Sync Boatstack from Intelligence Flow a854eed90b15 (#24)

github-actions[bot] · web-flow · commit 29184bcd0c95 · 2026-07-18T11:38:21.000+01:00
Co-authored-by: github-actions[bot] &lt;41898282+github-actions[bot]@users.noreply.github.com&gt;
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,7 +2,7 @@
 
 # Contributing
 
-Boatstack is a generated content distribution. Propose changes to workflow semantics, templates, evidence rules, or generated presentation in [Intelligence Flow](https://github.com/operatorstack/intelligence-flow/tree/c6770c227ed9c7b4e3063663c014447c3b3c081e/examples/12-product-engineering-loop).
+Boatstack is a generated content distribution. Propose changes to workflow semantics, templates, evidence rules, or generated presentation in [Intelligence Flow](https://github.com/operatorstack/intelligence-flow/tree/a854eed90b15a57e3923ffcc4365dbc4d1ab755f/examples/12-product-engineering-loop).
 
 The Boatstack repository receives product/runtime changes through a generated pull request. Review the PR's `UPSTREAM.json`, tests, adapter diff, and context-size change; do not hand-edit generated output on `main`. `.github/workflows` is the exception: it is Boatstack's executable control plane, excluded from scheduled projection and changed only through a separate manually reviewed Boatstack PR.
 
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 <!-- Generated from operatorstack/intelligence-flow. Edit the upstream public source, not this file. -->
 
 <p align="center">
-  <img src="assets/boatstack-mark.svg" width="96" height="96" alt="Boatstack stacked-node B mark">
+  <img src="assets/boatstack-mark.svg" width="96" height="96" alt="Boatstack stacked-bar mark">
 </p>
 
 <h1 align="center">Boatstack</h1>
diff --git a/UPSTREAM.json b/UPSTREAM.json
@@ -12,11 +12,11 @@
   },
   "files": {
     ".gitignore": "a7079e923a776f14f1bb3a6aa0a11a133a8e1dfb35af020f327623357b7e3957",
-    "CONTRIBUTING.md": "71bf34b51561d2e1af39cf8bbeaabb86dd9b20646b90858b68b2ef9e1a324542",
-    "README.md": "a7a74bbf280912043c93e1e59f47866c10275520a256c59747c68d678fef0af5",
+    "CONTRIBUTING.md": "05e474b0512b03545620fe479b8f40ddb48bd328d61629048361debcfbd6ec45",
+    "README.md": "83ea436685782c5c2d2d375ceae21cb95c72a5f6608eb8187a5efc817350e081",
     "assets/boatstack-journey.svg": "c1f7fe2741f5e9ca66bb3fe9b103e6364ba5acbca8b7a8054768ffd85cf325ea",
-    "assets/boatstack-mark.svg": "c46e935f06fcfde3b37abfd579c1963b765b2337a0fa993f9538c9b652297e39",
-    "assets/boatstack-portability.svg": "888b51cda1a72af0323a744dee89cc62f5d3f412f2a86f893db7c147f96b2f53",
+    "assets/boatstack-mark.svg": "ec96165583b15cfd446c27049d49217973f3e9b1defa5771cc08eec0c9542ce4",
+    "assets/boatstack-portability.svg": "ce648f5581d16586d25824d3a8132ef1b3d88b73329179173120129d4f74fd24",
     "boatstack/SKILL.md": "2c4547c504ebac01b14fe6cbed97b5ea114b685cb9b43b68ffa053ebe0aeb0c4",
     "boatstack/agents/openai.yaml": "68a30a60859556c5a26e16d184594ca243a6043d99c8cf7d66b5dd6d50a93cd1",
     "boatstack/assets/templates/adr.md": "c577a3c1c1319061f61deb053597e6e853657022185fe28b8f733327e2a78565",
@@ -66,11 +66,11 @@
     "docs/account-recovery-walkthrough.md": "acd3558a95f48004f18a0590670de496e1cc9f0cd1d187f924615497f57e1d6f",
     "docs/benchmark-corpus-audit.md": "f2d206fe8579a514f9da82b2c96c19b343ac004be67617e1bd34f0f8e0e5e6c6",
     "docs/benchmark-submission-audit.md": "9518abdd17690729c6423f87cab20418ed47b0915b5faa44b9ef975e9e9c3b79",
-    "docs/evidence-engineered-coding.md": "2dfc75cc85b5250e2810bdeeffd03404e5545ab221365115c539202dbc9e8981",
+    "docs/evidence-engineered-coding.md": "1c74d9a8d222c3260e972938d475a3878ad341c5a911124954a7868af6979f29",
     "docs/generated-files.md": "7b2e8c10a35aa351fb87753492ed3cadb05011002d2fd6ffeb1951c356f6b286",
     "docs/getting-started.md": "9ecd9e543862e4bcf139be52de113c548708a2a5707c3c09233fd1605eda86d0",
-    "docs/public-claims.json": "f51061537b76bb7f76219dd5b63b6ad88cadf84092f742ba5fec290f444f1ee9",
-    "docs/public-surface.md": "43232ab36e8d62a31b2bb37b6800df77d8b4e2e22ef4779f0c7f836fb9125f14",
+    "docs/public-claims.json": "e3d228e5d78434e10ec21788c41c9451d69f3dce1f00c5a371bb40924fb18924",
+    "docs/public-surface.md": "713f7a050b5f339cf948299103ef3800417dccfecf2cc1a4166397ea6f978907",
     "docs/research-and-design.md": "d65c66e323037bda5d45aacef5d48afa6bf93da55901378891d235aca3a5684f",
     "docs/safety.md": "7b9b5c515d36e683767ec8d3d9d6d119ac93650b2f629d351deadd4c600ed6a6",
     "docs/troubleshooting.md": "a3314d0eb97643534415f3c19f1763fd80ff6bb5e98c53b646e447e0b31c4829",
@@ -81,7 +81,7 @@
     "examples/diagram-json/compiled/evidence.md": "1ba1c989ade070a8ef9a508fbd788d100d7292f2dbacbb2bce895468019f619d",
     "examples/diagram-json/compiled/tasks.json": "f040696f1f8bcedc4a8ed9816a61a49edbda970ec0cc3b28175ba37b73bbc896",
     "examples/diagram-json/compiled/test-matrix.json": "6c6895c509271e4337f3c91d9f62ee3a2b34e768e78513784cb012506a328ecf",
-    "examples/diagram-json/plan.lock.json": "4bf3b716db39d0503fca784ea2c0eabd873d26d71e4569cf2ff5c175c88459db",
+    "examples/diagram-json/plan.lock.json": "97386aea5c532218552a6097dbc2075254bb618e5383b04c0872b38cd4d3c811",
     "examples/diagram-json/plan.md": "3ad35cc3cbe48306e7ee401bd9e9047d25e46c8a6fe9679aa1b3f5e96ceea292",
     "examples/diagram-json/questions.md": "1a0050041cac0a8d53e6ebfe04cbec4a298cdc8c50efeeb6fa15aeb663c5ec76",
     "examples/diagram-json/request.md": "0808fc41c36779c404f4a3a121167da6e76cac56df526e70f9ed6d3e0d4c02ed",
@@ -92,12 +92,13 @@
     "project.example.json": "d1f7aa3cff0b55ede79500bd2ca710bb99cb2ae579f0a058dc00934accf03d33",
     "release-notes/2026-07-17-delivery-harness-framing.md": "6fccbe7efdb288f5eca7e824ee5e44ad6b30a34f312eb997dca6aa44c55b26cb",
     "release-notes/2026-07-17-phase-scoped-delivery.md": "bfc8edd30a67daf5940ad4ceceebf81d01d62914ebeabb7073985c53f13df2ff",
-    "release-notes/2026-07-17-visible-release-messages.md": "c93e8c812528a983502263e35d66c86a265d6ccba8203f393788c069b3fa6606"
+    "release-notes/2026-07-17-visible-release-messages.md": "c93e8c812528a983502263e35d66c86a265d6ccba8203f393788c069b3fa6606",
+    "release-notes/2026-07-18-stacked-bar-mark.md": "c4d5bd5fb89c280d7fba015384fd795fcb8c31ffe501078aa55a90cbcf66ba7b"
   },
   "generator": "operatorstack/intelligence-flow:boatstack-distribution",
   "schema_version": 1,
   "source": {
-    "commit": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+    "commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
     "path": "examples/12-product-engineering-loop",
     "repository": "operatorstack/intelligence-flow"
   }
diff --git a/assets/boatstack-mark.svg b/assets/boatstack-mark.svg
@@ -1,9 +1,17 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title description">
   <title id="title">Boatstack</title>
-  <desc id="description">A geometric letter B constructed from stacked connected nodes.</desc>
-  <style>.ink{fill:#0F172A}@media(prefers-color-scheme:dark){.ink{fill:#E2E8F0}}</style>
-  <path class="ink" d="M10 8a4 4 0 0 1 4-4h6a4 4 0 0 1 4 4v48a4 4 0 0 1-4 4h-6a4 4 0 0 1-4-4z"/>
-  <path fill="#2563EB" d="M20 4h20c9.94 0 18 8.06 18 18 0 4.66-1.77 8.91-4.68 12.11A17.94 17.94 0 0 1 58 46c0 9.94-8.06 18-18 18H20V50h20a4 4 0 0 0 0-8H20V28h20a4 4 0 0 0 0-8H20z"/>
-  <circle class="ink" cx="40" cy="20" r="4"/>
-  <circle class="ink" cx="40" cy="46" r="4"/>
+  <desc id="description">A rounded ink field with three stacked bars — the repository-owned delivery stack.</desc>
+  <style>
+    .ink{fill:#0F172A}
+    .blue{fill:#2563EB}
+    .cut{fill:#FFFFFF}
+    @media(prefers-color-scheme:dark){
+      .ink{fill:#E2E8F0}
+      .cut{fill:#0F172A}
+    }
+  </style>
+  <rect class="ink" x="2" y="2" width="60" height="60" rx="16"/>
+  <rect class="blue" x="14" y="15" width="36" height="8" rx="2.5"/>
+  <rect class="cut" x="14" y="28" width="36" height="8" rx="2.5"/>
+  <rect class="blue" x="14" y="41" width="36" height="8" rx="2.5"/>
 </svg>
diff --git a/assets/boatstack-portability.svg b/assets/boatstack-portability.svg
@@ -34,9 +34,9 @@
     <path d="M360 157H405V372H360"/>
     <path d="M360 259H405"/>
   </g>
-  <path class="blue" d="M405 270H447" fill="none" stroke-width="4" marker-end="url(#arrow)"/>
+  <path class="blue" d="M405 259H447" fill="none" stroke-width="3" marker-end="url(#arrow)"/>
 
-  <g transform="translate(456 132)">
+  <g transform="translate(456 121)">
     <rect class="core" width="406" height="276" rx="24" stroke-width="3"/>
     <text class="small" x="203" y="34" text-anchor="middle" fill="#2563EB">YOUR REPOSITORY</text>
     <text class="title ink" x="203" y="75" text-anchor="middle">BOATSTACK</text>
@@ -49,8 +49,8 @@
     <text class="body muted" x="203" y="254" text-anchor="middle">The saved state stays with the project.</text>
   </g>
 
-  <path class="blue" d="M862 270H914" fill="none" stroke-width="4" marker-end="url(#arrow)"/>
-  <g transform="translate(928 166)">
+  <path class="blue" d="M862 259H914" fill="none" stroke-width="3" marker-end="url(#arrow)"/>
+  <g transform="translate(928 155)">
     <rect class="node" width="224" height="208" rx="24" stroke-width="3"/>
     <text class="small muted" x="112" y="34" text-anchor="middle">WHAT LEAVES THE FLOW</text>
     <text class="label ink" x="112" y="77" text-anchor="middle">Reviewed PR</text>
diff --git a/docs/evidence-engineered-coding.md b/docs/evidence-engineered-coding.md
@@ -146,6 +146,6 @@ Delivery and system improvement also remain separate. A failed task may suggest
 
 ## What is evidence-backed
 
-The current moves were derived from the Intelligence Flow benchmark corpus and product-repository studies. The generated source commit is [`c6770c227ed9c7b4e3063663c014447c3b3c081e`](https://github.com/operatorstack/intelligence-flow/tree/c6770c227ed9c7b4e3063663c014447c3b3c081e/examples/12-product-engineering-loop).
+The current moves were derived from the Intelligence Flow benchmark corpus and product-repository studies. The generated source commit is [`a854eed90b15a57e3923ffcc4365dbc4d1ab755f`](https://github.com/operatorstack/intelligence-flow/tree/a854eed90b15a57e3923ffcc4365dbc4d1ab755f/examples/12-product-engineering-loop).
 
 The evidence supports specific failure mechanisms and guardrails. It does not establish that Boatstack is optimal, that control-theory notation proves software quality, or that one workflow dominates every team. Those are evaluation questions, so the distribution preserves measurements, provenance, gaps, and negative results.
diff --git a/docs/public-claims.json b/docs/public-claims.json
@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "source_commit": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+  "source_commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
   "statuses": ["verified", "observed", "still_being_evaluated"],
   "claims": [
     {
@@ -12,7 +12,7 @@
       "readable_evidence": "why-these-steps.md#portable-workflow-and-state",
       "implementation": ["../boatstack/export.go", "../boatstack/references/artifacts.md", "../boatstack/references/workflow.md"],
       "verification": ["../boatstack/export_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "human-decisions",
@@ -23,7 +23,7 @@
       "readable_evidence": "why-these-steps.md#human-decisions",
       "implementation": ["../boatstack/references/workflow.md", "../boatstack/plan.go"],
       "verification": ["../boatstack/plan_test.go", "../boatstack/planning_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "validation-provenance",
@@ -34,7 +34,7 @@
       "readable_evidence": "why-these-steps.md#validation-provenance",
       "implementation": ["validation-and-evidence.md", "../boatstack/plan.go"],
       "verification": ["../boatstack/plan_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "irreversible-operations",
@@ -46,7 +46,7 @@
       "readable_evidence": "why-these-steps.md#irreversible-operations",
       "implementation": ["safety.md", "../boatstack/safety.go", "../boatstack/hooks.go"],
       "verification": ["../boatstack/safety_test.go", "../boatstack/hooks_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "reviewer-ready-pr",
@@ -57,7 +57,7 @@
       "readable_evidence": "why-these-steps.md#reviewer-ready-pr",
       "implementation": ["../boatstack/pr.go", "getting-started.md"],
       "verification": ["../boatstack/pr_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "phase-scoped-delivery",
@@ -68,7 +68,7 @@
       "readable_evidence": "why-these-steps.md#phase-scoped-delivery",
       "implementation": ["../boatstack/delivery.go", "../boatstack/safety.go", "../boatstack/hooks.go", "../boatstack/references/workflow.md"],
       "verification": ["../boatstack/delivery_test.go", "../boatstack/pr_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "model-neutral-contract",
@@ -79,7 +79,7 @@
       "readable_evidence": "why-these-steps.md#model-choice-and-budget",
       "implementation": ["research-and-design.md", "../boatstack/references/workflow.md"],
       "verification": ["../boatstack/export_test.go", "../boatstack/planning_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "cross-model-failures",
@@ -90,7 +90,7 @@
       "readable_evidence": "why-these-steps.md#model-choice-and-budget",
       "implementation": ["research-and-design.md"],
       "verification": ["benchmark-corpus-audit.md", "benchmark-submission-audit.md"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "lower-cost-outcomes",
@@ -101,7 +101,7 @@
       "readable_evidence": "why-these-steps.md#model-choice-and-budget",
       "implementation": ["research-and-design.md"],
       "verification": ["benchmark-corpus-audit.md", "benchmark-submission-audit.md"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "git-worktree-activation",
@@ -112,7 +112,7 @@
       "readable_evidence": "why-these-steps.md#git-worktree-activation",
       "implementation": ["../boatstack/runtime_cache.go", "../boatstack/hooks.go"],
       "verification": ["../boatstack/runtime_cache_test.go", "../boatstack/hooks_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     },
     {
       "id": "visible-updates",
@@ -123,7 +123,7 @@
       "readable_evidence": "why-these-steps.md#visible-updates",
       "implementation": ["../boatstack/update.go", "../boatstack/init.go"],
       "verification": ["../boatstack/update_test.go", "../boatstack/init_test.go", "../boatstack/export_test.go"],
-      "last_verified_version": "source:c6770c227ed9c7b4e3063663c014447c3b3c081e"
+      "last_verified_version": "source:a854eed90b15a57e3923ffcc4365dbc4d1ab755f"
     }
   ]
 }
diff --git a/docs/public-surface.md b/docs/public-surface.md
@@ -31,7 +31,7 @@ Do not use “proven,” “optimal,” performance uplift, cost reduction, or s
 
 When Huashu Design is installed, use it to review a public-surface change. The review must still satisfy this portable fallback:
 
-- preserve the stacked-node mark, ink `#0F172A`, and electric blue `#2563EB`;
+- preserve the stacked-bar mark (ink field with blue/cutout stack), ink `#0F172A`, and electric blue `#2563EB`;
 - name the delivery-harness category before asking readers to adopt its philosophy;
 - design from real Boatstack content rather than a generic AI landing-page pattern;
 - use one dominant product journey and progressive disclosure;
diff --git a/examples/diagram-json/plan.lock.json b/examples/diagram-json/plan.lock.json
@@ -6,7 +6,7 @@
   "plan_path": "examples/diagram-json/plan.md",
   "plan_sha256": "3ad35cc3cbe48306e7ee401bd9e9047d25e46c8a6fe9679aa1b3f5e96ceea292",
   "schema_version": 1,
-  "source_commit": "c6770c227ed9c7b4e3063663c014447c3b3c081e",
+  "source_commit": "a854eed90b15a57e3923ffcc4365dbc4d1ab755f",
   "source_plan_path": "examples/diagram-json/source-plan.md",
   "source_plan_sha256": "e10593ddaa7522ab80cc991d0a09399257139799e37f737794cd49d68a39985b",
   "spec_path": "examples/diagram-json/spec.md",
diff --git a/release-notes/2026-07-18-stacked-bar-mark.md b/release-notes/2026-07-18-stacked-bar-mark.md
@@ -0,0 +1,3 @@
+### Boatstack adopts a stacked-bar mark
+
+The homepage logo is now a negative-space stack inside an ink field — clearer at favicon size and closer to the repository-owned delivery stack metaphor. The portability diagram also aligns the flow arrows with the model connector.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+### Boatstack adopts a stacked-bar mark`
	`2`	`+`
	`3`	`+The homepage logo is now a negative-space stack inside an ink field — clearer at favicon size and closer to the repository-owned delivery stack metaphor. The portability diagram also aligns the flow arrows with the model connector.`