@cleocode/adapters 2026.5.108 → 2026.5.109

package/dist/index.js

@@ -861,6 +861,189 @@ var init_credentials = __esm({
   }
 });
 
+// packages/core/src/store/db-inventory.json
+var db_inventory_default;
+var init_db_inventory = __esm({
+  "packages/core/src/store/db-inventory.json"() {
+    db_inventory_default = {
+      $schemaNote: "SSoT machine-readable inventory of every CLEO SQLite database. Consumed by T10307 fleet survey, T10310 pragma drift, T10311 migration coverage, T10312 doctor integrity, T10320 cross-DB invariants. Owned by Saga T10281 SG-BRAIN-DB-RESILIENCE / Epic T10282 E1-DB-INVENTORY (task T10305). Amend together with ADR-068 charter; the CI drift gate (forthcoming under E1) compares entries to disk reality.",
+      $pathTokens: {
+        "<projectRoot>": "Resolved at runtime from CLEO_ROOT env var or process.cwd(). Substituted by SSoT helpers `getCleoProjectDir()` in packages/brain/src/cleo-home.ts.",
+        $XDG_DATA_HOME: "Resolved via env-paths through `getCleoHome()` in @cleocode/paths. Linux: ~/.local/share/cleo/, macOS: ~/Library/Application Support/cleo/."
+      },
+      entries: [
+        {
+          role: "tasks",
+          tier: "project",
+          filePathTemplate: "<projectRoot>/.cleo/tasks.db",
+          drizzleSchemaPath: "packages/core/src/store/tasks-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-tasks/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "openCleoDb('tasks', cwd)",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: ".cleo/backups/sqlite/tasks-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 1; ADR-013 \xA79"
+        },
+        {
+          role: "brain",
+          tier: "project",
+          filePathTemplate: "<projectRoot>/.cleo/brain.db",
+          drizzleSchemaPath: "packages/core/src/store/memory-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-brain/",
+          ownerPackage: "@cleocode/brain",
+          openedVia: "openCleoDb('brain', cwd)",
+          concurrency: "single-writer",
+          privacy: "local-only-pii",
+          backupPath: ".cleo/backups/sqlite/brain-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 2; ADR-013 \xA79; audit \xA72 (P0 malformed 2026-05-23)"
+        },
+        {
+          role: "conduit",
+          tier: "project",
+          filePathTemplate: "<projectRoot>/.cleo/conduit.db",
+          drizzleSchemaPath: "packages/core/src/store/conduit-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-conduit/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "openCleoDb('conduit', cwd)",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: ".cleo/backups/sqlite/conduit-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 3; ADR-037 (signaldock\u2192conduit split)"
+        },
+        {
+          role: "manifest",
+          tier: "derived",
+          filePathTemplate: "<projectRoot>/.cleo/blobs/manifest.db",
+          drizzleSchemaPath: "packages/core/src/store/llmtxt-blob-adapter.ts",
+          migrationsDir: null,
+          ownerPackage: "@cleocode/core",
+          openedVia: "CleoBlobStore via llmtxt/blob BlobFsAdapter (no openCleoDb role registered)",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: "rebuildable-from-blob-store",
+          documentedIn: "ADR-068 row 7 (derived); schema owned by llmtxt/blob BlobFsAdapter contract"
+        },
+        {
+          role: "llmtxt",
+          tier: "project",
+          filePathTemplate: "<projectRoot>/.cleo/llmtxt/llmtxt.db",
+          drizzleSchemaPath: null,
+          migrationsDir: null,
+          ownerPackage: "@cleocode/llmtxt-core",
+          openedVia: "openCleoDb('llmtxt', cwd) \u2014 RESERVED; opener throws 'not yet implemented' (see open-cleo-db.ts L138)",
+          concurrency: "single-writer",
+          privacy: "local-only-pii",
+          backupPath: ".cleo/backups/sqlite/llmtxt-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 8 (reserved); audit \xA71.1 row 4 (live at .cleo/llmtxt/llmtxt.db)"
+        },
+        {
+          role: "nexus",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/nexus.db",
+          drizzleSchemaPath: "packages/core/src/store/nexus-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-nexus/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "openCleoDb('nexus')",
+          concurrency: "single-writer",
+          privacy: "local-only-pii",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/nexus-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 5"
+        },
+        {
+          role: "signaldock-project",
+          tier: "project",
+          filePathTemplate: "<projectRoot>/.cleo/signaldock.db",
+          drizzleSchemaPath: "packages/core/src/store/signaldock-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-signaldock/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "HISTORICAL \u2014 project-tier signaldock.db was migrated into conduit.db post-T310/ADR-037. No live opener; charter row retained for migration provenance and legacy backup detection.",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: ".cleo/backups/sqlite/signaldock-project-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 4 (stale \u2014 superseded by ADR-037); audit \xA71.1 (not in live project DB list)"
+        },
+        {
+          role: "signaldock-global",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/signaldock.db",
+          drizzleSchemaPath: "packages/core/src/store/signaldock-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-signaldock/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "openCleoDb('signaldock')",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/signaldock-global-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 9; ADR-037 (post-split global identity registry)"
+        },
+        {
+          role: "telemetry",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/telemetry.db",
+          drizzleSchemaPath: "packages/core/src/telemetry/schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-telemetry/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "@cleocode/core telemetry/sqlite.ts \u2014 lazy open on first event when opted-in; not yet registered as openCleoDb role",
+          concurrency: "single-writer",
+          privacy: "cloud-exportable-opt-in",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/telemetry-YYYYMMDD-HHmmss.db",
+          documentedIn: "ADR-068 row 6; T624"
+        },
+        {
+          role: "skills",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/skills.db",
+          drizzleSchemaPath: "packages/core/src/store/skills-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-skills/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "openCleoDb('skills')",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/skills-YYYYMMDD-HHmmss.db",
+          documentedIn: "T9651 (initial skills.db migration); audit \xA71.2 row 4 \u2014 NOT yet in ADR-068 table"
+        },
+        {
+          role: "global-brain",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/brain.db",
+          drizzleSchemaPath: "packages/core/src/store/memory-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-brain/",
+          ownerPackage: "@cleocode/brain",
+          openedVia: "UNREGISTERED \u2014 file exists on disk (audit \xA71.2 row 3) but no live opener. Provenance unclear; likely orphan from a getCleoHome()-vs-project-resolution path bug. Tracked for cleanup decision under T10282/T10307.",
+          concurrency: "single-writer",
+          privacy: "local-only-pii",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/global-brain-YYYYMMDD-HHmmss.db",
+          documentedIn: "audit \xA71.2 row 3 \u2014 NEW per saga T10281; not in ADR-068"
+        },
+        {
+          role: "global-tasks",
+          tier: "global",
+          filePathTemplate: "$XDG_DATA_HOME/cleo/tasks.db",
+          drizzleSchemaPath: "packages/core/src/store/tasks-schema.ts",
+          migrationsDir: "packages/core/migrations/drizzle-tasks/",
+          ownerPackage: "@cleocode/core",
+          openedVia: "UNREGISTERED \u2014 file exists on disk (audit \xA71.2 row 5, 4 KB) but no live opener. Provenance unclear; likely orphan from a cwd-cascade bug (T9550 class). Tracked for cleanup decision under T10282/T10307.",
+          concurrency: "single-writer",
+          privacy: "local-only",
+          backupPath: "$XDG_DATA_HOME/cleo/backups/sqlite/global-tasks-YYYYMMDD-HHmmss.db",
+          documentedIn: "audit \xA71.2 row 5 \u2014 NEW per saga T10281; not in ADR-068"
+        }
+      ]
+    };
+  }
+});
+
+// packages/contracts/src/db-inventory.ts
+var rawInventory, DB_INVENTORY;
+var init_db_inventory2 = __esm({
+  "packages/contracts/src/db-inventory.ts"() {
+    "use strict";
+    init_db_inventory();
+    rawInventory = db_inventory_default;
+    DB_INVENTORY = rawInventory.entries;
+  }
+});
+
 // packages/contracts/src/dispatch/identity.ts
 var init_identity = __esm({
   "packages/contracts/src/dispatch/identity.ts"() {
@@ -1783,6 +1966,7 @@ var init_src = __esm({
     init_changesets();
     init_cli_category();
     init_credentials();
+    init_db_inventory2();
     init_identity();
     init_operations_registry();
     init_docs_taxonomy();