Skip to content

docs: release to production — the whole path (content, recompile, image rollout) - #832

Merged
rbuergi merged 7 commits into
mainfrom
docs/release-pipeline
Aug 7, 2026
Merged

docs: release to production — the whole path (content, recompile, image rollout)#832
rbuergi merged 7 commits into
mainfrom
docs/release-pipeline

Conversation

@rbuergi

@rbuergi rbuergi commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

A map of everything between a green merge and a working page, written after a week in which each hop failed at least once:

  • (A) content — the two channels (catalog install, GitSync), plus the two rules that made syncs fail this week: triggers run as SYSTEM (the click authorizes, the system executes), and a shared= source query is anchored at its namespace so shared source belongs at partition level.
  • (B) recompile — the assembly is the deliverable; the affected set includes every shared= sharer, in dependency order. Same closure the CI test-selection uses, so runtime and pipeline agree by construction.
  • (C) the image — CD builds and pushes but does not roll out (deployments pin an explicit tag). Deliberate, but easy to forget: check the running image before hunting a core symptom.

Also documents the update policy (auto by default, on-demand and ignore as overrides), the three-way conflict basis for kept-local nodes, and an ordered "my change is not live" diagnosis ending at the compile activity's source-discovery trace.

🤖 Generated with Claude Code

https://claude.ai/code/session_01CsVb5f4N6KuJnvLaNrvjDB

Content arrival, the recompile that both channels must trigger, and the image
rollout nothing automates — plus the update policies, the three-way conflict
basis, and an ordered diagnosis for 'my change is not live'.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CsVb5f4N6KuJnvLaNrvjDB
Copilot AI lite review requested due to automatic review settings August 6, 2026 07:33
@rbuergi
rbuergi enabled auto-merge August 6, 2026 07:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Architecture documentation page that lays out the end-to-end “release to production” pipeline for MeshWeaver, focusing on how content reaches an instance, how/why NodeTypes must be recompiled as part of delivery, and when a platform image rollout is required.

Changes:

  • Introduces a “Release to Production — the whole path” doc page describing the three independent hops: content sync, NodeType recompilation, and platform image rollout.
  • Documents operational rules that commonly cause silent failures (SYSTEM execution for sync triggers; shared= source discovery anchored to namespace).
  • Captures update policy options and a step-by-step diagnosis checklist for “my change is not live”.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 4)

1 110 tests  ±0   1 103 ✅ ±0   5m 34s ⏱️ +8s
   11 suites ±0       7 💤 ±0 
   11 files   ±0       0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 5)

1 538 tests  ±0   1 434 ✅ ±0   5m 37s ⏱️ +49s
   11 suites ±0     104 💤 ±0 
   11 files   ±0       0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 2)

2 023 tests  ±0   2 022 ✅ ±0   5m 22s ⏱️ -10s
   11 suites ±0       1 💤 ±0 
   11 files   ±0       0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 3)

   10 files  ±0     10 suites  ±0   5m 28s ⏱️ +11s
1 486 tests +1  1 486 ✅ +1  0 💤 ±0  0 ❌ ±0 
1 572 runs  +2  1 572 ✅ +2  0 💤 ±0  0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 0)

367 tests  ±0   363 ✅ ±0   4m 52s ⏱️ -12s
 10 suites ±0     4 💤 ±0 
 10 files   ±0     0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results (shard 1)

1 529 tests  ±0   1 340 ✅ ±0   6m 42s ⏱️ +5s
   11 suites ±0     189 💤 ±0 
   11 files   ±0       0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

This pull request removes 1 and adds 1 tests. Note that renamed tests count towards both.
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .stack-horizontal, .layout-area .stac\"···, renderedTextMarker: \"Date/time picker\")
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .form-group\", renderedTextMarker: \"Full name\")
This pull request removes 1 skipped test and adds 1 skipped test. Note that renamed tests count towards both.
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .stack-horizontal, .layout-area .stac\"···, renderedTextMarker: \"Date/time picker\")
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .form-group\", renderedTextMarker: \"Full name\")

♻️ This comment has been updated with latest results.

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

Test Results

   64 files  ±0     64 suites  ±0   33m 37s ⏱️ +51s
8 053 tests +1  7 748 ✅ +1  305 💤 ±0  0 ❌ ±0 
8 139 runs  +2  7 834 ✅ +2  305 💤 ±0  0 ❌ ±0 

Results for commit b3436b2. ± Comparison against base commit 939e485.

This pull request removes 1 and adds 2 tests. Note that renamed tests count towards both.
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .stack-horizontal, .layout-area .stac\"···, renderedTextMarker: \"Date/time picker\")
MeshWeaver.Persistence.Test.DocExecutableBlocksTest ‑ RenderBlocks_EndInAnExpression_SoTheAreaReceivesAControl
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .form-group\", renderedTextMarker: \"Full name\")
This pull request removes 1 skipped test and adds 1 skipped test. Note that renamed tests count towards both.
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .stack-horizontal, .layout-area .stac\"···, renderedTextMarker: \"Date/time picker\")
MeshWeaver.Portal.E2E.DocExamplesRenderTest ‑ DocPage_InteractiveExamples_RenderRealContent(docPath: \"Doc/GUI/Editor\", exampleCount: 1, controlSelector: \".layout-area .form-group\", renderedTextMarker: \"Full name\")

♻️ This comment has been updated with latest results.

@rbuergi rbuergi closed this Aug 6, 2026
auto-merge was automatically disabled August 6, 2026 19:37

Pull request was closed

@rbuergi rbuergi reopened this Aug 6, 2026
@rbuergi
rbuergi enabled auto-merge August 6, 2026 19:39
@rbuergi
rbuergi merged commit 87f4392 into main Aug 7, 2026
16 checks passed
@rbuergi
rbuergi deleted the docs/release-pipeline branch August 7, 2026 07:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants