@herbcaudill/ralph 0.8.5 → 1.0.1

package/dist/lib/parseWorktreeFromBranch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parse instance name and ID from a worktree branch name.
+ *
+ * Expected format: {name}-{id}
+ * The last dash separates name from ID.
+ */
+export declare function parseWorktreeFromBranch(
+/** Branch name without the "ralph/" prefix */
+branchParts: string): {
+    instanceName: string;
+    instanceId: string;
+} | null;
+//# sourceMappingURL=parseWorktreeFromBranch.d.ts.map

package/dist/lib/parseWorktreeFromBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseWorktreeFromBranch.d.ts","sourceRoot":"","sources":["../../src/lib/parseWorktreeFromBranch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,uBAAuB;AACrC,8CAA8C;AAC9C,WAAW,EAAE,MAAM,GAClB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASrD"}

package/dist/lib/parseWorktreeFromBranch.js

@@ -0,0 +1,19 @@
+/**
+ * Parse instance name and ID from a worktree branch name.
+ *
+ * Expected format: {name}-{id}
+ * The last dash separates name from ID.
+ */
+export function parseWorktreeFromBranch(
+/** Branch name without the "ralph/" prefix */
+branchParts) {
+    // Parse {name}-{id} from branch name
+    const lastDash = branchParts.lastIndexOf("-");
+    if (lastDash > 0) {
+        const instanceName = branchParts.slice(0, lastDash);
+        const instanceId = branchParts.slice(lastDash + 1);
+        return { instanceName, instanceId };
+    }
+    return null;
+}
+//# sourceMappingURL=parseWorktreeFromBranch.js.map

package/dist/lib/parseWorktreeFromBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseWorktreeFromBranch.js","sourceRoot":"","sources":["../../src/lib/parseWorktreeFromBranch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;AACrC,8CAA8C;AAC9C,WAAmB;IAEnB,qCAAqC;IACrC,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACnD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;QAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA;IACrC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/lib/processEvents.d.ts

@@ -0,0 +1,12 @@
+import { type ContentBlock } from "../components/eventToBlocks.js";
+/**
+ * Process raw events into content blocks.
+ *
+ * With includePartialMessages: true, we receive multiple snapshots of the same message
+ * as it builds up. Each snapshot may contain different parts of the message content,
+ * so we need to merge them and deduplicate.
+ */
+export declare const processEvents: (
+/** Array of raw event objects from the SDK */
+events: Array<Record<string, unknown>>) => ContentBlock[];
+//# sourceMappingURL=processEvents.d.ts.map

package/dist/lib/processEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processEvents.d.ts","sourceRoot":"","sources":["../../src/lib/processEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;AACxB,8CAA8C;AAC9C,QAAQ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,YAAY,EA6Gd,CAAA"}

package/dist/lib/processEvents.js

@@ -0,0 +1,113 @@
+import { eventToBlocks } from "../components/eventToBlocks.js";
+/**
+ * Process raw events into content blocks.
+ *
+ * With includePartialMessages: true, we receive multiple snapshots of the same message
+ * as it builds up. Each snapshot may contain different parts of the message content,
+ * so we need to merge them and deduplicate.
+ */
+export const processEvents = (
+/** Array of raw event objects from the SDK */
+events) => {
+    const blocks = [];
+    // First pass: collect all assistant message content and track message order
+    const assistantEvents = events.filter(event => event.type === "assistant");
+    // Collect all content blocks from all snapshots of the same message
+    const messageMap = new Map();
+    for (const event of assistantEvents) {
+        const message = event.message;
+        const messageId = message?.id;
+        const content = message?.content;
+        if (messageId && content) {
+            if (!messageMap.has(messageId)) {
+                messageMap.set(messageId, []);
+            }
+            messageMap.get(messageId).push(...content);
+        }
+    }
+    // Create merged events with deduplicated content
+    const mergedEvents = Array.from(messageMap.entries()).map(([messageId, allContent]) => {
+        // Deduplicate content blocks by their ID (for tool_use) or text (for text blocks)
+        const seenBlocks = new Set();
+        const uniqueContent = [];
+        for (const block of allContent) {
+            const blockType = block.type;
+            let blockKey;
+            if (blockType === "tool_use") {
+                // Tool use blocks are unique by their ID
+                blockKey = `tool:${block.id}`;
+            }
+            else if (blockType === "text") {
+                // For text blocks, check if this is a prefix of or prefixed by existing text
+                // This handles incremental text updates where each snapshot has more content
+                const text = block.text;
+                let isDuplicate = false;
+                for (const seenKey of seenBlocks) {
+                    if (seenKey.startsWith("text:")) {
+                        const seenText = seenKey.substring(5);
+                        // If existing text starts with this text, or this text starts with existing,
+                        // keep only the longer one
+                        if (seenText.startsWith(text)) {
+                            // Existing is longer, this is a duplicate
+                            isDuplicate = true;
+                            break;
+                        }
+                        else if (text.startsWith(seenText)) {
+                            // This is longer, remove the old one and add this
+                            seenBlocks.delete(seenKey);
+                            // Also remove from uniqueContent
+                            const idx = uniqueContent.findIndex(b => b.type === "text" && b.text === seenText);
+                            if (idx >= 0)
+                                uniqueContent.splice(idx, 1);
+                            break;
+                        }
+                    }
+                }
+                if (isDuplicate)
+                    continue;
+                blockKey = `text:${text}`;
+            }
+            else {
+                blockKey = JSON.stringify(block);
+            }
+            if (!seenBlocks.has(blockKey)) {
+                seenBlocks.add(blockKey);
+                uniqueContent.push(block);
+            }
+        }
+        return {
+            type: "assistant",
+            message: {
+                id: messageId,
+                content: uniqueContent,
+            },
+        };
+    });
+    const assistantBlocks = mergedEvents.flatMap(event => eventToBlocks(event));
+    // Second pass: process events in order, including user messages
+    // Track which user messages and assistant messages we've already seen
+    const processedUserIds = new Set();
+    const processedAssistantIds = new Set();
+    for (const event of events) {
+        if (event.type === "user") {
+            const message = event.message;
+            const messageId = message?.id ?? `user-${Date.now()}`;
+            if (!processedUserIds.has(messageId)) {
+                processedUserIds.add(messageId);
+                blocks.push(...eventToBlocks(event));
+            }
+        }
+        else if (event.type === "assistant") {
+            const message = event.message;
+            const messageId = message?.id;
+            if (messageId && !processedAssistantIds.has(messageId)) {
+                processedAssistantIds.add(messageId);
+                // Find the merged version of this message
+                const merged = assistantBlocks.filter(b => b.id.startsWith(messageId));
+                blocks.push(...merged);
+            }
+        }
+    }
+    return blocks;
+};
+//# sourceMappingURL=processEvents.js.map

package/dist/lib/processEvents.js.map

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

package/dist/lib/rel.d.ts

@@ -1,2 +1,8 @@
-export declare const rel: (path: string) => string;
+/**
+ * Convert an absolute path to a relative path from the base working directory.
+ * For temp files, returns just the filename. Leaves relative paths unchanged.
+ */
+export declare const rel: (
+/** The path to convert */
+path: string) => string;
 //# sourceMappingURL=rel.d.ts.map

package/dist/lib/rel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rel.d.ts","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,WAM/B,CAAA"}
+{"version":3,"file":"rel.d.ts","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,GAAG;AACd,0BAA0B;AAC1B,MAAM,MAAM,WAUb,CAAA"}

package/dist/lib/rel.js

@@ -1,10 +1,19 @@
-import { relative } from "path";
-const cwd = process.cwd();
-export const rel = (path) => {
+import { isAbsolute, relative } from "path";
+import { getBaseCwd } from "./getBaseCwd.js";
+/**
+ * Convert an absolute path to a relative path from the base working directory.
+ * For temp files, returns just the filename. Leaves relative paths unchanged.
+ */
+export const rel = (
+/** The path to convert */
+path) => {
+    if (!isAbsolute(path)) {
+        return path;
+    }
     // For temp files, just show the filename
     if (path.includes("/var/folders/") || path.includes("/tmp/")) {
         return path.split("/").pop() || path;
     }
-    return relative(cwd, path) || path;
+    return relative(getBaseCwd(), path) || path;
 };
 //# sourceMappingURL=rel.js.map

package/dist/lib/rel.js.map

@@ -1 +1 @@
-{"version":3,"file":"rel.js","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAE/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;AAEzB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;IAClC,yCAAyC;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAA;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAA;AACpC,CAAC,CAAA"}
+{"version":3,"file":"rel.js","sourceRoot":"","sources":["../../src/lib/rel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;AACjB,0BAA0B;AAC1B,IAAY,EACZ,EAAE;IACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,yCAAyC;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAA;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAA;AAC7C,CAAC,CAAA"}

package/dist/lib/rel.test.js

@@ -1,5 +1,14 @@
-import { describe, it, expect } from "vitest";
+import { describe, it, expect, afterEach } from "vitest";
 import { rel } from "./rel.js";
+const originalCwd = process.env.RALPH_CWD;
+afterEach(() => {
+    if (originalCwd === undefined) {
+        delete process.env.RALPH_CWD;
+    }
+    else {
+        process.env.RALPH_CWD = originalCwd;
+    }
+});
 describe("rel", () => {
     it("converts absolute path to relative path", () => {
         const absolutePath = `${process.cwd()}/src/lib/rel.ts`;
@@ -21,6 +30,12 @@ describe("rel", () => {
         const result = rel(relativePath);
         expect(result).toBe(relativePath);
     });
+    it("uses RALPH_CWD when set", () => {
+        process.env.RALPH_CWD = "/Users/example/ralph";
+        const absolutePath = "/Users/example/ralph/src/lib/rel.ts";
+        const result = rel(absolutePath);
+        expect(result).toBe("src/lib/rel.ts");
+    });
     it("handles path outside current directory", () => {
         const outsidePath = "/completely/different/path/file.ts";
         const result = rel(outsidePath);

package/dist/lib/rel.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"rel.test.js","sourceRoot":"","sources":["../../src/lib/rel.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACnB,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,YAAY,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAA;QACtD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,wCAAwC,CAAA;QACzD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,0BAA0B,CAAA;QAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,YAAY,GAAG,gBAAgB,CAAA;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,WAAW,GAAG,oCAAoC,CAAA;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;QAC/B,6DAA6D;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAA;QACpB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"rel.test.js","sourceRoot":"","sources":["../../src/lib/rel.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAA;AAEzC,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAA;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,WAAW,CAAA;IACrC,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACnB,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,YAAY,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAA;QACtD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,wCAAwC,CAAA;QACzD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,0BAA0B,CAAA;QAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,YAAY,GAAG,gBAAgB,CAAA;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,sBAAsB,CAAA;QAC9C,MAAM,YAAY,GAAG,qCAAqC,CAAA;QAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,WAAW,GAAG,oCAAoC,CAAA;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;QAC/B,6DAA6D;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAA;QACpB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/sdkMessageToEvent.d.ts

@@ -0,0 +1,6 @@
+import { type SDKMessage } from "@anthropic-ai/claude-agent-sdk";
+/**  Convert SDK message to event format for display. */
+export declare const sdkMessageToEvent: (
+/** The SDK message to convert */
+message: SDKMessage) => Record<string, unknown> | null;
+//# sourceMappingURL=sdkMessageToEvent.d.ts.map

package/dist/lib/sdkMessageToEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkMessageToEvent.d.ts","sourceRoot":"","sources":["../../src/lib/sdkMessageToEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,wDAAwD;AACxD,eAAO,MAAM,iBAAiB;AAC5B,iCAAiC;AACjC,SAAS,UAAU,KAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAO5B,CAAA"}

package/dist/lib/sdkMessageToEvent.js

@@ -0,0 +1,12 @@
+/**  Convert SDK message to event format for display. */
+export const sdkMessageToEvent = (
+/** The SDK message to convert */
+message) => {
+    // Pass through messages that have the structure we expect
+    if (message.type === "assistant" || message.type === "user" || message.type === "result") {
+        return message;
+    }
+    // Skip system and stream_event messages for display
+    return null;
+};
+//# sourceMappingURL=sdkMessageToEvent.js.map

package/dist/lib/sdkMessageToEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkMessageToEvent.js","sourceRoot":"","sources":["../../src/lib/sdkMessageToEvent.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG;AAC/B,iCAAiC;AACjC,OAAmB,EACa,EAAE;IAClC,0DAA0D;IAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,OAA6C,CAAA;IACtD,CAAC;IACD,oDAAoD;IACpD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/lib/shortenTempPaths.d.ts

@@ -1,2 +1,8 @@
-export declare const shortenTempPaths: (text: string) => string;
+/**
+ * Replace temp file paths with just the filename.
+ * Shortens macOS and Linux temporary paths to be more readable in output.
+ */
+export declare const shortenTempPaths: (
+/** The text to process */
+text: string) => string;
 //# sourceMappingURL=shortenTempPaths.d.ts.map

package/dist/lib/shortenTempPaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shortenTempPaths.d.ts","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,WAK5C,CAAA"}
+{"version":3,"file":"shortenTempPaths.d.ts","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;AAC3B,0BAA0B;AAC1B,MAAM,MAAM,WAKb,CAAA"}

package/dist/lib/shortenTempPaths.js

@@ -1,5 +1,10 @@
-export const shortenTempPaths = (text) => {
-    // Replace temp file paths with just the filename
+/**
+ * Replace temp file paths with just the filename.
+ * Shortens macOS and Linux temporary paths to be more readable in output.
+ */
+export const shortenTempPaths = (
+/** The text to process */
+text) => {
     return text
         .replace(/\/var\/folders\/[^\s]+/g, match => match.split("/").pop() || match)
         .replace(/\/tmp\/[^\s]+/g, match => match.split("/").pop() || match);

package/dist/lib/shortenTempPaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"shortenTempPaths.js","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC/C,iDAAiD;IACjD,OAAO,IAAI;SACR,OAAO,CAAC,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;SAC5E,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAA;AACxE,CAAC,CAAA"}
+{"version":3,"file":"shortenTempPaths.js","sourceRoot":"","sources":["../../src/lib/shortenTempPaths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;AAC9B,0BAA0B;AAC1B,IAAY,EACZ,EAAE;IACF,OAAO,IAAI;SACR,OAAO,CAAC,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;SAC5E,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAA;AACxE,CAAC,CAAA"}

package/dist/lib/types.d.ts

@@ -0,0 +1,19 @@
+/**  Progress data for tracking issues/tasks. */
+export type ProgressData = {
+    /** Type of workspace (beads, todo, or none) */
+    type: "beads" | "todo" | "none";
+    /** Number of issues/tasks completed since startup */
+    completed: number;
+    /** Total issues/tasks seen since startup (initial + created since) */
+    total: number;
+};
+/**  Startup snapshot containing initial count and timestamp. */
+export type StartupSnapshot = {
+    /** Initial count of open + in_progress issues */
+    initialCount: number;
+    /** RFC3339 timestamp of when the snapshot was taken */
+    timestamp: string;
+    /** Type of workspace (beads or todo) */
+    type: "beads" | "todo";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IAC/B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG;IAC5B,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;CACvB,CAAA"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

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

package/dist/lib/useTerminalSize.d.ts

@@ -1,5 +1,6 @@
+/**  Hook to get the current terminal size and subscribe to resize events. */
 export declare const useTerminalSize: () => {
-    columns: number;
-    rows: number;
+    columns: any;
+    rows: any;
 };
 //# sourceMappingURL=useTerminalSize.d.ts.map

package/dist/lib/useTerminalSize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTerminalSize.d.ts","sourceRoot":"","sources":["../../src/lib/useTerminalSize.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe;;;CAuB3B,CAAA"}
+{"version":3,"file":"useTerminalSize.d.ts","sourceRoot":"","sources":["../../src/lib/useTerminalSize.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,eAAO,MAAM,eAAe;;;CAiB3B,CAAA"}

package/dist/lib/useTerminalSize.js

@@ -1,15 +1,13 @@
 import { useState, useEffect } from "react";
 import { useStdout } from "ink";
+import { getTerminalSize } from "./getTerminalSize.js";
+/**  Hook to get the current terminal size and subscribe to resize events. */
 export const useTerminalSize = () => {
     const { stdout } = useStdout();
-    const getSize = () => ({
-        columns: stdout?.columns ?? 80,
-        rows: stdout?.rows ?? 24,
-    });
-    const [size, setSize] = useState(getSize);
+    const [size, setSize] = useState(() => getTerminalSize(stdout));
     useEffect(() => {
         const handleResize = () => {
-            setSize(getSize());
+            setSize(getTerminalSize(stdout));
         };
         stdout?.on("resize", handleResize);
         return () => {

package/dist/lib/useTerminalSize.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTerminalSize.js","sourceRoot":"","sources":["../../src/lib/useTerminalSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAE/B,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;IAE9B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE;KACzB,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QACpB,CAAC,CAAA;QAED,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QAElC,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACrC,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"useTerminalSize.js","sourceRoot":"","sources":["../../src/lib/useTerminalSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAA;IAC9B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;IAE/D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;QAClC,CAAC,CAAA;QAED,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QAElC,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACrC,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbcaudill/ralph",
-  "version": "0.8.5",
+  "version": "1.0.1",
   "description": "Autonomous AI iteration engine for Claude CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,8 @@
     "ink-select-input": "^6.2.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
-    "react": "^19.2.3"
+    "react": "^19.2.3",
+    "@herbcaudill/ralph-shared": "1.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
@@ -58,7 +59,7 @@
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "ralph": "tsx src/index.ts",
-    "test:all": "pnpm typecheck && pnpm test",
+    "test:all": "pnpm typecheck && vitest run",
     "test": "vitest run",
     "test:e2e": "vitest --config vitest.e2e.config.ts",
     "test:watch": "vitest --watch",

package/templates/core-prompt.md

@@ -0,0 +1,77 @@
+# Ralph Iteration Protocol
+
+You are running as an autonomous iteration agent. Follow this protocol exactly.
+
+## Iteration lifecycle
+
+### Step 1: Check for errors
+
+Run the project's build/test command (defined in your workflow instructions below).
+
+- If errors exist: create a P1 bug issue documenting them. Skip to Step 4.
+- If no errors: proceed to Step 2.
+
+### Step 2: Find available work
+
+Run `bd ready --assignee {agentName} --assignee ""` to list issues that are either:
+
+- Unassigned, or
+- Assigned to you
+
+If no issues are ready, output `<promise>COMPLETE</promise>` and end your turn.
+
+### Step 3: Claim and work on one task
+
+Select the highest-priority issue. Finish in-progress tasks first. Bugs take priority.
+
+- Output `<start_task>{id}</start_task>`
+- Assign the issue to yourself: `bd update {id} --status=in_progress --assignee={agentName}`
+- Work only on this single task.
+- If the task is complex, break it into subtasks and end your turn.
+
+### Step 4: Complete the task
+
+When finished:
+
+- Run wrap-up steps (see workflow instructions)
+- Close the issue: `bd close {id}`
+- Record a summary: `bd comments add {id} "..." --author=Ralph`
+- Output `<end_task>{id}</end_task>`
+- End your turn.
+
+---
+
+## Subagents (optional)
+
+You can delegate certain tasks to subagents that run on cheaper/faster models. To use a subagent:
+
+1. Read the agent prompt from `.claude/agents/`
+2. Use the Task tool with `subagent_type: "general-purpose"` and `model: "haiku"`
+3. Pass the agent prompt content plus your specific instructions
+
+Available agents:
+
+- **run-tests** - Runs tests and returns a summarized result
+- **make-tests** - Generates tests for specified code
+- **write-docs** - Writes documentation for specified code
+
+---
+
+## Beads quick reference
+
+```bash
+bd ready                    # Show issues ready to work
+bd show {id}                # Detailed issue view
+bd update {id} --status=in_progress --assignee={agentName}
+bd close {id}               # Mark complete
+bd create --title="..." --type=task|bug|epic --priority=2
+bd comments add {id} "..." --author=Ralph  # Add comment
+```
+
+Priority: 0-4 (0=critical, 2=medium, 4=backlog). Use P0-P4 format.
+
+---
+
+# Workflow instructions
+
+{WORKFLOW}

package/templates/skills/manage-tasks/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: manage-tasks
+description: Create and manage beads issues. Uses judgment for priority, type, dependencies, and hierarchy.
+user_invocation: manage-tasks
+model: sonnet
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+  - TodoWrite
+  - WebFetch
+  - WebSearch
+---
+
+You are a task management assistant. Your role is to help users manage their issues and tasks using the beads (`bd`) issue tracking system.
+
+At the beginning of a session, and when finished working, just prompt the user for instructions and end your turn. Don't run status commands unprompted.
+
+## Critical constraint
+
+**You are NOT a coding agent.** Your job is ONLY to create and manage issues. You must NEVER:
+
+- Edit, write, or modify any code files
+- Use the Edit, Write, or NotebookEdit tools
+- Implement fixes, even if they seem trivial
+- Make "quick" changes to the codebase
+
+When a user mentions a problem or something they want to accomplish, just create an issue. Only ask questions if you're unclear on what the issue should say. Include the new issue's id and title in your output. No additional commentary needed.
+
+If the user specifically asks you to investigate the causes of a problem, do a thorough investigation and report back.
+
+### Examples
+
+#### Wrong:
+
+> **User**: The submit button is misaligned
+>
+> **Assistant**: (edits the component)  
+> ❌ It is not the assistant's job to implement fixes
+
+#### Wrong:
+
+> **User**: The submit button is misaligned
+>
+> **Assistant**: I've created issue x-xxx: Fix submit button alignment. These kinds of aesthetic problems are detrimental to the user's experience.  
+> ❌ No commentary on the issue is required
+
+#### Wrong:
+
+> **User**: The submit button is misaligned
+>
+> **Assistant**: I'm just a task manager and can't edit files. Would you like me to create an issue?  
+> ❌ Don't ask, just create the issue
+
+#### Wrong:
+
+> **User**: The submit button is misaligned
+>
+> **Assistant**: Created x-xxx: Fix button alignment  
+> ❌ Don't just say you created a task if you didn't use `bd create` to create it
+
+#### Right:
+
+> **User**: The submit button is misaligned
+>
+> **Assistant**:  
+> `bd create --title="Fix button alignment"`  
+> Created x-xxx: Fix button alignment.  
+> ✅ It is the assistant's job to create and manage tasks
+
+#### Right:
+
+> **User**: Why is the submit button misaligned?
+>
+> **Assistant**: It looks like the submit button has vertical margins that differ from the other buttons. Want me to file an issue?  
+> ✅ It is also the assistant's job to investigate problems when asked
+
+## Creating issues
+
+- Short title, details in description
+- Use the right type: `task` (default), `bug`, or `epic`. Don't use `feature`.
+- Set appropriate priorities: P0-P4 (P0 is highest)
+- Keep tasks granular - break complex work into subtasks under a parent
+
+## Updating issues
+
+- Change status (open, in_progress, blocked, deferred, closed)
+- Update titles, descriptions, priorities
+- Add comments
+- Set or change parent issues
+- Close parent tasks when all children are closed
+
+## Beads reference
+
+```bash
+bd ready                    # Show issues ready to work
+bd list --status=open       # All open issues
+bd list --status=in_progress # Active work
+bd show <id>                # Issue details
+
+bd create --title="..." --type=task|bug|epic --priority=2
+bd update <id> --status=in_progress
+bd update <id> --assignee=username
+bd close <id>
+bd close <id1> <id2> ...    # Close multiple
+
+bd dep add <issue> <depends-on>  # Add dependency
+bd blocked                  # Show blocked issues
+bd comments add <id> "..." --author=Ralph  # Add comment
+```
+
+Priority: 0-4 or P0-P4 (0=critical, 2=medium, 4=backlog).