@cleocode/core 2026.9.20 → 2026.9.22

package/dist/sessions/session-end-snapshot.js

@@ -0,0 +1,446 @@
+/**
+ * Session-end SQLite snapshot — requested after the session is persisted,
+ * taken in a detached child process.
+ *
+ * ADR-013 / T5158: `.cleo/cleo.db` is not tracked in git, so ending a session
+ * writes a point-in-time snapshot to `.cleo/backups/sqlite/`. Both session-end
+ * paths call {@link requestSessionEndSnapshot} as their LAST step, after the
+ * session row is written as ended:
+ *
+ *   - the CLI / dispatch path (`cleo session end`, the Claude Code Stop hook,
+ *     orchestrate handoff, safestop, GC): `session/engine-ops.ts` `sessionEnd`;
+ *   - the SDK path: `sessions/index.ts` `endSession`.
+ *
+ * The request spawns a detached, unref'd worker and returns — the command that
+ * ended the session never waits for a VACUUM. At most one worker is QUEUED per
+ * project: a per-project marker ({@link SESSION_END_WORKER_MARKER}) exists from
+ * spawn until the worker holds the gate lock. A request that finds a live
+ * marker spawns nothing ("coalesced", logged): the queued worker drops the
+ * marker only once it holds the lock, and then snapshots UNCONDITIONALLY, so
+ * its snapshot contains every write made before any request that coalesced
+ * onto it. A generation claimed by some other snapshot while the worker waited
+ * proves nothing about those requests, so the worker never counts itself
+ * covered (T12508 round 5). A burst therefore keeps at most two workers alive
+ * (one running, one queued) and produces at most two snapshots.
+ *
+ * The worker appends its outcome as one JSON line to
+ * `.cleo/logs/session-end-snapshot.log`; coalesced requests are logged there
+ * too.
+ *
+ * `CLEO_SESSION_END_SNAPSHOT=inline` runs the snapshot in-process instead
+ * (bounded lock wait, generation coverage), as does a failure to spawn the
+ * worker. Under vitest the default is `inline`, so unit tests do not leave
+ * detached processes behind.
+ *
+ * @task T12508
+ */
+import { execFileSync, spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, closeSync, linkSync, mkdirSync, openSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, writeSync, } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { getLogger } from '../logger.js';
+import { getCleoDir } from '../paths.js';
+import { describeSnapshotMiss, SESSION_END_LOCK_WAIT_RETRIES, } from '../store/snapshot-gate.js';
+/** Package specifier of the detached worker's compiled entry. */
+const WORKER_SPECIFIER = '@cleocode/core/sessions/session-end-snapshot-entry.js';
+/** Basename of the per-project "a worker is queued" marker in the backup dir. */
+export const SESSION_END_WORKER_MARKER = '.session-end-worker.pending';
+/**
+ * A marker older than this is stale whatever its holder says. The worker
+ * drops the marker as soon as it holds the gate lock, and it waits at most
+ * about 90 s for that lock, so a live marker is always younger.
+ */
+export const SESSION_END_MARKER_STALE_MS = 2 * 60_000;
+/**
+ * Take the session-end snapshot in THIS process through the gate's
+ * `required` mode. Used by the detached worker and by the inline fallback.
+ *
+ * Never throws. A result other than a written or covered snapshot is logged
+ * at warn level with its cause.
+ *
+ * @param projectRoot - Project root of the ended session.
+ * @param opts - Request generation and lock wait.
+ * @returns The gate outcome, or `null` when no snapshot could be attempted.
+ * @task T12508
+ */
+export async function snapshotAfterSessionEnd(projectRoot, opts = {}) {
+    const log = getLogger('session-end-snapshot');
+    try {
+        const { vacuumIntoBackupAll } = await import('../store/sqlite-backup.js');
+        const result = await vacuumIntoBackupAll({
+            cwd: projectRoot,
+            mode: 'required',
+            lockWaitRetries: opts.lockWaitRetries ?? SESSION_END_LOCK_WAIT_RETRIES,
+            ...(opts.seenGeneration !== undefined && { seenGeneration: opts.seenGeneration }),
+            ...(opts.alwaysSnapshot !== undefined && { alwaysSnapshot: opts.alwaysSnapshot }),
+            ...(opts.onLockAcquired !== undefined && { onLockAcquired: opts.onLockAcquired }),
+        });
+        const miss = describeSnapshotMiss(result);
+        if (miss)
+            log.warn({ projectRoot, cause: miss }, 'Session-end snapshot not taken');
+        return result;
+    }
+    catch (err) {
+        log.warn({ err, projectRoot }, 'Session-end snapshot failed');
+        return null;
+    }
+}
+/** Whether to snapshot in-process instead of in a detached child. */
+function runInline() {
+    const mode = process.env['CLEO_SESSION_END_SNAPSHOT'];
+    if (mode === 'inline')
+        return true;
+    if (mode === 'detached')
+        return false;
+    return process.env['VITEST'] !== undefined;
+}
+/** Resolve the compiled worker entry, or `null` when it is not installed/built. */
+function resolveWorkerEntry() {
+    try {
+        return createRequire(import.meta.url).resolve(WORKER_SPECIFIER);
+    }
+    catch {
+        return null;
+    }
+}
+/** Absolute path of the worker-pending marker for a project. */
+export function sessionEndWorkerMarkerPath(projectRoot) {
+    return join(getCleoDir(projectRoot), 'backups', 'sqlite', SESSION_END_WORKER_MARKER);
+}
+/** Path of the sidecar holding the queued worker's identity for `token`. */
+function workerSidecarPath(markerPath, token) {
+    return `${markerPath}.${token}.worker`;
+}
+/** Path of the session-end worker log for a project. */
+function workerLogPath(projectRoot) {
+    return join(getCleoDir(projectRoot), 'logs', 'session-end-snapshot.log');
+}
+/** Whether a process with this pid exists (EPERM means it exists but is not ours). */
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err instanceof Error && 'code' in err && err.code === 'EPERM';
+    }
+}
+/**
+ * Start time of a process as `ps -o lstart=` prints it (second resolution,
+ * stable for the life of the process), or `null` when it cannot be read —
+ * the process is gone, or `ps` is unavailable (Windows).
+ */
+function processStart(pid) {
+    try {
+        const out = execFileSync('ps', ['-o', 'lstart=', '-p', String(pid)], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 2_000,
+            env: { ...process.env, LC_ALL: 'C' },
+        }).trim();
+        return out === '' ? null : out;
+    }
+    catch {
+        return null;
+    }
+}
+/** Identity of a process that is running now. */
+function identityOf(pid) {
+    return { pid, pidStart: processStart(pid) };
+}
+/**
+ * Whether `who` is still the process that recorded it: its pid is alive and,
+ * where start times are available, the pid's current start time matches. A
+ * reused pid (or pid 1, always alive) with a different start time is not.
+ */
+function isSameLiveProcess(who) {
+    if (!isPidAlive(who.pid))
+        return false;
+    if (who.pidStart === null)
+        return true; // Recorded without `ps`: liveness only.
+    const now = processStart(who.pid);
+    return now === null ? true : now === who.pidStart;
+}
+/** Parse a JSON process identity (and token), or `null` when malformed. */
+function parseIdentity(text) {
+    try {
+        const v = JSON.parse(text);
+        if (!v || typeof v.pid !== 'number')
+            return null;
+        const pidStart = typeof v.pidStart === 'string' ? v.pidStart : null;
+        return typeof v.token === 'string'
+            ? { pid: v.pid, pidStart, token: v.token }
+            : { pid: v.pid, pidStart };
+    }
+    catch {
+        return null;
+    }
+}
+/** Read the marker, or `null` when it is missing or malformed. */
+function readWorkerMarker(path) {
+    let text;
+    try {
+        text = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const v = parseIdentity(text);
+    return v?.token === undefined ? null : { token: v.token, pid: v.pid, pidStart: v.pidStart };
+}
+/** Read the queued worker's identity for `token`, or `null` when not yet handed over. */
+function readWorkerSidecar(markerPath, token) {
+    try {
+        return parseIdentity(readFileSync(workerSidecarPath(markerPath, token), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether the marker names a worker that is still queued: it is younger than
+ * {@link SESSION_END_MARKER_STALE_MS}, and its holder — the worker named in
+ * the sidecar, or else the requester still handing over — is the same live
+ * process that recorded it.
+ */
+function isMarkerLive(path) {
+    let ageMs;
+    try {
+        ageMs = Date.now() - statSync(path).mtimeMs;
+    }
+    catch {
+        return false;
+    }
+    if (ageMs > SESSION_END_MARKER_STALE_MS)
+        return false;
+    const marker = readWorkerMarker(path);
+    if (!marker)
+        return false;
+    return isSameLiveProcess(readWorkerSidecar(path, marker.token) ?? marker);
+}
+/** Write `text` to `path` atomically: a unique temp file, then rename. */
+function writeAtomic(path, text) {
+    const tmp = `${path}.tmp-${process.pid}-${randomUUID()}`;
+    try {
+        writeFileSync(tmp, text);
+        renameSync(tmp, path);
+    }
+    finally {
+        rmSync(tmp, { force: true });
+    }
+}
+/**
+ * Create the marker atomically and exclusively: write it complete to a temp
+ * file, then `link()` it into place — the link fails with EEXIST if a marker
+ * exists, and no reader ever sees a partial marker. Where hard links are not
+ * supported, falls back to an O_EXCL create. Returns `false` when a marker
+ * already exists.
+ */
+function tryCreateMarker(path, marker) {
+    const body = JSON.stringify(marker);
+    const tmp = `${path}.${marker.token}.new`;
+    try {
+        writeFileSync(tmp, body);
+        try {
+            linkSync(tmp, path);
+            return true;
+        }
+        catch (err) {
+            if (!(err instanceof Error && 'code' in err))
+                throw err;
+            if (err.code === 'EEXIST')
+                return false;
+            if (!['EPERM', 'ENOTSUP', 'EXDEV', 'EMLINK'].includes(String(err.code)))
+                throw err;
+        }
+        let fd;
+        try {
+            fd = openSync(path, 'wx');
+        }
+        catch (err) {
+            if (err instanceof Error && 'code' in err && err.code === 'EEXIST')
+                return false;
+            throw err;
+        }
+        try {
+            writeSync(fd, body);
+        }
+        finally {
+            closeSync(fd);
+        }
+        return true;
+    }
+    finally {
+        rmSync(tmp, { force: true });
+    }
+}
+/** Remove the marker and its worker sidecar. */
+function removeMarker(path, token) {
+    rmSync(path, { force: true });
+    if (token !== null)
+        rmSync(workerSidecarPath(path, token), { force: true });
+}
+/** Remove worker sidecars that do not belong to the current marker's token. */
+function removeOrphanSidecars(path, currentToken) {
+    try {
+        const dir = dirname(path);
+        const prefix = `${SESSION_END_WORKER_MARKER}.`;
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith(prefix) || !name.endsWith('.worker'))
+                continue;
+            if (name === `${prefix}${currentToken}.worker`)
+                continue;
+            rmSync(join(dir, name), { force: true });
+        }
+    }
+    catch {
+        // Orphans are harmless: a sidecar is read only for the current token.
+    }
+}
+/**
+ * Reserve the right to spawn the session-end worker for this project.
+ * Returns the reservation, or `null` when a live worker is already queued.
+ * A stale marker (holder gone or replaced, or older than
+ * {@link SESSION_END_MARKER_STALE_MS}) is removed and the reservation retried
+ * once.
+ */
+function reserveWorkerMarker(path) {
+    const marker = { token: randomUUID(), ...identityOf(process.pid) };
+    let created = tryCreateMarker(path, marker);
+    if (!created) {
+        if (isMarkerLive(path))
+            return null;
+        removeMarker(path, readWorkerMarker(path)?.token ?? null);
+        created = tryCreateMarker(path, marker);
+    }
+    if (!created)
+        return null;
+    removeOrphanSidecars(path, marker.token);
+    return marker;
+}
+/**
+ * Record the spawned worker as the marker's holder, so the marker stays live
+ * after this (short-lived) requester exits. Writes only the per-token sidecar,
+ * atomically; the marker itself is never touched, so if the worker has already
+ * dropped the marker (it holds the lock and is about to snapshot) nothing is
+ * recreated and later requests correctly spawn the next worker.
+ */
+function handMarkerToWorker(path, token, worker) {
+    try {
+        writeAtomic(workerSidecarPath(path, token), JSON.stringify(worker));
+    }
+    catch {
+        // Without the sidecar the marker goes stale when this requester exits.
+    }
+}
+/**
+ * Remove the worker-pending marker if it still carries `token` — i.e. it was
+ * created for this worker and not replaced after being judged stale — and the
+ * worker's sidecar. Called by the worker under the gate lock, before it
+ * snapshots, and again when it exits. Never throws.
+ *
+ * @param projectRoot - Project whose marker to release.
+ * @param token - Token the worker was spawned with.
+ * @task T12508
+ */
+export function releaseSessionEndWorkerMarker(projectRoot, token) {
+    try {
+        const path = sessionEndWorkerMarkerPath(projectRoot);
+        if (readWorkerMarker(path)?.token === token)
+            rmSync(path, { force: true });
+        rmSync(workerSidecarPath(path, token), { force: true });
+    }
+    catch {
+        // Best-effort: a leftover marker goes stale within minutes.
+    }
+}
+/** Append one line to the worker log recording a coalesced request. Never throws. */
+function logCoalesced(projectRoot, markerPath) {
+    try {
+        const marker = readWorkerMarker(markerPath);
+        const holder = marker ? (readWorkerSidecar(markerPath, marker.token) ?? marker) : null;
+        const log = workerLogPath(projectRoot);
+        mkdirSync(dirname(log), { recursive: true });
+        appendFileSync(log, `${JSON.stringify({
+            event: 'session-end-snapshot-coalesced',
+            at: new Date().toISOString(),
+            pid: process.pid,
+            projectRoot,
+            queuedWorkerPid: holder?.pid ?? null,
+        })}\n`);
+    }
+    catch {
+        // Logging is best-effort.
+    }
+}
+/**
+ * Request the session-end snapshot. Call it as the LAST step of ending a
+ * session, after the session row is persisted as ended.
+ *
+ * Unless a worker is already queued for this project, spawns a detached,
+ * unref'd worker that takes the snapshot, and returns immediately. A request
+ * that finds a live marker spawns nothing and is logged as coalesced (see the
+ * module comment for why that is safe). Falls back to an inline snapshot
+ * (bounded lock wait) when the worker cannot be spawned. Never throws.
+ *
+ * @param projectRoot - Project root of the ended session.
+ * @returns How the snapshot was requested.
+ * @task T12508
+ */
+export async function requestSessionEndSnapshot(projectRoot) {
+    const log = getLogger('session-end-snapshot');
+    let seenGeneration = null;
+    try {
+        const { readProjectSnapshotGeneration } = await import('../store/sqlite-backup.js');
+        seenGeneration = await readProjectSnapshotGeneration(projectRoot);
+    }
+    catch {
+        // Unknown generation: an inline snapshot is then never considered covered.
+    }
+    const inlineOpts = seenGeneration === null ? {} : { seenGeneration };
+    const entry = runInline() ? null : resolveWorkerEntry();
+    if (entry !== null) {
+        let marker = null;
+        try {
+            const backupDir = join(getCleoDir(projectRoot), 'backups', 'sqlite');
+            mkdirSync(backupDir, { recursive: true });
+            const markerPath = sessionEndWorkerMarkerPath(projectRoot);
+            marker = reserveWorkerMarker(markerPath);
+            if (marker === null) {
+                logCoalesced(projectRoot, markerPath);
+                return { mode: 'coalesced', seenGeneration };
+            }
+            const logFile = workerLogPath(projectRoot);
+            mkdirSync(dirname(logFile), { recursive: true });
+            const fd = openSync(logFile, 'a');
+            try {
+                const child = spawn(process.execPath, [entry, projectRoot, marker.token], {
+                    detached: true,
+                    stdio: ['ignore', fd, fd],
+                    cwd: projectRoot,
+                    env: process.env,
+                });
+                // A spawn failure is emitted asynchronously; without a listener it
+                // would be an uncaught error in the process ending the session.
+                child.on('error', (err) => log.warn({ err, projectRoot }, 'Session-end snapshot worker failed'));
+                child.unref();
+                if (child.pid !== undefined) {
+                    handMarkerToWorker(markerPath, marker.token, identityOf(child.pid));
+                    return { mode: 'detached', seenGeneration, pid: child.pid };
+                }
+            }
+            finally {
+                closeSync(fd);
+            }
+        }
+        catch (err) {
+            log.warn({ err, projectRoot }, 'Could not spawn session-end snapshot worker; running inline');
+        }
+        if (marker !== null)
+            releaseSessionEndWorkerMarker(projectRoot, marker.token);
+    }
+    const result = await snapshotAfterSessionEnd(projectRoot, inlineOpts);
+    return { mode: 'inline', seenGeneration, result };
+}
+//# sourceMappingURL=session-end-snapshot.js.map

package/dist/sessions/session-end-snapshot.js.map

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

package/dist/sessions/session-manifest-mirror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manifest-mirror.d.ts","sourceRoot":"","sources":["../../src/sessions/session-manifest-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAEL,KAAK,iBAAiB,EAGvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAqBlF;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAKrF;AAuFD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,eAAe,CAAC,YAAY,GAAG,IAAI,CAAC,CAQrD;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}
+{"version":3,"file":"session-manifest-mirror.d.ts","sourceRoot":"","sources":["../../src/sessions/session-manifest-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAEL,KAAK,iBAAiB,EAGvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAqBlF;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAKrF;AAgFD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,eAAe,CAAC,YAAY,GAAG,IAAI,CAAC,CAQrD;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAGL,eAAe,EACf,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,IAAI,IAAI,GAAwC,IAAI,CAAC;AACrD,SAAS,GAAG;IACV,IAAI,IAAI,KAAK,IAAI;QAAE,IAAI,GAAG,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,+EAA+E;IAC/E,gFAAgF;IAChF,gFAAgF;IAChF,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CACpB,OAAgB,EAChB,SAAwB,EACxB,WAA0B;IAE1B,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,SAAS;QACT,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,iBAAiB,CAC9B,MAAmC,EACnC,GAAwC;IAExC,MAAM,EAAE,GAAiB,MAAM,CAAC,EAAE,CAAC;IACnC,iFAAiF;IACjF,kEAAkE;IAClE,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,KAAK,IAAI,EAAE;QACT,MAAM,EAAE;aACL,MAAM,CAAC,eAAe,CAAC;aACvB,MAAM,CAAC,GAAG,CAAC;aACX,kBAAkB,CAAC;YAClB,MAAM,EAAE,eAAe,CAAC,SAAS;YACjC,uEAAuE;YACvE,uEAAuE;YACvE,GAAG,EAAE;gBACH,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,eAAe,EAAE,GAAG,CAAC,eAAe;gBACpC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;aAC3B;SACF,CAAC;aACD,GAAG,EAAE,CAAC;IACX,CAAC,EACD,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAmB,EACnB,OAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,wBAAwB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC3D,MAAM,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,GAAG,EAAE,CAAC,KAAK,CACT,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EACxE,yEAAyE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,WAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC;QACH,4EAA4E;QAC5E,kEAAkE;QAClE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,8EAA8E;YAC9E,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,wBAAwB,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,EAAE,CAAC,KAAK,CACT,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAC5D,+EAA+E,CAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE;SACzB,MAAM,EAAE;SACR,IAAI,CAAC,eAAe,CAAC;SACrB,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;SAC/C,GAAG,EAAE,CAAC;IACT,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}
+{"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