Add v0.2 planning toolkit

Author: n57d30top

.github/workflows/ci.yml

@@ -42,6 +42,8 @@ jobs:
           jq empty reports/future-work/hrm-neural-mapping/calibration-plan.json
           jq empty reports/future-work/hrm-neural-mapping/complex-unitary-mesh-support.json
           jq empty reports/future-work/hrm-neural-mapping/error-budget-report.json
+          jq empty reports/future-work/hrm-neural-mapping/hardware-design-space-analysis.json
+          jq empty reports/future-work/hrm-neural-mapping/hardware-design-space-sweep.json
           jq empty reports/future-work/hrm-neural-mapping/hardware-requirements-analysis.json
           jq empty reports/future-work/hrm-neural-mapping/hardware-requirements-envelope.json
           jq empty reports/future-work/hrm-neural-mapping/hardware-scenario-analysis.json
@@ -50,6 +52,10 @@ jobs:
           jq empty reports/future-work/hrm-neural-mapping/layer-stack-error-analysis.json
           jq empty reports/future-work/hrm-neural-mapping/matrix-family-benchmark.json
           jq empty reports/future-work/hrm-neural-mapping/matrix-family-analysis.json
+          jq empty reports/future-work/hrm-neural-mapping/model-export-adapter-demo.json
+          jq empty reports/future-work/hrm-neural-mapping/model-export-adapter-validation.json
+          jq empty reports/future-work/hrm-neural-mapping/model-portfolio-benchmark.json
+          jq empty reports/future-work/hrm-neural-mapping/model-portfolio-ranking.json
           jq empty reports/future-work/hrm-neural-mapping/model-to-hrm-decision-report.json
           jq empty reports/future-work/hrm-neural-mapping/model-weight-import-demo.json
           jq empty reports/future-work/hrm-neural-mapping/model-weight-eligibility-analysis.json
@@ -70,6 +76,7 @@ jobs:
           jq empty reports/future-work/hrm-neural-mapping/stage-6-measured-transfer-matrix-gate.json
           jq empty reports/future-work/hrm-neural-mapping/stage-7-hardware-benchmark-gate.json
           jq empty reports/future-work/hrm-neural-mapping/transfer-matrix-assimilation-plan.json
+          jq empty reports/future-work/hrm-neural-mapping/transfer-matrix-ingestion-sandbox.json
           jq empty reports/future-work/hrm-neural-mapping/v0.1.0-rc1-readiness.json
           jq empty reports/future-work/hrm-neural-mapping/validation-ladder-summary.json
 

Makefile

@@ -17,6 +17,8 @@ json:
 	jq empty reports/future-work/hrm-neural-mapping/calibration-plan.json
 	jq empty reports/future-work/hrm-neural-mapping/complex-unitary-mesh-support.json
 	jq empty reports/future-work/hrm-neural-mapping/error-budget-report.json
+	jq empty reports/future-work/hrm-neural-mapping/hardware-design-space-analysis.json
+	jq empty reports/future-work/hrm-neural-mapping/hardware-design-space-sweep.json
 	jq empty reports/future-work/hrm-neural-mapping/hardware-requirements-analysis.json
 	jq empty reports/future-work/hrm-neural-mapping/hardware-requirements-envelope.json
 	jq empty reports/future-work/hrm-neural-mapping/hardware-scenario-analysis.json
@@ -25,6 +27,10 @@ json:
 	jq empty reports/future-work/hrm-neural-mapping/layer-stack-error-analysis.json
 	jq empty reports/future-work/hrm-neural-mapping/matrix-family-benchmark.json
 	jq empty reports/future-work/hrm-neural-mapping/matrix-family-analysis.json
+	jq empty reports/future-work/hrm-neural-mapping/model-export-adapter-demo.json
+	jq empty reports/future-work/hrm-neural-mapping/model-export-adapter-validation.json
+	jq empty reports/future-work/hrm-neural-mapping/model-portfolio-benchmark.json
+	jq empty reports/future-work/hrm-neural-mapping/model-portfolio-ranking.json
 	jq empty reports/future-work/hrm-neural-mapping/model-to-hrm-decision-report.json
 	jq empty reports/future-work/hrm-neural-mapping/model-weight-import-demo.json
 	jq empty reports/future-work/hrm-neural-mapping/model-weight-eligibility-analysis.json
@@ -45,6 +51,7 @@ json:
 	jq empty reports/future-work/hrm-neural-mapping/stage-6-measured-transfer-matrix-gate.json
 	jq empty reports/future-work/hrm-neural-mapping/stage-7-hardware-benchmark-gate.json
 	jq empty reports/future-work/hrm-neural-mapping/transfer-matrix-assimilation-plan.json
+	jq empty reports/future-work/hrm-neural-mapping/transfer-matrix-ingestion-sandbox.json
 	jq empty reports/future-work/hrm-neural-mapping/v0.1.0-rc1-readiness.json
 	jq empty reports/future-work/hrm-neural-mapping/validation-ladder-summary.json
 

README.md

@@ -143,6 +143,9 @@ Key files:
 - `complex-unitary-mesh-support.json`
 - `error-budget-report.json`
 - `error-budget-analysis.md`
+- `hardware-design-space-sweep.json`
+- `hardware-design-space-analysis.json`
+- `hardware-design-space-pareto.md`
 - `hardware-requirements-envelope.json`
 - `hardware-requirements-analysis.json`
 - `hardware-scenario-estimates.json`
@@ -151,6 +154,11 @@ Key files:
 - `layer-stack-error-analysis.json`
 - `matrix-family-benchmark.json`
 - `matrix-family-analysis.json`
+- `model-export-adapter-demo.json`
+- `model-export-adapter-validation.json`
+- `model-portfolio-benchmark.json`
+- `model-portfolio-ranking.json`
+- `model-portfolio-decision-summary.md`
 - `model-to-hrm-decision-report.json`
 - `model-to-hrm-decision-report.md`
 - `model-weight-import-demo.json`
@@ -177,6 +185,7 @@ Key files:
 - `stage-6-measured-transfer-matrix-gate.json`
 - `stage-7-hardware-benchmark-gate.json`
 - `transfer-matrix-assimilation-plan.json`
+- `transfer-matrix-ingestion-sandbox.json`
 - `v0.1.0-rc1-readiness.json`
 - `v0.1.0-rc1-readiness.md`
 - `validation-ladder-summary.json`
@@ -194,9 +203,14 @@ Schema documentation for future hardware evidence gates:
 - `docs/future-work/measured-transfer-matrix-fixture-schema.md`
 - `docs/future-work/hardware-benchmark-acceptance-schema.md`
 - `docs/future-work/model-weight-manifest-schema.md`
+- `docs/future-work/model-export-adapter-protocol.md`
 - `docs/future-work/transfer-matrix-assimilation-protocol.md`
 - `docs/ROADMAP-v0.2.md`
 
+The static dashboard is written to:
+
+- `dashboard/index.html`
+
 ## Stage 2 Interpretation
 
 Stage 2 is complete only as an abstract mesh simulation.
@@ -392,6 +406,59 @@ The scaling reports do not claim hardware latency, hardware throughput, hardware
 energy efficiency, accelerator performance, foundry calibration, measured
 transfer matrices, or production inference readiness.
 
+## v0.2 Planning Toolkit
+
+Post-v0.1.0 work extends the simulation-only framework into a more usable
+planning toolkit without changing hardware evidence status.
+
+The model-portfolio artifacts are:
+
+- `model-portfolio-benchmark.json`
+- `model-portfolio-ranking.json`
+- `model-portfolio-decision-summary.md`
+
+They compare `tiny_mlp`, `projection_chain`, `low_rank_adapter_demo`,
+`sparse_linear_demo`, and `transformer_block_manifest_only` fixtures. The
+ranking is a simulation-only planning label, not hardware evidence.
+
+The optional export-adapter artifacts are:
+
+- `model-export-adapter-demo.json`
+- `model-export-adapter-validation.json`
+- `docs/future-work/model-export-adapter-protocol.md`
+
+They define how an external framework exporter can write the existing manifest
+format. PyTorch remains optional and is not a required dependency.
+
+The design-space explorer artifacts are:
+
+- `hardware-design-space-sweep.json`
+- `hardware-design-space-analysis.json`
+- `hardware-design-space-pareto.md`
+
+They sweep phase bits, insertion loss, phase noise, and calibration interval
+proxies. Latency and energy fields are deterministic planning proxies only.
+
+The transfer-matrix ingestion sandbox artifact is:
+
+- `transfer-matrix-ingestion-sandbox.json`
+
+It uses a synthetic test-only fixture to exercise ingestion, normalization, and
+target-vs-observed comparison logic. It is not measured transfer-matrix
+evidence and it keeps Stage 6 blocked.
+
+The CLI and dashboard artifacts are:
+
+- `hrmwtp check`
+- `hrmwtp regenerate`
+- `hrmwtp summary`
+- `hrmwtp decision`
+- `hrmwtp list-reports`
+- `dashboard/index.html`
+
+The dashboard is static HTML summarizing generated simulation reports. It is not
+hardware evidence.
+
 ## Planning Reports
 
 Post-alpha.12 planning reports turn the simulation-only framework into a
@@ -626,12 +693,21 @@ Completed post-alpha.12 main work:
 - model-to-HRM decision report added for suitability, error, scenario, requirement, and missing-evidence review.
 - v0.1.0-rc.1 readiness report and `docs/ROADMAP-v0.2.md` added for release-candidate review.
 
+Completed v0.2.0-alpha.1 main work:
+
+- model portfolio benchmark and ranking added for five deterministic model fixtures.
+- optional model-export adapter protocol added without a hard PyTorch dependency.
+- design-space explorer added for phase bits, loss, noise, and calibration interval planning proxies.
+- synthetic transfer-matrix ingestion sandbox added while keeping Stage 6 blocked.
+- `hrmwtp` CLI added for check, regenerate, summary, decision, and report-list workflows.
+- static dashboard added at `dashboard/index.html`.
+
 Near-term:
 
 - keep CI green for report generation, JSON validation, hashes, tests, local-path hygiene, and claim-boundary checks
-- review `v0.1.0-rc.1` readiness artifacts before tagging a release candidate
+- review `v0.2.0-alpha.1` artifacts before broadening model fixtures
 - keep Stage 5, Stage 6, and Stage 7 blocked until real external evidence exists
-- use `docs/ROADMAP-v0.2.md` to plan optional exporters, richer fixtures, and measured-data ingestion only when real data exists
+- keep synthetic transfer-matrix sandbox outputs separate from public measured evidence
 
 Later, only when evidence exists:
 

dashboard/index.html

@@ -0,0 +1,47 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>HRM Planning Dashboard</title>
+  <style>
+    body { font-family: system-ui, sans-serif; margin: 2rem; color: #172026; background: #f7f8f4; }
+    header { max-width: 920px; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 1rem; margin: 2rem 0; }
+    section { background: #ffffff; border: 1px solid #d5d9ce; border-radius: 8px; padding: 1rem; }
+    h1, h2 { margin: 0 0 0.5rem; }
+    table { border-collapse: collapse; width: 100%; background: #ffffff; }
+    th, td { border: 1px solid #d5d9ce; padding: 0.5rem; text-align: left; }
+    th { background: #e9ece2; }
+    code { background: #ecefe8; padding: 0.1rem 0.25rem; border-radius: 4px; }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>HRM Simulation Planning Dashboard</h1>
+    <p>This static dashboard summarizes simulation-only reports. It is not hardware evidence.</p>
+  </header>
+  <main>
+    <div class="grid">
+      <section><h2>Decision</h2><p>blocked_by_missing_hardware_evidence</p></section>
+<section><h2>Suitability Score</h2><p>87.647</p></section>
+<section><h2>Best Portfolio Candidate</h2><p>low_rank_adapter_demo</p></section>
+<section><h2>Design Pareto Candidates</h2><p>4</p></section>
+<section><h2>Hardware Gates Blocked</h2><p>3</p></section>
+    </div>
+    <h2>Stage Status</h2>
+    <table>
+      <thead><tr><th>Stage</th><th>Report</th><th>Status</th><th>Evidence Level</th></tr></thead>
+      <tbody><tr><td>0</td><td>stage-0-specification</td><td>complete</td><td>theoretical_extension</td></tr>
+<tr><td>1</td><td>stage-1-svd-demo</td><td>complete</td><td>numerical_simulation</td></tr>
+<tr><td>2</td><td>stage-2-mesh-constrained</td><td>complete</td><td>abstract_mesh_simulation</td></tr>
+<tr><td>3</td><td>stage-3-perturbation-model</td><td>complete</td><td>uncalibrated_perturbation_simulation</td></tr>
+<tr><td>4</td><td>stage-4-simulated-calibration</td><td>complete</td><td>synthetic_calibration_simulation</td></tr>
+<tr><td>5</td><td>stage-5-foundry-calibration-gate</td><td>blocked</td><td>foundry_calibration_gate</td></tr>
+<tr><td>6</td><td>stage-6-measured-transfer-matrix-gate</td><td>blocked</td><td>measured_transfer_matrix_gate</td></tr>
+<tr><td>7</td><td>stage-7-hardware-benchmark-gate</td><td>blocked</td><td>hardware_benchmark_gate</td></tr></tbody>
+    </table>
+    <p>Claim boundary: hardware validation, foundry calibration, measured transfer matrices, and production inference readiness remain false.</p>
+  </main>
+</body>
+</html>

docs/ROADMAP-v0.2.md

@@ -5,13 +5,13 @@ Stage 5, Stage 6, and Stage 7 remain blocked by default.
 
 ## Recommended Work
 
-- optional PyTorch export adapter that emits the existing manifest format without adding a hard runtime dependency
-- larger deterministic model manifest fixtures
-- richer model suitability scoring with unsupported-layer penalties
-- transfer-matrix measured-data ingestion only when real measured artifacts exist
-- optional visualization dashboard for generated reports
-- stronger synthetic calibration models with explicit limitations
-- foundry or PDK integration only with real external evidence
+- expand the model portfolio beyond deterministic fixtures
+- add richer optional PyTorch export adapter examples while keeping framework dependencies optional
+- improve design-space objective functions with measured data only when real evidence exists
+- keep synthetic transfer-matrix ingestion sandbox separate from Stage 6 public evidence
+- extend the static dashboard with report filtering
+- strengthen synthetic calibration models with explicit limitations
+- add foundry or PDK integration only with real external evidence
 
 ## Claim Boundary