From 44eccb3d26c05279d0bc599902c7a0374f357198 Mon Sep 17 00:00:00 2001 From: dctouch Date: Sat, 11 Apr 2026 11:21:27 +0300 Subject: [PATCH] =?UTF-8?q?=D0=93=D0=9B=D0=9E=D0=91=D0=90=D0=9B=D0=AC?= =?UTF-8?q?=D0=9D=D0=AB=D0=99=20=D0=A0=D0=95=D0=A4=D0=90=D0=9A=D0=A2=D0=9E?= =?UTF-8?q?=D0=A0=D0=98=D0=9D=D0=93=20=D0=90=D0=A0=D0=A5=D0=98=D0=A2=D0=95?= =?UTF-8?q?=D0=9A=D0=A2=D0=A3=D0=A0=D0=AB=20-=20=D0=A0=D0=B5=D1=84=D0=B0?= =?UTF-8?q?=D0=BA=D1=82=D0=BE=D1=80=D0=B8=D0=BD=D0=B3=20=D1=8D=D1=82=D0=B0?= =?UTF-8?q?=D0=BF=D0=BE=D0=B2=202.97=20-=202.100=20-=20=D0=A3=D0=B6=D0=B5?= =?UTF-8?q?=D1=81=D1=82=D0=BE=D1=87=D0=B8=D0=BB=20=D0=BA=D0=BE=D0=BD=D1=82?= =?UTF-8?q?=D1=80=D0=B0=D0=BA=D1=82=D1=8B=20deep-turn=20response-=D1=86?= =?UTF-8?q?=D0=B5=D0=BF=D0=BE=D1=87=D0=BA=D0=B8:llm=5Fnormalizer/backend/s?= =?UTF-8?q?rc/services/assistantDeepTurnResponseRuntimeAdapter.tsruntimeAn?= =?UTF-8?q?alysisContext=20=D1=82=D0=B5=D0=BF=D0=B5=D1=80=D1=8C=20=D1=81?= =?UTF-8?q?=20=D1=8F=D0=B2=D0=BD=D1=8B=D0=BC=D0=B8=20=D0=BF=D0=BE=D0=BB?= =?UTF-8?q?=D1=8F=D0=BC=D0=B8=20=D0=B8=20=D0=BE=D0=BF=D1=86=D0=B8=D0=BE?= =?UTF-8?q?=D0=BD=D0=B0=D0=BB=D1=8C=D0=BD=D1=8B=D0=BC=20snapshot=5Fmode.ad?= =?UTF-8?q?dressRuntimeMetaForDeep=20=D1=82=D0=B8=D0=BF=D0=B8=D0=B7=D0=B8?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=20=D1=87=D0=B5=D1=80=D0=B5=D0=B7?= =?UTF-8?q?=20=D0=BA=D0=BE=D0=BD=D1=82=D1=80=D0=B0=D0=BA=D1=82=20=D1=83?= =?UTF-8?q?=D0=BF=D0=B0=D0=BA=D0=BE=D0=B2=D0=BA=D0=B8.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/TECH/1CLLMARCH-FACT.md | 20 ++++++++++++++++++- .../assistantDeepTurnAttemptRuntimeAdapter.ts | 2 +- ...ntDeepTurnResponseAttemptRuntimeAdapter.ts | 4 ++-- ...assistantDeepTurnResponseRuntimeAdapter.ts | 16 +++++++++++---- 4 files changed, 34 insertions(+), 8 deletions(-) diff --git a/docs/TECH/1CLLMARCH-FACT.md b/docs/TECH/1CLLMARCH-FACT.md index 04029ce..d3192eb 100644 --- a/docs/TECH/1CLLMARCH-FACT.md +++ b/docs/TECH/1CLLMARCH-FACT.md @@ -2025,7 +2025,25 @@ Validation: - `assistantDeepTurnPackagingRuntimeAdapter.test.ts` - `assistantDeepTurnPackaging.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 + 2.81 + 2.82 + 2.83 + 2.84 + 2.85 + 2.86 + 2.87 + 2.88 + 2.89 + 2.90 + 2.91 + 2.92 + 2.93 + 2.94 + 2.95 + 2.96 completed)** +Implemented in current pass (Phase 2.97 + 2.98 + 2.99 + 2.100): +1. Tightened deep-turn response runtime input contracts for analysis context and address meta: + - `assistantDeepTurnResponseRuntimeAdapter.ts` + - `runtimeAnalysisContext` now typed with explicit fields and optional `snapshot_mode`; + - `addressRuntimeMetaForDeep` now typed via packaging contract. +2. Propagated the tightened types through deep response attempt chain: + - `assistantDeepTurnResponseAttemptRuntimeAdapter.ts` + - `assistantDeepTurnAttemptRuntimeAdapter.ts` +3. Preserved behavior: + - no runtime logic changes; only type alignment for response attempt inputs. + +Validation: +1. `npm run build` passed. +2. Targeted deep response attempt pack passed: + - `assistantDeepTurnResponseAttemptRuntimeAdapter.test.ts` + - `assistantDeepTurnAttemptRuntimeAdapter.test.ts` + - `assistantDeepTurnAttemptInputBuilder.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 + 2.81 + 2.82 + 2.83 + 2.84 + 2.85 + 2.86 + 2.87 + 2.88 + 2.89 + 2.90 + 2.91 + 2.92 + 2.93 + 2.94 + 2.95 + 2.96 + 2.97 + 2.98 + 2.99 + 2.100 completed)** ## Stage 3 (P2): Hybrid Semantic Layer (LLM + Deterministic Guards) diff --git a/llm_normalizer/backend/src/services/assistantDeepTurnAttemptRuntimeAdapter.ts b/llm_normalizer/backend/src/services/assistantDeepTurnAttemptRuntimeAdapter.ts index e6dc3ac..61b498f 100644 --- a/llm_normalizer/backend/src/services/assistantDeepTurnAttemptRuntimeAdapter.ts +++ b/llm_normalizer/backend/src/services/assistantDeepTurnAttemptRuntimeAdapter.ts @@ -27,7 +27,7 @@ export interface RunAssistantDeepTurnAttemptRuntimeInput["addressRuntimeMetaForDeep"]; featureInvestigationStateV1: boolean; featureStateFollowupBindingV1: boolean; featureContractsV11: boolean; diff --git a/llm_normalizer/backend/src/services/assistantDeepTurnResponseAttemptRuntimeAdapter.ts b/llm_normalizer/backend/src/services/assistantDeepTurnResponseAttemptRuntimeAdapter.ts index 5d67097..88ce9a3 100644 --- a/llm_normalizer/backend/src/services/assistantDeepTurnResponseAttemptRuntimeAdapter.ts +++ b/llm_normalizer/backend/src/services/assistantDeepTurnResponseAttemptRuntimeAdapter.ts @@ -27,11 +27,11 @@ export interface RunAssistantDeepTurnResponseAttemptRuntimeInput< }; normalizedQuestion: string; deepTurnAnalysisRuntime: RunAssistantDeepTurnAnalysisRuntimeOutput; - runtimeAnalysisContext: unknown; + runtimeAnalysisContext: RunAssistantDeepTurnResponseRuntimeInput["runtimeAnalysisContext"]; followupStateUsage: AssistantFollowupUsage | null; followupApplied: boolean; previousInvestigationState: InvestigationStateWithProblemUnits | null | undefined; - addressRuntimeMetaForDeep: unknown; + addressRuntimeMetaForDeep: RunAssistantDeepTurnResponseRuntimeInput["addressRuntimeMetaForDeep"]; extractDroppedIntentSegments: RunAssistantDeepTurnResponseRuntimeInput["extractDroppedIntentSegments"]; buildDebugRoutes: RunAssistantDeepTurnResponseRuntimeInput["buildDebugRoutes"]; extractExecutionState: RunAssistantDeepTurnResponseRuntimeInput["extractExecutionState"]; diff --git a/llm_normalizer/backend/src/services/assistantDeepTurnResponseRuntimeAdapter.ts b/llm_normalizer/backend/src/services/assistantDeepTurnResponseRuntimeAdapter.ts index ee793b7..abe911e 100644 --- a/llm_normalizer/backend/src/services/assistantDeepTurnResponseRuntimeAdapter.ts +++ b/llm_normalizer/backend/src/services/assistantDeepTurnResponseRuntimeAdapter.ts @@ -6,6 +6,7 @@ import { type AssistantDeepTurnPackagingRuntimeInput, type AssistantDeepTurnPackagingRuntimeOutput } from "./assistantDeepTurnPackagingRuntimeAdapter"; +import type { RunAssistantDeepTurnAnalysisRuntimeOutput } from "./assistantDeepTurnAnalysisRuntimeAdapter"; import { finalizeAssistantDeepTurn, type FinalizeAssistantDeepTurnInput @@ -35,9 +36,16 @@ export interface RunAssistantDeepTurnResponseRuntimeInput { retrievalResultsRaw: unknown[]; retrievalResults: AssistantDeepTurnPackagingRuntimeInput["retrievalResults"]; questionTypeClass: AssistantDeepTurnPackagingRuntimeInput["questionTypeClass"]; - companyAnchors: unknown; - runtimeAnalysisContext: unknown; - businessScopeResolution: unknown; + companyAnchors: RunAssistantDeepTurnAnalysisRuntimeOutput["companyAnchors"]; + runtimeAnalysisContext: { + active: boolean; + as_of_date: string | null; + period_from: string | null; + period_to: string | null; + source: string | null; + snapshot_mode?: "auto" | "force_snapshot" | "force_live"; + }; + businessScopeResolution: RunAssistantDeepTurnAnalysisRuntimeOutput["businessScopeResolution"]; temporalGuard: unknown; polarityAudit: unknown; claimAnchorAudit: unknown; @@ -50,7 +58,7 @@ export interface RunAssistantDeepTurnResponseRuntimeInput { followupApplied: boolean; composition: AssistantDeepTurnPackagingRuntimeInput["composition"]; previousInvestigationState: AssistantDeepTurnPackagingRuntimeInput["previousInvestigationState"]; - addressRuntimeMetaForDeep: unknown; + addressRuntimeMetaForDeep: AssistantDeepTurnPackagingRuntimeInput["addressRuntimeMetaForDeep"]; extractDroppedIntentSegments: (normalizedPayload: NormalizeResponsePayload["normalized"]) => string[]; buildDebugRoutes: (routeSummary: RouteHintSummary | null) => Array>; extractExecutionState: (normalizedPayload: NormalizeResponsePayload["normalized"]) => unknown[];