@cleocode/core 2026.5.131 → 2026.5.133

package/dist/store/dual-scope-db.js

@@ -0,0 +1,315 @@
+/**
+ * Dual-scope SQLite DB open chokepoint for the SG-DB-SUBSTRATE-V2 consolidated schema.
+ *
+ * ## Overview (D1″ lifecycle split · T11246/E3 + T11247/E4)
+ *
+ * The owner-ratified D1″ decision (2026-05-30) collapses the CLEO SQLite fleet
+ * into exactly **two `cleo.db` files per machine view**:
+ *
+ *   - **Project scope** — `<projectRoot>/.cleo/cleo.db`
+ *     Contains every project-tier domain: `tasks_*` / `brain_*` (project-local
+ *     memory) / `conduit_*` / `docs_*` / `telemetry_*` / lifecycle / provenance /
+ *     chain / playbooks / agents (87 tables / 903 columns, T11360 count).
+ *
+ *   - **Global scope** — `$XDG_DATA_HOME/cleo/cleo.db`
+ *     Contains every cross-project domain: `nexus_*` / `skills_*` /
+ *     `signaldock_*` / `brain_*` (global cross-project memory)
+ *     (49 tables / 555 columns, T11361 count).
+ *
+ * ## Lifecycle
+ *
+ * `openDualScopeDb` is the **single chokepoint** for all opens of the
+ * consolidated schema. It:
+ *   1. Resolves the DB file path from scope + `cwd` (project) or `getCleoHome()`
+ *      (global).
+ *   2. Opens a `node:sqlite` `DatabaseSync` handle.
+ *   3. Applies the canonical pragma set from `specs/sqlite-pragmas.json` via
+ *      {@link applyPerfPragmas}.
+ *   4. Runs the drizzle-kit migrate step against the scope-appropriate
+ *      migrations folder (`drizzle-cleo-project` or `drizzle-cleo-global`).
+ *   5. Returns a cached, typed `NodeSQLiteDatabase<TSchema>` handle.
+ *      Subsequent calls for the same (scope, cwd) return the cached handle.
+ *
+ * ## Note on co-existence with legacy openCleoDb
+ *
+ * During the E3/E4 → E6 exodus transition, `openCleoDb` (the existing
+ * 8-role chokepoint) and `openDualScopeDb` (this module) co-exist. `openCleoDb`
+ * will be updated by E3 to delegate to this function for the consolidated
+ * schema. Until the E6 store rewrite, individual store modules still open their
+ * own legacy DBs via `openCleoDb`. The E6 milestone removes the legacy opens.
+ *
+ * @module
+ * @task T11512 (E4-T1)
+ * @task T11513 (E4-T2 — idempotent write helpers in this same file)
+ * @epic T11247 (E4)
+ * @saga T11242 (SG-DB-SUBSTRATE-V2)
+ * @adr ADR-068, ADR-069
+ * @see packages/core/src/store/schema/cleo-project/index.ts — project schema
+ * @see packages/core/src/store/schema/cleo-global/index.ts — global schema
+ * @see packages/core/migrations/drizzle-cleo-project — project migrations
+ * @see packages/core/migrations/drizzle-cleo-global — global migrations
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { getLogger } from '../logger.js';
+import { getCleoHome, resolveCleoDir } from '../paths.js';
+import { migrateWithRetry, reconcileJournal } from './migration-manager.js';
+import { resolveCorePackageMigrationsFolder } from './resolve-migrations-folder.js';
+import { applyPerfPragmas } from './sqlite-pragmas.js';
+const _cache = new Map();
+/**
+ * Build the singleton cache key for a given scope + resolved DB path.
+ * Uses `::` as a separator that cannot appear in POSIX paths.
+ */
+function cacheKey(scope, dbPath) {
+    return `${scope}::${dbPath}`;
+}
+// ── Path resolution ──────────────────────────────────────────────────────────
+/**
+ * Resolve the absolute path to the dual-scope `cleo.db` for the given scope.
+ *
+ * - `project`: `resolveCleoDir(cwd)` + `'cleo.db'` (falls under `<root>/.cleo/`)
+ * - `global`:  `getCleoHome()` + `'cleo.db'` (falls under XDG data home `/cleo/`)
+ */
+export function resolveDualScopeDbPath(scope, cwd) {
+    if (scope === 'project') {
+        return join(resolveCleoDir(cwd), 'cleo.db');
+    }
+    return join(getCleoHome(), 'cleo.db');
+}
+// ── Migration folder resolution ──────────────────────────────────────────────
+/**
+ * Return the migrations folder name for the given scope.
+ * The folder lives under `@cleocode/core/migrations/<name>`.
+ */
+function migrationsSetName(scope) {
+    return scope === 'project' ? 'drizzle-cleo-project' : 'drizzle-cleo-global';
+}
+// ── Lazy drizzle loading ─────────────────────────────────────────────────────
+// The drizzle-orm/node-sqlite driver statically imports `node:sqlite`, so we
+// load it lazily (matching the pattern in sqlite.ts, T11280) to avoid pulling
+// the native binding at module-load time and breaking lazy-init assertions.
+const _require = createRequire(import.meta.url);
+let _drizzle = null;
+function getDrizzle() {
+    if (_drizzle === null) {
+        const mod = _require('drizzle-orm/node-sqlite');
+        _drizzle = mod.drizzle;
+    }
+    return _drizzle;
+}
+let _DatabaseSyncCtor = null;
+function getDatabaseSyncCtor() {
+    if (_DatabaseSyncCtor === null) {
+        const mod = _require('node:sqlite');
+        _DatabaseSyncCtor = mod.DatabaseSync;
+    }
+    return _DatabaseSyncCtor;
+}
+// ── Schema loading ───────────────────────────────────────────────────────────
+// Dynamic imports for schema barrels. Loaded once per scope and cached.
+// We use dynamic import() to avoid loading both schemas at module-init time —
+// only the requested scope's schema is loaded.
+let _projectSchema = null;
+let _globalSchema = null;
+async function loadProjectSchema() {
+    if (_projectSchema === null) {
+        _projectSchema = await import('./schema/cleo-project/index.js');
+    }
+    return _projectSchema;
+}
+async function loadGlobalSchema() {
+    if (_globalSchema === null) {
+        _globalSchema = await import('./schema/cleo-global/index.js');
+    }
+    return _globalSchema;
+}
+// ── Existence table for migration reconciliation ──────────────────────────────
+/**
+ * The "existence table" used by {@link reconcileJournal} to detect whether
+ * migrations have been run before.
+ *
+ * For the project scope the first domain is `tasks_tasks`; for global it
+ * is `nexus_project_registry`. These are the canonical first tables in each
+ * scope's migration.
+ */
+function existenceTable(scope) {
+    return scope === 'project' ? 'tasks_tasks' : 'nexus_project_registry';
+}
+export async function openDualScopeDb(scope, cwd) {
+    const dbPath = resolveDualScopeDbPath(scope, cwd);
+    const key = cacheKey(scope, dbPath);
+    // Return cached handle if available and not mid-init.
+    const existing = _cache.get(key);
+    if (existing) {
+        if (existing.initPromise) {
+            return existing.initPromise;
+        }
+        return existing.handle;
+    }
+    const log = getLogger('dual-scope-db');
+    // Create a placeholder entry so concurrent callers wait for the same init.
+    const initPromise = (async () => {
+        log.debug({ scope, dbPath }, 'opening dual-scope cleo.db');
+        // Ensure the directory exists before opening.
+        const dir = dirname(dbPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Open the native SQLite handle.
+        const DatabaseSyncCtor = getDatabaseSyncCtor();
+        const nativeDb = new DatabaseSyncCtor(dbPath);
+        // Apply canonical pragma set (specs/sqlite-pragmas.json SSoT).
+        applyPerfPragmas(nativeDb);
+        // Load the schema barrel for this scope.
+        const schema = scope === 'project' ? await loadProjectSchema() : await loadGlobalSchema();
+        // Create the Drizzle ORM wrapper.
+        // Drizzle v1 RC3 node-sqlite API: pass { client, schema } as a single config object.
+        const drizzle = getDrizzle();
+        // biome-ignore lint/suspicious/noExplicitAny: schema type is scope-specific; typed via DualScopeDbHandle<TScope>
+        const db = drizzle({ client: nativeDb, schema });
+        // Resolve the migrations folder for this scope.
+        const migrationsFolder = resolveCorePackageMigrationsFolder(migrationsSetName(scope));
+        // Reconcile the migration journal (handles WAL/journal divergence across
+        // SQLite version upgrades — same pattern as sqlite.ts / memory-sqlite.ts).
+        reconcileJournal(nativeDb, migrationsFolder, existenceTable(scope), `dual-scope-db[${scope}]`);
+        // Run any pending migrations.
+        migrateWithRetry(db, migrationsFolder, nativeDb, existenceTable(scope), `dual-scope-db[${scope}]`);
+        log.debug({ scope, dbPath }, 'dual-scope cleo.db ready');
+        const handle = {
+            db,
+            scope,
+            dbPath,
+            close() {
+                _cache.delete(key);
+                try {
+                    nativeDb.close();
+                }
+                catch {
+                    // Idempotent — ignore double-close errors.
+                }
+            },
+        };
+        // Update the cache entry to mark init complete.
+        const entry = _cache.get(key);
+        if (entry) {
+            entry.initPromise = null;
+            entry.handle = handle;
+        }
+        return handle;
+    })();
+    // Store a placeholder with the in-flight promise so concurrent callers wait.
+    _cache.set(key, {
+        // biome-ignore lint/suspicious/noExplicitAny: placeholder until initPromise resolves
+        handle: null,
+        // biome-ignore lint/suspicious/noExplicitAny: nativeDb not available yet
+        nativeDb: null,
+        initPromise,
+    });
+    return initPromise;
+}
+/**
+ * Reset all cached handles. Primarily for use in tests between test cases.
+ * Closes all open handles before evicting from the cache.
+ *
+ * @internal
+ */
+export function _resetDualScopeDbCache() {
+    for (const entry of _cache.values()) {
+        if (entry.handle) {
+            try {
+                entry.handle.close();
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    _cache.clear();
+    // Also reset schema caches so tests can reload fresh schemas.
+    _projectSchema = null;
+    _globalSchema = null;
+}
+/**
+ * Attempt to insert `row` into `table`. If a row with the same value for
+ * `keyColumn` already exists (UNIQUE conflict), the insert is silently skipped.
+ *
+ * Wraps Drizzle v1's `.onConflictDoNothing()` to provide a type-safe,
+ * retry-safe idempotent insert for tables that carry an `idempotency_key`
+ * column or any other UNIQUE column.
+ *
+ * @param db - The Drizzle database handle (project or global scope).
+ * @param table - The Drizzle table reference from the consolidated schema.
+ * @param row - The row data to insert (all required columns).
+ * @param _keyColumn - The column name to conflict on (informational; the
+ *   conflict resolution is applied table-wide via `.onConflictDoNothing()`).
+ *   Pass the column name as a hint for documentation purposes.
+ * @returns The number of rows actually inserted (0 or 1).
+ *
+ * @example
+ * ```ts
+ * import { tasksTasksTable } from '@cleocode/core/store/schema/cleo-project';
+ * const inserted = await insertIdempotent(db, tasksTasksTable, newTask, 'idempotencyKey');
+ * ```
+ *
+ * @task T11513 (E4-T2)
+ * @epic T11247 (E4)
+ * @saga T11242
+ */
+export async function insertIdempotent(
+// biome-ignore lint/suspicious/noExplicitAny: accepts both project and global schema handles
+db, table, row, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_keyColumn) {
+    const result = await db.insert(table).values(row).onConflictDoNothing().returning();
+    return result.length;
+}
+/**
+ * Upsert `row` into `table`, updating all non-key columns when a row with
+ * the same `keyColumn` value already exists.
+ *
+ * Wraps Drizzle v1's `.onConflictDoUpdate()` for retry-safe upsert semantics.
+ *
+ * @param db - The Drizzle database handle.
+ * @param table - The Drizzle table reference.
+ * @param row - The row data to insert or update.
+ * @param keyColumn - The conflict-target column name (must be a UNIQUE or
+ *   PRIMARY KEY column on the table).
+ * @param conflictTarget - The column reference used as the `.target` for
+ *   `.onConflictDoUpdate()`. Pass the Drizzle column reference (e.g.
+ *   `table.idempotencyKey`).
+ * @param set - The columns to update on conflict. If omitted, all columns
+ *   in `row` are used as the update set.
+ * @returns The number of rows inserted or updated (always 1).
+ *
+ * @example
+ * ```ts
+ * await upsertIdempotent(db, tasksTasksTable, updatedTask, 'idempotencyKey',
+ *   tasksTasksTable.idempotencyKey);
+ * ```
+ *
+ * @task T11513 (E4-T2)
+ * @epic T11247 (E4)
+ * @saga T11242
+ */
+export async function upsertIdempotent(
+// biome-ignore lint/suspicious/noExplicitAny: accepts both project and global schema handles
+db, table, row, 
+/** The conflict-target column name (informational hint for callers). */
+_keyColumn, 
+// biome-ignore lint/suspicious/noExplicitAny: column reference type varies by table
+conflictTarget, set) {
+    const updateSet = set ?? row;
+    const result = await db
+        .insert(table)
+        .values(row)
+        .onConflictDoUpdate({
+        target: conflictTarget,
+        // biome-ignore lint/suspicious/noExplicitAny: updateSet shape varies by table; type-safe at call sites
+        set: updateSet,
+    })
+        .returning();
+    return result.length;
+}
+//# sourceMappingURL=dual-scope-db.js.map

package/dist/store/dual-scope-db.js.map

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

package/dist/store/open-cleo-db.d.ts

@@ -21,11 +21,24 @@
  * ```typescript
  * import { openCleoDb } from '@cleocode/core/store/open-cleo-db';
  *
+ * // Dual-scope consolidated cleo.db (D1″ lifecycle — E3/E4 exodus):
+ * const projHandle = await openCleoDb('project', cwd);
+ * const globHandle = await openCleoDb('global');
+ *
+ * // Legacy 8-role API (deprecated — use 'project'|'global' for new code):
  * const handle = await openCleoDb('tasks', cwd);
  * // use handle.db (DatabaseSync) ...
  * await handle.close();
  * ```
  *
+ * ## Dual-scope delegation (T11517 · E3)
+ *
+ * When called with `'project'` or `'global'` as the role, `openCleoDb` delegates
+ * directly to {@link openDualScopeDb} from `./dual-scope-db.ts`, returning a
+ * `CleoDbHandle`-shaped wrapper. This is the preferred API for all new code
+ * after the E3 exodus. The legacy 8-role CleoDbRole API is retained as a
+ * deprecated shim for one migration cycle (E6 removes it).
+ *
  * ## Snapshot opener (read-only, no migrations)
  *
  * For short-lived read-only opens (backup verification, schema integrity
@@ -34,12 +47,25 @@
  * migrations and singleton management, so the caller owns the handle's
  * lifecycle directly.
  *
- * @task T9047, T9685
+ * @task T9047, T9685, T11517
  * @adr ADR-068, ADR-069
  */
 import type { DatabaseSync } from 'node:sqlite';
-/** Canonical roles for the 6 SQLite databases (ADR-068), plus planned llmtxt/docs storage. */
-export type CleoDbRole = 'tasks' | 'brain' | 'sessions' | 'signaldock' | 'conduit' | 'nexus' | 'skills' | 'llmtxt';
+import type { DualScope } from './dual-scope-db.js';
+/**
+ * Canonical roles for the CLEO SQLite databases (ADR-068).
+ *
+ * ### Preferred (dual-scope, D1″ — E3 exodus)
+ * - `'project'` — consolidated per-project `cleo.db` (delegates to {@link openDualScopeDb})
+ * - `'global'`  — consolidated per-user `cleo.db`  (delegates to {@link openDualScopeDb})
+ *
+ * ### Legacy 8-role API (deprecated — kept for one migration cycle until E6)
+ * The legacy roles below are retained as shims during the E3→E6 transition.
+ * New code MUST use `'project'` or `'global'` instead.
+ *
+ * @task T11517 (E3-T1 · SG-DB-SUBSTRATE-V2)
+ */
+export type CleoDbRole = DualScope | 'tasks' | 'brain' | 'sessions' | 'signaldock' | 'conduit' | 'nexus' | 'skills' | 'llmtxt';
 /** Handle returned by {@link openCleoDb}. */
 export interface CleoDbHandle {
     db: unknown;
@@ -76,11 +102,32 @@ export type DBHandle = CleoDbHandle;
  */
 export declare function validateProjectIdConsistency(role: CleoDbRole, db: unknown, cwd?: string): void;
 /**
- * Open (or create) a CLEO database by canonical role.
+ * Open (or create) a CLEO database by canonical role or dual-scope selector.
+ *
+ * ## Dual-scope delegation (preferred — T11517 · E3)
+ *
+ * When called with `'project'` or `'global'`, this function delegates to
+ * {@link openDualScopeDb} from `./dual-scope-db.ts`. The returned handle
+ * wraps the typed Drizzle client as `CleoDbHandle.db` for backward compat
+ * with legacy callers that treat `db` as an opaque `unknown`.
+ *
+ * ```ts
+ * // Preferred for new code after E3 exodus:
+ * const handle = await openCleoDb('project', cwd);
+ * const handle = await openCleoDb('global');
+ * ```
+ *
+ * ## Legacy 8-role API (deprecated)
+ *
+ * The legacy role strings (`'tasks'`, `'brain'`, `'signaldock'`, …) remain
+ * functional as deprecated shims for existing callers. E6 will remove them.
  *
  * Single chokepoint for all DB opens. Applies pragma SSoT at open time.
  * Enforces the worktree-isolation guard (T9806) on top of T9803's path-layer
  * THROWS-on-orphan fix.
+ *
+ * @task T9047, T9685, T11517
+ * @adr ADR-068, ADR-069
  */
 export declare function openCleoDb(role: CleoDbRole, cwd?: string): Promise<CleoDbHandle>;
 /**

package/dist/store/open-cleo-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-cleo-db.d.ts","sourceRoot":"","sources":["../../src/store/open-cleo-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAchD,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,OAAO,GACP,UAAU,GACV,YAAY,GACZ,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAQb,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAoGpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAoD9F;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCtF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAErE;AAMD,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,EAAE,EAAE,YAAY,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA8BtB"}
+{"version":3,"file":"open-cleo-db.d.ts","sourceRoot":"","sources":["../../src/store/open-cleo-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAElB,SAAS,GAET,OAAO,GACP,OAAO,GACP,UAAU,GACV,YAAY,GACZ,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAYb,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAqGpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAoD9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4DtF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAErE;AAMD,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,EAAE,EAAE,YAAY,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA8BtB"}

package/dist/store/open-cleo-db.js

@@ -21,11 +21,24 @@
  * ```typescript
  * import { openCleoDb } from '@cleocode/core/store/open-cleo-db';
  *
+ * // Dual-scope consolidated cleo.db (D1″ lifecycle — E3/E4 exodus):
+ * const projHandle = await openCleoDb('project', cwd);
+ * const globHandle = await openCleoDb('global');
+ *
+ * // Legacy 8-role API (deprecated — use 'project'|'global' for new code):
  * const handle = await openCleoDb('tasks', cwd);
  * // use handle.db (DatabaseSync) ...
  * await handle.close();
  * ```
  *
+ * ## Dual-scope delegation (T11517 · E3)
+ *
+ * When called with `'project'` or `'global'` as the role, `openCleoDb` delegates
+ * directly to {@link openDualScopeDb} from `./dual-scope-db.ts`, returning a
+ * `CleoDbHandle`-shaped wrapper. This is the preferred API for all new code
+ * after the E3 exodus. The legacy 8-role CleoDbRole API is retained as a
+ * deprecated shim for one migration cycle (E6 removes it).
+ *
  * ## Snapshot opener (read-only, no migrations)
  *
  * For short-lived read-only opens (backup verification, schema integrity
@@ -34,7 +47,7 @@
  * migrations and singleton management, so the caller owns the handle's
  * lifecycle directly.
  *
- * @task T9047, T9685
+ * @task T9047, T9685, T11517
  * @adr ADR-068, ADR-069
  */
 import { createRequire } from 'node:module';
@@ -43,6 +56,7 @@ import { CleoError } from '../errors.js';
 import { resolveOrCwd } from '../paths.js';
 import { getProjectInfoSync } from '../project-info.js';
 import { getConduitNativeDb } from './conduit-sqlite.js';
+import { openDualScopeDb } from './dual-scope-db.js';
 import { getBrainDb } from './memory-sqlite.js';
 import { getNexusDb } from './nexus-sqlite.js';
 import { ensureGlobalSignaldockDb, getGlobalSignaldockNativeDb } from './signaldock-sqlite.js';
@@ -87,6 +101,7 @@ async function openSkillsDbHandle(_cwd) {
 async function openBrainDbHandle(cwd) {
     return getBrainDb(cwd);
 }
+/** Openers for the legacy 8-role API (deprecated shim — E6 removes these). */
 const ROLE_OPENERS = {
     tasks: getTasksDb,
     // T10397: brain role MUST resolve to brain.db, NOT tasks.db. Prior to
@@ -203,13 +218,52 @@ export function validateProjectIdConsistency(role, db, cwd) {
     }
 }
 /**
- * Open (or create) a CLEO database by canonical role.
+ * Open (or create) a CLEO database by canonical role or dual-scope selector.
+ *
+ * ## Dual-scope delegation (preferred — T11517 · E3)
+ *
+ * When called with `'project'` or `'global'`, this function delegates to
+ * {@link openDualScopeDb} from `./dual-scope-db.ts`. The returned handle
+ * wraps the typed Drizzle client as `CleoDbHandle.db` for backward compat
+ * with legacy callers that treat `db` as an opaque `unknown`.
+ *
+ * ```ts
+ * // Preferred for new code after E3 exodus:
+ * const handle = await openCleoDb('project', cwd);
+ * const handle = await openCleoDb('global');
+ * ```
+ *
+ * ## Legacy 8-role API (deprecated)
+ *
+ * The legacy role strings (`'tasks'`, `'brain'`, `'signaldock'`, …) remain
+ * functional as deprecated shims for existing callers. E6 will remove them.
  *
  * Single chokepoint for all DB opens. Applies pragma SSoT at open time.
  * Enforces the worktree-isolation guard (T9806) on top of T9803's path-layer
  * THROWS-on-orphan fix.
+ *
+ * @task T9047, T9685, T11517
+ * @adr ADR-068, ADR-069
  */
 export async function openCleoDb(role, cwd) {
+    // ── Dual-scope delegation (preferred API — E3 onwards) ──────────────────
+    if (role === 'project' || role === 'global') {
+        // Delegate to the E4 chokepoint which applies pragma SSoT, runs migrations,
+        // and manages the singleton cache. Explicit conditional narrows the overload.
+        const dualHandle = role === 'project'
+            ? await openDualScopeDb('project', cwd)
+            : await openDualScopeDb('global', cwd);
+        return {
+            // The Drizzle handle is compatible with `unknown` — callers that need
+            // the native DatabaseSync should use `@cleocode/core/db` directly.
+            db: dualHandle.db,
+            role,
+            async close() {
+                dualHandle.close();
+            },
+        };
+    }
+    // ── Legacy 8-role API (deprecated shim — E6 removes) ───────────────────
     if (role === 'llmtxt') {
         throw new Error('CLEO DB role llmtxt is not yet implemented');
     }

package/dist/store/open-cleo-db.js.map

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

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

@@ -1919,7 +1919,7 @@ export declare const nexusSigils: import("drizzle-orm/sqlite-core").SQLiteTableW
             name: string;
             tableName: "nexus_sigils";
             dataType: "string enum";
-            data: "" | "orchestrator" | "validator" | "lead" | "worker" | "specialist" | "subagent";
+            data: "" | "orchestrator" | "validator" | "lead" | "worker" | "subagent" | "specialist";
             driverParam: string;
             notNull: true;
             hasDefault: true;

package/dist/store/schema/cleo-global/signaldock.d.ts

@@ -802,7 +802,7 @@ export declare const signaldockAgents: import("drizzle-orm/sqlite-core").SQLiteT
             name: string;
             tableName: "signaldock_agents";
             dataType: "string enum";
-            data: "online" | "busy" | "offline" | "away";
+            data: "online" | "offline" | "busy" | "away";
             driverParam: string;
             notNull: true;
             hasDefault: true;

package/dist/store/schema/cleo-shared/brain.d.ts

@@ -4244,7 +4244,7 @@ export declare const brainBackfillRuns: import("drizzle-orm/sqlite-core").SQLite
             name: string;
             tableName: "brain_backfill_runs";
             dataType: "string enum";
-            data: "custom" | "graph-backfill" | "noise-sweep-2440" | "observation-promotion" | "transcript-ingest";
+            data: "custom" | "observation-promotion" | "transcript-ingest" | "graph-backfill" | "noise-sweep-2440";
             driverParam: string;
             notNull: true;
             hasDefault: false;

package/dist/tasks/add.d.ts.map

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

package/dist/tasks/add.js

@@ -694,12 +694,26 @@ export async function addTask(options, cwd, accessor) {
         const ancestors = await dataAccessor.getAncestorChain(parentId);
         const parentDepth = ancestors.length;
         if (parentDepth + 1 >= policy.maxDepth) {
-            throw new CleoError(ExitCode.DEPTH_EXCEEDED, `Maximum nesting depth ${policy.maxDepth} would be exceeded`, {
-                fix: 'Reparent this task under a higher-level epic',
+            // T11491 — DHQ-044: produce a clear actionable message that names the
+            // parent epic the user SHOULD target instead. The ancestor chain is
+            // ordered [immediateParent, grandparent, …, root]. When the parent is a
+            // task (depth 2), ancestors[0] is the epic (depth 1) — tell the user
+            // to file under THAT epic instead.
+            const grandparentEpic = ancestors.length > 0 ? ancestors[ancestors.length - 1] : ancestors[0];
+            const epicSuggestion = grandparentEpic
+                ? ` Use --parent ${grandparentEpic.id} (the parent epic) instead, or omit --parent to create a standalone task.`
+                : ' Omit --parent to create a standalone task, or reparent under a higher-level epic.';
+            throw new CleoError(ExitCode.DEPTH_EXCEEDED, `Cannot add a child to ${parentId}: the hierarchy depth cap (${policy.maxDepth}) would be exceeded. ` +
+                `Tasks at depth ${parentDepth} cannot have children.${epicSuggestion}`, {
+                fix: grandparentEpic
+                    ? `cleo add --parent ${grandparentEpic.id} --title "..." --acceptance "..."`
+                    : 'Reparent this task under a higher-level epic',
                 details: {
                     field: 'parentId',
                     expected: `depth < ${policy.maxDepth}`,
                     actual: parentDepth + 1,
+                    suggestedParentId: grandparentEpic?.id,
+                    suggestedParentTitle: grandparentEpic?.title,
                 },
             });
         }