patchpilots 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Piia Alavesa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,230 @@
+# PatchPilots
+
+A team of AI agents that reviews and improves your code automatically.
+
+```
+         ○      ○      ○      ○      ○      ○
+        /|\    /|\    /|\    /|\    /|\    /|\
+        / \    / \    / \    / \    / \    / \
+         🧠      🔍      ✨      🧪      📝      🎯
+      Planner Reviewer Coder  Tester  Docs  Orchestrator
+
+    ____        __       __    ____  _ __      __
+   / __ \____ _/ /______/ /_  / __ \(_) /___  / /______
+  / /_/ / __ `/ __/ ___/ __ \/ /_/ / / / __ \/ __/ ___/
+ / ____/ /_/ / /_/ /__/ / / / ____/ / / /_/ / /_(__  )
+/_/    \__,_/\__/\___/_/ /_/_/   /_/_/\____/\__/____/
+
+        ○      ○      ○      ○      ○      ○
+       /|\    /|\    /|\    /|\    /|\    /|\
+       / \    / \    / \    / \    / \    / \
+
+    Your code crew is ready. One dev. Six agents. Zero bugs.
+```
+
+**One dev. Six AI agents. Zero excuses.**
+
+Built for solo developers and hobby projects — when you don't have a team to review your PRs, PatchPilots is your crew.
+
+## The Crew
+
+| Agent | Command | What it does |
+|-------|---------|--------------|
+| 🧠 Planner | `patchpilots plan` | Analyzes codebase and breaks down work into tasks |
+| 🔍 Reviewer | `patchpilots review` | Finds bugs, security issues, and code smells |
+| ✨ Coder | `patchpilots improve` | Rewrites and fixes code based on review findings |
+| 🧪 Tester | `patchpilots test` | Generates unit tests for your source files |
+| 📝 Docs | `patchpilots docs` | Generates JSDoc/TSDoc documentation |
+| 🎯 Orchestrator | (coordinates) | Manages the pipeline between agents |
+
+## Quick start
+
+```bash
+# Install dependencies
+npm install
+
+# Set your API key
+export ANTHROPIC_API_KEY=your-key-here
+
+# Review code
+npx tsx bin/patchpilots.ts review ./src
+
+# Generate an implementation plan
+npx tsx bin/patchpilots.ts plan ./src --task "add authentication"
+
+# Review and improve code
+npx tsx bin/patchpilots.ts improve ./src
+
+# Generate unit tests
+npx tsx bin/patchpilots.ts test ./src
+
+# Generate documentation
+npx tsx bin/patchpilots.ts docs ./src
+
+# Apply any changes to disk
+npx tsx bin/patchpilots.ts improve ./src --write
+npx tsx bin/patchpilots.ts test ./src --write
+npx tsx bin/patchpilots.ts docs ./src --write
+```
+
+## CLI commands
+
+### `patchpilots review <path>`
+
+Analyzes your code and reports findings grouped by file, color-coded by severity.
+
+| Option | Description |
+|--------|-------------|
+| `-m, --model <model>` | Claude model to use |
+| `-c, --config <path>` | Path to config file |
+| `--severity <level>` | Minimum severity: `critical`, `warning`, `info` |
+| `--json` | Output raw JSON |
+| `--verbose` | Show token usage and thinking progress |
+
+### `patchpilots improve <path>`
+
+Reviews code and then generates improved versions with fixes applied.
+
+All `review` options plus:
+
+| Option | Description |
+|--------|-------------|
+| `--write` | Write improved files to disk (default: dry-run) |
+| `--backup` | Create `.bak` files before overwriting |
+
+### `patchpilots test <path>`
+
+Generates unit tests for source files.
+
+| Option | Description |
+|--------|-------------|
+| `--write` | Write test files to disk |
+| `--framework <name>` | Test framework to use (default: `vitest`) |
+
+### `patchpilots plan <path>`
+
+Analyzes codebase and creates a structured implementation plan.
+
+| Option | Description |
+|--------|-------------|
+| `-t, --task <description>` | Specific task to plan for |
+
+### `patchpilots docs <path>`
+
+Generates documentation for source files.
+
+| Option | Description |
+|--------|-------------|
+| `--write` | Write documented files to disk |
+| `--backup` | Create `.bak` files before overwriting |
+
+## Configuration
+
+Create a `.patchpilots.json` in your project root:
+
+```json
+{
+  "model": "claude-sonnet-4-6",
+  "maxTokens": 16000,
+  "temperature": 0.3,
+  "include": ["**/*.ts", "**/*.js"],
+  "exclude": ["node_modules/**", "dist/**"],
+  "maxFileSize": 100000,
+  "maxFiles": 20
+}
+```
+
+Or set your API key **once globally** so it works for every project:
+
+```bash
+echo '{"apiKey": "sk-ant-..."}' > ~/.patchpilots.json
+```
+
+Or per-project via `.patchpilots.json` in your project root, or via environment variable:
+
+```bash
+export ANTHROPIC_API_KEY=your-key-here
+```
+
+Config resolution order: CLI flags > project `.patchpilots.json` > global `~/.patchpilots.json` > `ANTHROPIC_API_KEY` env var.
+
+## Powered by Claude API
+
+PatchPilots uses three key features of the Claude API:
+
+### Structured outputs
+Every agent response is **guaranteed** to match its Zod schema via `zodOutputFormat`. No regex JSON extraction, no prayer-based parsing — the API enforces the schema.
+
+### Adaptive thinking
+Agents use Claude's adaptive thinking mode for deeper reasoning. The Reviewer agent thinks through code logic before flagging issues, catching bugs that a surface-level scan would miss.
+
+### Streaming
+Responses are streamed in real-time. No hanging on long requests, no timeouts. Use `--verbose` to see thinking progress as it happens.
+
+### Prompt caching
+System prompts are cached via Claude's `cache_control` — repeat runs against the same project cost ~90% less on the cached portion.
+
+### Cost tracking
+Every run shows a cost summary with per-agent token usage and estimated USD cost.
+
+## Architecture
+
+PatchPilots uses a clean agent abstraction. Every agent extends `BaseAgent<T>` and implements three methods:
+
+```typescript
+class MyAgent extends BaseAgent<MyOutputType> {
+  getSystemPrompt()          // What the agent's role is
+  buildUserMessage(context)  // How to format the input
+  getOutputSchema()          // Zod schema — guarantees output shape
+}
+```
+
+Adding a new agent is one file + three methods. The orchestrator handles coordination, streaming, error handling, and output formatting.
+
+### Error handling
+
+The LLM client uses typed Anthropic SDK exceptions:
+- `RateLimitError` — automatic retry with backoff
+- `AuthenticationError` — clear message about API key
+- `APIError` — surfaced with status code and details
+
+## Tech stack
+
+- TypeScript + Node.js
+- Claude API (`@anthropic-ai/sdk` v0.79.0)
+- Structured outputs (`zodOutputFormat`) — guaranteed schema compliance
+- Adaptive thinking — deeper code analysis
+- Streaming — real-time response delivery
+- Commander (CLI)
+- Chalk (terminal formatting)
+- Zod (schema definition + validation)
+
+## Status
+
+This is an MVP — actively being built in public. Follow along for updates.
+
+## Roadmap
+
+### Done
+- [x] 6 AI agents: Planner, Reviewer, Coder, Tester, Docs, Orchestrator
+- [x] Structured outputs with Zod schemas — guaranteed valid responses
+- [x] Adaptive thinking for deeper code analysis
+- [x] Streaming — real-time response delivery
+- [x] Prompt caching — ~90% cost savings on repeat runs
+- [x] Cost tracking — per-agent token usage and USD estimate after every run
+- [x] Global config (`~/.patchpilots.json`) — set API key once for all projects
+
+### Next up
+- [x] **Diff-based Coder output** — return patches instead of full files (fixes token limit on large files)
+- [ ] **npm publish** — `npx patchpilots review ./src` from anywhere
+- [ ] **Parallel file review** — review files in batches instead of one giant prompt
+- [ ] **GitHub Action** — auto-review PRs and post findings as comments
+- [ ] **`patchpilots audit`** — full pipeline: plan → review → improve → test → docs in one command
+- [ ] **Smart model routing** — Haiku for Docs/Tester, Sonnet for Reviewer/Coder
+- [ ] **HTML/CSS support** — review static sites and stylesheets
+- [ ] **Security agent** — dedicated OWASP Top 10, secrets detection, input validation, and auth pattern analysis
+- [ ] **Designer agent** — generate CSS, design tokens, and component markup
+
+## License
+
+MIT

package/dist/bin/demo.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env npx tsx
+export {};

package/dist/bin/demo.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env npx tsx
+import { playBanner } from "../src/utils/banner.js";
+await playBanner();
+console.log("\n  Ready to review your code. Run: patchpilots review <path>\n");
+//# sourceMappingURL=demo.js.map

package/dist/bin/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../bin/demo.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,UAAU,EAAE,CAAC;AACnB,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC"}

package/dist/bin/patchpilots.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/patchpilots.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createProgram } from "../src/cli/index.js";
+const program = createProgram();
+program.parse();
+//# sourceMappingURL=patchpilots.js.map

package/dist/bin/patchpilots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchpilots.js","sourceRoot":"","sources":["../../bin/patchpilots.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAChC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/agents/base-agent.d.ts

@@ -0,0 +1,13 @@
+import type { z } from "zod";
+import type { LLMClient } from "../core/llm-client.js";
+import type { AgentContext, AgentResult } from "../types/index.js";
+export declare abstract class BaseAgent<T = unknown> {
+    protected llmClient: LLMClient;
+    abstract readonly name: string;
+    abstract readonly description: string;
+    constructor(llmClient: LLMClient);
+    protected abstract getSystemPrompt(): string;
+    protected abstract buildUserMessage(context: AgentContext): string;
+    protected abstract getOutputSchema(): z.ZodType<T>;
+    execute(context: AgentContext, onToken?: (text: string) => void): Promise<AgentResult>;
+}

package/dist/src/agents/base-agent.js

@@ -0,0 +1,23 @@
+export class BaseAgent {
+    llmClient;
+    constructor(llmClient) {
+        this.llmClient = llmClient;
+    }
+    async execute(context, onToken) {
+        const systemPrompt = this.getSystemPrompt();
+        const userMessage = this.buildUserMessage(context);
+        const schema = this.getOutputSchema();
+        const response = await this.llmClient.chatStructured(systemPrompt, userMessage, schema, {
+            maxTokens: context.config.maxTokens,
+            temperature: context.config.temperature,
+        }, onToken);
+        return {
+            agentName: this.name,
+            success: true,
+            data: response.data,
+            rawResponse: JSON.stringify(response.data),
+            tokensUsed: response.usage,
+        };
+    }
+}
+//# sourceMappingURL=base-agent.js.map

package/dist/src/agents/base-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.js","sourceRoot":"","sources":["../../../src/agents/base-agent.ts"],"names":[],"mappings":"AAIA,MAAM,OAAgB,SAAS;IAIP;IAAtB,YAAsB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAM9C,KAAK,CAAC,OAAO,CACX,OAAqB,EACrB,OAAgC;QAEhC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAClD,YAAY,EACZ,WAAW,EACX,MAAM,EACN;YACE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACnC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;SACxC,EACD,OAAO,CACR,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1C,UAAU,EAAE,QAAQ,CAAC,KAAK;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/src/agents/coder.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { BaseAgent } from "./base-agent.js";
+import type { AgentContext } from "../types/index.js";
+import type { CoderResult } from "../types/review.js";
+export declare class CoderAgent extends BaseAgent<CoderResult> {
+    readonly name = "Coder";
+    readonly description = "Rewrites and improves code based on review findings";
+    protected getOutputSchema(): z.ZodObject<{
+        improvedFiles: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            patches: z.ZodArray<z.ZodObject<{
+                find: z.ZodString;
+                replace: z.ZodString;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                replace: string;
+                find: string;
+                description: string;
+            }, {
+                replace: string;
+                find: string;
+                description: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            patches: {
+                replace: string;
+                find: string;
+                description: string;
+            }[];
+        }, {
+            path: string;
+            patches: {
+                replace: string;
+                find: string;
+                description: string;
+            }[];
+        }>, "many">;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        improvedFiles: {
+            path: string;
+            patches: {
+                replace: string;
+                find: string;
+                description: string;
+            }[];
+        }[];
+    }, {
+        summary: string;
+        improvedFiles: {
+            path: string;
+            patches: {
+                replace: string;
+                find: string;
+                description: string;
+            }[];
+        }[];
+    }>;
+    protected getSystemPrompt(): string;
+    protected buildUserMessage(context: AgentContext): string;
+}

package/dist/src/agents/coder.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { BaseAgent } from "./base-agent.js";
+const coderResultSchema = z.object({
+    improvedFiles: z.array(z.object({
+        path: z.string(),
+        patches: z.array(z.object({
+            find: z.string(),
+            replace: z.string(),
+            description: z.string(),
+        })),
+    })),
+    summary: z.string(),
+});
+export class CoderAgent extends BaseAgent {
+    name = "Coder";
+    description = "Rewrites and improves code based on review findings";
+    getOutputSchema() {
+        return coderResultSchema;
+    }
+    getSystemPrompt() {
+        return `You are a senior software developer. You receive code files along with review findings, and your job is to fix the identified issues.
+
+Rules:
+- Only change what the review identified — do not refactor unrelated code
+- Preserve the original code style (indentation, naming conventions, etc.)
+- Make minimal, targeted changes
+
+Output format: For each file, return an array of search-and-replace patches.
+Each patch has:
+- "find": the EXACT string to find in the original file (must match uniquely, include enough context)
+- "replace": the replacement string
+- "description": brief explanation of what the patch does
+
+IMPORTANT:
+- The "find" string must be an EXACT match of the original source code including whitespace and indentation
+- Include enough surrounding context in "find" to ensure a unique match (at least 2-3 lines)
+- Do NOT include the entire file — only the specific lines that need changing with minimal surrounding context
+- Each patch should be small and focused on one change
+
+Only include files that actually need changes. If no changes are needed, return an empty improvedFiles array.`;
+    }
+    buildUserMessage(context) {
+        const review = context.previousResults?.data;
+        const parts = ["Here are the code files and the review findings. Please fix the identified issues.\n"];
+        parts.push("## Review Findings");
+        parts.push("```json");
+        parts.push(JSON.stringify(review, null, 2));
+        parts.push("```\n");
+        parts.push("## Source Files\n");
+        for (const file of context.files) {
+            parts.push(`### ${file.path} (${file.language})`);
+            parts.push("```" + file.language);
+            parts.push(file.content);
+            parts.push("```\n");
+        }
+        return parts.join("\n");
+    }
+}
+//# sourceMappingURL=coder.js.map

package/dist/src/agents/coder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coder.js","sourceRoot":"","sources":["../../../src/agents/coder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,KAAK,CACpB,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACxB,CAAC,CACH;KACF,CAAC,CACH;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,OAAO,UAAW,SAAQ,SAAsB;IAC3C,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,qDAAqD,CAAC;IAEnE,eAAe;QACvB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAES,eAAe;QACvB,OAAO;;;;;;;;;;;;;;;;;;;8GAmBmG,CAAC;IAC7G,CAAC;IAES,gBAAgB,CAAC,OAAqB;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,IAAoB,CAAC;QAC7D,MAAM,KAAK,GAAG,CAAC,sFAAsF,CAAC,CAAC;QAEvG,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEpB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/src/agents/docs.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { BaseAgent } from "./base-agent.js";
+import type { AgentContext } from "../types/index.js";
+import type { DocsResult } from "../types/review.js";
+export declare class DocsAgent extends BaseAgent<DocsResult> {
+    readonly name = "Docs";
+    readonly description = "Generates and improves documentation for source files";
+    protected getOutputSchema(): z.ZodObject<{
+        docs: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            content: z.ZodString;
+            type: z.ZodEnum<["jsdoc", "readme", "inline"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "jsdoc" | "readme" | "inline";
+            file: string;
+            content: string;
+        }, {
+            type: "jsdoc" | "readme" | "inline";
+            file: string;
+            content: string;
+        }>, "many">;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        docs: {
+            type: "jsdoc" | "readme" | "inline";
+            file: string;
+            content: string;
+        }[];
+    }, {
+        summary: string;
+        docs: {
+            type: "jsdoc" | "readme" | "inline";
+            file: string;
+            content: string;
+        }[];
+    }>;
+    protected getSystemPrompt(): string;
+    protected buildUserMessage(context: AgentContext): string;
+}

package/dist/src/agents/docs.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { BaseAgent } from "./base-agent.js";
+const docsResultSchema = z.object({
+    docs: z.array(z.object({
+        file: z.string(),
+        content: z.string(),
+        type: z.enum(["jsdoc", "readme", "inline"]),
+    })),
+    summary: z.string(),
+});
+export class DocsAgent extends BaseAgent {
+    name = "Docs";
+    description = "Generates and improves documentation for source files";
+    getOutputSchema() {
+        return docsResultSchema;
+    }
+    getSystemPrompt() {
+        return `You are a senior technical writer and documentation specialist. Your job is to generate clear, useful documentation for source code.
+
+Rules:
+- Generate JSDoc/TSDoc comments for exported functions, classes, and interfaces
+- Write concise descriptions that explain WHAT something does and WHY, not just restating the code
+- Include @param, @returns, and @example tags where helpful
+- For complex modules, generate a module-level doc comment explaining the overall purpose
+- Keep inline comments short and only where logic isn't self-evident
+- Use the "jsdoc" type for function/class documentation
+- Use the "inline" type for important inline comments
+- Use the "readme" type if you generate a module README section
+
+For each file, return the full file content with documentation added. Do not change any functional code — only add or improve documentation.
+
+Skip files that are already well-documented or are simple re-exports.`;
+    }
+    buildUserMessage(context) {
+        const parts = ["Please add documentation to the following source files:\n"];
+        for (const file of context.files) {
+            parts.push(`## File: ${file.path} (${file.language})`);
+            parts.push("```" + file.language);
+            parts.push(file.content);
+            parts.push("```\n");
+        }
+        return parts.join("\n");
+    }
+}
+//# sourceMappingURL=docs.js.map

package/dist/src/agents/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/agents/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CACX,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;KAC5C,CAAC,CACH;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,OAAO,SAAU,SAAQ,SAAqB;IACzC,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,uDAAuD,CAAC;IAErE,eAAe;QACvB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAES,eAAe;QACvB,OAAO;;;;;;;;;;;;;;sEAc2D,CAAC;IACrE,CAAC;IAES,gBAAgB,CAAC,OAAqB;QAC9C,MAAM,KAAK,GAAG,CAAC,2DAA2D,CAAC,CAAC;QAE5E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/src/agents/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseAgent } from "./base-agent.js";
+export { ReviewerAgent } from "./reviewer.js";
+export { CoderAgent } from "./coder.js";
+export { TesterAgent } from "./tester.js";
+export { PlannerAgent } from "./planner.js";
+export { DocsAgent } from "./docs.js";

package/dist/src/agents/index.js

@@ -0,0 +1,7 @@
+export { BaseAgent } from "./base-agent.js";
+export { ReviewerAgent } from "./reviewer.js";
+export { CoderAgent } from "./coder.js";
+export { TesterAgent } from "./tester.js";
+export { PlannerAgent } from "./planner.js";
+export { DocsAgent } from "./docs.js";
+//# sourceMappingURL=index.js.map

package/dist/src/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/agents/planner.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { BaseAgent } from "./base-agent.js";
+import type { AgentContext } from "../types/index.js";
+import type { PlanResult } from "../types/review.js";
+export declare class PlannerAgent extends BaseAgent<PlanResult> {
+    readonly name = "Planner";
+    readonly description = "Breaks down tasks and creates implementation plans";
+    private taskDescription;
+    constructor(llmClient: ConstructorParameters<typeof BaseAgent>[0], taskDescription?: string);
+    protected getOutputSchema(): z.ZodObject<{
+        goal: z.ZodString;
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            title: z.ZodString;
+            description: z.ZodString;
+            files: z.ZodArray<z.ZodString, "many">;
+            priority: z.ZodEnum<["high", "medium", "low"]>;
+            estimatedComplexity: z.ZodEnum<["simple", "moderate", "complex"]>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            description: string;
+            id: number;
+            files: string[];
+            priority: "high" | "medium" | "low";
+            estimatedComplexity: "simple" | "moderate" | "complex";
+        }, {
+            title: string;
+            description: string;
+            id: number;
+            files: string[];
+            priority: "high" | "medium" | "low";
+            estimatedComplexity: "simple" | "moderate" | "complex";
+        }>, "many">;
+        risks: z.ZodArray<z.ZodString, "many">;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        goal: string;
+        tasks: {
+            title: string;
+            description: string;
+            id: number;
+            files: string[];
+            priority: "high" | "medium" | "low";
+            estimatedComplexity: "simple" | "moderate" | "complex";
+        }[];
+        risks: string[];
+    }, {
+        summary: string;
+        goal: string;
+        tasks: {
+            title: string;
+            description: string;
+            id: number;
+            files: string[];
+            priority: "high" | "medium" | "low";
+            estimatedComplexity: "simple" | "moderate" | "complex";
+        }[];
+        risks: string[];
+    }>;
+    protected getSystemPrompt(): string;
+    protected buildUserMessage(context: AgentContext): string;
+}