# Track state for chronology_20260619
# Updated by Tier 2 Tech Lead (or Tier 1 in this case) as tasks complete

[meta]
track_id = "chronology_20260619"
name = "Conductor Chronology"
status = "active"
current_phase = 0  # 0 = pre-Phase 1; spec is written but no implementation yet
last_updated = "2026-06-19"

[blocked_by]
# Independent track. No blockers.

[blocks]
# No followup tracks blocked on this one (deferred items listed in metadata.json).

[phases]
phase_1 = { status = "pending", checkpointsha = "", name = "Data extraction audit + draft helper script (FR5)" }
phase_2 = { status = "pending", checkpointsha = "", name = "Run script, generate conductor/chronology.md.draft" }
phase_3 = { status = "pending", checkpointsha = "", name = "Prune [x]/[shipped] entries from conductor/tracks.md (FR2)" }
phase_4 = { status = "pending", checkpointsha = "", name = "Add 3-step archiving convention to conductor/workflow.md (FR3)" }
phase_5 = { status = "pending", checkpointsha = "", name = "Write docs/reports/CHRONOLOGY_MIGRATION_20260619.md (FR4)" }
phase_6 = { status = "pending", checkpointsha = "", name = "User review of draft" }
phase_7 = { status = "pending", checkpointsha = "", name = "Final commit (rename draft to canonical)" }
phase_8 = { status = "pending", checkpointsha = "", name = "Per-row cross-check (FR6 hard gate; 165+ tasks)" }
phase_9 = { status = "pending", checkpointsha = "", name = "Completeness check (FR6 hard gate; folder set vs row set)" }
phase_10 = { status = "pending", checkpointsha = "", name = "User sign-off (FR6 hard gate; user is the quality gate)" }

[tasks]
# Phase 1 tasks
t1_1 = { status = "pending", commit_sha = "", description = "Audit: walk conductor/tracks/ and conductor/archive/; capture per-folder (id, date, status, init SHA, end SHA, summary source). Build the migration dataset." }
t1_2 = { status = "pending", commit_sha = "", description = "Write scripts/audit/generate_chronology.py per FR5: extract date from slug, init SHA via 'git log --reverse --format=%h -- <folder>', end SHA via 'git log -1 --format=%h -- <folder>', summary from spec.md first sentence (or metadata.json.description). Output markdown to stdout when --draft flag is set." }
t1_3 = { status = "pending", commit_sha = "", description = "Write 3-5 unit tests for the script: slug parsing, SHA extraction, summary extraction, multi-folder walk, draft output format. Commit Phase 1." }

# Phase 2 tasks
t2_1 = { status = "pending", commit_sha = "", description = "Run 'uv run python scripts/audit/generate_chronology.py --draft > conductor/chronology.md.draft'. Verify the draft has one row per folder, 5 fields per row, sorted newest first." }
t2_2 = { status = "pending", commit_sha = "", description = "Sanity-check the draft: count rows; spot-check 5-10 rows against source spec.md; verify Notable Non-Track Commits section is empty (filled in later or by Tier 1 manually)." }

# Phase 3 tasks
t3_1 = { status = "pending", commit_sha = "", description = "Prune 'Phase 9: Chore Tracks' section in conductor/tracks.md: either remove entirely or replace with a one-line stub pointing to chronology.md." }
t3_2 = { status = "pending", commit_sha = "", description = "Prune [x] entries from 'Active Research Tracks' section; keep [ ] in-flight entries. Verify with grep that no [x] remains." }
t3_3 = { status = "pending", commit_sha = "", description = "Prune [shipped: ...] entries from 'Follow-up (Planned, Not Yet Specced)' section; keep 'planned' and 'not yet specced' entries. Commit Phase 3." }

# Phase 4 tasks
t4_1 = { status = "pending", commit_sha = "", description = "Append 3-step archiving convention to conductor/workflow.md 'Notes > Editing this file' section per FR3. Commit Phase 4." }

# Phase 5 tasks
t5_1 = { status = "pending", commit_sha = "", description = "Write docs/reports/CHRONOLOGY_MIGRATION_20260619.md per FR4: count by status, count by section removed, list of notable non-track commits, list of documented exceptions, 10-20 row diff preview for user spot-check. Commit Phase 5." }

# Phase 6 tasks
t6_1 = { status = "pending", commit_sha = "", description = "User reviews conductor/chronology.md.draft + the migration report. Approves format, OR requests changes (loop back to Phase 2)." }

# Phase 7 tasks
t7_1 = { status = "pending", commit_sha = "", description = "Rename conductor/chronology.md.draft to conductor/chronology.md. Commit Phase 7." }

# Phase 8 tasks (per-row cross-check, 165+ rows)
# Each row's 5 fields are verified per FR6.
# This is a Tier 1 effort; rows are processed in batches of ~20 for commit granularity.
# Per the user directive: EVERY row, not a sample.
t8_1 = { status = "pending", commit_sha = "", description = "Batch 1 (~20 rows): cross-check the 20 newest tracks. Open each row, verify date/ID/status/summary/range. Fix any errors. Commit." }
t8_2 = { status = "pending", commit_sha = "", description = "Batch 2 (~20 rows): continue. Commit per batch." }
# ... (8-9 more batches to cover 165+ rows)

# Phase 9 tasks
t9_1 = { status = "pending", commit_sha = "", description = "Enumerate every folder in conductor/tracks/ and conductor/archive/. Compare to row set in chronology.md. Diff must be empty OR only contain documented exceptions (per migration report)." }
t9_2 = { status = "pending", commit_sha = "", description = "For each missing folder: add the row (and verify per FR6), OR document the exception in the migration report. Commit Phase 9." }

# Phase 10 tasks
t10_1 = { status = "pending", commit_sha = "", description = "User reviews the final chronology.md + migration report + completeness check result. Confirms: (a) format correct, (b) summaries accurate, (c) commit ranges right, (d) nothing missed. Records sign-off in the migration report." }

[verification]
phase_8_cross_check_complete = false
phase_9_completeness_check_complete = false
phase_10_user_signoff_recorded = false
chronology_md_committed = false
tracks_md_pruned = false
workflow_md_updated = false
migration_report_committed = false

[user_directives_logged]
cross_check_mandatory = "Per user 2026-06-19: 'EVERY SINGLE ENTRY MUST BE CROSS CHECKED TO MAKE SURE IT'S STILL CORRECT, AND NOTHING WAS MISSED.' Hard gate (FR6, VC10/11/12). No shortcut is acceptable."
helper_script_approved = "Per user 2026-06-19: helper script may be used, but is DRAFT-ONLY. The cross-check is the authority."
manual_maintenance = "Per user 2026-06-19: ongoing workflow is hand-edited (like tracks.md). The helper script is one-shot only."
no_day_estimates = "Per conductor/workflow.md Tier 1 Track Initialization Rules (added 2026-06-16). Scope measured in files/sites only."
date_source = "Per FR1: track slug date wins. First-commit date is the fallback when slug is missing."
