Skip to content

refactor: retire complete.md — dated complete/ records are the ledger#83

Merged
Jammy2211 merged 2 commits into
mainfrom
feature/retire-complete-ledger
Jul 16, 2026
Merged

refactor: retire complete.md — dated complete/ records are the ledger#83
Jammy2211 merged 2 commits into
mainfrom
feature/retire-complete-ledger

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Summary

Retires the monolithic complete.md ledger (590 entries / 6,274 lines — closes #81). The dated complete/<YYYY>/<MM>/<slug>.md records plus the generated complete/index.md are now the sole completion ledger.

  • Parity backfill before deletion: 8 ledger entries had no dated record (eceb-editorial-revision, ep-analytic-updates-scope, ep-deterministic-reconcile, ep-priors-fable-reassess, keck-ao-acceptance-checks, morning-status-release-rehearsal, release-profile-jax-default, slacs1430-acs-parity) — all extracted verbatim into records; keck-ao also recovers its stranded active/ prompt.
  • scripts/lifecycle.py: record <slug> --date --from-file <body> [--prompt] now takes the rich completion body from the ship skill (no complete.md parsing); move infers the bucket from an existing record; check gains the post-retirement invariants (no active.md slug may have a record; no file in two states); the spent one-time split-complete/migrate subcommands are deleted.
  • complete.md removed (full history in git); index regenerated (594 records).
  • scripts/status.sh counts records (excluding archive/) and reads "recently completed" from the reverse-chronological index.
  • Docs updated: README, AGENTS, REFERENCE (record schema replaces the ledger schema), skills/OWNERSHIP, complete/AGENTS, complete/archive/README, parked.md header, prompt_sync.sh comment.
  • Deliberately untouched: scripts/spawn.py + docs/pyautobrain/spawn_spec.md (memory-structure-cleanup rewrites spawn.py in parallel) — 1-line rider on refactor: retire complete.md ledger for dated complete/ records #81 to drop the ("complete.md", "EMPTY") template stamp after it merges.

Companion PRs: PyAutoBrain + PyAutoHeart repoint the readers/writers.

API Changes

None — internal registry tooling and docs only. lifecycle.py record CLI changed (now requires --date + --from-file); the ship skills that call it are updated in the companion PyAutoBrain PR.

Test Plan

  • Parity proven before deletion: every complete.md slug has a record (8 backfilled, 0 remaining)
  • lifecycle.py check + index --check green post-retirement
  • record --from-file and move (record-derived bucket) dry-runs exercised
  • status.sh runs against the records (counts + recent-5)
  • No live complete.md references remain (grep; historical records/epics keep theirs)

Shipped through an unrelated Heart RED on explicit user authorization (recorded on #81; no library source touched).

Generated by the PyAutoLabs agent workflow.

…dger (#81)

- backfill the 8 ledger entries that had no dated record (parity proven before
  deletion); keck-ao also recovers its stranded active/ prompt
- lifecycle.py: record --date --from-file (ship skills supply the rich body;
  no complete.md parsing), move infers the bucket from an existing record,
  check gains post-retirement invariants, spent one-time subcommands
  (split-complete, migrate) deleted
- git rm complete.md (history in git); index regenerated (594 records)
- status.sh counts + recent-5 from complete/ records; README/AGENTS/REFERENCE/
  OWNERSHIP/complete-AGENTS/parked/prompt_sync wording updated
- scripts/spawn.py deliberately untouched (memory-structure-cleanup rewrites
  it in parallel; 1-line rider recorded on #81)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ve paired records); fold the spawn.py rider — drop the complete.md template stamp (memory-structure-cleanup's rewrite merged)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Jammy2211 Jammy2211 merged commit 9ae82cc into main Jul 16, 2026
1 check passed
@Jammy2211 Jammy2211 deleted the feature/retire-complete-ledger branch July 16, 2026 09:33
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.

refactor: retire complete.md ledger for dated complete/ records

1 participant