NODEDC_1C/docs/ARCH/11 - architecture_turnaround/11 - continuity_stabilization_plan_2026-04-17.md

11 - Continuity Stabilization Plan (2026-04-17)

Purpose

This note defines the recovery plan for the current pre-expansion breakpoint.

The goal is not to patch individual failing prompts.

The goal is to finish the missing runtime authority that should govern mixed live sessions after the turnaround 11 owner extractions.

Current Reading

The strongest current evidence is:

• narrow and company-selected scenarios can pass end-to-end;
• mixed saved-session runtime still fails on root inventory, selected-object continuity, same-date restore, and cross-domain same-date pivot;
• therefore the architecture is not missing only routes;
• it is missing one governing continuity authority.

In one sentence:

• decision ownership became distributed faster than continuity ownership became explicit.

What This Plan Stabilizes

This plan is specifically about one system object:

• assistant_session_continuity_v1

That object should become the shared authority for:

• active root frame
• active selected object
• active organization scope
• active date scope
• active clarification state
• active answer object / reusable bundle
• recap source of truth

Target Runtime Rule

Before any of the following decisions are made:

• route arbitration
• company clarification
• selected-object follow-up routing
• same-date restore
• recap answer generation

the runtime must first resolve one continuity snapshot for the active session.

Those downstream owners may interpret the snapshot differently, but they must not reconstruct competing versions of the session state independently.

Immediate Passes

Pass A. Install shared continuity snapshot

Scope:

• create one shared continuity resolver for session items and grounded address context;
• centralize extraction of active item, organization, date, root frame, and recap-eligible grounded context;
• stop allowing recap and adjacent meta logic to build over ungrounded or clarification-only state.

Exit condition:

• recap can only trigger over verified grounded address context;
• selected-object memory cannot be reconstructed from failed clarification turns;
• route and memory layers consume the same continuity snapshot.

Pass B. Reduce clarification priority conflicts

Scope:

• move clarification behind restored continuity when the business frame is already sufficient;
• stop repeated company clarification from interrupting same-family continuation;
• make clarification state explicit and resumable instead of re-discovered ad hoc.

Exit condition:

• repeated clarification no longer appears after adjacent grounded business answers in the same thread;
• selected-object and same-date follow-ups stop falling into generic company templates.

Pass C. Re-ground recap and answer packaging

Scope:

• recap must summarize verified session facts only;
• answer packaging must not sound more certain than truth assembly;
• technical scaffolding must not leak into the top block of user-facing answers.

Exit condition:

• recap cannot claim supplier/date/document facts that were never grounded;
• meta boundary replies no longer expose MCP, read-only, route ids, capability ids, or debug labels;
• user-facing top blocks remain business-first.

Pass D. Lock mixed runtime as the primary gate

Scope:

• promote mixed saved-session runtime to the main architecture gate before domain expansion;
• keep narrow harnesses and seam tests, but do not let them overrule mixed replay;
• evaluate critical user paths rather than isolated route green status.

Exit condition:

• the core mixed replay is green on direct answer, selected-object continuity, same-date carryover, recap truthfulness, and technical cleanliness;
• no unresolved P0 remains on the primary user path.

Anti-Goals

This stabilization pass is not:

• a rollback to the old monolith
• a case-by-case regex patch sweep
• a prompt-only wording cleanup
• a UI-only improvement pass

Practical Sequence

1. Finish the continuity snapshot and wire it into the hot route / recap path.
2. Rework clarification precedence so it becomes a last meaningful step.
3. Harden recap and boundary presentation against ungrounded and technical output.
4. Rerun the mixed AGENT replay until the critical continuity edges are green.
5. Only then continue deeper intent extraction and wider domain expansion.

Current Pass Status

Completed in the current working pass:

• shared continuity snapshot is already wired into recap and adjacent route memory logic;
• grounded address history can now restore active organization scope instead of depending only on explicit company-selection metadata;
• early organization clarification no longer outranks item-focused inventory follow-up paths when the session already carries a strong object frame;
• meta boundary replies were already cleaned from technical MCP / read-only leakage.
• early non_domain arbitration no longer suppresses a positive L0 address-lane decision for colloquial but supported exact routes;
• foreign-accounting pivots over inventory drilldown now preserve root-scoped carryover instead of dropping continuity before root-frame sanitation;
• the wide assistantAddressFollowupContext regression pack is green again, including month-only VAT follow-up and inventory -> VAT pivot sanitation.
• counterparty document root wording is now recovered through unicode-safe exact signals instead of depending on mojibake-sensitive legacy phrases;
• declined Russian account wording like по счёту 60 now restores account scope inside polarity/runtime guards instead of collapsing into other_numeric;
• exact address intents can now stay in the address lane even if the semantic guard overflags deep investigation without an actual investigative user request;
• live replay address_truth_harness_phase7_meta_domain_mix_live_20260417_post_arch_fix_rerun2 is accepted end-to-end with 14/14 steps green, including the previously broken step_01_counterparty_documents and step_04_open_items_account_60.

Still open after this pass:

• mixed continuity is now strong enough for the current phase7 gate, but it still needs broader saved-session proof before domain expansion can be treated as low-risk;
• the next architecture pass should move from one repaired mixed replay to a wider saved-session set and multi-domain acceptance pack;
• remaining work should focus on keeping the unified continuity authority stable under new real user paths, not on wording-only polish or isolated route greens.

Ready Signal

The project can leave the current breakpoint when:

• mixed live sessions no longer depend on distributed guesswork about active context;
• clarification does not outrank valid restored business continuity;
• recap is grounded and business-useful;
• technical scaffolding is removed from user-facing meta answers;
• the primary mixed replay is green for the real user path, not only for narrow packs.