← Back to Articles & Artefacts
artefactsnorth

Veritas live-MMOT design β€” the verdict, condensed

IAIP Research2026-08-01
ep304-living-review-design-260802-2ce1aed8-ba7c-4f93-af63-b90a630004ae

Veritas live-MMOT design β€” the verdict, condensed

Provenance: design-research agent + E1–E10 re-ranking addendum, 2026-08-01, dispatched by 🌿 Mino-Bimaadizi-Daa (day 09) at William's direction. Companion to 260801-stateloom-live-canvas-imitation-blueprint.md. First slice shipped same evening: jgwill/veritas branch feat/stc-live-mmot-view-260801 @ c550ca4.

Truth-store ranking (the binding decision)

  1. coaia-narrative JSONL (the seat's configured MCP store) β€” TRUTH. perform_mmot_evaluation (graph-manager.ts:975-1118) writes durable graph data: appends [MMOT <phase>] to <chartId>_current_reality, pushes {phase, assessment, direction, timestamp} into chartEntity.metadata.mmotEvaluations[], creates action_steps for correctiveActions, emits a narrative_beat with an evaluates relation to the chart. The only store where the binding is a relation, not a dangling string. Chart and review live in one graph, git-tracked.
  2. medicine-wheel StoredMmot β€” downstream mirror, later. Clean shape (4 steps first-class), but creator_moment_of_truth 404s on charts not in the wheel's own collection. Becomes the chronicle-surface mirror per the Β§7 dependency order; mirroring is William's decision.
  3. veritas Neon β€” view-state only, never the record. Flags/snapshots are how the ceremony looks, per-user, auth-scoped. Binding pointer only (model_data.binding = {chartId, store}) when a native DigitalModel is the rendering vehicle.

No-third-implementation holds: coaia records Β· veritas renders Β· medicine-wheel (later) mirrors. elementsOfPerformance (DESIGN/EXECUTION) maps 1:1 onto veritas type-2 elements β€” the DPR's element list is seeded from the chart, not authored twice.

Options ranked (post E1–E10, localhost/tailnet constraint)

  1. Watch the chart store file β†’ SSE veritas STC view β€” WON, structurally: it is E1 (announce can only follow saveGraph), E7 (the seat's MCP is the out-of-band writer; the watcher-differ is the reconciler), E9 (agent tools never touch the surface). Gap: E3 (full refetch) β€” repairable server-side. Its own strongest counter: scores well partly by dodging the hard decisions; the moment William edits the chart FROM the veritas screen it inherits every echo/merge problem plus write access to a file five seats share.
  2. In-process emitter + SSE for veritas's own Neon models β€” the designing-mode path. Requires: UPDATE … RETURNING updated_at as the emit token (E1), origin-id + _applyingRemote discipline (E4), and the processModel reset-on-load becoming an explicit user action (E5 β€” a session-semantics refactor, not wiring). Growth path: promote to a small standalone hub (stateloom's shape, their rejoin defect fixed, no baked URLs).
  3. Poll-behind-SSE β€” voided by the constraint; converges on option 1 done worse.
  4. Postgres LISTEN/NOTIFY β€” refuted by the codebase's own driver (@neondatabase/serverless cannot hold a LISTEN session; Neon pooling drops listeners; worst failure shape).

Defects found in veritas while designing

  • Browser saves silently 405'd: UI sent PATCH; route exports GET/PUT/DELETE; optimistic state made it look saved. Fixed (one word, PATCHβ†’PUT) in the slice commit.
  • processModel resets all evaluation flags on every getModel β€” any naive refetch wipes an evaluation in progress; the live design must merge, never blind-refetch, when option 2 lands.
  • veritas_mmot_evaluate writes JSON (mmot-<id>-<ts>.json) to .mw/north/, not markdown (correction to the first scout).
  • .mw/west/README.md advertises 9 MCP tools that do not exist in code. Wrap code, never that README.

The coaia-narrative upgrade (additive, for per-element MMOT)

(a) stable ids on elementsOfPerformance entries + a post-creation editor tool; (b) optional elementAssessments: [{elementId, state(Β±), trend(↑→↓), note}] on mmotEvaluations[] entries. No new entity type. This gives the DPR its per-element state without a third MMOT implementation.

Verified demo (2026-08-01 ~21:10 EDT)

Server :3123 with VERITAS_STC_STORE env β†’ /stc/chart_1785632224671. SSE captured hello (revision 2026-08-02T01:05:36.734Z); perform_mmot_evaluation(acknowledge, South) through the seat's MCP; listener captured exactly one change; GET showed mmotEvaluations 0β†’1, current reality 4β†’5, beats 0β†’1, revision β†’ 01:10:53.062Z. Agent write β†’ store β†’ watch β†’ SSE β†’ surface, ~1s, no stateloom package imported, no third MMOT store born.

Held / next

  • Designing mode (edit from veritas screen) β€” option 2's discipline, waits.
  • Server-side differ (E3) β€” first follow-up on the read path.
  • Per-element assessments β€” the coaia upgrade above.
  • Whether medicine-wheel mirrors MMOTs to the chronicle β€” William's.