gentle-pi 4.1.0 → 4.2.0

package/tests/install-wizard.test.ts

@@ -399,7 +399,7 @@ test("the review screen shows the notice about reused tools in folders another a
 });
 
 test("a recoverable stack is reviewed as completing setup, not as a reinstall", async () => {
-	const view = await serverPlanView({ pi: { available: true, version: "1.0.0", usable: true },
+	const view = await serverPlanView({ pi: { available: true, version: "1.2.0", usable: true },
 		shell: { available: true, version: requirements.shell, usable: true, global: true },
 		gentleAi: { available: true, version: requirements.gentleAi, usable: true, compatible: true },
 		setup: { available: true, recoverable: true } });
@@ -563,7 +563,7 @@ test("expectedSteps checks, updates and verifies an older Pi before any Gentle S
 test("a plan that only updates an older Pi is reviewed as a Pi update, with an Update Pi button", () => {
 	const document = new FakeDocument();
 	const model = wizard.planModel({ planId: "p", ready: false, channel: "release", blockers: [],
-		actions: [{ id: "update-pi", description: "Update Pi 0.87.1 to 1.0.0 with npm." }, { id: "verify-readiness", description: "Verify." }] });
+		actions: [{ id: "update-pi", description: "Update Pi 0.87.1 to 1.2.0 with npm." }, { id: "verify-readiness", description: "Verify." }] });
 	assert.equal(model.kind, "update-pi");
 	const view = wizard.renderPlan(document, model, { install: () => {}, reload: () => {}, close: () => {} });
 	assert.ok(headings(view)[0].textContent.includes("Update Pi"));

package/tests/installer-posix-bootstrap.test.ts

@@ -934,19 +934,19 @@ test("Go has no descriptor for other targets", () => {
 // The Engram release the bundled install ships (S9), from its checksums.txt and
 // the GitHub asset digests; every archive was downloaded and re-hashed.
 const engramPins = {
-	"darwin-arm64": ["darwin_arm64.tar.gz", "3d6b4ac0055883ec23d5b0a04a3cda041653cdf4916fd7e98944692e62fd0441", 7465858],
-	"darwin-x64": ["darwin_amd64.tar.gz", "3da8d7befe8500ff09aa44c48f493eda96513fd3f63c7e4bfb95e3ae85dfae52", 7952089],
-	"linux-x64": ["linux_amd64.tar.gz", "8694d3817b63c5fc5607b5919e88aa929bffa0bafda330513364e10c8ab61445", 7817468],
-	"linux-arm64": ["linux_arm64.tar.gz", "b4546b6e00f68e56da52064f1865c6cbae1d5b0633aeebc36e1a2f20b17683e7", 7168173],
-	"win32-x64": ["windows_amd64.zip", "e00afe91d1baade484d217606d78c2fd91e26a4f9823b603d050c1e4be78233c", 8013889],
-	"win32-arm64": ["windows_arm64.zip", "251d467017f88e4eb7fc186c635a9bf64db5aa39cfc251d35dd4035f38941454", 7224229],
+	"darwin-arm64": ["darwin_arm64.tar.gz", "d0aa59c9a83d17ae3fc7f5dd31fdab6a26fd8c00fc5e692195753cd0719294f7", 7470202],
+	"darwin-x64": ["darwin_amd64.tar.gz", "3c5bdc73d226af5629cf4f4a781e223142e37c1ebb443c4b596f2e284352e381", 7961674],
+	"linux-x64": ["linux_amd64.tar.gz", "715fda625556e46d65ddb4526bb7f88a3fee5339ca3c44ce44cc652f17fa57f1", 7821191],
+	"linux-arm64": ["linux_arm64.tar.gz", "3309e9c0bbb539d183fd5aa9f9a13cd7aa0e81ec2512b5bedefb8b2bdd35b3e5", 7176726],
+	"win32-x64": ["windows_amd64.zip", "3065736ec7ff8137eb3fc607275f542ea13bb743a5157318c8a8770f11ce3289", 8021225],
+	"win32-arm64": ["windows_arm64.zip", "7463872a85a5e5434cf958bdffc71dda1926bced30d3b6b38c80fec9bb98fbba", 7231641],
 } as const;
 test("fixed Engram descriptors are the GitHub release archives and checksums, and nothing else", () => {
 	for (const [target, [suffix, sha256, size]] of Object.entries(engramPins)) {
 		const [platform, arch] = target.split("-");
 		const artifact = artifactFor("engram", platform, arch);
-		assert.equal(artifact.version, "3.3.2");
-		assert.equal(artifact.url, `https://github.com/Gentleman-Programming/engram/releases/download/v3.3.2/engram_3.3.2_${suffix}`);
+		assert.equal(artifact.version, "3.4.0");
+		assert.equal(artifact.url, `https://github.com/Gentleman-Programming/engram/releases/download/v3.4.0/engram_3.4.0_${suffix}`);
 		assert.equal(artifact.integrity, `sha256-${sha256}`);
 		assert.deepEqual([artifact.size, artifact.maxBytes], [size, size]);
 		// GitHub serves release assets from its asset hosts.

package/tests/installer-preflight.test.ts

@@ -253,7 +253,7 @@ test("a missing Pi is installed before an existing Gentle Shell is updated", ()
 });
 
 test("an existing compatible Pi from any installation is reused and only Gentle Shell is installed", () => {
-	for (const pi of [tool("1.2.0"), { ...tool("1.0.4"), external: true }]) {
+	for (const pi of [tool("1.2.0"), { ...tool("1.2.4"), external: true }]) {
 		const plan = planPreflight({ ...installed(), pi, shell: absent, gentleAi: absent, setup: false });
 		assert.equal(plan.tools.pi.status, "reusable");
 		assert.deepEqual(updateIds(plan), ["install-shell", "setup-shell", "verify-readiness"]);
@@ -261,7 +261,7 @@ test("an existing compatible Pi from any installation is reused and only Gentle
 });
 
 test("a pnpm Pi newer than the installer's pin never blocks: Gentle Shell is added or updated beside it", () => {
-	const newer = { ...tool("1.1.0") };
+	const newer = { ...tool("1.2.1") };
 	const install = planPreflight({ ...installed(), pi: newer, shell: absent, gentleAi: absent, setup: false });
 	assert.deepEqual([install.blockers, updateIds(install)], [[], ["install-shell", "setup-shell", "verify-readiness"]]);
 	const update = planPreflight({ ...installed(), pi: newer, shell: owned("3.9.0"), gentleAi: unchecked, setup: unchecked });
@@ -363,7 +363,7 @@ test("missing Windows Go is acquired before reprovisioning an existing Shell", (
 // A pinned stack this pnpm installed whose setup did not finish (setup probe: recoverable).
 const recoverable = { available: true, recoverable: true };
 function partial(change: object = {}) {
-	return { ...installed(), pi: tool("1.0.0"), shell: { ...tool(requirements.shell), global: true }, setup: recoverable, ...change };
+	return { ...installed(), pi: tool("1.2.0"), shell: { ...tool(requirements.shell), global: true }, setup: recoverable, ...change };
 }
 
 test("a recoverable stack only reruns setup, with PATH setup when the global bin is off PATH", () => {

package/tests/installer-probes.test.ts

@@ -657,11 +657,11 @@ test("clean global list: Pi, Shell and Gentle AI absent and setup needed, from o
 });
 
 test("pnpm-global Pi and Shell report versions; verified package-native Gentle AI is compatible", async () => {
-	const stdout = listing({ "@earendil-works/pi-coding-agent": { version: "1.0.0", path: `${PNPM_HOME}/global/v11/def/node_modules/pi` },
+	const stdout = listing({ "@earendil-works/pi-coding-agent": { version: PI_INSTALL_VERSION, path: `${PNPM_HOME}/global/v11/def/node_modules/pi` },
 		"gentle-pi": { version: requirements.shell, path: SHELL_ROOT } });
 	const files = [TOOLS_PNPM, `${BIN}/gentle-shell`, gentleAiBinaryPath(SHELL_ROOT, "linux")];
 	const h = probes({ files, dirs: [HOME, PNPM_HOME, SHELL_ROOT], texts: besidePi(PI_INSTALL_VERSION), results: { [`${TOOLS_PNPM} ${LIST}`]: { code: 0, stdout } } });
-	assert.deepEqual(await h.probes.pi(), { available: true, version: "1.0.0", usable: true });
+	assert.deepEqual(await h.probes.pi(), { available: true, version: PI_INSTALL_VERSION, usable: true });
 	assert.deepEqual(await h.probes.shell(), { available: true, version: requirements.shell, usable: true, global: true, owner: "pnpm" });
 	assert.deepEqual(await h.probes.gentleAi(), { available: true, version: requirements.gentleAi, usable: true, compatible: true });
 	assert.deepEqual(h.integrityCalls, [{ packageRoot: SHELL_ROOT, platform: "linux", env: bootstrapEnv, home: HOME }]);
@@ -684,7 +684,7 @@ test("setup is recoverable only for the pinned Pi and Shell owned by one pnpm pr
 	const persisted = { dependencies: { npm: { version: "11.19.0" }, pnpm: { version: "11.1.1" } } };
 	assert.deepEqual(await setup(JSON.stringify([persisted, { dependencies: { [PI]: pi, "gentle-pi": shell } }])), recoverable);
 	const foreign = [
-		listing({ [PI]: { ...pi, version: "1.2.0" }, "gentle-pi": shell }),
+		listing({ [PI]: { ...pi, version: "1.2.1" }, "gentle-pi": shell }),
 		listing({ [PI]: pi, "gentle-pi": { ...shell, version: "3.0.0" } }),
 		listing({ "gentle-pi": shell }),
 		JSON.stringify([{ dependencies: { [PI]: pi, "gentle-pi": shell } }, { dependencies: { [PI]: pi } }]),
@@ -698,7 +698,7 @@ test("setup is recoverable only for the pinned Pi and Shell owned by one pnpm pr
 	assert.deepEqual(await setup(listing({ [PI]: pi, "gentle-pi": shell }), { realpaths: { [SHELL_ROOT]: "/elsewhere/gentle-pi" } }),
 		{ available: null });
 	// The Pi beside gentle-pi, which the launcher runs, may be pnpm's newer peer, but never below the minimum, unreadable or missing.
-	assert.deepEqual(await setup(listing({ [PI]: pi, "gentle-pi": shell }), { texts: besidePi("1.1.0") }), recoverable);
+	assert.deepEqual(await setup(listing({ [PI]: pi, "gentle-pi": shell }), { texts: besidePi("1.2.1") }), recoverable);
 	for (const texts of [besidePi("0.99.0"), { [BESIDE_PI]: "not json" }, { [`${PNPM_HOME}/elsewhere`]: "" }]) {
 		assert.deepEqual(await setup(listing({ [PI]: pi, "gentle-pi": shell }), { texts }), { available: null }, JSON.stringify(texts));
 	}
@@ -741,7 +741,7 @@ test("a pnpm-global Shell from the main channel is present with its main version
 
 const NPM_ROOT = "/usr/local/lib/node_modules";
 const NPM_SHELL = `${NPM_ROOT}/gentle-pi`;
-const outside = (shellVersion: string, { linked = false, piOutput = "1.0.4\n" } = {}) => probes({
+const outside = (shellVersion: string, { linked = false, piOutput = "1.2.4\n" } = {}) => probes({
 	env: { HOME, PATH: `${TOOLS}/pnpm/bin:/usr/local/bin:/usr/bin` },
 	files: [TOOLS_PNPM, "/usr/local/bin/pi", "/usr/local/bin/gentle-shell", "/usr/local/bin/npm"],
 	dirs: [HOME, NPM_ROOT, "/home/u/work/gentle-pi"],
@@ -752,7 +752,7 @@ const outside = (shellVersion: string, { linked = false, piOutput = "1.0.4\n" }
 });
 
 test("a Pi on PATH that pnpm does not manage is reused with the version it reports", async () => {
-	assert.deepEqual(await outside("3.9.0").probes.pi(), { available: true, version: "1.0.4", usable: true, external: true });
+	assert.deepEqual(await outside("3.9.0").probes.pi(), { available: true, version: "1.2.4", usable: true, external: true });
 	for (const piOutput of ["", "pi dev build\n"]) {
 		assert.deepEqual(await outside("3.9.0", { piOutput }).probes.pi(), { available: null, outsidePnpm: true }, piOutput);
 	}
@@ -791,13 +791,13 @@ test("an older pnpm-global Pi reports pnpm as its owner, and locatePi finds its
 });
 
 test("a pnpm-global Pi newer than the installer's pin reports no owner: it is reused as it is", async () => {
-	for (const version of ["1.0.1", "1.1.0", "2.0.0"]) {
+	for (const version of ["1.2.1", "1.3.0", "2.0.0"]) {
 		const newer = probes({ files: [TOOLS_PNPM], dirs: [HOME, PI_ROOT], results: { [`${TOOLS_PNPM} ${LIST}`]: { code: 0,
 			stdout: listing({ [PI_PACKAGE]: { version, path: PI_ROOT } }) } } });
 		assert.deepEqual(await newer.probes.pi(), { available: true, version, usable: true }, version);
 	}
 	// A newer Pi from elsewhere is reused as it is: pnpm does not own it.
-	assert.deepEqual(await outsidePi("1.1.0").probes.pi(), { available: true, version: "1.1.0", usable: true, external: true });
+	assert.deepEqual(await outsidePi("1.2.1").probes.pi(), { available: true, version: "1.2.1", usable: true, external: true });
 });
 
 test("an older Pi in npm's global root reports npm as its owner; one elsewhere has no owner", async () => {

package/tests/installer-runner.test.ts

@@ -724,7 +724,7 @@ test("install nonzero, signal or deadline fails and reports completed steps", as
 test("an existing global Pi or gentle-pi blocks before installation regardless of the plan", async () => {
 	const existing = [
 		listing(),
-		JSON.stringify([{ dependencies: { "@earendil-works/pi-coding-agent": { version: "1.2.0" } } }]),
+		JSON.stringify([{ dependencies: { "@earendil-works/pi-coding-agent": { version: "1.2.1" } } }]),
 		JSON.stringify([{ dependencies: {} }, { dependencies: { "gentle-pi": { version: "3.0.0" } } }]),
 		JSON.stringify([{ optionalDependencies: { "gentle-pi": { version: "4.0.0" } } }]),
 	];
@@ -1390,7 +1390,7 @@ test("setup recovery blocks when the installed stack changed between plan and ru
 	const stack = JSON.parse(listing());
 	const changed = [
 		"[]",
-		listing("1.2.0"),
+		listing("1.2.1"),
 		listing(PI_INSTALL_VERSION, "3.0.0"),
 		listing(PI_INSTALL_VERSION, requirements.shell, "/elsewhere/gentle-pi"),
 		JSON.stringify([...stack, { dependencies: { "gentle-pi": { version: requirements.shell, path: PACKAGE_ROOT } } }]),
@@ -1640,7 +1640,7 @@ const NPM_SHELL_ROOT = "/usr/local/lib/node_modules/gentle-pi";
 
 test("with a compatible Pi already installed, only Gentle Shell is added and Pi is left as it is", async () => {
 	// A pnpm Pi newer than PI_INSTALL_VERSION is kept too: gentle-pi gets its own pnpm group, nothing is replaced.
-	for (const version of ["1.2.0", PI_INSTALL_VERSION]) {
+	for (const version of ["1.2.1", PI_INSTALL_VERSION]) {
 		const h = harness({ results: { [LIST]: [piOnlyList(version), { code: 0, stdout: listing(version) }], [SHELL_ONLY_ADD]: { code: 0 } } });
 		const result = await runStandardInstall({ plan: existingPlan({ pi: tool(version) }), consent: true }, h.adapters);
 		assert.equal(result.outcome, "ready", version);
@@ -1652,7 +1652,7 @@ test("with a compatible Pi already installed, only Gentle Shell is added and Pi
 });
 
 test("adding only Gentle Shell still refuses a gentle-pi that pnpm already lists", async () => {
-	const h = harness({ results: { [LIST]: { code: 0, stdout: listing("1.2.0") } } });
+	const h = harness({ results: { [LIST]: { code: 0, stdout: listing("1.2.1") } } });
 	const result = await runStandardInstall({ plan: existingPlan({}), consent: true }, h.adapters);
 	assert.deepEqual([result.outcome, result.reason], ["blocked", "existing-stack"]);
 	assert.equal(h.calls.some((call) => call.args[1] === "add"), false);
@@ -1674,19 +1674,20 @@ test("Pi and gentle-pi are added as separate pnpm groups, so a later `pi update`
 
 test("verify-global-list accepts the Pi the launcher runs beside gentle-pi at the minimum or newer, and reports one other than the pin", async () => {
 	// pnpm's latest peer beside gentle-pi (or nested in it): Gentle Shell runs it, and the outcome says which.
-	for (const texts of [{ [besidePi(PACKAGE_ROOT)]: piPackage("1.1.0") }, { [nestedPi(PACKAGE_ROOT)]: piPackage("1.1.0") },
+	for (const texts of [{ [besidePi(PACKAGE_ROOT)]: piPackage("1.2.1") }, { [nestedPi(PACKAGE_ROOT)]: piPackage("1.2.1") },
 		{ [besidePi(PACKAGE_ROOT)]: piPackage(requirements.pi) }]) {
 		const h = harness({ texts });
 		const result = await runStandardInstall({ plan: plan(), consent: true }, h.adapters);
 		assert.equal(result.outcome, "ready", JSON.stringify(texts));
-		assert.equal(result.piVersion, Object.values(texts)[0].includes("1.1.0") ? "1.1.0" : requirements.pi);
+		const selectedVersion = JSON.parse(Object.values(texts)[0]).version;
+		assert.equal(result.piVersion, selectedVersion === PI_INSTALL_VERSION ? undefined : selectedVersion);
 	}
 	// The pin itself adds nothing to the outcome.
 	assert.equal("piVersion" in (await runStandardInstall({ plan: plan(), consent: true }, harness().adapters)), false);
 	const wrong = [
 		{ [besidePi(PACKAGE_ROOT)]: piPackage("0.99.0") },
 		// A Pi nested in gentle-pi resolves first, even below the minimum.
-		{ [nestedPi(PACKAGE_ROOT)]: piPackage("0.99.0"), [besidePi(PACKAGE_ROOT)]: piPackage("1.1.0") },
+		{ [nestedPi(PACKAGE_ROOT)]: piPackage("0.99.0"), [besidePi(PACKAGE_ROOT)]: piPackage("1.2.1") },
 		{ [besidePi(PACKAGE_ROOT)]: piPackage("1.2.0-beta.1") },
 		{ [besidePi(PACKAGE_ROOT)]: JSON.stringify({ name: "not-pi", version: PI_INSTALL_VERSION }) },
 		{ [besidePi(PACKAGE_ROOT)]: "not json" },
@@ -1706,10 +1707,10 @@ test("verify-global-list accepts the Pi the launcher runs beside gentle-pi at th
 });
 
 test("the main Shell is added alone and its adjacent Pi is verified like the release one", async () => {
-	const h = mainHarness(undefined, { texts: { [besidePi(MAIN_ROOT)]: piPackage("1.1.0") } });
+	const h = mainHarness(undefined, { texts: { [besidePi(MAIN_ROOT)]: piPackage("1.2.1") } });
 	const result = await runStandardInstall({ plan: mainPlan(), consent: true }, h.adapters);
 	assert.equal(result.outcome, "ready");
-	assert.equal(result.piVersion, "1.1.0");
+	assert.equal(result.piVersion, "1.2.1");
 	assert.deepEqual(h.calls.filter((call) => call.args[1] === "add").map((call) => call.args.slice(1)),
 		[INSTALL.split(" "), MAIN_ADD.split(" ")]);
 	const below = mainHarness(undefined, { texts: { [besidePi(MAIN_ROOT)]: piPackage("0.99.0") } });
@@ -1722,10 +1723,10 @@ test("a pnpm-owned Gentle Shell update is verified with a Pi at the minimum or n
 	const fixed = existingPlan({ shell: { available: true, version: "3.9.0", usable: true, global: true, owner: "pnpm" },
 		gentleAi: { available: null }, setup: { available: null } });
 	const located = [{ root: OLD_ROOT, version: "3.9.0", owner: "pnpm" }, { root: PACKAGE_ROOT, version: requirements.shell, owner: "pnpm" }];
-	const h = updateHarness({ located, texts: { [besidePi(PACKAGE_ROOT)]: piPackage("1.1.0") } });
+	const h = updateHarness({ located, texts: { [besidePi(PACKAGE_ROOT)]: piPackage("1.2.1") } });
 	const result = await runStandardInstall({ plan: fixed, consent: true }, h.adapters);
 	assert.equal(result.outcome, "ready");
-	assert.equal(result.piVersion, "1.1.0");
+	assert.equal(result.piVersion, "1.2.1");
 	assert.deepEqual(result.completed.slice(3, 5), ["update-shell", "verify-updated-shell"]);
 	for (const texts of [{ [besidePi(PACKAGE_ROOT)]: piPackage("0.99.0") }, { [nestedPi(PACKAGE_ROOT)]: piPackage("0.99.0") }]) {
 		const wrong = updateHarness({ located, texts });
@@ -1740,7 +1741,7 @@ test("a pnpm-owned Gentle Shell update is verified with a Pi at the minimum or n
 });
 
 test("a setup recovery accepts a newer Pi beside gentle-pi but not one below the minimum", async () => {
-	const newer = harness({ results: installedList, texts: { [besidePi(PACKAGE_ROOT)]: piPackage("1.1.0") } });
+	const newer = harness({ results: installedList, texts: { [besidePi(PACKAGE_ROOT)]: piPackage("1.2.1") } });
 	assert.equal((await runStandardInstall({ plan: recoveryPlan(), consent: true }, newer.adapters)).outcome, "ready");
 	const h = harness({ results: installedList, texts: { [besidePi(PACKAGE_ROOT)]: piPackage("0.99.0") } });
 	const result = await runStandardInstall({ plan: recoveryPlan(), consent: true }, h.adapters);
@@ -1942,7 +1943,7 @@ test("a Pi update is refused before any change when the installed Pi is not the
 	const plan = existingPlan({ pi: olderPi("pnpm") });
 	// Gone, unattributed, another version, another owner, or already current: never reinstalled, never downgraded.
 	for (const before of [null, { ...piBefore, owner: null }, { ...piBefore, version: "0.90.0" }, { ...piBefore, owner: "npm" },
-		{ ...piBefore, version: "1.2.0" }, { ...piBefore, version: PI_INSTALL_VERSION }, { ...piBefore, root: "relative/pi" }]) {
+		{ ...piBefore, version: "1.2.1" }, { ...piBefore, version: PI_INSTALL_VERSION }, { ...piBefore, root: "relative/pi" }]) {
 		const h = locatingPi(harness({ results: { [LIST]: piOnlyList("0.87.1") } }), [before]);
 		const result = await runStandardInstall({ plan, consent: true }, h.adapters);
 		assert.deepEqual([result.outcome, result.reason], ["blocked", "existing-stack-unverified"], JSON.stringify(before));

package/tests/installer-server.test.ts

@@ -298,7 +298,7 @@ test("/api/plan reports blockers with guidance and no profile change when alread
 
 test("/api/plan names the found and required version of an older Gentle Shell and how to resolve it", async () => {
 	const { host, port, login } = await start({ collect: async () => collected({
-		pi: { available: true, version: "1.0.4", usable: true },
+		pi: { available: true, version: "1.2.4", usable: true },
 		shell: { available: true, version: "3.4.0", usable: false, global: true },
 		gentleAi: { available: null }, setup: { available: null },
 	}) });
@@ -306,8 +306,8 @@ test("/api/plan names the found and required version of an older Gentle Shell an
 		const view = await plan(port, await login());
 		assert.deepEqual(view.blockers.map((blocker: { code: string; tool: string }) => [blocker.code, blocker.tool]), [["incompatible-tool", "shell"]]);
 		assert.equal(view.blockers[0].guidance,
-			"Gentle Shell 3.4.0 is installed globally with pnpm, but this installer needs 4.1.0 or newer. Nothing was replaced. " +
-			"Update it with `pnpm add -g gentle-pi@4.1.0`, or remove it with `pnpm remove -g gentle-pi`, then select Check again.");
+			"Gentle Shell 3.4.0 is installed globally with pnpm, but this installer needs 4.2.0 or newer. Nothing was replaced. " +
+			"Update it with `pnpm add -g gentle-pi@4.2.0`, or remove it with `pnpm remove -g gentle-pi`, then select Check again.");
 		assert.deepEqual(view.actions, []);
 	} finally {
 		await host.close("test");
@@ -449,7 +449,7 @@ test("/api/plan explains a pnpm in $PNPM_HOME/bin that the installer will not re
 
 test("/api/plan explains a Gentle Shell that neither pnpm nor npm manages", async () => {
 	const { host, port, login } = await start({ collect: async () => collected({
-		pi: { available: true, version: "1.0.4", usable: true },
+		pi: { available: true, version: "1.2.4", usable: true },
 		shell: { available: null, outsidePnpm: true }, gentleAi: { available: null }, setup: { available: null },
 	}) });
 	try {
@@ -514,7 +514,7 @@ test("the outcome says which Pi Gentle Shell runs only when it is not the instal
 
 test("/api/plan describes updating an existing Gentle Shell on either channel", async () => {
 	const shell = { available: true, version: "3.9.0", usable: true, global: true, owner: "npm" };
-	const { host, port, login } = await start({ collect: async (channel) => collectedFor(channel, { pi: { available: true, version: "1.0.4", usable: true },
+	const { host, port, login } = await start({ collect: async (channel) => collectedFor(channel, { pi: { available: true, version: "1.2.4", usable: true },
 		shell, go: { available: true, version: "1.26.0", usable: true }, gentleAi: { available: null }, setup: { available: null } }) });
 	try {
 		const cookie = await login();

package/tests/main-channel-upgrade.test.ts

@@ -5,6 +5,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import test from "node:test";
 import { CHANNEL_SCHEMA, MainChannelError, ownerManager, readChannel, removeGlobalShell, runUpgrade, writeChannel } from "../scripts/main-channel.mjs";
+import { requirements } from "../scripts/installer-preflight.mjs";
 
 const AI_SHA = "1f9d5e6423e37f7d2316859045f379ba9b5d8c3a";
 const SHELL_SHA = "6e7e3a18f794223396527a54c7c36d19c7d236c6";
@@ -53,6 +54,9 @@ function world({ owner = "pnpm", latest = "4.1.0", commits = { ai: AI_SHA, shell
 			for (const name of ["gentle-ai", "gentle-ai.exe"]) writeFileSync(join(options.env!.GOBIN, name), "#!/bin/sh\n", { mode: 0o755 });
 			return { code: 0, stdout: "" };
 		}
+		if (argv[0] === "version" && command === `${bin}/go`) {
+			return { code: 0, stdout: `go version go${requirements.go} ${platform}/amd64\n` };
+		}
 		if (argv[0] === "version") {
 			const sha = command.split("/").at(-2) ?? "";
 			return { code: 0, stdout: `gentle-ai 4.0.1-0.20261008202137-${sha.slice(0, 12)}\n` };
@@ -69,7 +73,9 @@ function world({ owner = "pnpm", latest = "4.1.0", commits = { ai: AI_SHA, shell
 	};
 	const which = async (name: string) => (tools.includes(name) ? `${bin}/${name}${name === "go" ? "" : suffix}` : null);
 	const upgrade = (args: string[], currentVersion = "4.0.0") => runUpgrade({ args, ctx, platform, packageRoot, currentVersion,
-		adapters: { fetch, run, fs, which, ...(invocation ? { invocation } : {}), ...(migrate ? { migrate } : {}) }, out: (line: string) => lines.push(line) });
+		adapters: { fetch, run, fs, which,
+			acquireGo: async () => { throw new Error("Unexpected Go acquisition in sandboxed upgrade fixture"); },
+			...(invocation ? { invocation } : {}), ...(migrate ? { migrate } : {}) }, out: (line: string) => lines.push(line) });
 	const installs = () => calls.filter((call) => call.argv.some((arg) => ["add", "install"].includes(arg)) && !call.argv.some((arg) => arg.includes("cmd/gentle-ai@")))
 		.map((call) => `${call.command} ${call.argv.join(" ")}`);
 	const manager = (command?: string) => ownerManager({ ctx, platform, packageRoot, adapters: { fs, run, which, ...(invocation ? { invocation } : {}) },

package/tests/odd-runtime-delegation-gate.test.ts

@@ -17,7 +17,10 @@ test("a second direct file is not refused based on session write history", async
 			events: { emit() {} }, registerCommand() {}, registerTool() {}, getFlag: () => undefined,
 			getActiveTools: () => ["edit", "write"],
 		} as unknown as ExtensionAPI;
-		createGentleAiExtension({ nativeReviewCli: null, processEnv: {}, resolveTelemetryTriggerBinary: () => "/usr/bin/true", telemetryTriggerSpawn: (() => undefined) as never })(pi);
+		// An isolated config home keeps the host's permission mode (for example Auto)
+		// out of a test that only exercises the ODD write gate.
+		const processEnv = { GENTLE_PI_CONFIG_HOME: join(cwd, ".config-home") };
+		createGentleAiExtension({ nativeReviewCli: null, processEnv, resolveTelemetryTriggerBinary: () => "/usr/bin/true", telemetryTriggerSpawn: (() => undefined) as never })(pi);
 		const ctx = {
 			cwd, hasUI: false, mode: "interactive", ui: { notify() {} },
 			sessionManager: { getSessionId: () => "odd-direct" },

package/tests/package-manifest.test.ts

@@ -133,13 +133,13 @@ test("public docs and metadata advertise ODD and review without retired phase wo
 
 test("technical reference declares the tested Pi minimum required for agent_settled", () => {
 	const manifest = readPackageJson();
-	assert.equal(manifest.peerDependencies?.["@earendil-works/pi-coding-agent"], ">=0.99.1");
-	assert.equal(manifest.devDependencies?.["@earendil-works/pi-coding-agent"], ">=1.0.0");
+	assert.equal(manifest.peerDependencies?.["@earendil-works/pi-coding-agent"], ">=1.2.0");
+	assert.equal(manifest.devDependencies?.["@earendil-works/pi-coding-agent"], ">=1.2.0");
 	assert.equal(manifest.peerDependenciesMeta?.["@earendil-works/pi-coding-agent"]?.optional, true);
 	assert.equal(manifest.engines?.node, ">=22.19.0");
 	for (const path of ["docs/readme-reference.md", "docs/gentle-shell.md"]) {
 		const source = readFileSync(join(PACKAGE_ROOT, path), "utf8");
-		assert.match(source, /Pi 0\.99\.1 or newer/, path);
+		assert.match(source, /Pi 1\.2\.0 or newer/, path);
 		assert.match(source, /open `>=1\.0\.0` development range/, path);
 		assert.doesNotMatch(source, /development tests pin Pi/, path);
 		// Docs name exactly the audited Vim editor releases, never a future one.
@@ -162,7 +162,7 @@ test("packed runtime uses optional Pi host peers with one open development range
 	// one exact release shared by every Pi host package.
 	const installed = new Set<string>();
 	for (const name of ["@earendil-works/pi-coding-agent", "@earendil-works/pi-ai", "@earendil-works/pi-tui"]) {
-		assert.equal(manifest.devDependencies?.[name], ">=1.0.0", name);
+		assert.equal(manifest.devDependencies?.[name], ">=1.2.0", name);
 		const metadata = JSON.parse(readFileSync(join(PACKAGE_ROOT, "node_modules", name, "package.json"), "utf8")) as { name: string; version: string };
 		assert.equal(metadata.name, name);
 		installed.add(metadata.version);
@@ -1789,9 +1789,9 @@ test("pi-pretty wrapper uses cached ESM loading for compiled and pnpm symlink in
 	assert.match(wrapper, /quietToolsEnabled/);
 });
 
-test("Gentle Shell v4.1.0 package manifest declares the release version", () => {
+test("Gentle Shell v4.2.0 package manifest declares the release version", () => {
 	const packageJson = readPackageJson();
-	assert.equal(packageJson.version, "4.1.0", "the release manifest must be explicitly pinned to v4.1.0");
+	assert.equal(packageJson.version, "4.2.0", "the release manifest must be explicitly pinned to v4.2.0");
 	assert.equal(packageJson.scripts?.test, "node scripts/run-test-suite.mjs");
 	assert.ok(packageJson.files?.includes("assets/"));
 	assert.ok(packageJson.files?.includes("contracts/"));

package/tests/pi-update-launcher.test.ts

@@ -0,0 +1,87 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { test } from 'node:test';
+
+const PI = '@earendil-works/pi-coding-agent';
+// A virtual symlink filesystem: listed global links point into a pnpm store.
+// The store's adjacent peer is a sibling, not Shell/node_modules/Pi.
+function launch(args: string[], scenario = 'owned') {
+ const adjacent = scenario.startsWith('adjacent');
+ const npm = scenario.startsWith('npm-');
+ const nodeModules = '/global/v11/selected/node_modules';
+ const shellRoot = '/store/shell-peer/node_modules/gentle-pi';
+ const piRoot = adjacent ? '/store/shell-peer/node_modules/' + PI : '/store/pi/node_modules/' + PI;
+ const target = adjacent ? 'gentle-pi' : PI;
+ const dependencies: Record<string, object> = {[target]:{path: `${nodeModules}/${target}`,
+  ...(scenario === 'npm-link' ? {link:true} : {}),
+  ...(scenario === 'npm-file' ? {resolved:'file:/source/pi'} : {})}};
+ if (scenario.endsWith('shared')) dependencies['unrelated'] = {path:`${nodeModules}/unrelated`};
+ if (scenario === 'separate') dependencies['unrelated'] = {path:'/global/v11/other/node_modules/unrelated'};
+ const groups = [{path:'/global/v11',dependencies}, ...(scenario === 'ambiguous' ? [{path:'/global/other',dependencies}] : [])];
+ const listing = scenario === 'malformed' ? '{' : JSON.stringify(npm ? groups[0] : groups);
+ // pnpm links only the top-level package into the global group; the peer
+ // is reachable solely as the Shell package's store sibling.
+ const links = {[`${nodeModules}/${target}`]:adjacent ? shellRoot : piRoot};
+ const roots = [nodeModules, '/global/v11/other/node_modules', shellRoot, piRoot, `${piRoot}/dist/bundle/cli.js`];
+ const bootstrap = `import { registerHooks } from 'node:module';
+ const original = ${JSON.stringify(new URL('../bin/gentle-shell.mjs', import.meta.url).href)};
+ registerHooks({load(url, context, next) {
+  if (url === original) {
+   let source = next(url, context).source.toString();
+   source = source.replace('const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));', ${JSON.stringify(`const packageRoot = '${shellRoot}';`)});
+   source = source.replace('const bundled = resolveBundledInstall({ packageRoot, platform: process.platform, fs: bundledFs, verifying });', 'const bundled = undefined;');
+   source = source.replace('runtime = resolvePiRuntime({', ${JSON.stringify(`runtime = ({ kind: '${adjacent ? 'bundled' : 'env'}', command: '${adjacent ? 'node' : piRoot + '/dist/bundle/cli.js'}', args: ${JSON.stringify(adjacent ? [piRoot + '/dist/bundle/cli.js'] : [])} }); /*`)}).replace('nodeExecPath: process.execPath,\\n\\t\\t});', 'nodeExecPath: process.execPath, */');
+   source = source.replace('const versionProbe = spawnSync(versionProbePlan.command, versionProbePlan.args, {', 'const versionProbe = { stdout: "1.2.0" }; /*').replace('env: bundledEnv ?? process.env,\\n\\t});', 'env: bundledEnv ?? process.env, */');
+   source = source.replace('async function packageManagerAdapters() {', 'async function packageManagerAdapters() { return globalThis.fakeAdapters; } async function unusedAdapters() {');
+   source = source.replace('let homeHadContentBeforeBootstrap = false;', 'if (passthrough.length === 1) { console.error("error: pi cannot self-update this installation. This installation is not managed by a global pnpm install."); process.exitCode = 1; return; } console.log("FORWARD " + JSON.stringify(passthrough)); return; let homeHadContentBeforeBootstrap = false;');
+   return {format:'module', source, shortCircuit:true};
+  }
+  return next(url,context);
+ }});
+ const links = ${JSON.stringify(links)}, roots = ${JSON.stringify(roots)};
+ globalThis.fakeAdapters = {
+  fs: { realpath: async p => { if (links[p]) return links[p]; if (roots.includes(p)) return p; throw new Error('ENOENT ' + p); },
+   readFile: async p => { if (p === '${shellRoot}/package.json') return JSON.stringify({name:'gentle-pi',version:'4.1.0'}); if(p === '${piRoot}/package.json') return JSON.stringify({name:'${PI}',version:'1.2.0',bin:{pi:'dist/bundle/cli.js'}}); throw new Error('ENOENT ' + p); } },
+  which: async n => n === '${npm ? 'npm' : 'pnpm'}' ? '/fake/' + n : null,
+  run: async (cmd, args) => {
+   if(args.includes('list') || args.includes('ls')) return {code:0,stdout:${JSON.stringify(listing)}};
+   console.log('MUTATION ' + JSON.stringify(args)); return {code:0};
+  }
+ };
+ await import(original);`;
+ return spawnSync(process.execPath, ['--import', `data:text/javascript,${encodeURIComponent(bootstrap)}`, 'bin/gentle-shell.mjs', ...args], {encoding:'utf8'});
+}
+
+for (const scenario of ['owned','adjacent','separate']) test(`public linked-store update succeeds for ${scenario}`, () => {
+ const result = launch(['update'], scenario);
+ assert.equal(result.status, 0, result.stderr);
+ assert.match(result.stdout, scenario === 'adjacent' ? /MUTATION \["add","-g","gentle-pi@4\.1\.0","--allow-build=gentle-pi"\]/ : /MUTATION \["add","-g","@earendil-works\/pi-coding-agent@latest"\]/);
+ assert.doesNotMatch(result.stdout, /FORWARD/);
+ // The fake manager changes nothing, so the readback reports the same version and pnpm's release-age rule.
+ assert.match(result.stdout, /the selected Pi is still 1\.2\.0\./);
+ assert.match(result.stdout, /minimumReleaseAge/);
+ assert.equal(result.stderr, '');
+});
+
+test('public all updates only its owner and then forwards extension updates', () => {
+ const result = launch(['update', '--all']);
+ assert.equal(result.status, 0, result.stderr);
+ assert.match(result.stdout, /MUTATION .*add.*@earendil-works\/pi-coding-agent@latest/);
+ assert.match(result.stdout, /FORWARD \["update","--extensions"\]/);
+ assert.equal(result.stderr, '');
+});
+
+for (const scenario of ['ambiguous', 'malformed', 'npm-link', 'npm-file', 'shared', 'adjacent-shared']) test(`public update rejects ${scenario} ownership without mutation`, () => {
+ const result = launch(['update'], scenario);
+ assert.equal(result.status, 1, result.stdout);
+ assert.equal(result.stdout, '');
+ assert.match(result.stderr, /ownership/);
+ assert.doesNotMatch(result.stdout + result.stderr, /MUTATION/);
+});
+
+test('public extensions-only update preserves the forwarded command', () => {
+ const result = launch(['update', '--extensions-only']);
+ assert.equal(result.status, 0, result.stderr);
+ assert.equal(result.stdout, 'FORWARD ["update","--extensions-only"]\n');
+ assert.equal(result.stderr, '');
+});