feat(notes): store unprocessed worker-notes in the TODO.md index#12
Open
ArgonQQ wants to merge 3 commits into
Open
feat(notes): store unprocessed worker-notes in the TODO.md index#12ArgonQQ wants to merge 3 commits into
ArgonQQ wants to merge 3 commits into
Conversation
Move human "note to worker" storage from the per-task file's `## Notes` section to a repeatable `- note:` sub-bullet on the index entry, so a loop worker sees notes on its every-pass index read instead of missing them when it doesn't open the task file (grammar v4 extension). - model: IndexEntry gains `notes: string[]`; TaskDetail drops it - parser/writer: parse + serialize `- note:` after questions; round-trips - taskfile: stop parsing/emitting `## Notes` (a stray one is preserved as a flagged unknown section) - merge: `note` becomes an index field (patch routes to TODO.md) - notes are transient/unprocessed: dropped on accept; Rule 16 apply-then-delete - docs: LOOP.md template + CLAUDE.md non-negotiable + Rule 16/Automation step 6 - tests/fixtures updated; make check green
Keep CLAUDE.md aware of >=2.0 only: drop the PLAN.md (v1 design) pointer, the 'breaking, no migration' + 'root TODO.md ignored' v1->v2 transition framing, and the stale terminals note (old ~3,000-char prompt history, 'tmux = v2 path' — the current terminals.ts uses plain VSCode terminals).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Human "note to worker" input now lives on the index entry in
TODO.mdas a repeatable- note:sub-bullet, instead of the per-task file's## Notessection. A loop worker reads the index every pass, so notes are now surfaced reliably — previously a note added to an already-groomed task's file was invisible until someone opened the file.Decision (t-4e7a grooming): store unprocessed notes in TODO.md; no long-term storage in the task file. Notes are transient — applied then deleted (Rule 16), and dropped on accept.
Changes
IndexEntrygainsnotes: string[];TaskDetaildrops it.- note:afterquestion:/answer:; round-trip fixpoint preserved.## Notes(a stray one is preserved as a flagged unknown section).notebecomes an index field (patch routes toTODO.md); dropped from detail fields.media/template-loop.mdgrammar + task-file format + Rule 16 + Automation step 6; CLAUDE.md non-negotiable fix(board): make DRAFT cards readable — body-text layout instead of italic title blob #3.field: 'note').Second commit
chore: remove REFACTORING.md— deletes the v2 storage-split spec and its now-dangling references (CLAUDE.md,.vscodeignore), per request.Verification
make checkgreen — build clean, 57 tests pass (newnote:parser round-trip + index-field merge tests), VSIX packaged.