hakorune/docs/private/roadmap/phases/phase-20.29/CLAUDE_SPEC.md

Phase‑20.29 — Claude Handoff Spec (Rust Freeze + Self‑Host Loop)

Scope

• Make dev/quick default to Gate‑C(Core); keep wrappers opt‑in.
• Enforce Rust freeze: allow glue/ENV/bugfix; deny new semantics.
• Stabilize self‑host minimal loop and canaries.
• Start SSOT generation in lang with Rust consuming the result.

Tasks

• Runner defaults
  • Add a dev/quick overlay that sets HAKO_GATE_C_CORE=1 (docs only if code already supports); ensure file/pipe parity.
  • Ensure normalization (Method→Extern) runs only when HAKO_GATE_C_ENABLE_PLUGINS=1.
• Freeze enforcement
  • Add brief comments at handler/runner entry points clarifying freeze (no new semantics). No behavior change.
• Self‑host loop
  • Verify selfhost_bootstrap_min_vm.sh stays green; keep nested‑if opt‑in green with strict guards.
  • Expand builder canaries as needed (we already added set→compare).
• SSOT
  • Propose a minimal pipeline: lang emits a TOML/JSON table for externs; Rust reads it at build time. No runtime dependency added in this phase.

Non‑goals

• No new VM ops; no new plugin behaviors.
• No default behavior change outside dev/quick profiles (docs emphasize dev path preference).

Deliverables

• Updated docs (this phase), checklist items green, and no red in quick/integration‑core.