jorgex-stack 1.9.32 → 1.9.33

package/README.md

@@ -42,6 +42,14 @@ pnpm dlx jorgex-stack install
 pnpm dlx jorgex-stack sync
 ```
 
+For a fresh Engram installation, always consult the current published Stack and bypass only the `pnpm dlx` cache:
+
+```bash
+pnpm --config.dlx-cache-max-age=0 dlx jorgex-stack@latest install --engram
+```
+
+`dlx-cache-max-age` is separate from the pnpm 11 dependency-age filter: it controls only the cached `dlx` package, while `minimumReleaseAgeExclude` applies only to the named package resolution. An explicit Stack version such as `@1.9.30` does not reuse the cache entry for another version. Do not use `@latest` for Pi; Pi consumption still requires its exact validated pin.
+
 Other important commands:
 
 ```bash
@@ -120,7 +128,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 global Playwright package and Chromium cache are shared by the machine; `--playwright-runtimes` controls which runtime receives the guide. Pi is selectable only when the adopted package declares `playwright-handoff-v1`; otherwise Stack reports that it can install the global capability but cannot project it into Pi yet. 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.
+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 global Playwright package and Chromium cache are shared by the machine; `--playwright-runtimes` controls which runtime receives the guide. The pin vigente declara `playwright-handoff-v1`, por lo que Pi puede seleccionarse y recibe su handoff de Playwright además de la guía. El paquete Pi fijado también soporta el handoff opcional de Chrome DevTools; Stack persiste cada handoff como parte de la proyección y registra su SHA-256 en el receipt correspondiente tras una operación correcta. 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.
 
@@ -136,7 +144,7 @@ Engram remains mandatory and user-owned. An existing binary is preserved. `insta
 
 Históricamente, Stack `1.9.7` reconocía el receipt exacto de Pi `npm:jorgex-pi@0.8.4`. Usa versiones exactas, nunca `latest`, y no edites receipts o hashes ni borres `HOME`, Engram o la proyección de otro runtime para forzar confianza. El pin y los comandos actuales de transición y rollback están en [docs/references/pi-runtime.md](docs/references/pi-runtime.md).
 
-The 24-hour managed-consumption maturity rule applies only to real installation or consumption of the new Pi package; development, PR validation, merge and Stack publication may proceed immediately. Installing it on a real user scope before the maturity window requires Jorge's explicit exception.
+Pi puede consumirse inmediatamente después de publicar y verificar el artefacto adoptado. El pin exacto, la procedencia, los SHA-256/SHA-512, el SRI, la compatibilidad y el procedimiento de rollback siguen siendo obligatorios; no uses `latest` ni una versión aproximada.
 
 `update --agents pi` only runs the Pi package lifecycle; it does not enter the global Stack updater. `update --check --agents pi` is a read-only Pi doctor. Uninstall runs package cleanup, backs up Pi's settings before removal, removes only the exact receipt-owned package after verifying absence, and preserves all companion/user state. Full behavior, failure states and troubleshooting are in [docs/references/pi-runtime.md](docs/references/pi-runtime.md).
 
@@ -240,6 +248,8 @@ La integración de este App pertenece al release del repositorio Stack. No conce
 
 Requirements: Node >= 22.5 and pnpm (never npm).
 
+pnpm 11 dependency resolution uses `minimumReleaseAge=1440` by default, with `minimumReleaseAgeExclude` for `jorgex-stack` and `jorgex-pi`. Keep that exclusion in the user-level pnpm config for `pnpm dlx` launched from HOME and in each repository workspace config for local commands; preserve every unrelated existing setting. This documents the maintainer environment and does not change other users' global configuration.
+
 ```
 pnpm install
 pnpm build        # tsup -> dist/

package/dist/cli.js

@@ -2826,7 +2826,11 @@ async function runInstall(opts) {
           const pnpmBin = resolvePnpmBin();
           return executePlaywrightToolAction2(action, pnpmBin, env);
         },
-        persistEnabled: (enabled) => savePlaywrightCliPreference(playwrightCliPreferenceFile(), enabled, opts.playwrightToolConsent?.runtimeSelection),
+        persistEnabled: (enabled) => {
+          const selected = opts.playwrightToolConsent?.runtimeSelection;
+          const fileSelection = selected === void 0 ? void 0 : Object.fromEntries(Object.entries(selected).filter(([runtime]) => runtime !== "pi"));
+          savePlaywrightCliPreference(playwrightCliPreferenceFile(), enabled, fileSelection);
+        },
         setupPnpm: (pnpmBin) => setupPnpmGlobal(pnpmBin)
       };
       let setupAttempted = false;
@@ -3357,6 +3361,10 @@ function runPiPackageManagedOperation(input, deps) {
 }
 
 // src/lib/pi-projection-lifecycle.ts
+var HANDOFF_KINDS = ["devtools", "playwright"];
+function handoffEnabled(input, kind) {
+  return (kind === "devtools" ? input.devtoolsMcpEnabled : input.playwrightHandoffEnabled) === true;
+}
 var preparedPiProjectionUninstalls = /* @__PURE__ */ new WeakMap();
 function projectionScope(scope) {
   return {
@@ -3403,18 +3411,27 @@ function projectionPlan(input, scope) {
   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({
+    actions.push({ kind: "write", target: handoffPath(scope, "devtools"), content: `${JSON.stringify({
       schemaVersion: 1,
       enabled: true,
       command: input.pnpmBin,
       args: server.args
     }, null, 2)}
+` });
+  }
+  if (input.playwrightHandoffEnabled && input.playwrightCliCommand) {
+    actions.push({ kind: "write", target: handoffPath(scope, "playwright"), content: `${JSON.stringify({
+      schemaVersion: 1,
+      enabled: true,
+      command: input.playwrightCliCommand,
+      version: PLAYWRIGHT_CLI.version
+    }, null, 2)}
 ` });
   }
   return actions;
 }
-function devtoolsPath(scope) {
-  return path23.resolve(scope.codingAgentDir, "jorgex-pi", "devtools.v1.json");
+function handoffPath(scope, kind) {
+  return path23.resolve(scope.codingAgentDir, "jorgex-pi", `${kind}.v1.json`);
 }
 function contentHash(content) {
   return createHash("sha256").update(content).digest("hex");
@@ -3425,13 +3442,14 @@ function canonicalActionContent(action) {
 function hasActionDrift(action, deps) {
   return deps.readText(action.target) !== canonicalActionContent(action);
 }
-function applyActions(actions, deps, handoff) {
+function applyActions(actions, deps, handoffs = []) {
   for (const action of actions) {
-    if (handoff && path23.resolve(action.target) === handoff.file) {
+    const handoff = handoffs.find((entry) => path23.resolve(action.target) === entry.file);
+    if (handoff) {
       try {
-        if (deps.readText(handoff.file) !== handoff.previous) return devtoolsConflict(handoff.file);
+        if (deps.readText(handoff.file) !== handoff.previous) return handoffConflict(handoff.kind, handoff.file);
       } catch {
-        return devtoolsConflict(handoff.file);
+        return handoffConflict(handoff.kind, handoff.file);
       }
     }
     if (action.kind === "write") deps.writeText(action.target, action.content);
@@ -3450,8 +3468,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 {
+  const receipt = {
     schemaVersion: 1,
     scope: {
       kind: scope.kind,
@@ -3459,9 +3476,13 @@ function receiptFor(plan, scope) {
       codingAgentDir: scope.codingAgentDir,
       receiptFile: scope.receiptFile
     },
-    owned,
-    ...handoff ? { devtools: { sha256: contentHash(canonicalActionContent(handoff)) } } : {}
+    owned
   };
+  for (const kind of HANDOFF_KINDS) {
+    const action = plan.find((entry) => path23.resolve(entry.target) === handoffPath(scope, kind));
+    if (action) receipt[kind] = { sha256: contentHash(canonicalActionContent(action)) };
+  }
+  return receipt;
 }
 function receiptContent(receipt) {
   return `${JSON.stringify(receipt, null, 2)}
@@ -3479,25 +3500,24 @@ function parseReceipt2(raw, expected) {
     const version = Reflect.get(receipt, "schemaVersion");
     const receivedScope = Reflect.get(receipt, "scope");
     const owned = Reflect.get(receipt, "owned");
-    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"])) {
+    const presentKinds = HANDOFF_KINDS.filter((kind) => Object.hasOwn(receipt, kind));
+    if (version !== expected.schemaVersion || !hasExactKeys(receipt, ["schemaVersion", "scope", "owned", ...presentKinds]) || 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)) {
       return null;
     }
-    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);
+    const digests = {};
+    for (const kind of presentKinds) {
+      const value = Reflect.get(receipt, kind);
+      if (value === null || typeof value !== "object" || Array.isArray(value) || !hasExactKeys(value, ["sha256"]) || typeof Reflect.get(value, "sha256") !== "string" || !/^[a-f0-9]{64}$/.test(Reflect.get(value, "sha256"))) return null;
+      digests[kind] = { sha256: Reflect.get(value, "sha256") };
+    }
+    const handoffPaths = HANDOFF_KINDS.map((kind) => handoffPath(expected.scope, kind));
+    const expectedOwned = expected.owned.filter((file) => !handoffPaths.includes(file));
+    for (const kind of presentKinds) expectedOwned.push(handoffPath(expected.scope, kind));
     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") } } : {}
-    };
+    return { schemaVersion: 1, scope: expected.scope, owned: expectedOwned, ...digests };
   } catch {
     return null;
   }
@@ -3623,34 +3643,39 @@ function readProjectionReceipt(receiptFile, deps) {
     return { kind: "unreadable" };
   }
 }
-function devtoolsConflict(file) {
+function handoffConflict(kind, file) {
+  const label = kind === "devtools" ? "DevTools" : "Playwright";
   return blocked2(
-    "projection-devtools-conflict",
+    `projection-${kind}-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."
+    `El handoff de ${label} 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);
+function inspectHandoffs(input, scope, expected, deps) {
   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") {
+  const handoffs = [];
+  for (const kind of HANDOFF_KINDS) {
+    const file = handoffPath(scope, kind);
+    let content;
     try {
-      recordedDevtools = Object.hasOwn(JSON.parse(read.content), "devtools");
+      content = deps.readText(file);
     } catch {
+      return handoffConflict(kind, file);
     }
-    if (!previous && (input.devtoolsMcpEnabled || content !== null || recordedDevtools)) return receiptInvalid(scope.receiptFile);
+    let recorded = false;
+    if (read.kind === "present") {
+      try {
+        recorded = Object.hasOwn(JSON.parse(read.content), kind);
+      } catch {
+      }
+      if (!previous && (handoffEnabled(input, kind) || content !== null || recorded)) return receiptInvalid(scope.receiptFile);
+    }
+    if (content !== null && (!previous?.[kind] || contentHash(content) !== previous[kind].sha256)) return handoffConflict(kind, file);
+    handoffs.push({ kind, file, content });
   }
-  if (content !== null && (!previous?.devtools || contentHash(content) !== previous.devtools.sha256)) return devtoolsConflict(file);
-  return { kind: "checked", previous, content };
+  return { kind: "checked", previous, handoffs };
 }
 function preparePiProjectionUninstall(input, deps) {
   if (input.operation !== "uninstall") {
@@ -3687,14 +3712,19 @@ 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);
+  const handoffs = [];
+  for (const kind of HANDOFF_KINDS) {
+    const file = handoffPath(scope, kind);
+    let content;
+    try {
+      content = deps.readText(file);
+    } catch {
+      return handoffConflict(kind, file);
+    }
+    const digest = ownedReceipt?.[kind]?.sha256;
+    if (content !== null && (digest === void 0 || contentHash(content) !== digest)) return handoffConflict(kind, file);
+    if (digest !== void 0) handoffs.push({ kind, file, sha256: digest });
   }
-  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 = {};
@@ -3702,7 +3732,7 @@ function preparePiProjectionUninstall(input, deps) {
     prompt: promptUpdate,
     ownedToRemove,
     receiptFile,
-    ...ownedReceipt?.devtools ? { devtools: { file: handoff, sha256: ownedReceipt.devtools.sha256 } } : {}
+    handoffs
   });
   return { kind: "prepared", plan: token };
 }
@@ -3714,14 +3744,14 @@ function completePiProjectionUninstall(plan, deps) {
   if (prepared === void 0) {
     return cleanupFailure([]);
   }
-  if (prepared.devtools) {
+  for (const handoff of prepared.handoffs) {
     let current;
     try {
-      current = deps.readText(prepared.devtools.file);
+      current = deps.readText(handoff.file);
     } catch {
-      return devtoolsConflict(prepared.devtools.file);
+      return handoffConflict(handoff.kind, handoff.file);
     }
-    if (current !== null && contentHash(current) !== prepared.devtools.sha256) return devtoolsConflict(prepared.devtools.file);
+    if (current !== null && contentHash(current) !== handoff.sha256) return handoffConflict(handoff.kind, handoff.file);
   }
   if (prepared.prompt !== null) {
     try {
@@ -3732,9 +3762,10 @@ function completePiProjectionUninstall(plan, deps) {
   }
   for (const owned of prepared.ownedToRemove) {
     try {
-      if (prepared.devtools?.file === owned) {
+      const handoff = prepared.handoffs.find((entry) => entry.file === owned);
+      if (handoff) {
         const current = deps.readText(owned);
-        if (current !== null && contentHash(current) !== prepared.devtools.sha256) return devtoolsConflict(owned);
+        if (current !== null && contentHash(current) !== handoff.sha256) return handoffConflict(handoff.kind, owned);
       }
       deps.removeFile(owned);
     } catch {
@@ -3757,22 +3788,27 @@ function runPiProjectionLifecycle(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.");
+    return blocked2("projection-devtools-command", [handoffPath(scope, "devtools")], "DevTools requiere un ejecutable pnpm absoluto disponible en PATH.");
+  }
+  if (input.playwrightHandoffEnabled && (!input.playwrightCliCommand || !path23.isAbsolute(input.playwrightCliCommand) || /[\u0000-\u001f\u007f]/.test(input.playwrightCliCommand))) {
+    return blocked2("projection-playwright-command", [handoffPath(scope, "playwright")], "Playwright requiere un ejecutable absoluto verificado. Abre una terminal nueva tras pnpm setup y reintenta install --playwright.");
   }
   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 checked = inspectHandoffs(input, scope, receipt, deps);
+  if (checked.kind === "blocked") return input.operation === "doctor" ? { kind: "drift", paths: checked.paths } : checked;
+  const removedHandoffs = checked.handoffs.filter(({ kind, content }) => !handoffEnabled(input, kind) && checked.previous?.[kind] !== void 0 && 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));
+  for (const { kind, file } of checked.handoffs) {
+    if (handoffEnabled(input, kind) && checked.previous?.[kind]?.sha256 !== receipt[kind]?.sha256 && !drifted.some((action) => path23.resolve(action.target) === file)) {
+      return input.operation === "doctor" ? { kind: "drift", paths: [file] } : handoffConflict(kind, file);
+    }
   }
   if (input.operation === "doctor") {
     const paths = drifted.map((action) => path23.resolve(action.target));
-    if (removeHandoff) paths.push(devtoolsPath(scope));
+    paths.push(...removedHandoffs.map(({ file }) => file));
     const currentSettings2 = deps.readText(scope.settingsFile);
     if (currentSettings2 === null || filterProjectedPiPackage(currentSettings2, input.packageSource) !== currentSettings2) {
       paths.push(scope.settingsFile);
@@ -3788,30 +3824,38 @@ function runPiProjectionLifecycle(input, deps) {
   }
   const packageWillChange = filteredSettings !== null && filteredSettings !== currentSettings;
   const receiptChanged = deps.readText(scope.receiptFile) !== expectedReceipt2;
-  if (drifted.length > 0 || packageWillChange || receiptChanged || removeHandoff) {
+  if (drifted.length > 0 || packageWillChange || receiptChanged || removedHandoffs.length > 0) {
     const backup = backupExisting([
       ...drifted.map((action) => action.target),
-      ...removeHandoff ? [devtoolsPath(scope)] : [],
+      ...removedHandoffs.map(({ file }) => file),
       ...packageWillChange ? [scope.settingsFile] : [],
       ...receiptChanged ? [scope.receiptFile] : []
     ], deps);
     if (backup.kind === "backup-failed") return backupFailure(backup.paths);
   }
-  if (removeHandoff) {
+  for (const { kind, file } of removedHandoffs) {
+    try {
+      const current = deps.readText(file);
+      if (current !== null && contentHash(current) !== checked.previous?.[kind]?.sha256) return handoffConflict(kind, file);
+    } catch {
+      return handoffConflict(kind, file);
+    }
+  }
+  for (const { kind, file } of removedHandoffs) {
     try {
-      const current = deps.readText(devtoolsPath(scope));
-      if (current !== null && contentHash(current) !== devtools.previous?.devtools?.sha256) return devtoolsConflict(devtoolsPath(scope));
-      deps.removeFile(devtoolsPath(scope));
+      const current = deps.readText(file);
+      if (current !== null && contentHash(current) !== checked.previous?.[kind]?.sha256) return handoffConflict(kind, file);
+      deps.removeFile(file);
     } catch {
-      return cleanupFailure([devtoolsPath(scope)]);
+      return cleanupFailure([file]);
     }
   }
-  const writeResult = applyActions(drifted, deps, input.devtoolsMcpEnabled ? { file: devtoolsPath(scope), previous: devtools.content } : void 0);
+  const writeResult = applyActions(drifted, deps, checked.handoffs.filter(({ kind }) => handoffEnabled(input, kind)).map(({ kind, file, content }) => ({ kind, file, previous: content })));
   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 || removeHandoff };
+  return { kind: "synced", changed: drifted.length > 0 || packageWillChange || receiptChanged || removedHandoffs.length > 0 };
 }
 function systemProjectionLifecycle(input) {
   const targetRoot = input.targetDir === void 0 ? null : path23.resolve(input.targetDir);
@@ -3830,7 +3874,9 @@ function systemProjectionLifecycle(input) {
       engramBin: input.engramBin ?? "",
       playwrightCliEnabled: input.playwrightCliEnabled,
       devtoolsMcpEnabled: input.devtoolsMcpEnabled,
-      pnpmBin: input.pnpmBin
+      pnpmBin: input.pnpmBin,
+      playwrightHandoffEnabled: input.playwrightHandoffEnabled,
+      playwrightCliCommand: input.playwrightCliCommand
     },
     deps: {
       readText: readTextOnlyIfMissing,
@@ -5425,16 +5471,16 @@ import { createHash as createHash2 } from "crypto";
 var pi_runtime_pin_default = {
   package: {
     name: "jorgex-pi",
-    version: "0.8.13",
-    source: "npm:jorgex-pi@0.8.13"
+    version: "0.8.15",
+    source: "npm:jorgex-pi@0.8.15"
   },
   provenance: {
-    commit: "e28a677da0a112925251cf11269b70cb5c8aa15e"
+    commit: "9d619e205685df0b8b122aa24b81e8694182e3ca"
   },
   tarball: {
-    bytes: 89143404,
-    sha256: "6bbe877249b900af582c8881e0dd7993951ea1cef6e7252522c626c078de7478",
-    sha512: "bb527d1f3812406f2184f778b22cca00ead33692fecac0012cf8cdcdc469b7cccf3c789c35b4327dd599d06542162bd07eefeeaaa40de19662ec5fc422b14af8"
+    bytes: 89145074,
+    sha256: "a866da924e0d7ad2b5a5ef285671c06b742d5b64cd62d463a8a39d8e7b5d4453",
+    sha512: "ac5a70bcf336bd28eccb06360a8874c2a3bb2887fe420b6f97a0b61ca1b1c97d2db26fd28033fa296ab273423b1b5884d123dfc56ad1d6e274aefd828d9d25c6"
   }
 };
 
@@ -5457,6 +5503,7 @@ var PI_RUNTIME_CANDIDATE = {
       "mcp-adapter-v1",
       "engram-runtime-tools-v1",
       "chrome-devtools-handoff-v1",
+      "playwright-handoff-v1",
       "runner-json-v1",
       "tui-branding-v1",
       "managed-primary-model-v1",
@@ -6031,14 +6078,18 @@ function managedPackageResult(result) {
   return result;
 }
 async function runManagedPiSystem(input) {
-  const { devtoolsMcpEnabled: explicitDevtools, ...runtimeInput } = input;
+  const { devtoolsMcpEnabled: explicitDevtools, playwrightCliEnabled: explicitPlaywright, ...runtimeInput } = input;
   const devtoolsMcpEnabled = explicitDevtools ?? (input.targetDir === void 0 && loadDevtoolsMcpPreference(devtoolsMcpPreferenceFile(), "pi"));
-  const playwrightCliEnabled = input.targetDir === void 0 && loadPlaywrightCliPreference(void 0, "pi") === true;
+  const supportsPlaywright = PI_RUNTIME_CANDIDATE.contract.capabilities.includes("playwright-handoff-v1");
+  const playwrightCliEnabled = input.targetDir === void 0 && supportsPlaywright && (explicitPlaywright ?? loadPlaywrightCliPreference(void 0, "pi") === true);
+  const playwrightCliCommand = playwrightCliEnabled && input.operation !== "uninstall" && input.operation !== "models" ? detectPlaywrightCli().binPath : null;
   const projectionInput = {
     targetDir: input.targetDir,
     packageSource: PI_RUNTIME_CANDIDATE.package.source,
     engramBin: input.engramBin,
     playwrightCliEnabled,
+    playwrightHandoffEnabled: playwrightCliEnabled,
+    playwrightCliCommand,
     devtoolsMcpEnabled,
     pnpmBin: devtoolsMcpEnabled && input.operation !== "uninstall" ? resolvePnpmBin() : null
   };
@@ -6068,6 +6119,9 @@ async function runManagedPiSystem(input) {
   if (input.targetDir === void 0 && explicitDevtools !== void 0 && (input.operation === "install" || input.operation === "sync") && result.kind !== "blocked") {
     saveDevtoolsMcpPreference(devtoolsMcpPreferenceFile(), "pi", explicitDevtools);
   }
+  if (input.targetDir === void 0 && supportsPlaywright && explicitPlaywright !== void 0 && (input.operation === "install" || input.operation === "sync") && result.kind !== "blocked") {
+    savePlaywrightCliPreference(playwrightCliPreferenceFile(), true, { pi: explicitPlaywright });
+  }
   return result;
 }
 
@@ -6875,7 +6929,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, devtoolsMcpEnabled) {
+async function runSelectedPi(operation, targetDir, yes = false, resolvedEngramBin, devtoolsMcpEnabled, playwrightCliEnabled) {
   if (targetDir === void 0 && operation !== "models") {
     const preferenceErrors = browserPreferenceErrors();
     if (preferenceErrors.length > 0) {
@@ -6918,7 +6972,8 @@ async function runSelectedPi(operation, targetDir, yes = false, resolvedEngramBi
     targetDir,
     detected: { executable: detected.executable, version: detected.version },
     engramBin,
-    ...devtoolsMcpEnabled === void 0 ? {} : { devtoolsMcpEnabled }
+    ...devtoolsMcpEnabled === void 0 ? {} : { devtoolsMcpEnabled },
+    ...playwrightCliEnabled === void 0 ? {} : { playwrightCliEnabled }
   });
   if (result.kind === "blocked") {
     const paths = "paths" in result ? `: ${result.paths.join(", ")}` : "";
@@ -7121,7 +7176,8 @@ Flags disponibles: jorgex-stack --help`
             flags.targetDir,
             flags.yes,
             flags.targetDir === void 0 ? engramBin : void 0,
-            devtoolsMcpSelection.pi
+            devtoolsMcpSelection.pi,
+            flags.targetDir === void 0 && exitCode === 0 && resolvePlaywrightToolPlan(playwrightToolConsent).actions.length > 0 ? playwrightToolConsent.runtimeSelection?.pi : void 0
           ));
         }
         completed = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jorgex-stack",
-  "version": "1.9.32",
+  "version": "1.9.33",
   "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",