docs(dnn): refresh 3 #131/#132 runbooks post-execution (10.3.2+2sxc21 delivered) - #792
Conversation
… 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
left a comment
There was a problem hiding this comment.
[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.mdEXISTS 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).
…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>
…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>
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)
131-step1-sandbox-upgrade-runbook.md131-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.mdc1ed77d2(#782) as the live harness.132-deployment-runbook.mdThe one real gap fixed (132 §5.5a)
The deployment runbook predates the B1 incident and would lead a future executor to break 2sxc 21:
§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 MEMORYreference-dnn-2sxc-net48-bcl-stack+682-field-model-revision-2sxc21.md.What was deliberately NOT done
**Base:**lines — those are the hash-at-time-of-writing (historical provenance), kept intact.Verification
lsconfirmed):131-dnn-phase2-exec-rollback.md,682-field-model-revision-2sxc21.md,UPGRADE-ASSESSMENT.md,2026-07-11-regen-readiness-refresh-c1ed77d2.md.sk-).Gate
Cards/, no.cs, no DNN DB, no live mutation)docs/dnn-localization/)Relates: dispatch
2lnzsb, #131/#132 (DNN), #782 (regen-readiness live harness), #565 (8-lang shipped), #651 (Playwright fix), #569 (tscon recipe), B1-inversion (MEMORYreference-dnn-2sxc-net48-bcl-stack).Co-Authored-By: Claude-Code noreply@anthropic.com