@electric-agent/agent 1.0.0

package/dist/progress/reporter.js

@@ -0,0 +1,133 @@
+const PREFIXES = {
+    plan: "\x1b[36m[plan]\x1b[0m",
+    approve: "\x1b[33m[approve]\x1b[0m",
+    task: "\x1b[34m[task]\x1b[0m",
+    build: "\x1b[35m[build]\x1b[0m",
+    fix: "\x1b[33m[fix]\x1b[0m",
+    done: "\x1b[32m[done]\x1b[0m",
+    error: "\x1b[31m[error]\x1b[0m",
+    verbose: "\x1b[2m[verbose]\x1b[0m",
+};
+export function createProgressReporter(opts) {
+    const verboseMode = opts?.verbose ?? false;
+    return {
+        verboseMode,
+        log(level, message) {
+            if (level === "verbose" && !verboseMode)
+                return;
+            console.log(`${PREFIXES[level]} ${message}`);
+        },
+        logToolUse(toolName, summary) {
+            const prefix = "\x1b[2m";
+            const reset = "\x1b[0m";
+            console.log(`${prefix}  ↳ ${toolName}: ${summary}${reset}`);
+        },
+    };
+}
+/**
+ * Process SDK messages and route them to the progress reporter.
+ */
+export function processAgentMessage(message, reporter) {
+    if (message.type === "assistant" && message.message?.content) {
+        const content = message.message.content;
+        for (const block of content) {
+            if ("text" in block && block.text) {
+                const text = block.text;
+                if (reporter.verboseMode) {
+                    reporter.log("verbose", text);
+                }
+                else if (text.length > 10) {
+                    reporter.log("task", text);
+                }
+            }
+            else if ("thinking" in block && block.thinking && reporter.verboseMode) {
+                const thinking = block.thinking;
+                reporter.log("verbose", `[thinking] ${thinking.slice(0, 500)}`);
+            }
+            else if ("name" in block) {
+                const name = block.name;
+                const input = (block.input || {});
+                if (name === "Write" || name === "Edit") {
+                    reporter.logToolUse(name, (input.file_path || "unknown file"));
+                }
+                else if (name === "Bash") {
+                    const cmd = (input.command || "");
+                    reporter.logToolUse("Bash", cmd.slice(0, 80));
+                }
+                else if (name.includes("build")) {
+                    reporter.log("build", "Running build...");
+                }
+                else if (name.includes("playbook")) {
+                    reporter.logToolUse("Playbook", (input.name || "read"));
+                }
+            }
+        }
+    }
+    else if (message.type === "user" && message.message?.content) {
+        // SDK sends tool results as user messages with tool_result content blocks
+        const msgContent = message.message.content;
+        if (Array.isArray(msgContent)) {
+            for (const block of msgContent) {
+                if (typeof block === "object" &&
+                    block &&
+                    block.type === "tool_result") {
+                    const b = block;
+                    const content = b.content;
+                    const texts = [];
+                    if (typeof content === "string") {
+                        texts.push(content);
+                    }
+                    else if (Array.isArray(content)) {
+                        for (const inner of content) {
+                            if (typeof inner === "object" && inner && "text" in inner) {
+                                texts.push(inner.text);
+                            }
+                        }
+                    }
+                    for (const text of texts) {
+                        // Always surface build tool results (even without --verbose)
+                        if (text.includes("=== pnpm run build ===")) {
+                            try {
+                                const result = JSON.parse(text);
+                                const output = result.output || "";
+                                const lines = output.split("\n").filter((l) => l.trim());
+                                const tail = lines.slice(-8).join("\n");
+                                if (!result.success) {
+                                    reporter.log("build", `FAILED (${result.errors})`);
+                                    reporter.log("build", tail);
+                                }
+                                else {
+                                    reporter.log("build", "Build passed");
+                                }
+                            }
+                            catch {
+                                // Not JSON — show raw tail
+                                const lines = text.split("\n").filter((l) => l.trim());
+                                reporter.log("build", lines.slice(-5).join("\n"));
+                            }
+                            continue;
+                        }
+                        if (reporter.verboseMode) {
+                            reporter.log("verbose", `[tool_result] ${text.slice(0, 1000)}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    else if (message.type === "result") {
+        const sub = String(message.subtype);
+        const cost = message.total_cost_usd;
+        const costStr = `(cost: $${cost?.toFixed(4) || "?"})`;
+        if (sub === "success") {
+            reporter.log("done", `Agent completed ${costStr}`);
+        }
+        else if (sub.includes("max_turns")) {
+            reporter.log("task", `Agent reached turn limit ${costStr}`);
+        }
+        else {
+            reporter.log("error", `Agent stopped: ${sub} ${costStr}`);
+        }
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/progress/reporter.js.map

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

package/dist/scaffold/index.d.ts

@@ -0,0 +1,23 @@
+import type { ProgressReporter } from "../progress/reporter.js";
+export interface ScaffoldResult {
+    projectDir: string;
+    skippedInstall: boolean;
+    errors: string[];
+}
+/**
+ * Scaffold a new Electric + TanStack DB project from the KPB template.
+ *
+ * 1. Clone KPB via `npx gitpick KyleAMathews/kpb`
+ * 2. Copy Electric + Drizzle infrastructure files
+ * 3. Merge dependencies into package.json
+ * 4. Patch vite.config.ts, root route, .gitignore
+ * 5. Set up .env and _agent/ directory
+ * 6. Run pnpm install
+ */
+export declare function scaffold(projectDir: string, opts?: {
+    skipInstall?: boolean;
+    skipGit?: boolean;
+    projectName?: string;
+    reporter?: ProgressReporter;
+}): Promise<ScaffoldResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffold/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAK/D,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IACN,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC3B,GACC,OAAO,CAAC,cAAc,CAAC,CAkJzB"}

package/dist/scaffold/index.js

@@ -0,0 +1,315 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { gitInit } from "../git/index.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const templateDir = path.resolve(__dirname, "../../template");
+/**
+ * Scaffold a new Electric + TanStack DB project from the KPB template.
+ *
+ * 1. Clone KPB via `npx gitpick KyleAMathews/kpb`
+ * 2. Copy Electric + Drizzle infrastructure files
+ * 3. Merge dependencies into package.json
+ * 4. Patch vite.config.ts, root route, .gitignore
+ * 5. Set up .env and _agent/ directory
+ * 6. Run pnpm install
+ */
+export async function scaffold(projectDir, opts) {
+    const errors = [];
+    const reporter = opts?.reporter;
+    let skippedInstall = opts?.skipInstall ?? false;
+    // Step 1: Clone KPB template
+    if (!fs.existsSync(projectDir)) {
+        fs.mkdirSync(projectDir, { recursive: true });
+    }
+    try {
+        reporter?.log("verbose", "Cloning KPB template via gitpick...");
+        execSync(`npx gitpick KyleAMathews/kpb ${projectDir} -o`, {
+            stdio: "pipe",
+            timeout: 120_000,
+        });
+        reporter?.log("verbose", "KPB template cloned");
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : "gitpick failed";
+        throw new Error(`Failed to clone KPB template: ${msg}`);
+    }
+    // Validate that gitpick actually produced a usable project
+    const pkgJsonPath = path.join(projectDir, "package.json");
+    if (!fs.existsSync(pkgJsonPath)) {
+        throw new Error(`Scaffold failed: package.json not found in ${projectDir} after cloning KPB template. ` +
+            "The template clone may have been incomplete.");
+    }
+    // Step 2: Copy template overlay files
+    reporter?.log("verbose", `Copying template overlay files from ${templateDir}...`);
+    if (!fs.existsSync(templateDir)) {
+        reporter?.log("error", `Template directory not found at ${templateDir} — template overlay files (drizzle.config.ts, etc.) will be missing`);
+    }
+    copyTemplateFiles(templateDir, projectDir);
+    reporter?.log("verbose", "Template overlay complete");
+    // Step 3: Merge dependencies and rename project
+    reporter?.log("verbose", "Merging dependencies into package.json...");
+    mergeDependencies(projectDir, opts?.projectName);
+    // Step 4: Delete stale lockfile (we changed deps, lockfile is now invalid)
+    const lockPath = path.join(projectDir, "pnpm-lock.yaml");
+    if (fs.existsSync(lockPath)) {
+        fs.unlinkSync(lockPath);
+        reporter?.log("verbose", "Removed stale pnpm-lock.yaml");
+    }
+    // Step 5: Patch vite.config.ts
+    reporter?.log("verbose", "Patching vite.config.ts...");
+    patchViteConfig(projectDir);
+    // Step 6: Patch root route for shellComponent
+    patchRootRoute(projectDir);
+    // Step 6b: Fix public-dir CSS imports that break Rollup production builds
+    reporter?.log("verbose", "Patching public CSS imports...");
+    patchPublicCssImports(projectDir);
+    // Step 7: Copy .env.example -> .env and ensure VITE_PORT is set
+    const envExample = path.join(projectDir, ".env.example");
+    const envFile = path.join(projectDir, ".env");
+    if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
+        fs.copyFileSync(envExample, envFile);
+        reporter?.log("verbose", "Copied .env.example to .env");
+    }
+    // Ensure VITE_PORT is in .env (default 5174 for local Caddy mode)
+    if (fs.existsSync(envFile)) {
+        const envContent = fs.readFileSync(envFile, "utf-8");
+        if (!envContent.includes("VITE_PORT")) {
+            fs.appendFileSync(envFile, "\nVITE_PORT=5174\n");
+        }
+    }
+    // Step 8: Create _agent/ working memory directory
+    const agentDir = path.join(projectDir, "_agent");
+    fs.mkdirSync(agentDir, { recursive: true });
+    fs.writeFileSync(path.join(agentDir, "errors.md"), "# Error Log\n\n", "utf-8");
+    fs.writeFileSync(path.join(agentDir, "session.md"), "# Session State\n\n", "utf-8");
+    reporter?.log("verbose", "Created _agent/ working memory directory");
+    // Step 9: Patch .gitignore
+    patchGitignore(projectDir);
+    // Step 10: Install dependencies
+    // Use --ignore-workspace to ensure packages install into the project's own
+    // node_modules, not a parent workspace. Generated apps are standalone.
+    if (!skippedInstall) {
+        try {
+            const installer = detectPackageManager(projectDir);
+            const ignoreWs = installer === "pnpm" ? " --ignore-workspace" : "";
+            reporter?.log("verbose", `Running ${installer} install...`);
+            execSync(`${installer} install${ignoreWs}`, {
+                cwd: projectDir,
+                stdio: "pipe",
+                timeout: 180_000,
+            });
+            reporter?.log("verbose", "Dependencies installed successfully");
+        }
+        catch (e) {
+            const stdout = e?.stdout?.toString() || "";
+            const stderr = e?.stderr?.toString() || "";
+            const combined = `${stdout}\n${stderr}`.trim();
+            if (reporter?.verboseMode) {
+                errors.push(`Package install failed:\n${combined}`);
+            }
+            else {
+                errors.push(`Package install failed: ${combined.slice(0, 500)}`);
+            }
+            skippedInstall = true;
+        }
+    }
+    // Step 11: Initialize git repo with initial commit (unless skipped)
+    if (!opts?.skipGit) {
+        reporter?.log("build", "Initializing git repository...");
+        try {
+            const commitOutput = gitInit(projectDir, opts?.projectName);
+            reporter?.log("done", `Git initialized: ${commitOutput}`);
+        }
+        catch (e) {
+            const msg = `Git init failed: ${e instanceof Error ? e.message : "unknown"}`;
+            reporter?.log("error", msg);
+            errors.push(msg);
+            // Attempt bare git init as recovery — at minimum create the .git directory
+            // so later git operations don't fail with "not a git repository"
+            try {
+                execSync("git init -b main", { cwd: projectDir, stdio: "pipe" });
+                execSync('git config user.email "electric-agent@local"', {
+                    cwd: projectDir,
+                    stdio: "pipe",
+                });
+                execSync('git config user.name "Electric Agent"', {
+                    cwd: projectDir,
+                    stdio: "pipe",
+                });
+                reporter?.log("verbose", "Recovery: bare git init succeeded");
+            }
+            catch {
+                errors.push("Recovery git init also failed — git operations will not work");
+            }
+        }
+    }
+    return { projectDir, skippedInstall, errors };
+}
+function detectPackageManager(projectDir) {
+    if (fs.existsSync(path.join(projectDir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (fs.existsSync(path.join(projectDir, "yarn.lock")))
+        return "yarn";
+    // Check if pnpm is available
+    try {
+        execSync("pnpm --version", { stdio: "pipe" });
+        return "pnpm";
+    }
+    catch {
+        return "npm";
+    }
+}
+function copyTemplateFiles(srcDir, destDir) {
+    if (!fs.existsSync(srcDir))
+        return;
+    for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            fs.mkdirSync(destPath, { recursive: true });
+            copyTemplateFiles(srcPath, destPath);
+        }
+        else {
+            fs.mkdirSync(path.dirname(destPath), { recursive: true });
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+const ADDED_DEPENDENCIES = {
+    "@tanstack/db": "0.5.25",
+    "@tanstack/react-db": "0.1.69",
+    "@tanstack/electric-db-collection": "0.2.31",
+    "@electric-sql/client": "1.5.1",
+    "drizzle-orm": "0.45.1",
+    "drizzle-zod": "^0.8.3",
+    postgres: "^3.4",
+    zod: "^3.24",
+};
+const ADDED_DEV_DEPENDENCIES = {
+    "drizzle-kit": "0.31.9",
+    vitest: "^3.0.0",
+    // Playbook packages (@electric-sql/playbook, @tanstack/db-playbook,
+    // @durable-streams/playbook) come from the KPB template — don't duplicate here.
+};
+const ADDED_SCRIPTS = {
+    generate: "drizzle-kit generate",
+    migrate: "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "dev:start": "nohup pnpm dev > /tmp/dev-server.log 2>&1 & echo $! > /tmp/dev-server.pid",
+    "dev:stop": "kill $(cat /tmp/dev-server.pid 2>/dev/null) 2>/dev/null; rm -f /tmp/dev-server.pid",
+    "dev:restart": "pnpm dev:stop && pnpm dev:start",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run tests/integration",
+};
+function mergeDependencies(projectDir, projectName) {
+    const pkgPath = path.join(projectDir, "package.json");
+    if (!fs.existsSync(pkgPath))
+        return;
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    // Rename project
+    if (projectName) {
+        pkg.name = projectName;
+    }
+    pkg.dependencies = { ...(pkg.dependencies || {}), ...ADDED_DEPENDENCIES };
+    pkg.devDependencies = { ...(pkg.devDependencies || {}), ...ADDED_DEV_DEPENDENCIES };
+    pkg.scripts = { ...(pkg.scripts || {}), ...ADDED_SCRIPTS };
+    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
+}
+function patchViteConfig(projectDir) {
+    const vitePath = path.join(projectDir, "vite.config.ts");
+    if (!fs.existsSync(vitePath))
+        return;
+    let content = fs.readFileSync(vitePath, "utf-8");
+    // Make port configurable via VITE_PORT env var (default 5174 for Caddy local mode,
+    // sandbox sets VITE_PORT=5173 so the Docker port binding works)
+    content = content.replace(/port:\s*5173/, "port: parseInt(process.env.VITE_PORT || '5174')");
+    // Bind to all interfaces so Caddy/Docker/Sprites can reach the dev server.
+    // Insert host + allowedHosts + proxy together after port to keep them grouped.
+    if (!content.includes("host:")) {
+        content = content.replace(/port:\s*parseInt\(process\.env\.VITE_PORT \|\| '5174'\),?/, "port: parseInt(process.env.VITE_PORT || '5174'),\n\t\thost: true,");
+    }
+    // Ensure allowedHosts is always present — Vite blocks requests from
+    // Sprites hostnames (*.sprites.app) without it.
+    // Must be boolean `true`, NOT the string "all" — Vite only accepts
+    // `string[] | true` (see https://vite.dev/config/server-options).
+    if (!content.includes("allowedHosts")) {
+        if (content.match(/host:\s*/)) {
+            content = content.replace(/(host:\s*[^,\n]+,?)/, "$1\n\t\tallowedHosts: true,");
+        }
+        else if (content.match(/server:\s*\{/)) {
+            content = content.replace(/(server:\s*\{)/, "$1\n\t\tallowedHosts: true,");
+        }
+    }
+    // Add proxy for Electric shape API — works with both Caddy (external) and
+    // sandbox (no Caddy, Electric on localhost:3000) setups
+    if (!content.includes("proxy:")) {
+        const proxyBlock = [
+            "\t\tproxy: {",
+            "\t\t\t'/v1/shape': {",
+            "\t\t\t\ttarget: process.env.ELECTRIC_URL || 'http://localhost:3000',",
+            "\t\t\t\tchangeOrigin: true,",
+            "\t\t\t},",
+            "\t\t},",
+        ].join("\n");
+        // Insert proxy after allowedHosts or host line
+        if (content.includes("allowedHosts")) {
+            content = content.replace(/(allowedHosts:\s*true,?)/, `$1\n${proxyBlock}`);
+        }
+        else {
+            content = content.replace(/(host:\s*true,?)/, `$1\n${proxyBlock}`);
+        }
+    }
+    fs.writeFileSync(vitePath, content, "utf-8");
+}
+// NOTE: patchRootRoute intentionally does NOT add ssr: false to the root
+// route. The root renders the HTML shell (<html>, <head>, <Scripts>).
+// Disabling SSR there prevents the document from rendering — blank page.
+// The coder agent adds ssr: false to individual leaf routes instead.
+function patchRootRoute(_projectDir) {
+    // no-op — root route must always SSR
+}
+function patchPublicCssImports(projectDir) {
+    const rootPath = path.join(projectDir, "src/routes/__root.tsx");
+    if (!fs.existsSync(rootPath))
+        return;
+    let content = fs.readFileSync(rootPath, "utf-8");
+    // KPB imports typography.css from the public dir via a module import:
+    //   import typographyCss from '/typography.css?url'
+    // Rollup can't resolve absolute public-dir paths during production builds.
+    // The capsizeRadixPlugin generates this file into public/ only when Vite
+    // runs, so it may not exist yet at scaffold time.
+    //
+    // Fix: remove the module import and inline the public path as a string
+    // literal. Vite serves public/ files at the root, so "/typography.css"
+    // works in both dev and production.
+    const hasTypographyImport = content.includes(`'/typography.css?url'`) || content.includes(`"/typography.css?url"`);
+    if (hasTypographyImport) {
+        // Remove the import statement
+        content = content.replace(/import\s+typographyCss\s+from\s+['"]\/typography\.css\?url['"];?\s*\n/, "");
+        // Replace the variable reference with a string literal
+        content = content.replace(/href:\s*typographyCss/g, 'href: "/typography.css"');
+        fs.writeFileSync(rootPath, content, "utf-8");
+    }
+}
+function patchGitignore(projectDir) {
+    const gitignorePath = path.join(projectDir, ".gitignore");
+    let content = "";
+    if (fs.existsSync(gitignorePath)) {
+        content = fs.readFileSync(gitignorePath, "utf-8");
+    }
+    const additions = [];
+    if (!content.includes("_agent/"))
+        additions.push("_agent/");
+    if (!content.includes("drizzle/meta/"))
+        additions.push("drizzle/meta/");
+    if (!content.includes(".env"))
+        additions.push(".env");
+    if (additions.length > 0) {
+        content += `\n# Electric Agent\n${additions.join("\n")}\n`;
+        fs.writeFileSync(gitignorePath, content, "utf-8");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/scaffold/index.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,3 @@
+import type { ProgressReporter } from "../progress/reporter.js";
+export declare function createBuildTool(projectDir: string, reporter?: ProgressReporter): import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{}>;
+//# sourceMappingURL=build.d.ts.map

package/dist/tools/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,qEAsF9E"}

package/dist/tools/build.js

@@ -0,0 +1,84 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { tool } from "@anthropic-ai/claude-agent-sdk";
+export function createBuildTool(projectDir, reporter) {
+    return tool("build", "Run pnpm build and pnpm check (Biome lint) in the project. Returns build output including any TypeScript or lint errors.", {}, async () => {
+        let buildOutput = "";
+        let checkOutput = "";
+        let success = true;
+        const errors = [];
+        try {
+            buildOutput = execSync("pnpm run build 2>&1", {
+                encoding: "utf-8",
+                timeout: 120_000,
+                cwd: projectDir,
+            });
+        }
+        catch (e) {
+            success = false;
+            buildOutput =
+                e?.stdout || (e instanceof Error ? e.message : "Build failed");
+            errors.push("build");
+        }
+        try {
+            checkOutput = execSync("pnpm run check 2>&1", {
+                encoding: "utf-8",
+                timeout: 60_000,
+                cwd: projectDir,
+            });
+        }
+        catch (e) {
+            success = false;
+            checkOutput =
+                e?.stdout || (e instanceof Error ? e.message : "Check failed");
+            errors.push("check");
+        }
+        // Run smoke tests if tests/ directory exists
+        let testOutput = "";
+        const testsDir = path.join(projectDir, "tests");
+        if (fs.existsSync(testsDir)) {
+            try {
+                testOutput = execSync("pnpm test 2>&1", {
+                    encoding: "utf-8",
+                    timeout: 120_000,
+                    cwd: projectDir,
+                });
+            }
+            catch (e) {
+                success = false;
+                testOutput =
+                    e?.stdout ||
+                        (e instanceof Error ? e.message : "Tests failed");
+                errors.push("test");
+            }
+        }
+        const outputParts = [
+            "=== pnpm run build ===",
+            buildOutput.trim(),
+            "",
+            "=== pnpm run check ===",
+            checkOutput.trim(),
+        ];
+        if (testOutput) {
+            outputParts.push("", "=== pnpm test ===", testOutput.trim());
+        }
+        const output = outputParts.join("\n");
+        if (reporter?.verboseMode) {
+            reporter.log("verbose", `[build output]\n${output}`);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success,
+                        output: output.slice(0, 10_000),
+                        errors: errors.join(", ") || "none",
+                    }),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/playbook.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+/**
+ * Validate that all required playbook skills are installed in the project.
+ * Throws if any are missing so generation fails fast.
+ */
+export declare function validatePlaybooks(projectDir: string): void;
+export declare function createPlaybookTools(projectDir: string): {
+    readPlaybookTool: import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+        name: z.ZodString;
+        include_references: z.ZodOptional<z.ZodBoolean>;
+    }>;
+    listPlaybooksTool: import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{}>;
+};
+//# sourceMappingURL=playbook.d.ts.map

package/dist/tools/playbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/tools/playbook.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwGvB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA2B1D;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM;;;;;;EAsJrD"}