Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

fix(installer): remove the macOS 26 version gate

罗高ee82fb5f142c
diff --git a/docs/install.md b/docs/install.md
index 8bebd810..011603d8 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -6,7 +6,7 @@ If you are reading this file in the source repository and see `{{...}}`, it is a
## Instructions for the Agent
-1. Collect OS/CPU, Node.js/npm versions and the current Agent identity together, using the host's supplied context where available. Node.js 22.18+ with npm and the Agent must already be installed. Supported native targets: {{TARGETS}}. Do not claim support for another target from package-download success.
+1. Collect OS/CPU, Node.js/npm versions and the current Agent identity together, using the host's supplied context where available. Node.js 22.18+ with npm and the Agent must already be installed. Supported native targets: {{TARGETS}}. If a macOS target has no declared minimum version, proceed with setup and native executable checks; do not infer a minimum from the build/test machine's OS version. Do not claim support for another target from package-download success.
2. Select the current host explicitly: `codex` (Codex), `claude` (Claude Code), `deepseek` (DeepSeek Harness) or `workbuddy` (WorkBuddy). An explicit user selection takes precedence. Do not infer the current host from which CLIs happen to be installed. Ask only when the current host or required profile cannot be established. Configure only that host; preserve projects, credentials and unrelated MCP/Skills settings.
3. For a test candidate, use a separate host profile, application home, project data and Skills directory. Keep those paths and reuse them for prepare and future reconnects. The [platform installation recipes]({{DETAILS_URL}}) describe the actual supported options. Do not run a test candidate into the user's daily profile by default.
4. Choose exactly one setup command below, applying the test isolation paths first when required. Setup starts checked video-component downloads in the background. Do not wait for prepare to connect MCP, create/edit projects or open ordinary preview. Studio shows preparation status and retry; media import, automated capture and export require their respective components. Compatible phase-one updates can keep existing connections; reconnect closed or incompatible transports. When the current host can discover the eleven public Tools and five Skills, verify the version/environment and make an actual `motion_get_project` call. If the current chat has not loaded them, report that limitation; registration alone does not prove loading. Do not postpone the installation reply or invitation until a new chat or the first MCP call.
diff --git a/docs/npm-installation.md b/docs/npm-installation.md
index 717fc1b2..b48410cd 100644
--- a/docs/npm-installation.md
+++ b/docs/npm-installation.md
@@ -59,7 +59,7 @@ Set-Location "$motionTest\workspace"
codex
```
-These are documented commands, not proof of Windows acceptance. Use a directly executable host or pass its JavaScript CLI through `--codex`. The native lock declares Mac arm64/macOS 26 and Windows x64/Windows 11; other platforms are not implied supported by npm installation.
+These are documented commands, not proof of Windows acceptance. Use a directly executable host or pass its JavaScript CLI through `--codex`. The native lock declares Mac arm64 and Windows x64/Windows 11. OpenMotion adds no macOS version gate: proceed with installation and the native executable checks, rather than treating the build/test machine's OS version as a minimum. Node.js and the pinned browser/media binaries must still run on the target machine; this is not acceptance of every macOS version. Other platforms are not implied supported by npm installation.
## Test template data (DEV)
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index 67dafb3f..d9ab5202 100644
--- a/docs/product/architecture.md
+++ b/docs/product/architecture.md
@@ -269,6 +269,8 @@ The `@openmotion/app` npm tgz contains installer scripts, the prebuilt applicati
Explicit test/DEV and stable/prod builds produce publishable artifact metadata with candidate/stage defaults; source manifests, unversioned builds and channel/environment mismatches stay private. New public test versions use DEV template routing; catalog access still depends on service network/authentication. No private catalog payloads or credentials are bundled. Existing versions retain their original defaults. Packaging does not publish, update users, move main or rename the repository. DEV packages embed their template source, default to a separate installation home and refuse cross-environment reuse. Application, project data, host configuration and dependency cache retain distinct ownership. See [installation](../npm-installation.md) and [test/stable acceptance](../release-guide.md).
+Mac arm64 installation and complete-bundle startup impose no additional macOS version floor. Platform/CPU matching and native executable checks still apply; the target machine must run its Node.js and pinned browser/media tools. Build/test OS versions are evidence for those runs, not installation minimums or acceptance of every older macOS version. Windows x64 retains its Windows 11 requirement.
+
## 演进约束
The application npm format is the default; complete platform ZIPs are backups. Ordinary PR CI scans tracked source and both npm archive layers without publication credentials. Separate manual candidate-build and npm-publication entries implement build → local testing → manual publish. Candidate build, npm publication and snapshot recovery run only from feature/motion; main registers their manual entries without aliasing Motion operations. The build freezes the selected dispatch commit (or an explicitly integrated source SHA). Test builds use DEV; an empty test version uses the next source patch plus short test.N from the workflow counter and historical offset, without rewriting the source baseline. Reruns add an attempt suffix. Stable builds require an explicit new version and prod configuration. Each immutable candidate includes candidate-install.md and an identity-filled acceptance checklist. Publication resolves a unique unexpired artifact from a successful registered build, checks official ZIP/file hashes and source integration, then records the actual operator. No acceptance checkbox or independent approval environment is enabled; the receipt is not proof of private tests or review.
diff --git a/docs/test-packages.md b/docs/test-packages.md
index 0f590516..b37ec024 100644
--- a/docs/test-packages.md
+++ b/docs/test-packages.md
@@ -29,10 +29,10 @@ PR / main 工作流执行清单、类型、Studio 构建与回归、安装/打
| 测试包 | 最低系统要求 | 构建 / 运行验收 |
|---|---|---|
-| mac-arm64 | macOS 26.0,本轮支持与验证基线,旧系统未验收 | Linux 装配 / Mac 本机验收 |
+| mac-arm64 | macOS / Apple Silicon; no additional installer version gate | Linux 装配 / Mac 本机验收;旧系统仍需独立验收 |
| win-x64 | Windows 11,实际链路以 smoke 结果为准 | Linux 装配 / Windows 目标机独立验收 |
-没有 Linux、Intel Mac 或 Windows arm64 完整包,也没有旧 macOS 兼容承诺。本需求不重新选择编辑器方案。
+没有 Linux、Intel Mac 或 Windows arm64 完整包。macOS 安装不按系统版本提前拒绝;Node、浏览器和媒体工具仍须通过目标机的可执行检查,移除门槛不等于所有旧系统均已验收。本需求不重新选择编辑器方案。
## 完整 ZIP 备用试安装
diff --git a/scripts/bundle/bootstrap.mjs b/scripts/bundle/bootstrap.mjs
index 3768c3dd..6b02dbfd 100644
--- a/scripts/bundle/bootstrap.mjs
+++ b/scripts/bundle/bootstrap.mjs
@@ -7,7 +7,6 @@ const root = path.dirname(fileURLToPath(import.meta.url));
const metadata = JSON.parse(fs.readFileSync(path.join(root, 'release.json'), 'utf8'));
const windows = process.platform === 'win32';
if (metadata.target !== (windows ? 'win-x64' : 'mac-arm64') || process.arch !== (windows ? 'x64' : 'arm64')) throw new Error('此测试包与当前系统/CPU 不匹配');
-if (!windows && Number(os.release().split('.')[0]) < 25) throw new Error('当前固定 FFmpeg 测试运行时要求 macOS 26.0 或以上');
if (windows && Number(os.release().split('.')[2]) < 22000) throw new Error('此测试包要求 Windows 11 或以上');
const media = path.join(root, 'runtime/media/bin'), node = path.join(root, windows ? 'runtime/node' : 'runtime/node/bin');
const suffix = windows ? '.exe' : '';
diff --git a/scripts/install-guide.mjs b/scripts/install-guide.mjs
index 2b756ac9..fcb8c18a 100644
--- a/scripts/install-guide.mjs
+++ b/scripts/install-guide.mjs
@@ -22,7 +22,7 @@ export function validateGuideIdentity(pkg, manifest) {
assert.match(manifest.commit || '', /^[a-f0-9]{40}$/, 'Require the built source SHA');
for (const hash of [manifest.application?.sha256, manifest.locks?.npm, manifest.locks?.native]) assert.match(hash || '', /^[a-f0-9]{64}$/, 'Require release checksums');
const targets = Object.values(manifest.runtime?.targets || {});
- assert(targets.length > 0 && targets.every(t => t.platform && t.arch && t.minimumOS), 'Require native target declarations');
+ assert(targets.length > 0 && targets.every(t => t.platform && t.arch && (t.platform === 'darwin' || t.minimumOS)), 'Require native target declarations (minimum system version required outside macOS)');
return pkg.version.includes('-test.') ? 'test' : 'stable';
}
@@ -33,7 +33,7 @@ export async function generateInstallGuide(tgz, output, candidate = false) {
const digest = await sha256(tgz), packageSpec = `${pkg.name}@${pkg.version}`;
const values = { VERSION: pkg.version, PACKAGE_SPEC: packageSpec, CHANNEL: channel, COMMIT: manifest.commit,
TEMPLATE_ENVIRONMENT: manifest.templateEnvironment, TGZ_SHA256: digest,
- TARGETS: Object.values(manifest.runtime.targets).map(t => `${t.platform}/${t.arch} (${t.minimumOS}+)`).join(', '),
+ TARGETS: Object.values(manifest.runtime.targets).map(t => `${t.platform}/${t.arch}${t.minimumOS ? ` (${t.minimumOS}+)` : ''}`).join(', '),
DETAILS_URL: `https://github.com/nexu-io/html-anything/blob/${manifest.commit}/docs/npm-installation.md` };
const template = await readFile(new URL('../docs/install.md', import.meta.url), 'utf8');
// The repository warning is unnecessary after all release placeholders are resolved.
diff --git a/scripts/npm-runtime.mjs b/scripts/npm-runtime.mjs
index ec6673c3..d1c75f41 100644
--- a/scripts/npm-runtime.mjs
+++ b/scripts/npm-runtime.mjs
@@ -96,7 +96,6 @@ async function prepareComponent(native, component) {
}
if (await ready(native, component)) return;
const asset = info[component];
- if (process.platform === 'darwin') assert(Number(os.release().split('.')[0]) >= 25, 'Pinned native downloads require macOS 26 or later; supply compatible media and browser paths on older systems.');
if (process.platform === 'win32') assert(Number(os.release().split('.')[2]) >= 22000, 'Pinned native runtime requires Windows 11 or later');
console.error(`OpenMotion: preparing pinned ${component} in the background.`);
const archive = path.join(config.cacheDirectory, 'downloads', asset.sha256 + (new URL(asset.url).pathname.endsWith('.zip') ? '.zip' : '.tar.gz'));
diff --git a/scripts/package-npm.mjs b/scripts/package-npm.mjs
index d9970db7..577cc705 100644
--- a/scripts/package-npm.mjs
+++ b/scripts/package-npm.mjs
@@ -47,7 +47,7 @@ export function checkReleaseLocks(pkg, lockfile, runtime) {
assert.equal(runtime.chromium, PUPPETEER_REVISIONS['chrome-headless-shell'], 'Browser must match the locked Puppeteer release');
assert(Object.keys(runtime.targets || {}).length, 'At least one native target is required');
for (const target of Object.values(runtime.targets)) {
- assert(target.platform && target.arch && target.minimumOS, 'Native runtime requires an OS/CPU and minimum system version');
+ assert(target.platform && target.arch && (target.platform === 'darwin' || target.minimumOS), 'Native runtime requires an OS/CPU and, outside macOS, a minimum system version');
for (const key of ['node', ...nativeComponents(target)]) {
assert.equal(new URL(target[key].url).protocol, 'https:', 'Native sources require HTTPS');
assert.match(target[key].sha256, /^[a-f0-9]{64}$/, 'Pin native SHA256: ' + key);
diff --git a/scripts/runtime-lock.json b/scripts/runtime-lock.json
index f481e88e..097aba9f 100644
--- a/scripts/runtime-lock.json
+++ b/scripts/runtime-lock.json
@@ -7,7 +7,6 @@
"mac-arm64": {
"platform": "darwin",
"arch": "arm64",
- "minimumOS": "26.0",
"node": {
"url": "https://nodejs.org/dist/v26.11.1/node-v26.11.1-darwin-arm64.tar.gz",
"sha256": "d916511b55965e91be7a88e17f88d895b6793ceaba3e6c9b194aefe51c2c65ac",
diff --git a/tests/install-guide.test.ts b/tests/install-guide.test.ts
index a797fbd9..1b82906b 100644
--- a/tests/install-guide.test.ts
+++ b/tests/install-guide.test.ts
@@ -12,7 +12,7 @@ import { runFile } from '../scripts/runtime-assets.mjs';
const pkg = { name: '@openmotion/app', version: '0.6.4-test.1', private: false, bin: { openmotion: 'scripts/npm-installer.mjs' } };
const manifest = { schemaVersion: 1, version: pkg.version, templateEnvironment: 'dev', commit: 'a'.repeat(40),
application: { sha256: 'b'.repeat(64) }, locks: { npm: 'c'.repeat(64), native: 'd'.repeat(64) },
- runtime: { targets: { mac: { platform: 'darwin', arch: 'arm64', minimumOS: '26.0' } } } };
+ runtime: { targets: { mac: { platform: 'darwin', arch: 'arm64' }, windows: { platform: 'win32', arch: 'x64', minimumOS: 'Windows 11' } } } };
const config = { endpoint: 'https://example.r2.cloudflarestorage.com', bucket: 'example-guides', publicOrigin: 'https://download.example.invalid' };
test('installation URLs separate the moving channel entry from the exact immutable version', () => {
assert.equal(storagePlan({ channel: 'test', version: pkg.version }, config).versionKey, `open-motion/dev/${pkg.version}/install.md`);
@@ -20,17 +20,32 @@ test('installation URLs separate the moving channel entry from the exact immutab
assert.equal(storagePlan({ channel: 'stable', version: '0.6.4' }, config).versionKey, 'open-motion/0.6.4/install.md');
assert.equal(storagePlan({ channel: 'stable', version: '0.6.4' }, config).fixedKey, 'open-motion/install.md');
});
-async function fixture(t: any, candidate = false) {
+async function fixture(t: any, candidate = false, declaration = manifest) {
const root = await mkdtemp(path.join(os.tmpdir(), 'motion-guide-test-')); t.after(() => rm(root, { recursive: true, force: true }));
await mkdir(path.join(root, 'package/payload'), { recursive: true });
await writeFile(path.join(root, 'package/package.json'), JSON.stringify(pkg));
- await writeFile(path.join(root, 'package/payload/release-npm.json'), JSON.stringify(manifest));
+ await writeFile(path.join(root, 'package/payload/release-npm.json'), JSON.stringify(declaration));
const tgz = path.join(root, 'candidate.tgz');
await runFile('tar', ['-czf', tgz, '-C', root, 'package']);
const directory = path.join(root, 'guide'), record = await generateInstallGuide(tgz, directory, candidate);
return { directory, record };
}
const previousGuide = '# Install OpenMotion 0.6.3-test.1\n';
+test('guides allow macOS without a version floor and retain declared minimums for other targets and older packages', async t => {
+ const { directory } = await fixture(t);
+ const text = await readFile(path.join(directory, 'install.md'), 'utf8');
+ assert(text.includes('darwin/arm64, win32/x64 (Windows 11+)'));
+ assert(!text.includes('26.0+') && !text.includes('undefined+'));
+ const missingWindowsMinimum = structuredClone(manifest);
+ missingWindowsMinimum.runtime.targets.windows.minimumOS = '';
+ assert.throws(() => validateGuideIdentity(pkg, missingWindowsMinimum), /native target/);
+ const missingCPU = structuredClone(manifest);
+ missingCPU.runtime.targets.mac.arch = '';
+ assert.throws(() => validateGuideIdentity(pkg, missingCPU), /native target/);
+ const legacy = { ...manifest, runtime: { targets: { ...manifest.runtime.targets, mac: { ...manifest.runtime.targets.mac, minimumOS: '26.0' } } } };
+ const older = await fixture(t, false, legacy);
+ assert((await readFile(path.join(older.directory, 'install.md'), 'utf8')).includes('darwin/arm64 (26.0+)'));
+});
function storage(directory: string, record: any, previous = previousGuide) {
const plan = storagePlan(record, config), objects = new Map<string, Buffer>(), writes: any[] = [];
objects.set(plan.fixedKey, Buffer.from(previous));
diff --git a/tests/native-runtime.test.ts b/tests/native-runtime.test.ts
index 09742034..fa4e9e6c 100644
--- a/tests/native-runtime.test.ts
+++ b/tests/native-runtime.test.ts
@@ -1,7 +1,7 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import { cp, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
+import os, { tmpdir } from 'node:os';
import path from 'node:path';
import { spawn } from 'node:child_process';
import { once } from 'node:events';
@@ -35,6 +35,16 @@ async function fixture(t: any) {
return { directory, root, assets, config, configFile };
}
+test('native preparation checks executable tools without rejecting macOS 15 by kernel version', { skip: process.platform === 'win32' }, async t => {
+ const descriptor = Object.getOwnPropertyDescriptor(process, 'platform')!;
+ Object.defineProperty(process, 'platform', { value: 'darwin' });
+ t.after(() => Object.defineProperty(process, 'platform', descriptor));
+ t.mock.method(os, 'release', () => '24.6.0');
+ const { root } = await fixture(t);
+ await ensureNativeRuntime(root);
+ assert.equal((await nativeRuntimeStatus(root)).capabilities.export, true);
+});
+
test('cold status is readable without downloading, and runtime guards do not create export jobs', { skip: process.platform === 'win32' }, async t => {
const { directory, root } = await fixture(t);
const initial = await nativeRuntimeStatus(root);
diff --git a/tests/npm-package.test.ts b/tests/npm-package.test.ts
index 765a235c..37fd4322 100644
--- a/tests/npm-package.test.ts
+++ b/tests/npm-package.test.ts
@@ -31,6 +31,11 @@ test('shared Agent instructions keep the release controls synchronized', async (
test('release packaging rejects floating npm versions, lock drift, unpinned native assets and a mismatched browser', async () => {
const pkg = await json('package.json'), lock = await json('package-lock.json'), runtime = await json('scripts/runtime-lock.json');
checkReleaseLocks(pkg, lock, runtime);
+ assert.equal(runtime.targets['mac-arm64'].minimumOS, undefined);
+ const missingCPU = structuredClone(runtime); missingCPU.targets['mac-arm64'].arch = '';
+ assert.throws(() => checkReleaseLocks(pkg, lock, missingCPU), /OS\/CPU/);
+ const missingWindowsMinimum = structuredClone(runtime); missingWindowsMinimum.targets['win-x64'].minimumOS = '';
+ assert.throws(() => checkReleaseLocks(pkg, lock, missingWindowsMinimum), /minimum system version/);
const floating = structuredClone(pkg); floating.dependencies.gsap = '^' + pkg.dependencies.gsap;
const floatingLock = structuredClone(lock); floatingLock.packages[''].dependencies = floating.dependencies;
assert.throws(() => checkReleaseLocks(floating, floatingLock, runtime), /exact npm/);
@@ -52,6 +57,8 @@ test('test npm artifacts contain their application, locked manifest and no bundl
const built = await packageNpm(output, version), release = await json(built.manifest);
assert.equal(release.version, version); assert.equal(release.installer.version, version); assert.equal(release.format, 'npm');
assert.equal(release.templateEnvironment, 'dev');
+ assert.equal(release.runtime.targets['mac-arm64'].minimumOS, undefined);
+ assert.equal(release.runtime.targets['win-x64'].minimumOS, 'Windows 11');
assert.equal(release.mcp.profile, 'phase1'); assert.deepEqual(release.mcp.tools, mcpRegistry().tools.map(tool => tool.name));
assert.deepEqual(release.skills, [...phase1Skills].sort());
assert.equal(release.installer.sha256, await sha256(built.installer)); assert.equal(release.application.sha256, await sha256(built.application));
diff --git a/tests/release-fixture.mjs b/tests/release-fixture.mjs
index df212671..536ebcc8 100644
--- a/tests/release-fixture.mjs
+++ b/tests/release-fixture.mjs
@@ -21,7 +21,7 @@ export async function candidateFixture(t, branch = 'main', options = {}) {
const manifest = { schemaVersion: 1, version, format: 'npm', templateEnvironment, commit,
application: { url: './' + path.basename(application), sha256: await sha256(application) },
locks: { npm: await sha256(path.join(app, 'package-lock.json')), native: await sha256(path.join(app, 'scripts/runtime-lock.json')) },
- runtime: { targets: { mac: { platform: 'darwin', arch: 'arm64', minimumOS: '26.0' } } } };
+ runtime: { targets: { mac: { platform: 'darwin', arch: 'arm64' } } } };
await writeJSON(path.join(pkg, 'payload/release-npm.json'), manifest);
await writeJSON(path.join(pkg, 'package.json'), { name: '@openmotion/app', version, private: false, bin: { openmotion: 'scripts/npm-installer.mjs' } });
const tgz = path.join(build, `openmotion-app-${version}.tgz`);
diff --git a/tests/test-package.test.ts b/tests/test-package.test.ts
index 898662b2..cfa03427 100644
--- a/tests/test-package.test.ts
+++ b/tests/test-package.test.ts
@@ -1,11 +1,37 @@
import test from 'node:test';
import assert from 'node:assert/strict';
-import { mkdtemp, writeFile, readFile, rm, access } from 'node:fs/promises';
+import { mkdtemp, mkdir, copyFile, writeFile, readFile, rm, access } from 'node:fs/promises';
import { tmpdir } from 'node:os';
import path from 'node:path';
import { createHash } from 'node:crypto';
import { download, testVersion, checkReleaseVersion, lock, targetInfo } from '../scripts/test-package.mjs';
-import { nativeComponents } from '../scripts/runtime-assets.mjs';
+import { nativeComponents, runFile } from '../scripts/runtime-assets.mjs';
+
+test('complete bundle starts on macOS 15 while retaining CPU, executable and Windows version checks', async t => {
+ const directory = await mkdtemp(path.join(tmpdir(), 'motion-bundle-os-'));
+ t.after(() => rm(directory, { recursive: true, force: true }));
+ const bootstrap = path.join(directory, 'bootstrap.mjs');
+ await copyFile(new URL('../scripts/bundle/bootstrap.mjs', import.meta.url), bootstrap);
+ await writeFile(path.join(directory, 'release.json'), JSON.stringify({ target: 'mac-arm64' }));
+ for (const file of ['runtime/media/bin/ffmpeg', 'runtime/media/bin/ffprobe', 'runtime/browser/chrome-headless-shell-mac-arm64/chrome-headless-shell']) {
+ await mkdir(path.dirname(path.join(directory, file)), { recursive: true });
+ await writeFile(path.join(directory, file), 'fixture', { mode: 0o755 });
+ }
+ const script = `import os from 'node:os';
+ import { pathToFileURL } from 'node:url';
+ Object.defineProperty(process, 'platform', { value: process.argv[2] });
+ Object.defineProperty(process, 'arch', { value: process.argv[3] });
+ os.release = () => process.argv[4];
+ await import(pathToFileURL(process.argv[1]).href);
+ console.log(process.env.HYPERFRAMES_FFMPEG_PATH);`;
+ const run = (platform: string, arch: string, kernel: string) => runFile(process.execPath, ['--input-type=module', '-e', script, bootstrap, platform, arch, kernel]);
+ assert((await run('darwin', 'arm64', '24.6.0')).includes(path.join(directory, 'runtime/media/bin/ffmpeg')));
+ await assert.rejects(run('darwin', 'x64', '24.6.0'), /CPU/);
+ await rm(path.join(directory, 'runtime/media/bin/ffmpeg'));
+ await assert.rejects(run('darwin', 'arm64', '24.6.0'), /ENOENT/);
+ await writeFile(path.join(directory, 'release.json'), JSON.stringify({ target: 'win-x64' }));
+ await assert.rejects(run('win32', 'x64', '10.0.19045'), /Windows 11/);
+});
test('test versions sort above an already distributed source version and distinguish attempts', () => {
assert.equal(testVersion('0.6.1', '42', '1'), '0.6.2-test.42.1');