@gaberrb/polypus 0.3.0 → 0.4.0

package/dist/index.js

@@ -2,8 +2,7 @@
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { createRequire } from "module";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 
 // src/cli/commands/add-agent.ts
 import pc from "picocolors";
@@ -74,11 +73,13 @@ var en = {
   "cli.description": "Agentic coding harness that makes any AI API generate and apply code \u2014 OpenRouter, Ollama, and any OpenAI-compatible endpoint.",
   "cli.opt.lang": "interface language: pt-BR | en",
   "cli.cmd.setup": "Interactive setup wizard (configure agents, keys, permissions)",
+  "cli.cmd.init": "Scaffold a .poly/ workspace (agents.md, skills, SDD spec template, README)",
+  "cli.opt.force": "overwrite files that already exist",
   "cli.cmd.addAgent": "Register a new agent (API key + model)",
   "cli.cmd.removeAgent": "Remove a configured agent",
   "cli.cmd.listAgents": "List configured agents",
   "cli.cmd.run": "Run a coding task with an agent",
-  "cli.cmd.swarm": "Split a task across multiple agents working in parallel git worktrees",
+  "cli.cmd.swarm": "Split a task across multiple agents working in parallel git worktrees (requires 3+ configured agents)",
   "cli.cmd.models": "Browse OpenRouter models (price, context, tool support)",
   "cli.cmd.prd": "Generate a PRD from a GitHub issue (uses a free OpenRouter model)",
   "cli.arg.prdIssue": "issue number to turn into a PRD",
@@ -164,6 +165,7 @@ var en = {
   ].join("\n"),
   // swarm
   "swarm.noAgents": "No agents configured. Run `polypus setup` or `polypus add-agent` first.",
+  "swarm.needsAgents": "Swarm mode needs at least {min} configured agents (you have {have}). Add more with `polypus add-agent`, or use `polypus run` for a single agent.",
   "swarm.status": "swarm agents=[{agents}] workspace={workspace}",
   "swarm.bypassNote": "Workers run in bypass mode inside isolated git worktrees; branches are merged at the end.",
   "swarm.decomposed": "Decomposed into {n} subtask(s):",
@@ -189,6 +191,12 @@ var en = {
   "swarm.conflictsHeader": "\u26A0 {n} branch(es) had merge conflicts (kept for inspection):",
   "swarm.statusDone": "done",
   "swarm.statusIncomplete": "incomplete",
+  // init
+  "init.created": "\u2713 .poly scaffolded:",
+  "init.skipped": "Kept (already existed):",
+  "init.allExist": "Nothing to do \u2014 .poly already has these files:",
+  "init.forceHint": "Run `polypus init --force` to overwrite them.",
+  "init.tip": "Tip: edit .poly/agents.md \u2014 Polypus loads it into the agent's context automatically.",
   // wizard
   "wizard.title": " polypus setup ",
   "wizard.intro": [
@@ -274,7 +282,8 @@ var en = {
   "welcome.hints": "Type your task and press Enter  \xB7  ESC cancels  \xB7  /help  \xB7  /exit",
   "welcome.firstRun": "No agents configured yet \u2014 let's set you up.",
   // agent system prompt
-  "prompt.language": "Communicate with the user in {language}."
+  "prompt.language": "Communicate with the user in {language}.",
+  "prompt.projectInstructions": "Project-specific operating instructions follow, loaded from `.poly/agents.md`. Treat them as authoritative for how to work in THIS repo. Paths they reference (e.g. skills/*.md, ../context.md, ../rules.md) are relative to the `.poly/` directory \u2014 read those files when relevant before acting:"
 };
 var ptBR = {
   "common.default": "padr\xE3o",
@@ -283,11 +292,13 @@ var ptBR = {
   "cli.description": "Harness ag\xEAntico que faz qualquer API de IA gerar e aplicar c\xF3digo \u2014 OpenRouter, Ollama e qualquer endpoint compat\xEDvel com OpenAI.",
   "cli.opt.lang": "idioma da interface: pt-BR | en",
   "cli.cmd.setup": "Assistente de configura\xE7\xE3o interativo (agentes, chaves, permiss\xF5es)",
+  "cli.cmd.init": "Cria um workspace .poly/ (agents.md, skills, template de spec SDD, README)",
+  "cli.opt.force": "sobrescreve arquivos que j\xE1 existem",
   "cli.cmd.addAgent": "Cadastra um novo agente (chave de API + modelo)",
   "cli.cmd.removeAgent": "Remove um agente configurado",
   "cli.cmd.listAgents": "Lista os agentes configurados",
   "cli.cmd.run": "Executa uma tarefa de c\xF3digo com um agente",
-  "cli.cmd.swarm": "Divide uma tarefa entre v\xE1rios agentes trabalhando em paralelo em git worktrees",
+  "cli.cmd.swarm": "Divide uma tarefa entre v\xE1rios agentes em git worktrees paralelas (requer 3+ agentes configurados)",
   "cli.cmd.models": "Explora os modelos do OpenRouter (pre\xE7o, contexto, suporte a tools)",
   "cli.cmd.prd": "Gera um PRD a partir de uma issue do GitHub (usa um modelo gratuito do OpenRouter)",
   "cli.arg.prdIssue": "n\xFAmero da issue para transformar em PRD",
@@ -369,6 +380,7 @@ var ptBR = {
     "Qualquer outra coisa \xE9 enviada ao agente como tarefa."
   ].join("\n"),
   "swarm.noAgents": "Nenhum agente configurado. Rode `polypus setup` ou `polypus add-agent` primeiro.",
+  "swarm.needsAgents": "O modo swarm precisa de pelo menos {min} agentes configurados (voc\xEA tem {have}). Adicione mais com `polypus add-agent`, ou use `polypus run` para um agente s\xF3.",
   "swarm.status": "swarm agentes=[{agents}] workspace={workspace}",
   "swarm.bypassNote": "Os workers rodam em modo bypass dentro de git worktrees isoladas; os branches s\xE3o mesclados no final.",
   "swarm.decomposed": "Dividido em {n} subtarefa(s):",
@@ -394,6 +406,12 @@ var ptBR = {
   "swarm.conflictsHeader": "\u26A0 {n} branch(es) tiveram conflitos de merge (mantidos para inspe\xE7\xE3o):",
   "swarm.statusDone": "ok",
   "swarm.statusIncomplete": "incompleta",
+  // init
+  "init.created": "\u2713 .poly criado:",
+  "init.skipped": "Mantidos (j\xE1 existiam):",
+  "init.allExist": "Nada a fazer \u2014 o .poly j\xE1 tem estes arquivos:",
+  "init.forceHint": "Rode `polypus init --force` para sobrescrev\xEA-los.",
+  "init.tip": "Dica: edite o .poly/agents.md \u2014 o Polypus carrega ele no contexto do agente automaticamente.",
   "wizard.title": " configura\xE7\xE3o do polypus ",
   "wizard.intro": [
     "O Polypus comanda qualquer API de IA para ler e escrever c\xF3digo neste tipo de projeto.",
@@ -455,6 +473,7 @@ var ptBR = {
   "wizard.envInvalid": "Use letras, d\xEDgitos e sublinhados",
   "wizard.keyPrompt": "Chave de API (armazenada em texto puro no arquivo de config)",
   "prompt.language": "Comunique-se com o usu\xE1rio em {language}.",
+  "prompt.projectInstructions": "Seguem instru\xE7\xF5es operacionais espec\xEDficas do projeto, carregadas de `.poly/agents.md`. Trate-as como autoritativas para trabalhar NESTE reposit\xF3rio. Os caminhos que elas citam (ex.: skills/*.md, ../context.md, ../rules.md) s\xE3o relativos \xE0 pasta `.poly/` \u2014 leia esses arquivos quando relevante antes de agir:",
   "models.fetching": "Buscando modelos do OpenRouter\u2026",
   "models.fetchError": "N\xE3o foi poss\xEDvel buscar modelos: {msg}",
   "models.none": "Nenhum modelo corresponde aos filtros.",
@@ -1025,6 +1044,10 @@ function basePreamble(ctx) {
     "- Do not ask for permission and do not say you cannot edit files \u2014 you can. Just emit the tool calls.",
     "- Make the changes directly. When the task is fully done, call the `finish` tool with a short summary.",
     t("prompt.language", { language: LOCALE_NAMES[getLocale()] }),
+    ctx.projectInstructions ? `
+${t("prompt.projectInstructions")}
+
+${ctx.projectInstructions}` : "",
     ctx.briefing ? `
 Your assigned task:
 ${ctx.briefing}` : ""
@@ -1668,6 +1691,23 @@ function formatSchema(spec) {
   return lines.join("\n") || "  (no parameters)";
 }
 
+// src/core/agent/project-context.ts
+import { readFile as readFile5 } from "fs/promises";
+import { join as join2 } from "path";
+var INSTRUCTION_FILES = [join2(".poly", "agents.md"), "AGENTS.md"];
+var MAX_CHARS2 = 8e3;
+async function loadProjectInstructions(workspace) {
+  for (const rel of INSTRUCTION_FILES) {
+    try {
+      const raw = (await readFile5(join2(workspace, rel), "utf8")).trim();
+      if (!raw) continue;
+      return raw.length > MAX_CHARS2 ? raw.slice(0, MAX_CHARS2) + "\n\u2026(truncated)" : raw;
+    } catch {
+    }
+  }
+  return void 0;
+}
+
 // src/core/agent/loop.ts
 function looksLikeStall(text2) {
   const lc = text2.toLowerCase();
@@ -1710,10 +1750,12 @@ async function runAgent(opts) {
   const maxReprompts = opts.maxReprompts ?? 3;
   const driver = makeDriver(agent.toolMode, toolSpecs());
   const ctx = { workspace: opts.workspace, permissions };
-  const messages = opts.history && opts.history.length > 0 ? [...opts.history, { role: "user", content: opts.task }] : [
-    { role: "system", content: driver.systemPrompt(opts.promptContext) },
+  const seeding = !(opts.history && opts.history.length > 0);
+  const promptContext = seeding && opts.promptContext.projectInstructions === void 0 ? { ...opts.promptContext, projectInstructions: await loadProjectInstructions(opts.workspace) } : opts.promptContext;
+  const messages = seeding ? [
+    { role: "system", content: driver.systemPrompt(promptContext) },
     { role: "user", content: opts.task }
-  ];
+  ] : [...opts.history, { role: "user", content: opts.task }];
   let consecutiveNoTool = 0;
   let lastFailSig = "";
   let failStreak = 0;
@@ -2182,6 +2224,23 @@ async function promptApiKey(provider) {
 
 // src/ui/banner.ts
 import pc5 from "picocolors";
+
+// src/core/version.ts
+import { createRequire } from "module";
+function resolveVersion() {
+  const require2 = createRequire(import.meta.url);
+  for (const rel of ["../package.json", "../../package.json"]) {
+    try {
+      const version = require2(rel).version;
+      if (typeof version === "string" && version.length > 0) return version;
+    } catch {
+    }
+  }
+  return "0.0.0";
+}
+var VERSION = resolveVersion();
+
+// src/ui/banner.ts
 var RESET = "\x1B[0m";
 var useColor = (Boolean(process.stdout.isTTY) || Boolean(process.env.FORCE_COLOR)) && !process.env.NO_COLOR;
 var animated = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && !process.env.POLYPUS_NO_ANIM;
@@ -2255,7 +2314,7 @@ function colorChar(rowIdx, ch) {
 function renderArtRow(rowIdx, line) {
   return [...center(line)].map((ch) => colorChar(rowIdx, ch)).join("");
 }
-var tagline = () => c1(t("welcome.tagline")) + pc5.dim("   v0.1.0");
+var tagline = () => c1(t("welcome.tagline")) + pc5.dim(`   v${VERSION}`);
 function authorLine() {
   return pc5.dim("by ") + c2(AUTHOR.name) + pc5.dim("  \xB7  ") + c1(AUTHOR.github) + pc5.dim("  \xB7  ") + c1(AUTHOR.linkedin);
 }
@@ -2678,13 +2737,302 @@ async function setup() {
   await runWizard();
 }
 
-// src/cli/commands/swarm.ts
+// src/cli/commands/init.ts
 import pc8 from "picocolors";
 
+// src/core/scaffold/init.ts
+import { mkdir as mkdir3, writeFile as writeFile4, access } from "fs/promises";
+import { dirname as dirname3, join as join3 } from "path";
+
+// src/core/scaffold/templates.ts
+function polyTemplates(locale) {
+  return locale === "pt-BR" ? PT : EN;
+}
+var EN = {
+  "agents.md": `# agents.md \u2014 how an AI agent operates this repo
+
+> Local workspace under \`.poly/\`. Conditions any AI agent (Polypus, Claude, \u2026)
+> to work the way this project expects. **Polypus loads this file automatically**
+> into the agent's system prompt on every run, so keep it accurate and lean.
+
+## Role
+
+You implement changes end to end \u2014 from understanding the task to a reviewable
+result \u2014 respecting the rules below.
+
+## Golden rules
+
+1. Green before a PR: the project builds, type-checks and tests pass.
+2. Keep docs/changelog in sync with behavior changes.
+3. Confirm before irreversible actions (publishing, deleting, force-pushing).
+4. Small, targeted changes over broad rewrites.
+
+## Skills index
+
+| Skill | When to use |
+|-------|-------------|
+| [skills/coding.md](skills/coding.md) | Technical standards for any code change |
+| [skills/spec-driven.md](skills/spec-driven.md) | Write a spec before non-trivial work |
+
+## Environment
+
+- Describe the OS, shell, package manager and any tooling the agent needs.
+- Note where credentials/CLIs live and how commands are run.
+`,
+  "README.md": `# .poly \u2014 your project's AI operating manual
+
+\`.poly/\` is a small, local workspace that teaches AI agents how to work in THIS
+repository. Gitignore it to keep it personal, or commit it to standardize the
+workflow across your team.
+
+## What's inside
+
+- **\`agents.md\`** \u2014 the entry point: role, golden rules and an index of skills.
+  Polypus loads it automatically into the agent's system prompt on every run.
+- **\`skills/\`** \u2014 focused how-to guides the agent reads when relevant.
+- **\`templates/spec.md\`** \u2014 a lean Spec-Driven Development (SDD) template.
+
+## How it works
+
+1. You describe a task to the agent.
+2. The agent reads \`agents.md\`, follows the golden rules and opens the skills it needs.
+3. For non-trivial work, it writes a spec first from \`templates/spec.md\`.
+
+## Extend it
+
+- Edit \`agents.md\` to encode your conventions.
+- Add one skill file per recurring workflow (releases, reviews, migrations\u2026).
+- Reference new skills from \`agents.md\` so the agent can discover them.
+
+Regenerate any missing files with \`polypus init\` (existing files are preserved;
+use \`--force\` to overwrite).
+`,
+  "skills/coding.md": `# skill: coding
+
+Technical standards for changes in this repo.
+
+## Principles
+
+- Match the style, naming and structure of the surrounding code.
+- Prefer small, targeted edits over broad rewrites.
+- Add or update tests with every behavior change.
+
+## Checklist before opening a PR
+
+- [ ] Builds and type-checks
+- [ ] Tests pass
+- [ ] Docs / changelog updated when behavior changed
+`,
+  "skills/spec-driven.md": `# skill: spec-driven development
+
+For anything non-trivial, write a short spec BEFORE coding.
+
+## Flow
+
+1. Copy \`templates/spec.md\` into your issue (or \`specs/<slug>.md\`).
+2. Fill **Why / What / Acceptance criteria / Out of scope**.
+3. Get a thumbs-up, then implement to the acceptance criteria.
+4. Keep the spec updated if scope changes.
+
+Lean by design: if a section is empty, delete it.
+`,
+  "templates/spec.md": `# Spec: <title>
+
+> Status: draft \xB7 Owner: <name> \xB7 Updated: <yyyy-mm-dd>
+
+## Why
+
+What problem are we solving, and for whom? Why now?
+
+## What
+
+The change in plain terms \u2014 the behavior a user will actually see.
+
+## Acceptance criteria
+
+- [ ] Observable outcome 1
+- [ ] Observable outcome 2
+
+## Out of scope
+
+- Things we are explicitly NOT doing here.
+
+## Notes / open questions
+
+- \u2026
+`
+};
+var PT = {
+  "agents.md": `# agents.md \u2014 como um agente de IA opera este reposit\xF3rio
+
+> Workspace local em \`.poly/\`. Condiciona qualquer agente de IA (Polypus, Claude\u2026)
+> a trabalhar do jeito que este projeto espera. **O Polypus carrega este arquivo
+> automaticamente** no system prompt do agente a cada execu\xE7\xE3o \u2014 mantenha-o
+> preciso e enxuto.
+
+## Papel
+
+Voc\xEA implementa mudan\xE7as de ponta a ponta \u2014 do entendimento da tarefa a um
+resultado revis\xE1vel \u2014 respeitando as regras abaixo.
+
+## Regras de ouro
+
+1. Verde antes do PR: o projeto builda, passa no type-check e nos testes.
+2. Mantenha docs/changelog em sincronia com mudan\xE7as de comportamento.
+3. Confirme antes de a\xE7\xF5es irrevers\xEDveis (publicar, deletar, force-push).
+4. Mudan\xE7as pequenas e focadas em vez de reescritas amplas.
+
+## \xCDndice de skills
+
+| Skill | Quando usar |
+|-------|-------------|
+| [skills/coding.md](skills/coding.md) | Padr\xF5es t\xE9cnicos para qualquer mudan\xE7a de c\xF3digo |
+| [skills/spec-driven.md](skills/spec-driven.md) | Escrever um spec antes de trabalho n\xE3o-trivial |
+
+## Ambiente
+
+- Descreva SO, shell, gerenciador de pacotes e ferramentas que o agente precisa.
+- Anote onde ficam credenciais/CLIs e como os comandos s\xE3o executados.
+`,
+  "README.md": `# .poly \u2014 o manual de opera\xE7\xE3o de IA do seu projeto
+
+O \`.poly/\` \xE9 um workspace local e pequeno que ensina agentes de IA a trabalhar
+NESTE reposit\xF3rio. Coloque no .gitignore para mant\xEA-lo pessoal, ou commite para
+padronizar o fluxo entre o time.
+
+## O que tem dentro
+
+- **\`agents.md\`** \u2014 o ponto de entrada: papel, regras de ouro e um \xEDndice de skills.
+  O Polypus carrega ele automaticamente no system prompt do agente a cada execu\xE7\xE3o.
+- **\`skills/\`** \u2014 guias pr\xE1ticos e focados que o agente l\xEA quando relevante.
+- **\`templates/spec.md\`** \u2014 um template enxuto de Spec-Driven Development (SDD).
+
+## Como funciona
+
+1. Voc\xEA descreve uma tarefa ao agente.
+2. O agente l\xEA o \`agents.md\`, segue as regras de ouro e abre as skills necess\xE1rias.
+3. Para trabalho n\xE3o-trivial, escreve um spec primeiro a partir de \`templates/spec.md\`.
+
+## Como estender
+
+- Edite o \`agents.md\` para codificar suas conven\xE7\xF5es.
+- Adicione um arquivo de skill por fluxo recorrente (releases, reviews, migra\xE7\xF5es\u2026).
+- Referencie as novas skills no \`agents.md\` para o agente descobri-las.
+
+Regenere arquivos que faltarem com \`polypus init\` (os existentes s\xE3o preservados;
+use \`--force\` para sobrescrever).
+`,
+  "skills/coding.md": `# skill: coding
+
+Padr\xF5es t\xE9cnicos para mudan\xE7as neste reposit\xF3rio.
+
+## Princ\xEDpios
+
+- Siga o estilo, a nomenclatura e a estrutura do c\xF3digo ao redor.
+- Prefira edi\xE7\xF5es pequenas e focadas a reescritas amplas.
+- Adicione ou atualize testes a cada mudan\xE7a de comportamento.
+
+## Checklist antes de abrir um PR
+
+- [ ] Builda e passa no type-check
+- [ ] Testes passam
+- [ ] Docs / changelog atualizados quando o comportamento mudou
+`,
+  "skills/spec-driven.md": `# skill: spec-driven development
+
+Para qualquer coisa n\xE3o-trivial, escreva um spec curto ANTES de codar.
+
+## Fluxo
+
+1. Copie \`templates/spec.md\` para a issue (ou \`specs/<slug>.md\`).
+2. Preencha **Por qu\xEA / O qu\xEA / Crit\xE9rios de aceite / Fora de escopo**.
+3. Valide com um "ok", ent\xE3o implemente at\xE9 os crit\xE9rios de aceite.
+4. Mantenha o spec atualizado se o escopo mudar.
+
+Enxuto por design: se uma se\xE7\xE3o ficar vazia, apague-a.
+`,
+  "templates/spec.md": `# Spec: <t\xEDtulo>
+
+> Status: rascunho \xB7 Dono: <nome> \xB7 Atualizado: <aaaa-mm-dd>
+
+## Por qu\xEA
+
+Que problema estamos resolvendo, e para quem? Por que agora?
+
+## O qu\xEA
+
+A mudan\xE7a em termos simples \u2014 o comportamento que o usu\xE1rio vai realmente ver.
+
+## Crit\xE9rios de aceite
+
+- [ ] Resultado observ\xE1vel 1
+- [ ] Resultado observ\xE1vel 2
+
+## Fora de escopo
+
+- Coisas que explicitamente N\xC3O faremos aqui.
+
+## Notas / d\xFAvidas em aberto
+
+- \u2026
+`
+};
+
+// src/core/scaffold/init.ts
+async function scaffoldPoly(workspace, opts) {
+  const templates = polyTemplates(opts.locale);
+  const created = [];
+  const skipped = [];
+  for (const [rel, content] of Object.entries(templates)) {
+    const display = `.poly/${rel}`;
+    const abs = join3(workspace, ".poly", ...rel.split("/"));
+    if (!opts.force && await exists(abs)) {
+      skipped.push(display);
+      continue;
+    }
+    await mkdir3(dirname3(abs), { recursive: true });
+    await writeFile4(abs, content, "utf8");
+    created.push(display);
+  }
+  return { created, skipped };
+}
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/cli/commands/init.ts
+async function init(opts) {
+  const { created, skipped } = await scaffoldPoly(process.cwd(), {
+    force: Boolean(opts.force),
+    locale: getLocale()
+  });
+  if (created.length === 0) {
+    console.log(pc8.yellow(t("init.allExist")));
+    for (const f of skipped) console.log(pc8.dim(`  ${f}`));
+    console.log(pc8.dim(t("init.forceHint")));
+    return;
+  }
+  console.log(pc8.green(t("init.created")));
+  for (const f of created) console.log(pc8.dim(`  ${f}`));
+  if (skipped.length > 0) {
+    console.log(pc8.dim(t("init.skipped")));
+    for (const f of skipped) console.log(pc8.dim(`  ${f}`));
+  }
+  console.log("\n" + t("init.tip"));
+}
+
+// src/cli/commands/swarm.ts
+import pc9 from "picocolors";
+
 // src/core/git/worktree.ts
 import { mkdtemp } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 import { simpleGit } from "simple-git";
 async function ensureRepo(workspace) {
   const git = simpleGit(workspace);
@@ -2705,7 +3053,7 @@ async function identityArgs(git) {
 }
 async function createWorktree(git, label) {
   const branch = `polypus/${label}-${Date.now().toString(36)}`;
-  const path = await mkdtemp(join2(tmpdir(), "polypus-wt-"));
+  const path = await mkdtemp(join4(tmpdir(), "polypus-wt-"));
   await git.raw(["worktree", "add", "-b", branch, path, "HEAD"]);
   return { path, branch };
 }
@@ -3017,8 +3365,15 @@ function pad(s, n) {
 }
 
 // src/cli/commands/swarm.ts
+var MIN_SWARM_AGENTS = 3;
+function canSwarm(agentCount) {
+  return agentCount >= MIN_SWARM_AGENTS;
+}
 async function swarm(task, opts) {
   const config = await loadConfig();
+  if (!canSwarm(config.agents.length)) {
+    throw new Error(t("swarm.needsAgents", { min: MIN_SWARM_AGENTS, have: config.agents.length }));
+  }
   const selected = opts.agents ? opts.agents.split(",").map((s) => s.trim()).filter(Boolean) : config.agents.map((a) => a.name);
   if (selected.length === 0) {
     throw new Error(t("swarm.noAgents"));
@@ -3029,9 +3384,9 @@ async function swarm(task, opts) {
     return createProvider(a);
   });
   console.log(
-    pc8.dim(t("swarm.status", { agents: resolved.map((a) => a.config.name).join(", "), workspace: process.cwd() }))
+    pc9.dim(t("swarm.status", { agents: resolved.map((a) => a.config.name).join(", "), workspace: process.cwd() }))
   );
-  console.log(pc8.yellow(t("swarm.bypassNote") + "\n"));
+  console.log(pc9.yellow(t("swarm.bypassNote") + "\n"));
   const view = new SwarmView(resolved[0].config.name);
   view.start();
   let result;
@@ -3058,25 +3413,25 @@ async function swarm(task, opts) {
     view.stop();
   }
   console.log("");
-  console.log(pc8.bold("\n" + t("swarm.summary")));
+  console.log(pc9.bold("\n" + t("swarm.summary")));
   for (const o of result.outcomes) {
-    const status = o.finished ? pc8.green(t("swarm.statusDone")) : pc8.yellow(t("swarm.statusIncomplete"));
-    const committed = o.committed ? "" : pc8.dim(` (${t("swarm.noChanges")})`);
-    console.log(`  ${pc8.bold(o.subtask.id)} [${o.agentName}] ${status}${committed} \u2014 ${o.subtask.title}`);
+    const status = o.finished ? pc9.green(t("swarm.statusDone")) : pc9.yellow(t("swarm.statusIncomplete"));
+    const committed = o.committed ? "" : pc9.dim(` (${t("swarm.noChanges")})`);
+    console.log(`  ${pc9.bold(o.subtask.id)} [${o.agentName}] ${status}${committed} \u2014 ${o.subtask.title}`);
   }
   const conflicts = result.merges.filter((m) => !m.ok);
   if (conflicts.length > 0) {
-    console.log(pc8.red("\n" + t("swarm.conflictsHeader", { n: conflicts.length })));
+    console.log(pc9.red("\n" + t("swarm.conflictsHeader", { n: conflicts.length })));
     for (const m of conflicts) {
-      console.log(pc8.red(`  ${m.branch}: ${m.conflicts.join(", ")}`));
+      console.log(pc9.red(`  ${m.branch}: ${m.conflicts.join(", ")}`));
     }
   } else {
-    console.log(pc8.green("\n" + t("swarm.allMerged")));
+    console.log(pc9.green("\n" + t("swarm.allMerged")));
   }
 }
 
 // src/cli/commands/models.ts
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 import * as p3 from "@clack/prompts";
 async function models(opts) {
   const apiKey = await resolveOpenRouterKey();
@@ -3085,9 +3440,9 @@ async function models(opts) {
   let all;
   try {
     all = await listOpenRouterModels(apiKey);
-    spin.stop(pc9.green("\u2713 OpenRouter"));
+    spin.stop(pc10.green("\u2713 OpenRouter"));
   } catch (err) {
-    spin.stop(pc9.red(t("models.fetchError", { msg: err.message })), 2);
+    spin.stop(pc10.red(t("models.fetchError", { msg: err.message })), 2);
     return;
   }
   const filtered = filterModels(all, {
@@ -3101,26 +3456,26 @@ async function models(opts) {
   printModelsTable(filtered, limit, all.length);
 }
 function printModelsTable(models2, limit, total) {
-  console.log(pc9.dim(t("models.legend")));
+  console.log(pc10.dim(t("models.legend")));
   if (models2.length === 0) {
-    console.log(pc9.yellow(t("models.none")));
+    console.log(pc10.yellow(t("models.none")));
     return;
   }
   const rows = models2.slice(0, limit);
   console.log(
-    "  " + pc9.dim(t("models.colTools").padEnd(6)) + pc9.dim(t("models.colPrice").padEnd(16)) + pc9.dim(t("models.colCtx").padEnd(9)) + pc9.dim(t("models.colModel"))
+    "  " + pc10.dim(t("models.colTools").padEnd(6)) + pc10.dim(t("models.colPrice").padEnd(16)) + pc10.dim(t("models.colCtx").padEnd(9)) + pc10.dim(t("models.colModel"))
   );
   for (const m of rows) {
     console.log("  " + modelRow(m));
   }
-  console.log(pc9.dim("\n" + t("models.shown", { shown: rows.length, total })));
+  console.log(pc10.dim("\n" + t("models.shown", { shown: rows.length, total })));
 }
 function modelRow(m) {
-  const tools = m.supportsTools ? pc9.green("\u{1F6E0}".padEnd(5)) : pc9.dim("\u2014".padEnd(5));
+  const tools = m.supportsTools ? pc10.green("\u{1F6E0}".padEnd(5)) : pc10.dim("\u2014".padEnd(5));
   const price = `${fmtPrice(m.promptPrice)}/${fmtPrice(m.completionPrice)}`;
-  const priceColored = (m.free ? pc9.green : pc9.yellow)(price.padEnd(16));
-  const ctx = pc9.cyan(fmtContext(m.contextLength).padEnd(9));
-  return `${tools} ${priceColored}${ctx}${pc9.bold(m.id)}`;
+  const priceColored = (m.free ? pc10.green : pc10.yellow)(price.padEnd(16));
+  const ctx = pc10.cyan(fmtContext(m.contextLength).padEnd(9));
+  return `${tools} ${priceColored}${ctx}${pc10.bold(m.id)}`;
 }
 async function resolveOpenRouterKey() {
   if (process.env.OPENROUTER_API_KEY) return process.env.OPENROUTER_API_KEY;
@@ -3134,10 +3489,10 @@ async function resolveOpenRouterKey() {
 }
 
 // src/cli/commands/prd.ts
-import { writeFile as writeFile4, readFile as readFile5 } from "fs/promises";
+import { writeFile as writeFile5, readFile as readFile6 } from "fs/promises";
 import { execFile } from "child_process";
 import { promisify as promisify2 } from "util";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 
 // src/core/agent/prd.ts
 var SYSTEM = [
@@ -3265,15 +3620,15 @@ async function prd(issueRef, opts) {
   const guide = readProjectGuide(["context.md"]);
   const markdown = await withRetry(() => generatePrd(issue, provider, guide));
   if (opts.out) {
-    await writeFile4(opts.out, markdown + "\n", "utf8");
-    console.error(pc10.green(t("prd.wrote", { path: opts.out })));
+    await writeFile5(opts.out, markdown + "\n", "utf8");
+    console.error(pc11.green(t("prd.wrote", { path: opts.out })));
   } else {
     process.stdout.write(markdown + "\n");
   }
 }
 async function loadIssue(issueRef, input) {
   if (input) {
-    const raw = input === "-" ? await readStdin() : await readFile5(input, "utf8");
+    const raw = input === "-" ? await readStdin() : await readFile6(input, "utf8");
     return normalize2(JSON.parse(stripBom(raw)));
   }
   const num = numericRef(issueRef);
@@ -3292,10 +3647,10 @@ function normalize2(raw) {
 }
 
 // src/cli/commands/review.ts
-import { writeFile as writeFile5, readFile as readFile6 } from "fs/promises";
+import { writeFile as writeFile6, readFile as readFile7 } from "fs/promises";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify3 } from "util";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 
 // src/core/agent/review.ts
 var MAX_DIFF_CHARS = Number(process.env.POLYPUS_MAX_DIFF_CHARS) || 6e4;
@@ -3361,14 +3716,14 @@ async function review(prRef, opts) {
   const guide = readProjectGuide(["rules.md", "context.md"]);
   const markdown = await withRetry(() => reviewDiff(diff, meta, provider, guide));
   if (opts.out) {
-    await writeFile5(opts.out, markdown + "\n", "utf8");
-    console.error(pc11.green(t("review.wrote", { path: opts.out })));
+    await writeFile6(opts.out, markdown + "\n", "utf8");
+    console.error(pc12.green(t("review.wrote", { path: opts.out })));
   } else {
     process.stdout.write(markdown + "\n");
   }
 }
 async function loadDiff(num, input) {
-  if (input) return input === "-" ? readStdin() : readFile6(input, "utf8");
+  if (input) return input === "-" ? readStdin() : readFile7(input, "utf8");
   const { stdout: stdout2 } = await exec3("gh", ["pr", "diff", num]);
   return stdout2;
 }
@@ -3380,7 +3735,7 @@ async function loadMeta(num, input) {
 }
 
 // src/cli/index.ts
-import { join as join3 } from "path";
+import { join as join5 } from "path";
 
 // src/core/config/dotenv.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
@@ -3409,12 +3764,11 @@ function loadDotenv(paths) {
 }
 
 // src/cli/index.ts
-var { version: pkgVersion } = createRequire(import.meta.url)("../package.json");
 async function launchInteractive() {
   const config = await loadConfig();
   if (config.agents.length === 0) {
     console.log(banner());
-    console.log("  " + pc12.yellow(t("welcome.firstRun")) + "\n");
+    console.log("  " + pc13.yellow(t("welcome.firstRun")) + "\n");
     await setup();
   }
   await run(void 0, {});
@@ -3435,8 +3789,9 @@ async function resolveLocale() {
 }
 function buildProgram() {
   const program = new Command();
-  program.name("polypus").description(t("cli.description")).version(pkgVersion).option("--lang <locale>", t("cli.opt.lang")).action(() => launchInteractive());
+  program.name("polypus").description(t("cli.description")).version(VERSION).option("--lang <locale>", t("cli.opt.lang")).action(() => launchInteractive());
   program.command("setup").description(t("cli.cmd.setup")).action(() => setup());
+  program.command("init").option("--force", t("cli.opt.force")).description(t("cli.cmd.init")).action((opts) => init(opts));
   program.command("add-agent").argument("<name>", t("cli.arg.addAgentName")).requiredOption("--provider <provider>", t("cli.opt.provider")).requiredOption("--model <model>", t("cli.opt.model")).option("--api-key <key>", t("cli.opt.apiKey")).option("--base-url <url>", t("cli.opt.baseUrl")).option("--tool-mode <mode>", t("cli.opt.toolMode"), "auto").option("--set-default", t("cli.opt.setDefault")).description(t("cli.cmd.addAgent")).action((name, opts) => addAgent(name, opts));
   program.command("remove-agent").argument("<name>", t("cli.arg.removeAgentName")).description(t("cli.cmd.removeAgent")).action((name) => removeAgent(name));
   program.command("list-agents").alias("agents").description(t("cli.cmd.listAgents")).action(() => listAgents());
@@ -3449,11 +3804,11 @@ function buildProgram() {
 }
 async function main() {
   try {
-    loadDotenv([join3(configDir(), ".env"), join3(process.cwd(), ".env")]);
+    loadDotenv([join5(configDir(), ".env"), join5(process.cwd(), ".env")]);
     await resolveLocale();
     await buildProgram().parseAsync(process.argv);
   } catch (err) {
-    console.error(pc12.red(`\u2717 ${err.message}`));
+    console.error(pc13.red(`\u2717 ${err.message}`));
     process.exitCode = 1;
   }
 }