KB-3EE2

00 — Readme First: RP Generator Parity Fix + Contract Replace + UI Deploy Standby

3 min read Revision 1
rpgenerator-parityreadme2026-06-05

00 — Readme First

Macro: RP_GENERATOR_PARITY_FIX_CONTRACT_REPLACE_UI_DEPLOY_STANDBY_AND_AUTOSCALE_CLOSEOUT. 20 phases. Mode EXECUTION.

Outcome: Both generator parity gaps fixed; generated contract backbone now reproduces the current contract at 87/87 (membership + count, zero gap). Replacement made safe (candidate applied, production current preserved). UI on standby (git/operator only). No engineering blocker remains.

Final verdict: GENERATOR_BACKBONE_PARITY_PASS__CONTRACT_REPLACE_READY_OPERATOR_GATED__UI_DEPLOY_STANDBY_BLOCKED_BY_GIT. Status PARTIAL.

What changed (additive, birth-free, reversible)

  • Generator manifest v2 + function v2 with corrected AX-PROCESS and AX-PXT legs.
  • Generated contract backbone v2 (87 rows) + explicit replacement candidate alias.
  • Parity validation v2 (per-axis + summary), autoscale dashboard v2, regression v2 (6/6 with teeth), synthetic-axis/generator relation, crash-safe deploy readiness guard (plpgsql function).

The two fixes

  1. AX-PROCESS: the generated leg bound only the 19-row candidate source and never emitted the three verified workflow nodes (job:cut from job_queue; WF-001 and WF-002 from the workflows table). generated_v2 unions all three legs → 22 nodes, matching current.
  2. AX-PXT: the generated leg bound the OLD actionability ledger (residual_reconcile 8) instead of the corrected live_v2 ledger (residual_reconcile 2). generated_v2 binds live_v2 → count diff 0. Side-by-side proved the live_v2 ledger differs from the old one on exactly that one gap_code.

IMPORTANT — operational incident

Four OOM crashes of production Postgres occurred during deploy-guard development (all auto-recovered, no data loss). See doc 13. The deploy guard is now a crash-safe plpgsql function; the naive single-statement guard was neutralized.

Read order

01 dual-path baseline · 02-03 AX-PROCESS root-cause + patch · 04-05 AX-PXT root-cause + patch · 06 generated contract v2 · 07 parity validation v2 · 08 autoscale v2 · 09 dry-run replacement plan · 10 safe replacement decision · 11 post-replacement invariant proof · 12 UI standby refresh · 13 deploy readiness guard + crash incident · 14 synthetic-axis/generator relation · 15 regression v2 · 16 safety/no-fake audit · 17 operator runbook · 18 final summary · 19 MCP-readable checkpoint.

Artifacts

SQL: /opt/incomex/docs/mcp-writes/rp-generator-parity-fix-2026-06-05/ (01_apply, 02_verify, 04_deploy_guard_fn = canonical guard, 99_rollback). Checkpoint: knowledge/dev/reports/architecture/checkpoint-rp-generator-parity-fix-contract-replace-ui-deploy-standby-2026-06-05.md.

Back to Knowledge Hub knowledge/dev/reports/architecture/rp-generator-parity-fix-contract-replace-ui-deploy-standby-2026-06-05/00-readme-first.md