@cleocode/paths 2026.9.19 → 2026.9.21

package/dist/cleo-paths.d.ts

@@ -29,6 +29,38 @@ export declare function getCleoPlatformPaths(): PlatformPaths;
  * @public
  */
 export declare function getCleoHome(): string;
+/**
+ * Get the absolute path to CLEO's global state directory.
+ *
+ * State is data CLEO keeps between runs but can rebuild or lose: warn-once
+ * caches, deprecation telemetry, cleanup audit logs.
+ *
+ * Linux:   `$XDG_STATE_HOME/cleo` (default `~/.local/state/cleo`)
+ * macOS:   `<getCleoHome()>/state` (`~/Library/Application Support/cleo/state`)
+ * Windows: `<getCleoHome()>/state` (`%LOCALAPPDATA%\cleo\Data\state`)
+ *
+ * macOS and Windows have no XDG state dir, so state lives beside the data it
+ * describes and follows a `CLEO_HOME` override.
+ *
+ * @returns Absolute path of the state directory. Not created.
+ *
+ * @public
+ * @task T12602
+ */
+export declare function getCleoStateDir(): string;
+/**
+ * Path of the persisted stable device id — `<cleoHome>/device-id`.
+ *
+ * Core's `getStableDeviceId()` creates it; `@cleocode/worktree` reads it to
+ * decide whether a worktree lock holder's pid can be probed on this device
+ * (T12506). One path, two readers.
+ *
+ * @returns Absolute path of the device-id file.
+ *
+ * @public
+ * @task T12506
+ */
+export declare function resolveStableDeviceIdPath(): string;
 /**
  * Get a cached system information snapshot scoped to CLEO.
  *
@@ -118,13 +150,61 @@ export declare function resolveLegacyCleoDir(override?: string): string;
  * @public
  */
 export interface ResolvedProject {
-    /** Canonical runtime project ID (12-hex-char SHA-256 of git-root|name|remote). */
+    /**
+     * The project's portable identity (ADR-094, T12470): the tracked
+     * `.cleo/project-id` when valid, otherwise the `projectId` recorded in
+     * `.cleo/project-info.json`. Never derived from the path. Treat it as an
+     * opaque string — ids of every historical shape (UUID, 12-hex, legacy) occur.
+     */
     projectId: string;
     /** Absolute realpath to the project root directory. */
     projectRoot: string;
-    /** The legacy UUID from project-info.json, if present. */
+    /** The `projectId` recorded in `project-info.json`, if present. */
     legacyUUID?: string;
+    /**
+     * Which declaration supplied {@link ResolvedProject.projectId}. Optional so
+     * callers that construct a `ResolvedProject` themselves keep compiling;
+     * {@link resolveProjectByCwd} always sets it.
+     */
+    source?: DeclaredProjectIdentity['source'];
+}
+/**
+ * A project identity declared by files inside `<root>/.cleo/` — the only
+ * sources that may name a project (ADR-094, T12470).
+ *
+ * @public
+ */
+export interface DeclaredProjectIdentity {
+    /** The opaque project id. */
+    readonly projectId: string;
+    /** `tracked` = `.cleo/project-id`; `project-info` = `.cleo/project-info.json`. */
+    readonly source: 'tracked' | 'project-info';
+    /** The `projectId` recorded in `project-info.json`, when that file has one. */
+    readonly infoProjectId?: string;
 }
+/**
+ * Read the identity a project root DECLARES, in precedence order (T12470):
+ *
+ *   1. the tracked, write-once `.cleo/project-id` (ADR-094);
+ *   2. the `projectId` in `.cleo/project-info.json`.
+ *
+ * A malformed tracked file is skipped here (it is reported by
+ * `cleo doctor project-identity`) and never replaced by a derived value.
+ * Nothing about the path — its spelling, realpath, git root or remote — takes
+ * part: moving or re-cloning a project keeps its id.
+ *
+ * @param projectRoot - Directory containing `.cleo/`.
+ * @returns The declared identity, or `null` when the root declares none.
+ *
+ * @example
+ * ```ts
+ * readDeclaredProjectIdentity('/repo'); // { projectId: 'c78d09c3a8ee', source: 'tracked' }
+ * ```
+ *
+ * @public
+ * @task T12470
+ */
+export declare function readDeclaredProjectIdentity(projectRoot: string): DeclaredProjectIdentity | null;
 /**
  * Canonicalize a filesystem path across operating systems — resolve symlinks
  * and mount/alias divergence (macOS `/var` → `/private/var`, Windows
@@ -149,25 +229,30 @@ export interface ResolvedProject {
  */
 export declare function canonicalizePath(p: string): string;
 /**
- * Compute the canonical project ID for a given repository path (T9149/T11023).
+ * Compute the path-derived fingerprint `sha256(gitRoot|name|remote)[0:12]`.
  *
- * 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.
+ * **Not an identity (T12470, supersedes the T9149/T11023 design).** A project
+ * is identified only by its declared id ({@link readDeclaredProjectIdentity}).
+ * This fingerprint survives solely as a LOOKUP KEY into
+ * `nexus_project_id_aliases`, so ids that older CLEO versions derived from a
+ * path keep resolving to the project that now owns them. Never return it as a
+ * project id and never mint a registry row from it.
  *
  * @param repoPath - Absolute path to the project root.
- * @returns The 12-hex-char canonical project ID.
+ * @returns The 12-hex-char path fingerprint.
  *
- * @task T11023
- * @task T9149
+ * @public
+ * @task T12470
  */
-export declare function computeCanonicalProjectId(repoPath: string): string;
+export declare function computePathFingerprintId(repoPath: string): string;
+/**
+ * Former name of {@link computePathFingerprintId}.
+ *
+ * @deprecated T12470 — the value is a path fingerprint (alias key), not a
+ * project id. Use {@link readDeclaredProjectIdentity} for identity and
+ * {@link computePathFingerprintId} for alias lookups.
+ */
+export declare const computeCanonicalProjectId: (repoPath: string) => string;
 /**
  * Compute the legacy base64url(path) ID for a given path.
  *
@@ -176,29 +261,58 @@ export declare function computeCanonicalProjectId(repoPath: string): string;
  * before T9149 W5: `Buffer.from(path).toString('base64url').slice(0, 32)`.
  */
 export declare function legacyProjectId(repoPath: string): string;
+/** A project and one path recorded for it, as read from the registry (T12589). */
+export interface RecordedProjectPath {
+    /** Immutable project id. */
+    readonly projectId: string;
+    /** A path recorded for the project (registry row or location). */
+    readonly path: string;
+}
 /**
- * Walk up from `cwd` (or `process.cwd()`) looking for `.cleo/project-info.json`
- * and return the project identity if found.
+ * Every project that can claim an alias key (T12589): the alias row's owner
+ * plus each project with a recorded path whose {@link legacyProjectId} is the
+ * key.
+ *
+ * The legacy id encodes only the first 24 bytes of a path, so every project
+ * under a long shared prefix (`/Users/<name>/projects/…`) derives the SAME
+ * key. A key with more than one claimant is ambiguous: it names no project,
+ * and a resolver must refuse it rather than return whichever project happened
+ * to record it first. A non-legacy key (full-path fingerprint, UUID) is never
+ * derived from a path by this function, so only its owner claims it.
+ *
+ * @param alias - The alias key being resolved or recorded.
+ * @param owner - `canonical_id` of the alias row for `alias`, when one exists.
+ * @param paths - Every recorded project path to check.
+ * @returns Distinct claimant ids, sorted; ambiguous when longer than one.
+ * @example
+ * ```ts
+ * const claimants = legacyAliasClaimants(id, row?.canonicalId, registryPaths);
+ * if (claimants.length > 1) return null; // ambiguous — resolves to no project
+ * ```
+ */
+export declare function legacyAliasClaimants(alias: string, owner: string | null | undefined, paths: Iterable<RecordedProjectPath>): string[];
+/**
+ * Walk up from `cwd` (or `process.cwd()`) to the nearest directory whose
+ * `.cleo/` DECLARES a project identity, and return that identity.
  *
- * The project-info file acts as the local sentinel and supplies `legacyUUID`.
- * The returned `projectId` is the derived canonical runtime ID, not the raw
- * project-local UUID stored in the file.
+ * Resolution order at each level (T12470 · ADR-094): the tracked
+ * `.cleo/project-id`, then `project-info.json`'s `projectId`. The returned
+ * `projectId` is that declared id — never a hash of the path — so the same
+ * project resolves to the same id from any absolute location, mount or device.
+ * `projectRoot` is realpath-canonicalized (bind-mounts, macOS `/private/var`).
  *
- * **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.
+ * A `.cleo/` that holds only the tracked id (no `project-info.json`) counts as
+ * a project root only when the directory is a git toplevel (has `.git`), so a
+ * monorepo subdirectory carrying a committed id does not shadow its parent.
  *
  * @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.
+ * @returns The resolved project identity, or `null` if no ancestor declares one.
  *
  * @example
  * ```typescript
  * const project = resolveProjectByCwd('/repo/packages/core');
- * // { projectId: 'a1b2c3d4e5f6', projectRoot: '/repo' }
+ * // { projectId: 'c78d09c3a8ee', projectRoot: '/repo', source: 'tracked' }
  *
  * const notFound = resolveProjectByCwd('/tmp/empty');
  * // null
@@ -206,7 +320,7 @@ export declare function legacyProjectId(repoPath: string): string;
  *
  * @public
  * @task T11008
- * @task T11023
+ * @task T12470
  */
 export declare function resolveProjectByCwd(cwd?: string): ResolvedProject | null;
 /**

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;AAeH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAwB7B;;;;;;;;;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,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0CxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsExE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"cleo-paths.d.ts","sourceRoot":"","sources":["../src/cleo-paths.ts"],"names":[],"mappings":"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"}

package/dist/cleo-paths.js

@@ -15,6 +15,7 @@ import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { createPlatformPathsResolver, } from './platform-paths.js';
+import { readPortableProjectId } from './portable-project-id.js';
 const TEMPLATES_SUBDIR = 'templates';
 /**
  * Returns the `node:sqlite` `DatabaseSync` constructor, loaded on first use.
@@ -54,6 +55,47 @@ export function getCleoPlatformPaths() {
 export function getCleoHome() {
     return cleoResolver.getPlatformPaths().data;
 }
+/**
+ * Get the absolute path to CLEO's global state directory.
+ *
+ * State is data CLEO keeps between runs but can rebuild or lose: warn-once
+ * caches, deprecation telemetry, cleanup audit logs.
+ *
+ * Linux:   `$XDG_STATE_HOME/cleo` (default `~/.local/state/cleo`)
+ * macOS:   `<getCleoHome()>/state` (`~/Library/Application Support/cleo/state`)
+ * Windows: `<getCleoHome()>/state` (`%LOCALAPPDATA%\cleo\Data\state`)
+ *
+ * macOS and Windows have no XDG state dir, so state lives beside the data it
+ * describes and follows a `CLEO_HOME` override.
+ *
+ * @returns Absolute path of the state directory. Not created.
+ *
+ * @public
+ * @task T12602
+ */
+export function getCleoStateDir() {
+    const paths = cleoResolver.getPlatformPaths();
+    if (process.platform === 'darwin' || process.platform === 'win32') {
+        return join(paths.data, 'state');
+    }
+    // env-paths maps `log` to $XDG_STATE_HOME/<app> on Linux.
+    return paths.log;
+}
+/**
+ * Path of the persisted stable device id — `<cleoHome>/device-id`.
+ *
+ * Core's `getStableDeviceId()` creates it; `@cleocode/worktree` reads it to
+ * decide whether a worktree lock holder's pid can be probed on this device
+ * (T12506). One path, two readers.
+ *
+ * @returns Absolute path of the device-id file.
+ *
+ * @public
+ * @task T12506
+ */
+export function resolveStableDeviceIdPath() {
+    return join(getCleoHome(), 'device-id');
+}
 /**
  * Get a cached system information snapshot scoped to CLEO.
  *
@@ -162,8 +204,61 @@ export function resolveLegacyCleoDir(override) {
         return override;
     return join(homedir(), '.cleo');
 }
+/**
+ * Read the `projectId` field from `<root>/.cleo/project-info.json`.
+ * Returns `undefined` when the file is absent, unparseable or has no id.
+ */
+function _readProjectInfoId(projectRoot) {
+    try {
+        const raw = readFileSync(join(projectRoot, '.cleo', 'project-info.json'), 'utf-8');
+        const data = JSON.parse(raw);
+        return typeof data.projectId === 'string' && data.projectId.length > 0
+            ? data.projectId
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Read the identity a project root DECLARES, in precedence order (T12470):
+ *
+ *   1. the tracked, write-once `.cleo/project-id` (ADR-094);
+ *   2. the `projectId` in `.cleo/project-info.json`.
+ *
+ * A malformed tracked file is skipped here (it is reported by
+ * `cleo doctor project-identity`) and never replaced by a derived value.
+ * Nothing about the path — its spelling, realpath, git root or remote — takes
+ * part: moving or re-cloning a project keeps its id.
+ *
+ * @param projectRoot - Directory containing `.cleo/`.
+ * @returns The declared identity, or `null` when the root declares none.
+ *
+ * @example
+ * ```ts
+ * readDeclaredProjectIdentity('/repo'); // { projectId: 'c78d09c3a8ee', source: 'tracked' }
+ * ```
+ *
+ * @public
+ * @task T12470
+ */
+export function readDeclaredProjectIdentity(projectRoot) {
+    const infoProjectId = _readProjectInfoId(projectRoot);
+    const tracked = readPortableProjectId(projectRoot);
+    if (tracked.status === 'valid') {
+        return {
+            projectId: tracked.projectId,
+            source: 'tracked',
+            ...(infoProjectId !== undefined && { infoProjectId }),
+        };
+    }
+    if (infoProjectId !== undefined) {
+        return { projectId: infoProjectId, source: 'project-info', infoProjectId };
+    }
+    return null;
+}
 // ---------------------------------------------------------------------------
-// Canonical project ID computation (T11023 — cross-mount divergence)
+// Path fingerprint (alias key only — never an identity, T12470)
 // ---------------------------------------------------------------------------
 /**
  * Synchronously find the git root for a given directory.
@@ -248,25 +343,22 @@ export function canonicalizePath(p) {
     }
 }
 /**
- * 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.
+ * Compute the path-derived fingerprint `sha256(gitRoot|name|remote)[0:12]`.
  *
- * This ensures `/mnt/projects/X` and `/workspace/X` (same git root,
- * same remote) produce the same ID.
+ * **Not an identity (T12470, supersedes the T9149/T11023 design).** A project
+ * is identified only by its declared id ({@link readDeclaredProjectIdentity}).
+ * This fingerprint survives solely as a LOOKUP KEY into
+ * `nexus_project_id_aliases`, so ids that older CLEO versions derived from a
+ * path keep resolving to the project that now owns them. Never return it as a
+ * project id and never mint a registry row from it.
  *
  * @param repoPath - Absolute path to the project root.
- * @returns The 12-hex-char canonical project ID.
+ * @returns The 12-hex-char path fingerprint.
  *
- * @task T11023
- * @task T9149
+ * @public
+ * @task T12470
  */
-export function computeCanonicalProjectId(repoPath) {
+export function computePathFingerprintId(repoPath) {
     const realRepoPath = canonicalizePath(repoPath);
     const gitRoot = _findGitRootSync(realRepoPath);
     const effectiveRoot = gitRoot ?? realRepoPath;
@@ -275,6 +367,14 @@ export function computeCanonicalProjectId(repoPath) {
     const fingerprint = [effectiveRoot, projectName ?? '', remoteUrl ?? ''].join('|');
     return createHash('sha256').update(fingerprint).digest('hex').substring(0, 12);
 }
+/**
+ * Former name of {@link computePathFingerprintId}.
+ *
+ * @deprecated T12470 — the value is a path fingerprint (alias key), not a
+ * project id. Use {@link readDeclaredProjectIdentity} for identity and
+ * {@link computePathFingerprintId} for alias lookups.
+ */
+export const computeCanonicalProjectId = computePathFingerprintId;
 /**
  * Compute the legacy base64url(path) ID for a given path.
  *
@@ -286,28 +386,56 @@ 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.
+ * Every project that can claim an alias key (T12589): the alias row's owner
+ * plus each project with a recorded path whose {@link legacyProjectId} is the
+ * key.
+ *
+ * The legacy id encodes only the first 24 bytes of a path, so every project
+ * under a long shared prefix (`/Users/<name>/projects/…`) derives the SAME
+ * key. A key with more than one claimant is ambiguous: it names no project,
+ * and a resolver must refuse it rather than return whichever project happened
+ * to record it first. A non-legacy key (full-path fingerprint, UUID) is never
+ * derived from a path by this function, so only its owner claims it.
+ *
+ * @param alias - The alias key being resolved or recorded.
+ * @param owner - `canonical_id` of the alias row for `alias`, when one exists.
+ * @param paths - Every recorded project path to check.
+ * @returns Distinct claimant ids, sorted; ambiguous when longer than one.
+ * @example
+ * ```ts
+ * const claimants = legacyAliasClaimants(id, row?.canonicalId, registryPaths);
+ * if (claimants.length > 1) return null; // ambiguous — resolves to no project
+ * ```
+ */
+export function legacyAliasClaimants(alias, owner, paths) {
+    const claimants = new Set(owner ? [owner] : []);
+    for (const { projectId, path } of paths)
+        if (path && legacyProjectId(path) === alias)
+            claimants.add(projectId);
+    return [...claimants].sort();
+}
+/**
+ * Walk up from `cwd` (or `process.cwd()`) to the nearest directory whose
+ * `.cleo/` DECLARES a project identity, and return that identity.
  *
- * The project-info file acts as the local sentinel and supplies `legacyUUID`.
- * The returned `projectId` is the derived canonical runtime ID, not the raw
- * project-local UUID stored in the file.
+ * Resolution order at each level (T12470 · ADR-094): the tracked
+ * `.cleo/project-id`, then `project-info.json`'s `projectId`. The returned
+ * `projectId` is that declared id — never a hash of the path — so the same
+ * project resolves to the same id from any absolute location, mount or device.
+ * `projectRoot` is realpath-canonicalized (bind-mounts, macOS `/private/var`).
  *
- * **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.
+ * A `.cleo/` that holds only the tracked id (no `project-info.json`) counts as
+ * a project root only when the directory is a git toplevel (has `.git`), so a
+ * monorepo subdirectory carrying a committed id does not shadow its parent.
  *
  * @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.
+ * @returns The resolved project identity, or `null` if no ancestor declares one.
  *
  * @example
  * ```typescript
  * const project = resolveProjectByCwd('/repo/packages/core');
- * // { projectId: 'a1b2c3d4e5f6', projectRoot: '/repo' }
+ * // { projectId: 'c78d09c3a8ee', projectRoot: '/repo', source: 'tracked' }
  *
  * const notFound = resolveProjectByCwd('/tmp/empty');
  * // null
@@ -315,38 +443,29 @@ export function legacyProjectId(repoPath) {
  *
  * @public
  * @task T11008
- * @task T11023
+ * @task T12470
  */
 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 the canonicalizePath SSoT to
-                    // handle cross-mount + cross-OS divergence — same repo at
-                    // /mnt/projects/X and /workspace/X (and macOS /var vs /private/var)
-                    // resolves to the same real path (AC2, AC3). Falls back to the
-                    // lexical path when `current` no longer exists on disk.
-                    const realRoot = canonicalizePath(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.
+        if (existsSync(join(current, '.cleo'))) {
+            const declared = readDeclaredProjectIdentity(current);
+            // A `.cleo/` holding ONLY a committed project-id (no project-info.json)
+            // is a project root only at a git toplevel. Otherwise a monorepo
+            // subdirectory that carries a committed id would shadow its parent.
+            const trackedOnly = declared?.source === 'tracked' && declared.infoProjectId === undefined;
+            if (declared !== null && (!trackedOnly || existsSync(join(current, '.git')))) {
+                return {
+                    projectId: declared.projectId,
+                    projectRoot: canonicalizePath(current),
+                    ...(declared.infoProjectId !== undefined && { legacyUUID: declared.infoProjectId }),
+                    source: declared.source,
+                };
             }
+            // A `.cleo/` that declares nothing (corrupt / id-less project-info.json),
+            // or only a tracked id below a git toplevel, keeps walking — a higher
+            // ancestor may declare one.
         }
         const parent = dirname(current);
         if (parent === current)
@@ -425,6 +544,16 @@ export function resolveCanonicalCleoDir(projectId) {
             if (aliasRow &&
                 typeof aliasRow.canonical_id === 'string' &&
                 aliasRow.canonical_id.length > 0) {
+                // T12589: a truncated legacy key shared by several projects names none.
+                const recorded = db
+                    .prepare('SELECT project_id, project_path FROM nexus_project_registry')
+                    .all()
+                    .map((row) => ({
+                    projectId: String(row['project_id']),
+                    path: String(row['project_path']),
+                }));
+                if (legacyAliasClaimants(projectId, aliasRow.canonical_id, recorded).length > 1)
+                    return null;
                 // Resolved a legacy alias — look up the canonical ID.
                 const canonicalRow = directStmt.get(aliasRow.canonical_id);
                 if (canonicalRow &&

package/dist/cleo-paths.js.map

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