@duckcodeailabs/dql-project 1.4.4 → 1.5.1

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { RegistrySync } from './sync.js';
 export type { SyncResult, SyncOptions, ParsedBlock } from './sync.js';
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
+export { LocalAppStorage, defaultLocalAppsDbPath, } from './local-app-storage.js';
+export type { LocalAiPin, CreateLocalAiPinInput, LocalAiPinRefreshCadence, LocalAiPinReviewStatus, LocalAppVisibility, } from './local-app-storage.js';
 export { ManifestCache } from './manifest-cache.js';
 export type { TrackedFile, CacheHit, CacheMiss, CacheLookup, ManifestCacheOptions, } from './manifest-cache.js';
 export { PersonaRegistry, defaultPersonaRegistry, personaFromMember, OWNER_DEFAULT, } from './persona.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@ export { VersionManager } from './version-manager.js';
 export { RegistrySync } from './sync.js';
 export { MemoryStorage } from './memory-storage.js';
 export { SQLiteStorage } from './sqlite-storage.js';
+export { LocalAppStorage, defaultLocalAppsDbPath, } from './local-app-storage.js';
 export { ManifestCache } from './manifest-cache.js';
 // Persona registry — runtime active-user state used by the governance and
 // RLS layers. The Apps/Dashboards file format itself lives in dql-core

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,0EAA0E;AAC1E,uEAAuE;AACvE,mEAAmE;AACnE,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,0EAA0E;AAC1E,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,0EAA0E;AAC1E,uEAAuE;AACvE,mEAAmE;AACnE,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,0EAA0E;AAC1E,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}

package/dist/local-app-storage.d.ts

@@ -0,0 +1,57 @@
+export type LocalAppVisibility = 'mine' | 'shared' | 'template';
+export type LocalAiPinRefreshCadence = 'none' | 'daily';
+export type LocalAiPinReviewStatus = 'needs_review' | 'draft_created' | 'certified' | 'rejected';
+export interface LocalAiPin {
+    id: string;
+    appId: string;
+    dashboardId: string;
+    tileId?: string;
+    title: string;
+    answer: string;
+    sql?: string;
+    sourceTier?: string;
+    certification: 'certified' | 'ai_generated';
+    reviewStatus: LocalAiPinReviewStatus;
+    refreshCadence: LocalAiPinRefreshCadence;
+    chartConfig?: Record<string, unknown>;
+    result?: unknown;
+    citations?: unknown[];
+    createdAt: string;
+    updatedAt: string;
+    lastRefreshedAt?: string;
+    lastRefreshError?: string;
+    promotedBlockPath?: string;
+}
+export interface CreateLocalAiPinInput {
+    id?: string;
+    appId: string;
+    dashboardId: string;
+    tileId?: string;
+    title: string;
+    answer: string;
+    sql?: string;
+    sourceTier?: string;
+    certification?: 'certified' | 'ai_generated';
+    reviewStatus?: LocalAiPinReviewStatus;
+    refreshCadence?: LocalAiPinRefreshCadence;
+    chartConfig?: Record<string, unknown>;
+    result?: unknown;
+    citations?: unknown[];
+}
+export declare function defaultLocalAppsDbPath(projectRoot: string): string;
+/**
+ * Local-only App state. Shared Apps remain file-backed under apps/<id>/;
+ * this store is intentionally for personal/private overlays and AI pins.
+ */
+export declare class LocalAppStorage {
+    private db;
+    constructor(dbPath: string);
+    close(): void;
+    createAiPin(input: CreateLocalAiPinInput): LocalAiPin;
+    getAiPin(id: string): LocalAiPin | null;
+    listAiPins(appId?: string, dashboardId?: string): LocalAiPin[];
+    updateAiPinResult(id: string, result: unknown, error?: string): LocalAiPin | null;
+    markAiPinPromoted(id: string, blockPath: string): LocalAiPin | null;
+    private initSchema;
+}
+//# sourceMappingURL=local-app-storage.d.ts.map

package/dist/local-app-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-storage.d.ts","sourceRoot":"","sources":["../src/local-app-storage.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,OAAO,CAAC;AACxD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,WAAW,GAAG,cAAc,CAAC;IAC5C,YAAY,EAAE,sBAAsB,CAAC;IACrC,cAAc,EAAE,wBAAwB,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;IAC7C,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAO1B,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU;IA+CrD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKvC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAgB9D,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUjF,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUnE,OAAO,CAAC,UAAU;CA0DnB"}

package/dist/local-app-storage.js

@@ -0,0 +1,191 @@
+import Database from 'better-sqlite3';
+import { dirname } from 'node:path';
+import { mkdirSync } from 'node:fs';
+export function defaultLocalAppsDbPath(projectRoot) {
+    return `${projectRoot}/.dql/local/apps.sqlite`;
+}
+/**
+ * Local-only App state. Shared Apps remain file-backed under apps/<id>/;
+ * this store is intentionally for personal/private overlays and AI pins.
+ */
+export class LocalAppStorage {
+    db;
+    constructor(dbPath) {
+        mkdirSync(dirname(dbPath), { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.initSchema();
+    }
+    close() {
+        this.db.close();
+    }
+    createAiPin(input) {
+        const now = new Date().toISOString();
+        const pin = {
+            id: input.id ?? `pin_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            appId: input.appId,
+            dashboardId: input.dashboardId,
+            tileId: input.tileId,
+            title: input.title,
+            answer: input.answer,
+            sql: input.sql,
+            sourceTier: input.sourceTier,
+            certification: input.certification ?? 'ai_generated',
+            reviewStatus: input.reviewStatus ?? 'needs_review',
+            refreshCadence: input.refreshCadence ?? 'none',
+            chartConfig: input.chartConfig,
+            result: input.result,
+            citations: input.citations,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.db.prepare(`
+      INSERT INTO ai_pins (
+        id, app_id, dashboard_id, tile_id, title, answer, sql, source_tier,
+        certification, review_status, refresh_cadence, chart_config, result,
+        citations, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(pin.id, pin.appId, pin.dashboardId, pin.tileId ?? null, pin.title, pin.answer, pin.sql ?? null, pin.sourceTier ?? null, pin.certification, pin.reviewStatus, pin.refreshCadence, json(pin.chartConfig), json(pin.result), json(pin.citations ?? []), pin.createdAt, pin.updatedAt);
+        return pin;
+    }
+    getAiPin(id) {
+        const row = this.db.prepare('SELECT * FROM ai_pins WHERE id = ?').get(id);
+        return row ? rowToAiPin(row) : null;
+    }
+    listAiPins(appId, dashboardId) {
+        const clauses = [];
+        const params = [];
+        if (appId) {
+            clauses.push('app_id = ?');
+            params.push(appId);
+        }
+        if (dashboardId) {
+            clauses.push('dashboard_id = ?');
+            params.push(dashboardId);
+        }
+        const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+        const rows = this.db.prepare(`SELECT * FROM ai_pins ${where} ORDER BY updated_at DESC`).all(...params);
+        return rows.map(rowToAiPin);
+    }
+    updateAiPinResult(id, result, error) {
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      UPDATE ai_pins
+      SET result = ?, last_refreshed_at = ?, last_refresh_error = ?, updated_at = ?
+      WHERE id = ?
+    `).run(json(result), now, error ?? null, now, id);
+        return this.getAiPin(id);
+    }
+    markAiPinPromoted(id, blockPath) {
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      UPDATE ai_pins
+      SET review_status = 'draft_created', promoted_block_path = ?, updated_at = ?
+      WHERE id = ?
+    `).run(blockPath, now, id);
+        return this.getAiPin(id);
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS personal_apps (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        domain TEXT NOT NULL,
+        description TEXT,
+        visibility TEXT NOT NULL DEFAULT 'mine',
+        payload TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS personal_dashboards (
+        id TEXT NOT NULL,
+        app_id TEXT NOT NULL,
+        title TEXT NOT NULL,
+        payload TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        PRIMARY KEY (app_id, id)
+      );
+
+      CREATE TABLE IF NOT EXISTS layout_overrides (
+        app_id TEXT NOT NULL,
+        dashboard_id TEXT NOT NULL,
+        user_id TEXT NOT NULL DEFAULT 'local',
+        layout TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        PRIMARY KEY (app_id, dashboard_id, user_id)
+      );
+
+      CREATE TABLE IF NOT EXISTS ai_pins (
+        id TEXT PRIMARY KEY,
+        app_id TEXT NOT NULL,
+        dashboard_id TEXT NOT NULL,
+        tile_id TEXT,
+        title TEXT NOT NULL,
+        answer TEXT NOT NULL,
+        sql TEXT,
+        source_tier TEXT,
+        certification TEXT NOT NULL,
+        review_status TEXT NOT NULL,
+        refresh_cadence TEXT NOT NULL DEFAULT 'none',
+        chart_config TEXT,
+        result TEXT,
+        citations TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        last_refreshed_at TEXT,
+        last_refresh_error TEXT,
+        promoted_block_path TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_ai_pins_app_dashboard ON ai_pins(app_id, dashboard_id);
+      CREATE INDEX IF NOT EXISTS idx_ai_pins_review ON ai_pins(review_status);
+    `);
+    }
+}
+function rowToAiPin(row) {
+    return {
+        id: String(row.id),
+        appId: String(row.app_id),
+        dashboardId: String(row.dashboard_id),
+        tileId: optionalString(row.tile_id),
+        title: String(row.title),
+        answer: String(row.answer),
+        sql: optionalString(row.sql),
+        sourceTier: optionalString(row.source_tier),
+        certification: row.certification === 'certified' ? 'certified' : 'ai_generated',
+        reviewStatus: parseReviewStatus(row.review_status),
+        refreshCadence: row.refresh_cadence === 'daily' ? 'daily' : 'none',
+        chartConfig: parseJson(row.chart_config),
+        result: parseJson(row.result),
+        citations: parseJson(row.citations) ?? [],
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+        lastRefreshedAt: optionalString(row.last_refreshed_at),
+        lastRefreshError: optionalString(row.last_refresh_error),
+        promotedBlockPath: optionalString(row.promoted_block_path),
+    };
+}
+function parseReviewStatus(value) {
+    if (value === 'draft_created' || value === 'certified' || value === 'rejected')
+        return value;
+    return 'needs_review';
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function json(value) {
+    return value === undefined ? null : JSON.stringify(value);
+}
+function parseJson(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=local-app-storage.js.map

package/dist/local-app-storage.js.map

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

package/dist/local-app-storage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-app-storage.test.d.ts.map

package/dist/local-app-storage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-storage.test.d.ts","sourceRoot":"","sources":["../src/local-app-storage.test.ts"],"names":[],"mappings":""}

package/dist/local-app-storage.test.js

@@ -0,0 +1,37 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { LocalAppStorage } from './local-app-storage.js';
+let dir;
+let store;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'dql-local-apps-'));
+    store = new LocalAppStorage(join(dir, '.dql', 'local', 'apps.sqlite'));
+});
+afterEach(() => {
+    store.close();
+    rmSync(dir, { recursive: true, force: true });
+});
+describe('LocalAppStorage', () => {
+    it('stores AI pins and refresh metadata locally', () => {
+        const pin = store.createAiPin({
+            appId: 'executive-cockpit',
+            dashboardId: 'bank-overview',
+            title: 'AI summary',
+            answer: 'Deposits are growing.',
+            sql: 'SELECT 1 AS value',
+            chartConfig: { chart: 'single_value' },
+            result: { columns: ['value'], rows: [{ value: 1 }], rowCount: 1 },
+        });
+        expect(pin.reviewStatus).toBe('needs_review');
+        expect(store.listAiPins('executive-cockpit', 'bank-overview')).toHaveLength(1);
+        const refreshed = store.updateAiPinResult(pin.id, { columns: ['value'], rows: [{ value: 2 }], rowCount: 1 });
+        expect(refreshed?.lastRefreshedAt).toBeTruthy();
+        expect(refreshed?.lastRefreshError).toBeUndefined();
+        const promoted = store.markAiPinPromoted(pin.id, 'apps/executive-cockpit/drafts/ai_summary.dql');
+        expect(promoted?.reviewStatus).toBe('draft_created');
+        expect(promoted?.promotedBlockPath).toBe('apps/executive-cockpit/drafts/ai_summary.dql');
+    });
+});
+//# sourceMappingURL=local-app-storage.test.js.map

package/dist/local-app-storage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-storage.test.js","sourceRoot":"","sources":["../src/local-app-storage.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,IAAI,GAAW,CAAC;AAChB,IAAI,KAAsB,CAAC;AAE3B,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrD,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC;YAC5B,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,uBAAuB;YAC/B,GAAG,EAAE,mBAAmB;YACxB,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;YACtC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;SAClE,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE/E,MAAM,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7G,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAC;QAEpD,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,8CAA8C,CAAC,CAAC;QACjG,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-project",
-  "version": "1.4.4",
+  "version": "1.5.1",
   "description": "DQL project and block registry primitives: block metadata, versions, sync, and storage adapters",
   "license": "Apache-2.0",
   "type": "module",
@@ -24,8 +24,8 @@
     "access": "public"
   },
   "dependencies": {
-    "better-sqlite3": "^11.7.0",
-    "@duckcodeailabs/dql-core": "1.4.4"
+    "@duckcodeailabs/dql-core": "^1.5.1",
+    "better-sqlite3": "^11.7.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",