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): align onboarding installation and releases with main (OPEND-5061)

bone3deep1962-collab14cfd838489f
diff --git a/.github/scripts/motion-release.mjs b/.github/scripts/motion-release.mjs
index 87fa63f0..c7e026ac 100644
--- a/.github/scripts/motion-release.mjs
+++ b/.github/scripts/motion-release.mjs
@@ -12,7 +12,7 @@ import { generateInstallGuide } from '../../scripts/install-guide.mjs';
import { publishGuide, storagePlan } from './publish-install-guide.mjs';
import { scanPackage, scanSource } from './motion-scan.mjs';
-export const repository = 'nexu-io/html-anything';
+export const repository = 'nexu-io/openmotion';
export const candidateWorkflow = '.github/workflows/motion-candidate.yml';
export const publicationWorkflow = '.github/workflows/motion-publish-test.yml';
export const recoveryWorkflow = '.github/workflows/motion-publication-recovery.yml';
@@ -25,8 +25,8 @@ const integrity = bytes => 'sha512-' + createHash('sha512').update(bytes).digest
function manualEntry(env, workflows) {
assert.equal(env.GITHUB_REPOSITORY, repository, 'Wrong repository');
assert.equal(env.GITHUB_EVENT_NAME, 'workflow_dispatch', 'Manual invocation required');
- assert.equal(env.GITHUB_REF, 'refs/heads/feature/motion', 'Select feature/motion in Run workflow for Motion operations');
- assert(workflows.some(p => env.GITHUB_WORKFLOW_REF === `${repository}/${p}@refs/heads/feature/motion`), 'Require a trusted manual entry');
+ assert.equal(env.GITHUB_REF, 'refs/heads/main', 'Select main in Run workflow for Motion operations');
+ assert(workflows.some(p => env.GITHUB_WORKFLOW_REF === `${repository}/${p}@refs/heads/main`), 'Require a trusted manual entry');
}
export function releaseChannel(version) {
@@ -72,7 +72,7 @@ export async function resolveCandidate(control, requested, version, env = proces
export async function validateSource(control, commit, version, run = runFile, channel = releaseChannel(version)) {
assert.match(commit || '', /^[a-f0-9]{40}$/, 'Use a full immutable source SHA');
channelVersion(version, channel);
- await run('git', ['merge-base', '--is-ancestor', commit, 'refs/remotes/origin/feature/motion'], { cwd: control });
+ await run('git', ['merge-base', '--is-ancestor', commit, 'refs/remotes/origin/main'], { cwd: control });
}
export async function sealCandidate(build, output, source, env = process.env) {
@@ -82,8 +82,8 @@ export async function sealCandidate(build, output, source, env = process.env) {
channelVersion(manifest.version, env.MOTION_RELEASE_CHANNEL || 'test');
assert.equal(manifest.templateEnvironment, releaseTemplateEnvironment(manifest.version), 'Template defaults must match the release channel');
assert.match(env.GITHUB_SHA || '', /^[a-f0-9]{40}$/);
- const workflowRef = candidateRefs.find(ref => env.GITHUB_WORKFLOW_REF === `${repository}/${candidateWorkflow}@${ref}`);
- assert(workflowRef, 'Build candidates only from main or feature/motion');
+ const workflowRef = env.GITHUB_WORKFLOW_REF === `${repository}/${candidateWorkflow}@refs/heads/main` ? 'refs/heads/main' : undefined;
+ assert(workflowRef, 'Build candidates only from main');
assert(/^[1-9]\d*$/.test(env.GITHUB_RUN_ID || '') && /^[1-9]\d*$/.test(env.GITHUB_RUN_ATTEMPT || ''));
const filename = manifest.installer.url.replace(/^\.\//, '');
assert.equal(filename, `openmotion-app-${manifest.version}.tgz`);
@@ -148,7 +148,7 @@ export async function recordAuthorization(directory, inputs, fetcher = fetch, en
assert.equal(authorized.action, inputs.action); assert.equal(authorized.version, inputs.version);
const candidate = await verifyDownloaded(directory, inputs.expectedSHA256, inputs.version);
const run = await github(`/actions/runs/${env.GITHUB_RUN_ID}`, fetcher);
- assert.equal(String(run.id), env.GITHUB_RUN_ID); assert.equal(run.head_branch, 'feature/motion'); assert.equal(run.event, 'workflow_dispatch');
+ assert.equal(String(run.id), env.GITHUB_RUN_ID); assert.equal(run.head_branch, 'main'); assert.equal(run.event, 'workflow_dispatch');
assert.equal(run.head_repository?.full_name, repository); assert.equal(run.head_sha, env.GITHUB_SHA);
assert.equal(run.path.split('@')[0], env.GITHUB_WORKFLOW_REF.slice(repository.length + 1).split('@')[0]);
await writeJSON(path.join(directory, 'authorization.json'), authorizationReceipt(candidate, run, inputs.action));
@@ -173,7 +173,11 @@ export async function verifyCandidate(directory, expectedSHA256, run) {
assert.match(expectedSHA256, hashPattern); assert.match(candidate.sourceCommit, /^[a-f0-9]{40}$/);
const ref = `refs/heads/${run.head_branch || 'main'}`; // Older main-only receipts omitted the branch.
assert(candidateRefs.includes(ref), 'Untrusted candidate branch');
- assert.deepEqual(candidate.workflow, { repository, path: candidateWorkflow, ref, sha: run.head_sha, runId: run.id, attempt: run.run_attempt });
+ // Immutable receipts predating the rename keep their original name. Artifact lookup
+ // and live run validation still use only the current repository; never follow an alias.
+ const receiptRepository = candidate.workflow?.repository;
+ assert([repository, 'nexu-io/html-anything'].includes(receiptRepository), 'Untrusted candidate repository');
+ assert.deepEqual(candidate.workflow, { repository: receiptRepository, path: candidateWorkflow, ref, sha: run.head_sha, runId: run.id, attempt: run.run_attempt });
const names = [candidate.tgz, 'release-npm.json', 'source-scan.json', 'package-scan.json', 'install.md', 'install-record.json', 'acceptance.md', 'candidate-install.md'];
assert.deepEqual(Object.keys(candidate.files).sort(), names.sort());
for (const name of names) assert.equal(await sha256(path.join(directory, name)), candidate.files[name], 'Candidate file changed: ' + name);
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 36b8f523..1b53f13a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -33,7 +33,7 @@ concurrency:
jobs:
maintainability:
name: Maintainability report
- if: github.event_name == 'pull_request' && github.base_ref == 'feature/motion'
+ if: github.event_name == 'pull_request' && github.base_ref == 'main'
runs-on: ubuntu-24.04
timeout-minutes: 10
steps:
diff --git a/.github/workflows/motion-candidate.yml b/.github/workflows/motion-candidate.yml
index 64a98e5b..eeead8c9 100644
--- a/.github/workflows/motion-candidate.yml
+++ b/.github/workflows/motion-candidate.yml
@@ -15,7 +15,7 @@ on:
required: false
default: ''
source_sha:
- description: 'Optional reviewed full SHA integrated into feature/motion; empty freezes the selected dispatch commit'
+ description: 'Optional reviewed full SHA integrated into main; empty freezes the selected dispatch commit'
type: string
required: false
default: ''
@@ -26,7 +26,7 @@ permissions:
jobs:
candidate:
name: Build immutable candidate
- if: github.repository == 'nexu-io/html-anything'
+ if: github.repository == 'nexu-io/openmotion'
runs-on: ubuntu-24.04
timeout-minutes: 45
env:
@@ -41,8 +41,8 @@ jobs:
steps:
- name: Require Motion integration branch
run: |
- if [ "$GITHUB_REF" != 'refs/heads/feature/motion' ]; then
- echo '::error::Select feature/motion in Run workflow for Motion operations.'
+ if [ "$GITHUB_REF" != 'refs/heads/main' ]; then
+ echo '::error::Select main in Run workflow for Motion operations.'
exit 1
fi
- uses: actions/[email protected]
@@ -57,7 +57,7 @@ jobs:
- name: Resolve and freeze the integrated source
id: source
run: |
- git -C control fetch origin feature/motion:refs/remotes/origin/feature/motion
+ git -C control fetch origin main:refs/remotes/origin/main
node control/.github/scripts/motion-release.mjs source control
- uses: actions/[email protected]
with:
diff --git a/.github/workflows/motion-install-check.yml b/.github/workflows/motion-install-check.yml
index 3d5adbb4..bd51e1b6 100644
--- a/.github/workflows/motion-install-check.yml
+++ b/.github/workflows/motion-install-check.yml
@@ -10,7 +10,7 @@ on:
required: true
default: '0.6.4-test.7'
pull_request:
- branches: [feature/motion]
+ branches: [main]
paths:
- '.github/workflows/motion-install-check.yml'
- '.github/scripts/motion-registry*.mjs'
@@ -26,7 +26,7 @@ env:
jobs:
candidate:
- if: github.repository == 'nexu-io/html-anything' && (github.event_name == 'workflow_dispatch' || github.event.pull_request.head.repo.full_name == github.repository)
+ if: github.repository == 'nexu-io/openmotion' && (github.event_name == 'workflow_dispatch' || github.event.pull_request.head.repo.full_name == github.repository)
runs-on: ubuntu-24.04
timeout-minutes: 10
outputs:
@@ -45,7 +45,7 @@ jobs:
env:
GH_TOKEN: ${{ github.token }}
run: |
- git fetch origin feature/motion:refs/remotes/origin/feature/motion
+ git fetch origin main:refs/remotes/origin/main
node --input-type=module <<'JS'
import { appendFile } from 'node:fs/promises';
import { downloadCandidate, validateSource } from './.github/scripts/motion-release.mjs';
diff --git a/.github/workflows/motion-publication-recovery.yml b/.github/workflows/motion-publication-recovery.yml
index ec660da7..b917ea85 100644
--- a/.github/workflows/motion-publication-recovery.yml
+++ b/.github/workflows/motion-publication-recovery.yml
@@ -19,13 +19,13 @@ permissions:
jobs:
select-ref:
- if: github.repository == 'nexu-io/html-anything'
+ if: github.repository == 'nexu-io/openmotion'
runs-on: ubuntu-24.04
steps:
- name: Require Motion integration branch
run: |
- if [ "$GITHUB_REF" != 'refs/heads/feature/motion' ]; then
- echo '::error::Select feature/motion in Run workflow for Motion operations.'
+ if [ "$GITHUB_REF" != 'refs/heads/main' ]; then
+ echo '::error::Select main in Run workflow for Motion operations.'
exit 1
fi
recover:
diff --git a/.github/workflows/motion-publish-test.yml b/.github/workflows/motion-publish-test.yml
index 63e4cc16..6a7f23a8 100644
--- a/.github/workflows/motion-publish-test.yml
+++ b/.github/workflows/motion-publish-test.yml
@@ -40,7 +40,7 @@ env:
jobs:
verify:
- if: github.repository == 'nexu-io/html-anything'
+ if: github.repository == 'nexu-io/openmotion'
runs-on: ubuntu-24.04
timeout-minutes: 15
outputs:
@@ -49,8 +49,8 @@ jobs:
steps:
- name: Require Motion integration branch
run: |
- if [ "$GITHUB_REF" != 'refs/heads/feature/motion' ]; then
- echo '::error::Select feature/motion in Run workflow for Motion operations.'
+ if [ "$GITHUB_REF" != 'refs/heads/main' ]; then
+ echo '::error::Select main in Run workflow for Motion operations.'
exit 1
fi
- uses: actions/[email protected]
@@ -71,7 +71,7 @@ jobs:
GH_TOKEN: ${{ github.token }}
MOTION_EXPECTED_SHA256: ${{ steps.download.outputs.tgz_sha256 }}
run: |
- git fetch origin feature/motion:refs/remotes/origin/feature/motion
+ git fetch origin main:refs/remotes/origin/main
node .github/scripts/motion-scan.mjs install "$RUNNER_TEMP/scanner"
node .github/scripts/motion-release.mjs rescan "$RUNNER_TEMP/candidate" "$PWD" "$RUNNER_TEMP/scanner/gitleaks"
- uses: actions/[email protected]
diff --git a/AGENTS.md b/AGENTS.md
index a3b7d5dd..a488d30c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -53,6 +53,6 @@ Phase one exposes eleven motion_ Tools (nine project tools plus catalog fetch an
## Candidate and publication controls
-Follow [the release workflow manual](docs/release-workflows.md): separate manual candidate-build and npm-publication entries, plus snapshot-only recovery. Select `feature/motion` for all entries; `main` only registers them and is rejected as an execution ref. Select `test` (default, DEV templates) or `stable` (prod templates). Blank test versions use short workflow-counter `test.N` numbering; stable requires an explicit new `MAJOR.MINOR.PATCH`. Keep full run/source identities in the records. Use candidate-install.md for local testing and keep results private. The publication operator enters the exact version and starts the manual workflow; no acceptance checkbox or independent approval environment is enabled. Public candidates must use an exact reviewed source SHA integrated into `feature/motion`. Scan tracked source plus the outer npm tgz and inner application; preserve the positive distribution list and licenses. Keep candidate, native registry installation, real Agent creation and human acceptance evidence separate.
+Follow [the release workflow manual](docs/release-workflows.md): separate manual candidate-build and npm-publication entries, plus snapshot-only recovery. Select `main` in `nexu-io/openmotion` for all new candidate, publication and recovery entries. Select `test` (default, DEV templates) or `stable` (prod templates). Blank test versions use short workflow-counter `test.N` numbering; stable requires an explicit new `MAJOR.MINOR.PATCH`. Keep full run/source identities in the records. Use candidate-install.md for local testing and keep results private. The publication operator enters the exact version and starts the manual workflow; no acceptance checkbox or independent approval environment is enabled. Public candidates must use an exact reviewed source SHA integrated into `main`. Scan tracked source plus the outer npm tgz and inner application; preserve the positive distribution list and licenses. Keep candidate, native registry installation, real Agent creation and human acceptance evidence separate.
-Publication uses the accepted candidate bytes, never a rebuild. Test publishes under `candidate`, promotes `test` after registry propagation, archives and updates the DEV guide, then runs non-blocking Mac/Windows cold installs. Stable publishes publicly under `stage`, requires both exact prod cold installs to pass, then promotes `latest`, archives and updates the stable guide last; it preserves `test`. A stage tag does not make the package private. The existing `motion-publish-test.yml` filename remains the npm Trusted Publisher identity for both channels. Only separately authorized manual publication/recovery may receive npm OIDC or R2 credentials; consumer jobs receive neither. Archive-only work must not publish npm, move tags or access default entries. The read-only Motion installation check can recheck an exact public test or stable version independently. Never overwrite published versions, put private template payloads/internal acceptance material into public artifacts, or infer merge/publication authorization from green CI. Real prod template, Agent and audiovisual acceptance remain release responsibilities; hosted installation checks do not establish them. Skills marketplace publication, main registration, npm trust, main cutover and repository rename remain separate operations.
+Publication uses the accepted candidate bytes, never a rebuild. Test publishes under `candidate`, promotes `test` after registry propagation, archives and updates the DEV guide, then runs non-blocking Mac/Windows cold installs. Stable publishes publicly under `stage`, requires both exact prod cold installs to pass, then promotes `latest`, archives and updates the stable guide last; it preserves `test`. A stage tag does not make the package private. The existing `motion-publish-test.yml` filename remains the npm Trusted Publisher identity for both channels. Only separately authorized manual publication/recovery may receive npm OIDC or R2 credentials; consumer jobs receive neither. Archive-only work must not publish npm, move tags or access default entries. The read-only Motion installation check can recheck an exact public test or stable version independently. Never overwrite published versions, put private template payloads/internal acceptance material into public artifacts, or infer merge/publication authorization from green CI. Real prod template, Agent and audiovisual acceptance remain release responsibilities; hosted installation checks do not establish them. Skills marketplace publication and npm trusted-publisher configuration remain separate operations.
diff --git a/CLAUDE.md b/CLAUDE.md
index 8d2c93ac..af14c72e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,9 +4,9 @@ Read and follow [AGENTS.md](AGENTS.md) before working in this repository. It is
## Candidate and publication controls
-Follow [the release workflow manual](docs/release-workflows.md): separate manual candidate-build and npm-publication entries, plus snapshot-only recovery. Select `feature/motion` for all entries; `main` only registers them and is rejected as an execution ref. Select `test` (default, DEV templates) or `stable` (prod templates). Blank test versions use short workflow-counter `test.N` numbering; stable requires an explicit new `MAJOR.MINOR.PATCH`. Keep full run/source identities in the records. Use candidate-install.md for local testing and keep results private. The publication operator enters the exact version and starts the manual workflow; no acceptance checkbox or independent approval environment is enabled. Public candidates must use an exact reviewed source SHA integrated into `feature/motion`. Scan tracked source plus the outer npm tgz and inner application; preserve the positive distribution list and licenses. Keep candidate, native registry installation, real Agent creation and human acceptance evidence separate.
+Follow [the release workflow manual](docs/release-workflows.md): separate manual candidate-build and npm-publication entries, plus snapshot-only recovery. Select `main` in `nexu-io/openmotion` for all new candidate, publication and recovery entries. Select `test` (default, DEV templates) or `stable` (prod templates). Blank test versions use short workflow-counter `test.N` numbering; stable requires an explicit new `MAJOR.MINOR.PATCH`. Keep full run/source identities in the records. Use candidate-install.md for local testing and keep results private. The publication operator enters the exact version and starts the manual workflow; no acceptance checkbox or independent approval environment is enabled. Public candidates must use an exact reviewed source SHA integrated into `main`. Scan tracked source plus the outer npm tgz and inner application; preserve the positive distribution list and licenses. Keep candidate, native registry installation, real Agent creation and human acceptance evidence separate.
-Publication uses the accepted candidate bytes, never a rebuild. Test publishes under `candidate`, promotes `test` after registry propagation, archives and updates the DEV guide, then runs non-blocking Mac/Windows cold installs. Stable publishes publicly under `stage`, requires both exact prod cold installs to pass, then promotes `latest`, archives and updates the stable guide last; it preserves `test`. A stage tag does not make the package private. The existing `motion-publish-test.yml` filename remains the npm Trusted Publisher identity for both channels. Only separately authorized manual publication/recovery may receive npm OIDC or R2 credentials; consumer jobs receive neither. Archive-only work must not publish npm, move tags or access default entries. The read-only Motion installation check can recheck an exact public test or stable version independently. Never overwrite published versions, put private template payloads/internal acceptance material into public artifacts, or infer merge/publication authorization from green CI. Real prod template, Agent and audiovisual acceptance remain release responsibilities; hosted installation checks do not establish them. Skills marketplace publication, main registration, npm trust, main cutover and repository rename remain separate operations.
+Publication uses the accepted candidate bytes, never a rebuild. Test publishes under `candidate`, promotes `test` after registry propagation, archives and updates the DEV guide, then runs non-blocking Mac/Windows cold installs. Stable publishes publicly under `stage`, requires both exact prod cold installs to pass, then promotes `latest`, archives and updates the stable guide last; it preserves `test`. A stage tag does not make the package private. The existing `motion-publish-test.yml` filename remains the npm Trusted Publisher identity for both channels. Only separately authorized manual publication/recovery may receive npm OIDC or R2 credentials; consumer jobs receive neither. Archive-only work must not publish npm, move tags or access default entries. The read-only Motion installation check can recheck an exact public test or stable version independently. Never overwrite published versions, put private template payloads/internal acceptance material into public artifacts, or infer merge/publication authorization from green CI. Real prod template, Agent and audiovisual acceptance remain release responsibilities; hosted installation checks do not establish them. Skills marketplace publication and npm trusted-publisher configuration remain separate operations.
## Product documentation
diff --git a/README.md b/README.md
index d4778f1d..a9d80a6b 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
</p>
<p align="center">
- <a href="https://github.com/nexu-io/html-anything"><img src="docs/readme/badges/stars.svg" alt="GitHub Stars · 9.5k (2026-11-09)"></a>
+ <a href="https://github.com/nexu-io/openmotion"><img src="docs/readme/badges/stars.svg" alt="GitHub Stars · 9.5k (2026-11-09)"></a>
<a href="package.json"><img src="docs/readme/badges/node.svg" alt="Node.js 22.18+"></a>
<a href="LICENSE"><img src="docs/readme/badges/license.svg" alt="Apache 2.0 license"></a>
<a href="https://github.com/nexu-io/open-design"><img src="docs/readme/badges/built-by-opendesign.svg" alt="Built by OpenDesign"></a>
@@ -561,7 +561,7 @@ If MCP tools are missing or fail to connect, use the installed [connection diagn
Use Git, npm and **Node.js 26.11.1**. Source-based preview and export also need Chrome/Chromium and FFmpeg/FFprobe. [Runtime setup](docs/usage.md)
```sh
-git clone --branch feature/motion https://github.com/nexu-io/html-anything.git openmotion
+git clone --branch main https://github.com/nexu-io/openmotion.git openmotion
cd openmotion
npm ci
npm run build:studio
@@ -798,7 +798,7 @@ Dependency pins live in [package.json](package.json), [package-lock.json](packag
| **Agents and developer tools** | Improve a host adapter, Skill, resource guide or project-tool workflow | [Agent adapters](docs/agent-adapters.md) · [MCP contract](docs/mcp-phase1-tools.md) |
| **Motion and creative coding** | Share a component, native template or Motion.md package with an actual remix | [Components](library/components/README.md) · [Entry checklist](library/ENTRY_TEMPLATE.md) |
| **Video and rendering** | Improve export reliability, media handling or reproducible validation | [Engine notes](docs/hyperframes.md) · [Export verifier](scripts/verify-export.ts) |
-| **Social publishing** | Help design the Coming connector layer: account access, release review, scheduling and version mapping | [Publishing direction](docs/product/studio-vision.md) · [Discuss a proposal](https://github.com/nexu-io/html-anything/issues) |
+| **Social publishing** | Help design the Coming connector layer: account access, release review, scheduling and version mapping | [Publishing direction](docs/product/studio-vision.md) · [Discuss a proposal](https://github.com/nexu-io/openmotion/issues) |
Start with the [local setup](#quick-start), choose one layer, and follow [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md). Keep user projects and credentials outside the checkout and preserve dependency pins and upstream licenses.
@@ -849,15 +849,15 @@ Share a remake, a reusable template or a Motion.md that captures the rhythm of a
| **Brand Kit content for Motion.md** | Identity, accurate product facts and approved assets within the creative specification |
| **Agent support or editor improvements** | A focused change with reproducible validation |
-[Library entry checklist](library/ENTRY_TEMPLATE.md) · [Contribute](CONTRIBUTING.md) · [Report an issue](https://github.com/nexu-io/html-anything/issues) · [Contributors](https://github.com/nexu-io/html-anything/graphs/contributors) · [Media kit](docs/media-kit.md)
+[Library entry checklist](library/ENTRY_TEMPLATE.md) · [Contribute](CONTRIBUTING.md) · [Report an issue](https://github.com/nexu-io/openmotion/issues) · [Contributors](https://github.com/nexu-io/openmotion/graphs/contributors) · [Media kit](docs/media-kit.md)
The dedicated OpenMotion site is coming to `open-design.ai/openmotion`.
[Motion showcase](https://open-design.ai/motion/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_en) · [OpenDesign Go](https://go.open-design.ai/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_en) · [Discord](https://discord.gg/mHAjSMV6gz) · [X @OpenDesignDevs](https://x.com/OpenDesignDevs) · [X @OpenDesignHQ](https://x.com/OpenDesignHQ) · [YouTube](https://www.youtube.com/channel/UChtshixMhvtgBWzoD9R_Qfg)
-[**Star OpenMotion on GitHub**](https://github.com/nexu-io/html-anything)
+[**Star OpenMotion on GitHub**](https://github.com/nexu-io/openmotion)
-[![Stay tuned with us · Star OpenMotion](docs/readme/community-star.svg)](https://github.com/nexu-io/html-anything)
+[![Stay tuned with us · Star OpenMotion](docs/readme/community-star.svg)](https://github.com/nexu-io/openmotion)
<a id="acknowledgements"></a>
@@ -882,4 +882,4 @@ OpenMotion is licensed under [Apache-2.0](LICENSE). Third-party code, templates,
[Asset sources](docs/readme/ASSETS.md) · [Additional showcase sources](docs/readme/brand-showcase/README.md) · [Font notices](web/design-system/fonts/NOTICES.txt) · [Studio license](studio/LICENSE)
-The former HTML Anything application is preserved on the [`legacy` branch](https://github.com/nexu-io/html-anything/tree/legacy). See the [repository migration guide](docs/repository-migration.md) for the active branch and distribution boundaries.
+The former HTML Anything application is preserved on the [`legacy` branch](https://github.com/nexu-io/openmotion/tree/legacy). See the [repository migration guide](docs/repository-migration.md) for the active branch and distribution boundaries.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index fe35aca2..1a15531c 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -7,7 +7,7 @@
</p>
<p align="center">
- <a href="https://github.com/nexu-io/html-anything"><img src="docs/readme/badges/stars.zh-CN.svg" alt="GitHub 星标 · 9.5k(2026-11-09)"></a>
+ <a href="https://github.com/nexu-io/openmotion"><img src="docs/readme/badges/stars.zh-CN.svg" alt="GitHub 星标 · 9.5k(2026-11-09)"></a>
<a href="package.json"><img src="docs/readme/badges/node.svg" alt="Node.js 22.18+"></a>
<a href="LICENSE"><img src="docs/readme/badges/license.zh-CN.svg" alt="Apache 2.0 许可证"></a>
<a href="https://github.com/nexu-io/open-design"><img src="docs/readme/badges/built-by-opendesign.zh-CN.svg" alt="OpenDesign 出品"></a>
@@ -561,7 +561,7 @@ OpenMotion 另附三个可编辑工程。在 Studio 的 **Templates → Ready to
准备 Git、npm 和 **Node.js 26.11.1**。从源码预览和导出还需要 Chrome/Chromium 和 FFmpeg/FFprobe。[运行环境配置](docs/usage.md)
```sh
-git clone --branch feature/motion https://github.com/nexu-io/html-anything.git openmotion
+git clone --branch main https://github.com/nexu-io/openmotion.git openmotion
cd openmotion
npm ci
npm run build:studio
@@ -789,7 +789,7 @@ BYOA 让 Agent 留在已有客户端,BYOK 连接受支持的模型账号。Stu
| **Agent 与开发工具** | 改进宿主适配器、Skill、资源指引或工程工具流程 | [Agent 适配器](docs/agent-adapters.md) · [MCP 契约](docs/mcp-phase1-tools.md) |
| **动效与创意编程** | 分享组件、原生模板或带真实改编的 Motion.md 包 | [组件](library/components/README.md) · [条目清单](library/ENTRY_TEMPLATE.md) |
| **视频与渲染** | 改进导出可靠性、媒体处理或可复现验证 | [引擎说明](docs/hyperframes.md) · [导出校验器](scripts/verify-export.ts) |
-| **社交发布** | 设计规划中的连接器层:账号访问、发布审阅、排期和版本映射 | [发布方向](docs/product/studio-vision.md) · [讨论提案](https://github.com/nexu-io/html-anything/issues) |
+| **社交发布** | 设计规划中的连接器层:账号访问、发布审阅、排期和版本映射 | [发布方向](docs/product/studio-vision.md) · [讨论提案](https://github.com/nexu-io/openmotion/issues) |
从[本地安装](#quick-start)开始,选择一层,遵循 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [AGENTS.md](AGENTS.md)。工程与凭据放在 checkout 外,保留依赖锁定与上游许可。
@@ -842,15 +842,15 @@ BYOA 让 Agent 留在已有客户端,BYOK 连接受支持的模型账号。Stu
| **Brandkit** | 品牌身份、准确产品事实和可分享素材 |
| **Agent 支持或编辑器改进** | 范围聚焦且可复现验证的变更 |
-[资源提交清单](library/ENTRY_TEMPLATE.md) · [参与贡献](CONTRIBUTING.md) · [反馈问题](https://github.com/nexu-io/html-anything/issues) · [贡献者](https://github.com/nexu-io/html-anything/graphs/contributors) · [媒体资料](docs/media-kit.md)
+[资源提交清单](library/ENTRY_TEMPLATE.md) · [参与贡献](CONTRIBUTING.md) · [反馈问题](https://github.com/nexu-io/openmotion/issues) · [贡献者](https://github.com/nexu-io/openmotion/graphs/contributors) · [媒体资料](docs/media-kit.md)
OpenMotion 独立官网将上线于 `open-design.ai/openmotion`。
[OpenDesign 动效展示](https://open-design.ai/motion/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_zh) · [OpenDesign Go](https://go.open-design.ai/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_zh) · [Discord](https://discord.gg/mHAjSMV6gz) · [X @OpenDesignDevs](https://x.com/OpenDesignDevs) · [X @OpenDesignHQ](https://x.com/OpenDesignHQ) · [YouTube](https://www.youtube.com/channel/UChtshixMhvtgBWzoD9R_Qfg)
-[**在 GitHub 上给 OpenMotion 点个 Star**](https://github.com/nexu-io/html-anything)
+[**在 GitHub 上给 OpenMotion 点个 Star**](https://github.com/nexu-io/openmotion)
-[![关注 OpenMotion · 在 GitHub 上加星](docs/readme/community-star.zh-CN.svg)](https://github.com/nexu-io/html-anything)
+[![关注 OpenMotion · 在 GitHub 上加星](docs/readme/community-star.zh-CN.svg)](https://github.com/nexu-io/openmotion)
<a id="acknowledgements"></a>
@@ -875,4 +875,4 @@ OpenMotion 采用 [Apache-2.0](LICENSE)许可。第三方代码、模板、媒
[素材来源](docs/readme/ASSETS.md) · [其他展示素材来源](docs/readme/brand-showcase/README.md) · [字体声明](web/design-system/fonts/NOTICES.txt) · [Studio 许可证](studio/LICENSE)
-原 HTML Anything 应用保留在 [`legacy` 分支](https://github.com/nexu-io/html-anything/tree/legacy)。当前分支与分发边界参见[仓库迁移指南](docs/repository-migration.md) 。
+原 HTML Anything 应用保留在 [`legacy` 分支](https://github.com/nexu-io/openmotion/tree/legacy)。当前分支与分发边界参见[仓库迁移指南](docs/repository-migration.md) 。
diff --git a/docs/README.ja.md b/docs/README.ja.md
index 9d821c44..0171210b 100644
--- a/docs/README.ja.md
+++ b/docs/README.ja.md
@@ -7,7 +7,7 @@
</p>
<p align="center">
- <a href="https://github.com/nexu-io/html-anything"><img src="readme/badges/stars.ja.svg" alt="GitHub スター · 9.5k(2026-11-09)"></a>
+ <a href="https://github.com/nexu-io/openmotion"><img src="readme/badges/stars.ja.svg" alt="GitHub スター · 9.5k(2026-11-09)"></a>
<a href="../package.json"><img src="readme/badges/node.svg" alt="Node.js 22.18+"></a>
<a href="../LICENSE"><img src="readme/badges/license.ja.svg" alt="Apache 2.0 ライセンス"></a>
<a href="https://github.com/nexu-io/open-design"><img src="readme/badges/built-by-opendesign.ja.svg" alt="開発元 OpenDesign"></a>
@@ -561,7 +561,7 @@ Brand Kit 欄にはロゴ、配色、書体、文体、確認済みの製品情
Git、npm、**Node.js 26.11.1** を用意してください。ソースからのプレビューと書き出しには Chrome または Chromium と、FFmpeg・FFprobe も必要です。[実行環境の設定](usage.md)
```sh
-git clone --branch feature/motion https://github.com/nexu-io/html-anything.git openmotion
+git clone --branch main https://github.com/nexu-io/openmotion.git openmotion
cd openmotion
npm ci
npm run build:studio
@@ -789,7 +789,7 @@ BYOA は既存クライアントを使い、BYOK は対応するモデルアカ
| **エージェントと開発ツール** | ホストアダプター、Skill、リソースガイド、プロジェクト操作の改善 | [エージェントアダプター](agent-adapters.md) · [MCP 契約](mcp-phase1-tools.md) |
| **動きとクリエイティブコード** | 実際の改編を添えた部品、ネイティブテンプレート、Motion.md パッケージ | [部品](../library/components/README.md) · [登録チェックリスト](../library/ENTRY_TEMPLATE.md) |
| **動画とレンダリング** | 出力の信頼性、メディア処理、再現可能な検証の改善 | [エンジンの説明](hyperframes.md) · [出力検証器](../scripts/verify-export.ts) |
-| **SNS 公開** | 計画中の接続層を設計:アカウント利用、公開確認、予約、版の対応付け | [公開の方向性](product/studio-vision.md) · [提案を議論する](https://github.com/nexu-io/html-anything/issues) |
+| **SNS 公開** | 計画中の接続層を設計:アカウント利用、公開確認、予約、版の対応付け | [公開の方向性](product/studio-vision.md) · [提案を議論する](https://github.com/nexu-io/openmotion/issues) |
[ローカル設定](#quick-start)から始め、担当する層を選び、[CONTRIBUTING.md](../CONTRIBUTING.md) と [AGENTS.md](../AGENTS.md)に従ってください。プロジェクトと認証情報はチェックアウト外に置き、固定バージョンと上流ライセンスを維持します。
@@ -842,15 +842,15 @@ BYOA は既存クライアントを使い、BYOK は対応するモデルアカ
| **Brandkit** | ブランド、正確な製品情報、共有できる素材 |
| **エージェント対応や編集機能の改善** | 焦点を絞った変更と再現可能な検証 |
-[リソース提出時のチェックリスト](../library/ENTRY_TEMPLATE.md) · [貢献ガイド](../CONTRIBUTING.md) · [問題を報告](https://github.com/nexu-io/html-anything/issues) · [コントリビューター](https://github.com/nexu-io/html-anything/graphs/contributors) · [メディア向け資料](media-kit.md)
+[リソース提出時のチェックリスト](../library/ENTRY_TEMPLATE.md) · [貢献ガイド](../CONTRIBUTING.md) · [問題を報告](https://github.com/nexu-io/openmotion/issues) · [コントリビューター](https://github.com/nexu-io/openmotion/graphs/contributors) · [メディア向け資料](media-kit.md)
OpenMotion の専用サイトは `open-design.ai/openmotion` に開設予定です。
[OpenDesign の動画ギャラリー](https://open-design.ai/motion/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_ja) · [OpenDesign Go](https://go.open-design.ai/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_ja) · [Discord](https://discord.gg/mHAjSMV6gz) · [X @OpenDesignDevs](https://x.com/OpenDesignDevs) · [X @OpenDesignHQ](https://x.com/OpenDesignHQ) · [YouTube](https://www.youtube.com/channel/UChtshixMhvtgBWzoD9R_Qfg)
-[**GitHub で OpenMotion にスターを付ける**](https://github.com/nexu-io/html-anything)
+[**GitHub で OpenMotion にスターを付ける**](https://github.com/nexu-io/openmotion)
-[![OpenMotion の更新をフォローするには GitHub でスターを](readme/community-star.ja.svg)](https://github.com/nexu-io/html-anything)
+[![OpenMotion の更新をフォローするには GitHub でスターを](readme/community-star.ja.svg)](https://github.com/nexu-io/openmotion)
<a id="acknowledgements"></a>
@@ -875,4 +875,4 @@ OpenMotion のライセンスは [Apache-2.0](../LICENSE)です。第三者の
[素材の出典](readme/ASSETS.md) · [その他の展示素材の出典](readme/brand-showcase/README.md) · [フォントのライセンス](../web/design-system/fonts/NOTICES.txt) · [Studio のライセンス](../studio/LICENSE)
-旧 HTML Anything アプリは [`legacy` ブランチ](https://github.com/nexu-io/html-anything/tree/legacy)に保存されています。現在のブランチと配布範囲は[リポジトリ移行ガイド](repository-migration.md) を参照してください。
+旧 HTML Anything アプリは [`legacy` ブランチ](https://github.com/nexu-io/openmotion/tree/legacy)に保存されています。現在のブランチと配布範囲は[リポジトリ移行ガイド](repository-migration.md) を参照してください。
diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md
index 95400fc7..11e53ad0 100644
--- a/docs/README.zh-CN.md
+++ b/docs/README.zh-CN.md
@@ -7,7 +7,7 @@
</p>
<p align="center">
- <a href="https://github.com/nexu-io/html-anything"><img src="readme/badges/stars.zh-CN.svg" alt="GitHub 星标 · 9.5k(2026-11-09)"></a>
+ <a href="https://github.com/nexu-io/openmotion"><img src="readme/badges/stars.zh-CN.svg" alt="GitHub 星标 · 9.5k(2026-11-09)"></a>
<a href="../package.json"><img src="readme/badges/node.svg" alt="Node.js 22.18+"></a>
<a href="../LICENSE"><img src="readme/badges/license.zh-CN.svg" alt="Apache 2.0 许可证"></a>
<a href="https://github.com/nexu-io/open-design"><img src="readme/badges/built-by-opendesign.zh-CN.svg" alt="OpenDesign 出品"></a>
@@ -559,7 +559,7 @@ OpenMotion 另附三个可编辑工程。在 Studio 的 **Templates → Ready to
准备 Git、npm 和 **Node.js 26.11.1**。从源码预览和导出还需要 Chrome/Chromium 和 FFmpeg/FFprobe。[运行环境配置](usage.md)
```sh
-git clone --branch feature/motion https://github.com/nexu-io/html-anything.git openmotion
+git clone --branch main https://github.com/nexu-io/openmotion.git openmotion
cd openmotion
npm ci
npm run build:studio
@@ -787,7 +787,7 @@ BYOA 让 Agent 留在已有客户端,BYOK 连接受支持的模型账号。Stu
| **Agent 与开发工具** | 改进宿主适配器、Skill、资源指引或工程工具流程 | [Agent 适配器](agent-adapters.md) · [MCP 契约](mcp-phase1-tools.md) |
| **动效与创意编程** | 分享组件、原生模板或带真实改编的 Motion.md 包 | [组件](../library/components/README.md) · [条目清单](../library/ENTRY_TEMPLATE.md) |
| **视频与渲染** | 改进导出可靠性、媒体处理或可复现验证 | [引擎说明](hyperframes.md) · [导出校验器](../scripts/verify-export.ts) |
-| **社交发布** | 设计规划中的连接器层:账号访问、发布审阅、排期和版本映射 | [发布方向](product/studio-vision.md) · [讨论提案](https://github.com/nexu-io/html-anything/issues) |
+| **社交发布** | 设计规划中的连接器层:账号访问、发布审阅、排期和版本映射 | [发布方向](product/studio-vision.md) · [讨论提案](https://github.com/nexu-io/openmotion/issues) |
从[本地安装](#quick-start)开始,选择一层,遵循 [CONTRIBUTING.md](../CONTRIBUTING.md) 和 [AGENTS.md](../AGENTS.md)。工程与凭据放在 checkout 外,保留依赖锁定与上游许可。
@@ -840,15 +840,15 @@ BYOA 让 Agent 留在已有客户端,BYOK 连接受支持的模型账号。Stu
| **Brandkit** | 品牌身份、准确产品事实和可分享素材 |
| **Agent 支持或编辑器改进** | 范围聚焦且可复现验证的变更 |
-[资源提交清单](../library/ENTRY_TEMPLATE.md) · [参与贡献](../CONTRIBUTING.md) · [反馈问题](https://github.com/nexu-io/html-anything/issues) · [贡献者](https://github.com/nexu-io/html-anything/graphs/contributors) · [媒体资料](media-kit.md)
+[资源提交清单](../library/ENTRY_TEMPLATE.md) · [参与贡献](../CONTRIBUTING.md) · [反馈问题](https://github.com/nexu-io/openmotion/issues) · [贡献者](https://github.com/nexu-io/openmotion/graphs/contributors) · [媒体资料](media-kit.md)
OpenMotion 独立官网将上线于 `open-design.ai/openmotion`。
[OpenDesign 动效展示](https://open-design.ai/motion/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_zh) · [OpenDesign Go](https://go.open-design.ai/?utm_source=github&utm_medium=referral&utm_campaign=openmotion&utm_content=readme_zh) · [Discord](https://discord.gg/mHAjSMV6gz) · [X @OpenDesignDevs](https://x.com/OpenDesignDevs) · [X @OpenDesignHQ](https://x.com/OpenDesignHQ) · [YouTube](https://www.youtube.com/channel/UChtshixMhvtgBWzoD9R_Qfg)
-[**在 GitHub 上给 OpenMotion 点个 Star**](https://github.com/nexu-io/html-anything)
+[**在 GitHub 上给 OpenMotion 点个 Star**](https://github.com/nexu-io/openmotion)
-[![关注 OpenMotion · 在 GitHub 上加星](readme/community-star.zh-CN.svg)](https://github.com/nexu-io/html-anything)
+[![关注 OpenMotion · 在 GitHub 上加星](readme/community-star.zh-CN.svg)](https://github.com/nexu-io/openmotion)
<a id="acknowledgements"></a>
@@ -873,4 +873,4 @@ OpenMotion 采用 [Apache-2.0](../LICENSE)许可。第三方代码、模板、
[素材来源](readme/ASSETS.md) · [其他展示素材来源](readme/brand-showcase/README.md) · [字体声明](../web/design-system/fonts/NOTICES.txt) · [Studio 许可证](../studio/LICENSE)
-原 HTML Anything 应用保留在 [`legacy` 分支](https://github.com/nexu-io/html-anything/tree/legacy)。当前分支与分发边界参见[仓库迁移指南](repository-migration.md) 。
+原 HTML Anything 应用保留在 [`legacy` 分支](https://github.com/nexu-io/openmotion/tree/legacy)。当前分支与分发边界参见[仓库迁移指南](repository-migration.md) 。
diff --git a/docs/motion-release-activation.md b/docs/motion-release-activation.md
index 87b56fee..1bb13490 100644
--- a/docs/motion-release-activation.md
+++ b/docs/motion-release-activation.md
@@ -1,29 +1,29 @@
# OpenMotion repository and release activation
-OpenMotion is the application on `main` in `nexu-io/html-anything`. Daily integration and manual release operations continue on `feature/motion`; the default branch remains `main`. The former HTML Anything application remains available on [legacy](https://github.com/nexu-io/html-anything/tree/legacy).
+OpenMotion is the application on `main` in `nexu-io/openmotion`, renamed from `nexu-io/html-anything`. Daily development and new manual release operations use `main`. Git history, existing issues, pull requests and historical candidate artifacts remain in the same GitHub repository. The former HTML Anything application remains on [legacy](https://github.com/nexu-io/openmotion/tree/legacy).
-The default-branch cutover carries the integrated Motion workflows, helpers, templates and tests. It replaces the older registration-only copies on main. A push or merge runs validation; it does not publish a package, advance npm tags or write release storage.
+A push or merge runs validation; it does not publish a package, advance npm tags or update the public installation guide.
## Repository and release identity
-The repository remains `nexu-io/html-anything`. Repository guards, installation URLs and generated package links retain that address. Repository renaming is a separate administrator action.
+New source-install commands, generated guide/package links and release guards use `nexu-io/openmotion`. New candidate builds and manual publication/recovery require `main`; application source must be integrated there. Frozen pre-rename candidate receipts keep their original repository/ref identity and remain verifiable against the same GitHub producer run and artifact hashes. They are not rewritten.
-Before the next npm publication, a package maintainer must verify the trusted publisher for `@openmotion/app` in npm:
+Before the next npm publication, a package maintainer must verify or update the external trusted publisher for `@openmotion/app` in npm:
| Setting | Value |
| --- | --- |
| Organization | `nexu-io` |
-| Repository | `html-anything` |
+| Repository | `openmotion` |
| Workflow | `motion-publish-test.yml` |
| Environment | Blank |
| Permissions | npm publish and npm dist-tag |
-The main-branch cutover does not change npm trust, published packages or tags. If the repository is renamed later, update its source URLs, release guards and npm trusted-publisher setting together before the next publication.
+Source changes do not update npm trust. Keep the workflow filename because it is part of the trusted-publisher identity. Existing R2 secrets and variables stay with the same GitHub repository; never copy their values into source. Only authorized publication/storage jobs receive publication credentials.
-Existing R2 secrets and variables stay with the same GitHub repository; never copy their values into source. Only the authorized publication/storage jobs receive publication credentials.
+## Installation and onboarding rollout
-## Manual operations
+The canonical installation-success reply contract and few-shots are in [docs/install.md](install.md#installation-success-reply). Installers return that contract plus bounded real template summaries in the installation turn. The Agent defaults to one confirmed template, offers three for an explicit comparison request when available, and creates the exact selected template only after consent. A known template plus an explicit creation request continues directly. Registration is separate from current-chat loading and invitation display.
-Use the [release workflow manual](release-workflows.md) for candidate building, exact-byte publication, native installation checks and snapshot recovery. Select `feature/motion` in **Run workflow**. Keep candidate validation, target-machine installation, real Agent creation and human audiovisual acceptance separate.
+To make those changes available through the website's existing short installation prompt, build and publish a new test candidate from `main`, then promote its matching DEV guide. The `/open-motion/dev/install.md` path and npm package name `@openmotion/app` stay the same; `dev` names the test channel, not the Git branch. Stable publication uses the stable guide separately. Never point a public guide at an unpublished version or claim that a source-only change has reached installed hosts.
-Main and repository-name changes do not authorize npm publication or storage writes. Historical registration began with [PR #222](https://github.com/nexu-io/html-anything/pull/222); the current integrated source and workflow manual supersede those registration-only instructions.
+Use the [release workflow manual](release-workflows.md) for exact-byte publication, native installation checks and snapshot recovery. Keep candidate validation, target-machine installation, real host invitation/creation and human audiovisual acceptance separate. Repository migration and green CI do not authorize publication.
diff --git a/docs/npm-installation.md b/docs/npm-installation.md
index b48410cd..bf5a8ef4 100644
--- a/docs/npm-installation.md
+++ b/docs/npm-installation.md
@@ -18,7 +18,7 @@ The npm page uses the repository's product `README.md`. Packaging resolves its r
## Build and install a local test
-From a clean checkout based on `feature/motion`:
+From a clean checkout based on `main`:
```sh
npm ci --no-audit --no-fund
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index 83e41b13..8052b712 100644
--- a/docs/product/architecture.md
+++ b/docs/product/architecture.md
@@ -37,7 +37,7 @@ Model Gateway remains a shared media-generation backend for MCP, using local Cod
## 对外主张与 Motion.md 方向
-The public product name is **OpenMotion**. README pages place the centered logo above the cover and retain a plain-text OpenMotion heading before the introduction. The cover and footer share the same identity. OpenMotion is on `main` in `nexu-io/html-anything`, with daily integration on `feature/motion`; the `motion` plugin identifier and environment variables remain compatible. The public workflow is reference → analysis and reconstruction → brand adaptation → multimodal generation → editing and rendering. It emphasizes editable HTML video, BYOA / BYOK, presenter stories, editable projects and the Motion.md community. English, Simplified Chinese and Japanese READMEs share examples, media and stable section anchors. README localization is maintained independently of the Studio interface, which currently supports eleven languages.
+The public product name is **OpenMotion**. README pages place the centered logo above the cover and retain a plain-text OpenMotion heading before the introduction. The cover and footer share the same identity. OpenMotion is on `main` in `nexu-io/openmotion`, with daily integration and new release operations on `main`; the `motion` plugin identifier and environment variables remain compatible. The public workflow is reference → analysis and reconstruction → brand adaptation → multimodal generation → editing and rendering. It emphasizes editable HTML video, BYOA / BYOK, presenter stories, editable projects and the Motion.md community. English, Simplified Chinese and Japanese READMEs share examples, media and stable section anchors. README localization is maintained independently of the Studio interface, which currently supports eleven languages.
“任何视频”是工作流的创作范围表述,不保证任意输入的获取、解析、还原度或传播结果。参考获取与媒体分析依赖宿主工具和用户材料,生成效果依赖模型配置,成片需按参考、简报与实际视听结果审阅。README 的发布部分明确区分当前 MP4 手动交接与规划中的平台连接、排期和反馈。外部产品来源和比较统一放在 README 最后的 Acknowledgements,技术依赖与具体出处仍保留在专题和源文件中。
@@ -276,9 +276,9 @@ Mac arm64 installation and complete-bundle startup impose no additional macOS ve
## 演进约束
-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.
+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. New candidate builds, npm publication and snapshot recovery run only from main in nexu-io/openmotion. Frozen receipts from the former repository name and feature/motion producer runs remain readable with their original run/hash identity. 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.
-Test publishes the same tgz under npm candidate, promotes test in an npm-OIDC-only job with bounded propagation retries, then archives and advances the DEV guide. Mac/Windows cold installs follow as non-blocking checks with visible warnings. Stable uses the same trusted workflow filename and publicly stages the exact prod tgz under stage. Both matching Mac/Windows installation reports must pass before latest advances; test is preserved, prod snapshots follow, and the stable guide advances last. Stage is public. A separate read-only installation workflow can recheck an exact public test or stable version using the shared registry-download retries. npm and R2 are not atomic; storage failure can leave the guide on the earlier version. Builds can continue during acceptance; publication serialization, version checks and ETag writes prevent an older completion from regressing the guide. Snapshot-only recovery requires an identical existing npm version and never moves tags or the default. No private template contents or credentials are bundled. Default-branch registration and npm trust remain separate activation prerequisites. Live prod templates, real Agent creation and human playback remain release acceptance responsibilities, separate from build and native-install evidence. See [release workflows](../release-workflows.md) and [package checks](../test-packages.md).
+Test publishes the same tgz under npm candidate, promotes test in an npm-OIDC-only job with bounded propagation retries, then archives and advances the DEV guide. Mac/Windows cold installs follow as non-blocking checks with visible warnings. Stable uses the same trusted workflow filename and publicly stages the exact prod tgz under stage. Both matching Mac/Windows installation reports must pass before latest advances; test is preserved, prod snapshots follow, and the stable guide advances last. Stage is public. A separate read-only installation workflow can recheck an exact public test or stable version using the shared registry-download retries. npm and R2 are not atomic; storage failure can leave the guide on the earlier version. Builds can continue during acceptance; publication serialization, version checks and ETag writes prevent an older completion from regressing the guide. Snapshot-only recovery requires an identical existing npm version and never moves tags or the default. No private template contents or credentials are bundled. npm trusted-publisher configuration must name the renamed repository and remains a separate activation prerequisite. Live prod templates, real Agent creation and human playback remain release acceptance responsibilities, separate from build and native-install evidence. See [release workflows](../release-workflows.md) and [package checks](../test-packages.md).
Downstream publication jobs consume immutable producer artifact IDs retained across partial retries; native Mac and Windows jobs expose separate report identities. OIDC authenticates publication, but automatic npm provenance is disabled for prebuilt candidates because the publication workflow SHA differs from the application source. Candidate/manifest/hash records provide traceability without claiming a signed build attestation. Test and stable share source/hash/scanning and retry controls; stable release records additionally retain both matching native reports. Skills marketplace/platform publication is not implemented. The bundled Skills are installed into local hosts only.
diff --git a/docs/release-workflows.md b/docs/release-workflows.md
index 57163b7c..aec05560 100644
--- a/docs/release-workflows.md
+++ b/docs/release-workflows.md
@@ -1,10 +1,10 @@
# Motion releases: build, test, publish
-Use two manual Actions entries: **Motion candidate build**, then **Motion npm publication**. The daily flow is **build → optional local testing → manual publish**. Neither entry runs on pushes, PR merges, tags or a schedule. The entries are registered on `main`; Motion application development stays on `feature/motion`. Merging a workflow change does not publish a package or configure npm permissions.
+Use two manual Actions entries: **Motion candidate build**, then **Motion npm publication**, in `nexu-io/openmotion` on `main`. The daily flow is **build → optional local testing → manual publish**. Neither entry runs on pushes, PR merges, tags or a schedule. Merging a workflow change does not publish a package or configure npm permissions.
| Operator step | Automated work |
| --- | --- |
-| Build: select `feature/motion` and channel; leave test version empty or enter a stable version | Freeze the current `feature/motion` SHA and template environment, check/build/scan once, retain the candidate and show download/install instructions |
+| Build: select `main` and channel; leave test version empty or enter a stable version | Freeze the current `main` SHA and template environment, check/build/scan once, retain the candidate and show download/install instructions |
| Optional local testing | Use `candidate-install.md` and the local tgz in an isolated host; retain completed `acceptance.md` internally |
| Publish: select the same channel and enter the exact candidate version | Find the unique candidate, verify source/hashes and publish the same tgz. Test advances `test` before non-blocking native checks; stable requires both native checks before `latest`. Archive snapshots and update the corresponding guide last |
@@ -14,7 +14,7 @@ New public test packages use **DEV templates**; stable packages use prod. The `d
## First-time administrator setup
-The default `main` contains OpenMotion; the former HTML Anything application remains on `legacy`. GitHub requires a `workflow_dispatch` workflow to exist on the **default branch** before its manual entry is available; it can otherwise run from another ref. For candidate build, npm publication and snapshot recovery, select **Use workflow from: feature/motion**. Selecting `main`, `legacy`, a tag or another feature/fix branch fails explicitly before checkout or release work. Older valid candidates built from `main` remain readable; new operations execute the reviewed controls on `feature/motion`. Application source always comes from a commit integrated into `feature/motion`. Keep the reviewed control files aligned between `main` and `feature/motion`. See [GitHub's manual workflow requirements](https://docs.github.com/en/actions/how-tos/manage-workflow-runs/manually-run-a-workflow).
+The default `main` contains OpenMotion; the former HTML Anything application remains on `legacy`. For candidate build, npm publication and snapshot recovery, select **Use workflow from: main**. Selecting `feature/motion`, `legacy`, a tag or another feature/fix branch fails before new release work. Application source must be a reviewed commit integrated into `main`. Frozen candidates produced before the repository rename/main cutover retain their original receipt identity and remain readable; new builds seal only the current repository/main identity. See [GitHub's manual workflow requirements](https://docs.github.com/en/actions/how-tos/manage-workflow-runs/manually-run-a-workflow).
Keep these control files together:
@@ -22,9 +22,9 @@ Keep these control files together:
- `.github/scripts/motion-release.mjs`, `motion-scan.mjs`, `motion-registry.mjs`, `motion-registry-smoke.mjs`, `publish-install-guide.mjs` and `.github/gitleaks.toml`.
- `scripts/runtime-assets.mjs`, `release-version.mjs`, `install-guide.mjs`, `docs/install.md`, `docs/templates/release-record.md` and `docs/templates/candidate-install.md`.
-Protect changes to the trusted control files and `feature/motion`; keep default-branch registration aligned. There is no `motion-test-publish` GitHub Environment prerequisite or Review deployments step in this version.
+Protect changes to the trusted control files and `main`; keep default-branch registration aligned. There is no `motion-test-publish` GitHub Environment prerequisite or Review deployments step in this version.
-For `@openmotion/app`, open npm **Settings → Trusted publishing → Add trusted publisher → GitHub Actions**. Set owner **`nexu-io`**, repository **`html-anything`**, workflow filename **`motion-publish-test.yml`** (no directory), **leave Environment blank**, and allow **npm publish** plus **Allow npm dist-tag**. The latter is separately required to advance `test` or `latest` after registry propagation; enabling publish alone is insufficient. If an older entry names an environment, it must be updated to match this workflow before publication. GitHub-hosted runners use Node 26.11.1; credentialed npm jobs explicitly install npm 11.21.2 for OIDC dist-tag support and `id-token: write`; no stored npm token is needed. The recovery caller never calls npm publish or dist-tag. npm does not support a dist-tag dry-run; do not test that command against the real registry without channel-write authorization. See [npm trusted publishing](https://docs.npmjs.com/trusted-publishers/).
+For `@openmotion/app`, open npm **Settings → Trusted publishing → Add trusted publisher → GitHub Actions**. After the repository rename, verify or update npm's external trusted-publisher configuration; source changes do not update it automatically. Set owner **`nexu-io`**, repository **`openmotion`**, workflow filename **`motion-publish-test.yml`** (no directory), **leave Environment blank**, and allow **npm publish** plus **Allow npm dist-tag**. The latter is separately required to advance `test` or `latest` after registry propagation; enabling publish alone is insufficient. If an older entry names an environment, it must be updated to match this workflow before publication. GitHub-hosted runners use Node 26.11.1; credentialed npm jobs explicitly install npm 11.21.2 for OIDC dist-tag support and `id-token: write`; no stored npm token is needed. The recovery caller never calls npm publish or dist-tag. npm does not support a dist-tag dry-run; do not test that command against the real registry without channel-write authorization. See [npm trusted publishing](https://docs.npmjs.com/trusted-publishers/).
Reuse the existing R2 settings. Only the final snapshot step receives the storage credentials:
@@ -37,15 +37,15 @@ Reuse the existing R2 settings. Only the final snapshot step receives the storag
## 1. Build
-Open **Actions → Motion candidate build → Run workflow**, select **`feature/motion`** and a **channel**. For `test`, normally leave **version** empty. For `stable`, enter an explicit new version such as `0.6.4` (no suffix); empty or mismatched versions fail before building. Use this same branch for publication and recovery; `main` registers the manual Actions entries; release operations still execute from `feature/motion`.
+Open **Actions → Motion candidate build → Run workflow**, select **`main`** and a **channel**. For `test`, normally leave **version** empty. For `stable`, enter an explicit new version such as `0.6.4` (no suffix); empty or mismatched versions fail before building. Use this same branch for publication and recovery; `main` registers the manual Actions entries; release operations still execute from `main`.
An empty version uses the frozen Motion source's `package.json`, increments its patch and appends a short `-test.N`. `N` is the candidate workflow's `GITHUB_RUN_NUMBER` plus **5**: candidate run #1 used the retired long format, and run #2 continues after historical `test.6` as **`0.6.4-test.7`**, then run #3 produces **`0.6.4-test.8`**. Failed builds and explicit overrides still consume run numbers, so gaps are expected. A rerun adds its attempt only after the first attempt, for example `0.6.4-test.7.2`; start a new build if an older rerun is rejected by the no-regression check. Do not reset or move the workflow file without reviewing this numbering offset. Full run ID, attempt and source SHA remain in candidate.json and acceptance.md. See [GitHub run variables](https://docs.github.com/en/actions/reference/workflows-and-actions/variables).
-The checkout version is a development baseline, not the last published package version. Packaging stamps the resolved version into the output package, application, lock and plugin metadata without rewriting source manifests. Thus source `0.6.3` and the historical npm `0.6.4-test.6` can coexist; no stable `0.6.4` is implied. With `source_sha` empty, source is frozen to `GITHUB_SHA` of the selected `feature/motion` dispatch, even if the branch advances while the run queues. The legacy `main` package version is never used for automatic Motion numbering. After a stable release, maintainers must advance the Motion source baseline for the next patch series.
+The checkout version is a development baseline, not the last published package version. Packaging stamps the resolved version into the output package, application, lock and plugin metadata without rewriting source manifests. Thus source `0.6.3` and the historical npm `0.6.4-test.6` can coexist; no stable `0.6.4` is implied. With `source_sha` empty, source is frozen to `GITHUB_SHA` of the selected `main` dispatch, even if the branch advances while the run queues. The legacy `main` package version is never used for automatic Motion numbering. After a stable release, maintainers must advance the Motion source baseline for the next patch series.
To override numbering, enter a new `MAJOR.MINOR.PATCH-test.N[.N]`. Do not reuse an existing candidate/published version or choose one older than the current npm `test` channel. Never change bytes under an existing published version. The successful summary and artifact name show the resolved version; copy that exact version into the publication form after accepting its bytes. Publication never generates a new number.
-Normally leave **source_sha** empty. The build fetches `feature/motion`, resolves its current full SHA once, records it and checks out exactly that SHA. To test a particular reviewed integrated commit, supply its full 40-character SHA. A later branch update cannot silently change this candidate. Confirm the chosen source has completed the required integration review.
+Normally leave **source_sha** empty. The build fetches `main`, resolves its current full SHA once, records it and checks out exactly that SHA. To test a particular reviewed integrated commit, supply its full 40-character SHA. A later branch update cannot silently change this candidate. Confirm the chosen source has completed the required integration review.
The build scans tracked source before dependency installation, runs the technical checks/Studio regression/eleven-Tool ZIP E2E, builds the final channel-specific npm tgz once and scans its outer and inner archives. It has no npm OIDC or R2 credentials. Successful output is retained as **`motion-candidate-<version>` for 30 days**. Wait for the whole build run to succeed before publication.
@@ -67,9 +67,9 @@ Keep completed evidence against the generated candidate identity. Do not edit/re
## 3. Publish the candidate version
-Open **Actions → Motion npm publication → Run workflow**, select **`feature/motion`**, choose the same **channel** as the build, enter the exact candidate **version**, and click **Run workflow**. The workflow filename remains `motion-publish-test.yml`, so existing npm trust is reused. `test` is the default; stable must be selected explicitly. No acceptance checkbox or later independent approval dialog is required.
+Open **Actions → Motion npm publication → Run workflow**, select **`main`**, choose the same **channel** as the build, enter the exact candidate **version**, and click **Run workflow**. The workflow filename remains `motion-publish-test.yml`, and the npm trusted-publisher repository must be `openmotion`. `test` is the default; stable must be selected explicitly. No acceptance checkbox or later independent approval dialog is required.
-The workflow searches GitHub artifacts by the exact versioned name and requires exactly one unexpired match from a completed successful registered candidate build on `main` or `feature/motion` in this repository. Missing, ambiguous, expired or failed candidates stop instead of choosing a different run. Copy the exact version from the successful build summary. Entering `0.6.4-test.7` cannot rename an existing `0.6.4-test.42818506484.1` candidate: build `test.7` separately and accept its new bytes first. The official ZIP digest, frozen file hashes and source integration are checked; source and package scans run again. The current manual run's actual operator, candidate identity and publication action are retained in `authorization.json`.
+The workflow searches GitHub artifacts by the exact versioned name and requires exactly one unexpired match from a completed successful registered candidate build in this repository (including historical pre-cutover `feature/motion` runs). Missing, ambiguous, expired or failed candidates stop instead of choosing a different run. Copy the exact version from the successful build summary. Entering `0.6.4-test.7` cannot rename an existing `0.6.4-test.42818506484.1` candidate: build `test.7` separately and accept its new bytes first. The official ZIP digest, frozen file hashes and source integration are checked; source and package scans run again. The current manual run's actual operator, candidate identity and publication action are retained in `authorization.json`.
For **test**, it then automatically:
@@ -96,7 +96,7 @@ npm and R2 cannot commit atomically. If native checks fail, rerun the failed job
## Independent installation rechecks
-Use **Motion installation check** (`motion-install-check.yml`) to check an existing public test or stable version without starting publication. After its manual entry is registered on the default branch, select `feature/motion`, enter the exact version, and run. This entry has only `contents: read` and `actions: read`; it has no npm OIDC or R2 credentials and cannot publish, move tags or write install.md. Only candidate resolution receives the read-only GitHub token; installed consumer processes receive an allowlisted environment and isolated application/data/Skills/host directories.
+Use **Motion installation check** (`motion-install-check.yml`) to check an existing public test or stable version without starting publication. After its manual entry is registered on the default branch, select `main`, enter the exact version, and run. This entry has only `contents: read` and `actions: read`; it has no npm OIDC or R2 credentials and cannot publish, move tags or write install.md. Only candidate resolution receives the read-only GitHub token; installed consumer processes receive an allowlisted environment and isolated application/data/Skills/host directories.
The workflow verifies the original successful candidate's ZIP/file hashes and integrated source, then downloads the exact npm bytes on macOS ARM64 and Windows x64. It checks fresh/repeated setup, unrelated MCP-setting preservation, the version’s DEV/prod configuration, Chromium/FFmpeg/ffprobe preparation, eleven Tools, five Skills and resources. Both platforms complete independently (`fail-fast: false`). Metadata/tarball requests retry 404/408/429/5xx and transient network errors for up to 15 minutes per request. Authorization errors, malformed metadata and hash mismatches fail immediately. A failed retry cannot retain an old successful download report.
@@ -124,7 +124,7 @@ Actions artifacts and attempt records expire after **30 days**. R2 snapshots fol
- Before clicking publish: building, downloading and testing publish nothing. Discard an unwanted candidate. Fix code under a new version when bytes change.
- After clicking publish for test: the exact version and `candidate` tag are public even before native validation. Native checks run after publication. Once tag readback passes, `test` can advance before R2 finishes; if R2 fails it points to a verified version while the guide can remain on the previous version. npm and R2 are not one transaction. Inspect retained npm state and release-attempt/publication files; do not rebuild or blindly republish.
- Use **Re-run failed jobs** for a partial publication failure. Consumers use successful producer artifact IDs rather than guessing their own attempt. Re-running publication reuses the existing candidate and original accepted version; it does not rebuild. A candidate build rerun is different: a successful new artifact must be accepted again, and duplicate version artifacts block publication.
-- **Motion snapshot recovery** is a separate maintenance entry. Select `feature/motion`, choose the channel, enter the existing candidate version and start snapshot-only recovery. It requires an already published identical npm version. Test fills missing immutable snapshots and subsequently runs native checks; stable checks both exact prod installations before filling snapshots. It never builds, publishes npm, moves npm tags or accesses the moving guide. Missing/expired/ambiguous candidates stop.
+- **Motion snapshot recovery** is a separate maintenance entry. Select `main`, choose the channel, enter the existing candidate version and start snapshot-only recovery. It requires an already published identical npm version. Test fills missing immutable snapshots and subsequently runs native checks; stable checks both exact prod installations before filling snapshots. It never builds, publishes npm, moves npm tags or accesses the moving guide. Missing/expired/ambiguous candidates stop.
- Version writes use conditional create and byte comparison. Same bytes resume; different immutable bytes stop. A public readback error blocks promotion. A failure after `fixed-write-attempted` may mean the moving write completed: inspect storage and its canonical URL before retrying.
- An unexpected npm tag change stops promotion; a newer accepted stable version is preserved and only the older version snapshot is archived. This workflow does not silently repair tags. Channel rollback is a separate reviewed operation and does not downgrade installed clients or restore their data.
diff --git a/docs/repository-migration.md b/docs/repository-migration.md
index 638521f8..7814cb2c 100644
--- a/docs/repository-migration.md
+++ b/docs/repository-migration.md
@@ -1,8 +1,8 @@
# OpenMotion standalone repository
-OpenMotion replaces the former HTML Anything application at the repository root on `main`. The repository name remains `nexu-io/html-anything`; existing commits, issues and pull requests remain in the same repository. The cutover preserves Git history.
+OpenMotion replaces the former HTML Anything application at the repository root on `main`. The repository is `nexu-io/openmotion`, renamed from `nexu-io/html-anything`; existing commits, issues and pull requests remain in the same repository. The cutover preserves Git history.
-Daily Motion changes branch from the latest `feature/motion` and open PRs with that base. The previous application is preserved at [`legacy`](https://github.com/nexu-io/html-anything/tree/legacy). The default branch remains `main`. Package publication remains a separate, explicitly authorized operation.
+Daily Motion changes branch from the latest `main` and open PRs with that base. The previous application is preserved at [`legacy`](https://github.com/nexu-io/html-anything/tree/legacy). The default branch remains `main`. Package publication remains a separate, explicitly authorized operation.
## Upstream synchronization checkpoint
@@ -31,7 +31,7 @@ npm run package:npm
The npm output in `dist/npm-local/` contains an installer `.tgz`, application `.tar.gz`, manifest and SHA256. The application runs from its selected install directory, not transient npx cache. Node, browser and media tool requirements are pinned; native tools come from public sources and are cached on first use. See [installation](npm-installation.md).
-`install.sh` clones this repository's `feature/motion` branch and invokes `scripts/install-motion.command` from the root. `OPENMOTION_REF` can select a reviewed commit or another existing branch. Source installation requires Node/npm; complete ZIPs include a platform runtime. None of these installers relocates existing user projects.
+`install.sh` clones this repository's `main` branch and invokes `scripts/install-motion.command` from the root. `OPENMOTION_REF` can select a reviewed commit or another existing branch. Source installation requires Node/npm; complete ZIPs include a platform runtime. None of these installers relocates existing user projects.
## Public source and package contents
diff --git a/docs/test-packages.md b/docs/test-packages.md
index b37ec024..6ee3383f 100644
--- a/docs/test-packages.md
+++ b/docs/test-packages.md
@@ -19,7 +19,7 @@ MCP 公开入口由包内 `shared/mcp-release.json` 固化,详见[一期注册
Ordinary builds retain candidate installation-guide artifacts for review; they do not publish npm, Release or R2 objects. Separate manual guide publication follows the release guide; 两种格式误勾 `publish` 均会失败。本地构建的制品位于 `dist/`,The tgz alone is sufficient for setup; adjacent application/manifest files are evidence and an explicit-manifest fallback. See [installation](npm-installation.md) and [test/stable acceptance](release-guide.md).
-Explicit builds accept stable `MAJOR.MINOR.PATCH` or `MAJOR.MINOR.PATCH-test.N[.N]`. The shared helper selects next-patch `test.<run>.<attempt>` (for example, 0.6.3 → 0.6.4-test.42.1). The separate [Motion candidate build](release-workflows.md#1-build) runs from `feature/motion` and uses short workflow-counter versions when version is empty, for example `0.6.4-test.7` (rerun `0.6.4-test.7.2`); ordinary check builds retain their workflow-local numbering. Candidate publication uses the accepted version unchanged. All embedded identities agree; output directories cannot be overwritten and source versions do not change. Explicit test npm builds default to DEV and candidate; stable npm builds default to prod and stage. Unversioned and channel/environment-mismatched builds remain private. The backup ZIP builder still defaults to prod unless explicitly selected. Publication remains disabled.
+Explicit builds accept stable `MAJOR.MINOR.PATCH` or `MAJOR.MINOR.PATCH-test.N[.N]`. The shared helper selects next-patch `test.<run>.<attempt>` (for example, 0.6.3 → 0.6.4-test.42.1). The separate [Motion candidate build](release-workflows.md#1-build) runs from `main` and uses short workflow-counter versions when version is empty, for example `0.6.4-test.7` (rerun `0.6.4-test.7.2`); ordinary check builds retain their workflow-local numbering. Candidate publication uses the accepted version unchanged. All embedded identities agree; output directories cannot be overwritten and source versions do not change. Explicit test npm builds default to DEV and candidate; stable npm builds default to prod and stage. Unversioned and channel/environment-mismatched builds remain private. The backup ZIP builder still defaults to prod unless explicitly selected. Publication remains disabled.
PR / main 工作流执行清单、类型、Studio 构建与回归、安装/打包测试,以及十一个 Tool 的真实 ZIP E2E。Linux 是组装与测试环境,不是已支持的用户运行平台。Mac / Windows 的最终安装和真实出片仍须在对应系统验收;当前 本仓库工作流没有 Windows 或 Mac 原生验收 job,不把产包成功写成通过。
diff --git a/docs/usage.md b/docs/usage.md
index a9bcb1fd..d3d9e324 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -64,7 +64,7 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图
### 复制到 Codex 安装并体验
-适用于 macOS / Linux。先克隆本公开仓库的 `feature/motion` 分支,并用 Codex 打开该目录。需要支持插件的 Codex CLI、Git 和 Node.js 22.18+(含 npm)。将下面这段发到 Codex 对话框:
+适用于 macOS / Linux。先克隆本公开仓库的 `main` 分支,并用 Codex 打开该目录。需要支持插件的 Codex CLI、Git 和 Node.js 22.18+(含 npm)。将下面这段发到 Codex 对话框:
```text
请在当前仓库目录运行 bash scripts/install-motion.command 安装 openmotion。
diff --git a/install.sh b/install.sh
index 7254bcf1..76f92c0f 100644
--- a/install.sh
+++ b/install.sh
@@ -3,8 +3,8 @@
set -euo pipefail
main() {
- local motion_repo='https://github.com/nexu-io/html-anything.git'
- local motion_ref="${OPENMOTION_REF:-feature/motion}"
+ local motion_repo='https://github.com/nexu-io/openmotion.git'
+ local motion_ref="${OPENMOTION_REF:-main}"
local motion_destination="${OPENMOTION_INSTALL_DIR:-${XDG_DATA_HOME:-$HOME/.local/share}/open-motion}"
for motion_command in git node npm codex; do
diff --git a/packages/npm/package.json b/packages/npm/package.json
index 433eb26a..127179dc 100644
--- a/packages/npm/package.json
+++ b/packages/npm/package.json
@@ -1,6 +1,6 @@
{
"name": "@openmotion/app",
- "repository": { "type": "git", "url": "git+https://github.com/nexu-io/html-anything.git" },
+ "repository": { "type": "git", "url": "git+https://github.com/nexu-io/openmotion.git" },
"version": "0.6.3-local.1",
"private": true,
"description": "OpenMotion application, MCP and Skills installer for local Agent hosts",
diff --git a/scripts/install-guide.mjs b/scripts/install-guide.mjs
index fcb8c18a..c7d887e1 100644
--- a/scripts/install-guide.mjs
+++ b/scripts/install-guide.mjs
@@ -34,7 +34,7 @@ export async function generateInstallGuide(tgz, output, candidate = false) {
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 ? ` (${t.minimumOS}+)` : ''}`).join(', '),
- DETAILS_URL: `https://github.com/nexu-io/html-anything/blob/${manifest.commit}/docs/npm-installation.md` };
+ DETAILS_URL: `https://github.com/nexu-io/openmotion/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.
const text = (candidate ? '> Build preview only: this candidate is not an approved registry installation entry.\n\n' : '') + template.replace(/^If you are reading this file.*\n\n/m, '').replace(/\{\{([A-Z0-9_]+)\}\}/g, (_, key) => {
diff --git a/scripts/package-npm.mjs b/scripts/package-npm.mjs
index 577cc705..62e85736 100644
--- a/scripts/package-npm.mjs
+++ b/scripts/package-npm.mjs
@@ -21,7 +21,7 @@ function rewriteGuideLinks(text, file, commit, localPaths = new Set()) {
if (/^(?:#|[a-z][a-z\d+.-]*:|\/\/)/i.test(target)) return target;
const pathname = target.split(/[?#]/, 1)[0];
if (localPaths.has(path.posix.join(directory, pathname).replace(/\/$/, ''))) return target;
- const base = image ? 'https://raw.githubusercontent.com/nexu-io/html-anything/' : 'https://github.com/nexu-io/html-anything/blob/';
+ const base = image ? 'https://raw.githubusercontent.com/nexu-io/openmotion/' : 'https://github.com/nexu-io/openmotion/blob/';
return new URL(target, base + commit + '/' + (directory === '.' ? '' : directory + '/')).href;
};
return text
diff --git a/tests/bootstrap.test.ts b/tests/bootstrap.test.ts
index 8e7f5420..dad71cb5 100644
--- a/tests/bootstrap.test.ts
+++ b/tests/bootstrap.test.ts
@@ -44,7 +44,7 @@ test('remote entry point builds a fresh checkout before registering and checking
assert.equal(result.status, 0, result.stderr);
await access(path.join(destination, 'studio/build/index.html'));
const commands = await readFile(log, 'utf8');
- assert.match(commands, /git clone --depth 1 --branch test-ref -- https:\/\/github\.com\/nexu-io\/html-anything\.git/);
+ assert.match(commands, /git clone --depth 1 --branch test-ref -- https:\/\/github\.com\/nexu-io\/openmotion\.git/);
assert.ok(commands.indexOf('npm ci --include=dev') < commands.indexOf('npm run build:studio'));
assert.ok(commands.indexOf('npm run build:studio') < commands.indexOf('codex plugin marketplace add'));
assert.match(commands, /codex plugin add motion@motion-local\ncodex plugin list --marketplace motion-local\nMCP check/);
diff --git a/tests/install-guide.test.ts b/tests/install-guide.test.ts
index 1b82906b..daad9551 100644
--- a/tests/install-guide.test.ts
+++ b/tests/install-guide.test.ts
@@ -69,6 +69,9 @@ test('guide rendering pins the exact npm package, built source and hash while re
const text = await readFile(path.join(directory, 'install.md'), 'utf8');
assert(text.includes(`npx --yes --package "${pkg.name}@${pkg.version}"`));
assert(text.includes(manifest.commit) && text.includes(record.tgzSHA256));
+ assert(text.includes(`https://github.com/nexu-io/openmotion/blob/${manifest.commit}/docs/npm-installation.md`),
+ 'Generated guides must use the renamed repository and immutable source SHA');
+ assert(!text.includes('nexu-io/html-anything'), 'Do not republish retired repository links');
assert(!text.includes('{{') && !text.includes('see `{{...}}`'));
assert(text.includes('eleven public Tools') && text.includes('five Skills'));
assert(text.includes('new test versions embed DEV defaults') && !text.includes('does not select DEV templates'),
diff --git a/tests/npm-package.test.ts b/tests/npm-package.test.ts
index 37fd4322..61b813db 100644
--- a/tests/npm-package.test.ts
+++ b/tests/npm-package.test.ts
@@ -67,18 +67,18 @@ test('test npm artifacts contain their application, locked manifest and no bundl
await extractArchive(built.application, application); await extractArchive(built.installer, installer);
const readme = await readFile(path.join(installer, 'package/README.md'), 'utf8');
assert(readme.includes("Reverse engineering for any video"));
- assert(readme.includes(`https://raw.githubusercontent.com/nexu-io/html-anything/${release.commit}/docs/readme/brand-hero.jpg`));
- assert(readme.includes(`src="https://raw.githubusercontent.com/nexu-io/html-anything/${release.commit}/docs/readme/openmotion-logo.svg"`));
- assert(readme.includes(`https://github.com/nexu-io/html-anything/blob/${release.commit}/docs/motion-md.md`));
+ assert(readme.includes(`https://raw.githubusercontent.com/nexu-io/openmotion/${release.commit}/docs/readme/brand-hero.jpg`));
+ assert(readme.includes(`src="https://raw.githubusercontent.com/nexu-io/openmotion/${release.commit}/docs/readme/openmotion-logo.svg"`));
+ assert(readme.includes(`https://github.com/nexu-io/openmotion/blob/${release.commit}/docs/motion-md.md`));
assert(readme.includes('](#choose-agent)'));
assert(readme.includes('href="https://open-design.ai/motion/'));
- assert(readme.includes(`srcset="https://raw.githubusercontent.com/nexu-io/html-anything/${release.commit}/docs/readme/brand-hero.mobile.jpg"`));
- assert(readme.includes(`href="https://github.com/nexu-io/html-anything/blob/${release.commit}/docs/readme/media/presenter-caption-remake.mp4"`));
+ assert(readme.includes(`srcset="https://raw.githubusercontent.com/nexu-io/openmotion/${release.commit}/docs/readme/brand-hero.mobile.jpg"`));
+ assert(readme.includes(`href="https://github.com/nexu-io/openmotion/blob/${release.commit}/docs/readme/media/presenter-caption-remake.mp4"`));
assert(!readme.includes('](docs/') && !readme.includes('](template-library/'));
assert(!readme.startsWith('# Motion application npm package'));
const embeddedReadme = await readFile(path.join(application, 'README.md'), 'utf8');
assert(embeddedReadme.includes('](docs/motion-md.md)'), 'Installed documentation keeps local links to shipped guides');
- assert(embeddedReadme.includes(`srcset="https://raw.githubusercontent.com/nexu-io/html-anything/${release.commit}/docs/readme/brand-hero.mobile.jpg"`));
+ assert(embeddedReadme.includes(`srcset="https://raw.githubusercontent.com/nexu-io/openmotion/${release.commit}/docs/readme/brand-hero.mobile.jpg"`));
await assert.rejects(readdir(path.join(application, 'docs/readme/media')), { code: 'ENOENT' });
assert.equal((await json(path.join(application, 'package.json'))).version, version);
await verifyTrackingPolicy(application, 'test');
diff --git a/tests/release-fixture.mjs b/tests/release-fixture.mjs
index 536ebcc8..51024e39 100644
--- a/tests/release-fixture.mjs
+++ b/tests/release-fixture.mjs
@@ -34,8 +34,8 @@ export async function candidateFixture(t, branch = 'main', options = {}) {
const provenance = { head_branch: branch, head_sha: env.GITHUB_SHA, runId: 123, attempt: 1 };
await writeJSON(path.join(directory, 'provenance.json'), provenance);
const inputs = { action: 'publish-' + channel, channel, version, expectedSHA256: candidate.tgzSHA256 };
- const publicationEnv = { GITHUB_REPOSITORY: repository, GITHUB_EVENT_NAME: 'workflow_dispatch', GITHUB_REF: 'refs/heads/feature/motion',
- GITHUB_RUN_ID: '800', GITHUB_SHA: env.GITHUB_SHA, GITHUB_WORKFLOW_REF: `${repository}/${publicationWorkflow}@refs/heads/feature/motion`,
+ const publicationEnv = { GITHUB_REPOSITORY: repository, GITHUB_EVENT_NAME: 'workflow_dispatch', GITHUB_REF: 'refs/heads/main',
+ GITHUB_RUN_ID: '800', GITHUB_SHA: env.GITHUB_SHA, GITHUB_WORKFLOW_REF: `${repository}/${publicationWorkflow}@refs/heads/main`,
MOTION_VERSION: version, MOTION_RELEASE_CHANNEL: channel, MOTION_RELEASE_ACTION: inputs.action };
const authorization = authorizationReceipt(candidate, { id: 800, run_attempt: 1, actor: { login: 'operator' } }, inputs.action);
await writeJSON(path.join(directory, 'authorization.json'), authorization);
diff --git a/tests/release-workflows.test.mjs b/tests/release-workflows.test.mjs
index 417ac977..68a869c3 100644
--- a/tests/release-workflows.test.mjs
+++ b/tests/release-workflows.test.mjs
@@ -12,28 +12,36 @@ import { consumerEnvironment } from '../.github/scripts/motion-registry-smoke.mj
import { runFile } from '../scripts/runtime-assets.mjs';
const config = { endpoint: 'https://example.r2.cloudflarestorage.com', bucket: 'example-releases', publicOrigin: 'https://download.example.invalid' };
-const valid = { GITHUB_REPOSITORY: repository, GITHUB_EVENT_NAME: 'workflow_dispatch', GITHUB_REF: 'refs/heads/feature/motion',
- GITHUB_WORKFLOW_REF: `${repository}/${publicationWorkflow}@refs/heads/feature/motion`, MOTION_VERSION: '0.6.4-test.99', MOTION_RELEASE_ACTION: 'publish-test', MOTION_EXPECTED_SHA256: 'a'.repeat(64) };
+const valid = { GITHUB_REPOSITORY: repository, GITHUB_EVENT_NAME: 'workflow_dispatch', GITHUB_REF: 'refs/heads/main',
+ GITHUB_WORKFLOW_REF: `${repository}/${publicationWorkflow}@refs/heads/main`, MOTION_VERSION: '0.6.4-test.99', MOTION_RELEASE_ACTION: 'publish-test', MOTION_EXPECTED_SHA256: 'a'.repeat(64) };
const origin = { id: 123, run_attempt: 1, event: 'workflow_dispatch', head_branch: 'main', head_repository: { full_name: repository }, status: 'completed', conclusion: 'success', path: candidateWorkflow, head_sha: 'b'.repeat(40) };
const artifact = { id: 456, name: 'motion-candidate-0.6.4-test.99', workflow_run: { id: 123 }, expired: false, size_in_bytes: 100, digest: 'sha256:' + 'a'.repeat(64) };
+test('renamed OpenMotion accepts manual releases from main and rejects retired identities', () => {
+ const entry = { ...valid, GITHUB_REPOSITORY: 'nexu-io/openmotion', GITHUB_REF: 'refs/heads/main',
+ GITHUB_WORKFLOW_REF: `nexu-io/openmotion/${publicationWorkflow}@refs/heads/main` };
+ assert.equal(releaseInputs(entry).action, 'publish-test');
+ assert.throws(() => releaseInputs({ ...entry, GITHUB_REPOSITORY: 'nexu-io/html-anything' }));
+ assert.throws(() => releaseInputs({ ...entry, GITHUB_REF: 'refs/heads/feature/motion' }));
+});
+
test('manual entry and source selection reject untrusted callers, mutable refs and non-test versions', async () => {
assert.equal(releaseInputs(valid).action, 'publish-test');
- for (const [key, value] of Object.entries({ GITHUB_REPOSITORY: 'fork/repo', GITHUB_EVENT_NAME: 'push', GITHUB_REF: 'refs/heads/main', GITHUB_WORKFLOW_REF: `${repository}/evil.yml@refs/heads/feature/motion`, MOTION_EXPECTED_SHA256: 'bad', MOTION_VERSION: '0.6.4', MOTION_RELEASE_ACTION: 'stable' })) assert.throws(() => releaseInputs({ ...valid, [key]: value }));
- const recovery = { ...valid, GITHUB_WORKFLOW_REF: `${repository}/${recoveryWorkflow}@refs/heads/feature/motion` };
+ for (const [key, value] of Object.entries({ GITHUB_REPOSITORY: 'fork/repo', GITHUB_EVENT_NAME: 'push', GITHUB_REF: 'refs/heads/feature/motion', GITHUB_WORKFLOW_REF: `${repository}/evil.yml@refs/heads/main`, MOTION_EXPECTED_SHA256: 'bad', MOTION_VERSION: '0.6.4', MOTION_RELEASE_ACTION: 'stable' })) assert.throws(() => releaseInputs({ ...valid, [key]: value }));
+ const recovery = { ...valid, GITHUB_WORKFLOW_REF: `${repository}/${recoveryWorkflow}@refs/heads/main` };
assert.throws(() => releaseInputs(recovery), /Recovery/);
assert.equal(releaseInputs({ ...recovery, MOTION_RELEASE_ACTION: 'archive-only' }).action, 'archive-only');
let called = false;
- await validateSource('.', 'a'.repeat(40), '0.6.4-test.7', async (_, args) => { called = true; assert(args.includes('refs/remotes/origin/feature/motion')); }); assert(called);
+ await validateSource('.', 'a'.repeat(40), '0.6.4-test.7', async (_, args) => { called = true; assert(args.includes('refs/remotes/origin/main')); }); assert(called);
for (const [sha, version] of [['main', '0.6.4-test.7'], ['a'.repeat(40), '0.6.4-test.0']]) await assert.rejects(validateSource('.', sha, version, async () => { throw Error('must not run'); }));
await assert.rejects(validateSource('.', 'a'.repeat(40), '0.6.4-test.7', async () => { throw Error('not integrated'); }), /not integrated/);
- const buildEnv = { ...valid, GITHUB_SHA: 'a'.repeat(40), GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/feature/motion` };
+ const buildEnv = { ...valid, GITHUB_SHA: 'a'.repeat(40), GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/main` };
const resolved = await resolveCandidate('.', '', '0.6.4-test.7', buildEnv, async (_, args) => { assert.notEqual(args[0], 'rev-parse'); });
assert.deepEqual(resolved, { commit: 'a'.repeat(40), version: '0.6.4-test.7' });
await assert.rejects(resolveCandidate('.', 'main', '', buildEnv, async () => { throw Error('must not run'); }), /immutable/);
for (const env of [{}, { GITHUB_RUN_NUMBER: '2', GITHUB_RUN_ATTEMPT: '0' }, { GITHUB_RUN_NUMBER: 'bad', GITHUB_RUN_ATTEMPT: '1' }]) {
await assert.rejects(resolveCandidate('.', 'a'.repeat(40), '', { ...buildEnv, ...env }, async () => JSON.stringify({ version: '0.6.3' })), /Positive/);
}
- for (const patch of [{ GITHUB_REF: 'refs/heads/main' }, { GITHUB_REF: 'refs/heads/codex/unreviewed' }, { GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/main` }]) {
+ for (const patch of [{ GITHUB_REF: 'refs/heads/feature/motion' }, { GITHUB_REF: 'refs/heads/codex/unreviewed' }, { GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/feature/motion` }]) {
await assert.rejects(resolveCandidate('.', '', '0.6.4-test.7', { ...buildEnv, ...patch }, async () => { throw Error('Must reject before git'); }));
}
});
@@ -47,7 +55,7 @@ test('candidate CLI numbers the frozen Motion source, not the legacy control che
await git('add', 'package.json');
await git('-c', 'user.name=Fixture', '-c', '[email protected]', '-c', 'commit.gpgsign=false', 'commit', '-qm', 'Motion source');
const commit = (await git('rev-parse', 'HEAD')).trim();
- await git('update-ref', 'refs/remotes/origin/feature/motion', commit);
+ await git('update-ref', 'refs/remotes/origin/main', commit);
await writeFile(path.join(directory, 'package.json'), JSON.stringify({ version: '0.1.0' }));
const output = path.join(directory, 'output'), script = fileURLToPath(new URL('../.github/scripts/motion-release.mjs', import.meta.url));
for (const [source, version, run, attempt, expected] of [
@@ -58,7 +66,7 @@ test('candidate CLI numbers the frozen Motion source, not the legacy control che
]) {
await writeFile(output, '');
await runFile(process.execPath, [script, 'source', directory], { env: { ...process.env, GITHUB_OUTPUT: output,
- ...valid, GITHUB_SHA: commit, GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/feature/motion`,
+ ...valid, GITHUB_SHA: commit, GITHUB_WORKFLOW_REF: `${repository}/${candidateWorkflow}@refs/heads/main`,
MOTION_SOURCE_SHA: source, MOTION_VERSION: version, GITHUB_RUN_ID: '42812345678', GITHUB_RUN_NUMBER: run, GITHUB_RUN_ATTEMPT: attempt } });
assert.equal(await readFile(output, 'utf8'), `source_sha=${commit}\nversion=${expected}\n`);
assert(compareReleaseVersions(expected, '0.6.4-test.6') > 0);
@@ -68,7 +76,7 @@ test('candidate CLI numbers the frozen Motion source, not the legacy control che
test('only a completed successful registered candidate build can supply a version', () => {
validateRun(origin, artifact, '0.6.4-test.99');
- validateRun({ ...origin, head_branch: 'feature/motion' }, artifact, '0.6.4-test.99');
+ validateRun({ ...origin, head_branch: 'feature/motion' }, artifact, '0.6.4-test.99'); // Historical producer runs survive the cutover.
for (const patch of [{ event: 'pull_request' }, { head_branch: 'codex/unreviewed' }, { head_branch: 'legacy' }, { path: '.github/workflows/other.yml' }, { head_repository: { full_name: 'fork/repo' } }, { status: 'in_progress' }, { conclusion: 'failure' }]) assert.throws(() => validateRun({ ...origin, ...patch }, artifact, '0.6.4-test.99'));
for (const patch of [{ expired: true }, { name: 'motion-candidate-0.6.4-test.100' }, { digest: null }, { workflow_run: { id: 999 } }]) assert.throws(() => validateRun(origin, { ...artifact, ...patch }, '0.6.4-test.99'));
});
@@ -90,7 +98,7 @@ test('version lookup uses the exact artifact name and rejects missing, expired,
test('operator authorization records the actual manual caller without independent approval', async t => {
const f = await candidateFixture(t);
- const run = { ...origin, head_branch: 'feature/motion', id: 800, path: publicationWorkflow, actor: { login: 'operator' }, triggering_actor: { login: 'rerunner' } };
+ const run = { ...origin, head_branch: 'main', id: 800, path: publicationWorkflow, actor: { login: 'operator' }, triggering_actor: { login: 'rerunner' } };
assert.equal(authorizationReceipt(f.candidate, run, 'publish-test').actor, 'rerunner');
assert.throws(() => authorizationReceipt(f.candidate, { ...run, actor: {}, triggering_actor: {} }, 'publish-test'));
const fetcher = async url => { assert(String(url).endsWith('/actions/runs/800')); return Response.json(run); };
@@ -98,7 +106,7 @@ test('operator authorization records the actual manual caller without independen
const record = JSON.parse(await readFile(path.join(f.directory, 'authorization.json')));
assert.equal(record.publicationRun, 800); assert.equal(record.tgzSHA256, f.candidate.tgzSHA256);
assert.equal(record.actor, 'rerunner'); assert.equal(record.schemaVersion, 2); assert(!Object.hasOwn(record, 'acceptanceConfirmed'));
- for (const patch of [{ id: 801 }, { event: 'push' }, { head_branch: 'main' }, { head_sha: 'f'.repeat(40) }, { path: candidateWorkflow }, { head_repository: { full_name: 'fork/repo' } }]) {
+ for (const patch of [{ id: 801 }, { event: 'push' }, { head_branch: 'feature/motion' }, { head_sha: 'f'.repeat(40) }, { path: candidateWorkflow }, { head_repository: { full_name: 'fork/repo' } }]) {
await assert.rejects(recordAuthorization(f.directory, f.inputs, async () => Response.json({ ...run, ...patch }), f.env));
}
});
@@ -127,7 +135,7 @@ test('the sealed candidate detects tgz, guide, identity and provenance tampering
await assert.rejects(verifyDownloaded(directory, candidate.tgzSHA256));
});
-for (const branch of ['main', 'feature/motion']) test(`artifact download binds ${branch} provenance and does not forward credentials to signed URLs`, async t => {
+for (const branch of ['main']) test(`artifact download binds ${branch} provenance and does not forward credentials to signed URLs`, async t => {
const f = await candidateFixture(t, branch), zip = path.join(f.work, 'candidate.zip');
const producer = { ...origin, head_branch: branch };
await runFile('zip', ['-j', zip, ...['candidate.json', ...Object.keys(f.candidate.files)].map(name => path.join(f.directory, name))]);
@@ -146,7 +154,7 @@ for (const branch of ['main', 'feature/motion']) test(`artifact download binds $
await assert.rejects(downloadCandidate(f.candidate.version, path.join(f.work, 'retry'), undefined, retryFetcher), /success/);
assert.equal((await downloadCandidate(f.candidate.version, path.join(f.work, 'automatic'), undefined, fetcher)).tgzSHA256, f.candidate.tgzSHA256);
await assert.rejects(downloadCandidate(f.candidate.version, path.join(f.work, 'corrupt'), f.candidate.tgzSHA256, async (url, options) => String(url).includes('signed.') ? new Response('tampered ZIP') : fetcher(url, options)));
- const other = branch === 'main' ? 'feature/motion' : 'main';
+ const other = 'feature/motion';
await assert.rejects(downloadCandidate(f.candidate.version, path.join(f.work, 'wrong-branch'), f.candidate.tgzSHA256,
(url, options) => String(url).endsWith('/actions/runs/123') ? Response.json({ ...producer, head_branch: other }) : fetcher(url, options)));
});
@@ -156,7 +164,21 @@ test('old main receipts remain readable but unregistered candidate branches cann
const { head_branch, ...legacy } = f.provenance;
await writeFile(path.join(f.directory, 'provenance.json'), JSON.stringify(legacy));
assert.equal((await verifyDownloaded(f.directory, f.candidate.tgzSHA256)).workflow.ref, 'refs/heads/main');
- await assert.rejects(candidateFixture(t, 'codex/unreviewed'), /only from main or feature/);
+ await assert.rejects(candidateFixture(t, 'codex/unreviewed'), /only from main/);
+ await assert.rejects(candidateFixture(t, 'feature/motion'), /only from main/);
+});
+
+test('frozen pre-rename candidate receipts remain verifiable without allowing fork identities', async t => {
+ const f = await candidateFixture(t);
+ const candidatePath = path.join(f.directory, 'candidate.json');
+ f.candidate.workflow.repository = 'nexu-io/html-anything';
+ f.candidate.workflow.ref = 'refs/heads/feature/motion';
+ await writeFile(candidatePath, JSON.stringify(f.candidate));
+ await writeFile(path.join(f.directory, 'provenance.json'), JSON.stringify({ ...f.provenance, head_branch: 'feature/motion' }));
+ assert.equal((await verifyDownloaded(f.directory, f.candidate.tgzSHA256)).workflow.repository, 'nexu-io/html-anything');
+ f.candidate.workflow.repository = 'fork/repo';
+ await writeFile(candidatePath, JSON.stringify(f.candidate));
+ await assert.rejects(verifyDownloaded(f.directory, f.candidate.tgzSHA256), /Untrusted candidate repository/);
});
function registry(candidate, exists = true, tag = candidate.version, latest = '0.5.0') {
@@ -274,7 +296,7 @@ test('daily build and publication are separate manual entries without an indepen
assert(build.includes('name: ' + candidateJobName) && build.includes('ref: ${{ steps.source.outputs.source_sha }}'));
for (const entry of [build, workflow, recovery]) {
assert(entry.includes('name: Require Motion integration branch'));
- assert(entry.includes("Select feature/motion in Run workflow"));
+ assert(entry.includes("Select main in Run workflow"));
const guard = entry.split(' - name: Require Motion integration branch\n')[1].split(/\n - |\n [a-z]/)[0];
assert(guard.includes("exit 1"));
}
@@ -305,15 +327,15 @@ test('daily build and publication are separate manual entries without an indepen
assert(recovery.includes('uses: ./.github/workflows/motion-publish-test.yml') && !recovery.includes('source_sha:'));
});
-test('each manual entry accepts only feature/motion before checkout or publication', async () => {
+test('each manual entry accepts only main before checkout or publication', async () => {
for (const name of ['motion-candidate', 'motion-publish-test', 'motion-publication-recovery']) {
const workflow = await readFile(new URL(`../.github/workflows/${name}.yml`, import.meta.url), 'utf8');
const step = workflow.split(' - name: Require Motion integration branch\n')[1].split(/\n - |\n [a-z]/)[0];
const script = step.split(' run: |\n')[1].split('\n').map(line => line.replace(/^ {10}/, '')).join('\n');
const run = ref => runFile('bash', ['-e', '-o', 'pipefail', '-c', script], { env: { ...process.env, GITHUB_REF: ref } });
- await run('refs/heads/feature/motion');
- for (const ref of ['refs/heads/main', 'refs/heads/legacy', 'refs/heads/codex/unreviewed', 'refs/tags/feature/motion']) {
- await assert.rejects(run(ref), /Select feature\/motion/);
+ await run('refs/heads/main');
+ for (const ref of ['refs/heads/feature/motion', 'refs/heads/legacy', 'refs/heads/codex/unreviewed', 'refs/tags/main']) {
+ await assert.rejects(run(ref), /Select main/);
}
}
});
@@ -431,7 +453,7 @@ test('an unexpected npm latest change stops promotion and consumer processes can
test('no-publication rehearsal carries one accepted candidate through npm and storage using simulated services only', async t => {
const f = await candidateFixture(t), store = storage(f.candidate);
- const run = { ...origin, head_branch: 'feature/motion', id: 800, path: publicationWorkflow, actor: { login: 'operator' } };
+ const run = { ...origin, head_branch: 'main', id: 800, path: publicationWorkflow, actor: { login: 'operator' } };
const github = async url => { assert(String(url).endsWith('/actions/runs/800')); return Response.json(run); };
await writeFile(path.join(f.directory, 'authorization.json'), '{}');
let npmWrites = 0, tagWrites = 0, published = false, testTag = '0.6.4-test.1';
diff --git a/tests/source-install.test.ts b/tests/source-install.test.ts
index 2ce0cc91..1420b5fa 100644
--- a/tests/source-install.test.ts
+++ b/tests/source-install.test.ts
@@ -28,7 +28,7 @@ test('public Motion sources contain no company endpoints, workstation paths or e
}
});
-test('source installation clones the standalone Motion feature branch and invokes its installer', { skip: process.platform === 'win32' }, async () => {
+for (const ref of [undefined, 'migration-review']) test(`source installation clones openmotion ${ref || 'main by default'} and invokes its installer`, { skip: process.platform === 'win32' }, async () => {
const directory = await mkdtemp(path.join(tmpdir(), 'motion source install '));
try {
const bin = path.join(directory, 'bin'), log = path.join(directory, 'git.jsonl');
@@ -48,12 +48,12 @@ if (args[0] === 'clone') {
const destination = path.join(directory, 'selected install');
const result = spawnSync('bash', [fileURLToPath(new URL('../install.sh', import.meta.url))], {
encoding: 'utf8', env: { ...process.env, PATH: bin + path.delimiter + process.env.PATH,
- MOTION_GIT_LOG: log, OPENMOTION_INSTALL_DIR: destination, OPENMOTION_REF: 'migration-review' },
+ MOTION_GIT_LOG: log, OPENMOTION_INSTALL_DIR: destination, OPENMOTION_REF: ref },
});
assert.equal(result.status, 0, result.stderr);
assert.match(result.stdout, /nested-motion-installer/);
const calls = (await readFile(log, 'utf8')).trim().split('\n').map(line => JSON.parse(line));
- assert.deepEqual(calls[0], ['clone', '--depth', '1', '--branch', 'migration-review', '--', 'https://github.com/nexu-io/html-anything.git', destination]);
+ assert.deepEqual(calls[0], ['clone', '--depth', '1', '--branch', ref || 'main', '--', 'https://github.com/nexu-io/openmotion.git', destination]);
assert.equal(calls.length, 1);
} finally { await rm(directory, { recursive: true, force: true }); }
});
diff --git a/tests/stable-release.test.mjs b/tests/stable-release.test.mjs
index a11c7af4..fc48891b 100644
--- a/tests/stable-release.test.mjs
+++ b/tests/stable-release.test.mjs
@@ -33,7 +33,7 @@ function services(f) {
}
test('stable selection is explicit and rejects prerelease/prod or stable/DEV channel mismatches', async t => {
- const f = await candidateFixture(t, 'feature/motion', { version: '0.6.4' });
+ const f = await candidateFixture(t, 'main', { version: '0.6.4' });
assert.equal(releaseInputs(f.env).channel, 'stable');
for (const patch of [{ MOTION_RELEASE_CHANNEL: 'test' }, { MOTION_VERSION: '0.6.4-test.9' }, { MOTION_RELEASE_ACTION: 'publish-test' }]) assert.throws(() => releaseInputs({ ...f.env, ...patch }));
await assert.rejects(resolveCandidate('.', '', '', { ...f.env, GITHUB_WORKFLOW_REF: f.env.GITHUB_WORKFLOW_REF.replace('motion-publish-test', 'motion-candidate') }, async () => {}), /exact stable version/);
@@ -49,7 +49,7 @@ test('stable selection is explicit and rejects prerelease/prod or stable/DEV cha
});
test('stable stage, native acceptance, latest and exact/prod guides use the same immutable bytes', async t => {
- const f = await candidateFixture(t, 'feature/motion', { version: '0.6.4' }), store = services(f);
+ const f = await candidateFixture(t, 'main', { version: '0.6.4' }), store = services(f);
await publishNpm(f.directory, f.inputs, store);
assert.equal(store.getLatest(), '0.5.0');
const native = path.join(f.directory, 'registry-win32-x64.json'), original = await readFile(native, 'utf8');
@@ -73,7 +73,7 @@ test('stable stage, native acceptance, latest and exact/prod guides use the same
});
test('stable recovery never publishes, changes tags or touches the moving guide; newer latest is preserved', async t => {
- const f = await candidateFixture(t, 'feature/motion', { version: '0.6.4' }), store = services(f);
+ const f = await candidateFixture(t, 'main', { version: '0.6.4' }), store = services(f);
await publishNpm(f.directory, f.inputs, store);
store.setLatest('0.7.0');
assert.equal((await promoteStable(f.directory, f.inputs, store)).status, 'superseded');