@duckcodeailabs/dql-cli 1.3.6 → 1.4.1

package/dist/assets/dql-notebook/index.html

@@ -7,7 +7,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600;700&family=Kalam:wght@400;700&family=Caveat:wght@400;600;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-jwFfZgBm.js"></script>
+    <script type="module" crossorigin src="/assets/index-BJ7MV8Gv.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/react-CRB3T2We.js">
     <link rel="modulepreload" crossorigin href="/assets/codemirror-DJYUkPr1.js">
     <link rel="stylesheet" crossorigin href="/assets/index-DrhoZmtv.css">

package/dist/commands/agent.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `dql agent` — block-first answer loop on the command line.
+ *
+ *   dql agent ask "what was revenue last week?"
+ *     [--provider claude|openai|gemini|ollama]
+ *     [--user alice@acme.com]   (filters Skills + records feedback as this user)
+ *     [--domain growth]         (scopes KG search)
+ *     [--format json]           (emits structured JSON instead of prose)
+ *
+ *   dql agent reindex
+ *     Rebuilds .dql/cache/agent-kg.sqlite from the project's manifest +
+ *     Skills folder. Equivalent to `dql app reindex`.
+ *
+ *   dql agent feedback <up|down> --block <id> --question "..."
+ *     Records feedback into the KG. Used by clients without MCP access.
+ */
+import type { CLIFlags } from '../args.js';
+export declare function runAgent(sub: string | null, rest: string[], flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/commands/agent.js

@@ -0,0 +1,117 @@
+/**
+ * `dql agent` — block-first answer loop on the command line.
+ *
+ *   dql agent ask "what was revenue last week?"
+ *     [--provider claude|openai|gemini|ollama]
+ *     [--user alice@acme.com]   (filters Skills + records feedback as this user)
+ *     [--domain growth]         (scopes KG search)
+ *     [--format json]           (emits structured JSON instead of prose)
+ *
+ *   dql agent reindex
+ *     Rebuilds .dql/cache/agent-kg.sqlite from the project's manifest +
+ *     Skills folder. Equivalent to `dql app reindex`.
+ *
+ *   dql agent feedback <up|down> --block <id> --question "..."
+ *     Records feedback into the KG. Used by clients without MCP access.
+ */
+import { existsSync } from 'node:fs';
+import { KGStore, defaultKgPath, reindexProject, loadSkills, pickProvider, answer, } from '@duckcodeailabs/dql-agent';
+import { findProjectRoot } from '../local-runtime.js';
+export async function runAgent(sub, rest, flags) {
+    switch (sub) {
+        case 'ask':
+            return runAsk(rest, flags);
+        case 'reindex':
+            return runReindex(flags);
+        case 'feedback':
+            return runFeedback(rest, flags);
+        default:
+            throw new Error('Usage: dql agent <ask|reindex|feedback> [args]\n' +
+                '  dql agent ask "<question>" [--provider claude|openai|gemini|ollama] [--user <id>] [--domain <d>]\n' +
+                '  dql agent reindex\n' +
+                '  dql agent feedback up|down --block <id> --question "..."');
+    }
+}
+async function runAsk(rest, flags) {
+    const question = rest.join(' ').trim();
+    if (!question)
+        throw new Error('Usage: dql agent ask "<question>"');
+    const projectRoot = findProjectRoot(process.cwd());
+    const kgPath = defaultKgPath(projectRoot);
+    if (!existsSync(kgPath)) {
+        throw new Error('KG not built. Run `dql agent reindex` (or `dql app reindex`) before asking.');
+    }
+    const providerName = flags.provider;
+    const userId = flags.user;
+    const domain = flags.domain;
+    const format = flags.format;
+    const provider = await pickProvider(providerName);
+    const kg = new KGStore(kgPath);
+    const { skills } = loadSkills(projectRoot);
+    try {
+        const result = await answer({ question, provider, kg, skills, userId, domain });
+        if (format === 'json') {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const badge = result.kind === 'certified'
+            ? '✓ Certified'
+            : result.kind === 'uncertified'
+                ? '! AI-generated · uncertified'
+                : '? No answer';
+        const cite = result.citations.length > 0
+            ? '\n\nCitations:\n' + result.citations.map((c) => `  - ${c.kind} \`${c.name}\`${c.gitSha ? ` · ${c.gitSha.slice(0, 8)}` : ''}`).join('\n')
+            : '';
+        console.log(`${badge}\n\n${result.text}${cite}`);
+        if (result.proposedSql) {
+            console.log(`\n--- Proposed SQL (review before saving as a block) ---\n${result.proposedSql}`);
+            if (result.suggestedViz)
+                console.log(`Viz: ${result.suggestedViz}`);
+        }
+    }
+    finally {
+        kg.close();
+    }
+}
+async function runReindex(flags) {
+    const projectRoot = findProjectRoot(process.cwd());
+    const stats = await reindexProject(projectRoot);
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({ ok: true, ...stats }, null, 2));
+        return;
+    }
+    console.log(`  ✓ KG rebuilt — ${stats.nodes} nodes, ${stats.edges} edges, ${stats.skills} skill(s).`);
+}
+async function runFeedback(rest, flags) {
+    const rating = rest[0];
+    if (rating !== 'up' && rating !== 'down') {
+        throw new Error('Usage: dql agent feedback up|down --block <id> --question "..."');
+    }
+    const blockId = flags.block;
+    const question = flags.question;
+    const user = flags.user ?? `${process.env.USER ?? 'owner'}@local`;
+    if (!question)
+        throw new Error('--question is required');
+    const projectRoot = findProjectRoot(process.cwd());
+    const kgPath = defaultKgPath(projectRoot);
+    if (!existsSync(kgPath))
+        throw new Error('KG not built. Run `dql agent reindex`.');
+    const kg = new KGStore(kgPath);
+    try {
+        kg.recordFeedback({
+            id: `fb_${Date.now().toString(36)}`,
+            ts: new Date().toISOString(),
+            user,
+            question,
+            answerKind: blockId?.startsWith('block:') ? 'certified' : 'uncertified',
+            blockId,
+            rating,
+            comment: flags.comment,
+        });
+        console.log(`  ✓ Recorded ${rating} from ${user}.`);
+    }
+    finally {
+        kg.close();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/app.d.ts

@@ -1,3 +1,32 @@
+/**
+ * `dql app` — manage Apps (consumption-layer artifacts).
+ *
+ * Apps live at `apps/<id>/dql.app.json` and bundle dashboards/notebooks plus
+ * declarative members, roles, policies, RLS bindings, and schedules. They're
+ * compiled into the `apps[]` and `dashboards[]` records of `dql-manifest.json`
+ * and read by both the desktop UI and the CLI.
+ *
+ * Subcommands:
+ *   dql app new <id> --domain <domain> [--owner <user>]
+ *   dql app ls
+ *   dql app show <id>
+ *   dql app build [--app <id>]
+ *   dql app reindex [--app <id>]   (no-op until the agent KG package lands; aliased)
+ */
+import { type ManifestApp } from '@duckcodeailabs/dql-core';
 import type { CLIFlags } from '../args.js';
 export declare function runApp(sub: string | null, rest: string[], flags: CLIFlags): Promise<void>;
+interface ResolvedApp extends Omit<ManifestApp, 'dashboards'> {
+    dashboards: Array<{
+        id: string;
+        title: string;
+    }>;
+}
+declare function collectApps(projectRoot: string): ResolvedApp[];
+declare function humanise(id: string): string;
+export declare const __test__: {
+    collectApps: typeof collectApps;
+    humanise: typeof humanise;
+};
+export {};
 //# sourceMappingURL=app.d.ts.map

package/dist/commands/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/commands/app.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgB3C,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAWf"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/commands/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,wBAAsB,MAAM,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAuBf;AAkOD,UAAU,WAAY,SAAQ,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC;IAC3D,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,iBAAS,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAkDvD;AAOD,iBAAS,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMpC;AAGD,eAAO,MAAM,QAAQ;;;CAGpB,CAAC"}

package/dist/commands/app.js

@@ -1,191 +1,307 @@
+/**
+ * `dql app` — manage Apps (consumption-layer artifacts).
+ *
+ * Apps live at `apps/<id>/dql.app.json` and bundle dashboards/notebooks plus
+ * declarative members, roles, policies, RLS bindings, and schedules. They're
+ * compiled into the `apps[]` and `dashboards[]` records of `dql-manifest.json`
+ * and read by both the desktop UI and the CLI.
+ *
+ * Subcommands:
+ *   dql app new <id> --domain <domain> [--owner <user>]
+ *   dql app ls
+ *   dql app show <id>
+ *   dql app build [--app <id>]
+ *   dql app reindex [--app <id>]   (no-op until the agent KG package lands; aliased)
+ */
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, basename } from 'node:path';
-import { load as loadYaml, dump as dumpYaml } from 'js-yaml';
+import { join, relative } from 'node:path';
+import { resolveDbtManifestPath } from '@duckcodeailabs/dql-core';
+import { buildManifest, loadAppDocument, findAppDocuments, loadDashboardDocument, findDashboardsForApp, suggestAppId, } from '@duckcodeailabs/dql-core';
 import { findProjectRoot } from '../local-runtime.js';
-const APP_DIR_SUFFIX = '.dql-app';
 const APPS_ROOT = 'apps';
 export async function runApp(sub, rest, flags) {
     switch (sub) {
         case 'new':
             return runAppNew(rest, flags);
         case 'ls':
+        case 'list':
             return runAppList(flags);
         case 'show':
             return runAppShow(rest, flags);
+        case 'build':
+            return runAppBuild(flags);
+        case 'reindex':
+            return runAppReindex(flags);
         default:
-            throw new Error('Usage: dql app <new|ls|show> [args]');
+            throw new Error('Usage: dql app <new|ls|show|build|reindex> [args]\n' +
+                '  dql app new <id> --domain <domain> [--owner <user>]\n' +
+                '  dql app ls\n' +
+                '  dql app show <id>\n' +
+                '  dql app build\n' +
+                '  dql app reindex');
     }
 }
+// ---- new ----
 async function runAppNew(rest, flags) {
-    const name = rest[0];
-    if (!name)
-        throw new Error('Usage: dql app new <name> --domain <domain> [--owner <owner>]');
+    const rawId = rest[0];
+    if (!rawId) {
+        throw new Error('Usage: dql app new <id> --domain <domain> [--owner <user>]');
+    }
     const domain = flags.domain?.trim();
     if (!domain)
         throw new Error('--domain is required for "dql app new"');
+    const id = suggestAppId(rawId);
     const projectRoot = findProjectRoot(process.cwd());
-    const slug = toSlug(name);
-    const appDir = join(projectRoot, APPS_ROOT, `${slug}${APP_DIR_SUFFIX}`);
+    const appDir = join(projectRoot, APPS_ROOT, id);
     if (existsSync(appDir)) {
         throw new Error(`App already exists at ${relFromRoot(projectRoot, appDir)}`);
     }
-    const owner = flags.owner?.trim() || process.env.USER || 'team';
-    const manifest = {
-        name: slug,
+    const owner = flags.owner?.trim() || `${process.env.USER ?? 'owner'}@local`;
+    const displayName = humanise(id);
+    const appJson = {
+        version: 1,
+        id,
+        name: displayName,
+        description: `${displayName} — consumption surface for ${domain}`,
         domain,
-        owner,
-        description: `${titleFromSlug(slug)} — an app for ${domain}`,
-        cadence: 'ad-hoc',
-        consumers: [],
-        entryPoints: [`notebooks/overview.dqlnb`],
-    };
-    mkdirSync(join(appDir, 'notebooks'), { recursive: true });
-    mkdirSync(join(appDir, 'dashboards'), { recursive: true });
-    writeFileSync(join(appDir, 'app.yml'), dumpYaml(manifest), 'utf-8');
-    writeFileSync(join(appDir, 'notebooks', 'overview.dqlnb'), JSON.stringify({
-        dqlnbVersion: 1,
-        title: `${titleFromSlug(slug)} Overview`,
-        cells: [
+        owners: [owner],
+        tags: [],
+        members: [
+            { userId: owner, displayName: owner, roles: ['owner'] },
+        ],
+        roles: [
+            { id: 'owner', displayName: 'Owner', description: 'Full access to all dashboards and configuration.' },
+            { id: 'analyst', displayName: 'Analyst', description: 'Can view and run dashboards, propose new blocks.' },
+            { id: 'viewer', displayName: 'Viewer', description: 'Read-only access to certified dashboards.' },
+        ],
+        policies: [
+            {
+                id: 'viewers-read',
+                domain,
+                minClassification: 'internal',
+                allowedRoles: ['viewer', 'analyst', 'owner'],
+                accessLevel: 'read',
+                enabled: true,
+            },
             {
-                id: 'intro',
-                type: 'markdown',
-                content: `# ${titleFromSlug(slug)}\n\n${manifest.description}\n\nOwner: ${owner}`,
+                id: 'analyst-execute',
+                domain,
+                minClassification: 'confidential',
+                allowedRoles: ['analyst', 'owner'],
+                accessLevel: 'execute',
+                enabled: true,
             },
         ],
-    }, null, 2) + '\n', 'utf-8');
+        rlsBindings: [],
+        schedules: [],
+        homepage: { type: 'dashboard', id: 'overview' },
+    };
+    const overview = {
+        version: 1,
+        id: 'overview',
+        metadata: {
+            title: `${displayName} — Overview`,
+            description: 'Default dashboard scaffolded by `dql app new`. Replace with your own blocks.',
+            domain,
+        },
+        layout: {
+            kind: 'grid',
+            cols: 12,
+            rowHeight: 80,
+            items: [],
+        },
+    };
+    mkdirSync(join(appDir, 'dashboards'), { recursive: true });
+    mkdirSync(join(appDir, 'notebooks'), { recursive: true });
+    writeFileSync(join(appDir, 'dql.app.json'), JSON.stringify(appJson, null, 2) + '\n', 'utf-8');
+    writeFileSync(join(appDir, 'dashboards', 'overview.dqld'), JSON.stringify(overview, null, 2) + '\n', 'utf-8');
     const rel = relFromRoot(projectRoot, appDir);
     if (flags.format === 'json') {
-        console.log(JSON.stringify({ created: true, name: slug, path: rel, manifest }, null, 2));
+        console.log(JSON.stringify({ created: true, id, path: rel }, null, 2));
         return;
     }
-    console.log(`\n  ✓ Created app: ${slug}`);
+    console.log(`\n  ✓ Created app: ${id}`);
     console.log(`    Path: ${rel}`);
     console.log(`    Domain: ${domain}   Owner: ${owner}`);
     console.log('');
     console.log('  Next steps:');
-    console.log(`    1. Edit ${rel}/app.yml to describe consumers and cadence`);
-    console.log(`    2. dql notebook  (then open ${rel}/notebooks/overview.dqlnb)`);
+    console.log(`    1. Add blocks to your project under blocks/`);
+    console.log(`    2. Edit ${rel}/dashboards/overview.dqld to reference them`);
+    console.log(`    3. dql app build      # writes apps[] and dashboards[] into dql-manifest.json`);
+    console.log(`    4. dql notebook       # open the App in the desktop UI`);
     console.log('');
 }
+// ---- ls ----
 async function runAppList(flags) {
     const projectRoot = findProjectRoot(process.cwd());
-    const apps = discoverApps(projectRoot);
+    const apps = collectApps(projectRoot);
     if (flags.format === 'json') {
         console.log(JSON.stringify({ apps }, null, 2));
         return;
     }
     if (apps.length === 0) {
-        console.log('No apps found. Create one with: dql app new <name> --domain <domain>');
+        console.log('No apps found. Create one with: dql app new <id> --domain <domain>');
         return;
     }
-    for (const app of apps) {
-        console.log(`${app.manifest.name.padEnd(28)} domain=${app.manifest.domain.padEnd(12)} owner=${app.manifest.owner ?? '-'}`);
+    for (const a of apps) {
+        const member = `${a.members.length} member${a.members.length === 1 ? '' : 's'}`;
+        const dash = `${a.dashboards.length} dashboard${a.dashboards.length === 1 ? '' : 's'}`;
+        console.log(`${a.id.padEnd(28)} domain=${a.domain.padEnd(12)} ${member.padEnd(12)} ${dash}`);
     }
 }
+// ---- show ----
 async function runAppShow(rest, flags) {
-    const name = rest[0];
-    if (!name)
-        throw new Error('Usage: dql app show <name>');
+    const id = rest[0];
+    if (!id)
+        throw new Error('Usage: dql app show <id>');
     const projectRoot = findProjectRoot(process.cwd());
-    const app = loadAppByName(projectRoot, name);
+    const apps = collectApps(projectRoot);
+    const app = apps.find((a) => a.id === id);
     if (!app)
-        throw new Error(`No app named "${name}" under ${APPS_ROOT}/`);
+        throw new Error(`No app named "${id}" under ${APPS_ROOT}/`);
     if (flags.format === 'json') {
         console.log(JSON.stringify(app, null, 2));
         return;
     }
-    console.log(`App: ${app.manifest.name}`);
-    console.log(`  domain:      ${app.manifest.domain}`);
-    console.log(`  owner:       ${app.manifest.owner ?? '-'}`);
-    console.log(`  description: ${app.manifest.description ?? '-'}`);
-    console.log(`  cadence:     ${app.manifest.cadence ?? '-'}`);
-    console.log(`  consumers:   ${(app.manifest.consumers ?? []).join(', ') || '-'}`);
-    console.log(`  entryPoints: ${(app.manifest.entryPoints ?? []).join(', ') || '-'}`);
-    console.log(`  notebooks:   ${app.notebooks.length}`);
-    console.log(`  dashboards:  ${app.dashboards.length}`);
-}
-function discoverApps(projectRoot) {
-    const appsRoot = join(projectRoot, APPS_ROOT);
-    let entries;
-    try {
-        entries = readdirSync(appsRoot, { withFileTypes: true });
+    console.log(`App: ${app.name} (${app.id})`);
+    console.log(`  domain:      ${app.domain}`);
+    console.log(`  owners:      ${app.owners.join(', ')}`);
+    console.log(`  description: ${app.description ?? '-'}`);
+    console.log(`  members:     ${app.members.length}`);
+    for (const m of app.members) {
+        console.log(`    - ${m.userId} [${m.roles.join(', ')}]`);
     }
-    catch {
-        return [];
-    }
-    const results = [];
-    for (const entry of entries) {
-        if (!entry.isDirectory() || !entry.name.endsWith(APP_DIR_SUFFIX))
-            continue;
-        const app = readApp(projectRoot, join(appsRoot, entry.name));
-        if (app)
-            results.push(app);
+    console.log(`  policies:    ${app.policies.length}`);
+    console.log(`  schedules:   ${app.schedules.length}`);
+    console.log(`  dashboards:  ${app.dashboards.length}`);
+    for (const d of app.dashboards) {
+        console.log(`    - ${d.id} (${d.title})`);
     }
-    return results.sort((a, b) => a.manifest.name.localeCompare(b.manifest.name));
-}
-function loadAppByName(projectRoot, name) {
-    const slug = toSlug(name);
-    return readApp(projectRoot, join(projectRoot, APPS_ROOT, `${slug}${APP_DIR_SUFFIX}`));
 }
-function readApp(projectRoot, appDir) {
-    let raw;
-    try {
-        raw = readFileSync(join(appDir, 'app.yml'), 'utf-8');
-    }
-    catch {
-        return null;
+// ---- build ----
+async function runAppBuild(flags) {
+    const projectRoot = findProjectRoot(process.cwd());
+    // Build the manifest with dbt import resolved the same way `dql compile`
+    // does, so `dql app build` produces an identical on-disk artifact.
+    const dbtManifestPath = resolveDbtManifestPath(projectRoot) ?? undefined;
+    const manifest = buildManifest({ projectRoot, dbtManifestPath });
+    // Persist the manifest to dql-manifest.json — without this the App + the
+    // dashboards never land in the on-disk artifact, so downstream consumers
+    // (KG reindex, lineage CLI, the desktop UI) keep reading the previous build.
+    const manifestPath = join(projectRoot, 'dql-manifest.json');
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+    const json = flags.format === 'json';
+    const apps = manifest.apps ?? {};
+    const dashboards = manifest.dashboards ?? {};
+    const diagnostics = (manifest.diagnostics ?? []).filter((d) => d.filePath?.startsWith('apps/') ?? false);
+    if (json) {
+        console.log(JSON.stringify({
+            apps: Object.values(apps).map((a) => ({ id: a.id, name: a.name, dashboards: a.dashboards })),
+            dashboards: Object.values(dashboards).map((d) => ({
+                id: d.id,
+                appId: d.appId,
+                blockIds: d.blockIds,
+                unresolvedRefs: d.unresolvedRefs,
+            })),
+            manifestPath: relative(projectRoot, manifestPath),
+            diagnostics,
+        }, null, 2));
+        return;
     }
-    try {
-        const manifest = loadYaml(raw);
-        if (!manifest || !manifest.name || !manifest.domain)
-            return null;
-        return {
-            path: relFromRoot(projectRoot, appDir),
-            manifest,
-            notebooks: listTree(join(appDir, 'notebooks'), '.dqlnb'),
-            dashboards: listTree(join(appDir, 'dashboards'), '.dql'),
-        };
+    console.log(`\n  ✓ Built ${Object.keys(apps).length} app(s), ${Object.keys(dashboards).length} dashboard(s).`);
+    for (const a of Object.values(apps)) {
+        console.log(`    - ${a.id}: ${a.dashboards.length} dashboard(s)`);
     }
-    catch {
-        return null;
+    console.log(`\n  Manifest written to: ${relative(projectRoot, manifestPath)}`);
+    if (diagnostics.length > 0) {
+        console.log('\n  Diagnostics:');
+        for (const d of diagnostics) {
+            console.log(`    [${d.severity}] ${d.filePath ?? ''}: ${d.message}`);
+        }
     }
+    console.log('');
 }
-function listTree(dir, ext) {
-    let entries;
-    try {
-        entries = readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return [];
+// ---- reindex (alias hook for the agent KG package) ----
+async function runAppReindex(flags) {
+    const { reindexProject } = await import('@duckcodeailabs/dql-agent');
+    const projectRoot = findProjectRoot(process.cwd());
+    const stats = await reindexProject(projectRoot);
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({ ok: true, ...stats }, null, 2));
+        return;
     }
+    console.log(`  ✓ Knowledge graph reindexed — ${stats.nodes} nodes, ${stats.edges} edges, ${stats.skills} skill(s).`);
+}
+function collectApps(projectRoot) {
     const out = [];
-    for (const entry of entries) {
-        const full = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            out.push(...listTree(full, ext).map((n) => `${entry.name}/${n}`));
-        }
-        else if (entry.isFile() && entry.name.endsWith(ext)) {
-            out.push(entry.name);
+    for (const appJsonPath of findAppDocuments(projectRoot)) {
+        const { document } = loadAppDocument(appJsonPath);
+        if (!document)
+            continue;
+        const appDir = appJsonPath.slice(0, -'/dql.app.json'.length);
+        const dashboardSummaries = [];
+        for (const dqldPath of findDashboardsForApp(appDir)) {
+            const { document: d } = loadDashboardDocument(dqldPath);
+            if (d)
+                dashboardSummaries.push({ id: d.id, title: d.metadata.title });
         }
+        out.push({
+            id: document.id,
+            name: document.name,
+            description: document.description,
+            domain: document.domain,
+            owners: document.owners,
+            tags: document.tags ?? [],
+            filePath: relative(projectRoot, appDir),
+            members: document.members.map((m) => ({
+                userId: m.userId,
+                displayName: m.displayName,
+                roles: m.roles,
+                attributes: m.attributes,
+            })),
+            roles: document.roles,
+            policies: document.policies.map((p) => ({
+                id: p.id,
+                description: p.description,
+                domain: p.domain,
+                minClassification: p.minClassification,
+                allowedRoles: p.allowedRoles,
+                allowedUsers: p.allowedUsers,
+                accessLevel: p.accessLevel,
+                enabled: p.enabled === undefined ? true : Boolean(p.enabled),
+            })),
+            rlsBindings: document.rlsBindings ?? [],
+            schedules: (document.schedules ?? []).map((s) => ({
+                id: s.id,
+                cron: s.cron,
+                dashboard: s.dashboard,
+                deliver: s.deliver,
+                description: s.description,
+                enabled: s.enabled === undefined ? true : Boolean(s.enabled),
+            })),
+            dashboards: dashboardSummaries,
+            homepage: document.homepage,
+        });
     }
-    return out;
+    return out.sort((a, b) => a.name.localeCompare(b.name));
 }
-function relFromRoot(projectRoot, path) {
+function relFromRoot(projectRoot, p) {
     const prefix = projectRoot.endsWith('/') ? projectRoot : `${projectRoot}/`;
-    return path.startsWith(prefix) ? path.slice(prefix.length) : basename(path);
-}
-function toSlug(value) {
-    return (value
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '_')
-        .replace(/^_+|_+$/g, '') || 'app');
+    return p.startsWith(prefix) ? p.slice(prefix.length) : p;
 }
-function titleFromSlug(slug) {
-    return slug
-        .split('_')
+function humanise(id) {
+    return id
+        .split(/[-_]/)
         .filter(Boolean)
-        .map((w) => `${w[0]?.toUpperCase() || ''}${w.slice(1)}`)
-        .join(' ');
+        .map((w) => `${w[0]?.toUpperCase() ?? ''}${w.slice(1)}`)
+        .join(' ') || id;
 }
+// Export internal helpers for tests.
+export const __test__ = {
+    collectApps,
+    humanise,
+};
+// reference unused readdirSync/readFileSync to keep imports stable for future use
+void readdirSync;
+void readFileSync;
 //# sourceMappingURL=app.js.map