apiario 0.6.0 → 0.8.0

package/dist/extensions/subagent/spawn.js

@@ -0,0 +1,326 @@
+/**
+ * Spawn do child process (npx apiario --mode json)
+ *
+ * Lida com:
+ *   - Spawn do processo filho
+ *   - Streaming de saída JSON-line
+ *   - Coleta de resultados (mensagens, uso)
+ *   - Abort (Ctrl+C) — mata o child
+ */
+import { spawn } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { withFileMutationQueue } from "@earendil-works/pi-coding-agent";
+// ---------------------------------------------------------------------------
+// Constantes
+// ---------------------------------------------------------------------------
+const PER_TASK_OUTPUT_CAP = 50 * 1024; // 50 KB por task visível ao modelo pai
+// ---------------------------------------------------------------------------
+// Helpers de output
+// ---------------------------------------------------------------------------
+function getFinalOutput(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === "assistant") {
+            for (const part of msg.content) {
+                if (part.type === "text")
+                    return part.text;
+            }
+        }
+    }
+    return "";
+}
+export function isFailedResult(result) {
+    return (result.exitCode !== 0 ||
+        result.stopReason === "error" ||
+        result.stopReason === "aborted");
+}
+export function getResultOutput(result) {
+    if (isFailedResult(result)) {
+        return (result.errorMessage ||
+            result.stderr ||
+            getFinalOutput(result.messages) ||
+            "(sem saída)");
+    }
+    return getFinalOutput(result.messages) || "(sem saída)";
+}
+export function truncateParallelOutput(output) {
+    const byteLength = Buffer.byteLength(output, "utf8");
+    if (byteLength <= PER_TASK_OUTPUT_CAP)
+        return output;
+    let truncated = output.slice(0, PER_TASK_OUTPUT_CAP);
+    while (Buffer.byteLength(truncated, "utf8") > PER_TASK_OUTPUT_CAP) {
+        truncated = truncated.slice(0, -1);
+    }
+    return `${truncated}\n\n[Saída truncada: ${byteLength - Buffer.byteLength(truncated, "utf8")} bytes omitidos. Conteúdo completo preservado nos detalhes da ferramenta.]`;
+}
+export function formatTokens(count) {
+    if (count < 1000)
+        return count.toString();
+    if (count < 10000)
+        return `${(count / 1000).toFixed(1)}k`;
+    if (count < 1000000)
+        return `${Math.round(count / 1000)}k`;
+    return `${(count / 1000000).toFixed(1)}M`;
+}
+export function formatUsageStats(usage, model) {
+    const parts = [];
+    if (usage.turns)
+        parts.push(`${usage.turns} turno${usage.turns > 1 ? "s" : ""}`);
+    if (usage.input)
+        parts.push(`↑${formatTokens(usage.input)}`);
+    if (usage.output)
+        parts.push(`↓${formatTokens(usage.output)}`);
+    if (usage.cacheRead)
+        parts.push(`R${formatTokens(usage.cacheRead)}`);
+    if (usage.cacheWrite)
+        parts.push(`W${formatTokens(usage.cacheWrite)}`);
+    if (usage.cost)
+        parts.push(`R$ ${usage.cost.toFixed(4)}`);
+    if (usage.contextTokens && usage.contextTokens > 0) {
+        parts.push(`ctx:${formatTokens(usage.contextTokens)}`);
+    }
+    if (model)
+        parts.push(model);
+    return parts.join(" ");
+}
+// ---------------------------------------------------------------------------
+// Descoberta do binário apiario
+// ---------------------------------------------------------------------------
+function getApiarioInvocation(args) {
+    const currentScript = process.argv[1];
+    if (currentScript && fs.existsSync(currentScript)) {
+        return { command: process.execPath, args: [currentScript, ...args] };
+    }
+    // Fallback: tenta npx apiario
+    return { command: "npx", args: ["apiario", ...args] };
+}
+// ---------------------------------------------------------------------------
+// Helpers de sistema de arquivos
+// ---------------------------------------------------------------------------
+async function writePromptToTempFile(agentName, prompt) {
+    const tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "apiario-subagent-"));
+    const safeName = agentName.replace(/[^\w.-]+/g, "_");
+    const filePath = path.join(tmpDir, `prompt-${safeName}.md`);
+    await withFileMutationQueue(filePath, async () => {
+        await fs.promises.writeFile(filePath, prompt, {
+            encoding: "utf-8",
+            mode: 0o600,
+        });
+    });
+    return { dir: tmpDir, filePath };
+}
+function cleanupTemp(dir, file) {
+    if (file) {
+        try {
+            fs.unlinkSync(file);
+        }
+        catch {
+            /* ignora */
+        }
+    }
+    if (dir) {
+        try {
+            fs.rmdirSync(dir);
+        }
+        catch {
+            /* ignora */
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Spawn do subagent
+// ---------------------------------------------------------------------------
+export async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, signal, onUpdate, makeDetails) {
+    const agent = agents.find((a) => a.name === agentName);
+    if (!agent) {
+        const available = agents.map((a) => `"${a.name}"`).join(", ") || "nenhum";
+        return {
+            agent: agentName,
+            agentSource: "unknown",
+            task,
+            exitCode: 1,
+            messages: [],
+            stderr: `Agente desconhecido: "${agentName}". Agentes disponíveis: ${available}.`,
+            usage: {
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                cost: 0,
+                contextTokens: 0,
+                turns: 0,
+            },
+            step,
+        };
+    }
+    const childArgs = ["--mode", "json", "--no-session"];
+    if (agent.model)
+        childArgs.push("--model", agent.model);
+    if (agent.tools && agent.tools.length > 0) {
+        childArgs.push("--tools", agent.tools.join(","));
+    }
+    let tmpDir = null;
+    let tmpPath = null;
+    const currentResult = {
+        agent: agentName,
+        agentSource: agent.source,
+        task,
+        exitCode: 0,
+        messages: [],
+        stderr: "",
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            cost: 0,
+            contextTokens: 0,
+            turns: 0,
+        },
+        model: agent.model,
+        step,
+    };
+    const emitUpdate = () => {
+        if (onUpdate) {
+            onUpdate({
+                content: [
+                    {
+                        type: "text",
+                        text: getFinalOutput(currentResult.messages) || "(executando...)",
+                    },
+                ],
+                details: makeDetails([currentResult]),
+            });
+        }
+    };
+    try {
+        if (agent.systemPrompt.trim()) {
+            const tmp = await writePromptToTempFile(agent.name, agent.systemPrompt);
+            tmpDir = tmp.dir;
+            tmpPath = tmp.filePath;
+            childArgs.push("--append-system-prompt", tmpPath);
+        }
+        // Passa a task como argumento posicional (mensagem inicial)
+        childArgs.push(task);
+        let wasAborted = false;
+        const exitCode = await new Promise((resolve) => {
+            const invocation = getApiarioInvocation(childArgs);
+            const proc = spawn(invocation.command, invocation.args, {
+                cwd: cwd ?? defaultCwd,
+                shell: false,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let buffer = "";
+            const processLine = (line) => {
+                if (!line.trim())
+                    return;
+                let event;
+                try {
+                    event = JSON.parse(line);
+                }
+                catch {
+                    return;
+                }
+                if (event.type === "message_end" && event.message) {
+                    const msg = event.message;
+                    currentResult.messages.push(msg);
+                    if (msg.role === "assistant") {
+                        currentResult.usage.turns++;
+                        const usage = msg.usage;
+                        if (usage) {
+                            currentResult.usage.input += usage.input || 0;
+                            currentResult.usage.output += usage.output || 0;
+                            currentResult.usage.cacheRead += usage.cacheRead || 0;
+                            currentResult.usage.cacheWrite += usage.cacheWrite || 0;
+                            currentResult.usage.cost += usage.cost?.total || 0;
+                            currentResult.usage.contextTokens = usage.totalTokens || 0;
+                        }
+                        if (!currentResult.model && msg.model)
+                            currentResult.model = msg.model;
+                        if (msg.stopReason)
+                            currentResult.stopReason = msg.stopReason;
+                        if (msg.errorMessage)
+                            currentResult.errorMessage = msg.errorMessage;
+                    }
+                    emitUpdate();
+                }
+                if (event.type === "tool_execution_end" && event.toolCallId) {
+                    currentResult.messages.push({
+                        role: "assistant",
+                        content: [
+                            {
+                                type: "toolCall",
+                                id: event.toolCallId,
+                                name: event.toolName,
+                                arguments: event.args,
+                            },
+                        ],
+                    });
+                    emitUpdate();
+                }
+            };
+            proc.stdout.on("data", (data) => {
+                buffer += data.toString();
+                const lines = buffer.split("\n");
+                buffer = lines.pop() || "";
+                for (const line of lines)
+                    processLine(line);
+            });
+            proc.stderr.on("data", (data) => {
+                currentResult.stderr += data.toString();
+            });
+            proc.on("close", (code) => {
+                if (buffer.trim())
+                    processLine(buffer);
+                resolve(code ?? 0);
+            });
+            proc.on("error", () => {
+                resolve(1);
+            });
+            if (signal) {
+                const killProc = () => {
+                    wasAborted = true;
+                    proc.kill("SIGTERM");
+                    setTimeout(() => {
+                        if (!proc.killed)
+                            proc.kill("SIGKILL");
+                    }, 5000);
+                };
+                if (signal.aborted)
+                    killProc();
+                else
+                    signal.addEventListener("abort", killProc, { once: true });
+            }
+        });
+        currentResult.exitCode = exitCode;
+        if (wasAborted)
+            throw new Error("Subagent interrompido pelo usuário");
+        return currentResult;
+    }
+    finally {
+        cleanupTemp(tmpDir, tmpPath);
+    }
+}
+// ---------------------------------------------------------------------------
+// Concorrência limitada
+// ---------------------------------------------------------------------------
+export async function mapWithConcurrencyLimit(items, concurrency, fn) {
+    if (items.length === 0)
+        return [];
+    const limit = Math.max(1, Math.min(concurrency, items.length));
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const workers = new Array(limit).fill(null).map(async () => {
+        while (true) {
+            const current = nextIndex++;
+            if (current >= items.length)
+                return;
+            results[current] = await fn(items[current], current);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/extensions/subagent/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/extensions/subagent/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAwCxE,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,uCAAuC;AAE9E,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,SAAS,cAAc,CAAC,QAAmB;IACzC,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,IAAI,CAAC,IAAI,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,CACL,MAAM,CAAC,QAAQ,KAAK,CAAC;QACrB,MAAM,CAAC,UAAU,KAAK,OAAO;QAC7B,MAAM,CAAC,UAAU,KAAK,SAAS,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,CACL,MAAM,CAAC,YAAY;YACnB,MAAM,CAAC,MAAM;YACb,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC/B,aAAa,CACd,CAAC;IACJ,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,UAAU,IAAI,mBAAmB;QAAE,OAAO,MAAM,CAAC;IAErD,IAAI,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,mBAAmB,EAAE,CAAC;QAClE,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,SAAS,wBAAwB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,4EAA4E,CAAC;AAC3K,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1C,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,IAAI,KAAK,GAAG,OAAO;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;IAC3D,OAAO,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,KAAc;IAEd,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,KAAK;QACb,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,SAAS,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,SAAS,oBAAoB,CAC3B,IAAc;IAEd,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,aAAa,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,KAAK,UAAU,qBAAqB,CAClC,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CACtC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAC5C,CAAC;IACF,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,QAAQ,KAAK,CAAC,CAAC;IAE5D,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE;YAC5C,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,GAAkB,EAAE,IAAmB;IAC1D,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,MAAqB,EACrB,SAAiB,EACjB,IAAY,EACZ,GAAuB,EACvB,IAAwB,EACxB,MAA+B,EAC/B,QAAsC,EACtC,WAAyD;IAEzD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAEvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QAC1D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,SAAS;YACtB,IAAI;YACJ,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,yBAAyB,SAAS,2BAA2B,SAAS,GAAG;YACjF,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,CAAC;gBACZ,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,CAAC;gBACP,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE,CAAC;aACT;YACD,IAAI;SACL,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,KAAK;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,MAAM,aAAa,GAAiB;QAClC,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,IAAI;QACJ,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,KAAK,EAAE;YACL,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,IAAI,EAAE,CAAC;YACP,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,CAAC;SACT;QACD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI;KACL,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC;gBACP,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,iBAAiB;qBAC9D;iBACF;gBACD,OAAO,EAAE,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,qBAAqB,CACrC,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,YAAY,CACnB,CAAC;YACF,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC;YACjB,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QAED,4DAA4D;QAC5D,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErB,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrD,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE;gBACtD,GAAG,EAAE,GAAG,IAAI,UAAU;gBACtB,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;gBACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE,OAAO;gBACzB,IAAI,KAAU,CAAC;gBACf,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO;gBACT,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAkB,CAAC;oBACrC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAEjC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAC7B,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;wBAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;wBACxB,IAAI,KAAK,EAAE,CAAC;4BACV,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;4BAC9C,aAAa,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;4BAChD,aAAa,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;4BACtD,aAAa,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;4BACxD,aAAa,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;4BACnD,aAAa,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;wBAC7D,CAAC;wBACD,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK;4BACnC,aAAa,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;wBAClC,IAAI,GAAG,CAAC,UAAU;4BAAE,aAAa,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;wBAC9D,IAAI,GAAG,CAAC,YAAY;4BAAE,aAAa,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;oBACtE,CAAC;oBACD,UAAU,EAAE,CAAC;gBACf,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBAC5D,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAC1B,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,UAAU;gCAChB,EAAE,EAAE,KAAK,CAAC,UAAU;gCACpB,IAAI,EAAE,KAAK,CAAC,QAAQ;gCACpB,SAAS,EAAE,KAAK,CAAC,IAAI;6BACf;yBACT;qBACS,CAAC,CAAC;oBACd,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAC3B,KAAK,MAAM,IAAI,IAAI,KAAK;oBAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACtC,aAAa,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,MAAM,CAAC,IAAI,EAAE;oBAAE,WAAW,CAAC,MAAM,CAAC,CAAC;gBACvC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpB,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;YAEH,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,QAAQ,GAAG,GAAG,EAAE;oBACpB,UAAU,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACrB,UAAU,CAAC,GAAG,EAAE;wBACd,IAAI,CAAC,IAAI,CAAC,MAAM;4BAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACzC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACX,CAAC,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO;oBAAE,QAAQ,EAAE,CAAC;;oBAE7B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAClC,IAAI,UAAU;YACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,OAAO,aAAa,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAY,EACZ,WAAmB,EACnB,EAA+C;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAW,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;QACzD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;YAC5B,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YACpC,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "apiario",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "CLI Harness — pi.dev TUI wrapper for Apiário Dev API",
   "type": "module",
   "bin": {
-    "apiario": "./dist/cli.js"
+    "apiario": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc",
@@ -12,9 +12,9 @@
     "dev": "tsc --watch"
   },
   "dependencies": {
-    "@earendil-works/pi-ai": "^0.79.4",
-    "@earendil-works/pi-coding-agent": "^0.79.4",
-    "@earendil-works/pi-tui": "^0.79.4",
+    "@earendil-works/pi-ai": "^0.79.6",
+    "@earendil-works/pi-coding-agent": "^0.79.6",
+    "@earendil-works/pi-tui": "^0.79.6",
     "typebox": "1.1.38"
   },
   "devDependencies": {
@@ -24,6 +24,7 @@
     "node": ">=20.6.0"
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ]
 }

package/skills/git-worktree/SKILL.md

@@ -0,0 +1,203 @@
+---
+name: git-worktree
+description: Isola todas as alterações de código em um git worktree separado, protegendo a branch atual de mudanças durante a implementação de features ou correções
+compatibility: Requer git >= 2.5 (git worktree add) e permissão de escrita no sistema de arquivos
+---
+
+# Git Worktree
+
+## Visão Geral
+
+Garante que o trabalho aconteça em um workspace isolado. Prefere ferramentas nativas de worktree da plataforma. Usa `git worktree` manual como fallback apenas quando não há ferramenta nativa disponível.
+
+**Princípio central:** Detecte isolamento existente primeiro. Use ferramentas nativas. Depois fallback para git. Nunca lute contra o harness.
+
+**Anuncie no início:** "Estou usando a skill git-worktree para configurar um workspace isolado."
+
+## Passo 0: Detectar Isolamento Existente
+
+**Antes de criar qualquer coisa, verifique se você já está em um workspace isolado.**
+
+```bash
+GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
+GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
+BRANCH=$(git branch --show-current)
+```
+
+**Proteção contra submodules:** `GIT_DIR != GIT_COMMON` também é verdadeiro dentro de submodules. Antes de concluir "já estou em um worktree", verifique se não está em um submodule:
+
+```bash
+# Se retornar um caminho, você está em um submodule — trate como repositório normal
+git rev-parse --show-superproject-working-tree 2>/dev/null
+```
+
+**Se `GIT_DIR != GIT_COMMON` (e não for submodule):** Você já está em um worktree vinculado. Pule para o Passo 2 (Configuração do Projeto). NÃO crie outro worktree.
+
+Reporte o estado da branch:
+- Em uma branch: "Já estou em workspace isolado em `<caminho>` na branch `<nome>`."
+- HEAD detached: "Já estou em workspace isolado em `<caminho>` (HEAD detached, gerenciado externamente). Criação de branch necessária no final."
+
+**Se `GIT_DIR == GIT_COMMON` (ou em submodule):** Você está em um checkout normal do repositório.
+
+O usuário já indicou sua preferência de worktree nas instruções? Se não, peça consentimento antes de criar um worktree:
+
+> "Gostaria que eu configurasse um worktree isolado? Isso protege sua branch atual de alterações."
+
+Respeite qualquer preferência já declarada sem perguntar novamente. Se o usuário recusar, trabalhe no diretório atual e pule para o Passo 2.
+
+## Passo 1: Criar Workspace Isolado
+
+**Você tem dois mecanismos. Tente nesta ordem.**
+
+### 1a. Ferramentas Nativas de Worktree (preferido)
+
+O usuário pediu um workspace isolado (consentimento do Passo 0). Você já tem uma forma de criar worktree? Pode ser uma ferramenta com nome `EnterWorktree`, `WorktreeCreate`, um comando `/worktree` ou uma flag `--worktree`. Se tiver, use e pule para o Passo 2.
+
+Ferramentas nativas cuidam da colocação do diretório, criação da branch e limpeza automaticamente. Usar `git worktree add` quando você tem uma ferramenta nativa cria estado fantasma que seu harness não consegue ver ou gerenciar.
+
+Só prossiga para o Passo 1b se não tiver ferramenta nativa de worktree disponível.
+
+### 1b. Git Worktree Fallback
+
+**Use apenas se o Passo 1a não se aplicar** — você não tem ferramenta nativa de worktree disponível. Crie um worktree manualmente usando git.
+
+#### Seleção de Diretório
+
+Siga esta ordem de prioridade. Preferência explícita do usuário sempre vence estado observado do filesystem.
+
+1. **Verifique suas instruções para uma preferência de diretório de worktree declarada.** Se o usuário já especificou uma, use sem perguntar.
+
+2. **Verifique se existe um diretório de worktree local do projeto:**
+   ```bash
+   ls -d .worktrees 2>/dev/null     # Preferido (oculto)
+   ls -d worktrees 2>/dev/null      # Alternativa
+   ```
+   Se encontrado, use. Se ambos existirem, `.worktrees` vence.
+
+3. **Se não houver outra orientação disponível**, use `.worktrees/` na raiz do projeto como padrão.
+
+#### Verificação de Segurança (apenas diretórios locais do projeto)
+
+**DEVE verificar se o diretório está no .gitignore antes de criar worktree:**
+
+```bash
+git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
+```
+
+**Se NÃO estiver ignorado:** Adicione ao .gitignore, faça commit da mudança, então prossiga.
+
+**Por que é crítico:** Previne que conteúdo do worktree seja acidentalmente commitado ao repositório.
+
+#### Criar o Worktree
+
+```bash
+# Determine o caminho baseado na localização escolhida
+caminho="$LOCALIZACAO/$NOME_DA_BRANCH"
+
+git worktree add "$caminho" -b "$NOME_DA_BRANCH"
+cd "$caminho"
+```
+
+**Sandbox fallback:** Se `git worktree add` falhar com erro de permissão (negação do sandbox), informe que o sandbox bloqueou a criação do worktree e que você está trabalhando no diretório atual. Então execute setup e testes de baseline no lugar.
+
+## Passo 2: Configuração do Projeto
+
+Auto-detecte e execute o setup apropriado:
+
+```bash
+# Node.js
+if [ -f package.json ]; then npm install; fi
+
+# Rust
+if [ -f Cargo.toml ]; then cargo build; fi
+
+# Python
+if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+if [ -f pyproject.toml ]; then poetry install; fi
+
+# Go
+if [ -f go.mod ]; then go mod download; fi
+```
+
+## Passo 3: Verificar Baseline Limpo
+
+Execute testes para garantir que o workspace começa limpo:
+
+```bash
+# Use o comando apropriado para o projeto
+npm test / cargo test / pytest / go test ./...
+```
+
+**Se os testes falharem:** Reporte as falhas, pergunte se deve prosseguir ou investigar.
+
+**Se os testes passarem:** Reporte pronto.
+
+### Relatório
+
+```
+Worktree pronto em <caminho-completo>
+Testes passando (<N> testes, 0 falhas)
+Pronto para implementar <nome-da-feature>
+```
+
+## Tabela de Referência Rápida
+
+| Situação | Ação |
+|----------|------|
+| Já em worktree vinculado | Pule criação (Passo 0) |
+| Em submodule | Trate como repositório normal (guarda do Passo 0) |
+| Ferramenta nativa de worktree disponível | Use (Passo 1a) |
+| Sem ferramenta nativa | Fallback git worktree (Passo 1b) |
+| `.worktrees/` existe | Use (verifique se ignorado) |
+| `worktrees/` existe | Use (verifique se ignorado) |
+| Ambos existem | Use `.worktrees/` |
+| Nenhum existe | Verifique instruções, depois padrão `.worktrees/` |
+| Diretório não ignorado | Adicione ao .gitignore + commit |
+| Erro de permissão ao criar | Sandbox fallback, trabalhe no lugar |
+| Testes falham no baseline | Reporte falhas + pergunte |
+| Sem package.json/Cargo.toml | Pule instalação de dependências |
+
+## Erros Comuns
+
+### Lutando contra o harness
+
+- **Problema:** Usar `git worktree add` quando a plataforma já oferece isolamento
+- **Correção:** Passo 0 detecta isolamento existente. Passo 1a delega para ferramentas nativas.
+
+### Pulando detecção
+
+- **Problema:** Criar worktree aninhado dentro de um worktree existente
+- **Correção:** Sempre execute o Passo 0 antes de criar qualquer coisa
+
+### Pulando verificação de ignorado
+
+- **Problema:** Conteúdo do worktree fica rastreado, poluindo git status
+- **Correção:** Sempre use `git check-ignore` antes de criar worktree local do projeto
+
+### Assumindo localização do diretório
+
+- **Problema:** Cria inconsistência, viola convenções do projeto
+- **Correção:** Siga prioridade: instruções explícitas > diretório local existente do projeto > padrão
+
+### Prosseguindo com testes falhando
+
+- **Problema:** Não é possível distinguir novos bugs de problemas pré-existentes
+- **Correção:** Reporte falhas, obtenha permissão explícita para prosseguir
+
+## Bandeiras Vermelhas
+
+**Nunca:**
+- Crie worktree quando o Passo 0 detecta isolamento existente
+- Use `git worktree add` quando você tem ferramenta nativa de worktree (ex.: `EnterWorktree`). Este é o erro #1 — se você tem, use-a.
+- Pule o Passo 1a indo direto para comandos git do Passo 1b
+- Crie worktree sem verificar se o diretório está ignorado (local do projeto)
+- Pule verificação de baseline de testes
+- Prossiga com testes falhando sem perguntar
+
+**Sempre:**
+- Execute detecção do Passo 0 primeiro
+- Prefira ferramentas nativas sobre fallback git
+- Siga prioridade de diretório: instruções explícitas > diretório local existente do projeto > padrão
+- Verifique se o diretório está ignorado para diretórios locais do projeto
+- Auto-detecte e execute setup do projeto
+- Verifique baseline limpo de testes