frida-pi-studio 0.6.1

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "frida-pi-studio",
+  "version": "0.6.1",
+  "description": "Distribución FRIDA sobre pi: kit (25 extensiones + theme + branding) — este package.json ES el paquete; packages/setup = CLI npx",
+  "license": "MIT",
+  "author": "Edgar F. Fuentes Perea",
+  "bin": {
+    "frida-pi-studio": "packages/setup/bin/setup.mjs"
+  },
+  "keywords": [
+    "pi-package"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "dependencies": {
+    "@bacnh85/pi-notebooklm": "^0.1.8",
+    "@ff-labs/pi-fff": "^0.10.6",
+    "@gotgenes/pi-permission-system": "^31.1.1",
+    "@jachy/pi-git-sync": "^0.7.1",
+    "@juicesharp/rpiv-advisor": "^2.9.0",
+    "@juicesharp/rpiv-args": "^2.9.0",
+    "@juicesharp/rpiv-ask-user-question": "^2.9.0",
+    "@juicesharp/rpiv-i18n": "^2.9.0",
+    "@juicesharp/rpiv-pi": "^2.9.0",
+    "@juicesharp/rpiv-todo": "^2.9.0",
+    "@juicesharp/rpiv-web-tools": "^2.9.0",
+    "@juicesharp/rpiv-workflow": "^2.9.0",
+    "@llblab/pi-telegram": "^0.42.4",
+    "@monopi/analytics-db": "^0.6.1",
+    "@monopi/analytics-extension": "^0.6.1",
+    "@monopi/background-tasks": "^0.6.1",
+    "@monopi/diagnostics": "^0.6.1",
+    "@monopi/extension-git-guard": "^0.6.1",
+    "@monopi/extension-shared": "^0.6.1",
+    "@monopi/extension-watchdog": "^0.6.1",
+    "@monopi/remote-tailscale": "^0.6.1",
+    "@monopi/web-server": "^0.6.1",
+    "@mrclrchtr/supi-context": "^6.3.0",
+    "@mrclrchtr/supi-web": "^6.3.0",
+    "@narumitw/pi-worktree": "^0.51.7",
+    "@tintinweb/pi-subagents": "^0.19.0",
+    "pi-agent-browser-native": "^0.6.6",
+    "pi-antigravity": "^0.7.2",
+    "pi-extensible-workflows": "^5.13.0",
+    "pi-hermes-memory": "^0.9.8",
+    "pi-lens": "^4.1.3",
+    "pi-mcp-adapter": "^2.32.1",
+    "pi-multi-skills": "^1.1.3"
+  },
+  "pi": {
+    "extensions": [
+      "packages/studio/extensions",
+      "node_modules/@bacnh85/pi-notebooklm/extensions/index.ts",
+      "node_modules/@ff-labs/pi-fff/src/index.ts",
+      "node_modules/@gotgenes/pi-permission-system/src/index.ts",
+      "node_modules/@jachy/pi-git-sync/index.ts",
+      "node_modules/@juicesharp/rpiv-advisor/index.ts",
+      "node_modules/@juicesharp/rpiv-args/index.ts",
+      "node_modules/@juicesharp/rpiv-ask-user-question/index.ts",
+      "node_modules/@juicesharp/rpiv-i18n/index.ts",
+      "node_modules/@juicesharp/rpiv-pi/extensions",
+      "node_modules/@juicesharp/rpiv-todo/index.ts",
+      "node_modules/@juicesharp/rpiv-web-tools/index.ts",
+      "node_modules/@juicesharp/rpiv-workflow/extension.ts",
+      "node_modules/@llblab/pi-telegram/index.ts",
+      "node_modules/@monopi/analytics-extension/index.ts",
+      "node_modules/@monopi/background-tasks/index.ts",
+      "node_modules/@monopi/diagnostics/index.ts",
+      "node_modules/@monopi/extension-git-guard/index.ts",
+      "node_modules/@monopi/extension-watchdog/index.ts",
+      "node_modules/@monopi/remote-tailscale/index.ts",
+      "node_modules/@mrclrchtr/supi-context/src/extension.ts",
+      "node_modules/@mrclrchtr/supi-web/src/extension.ts",
+      "node_modules/@narumitw/pi-worktree/dist/index.ts",
+      "node_modules/@tintinweb/pi-subagents/src/index.ts",
+      "node_modules/pi-agent-browser-native/dist/extensions/agent-browser/index.js",
+      "node_modules/pi-antigravity/src/index.ts",
+      "node_modules/pi-extensible-workflows/dist/src/index.js",
+      "node_modules/pi-extensible-workflows/dist/starter/index.js",
+      "node_modules/pi-extensible-workflows/dist/subagents/index.js",
+      "node_modules/pi-extensible-workflows/dist/trajectory/index.js",
+      "node_modules/pi-hermes-memory/src/index.ts",
+      "node_modules/pi-lens/dist/index.js",
+      "node_modules/pi-mcp-adapter/index.ts",
+      "node_modules/pi-multi-skills/index.ts"
+    ],
+    "skills": [
+      "packages/studio/skills",
+      "node_modules/@bacnh85/pi-notebooklm/skills",
+      "node_modules/@juicesharp/rpiv-pi/skills",
+      "node_modules/@llblab/pi-telegram/skills",
+      "node_modules/pi-lens/skills",
+      "node_modules/pi-mcp-adapter/skills"
+    ],
+    "prompts": [
+      "packages/studio/prompts",
+      "node_modules/pi-extensible-workflows/starter/prompts"
+    ],
+    "themes": [
+      "packages/studio/themes"
+    ]
+  },
+  "files": [
+    "packages/studio/extensions",
+    "packages/studio/themes",
+    "packages/studio/skills",
+    "packages/studio/prompts",
+    "packages/setup/bin",
+    "README.md",
+    "CHANGELOG.md",
+    "docs/feature-catalog.md",
+    "docs/theme-gallery.html",
+    "assets",
+    ".npmrc"
+  ],
+  "overrides": {
+    "@jachy/pi-git-sync": {
+      "@earendil-works/pi-tui": "*"
+    }
+  }
+}

package/packages/setup/bin/setup.mjs

@@ -0,0 +1,430 @@
+#!/usr/bin/env node
+/**
+ * frida-pi-studio-setup — meta-installer del kit (#4):
+ *   npx github:efuentesp/frida-pi-studio [flags]
+ *
+ * Qué hace (idempotente):
+ *   1. Verifica node ≥ 24 y que `pi` exista (si no, imprime cómo
+ *      instalarlo managed y sale 1 — NO instala pi solo).
+ *   2. Resuelve la última versión (gh api → git ls-remote) y detecta
+ *      el transporte (HTTPS con credenciales de gh, o llave SSH) para
+ *      usar la forma de URL correcta (mata el bug v0.1.0).
+ *   3. `pi install <source>` (+ smoke: `pi list` muestra el kit).
+ *   4. Merge (nunca overwrite) de settings: theme default
+ *      "arctic-aurora" (override con --theme).
+ *   5. Checklist de pasos manuales (auth/secrets — patrón buzz-.env).
+ *
+ * Flags: --check (dry-run) · --doctor (diagnóstico) · --version vX.Y.Z
+ *        (pin) · --theme NAME · --local (settings de proyecto) ·
+ *        --remove · --completions bash|zsh|fish · --profile lite|full
+ *        (lite = marca + núcleo; filtra extensions via Package
+ *        Filtering de pi — issue #30)
+ *
+ * Contrato (setup/AGENTS.md): magro, sin deps, sin bundlear el kit.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import os from "node:os";
+import process from "node:process";
+
+const REPO = "efuentesp/frida-pi-studio";
+const DEFAULT_THEME = "arctic-aurora";
+
+// Perfil lite (#30): marca + núcleo. Whitelist por globs de paquete —
+// robusta a renombres de entry-files upstream. Solo extensions v1
+// (skills/prompts son markdown ligero y cargan siempre).
+const LITE_EXTENSIONS = [
+  "packages/studio/**",
+  "node_modules/@ff-labs/pi-fff/**",
+  "node_modules/@gotgenes/pi-permission-system/**",
+  "node_modules/@juicesharp/rpiv-args/**",
+  "node_modules/@juicesharp/rpiv-ask-user-question/**",
+  "node_modules/@juicesharp/rpiv-todo/**",
+  "node_modules/@monopi/background-tasks/**",
+  "node_modules/@monopi/diagnostics/**",
+  "node_modules/@monopi/extension-git-guard/**",
+  "node_modules/@monopi/extension-watchdog/**",
+];
+const args = process.argv.slice(2);
+
+const log = (icon, msg) => console.log(`${icon} ${msg}`);
+const fail = (msg) => {
+  console.error(`✗ ${msg}`);
+  process.exit(1);
+};
+const flag = (name) => {
+  const i = args.indexOf(name);
+  return i === -1 ? undefined : args[i + 1];
+};
+const run = (cmd, cmdArgs, opts = {}) =>
+  spawnSync(cmd, cmdArgs, { encoding: "utf8", ...opts });
+
+function printCompletions() {
+  const shell = flag("--completions");
+  const c = {
+    bash: `_frida_setup() { COMPREPLY=($(compgen -W "--check --doctor --version --theme --profile --local --remove --completions" -- "$2")); };
+complete -F _frida_setup frida-pi-studio-setup npx`,
+    zsh: `#compdef frida-pi-studio-setup
+_frida_setup() { _values "flags" --check --doctor "--version[pin vX.Y.Z]" --theme "--profile[lite|full]" --local --remove --completions; };
+_frida_setup "$@"`,
+    fish: `complete -c frida-pi-studio-setup -a "--check --doctor --version --theme --profile --local --remove --completions"`,
+  }[shell];
+  if (!c) fail("--completions bash|zsh|fish");
+  console.log(c);
+  process.exit(0);
+}
+
+// ── doctor (#29): diagnóstico sin instalar nada ───────────────────
+function doctor() {
+  let bad = 0;
+  const ok = (m) => log("✓", m);
+  const warn = (m) => log("⚠", m);
+  const bad1 = (m) => {
+    log("✗", m);
+    bad += 1;
+  };
+
+  ok(`node ${process.versions.node}`);
+
+  const which = run("which", ["pi"]);
+  const piPath = which.stdout?.trim() ?? "";
+  if (which.status !== 0 || !piPath) {
+    bad1("pi no encontrado — instala layout managed:");
+    console.log(
+      "    curl -fsSL https://pi.dev/install.sh | PI_EXPERIMENTAL=1 sh",
+    );
+    console.log(`    (salgo con el diagnóstico; nada se tocó)`);
+    process.exit(1);
+  }
+  const ver = run(piPath, ["--version"]).stdout?.trim() ?? "?";
+  ok(`pi ${ver} (${piPath})`);
+  if (!piPath.includes(".pi/agent/bin")) {
+    warn(
+      "layout NO managed: `pi update` no funcionará — reinstala con PI_EXPERIMENTAL=1",
+    );
+  }
+
+  const list = run(piPath, ["list"]);
+  const listed = list.stdout ?? "";
+  if (/frida-pi-studio/.test(listed)) {
+    ok("kit instalado (pi list)");
+  } else if (/\.\.\//.test(listed) || /\/repo/.test(listed)) {
+    warn("kit instalado por path local (dev) — el equipo usa la forma git");
+  } else {
+    warn("kit NO instalado — ejecuta este mismo comando sin --doctor");
+  }
+
+  const settingsPath = join(os.homedir(), ".pi", "agent", "settings.json");
+  try {
+    const theme = JSON.parse(readFileSync(settingsPath, "utf8")).theme;
+    if (theme === DEFAULT_THEME || theme === "frida") {
+      ok(`theme activo: ${theme}`);
+    } else {
+      warn(
+        `theme activo: ${theme ?? "(por defecto)"} — kit espera ${DEFAULT_THEME}`,
+      );
+    }
+  } catch {
+    warn(`settings ilegibles o inexistentes (${settingsPath})`);
+  }
+
+  log(
+    bad === 0 ? "✓" : "✗",
+    bad === 0 ? "doctor: sano" : `doctor: ${bad} problema(s)`,
+  );
+  process.exit(bad === 0 ? 0 : 1);
+}
+
+// ── resolución de versión y transporte ───────────────────────────
+function latestTag() {
+  const gh = run("gh", [
+    "api",
+    `repos/${REPO}/releases/latest`,
+    "--jq",
+    ".tag_name",
+  ]);
+  if (gh.status === 0 && /^v\d/.test(gh.stdout?.trim() ?? "")) {
+    return gh.stdout.trim();
+  }
+  const ls = run("git", [
+    "ls-remote",
+    "--tags",
+    "--sort=-v:refname",
+    `https://github.com/${REPO}.git`,
+  ]);
+  const m = ls.stdout?.match(/refs\/tags\/(v[\d.]+)\n/);
+  return m ? m[1] : undefined;
+}
+
+function transportSource(tag) {
+  // HTTPS con credenciales de gh (gh auth setup-git) — forma con slash.
+  const probe = run("git", [
+    "ls-remote",
+    "--exit-code",
+    `https://github.com/${REPO}.git`,
+    tag,
+  ]);
+  if (probe.status === 0) return `git:github.com/${REPO}@${tag}`;
+  // Llave SSH — forma scp (⚠️ jamás git:github.com:… sin git@: bug v0.1.0).
+  const ssh = run("ssh", ["-T", "-o", "BatchMode=yes", "git@github.com"]);
+  if (ssh.status === 1 || /successfully authenticated/.test(ssh.stderr ?? "")) {
+    return `git:git@github.com:${REPO}@${tag}`;
+  }
+  log("⚠", "sin acceso al repo (ni HTTPS con credenciales gh ni llave SSH)");
+  log("ℹ", "ver README §Acceso del equipo: gh auth login + gh auth setup-git");
+  return fail("sin credenciales para github.com");
+}
+
+function resolveSource() {
+  const pinned = flag("--version");
+  const tag = pinned ?? latestTag();
+  if (!tag) fail("no pude resolver la última versión — usa --version vX.Y.Z");
+  log("✓", pinned ? `versión pineada: ${pinned}` : `última versión: ${tag}`);
+  return transportSource(tag);
+}
+
+// ── flujo principal ──────────────────────────────────────────────
+function checkPrereqs() {
+  const [major] = process.versions.node.split(".").map(Number);
+  if (major < 24)
+    fail(`node >= 24 requerido (actual: ${process.versions.node})`);
+  log("✓", `node ${process.versions.node}`);
+
+  const which = run("which", ["pi"]);
+  if (which.status !== 0 || !which.stdout?.trim()) {
+    log("ℹ", "pi no encontrado. Instálalo primero (layout managed):");
+    console.log(
+      "    curl -fsSL https://pi.dev/install.sh | PI_EXPERIMENTAL=1 sh",
+    );
+    console.log(
+      "    (sin PI_EXPERIMENTAL=1 hace npm install y pi update no funciona)",
+    );
+    fail("pi ausente");
+  }
+  log("✓", `pi en ${which.stdout.trim()}`);
+}
+
+function installKit(source, local) {
+  const extra = local ? ["-l"] : [];
+  log("→", `pi install ${source}${local ? " (proyecto)" : ""}`);
+  const install = spawnSync("pi", ["install", ...extra, source], {
+    stdio: "inherit",
+  });
+  if (install.status !== 0) fail("pi install falló");
+
+  // smoke: el paquete aparece en pi list (git/npm → nombre; path → ruta)
+  const list = run("pi", ["list"]);
+  const needle = source.includes("frida-pi-studio")
+    ? "frida-pi-studio"
+    : source;
+  if ((list.stdout ?? "").includes(needle)) {
+    log("✓", "smoke: pi list muestra el kit");
+  } else {
+    log("⚠", "smoke: no vi el kit en pi list — revisa la instalación");
+  }
+}
+
+function settingsPathFor(local) {
+  return local
+    ? join(process.cwd(), ".pi", "settings.json")
+    : join(os.homedir(), ".pi", "agent", "settings.json");
+}
+
+function readSettings(sp) {
+  if (!existsSync(sp)) return {};
+  try {
+    return JSON.parse(readFileSync(sp, "utf8"));
+  } catch {
+    log("⚠", `settings ilegibles (${sp})`);
+    return null;
+  }
+}
+
+function mergeTheme(themeName, local) {
+  const settingsPath = settingsPathFor(local);
+  const settings = readSettings(settingsPath);
+  if (!settings || typeof settings !== "object") return;
+  if (settings.theme === themeName) {
+    log("✓", `theme ya era "${themeName}"`);
+    return;
+  }
+  settings.theme = themeName;
+  writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+  log("✓", `theme → "${themeName}" (merge; el resto intacto)`);
+}
+
+// #30: perfil del kit vía Package Filtering de pi (settings.packages
+// en forma objeto). Entrada plana = full (sin filtro).
+function applyProfile(source, profile, local) {
+  if (profile !== "lite" && profile !== "full") {
+    fail(`--profile espera lite|full (recibí: "${profile}")`);
+  }
+  const settingsPath = settingsPathFor(local);
+  const settings = readSettings(settingsPath);
+  if (!settings || typeof settings !== "object") return;
+  const pkgs = Array.isArray(settings.packages) ? settings.packages : [];
+  const isKit = (entry) => {
+    const s = typeof entry === "string" ? entry : entry?.source;
+    if (typeof s !== "string") return false;
+    if (s === source) return true;
+    if (
+      s.startsWith(`git:github.com/${REPO}`) ||
+      s.startsWith(`git:git@github.com:${REPO}`)
+    ) {
+      return true;
+    }
+    // Fuentes por ruta (dev/E2E): pi las registra relativas al cwd —
+    // comparar por ruta absoluta resuelta.
+    try {
+      return resolve(s) === resolve(source);
+    } catch {
+      return false;
+    }
+  };
+  const i = pkgs.findIndex(isKit);
+  if (i === -1) {
+    log("⚠", "perfil: no encontré el kit en settings.packages — omito");
+    return;
+  }
+  const current = pkgs[i];
+  const src = typeof current === "string" ? current : current.source;
+  pkgs[i] =
+    profile === "lite" ? { source: src, extensions: LITE_EXTENSIONS } : src;
+  settings.packages = pkgs;
+  writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+  log(
+    "✓",
+    profile === "lite"
+      ? `perfil lite: ${LITE_EXTENSIONS.length} grupos de extensiones (Package Filtering)`
+      : "perfil full: sin filtro de extensiones",
+  );
+}
+
+function printChecklist() {
+  console.log("");
+  log("ℹ", "Pasos manuales one-time (secrets, por máquina — jamás al repo):");
+  console.log("    - pi auth login  (o export de API keys del proveedor)");
+  console.log("    - Telegram: /telegram-setup en la sesión pi (si se usa)");
+  console.log("    - devengine: export FRIDA_DEV_ENGINE_API_KEY=… (si se usa)");
+  log("✓", "FRIDA-PI-STUDIO listo — ejecuta `pi` y prueba /frida");
+}
+
+// ── importadores de harness ajenos (#16) ─────────────────────
+function findHarnessConfigs() {
+  const proj = process.cwd();
+  const found = [];
+  const push = (harness, abs) =>
+    found.push({ harness, abs, rel: relative(proj, abs) });
+  const files = [
+    ["Claude Code", "CLAUDE.md"],
+    ["Cursor", ".cursorrules"],
+    ["Cline", ".clinerules"],
+    ["Copilot", ".github/copilot-instructions.md"],
+    ["Windsurf", ".windsurfrules"],
+  ];
+  for (const [h, rel] of files) {
+    if (existsSync(join(proj, rel))) push(h, join(proj, rel));
+  }
+  const dirs = [
+    ["Claude Code", ".claude/commands"],
+    ["Cursor", ".cursor/rules"],
+  ];
+  for (const [h, dir] of dirs) {
+    const abs = join(proj, dir);
+    if (!existsSync(abs)) continue;
+    try {
+      for (const f of readdirSync(abs)) {
+        if (/\.(md|mdc)$/i.test(f)) push(h, join(abs, f));
+      }
+    } catch {
+      /* dir ilegible — seguir */
+    }
+  }
+  const homeClaude = join(os.homedir(), ".claude", "CLAUDE.md");
+  if (existsSync(homeClaude)) {
+    found.push({
+      harness: "Claude Code (global)",
+      abs: homeClaude,
+      rel: homeClaude,
+    });
+  }
+  return found;
+}
+
+function scanImports() {
+  const found = findHarnessConfigs();
+  if (found.length === 0) {
+    log("ℹ", "sin configs de otros harness en este proyecto/home");
+    process.exit(0);
+  }
+  log("✓", `${found.length} config(s) de otros harness detectadas:`);
+  for (const f of found) {
+    const lines = readFileSync(f.abs, "utf8").split("\n").length;
+    console.log(`    ${f.harness.padEnd(18)} ${f.rel} (${lines} líneas)`);
+  }
+  log("ℹ", "importar: `npx github:efuentesp/frida-pi-studio --import`");
+  process.exit(0);
+}
+
+function importConfigs() {
+  const found = findHarnessConfigs();
+  if (found.length === 0) {
+    log("ℹ", "nada que importar");
+    process.exit(0);
+  }
+  const target = join(process.cwd(), "AGENTS.md");
+  let current = existsSync(target) ? readFileSync(target, "utf8") : "";
+  let added = 0;
+  let skipped = 0;
+  for (const f of found) {
+    const header = `## Importado de ${f.harness} — ${f.rel}`;
+    if (current.includes(header)) {
+      skipped += 1;
+      continue;
+    }
+    if (added === 0 && existsSync(target)) {
+      writeFileSync(`${target}.bak`, current);
+      log("ℹ", `backup: AGENTS.md.bak`);
+    }
+    const body = readFileSync(f.abs, "utf8").trimEnd();
+    current += `\n\n${header}\n\n${body}\n`;
+    added += 1;
+  }
+  if (added > 0) {
+    writeFileSync(target, current);
+    log("✓", `importadas ${added} config(s) a AGENTS.md (pi las lee nativo)`);
+  }
+  if (skipped > 0) log("ℹ", `${skipped} ya importada(s) antes — idempotente`);
+  process.exit(0);
+}
+
+// Completions primero: salida limpia, sin prerequisitos ni logs.
+if (args.includes("--completions")) printCompletions();
+if (args.includes("--doctor")) doctor();
+if (args.includes("--scan-imports")) scanImports();
+if (args.includes("--import")) importConfigs();
+
+checkPrereqs();
+
+if (args.includes("--remove")) {
+  log("→", `pi remove git:github.com/${REPO}`);
+  const rm = spawnSync("pi", ["remove", `git:github.com/${REPO}`], {
+    stdio: "inherit",
+  });
+  if (rm.status !== 0) fail("pi remove falló (¿estaba instalado?)");
+  log("✓", "kit removido");
+  process.exit(0);
+}
+
+if (args.includes("--check")) {
+  log("ℹ", "--check: prerequisitos OK, sin instalar nada más");
+  process.exit(0);
+}
+
+const source = flag("--source") ?? resolveSource();
+const local = args.includes("--local");
+installKit(source, local);
+mergeTheme(flag("--theme") ?? DEFAULT_THEME, local);
+applyProfile(source, flag("--profile") ?? "full", local);
+printChecklist();