jorgex-stack 1.9.44 → 1.9.46

package/README.md

@@ -116,7 +116,7 @@ Programmatic mode does **not** provide:
 
 El canon de Stack y el paquete Pi adoptado mantienen una snapshot de 17 árboles de skills con 89 archivos de skill. La identidad, procedencia e integridad del paquete adoptado son autoritativas en `src/lib/pi-runtime-pin.json`.
 
-Pi combines the frozen **snapshot v2** package with a Stack-owned shared projection. The version references that follow describe historical Stack/Pi transitions, not the current pin. The current pin, package integrity and lifecycle are maintained in [docs/references/pi-runtime.md](docs/references/pi-runtime.md) and `src/lib/pi-runtime-pin.json`; this README does not imply a future release.
+Pi combines the frozen **snapshot v2** package with a Stack-owned shared projection. The version references that follow describe historical Stack/Pi transitions, not the current pin. The current pin is the published `jorgex-pi@0.8.23` artifact. Package integrity and lifecycle are maintained in [docs/references/pi-runtime.md](docs/references/pi-runtime.md) and `src/lib/pi-runtime-pin.json`; this README does not imply a future Stack release.
 
 The following command block is retained as historical reference for that transition:
 
@@ -128,11 +128,13 @@ 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 exact 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`. Pi 0.8.22 registers Context7 through an isolated in-memory HTTP bridge during bootstrap; `available` means configuration permits registration and does not imply an HTTP handshake. A conflict preserves the existing MCP file and blocks managed activation. No MCP configuration or credentials are written. For the file runtimes, Context7, Playwright and DevTools use independent managed sections. The global Playwright package and Chromium cache are shared by the machine; `--playwright-runtimes` controls which runtime receives the guide. The adopted Pi package implements and tests `playwright-handoff-v1` through `PI_CODING_AGENT_DIR/jorgex-pi/playwright.v1.json`. Historical package entries do not describe the current 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.
+For the current Pi `0.8.23` pin, package identity and runner validation precede projection; the exact pending initialization diagnostic remains provisional until projection and final `sync` complete.
 
-The static `AGENTS.md` projected by Stack does not include Context7; Pi's native bootstrap adds that section after registering the isolated bridge. Pi never writes, owns or removes MCP files. In Claude Code, Codex and OpenCode, a compatible existing Context7 entry is preserved and removed only with explicit canonical Stack ownership.
+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 exact 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. A managed install then runs `package install → projection install → package sync`: after the package identity and runner are validated, Stack projects the shared resources into Pi and invokes Pi's native sync to complete initialization. The projection includes 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`. Pi 0.8.23 registers Context7 through an isolated in-memory HTTP bridge during bootstrap; `available` means configuration permits registration and does not imply an HTTP handshake. A conflict preserves the existing MCP file and blocks managed activation. No MCP configuration or credentials are written. For the file runtimes, Context7, Playwright and DevTools use independent managed sections. The global Playwright package and Chromium cache are shared by the machine; `--playwright-runtimes` controls which runtime receives the guide. The adopted Pi package implements and tests `playwright-handoff-v1` through `PI_CODING_AGENT_DIR/jorgex-pi/playwright.v1.json`. Historical package entries do not describe the current 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.
 
-Pi 0.8.22 also seeds `theme=JorgeX`, `quietStartup=true`, and `hideThinkingBlock=true` only for missing fields during first initialization. User changes and deletions are preserved without reseeding. `hideThinkingBlock` changes presentation only; `defaultThinkingLevel` and reasoning remain unchanged. Pi owns only the fields it creates and records in its lifecycle receipt; pre-existing user settings remain unowned. The JorgeX header preserves builtin and custom commands. `Ctrl+O` remains Pi's native tool presentation, with `NO_COLOR` and `JORGEX_PI_MOTION` behavior unchanged; Stack adds no renderer.
+The static `AGENTS.md` projected by Stack does not include Context7; Pi's native bootstrap adds that section after registering the isolated bridge. Pi never writes, owns or removes MCP files. In Claude Code, Codex and OpenCode, a compatible existing Context7 entry is preserved and removed only with explicit canonical Stack ownership. During package installation only, `initialization-diagnostics-v1` permits the exact pending `doctor` envelope described in [the Pi runtime reference](docs/references/pi-runtime.md); it is provisional and does not make Pi healthy. Projection and final `sync` must still complete, and every other unhealthy or malformed result remains blocked.
+
+Pi 0.8.23 also seeds `theme=JorgeX`, `quietStartup=true`, and `hideThinkingBlock=true` only for missing fields during first initialization. User changes and deletions are preserved without reseeding. `hideThinkingBlock` changes presentation only; `defaultThinkingLevel` and reasoning remain unchanged. Pi owns only the fields it creates and records in its lifecycle receipt; pre-existing user settings remain unowned. The JorgeX header preserves builtin and custom commands. `Ctrl+O` remains Pi's native tool presentation, with `NO_COLOR` and `JORGEX_PI_MOTION` behavior unchanged; Stack adds no renderer.
 
 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.
 

package/dist/cli.js

@@ -6146,16 +6146,16 @@ import { createHash as createHash2 } from "crypto";
 var pi_runtime_pin_default = {
   package: {
     name: "jorgex-pi",
-    version: "0.8.22",
-    source: "npm:jorgex-pi@0.8.22"
+    version: "0.8.23",
+    source: "npm:jorgex-pi@0.8.23"
   },
   provenance: {
-    commit: "462de6f6f52dbc86b6808ed051dd441932974500"
+    commit: "ebb5e6e18e8e9297ffbf7bd53cf6785b952474b9"
   },
   tarball: {
-    bytes: 89140502,
-    sha256: "98fbcffe5ee81e9fd8754dfbb40d786ee7c10251ef7050d68e70808f8de4d1df",
-    sha512: "ef415061fab27328cc1e43238653705bca089d32719034a3e6543da19069d42996d5b799b1f94eac8b2fccd64d97b2440dbf1ddcd1f3d22d9fc45ac0a805a7cd"
+    bytes: 89140657,
+    sha256: "cbe75c7975353c6ed3123a9bd9c3395e18263a49f33f80a607123392ba27a8fd",
+    sha512: "bb6dd4075a25818f301ed73d6b7b1432beca635fb6c130c0b0543844d086475640c41fa1e1e68035f3df97ad3cee52e5de8917b05fe01d7483875ae934e3374d"
   }
 };
 
@@ -6187,7 +6187,8 @@ var PI_RUNTIME_CANDIDATE = {
       "tui-branding-v1",
       "managed-primary-model-v1",
       "quality-receipt-contract-v1",
-      "quality-capabilities-contract-v1"
+      "quality-capabilities-contract-v1",
+      "initialization-diagnostics-v1"
     ],
     runner: {
       bin: "jorgex-pi",
@@ -6338,6 +6339,49 @@ function healthyDoctor(stdout, stderr, packageRunner, candidate) {
     return false;
   }
 }
+function provisionalPendingDoctor(exitCode, stdout, stderr, packageRunner, candidate) {
+  const capabilities = candidate.capabilities ?? PI_RUNTIME_CANDIDATE.contract.capabilities;
+  if (!capabilities.includes("initialization-diagnostics-v1")) return false;
+  if (exitCode !== 1 || stderr !== "" || !stdout.endsWith("\n") || stdout.slice(0, -1).includes("\n")) return false;
+  try {
+    const record = JSON.parse(stdout.slice(0, -1));
+    if (record === null || typeof record !== "object" || Array.isArray(record)) return false;
+    if (JSON.stringify(Object.keys(record).sort()) !== JSON.stringify(["command", "error", "ok", "package", "result", "schemaVersion"])) return false;
+    if (Reflect.get(record, "schemaVersion") !== 1) return false;
+    if (Reflect.get(record, "command") !== "doctor") return false;
+    if (Reflect.get(record, "ok") !== false) return false;
+    const packageValue = Reflect.get(record, "package");
+    if (packageValue === null || typeof packageValue !== "object" || Array.isArray(packageValue)) return false;
+    if (JSON.stringify(Object.keys(packageValue).sort()) !== JSON.stringify(["name", "root", "version"])) return false;
+    if (Reflect.get(packageValue, "name") !== "jorgex-pi") return false;
+    if (Reflect.get(packageValue, "version") !== (candidate.package?.version ?? /^npm:jorgex-pi@([^\s]+)$/.exec(candidate.source)?.[1])) return false;
+    if (path33.resolve(packageRunner) !== path33.resolve(String(Reflect.get(packageValue, "root")), "bin", "jorgex-pi.mjs")) return false;
+    const result = Reflect.get(record, "result");
+    if (result === null || typeof result !== "object" || Array.isArray(result)) return false;
+    if (JSON.stringify(Object.keys(result).sort()) !== JSON.stringify(["checks", "healthy"])) return false;
+    if (Reflect.get(result, "healthy") !== false) return false;
+    const checks = Reflect.get(result, "checks");
+    if (!Array.isArray(checks) || checks.length !== 5) return false;
+    const expectedIds = ["package", "engram", "context7", "permissions", "experience"];
+    for (let index = 0; index < 5; index++) {
+      const check = checks[index];
+      if (check === null || typeof check !== "object" || Array.isArray(check)) return false;
+      if (JSON.stringify(Object.keys(check).sort()) !== JSON.stringify(["id", "status"])) return false;
+      if (Reflect.get(check, "id") !== expectedIds[index]) return false;
+      const status = Reflect.get(check, "status");
+      if (index < 3) {
+        if (status !== "ok") return false;
+      } else if (status !== "ok" && status !== "error") return false;
+    }
+    if (Reflect.get(checks[3], "status") === "ok" && Reflect.get(checks[4], "status") === "ok") return false;
+    const errorValue = Reflect.get(record, "error");
+    if (errorValue === null || typeof errorValue !== "object" || Array.isArray(errorValue)) return false;
+    if (JSON.stringify(Object.keys(errorValue).sort()) !== JSON.stringify(["code", "message", "phase", "remedy"])) return false;
+    return Reflect.get(errorValue, "phase") === "initialization" && Reflect.get(errorValue, "code") === "INITIALIZATION_REQUIRED" && Reflect.get(errorValue, "message") === "Pi initialization is pending: run sync to complete first initialization." && Reflect.get(errorValue, "remedy") === "Run jorgex-pi sync --json and retry.";
+  } catch {
+    return false;
+  }
+}
 function installPiFromVerifiedTarball(input, deps) {
   const paths = input.targetDir === void 0 ? userPaths(input.engramBin, input.piExecutable) : targetPaths(input.targetDir, input.engramBin, input.piExecutable);
   const destination = input.targetDir === void 0 ? path33.join(dataDir(), "packages", `jorgex-pi-${PI_RUNTIME_CANDIDATE.package.version}.tgz`) : path33.join(path33.resolve(input.targetDir), "downloads", `jorgex-pi-${PI_RUNTIME_CANDIDATE.package.version}.tgz`);
@@ -6368,7 +6412,9 @@ function installPiFromVerifiedTarball(input, deps) {
     args: [paths.packageRunner, "doctor", "--json"],
     environment: paths.environment
   });
-  if (doctor.exitCode !== 0 || !healthyDoctor(doctor.stdout, doctor.stderr, paths.packageRunner, input.candidate)) {
+  const healthy = doctor.exitCode === 0 && healthyDoctor(doctor.stdout, doctor.stderr, paths.packageRunner, input.candidate);
+  const pending = provisionalPendingDoctor(doctor.exitCode, doctor.stdout, doctor.stderr, paths.packageRunner, input.candidate);
+  if (!healthy && !pending) {
     return { kind: "blocked", reason: "runner-unhealthy" };
   }
   const receipt = flatCandidateReceipt(input.candidate, scope, "installed", input.engramBin);
@@ -6680,7 +6726,8 @@ async function runPiRuntimeSystem(input) {
         source: PI_RUNTIME_CANDIDATE.package.source,
         ...PI_RUNTIME_CANDIDATE.tarball,
         package: PI_RUNTIME_CANDIDATE.package,
-        provenance: PI_RUNTIME_CANDIDATE.provenance
+        provenance: PI_RUNTIME_CANDIDATE.provenance,
+        capabilities: PI_RUNTIME_CANDIDATE.contract.capabilities
       }
     }, {
       download: () => artifact,
@@ -6746,6 +6793,21 @@ async function completeProjection(operation, packageResult, deps) {
   }
   return projectionResult.kind === "blocked" ? projectionResult : packageResult;
 }
+var INSTALL_INIT_REMEDY = "Corrige la causa y ejecuta sync --agents pi para completar la inicializaci\xF3n.";
+var INSTALL_INIT_TARGET_REMEDY = "Corrige la causa y ejecuta sync --agents pi con el mismo --target-dir para completar la inicializaci\xF3n.";
+function withInstallInitRemedy(result, fallbackRemedy) {
+  return result.remedy === void 0 ? { kind: "blocked", reason: result.reason, remedy: fallbackRemedy } : result;
+}
+async function completeInstallWithInitialization(packageResult, deps) {
+  const projected = await completeProjection("install", packageResult, deps);
+  if (projected.kind === "blocked") return projected;
+  const fallbackRemedy = deps.installInitRemedy ?? INSTALL_INIT_REMEDY;
+  const initResult = await deps.runPackage("sync");
+  if (initResult.kind === "synced") return packageResult;
+  if (initResult.kind === "manual-existing") return manualExistingResult(initResult);
+  if (initResult.kind === "blocked") return withInstallInitRemedy(initResult, fallbackRemedy);
+  return { kind: "blocked", reason: "runner-unhealthy", remedy: fallbackRemedy };
+}
 async function runManagedPiOperation(operation, deps) {
   if (operation === "uninstall") {
     const preparation = await deps.prepareProjectionUninstall();
@@ -6758,6 +6820,9 @@ async function runManagedPiOperation(operation, deps) {
   const packageResult = await deps.runPackage(operation);
   if (packageResult.kind === "manual-existing") return manualExistingResult(packageResult);
   if (operation === "models") return packageResult;
+  if (operation === "install" && packageResult.kind !== "blocked") {
+    return completeInstallWithInitialization(packageResult, deps);
+  }
   const nextProjectionOperation = projectionOperation(operation);
   if (packageResult.kind !== "blocked") {
     return completeProjection(nextProjectionOperation, packageResult, deps);
@@ -6837,6 +6902,7 @@ async function runManagedPiSystem(input) {
   };
   if (preparedStyle !== void 0 && input.operation !== "doctor") applyWritingStyle(preparedStyle);
   const result = await runManagedPiOperation(input.operation, {
+    installInitRemedy: input.targetDir === void 0 ? void 0 : INSTALL_INIT_TARGET_REMEDY,
     async runPackage(operation) {
       return managedPackageResult(await runPiRuntimeSystem({ ...runtimeInput, operation }));
     },

package/package.json

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