docs: 6-phase production path + version↔phase mapping

[hyperpolymath]

Summary

Adds docs/PRODUCTION-PATH.adoc as the canonical 6-phase strategic plan from pre-alpha to production-ready, with explicit gates, load-bearing decisions, and a comparison landscape locating typed-wasm against MS-Wasm / CHERI-Wasm / wasmGC / AssemblyScript / Rust / CompCert at each maturity level.

ROADMAP.adoc now opens with a version-axis ↔ phase-axis mapping so the two stay coherent (version cuts can happen mid-phase; phase transitions usually need several version cuts to accumulate).

README.adoc Status section now points readers at PRODUCTION-PATH.

What's in the plan

Phase	Theme	Duration	Gate
0	Stabilize foundation	weeks (in flight)	CI green, no merged red, ROADMAP truthful
1	End-to-end producer	4–6 months	.twasm → .wasm round-trips for all examples
2	Multi-producer adoption	6–12 months	≥3 independent producers ship wasm that passes the verifier
3	Runtime-side enforcement	9–18 months	Reference runtime detects an L7+ violation the verifier missed
4	Tooling + DX	12–24 months	Outside-ecosystem user ships without maintainer support
5	Spec + standards	18–36 months	1.0 spec frozen; conformance suite; academic publication
6	Production hardening	24–36 months	SLA + CVE process + ≥1 production deployment + case study

Also documents the six load-bearing decisions due in the first year (bytecode vs. compile-to-wasm; producer-side-only vs. runtime-aware; W3C CG vs. independent; Idris2-only vs. dual proof implementation; MPL-2.0 vs. dual-license; single-maintainer vs. recruit committers).

Scope clarification

The plan explicitly targets "serious-systems compile target adopted outside hyperpolymath" — not "W3C-standardized bytecode peer to wasm" (different project) and not "own bytecode that runtimes execute natively" (out of scope).

Out of scope for this PR

• Opening the six per-phase tracking issues — lands as a separate operation after this merges
• Phase 0 work itself — already in flight via PR CI triage: fix 4 of 6 persistent red jobs on main #46 (CI triage) and subsequent Track A/B/C PRs
• Code changes — docs only

Test plan

• docs/PRODUCTION-PATH.adoc renders as valid AsciiDoc
• Cross-references between README / ROADMAP / PRODUCTION-PATH resolve
• No load-bearing claims contradict LEVEL-STATUS.md, ECHIDNA results, or existing ADRs

---

Generated by Claude Code

[github-actions]

🔍 Hypatia Security Scan

Findings: 119 issues detected

Severity	Count
🔴 Critical	6
🟠 High	54
🟡 Medium	59

⚠️ Action Required: Critical security issues found!

View findings

[
  {
    "reason": "Issue in quality.yml",
    "type": "missing_workflow",
    "file": "quality.yml",
    "action": "create",
    "rule_module": "workflow_audit",
    "severity": "high"
  },
  {
    "reason": "Issue in security-policy.yml",
    "type": "missing_workflow",
    "file": "security-policy.yml",
    "action": "create",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Action hyperpolymath/standards/.github/workflows/governance-reusable.yml@main needs attention",
    "type": "unpinned_action",
    "file": "governance.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "high"
  },
  {
    "reason": "Action actions/upload-artifact@v4 needs attention",
    "type": "unpinned_action",
    "file": "release.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Action actions/download-artifact@v4 needs attention",
    "type": "unpinned_action",
    "file": "release.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "believe_me undermines formal verification (1 occurrences, CWE-704)",
    "type": "believe_me",
    "file": "/home/runner/work/typed-wasm/typed-wasm/src/abi/TypedWasm/ABI/SessionProtocol.idr",
    "action": "flag",
    "rule_module": "code_safety",
    "severity": "critical"
  },
  {
    "reason": "assert_total bypasses totality checker (1 occurrences, CWE-704)",
    "type": "assert_total",
    "file": "/home/runner/work/typed-wasm/typed-wasm/src/abi/TypedWasm/ABI/SessionProtocol.idr",
    "action": "flag",
    "rule_module": "code_safety",
    "severity": "high"
  },
  {
    "reason": "believe_me undermines formal verification (1 occurrences, CWE-704)",
    "type": "believe_me",
    "file": "/home/runner/work/typed-wasm/typed-wasm/src/abi/TypedWasm/ABI/Echo.idr",
    "action": "flag",
    "rule_module": "code_safety",
    "severity": "critical"
  },
  {
    "reason": "assert_total bypasses totality checker (1 occurrences, CWE-704)",
    "type": "assert_total",
    "file": "/home/runner/work/typed-wasm/typed-wasm/src/abi/TypedWasm/ABI/Echo.idr",
    "action": "flag",
    "rule_module": "code_safety",
    "severity": "high"
  },
  {
    "reason": "believe_me undermines formal verification (1 occurrences, CWE-704)",
    "type": "believe_me",
    "file": "/home/runner/work/typed-wasm/typed-wasm/src/abi/TypedWasm/ABI/ResourceCapabilities.idr",
    "action": "flag",
    "rule_module": "code_safety",
    "severity": "critical"
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence