@cleocode/core 2026.9.20 → 2026.9.21

package/dist/store/worktree-isolation-guard.d.ts

@@ -1,42 +1,64 @@
 /**
- * Worktree-isolation guard for CLEO DB opens (T9806 / T9961 / council verdict D009).
+ * Worktree-isolation guard for CLEO DB opens (T9806 / T9961 / T12460 · council verdict D009).
  *
- * Extracted into a standalone leaf module so it can be imported by both
- * `open-cleo-db.ts` (which owns the `CleoDbRole` union and the main chokepoint)
- * AND `sqlite.ts` (where `getDb()` lives) — without creating a circular import
- * cycle.
+ * Extracted into a standalone leaf module so it can be imported by
+ * `open-cleo-db.ts`, `sqlite.ts` (where `getDb()` lives) and `dual-scope-db.ts`
+ * (the physical open chokepoint) without creating a circular import cycle.
  *
- * Before this extraction, `assertDbPathIsNotWorktreeResident` lived in
- * `open-cleo-db.ts`, which imports `getDb` from `sqlite.ts`. If `sqlite.ts`
- * had tried to import the guard from `open-cleo-db.ts`, the import cycle would
- * have caused a TDZ failure at module-init time.
+ * T12460 moved the check onto the path actually being opened. The original
+ * guard re-derived a `.cleo/` directory through `getCleoDirAbsolute`, which
+ * follows the gitlink to the parent project, while the store open resolved the
+ * worktree's own `.cleo/`. The guard therefore approved a path nobody opened
+ * and the worktree silently received its own diverged `cleo.db`.
  *
- * @task T9961 (extraction), T9806 (original guard)
+ * @task T9961 (extraction), T9806 (original guard), T12460 (actual-path check)
  * @saga T9800
  * @decision D009
  */
 /**
- * Worktree-isolation guard for the DB chokepoint (T9806 / council verdict D009).
+ * Refuse to open a project-scope store file that lives inside a git worktree.
  *
- * Defense-in-depth on top of T9803's `getCleoDirAbsolute` THROWS-on-orphan
- * fix. After path resolution, this verifies the resolved `.cleo/`'s parent
- * directory is the **canonical project root** (i.e. `.git` is a real
- * directory) rather than a **git worktree** (i.e. `.git` is a gitlink file).
+ * A project store is `<root>/.cleo/<file>`. When `<root>` is a linked git
+ * checkout (`.git` is a gitlink FILE), the file is a worktree-resident copy
+ * diverged from the parent project's store: writes there never reach the
+ * parent and are lost when the worktree is pruned (T12460). Path resolution
+ * ({@link resolveCleoDir}) maps CLEO worktrees to their parent, so reaching
+ * this guard means the parent could not be resolved or the caller passed an
+ * explicit worktree path.
  *
- * Refusing worktree-resident opens prevents the residual orphan path where a
- * leaked `.cleo/` already exists inside a worktree from a pre-T9803 install:
- * T9803 stops NEW creation, T9806 stops re-use of an OLD leak.
+ * Paths whose parent directory is not named `.cleo` (explicit test fixtures,
+ * snapshot inspection) are outside the project layout and are not checked.
  *
  * Kill-switch: `CLEO_ALLOW_WORKTREE_DB_CREATE=1` bypasses the guard. The
- * override is recorded to stderr (caller may pipe to audit log).
+ * override is recorded on stderr.
+ *
+ * @param role - DB role label, used in the error message only.
+ * @param dbPath - Absolute path of the store file about to be opened.
+ * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when the store's project
+ *   root is a linked git checkout and the kill-switch is not set.
+ * @example
+ * ```ts
+ * assertStorePathIsNotWorktreeResident('project', '/wt/T1/.cleo/cleo.db'); // throws
+ * ```
+ * @task T12460
+ */
+export declare function assertStorePathIsNotWorktreeResident(role: string, dbPath: string): void;
+/**
+ * Worktree-isolation guard for callers that know only a working directory.
+ *
+ * Resolves the project store path exactly as the open does
+ * (`resolveCleoDir(cwd)` + `cleo.db`, the same derivation as
+ * `resolveDualScopeDbPath('project', cwd)`) and applies
+ * {@link assertStorePathIsNotWorktreeResident} to it.
  *
  * @param role - The DB role label (used in the error message only).
  * @param cwd  - Optional working directory; defaults to `process.cwd()`.
- *
- * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when:
- *   - The resolved `.cleo/`'s parent directory contains `.git` as a FILE
- *     (gitlink — worktree marker), AND
- *   - `CLEO_ALLOW_WORKTREE_DB_CREATE` is not set to `'1'`.
+ * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when the resolved store
+ *   lives inside a git worktree and the kill-switch is not set.
+ * @example
+ * ```ts
+ * assertDbPathIsNotWorktreeResident('tasks', process.cwd());
+ * ```
  */
 export declare function assertDbPathIsNotWorktreeResident(role: string, cwd?: string): void;
 //# sourceMappingURL=worktree-isolation-guard.d.ts.map

package/dist/store/worktree-isolation-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktree-isolation-guard.d.ts","sourceRoot":"","sources":["../../src/store/worktree-isolation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAkClF"}
+{"version":3,"file":"worktree-isolation-guard.d.ts","sourceRoot":"","sources":["../../src/store/worktree-isolation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkBvF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAUlF"}

package/dist/store/worktree-isolation-guard.js

@@ -1,77 +1,96 @@
 /**
- * Worktree-isolation guard for CLEO DB opens (T9806 / T9961 / council verdict D009).
+ * Worktree-isolation guard for CLEO DB opens (T9806 / T9961 / T12460 · council verdict D009).
  *
- * Extracted into a standalone leaf module so it can be imported by both
- * `open-cleo-db.ts` (which owns the `CleoDbRole` union and the main chokepoint)
- * AND `sqlite.ts` (where `getDb()` lives) — without creating a circular import
- * cycle.
+ * Extracted into a standalone leaf module so it can be imported by
+ * `open-cleo-db.ts`, `sqlite.ts` (where `getDb()` lives) and `dual-scope-db.ts`
+ * (the physical open chokepoint) without creating a circular import cycle.
  *
- * Before this extraction, `assertDbPathIsNotWorktreeResident` lived in
- * `open-cleo-db.ts`, which imports `getDb` from `sqlite.ts`. If `sqlite.ts`
- * had tried to import the guard from `open-cleo-db.ts`, the import cycle would
- * have caused a TDZ failure at module-init time.
+ * T12460 moved the check onto the path actually being opened. The original
+ * guard re-derived a `.cleo/` directory through `getCleoDirAbsolute`, which
+ * follows the gitlink to the parent project, while the store open resolved the
+ * worktree's own `.cleo/`. The guard therefore approved a path nobody opened
+ * and the worktree silently received its own diverged `cleo.db`.
  *
- * @task T9961 (extraction), T9806 (original guard)
+ * @task T9961 (extraction), T9806 (original guard), T12460 (actual-path check)
  * @saga T9800
  * @decision D009
  */
-import { existsSync, statSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { basename, dirname, join } from 'node:path';
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
-import { getCleoDirAbsolute } from '../paths.js';
+import { resolveCleoDir } from '../paths.js';
+import { isGitLinkedCheckout } from '../project-scope.js';
+/** File name of the consolidated project store under `<root>/.cleo/`. */
+const PROJECT_STORE_FILENAME = 'cleo.db';
 /**
- * Worktree-isolation guard for the DB chokepoint (T9806 / council verdict D009).
+ * Refuse to open a project-scope store file that lives inside a git worktree.
  *
- * Defense-in-depth on top of T9803's `getCleoDirAbsolute` THROWS-on-orphan
- * fix. After path resolution, this verifies the resolved `.cleo/`'s parent
- * directory is the **canonical project root** (i.e. `.git` is a real
- * directory) rather than a **git worktree** (i.e. `.git` is a gitlink file).
+ * A project store is `<root>/.cleo/<file>`. When `<root>` is a linked git
+ * checkout (`.git` is a gitlink FILE), the file is a worktree-resident copy
+ * diverged from the parent project's store: writes there never reach the
+ * parent and are lost when the worktree is pruned (T12460). Path resolution
+ * ({@link resolveCleoDir}) maps CLEO worktrees to their parent, so reaching
+ * this guard means the parent could not be resolved or the caller passed an
+ * explicit worktree path.
  *
- * Refusing worktree-resident opens prevents the residual orphan path where a
- * leaked `.cleo/` already exists inside a worktree from a pre-T9803 install:
- * T9803 stops NEW creation, T9806 stops re-use of an OLD leak.
+ * Paths whose parent directory is not named `.cleo` (explicit test fixtures,
+ * snapshot inspection) are outside the project layout and are not checked.
  *
  * Kill-switch: `CLEO_ALLOW_WORKTREE_DB_CREATE=1` bypasses the guard. The
- * override is recorded to stderr (caller may pipe to audit log).
+ * override is recorded on stderr.
+ *
+ * @param role - DB role label, used in the error message only.
+ * @param dbPath - Absolute path of the store file about to be opened.
+ * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when the store's project
+ *   root is a linked git checkout and the kill-switch is not set.
+ * @example
+ * ```ts
+ * assertStorePathIsNotWorktreeResident('project', '/wt/T1/.cleo/cleo.db'); // throws
+ * ```
+ * @task T12460
+ */
+export function assertStorePathIsNotWorktreeResident(role, dbPath) {
+    const cleoDir = dirname(dbPath);
+    if (basename(cleoDir) !== '.cleo')
+        return;
+    const projectRoot = dirname(cleoDir);
+    if (!isGitLinkedCheckout(projectRoot))
+        return;
+    if (process.env['CLEO_ALLOW_WORKTREE_DB_CREATE'] === '1') {
+        process.stderr.write(`[T9806 WT-DB-OVERRIDE] role=${role} path=${dbPath} reason=CLEO_ALLOW_WORKTREE_DB_CREATE=1\n`);
+        return;
+    }
+    throw new CleoError(ExitCode.CONFIG_ERROR, `E_WT_DB_ISOLATION_VIOLATION: refusing to open '${role}' DB at ${dbPath} — parent ${projectRoot} is a git worktree (gitlink). DBs must open against the canonical project root.`, {
+        fix: `Run from the canonical project root, or make sure the worktree's main repository is an initialised CLEO project so it resolves there. Inspect stranded worktree stores with \`cleo doctor worktree-stores\`. Emergency override (audited): CLEO_ALLOW_WORKTREE_DB_CREATE=1.`,
+    });
+}
+/**
+ * Worktree-isolation guard for callers that know only a working directory.
+ *
+ * Resolves the project store path exactly as the open does
+ * (`resolveCleoDir(cwd)` + `cleo.db`, the same derivation as
+ * `resolveDualScopeDbPath('project', cwd)`) and applies
+ * {@link assertStorePathIsNotWorktreeResident} to it.
  *
  * @param role - The DB role label (used in the error message only).
  * @param cwd  - Optional working directory; defaults to `process.cwd()`.
- *
- * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when:
- *   - The resolved `.cleo/`'s parent directory contains `.git` as a FILE
- *     (gitlink — worktree marker), AND
- *   - `CLEO_ALLOW_WORKTREE_DB_CREATE` is not set to `'1'`.
+ * @throws `CleoError('E_WT_DB_ISOLATION_VIOLATION')` when the resolved store
+ *   lives inside a git worktree and the kill-switch is not set.
+ * @example
+ * ```ts
+ * assertDbPathIsNotWorktreeResident('tasks', process.cwd());
+ * ```
  */
 export function assertDbPathIsNotWorktreeResident(role, cwd) {
     let cleoDir;
     try {
-        cleoDir = getCleoDirAbsolute(cwd);
-    }
-    catch {
-        // T9803 already throws on unresolvable project root. Re-raising here
-        // would lose context; let the underlying opener surface the original
-        // error.
-        return;
-    }
-    const projectRoot = dirname(cleoDir);
-    const projectGit = join(projectRoot, '.git');
-    let isWorktreeGitlink = false;
-    try {
-        isWorktreeGitlink = existsSync(projectGit) && statSync(projectGit).isFile();
+        cleoDir = resolveCleoDir(cwd);
     }
     catch {
-        /* If `.git` itself is missing, this isn't our concern — T9803 will fire. */
-    }
-    if (!isWorktreeGitlink) {
-        return;
-    }
-    if (process.env['CLEO_ALLOW_WORKTREE_DB_CREATE'] === '1') {
-        process.stderr.write(`[T9806 WT-DB-OVERRIDE] role=${role} path=${cleoDir} reason=CLEO_ALLOW_WORKTREE_DB_CREATE=1\n`);
+        // Unresolvable project root: let the underlying opener surface the
+        // original error with its own context.
         return;
     }
-    throw new CleoError(ExitCode.CONFIG_ERROR, `E_WT_DB_ISOLATION_VIOLATION: refusing to open '${role}' DB at ${cleoDir} — parent ${projectRoot} is a git worktree (gitlink). DBs must open against the canonical project root.`, {
-        fix: `Run from the canonical project root, OR delete the leaked .cleo/ inside the worktree, OR set CLEO_ALLOW_WORKTREE_DB_CREATE=1 (emergency override, audited).`,
-    });
+    assertStorePathIsNotWorktreeResident(role, join(cleoDir, PROJECT_STORE_FILENAME));
 }
 //# sourceMappingURL=worktree-isolation-guard.js.map

package/dist/store/worktree-isolation-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"worktree-isolation-guard.js","sourceRoot":"","sources":["../../src/store/worktree-isolation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAY,EAAE,GAAY;IAC1E,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,qEAAqE;QACrE,SAAS;QACT,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,CAAC;QACH,iBAAiB,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;IACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,KAAK,GAAG,EAAE,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+BAA+B,IAAI,SAAS,OAAO,2CAA2C,CAC/F,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,YAAY,EACrB,kDAAkD,IAAI,WAAW,OAAO,aAAa,WAAW,iFAAiF,EACjL;QACE,GAAG,EAAE,6JAA6J;KACnK,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"worktree-isolation-guard.js","sourceRoot":"","sources":["../../src/store/worktree-isolation-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,yEAAyE;AACzE,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,oCAAoC,CAAC,IAAY,EAAE,MAAc;IAC/E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,OAAO;QAAE,OAAO;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC;QAAE,OAAO;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,KAAK,GAAG,EAAE,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+BAA+B,IAAI,SAAS,MAAM,2CAA2C,CAC9F,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,YAAY,EACrB,kDAAkD,IAAI,WAAW,MAAM,aAAa,WAAW,iFAAiF,EAChL;QACE,GAAG,EAAE,6QAA6Q;KACnR,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAY,EAAE,GAAY;IAC1E,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,uCAAuC;QACvC,OAAO;IACT,CAAC;IACD,oCAAoC,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/system/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/system/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAsEH,iDAAiD;AACjD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAsGD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,YAAY,CAAC,CA0GvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA4BpE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5C,aAAa,CAuEf;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AAEH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/system/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAsEH,iDAAiD;AACjD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAoCD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,YAAY,CAAC,CA0GvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA4BpE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5C,aAAa,CAuEf;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AAEH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}

package/dist/system/backup.js

@@ -45,10 +45,11 @@
  *                (ADR-013 §10). The previous `.cleo/backups/snapshot/` is now
  *                a deprecated read-only fallthrough for one release.
  */
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
+import { formatBackupTimestamp, rotateBackupDir } from '../store/backup-sidecar.js';
 import { getBrainNativeDb } from '../store/memory-sqlite.js';
 import { getNativeDb } from '../store/sqlite.js';
 /** Default max backup snapshots per backup type directory. */
@@ -99,71 +100,6 @@ function emitLegacyDeprecationWarning() {
 export function _resetLegacyWarningOnce() {
     _legacyWarningEmitted = false;
 }
-/**
- * Format a Date as `YYYYMMDD-HHmmss` (local time) — mirrors the helper of
- * the same name in `sqlite-backup.ts` so both auto-snapshot and manual
- * snapshot files in `.cleo/backups/sqlite/` share one timestamp convention.
- *
- * @task T10315 — unified with `sqlite-backup.ts:formatTimestamp`.
- */
-function formatTimestamp(d) {
-    const pad = (n, len = 2) => String(n).padStart(len, '0');
-    return (`${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}` +
-        `-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`);
-}
-/**
- * Rotate backups in a directory: delete the oldest files until
- * fewer than `maxSnapshots` non-meta files remain.
- *
- * Only rotates files matching the `createBackup` filename scheme
- * (`<file>.<type>-YYYYMMDD-HHmmss` for the canonical timestamp shape OR
- * `<file>.<type>-<iso-with-dashes>` for backward compatibility) so it never
- * touches files produced by `vacuumIntoBackupAll` in the same directory.
- * Non-fatal — filesystem errors are silently swallowed.
- *
- * @task T9194
- * @task T10315 — added scoping predicate so rotation never reaches
- *                vacuum-snapshot files that share `.cleo/backups/sqlite/`.
- */
-function rotateBackupDir(backupDir, maxSnapshots, backupType) {
-    try {
-        // Match `<anything>.${backupType}-<timestamp>` where timestamp is either
-        // canonical (`YYYYMMDD-HHmmss`) or legacy-ISO (`YYYY-MM-DDTHH-MM-SS-mmmZ`).
-        // Excludes:
-        //   - `.meta.json` sidecars (filtered explicitly below)
-        //   - `.tmp` partial writes
-        //   - vacuum-snapshot files (`tasks-YYYYMMDD-HHmmss.db`, `brain-...`) —
-        //     those start with the prefix, not `.<file>.${backupType}-`.
-        const escapedType = backupType.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        const ownedPattern = new RegExp(`\\.${escapedType}-`);
-        const files = readdirSync(backupDir)
-            .filter((f) => !f.endsWith('.meta.json') && !f.endsWith('.tmp') && ownedPattern.test(f))
-            .map((f) => ({
-            name: f,
-            path: join(backupDir, f),
-            mtimeMs: statSync(join(backupDir, f)).mtimeMs,
-        }))
-            .sort((a, b) => a.mtimeMs - b.mtimeMs); // oldest first
-        while (files.length > maxSnapshots) {
-            const oldest = files.shift();
-            if (!oldest)
-                break;
-            try {
-                unlinkSync(oldest.path);
-                // Also delete the corresponding .meta.json sidecar if it exists.
-                const metaPath = `${oldest.path}.meta.json`;
-                if (existsSync(metaPath))
-                    unlinkSync(metaPath);
-            }
-            catch {
-                /* non-fatal */
-            }
-        }
-    }
-    catch {
-        // non-fatal — rotation failures must never block the backup operation
-    }
-}
 /** Safe wrapper around VACUUM INTO: flushes WAL then clones the DB. */
 function safeSqliteSnapshot(db, destPath) {
     if (!db)
@@ -231,7 +167,7 @@ export async function createBackup(projectRoot, opts) {
     // Unified `YYYYMMDD-HHmmss` local-time stamp — matches
     // `sqlite-backup.ts:formatTimestamp`. The `type` discriminates manual
     // snapshots from auto-VACUUM-INTO files in the SAME directory.
-    const backupId = `${btype}-${formatTimestamp(now)}`;
+    const backupId = `${btype}-${formatBackupTimestamp(now)}`;
     const backupDir = join(cleoDir, 'backups', CANONICAL_BACKUP_SUBDIR);
     if (!existsSync(backupDir)) {
         mkdirSync(backupDir, { recursive: true });

package/dist/system/backup.js.map

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

package/dist/system/cleo-link.d.ts

@@ -0,0 +1,163 @@
+/**
+ * `~/.cleo` link audit and repair — the keystone of global protocol delivery.
+ *
+ * The global hub `~/.agents/AGENTS.md` references
+ * `@~/.cleo/templates/CLEO-INJECTION.md`. That path is only real when
+ * `~/.cleo` links to the OS data directory (`getCleoHome()`): `~/.local/share/cleo`
+ * on Linux, `~/Library/Application Support/cleo` on macOS,
+ * `%LOCALAPPDATA%\cleo\Data` on Windows. A link carried between machines by
+ * dotfiles (a macOS `~/.cleo` pointing at `/home/<user>/.local/share/cleo`)
+ * dangles, and every harness loading the hub silently receives NO protocol —
+ * no error, just an unresolved reference (T12596).
+ *
+ * `existsSync` follows links, so a dangling link reads as ABSENT; creating a
+ * link over it then fails with `EEXIST`. Everything here classifies with
+ * `lstat` first for that reason.
+ *
+ * @task T12596
+ */
+/** The reference the global hub writes; identical on every OS. */
+export declare const CANONICAL_HUB_TEMPLATE_REF = "@~/.cleo/templates/CLEO-INJECTION.md";
+/**
+ * State of `~/.cleo`:
+ * - `canonical` — a link to `getCleoHome()` (or `CLEO_HOME` IS `~/.cleo`).
+ * - `absent`    — nothing there.
+ * - `dangling`  — a link whose target does not exist (e.g. a Linux path on macOS).
+ * - `foreign`   — a link to an existing directory that is not `getCleoHome()`.
+ * - `directory` — a real directory (pre-canonical layout).
+ * - `other`     — a regular file or anything else; never touched.
+ */
+export type CleoLinkState = 'canonical' | 'absent' | 'dangling' | 'foreign' | 'directory' | 'other';
+/** Result of {@link auditCleoLink}. */
+export interface CleoLinkAudit {
+    /** Absolute `~/.cleo` path. */
+    path: string;
+    /** Where the link must point: `getCleoHome()`. */
+    canonicalTarget: string;
+    /** Classified state. */
+    state: CleoLinkState;
+    /** Current link target, or null when `~/.cleo` is not a link. */
+    target: string | null;
+    /** True when the hub reference `~/.cleo/templates/CLEO-INJECTION.md` resolves to a file. */
+    hubReferenceResolves: boolean;
+    /** True when `repairCleoLink` can bring the link to `canonical`. */
+    repairable: boolean;
+    /** Exact command that repairs this state, or null when healthy / not repairable. */
+    remedy: string | null;
+}
+/** Receipt written for every non-dry-run {@link repairCleoLink}. */
+export interface CleoLinkRepairReceipt {
+    /** Unique receipt id. */
+    receiptId: string;
+    /** ISO timestamp. */
+    at: string;
+    /** What was done. */
+    action: 'none' | 'created' | 'relinked' | 'refused';
+    /** State and target before the repair. */
+    before: {
+        state: CleoLinkState;
+        target: string | null;
+    };
+    /** State and target after the repair. */
+    after: {
+        state: CleoLinkState;
+        target: string | null;
+    };
+    /**
+     * Where the previous entry was moved (a live foreign link or a directory),
+     * so the repair is reversible; null when nothing needed preserving.
+     */
+    preservedAt: string | null;
+    /** Why the repair was refused, when `action === 'refused'`. */
+    reason: string | null;
+    /** JSONL file the receipt was appended to, or null on a dry run. */
+    receiptLog: string | null;
+    /**
+     * Lifecycle phase of this receipt line. An `intent` line is appended BEFORE
+     * anything on disk changes, so a crash between the preserve-rename and the
+     * new link still leaves a record of where the old entry went; the final
+     * line is `completed` or `rolled-back`. `planned` receipts (dry run, no-op,
+     * refused) are returned but never written.
+     */
+    phase: 'intent' | 'completed' | 'rolled-back' | 'planned';
+}
+/** Thrown when creating the `~/.cleo` link fails; the previous entry has been restored. */
+export declare class CleoLinkRepairError extends Error {
+    readonly receipt: CleoLinkRepairReceipt;
+    /** Stable error code. */
+    readonly code = "E_CLEO_LINK_REPAIR_FAILED";
+    /**
+     * @param message - What failed.
+     * @param receipt - The `rolled-back` receipt (also appended to the log).
+     */
+    constructor(message: string, receipt: CleoLinkRepairReceipt);
+}
+/** Options shared by the audit and repair functions (tests inject paths). */
+export interface CleoLinkOptions {
+    /** `~/.cleo` path. Defaults to `resolveLegacyCleoDir()`. */
+    path?: string;
+    /** Link target. Defaults to `getCleoHome()`. */
+    canonicalTarget?: string;
+}
+/** Repair command printed in remedies and warnings. */
+export declare const CLEO_LINK_REPAIR_COMMAND = "cleo doctor global-delivery --repair";
+/**
+ * True when mutating `linkPath` to point at `target` would bind a real,
+ * non-temporary `~/.cleo` to a temporary directory — the shape of a test run
+ * that overrides `CLEO_HOME` without overriding `HOME`. Refused so a test can
+ * never repoint the developer's own `~/.cleo` at a scratch directory.
+ */
+export declare function wouldBindRealHomeToTemp(linkPath: string, target: string): boolean;
+/**
+ * Classify `~/.cleo` without modifying anything.
+ *
+ * @param opts - Path overrides (tests).
+ * @returns The audit; `remedy` names the exact repair command when one applies.
+ * @task T12596
+ */
+export declare function auditCleoLink(opts?: CleoLinkOptions): CleoLinkAudit;
+/**
+ * Bring `~/.cleo` to the canonical link and record a receipt.
+ *
+ * - `absent` → create the link.
+ * - `dangling` → replace the link (it reaches nothing, so nothing is lost;
+ *   the old target is kept in the receipt).
+ * - `foreign` / `directory` → move the entry to `~/.cleo.preserved-<ts>` (a
+ *   foreign link stays a link, keeping its target), then create the link.
+ * - `other`, or a real `~/.cleo` whose target would be a temp dir → refused.
+ *
+ * Receipts are appended to `<cleoHome>/audit/cleo-link-repairs.jsonl`.
+ *
+ * @param opts - `dryRun` reports the planned action without touching disk;
+ *   `states` limits which states may be repaired (bootstrap passes only the
+ *   lossless ones: `absent`, `dangling`).
+ * @returns The final audit plus the receipt.
+ * @task T12596
+ */
+export declare function repairCleoLink(opts?: CleoLinkOptions & {
+    dryRun?: boolean;
+    states?: readonly CleoLinkState[];
+}): Promise<{
+    audit: CleoLinkAudit;
+    receipt: CleoLinkRepairReceipt;
+}>;
+/**
+ * Content for the global hub's CAAMP block.
+ *
+ * Normally the one-line canonical reference. When `~/.cleo/templates` does not
+ * resolve (a link the bootstrap could not repair), a reference would deliver
+ * nothing — so the protocol text is embedded instead, with a marker naming
+ * the repair. Once the link is repaired the next bootstrap writes the
+ * reference again.
+ *
+ * @param templateContent - Installed `CLEO-INJECTION.md` text (embedded on fallback).
+ * @param opts - Path overrides (tests).
+ * @returns The block content and which mode was chosen.
+ * @task T12596
+ */
+export declare function resolveGlobalHubContent(templateContent: string | null, opts?: CleoLinkOptions): {
+    content: string;
+    mode: 'reference' | 'embedded';
+    audit: CleoLinkAudit;
+};
+//# sourceMappingURL=cleo-link.d.ts.map

package/dist/system/cleo-link.d.ts.map

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