pudu-ai 0.2.18 → 0.2.21

package/README.es.md

@@ -0,0 +1,85 @@
+# Pudu-AI
+
+**Laboratorio local de hardware y benchmarks de IA** para la terminal.
+
+[English](README.md) · [Español](README.es.md)
+
+Descubre, inspecciona, mide y compara modelos que corren en tu máquina. Las mediciones se quedan locales. Las estimaciones nunca se mezclan con resultados reales de `llama-bench`.
+
+```bash
+npx pudu-ai --lang es
+```
+
+El idioma de la UI por defecto es inglés. Usa `--lang es` para español.
+
+El nombre npm `pudu` está ocupado. Este CLI es **`pudu-ai`**.
+
+## Instalar
+
+```bash
+git clone https://github.com/devjaime/pudu-ai.git
+cd pudu-ai
+npm install
+npx . --lang es
+```
+
+O:
+
+```bash
+npm run pudu-ai -- --lang es
+```
+
+`PUDU_AI_LANG=es` o un `LANG` español (p. ej. `es_CL.UTF-8`) también seleccionan español.
+
+## Comandos
+
+```bash
+npx pudu-ai --lang es
+npx pudu-ai hardware
+npx pudu-ai models
+npx pudu-ai setup
+npx pudu-ai recommend
+npx pudu-ai tasks --for code --lang es
+npx pudu-ai benchmark qwen3:8b --json --preset quick
+npx pudu-ai doctor --lang es
+npx pudu-ai launch opencode
+npx pudu-ai repo search validate_user --json
+npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY' --repo .
+```
+
+Flags: `--json` `--csv` `--no-network` `--no-color` `--verbose` `--preset` `--lang en|es` `--repo` `--structural` `--intent` `--glob` `--limit`
+
+## Agent Lab (vista previa)
+
+Búsqueda determinista de repositorio. Python 3.10+, `rg` y `ast-grep` opcionales. Sin LLM.
+
+- Uso: [Español](docs/agent-lab-usage.es.md) · [English](docs/agent-lab-usage.md)
+- Spec: [Español](docs/spec/agent-lab.es.md) · [English](docs/spec/agent-lab.md)
+
+```bash
+npx pudu-ai repo search validate_user --repo . --json --lang es
+```
+
+Hace falta `python3` en PATH. Si faltan `rg` o `ast-grep`, el JSON dice `available: false`; no inventa coincidencias.
+
+La iteración 1 solo incluye `repo search`. Grafo, context pack y agentes aún no.
+
+## Privacidad
+
+Local-first. Benchmarks, rutas de modelos e identificadores de máquina se quedan en `~/.pudu-ai/`. Nada se sube. La red es opcional (catálogo CanIRun; `--no-network` la desactiva). Agent Lab no envía el repositorio a ninguna API.
+
+## Puntuación
+
+**Pudu-AI Score** es solo rendimiento de hardware. No incluye calidad/inteligencia del modelo. Ver `docs/spec/03-scoring.md`.
+
+**Pudu Task Score** (Agent Lab, aún no implementado) será otra métrica, separada.
+
+## Créditos
+
+**Medido:** `llama-bench` y telemetría del SO.
+
+**Estimado:** [CanIRun.ai](https://canirun.ai) de [midudev](https://midu.dev) ([GitHub](https://github.com/midudev/canirun.ai)), siempre etiquetado como estimado.
+
+## Contribuir
+
+Ver [CONTRIBUTING.md](CONTRIBUTING.md). Licencia MIT.

package/README.md

@@ -8,7 +8,7 @@ Discover, inspect, benchmark, and compare models that run on your machine. Measu
 npx pudu-ai
 ```
 
-English is the default UI language. Use `--lang es` for Spanish.
+English is the default UI language. Use `--lang es` for Spanish. Docs: [English](README.md) · [Español](README.es.md).
 
 The npm name `pudu` is taken by an empty stub. This CLI is **`pudu-ai`**.
 
@@ -59,9 +59,11 @@ npx pudu-ai report --markdown
 npx pudu-ai launch
 npx pudu-ai launch opencode
 npx pudu-ai launch opencode --yes
+npx pudu-ai repo search validate_user --json
+npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY' --repo .
 ```
 
-Flags: `--json` `--csv` `--no-network` `--no-color` `--verbose` `--preset quick|standard|stress` `--lang en|es` `--for` `--scope` `--priority`
+Flags: `--json` `--csv` `--no-network` `--no-color` `--verbose` `--preset quick|standard|stress` `--lang en|es` `--for` `--scope` `--priority` `--repo` `--structural` `--intent` `--glob` `--limit`
 
 ```bash
 npx pudu-ai --lang es
@@ -136,6 +138,21 @@ npx pudu-ai launch
 npx pudu-ai launch opencode --yes
 ```
 
+## Agent Lab (preview)
+
+Deterministic repository search. Optional Python 3.10+, `rg`, and `ast-grep`. No LLM.
+
+- Usage: [English](docs/agent-lab-usage.md) · [Español](docs/agent-lab-usage.es.md)
+- Spec: [English](docs/spec/agent-lab.md) · [Español](docs/spec/agent-lab.es.md)
+
+```bash
+npx pudu-ai repo search validate_user --repo . --json
+npx pudu-ai repo search --structural 'def $FUNC($$$ARGS): $$$BODY'
+npx pudu-ai repo search validate_user --lang es
+```
+
+Requires `python3` on PATH. If `rg` or `ast-grep` is missing, JSON reports `available: false` instead of inventing hits.
+
 ## Privacy
 
 Local-first. Benchmarks, model paths, and machine identifiers stay in `~/.pudu-ai/`. Nothing is uploaded. Network is optional and used only for the CanIRun catalog (`--no-network` disables it).

package/dist/cli/brew-ZRR7D4XL.js

@@ -0,0 +1,80 @@
+import {
+  commandExists,
+  runCommand
+} from "./chunk-SS7OXXQQ.js";
+
+// src/integrations/brew.ts
+var BREW_CANDIDATES = ["/opt/homebrew/bin/brew", "/usr/local/bin/brew", "brew"];
+async function resolveBrew() {
+  for (const bin of BREW_CANDIDATES) {
+    const found = await commandExists(bin);
+    if (found) return found;
+  }
+  return void 0;
+}
+async function dockerReady() {
+  const docker = await commandExists("docker");
+  if (!docker) return false;
+  const info = await runCommand("docker", ["info"], { timeout: 8e3 });
+  return info.exitCode === 0;
+}
+async function ensureBrew() {
+  const existing = await resolveBrew();
+  if (existing) return { ok: true, brew: existing, log: existing };
+  const install = await runCommand(
+    "/bin/bash",
+    ["-c", 'NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"'],
+    { timeout: 15 * 6e4 }
+  );
+  const after = await resolveBrew();
+  if (after) return { ok: true, brew: after, log: after };
+  return {
+    ok: false,
+    log: install.stderr || "Homebrew missing. Install: https://brew.sh"
+  };
+}
+async function brewInstall(args) {
+  const ensured = await ensureBrew();
+  if (!ensured.ok || !ensured.brew) return { ok: false, log: ensured.log };
+  const result = await runCommand(ensured.brew, args, { timeout: 15 * 6e4 });
+  return {
+    ok: result.exitCode === 0,
+    log: `${ensured.brew} ${args.join(" ")}
+${result.stdout || result.stderr}`
+  };
+}
+async function brewInstallCask(name) {
+  const brew = await resolveBrew();
+  if (!brew) {
+    const ensured = await ensureBrew();
+    if (!ensured.ok || !ensured.brew) return { ok: false, log: ensured.log };
+    const result2 = await runCommand(ensured.brew, ["install", "--cask", name], { timeout: 15 * 6e4 });
+    return { ok: result2.exitCode === 0, log: result2.stderr || result2.stdout };
+  }
+  const result = await runCommand(brew, ["install", "--cask", name], { timeout: 15 * 6e4 });
+  if (result.exitCode === 0) return { ok: true, log: result.stdout };
+  const formula = await runCommand(brew, ["install", name], { timeout: 15 * 6e4 });
+  return { ok: formula.exitCode === 0, log: formula.stderr || formula.stdout };
+}
+async function startDockerDesktop() {
+  if (process.platform === "darwin") {
+    await runCommand("open", ["-a", "Docker"], { timeout: 15e3 });
+  }
+}
+async function waitForDocker(ms = 9e4) {
+  const start = Date.now();
+  while (Date.now() - start < ms) {
+    if (await dockerReady()) return true;
+    await new Promise((resolve) => setTimeout(resolve, 2500));
+  }
+  return dockerReady();
+}
+export {
+  brewInstall,
+  brewInstallCask,
+  dockerReady,
+  ensureBrew,
+  resolveBrew,
+  startDockerDesktop,
+  waitForDocker
+};