Implement Claude Code basics

2025-08-29 00:41:05 -07:00
parent 7745a0befb
commit ede6cfdfbe
14 changed files with 7723 additions and 628 deletions
@@ -1,15 +0,0 @@
-import { exec } from "node:child_process";
-import { promisify } from "node:util";
-
-export const execAsync = promisify(exec);
-
-/**
- * Execute a shell command with optional environment variables
- */
-export async function executeCommand(
-  command: string,
-  env?: Record<string, string>
-): Promise<{ stdout: string; stderr: string }> {
-  const execEnv = env ? { ...process.env, ...env } : process.env;
-  return execAsync(command, { env: execEnv });
-}
@@ -0,0 +1,3 @@
+export * from "./files";
+export * from "./subprocess";
+export * from "./table";
@@ -0,0 +1,117 @@
+import { spawn as nodeSpawn } from "node:child_process";
+
+export interface SpawnOptions {
+  cmd: string;
+  args: string[];
+  env?: Record<string, string>;
+  input?: string;
+  timeout?: number;
+  onStdout?: (chunk: string) => void;
+  onStderr?: (chunk: string) => void;
+}
+
+export interface SpawnResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+  durationMs: number;
+}
+
+/**
+ * Spawn a subprocess with streaming callbacks and buffered results
+ */
+export async function spawn(options: SpawnOptions): Promise<SpawnResult> {
+  const { cmd, args, env, input, timeout, onStdout, onStderr } = options;
+
+  const startTime = Date.now();
+  let stdoutBuffer = "";
+  let stderrBuffer = "";
+
+  return new Promise((resolve, reject) => {
+    // Spawn the child process
+    const child = nodeSpawn(cmd, args, {
+      env: env ? { ...process.env, ...env } : process.env,
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+
+    // Set up timeout if specified
+    let timeoutId: NodeJS.Timeout | undefined;
+    let isTimedOut = false;
+
+    if (timeout) {
+      timeoutId = setTimeout(() => {
+        isTimedOut = true;
+        child.kill("SIGTERM");
+
+        // If SIGTERM doesn't work, use SIGKILL after 5 seconds
+        setTimeout(() => {
+          if (!child.killed) {
+            child.kill("SIGKILL");
+          }
+        }, 5000);
+      }, timeout);
+    }
+
+    // Handle stdout streaming
+    if (child.stdout) {
+      child.stdout.on("data", (data: Buffer) => {
+        const chunk = data.toString();
+        stdoutBuffer += chunk;
+        onStdout?.(chunk);
+      });
+    }
+
+    // Handle stderr streaming
+    if (child.stderr) {
+      child.stderr.on("data", (data: Buffer) => {
+        const chunk = data.toString();
+        stderrBuffer += chunk;
+        onStderr?.(chunk);
+      });
+    }
+
+    // Handle process completion
+    child.on("close", (exitCode) => {
+      const durationMs = Date.now() - startTime;
+
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+
+      if (isTimedOut) {
+        reject(new Error(`Process timed out after ${timeout}ms`));
+        return;
+      }
+
+      resolve({
+        stdout: stdoutBuffer,
+        stderr: stderrBuffer,
+        exitCode: exitCode || 0,
+        durationMs,
+      });
+    });
+
+    // Handle process errors
+    child.on("error", (error) => {
+      const durationMs = Date.now() - startTime;
+
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+
+      // Still return buffered output even on error
+      resolve({
+        stdout: stdoutBuffer,
+        stderr: stderrBuffer,
+        exitCode: 1,
+        durationMs,
+      });
+    });
+
+    // Send input if provided
+    if (input && child.stdin) {
+      child.stdin.write(input);
+      child.stdin.end();
+    }
+  });
+}
@@ -0,0 +1,172 @@
+import { table } from "table";
+
+/**
+ * Print a formatted table with consistent styling
+ * @param rows - Array of string arrays representing table rows
+ * @param options - Optional table configuration
+ */
+
+export function tableString(
+  rows: string[][],
+  options?: {
+    title?: string;
+    indent?: string;
+    drawHorizontalLine?: (lineIndex: number, rowCount: number) => boolean;
+  }
+): string {
+  const {
+    title,
+    indent = "",
+    drawHorizontalLine = (lineIndex: number, rowCount: number) => {
+      return lineIndex === 0 || (options?.title && lineIndex === 1) || lineIndex === rowCount;
+    },
+  } = options || {};
+
+  if (options?.title) {
+    rows.unshift([options.title]);
+  }
+
+  const tableOutput = table(rows, {
+    drawHorizontalLine,
+    border: {
+      topBody: `─`,
+      topJoin: `┬`,
+      topLeft: `┌`,
+      topRight: `┐`,
+
+      bottomBody: `─`,
+      bottomJoin: `┴`,
+      bottomLeft: `└`,
+      bottomRight: `┘`,
+
+      bodyLeft: `│`,
+      bodyRight: `│`,
+      bodyJoin: `│`,
+
+      joinBody: `─`,
+      joinLeft: `├`,
+      joinRight: `┤`,
+      joinJoin: `┼`,
+    },
+  });
+
+  const indentedOutput = tableOutput.split("\n").join(`\n${indent}`).trim();
+
+  return `${indent}${indentedOutput}`;
+}
+
+/**
+ * Print a multi-line string in a formatted box with text wrapping
+ * @param text - The text to display
+ * @param options - Optional configuration for the box
+ */
+export function boxString(
+  text: string,
+  options?: {
+    title?: string;
+    maxWidth?: number;
+    indent?: string;
+    padding?: number;
+  }
+): string {
+  const { title, maxWidth = 80, indent = "", padding = 1 } = options || {};
+
+  // Clean up the text and split into lines
+  const lines = text.trim().split("\n");
+
+  // Word wrap each line to fit within maxWidth
+  const wrappedLines: string[] = [];
+  for (const line of lines) {
+    if (line.length <= maxWidth - padding * 2) {
+      wrappedLines.push(line);
+    } else {
+      // Word wrap the line
+      const words = line.split(" ");
+      let currentLine = "";
+
+      for (const word of words) {
+        const testLine = currentLine ? `${currentLine} ${word}` : word;
+        if (testLine.length <= maxWidth - padding * 2) {
+          currentLine = testLine;
+        } else {
+          if (currentLine) {
+            wrappedLines.push(currentLine);
+            currentLine = word;
+          } else {
+            // Word is too long, break it
+            wrappedLines.push(word.substring(0, maxWidth - padding * 2));
+            currentLine = word.substring(maxWidth - padding * 2);
+          }
+        }
+      }
+
+      if (currentLine) {
+        wrappedLines.push(currentLine);
+      }
+    }
+  }
+
+  // Find the maximum line length for box sizing
+  const maxLineLength = Math.max(...wrappedLines.map((line) => line.length));
+  const boxWidth = maxLineLength + padding * 2;
+
+  // Create the box
+  const topBorder = "┌" + "─".repeat(boxWidth) + "┐";
+  const bottomBorder = "└" + "─".repeat(boxWidth) + "┘";
+  const sideBorder = "│";
+
+  let result = "";
+
+  // Add title if provided
+  if (title) {
+    const titleLine = ` ${title} `;
+    const titlePadding = Math.max(0, boxWidth - titleLine.length);
+    result += `${indent}┌${titleLine}${"─".repeat(titlePadding)}┐\n`;
+  }
+
+  // Add top border (or title border)
+  if (!title) {
+    result += `${indent}${topBorder}\n`;
+  }
+
+  // Add content lines
+  for (const line of wrappedLines) {
+    const paddedLine = line.padEnd(maxLineLength);
+    result += `${indent}${sideBorder}${" ".repeat(padding)}${paddedLine}${" ".repeat(padding)}${sideBorder}\n`;
+  }
+
+  // Add bottom border
+  result += `${indent}${bottomBorder}`;
+
+  return result;
+}
+
+// /**
+//  * Create a simple two-column table for displaying key-value pairs
+//  * @param data - Array of [key, value] pairs
+//  * @param title - Optional table title
+//  * @param indent - Optional indentation string
+//  */
+// export function printKeyValueTable(
+//   data: [string, string][],
+//   title?: string,
+//   indent?: string
+// ): void {
+//   const rows: string[][] = [["Key", "Value"], ...data];
+//   const options: Parameters<typeof printTable>[1] = {};
+//   if (title !== undefined) options.title = title;
+//   if (indent !== undefined) options.indent = indent;
+//   printTable(rows, options);
+// }
+
+// /**
+//  * Create a path resolution table (specific use case)
+//  * @param pathData - Array of [location, resolvedPath] pairs
+//  * @param indent - Optional indentation string
+//  */
+// export function printPathTable(pathData: [string, string][], indent?: string): void {
+//   const rows: string[][] = [["Location", "Resolved path"], ...pathData];
+//   const options: Parameters<typeof printTable>[1] = {};
+//   if (indent !== undefined) options.indent = indent;
+//   printTable(rows, options);
+// }