Private
Public Access
0
0
Files
manual_slop/conductor/tracks.md
T
ed e5a8a84381 docs(conductor): type_aliases count, tracks.md stale rows, index.md guide count
- product-guidelines.md: '10 aliases' -> core + extended per-aggregate
  dataclasses (Metadata, CommsLogEntry, ... PathInfo, FileItemsDiff,
  JsonPrimitive/JsonValue) reflecting the actual ~19 types in
  src/type_aliases.py.
- tracks.md: marked rows 2 (qwen_llama_grok), 3 (data_oriented_error
  handling), 17 (code_path_audit) as Completed per chronology.md
  (they were stale 'in progress' / 'ready to start'). Added cleanup
  note. data_structure_strengthening already dropped.
- index.md: '27 deep-dive guides' -> 41 (actual count in docs/);
  refreshed last doc-refresh date to 2026-07-02 with the drift-fix
  summary.
2026-07-02 19:02:35 -04:00

115 lines
9.6 KiB
Markdown

# Project Tracks
This file tracks all major tracks for the project. Each track has its own detailed plan in its respective folder (or in `../archive/<track_name>/` for completed tracks).
**Structure:**
- **Active Tracks (Current Queue):** In-flight and unblocked work the implementer can pick up today.
- **Standby / Pending Spec:** Tracks with spec TBD or pending decision.
- **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).
Archive directories live at `../archive/<track_name>/` (from this file's location at `conductor/tracks.md`).
---
## Active Tracks (Current Queue)
Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked-by first) and **priority** (A foundational → D forward-looking).
| # | 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) |
| 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) |
| 25 | B | [Fable System Prompt Review](#track-fable-review) | spec ✓, plan pending | (none) |
| 26 | A | [Video Analysis Campaign (Pass 1 of 3)](#track-video-analysis-campaign) | scaffolded; awaiting Phase 0 tooling | (none) |
| 29 | A | [Video Analysis De-obfuscation Campaign (Pass 2 of 3)](#track-video-analysis-deob) | scaffolded; awaits USER action item | (none) |
| 29c | A | [Pass 3 — C11/Python Projection](#track-pass-3-c11python-projection) | spec DRAFT pending user review | 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) | spec ✓, plan ✓, ready to start | (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/`
- **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/tracks/sqlite_docs_gui_2_continued_20260613/` (7c is the ai_client continuation)
- **Context First Message Fix** → `conductor/tracks/context_first_message_fix_20260604/`
---
## Standby / Pending Spec
| # | Priority | Track | Status | Blocked By |
|---|---|---|---|---|
| 6 | D | [Public API Result Migration](#track-public-api-result-migration) | placeholder; not yet specced | data_oriented_error_handling (deprecated send()) |
| 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) |
| 11 | — | [C# Language Support Tools](#track-csharp-language-support-tools) | spec TBD | (none) |
| 12 | — | [OpenAI Provider Integration](#track-openai-provider-integration) | spec TBD | (none) |
| 13 | — | [Zhipu AI (GLM) Provider Integration](#track-zhipu-integration) | spec TBD | (none) |
| 14 | — | [AI Provider Caching Optimization](#track-caching-optimization) | spec TBD | (none) |
| 15 | — | [Manual UX Validation & Review](#track-manual-ux-validation) | spec TBD | (none) |
| 15a | — | [Manual UX Validation — ASCII-Sketch Workflow](#track-manual-ux-validation-ascii) | spec ✓, plan ✓, ready to start | (none) |
| 15b | — | [Chunkification Optimization (Contingency)](#track-chunkification-optimization) | spec ✓ (contingency), no plan | hard constraint surface (deferred) |
| 16 | — | [GenCpp Dogfood Feedback Loop](#track-gencpp-dogfood-feedback) | spec TBD | (none) |
| 18 | — | [GUI Architecture Refinement](#track-gui-architecture-refinement) | no spec.md | (TBD) |
### Standby track anchors
- **Public API Result Migration** → placeholder (not yet specced)
- **Bootstrap gencpp Python Bindings** → `conductor/tracks/gencpp_python_bindings_20260308/`
- **Tree-Sitter Lua MCP Tools** → `conductor/tracks/tree_sitter_lua_mcp_tools_20260310/`
- **GDScript Language Support Tools** → `conductor/tracks/gdscript_godot_script_language_support_tools_20260310/`
- **C# Language Support Tools** → `conductor/tracks/csharp_language_support_tools_20260310/`
- **OpenAI Provider Integration** → `conductor/tracks/openai_integration_20260308/`
- **Zhipu AI (GLM) Provider Integration** → `conductor/tracks/zhipu_integration_20260308/`
- **AI Provider Caching Optimization** → `conductor/tracks/caching_optimization_20260308/`
- **Manual UX Validation & Review** → `conductor/tracks/manual_ux_validation_20260302/`
- **Manual UX Validation — ASCII-Sketch Workflow** → `conductor/tracks/manual_ux_validation_20260608_PLACEHOLDER/`
- **Chunkification Optimization (Contingency)** → `conductor/tracks/chunkification_optimization_20260608_PLACEHOLDER/`
- **GenCpp Dogfood Feedback Loop** → `conductor/tracks/gencpp_dogfood_feedback_20260510/`
- **GUI Architecture Refinement** → (no spec.md)
---
> **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`.
---
## Notes
**Archive link convention:** `./archive/...` paths resolve to `conductor/archive/...` (this file is at `conductor/tracks.md`).
**Status legend:**
- `[ ]` not started
- `[~]` in progress
- `[x]` completed (track may still be in `tracks/` or may have been moved to `archive/`)
- `~~**...**~~` struck-through (renamed/replaced/superseded)
**Naming convention:** Each track's `spec.md` and `plan.md` (where present) follow the project's standard format: `spec.md` for design intent (the "why"), `plan.md` for executable tasks (the "how").
**Editing this file:** When you mark a track as `[x]` and move its folder to `archive/`, remove its row from the Active Tracks table (its history is in `chronology.md`). When you start a new track, create the folder under `tracks/` first, then add the entry to the Active Tracks table.
**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.