@duckcodeailabs/dql-agent 1.13.1 → 1.13.2

package/dist/app-builder.d.ts

@@ -58,7 +58,7 @@ export interface AppPlanGenUi {
 export interface AppPlanFilter {
     id: string;
     label: string;
-    type: "date" | "daterange" | "select" | "string" | "number";
+    type: "date" | "daterange" | "select" | "search" | "string" | "number";
     default?: unknown;
     options?: string[];
     bindsTo?: string;
@@ -223,4 +223,22 @@ export declare const APP_BUILDER_SKILLS: AppBuilderSkill[];
 export declare function planAppFromPrompt(input: PlanAppFromPromptInput): AppPlan;
 export declare function validateAppPlan(plan: AppPlan, kg: KGStore): AppPlanValidationResult;
 export declare function generateAppFromPlan(projectRoot: string, plan: AppPlan, kg: KGStore, options?: GenerateAppFromPlanOptions): GeneratedAppPackage;
+/**
+ * Compile a validated AppPlan into typed App/dashboard documents without
+ * touching the user's project. App Studio uses this for AI proposal diffs;
+ * only the later Publish to Project service writes canonical App source.
+ */
+export declare function materializeAppPlanDocuments(plan: AppPlan, kg: KGStore, options?: GenerateAppFromPlanOptions): Pick<GeneratedAppPackage, "app" | "dashboards">;
+/**
+ * A tile title a stakeholder can read.
+ *
+ * A certified block's KG node name is its id — `monthly_revenue` — so using it
+ * directly labelled every AI-built tile with an identifier, which also made the
+ * titles look like system fields rather than something the author may rename.
+ * Prefer the lead clause of the block's own description, which authors already
+ * write as a summary ("Monthly gross order revenue and order count."), and fall
+ * back to the de-slugged id when that clause is missing or too long to sit in a
+ * tile header.
+ */
+export declare function humanTileTitle(name: string, description?: string): string;
 //# sourceMappingURL=app-builder.d.ts.map

package/dist/app-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-builder.d.ts","sourceRoot":"","sources":["../src/app-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-builder.d.ts","sourceRoot":"","sources":["../src/app-builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAE/B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAEhC,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;IAC1B,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,KAAK,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,2BAA2B,GAC3B,yBAAyB,GACzB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,cAAc,CAAC;AAEnB,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,WAAW,CAAC;AAEhB,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,oBAAoB,CAAC;AAEzB,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,KAAK,GACL,OAAO,GACP,WAAW,GACX,UAAU,GACV,OAAO,GACP,UAAU,GACV,WAAW,CAAC;AAEhB,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,eAAe,GACf,cAAc,GACd,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,WAAW,GACX,YAAY,GACZ,cAAc,GACd,eAAe,GACf,YAAY,GACZ,cAAc,GACd,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC;IAClC,oBAAoB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjD,qBAAqB,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IACpD,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC;IAC3C,YAAY,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,CAAC;IAC9D,cAAc,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC9C,iBAAiB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACpD,cAAc,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC/C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,eAAe,CAAC;QACtB,sBAAsB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACnD,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,eAAe,EAAE,qBAAqB,EAAE,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,YAAY,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAAC;IAC/C,YAAY,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAChD,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,iBAAiB,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,8FAA8F;IAC9F,iBAAiB,EAAE,UAAU,GAAG,gBAAgB,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,mBAAmB,EAAE,mBAAmB,EAAE,CAAC;IAC3C,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,WAAW,EAAE,eAAe,GAAG,aAAa,CAAC;QAC7C,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,qBAAqB,CAAC;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,KAAK,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;QACH,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,mBAAmB,EAAE,CAAC;QACrC,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,gBAAgB,EAAE,KAAK,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,iBAAiB,CAAC;KAC/B,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;sEAEkE;IAClE,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAqC/C,CAAC;AA8QF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAsPxE;AAiBD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,GACV,uBAAuB,CA4GzB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,EACX,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAuMrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,EACX,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,YAAY,CAAC,CAQjD;AAq7CD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzE"}

package/dist/app-builder.js

@@ -1,6 +1,7 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join, relative } from "node:path";
+import { tmpdir } from "node:os";
 import { parseAppDocument, parseDashboardDocument, suggestAppId, } from "@duckcodeailabs/dql-core";
 import { buildAnalysisQuestionPlan } from "./metadata/analysis-planner.js";
 import { certifiedFitAllowsTier1, evaluateCertifiedBlockFit } from "./metadata/block-fit.js";
@@ -36,13 +37,25 @@ export const APP_BUILDER_SKILLS = [
         description: "Keep generated analysis review-required and attach concrete next steps before stakeholder use.",
     },
 ];
-function appRequirementsForPrompt(prompt) {
+function appRequirementsForPrompt(prompt, certifiedNodes = []) {
     const analysis = buildAnalysisQuestionPlan(prompt);
     const measures = analysis.requestedShape.measures.length
         ? analysis.requestedShape.measures
         : analysis.metricTerms;
-    const dimensions = analysis.requestedShape.dimensions;
-    const filters = analysis.requestedShape.filters;
+    const explicitMembers = explicitMemberFilters(prompt);
+    const requestedDimensions = Array.from(new Set([
+        ...analysis.requestedShape.dimensions,
+        ...explicitMembers.map((member) => member.dimension),
+    ]));
+    const availableDimensions = Array.from(new Set(certifiedNodes.flatMap((node) => [
+        ...(node.dimensions ?? []),
+        ...(node.allowedFilters ?? []),
+    ]))).filter((dimension) => !/^(top_?n|limit)$/i.test(dimension));
+    const dimensions = requestedDimensions.length > 0 ? requestedDimensions : availableDimensions.slice(0, 3);
+    const filters = Array.from(new Set([
+        ...analysis.requestedShape.filters,
+        ...explicitMembers.map((member) => member.value),
+    ]));
     const ranking = analysis.requestedShape.topN
         ? { direction: analysis.requestedShape.rankingDirection ?? "top", limit: analysis.requestedShape.topN.n }
         : undefined;
@@ -56,18 +69,31 @@ function appRequirementsForPrompt(prompt) {
             grain: analysis.requestedShape.grain,
             ...(ranking ? { ranking } : {}),
         }];
-    const wantsTrend = analysis.mode === "trend" || /\btrend|over time|weekly|monthly|quarterly\b/i.test(prompt);
+    if (measures.length > 0 && requirements[0]?.role !== "kpi") {
+        requirements.unshift({
+            id: "headline",
+            question: `Headline ${measures.join(" and ")}`,
+            role: "kpi",
+            measures,
+            dimensions: [],
+            filters,
+        });
+    }
+    const sourceTimeDimension = availableDimensions.find((dimension) => /(_at$|_date$|_time$|^date$|^month$|^week$|^day$|quarter|year)/i.test(dimension));
+    const wantsTrend = Boolean(sourceTimeDimension) || analysis.mode === "trend" || /\btrend|over time|weekly|monthly|quarterly\b/i.test(prompt);
     if (wantsTrend && !requirements.some((requirement) => requirement.role === "trend")) {
         requirements.push({
             id: "trend",
             question: `${measures.join(" and ") || "primary metric"} over time`,
             role: "trend",
             measures,
-            dimensions: analysis.timeTerms.length ? analysis.timeTerms : ["time"],
+            dimensions: analysis.timeTerms.length ? analysis.timeTerms : [sourceTimeDimension ?? "time"],
             filters,
         });
     }
     for (const dimension of dimensions.slice(0, 2)) {
+        if (/(_at$|_date$|_time$|^date$|^month$|^week$|^day$|quarter|year)/i.test(dimension))
+            continue;
         if (requirements[0]?.dimensions.includes(dimension) && dimensions.length === 1)
             continue;
         requirements.push({
@@ -79,8 +105,25 @@ function appRequirementsForPrompt(prompt) {
             filters,
         });
     }
+    const detailDimensions = dimensions.filter((dimension) => !/(_at$|_date$|_time$|^date$|^month$|^week$|^day$|quarter|year)/i.test(dimension));
+    if ((ranking || detailDimensions.length > 0) && !requirements.some((requirement) => requirement.role === "detail")) {
+        requirements.push({
+            id: "detail",
+            question: `Detailed evidence for ${measures.join(" and ") || prompt}`,
+            role: "detail",
+            measures,
+            dimensions: detailDimensions.slice(0, 3),
+            filters,
+            grain: analysis.requestedShape.grain,
+            ...(ranking ? { ranking } : {}),
+        });
+    }
     return requirements;
 }
+function explicitMemberFilters(prompt) {
+    const matches = prompt.matchAll(/\bfor\s+([a-z0-9][a-z0-9_-]*)\s+((?:product\s+)?category|segment|status|region|channel|country|type)\b/gi);
+    return Array.from(matches, (match) => ({ value: match[1], dimension: match[2] }));
+}
 function certifiedCoverageForRequirement(requirement, nodes) {
     const plan = buildAnalysisQuestionPlan(requirement.question);
     const ranked = nodes.map((node) => ({
@@ -151,6 +194,12 @@ function semanticTileForRequirement(kg, requirement, domain, snapshotId) {
     if (!metric)
         return null;
     const semanticModelRefs = Array.from(new Set(modelNodes.map((node) => node.name))).slice(0, 4);
+    const semanticFilters = semanticFiltersForRequirement(requirement);
+    // A semantic fallback may close a filtered requirement only when every
+    // requested member is bound to a named dimension. Recording the filter in a
+    // fingerprint without applying it would make coverage untruthful.
+    if (requirement.filters.length > 0 && semanticFilters.length !== requirement.filters.length)
+        return null;
     const id = `semantic-${requirement.id}`;
     const fingerprintPayload = JSON.stringify({
         metric: metric.nodeId,
@@ -164,6 +213,7 @@ function semanticTileForRequirement(kg, requirement, domain, snapshotId) {
         provider: metric.provenance?.toLowerCase().includes("metricflow") ? "metricflow" : "native",
         metrics: [metric.name],
         ...(requirement.dimensions.length ? { dimensions: requirement.dimensions } : {}),
+        ...(semanticFilters.length ? { filters: semanticFilters } : {}),
         ...(requirement.ranking ? {
             orderBy: [{ field: metric.name, direction: requirement.ranking.direction === "bottom" ? "asc" : "desc" }],
             limit: requirement.ranking.limit,
@@ -189,6 +239,15 @@ function semanticTileForRequirement(kg, requirement, domain, snapshotId) {
         reviewStatus: "review_required",
         trustState: "review_required",
         rationale: "Governed semantic coverage for a requirement not fully covered by a compatible certified block.",
+        ...(semanticFilters.length ? {
+            filterBindings: semanticFilters.map((filter) => ({
+                filter: slugify(filter.field),
+                binding: filter.field,
+                mode: "semantic",
+                capability: "supported",
+                required: true,
+            })),
+        } : {}),
         sourceEvidence: [
             { source: metric.nodeId, nodeId: metric.nodeId, kind: metric.kind, reason: "Governed semantic metric; result review is still required", trustState: "review_required" },
             ...modelNodes.slice(0, 4).map((node) => ({ source: node.nodeId, nodeId: node.nodeId, kind: node.kind, reason: "Semantic model used by the canonical query", trustState: "review_required" })),
@@ -196,6 +255,39 @@ function semanticTileForRequirement(kg, requirement, domain, snapshotId) {
         reviewTasks: ["Review semantic definition freshness and result shape before stakeholder publication."],
     };
 }
+function semanticFiltersForRequirement(requirement) {
+    const question = requirement.question.toLowerCase();
+    return requirement.filters.flatMap((value) => {
+        const valueIndex = question.indexOf(value.toLowerCase());
+        if (valueIndex < 0)
+            return [];
+        const candidates = requirement.dimensions
+            .map((dimension) => ({
+            dimension,
+            index: question.indexOf(dimension.toLowerCase(), valueIndex + value.length),
+        }))
+            .filter((candidate) => candidate.index >= 0 && candidate.index - valueIndex <= 64)
+            .sort((left, right) => left.index - right.index);
+        const dimension = inferFilterFieldFromQuestion(requirement.question, value) ?? candidates[0]?.dimension;
+        if (!dimension)
+            return [];
+        return [{
+                field: slugify(dimension).replace(/-/g, "_"),
+                operator: "=",
+                value,
+            }];
+    });
+}
+function inferFilterFieldFromQuestion(question, value) {
+    const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const dimensionWord = /(category|type|segment|status|region|country|channel|customer|product|team|season|date|period)$/i;
+    const after = new RegExp(`${escaped}\\s+([a-z0-9_ -]{2,40})$`, "i").exec(question.trim())?.[1]?.trim();
+    if (after && dimensionWord.test(after))
+        return after;
+    const before = new RegExp(`([a-z0-9_ -]{2,40})\\s+${escaped}(?:\\s|$)`, "i").exec(question)?.[1]?.trim();
+    const beforeTail = before?.split(/\s+/).slice(-2).join(" ");
+    return beforeTail && dimensionWord.test(beforeTail) ? beforeTail : undefined;
+}
 export function planAppFromPrompt(input) {
     const prompt = input.prompt.trim();
     if (!prompt)
@@ -208,17 +300,22 @@ export function planAppFromPrompt(input) {
     const maxCertifiedTiles = input.maxCertifiedTiles ?? 4;
     const targetCertifiedTiles = Math.max(maxCertifiedTiles, input.preferredBlockIds?.length ?? 0);
     const preferredNodes = findPreferredCertifiedBlockNodes(input.kg, input.preferredBlockIds ?? []);
-    const matchedNodes = findCertifiedBlockNodes(input.kg, prompt, domain, Math.max(targetCertifiedTiles * 3, preferredNodes.length));
-    const certifiedNodes = dedupeCertifiedBlockNodes(mergeCertifiedBlockNodes(preferredNodes, matchedNodes), new Set(preferredNodes.map((node) => node.nodeId))).slice(0, targetCertifiedTiles);
+    const hasExplicitSelection = (input.preferredBlockIds?.length ?? 0) > 0;
+    const matchedNodes = hasExplicitSelection ? [] : findCertifiedBlockNodes(input.kg, prompt, domain, Math.max(targetCertifiedTiles * 3, preferredNodes.length));
+    // App Studio source review is an exact allow-list. Once the author chooses
+    // blocks, do not silently reintroduce an AI-ranked source they removed.
+    const certifiedNodes = dedupeCertifiedBlockNodes(hasExplicitSelection ? preferredNodes : mergeCertifiedBlockNodes(preferredNodes, matchedNodes), new Set(preferredNodes.map((node) => node.nodeId))).slice(0, targetCertifiedTiles);
     const contextNodes = findCertifiedContextNodes(input.kg, prompt, domain, 6);
     // Bind the global filter bar to what the certified tiles actually accept (their
     // declared allowedFilters), not prompt words — falling back to prompt inference
     // only when no tile declares any filter. Keeps the dashboard's filters dynamic.
     const promptFilters = inferFilters(prompt);
     const blockFilters = filtersFromCertifiedNodes(certifiedNodes);
-    const filters = blockFilters.length > 0 ? mergeAppFilters(blockFilters, promptFilters) : promptFilters;
+    let filters = blockFilters.length > 0 ? mergeAppFilters(blockFilters, promptFilters) : promptFilters;
     const candidateCertifiedTiles = certifiedNodes.map((node, index) => tileFromCertifiedNode(node, index, analysisIntent, filters));
-    const requirements = appRequirementsForPrompt(prompt);
+    const requirements = appRequirementsForPrompt(prompt, certifiedNodes);
+    const allowSemanticFallback = input.allowSemanticQueries !== false
+        && !promptExplicitlyUsesNamedCertifiedBlocks(prompt, certifiedNodes);
     const coverage = [];
     const selectedCertifiedIds = new Set();
     const semanticTiles = [];
@@ -238,7 +335,7 @@ export function planAppFromPrompt(input) {
             });
             continue;
         }
-        const semanticTile = input.allowSemanticQueries === false
+        const semanticTile = !allowSemanticFallback
             ? null
             : semanticTileForRequirement(input.kg, requirement, domain, input.snapshotId);
         if (semanticTile) {
@@ -263,6 +360,15 @@ export function planAppFromPrompt(input) {
             });
         }
     }
+    const semanticFilters = semanticTiles.flatMap((tile) => (tile.semantic?.filters ?? []).map((filter) => ({
+        id: slugify(filter.field),
+        label: titleCase(filter.field.replace(/[_.]+/g, " ")),
+        type: "select",
+        default: filter.value,
+        options: [String(filter.value)],
+        bindsTo: filter.field,
+    })));
+    filters = uniquePlanFilters([...filters, ...semanticFilters]);
     // Keep compatible certified context only. For legacy unshaped prompts, retain
     // the best certified candidates so existing simple App generation stays useful.
     // Requirement coverage is strict, while explicitly discovered certified
@@ -398,6 +504,21 @@ export function planAppFromPrompt(input) {
         },
     };
 }
+/**
+ * A user who explicitly names one or more certified blocks has selected the
+ * analytical contracts they want to use. Keep uncovered requirements visible
+ * instead of silently broadening that request with semantic fallbacks. Generic
+ * "governed sources" requests still retain certified-first semantic fallback.
+ */
+function promptExplicitlyUsesNamedCertifiedBlocks(prompt, nodes) {
+    if (!/\bcertified\b/i.test(prompt) || !/\bblocks?\b/i.test(prompt))
+        return false;
+    const normalizedPrompt = canonicalRequirementText(prompt);
+    return nodes.some((node) => {
+        const normalizedName = canonicalRequirementText(node.name).trim();
+        return normalizedName.split(/\s+/).length >= 2 && normalizedPrompt.includes(` ${normalizedName} `);
+    });
+}
 export function validateAppPlan(plan, kg) {
     const issues = [];
     let certifiedTiles = 0;
@@ -575,43 +696,52 @@ export function generateAppFromPlan(projectRoot, plan, kg, options = {}) {
             ? { copilot: { suggestedQuestions: options.copilotQuestions.slice(0, 8) } }
             : {}),
     };
-    const dashboards = plan.pages.map((page, pageIndex) => ({
-        version: 1,
-        id: page.id,
-        ...(options.narration && pageIndex === 0
-            ? { sections: buildStorySections(page.tiles, options.narration) }
-            : {}),
-        ...(pageIndex === 0 ? { story: plan.storyEvidencePlan } : {}),
-        metadata: {
-            title: page.title,
-            description: page.description ?? plan.planning.displayStrategy,
-            domain: plan.domain,
-            audience: plan.audience,
-            visibility: "private",
-            lifecycle: "draft",
-            tags: plan.tags,
-            businessOutcome: plan.planning.normalizedGoal,
-            businessOwner: plan.owner,
-            decisionUse: plan.planning.displayStrategy,
-            reviewCadence: inferReviewCadence(plan.prompt),
-            caveats: plan.caveats,
-        },
-        filters: page.filters.map((filter) => ({
-            id: filter.id,
-            type: filter.type,
-            default: filter.default,
-            ...(filter.options?.length ? { options: filter.options } : {}),
-            bindsTo: filter.bindsTo,
-        })),
-        layout: {
-            kind: "grid",
-            cols: 12,
-            rowHeight: 80,
-            items: options.narration && pageIndex === 0
-                ? buildStoryLayoutItems(page.tiles, options.narration)
-                : buildLayoutItems(page.tiles),
-        },
-    }));
+    const dashboards = plan.pages.map((page, pageIndex) => {
+        const items = options.narration && pageIndex === 0
+            ? buildStoryLayoutItems(page.tiles, options.narration)
+            : buildLayoutItems(page.tiles);
+        return {
+            version: 2,
+            id: page.id,
+            ...(options.narration && pageIndex === 0
+                ? { sections: buildStorySections(page.tiles, options.narration) }
+                : {}),
+            ...(pageIndex === 0 ? { story: plan.storyEvidencePlan } : {}),
+            metadata: {
+                title: page.title,
+                description: page.description ?? plan.planning.displayStrategy,
+                domain: plan.domain,
+                audience: plan.audience,
+                visibility: "private",
+                lifecycle: "draft",
+                tags: plan.tags,
+                businessOutcome: plan.planning.normalizedGoal,
+                businessOwner: plan.owner,
+                decisionUse: plan.planning.displayStrategy,
+                reviewCadence: inferReviewCadence(plan.prompt),
+                caveats: plan.caveats,
+            },
+            filters: page.filters.map((filter) => ({
+                id: filter.id,
+                label: filter.label,
+                type: filter.type,
+                default: filter.default,
+                ...(filter.options?.length ? { options: filter.options } : {}),
+                bindsTo: filter.bindsTo,
+                ...(filter.bindsTo ? { field: { name: filter.bindsTo } } : {}),
+                ...(filter.options?.length
+                    ? { optionSource: { mode: "static" } }
+                    : {}),
+            })),
+            layout: {
+                kind: "grid",
+                cols: 12,
+                rowHeight: 80,
+                items,
+                responsive: responsiveLayoutsForItems(items),
+            },
+        };
+    });
     const appValidation = parseAppDocument(JSON.stringify(app), join(appDir, "dql.app.json"));
     if (appValidation.errors.length > 0 || !appValidation.document) {
         throw new Error(`Generated app is invalid: ${appValidation.errors.map((e) => e.message).join("; ")}`);
@@ -640,10 +770,30 @@ export function generateAppFromPlan(projectRoot, plan, kg, options = {}) {
         ].map((path) => relative(projectRoot, path)),
     };
 }
+/**
+ * Compile a validated AppPlan into typed App/dashboard documents without
+ * touching the user's project. App Studio uses this for AI proposal diffs;
+ * only the later Publish to Project service writes canonical App source.
+ */
+export function materializeAppPlanDocuments(plan, kg, options = {}) {
+    const scratchRoot = mkdtempSync(join(tmpdir(), "dql-app-plan-"));
+    try {
+        const generated = generateAppFromPlan(scratchRoot, plan, kg, { ...options, overwrite: true });
+        return { app: generated.app, dashboards: generated.dashboards };
+    }
+    finally {
+        rmSync(scratchRoot, { recursive: true, force: true });
+    }
+}
 function findCertifiedBlockNodes(kg, prompt, domain, limit) {
     const hits = kg.search({
         query: prompt,
-        domain,
+        // `general` is the Studio's initial, unscoped page domain. Treating it as
+        // a literal KG domain hid every real project block from AI-created drafts
+        // until the author manually chose a domain. An unscoped draft must search
+        // the whole governed catalog; a concrete domain remains a hard preference
+        // with the existing cross-domain fallback below.
+        domain: domain === "general" ? undefined : domain,
         kinds: ["block"],
         limit: limit * 3,
     });
@@ -716,6 +866,14 @@ function dedupeCertifiedBlockNodes(nodes, preferredNodeIds = new Set()) {
             continue;
         }
         const current = selected[duplicateIndex];
+        // An explicit App Studio selection is author intent, not a search result.
+        // Keep both chosen blocks even when their business/topic fingerprints are
+        // similar; automatic discovery may still dedupe everything else.
+        if (preferredNodeIds.has(current.nodeId) && preferredNodeIds.has(node.nodeId)) {
+            signatureIndex.set(node.nodeId, selected.length);
+            selected.push(node);
+            continue;
+        }
         if (certifiedBlockSelectionScore(node, preferredNodeIds) > certifiedBlockSelectionScore(current, preferredNodeIds)) {
             selected[duplicateIndex] = node;
             signatureIndex.set(node.nodeId, duplicateIndex);
@@ -983,7 +1141,7 @@ function displayForCertifiedNode(node, viz, index, intent) {
         followUpActions,
         rationale,
         genUi: buildGenUiContract({
-            title: node.name,
+            title: humanTileTitle(node.name, node.description),
             role,
             viz,
             text,
@@ -1166,7 +1324,7 @@ function tileFromCertifiedNode(node, index, intent, globalFilters = []) {
     const parameterBindings = parameterBindingsForCertifiedNode(node, filterBindings);
     return {
         id: slugify(blockId) || `certified-${index + 1}`,
-        title: node.name,
+        title: humanTileTitle(blockId, node.description),
         kind: "certified_block",
         description: node.description,
         blockId,
@@ -1453,6 +1611,32 @@ function buildLayoutItems(tiles) {
         return item;
     });
 }
+function responsiveLayoutsForItems(items) {
+    return {
+        wide: { kind: "grid", cols: 12, rowHeight: 80, items },
+        medium: { kind: "grid", cols: 6, rowHeight: 80, items: projectItemsToColumns(items, 6) },
+        narrow: { kind: "grid", cols: 1, rowHeight: 80, items: projectItemsToColumns(items, 1) },
+    };
+}
+function projectItemsToColumns(items, cols) {
+    let x = 0;
+    let y = 0;
+    let rowHeight = 0;
+    return [...items]
+        .sort((left, right) => left.y - right.y || left.x - right.x)
+        .map((item) => {
+        const width = cols === 1 ? 1 : Math.min(cols, Math.max(2, Math.ceil(item.w / 2)));
+        if (x + width > cols) {
+            x = 0;
+            y += rowHeight || item.h;
+            rowHeight = 0;
+        }
+        const projected = { ...item, x, y, w: width };
+        x += width;
+        rowHeight = Math.max(rowHeight, item.h);
+        return projected;
+    });
+}
 function markdownForGeneratedPlanTile(tile) {
     const reviewTasks = tile.reviewTasks?.length
         ? tile.reviewTasks.map((task) => `- ${task}`).join("\n")
@@ -1795,12 +1979,15 @@ function uniquePlanFilters(filters) {
 }
 const APP_FILTER_TIME_RE = /(_at$|_date$|_time$|_ts$|^date$|^month$|^week$|^day$|ordered_at|created)/i;
 const APP_FILTER_NUMBER_RE = /(top[_-]?n|limit|count|amount|year|score|rank)/i;
+const APP_FILTER_SEARCH_RE = /(_name$|_id$|^name$|search|email)/i;
 /** Map a block filter column to the dashboard control the runtime filter engine renders. */
 function controlTypeForColumn(column) {
     if (APP_FILTER_TIME_RE.test(column))
         return "daterange";
     if (APP_FILTER_NUMBER_RE.test(column))
         return "number";
+    if (APP_FILTER_SEARCH_RE.test(column))
+        return "search";
     return "select"; // categorical → dropdown (options filled by /api/dashboard/filter-options)
 }
 /**
@@ -1961,6 +2148,29 @@ function cleanFieldHints(input) {
     }
     return Object.keys(out).length > 0 ? out : undefined;
 }
+/** Longest tile title we will lift out of a block description. */
+const MAX_DERIVED_TILE_TITLE = 48;
+/**
+ * A tile title a stakeholder can read.
+ *
+ * A certified block's KG node name is its id — `monthly_revenue` — so using it
+ * directly labelled every AI-built tile with an identifier, which also made the
+ * titles look like system fields rather than something the author may rename.
+ * Prefer the lead clause of the block's own description, which authors already
+ * write as a summary ("Monthly gross order revenue and order count."), and fall
+ * back to the de-slugged id when that clause is missing or too long to sit in a
+ * tile header.
+ */
+export function humanTileTitle(name, description) {
+    const lead = (description ?? "").split(/[.;]/)[0]?.trim() ?? "";
+    if (lead.length >= 3 && lead.length <= MAX_DERIVED_TILE_TITLE && /\s/.test(lead)) {
+        return lead.charAt(0).toUpperCase() + lead.slice(1);
+    }
+    const words = name.replace(/[_-]+/g, " ").trim();
+    if (!words)
+        return name;
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
 function titleCase(value) {
     return value
         .split(/\s+/)