mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-16 19:11:46 +00:00
dd5928711a
* feat(ui): fold Skills and Skill Workshop into a Plugins hub One sidebar entry (Plugins) now covers plugins, skills, and skill-workshop routes via a shared hub tab strip (Installed / Discover / Skills / Workshop). Routes and URLs are unchanged; /settings/plugins gains ?tab= deep links and the sidebar highlights Plugins for all hub routes. Also latches Skill Workshop proposal loading so updated() no longer re-kicks loads while one is pending or after one fails - the early-return finally used to spin the page at 100% CPU whenever skills.proposals.list stalled. * feat(mock): plugin catalog and skill-workshop fixtures for the mock harness * docs(web): describe the Plugins hub tabs in the Control UI guide * test(ui): backfill initialTab in plugins route-data fixtures * fix(ui): review fixes for the plugins hub - plugins route declares loaderDeps on the ?tab= param so query-only navigation and back/forward re-run the loader instead of reusing the cached match with the previous tab - catalog tab clicks navigate so the URL and history stay in sync with the documented ?tab=discover deep link (local switch stays instant) - skill-workshop error banner gains a Try again button so a transient proposals-list failure is recoverable without remounting the route * fix(ui): restore the Installed tab on bare plugins URLs in history navigation * fix(ui): manual-activation hub tablist with cross-route focus hand-off Arrow keys only move focus now; activation stays on click/Enter so arrowing can never unmount the strip under the user's focus. Keyboard activation of a cross-route tab hands focus to the destination strip's active tab, and the hub-route set uses a Set per lint. * fix(ui): defer hub-tab focus reclaim until the strip is connected * fix(ui): skip focus recovery for same-tab hub activation * docs(css): note the hub-panel flex ownership for the workshop board * fix(ui): adapt hub test to retired Overview route * chore(i18n): sync locale bundles for the plugins hub keys * docs(map): regenerate for the plugins hub section
summary, read_when, title
| summary | read_when | title | |||
|---|---|---|---|---|---|
| Repository script entry points and compatibility notes |
|
Scripts Directory |
Scripts Directory
The scripts/ directory contains repository tooling used by local development,
CI, docs publishing, releases, Docker proof, and maintainer operations. Prefer
the package-script entry points in package.json when one exists, then read the
underlying script before running it directly.
Compatibility
Many scripts are stable paths referenced by package.json, GitHub Actions,
docs, and maintainer runbooks. Do not move, rename, or regroup scripts only to
improve taxonomy. A directory migration needs an explicit maintainer-approved
compatibility plan for package scripts, workflows, docs snippets, and any raw
script paths users may have copied.
This index is a discovery aid for the current flat layout. It does not define a new directory taxonomy.
Common Entry Points
| Area | Prefer | Notes |
|---|---|---|
| Build | pnpm build |
Runs scripts/build-all.mjs; use specific build scripts only when debugging a build stage. |
| Changed checks | pnpm changed:lanes --json, pnpm check:changed |
Lane classification lives in scripts/changed-lanes.mjs; changed-file checks live in scripts/check-changed.mjs. |
| Docs | pnpm docs:list, pnpm docs:check-mdx, pnpm docs:check-links |
Backed by scripts/docs-list.js, scripts/check-docs-mdx.mjs, and scripts/docs-link-audit.mjs. |
| Formatting docs | pnpm format:docs:check |
Uses scripts/format-docs.mjs; use write mode only when intentionally formatting docs. |
| Lint | pnpm lint, pnpm lint:core, pnpm lint:all |
Wrapper scripts keep oxlint behavior aligned with repo config. |
| Targeted tests | pnpm test <path-or-filter> or node scripts/run-vitest.mjs <path-or-filter> |
Avoid bare vitest; it can start watch mode. |
| Changed tests | pnpm test:changed |
Uses the repo's changed-test resolver instead of a broad Vitest run. |
| Docker proof | pnpm test:docker:all, pnpm test:docker:rerun, pnpm test:docker:timings |
Use the planner/rerun helpers before launching broad Docker work. |
| Live proof | pnpm test:live |
Live checks require the matching environment and credentials. |
| Release checks | pnpm release:check, pnpm release:beta, pnpm release:candidate |
Release scripts are maintainer workflows; read release docs before use. |
| GitHub reads | scripts/gh-read |
Uses a GitHub App read token when configured, leaving normal gh login for writes. |
| Commits | scripts/committer "<message>" <files...> |
Preferred scoped commit helper for OpenClaw changes. |
| Remote proof | node scripts/crabbox-wrapper.mjs ... |
Agent default for tests and heavy work; pre-warm by source trust, sync each run, reuse the lease. |
Script Families
check-*.mjs/check-*.ts: guardrails for architecture, docs, package contents, boundaries, workflows, and generated artifacts.run-*.mjs: wrappers around repo runtimes or tools, such as Node, Vitest, oxlint, tsgo, and environment setup.test-*.mjs/test-*.sh/test-*.ts: test planners, Docker lanes, live checks, and focused validation helpers.docs-*andcheck-docs-*: docs listing, link auditing, MDX checks, spellcheck, sync, and i18n glossary checks.release-*,openclaw-npm-*, andplugin-*-release-*: release preparation, package verification, and publishing helpers.docker-*,test-docker-*, andtest-live-*-docker.sh: Docker E2E planning, rerun, timing, and live/package lane helpers.gh-read*,label-*,sync-labels.ts, and PR helpers: GitHub read, labeling, and maintainer workflow support.generate-*,write-*,copy-*, andsync-*: generated docs, metadata, package surfaces, and build artifact support.lib/: shared helpers imported by script entry points.
Maintenance Rules
- Read
scripts/AGENTS.mdbefore changing scripts. - Keep package scripts, generators, generated-artifact checks, docs references, and workflow references aligned when touching a script path.
- Prefer existing wrappers instead of introducing a raw tool invocation.
- Add or update focused tests under
test/scripts/when changing script behavior.
See also Scripts for public-facing script guidance.