Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
docs: revert the key-files median note to fit the 60,000-byte cap (the fact stays in docs/TESTING.md)
garrytane70a8a8d2373
diff --git a/docs/architecture/key-files/tooling-and-tests.md b/docs/architecture/key-files/tooling-and-tests.mdindex 3e59f4eb02..b33fe2c457 100644--- a/docs/architecture/key-files/tooling-and-tests.md+++ b/docs/architecture/key-files/tooling-and-tests.md@@ -80,7 +80,7 @@ Current behavior and load-bearing invariants; history belongs in Git and CHANGEL- `scripts/select-e2e.ts` + `scripts/ci-changed-files.sh` + `scripts/ci-doc-checks.sh` — E2E selection. `select-e2e.ts` classifies the changed files (git: committed `origin/master...HEAD`, working tree and untracked-unignored files; or `--changed-files <path|->`) as EMPTY / DOC_ONLY / SRC: DOC_ONLY (root `*.md`, `docs/`, LICENSE, VERSION) selects nothing, everything else selects every `test/e2e/*.test.ts` and prints "E2E narrowing is retired" (a diff map selected all files on 40 of 40 merged PRs). `ci-changed-files.sh` lists a PR's or merge-group entry's files from the GitHub API for `prepare-e2e` and exits 1 on a capped (3000 PR / 300 compare), short or failed list or with no PR context, so the workflow falls back to the whole corpus. `ci-doc-checks.sh` is the doc-only gate `ci:local:diff` and `ci:ubicloud:diff` run (llms freshness, `check:doc-history`, `test/docs-repo-paths.test.ts`, skill refs, privacy guards). Tests: `test/select-e2e.test.ts`, `test/scripts/e2e-wiring.test.ts`, `test/scripts/ci-local-rendering.test.ts`.-- `scripts/sharding.ts` + `scripts/mine-shard-weights.ts` + `scripts/capture-test-log.ts` — deterministic weighted partitioning and timing refresh. CLI takes lane-specific weights; missing entries use p75, equal loads prefer fewer files then shard index, and serial may explicitly opt into warning/fallback on bad advisory weights. `UNIT_SHARDS` sizes both unit matrices under `UNIT_SHARD_BUDGET_MS` (`test/scripts/unit-shard-budget.test.ts`); test.yml runs `UNIT_SHARDS_PER_JOB` per runner via `scripts/test-shard-pack.sh` (job `test (N, M)`, artifacts per shard). `--sum` prints a shard's predicted weight (test-shard.sh logs it with nproc, load, steal, CPU model: slow draw or slow tests). `weights:mine --lane unit|serial|e2e` validates complete lane logs before replacing and records run/commit/unit metadata; repeated `--run` (unit/serial) takes each file's median. A GitHub refresh reads one job at a time (gh refuses a whole-run `--log` above its job cap): unit from each shard's `timings-unit-N` capture artifact, which must record one capture start and a final `complete exit=0`; serial from `gh run view --job <id> --log`. E2E defaults to merging selected-job observations; explicit `--e2e-profile full --run ID` requires a successful source-matched run, pins its attempt/job IDs, resolves basename headers against committed default discovery including the outside-directory parity entry, and replaces the map only after exact disjoint corpus validation. Metadata retains log/corpus hashes; file/stdin sources cannot claim full-profile provenance. Capture keeps stdout/stderr, records timestamped GitHub-format artifacts, forwards cancellation to its process group and marks failed runs unmineable. A failed Actions run appends its last 50 failures to the step summary: file, test, backend arm, first error block and a reproduction command (or the last log lines when no `(fail)` line printed). Unit and E2E artifacts keep 14 days. `scripts/check-weight-coverage.ts` (`check:weight-coverage`, in verify) fails on a unit/serial/E2E/Ubicloud weight naming a missing file and on an unweighted lane share above 5% (unit) or 10% (serial, E2E) only when `GITHUB_EVENT_NAME=schedule`; else the share warns (stdout + step summary) with the lane's miner command. Tests: `test/scripts/check-weight-coverage.test.ts` plus guard self-test fixtures.+- `scripts/sharding.ts` + `scripts/mine-shard-weights.ts` + `scripts/capture-test-log.ts` — deterministic weighted partitioning and timing refresh. CLI takes lane-specific weights; missing entries use p75, equal loads prefer fewer files then shard index, and serial may explicitly opt into warning/fallback on bad advisory weights. `UNIT_SHARDS` sizes both unit matrices under `UNIT_SHARD_BUDGET_MS` (`test/scripts/unit-shard-budget.test.ts`); test.yml runs `UNIT_SHARDS_PER_JOB` per runner via `scripts/test-shard-pack.sh` (job `test (N, M)`, artifacts per shard). `--sum` prints a shard's predicted weight (test-shard.sh logs it with nproc, load, steal, CPU model: slow draw or slow tests). `weights:mine --lane unit|serial|e2e` validates complete lane logs before replacing and records run/commit/unit metadata. A GitHub refresh reads one job at a time (gh refuses a whole-run `--log` above its job cap): unit from each shard's `timings-unit-N` capture artifact, which must record one capture start and a final `complete exit=0`; serial from `gh run view --job <id> --log`. E2E defaults to merging selected-job observations; explicit `--e2e-profile full --run ID` requires a successful source-matched run, pins its attempt/job IDs, resolves basename headers against committed default discovery including the outside-directory parity entry, and replaces the map only after exact disjoint corpus validation. Metadata retains log/corpus hashes; file/stdin sources cannot claim full-profile provenance. Capture keeps stdout/stderr, records timestamped GitHub-format artifacts, forwards cancellation to its process group and marks failed runs unmineable. A failed Actions run appends its last 50 failures to the step summary: file, test, backend arm, first error block and a reproduction command (or the last log lines when no `(fail)` line printed). Unit and E2E artifacts keep 14 days. `scripts/check-weight-coverage.ts` (`check:weight-coverage`, in verify) fails on a unit/serial/E2E/Ubicloud weight naming a missing file and on an unweighted lane share above 5% (unit) or 10% (serial, E2E) only when `GITHUB_EVENT_NAME=schedule`; else the share warns (stdout + step summary) with the lane's miner command. Tests: `test/scripts/check-weight-coverage.test.ts` plus guard self-test fixtures.- `test/e2e/codex-plugin-install-real.serial.test.ts` + `test/e2e/claude-plugin-install-real.serial.test.ts` — the plugin doors: clean-tree staging (`git archive HEAD`), real marketplace add/plugin add, snapshot + exec-bit + non-root-mcp.json pins, tools/list starter-surface oracle, cold-home fast-fail, --source-guard block/allow, coexistence + removal probes, auth-gated SMOKE turns. CI: the `plugin-doors` job in heavy-tests.yml (pinned binary provisioning + expected-pass-count refuse-green).