@rewind-ai/cli 0.6.2

package/dist/src/session/attribution.js

@@ -0,0 +1,201 @@
+import { matchAmbientPath } from "./ambient.js";
+function emptySummary() {
+    return {
+        total: 0,
+        likelyAgent: 0,
+        likelyHuman: 0,
+        ambientSystem: 0,
+        unknown: 0,
+        confidenceHigh: 0,
+        confidenceMedium: 0,
+        confidenceLow: 0,
+        confidenceNone: 0,
+    };
+}
+function bumpConfidence(s, c) {
+    switch (c) {
+        case "HIGH":
+            s.confidenceHigh++;
+            break;
+        case "MEDIUM":
+            s.confidenceMedium++;
+            break;
+        case "LOW":
+            s.confidenceLow++;
+            break;
+        case "NONE":
+            s.confidenceNone++;
+            break;
+    }
+}
+function changePaths(c) {
+    const out = [];
+    if (c.pathBefore)
+        out.push(c.pathBefore);
+    if (c.pathAfter)
+        out.push(c.pathAfter);
+    return out;
+}
+/**
+ * Correlate authoritative manifest diffs with watcher signals + weak process hints.
+ *
+ * Honesty rules:
+ * - Do NOT label AGENT just because Cursor is running.
+ * - Ambient filename patterns → SYSTEM / MEDIUM with explicit evidence.
+ * - Watcher-only correlation → UNKNOWN / NONE or LOW if temporally near events.
+ * - lsof open-handle matches (if provided via evidence on events) can raise LOW→MEDIUM.
+ * - Without Endpoint Security / responsible-PID metadata, HIGH agent confidence is unreachable.
+ */
+export function attributeChanges(options) {
+    const notes = [];
+    const knownHuman = new Set(options.knownHumanPaths ?? []);
+    const knownSelf = new Set(options.knownSelfWritePaths ?? []);
+    const cursorSeen = options.processSnapshots.some((s) => s.cursorRelated.length > 0);
+    if (cursorSeen) {
+        notes.push("Cursor-related processes were observed during the session, but FSEvents does not include responsible PID — presence alone is NOT attribution.");
+    }
+    else {
+        notes.push("No Cursor-related processes were identified in snapshots (or process listing was unavailable).");
+    }
+    const eventsByPath = new Map();
+    for (const ev of options.events) {
+        const list = eventsByPath.get(ev.path) ?? [];
+        list.push(ev);
+        eventsByPath.set(ev.path, list);
+    }
+    const attributed = [];
+    const summary = emptySummary();
+    summary.total = options.changes.length;
+    for (const change of options.changes) {
+        const paths = changePaths(change);
+        const correlated = [];
+        for (const p of paths) {
+            const evs = eventsByPath.get(p);
+            if (evs)
+                correlated.push(...evs);
+        }
+        const evidence = [];
+        let actor = "UNKNOWN";
+        let confidence = "NONE";
+        let ambient = false;
+        // Authoritative ambient basename check on final paths
+        for (const p of paths) {
+            const m = matchAmbientPath(p);
+            if (m.ambient) {
+                ambient = true;
+                evidence.push({
+                    kind: "ambient_filename_pattern",
+                    detail: m.evidence,
+                });
+            }
+        }
+        if (correlated.length > 0) {
+            evidence.push({
+                kind: "watcher_correlation",
+                detail: `${correlated.length} coalesced watcher event(s) touched path(s)`,
+            });
+            for (const ev of correlated) {
+                evidence.push(...ev.evidence);
+            }
+        }
+        else {
+            evidence.push({
+                kind: "no_watcher_event",
+                detail: "Final diff path had no correlated live watcher event (missed/coalesced/pre-watch).",
+            });
+        }
+        // Fixture / test markers — only when explicitly provided
+        const humanHit = paths.some((p) => knownHuman.has(p));
+        const selfHit = paths.some((p) => knownSelf.has(p));
+        if (humanHit) {
+            actor = "USER";
+            confidence = "HIGH";
+            evidence.push({
+                kind: "explicit_human_marker",
+                detail: "Path marked as human-originated in concurrent-change test harness",
+            });
+        }
+        else if (selfHit) {
+            actor = "AGENT";
+            confidence = "HIGH";
+            evidence.push({
+                kind: "explicit_self_write_marker",
+                detail: "Path marked as written by controlled REWIND demo tool (not inferred from OS)",
+            });
+        }
+        else if (ambient) {
+            actor = "SYSTEM";
+            confidence = "MEDIUM";
+        }
+        else {
+            // Default honest outcome without ES/responsible PID
+            actor = "UNKNOWN";
+            confidence = correlated.length > 0 ? "NONE" : "NONE";
+            evidence.push({
+                kind: "no_responsible_pid",
+                detail: "macOS FSEvents/chokidar provides no process ID for the writer; cannot attribute to AGENT vs USER.",
+            });
+            if (cursorSeen) {
+                evidence.push({
+                    kind: "cursor_present_uncorrelated",
+                    detail: "Cursor processes existed during session but were not linked to this write.",
+                });
+                // Tempting to say LOW agent — we refuse. Presence ≠ authorship.
+            }
+        }
+        attributed.push({
+            change,
+            actor,
+            confidence,
+            evidence,
+            ambient,
+            correlatedEvents: correlated.map((e) => e.id),
+        });
+        switch (actor) {
+            case "AGENT":
+                summary.likelyAgent++;
+                break;
+            case "USER":
+                summary.likelyHuman++;
+                break;
+            case "SYSTEM":
+                summary.ambientSystem++;
+                break;
+            case "UNKNOWN":
+                summary.unknown++;
+                break;
+        }
+        bumpConfidence(summary, confidence);
+    }
+    notes.push("Selective agent-only rewind is UNSAFE while most changes remain UNKNOWN.");
+    const overall = summary.confidenceHigh > 0 &&
+        summary.unknown === 0 &&
+        summary.confidenceNone === 0
+        ? "HIGH"
+        : summary.confidenceMedium > summary.total / 2
+            ? "MEDIUM"
+            : summary.total === 0
+                ? "NONE"
+                : "LOW";
+    return { attributed, summary, overall, notes };
+}
+export function printAttributionReport(summary, durationLabel) {
+    console.log("REWIND SESSION COMPLETE");
+    console.log("");
+    console.log(`Duration: ${durationLabel}`);
+    console.log("");
+    console.log(`Final filesystem changes: ${summary.total}`);
+    console.log("");
+    console.log(`Likely agent:    ${summary.likelyAgent}`);
+    console.log(`Likely human:    ${summary.likelyHuman}`);
+    console.log(`Ambient/system:  ${summary.ambientSystem}`);
+    console.log(`Unknown:         ${summary.unknown}`);
+    console.log("");
+    console.log("Attribution confidence:");
+    console.log("");
+    console.log(`High:    ${summary.confidenceHigh}`);
+    console.log(`Medium:  ${summary.confidenceMedium}`);
+    console.log(`Low:     ${summary.confidenceLow}`);
+    console.log(`Unknown: ${summary.confidenceNone}`);
+}
+//# sourceMappingURL=attribution.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { ObservedEvent, RewindSession } from "./types.js";
+export interface StartSessionOptions {
+    projectRoot?: string;
+    /** If true, recreate sandbox before checkpoint. Default false for live Cursor tests. */
+    recreateSandbox?: boolean;
+    /** Auto-stop after N ms (tests). */
+    autoStopMs?: number;
+    /** Paths explicitly marked human for concurrent-change experiments. */
+    knownHumanPaths?: string[];
+    /** Called for each live event (tests). */
+    onEvent?: (ev: ObservedEvent) => void;
+    /** Skip process snapshots (faster tests). */
+    skipProcessSnapshots?: boolean;
+    quiet?: boolean;
+}
+export declare function startSession(options?: StartSessionOptions): Promise<RewindSession>;
+export declare function stopSession(projectRoot?: string): Promise<void>;
+export declare function sessionStatus(projectRoot?: string): Promise<void>;
+export declare function rewindSession(sessionId?: string | "latest", projectRoot?: string): Promise<void>;
+export declare function showSessionReport(sessionId?: string | "latest", projectRoot?: string): Promise<void>;
+export declare function printProcessProbe(projectRoot?: string): Promise<void>;
+/**
+ * Automated V1 demo: watch + synthetic writes + ambient + human marker + full rewind.
+ */
+export declare function demoV1(projectRoot?: string): Promise<void>;