From 855ad35c22de29ff9c4d37f2eda186960d417d06 Mon Sep 17 00:00:00 2001 From: Michael Wang Date: Wed, 18 Nov 2026 19:34:12 +0000 Subject: [PATCH] fix(skills): the launcher's floor is 0.9.67 (#8205) * fix(skills): the launcher's floor is 0.9.67 The skill launcher now refuses any HyperFrames release older than 0.9.67, the latest release and the oldest one the HyperFrames Desktop app will accept. This applies to --cli-version, to HYPERFRAMES_STANDALONE_CLI_VERSION, to a helper started with --script and to a plugin manifest pin. A standalone install's default npx range starts at 0.9.67. Every plugin manifest in this repo already pins 0.9.67. The skills guide and the plugin installation reference name the new floor. * docs(skills): the launcher floor stays at or above Desktop's oldest accepted release Desktop currently accepts 0.9.66 and later, and a pending Desktop change raises that to 0.9.67. The launcher's comment now says its floor stays at or above the oldest release Desktop accepts, without naming a Desktop version, so it stays true when Desktop moves. --- docs/guides/skills.mdx | 2 +- skills-manifest.json | 2 +- .../references/plugin-installation.md | 2 +- skills/hyperframes/scripts/plugin-cli.mjs | 8 ++++---- .../hyperframes/scripts/plugin-cli.test.mjs | 20 +++++++++---------- 5 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/guides/skills.mdx b/docs/guides/skills.mdx index 5a241228dd..36779f647d 100644 --- a/docs/guides/skills.mdx +++ b/docs/guides/skills.mdx @@ -153,7 +153,7 @@ particular release, the agent passes `--cli-version latest` or `--cli-version ` before the command. Take an exact version from the person, from the version an upgrade moves the pins to, or from `--cli-version latest --version`. Never take it from the project's own files: a `package.json` -pin does not choose the CLI unless the person asks for that release. The launcher refuses a release older than its floor (currently 0.9.65), the oldest one with +pin does not choose the CLI unless the person asks for that release. The launcher refuses a release older than its floor (currently 0.9.67), the oldest one with the protections for received projects, and its error names the floor. Use the launcher from the loaded skill installation for commands shown in CLI output, too. For example, run `node "/hyperframes/scripts/plugin-cli.mjs" --cli-version latest --version` diff --git a/skills/hyperframes/scripts/plugin-cli.mjs b/skills/hyperframes/scripts/plugin-cli.mjs index 2db011cb04..79c97a1fb0 100644 --- a/skills/hyperframes/scripts/plugin-cli.mjs +++ b/skills/hyperframes/scripts/plugin-cli.mjs @@ -18,11 +18,11 @@ const manifests = [ "gemini-extension.json", ]; -// The oldest release this launcher starts, for a plugin pin or any standalone selection. It matches -// the oldest release the HyperFrames Desktop app ships, which has every protection for projects -// received from someone else, so a pin copied from a project never runs a CLI without them. +// The oldest release this launcher starts, for a plugin pin or any standalone selection. It stays at +// or above the oldest release the HyperFrames Desktop app accepts, which has every protection for +// projects received from someone else, so a pin copied from a project never runs a CLI without them. // Desktop's release checks read this line from the published package, so it stays a string literal. -const CLI_FLOOR = "0.9.65"; +const CLI_FLOOR = "0.9.67"; export const STANDALONE_CLI = `hyperframes@>=${CLI_FLOOR}`; const realOrResolved = (path) => { diff --git a/skills/hyperframes/scripts/plugin-cli.test.mjs b/skills/hyperframes/scripts/plugin-cli.test.mjs index b2179bd5e2..cbc75c23eb 100644 --- a/skills/hyperframes/scripts/plugin-cli.test.mjs +++ b/skills/hyperframes/scripts/plugin-cli.test.mjs @@ -64,7 +64,7 @@ test("a standalone install runs the newest CLI that moves into the project, and cwd: "/work/project", npmCwd: "/home/person", }); - assert.equal(STANDALONE_CLI, "hyperframes@>=0.9.65"); + assert.equal(STANDALONE_CLI, "hyperframes@>=0.9.67"); assert.equal(result.command, "npx"); assert.equal(result.cwd, "/home/person"); assert.deepEqual(result.args, ["--yes", STANDALONE_CLI, "skills", "update"]); @@ -97,7 +97,7 @@ test("standalone release selection keeps npm in the home folder and passes only }; for (const [release, args] of [ ["latest", ["upgrade", "--project", ".", "--check"]], - ["0.9.65+build-1", ["--version"]], + ["0.9.67+build-1", ["--version"]], ["1.0.0-rc.1", ["reverse", "start", "a b.mp4"]], ]) { const run = invocation(["--cli-version", release, ...args], options); @@ -121,8 +121,8 @@ test("standalone release selection keeps npm in the home folder and passes only /requires latest or an exact/, ); } - for (const release of ["0.9.33", "0.9.65-rc.1+build"]) { - assert.throws(() => invocation(["--cli-version", release], options), /0\.9\.65 or newer/); + for (const release of ["0.9.33", "0.9.67-rc.1+build"]) { + assert.throws(() => invocation(["--cli-version", release], options), /0\.9\.67 or newer/); } assert.throws( () => invocation(["--cli-version", "latest"], { version: "1.2.3" }), @@ -134,14 +134,14 @@ test("standalone release selection keeps npm in the home folder and passes only // received project's package.json could start a CLI without the protections for received projects. test("a standalone selection older than the floor is refused, by flag or by environment", () => { const options = { version: null, platform: "linux", npmCwd: "/home/person", env: {} }; - const tooOld = /lacks protections for received projects; this launcher runs 0\.9\.65 or newer/; - for (const release of ["0.9.34", "0.9.63", "0.9.64"]) { + const tooOld = /lacks protections for received projects; this launcher runs 0\.9\.67 or newer/; + for (const release of ["0.9.34", "0.9.65", "0.9.66"]) { assert.throws(() => invocation(["--cli-version", release, "check"], options), tooOld); const env = { HYPERFRAMES_STANDALONE_CLI_VERSION: release }; assert.throws(() => invocation(["check"], { ...options, env }), tooOld); assert.throws(() => invocation(["--script", "helper.mjs"], { ...options, env }), tooOld); } - for (const release of ["latest", "0.9.65", "0.10.0"]) { + for (const release of ["latest", "0.9.67", "0.10.0"]) { const env = { HYPERFRAMES_STANDALONE_CLI_VERSION: release }; const spec = `hyperframes@${release}`; assert.equal(invocation(["--cli-version", release, "check"], options).args[1], spec); @@ -306,11 +306,11 @@ for (const [install, manifest, spec] of [ } test("rejects a plugin release older than the first one this launcher runs", (t) => { - for (const version of ["0.9.33", "0.9.64", "0.9.65-alpha.1", "0.8.99"]) { + for (const version of ["0.9.33", "0.9.66", "0.9.67-alpha.1", "0.8.99"]) { const { root } = fixture(t, "plugin.json", version); - assert.throws(() => pluginVersion(root), /this launcher runs 0\.9\.65 or newer/); + assert.throws(() => pluginVersion(root), /this launcher runs 0\.9\.67 or newer/); } - for (const version of ["0.9.65", "0.10.0", "1.0.0-beta.1"]) { + for (const version of ["0.9.67", "0.10.0", "1.0.0-beta.1"]) { const { root } = fixture(t, "plugin.json", version); assert.equal(pluginVersion(root), version); }