# 1CLLMARCH Fact Check And Stabilization Plan Updated at: 2026-04-10 Source baseline: `docs/TECH/1CLLMARCH.md` ## 1. Purpose This document fixes the current factual state of the codebase against `1CLLMARCH` and records a production-focused stabilization plan that preserves: 1. existing MCP routes; 2. manual routing and guard logic; 3. GUI manual markup + autorun operational loop. ## 2. Executive Reality Check Current state is **not MVP** and also **not stable production**. It is an advanced prototype with strong observability and eval tooling, but with architectural coupling and quality bottlenecks. Approximate readiness against target architecture: **55/100**. ## 3. Verified Facts (Code + Runtime) 1. Strong engineering layers already exist: - requirement extraction, coverage, grounding checks; - rich debug payload and session trace; - investigation state/followup continuity; - manual annotation schema and post-analysis queues; - async eval run + live history APIs. 2. Main production blockers: - orchestration monolith and coupling in `assistantService.ts`; - deterministic/template-heavy final answer construction; - large lexical heuristic surface for intent routing; - temporal policy inconsistency (date handling differs by lane/path); - hidden fallback behavior around historical snapshot assumptions. 3. Quality metrics from latest Stage1 runs confirm weak user value: - low retrieval differentiation; - high generic explanation rate; - low accountant actionability; - zero mechanism specificity. ## 4. Gap Vs `1CLLMARCH` ### 4.1 Already aligned (partially or strongly) 1. Structured normalization contracts and validator loops. 2. Coverage and grounding artifacts (with different naming than target). 3. Conversation state persistence. 4. Operational diagnostics and report generation. ### 4.2 Not aligned enough for stable prod 1. Role separation (Interpreter/Planner/Critic/Answer) is incomplete and strongly coupled. 2. Final user answer quality is constrained by deterministic template synthesis. 3. Unified contract for analysis date/time scope is missing across all lanes. 4. Result classes from target (`FULLY_ANSWERED`, `BLOCKED_BY_*`, etc.) are not normalized as one contract. 5. Reason-code taxonomy exists but is fragmented across modules. ## 5. Stabilization Plan (No Route Breakage) ## Stage 1 (P0): Unified Analysis Context + Temporal Hardening Goal: 1. Introduce unified `analysis_context` contract. 2. Propagate it through eval -> assistant -> runtime lanes. 3. Remove hidden hardcoded period fallback in live MCP plan generation. 4. Keep backward compatibility (`period_hint` still supported). Acceptance: 1. If analysis date is set, runtime uses it explicitly in both deep/address paths. 2. If analysis date is absent, runtime no longer silently injects fixed historical date in live-plan fallback. 3. Existing APIs and manual workflows remain operational. Implemented in current pass: 1. Added unified `analysis_context` contract to request context (`as_of_date`, `period_from`, `period_to`, `snapshot_mode`, `source`). 2. Added compatibility bridge: legacy `period_hint` is still accepted and normalized into `analysis_context`. 3. Propagated analysis context through eval flows into assistant runtime. 4. Applied analysis context in temporal guard with explicit precedence over implicit snapshot lock. 5. Removed hidden hardcoded live-plan fallback period by switching to: - explicit analysis period/date when provided; - query-derived period when present; - generic live probe when period is absent. Validation: 1. `npm run build` passed. 2. Targeted runtime tests passed: - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Status: **Completed** ## Stage 2 (P1): Orchestrator Decomposition (Behavior-Preserving Refactor) Goal: 1. Split monolith into explicit modules: - QueryFrame builder - Execution planner - Evidence assembler - Coverage critic - Answer package builder 2. Preserve current behavior under compatibility adapter. Acceptance: 1. No MCP route regressions. 2. Existing tests and autorun loop remain green. Implemented in current pass (Phase 2.1): 1. Added new orchestration contract module: - `assistant_query_frame_v1` - `assistant_execution_plan_v1` - `assistant_evidence_bundle_v1` - `assistant_coverage_contract_v1` - outcome classifier (`FULLY_ANSWERED`, `PARTIALLY_ANSWERED`, `BLOCKED_*`, `MISROUTED`, `FAILED_TO_BIND_ENTITIES`) 2. Integrated contracts into deep-lane runtime without route/answer behavior changes: - debug payload now includes `assistant_outcome_class_v1`; - debug payload and event logs now include `assistant_orchestration_contracts_v1`. 3. Added unit regression tests: - `assistantOrchestrationContracts.test.ts` Validation: 1. `npm run build` passed. 2. Targeted tests passed: - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.2): 1. Added runtime orchestration adapter for the deep lane: - `assistantOrchestrationRuntimeAdapter.ts` - unified pipeline call for `requirements -> coverage -> grounding` with stable interfaces. 2. Integrated adapter into `assistantService` main deep-lane flow (behavior-preserving): - existing extraction/coverage/grounding logic preserved; - execution now routed through one orchestration boundary. 3. Added adapter unit tests: - `assistantOrchestrationRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted tests passed: - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.3): 1. Extracted answer package builder (`answer_structure_v11`) from `assistantService` into dedicated module: - `assistantAnswerPackageBuilder.ts` 2. Rewired deep-lane answer structure assembly to use the new module without contract changes. 3. Added focused unit tests for answer package behavior: - `assistantAnswerPackageBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 test pack passed: - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.4): 1. Extracted coverage/grounding pipeline into dedicated module: - `assistantCoverageGrounding.ts` - moved requirement extraction, coverage resolution, and grounding checks under one reusable boundary. 2. Rewired `assistantService` to use extracted coverage/grounding module via compatibility wrappers (behavior-preserving). 3. Added focused regression tests: - `assistantCoverageGrounding.test.ts` 4. Stabilized deterministic Stage 2 regression environment for followup continuity checks: - fixed accidental false-positive token in grounding test fixture; - fixed env isolation in `assistantWave10SettlementCorrectiveRegression.test.ts` by explicitly controlling `FEATURE_ASSISTANT_ADDRESS_QUERY_V1`. Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.5): 1. Extracted query-planning helpers from `assistantService` into dedicated module: - `assistantQueryPlanning.ts` - moved `fragmentTextById`, execution-plan builder, and debug-routes builder under one reusable boundary. 2. Rewired `assistantService` to use extracted query-planning module (behavior-preserving wrapper integration). 3. Added focused unit tests for query-planning behavior: - `assistantQueryPlanning.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.6): 1. Extracted evidence-bundle assembly from `assistantService` into dedicated module: - `assistantEvidenceBundleAssembler.ts` - centralized: - `assistant_evidence_bundle_v1` contract assembly; - debug `retrieval_status` projection from normalized retrieval results. 2. Rewired `assistantService` to use assembler output for both: - `assistant_orchestration_contracts_v1.evidence_bundle`; - debug payload `retrieval_status`. 3. Added focused unit tests: - `assistantEvidenceBundleAssembler.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantEvidenceBundleAssembler.test.ts` - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.7): 1. Extracted deep-lane debug payload assembly from `assistantService` into dedicated module: - `assistantDebugPayloadAssembler.ts` 2. Rewired `assistantService` to build `debug` via assembler (behavior-preserving): - keeps all existing fields, guard audits, orchestration contracts and optional sections. 3. Added focused unit tests: - `assistantDebugPayloadAssembler.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantDebugPayloadAssembler.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.8): 1. Extracted deep-lane processed log payload assembly from `assistantService` into dedicated module: - `assistantMessageLogAssembler.ts` 2. Rewired `assistantService` to build `assistant_message_processed.details` via assembler (behavior-preserving). 3. Added focused unit tests: - `assistantMessageLogAssembler.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantMessageLogAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.9): 1. Extracted orchestration-contract bundle assembly from `assistantService` into dedicated module: - `assistantContractsBundleAssembler.ts` 2. Rewired `assistantService` to consume bundled contracts/outcome class from assembler (behavior-preserving): - `query_frame`, `execution_plan`, `evidence_bundle`, `coverage`, `outcome_class`. 3. Added focused unit tests: - `assistantContractsBundleAssembler.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantContractsBundleAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.10): 1. Extracted deep response envelope assembly from `assistantService` into dedicated module: - `assistantDeepResponseAssembler.ts` - centralized: - safe final assistant text cleanup (debug tail stripping); - `answer_structure_v11` selection/building policy; - assistant conversation item construction. 2. Rewired `assistantService` to consume deep response assembler (behavior-preserving). 3. Added focused unit tests: - `assistantDeepResponseAssembler.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 + safety regressions passed: - `assistantDeepResponseAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantQueryPlanning.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantOrchestrationContracts.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.11): 1. Added top-level deep turn packager to compose extracted Stage 2 modules behind one boundary: - `assistantDeepTurnPackaging.ts` - centralizes orchestration of: - evidence bundle assembly; - contracts/outcome class assembly; - deep answer artifacts; - debug payload; - assistant conversation item; - processed log details. 2. Rewired deep-lane `assistantService` flow to use `assembleAssistantDeepTurnPackaging(...)` (behavior-preserving): - replaced duplicated per-artifact assembly block with single orchestrator call; - preserved investigation-state update and existing response/event contract. 3. Added focused unit test: - `assistantDeepTurnPackaging.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.12): 1. Extracted deep-turn input normalization/defaulting from `assistantService` into dedicated module: - `assistantDeepTurnInputBuilder.ts` - centralized normalization of: - `followupStateUsage` default (`null` when absent); - composition defaults (`problem_*` fields, `answer_structure_v11`); - `problem_unit_ids_used` array normalization. 2. Rewired `assistantService` to build deep-turn input via: - `buildAssistantDeepTurnPackagingInput(...)` - followed by existing `assembleAssistantDeepTurnPackaging(...)` call (behavior-preserving). 3. Added focused unit tests: - `assistantDeepTurnInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.13): 1. Extracted investigation-state update/persist runtime block from `assistantService` into dedicated adapter: - `assistantInvestigationStateRuntimeAdapter.ts` - introduced: - `buildAssistantInvestigationStateSnapshot(...)` - `persistAssistantInvestigationStateSnapshot(...)` 2. Rewired `assistantService` to consume new adapter (behavior-preserving): - same `investigation_state` snapshot semantics; - same `FEATURE_ASSISTANT_INVESTIGATION_STATE_V1` gating; - same session persistence call path. 3. Added focused unit tests: - `assistantInvestigationStateRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.14): 1. Extracted deep-lane assistant post-turn commit/persist/log block from `assistantService` into dedicated adapter: - `assistantTurnCommitRuntimeAdapter.ts` - introduced: - `commitAssistantTurnAndLog(...)` 2. Rewired `assistantService` deep-lane to use new adapter (behavior-preserving): - same append-to-session semantics; - same session persistence behavior when session exists; - same `assistant_message_processed` log envelope and event type. 3. Added focused unit tests: - `assistantTurnCommitRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.15): 1. Extracted deep-lane pre-packaging context assembly from `assistantService` into dedicated module: - `assistantDeepTurnPrePackagingContext.ts` - centralized: - dropped intent segments extraction; - analysis context projection for contracts; - debug route projection; - resolved execution state projection; - safe assistant reply base sanitization. 2. Rewired `assistantService` deep-lane to consume `buildAssistantDeepTurnPrePackagingContext(...)` (behavior-preserving). 3. Added focused unit tests: - `assistantDeepTurnPrePackagingContext.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.16): 1. Extracted deep-lane success response envelope assembly from `assistantService` into dedicated builder: - `assistantDeepTurnResponseBuilder.ts` - introduced: - `buildAssistantDeepTurnSuccessResponse(...)` 2. Rewired `assistantService` deep-lane to return response via new builder (behavior-preserving). 3. Added focused unit tests: - `assistantDeepTurnResponseBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.17): 1. Extracted deep-lane composition assembly from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnCompositionRuntimeAdapter.ts` - introduced: - `buildAssistantDeepTurnComposition(...)` 2. Centralized composition-time derivations (behavior-preserving): - `focusDomainHint` from followup usage + investigation state; - `questionTypeClass` via `resolveQuestionType(...)`; - period presence signals from company anchors/normalization payload; - downstream `composeAssistantAnswer(...)` call wiring. 3. Rewired `assistantService` deep-lane to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.18): 1. Extracted deep-lane guard runtime pipeline from `assistantService` into dedicated adapter: - `assistantDeepTurnGuardRuntimeAdapter.ts` - introduced: - `applyAssistantDeepTurnRetrievalGuards(...)` - `applyAssistantDeepTurnGroundingEligibility(...)` 2. Centralized and isolated runtime sequence (behavior-preserving): - polarity guard on retrieval results; - targeted evidence acquisition; - evidence admissibility gate; - grounded-answer eligibility evaluation + grounding status overlay. 3. Rewired `assistantService` deep-lane to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnGuardRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.19): 1. Extracted deep-lane retrieval execution loop from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnRetrievalRuntimeAdapter.ts` - introduced: - `executeAssistantDeepTurnRetrievalPlan(...)` 2. Centralized retrieval runtime behavior (behavior-preserving): - skipped/no-route call record generation; - sequential route execution with temporal hint propagation; - raw result capture; - failed-route fallback normalization with stable error envelope. 3. Rewired `assistantService` deep-lane to consume retrieval adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.20): 1. Extracted deep-lane execution-plan assembly/enforcement from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnPlanRuntimeAdapter.ts` - introduced: - `buildAssistantDeepTurnExecutionPlan(...)` 2. Centralized planning runtime sequence (behavior-preserving): - requirement extraction by fragment; - execution plan build from route summary; - RBP route-plan enforcement; - FA route-plan enforcement; - temporal hint overlay; - polarity hint overlay. 3. Rewired `assistantService` deep-lane to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnPlanRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` - `assistantDeepTurnPlanRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.21): 1. Extracted deep-lane pre-guard runtime context assembly from `assistantService` into dedicated adapter: - `assistantDeepTurnContextRuntimeAdapter.ts` - introduced: - `buildAssistantDeepTurnRuntimeContext(...)` 2. Centralized context runtime sequence (behavior-preserving): - company anchors resolution; - initial business-scope alignment; - P0 domain inference + domain whitelist gating for guard focus; - temporal guard resolution with runtime analysis context; - domain polarity guard resolution; - claim-bound anchors resolution; - live business-scope resolution with followup flag; - normalized live temporal hint projection. 3. Rewired `assistantService` deep-lane to consume context adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnContextRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` - `assistantDeepTurnPlanRuntimeAdapter.test.ts` - `assistantDeepTurnContextRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.22): 1. Extracted deep-lane post-retrieval grounding runtime orchestration from `assistantService` into dedicated adapter: - `assistantDeepTurnGroundingRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnGroundingRuntime(...)` 2. Centralized grounding/runtime sequence (behavior-preserving): - RBP live-route audit projection; - FA live-route audit projection; - coverage+grounding pipeline execution; - grounded-answer eligibility overlay on base grounding check. 3. Rewired `assistantService` deep-lane to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnGroundingRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` - `assistantDeepTurnPlanRuntimeAdapter.test.ts` - `assistantDeepTurnContextRuntimeAdapter.test.ts` - `assistantDeepTurnGroundingRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.23): 1. Extracted deep-lane packaging orchestration block from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnPackagingRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnPackagingRuntime(...)` 2. Centralized packaging/runtime sequence (behavior-preserving): - pre-packaging context assembly; - investigation-state snapshot build/persist; - deep-turn packaging input assembly; - deep-turn packaging output projection (`safeAssistantReply`, debug payload, assistant item, processed log details). 3. Rewired `assistantService` deep-lane to consume packaging runtime adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` - `assistantDeepTurnPlanRuntimeAdapter.test.ts` - `assistantDeepTurnContextRuntimeAdapter.test.ts` - `assistantDeepTurnGroundingRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.24): 1. Extracted deep-lane finalization/response tail from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnFinalizeRuntimeAdapter.ts` - introduced: - `finalizeAssistantDeepTurn(...)` 2. Centralized finalization runtime sequence (behavior-preserving): - assistant turn commit + processed-event logging; - deep-turn API success response assembly from committed conversation state. 3. Rewired `assistantService` deep-lane to consume finalization adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantDeepTurnFinalizeRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 assembler/adapter pack passed: - `assistantOrchestrationContracts.test.ts` - `assistantOrchestrationRuntimeAdapter.test.ts` - `assistantAnswerPackageBuilder.test.ts` - `assistantCoverageGrounding.test.ts` - `assistantQueryPlanning.test.ts` - `assistantEvidenceBundleAssembler.test.ts` - `assistantDebugPayloadAssembler.test.ts` - `assistantMessageLogAssembler.test.ts` - `assistantContractsBundleAssembler.test.ts` - `assistantDeepResponseAssembler.test.ts` - `assistantDeepTurnPackaging.test.ts` - `assistantDeepTurnInputBuilder.test.ts` - `assistantInvestigationStateRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` - `assistantDeepTurnPrePackagingContext.test.ts` - `assistantDeepTurnResponseBuilder.test.ts` - `assistantDeepTurnCompositionRuntimeAdapter.test.ts` - `assistantDeepTurnGuardRuntimeAdapter.test.ts` - `assistantDeepTurnRetrievalRuntimeAdapter.test.ts` - `assistantDeepTurnPlanRuntimeAdapter.test.ts` - `assistantDeepTurnContextRuntimeAdapter.test.ts` - `assistantDeepTurnGroundingRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantDeepTurnFinalizeRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.25): 1. Extracted address-lane finalization/response tail from `assistantService` into dedicated runtime adapter: - `assistantAddressTurnFinalizeRuntimeAdapter.ts` - introduced: - `finalizeAssistantAddressTurn(...)` 2. Centralized address finalization runtime sequence (behavior-preserving): - assistant item creation for address lane; - structured `assistant_message_address` processed-event payload build; - turn commit/persist/log via shared commit runtime adapter; - API success response assembly from committed conversation state. 3. Rewired `assistantService` address-lane finalize path to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantAddressTurnFinalizeRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted Stage 2 adapter/finalization pack passed: - `assistantAddressTurnFinalizeRuntimeAdapter.test.ts` - `assistantDeepTurnFinalizeRuntimeAdapter.test.ts` - `assistantTurnCommitRuntimeAdapter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.26): 1. Extracted living-chat finalization/response tail from `assistantService` into dedicated runtime adapter: - `assistantLivingChatTurnFinalizeRuntimeAdapter.ts` - introduced: - `finalizeAssistantLivingChatTurn(...)` 2. Centralized living-chat finalization runtime sequence (behavior-preserving): - assistant item creation for chat lane; - structured `assistant_message_chat` processed-event payload build; - turn commit/persist/log via shared commit runtime adapter; - API success response assembly from committed conversation state. 3. Rewired `assistantService` `tryHandleLivingChat(...)` finalize path to consume adapter output (behavior-preserving). 4. Added focused unit tests: - `assistantLivingChatTurnFinalizeRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep finalize pack passed: - `assistantLivingChatTurnFinalizeRuntimeAdapter.test.ts` - `assistantAddressTurnFinalizeRuntimeAdapter.test.ts` - `assistantDeepTurnFinalizeRuntimeAdapter.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` 3. Additional safety regressions passed: - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantMcpRuntimeBridge.test.ts` - `assistantAddressFollowupContext.test.ts` Implemented in current pass (Phase 2.27): 1. Extracted living-chat runtime orchestration branch from `assistantService` into dedicated runtime adapter: - `assistantLivingChatRuntimeAdapter.ts` - introduced: - `runAssistantLivingChatRuntime(...)` 2. Centralized living-chat runtime branch sequence (behavior-preserving): - deterministic capability + safety refusal branch; - deterministic data-scope contract branch (with live probe projection); - deterministic organization-boundary and scope-selection branches; - deterministic operational-boundary and capability-contract branches; - LLM chat branch with script-guard + grounding-guard post-processing. 3. Rewired `assistantService` `tryHandleLivingChat(...)` to consume runtime adapter output and keep existing chat finalization adapter path unchanged. 4. Added focused unit tests: - `assistantLivingChatRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/chat followup pack passed: - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.28): 1. Extracted address-lane retry orchestration branch from `assistantService` into dedicated runtime adapter: - `assistantAddressLaneRuntimeAdapter.ts` - introduced: - `runAssistantAddressLaneRuntime(...)` 2. Centralized address retry/runtime branch sequence (behavior-preserving): - contextual-first execution when followup context is preferred; - primary execution without followup context; - optional contextual fallback when context exists but is not preferred; - retry with raw user message for retryable limited results; - deterministic fallback to pending limited result when retry does not improve outcome. 3. Rewired `assistantService` address lane execution path to consume retry adapter output and preserve existing address finalization contract. 4. Added focused unit tests: - `assistantAddressLaneRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address followup pack passed: - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.29): 1. Extracted address orchestration bootstrap block from `assistantService` into dedicated runtime adapter: - `assistantAddressOrchestrationRuntimeAdapter.ts` - introduced: - `buildAssistantAddressOrchestrationRuntime(...)` 2. Centralized address orchestration bootstrap sequence (behavior-preserving): - LLM predecompose stage or deterministic fallback contract when feature is disabled; - effective address input message resolution; - followup carryover context resolution; - orchestration/tool-gate decision resolution; - dialog continuation contract projection into runtime meta; - living mode decision projection for chat fallback. 3. Rewired `assistantService` address pre-lane bootstrap path to consume orchestration runtime adapter output. 4. Added focused unit tests: - `assistantAddressOrchestrationRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address followup pack passed: - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.30): 1. Extracted address tool-gate skip branch from `assistantService` into dedicated runtime adapter: - `assistantAddressToolGateRuntimeAdapter.ts` - introduced: - `runAssistantAddressToolGateRuntime(...)` 2. Centralized tool-gate skip/runtime sequence (behavior-preserving): - deterministic early noop when `runAddressLane=true`; - structured `assistant_address_tool_gate_skip` logging payload projection; - conditional living-chat fallback invocation when mode is `chat`. 3. Rewired `assistantService` to consume tool-gate runtime adapter output and preserve existing early-return contract for handled chat fallback. 4. Added focused unit tests: - `assistantAddressToolGateRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address followup pack passed: - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.31): 1. Extracted deep-lane followup binding + normalize bootstrap block from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnNormalizationRuntimeAdapter.ts` - introduced: - `buildAssistantDeepTurnNormalizationRuntime(...)` 2. Centralized deep normalization bootstrap sequence (behavior-preserving): - followup state binding projection when feature flags are enabled; - deterministic fallback to raw user question when followup binding is disabled/unavailable; - normalize request payload assembly and normalizer invocation. 3. Rewired `assistantService` deep-lane bootstrap to consume normalization runtime adapter output. 4. Added focused unit tests: - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.32): 1. Extracted deep-lane context/plan/retrieval/guard/grounding/composition orchestration block from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnAnalysisRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnAnalysisRuntime(...)` 2. Centralized deep analysis sequence wiring (behavior-preserving): - runtime context stage output propagation; - execution-plan, retrieval, guard and grounding stage chaining; - composition stage input projection from grounded retrieval output. 3. Rewired `assistantService` deep-lane middle pipeline to consume analysis runtime adapter output while preserving existing packaging/finalization contracts. 4. Added focused unit tests: - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.33): 1. Extracted deep-lane response tail (packaging + finalize) from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnResponseRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnResponseRuntime(...)` 2. Centralized deep response-tail sequence (behavior-preserving): - packaging runtime invocation with full debug/contract payload projection; - deep finalization invocation with packaged reply/debug artifacts; - single response projection back to caller. 3. Rewired `assistantService` deep-lane tail to consume response runtime adapter output. 4. Added focused unit tests: - `assistantDeepTurnResponseRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.34): 1. Extracted top-level address branch orchestration from `assistantService` into dedicated runtime adapter: - `assistantAddressRuntimeAdapter.ts` - introduced: - `runAssistantAddressRuntime(...)` 2. Centralized full address-branch control flow (behavior-preserving): - address bootstrap orchestration stage; - tool-gate skip/chat fallback stage; - lane execution/retry stage with analysis-date hint propagation; - address finalize stage projection with retry audit merge. 3. Rewired `assistantService` address branch to a single runtime adapter invocation and preserved `addressRuntimeMetaForDeep` propagation contract. 4. Added focused unit tests: - `assistantAddressRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.35): 1. Extracted address-lane response-tail (debug enrichment + finalize projection) from `assistantService` into dedicated runtime adapter: - `assistantAddressLaneResponseRuntimeAdapter.ts` - introduced: - `runAssistantAddressLaneResponseRuntime(...)` 2. Centralized address response-tail sequence (behavior-preserving): - reply sanitization and structured address debug payload assembly; - followup-offer projection + known/active organization debug enrichment; - address turn finalization through existing finalize adapter contract. 3. Rewired `assistantService` `finalizeAddressLaneResponse(...)` closure to consume response runtime adapter output. 4. Added focused unit tests: - `assistantAddressLaneResponseRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.36): 1. Extracted living-chat handler branch (`tryHandleLivingChat`) from `assistantService` into dedicated runtime adapter: - `assistantLivingChatHandlerRuntimeAdapter.ts` - introduced: - `tryHandleAssistantLivingChatRuntime(...)` 2. Centralized living-chat handler sequence (behavior-preserving): - living-chat runtime invocation (deterministic/LLM guard chain); - chat finalization invocation for `assistant_message_chat` response path; - warn-log fallback path for runtime failures. 3. Rewired `assistantService` `tryHandleLivingChat(...)` closure to consume handler runtime adapter output. 4. Added focused unit tests: - `assistantLivingChatHandlerRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnNormalizationRuntimeAdapter.test.ts` - `assistantAddressToolGateRuntimeAdapter.test.ts` - `assistantAddressOrchestrationRuntimeAdapter.test.ts` - `assistantAddressLaneRuntimeAdapter.test.ts` - `assistantAddressFollowupContext.test.ts` - `assistantLivingChatMode.test.ts` - `assistantLivingRouter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.37): 1. Extracted living-chat LLM call/build block from `assistantService` into dedicated runtime adapter: - `assistantLivingChatLlmRuntimeAdapter.ts` - introduced: - `runAssistantLivingChatLlmRuntime(...)` 2. Centralized living LLM execution sequence (behavior-preserving): - context window assembly from session history; - canon excerpt loading and prompt composition; - model/token selection with guard clamp; - output sanitization with stable fallback. 3. Rewired `assistantService` `tryHandleLivingChat(...)` closure to consume the new LLM runtime adapter. 4. Added focused unit tests: - `assistantLivingChatLlmRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.38): 1. Internalized living-chat prompt/context builders into `assistantLivingChatLlmRuntimeAdapter`: - removed external builder dependencies from runtime input contract; - centralized compacting + clipping + context/prompt projection directly in adapter. 2. Simplified `assistantService` living LLM call wiring: - removed `buildLivingChatContextWindow` / `buildLivingChatPrompt` injection from `executeLlmChat`. 3. Updated focused tests for adapter-owned prompt assembly: - `assistantLivingChatLlmRuntimeAdapter.test.ts` now verifies context carryover and user-message prompt shape. 4. Applied cleanup inside `assistantService` after the wiring simplification: - removed dead local living prompt/context helper functions. Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.39): 1. Extracted user-turn bootstrap sequence from `assistantService` into dedicated runtime adapter: - `assistantUserTurnBootstrapRuntimeAdapter.ts` - introduced: - `runAssistantUserTurnBootstrapRuntime(...)` 2. Centralized user-turn bootstrap flow (behavior-preserving): - session ensure + user message normalization/repair; - user item append + session persistence; - runtime analysis context projection. 3. Rewired `assistantService.handleMessage(...)` to consume bootstrap runtime output and preserve downstream `questionId` contract usage. 4. Added focused unit tests: - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.40): 1. Extracted address-lane attempt bridge (`runAddressLaneAttempt`) from `assistantService` into dedicated runtime adapter: - `assistantAddressLaneAttemptRuntimeAdapter.ts` - introduced: - `runAssistantAddressLaneAttemptRuntime(...)` 2. Centralized address-lane attempt handoff logic (behavior-preserving): - organization-scoped followup context merge; - fallback to plain lane attempt when scoped context is unavailable; - strict propagation of analysis-date hint into `addressQueryService.tryHandle(...)`. 3. Rewired `assistantService` to consume lane-attempt runtime adapter. 4. Added focused unit tests: - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.41): 1. Extracted living-chat attempt bridge (`tryHandleLivingChat`) from `assistantService` into dedicated runtime adapter: - `assistantLivingChatAttemptRuntimeAdapter.ts` - introduced: - `runAssistantLivingChatAttemptRuntime(...)` 2. Centralized living-chat attempt handoff logic (behavior-preserving): - delegated handler invocation (`tryHandleAssistantLivingChatRuntime(...)`); - delegated LLM call bridge (`runAssistantLivingChatLlmRuntime(...)`) behind unified `executeLlmChat` contract; - preserved all guard, scope and session finalization hooks. 3. Rewired `assistantService` to consume living-chat attempt runtime adapter. 4. Added focused unit tests: - `assistantLivingChatAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.42): 1. Extracted address-lane response attempt bridge (`finalizeAddressLaneResponse`) from `assistantService` into dedicated runtime adapter: - `assistantAddressLaneResponseAttemptRuntimeAdapter.ts` - introduced: - `runAssistantAddressLaneResponseAttemptRuntime(...)` 2. Centralized address-lane response handoff logic (behavior-preserving): - delegated response runtime invocation (`runAssistantAddressLaneResponseRuntime(...)`); - preserved followup-offer/debug payload and session finalization contract wiring. 3. Rewired `assistantService` to consume address-lane response attempt runtime adapter. 4. Added focused unit tests: - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.43): 1. Extracted deep-analysis bridge (`deepTurnAnalysisRuntime` wiring) from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnAnalysisAttemptRuntime(...)` 2. Centralized deep-analysis handoff logic (behavior-preserving): - context/plan/retrieval/guard/grounding/composition chain wiring moved behind a single runtime boundary; - preserved feature flags and all existing local helper hooks (`extractRequirements`, route enforcement, coverage/grounding evaluators, audits). 3. Rewired `assistantService` to consume deep-analysis attempt runtime adapter. 4. Added focused unit tests: - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.44): 1. Extracted deep-response bridge (`deepTurnResponseRuntime` wiring) from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnResponseAttemptRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnResponseAttemptRuntime(...)` 2. Centralized deep-response handoff logic (behavior-preserving): - mapping from deep-analysis runtime output into response/packaging/finalization runtime contract moved behind a single runtime boundary; - preserved existing debug/state persistence hooks and session finalization callbacks. 3. Rewired `assistantService` to consume deep-response attempt runtime adapter. 4. Added focused unit tests: - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.45): 1. Extracted full deep-turn chain (`normalization -> analysis -> response`) from `assistantService` into dedicated runtime adapter: - `assistantDeepTurnAttemptRuntimeAdapter.ts` - introduced: - `runAssistantDeepTurnAttemptRuntime(...)` 2. Centralized deep-turn orchestration handoff (behavior-preserving): - unified composition over existing attempt adapters (`Normalization`, `Analysis`, `Response`); - preserved followup binding, runtime context propagation, response finalization hooks and investigation-state persistence callbacks. 3. Rewired `assistantService` to consume a single deep-turn runtime adapter call. 4. Added focused unit tests: - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.46): 1. Activated full address-turn attempt runtime boundary inside `assistantService`: - rewired address handling call-site to `runAssistantAddressAttemptRuntime(...)`; - removed local inline closures for lane-attempt, lane-response, and living-chat handoff wiring from `handleMessage`. 2. Finalized and type-hardened address attempt adapter contract: - `assistantAddressAttemptRuntimeAdapter.ts` - aligned `logEvent` and `messageIdFactory` contract typing to runtime expectations. 3. Added focused unit tests: - `assistantAddressAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.47): 1. Extracted top-level assistant turn orchestration (`bootstrap -> address attempt -> deep attempt`) into dedicated runtime adapter: - `assistantTurnAttemptRuntimeAdapter.ts` - introduced: - `runAssistantTurnAttemptRuntime(...)` 2. Rewired `assistantService.handleMessage` to use single top-level turn runtime boundary (behavior-preserving): - user-turn bootstrap remains delegated to `assistantUserTurnBootstrapRuntime`; - address and deep attempt runtimes remain unchanged, but orchestration/early-return logic moved out of service body. 3. Added focused unit tests: - `assistantTurnAttemptRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.48): 1. Extracted turn-level runtime input assembly from `assistantService` into dedicated builder module: - `assistantTurnRuntimeInputBuilder.ts` - introduced: - `buildAssistantUserTurnBootstrapRuntimeInput(...)` - `buildAssistantAddressAttemptRuntimeInput(...)` - `buildAssistantDeepTurnAttemptRuntimeInput(...)` 2. Rewired `assistantService.handleMessage` to consume builder outputs (behavior-preserving): - moved bulky dependency mapping for bootstrap/address/deep attempts out of service body; - preserved existing runtime adapters and route behavior. 3. Added focused unit tests: - `assistantTurnRuntimeInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.49): 1. Extracted turn runtime dependency factory from `assistantService` into dedicated adapter: - `assistantTurnRuntimeDepsAdapter.ts` - introduced: - `buildAssistantTurnRuntimeDeps(...)` 2. Rewired `assistantService.handleMessage` to construct runtime deps via adapter (behavior-preserving): - service-level wrappers for `sessions`, `sessionLogger`, `normalizerService`, `dataLayer`, `addressQueryService` moved under deps-adapter boundary; - flags/defaults/helpers remain unchanged semantically and are passed as structured groups (`flags`, `defaults`, `helpers`). 3. Added focused unit tests: - `assistantTurnRuntimeDepsAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` Implemented in current pass (Phase 2.50): 1. Extracted organization-scope runtime logic from `assistantService` into dedicated adapter: - `assistantOrganizationScopeRuntimeAdapter.ts` - introduced: - `resolveSessionOrganizationScopeContextRuntime(...)` - `mergeFollowupContextWithOrganizationScopeRuntime(...)` 2. Rewired `assistantService` scope helpers to delegate through the adapter (behavior-preserving): - `resolveSessionOrganizationScopeContext(...)` now uses runtime adapter with existing extraction/scoring/sanitization helpers; - `mergeFollowupContextWithOrganizationScope(...)` now uses runtime adapter while preserving existing normalization/toNonEmpty semantics. 3. Added focused unit tests: - `assistantOrganizationScopeRuntimeAdapter.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantUserTurnBootstrapRuntimeAdapter.test.ts` - `assistantLivingChatLlmRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.51): 1. Extracted living-chat attempt input assembly from `assistantAddressAttemptRuntimeAdapter` into dedicated builder: - `assistantLivingChatAttemptInputBuilder.ts` - introduced: - `buildAssistantLivingChatAttemptRuntimeInput(...)` 2. Rewired `assistantAddressAttemptRuntimeAdapter` to consume the new builder (behavior-preserving): - moved inline living-chat payload mapping (including `traceIdFactory` derivation and scope/meta wiring) behind a single input-builder boundary. 3. Added focused unit tests: - `assistantLivingChatAttemptInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantLivingChatAttemptInputBuilder.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.52 + 2.53 + 2.54 + 2.55): 1. Removed remaining inline address-lane response input assembly from `assistantAddressAttemptRuntimeAdapter`: - rewired `finalizeAddressLaneResponse` to `buildAssistantAddressLaneResponseAttemptRuntimeInput(...)`. 2. Added dedicated lane-attempt input builder and rewired adapter call-site: - `assistantAddressLaneAttemptInputBuilder.ts` - introduced: - `buildAssistantAddressLaneAttemptRuntimeInput(...)` 3. Added dedicated address-runtime input builder and rewired final runtime invocation: - `assistantAddressRuntimeInputBuilder.ts` - introduced: - `buildAssistantAddressRuntimeInput(...)` 4. Added focused builder tests: - `assistantAddressLaneResponseAttemptInputBuilder.test.ts` - `assistantAddressLaneAttemptInputBuilder.test.ts` - `assistantAddressRuntimeInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressLaneResponseAttemptInputBuilder.test.ts` - `assistantAddressLaneAttemptInputBuilder.test.ts` - `assistantAddressRuntimeInputBuilder.test.ts` - `assistantLivingChatAttemptInputBuilder.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.56 + 2.57 + 2.58 + 2.59 + 2.60): 1. Extracted deep-turn attempt input assembly into dedicated builder: - `assistantDeepTurnAttemptInputBuilder.ts` - introduced: - `buildAssistantDeepTurnNormalizationRuntimeInput(...)` - `buildAssistantDeepTurnAnalysisAttemptRuntimeInput(...)` - `buildAssistantDeepTurnResponseAttemptRuntimeInput(...)` 2. Rewired `assistantDeepTurnAttemptRuntimeAdapter` to consume deep-turn attempt builder outputs (behavior-preserving): - removed inline normalization/analysis/response attempt payload mapping from adapter body. 3. Extracted deep-turn response runtime input mapping into dedicated builder: - `assistantDeepTurnResponseRuntimeInputBuilder.ts` - introduced: - `buildAssistantDeepTurnResponseRuntimeInput(...)` 4. Rewired `assistantDeepTurnResponseAttemptRuntimeAdapter` to consume response runtime input builder (behavior-preserving): - moved deep-analysis -> response-runtime field projection behind a single builder boundary. 5. Extracted deep-turn analysis-attempt stage input wiring into dedicated builder: - `assistantDeepTurnAnalysisAttemptInputBuilder.ts` - introduced: - `buildAssistantDeepTurnAnalysisRuntimeInput(...)` - `buildAssistantDeepTurnContextRuntimeInput(...)` - `buildAssistantDeepTurnExecutionPlanRuntimeInput(...)` - `buildAssistantDeepTurnRetrievalRuntimeInput(...)` - `buildAssistantDeepTurnGuardRuntimeInput(...)` - `buildAssistantDeepTurnGroundingRuntimeInput(...)` - `buildAssistantDeepTurnCompositionRuntimeInput(...)` 6. Rewired `assistantDeepTurnAnalysisAttemptRuntimeAdapter` to build `runAssistantDeepTurnAnalysisRuntime(...)` contract via builder (behavior-preserving). 7. Added focused builder tests: - `assistantDeepTurnAttemptInputBuilder.test.ts` - `assistantDeepTurnResponseRuntimeInputBuilder.test.ts` - `assistantDeepTurnAnalysisAttemptInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantDeepTurnAttemptInputBuilder.test.ts` - `assistantDeepTurnResponseRuntimeInputBuilder.test.ts` - `assistantDeepTurnAnalysisAttemptInputBuilder.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptInputBuilder.test.ts` - `assistantAddressLaneAttemptInputBuilder.test.ts` - `assistantAddressLaneResponseAttemptInputBuilder.test.ts` - `assistantAddressRuntimeInputBuilder.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.61 + 2.62 + 2.63 + 2.64): 1. Added dedicated runtime input builder for address lane response runtime: - `assistantAddressLaneResponseRuntimeInputBuilder.ts` - introduced: - `buildAssistantAddressLaneResponseRuntimeInput(...)` 2. Rewired `assistantAddressLaneResponseAttemptRuntimeAdapter` to consume the new builder (behavior-preserving): - removed inline mapping from attempt input to response runtime input. 3. Added dedicated runtime input builders for living-chat attempt orchestration: - `assistantLivingChatAttemptRuntimeInputBuilder.ts` - introduced: - `buildAssistantLivingChatLlmRuntimeInput(...)` - `buildAssistantLivingChatHandlerRuntimeInput(...)` 4. Rewired `assistantLivingChatAttemptRuntimeAdapter` to consume living-chat runtime input builders (behavior-preserving): - `buildExecuteLlmChat(...)` now delegates llm payload assembly via builder; - top-level living-chat handler invocation now uses builder payload. 5. Added focused builder tests: - `assistantAddressLaneResponseRuntimeInputBuilder.test.ts` - `assistantLivingChatAttemptRuntimeInputBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantAddressLaneResponseRuntimeInputBuilder.test.ts` - `assistantLivingChatAttemptRuntimeInputBuilder.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptInputBuilder.test.ts` - `assistantDeepTurnAnalysisAttemptInputBuilder.test.ts` - `assistantDeepTurnResponseRuntimeInputBuilder.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.65 + 2.66 + 2.67 + 2.68): 1. Added dedicated turn-attempt input builder: - `assistantTurnAttemptInputBuilder.ts` - introduced: - `buildAssistantTurnAttemptAddressRuntimeInput(...)` - `buildAssistantTurnAttemptDeepRuntimeInput(...)` 2. Rewired `assistantTurnAttemptRuntimeAdapter` to consume turn-attempt builder outputs (behavior-preserving): - removed inline payload assembly for `runAddressAttemptRuntime(...)` and `runDeepTurnAttemptRuntime(...)`. 3. Added dedicated query-options builder for address lane attempt: - `assistantAddressLaneAttemptQueryOptionsBuilder.ts` - introduced: - `resolveAssistantAddressLaneAttemptFollowupContext(...)` - `buildAssistantAddressLaneAttemptQueryOptions(...)` 4. Rewired `assistantAddressLaneAttemptRuntimeAdapter` to consume query-options builder (behavior-preserving): - moved followup-context extraction and options branching behind builder helpers. 5. Added focused builder tests: - `assistantTurnAttemptInputBuilder.test.ts` - `assistantAddressLaneAttemptQueryOptionsBuilder.test.ts` Validation: 1. `npm run build` passed. 2. Targeted living/address/deep followup pack passed: - `assistantTurnAttemptInputBuilder.test.ts` - `assistantAddressLaneAttemptQueryOptionsBuilder.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptRuntimeAdapter.test.ts` - `assistantAddressLaneAttemptInputBuilder.test.ts` - `assistantAddressLaneResponseRuntimeInputBuilder.test.ts` - `assistantLivingChatAttemptRuntimeInputBuilder.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantAddressRuntimeAdapter.test.ts` - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantLivingChatRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptInputBuilder.test.ts` - `assistantDeepTurnAnalysisAttemptInputBuilder.test.ts` - `assistantDeepTurnResponseRuntimeInputBuilder.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAnalysisRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantOrganizationScopeRuntimeAdapter.test.ts` - `assistantWave10SettlementCorrectiveRegression.test.ts` - `assistantLivingChatMode.test.ts` Implemented in current pass (Phase 2.69 + 2.70 + 2.71 + 2.72): 1. Finalized strict deps typing in turn runtime input builder: - `assistantTurnRuntimeInputBuilder.ts` - completed generic `AssistantTurnRuntimeBuilderDeps` wiring through address/deep runtime input contracts; - removed residual weak casts from builder field projection. 2. Hardened turn runtime deps adapter contracts: - `assistantTurnRuntimeDepsAdapter.ts` - typed sessions/normalizer/data-layer/address-query/chat/log inputs directly from `AssistantTurnRuntimeBuilderDeps` contract slices; - removed `unknown`/`any` wrappers from adapter mapping while preserving compatible handler signatures for optional args. 3. Preserved behavior of turn orchestration chain under stricter typing: - bootstrap -> address attempt -> deep attempt flow remains unchanged at runtime. Validation: 1. `npm run build` passed. 2. Targeted turn/deps regression pack passed: - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` - `assistantAddressAttemptRuntimeAdapter.test.ts` Implemented in current pass (Phase 2.73 + 2.74 + 2.75 + 2.76): 1. Removed remaining unsafe casts in address->living-chat bridge: - `assistantAddressAttemptRuntimeAdapter.ts` - replaced `mergeKnownOrganizations` dependency type with living-chat compatible contract; - removed `as any` cast for `mergeKnownOrganizations` and removed final object cast to `RunAssistantLivingChatAttemptRuntimeInput`. 2. Added explicit mode-decision normalization before living-chat runtime handoff: - mapped untyped `modeDecision` to typed `{ mode: string | null; reason: string | null }` contract. 3. Preserved behavior of address lane + living-chat fallback under stricter typing: - runtime flow unchanged, only contract hardening. Validation: 1. `npm run build` passed. 2. Targeted address/living/turn regression pack passed: - `assistantAddressAttemptRuntimeAdapter.test.ts` - `assistantLivingChatAttemptRuntimeAdapter.test.ts` - `assistantLivingChatHandlerRuntimeAdapter.test.ts` - `assistantTurnRuntimeInputBuilder.test.ts` - `assistantTurnRuntimeDepsAdapter.test.ts` - `assistantTurnAttemptRuntimeAdapter.test.ts` Implemented in current pass (Phase 2.77 + 2.78 + 2.79 + 2.80): 1. Removed unsafe casts from address lane response runtime finalization path: - `assistantAddressLaneResponseRuntimeAdapter.ts` - introduced explicit normalization for: - `replyType` (fallback-safe); - `carryoverMeta` extraction from followup context; - `llmPreDecomposeMeta` sparse contract mapping; - address debug payload handoff into finalize stage. 2. Hardened deep response runtime bridge to packaging stage: - `assistantDeepTurnResponseRuntimeAdapter.ts` - replaced `as any` payload handoff with typed normalizers for: - execution plan; - runtime analysis context; - business scope resolution; - record/audit buckets; - address-runtime meta. 3. Updated deep response runtime input builder to pass typed composition contract directly: - `assistantDeepTurnResponseRuntimeInputBuilder.ts` - removed composition cast in analysis->response mapping. Validation: 1. `npm run build` passed. 2. Targeted response/address/deep pack passed: - `assistantAddressLaneResponseRuntimeAdapter.test.ts` - `assistantAddressLaneResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnResponseRuntimeInputBuilder.test.ts` - `assistantDeepTurnResponseRuntimeAdapter.test.ts` - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` Status: **In progress (Phase 2.1 + 2.2 + 2.3 + 2.4 + 2.5 + 2.6 + 2.7 + 2.8 + 2.9 + 2.10 + 2.11 + 2.12 + 2.13 + 2.14 + 2.15 + 2.16 + 2.17 + 2.18 + 2.19 + 2.20 + 2.21 + 2.22 + 2.23 + 2.24 + 2.25 + 2.26 + 2.27 + 2.28 + 2.29 + 2.30 + 2.31 + 2.32 + 2.33 + 2.34 + 2.35 + 2.36 + 2.37 + 2.38 + 2.39 + 2.40 + 2.41 + 2.42 + 2.43 + 2.44 + 2.45 + 2.46 + 2.47 + 2.48 + 2.49 + 2.50 + 2.51 + 2.52 + 2.53 + 2.54 + 2.55 + 2.56 + 2.57 + 2.58 + 2.59 + 2.60 + 2.61 + 2.62 + 2.63 + 2.64 + 2.65 + 2.66 + 2.67 + 2.68 + 2.69 + 2.70 + 2.71 + 2.72 + 2.73 + 2.74 + 2.75 + 2.76 + 2.77 + 2.78 + 2.79 + 2.80 completed)** ## Stage 3 (P2): Hybrid Semantic Layer (LLM + Deterministic Guards) Goal: 1. Use LLM for semantic extraction/decomposition in strict schema. 2. Keep deterministic guardrails as verifier, not primary “brain”. 3. Reduce dictionary overfitting and false route drifts. Status: Planned ## Stage 4 (P2): Human-Centric Answer Layer Goal: 1. Move final user response to contract-driven answer package with: - direct answer; - what was checked; - what was found; - what remains unproven; - best next step. 2. Keep claim-to-evidence binding strict. Status: Planned ## Stage 5 (P3): Quality Loop Driven By GUI Markup Goal: 1. Drive backlog from `manual_case_decision` queues. 2. Build targeted regression packs from real failed comments. 3. Track trend by reason-code clusters. Status: Planned ## 6. Non-Negotiable Constraints 1. Do not break MCP route interfaces. 2. Do not remove manual logic without compatible replacement. 3. Preserve UTF-8 (without BOM) for all source/doc files. 4. Keep manual markup and autorun API contract stable.