jorgex-stack 1.9.29 → 1.9.31

package/README.md

@@ -120,7 +120,7 @@ pnpm dlx jorgex-stack@1.9.7 sync --agents pi
 pnpm dlx jorgex-stack@1.9.7 uninstall --agents pi
 ```
 
-Stack downloads the frozen registry tarball, verifies its exact size plus SHA-256/SHA-512, backs up Pi's `settings.json`, and only then asks Pi to install that local file. The historical `0.8.0` tarball was `89128340` bytes; the exact adopted artifact and integrity values are authoritative in `src/lib/pi-runtime-pin.json`, while the lifecycle remains authoritative in `src/lib/pi-runtime.ts`. Pi's own package-manager invocation is the narrow runtime exception to the repository's pnpm-only rule; the Stack lifecycle never launches npm directly. After the package is healthy, Stack projects the shared resources into Pi: marked `jorgex:system-prompt` and `jorgex:engram-protocol` sections in `~/.pi/agent/AGENTS.md`, canonical skills under `~/.agents/skills`, and `~/.pi/agent/prompts/lean-audit.md`. When the managed Playwright preference is active, the projection also adds or removes the marked `jorgex:browser` section dynamically. The Pi-only `install --agents pi --playwright` flow installs and persists that Playwright capability just like the other harnesses. Chrome DevTools MCP and Context7 remain outside the Pi scope. The published `1.9.7` entry `{ "source": "npm:jorgex-pi@0.8.4", "skills": [], "prompts": [] }` and the `0.8.5` snapshot reference are historical; they do not describe the adopted pin. Filters are applied only after this projection exists, so the package does not duplicate shared resources. Package ownership is recorded separately in `~/.jorgex-stack/pi-receipt.json`; projection ownership is recorded in `~/.jorgex-stack/pi-projection-receipt.json`. Both receipts are scope-bound and fail closed for manual, duplicate, divergent, partial, corrupt, copied-to-another-scope, or unknown-history state.
+Stack downloads the frozen registry tarball, verifies its exact size plus SHA-256/SHA-512, backs up Pi's `settings.json`, and only then asks Pi to install that local file. The historical `0.8.0` tarball was `89128340` bytes; the exact adopted artifact and integrity values are authoritative in `src/lib/pi-runtime-pin.json`, while the lifecycle remains authoritative in `src/lib/pi-runtime.ts`. Pi's own package-manager invocation is the narrow runtime exception to the repository's pnpm-only rule; the Stack lifecycle never launches npm directly. After the package is healthy, Stack projects the shared resources into Pi: marked `jorgex:system-prompt` and `jorgex:engram-protocol` sections in `~/.pi/agent/AGENTS.md`, canonical skills under `~/.agents/skills`, and `~/.pi/agent/prompts/lean-audit.md`. When the managed Playwright preference is active, the projection also adds or removes the marked `jorgex:browser` section dynamically. The Pi-only `install --agents pi --playwright` flow installs and persists that Playwright capability just like the other harnesses. The adopted Pi `0.8.13` candidate also supports the optional Chrome DevTools handoff; Stack persists the selected handoff as part of the Pi projection and records its SHA-256 in the optional `devtools.sha256` field of `~/.jorgex-stack/pi-projection-receipt.json` after a successful operation. Context7 remains outside the Pi scope. The published `1.9.7` entry `{ "source": "npm:jorgex-pi@0.8.4", "skills": [], "prompts": [] }` and the `0.8.5` snapshot reference are historical; they do not describe the adopted pin. Filters are applied only after this projection exists, so the package does not duplicate shared resources. Package ownership is recorded separately in `~/.jorgex-stack/pi-receipt.json`; projection ownership is recorded in `~/.jorgex-stack/pi-projection-receipt.json`. Package receipts reject manual, duplicate, divergent, partial, corrupt, copied-to-another-scope, or unknown-history state. Projection cleanup requires an exact scope-bound ownership receipt; DevTools conflicts preserve the handoff for review.
 
 Historically, the published Pi 0.8.0 direct-package snapshot added `work-audit`: the snapshot grew from **17 to 18 skill trees** (96 to 97 files), and the active runtime allowlist grew from **16 to 17 skills**. The historical Pi 0.8.5 snapshot reference records 18 skill trees and 98 files; it does not describe the adopted pin. Reference F2-A is included while the private F1 skills remain preserved. `playwright-cli` remains in the snapshot but inactive because browser automation is a separate opt-in integration.
 
@@ -159,6 +159,8 @@ pnpm dlx jorgex-stack install --yes --playwright
 # Enable Chrome DevTools MCP explicitly per runtime.
 pnpm dlx jorgex-stack install --devtools
 pnpm dlx jorgex-stack install --no-devtools
+pnpm dlx jorgex-stack install --agents pi --devtools
+pnpm dlx jorgex-stack sync --agents pi --no-devtools
 ```
 
 Under the hood, `--playwright` runs two `pnpm` argv-only plans back to back: `pnpm add --global @playwright/cli@0.1.18` (the package) and then `pnpm dlx @playwright/cli@0.1.18 install-browser` (the browser binary cache). Removal is `pnpm remove --global @playwright/cli` (no version suffix). If installation fails, the error identifies the failed phase — global package, browser download, or preference persistence — and recommends `jorgex-stack install --playwright`; the preference is not marked enabled unless the complete plan succeeds.

package/dist/cli.js

@@ -2257,10 +2257,12 @@ function executePlaywrightToolAction(action, pnpmBin = resolvePnpmBin(), env) {
     const preflight = planDetectedBinCommand(pnpmBin, ["bin", "--global"]);
     if (preflight === null) return { ok: false, reason: "pnpm-command" };
     try {
-      execFileSync2(preflight.command, preflight.args, {
-        stdio: "inherit",
+      const globalBin = execFileSync2(preflight.command, preflight.args, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "inherit"],
         ...env === void 0 ? {} : { env }
       });
+      if (globalBin.trim() === "") return { ok: false, reason: "pnpm-global-bin" };
     } catch (error) {
       return { ok: false, reason: hasNonzeroProcessStatus(error) ? "pnpm-global-bin" : "pnpm-command" };
     }
@@ -2341,7 +2343,7 @@ function parseDevtoolsMcpState(raw) {
     if (!isRecord2(value) || value.version !== DEVTOOLS_MCP_PREFERENCE_VERSION || !isRecord2(value.enabled) || !isRecord2(value.owned)) return null;
     const enabled = {};
     for (const [runtime, selected] of Object.entries(value.enabled)) {
-      if (!isRuntimeId(runtime) || typeof selected !== "boolean") return null;
+      if (!isRuntimeId(runtime) && runtime !== "pi" || typeof selected !== "boolean") return null;
       enabled[runtime] = selected;
     }
     const owned = {};
@@ -2844,6 +2846,7 @@ import * as p2 from "@clack/prompts";
 // src/lib/pi-projection-lifecycle.ts
 import fs16 from "fs";
 import path23 from "path";
+import { createHash } from "crypto";
 
 // src/adapters/pi.ts
 import path21 from "path";
@@ -3307,14 +3310,33 @@ function projectionPlan(input, scope) {
     engramBin: input.engramBin,
     models: DEFAULT_MODEL_MAP.codex,
     warnings: [],
-    playwrightCliEnabled: input.playwrightCliEnabled
+    playwrightCliEnabled: input.playwrightCliEnabled,
+    enabledMcpServers: input.devtoolsMcpEnabled ? /* @__PURE__ */ new Set([DEVTOOLS_MCP_SERVER]) : void 0
   };
   const adapter = projectedPiAdapter(scope);
-  return [
+  const actions = [
     ...planSystemPrompt(adapter, ctx),
     ...planSkills(adapter, ctx),
     ...planCommands(adapter, ctx)
   ];
+  if (input.devtoolsMcpEnabled && input.pnpmBin) {
+    const server = loadCanonicalMcp(input.stackDir).servers[DEVTOOLS_MCP_SERVER];
+    if (server?.transport !== "stdio" || !Array.isArray(server.args)) throw new Error("Falta la configuraci\xF3n can\xF3nica de DevTools.");
+    actions.push({ kind: "write", target: devtoolsPath(scope), content: `${JSON.stringify({
+      schemaVersion: 1,
+      enabled: true,
+      command: input.pnpmBin,
+      args: server.args
+    }, null, 2)}
+` });
+  }
+  return actions;
+}
+function devtoolsPath(scope) {
+  return path23.resolve(scope.codingAgentDir, "jorgex-pi", "devtools.v1.json");
+}
+function contentHash(content) {
+  return createHash("sha256").update(content).digest("hex");
 }
 function canonicalActionContent(action) {
   return action.kind === "write" ? action.content : fs16.readFileSync(action.source, "utf8");
@@ -3322,8 +3344,15 @@ function canonicalActionContent(action) {
 function hasActionDrift(action, deps) {
   return deps.readText(action.target) !== canonicalActionContent(action);
 }
-function applyActions(actions, deps) {
+function applyActions(actions, deps, handoff) {
   for (const action of actions) {
+    if (handoff && path23.resolve(action.target) === handoff.file) {
+      try {
+        if (deps.readText(handoff.file) !== handoff.previous) return devtoolsConflict(handoff.file);
+      } catch {
+        return devtoolsConflict(handoff.file);
+      }
+    }
     if (action.kind === "write") deps.writeText(action.target, action.content);
     else deps.copyFile(action.source, action.target);
   }
@@ -3340,6 +3369,7 @@ function receiptFor(plan, scope) {
   const owned = [...new Set(
     plan.map((action) => path23.resolve(action.target)).filter((target) => target !== systemPrompt)
   )];
+  const handoff = plan.find((action) => path23.resolve(action.target) === devtoolsPath(scope));
   return {
     schemaVersion: 1,
     scope: {
@@ -3348,7 +3378,8 @@ function receiptFor(plan, scope) {
       codingAgentDir: scope.codingAgentDir,
       receiptFile: scope.receiptFile
     },
-    owned
+    owned,
+    ...handoff ? { devtools: { sha256: contentHash(canonicalActionContent(handoff)) } } : {}
   };
 }
 function receiptContent(receipt) {
@@ -3367,16 +3398,25 @@ function parseReceipt2(raw, expected) {
     const version = Reflect.get(receipt, "schemaVersion");
     const receivedScope = Reflect.get(receipt, "scope");
     const owned = Reflect.get(receipt, "owned");
-    if (version !== expected.schemaVersion || !hasExactKeys(receipt, ["schemaVersion", "scope", "owned"]) || receivedScope === null || typeof receivedScope !== "object" || Array.isArray(receivedScope) || !hasExactKeys(receivedScope, ["kind", "home", "codingAgentDir", "receiptFile"])) {
-      return null;
-    }
-    if (Reflect.get(receivedScope, "kind") !== expected.scope.kind || Reflect.get(receivedScope, "home") !== expected.scope.home || Reflect.get(receivedScope, "codingAgentDir") !== expected.scope.codingAgentDir || Reflect.get(receivedScope, "receiptFile") !== expected.scope.receiptFile || !Array.isArray(owned) || owned.length !== expected.owned.length) {
+    const devtools = Reflect.get(receipt, "devtools");
+    const hasDevtools = Object.hasOwn(receipt, "devtools");
+    if (version !== expected.schemaVersion || !hasExactKeys(receipt, ["schemaVersion", "scope", "owned", ...hasDevtools ? ["devtools"] : []]) || receivedScope === null || typeof receivedScope !== "object" || Array.isArray(receivedScope) || !hasExactKeys(receivedScope, ["kind", "home", "codingAgentDir", "receiptFile"])) {
       return null;
     }
-    if (!owned.every((file, index) => typeof file === "string" && file === expected.owned[index])) {
+    if (Reflect.get(receivedScope, "kind") !== expected.scope.kind || Reflect.get(receivedScope, "home") !== expected.scope.home || Reflect.get(receivedScope, "codingAgentDir") !== expected.scope.codingAgentDir || Reflect.get(receivedScope, "receiptFile") !== expected.scope.receiptFile || !Array.isArray(owned)) {
       return null;
     }
-    return expected;
+    if (hasDevtools && (devtools === null || typeof devtools !== "object" || Array.isArray(devtools) || !hasExactKeys(devtools, ["sha256"]) || typeof Reflect.get(devtools, "sha256") !== "string" || !/^[a-f0-9]{64}$/.test(Reflect.get(devtools, "sha256")))) return null;
+    const handoff = devtoolsPath(expected.scope);
+    const expectedOwned = expected.owned.filter((file) => file !== handoff);
+    if (hasDevtools) expectedOwned.push(handoff);
+    if (owned.length !== expectedOwned.length || !owned.every((file, index) => typeof file === "string" && file === expectedOwned[index])) return null;
+    return {
+      schemaVersion: 1,
+      scope: expected.scope,
+      owned: expectedOwned,
+      ...hasDevtools ? { devtools: { sha256: Reflect.get(devtools, "sha256") } } : {}
+    };
   } catch {
     return null;
   }
@@ -3502,6 +3542,35 @@ function readProjectionReceipt(receiptFile, deps) {
     return { kind: "unreadable" };
   }
 }
+function devtoolsConflict(file) {
+  return blocked2(
+    "projection-devtools-conflict",
+    [file],
+    "El handoff de DevTools es ajeno o fue modificado. Cons\xE9rvalo y revisa su propiedad antes de reintentar; Stack no lo sobrescribe ni elimina."
+  );
+}
+function inspectDevtools(input, scope, expected, deps) {
+  const file = devtoolsPath(scope);
+  const read = readProjectionReceipt(scope.receiptFile, deps);
+  if (read.kind === "unreadable") return receiptUnreadable(scope.receiptFile);
+  const previous = read.kind === "present" ? parseReceipt2(read.content, expected) : null;
+  let content;
+  try {
+    content = deps.readText(file);
+  } catch {
+    return devtoolsConflict(file);
+  }
+  let recordedDevtools = false;
+  if (read.kind === "present") {
+    try {
+      recordedDevtools = Object.hasOwn(JSON.parse(read.content), "devtools");
+    } catch {
+    }
+    if (!previous && (input.devtoolsMcpEnabled || content !== null || recordedDevtools)) return receiptInvalid(scope.receiptFile);
+  }
+  if (content !== null && (!previous?.devtools || contentHash(content) !== previous.devtools.sha256)) return devtoolsConflict(file);
+  return { kind: "checked", previous, content };
+}
 function preparePiProjectionUninstall(input, deps) {
   if (input.operation !== "uninstall") {
     return cleanupFailure([]);
@@ -3520,11 +3589,13 @@ function preparePiProjectionUninstall(input, deps) {
   const receiptRead = readProjectionReceipt(scope.receiptFile, deps);
   if (receiptRead.kind === "unreadable") return receiptUnreadable(scope.receiptFile);
   let ownedToRemove = [];
+  let ownedReceipt = null;
   let receiptFile = null;
   let backupTargets = promptUpdate === null ? [] : [promptUpdate.file];
   if (receiptRead.kind === "present") {
     const receipt = parseReceipt2(receiptRead.content, expectedReceipt2);
     if (receipt === null) return receiptInvalid(scope.receiptFile);
+    ownedReceipt = receipt;
     let retained;
     try {
       retained = manifestOwned(deps.readManifest());
@@ -3535,13 +3606,22 @@ function preparePiProjectionUninstall(input, deps) {
     receiptFile = path23.resolve(scope.receiptFile);
     backupTargets = [...backupTargets, ...receipt.owned, receiptFile];
   }
+  const handoff = devtoolsPath(scope);
+  let handoffContent;
+  try {
+    handoffContent = deps.readText(handoff);
+  } catch {
+    return devtoolsConflict(handoff);
+  }
+  if (handoffContent !== null && (!ownedReceipt?.devtools || contentHash(handoffContent) !== ownedReceipt.devtools.sha256)) return devtoolsConflict(handoff);
   const backup = backupExisting(backupTargets, deps);
   if (backup.kind === "backup-failed") return backupFailure(backup.paths);
   const token = {};
   preparedPiProjectionUninstalls.set(token, {
     prompt: promptUpdate,
     ownedToRemove,
-    receiptFile
+    receiptFile,
+    ...ownedReceipt?.devtools ? { devtools: { file: handoff, sha256: ownedReceipt.devtools.sha256 } } : {}
   });
   return { kind: "prepared", plan: token };
 }
@@ -3553,6 +3633,15 @@ function completePiProjectionUninstall(plan, deps) {
   if (prepared === void 0) {
     return cleanupFailure([]);
   }
+  if (prepared.devtools) {
+    let current;
+    try {
+      current = deps.readText(prepared.devtools.file);
+    } catch {
+      return devtoolsConflict(prepared.devtools.file);
+    }
+    if (current !== null && contentHash(current) !== prepared.devtools.sha256) return devtoolsConflict(prepared.devtools.file);
+  }
   if (prepared.prompt !== null) {
     try {
       deps.writeText(prepared.prompt.file, prepared.prompt.content);
@@ -3562,6 +3651,10 @@ function completePiProjectionUninstall(plan, deps) {
   }
   for (const owned of prepared.ownedToRemove) {
     try {
+      if (prepared.devtools?.file === owned) {
+        const current = deps.readText(owned);
+        if (current !== null && contentHash(current) !== prepared.devtools.sha256) return devtoolsConflict(owned);
+      }
       deps.removeFile(owned);
     } catch {
       return cleanupFailure([owned]);
@@ -3582,13 +3675,23 @@ function runPiProjectionLifecycle(input, deps) {
     const prepared = preparePiProjectionUninstall(input, deps);
     return prepared.kind === "blocked" ? prepared : completePiProjectionUninstall(prepared.plan, deps);
   }
+  if (input.devtoolsMcpEnabled && (!input.pnpmBin || !path23.isAbsolute(input.pnpmBin))) {
+    return blocked2("projection-devtools-command", [devtoolsPath(scope)], "DevTools requiere un ejecutable pnpm absoluto disponible en PATH.");
+  }
   const plan = projectionPlan(input, scope);
   assertPlanContained(plan, scope);
   const receipt = receiptFor(plan, scope);
+  const devtools = inspectDevtools(input, scope, receipt, deps);
+  if (devtools.kind === "blocked") return input.operation === "doctor" ? { kind: "drift", paths: devtools.paths } : devtools;
+  const removeHandoff = !input.devtoolsMcpEnabled && devtools.previous?.devtools !== void 0 && devtools.content !== null;
   const expectedReceipt2 = receiptContent(receipt);
   const drifted = plan.filter((action) => hasActionDrift(action, deps));
+  if (input.devtoolsMcpEnabled && devtools.previous?.devtools?.sha256 !== receipt.devtools?.sha256 && !drifted.some((action) => path23.resolve(action.target) === devtoolsPath(scope))) {
+    return input.operation === "doctor" ? { kind: "drift", paths: [devtoolsPath(scope)] } : devtoolsConflict(devtoolsPath(scope));
+  }
   if (input.operation === "doctor") {
     const paths = drifted.map((action) => path23.resolve(action.target));
+    if (removeHandoff) paths.push(devtoolsPath(scope));
     const currentSettings2 = deps.readText(scope.settingsFile);
     if (currentSettings2 === null || filterProjectedPiPackage(currentSettings2, input.packageSource) !== currentSettings2) {
       paths.push(scope.settingsFile);
@@ -3604,19 +3707,30 @@ function runPiProjectionLifecycle(input, deps) {
   }
   const packageWillChange = filteredSettings !== null && filteredSettings !== currentSettings;
   const receiptChanged = deps.readText(scope.receiptFile) !== expectedReceipt2;
-  if (drifted.length > 0 || packageWillChange || receiptChanged) {
+  if (drifted.length > 0 || packageWillChange || receiptChanged || removeHandoff) {
     const backup = backupExisting([
       ...drifted.map((action) => action.target),
+      ...removeHandoff ? [devtoolsPath(scope)] : [],
       ...packageWillChange ? [scope.settingsFile] : [],
       ...receiptChanged ? [scope.receiptFile] : []
     ], deps);
     if (backup.kind === "backup-failed") return backupFailure(backup.paths);
   }
-  applyActions(drifted, deps);
+  if (removeHandoff) {
+    try {
+      const current = deps.readText(devtoolsPath(scope));
+      if (current !== null && contentHash(current) !== devtools.previous?.devtools?.sha256) return devtoolsConflict(devtoolsPath(scope));
+      deps.removeFile(devtoolsPath(scope));
+    } catch {
+      return cleanupFailure([devtoolsPath(scope)]);
+    }
+  }
+  const writeResult = applyActions(drifted, deps, input.devtoolsMcpEnabled ? { file: devtoolsPath(scope), previous: devtools.content } : void 0);
+  if (writeResult) return writeResult;
   if (packageWillChange && filteredSettings !== null) deps.writeText(scope.settingsFile, filteredSettings);
   if (receiptChanged) deps.writeText(scope.receiptFile, expectedReceipt2);
   if (input.operation === "install") return { kind: "installed", receipt };
-  return { kind: "synced", changed: drifted.length > 0 || packageWillChange || receiptChanged };
+  return { kind: "synced", changed: drifted.length > 0 || packageWillChange || receiptChanged || removeHandoff };
 }
 function systemProjectionLifecycle(input) {
   const targetRoot = input.targetDir === void 0 ? null : path23.resolve(input.targetDir);
@@ -3633,7 +3747,9 @@ function systemProjectionLifecycle(input) {
       packageSource: input.packageSource,
       stackDir: stackRoot(),
       engramBin: input.engramBin ?? "",
-      playwrightCliEnabled: input.playwrightCliEnabled
+      playwrightCliEnabled: input.playwrightCliEnabled,
+      devtoolsMcpEnabled: input.devtoolsMcpEnabled,
+      pnpmBin: input.pnpmBin
     },
     deps: {
       readText: readTextOnlyIfMissing,
@@ -5218,22 +5334,22 @@ import os4 from "os";
 import path31 from "path";
 import fs23 from "fs";
 import { spawnSync } from "child_process";
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 
 // src/lib/pi-runtime-pin.json
 var pi_runtime_pin_default = {
   package: {
     name: "jorgex-pi",
-    version: "0.8.12",
-    source: "npm:jorgex-pi@0.8.12"
+    version: "0.8.13",
+    source: "npm:jorgex-pi@0.8.13"
   },
   provenance: {
-    commit: "a041e8f290021b5a6bb161db77e03663f37c82cb"
+    commit: "e28a677da0a112925251cf11269b70cb5c8aa15e"
   },
   tarball: {
-    bytes: 89141968,
-    sha256: "eb7739852504bf4cd8cdd9f260c67da979728378a756db7f1ff6b0c1d60368c6",
-    sha512: "a37b36e5c846e1694db3c7bd7e9acf23f39b8ba45d348bf039fd218f90f041a6d95268af2e3b6248fc4e759dfd6441df1c44490411c1e13c2b0cedbc0ef526b2"
+    bytes: 89143404,
+    sha256: "6bbe877249b900af582c8881e0dd7993951ea1cef6e7252522c626c078de7478",
+    sha512: "bb527d1f3812406f2184f778b22cca00ead33692fecac0012cf8cdcdc469b7cccf3c789c35b4327dd599d06542162bd07eefeeaaa40de19662ec5fc422b14af8"
   }
 };
 
@@ -5255,6 +5371,7 @@ var PI_RUNTIME_CANDIDATE = {
       "goal-continuation-v1",
       "mcp-adapter-v1",
       "engram-runtime-tools-v1",
+      "chrome-devtools-handoff-v1",
       "runner-json-v1",
       "tui-branding-v1",
       "managed-primary-model-v1",
@@ -5607,8 +5724,8 @@ function readOptional(file, fallback) {
 }
 function hashPiTarball(file) {
   const descriptor = fs23.openSync(file, "r");
-  const sha2562 = createHash("sha256");
-  const sha512 = createHash("sha512");
+  const sha2562 = createHash2("sha256");
+  const sha512 = createHash2("sha512");
   const buffer = Buffer.allocUnsafe(1024 * 1024);
   let bytes = 0;
   try {
@@ -5826,36 +5943,44 @@ function managedPackageResult(result) {
   return result;
 }
 async function runManagedPiSystem(input) {
+  const { devtoolsMcpEnabled: explicitDevtools, ...runtimeInput } = input;
+  const devtoolsMcpEnabled = explicitDevtools ?? (input.targetDir === void 0 && loadDevtoolsMcpPreference(devtoolsMcpPreferenceFile(), "pi"));
   const playwrightCliEnabled = input.targetDir === void 0 && loadPlaywrightCliPreference() === true;
   const projectionInput = {
     targetDir: input.targetDir,
     packageSource: PI_RUNTIME_CANDIDATE.package.source,
     engramBin: input.engramBin,
-    playwrightCliEnabled
+    playwrightCliEnabled,
+    devtoolsMcpEnabled,
+    pnpmBin: devtoolsMcpEnabled && input.operation !== "uninstall" ? resolvePnpmBin() : null
   };
-  return runManagedPiOperation(input.operation, {
+  const result = await runManagedPiOperation(input.operation, {
     async runPackage(operation) {
-      return managedPackageResult(await runPiRuntimeSystem({ ...input, operation }));
+      return managedPackageResult(await runPiRuntimeSystem({ ...runtimeInput, operation }));
     },
     runProjection(operation) {
-      const result = runPiProjectionLifecycleSystem({
+      const result2 = runPiProjectionLifecycleSystem({
         operation,
         ...projectionInput
       });
-      return Promise.resolve(result.kind === "drift" ? {
+      return Promise.resolve(result2.kind === "drift" ? {
         kind: "drift",
-        paths: result.paths,
+        paths: result2.paths,
         remedy: "Ejecuta sync --agents pi para reparar la proyecci\xF3n de Pi."
-      } : result);
+      } : result2);
     },
     prepareProjectionUninstall() {
-      const result = preparePiProjectionUninstallSystem({ operation: "uninstall", ...projectionInput });
-      return Promise.resolve(result.kind === "prepared" ? { kind: "prepared", token: result.plan } : result);
+      const result2 = preparePiProjectionUninstallSystem({ operation: "uninstall", ...projectionInput });
+      return Promise.resolve(result2.kind === "prepared" ? { kind: "prepared", token: result2.plan } : result2);
     },
     completeProjectionUninstall(token) {
       return Promise.resolve(completePiProjectionUninstallSystem(token, { operation: "uninstall", ...projectionInput }));
     }
   });
+  if (input.targetDir === void 0 && explicitDevtools !== void 0 && (input.operation === "install" || input.operation === "sync") && result.kind !== "blocked") {
+    saveDevtoolsMcpPreference(devtoolsMcpPreferenceFile(), "pi", explicitDevtools);
+  }
+  return result;
 }
 
 // src/lib/quality-runner.ts
@@ -6241,7 +6366,7 @@ import fs24 from "fs";
 import os5 from "os";
 import path33 from "path";
 import { execFileSync as execFileSync7 } from "child_process";
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash3 } from "crypto";
 
 // src/lib/engram-release.json
 var engram_release_default = {
@@ -6318,7 +6443,7 @@ async function installMissingEngram(options = {}) {
       await reader.cancel();
     }
     const archive = Buffer.concat(chunks);
-    if (size !== asset.size || createHash2("sha256").update(archive).digest("hex") !== asset.sha256) {
+    if (size !== asset.size || createHash3("sha256").update(archive).digest("hex") !== asset.sha256) {
       throw new Error("Engram: tama\xF1o o hash SHA-256 no coincide con el artefacto aprobado.");
     }
     fs24.mkdirSync(path33.dirname(bin), { recursive: true });
@@ -6544,8 +6669,9 @@ async function resolveDevtoolsMcpSelection(command, flags, runtimes) {
   }
   const file = devtoolsMcpPreferenceFile();
   const selected = await p6.multiselect({
-    message: "Chrome DevTools MCP avanzado (full: ~29 tools y ~5.8\u20137.7k tokens de schemas). \xBFEn qu\xE9 runtimes activarlo?",
-    options: runtimes.map((runtime) => ({ value: runtime, label: ADAPTERS[runtime]?.name ?? runtime })),
+    message: "Chrome DevTools MCP avanzado (opcional). \xBFEn qu\xE9 runtimes activarlo?",
+    required: false,
+    options: runtimes.map((runtime) => ({ value: runtime, label: runtime === "pi" ? "Pi" : ADAPTERS[runtime]?.name ?? runtime })),
     initialValues: runtimes.filter((runtime) => loadDevtoolsMcpPreference(file, runtime))
   });
   if (p6.isCancel(selected)) return null;
@@ -6617,7 +6743,7 @@ async function resolveHostEngramForInstall(flags) {
     return { ok: false, message: `Engram: ${error instanceof Error ? error.message : String(error)}` };
   }
 }
-async function runSelectedPi(operation, targetDir, yes = false, resolvedEngramBin) {
+async function runSelectedPi(operation, targetDir, yes = false, resolvedEngramBin, devtoolsMcpEnabled) {
   if (targetDir === void 0 && operation !== "models") {
     const preferenceErrors = browserPreferenceErrors();
     if (preferenceErrors.length > 0) {
@@ -6659,7 +6785,8 @@ async function runSelectedPi(operation, targetDir, yes = false, resolvedEngramBi
     operation,
     targetDir,
     detected: { executable: detected.executable, version: detected.version },
-    engramBin
+    engramBin,
+    ...devtoolsMcpEnabled === void 0 ? {} : { devtoolsMcpEnabled }
   });
   if (result.kind === "blocked") {
     const paths = "paths" in result ? `: ${result.paths.join(", ")}` : "";
@@ -6795,7 +6922,7 @@ Flags disponibles: jorgex-stack --help`
         }
         const mode = fileRuntimes.length > 0 ? await resolveInstallMode(flags) : void 0;
         if (mode === null) return;
-        const devtoolsMcpSelection = await resolveDevtoolsMcpSelection(command, flags, fileRuntimes);
+        const devtoolsMcpSelection = await resolveDevtoolsMcpSelection(command, flags, runtimes);
         if (devtoolsMcpSelection === null) {
           exitCode = process.exitCode === 1 ? 1 : 0;
           return;
@@ -6852,7 +6979,8 @@ Flags disponibles: jorgex-stack --help`
             command,
             flags.targetDir,
             flags.yes,
-            flags.targetDir === void 0 ? engramBin : void 0
+            flags.targetDir === void 0 ? engramBin : void 0,
+            devtoolsMcpSelection.pi
           ));
         }
         completed = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jorgex-stack",
-  "version": "1.9.29",
+  "version": "1.9.31",
   "description": "Harness multi-agente portable: instala la config JorgeX (agentes, skills, hooks, Engram, MCPs) en Claude Code, Codex CLI, OpenCode y Pi",
   "type": "module",
   "license": "MIT",