@astralyn/pi 0.84.0 → 0.84.2

package/dist/extensions/rewind/restore.js

@@ -1,94 +0,0 @@
-/**
- * restore.ts — map a /tree navigation target to the snapshot that should be
- * restored and apply it via the engine.
- *
- * Snapshot semantics: a frame anchored at user entry U records the work tree
- * at the moment U's run STARTED (see engine.ts beginTurn). The selection here
- * must mirror AgentSession.navigateTree's leaf rules:
- *
- *   - user / custom_message target: navigateTree removes the target's turn
- *     from the branch (leaf = parent, text returns to the editor) → restore
- *     to the state BEFORE that turn = the snapshot anchored at the target.
- *   - any other target: the target's turn STAYS in the conversation
- *     (leaf = target) → restore to the state AFTER that turn = the first
- *     chronological snapshot anchored at a descendant turn (it recorded the
- *     work tree when the next run began). No such snapshot → nothing was
- *     recorded after the target, so offer no restore at all — falling back to
- *     an ancestor frame would roll back the target turn's own edits and leave
- *     the work tree older than the conversation.
- */
-import { applySnapshot, collectChangeDiffStats, collectChanges, } from "./engine.js";
-/** Cycle guard for parent-chain walks (ids are acyclic in practice). */
-const ANCESTOR_WALK_GUARD = 100_000;
-/** True when `id`'s parent chain passes through `ancestorId` (strict descent). */
-function isDescendantOf(view, id, ancestorId) {
-    let cur = view.getEntry(id)?.parentId ?? null;
-    let guard = 0;
-    while (cur !== null && guard++ < ANCESTOR_WALK_GUARD) {
-        if (cur === ancestorId)
-            return true;
-        cur = view.getEntry(cur)?.parentId ?? null;
-    }
-    return false;
-}
-/**
- * First (chronological) snapshot anchored at a strict descendant of `entryId`
- * — the run that started right after `entryId` existed, so its frame records
- * the work tree state "just after" the entry.
- */
-function snapshotAfterEntry(snapshots, view, entryId) {
-    for (const snap of snapshots) {
-        if (!snap.userEntryId)
-            continue;
-        if (isDescendantOf(view, snap.userEntryId, entryId))
-            return snap;
-    }
-    return undefined;
-}
-/**
- * The snapshot that matches navigating to `targetId`, per the rules in the
- * module header. Undefined when no recorded state corresponds to the target
- * (then the work tree should be left alone).
- */
-export function snapshotForEntry(snapshots, view, targetId) {
-    const target = view.getEntry(targetId);
-    if (!target)
-        return undefined;
-    if (target.isTurnAnchor) {
-        // Exact anchor match: the frame recording the state right before this
-        // turn ran. Chronologically last wins if duplicate anchors exist.
-        let exact;
-        for (const snap of snapshots) {
-            if (snap.userEntryId === targetId)
-                exact = snap;
-        }
-        if (exact)
-            return exact;
-        // No frame for this turn (it recorded no changes): the state before it
-        // equals the state after its parent.
-        return target.parentId === null ? undefined : snapshotAfterEntry(snapshots, view, target.parentId);
-    }
-    return snapshotAfterEntry(snapshots, view, targetId);
-}
-/**
- * Absolute file paths restoring to this snapshot would change on disk (empty =
- * none). Callers use the length for the count and the paths for the preview.
- */
-export function snapshotChangedPaths(sessionId, snapshot) {
-    return collectChanges(sessionId, snapshot);
-}
-/**
- * Coarse +N/−M line stats for the confirm dialog (paths must already be known
- * changed — typically from snapshotChangedPaths).
- */
-export function snapshotChangeDiffStats(sessionId, snapshot, changedPaths) {
-    return collectChangeDiffStats(sessionId, snapshot, changedPaths);
-}
-/**
- * Restore the work tree to `snapshot` and return changed absolute paths.
- * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.
- */
-export async function restoreToSnapshot(sessionId, snapshot, opts) {
-    return applySnapshot(sessionId, snapshot, opts);
-}
-//# sourceMappingURL=restore.js.map

package/dist/extensions/rewind/restore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/extensions/rewind/restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAEN,aAAa,EAEb,sBAAsB,EACtB,cAAc,GACd,MAAM,aAAa,CAAC;AAgBrB,wEAAwE;AACxE,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAEpC,kFAAkF;AAClF,SAAS,cAAc,CAAC,IAAmB,EAAE,EAAU,EAAE,UAAkB;IAC1E,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,KAAK,IAAI,IAAI,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;QACtD,IAAI,GAAG,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACpC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAC1B,SAAgC,EAChC,IAAmB,EACnB,OAAe;IAEf,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,SAAS;QAChC,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,SAAgC,EAChC,IAAmB,EACnB,QAAgB;IAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,KAAsC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,WAAW,KAAK,QAAQ;gBAAE,KAAK,GAAG,IAAI,CAAC;QACjD,CAAC;QACD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,uEAAuE;QACvE,qCAAqC;QACrC,OAAO,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,QAA6B;IACpF,OAAO,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACtC,SAAiB,EACjB,QAA6B,EAC7B,YAA+B;IAE/B,OAAO,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAiB,EACjB,QAA6B,EAC7B,IAA2B;IAE3B,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC","sourcesContent":["/**\n * restore.ts — map a /tree navigation target to the snapshot that should be\n * restored and apply it via the engine.\n *\n * Snapshot semantics: a frame anchored at user entry U records the work tree\n * at the moment U's run STARTED (see engine.ts beginTurn). The selection here\n * must mirror AgentSession.navigateTree's leaf rules:\n *\n *   - user / custom_message target: navigateTree removes the target's turn\n *     from the branch (leaf = parent, text returns to the editor) → restore\n *     to the state BEFORE that turn = the snapshot anchored at the target.\n *   - any other target: the target's turn STAYS in the conversation\n *     (leaf = target) → restore to the state AFTER that turn = the first\n *     chronological snapshot anchored at a descendant turn (it recorded the\n *     work tree when the next run began). No such snapshot → nothing was\n *     recorded after the target, so offer no restore at all — falling back to\n *     an ancestor frame would roll back the target turn's own edits and leave\n *     the work tree older than the conversation.\n */\nimport {\n\ttype ApplySnapshotOptions,\n\tapplySnapshot,\n\ttype CoarseDiffStats,\n\tcollectChangeDiffStats,\n\tcollectChanges,\n} from \"./engine.ts\";\nimport type { FileHistorySnapshot } from \"./snapshot.ts\";\n\n/** Minimal per-entry view needed to walk the tree and classify targets. */\nexport interface EntryView {\n\tid: string;\n\tparentId: string | null;\n\t/** True for entries navigateTree treats as turn starts (user / custom_message → leaf = parent). */\n\tisTurnAnchor: boolean;\n}\n\n/** Minimal session view we need to walk the entry tree. */\nexport interface EntryTreeView {\n\tgetEntry(id: string): EntryView | undefined;\n}\n\n/** Cycle guard for parent-chain walks (ids are acyclic in practice). */\nconst ANCESTOR_WALK_GUARD = 100_000;\n\n/** True when `id`'s parent chain passes through `ancestorId` (strict descent). */\nfunction isDescendantOf(view: EntryTreeView, id: string, ancestorId: string): boolean {\n\tlet cur = view.getEntry(id)?.parentId ?? null;\n\tlet guard = 0;\n\twhile (cur !== null && guard++ < ANCESTOR_WALK_GUARD) {\n\t\tif (cur === ancestorId) return true;\n\t\tcur = view.getEntry(cur)?.parentId ?? null;\n\t}\n\treturn false;\n}\n\n/**\n * First (chronological) snapshot anchored at a strict descendant of `entryId`\n * — the run that started right after `entryId` existed, so its frame records\n * the work tree state \"just after\" the entry.\n */\nfunction snapshotAfterEntry(\n\tsnapshots: FileHistorySnapshot[],\n\tview: EntryTreeView,\n\tentryId: string,\n): FileHistorySnapshot | undefined {\n\tfor (const snap of snapshots) {\n\t\tif (!snap.userEntryId) continue;\n\t\tif (isDescendantOf(view, snap.userEntryId, entryId)) return snap;\n\t}\n\treturn undefined;\n}\n\n/**\n * The snapshot that matches navigating to `targetId`, per the rules in the\n * module header. Undefined when no recorded state corresponds to the target\n * (then the work tree should be left alone).\n */\nexport function snapshotForEntry(\n\tsnapshots: FileHistorySnapshot[],\n\tview: EntryTreeView,\n\ttargetId: string,\n): FileHistorySnapshot | undefined {\n\tconst target = view.getEntry(targetId);\n\tif (!target) return undefined;\n\n\tif (target.isTurnAnchor) {\n\t\t// Exact anchor match: the frame recording the state right before this\n\t\t// turn ran. Chronologically last wins if duplicate anchors exist.\n\t\tlet exact: FileHistorySnapshot | undefined;\n\t\tfor (const snap of snapshots) {\n\t\t\tif (snap.userEntryId === targetId) exact = snap;\n\t\t}\n\t\tif (exact) return exact;\n\t\t// No frame for this turn (it recorded no changes): the state before it\n\t\t// equals the state after its parent.\n\t\treturn target.parentId === null ? undefined : snapshotAfterEntry(snapshots, view, target.parentId);\n\t}\n\n\treturn snapshotAfterEntry(snapshots, view, targetId);\n}\n\n/**\n * Absolute file paths restoring to this snapshot would change on disk (empty =\n * none). Callers use the length for the count and the paths for the preview.\n */\nexport function snapshotChangedPaths(sessionId: string, snapshot: FileHistorySnapshot): Promise<string[]> {\n\treturn collectChanges(sessionId, snapshot);\n}\n\n/**\n * Coarse +N/−M line stats for the confirm dialog (paths must already be known\n * changed — typically from snapshotChangedPaths).\n */\nexport function snapshotChangeDiffStats(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\tchangedPaths: readonly string[],\n): Promise<CoarseDiffStats> {\n\treturn collectChangeDiffStats(sessionId, snapshot, changedPaths);\n}\n\n/**\n * Restore the work tree to `snapshot` and return changed absolute paths.\n * Pass `onlyPaths` from a prior snapshotChangedPaths call to skip re-compare.\n */\nexport async function restoreToSnapshot(\n\tsessionId: string,\n\tsnapshot: FileHistorySnapshot,\n\topts?: ApplySnapshotOptions,\n): Promise<string[]> {\n\treturn applySnapshot(sessionId, snapshot, opts);\n}\n"]}

package/dist/extensions/rewind/snapshot.d.ts

@@ -1,45 +0,0 @@
-/**
- * snapshot.ts — persisted data shapes for the rewind extension's file-history
- * engine. Pure types + tiny helpers; no Pi imports, no side effects, so the
- * engine and its selftests can import them under plain node.
- *
- * A FileHistorySnapshot is written to the session JSONL (via the integration
- * layer's appendEntry, custom type "pi-rewind-snapshot"). It is never sent to
- * the LLM and survives reload/compaction. Each snapshot anchors to one turn and
- * records, for every tracked file, which backup blob holds that file's contents
- * as of the start of the turn.
- */
-/** Custom session-entry type used to persist snapshots to the session JSONL. */
-export declare const SNAPSHOT_ENTRY_TYPE = "pi-rewind-snapshot";
-/**
- * One file's backup at a specific version.
- * `backupName === null` means the file did not exist at this version — rewinding
- * to a snapshot carrying a null backup deletes the file.
- */
-export interface FileBackup {
-    /** Backup blob filename (`<sha256(relpath)[:16]>@v<n>`), or null if the file did not exist. */
-    backupName: string | null;
-    /** Monotonic version for this file within the session (1-based). */
-    version: number;
-}
-/**
- * One turn's snapshot. `v` lets future readers migrate old entries.
- * `trackedFileBackups` is keyed by the file's path *relative to cwd* when inside
- * cwd (else the absolute path), matching the engine's path shortening.
- */
-export interface FileHistorySnapshot {
-    v: 1;
-    /** Session entry id this snapshot anchors to (used to match /tree navigation). */
-    userEntryId: string;
-    /** Leaf/turn id when finalized (informational). */
-    turnId: string;
-    /** The user prompt that drove the turn (truncated; shown in the /tree sync prompt). */
-    prompt: string;
-    /** Map of tracking-path → the backup recorded for that file at the start of this turn. */
-    trackedFileBackups: Record<string, FileBackup>;
-    /** ISO timestamp the snapshot was finalized. */
-    timestamp: string;
-}
-/** Narrow an arbitrary session-entry payload to a FileHistorySnapshot. */
-export declare function isSnapshot(data: unknown): data is FileHistorySnapshot;
-//# sourceMappingURL=snapshot.d.ts.map

package/dist/extensions/rewind/snapshot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,+FAA+F;IAC/F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC,CAAC,EAAE,CAAC,CAAC;IACL,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,mBAAmB,CAMrE"}

package/dist/extensions/rewind/snapshot.js

@@ -1,21 +0,0 @@
-/**
- * snapshot.ts — persisted data shapes for the rewind extension's file-history
- * engine. Pure types + tiny helpers; no Pi imports, no side effects, so the
- * engine and its selftests can import them under plain node.
- *
- * A FileHistorySnapshot is written to the session JSONL (via the integration
- * layer's appendEntry, custom type "pi-rewind-snapshot"). It is never sent to
- * the LLM and survives reload/compaction. Each snapshot anchors to one turn and
- * records, for every tracked file, which backup blob holds that file's contents
- * as of the start of the turn.
- */
-/** Custom session-entry type used to persist snapshots to the session JSONL. */
-export const SNAPSHOT_ENTRY_TYPE = "pi-rewind-snapshot";
-/** Narrow an arbitrary session-entry payload to a FileHistorySnapshot. */
-export function isSnapshot(data) {
-    if (!data || typeof data !== "object")
-        return false;
-    const s = data;
-    return (typeof s.userEntryId === "string" && typeof s.trackedFileBackups === "object" && s.trackedFileBackups !== null);
-}
-//# sourceMappingURL=snapshot.js.map

package/dist/extensions/rewind/snapshot.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/extensions/rewind/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAiCxD,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,IAAa;IACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,CAAC,GAAG,IAAoC,CAAC;IAC/C,OAAO,CACN,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ,IAAI,CAAC,CAAC,kBAAkB,KAAK,IAAI,CAC9G,CAAC;AACH,CAAC","sourcesContent":["/**\n * snapshot.ts — persisted data shapes for the rewind extension's file-history\n * engine. Pure types + tiny helpers; no Pi imports, no side effects, so the\n * engine and its selftests can import them under plain node.\n *\n * A FileHistorySnapshot is written to the session JSONL (via the integration\n * layer's appendEntry, custom type \"pi-rewind-snapshot\"). It is never sent to\n * the LLM and survives reload/compaction. Each snapshot anchors to one turn and\n * records, for every tracked file, which backup blob holds that file's contents\n * as of the start of the turn.\n */\n\n/** Custom session-entry type used to persist snapshots to the session JSONL. */\nexport const SNAPSHOT_ENTRY_TYPE = \"pi-rewind-snapshot\";\n\n/**\n * One file's backup at a specific version.\n * `backupName === null` means the file did not exist at this version — rewinding\n * to a snapshot carrying a null backup deletes the file.\n */\nexport interface FileBackup {\n\t/** Backup blob filename (`<sha256(relpath)[:16]>@v<n>`), or null if the file did not exist. */\n\tbackupName: string | null;\n\t/** Monotonic version for this file within the session (1-based). */\n\tversion: number;\n}\n\n/**\n * One turn's snapshot. `v` lets future readers migrate old entries.\n * `trackedFileBackups` is keyed by the file's path *relative to cwd* when inside\n * cwd (else the absolute path), matching the engine's path shortening.\n */\nexport interface FileHistorySnapshot {\n\tv: 1;\n\t/** Session entry id this snapshot anchors to (used to match /tree navigation). */\n\tuserEntryId: string;\n\t/** Leaf/turn id when finalized (informational). */\n\tturnId: string;\n\t/** The user prompt that drove the turn (truncated; shown in the /tree sync prompt). */\n\tprompt: string;\n\t/** Map of tracking-path → the backup recorded for that file at the start of this turn. */\n\ttrackedFileBackups: Record<string, FileBackup>;\n\t/** ISO timestamp the snapshot was finalized. */\n\ttimestamp: string;\n}\n\n/** Narrow an arbitrary session-entry payload to a FileHistorySnapshot. */\nexport function isSnapshot(data: unknown): data is FileHistorySnapshot {\n\tif (!data || typeof data !== \"object\") return false;\n\tconst s = data as Partial<FileHistorySnapshot>;\n\treturn (\n\t\ttypeof s.userEntryId === \"string\" && typeof s.trackedFileBackups === \"object\" && s.trackedFileBackups !== null\n\t);\n}\n"]}

package/dist/extensions/rewind/storage.d.ts

@@ -1,12 +0,0 @@
-/** Bind the on-disk roots. Called once by index.ts (or by selftests). */
-export declare function configureStorage(opts: {
-    backupsRoot: string;
-    sessionsRoot: string;
-}): void;
-/** Root holding every session's backup directory. */
-export declare function backupsRootDir(): string;
-/** A single session's backup directory. */
-export declare function backupsDir(sessionId: string): string;
-/** Root holding Pi's session JSONL files (for orphan detection). */
-export declare function sessionsRootDir(): string;
-//# sourceMappingURL=storage.d.ts.map

package/dist/extensions/rewind/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/storage.ts"],"names":[],"mappings":"AAiBA,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG1F;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/extensions/rewind/storage.js

@@ -1,33 +0,0 @@
-/**
- * storage.ts — injected storage roots for the rewind engine.
- *
- * engine.ts and gc.ts must stay loadable under plain node (for offline
- * selftests), so they cannot statically import paths.ts (which imports
- * getAgentDir from @astralyn/pi — unresolvable outside Pi).
- * Instead they read the roots from here, and the integration layer (index.ts)
- * calls configureStorage() with the real paths at startup. Selftests call it with
- * temp directories.
- *
- * No Pi imports in this module.
- */
-import { join } from "node:path";
-let backupsRoot = "";
-let sessionsRoot = "";
-/** Bind the on-disk roots. Called once by index.ts (or by selftests). */
-export function configureStorage(opts) {
-    backupsRoot = opts.backupsRoot;
-    sessionsRoot = opts.sessionsRoot;
-}
-/** Root holding every session's backup directory. */
-export function backupsRootDir() {
-    return backupsRoot;
-}
-/** A single session's backup directory. */
-export function backupsDir(sessionId) {
-    return join(backupsRoot, sessionId);
-}
-/** Root holding Pi's session JSONL files (for orphan detection). */
-export function sessionsRootDir() {
-    return sessionsRoot;
-}
-//# sourceMappingURL=storage.js.map

package/dist/extensions/rewind/storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/extensions/rewind/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,WAAW,GAAG,EAAE,CAAC;AACrB,IAAI,YAAY,GAAG,EAAE,CAAC;AAEtB,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,IAAmD;IACnF,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;AAClC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,cAAc;IAC7B,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC3C,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe;IAC9B,OAAO,YAAY,CAAC;AACrB,CAAC","sourcesContent":["/**\n * storage.ts — injected storage roots for the rewind engine.\n *\n * engine.ts and gc.ts must stay loadable under plain node (for offline\n * selftests), so they cannot statically import paths.ts (which imports\n * getAgentDir from @astralyn/pi — unresolvable outside Pi).\n * Instead they read the roots from here, and the integration layer (index.ts)\n * calls configureStorage() with the real paths at startup. Selftests call it with\n * temp directories.\n *\n * No Pi imports in this module.\n */\nimport { join } from \"node:path\";\n\nlet backupsRoot = \"\";\nlet sessionsRoot = \"\";\n\n/** Bind the on-disk roots. Called once by index.ts (or by selftests). */\nexport function configureStorage(opts: { backupsRoot: string; sessionsRoot: string }): void {\n\tbackupsRoot = opts.backupsRoot;\n\tsessionsRoot = opts.sessionsRoot;\n}\n\n/** Root holding every session's backup directory. */\nexport function backupsRootDir(): string {\n\treturn backupsRoot;\n}\n\n/** A single session's backup directory. */\nexport function backupsDir(sessionId: string): string {\n\treturn join(backupsRoot, sessionId);\n}\n\n/** Root holding Pi's session JSONL files (for orphan detection). */\nexport function sessionsRootDir(): string {\n\treturn sessionsRoot;\n}\n"]}

package/dist/extensions/rewind/text.d.ts

@@ -1,7 +0,0 @@
-export interface TruncateTextOptions {
-    ellipsis?: string;
-    collapseWhitespace?: boolean;
-}
-export declare function truncateText(text: string, maxLength: number, options?: TruncateTextOptions): string;
-export declare function formatSize(bytes: number): string;
-//# sourceMappingURL=text.d.ts.map

package/dist/extensions/rewind/text.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/text.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAMvG;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/extensions/rewind/text.js

@@ -1,19 +0,0 @@
-export function truncateText(text, maxLength, options = {}) {
-    const ellipsis = options.ellipsis ?? "...";
-    const source = options.collapseWhitespace ? text.replace(/\s+/g, " ").trim() : text;
-    if (source.length <= maxLength)
-        return source;
-    if (ellipsis.length >= maxLength)
-        return ellipsis.slice(0, maxLength);
-    return `${source.slice(0, maxLength - ellipsis.length)}${ellipsis}`;
-}
-export function formatSize(bytes) {
-    if (bytes < 1024)
-        return `${bytes}B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)}KB`;
-    if (bytes < 1024 * 1024 * 1024)
-        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
-}
-//# sourceMappingURL=text.js.map

package/dist/extensions/rewind/text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/extensions/rewind/text.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,UAA+B,EAAE;IAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC","sourcesContent":["export interface TruncateTextOptions {\n\tellipsis?: string;\n\tcollapseWhitespace?: boolean;\n}\n\nexport function truncateText(text: string, maxLength: number, options: TruncateTextOptions = {}): string {\n\tconst ellipsis = options.ellipsis ?? \"...\";\n\tconst source = options.collapseWhitespace ? text.replace(/\\s+/g, \" \").trim() : text;\n\tif (source.length <= maxLength) return source;\n\tif (ellipsis.length >= maxLength) return ellipsis.slice(0, maxLength);\n\treturn `${source.slice(0, maxLength - ellipsis.length)}${ellipsis}`;\n}\n\nexport function formatSize(bytes: number): string {\n\tif (bytes < 1024) return `${bytes}B`;\n\tif (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;\n\tif (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n\treturn `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;\n}\n"]}

package/dist/extensions/rewind/tool-path.d.ts

@@ -1,3 +0,0 @@
-export declare function editWriteTargetPath(input: unknown): string | undefined;
-export declare function resolveToolPath(rawPath: string, cwd: string): string;
-//# sourceMappingURL=tool-path.d.ts.map

package/dist/extensions/rewind/tool-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-path.d.ts","sourceRoot":"","sources":["../../../src/extensions/rewind/tool-path.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/extensions/rewind/tool-path.js

@@ -1,9 +0,0 @@
-import path from "node:path";
-export function editWriteTargetPath(input) {
-    const rawPath = input?.path;
-    return typeof rawPath === "string" && rawPath.length > 0 ? rawPath : undefined;
-}
-export function resolveToolPath(rawPath, cwd) {
-    return path.isAbsolute(rawPath) ? rawPath : path.resolve(cwd, rawPath);
-}
-//# sourceMappingURL=tool-path.js.map

package/dist/extensions/rewind/tool-path.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-path.js","sourceRoot":"","sources":["../../../src/extensions/rewind/tool-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,mBAAmB,CAAC,KAAc;IACjD,MAAM,OAAO,GAAI,KAAwC,EAAE,IAAI,CAAC;IAChE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import path from \"node:path\";\n\nexport function editWriteTargetPath(input: unknown): string | undefined {\n\tconst rawPath = (input as { path?: unknown } | undefined)?.path;\n\treturn typeof rawPath === \"string\" && rawPath.length > 0 ? rawPath : undefined;\n}\n\nexport function resolveToolPath(rawPath: string, cwd: string): string {\n\treturn path.isAbsolute(rawPath) ? rawPath : path.resolve(cwd, rawPath);\n}\n"]}

package/docs/bundled/extensions/biu.md

@@ -1,63 +0,0 @@
-# Biu — project development workflow
-
-Biu is a simple, structured development workflow for the interactive TUI: `/biu` switches Biu Mode on, and inside the mode `/biu` opens its menu. One project cycle moves through soft stages — **plan** (clarify requirements into an approved `SPEC.md`), an **optional decompose** step (break a complex SPEC into task handoffs; simple SPECs are implemented directly), **execute** (implement, one task at a time when tasks exist), and **archive** (summarize and close the cycle).
-
-There is no state machine and no workflow tool. Workflow state lives in the frontmatter of the workspace Markdown files — the SPEC's `status: draft|ready`, each task's `status: ready|in_progress|completed` and `depends_on` — and the extension derives a read-only snapshot from them each turn. The model edits these files with the normal file tools through the `biu://` scheme.
-
-## Command
-
-| Command | Behavior |
-|---|---|
-| `/biu` | When the mode is off, turn it on (no agent turn is triggered); when it is on, open the Biu menu |
-
-`/biu` accepts no arguments. Turning the mode on with no prior cycle leaves the workflow at the plan stage — describe what you want to build in your next message and the interview starts from there. With an existing cycle, the mode resumes at the stage derived from the workspace files.
-
-The menu keeps only the actions needed to operate the workflow:
-
-- **Continue · stage** — send a kickoff message (collapsed to one line; expandable with the standard expand key) that starts a turn continuing the current stage.
-- **Archive cycle** — deterministically move `SPEC.md`, `Summary.md`, and `tasks/` into `archived/YYYY-MM-DD-<shortname>/`. Requires an existing, model-drafted and user-confirmed `Summary.md`; archiving with unfinished tasks asks for confirmation first. The shortname is derived from the SPEC's `title` frontmatter (a dialog asks for one when it is missing). On failure, already-moved files are rolled back.
-- **Exit Biu Mode** — turn the mode off. Workflow files are kept.
-
-A subtitle summarizes the current stage; while the mode is on, the footer keeps the marker `Biu · execute 2/5` (warning-colored when workspace files have problems, such as malformed frontmatter).
-
-Biu Mode is TUI-only. RPC, JSON, and print sessions do not enable it, inject its resident prompt, or open its menu. Opening the same branch later in the TUI restores its recorded enabled flag.
-
-## Storage and the `biu://` scheme
-
-Biu artifacts live under the normal Pi agent directory, grouped by working directory with the same path encoding used for sessions:
-
-```text
-~/.pi/agent/biu/
-└── --encoded-working-directory--/
-    ├── SPEC.md                    # frontmatter: title, status, execution, baseline_commit
-    ├── Summary.md                 # frontmatter: title, head_commit; temporary while archiving
-    ├── tasks/
-    │   └── TASK-<short-name>.md   # frontmatter: title, status, depends_on
-    └── archived/
-        └── YYYY-MM-DD-shortname/
-            ├── SPEC.md
-            ├── Summary.md
-            └── tasks/
-```
-
-`PI_CODING_AGENT_DIR` is respected.
-
-The model never sees or uses these real paths. A `tool_call` hook rewrites `biu://` paths — `biu://SPEC.md`, `biu://tasks/TASK-api.md`, `biu://Summary.md` — to the workspace of the current working directory before `read`, `write`, `edit`, `grep`, `find`, and `ls` execute. The session records keep the original `biu://` arguments, so the transcript and TUI show the short stable paths while execution uses the resolved ones. Paths that escape the workspace (`..` segments, rooted paths) are blocked. The scheme resolves regardless of whether Biu Mode is on; the mode only controls prompting, the statusline, and the menu.
-
-## Prompting
-
-While the mode is on, the full Biu block is injected into the system prompt each turn: the `biu://` conventions, a JSON snapshot of the workspace (derived stage, SPEC metadata, task statuses and focus, detected problems), and the playbook for the derived stage, including the relevant Markdown templates. At the execute stage the playbook follows the SPEC's `execution` field — `direct` implements straight against the SPEC, `tasks` decomposes into task files first, and a SPEC without the field falls back to a combined playbook that asks to record the choice. There is nothing to fetch on demand — the workspace files are the state, and the snapshot always reflects them.
-
-Stage transitions are file edits, with one guarded exception: flipping the SPEC's `status` to `ready` opens an approval dialog. Approving lets the write land and the cycle move on to execute; declining blocks the write and hands your feedback to the model as the tool result, so it revises the SPEC and asks again. During planning the model also records the agreed execution path in the frontmatter (`execution: direct` by default; `tasks` when the work splits into independently verifiable chunks). Writing task files opts into decomposition, task frontmatter tracks execution, and writing `Summary.md` (or completing every task) enters archive. Moving backward — for example reopening the SPEC as `draft` when execution reveals a gap, or switching `execution` when the size estimate was wrong — is just another frontmatter edit.
-
-## Lifecycle
-
-The enabled flag is stored as a branch-aware custom session entry. In the TUI, `session_start` and `session_tree` replay the latest flag, so `/reload`, resume, fork, and tree navigation restore the mode. Non-TUI sessions leave that flag untouched but keep Biu inactive. The statusline refreshes whenever a `write` or `edit` lands inside the workspace.
-
-Biu artifacts are project-global rather than conversation-branch snapshots: navigating `/tree` changes the enabled flag with the branch, but workflow files do not roll back.
-
-## Limits
-
-- The snapshot lists at most 100 task files; additional files are reported as a problem instead of being silently ignored.
-- Malformed frontmatter never blocks the workflow: the affected file degrades to an `unknown` status and the problem is surfaced to the model and in the statusline.
-- Concurrent writers in multiple Pi processes are not coordinated. Use one active Biu writer per project.

package/docs/bundled/extensions/rewind.md

@@ -1,86 +0,0 @@
-# rewind — checkpoints & rewind
-
-Per-edit file backups plus a `/rewind` settings menu. Instead of snapshotting the
-whole working tree, rewind backs up **only the files Pi's `edit`/`write` tools are
-about to change** — one `copyFile` before each edit. Cost is proportional to how
-many files Pi changed, never to project size, so it never blocks the session
-lifecycle (the old shadow-git design froze the UI in large multi-project
-directories) and storage stays tiny.
-
-## Behavior
-
-Per turn: `before_agent_start` opens a snapshot frame (re-recording every tracked
-file at its turn-start state, reusing the latest backup when unchanged);
-`tool_call(edit|write)` backs up each newly edited file *before* it lands;
-`agent_settled` persists the frame to the session JSONL as a `pi-rewind-snapshot`
-custom entry **only when files changed**. The frame anchors to the **first** user
-entry the run appended — the message whose start the frame recorded; steering and
-follow-up messages consumed inside the same run append later user entries and do
-not steal the anchor (a run that appends no user entry, e.g. custom-triggered,
-records no frame). Using `agent_settled` (not `agent_end`)
-keeps auto-retry, overflow compaction-retry, and queued follow-ups in one logical
-turn — `agent_end` can fire while Pi still continues. Requires **Pi ≥ 0.80.4**
-(when `agent_settled` was added); older hosts never fire that event, so frames
-would not finalize. Entries survive `/reload` and compaction; the index is
-rebuilt from them on `session_start`.
-
-- **Scope (deliberate trade-off):** rewind covers edits made through Pi's built-in
-  `edit` and `write` tools. Files written by `bash` (redirects, codegen, `mv`) or
-  edited by hand outside Pi are **not** tracked — same boundary as Claude Code's
-  file-history. Rewind undoes *Pi's edits*, not arbitrary filesystem state.
-- **Time-travel is via `/tree`.** Navigating to a node whose recorded state
-  differs from the work tree prompts to restore, listing the affected files
-  (cwd-relative, up to 8 then *"+N more"*) under *"Restore 3 files to this
-  point?  (+120 / −40)"* when coarse line stats are available. The restore
-  target mirrors `/tree`'s own semantics: a **user message** target (whose turn
-  is removed and returned to the editor) restores to the state *before* that
-  turn ran; any **other** target (whose turn stays in the conversation)
-  restores to the state *after* that turn — the state recorded when the next
-  run began. When nothing was recorded after the target (e.g. the last turn's
-  assistant message), navigation is silent rather than rolling back edits the
-  conversation still contains. Nodes with no file changes navigate silently.
-  Only files that actually differ are rewritten. Line totals are a bag-of-lines
-  estimate (capped at 1 MB per file), not a full Myers diff.
-- **`/rewind` is a settings + storage menu**, not a restore picker:
-  - toggle rewind on/off,
-  - set the auto-clean retention window,
-  - inspect storage and prune (clean aged + orphaned / remove orphaned / remove
-    all except current — the latter also keeps backups written to in the last
-    10 minutes, which may belong to sessions running in another Pi process).
-- **New files** created by `write` are tracked with a "did not exist" marker, so
-  rewinding deletes them.
-- **Resume/fork** hard-links the prior session's backup blobs into the new
-  session (falling back to copy), so rewind keeps working without duplicating
-  storage.
-
-## Storage & cleanup
-
-- **Layout:** `~/.pi/agent/rewind/`
-  - `config.json` — `{ enabled, retentionDays, maxSnapshots }`
-  - `backups/<sessionId>/<sha256(relpath)[:16]>@v<n>` — backup blobs (flat, hashed
-    names keep paths short on Windows; mode preserved)
-- **Auto-clean:** at `session_start`, backup directories older than
-  `retentionDays` (default **30**, set in `/rewind`) are reclaimed, plus an
-  **orphan sweep** of directories whose session id has no session JSONL (crashed
-  sessions). The GC is time-boxed and deletion-capped so it never slows startup.
-- The former `pi-config` storage layout is **not** read or migrated by this
-  engine. Remove any old `~/.pi/agent/pi-config/` data manually if it is no
-  longer needed.
-
-## Limits
-
-- Covers edits made through Pi's built-in `edit` and `write` tools only. Files written by `bash` or edited outside Pi are not tracked.
-- A backup failure is swallowed — the edit proceeds without checkpointing rather than blocking the tool.
-- `/rewind` on its own does not restore files. Restoration uses `/tree` — navigate to a turn and confirm the prompt.
-- Restore is coarse: only files that differ are rewritten, but line totals are a bag-of-lines estimate (capped at 1 MB per file), not a full Myers diff.
-
-## Implementation notes
-
-- **Never blocks the edit.** Backup runs before the write lands; a backup failure is swallowed so the session never stalls.
-- **Restore safety.** `applySnapshot` only rewrites files that differ and degrades gracefully on unreadable backups.
-- **Change detection.** A file is re-backed-up only when its stat or content differs from the latest backup. Content comparison streams in 64 KiB chunks instead of buffering whole files up to the 25 MB cap.
-- **Config is memory-cached.** `config.json` is re-read on `session_start` and updated in memory when `/rewind` saves.
-- **Restore path is single-scan.** The `/tree` confirm pass caches changed absolute paths; IO is concurrency-capped (16).
-
-
-Architecture informed by oh-my-pi (GPL-3.0) and Claude Code's file-history; independent implementation.