@autonsh/cli 0.17.2 → 0.18.0

package/dist/template-registry.js

@@ -0,0 +1,294 @@
+/**
+ * Template Registry — carrega templates built-in + custom (~/.auton/templates)
+ * Fonte única de verdade para `auton init`, `auton template list`, etc.
+ */
+import { readFile, readdir, mkdir } from "node:fs/promises";
+import { join, resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+const SRC = dirname(fileURLToPath(import.meta.url));
+const BUILTIN_TEMPLATES_DIR = resolve(SRC, "../templates");
+const USER_TEMPLATES_DIR = join(homedir(), ".auton", "templates");
+async function parseTemplateJson(dir, source) {
+    const jsonPath = join(dir, "template.json");
+    try {
+        const raw = await readFile(jsonPath, "utf8");
+        const spec = JSON.parse(raw);
+        return {
+            ...spec,
+            source,
+            templateDir: dir,
+            category: spec.category ?? "general",
+            defaultMode: spec.defaultMode ?? "build",
+            skills: spec.skills ?? [],
+            verifyGates: spec.verifyGates ?? [],
+            variables: spec.variables ?? [],
+            hasGenesis: spec.hasGenesis ?? false,
+        };
+    }
+    catch {
+        return inferFromTaskYaml(dir, source);
+    }
+}
+async function inferFromTaskYaml(dir, source) {
+    const taskPath = join(dir, "task.yaml");
+    try {
+        const raw = await readFile(taskPath, "utf8");
+        const name = raw.match(/^name:\s*(\S+)/m)?.[1] ?? basename(dir);
+        const entry = raw.match(/^entry:\s*(\S+)/m)?.[1] ?? "agent.ts";
+        const modelMatch = raw.match(/^models:\s*\n\s*default:\s*(\S+)/m);
+        const defaultModel = modelMatch?.[1] ?? "mock:local";
+        const modeMatch = raw.match(/^mode:\s*(\S+)/m);
+        const defaultMode = modeMatch?.[1] ?? "build";
+        const skillsBlock = raw.match(/^skills:\s*\n((?:[ \t]*- \S+\n?)+)/m);
+        const skills = skillsBlock?.[1]
+            ?.split("\n")
+            .map(l => l.match(/^\s*-\s*(\S+)/)?.[1])
+            .filter((s) => Boolean(s)) ?? [];
+        const verifyBlock = raw.match(/^verify:\s*\n((?:[ \t]+\S.*\n?)+)/m);
+        const verifyGates = [];
+        if (verifyBlock?.[1]) {
+            for (const line of verifyBlock[1].split("\n")) {
+                const m = line.match(/^\s+([A-Za-z0-9_-]+):\s*["']?([^"'\n]+)["']?\s*$/);
+                if (m && m[1] && m[2] && m[1] !== "timeout_ms" && m[1] !== "on-fail") {
+                    verifyGates.push({ name: m[1], cmd: m[2].trim() });
+                }
+            }
+        }
+        const genesisMatch = raw.match(/^genesis:\s*[\|>]\s*\n((?:[ \t].*\n?)+)/m);
+        const hasGenesis = !!genesisMatch;
+        return {
+            id: name,
+            name: name.charAt(0).toUpperCase() + name.slice(1).replace(/-/g, " "),
+            description: raw.match(/^description:\s*["']?([^"'\n]+)/m)?.[1]?.trim() ?? "",
+            category: name === "harness" ? "harness" : "general",
+            entry,
+            defaultModel,
+            defaultMode,
+            skills,
+            verifyGates,
+            hasGenesis,
+            genesisPrompt: genesisMatch?.[1]?.replace(/^[ \t]/gm, "").trim(),
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+            source,
+            templateDir: dir,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function basename(dir) {
+    return dir.split("/").pop() ?? dir;
+}
+function getBuiltinTemplates() {
+    const builtinFallback = {
+        support: {
+            id: "support",
+            name: "Support Bot",
+            description: "Bot de suporte: prompt → LLM → responde + contador",
+            category: "general",
+            entry: "agent.ts",
+            defaultModel: "mock:local",
+            defaultMode: "build",
+            skills: [],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        "cron-digester": {
+            id: "cron-digester",
+            name: "Cron Digester",
+            description: "Digest periódico no storage",
+            category: "ops",
+            entry: "agent.ts",
+            defaultModel: "mock:local",
+            defaultMode: "build",
+            skills: [],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        "webhook-echo": {
+            id: "webhook-echo",
+            name: "Webhook Echo",
+            description: "Ecoa payload via invoke + emite evento",
+            category: "ops",
+            entry: "agent.ts",
+            defaultModel: "mock:local",
+            defaultMode: "build",
+            skills: [],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        "with-approval": {
+            id: "with-approval",
+            name: "With Approval",
+            description: "Task com gate humano (prepara → aprova → executa)",
+            category: "general",
+            entry: "agent.ts",
+            defaultModel: "mock:local",
+            defaultMode: "build",
+            skills: [],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        "api-json": {
+            id: "api-json",
+            name: "API JSON",
+            description: "Agente que retorna JSON estruturado",
+            category: "coding",
+            entry: "agent.ts",
+            defaultModel: "ollama:qwen2.5-coder:14b-instruct-q4_K_M",
+            defaultMode: "build",
+            skills: ["api"],
+            verifyGates: [{ name: "typecheck", cmd: "tsc --noEmit" }],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        "multi-agent": {
+            id: "multi-agent",
+            name: "Multi Agent",
+            description: "Coordenação de múltiplos agentes",
+            category: "ops",
+            entry: "agent.ts",
+            defaultModel: "ollama:qwen2.5-coder:14b-instruct-q4_K_M",
+            defaultMode: "build",
+            skills: [],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        coding: {
+            id: "coding",
+            name: "Coding Agent",
+            description: "Engenheiro TypeScript sênior — refatorar, testar, migrar",
+            category: "coding",
+            entry: "agent.ts",
+            defaultModel: "ollama:qwen2.5-coder:14b-instruct-q4_K_M",
+            defaultMode: "build",
+            skills: ["typescript", "refactoring", "testing"],
+            verifyGates: [
+                { name: "typecheck", cmd: "tsc --noEmit" },
+                { name: "test", cmd: "vitest run" },
+                { name: "lint", cmd: "eslint ." },
+            ],
+            hasGenesis: true,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        harness: {
+            id: "harness",
+            name: "Harness Local",
+            description: "Loop agêntico local (sem CP), checkpoints persistentes",
+            category: "harness",
+            entry: "harness.ts",
+            defaultModel: "ollama:qwen2.5-coder:14b-instruct-q4_K_M",
+            defaultMode: "harness",
+            skills: [],
+            verifyGates: [
+                { name: "typecheck", cmd: "tsc --noEmit" },
+                { name: "test", cmd: "vitest run" },
+            ],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+        research: {
+            id: "research",
+            name: "Research",
+            description: "Pesquisa e análise — modo research",
+            category: "research",
+            entry: "agent.ts",
+            defaultModel: "ollama:qwen2.5-coder:14b-instruct-q4_K_M",
+            defaultMode: "research",
+            skills: ["docs"],
+            verifyGates: [],
+            hasGenesis: false,
+            variables: [{ key: "name", label: "Nome do agente", type: "string", required: true }],
+        },
+    };
+    return Object.entries(builtinFallback).map(([id, spec]) => ({
+        ...spec,
+        id,
+        source: "builtin",
+        templateDir: join(BUILTIN_TEMPLATES_DIR, id),
+    }));
+}
+export async function createTemplateRegistry() {
+    let cache = [];
+    let loaded = false;
+    async function loadAll() {
+        const specs = [];
+        // 1. Built-in templates
+        try {
+            const builtinDirs = await readdir(BUILTIN_TEMPLATES_DIR, { withFileTypes: true });
+            for (const entry of builtinDirs) {
+                if (!entry.isDirectory())
+                    continue;
+                if (entry.name === "modes" || entry.name === "skills")
+                    continue;
+                const spec = await parseTemplateJson(join(BUILTIN_TEMPLATES_DIR, entry.name), "builtin");
+                if (spec)
+                    specs.push(spec);
+            }
+        }
+        catch {
+            specs.push(...getBuiltinTemplates());
+        }
+        // 2. Custom templates (~/.auton/templates)
+        try {
+            await mkdir(USER_TEMPLATES_DIR, { recursive: true });
+            const customDirs = await readdir(USER_TEMPLATES_DIR, { withFileTypes: true });
+            for (const entry of customDirs) {
+                if (!entry.isDirectory())
+                    continue;
+                const spec = await parseTemplateJson(join(USER_TEMPLATES_DIR, entry.name), "custom");
+                if (spec)
+                    specs.push(spec);
+            }
+        }
+        catch {
+            // diretório não existe ou vazio — ok
+        }
+        // Dedupe por id (custom vence builtin)
+        const seen = new Set();
+        const deduped = [];
+        for (const s of specs) {
+            if (!seen.has(s.id)) {
+                seen.add(s.id);
+                deduped.push(s);
+            }
+        }
+        return deduped;
+    }
+    const registry = {
+        async list() {
+            if (!loaded) {
+                cache = await loadAll();
+                loaded = true;
+            }
+            return cache;
+        },
+        async get(id) {
+            const all = await registry.list();
+            return all.find((t) => t.id === id);
+        },
+        async getByCategory(category) {
+            const all = await registry.list();
+            return all.filter((t) => t.category === category);
+        },
+        async reload() {
+            loaded = false;
+            cache = await loadAll();
+        },
+    };
+    return registry;
+}
+let _registry = null;
+export async function getTemplateRegistry() {
+    if (!_registry)
+        _registry = await createTemplateRegistry();
+    return _registry;
+}
+//# sourceMappingURL=template-registry.js.map

package/dist/template-registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autonsh/cli",
-  "version": "0.17.2",
+  "version": "0.18.0",
   "description": "auton CLI. Run autonomous tasks in one command.",
   "type": "module",
   "files": [
@@ -22,6 +22,7 @@
     "@clack/prompts": "^1.7.0",
     "boxen": "^8.0.1",
     "cli-progress": "^3.12.0",
+    "handlebars": "^4.7.8",
     "log-symbols": "^7.0.1",
     "ora": "^9.4.1",
     "picocolors": "^1.1.1",

package/templates/coding/agent.md

@@ -0,0 +1,39 @@
+# Coding Agent — Engenheiro TypeScript Sênior
+
+Você refatora, testa, migra e corrige código TypeScript.
+
+## Princípios Invioláveis
+1. **Entenda antes de mudar** — leia, trace dependências, entenda o fluxo
+2. **Mudanças atômicas** — um arquivo por vez, typecheck a cada passo
+3. **Tipos estritos** — `strict: true`, `noImplicitAny`, `exactOptionalPropertyTypes`
+4. **Testes obrigatórios** — unit + integration para lógica de negócio
+5. **Sem breaking changes** — API pública só com migração + depreciação
+6. **Performance consciente** — `const`, `readonly`, evite alocações
+7. **Documentação "por que"** — JSDoc em exports, comentários de decisão
+
+## Fluxo por Task
+```
+PLAN      → analise impacto, liste arquivos, defina testes
+IMPLEMENT → edite um arquivo, tsc --noEmit, commit mental
+TEST      → vitest run, coverage > 80%
+VERIFY    → goal atendido? gaps? evidência
+CHECKPOINT→ salve diff, testes, coverage
+```
+
+## Ferramentas
+- `ctx.tools.read(file)` — ler
+- `ctx.tools.write(file, content)` — escrever
+- `ctx.tools.patch(file, old, new)` — editar cirúrgico
+- `ctx.tools.exec(cmd)` — rodar tsc, vitest, eslint
+- `ctx.tools.list(dir)` — explorar
+- `ctx.storage` — KV persistente
+- `ctx.work.add(type, title, payload)` — findings/artifacts
+
+## Resposta (JSON)
+```json
+{ "file": "src/auth.ts", "content": "...", "reason": "adicionar Zod schema" }
+```
+ou finalização:
+```json
+{ "done": true, "summary": "Refatorado auth.ts + 12 testes + OpenAPI atualizado" }
+```

package/templates/coding/agent.ts

@@ -0,0 +1,83 @@
+import { readdirSync, readFileSync, existsSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { agent, TASK_DONE_EVENT } from "@autonsh/runtime";
+
+function readdirSyncSafe(dir: string): string[] {
+  try { return readdirSync(dir); } catch { return []; }
+}
+
+function readFileSafe(file: string): string {
+  try { return readFileSync(file, "utf8"); } catch { return ""; }
+}
+
+function writeFileSafe(file: string, content: string): void {
+  writeFileSync(file, content, "utf8");
+}
+
+export default agent(async (ctx) => {
+  const goal = ((ctx.input as { prompt?: string } | undefined)?.prompt ?? "").trim();
+  if (!goal) {
+    await ctx.events.emit(TASK_DONE_EVENT, { result: "goal vazio", evidence: {} });
+    return;
+  }
+
+  // Carrega agent.md (genesis) + skills
+  const agentMd = readFileSafe("agent.md");
+  const skillDocs = readdirSyncSafe("skills")
+    .filter((d) => existsSync(join("skills", d, "SKILL.md")))
+    .map((d) => `# skill: ${d}\n${readFileSafe(join("skills", d, "SKILL.md"))}`)
+    .join("\n\n");
+  const systemPrompt = `${agentMd}\n\n${skillDocs}`;
+
+  await ctx.logger.info("task iniciada", { goal });
+
+  // 1. PLAN — analisa código, propõe plano
+  const plan = await ctx.llm.chat({
+    system: `Você é um engenheiro sênior TypeScript.\n${systemPrompt}\n\nAnalise o codebase e proponha um PLANO detalhado para: ${goal}\nListe: arquivos a tocar, testes a criar, riscos.`,
+    prompt: goal,
+  });
+  await ctx.logger.info("plano", { plan });
+
+  // 2. IMPLEMENT — executa mudanças arquivo a arquivo
+  // Para simplicidade: pede ao LLM para gerar os diffs/patches
+  const implement = await ctx.llm.chat({
+    system: `Execute o plano. Use ctx.tools para ler/escrever/editar arquivos.\nFaça UMA mudança por vez. Rode tsc --noEmit após cada arquivo.\nResponda JSON: { file, content, reason } ou { done: true, summary }`,
+    prompt: plan,
+  });
+
+  let parsed: { file?: string; content?: string; reason?: string; done?: boolean; summary?: string };
+  try { parsed = JSON.parse(implement.trim()); } catch { parsed = { done: true, summary: implement }; }
+
+  if (!parsed.done && parsed.file && parsed.content) {
+    await ctx.tools.write(parsed.file, parsed.content);
+    await ctx.logger.info("arquivo escrito", { file: parsed.file, reason: parsed.reason });
+    
+    // Typecheck incremental
+    const tc = await ctx.tools.exec("tsc --noEmit").catch((e) => e.message);
+    await ctx.logger.info("typecheck", { result: tc });
+  }
+
+  // 3. TESTS — roda testes
+  const testResult = await ctx.tools.exec("vitest run --reporter=json").catch((e) => e.message);
+  await ctx.logger.info("testes", { result: testResult });
+
+  // 4. VERIFY — validação final
+  const verify = await ctx.llm.chat({
+    system: "Verifique: goal atendido? Testes passam? Typecheck limpo? Responda JSON: { pass: boolean, gaps: string[] }",
+    prompt: `Goal: ${goal}\nPlan: ${plan}\nTestes: ${testResult}`,
+  });
+
+  let verified: { pass: boolean; gaps: string[] };
+  try { verified = JSON.parse(verify.trim()); } catch { verified = { pass: false, gaps: ["parse error"] }; }
+
+  await ctx.logger.info("verificacao", { pass: verified.pass, gaps: verified.gaps });
+
+  // Work context
+  await ctx.work.add("finding", "implementação", { goal, plan, verify: verified });
+  await ctx.work.add("artifact", "mudanças", { files: parsed.file ? [parsed.file] : [] });
+
+  await ctx.events.emit(TASK_DONE_EVENT, {
+    result: verified.pass ? "Goal atendido" : `Gaps: ${verified.gaps.join(", ")}`,
+    evidence: { plan, testResult, verify: verified, filesChanged: parsed.file ? [parsed.file] : [] },
+  });
+});

package/templates/coding/task.yaml

@@ -0,0 +1,36 @@
+name: coding
+description: Agente de código — refatorar, testar, migrar, corrigir
+goal: ""
+entry: agent.ts
+models:
+  default: ollama:qwen2.5-coder:14b-instruct-q4_K_M
+env:
+  - GITHUB_TOKEN
+mode: build
+skills:
+  - typescript
+  - refactoring
+  - testing
+verify:
+  typecheck: "tsc --noEmit"
+  test: "vitest run"
+  lint: "eslint ."
+genesis: |
+  Você é um engenheiro de software sênior especializado em TypeScript.
+  
+  Princípios:
+  1. Entenda o código ANTES de mudar — leia, trace dependências
+  2. Mudanças pequenas, atômicas, testáveis
+  3. Tipos estritos: `strict: true`, `noImplicitAny`, `exactOptionalPropertyTypes`
+  4. Testes obrigatórios: unit + integration para lógica de negócio
+  5. Nunca quebre API pública sem migração + depreciação
+  6. Performance: evite alocações desnecessárias, use `const`, `readonly`
+  7. Documentação: JSDoc em exports públicos, comentários "por que" não "o que"
+  
+  Fluxo por task:
+  - PLAN: analise impacto, liste arquivos, defina testes
+  - IMPLEMENT: edite um arquivo por vez, rode typecheck a cada passo
+  - VERIFY: tsc --noEmit → vitest run → eslint
+  - CHECKPOINT: salve evidência (diff, testes, coverage)
+  
+  Responda em PT-BR. Seja conciso.

package/templates/harness/agent.md

@@ -0,0 +1,43 @@
+# Harness Agent — Loop Local
+
+Você é um agente autônomo que roda **local** (sem Control Plane).
+Seu ciclo: **PLAN → ACT → VERIFY → CHECKPOINT** até `done: true`.
+
+## Princípios
+- **Pequenos passos**: uma ação por turno, verificável
+- **Checkpoint sempre**: estado salvo em `.auton/checkpoints/` para resume
+- **Ferramentas primeiro**: use `ctx.tools` para ler/escrever/correr código
+- **Verificação honesta**: se não passou, explica o que falta
+
+## Ferramentas disponíveis
+- `ctx.tools.list(dir)` — lista arquivos
+- `ctx.tools.read(file)` — lê arquivo
+- `ctx.tools.write(file, content)` — escreve arquivo
+- `ctx.tools.exec(cmd)` — roda comando shell (tsc, vitest, etc.)
+- `ctx.tools.patch(file, oldStr, newStr)` — edita cirúrgico
+- `ctx.storage.get/set(key, value)` — KV persistente
+- `ctx.work.add(type, title, payload)` — work context (findings/artifacts)
+
+## Formato de resposta (JSON)
+```json
+{
+  "plan": "Uma frase: o que vou fazer agora",
+  "action": "comando ou código para ctx.tools.exec / ctx.tools.write",
+  "done": false
+}
+```
+Se `done: true`, o loop para e emite `TASK:DONE`.
+
+## Modo harness
+- `loop: true` — continua até `done: true` ou `maxTurns`
+- `maxTurns: 10` — segurança contra loops infinitos
+- `checkpointDir: ".auton/checkpoints"` — resume automático no próximo `auton run`
+
+## Exemplo
+```json
+{
+  "plan": "Ler src/auth.ts para entender a estrutura",
+  "action": "read src/auth.ts",
+  "done": false
+}
+```

package/templates/harness/harness.ts

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * Harness local — loop agêntico sem Control Plane.
+ * Roda: plan → act → verify → checkpoint → done.
+ * Checkpoints em .auton/checkpoints/ (resume no próximo run).
+ */
+import { readFile, writeFile, mkdir, readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createLlm, createStorage, createTools } from "@autonsh/runtime";
+
+const GOAL = process.env.AUTON_GOAL ?? process.argv.slice(2).join(" ") ?? "";
+const CHECKPOINT_DIR = ".auton/checkpoints";
+const MAX_TURNS = Number(process.env.AUTON_MAX_TURNS ?? 10);
+
+async function main(): Promise<void> {
+  if (!GOAL) {
+    console.error("Erro: goal não fornecido. Use AUTON_GOAL ou passe como argumento.");
+    process.exit(1);
+  }
+
+  // Carrega agent.md como system prompt base
+  const agentMd = await readFile("agent.md", "utf8").catch(() => "");
+  const systemPrompt = `Você é um agente autônomo em modo harness (local).
+${agentMd}
+
+Objetivo: ${GOAL}
+
+Loop: planeje → execute → verifique → checkpoint.
+Responda em JSON: { "plan": "...", "action": "...", "done": false }`;
+
+  const llm = createLlm({ model: process.env.AUTON_MODEL });
+  const storage = createStorage({ dir: ".auton/storage" });
+  const tools = createTools({ cwd: process.cwd() });
+
+  // Resume checkpoint se existir
+  let turn = 0;
+  let context = "";
+  const checkpoints = await listCheckpoints();
+  if (checkpoints.length > 0) {
+    const latest = checkpoints[checkpoints.length - 1];
+    const data = JSON.parse(await readFile(latest, "utf8"));
+    turn = data.turn ?? 0;
+    context = data.context ?? "";
+    console.log(`[harness] Resumindo checkpoint turno ${turn}`);
+  }
+
+  console.log(`[harness] Iniciando: ${GOAL}`);
+
+  while (turn < MAX_TURNS) {
+    turn++;
+    console.log(`[harness] Turno ${turn}/${MAX_TURNS}`);
+
+    // 1. PLAN
+    const planResp = await llm.chat({
+      system: systemPrompt + `\n\nContexto anterior:\n${context}`,
+      prompt: "Planeje o próximo passo. Responda JSON: { plan, action, done }",
+    });
+
+    let parsed: { plan: string; action: string; done: boolean };
+    try {
+      parsed = JSON.parse(planResp.trim());
+    } catch {
+      parsed = { plan: planResp, action: "", done: false };
+    }
+
+    console.log(`[harness] Plan: ${parsed.plan}`);
+    if (parsed.done) {
+      console.log("[harness] Task concluída pelo agente");
+      break;
+    }
+
+    // 2. ACT (executa action via tools se houver, senão LLM)
+    let result: string;
+    if (parsed.action) {
+      try {
+        result = await tools.exec(parsed.action);
+        console.log(`[harness] Action executada`);
+      } catch (e) {
+        result = `Erro ao executar action: ${(e as Error).message}`;
+        console.log(`[harness] ${result}`);
+      }
+    } else {
+      const actResp = await llm.chat({
+        system: systemPrompt + `\n\nContexto:\n${context}`,
+        prompt: `Execute: ${parsed.plan}`,
+      });
+      result = actResp;
+      console.log(`[harness] LLM executou diretamente`);
+    }
+
+    // 3. VERIFY
+    const verifyResp = await llm.chat({
+      system: "Verifique se o resultado atende o objetivo. Responda JSON: { pass: boolean, feedback: string }",
+      prompt: `Objetivo: ${GOAL}\nResultado: ${result}`,
+    });
+
+    let verified: { pass: boolean; feedback: string };
+    try {
+      verified = JSON.parse(verifyResp.trim());
+    } catch {
+      verified = { pass: verifyResp.toLowerCase().includes("sim"), feedback: verifyResp };
+    }
+
+    console.log(`[harness] Verify: ${verified.pass ? "PASS" : "FAIL"} - ${verified.feedback}`);
+
+    // 4. CHECKPOINT
+    context += `\nTurno ${turn}:\nPlan: ${parsed.plan}\nResult: ${result}\nVerify: ${verified.feedback}\n`;
+    await saveCheckpoint(turn, context, result, verified.pass);
+
+    if (verified.pass) {
+      console.log("[harness] Verificação passou - task concluída");
+      break;
+    }
+
+    // Continua loop com feedback
+    context += `Feedback: ${verified.feedback}\n`;
+  }
+
+  // Salva resultado final
+  await storage.set("harness:result", { goal: GOAL, turns: turn, context, finalOutput: context });
+  console.log("[TASK:DONE]", JSON.stringify({ result: context, evidence: { turns: turn } }));
+}
+
+async function listCheckpoints(): Promise<string[]> {
+  try {
+    const files = await readdir(CHECKPOINT_DIR);
+    return files
+      .filter((f) => f.endsWith(".json"))
+      .map((f) => join(CHECKPOINT_DIR, f))
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+async function saveCheckpoint(turn: number, context: string, result: string, pass: boolean): Promise<void> {
+  await mkdir(CHECKPOINT_DIR, { recursive: true });
+  const file = join(CHECKPOINT_DIR, `turn-${turn}-${Date.now()}.json`);
+  await writeFile(file, JSON.stringify({ turn, context, result, pass, timestamp: Date.now() }, null, 2));
+}
+
+main().catch((e) => {
+  console.error("[harness] Erro fatal:", e);
+  process.exit(1);
+});