@getrift/rift 0.1.0-beta.21 → 0.1.0-beta.23

package/dist/src/ingestion/cursor/cursor-store.js

@@ -0,0 +1,243 @@
+import { resolveProjectRoot, } from "./workspace-root.js";
+const ITEM_KEY_COMPOSER_HEADERS = "composer.composerHeaders";
+const KV_PREFIX_COMPOSER_DATA = "composerData:";
+const KV_PREFIX_BUBBLE = "bubbleId:";
+const BUBBLE_TYPE_USER = 1;
+const BUBBLE_TYPE_ASSISTANT = 2;
+function safeJsonParse(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function indexByKey(rows) {
+    const map = new Map();
+    for (const row of rows)
+        map.set(row.key, row.value);
+    return map;
+}
+function epochMsToIso(ms) {
+    if (typeof ms !== "number" || !Number.isFinite(ms) || ms <= 0)
+        return null;
+    return new Date(ms).toISOString();
+}
+/**
+ * Map a Cursor model label to a coarse backend. Cursor records its OWN labels
+ * (e.g. "composer-2.5"), not raw provider ids, and very often "default" (the
+ * account-level pick), which is NOT resolvable from local artifacts. This is a
+ * best-effort heuristic — see "Unknowns" in the discovery doc.
+ */
+export function classifyBackend(modelName) {
+    if (!modelName)
+        return "unknown";
+    const m = modelName.toLowerCase();
+    if (m === "default" || m === "auto")
+        return "default";
+    if (m.startsWith("composer") || m.startsWith("cursor"))
+        return "cursor_native";
+    if (m.includes("claude") || m.includes("sonnet") || m.includes("opus") || m.includes("haiku")) {
+        return "anthropic";
+    }
+    if (m.startsWith("gpt") || /^o\d/.test(m) || m.includes("openai") || m.includes("chatgpt")) {
+        return "openai";
+    }
+    if (m.includes("gemini"))
+        return "google";
+    return "unknown";
+}
+/**
+ * Stable, deterministic session key for idempotent capture. composerId is a
+ * UUID minted once per session by Cursor and never reused, so it is the natural
+ * idempotency anchor. Prefixed by source so it can't collide with CLI keys.
+ *
+ * Change detection across re-captures is a SEPARATE concern: pair this key with
+ * a content fingerprint (see {@link cursorConversationFingerprintInput}) and the
+ * session's lastUpdatedAt, exactly as the CLI lanes do. Designing this now
+ * satisfies the "stable key before any scheduled capture" requirement.
+ */
+export function cursorSessionKey(composerId) {
+    return `cursor_composer:${composerId}`;
+}
+/**
+ * Discover native Cursor composer/chat sessions from raw vscdb rows.
+ *
+ * Pure and side-effect free. Uses ONLY the session index + per-session metadata
+ * rows — never bubble bodies — so discovery reveals no private message text.
+ * Sessions are returned newest-updated first.
+ */
+export function discoverCursorComposerSessions(raw) {
+    const items = indexByKey(raw.itemTable);
+    const headersRaw = items.get(ITEM_KEY_COMPOSER_HEADERS);
+    const index = headersRaw
+        ? safeJsonParse(headersRaw)
+        : null;
+    // Body rows, indexed by composerId, give us authoritative model + turn count.
+    const bodyById = new Map();
+    for (const row of raw.cursorDiskKV) {
+        if (!row.key.startsWith(KV_PREFIX_COMPOSER_DATA))
+            continue;
+        const body = safeJsonParse(row.value);
+        if (!body)
+            continue;
+        const id = body.composerId ?? row.key.slice(KV_PREFIX_COMPOSER_DATA.length);
+        if (id)
+            bodyById.set(id, body);
+    }
+    // Prefer the header index as the session roster (it is the UI source of
+    // truth); fall back to body rows if the index is missing/corrupt.
+    const headers = index?.allComposers ?? [];
+    const seen = new Set();
+    const candidates = [];
+    const pushCandidate = (composerId, header, body) => {
+        if (!composerId || seen.has(composerId))
+            return;
+        seen.add(composerId);
+        const modelName = body?.modelConfig?.modelName ?? null;
+        const created = header?.createdAt ?? body?.createdAt;
+        const updated = header?.lastUpdatedAt ?? body?.lastUpdatedAt;
+        // Pure (inline-uri-only) resolution — discovery never touches the fs. The
+        // probe upgrades any legacy `unresolved` row via the workspace.json join.
+        const resolution = resolveProjectRoot(header?.workspaceIdentifier);
+        candidates.push({
+            composerId,
+            name: header?.name ?? body?.name ?? null,
+            mode: header?.unifiedMode ?? body?.unifiedMode ?? null,
+            modelName,
+            backend: classifyBackend(modelName),
+            workspaceId: header?.workspaceIdentifier?.id ?? null,
+            projectRoot: resolution.status === "resolved" ? resolution.root : null,
+            projectRootSource: resolution.status === "resolved" ? resolution.source : null,
+            projectRootStatus: resolution.status,
+            createdAt: epochMsToIso(created),
+            updatedAt: epochMsToIso(updated),
+            turnCount: body?.fullConversationHeadersOnly?.length ?? 0,
+            isDraft: header?.isDraft === true,
+            hasBody: body !== undefined,
+        });
+    };
+    for (const header of headers) {
+        if (!header?.composerId)
+            continue;
+        pushCandidate(header.composerId, header, bodyById.get(header.composerId));
+    }
+    // Bodies present but absent from the index (orphans) still get surfaced.
+    for (const [composerId, body] of bodyById) {
+        pushCandidate(composerId, undefined, body);
+    }
+    return candidates.sort((a, b) => {
+        const at = a.updatedAt ?? a.createdAt ?? "";
+        const bt = b.updatedAt ?? b.createdAt ?? "";
+        return bt.localeCompare(at);
+    });
+}
+/** Build the proposed provenance row for a candidate (design artifact only). */
+export function proposeCursorProvenance(candidate) {
+    return {
+        source: "cursor_composer",
+        source_app: "cursor",
+        source_session_id: candidate.composerId,
+        idempotency_key: cursorSessionKey(candidate.composerId),
+        workspace_id: candidate.workspaceId,
+        project_root: candidate.projectRoot,
+        project_root_source: candidate.projectRootSource,
+        model_name: candidate.modelName,
+        backend: candidate.backend,
+        mode: candidate.mode,
+        created_at: candidate.createdAt,
+        updated_at: candidate.updatedAt,
+    };
+}
+/**
+ * Collect a session's bubbles in conversation order. Order comes from the
+ * session body's `fullConversationHeadersOnly` when present; otherwise we fall
+ * back to whatever bubble rows exist for this composer, in key order. Returns
+ * EVERY referenced bubble (including empty/tool-only ones) so callers — notably
+ * the fingerprint — can see structural changes that carry no prose.
+ */
+export function collectOrderedBubbles(raw, composerId) {
+    const kv = indexByKey(raw.cursorDiskKV);
+    const bodyRaw = kv.get(`${KV_PREFIX_COMPOSER_DATA}${composerId}`);
+    const body = bodyRaw ? safeJsonParse(bodyRaw) : null;
+    let order;
+    if (body?.fullConversationHeadersOnly?.length) {
+        order = body.fullConversationHeadersOnly
+            .map((h) => h.bubbleId)
+            .filter((id) => typeof id === "string");
+    }
+    else {
+        const prefix = `${KV_PREFIX_BUBBLE}${composerId}:`;
+        order = raw.cursorDiskKV
+            .filter((r) => r.key.startsWith(prefix))
+            .map((r) => r.key.slice(prefix.length))
+            .sort();
+    }
+    const bubbles = [];
+    for (const bubbleId of order) {
+        const bubbleRaw = kv.get(`${KV_PREFIX_BUBBLE}${composerId}:${bubbleId}`);
+        if (!bubbleRaw)
+            continue;
+        const bubble = safeJsonParse(bubbleRaw);
+        if (!bubble)
+            continue;
+        bubbles.push({
+            bubbleId,
+            type: typeof bubble.type === "number" ? bubble.type : 0,
+            text: bubble.text ?? "",
+        });
+    }
+    return bubbles;
+}
+/**
+ * Deterministic fingerprint input for a session, over the ordered
+ * `(bubbleId, type, text)` of every turn. This is the change-detection contract
+ * the capture slice will hash (NOT hashed here — the hashing util stays in one
+ * place): re-running on an unchanged session yields an identical string, while
+ * an edited/added/removed turn — including a tool-only turn that carries no
+ * prose — changes it. Requires bubble bodies to be present in `raw`.
+ */
+export function cursorConversationFingerprintInput(raw, composerId) {
+    return collectOrderedBubbles(raw, composerId)
+        .map((b) => `${b.bubbleId}\t${b.type}\t${b.text}`)
+        .join("\n");
+}
+/**
+ * Full parse of a single native Cursor session into the shared
+ * {@link ParsedConversation} contract. Requires the session's bubble bodies to
+ * be present in `raw.cursorDiskKV` (the reader only fetches these on explicit,
+ * privacy-acknowledged opt-in). Returns null when no user/assistant turns with
+ * text exist.
+ *
+ * Provided for the FUTURE capture slice and for round-trip tests; the discovery
+ * probe does not call it by default.
+ */
+export function parseCursorComposerSession(raw, composerId) {
+    const kv = indexByKey(raw.cursorDiskKV);
+    const bodyRaw = kv.get(`${KV_PREFIX_COMPOSER_DATA}${composerId}`);
+    const body = bodyRaw ? safeJsonParse(bodyRaw) : null;
+    const turns = [];
+    for (const bubble of collectOrderedBubbles(raw, composerId)) {
+        const text = bubble.text.trim();
+        if (!text)
+            continue; // tool-only / empty assistant bubbles carry no prose
+        if (bubble.type === BUBBLE_TYPE_USER) {
+            turns.push({ role: "user", text });
+        }
+        else if (bubble.type === BUBBLE_TYPE_ASSISTANT) {
+            turns.push({ role: "assistant", text });
+        }
+    }
+    if (turns.length === 0)
+        return null;
+    const content = turns
+        .map((t) => `${t.role === "user" ? "User" : "Assistant"}: ${t.text}`)
+        .join("\n\n");
+    const name = body?.name?.trim();
+    const firstUser = turns.find((t) => t.role === "user");
+    const rawTitle = name || firstUser?.text.slice(0, 120) || "Cursor session";
+    const title = rawTitle.includes("\n") ? rawTitle.split("\n")[0] : rawTitle;
+    const createdAt = epochMsToIso(body?.createdAt) ?? new Date(0).toISOString();
+    return { id: composerId, title, createdAt, content };
+}
+//# sourceMappingURL=cursor-store.js.map

package/dist/src/ingestion/cursor/cursor-store.js.map

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

package/dist/src/ingestion/cursor/enrich-roots.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared project-root enrichment for native Cursor sessions.
+ *
+ * Pure discovery (`discoverCursorComposerSessions`) resolves a project root only
+ * from the inline header `uri` (current Cursor builds) and never touches the
+ * filesystem. Legacy builds omit that inline uri, leaving the candidate
+ * `unresolved`. This helper upgrades those by joining the workspace id to the
+ * on-disk `workspace.json` — READ-ONLY, and only for `unresolved` candidates, so
+ * inline-resolved rows are left untouched.
+ *
+ * Used by both `rift cursor-probe` (inspection) and the auto-capture bridge so
+ * the two agree on exactly which sessions are project-attributable.
+ */
+import type { CursorSessionCandidate } from "./cursor-store.js";
+export declare function enrichCursorProjectRoots(candidates: CursorSessionCandidate[], cursorDir: string): CursorSessionCandidate[];
+//# sourceMappingURL=enrich-roots.d.ts.map

package/dist/src/ingestion/cursor/enrich-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-roots.d.ts","sourceRoot":"","sources":["../../../../src/ingestion/cursor/enrich-roots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,sBAAsB,EAAE,EACpC,SAAS,EAAE,MAAM,GAChB,sBAAsB,EAAE,CAiB1B"}

package/dist/src/ingestion/cursor/enrich-roots.js

@@ -0,0 +1,22 @@
+import { resolveProjectRootByWorkspaceId } from "./workspace-root.js";
+export function enrichCursorProjectRoots(candidates, cursorDir) {
+    return candidates.map((c) => {
+        if (c.projectRootStatus !== "unresolved" || !c.workspaceId)
+            return c;
+        const r = resolveProjectRootByWorkspaceId(cursorDir, c.workspaceId);
+        if (r.status === "resolved") {
+            return {
+                ...c,
+                projectRoot: r.root,
+                projectRootSource: r.source,
+                projectRootStatus: r.status,
+            };
+        }
+        // A non-`resolved`, non-`unresolved` on-disk outcome (empty_window /
+        // multi_root / remote) is still more informative than bare `unresolved`.
+        if (r.status !== "unresolved")
+            return { ...c, projectRootStatus: r.status };
+        return c;
+    });
+}
+//# sourceMappingURL=enrich-roots.js.map

package/dist/src/ingestion/cursor/enrich-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-roots.js","sourceRoot":"","sources":["../../../../src/ingestion/cursor/enrich-roots.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,UAAU,wBAAwB,CACtC,UAAoC,EACpC,SAAiB;IAEjB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,iBAAiB,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,GAAG,+BAA+B,CAAC,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QACpE,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,CAAC;gBACJ,WAAW,EAAE,CAAC,CAAC,IAAI;gBACnB,iBAAiB,EAAE,CAAC,CAAC,MAAM;gBAC3B,iBAAiB,EAAE,CAAC,CAAC,MAAM;aAC5B,CAAC;QACJ,CAAC;QACD,qEAAqE;QACrE,yEAAyE;QACzE,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/ingestion/cursor/vscdb-reader.d.ts

@@ -0,0 +1,32 @@
+import type { CursorRawRows } from "./cursor-store.js";
+/** Default macOS location of Cursor's per-user application support dir. */
+export declare function defaultCursorDir(): string;
+/** Global KV store path under a Cursor application-support dir. */
+export declare function globalStatePath(cursorDir: string): string;
+export interface CursorReadResult {
+    /** Absolute path of the db that was read. */
+    dbPath: string;
+    /** Raw rows for the pure discovery layer. */
+    rows: CursorRawRows;
+}
+export declare class CursorReaderError extends Error {
+    readonly code: "sqlite_missing" | "db_missing" | "query_failed";
+    constructor(message: string, code: "sqlite_missing" | "db_missing" | "query_failed");
+}
+export interface ReadOptions {
+    /** Cursor application-support dir; defaults to the standard macOS path. */
+    cursorDir?: string;
+    /**
+     * When true, ALSO fetch bubble bodies (`bubbleId:*`) — the actual message
+     * text. Off by default: discovery never needs private content. Only enable
+     * when the caller has acknowledged it will read prose (e.g. parse round-trip).
+     */
+    includeBubbles?: boolean;
+}
+/**
+ * Read the global Cursor state.vscdb read-only and return raw rows for the pure
+ * discovery layer. Throws {@link CursorReaderError} with a stable `code` for the
+ * three expected failure modes so callers can render friendly guidance.
+ */
+export declare function readCursorGlobalState(options?: ReadOptions): CursorReadResult;
+//# sourceMappingURL=vscdb-reader.d.ts.map

package/dist/src/ingestion/cursor/vscdb-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscdb-reader.d.ts","sourceRoot":"","sources":["../../../../src/ingestion/cursor/vscdb-reader.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAGxC,QAAQ,CAAC,IAAI,EACT,gBAAgB,GAChB,YAAY,GACZ,cAAc;gBAJlB,OAAO,EAAE,MAAM,EACN,IAAI,EACT,gBAAgB,GAChB,YAAY,GACZ,cAAc;CAKrB;AAmDD,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,WAAgB,GAAG,gBAAgB,CA+CjF"}

package/dist/src/ingestion/cursor/vscdb-reader.js

@@ -0,0 +1,113 @@
+/**
+ * Read-only reader for Cursor's `state.vscdb` SQLite stores.
+ *
+ * DISCOVERY SLICE ONLY — this is the single I/O boundary for Cursor capture.
+ * It is deliberately read-only by THREE independent guarantees:
+ *   1. SQLite is opened with the `immutable=1` URI flag, which forbids any
+ *      write and never creates/touches the -wal/-shm sidecar files.
+ *   2. Only SELECT statements are ever issued.
+ *   3. We shell out to the system `sqlite3` binary rather than linking a
+ *      writable driver. (Cursor itself holds the db open under WAL; immutable
+ *      lets us read a consistent snapshot without contending for the lock.)
+ *
+ * Why shell out instead of a native dep: Rift's Node engine floor still
+ * includes Node 20 (no `node:sqlite`), and we don't want to pull a native
+ * addon (better-sqlite3) into the tree for a read-only probe. macOS always
+ * ships `/usr/bin/sqlite3`, and Cursor is macOS-first. The future capture slice
+ * can revisit this (node:sqlite once the floor rises). See the discovery doc.
+ *
+ * PRIVACY: by default we fetch only the session index + per-session metadata
+ * (`composer.composerHeaders`, `composerData:*`). We never SELECT `cursorAuth/*`
+ * (access/refresh tokens) or `secret://*` (MCP OAuth secrets), and we do not
+ * fetch bubble bodies (`bubbleId:*`, the actual message text) unless the caller
+ * explicitly opts in.
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** Default macOS location of Cursor's per-user application support dir. */
+export function defaultCursorDir() {
+    return path.join(os.homedir(), "Library", "Application Support", "Cursor");
+}
+/** Global KV store path under a Cursor application-support dir. */
+export function globalStatePath(cursorDir) {
+    return path.join(cursorDir, "User", "globalStorage", "state.vscdb");
+}
+export class CursorReaderError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "CursorReaderError";
+    }
+}
+function sqlite3Available() {
+    try {
+        execFileSync("sqlite3", ["--version"], { stdio: ["ignore", "ignore", "ignore"] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a single SELECT against an immutable (read-only) view of the db and
+ * return rows as objects. Uses `.mode json` so values come back as strings.
+ */
+function selectJson(dbPath, sql) {
+    const uri = `file:${dbPath}?immutable=1`;
+    let stdout;
+    try {
+        stdout = execFileSync("sqlite3", ["-cmd", ".mode json", uri, sql], {
+            encoding: "utf-8",
+            maxBuffer: 256 * 1024 * 1024, // composer blobs can be large
+        });
+    }
+    catch (err) {
+        throw new CursorReaderError(`sqlite3 query failed: ${err instanceof Error ? err.message : String(err)}`, "query_failed");
+    }
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return [];
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (err) {
+        throw new CursorReaderError(`failed to parse sqlite3 JSON output: ${err instanceof Error ? err.message : String(err)}`, "query_failed");
+    }
+}
+function toKvRows(records) {
+    const rows = [];
+    for (const rec of records) {
+        if (typeof rec.key === "string" && typeof rec.value === "string") {
+            rows.push({ key: rec.key, value: rec.value });
+        }
+    }
+    return rows;
+}
+/**
+ * Read the global Cursor state.vscdb read-only and return raw rows for the pure
+ * discovery layer. Throws {@link CursorReaderError} with a stable `code` for the
+ * three expected failure modes so callers can render friendly guidance.
+ */
+export function readCursorGlobalState(options = {}) {
+    const cursorDir = options.cursorDir ?? defaultCursorDir();
+    const dbPath = globalStatePath(cursorDir);
+    if (!fs.existsSync(dbPath)) {
+        throw new CursorReaderError(`Cursor state.vscdb not found at ${dbPath}`, "db_missing");
+    }
+    if (!sqlite3Available()) {
+        throw new CursorReaderError("The `sqlite3` binary is required to read Cursor's store but was not found on PATH.", "sqlite_missing");
+    }
+    // Session index (ItemTable). Single, small row.
+    const itemTable = toKvRows(selectJson(dbPath, "SELECT key, value FROM ItemTable WHERE key = 'composer.composerHeaders'"));
+    // Per-session metadata (cursorDiskKV). Small; never tokens/secrets.
+    const composerData = toKvRows(selectJson(dbPath, "SELECT key, value FROM cursorDiskKV WHERE key LIKE 'composerData:%'"));
+    const cursorDiskKV = [...composerData];
+    if (options.includeBubbles) {
+        cursorDiskKV.push(...toKvRows(selectJson(dbPath, "SELECT key, value FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'")));
+    }
+    return { dbPath, rows: { itemTable, cursorDiskKV } };
+}
+//# sourceMappingURL=vscdb-reader.js.map

package/dist/src/ingestion/cursor/vscdb-reader.js.map

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

package/dist/src/ingestion/cursor/workspace-root.d.ts

@@ -0,0 +1,96 @@
+/** Sentinel `workspaceIdentifier.id` Cursor uses when no folder is open. */
+export declare const EMPTY_WINDOW_ID = "empty-window";
+/** The `uri` object Cursor embeds in a folder-bound composer header. */
+export interface CursorWorkspaceUri {
+    scheme?: string;
+    fsPath?: string;
+    path?: string;
+    external?: string;
+}
+/** A composer header's `workspaceIdentifier` (id + optional inline uri). */
+export interface CursorWorkspaceIdentifier {
+    id?: string;
+    uri?: CursorWorkspaceUri | null;
+}
+/**
+ * Outcome of resolving a workspace identifier to a project root. Every
+ * non-`resolved` status is a deliberate, named outcome — the capture slice must
+ * branch on these rather than ever fabricate a root.
+ */
+export type ProjectRootResolution = {
+    status: "resolved";
+    /** Absolute filesystem path of the project root. */
+    root: string;
+    /** Which link produced the root. */
+    source: "header_uri" | "workspace_json";
+    workspaceId: string | null;
+}
+/** No folder open (`empty-window`). Expected; not attributable. */
+ | {
+    status: "empty_window";
+    workspaceId: "empty-window";
+}
+/** Multi-root `.code-workspace`; root ambiguous. */
+ | {
+    status: "multi_root";
+    workspaceId: string;
+    configPath: string | null;
+}
+/** Non-`file` scheme (remote/ssh/wsl/devcontainer); not a local path. */
+ | {
+    status: "remote";
+    workspaceId: string | null;
+    scheme: string;
+}
+/** Id present but no inline uri and no readable `workspace.json`. */
+ | {
+    status: "unresolved";
+    workspaceId: string | null;
+};
+/**
+ * Parse a `workspace.json` file's text. Returns the folder root (single-folder
+ * window), a multi-root marker (`.code-workspace`), or unknown. Pure.
+ */
+export declare function parseWorkspaceJson(text: string): {
+    kind: "folder";
+    scheme: string | null;
+    root: string | null;
+} | {
+    kind: "multi_root";
+    configPath: string | null;
+} | {
+    kind: "unknown";
+};
+/** Injected dependencies for the pure resolver. */
+export interface ResolveOptions {
+    /**
+     * Returns the raw text of `workspaceStorage/<id>/workspace.json`, or null if
+     * absent. Injected so the resolver stays pure and fully fixture-testable.
+     * Used only as a fallback when the header carries no inline uri.
+     */
+    readWorkspaceJson?: (workspaceId: string) => string | null;
+}
+/**
+ * Resolve a composer header's `workspaceIdentifier` to a project root. Pure:
+ * the only I/O is the injected {@link ResolveOptions.readWorkspaceJson}. Tries
+ * the inline header uri first (current builds), then the on-disk
+ * `workspace.json` join (legacy builds / uri stripped). Never guesses — every
+ * non-resolvable case maps to an explicit status.
+ */
+export declare function resolveProjectRoot(identifier: CursorWorkspaceIdentifier | null | undefined, options?: ResolveOptions): ProjectRootResolution;
+/** Path to a workspace's `workspace.json` under a Cursor app-support dir. */
+export declare function workspaceJsonPath(cursorDir: string, workspaceId: string): string;
+/** Read `workspace.json` text read-only; null if it does not exist / unreadable. */
+export declare function readWorkspaceJsonFromDisk(cursorDir: string, workspaceId: string): string | null;
+/**
+ * Filesystem-backed resolution: resolve a header's identifier against a real
+ * Cursor app-support dir, reading `workspace.json` read-only when needed.
+ */
+export declare function resolveCursorProjectRoot(identifier: CursorWorkspaceIdentifier | null | undefined, cursorDir: string): ProjectRootResolution;
+/**
+ * Resolve a project root from a workspace id alone (no inline uri available).
+ * Used by the probe to upgrade `unresolved` discovery candidates on legacy
+ * builds via the on-disk `workspace.json` join.
+ */
+export declare function resolveProjectRootByWorkspaceId(cursorDir: string, workspaceId: string): ProjectRootResolution;
+//# sourceMappingURL=workspace-root.d.ts.map

package/dist/src/ingestion/cursor/workspace-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-root.d.ts","sourceRoot":"","sources":["../../../../src/ingestion/cursor/workspace-root.ts"],"names":[],"mappings":"AAsDA,4EAA4E;AAC5E,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACxC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AACH,mEAAmE;GACjE;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,cAAc,CAAA;CAAE;AACzD,oDAAoD;GAClD;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAC1E,yEAAyE;GACvE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAClE,qEAAqE;GACnE;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAoCzD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAEV;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAkBtB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxD,OAAO,GAAE,cAAmB,GAC3B,qBAAqB,CAqCvB;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAMf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,EACxD,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAIvB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAEvB"}