Commit graph Ghostlight/AGENTS.md
Author SHA1 Message Date
Meta Vens
9de9e53a5f Docs describe the machine on main: README, AGENTS, handoff pointer, live architecture pages
README and AGENTS.md state what exists (sealed kernel, Dungeon, persona
projection, sidecar, browser host) and what does not (the verse, storylets,
cast, episodes). The handoff becomes a pointer to the Eureka mind. The Eve
interface page matches eve.rs (world.create v4, Draft/Active cards, play
card). Live pages cite crates/ghostlight/src/<file> instead of world/*.rs.
The implementation plan gains a historical status line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 19:50:28 +02:00
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