@duckcodeailabs/dql-cli 1.5.1 → 1.5.3

package/dist/apps-api.d.ts

@@ -12,6 +12,7 @@ interface Ctx {
     path: string;
     projectRoot: string;
     executeSql?: (sql: string) => Promise<unknown>;
+    runNotebook?: (appId: string, notebookPath: string) => Promise<void>;
 }
 export declare function handleAppsApi(ctx: Ctx): Promise<boolean>;
 type AppListEntry = {
@@ -62,6 +63,7 @@ interface AppRecommendationRequest {
 interface AppCreateRequest {
     name?: string;
     domain?: string;
+    dashboardTitle?: string;
     subdomain?: string;
     groups?: string[];
     purpose?: string;
@@ -97,5 +99,48 @@ export declare function createAppPackage(projectRoot: string, input: AppCreateRe
     ok: false;
     error: string;
 };
+declare function loadAppById(projectRoot: string, id: string): {
+    app: AppDocument;
+    dashboards: Array<{
+        id: string;
+        title: string;
+        description?: string;
+        itemCount: number;
+    }>;
+    notebooks: AppListEntry['notebooks'];
+    drafts: AppListEntry['drafts'];
+    aiPins: unknown[];
+} | null;
+export declare function listNotebookCandidates(projectRoot: string, app: AppDocument, appDir: string): Array<{
+    path: string;
+    title: string;
+    attached: boolean;
+    role?: 'source' | 'analysis' | 'supporting';
+    visibility?: NonNullable<AppDocument['visibility']>;
+    lastModified?: string;
+}>;
+export declare function createNotebookForApp(projectRoot: string, appId: string, input: {
+    name?: string;
+    title?: string;
+    role?: string;
+    visibility?: string;
+    template?: string;
+}): {
+    ok: true;
+    path: string;
+    app: ReturnType<typeof loadAppById>;
+    preview: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function previewNotebookForApp(projectRoot: string, appId: string, notebookPath: string): {
+    ok: true;
+    preview: unknown;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
 export {};
 //# sourceMappingURL=apps-api.d.ts.map

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

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

package/dist/apps-api.js

@@ -83,6 +83,73 @@ export async function handleAppsApi(ctx) {
         }
         return true;
     }
+    m = path.match(/^\/api\/apps\/([^/]+)\/notebook-candidates$/);
+    if (m && req.method === 'GET') {
+        const appId = decodeURIComponent(m[1]);
+        const loaded = loadAppById(projectRoot, appId);
+        if (!loaded) {
+            sendJson(res, 404, { error: `App "${appId}" not found` });
+            return true;
+        }
+        sendJson(res, 200, { notebooks: listNotebookCandidates(projectRoot, loaded.app, join(projectRoot, 'apps', appId)) });
+        return true;
+    }
+    m = path.match(/^\/api\/apps\/([^/]+)\/notebooks\/create$/);
+    if (m && req.method === 'POST') {
+        const appId = decodeURIComponent(m[1]);
+        try {
+            const body = await readJson(req);
+            const result = createNotebookForApp(projectRoot, appId, body);
+            if (!result.ok) {
+                sendJson(res, 400, { error: result.error });
+                return true;
+            }
+            sendJson(res, 201, result);
+        }
+        catch (err) {
+            sendJson(res, 500, { error: err.message });
+        }
+        return true;
+    }
+    m = path.match(/^\/api\/apps\/([^/]+)\/notebooks\/preview$/);
+    if (m && req.method === 'GET') {
+        const appId = decodeURIComponent(m[1]);
+        const notebookPath = ctx.url.searchParams.get('path') ?? '';
+        const result = previewNotebookForApp(projectRoot, appId, notebookPath);
+        if (!result.ok) {
+            sendJson(res, result.status, { error: result.error });
+            return true;
+        }
+        sendJson(res, 200, result.preview);
+        return true;
+    }
+    m = path.match(/^\/api\/apps\/([^/]+)\/notebooks\/run$/);
+    if (m && req.method === 'POST') {
+        const appId = decodeURIComponent(m[1]);
+        try {
+            const body = await readJson(req);
+            const notebookPath = cleanString(body.path);
+            if (!notebookPath) {
+                sendJson(res, 400, { error: 'path is required' });
+                return true;
+            }
+            if (!ctx.runNotebook) {
+                sendJson(res, 400, { error: 'Notebook run is unavailable in this host.' });
+                return true;
+            }
+            await ctx.runNotebook(appId, notebookPath);
+            const preview = previewNotebookForApp(projectRoot, appId, notebookPath);
+            if (!preview.ok) {
+                sendJson(res, preview.status, { error: preview.error });
+                return true;
+            }
+            sendJson(res, 200, { ok: true, preview: preview.preview });
+        }
+        catch (err) {
+            sendJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+        }
+        return true;
+    }
     m = path.match(/^\/api\/apps\/([^/]+)\/notebooks$/);
     if (m && req.method === 'POST') {
         const appId = decodeURIComponent(m[1]);
@@ -100,6 +167,79 @@ export async function handleAppsApi(ctx) {
         }
         return true;
     }
+    m = path.match(/^\/api\/apps\/([^/]+)\/conversations$/);
+    if (m) {
+        const appId = decodeURIComponent(m[1]);
+        if (!loadAppById(projectRoot, appId)) {
+            sendJson(res, 404, { error: `App "${appId}" not found` });
+            return true;
+        }
+        const storage = new LocalAppStorage(defaultLocalAppsDbPath(projectRoot));
+        try {
+            if (req.method === 'GET') {
+                sendJson(res, 200, { conversations: storage.listAppConversations(appId) });
+                return true;
+            }
+            if (req.method === 'POST') {
+                const body = await readJson(req);
+                const conversation = storage.createAppConversation({
+                    appId,
+                    title: body.title,
+                    dashboardId: body.dashboardId,
+                    notebookPath: body.notebookPath,
+                    messages: normalizeConversationMessages(body.messages),
+                });
+                sendJson(res, 201, { ok: true, conversation });
+                return true;
+            }
+        }
+        catch (err) {
+            sendJson(res, 500, { error: err.message });
+            return true;
+        }
+        finally {
+            storage.close();
+        }
+    }
+    m = path.match(/^\/api\/apps\/([^/]+)\/conversations\/([^/]+)$/);
+    if (m) {
+        const appId = decodeURIComponent(m[1]);
+        const conversationId = decodeURIComponent(m[2]);
+        const storage = new LocalAppStorage(defaultLocalAppsDbPath(projectRoot));
+        try {
+            const conversation = storage.getAppConversation(conversationId);
+            if (!conversation || conversation.appId !== appId) {
+                sendJson(res, 404, { error: `Conversation "${conversationId}" not found` });
+                return true;
+            }
+            if (req.method === 'GET') {
+                sendJson(res, 200, { conversation });
+                return true;
+            }
+            if (req.method === 'PATCH') {
+                const body = await readJson(req);
+                const updated = storage.updateAppConversation(conversationId, {
+                    title: body.title,
+                    dashboardId: body.dashboardId,
+                    notebookPath: body.notebookPath,
+                    messages: body.messages ? normalizeConversationMessages(body.messages) : undefined,
+                });
+                sendJson(res, 200, { ok: true, conversation: updated });
+                return true;
+            }
+            if (req.method === 'DELETE') {
+                sendJson(res, 200, { ok: storage.deleteAppConversation(conversationId) });
+                return true;
+            }
+        }
+        catch (err) {
+            sendJson(res, 500, { error: err.message });
+            return true;
+        }
+        finally {
+            storage.close();
+        }
+    }
     m = path.match(/^\/api\/apps\/([^/]+)\/ai-pins$/);
     if (m) {
         const appId = decodeURIComponent(m[1]);
@@ -388,6 +528,8 @@ export function createAppPackage(projectRoot, input) {
     const appDir = join(projectRoot, 'apps', id);
     if (existsSync(appDir))
         return { ok: false, error: `App already exists: ${id}` };
+    const dashboardTitle = cleanString(input.dashboardTitle) || 'Overview';
+    const dashboardId = slugify(dashboardTitle) || 'overview';
     const owner = cleanString(input.owners?.[0]) || `${process.env.USER ?? 'owner'}@local`;
     const audience = cleanString(input.audience);
     const subdomain = cleanString(input.subdomain);
@@ -451,13 +593,13 @@ export function createAppPackage(projectRoot, input) {
         ],
         rlsBindings: [],
         schedules: [],
-        homepage: { type: 'dashboard', id: 'overview' },
+        homepage: { type: 'dashboard', id: dashboardId },
     };
     const dashboard = {
         version: 1,
-        id: 'overview',
+        id: dashboardId,
         metadata: {
-            title: `${name} Overview`,
+            title: dashboardTitle,
             description: cleanString(input.purpose) || `Starter dashboard for ${name}`,
             domain,
             subdomain: subdomain || undefined,
@@ -477,7 +619,7 @@ export function createAppPackage(projectRoot, input) {
     const paths = [
         join(appDir, 'dql.app.json'),
         join(appDir, 'README.md'),
-        join(appDir, 'dashboards', 'overview.dqld'),
+        join(appDir, 'dashboards', `${dashboardId}.dqld`),
         join(appDir, 'notebooks'),
         join(appDir, 'drafts'),
     ];
@@ -485,8 +627,8 @@ export function createAppPackage(projectRoot, input) {
     mkdirSync(join(appDir, 'notebooks'), { recursive: true });
     mkdirSync(join(appDir, 'drafts'), { recursive: true });
     writeFileSync(join(appDir, 'dql.app.json'), JSON.stringify(app, null, 2) + '\n', 'utf-8');
-    writeFileSync(join(appDir, 'dashboards', 'overview.dqld'), JSON.stringify(dashboard, null, 2) + '\n', 'utf-8');
-    writeFileSync(join(appDir, 'README.md'), appReadme(app, audience, selectedBlocks), 'utf-8');
+    writeFileSync(join(appDir, 'dashboards', `${dashboardId}.dqld`), JSON.stringify(dashboard, null, 2) + '\n', 'utf-8');
+    writeFileSync(join(appDir, 'README.md'), appReadme(app, audience, selectedBlocks, dashboardId), 'utf-8');
     const created = collectAppsList(projectRoot).find((entry) => entry.id === id);
     if (!created)
         return { ok: false, error: `App was written but could not be reloaded: ${id}` };
@@ -494,7 +636,7 @@ export function createAppPackage(projectRoot, input) {
         ok: true,
         app: created,
         paths: paths.map((path) => path.startsWith(projectRoot) ? path.slice(projectRoot.length + 1) : path),
-        dashboardId: 'overview',
+        dashboardId,
     };
 }
 function buildDashboardItems(blocks) {
@@ -584,7 +726,7 @@ function normalizeVizType(chartType) {
         return 'funnel';
     return 'table';
 }
-function appReadme(app, audience, blocks) {
+function appReadme(app, audience, blocks, dashboardId = 'overview') {
     return [
         `# ${app.name}`,
         '',
@@ -597,7 +739,7 @@ function appReadme(app, audience, blocks) {
         `- Visibility: ${app.visibility}`,
         `- Lifecycle: ${app.lifecycle}`,
         `- Owners: ${app.owners.join(', ')}`,
-        `- Starter dashboard: dashboards/overview.dqld`,
+        `- Starter dashboard: dashboards/${dashboardId}.dqld`,
         `- Supporting notebooks: notebooks/`,
         `- Draft blocks: drafts/`,
         '',
@@ -684,6 +826,17 @@ function matchArray(source, regex) {
         .map((item) => item.trim().replace(/^"|"$/g, ''))
         .filter(Boolean);
 }
+function normalizeConversationMessages(messages) {
+    return (messages ?? [])
+        .map((message) => ({
+        id: cleanString(message.id) || undefined,
+        role: message.role === 'assistant' ? 'assistant' : 'user',
+        content: cleanString(message.content),
+        events: Array.isArray(message.events) ? message.events : [],
+        createdAt: cleanString(message.createdAt) || undefined,
+    }))
+        .filter((message) => message.content.length > 0);
+}
 function cleanString(value) {
     return typeof value === 'string' ? value.trim() : '';
 }
@@ -726,8 +879,8 @@ function createDashboardForApp(projectRoot, appId, input) {
     const loaded = loadAppById(projectRoot, appId);
     if (!loaded)
         return { ok: false, error: `App "${appId}" not found` };
-    const title = cleanString(input.title) || 'New tab';
-    const id = slugify(cleanString(input.id) || title) || `tab-${Date.now()}`;
+    const title = cleanString(input.title) || 'New page';
+    const id = slugify(cleanString(input.id) || title) || `page-${Date.now()}`;
     if (!/^[a-z0-9][a-z0-9_-]*$/i.test(id))
         return { ok: false, error: 'dashboard id must be folder-safe' };
     const appDir = join(projectRoot, 'apps', appId);
@@ -739,7 +892,7 @@ function createDashboardForApp(projectRoot, appId, input) {
         id,
         metadata: {
             title,
-            description: cleanString(input.description) || `${title} dashboard tab`,
+            description: cleanString(input.description) || `${title} dashboard page`,
             domain: loaded.app.domain,
             subdomain: loaded.app.subdomain,
             groups: loaded.app.groups ?? [],
@@ -925,6 +1078,120 @@ function loadAppById(projectRoot, id) {
     }
     return null;
 }
+export function listNotebookCandidates(projectRoot, app, appDir) {
+    const attached = new Map(listAppNotebookRefs(projectRoot, app, appDir).map((notebook) => [notebook.path, notebook]));
+    const files = new Map();
+    for (const root of ['notebooks', 'workbooks', 'apps']) {
+        for (const file of scanFiles(join(projectRoot, root), '.dqlnb')) {
+            const rel = relative(projectRoot, file).replaceAll('\\', '/');
+            files.set(rel, file);
+        }
+    }
+    for (const notebook of attached.values()) {
+        const abs = join(projectRoot, notebook.path);
+        if (existsSync(abs))
+            files.set(notebook.path, abs);
+    }
+    return Array.from(files.entries())
+        .map(([path, abs]) => {
+        const ref = attached.get(path);
+        const stat = statSyncSafe(abs);
+        return {
+            path,
+            title: ref?.title ?? notebookTitleFromFile(abs) ?? titleFromPath(path),
+            attached: Boolean(ref),
+            role: ref?.role,
+            visibility: ref?.visibility,
+            lastModified: stat?.mtime.toISOString(),
+        };
+    })
+        .sort((a, b) => Number(b.attached) - Number(a.attached) || a.title.localeCompare(b.title));
+}
+export function createNotebookForApp(projectRoot, appId, input) {
+    const loaded = loadAppById(projectRoot, appId);
+    if (!loaded)
+        return { ok: false, error: `App "${appId}" not found` };
+    const title = cleanString(input.title) || cleanString(input.name) || 'App analysis';
+    const slug = slugify(cleanString(input.name) || title) || `notebook-${Date.now()}`;
+    const appDir = join(projectRoot, 'apps', appId);
+    const relPath = `apps/${appId}/notebooks/${slug}.dqlnb`;
+    const absPath = join(projectRoot, relPath);
+    if (existsSync(absPath))
+        return { ok: false, error: `Notebook already exists: ${relPath}` };
+    mkdirSync(dirname(absPath), { recursive: true });
+    writeFileSync(absPath, buildAppNotebookTemplate(title, loaded.app, input.template), 'utf-8');
+    const attached = attachNotebookToApp(projectRoot, appId, {
+        path: relPath,
+        title,
+        role: normalizeNotebookRole(input.role),
+        visibility: input.visibility,
+    });
+    if (!attached.ok)
+        return { ok: false, error: attached.error };
+    const preview = previewNotebookForApp(projectRoot, appId, relPath);
+    return {
+        ok: true,
+        path: relPath,
+        app: loadAppById(projectRoot, appId),
+        preview: preview.ok ? preview.preview : null,
+    };
+}
+export function previewNotebookForApp(projectRoot, appId, notebookPath) {
+    if (!loadAppById(projectRoot, appId))
+        return { ok: false, status: 404, error: `App "${appId}" not found` };
+    const rel = cleanString(notebookPath).replaceAll('\\', '/');
+    if (!rel || rel.startsWith('/') || rel.includes('..') || !rel.endsWith('.dqlnb')) {
+        return { ok: false, status: 400, error: 'notebook path must be a project-relative .dqlnb path' };
+    }
+    const abs = join(projectRoot, rel);
+    if (!existsSync(abs))
+        return { ok: false, status: 404, error: `Notebook not found: ${rel}` };
+    try {
+        const raw = readFileSync(abs, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const snapshot = readNotebookRunSnapshot(abs);
+        const snapshotByCell = new Map();
+        for (const entry of snapshot?.cells ?? []) {
+            if (entry && typeof entry === 'object' && typeof entry.cellId === 'string') {
+                snapshotByCell.set(String(entry.cellId), entry);
+            }
+        }
+        const cells = (parsed.cells ?? []).map((cell, index) => {
+            const id = typeof cell.id === 'string' ? cell.id : `cell-${index + 1}`;
+            const snap = snapshotByCell.get(id);
+            return {
+                id,
+                type: typeof cell.type === 'string' ? cell.type : 'sql',
+                name: typeof cell.name === 'string' ? cell.name : typeof cell.title === 'string' ? cell.title : undefined,
+                content: typeof cell.content === 'string' ? cell.content : typeof cell.source === 'string' ? cell.source : '',
+                upstream: typeof cell.upstream === 'string' ? cell.upstream : undefined,
+                chartConfig: cell.chartConfig ?? cell.config,
+                tableConfig: cell.tableConfig,
+                singleValueConfig: cell.singleValueConfig,
+                pivotConfig: cell.pivotConfig,
+                status: snap?.status ?? 'idle',
+                result: snap?.result,
+                error: snap?.error,
+                executionCount: snap?.executionCount,
+                executedAt: snap?.executedAt,
+            };
+        });
+        return {
+            ok: true,
+            preview: {
+                path: rel,
+                title: parsed.title ?? parsed.metadata?.title ?? titleFromPath(rel),
+                metadata: parsed.metadata ?? {},
+                cells,
+                snapshotFound: Boolean(snapshot),
+                capturedAt: typeof snapshot?.capturedAt === 'string' ? snapshot.capturedAt : undefined,
+            },
+        };
+    }
+    catch (err) {
+        return { ok: false, status: 400, error: err instanceof Error ? err.message : String(err) };
+    }
+}
 function attachNotebookToApp(projectRoot, appId, input) {
     const notebookPath = cleanString(input.path).replaceAll('\\', '/');
     if (!notebookPath)
@@ -985,6 +1252,78 @@ function listAppNotebookRefs(projectRoot, app, appDir) {
     }
     return Array.from(byPath.values()).sort((a, b) => (a.title ?? a.path).localeCompare(b.title ?? b.path));
 }
+function buildAppNotebookTemplate(title, app, template) {
+    const normalizedTemplate = cleanString(template) || 'blank';
+    const cellId = (base) => `${slugify(base) || 'cell'}_${Math.random().toString(36).slice(2, 8)}`;
+    const intro = [
+        `# ${title}`,
+        '',
+        `App: ${app.name}`,
+        `Domain: ${[app.domain, app.subdomain, ...(app.groups ?? [])].filter(Boolean).join(' / ')}`,
+        '',
+        'Use this notebook for analysis that supports the App dashboard pages.',
+    ].join('\n');
+    const cells = [
+        {
+            id: cellId('intro'),
+            type: 'markdown',
+            content: intro,
+        },
+        {
+            id: cellId('starter-sql'),
+            type: 'sql',
+            name: 'starter_query',
+            content: '-- Write supporting SQL for this App here\nSELECT 1 AS value;',
+        },
+    ];
+    if (normalizedTemplate === 'summary') {
+        cells.push({
+            id: cellId('summary'),
+            type: 'markdown',
+            content: '## Notes\n\nAdd observations, assumptions, and follow-up questions here.',
+        });
+    }
+    return JSON.stringify({
+        dqlnbVersion: 1,
+        version: 1,
+        title,
+        metadata: {
+            description: `Supporting notebook for ${app.name}`,
+            status: 'draft',
+            categories: [app.domain, app.subdomain, ...(app.groups ?? [])].filter(Boolean),
+            createdAt: new Date().toISOString(),
+            modifiedAt: new Date().toISOString(),
+        },
+        cells,
+    }, null, 2) + '\n';
+}
+function notebookTitleFromFile(absPath) {
+    try {
+        const parsed = JSON.parse(readFileSync(absPath, 'utf-8'));
+        if (typeof parsed.title === 'string' && parsed.title.trim())
+            return parsed.title.trim();
+        if (typeof parsed.metadata?.title === 'string' && parsed.metadata.title.trim())
+            return parsed.metadata.title.trim();
+    }
+    catch {
+        // fall back to path-derived title
+    }
+    return null;
+}
+function readNotebookRunSnapshot(absNotebookPath) {
+    const snapshotPath = absNotebookPath.replace(/\.dqlnb$/i, '.run.json');
+    if (!existsSync(snapshotPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(snapshotPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeNotebookRole(value) {
+    return value === 'source' || value === 'analysis' ? value : 'supporting';
+}
 function listAppDrafts(projectRoot, appDir) {
     return scanFiles(join(appDir, 'drafts'), '.dql').map((file) => {
         const source = readFileSync(file, 'utf-8');