pudu-ai 0.2.21 → 0.2.23

package/README.md

@@ -148,6 +148,8 @@ Deterministic repository search. Optional Python 3.10+, `rg`, and `ast-grep`. No
 ```bash
 npx pudu-ai repo search validate_user --repo . --json
 npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+npx pudu-ai repo graph --repo .
+npx pudu-ai repo harness --task "fix validate_user" --json
 npx pudu-ai repo search validate_user --lang es
 ```
 

package/dist/cli/chunk-473MNTMS.js

@@ -0,0 +1,24 @@
+// src/shared/format.ts
+function formatNumber(value, digits = 1) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return value.toFixed(digits);
+}
+function formatPercent(value, digits = 0) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return `${value.toFixed(digits)} %`;
+}
+function formatTokensPerSec(value, digits = 1) {
+  if (value === void 0 || Number.isNaN(value)) return "N/A";
+  return `${value.toFixed(digits)} t/s`;
+}
+function na(value) {
+  if (value === void 0 || value === null || value === "") return "N/A";
+  return String(value);
+}
+
+export {
+  formatNumber,
+  formatPercent,
+  formatTokensPerSec,
+  na
+};

package/dist/cli/chunk-47LK5I2X.js

@@ -0,0 +1,39 @@
+// src/integrations/catalog.ts
+var INTEGRATIONS = {
+  opencode: {
+    id: "opencode",
+    docsUrl: "https://docs.ollama.com/integrations/opencode",
+    ollamaLaunch: "opencode",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  openclaw: {
+    id: "openclaw",
+    docsUrl: "https://docs.ollama.com/integrations/openclaw",
+    ollamaLaunch: "openclaw",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  hermes: {
+    id: "hermes",
+    docsUrl: "https://docs.ollama.com/integrations/hermes",
+    ollamaLaunch: "hermes",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A"],
+    useCases: ["code", "chat", "reasoning"]
+  },
+  claude: {
+    id: "claude",
+    docsUrl: "https://docs.ollama.com/integrations/claude-code",
+    ollamaLaunch: "claude",
+    minGenerationTps: 12,
+    allowedGrades: ["S", "A", "B"],
+    useCases: ["code", "chat", "reasoning"]
+  }
+};
+
+export {
+  INTEGRATIONS
+};

package/dist/cli/{chunk-QGEXKMQ5.js → chunk-4VEDGI4L.js}

@@ -30,16 +30,36 @@ var en = {
   aboutRepoSearch: "Deterministic repository search (Pudu Agent Lab). Literal strings use rg; syntactic patterns use ast-grep. No LLM. Missing tools are reported, never faked.",
   repoSearchTitle: "Pudu Agent Lab \u2014 repo search",
   repoNeedQuery: "Pass a query or --structural PATTERN, e.g. npx pudu-ai repo search validate_user --json",
-  repoUnknownSubcommand: "Unknown repo subcommand: {sub}. Iteration 1 supports search only.",
+  repoUnknownSubcommand: "Unknown repo subcommand: {sub}. Supported: search, graph, harness.",
   repoPythonMissing: "python3 not found. Agent Lab search needs Python 3.10+ on PATH.",
   repoToolMissing: "{tool} not found on PATH",
   repoNoMatches: "No matches.",
-  repoHelp: `Pudu Agent Lab \u2014 repository search
+  repoNeedTask: 'Pass a task, e.g. npx pudu-ai repo harness --task "fix validate_user" --repo .',
+  repoGraphTitle: "AGENT LAB \u2014 IMPLEMENTATION GRAPH",
+  aboutRepoGraph: "Python stdlib AST graph (imports, defs, calls, inherits). Optional Graphify file if present. Edges are EXTRACTED or RESOLVED. Never invented.",
+  repoGraphBuilding: "Building graph of this folder\u2026",
+  repoGraphEmpty: "No Python files with extractable structure.",
+  repoGraphFiles: "Files",
+  repoGraphNodes: "Nodes",
+  repoGraphEdges: "Edges",
+  repoTokens: "Token estimate",
+  repoEffortTitle: "TASK EFFORT (DERIVED)",
+  repoHarnessPrompt: "HARNESS TASK",
+  repoHarnessPromptHint: "Type the coding task, then Enter",
+  repoHarnessEnter: "Enter = pick local model from effort   Esc = back",
+  repoHarnessNoPrompt: "(empty prompt \u2014 effort is still from the graph)",
+  repoHarnessModel: "BEST LOCAL MODEL FOR THIS TASK",
+  repoHarnessKeys: "1 OpenCode  2 Hermes  3 OpenClaw  Enter=OpenCode  Esc=back",
+  repoHarnessNoTag: "No Ollama tag for this model. N/A \u2014 will not invent a launch command.",
+  repoHarnessWroteConfig: "Wrote OpenCode config {file} (local model + pudu-ai MCP tools).",
+  repoHelp: `Pudu Agent Lab \u2014 repository search, graph, harness
 
 Usage:
   npx pudu-ai repo search QUERY
   npx pudu-ai repo search QUERY --repo PATH --json
   npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+  npx pudu-ai repo graph --repo PATH
+  npx pudu-ai repo harness --task "fix auth" --repo PATH --json
 
 Flags:
   --repo PATH         Repository root (default: cwd)
@@ -47,7 +67,8 @@ Flags:
   --intent INTENT     TEXT | STRUCTURAL | RELATIONSHIP | IMPACT | SEMANTIC | UNKNOWN
   --glob GLOB         Repeatable include glob
   --limit N           Max matches (default 100)
-  --json              Machine-readable SearchResult
+  --task TEXT         Harness task prompt
+  --json              Machine-readable JSON
 `,
   nav: "[S] Setup/Install  [B] Benchmark  [M] Models  [R] Recommend  [T] Tasks  [H] Hardware  [C] Compare  [L] History  [Q] Quit",
   setupTitle: "SETUP \u2014 INSTALL MODELS & AGENTS",
@@ -197,6 +218,8 @@ Usage:
   npx pudu-ai launch opencode --yes
   npx pudu-ai repo search QUERY
   npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+  npx pudu-ai repo graph
+  npx pudu-ai repo harness --task "fix auth"
 
 Flags:
   --json          Machine-readable JSON (no TUI)
@@ -215,6 +238,7 @@ Flags:
   --intent        TEXT | STRUCTURAL | RELATIONSHIP | IMPACT | SEMANTIC | UNKNOWN
   --glob          Repeatable include glob for repo search
   --limit         Max repo search matches
+  --task          Harness task prompt
 
 Credits:
   Measured values come from llama-bench and OS telemetry.
@@ -256,24 +280,45 @@ var es = {
   aboutRepoSearch: "B\xFAsqueda determinista de repositorio (Pudu Agent Lab). Cadenas literales: rg; patrones sint\xE1cticos: ast-grep. Sin LLM. Si falta una herramienta se informa, no se inventa.",
   repoSearchTitle: "Pudu Agent Lab \u2014 b\xFAsqueda de repo",
   repoNeedQuery: "Pasa una consulta o --structural PATR\xD3N, p. ej. npx pudu-ai repo search validate_user --json",
-  repoUnknownSubcommand: "Subcomando de repo desconocido: {sub}. La iteraci\xF3n 1 solo admite search.",
+  repoUnknownSubcommand: "Subcomando de repo desconocido: {sub}. Soportados: search, graph, harness.",
   repoPythonMissing: "No se encontr\xF3 python3. La b\xFAsqueda de Agent Lab necesita Python 3.10+ en PATH.",
   repoToolMissing: "{tool} no est\xE1 en PATH",
   repoNoMatches: "Sin coincidencias.",
-  repoHelp: `Pudu Agent Lab \u2014 b\xFAsqueda de repositorio
+  repoNeedTask: 'Pasa una tarea, p. ej. npx pudu-ai repo harness --task "arreglar validate_user" --repo .',
+  repoGraphTitle: "AGENT LAB \u2014 GRAFO DE IMPLEMENTACI\xD3N",
+  aboutRepoGraph: "Grafo AST de Python (imports, defs, llamadas, herencias). Graphify opcional si existe el archivo. Aristas EXTRACTED o RESOLVED. Nunca inventadas.",
+  repoGraphBuilding: "Construyendo el grafo de esta carpeta\u2026",
+  repoGraphEmpty: "No hay Python con estructura extra\xEDble.",
+  repoGraphFiles: "Archivos",
+  repoGraphNodes: "Nodos",
+  repoGraphEdges: "Aristas",
+  repoTokens: "Estimaci\xF3n de tokens",
+  repoEffortTitle: "ESFUERZO DE TAREA (DERIVED)",
+  repoHarnessPrompt: "TAREA HARNESS",
+  repoHarnessPromptHint: "Escribe la tarea de c\xF3digo y pulsa Enter",
+  repoHarnessEnter: "Enter = elegir modelo local seg\xFAn esfuerzo   Esc = atr\xE1s",
+  repoHarnessNoPrompt: "(prompt vac\xEDo \u2014 el esfuerzo sigue saliendo del grafo)",
+  repoHarnessModel: "MEJOR MODELO LOCAL PARA ESTA TAREA",
+  repoHarnessKeys: "1 OpenCode  2 Hermes  3 OpenClaw  Enter=OpenCode  Esc=atr\xE1s",
+  repoHarnessNoTag: "Este modelo no tiene tag Ollama. N/A \u2014 no se inventa el comando de launch.",
+  repoHarnessWroteConfig: "Config OpenCode escrita en {file} (modelo local + tools MCP pudu-ai).",
+  repoHelp: `Pudu Agent Lab \u2014 b\xFAsqueda, grafo y harness
 
 Uso:
   npx pudu-ai repo search CONSULTA
   npx pudu-ai repo search CONSULTA --repo RUTA --json
   npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+  npx pudu-ai repo graph --repo RUTA
+  npx pudu-ai repo harness --task "arreglar auth" --repo RUTA --json
 
 Flags:
-  --repo PATH         Ra\xEDz del repositorio (por defecto: cwd)
-  --structural PAT    Patr\xF3n de ast-grep
+  --repo PATH         Ra\xEDz del repositorio (cwd)
+  --structural PAT    Patr\xF3n ast-grep
   --intent INTENT     TEXT | STRUCTURAL | RELATIONSHIP | IMPACT | SEMANTIC | UNKNOWN
   --glob GLOB         Glob de inclusi\xF3n (repetible)
   --limit N           M\xE1ximo de coincidencias (100)
-  --json              SearchResult legible por m\xE1quinas
+  --task TEXT         Prompt de la tarea harness
+  --json              JSON
 `,
   nav: "[S] Setup/Instalar  [B] Benchmark  [M] Modelos  [R] Recomendaciones  [T] Tareas  [H] Hardware  [C] Comparar  [L] Historial  [Q] Salir",
   setupTitle: "SETUP \u2014 INSTALAR MODELOS Y AGENTES",
@@ -423,6 +468,8 @@ Uso:
   npx pudu-ai launch opencode --yes
   npx pudu-ai repo search CONSULTA
   npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+  npx pudu-ai repo graph
+  npx pudu-ai repo harness --task "arreglar auth"
 
 Flags:
   --json          JSON legible por m\xE1quinas (sin TUI)
@@ -472,30 +519,8 @@ function t(id, vars) {
   return text;
 }
 
-// src/shared/format.ts
-function formatNumber(value, digits = 1) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return value.toFixed(digits);
-}
-function formatPercent(value, digits = 0) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return `${value.toFixed(digits)} %`;
-}
-function formatTokensPerSec(value, digits = 1) {
-  if (value === void 0 || Number.isNaN(value)) return "N/A";
-  return `${value.toFixed(digits)} t/s`;
-}
-function na(value) {
-  if (value === void 0 || value === null || value === "") return "N/A";
-  return String(value);
-}
-
 export {
   resolveLocale,
   setLocale,
-  t,
-  formatNumber,
-  formatPercent,
-  formatTokensPerSec,
-  na
+  t
 };

package/dist/cli/{chunk-6C5EPKRI.js → chunk-6BGYI7XY.js}

@@ -1,9 +1,14 @@
+import {
+  INTEGRATIONS
+} from "./chunk-47LK5I2X.js";
 import {
   formatNumber,
   formatTokensPerSec,
-  na,
+  na
+} from "./chunk-473MNTMS.js";
+import {
   t
-} from "./chunk-QGEXKMQ5.js";
+} from "./chunk-4VEDGI4L.js";
 import {
   commandExists,
   runCommand,
@@ -1053,42 +1058,6 @@ function tasksText(plans, answers) {
   return [...header, ...blocks].join("\n\n");
 }
 
-// src/integrations/catalog.ts
-var INTEGRATIONS = {
-  opencode: {
-    id: "opencode",
-    docsUrl: "https://docs.ollama.com/integrations/opencode",
-    ollamaLaunch: "opencode",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  openclaw: {
-    id: "openclaw",
-    docsUrl: "https://docs.ollama.com/integrations/openclaw",
-    ollamaLaunch: "openclaw",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  hermes: {
-    id: "hermes",
-    docsUrl: "https://docs.ollama.com/integrations/hermes",
-    ollamaLaunch: "hermes",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A"],
-    useCases: ["code", "chat", "reasoning"]
-  },
-  claude: {
-    id: "claude",
-    docsUrl: "https://docs.ollama.com/integrations/claude-code",
-    ollamaLaunch: "claude",
-    minGenerationTps: 12,
-    allowedGrades: ["S", "A", "B"],
-    useCases: ["code", "chat", "reasoning"]
-  }
-};
-
 // src/integrations/ollama-tags.ts
 var RULES = [
   { test: /qwen\s*3\.5\s*[-:]?\s*8b/i, tag: "qwen3.5:8b" },

package/dist/cli/chunk-7KPNGK6A.js

@@ -0,0 +1,61 @@
+import {
+  commandExists,
+  runCommand
+} from "./chunk-SS7OXXQQ.js";
+
+// src/agent-lab/python-bridge.ts
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function hasEngine(dir) {
+  return existsSync(path.join(dir, "pudu_agent", "__main__.py"));
+}
+function pythonRoot() {
+  const starts = [path.dirname(fileURLToPath(import.meta.url)), process.cwd()];
+  for (const start of starts) {
+    let dir = start;
+    for (let i = 0; i < 8; i++) {
+      const candidate = path.join(dir, "python");
+      if (hasEngine(candidate)) return candidate;
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  }
+  return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "python");
+}
+async function findPython() {
+  return await commandExists("python3") ?? await commandExists("python");
+}
+async function invokePuduAgent(request, timeout = 3e4) {
+  const python = await findPython();
+  if (!python) {
+    throw new Error("python3 not found on PATH");
+  }
+  const root = pythonRoot();
+  const payload = `${JSON.stringify(request)}
+`;
+  const result = await runCommand(python, ["-m", "pudu_agent"], {
+    cwd: root,
+    env: { ...process.env, PYTHONPATH: root, PYTHONUNBUFFERED: "1" },
+    input: payload,
+    timeout
+  });
+  return { ...result, python };
+}
+function parseJsonStdout(stdout) {
+  const text = stdout.trim();
+  if (!text) {
+    throw new Error("Python engine returned empty stdout");
+  }
+  const start = text.indexOf("{");
+  const slice = start >= 0 ? text.slice(start) : text;
+  return JSON.parse(slice);
+}
+
+export {
+  pythonRoot,
+  findPython,
+  invokePuduAgent,
+  parseJsonStdout
+};

package/dist/cli/chunk-XEEGLMVT.js

@@ -0,0 +1,25 @@
+import {
+  invokePuduAgent,
+  parseJsonStdout
+} from "./chunk-7KPNGK6A.js";
+
+// src/agent-lab/graph.ts
+async function buildRepoGraph(repo, timeoutMs = 6e4) {
+  const invoked = await invokePuduAgent({ op: "graph", repo }, timeoutMs);
+  if (invoked.timedOut) throw new Error("Python graph engine timed out");
+  const parsed = parseJsonStdout(invoked.stdout);
+  if (!parsed || parsed.ok === false) {
+    throw new Error(parsed.error ?? "graph failed");
+  }
+  return parsed;
+}
+async function runRepoHarness(repo, task, timeoutMs = 6e4) {
+  const invoked = await invokePuduAgent({ op: "harness", repo, task }, timeoutMs);
+  if (invoked.timedOut) throw new Error("Python harness engine timed out");
+  return parseJsonStdout(invoked.stdout);
+}
+
+export {
+  buildRepoGraph,
+  runRepoHarness
+};

package/dist/cli/harness-launch-KEUKZZXH.js

@@ -0,0 +1,118 @@
+import {
+  INTEGRATIONS
+} from "./chunk-47LK5I2X.js";
+import {
+  findPython,
+  pythonRoot
+} from "./chunk-7KPNGK6A.js";
+import {
+  t
+} from "./chunk-4VEDGI4L.js";
+import {
+  commandExists,
+  runCommand
+} from "./chunk-SS7OXXQQ.js";
+
+// src/integrations/opencode-config.ts
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+function mergeOpenCodeHarness(existing, ollamaTag, pythonBin, engineRoot) {
+  const prev = existing ?? {};
+  const provider = prev.provider ?? {};
+  const ollama = provider.ollama ?? {};
+  const models = ollama.models ?? {};
+  const mcp = prev.mcp ?? {};
+  return {
+    ...prev,
+    $schema: typeof prev.$schema === "string" ? prev.$schema : "https://opencode.ai/config.json",
+    model: `ollama/${ollamaTag}`,
+    provider: {
+      ...provider,
+      ollama: {
+        ...ollama,
+        npm: "@ai-sdk/openai-compatible",
+        name: typeof ollama.name === "string" ? ollama.name : "Ollama (local)",
+        options: {
+          ...ollama.options ?? {},
+          baseURL: "http://127.0.0.1:11434/v1"
+        },
+        models: {
+          ...models,
+          [ollamaTag]: {
+            ...models[ollamaTag] ?? {},
+            name: ollamaTag
+          }
+        }
+      }
+    },
+    mcp: {
+      ...mcp,
+      "pudu-ai": {
+        type: "local",
+        enabled: true,
+        timeout: 12e4,
+        command: [pythonBin, "-m", "pudu_agent", "mcp"],
+        environment: { PYTHONPATH: engineRoot, PYTHONUNBUFFERED: "1" }
+      }
+    }
+  };
+}
+async function writeOpenCodeHarnessConfig(input) {
+  const file = path.join(input.repo, "opencode.json");
+  let existing;
+  try {
+    const raw = await readFile(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      existing = parsed;
+    }
+  } catch {
+    existing = void 0;
+  }
+  const next = mergeOpenCodeHarness(existing, input.ollamaTag, input.pythonBin, pythonRoot());
+  await mkdir(input.repo, { recursive: true });
+  await writeFile(file, `${JSON.stringify(next, null, 2)}
+`, "utf8");
+  return file;
+}
+
+// src/integrations/harness-launch.ts
+async function executeHarnessLaunch(req) {
+  const def = INTEGRATIONS[req.tool];
+  if (!def) return { ok: false, log: t("launchUnknown") };
+  const ollama = await commandExists("ollama");
+  if (!ollama) return { ok: false, log: t("launchNeedOllama") };
+  const lines = [];
+  if (req.tool === "opencode") {
+    const python = await findPython();
+    if (!python) return { ok: false, log: t("repoPythonMissing") };
+    const file = await writeOpenCodeHarnessConfig({
+      repo: req.repo,
+      ollamaTag: req.ollamaTag,
+      pythonBin: python
+    });
+    lines.push(t("repoHarnessWroteConfig", { file }));
+    const bin = await commandExists("opencode");
+    if (bin) {
+      lines.push(`${bin}  (${req.ollamaTag})`);
+      const launched2 = await runCommand(bin, [], { cwd: req.repo, timeout: 0, stdio: "inherit" });
+      if (launched2.exitCode !== 0) {
+        return { ok: false, log: `${lines.join("\n")}
+${launched2.stderr || t("launchExecFail")}` };
+      }
+      return { ok: true, log: lines.join("\n") };
+    }
+  }
+  const args = ["launch", def.ollamaLaunch, "--model", req.ollamaTag];
+  if (def.id === "openclaw" || def.id === "claude") args.push("--yes");
+  lines.push(`ollama ${args.join(" ")}`);
+  const launched = await runCommand("ollama", args, { timeout: 0, stdio: "inherit", cwd: req.repo });
+  if (launched.exitCode !== 0) {
+    return { ok: false, log: `${lines.join("\n")}
+${launched.stderr || t("launchExecFail")}` };
+  }
+  return { ok: true, log: lines.join("\n") };
+}
+export {
+  executeHarnessLaunch
+};

package/dist/cli/index.js

@@ -32,12 +32,14 @@ import {
   runBenchmark,
   runtimesText,
   tasksText
-} from "./chunk-6C5EPKRI.js";
+} from "./chunk-6BGYI7XY.js";
+import "./chunk-47LK5I2X.js";
+import "./chunk-473MNTMS.js";
 import {
   resolveLocale,
   setLocale,
   t
-} from "./chunk-QGEXKMQ5.js";
+} from "./chunk-4VEDGI4L.js";
 import {
   commandExists,
   killAll,
@@ -57,7 +59,8 @@ var VALUE_FLAGS = /* @__PURE__ */ new Set([
   "--repo",
   "--intent",
   "--limit",
-  "--glob"
+  "--glob",
+  "--task"
 ]);
 function flagValue(args2, name) {
   const index = args2.findIndex((a) => a === name);
@@ -131,7 +134,8 @@ function parseArgs(argv) {
     repo: flagValue(args2, "--repo"),
     intent: flagValue(args2, "--intent"),
     limit,
-    globs: flagValues(args2, "--glob")
+    globs: flagValues(args2, "--glob"),
+    task: flagValue(args2, "--task")
   };
 }
 
@@ -726,8 +730,14 @@ ${modelsText(session)}`)}
     );
     return;
   }
-  const { renderDashboard } = await import("./render-3UBPZNF4.js");
-  await renderDashboard(session, preset, start);
+  const { renderDashboard } = await import("./render-Y4DNH7FW.js");
+  const pending = await renderDashboard(session, preset, start);
+  if (pending) {
+    const { executeHarnessLaunch } = await import("./harness-launch-KEUKZZXH.js");
+    const result = await executeHarnessLaunch(pending);
+    if (!result.ok) process.stderr.write(`${result.log}
+`);
+  }
 }
 async function run(args2) {
   setLocale(resolveLocale(args2.lang));
@@ -739,7 +749,7 @@ async function run(args2) {
   if (args2.verbose) setLogLevel("verbose");
   if (!args2.color) process.env.NO_COLOR = "1";
   if (args2.command === "repo") {
-    const { runRepoCommand } = await import("./repo-cli-4GSG5MD3.js");
+    const { runRepoCommand } = await import("./repo-cli-BK76EVBZ.js");
     return runRepoCommand(args2);
   }
   const cleanup = () => {