feat: track NH broadband install lifecycle (#533)

docs/nh-broadband-install-packet.example.md

@@ -1,7 +1,7 @@
 # NH Broadband Install Packet
 
-**Packet ID:** nh-bb-20260415-113232
-**Generated:** 2026-04-15T11:32:32.781304+00:00
+**Packet ID:** nh-bb-20260417-015617
+**Generated:** 2026-04-17T01:56:17.706676+00:00
 **Status:** pending_scheduling_call
 
 ## Contact
@@ -19,6 +19,26 @@
 
 residential-fiber
 
+## Availability Check
+
+- Status: pending
+- Checked at: pending
+- Notes: Pending exact-address lookup on nhbroadband.com
+
+## Pricing
+
+- Monthly cost: pending live quote
+- Install fee: pending live quote
+- Quoted at: pending
+- Notes: Pending live quote from NH Broadband
+
+## Appointment
+
+- Scheduled for: pending
+- Window: pending
+- Confirmation number: pending
+- Installer access notes: Driveway condition note pending
+
 ## Call Log
 
 - **2026-04-15T14:30:00Z** — no_answer
@@ -35,3 +55,11 @@ residential-fiber
 - [ ] Post-install: run speed test (fast.com / speedtest.net)
 - [ ] Log final speeds and appointment outcome
 
+## Post-Install Verification
+
+- Download: pending
+- Upload: pending
+- Latency: pending
+- Tested at: pending
+- Notes: Populate after installation completes
+

docs/nh-broadband-install-request.example.yaml

@@ -11,6 +11,31 @@ service:
 
 desired_plan: residential-fiber
 
+availability:
+  status: pending
+  checked_at: ""
+  notes: "Pending exact-address lookup on nhbroadband.com"
+
+pricing:
+  monthly_cost_usd:
+  install_fee_usd:
+  quoted_at: ""
+  notes: "Pending live quote from NH Broadband"
+
+appointment:
+  scheduled_for: ""
+  window: ""
+  confirmation_number: ""
+  installer_access_notes: "Driveway condition note pending"
+
+post_install:
+  speed_test:
+    download_mbps:
+    upload_mbps:
+    latency_ms:
+    tested_at: ""
+    notes: "Populate after installation completes"
+
 call_log:
   - timestamp: "2026-04-15T14:30:00Z"
     outcome: no_answer

reports/2026-04-16-genome-pipeline-status.md

@@ -1,61 +0,0 @@
-# Codebase Genome Pipeline — Status Report
-
-> Issue #665 | Pipeline 2: Deep Analysis of Every Repo
-> Generated: 2026-04-16
-
-## Pipeline Status
-
-The Codebase Genome pipeline generates GENOME.md for every Foundation repo. Each genome includes project overview, architecture diagram, key abstractions, test coverage, and sovereignty assessment.
-
-## Completion Matrix
-
-| # | Repo | Issue | PR | Status |
-|---|------|-------|-----|--------|
-| 1 | hermes-agent | #666 | — | ⏳ Pending |
-| 2 | the-nexus | #672 | #753 | ✅ Merged |
-| 3 | timmy-home | #673 | — | ⏳ Pending |
-| 4 | timmy-config | #674 | — | ⏳ Pending |
-| 5 | the-playground | #671 | #771 | 🔄 PR Open |
-| 6 | fleet-ops | #680 | #697 | 🔄 PR Open |
-| 7 | evennia-local-world | #677 | #756 | 🔄 PR Open |
-| 8 | wolf | #683 | #702 | 🔄 PR Open |
-| 9 | turboquant | #679 | #752 | 🔄 PR Open |
-| 10 | burn-fleet | #681 | #762 | 🔄 PR Open |
-| 11 | the-door | #675 | — | ⏳ Pending |
-| 12 | the-beacon | #676 | — | ⏳ Pending |
-| 13 | the-testament | #678 | — | ⏳ Pending |
-| 14 | compounding-intelligence | #676* | — | ⏳ Pending |
-| 15 | the-tower | — | — | ⏳ Pending |
-| 16 | timmy-academy | — | — | ⏳ Pending |
-
-## Summary
-
-| Metric | Count |
-|--------|-------|
-| Total repos | 16 |
-| Genomes merged | 1 |
-| PRs open | 5 |
-| Pending | 10 |
-| Completion | 37.5% (6/16 either merged or PR open) |
-
-## Velocity
-
-This session produced 5 new genomes in a single burn cycle:
-- wolf (repo 16/16)
-- turboquant (repo 12/16)
-- the-nexus (repo 5/16)
-- burn-fleet (repo 14/16)
-- the-playground (repo 11/16)
-
-Plus the evennia-local-world genome (repo 10/16).
-
-## Next Priorities
-
-1. Merge open PRs to clear the queue
-2. hermes-agent genome (#666) — largest and most complex repo
-3. timmy-home genome (#673) — meta-repo, reference for all others
-4. the-door genome (#675) — mission-critical crisis intervention
-
----
-
-*Pipeline 2 of 5 | Issue #665*

scripts/plan_nh_broadband_install.py

@@ -17,6 +17,27 @@ def load_request(path: str | Path) -> dict[str, Any]:
     data.setdefault("service", {})
     data.setdefault("call_log", [])
     data.setdefault("checklist", [])
+    data.setdefault("availability", {})
+    data.setdefault("pricing", {})
+    data.setdefault("appointment", {})
+    data.setdefault("post_install", {})
+    data["availability"].setdefault("status", "pending")
+    data["availability"].setdefault("checked_at", "")
+    data["availability"].setdefault("notes", "")
+    data["pricing"].setdefault("monthly_cost_usd", None)
+    data["pricing"].setdefault("install_fee_usd", None)
+    data["pricing"].setdefault("quoted_at", "")
+    data["pricing"].setdefault("notes", "")
+    data["appointment"].setdefault("scheduled_for", "")
+    data["appointment"].setdefault("window", "")
+    data["appointment"].setdefault("confirmation_number", "")
+    data["appointment"].setdefault("installer_access_notes", "")
+    data["post_install"].setdefault("speed_test", {})
+    data["post_install"]["speed_test"].setdefault("download_mbps", None)
+    data["post_install"]["speed_test"].setdefault("upload_mbps", None)
+    data["post_install"]["speed_test"].setdefault("latency_ms", None)
+    data["post_install"]["speed_test"].setdefault("tested_at", "")
+    data["post_install"]["speed_test"].setdefault("notes", "")
     return data
 
 
@@ -39,6 +60,19 @@ def build_packet(data: dict[str, Any]) -> dict[str, Any]:
     validate_request(data)
     contact = data["contact"]
     service = data["service"]
+    availability = data.get("availability", {})
+    pricing = data.get("pricing", {})
+    appointment = data.get("appointment", {})
+    post_install = data.get("post_install", {})
+    speed_test = post_install.get("speed_test", {})
+
+    status = "pending_scheduling_call"
+    if availability.get("status") == "unavailable":
+        status = "blocked_unavailable"
+    elif appointment.get("confirmation_number") or appointment.get("scheduled_for"):
+        status = "scheduled_install"
+    if speed_test.get("download_mbps") is not None:
+        status = "post_install_verified"
 
     return {
         "packet_id": f"nh-bb-{datetime.now(timezone.utc).strftime('%Y%m%d-%H%M%S')}",
@@ -55,18 +89,69 @@ def build_packet(data: dict[str, Any]) -> dict[str, Any]:
             "zip": service.get("zip", ""),
         },
         "desired_plan": data.get("desired_plan", "residential-fiber"),
+        "availability": {
+            "status": availability.get("status", "pending"),
+            "checked_at": availability.get("checked_at", ""),
+            "notes": availability.get("notes", ""),
+        },
+        "pricing": {
+            "monthly_cost_usd": pricing.get("monthly_cost_usd"),
+            "install_fee_usd": pricing.get("install_fee_usd"),
+            "quoted_at": pricing.get("quoted_at", ""),
+            "notes": pricing.get("notes", ""),
+        },
+        "appointment": {
+            "scheduled_for": appointment.get("scheduled_for", ""),
+            "window": appointment.get("window", ""),
+            "confirmation_number": appointment.get("confirmation_number", ""),
+            "installer_access_notes": appointment.get("installer_access_notes", ""),
+        },
         "call_log": data.get("call_log", []),
         "checklist": [
             {"item": item, "done": False} if isinstance(item, str) else item
             for item in data["checklist"]
         ],
-        "status": "pending_scheduling_call",
+        "post_install": {
+            "speed_test": {
+                "download_mbps": speed_test.get("download_mbps"),
+                "upload_mbps": speed_test.get("upload_mbps"),
+                "latency_ms": speed_test.get("latency_ms"),
+                "tested_at": speed_test.get("tested_at", ""),
+                "notes": speed_test.get("notes", ""),
+            }
+        },
+        "status": status,
     }
 
 
 def render_markdown(packet: dict[str, Any], data: dict[str, Any]) -> str:
     contact = packet["contact"]
     addr = packet["service_address"]
+    availability = packet["availability"]
+    pricing = packet["pricing"]
+    appointment = packet["appointment"]
+    speed_test = packet["post_install"]["speed_test"]
+
+    monthly_cost = pricing["monthly_cost_usd"]
+    install_fee = pricing["install_fee_usd"]
+    monthly_line = f"${monthly_cost:.2f}" if isinstance(monthly_cost, (int, float)) else "pending live quote"
+    install_line = f"${install_fee:.2f}" if isinstance(install_fee, (int, float)) else "pending live quote"
+    download_line = (
+        f"{speed_test['download_mbps']} Mbps"
+        if speed_test["download_mbps"] is not None else
+        "pending"
+    )
+    upload_line = (
+        f"{speed_test['upload_mbps']} Mbps"
+        if speed_test["upload_mbps"] is not None else
+        "pending"
+    )
+    latency_line = (
+        f"{speed_test['latency_ms']} ms"
+        if speed_test["latency_ms"] is not None else
+        "pending"
+    )
+
     lines = [
         f"# NH Broadband Install Packet",
         "",
@@ -89,6 +174,26 @@ def render_markdown(packet: dict[str, Any], data: dict[str, Any]) -> str:
         "",
         f"{packet['desired_plan']}",
         "",
+        "## Availability Check",
+        "",
+        f"- Status: {availability['status']}",
+        f"- Checked at: {availability['checked_at'] or 'pending'}",
+        f"- Notes: {availability['notes'] or 'pending exact-address lookup'}",
+        "",
+        "## Pricing",
+        "",
+        f"- Monthly cost: {monthly_line}",
+        f"- Install fee: {install_line}",
+        f"- Quoted at: {pricing['quoted_at'] or 'pending'}",
+        f"- Notes: {pricing['notes'] or 'pending live quote'}",
+        "",
+        "## Appointment",
+        "",
+        f"- Scheduled for: {appointment['scheduled_for'] or 'pending'}",
+        f"- Window: {appointment['window'] or 'pending'}",
+        f"- Confirmation number: {appointment['confirmation_number'] or 'pending'}",
+        f"- Installer access notes: {appointment['installer_access_notes'] or 'pending'}",
+        "",
         "## Call Log",
         "",
     ]
@@ -112,7 +217,17 @@ def render_markdown(packet: dict[str, Any], data: dict[str, Any]) -> str:
         mark = "x" if item.get("done") else " "
         lines.append(f"- [{mark}] {item['item']}")
 
-    lines.append("")
+    lines.extend([
+        "",
+        "## Post-Install Verification",
+        "",
+        f"- Download: {download_line}",
+        f"- Upload: {upload_line}",
+        f"- Latency: {latency_line}",
+        f"- Tested at: {speed_test['tested_at'] or 'pending'}",
+        f"- Notes: {speed_test['notes'] or 'pending'}",
+        "",
+    ])
     return "\n".join(lines)
 
 

tests/test_nh_broadband_install_planner.py

@@ -35,6 +35,11 @@ def test_load_and_build_packet() -> None:
     assert packet["status"] == "pending_scheduling_call"
     assert len(packet["checklist"]) == 8
     assert packet["checklist"][0]["done"] is False
+    assert packet["availability"]["status"] == "pending"
+    assert packet["pricing"]["monthly_cost_usd"] is None
+    assert packet["pricing"]["install_fee_usd"] is None
+    assert packet["appointment"]["confirmation_number"] == ""
+    assert packet["post_install"]["speed_test"]["download_mbps"] is None
 
 
 def test_validate_rejects_missing_contact_name() -> None:
@@ -86,8 +91,12 @@ def test_render_markdown_contains_key_sections() -> None:
     assert "# NH Broadband Install Packet" in md
     assert "## Contact" in md
     assert "## Service Address" in md
+    assert "## Availability Check" in md
+    assert "## Pricing" in md
+    assert "## Appointment" in md
     assert "## Call Log" in md
     assert "## Appointment Checklist" in md
+    assert "## Post-Install Verification" in md
     assert "Concord" in md
     assert "NH" in md
 
@@ -103,3 +112,16 @@ def test_example_yaml_is_valid() -> None:
     data = yaml.safe_load(Path("docs/nh-broadband-install-request.example.yaml").read_text())
     assert data["contact"]["name"] == "Timmy Operator"
     assert len(data["checklist"]) == 8
+    assert data["availability"]["status"] == "pending"
+    assert data["appointment"]["confirmation_number"] == ""
+
+
+def test_render_markdown_shows_pending_live_fields() -> None:
+    data = load_request("docs/nh-broadband-install-request.example.yaml")
+    packet = build_packet(data)
+    md = render_markdown(packet, data)
+    assert "Status: pending" in md
+    assert "Monthly cost: pending live quote" in md
+    assert "Install fee: pending live quote" in md
+    assert "Confirmation number: pending" in md
+    assert "Download: pending" in md