@jaybeeuu/agent-cortex 1.42.0 → 1.43.0

package/skills/workflow/run-pipeline-stage/scripts/pnpm-lock.yaml

@@ -0,0 +1,342 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@types/node':
+        specifier: ^22.0.0
+        version: 22.19.17
+      tsx:
+        specifier: ^4.0.0
+        version: 4.21.0
+      typescript:
+        specifier: ^5.0.0
+        version: 5.9.3
+
+packages:
+
+  '@esbuild/aix-ppc64@0.27.7':
+    resolution: {integrity: sha512-EKX3Qwmhz1eMdEJokhALr0YiD0lhQNwDqkPYyPhiSwKrh7/4KRjQc04sZ8db+5DVVnZ1LmbNDI1uAMPEUBnQPg==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.27.7':
+    resolution: {integrity: sha512-62dPZHpIXzvChfvfLJow3q5dDtiNMkwiRzPylSCfriLvZeq0a1bWChrGx/BbUbPwOrsWKMn8idSllklzBy+dgQ==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.27.7':
+    resolution: {integrity: sha512-jbPXvB4Yj2yBV7HUfE2KHe4GJX51QplCN1pGbYjvsyCZbQmies29EoJbkEc+vYuU5o45AfQn37vZlyXy4YJ8RQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.27.7':
+    resolution: {integrity: sha512-x5VpMODneVDb70PYV2VQOmIUUiBtY3D3mPBG8NxVk5CogneYhkR7MmM3yR/uMdITLrC1ml/NV1rj4bMJuy9MCg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.27.7':
+    resolution: {integrity: sha512-5lckdqeuBPlKUwvoCXIgI2D9/ABmPq3Rdp7IfL70393YgaASt7tbju3Ac+ePVi3KDH6N2RqePfHnXkaDtY9fkw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.27.7':
+    resolution: {integrity: sha512-rYnXrKcXuT7Z+WL5K980jVFdvVKhCHhUwid+dDYQpH+qu+TefcomiMAJpIiC2EM3Rjtq0sO3StMV/+3w3MyyqQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.27.7':
+    resolution: {integrity: sha512-B48PqeCsEgOtzME2GbNM2roU29AMTuOIN91dsMO30t+Ydis3z/3Ngoj5hhnsOSSwNzS+6JppqWsuhTp6E82l2w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.27.7':
+    resolution: {integrity: sha512-jOBDK5XEjA4m5IJK3bpAQF9/Lelu/Z9ZcdhTRLf4cajlB+8VEhFFRjWgfy3M1O4rO2GQ/b2dLwCUGpiF/eATNQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.27.7':
+    resolution: {integrity: sha512-RZPHBoxXuNnPQO9rvjh5jdkRmVizktkT7TCDkDmQ0W2SwHInKCAV95GRuvdSvA7w4VMwfCjUiPwDi0ZO6Nfe9A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.27.7':
+    resolution: {integrity: sha512-RkT/YXYBTSULo3+af8Ib0ykH8u2MBh57o7q/DAs3lTJlyVQkgQvlrPTnjIzzRPQyavxtPtfg0EopvDyIt0j1rA==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.27.7':
+    resolution: {integrity: sha512-GA48aKNkyQDbd3KtkplYWT102C5sn/EZTY4XROkxONgruHPU72l+gW+FfF8tf2cFjeHaRbWpOYa/uRBz/Xq1Pg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.27.7':
+    resolution: {integrity: sha512-a4POruNM2oWsD4WKvBSEKGIiWQF8fZOAsycHOt6JBpZ+JN2n2JH9WAv56SOyu9X5IqAjqSIPTaJkqN8F7XOQ5Q==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.27.7':
+    resolution: {integrity: sha512-KabT5I6StirGfIz0FMgl1I+R1H73Gp0ofL9A3nG3i/cYFJzKHhouBV5VWK1CSgKvVaG4q1RNpCTR2LuTVB3fIw==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.27.7':
+    resolution: {integrity: sha512-gRsL4x6wsGHGRqhtI+ifpN/vpOFTQtnbsupUF5R5YTAg+y/lKelYR1hXbnBdzDjGbMYjVJLJTd2OFmMewAgwlQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.27.7':
+    resolution: {integrity: sha512-hL25LbxO1QOngGzu2U5xeXtxXcW+/GvMN3ejANqXkxZ/opySAZMrc+9LY/WyjAan41unrR3YrmtTsUpwT66InQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.27.7':
+    resolution: {integrity: sha512-2k8go8Ycu1Kb46vEelhu1vqEP+UeRVj2zY1pSuPdgvbd5ykAw82Lrro28vXUrRmzEsUV0NzCf54yARIK8r0fdw==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.27.7':
+    resolution: {integrity: sha512-hzznmADPt+OmsYzw1EE33ccA+HPdIqiCRq7cQeL1Jlq2gb1+OyWBkMCrYGBJ+sxVzve2ZJEVeePbLM2iEIZSxA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-b6pqtrQdigZBwZxAn1UpazEisvwaIDvdbMbmrly7cDTMFnw/+3lVxxCTGOrkPVnsYIosJJXAsILG9XcQS+Yu6w==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.27.7':
+    resolution: {integrity: sha512-OfatkLojr6U+WN5EDYuoQhtM+1xco+/6FSzJJnuWiUw5eVcicbyK3dq5EeV/QHT1uy6GoDhGbFpprUiHUYggrw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.27.7':
+    resolution: {integrity: sha512-AFuojMQTxAz75Fo8idVcqoQWEHIXFRbOc1TrVcFSgCZtQfSdc1RXgB3tjOn/krRHENUB4j00bfGjyl2mJrU37A==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.27.7':
+    resolution: {integrity: sha512-+A1NJmfM8WNDv5CLVQYJ5PshuRm/4cI6WMZRg1by1GwPIQPCTs1GLEUHwiiQGT5zDdyLiRM/l1G0Pv54gvtKIg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.27.7':
+    resolution: {integrity: sha512-+KrvYb/C8zA9CU/g0sR6w2RBw7IGc5J2BPnc3dYc5VJxHCSF1yNMxTV5LQ7GuKteQXZtspjFbiuW5/dOj7H4Yw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.27.7':
+    resolution: {integrity: sha512-ikktIhFBzQNt/QDyOL580ti9+5mL/YZeUPKU2ivGtGjdTYoqz6jObj6nOMfhASpS4GU4Q/Clh1QtxWAvcYKamA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.27.7':
+    resolution: {integrity: sha512-7yRhbHvPqSpRUV7Q20VuDwbjW5kIMwTHpptuUzV+AA46kiPze5Z7qgt6CLCK3pWFrHeNfDd1VKgyP4O+ng17CA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.27.7':
+    resolution: {integrity: sha512-SmwKXe6VHIyZYbBLJrhOoCJRB/Z1tckzmgTLfFYOfpMAx63BJEaL9ExI8x7v0oAO3Zh6D/Oi1gVxEYr5oUCFhw==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.27.7':
+    resolution: {integrity: sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@types/node@22.19.17':
+    resolution: {integrity: sha512-wGdMcf+vPYM6jikpS/qhg6WiqSV/OhG+jeeHT/KlVqxYfD40iYJf9/AE1uQxVWFvU7MipKRkRv8NSHiCGgPr8Q==}
+
+  esbuild@0.27.7:
+    resolution: {integrity: sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  get-tsconfig@4.14.0:
+    resolution: {integrity: sha512-yTb+8DXzDREzgvYmh6s9vHsSVCHeC0G3PI5bEXNBHtmshPnO+S5O7qgLEOn0I5QvMy6kpZN8K1NKGyilLb93wA==}
+
+  resolve-pkg-maps@1.0.0:
+    resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==}
+
+  tsx@4.21.0:
+    resolution: {integrity: sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undici-types@6.21.0:
+    resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
+
+snapshots:
+
+  '@esbuild/aix-ppc64@0.27.7':
+    optional: true
+
+  '@esbuild/android-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/android-arm@0.27.7':
+    optional: true
+
+  '@esbuild/android-x64@0.27.7':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/darwin-x64@0.27.7':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-arm@0.27.7':
+    optional: true
+
+  '@esbuild/linux-ia32@0.27.7':
+    optional: true
+
+  '@esbuild/linux-loong64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.27.7':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.27.7':
+    optional: true
+
+  '@esbuild/linux-s390x@0.27.7':
+    optional: true
+
+  '@esbuild/linux-x64@0.27.7':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.27.7':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/sunos-x64@0.27.7':
+    optional: true
+
+  '@esbuild/win32-arm64@0.27.7':
+    optional: true
+
+  '@esbuild/win32-ia32@0.27.7':
+    optional: true
+
+  '@esbuild/win32-x64@0.27.7':
+    optional: true
+
+  '@types/node@22.19.17':
+    dependencies:
+      undici-types: 6.21.0
+
+  esbuild@0.27.7:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.27.7
+      '@esbuild/android-arm': 0.27.7
+      '@esbuild/android-arm64': 0.27.7
+      '@esbuild/android-x64': 0.27.7
+      '@esbuild/darwin-arm64': 0.27.7
+      '@esbuild/darwin-x64': 0.27.7
+      '@esbuild/freebsd-arm64': 0.27.7
+      '@esbuild/freebsd-x64': 0.27.7
+      '@esbuild/linux-arm': 0.27.7
+      '@esbuild/linux-arm64': 0.27.7
+      '@esbuild/linux-ia32': 0.27.7
+      '@esbuild/linux-loong64': 0.27.7
+      '@esbuild/linux-mips64el': 0.27.7
+      '@esbuild/linux-ppc64': 0.27.7
+      '@esbuild/linux-riscv64': 0.27.7
+      '@esbuild/linux-s390x': 0.27.7
+      '@esbuild/linux-x64': 0.27.7
+      '@esbuild/netbsd-arm64': 0.27.7
+      '@esbuild/netbsd-x64': 0.27.7
+      '@esbuild/openbsd-arm64': 0.27.7
+      '@esbuild/openbsd-x64': 0.27.7
+      '@esbuild/openharmony-arm64': 0.27.7
+      '@esbuild/sunos-x64': 0.27.7
+      '@esbuild/win32-arm64': 0.27.7
+      '@esbuild/win32-ia32': 0.27.7
+      '@esbuild/win32-x64': 0.27.7
+
+  fsevents@2.3.3:
+    optional: true
+
+  get-tsconfig@4.14.0:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
+  resolve-pkg-maps@1.0.0: {}
+
+  tsx@4.21.0:
+    dependencies:
+      esbuild: 0.27.7
+      get-tsconfig: 4.14.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  typescript@5.9.3: {}
+
+  undici-types@6.21.0: {}

package/test/cli.test.mjs

@@ -123,11 +123,6 @@ describe("parseArgs", () => {
     assert.deepStrictEqual(result, { command: "install", harness: "pi", pluginRoot: "/tmp/plugin" });
   });
 
-  it("parses --no-provision for install", async () => {
-    const result = parseArgs(["install", "pi", "--no-provision"]);
-    assert.deepStrictEqual(result, { command: "install", harness: "pi", noProvision: true });
-  });
-
   it("combines multiple install options", async () => {
     const result = parseArgs(["install", "pi", "--dry-run", "--output", "/tmp/out", "--plugin-root", "/tmp/plugin"]);
     assert.deepStrictEqual(result, {
@@ -236,14 +231,6 @@ describe("CLI integration", () => {
     }
   });
 
-  it("exits 0 for install pi --no-provision", async () => {
-    // --no-provision keeps this hermetic: without it the CLI would install the
-    // third-party packages declared in the package manifest.
-    const { exitCode, stdout } = await runCli(["install", "pi", "--no-provision"]);
-    assert.equal(exitCode, 0);
-    assert.ok(stdout.includes("pi"));
-  });
-
   it("exits 1 and prints error for install with no harness", async () => {
     const { exitCode, stderr } = await runCli(["install"]);
     assert.equal(exitCode, 1);
@@ -256,6 +243,12 @@ describe("CLI integration", () => {
     assert.ok(stderr.includes("--bogus"));
   });
 
+  it("exits 1 for the removed --no-provision flag", async () => {
+    const { exitCode, stderr } = await runCli(["install", "pi", "--no-provision"]);
+    assert.equal(exitCode, 1);
+    assert.ok(stderr.includes("--no-provision"), "the removed flag is named in the error");
+  });
+
   it("exits 1 and prints error for install with a missing option value", async () => {
     const { exitCode, stderr } = await runCli(["install", "pi", "--output"]);
     assert.equal(exitCode, 1);
@@ -263,30 +256,33 @@ describe("CLI integration", () => {
   });
 
   it("exits 0 for install pi --dry-run and writes nothing", async () => {
-    const { exitCode, stdout } = await runCli(["install", "pi", "--dry-run"]);
-    assert.equal(exitCode, 0);
-    assert.ok(stdout.includes("ralph.agent.md"));
-    assert.ok(stdout.includes("dry-run"));
+    // A throwaway HOME keeps the registration plan (which reads pi's settings)
+    // off the developer's real ~/.pi/agent.
+    const fakeHome = await mkdtemp(join(tmpdir(), "cli-pi-dry-run-home-"));
+    try {
+      const { exitCode, stdout } = await runCli(["install", "pi", "--dry-run"], { HOME: fakeHome });
+      assert.equal(exitCode, 0);
+      assert.ok(stdout.includes("ralph.agent.md"));
+      assert.ok(stdout.includes("dry-run"));
+    } finally {
+      await rm(fakeHome, { recursive: true, force: true });
+    }
   });
 
-  it("install pi --dry-run lists the pi packages it would install", async () => {
-    // Fake HOME keeps the pi user scope hermetic: both manifest packages are
-    // missing, so the plan contains exactly the declared sources.
+  it("install pi --dry-run reports the bundled pi packages it would stage", async () => {
     const fakeHome = await mkdtemp(join(tmpdir(), "cli-pi-home-"));
     try {
       const { exitCode, stdout } = await runCli(["install", "pi", "--dry-run"], { HOME: fakeHome });
       assert.equal(exitCode, 0);
-      assert.ok(stdout.includes("Would install pi package npm:pi-questions"), "planned pi-questions shown");
-      assert.ok(
-        stdout.includes("Would install pi package npm:pi-web-access@0.10.7"),
-        "planned pi-web-access shown",
-      );
+      assert.ok(stdout.includes("Bundled pi package pi-questions"), "pi-questions staged");
+      assert.ok(stdout.includes("Bundled pi package pi-web-access"), "pi-web-access staged");
+      assert.ok(stdout.includes(join(fakeHome, ".agent-cortex", "pi")), "default output is the home staging dir");
     } finally {
       await rm(fakeHome, { recursive: true, force: true });
     }
   });
 
-  it("exits 0 for install pi --output <tmp> and writes agent and config files", async () => {
+  it("exits 0 for install pi --output <tmp> and stages a loadable pi package", async () => {
     const outDir = await mkdtemp(join(tmpdir(), "cli-pi-install-"));
     try {
       const { exitCode, stdout } = await runCli(["install", "pi", "--output", outDir]);
@@ -294,9 +290,10 @@ describe("CLI integration", () => {
       assert.ok(stdout.includes("ralph.agent.md"));
       const ralph = await readFile(join(outDir, "agents", "ralph.agent.md"), "utf-8");
       assert.ok(ralph.includes("agent-cortex:ralph"));
-      const settings = JSON.parse(await readFile(join(outDir, "settings.json"), "utf-8"));
-      assert.ok(Array.isArray(settings.packages));
-      assert.ok(await readFile(join(outDir, "keybindings.json"), "utf-8"));
+      const manifest = JSON.parse(await readFile(join(outDir, "package.json"), "utf-8"));
+      assert.deepEqual(manifest.keywords, ["pi-package"]);
+      assert.ok(manifest.pi.extensions.includes("./extensions"));
+      assert.ok(manifest.pi.skills.includes("./skills"));
     } finally {
       await rm(outDir, { recursive: true, force: true });
     }

package/test/helpers/fake-pi.mjs

@@ -0,0 +1,132 @@
+// Shared test helper: a stateful fake `pi` binary for pi's package commands.
+// The real CLI is a genuine external system (and its user settings must never
+// be touched by tests), so tests drive this fake instead. It records every
+// invocation to `calls.log` (argv, space-joined, one line each) and simulates
+// just enough real behaviour to assert registration state:
+//
+//   --version          → exit 0 (availability probe)
+//   list               → configured package sources
+//   install <source>   → adds <source> to settings.json `packages`, persisted
+//                        relative to the settings file's directory (what real
+//                        pi does) unless an entry already resolves to it
+//   remove <source>    → drops the matching entry; exit 1 when none matches
+//
+// Local sources are resolved the way pi resolves them: relative to the
+// directory holding settings.json. `failWhen` makes any invocation whose argv
+// contains the substring exit 1 (command failures).
+//
+// Written async throughout (the fake is a child process and the helper's own
+// I/O is test code) — the repo's check-no-sync lint scans test/ for *Sync.
+
+import { chmod, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+
+const FAKE_PI_SCRIPT = [
+  "#!/usr/bin/env node",
+  "// Stateful fake for the `pi` package CLI (test/helpers/fake-pi.mjs).",
+  "const fs = require('node:fs/promises');",
+  "const path = require('node:path');",
+  "const os = require('node:os');",
+  "",
+  "const dir = __dirname;",
+  "const settingsFile = path.join(dir, 'settings.json');",
+  "const logFile = path.join(dir, 'calls.log');",
+  "const failWhenFile = path.join(dir, 'failWhen.txt');",
+  "",
+  "const expand = (p) => (p === '~' ? os.homedir() : p.startsWith('~/') ? path.join(os.homedir(), p.slice(2)) : p);",
+  "const sourceOf = (entry) => (typeof entry === 'string' ? entry : entry && entry.source);",
+  "// pi resolves a configured local source against the settings file's directory.",
+  "const resolvedSource = (entry) => path.resolve(dir, expand(sourceOf(entry)));",
+  "const resolvedArgument = (arg) => path.resolve(dir, expand(arg));",
+  "",
+  "(async () => {",
+  "  const argv = process.argv.slice(2);",
+  "  const joined = argv.join(' ');",
+  "  await fs.appendFile(logFile, joined + '\\n');",
+  "",
+  "  const failWhen = await fs.readFile(failWhenFile, 'utf8').catch(() => null);",
+  "  if (failWhen && joined.includes(failWhen)) process.exit(1);",
+  "",
+  "  if (argv[0] === '--version' || argv[0] === '-v') {",
+  "    console.log('1.4.0');",
+  "    process.exit(0);",
+  "  }",
+  "",
+  "  const readSettings = async () => {",
+  "    try {",
+  "      return JSON.parse(await fs.readFile(settingsFile, 'utf8'));",
+  "    } catch {",
+  "      return {};",
+  "    }",
+  "  };",
+  "  const writePackages = async (settings, packages) =>",
+  "    fs.writeFile(settingsFile, JSON.stringify({ ...settings, packages }, null, 2) + '\\n');",
+  "",
+  "  const [command, argument] = argv;",
+  "  const settings = await readSettings();",
+  "  const packages = settings.packages ?? [];",
+  "",
+  "  if (command === 'list') {",
+  "    if (packages.length === 0) {",
+  "      console.log('No packages installed.');",
+  "      process.exit(0);",
+  "    }",
+  "    console.log('User packages:');",
+  "    for (const entry of packages) console.log('  ' + sourceOf(entry));",
+  "    process.exit(0);",
+  "  }",
+  "",
+  "  if (command === 'install') {",
+  "    const target = resolvedArgument(argument);",
+  "    const persisted = path.relative(dir, target) || '.';",
+  "    const index = packages.findIndex((entry) => resolvedSource(entry) === target);",
+  "    if (index === -1) {",
+  "      packages.push(persisted);",
+  "    } else if (typeof packages[index] === 'string') {",
+  "      packages[index] = persisted;",
+  "    } else {",
+  "      packages[index] = { ...packages[index], source: persisted };",
+  "    }",
+  "    await writePackages(settings, packages);",
+  "    console.log('Installed ' + argument);",
+  "    process.exit(0);",
+  "  }",
+  "",
+  "  if (command === 'remove') {",
+  "    const target = resolvedArgument(argument);",
+  "    const next = packages.filter((entry) => resolvedSource(entry) !== target);",
+  "    if (next.length === packages.length) {",
+  "      console.error('No matching package found for ' + argument);",
+  "      process.exit(1);",
+  "    }",
+  "    await writePackages(settings, next);",
+  "    console.log('Removed ' + argument);",
+  "    process.exit(0);",
+  "  }",
+  "",
+  "  process.exit(0);",
+  "})().catch((err) => {",
+  "  console.error(err);",
+  "  process.exit(1);",
+  "});",
+].join("\n");
+
+/** Create a stateful fake `pi` binary in `dir`.
+ *
+ * The binary's own directory doubles as pi's settings directory, so a local
+ * package source is persisted relative to it exactly as real pi does.
+ * @param {string} dir  Directory to hold bin, calls.log, settings.json
+ * @param {{ failWhen?: string|null, packages?: unknown[] }} [options]
+ *   failWhen: invocations whose argv contains the substring exit 1;
+ *   packages: initial `packages` array for settings.json
+ * @returns {Promise<{ bin: string, log: string, settingsPath: string }>} */
+export async function makeFakePi(dir, { failWhen = null, packages = [] } = {}) {
+  const bin = join(dir, "pi");
+  const log = join(dir, "calls.log");
+  const settingsPath = join(dir, "settings.json");
+  await writeFile(bin, FAKE_PI_SCRIPT + "\n");
+  await chmod(bin, 0o755);
+  await writeFile(settingsPath, `${JSON.stringify({ packages }, null, 2)}\n`);
+  if (failWhen) await writeFile(join(dir, "failWhen.txt"), failWhen);
+  return { bin, log, settingsPath };
+}