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.
This commit is contained in:
Michael Wang
2026-11-18 19:34:12 +00:00
committed by GitHub
parent fadad3f12d
commit 855ad35c22
5 changed files with 17 additions and 17 deletions
+1 -1
View File
@@ -153,7 +153,7 @@ particular release, the agent passes `--cli-version latest` or `--cli-version <e
the installed launcher before the CLI command. This also works for releases with a prerelease
suffix. A project's `package.json` pin does not choose that release; the agent runs a pinned
release only when you ask for it. The launcher refuses a release older than its floor, whether a
plugin pins it or the agent selects it. The floor (currently 0.9.65) is the oldest release with
plugin pins it or the agent selects it. The floor (currently 0.9.67) is the oldest release with
the protections for projects you receive from others. Plugin installs keep their pin.
The agent runs a project's own npm scripts only when you ask for one by name.
+1 -1
View File
@@ -6,7 +6,7 @@
"files": 3
},
"hyperframes": {
"hash": "e39e211438a19c73",
"hash": "71efd98a0e1a4078",
"files": 81
},
"hyperframes-cli": {
@@ -24,7 +24,7 @@ Without a plugin manifest, the launcher runs the newest compatible published CLI
release, put `--cli-version latest` or `--cli-version <exact-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 "<SKILLS>/hyperframes/scripts/plugin-cli.mjs" --cli-version latest --version`
+4 -4
View File
@@ -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) => {
+10 -10
View File
@@ -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);
}