@duckcodeailabs/dql-agent 1.9.4 → 1.10.0

package/dist/resolved-analytical-plan.js

@@ -0,0 +1,346 @@
+/**
+ * Immutable, snapshot-bound analytical plan shared by every downstream route.
+ * The router emits it authoritatively by default. Shadow mode remains the
+ * bounded route-level rollback switch while integration verification closes.
+ *
+ * Acceptance: AGT-013, API-006.
+ */
+import { createHash } from 'node:crypto';
+export function buildResolvedAnalyticalPlan(input) {
+    const byLegacyId = new Map(input.candidates.map((candidate) => [candidate.id, candidate]));
+    const selectedCandidates = input.resolution.selectedConceptIds
+        .flatMap((id) => byLegacyId.get(id) ? [byLegacyId.get(id)] : []);
+    const executionCandidate = input.resolution.recommendedExecutionId
+        ? byLegacyId.get(input.resolution.recommendedExecutionId)
+        : selectedCandidates[0];
+    const bindingCandidates = resolutionUsesRelationalEvidence(input.resolution)
+        ? input.candidates
+        : selectedCandidates.length > 0
+            ? selectedCandidates
+            : executionCandidate
+                ? [executionCandidate]
+                : input.candidates;
+    const canonicalId = (candidate) => candidate.qualifiedId ?? candidate.id;
+    const selectedConceptIds = selectedCandidates.map(canonicalId);
+    const executionId = executionCandidate ? canonicalId(executionCandidate) : undefined;
+    const measures = input.resolution.queryIntent.measures.length > 0
+        ? input.resolution.queryIntent.measures.map((requested) => bindRequestedMember(requested, bindingCandidates, 'measure'))
+        : selectedCandidates
+            .filter((candidate) => candidate.kind === 'semantic_metric')
+            .map((candidate) => ({
+            requested: candidate.name,
+            qualifiedId: canonicalId(candidate),
+            status: 'resolved',
+            candidateIds: [canonicalId(candidate)],
+        }));
+    const dimensions = input.resolution.queryIntent.dimensions
+        .map((requested) => bindRequestedMember(requested, bindingCandidates, 'dimension'));
+    const filters = input.resolution.queryIntent.filters.map((filter) => ({
+        ...filter,
+        binding: bindRequestedMember(filter.field, bindingCandidates, 'dimension'),
+    }));
+    const compatibilityProof = selectedCandidates.map((candidate) => ({
+        candidateId: canonicalId(candidate),
+        compatibility: candidate.compatibility,
+        facts: [...(candidate.compatibilityFacts ?? [])].sort(),
+    }));
+    const capability = resolveCapability(input.resolution, executionCandidate, measures, dimensions, filters);
+    const timeBounds = input.resolution.queryIntent.timeRange
+        ? resolvePlanTimeRange(input.resolution.queryIntent.timeRange, input.referenceTime ?? new Date())
+        : undefined;
+    const payload = {
+        schemaVersion: 1,
+        mode: input.mode ?? 'shadow',
+        revision: 0,
+        snapshotId: input.evidence.knowledgeLens?.snapshotId
+            ?? input.evidence.snapshotId
+            ?? input.evidence.sourceFingerprint
+            ?? 'snapshot-unavailable',
+        sourceFingerprint: input.evidence.sourceFingerprint,
+        question: input.question,
+        interpretedQuestion: input.resolution.interpretedQuestion,
+        questionType: input.resolution.questionType,
+        confidence: input.resolution.confidence,
+        selectedConceptIds,
+        executionId,
+        recommendedRoute: input.resolution.recommendedRoute,
+        capability,
+        query: {
+            measures,
+            dimensions,
+            filters,
+            ...(input.resolution.queryIntent.timeRange ? { timeRange: input.resolution.queryIntent.timeRange } : {}),
+            ...(timeBounds ? { timeBounds } : {}),
+            ...(input.resolution.queryIntent.timeGrain ? { timeGrain: input.resolution.queryIntent.timeGrain } : {}),
+            ...(input.resolution.queryIntent.order ? { order: input.resolution.queryIntent.order } : {}),
+            ...(input.resolution.queryIntent.limit !== undefined ? { limit: input.resolution.queryIntent.limit } : {}),
+        },
+        entityGrain: executionCandidate?.primaryEntity,
+        sourceRelationIds: uniqueSorted(selectedCandidates.flatMap((candidate) => candidate.sourceObjects ?? [])),
+        relationshipPathIds: uniqueSorted(selectedCandidates.flatMap((candidate) => candidate.relationshipEvidence ?? [])),
+        compatibilityProof,
+        outputContract: {
+            measures: uniqueSorted(measures.flatMap((binding) => binding.qualifiedId ? [binding.qualifiedId] : [binding.requested])),
+            dimensions: uniqueSorted(dimensions.flatMap((binding) => binding.qualifiedId ? [binding.qualifiedId] : [binding.requested])),
+            ...(input.resolution.queryIntent.timeGrain ? { timeGrain: input.resolution.queryIntent.timeGrain } : {}),
+        },
+        evidenceIds: uniqueSorted(input.candidates.map(canonicalId)),
+        rejectedCandidates: input.resolution.rejectedCandidates.map((candidate) => {
+            const retrieved = byLegacyId.get(candidate.id);
+            return { id: retrieved ? canonicalId(retrieved) : candidate.id, reason: candidate.reason };
+        }),
+        missingInformation: [...input.resolution.missingInformation],
+        clarification: input.resolution.clarifyingQuestion,
+        knowledgeLens: input.evidence.knowledgeLens,
+    };
+    const fingerprint = sha256(stableStringify(payload));
+    return deepFreeze({
+        ...payload,
+        planId: `rap:${fingerprint.slice(0, 24)}`,
+        fingerprint,
+    });
+}
+/**
+ * Apply an explicitly typed follow-up delta. No prose, prior SQL, or answer text
+ * is inspected; every carried member remains a qualified binding from the root.
+ * Acceptance: CTX-003, AGT-013, AGT-016.
+ */
+export function deriveResolvedAnalyticalPlan(parent, delta) {
+    const dimensions = delta.dimensions ? delta.dimensions.map(cloneBinding) : parent.query.dimensions.map(cloneBinding);
+    const measures = delta.measures ? delta.measures.map(cloneBinding) : parent.query.measures.map(cloneBinding);
+    const filters = delta.filters
+        ? delta.filters.map(cloneFilter)
+        : parent.query.filters.map(cloneFilter);
+    if (delta.selectedResultFilter) {
+        filters.push({
+            field: delta.selectedResultFilter.binding.requested,
+            value: delta.selectedResultFilter.value,
+            binding: cloneBinding(delta.selectedResultFilter.binding),
+        });
+    }
+    const timeRange = delta.timeRange !== undefined ? delta.timeRange : parent.query.timeRange;
+    // An inherited relative range is already bound to the root plan's captured
+    // clock. Re-resolving "last month" during a later turn would silently change
+    // the analytical contract, so only an explicit time delta gets a new clock.
+    const timeBounds = delta.timeRange !== undefined
+        ? (timeRange ? resolvePlanTimeRange(timeRange, delta.referenceTime ?? new Date()) : undefined)
+        : parent.query.timeBounds;
+    const unresolved = [...measures, ...dimensions, ...filters.map((filter) => filter.binding)]
+        .filter((binding) => binding.status !== 'resolved');
+    const payload = {
+        ...parent,
+        parentPlanId: parent.planId,
+        rootPlanId: parent.rootPlanId ?? parent.planId,
+        revision: parent.revision + 1,
+        question: delta.question,
+        interpretedQuestion: delta.question,
+        capability: unresolved.length > 0 ? 'blocked' : parent.capability,
+        query: {
+            measures,
+            dimensions,
+            filters,
+            ...(timeRange ? { timeRange } : {}),
+            ...(timeBounds ? { timeBounds } : {}),
+            ...((delta.timeGrain ?? parent.query.timeGrain) ? { timeGrain: delta.timeGrain ?? parent.query.timeGrain } : {}),
+            ...((delta.order ?? parent.query.order) ? { order: delta.order ?? parent.query.order } : {}),
+            ...(delta.limit !== undefined || parent.query.limit !== undefined ? { limit: delta.limit ?? parent.query.limit } : {}),
+        },
+        outputContract: {
+            measures: uniqueSorted(measures.flatMap((binding) => binding.qualifiedId ? [binding.qualifiedId] : [binding.requested])),
+            dimensions: uniqueSorted(dimensions.flatMap((binding) => binding.qualifiedId ? [binding.qualifiedId] : [binding.requested])),
+            ...((delta.timeGrain ?? parent.query.timeGrain) ? { timeGrain: delta.timeGrain ?? parent.query.timeGrain } : {}),
+        },
+        missingInformation: unresolved.length > 0
+            ? uniqueSorted([...parent.missingInformation, ...unresolved.map((binding) => `${binding.requested} is ${binding.status}.`)])
+            : [...parent.missingInformation],
+    };
+    const { planId: _oldPlanId, fingerprint: _oldFingerprint, ...fingerprintPayload } = payload;
+    const fingerprint = sha256(stableStringify(fingerprintPayload));
+    return deepFreeze({
+        ...fingerprintPayload,
+        planId: `rap:${fingerprint.slice(0, 24)}`,
+        fingerprint,
+    });
+}
+function cloneBinding(binding) {
+    return { ...binding, candidateIds: [...binding.candidateIds] };
+}
+function cloneFilter(filter) {
+    return { ...filter, binding: cloneBinding(filter.binding) };
+}
+function bindRequestedMember(requested, candidates, kind) {
+    const normalized = normalize(requested);
+    const directCandidates = candidates.filter((candidate) => {
+        const kindMatches = kind === 'measure'
+            ? candidate.kind === 'semantic_metric' || candidate.kind === 'sql_column'
+            : candidate.kind === 'semantic_member' || candidate.kind === 'sql_column';
+        return kindMatches
+            && candidateTerms(candidate).some((term) => memberTermMatches(term, normalized));
+    });
+    const ids = uniqueSorted([
+        ...directCandidates.map((candidate) => candidate.qualifiedId ?? candidate.id),
+        ...(kind === 'dimension' ? candidates.flatMap((candidate) => (candidate.dimensions ?? []).filter((dimension) => {
+            const value = normalize(dimension);
+            return value === normalized || value.endsWith(` ${normalized}`);
+        }).map((dimension) => qualifyDeclaredDimension(candidate, dimension))) : []),
+    ]);
+    if (ids.length === 0 && kind === 'measure' && candidates.length === 1) {
+        const certified = candidates[0];
+        if (certified.kind === 'certified_block' && certified.compatibility === 'compatible') {
+            const id = certified.qualifiedId ?? certified.id;
+            return {
+                requested,
+                qualifiedId: id,
+                status: 'resolved',
+                candidateIds: [id],
+            };
+        }
+    }
+    const direct = ids.length === 1
+        ? directCandidates.find((candidate) => (candidate.qualifiedId ?? candidate.id) === ids[0])
+        : undefined;
+    return {
+        requested,
+        ...(ids.length === 1 ? { qualifiedId: ids[0] } : {}),
+        ...(direct?.aggregation ? { aggregation: direct.aggregation } : {}),
+        status: ids.length === 1 ? 'resolved' : ids.length > 1 ? 'ambiguous' : 'unresolved',
+        candidateIds: ids,
+    };
+}
+function qualifyDeclaredDimension(candidate, dimension) {
+    if (/[:./]/.test(dimension) || !candidate.domain)
+        return dimension;
+    const domain = candidate.domain.toLowerCase().replace(/[^a-z0-9_-]+/g, '_');
+    const local = dimension.toLowerCase().replace(/[^a-z0-9_-]+/g, '_');
+    return `semantic:${domain}:dimension:${local}`;
+}
+function resolutionUsesRelationalEvidence(resolution) {
+    return resolution.recommendedRoute === 'governed_sql' || resolution.recommendedRoute === 'exploratory';
+}
+function memberTermMatches(candidateTerm, requested) {
+    if (candidateTerm === requested || candidateTerm.endsWith(` ${requested}`))
+        return true;
+    if (!requested)
+        return false;
+    return ` ${candidateTerm} `.includes(` ${requested} `);
+}
+function candidateTerms(candidate) {
+    return [candidate.name, ...(candidate.aliases ?? []), candidate.qualifiedId ?? '', candidate.id]
+        .map(normalize)
+        .filter(Boolean);
+}
+function resolveCapability(resolution, execution, measures, dimensions, filters) {
+    if (resolution.confidence === 'low' || resolution.recommendedRoute === 'clarify' || !execution)
+        return 'blocked';
+    if (((measures.some((binding) => binding.status !== 'resolved') && resolution.queryIntent.measures.length > 0)
+        || (dimensions.some((binding) => binding.status !== 'resolved') && resolution.queryIntent.dimensions.length > 0))
+        && (resolution.recommendedRoute === 'certified' || resolution.recommendedRoute === 'semantic'))
+        return 'blocked';
+    if (filters.some((filter) => filter.binding.status !== 'resolved')
+        && (resolution.recommendedRoute === 'certified' || resolution.recommendedRoute === 'semantic'))
+        return 'blocked';
+    if (execution.compatibility === 'incompatible')
+        return 'blocked';
+    if (resolution.recommendedRoute === 'certified' && execution.kind === 'certified_block' && execution.compatibility === 'compatible') {
+        return 'certified_execution';
+    }
+    if (resolution.recommendedRoute === 'semantic'
+        && (execution.kind === 'semantic_metric' || execution.kind === 'semantic_member')
+        && execution.compatibility === 'compatible')
+        return 'semantic_execution';
+    if (resolution.recommendedRoute === 'governed_sql')
+        return 'governed_relational';
+    if (resolution.recommendedRoute === 'exploratory')
+        return 'bounded_exploration';
+    return 'blocked';
+}
+function normalize(value) {
+    return value.toLowerCase().replace(/[_./:-]+/g, ' ').replace(/[^a-z0-9 ]+/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Resolve common analytical ranges once so no executor reinterprets "last month". */
+export function resolvePlanTimeRange(expression, referenceTime) {
+    const text = expression.trim().toLowerCase();
+    const reference = new Date(Date.UTC(referenceTime.getUTCFullYear(), referenceTime.getUTCMonth(), referenceTime.getUTCDate()));
+    const explicit = /^(\d{4}-\d{2}-\d{2})\s+(?:to|through)\s+(\d{4}-\d{2}-\d{2})$/.exec(text);
+    if (explicit) {
+        const start = new Date(`${explicit[1]}T00:00:00.000Z`);
+        const inclusiveEnd = new Date(`${explicit[2]}T00:00:00.000Z`);
+        if (!Number.isNaN(start.valueOf()) && !Number.isNaN(inclusiveEnd.valueOf()) && start <= inclusiveEnd) {
+            inclusiveEnd.setUTCDate(inclusiveEnd.getUTCDate() + 1);
+            return temporalBounds(expression, start, inclusiveEnd);
+        }
+    }
+    const match = /^(?:the\s+)?(last|this)\s+(?:(\d+)\s+)?(day|week|month|quarter|year)s?$/.exec(text);
+    if (!match)
+        return undefined;
+    const mode = match[1];
+    const count = Math.max(1, Number(match[2] ?? 1));
+    const unit = match[3];
+    if (mode === 'this') {
+        const start = startOfUnit(reference, unit);
+        return temporalBounds(expression, start, addUnits(start, unit, count));
+    }
+    if (match[2])
+        return temporalBounds(expression, addUnits(reference, unit, -count), reference);
+    const end = startOfUnit(reference, unit);
+    return temporalBounds(expression, addUnits(end, unit, -1), end);
+}
+function temporalBounds(expression, start, end) {
+    return {
+        expression,
+        startInclusive: start.toISOString(),
+        endExclusive: end.toISOString(),
+        timeZone: 'UTC',
+    };
+}
+function startOfUnit(value, unit) {
+    const out = new Date(value);
+    if (unit === 'year')
+        out.setUTCMonth(0, 1);
+    else if (unit === 'quarter')
+        out.setUTCMonth(Math.floor(out.getUTCMonth() / 3) * 3, 1);
+    else if (unit === 'month')
+        out.setUTCDate(1);
+    else if (unit === 'week')
+        out.setUTCDate(out.getUTCDate() - ((out.getUTCDay() + 6) % 7));
+    return out;
+}
+function addUnits(value, unit, count) {
+    const out = new Date(value);
+    if (unit === 'year')
+        out.setUTCFullYear(out.getUTCFullYear() + count);
+    else if (unit === 'quarter')
+        out.setUTCMonth(out.getUTCMonth() + count * 3);
+    else if (unit === 'month')
+        out.setUTCMonth(out.getUTCMonth() + count);
+    else if (unit === 'week')
+        out.setUTCDate(out.getUTCDate() + count * 7);
+    else
+        out.setUTCDate(out.getUTCDate() + count);
+    return out;
+}
+function uniqueSorted(values) {
+    return [...new Set(values.filter(Boolean))].sort();
+}
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function stableStringify(value) {
+    if (value === undefined || value === null)
+        return 'null';
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(',')}}`;
+}
+function deepFreeze(value) {
+    if (!value || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const nested of Object.values(value))
+        deepFreeze(nested);
+    return value;
+}
+//# sourceMappingURL=resolved-analytical-plan.js.map

package/dist/resolved-analytical-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-analytical-plan.js","sourceRoot":"","sources":["../src/resolved-analytical-plan.ts"],"names":[],"mappings":"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"}

package/dist/router.d.ts

@@ -17,6 +17,7 @@
 import type { AgentRunRequest, AgentRouter } from "./agent-run-engine.js";
 import type { MetadataAgentIntent } from "./metadata/catalog.js";
 import { type AgentMeaningResolver, type AgentRetrievalEvidence, type MeaningResolution } from "./meaning-resolution.js";
+import { type ResolvedAnalyticalPlan } from './resolved-analytical-plan.js';
 /** The router's fine-grained classification of a turn. */
 export interface RouterClassification {
     category: "conversational" | "capability" | "general_knowledge" | "data_lookup" | "data_analysis" | "authoring" | "app" | "unclear";
@@ -45,6 +46,8 @@ export interface HybridRouterOptions {
     resolveMeaning?: AgentMeaningResolver;
     /** Maximum candidate cards sent to meaning resolution. Default 12. */
     maxMeaningCandidates?: number;
+    /** Authoritative by default; `shadow` is the bounded rollback switch. */
+    resolvedPlanMode?: ResolvedAnalyticalPlan['mode'];
     /** Deterministic confidence at/above which the LLM is never called. Default 0.7. */
     llmThreshold?: number;
     /** Max cached classifications. Default 200. */

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EACJ,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,WAAW,GACX,KAAK,GACL,SAAS,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtB,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IAC7H,iFAAiF;IACjF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAWD;;;;GAIG;AACH,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,mBAAmB,GAAG,SAAS,CAWtG;AAkOD,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CA4D1E;AAwND;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,WAAW,CAmLjF;AAED,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA+B,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEzG,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EACJ,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,eAAe,GACf,WAAW,GACX,KAAK,GACL,SAAS,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtB,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IAC7H,iFAAiF;IACjF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAWD;;;;GAIG;AACH,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,mBAAmB,GAAG,SAAS,CAWtG;AAkOD,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CA4D1E;AA0OD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,WAAW,CAyMjF;AAED,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/router.js

@@ -16,6 +16,7 @@
  */
 import { classifyConversationalTurn, decideAgentAction, } from "./intent-controller.js";
 import { buildMeaningEvidencePackage, defaultQueryIntent, findExplicitEvidenceReference, questionTypeFromText, routeForEvidenceCandidate, validateMeaningResolution, } from "./meaning-resolution.js";
+import { buildResolvedAnalyticalPlan } from './resolved-analytical-plan.js';
 const DEFAULT_THRESHOLD = 0.7;
 const DEFAULT_CACHE_SIZE = 200;
 const DEFAULT_CACHE_TTL_MS = 10 * 60 * 1000;
@@ -349,12 +350,19 @@ function retrievalTrace(evidence, candidates) {
         candidateIds: candidates.map((candidate) => candidate.id),
     };
 }
-function routeDecisionForResolution(base, evidence, candidates, resolution, source) {
+function routeDecisionForResolution(base, evidence, candidates, resolution, source, question = resolution.interpretedQuestion, mode = 'authoritative') {
     const needsClarification = resolution.confidence === "low" || resolution.recommendedRoute === "clarify";
     const analytical = resolution.questionType === "diagnosis" || resolution.questionType === "research";
     const reason = needsClarification
         ? `The retrieved evidence supports multiple business meanings: ${resolution.interpretedQuestion}`
         : `Resolved the question against ${resolution.selectedConceptIds.join(", ")}: ${resolution.interpretedQuestion}`;
+    const resolvedAnalyticalPlan = buildResolvedAnalyticalPlan({
+        question,
+        resolution,
+        evidence,
+        candidates,
+        mode,
+    });
     return {
         ...base,
         action: needsClarification ? "clarify" : analytical ? "investigate" : "answer",
@@ -364,6 +372,7 @@ function routeDecisionForResolution(base, evidence, candidates, resolution, sour
         category: analytical ? "data_analysis" : needsClarification ? "unclear" : "data_lookup",
         depth: analytical ? "deep" : "quick",
         meaningResolution: resolution,
+        resolvedAnalyticalPlan,
         retrievalEvidence: retrievalTrace(evidence, candidates),
         requiresClarification: needsClarification,
         ...(needsClarification ? { clarificationOptions: buildClarificationOptions(candidates) } : {}),
@@ -414,10 +423,10 @@ function directResolution(request, evidence, candidate) {
         recommendedRoute: routeForEvidenceCandidate(candidate),
     };
 }
-function routeWithoutMeaningModel(request, base, evidence, candidates) {
+function routeWithoutMeaningModel(request, base, evidence, candidates, planMode = 'authoritative') {
     const exactCompatible = candidates.filter((candidate) => candidate.exactMatch && candidate.compatibility !== "incompatible");
     if (exactCompatible.length === 1 && !hasMateriallyRelatedCompetitor(exactCompatible[0], candidates)) {
-        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, exactCompatible[0]), "heuristic");
+        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, exactCompatible[0]), "heuristic", request.question, planMode);
     }
     if (base.action === "investigate") {
         return {
@@ -461,6 +470,13 @@ function dominantCompatibleGovernedCandidate(candidates) {
         return undefined;
     if (best.relevanceScore < 0.82)
         return undefined;
+    // Deterministic fit proves executability, not business meaning. Preserve the
+    // one bounded meaning call whenever a plausible semantic interpretation is
+    // present, even if the certified block won lexical ranking.
+    if (candidates.some((candidate) => (candidate.kind === 'semantic_metric' || candidate.kind === 'semantic_member')
+        && candidate.compatibility !== 'incompatible'
+        && candidate.relevanceScore >= 0.45))
+        return undefined;
     const competitorFloor = Math.max(0.7, best.relevanceScore - 0.12);
     const hasExecutableCompetitor = compatible.some((candidate) => candidate.id !== best.id && candidate.relevanceScore >= competitorFloor);
     return hasExecutableCompetitor ? undefined : best;
@@ -562,18 +578,18 @@ export function createHybridRouter(options = {}) {
                 if (candidates.length > 0) {
                     const explicit = selectedEvidence ?? findExplicitEvidenceReference(request.question, candidates);
                     if (explicit && explicit.compatibility !== "incompatible") {
-                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, explicit), "heuristic");
+                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, explicit), "heuristic", request.question, options.resolvedPlanMode ?? 'authoritative');
                     }
                     const exactCompatible = candidates.filter((candidate) => candidate.exactMatch && candidate.compatibility !== "incompatible");
                     if (exactCompatible.length === 1 && !hasMateriallyRelatedCompetitor(exactCompatible[0], candidates)) {
-                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, exactCompatible[0]), "heuristic");
+                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, exactCompatible[0]), "heuristic", request.question, options.resolvedPlanMode ?? 'authoritative');
                     }
                     const dominant = dominantCompatibleGovernedCandidate(candidates);
                     if (dominant) {
-                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, dominant), "heuristic");
+                        return routeDecisionForResolution(base, evidence, candidates, directResolution(request, evidence, dominant), "heuristic", request.question, options.resolvedPlanMode ?? 'authoritative');
                     }
                     if (shouldDeferCompositionalFollowUpToExecutor(base, candidates)) {
-                        return routeWithoutMeaningModel(request, base, evidence, candidates);
+                        return routeWithoutMeaningModel(request, base, evidence, candidates, options.resolvedPlanMode ?? 'authoritative');
                     }
                     const key = cacheKey(request, evidence);
                     const cached = cache.get(key);
@@ -593,7 +609,7 @@ export function createHybridRouter(options = {}) {
                         if (resolution) {
                             const validated = validateMeaningResolution(resolution, candidates);
                             if (validated.ok) {
-                                return remember(key, routeDecisionForResolution(base, evidence, candidates, validated.resolution, "llm"));
+                                return remember(key, routeDecisionForResolution(base, evidence, candidates, validated.resolution, "llm", request.question, options.resolvedPlanMode ?? 'authoritative'));
                             }
                             const invalidResolution = {
                                 interpretedQuestion: request.question,
@@ -606,7 +622,15 @@ export function createHybridRouter(options = {}) {
                                 recommendedRoute: "clarify",
                                 clarifyingQuestion: buildEvidenceClarification(candidates, [validated.reason]),
                             };
-                            return remember(key, routeDecisionForResolution(base, evidence, candidates, invalidResolution, "llm"));
+                            const invalidDecision = routeDecisionForResolution(base, evidence, candidates, invalidResolution, "llm", request.question, options.resolvedPlanMode ?? 'authoritative');
+                            return remember(key, {
+                                ...invalidDecision,
+                                action: 'answer',
+                                requiresClarification: false,
+                                clarificationOptions: undefined,
+                                clarifyingQuestion: undefined,
+                                meaningResolutionErrorCode: 'invalid_evidence_reference',
+                            });
                         }
                     }
                     catch (error) {
@@ -614,7 +638,7 @@ export function createHybridRouter(options = {}) {
                         // A resolver transport/parse failure falls back without losing the
                         // retrieval signal or permitting a general-knowledge misroute.
                     }
-                    return routeWithoutMeaningModel(request, base, evidence, candidates);
+                    return routeWithoutMeaningModel(request, base, evidence, candidates, options.resolvedPlanMode ?? 'authoritative');
                 }
             }
             // Legacy/no-evidence path. A confident analytical heuristic stays offline;