manual_slop/conductor/tracks/metadata_ssdl_defusing_20260624/metadata.json

{
  "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/<thing>.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"
    }
  ]
}