@reverso-agent/cli 0.2.6 → 0.3.0

package/README.md

@@ -4,6 +4,8 @@ CLI do agente investigativo Reverso — OSINT com LLM. Processa documentos, gera
 
 ## Instalação
 
+**Recomendado — instalação global** (evita conflitos com dependências do projeto):
+
 ```bash
 # npm
 npm install -g @reverso-agent/cli
@@ -12,6 +14,14 @@ npm install -g @reverso-agent/cli
 pnpm add -g @reverso-agent/cli
 ```
 
+Para usar como dependência local do projeto, use `--ignore-scripts` (a dependência `yargs` pode falhar em scripts de build em alguns ambientes):
+
+```bash
+npm i @reverso-agent/cli --ignore-scripts
+# ou
+pnpm add @reverso-agent/cli --ignore-scripts
+```
+
 Requisitos: Node.js >= 18.
 
 Verificar:

package/dist/index.js

@@ -4315,7 +4315,7 @@ async function detectFilesystemRoot(cwd) {
   }
   await ensureFilesystemDirs(cwd);
   console.log(
-    `Nenhuma estrutura de investiga\xE7\xE3o encontrada em ${cwd}. Estrutura inicial criada. Adicione PDFs em ${path.join(cwd, "source")}.`
+    `No investigation structure found in ${cwd}. Initial structure created. Add PDFs to ${path.join(cwd, "source")}.`
   );
   return {
     filesystemRoot: cwd,
@@ -4472,7 +4472,7 @@ async function resolveRuntimeConfig(opts) {
   const apiKey = process.env.OPENROUTER_API_KEY;
   if (!apiKey) {
     throw new Error(
-      "OPENROUTER_API_KEY nao encontrado. Configure no shell, ~/.reverso/.env, ./.env ou ./.env.local."
+      "OPENROUTER_API_KEY not found. Set it in your shell, ~/.reverso/.env, ./.env or ./.env.local."
     );
   }
   const model = opts?.model ?? process.env.AGENT_LAB_MODEL ?? "google/gemini-2.5-flash";
@@ -4972,7 +4972,7 @@ var OpenRouterClient = class {
           const rawBody = await response.text();
           const json = rawBody ? JSON.parse(rawBody) : {};
           const message = json?.error?.message ?? `HTTP ${response.status}`;
-          throw new Error(`Falha OpenRouter: ${message}`);
+          throw new Error(`OpenRouter request failed: ${message}`);
         }
         const reader = response.body?.getReader();
         if (!reader) throw new Error("Response body is not readable");
@@ -5017,7 +5017,7 @@ var OpenRouterClient = class {
         clearTimeout(timeout);
         return stripCodeFence(fullContent.trim());
       } catch (error2) {
-        lastError = error2 instanceof Error ? error2.name === "AbortError" ? new Error("Timeout ao chamar OpenRouter.") : error2 : new Error(String(error2));
+        lastError = error2 instanceof Error ? error2.name === "AbortError" ? new Error("OpenRouter request timed out.") : error2 : new Error(String(error2));
         if (attempt < 3) {
           await sleep(700 * attempt);
         }
@@ -5025,7 +5025,7 @@ var OpenRouterClient = class {
         clearTimeout(timeout);
       }
     }
-    throw lastError ?? new Error("Falha desconhecida no OpenRouter.");
+    throw lastError ?? new Error("Unknown OpenRouter failure.");
   }
   async chatJson(request, fallback) {
     const content = await this.chatText(request);
@@ -5161,26 +5161,26 @@ var CliUiFeedback = class {
       ...errorCode ? { errorCode } : {}
     });
   }
-  fileCreated(path37, addedLines, preview) {
+  fileCreated(path39, addedLines, preview) {
     this.bus.emit({
       type: "file_change",
-      path: path37,
+      path: path39,
       changeType: "new",
       ...addedLines !== void 0 ? { addedLines } : {},
       ...preview ? { preview } : {}
     });
   }
-  fileEdited(path37, addedLines, removedLines) {
+  fileEdited(path39, addedLines, removedLines) {
     this.bus.emit({
       type: "file_change",
-      path: path37,
+      path: path39,
       changeType: "edited",
       ...addedLines !== void 0 ? { addedLines } : {},
       ...removedLines !== void 0 ? { removedLines } : {}
     });
   }
-  fileDeleted(path37) {
-    this.bus.emit({ type: "file_change", path: path37, changeType: "deleted" });
+  fileDeleted(path39) {
+    this.bus.emit({ type: "file_change", path: path39, changeType: "deleted" });
   }
   requestApproval(_requestId, title, description) {
     this.bus.emit({
@@ -5567,19 +5567,19 @@ ${p.content}`
 // src/commands/init.ts
 var initCommand = {
   command: "init",
-  describe: "Gera entendimento inicial da investigacao",
+  describe: "Generate initial understanding of the investigation",
   builder: (yargs2) => yargs2.option("max-tokens", {
     type: "number",
-    describe: "Limite de tokens a consumir"
+    describe: "Token consumption limit"
   }).option("model", {
     type: "string",
-    describe: "Modelo LLM"
+    describe: "LLM model"
   }).option("response-language", {
     type: "string",
-    describe: "Idioma de resposta (auto|en|pt|es|fr|de|it)"
+    describe: "Response language (auto|en|pt|es|fr|de|it)"
   }).option("artifact-language", {
     type: "string",
-    describe: "Idioma dos artefatos (source|en|pt|es|fr|de|it)"
+    describe: "Artifact language (source|en|pt|es|fr|de|it)"
   }),
   handler: async (argv) => {
     await runInit({
@@ -7200,19 +7200,19 @@ async function requestStrictDigPayload(input) {
 var digCommand = {
   command: "dig",
   aliases: ["deep-dive"],
-  describe: "Executa deep-dive nas fontes",
-  builder: (yargs2) => yargs2.option("model", { type: "string", describe: "Modelo LLM" }).option("response-language", {
+  describe: "Run deep-dive on sources",
+  builder: (yargs2) => yargs2.option("model", { type: "string", describe: "LLM model" }).option("response-language", {
     type: "string",
-    describe: "Idioma de resposta (auto|en|pt|es|fr|de|it)"
+    describe: "Response language (auto|en|pt|es|fr|de|it)"
   }).option("pev", {
     type: "boolean",
-    describe: "Ativa fluxo plan -> execute -> verify"
+    describe: "Enable plan -> execute -> verify flow"
   }).option("self-repair", {
     type: "boolean",
-    describe: "Ativa auto-reparo de contratos JSON"
+    describe: "Enable JSON contract auto-repair"
   }).option("self-repair-max-rounds", {
     type: "number",
-    describe: "Maximo de rodadas de auto-reparo"
+    describe: "Maximum auto-repair rounds"
   }),
   handler: async (argv) => {
     await runDig({
@@ -7579,19 +7579,19 @@ ${lines.join("\n")}${suffix}`;
 // src/commands/create-lead.ts
 var createLeadCommand = {
   command: "create-lead",
-  describe: "Cria lead de investigacao com inquiry plan",
-  builder: (yargs2) => yargs2.option("idea", { type: "string", describe: "Ideia inicial para o lead" }).option("model", { type: "string", describe: "Modelo LLM" }).option("response-language", {
+  describe: "Create investigation lead with inquiry plan",
+  builder: (yargs2) => yargs2.option("idea", { type: "string", describe: "Initial idea for the lead" }).option("model", { type: "string", describe: "LLM model" }).option("response-language", {
     type: "string",
-    describe: "Idioma de resposta (auto|en|pt|es|fr|de|it)"
+    describe: "Response language (auto|en|pt|es|fr|de|it)"
   }).option("pev", {
     type: "boolean",
-    describe: "Ativa fluxo plan -> execute -> verify"
+    describe: "Enable plan -> execute -> verify flow"
   }).option("self-repair", {
     type: "boolean",
-    describe: "Ativa auto-reparo de contratos JSON"
+    describe: "Enable JSON contract auto-repair"
   }).option("self-repair-max-rounds", {
     type: "number",
-    describe: "Maximo de rodadas de auto-reparo"
+    describe: "Maximum auto-repair rounds"
   }),
   handler: async (argv) => {
     await runCreateLead({
@@ -19456,14 +19456,14 @@ var parameters = /* @__PURE__ */ new Map([
   ["Z", 0],
   ["z", 0]
 ]);
-var parse = function(path37) {
+var parse = function(path39) {
   var cmd;
   var ret = [];
   var args = [];
   var curArg = "";
   var foundDecimal = false;
   var params = 0;
-  for (var _i = 0, path_1 = path37; _i < path_1.length; _i++) {
+  for (var _i = 0, path_1 = path39; _i < path_1.length; _i++) {
     var c = path_1[_i];
     if (parameters.has(c)) {
       params = parameters.get(c);
@@ -19777,8 +19777,8 @@ var segmentToBezier = function(cx1, cy1, th0, th1, rx, ry, sinTh, cosTh) {
   ];
   return result;
 };
-var svgPathToOperators = function(path37) {
-  return apply(parse(path37));
+var svgPathToOperators = function(path39) {
+  return apply(parse(path39));
 };
 
 // ../../node_modules/.pnpm/pdf-lib@1.17.1/node_modules/pdf-lib/es/api/operations.js
@@ -19935,7 +19935,7 @@ var drawEllipse = function(options) {
     popGraphicsState()
   ]).filter(Boolean);
 };
-var drawSvgPath = function(path37, options) {
+var drawSvgPath = function(path39, options) {
   var _a, _b, _c;
   return __spreadArrays([
     pushGraphicsState(),
@@ -19949,7 +19949,7 @@ var drawSvgPath = function(path37, options) {
     options.borderWidth && setLineWidth(options.borderWidth),
     options.borderLineCap && setLineCap(options.borderLineCap),
     setDashPattern((_b = options.borderDashArray) !== null && _b !== void 0 ? _b : [], (_c = options.borderDashPhase) !== null && _c !== void 0 ? _c : 0)
-  ], svgPathToOperators(path37), [
+  ], svgPathToOperators(path39), [
     // prettier-ignore
     options.color && options.borderWidth ? fillAndStroke() : options.color ? fill() : options.borderColor ? stroke() : closePath(),
     popGraphicsState()
@@ -23931,12 +23931,12 @@ var PDFPage = (
         graphicsState: graphicsStateKey
       }));
     };
-    PDFPage2.prototype.drawSvgPath = function(path37, options) {
+    PDFPage2.prototype.drawSvgPath = function(path39, options) {
       var _a, _b, _c, _d, _e, _f, _g, _h, _j;
       if (options === void 0) {
         options = {};
       }
-      assertIs(path37, "path", ["string"]);
+      assertIs(path39, "path", ["string"]);
       assertOrUndefined(options.x, "options.x", ["number"]);
       assertOrUndefined(options.y, "options.y", ["number"]);
       assertOrUndefined(options.scale, "options.scale", ["number"]);
@@ -23965,7 +23965,7 @@ var PDFPage = (
         options.borderColor = rgb(0, 0, 0);
       }
       var contentStream = this.getContentStream();
-      contentStream.push.apply(contentStream, drawSvgPath(path37, {
+      contentStream.push.apply(contentStream, drawSvgPath(path39, {
         x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
         y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
         scale: options.scale,
@@ -24478,9 +24478,9 @@ ${chunk}
 
 // src/tools/document-processing/checkpoint.ts
 import { readFile as readFile11, writeFile as writeFile6 } from "fs/promises";
-async function loadCheckpoint(path37) {
+async function loadCheckpoint(path39) {
   try {
-    const raw = await readFile11(path37, "utf8");
+    const raw = await readFile11(path39, "utf8");
     const data = JSON.parse(raw);
     if (!data.pdfPath || !Array.isArray(data.chunks)) return null;
     return data;
@@ -24488,9 +24488,9 @@ async function loadCheckpoint(path37) {
     return null;
   }
 }
-async function saveCheckpoint(path37, data) {
+async function saveCheckpoint(path39, data) {
   const next = { ...data, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
-  await writeFile6(path37, JSON.stringify(next, null, 2), "utf8");
+  await writeFile6(path39, JSON.stringify(next, null, 2), "utf8");
 }
 function createInitialCheckpoint(pdfPath, totalPages, totalChunks, chunkPages, chunkRanges) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -26315,9 +26315,9 @@ function getSourceCheckpointPath(sourceDir) {
   return `${sourceDir.replace(/\/$/, "")}/${SOURCE_CHECKPOINT_FILENAME}`;
 }
 async function loadSourceCheckpoint(sourceDir) {
-  const path37 = getSourceCheckpointPath(sourceDir);
+  const path39 = getSourceCheckpointPath(sourceDir);
   try {
-    const raw = await readFile20(path37, "utf8");
+    const raw = await readFile20(path39, "utf8");
     const data = JSON.parse(raw);
     if (data.version == null || !Array.isArray(data.files)) return null;
     return data;
@@ -26326,12 +26326,12 @@ async function loadSourceCheckpoint(sourceDir) {
   }
 }
 async function saveSourceCheckpoint(sourceDir, data) {
-  const path37 = getSourceCheckpointPath(sourceDir);
+  const path39 = getSourceCheckpointPath(sourceDir);
   const next = {
     ...data,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  await writeJsonAtomic(path37, next);
+  await writeJsonAtomic(path39, next);
 }
 function createEmptySourceCheckpoint(sourceDir) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -27160,7 +27160,7 @@ function resolveApiKey(cwd) {
   const apiKey = process.env.OPENROUTER_API_KEY;
   if (!apiKey) {
     throw new Error(
-      "OPENROUTER_API_KEY n\xE3o encontrado. Configure no shell, ~/.reverso/.env, ./.env ou ./.env.local."
+      "OPENROUTER_API_KEY not found. Set it in your shell, ~/.reverso/.env, ./.env or ./.env.local."
     );
   }
   return apiKey;
@@ -27207,7 +27207,7 @@ async function runCli(argv) {
     if (sub === "process-all" || sub === "process-queue") {
       printNextCommand({
         command: "reverso init",
-        description: "Atualizar contexto de investiga\xE7\xE3o ap\xF3s processar fontes."
+        description: "Update investigation context after processing sources."
       });
     }
     return true;
@@ -27238,7 +27238,7 @@ async function runCli(argv) {
     });
     printNextCommand({
       command: "reverso init",
-      description: "Atualizar contexto de investiga\xE7\xE3o ap\xF3s o rerun dos documentos."
+      description: "Update investigation context after document rerun."
     });
     return true;
   }
@@ -27250,10 +27250,10 @@ async function runCli(argv) {
     checkpoint = await upsertSourceFileEntries(sourceDir, entries);
     const pending = checkpoint.files.filter((f) => f.queuedAt != null && f.status !== "done");
     if (pending.length === 0) {
-      console.log("Nenhum documento na fila (queued e n\xE3o conclu\xEDdo).");
+      console.log("No documents in queue (queued and not completed).");
       return true;
     }
-    console.log(`Fila: ${pending.length} documento(s) pendente(s)
+    console.log(`Queue: ${pending.length} pending document(s)
 `);
     for (const f of pending) {
       const err = f.lastError ? ` \u2014 ${f.lastError}` : "";
@@ -27276,11 +27276,11 @@ async function runCli(argv) {
       docIdsToClear = checkpoint.files.filter((f) => f.queuedAt != null).map((f) => f.docId);
     }
     if (docIdsToClear.length === 0) {
-      console.log("Nenhum documento para remover da fila.");
+      console.log("No documents to remove from queue.");
       return true;
     }
     await setSourceQueued(sourceDir, docIdsToClear, null);
-    console.log(`${docIdsToClear.length} documento(s) removido(s) da fila.`);
+    console.log(`${docIdsToClear.length} document(s) removed from queue.`);
     return true;
   }
   if (sub === "watch") {
@@ -27290,7 +27290,7 @@ async function runCli(argv) {
       sourceDir,
       autoProcess,
       onCheckpointUpdated: () => {
-        console.log("Checkpoint atualizado.");
+        console.log("Checkpoint updated.");
       }
     });
     let queueInterval = null;
@@ -27322,9 +27322,9 @@ async function runCli(argv) {
         });
       };
       queueInterval = setInterval(runProcessQueue, processQueueEverySec * 1e3);
-      console.log(`process-queue a cada ${processQueueEverySec}s`);
+      console.log(`process-queue every ${processQueueEverySec}s`);
     }
-    console.log(`Monitorando ${sourceDir}. Ctrl+C para encerrar.`);
+    console.log(`Watching ${sourceDir}. Press Ctrl+C to stop.`);
     process.on("SIGINT", () => {
       if (queueInterval) clearInterval(queueInterval);
       stop();
@@ -27349,11 +27349,11 @@ async function runCli(argv) {
     const existingDocIds = checkpoint.files.map((f) => f.docId);
     const toSet = docIds.filter((id) => existingDocIds.includes(id));
     if (toSet.length === 0) {
-      console.log("Nenhum arquivo do checkpoint corresponde \xE0 lista informada.");
+      console.log("No checkpoint files match the provided list.");
       return true;
     }
     await setSourceSelected(sourceDir, toSet, value);
-    console.log(`Sele\xE7\xE3o atualizada: ${toSet.length} arquivo(s) -> ${value}`);
+    console.log(`Selection updated: ${toSet.length} file(s) -> ${value}`);
     return true;
   }
   return false;
@@ -29863,111 +29863,111 @@ function addAdvancedOption(yargs2, showAdvanced, key, config) {
     describe: config.describe,
     ...config.choices ? { choices: config.choices } : {},
     hidden: !showAdvanced,
-    group: showAdvanced ? "Op\xE7\xF5es avan\xE7adas:" : void 0
+    group: showAdvanced ? "Advanced options:" : void 0
   });
 }
 var inquiryCommand = {
   command: "inquiry",
-  describe: "Executa inquiry para um lead especifico",
+  describe: "Run inquiry for a specific lead",
   builder: (yargs2) => {
     const showAdvanced = process.argv.includes("--advanced") || process.argv.includes("--expert");
     let configured = yargs2.option("lead", {
       type: "string",
       demandOption: true,
-      describe: "Slug do lead"
-    }).option("model", { type: "string", describe: "Modelo LLM" }).option("response-language", {
+      describe: "Lead slug"
+    }).option("model", { type: "string", describe: "LLM model" }).option("response-language", {
       type: "string",
-      describe: "Idioma de resposta (auto|en|pt|es|fr|de|it)"
+      describe: "Response language (auto|en|pt|es|fr|de|it)"
     }).option("pev", {
       type: "boolean",
-      describe: "Ativa fluxo plan -> execute -> verify"
-    }).option("max-steps", { type: "number", describe: "Limite de passos do loop" }).option("max-tool-calls", { type: "number", describe: "Limite de tool calls do loop" }).option("max-elapsed-ms", { type: "number", describe: "Timeout total em ms" }).option("confidence-threshold", {
+      describe: "Enable plan -> execute -> verify flow"
+    }).option("max-steps", { type: "number", describe: "Loop step limit" }).option("max-tool-calls", { type: "number", describe: "Loop tool call limit" }).option("max-elapsed-ms", { type: "number", describe: "Total timeout in ms" }).option("confidence-threshold", {
       type: "number",
-      describe: "Threshold de confian\xE7a (0-1)"
+      describe: "Confidence threshold (0-1)"
     }).option("self-repair", {
       type: "boolean",
-      describe: "Ativa auto-reparo de contratos JSON"
+      describe: "Enable JSON contract auto-repair"
     }).option("self-repair-max-rounds", {
       type: "number",
-      describe: "Maximo de rodadas de auto-reparo"
+      describe: "Maximum auto-repair rounds"
     });
     configured = addAdvancedOption(configured, showAdvanced, "evidence-gate", {
       type: "boolean",
-      describe: "Ativa gate de evid\xEAncia"
+      describe: "Enable evidence gate"
     });
     configured = addAdvancedOption(configured, showAdvanced, "evidence-min-confidence", {
       type: "number",
-      describe: "Confian\xE7a m\xEDnima do gate de evid\xEAncia (0-1)"
+      describe: "Minimum confidence for evidence gate (0-1)"
     });
     configured = addAdvancedOption(configured, showAdvanced, "enriched-tool-manifest", {
       type: "boolean",
-      describe: "Exp\xF5e manifesto de tools enriquecido no planning"
+      describe: "Expose enriched tool manifest in planning"
     });
     configured = addAdvancedOption(configured, showAdvanced, "strict-planning-validation", {
       type: "boolean",
-      describe: "Falha se o plano n\xE3o atender valida\xE7\xE3o estrita"
+      describe: "Fail if plan does not meet strict validation"
     });
     configured = addAdvancedOption(configured, showAdvanced, "prewrite-validation", {
       type: "boolean",
-      describe: "Executa valida\xE7\xE3o pr\xE9-persist\xEAncia"
+      describe: "Run pre-persistence validation"
     });
     configured = addAdvancedOption(configured, showAdvanced, "prewrite-validation-strict", {
       type: "boolean",
-      describe: "Falha a execu\xE7\xE3o se a valida\xE7\xE3o pr\xE9-write reprovar"
+      describe: "Fail execution if pre-write validation fails"
     });
     configured = addAdvancedOption(configured, showAdvanced, "critical-write-gate", {
       type: "boolean",
-      describe: "Ativa gate cr\xEDtico de escrita"
+      describe: "Enable critical write gate"
     });
     configured = addAdvancedOption(configured, showAdvanced, "require-explicit-write-approval", {
       type: "boolean",
-      describe: "Exige aprova\xE7\xE3o expl\xEDcita para persist\xEAncia cr\xEDtica"
+      describe: "Require explicit approval for critical writes"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p1-compliance-hooks", {
       type: "boolean",
-      describe: "Ativa hooks de compliance P1"
+      describe: "Enable P1 compliance hooks"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p1-domain-subagents", {
       type: "boolean",
-      describe: "Ativa subagentes de dom\xEDnio P1"
+      describe: "Enable P1 domain subagents"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p1-checkpoint", {
       type: "boolean",
-      describe: "Ativa checkpoints de investiga\xE7\xE3o P1"
+      describe: "Enable P1 investigation checkpoints"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p1-checkpoint-restore", {
       type: "boolean",
-      describe: "Restaura checkpoint no in\xEDcio da inquiry"
+      describe: "Restore checkpoint at inquiry start"
     });
     configured = addAdvancedOption(configured, showAdvanced, "editorial-governance", {
       type: "boolean",
-      describe: "Ativa governan\xE7a editorial de artefatos"
+      describe: "Enable artifact editorial governance"
     });
     configured = addAdvancedOption(configured, showAdvanced, "editorial-governance-strict", {
       type: "boolean",
-      describe: "Falha em viola\xE7\xF5es de governan\xE7a editorial"
+      describe: "Fail on editorial governance violations"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p2-batch-concurrency", {
       type: "number",
-      describe: "Concorr\xEAncia de lotes da inquiry"
+      describe: "Inquiry batch concurrency"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p2-evidence-mode", {
       type: "string",
       choices: ["lexical", "semantic", "hybrid"],
-      describe: "Modo de verifica\xE7\xE3o de evid\xEAncia"
+      describe: "Evidence verification mode"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p2-observability", {
       type: "boolean",
-      describe: "Ativa observabilidade operacional P2"
+      describe: "Enable P2 operational observability"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p2-sensitive-data-policy", {
       type: "string",
       choices: ["off", "warn", "strict"],
-      describe: "Pol\xEDtica de dados sens\xEDveis"
+      describe: "Sensitive data policy"
     });
     configured = addAdvancedOption(configured, showAdvanced, "p2-sensitive-data-strict", {
       type: "boolean",
-      describe: "Alias para p2-sensitive-data-policy=strict"
+      describe: "Alias for p2-sensitive-data-policy=strict"
     });
     return configured;
   },
@@ -30091,11 +30091,11 @@ ${SECTION_ACTIVE}
 // src/commands/agent-setup.ts
 var agentSetupCommand = {
   command: "agent-setup",
-  describe: "Atualiza instrucoes do agent.md",
+  describe: "Update agent.md instructions",
   builder: (yargs2) => yargs2.option("text", {
     type: "string",
     demandOption: true,
-    describe: "Texto da instrucao"
+    describe: "Instruction text"
   }),
   handler: async (argv) => {
     await runAgentSetup({
@@ -30113,10 +30113,10 @@ async function runDocumentProcessing(argv) {
 // src/commands/doc-process.ts
 var docProcessCommand = {
   command: "doc-process [args..]",
-  describe: "Executa processamento de documentos (subcomandos)",
-  builder: (yargs2) => yargs2.usage("reverso doc-process <subcomando> [flags]").example("reverso doc-process process-all", "Processa todos os PDFs pendentes").example("reverso doc-process queue-status", "Mostra a fila atual").option("artifact-language", {
+  describe: "Run document processing (subcommands)",
+  builder: (yargs2) => yargs2.usage("reverso doc-process <subcommand> [flags]").example("reverso doc-process process-all", "Process all pending PDFs").example("reverso doc-process queue-status", "Show the current queue").option("artifact-language", {
     type: "string",
-    describe: "Idioma dos artefatos (source|en|pt|es|fr|de|it)"
+    describe: "Artifact language (source|en|pt|es|fr|de|it)"
   }),
   handler: async (argv) => {
     const positional = Array.isArray(argv.args) ? argv.args : [];
@@ -30132,40 +30132,135 @@ var docProcessCommand = {
   }
 };
 
+// src/commands/setup.ts
+import readline from "readline";
+import fs2 from "fs";
+import path37 from "path";
+function prompt(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+var setupCommand = {
+  command: "setup",
+  describe: "Configure OpenRouter API key",
+  builder: (yargs2) => yargs2,
+  handler: async () => {
+    console.log("=== Reverso Setup ===\n");
+    console.log("To get your OpenRouter API key, visit:");
+    console.log("  https://openrouter.ai/settings/keys\n");
+    const key = await prompt("Enter your OpenRouter API key: ");
+    if (!key.startsWith("sk-or-")) {
+      console.error('\nError: API key must start with "sk-or-". Please check your key and try again.');
+      process.exitCode = 1;
+      return;
+    }
+    const envPath = getGlobalEnvPath();
+    const envDir = path37.dirname(envPath);
+    fs2.mkdirSync(envDir, { recursive: true });
+    let existing = "";
+    if (fs2.existsSync(envPath)) {
+      existing = fs2.readFileSync(envPath, "utf8");
+    }
+    const lines = existing.split("\n").filter((l) => !l.startsWith("OPENROUTER_API_KEY="));
+    lines.push(`OPENROUTER_API_KEY=${key}`);
+    const content = lines.filter(Boolean).join("\n") + "\n";
+    fs2.writeFileSync(envPath, content, "utf8");
+    console.log(`
+API key saved to ${envPath}`);
+  }
+};
+
+// src/commands/process.ts
+import fs3 from "fs";
+import path38 from "path";
+function hasPdfs(dir) {
+  try {
+    return fs3.readdirSync(dir).some((f) => f.toLowerCase().endsWith(".pdf"));
+  } catch {
+    return false;
+  }
+}
+function detectSourceDir(cwd) {
+  const filesystemSources = path38.join(cwd, "filesystem", "sources");
+  if (fs3.existsSync(filesystemSources) && hasPdfs(filesystemSources)) {
+    return filesystemSources;
+  }
+  if (hasPdfs(cwd)) {
+    return cwd;
+  }
+  return void 0;
+}
+var processCommand = {
+  command: "process",
+  describe: "Process all PDFs (auto-detects source directory)",
+  builder: (yargs2) => yargs2.option("mode", {
+    type: "string",
+    choices: ["standard", "deep"],
+    default: "standard",
+    describe: "Processing mode"
+  }).option("artifact-language", {
+    type: "string",
+    describe: "Artifact language (source|en|pt|es|fr|de|it)"
+  }).example("reverso process", "Auto-detect PDFs and process all").example("reverso process --mode deep", "Deep processing mode").example("reverso process --artifact-language pt", "Output artifacts in Portuguese"),
+  handler: async (argv) => {
+    const cwd = process.cwd();
+    const detectedSource = detectSourceDir(cwd);
+    const docProcessArgv = ["process-all"];
+    if (detectedSource) {
+      docProcessArgv.push("--source", detectedSource);
+    }
+    if (typeof argv.mode === "string" && argv.mode !== "standard") {
+      docProcessArgv.push("--mode", argv.mode);
+    }
+    if (typeof argv["artifact-language"] === "string") {
+      docProcessArgv.push("--artifact-language", argv["artifact-language"]);
+    }
+    if (typeof argv.feedback === "string") {
+      docProcessArgv.push("--feedback", argv.feedback);
+    }
+    await runDocumentProcessing(docProcessArgv);
+  }
+};
+
 // src/index.ts
 async function main2() {
-  await yargs(hideBin(process.argv)).scriptName("reverso").usage("$0 <comando> [flags]").parserConfiguration({
+  await yargs(hideBin(process.argv)).scriptName("reverso").usage("$0 <command> [flags]").parserConfiguration({
     "camel-case-expansion": false
   }).option("filesystem", {
     type: "string",
-    describe: "For\xE7ar caminho do filesystem root",
+    describe: "Override filesystem root path",
     global: true
   }).option("feedback", {
     type: "string",
     choices: ["plain", "compact", "visual"],
     default: DEFAULT_FEEDBACK_MODE,
-    describe: "Modo de feedback no terminal",
+    describe: "Terminal feedback mode",
     global: true
   }).option("advanced", {
     type: "boolean",
     default: false,
-    describe: "Mostra flags avan\xE7adas no help",
+    describe: "Show advanced flags in help",
     global: true
   }).option("expert", {
     type: "boolean",
     default: false,
     hidden: true,
-    describe: "Alias interno para flags avan\xE7adas",
+    describe: "Internal alias for advanced flags",
     global: true
   }).middleware((argv) => {
     if (typeof argv.filesystem === "string" && argv.filesystem.length > 0) {
       process.env.REVERSO_FILESYSTEM = argv.filesystem;
     }
-  }).command(initCommand).command(agentSetupCommand).command(digCommand).command(createLeadCommand).command(inquiryCommand).command(docProcessCommand).demandCommand(1, "Especifique um comando. Use --help para ver os dispon\xEDveis.").strictCommands().recommendCommands().help().alias("h", "help").parseAsync();
+  }).command(setupCommand).command(processCommand).command(initCommand).command(agentSetupCommand).command(digCommand).command(createLeadCommand).command(inquiryCommand).command(docProcessCommand).demandCommand(1, "Specify a command. Use --help to see available commands.").strictCommands().recommendCommands().help().alias("h", "help").parseAsync();
 }
 main2().catch((error2) => {
   const message = error2 instanceof Error ? error2.message : String(error2);
-  console.error(`Erro no Agent CLI: ${message}`);
+  console.error(`Agent CLI error: ${message}`);
   process.exitCode = 1;
 });
 /*! Bundled license information:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverso-agent/cli",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "CLI do agente investigativo Reverso — OSINT com LLM",
   "type": "module",
   "bin": {