{ "track_id": "metadata_ssdl_defusing_20260624", "name": "Metadata SSDL Defusing Campaign", "track_type": "campaign", "created_date": "2026-06-24", "branch": "master", "depends_on": ["code_path_audit_20260607"], "blocks": [], "child_tracks": [ { "track_id": "metadata_nil_sentinel_20260624", "name": "Child 1: Nil Sentinel", "blocked_by_parent": false, "blocks_within_campaign": ["metadata_generational_handle_20260624"] }, { "track_id": "metadata_generational_handle_20260624", "name": "Child 2: Generational Handle", "blocked_by_parent": true, "blocks_within_campaign": ["metadata_field_cache_20260624"] }, { "track_id": "metadata_field_cache_20260624", "name": "Child 3: Immediate-Mode Field Cache", "blocked_by_parent": true, "blocks_within_campaign": [] } ], "scope": { "new_files": [ "conductor/tracks/metadata_ssdl_defusing_20260624/spec.md", "conductor/tracks/metadata_ssdl_defusing_20260624/plan.md", "conductor/tracks/metadata_ssdl_defusing_20260624/metadata.json", "conductor/tracks/metadata_ssdl_defusing_20260624/state.toml", "conductor/tracks/metadata_nil_sentinel_20260624/*", "conductor/tracks/metadata_generational_handle_20260624/*", "conductor/tracks/metadata_field_cache_20260624/*", "tests/test_metadata_nil_sentinel.py", "tests/test_metadata_generational_handle.py", "tests/test_metadata_field_cache.py", "docs/reports/campaign_measurements_20260624.md", "docs/reports/TRACK_COMPLETION_metadata_ssdl_defusing_20260624.md" ], "modified_files": [ "src/aggregate.py", "src/ai_client.py", "src/history.py", "src/aggregate.py (additional functions as Tier 2 identifies)", "conductor/tracks.md" ], "deleted_files": [] }, "estimated_effort": { "method": "scope (per workflow.md §Tier 1 Track Initialization Rules). NO day estimates.", "child_1": "1 atomic commit (sentinel + 6 migrations) + 1 test + 1 verification", "child_2": "1 atomic commit (handle registry) + 1 test + 1 verification", "child_3": "1 atomic commit (field cache) + 1 test + 1 verification", "phase_4": "1 end-of-campaign report + state + tracks.md" }, "verification_criteria": [ "VC1: All 3 child tracks SHIPPED (status=completed, current_phase=complete, all phases completed)", "VC2: End-of-campaign report exists with 3 measurements + cumulative reduction", "VC3: Full batched test suite is green (all 11 tiers PASS)", "VC4: 4 audit gates remain clean", "VC5: No new top-level src/.py files (per AGENTS.md file naming convention)", "VC6: 3 behavioral tests for the 3 SSDL primitives exist and pass" ], "budget_gates": [ { "child": "metadata_nil_sentinel_20260624", "baseline": "4.01e22 effective codepaths for Metadata (pre-campaign)", "expected_drop": ">= 10%", "pause_threshold": "drop < 10%", "pause_action": "STOP campaign; report to user; investigate why 6 nil-checks didn't reduce branch count" }, { "child": "metadata_generational_handle_20260624", "baseline": "post-child-1 measurement", "expected_drop": ">= 20%", "pause_threshold": "drop < 20%", "pause_action": "STOP campaign; report to user; investigate why lifetime branches didn't collapse" }, { "child": "metadata_field_cache_20260624", "baseline": "post-child-2 measurement", "expected_drop": ">= 30%", "pause_threshold": "drop < 30%", "pause_action": "STOP campaign; report to user; investigate why cache lookups didn't reduce branch count" } ], "known_issues": [], "deferred_to_followup_tracks": [ { "id": "deferred-same-techniques-other-aggregates", "title": "Apply the 3 SSDL primitives to the other 9 in-scope aggregates (FileItem, CommsLogEntry, HistoryMessage, ToolDefinition, ToolCall, Result, the 3 list-typed, the 3 candidates)", "description": "The 3 SSDL primitives (NIL_METADATA, MetadataHandleRegistry, MetadataFieldCache) are general; the same pattern can be applied to other aggregates. The 4 other dict[str, Any] aggregates (FileItem, CommsLogEntry, HistoryMessage, ToolDefinition, ToolCall) show similar patterns per the parent audit Finding 2.", "track_status": "separate campaign post-this one" } ], "regressions_and_pre_existing_failures": [], "pre_existing_failures_remaining": [], "risk_register": [ { "id": "risk-1", "description": "Child 1 doesn't measurably drop the effective-codepaths number", "likelihood": "low", "impact": "Campaign pauses at child 1", "mitigation": "Budget gate catches this; investigate the SSDL math or the audit if drop is 0" }, { "id": "risk-2", "description": "Child 2 (generational handle) breaks code that expects raw Metadata", "likelihood": "medium", "impact": "Production code that does `entry['key']` directly fails; need wrapper migration", "mitigation": "The handle is a wrapper; consumers can extract raw value via .value or similar; behavioral test verifies backwards-compat" }, { "id": "risk-3", "description": "Child 3 (field cache) cache invalidation is wrong", "likelihood": "medium", "impact": "Stale values returned; subtle bug", "mitigation": "Cache keyed by handle; when underlying value changes, handle generation bumps, invalidating cache entries" }, { "id": "risk-4", "description": "Cumulative drop is less than expected", "likelihood": "low", "impact": "Campaign produces smaller improvement than expected", "mitigation": "The campaign's value is in the TECHNIQUE, not the final number; techniques ship, numbers are heuristic" } ] }