@duckcodeailabs/dql-agent 1.9.5 → 1.10.1

package/dist/plan-execution-adapter.js

@@ -0,0 +1,447 @@
+/**
+ * The single identity adapter between a ResolvedAnalyticalPlan and execution.
+ * It does no question search and no fuzzy rematching: every executable member
+ * must resolve by an identity captured in the immutable registry snapshot.
+ *
+ * Acceptance: AGT-013, AGT-014, API-006.
+ */
+export function buildPlanExecutionRegistry(input) {
+    const byNodeId = new Map(input.nodes.map((node) => [node.nodeId, node]));
+    const identitiesByNode = new Map();
+    for (const node of input.nodes) {
+        identitiesByNode.set(node.nodeId, new Set(nodeIdentities(node)));
+    }
+    for (const object of input.objects ?? []) {
+        const nodeId = nodeIdForMetadataObject(object);
+        if (!nodeId || !byNodeId.has(nodeId))
+            continue;
+        const identities = identitiesByNode.get(nodeId) ?? new Set();
+        for (const identity of metadataObjectIdentities(object))
+            identities.add(identity);
+        identitiesByNode.set(nodeId, identities);
+    }
+    return input.nodes.map((node) => ({
+        node,
+        identities: [...(identitiesByNode.get(node.nodeId) ?? [])].filter(Boolean).sort(),
+    }));
+}
+export function adaptResolvedAnalyticalPlan(input) {
+    const { plan } = input;
+    const block = (code, reason, candidateIds) => ({
+        schemaVersion: 1,
+        status: 'blocked',
+        kind: 'blocked',
+        planId: plan.planId,
+        fingerprint: plan.fingerprint,
+        code,
+        reason,
+        ...(candidateIds?.length ? { candidateIds: [...candidateIds].sort() } : {}),
+    });
+    if (input.expectedSnapshotId && plan.snapshotId !== input.expectedSnapshotId) {
+        return block('SNAPSHOT_MISMATCH', `Plan snapshot ${plan.snapshotId} does not match active snapshot ${input.expectedSnapshotId}.`);
+    }
+    if (plan.capability === 'blocked') {
+        return block('PLAN_BLOCKED', plan.missingInformation.join(' ') || 'The resolved plan is not executable.');
+    }
+    if (plan.capability === 'governed_relational' || plan.capability === 'bounded_exploration') {
+        return {
+            schemaVersion: 1,
+            status: 'delegated',
+            kind: plan.capability,
+            planId: plan.planId,
+            fingerprint: plan.fingerprint,
+        };
+    }
+    if (!plan.executionId)
+        return block('EXECUTION_ID_MISSING', 'The resolved plan has no qualified execution ID.');
+    const execution = resolveRegistryIdentity(plan.executionId, input.registry);
+    if (execution.length === 0) {
+        return block('EXECUTION_ID_MISSING', `Qualified execution ID ${plan.executionId} is not present in the pinned registry.`);
+    }
+    if (execution.length > 1) {
+        return block('EXECUTION_ID_AMBIGUOUS', `Qualified execution ID ${plan.executionId} resolves to more than one registry object.`, execution.map((entry) => entry.node.nodeId));
+    }
+    const entry = execution[0];
+    if (plan.capability === 'certified_execution') {
+        if (entry.node.kind !== 'block') {
+            return block('EXECUTION_KIND_MISMATCH', `${plan.executionId} is ${entry.node.kind}, not a certified block.`);
+        }
+        if (entry.node.status !== 'certified') {
+            return block('CERTIFICATION_REQUIRED', `${plan.executionId} is not certified in the pinned snapshot.`);
+        }
+        return {
+            schemaVersion: 1,
+            status: 'ready',
+            kind: 'certified',
+            planId: plan.planId,
+            fingerprint: plan.fingerprint,
+            node: entry.node,
+        };
+    }
+    if (entry.node.kind !== 'metric') {
+        return block('EXECUTION_KIND_MISMATCH', `${plan.executionId} is ${entry.node.kind}, not a semantic metric.`);
+    }
+    if (!input.semanticLayer)
+        return block('SEMANTIC_LAYER_REQUIRED', 'The pinned semantic layer is unavailable.');
+    const metricNames = semanticMetricNames(entry.node, input.semanticLayer);
+    if (metricNames.length === 0)
+        return block('SEMANTIC_MEMBER_MISSING', `${plan.executionId} is not present in the pinned semantic layer.`);
+    if (metricNames.length > 1)
+        return block('SEMANTIC_MEMBER_AMBIGUOUS', `${plan.executionId} maps to multiple semantic metrics.`, metricNames);
+    const dimensions = [];
+    let timeDimension;
+    let timeFilterDimensionName;
+    for (const binding of plan.query.dimensions) {
+        const resolved = resolveSemanticDimension(binding, input.registry, input.semanticLayer);
+        if ('code' in resolved)
+            return block(resolved.code, resolved.reason, resolved.candidateIds);
+        if (isTimeDimension(resolved.definition)) {
+            timeFilterDimensionName = resolved.name;
+            if (timeDimension && timeDimension.name !== resolved.name) {
+                return block('SEMANTIC_MEMBER_AMBIGUOUS', 'The plan selects more than one time dimension.', [timeDimension.name, resolved.name]);
+            }
+            if (plan.query.timeGrain)
+                timeDimension = { name: resolved.name, granularity: plan.query.timeGrain };
+            else
+                dimensions.push(resolved.name);
+        }
+        else {
+            dimensions.push(resolved.name);
+        }
+    }
+    const filters = [];
+    for (const filter of plan.query.filters) {
+        const resolved = resolveSemanticDimension(filter.binding, input.registry, input.semanticLayer);
+        if ('code' in resolved)
+            return block(resolved.code, resolved.reason, resolved.candidateIds);
+        filters.push({ dimension: resolved.name, operator: 'equals', values: [filter.value] });
+    }
+    if ((plan.query.timeGrain || plan.query.timeBounds) && !timeFilterDimensionName) {
+        const metric = input.semanticLayer.listMetrics().find((candidate) => candidate.name === metricNames[0]);
+        const defaultName = metric?.aggTimeDimension;
+        const defaultDimension = defaultName ? input.semanticLayer.getTimeDimension(defaultName) : undefined;
+        if (!defaultDimension) {
+            return block('TIME_DIMENSION_REQUIRED', `Metric ${metricNames[0]} has no unambiguous default time dimension for the requested time scope.`);
+        }
+        timeFilterDimensionName = defaultDimension.name;
+        if (plan.query.timeGrain)
+            timeDimension = { name: defaultDimension.name, granularity: plan.query.timeGrain };
+    }
+    if (plan.query.timeBounds && timeFilterDimensionName) {
+        filters.push({ dimension: timeFilterDimensionName, operator: 'gte', values: [plan.query.timeBounds.startInclusive] }, { dimension: timeFilterDimensionName, operator: 'lt', values: [plan.query.timeBounds.endExclusive] });
+    }
+    else if (plan.query.timeRange) {
+        return block('TIME_RANGE_UNBOUND', `Time range "${plan.query.timeRange}" must be resolved to typed bounds before execution.`);
+    }
+    const selection = {
+        metrics: metricNames,
+        dimensions,
+        ...(timeDimension ? { timeDimension } : {}),
+        ...(filters.length ? { filters } : {}),
+        ...(plan.query.order ? { orderBy: [{ name: metricNames[0], direction: plan.query.order }] } : {}),
+        ...(plan.query.limit !== undefined ? { limit: plan.query.limit } : {}),
+    };
+    return {
+        schemaVersion: 1,
+        status: 'ready',
+        kind: 'semantic',
+        planId: plan.planId,
+        fingerprint: plan.fingerprint,
+        metricNode: entry.node,
+        selection,
+    };
+}
+/**
+ * Bind a freshness observation to the same exact semantic identities as the
+ * selected plan. This is intentionally not a search API: the request, plan,
+ * registry, and semantic layer must all agree before the host receives adapter
+ * member names. Acceptance: AGT-019, SEC-004.
+ */
+export function adaptAnalyticalFreshnessRequest(input) {
+    const block = (code, reason, candidateIds) => ({
+        schemaVersion: 1,
+        status: 'blocked',
+        kind: 'semantic_freshness',
+        code,
+        reason,
+        ...(candidateIds?.length ? { candidateIds: [...candidateIds].sort() } : {}),
+    });
+    const frame = input.plan.analyticalFrame;
+    const time = frame?.timeContext;
+    if (input.plan.schemaVersion !== 2 || input.plan.capability !== 'semantic_execution' || !frame || !time) {
+        return block('PLAN_BLOCKED', 'The selected plan does not define a semantic analytical freshness route.');
+    }
+    if (input.request.snapshotId !== input.plan.snapshotId
+        || (input.expectedSnapshotId && input.request.snapshotId !== input.expectedSnapshotId)) {
+        return block('SNAPSHOT_MISMATCH', 'The freshness request does not match the pinned analytical snapshot.');
+    }
+    if (input.request.metricId !== frame.metricConceptIds[0]) {
+        return block('EXECUTION_ID_MISSING', 'The freshness metric does not match the immutable analytical frame.');
+    }
+    if (!time.timeDimensionId || input.request.timeDimensionId !== time.timeDimensionId) {
+        return block('TIME_DIMENSION_REQUIRED', 'The freshness time dimension does not match the immutable analytical frame.');
+    }
+    if (!input.plan.executionId) {
+        return block('EXECUTION_ID_MISSING', 'The semantic plan has no qualified execution identity.');
+    }
+    const executions = resolveRegistryIdentity(input.plan.executionId, input.registry);
+    if (executions.length !== 1) {
+        return block(executions.length > 1 ? 'EXECUTION_ID_AMBIGUOUS' : 'EXECUTION_ID_MISSING', `Qualified execution ID ${input.plan.executionId} resolves to ${executions.length} pinned registry objects.`, executions.map((entry) => entry.node.nodeId));
+    }
+    const metricNode = executions[0].node;
+    if (metricNode.kind !== 'metric') {
+        return block('EXECUTION_KIND_MISMATCH', `${input.plan.executionId} is ${metricNode.kind}, not a semantic metric.`);
+    }
+    const metricNames = semanticMetricNames(metricNode, input.semanticLayer);
+    if (metricNames.length !== 1) {
+        return block(metricNames.length > 1 ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING', `${input.plan.executionId} maps to ${metricNames.length} semantic metrics.`, metricNames);
+    }
+    const resolvedTime = resolveSemanticDimensionId(time.timeDimensionId, input.registry, input.semanticLayer);
+    if ('code' in resolvedTime)
+        return block(resolvedTime.code, resolvedTime.reason, resolvedTime.candidateIds);
+    const resolvedTimeDefinition = resolvedTime.definition;
+    if (!resolvedTimeDefinition || !isTimeDimension(resolvedTimeDefinition)) {
+        return block('TIME_DIMENSION_REQUIRED', `${time.timeDimensionId} is not a semantic time dimension.`);
+    }
+    const timeDefinitions = input.semanticLayer.listTimeDimensions().filter((candidate) => candidate.name === resolvedTimeDefinition.name
+        && candidate.table === resolvedTimeDefinition.table);
+    if (timeDefinitions.length !== 1) {
+        return block(timeDefinitions.length > 1 ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING', `${time.timeDimensionId} maps to ${timeDefinitions.length} semantic time definitions.`, timeDefinitions.map((candidate) => `${candidate.cube ?? candidate.table}.${candidate.name}`));
+    }
+    const timeDefinition = timeDefinitions[0];
+    const availableGrains = timeDefinition.granularities;
+    const requestedGrain = availableGrains.find((candidate) => candidate === time.grain);
+    const granularity = availableGrains.includes('day')
+        ? 'day'
+        : requestedGrain ?? availableGrains[0] ?? 'day';
+    const outputField = `${timeDefinition.name}_${granularity}`;
+    return {
+        schemaVersion: 1,
+        status: 'ready',
+        kind: 'semantic_freshness',
+        request: {
+            route: 'semantic',
+            metric: metricNames[0],
+            timeDimension: resolvedTime.name,
+            granularity,
+            outputField,
+        },
+    };
+}
+/**
+ * Convert semantic source nodes into exact adapter selections. Every metric,
+ * dimension, filter, and period comes from the frozen graph/plan; this adapter
+ * performs identity lookup only and never searches or rematches question text.
+ *
+ * Acceptance: AGT-014, AGT-018, AGT-019.
+ */
+export function adaptAnalyticalSemanticGraph(input) {
+    const { graph, plan } = input;
+    const block = (code, reason, candidateIds) => ({
+        schemaVersion: 1,
+        status: 'blocked',
+        kind: 'semantic_graph',
+        graphId: graph.graphId,
+        graphFingerprint: graph.fingerprint,
+        planId: plan.planId,
+        planFingerprint: plan.fingerprint,
+        code,
+        reason,
+        ...(candidateIds?.length ? { candidateIds: [...candidateIds].sort() } : {}),
+    });
+    if (graph.planId !== plan.planId ||
+        graph.planFingerprint !== plan.fingerprint ||
+        graph.snapshotId !== plan.snapshotId) {
+        return block('EXECUTION_GRAPH_MISMATCH', 'The executable graph does not bind the supplied immutable plan.');
+    }
+    if (input.expectedSnapshotId && graph.snapshotId !== input.expectedSnapshotId) {
+        return block('SNAPSHOT_MISMATCH', `Graph snapshot ${graph.snapshotId} does not match active snapshot ${input.expectedSnapshotId}.`);
+    }
+    if (graph.route !== 'semantic') {
+        return block('EXECUTION_GRAPH_ROUTE_MISMATCH', `Graph route ${graph.route} is not semantic.`);
+    }
+    if (!plan.executionId)
+        return block('EXECUTION_ID_MISSING', 'The resolved plan has no qualified semantic execution ID.');
+    const execution = resolveRegistryIdentity(plan.executionId, input.registry);
+    if (execution.length !== 1) {
+        return block(execution.length > 1 ? 'EXECUTION_ID_AMBIGUOUS' : 'EXECUTION_ID_MISSING', `Qualified execution ID ${plan.executionId} resolves to ${execution.length} pinned registry objects.`, execution.map((entry) => entry.node.nodeId));
+    }
+    const metricNode = execution[0].node;
+    if (metricNode.kind !== 'metric') {
+        return block('EXECUTION_KIND_MISMATCH', `${plan.executionId} is ${metricNode.kind}, not a semantic metric.`);
+    }
+    const metricNames = semanticMetricNames(metricNode, input.semanticLayer);
+    if (metricNames.length !== 1) {
+        return block(metricNames.length > 1 ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING', `${plan.executionId} maps to ${metricNames.length} semantic metrics.`, metricNames);
+    }
+    const invocations = [];
+    for (const source of graph.nodes.filter((node) => node.kind === 'source_invocation')) {
+        if (source.strategy !== 'period_aggregate') {
+            return block('EXECUTION_GRAPH_ROUTE_MISMATCH', 'A semantic graph cannot invoke a complete certified asset.');
+        }
+        const dimensions = [];
+        let timeDimension;
+        for (const dimensionId of source.groupByDimensionIds) {
+            const resolved = resolveSemanticDimensionId(dimensionId, input.registry, input.semanticLayer);
+            if ('code' in resolved)
+                return block(resolved.code, resolved.reason, resolved.candidateIds);
+            if (source.period?.timeDimensionId === dimensionId) {
+                timeDimension = { name: resolved.name, granularity: source.period.grain };
+            }
+            else {
+                dimensions.push(resolved.name);
+            }
+        }
+        const filters = [];
+        for (const member of source.memberFilters) {
+            const resolved = resolveSemanticDimensionId(member.dimensionId, input.registry, input.semanticLayer);
+            if ('code' in resolved)
+                return block(resolved.code, resolved.reason, resolved.candidateIds);
+            const values = member.canonicalValues.flatMap((value) => scalarFilterValue(value));
+            if (values.length !== member.canonicalValues.length) {
+                return block('SEMANTIC_MEMBER_MISSING', `Filter ${member.dimensionId} contains a non-scalar canonical value.`);
+            }
+            filters.push({ dimension: resolved.name, operator: 'equals', values });
+        }
+        if (source.period) {
+            const resolvedTime = resolveSemanticDimensionId(source.period.timeDimensionId, input.registry, input.semanticLayer);
+            if ('code' in resolvedTime)
+                return block(resolvedTime.code, resolvedTime.reason, resolvedTime.candidateIds);
+            filters.push({
+                dimension: resolvedTime.name,
+                operator: 'gte',
+                values: [source.period.startInclusive],
+            }, {
+                dimension: resolvedTime.name,
+                operator: 'lt',
+                values: [source.period.endExclusive],
+            });
+        }
+        invocations.push({
+            nodeId: source.id,
+            ...(source.adapterId ? { adapterId: source.adapterId } : {}),
+            selection: {
+                metrics: metricNames,
+                dimensions,
+                ...(timeDimension ? { timeDimension } : {}),
+                ...(filters.length ? { filters } : {}),
+            },
+            outputAliases: structuredClone(source.outputAliases),
+            ...(source.period ? { period: structuredClone(source.period) } : {}),
+        });
+    }
+    return {
+        schemaVersion: 1,
+        status: 'ready',
+        kind: 'semantic_graph',
+        graphId: graph.graphId,
+        graphFingerprint: graph.fingerprint,
+        planId: plan.planId,
+        planFingerprint: plan.fingerprint,
+        metricNode,
+        invocations,
+    };
+}
+function resolveRegistryIdentity(identity, registry) {
+    return registry.filter((entry) => entry.identities.includes(identity));
+}
+function resolveSemanticDimension(binding, registry, layer) {
+    if (binding.status !== 'resolved' || !binding.qualifiedId) {
+        return {
+            code: binding.status === 'ambiguous' ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING',
+            reason: `Dimension ${binding.requested} is ${binding.status} in the resolved plan.`,
+            candidateIds: binding.candidateIds,
+        };
+    }
+    const matches = resolveRegistryIdentity(binding.qualifiedId, registry).filter((entry) => entry.node.kind === 'dimension');
+    if (matches.length !== 1) {
+        return {
+            code: matches.length > 1 ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING',
+            reason: `Qualified dimension ${binding.qualifiedId} resolves to ${matches.length} pinned registry objects.`,
+            candidateIds: matches.map((entry) => entry.node.nodeId),
+        };
+    }
+    const node = matches[0].node;
+    const localId = stringValue(node.payload?.localId) ?? node.name;
+    const candidates = uniqueDefinitions([
+        layer.resolveGroupBy(node.name),
+        layer.resolveGroupBy(localId),
+        ...stringArray(node.payload?.aliases).map((alias) => layer.resolveGroupBy(alias)),
+    ]);
+    if (candidates.length !== 1) {
+        return {
+            code: candidates.length > 1 ? 'SEMANTIC_MEMBER_AMBIGUOUS' : 'SEMANTIC_MEMBER_MISSING',
+            reason: `Qualified dimension ${binding.qualifiedId} maps to ${candidates.length} semantic definitions.`,
+            candidateIds: candidates.map((candidate) => `${candidate.cube ?? candidate.table}.${candidate.name}`),
+        };
+    }
+    return { name: candidates[0].qualifiedName ?? candidates[0].name, definition: candidates[0] };
+}
+function resolveSemanticDimensionId(dimensionId, registry, layer) {
+    return resolveSemanticDimension({
+        requested: dimensionId,
+        qualifiedId: dimensionId,
+        status: 'resolved',
+        candidateIds: [dimensionId],
+    }, registry, layer);
+}
+function semanticMetricNames(node, layer) {
+    const localId = stringValue(node.payload?.localId) ?? node.name;
+    const exactIdentities = new Set([node.name, localId, ...stringArray(node.payload?.aliases)]);
+    return [...new Set(layer.listMetrics().filter((metric) => exactIdentities.has(metric.name)
+            || exactIdentities.has(`${metric.cube ?? ''}.${metric.name}`)
+            || (metric.source?.objectId ? exactIdentities.has(metric.source.objectId) : false)).map((metric) => metric.name))].sort();
+}
+function nodeIdentities(node) {
+    return [
+        node.nodeId,
+        stringValue(node.payload?.qualifiedId),
+        stringValue(node.payload?.sourceNativeId),
+        ...stringArray(node.payload?.aliases),
+    ].filter((value) => Boolean(value));
+}
+function metadataObjectIdentities(object) {
+    return [
+        object.objectKey,
+        object.fullName,
+        stringValue(object.payload?.qualifiedId),
+        stringValue(object.payload?.sourceNativeId),
+        ...stringArray(object.payload?.aliases),
+    ].filter((value) => Boolean(value));
+}
+function nodeIdForMetadataObject(object) {
+    if (object.objectType === 'dql_block')
+        return `block:${object.name}`;
+    if (object.objectType === 'semantic_metric')
+        return `metric:${object.name}`;
+    if (object.objectType === 'semantic_dimension' || object.objectType === 'semantic_time_dimension')
+        return `dimension:${object.name}`;
+    return undefined;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string' && Boolean(item.trim())) : [];
+}
+function scalarFilterValue(value) {
+    if (typeof value === 'string')
+        return [value];
+    if (typeof value === 'number' && Number.isFinite(value))
+        return [String(value)];
+    if (typeof value === 'boolean' || typeof value === 'bigint')
+        return [String(value)];
+    return [];
+}
+function uniqueDefinitions(values) {
+    const byId = new Map();
+    for (const value of values) {
+        if (value)
+            byId.set(`${value.cube ?? ''}:${value.table ?? ''}:${value.name}`, value);
+    }
+    return [...byId.values()];
+}
+function isTimeDimension(value) {
+    return Boolean(value && (value.isTimeDimension || value.source?.objectType === 'time_dimension'));
+}
+//# sourceMappingURL=plan-execution-adapter.js.map

package/dist/plan-execution-adapter.js.map

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

package/dist/research-governance.d.ts

@@ -0,0 +1,56 @@
+/** Bounded, receipt-backed research built from typed deltas over one root plan. */
+import { type ResolvedAnalyticalPlan, type ResolvedAnalyticalPlanDelta } from './resolved-analytical-plan.js';
+import { type ResearchBudget } from './research-loop.js';
+export type ResearchBudgetCounter = 'plannerCalls' | 'sqlExecutions' | 'repairs' | 'narratorCalls';
+export declare class ResearchBudgetExceededError extends Error {
+    readonly counter: ResearchBudgetCounter | 'wallClockMs';
+    readonly code = "RESEARCH_BUDGET_EXCEEDED";
+    constructor(counter: ResearchBudgetCounter | 'wallClockMs');
+}
+export declare class ResearchBudgetController {
+    readonly budget: ResearchBudget;
+    private readonly now;
+    private readonly used;
+    private readonly startedAt;
+    constructor(budget?: ResearchBudget, now?: () => number);
+    consume(counter: ResearchBudgetCounter): void;
+    assertWithinDeadline(): void;
+    snapshot(): Readonly<typeof this.used & {
+        elapsedMs: number;
+    }>;
+}
+export interface TypedResearchBranchInput {
+    id: string;
+    label: string;
+    delta: ResolvedAnalyticalPlanDelta;
+    evidenceIds: string[];
+}
+export interface TypedResearchBranch {
+    id: string;
+    label: string;
+    plan: ResolvedAnalyticalPlan;
+    evidenceIds: string[];
+}
+export declare function buildTypedResearchBranches(root: ResolvedAnalyticalPlan, inputs: TypedResearchBranchInput[]): TypedResearchBranch[];
+export interface ResearchObservation {
+    branchId: string;
+    status: 'executed' | 'failed' | 'not_run';
+    numericClaims: string[];
+    executionReceipt?: {
+        sqlFingerprint?: string;
+        compiledSqlFingerprint?: string;
+        resultFingerprint?: string;
+        result?: {
+            resultFingerprint?: string;
+        };
+    };
+}
+export interface ResearchConclusionGate {
+    status: 'complete' | 'partial';
+    supportedClaimIds: string[];
+    unsupportedClaimIds: string[];
+    message: string;
+}
+/** Every numeric claim needs a successful execution and a result fingerprint. */
+export declare function gateResearchConclusion(observations: ResearchObservation[]): ResearchConclusionGate;
+//# sourceMappingURL=research-governance.d.ts.map

package/dist/research-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-governance.d.ts","sourceRoot":"","sources":["../src/research-governance.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EACjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,eAAe,GAAG,SAAS,GAAG,eAAe,CAAC;AAEnG,qBAAa,2BAA4B,SAAQ,KAAK;IAExC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa;IADnE,QAAQ,CAAC,IAAI,8BAA8B;gBACtB,OAAO,EAAE,qBAAqB,GAAG,aAAa;CAIpE;AAED,qBAAa,wBAAwB;IAIjC,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuE;IAC5F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAExB,MAAM,GAAE,cAAgC,EAChC,GAAG,GAAE,MAAM,MAAiB;IAK/C,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAO7C,oBAAoB,IAAI,IAAI;IAM5B,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,IAAI,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAG/D;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,2BAA2B,CAAC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,sBAAsB,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,wBAAwB,EAAE,GACjC,mBAAmB,EAAE,CAOvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,MAAM,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,mBAAmB,EAAE,GAAG,sBAAsB,CAkBlG"}

package/dist/research-governance.js

@@ -0,0 +1,68 @@
+/** Bounded, receipt-backed research built from typed deltas over one root plan. */
+import { deriveResolvedAnalyticalPlan, } from './resolved-analytical-plan.js';
+import { RESEARCH_BUDGET } from './research-loop.js';
+export class ResearchBudgetExceededError extends Error {
+    counter;
+    code = 'RESEARCH_BUDGET_EXCEEDED';
+    constructor(counter) {
+        super(`Research budget exceeded: ${counter}.`);
+        this.counter = counter;
+        this.name = 'ResearchBudgetExceededError';
+    }
+}
+export class ResearchBudgetController {
+    budget;
+    now;
+    used = { plannerCalls: 0, sqlExecutions: 0, repairs: 0, narratorCalls: 0 };
+    startedAt;
+    constructor(budget = RESEARCH_BUDGET, now = Date.now) {
+        this.budget = budget;
+        this.now = now;
+        this.startedAt = now();
+    }
+    consume(counter) {
+        this.assertWithinDeadline();
+        const next = this.used[counter] + 1;
+        if (next > this.budget[counter])
+            throw new ResearchBudgetExceededError(counter);
+        this.used[counter] = next;
+    }
+    assertWithinDeadline() {
+        if (this.now() - this.startedAt > this.budget.wallClockMs) {
+            throw new ResearchBudgetExceededError('wallClockMs');
+        }
+    }
+    snapshot() {
+        return Object.freeze({ ...this.used, elapsedMs: Math.max(0, this.now() - this.startedAt) });
+    }
+}
+export function buildTypedResearchBranches(root, inputs) {
+    return inputs.slice(0, RESEARCH_BUDGET.sqlExecutions).map((input) => ({
+        id: input.id,
+        label: input.label,
+        plan: deriveResolvedAnalyticalPlan(root, input.delta),
+        evidenceIds: [...new Set(input.evidenceIds)].sort(),
+    }));
+}
+/** Every numeric claim needs a successful execution and a result fingerprint. */
+export function gateResearchConclusion(observations) {
+    const supported = [];
+    const unsupported = [];
+    for (const observation of observations) {
+        const hasReceipt = observation.status === 'executed'
+            && Boolean(observation.executionReceipt?.resultFingerprint
+                ?? observation.executionReceipt?.result?.resultFingerprint);
+        for (const claim of observation.numericClaims)
+            (hasReceipt ? supported : unsupported).push(claim);
+    }
+    const status = unsupported.length === 0 ? 'complete' : 'partial';
+    return {
+        status,
+        supportedClaimIds: [...new Set(supported)].sort(),
+        unsupportedClaimIds: [...new Set(unsupported)].sort(),
+        message: status === 'complete'
+            ? 'Every numeric research claim is backed by a successful execution receipt.'
+            : 'Research evidence is partial; unsupported numeric claims cannot be presented as a completed causal conclusion.',
+    };
+}
+//# sourceMappingURL=research-governance.js.map

package/dist/research-governance.js.map

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

package/dist/research-loop.d.ts

@@ -14,6 +14,7 @@ import { type AgentAction } from './intent-controller.js';
 import type { MetadataAgentIntent } from './metadata/catalog.js';
 import type { KGNode } from './kg/types.js';
 import type { PlanBlock } from './app-planner.js';
+import type { ResolvedAnalyticalPlan } from './resolved-analytical-plan.js';
 /** One ReAct step: a thought, the asset-bound action, and what observing it tells us. */
 export interface ResearchStep {
     thought: string;
@@ -42,7 +43,18 @@ export interface ResearchPlan {
     sources: string[];
     /** True when the question is answerable directly (single step, no research needed). */
     done: boolean;
+    /** Root analytical contract reused by every research branch. */
+    rootPlanId?: string;
+    budget: ResearchBudget;
 }
+export interface ResearchBudget {
+    plannerCalls: 1;
+    sqlExecutions: 6;
+    repairs: 1;
+    narratorCalls: 1;
+    wallClockMs: 120_000;
+}
+export declare const RESEARCH_BUDGET: ResearchBudget;
 /**
  * Plan how to handle a research / follow-up question. Returns the decision plus a
  * grounded plan: a direct answer, a multi-step research trace, or a follow-up with
@@ -60,5 +72,7 @@ export declare function planResearch(input: {
     }>;
     /** The user explicitly asked to research/dig deeper — don't collapse to a single-step answer. */
     forceInvestigate?: boolean;
+    /** Authoritative root plan. When present, research never re-matches meaning. */
+    rootPlan?: ResolvedAnalyticalPlan;
 }): Promise<ResearchPlan>;
 //# sourceMappingURL=research-loop.d.ts.map