@towles/tool 0.0.41 → 0.0.48

package/src/commands/ralph/task/add.ts

@@ -1,105 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import pc from "picocolors";
-import { BaseCommand } from "../../base.js";
-import {
-  DEFAULT_STATE_FILE,
-  DEFAULT_MAX_ITERATIONS,
-  loadState,
-  saveState,
-  createInitialState,
-  addTaskToState,
-  resolveRalphPath,
-} from "../lib/state.js";
-import { findSessionByMarker } from "../lib/marker.js";
-
-/**
- * Add a new task to ralph state
- */
-export default class TaskAdd extends BaseCommand {
-  static override description = "Add a new task";
-
-  static override examples = [
-    '<%= config.bin %> ralph task add "Fix the login bug"',
-    '<%= config.bin %> ralph task add "Implement feature X" --sessionId abc123',
-    '<%= config.bin %> ralph task add "Implement feature X" --findMarker RALPH_MARKER_abc123',
-    '<%= config.bin %> ralph task add "Backend refactor" --label backend',
-  ];
-
-  static override args = {
-    description: Args.string({
-      description: "Task description",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    stateFile: Flags.string({
-      char: "s",
-      description: `State file path (default: ${DEFAULT_STATE_FILE})`,
-    }),
-    sessionId: Flags.string({
-      description: "Claude session ID for resuming from prior research",
-    }),
-    findMarker: Flags.string({
-      char: "m",
-      description: "Find session by full marker (e.g., RALPH_MARKER_abc123)",
-    }),
-    label: Flags.string({
-      char: "l",
-      description: "Label for grouping/filtering tasks",
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(TaskAdd);
-    const ralphSettings = this.settings.settingsFile.settings.ralphSettings;
-    const stateFile = resolveRalphPath(flags.stateFile, "stateFile", ralphSettings);
-
-    const description = args.description.trim();
-
-    if (!description || description.length < 3) {
-      this.error("Task description too short (min 3 chars)");
-    }
-
-    // Resolve session ID from --sessionId or --findMarker
-    let sessionId = flags.sessionId;
-    let marker: string | undefined;
-    if (flags.findMarker) {
-      if (sessionId) {
-        this.error("Cannot use both --sessionId and --findMarker");
-      }
-      marker = flags.findMarker;
-      console.log(pc.dim(`Searching for marker: ${marker}...`));
-      sessionId = (await findSessionByMarker(marker)) ?? undefined;
-      if (!sessionId) {
-        this.error(
-          `Marker not found: ${marker}\nMake sure Claude output this marker during research.`,
-        );
-      }
-      console.log(pc.cyan(`Found session: ${sessionId.slice(0, 8)}...`));
-    }
-
-    let state = loadState(stateFile);
-
-    if (!state) {
-      state = createInitialState(DEFAULT_MAX_ITERATIONS);
-    }
-
-    const newTask = addTaskToState(state, description, sessionId, marker, flags.label);
-    saveState(state, stateFile);
-
-    console.log(pc.green(`✓ Added task #${newTask.id}: ${newTask.description}`));
-    if (flags.label) {
-      console.log(pc.cyan(`  Label: ${flags.label}`));
-    }
-    if (sessionId) {
-      console.log(pc.cyan(`  Session: ${sessionId.slice(0, 8)}...`));
-    }
-    if (marker) {
-      console.log(pc.dim(`  Marker: ${marker}`));
-    }
-    console.log(pc.dim(`State saved to: ${stateFile}`));
-    console.log(pc.dim(`Total tasks: ${state.tasks.length}`));
-  }
-}

package/src/commands/ralph/task/done.ts

@@ -1,73 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import pc from "picocolors";
-import { BaseCommand } from "../../base.js";
-import { DEFAULT_STATE_FILE, loadState, saveState, resolveRalphPath } from "../lib/state.js";
-
-/**
- * Mark a ralph task as done
- */
-export default class TaskDone extends BaseCommand {
-  static override description = "Mark a task as done by ID";
-
-  static override examples = [
-    "<%= config.bin %> ralph task done 1",
-    "<%= config.bin %> ralph task done 5 --stateFile custom-state.json",
-  ];
-
-  static override args = {
-    id: Args.integer({
-      description: "Task ID to mark done",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    stateFile: Flags.string({
-      char: "s",
-      description: `State file path (default: ${DEFAULT_STATE_FILE})`,
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(TaskDone);
-    const ralphSettings = this.settings.settingsFile.settings.ralphSettings;
-    const stateFile = resolveRalphPath(flags.stateFile, "stateFile", ralphSettings);
-
-    const taskId = args.id;
-
-    if (taskId < 1) {
-      this.error("Invalid task ID");
-    }
-
-    const state = loadState(stateFile);
-
-    if (!state) {
-      this.error(`No state file found at: ${stateFile}`);
-    }
-
-    const task = state.tasks.find((t) => t.id === taskId);
-
-    if (!task) {
-      this.error(`Task #${taskId} not found. Use: tt ralph task list`);
-    }
-
-    if (task.status === "done") {
-      console.log(pc.yellow(`Task #${taskId} is already done.`));
-      return;
-    }
-
-    task.status = "done";
-    task.completedAt = new Date().toISOString();
-    saveState(state, stateFile);
-
-    console.log(pc.green(`✓ Marked task #${taskId} as done: ${task.description}`));
-
-    const remaining = state.tasks.filter((t) => t.status !== "done").length;
-    if (remaining === 0) {
-      console.log(pc.bold(pc.green("All tasks complete!")));
-    } else {
-      console.log(pc.dim(`Remaining tasks: ${remaining}`));
-    }
-  }
-}

package/src/commands/ralph/task/remove.ts

@@ -1,62 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import pc from "picocolors";
-import { BaseCommand } from "../../base.js";
-import { DEFAULT_STATE_FILE, loadState, saveState, resolveRalphPath } from "../lib/state.js";
-
-/**
- * Remove a ralph task by ID
- */
-export default class TaskRemove extends BaseCommand {
-  static override description = "Remove a task by ID";
-
-  static override examples = [
-    "<%= config.bin %> ralph task remove 1",
-    "<%= config.bin %> ralph task remove 5 --stateFile custom-state.json",
-  ];
-
-  static override args = {
-    id: Args.integer({
-      description: "Task ID to remove",
-      required: true,
-    }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    stateFile: Flags.string({
-      char: "s",
-      description: `State file path (default: ${DEFAULT_STATE_FILE})`,
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(TaskRemove);
-    const ralphSettings = this.settings.settingsFile.settings.ralphSettings;
-    const stateFile = resolveRalphPath(flags.stateFile, "stateFile", ralphSettings);
-
-    const taskId = args.id;
-
-    if (taskId < 1) {
-      this.error("Invalid task ID");
-    }
-
-    const state = loadState(stateFile);
-
-    if (!state) {
-      this.error(`No state file found at: ${stateFile}`);
-    }
-
-    const taskIndex = state.tasks.findIndex((t) => t.id === taskId);
-
-    if (taskIndex === -1) {
-      this.error(`Task #${taskId} not found. Use: tt ralph task list`);
-    }
-
-    const removedTask = state.tasks[taskIndex];
-    state.tasks.splice(taskIndex, 1);
-    saveState(state, stateFile);
-
-    console.log(pc.green(`✓ Removed task #${taskId}: ${removedTask.description}`));
-    console.log(pc.dim(`Remaining tasks: ${state.tasks.length}`));
-  }
-}

package/src/config/context.ts

@@ -1,7 +0,0 @@
-import type { SettingsFile } from "./settings";
-
-export interface Context {
-  cwd: string;
-  settingsFile: SettingsFile;
-  debug: boolean;
-}

package/src/constants.ts

@@ -1,3 +0,0 @@
-export const AppInfo = {
-  toolName: "towles-tool",
-} as const;

package/src/utils/anthropic/types.ts

@@ -1,158 +0,0 @@
-import type {
-  ContentBlock,
-  ContentBlockParam,
-  Message,
-  MessageParam,
-} from "@anthropic-ai/sdk/resources"; // only used for types
-import { z } from "zod/v4";
-
-// This file defines types and interfaces for Claude SDK messages and related structures.
-// copied from https://github.com/tuanemuy/cc-jsonl/blob/main/src/core/domain/claude/types.ts
-// which is also using the Anthropic claude-code package.
-
-export const sendMessageInputSchema = z.object({
-  message: z.string().min(1),
-  sessionId: z.string().optional(),
-  cwd: z.string().optional(),
-  allowedTools: z.array(z.string()).optional(),
-  bypassPermissions: z.boolean().optional(),
-});
-export type SendMessageInput = z.infer<typeof sendMessageInputSchema>;
-
-export type AssistantContent = ContentBlock[];
-export type UserContent = string | ContentBlockParam[];
-
-export interface AssistantMessage {
-  type: "assistant";
-  message: Message; // From Anthropic SDK
-  session_id: string;
-}
-
-export function isAssistantMessage(message: SDKMessage): message is AssistantMessage {
-  return message.type === "assistant";
-}
-
-export interface UserMessage {
-  type: "user";
-  message: MessageParam; // Anthropic SDK
-  session_id: string;
-}
-
-export function isUserMessage(message: SDKMessage): message is UserMessage {
-  return message.type === "user";
-}
-
-export interface ResultMessage {
-  type: "result";
-  subtype: "success" | "error_max_turns" | "error_during_execution";
-  duration_ms: number;
-  duration_api_ms: number;
-  is_error: boolean;
-  num_turns: number;
-  result?: string; // Only on success
-  session_id: string;
-  total_cost_usd: number;
-}
-
-export function isResultMessage(message: SDKMessage): message is ResultMessage {
-  return message.type === "result";
-}
-
-export interface SystemMessage {
-  type: "system";
-  subtype: "init";
-  apiKeySource: string;
-  cwd: string;
-  session_id: string;
-  tools: string[];
-  mcp_servers: {
-    name: string;
-    status: string;
-  }[];
-  model: string;
-  permissionMode: "default" | "acceptEdits" | "bypassPermissions" | "plan";
-}
-
-export function isSystemMessage(message: SDKMessage): message is SystemMessage {
-  return message.type === "system";
-}
-
-export type SDKMessage = AssistantMessage | UserMessage | ResultMessage | SystemMessage;
-
-// ChunkData is simply an SDKMessage
-// The SDK already provides messages in the appropriate granularity for streaming
-export type ChunkData = SDKMessage;
-
-// Tool result type for handling tool execution results
-export interface ToolResult {
-  type: "tool_result";
-  tool_use_id: string;
-  content?: string | Record<string, unknown>[];
-  is_error?: boolean;
-}
-
-export function isToolResult(obj: unknown): obj is ToolResult {
-  return (
-    typeof obj === "object" &&
-    obj !== null &&
-    "type" in obj &&
-    obj.type === "tool_result" &&
-    "tool_use_id" in obj &&
-    typeof (obj as ToolResult).tool_use_id === "string"
-  );
-}
-
-// Type guard helpers for parseSDKMessage - use unknown input to allow type narrowing
-function isValidAssistantMessage(obj: unknown): obj is AssistantMessage {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj as Record<string, unknown>;
-  return (
-    o.type === "assistant" &&
-    o.message !== null &&
-    typeof o.message === "object" &&
-    typeof o.session_id === "string"
-  );
-}
-
-function isValidUserMessage(obj: unknown): obj is UserMessage {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj as Record<string, unknown>;
-  return (
-    o.type === "user" &&
-    o.message !== null &&
-    typeof o.message === "object" &&
-    typeof o.session_id === "string"
-  );
-}
-
-function isValidResultMessage(obj: unknown): obj is ResultMessage {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj as Record<string, unknown>;
-  return (
-    o.type === "result" &&
-    typeof o.session_id === "string" &&
-    typeof o.subtype === "string" &&
-    typeof o.duration_ms === "number" &&
-    typeof o.is_error === "boolean"
-  );
-}
-
-function isValidSystemMessage(obj: unknown): obj is SystemMessage {
-  if (typeof obj !== "object" || obj === null) return false;
-  const o = obj as Record<string, unknown>;
-  return (
-    o.type === "system" &&
-    typeof o.session_id === "string" &&
-    typeof o.subtype === "string" &&
-    typeof o.cwd === "string"
-  );
-}
-
-// Helper function to safely parse SDKMessage
-export function parseSDKMessage(data: unknown): SDKMessage | null {
-  if (isValidAssistantMessage(data)) return data;
-  if (isValidUserMessage(data)) return data;
-  if (isValidResultMessage(data)) return data;
-  if (isValidSystemMessage(data)) return data;
-  return null;
-}

package/src/utils/exec.ts

@@ -1,8 +0,0 @@
-import { execSync } from "node:child_process";
-
-// TODO change to use tinyexec or similar for better error handling
-export function execCommand(cmd: string, cwd?: string) {
-  // Note about execSync, if the command fails or times out, it might not throw an error,
-  // if the child process intercepts the SIGTERM signal, we might not get an error.
-  return execSync(cmd, { encoding: "utf8", cwd }).trim();
-}

package/src/utils/git/git.ts

@@ -1,25 +0,0 @@
-// unJs/changelogen has some nice utilities for git
-import { execCommand } from "../exec";
-
-// using logic from https://github.com/unjs/changelogen/blob/main/src/git.ts
-
-export async function getGitDiff(cwd: string): Promise<string> {
-  // https://git-scm.com/docs/pretty-formats
-  let r = execCommand(
-    // `git --no-pager log "${from ? `${from}...` : ''}${to}"  `,
-    // using --cached because staged didn't work on MacOS
-    `git --no-pager diff --cached`,
-    // --name-status
-    // --pretty="----%n%s|%h|%an|%ae%n%b"
-    cwd,
-  );
-
-  // Limit output to 1000 lines maximum
-  const lines = r.split("\n");
-  if (lines.length > 1000) {
-    r = lines.slice(0, 1000).join("\n");
-    r += `\n\n[Output truncated to 1000 lines]`;
-  }
-
-  return r;
-}