Commit graph Ghostlight/AGENTS.md
Author SHA1 Message Date
Meta Vens
22937b71f0 Replace vendor/cultcache-py submodule with published PyPI dependency
CultLib's packages/cultcache-py is now published as cultcache-py==0.2.0 on
PyPI (MIT), so the standalone GameCult/cultcache-py fork that Ghostlight
vendored as a submodule is retired. Symbol-for-symbol and on-disk-format
verification against the pinned submodule commit 9b4bbb8 found no
incompatibility: every symbol tools/ghostlight_state_store.py imports
(CultCache, JsonLinesBackingStore, define_document_type) and every method it
calls kept its signature, and JsonLinesBackingStore's on-disk JSONL envelope
fields and sort order are unchanged, confirmed by a real round-trip against
Ghostlight's production state/ghostlight-state.cultcache.jsonl.

tools/ghostlight_state_store.py no longer pushes vendor/cultcache-py/src onto
sys.path; it imports cultcache_py directly. Since Ghostlight's session
bootstrap previously depended on the submodule needing no install step,
tools/requirements.txt now pins cultcache-py==0.2.0 and npm run
state:bootstrap (pip install -r tools/requirements.txt, idempotent) runs as a
pre-hook ahead of state:status and state:prepare-compaction; AGENTS.md's
Session Bootstrap protocol and Useful Commands section call it out explicitly
for the direct ghostlight_state.py CLI invocations that don't go through npm.

Verified for real: `python tools/ghostlight_state.py status` and `python
tools/ghostlight_prepare_compaction.py`, run from a venv with cultcache-py
installed from PyPI, against Ghostlight's actual production state file (22 ok
findings, 2 pre-existing unrelated warnings, exit 0 both times).

Idunn's deployment/idunn/recipe.toml never declared vendor/cultcache-py in
required_gitlinks (only vendor/eve) and its build/test/service steps never
touch Python state tooling, so no recipe change is needed for admission.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-13 16:08:19 +02:00
Meta Vens
463bd8dc14 Name the Linux deploy target so agents stop compiling for Windows
Nothing an agent loads in this repo said Ghostlight Dungeon ships to Linux
on Yggdrasil, so a Windows workstation build looked like reasonable
verification. Record the target, the fact that Idunn builds the release in
pinned Linux containers, and what a local compile is and is not evidence
for.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-08 12:23:24 +02:00
Meta Vens
18f2eb96a2 Distill the evidence ledger to twelve records through one compaction path
44 records to 12: supersession chains collapsed to their survivors,
per-commit receipts folded into the decision they served, standing
pre-rebuild decisions merged into one record map.yaml already owns. Every
removed record is archived verbatim. `compact-evidence` is now the one
durable deletion path; the status tool reads folded scalars, and the
compaction helper imports the map readers instead of carrying copies.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-06 15:03:55 +02:00
Meta Vens
5d852b76b0 Warn that evidence.jsonl edits are silently reverted
The existing rule said evidence.jsonl is an export surface rather than the
direct-write API, which is true but understates the failure. A hand edit does
not fail loudly; it survives until the next add-evidence regenerates the file
from the CultCache evidence document and restores whatever was removed.

An agent compacting the ledger would see a clean result, commit it, and have
it silently undone by the next append. Say so where the rule already lives,
since AGENTS.md is read before anyone reaches the store.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 00:28:50 +02:00
Meta Vens
ab39d8cdac Build grounded world compiler flow 2026-08-16 20:12:53 +02:00
Meta Vens
2531b42ea7 Migrate state spine toward cultcache-py 2026-05-06 04:48:21 +01:00
Meta Vens
f2b22df1b3 Distill persistent memory doctrine 2026-05-04 19:00:39 +01:00
Meta Vens
0f50cce12d Document illustrated IF scene-set pipeline 2026-05-04 12:23:41 +01:00
Meta Vens
d6c71e228f Clarify visual reviewer scope 2026-05-03 11:58:42 +01:00
Meta Vens
bfecac739e Expand environment image prompt details 2026-05-03 10:39:31 +01:00
Meta Vens
8cccfd38a3 Correct image prompt assembly rules 2026-05-03 10:37:21 +01:00
Meta Vens
56e093de80 Add global image style cue 2026-05-03 10:30:58 +01:00
Meta Vens
350404b5eb Add Pallas visual character refs 2026-05-03 10:25:49 +01:00
Meta Vens
4583a946c9 Add visual scene segmentation review 2026-05-03 10:09:20 +01:00
Meta Vens
ef5a2f5697 Add Aetheria tonal range doctrine 2026-05-03 09:12:09 +01:00
Meta Vens
2178e08d6b Revert "Wire Ghostlight to voidbot retrieval"
This reverts commit 06c23b5bfb.
2026-05-02 15:21:43 +01:00
Meta Vens
06c23b5bfb Wire Ghostlight to voidbot retrieval 2026-05-02 15:21:25 +01:00
Meta Vens
ba2b17e596 Clarify compaction scratch cleanup 2026-05-02 12:02:53 +01:00
Meta Vens
57b586bb33 Document source-first Aetheria generation doctrine 2026-05-02 04:30:17 +01:00
Meta Vens
d445960bed Strengthen no-victory-lap documentation rule 2026-05-01 19:31:09 +01:00
Meta Vens
ed971842ca Tighten documentation drift guardrail 2026-05-01 19:23:24 +01:00
Meta Vens
3726210016 Scaffold Ghostlight persistence spine 2026-05-01 18:06:51 +01:00