@duckcodeailabs/dql-mcp 1.6.15 → 1.6.17

package/dist/index.d.ts

@@ -15,4 +15,5 @@ export { lineageImpact, lineageImpactInput } from './tools/lineage-impact.js';
 export { certify, certifyInput } from './tools/certify.js';
 export { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
 export { kgSearch, kgSearchInput, feedbackRecord, feedbackRecordInput } from './tools/kg.js';
+export { askDql, askDqlInput, buildDqlApp, buildDqlAppInput, buildDqlBlock, buildDqlBlockInput, inspectDqlProject, inspectDqlProjectInput, } from './tools/workflows.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -14,4 +14,5 @@ export { lineageImpact, lineageImpactInput } from './tools/lineage-impact.js';
 export { certify, certifyInput } from './tools/certify.js';
 export { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
 export { kgSearch, kgSearchInput, feedbackRecord, feedbackRecordInput } from './tools/kg.js';
+export { askDql, askDqlInput, buildDqlApp, buildDqlAppInput, buildDqlBlock, buildDqlBlockInput, inspectDqlProject, inspectDqlProjectInput, } from './tools/workflows.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,QAoBsD,CAAC;AAExF,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAgG/E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BpE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,QAmBT,CAAC;AAEzB,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAoI/E"}

package/dist/server.js

@@ -10,30 +10,46 @@ import { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
 import { queryViaMetadata, queryViaMetadataInput } from './tools/query-via-metadata.js';
 import { listProposals, listProposalsInput } from './tools/list-proposals.js';
 import { feedbackRecord, feedbackRecordInput, inspectMetadataContext, inspectMetadataContextInput, kgSearch, kgSearchInput, } from './tools/kg.js';
-export const DQL_MCP_INSTRUCTIONS = 'DQL exposes governed analytics under graduated trust:\n' +
-    ' Tier 1 — Use certified artifacts when the user asks for an exact saved block, ' +
-    'direct KPI, or definition. Discover candidates with `kg_search`, `search_blocks`, ' +
-    'and `get_block`; execute data blocks with `query_via_block` only when the block ' +
-    'grain exactly answers the question. Certified blocks may optionally enforce ' +
-    'DataLex contract resolution when a DataLex manifest is loaded.\n' +
-    ' Tier 2 — For named customer/user/account questions, custom filters, rankings, ' +
-    'breakdowns, comparisons, drill-throughs, or any different grain, use certified ' +
-    'blocks/terms only as context. Call `inspect_metadata_context` first, then call ' +
-    '`query_via_metadata`; omit SQL when you need the route plan/allowed SQL context, ' +
-    'or provide read-only SQL inferred from the manifest, semantic layer, dbt/source ' +
-    'metadata, and runtime schema. Surface `uncertified: true` and the draft review ' +
-    'path verbatim.\n' +
-    ' Tier 3 — If the available metadata does not identify a safe table, metric, ' +
-    'dimension, or grain, refuse and ask for the missing business object or metric.\n' +
-    'Other tools support the loop: `list_proposals` shows repeated Tier-2 drafts, ' +
-    '`suggest_block` proposes shared building blocks, `certify` evaluates governance, ' +
-    '`lineage_impact` traces dependencies, `list_metrics` / `list_dimensions` expose ' +
-    'the semantic layer, `kg_search` searches the DQL agent knowledge graph, and ' +
-    '`feedback_record` records answer quality. Never present Tier-2 output as certified.';
+import { askDql, askDqlInput, buildDqlApp, buildDqlAppInput, buildDqlBlock, buildDqlBlockInput, inspectDqlProject, inspectDqlProjectInput, } from './tools/workflows.js';
+export const DQL_MCP_INSTRUCTIONS = 'DQL is a governed analytics MCP server. Start each session with ' +
+    '`inspect_dql_project`; route every analytics question through `ask_dql` ' +
+    'before writing SQL. It returns the safe route, trust label, certified ' +
+    'candidate when available, allowed SQL context, and next tool.\n' +
+    'Tier 1 certified: for an exact saved block or direct KPI, use ' +
+    '`search_blocks`/`get_block` for discovery and `query_via_block` only when ' +
+    'a certified block grain exactly answers the question.\n' +
+    'Tier 2 generated: for named customer/user/account questions, custom filters, ' +
+    'rankings, breakdowns, comparisons, drill-throughs, or different grain, use ' +
+    'certified assets only as context. Call `inspect_metadata_context`, then `query_via_metadata` with ' +
+    'one read-only SELECT/WITH query from the inspected context. Surface ' +
+    '`uncertified: true`, the trust status, and draft path verbatim.\n' +
+    'Tier 3 missing context: if metadata does not identify a safe table, metric, ' +
+    'dimension, or grain, refuse and ask for what is missing.\n' +
+    'Use `build_dql_block` for reusable draft blocks, `build_dql_app` for app ' +
+    'drafts with certified tiles plus review-only gaps, `certify` for governance, ' +
+    '`lineage_impact` for dependencies, `kg_search` for the knowledge graph, and ' +
+    '`feedback_record` for answer quality. Never present generated SQL or draft ' +
+    'output as certified.';
 export function createDQLMCPServer(options = {}) {
     const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd());
     const ctx = new DQLContext({ projectRoot, dqlVersion: options.version });
     const server = new McpServer({ name: 'dql-mcp', version: options.version ?? '0.1.0' }, { instructions: DQL_MCP_INSTRUCTIONS });
+    server.registerTool('inspect_dql_project', {
+        description: 'Front-door project health/context tool for MCP clients. Refreshes metadata/index by default and returns block, app, dashboard, semantic, catalog, and recommended-next-step status.',
+        inputSchema: inspectDqlProjectInput,
+    }, async (args) => wrap(await inspectDqlProject(ctx, args)));
+    server.registerTool('ask_dql', {
+        description: 'High-level governed ask router. Use first for business questions. Returns certified-vs-generated route, contextPackId, exact block candidate, allowed SQL context, missing context, trust status, and next safe DQL tool.',
+        inputSchema: askDqlInput,
+    }, async (args) => wrap(await askDql(ctx, args)));
+    server.registerTool('build_dql_block', {
+        description: 'High-level draft-block tool. Writes a proposed block to blocks/_drafts/ with governance results. Does not certify automatically.',
+        inputSchema: buildDqlBlockInput,
+    }, async (args) => wrap(await buildDqlBlock(ctx, args)));
+    server.registerTool('build_dql_app', {
+        description: 'High-level app builder. Creates or plans a governed DQL app draft from a prompt using certified tiles first and review-only placeholders for missing evidence.',
+        inputSchema: buildDqlAppInput,
+    }, async (args) => wrap(await buildDqlApp(ctx, args)));
     server.registerTool('search_blocks', { description: 'Find certified DQL blocks by keyword, domain, or status.', inputSchema: searchBlocksInput }, async (args) => wrap(await searchBlocks(ctx, args)));
     server.registerTool('get_block', { description: 'Return full metadata, dependencies, and SQL for a block.', inputSchema: getBlockInput }, async (args) => wrap(await getBlock(ctx, args)));
     server.registerTool('query_via_block', {

package/dist/server.js.map

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

package/dist/tools/workflows.d.ts

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import type { DQLContext } from '../context.js';
+import { type MetadataAllowedSqlContext } from '@duckcodeailabs/dql-agent';
+import { suggestBlock } from './suggest-block.js';
+export declare const askDqlInput: {
+    question: z.ZodString;
+    focusObjectKey: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function askDql(ctx: DQLContext, args: {
+    question: string;
+    focusObjectKey?: string;
+    limit?: number;
+}): Promise<{
+    question: string;
+    contextPackId: string;
+    route: import("@duckcodeailabs/dql-agent").MetadataAnswerRoute;
+    intent: import("@duckcodeailabs/dql-agent").MetadataAgentIntent;
+    trustStatus: import("@duckcodeailabs/dql-agent").MetadataTrustLabel;
+    reviewStatus: "certified" | "none" | "draft_ready" | "needs_review";
+    reason: string;
+    recommendedAction: string;
+    nextTool: string;
+    exactCertifiedBlock: {
+        objectKey: string;
+        objectType: string;
+        name: string;
+        fullName: string | undefined;
+        domain: string | undefined;
+        owner: string | undefined;
+        status: string | undefined;
+        description: string | undefined;
+        sourcePath: string | undefined;
+    } | undefined;
+    certifiedCandidates: {
+        objectKey: string;
+        objectType: string;
+        name: string;
+        fullName: string | undefined;
+        domain: string | undefined;
+        owner: string | undefined;
+        status: string | undefined;
+        description: string | undefined;
+        sourcePath: string | undefined;
+    }[];
+    selectedEvidence: {
+        objectKey: string;
+        objectType: string;
+        name: string;
+        role: import("@duckcodeailabs/dql-agent").MetadataEvidenceRole;
+        reason: string;
+    }[];
+    allowedSqlContext: MetadataAllowedSqlContext;
+    missingContext: import("@duckcodeailabs/dql-agent").MetadataMissingContext[];
+    followUps: string[];
+    warnings: string[];
+    answerContract: {
+        requiredFields: string[];
+        rule: string;
+    };
+}>;
+export declare const buildDqlAppInput: {
+    prompt: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    aiLayout: z.ZodOptional<z.ZodBoolean>;
+    saveDraft: z.ZodOptional<z.ZodBoolean>;
+    overwrite: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function buildDqlApp(ctx: DQLContext, args: {
+    prompt: string;
+    domain?: string;
+    owner?: string;
+    aiLayout?: boolean;
+    saveDraft?: boolean;
+    overwrite?: boolean;
+}): Promise<{
+    ok: boolean;
+    appId: string;
+    name: string;
+    domain: string;
+    audience: string;
+    lifecycle: "draft" | "review";
+    certifiedTiles: number;
+    draftTiles: number;
+    validation: import("@duckcodeailabs/dql-agent").AppPlanValidationResult;
+    plan: import("@duckcodeailabs/dql-agent").AppPlan;
+    generated: import("@duckcodeailabs/dql-agent").GeneratedAppPackage | undefined;
+    nextActions: string[];
+}>;
+export declare const inspectDqlProjectInput: {
+    refresh: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function inspectDqlProject(ctx: DQLContext, args: {
+    refresh?: boolean;
+}): Promise<{
+    projectRoot: string;
+    blocks: {
+        total: number;
+        certified: number;
+        draft: number;
+    };
+    apps: number;
+    dashboards: number;
+    semantic: {
+        metrics: number;
+        dimensions: number;
+    };
+    index: {
+        nodes: number;
+        edges: number;
+        skills: number;
+    } | undefined;
+    catalog: {
+        path: string;
+        refreshed: boolean;
+        objectCount: number;
+        edgeCount: number;
+        diagnostics: unknown[];
+    } | undefined;
+    recommendedNextStep: string;
+}>;
+export declare const buildDqlBlockInput: {
+    name: z.ZodString;
+    domain: z.ZodString;
+    owner: z.ZodString;
+    description: z.ZodString;
+    sql: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    chartType: z.ZodOptional<z.ZodString>;
+};
+export declare function buildDqlBlock(ctx: DQLContext, args: Parameters<typeof suggestBlock>[1]): {
+    error: string;
+    name?: undefined;
+    path?: undefined;
+    certified?: undefined;
+    errors?: undefined;
+    warnings?: undefined;
+    nextStep?: undefined;
+} | {
+    name: string;
+    path: string;
+    certified: boolean;
+    errors: {
+        rule: string;
+        message: string;
+    }[];
+    warnings: {
+        rule: string;
+        message: string;
+    }[];
+    nextStep: string;
+    error?: undefined;
+};
+//# sourceMappingURL=workflows.d.ts.map

package/dist/tools/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/tools/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EASL,KAAK,yBAAyB,EAE/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAErE,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DpE;AAED,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAC;AAEF,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;;;;;;;;;;;;;GA+CF;AAED,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;eAEP,MAAM;eAAS,MAAM;gBAAU,MAAM;;;cACpC,MAAM;mBAAa,OAAO;qBAAe,MAAM;mBAAa,MAAM;qBAAe,OAAO,EAAE;;;GA2BhH;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAAoB,CAAC;AAEpD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;EAGzC"}

package/dist/tools/workflows.js

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+import { KGStore, defaultKgPath, ensureMetadataCatalogFresh, generateAppFromPlan, planAgentAnswer, planAppFromPrompt, reindexProject, validateAppPlan, } from '@duckcodeailabs/dql-agent';
+import { suggestBlock, suggestBlockInput } from './suggest-block.js';
+export const askDqlInput = {
+    question: z.string().min(1).describe('Business or analytics question to route through governed DQL context.'),
+    focusObjectKey: z.string().optional().describe('Optional metadata object key to bias retrieval.'),
+    limit: z.number().int().min(1).max(160).optional().describe('Maximum metadata objects in the context pack.'),
+};
+export async function askDql(ctx, args) {
+    const catalog = await ensureMetadataCatalogFresh(ctx.projectRoot).catch((error) => ({
+        path: '',
+        refreshed: false,
+        objectCount: 0,
+        edgeCount: 0,
+        diagnostics: [{
+                kind: 'metadata',
+                severity: 'error',
+                message: error instanceof Error ? error.message : String(error),
+            }],
+        fingerprint: '',
+    }));
+    const planned = await planAgentAnswer(ctx.projectRoot, {
+        question: args.question,
+        focusObjectKey: args.focusObjectKey,
+        limit: args.limit ?? 100,
+        surface: 'mcp',
+    });
+    const route = planned.routeDecision;
+    const exact = route.exactObjectKey
+        ? planned.contextPack.objects.find((object) => object.objectKey === route.exactObjectKey)
+        : undefined;
+    const certifiedCandidates = planned.contextPack.objects
+        .filter((object) => object.objectType === 'dql_block' && isCertified(object))
+        .slice(0, 8)
+        .map(summarizeObject);
+    return {
+        question: args.question,
+        contextPackId: planned.contextPackId,
+        route: route.route,
+        intent: route.intent,
+        trustStatus: route.trustLabel,
+        reviewStatus: route.reviewStatus,
+        reason: route.reason,
+        recommendedAction: recommendedAction(route.route),
+        nextTool: nextTool(route.route),
+        exactCertifiedBlock: exact && exact.objectType === 'dql_block' ? summarizeObject(exact) : undefined,
+        certifiedCandidates,
+        selectedEvidence: route.selectedEvidence,
+        allowedSqlContext: summarizeAllowedSqlContext(planned.allowedSqlContext),
+        missingContext: planned.missingContext,
+        followUps: route.followUps,
+        warnings: [
+            ...planned.warnings,
+            ...catalog.diagnostics.map((diagnostic) => diagnostic.message),
+        ],
+        answerContract: {
+            requiredFields: [
+                'answer',
+                'tableOrResultSummary',
+                'sqlWhenGenerated',
+                'trustStatus',
+                'citations',
+                'draftPathWhenGenerated',
+                'nextReviewAction',
+            ],
+            rule: 'Never present generated SQL or Tier-2 preview rows as certified.',
+        },
+    };
+}
+export const buildDqlAppInput = {
+    prompt: z.string().min(1).describe('App outcome request, for example "Build a Customer 360 for Melissa Lopez".'),
+    domain: z.string().optional().describe('Optional business domain to prioritize.'),
+    owner: z.string().optional().describe('Owner identity to store on the generated app.'),
+    aiLayout: z.boolean().optional().describe('Store richer dynamic GenUI layout metadata.'),
+    saveDraft: z.boolean().optional().describe('Write the app draft files. Default true.'),
+    overwrite: z.boolean().optional().describe('Overwrite an existing app folder if it already exists. Default false.'),
+};
+export async function buildDqlApp(ctx, args) {
+    const kgPath = defaultKgPath(ctx.projectRoot);
+    await reindexProject(ctx.projectRoot, { kgPath });
+    const kg = new KGStore(kgPath);
+    try {
+        const plan = planAppFromPrompt({
+            prompt: args.prompt,
+            kg,
+            domain: cleanOptional(args.domain),
+            owner: cleanOptional(args.owner),
+            plannerMode: args.aiLayout ? 'ai_assisted' : 'deterministic',
+        });
+        const validation = validateAppPlan(plan, kg);
+        const generated = args.saveDraft === false
+            ? undefined
+            : generateAppFromPlan(ctx.projectRoot, plan, kg, { overwrite: args.overwrite === true });
+        if (generated) {
+            ctx.refresh();
+            await ensureMetadataCatalogFresh(ctx.projectRoot, { force: true }).catch(() => undefined);
+        }
+        return {
+            ok: true,
+            appId: plan.appId,
+            name: plan.name,
+            domain: plan.domain,
+            audience: plan.audience,
+            lifecycle: plan.lifecycle,
+            certifiedTiles: validation.certifiedTiles,
+            draftTiles: validation.draftTiles,
+            validation,
+            plan,
+            generated,
+            nextActions: generated
+                ? [
+                    'Open the generated app draft in DQL.',
+                    'Review draft/research tiles before stakeholder use.',
+                    'Run dql app build after review.',
+                ]
+                : [
+                    'Review the returned plan.',
+                    'Call build_dql_app again with saveDraft=true to write files.',
+                ],
+        };
+    }
+    finally {
+        kg.close();
+    }
+}
+export const inspectDqlProjectInput = {
+    refresh: z.boolean().optional().describe('Refresh metadata and agent index before returning status. Default true.'),
+};
+export async function inspectDqlProject(ctx, args) {
+    let index;
+    let catalog;
+    if (args.refresh !== false) {
+        index = await reindexProject(ctx.projectRoot, { kgPath: defaultKgPath(ctx.projectRoot) });
+        catalog = await ensureMetadataCatalogFresh(ctx.projectRoot);
+        ctx.refresh();
+    }
+    const manifest = ctx.manifest;
+    const blocks = Object.values(manifest.blocks ?? {});
+    const dashboards = Object.values(manifest.dashboards ?? {});
+    const apps = Object.values(manifest.apps ?? {});
+    return {
+        projectRoot: ctx.projectRoot,
+        blocks: {
+            total: blocks.length,
+            certified: blocks.filter((block) => block.status === 'certified').length,
+            draft: blocks.filter((block) => block.status !== 'certified').length,
+        },
+        apps: apps.length,
+        dashboards: dashboards.length,
+        semantic: {
+            metrics: ctx.semanticLayer.listMetrics().length,
+            dimensions: ctx.semanticLayer.listDimensions().length,
+        },
+        index,
+        catalog,
+        recommendedNextStep: 'Use ask_dql before writing SQL, then query_via_block or query_via_metadata based on the returned route.',
+    };
+}
+export const buildDqlBlockInput = suggestBlockInput;
+export function buildDqlBlock(ctx, args) {
+    return suggestBlock(ctx, args);
+}
+function recommendedAction(route) {
+    if (route === 'certified')
+        return 'Use query_via_block only if the certified grain exactly answers the question.';
+    if (route === 'generated_sql')
+        return 'Generate one read-only SELECT/WITH query from the allowed SQL context, then call query_via_metadata.';
+    if (route === 'research')
+        return 'Use lineage, proposals, and metadata evidence before creating or promoting any app tile.';
+    return 'Ask for the missing business object, metric, table, filter, or grain before writing SQL.';
+}
+function nextTool(route) {
+    if (route === 'certified')
+        return 'query_via_block';
+    if (route === 'generated_sql')
+        return 'query_via_metadata';
+    if (route === 'research')
+        return 'inspect_metadata_context';
+    return 'ask_user_clarifying_question';
+}
+function summarizeAllowedSqlContext(context) {
+    return {
+        relations: context.relations.slice(0, 12).map((relation) => ({
+            ...relation,
+            columns: relation.columns.slice(0, 40),
+        })),
+        sourceBlockSql: context.sourceBlockSql.slice(0, 8),
+    };
+}
+function summarizeObject(object) {
+    return {
+        objectKey: object.objectKey,
+        objectType: object.objectType,
+        name: object.name,
+        fullName: object.fullName,
+        domain: object.domain,
+        owner: object.owner,
+        status: object.status,
+        description: object.description,
+        sourcePath: object.sourcePath,
+    };
+}
+function isCertified(object) {
+    return object.status === 'certified' || object.payload?.certification === 'certified';
+}
+function cleanOptional(value) {
+    const trimmed = value?.trim();
+    return trimmed || undefined;
+}
+//# sourceMappingURL=workflows.js.map

package/dist/tools/workflows.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-mcp",
-  "version": "1.6.15",
+  "version": "1.6.17",
   "description": "DQL MCP server: expose certified blocks, semantic layer, lineage, and governance to LLM agents via the Model Context Protocol",
   "license": "Apache-2.0",
   "type": "module",
@@ -24,10 +24,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@duckcodeailabs/dql-agent": "^1.6.15",
-    "@duckcodeailabs/dql-core": "^1.6.15",
-    "@duckcodeailabs/dql-governance": "^1.6.15",
-    "@duckcodeailabs/dql-project": "^1.6.15",
+    "@duckcodeailabs/dql-agent": "^1.6.17",
+    "@duckcodeailabs/dql-core": "^1.6.17",
+    "@duckcodeailabs/dql-governance": "^1.6.17",
+    "@duckcodeailabs/dql-project": "^1.6.17",
     "@modelcontextprotocol/sdk": "^1.0.4",
     "zod": "^3.25.0"
   },