@duckcodeailabs/dql-cli 1.6.4 → 1.6.6

package/dist/apps-api.d.ts

@@ -143,6 +143,19 @@ export declare function createAppPackage(projectRoot: string, input: AppCreateRe
     ok: false;
     error: string;
 };
+declare function selectedBlockContext(context: unknown): Record<string, unknown> | null;
+declare function buildPreviewMetricSnapshot(preview: Record<string, unknown>, fallbackTitle?: string): Record<string, unknown>;
+declare function buildPreviewDriverCards(preview: Record<string, unknown>, intent: LocalAppInvestigationIntent): Array<Record<string, unknown>>;
+declare function buildDeterministicInvestigationSql(projectRoot: string, input: {
+    question: string;
+    intent: LocalAppInvestigationIntent;
+    selected: Record<string, unknown> | null;
+    sourceBlockId?: string;
+}): {
+    sql: string;
+    sourceBlockPath: string;
+    sourceBlockName: string;
+} | undefined;
 declare function loadAppById(projectRoot: string, id: string): {
     app: AppDocument;
     dashboards: Array<{
@@ -187,5 +200,11 @@ export declare function previewNotebookForApp(projectRoot: string, appId: string
     status: number;
     error: string;
 };
+export declare const __test__: {
+    buildPreviewDriverCards: typeof buildPreviewDriverCards;
+    buildPreviewMetricSnapshot: typeof buildPreviewMetricSnapshot;
+    buildDeterministicInvestigationSql: typeof buildDeterministicInvestigationSql;
+    selectedBlockContext: typeof selectedBlockContext;
+};
 export {};
 //# sourceMappingURL=apps-api.d.ts.map

package/dist/apps-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apps-api.d.ts","sourceRoot":"","sources":["../src/apps-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apps-api.d.ts","sourceRoot":"","sources":["../src/apps-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAQL,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAOL,KAAK,2BAA2B,EACjC,MAAM,6BAA6B,CAAC;AAErC,UAAU,GAAG;IACX,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACnH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAqlB9D;AAID,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IACjD,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC;IAC3C,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;QAAC,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IACnJ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,iBAAS,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAuC5D;AAED,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAsDD,UAAU,iCAAiC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,2BAA2B,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,gCAAgC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,GAAG,cAAc,EAAE,CA6CtG;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CACN;IACE,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/B,GAAG,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAC/B,CA6CA;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,gBAAgB,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2HpI;AAwWD,iBAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ9E;AAkHD,iBAAS,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCrH;AAED,iBAAS,uBAAuB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,2BAA2B,GAClC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoChC;AA8BD,iBAAS,kCAAkC,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAoE/E;AAuqBD,iBAAS,WAAW,CAClB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT;IACD,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B,GAAG,IAAI,CA2BP;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC5C,UAAU,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,CA2BD;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBlH;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAwD/E;AA0TD,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAC"}

package/dist/apps-api.js

@@ -48,6 +48,7 @@ export async function handleAppsApi(ctx) {
                 sendJson(res, 400, { error: result.error });
                 return true;
             }
+            await refreshGeneratedMetadata(projectRoot);
             sendJson(res, 201, result);
         }
         catch (err) {
@@ -689,7 +690,7 @@ export async function generateAppPackage(projectRoot, input) {
     if (!prompt)
         return { ok: false, error: 'prompt is required' };
     const selectedBlockIds = unique((input.selectedBlockIds ?? []).map(cleanString).filter(Boolean));
-    const { KGStore, defaultKgPath, generateAppFromPlan, planAppFromPrompt, reindexProject, validateAppPlan, } = await import('@duckcodeailabs/dql-agent');
+    const { KGStore, defaultKgPath, generateAppFromPlan, ensureMetadataCatalogFresh, planAppFromPrompt, reindexProject, validateAppPlan, } = await import('@duckcodeailabs/dql-agent');
     const kgPath = defaultKgPath(projectRoot);
     await reindexProject(projectRoot, { kgPath });
     const kg = new KGStore(kgPath);
@@ -705,6 +706,7 @@ export async function generateAppPackage(projectRoot, input) {
         const generated = generateAppFromPlan(projectRoot, plan, kg, {
             overwrite: Boolean(input.force),
         });
+        await ensureMetadataCatalogFresh(projectRoot, { force: true });
         const app = collectAppsList(projectRoot).find((entry) => entry.id === plan.appId) ?? null;
         return {
             ok: true,
@@ -1063,13 +1065,28 @@ async function runAppInvestigation(ctx, storage, investigation, input = {}) {
         const previews = buildContextPreviews(selected);
         let metricSnapshot = buildMetricSnapshot(selected);
         let driverCards = buildDriverCards(selected, intent);
-        const agentGeneration = generatedSql
+        const baselineGap = intent === 'diagnose_change' && hasSelectedRows(selected) && !hasComparableTimeBaseline(selected);
+        const metadataOnly = intent === 'trust_gap_review';
+        if (metadataOnly)
+            generatedSql = '';
+        const sourceTileId = investigation.sourceTileId ?? selectedContextString(context, 'tileId');
+        const sourceBlockId = investigation.sourceBlockId ?? selectedContextString(context, 'blockId');
+        const deterministicGeneration = generatedSql || baselineGap || metadataOnly
+            ? undefined
+            : buildDeterministicInvestigationSql(ctx.projectRoot, {
+                question,
+                intent,
+                selected,
+                sourceBlockId,
+            });
+        generatedSql = generatedSql || deterministicGeneration?.sql;
+        const agentGeneration = generatedSql || baselineGap || metadataOnly
             ? undefined
             : await generateInvestigationSql(ctx, {
                 appId: investigation.appId,
                 dashboardId: investigation.dashboardId ?? selectedString(context, 'dashboardId'),
-                sourceTileId: investigation.sourceTileId ?? selectedContextString(context, 'tileId'),
-                sourceBlockId: investigation.sourceBlockId ?? selectedContextString(context, 'blockId'),
+                sourceTileId,
+                sourceBlockId,
                 title: investigation.title,
                 question,
                 intent,
@@ -1079,7 +1096,7 @@ async function runAppInvestigation(ctx, storage, investigation, input = {}) {
         const generationError = cleanString(agentGeneration?.executionError);
         const sqlEvidence = agentGeneration?.result
             ? { preview: buildGeneratedSqlPreview(agentGeneration.result, generatedSql), error: generationError || undefined }
-            : await runGeneratedSqlPreview(ctx, generatedSql);
+            : metadataOnly ? {} : await runGeneratedSqlPreview(ctx, generatedSql);
         const sqlError = sqlEvidence.error ?? generationError;
         if (sqlEvidence.preview) {
             previews.unshift(sqlEvidence.preview);
@@ -1095,6 +1112,10 @@ async function runAppInvestigation(ctx, storage, investigation, input = {}) {
                 generatedSql: generatedSql || undefined,
                 sqlExecuted: Boolean(sqlEvidence.preview),
                 sqlError,
+                generationSource: baselineGap ? 'missing_baseline' : deterministicGeneration ? 'selected_block_metadata' : agentGeneration?.providerUsed ? 'ai_provider' : generatedSql ? 'provided_sql' : 'context_only',
+                baselineGap,
+                sourceBlockPath: deterministicGeneration?.sourceBlockPath,
+                sourceBlockName: deterministicGeneration?.sourceBlockName,
                 providerUsed: agentGeneration?.providerUsed,
             },
             certifiedContext: {
@@ -1102,18 +1123,26 @@ async function runAppInvestigation(ctx, storage, investigation, input = {}) {
                 appName: appInfo?.app.name,
                 dashboardId: investigation.dashboardId,
                 dashboardTitle: selectedString(context, 'dashboardTitle'),
-                sourceTileId: investigation.sourceTileId ?? selectedContextString(context, 'tileId'),
-                sourceBlockId: investigation.sourceBlockId ?? selectedContextString(context, 'blockId'),
+                sourceTileId,
+                sourceBlockId,
+                sourceBlockPath: deterministicGeneration?.sourceBlockPath ?? selectedString(selected, 'blockPath'),
                 certificationStatus: selectedString(selected, 'certificationStatus'),
             },
-            assumptions: investigationAssumptions(intent, selected, generatedSql, sqlError),
+            assumptions: [
+                ...investigationAssumptions(intent, selected, generatedSql, sqlError),
+                ...(baselineGap ? ['The selected tile sample does not include at least two comparable time values, so DQL did not invent a change query from an unrelated table.'] : []),
+            ],
             context,
             agentEvidence: agentGeneration?.evidence,
             analysisPlan: agentGeneration?.analysisPlan,
             citations: agentGeneration?.citations,
         };
-        const summary = cleanString(agentGeneration?.answer) || buildInvestigationSummary(intent, question, selected, metricSnapshot, driverCards);
-        const recommendation = buildInvestigationRecommendation(intent, selected, sqlError);
+        const summary = cleanString(agentGeneration?.answer) || (baselineGap
+            ? buildMissingBaselineSummary(question, selected)
+            : buildInvestigationSummary(intent, question, selected, metricSnapshot, driverCards));
+        const recommendation = baselineGap
+            ? buildMissingBaselineRecommendation(selected)
+            : buildInvestigationRecommendation(intent, selected, sqlError);
         return storage.updateAppInvestigation(investigation.id, {
             title: cleanString(input.question) ? titleFromInvestigation(question, selected) : investigation.title,
             question,
@@ -1174,7 +1203,14 @@ function safeIntentContext(context) {
 }
 function selectedBlockContext(context) {
     const root = asRecord(context);
-    return asRecord(root?.selectedBlock);
+    const selected = asRecord(root?.selectedBlock);
+    if (selected)
+        return selected;
+    if (!root)
+        return null;
+    const hasSelectedTileContext = ['blockId', 'blockPath', 'tileId', 'certificationStatus', 'resultSample', 'rowCount']
+        .some((key) => root[key] !== undefined && root[key] !== null);
+    return hasSelectedTileContext ? root : null;
 }
 function selectedContextString(context, key) {
     return selectedString(selectedBlockContext(context), key);
@@ -1226,6 +1262,24 @@ function buildMetricSnapshot(selected) {
         context: selectedString(selected, 'title') ?? 'Selected dashboard tile',
     };
 }
+function hasSelectedRows(selected) {
+    return selectedRows(selected).length > 0;
+}
+function hasComparableTimeBaseline(selected) {
+    const rows = selectedRows(selected);
+    if (rows.length < 2)
+        return false;
+    const columns = selectedColumns(selected, rows);
+    const profile = profileResultColumns(columns, rows);
+    const timeDimension = chooseTimeDimension(profile);
+    if (!timeDimension)
+        return false;
+    const values = new Set(rows
+        .map((row) => row[timeDimension.name])
+        .filter((value) => value !== null && value !== undefined && String(value).trim())
+        .map((value) => String(value)));
+    return values.size >= 2;
+}
 function buildDriverCards(selected, intent) {
     const rows = selectedRows(selected);
     const columns = selectedColumns(selected, rows);
@@ -1274,7 +1328,8 @@ function buildPreviewMetricSnapshot(preview, fallbackTitle) {
         };
     }
     const currentColumn = pickColumn(numericColumns, [/^current_/i, /current.*(revenue|value|amount|total|orders?)/i])
-        ?? pickColumn(numericColumns, [/(revenue|value|amount|total|orders?|count)$/i])
+        ?? pickColumn(numericColumns, [/^total_/i, /(revenue|value|amount|total|orders?|points?|goals?|assists?|rebounds?|score|games_played)$/i])
+        ?? pickColumn(numericColumns, [/(count|row_count)$/i])
         ?? numericColumns[0];
     const baselineColumn = pickColumn(numericColumns, [/^baseline_/i, /baseline.*(revenue|value|amount|total|orders?)/i]);
     const deltaColumn = pickColumn(numericColumns, [/(delta|change|variance|diff|contribution)/i]);
@@ -1302,7 +1357,8 @@ function buildPreviewDriverCards(preview, intent) {
     }
     const numericColumns = columns.filter((column) => rows.some((row) => typeofNumber(row[column]) !== null));
     const contributionColumn = pickColumn(numericColumns, [/(delta|change|variance|diff|contribution)/i])
-        ?? pickColumn(numericColumns, [/^current_/i, /(revenue|value|amount|total|orders?|count)$/i])
+        ?? pickColumn(numericColumns, [/^current_/i, /^total_/i, /(revenue|value|amount|total|orders?|points?|goals?|assists?|rebounds?|score|games_played)$/i])
+        ?? pickColumn(numericColumns, [/(count|row_count)$/i])
         ?? numericColumns[0];
     const dimensionColumn = columns.find((column) => column !== contributionColumn && rows.some((row) => typeof row[column] === 'string'));
     if (!contributionColumn) {
@@ -1355,6 +1411,229 @@ function sumNumericRows(rows, column) {
     }
     return found ? total : null;
 }
+function buildDeterministicInvestigationSql(projectRoot, input) {
+    if (input.intent === 'trust_gap_review')
+        return undefined;
+    const block = resolveSelectedBlock(projectRoot, input.selected, input.sourceBlockId);
+    if (!block)
+        return undefined;
+    const source = readFileSync(join(projectRoot, block.path), 'utf-8');
+    const blockSql = extractDqlQuery(source);
+    if (!blockSql || /\{\{/.test(blockSql) || !isReadOnlySql(blockSql))
+        return undefined;
+    const rows = selectedRows(input.selected);
+    const columns = selectedColumns(input.selected, rows);
+    const sourceSql = stripTopLevelOrderAndLimit(blockSql);
+    const profile = profileResultColumns(columns, rows);
+    const measure = chooseMeasureColumn(profile);
+    if (!measure)
+        return undefined;
+    const dimension = chooseDimensionColumn(input.question, profile, input.intent);
+    const sourceCte = `WITH dql_source AS (\n${sourceSql}\n)`;
+    if (input.intent === 'entity_drilldown') {
+        const entity = inferEntityFilter(input.question, profile, rows);
+        const orderBy = `ORDER BY ${quoteSqlIdentifier(measure.name)} DESC`;
+        const where = entity ? `\nWHERE ${quoteSqlIdentifier(entity.column)} IS NOT NULL AND LOWER(CAST(${quoteSqlIdentifier(entity.column)} AS VARCHAR)) LIKE ${sqlStringLiteral(`%${entity.value.toLowerCase()}%`)}` : '';
+        return {
+            sql: `${sourceCte}\nSELECT *\nFROM dql_source${where}\n${orderBy}\nLIMIT 100`,
+            sourceBlockPath: block.path,
+            sourceBlockName: block.name,
+        };
+    }
+    if (input.intent === 'anomaly_investigation' || input.intent === 'diagnose_change') {
+        const timeDimension = chooseTimeDimension(profile) ?? dimension;
+        const rankExpr = `${measureAgg(measure)}(${quoteSqlIdentifier(measure.name)})`;
+        if (timeDimension) {
+            return {
+                sql: [
+                    sourceCte,
+                    ', dql_trend AS (',
+                    `  SELECT ${quoteSqlIdentifier(timeDimension.name)} AS ${quoteSqlIdentifier(timeDimension.name)}, ${rankExpr} AS ${quoteSqlIdentifier(measure.name)}`,
+                    '  FROM dql_source',
+                    `  GROUP BY ${quoteSqlIdentifier(timeDimension.name)}`,
+                    '), dql_deltas AS (',
+                    `  SELECT ${quoteSqlIdentifier(timeDimension.name)}, ${quoteSqlIdentifier(measure.name)}, LAG(${quoteSqlIdentifier(measure.name)}) OVER (ORDER BY ${quoteSqlIdentifier(timeDimension.name)}) AS baseline_${safeAlias(measure.name)}`,
+                    '  FROM dql_trend',
+                    ')',
+                    `SELECT *, ${quoteSqlIdentifier(measure.name)} - baseline_${safeAlias(measure.name)} AS delta_${safeAlias(measure.name)}`,
+                    'FROM dql_deltas',
+                    `ORDER BY ABS(COALESCE(delta_${safeAlias(measure.name)}, 0)) DESC`,
+                    'LIMIT 20',
+                ].join('\n'),
+                sourceBlockPath: block.path,
+                sourceBlockName: block.name,
+            };
+        }
+    }
+    if (!dimension)
+        return undefined;
+    const aggregate = `${measureAgg(measure)}(${quoteSqlIdentifier(measure.name)})`;
+    const label = quoteSqlIdentifier(dimension.name);
+    return {
+        sql: [
+            sourceCte,
+            `SELECT ${label} AS ${label}, ${aggregate} AS ${quoteSqlIdentifier(measure.name)}, COUNT(*) AS ${quoteSqlIdentifier('row_count')}`,
+            'FROM dql_source',
+            `GROUP BY ${label}`,
+            `ORDER BY ABS(COALESCE(${quoteSqlIdentifier(measure.name)}, 0)) DESC`,
+            'LIMIT 20',
+        ].join('\n'),
+        sourceBlockPath: block.path,
+        sourceBlockName: block.name,
+    };
+}
+function resolveSelectedBlock(projectRoot, selected, sourceBlockId) {
+    const selectedPath = selectedString(selected, 'blockPath');
+    const candidates = collectBlockCandidates(projectRoot);
+    if (selectedPath) {
+        const normalizedPath = selectedPath.replace(/^\/+/, '');
+        const found = candidates.find((block) => block.path === normalizedPath);
+        if (found)
+            return found;
+        if (normalizedPath.startsWith('blocks/') && existsSync(join(projectRoot, normalizedPath))) {
+            const source = readFileSync(join(projectRoot, normalizedPath), 'utf-8');
+            const name = matchString(source, /block\s+"([^"]+)"/) ?? titleFromPath(normalizedPath);
+            return {
+                id: name,
+                name,
+                domain: matchString(source, /domain\s*=\s*"([^"]+)"/) ?? 'uncategorized',
+                status: matchString(source, /status\s*=\s*"([^"]+)"/) ?? 'draft',
+                owner: matchString(source, /owner\s*=\s*"([^"]+)"/),
+                tags: matchArray(source, /tags\s*=\s*\[([^\]]*)\]/),
+                path: normalizedPath,
+                lastModified: statSyncSafe(join(projectRoot, normalizedPath))?.mtime.toISOString() ?? new Date(0).toISOString(),
+                description: matchString(source, /description\s*=\s*"((?:[^"\\]|\\.)*)"/) ?? '',
+                llmContext: matchString(source, /llmContext\s*=\s*"((?:[^"\\]|\\.)*)"/),
+                chartType: matchString(source, /chart\s*=\s*"([^"]+)"/) ?? undefined,
+                score: 0,
+                reasons: [],
+            };
+        }
+    }
+    const id = cleanString(sourceBlockId) || selectedString(selected, 'blockId');
+    if (!id)
+        return undefined;
+    return candidates.find((block) => block.id === id || block.name === id || block.path === id);
+}
+function profileResultColumns(columns, rows) {
+    return columns.map((name) => {
+        const lower = name.toLowerCase();
+        const numeric = rows.length === 0 ? !isLikelyTextColumn(lower) : rows.some((row) => typeofNumber(row[name]) !== null);
+        const text = rows.some((row) => typeof row[name] === 'string' && String(row[name]).trim().length > 0);
+        const time = /\b(season|year|month|week|quarter|date|day)\b/i.test(lower);
+        const identifier = /\b(id|key|uuid|number)\b/i.test(lower) && !time;
+        const measureName = /\b(total|sum|amount|revenue|sales|points?|goals?|assists?|rebounds?|count|avg|average|rate|pct|percent|score|value|delta|change|variance)\b/i.test(lower);
+        const dimensionName = /\b(name|type|segment|region|market|category|status|player|customer|account|team|season|year|month|week|quarter|date)\b/i.test(lower);
+        const measure = numeric && measureName && !identifier && !time;
+        const dimension = !measure && (text || time || dimensionName || !numeric);
+        return { name, lower, numeric, text, dimension, measure, time };
+    });
+}
+function chooseMeasureColumn(columns) {
+    const candidates = columns.filter((column) => column.measure);
+    return candidates.find((column) => /\b(delta|change|variance|contribution)\b/i.test(column.lower))
+        ?? candidates.find((column) => /\b(total_points|total_revenue|total_amount|total|revenue|amount|sales|points|goals)\b/i.test(column.lower))
+        ?? candidates.find((column) => /\b(count|value|score|avg|average|rate|pct|percent)\b/i.test(column.lower))
+        ?? columns.find((column) => column.numeric && !column.dimension);
+}
+function chooseDimensionColumn(question, columns, intent) {
+    const dimensions = columns.filter((column) => column.dimension);
+    const questionTokens = new Set(question.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean));
+    const mentioned = dimensions.find((column) => column.lower.split(/[^a-z0-9]+/).some((token) => questionTokens.has(token)));
+    if (mentioned)
+        return mentioned;
+    const timeDimension = chooseTimeDimension(columns);
+    if ((intent === 'diagnose_change' || intent === 'segment_compare' || intent === 'anomaly_investigation') && timeDimension)
+        return timeDimension;
+    return dimensions.find((column) => column.text && !column.time)
+        ?? timeDimension
+        ?? dimensions[0];
+}
+function chooseTimeDimension(columns) {
+    return columns.find((column) => column.time);
+}
+function inferEntityFilter(question, columns, rows) {
+    const textDimensions = columns.filter((column) => column.dimension && (column.text || /\b(name|player|customer|account|team)\b/i.test(column.lower)));
+    const lowerQuestion = question.toLowerCase();
+    for (const column of textDimensions) {
+        for (const row of rows) {
+            const value = cleanString(row[column.name]);
+            if (value && lowerQuestion.includes(value.toLowerCase()))
+                return { column: column.name, value };
+        }
+    }
+    const named = question.match(/\b([A-Z][a-z]+(?:\s+[A-Z][a-z]+)+)\b/);
+    const value = named?.[1]?.trim();
+    const column = textDimensions[0];
+    return value && column ? { column: column.name, value } : undefined;
+}
+function measureAgg(column) {
+    return /\b(avg|average|rate|pct|percent|per_)\b/i.test(column.lower) ? 'AVG' : 'SUM';
+}
+function extractDqlQuery(source) {
+    const tripleQuoteMatch = source.match(/query\s*=\s*"""([\s\S]*?)"""/i);
+    if (tripleQuoteMatch)
+        return tripleQuoteMatch[1].trim() || null;
+    const singleQuoteMatch = source.match(/query\s*=\s*"((?:[^"\\]|\\.)*)"/i);
+    if (singleQuoteMatch)
+        return singleQuoteMatch[1].replace(/\\"/g, '"').trim() || null;
+    return null;
+}
+function stripTopLevelOrderAndLimit(sql) {
+    let next = sql.trim().replace(/;+\s*$/g, '');
+    const limitIndex = findLastTopLevelKeyword(next, 'limit');
+    if (limitIndex >= 0 && /^\s+limit\s+\d+\s*$/i.test(next.slice(limitIndex))) {
+        next = next.slice(0, limitIndex).trim();
+    }
+    const orderIndex = findLastTopLevelKeyword(next, 'order by');
+    if (orderIndex >= 0)
+        next = next.slice(0, orderIndex).trim();
+    return next;
+}
+function findLastTopLevelKeyword(sql, keyword) {
+    const lower = sql.toLowerCase();
+    const target = keyword.toLowerCase();
+    let depth = 0;
+    let quote = null;
+    let last = -1;
+    for (let i = 0; i < lower.length; i += 1) {
+        const char = lower[i];
+        if (quote) {
+            if (char === quote && lower[i - 1] !== '\\')
+                quote = null;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === '`') {
+            quote = char;
+            continue;
+        }
+        if (char === '(')
+            depth += 1;
+        if (char === ')')
+            depth = Math.max(0, depth - 1);
+        if (depth === 0 && lower.startsWith(target, i) && isKeywordBoundary(lower, i - 1) && isKeywordBoundary(lower, i + target.length)) {
+            last = i;
+        }
+    }
+    return last;
+}
+function isKeywordBoundary(value, index) {
+    if (index < 0 || index >= value.length)
+        return true;
+    return /[^a-z0-9_]/i.test(value[index]);
+}
+function quoteSqlIdentifier(identifier) {
+    return `"${identifier.replace(/"/g, '""')}"`;
+}
+function sqlStringLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+function safeAlias(identifier) {
+    return identifier.replace(/[^a-z0-9_]+/gi, '_').replace(/^_+|_+$/g, '') || 'value';
+}
+function isLikelyTextColumn(value) {
+    return /\b(name|type|segment|region|market|category|status|player|customer|account|team)\b/i.test(value);
+}
 async function generateInvestigationSql(ctx, input) {
     if (!ctx.generateInvestigationSql)
         return undefined;
@@ -1432,13 +1711,26 @@ function buildGeneratedSqlPreview(result, generatedSql) {
     };
 }
 function isReadOnlySql(sql) {
-    const trimmed = sql.trim().replace(/;+\s*$/g, '');
+    const trimmed = stripLeadingSqlComments(sql).replace(/;+\s*$/g, '');
     if (!/^(select|with)\b/i.test(trimmed))
         return false;
     if (/;\s*\S/.test(trimmed))
         return false;
     return !/\b(insert|update|delete|merge|drop|alter|create|truncate|copy|grant|revoke|call|execute|attach|detach)\b/i.test(trimmed);
 }
+function stripLeadingSqlComments(sql) {
+    let next = sql.trim();
+    while (next.startsWith('--') || next.startsWith('/*')) {
+        if (next.startsWith('--')) {
+            const lineEnd = next.indexOf('\n');
+            next = lineEnd >= 0 ? next.slice(lineEnd + 1).trimStart() : '';
+            continue;
+        }
+        const blockEnd = next.indexOf('*/');
+        next = blockEnd >= 0 ? next.slice(blockEnd + 2).trimStart() : '';
+    }
+    return next;
+}
 function boundedPreviewSql(sql) {
     return `SELECT * FROM (${sql.trim().replace(/;+\s*$/g, '')}) AS dql_research_preview LIMIT 100`;
 }
@@ -1487,6 +1779,14 @@ function buildInvestigationSummary(intent, question, selected, metrics, drivers)
     const driver = drivers[0]?.title ? ` Top visible driver in the current evidence is ${drivers[0].title}.` : '';
     return `DQL opened a review-required investigation for ${target}: ${question}.${delta}${driver}`;
 }
+function buildMissingBaselineSummary(question, selected) {
+    const target = selectedString(selected, 'title') ?? 'the selected tile';
+    return `DQL opened a review-required investigation for ${target}: ${question}. The selected tile shows the current certified result, but its sample does not include a comparable prior period or historical snapshot, so DQL cannot calculate what changed without guessing.`;
+}
+function buildMissingBaselineRecommendation(selected) {
+    const target = selectedString(selected, 'title') ?? 'this tile';
+    return `Use ${target} as current-state evidence. To explain change, add or select a block with a time grain, snapshot date, or prior-period baseline, then rerun the investigation.`;
+}
 function buildInvestigationRecommendation(intent, selected, sqlError) {
     if (sqlError)
         return 'Review the generated SQL or add a certified drilldown block before promoting this result.';
@@ -1525,7 +1825,11 @@ function titleFromInvestigation(question, selected) {
     return base.replace(/\s+/g, ' ').slice(0, 90);
 }
 function selectedRows(selected) {
-    const rows = Array.isArray(selected?.sampleRows) ? selected?.sampleRows : selected?.rows;
+    const rows = Array.isArray(selected?.sampleRows)
+        ? selected?.sampleRows
+        : Array.isArray(selected?.resultSample)
+            ? selected?.resultSample
+            : selected?.rows;
     if (!Array.isArray(rows))
         return [];
     return rows.map(asRecord).filter((row) => Boolean(row)).slice(0, 100);
@@ -2187,6 +2491,16 @@ function activatePersona(projectRoot, userId, appId) {
     return null;
 }
 // ---- IO utilities ----
+async function refreshGeneratedMetadata(projectRoot) {
+    try {
+        const { ensureMetadataCatalogFresh } = await import('@duckcodeailabs/dql-agent');
+        await ensureMetadataCatalogFresh(projectRoot, { force: true });
+    }
+    catch {
+        // App files remain the source of truth; the local catalog refreshes again
+        // on the next agent/MCP call if this best-effort update fails.
+    }
+}
 function sendJson(res, status, body) {
     res.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' });
     res.end(JSON.stringify(body));
@@ -2209,6 +2523,12 @@ async function readJson(req) {
         req.on('error', reject);
     });
 }
+export const __test__ = {
+    buildPreviewDriverCards,
+    buildPreviewMetricSnapshot,
+    buildDeterministicInvestigationSql,
+    selectedBlockContext,
+};
 // reference unused parseAppDocument/readFileSync to keep import stable for forward use
 void parseAppDocument;
 void readFileSync;