@vibe-commit/capture 0.6.1 → 0.8.0

package/dist/agents/claude_code.js

@@ -7,9 +7,10 @@
  * `commands/connect.ts`'s own `findCurrentTranscript` verbatim except for the
  * confinement call, which now runs against the registry's union.
  */
-import { readdirSync, statSync } from "node:fs";
+import { readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, join } from "node:path";
-import { claudeSettingsPath, isInside, isTranscriptFile, transcriptRoot } from "../paths.js";
+import { claudeConfigPath, claudeSettingsPath, isInside, isTranscriptFile, transcriptRoot, } from "../paths.js";
+import { readEntries, sessionFile, subdirectories } from "./session_listing.js";
 /**
  * The client-side backstop, per event.
  *
@@ -38,16 +39,66 @@ const CLAUDE_CLIENT_BUDGET_MS = 5_000;
 const CLAUDE_REGISTERED_STOP_MS = 8_000;
 const CLAUDE_REGISTERED_PRECOMPACT_MS = 8_000;
 const CLAUDE_REGISTERED_SESSION_END_MS = 10_000;
+/**
+ * `SessionStart` reuses `Stop`'s two clocks and has no fast path of its own.
+ *
+ * ⛔ **A logged shortcut** — gstack-shortcut(dec-e650afbf), eng review D7 · B,
+ * Alexander's choice over a 1.5 s cap. The ceiling: a hung `SessionStart` can
+ * hold a session's start up by as long as the REGISTERED timeout (8 s here).
+ * Upgrade when a measurement or a user report shows session-start delay, or
+ * before slice 2's grants fetch is built into this handler.
+ */
+const CLAUDE_REGISTERED_SESSION_START_MS = CLAUDE_REGISTERED_STOP_MS; // gstack-shortcut(dec-e650afbf)
+/**
+ * The longest folder name Claude Code writes verbatim.
+ *
+ * ⛔ **MEASURED (Open Question 3, VS, 2026-10-24).** An encoded path that would
+ * pass 200 characters is cut to 200, then `-`, then 6 hash characters (a
+ * measured name was 207 long, `…-x911fg`). The hash is not invertible from here,
+ * so such a folder cannot be matched to a path — and so a name LONGER than this
+ * is always a hashed one, since a verbatim name never exceeds it.
+ */
+export const CLAUDE_NAME_LIMIT = 200;
+/**
+ * The folder name Claude Code gives a project path — Open Question 3.
+ *
+ * ⛔ **EVERY UTF-16 CODE UNIT OUTSIDE `[A-Za-z0-9]` BECOMES ONE `-`.** Measured by
+ * running throwaway sessions in folders named with `. _`, a space, `@ + ~ ( ) ' =
+ * , # % &`, `é` and an emoji: all of them, and the emoji TWICE, because the
+ * regular expression below runs over code units (no `u` flag) and an emoji is
+ * two. Runs do NOT collapse (`501/-Users` gave `501--Users`), a literal `-` stays
+ * itself, case is kept, and a leading `/` gives a leading `-`.
+ *
+ * ⚠ **This replaces `/[/.]/g`, which was the rule the first version of
+ * `locateCurrentTranscript` derived from 17 folders none of which held anything
+ * else.** For a repo whose path held an `_` or a space, `connect`'s test capture
+ * looked in a folder that does not exist and skipped the beat (a 0.6.x defect;
+ * `test/scan-encodings.test.ts` carries its regression cell).
+ *
+ * ⚠ **It returns the FULL encoding even past the limit**, and the callers decide
+ * what that means: `locateCurrentTranscript` cannot find a hashed folder, and the
+ * scan's walk compares PREFIXES of a name that is itself at most the limit, so a
+ * longer prefix simply never matches. One function, no second spelling of the rule.
+ */
+export function encodeProjectPath(path) {
+    return path.replace(/[^A-Za-z0-9]/g, "-");
+}
+/** Is this folder name one Claude Code cut and hashed? See `CLAUDE_NAME_LIMIT`. */
+export function isHashedProjectName(name) {
+    return name.length > CLAUDE_NAME_LIMIT;
+}
 /**
  * The transcript for the session running right now.
  *
  * A hook is HANDED `transcript_path` on stdin. `connect` is typed by a human and
  * gets nothing, so it has to find one: Claude Code stores transcripts at
  * `<transcriptRoot>/<encoded-project-path>/<session-id>.jsonl`, where the
- * encoding replaces `/` and `.` with `-`. That was derived by comparing every
- * directory on this machine against the `cwd` its transcripts record — 15 of 17
- * matched exactly, and both misses were sessions whose `cwd` MOVED mid-session,
- * not a different encoding.
+ * encoding is `encodeProjectPath` above. The first version of that was derived
+ * by comparing every directory on this machine against the `cwd` its transcripts
+ * record — 15 of 17 matched exactly, and both misses were sessions whose `cwd`
+ * MOVED mid-session, not a different encoding. ⚠ Seventeen folders cannot
+ * contain a character none of them had: see `encodeProjectPath` for what that
+ * assumption cost.
  *
  * Which is also why this looks up the directory for THIS project rather than
  * taking the newest transcript anywhere: a session that started in another
@@ -70,7 +121,13 @@ const CLAUDE_REGISTERED_SESSION_END_MS = 10_000;
  */
 function locateCurrentTranscript(home, env, projectKey) {
     const root = transcriptRoot(home, env);
-    const dir = join(root, projectKey.replace(/[/.]/g, "-"));
+    const name = encodeProjectPath(projectKey);
+    // A hashed folder name cannot be derived from the path, so there is nothing to
+    // look in. `connect` then skips the test-capture beat, as it does for an agent
+    // with no locator, rather than guessing a sibling.
+    if (isHashedProjectName(name))
+        return null;
+    const dir = join(root, name);
     let entries;
     try {
         entries = readdirSync(dir);
@@ -129,6 +186,70 @@ function claudeSessionIdFromEnv(env) {
     const value = raw.trim();
     return value === "" ? null : value;
 }
+/**
+ * The folders Claude Code has recorded running in: the KEYS of `~/.claude.json`'s
+ * `projects` map, and nothing else.
+ *
+ * ⛔ **Keys only.** The file also holds account and onboarding state, none of
+ * which this client has any use for. Nothing but the key strings leaves this
+ * function, and a failure of any kind is an empty list: the signal then simply
+ * does not fire, which skips less. ⚠ **No error is ever surfaced or logged** — Node
+ * 22's `JSON.parse` message quotes the text it failed on, and this file is not
+ * one whose text belongs on a screen.
+ */
+function recordedProjectPaths(home, env) {
+    try {
+        const parsed = JSON.parse(readFileSync(claudeConfigPath(home, env), "utf8"));
+        const projects = typeof parsed === "object" && parsed !== null
+            ? parsed.projects
+            : undefined;
+        return typeof projects === "object" && projects !== null ? Object.keys(projects) : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Claude Code's sessions, by folder — `D11 · A`, `scan`.
+ *
+ * `<root>/<encoded path>/<session-id>.jsonl`. Only the files DIRECTLY in a
+ * project folder are sessions: `<session-id>/subagents/…` holds delegated work
+ * that belongs to a parent session (`CR-124`), and counting it would turn one
+ * session into several. A legacy `agent-*.jsonl` sidechain at this level is
+ * excluded for the same reason.
+ *
+ * ⛔ **Names and times only.** The folder name is returned still ENCODED; whether
+ * it resolves to a path is the scan engine's walk, against the filesystem, never
+ * against a transcript's own `cwd` record (D60 §D6).
+ */
+function claudeSessionSource(home, env) {
+    const root = transcriptRoot(home, env);
+    const folders = [];
+    try {
+        for (const folder of subdirectories(root)) {
+            const sessions = [];
+            for (const entry of readEntries(folder.path) ?? []) {
+                if (!entry.name.endsWith(".jsonl") || entry.name.startsWith("agent-"))
+                    continue;
+                const session = sessionFile(join(folder.path, entry.name));
+                if (session !== null)
+                    sessions.push(session);
+            }
+            if (sessions.length > 0)
+                folders.push({ name: folder.name, sessions });
+        }
+    }
+    catch {
+        return { kind: "unreadable", reason: "unreadable" };
+    }
+    return {
+        kind: "folders",
+        folders,
+        encode: encodeProjectPath,
+        isHashed: isHashedProjectName,
+        recorded: recordedProjectPaths(home, env),
+    };
+}
 export const CLAUDE_CODE = {
     id: "claude-code",
     transport: "ndjson",
@@ -143,7 +264,12 @@ export const CLAUDE_CODE = {
     // agent the client was built for. Declared explicitly rather than defaulted so
     // that a dialect added later must ANSWER the question; a default would let a
     // camelCase agent inherit Claude's spellings and match nothing (`CR-195`).
-    eventNames: { Stop: "Stop", PreCompact: "PreCompact", SessionEnd: "SessionEnd" },
+    eventNames: {
+        Stop: "Stop",
+        PreCompact: "PreCompact",
+        SessionEnd: "SessionEnd",
+        SessionStart: "SessionStart",
+    },
     // ⛔ `~/.claude/settings.json`, honouring `CLAUDE_CONFIG_DIR`. ⚠ This is the
     // file the PLUGIN path does not need — the plugin ships its own `hooks.json`
     // — and the npm path had no writer at all, which is the defect `/install`
@@ -162,12 +288,19 @@ export const CLAUDE_CODE = {
             registeredTimeoutMs: CLAUDE_REGISTERED_SESSION_END_MS,
             clientBudgetMs: CLAUDE_CLIENT_BUDGET_MS,
         },
+        // MEASURED (Open Question 1, 2.1.309): fires before the first prompt in `-p`
+        // and the TUI, and accepts `systemMessage`. gstack-shortcut(dec-e650afbf).
+        SessionStart: {
+            registeredTimeoutMs: CLAUDE_REGISTERED_SESSION_START_MS,
+            clientBudgetMs: CLAUDE_CLIENT_BUDGET_MS,
+        },
     },
     // `<session>/subagents/agent-*.jsonl`, globbed — the paths are never handed
     // over. `CR-124`, D76.
     delegatedTranscripts: "discover",
     redaction: "claude-code",
     sessionIdFromEnv: claudeSessionIdFromEnv,
+    sessionSource: claudeSessionSource,
     locateCurrentTranscript,
 };
 //# sourceMappingURL=claude_code.js.map

package/dist/agents/claude_code.js.map

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

package/dist/agents/codex_cli.d.ts

@@ -12,4 +12,17 @@
  * reader can check them against the product rather than against this file.
  */
 import type { TranscriptDialect } from "./types.js";
+/**
+ * ⛔ **THE FOUR COLUMNS, AND NO OTHER — `D11 · A`, Alexander's approved read.**
+ *
+ * The thread index also holds `first_user_message`, `title`, `preview` and more,
+ * which are CONTENT. Selecting one would turn a metadata read into a transcript
+ * read, so the statement names exactly these four and `test/scan-codex-index.test.ts`
+ * asserts the SQL carries nothing else. ⚠ **`archived` is not here either, on
+ * purpose** (VQ, 2026-10-24): an archived thread's `rollout_path` is decided by
+ * the admission below, and a fifth column would change the approved read surface.
+ */
+export declare const CODEX_INDEX_COLUMNS: readonly ["cwd", "git_origin_url", "rollout_path", "created_at"];
+/** The one statement the adapter runs against a thread row. */
+export declare const CODEX_INDEX_SQL: string;
 export declare const CODEX_CLI: TranscriptDialect;

package/dist/agents/codex_cli.js

@@ -11,7 +11,11 @@
  * measured by this task.** They are recorded as the brief stated them so a later
  * reader can check them against the product rather than against this file.
  */
-import { codexHooksPath, codexTranscriptRoot, isTranscriptFile } from "../paths.js";
+import { readdirSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { CODEX_INDEX_FILE, codexHooksPath, codexIndexDir, codexTranscriptRoot, isInside, isTranscriptFile, } from "../paths.js";
+import { readEntries, sessionFile } from "./session_listing.js";
 /**
  * `SessionEnd` is the tight one — 3 s registered, 2.2 s client.
  *
@@ -24,6 +28,226 @@ const CODEX_SESSION_END_CLIENT_MS = 2_200;
 /** `Stop` and `PreCompact` are registered far wider — 30 s, client 8 s. */
 const CODEX_TURN_REGISTERED_MS = 30_000;
 const CODEX_TURN_CLIENT_MS = 8_000;
+/**
+ * `SessionStart` takes the turn clocks, with no fast path of its own.
+ *
+ * ⛔ **A logged shortcut** — gstack-shortcut(dec-e650afbf), eng review D7 · B.
+ * The ceiling: a hung `SessionStart` can hold a session's start up by as long as
+ * the REGISTERED timeout (30 s here). Upgrade when a measurement or a user report
+ * shows session-start delay, or before slice 2's grants fetch lands in this handler.
+ */
+const CODEX_SESSION_START_REGISTERED_MS = CODEX_TURN_REGISTERED_MS; // gstack-shortcut(dec-e650afbf)
+const CODEX_SESSION_START_CLIENT_MS = CODEX_TURN_CLIENT_MS; // gstack-shortcut(dec-e650afbf)
+/**
+ * ⛔ **THE FOUR COLUMNS, AND NO OTHER — `D11 · A`, Alexander's approved read.**
+ *
+ * The thread index also holds `first_user_message`, `title`, `preview` and more,
+ * which are CONTENT. Selecting one would turn a metadata read into a transcript
+ * read, so the statement names exactly these four and `test/scan-codex-index.test.ts`
+ * asserts the SQL carries nothing else. ⚠ **`archived` is not here either, on
+ * purpose** (VQ, 2026-10-24): an archived thread's `rollout_path` is decided by
+ * the admission below, and a fifth column would change the approved read surface.
+ */
+export const CODEX_INDEX_COLUMNS = ["cwd", "git_origin_url", "rollout_path", "created_at"];
+/** The one statement the adapter runs against a thread row. */
+export const CODEX_INDEX_SQL = `SELECT ${CODEX_INDEX_COLUMNS.join(", ")} FROM threads`;
+/** How long a locked index is waited for before the adapter gives up (eng review D2). */
+const CODEX_BUSY_TIMEOUT_MS = 1_000;
+/**
+ * `node:sqlite`, loaded here and nowhere else, with ITS warning and only its
+ * warning dropped — eng review D2 · A.
+ *
+ * Node 22 prints `ExperimentalWarning: SQLite is an experimental feature…` to
+ * stderr the first time the module loads, which would land mid-screen in the
+ * picker and breaks DESIGN.md §13's output rules. `process.emitWarning` is
+ * wrapped for the duration of the one `require` and restored in a `finally`;
+ * any OTHER warning, in that window or after it, still prints. Measured on
+ * node 22.17.0.
+ *
+ * ⚠ **A `require` and not a dynamic `import()`**, so the whole adapter stays
+ * synchronous like every other lister (`scan` is a chain of `execFileSync`
+ * anyway) and the wrapped window is exactly the load, not a promise turn that
+ * something else could emit a warning inside. Lazy: a machine with no Codex
+ * never loads the module at all.
+ */
+function loadSqlite() {
+    const original = process.emitWarning;
+    process.emitWarning = ((warning, ...rest) => {
+        const type = typeof warning === "string" ? rest[0] : warning.name;
+        const message = typeof warning === "string" ? warning : warning.message;
+        if (type === "ExperimentalWarning" && message.startsWith("SQLite"))
+            return;
+        return original.call(process, warning, ...rest);
+    });
+    try {
+        return createRequire(import.meta.url)("node:sqlite");
+    }
+    finally {
+        process.emitWarning = original;
+    }
+}
+/** Does the `threads` table carry all four columns? A bare name test, nothing deeper. */
+function hasIndexColumns(db) {
+    const present = new Set(db.prepare("PRAGMA table_info(threads)").all().map((c) => String(c.name)));
+    return CODEX_INDEX_COLUMNS.every((column) => present.has(column));
+}
+/** A locked database is a different line from an unrecognised one. */
+function readFailure(err) {
+    return /locked|busy/i.test(err instanceof Error ? err.message : "")
+        ? "index locked"
+        : "unreadable";
+}
+/**
+ * Rollout files under `sessions/` that NO index row names — counted, never opened.
+ *
+ * Open Question 6's text, as VQ ruled (PR 1 ruling 5c): an index which cannot see a
+ * session is a thing to REPORT, not to guess about. The walk lists directory entries — names
+ * and file types, nothing else — and counts each regular `.jsonl`; a symlink is
+ * not a file here (`Dirent.isFile` is false for it).
+ *
+ * Compared as REALPATHS on both sides, because the index stores the path Codex
+ * wrote and the walk builds its own from `home`; a symlinked home would otherwise
+ * make every rollout look unindexed. A row whose rollout has gone cannot be
+ * resolved and names nothing, which is correct: it is not on disk to be matched.
+ */
+function countUnindexed(root, rolloutPaths) {
+    const named = new Set();
+    for (const path of rolloutPaths) {
+        try {
+            named.add(realpathSync(path));
+        }
+        catch {
+            // Gone from disk: it names no file that the walk could find.
+        }
+    }
+    let base;
+    try {
+        base = realpathSync(root);
+    }
+    catch {
+        return 0;
+    }
+    let count = 0;
+    const visit = (dir) => {
+        let entries;
+        try {
+            entries = readEntries(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries ?? []) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (entry.isFile() && entry.name.endsWith(".jsonl") && !named.has(path))
+                count += 1;
+        }
+    };
+    visit(base);
+    return count;
+}
+/**
+ * Codex's sessions, from its thread index — `D11 · A`, eng review D2, `scan`.
+ *
+ * Codex keeps rollouts DATE-keyed (`sessions/YYYY/MM/DD/`), so a folder walk
+ * cannot say which repo one belongs to; its `threads` table can, because it
+ * records the real `cwd`. That row is the whole reason this adapter exists and
+ * the reason a Codex row is never ambiguous.
+ *
+ * ## ⛔ What is read, and how
+ *
+ *   - **exactly `state_5.sqlite`**, and any other `state_N` is `unrecognised
+ *     index` (Open Question 6; see `codexIndexDir`).
+ *   - **`readOnly`, never `immutable`.** Codex keeps everything since its last
+ *     checkpoint in the `-wal` file (on the author's machine, every thread since
+ *     Sep 30), and an `immutable` open ignores it.
+ *   - **the four columns only** (`CODEX_INDEX_SQL`), after a `PRAGMA table_info`
+ *     check, and a 1000 ms busy timeout. Any failure is this agent's
+ *     `unreadable` answer, so the other two agents' rows are untouched.
+ *
+ * ## ⛔ The rollout file is `lstat`ed, never opened
+ *
+ * A row is admitted only if its `rollout_path` lies under the sessions root and
+ * is a regular file there. That is also what decides an ARCHIVED thread, whose
+ * rollout is not under `sessions/`. The row's `git_origin_url` is carried but is
+ * not the slug source: the scan names a repo from the CLONE (`resolveRepoSlug`),
+ * so there is one normalisation and not two.
+ */
+function codexSessionSource(home, env) {
+    const dir = codexIndexDir(home, env);
+    const file = join(dir, CODEX_INDEX_FILE);
+    let present;
+    try {
+        present = readdirSync(dir);
+    }
+    catch (err) {
+        const code = err.code;
+        return code === "ENOENT" || code === "ENOTDIR"
+            ? { kind: "rows", rows: [], unindexed: 0 }
+            : { kind: "unreadable", reason: "unreadable" };
+    }
+    if (!present.includes(CODEX_INDEX_FILE)) {
+        // A Codex that keeps its index under another generation's name is a store
+        // this client was not checked against. One with no index at all has simply
+        // never recorded a thread — and its rollouts, if any, are all unindexed.
+        return present.some((name) => /^state_\d+\.sqlite$/.test(name))
+            ? { kind: "unreadable", reason: "unrecognised index" }
+            : { kind: "rows", rows: [], unindexed: countUnindexed(codexTranscriptRoot(home, env), []) };
+    }
+    let sqlite;
+    try {
+        sqlite = loadSqlite();
+    }
+    catch {
+        return { kind: "unreadable", reason: "unreadable" };
+    }
+    let db = null;
+    try {
+        // ⚠ `readOnly` stops THIS CODE writing the index and does not stop SQLite creating its own
+        // `-wal`/`-shm` files beside it, which any reader of a WAL database whose writer has closed does
+        // (measured by VQ on node 22.17, PR 1 F1). Nothing is written to `state_5.sqlite` itself.
+        db = new sqlite.DatabaseSync(file, { readOnly: true });
+        db.exec(`PRAGMA busy_timeout = ${CODEX_BUSY_TIMEOUT_MS}`);
+        if (!hasIndexColumns(db))
+            return { kind: "unreadable", reason: "unrecognised index" };
+        const root = codexTranscriptRoot(home, env);
+        const rows = [];
+        const named = [];
+        for (const row of db.prepare(CODEX_INDEX_SQL).all()) {
+            const { cwd, git_origin_url: origin, rollout_path: rollout, created_at: created } = row;
+            if (typeof cwd !== "string" || typeof rollout !== "string")
+                continue;
+            // Every path an index row names counts as INDEXED, admitted or not: an archived thread's rollout
+            // is not "missing from the index", it is simply not capturable (`D11 · A`).
+            named.push(rollout);
+            if (!isInside(root, rollout) || !isTranscriptFile(root, rollout))
+                continue;
+            const session = sessionFile(rollout);
+            if (session === null)
+                continue;
+            rows.push({
+                cwd,
+                origin: typeof origin === "string" ? origin : null,
+                // `created_at` is whole SECONDS (measured), the rest of this client's
+                // times are milliseconds.
+                session: typeof created === "number" ? { ...session, startedMs: created * 1000 } : session,
+            });
+        }
+        return { kind: "rows", rows, unindexed: countUnindexed(root, named) };
+    }
+    catch (err) {
+        return { kind: "unreadable", reason: readFailure(err) };
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            // Closing a read-only handle that failed to open is not a second finding.
+        }
+    }
+}
 export const CODEX_CLI = {
     id: "codex-cli",
     transport: "ndjson",
@@ -46,7 +270,17 @@ export const CODEX_CLI = {
     // against three throwaway `CODEX_HOME`s settled it: `SessionEnd` is recognised
     // and says so by clamping, while `session_end` and a bogus key produce NO
     // diagnostic — a file that parses, registers nothing, and reports success.
-    eventNames: { Stop: "Stop", PreCompact: "PreCompact", SessionEnd: "SessionEnd" },
+    // `SessionStart` is in that schema list too, spelled the same way, and MEASURED
+    // live (Open Question 1, Codex 0.148.0): it fires before the first prompt — in
+    // the TUI lazily, when the first prompt is submitted — and accepts a
+    // `systemMessage`. ⚠ Those runs were under cmux's `--dangerously-bypass-hook-trust`;
+    // stock Codex >= 0.131.0 runs a user-level hook only after the user trusts it.
+    eventNames: {
+        Stop: "Stop",
+        PreCompact: "PreCompact",
+        SessionEnd: "SessionEnd",
+        SessionStart: "SessionStart",
+    },
     // ⛔ `~/.codex/hooks.json`, honouring `CODEX_HOME` — MEASURED, since every
     // probe in this unit drove a real `codex` through a throwaway `CODEX_HOME`
     // and it read the `hooks.json` there. The NESTED shape, also measured: a
@@ -66,6 +300,10 @@ export const CODEX_CLI = {
             registeredTimeoutMs: CODEX_SESSION_END_REGISTERED_MS,
             clientBudgetMs: CODEX_SESSION_END_CLIENT_MS,
         },
+        SessionStart: {
+            registeredTimeoutMs: CODEX_SESSION_START_REGISTERED_MS,
+            clientBudgetMs: CODEX_SESSION_START_CLIENT_MS,
+        },
     },
     // The delegated path ARRIVES on stdin as `agent_transcript_path` — there is no
     // directory to glob. Nothing parses it yet; the discriminator is here so the
@@ -79,6 +317,7 @@ export const CODEX_CLI = {
     // of a measurement, not as a fact about the agent. Measuring it is a change to
     // this line and nothing else.
     sessionIdFromEnv: () => null,
+    sessionSource: codexSessionSource,
     // ⛔ NO `locateCurrentTranscript`, and the omission is the decision. Finding
     // the repository would mean reading a `cwd` out of the transcript's own
     // records — ANALYSIS, which D60 §D6 forbids this client. `connect` therefore

package/dist/agents/codex_cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex_cli.js","sourceRoot":"","sources":["../../src/agents/codex_cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpF;;;;;;GAMG;AACH,MAAM,+BAA+B,GAAG,KAAK,CAAC;AAC9C,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,MAAM,CAAC,MAAM,SAAS,GAAsB;IAC1C,EAAE,EAAE,WAAW;IACf,SAAS,EAAE,QAAQ;IACnB,cAAc,EAAE,mBAAmB;IACnC,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,+DAA+D;IAC/D,UAAU,EAAE,gBAAgB;IAC5B,4EAA4E;IAC5E,8EAA8E;IAC9E,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,mEAAmE;IACnE,EAAE;IACF,kEAAkE;IAClE,4EAA4E;IAC5E,+EAA+E;IAC/E,+EAA+E;IAC/E,0EAA0E;IAC1E,2EAA2E;IAC3E,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE;IAChF,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,gEAAgE;IAChE,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE;IACrD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,mBAAmB,EAAE,wBAAwB;YAC7C,cAAc,EAAE,oBAAoB;SACrC;QACD,UAAU,EAAE;YACV,mBAAmB,EAAE,wBAAwB;YAC7C,cAAc,EAAE,oBAAoB;SACrC;QACD,UAAU,EAAE;YACV,mBAAmB,EAAE,+BAA+B;YACpD,cAAc,EAAE,2BAA2B;SAC5C;KACF;IACD,+EAA+E;IAC/E,6EAA6E;IAC7E,oEAAoE;IACpE,oBAAoB,EAAE,UAAU;IAChC,SAAS,EAAE,WAAW;IACtB,8EAA8E;IAC9E,0EAA0E;IAC1E,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,8BAA8B;IAC9B,gBAAgB,EAAE,GAAG,EAAE,CAAC,IAAI;IAC5B,4EAA4E;IAC5E,wEAAwE;IACxE,6EAA6E;IAC7E,oDAAoD;CACrD,CAAC"}
+{"version":3,"file":"codex_cli.js","sourceRoot":"","sources":["../../src/agents/codex_cli.ts"],"names":[],"mappings":"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"}

package/dist/agents/cursor.d.ts

@@ -18,4 +18,38 @@
  * difference is marked on each member below rather than left to a reader.
  */
 import type { TranscriptDialect } from "./types.js";
+/**
+ * The longest folder name Cursor writes verbatim.
+ *
+ * ⛔ **MEASURED (Open Question 3, VS, 2026-10-24), with `cursor-agent`, which
+ * creates the project folder even when it is not logged in.** A name up to 61
+ * characters is kept; a longer one becomes its first 53 characters, `-`, and 7
+ * hex characters (the hash varied with the input, so it is not a constant).
+ */
+export declare const CURSOR_NAME_LIMIT = 61;
+/**
+ * The folder name Cursor gives a workspace path — Open Question 3.
+ *
+ * ⛔ **THIS IS NOT CLAUDE CODE'S RULE, and the difference is the measurement.**
+ * Every RUN of non-alphanumerics, a literal `--` included, collapses to ONE `-`;
+ * leading and trailing separators are dropped (so `/tmp/q/trail.` is `…-trail`
+ * and there is no leading `-`); case is kept. An emoji and `é'` each gave a single
+ * dash where Claude Code gives two.
+ *
+ * ⚠ **Which makes Cursor's names collide far more:** `a-b`, `a.b`, `a--b` and
+ * `a.b.` are all one folder. The scan's walk encodes every directory entry with
+ * THIS function and matches on the result, so the collapsing applies to every
+ * candidate rather than being assumed away.
+ */
+export declare function encodeProjectPath(path: string): string;
+/**
+ * Is this folder name one Cursor cut and hashed? See `CURSOR_NAME_LIMIT`.
+ *
+ * ⚠ **A hashed name is always exactly 61 long, and so is a verbatim name that
+ * happens to be 61 long** — length alone cannot tell them apart. The test is the
+ * hash's shape too (`-` and 7 hex). A verbatim 61-character name that ends the
+ * same way is read as hashed, which is the safe error: it is skipped and
+ * counted, never matched to a path it might not be.
+ */
+export declare function isHashedProjectName(name: string): boolean;
 export declare const CURSOR: TranscriptDialect;