@cdoing/core 0.1.0

package/dist/utils/streaming-diff.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Streaming Diff — generates and emits diff chunks in real-time as edits are applied.
+ *
+ * Instead of computing the entire diff at once and returning it,
+ * StreamingDiff emits line-level diff events via a callback, enabling
+ * UIs to render changes incrementally (e.g., green/red highlighting as
+ * each hunk is processed).
+ *
+ * Supports three strategies:
+ *   1. Deterministic — line-by-line Myers diff (always correct, synchronous)
+ *   2. Unified diff — parse and stream hunk-by-hunk from a unified diff string
+ *   3. Streaming — emit chunks as they arrive from an LLM token stream
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingDiffAccumulator = void 0;
+exports.streamDeterministicDiff = streamDeterministicDiff;
+exports.streamUnifiedDiff = streamUnifiedDiff;
+/**
+ * Compute a line-level diff between two strings and emit chunks via callback.
+ * Uses a simple LCS-based diff algorithm.
+ */
+function streamDeterministicDiff(oldContent, newContent, filePath, onChunk) {
+    const oldLines = oldContent.split("\n");
+    const newLines = newContent.split("\n");
+    // Emit file headers
+    onChunk({ type: "file-header", content: `--- a/${filePath}` });
+    onChunk({ type: "file-header", content: `+++ b/${filePath}` });
+    // Compute LCS for line-level diff
+    const diff = computeLineDiff(oldLines, newLines);
+    // Group into hunks
+    const hunks = groupIntoHunks(diff, oldLines.length, newLines.length);
+    for (const hunk of hunks) {
+        onChunk({
+            type: "hunk-header",
+            content: `@@ -${hunk.oldStart + 1},${hunk.oldCount} +${hunk.newStart + 1},${hunk.newCount} @@`,
+        });
+        for (const entry of hunk.entries) {
+            onChunk(entry);
+        }
+    }
+}
+/**
+ * Simple line diff using longest common subsequence.
+ */
+function computeLineDiff(oldLines, newLines) {
+    const m = oldLines.length;
+    const n = newLines.length;
+    // Build LCS table
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack to produce diff
+    const result = [];
+    let i = m, j = n;
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            result.unshift({ type: "context", content: oldLines[i - 1], oldLine: i, newLine: j });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            result.unshift({ type: "add", content: newLines[j - 1], newLine: j });
+            j--;
+        }
+        else {
+            result.unshift({ type: "remove", content: oldLines[i - 1], oldLine: i });
+            i--;
+        }
+    }
+    return result;
+}
+/**
+ * Group diff entries into hunks with context lines.
+ */
+function groupIntoHunks(diff, oldTotal, newTotal, contextLines = 3) {
+    if (diff.length === 0)
+        return [];
+    // Find ranges of changes
+    const changeIndices = [];
+    for (let i = 0; i < diff.length; i++) {
+        if (diff[i].type !== "context") {
+            changeIndices.push(i);
+        }
+    }
+    if (changeIndices.length === 0)
+        return [];
+    // Group changes that are within contextLines*2 of each other
+    const groups = [];
+    let groupStart = changeIndices[0];
+    let groupEnd = changeIndices[0];
+    for (let i = 1; i < changeIndices.length; i++) {
+        if (changeIndices[i] - groupEnd <= contextLines * 2 + 1) {
+            groupEnd = changeIndices[i];
+        }
+        else {
+            groups.push({ start: groupStart, end: groupEnd });
+            groupStart = changeIndices[i];
+            groupEnd = changeIndices[i];
+        }
+    }
+    groups.push({ start: groupStart, end: groupEnd });
+    // Build hunks with context
+    const hunks = [];
+    for (const group of groups) {
+        const hunkStart = Math.max(0, group.start - contextLines);
+        const hunkEnd = Math.min(diff.length - 1, group.end + contextLines);
+        const entries = [];
+        let oldStart = Infinity, newStart = Infinity;
+        let oldCount = 0, newCount = 0;
+        for (let i = hunkStart; i <= hunkEnd; i++) {
+            const d = diff[i];
+            const lineNum = d.oldLine ?? d.newLine;
+            if (d.type === "context") {
+                entries.push({ type: "context", content: ` ${d.content}`, lineNumber: lineNum });
+                if (d.oldLine !== undefined && d.oldLine < oldStart)
+                    oldStart = d.oldLine;
+                if (d.newLine !== undefined && d.newLine < newStart)
+                    newStart = d.newLine;
+                oldCount++;
+                newCount++;
+            }
+            else if (d.type === "remove") {
+                entries.push({ type: "remove", content: `-${d.content}`, lineNumber: d.oldLine });
+                if (d.oldLine !== undefined && d.oldLine < oldStart)
+                    oldStart = d.oldLine;
+                oldCount++;
+            }
+            else {
+                entries.push({ type: "add", content: `+${d.content}`, lineNumber: d.newLine });
+                if (d.newLine !== undefined && d.newLine < newStart)
+                    newStart = d.newLine;
+                newCount++;
+            }
+        }
+        if (oldStart === Infinity)
+            oldStart = 1;
+        if (newStart === Infinity)
+            newStart = 1;
+        hunks.push({
+            oldStart: oldStart - 1,
+            oldCount,
+            newStart: newStart - 1,
+            newCount,
+            entries,
+        });
+    }
+    return hunks;
+}
+/**
+ * Stream a unified diff string hunk-by-hunk via callback.
+ */
+function streamUnifiedDiff(diffText, onChunk) {
+    const lines = diffText.split("\n");
+    for (const line of lines) {
+        if (line.startsWith("---") || line.startsWith("+++")) {
+            onChunk({ type: "file-header", content: line });
+        }
+        else if (line.startsWith("@@")) {
+            onChunk({ type: "hunk-header", content: line });
+        }
+        else if (line.startsWith("+")) {
+            onChunk({ type: "add", content: line });
+        }
+        else if (line.startsWith("-")) {
+            onChunk({ type: "remove", content: line });
+        }
+        else {
+            onChunk({ type: "context", content: line });
+        }
+    }
+}
+/**
+ * StreamingDiffAccumulator — collects tokens from an LLM stream and emits
+ * diff chunks as complete lines are formed. Used for real-time diff display
+ * while the model is still generating.
+ */
+class StreamingDiffAccumulator {
+    buffer = "";
+    onChunk;
+    lineNumber = 1;
+    constructor(onChunk) {
+        this.onChunk = onChunk;
+    }
+    /** Feed a token from the LLM stream */
+    addToken(token) {
+        this.buffer += token;
+        // Emit complete lines
+        while (this.buffer.includes("\n")) {
+            const newlineIdx = this.buffer.indexOf("\n");
+            const line = this.buffer.substring(0, newlineIdx);
+            this.buffer = this.buffer.substring(newlineIdx + 1);
+            this.emitLine(line);
+        }
+    }
+    /** Flush any remaining content */
+    flush() {
+        if (this.buffer.length > 0) {
+            this.emitLine(this.buffer);
+            this.buffer = "";
+        }
+    }
+    emitLine(line) {
+        if (line.startsWith("---") || line.startsWith("+++")) {
+            this.onChunk({ type: "file-header", content: line });
+        }
+        else if (line.startsWith("@@")) {
+            this.onChunk({ type: "hunk-header", content: line });
+        }
+        else if (line.startsWith("+")) {
+            this.onChunk({ type: "add", content: line, lineNumber: this.lineNumber++ });
+        }
+        else if (line.startsWith("-")) {
+            this.onChunk({ type: "remove", content: line, lineNumber: this.lineNumber++ });
+        }
+        else {
+            this.onChunk({ type: "context", content: line, lineNumber: this.lineNumber++ });
+        }
+    }
+}
+exports.StreamingDiffAccumulator = StreamingDiffAccumulator;
+//# sourceMappingURL=streaming-diff.js.map

package/dist/utils/streaming-diff.js.map

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

package/dist/utils/todo.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Todo/Task Manager
+ *
+ * Allows the LLM to create, update, and track tasks during a session.
+ * Tasks have a status: pending, in_progress, completed, or blocked.
+ */
+export type TodoStatus = "pending" | "in_progress" | "completed" | "blocked";
+export interface TodoItem {
+    id: string;
+    subject: string;
+    description?: string;
+    status: TodoStatus;
+    createdAt: number;
+    updatedAt: number;
+    blockedBy?: string[];
+}
+export declare class TodoStore {
+    private todos;
+    private nextId;
+    /** Create a new todo item */
+    create(subject: string, description?: string): TodoItem;
+    /** Get a todo by ID */
+    get(id: string): TodoItem | undefined;
+    /** Update a todo's status */
+    updateStatus(id: string, status: TodoStatus): TodoItem | undefined;
+    /** Update a todo's details */
+    update(id: string, updates: Partial<Pick<TodoItem, "subject" | "description" | "status" | "blockedBy">>): TodoItem | undefined;
+    /** Delete a todo */
+    delete(id: string): boolean;
+    /** Get all todos */
+    getAll(): TodoItem[];
+    /** Get todos by status */
+    getByStatus(status: TodoStatus): TodoItem[];
+    /** Get summary counts */
+    getSummary(): {
+        pending: number;
+        in_progress: number;
+        completed: number;
+        blocked: number;
+        total: number;
+    };
+    /** Clear all todos */
+    clear(): void;
+    /** Check if there are any active (non-completed) todos */
+    hasActiveTodos(): boolean;
+}
+//# sourceMappingURL=todo.d.ts.map

package/dist/utils/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/utils/todo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAK;IAEnB,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ;IAcvD,uBAAuB;IACvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrC,6BAA6B;IAC7B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS;IASlE,8BAA8B;IAC9B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC,GAAG,QAAQ,GAAG,SAAS;IAY9H,oBAAoB;IACpB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,oBAAoB;IACpB,MAAM,IAAI,QAAQ,EAAE;IAepB,0BAA0B;IAC1B,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,EAAE;IAI3C,yBAAyB;IACzB,UAAU,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAWzG,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAKb,0DAA0D;IAC1D,cAAc,IAAI,OAAO;CAG1B"}

package/dist/utils/todo.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Todo/Task Manager
+ *
+ * Allows the LLM to create, update, and track tasks during a session.
+ * Tasks have a status: pending, in_progress, completed, or blocked.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoStore = void 0;
+class TodoStore {
+    todos = new Map();
+    nextId = 1;
+    /** Create a new todo item */
+    create(subject, description) {
+        const id = String(this.nextId++);
+        const todo = {
+            id,
+            subject,
+            description,
+            status: "pending",
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        };
+        this.todos.set(id, todo);
+        return todo;
+    }
+    /** Get a todo by ID */
+    get(id) {
+        return this.todos.get(id);
+    }
+    /** Update a todo's status */
+    updateStatus(id, status) {
+        const todo = this.todos.get(id);
+        if (todo) {
+            todo.status = status;
+            todo.updatedAt = Date.now();
+        }
+        return todo;
+    }
+    /** Update a todo's details */
+    update(id, updates) {
+        const todo = this.todos.get(id);
+        if (todo) {
+            if (updates.subject !== undefined)
+                todo.subject = updates.subject;
+            if (updates.description !== undefined)
+                todo.description = updates.description;
+            if (updates.status !== undefined)
+                todo.status = updates.status;
+            if (updates.blockedBy !== undefined)
+                todo.blockedBy = updates.blockedBy;
+            todo.updatedAt = Date.now();
+        }
+        return todo;
+    }
+    /** Delete a todo */
+    delete(id) {
+        return this.todos.delete(id);
+    }
+    /** Get all todos */
+    getAll() {
+        return Array.from(this.todos.values()).sort((a, b) => {
+            // Sort by status priority: in_progress > pending > blocked > completed
+            const statusOrder = {
+                in_progress: 0,
+                pending: 1,
+                blocked: 2,
+                completed: 3,
+            };
+            const statusDiff = statusOrder[a.status] - statusOrder[b.status];
+            if (statusDiff !== 0)
+                return statusDiff;
+            return a.createdAt - b.createdAt;
+        });
+    }
+    /** Get todos by status */
+    getByStatus(status) {
+        return this.getAll().filter(t => t.status === status);
+    }
+    /** Get summary counts */
+    getSummary() {
+        const todos = this.getAll();
+        return {
+            pending: todos.filter(t => t.status === "pending").length,
+            in_progress: todos.filter(t => t.status === "in_progress").length,
+            completed: todos.filter(t => t.status === "completed").length,
+            blocked: todos.filter(t => t.status === "blocked").length,
+            total: todos.length,
+        };
+    }
+    /** Clear all todos */
+    clear() {
+        this.todos.clear();
+        this.nextId = 1;
+    }
+    /** Check if there are any active (non-completed) todos */
+    hasActiveTodos() {
+        return this.getAll().some(t => t.status !== "completed");
+    }
+}
+exports.TodoStore = TodoStore;
+//# sourceMappingURL=todo.js.map

package/dist/utils/todo.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@cdoing/core",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "chalk": "^5.4.1",
+    "glob": "^11.0.1",
+    "minimatch": "^9.0.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/minimatch": "^5.1.2",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  }
+}

package/src/agents/coordinator.ts

@@ -0,0 +1,240 @@
+/**
+ * Multi-Agent Coordinator — Orchestrates multiple sub-agents for complex tasks.
+ *
+ * The coordinator pattern splits complex tasks into subtasks, assigns each
+ * to a specialized sub-agent, and merges results.
+ *
+ * Architecture:
+ *   User Request
+ *       │
+ *   ┌───▼───┐
+ *   │Coordinator│ ← Breaks task into subtasks
+ *   └───┬───┘
+ *       │
+ *   ┌───┼───┬───┐
+ *   │   │   │   │
+ *   ▼   ▼   ▼   ▼
+ *  Agent Agent Agent Agent  ← Run in parallel
+ *   │   │   │   │
+ *   └───┼───┴───┘
+ *       │
+ *   ┌───▼───┐
+ *   │ Merge  │ ← Combine results
+ *   └───────┘
+ *
+ * Learning note: This is the Scatter-Gather pattern. The coordinator
+ * "scatters" work to sub-agents and "gathers" their results. This is
+ * particularly effective for:
+ *   - Searching across many files simultaneously
+ *   - Making independent changes to different files
+ *   - Running analysis tasks that don't depend on each other
+ */
+
+/**
+ * A subtask assigned to a sub-agent.
+ */
+export interface Subtask {
+  /** Unique subtask ID */
+  id: string;
+
+  /** Description of what this subtask should accomplish */
+  description: string;
+
+  /** System prompt override for this subtask's agent */
+  systemPrompt?: string;
+
+  /** Whether this subtask can run in parallel with others */
+  parallel: boolean;
+
+  /** Dependencies: IDs of subtasks that must complete first */
+  dependsOn: string[];
+
+  /** Current status */
+  status: "pending" | "running" | "completed" | "failed";
+
+  /** Result of the subtask (populated after completion) */
+  result?: string;
+
+  /** Error message if the subtask failed */
+  error?: string;
+}
+
+/**
+ * Callback interface for coordinator events.
+ */
+export interface CoordinatorCallbacks {
+  /** Called when a subtask starts */
+  onSubtaskStart: (subtask: Subtask) => void;
+
+  /** Called when a subtask completes */
+  onSubtaskComplete: (subtask: Subtask) => void;
+
+  /** Called when a subtask fails */
+  onSubtaskError: (subtask: Subtask, error: Error) => void;
+
+  /** Called when all subtasks are complete */
+  onAllComplete: (results: Subtask[]) => void;
+}
+
+/**
+ * The function signature for running a sub-agent.
+ * This is provided by the AgentRunner — we don't import it directly
+ * to avoid circular dependencies between core and ai packages.
+ */
+export type SubAgentRunner = (prompt: string, systemPrompt?: string) => Promise<string>;
+
+export class AgentCoordinator {
+  private subtasks: Subtask[] = [];
+  private runAgent: SubAgentRunner;
+
+  constructor(runAgent: SubAgentRunner) {
+    this.runAgent = runAgent;
+  }
+
+  /**
+   * Add a subtask to the coordinator.
+   */
+  addSubtask(
+    description: string,
+    options?: {
+      systemPrompt?: string;
+      parallel?: boolean;
+      dependsOn?: string[];
+    },
+  ): Subtask {
+    const subtask: Subtask = {
+      id: `subtask_${this.subtasks.length + 1}`,
+      description,
+      systemPrompt: options?.systemPrompt,
+      parallel: options?.parallel ?? true,
+      dependsOn: options?.dependsOn || [],
+      status: "pending",
+    };
+
+    this.subtasks.push(subtask);
+    return subtask;
+  }
+
+  /**
+   * Execute all subtasks respecting dependencies and parallelism.
+   *
+   * Algorithm:
+   *   1. Find all subtasks whose dependencies are met
+   *   2. Run parallel-safe ones concurrently
+   *   3. Run sequential ones in order
+   *   4. Repeat until all done
+   *
+   * Learning note: This is a topological sort execution — we process
+   * subtasks in dependency order, maximizing parallelism where possible.
+   */
+  async execute(callbacks?: Partial<CoordinatorCallbacks>): Promise<Subtask[]> {
+    const completed = new Set<string>();
+
+    while (completed.size < this.subtasks.length) {
+      // Find ready subtasks (all dependencies met)
+      const ready = this.subtasks.filter(
+        (t) =>
+          t.status === "pending" &&
+          t.dependsOn.every((dep) => completed.has(dep)),
+      );
+
+      if (ready.length === 0) {
+        // No ready tasks but not all complete — there's a dependency cycle
+        const stuck = this.subtasks.filter((t) => t.status === "pending");
+        for (const t of stuck) {
+          t.status = "failed";
+          t.error = "Dependency cycle detected";
+        }
+        break;
+      }
+
+      // Separate parallel and sequential tasks
+      const parallelTasks = ready.filter((t) => t.parallel);
+      const sequentialTasks = ready.filter((t) => !t.parallel);
+
+      // Run parallel tasks concurrently
+      if (parallelTasks.length > 0) {
+        await Promise.all(
+          parallelTasks.map((task) => this.runSubtask(task, callbacks)),
+        );
+
+        for (const task of parallelTasks) {
+          if (task.status === "completed") {
+            completed.add(task.id);
+          }
+        }
+      }
+
+      // Run sequential tasks one at a time
+      for (const task of sequentialTasks) {
+        await this.runSubtask(task, callbacks);
+        if (task.status === "completed") {
+          completed.add(task.id);
+        }
+      }
+    }
+
+    callbacks?.onAllComplete?.(this.subtasks);
+    return this.subtasks;
+  }
+
+  /**
+   * Run a single subtask using the sub-agent runner.
+   */
+  private async runSubtask(
+    subtask: Subtask,
+    callbacks?: Partial<CoordinatorCallbacks>,
+  ): Promise<void> {
+    subtask.status = "running";
+    callbacks?.onSubtaskStart?.(subtask);
+
+    try {
+      const result = await this.runAgent(subtask.description, subtask.systemPrompt);
+      subtask.result = result;
+      subtask.status = "completed";
+      callbacks?.onSubtaskComplete?.(subtask);
+    } catch (err) {
+      subtask.status = "failed";
+      subtask.error = err instanceof Error ? err.message : String(err);
+      callbacks?.onSubtaskError?.(subtask, err instanceof Error ? err : new Error(String(err)));
+    }
+  }
+
+  /**
+   * Get all subtask results as a formatted summary.
+   */
+  getSummary(): string {
+    const lines: string[] = ["## Agent Coordinator Results\n"];
+
+    for (const task of this.subtasks) {
+      const icon = task.status === "completed" ? "✅"
+        : task.status === "failed" ? "❌"
+        : task.status === "running" ? "⏳"
+        : "⬜";
+
+      lines.push(`${icon} **${task.description}**`);
+      if (task.result) {
+        lines.push(`   ${task.result.substring(0, 200)}`);
+      }
+      if (task.error) {
+        lines.push(`   Error: ${task.error}`);
+      }
+    }
+
+    return lines.join("\n");
+  }
+
+  /**
+   * Get all subtasks.
+   */
+  getSubtasks(): Subtask[] {
+    return [...this.subtasks];
+  }
+
+  /**
+   * Clear all subtasks.
+   */
+  clear(): void {
+    this.subtasks = [];
+  }
+}