feat(phase-ii): evidence assembly + commercialization plan refinement

.github/workflows/phase-ii-pdf.yml

@@ -0,0 +1,89 @@
+name: phase-ii-pdf
+
+# Auto-renders phase-ii/evidence-package.md to PDF via Pandoc on every push to main
+# that touches the evidence package. PDF is uploaded as a workflow artifact
+# (downloadable from the workflow run). The source-of-truth is the .md file;
+# the PDF is a derived artifact and is not committed back to the repo.
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'phase-ii/evidence-package.md'
+      - '.github/workflows/phase-ii-pdf.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'phase-ii/evidence-package.md'
+      - '.github/workflows/phase-ii-pdf.yml'
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+jobs:
+  render-pdf:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Pandoc and XeLaTeX
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            pandoc \
+            texlive-xetex \
+            texlive-fonts-recommended \
+            texlive-latex-recommended \
+            texlive-latex-extra \
+            lmodern
+
+      - name: Render evidence-package.md to PDF
+        run: |
+          mkdir -p build/phase-ii
+          BUILD_DATE="$(date -u +%Y-%m-%d)"
+          pandoc phase-ii/evidence-package.md \
+            -o build/phase-ii/evidence-package.pdf \
+            --pdf-engine=xelatex \
+            --variable=geometry:margin=1in \
+            --variable=fontsize:11pt \
+            --variable=colorlinks:true \
+            --variable=linkcolor:blue \
+            --variable=urlcolor:blue \
+            --variable=toccolor:blue \
+            --toc \
+            --toc-depth=2 \
+            --metadata=date:"$BUILD_DATE"
+
+      - name: Verify PDF rendered
+        run: |
+          test -s build/phase-ii/evidence-package.pdf || {
+            echo "::error::evidence-package.pdf is empty or missing"
+            exit 1
+          }
+          ls -la build/phase-ii/
+
+      - name: Upload PDF artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: phase-ii-evidence-package-pdf
+          path: build/phase-ii/evidence-package.pdf
+          if-no-files-found: error
+          retention-days: 90
+
+  link-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: lychee link-check on evidence-package.md
+        uses: lycheeverse/lychee-action@v1
+        with:
+          args: >-
+            --no-progress
+            --max-redirects 5
+            --timeout 20
+            --accept 200,206,301,302,308,403,429
+            --exclude '^mailto:'
+            --exclude '^https?://(localhost|127\.0\.0\.1)'
+            phase-ii/evidence-package.md
+          fail: false  # warn-only — flip to true once all referenced artifacts have stable URLs

docs/phase-ii/commercialization-plan-refined.md

@@ -0,0 +1,4 @@
+{%
+   include-markdown "../../phase-ii/commercialization-plan-refined.md"
+   rewrite-relative-urls=false
+%}

docs/phase-ii/evidence-package.md

@@ -0,0 +1,4 @@
+{%
+   include-markdown "../../phase-ii/evidence-package.md"
+   rewrite-relative-urls=false
+%}

docs/phase-ii/index.md

@@ -0,0 +1,4 @@
+{%
+   include-markdown "../../phase-ii/README.md"
+   rewrite-relative-urls=false
+%}

docs/phase-ii/phase-ii-proposal-draft.md

@@ -0,0 +1,4 @@
+{%
+   include-markdown "../../phase-ii/phase-ii-proposal-draft.md"
+   rewrite-relative-urls=false
+%}

mkdocs.yml

@@ -134,3 +134,8 @@ nav:
       - "Artifact B — Connectors + DONKI": specs/B-connectors-foundation.md
       - "Artifact C — Fusion-Engine Framework": specs/C-fusion-engine-framework.md
       - "Artifact D — Gannon Analysis": specs/D-gannon-analysis.md
+  - Phase II:
+      - "Overview": phase-ii/index.md
+      - "Evidence Package": phase-ii/evidence-package.md
+      - "Commercialization Plan (Refined)": phase-ii/commercialization-plan-refined.md
+      - "Phase II Proposal (Scaffold)": phase-ii/phase-ii-proposal-draft.md

phase-ii/README.md

@@ -0,0 +1,45 @@
+# HELIOS Phase II — evidence package
+
+**Last refreshed**: 2026-05-18 (initial assembly)
+**Status**: incremental — refreshed each session as new artifacts ship.
+
+This directory holds the **Phase II proposal evidence package** — operator-facing summary material curated from the existing HELIOS portfolio, ready to embed in the Phase II proposal narrative or hand to NASA-center reviewers as a one-shot orientation packet.
+
+## Read these in order
+
+1. **[`evidence-package.md`](./evidence-package.md)** — the single curated summary covering the 7 evidence categories (lead narrative, public artifacts, Gannon ground-truth observations, RFC engagement, Sprint C-Training methodology evolution, kill-gate placeholder, arXiv placeholder). **This is the document the operator hands to reviewers.** An auto-built PDF is uploaded as a workflow artifact on every push to `main` via [`.github/workflows/phase-ii-pdf.yml`](https://github.com/577Industries/helios-program/blob/main/.github/workflows/phase-ii-pdf.yml).
+2. **[`commercialization-plan-refined.md`](./commercialization-plan-refined.md)** — Phase I learnings → Phase II strategy refinement. Cites 5 specific Phase I learnings with cross-links to source artifacts. Refines proposal §6.2 revenue model and §6.3 go-to-market based on what Phase I actually surfaced.
+3. **[`phase-ii-proposal-draft.md`](./phase-ii-proposal-draft.md)** — section-by-section scaffold mirroring the submitted Phase I proposal's §1-8 structure, with placeholders flagging the Phase II adjustments (§1.3 Gannon retrospective → v2 real-SPP; §2 → Phase II success criteria; §3.3 vision → execution plan; new §4.3 "Phase I results" with cross-links to the evidence package).
+
+## Operator-action subdirectories
+
+Each holds a README inventory plus `.gitkeep` placeholder. **No fake LoI PDFs.** The operator fills these as outreach lands.
+
+| Subdirectory | What it tracks | Operator action |
+|---|---|---|
+| [`letters/`](https://github.com/577Industries/helios-program/blob/main/phase-ii/letters/README.md) | 8 LoI slots (ML engineer · SME consultant · ≥2 NASA-center · ≥2 ag-industry · 2 spare) | OPERATOR_TODO.md item 6-7 |
+| [`customer-discovery/`](https://github.com/577Industries/helios-program/blob/main/phase-ii/customer-discovery/README.md) | ≥10 prospective customers (Ohio/Midwest cooperatives, large family operations, OEM platform teams) | OPERATOR_TODO.md item 5 |
+| [`nasa-engagement/`](https://github.com/577Industries/helios-program/blob/main/phase-ii/nasa-engagement/README.md) | CCMC · M2M SWAO · SRAG · SPoRT contact records | OPERATOR_TODO.md item 7 |
+
+## Refresh policy
+
+Each refresh = a small focused commit with the trigger noted in the commit message and the **Last refreshed** line above advanced.
+
+| Trigger | Refresh action |
+|---|---|
+| Sprint D ships | Replace the §6 kill-gate placeholder in `evidence-package.md` with real HSS / Brier / CRPS numbers + reliability-diagram PNG + `results/<date>-killgate.json` cross-link |
+| arXiv submitted | Replace the §7 arXiv placeholder with `arXiv:YYYY.NNNNN` + DOI + cover letter URL |
+| TFT-TEC ships | Update Gannon ground-truth observation #3 (TEC 55.1 TECU) from CDDIS-synthetic to CDDIS-real and `gannon-storm-rtk-analysis` to v0.2.0 (v2 real-SPP) |
+| LoI lands | Drop the signed PDF into `letters/`; update `letters/README.md` inventory row |
+| Customer-discovery interview | New file at `customer-discovery/YYYY-MM-DD-<organization>.md`; update inventory |
+| NASA-center engagement record | New file at `nasa-engagement/<center>-YYYY-MM-DD.md`; update inventory |
+
+The auto-render workflow ([`phase-ii-pdf.yml`](https://github.com/577Industries/helios-program/blob/main/.github/workflows/phase-ii-pdf.yml)) rebuilds `evidence-package.pdf` on every push to `main` that touches `phase-ii/evidence-package.md`. The PDF is downloadable from the workflow run. Stale signals: if **Last refreshed** is more than 60 days behind the most recent companion footnotes-sync commit, the operator runs a top-to-bottom refresh.
+
+## Cross-references
+
+- Submitted Phase I proposal (locked): `/home/twawe/577i-Projects/SBIR Working Folder/NASA/HELIOS_NASA_SBIR_PhaseI_Proposal.docx`
+- Public companion (the lead narrative): [`../companion/companion.md`](https://github.com/577Industries/helios-program/blob/main/companion/companion.md)
+- Master plan: [`../plan/master-plan.md`](https://github.com/577Industries/helios-program/blob/main/plan/master-plan.md)
+- Dispatch spec for this assembly: [`../specs/2026-05-18-PhaseII-evidence-assembly-spec.md`](https://github.com/577Industries/helios-program/blob/main/specs/2026-05-18-PhaseII-evidence-assembly-spec.md)
+- Operator TODO: [`../OPERATOR_TODO.md`](https://github.com/577Industries/helios-program/blob/main/OPERATOR_TODO.md)