@cleocode/core 2026.9.20 → 2026.9.21

package/dist/sessions/session-manifest-mirror.js

@@ -45,6 +45,7 @@
  * @see ../store/schema/cleo-global/session-manifest.ts — the table decl
  * @see ./index.ts — startSession/endSession call sites
  */
+import { readDeclaredProjectIdentity } from '@cleocode/paths';
 import { eq } from 'drizzle-orm';
 import { getLogger } from '../logger.js';
 import { openDualScopeDb, resolveDualScopeDbPath, } from '../store/dual-scope-db.js';
@@ -108,22 +109,14 @@ function toManifestRow(session, projectId, projectPath) {
     };
 }
 /**
- * Resolve the CANONICAL `nexus_project_registry.project_id` (12-hex) for a project
- * root, best-effort. Returns `null` when the project is not resolvable (e.g. not a
- * git repo / no canonical id) — the manifest row then carries a NULL `project_id`.
- *
- * Lazy `import()` of the nexus identity helper keeps this module's import graph
- * light and avoids a cycle (the nexus layer transitively imports the store).
+ * Resolve the project's `nexus_project_registry.project_id` — the id the
+ * project DECLARES (tracked `.cleo/project-id`, then `project-info.json`), the
+ * same key the registry rows are stored under (T12469 · T12470). Returns
+ * `null` when the root declares no identity; the manifest row then carries a
+ * NULL `project_id`. A path fingerprint is never substituted.
  */
-async function resolveCanonicalProjectId(projectRoot) {
-    try {
-        const { canonicalProjectId } = await import('../nexus/identity.js');
-        const result = await canonicalProjectId(projectRoot);
-        return result.id ?? null;
-    }
-    catch {
-        return null;
-    }
+function resolveCanonicalProjectId(projectRoot) {
+    return readDeclaredProjectIdentity(projectRoot)?.projectId ?? null;
 }
 /**
  * Write (upsert) a single `session_manifest` mirror row through the GLOBAL handle,
@@ -175,7 +168,7 @@ async function upsertManifestRow(handle, row) {
 export async function mirrorSessionToManifest(projectRoot, session) {
     try {
         const handle = await ensureGlobalSignaldockDb();
-        const projectId = await resolveCanonicalProjectId(projectRoot);
+        const projectId = resolveCanonicalProjectId(projectRoot);
         const row = toManifestRow(session, projectId, projectRoot);
         await upsertManifestRow(handle, row);
     }
@@ -209,7 +202,7 @@ export async function reconcileSessionManifestOnStart(projectRoot, sessionId) {
             return;
         }
         const handle = await ensureGlobalSignaldockDb();
-        const projectId = await resolveCanonicalProjectId(projectRoot);
+        const projectId = resolveCanonicalProjectId(projectRoot);
         const row = toManifestRow(authoritative, projectId, projectRoot);
         await upsertManifestRow(handle, row);
     }

package/dist/sessions/session-manifest-mirror.js.map

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

package/dist/sessions/session-switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-switch.d.ts","sourceRoot":"","sources":["../../src/sessions/session-switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAMlE;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoD5F"}
+{"version":3,"file":"session-switch.d.ts","sourceRoot":"","sources":["../../src/sessions/session-switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAOlE;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqD5F"}

package/dist/sessions/session-switch.js

@@ -7,6 +7,7 @@
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
+import { resolveBoundSession } from '../store/session-store.js';
 import { readFocusState, writeFocusState } from './focus-state-store.js';
 /**
  * Switch to a different session.
@@ -28,9 +29,10 @@ export async function switchSession(projectRoot, sessionId) {
     // Suspend the CALLER's current session (if different from target). T11640 —
     // identity resolution (connection-handle → CLEO_SESSION_ID → most-recent-
     // active) so a switch suspends the agent's OWN session, not whoever wrote the
-    // DB last.
-    const currentActive = await accessor.resolveCurrentSession();
-    if (currentActive && currentActive.id !== sessionId) {
+    // DB last. T12500 — bound tiers only: an unbound caller suspends NOTHING
+    // rather than the newest active row, which is another agent's session.
+    const currentActive = (await resolveBoundSession(projectRoot))?.session ?? null;
+    if (currentActive && currentActive.status === 'active' && currentActive.id !== sessionId) {
         currentActive.status = 'suspended';
         Object.assign(currentActive, { suspendedAt: now });
         if (currentActive.stats) {

package/dist/sessions/session-switch.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-switch.js","sourceRoot":"","sources":["../../src/sessions/session-switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,SAAiB;IACxE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAE/C,sBAAsB;IACtB,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAE/D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,YAAY,SAAS,aAAa,CAAC,CAAC;IACtF,CAAC;IAED,IAAK,aAAa,CAAC,MAAiB,KAAK,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,iBAAiB,EAC1B,YAAY,SAAS,yCAAyC,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,WAAW;IACX,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,qBAAqB,EAAE,CAAC;IAC7D,IAAI,aAAa,IAAI,aAAa,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACpD,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACnD,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,aAAa,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,QAAQ,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,OAAO,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,WAAW,GAAG,CAAC,aAAa,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAEjE,6EAA6E;IAC7E,kDAAkD;IAClD,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAK,EAAoB,CAAC;QACnF,KAAK,CAAC,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClD,MAAM,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAElD,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"session-switch.js","sourceRoot":"","sources":["../../src/sessions/session-switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,SAAiB;IACxE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAE/C,sBAAsB;IACtB,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAE/D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,YAAY,SAAS,aAAa,CAAC,CAAC;IACtF,CAAC;IAED,IAAK,aAAa,CAAC,MAAiB,KAAK,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,iBAAiB,EAC1B,YAAY,SAAS,yCAAyC,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,aAAa,GAAG,CAAC,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;IAChF,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,QAAQ,IAAI,aAAa,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACzF,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACnD,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,aAAa,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,QAAQ,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,OAAO,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,WAAW,GAAG,CAAC,aAAa,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAEjE,6EAA6E;IAC7E,kDAAkD;IAClD,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,IAAK,EAAoB,CAAC;QACnF,KAAK,CAAC,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClD,MAAM,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAElD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/sessions/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/sessions/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhE,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,wDAAwD;IACxD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,mDAAmD;IACnD,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,EAC9B,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,eAAe,CAAC,CAsG1B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,cAAmB,EAC5B,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,OAAO,CAAC,CAqFlB"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/sessions/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhE,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,wDAAwD;IACxD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,mDAAmD;IACnD,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,EAC9B,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,eAAe,CAAC,CAsG1B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,cAAmB,EAC5B,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,OAAO,CAAC,CAqFlB"}

package/dist/sessions/snapshot.js

@@ -17,6 +17,7 @@
 import { ExitCode } from '@cleocode/contracts';
 import { CleoError } from '../errors.js';
 import { getTaskAccessor } from '../store/data-accessor.js';
+import { requireBoundSession } from '../store/session-store.js';
 import { getDecisionLog } from './decisions.js';
 import { computeHandoff } from './handoff.js';
 // ============================================================================
@@ -49,10 +50,10 @@ export async function serializeSession(projectRoot, options = {}, accessor) {
         session = sessions.find((s) => s.id === options.sessionId);
     }
     else {
-        // Find the active session
-        session = sessions
-            .filter((s) => s.status === 'active')
-            .sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime())[0];
+        // T12500: the CALLER's bound session — never the newest active row,
+        // which from an unbound terminal is another agent's session.
+        const bound = await requireBoundSession('serialize the session', projectRoot);
+        session = bound ? sessions.find((s) => s.id === bound.id) : undefined;
     }
     if (!session) {
         throw new CleoError(ExitCode.SESSION_NOT_FOUND, options.sessionId

package/dist/sessions/snapshot.js.map

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

package/dist/sessions/terminal-identity.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Terminal / harness identity keys for session binding (T12499 · Epic T12497).
+ *
+ * A CLEO session id names a row; it says nothing about WHICH terminal or agent
+ * harness is calling. Before T12499 an unbound terminal fell through to the
+ * newest active session row, so one agent's `cleo` call resolved another
+ * agent's session. This module answers the missing question — "which terminal
+ * am I?" — as an ordered list of opaque binding keys that `session start`
+ * persists (terminal key → session id) and that resolution reads back before
+ * any newest-active fallback.
+ *
+ * ## The key map is DATA
+ *
+ * {@link TERMINAL_KEY_SOURCES} is the single table of environment variables a
+ * provider harness or terminal emulator exports with a per-session / per-pane
+ * value. Adding a harness is one row, never a new `process.env[...]` check at a
+ * call site. Order is precedence: the most specific identity first — an agent
+ * harness session beats the multiplexer pane it runs in, which beats the
+ * terminal tab that hosts the multiplexer.
+ *
+ * These values are NOT CLEO session ids (contrast `SESSION_ENV_KEY_PRECEDENCE`
+ * in `session-id.ts`, whose values ARE CLEO ids). They are opaque identities
+ * that only mean something through a persisted binding.
+ *
+ * ## ppid-chain fallback
+ *
+ * When no environment key is present, the identity falls back to the nearest
+ * ancestor process that is not a launcher (node, pnpm, npx, mise, …) — in
+ * practice the interactive shell of the terminal tab. The key carries the
+ * process start time, so a recycled pid never matches a stale binding. The walk
+ * is bounded ({@link PPID_CHAIN_MAX_DEPTH}) and never climbs past the first
+ * non-launcher ancestor, because anything above the shell (the terminal
+ * emulator, tmux server, launchd) is shared by every tab and would re-create the
+ * cross-terminal bleed this module exists to remove.
+ *
+ * @module
+ * @task T12499
+ * @epic T12497
+ */
+import { PS_STABLE_ENV } from '@cleocode/contracts';
+/** Where a terminal key comes from. */
+export type TerminalKeyKind = 'provider' | 'multiplexer' | 'terminal' | 'ppid';
+/**
+ * One row of the provider/terminal key map: an environment variable whose value
+ * identifies a single harness session, multiplexer pane or terminal tab.
+ */
+export interface TerminalKeySource {
+    /** Environment variable carrying the identity value. */
+    readonly envVar: string;
+    /** Category of identity (drives precedence documentation only). */
+    readonly kind: Exclude<TerminalKeyKind, 'ppid'>;
+    /** Harness / terminal that exports the variable. */
+    readonly origin: string;
+    /**
+     * Optional companion variable that disambiguates the value. `TMUX_PANE` is
+     * `%0` on every tmux server, so it is qualified by `TMUX` (socket path, server
+     * pid, session index) to stay unique across servers.
+     */
+    readonly qualifierEnvVar?: string;
+}
+/**
+ * The provider/terminal key map, in precedence order (T12499).
+ *
+ * Provider rows cover agent harnesses that export a per-session id to the shell
+ * commands they run. Only variables whose export is documented upstream are
+ * listed: `CLAUDE_CODE_SESSION_ID` (Claude Code), `CODEX_THREAD_ID` (Codex CLI,
+ * `codex-rs/core/src/exec_env.rs`) and `GEMINI_SESSION_ID` (Gemini CLI; its docs
+ * name it for the hook environment). The CAAMP provider definitions carry no
+ * session-id variable for any provider, and none is known for Kimi, so none is
+ * invented here; add a row once one is confirmed.
+ */
+export declare const TERMINAL_KEY_SOURCES: readonly TerminalKeySource[];
+/**
+ * Launcher processes skipped by the ppid-chain walk: they sit between the shell
+ * and the `cleo` process (`pnpm exec`, a mise shim, `npx`) and carry no terminal
+ * identity of their own.
+ */
+export declare const PPID_CHAIN_LAUNCHERS: ReadonlySet<string>;
+/**
+ * Environment overrides for the `ps` probe (T12500): UTC and the C locale make
+ * the `lstart` start time — part of every ppid-chain key — independent of the
+ * caller's `TZ` / `LANG`. Defined in `@cleocode/contracts` so the worktree
+ * lock (T12506) renders start times identically.
+ */
+export { PS_STABLE_ENV };
+/** Maximum number of ancestors the ppid-chain walk inspects. */
+export declare const PPID_CHAIN_MAX_DEPTH: 4;
+/** One resolved identity key for the calling terminal. */
+export interface TerminalKey {
+    /** Opaque, stable binding key (`env:<VAR>=<value>` or `ppid:<pid>@<start>`). */
+    readonly key: string;
+    /** Environment variable name, or `'ppid'` for the process-chain fallback. */
+    readonly source: string;
+    /** Identity category. */
+    readonly kind: TerminalKeyKind;
+}
+/** One ancestor process as read from the OS process table. */
+export interface ProcessAncestor {
+    /** Process id. */
+    readonly pid: number;
+    /** Parent process id. */
+    readonly ppid: number;
+    /** Process start time as reported by the OS (disambiguates recycled pids). */
+    readonly startedAt: string;
+    /** Executable base name (e.g. `zsh`, `node`). */
+    readonly command: string;
+}
+/** Reads one process-table entry; returns `null` when the pid is unknown. */
+export type ProcessLookup = (pid: number) => ProcessAncestor | null;
+/** Inputs for {@link resolveTerminalKeys}; every field defaults to the live process. */
+export interface ResolveTerminalKeysOptions {
+    /** Environment to read (defaults to `process.env`). */
+    readonly env?: NodeJS.ProcessEnv;
+    /** Parent pid to start the ppid-chain walk from (defaults to `process.ppid`). */
+    readonly ppid?: number;
+    /** Process-table reader (defaults to {@link readProcessEntry}). */
+    readonly lookupProcess?: ProcessLookup;
+}
+/**
+ * Read one entry from the OS process table via `ps` (POSIX only).
+ *
+ * Returns `null` on Windows, for an unknown pid, or when `ps` fails — the
+ * ppid-chain fallback is best-effort and must never fail a command.
+ *
+ * @param pid - Process id to inspect.
+ * @returns The process entry, or `null`.
+ */
+export declare function readProcessEntry(pid: number): ProcessAncestor | null;
+/** Interactive / script shells skipped by {@link resolveOwnerProcess}, beyond the launchers. */
+export declare const OWNER_PROCESS_SHELLS: ReadonlySet<string>;
+/** Maximum number of ancestors {@link resolveOwnerProcess} inspects. */
+export declare const OWNER_PROCESS_MAX_DEPTH: 8;
+/**
+ * Resolve the long-lived process that OWNS the calling `cleo` invocation
+ * (T12506): the nearest ancestor that is neither a launcher
+ * ({@link PPID_CHAIN_LAUNCHERS}) nor a shell ({@link OWNER_PROCESS_SHELLS}).
+ *
+ * Agent harnesses run each tool call in a fresh `sh -c`, so the parent shell
+ * dies the moment `cleo orchestrate spawn` returns; the harness above it
+ * (e.g. `claude`, `codex`) lives as long as the agents it spawned. The worktree
+ * lock records this process so its liveness keeps the lock held. When every
+ * inspected ancestor is skippable, the last one read is returned.
+ *
+ * @param ppid - Parent pid to start from (defaults to `process.ppid`).
+ * @param lookupProcess - Process-table reader (defaults to {@link readProcessEntry}).
+ * @returns The owner process, or `null` when the chain cannot be read.
+ */
+export declare function resolveOwnerProcess(ppid?: number, lookupProcess?: ProcessLookup): ProcessAncestor | null;
+/**
+ * Resolve the calling terminal's identity keys, most specific first (T12499).
+ *
+ * Every {@link TERMINAL_KEY_SOURCES} row whose variable is set contributes one
+ * key. Only when NO row matches does the ppid-chain fallback run, so the common
+ * case (an agent harness or a mainstream terminal) never spawns `ps`.
+ *
+ * Synchronous and database-free; binding persistence and lookup live in
+ * `store/session-binding-store.ts`.
+ *
+ * @param options - Environment / process-table overrides (tests inject these).
+ * @returns Ordered identity keys; empty when nothing identifies the terminal.
+ *
+ * @example
+ * ```ts
+ * resolveTerminalKeys({ env: { TMUX: '/tmp/tmux-501/default,123,0', TMUX_PANE: '%3' } });
+ * // → [{ key: 'env:TMUX_PANE=/tmp/tmux-501/default,123,0|%3', source: 'TMUX_PANE', kind: 'multiplexer' }]
+ * ```
+ */
+export declare function resolveTerminalKeys(options?: ResolveTerminalKeysOptions): TerminalKey[];
+//# sourceMappingURL=terminal-identity.d.ts.map

package/dist/sessions/terminal-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-identity.d.ts","sourceRoot":"","sources":["../../src/sessions/terminal-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EA4B5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAcnD,CAAC;AAEH;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,CAAC;AAEpE,wFAAwF;AACxF,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAWD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA6BpE;AAsBD,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CASnD,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,MAAqB,EAC3B,aAAa,GAAE,aAAgC,GAC9C,eAAe,GAAG,IAAI,CAaxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,WAAW,EAAE,CA4B3F"}

package/dist/sessions/terminal-identity.js

@@ -0,0 +1,273 @@
+/**
+ * Terminal / harness identity keys for session binding (T12499 · Epic T12497).
+ *
+ * A CLEO session id names a row; it says nothing about WHICH terminal or agent
+ * harness is calling. Before T12499 an unbound terminal fell through to the
+ * newest active session row, so one agent's `cleo` call resolved another
+ * agent's session. This module answers the missing question — "which terminal
+ * am I?" — as an ordered list of opaque binding keys that `session start`
+ * persists (terminal key → session id) and that resolution reads back before
+ * any newest-active fallback.
+ *
+ * ## The key map is DATA
+ *
+ * {@link TERMINAL_KEY_SOURCES} is the single table of environment variables a
+ * provider harness or terminal emulator exports with a per-session / per-pane
+ * value. Adding a harness is one row, never a new `process.env[...]` check at a
+ * call site. Order is precedence: the most specific identity first — an agent
+ * harness session beats the multiplexer pane it runs in, which beats the
+ * terminal tab that hosts the multiplexer.
+ *
+ * These values are NOT CLEO session ids (contrast `SESSION_ENV_KEY_PRECEDENCE`
+ * in `session-id.ts`, whose values ARE CLEO ids). They are opaque identities
+ * that only mean something through a persisted binding.
+ *
+ * ## ppid-chain fallback
+ *
+ * When no environment key is present, the identity falls back to the nearest
+ * ancestor process that is not a launcher (node, pnpm, npx, mise, …) — in
+ * practice the interactive shell of the terminal tab. The key carries the
+ * process start time, so a recycled pid never matches a stale binding. The walk
+ * is bounded ({@link PPID_CHAIN_MAX_DEPTH}) and never climbs past the first
+ * non-launcher ancestor, because anything above the shell (the terminal
+ * emulator, tmux server, launchd) is shared by every tab and would re-create the
+ * cross-terminal bleed this module exists to remove.
+ *
+ * @module
+ * @task T12499
+ * @epic T12497
+ */
+import { execFileSync } from 'node:child_process';
+import { PS_STABLE_ENV } from '@cleocode/contracts';
+/**
+ * The provider/terminal key map, in precedence order (T12499).
+ *
+ * Provider rows cover agent harnesses that export a per-session id to the shell
+ * commands they run. Only variables whose export is documented upstream are
+ * listed: `CLAUDE_CODE_SESSION_ID` (Claude Code), `CODEX_THREAD_ID` (Codex CLI,
+ * `codex-rs/core/src/exec_env.rs`) and `GEMINI_SESSION_ID` (Gemini CLI; its docs
+ * name it for the hook environment). The CAAMP provider definitions carry no
+ * session-id variable for any provider, and none is known for Kimi, so none is
+ * invented here; add a row once one is confirmed.
+ */
+export const TERMINAL_KEY_SOURCES = [
+    { envVar: 'CLAUDE_CODE_SESSION_ID', kind: 'provider', origin: 'claude-code' },
+    { envVar: 'CODEX_THREAD_ID', kind: 'provider', origin: 'codex' },
+    { envVar: 'GEMINI_SESSION_ID', kind: 'provider', origin: 'gemini-cli' },
+    { envVar: 'TMUX_PANE', kind: 'multiplexer', origin: 'tmux', qualifierEnvVar: 'TMUX' },
+    {
+        envVar: 'ZELLIJ_PANE_ID',
+        kind: 'multiplexer',
+        origin: 'zellij',
+        qualifierEnvVar: 'ZELLIJ_SESSION_NAME',
+    },
+    {
+        envVar: 'WEZTERM_PANE',
+        kind: 'multiplexer',
+        origin: 'wezterm',
+        qualifierEnvVar: 'WEZTERM_UNIX_SOCKET',
+    },
+    { envVar: 'WT_SESSION', kind: 'terminal', origin: 'windows-terminal' },
+    { envVar: 'ITERM_SESSION_ID', kind: 'terminal', origin: 'iterm2' },
+    { envVar: 'TERM_SESSION_ID', kind: 'terminal', origin: 'macos-terminal' },
+    { envVar: 'KITTY_WINDOW_ID', kind: 'terminal', origin: 'kitty', qualifierEnvVar: 'KITTY_PID' },
+    { envVar: 'GNOME_TERMINAL_SCREEN', kind: 'terminal', origin: 'gnome-terminal' },
+    {
+        envVar: 'KONSOLE_DBUS_SESSION',
+        kind: 'terminal',
+        origin: 'konsole',
+        qualifierEnvVar: 'KONSOLE_DBUS_SERVICE',
+    },
+];
+/**
+ * Launcher processes skipped by the ppid-chain walk: they sit between the shell
+ * and the `cleo` process (`pnpm exec`, a mise shim, `npx`) and carry no terminal
+ * identity of their own.
+ */
+export const PPID_CHAIN_LAUNCHERS = new Set([
+    'node',
+    'npm',
+    'npx',
+    'pnpm',
+    'pnpx',
+    'yarn',
+    'bun',
+    'bunx',
+    'tsx',
+    'corepack',
+    'mise',
+    'env',
+    'cleo',
+]);
+/**
+ * Environment overrides for the `ps` probe (T12500): UTC and the C locale make
+ * the `lstart` start time — part of every ppid-chain key — independent of the
+ * caller's `TZ` / `LANG`. Defined in `@cleocode/contracts` so the worktree
+ * lock (T12506) renders start times identically.
+ */
+export { PS_STABLE_ENV };
+/** Maximum number of ancestors the ppid-chain walk inspects. */
+export const PPID_CHAIN_MAX_DEPTH = 4;
+/** Non-empty trimmed value of `name` in `env`, or `null`. */
+function envValue(env, name) {
+    if (!name)
+        return null;
+    const raw = env[name];
+    if (raw === undefined)
+        return null;
+    const trimmed = raw.trim();
+    return trimmed === '' ? null : trimmed;
+}
+/**
+ * Read one entry from the OS process table via `ps` (POSIX only).
+ *
+ * Returns `null` on Windows, for an unknown pid, or when `ps` fails — the
+ * ppid-chain fallback is best-effort and must never fail a command.
+ *
+ * @param pid - Process id to inspect.
+ * @returns The process entry, or `null`.
+ */
+export function readProcessEntry(pid) {
+    if (process.platform === 'win32' || !Number.isInteger(pid) || pid <= 1)
+        return null;
+    try {
+        const out = execFileSync('ps', ['-o', 'ppid=', '-o', 'lstart=', '-o', 'comm=', '-p', String(pid)], {
+            encoding: 'utf8',
+            timeout: 1000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+            // T12500: `lstart` is rendered in the caller's time zone and locale, so
+            // two shells with different TZ/LANG would derive different keys for
+            // the same process and silently lose their binding. Pin both.
+            env: { ...process.env, ...PS_STABLE_ENV },
+        }).trim();
+        // `lstart` is five whitespace-separated fields: `Sat Sep 27 22:07:02 2026`.
+        const match = /^(\d+)\s+(\S+\s+\S+\s+\S+\s+\S+\s+\S+)\s+(.+)$/.exec(out);
+        if (!match)
+            return null;
+        const command = (match[3] ?? '').trim();
+        return {
+            pid,
+            ppid: Number(match[1]),
+            startedAt: (match[2] ?? '').replace(/\s+/g, ' '),
+            command: command.slice(command.lastIndexOf('/') + 1).replace(/^-/, ''),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the ppid-chain fallback key: the nearest non-launcher ancestor.
+ *
+ * @param ppid - Parent pid to start from.
+ * @param lookupProcess - Process-table reader.
+ * @returns The fallback key, or `null` when the chain cannot be read.
+ */
+function resolvePpidKey(ppid, lookupProcess) {
+    let pid = ppid;
+    for (let depth = 0; depth < PPID_CHAIN_MAX_DEPTH && pid > 1; depth++) {
+        const entry = lookupProcess(pid);
+        if (!entry)
+            return null;
+        if (!PPID_CHAIN_LAUNCHERS.has(entry.command)) {
+            return { key: `ppid:${entry.pid}@${entry.startedAt}`, source: 'ppid', kind: 'ppid' };
+        }
+        pid = entry.ppid;
+    }
+    return null;
+}
+/** Interactive / script shells skipped by {@link resolveOwnerProcess}, beyond the launchers. */
+export const OWNER_PROCESS_SHELLS = new Set([
+    'sh',
+    'bash',
+    'zsh',
+    'dash',
+    'fish',
+    'ksh',
+    'tcsh',
+    'csh',
+]);
+/** Maximum number of ancestors {@link resolveOwnerProcess} inspects. */
+export const OWNER_PROCESS_MAX_DEPTH = 8;
+/**
+ * Resolve the long-lived process that OWNS the calling `cleo` invocation
+ * (T12506): the nearest ancestor that is neither a launcher
+ * ({@link PPID_CHAIN_LAUNCHERS}) nor a shell ({@link OWNER_PROCESS_SHELLS}).
+ *
+ * Agent harnesses run each tool call in a fresh `sh -c`, so the parent shell
+ * dies the moment `cleo orchestrate spawn` returns; the harness above it
+ * (e.g. `claude`, `codex`) lives as long as the agents it spawned. The worktree
+ * lock records this process so its liveness keeps the lock held. When every
+ * inspected ancestor is skippable, the last one read is returned.
+ *
+ * @param ppid - Parent pid to start from (defaults to `process.ppid`).
+ * @param lookupProcess - Process-table reader (defaults to {@link readProcessEntry}).
+ * @returns The owner process, or `null` when the chain cannot be read.
+ */
+export function resolveOwnerProcess(ppid = process.ppid, lookupProcess = readProcessEntry) {
+    let pid = ppid;
+    let last = null;
+    for (let depth = 0; depth < OWNER_PROCESS_MAX_DEPTH && pid > 1; depth++) {
+        const entry = lookupProcess(pid);
+        if (!entry)
+            break;
+        last = entry;
+        if (!PPID_CHAIN_LAUNCHERS.has(entry.command) && !OWNER_PROCESS_SHELLS.has(entry.command)) {
+            return entry;
+        }
+        pid = entry.ppid;
+    }
+    return last;
+}
+/**
+ * Resolve the calling terminal's identity keys, most specific first (T12499).
+ *
+ * Every {@link TERMINAL_KEY_SOURCES} row whose variable is set contributes one
+ * key. Only when NO row matches does the ppid-chain fallback run, so the common
+ * case (an agent harness or a mainstream terminal) never spawns `ps`.
+ *
+ * Synchronous and database-free; binding persistence and lookup live in
+ * `store/session-binding-store.ts`.
+ *
+ * @param options - Environment / process-table overrides (tests inject these).
+ * @returns Ordered identity keys; empty when nothing identifies the terminal.
+ *
+ * @example
+ * ```ts
+ * resolveTerminalKeys({ env: { TMUX: '/tmp/tmux-501/default,123,0', TMUX_PANE: '%3' } });
+ * // → [{ key: 'env:TMUX_PANE=/tmp/tmux-501/default,123,0|%3', source: 'TMUX_PANE', kind: 'multiplexer' }]
+ * ```
+ */
+export function resolveTerminalKeys(options = {}) {
+    const env = options.env ?? process.env;
+    const keys = [];
+    for (const source of TERMINAL_KEY_SOURCES) {
+        const value = envValue(env, source.envVar);
+        if (value === null)
+            continue;
+        const qualifier = envValue(env, source.qualifierEnvVar);
+        keys.push({
+            key: `env:${source.envVar}=${qualifier === null ? value : `${qualifier}|${value}`}`,
+            source: source.envVar,
+            kind: source.kind,
+        });
+    }
+    if (keys.length > 0)
+        return keys;
+    const live = options.ppid === undefined && options.lookupProcess === undefined;
+    let ppidKey;
+    if (live) {
+        // The live process's ancestry cannot change, so `ps` runs at most once per
+        // process even though identity resolution runs on every dispatch.
+        if (livePpidKey === undefined)
+            livePpidKey = resolvePpidKey(process.ppid, readProcessEntry);
+        ppidKey = livePpidKey;
+    }
+    else {
+        ppidKey = resolvePpidKey(options.ppid ?? process.ppid, options.lookupProcess ?? readProcessEntry);
+    }
+    return ppidKey ? [ppidKey] : [];
+}
+/** Memoised ppid-chain key of the live process (`undefined` = not yet read). */
+let livePpidKey;
+//# sourceMappingURL=terminal-identity.js.map