@duckcodeailabs/dql-agent 1.11.10 → 1.12.1

package/dist/conversation/snapshot.js

@@ -4,9 +4,9 @@
  * a few verbatim recent turns + how the new question relates to the topic.
  */
 import { parseWorkingState, reduceWorkingState, } from './working-state.js';
-import { updateRollingSummary } from './rolling-summary.js';
+import { renderStructuredConversationSummary, updateRollingSummary, updateStructuredConversationSummary, } from './rolling-summary.js';
 import { buildAnalysisQuestionPlan } from '../metadata/analysis-planner.js';
-import { hybridRank } from '../embeddings/provider.js';
+import { envEmbeddingProvider, hybridRank } from '../embeddings/provider.js';
 const RECENT_TURNS = 4;
 /**
  * Build the snapshot for a new question. When the question starts a genuinely
@@ -26,12 +26,22 @@ export function buildConversationSnapshot(store, threadId, options = {}) {
             workingState = { ...workingState, filters: [] };
         }
     }
+    const latest = recent[recent.length - 1];
     return {
+        version: 1,
         threadId,
+        surface: thread.surface,
         rollingSummary: thread.rollingSummary,
+        structuredSummary: thread.structuredSummary,
         workingState: hasWorkingState(workingState) ? workingState : undefined,
         recentTurns: recent.map(snapshotTurn),
         topicRelation,
+        pendingClarification: latest && (latest.route === 'clarify' || latest.runStatus === 'needs_clarification')
+            ? {
+                sourceTurnId: latest.id,
+                question: latest.answerSummary ?? latest.answerText ?? latest.question,
+            }
+            : undefined,
     };
 }
 /**
@@ -53,9 +63,16 @@ export function advanceThreadState(store, threadId, turn) {
         const rollingSummary = compactable.length > 0
             ? updateRollingSummary({ previousSummary: thread.rollingSummary, compactedTurns: compactable })
             : thread.rollingSummary;
+        const structuredSummary = compactable.length > 0
+            ? updateStructuredConversationSummary({
+                previousSummary: thread.structuredSummary,
+                compactedTurns: compactable,
+            })
+            : thread.structuredSummary;
         store.updateThreadState(threadId, {
             workingState: state,
             rollingSummary,
+            ...(structuredSummary ? { structuredSummary } : {}),
             summaryTurnSeq: compactable.length > 0
                 ? compactable[compactable.length - 1].seq
                 : thread.summaryTurnSeq,
@@ -67,9 +84,10 @@ export function advanceThreadState(store, threadId, turn) {
 }
 /**
  * Semantic recall over the thread's OLDER turns ("what did we discuss about X?").
- * FTS candidates re-ranked with the deterministic hash-embedding blend
- * (alpha 0.4 — FTS still dominates). Turns already in the recent verbatim
- * window are excluded; returns at most `limit` hits. Never throws.
+ * FTS candidates are re-ranked with the configured project embedding provider
+ * (and the deterministic local fallback when no provider is configured).
+ * Turns already in the recent verbatim window are excluded; returns at most
+ * `limit` hits. Never throws.
  */
 export async function recallRelevantTurns(store, threadId, question, options = {}) {
     try {
@@ -83,13 +101,86 @@ export async function recallRelevantTurns(store, threadId, question, options = {
             // FTS returns rank-ordered rows; convert position to a [0,1] score.
             ftsScore: 1 - index / candidates.length,
             text: `${turn.question} ${turn.answerSummary ?? ''}`,
-        })), { alpha: 0.4 });
+        })), { alpha: 0.4, provider: envEmbeddingProvider() });
         return ranked.slice(0, options.limit ?? 3).map((entry) => snapshotTurn(entry.item));
     }
     catch {
         return [];
     }
 }
+/** Read the canonical server envelope while accepting the original key during upgrades. */
+export function conversationEnvelopeFromContext(context) {
+    if (!context)
+        return undefined;
+    const raw = context.conversationEnvelope ?? context.serverSnapshot;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const envelope = raw;
+    if (typeof envelope.threadId !== 'string' || !Array.isArray(envelope.recentTurns))
+        return undefined;
+    return {
+        ...envelope,
+        version: 1,
+        surface: typeof envelope.surface === 'string' ? envelope.surface : 'agent',
+        threadId: envelope.threadId,
+        recentTurns: envelope.recentTurns,
+    };
+}
+/**
+ * One bounded history projection for routing, meaning resolution, planning and
+ * execution fallbacks. Review/blocked state is explicit so prose cannot silently
+ * become trusted analytical context.
+ */
+export function conversationHistoryFromContext(context, limit = 6) {
+    const envelope = conversationEnvelopeFromContext(context);
+    if (!envelope)
+        return [];
+    return envelope.recentTurns.slice(-Math.max(1, limit)).flatMap((turn) => {
+        const answer = turn.answerSummary?.trim();
+        return [
+            { role: 'user', text: turn.question },
+            ...(answer
+                ? [{
+                        role: 'assistant',
+                        text: `[${conversationTurnContextState(turn)}] ${answer}`,
+                    }]
+                : []),
+        ];
+    });
+}
+/** Compact non-prose context shared by every orchestration stage. */
+export function renderConversationEnvelopeForPrompt(context) {
+    const envelope = conversationEnvelopeFromContext(context);
+    if (!envelope)
+        return undefined;
+    const state = envelope.workingState
+        ? parseWorkingState(envelope.workingState)
+        : undefined;
+    const summary = renderStructuredConversationSummary(envelope.structuredSummary)
+        ?? envelope.rollingSummary;
+    const stateLines = state
+        ? [
+            state.topicKey ? `active topic: ${state.topicKey}` : '',
+            state.entities.length ? `entities: ${state.entities.join(', ')}` : '',
+            state.measures.length ? `measures: ${state.measures.join(', ')}` : '',
+            state.dimensions.length ? `dimensions: ${state.dimensions.join(', ')}` : '',
+            state.filters.length ? `filters: ${state.filters.map((filter) => filter.value).join(', ')}` : '',
+            state.timeframe ? `timeframe: ${state.timeframe}` : '',
+            state.limit !== undefined ? `limit: ${state.limit}` : '',
+        ].filter(Boolean)
+        : [];
+    const lines = [
+        `thread: ${envelope.threadId}`,
+        `surface: ${envelope.surface}`,
+        envelope.topicRelation ? `new-turn relation: ${envelope.topicRelation}` : '',
+        ...stateLines,
+        envelope.pendingClarification
+            ? `pending clarification: ${envelope.pendingClarification.question}`
+            : '',
+        summary ? `older trusted-state summary:\n${summary}` : '',
+    ].filter(Boolean);
+    return lines.length > 0 ? lines.join('\n') : undefined;
+}
 /** Classify the NEW question against the current topic key (same Jaccard rule as the reducer). */
 function classifyQuestionRelation(state, question) {
     const plan = buildAnalysisQuestionPlan(question);
@@ -130,6 +221,9 @@ function snapshotTurn(turn) {
         question: turn.question,
         answerSummary: turn.answerSummary,
         route: turn.route,
+        trustLabel: turn.trustLabel,
+        runStatus: turn.runStatus,
+        stopReason: turn.stopReason,
         sourceCertifiedBlock: turn.sourceCertifiedBlock,
         contextPackId: turn.contextPackId,
         knowledgeLens: turn.knowledgeLens,
@@ -141,6 +235,21 @@ function snapshotTurn(turn) {
         cascade: turn.cascade,
     };
 }
+export function conversationTurnContextState(turn) {
+    if (turn.runStatus === 'blocked' || turn.trustLabel === 'blocked' || turn.route === 'blocked') {
+        return 'blocked';
+    }
+    if (turn.runStatus === 'needs_clarification' || turn.route === 'clarify') {
+        return 'unresolved';
+    }
+    if (turn.runStatus === 'needs_review' || turn.trustLabel === 'review_required') {
+        return 'provisional';
+    }
+    if (turn.trustLabel === 'certified' || turn.trustLabel === 'governed' || turn.trustLabel === 'grounded') {
+        return 'confirmed';
+    }
+    return 'context';
+}
 function hasWorkingState(state) {
     return state.entities.length > 0
         || state.measures.length > 0

package/dist/conversation/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,YAAY,GAAG,CAAC,CAAC;AA6BvB;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAwB,EACxB,QAAgB,EAChB,UAAkD,EAAE;IAEpD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;IAC3E,IAAI,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,aAAwC,CAAC;IAC7C,IAAI,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC9C,aAAa,GAAG,wBAAwB,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;YAC9B,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO;QACL,QAAQ;QACR,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QACtE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QACrC,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB,EAAE,QAAgB,EAAE,IAAsB;IACnG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;QACnF,4DAA4D;QAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,GAAG,aAAa,GAAG,CAAC;YAC3D,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC;YAC1E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;YAC3C,CAAC,CAAC,oBAAoB,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;YAC/F,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1B,KAAK,CAAC,iBAAiB,CAAC,QAAQ,EAAE;YAChC,YAAY,EAAE,KAA2C;YACzD,cAAc;YACd,cAAc,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;gBACpC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG;gBACzC,CAAC,CAAC,MAAM,CAAC,cAAc;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAwB,EACxB,QAAgB,EAChB,QAAgB,EAChB,UAAyD,EAAE;IAE3D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;aAC3E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,QAAQ,EACR,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,IAAI;YACV,oEAAoE;YACpE,QAAQ,EAAE,CAAC,GAAG,KAAK,GAAG,UAAU,CAAC,MAAM;YACvC,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE;SACrD,CAAC,CAAC,EACH,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,SAAS,wBAAwB,CAAC,KAA+B,EAAE,QAAgB;IACjF,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;QACpB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC;KACvC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAC5C,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IACjD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACjE,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACxD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,GAAG,IAAI,CAAC,CAAC;QAC7D,OAAO,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IACvH,OAAO,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,IAAsB;IAC1C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO;QACnC,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ;QACrC,qBAAqB,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe;QACnD,SAAS,EAAE,IAAI,CAAC,GAAG;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAA+B;IACtD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;WAC3B,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;WACzB,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;WAC3B,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;WACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACnF,CAAC"}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/conversation/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/hints/correction-eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correction-eval.d.ts","sourceRoot":"","sources":["../../src/hints/correction-eval.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtC;AAED,eAAO,MAAM,8BAA8B,4CAA4C,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAU5H;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAoBlG;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpI"}
+{"version":3,"file":"correction-eval.d.ts","sourceRoot":"","sources":["../../src/hints/correction-eval.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtC;AAED,eAAO,MAAM,8BAA8B,4CAA4C,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAU5H;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAoBlG;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpI"}

package/dist/hints/correction-eval.js

@@ -1,12 +1,10 @@
 /**
  * Corrections become regression eval cases (W4.3).
  *
- * When an analyst corrects an answer, we already capture a scoped hint. This also
- * distills the correction into an agent-eval case so the wrong answer can never
- * silently return: the case asserts a future answer to the same question references
- * the same relations the human's corrected SQL used. Cases accumulate in the
- * project's `agent-evals/corrections.agent-evals.yml`, which `dql agent eval` reads.
- * This is the Anthropic pattern — a stakeholder correction turns into a durable test.
+ * Explicit utility for turning a reviewed correction into an agent-eval case.
+ * Correction capture does not call this automatically: writing a regression
+ * source is a separate authoring action. The generated assertion only checks
+ * referenced relations and is not semantic proof for hint approval.
  */
 import { analyzeSqlReferences } from '@duckcodeailabs/dql-core';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';

package/dist/hints/correction-eval.js.map

@@ -1 +1 @@
-{"version":3,"file":"correction-eval.js","sourceRoot":"","sources":["../../src/hints/correction-eval.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"correction-eval.js","sourceRoot":"","sources":["../../src/hints/correction-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,IAAI,MAAM,SAAS,CAAC;AAQ3B,MAAM,CAAC,MAAM,8BAA8B,GAAG,yCAAyC,CAAC;AAExF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAgE;IACtG,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;SAC7F,MAAM,CAAC,OAAO,CAAC;SACf,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,eAAe,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAChE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;KACjE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB,EAAE,QAA4B;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiD,CAAC;YACrG,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IAClG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,yEAAyE;UACpF,qFAAqF;UACrF,2EAA2E,CAAC;IAChF,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,KAAgE;IAC1H,OAAO,wBAAwB,CAAC,WAAW,EAAE,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/hints/dependencies.d.ts

@@ -0,0 +1,63 @@
+import type { HintDependency, HintScope } from './types.js';
+export interface HintDependencyObject {
+    objectKey: string;
+    objectType: string;
+    name: string;
+    fullName?: string;
+    domain?: string;
+    sourcePath?: string;
+    status?: string;
+    description?: string;
+    payload?: Record<string, unknown>;
+}
+export interface HintDependencyRelation {
+    relation: string;
+    name: string;
+    objectKey?: string;
+    source: string;
+    columns: Array<{
+        name: string;
+        type?: string;
+        description?: string;
+    }>;
+    columnCompleteness?: 'complete' | 'partial';
+}
+export interface CollectedHintDependencies {
+    dependencies: HintDependency[];
+    referencedRelations: string[];
+    unknownRelations: string[];
+}
+export interface HintFreshnessAssessment {
+    snapshotCurrent: boolean;
+    dependenciesCurrent: boolean;
+    staleDependencies: HintDependency[];
+    /**
+     * Dependency-bearing hints are scoped: an unrelated project snapshot change
+     * does not invalidate them when every recorded dependency still matches.
+     * Legacy hints without dependency evidence fall back to the project snapshot.
+     */
+    current: boolean;
+}
+/** Content-address the governed relation/object inputs used by a hint. */
+export declare function collectHintDependencies(input: {
+    sql?: string;
+    scope: HintScope;
+    objects: HintDependencyObject[];
+    relations: HintDependencyRelation[];
+    /** Conservative fingerprint when a scoped object is not in the bounded pack. */
+    fallbackFingerprint?: string;
+}): CollectedHintDependencies;
+/** Build the current dependency lookup used by retrieval-time drift gates. */
+export declare function currentHintDependencyFingerprints(input: {
+    objects: HintDependencyObject[];
+    relations: HintDependencyRelation[];
+}): Map<string, string>;
+export declare function staleHintDependencies(dependencies: HintDependency[] | undefined, current: ReadonlyMap<string, string> | undefined): HintDependency[];
+/** Apply the same fail-closed freshness rule at review, inspection, and retrieval. */
+export declare function assessHintFreshness(input: {
+    dependencies?: HintDependency[];
+    snapshotId?: string;
+    currentDependencies?: ReadonlyMap<string, string>;
+    currentSnapshotId?: string | null;
+}): HintFreshnessAssessment;
+//# sourceMappingURL=dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/hints/dependencies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAsB,SAAS,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,yBAAyB,CAiD5B;AAED,8EAA8E;AAC9E,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBtB;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,cAAc,EAAE,GAAG,SAAS,EAC1C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC/C,cAAc,EAAE,CAGlB;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,GAAG,uBAAuB,CAmB1B"}

package/dist/hints/dependencies.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { analyzeSqlReferences } from '@duckcodeailabs/dql-core';
+/** Content-address the governed relation/object inputs used by a hint. */
+export function collectHintDependencies(input) {
+    const dependencies = new Map();
+    const analysis = input.sql?.trim() ? analyzeSqlReferences(input.sql) : null;
+    const referencedRelations = analysis?.tables ?? [];
+    const unknownRelations = [];
+    for (const referenced of referencedRelations) {
+        const relation = findRelation(input.relations, referenced);
+        if (!relation) {
+            unknownRelations.push(referenced);
+            continue;
+        }
+        const dependency = relationDependency(relation);
+        dependencies.set(dependency.id, dependency);
+        if (relation.objectKey) {
+            const object = input.objects.find((candidate) => candidate.objectKey === relation.objectKey);
+            if (object) {
+                const objectDep = objectDependency(object);
+                dependencies.set(objectDep.id, objectDep);
+            }
+        }
+    }
+    for (const [scopeField, kind, objectTypes] of SCOPE_OBJECTS) {
+        const name = input.scope[scopeField];
+        if (!name)
+            continue;
+        const object = input.objects.find((candidate) => objectTypes.includes(candidate.objectType.toLowerCase())
+            && objectNames(candidate).some((candidateName) => eq(candidateName, name)));
+        const dependency = object
+            ? objectDependency(object, kind)
+            : input.fallbackFingerprint
+                ? {
+                    id: `scope:${kind}:${normalizeScopeName(name)}`,
+                    kind,
+                    name,
+                    fingerprint: input.fallbackFingerprint,
+                }
+                : undefined;
+        if (!dependency)
+            continue;
+        dependencies.set(dependency.id, dependency);
+    }
+    return {
+        dependencies: [...dependencies.values()].sort((left, right) => left.id.localeCompare(right.id)),
+        referencedRelations,
+        unknownRelations,
+    };
+}
+/** Build the current dependency lookup used by retrieval-time drift gates. */
+export function currentHintDependencyFingerprints(input) {
+    const current = new Map();
+    for (const relation of input.relations) {
+        const dependency = relationDependency(relation);
+        current.set(dependency.id, dependency.fingerprint);
+    }
+    for (const object of input.objects) {
+        const dependency = objectDependency(object);
+        current.set(dependency.id, dependency.fingerprint);
+        const inferredKind = hintKindForObjectType(object.objectType);
+        if (inferredKind) {
+            const scoped = objectDependency(object, inferredKind);
+            current.set(scoped.id, scoped.fingerprint);
+        }
+    }
+    return current;
+}
+export function staleHintDependencies(dependencies, current) {
+    if (!dependencies?.length || !current)
+        return [];
+    return dependencies.filter((dependency) => current.get(dependency.id) !== dependency.fingerprint);
+}
+/** Apply the same fail-closed freshness rule at review, inspection, and retrieval. */
+export function assessHintFreshness(input) {
+    const dependencies = input.dependencies ?? [];
+    const staleDependencies = dependencies.length > 0
+        ? staleHintDependencies(dependencies, input.currentDependencies ?? new Map())
+        : [];
+    const snapshotCurrent = Boolean(input.snapshotId)
+        && Boolean(input.currentSnapshotId)
+        && input.snapshotId === input.currentSnapshotId
+        && !input.currentSnapshotId.startsWith('unverified:');
+    const dependenciesCurrent = dependencies.length > 0 && staleDependencies.length === 0;
+    // v1/v2 approved hints predate snapshot/dependency provenance. Preserve their
+    // historical retrieval behavior; v3 lifecycle approval cannot create these.
+    const legacyUnversioned = dependencies.length === 0 && !input.snapshotId;
+    return {
+        snapshotCurrent,
+        dependenciesCurrent,
+        staleDependencies,
+        current: dependencies.length > 0 ? dependenciesCurrent : snapshotCurrent || legacyUnversioned,
+    };
+}
+function relationDependency(relation) {
+    const name = normalizeRelation(relation.relation);
+    return {
+        id: `relation:${name}`,
+        kind: 'relation',
+        name: relation.relation,
+        fingerprint: fingerprint({
+            relation: name,
+            objectKey: relation.objectKey,
+            source: relation.source,
+            columnCompleteness: relation.columnCompleteness,
+            columns: relation.columns
+                .map((column) => ({
+                name: column.name.toLowerCase(),
+                type: column.type?.toLowerCase(),
+                description: column.description,
+            }))
+                .sort((left, right) => left.name.localeCompare(right.name)),
+        }),
+    };
+}
+function objectDependency(object, kind = hintKindForObjectType(object.objectType) ?? 'semantic') {
+    return {
+        id: `${kind}:${object.objectKey}`,
+        kind,
+        name: object.fullName ?? object.name,
+        fingerprint: fingerprint({
+            objectKey: object.objectKey,
+            objectType: object.objectType,
+            name: object.name,
+            fullName: object.fullName,
+            domain: object.domain,
+            status: object.status,
+            description: object.description,
+            sourcePath: object.sourcePath,
+            payload: object.payload,
+        }),
+        sourcePath: object.sourcePath,
+    };
+}
+function findRelation(relations, referenced) {
+    const keys = relationKeys(referenced);
+    return relations.find((relation) => [...relationKeys(relation.relation)].some((key) => keys.has(key))
+        || [...relationKeys(relation.name)].some((key) => keys.has(key)));
+}
+function relationKeys(value) {
+    const normalized = normalizeRelation(value);
+    const parts = normalized.split('.');
+    return new Set([normalized, parts.at(-1) ?? normalized]);
+}
+function normalizeRelation(value) {
+    return value.replace(/["`\[\]]/g, '').trim().toLowerCase();
+}
+function objectNames(object) {
+    return [object.name, object.fullName, object.objectKey]
+        .filter((value) => Boolean(value));
+}
+function eq(left, right) {
+    return normalizeScopeName(left) === normalizeScopeName(right);
+}
+function normalizeScopeName(value) {
+    return value.trim().toLowerCase().replace(/^(block|metric|term|dbt_model|dbt_source|domain):/, '');
+}
+function hintKindForObjectType(objectType) {
+    const normalized = objectType.toLowerCase();
+    if (normalized === 'dbt_model' || normalized === 'dbt_source')
+        return 'dbt_model';
+    if (normalized.includes('metric'))
+        return 'metric';
+    if (normalized === 'domain' || normalized === 'domain_capsule')
+        return 'domain';
+    if (normalized === 'term' || normalized === 'dql_term')
+        return 'term';
+    if (normalized === 'block' || normalized === 'dql_block')
+        return 'block';
+    if (normalized.includes('semantic') || normalized === 'business_view')
+        return 'semantic';
+    return undefined;
+}
+const SCOPE_OBJECTS = [
+    ['metric', 'metric', ['metric', 'semantic_metric']],
+    ['dbtModel', 'dbt_model', ['dbt_model', 'dbt_source']],
+    ['domain', 'domain', ['domain', 'domain_capsule']],
+    ['term', 'term', ['term', 'dql_term']],
+    ['block', 'block', ['block', 'dql_block']],
+];
+function fingerprint(value) {
+    return createHash('sha256').update(stableStringify(value)).digest('hex');
+}
+function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .filter(([, item]) => item !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/hints/dependencies.js.map

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

package/dist/hints/git-store.d.ts

@@ -3,7 +3,7 @@
  *
  * Files (the source of truth, consistent with DQL):
  *   - `.dql/traces/<id>.trace.json`  — correction traces
- *   - `.dql/hints/<id>.hint.yaml`     — candidate / approved / rejected hints
+ *   - `.dql/hints/<id>.hint.yaml`     — candidate / approved / rejected / retired hints
  *   - `.dql/evaluations/<id>.hint-evaluation.yaml` — required evaluation results
  *   - `.dql/reviews/<id>.review.yaml` — human review decisions
  *
@@ -16,7 +16,7 @@
  *                            flips status, writes the review, and reindexes SQLite
  * Approved-only is enforced at retrieval; nothing here auto-applies a hint.
  */
-import type { CorrectionTrace, Hint, HintEvaluation, HintEvaluationCheck, HintReview, HintScope } from './types.js';
+import type { CorrectionTrace, Hint, HintEvaluation, HintEvaluationCheck, HintDependency, HintLifecycleFailure, HintReview, HintScope } from './types.js';
 export declare function tracesDir(projectRoot: string): string;
 export declare function hintsDir(projectRoot: string): string;
 export declare function evaluationsDir(projectRoot: string): string;
@@ -38,6 +38,10 @@ export interface RecordCorrectionTraceInput {
     snapshotId?: string;
     /** Stable evaluation name that must pass before approval. Required by v3. */
     requiredEvaluation?: string;
+    /** Exact governed inputs used to validate the correction. */
+    dependencies?: HintDependency[];
+    /** Fail-closed validation problems retained with the candidate. */
+    lifecycleErrors?: HintLifecycleFailure[];
     /** Override the derived candidate hint's title. */
     hintTitle?: string;
     /** Override the derived candidate hint's guidance (defaults to the correction). */
@@ -49,6 +53,8 @@ export interface RecordCorrectionTraceResult {
     trace: CorrectionTrace;
     hint: Hint;
 }
+export declare function correctionTraceFilePath(projectRoot: string, traceId: string): string;
+export declare function getCorrectionTraceFromGit(projectRoot: string, traceId: string): CorrectionTrace | null;
 /**
  * Record a Tier-2 correction as a Git trace + a derived **candidate** hint.
  * The hint is NOT usable until reviewed/approved.
@@ -94,12 +100,59 @@ export interface ReviewHintResult {
     hint: Hint;
     review: HintReview;
 }
+export interface UpdateHintCandidateInput {
+    hintId: string;
+    title?: string;
+    guidance?: string;
+    correctedSql?: string;
+    scope?: HintScope;
+    snapshotId: string;
+    dependencies: HintDependency[];
+    lifecycleErrors: HintLifecycleFailure[];
+}
+export declare function updateHintCandidate(projectRoot: string, input: UpdateHintCandidateInput): Hint;
 /**
  * Approve or reject a candidate hint. Writes the review record, flips the hint
  * file's status, and reindexes SQLite. Approval is the ONLY path that makes a
  * hint usable in normal retrieval.
  */
 export declare function reviewHint(projectRoot: string, input: ReviewHintInput): ReviewHintResult | null;
+export declare function retireHint(projectRoot: string, input: {
+    hintId: string;
+    reviewer: string;
+    note?: string;
+}): ReviewHintResult;
+export declare function reopenHint(projectRoot: string, input: {
+    hintId: string;
+    reviewer: string;
+    note?: string;
+    snapshotId: string;
+    dependencies: HintDependency[];
+    lifecycleErrors: HintLifecycleFailure[];
+}): ReviewHintResult;
+export declare function supersedeHint(projectRoot: string, input: {
+    hintId: string;
+    targetHintId: string;
+    reviewer: string;
+    note?: string;
+}): ReviewHintResult;
+export interface EnsureHintIndexFreshResult {
+    hintCount: number;
+    fingerprint: string;
+    rebuilt: boolean;
+}
+/**
+ * Content-address the Git-authoritative hint files together with the SQLite
+ * projection version. File names and bytes are stable across clones; absolute
+ * paths and filesystem timestamps are intentionally excluded.
+ */
+export declare function hintIndexProjectionFingerprint(projectRoot: string): string;
 /** Rebuild the SQLite hint index from the Git-authoritative files. */
 export declare function reindexHints(projectRoot: string, indexPath?: string): number;
+/**
+ * Bootstrap or refresh the local hint projection only when Git data or the
+ * projection schema changed. Safe to call whenever an OSS project is opened.
+ */
+export declare function ensureHintIndexFresh(projectRoot: string, indexPath?: string): EnsureHintIndexFreshResult;
+export declare function requiresEvaluatedApproval(projectRoot: string): boolean;
 //# sourceMappingURL=git-store.d.ts.map