Promote develop → main (170 commits, 2026-07-04 evening wave)

.github/issue-evidence/12259-bun-lockfile-guard.md

@@ -0,0 +1,40 @@
+# Issue #12259 - Bun lockfile version guard
+
+PR scope:
+
+- `packages/scripts/run-turbo.mjs` now parses `bun.lock` before spawning
+  Turbo and fails loudly when `lockfileVersion` exceeds the version supported by
+  the pinned Turbo parser.
+- The old Bun lockfile warning filter was removed; Turbo output now passes
+  through directly instead of hiding lockfile parser warnings.
+- `packages/scripts/run-turbo.self-test.mjs` proves a synthetic
+  `lockfileVersion: 1` passes and `lockfileVersion: 2` fails with the Turbo/Bun
+  compatibility pointer.
+
+Local verification on 2026-07-04:
+
+```bash
+node --check packages/scripts/run-turbo.mjs
+node --check packages/scripts/run-turbo.self-test.mjs
+node packages/scripts/run-turbo.self-test.mjs
+# run-turbo self-test passed
+
+RUN_TURBO_LOCKFILE_CHECK_ONLY=1 \
+  node packages/scripts/run-turbo.mjs run build --dry=json
+
+git diff --check
+```
+
+Attempted full Turbo dry run:
+
+```bash
+node packages/scripts/run-turbo.mjs run build --dry=json \
+  --filter=__run_turbo_lockfile_no_match__
+```
+
+Result: not run in this auxiliary worktree because no ancestor
+`node_modules/turbo` exists. The wrapper failed before Turbo spawn with the
+expected "Unable to find turbo" message. The lockfile guard path itself was
+verified with `RUN_TURBO_LOCKFILE_CHECK_ONLY=1`.
+
+Screenshots/recordings: N/A, CLI guard only; no UI changed.

.github/issue-evidence/12259-electrobun-build-graph.md

@@ -0,0 +1,30 @@
+# Issue #12259 - Electrobun builds inside the Turbo graph
+
+## Change
+
+- Removed the root build script's `!@elizaos/electrobun` Turbo filter.
+- Removed the appended `bun run --cwd packages/app-core/platforms/electrobun build` tail step.
+- Left `bun run check:view-bundles` as the root build tail gate.
+
+The existing `@elizaos/electrobun#build` Turbo task has `dependsOn: ["@elizaos/app#build", "^build"]`, `cache: false`, and `outputs: []`, so Electrobun keeps its build ordering while running inside the graph.
+
+## Verification
+
+Run on 2026-07-04:
+
+- Static root script assertion:
+  - root `build` no longer contains `!@elizaos/electrobun`
+  - root `build` no longer contains `--cwd packages/app-core/platforms/electrobun build`
+  - root `build` still contains `bun run check:view-bundles`
+- Turbo dry run:
+  - `node packages/scripts/run-turbo.mjs run build --concurrency=8 --filter='!./packages/examples/**' --filter='!./packages/benchmarks/**' --cache=local:rw,remote:r --output-logs=errors-only --dry=json`
+  - Confirmed the task set contains `@elizaos/electrobun#build`.
+  - Confirmed `@elizaos/electrobun#build` depends on `@elizaos/app#build`.
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+The Turbo dry run used a temporary `node_modules` symlink to the main checkout because the auxiliary worktree does not have a local install.
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/Turbo build-graph change with no user interface.

.github/issue-evidence/12259-examples-benchmarks-list-mode.md

@@ -0,0 +1,33 @@
+# Issue #12259 - examples/benchmarks side-runner list mode
+
+## Change
+
+- Added `--list` and `--list=json` to `packages/scripts/run-examples-benchmarks.mjs`.
+- Added `packages/scripts/run-examples-benchmarks.self-test.mjs` to prove list mode honors workspace membership, examples/benchmarks scope, workspace negations, and target script presence without running package scripts.
+
+## Verification
+
+Run on 2026-07-04:
+
+- `node --check packages/scripts/run-examples-benchmarks.mjs`
+- `node --check packages/scripts/run-examples-benchmarks.self-test.mjs`
+- `node packages/scripts/run-examples-benchmarks.self-test.mjs`
+- `node packages/scripts/run-examples-benchmarks.mjs lint --list=json`
+- `node packages/scripts/run-examples-benchmarks.mjs typecheck --list=json`
+
+Real repo list counts:
+
+- `lint`: 47 examples/benchmarks packages
+- `typecheck`: 53 examples/benchmarks packages
+
+Dry-run comparison using `node packages/scripts/run-turbo.mjs ... --dry=json` with a temporary `node_modules` symlink:
+
+- `lint`: side-runner 47, Turbo 254, missing from Turbo 0
+- `typecheck`: side-runner 53, Turbo 253, missing from Turbo 1
+- Missing typecheck package: `@elizaos/example-code`
+
+That missing typecheck package is caused by the current root `typecheck` body excluding `@elizaos/example-code` from the Turbo run while the side-runner still includes it. The follow-up side-runner deletion must handle this package before removing the side-runner.
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/script introspection change with no user interface.

.github/issue-evidence/12259-lint-no-build-deps.md

@@ -0,0 +1,31 @@
+# Issue #12259 - Lint tasks no longer force builds
+
+PR scope:
+
+- Removed generic `dependsOn` build prerequisites from the `lint` Turbo task.
+- Removed the same generic build prerequisites from the `lint:check` Turbo
+  task.
+- Left `typecheck` build prerequisites unchanged.
+
+Local verification on 2026-07-04:
+
+```bash
+node -e "const fs=require('fs'); const t=JSON.parse(fs.readFileSync('turbo.json','utf8')).tasks; if ('dependsOn' in t.lint || 'dependsOn' in t['lint:check']) process.exit(1); if (!Array.isArray(t.typecheck.dependsOn)) process.exit(1);"
+
+node -e "JSON.parse(require('fs').readFileSync('turbo.json','utf8'));"
+
+git diff --check origin/develop..HEAD
+```
+
+Turbo dry-run:
+
+```bash
+ln -s /Users/shawwalters/eliza/node_modules node_modules
+node packages/scripts/run-turbo.mjs run lint:check --dry=json --filter=./packages/core
+rm node_modules
+```
+
+The dry-run completed and emitted a `lint:check` plan without any build task
+dependency injected by the generic lint task.
+
+Screenshots/recordings: N/A, Turbo config only; no UI changed.

.github/issue-evidence/12259-phantom-turbo-overrides.md

@@ -0,0 +1,32 @@
+# Issue #12259 - phantom Turbo override guard
+
+## Change
+
+- Extended `packages/scripts/audit-turbo-build-deps.mjs` to fail on any `pkg#task` override whose owner package is missing or does not define that script.
+- Extended the dependency-edge audit to scan named `#build` dependencies from all `pkg#task` overrides, including `#typecheck` overrides.
+- Removed 22 dead named `#build` edges from typecheck overrides in `turbo.json`.
+- Added `packages/scripts/audit-turbo-build-deps.self-test.mjs` with a synthetic workspace that fails on missing owner scripts/packages and passes after fixing the fixture.
+
+## Verification
+
+Run on 2026-07-04:
+
+- `node --check packages/scripts/audit-turbo-build-deps.mjs`
+- `node --check packages/scripts/audit-turbo-build-deps.self-test.mjs`
+- `node packages/scripts/audit-turbo-build-deps.self-test.mjs`
+- `node packages/scripts/audit-turbo-build-deps.mjs`
+- `node -e "JSON.parse(require('fs').readFileSync('turbo.json','utf8'));"`
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+Real audit result:
+
+- No phantom `#build` dependency edges.
+- No phantom `pkg#task` overrides.
+- Residual non-failing output:
+  - 3 undeclared dependency-edge warnings.
+  - 9 redundant override info entries.
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/Turbo auditor and config cleanup with no user interface.

.github/issue-evidence/12259-remove-examples-benchmarks-side-runner.md

@@ -0,0 +1,28 @@
+# Issue #12259 - remove examples/benchmarks side-runner
+
+## Change
+
+- Removed the serial `run-examples-benchmarks.mjs` tail from root `lint` and `typecheck`.
+- Removed the `lint-test-integrity` tail from root `lint`; root `lint` is now exactly the Turbo lint task.
+- Removed the `!@elizaos/example-code` exclusion from root `typecheck` so the Turbo typecheck fan-out preserves coverage for the package that the side-runner previously covered.
+- Deleted `packages/scripts/run-examples-benchmarks.mjs` and its self-test.
+
+## Verification
+
+Run on 2026-07-04:
+
+- Static root script assertion:
+  - `lint` is `node packages/scripts/run-turbo.mjs run lint`
+  - `typecheck` is `NODE_OPTIONS='--max-old-space-size=8192' node packages/scripts/run-turbo.mjs run typecheck --concurrency=8`
+- Side-runner package-set comparison against Turbo dry runs:
+  - `lint`: side-runner 47, Turbo 254, missing from Turbo 0
+  - `typecheck`: side-runner 53, Turbo 254, missing from Turbo 0
+- `git grep -n "run-examples-benchmarks" -- package.json packages scripts turbo.json .github/workflows docs` returned no references.
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+The Turbo dry runs used a temporary `node_modules` symlink to the main checkout because the auxiliary worktree does not have a local install.
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/Turbo script cleanup with no user interface.

.github/issue-evidence/12259-test-core-orchestrator.md

@@ -0,0 +1,29 @@
+# Issue #12259 - test:core uses the test orchestrator
+
+## Change
+
+- Removed the root `turbo.json` `test` task so root test lanes are not routed through a generic Turbo package graph.
+- Rewired root `test:core` from `run-turbo.mjs run test --filter=./packages/core` to `run-all-tests.mjs --only=test --no-cloud --filter='@elizaos/core \\(packages/core\\)#test'`.
+
+## Verification
+
+Run on 2026-07-04:
+
+- `node -e "const fs=require('fs'); const t=JSON.parse(fs.readFileSync('turbo.json','utf8')).tasks; if ('test' in t) process.exit(1);"`
+- `node -e "const fs=require('fs'); const pkg=JSON.parse(fs.readFileSync('package.json','utf8')); if (!pkg.scripts['test:core'].includes('run-all-tests.mjs') || pkg.scripts['test:core'].includes('run-turbo.mjs')) process.exit(1);"`
+- `node packages/scripts/run-all-tests.mjs --only=test --no-cloud --filter='@elizaos/core \\(packages/core\\)#test' --plan=json`
+- `git diff --check origin/develop..HEAD`
+
+The plan output selected exactly one task:
+
+- `@elizaos/core (packages/core)#test`
+
+Attempted full runtime verification:
+
+- `bun run test:core`
+
+That command reached `@elizaos/core (packages/core)#test`, then failed because the auxiliary worktree did not have a local install and the temporary shared `node_modules` symlink did not contain `vitest/vitest.mjs`. A fresh monorepo install was not attempted because the machine had about 7.8 GiB free at the time of verification.
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/Turbo configuration change with no user interface.

.github/issue-evidence/12259-turbo-persistent-cache.md

@@ -0,0 +1,19 @@
+# Issue #12259 - Persistent Turbo tasks are uncached
+
+PR scope:
+
+- `turbo.json` now marks both persistent generic tasks, `dev` and `start`, with
+  `cache: false`.
+- No other Turbo pipeline behavior is changed in this slice.
+
+Local verification on 2026-07-04:
+
+```bash
+node -e "const fs=require('fs'); const t=JSON.parse(fs.readFileSync('turbo.json','utf8')).tasks; if (t.dev.cache !== false || t.start.cache !== false) process.exit(1);"
+
+node -e "JSON.parse(require('fs').readFileSync('turbo.json','utf8'));"
+
+git diff --check origin/develop..HEAD
+```
+
+Screenshots/recordings: N/A, Turbo config only; no UI changed.

.github/issue-evidence/12262-clean-reset-split.md

@@ -0,0 +1,22 @@
+# Issue #12262 - clean/reset split
+
+## Change
+
+- Split root `clean` so it only runs Turbo clean plus local path removal.
+- Added root `reset` for the old clean + install + build workflow.
+- Updated root `CLAUDE.md` and `AGENTS.md` command docs.
+- Added `reset` to the script-audit exact allowlist.
+
+## Verification
+
+Run on 2026-07-04:
+
+- `node -e "const fs=require('fs'); const p=JSON.parse(fs.readFileSync('package.json','utf8')); if (p.scripts.clean.includes('bun install') || p.scripts.clean.includes('bun run build')) throw new Error(p.scripts.clean); if (p.scripts.reset !== 'bun run clean && bun install && bun run build') throw new Error(p.scripts.reset); if (Object.keys(p.scripts).length !== 213) throw new Error(String(Object.keys(p.scripts).length));"`
+- `node scripts/assert-agents-claude-identical.mjs`
+- `node packages/scripts/audit-scripts.mjs`
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/docs script-surface change with no user interface.

.github/issue-evidence/12262-cloud-turbo-scripts.md

@@ -0,0 +1,28 @@
+# Issue #12262 - cloud scripts folded into Turbo
+
+## Change
+
+- Replaced serial root `typecheck:cloud` package wrappers with a Turbo-filtered typecheck command.
+- Replaced root `verify:cloud` with a Turbo-filtered `lint:check typecheck` command.
+
+## Verification
+
+Run on 2026-07-04:
+
+- Static root script assertion:
+  - `typecheck:cloud` is `node packages/scripts/run-turbo.mjs run typecheck --filter='./packages/cloud/**'`
+  - `verify:cloud` is `node packages/scripts/run-turbo.mjs run lint:check typecheck --filter='./packages/cloud/**'`
+- Turbo dry runs with a temporary `node_modules` symlink:
+  - `node packages/scripts/run-turbo.mjs run typecheck --filter='./packages/cloud/**' --dry=json`
+  - `node packages/scripts/run-turbo.mjs run lint --filter='./packages/cloud/**' --dry=json`
+  - `node packages/scripts/run-turbo.mjs run lint:check --filter='./packages/cloud/**' --dry=json`
+- Dry-run task counts:
+  - `typecheck`: 77 total tasks including dependency builds
+  - `lint`: 14 cloud lint tasks
+  - `lint:check`: 14 cloud lint-check tasks
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/Turbo script-surface change with no user interface.

.github/issue-evidence/12262-delete-duplicate-root-aliases.md

@@ -0,0 +1,26 @@
+# Issue #12262 - delete duplicate root aliases
+
+## Change
+
+- Removed root `test:ci`; use `bun run test`.
+- Removed root `lint:all`; use `bun run verify`.
+- Removed root `build:typescript`; use `node packages/scripts/run-turbo.mjs run build`.
+- Added a root `CLAUDE.md` / `AGENTS.md` migration table.
+- Removed `lint:all` from the script-audit exact allowlist.
+
+## Verification
+
+Run on 2026-07-04:
+
+- Static root script assertion confirmed `test:ci`, `lint:all`, and `build:typescript` are absent.
+- Reference sweep:
+  - `git grep -n "test:ci\\|lint:all\\|build:typescript" -- . ':!package.json' ':!.github/issue-evidence'`
+  - No blocking root alias references. The remaining `build:typescript` reference is package-local under `packages/prompts`, invoked with `--cwd` by `packages/app-core/scripts/setup-upstreams.mjs`.
+- `node scripts/assert-agents-claude-identical.mjs`
+- `node packages/scripts/audit-scripts.mjs`
+- `git diff --check`
+- `git diff --check origin/develop..HEAD`
+
+## Evidence notes
+
+Screenshots and recordings are N/A: this is a root CLI/docs script-surface change with no user interface.

.github/issue-evidence/12262-guard-root-cwd-wrappers.md

@@ -0,0 +1,28 @@
+# Evidence: #12262 guard root cwd wrappers
+
+Date: 2026-07-04
+
+## Change
+
+- Added a root script audit check for exact `bun run --cwd <dir> <script>` wrappers.
+- Kept intentional product/CI root entrypoints in an explicit allowlist with written reasons.
+- Added self-test coverage proving an unallowlisted wrapper fails and an allowlisted wrapper passes.
+
+Screenshots/recordings: N/A. This is a script-audit guard change with no UI behavior change.
+
+## Verification
+
+```bash
+node packages/scripts/audit-scripts.self-test.mjs
+# audit-scripts self-test passed
+```
+
+```bash
+node packages/scripts/audit-scripts.mjs
+# [audit-scripts] OK - no orphan/no-op/broken scripts.
+```
+
+```bash
+git diff --check
+# no output
+```