@towles/tool 0.0.53 → 0.0.55

package/src/lib/ralph/execution.ts

@@ -1,292 +0,0 @@
-import type { WriteStream } from "node:fs";
-// NOTE: We use spawn instead of tinyexec for runIteration because we need
-// real-time streaming of stdout/stderr. tinyexec waits for command completion
-// before returning output, which doesn't work for long-running claude sessions.
-import { spawn } from "node:child_process";
-import pc from "picocolors";
-import { x } from "tinyexec";
-import { CLAUDE_DEFAULT_ARGS } from "./state.js";
-
-// ============================================================================
-// Types
-// ============================================================================
-
-interface StreamEvent {
-  type: string;
-  message?: {
-    content?: Array<{ type: string; text?: string }>;
-    usage?: {
-      input_tokens?: number;
-      output_tokens?: number;
-      cache_read_input_tokens?: number;
-      cache_creation_input_tokens?: number;
-    };
-  };
-  result?: string;
-  total_cost_usd?: number;
-  num_turns?: number;
-  session_id?: string;
-  usage?: {
-    input_tokens?: number;
-    output_tokens?: number;
-    cache_read_input_tokens?: number;
-    cache_creation_input_tokens?: number;
-  };
-}
-
-// Claude model context windows (tokens)
-const MODEL_CONTEXT_WINDOWS: Record<string, number> = {
-  "claude-sonnet-4-20250514": 200000,
-  "claude-opus-4-20250514": 200000,
-  "claude-3-5-sonnet-20241022": 200000,
-  "claude-3-opus-20240229": 200000,
-  default: 200000,
-};
-
-export interface IterationResult {
-  output: string;
-  exitCode: number;
-  contextUsedPercent?: number;
-  sessionId?: string;
-}
-
-interface ParsedLine {
-  text: string | null;
-  tool?: { name: string; summary: string };
-  usage?: StreamEvent["usage"];
-  sessionId?: string;
-}
-
-// ============================================================================
-// Claude CLI Check
-// ============================================================================
-
-export async function checkClaudeCli(): Promise<boolean> {
-  try {
-    const result = await x("which", ["claude"]);
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-
-// ============================================================================
-// Stream Parsing
-// ============================================================================
-
-// Track accumulated text from assistant messages to compute deltas
-let lastAssistantText = "";
-
-/**
- * Reset stream parsing state between iterations.
- */
-export function resetStreamState(): void {
-  lastAssistantText = "";
-}
-
-function summarizeTool(name: string, input: Record<string, unknown>): string {
-  switch (name) {
-    case "Read":
-      return (
-        String(input.file_path || input.path || "")
-          .split("/")
-          .pop() || "file"
-      );
-    case "Write":
-    case "Edit":
-      return (
-        String(input.file_path || input.path || "")
-          .split("/")
-          .pop() || "file"
-      );
-    case "Glob":
-      return String(input.pattern || "");
-    case "Grep":
-      return String(input.pattern || "");
-    case "Bash":
-      return String(input.command || "").substring(0, 40);
-    case "TodoWrite":
-      return "updating todos";
-    default:
-      return Object.values(input)[0]?.toString().substring(0, 30) || "";
-  }
-}
-
-function parseStreamLine(line: string): ParsedLine {
-  if (!line.trim()) return { text: null };
-  try {
-    const data = JSON.parse(line) as StreamEvent & {
-      tool_use?: { name: string; input: Record<string, unknown> };
-      content_block?: { type: string; name?: string; input?: Record<string, unknown> };
-    };
-
-    // Handle tool_use events
-    if (data.type === "tool_use" && data.tool_use) {
-      const name = data.tool_use.name;
-      const summary = summarizeTool(name, data.tool_use.input || {});
-      return { text: null, tool: { name, summary } };
-    }
-
-    // Handle content_block with tool_use (streaming format)
-    if (data.type === "content_block" && data.content_block?.type === "tool_use") {
-      const name = data.content_block.name || "Tool";
-      const summary = summarizeTool(name, data.content_block.input || {});
-      return { text: null, tool: { name, summary } };
-    }
-
-    // Handle assistant messages with content array
-    if (data.type === "assistant" && data.message) {
-      // Check for tool_use in content blocks
-      const toolBlocks = data.message.content?.filter((c) => c.type === "tool_use") || [];
-      if (toolBlocks.length > 0) {
-        const tb = toolBlocks[toolBlocks.length - 1] as {
-          name?: string;
-          input?: Record<string, unknown>;
-        };
-        const name = tb.name || "Tool";
-        const summary = summarizeTool(name, tb.input || {});
-        return {
-          text: null,
-          tool: { name, summary },
-          usage: data.message.usage || data.usage,
-          sessionId: data.session_id,
-        };
-      }
-
-      // Extract full text from content blocks
-      const fullText =
-        data.message.content
-          ?.filter((c) => c.type === "text" && c.text)
-          .map((c) => c.text)
-          .join("") || "";
-
-      // Compute delta (only new portion) to avoid duplicate output
-      let delta: string | null = null;
-      if (fullText.startsWith(lastAssistantText)) {
-        delta = fullText.slice(lastAssistantText.length) || null;
-      } else {
-        // Text doesn't match prefix - new context
-        delta = fullText || null;
-      }
-      lastAssistantText = fullText;
-
-      return { text: delta, usage: data.message.usage || data.usage, sessionId: data.session_id };
-    }
-    // Capture final result with usage and session_id
-    if (data.type === "result") {
-      const resultText = data.result
-        ? `\n[Result: ${data.result.substring(0, 100)}${data.result.length > 100 ? "..." : ""}]\n`
-        : null;
-      return { text: resultText, usage: data.usage, sessionId: data.session_id };
-    }
-  } catch {
-    // Not JSON, return raw
-    return { text: line };
-  }
-  return { text: null };
-}
-
-// ============================================================================
-// Run Iteration
-// ============================================================================
-
-export async function runIteration(
-  prompt: string,
-  claudeArgs: string[],
-  logStream?: WriteStream,
-): Promise<IterationResult> {
-  // Reset accumulated text state from previous iteration
-  resetStreamState();
-
-  // Pass task context as system prompt via --append-system-prompt
-  // 'continue' is the user prompt - required by claude CLI when using --print
-  const allArgs = [
-    ...CLAUDE_DEFAULT_ARGS,
-    ...claudeArgs,
-    "--append-system-prompt",
-    prompt,
-    "continue",
-  ];
-
-  let output = "";
-  let lineBuffer = "";
-  let finalUsage: StreamEvent["usage"] | undefined;
-  let sessionId: string | undefined;
-  let lastCharWasNewline = true;
-
-  const processLine = (line: string) => {
-    const { text: parsed, tool, usage, sessionId: sid } = parseStreamLine(line);
-    if (usage) finalUsage = usage;
-    if (sid) sessionId = sid;
-    if (tool) {
-      const prefix = lastCharWasNewline ? "" : "\n";
-      const toolLine = `${prefix}${pc.yellow("⚡")} ${pc.cyan(tool.name)}: ${tool.summary}\n`;
-      process.stdout.write(toolLine);
-      logStream?.write(`${prefix}⚡ ${tool.name}: ${tool.summary}\n`);
-      lastCharWasNewline = true;
-    }
-    if (parsed) {
-      process.stdout.write(parsed);
-      logStream?.write(parsed);
-      output += parsed;
-      lastCharWasNewline = parsed.endsWith("\n");
-    }
-  };
-
-  return new Promise((resolve) => {
-    const proc = spawn("claude", allArgs, {
-      stdio: ["inherit", "pipe", "pipe"],
-    });
-
-    proc.stdout.on("data", (chunk: Buffer) => {
-      const text = chunk.toString();
-      lineBuffer += text;
-
-      const lines = lineBuffer.split("\n");
-      lineBuffer = lines.pop() || "";
-
-      for (const line of lines) {
-        processLine(line);
-      }
-    });
-
-    proc.stderr.on("data", (chunk: Buffer) => {
-      const text = chunk.toString();
-      process.stderr.write(text);
-      logStream?.write(text);
-      output += text;
-    });
-
-    proc.on("close", (code: number | null) => {
-      if (lineBuffer) {
-        processLine(lineBuffer);
-      }
-
-      if (output && !output.endsWith("\n")) {
-        process.stdout.write("\n");
-        logStream?.write("\n");
-        output += "\n";
-      }
-
-      // Calculate context usage percent
-      let contextUsedPercent: number | undefined;
-      if (finalUsage) {
-        const totalTokens =
-          (finalUsage.input_tokens || 0) +
-          (finalUsage.output_tokens || 0) +
-          (finalUsage.cache_read_input_tokens || 0) +
-          (finalUsage.cache_creation_input_tokens || 0);
-        const maxContext = MODEL_CONTEXT_WINDOWS.default;
-        contextUsedPercent = Math.round((totalTokens / maxContext) * 100);
-      }
-
-      resolve({ output, exitCode: code ?? 0, contextUsedPercent, sessionId });
-    });
-
-    proc.on("error", (err: Error) => {
-      console.error(pc.red(`Error running claude: ${err}`));
-      logStream?.write(`Error running claude: ${err}\n`);
-      resolve({ output, exitCode: 1 });
-    });
-  });
-}

package/src/lib/ralph/formatter.ts

@@ -1,240 +0,0 @@
-import { execFileSync } from "node:child_process";
-import * as path from "node:path";
-import type { RalphPlan, PlanStatus, RalphState } from "./state.js";
-
-// ============================================================================
-// Clipboard Utility
-// ============================================================================
-
-export function copyToClipboard(text: string): boolean {
-  try {
-    const platform = process.platform;
-    if (platform === "darwin") {
-      execFileSync("pbcopy", [], { input: text });
-    } else if (platform === "linux") {
-      // Try xclip first, then xsel
-      try {
-        execFileSync("xclip", ["-selection", "clipboard"], { input: text });
-      } catch {
-        execFileSync("xsel", ["--clipboard", "--input"], { input: text });
-      }
-    } else if (platform === "win32") {
-      execFileSync("clip", [], { input: text });
-    } else {
-      return false;
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Format plans as markdown with checkboxes and status badges.
- */
-export function formatPlansAsMarkdown(plans: RalphPlan[]): string {
-  if (plans.length === 0) {
-    return "# Plans\n\nNo plans.\n";
-  }
-
-  const statusBadge = (status: PlanStatus): string => {
-    switch (status) {
-      case "done":
-        return "`✓ done`";
-      case "ready":
-        return "`○ ready`";
-      case "blocked":
-        return "`⏸ blocked`";
-      case "cancelled":
-        return "`✗ cancelled`";
-    }
-  };
-
-  const ready = plans.filter((p) => p.status === "ready");
-  const done = plans.filter((p) => p.status === "done");
-
-  const lines: string[] = ["# Plans", ""];
-  lines.push(
-    `**Total:** ${plans.length} | **Done:** ${done.length} | **Ready:** ${ready.length}`,
-    "",
-  );
-
-  if (ready.length > 0) {
-    lines.push("## Ready", "");
-    for (const p of ready) {
-      const errorSuffix = p.error ? ` ⚠️ ${p.error}` : "";
-      lines.push(`- [ ] **#${p.id}** ${p.planFilePath} ${statusBadge(p.status)}${errorSuffix}`);
-    }
-    lines.push("");
-  }
-
-  if (done.length > 0) {
-    lines.push("## Done", "");
-    for (const p of done) {
-      lines.push(`- [x] **#${p.id}** ${p.planFilePath} ${statusBadge(p.status)}`);
-    }
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Format plans with markdown and optional mermaid graph.
- */
-export function formatPlanAsMarkdown(plans: RalphPlan[], state: RalphState): string {
-  const lines: string[] = ["# Ralph Plan", ""];
-
-  // Summary section
-  const ready = plans.filter((p) => p.status === "ready").length;
-  const done = plans.filter((p) => p.status === "done").length;
-
-  lines.push("## Summary", "");
-  lines.push(`- **Status:** ${state.status}`);
-  lines.push(`- **Total:** ${plans.length}`);
-  lines.push(`- **Done:** ${done} | **Ready:** ${ready}`);
-  lines.push("");
-
-  // Plans section with checkboxes
-  lines.push("## Plans", "");
-  for (const p of plans) {
-    const checkbox = p.status === "done" ? "[x]" : "[ ]";
-    const status = p.status === "done" ? "`done`" : "`ready`";
-    const errorSuffix = p.error ? ` ⚠️ ${p.error}` : "";
-    lines.push(`- ${checkbox} **#${p.id}** ${p.planFilePath} ${status}${errorSuffix}`);
-  }
-  lines.push("");
-
-  // Mermaid graph section
-  lines.push("## Progress Graph", "");
-  lines.push("```mermaid");
-  lines.push("graph LR");
-  lines.push(`    subgraph Progress["Plans: ${done}/${plans.length} done"]`);
-
-  for (const p of plans) {
-    const filename = path.basename(p.planFilePath);
-    const shortName = filename.length > 30 ? filename.slice(0, 27) + "..." : filename;
-    // Escape quotes in filenames
-    const safeName = shortName.replace(/"/g, "'");
-    const nodeId = `P${p.id}`;
-
-    if (p.status === "done") {
-      lines.push(`        ${nodeId}["#${p.id}: ${safeName}"]:::done`);
-    } else {
-      lines.push(`        ${nodeId}["#${p.id}: ${safeName}"]:::ready`);
-    }
-  }
-
-  lines.push("    end");
-  lines.push("    classDef done fill:#22c55e,color:#fff");
-  lines.push("    classDef ready fill:#94a3b8,color:#000");
-  lines.push("```");
-  lines.push("");
-
-  return lines.join("\n");
-}
-
-/**
- * Format plans as JSON for programmatic consumption.
- */
-export function formatPlanAsJson(plans: RalphPlan[], state: RalphState): string {
-  return JSON.stringify(
-    {
-      status: state.status,
-      summary: {
-        total: plans.length,
-        done: plans.filter((p) => p.status === "done").length,
-        ready: plans.filter((p) => p.status === "ready").length,
-      },
-      plans: plans.map((p) => ({
-        id: p.id,
-        planFilePath: p.planFilePath,
-        status: p.status,
-        addedAt: p.addedAt,
-        completedAt: p.completedAt,
-        error: p.error,
-      })),
-    },
-    null,
-    2,
-  );
-}
-
-// ============================================================================
-// Duration Formatting
-// ============================================================================
-
-export function formatDuration(ms: number): string {
-  const seconds = Math.floor(ms / 1000);
-  const minutes = Math.floor(seconds / 60);
-  const hours = Math.floor(minutes / 60);
-
-  if (hours > 0) {
-    const remainingMins = minutes % 60;
-    return `${hours}h ${remainingMins}m`;
-  }
-  if (minutes > 0) {
-    const remainingSecs = seconds % 60;
-    return `${minutes}m ${remainingSecs}s`;
-  }
-  return `${seconds}s`;
-}
-
-// ============================================================================
-// Output Summary
-// ============================================================================
-
-export function extractOutputSummary(output: string, maxLength: number = 2000): string {
-  const lines = output
-    .split("\n")
-    .filter((l) => l.trim())
-    .slice(-5);
-  let summary = lines.join(" ").trim();
-
-  if (summary.length > maxLength) {
-    summary = summary.substring(0, maxLength) + "...";
-  }
-
-  return summary || "(no output)";
-}
-
-// ============================================================================
-// Prompt Building
-// ============================================================================
-
-export interface BuildPromptOptions {
-  completionMarker: string;
-  taskDoneMarker: string;
-  plan: RalphPlan;
-  skipCommit?: boolean;
-}
-
-export function buildIterationPrompt({
-  completionMarker,
-  taskDoneMarker,
-  plan,
-  skipCommit = false,
-}: BuildPromptOptions): string {
-  let step = 1;
-
-  const prompt = `
-  <instructions>
-${step++}. Read Plan: \`${plan.planFilePath}\`
-${step++}. Choose next best task to work on.
-${step++}. Complete that task.
-${step++}. Update the plan \`${plan.planFilePath}\` to mark that task Done with any notes.
-${skipCommit ? "" : `${step++}. Make a git commit.`}
-${step++}. If any tasks remain return <promise>${taskDoneMarker}</promise> else if plan is complete return <promise>${completionMarker}</promise>.
-
-</instructions>
-`;
-  return prompt.trim();
-}
-
-// ============================================================================
-// Marker Detection
-// ============================================================================
-
-export function detectCompletionMarker(output: string, marker: string): boolean {
-  return output.includes(marker);
-}

package/src/lib/ralph/index.ts

@@ -1,4 +0,0 @@
-// Re-export all modules for external use
-export * from "./state.js";
-export * from "./formatter.js";
-export * from "./execution.js";