agentleFS
BlackBeltTechnologyBlackBeltTechnology/pi-agent-dashboard/scripts/AGENTS.md

pi-agent-dashboard / scripts

AGENTS.md349 starsChanged 23 days agoMITView on GitHub

Files in this directory. One row per file. Non-source area (migrated from docs/file-index-skills-misc.md; source of truth now here). See change: migrate-file-index-to-agents-tree.

  • Deletes or force-pushes
  • Installs packages

The file

Files
AGENTS.md

DOX — scripts

Files in this directory. One row per file. Non-source area (migrated from docs/file-index-skills-misc.md; source of truth now here). See change: migrate-file-index-to-agents-tree.

FilePurpose
__tests__/anti-slop-suite-contract.test.mjsStatic L1 contract over packages/anti-slop skill suite + dashboard adapter. → see __tests__/anti-slop-suite-contract.test.mjs.AGENTS.md
__tests__/assert-bundled-plugins-complete.test.mjsVitest unit tests for packages/electron/scripts/assert-bun… → see __tests__/assert-bundled-plugins-complete.test.mjs.AGENTS.md
__tests__/assert-bundled-server-plugin-load.test.mjsTests for the bundled-server plugin-load gate:
__tests__/build-runtime-canary.test.mjsBuilds canary + variants via SDK preset; artifact shape (#E95). → see build-runtime-canary.mjs.AGENTS.md
__tests__/check-kb-dist-fresh.test.mjsC1 (fix-kb-eval-measurement-integrity): fault-injection vi… → see __tests__/check-kb-dist-fresh.test.mjs.AGENTS.md
__tests__/check-mockups.test.mjs→ __tests__/check-mockups.test.mjs.AGENTS.md
__tests__/check-pi-settings-paths.test.mjsDrives absoluteSourceViolations directly (12 cases) so de… → see __tests__/check-pi-settings-paths.test.mjs.AGENTS.md
__tests__/check-plugin-boundary.test.mjscheck-plugin-boundary.mjs via CLI on tmp packages/* trees (test-plan #E1–#E8) + r… → see __tests__/check-plugin-boundary.test.mjs.AGENTS.md
__tests__/client-sinks.test.mjscheck-client-sinks.mjs tests. See change: harden-client-sinks.
__tests__/discord-release-announce.test.mjs→ see __tests__/discord-release-announce.test.mjs.AGENTS.md
__tests__/e2e-canary-seed.test.mjs→ see __tests__/e2e-canary-seed.test.mjs.AGENTS.md
__tests__/encoded-cwd-oneliner.test.mjs#E10 shell one-liner = encodeFolderPath. See change: add-session-ui-deep-links-for-agents.
__tests__/host-api-surface.test.mjsBump-rule table for host-api-surface.mjs (#E29), committed snapshot is current, accent-token expansion, unexpanded …
__tests__/biome-undeclared-dependencies.test.mjsGuardrails for the noUndeclaredDependencies config in biome.json. → see __tests__/biome-undeclared-dependencies.test.mjs.AGENTS.md
__tests__/claude-plugin-ensure-dashboard.test.mjsBehaviour tests for ensure-dashboard.sh (test-plan E3–E34, P1, X1–X10):
__tests__/claude-plugin-publish-contract.test.mjsStatic contract over publish.yml. publish preflight re… → see __tests__/claude-plugin-publish-contract.test.mjs.AGENTS.md
__tests__/claude-plugin-parity.test.mjs→ see __tests__/claude-plugin-parity.test.mjs.AGENTS.md
__tests__/claude-plugin-structure.test.mjs→ see __tests__/claude-plugin-structure.test.mjs.AGENTS.md
__tests__/claude-plugin-version.test.mjsplugin.json = root version (E40), sync-versions.js stamping idempotent (E41), release-cut stages + verifies it (E42).
__tests__/claude-plugin-zip.test.mjsRelease zip layout (E44) and version gate (E45) for build-claude-plugin-zip.mjs.
__tests__/codeql-local-cli.test.mjscodeql-local.mjs end to end against a fake CODEQL_BIN… → see __tests__/codeql-local-cli.test.mjs.AGENTS.md
__tests__/codeql-local-real.test.mjscodeql-local.mjs against the REAL CodeQL CLI on tiny repos (#E4, #E18, #X6). → see __tests__/codeql-local-real.test.mjs.AGENTS.md
__tests__/codeql-local-mirror.test.mjs→ __tests__/codeql-local-mirror.test.mjs.AGENTS.md
__tests__/codeql-local.test.mjsPure decision logic of codeql-local.mjs (#E14, #E15, #E17… → see __tests__/codeql-local.test.mjs.AGENTS.md
__tests__/coverage-config.test.mjsCoverage config shape; coverage-unloaded fixture stays unloaded (E29-E31). See change: triage-browser-e2e-offbox-poison.
__tests__/coverage-report.test.mjsLive coverage runs; E2 scoped to fixtures/coverage-unloaded. See change: triage-browser-e2e-offbox-poison.
__tests__/client-isolate-gate.test.mjsClient isolate gate. Also E22 (keycloak dep dropped) and E… → see __tests__/client-isolate-gate.test.mjs.AGENTS.md
__tests__/e2e-fixture-import.test.mjsGuard tests for check-e2e-fixture-import.mjs (E6/E7, trust-write lint E21/E22). See change: triage-browser-e2e-offbox-poison.
__tests__/e2e-reap-core.test.mjsL1 for tests/e2e/reap-core.ts (reap, refusal verdict, trust isolation E8-E18, X5-X16). See change: triage-browser-e2e-offbox-poison.
__tests__/e2e-trust-seed.test.mjsRuns the test-entrypoint.sh config-seed program verbatim (E23-E25). See change: triage-browser-e2e-offbox-poison.
__tests__/fixtures/coverage-unloaded/Fixture: one source file no test imports + no-op test + pinned config (scoped E2). See change: triage-browser-e2e-offbox-poison.
__tests__/dependency-declarations.test.mjsSet-based manifest guarantees over ALL 32 non-private workspaces (not a sample). → see __tests__/dependency-declarations.test.mjs.AGENTS.md
__tests__/fixtures/codeql-harness.mjsTest harness for codeql-local.mjs: temp git repos, per-ca… → see __tests__/fixtures/codeql-harness.mjs.AGENTS.md
__tests__/fixtures/codeql-resolve-extensions.json→ __tests__/fixtures/codeql-resolve-extensions.json.AGENTS.md
__tests__/fixtures/coverage-failing/Red coverage fixture.
__tests__/fixtures/fake-codeql.mjsFake codeql (CODEQL_BIN seam). Plan from $FAKE_CODEQL… → see tests/fixtures/fake-codeql.mjs.AGENTS.md`
__tests__/fixtures/fake-gh.mjsFake gh (PI_CODEQL_GH_BIN seam). Plan $FAKE_GH_PLAN {log, alerts, exit, stderr, sleepMs}; logs argv first. See change: codeql-model-pack-and-mirror.
__tests__/fixtures/gh-code-scanning-alert.jsonRecorded real gh api …/code-scanning/alerts/464 (trimmed); base of ghAlert(). See change: codeql-model-pack-and-mirror.
__tests__/fixtures/mutation-journal-child.mjsChild-process fixture for the mutation-journal crash-safety tests. → see __tests__/fixtures/mutation-journal-child.mjs.AGENTS.md
__tests__/fixtures/npm-view-stub.mjsGate CLI npm-view stub. → see __tests__/fixtures/npm-view-stub.mjs.AGENTS.md
__tests__/helpers/ensure-dashboard-harness.mjsmakeCtx() sandbox for the bootstrap tests: temp HOME, logging stub executables, fixture/pid helpers, async run().
__tests__/helpers/fixture-dashboard-server.mjsStandalone fixture /api/health server (modes dashboard/wrong-pid/no-pid/recovery/foreign-html/hung); delayed bind, optional lock-meta write.
__tests__/merge-latest-mac.test.mjsCovers test-plan U6 for merge-latest-mac.py: the minimu… → see tests/merge-latest-mac.test.mjs.AGENTS.md`
__tests__/qa-pack-fixture-plugin.test.mjsTests qa/scripts/pack-fixture-plugin.mjs.
__tests__/qa-dist-only-scripts.test.mjsGuards QA 47–51, #E103. → __tests__/qa-dist-only-scripts.test.mjs.AGENTS.md
__tests__/seed-settings-compaction.test.mjsUnit tests for the e2e-only compaction.keepRecentTokens… → see __tests__/seed-settings-compaction.test.mjs.AGENTS.md
__tests__/nightly-report.test.mjsNightly report (X9–X11). → see __tests__/nightly-report.test.mjs.AGENTS.md
__tests__/shared-heavy-files.test.mjsHeavy shared groups.
__tests__/select-affected-tests.test.mjsSelector layers (E1–E27). → see __tests__/select-affected-tests.test.mjs.AGENTS.md
__tests__/select-affected-tests-cli.test.mjsSelector CLI (X2–X8). → see __tests__/select-affected-tests-cli.test.mjs.AGENTS.md
__tests__/select-affected-tests-graph.test.mjsReal-tree graph build (X1, P1). → see __tests__/select-affected-tests-graph.test.mjs.AGENTS.md
__tests__/test-selection-data.test.mjsSelection data contract (E29). → see __tests__/test-selection-data.test.mjs.AGENTS.md
__tests__/fixed-tick-waits.test.mjsGuard tests + vitest wrapper for check-fixed-tick-waits.m… → see tests/fixed-tick-waits.test.mjs.AGENTS.md`
__tests__/jiti-cjs-transpile-safety.test.mjsRepo gate: jiti CJS transpile safety. → see __tests__/jiti-cjs-transpile-safety.test.mjs.AGENTS.md
__tests__/loader-neutral-source.test.mjsLoader-neutral gate tests E23–E28 + repo HEAD clean. See change: fix-appimage-cold-boot-latency.
__tests__/kb-packaging.test.mjsC2 (fix-kb-eval-measurement-integrity, ci-level behind RUN_CI_SCENARIOS=1): npm pack --dry-run of… → see __tests__/kb-packaging.test.mjs.AGENTS.md
__tests__/knip-config.test.mjsEntry-point rooting for the dead-code oracle (test-plan #G1, #G2, #G4, #D1, #P2). → see __tests__/knip-config.test.mjs.AGENTS.md
__tests__/knip-harness.test.mjsDocker-harness reproducibility for the dead-code oracle (test-plan #H1). → see __tests__/knip-harness.test.mjs.AGENTS.md
__tests__/lint-harness-scoping.test.mjsGuards that repo-wide lint harnesses judge git-tracked SOU… → see __tests__/lint-harness-scoping.test.mjs.AGENTS.md
__tests__/knip-ratchet.test.mjsPer-class dead-code ratchet (test-plan #R1-#R6). Load-beari… → see __tests__/knip-ratchet.test.mjs.AGENTS.md
__tests__/tsc7-wrapper.test.mjsE1–E6, E8, E9, E11, X4: wrapper runs TS 7 from any cwd, fo… → see __tests__/tsc7-wrapper.test.mjs.AGENTS.md
__tests__/verify-release-deps-keyring-floor.test.mjsE87 @napi-rs/keyring floor. → see __tests__/verify-release-deps-keyring-floor.test.mjs.AGENTS.md
__tests__/z-layer-lint.test.mjsOverlay z-index ratchet tests (test-plan #E4/#E5): extractRawZ matches raw numeric z but not word… → see __tests__/z-layer-lint.test.mjs.AGENTS.md
__tests__/knip-scan.test.mjsLive whole-workspace Knip scan assertions (test-plan #G3, #G5, #G6, #D2, #D3, #P1). → see __tests__/knip-scan.test.mjs.AGENTS.md
__tests__/mutation-journal.test.mjsVitest crash-safety tests for the mutation-harness journal (test-plan #E1-#E8, #X1-#X13). → see __tests__/mutation-journal.test.mjs.AGENTS.md
__tests__/nightly-verdaccio-publish.test.mjsVitest unit tests for scripts/nightly-verdaccio-publish.mj… → see __tests__/nightly-verdaccio-publish.test.mjs.AGENTS.md
__tests__/qa-smoke-guards.test.mjsFault-injects the clean-prefix QA smoke (qa/tests/35-plugin-install-load.sh) by stubbing… → see __tests__/qa-smoke-guards.test.mjs.AGENTS.md
__tests__/prune-memory-backups.test.mjsPins planPrune selection + prune IO for the hermes store trim. → see __tests__/prune-memory-backups.test.mjs.AGENTS.md
__tests__/rebuild-scripts-gate.test.mjsX5 fault injection: both rebuild-restart.sh and rebuild-and-restart.sh run the se… → see __tests__/rebuild-scripts-gate.test.mjs.AGENTS.md
__tests__/repair-meta-source.test.mjsVitest unit tests for repair-meta-source.mjs. Asserts source:"dashboard" → cleaned (o… → see __tests__/repair-meta-source.test.mjs.AGENTS.md
__tests__/review-changes-parser.test.mjsVitest unit tests for parseFindings + splitFindings (.pi/s… → see __tests__/review-changes-parser.test.mjs.AGENTS.md
__tests__/settings-kit-guard.test.mjsSettings-kit ratchet tests: per-kind counts + negatives (#… → see __tests__/settings-kit-guard.test.mjs.AGENTS.md
__tests__/severity-literal-guard.test.mjsStatic guard: no raw red-<NN(N)> Tailwind literal (2- or… → see __tests__/severity-literal-guard.test.mjs.AGENTS.md
__tests__/ship-it-manifest.test.mjsVitest unit tests for ship-it manifest.ts (.pi/skills/ship-it/scripts/). → see __tests__/ship-it-manifest.test.mjs.AGENTS.md
__tests__/ship-it-no-weakening.test.mjsVitest unit tests for ship-it no-weakening.ts assertNoWeakening. → see __tests__/ship-it-no-weakening.test.mjs.AGENTS.md
__tests__/skill-frontmatter.test.mjsVitest guard over every repo **/SKILL.md (skips node_modules/dist/worktrees). → see __tests__/skill-frontmatter.test.mjs.AGENTS.md
__tests__/spec-collateral.test.mjsL1 for spec-collateral.mjs (E1–E26, P1–P2, X1–X5). → see __tests__/spec-collateral.test.mjs.AGENTS.md
__tests__/sync-served-client.test.mjsE15/E16/X3/X4: the sync-served-client.mjs outcome table… → see __tests__/sync-served-client.test.mjs.AGENTS.md
__tests__/verify-release-deps-client-build-deps.test.mjsVitest tests for the E7 client build-dep rules… → see __tests__/verify-release-deps-client-build-deps.test.mjs.AGENTS.md
__tests__/theme-token-guard.test.mjsScan/ratchet/bootstrap tests for all three guard arms. → see __tests__/theme-token-guard.test.mjs.AGENTS.md
__tests__/harness-audit-armed.test.mjs→ __tests__/harness-audit-armed.test.mjs.AGENTS.md
__tests__/harness-recorder-helpers.mjsShared docker stub + sandbox for the harness recorder tests (not a test file). See change: add-missing-ci-legs.
__tests__/site-drift-decision.test.mjs→ __tests__/site-drift-decision.test.mjs.AGENTS.md
__tests__/test-down-recorder.test.mjstest-down.sh teardown marker, ≤10 s destroy wait, dead/absent recorder (stub docker). See change: add-missing-ci-legs.
__tests__/test-up-recorder.test.mjstest-up.sh lifecycle recorder: state fields, events path, ordering, re-up idempotence, best-effort faults. See change: add-missing-ci-legs.
__tests__/test-up-oversubscribe-guard.test.mjsVitest tests for the co-resident harness oversubscription… → see __tests__/test-up-oversubscribe-guard.test.mjs.AGENTS.md
__tests__/test-up-port-derivation.test.mjsVitest tests for parallel-worktree test-harness port/project derivation. → see __tests__/test-up-port-derivation.test.mjs.AGENTS.md
_windows-introspection-probe.tsProbe child for Windows introspection smoke. Imports real… → see _windows-introspection-probe.ts.AGENTS.md
assert-bundled-plugins-published.mjsGate #X17. → see assert-bundled-plugins-published.mjs.AGENTS.md
assert-runtime-release.mjsRelease shape check #X16. → see assert-runtime-release.mjs.AGENTS.md
build-runtime-canary.mjsBuilds the runtime canary fixture + variants with the SDK preset. → see build-runtime-canary.mjs.AGENTS.md
build-claude-plugin-zip.mjsZips packages/claude-plugin/ (manifest at zip root) to pi-dashboard-claude-plugin-<v>.zip; fails when… → see build-claude-plugin-zip.mjs.AGENTS.md
build.shType-check + build dashboard. Flags: --check-only (tsc --noEmit only), --client-only (Vite build only). Auto-runs npm install if node_modules absent.
build-runtime-asset.mjsPer-platform runtime asset. → see build-runtime-asset.mjs.AGENTS.md
__tests__/verify-published-imports.test.mjsTests for verify-published-imports.mjs. Fixtures built i… → see __tests__/verify-published-imports.test.mjs.AGENTS.md
__tests__/patch-vendor-specifiers.test.mjsTests for patch-vendor-specifiers.mjs (E6: 4-specifier re… → see __tests__/patch-vendor-specifiers.test.mjs.AGENTS.md
__tests__/root-packaging.test.mjsci-level root tarball exclusion check (E14/E15). → see __tests__/root-packaging.test.mjs.AGENTS.md
__tests__/release-lock.test.mjsTests for release-lock rebase/audit/fetch/lint + post-bundle assertion (E1–E12, E18, E19, X1, X2). See change: pin-electron-bundle-dependency-tree.
__tests__/runtime-release.test.mjsRuntime release tests. → see __tests__/runtime-release.test.mjs.AGENTS.md
__tests__/refresh-vendor.test.mjsTests for refresh-vendor.mjs (X3: an unfaithful stubbed… → see __tests__/refresh-vendor.test.mjs.AGENTS.md
__tests__/vendor-specifiers.test.mjsTests for check-vendor-specifiers.mjs (E1/E2/X4: the patched tree passes non-vacuously;… → see __tests__/vendor-specifiers.test.mjs.AGENTS.md
__tests__/verify-plugin-install-load.test.mjsTests for verify-plugin-install-load.mjs (E8 scope filter always;
__tests__/verify-docker-plugin-load.test.mjsTests for verify-docker-plugin-load.mjs (X12): harness-s… → see __tests__/verify-docker-plugin-load.test.mjs.AGENTS.md
__tests__/vitest-workers.test.mjsGuard over the vitest worker consolidation (test-plan E15-… → see __tests__/vitest-workers.test.mjs.AGENTS.md
check-advisory-triage.mjs→ check-advisory-triage.mjs.AGENTS.md
check-client-sinks.mjsClient sink guard. → see check-client-sinks.mjs.AGENTS.md
check-conventions.mjsDeterministic half of the ship gate, run by ship-it step 4.4. → see check-conventions.mjs.AGENTS.md
check-e2e-fixture-import.mjsGuard: every tests/e2e/*.spec.ts MUST import test from ./fixtures.js, never @playwright/test directly… → see check-e2e-fixture-import.mjs.AGENTS.md
check-fixed-tick-waits.mjsFixed-tick wait guard, run by ci.yml (standalone step) + ship gate. → see check-fixed-tick-waits.mjs.AGENTS.md
check-kb-dist-fresh.mjsCI gate (ci.yml, ship-it 4.4-adjacent): recomputes kb srcHash+tsconfigHash vs the committed… → see check-kb-dist-fresh.mjs.AGENTS.md
check-loader-neutral-source.mjsLoader-neutral source gate (AST; server scope). → see check-loader-neutral-source.mjs.AGENTS.md
check-mockups.mjs→ check-mockups.mjs.AGENTS.md
check-pi-settings-paths.mjsGuard, run by ci.yml: no machine-specific absolute path in a committed .pi/settings.json… → see check-pi-settings-paths.mjs.AGENTS.md
check-plugin-boundary.mjsCore/plugin import ratchet for ship-it step 4.4 + npm run check:plugin-boundary: NEW edge / STALE row… → see check-plugin-boundary.mjs.AGENTS.md
codeql-anchor/plugin-routes.mjs→ codeql-anchor/plugin-routes.mjs.AGENTS.md
host-api-surface.mjsHost API surface snapshot + bump gate. --write regenerates… → see host-api-surface.mjs.AGENTS.md
check-skill-frontmatter.mjsSkill frontmatter guard, run by ci.yml. Exit non-zero iff >=1 error; warnings never fail. → see check-skill-frontmatter.mjs.AGENTS.md
check-vendor-specifiers.mjsStatic specifier guard for the vendored relay: every import under relay/vendor/ mus… → see check-vendor-specifiers.mjs.AGENTS.md
codeql-local.mjsLocal CodeQL ratchet for ship-it steps 4.4/4.4b: snapshot → analyse → per-alert baseline ratchet (codeql-baseline.json). → see codeql-local.mjs.AGENTS.md
commit-windows-parity.shStages and commits fix-windows-server-parity + consolidate-platform-handlers work in 5 logical chunks (fix:,… → see commit-windows-parity.sh.AGENTS.md
discord-release-announce.mjsFull release notes → Discord webhook. → see discord-release-announce.mjs.AGENTS.md
dox-byte-gate.mjsAGENTS.md byte-cap gate for ship-it step 4.4. Filters kb dox lint --json to kind:"over-threshold" +… → see dox-byte-gate.mjs.AGENTS.md
fix-pty-permissions.cjsPostinstall: fix node-pty spawn-helper execute permissions
generate-plugin-registry.mjsStandalone generator for packages/client/src/generated/plug… → see generate-plugin-registry.mjs.AGENTS.md
generate-runtime-lock.mjsServer lock gen. → see generate-runtime-lock.mjs.AGENTS.md
lint-runtime-lock.mjs--version X [--lock F]: runs the bundle's rebaseRuntimeLock over the generated lock as a check; non-zero… → see lint-runtime-lock.mjs.AGENTS.md
i18n-lint.mjsHardcoded-UI-string lint. → see i18n-lint.mjs.AGENTS.md
i18n-parity.mjsCatalog parity gate: every key in the union of zh-CN (i18n-zh-CN.ts) + hu + plugin catalogs exists in each. → see i18n-parity.mjs.AGENTS.md
rebuild-and-restart.shBuild → verify served client → pi-dashboard restart → npm run reload. → see rebuild-and-restart.sh.AGENTS.md
rebuild-restart.shBuild (+ optional --check tsc) → verify served client (node scripts/sync-served-client.mjs) →… → see rebuild-restart.sh.AGENTS.md
refresh-vendor.mjsOwns the vendored-relay refresh: copy → verify upstream (in memory, before any write) → patch → rehash. → see refresh-vendor.mjs.AGENTS.md
site-drift-decision.mjsDecision script of .github/workflows/site-drift-check.yml: live deploy-sha.txt vs last site-relevant… → see site-drift-decision.mjs.AGENTS.md
stage-runtime-canary.mjsStages runtime canary for the harness. → see stage-runtime-canary.mjs.AGENTS.md
sync-claude-plugin.mjsDerives the control skill's references/api-reference.md from the extension skill's (drops the bus-verbs… → see sync-claude-plugin.mjs.AGENTS.md
sync-served-client.mjsResolves the served destination via the SERVER's resolveStaticClientDir (jiti) and mirrors the fresh… → see sync-served-client.mjs.AGENTS.md
heap-probe.mjsCDP heap probe for a RUNNING dashboard: SIGUSR1s the pid (from --pid or /api/health), attaches to… → see heap-probe.mjs.AGENTS.md
lib-jiti-scope.mjsDiscovery rule + AST detector behind the jiti-cjs-transpile-safety gate. Scope is a DERIVED RULE… → see lib-jiti-scope.mjs.AGENTS.md
lib/kb-engine-fingerprint.mjsRepo-facing re-export of packages/kb/bin/lib/engine-fingerprint.mjs (the ONE implementation — shipped via… → see lib/kb-engine-fingerprint.mjs.AGENTS.md
lib/runtime-release.mjsRuntime release shared helpers. → see lib/runtime-release.mjs.AGENTS.md
lib/smoke-spawn-session.mjsTest helper: connects dashboard browser WS (/ws), sends spawn_session for cwd, waits for… → see lib/smoke-spawn-session.mjs.AGENTS.md
knip-config.mjsDerives Knip entry points from the project's own manifest conventions and fails when knip.json does not… → see knip-config.mjs.AGENTS.md
knip-ratchet.mjsPer-class dead-code ratchet for ship-it step 4.4 and the nightly job. → see knip-ratchet.mjs.AGENTS.md
tsc7.mjsSingle wrapper for the TypeScript 7 compiler (typescript-7 = npm alias of typescript@7.0.2). → see tsc7.mjs.AGENTS.md
windows-forbidden-subjects-smoke.tsWindows-only smoke (_smoke.yml Windows leg): forbiddenG… → see windows-forbidden-subjects-smoke.ts.AGENTS.md`
z-layer-lint.mjsOverlay z-index ratchet (spec overlay-layering). Freezes raw numeric z-[NNNN]/z-<n> in… → see z-layer-lint.mjs.AGENTS.md
z-layer-baseline.jsonFrozen baseline for z-layer-lint.mjs — the current raw-z occurrences (Tier-B inline popovers +… → see z-layer-baseline.json.AGENTS.md
maybe-patch-package.cjspostinstall guard: runs patch-package only when module resolvable + patches/ dir exists. → see maybe-patch-package.cjs.AGENTS.md
merge-latest-mac.pyMerges the arm64 + x64 latest-mac.yml update-metadata legs into one file (softprops dedups release assets… → see merge-latest-mac.py.AGENTS.md
measure-replay-compaction.mjsMeasures the compact-warm-replay-stream (#399) win: events / bytes / batches / wall time, before vs after… → see measure-replay-compaction.mjs.AGENTS.md
migrate-child-process-imports.shOne-shot sed migration: rewrites from "node:child_process" to platform/exec wrapper. → see migrate-child-process-imports.sh.AGENTS.md
mutation-harness.mjsManifest-driven mutation runner for the promise-rule ladder: breaks a covered behaviour in a real source file… → see mutation-harness.mjs.AGENTS.md
mutation-journal-global-setup.mjsRoot-level vitest globalSetup (registered in the ROOT v… → see mutation-journal-global-setup.mjs.AGENTS.md`
nightly-verdaccio-publish.mjsNightly Verdaccio publish: bump every non-private workspace + root t… → see nightly-verdaccio-publish.mjs.AGENTS.md
nightly-verdaccio-serve.mjsStart an ephemeral Verdaccio as a detached background service (spawn detached+unref+stdio:ignore — cross-OS,… → see nightly-verdaccio-serve.mjs.AGENTS.md
plugin-boundary-allowlist.jsonRatcheting (from, to) baseline for check-plugin-boundary.mjs: 76 seed rows, each… → see plugin-boundary-allowlist.json.AGENTS.md
probe-harness-memory.mjsOut-of-band harness memory probe (host side): docker exec reads cgroup v2 memory.* + pids.current and… → see probe-harness-memory.mjs.AGENTS.md
prune-memory-backups.mjsRecurring maintenance: trims ~/.pi/agent/pi-hermes-memory/. Deletes all sessions.db.corrupt-* (incl. → see prune-memory-backups.mjs.AGENTS.md
prune-orphan-worktrees.tsOne-shot: rm -rf orphan .worktrees/* husk dirs (on disk, absent from git worktree list) left by kb DB… → see prune-orphan-worktrees.ts.AGENTS.md
patch-vendor-specifiers.mjsRewrites the vendored relay's playwright-internal specifiers to package-relative shi… → see patch-vendor-specifiers.mjs.AGENTS.md`
reload-all.shBuild bridge + reload all pi sessions Inline per-request proof mint (byte-identical to shared mintProof,… → see reload-all.sh.AGENTS.md
repair-main-specs.mjsStructural repair of corrupted openspec/specs/**/spec.md. → see repair-main-specs.mjs.AGENTS.md
repair-meta-source.mjsRemoves source: "dashboard" from every ~/.pi/agent/sessions/**/*.meta.json. Atomic tmp+rename. → see repair-meta-source.mjs.AGENTS.md
runtime-e2e-registry.mjsE2E registry fixture. → see runtime-e2e-registry.mjs.AGENTS.md
seed-sessions-window.mjsE2E-only seed: writes >120 ended session .meta.json/.jsonl records across dummy dirs plus one… → see seed-sessions-window.mjs.AGENTS.md
seed-settings-compaction.mjsE2E-only seed: writes compaction.keepRecentTokens (default 1) into pi settings.json so a manual… → see seed-settings-compaction.mjs.AGENTS.md
seed-settings-default-model.mjsSeeds pi settings.json with SPLIT defaultProvider+def… → see seed-settings-default-model.mjs.AGENTS.md`
select-affected-tests.mjsAffected-test selector CLI. → see select-affected-tests.mjs.AGENTS.md
test-selection/Selector modules + data. → see test-selection/AGENTS.md
settings-kit-baseline.jsonShrink-only baseline for settings-kit-guard.mjs: {counts} map <file>::<kind> → count. → see settings-kit-baseline.json.AGENTS.md
settings-kit-guard.mjsSettings-kit ratchet (design D7): scans every .tsx under each settings-section claim dir… → see settings-kit-guard.mjs.AGENTS.md
spec-collateral.mjsAdvisory OpenSpec post-archive contradiction scan; exit 0/2, never 1. → see spec-collateral.mjs.AGENTS.md
split-large-agents.mjsOne-off Node script. Splits over-large directory AGENTS.md file-based. → see split-large-agents.mjs.AGENTS.md
stop-dashboard.shStops pi-dashboard server. Reads port from ~/.pi/dashboard/config.json (default 8000); lsof -ti :PORT; SIGTERM, SIGKILL fallback after 5s.
sync-versions-spec.jsPure helper extracted from sync-versions.js for unit tests. → see sync-versions-spec.js.AGENTS.md
sync-versions.jsPost-bump release helper. Reads every workspace package.json, enforces lockstep versions, rewrites every… → see sync-versions.js.AGENTS.md
test-standalone-npm-install-docker.shDocker smoke: packs workspaces + root, launches clean Linu… → see test-standalone-npm-install-docker.sh.AGENTS.md
test-standalone-npm-install.ps1Windows port of standalone-npm-install smoke. Packs workspaces… → see test-standalone-npm-install.ps1.AGENTS.md
test-standalone-npm-install.shBash standalone-install smoke: packs workspaces, installs tarballs into isolated temp HOME, spawns… → see test-standalone-npm-install.sh.AGENTS.md
theme-token-baseline.jsonShrink-only baseline for theme-token-guard.mjs: {fallback,undeclared,accentText} maps. → see theme-token-baseline.json.AGENTS.md
theme-token-guard.mjsThree-arm theme-token ratchet: fallback-form, undeclared colour token, accent-as-text. → see theme-token-guard.mjs.AGENTS.md
verify-published-imports.mjsPublish-correctness checker, run by ci.yml. For every non-private packages/*, asserts every module… → see verify-published-imports.mjs.AGENTS.md
verify-plugin-install-load.mjsDynamic install-load check: pack → install OUTSIDE the rep… → see verify-plugin-install-load.mjs.AGENTS.md
verify-docker-plugin-load.mjsRequired Docker gate (X12): boot the image and assert the browser plugin loaded, with no alias crutch. → see verify-docker-plugin-load.mjs.AGENTS.md
verify-lockfile-versions.mjsSanity gate after pnpm install --lockfile-only in publish.yml (tag-and-push) + _electron-build.yml. → see verify-lockfile-versions.mjs.AGENTS.md
verify-release-deps.mjsPre-release dependency-shape gate. RULES assert server declares jiti, node-pty (>=1.2.0-beta.13),… → see verify-release-deps.mjs.AGENTS.md
vitest.config.tsVitest config for repo-root /scripts project. Includes scripts/tests/**/*.test.mjs, node env, forks pool,… → see vitest.config.ts.AGENTS.md
windows-liveness-smoke.tsWindows boot-parent-liveness smoke (CI: _smoke.yml standalone-install-smoke-windows). → see windows-liveness-smoke.ts.AGENTS.md
windows-introspection-smoke.tsWindows introspection smoke driver (CI: _smoke.yml standalone-install-smoke-windows). → see windows-introspection-smoke.ts.AGENTS.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.