@towles/tool 0.0.41 → 0.0.48

package/src/commands/observe/setup.ts

@@ -1,180 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { homedir } from "node:os";
-import pc from "picocolors";
-import consola from "consola";
-import { BaseCommand } from "../base.js";
-
-const CLAUDE_DIR = path.join(homedir(), ".claude");
-const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
-const REPORTS_DIR = path.join(CLAUDE_DIR, "reports");
-
-interface ClaudeSettings {
-  cleanupPeriodDays?: number;
-  alwaysThinkingEnabled?: boolean;
-  env?: Record<string, string>;
-  hooks?: {
-    SubagentStop?: Array<{
-      matcher?: Record<string, unknown>;
-      hooks?: Array<{
-        type: string;
-        command: string;
-      }>;
-    }>;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-
-const OTEL_ENV_VARS: Record<string, string> = {
-  CLAUDE_CODE_ENABLE_TELEMETRY: "1",
-  OTEL_METRICS_EXPORTER: "otlp",
-  OTEL_LOGS_EXPORTER: "otlp",
-  OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4317",
-};
-
-/**
- * Configure observability settings for Claude Code
- */
-export default class ObserveSetup extends BaseCommand {
-  static override description = "Configure Claude Code observability settings";
-
-  static override examples = [
-    "<%= config.bin %> observe setup",
-    "<%= config.bin %> observe setup  # Adds SubagentStop hook for lineage tracking",
-  ];
-
-  async run(): Promise<void> {
-    await this.parse(ObserveSetup);
-
-    this.log(pc.bold("\n📊 Claude Code Observability Setup\n"));
-
-    // Load or create Claude settings
-    let claudeSettings: ClaudeSettings = {};
-    if (fs.existsSync(CLAUDE_SETTINGS_PATH)) {
-      try {
-        const content = fs.readFileSync(CLAUDE_SETTINGS_PATH, "utf-8");
-        claudeSettings = JSON.parse(content);
-        this.log(pc.dim(`Found existing Claude settings at ${CLAUDE_SETTINGS_PATH}`));
-      } catch {
-        this.log(
-          pc.yellow(`Warning: Could not parse ${CLAUDE_SETTINGS_PATH}, will create fresh settings`),
-        );
-      }
-    } else {
-      this.log(pc.dim(`No Claude settings file found, will create one`));
-    }
-
-    let modified = false;
-
-    // 1. Ensure cleanupPeriodDays is set to prevent log deletion
-    if (claudeSettings.cleanupPeriodDays !== 99999) {
-      claudeSettings.cleanupPeriodDays = 99999;
-      modified = true;
-      this.log(pc.green("✓ Set cleanupPeriodDays: 99999 (prevent log deletion)"));
-    } else {
-      this.log(pc.dim("✓ cleanupPeriodDays already set to 99999"));
-    }
-
-    // 2. Configure SubagentStop hook for lineage tracking
-    const subagentLogPath = path.join(REPORTS_DIR, "subagent-log.jsonl");
-    const subagentHookCommand = `jq -c '. + {parent: env.SESSION_ID, timestamp: now}' >> ${subagentLogPath}`;
-
-    if (!claudeSettings.hooks) {
-      claudeSettings.hooks = {};
-    }
-
-    const existingSubagentHook = claudeSettings.hooks.SubagentStop;
-    const hasSubagentHook =
-      existingSubagentHook &&
-      Array.isArray(existingSubagentHook) &&
-      existingSubagentHook.length > 0;
-
-    if (!hasSubagentHook) {
-      claudeSettings.hooks.SubagentStop = [
-        {
-          hooks: [
-            {
-              type: "command",
-              command: subagentHookCommand,
-            },
-          ],
-        },
-      ];
-      modified = true;
-      this.log(pc.green("✓ Added SubagentStop hook for subagent lineage tracking"));
-    } else {
-      this.log(pc.dim("✓ SubagentStop hook already configured"));
-    }
-
-    // 3. Add OTEL environment variables to settings
-    if (!claudeSettings.env) {
-      claudeSettings.env = {};
-    }
-
-    const addedVars: string[] = [];
-    const skippedVars: string[] = [];
-    for (const [key, value] of Object.entries(OTEL_ENV_VARS)) {
-      if (claudeSettings.env[key] === undefined) {
-        claudeSettings.env[key] = value;
-        addedVars.push(key);
-        modified = true;
-      } else {
-        skippedVars.push(key);
-      }
-    }
-
-    if (addedVars.length > 0) {
-      this.log(pc.green(`✓ Added env vars: ${addedVars.join(", ")}`));
-    }
-    if (skippedVars.length > 0) {
-      this.log(pc.dim(`✓ Env vars already set: ${skippedVars.join(", ")}`));
-    }
-
-    // Save settings if modified
-    if (modified) {
-      this.saveClaudeSettings(claudeSettings);
-      this.log(pc.green(`\n✓ Saved settings to ${CLAUDE_SETTINGS_PATH}`));
-    }
-
-    // 4. Create reports directory
-    if (!fs.existsSync(REPORTS_DIR)) {
-      fs.mkdirSync(REPORTS_DIR, { recursive: true });
-      this.log(pc.green(`✓ Created reports directory at ${REPORTS_DIR}`));
-    } else {
-      this.log(pc.dim(`✓ Reports directory exists at ${REPORTS_DIR}`));
-    }
-
-    // 5. Show OTEL environment variables setup
-    this.log(pc.bold("\n🔧 OTEL Environment Variables\n"));
-    this.log(pc.cyan("Add these to your shell profile (~/.bashrc, ~/.zshrc, etc.):\n"));
-
-    consola.box(`export CLAUDE_CODE_ENABLE_TELEMETRY=1
-export OTEL_METRICS_EXPORTER=otlp
-export OTEL_LOGS_EXPORTER=otlp
-export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317`);
-
-    this.log("");
-    this.log(pc.dim("For a full monitoring stack, see:"));
-    this.log(pc.dim("  https://github.com/anthropics/claude-code-monitoring-guide"));
-    this.log("");
-
-    // Quick usage tips
-    this.log(pc.bold("📈 Quick Analysis Commands\n"));
-    this.log(pc.dim("  tt observe status     # Check current config"));
-    this.log(pc.dim("  tt observe report     # Token/cost breakdown"));
-    this.log(pc.dim("  tt observe session    # List sessions"));
-    this.log(pc.dim("  tt observe graph     # Visualize token usage"));
-    this.log("");
-
-    this.log(pc.bold(pc.green("✅ Observability setup complete!\n")));
-  }
-
-  private saveClaudeSettings(settings: ClaudeSettings): void {
-    const dir = path.dirname(CLAUDE_SETTINGS_PATH);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2));
-  }
-}

package/src/commands/observe/status.ts

@@ -1,146 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { homedir } from "node:os";
-import pc from "picocolors";
-import { BaseCommand } from "../base.js";
-
-const CLAUDE_DIR = path.join(homedir(), ".claude");
-const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
-const REPORTS_DIR = path.join(CLAUDE_DIR, "reports");
-
-interface ClaudeSettings {
-  cleanupPeriodDays?: number;
-  alwaysThinkingEnabled?: boolean;
-  hooks?: {
-    SubagentStop?: unknown[];
-    PreToolUse?: unknown[];
-    PostToolUse?: unknown[];
-    Stop?: unknown[];
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-
-/**
- * Display current observability configuration status
- */
-export default class ObserveStatus extends BaseCommand {
-  static override description = "Display current observability configuration status";
-
-  static override examples = [
-    "<%= config.bin %> observe status",
-    "<%= config.bin %> observe status  # Check if observability is properly configured",
-  ];
-
-  async run(): Promise<void> {
-    await this.parse(ObserveStatus);
-
-    this.log(pc.bold("\n📊 Observability Status\n"));
-
-    // Load Claude settings
-    let settings: ClaudeSettings = {};
-    if (fs.existsSync(CLAUDE_SETTINGS_PATH)) {
-      try {
-        const content = fs.readFileSync(CLAUDE_SETTINGS_PATH, "utf-8");
-        settings = JSON.parse(content);
-      } catch {
-        this.log(pc.red(`✗ Could not parse ${CLAUDE_SETTINGS_PATH}`));
-      }
-    } else {
-      this.log(pc.yellow(`⚠ No settings file at ${CLAUDE_SETTINGS_PATH}`));
-      this.log(pc.dim("  Run: tt observe setup"));
-      this.log("");
-    }
-
-    // 1. Claude Settings
-    this.log(pc.bold("Claude Settings"));
-    this.log(pc.dim(`  Path: ${CLAUDE_SETTINGS_PATH}\n`));
-
-    // cleanupPeriodDays
-    const cleanup = settings.cleanupPeriodDays;
-    if (cleanup === 99999) {
-      this.log(pc.green("  ✓ cleanupPeriodDays: 99999 (logs preserved)"));
-    } else if (cleanup !== undefined) {
-      this.log(pc.yellow(`  ⚠ cleanupPeriodDays: ${cleanup} (logs may be deleted)`));
-    } else {
-      this.log(pc.red("  ✗ cleanupPeriodDays: not set (default cleanup applies)"));
-    }
-
-    // alwaysThinkingEnabled
-    if (settings.alwaysThinkingEnabled) {
-      this.log(pc.green("  ✓ alwaysThinkingEnabled: true"));
-    } else {
-      this.log(pc.dim("  ○ alwaysThinkingEnabled: false"));
-    }
-
-    this.log("");
-
-    // 2. Hooks
-    this.log(pc.bold("Hooks Configured"));
-    const hooks = settings.hooks || {};
-    const hookNames = ["SubagentStop", "PreToolUse", "PostToolUse", "Stop"];
-    let hasAnyHook = false;
-
-    for (const name of hookNames) {
-      const hook = hooks[name];
-      if (hook && Array.isArray(hook) && hook.length > 0) {
-        this.log(pc.green(`  ✓ ${name}: ${hook.length} handler(s)`));
-        hasAnyHook = true;
-      }
-    }
-
-    // Check for other hooks
-    const otherHooks = Object.keys(hooks).filter((k) => !hookNames.includes(k));
-    for (const name of otherHooks) {
-      const hook = hooks[name];
-      if (hook && Array.isArray(hook) && hook.length > 0) {
-        this.log(pc.green(`  ✓ ${name}: ${(hook as unknown[]).length} handler(s)`));
-        hasAnyHook = true;
-      }
-    }
-
-    if (!hasAnyHook) {
-      this.log(pc.dim("  ○ No hooks configured"));
-    }
-
-    this.log("");
-
-    // 3. Reports Directory
-    this.log(pc.bold("Reports Directory"));
-    if (fs.existsSync(REPORTS_DIR)) {
-      const files = fs.readdirSync(REPORTS_DIR);
-      this.log(pc.green(`  ✓ ${REPORTS_DIR}`));
-      this.log(pc.dim(`    ${files.length} file(s)`));
-    } else {
-      this.log(pc.yellow(`  ⚠ ${REPORTS_DIR} does not exist`));
-      this.log(pc.dim("    Run: tt observe setup"));
-    }
-
-    this.log("");
-
-    // 4. OTEL Environment Variables
-    this.log(pc.bold("OTEL Environment Variables"));
-
-    const otelVars = [
-      { name: "CLAUDE_CODE_ENABLE_TELEMETRY", expected: "1" },
-      { name: "OTEL_METRICS_EXPORTER", expected: "otlp" },
-      { name: "OTEL_LOGS_EXPORTER", expected: "otlp" },
-      { name: "OTEL_EXPORTER_OTLP_ENDPOINT", expected: undefined },
-    ];
-
-    for (const { name, expected } of otelVars) {
-      const value = process.env[name];
-      if (value) {
-        if (expected && value !== expected) {
-          this.log(pc.yellow(`  ⚠ ${name}=${value} (expected: ${expected})`));
-        } else {
-          this.log(pc.green(`  ✓ ${name}=${value}`));
-        }
-      } else {
-        this.log(pc.dim(`  ○ ${name}: not set`));
-      }
-    }
-
-    this.log("");
-  }
-}

package/src/commands/ralph/lib/formatter.ts

@@ -1,298 +0,0 @@
-import { execFileSync } from "node:child_process";
-import type { RalphTask, TaskStatus, 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;
-  }
-}
-
-// ============================================================================
-// Task Formatting
-// ============================================================================
-
-export function formatTasksForPrompt(tasks: RalphTask[]): string {
-  if (tasks.length === 0) {
-    return "No tasks.";
-  }
-
-  const statusIcon = (status: TaskStatus): string => {
-    switch (status) {
-      case "done":
-        return "✓";
-      case "ready":
-        return "○";
-      case "blocked":
-        return "⏸";
-      case "cancelled":
-        return "✗";
-    }
-  };
-
-  const lines: string[] = [];
-  for (const t of tasks) {
-    const checkbox = t.status === "done" ? "[x]" : "[ ]";
-    lines.push(`- ${checkbox} #${t.id} ${t.description} \`${statusIcon(t.status)} ${t.status}\``);
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Format tasks as markdown with checkboxes and status badges.
- */
-export function formatTasksAsMarkdown(tasks: RalphTask[]): string {
-  if (tasks.length === 0) {
-    return "# Tasks\n\nNo tasks.\n";
-  }
-
-  const statusBadge = (status: TaskStatus): string => {
-    switch (status) {
-      case "done":
-        return "`✓ done`";
-      case "ready":
-        return "`○ ready`";
-      case "blocked":
-        return "`⏸ blocked`";
-      case "cancelled":
-        return "`✗ cancelled`";
-    }
-  };
-
-  const ready = tasks.filter((t) => t.status === "ready");
-  const done = tasks.filter((t) => t.status === "done");
-
-  const lines: string[] = ["# Tasks", ""];
-  lines.push(
-    `**Total:** ${tasks.length} | **Done:** ${done.length} | **Ready:** ${ready.length}`,
-    "",
-  );
-
-  if (ready.length > 0) {
-    lines.push("## Ready", "");
-    for (const t of ready) {
-      lines.push(`- [ ] **#${t.id}** ${t.description} ${statusBadge(t.status)}`);
-    }
-    lines.push("");
-  }
-
-  if (done.length > 0) {
-    lines.push("## Done", "");
-    for (const t of done) {
-      lines.push(`- [x] **#${t.id}** ${t.description} ${statusBadge(t.status)}`);
-    }
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Format tasks as a plan with markdown and optional mermaid graph.
- */
-export function formatPlanAsMarkdown(tasks: RalphTask[], state: RalphState): string {
-  const lines: string[] = ["# Ralph Plan", ""];
-
-  // Summary section
-  const ready = tasks.filter((t) => t.status === "ready").length;
-  const done = tasks.filter((t) => t.status === "done").length;
-
-  lines.push("## Summary", "");
-  lines.push(`- **Status:** ${state.status}`);
-  lines.push(`- **Iteration:** ${state.iteration}/${state.maxIterations}`);
-  lines.push(`- **Total Tasks:** ${tasks.length}`);
-  lines.push(`- **Done:** ${done} | **Ready:** ${ready}`);
-  if (state.sessionId) {
-    lines.push(`- **Session ID:** ${state.sessionId.slice(0, 8)}...`);
-  }
-  lines.push("");
-
-  // Tasks section with checkboxes
-  lines.push("## Tasks", "");
-  for (const t of tasks) {
-    const checkbox = t.status === "done" ? "[x]" : "[ ]";
-    const status = t.status === "done" ? "`done`" : "`ready`";
-    lines.push(`- ${checkbox} **#${t.id}** ${t.description} ${status}`);
-  }
-  lines.push("");
-
-  // Mermaid graph section
-  lines.push("## Progress Graph", "");
-  lines.push("```mermaid");
-  lines.push("graph LR");
-  lines.push(`    subgraph Progress["Tasks: ${done}/${tasks.length} done"]`);
-
-  for (const t of tasks) {
-    const shortDesc =
-      t.description.length > 30 ? t.description.slice(0, 27) + "..." : t.description;
-    // Escape quotes in descriptions
-    const safeDesc = shortDesc.replace(/"/g, "'");
-    const nodeId = `T${t.id}`;
-
-    if (t.status === "done") {
-      lines.push(`        ${nodeId}["#${t.id}: ${safeDesc}"]:::done`);
-    } else {
-      lines.push(`        ${nodeId}["#${t.id}: ${safeDesc}"]:::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 tasks as JSON for programmatic consumption.
- */
-export function formatPlanAsJson(tasks: RalphTask[], state: RalphState): string {
-  return JSON.stringify(
-    {
-      status: state.status,
-      iteration: state.iteration,
-      maxIterations: state.maxIterations,
-      sessionId: state.sessionId,
-      summary: {
-        total: tasks.length,
-        done: tasks.filter((t) => t.status === "done").length,
-        ready: tasks.filter((t) => t.status === "ready").length,
-      },
-      tasks: tasks.map((t) => ({
-        id: t.id,
-        description: t.description,
-        status: t.status,
-        addedAt: t.addedAt,
-        completedAt: t.completedAt,
-      })),
-    },
-    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;
-  progressFile: string;
-  focusedTaskId: number | null;
-  skipCommit?: boolean;
-  progressContent?: string;
-  taskList: string;
-}
-
-export function buildIterationPrompt({
-  completionMarker,
-  progressFile,
-  focusedTaskId,
-  skipCommit = false,
-  progressContent,
-  taskList,
-}: BuildPromptOptions): string {
-  // prompt inspired by https://www.aihero.dev/tips-for-ai-coding-with-ralph-wiggum#2-start-with-hitl-then-go-afk
-
-  let step = 1;
-
-  //IMPORTANT Always tell it to APPEND to progress file, save a lot of tokens by not reading it to update.
-
-  const prompt = `
-<input-current-tasks>
-${taskList}
-</input-current-tasks>
-
-<instructions>
-${step++}. ${
-    focusedTaskId
-      ? `**Work on Task #${focusedTaskId}** (you've been asked to focus on this one).`
-      : `**Choose** which ready task to work on next based on YOUR judgment of priority/dependencies.`
-  }
-${step++}. Work on that single task.
-${step++}. Run type checks and tests.
-${step++}. Mark the task done using CLI: \`tt ralph task done <id>\`
-${step++}. Append to @${progressFile} with what you did.
-${skipCommit ? "" : `${step++}. Make a git commit.`}
-
-**ONE TASK PER ITERATION**
-
-**Before ending:** Run \`tt ralph task list\` to check remaining tasks.
-**ONLY if ALL TASKS are done** then Output: <promise>${completionMarker}</promise>
-</instructions>
-
-<prior-context note="Reference only - these tasks are already completed, do not work on them">
-${progressContent || "(No prior progress)"}
-</prior-context>
-`;
-  return prompt.trim();
-}
-
-// ============================================================================
-// Marker Detection
-// ============================================================================
-
-export function detectCompletionMarker(output: string, marker: string): boolean {
-  return output.includes(marker);
-}