@cleocode/core 2026.3.41 → 2026.3.43

package/dist/store/nexus-schema.d.ts

@@ -0,0 +1,503 @@
+/**
+ * Drizzle ORM schema for CLEO nexus.db (SQLite via node:sqlite + sqlite-proxy).
+ *
+ * Tables: project_registry, nexus_audit_log, nexus_schema_meta
+ * Stores cross-project registry and audit infrastructure for the Nexus domain.
+ *
+ * @task T5365
+ */
+/** Central registry of all CLEO projects known to the Nexus. */
+export declare const projectRegistry: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "project_registry";
+    schema: undefined;
+    columns: {
+        projectId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        projectHash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        projectPath: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        registeredAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        lastSeen: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        healthStatus: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        healthLastCheck: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        permissions: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        lastSync: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        taskCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        labelsJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "project_registry";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Append-only audit log for all Nexus operations across projects. */
+export declare const nexusAuditLog: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "nexus_audit_log";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        timestamp: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        action: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        projectHash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        projectId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        domain: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        operation: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        sessionId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        requestId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        source: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        gateway: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        success: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        durationMs: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "number int53";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        detailsJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        errorMessage: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_audit_log";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Key-value store for nexus.db schema versioning and metadata. */
+export declare const nexusSchemaMeta: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "nexus_schema_meta";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_schema_meta";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+        value: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: string;
+            tableName: "nexus_schema_meta";
+            dataType: "string";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}>;
+    };
+    dialect: "sqlite";
+}>;
+export type ProjectRegistryRow = typeof projectRegistry.$inferSelect;
+export type NewProjectRegistryRow = typeof projectRegistry.$inferInsert;
+export type NexusAuditLogRow = typeof nexusAuditLog.$inferSelect;
+export type NewNexusAuditLogRow = typeof nexusAuditLog.$inferInsert;
+export type NexusSchemaMetaRow = typeof nexusSchemaMeta.$inferSelect;
+export type NewNexusSchemaMetaRow = typeof nexusSchemaMeta.$inferInsert;
+//# sourceMappingURL=nexus-schema.d.ts.map

package/dist/store/nexus-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-schema.d.ts","sourceRoot":"","sources":["../../src/store/nexus-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,gEAAgE;AAChE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB3B,CAAC;AAIF,sEAAsE;AACtE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BzB,CAAC;AAIF,mEAAmE;AACnE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG1B,CAAC;AAIH,MAAM,MAAM,kBAAkB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AACjE,MAAM,MAAM,mBAAmB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC"}

package/dist/store/nexus-sqlite.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SQLite store for nexus.db via drizzle-orm/node-sqlite + node:sqlite (DatabaseSync).
+ *
+ * Separate database from tasks.db and brain.db for cross-project registry
+ * and audit infrastructure. Follows the same singleton + WAL + migration
+ * pattern as brain-sqlite.ts.
+ *
+ * nexus.db lives in ~/.cleo/ (global home) rather than per-project .cleo/,
+ * since it stores cross-project data.
+ *
+ * @task T5365
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
+import * as nexusSchema from './nexus-schema.js';
+/** Schema version for newly created nexus databases. Single source of truth. */
+export declare const NEXUS_SCHEMA_VERSION = "1.0.0";
+/**
+ * Get the path to the nexus.db SQLite database file.
+ * nexus.db lives in the global ~/.cleo/ directory.
+ */
+export declare function getNexusDbPath(): string;
+/**
+ * Resolve the path to the drizzle-nexus migrations folder.
+ * Works from both src/ (dev via tsx) and dist/ (compiled).
+ */
+export declare function resolveNexusMigrationsFolder(): string;
+/**
+ * Initialize the nexus.db SQLite database (lazy, singleton).
+ * Creates the database file and tables if they don't exist.
+ * Returns the drizzle ORM instance (async via sqlite-proxy).
+ *
+ * Uses a promise guard so concurrent callers wait for the same
+ * initialization to complete (migrations are async).
+ */
+export declare function getNexusDb(): Promise<NodeSQLiteDatabase<typeof nexusSchema>>;
+/**
+ * Close the nexus.db database connection and release resources.
+ */
+export declare function closeNexusDb(): void;
+/**
+ * Reset nexus.db singleton state without saving.
+ * Used during tests or when database file is recreated.
+ * Safe to call multiple times.
+ */
+export declare function resetNexusDbState(): void;
+/**
+ * Get the underlying node:sqlite DatabaseSync instance for nexus.db.
+ * Useful for direct PRAGMA calls or raw SQL operations.
+ * Returns null if the database hasn't been initialized.
+ */
+export declare function getNexusNativeDb(): DatabaseSync | null;
+export type { NodeSQLiteDatabase };
+/**
+ * Re-export nexus schema for external use.
+ */
+export { nexusSchema };
+//# sourceMappingURL=nexus-sqlite.d.ts.map

package/dist/store/nexus-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-sqlite.d.ts","sourceRoot":"","sources":["../../src/store/nexus-sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAMjD,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAS5C;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAKrD;AAiFD;;;;;;;GAOG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC,OAAO,WAAW,CAAC,CAAC,CA+ClF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAanC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAEtD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC"}