@cleocode/paths 2026.5.123 → 2026.5.125

package/dist/cleo-paths.d.ts

@@ -111,6 +111,102 @@ export declare function getCanonicalTemplatesTildePath(): string;
  * @public
  */
 export declare function resolveLegacyCleoDir(override?: string): string;
+/**
+ * Result of {@link resolveProjectByCwd} — the project identity resolved
+ * from walking up from a working directory.
+ *
+ * @public
+ /** Result of {@link resolveProjectByCwd} — the project identity resolved from walking up from a working directory. */
+export interface ResolvedProject {
+    /** Stable canonical project ID (12-hex-char SHA-256 of git-root|name|remote). */
+    projectId: string;
+    /** Absolute realpath to the project root directory. */
+    projectRoot: string;
+    /** The legacy UUID from project-info.json, if present. */
+    legacyUUID?: string;
+}
+/**
+ * Compute the canonical project ID for a given repository path (T9149/T11023).
+ *
+ * Algorithm:
+ *   1. Resolve `repoPath` to its `realpath` (resolves symlinks, normalises mounts).
+ *   2. Detect the git root via `git rev-parse --show-toplevel` (falls back to realpath).
+ *   3. Read `.cleo/project-info.json` name (optional).
+ *   4. Read `git remote get-url origin` (optional).
+ *   5. SHA-256 of `<gitRoot>|<projectName>|<remoteUrl>`, first 12 hex chars.
+ *
+ * This ensures `/mnt/projects/X` and `/workspace/X` (same git root,
+ * same remote) produce the same ID.
+ *
+ * @param repoPath - Absolute path to the project root.
+ * @returns The 12-hex-char canonical project ID.
+ *
+ * @task T11023
+ * @task T9149
+ */
+export declare function computeCanonicalProjectId(repoPath: string): string;
+/**
+ * Compute the legacy base64url(path) ID for a given path.
+ * This is the old algorithm used before T9149 W5.
+ */
+export declare function legacyProjectId(repoPath: string): string;
+/**
+ * Walk up from `cwd` (or `process.cwd()`) looking for `.cleo/project-info.json`
+ * and return the project identity if found.
+ *
+ * This replaces the ancestor-walk pattern in `getCleoDirAbsolute` with a
+ * projectId-aware lookup. Instead of resolving a `.cleo/` directory via
+ * git-root heuristics, it reads the stable `projectId` from the canonical
+ * project-info file — enabling move-safe project identification.
+ *
+ * **Cross-mount divergence (T11023):** Uses `realpathSync` to normalize
+ * bind-mounts and symlinks so the same repo at `/mnt/projects/X` and
+ * `/workspace/X` resolves to the same `projectRoot`. The `projectId` is
+ * the T9149 canonical 12-hex-char SHA-256 fingerprint of git-root + name
+ * + remote URL, which is also mount-invariant.
+ *
+ * @param cwd - Optional working directory to start the ancestor walk from.
+ *   Defaults to `process.cwd()`.
+ * @returns The resolved project identity, or `null` if no CLEO project is
+ *   found anywhere in the ancestor chain.
+ *
+ * @example
+ * ```typescript
+ * const project = resolveProjectByCwd('/repo/packages/core');
+ * // { projectId: 'a1b2c3d4e5f6', projectRoot: '/repo' }
+ *
+ * const notFound = resolveProjectByCwd('/tmp/empty');
+ * // null
+ * ```
+ *
+ * @public
+ * @task T11008
+ * @task T11023
+ */
+export declare function resolveProjectByCwd(cwd?: string): ResolvedProject | null;
+/**
+ * Resolve the canonical `.cleo` directory for a project given its `projectId`.
+ *
+ * Looks up the project in the global `nexus.db` registry (`project_registry`
+ * table) to find the project's root path, then returns the `.cleo/` directory
+ * under that root.
+ *
+ * **Legacy ID support (T11023 AC4):** If the `projectId` is not found in
+ * `project_registry`, also checks the `project_id_aliases` table for a
+ * legacy→canonical mapping before returning `null`.
+ *
+ * This enables cross-project lookups: given a stable project ID, resolve where
+ * that project lives on disk without walking from a working directory.
+ *
+ * @param projectId - The project ID to look up. Can be a canonical 12-hex-char
+ *   ID, a legacy UUID, or a legacy base64url(path) ID.
+ * @returns Absolute path to the `.cleo/` directory, or `null` if the
+ *   projectId is not found in the nexus registry (or its alias table).
+ *
+ * @task T11008
+ * @task T11023
+ */
+export declare function resolveCanonicalCleoDir(projectId: string): string | null;
 /**
  * Invalidate the cached CLEO system info snapshot. Use in tests after
  * mutating `CLEO_HOME` or related env vars.

package/dist/cleo-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleo-paths.d.ts","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"cleo-paths.d.ts","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;uHAKuH;AACvH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA8CxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiExE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/cleo-paths.js

@@ -8,8 +8,12 @@
  *
  * @task T1883
  */
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
 import { createPlatformPathsResolver, } from './platform-paths.js';
 const TEMPLATES_SUBDIR = 'templates';
 const cleoResolver = createPlatformPathsResolver('cleo', 'CLEO_HOME', 'CLEO_CONFIG_HOME');
@@ -145,6 +149,243 @@ export function resolveLegacyCleoDir(override) {
         return override;
     return join(homedir(), '.cleo');
 }
+// ---------------------------------------------------------------------------
+// Canonical project ID computation (T11023 — cross-mount divergence)
+// ---------------------------------------------------------------------------
+/**
+ * Synchronously find the git root for a given directory.
+ * Returns `null` if the directory is not inside a git repo.
+ */
+function _findGitRootSync(fromPath) {
+    try {
+        const stdout = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd: resolve(fromPath),
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return resolve(stdout.trim());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Synchronously find the primary git remote URL (origin fetch URL).
+ * Returns `null` when there are no remotes or git is unavailable.
+ */
+function _findGitRemoteUrlSync(fromPath) {
+    try {
+        const stdout = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd: resolve(fromPath),
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const url = stdout.trim();
+        return url || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the project name from `.cleo/project-info.json` (if present).
+ * Non-fatal on any I/O or parse error.
+ */
+function _readProjectInfoName(repoRoot) {
+    try {
+        const raw = readFileSync(join(repoRoot, '.cleo', 'project-info.json'), 'utf-8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.name === 'string' ? parsed.name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Compute the canonical project ID for a given repository path (T9149/T11023).
+ *
+ * Algorithm:
+ *   1. Resolve `repoPath` to its `realpath` (resolves symlinks, normalises mounts).
+ *   2. Detect the git root via `git rev-parse --show-toplevel` (falls back to realpath).
+ *   3. Read `.cleo/project-info.json` name (optional).
+ *   4. Read `git remote get-url origin` (optional).
+ *   5. SHA-256 of `<gitRoot>|<projectName>|<remoteUrl>`, first 12 hex chars.
+ *
+ * This ensures `/mnt/projects/X` and `/workspace/X` (same git root,
+ * same remote) produce the same ID.
+ *
+ * @param repoPath - Absolute path to the project root.
+ * @returns The 12-hex-char canonical project ID.
+ *
+ * @task T11023
+ * @task T9149
+ */
+export function computeCanonicalProjectId(repoPath) {
+    const realRepoPath = realpathSync(resolve(repoPath));
+    const gitRoot = _findGitRootSync(realRepoPath);
+    const effectiveRoot = gitRoot ?? realRepoPath;
+    const remoteUrl = gitRoot ? _findGitRemoteUrlSync(gitRoot) : null;
+    const projectName = _readProjectInfoName(effectiveRoot);
+    const fingerprint = [effectiveRoot, projectName ?? '', remoteUrl ?? ''].join('|');
+    return createHash('sha256').update(fingerprint).digest('hex').substring(0, 12);
+}
+/**
+ * Compute the legacy base64url(path) ID for a given path.
+ * This is the old algorithm used before T9149 W5.
+ */
+export function legacyProjectId(repoPath) {
+    return Buffer.from(repoPath).toString('base64url').slice(0, 32);
+}
+/**
+ * Walk up from `cwd` (or `process.cwd()`) looking for `.cleo/project-info.json`
+ * and return the project identity if found.
+ *
+ * This replaces the ancestor-walk pattern in `getCleoDirAbsolute` with a
+ * projectId-aware lookup. Instead of resolving a `.cleo/` directory via
+ * git-root heuristics, it reads the stable `projectId` from the canonical
+ * project-info file — enabling move-safe project identification.
+ *
+ * **Cross-mount divergence (T11023):** Uses `realpathSync` to normalize
+ * bind-mounts and symlinks so the same repo at `/mnt/projects/X` and
+ * `/workspace/X` resolves to the same `projectRoot`. The `projectId` is
+ * the T9149 canonical 12-hex-char SHA-256 fingerprint of git-root + name
+ * + remote URL, which is also mount-invariant.
+ *
+ * @param cwd - Optional working directory to start the ancestor walk from.
+ *   Defaults to `process.cwd()`.
+ * @returns The resolved project identity, or `null` if no CLEO project is
+ *   found anywhere in the ancestor chain.
+ *
+ * @example
+ * ```typescript
+ * const project = resolveProjectByCwd('/repo/packages/core');
+ * // { projectId: 'a1b2c3d4e5f6', projectRoot: '/repo' }
+ *
+ * const notFound = resolveProjectByCwd('/tmp/empty');
+ * // null
+ * ```
+ *
+ * @public
+ * @task T11008
+ * @task T11023
+ */
+export function resolveProjectByCwd(cwd) {
+    const start = resolve(cwd ?? process.cwd());
+    let current = start;
+    while (true) {
+        const infoPath = join(current, '.cleo', 'project-info.json');
+        if (existsSync(infoPath)) {
+            try {
+                const raw = readFileSync(infoPath, 'utf-8');
+                const data = JSON.parse(raw);
+                if (typeof data.projectId === 'string' && data.projectId.length > 0) {
+                    // T11023: Normalize projectRoot via realpathSync to handle cross-mount
+                    // divergence — same repo at /mnt/projects/X and /workspace/X resolves
+                    // to the same real path (AC2, AC3).
+                    let realRoot;
+                    try {
+                        realRoot = realpathSync(current);
+                    }
+                    catch {
+                        // realpathSync fails on nonexistent paths — fall back to resolved path
+                        realRoot = current;
+                    }
+                    // T11023: Compute canonical projectId using T9149 algorithm
+                    // (git-root + realpath fingerprint) for mount-invariant identity (AC1).
+                    const canonicalId = computeCanonicalProjectId(realRoot);
+                    return {
+                        projectId: canonicalId,
+                        projectRoot: realRoot,
+                        legacyUUID: data.projectId,
+                    };
+                }
+            }
+            catch {
+                // Corrupt or unparseable project-info.json — keep walking up.
+                // A higher ancestor may have a valid one.
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break; // Reached filesystem root
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Resolve the canonical `.cleo` directory for a project given its `projectId`.
+ *
+ * Looks up the project in the global `nexus.db` registry (`project_registry`
+ * table) to find the project's root path, then returns the `.cleo/` directory
+ * under that root.
+ *
+ * **Legacy ID support (T11023 AC4):** If the `projectId` is not found in
+ * `project_registry`, also checks the `project_id_aliases` table for a
+ * legacy→canonical mapping before returning `null`.
+ *
+ * This enables cross-project lookups: given a stable project ID, resolve where
+ * that project lives on disk without walking from a working directory.
+ *
+ * @param projectId - The project ID to look up. Can be a canonical 12-hex-char
+ *   ID, a legacy UUID, or a legacy base64url(path) ID.
+ * @returns Absolute path to the `.cleo/` directory, or `null` if the
+ *   projectId is not found in the nexus registry (or its alias table).
+ *
+ * @task T11008
+ * @task T11023
+ */
+export function resolveCanonicalCleoDir(projectId) {
+    const cleoHome = getCleoHome();
+    const nexusDbPath = join(cleoHome, 'nexus.db');
+    if (!existsSync(nexusDbPath))
+        return null;
+    let db;
+    try {
+        db = new DatabaseSync(nexusDbPath, { readOnly: true });
+        // Try direct project_registry lookup first.
+        const directStmt = db.prepare('SELECT project_path FROM project_registry WHERE project_id = ? LIMIT 1');
+        const directRow = directStmt.get(projectId);
+        if (directRow &&
+            typeof directRow.project_path === 'string' &&
+            directRow.project_path.length > 0) {
+            return join(directRow.project_path, '.cleo');
+        }
+        // T11023 AC4: Fall back to project_id_aliases for legacy ID resolution.
+        // Legacy base64url(path) IDs and old UUIDs are mapped to canonical IDs
+        // in the aliases table. Try resolving the input as a legacy ID first,
+        // then look up the canonical ID.
+        try {
+            const aliasStmt = db.prepare('SELECT canonical_id FROM project_id_aliases WHERE legacy_id = ? LIMIT 1');
+            const aliasRow = aliasStmt.get(projectId);
+            if (aliasRow &&
+                typeof aliasRow.canonical_id === 'string' &&
+                aliasRow.canonical_id.length > 0) {
+                // Resolved a legacy alias — look up the canonical ID.
+                const canonicalRow = directStmt.get(aliasRow.canonical_id);
+                if (canonicalRow &&
+                    typeof canonicalRow.project_path === 'string' &&
+                    canonicalRow.project_path.length > 0) {
+                    return join(canonicalRow.project_path, '.cleo');
+                }
+            }
+        }
+        catch {
+            // project_id_aliases table may not exist yet (pre-migration) — non-fatal.
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            // Best-effort close
+        }
+    }
+}
 /**
  * Invalidate the cached CLEO system info snapshot. Use in tests after
  * mutating `CLEO_HOME` or related env vars.

package/dist/cleo-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleo-paths.js","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,2BAA2B,GAG5B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC,MAAM,YAAY,GAAG,2BAA2B,CAAC,MAAM,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;AAE1F;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,aAAa,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,qEAAqE;IACrE,qEAAqE;IACrE,wCAAwC;IACxC,MAAM,OAAO,GACX,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,GAAG,QAAQ,IAAI,gBAAgB,EAAE;QACnC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,8BAA8B;IAC5C,4EAA4E;IAC5E,+EAA+E;IAC/E,8EAA8E;IAC9E,6EAA6E;IAC7E,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAiB;IACpD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC1C,YAAY,CAAC,UAAU,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"cleo-paths.js","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@
  * - {@link createPlatformPathsResolver} — generic factory bindable to any app
  * - CLEO-bound helpers: {@link getCleoHome}, {@link getCleoPlatformPaths},
  *   {@link getCleoSystemInfo}, {@link getCleoTemplatesTildePath}
+ * - Project resolution: {@link resolveProjectByCwd}, {@link resolveCanonicalCleoDir}
  * - Worktree primitives: {@link computeProjectHash},
  *   {@link resolveWorktreeRootForHash}, {@link resolveTaskWorktreePath},
  *   {@link getCleoWorktreesRoot}, {@link resolveWorktreeIndexPath}
@@ -17,9 +18,10 @@
  *
  * @packageDocumentation
  * @task T1883
+ * @task T11008
  */
 export { isAbsolutePath } from './abs-path.js';
-export { _resetCleoPlatformPathsCache, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, resolveLegacyCleoDir, } from './cleo-paths.js';
+export { _resetCleoPlatformPathsCache, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, type ResolvedProject, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
 export { createPlatformPathsResolver, type PlatformPaths, type PlatformPathsResolver, type SystemInfo, } from './platform-paths.js';
 export { computeProjectHash, getCleoWorktreesRoot, resolveTaskWorktreePath, resolveWorktreeIndexPath, resolveWorktreeRootForHash, } from './worktree-paths.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,KAAK,eAAe,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -10,6 +10,7 @@
  * - {@link createPlatformPathsResolver} — generic factory bindable to any app
  * - CLEO-bound helpers: {@link getCleoHome}, {@link getCleoPlatformPaths},
  *   {@link getCleoSystemInfo}, {@link getCleoTemplatesTildePath}
+ * - Project resolution: {@link resolveProjectByCwd}, {@link resolveCanonicalCleoDir}
  * - Worktree primitives: {@link computeProjectHash},
  *   {@link resolveWorktreeRootForHash}, {@link resolveTaskWorktreePath},
  *   {@link getCleoWorktreesRoot}, {@link resolveWorktreeIndexPath}
@@ -17,9 +18,10 @@
  *
  * @packageDocumentation
  * @task T1883
+ * @task T11008
  */
 export { isAbsolutePath } from './abs-path.js';
-export { _resetCleoPlatformPathsCache, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, resolveLegacyCleoDir, } from './cleo-paths.js';
+export { _resetCleoPlatformPathsCache, computeCanonicalProjectId, getCanonicalTemplatesTildePath, getCleoHome, getCleoPlatformPaths, getCleoSystemInfo, getCleoTemplatesTildePath, legacyProjectId, resolveCanonicalCleoDir, resolveLegacyCleoDir, resolveProjectByCwd, } from './cleo-paths.js';
 export { createPlatformPathsResolver, } from './platform-paths.js';
 export { computeProjectHash, getCleoWorktreesRoot, resolveTaskWorktreePath, resolveWorktreeIndexPath, resolveWorktreeRootForHash, } from './worktree-paths.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,GAI5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/worktree-paths.d.ts

@@ -21,6 +21,10 @@
  * the historical implementation in `branch-lock.ts#resolveAgentWorktreeRoot`
  * (the root cause of the duplicated logic this package consolidates).
  *
+ * **Cross-mount normalization (T11023 AC3):** The input path is resolved
+ * through `realpathSync` before hashing so that different mount points
+ * (/mnt/projects/X vs /workspace/X) produce the same hash.
+ *
  * @param projectRoot - Absolute path to the project root.
  * @returns 16-character lowercase hex string.
  *

package/dist/worktree-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktree-paths.d.ts","sourceRoot":"","sources":["../src/worktree-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0BH;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE"}
+{"version":3,"file":"worktree-paths.d.ts","sourceRoot":"","sources":["../src/worktree-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA2BH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/worktree-paths.js

@@ -15,6 +15,7 @@
  * @task T9802
  */
 import { createHash } from 'node:crypto';
+import { realpathSync } from 'node:fs';
 import { join } from 'node:path';
 import { getCleoHome } from './cleo-paths.js';
 const WORKTREES_SUBDIR = 'worktrees';
@@ -42,13 +43,26 @@ function joinSegments(base, ...parts) {
  * the historical implementation in `branch-lock.ts#resolveAgentWorktreeRoot`
  * (the root cause of the duplicated logic this package consolidates).
  *
+ * **Cross-mount normalization (T11023 AC3):** The input path is resolved
+ * through `realpathSync` before hashing so that different mount points
+ * (/mnt/projects/X vs /workspace/X) produce the same hash.
+ *
  * @param projectRoot - Absolute path to the project root.
  * @returns 16-character lowercase hex string.
  *
  * @public
  */
 export function computeProjectHash(projectRoot) {
-    return createHash('sha256').update(projectRoot).digest('hex').slice(0, PROJECT_HASH_LENGTH);
+    // T11023: Normalize via realpath to handle cross-mount divergence.
+    // realpathSync throws on nonexistent paths — fall back to raw path.
+    let normalized;
+    try {
+        normalized = realpathSync(projectRoot);
+    }
+    catch {
+        normalized = projectRoot;
+    }
+    return createHash('sha256').update(normalized).digest('hex').slice(0, PROJECT_HASH_LENGTH);
 }
 /**
  * Resolve the worktrees root directory for a given project hash.

package/dist/worktree-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"worktree-paths.js","sourceRoot":"","sources":["../src/worktree-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,gBAAgB,GAAG,WAAW,CAAC;AACrC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,GAAG,KAAe;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,YAAqB;IACnF,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,YAAY,CAAC,WAAW,EAAE,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,MAAc,EACd,YAAqB;IAErB,MAAM,IAAI,GAAG,0BAA0B,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnE,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"worktree-paths.js","sourceRoot":"","sources":["../src/worktree-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,gBAAgB,GAAG,WAAW,CAAC;AACrC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,GAAG,KAAe;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,mEAAmE;IACnE,oEAAoE;IACpE,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,WAAW,CAAC;IAC3B,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,YAAqB;IACnF,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,YAAY,CAAC,WAAW,EAAE,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,MAAc,EACd,YAAqB;IAErB,MAAM,IAAI,GAAG,0BAA0B,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnE,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/paths",
-  "version": "2026.5.123",
+  "version": "2026.5.125",
   "private": false,
   "type": "module",
   "description": "CLEO XDG/env-paths SSoT — createPlatformPathsResolver factory, cleo-bound platform paths, project hash + worktree root primitives, isAbsolutePath. Zero-dep leaf package consumed by core, worktree, brain, adapters, and caamp.",