Skip to content

fix: Consolidate duplicate types, fix stale docs and confused comments#11

Open
avi8or wants to merge 1 commit into
piercelamb:mainfrom
avi8or:fix/doc-fixes
Open

fix: Consolidate duplicate types, fix stale docs and confused comments#11
avi8or wants to merge 1 commit into
piercelamb:mainfrom
avi8or:fix/doc-fixes

Conversation

@avi8or
Copy link
Copy Markdown

@avi8or avi8or commented Mar 5, 2026

  • CurrentTask and ConflictInfo are defined in both task_storage.py and task_reconciliation.py with different fields. Consolidated both into task_storage.py so there's a single definition to maintain.
  • generate-section-tasks.py has a comment block that reads like stream-of-consciousness notes ("Actually", "No wait", "Let me check"). Replaced with a clean summary of the position mapping formula.
  • section-index.md says both PROJECT_CONFIG and SECTION_MANIFEST blocks "MUST start" the file, which is contradictory. Clarified ordering.
  • section-splitting.md describes the SubagentStop hook as parsing JSON with sections_dir/filename/content fields, but the actual hook extracts the prompt path and writes the last assistant message as raw markdown. Updated to match what the hook actually does.

All 341 existing tests pass.

- CurrentTask and ConflictInfo are defined in both task_storage.py and
  task_reconciliation.py with different fields. Consolidated both into
  task_storage.py so there's a single definition to maintain.
- generate-section-tasks.py has a comment block that reads like
  stream-of-consciousness notes ("Actually", "No wait", "Let me check").
  Replaced with a clean summary of the position mapping formula.
- section-index.md says both PROJECT_CONFIG and SECTION_MANIFEST blocks
  "MUST start" the file, which is contradictory. Clarified ordering.
- section-splitting.md describes the SubagentStop hook as parsing JSON
  with sections_dir/filename/content fields, but the actual hook
  extracts the prompt path and writes the last assistant message as raw
  markdown. Updated to match what the hook actually does.

All 341 existing tests pass.
@avi8or avi8or changed the title Consolidate duplicate types, fix stale docs and confused comments fix: Consolidate duplicate types, fix stale docs and confused comments Mar 5, 2026
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