Skip to content

feat: move CLI metadata from soul frontmatter into state.toml - #112

Open
scode wants to merge 1 commit into
hookless/0-planfrom
hookless/1-state-toml
Open

feat: move CLI metadata from soul frontmatter into state.toml#112
scode wants to merge 1 commit into
hookless/0-planfrom
hookless/1-state-toml

Conversation

@scode

@scode scode commented Jul 6, 2026

Copy link
Copy Markdown
Owner

First step of the hookless transition (plan: lore/hookless-migration.md, the PR below this one).

The soul file was shared between the agent (body) and the CLI (frontmatter) — that split is where the whole
corrupt-frontmatter failure mode came from, and a later step imports the soul into CLAUDE.md, which requires pure
markdown with no metadata block. Watermark state also had to stop being Codex-specific: the upcoming external Claude
session scan needs a per-session watermark home, so the codex-meta.toml split (already flagged as temporary in the
spec) folds into the same file.

Existing installs are deliberately not migrated here: the migration routine ships unit-tested but unwired, and a later
revision's hard-epoch bump drives it. Until then leiter claude install refuses a legacy layout rather than
half-migrating it, and its write ordering is chosen so a torn install self-heals on rerun.

Also adds leiter soul mark-upgraded: soul_version now advances only after the agent actually finishes restructuring —
the same fail-safe direction as mark-distilled, replacing the old "trust the agent to edit frontmatter" step.

changelog: include

@scode
scode force-pushed the hookless/0-plan branch from b7867b9 to 27d095e Compare July 7, 2026 00:48
@scode
scode force-pushed the hookless/1-state-toml branch from 8b621fe to 550afbb Compare July 7, 2026 00:48
@scode
scode force-pushed the hookless/0-plan branch from 27d095e to 4077c29 Compare July 7, 2026 06:17
@scode
scode force-pushed the hookless/1-state-toml branch from 550afbb to 14f6242 Compare July 7, 2026 06:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant