Skip to content

docs(dnn): refresh 3 #131/#132 runbooks post-execution (10.3.2+2sxc21 delivered) - #792

Merged
jsboige merged 1 commit into
masterfrom
docs/dnn-runbooks-postexec-refresh
Jul 12, 2026
Merged

docs(dnn): refresh 3 #131/#132 runbooks post-execution (10.3.2+2sxc21 delivered)#792
jsboige merged 1 commit into
masterfrom
docs/dnn-runbooks-postexec-refresh

Conversation

@jsboige

@jsboige jsboige commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Context

Dispatch 2lnzsb (ai-01 → po-2023) [secondaire]: "scope/refresh les 3 runbooks existants (131-regen-staging, 131-step1-sandbox-upgrade, 132-deployment)." The runbooks were written Jun 15-25 as PRE-execution prep — before the migration was delivered. They now describe steps that have already happened, or (in one case) carry an undocumented lesson that would bite a future executor.

What landed (docs-only, 3 files, +85/-1)

Runbook Refresh
131-step1-sandbox-upgrade-runbook.md POST-EXEC banner: sandbox upgrade DELIVERED (10.3.2+2sxc21 live full-IIS, ACME bypass active). Points to 131-dnn-phase2-exec-rollback + MEMORY + UPGRADE-ASSESSMENT as current truth. Flags 2 staleness items resolved (§2 "2sxc 15.02" was stale — already 21.07; §5 "templates untouched" moot — cliff crossed).
131-regen-staging-runbook.md REFRESH banner: scope DEFERRED 4-vs-8 lang → RESOLVED (8-lang shipped #565, 41 SVGs). Foreground-lock mitigated (#569 tscon recipe), Playwright deadlock resolved (#651), build-server deadlock lesson. Points to regen-readiness-refresh-c1ed77d2 (#782) as the live harness.
132-deployment-runbook.md POST-EXEC banner (sandbox+full-IIS delivered, prod VPS go-live remains gated) + the critical B1-inversion lesson added to §5.5(a).

The one real gap fixed (132 §5.5a)

The deployment runbook predates the B1 incident and would lead a future executor to break 2sxc 21:

The earlier repair-bin-net48.ps1 reverted BCL/SDK DLLs to 6.0.0.0, treating .NET 8/9 versions as "contamination." That thesis was INVERTED for 2sxc 21: 2sxc 21.07 is compiled against System.Text.Json 9.0.0.0 / SCI 9.0.0.0 / Bcl 8.0.0.0. Reverting → JsonOptions type-init MissingMethodException → every 2sxc module "Something went really wrong in view.ascx".

§5.5(a) now carries this as a MANDATORY sub-step (align BCL stack from the 2sxc 21.07 Install package + align <assemblyBinding> redirects), with pointer to MEMORY reference-dnn-2sxc-net48-bcl-stack + 682-field-model-revision-2sxc21.md.

What was deliberately NOT done

  • No full rewrite of the historical procedures — they are a valid record of the prep/reasoning. Banners + the one targeted correctness fix only.
  • No master-hash bump of the **Base:** lines — those are the hash-at-time-of-writing (historical provenance), kept intact.

Verification

  • All 4 linked target docs exist (ls confirmed): 131-dnn-phase2-exec-rollback.md, 682-field-model-revision-2sxc21.md, UPGRADE-ASSESSMENT.md, 2026-07-11-regen-readiness-refresh-c1ed77d2.md.
  • Secret-scan: clean (hits are descriptive words "source of truth is", "conn-string errors" — no secrets, no sk-).
  • Banners cross-reference the live state from MEMORY §DNN (verified 2026-07-12).

Gate

  • ✅ Docs-only (no Cards/, no .cs, no DNN DB, no live mutation)
  • ✅ po-2023 lane (docs/dnn-localization/)
  • ✅ No secret in diff
  • ⏸ Gated ai-01 review before merge (worker never self-merges)

Relates: dispatch 2lnzsb, #131/#132 (DNN), #782 (regen-readiness live harness), #565 (8-lang shipped), #651 (Playwright fix), #569 (tscon recipe), B1-inversion (MEMORY reference-dnn-2sxc-net48-bcl-stack).

Co-Authored-By: Claude-Code noreply@anthropic.com

… full-IIS)

The 3 #131/#132 runbooks were written Jun 15-25 as PRE-execution prep,
before the migration was delivered. They now describe steps that have
already happened (or carry an undocumented lesson that would bite a
future executor). This refresh adds POST-EXECUTION REALITY banners +
one targeted correctness addition — without rewriting the historical
procedure (a valid record of the prep/reasoning).

Changes (docs-only, 3 files, +85/-1):
- 131-step1-sandbox-upgrade-runbook.md: POST-EXEC banner — marks the
  sandbox upgrade DELIVERED (10.3.2+2sxc21 live full-IIS, ACME bypass
  active), points to phase2-exec-rollback + MEMORY + UPGRADE-ASSESSMENT
  as current truth, flags 2 staleness items resolved (§2 "2sxc 15.02"
  was stale — already 21.07; §5 "templates untouched" moot — cliff crossed).
- 131-regen-staging-runbook.md: REFRESH banner — scope DEFERRED 4-vs-8
  lang RESOLVED (8-lang shipped #565, 41 SVGs), foreground-lock mitigated
  (#569 tscon recipe), Playwright deadlock resolved (#651), build-server
  deadlock lesson; points to regen-readiness-refresh-c1ed77d2 (#782) as
  the live harness.
- 132-deployment-runbook.md: POST-EXEC banner (sandbox+full-IIS delivered,
  prod VPS go-live remains the gated frontier) + the critical B1-inversion
  lesson added to §5.5(a): 2sxc-21 REQUIRES .NET 8/9 BCL stack
  (Json 9.0.0.0/SCI 9.0.0.0/Bcl 8.0.0.0), NOT the 6.0.0.0 reversion the
  early repair-bin-net48.ps1 encoded. This was a real gap — the runbook
  predates the B1 incident and would have led a future executor to break
  2sxc 21 with JsonOptions MissingMethodException.

po-2023 lane (docs/dnn-localization/). Non-gated. No Cards/, no .cs, no DB.
Gated ai-01 review before merge.

Co-Authored-By: Claude-Code <noreply@anthropic.com>

@clusterManager-Myia clusterManager-Myia left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

[NanoClaw] — ✅ LGTM docs-only (+85/-1, 3 DNN runbooks refreshed "POST-EXECUTION REALITY 2026-07-12").

Byte-verified firsthand (head 9f94c3ffbe043e678fb37282e3b5778e6d9e17c5, base 5c6b3bce). Each of the 3 runbooks gains a top blockquote annotating the prep doc with what was delivered, + one genuine casing fix in the 132 body.

Anchors verified (all referenced PRs merged firsthand):

  • #565 merged ✓ — feat(assets): add 8-language FreeMind SVG mind maps (es/ar/fa/zh + refresh fr/pt) → matches "8 languages shipped, 41 SVGs across 8/8 langs via git ls-tree"
  • #569 merged ✓ — docs(mindmap): #568 fiabiliser la generation SVG sans RDP actif + helper script → matches "foreground-lock mitigated, tscon /dest:console recipe"
  • #651 merged ✓ — fix(harvest): resolve reproducible Playwright deadlock (console-flood on event thread) → matches "console-flood sync I/O moved to transport queue" (I reviewed this root-cause firsthand 04/07)
  • #782 merged ✓ — docs(release): regen-readiness refresh vs c1ed77d2 → matches "live, refreshed fire-time harness ... PR #782 merged"
  • #593 merged ✓ — docs(dnn): #131 refresh UPGRADE-ASSESSMENT — fix CVE patch level + .NET 4.8 runtime → matches UPGRADE-ASSESSMENT reference
  • Referenced doc 682-field-model-revision-2sxc21.md EXISTS on master (9313 B) ✓

Casing fix is genuine: the single -1/+1 in the 132 body is ToSic_EAV_*ToSIC_EAV_*. Verified base has the lowercase-c form (1 hit), head has the canonical uppercase-C 2sxc EAV table-prefix form (1 hit). Real correction, not cosmetic.

Substantive technical content: the "B1-inversion" lesson in the 132 §5.5(a) sub-step (2sxc 21.07 REQUIRES System.Text.Json 9.0.0.0 / SCI 9.0.0.0 / Bcl 8.0.0.0 from the 2sxc 21.07 Install package — NOT the 6.0.0.0 reversion repair-bin-net48.ps1 encoded; reverting → JsonOptions type-init MissingMethodException → every module "Something went really wrong") is a load-bearing operational lesson, well cross-referenced (MEMORY reference-dnn-2sxc-net48-bcl-stack + doc 682). Correct that the earlier "decontamination" thesis was inverted for 2sxc 21.

△ Caveat (non-blocking): the live-site operational claims (HTTP 200/~85 KB at dnn.argumentum.myia.io, HTTPS SAN 9D80D4CC exp 2026-09-27, dbo.[Version] top row = 10.3.2) are worker state-reporting I can't re-verify without a live site probe / DB read — but they are consistent with the established DNN-migration narrative across #693/#671/#670/#669 and the B2.5 smoke GREEN claim. Framing is honest (gated prod VPS go-live clearly marked as remaining jsboige ops task, de-coupled from v0.9.0 print release).

Recommendation: merge. The blocks are additive, anchored, and turn stale prep docs into accurate historical records pointing at the live harness (#782).

@jsboige
jsboige merged commit 5910421 into master Jul 12, 2026
3 checks passed
@jsboige
jsboige deleted the docs/dnn-runbooks-postexec-refresh branch July 12, 2026 15:00
jsboige added a commit that referenced this pull request Jul 12, 2026
…n turnkey (#794)

The 2 operational go-live docs (go-live-turnkey-checklist.md, go-live-smoke-
test.md) were written 2026-06-26 as PRE-execution navigators. Since then the
sandbox + full-IIS migration was delivered (10.3.2 + 2sxc 21.07 live at
dnn.argumentum.myia.io). One carries a dangerous error that would bite a
future executor.

Changes (docs-only, 2 files, +45/-2):
- go-live-turnkey-checklist.md: POST-EXEC banner (B1-B3 DELIVERED, only prod
  VPS go-live B4 remains) + CRITICAL CORRECTION to B1: the step-2/3
  instruction "fetch .NET-9 contaminants at 6.0.x + align binding redirects
  -> 6.0.0.0" is the INVERTED thesis, proven WRONG during execution.
  Reverting BCL to 6.0.0.0 breaks 2sxc 21 (JsonOptions type-init
  MissingMethodException -> "Something went really wrong"). Correct action =
  deploy matched BCL stack from 2sxc 21.07 Install pkg (Json 9.0.0.0 /
  SCI 9.0.0.0 / Bcl 8.0.0.0) + align redirects. Cross-ref to 132 §5.5a +
  MEMORY reference-dnn-2sxc-net48-bcl-stack. Release de-coupling noted
  (B4 = jsboige ops VPS task, not blocking v0.9.0 print tag).
- go-live-smoke-test.md: POST-EXEC context banner (sandbox smoke already
  green, checklist now prod-replay; A2/A3/A5 red-flags resolved as
  regression-watch not open blockers; release de-coupled).

Same B1-inversion lesson already corrected in 132-deployment §5.5a (companion
PR #792). This PR closes the second doc that encoded the error.

po-2023 lane (docs/dnn/, operational go-live docs). Non-gated. No Cards/,
no .cs, no DB. Gated ai-01 review before merge.

Co-authored-by: Claude-Code <noreply@anthropic.com>
jsboige added a commit that referenced this pull request Jul 13, 2026
…backlog (#798)

The navigation index (entry point of the #131/#132/#457 arc) was last
refreshed 2026-07-10 (#765). Since then 3 merges changed what it should
report, leaving it stale:

1. B1-inversion correction swept to a 3rd doc — #792 added the lesson to
   132-deployment-runbook.md §5.5(a) as a MANDATORY sub-step (the 07-10
   refresh only named sandbox-bootstrap + go-live-turnkey). #794 extended
   the turnkey fix. §0.5 "stale-doc flags" now lists all 3 docs with PR refs.

2. #682 Path A provisioning manifest (49 fields) merged in #777 — the 3
   #682 docs (decision-input, revision-2sxc21, path-a-provisioning-manifest)
   were missing from §2 supporting-docs table. Added.

3. §4 "jsboige gates pending" listed only #445/#525/visual-verdict — the
   entire i18n portage chain (#682 provisioning → #683 enablement → #684
   re-import) was absent from the backlog. Added as gates 3/4/5, with #684
   prep marked DONE (PR #767) and re-import marked GATED.

Navigation index only — no runbook content rewritten. MD032 on the new
blockquote list resolved with blank > lines (my addition, not surrounding
style). Lane: docs/dnn-localization (po-2023). 0 prod write, 0 CSV.

Co-authored-by: Claude-Code <noreply@anthropic.com>
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