@duckcodeailabs/dql-agent 1.6.21 → 1.6.22

package/dist/hints/types.js

@@ -0,0 +1,92 @@
+/**
+ * Scoped correction memory ("mini Hint Graph") types.
+ *
+ * When an analyst corrects a Tier-2 generated answer, that knowledge is captured
+ * as a scoped, approved-only, Git-versioned **hint**. Hints never override
+ * certified routing — they are folded into the agent's context AFTER certified
+ * artifacts, semantic context, and graph anchors, and only when `approved`.
+ *
+ * Source of truth = Git:
+ *   - `.dql/traces/*.trace.json`  — raw correction traces (what was wrong + the fix)
+ *   - `.dql/hints/*.hint.yaml`     — candidate/approved/rejected hints
+ *   - `.dql/reviews/*.review.yaml` — human review decisions
+ *
+ * `.dql/cache/agent-kg.sqlite` carries a rebuildable FTS index of approved hints
+ * (Git authoritative; SQLite is just a fast scoped lookup).
+ */
+/**
+ * Does a hint's scope apply to the question's resolved scope?
+ *
+ * Semantics: a hint scope field constrains ONLY when the hint declares it. For
+ * each declared field, the question must declare the same value (case-insensitive).
+ * If the question does not declare a field the hint constrains, the hint does
+ * NOT apply (we never apply a narrower-than-known hint to an unknown context),
+ * EXCEPT `dialect`, which applies when the question's dialect is unknown (so a
+ * project-wide dialect hint is not silently dropped before a warehouse is wired).
+ *
+ * Undeclared hint fields are wildcards and never block a match.
+ */
+export function hintAppliesToScope(scope, question) {
+    const matched = [];
+    const constrainedFields = [
+        ['metric', 'metric'],
+        ['dbtModel', 'dbtModel'],
+        ['domain', 'domain'],
+        ['term', 'term'],
+        ['block', 'block'],
+    ];
+    for (const [hintField, qField] of constrainedFields) {
+        const want = scope[hintField];
+        if (want === undefined || want === '')
+            continue; // wildcard
+        const have = question[qField];
+        if (have === undefined || have === '') {
+            return { applies: false, reason: `hint requires ${hintField}=${want} but question scope is unknown` };
+        }
+        if (!eqScope(want, have)) {
+            return { applies: false, reason: `hint ${hintField}=${want} ≠ question ${String(have)}` };
+        }
+        matched.push(`${hintField}=${want}`);
+    }
+    // Dialect: constrain when both sides know it; tolerate unknown question dialect.
+    if (scope.dialect && scope.dialect !== '') {
+        if (question.dialect && question.dialect !== '') {
+            if (!eqScope(scope.dialect, question.dialect)) {
+                return { applies: false, reason: `hint dialect=${scope.dialect} ≠ question ${question.dialect}` };
+            }
+            matched.push(`dialect=${scope.dialect}`);
+        }
+        // else: dialect unknown for the question — do not block; note advisory match.
+    }
+    return {
+        applies: true,
+        reason: matched.length > 0 ? matched.join(', ') : 'project-wide hint (no scope constraints)',
+    };
+}
+/** Two hints conflict when their scopes overlap on the same concept. */
+export function hintsConflict(a, b) {
+    if (a.id === b.id)
+        return false;
+    if (a.supersedes === b.id || b.supersedes === a.id)
+        return false; // explicit resolution
+    return scopesOverlap(a.scope, b.scope);
+}
+function scopesOverlap(a, b) {
+    const fields = ['metric', 'dbtModel', 'domain', 'dialect', 'term', 'block'];
+    let sharedConstraint = false;
+    for (const field of fields) {
+        const av = a[field];
+        const bv = b[field];
+        if (av && bv) {
+            if (!eqScope(av, bv))
+                return false; // disjoint on a declared field → no overlap
+            sharedConstraint = true;
+        }
+    }
+    // Overlap only when they actually share at least one declared, equal field.
+    return sharedConstraint;
+}
+function eqScope(a, b) {
+    return a.trim().toLowerCase() === b.trim().toLowerCase();
+}
+//# sourceMappingURL=types.js.map

package/dist/hints/types.js.map

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

package/dist/index.d.ts

@@ -11,10 +11,24 @@ import type { DQLManifest } from "@duckcodeailabs/dql-core";
 export { KGStore } from "./kg/sqlite-fts.js";
 export type { KGNode, KGEdge, KGNodeKind, KGSearchHit, KGFeedbackRow, KGSearchOptions, } from "./kg/types.js";
 export { buildKGFromManifest, buildKGFromSemanticLayer } from "./kg/build.js";
-export { activeSkills, buildSkillBlockHints, loadSkills, parseSkill, buildSkillsPrompt, } from "./skills/loader.js";
-export type { Skill, SkillLoadResult } from "./skills/loader.js";
+export { activeSkills, buildSkillBlockHints, loadSkills, parseSkill, renderSkill, buildSkillsPrompt, selectRelevantSkills, writeSkill, upsertSkill, deleteSkill, skillsDir, skillPath, } from "./skills/loader.js";
+export type { Skill, SkillLoadResult, WriteSkillInput, SelectRelevantSkillsOptions, } from "./skills/loader.js";
+export { seedDefaultSkills } from "./skills/defaults.js";
+export type { SeedDefaultSkillsOptions, SeedDefaultSkillsResult, } from "./skills/defaults.js";
 export { answer, parseProposal } from "./answer-loop.js";
-export type { AgentAnalysisPlan, AgentAnswer, AgentCitation, AgentFollowUpContext, AgentJoinPath, AgentIntent, AgentResultPayload, AgentSchemaColumn, AgentSchemaTable, AnswerKind, AnswerLoopInput, } from "./answer-loop.js";
+export { decideAgentAction, looksLikeComposeApp, looksLikeFollowUp, type AgentAction, type IntentDecision, type IntentDecisionInput, type IntentSignals, } from "./intent-controller.js";
+export { AgentRunEngine, AGENT_RUN_ESCALATION_MAP, createDeterministicAgentRunPlanner, defaultSuccessCriteria, FileAgentRunStore, InMemoryAgentRunStore, defaultAgentRunStorePath, selectRoute, } from "./agent-run-engine.js";
+export type { FileAgentRunStoreOptions } from "./agent-run-engine.js";
+export type { AgentRouteExecutionContext, AgentRouteExecutor, AgentRouteExecutorResult, AgentRun, AgentRunArtifact, AgentRunArtifactKind, AgentRunAudience, AgentRunEngineOptions, AgentRunEvaluation, AgentRunEvaluationSeverity, AgentRunEvent, AgentRunExecutors, AgentRunGate, AgentRunGateContext, AgentRunGates, AgentRunNextAction, AgentRunPlan, AgentRunPlanInput, AgentRunPlanner, AgentRunPlanSource, AgentRunPlannedStep, AgentRunReplanDecision, AgentRunReplanInput, AgentRunRepairAction, AgentRunRequest, AgentRunRequestedMode, AgentRunRoute, AgentRunSelectedObject, AgentRunStatus, AgentRunStep, AgentRunStepStatus, AgentRunStopReason, AgentRunStore, AgentRunTrustState, } from "./agent-run-engine.js";
+export { defaultAgentRunGates } from "./agent-run-gates.js";
+export { narrateResult, type NarrateInput, type NarrateItem, type NarrateResult, type NarrateResultData, type NarrateCompletion, type NarrateOptions, } from "./narrate.js";
+export { createLlmAgentRunPlanner, type AgentRunPlannerCompletion, type LlmAgentRunPlannerOptions, } from "./agent-run-planner.js";
+export { planApp, type AppPlan as AgentAppPlan, type AppPlanSection, type AppPlanFilter as AgentAppPlanFilter, type PlanBlock, } from "./app-planner.js";
+export { planResearch, type ResearchPlan, type ResearchStep, type ResearchFollowUp, } from "./research-loop.js";
+export { loadSemanticMetrics } from "./propose/build-from-prompt.js";
+export type { AgentAnalysisPlan, AgentAnswer, AgentCitation, AgentFollowUpContext, AgentJoinPath, AgentIntent, AgentResultPayload, AgentSchemaColumn, AgentSchemaTable, AnswerKind, AnswerLoopInput, AiRoute, AiRouteTier, } from "./answer-loop.js";
+export { matchSemanticMetric } from "./metadata/metric-match.js";
+export type { MetricMatch, MatchSemanticMetricOptions } from "./metadata/metric-match.js";
 export { APP_BUILDER_SKILLS, planAppFromPrompt, validateAppPlan, generateAppFromPlan, } from "./app-builder.js";
 export type { AppBuilderSkill, AppBuilderSkillId, AppPlan, AppPlanAnalysisIntent, AppPlanFilter, AppPlanFollowUpAction, AppPlanPage, AppPlanTile, AppPlanTileKind, AppPlanTileRole, AppPlanTrustState, AppPlanValidationIssue, AppPlanValidationResult, GeneratedAppPackage, GenerateAppFromPlanOptions, PlanAppFromPromptInput, } from "./app-builder.js";
 export { MemoryStore, defaultMemoryPath, ensureDefaultMemoryFiles, } from "./memory/sqlite-memory.js";
@@ -24,12 +38,35 @@ export { buildBlockBusinessFingerprint, buildBlockSqlFingerprints, fingerprintSq
 export type { BlockBusinessFingerprint, BlockSqlFingerprints, BuildBlockBusinessFingerprintInput, } from "./metadata/block-fingerprints.js";
 export { buildAnalysisQuestionPlan, certifiedApplicabilityForObject, scoreAllowedSqlRelationWithAnalysisPlan, scoreMetadataObjectWithAnalysisPlan, sortAllowedSqlContextForAnalysisPlan, } from "./metadata/analysis-planner.js";
 export type { AnalysisEntityMention, AnalysisQuestionMode, AnalysisQuestionPlan, AllowedSqlRelationScore, CertifiedApplicabilityKind, CertifiedBlockApplicability, } from "./metadata/analysis-planner.js";
+export { grainMatches, requestedGrainFromPlan, } from "./metadata/grain-gate.js";
+export type { GrainGateKind, GrainGateResult, RequestedGrain, } from "./metadata/grain-gate.js";
 export { validateSqlAgainstLocalContext, } from "./metadata/sql-context-validation.js";
-export { deriveGeneratedDraftSlug, upsertGeneratedDraft, } from "./metadata/drafts.js";
-export type { BuildLocalContextPackRequest, EnsureMetadataCatalogOptions, EnsureMetadataCatalogResult, DqlContextPack, LocalContextPack, MetadataCandidateConflict, MetadataDiagnostic, MetadataEdge, MetadataAgentIntent, MetadataAllowedSqlContext, MetadataAnswerRoute, MetadataEvidenceRole, MetadataFollowUpContext, MetadataMissingContext, MetadataObject, MetadataRouteDecision, MetadataDomainShard, MetadataSourceFingerprint, MetadataSnapshot, MetadataTrustLabel, PlanAgentAnswerResult, QueryRunSummary, RuntimeSchemaSnapshot, RuntimeSchemaTable, RuntimeSchemaColumn, } from "./metadata/catalog.js";
+export { buildSchemaGrounding, buildGroundingFromRuntimeRelations, renderGroundingForPrompt, resolveRelationsInSql, validateSqlAgainstGrounding, relationKeys, } from "./metadata/sql-grounding.js";
+export type { SchemaGrounding, GroundedTable, GroundedColumn, GroundedJoinKey, BuildSchemaGroundingOptions, RuntimeRelationInput, RelationResolution, GroundingValidationCode, GroundingValidationResult, } from "./metadata/sql-grounding.js";
+export { selectRelevantModels } from "./metadata/sql-retrieval.js";
+export type { SelectRelevantModelsOptions } from "./metadata/sql-retrieval.js";
+export { deriveGeneratedDraftSlug, deriveSemanticDraftName, upsertGeneratedDraft, } from "./metadata/drafts.js";
+export type { SemanticDraftNameInput } from "./metadata/drafts.js";
+export { persistOwner, readPersistedOwner, resolveLocalOwner, } from "./metadata/identity.js";
+export type { ResolveOwnerOptions } from "./metadata/identity.js";
+export { propose, proposePlan, buildProposePreview, buildFromPrompt, loadDbtArtifacts, upsertProposedDraft, renderProposedDraft, blockSlug, resolveProposeConfig, DEFAULT_PROPOSE_CONFIG, classifyModel, resolveDomain, enrichProposal, enrichProposals, } from "./propose/index.js";
+export type { ProposeOptions, ProposeSummary, ProposalResult, ProposalInference, ProposalRanking, ProposedPattern, ProposePlan, ProposePlanOptions, ProposePlanDomain, ProposePlanCandidate, ProposePreviewOptions, BuildFromPromptOptions, BuildFromPromptContext, BuildFromPromptResult, BuildCellResult, BuildBlockResult, BuildMode, BuildRoute, CertifierVerdict, ProposeConfig, ProposeConfigInput, Classification, ClassificationResult, ProposedDraftRecord, WrittenDraft, DbtArtifacts, DbtModelNode, DbtSourceNode, DbtColumn, EnrichFacts, EnrichedContent, EnrichOptions, ReflectableDraft, ExecutionProbe, BlockReflection, ReflectionFix, } from "./propose/index.js";
+export { reflectAndReviseBlock } from "./propose/index.js";
+export type { BuildLocalContextPackRequest, EnsureMetadataCatalogOptions, EnsureMetadataCatalogResult, DqlContextPack, LocalContextPack, MetadataCandidateConflict, MetadataDiagnostic, MetadataEdge, MetadataAgentIntent, MetadataAllowedSqlContext, MetadataAnswerRoute, MetadataEvidenceRole, MetadataFollowUpContext, MetadataMissingContext, MetadataObject, MetadataRouteDecision, GrainGateRouteInfo, MetadataDomainShard, MetadataSourceFingerprint, MetadataSnapshot, MetadataTrustLabel, PlanAgentAnswerResult, QueryRunSummary, RuntimeSchemaSnapshot, RuntimeSchemaTable, RuntimeSchemaColumn, } from "./metadata/catalog.js";
 export type { SqlContextValidationCode, SqlContextValidationOptions, SqlContextValidationResult, } from "./metadata/sql-context-validation.js";
 export type { GeneratedDraftBlock, GeneratedDraftRecord, } from "./metadata/drafts.js";
-export { ClaudeProvider, OpenAIProvider, GeminiProvider, OllamaProvider, pickProvider, buildProvider, } from "./providers/index.js";
+export { HintStore, } from "./hints/store.js";
+export type { SearchApprovedHintsOptions, } from "./hints/store.js";
+export { recordCorrectionTrace, reviewHint, reindexHints, listHintsFromGit, getHintFromGit, writeHintFile, readHintFile, hintsDir, tracesDir, reviewsDir, defaultHintIndexPath, } from "./hints/git-store.js";
+export type { RecordCorrectionTraceInput, RecordCorrectionTraceResult, ReviewHintInput, ReviewHintResult, } from "./hints/git-store.js";
+export { retrieveScopedHints, } from "./hints/retrieval.js";
+export type { AppliedHint, HintRetrievalResult, RetrieveScopedHintsOptions, } from "./hints/retrieval.js";
+export { hintAppliesToScope, hintsConflict, } from "./hints/types.js";
+export type { CorrectionTrace, Hint, HintReview, HintScope, HintStatus, QuestionScope, ScopedHintMatch, } from "./hints/types.js";
+export { HashedTokenEmbeddingProvider, defaultEmbeddingProvider, cosineSimilarity, hybridRank, } from "./embeddings/provider.js";
+export type { EmbeddingProvider, HybridRankItem, HybridRankOptions, HybridRanked, } from "./embeddings/provider.js";
+export type { AppliedContextHint, } from "./metadata/catalog.js";
+export { ClaudeProvider, OpenAIProvider, GeminiProvider, OllamaProvider, pickProvider, buildProvider, normalizeAnthropicBaseUrl, normalizeGeminiBaseUrl, } from "./providers/index.js";
 export type { AgentProvider, AgentMessage, ProviderName, ProviderRunOptions, } from "./providers/index.js";
 /**
  * Default location for the agent's SQLite KG file.

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -14,18 +14,42 @@ import { KGStore } from "./kg/sqlite-fts.js";
 import { buildKGFromManifest, buildKGFromSemanticLayer } from "./kg/build.js";
 import { loadSkills } from "./skills/loader.js";
 import { ensureMetadataCatalogFresh } from "./metadata/catalog.js";
+import { reindexHints } from "./hints/git-store.js";
 export { KGStore } from "./kg/sqlite-fts.js";
 export { buildKGFromManifest, buildKGFromSemanticLayer } from "./kg/build.js";
-export { activeSkills, buildSkillBlockHints, loadSkills, parseSkill, buildSkillsPrompt, } from "./skills/loader.js";
+export { activeSkills, buildSkillBlockHints, loadSkills, parseSkill, renderSkill, buildSkillsPrompt, selectRelevantSkills, writeSkill, upsertSkill, deleteSkill, skillsDir, skillPath, } from "./skills/loader.js";
+export { seedDefaultSkills } from "./skills/defaults.js";
 export { answer, parseProposal } from "./answer-loop.js";
+export { decideAgentAction, looksLikeComposeApp, looksLikeFollowUp, } from "./intent-controller.js";
+export { AgentRunEngine, AGENT_RUN_ESCALATION_MAP, createDeterministicAgentRunPlanner, defaultSuccessCriteria, FileAgentRunStore, InMemoryAgentRunStore, defaultAgentRunStorePath, selectRoute, } from "./agent-run-engine.js";
+export { defaultAgentRunGates } from "./agent-run-gates.js";
+export { narrateResult, } from "./narrate.js";
+export { createLlmAgentRunPlanner, } from "./agent-run-planner.js";
+export { planApp, } from "./app-planner.js";
+export { planResearch, } from "./research-loop.js";
+export { loadSemanticMetrics } from "./propose/build-from-prompt.js";
+export { matchSemanticMetric } from "./metadata/metric-match.js";
 export { APP_BUILDER_SKILLS, planAppFromPrompt, validateAppPlan, generateAppFromPlan, } from "./app-builder.js";
 export { MemoryStore, defaultMemoryPath, ensureDefaultMemoryFiles, } from "./memory/sqlite-memory.js";
 export { MetadataCatalog, buildLocalContextPack, buildMetadataSnapshot, defaultMetadataPath, ensureMetadataCatalogFresh, openMetadataCatalog, planAgentAnswer, recordRuntimeSchemaSnapshot, recordQueryRun, upsertMetadataSnapshot, } from "./metadata/catalog.js";
 export { buildBlockBusinessFingerprint, buildBlockSqlFingerprints, fingerprintSql, normalizeBusinessFingerprintToken, normalizeSqlForFingerprint, } from "./metadata/block-fingerprints.js";
 export { buildAnalysisQuestionPlan, certifiedApplicabilityForObject, scoreAllowedSqlRelationWithAnalysisPlan, scoreMetadataObjectWithAnalysisPlan, sortAllowedSqlContextForAnalysisPlan, } from "./metadata/analysis-planner.js";
+export { grainMatches, requestedGrainFromPlan, } from "./metadata/grain-gate.js";
 export { validateSqlAgainstLocalContext, } from "./metadata/sql-context-validation.js";
-export { deriveGeneratedDraftSlug, upsertGeneratedDraft, } from "./metadata/drafts.js";
-export { ClaudeProvider, OpenAIProvider, GeminiProvider, OllamaProvider, pickProvider, buildProvider, } from "./providers/index.js";
+export { buildSchemaGrounding, buildGroundingFromRuntimeRelations, renderGroundingForPrompt, resolveRelationsInSql, validateSqlAgainstGrounding, relationKeys, } from "./metadata/sql-grounding.js";
+export { selectRelevantModels } from "./metadata/sql-retrieval.js";
+export { deriveGeneratedDraftSlug, deriveSemanticDraftName, upsertGeneratedDraft, } from "./metadata/drafts.js";
+export { persistOwner, readPersistedOwner, resolveLocalOwner, } from "./metadata/identity.js";
+export { propose, proposePlan, buildProposePreview, buildFromPrompt, loadDbtArtifacts, upsertProposedDraft, renderProposedDraft, blockSlug, resolveProposeConfig, DEFAULT_PROPOSE_CONFIG, classifyModel, resolveDomain, enrichProposal, enrichProposals, } from "./propose/index.js";
+export { reflectAndReviseBlock } from "./propose/index.js";
+// --- Scoped correction memory (hints) ---
+export { HintStore, } from "./hints/store.js";
+export { recordCorrectionTrace, reviewHint, reindexHints, listHintsFromGit, getHintFromGit, writeHintFile, readHintFile, hintsDir, tracesDir, reviewsDir, defaultHintIndexPath, } from "./hints/git-store.js";
+export { retrieveScopedHints, } from "./hints/retrieval.js";
+export { hintAppliesToScope, hintsConflict, } from "./hints/types.js";
+// --- Pluggable semantic retrieval (embeddings) ---
+export { HashedTokenEmbeddingProvider, defaultEmbeddingProvider, cosineSimilarity, hybridRank, } from "./embeddings/provider.js";
+export { ClaudeProvider, OpenAIProvider, GeminiProvider, OllamaProvider, pickProvider, buildProvider, normalizeAnthropicBaseUrl, normalizeGeminiBaseUrl, } from "./providers/index.js";
 /**
  * Default location for the agent's SQLite KG file.
  * Mirrors the manifest cache layout under `.dql/cache/`.
@@ -74,6 +98,14 @@ export async function reindexProject(projectRoot, opts = {}) {
         semanticLayer,
         force: true,
     });
+    // Rebuild the approved-hint index (Git authoritative; SQLite is a view). Safe
+    // when no hints exist — yields an empty index.
+    try {
+        reindexHints(projectRoot, opts.kgPath ?? defaultKgPath(projectRoot));
+    }
+    catch {
+        // Hint indexing is advisory; never fail a reindex over it.
+    }
     return { nodes: nodes.length, edges: edges.length, skills: skills.length };
 }
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAS7C,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,kCAAkC,EAClC,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAsC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,aAAa,GAOd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,GAGzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,OAAO,GAKR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAgBrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAmB1B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,cAAc,EACd,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,uCAAuC,EACvC,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,gCAAgC,CAAC;AASxC,OAAO,EACL,YAAY,EACZ,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EACL,8BAA8B,GAC/B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,kCAAkC,EAClC,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,YAAY,GACb,MAAM,6BAA6B,CAAC;AAYrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAuC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAsC3D,2CAA2C;AAC3C,OAAO,EACL,SAAS,GACV,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EACL,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAU1B,oDAAoD;AACpD,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,gBAAgB,EAChB,UAAU,GACX,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAQ9B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC/D,CAAC;AAUD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,OAAuB,EAAE;IAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,KAAK,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAE7D,6DAA6D;IAC7D,IAAI,MAAM,GAAY,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE;gBACvB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,CAAC,CAAC,EAAE;gBACV,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,UAAU,EAAE,CAAC,CAAC,IAAI;gBAClB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAE/C,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IACD,MAAM,0BAA0B,CAAC,WAAW,EAAE;QAC5C,QAAQ;QACR,aAAa;QACb,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,8EAA8E;IAC9E,+CAA+C;IAC/C,IAAI,CAAC;QACH,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,MAAM,GAAG,CAAC;IAMV,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,WAAmB;IACvC,oEAAoE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAgB,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC;QACnB,WAAW;QACX,eAAe,EAAE,sBAAsB,CAAC,WAAW,CAAC,IAAI,SAAS;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,WAAmB;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,EAAE,QAAQ;QACnD,CAAC,CAAE,MAAM,CAAC,aAEH;QACP,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI;YAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAc,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;YAC/D,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,UAAU,GAAG,mCAAmC,CACpD,cAAc,EACd,WAAW,CACZ,CAAC,KAAK,CAAC;IACR,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,IAAI,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC;QAC3B,OAAO,mCAAmC,CACxC;YACE,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU;SACnC,EACD,WAAW,CACZ,CAAC,KAAK,CAAC;IACV,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAClB,KAAe,EACf,KAAe;IAEf,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACzD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS;IACrC,OAAO;QACL,GAAG,CAAC;QACJ,GAAG,CAAC;QACJ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW;QAC3C,UAAU,EACR,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS;QACxE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACxD,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU;QACxC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM;KAC7B,CAAC;AACJ,CAAC"}

package/dist/intent-controller.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Intent controller (P0) — the deciding front door of the agent.
+ *
+ * Instead of "always generate SQL", the controller looks at each turn and DECIDES
+ * what it deserves: answer it now, ask one sharp clarifying question, run a
+ * multi-step investigation, or compose an app/dashboard. It maps the existing
+ * fine-grained `MetadataAgentIntent` taxonomy + retrieval signals into a small set
+ * of high-level ACTIONS the rest of the system routes on, and it carries a
+ * human-facing rationale (show-your-work) and follow-up awareness so a turn like
+ * "why?" or "break that down" is understood in context rather than re-generated
+ * from scratch.
+ *
+ * Deterministic + offline by design: heuristics over the question, the classified
+ * intent, and match scores — no extra model call. A caller may refine with an LLM,
+ * but the default is fast, testable, and reliable.
+ */
+import type { MetadataAgentIntent } from './metadata/catalog.js';
+/** The high-level action the agent will take for a turn. */
+export type AgentAction = 'answer' | 'clarify' | 'investigate' | 'compose_app';
+export interface IntentSignals {
+    /** Best certified-artifact match score (0..1), if any. */
+    certifiedScore?: number;
+    /** Best governed-metric match score (0..1), if any. */
+    metricScore?: number;
+    /** Whether KG retrieval surfaced relevant governed context at all. */
+    hasRetrieval?: boolean;
+    /** Missing-context messages from the catalog route (drives clarify). */
+    missingContext?: string[];
+}
+export interface IntentDecisionInput {
+    question: string;
+    /** The fine-grained intent already classified upstream. */
+    intent: MetadataAgentIntent;
+    signals?: IntentSignals;
+    /** True when this turn is a follow-up (e.g. a drilldown carrier was present). */
+    isFollowUp?: boolean;
+    /** Recent turns (most recent last) — used to resolve deictic follow-ups. */
+    history?: Array<{
+        role: 'user' | 'assistant';
+        text: string;
+    }>;
+}
+export interface IntentDecision {
+    action: AgentAction;
+    /** Confidence in the action choice, 0..1. */
+    confidence: number;
+    /** One-sentence, business-facing rationale for the choice. */
+    reason: string;
+    /** Present when action is clarify: the single question to ask. */
+    clarifyingQuestion?: string;
+    /** True when the turn references prior context ("it", "that", "why", "more"). */
+    followsUp: boolean;
+}
+/** Heuristic: does the question explicitly ask to build a dashboard/app? */
+export declare function looksLikeComposeApp(question: string): boolean;
+/** Heuristic: is this turn a follow-up that depends on prior context? */
+export declare function looksLikeFollowUp(question: string, hasHistory: boolean): boolean;
+/**
+ * Decide the high-level action for a turn. Deterministic; returns the action plus
+ * a rationale and (for clarify) a single sharp question.
+ */
+export declare function decideAgentAction(input: IntentDecisionInput): IntentDecision;
+//# sourceMappingURL=intent-controller.d.ts.map

package/dist/intent-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-controller.d.ts","sourceRoot":"","sources":["../src/intent-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACpB;AA0CD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAMhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAmF5E"}

package/dist/intent-controller.js

@@ -0,0 +1,150 @@
+/**
+ * Intent controller (P0) — the deciding front door of the agent.
+ *
+ * Instead of "always generate SQL", the controller looks at each turn and DECIDES
+ * what it deserves: answer it now, ask one sharp clarifying question, run a
+ * multi-step investigation, or compose an app/dashboard. It maps the existing
+ * fine-grained `MetadataAgentIntent` taxonomy + retrieval signals into a small set
+ * of high-level ACTIONS the rest of the system routes on, and it carries a
+ * human-facing rationale (show-your-work) and follow-up awareness so a turn like
+ * "why?" or "break that down" is understood in context rather than re-generated
+ * from scratch.
+ *
+ * Deterministic + offline by design: heuristics over the question, the classified
+ * intent, and match scores — no extra model call. A caller may refine with an LLM,
+ * but the default is fast, testable, and reliable.
+ */
+/** A confident match means a certified block or governed metric clearly fits. */
+const STRONG_MATCH = 0.5;
+/** Build-an-app phrasing: an explicit verb on a dashboard/app noun. */
+const COMPOSE_APP_RE = /\b(build|create|make|set ?up|put ?together|assemble|design|generate|spin ?up|give me)\b[^.?!]*\b(dashboard|dashboards|app|apps|cockpit|scorecard|overview|workspace|monitor|report)\b/i;
+/** "Monitor / keep an eye on X over time" also implies a standing surface. */
+const MONITOR_RE = /\b(monitor|keep an eye on|track .* over time|standing (view|report)|watch over time)\b/i;
+/**
+ * EXPLICIT investigation phrasing — a "why / root cause / what happened" question
+ * is an investigation even when a governed metric matches, so this beats a direct
+ * answer. Returning just the number would miss the point of the ask.
+ */
+const STRONG_INVESTIGATE_RE = /\b(why|what'?s driving|what is driving|root ?cause|diagnose|deep ?dive|investigate|what (happened|caused|changed)|drivers? of|contributed to|explain the|analy[sz]e|anomal)\b/i;
+/** SOFT analytical phrasing — only investigate when no confident direct answer fits. */
+const SOFT_INVESTIGATE_RE = /\b(break ?down|breakdown|compare|vs\.?|versus|trend over|over time|by (region|segment|month|day|week|category|product|location|type))\b/i;
+/** Deictic / continuation phrasing that only makes sense against a prior turn. */
+const FOLLOW_UP_RE = /^\s*(why|how come|and|but|what about|how about|ok|okay|so|then|more|show more|drill|dig|expand|same|that one|those|these|it|this)\b|\b(again|instead|by (region|segment|month|day|category|product|location))\b/i;
+/** Truly diagnostic intents — investigate even when a metric matches. */
+const DIAGNOSTIC_INTENTS = new Set([
+    'diagnose_change',
+    'anomaly_investigation',
+]);
+/** Softer analytical intents — investigate only when no confident answer fits. */
+const SOFT_INVESTIGATIVE_INTENTS = new Set([
+    'driver_breakdown',
+    'segment_compare',
+    'entity_drilldown',
+]);
+const DIRECT_ANSWER_INTENTS = new Set([
+    'exact_certified_lookup',
+    'definition_lookup',
+    'ad_hoc_ranking',
+]);
+/** Heuristic: does the question explicitly ask to build a dashboard/app? */
+export function looksLikeComposeApp(question) {
+    return COMPOSE_APP_RE.test(question) || MONITOR_RE.test(question);
+}
+/** Heuristic: is this turn a follow-up that depends on prior context? */
+export function looksLikeFollowUp(question, hasHistory) {
+    if (!hasHistory)
+        return false;
+    const trimmed = question.trim();
+    // Short + deictic, or starts with a continuation word.
+    if (FOLLOW_UP_RE.test(trimmed))
+        return true;
+    return trimmed.split(/\s+/).length <= 4 && /\b(it|that|this|those|these|them)\b/i.test(trimmed);
+}
+/**
+ * Decide the high-level action for a turn. Deterministic; returns the action plus
+ * a rationale and (for clarify) a single sharp question.
+ */
+export function decideAgentAction(input) {
+    const { question, intent } = input;
+    const signals = input.signals ?? {};
+    const certified = signals.certifiedScore ?? 0;
+    const metric = signals.metricScore ?? 0;
+    const bestMatch = Math.max(certified, metric);
+    const hasMissing = (signals.missingContext?.length ?? 0) > 0;
+    const followsUp = input.isFollowUp ?? looksLikeFollowUp(question, (input.history?.length ?? 0) > 0);
+    // 1) Explicit "build me a dashboard/app" → compose an app, regardless of match.
+    if (looksLikeComposeApp(question)) {
+        return {
+            action: 'compose_app',
+            confidence: 0.8,
+            reason: 'This asks to assemble a standing view, so I will compose an app from the relevant certified blocks rather than answer a single question.',
+            followsUp,
+        };
+    }
+    // 2) EXPLICIT investigation ("why / root cause / what happened") wins even over a
+    //    metric match — returning a single number would miss the point of the ask.
+    if (STRONG_INVESTIGATE_RE.test(question) || DIAGNOSTIC_INTENTS.has(intent)) {
+        return {
+            action: 'investigate',
+            confidence: 0.75,
+            reason: 'This is an open-ended analytical question, so I will investigate it across the governed metrics and lineage rather than return one number.',
+            followsUp,
+        };
+    }
+    // 3) A confident certified block or governed metric fits → answer it directly,
+    //    even if the phrasing looks lightly analytical (don't over-investigate a lookup).
+    if (bestMatch >= STRONG_MATCH && !hasMissing && intent !== 'clarify') {
+        const via = certified >= metric ? 'a certified block' : 'a governed metric';
+        return {
+            action: 'answer',
+            confidence: Math.min(0.95, 0.5 + bestMatch / 2),
+            reason: `${via} answers this directly, so I will answer from the governed layer.`,
+            followsUp,
+        };
+    }
+    // 4) Softer analytical phrasing/intent (breakdown / compare / trend) with no
+    //    confident direct answer → investigate.
+    if (SOFT_INVESTIGATE_RE.test(question) || SOFT_INVESTIGATIVE_INTENTS.has(intent)) {
+        return {
+            action: 'investigate',
+            confidence: 0.65,
+            reason: 'This asks for a breakdown or comparison without a single governed answer, so I will investigate it.',
+            followsUp,
+        };
+    }
+    // 4) Missing context or an explicit clarify intent → ask ONE sharp question.
+    if (hasMissing || intent === 'clarify' || intent === 'trust_gap_review') {
+        return {
+            action: 'clarify',
+            confidence: 0.6,
+            reason: 'The request is missing a business object, measure, or grain I need before answering safely.',
+            clarifyingQuestion: buildClarifyingQuestion(question, signals),
+            followsUp,
+        };
+    }
+    // 5) Direct-answer intent with some retrieval → answer (generate grounded SQL).
+    if (DIRECT_ANSWER_INTENTS.has(intent) && (signals.hasRetrieval ?? false)) {
+        return {
+            action: 'answer',
+            confidence: 0.55,
+            reason: 'A specific, answerable question with governed context available — I will answer it.',
+            followsUp,
+        };
+    }
+    // 6) Default: nothing governed matched and it is not clearly analytical → clarify
+    //    honestly rather than guess.
+    return {
+        action: 'clarify',
+        confidence: 0.5,
+        reason: 'I could not match this to a certified block, governed metric, or clear analysis, so I will ask for the missing detail.',
+        clarifyingQuestion: buildClarifyingQuestion(question, signals),
+        followsUp,
+    };
+}
+function buildClarifyingQuestion(question, signals) {
+    const missing = signals.missingContext?.[0];
+    if (missing)
+        return missing;
+    return `For "${question.trim().slice(0, 80)}", which business object and measure should I use, and at what grain (e.g. by day, by customer)?`;
+}
+//# sourceMappingURL=intent-controller.js.map

package/dist/intent-controller.js.map

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

package/dist/kg/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/kg/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EAIX,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAA+B,MAAM,YAAY,CAAC;AAG9E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAyTA;AAmCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CA+KA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/kg/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EAIX,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAA+B,MAAM,YAAY,CAAC;AAG9E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CA2TA;AAmCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CA+KA"}

package/dist/kg/build.js

@@ -81,6 +81,8 @@ export function buildKGFromManifest(manifest) {
             datalexContract: block.datalexContract,
             businessRules: block.businessRules ?? block.invariants,
             caveats: block.caveats,
+            dataState: block.dataState,
+            dataStateDetail: block.dataStateDetail,
             sourcePath: block.filePath,
             sourceTier: 'certified_artifact',
             certification: block.status === 'certified' ? 'certified' : 'analyst_review_required',