Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

docs: describe the focused local gate consistently

[._.]/ Adam Eivy3f0bfec5d819
diff --git a/.githooks/pre-commit b/.githooks/pre-commit
index b0ec97b90d..358d7b7e8a 100755
--- a/.githooks/pre-commit
+++ b/.githooks/pre-commit
@@ -11,10 +11,10 @@ if [ -z "$STAGED" ]; then
fi
# Lightweight local policy: lint, structural guards and directly owned tests.
-# Hosted CI owns broad coverage; no transitive server/browser/DB/build suite. The hook deliberately runs nothing
-# else: it used to run the whole server suite and `npm run build --prefix
-# client`, which publishes the branch's build into the dist the running
-# install serves (#12045). Validation never swaps what `npm start` serves.
+# Hosted CI owns broad coverage; no transitive server/browser/DB/build suite.
+#
+# Do not build the client here: that would publish this branch's build into
+# the dist the running install serves (#12045). Validation never swaps it.
printf -- "\n🔎 pre-commit: running focused local pregate on the PortOS changes\n"
node scripts/pregate.js
diff --git a/AGENTS.md b/AGENTS.md
index 56deca8b90..b96eabd71c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -55,7 +55,7 @@ npm test --prefix client # Vitest (happy-dom) — component/unit tests
# inherits it aims at the real Postgres.
npm run test:db # DB-backed suites → portos_test ONLY (see Security Model)
-npm run pregate # BEFORE EVERY PUSH — CI's plan run locally; receipt in .cache/pregate/report.json
+npm run pregate # BEFORE EVERY PUSH — focused local gate (lint, guards, direct tests); --full for CI's plan
# Local focused tests and CI skip test files whose every input already passed (the test
# memo, docs/GITHUB_ACTIONS.md "Test memo"); PORTOS_TEST_MEMO=off runs them all.
node scripts/pregate-attest.js # Only after explicit --full validation and the push: posts the green receipt as a `pregate` commit status bound to the