@cleocode/core 2026.5.134 → 2026.6.1

package/dist/store/skills-db.d.ts

@@ -1,32 +1,41 @@
 /**
- * Per-user skills.db lifecycle module — opener, migrations, helpers.
+ * Per-user skills registry lifecycle module — opener, helpers.
  *
- * `skills.db` is a global-tier SQLite database that lives next to `tasks.db`
- * and `brain.db` under `getCleoHome()` (e.g. `~/.local/share/cleo/skills.db`).
- * It stores the per-user skills registry described in
+ * The per-user skills registry is a global-tier domain described in
  * `docs/architecture/SG-CLEO-SKILLS-architecture-v3.md` §4.
  *
- * ## Chokepoint compliance (ADR-068 + D003)
- *
- * Every CLEO SQLite open MUST flow through `openCleoDb(role, cwd)`. This
- * module implements the `'skills'` branch of that chokepoint — it is the
- * ONLY place a raw `new DatabaseSync(...)` is permitted for skills.db,
- * because it sits under `packages/core/src/store/` which is allowlisted by
- * `scripts/lint-no-raw-db-opens.mjs`.
- *
- * ## Why not in conduit.db / signaldock.db?
- *
- * Per architecture v3 §1, the database boundaries are intentional:
- *   - `signaldock.db` — cross-project AGENT identity (global)
- *   - `tasks.db`     — per-project task tracking
- *   - `brain.db`     — per-project memory
- *   - `skills.db`    — per-user SKILL registry (this module, global)
- *
- * Skills are user-scoped (a single Claude install is one user), so they
- * live under `getCleoHome()` — never inside a project's `.cleo/` folder.
+ * ## E6-L5 — thin-facade migration (T11525)
+ *
+ * `openSkillsDb()` is now a thin facade that delegates the database open to
+ * {@link openDualScopeDb}('global') — the canonical dual-scope chokepoint
+ * (E3/E4 · T11512/T11517) already adopted by the tasks (E6-L1), brain (E6-L2),
+ * conduit (E6-L3), and nexus (E6-L4) domains. The skills registry tables now
+ * live inside the consolidated GLOBAL `cleo.db` under `getCleoHome()`, sharing
+ * the SAME native handle the nexus / signaldock global domains use — NOT a
+ * separate `skills.db` file.
+ *
+ * ## Why prefixed `skills_*` tables (no establishLegacy rebuild)
+ *
+ * Unlike nexus (E6-L4), the skills registry does NOT run its legacy
+ * `drizzle-skills` migration on the shared handle. That migration created BARE
+ * `skills` / `skill_usage` / … tables — and the bare `skills` name COLLIDES with
+ * the signaldock domain's own legacy `skills` slug-catalog now that both share
+ * one `cleo.db`. The consolidated `drizzle-cleo-global` migration already creates
+ * the registry tables under the domain-prefixed names (`skills_skills`,
+ * `skills_skill_usage`, …), column-identical to the legacy shape plus additive
+ * enum/timestamp/boolean CHECK constraints that ACCEPT every value the runtime
+ * writers produce (ISO-8601 text, 0/1 booleans — verified). So skills-db simply
+ * binds the (now prefix-renamed) `skillsSchema` drizzle queries to those
+ * already-created consolidated tables. No drop+rebuild is needed because there is
+ * no consolidated-vs-legacy shape incompatibility (the L4 precondition is absent).
+ *
+ * The residency MOVE of skills global→project and the exodus data copy from the
+ * legacy standalone `skills.db` are SEPARATE later tasks (T11553 / T11538).
  *
  * @task T9651
+ * @task T11525 - E6-L5: route openSkillsDb through openDualScopeDb('global') (SG-DB-SUBSTRATE-V2)
  * @epic T9571
+ * @epic T11249
  * @saga T9560
  * @adr ADR-068, ADR-069
  * @architecture docs/architecture/SG-CLEO-SKILLS-architecture-v3.md §4
@@ -35,46 +44,58 @@ import type { DatabaseSync } from 'node:sqlite';
 import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
 import * as skillsSchema from './schema/skills-schema.js';
 import { type NewSkillRow, type SkillRow, type SkillSourceType } from './schema/skills-schema.js';
-/** Database file name within `getCleoHome()`. */
+/**
+ * Legacy standalone skills.db file name within `getCleoHome()`.
+ *
+ * E6-L5 (T11525): the live skills registry now consolidates into the shared
+ * GLOBAL `cleo.db`; this literal is retained only for the backup/exodus paths
+ * that still read the pre-cutover standalone file.
+ */
 export declare const SKILLS_DB_FILENAME = "skills.db";
-/** Schema version stamped into `_skills_meta`. Bump on every schema change. */
+/** Schema version constant. Retained for compatibility with external re-exporters. */
 export declare const SKILLS_SCHEMA_VERSION = "2026.5.81";
 /**
- * Resolve the canonical filesystem path for `skills.db`.
+ * Resolve the canonical filesystem path for the skills registry DB.
  *
- * Always returns a path under `getCleoHome()`. Throws if the resolved path
- * somehow escapes that prefix — that would indicate a regression in
- * `getCleoHome()` itself and MUST be fixed at the source, not silently
- * tolerated.
+ * E6-L5 (T11525): resolves `getCleoHome()` + `cleo.db` — the consolidated GLOBAL
+ * `cleo.db` that now hosts the `skills_*` registry tables (the same path
+ * {@link openDualScopeDb}('global') opens). Always returns a path under
+ * `getCleoHome()`. Throws if the resolved path somehow escapes that prefix — that
+ * would indicate a regression in `getCleoHome()` itself and MUST be fixed at the
+ * source, not silently tolerated.
  *
- * @returns Absolute path to `skills.db`.
+ * @returns Absolute path to the consolidated `cleo.db`.
  * @throws {Error} If the resolved path is not under `getCleoHome()`.
  */
 export declare function getDefaultSkillsDbPath(): string;
-/**
- * Resolve the absolute path to the `drizzle-skills` migrations folder.
- *
- * Delegates to {@link resolveCorePackageMigrationsFolder} which handles the
- * three install layouts (workspace dev, bundled dist, global install) via
- * `import.meta.resolve()` with a `createRequire().resolve()` fallback.
- */
-export declare function resolveSkillsMigrationsFolder(): string;
 /**
  * Options for {@link openSkillsDb}.
  */
 export interface OpenSkillsDbOptions {
     /**
      * Override the on-disk path. Used by tests; production callers should
-     * leave this `undefined` to let the module resolve `getDefaultSkillsDbPath()`.
+     * leave this `undefined` to let the module resolve {@link getDefaultSkillsDbPath}.
+     *
+     * E6-L5 (T11525): the override path is opened as a consolidated GLOBAL
+     * `cleo.db` (the prefixed `skills_*` tables are created by the consolidated
+     * migration) via {@link openDualScopeDbAtPath}, so a test passing
+     * `<tmpdir>/skills.db` materialises an isolated consolidated DB at that exact
+     * path — distinct cache key from the canonical `cleo.db`.
      */
     path?: string;
 }
 /**
- * Open (or first-time materialise) `skills.db` and return the Drizzle handle.
- *
- * Idempotent: repeated calls with the same effective path return the cached
- * singleton. Concurrent callers share a single in-flight init promise so
- * migrations never race.
+ * Open (or first-time materialise) the skills registry and return the Drizzle
+ * handle bound to the prefixed `skills_*` tables.
+ *
+ * E6-L5 (T11525): delegates the physical open to {@link openDualScopeDb}('global')
+ * (or {@link openDualScopeDbAtPath} for the test `{ path }` override) — the
+ * canonical dual-scope chokepoint — and re-wraps its native handle with the
+ * prefix-renamed `skillsSchema` drizzle instance. The consolidated
+ * `drizzle-cleo-global` migration creates the `skills_*` tables; this module does
+ * NOT run the legacy `drizzle-skills` migration (which would create the
+ * signaldock-colliding bare `skills` table). Idempotent: repeated calls with the
+ * same effective path return the cached singleton.
  *
  * @example
  * ```typescript
@@ -85,21 +106,40 @@ export interface OpenSkillsDbOptions {
  * ```
  *
  * @param options - Override the default path (test-only).
- * @returns A Drizzle ORM handle bound to the four skills.db tables.
+ * @returns A Drizzle ORM handle bound to the four `skills_*` registry tables.
  *
  * @task T9651
+ * @task T11525
  */
 export declare function openSkillsDb(options?: OpenSkillsDbOptions): Promise<NodeSQLiteDatabase<typeof skillsSchema>>;
 /**
- * Close the singleton handle and release the underlying native DB.
+ * Drop the skills-domain singleton references and trigger the coordinated close
+ * of the shared GLOBAL `cleo.db` handle via the dual-scope cache.
+ *
+ * ## E6-L5 (T11525) — shared-handle close rule
+ *
+ * `_skillsNativeDb` is the SHARED consolidated GLOBAL `cleo.db` handle owned by
+ * {@link openDualScopeDb}('global') and co-owned by the nexus / signaldock global
+ * domains. This function MUST NOT call `.close()` on it directly — doing so would
+ * tear the handle out from under those siblings (the exact bug class L4 fixed at
+ * `dual-scope-db.ts`). Instead it evicts the GLOBAL-scope entry from the
+ * dual-scope cache (a single coordinated close) and drops the local references.
  *
- * Safe to call multiple times. Used by `cleo backup restore skills.db` and
- * tests that mkdtemp a fresh location between cases.
+ * Safe to call multiple times. Used by `cleo backup restore` and tests that
+ * mkdtemp a fresh location between cases.
+ *
+ * @task T9651
+ * @task T11525
  */
 export declare function closeSkillsDb(): void;
 /**
- * Reset singleton state WITHOUT closing — used between tests to force a
- * re-open against a new tmpdir.
+ * Reset singleton state — used between tests to force a re-open against a new
+ * tmpdir. E6-L5: identical to {@link closeSkillsDb} (both go through the
+ * scope-filtered dual-scope cache reset; neither closes the shared handle
+ * directly).
+ *
+ * @task T9651
+ * @task T11525
  */
 export declare function resetSkillsDbState(): void;
 /**

package/dist/store/skills-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-db.d.ts","sourceRoot":"","sources":["../../src/store/skills-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMlE,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAGnC,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAejD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAW/C;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAyFD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,OAAO,YAAY,CAAC,CAAC,CA6ClD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAapC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,IAAI,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAMD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAIxE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBlE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,QAAQ,EAAE,CAAC,CASrB;AAMD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"skills-db.d.ts","sourceRoot":"","sources":["../../src/store/skills-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAUlE,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAejD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAiB/C;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,OAAO,YAAY,CAAC,CAAC,CAiElD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAQpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,IAAI,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAMD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAIxE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAiBlE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;CAAE,GAC7D,OAAO,CAAC,QAAQ,EAAE,CAAC,CASrB;AAMD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/store/skills-db.js

@@ -1,51 +1,67 @@
 /**
- * Per-user skills.db lifecycle module — opener, migrations, helpers.
+ * Per-user skills registry lifecycle module — opener, helpers.
  *
- * `skills.db` is a global-tier SQLite database that lives next to `tasks.db`
- * and `brain.db` under `getCleoHome()` (e.g. `~/.local/share/cleo/skills.db`).
- * It stores the per-user skills registry described in
+ * The per-user skills registry is a global-tier domain described in
  * `docs/architecture/SG-CLEO-SKILLS-architecture-v3.md` §4.
  *
- * ## Chokepoint compliance (ADR-068 + D003)
- *
- * Every CLEO SQLite open MUST flow through `openCleoDb(role, cwd)`. This
- * module implements the `'skills'` branch of that chokepoint — it is the
- * ONLY place a raw `new DatabaseSync(...)` is permitted for skills.db,
- * because it sits under `packages/core/src/store/` which is allowlisted by
- * `scripts/lint-no-raw-db-opens.mjs`.
- *
- * ## Why not in conduit.db / signaldock.db?
- *
- * Per architecture v3 §1, the database boundaries are intentional:
- *   - `signaldock.db` — cross-project AGENT identity (global)
- *   - `tasks.db`     — per-project task tracking
- *   - `brain.db`     — per-project memory
- *   - `skills.db`    — per-user SKILL registry (this module, global)
- *
- * Skills are user-scoped (a single Claude install is one user), so they
- * live under `getCleoHome()` — never inside a project's `.cleo/` folder.
+ * ## E6-L5 — thin-facade migration (T11525)
+ *
+ * `openSkillsDb()` is now a thin facade that delegates the database open to
+ * {@link openDualScopeDb}('global') — the canonical dual-scope chokepoint
+ * (E3/E4 · T11512/T11517) already adopted by the tasks (E6-L1), brain (E6-L2),
+ * conduit (E6-L3), and nexus (E6-L4) domains. The skills registry tables now
+ * live inside the consolidated GLOBAL `cleo.db` under `getCleoHome()`, sharing
+ * the SAME native handle the nexus / signaldock global domains use — NOT a
+ * separate `skills.db` file.
+ *
+ * ## Why prefixed `skills_*` tables (no establishLegacy rebuild)
+ *
+ * Unlike nexus (E6-L4), the skills registry does NOT run its legacy
+ * `drizzle-skills` migration on the shared handle. That migration created BARE
+ * `skills` / `skill_usage` / … tables — and the bare `skills` name COLLIDES with
+ * the signaldock domain's own legacy `skills` slug-catalog now that both share
+ * one `cleo.db`. The consolidated `drizzle-cleo-global` migration already creates
+ * the registry tables under the domain-prefixed names (`skills_skills`,
+ * `skills_skill_usage`, …), column-identical to the legacy shape plus additive
+ * enum/timestamp/boolean CHECK constraints that ACCEPT every value the runtime
+ * writers produce (ISO-8601 text, 0/1 booleans — verified). So skills-db simply
+ * binds the (now prefix-renamed) `skillsSchema` drizzle queries to those
+ * already-created consolidated tables. No drop+rebuild is needed because there is
+ * no consolidated-vs-legacy shape incompatibility (the L4 precondition is absent).
+ *
+ * The residency MOVE of skills global→project and the exodus data copy from the
+ * legacy standalone `skills.db` are SEPARATE later tasks (T11553 / T11538).
  *
  * @task T9651
+ * @task T11525 - E6-L5: route openSkillsDb through openDualScopeDb('global') (SG-DB-SUBSTRATE-V2)
  * @epic T9571
+ * @epic T11249
  * @saga T9560
  * @adr ADR-068, ADR-069
  * @architecture docs/architecture/SG-CLEO-SKILLS-architecture-v3.md §4
  */
-import { existsSync, mkdirSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { join } from 'node:path';
 import { and, eq } from 'drizzle-orm';
-import { readMigrationFiles } from 'drizzle-orm/migrator';
 import { drizzle } from 'drizzle-orm/node-sqlite';
 import { getCleoHome } from '../paths.js';
 import { getCurrentWriteOrigin } from '../sentient/skill-provenance.js';
-import { migrateWithRetry, reconcileJournal, tableExists } from './migration-manager.js';
-import { resolveCorePackageMigrationsFolder } from './resolve-migrations-folder.js';
+// E6-L5 (T11525): dual-scope chokepoint — the skills registry opens the
+// consolidated GLOBAL `cleo.db` through here. openDualScopeDb manages the
+// DatabaseSync lifecycle, pragmas, and consolidated migrations (which create the
+// prefixed `skills_*` tables). We extract the native handle and re-wrap it with
+// the prefix-renamed skills schema so existing callers compile unchanged.
+import { _resetDualScopeDbCache, openDualScopeDb, openDualScopeDbAtPath } from './dual-scope-db.js';
 import * as skillsSchema from './schema/skills-schema.js';
 import { skills as skillsTable, } from './schema/skills-schema.js';
-import { isSqliteBusy, openNativeDatabase } from './sqlite.js';
-/** Database file name within `getCleoHome()`. */
+/**
+ * Legacy standalone skills.db file name within `getCleoHome()`.
+ *
+ * E6-L5 (T11525): the live skills registry now consolidates into the shared
+ * GLOBAL `cleo.db`; this literal is retained only for the backup/exodus paths
+ * that still read the pre-cutover standalone file.
+ */
 export const SKILLS_DB_FILENAME = 'skills.db';
-/** Schema version stamped into `_skills_meta`. Bump on every schema change. */
+/** Schema version constant. Retained for compatibility with external re-exporters. */
 export const SKILLS_SCHEMA_VERSION = '2026.5.81';
 // ---------------------------------------------------------------------------
 // Singleton state — one open handle per process, reset across tests.
@@ -58,110 +74,46 @@ let _skillsInitPromise = null;
 // Path resolution
 // ---------------------------------------------------------------------------
 /**
- * Resolve the canonical filesystem path for `skills.db`.
+ * Resolve the canonical filesystem path for the skills registry DB.
  *
- * Always returns a path under `getCleoHome()`. Throws if the resolved path
- * somehow escapes that prefix — that would indicate a regression in
- * `getCleoHome()` itself and MUST be fixed at the source, not silently
- * tolerated.
+ * E6-L5 (T11525): resolves `getCleoHome()` + `cleo.db` — the consolidated GLOBAL
+ * `cleo.db` that now hosts the `skills_*` registry tables (the same path
+ * {@link openDualScopeDb}('global') opens). Always returns a path under
+ * `getCleoHome()`. Throws if the resolved path somehow escapes that prefix — that
+ * would indicate a regression in `getCleoHome()` itself and MUST be fixed at the
+ * source, not silently tolerated.
  *
- * @returns Absolute path to `skills.db`.
+ * @returns Absolute path to the consolidated `cleo.db`.
  * @throws {Error} If the resolved path is not under `getCleoHome()`.
  */
 export function getDefaultSkillsDbPath() {
+    // Resolve via THIS module's getCleoHome binding so the path and the guard are
+    // self-consistent — see the same note on signaldock-sqlite.getGlobalAgentRegistryDbPath
+    // (T11525). resolveDualScopeDbPath('global') builds the identical path but binds
+    // getCleoHome through dual-scope-db's module graph, which can diverge under
+    // per-test vi.doMock timing.
     const cleoHome = getCleoHome();
-    const dbPath = join(cleoHome, SKILLS_DB_FILENAME);
+    const dbPath = join(cleoHome, 'cleo.db');
     if (!dbPath.startsWith(cleoHome)) {
+        /* c8 ignore next 6 — unreachable: dbPath is built FROM cleoHome above. */
         throw new Error(`BUG: getDefaultSkillsDbPath() resolved to "${dbPath}" which is NOT under ` +
-            `getCleoHome() ("${cleoHome}"). skills.db is global-only per ` +
+            `getCleoHome() ("${cleoHome}"). The skills registry is global-only per ` +
             `SG-CLEO-SKILLS-architecture-v3.md §4. Fix the caller, do not suppress.`);
     }
     return dbPath;
 }
 /**
- * Resolve the absolute path to the `drizzle-skills` migrations folder.
- *
- * Delegates to {@link resolveCorePackageMigrationsFolder} which handles the
- * three install layouts (workspace dev, bundled dist, global install) via
- * `import.meta.resolve()` with a `createRequire().resolve()` fallback.
- */
-export function resolveSkillsMigrationsFolder() {
-    return resolveCorePackageMigrationsFolder('drizzle-skills');
-}
-// ---------------------------------------------------------------------------
-// Migration runner
-// ---------------------------------------------------------------------------
-/**
- * Apply the drizzle journal + pending migrations to the open `skills.db`.
- *
- * Uses the same retry-on-BUSY loop as `nexus-sqlite.ts` so concurrent CLI
- * invocations don't trip over each other during first-install bootstrap.
- *
- * @task T9651
- */
-function runSkillsMigrations(nativeDb, db) {
-    const migrationsFolder = resolveSkillsMigrationsFolder();
-    // Bootstrap: if the table exists from a prior bare-SQL apply but the
-    // drizzle journal hasn't been seeded, mark the initial migration as
-    // already applied. This mirrors the nexus-sqlite Scenario-1 bootstrap.
-    if (tableExists(nativeDb, 'skills') && !tableExists(nativeDb, '__drizzle_migrations')) {
-        const migrations = readMigrationFiles({ migrationsFolder });
-        const baseline = migrations[0];
-        if (baseline) {
-            nativeDb
-                .prepare(`CREATE TABLE IF NOT EXISTS "__drizzle_migrations" (id INTEGER PRIMARY KEY AUTOINCREMENT, hash text NOT NULL, created_at numeric)`)
-                .run();
-            nativeDb
-                .prepare(`INSERT INTO "__drizzle_migrations" ("hash", "created_at") VALUES ('${baseline.hash}', ${baseline.folderMillis})`)
-                .run();
-        }
-    }
-    // Reconcile any partial / out-of-band migrations before the regular run.
-    reconcileJournal(nativeDb, migrationsFolder, 'skills', 'skills');
-    const MAX_RETRIES = 5;
-    const BASE_DELAY_MS = 100;
-    const MAX_DELAY_MS = 2000;
-    let lastError;
-    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
-        try {
-            migrateWithRetry(db, migrationsFolder, nativeDb, 'skills', 'skills');
-            return;
-        }
-        catch (err) {
-            if (!isSqliteBusy(err) || attempt === MAX_RETRIES)
-                throw err;
-            lastError = err;
-            const delay = Math.min(BASE_DELAY_MS * 2 ** (attempt - 1) * (1 + Math.random() * 0.5), MAX_DELAY_MS);
-            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, Math.round(delay));
-        }
-    }
-    /* c8 ignore next */
-    throw lastError;
-}
-/**
- * Stamp the `_skills_meta.schema_version` sentinel so the next process can
- * take a fast-path through `ensureSkillsDb`.
- */
-function writeSkillsSchemaVersionSentinel(nativeDb) {
-    try {
-        nativeDb.exec(`CREATE TABLE IF NOT EXISTS _skills_meta (
-         key TEXT PRIMARY KEY,
-         value TEXT NOT NULL,
-         updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now'))
-       );
-       INSERT OR REPLACE INTO _skills_meta (key, value, updated_at)
-       VALUES ('schema_version', '${SKILLS_SCHEMA_VERSION}', strftime('%s', 'now'));`);
-    }
-    catch {
-        // Non-fatal — the next open will simply take the fall-through path.
-    }
-}
-/**
- * Open (or first-time materialise) `skills.db` and return the Drizzle handle.
- *
- * Idempotent: repeated calls with the same effective path return the cached
- * singleton. Concurrent callers share a single in-flight init promise so
- * migrations never race.
+ * Open (or first-time materialise) the skills registry and return the Drizzle
+ * handle bound to the prefixed `skills_*` tables.
+ *
+ * E6-L5 (T11525): delegates the physical open to {@link openDualScopeDb}('global')
+ * (or {@link openDualScopeDbAtPath} for the test `{ path }` override) — the
+ * canonical dual-scope chokepoint — and re-wraps its native handle with the
+ * prefix-renamed `skillsSchema` drizzle instance. The consolidated
+ * `drizzle-cleo-global` migration creates the `skills_*` tables; this module does
+ * NOT run the legacy `drizzle-skills` migration (which would create the
+ * signaldock-colliding bare `skills` table). Idempotent: repeated calls with the
+ * same effective path return the cached singleton.
  *
  * @example
  * ```typescript
@@ -172,9 +124,10 @@ function writeSkillsSchemaVersionSentinel(nativeDb) {
  * ```
  *
  * @param options - Override the default path (test-only).
- * @returns A Drizzle ORM handle bound to the four skills.db tables.
+ * @returns A Drizzle ORM handle bound to the four `skills_*` registry tables.
  *
  * @task T9651
+ * @task T11525
  */
 export async function openSkillsDb(options) {
     // Fast-path: if no explicit override was requested AND a singleton already
@@ -182,7 +135,7 @@ export async function openSkillsDb(options) {
     // is important for tests that open the DB at a tmpdir via `{path:...}` and
     // then exercise helpers that call `openSkillsDb()` with no args; without
     // this guard the helper call would swap the singleton over to the real
-    // user-home path and leak writes outside the test sandbox.
+    // consolidated cleo.db path and leak writes outside the test sandbox.
     if (_skillsDb && !options?.path)
         return _skillsDb;
     const requestedPath = options?.path ?? getDefaultSkillsDbPath();
@@ -190,21 +143,39 @@ export async function openSkillsDb(options) {
     if (_skillsDb && _skillsDbPath !== requestedPath) {
         resetSkillsDbState();
     }
+    // Liveness guard (T11525): the skills registry SHARES the consolidated GLOBAL
+    // `cleo.db` handle with the nexus / signaldock domains. A sibling may have
+    // closed + re-opened the shared handle while our singleton still references the
+    // now-closed one. Detect a stale (closed) handle and drop the singleton so we
+    // re-derive from the live dual-scope cache below.
+    if (_skillsDb && (_skillsNativeDb === null || !_skillsNativeDb.isOpen)) {
+        resetSkillsDbState();
+    }
     if (_skillsDb)
         return _skillsDb;
     if (_skillsInitPromise)
         return _skillsInitPromise;
     _skillsInitPromise = (async () => {
         _skillsDbPath = requestedPath;
-        // Ensure the parent directory exists before SQLite tries to create the file.
-        if (!existsSync(dirname(requestedPath))) {
-            mkdirSync(dirname(requestedPath), { recursive: true });
+        // ── Dual-scope chokepoint delegation (T11525 · E6-L5) ───────────────────
+        // openDualScopeDb('global') applies the pragma SSoT, creates the directory,
+        // runs the consolidated cleo-global migrations (which create the prefixed
+        // `skills_*` tables), and manages the singleton cache. The `{ path }` test
+        // override routes through the path-aware sibling against an isolated file.
+        const dualHandle = options?.path
+            ? await openDualScopeDbAtPath('global', options.path)
+            : await openDualScopeDb('global');
+        // Extract the underlying DatabaseSync. Drizzle exposes it via `$client`.
+        const nativeDb = dualHandle.db.$client ?? null;
+        if (!nativeDb) {
+            throw new Error('E6-L5: openDualScopeDb returned a handle without $client — ' +
+                'cannot extract DatabaseSync for the skills-schema wrapping.');
         }
-        const nativeDb = openNativeDatabase(requestedPath);
         _skillsNativeDb = nativeDb;
+        // Wrap the native handle with the prefix-renamed skills schema so existing
+        // callers (skillsSchema.* queries) bind to the consolidated `skills_*`
+        // tables the dual-scope migration already created.
         const db = drizzle({ client: nativeDb, schema: skillsSchema });
-        runSkillsMigrations(nativeDb, db);
-        writeSkillsSchemaVersionSentinel(nativeDb);
         _skillsDb = db;
         return db;
     })();
@@ -216,33 +187,48 @@ export async function openSkillsDb(options) {
     }
 }
 /**
- * Close the singleton handle and release the underlying native DB.
+ * Drop the skills-domain singleton references and trigger the coordinated close
+ * of the shared GLOBAL `cleo.db` handle via the dual-scope cache.
+ *
+ * ## E6-L5 (T11525) — shared-handle close rule
  *
- * Safe to call multiple times. Used by `cleo backup restore skills.db` and
- * tests that mkdtemp a fresh location between cases.
+ * `_skillsNativeDb` is the SHARED consolidated GLOBAL `cleo.db` handle owned by
+ * {@link openDualScopeDb}('global') and co-owned by the nexus / signaldock global
+ * domains. This function MUST NOT call `.close()` on it directly — doing so would
+ * tear the handle out from under those siblings (the exact bug class L4 fixed at
+ * `dual-scope-db.ts`). Instead it evicts the GLOBAL-scope entry from the
+ * dual-scope cache (a single coordinated close) and drops the local references.
+ *
+ * Safe to call multiple times. Used by `cleo backup restore` and tests that
+ * mkdtemp a fresh location between cases.
+ *
+ * @task T9651
+ * @task T11525
  */
 export function closeSkillsDb() {
-    if (_skillsNativeDb) {
-        try {
-            if (_skillsNativeDb.isOpen) {
-                _skillsNativeDb.close();
-            }
-        }
-        catch {
-            // Ignore — the singleton is about to be reset.
-        }
-        _skillsNativeDb = null;
-    }
+    // Drop only the local references. The scope-filtered cache reset performs the
+    // single coordinated close of the shared GLOBAL handle.
+    _skillsNativeDb = null;
     _skillsDb = null;
     _skillsDbPath = null;
+    _skillsInitPromise = null;
+    _resetDualScopeDbCache('global');
 }
 /**
- * Reset singleton state WITHOUT closing — used between tests to force a
- * re-open against a new tmpdir.
+ * Reset singleton state — used between tests to force a re-open against a new
+ * tmpdir. E6-L5: identical to {@link closeSkillsDb} (both go through the
+ * scope-filtered dual-scope cache reset; neither closes the shared handle
+ * directly).
+ *
+ * @task T9651
+ * @task T11525
  */
 export function resetSkillsDbState() {
-    closeSkillsDb();
+    _skillsNativeDb = null;
+    _skillsDb = null;
+    _skillsDbPath = null;
     _skillsInitPromise = null;
+    _resetDualScopeDbCache('global');
 }
 /**
  * Return the raw `node:sqlite` handle for the open skills.db (or null if

package/dist/store/skills-db.js.map

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

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

@@ -46,7 +46,7 @@ import { type DbInventoryEntry, type DbRole } from '@cleocode/contracts';
  *
  *   - `chokepoint-opener`        — role has a canonical opener (`getDb`,
  *                                  `getBrainDb`, `ensureConduitDb`,
- *                                  `getNexusDb`, `ensureGlobalSignaldockDb`,
+ *                                  `getNexusDb`, `ensureGlobalAgentRegistryDb`,
  *                                  `getTelemetryDb`, `openSkillsDb`).
  *   - `raw-file-vacuum-readonly` — role has NO live opener; the file is
  *                                  opened read-only via a one-shot
@@ -78,7 +78,7 @@ export interface VacuumOptions {
  *
  * Debounced by default (30s). Pass `force: true` to bypass debounce. This
  * function is retained for backward compatibility with existing call sites
- * in `data-safety.ts` / `data-safety-central.ts` that only snapshot tasks.db.
+ * in `data-safety-central.ts` that only snapshot tasks.db.
  *
  * Prefer {@link vacuumIntoBackupAll} for new code — it snapshots every
  * inventory-registered database and shares the same debounce + rotation