Sync Boatstack from Intelligence Flow Labs @ a063adb7e10c

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/c457045039b798a9db660b0f102753fc6bb0a975/labs/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/a063adb7e10c577e95906f6cc1bb2dd7d3b99ed9/labs/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.
 

UPSTREAM.json

@@ -1,7 +1,7 @@
 {
   "canonical_context": {
-    "characters": 51814,
-    "estimated_tokens": 12954,
+    "characters": 53187,
+    "estimated_tokens": 13297,
     "estimator": "ceil(total characters / 4); compactness signal, not provider billing",
     "files": [
       "product-engineering-loop/references/workflow.md",
@@ -12,7 +12,7 @@
   },
   "files": {
     ".gitignore": "a7079e923a776f14f1bb3a6aa0a11a133a8e1dfb35af020f327623357b7e3957",
-    "CONTRIBUTING.md": "bf4632277b4acced8795c57427be006a3d998b9a536fff24c143480f5152ecf4",
+    "CONTRIBUTING.md": "224a7dc56b254511c0f149effcce668590f3df06c8eedfdc88798c17e75ffe0d",
     "README.md": "125b47671a68556df382f19756fb61fa18925606cbbaf54d6bc9df8872b36870",
     "assets/boatstack-journey.svg": "e465befc50c8ce30f3e07e8fd97012931beeb053392c8fbf38ad645023b3cc63",
     "assets/boatstack-mark.svg": "be1f984da1bfa69fa5d1f986d8343d21f7e20921b71db888c928b4d2e54b09b5",
@@ -21,67 +21,67 @@
     "boatstack/agents/gemini.yaml": "cbf43b387399e456fa6178f86d83e6e35567e6142ff800f8de6ffca306fa963e",
     "boatstack/agents/openai.yaml": "68a30a60859556c5a26e16d184594ca243a6043d99c8cf7d66b5dd6d50a93cd1",
     "boatstack/assets/templates/adr.md": "c577a3c1c1319061f61deb053597e6e853657022185fe28b8f733327e2a78565",
-    "boatstack/assets/templates/approval.md": "74b0b816703a6dce3c96c8f95f981af910b020b6908e7f76cf5630778637e9f5",
+    "boatstack/assets/templates/approval.md": "b4a400b14c0a42338ae985475078eb8c4d14d87dca6d1d6d3e80646f3d0b1b82",
     "boatstack/assets/templates/evidence.md": "12dac552bc5373ab443367d5797f41988f14284bcf46d16dfd72015cfddf9ad1",
     "boatstack/assets/templates/feature-spec.md": "c7e007cc4295ed4c599642c0587021ef978e729cf0946f6bf3a6c4f01d366ad4",
     "boatstack/assets/templates/gaps.md": "911cc2f086104d35071b952950c2ec44258641419f10b2355c594f33eb492cbe",
     "boatstack/assets/templates/move.md": "91bfd9a9b9426ac023eb88fd19f4f638190481c1855f1239acc73830528e50f0",
-    "boatstack/assets/templates/plan-lock.json": "fe5507bfdb99ff892e56be0f3015056a72171183a06930b4555d6075b3ee04d9",
+    "boatstack/assets/templates/plan-lock.json": "526ba903c42eed3a1dee4c46c47ca90837db35ff79631a737984bf9f5988bb9b",
     "boatstack/assets/templates/plan.md": "46b3f9017fe72d97efc429191aafa1711515101b7372cc5488813abc29a64547",
     "boatstack/assets/templates/questions.md": "1133b557a832d4988545f3694b365ebffa808640ed696b6c04b5a390266eed80",
     "boatstack/assets/templates/test-plan.md": "6db8a9f27dd171fb80222a501cae50eb051e7278c04703fa43b5ff86dd4d2df4",
     "boatstack/atomic_unix.go": "89f2723361591de2bb8bd22ce7e34ec529d3278509f0df78fd5c4a7d4140fbe9",
     "boatstack/atomic_windows.go": "cefd775cbe7e7c3bd8a3f5673b11cdd784c6d3ebd6de7dcb8f39406b0bee511f",
     "boatstack/changelog.go": "c5e1f31440b44d61e6037ad27af0333540af3545d655e35819a0241cbbebd8ec",
     "boatstack/changelog_test.go": "ce792f23a7fe1e09fb3096cd1314130a6ab69321d4877b12a8e994027541baf7",
-    "boatstack/cmd/boatstack-helper/main.go": "dada2c26e5947cd4cf7c47b3c853781b4834a721eb833fc290c393f585367597",
+    "boatstack/cmd/boatstack-helper/main.go": "e769b9aa4894260a53352865741bc52ad1e257213e270fa3a1d13cf68d07d5d3",
     "boatstack/cmd/boatstack-helper/main_test.go": "ff73003b6a5157202fa09ddf1129fb13c3d79702b2e05a8721ce5a11bf5ab779",
     "boatstack/config_documentation_test.go": "bd34ac570d08c8d1d1e4f5e86c327c02a55dd5e96bd785b895a05f28fcd3f7a2",
     "boatstack/decision.go": "257ca328da6ae19ab252f10ee5d06bd7daf49dd8141d083ab1b32f106ea7a94c",
     "boatstack/decision_test.go": "1a92ff832610f9559bd47ccac7fc1755a8b4f8261c35bc72a092830dff05f7c0",
     "boatstack/delivery.go": "f203cbfa78a79609fb4f9e66dd013c0c9d8ff8da478cc1ab7e75b425c66b3920",
     "boatstack/delivery_test.go": "e669e24bb5bb3cc5d48c6dcfb1e20ad83ddaa26161785254a7aab9d3b1219e11",
     "boatstack/evidence.go": "497a31e6ff632cb1d7c3adfc9f269af3f6aa84e948dd5d417c162767542a27df",
-    "boatstack/export.go": "0f12f06796d0748a14d99118f1b20bcc75631b8c557915af94a854b6c4e8d850",
+    "boatstack/export.go": "71a3e1493947537cdf271c7a2445ecd7157dee89af84ea548a06f3165cb69780",
     "boatstack/export_test.go": "51b0340bec3decdb3e13b2a6cd73dd15e16e906031acb0c98cc553da54622162",
     "boatstack/go.mod": "6086ef1b2a83f5696190dca692c653925f27b61f652f659fd3fca43ed54a1641",
     "boatstack/go.sum": "26c315c867b11b886f3c9402fce7f341f6a9115a5d61f54afbb5e1b1fb5f6017",
-    "boatstack/hooks.go": "2b7d899f92efef8a68a160c423a46bcd6fd37daa0eba2ac8ad44ffa3dc5f88c9",
-    "boatstack/hooks_test.go": "d71271c0b9ea59b907cc0407a7173d3542281fb2984e6e3c3062ac39b131ec59",
-    "boatstack/init.go": "bc484058959202a832c9b6a76c121fcc5a666b5bcfc52ab7a7e9e3f9b37c0887",
+    "boatstack/hooks.go": "2895ecb6f20397f2c39b3af8fe37c704a6048cc05d742efce6aae554ce659cfe",
+    "boatstack/hooks_test.go": "eedef3fe5d0f5b6d27c3290965cadc10f76f6b4fef5860c690d62672850caf3f",
+    "boatstack/init.go": "013e1fe1f4d058442558e8057e261178af53b0dfd7ea4d72517d0ad8d9d8ca23",
     "boatstack/init_test.go": "fa48be69d07691fa7842224ec831e5f290504d8b6565263c9735d2dabd9b43b8",
     "boatstack/init_transaction.go": "112456c4e1c4db54c4137bcf4f7a9a9e63399a6f5971e9b3dc952d0c4b2aa4b6",
     "boatstack/integrations.go": "75b39ce2e662fccd66bf4b9bff0e097a4db558f23b3aa1d9bc83a5fc6373444c",
     "boatstack/migrate.go": "eaf589e2b266238068e42c6d78e01dc040266d28e342cb24f09e33e8541749b3",
     "boatstack/migrate_test.go": "9f4bda2fb158c5e54bcc0242dace1da3c1965f9846a213c573956a35b7d1724e",
     "boatstack/next.go": "6bf119965704e8979921aaf514b205f85082716f34a5d1901ed63c175103227b",
     "boatstack/next_test.go": "641bf32cf160c426531134a4756b0c41c6a6d876d515bb151cd01fd9c1ae5056",
-    "boatstack/plan.go": "dc34c2b37767574b6bd1327688f002e09b7ed39465a2851712434f151a169825",
+    "boatstack/plan.go": "8189ee42902bce62dcd39ce7a2e423cecb4c9e0d1dd34a5497e5a732a45c851f",
     "boatstack/plan_test.go": "ea96bf0047a43e8224f02e0b8761978ce48636a83a63b6296c9bd3336f51250c",
     "boatstack/plan_validation.go": "412f06750832fe46f01190ea5e475fc6f6ea59c8ba78131f94ec031053a405d2",
     "boatstack/plan_validation_test.go": "6cbde4ac719baef6b73aa569515d6a9daadcbf14b33f76fa78159826954e20fa",
-    "boatstack/planning.go": "4b86ae9dc16393f099ca26812bf3e62909fee42a541b33c33275cc16a80262aa",
-    "boatstack/planning_test.go": "6b156a64182ed76d4c3d392b4c5a26abe5d8b81cea27ee12ac7c4627c827e186",
+    "boatstack/planning.go": "ef4507a9fecc900f0691372c50883f328c9232c3dfd6986fbde26fb7ef436ae3",
+    "boatstack/planning_test.go": "c105a9c78c342be06614bf54d0bc1b661b0f7af64d63b79e43bd1fcc2769edd5",
     "boatstack/pr.go": "173392fd40ff1c111ec89b1f3dabaf666347be299ac7653bfe5ea2de407fc26f",
     "boatstack/pr_test.go": "838e6c244aed84317d00e6f49de6b65bb08f6fe1e1a11fb37aad8428ae2f6ea1",
     "boatstack/recovery.go": "dd816b18b54a0085b8d8276a93ee98d2b1e90099059a0d85cf6e24edf6f37d5b",
     "boatstack/recovery_test.go": "29490e7477ba602491330036a491289dd9117b99ff862f66dae421ba17e04c9f",
-    "boatstack/references/artifacts.md": "20bc466f7eac1c834a5d4d0b4cd102e6898e1af908e1905ff9ebf9b1c347baf6",
+    "boatstack/references/artifacts.md": "d49b3c207546ba788a833078c422c3d04390a4997a3322451dcb8fddd4ccff08",
     "boatstack/references/config-schema.md": "c07c2d532ef95ea6ae538a1fffefb92ded1f8dc6a06eb3b8d463e371d1ed8416",
     "boatstack/references/failure-moves.md": "3c3f654fd3a2319ca21218e921d37b31b4d926c2df5febd9c92402bffae40cd4",
-    "boatstack/references/host-hook-contracts.md": "8e97bc3591367afd82c6822c8e45283b97fdd84faaa9cc8a21862df8f61e403b",
+    "boatstack/references/host-hook-contracts.md": "36b125ac121b9ace5de30f0783e2068a47e8cb6d20a75852e5aff52f25334622",
     "boatstack/references/irreversible-operation-boundary.md": "631743991ace65977586e4537f8dd50f8ae88f8e16f27cf7baad93b2791a73df",
     "boatstack/references/portability.md": "fb683095991bb0cb06ec56fb8884c49038b283172a7d2f8b203483b7cacb4bae",
-    "boatstack/references/workflow.md": "5a6d3ae0c7f267b4a9a773f0cd8a2d4f6bcf58cfc1c7e48f8a47ca432aeffebc",
+    "boatstack/references/workflow.md": "a9e5a6330e1ce850b8a2a3e5af3ed9d9ea4c62d56a16638a7c9cd8ef015a5fbd",
     "boatstack/release.go": "fa2ac926df89c90c5844e938a2e02d4b8dbbaefbf85bb7a1a89fc51690bea520",
     "boatstack/release_test.go": "5cf2d76fe9b836a91ca68eba53d5585e2c4be5b9421aaf939ea0723063a24690",
     "boatstack/run.go": "fbdbf583c862c41f23d1a200f53d042842db72f19c29fe94e4288a69b0ac4a6b",
     "boatstack/run_test.go": "34484285fd2457b84faf6d5353117b74af73d4601cd60a96e270b7fd0a7a6a8e",
     "boatstack/runtime.go": "687b3543c22acbbed91c94e798c2a813bd828e087ac180ab29a21e3a429f9971",
     "boatstack/runtime_cache.go": "60c4eb0c7dde91d40d6ef3f05adc1a1282d17ff1ca12470d0a008454f7ca7489",
     "boatstack/runtime_cache_test.go": "b981467ddc9f0f562da6bff5de7a80a9fe5a433a0317541d1e48df268546ac85",
-    "boatstack/safety.go": "546a2c9c6d164185990ce7f515f95bb962f8b2e7d82947895fb651400b20e11b",
-    "boatstack/safety_test.go": "efe5990631134cf469d09e8ff1138007132006b50b8e757ff55749f0d968dec7",
+    "boatstack/safety.go": "6e213386fcaa6471f178cceb4154baca2d07254a2eb0274b40b6bfebe4f3b8c0",
+    "boatstack/safety_test.go": "c889117eee9d288da67781747886ddde01c4552abd6a6c389a9361ee4fa2c177",
     "boatstack/skill_frontmatter.go": "73364df463ce828c2d005aab55f72bb92f7a34d99cf3f53d4e0cd5a4da9dbd0e",
     "boatstack/skill_frontmatter_test.go": "a3ec52e7df357a72265c95dd66db15d9c0effc7e5f90f14ce69c27792ce394eb",
     "boatstack/testdata/reviewer-pr-body.md": "4c64e3788e5d61a377aeb0f797f7fc8d2316ab6e49572d15636eea7ba9e34ac4",
@@ -97,14 +97,14 @@
     "docs/benchmark-corpus-audit.md": "f2d206fe8579a514f9da82b2c96c19b343ac004be67617e1bd34f0f8e0e5e6c6",
     "docs/benchmark-submission-audit.md": "9518abdd17690729c6423f87cab20418ed47b0915b5faa44b9ef975e9e9c3b79",
     "docs/configuration.md": "f530c5dcbacf32dcb6fdab590901d8f658a4f29bd93f6264cec5d4f449c2cbd1",
-    "docs/evidence-engineered-coding.md": "315080bb71a2fccb673db2bcbd2792ce7662bfbcd3172bb32aa802a6912072c0",
+    "docs/evidence-engineered-coding.md": "9dcbd6ba9ba02aa263de2cb15fa8ed7722e07358e04913fd4b63aa9aeb00295e",
     "docs/generated-files.md": "bb8cd6e4b7d0042c899685a916ea0170ece363388328786cb0ba8fad6df3b780",
     "docs/getting-started.md": "eacc814fdffdfa3c7d8052b7cd99a79c04da5c75d88d8b44f3fb68d9afec0316",
-    "docs/public-claims.json": "e639e90ecd2905089e54864c77da36ede26768120524ded054eb5e3fb2673ab3",
+    "docs/public-claims.json": "e00c0b7cf4a5bc4d3cc672ccf7162c650aa315a5e0ed8a6bd3bf8ce8e6ad0f98",
     "docs/public-surface.md": "713f7a050b5f339cf948299103ef3800417dccfecf2cc1a4166397ea6f978907",
     "docs/research-and-design.md": "d65c66e323037bda5d45aacef5d48afa6bf93da55901378891d235aca3a5684f",
     "docs/safety.md": "7b9b5c515d36e683767ec8d3d9d6d119ac93650b2f629d351deadd4c600ed6a6",
-    "docs/troubleshooting.md": "648a189f260834a1923ef1f27b4b2cc6f7314dd6153b8bf5699369fc2f29945b",
+    "docs/troubleshooting.md": "b975f818360440d992d19f601040c7248c9fc23edc0c4f902e09daf056df926d",
     "docs/validation-and-evidence.md": "e7d91ad49c6adb44784ebe7d94feceb6abd445857f9a0716f0758bf6b55296c5",
     "docs/why-these-steps.md": "80957af13979070e8b2f2a8db78ce06d20d152bbc8ec41c3a8003f28393f6369",
     "install.ps1": "960b2b20b406bb2878a560e9ace53fe7226bc510be6ee8466ce4e608beb5625a",
@@ -114,7 +114,7 @@
     "labs/diagram-json/compiled/evidence.md": "1ba1c989ade070a8ef9a508fbd788d100d7292f2dbacbb2bce895468019f619d",
     "labs/diagram-json/compiled/tasks.json": "88f60851abf79d851e9fccc754ff3040034ae595306bc87d64784c19eb403e71",
     "labs/diagram-json/compiled/test-matrix.json": "424657ff505768e50fa113801fd8363364a18269d5297480907a993d44063a39",
-    "labs/diagram-json/plan.lock.json": "4810b9344d3944a692b0f68408ac583fb1d70fd39986bebf53cb953d817cab32",
+    "labs/diagram-json/plan.lock.json": "e112e544a997e89821b3a49ada2d789cd47c2bbcd974f6cf5a08b1b2ed687218",
     "labs/diagram-json/plan.md": "3cc4f533b8d69386deff16b3a594a3ba09d4c0c3db636cccd8c4380084ce6a51",
     "labs/diagram-json/questions.md": "74733b015002c8a6777c558e7e997fa48c94850b9bd39054fe9366c97ecf728d",
     "labs/diagram-json/request.md": "0808fc41c36779c404f4a3a121167da6e76cac56df526e70f9ed6d3e0d4c02ed",
@@ -167,14 +167,15 @@
     "release-notes/2026-07-22-boundary-oracle-loop.md": "698c2ed7dd0a000e6e210f521989992b8fa476376987819ba92c12feb3528f7c",
     "release-notes/2026-07-22-enforce-public-configuration-controls.md": "3c0904e206c483fa1c148c20125dd0f63e4fdac165775fbde984f168e62f4a96",
     "release-notes/2026-07-22-pr-visual-evidence.md": "097e66a778a1d3197796c44c374b346a0cf29f24baa895080863372816696921",
+    "release-notes/2026-07-22-pre-activation-mutation-interlock.md": "bebc6104159acc7c91e45c3d80d6e714b79486ab204c619fc715971303adedd1",
     "release-notes/2026-07-22-product-configuration-guide.md": "45e96862336bd53a2628ce3fe718c829ea20315555f53187eb7f04ba749f3a97",
     "release-notes/2026-07-22-projection-layout-validation.md": "fd0d2935f3f0c4caa41bda678e3bd9a9b496eb2652ab38d80c1c1434cbba3159",
     "release-notes/2026-07-22-value-translation-boundary.md": "9cf168ff7caaf3906b78533935bdfb2c86e753984ed1e5ec8204cb373d083390"
   },
   "generator": "operatorstack/intelligence-flow:boatstack-distribution",
   "schema_version": 1,
   "source": {
-    "commit": "c457045039b798a9db660b0f102753fc6bb0a975",
+    "commit": "a063adb7e10c577e95906f6cc1bb2dd7d3b99ed9",
     "path": "labs/12-product-engineering-loop",
     "repository": "operatorstack/intelligence-flow"
   }

boatstack/assets/templates/approval.md

@@ -5,11 +5,13 @@ This receipt may be created only after the named human explicitly approves the e
 <!-- boatstack-approval:v1 -->
 ```json
 {
-  "schema_version": 1,
+  "schema_version": 2,
   "status": "APPROVED",
   "approved_by": "<human identity>",
   "approved_at": "<ISO-8601 timestamp>",
-  "approval_fingerprint": "<PLAN_FINGERPRINT>"
+  "approval_fingerprint": "<PLAN_FINGERPRINT>",
+  "baseline_diff_sha256": "<empty only when the product baseline is clean>",
+  "baseline_changed_paths": []
 }
 ```
 <!-- /boatstack-approval -->

boatstack/assets/templates/plan-lock.json

@@ -14,6 +14,8 @@
   "plan_sha256": "<sha256>",
   "task_graph_path": "compiled/tasks.json",
   "task_graph_sha256": "<sha256>",
+  "baseline_diff_sha256": "<empty only when the product baseline was clean>",
+  "baseline_changed_paths": [],
   "invalidated_at": null,
   "invalidation_reason": null
 }

boatstack/cmd/boatstack-helper/main.go

@@ -197,7 +197,12 @@ func checkPlanCommand(arguments []string) int {
 	if err != nil {
 		return fail(fmt.Errorf("invalid Markdown plan: %w", err))
 	}
-	fmt.Printf("PASS: Markdown plan is structurally valid\nPLAN_FINGERPRINT=%s\nSOURCE_PLAN=%s\nSPEC=%s\n", check.Fingerprint, check.SourcePlanPath, check.SpecPath)
+	baseline, err := boatstack.PlanningBaselineForPlan(*plan)
+	if err != nil {
+		return fail(fmt.Errorf("cannot fingerprint the pre-activation product baseline: %w", err))
+	}
+	paths, _ := json.Marshal(baseline.ChangedPaths)
+	fmt.Printf("PASS: Markdown plan is structurally valid\nPLAN_FINGERPRINT=%s\nSOURCE_PLAN=%s\nSPEC=%s\nBASELINE_DIFF_SHA256=%s\nBASELINE_CHANGED_PATHS=%s\n", check.Fingerprint, check.SourcePlanPath, check.SpecPath, baseline.DiffSHA256, paths)
 	return 0
 }
 
@@ -269,6 +274,7 @@ func recordApprovalCommand(arguments []string) int {
 	approvedBy := flags.String("approved-by", "", "named human approver")
 	approvedAt := flags.String("approved-at", "", "RFC3339 approval timestamp")
 	fingerprint := flags.String("fingerprint", "", "exact fingerprint displayed before approval")
+	baselineDiffSHA256 := flags.String("baseline-diff-sha256", "", "exact product baseline fingerprint displayed before approval; omit only when clean")
 	if err := flags.Parse(arguments); err != nil {
 		return 2
 	}
@@ -277,7 +283,7 @@ func recordApprovalCommand(arguments []string) int {
 	}
 	if err := boatstack.RecordApproval(boatstack.ApprovalRecordOptions{
 		PlanPath: *plan, OutputPath: *output, ApprovedBy: *approvedBy,
-		ApprovedAt: *approvedAt, Fingerprint: *fingerprint,
+		ApprovedAt: *approvedAt, Fingerprint: *fingerprint, BaselineDiffSHA256: *baselineDiffSHA256,
 	}); err != nil {
 		return fail(err)
 	}