Docs+handbook

2026-04-03 03:12:44 -04:00
parent d794c87b32
commit 7435f4b353
16 changed files with 1044 additions and 33 deletions
@@ -0,0 +1,23 @@
+# scripts
+
+Small **monorepo-level** helpers used by npm scripts and maintainers.
+
+## `ensure-pear-node-modules.mjs`
+
+**Usage:** `node scripts/ensure-pear-node-modules.mjs packages/<app>`
+
+Recreates `packages/<app>/node_modules` by symlinking **each top-level package** from the **repo root** `node_modules` (matching npm’s flat hoist). Pear’s dev bundle often does not resolve a single nested `node_modules` tree correctly; this makes `pear run --dev .` reliable after `npm ci` at the root.
+
+Invoked automatically by:
+
+- Root `npm run os:seeder` / `npm run os:booter`
+- Package `start` / `dev` / `pear:dev` scripts where configured
+
+## `stage-release.sh`
+
+Maintainer helper for release/staging workflows (see script header for intended use).
+
+## See also
+
+- Root [README.md](../README.md) — Pear + workspaces note
+- [Handbook — Building and releasing](../handbook/07-operations-and-development.md)