From 9d38d79abb8acc4bd42a42dfbf162c4e6e96dfb7 Mon Sep 17 00:00:00 2001
From: Sam Rolfe <samuelrolfe@gmail.com>
Date: Sat, 12 Sep 2026 09:04:29 +1000
Subject: [PATCH] Archify + README: add Whisper speech-to-text node (dsh ->
 whisper); maps republished

---
 README.md                                     |  1 +
 .../archify/family-home-lab.architecture.json | 24 +++++++++++++++++++
 docs/family-home-lab-map.html                 | 18 +++++++++++++-
 3 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a691403..d0f3f58 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,7 @@ flowchart LR
     D -->|LLM| OR[OmniRoute :20129]
     OR -->|chat/reasoning/coding| OC[opencode-go / deepseek]
     D -->|vision/video| OL[OpenRouter GPT-5 · GLM-5v]
+    D -->|audio → text| WS[Whisper faster-whisper :13:5000]
     P -->|Files/S3| G[(Garage S3 + shared-media)]
     G -.->|Borg| BACK[(Amazon S3 offsite)]
     U -->|Voice page| V[Jervis voice agent :8501]
diff --git a/docs/archify/family-home-lab.architecture.json b/docs/archify/family-home-lab.architecture.json
index 42eaaa9..50e02fc 100644
--- a/docs/archify/family-home-lab.architecture.json
+++ b/docs/archify/family-home-lab.architecture.json
@@ -184,6 +184,20 @@
         130,
         60
       ]
+    },
+    {
+      "id": "whisper",
+      "type": "backend",
+      "label": "Whisper",
+      "sublabel": "speech\u2192text :13:5000",
+      "pos": [
+        900,
+        150
+      ],
+      "size": [
+        120,
+        60
+      ]
     }
   ],
   "boundaries": [
@@ -262,6 +276,16 @@
       "label": "Borg sync",
       "variant": "dashed",
       "labelDy": -20
+    },
+    {
+      "id": "d-w",
+      "from": "dsh",
+      "to": "whisper",
+      "label": "audio \u2192 text",
+      "labelAt": [
+        760,
+        130
+      ]
     }
   ],
   "cards": [
diff --git a/docs/family-home-lab-map.html b/docs/family-home-lab-map.html
index 0a15227..5172594 100644
--- a/docs/family-home-lab-map.html
+++ b/docs/family-home-lab-map.html
@@ -4883,7 +4883,7 @@
 
     <!-- Main Diagram -->
     <div class="diagram-container" data-detail-level="read">
-      <svg viewBox="0 0 990 608" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="showcase">
+      <svg viewBox="0 0 1060 608" role="img" aria-labelledby="archify-diagram-title archify-diagram-description" data-preset="classic" data-quality-profile="showcase">
         <title id="archify-diagram-title">Family Home Lab</title>
         <desc id="archify-diagram-description">A architecture diagram generated by Archify.</desc>
         <!-- Definitions -->
@@ -4920,6 +4920,7 @@
         <path data-edge-from="portal" data-edge-to="redis" data-edge-label="async" data-edge-key="4" data-edge-id="p-r" data-composition-points="580,383;600,383;600,330;620,330" d="M 580 383 L 592 383 Q 600 383 600 375 L 600 338 Q 600 330 608 330 L 620 330" class="a-dashed" stroke-width="1.5" marker-end="url(#arrowhead-dashed)"/>
         <path data-edge-from="portal" data-edge-to="db" data-edge-label="SQL" data-edge-key="5" data-edge-id="p-db" data-composition-points="580,397;756,397;756,470;780,470" d="M 580 397 L 748 397 Q 756 397 756 405 L 756 462 Q 756 470 764 470 L 780 470" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
         <path data-edge-from="garage" data-edge-to="offsite" data-edge-label="Borg sync" data-edge-key="6" data-edge-id="g-o" data-composition-points="460,490;620,490" d="M 460 490 L 620 490" class="a-dashed" stroke-width="1.5" marker-end="url(#arrowhead-dashed)"/>
+        <path data-edge-from="dsh" data-edge-to="whisper" data-edge-label="audio → text" data-edge-key="7" data-edge-id="d-w" data-composition-points="750,180;900,180" d="M 750 180 L 900 180" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>
 
         <!-- Components -->
         <g id="node-users" data-node-id="users" data-node-label="Family" tabindex="0" role="button" aria-label="Focus Family, browsers / phones, Architecture component" aria-pressed="false" data-node-kind="external" data-node-sublabel="browsers / phones" data-node-context="Architecture component">
@@ -5046,6 +5047,17 @@
         <text data-detail="context" x="685" y="504" class="t-muted" font-size="9" text-anchor="middle">offsite backup</text>
         </g>
 
+        <g id="node-whisper" data-node-id="whisper" data-node-label="Whisper" tabindex="0" role="button" aria-label="Focus Whisper, speech→text :13:5000, Architecture component" aria-pressed="false" data-node-kind="backend" data-node-sublabel="speech→text :13:5000" data-node-context="Architecture component">
+          <title>Whisper · speech→text :13:5000 · Architecture component</title>
+          <rect x="900" y="150" width="120" height="60" rx="6" class="c-mask"/>
+          <rect x="900" y="150" width="120" height="60" rx="6" class="c-backend" stroke-width="1.5"/>
+          <g aria-hidden="true" data-semantic-sigil="backend" class="semantic-sigil s-backend" transform="translate(906 156) scale(0.6875)">
+            <path d="M6 3 3 8l3 5M10 3l3 5-3 5"/>
+          </g>
+          <text data-detail-anchor x="960" y="178" class="t-primary" font-size="11" font-weight="600" text-anchor="middle">Whisper</text>
+        <text data-detail="context" x="960" y="194" class="t-muted" font-size="9" text-anchor="middle">speech→text :13:5000</text>
+        </g>
+
         <!-- Connection labels -->
         <g data-detail="context" data-edge-from="users" data-edge-to="caddy" data-edge-label="HTTPS *.lab" data-edge-key="0" data-edge-id="u-c">
           <rect x="173.6" y="290" width="62.8" height="14" rx="3" class="c-mask"/>
@@ -5075,6 +5087,10 @@
           <rect x="513.4" y="450" width="53.199999999999996" height="14" rx="3" class="c-mask"/>
           <text x="540" y="460" class="t-messagebus" font-size="8" text-anchor="middle">Borg sync</text>
         </g>
+        <g data-detail="context" data-edge-from="dsh" data-edge-to="whisper" data-edge-label="audio → text" data-edge-key="7" data-edge-id="d-w">
+          <rect x="726.2" y="120" width="67.6" height="14" rx="3" class="c-mask"/>
+          <text x="760" y="130" class="t-muted" font-size="8" text-anchor="middle">audio → text</text>
+        </g>
 
         <!-- Legend -->
         <g data-legend data-legend-bridge>