@rewind-ai/cli 0.6.2

package/dist/src/session/process.js

@@ -0,0 +1,234 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function run(cmd, args, timeoutMs = 5000) {
+    try {
+        const { stdout, stderr } = await execFileAsync(cmd, args, {
+            timeout: timeoutMs,
+            maxBuffer: 8 * 1024 * 1024,
+            encoding: "utf8",
+        });
+        return { stdout: stdout ?? "", stderr: stderr ?? "" };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: e.stdout ?? "",
+            stderr: e.stderr ?? "",
+            error: e.message ?? String(err),
+        };
+    }
+}
+function parsePs(stdout) {
+    const lines = stdout.split("\n").filter((l) => l.trim().length > 0);
+    // Expect: PID PPID USER COMMAND...  (command may contain spaces if we use -o args=)
+    const out = [];
+    for (const line of lines) {
+        const m = line.match(/^\s*(\d+)\s+(\d+)\s+(\S+)\s+(.*)$/);
+        if (!m)
+            continue;
+        const pid = Number(m[1]);
+        const ppid = Number(m[2]);
+        const user = m[3];
+        const rest = m[4].trim();
+        if (!Number.isFinite(pid))
+            continue;
+        out.push({
+            pid,
+            ppid,
+            user,
+            command: rest.split(/\s+/)[0] ?? rest,
+            args: rest,
+        });
+    }
+    return out;
+}
+function isCursorRelated(p) {
+    const hay = `${p.command} ${p.args ?? ""}`.toLowerCase();
+    return (hay.includes("cursor") ||
+        hay.includes("cursor helper") ||
+        hay.includes("cursor agent") ||
+        /\/cursor\.app\//i.test(hay));
+}
+function buildTrees(processes, rootPids) {
+    const byParent = new Map();
+    for (const p of processes) {
+        const list = byParent.get(p.ppid) ?? [];
+        list.push(p);
+        byParent.set(p.ppid, list);
+    }
+    const build = (p, depth) => {
+        const children = depth > 12
+            ? []
+            : (byParent.get(p.pid) ?? []).map((c) => build(c, depth + 1));
+        return {
+            pid: p.pid,
+            ppid: p.ppid,
+            command: p.args ?? p.command,
+            children,
+        };
+    };
+    const byPid = new Map(processes.map((p) => [p.pid, p]));
+    const roots = [];
+    for (const pid of rootPids) {
+        const p = byPid.get(pid);
+        if (p)
+            roots.push(build(p, 0));
+    }
+    return roots;
+}
+export function formatProcessTree(nodes, indent = "") {
+    const lines = [];
+    for (const n of nodes) {
+        lines.push(`${indent}${n.command} (pid ${n.pid})`);
+        if (n.children.length) {
+            lines.push(formatProcessTree(n.children, indent + "  "));
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Snapshot process table and attempt to identify Cursor-related hierarchy.
+ * Honest: may fail under sandbox/TCC; errors are recorded, not invented.
+ */
+export async function captureProcessSnapshot() {
+    const notes = [];
+    const errors = [];
+    const capturedAt = new Date().toISOString();
+    // Prefer args-capable listing; fall back to comm-only.
+    let ps = await run("/bin/ps", ["-axo", "pid=,ppid=,user=,args="]);
+    if (ps.error && !ps.stdout) {
+        errors.push(`ps args failed: ${ps.error}`);
+        ps = await run("/bin/ps", ["-axo", "pid=,ppid=,user=,comm="]);
+    }
+    if (ps.error && !ps.stdout) {
+        errors.push(`ps failed: ${ps.error}`);
+    }
+    const processes = parsePs(ps.stdout);
+    if (processes.length === 0) {
+        notes.push("Process list empty or inaccessible — TCC/sandbox may block process enumeration.");
+    }
+    const cursorRelated = processes.filter(isCursorRelated);
+    notes.push(cursorRelated.length > 0
+        ? `Found ${cursorRelated.length} Cursor-related process(es).`
+        : "No Cursor-related processes matched name heuristics in process table.");
+    // Root candidates: Cursor main app processes (shortest path / no Cursor parent)
+    const cursorPids = new Set(cursorRelated.map((p) => p.pid));
+    const roots = new Set();
+    for (const p of cursorRelated) {
+        if (!cursorPids.has(p.ppid))
+            roots.add(p.pid);
+    }
+    const treeRoots = buildTrees(processes, roots);
+    // lsof probe: who has the sandbox open? Caller may pass path via separate fn.
+    return {
+        capturedAt,
+        processes: cursorRelated.length
+            ? // Keep full table only if manageable; otherwise store cursor-related + sample
+                processes.length > 2000
+                    ? cursorRelated
+                    : processes
+            : processes.slice(0, 500),
+        cursorRelated,
+        treeRoots,
+        notes,
+        errors,
+    };
+}
+/**
+ * Use lsof to find processes with open handles under a path.
+ * This is correlative / weak: short writes often leave no open handle.
+ * Avoid `lsof +D` — it recursively walks and can hang on large trees.
+ */
+export async function lsofSandboxHolders(sandboxPath) {
+    // Bound tightly: lsof without +D on the directory node + a filtered full listing sample.
+    const direct = await run("/usr/sbin/lsof", ["-nP", sandboxPath], 2500);
+    const filtered = await run("/bin/sh", [
+        "-c",
+        // shell-escape path lightly
+        `lsof -nP 2>/dev/null | grep -F -- ${JSON.stringify(sandboxPath)} | head -n 40`,
+    ], 3000);
+    const combined = [direct.stdout, filtered.stdout]
+        .join("\n")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+    const data = combined.filter((l) => !l.startsWith("COMMAND"));
+    const pids = [];
+    for (const line of data) {
+        const parts = line.split(/\s+/);
+        const pid = Number(parts[1]);
+        if (Number.isFinite(pid))
+            pids.push(pid);
+    }
+    const err = direct.error && filtered.error
+        ? `${direct.error}; ${filtered.error}`
+        : direct.error || filtered.error;
+    if (err && data.length === 0) {
+        return {
+            lines: [],
+            pids: [],
+            error: err,
+            note: "lsof failed or denied — cannot correlate open handles.",
+        };
+    }
+    return {
+        lines: [...new Set(data)].slice(0, 100),
+        pids: [...new Set(pids)],
+        note: data.length === 0
+            ? "lsof found no open handles under sandbox (common for completed short writes)."
+            : `lsof found ${data.length} open handle line(s) (non-recursive probe).`,
+    };
+}
+/**
+ * Probe whether eslogger / Endpoint Security is usable without entitlements.
+ */
+export async function probeEndpointSecurityAccess() {
+    const which = await run("/usr/bin/which", ["eslogger"]);
+    if (!which.stdout.trim()) {
+        return {
+            available: false,
+            detail: "eslogger binary not found",
+            tested: true,
+        };
+    }
+    const probe = await run("/usr/bin/eslogger", ["--list-events"], 3000);
+    // Creating an ES client requires root; this call should fail fast when unprivileged.
+    // Do not leave eslogger running as an event stream.
+    const create = await run("/usr/bin/eslogger", ["create"], 1500);
+    const createText = `${create.stdout} ${create.stderr} ${create.error ?? ""}`;
+    const detail = [
+        `eslogger present: ${which.stdout.trim()}`,
+        probe.error
+            ? `list-events: ${probe.error}`
+            : `list-events: ok (${probe.stdout.split("\n").filter(Boolean).length} event types)`,
+        `create-probe: ${createText.trim().slice(0, 300) || "no output"}`,
+    ].join(" | ");
+    const available = !/Not privileged|NOT_PRIVILEGED|Full Disk Access|NOT_PERMITTED|Operation not permitted|killed|ETIMEOUT|timeout/i.test(createText) && /\{|"event"/.test(createText);
+    return {
+        available,
+        detail,
+        tested: true,
+    };
+}
+/**
+ * Try fs_usage briefly — usually requires root.
+ */
+export async function probeFsUsage() {
+    // fs_usage usually needs root; execFile timeout kills the child on macOS (no GNU timeout).
+    const result = await run("/usr/bin/fs_usage", ["-w", "-t", "1"], 2000);
+    const text = `${result.stdout} ${result.stderr} ${result.error ?? ""}`;
+    if (/permission|privileged|sudo|must be root|not permitted/i.test(text)) {
+        return {
+            usable: false,
+            detail: text.trim().slice(0, 400) || "fs_usage failed",
+            tested: true,
+        };
+    }
+    return {
+        usable: /open|write|read|fs_usage/i.test(result.stdout),
+        detail: text.trim().slice(0, 400) || "fs_usage produced no usable output",
+        tested: true,
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/src/session/process.js.map

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

package/dist/src/session/store.d.ts

@@ -0,0 +1,14 @@
+import type { ActiveSessionPointer, ObservedEvent, RewindSession } from "./types.js";
+export declare function sessionDir(sessionId: string, projectRoot?: string): string;
+export declare function ensureSessionsRoot(projectRoot?: string): Promise<string>;
+export declare function saveSession(session: RewindSession, projectRoot?: string): Promise<string>;
+export declare function loadSession(sessionId?: string | "latest", projectRoot?: string): Promise<RewindSession>;
+export declare function appendEvent(sessionId: string, event: ObservedEvent, projectRoot?: string): Promise<void>;
+export declare function readEvents(sessionId: string, projectRoot?: string): Promise<ObservedEvent[]>;
+export declare function activePointerPath(projectRoot?: string): string;
+export declare function writeActivePointer(pointer: ActiveSessionPointer, projectRoot?: string): Promise<void>;
+export declare function readActivePointer(projectRoot?: string): Promise<ActiveSessionPointer | null>;
+export declare function clearActivePointer(projectRoot?: string): Promise<void>;
+export declare function requestStop(projectRoot?: string): Promise<ActiveSessionPointer>;
+export declare function stopFlagExists(sessionId: string, projectRoot?: string): Promise<boolean>;
+export declare function clearStopFlag(sessionId: string, projectRoot?: string): Promise<void>;

package/dist/src/session/store.js

@@ -0,0 +1,125 @@
+import path from "node:path";
+import { mkdir, readFile, writeFile, appendFile, rm, access, } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import { getProjectRoot, getSessionsDir, PathSafetyError, } from "../paths.js";
+function assertSafeSessionId(id) {
+    if (id.includes("..") ||
+        id.includes("/") ||
+        id.includes("\\") ||
+        id.includes("\0") ||
+        id.length === 0 ||
+        id.length > 120 ||
+        !/^sess-[A-Za-z0-9-]+$/.test(id)) {
+        throw new PathSafetyError(`Invalid session id: ${id}`);
+    }
+    return id;
+}
+export function sessionDir(sessionId, projectRoot = getProjectRoot()) {
+    return path.join(getSessionsDir(projectRoot), assertSafeSessionId(sessionId));
+}
+export async function ensureSessionsRoot(projectRoot = getProjectRoot()) {
+    const dir = getSessionsDir(projectRoot);
+    await mkdir(dir, { recursive: true });
+    return dir;
+}
+async function writeJsonAtomic(file, data) {
+    await mkdir(path.dirname(file), { recursive: true });
+    const tmp = `${file}.tmp-${process.pid}`;
+    await writeFile(tmp, JSON.stringify(data, null, 2) + "\n", "utf8");
+    const { rename } = await import("node:fs/promises");
+    await rename(tmp, file);
+}
+export async function saveSession(session, projectRoot = getProjectRoot()) {
+    const dir = sessionDir(session.id, projectRoot);
+    await mkdir(dir, { recursive: true });
+    const file = path.join(dir, "session.json");
+    await writeJsonAtomic(file, session);
+    await writeJsonAtomic(path.join(getSessionsDir(projectRoot), "latest.json"), {
+        id: session.id,
+    });
+    return file;
+}
+export async function loadSession(sessionId = "latest", projectRoot = getProjectRoot()) {
+    let id = sessionId;
+    if (sessionId === "latest") {
+        const latestPath = path.join(getSessionsDir(projectRoot), "latest.json");
+        try {
+            const raw = await readFile(latestPath, "utf8");
+            id = JSON.parse(raw).id;
+        }
+        catch {
+            throw new PathSafetyError("No session found. Start one with session start.");
+        }
+    }
+    const file = path.join(sessionDir(id, projectRoot), "session.json");
+    try {
+        const raw = await readFile(file, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new PathSafetyError(`Session not found or unreadable: ${id}`);
+    }
+}
+export async function appendEvent(sessionId, event, projectRoot = getProjectRoot()) {
+    const file = path.join(sessionDir(sessionId, projectRoot), "events.jsonl");
+    await mkdir(path.dirname(file), { recursive: true });
+    await appendFile(file, JSON.stringify(event) + "\n", "utf8");
+}
+export async function readEvents(sessionId, projectRoot = getProjectRoot()) {
+    const file = path.join(sessionDir(sessionId, projectRoot), "events.jsonl");
+    try {
+        const raw = await readFile(file, "utf8");
+        return raw
+            .split("\n")
+            .filter((l) => l.trim())
+            .map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+export function activePointerPath(projectRoot = getProjectRoot()) {
+    return path.join(getSessionsDir(projectRoot), "active.json");
+}
+export async function writeActivePointer(pointer, projectRoot = getProjectRoot()) {
+    await ensureSessionsRoot(projectRoot);
+    await writeJsonAtomic(activePointerPath(projectRoot), pointer);
+}
+export async function readActivePointer(projectRoot = getProjectRoot()) {
+    try {
+        const raw = await readFile(activePointerPath(projectRoot), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function clearActivePointer(projectRoot = getProjectRoot()) {
+    await rm(activePointerPath(projectRoot), { force: true });
+}
+export async function requestStop(projectRoot = getProjectRoot()) {
+    const active = await readActivePointer(projectRoot);
+    if (!active) {
+        throw new PathSafetyError("No active session to stop.");
+    }
+    active.stopRequested = true;
+    await writeActivePointer(active, projectRoot);
+    // Also write a stop flag file the watcher polls
+    await writeFile(path.join(sessionDir(active.id, projectRoot), "STOP"), new Date().toISOString() + "\n", "utf8");
+    return active;
+}
+export async function stopFlagExists(sessionId, projectRoot = getProjectRoot()) {
+    try {
+        await access(path.join(sessionDir(sessionId, projectRoot), "STOP"), fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function clearStopFlag(sessionId, projectRoot = getProjectRoot()) {
+    await rm(path.join(sessionDir(sessionId, projectRoot), "STOP"), {
+        force: true,
+    });
+}
+//# sourceMappingURL=store.js.map

package/dist/src/session/store.js.map

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

package/dist/src/session/types.d.ts

@@ -0,0 +1,111 @@
+/** V1 session / attribution types. Extends V0 concepts without replacing them. */
+import type { Change } from "../types.js";
+export type ObservedEventType = "CREATE" | "MODIFY" | "DELETE" | "RENAME" | "DIRECTORY_CREATE" | "DIRECTORY_DELETE" | "UNKNOWN";
+export type ActorKind = "AGENT" | "USER" | "SYSTEM" | "UNKNOWN";
+export type AttributionConfidence = "HIGH" | "MEDIUM" | "LOW" | "NONE";
+export type SessionStatus = "watching" | "stopping" | "completed" | "rewound" | "failed" | "crashed";
+export interface AttributionEvidence {
+    kind: string;
+    detail: string;
+    observedAt?: string;
+}
+export interface ProcessInfo {
+    pid: number;
+    ppid: number;
+    user: string;
+    command: string;
+    args?: string;
+}
+export interface ProcessSnapshot {
+    capturedAt: string;
+    processes: ProcessInfo[];
+    cursorRelated: ProcessInfo[];
+    treeRoots: ProcessTreeNode[];
+    notes: string[];
+    errors: string[];
+}
+export interface ProcessTreeNode {
+    pid: number;
+    ppid: number;
+    command: string;
+    children: ProcessTreeNode[];
+}
+export interface ObservedEvent {
+    id: string;
+    at: string;
+    type: ObservedEventType;
+    path: string;
+    pathFrom?: string;
+    /** Coalesced raw watcher signals that produced this event. */
+    rawCount: number;
+    /** Attribution guess at observation time — often UNKNOWN. */
+    actor: ActorKind;
+    confidence: AttributionConfidence;
+    evidence: AttributionEvidence[];
+    ambientSuspect: boolean;
+}
+export interface AttributedChange {
+    change: Change;
+    actor: ActorKind;
+    confidence: AttributionConfidence;
+    evidence: AttributionEvidence[];
+    ambient: boolean;
+    correlatedEvents: string[];
+}
+export interface AttributionSummary {
+    total: number;
+    likelyAgent: number;
+    likelyHuman: number;
+    ambientSystem: number;
+    unknown: number;
+    confidenceHigh: number;
+    confidenceMedium: number;
+    confidenceLow: number;
+    confidenceNone: number;
+}
+export interface SessionMetrics {
+    watcherIdleCpuSample?: number;
+    eventsObserved: number;
+    eventsPerSecondPeak: number;
+    memoryRssMbStart?: number;
+    memoryRssMbEnd?: number;
+    checkpointMs?: number;
+    finalDiffMs?: number;
+    rewindMs?: number;
+    watchDurationMs: number;
+}
+export interface RewindSession {
+    id: string;
+    version: 1;
+    targetPath: string;
+    checkpointId: string;
+    checkpointFingerprint: string;
+    startedAt: string;
+    endedAt: string | null;
+    watcherPid: number | null;
+    observedEvents: ObservedEvent[];
+    finalChanges: Change[];
+    attributedChanges: AttributedChange[];
+    processes: ProcessSnapshot[];
+    attributionConfidenceOverall: AttributionConfidence;
+    attributionSummary: AttributionSummary | null;
+    status: SessionStatus;
+    metrics: SessionMetrics;
+    notes: string[];
+    /** Selective agent-only rewind is intentionally gated. */
+    selectiveRewindEnabled: boolean;
+    selectiveRewindReason: string;
+}
+export interface ActiveSessionPointer {
+    id: string;
+    watcherPid: number;
+    startedAt: string;
+    targetPath: string;
+    checkpointId: string;
+    stopRequested: boolean;
+}
+export interface SessionReport {
+    session: RewindSession;
+    lines: string[];
+}
+export type { Change };

package/dist/src/session/types.js

@@ -0,0 +1,3 @@
+/** V1 session / attribution types. Extends V0 concepts without replacing them. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/session/types.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/src/session/watcher.d.ts

@@ -0,0 +1,32 @@
+import type { ObservedEvent } from "./types.js";
+export interface WatcherStats {
+    rawSignals: number;
+    emittedEvents: number;
+    peakEventsPerSec: number;
+}
+export type WatchEventHandler = (event: ObservedEvent) => void;
+/**
+ * Live sandbox watcher.
+ * Uses chokidar (FSEvents on macOS) with debounce/coalesce.
+ * Events are signals — final manifest diff remains authoritative.
+ */
+export declare class SandboxWatcher {
+    private readonly sandboxRoot;
+    private readonly onEvent;
+    private watcher;
+    private pending;
+    private closed;
+    private readonly debounceMs;
+    readonly stats: WatcherStats;
+    private windowCount;
+    private windowTimer;
+    constructor(sandboxRoot: string, onEvent: WatchEventHandler, options?: {
+        debounceMs?: number;
+        projectRoot?: string;
+    });
+    start(projectRoot?: string): Promise<void>;
+    private handleRaw;
+    private flush;
+    private classify;
+    stop(): Promise<WatcherStats>;
+}