- tracks.md: new row 29 for the de-obfuscation campaign (priority A, research, awaits user samples)
- Pass 1 spec §11.1: superseded 2026-06-21; now points to the dedicated Pass 2 umbrella spec for the full handoff contract. The 'user must rediscover math encoding' action item is replaced by 'user provides 3-10 samples of past de-obfuscation notes; warmup derives the lexicon'
The MVP brute-force on code_path_audit_20260607 produced a working
AUDIT_REPORT.md (6797 lines, real per-aggregate numbers) but left:
1. 2 in-scope failing audit gates (weak_types regression of 5;
generate_type_registry --check drift).
2. 3 carry-over code smells (duplicate import json; dead DSL parser
with arity bugs; dead compute_result_coverage).
3. No behavioral test for the headline SSDL number (4.01e22).
4. Stale state.toml + tracks.md + spec_v2.md claiming v2 DSL shipped.
This track addresses all 4: 5 phases, 12 tasks, 12 atomic commits.
Out of scope (documented in metadata.json::known_issues): the 4
pre-existing exception-handling violations in other files; the 7
pre-existing Optional[T] violations in mcp_client.py/ai_client.py;
the 7-file split refactor.
Proposals analyzed:
- A (this): tight audit-gate cleanup, 30-60 min, 5 atomic commits.
- B: A + 7->1 refactor. Rejected: user said small.
- C: A + B + cross-cutting convention fixes. Rejected: crosses into
other tracks' territory.
Replaces the Phase 0 stub. Documents the per-aggregate profile
structure, the 4 decomposition directions, the override file
format, the 4 mem dim classification rules, and the 6-input
cross-audit integration contract.
Phase 1 data model: 19 unit tests passing. The 5 enums + 9
supporting dataclasses + AggregateProfile central artifact are
all in place. Phase 1 checkpoint at ef207cf6.
metadata.json: standard track metadata (15 fields per the
live_gui_test_fixes_20260618 precedent; includes scope,
depends_on, blocks, out_of_scope, tolerated_at_run_time,
test_summary, verification_criteria, 10 risks).
state.toml: initial state (status=active, current_phase=0;
14 phases pending; 19 verification flags all false).
TIER2_STARTUP.md: the per-track readme for the Tier 2 agent.
Track-specific supplement to conductor/tier2/agents/tier2-autonomous.md.
Covers: what to load (plan_v2.md first, spec_v2.md second;
do NOT load v1 spec/plan), hard bans (3-layer), conventions,
TDD protocol, per-task commit protocol, pre-delegation
checkpoint, failcount contract, 8 known gotchas, verification
protocol, end-of-track handoff, out-of-scope restatement.
EXPLICITLY NOTES:
- any_type_componentization_20260621 + phase2_4_5_call_site_completion_20260621
are NOT on master (merged f914b2bc, reverted 751b94d4).
v2 audit is tolerant of their absence.
- The 3 candidate aggregates (ToolSpec, ChatMessage,
ProviderHistory) are forward-compat placeholders with
is_candidate: True. The integration tests verify the
placeholder format (synthesize_aggregate_profile() in
Phase 9 Task 9.2 has the template hard-coded).
- The 1-line extension to scripts/audit_optional_in_3_files.py
is the audit gate; skipping Phase 12 Task 12.2 leaves the
new file uncovered by the Optional[T] ban.
Total v2 artifacts (committed):
- spec_v2.md (460 lines)
- plan_v2.md (5006 lines)
- metadata.json
- state.toml
- TIER2_STARTUP.md
Re-scopes the audit from 'expensive operations per action' (v1) to
'data pipelines per aggregate' (v2). The v1 framing was correct
2026-06-07 (the 4 foundational tracks were future) but is now
stale; v2 also cross-validates the data_structure_strengthening
+ data_oriented_error_handling deductions directly.
10 in-scope aggregates (Metadata, FileItem, FileItems,
CommsLogEntry, CommsLog, HistoryMessage, History, ToolDefinition,
ToolCall, Result[T]) + 3 candidate aggregates (ToolSpec,
ChatMessage, ProviderHistory; forward-compat placeholders for
any_type_componentization_20260621 which is NOT on master).
4 static analyses: PCG (3 AST passes), MemoryDim classifier,
APD (5 access patterns), CFE (7 frequencies). 11 public
functions, all return Result[T] per error_handling.md hard rule.
Decomposition-cost heuristic per aggregate answers: 'should
this data be componentize further (split) or unify further
(wider fat structs)?' 4 directions: componentize, unify, hold,
insufficient_data. 10-phase TDD plan, 69 tests total.
Consumes JSON from 6 existing audit scripts (cross-validates
data_structure_strengthening + data_oriented_error_handling).
Out-of-scope: runtime profiling (deferred to
pipeline_runtime_profiling_20260607), MMA worker spawn (cold).
v1 spec.md + plan.md preserved unchanged.
ed