@duckcodeailabs/dql-agent 1.11.10 → 1.12.0

package/dist/hints/lifecycle.js

@@ -0,0 +1,387 @@
+import { createHash } from 'node:crypto';
+import { buildLocalContextPack } from '../metadata/catalog.js';
+import { validateSqlAgainstLocalContext } from '../metadata/sql-context-validation.js';
+import { evaluateHint, getCorrectionTraceFromGit, getHintEvaluationFromGit, getHintFromGit, HintLifecycleError, recordCorrectionTrace, reopenHint, requiresEvaluatedApproval, reviewHint, updateHintCandidate, } from './git-store.js';
+import { assessHintFreshness, collectHintDependencies } from './dependencies.js';
+/**
+ * Shared correction capture path for the notebook API, CLI runtime, and MCP.
+ * Capture remains permissive: unsafe or unresolved corrections are retained as
+ * candidates with lifecycle errors, but can never pass approval.
+ */
+export async function recordGovernedCorrection(projectRoot, input, resolveContext = resolveGovernedHintContext) {
+    const context = await resolveContext({
+        projectRoot,
+        question: input.question,
+        correctedSql: input.correctedSql,
+        scope: input.scope,
+        snapshotId: input.snapshotId,
+    }).catch((error) => unresolvedContext(input, error));
+    const lifecycleErrors = failuresFromChecks(context.checks);
+    const requiredEvaluation = input.requiredEvaluation?.trim()
+        || `correction: ${input.question.trim().replace(/\s+/g, ' ').slice(0, 60)}`;
+    const evidence = uniqueStrings([
+        ...(input.evidence ?? []),
+        `question: ${input.question}`,
+        ...(input.correctedSql ? [`corrected SQL: ${compact(input.correctedSql, 400)}`] : []),
+        ...context.evidence,
+    ]);
+    return recordCorrectionTrace(projectRoot, {
+        ...input,
+        failedRoute: input.failedRoute?.trim() || 'generated_answer',
+        evidence,
+        snapshotId: context.snapshotId,
+        requiredEvaluation,
+        dependencies: context.dependencies,
+        lifecycleErrors,
+    });
+}
+/**
+ * Shared fail-closed review path. A v3 approval always creates a fresh
+ * evaluation artifact, so a failed attempt remains reviewable and retryable.
+ */
+export async function reviewGovernedHint(projectRoot, input) {
+    const hint = getHintFromGit(projectRoot, input.hintId);
+    if (!hint)
+        return null;
+    if (input.decision === 'rejected' || !requiresEvaluatedApproval(projectRoot)) {
+        return reviewHint(projectRoot, {
+            hintId: input.hintId,
+            decision: input.decision,
+            reviewer: input.reviewer,
+            note: input.note,
+            snapshotId: input.snapshotId,
+        });
+    }
+    if (hint.status !== 'candidate') {
+        throw new HintLifecycleError('HINT_NOT_CANDIDATE', `Hint ${hint.id} is ${hint.status}; only candidates can be reviewed.`);
+    }
+    if (!hint.correctedSql?.trim()) {
+        throw new HintLifecycleError('HINT_CORRECTED_SQL_REQUIRED', `Hint ${hint.id} cannot be approved without corrected SQL.`);
+    }
+    if (!hint.requiredEvaluation || !hint.snapshotId) {
+        throw new HintLifecycleError('HINT_PROVENANCE_REQUIRED', `Hint ${hint.id} is missing its required evaluation or immutable snapshot.`);
+    }
+    const trace = hint.traceId ? getCorrectionTraceFromGit(projectRoot, hint.traceId) : null;
+    const question = trace?.question?.trim() || hint.title;
+    const resolveContext = input.resolveContext ?? resolveGovernedHintContext;
+    const current = await resolveContext({
+        projectRoot,
+        question,
+        correctedSql: hint.correctedSql,
+        scope: hint.scope,
+        snapshotId: input.snapshotId,
+    }).catch((error) => unresolvedContext({ question, scope: hint.scope, correctedSql: hint.correctedSql }, error));
+    const freshness = assessHintFreshness({
+        dependencies: hint.dependencies,
+        snapshotId: hint.snapshotId,
+        currentSnapshotId: current.snapshotId,
+        currentDependencies: new Map(current.dependencies.map((dependency) => [dependency.id, dependency.fingerprint])),
+    });
+    const checks = [
+        ...current.checks,
+        {
+            name: 'snapshot-current',
+            passed: freshness.current,
+            evidence: freshness.snapshotCurrent
+                ? `Current snapshot matches ${hint.snapshotId}.`
+                : freshness.dependenciesCurrent
+                    ? `Project snapshot changed from ${hint.snapshotId} to ${current.snapshotId}, but every scoped dependency still matches.`
+                    : `Candidate snapshot ${hint.snapshotId}; current snapshot ${current.snapshotId}.`,
+        },
+    ];
+    checks.push({
+        name: 'dependencies-current',
+        passed: freshness.dependenciesCurrent,
+        evidence: freshness.staleDependencies.length > 0
+            ? `Changed or missing dependencies: ${freshness.staleDependencies.map((dependency) => dependency.id).join(', ')}.`
+            : `${hint.dependencies?.length ?? 0} recorded dependencies match current governed context.`,
+    });
+    const rowLimit = clampRowLimit(input.rowLimit);
+    const executionEvidence = [];
+    if (input.executeSql) {
+        try {
+            const result = await input.executeSql(hint.correctedSql, { rowLimit, question });
+            const bounded = Number.isInteger(result.rowCount)
+                && result.rowCount >= 0
+                && result.rowCount <= rowLimit
+                && Array.isArray(result.rows)
+                && result.rows.length <= rowLimit;
+            checks.push({
+                name: 'bounded-execution',
+                passed: bounded,
+                evidence: bounded
+                    ? `Compiled and executed read-only SQL with ${result.rowCount} row(s), bounded to ${rowLimit}.`
+                    : `Execution returned an invalid or unbounded result (rowCount=${String(result.rowCount)}, rows=${result.rows?.length ?? 'unknown'}).`,
+            });
+            const hasResultShape = Array.isArray(result.columns) && result.columns.length > 0;
+            checks.push({
+                name: 'result-shape-assertion',
+                passed: hasResultShape,
+                evidence: hasResultShape
+                    ? `Result columns: ${result.columns.map((column) => typeof column === 'string'
+                        ? column
+                        : column && typeof column === 'object' && 'name' in column
+                            ? String(column.name ?? '?')
+                            : '?').join(', ')}.`
+                    : 'Execution returned no inspectable result columns.',
+            });
+            executionEvidence.push(`bounded result: rows=${result.rowCount}; columns=${result.columns.length}; limit=${rowLimit}`);
+            if (result.executionReceipt) {
+                executionEvidence.push(`execution receipt: ${compact(JSON.stringify(result.executionReceipt), 500)}`);
+            }
+        }
+        catch (error) {
+            checks.push({
+                name: 'bounded-execution',
+                passed: false,
+                evidence: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: 'review-evidence-assertion',
+            passed: Boolean(input.note?.trim()),
+            evidence: input.note?.trim()
+                ? `Reviewer assertion: ${compact(input.note, 300)}`
+                : 'This surface cannot execute the correction; an explicit reviewer evidence note is required.',
+        });
+    }
+    checks.push({
+        name: 'human-semantic-approval',
+        passed: Boolean(input.reviewer.trim()),
+        evidence: `Explicit approval by ${input.reviewer.trim() || 'unknown reviewer'}; execution success alone does not establish semantic correctness.`,
+    });
+    const evaluated = evaluateHint(projectRoot, {
+        hintId: hint.id,
+        snapshotId: hint.snapshotId,
+        evaluation: hint.requiredEvaluation,
+        evaluator: input.reviewer,
+        checks,
+        evidence: uniqueStrings([
+            `candidate snapshot: ${hint.snapshotId}`,
+            `current snapshot: ${current.snapshotId}`,
+            ...current.evidence,
+            ...executionEvidence,
+        ]),
+        note: input.note,
+    });
+    if (evaluated.evaluation.status !== 'passed') {
+        throw new HintLifecycleError('HINT_EVALUATION_FAILED', `Hint ${hint.id} remains a candidate because evaluation ${evaluated.evaluation.id} failed: ${checks.filter((check) => !check.passed).map((check) => check.name).join(', ')}. The evaluation is persisted and may be rerun after correction.`);
+    }
+    const reviewed = reviewHint(projectRoot, {
+        hintId: hint.id,
+        decision: 'approved',
+        reviewer: input.reviewer,
+        note: input.note,
+        snapshotId: hint.snapshotId,
+    });
+    return reviewed ? { ...reviewed, evaluation: evaluated.evaluation } : null;
+}
+/** CTX-005 / API-003: read-only live inspection used by review surfaces and lifecycle decisions. */
+export async function inspectGovernedHint(projectRoot, input) {
+    const hint = getHintFromGit(projectRoot, input.hintId);
+    if (!hint)
+        return null;
+    const trace = hint.traceId ? getCorrectionTraceFromGit(projectRoot, hint.traceId) ?? undefined : undefined;
+    const question = trace?.question?.trim() || hint.title;
+    const resolveContext = input.resolveContext ?? resolveGovernedHintContext;
+    const current = await resolveContext({
+        projectRoot,
+        question,
+        correctedSql: hint.correctedSql,
+        scope: hint.scope,
+        snapshotId: input.snapshotId,
+    }).catch((error) => unresolvedContext({ question, scope: hint.scope, correctedSql: hint.correctedSql }, error));
+    const freshness = assessHintFreshness({
+        dependencies: hint.dependencies,
+        snapshotId: hint.snapshotId,
+        currentSnapshotId: current.snapshotId,
+        currentDependencies: new Map(current.dependencies.map((dependency) => [dependency.id, dependency.fingerprint])),
+    });
+    const checks = [
+        ...current.checks,
+        {
+            name: 'snapshot-current',
+            passed: freshness.current,
+            evidence: freshness.snapshotCurrent
+                ? `Current snapshot matches ${hint.snapshotId}.`
+                : freshness.dependenciesCurrent
+                    ? `Project snapshot changed from ${hint.snapshotId ?? '(missing)'} to ${current.snapshotId}, but every scoped dependency still matches.`
+                    : `Recorded snapshot ${hint.snapshotId ?? '(missing)'}; current snapshot ${current.snapshotId}.`,
+        },
+        {
+            name: 'dependencies-current',
+            passed: freshness.dependenciesCurrent,
+            evidence: freshness.staleDependencies.length > 0
+                ? `Changed or missing dependencies: ${freshness.staleDependencies.map((dependency) => dependency.id).join(', ')}.`
+                : `${hint.dependencies?.length ?? 0} recorded dependencies match current governed context.`,
+        },
+    ];
+    const state = current.snapshotId.startsWith('unverified:')
+        ? 'unverified'
+        : !freshness.current
+            ? 'stale'
+            : checks.some((check) => !check.passed)
+                ? 'invalid'
+                : 'current';
+    return {
+        hint,
+        trace,
+        evaluation: hint.evaluationId ? getHintEvaluationFromGit(projectRoot, hint.evaluationId) ?? undefined : undefined,
+        currentSnapshotId: current.snapshotId,
+        snapshotCurrent: freshness.snapshotCurrent,
+        dependenciesCurrent: freshness.dependenciesCurrent,
+        driftedDependencies: freshness.staleDependencies,
+        checks,
+        state,
+    };
+}
+/** CTX-005 / E2E-001: explicit edit revalidates provenance and clears prior evaluation state. */
+export async function editGovernedHintCandidate(projectRoot, input) {
+    const hint = getHintFromGit(projectRoot, input.hintId);
+    if (!hint)
+        return null;
+    const trace = hint.traceId ? getCorrectionTraceFromGit(projectRoot, hint.traceId) : null;
+    const scope = input.scope ?? hint.scope;
+    const correctedSql = input.correctedSql?.trim() || hint.correctedSql;
+    const question = trace?.question?.trim() || input.title?.trim() || hint.title;
+    const resolveContext = input.resolveContext ?? resolveGovernedHintContext;
+    const current = await resolveContext({
+        projectRoot,
+        question,
+        correctedSql,
+        scope,
+        snapshotId: input.snapshotId,
+    }).catch((error) => unresolvedContext({ question, scope, correctedSql }, error));
+    return updateHintCandidate(projectRoot, {
+        hintId: hint.id,
+        title: input.title,
+        guidance: input.guidance,
+        correctedSql,
+        scope,
+        snapshotId: current.snapshotId,
+        dependencies: current.dependencies,
+        lifecycleErrors: failuresFromChecks(current.checks),
+    });
+}
+/** CTX-005: reopen an applied/retired hint as a non-retrievable candidate against current context. */
+export async function reopenGovernedHint(projectRoot, input) {
+    const hint = getHintFromGit(projectRoot, input.hintId);
+    if (!hint)
+        return null;
+    const trace = hint.traceId ? getCorrectionTraceFromGit(projectRoot, hint.traceId) : null;
+    const question = trace?.question?.trim() || hint.title;
+    const resolveContext = input.resolveContext ?? resolveGovernedHintContext;
+    const current = await resolveContext({
+        projectRoot,
+        question,
+        correctedSql: hint.correctedSql,
+        scope: hint.scope,
+        snapshotId: input.snapshotId,
+    }).catch((error) => unresolvedContext({ question, scope: hint.scope, correctedSql: hint.correctedSql }, error));
+    return reopenHint(projectRoot, {
+        hintId: hint.id,
+        reviewer: input.reviewer,
+        note: input.note,
+        snapshotId: current.snapshotId,
+        dependencies: current.dependencies,
+        lifecycleErrors: failuresFromChecks(current.checks),
+    });
+}
+/** Resolve current SQL authorization and content-addressed dependencies. */
+export async function resolveGovernedHintContext(input) {
+    const pack = await buildLocalContextPack(input.projectRoot, {
+        question: input.question,
+        surface: 'hint_lifecycle',
+        strictness: 'safe',
+    });
+    const snapshotId = input.snapshotId?.trim()
+        || pack.freshness.fingerprint
+        || `unverified:${shortHash(`${input.question}\0${input.correctedSql ?? ''}`)}`;
+    const collected = collectHintDependencies({
+        sql: input.correctedSql,
+        scope: input.scope,
+        objects: pack.objects,
+        relations: pack.allowedSqlContext.relations,
+        fallbackFingerprint: pack.freshness.fingerprint ?? undefined,
+    });
+    const validation = input.correctedSql?.trim()
+        ? validateSqlAgainstLocalContext(input.correctedSql, pack, {
+            dialect: input.scope.dialect,
+            question: input.question,
+        })
+        : null;
+    const checks = [
+        {
+            name: 'corrected-sql-present',
+            passed: Boolean(input.correctedSql?.trim()),
+            evidence: input.correctedSql?.trim() ? 'Candidate includes corrected SQL.' : 'Candidate has no corrected SQL.',
+        },
+        {
+            name: 'read-only-sql',
+            passed: Boolean(validation && (validation.ok
+                || (validation.code !== 'unsafe_sql' && validation.code !== 'insufficient_context'))),
+            evidence: validation?.ok
+                ? 'Parser accepted a read-only SELECT/WITH statement.'
+                : validation?.error ?? 'No SQL was available to parse.',
+        },
+        {
+            name: 'relations-authorized',
+            passed: Boolean(validation?.ok) && collected.referencedRelations.length > 0 && collected.unknownRelations.length === 0,
+            evidence: collected.unknownRelations.length > 0
+                ? `Relations outside current governed context: ${collected.unknownRelations.join(', ')}.`
+                : collected.referencedRelations.length > 0
+                    ? `Authorized relations: ${collected.referencedRelations.join(', ')}.`
+                    : validation && !validation.ok
+                        ? validation.error
+                        : 'No governed relation was referenced.',
+        },
+    ];
+    return {
+        snapshotId,
+        dependencies: collected.dependencies,
+        checks,
+        evidence: [
+            `snapshot: ${snapshotId}`,
+            ...collected.dependencies.map((dependency) => `dependency: ${dependency.id}@${dependency.fingerprint}`),
+        ],
+    };
+}
+function unresolvedContext(input, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        snapshotId: `unverified:${shortHash(`${input.question}\0${input.correctedSql ?? ''}`)}`,
+        dependencies: [],
+        checks: [
+            { name: 'context-resolved', passed: false, evidence: message },
+            { name: 'relations-authorized', passed: false, evidence: 'Current governed context could not be resolved.' },
+        ],
+        evidence: [`context resolution failed: ${message}`],
+    };
+}
+function failuresFromChecks(checks) {
+    const at = new Date().toISOString();
+    return checks
+        .filter((check) => !check.passed)
+        .map((check) => ({
+        code: `HINT_${check.name.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_FAILED`,
+        message: check.evidence || `${check.name} failed.`,
+        at,
+    }));
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+function compact(value, limit) {
+    return value.replace(/\s+/g, ' ').trim().slice(0, limit);
+}
+function shortHash(value) {
+    return createHash('sha256').update(value).digest('hex').slice(0, 16);
+}
+function clampRowLimit(value) {
+    if (!Number.isFinite(value))
+        return 200;
+    return Math.max(1, Math.min(500, Math.floor(value)));
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/hints/lifecycle.js.map

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

package/dist/hints/retrieval.d.ts

@@ -8,13 +8,14 @@
  * ever returned in normal mode. A hint is applied only within its declared
  * scope (metric / dbt model / domain / dialect / term / block).
  */
-import type { QuestionScope } from './types.js';
+import { type QuestionScope } from './types.js';
 import type { EmbeddingProvider } from '../embeddings/provider.js';
 export interface AppliedHint {
     hintId: string;
     title: string;
     guidance: string;
     scopeReason: string;
+    graphReason?: string;
     score: number;
     correctedSql?: string;
     traceId?: string;
@@ -28,6 +29,13 @@ export interface HintRetrievalResult {
         titles: [string, string];
         reason: string;
     }>;
+    /** Approved hints withheld by governance gates, retained for review/repair. */
+    excluded: Array<{
+        hintId: string;
+        title: string;
+        reason: 'stale' | 'superseded' | 'conflict';
+        detail: string;
+    }>;
 }
 export interface RetrieveScopedHintsOptions {
     questionScope: QuestionScope;
@@ -39,6 +47,10 @@ export interface RetrieveScopedHintsOptions {
     alpha?: number;
     embeddingProvider?: EmbeddingProvider;
     indexPath?: string;
+    /** Current content fingerprints keyed by persisted dependency id. */
+    currentDependencies?: ReadonlyMap<string, string>;
+    /** Conservative fallback for older v3 hints without dependency provenance. */
+    currentSnapshotId?: string | null;
 }
 /**
  * Retrieve approved scoped hints from the SQLite index. Returns an empty result

package/dist/hints/retrieval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/hints/retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA8B9B"}
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/hints/retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAA4B,KAAK,aAAa,EAAwB,MAAM,YAAY,CAAC;AAEhG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,+EAA+E;IAC/E,QAAQ,EAAE,KAAK,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;QAC5C,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAyF9B"}

package/dist/hints/retrieval.js

@@ -11,6 +11,8 @@
 import { existsSync } from 'node:fs';
 import { defaultHintIndexPath } from './git-store.js';
 import { HintStore } from './store.js';
+import { hintsConflict } from './types.js';
+import { assessHintFreshness } from './dependencies.js';
 /**
  * Retrieve approved scoped hints from the SQLite index. Returns an empty result
  * (no error) when the index does not exist yet or no hints match — keeping the
@@ -19,7 +21,7 @@ import { HintStore } from './store.js';
 export async function retrieveScopedHints(projectRoot, options) {
     const indexPath = options.indexPath ?? defaultHintIndexPath(projectRoot);
     if (!existsSync(indexPath))
-        return { applied: [], conflicts: [] };
+        return { applied: [], conflicts: [], excluded: [] };
     const store = new HintStore(indexPath);
     try {
         const matches = await store.searchApprovedHints({
@@ -28,19 +30,79 @@ export async function retrieveScopedHints(projectRoot, options) {
             alpha: options.alpha,
             embeddingProvider: options.embeddingProvider,
         });
-        const applied = matches.map(toAppliedHint);
-        // Surface conflicts only among the hints we actually applied, so unrelated
-        // overlaps elsewhere in the project do not noise up an answer.
-        const appliedIds = new Set(applied.map((hint) => hint.hintId));
-        const conflicts = store
-            .conflictingApprovedHints()
-            .filter(([a, b]) => appliedIds.has(a.id) || appliedIds.has(b.id))
-            .map(([a, b]) => ({
+        const excluded = [];
+        const fresh = matches.filter((match) => {
+            const currentDependencies = new Map(options.currentDependencies ?? []);
+            if (options.currentSnapshotId) {
+                for (const dependency of match.hint.dependencies ?? []) {
+                    if (dependency.id.startsWith('scope:')) {
+                        currentDependencies.set(dependency.id, options.currentSnapshotId);
+                    }
+                }
+            }
+            const freshness = assessHintFreshness({
+                dependencies: match.hint.dependencies,
+                snapshotId: match.hint.snapshotId,
+                currentDependencies,
+                currentSnapshotId: options.currentSnapshotId,
+            });
+            if (freshness.current)
+                return true;
+            excluded.push({
+                hintId: match.hint.id,
+                title: match.hint.title,
+                reason: 'stale',
+                detail: freshness.staleDependencies.length > 0
+                    ? `Changed or missing dependencies: ${freshness.staleDependencies.map((dependency) => dependency.id).join(', ')}.`
+                    : `Candidate snapshot ${match.hint.snapshotId} differs from current snapshot ${options.currentSnapshotId}.`,
+            });
+            return false;
+        });
+        const eligibleIds = new Set(fresh.map((match) => match.hint.id));
+        const supersededIds = new Set(fresh
+            .map((match) => match.hint.supersedes)
+            .filter((id) => Boolean(id) && eligibleIds.has(id)));
+        const unsuperseded = fresh.filter((match) => {
+            if (!supersededIds.has(match.hint.id))
+                return true;
+            excluded.push({
+                hintId: match.hint.id,
+                title: match.hint.title,
+                reason: 'superseded',
+                detail: 'A newer eligible approved hint explicitly supersedes this hint.',
+            });
+            return false;
+        });
+        const conflictPairs = [];
+        for (let left = 0; left < unsuperseded.length; left += 1) {
+            for (let right = left + 1; right < unsuperseded.length; right += 1) {
+                const a = unsuperseded[left].hint;
+                const b = unsuperseded[right].hint;
+                if (hintsConflict(a, b))
+                    conflictPairs.push([a, b]);
+            }
+        }
+        const conflictingIds = new Set(conflictPairs.flatMap(([a, b]) => [a.id, b.id]));
+        for (const match of unsuperseded) {
+            if (!conflictingIds.has(match.hint.id))
+                continue;
+            excluded.push({
+                hintId: match.hint.id,
+                title: match.hint.title,
+                reason: 'conflict',
+                detail: 'Overlapping approved hints are withheld until one explicitly supersedes the other.',
+            });
+        }
+        const applied = unsuperseded
+            .filter((match) => !conflictingIds.has(match.hint.id))
+            .slice(0, options.limit ?? 6)
+            .map(toAppliedHint);
+        const conflicts = conflictPairs.map(([a, b]) => ({
             hintIds: [a.id, b.id],
             titles: [a.title, b.title],
-            reason: `Approved hints "${a.title}" and "${b.title}" overlap on scope and may disagree; review which is authoritative.`,
+            reason: `Approved hints "${a.title}" and "${b.title}" overlap on scope and are withheld until review resolves the conflict.`,
         }));
-        return { applied, conflicts };
+        return { applied, conflicts, excluded };
     }
     finally {
         store.close();
@@ -52,6 +114,7 @@ function toAppliedHint(match) {
         title: match.hint.title,
         guidance: match.hint.guidance,
         scopeReason: match.scopeReason,
+        graphReason: match.graphReason,
         score: match.score,
         correctedSql: match.hint.correctedSql,
         traceId: match.hint.traceId,

package/dist/hints/retrieval.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../src/hints/retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiCvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,OAAmC;IAEnC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAElE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC;YAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAE3C,2EAA2E;QAC3E,+DAA+D;QAC/D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,KAAK;aACpB,wBAAwB,EAAE;aAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAChE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChB,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAqB;YACzC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAqB;YAC9C,MAAM,EAAE,mBAAmB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,KAAK,qEAAqE;SACzH,CAAC,CAAC,CAAC;QAEN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAsB;IAC3C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;QACrB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;QACvB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;QAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY;QACrC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../src/hints/retrieval.ts"],"names":[],"mappings":"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"}

package/dist/hints/store.d.ts

@@ -6,7 +6,7 @@
  * extending the existing store rather than introducing a second cache file.
  * Approved-only is enforced at the retrieval boundary (`searchApprovedHints`).
  */
-import { type Hint, type HintStatus, type QuestionScope, type ScopedHintMatch } from './types.js';
+import { type Hint, type HintGraphEdge, type HintStatus, type QuestionScope, type ScopedHintMatch } from './types.js';
 import { type EmbeddingProvider } from '../embeddings/provider.js';
 export interface SearchApprovedHintsOptions {
     questionScope: QuestionScope;
@@ -19,19 +19,26 @@ export declare class HintStore {
     private db;
     constructor(dbPath: string);
     private initSchema;
+    private ensureColumn;
     /** Replace the whole index from the Git-authoritative hint set. */
-    rebuild(hints: Hint[]): void;
+    rebuild(hints: Hint[], projectionFingerprint?: string): void;
     /** Upsert a single hint (keeps Git + SQLite in sync after a record/approve). */
     upsert(hint: Hint): void;
+    /** Fingerprint of the Git hint set and projection schema currently indexed. */
+    projectionFingerprint(): string | undefined;
     private insertRow;
+    private prepareEdgeInsert;
     get(id: string): Hint | null;
     list(status?: HintStatus): Hint[];
+    /** Typed, rebuildable graph connections for review and retrieval ranking. */
+    edgesForHint(hintId: string): HintGraphEdge[];
     /**
      * Retrieve APPROVED hints that apply to a question's scope. This is the only
      * retrieval entry point used outside review/dev mode — draft/candidate hints
      * are never returned here.
      */
     searchApprovedHints(options: SearchApprovedHintsOptions): Promise<ScopedHintMatch[]>;
+    private approvedHintsForTargets;
     /** Approved hints whose scopes overlap (surfaced as conflicts for review). */
     conflictingApprovedHints(): Array<[Hint, Hint]>;
     close(): void;

package/dist/hints/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/hints/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAEL,KAAK,IAAI,EAET,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAWnC,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAQ1B,OAAO,CAAC,UAAU;IAuClB,mEAAmE;IACnE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAsB5B,gFAAgF;IAChF,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAmBxB,OAAO,CAAC,SAAS;IAmCjB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK5B,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAOjC;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0D1F,8EAA8E;IAC9E,wBAAwB,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAc/C,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/hints/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAEL,KAAK,IAAI,EACT,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAWnC,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAQ1B,OAAO,CAAC,UAAU;IAuElB,OAAO,CAAC,YAAY;IAOpB,mEAAmE;IACnE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI;IAkC5D,gFAAgF;IAChF,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAuBxB,+EAA+E;IAC/E,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAO3C,OAAO,CAAC,SAAS;IAqDjB,OAAO,CAAC,iBAAiB;IAQzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK5B,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAOjC,6EAA6E;IAC7E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;IAU7C;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmF1F,OAAO,CAAC,uBAAuB;IAe/B,8EAA8E;IAC9E,wBAAwB,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAc/C,KAAK,IAAI,IAAI;CAGd"}