@duckcodeailabs/dql-agent 1.6.34 → 1.7.1

package/dist/app-builder.d.ts

@@ -1,8 +1,31 @@
-import { type AppDocument, type DashboardDocument, type DashboardTileFilterBinding, type DashboardTileParameterBinding, type DashboardTileSourceEvidence, type DashboardVizConfig } from "@duckcodeailabs/dql-core";
+import { type AppDocument, type DashboardDocument, type DashboardSemanticQueryRef, type DashboardStoryEvidencePlan, type DashboardTileFilterBinding, type DashboardTileParameterBinding, type DashboardTileSourceEvidence, type DashboardVizConfig } from "@duckcodeailabs/dql-core";
 import type { KGStore } from "./kg/sqlite-fts.js";
 import type { NarrateResult } from "./narrate.js";
+export type AppMode = "personal" | "stakeholder";
+export interface AppRequirement {
+    id: string;
+    question: string;
+    role: "kpi" | "trend" | "breakdown" | "detail";
+    measures: string[];
+    dimensions: string[];
+    filters: string[];
+    grain?: string;
+    ranking?: {
+        direction: "top" | "bottom";
+        limit: number;
+    };
+}
+export interface RequirementCoverage {
+    requirementId: string;
+    status: "covered" | "gap";
+    source: "certified_block" | "semantic_query" | "gap";
+    tileId?: string;
+    sourceId?: string;
+    trustState: AppPlanTrustState;
+    reasons: string[];
+}
 export type AppBuilderSkillId = "interpret_business_intent" | "match_certified_context" | "shape_business_story" | "design_dashboard_layout" | "draft_missing_sections" | "route_review";
-export type AppPlanTileKind = "certified_block" | "draft_placeholder" | "narrative";
+export type AppPlanTileKind = "certified_block" | "semantic_query" | "draft_placeholder" | "narrative";
 export type AppPlanAnalysisIntent = "executive_summary" | "metric_monitoring" | "driver_analysis" | "entity_drilldown" | "trust_review" | "data_quality" | "experiment_readout";
 export type AppPlanTileRole = "business_summary" | "kpi" | "trend" | "breakdown" | "evidence" | "trust" | "research" | "narrative";
 export type AppPlanTrustState = "certified" | "review_required" | "draft_ready";
@@ -46,6 +69,8 @@ export interface AppPlanTile {
     kind: AppPlanTileKind;
     description?: string;
     blockId?: string;
+    semantic?: DashboardSemanticQueryRef;
+    requirementIds?: string[];
     sourceNodeId?: string;
     viz: DashboardVizConfig["type"];
     certification: "certified" | "uncertified";
@@ -98,7 +123,12 @@ export interface AppBuilderSkill {
     description: string;
 }
 export interface AppPlan {
-    version: 1;
+    version: 2;
+    mode: AppMode;
+    snapshotId?: string;
+    requirements: AppRequirement[];
+    requirementCoverage: RequirementCoverage[];
+    storyEvidencePlan: DashboardStoryEvidencePlan;
     appId: string;
     name: string;
     prompt: string;
@@ -158,6 +188,9 @@ export interface PlanAppFromPromptInput {
     preferredBlockIds?: string[];
     maxCertifiedTiles?: number;
     plannerMode?: "deterministic" | "ai_assisted";
+    mode?: AppMode;
+    snapshotId?: string;
+    allowSemanticQueries?: boolean;
 }
 export interface AppPlanValidationIssue {
     level: "error" | "warning";

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":"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"}

package/dist/app-builder.js

@@ -1,6 +1,9 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { join, relative } from "node:path";
 import { parseAppDocument, parseDashboardDocument, suggestAppId, } from "@duckcodeailabs/dql-core";
+import { buildAnalysisQuestionPlan } from "./metadata/analysis-planner.js";
+import { certifiedFitAllowsTier1, evaluateCertifiedBlockFit } from "./metadata/block-fit.js";
 export const APP_BUILDER_SKILLS = [
     {
         id: "interpret_business_intent",
@@ -33,6 +36,163 @@ export const APP_BUILDER_SKILLS = [
         description: "Keep generated analysis review-required and attach concrete next steps before stakeholder use.",
     },
 ];
+function appRequirementsForPrompt(prompt) {
+    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 ranking = analysis.requestedShape.topN
+        ? { direction: analysis.requestedShape.rankingDirection ?? "top", limit: analysis.requestedShape.topN.n }
+        : undefined;
+    const requirements = [{
+            id: "primary",
+            question: prompt,
+            role: ranking ? "detail" : dimensions.length ? "breakdown" : "kpi",
+            measures,
+            dimensions,
+            filters,
+            grain: analysis.requestedShape.grain,
+            ...(ranking ? { ranking } : {}),
+        }];
+    const wantsTrend = 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"],
+            filters,
+        });
+    }
+    for (const dimension of dimensions.slice(0, 2)) {
+        if (requirements[0]?.dimensions.includes(dimension) && dimensions.length === 1)
+            continue;
+        requirements.push({
+            id: `by-${slugify(dimension)}`,
+            question: `${measures.join(" and ") || "primary metric"} by ${dimension}`,
+            role: "breakdown",
+            measures,
+            dimensions: [dimension],
+            filters,
+        });
+    }
+    return requirements;
+}
+function certifiedCoverageForRequirement(requirement, nodes) {
+    const plan = buildAnalysisQuestionPlan(requirement.question);
+    const ranked = nodes.map((node) => ({
+        node,
+        fit: evaluateCertifiedBlockFit({ question: requirement.question, plan, block: node }),
+        requirementFit: certifiedNodeCoversRequirement(node, requirement),
+    }));
+    const exact = ranked.find((candidate) => certifiedFitAllowsTier1(candidate.fit) && candidate.requirementFit.ok);
+    if (exact)
+        return { node: exact.node, reasons: exact.fit.reasons };
+    return {
+        reasons: Array.from(new Set(ranked.flatMap((candidate) => [
+            ...(certifiedFitAllowsTier1(candidate.fit) && !candidate.requirementFit.ok ? [] : candidate.fit.reasons),
+            ...candidate.requirementFit.reasons,
+        ]))).slice(0, 5),
+    };
+}
+/**
+ * App requirements are already structured, so they are a stronger contract than
+ * reparsing the short requirement question.  This guard prevents descriptive
+ * metadata from making (for example) a product ranking look like a time trend,
+ * or an all-customer lifetime ranking look like a beverage-filtered ranking.
+ */
+function certifiedNodeCoversRequirement(node, requirement) {
+    const haystack = canonicalRequirementText(JSON.stringify(node));
+    const missingDimensions = requirement.dimensions.filter((dimension) => !requirementTermAliases(dimension).some((alias) => haystack.includes(` ${alias} `)));
+    const filterTerms = requirement.filters.flatMap((filter) => canonicalRequirementText(filter).trim().split(/\s+/).filter((term) => term.length > 2 && !REQUIREMENT_FILTER_STOP_WORDS.has(term)));
+    const missingFilters = filterTerms.filter((term) => !requirementTermAliases(term).some((alias) => haystack.includes(` ${alias} `)));
+    const reasons = [
+        missingDimensions.length ? `certified source does not prove dimensions: ${missingDimensions.join(", ")}` : "",
+        missingFilters.length ? `certified source does not prove filters: ${missingFilters.join(", ")}` : "",
+    ].filter(Boolean);
+    return { ok: reasons.length === 0, reasons };
+}
+const REQUIREMENT_FILTER_STOP_WORDS = new Set([
+    "and", "for", "from", "with", "different", "type", "types", "specific", "only", "all",
+]);
+function canonicalRequirementText(value) {
+    return ` ${value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim()} `;
+}
+function requirementTermAliases(value) {
+    const term = canonicalRequirementText(value).trim();
+    if (["time", "date"].includes(term))
+        return ["time", "date", "day", "week", "month", "quarter", "year", "ordered at"];
+    if (["beverage", "beverages"].includes(term))
+        return ["beverage", "beverages", "drink", "drinks"];
+    if (["customer", "customers"].includes(term))
+        return ["customer", "customers", "customer name", "customer id"];
+    if (["product", "products"].includes(term))
+        return ["product", "products", "product name", "product id", "item", "sku"];
+    return [term];
+}
+function semanticTileForRequirement(kg, requirement, domain, snapshotId) {
+    if (requirement.measures.length === 0)
+        return null;
+    const hits = kg.search({
+        query: requirement.question,
+        domain: domain === "general" ? undefined : domain,
+        kinds: ["metric", "measure", "semantic_model", "dimension"],
+        limit: 24,
+    }).map((hit) => hit.node);
+    const metricNodes = hits.filter((node) => node.kind === "metric" || node.kind === "measure");
+    const modelNodes = hits.filter((node) => node.kind === "semantic_model");
+    if (metricNodes.length === 0 || modelNodes.length === 0)
+        return null;
+    const requested = new Set(requirement.measures.map((measure) => slugify(measure).replace(/-/g, "_")));
+    const metric = metricNodes.find((node) => requested.has(slugify(node.name).replace(/-/g, "_"))) ?? metricNodes[0];
+    if (!metric)
+        return null;
+    const semanticModelRefs = Array.from(new Set(modelNodes.map((node) => node.name))).slice(0, 4);
+    const id = `semantic-${requirement.id}`;
+    const fingerprintPayload = JSON.stringify({
+        metric: metric.nodeId,
+        dimensions: requirement.dimensions,
+        filters: requirement.filters,
+        models: semanticModelRefs,
+        snapshotId,
+    });
+    const semantic = {
+        id,
+        provider: metric.provenance?.toLowerCase().includes("metricflow") ? "metricflow" : "native",
+        metrics: [metric.name],
+        ...(requirement.dimensions.length ? { dimensions: requirement.dimensions } : {}),
+        ...(requirement.ranking ? {
+            orderBy: [{ field: metric.name, direction: requirement.ranking.direction === "bottom" ? "asc" : "desc" }],
+            limit: requirement.ranking.limit,
+        } : {}),
+        semanticModelRefs,
+        definitionFingerprint: `sha256:${createHash("sha256").update(fingerprintPayload).digest("hex")}`,
+        ...(snapshotId ? { snapshotId } : {}),
+    };
+    const viz = requirement.role === "kpi"
+        ? "single_value"
+        : requirement.role === "trend" ? "line" : requirement.ranking ? "bar" : "table";
+    return {
+        id,
+        title: requirement.question,
+        kind: "semantic_query",
+        semantic,
+        requirementIds: [requirement.id],
+        viz,
+        certification: "uncertified",
+        reviewStatus: "review_required",
+        trustState: "review_required",
+        rationale: "Governed semantic coverage for a requirement not fully covered by a compatible certified block.",
+        sourceEvidence: [
+            { source: metric.nodeId, nodeId: metric.nodeId, kind: metric.kind, reason: "Reviewed semantic metric", 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" })),
+        ],
+        reviewTasks: ["Review semantic definition freshness and result shape before stakeholder publication."],
+    };
+}
 export function planAppFromPrompt(input) {
     const prompt = input.prompt.trim();
     if (!prompt)
@@ -54,7 +214,61 @@ export function planAppFromPrompt(input) {
     const promptFilters = inferFilters(prompt);
     const blockFilters = filtersFromCertifiedNodes(certifiedNodes);
     const filters = blockFilters.length > 0 ? mergeAppFilters(blockFilters, promptFilters) : promptFilters;
-    const certifiedTiles = certifiedNodes.map((node, index) => tileFromCertifiedNode(node, index, analysisIntent, filters));
+    const candidateCertifiedTiles = certifiedNodes.map((node, index) => tileFromCertifiedNode(node, index, analysisIntent, filters));
+    const requirements = appRequirementsForPrompt(prompt);
+    const coverage = [];
+    const selectedCertifiedIds = new Set();
+    const semanticTiles = [];
+    for (const requirement of requirements) {
+        const match = certifiedCoverageForRequirement(requirement, certifiedNodes);
+        if (match.node) {
+            const tileId = slugify(match.node.name) || match.node.nodeId;
+            selectedCertifiedIds.add(match.node.nodeId);
+            coverage.push({
+                requirementId: requirement.id,
+                status: "covered",
+                source: "certified_block",
+                tileId,
+                sourceId: match.node.nodeId,
+                trustState: "certified",
+                reasons: match.reasons,
+            });
+            continue;
+        }
+        const semanticTile = input.allowSemanticQueries === false
+            ? null
+            : semanticTileForRequirement(input.kg, requirement, domain, input.snapshotId);
+        if (semanticTile) {
+            semanticTiles.push(semanticTile);
+            coverage.push({
+                requirementId: requirement.id,
+                status: "covered",
+                source: "semantic_query",
+                tileId: semanticTile.id,
+                sourceId: semanticTile.semantic?.id,
+                trustState: "review_required",
+                reasons: ["No fully compatible certified block; covered by a governed semantic query."],
+            });
+        }
+        else {
+            coverage.push({
+                requirementId: requirement.id,
+                status: "gap",
+                source: "gap",
+                trustState: "draft_ready",
+                reasons: match.reasons.length ? match.reasons : ["No compatible certified block or reviewed semantic definition was found."],
+            });
+        }
+    }
+    // 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
+    // context may still appear as supporting evidence tiles. It never closes a
+    // requirement unless the compatibility check above succeeds.
+    // Compatible blocks close requirements; other strongly related certified
+    // blocks may still appear as supporting context, but never change coverage.
+    const certifiedTiles = candidateCertifiedTiles;
+    const dashboardTiles = [...certifiedTiles, ...semanticTiles];
     const scopedReports = inferScopedReports(prompt, domain, analysisIntent, certifiedNodes);
     const certifiedContextSummary = summarizeCertifiedContext([
         ...certifiedNodes,
@@ -76,7 +290,18 @@ export function planAppFromPrompt(input) {
         filterLabels: filters.map((filter) => filter.label),
     });
     return {
-        version: 1,
+        version: 2,
+        mode: input.mode ?? "stakeholder",
+        ...(input.snapshotId ? { snapshotId: input.snapshotId } : {}),
+        requirements,
+        requirementCoverage: coverage,
+        storyEvidencePlan: {
+            version: 1,
+            goal: prompt,
+            audience,
+            eligibleTileIds: dashboardTiles.map((tile) => tile.id),
+            driverTileIds: dashboardTiles.filter((tile) => tile.display?.role === "breakdown" || tile.requirementIds?.some((id) => id.startsWith("by-"))).map((tile) => tile.id),
+        },
         appId,
         name: appName,
         prompt,
@@ -139,7 +364,7 @@ export function planAppFromPrompt(input) {
                 title: inferDashboardTitle(prompt, domain, appName),
                 description: `Certified app surface for ${audience}. Draft gaps stay in reports until reviewed.`,
                 filters,
-                tiles: certifiedTiles,
+                tiles: dashboardTiles,
             },
         ],
         caveats: [
@@ -154,9 +379,9 @@ export function planAppFromPrompt(input) {
         ],
         coverage: {
             certifiedTiles: certifiedTiles.length,
-            gaps: scopedReports.length,
-            ratio: certifiedTiles.length + scopedReports.length > 0
-                ? certifiedTiles.length / (certifiedTiles.length + scopedReports.length)
+            gaps: coverage.filter((item) => item.status === "gap").length,
+            ratio: coverage.length > 0
+                ? coverage.filter((item) => item.status === "covered").length / coverage.length
                 : 0,
         },
     };
@@ -165,7 +390,7 @@ export function validateAppPlan(plan, kg) {
     const issues = [];
     let certifiedTiles = 0;
     let draftTiles = 0;
-    if (plan.version !== 1)
+    if (plan.version !== 2)
         issues.push(error("version", "unsupported app plan version"));
     if (!plan.appId || !/^[a-z0-9][a-z0-9_-]*$/i.test(plan.appId)) {
         issues.push(error("appId", "appId must be folder-safe"));
@@ -207,6 +432,23 @@ export function validateAppPlan(plan, kg) {
                     issues.push(error(path, "certified block tiles must be visibly certified"));
                 }
             }
+            else if (tile.kind === "semantic_query") {
+                draftTiles += 1;
+                if (!tile.semantic) {
+                    issues.push(error(`${path}.semantic`, "semantic query tile requires a canonical semantic reference"));
+                }
+                else {
+                    if (tile.semantic.metrics.length === 0)
+                        issues.push(error(`${path}.semantic.metrics`, "semantic query requires a metric"));
+                    if (tile.semantic.semanticModelRefs.length === 0)
+                        issues.push(error(`${path}.semantic.semanticModelRefs`, "semantic query requires reviewed model references"));
+                    if (!tile.semantic.definitionFingerprint)
+                        issues.push(error(`${path}.semantic.definitionFingerprint`, "semantic query requires a definition fingerprint"));
+                }
+                if (tile.certification === "certified" || tile.reviewStatus === "certified") {
+                    issues.push(error(path, "semantic query tiles cannot be presented as certified blocks"));
+                }
+            }
             else {
                 draftTiles += 1;
                 issues.push(error(path, "stakeholder dashboard tiles must be certified blocks; route generated story, trust, and analysis work through scoped reports or Copilot investigations"));
@@ -235,11 +477,20 @@ export function generateAppFromPlan(projectRoot, plan, kg, options = {}) {
     if (errors.length > 0) {
         throw new Error(`AppPlan is invalid: ${errors.map((issue) => `${issue.path}: ${issue.message}`).join("; ")}`);
     }
-    const appDir = resolveAppPackageDir(projectRoot, plan.domain, plan.appId);
+    const appDir = resolveAppPackageDir(projectRoot, plan.appId);
     if (existsSync(appDir) && !options.overwrite) {
         throw new Error(`App already exists: ${relative(projectRoot, appDir)}`);
     }
     const dashboardId = plan.pages[0]?.id || "overview";
+    const sourceNodes = plan.pages.flatMap((page) => page.tiles)
+        .flatMap((tile) => tile.sourceEvidence ?? [])
+        .map((evidence) => evidence.nodeId ? kg.getNode(evidence.nodeId) : undefined)
+        .filter((node) => Boolean(node));
+    const usedDomains = Array.from(new Set([plan.domain, ...sourceNodes.map((node) => node.domain).filter((domain) => Boolean(domain))]));
+    const requiredExports = Array.from(new Set(sourceNodes.flatMap((node) => {
+        const value = node.payload?.requiredExports;
+        return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+    })));
     const app = {
         version: 1,
         id: plan.appId,
@@ -253,7 +504,10 @@ export function generateAppFromPlan(projectRoot, plan, kg, options = {}) {
             "Certified tiles must reference existing certified blocks.",
         ],
         caveats: plan.caveats,
-        visibility: "shared",
+        visibility: plan.mode === "personal" ? "private" : "shared",
+        ownerDomain: plan.domain,
+        usesDomains: usedDomains,
+        requiredExports,
         domain: plan.domain,
         audience: plan.audience,
         lifecycle: plan.lifecycle,
@@ -311,16 +565,16 @@ export function generateAppFromPlan(projectRoot, plan, kg, options = {}) {
     const dashboards = plan.pages.map((page, pageIndex) => ({
         version: 1,
         id: page.id,
-        // Story layout on the primary page when a narration was supplied.
         ...(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: "shared",
+            visibility: plan.mode === "personal" ? "private" : "shared",
             lifecycle: "draft",
             tags: plan.tags,
             businessOutcome: plan.planning.normalizedGoal,
@@ -990,16 +1244,26 @@ function filterBindingsForCertifiedNode(node, globalFilters) {
     return uniqueTileFilterBindings(bindings);
 }
 function parameterBindingsForCertifiedNode(node, filterBindings) {
-    const dynamicParams = (node.parameterPolicy ?? [])
-        .filter((entry) => entry.policy === "dynamic")
-        .map((entry) => entry.name);
+    const definitions = new Map((node.parameters ?? []).map((entry) => [entry.name, entry]));
+    const runtimePolicies = new Set(["dynamic", "optional"]);
+    const dynamicParams = Array.from(new Set([
+        ...(node.parameters ?? []).filter((entry) => runtimePolicies.has(entry.policy)).map((entry) => entry.name),
+        ...(node.parameterPolicy ?? []).filter((entry) => runtimePolicies.has(entry.policy)).map((entry) => entry.name),
+    ]));
     return dynamicParams.map((param) => {
         const filterBinding = filterBindings.find((entry) => entry.paramNames?.includes(param) || entry.filter === param);
+        const definition = definitions.get(param);
         return {
             param,
             source: filterBinding ? "dashboard_filter" : "variable",
             ...(filterBinding?.filter ? { filter: filterBinding.filter } : {}),
             field: filterBinding?.binding ?? param,
+            ...(definition ? {
+                parameterType: definition.type,
+                required: definition.required,
+                ...(definition.default !== undefined ? { default: definition.default } : {}),
+                policy: definition.policy,
+            } : {}),
         };
     });
 }
@@ -1155,9 +1419,12 @@ function buildLayoutItems(tiles) {
             trustState: tile.trustState ?? tile.display?.trustState ?? (tile.certification === "certified" ? "certified" : "draft_ready"),
             reviewStatus: tile.reviewStatus,
         };
-        if (isDashboardTile(tile)) {
+        if (tile.kind === "certified_block" && tile.blockId) {
             item.block = { blockId: tile.blockId };
         }
+        else if (tile.kind === "semantic_query" && tile.semantic) {
+            item.semantic = tile.semantic;
+        }
         else {
             item.text = { markdown: markdownForGeneratedPlanTile(tile) };
         }
@@ -1187,7 +1454,8 @@ function markdownForGeneratedPlanTile(tile) {
     ].filter(Boolean).join("\n");
 }
 function isDashboardTile(tile) {
-    return tile.kind === "certified_block" && tile.certification === "certified" && Boolean(tile.blockId);
+    return (tile.kind === "certified_block" && tile.certification === "certified" && Boolean(tile.blockId))
+        || (tile.kind === "semantic_query" && Boolean(tile.semantic));
 }
 function appPlanReadme(plan, validation) {
     const reviewDashboardItems = plan.pages.flatMap((page) => page.tiles
@@ -1688,12 +1956,7 @@ function slugify(input) {
         .replace(/^-+|-+$/g, "")
         .replace(/-{2,}/g, "-");
 }
-function resolveAppPackageDir(projectRoot, domain, appId) {
-    const domainSlug = slugify(domain);
-    const domainDir = domainSlug ? join(projectRoot, "domains", domainSlug) : "";
-    if (domainDir && existsSync(domainDir)) {
-        return join(domainDir, "apps", appId);
-    }
+function resolveAppPackageDir(projectRoot, appId) {
     return join(projectRoot, "apps", appId);
 }
 function normalizeToken(input) {