docs(chronology): switch to manual maintenance; delete generator scripts; archive review report

Deleted scripts/audit/generate_chronology.py + chronology_quality_gate.py
after repeated corruption incidents (auto-classifier drifted from
user intent, silently rewrote rows). chronology.md is now maintained
by hand: add a row at the top when a track ships/abandons/is archived.

Updated conductor/workflow.md §Chronology Maintenance and
conductor/tracks.md §Archiving a track to reflect manual maintenance.

Added 40 rows to conductor/chronology.md for the 2026-07-05 archive
batch, with archive-folder paths and deferral notes where applicable.

Removed 12 archived-track rows from conductor/tracks.md Active Tracks
table (rows 2, 3, 7c, 16, 17, 23b, 23c, 23d, 25, 26, 29, 29c) and
their track-detail anchors.

Wrote docs/reports/ARCHIVE_REVIEW_20260705.md: a categorized index
of unfinished work items from the archived tracks' state.toml files
that remain relevant to the codebase, with a ranked follow-up list.
This commit is contained in:
ed
2026-07-05 16:17:13 -04:00
parent 2f3a8283f9
commit 4c9fc99cd4
6 changed files with 285 additions and 630 deletions
+42 -1
View File
@@ -1,7 +1,48 @@
<!-- Generated 2026-07-02 | 244 rows -->
<!-- Manually maintained (since 2026-07-05, when the generator scripts were deleted after repeated corruption incidents) -->
| Date | ID | Status | Summary | Folder | Range |
| --- | --- | --- | --- | --- | --- |
| 2026-07-05 | `superpowers_review_apply_high_20260705` | Completed | Phase 1: `26dd9258` Session Start Checklist item 13 added; Phase 2: `670a919e` tests/test_mma_skill_discipline.py (25 cases); Phase 3: `5037f48f` cross-reference + finalization. | `conductor/archive/superpowers_review_apply_high_20260705` | `0522252f..5037f48f` (3) |
| 2026-07-05 | `superpowers_review_20260619` | Completed | 16-section review of the superpowers skill suite: 14 PARITY / 3 PARTIAL / 2 ARCH-DIFF / 1 GAP; 25 decisions logged; 3 side artifacts (decisions.md, comparison_table.md, nagent_takeaways). | `conductor/archive/superpowers_review_20260619` | `eb272cb7..137868a1` (40) |
| 2026-07-05 | `agent_directives_consolidation_20260705` | Completed | AGENTS.md reduced from 202→87 lines; conductor/workflow.md §Process Anti-Patterns promoted to canonical home; conductor/edit_workflow.md §9 + product-guidelines.md subsections thin-pointed to canonical styleguides; 9 atomic commits with git notes. | `conductor/archive/agent_directives_consolidation_20260705` | `48ddd15c..8ab82022` (4) |
| 2026-07-05 | `test_sandbox_hardening_20260619` | Completed | Hard file-I/O sandbox for the test suite so a misbehaving test cannot leak artifacts into the working tree. Adds FR1 runtime guard + addopts redirect to `tests/artifacts/_pytest_tmp`. | `conductor/archive/test_sandbox_hardening_20260619` | `ec0716c9..eec44a09` (9) |
| 2026-07-05 | `test_patch_fixes_20260513` | Abandoned | After the refactor to use `ai_client_stub` as the module alias for `app_controller`, several tests fail because they use `patch('src.ai_client.X')`. Stale; superseded by later test_infrastructure_hardening + result_migration waves. | `conductor/archive/test_patch_fixes_20260513` | `12f16e9a..12f16e9a` (1) |
| 2026-07-05 | `send_result_to_send_20260616` | Completed | Tier 2 migration of the `send()` public API to `Result[str, ErrorInfo]` return type, replacing the str/None return. | `conductor/archive/send_result_to_send_20260616` | `c1d9a966..e2e57036` (15) |
| 2026-07-05 | `post_module_taxonomy_de_cruft_20260627` | Completed | Followup to module_taxonomy_refactor_20260627: removed leftover cruft, dead imports, and stale references after the models.py split. | `conductor/archive/post_module_taxonomy_de_cruft_20260627` | `05647d94..e4f652a7` (3) |
| 2026-07-05 | `phase2_4_5_call_site_completion_20260621` | Completed | Tier 2 autonomous completion of the phase 2/4/5 call-site migration left over from any_type_componentization_20260621. | `conductor/archive/phase2_4_5_call_site_completion_20260621` | `1a739ece..6e734a49` (3) |
| 2026-07-05 | `cruft_elimination_20260627` | Partially Completed | Goal: make Python behave as close to C11/Odin/Jai as possible. Phases 2, 4, 5, 6, 7 DEFERRED (ProjectContext dataclass; _do_generate return type; rag_engine.search() return type; 30 Optional[T] sites; 69 Any/dict[str,Any] sites). | `conductor/archive/cruft_elimination_20260627` | `f219616f..0a65056f` (8) |
| 2026-07-05 | `fable_review_20260617` | Completed | 10-cluster review of the "Fable" system-prompt artifact; 42 commits; 7-phase structure producing comparison_table, decisions, and per-cluster research notes. Section 16 (deferred nagent-rebuild recommendations) PENDING. | `conductor/archive/fable_review_20260617` | `058e2c93..22d3234b` (42) |
| 2026-07-05 | `context_preview_fixes_20260516` | Abandoned | Fix critical failures in the context composition feature (Preview button + Inspect/Slices buttons). Superseded by later context_composition_ux_20260601 + structural_file_editor_20260601 work. | `conductor/archive/context_preview_fixes_20260516` | `45de48bc..2249606e` (5) |
| 2026-07-05 | `public_api_migration_and_ui_polish_20260615` | Completed | First public-API migration sub-track: Result[T] adoption in the UI layer + polish. | `conductor/archive/public_api_migration_and_ui_polish_20260615` | `3febdab4..bbd4c7b5` (8) |
| 2026-07-05 | `code_path_audit_polish_20260622` | Completed | Tight surgical follow-up to code_path_audit_20260607 v2 (the MVP brute-force state). | `conductor/archive/code_path_audit_polish_20260622` | `1e92fbe9..ca219163` (12) |
| 2026-07-05 | `tier2_leak_prevention_20260620` | Completed | Prevents Tier 2 autonomous sandbox from leaking into AppData/Temp/Documents. Establishes the 3-layer hard-ban enforcement (OpenCode + OS + git hook). | `conductor/archive/tier2_leak_prevention_20260620` | `9224be7a..9224be7a` (1) |
| 2026-07-05 | `type_alias_unfuck_20260626` | Completed | The MINIMAL track to fix the type-usage problem that metadata_promotion_20260624 left as a tar pit. Replaces opaque aliases with typed dataclasses; vc4_codepaths_drop metric deferred. | `conductor/archive/type_alias_unfuck_20260626` | `f47be0ec..c0f30f28` (3) |
| 2026-07-05 | `data_oriented_error_handling_20260606` | Completed | The Fleury-pattern data-oriented error handling convention: Result[T] + NIL_T sentinels + ErrorInfo classification. Path C (mcp_client.py tool surface assert-removal) DEFERRED to follow-up. | `conductor/archive/data_oriented_error_handling_20260606` | `494f68f9..92cff705` (20) |
| 2026-07-05 | `data_structure_strengthening_20260606` | Completed | TypeAlias conventions + per-aggregate dataclass migration. Adds the audit_weak_types.py gate. typed_dict_migration_followup + public_api_migration_followup sections retained. | `conductor/archive/data_structure_strengthening_20260606` | `ed42a97a..1dce3203` (8) |
| 2026-07-05 | `code_path_audit_20260607` | Completed | First-pass brute-force code-path audit. Identifies NG2 (Optional[T] returns) and other anti-pattern sites; baseline for phase_2 + phase_3 + polish follow-ups. | `conductor/archive/code_path_audit_20260607` | `f069a8b2..5ac0618a` (22) |
| 2026-07-05 | `code_path_audit_phase_2_20260624` | Completed | The actual follow-up to code_path_audit_20260607. Snapshots pre-Phase-3 baseline and addresses NG2 violations. | `conductor/archive/code_path_audit_phase_2_20260624` | `7c352e1c..705cb50d` (2) |
| 2026-07-05 | `code_path_audit_phase_3_provider_state_20260624` | Completed | The fix for the 4 NG2 violations and 1 partial NG2 violation left by code_path_audit_phase_2_20260624. | `conductor/archive/code_path_audit_phase_3_provider_state_20260624` | `f7a29179..c3d575de` (10) |
| 2026-07-05 | `result_migration_20260616` | Completed | Umbrella track for the public-API Result[T] migration campaign (8 sub-tracks; 7 shipped + 1 Active per 2026-07-02). | `conductor/archive/result_migration_20260616` | `4c0b19b4..9c30ef64` (14) |
| 2026-07-05 | `result_migration_review_pass_20260617` | Completed | Audit + documentation pass over the Result[T] migration; informational, no production code change. | `conductor/archive/result_migration_review_pass_20260617` | `396eb82c..33479267` (19) |
| 2026-07-05 | `result_migration_baseline_cleanup_20260620` | Completed | Final baseline cleanup of the Result[T] migration campaign; 18 commits. Phase 10-14 invariant tests marked in_progress (per state.toml). | `conductor/archive/result_migration_baseline_cleanup_20260620` | `e9016749..9c30ef64` (18) |
| 2026-07-05 | `exception_handling_audit_20260616` | Completed | Audit of try/except/finally/raise sites per the data-oriented convention; adds the audit_exception_handling.py classifier + CI gate. | `conductor/archive/exception_handling_audit_20260616` | `e81413a2..ed660227` (5) |
| 2026-07-05 | `fix_mma_concurrent_tracks_sim_20260627` | Completed | Single-test fix track addressing the 1 remaining tier-3 failure after post_module_taxonomy_de_cruft_20260627. | `conductor/archive/fix_mma_concurrent_tracks_sim_20260627` | `ee185758..9d22c37c` (4) |
| 2026-07-05 | `fix_test_failures_20260624` | Completed | 3 surgical fixes to make the full test suite green after the polish merge. | `conductor/archive/fix_test_failures_20260624` | `7a9261c4..45876aef` (7) |
| 2026-07-05 | `live_gui_test_fixes_20260618` | Completed | Addresses 2 test failures reported as "documented issues" by result_migration_small_files_20260617 Phase 13. | `conductor/archive/live_gui_test_fixes_20260618` | `ff40138f..6ce55cba` (2) |
| 2026-07-05 | `default_layout_extract_20260629` | Completed | Extract tier-2's GOOD work on the default layout setup (layouts/ directory, install-on-empty-INI helpers, pre-run install timing fix, orphan-end-child cleanup). panel_defs_fleury_migration + render_persona_editor_window_fix DEFERRED. | `conductor/archive/default_layout_extract_20260629` | `466d2656..410d81fb` (2) |
| 2026-07-05 | `default_layout_install_20260629` | Completed | Fix GUI panels becoming invisible at startup whenever manualslop_layout.ini is missing/empty/stale. User Manual Verification DEFERRED. | `conductor/archive/default_layout_install_20260629` | `5ad062b1..4bf5ecd6` (10) |
| 2026-07-05 | `default_layout_install_followup_20260629` | Completed | Followup to default_layout_install_20260629: restore docking structure (strip stale dockspace IDs, force live-session apply). | `conductor/archive/default_layout_install_followup_20260629` | `34538639..4bf5ecd6` (2) |
| 2026-07-05 | `doeh_test_thinking_cleanup_20260615` | Completed | Cleanup of test-thinking-trace handling after the data-oriented error handling convention landed. | `conductor/archive/doeh_test_thinking_cleanup_20260615` | `925e366c..a8c81251` (5) |
| 2026-07-05 | `metadata_nil_sentinel_20260624` | Completed | Child 1 of metadata_ssdl_defusing_20260624 campaign. Introduces NIL_T sentinels for the Metadata aggregate. | `conductor/archive/metadata_nil_sentinel_20260624` | `84c0b4ec..7c352e1c` (3) |
| 2026-07-05 | `metadata_promotion_20260624` | Partially Completed | Promotes 5 sub-aggregates (CommsLogEntry, HistoryMessage, FileItem, ToolDefinition, ToolCall) to typed dataclasses. 3 open blockers (rag return type, tool builders dicts, drifted field types) deferred to follow-up tracks. | `conductor/archive/metadata_promotion_20260624` | `e50bebdd..b4bd772d` (16) |
| 2026-07-05 | `ai_loop_regressions_20260614` | Completed | Fixes regressions in the AI loop after the Result[T] migration; 11 commits. | `conductor/archive/ai_loop_regressions_20260614` | `7a4dcc96..6edeb2b5` (11) |
| 2026-07-05 | `module_taxonomy_refactor_20260627` | Completed | The user-reported models.py "dumping ground" (1044 lines, 36 classes, 5+ unrelated domains). Splits into per-system files (mma.py, project_files.py, type_aliases.py, mcp_tool_specs.py, result_types.py). | `conductor/archive/module_taxonomy_refactor_20260627` | `cba6e7d7..91a61288` (13) |
| 2026-07-05 | `any_type_componentization_20260621` | Partially Completed | Componentize `Any`-typed call sites across src/. The phase 2/4/5 call-site completion was deferred to phase2_4_5_call_site_completion_20260621 (shipped). | `conductor/archive/any_type_componentization_20260621` | `ed0d198a..751b94d4` (12) |
| 2026-07-05 | `chronology_v2_20260701` | Completed | The v2 chronology rewrite spec (354 lines — designed but never executed as a track; the v2 design informed the manual-maintenance switch on 2026-07-05). | `conductor/archive/chronology_v2_20260701` | `c1da0f99..c6593278` (6) |
| 2026-07-05 | `sqlite_docs_gui_2_20260612` | Completed | SQLite-granularity inline docs for gui_2.py (the original gui_2 doc track). | `conductor/archive/sqlite_docs_gui_2_20260612` | `99e7b6e8..56e1950b` (8) |
| 2026-07-05 | `sqlite_docs_gui_2_continued_20260613` | Completed | The ai_client.py continuation of the SQLite-granularity inline docs campaign. | `conductor/archive/sqlite_docs_gui_2_continued_20260613` | `cb129aae..e02a865d` (3) |
| 2026-07-05 | `directive_hotswap_harness_20260627` | Partially Completed | Harness for hot-swapping agent directive presets at session warm. Phase 3.2 (manual verification: does the LLM follow warm-with) DEFERRED to user per directive. 3 deferred + 2 in_progress per state.toml. | `conductor/archive/directive_hotswap_harness_20260627` | `03c7cfd5..03c7cfd5` (1) |
| 2026-07-02 | `intent_dsl_survey_20260612` | Completed | Intent-based scripting-languages survey (spec); Tier 1 authored, Tier 2 executed. 12 commits. | `conductor/tracks/intent_dsl_survey_20260612` | `b389f1be..45144872` (12) |
| 2026-07-01 | `chronology_v2_20260701` | Completed | - `conductor/tracks/chronology_20260619/spec.md` (the v2 rewrite spec, 354 lines — designed but never executed) | `conductor/tracks/chronology_v2_20260701` | `c1da0f99..c6593278` (6) |
| 2026-07-01 | `mma_quarantine_rag_test_decoupling_20260701` | Active | Two surgical interventions: | `conductor/tracks/mma_quarantine_rag_test_decoupling_20260701` | `e5f37e74..e5f37e74` (1) |
| 2026-06-29 | `default_layout_extract_20260629` | In Progress | Extract tier-2's GOOD work on the default layout setup (the `layouts/` directory, the install-on-empty-INI helpers, the pre-run install timing fix, and the orphan-end-child cleanup) into… | `conductor/tracks/default_layout_extract_20260629` | `466d2656..410d81fb` (2) |
+4 -30
View File
@@ -18,45 +18,19 @@ Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked
| # | Priority | Track | Status | Blocked By |
|---|---|---|---|---|
| 36 | A (sunset) | [MMA Quarantine + RAG Test Decoupling](#track-mma-quarantine--rag-test-decoupling) | spec ✓, plan pending | (none) |
| 2 | A | [Qwen, Llama & Grok Vendor Integration](#track-qwen-llama-grok-vendor-integration) | **Completed** (per chronology.md; Phase 6 follow-up shipped) — row retained for cross-ref; archive candidate | test_infrastructure_hardening_20260609 (merged) |
| 3 | A | [Data-Oriented Error Handling (Fleury Pattern)](#track-data-oriented-error-handling) | **Completed** (per chronology.md) — archive candidate | test_infrastructure_hardening_20260609 (merged), qwen_llama_grok |
| 4 | A | [MCP Architecture Refactor (Sub-MCP Extraction)](#track-mcp-architecture-refactor) | spec ✓, plan pending | test_infrastructure_hardening_20260609 (merged), data_oriented_error_handling, data_structure_strengthening |
| 16 | A | [Test Sandbox Hardening](#track-test-sandbox-hardening) | spec ✓, plan ✓, ready to start | (none) |
| 17 | A | [Code Path Audit](#track-code-path-audit) | **Completed** (per chronology.md) — archive candidate | test_infrastructure_hardening_20260609 (merged), any_type_componentization (shipped), phase2_4_5_call_site_completion (shipped) |
| 4 | A | [MCP Architecture Refactor (Sub-MCP Extraction)](#track-mcp-architecture-refactor) | spec ✓, plan pending | (none) |
| 22b | A | [Meta-Tooling Workflow Review](#track-meta-tooling-workflow-review) | spec ✓, plan ✓, parked | (none) |
| 23 | A | [Intent-Based Scripting Languages Survey](#track-intent-dsl-survey) | spec ✓, plan pending | (none) |
| 23b | B | [Superpowers Skills Review](#track-superpowers-skills-review) | **Completed** (Phase 10 finalize `deecd931`; current_phase=10; 16 sections + 3 side artifacts; 25 decisions; verdict distribution 14 PARITY / 3 PARTIAL / 2 ARCH-DIFF / 1 GAP) — archive candidate | (none) |
| 23c | B | [Apply HIGH-Priority Recommendations](#track-superpowers-apply-high) | **Completed** (Phase 1: `26dd9258` Session Start Checklist item 13 added; Phase 2: `670a919e` tests/test_mma_skill_discipline.py (25 cases); Phase 3: `5037f48f` cross-reference + finalization) — archive candidate | superpowers_review_20260619 (shipped) |
| 23d | B | [Agent Directives Consolidation](#track-agent-directives-consolidation) | **Completed** (4 phases: AGENTS.md reduced from 202→87 lines; conductor/workflow.md §Process Anti-Patterns promoted to canonical home; conductor/edit_workflow.md §9 + product-guidelines.md subsections thin-pointed to canonical styleguides; 9 atomic commits with git notes) — archive candidate | (none) |
| 25 | B | [Fable System Prompt Review](#track-fable-review) | **Completed** (shipped 2026-06-17 per Phase 7 commit `22d3234b`; state.toml stale) — retained in tracks/ per user; will be archived later; reports kept for future reference | (none) |
| 26 | A | [Video Analysis Campaign (Pass 1 of 3)](#track-video-analysis-campaign) | **Completed** (archived 2026-06-24 → `archive/analysis/` with 22 sibling video_analysis tracks) — archive candidate | (none) |
| 29 | A | [Video Analysis De-obfuscation Campaign (Pass 2 of 3)](#track-video-analysis-deob) | **Completed** (archived 2026-06-24 → `archive/analysis/`) — archive candidate | (none) |
| 29c | A | [Pass 3 — C11/Python Projection](#track-pass-3-c11python-projection) | **Completed** (archived 2026-06-24 → `archive/analysis/`) — archive candidate | deob_apply (shipped), lexicon_v2 (shipped), c11_reference (shipped) |
| 7 | — | [UI Polish (Five Issues)](#track-ui-polish-five-issues) | spec ✓, plan ✓, ready to start | (none) |
| 7c | B | [SQLite-Granularity Inline Docs for ai_client.py](#track-sqlite-docs-ai-client) | **Completed** (shipped 2026-06-13 per commit `e02a865d`; archived) — archive candidate | (none) |
| 19 | — | [Context First Message Fix](#track-context-first-message-fix) | spec TBD | (none) |
> **Stale-row cleanup (2026-07-02):** rows 2, 3, 17 marked Completed per `conductor/chronology.md` (which is the canonical status source). They are retained here as archive candidates pending a `git mv` to `conductor/archive/`. `data_structure_strengthening_20260606` (also Completed per chronology) was already dropped from this table.
### Track detail anchors
- **MMA Quarantine + RAG Test Decoupling** → `conductor/tracks/mma_quarantine_rag_test_decoupling_20260701/`
- **Qwen, Llama & Grok Vendor Integration** → `conductor/tracks/qwen_llama_grok_integration_20260606/` (Phase 6 in progress)
- **Data-Oriented Error Handling** → `conductor/tracks/data_oriented_error_handling_20260606/`
- **MCP Architecture Refactor** → `conductor/tracks/mcp_architecture_refactor_20260606/`
- **Test Sandbox Hardening** → `conductor/tracks/test_sandbox_hardening_20260619/`
- **Code Path Audit** → `conductor/tracks/code_path_audit_20260607/`
- **Meta-Tooling Workflow Review** → `conductor/tracks/meta_tooling_workflow_review_20260620/`
- **Intent-Based Scripting Languages Survey** → `conductor/tracks/intent_dsl_survey_20260612/`
- **Superpowers Skills Review** → `conductor/tracks/superpowers_review_20260619/`
- **Apply HIGH-Priority Recommendations** → `conductor/tracks/superpowers_review_apply_high_20260705/`
- **Agent Directives Consolidation** → `conductor/tracks/agent_directives_consolidation_20260705/`
- **Fable System Prompt Review** → `conductor/tracks/fable_review_20260617/`
- **Video Analysis Campaign (Pass 1)** → `conductor/tracks/video_analysis_campaign_20260621/`
- **Video Analysis De-obfuscation (Pass 2)** → `conductor/tracks/video_analysis_deob_20260621/`
- **Pass 3 — C11/Python Projection** → `conductor/tracks/video_analysis_deob_pass3_20260623/`
- **UI Polish (Five Issues)** → `conductor/tracks/` (see spec for details)
- **SQLite-Granularity Inline Docs for ai_client.py** → `conductor/archive/sqlite_docs_gui_2_continued_20260613/` (7c is the ai_client continuation; the original gui_2 track is `conductor/archive/sqlite_docs_gui_2_20260612/`)
- **Context First Message Fix** → `conductor/tracks/context_first_message_fix_20260604/`
---
@@ -65,7 +39,7 @@ Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked
| # | Priority | Track | Status | Blocked By |
|---|---|---|---|---|
| 6 | D | [Public API Result Migration](#track-public-api-result-migration) | **Largely Completed** (umbrella + 6 sub-tracks shipped per chronology): `public_api_migration_and_ui_polish_20260615` ✓, `send_result_to_send_20260616` ✓, `result_migration_review_pass_20260617` ✓, `result_migration_small_files_20260617` ✓, `result_migration_app_controller_20260618` ✓, `result_migration_gui_2_20260619` ✓, `result_migration_baseline_cleanup_20260620` ✓; only `result_migration_cruft_removal_20260620` still Active (Round 4 corrections applied; user-confirmed closeout; state.toml stale) | data_oriented_error_handling (deprecated send()) |
| 6 | D | [Public API Result Migration](#track-public-api-result-migration) | **Largely Completed** (umbrella + 6 sub-tracks shipped per chronology): `public_api_migration_and_ui_polish_20260615` ✓, `send_result_to_send_20260616` ✓, `result_migration_review_pass_20260617` ✓, `result_migration_small_files_20260617` ✓, `result_migration_app_controller_20260618` ✓, `result_migration_gui_2_20260619` ✓, `result_migration_baseline_cleanup_20260620` ✓; only `result_migration_cruft_removal_20260620` still Active (Round 4 corrections applied; user-confirmed closeout; state.toml stale) | (none) |
| 8 | — | [Bootstrap gencpp Python Bindings](#track-gencpp-python-bindings) | spec TBD | (none) |
| 9 | — | [Tree-Sitter Lua MCP Tools](#track-tree-sitter-lua-mcp-tools) | spec TBD | (none) |
| 10 | — | [GDScript Language Support Tools](#track-gdscript-language-support-tools) | spec TBD | (none) |
@@ -97,7 +71,7 @@ Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked
---
> **Full project history:** see [`chronology.md`](./chronology.md) — the canonical index of all 244 tracks (active, shipped, superseded, abandoned), sorted newest-first, with git-history-evidence-backed status per row. Generated by `scripts/audit/generate_chronology.py`; quality-gated by `scripts/audit/chronology_quality_gate.py`.
> **Full project history:** see [`chronology.md`](./chronology.md) — the canonical index of all tracks (active, shipped, superseded, abandoned), sorted newest-first, with git-history-evidence-backed status per row. Maintained manually (the generator scripts were deleted 2026-07-05 after repeated corruption incidents).
---
@@ -118,4 +92,4 @@ Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked
**Archiving a track (3 steps):** When a track ships and its folder moves from `conductor/tracks/<id>/` to `conductor/archive/<id>/`, complete all 3 steps in order:
1. Move the folder: `git mv conductor/tracks/<id> conductor/archive/<id>` (preserves history as a rename).
2. Remove the row from this file (`conductor/tracks.md`).
3. Run `uv run python scripts/audit/generate_chronology.py --draft > conductor/chronology.md` to regenerate the chronology (the new row appears automatically). Commit with `docs(chronology): regenerate after <track-id> shipped`. Run `uv run python -m scripts.audit.chronology_quality_gate --strict` before committing to verify the quality gate passes.
3. Add a row to `conductor/chronology.md` (top of the table, newest-first) summarizing the track: Date, ID, Status, one-line Summary, Folder path, commit Range. Commit with `docs(chronology): add row for <track-id> archive`. (Chronology is maintained manually as of 2026-07-05 — the generator scripts were deleted after repeated corruption incidents.)
+3 -5
View File
@@ -624,17 +624,15 @@ The recommended execution order is the topological sort of the `blocked_by` grap
## Chronology Maintenance
**Chronology regeneration cadence.** After every track ships (completion commit + TRACK_COMPLETION report), the implementing agent must run `uv run python scripts/audit/generate_chronology.py --draft > conductor/chronology.md` to regenerate `conductor/chronology.md`. The regeneration is a single atomic commit (`docs(chronology): regenerate after <track-id> shipped`). If the regeneration produces a diff beyond the new row (e.g., status changes on other rows), the agent must investigate before committing — a status drift on an unrelated row indicates a stale classifier, not a chronology bug.
**Manual maintenance (changed 2026-07-05).** The chronology generator scripts (`scripts/audit/generate_chronology.py` + `scripts/audit/chronology_quality_gate.py`) were deleted on 2026-07-05 after repeated corruption incidents (the auto-classifier drifted from the user's intent and silently rewrote rows). `conductor/chronology.md` is now maintained **manually**: when a track ships, is abandoned, is superseded, or its folder is archived, the implementing agent adds a row to the top of the chronology table (newest-first) by hand. Fields: Date, ID, Status, one-line Summary, Folder path, commit Range. Commit with `docs(chronology): add row for <track-id> archive`.
**Quality gate.** `scripts/audit/chronology_quality_gate.py` runs as part of the regeneration. It fails (exit 1) if >30% of rows are classified as `Needs Review`. A failing quality gate blocks the regeneration commit. Run `uv run python -m scripts.audit.chronology_quality_gate --strict` before committing the regenerated chronology.
**When to regenerate:**
**When to add a row:**
- After a track ships (TRACK_COMPLETION report committed)
- After a track is abandoned (TRACK_ABORTED report committed)
- After a track is superseded (state.toml status = "superseded")
- After a track folder is archived (moved to `conductor/archive/`)
**When NOT to regenerate:**
**When NOT to add a row:**
- Mid-track (the chronology reflects filesystem state; a mid-track folder is correctly "In Progress" or "Active")
- After a plan.md edit (the chronology doesn't track plan content)