{
  "title": "Steel Tongue Drum - V5 issue readiness packet",
  "repo": "tonykoop/steel-tongue-drum",
  "issue": 5,
  "generated": "2026-05-18",
  "readiness": {
    "current_status": "L2 root-mode packet / prototype planning",
    "fabrication_authority": "not build-ready without measured prototype data",
    "v5_status": "partial; packet/explorer surfaces exist, but CAD/DXF authority, measured tuning logs, and MCP provenance remain future work",
    "authority_note": "The workbook and packet tables are planning authority for first prototype layout. They do not prove final slot geometry, tuning, heat/stress behavior, or safety until the real blank, kerf coupon, first-strike, tuning, mount, finish, and drift checks are logged.",
    "measurement_note": "Every target frequency, slot geometry, heat/stress, tuning, support, and finish claim remains evidence-bound until validation.csv is populated from an actual steel prototype."
  },
  "entrypoints": {
    "explorer": "explorer.html",
    "site": "site/index.html",
    "readme": "README.md",
    "print_packet_html": "print-packet.html",
    "print_packet_pdf": "print-packet.pdf",
    "capstone_deck_markdown": "capstone-deck.md",
    "capstone_deck_pptx": "capstone-deck.pptx"
  },
  "packet_files": [
    "README.md",
    "design.md",
    "family-spec.csv",
    "bom.csv",
    "sourcing.csv",
    "cut-list.csv",
    "drawing-brief.md",
    "assembly-manual.md",
    "validation.csv",
    "validation-report.md",
    "data/measurement-capture-plan.md",
    "data/coupon-cam-cad-log.csv",
    "cnc/coupon-first-cam-cad-gate.md",
    "risks.md",
    "resources.md",
    "jig-decision.md",
    "photo-shotlist.md",
    "supplier-rfq.md",
    "visual-bom-brief.md",
    "steel-tongue-drum-starter.wl"
  ],
  "authority_files": [
    "steel-tongue-drum-design-table.xlsx",
    "family-spec.csv",
    "validation.csv",
    "visual-output-register.csv"
  ],
  "visual_assets": [
    "drawings/steel-tongue-drum-layout.svg"
  ],
  "v5_gap_register": [
    {
      "deliverable": "cad/steel-tongue-drum.scad or equivalent CAD source",
      "status": "missing",
      "next_action": "Create parametric CAD from the design-table and family-spec values before claiming V5 CAD authority."
    },
    {
      "deliverable": "drawings/steel-tongue-drum.dxf",
      "status": "missing",
      "next_action": "Export a reviewed DXF with slot geometry, root radius, datum, kerf, and stress-relief notes before any cut-ready claim."
    },
    {
      "deliverable": "coupon-first CAM/CAD authority evidence",
      "status": "blocked-no-coupon-evidence",
      "next_action": "Populate data/coupon-cam-cad-log.csv from a real material/process coupon before promoting CAD, DXF, CAM, or G-code authority."
    },
    {
      "deliverable": "measured tuning log",
      "status": "missing",
      "next_action": "Populate validation.csv with real first-strike, trim, mount, finish, and drift readings for every tongue."
    },
    {
      "deliverable": "heat/stress process evidence",
      "status": "missing",
      "next_action": "Log actual cutter, heat affected zone or taper, burr condition, warp, and slot-root inspection from coupon and prototype work."
    },
    {
      "deliverable": "images/hero-render.png and exploded diagram",
      "status": "missing",
      "next_action": "Create only after CAD source exists; record as derived_preview or concept_only, not dimensional authority."
    },
    {
      "deliverable": "cad/mcp-session-log.md",
      "status": "missing",
      "next_action": "Start MCP provenance log when MCP-authored V5 artifacts are created."
    }
  ],
  "validation_commands": [
    "jq . capstone-manifest.json",
    "python3 -c \"import csv; files=['validation.csv','visual-output-register.csv','data/coupon-cam-cad-log.csv']; [print(f, len(list(csv.DictReader(open(f, newline=''))))) for f in files]\"",
    "test -f explorer.html",
    "python3 ${CODEX_HOME:-$HOME/.codex}/skills/instrument-maker/scripts/validate_visual_authority.py visual-output-register.csv",
    "python3 ${CODEX_HOME:-$HOME/.codex}/skills/instrument-maker/scripts/validate_acoustic_law.py family-spec.csv",
    "git diff --check"
  ],
  "notes": [
    "All artifact paths are repository-relative.",
    "This manifest intentionally preserves the current Wolfram source path, steel-tongue-drum-starter.wl; the inspected stash row used an older steel-tongue-drum-starter.wl name.",
    "Issue #5 remains blocked on coupon evidence; this round adds the gate and evidence template without claiming complete V5, L3, measured, CAM-ready, or build-ready status."
  ]
}