From f527850107e43fdc32afe783d528489d67e2ad52 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sat, 31 Oct 2026 08:56:32 +0100 Subject: [PATCH] =?UTF-8?q?Answer=20prose=20round=201:=200=20=F0=9F=94=B4,?= =?UTF-8?q?=203=20=F0=9F=9F=A1=20(0=20misread);=20trim=20the=20header=20co?= =?UTF-8?q?mment=20and=20AGENTS.md=20rule,=20list=20the=20guard=20in=20the?= =?UTF-8?q?=20file=20map?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 6 ++---- README.md | 2 +- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 4d99fcd..43ddade 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -435,10 +435,8 @@ one-time setup. A file-map or table row gets a clause, not a paragraph. URL shape, ignores the router's params, and has to re-handle HEAD. Factor shared per-request setup into a small `withX` wrapper — see `examples/plugins/admin/`. - **A function stays within 50 lines and complexity 20** (ESLint's defaults, measured by - `src/function-limits.test.ts`). Split one that outgrows them; never add it to the grandfathered - list or raise its ceiling there. The largest entry, `handleRequest`, is orchestration whose pure - parts are already extracted; it splits along the seams it tracks (canonical host, static, locale, - session, CSRF, hooks, routing, error mapping). + `src/function-limits.test.ts`). Split one that outgrows them; never add it to the test's + `grandfathered` list or raise a ceiling there. - Reviews are maintainer-triggered (e.g. via the larv-review skill) — never auto-run reviewer agents. - **A user-visible string belongs in a catalog, not in the code or a view.** Core strings go in `src/i18n/locales/en-US.ts` (then every other locale, or the boot fails); a plugin's go in its own diff --git a/README.md b/README.md index 8e6a230..0f1871b 100644 --- a/README.md +++ b/README.md @@ -1813,7 +1813,7 @@ unnecessary here — the signature itself is already invalid. ``` src/ The app — strict tsc, no build step. *.test.ts sit beside their module. server.ts Entry point; config.ts env loader; logger.ts structured log + trace span + tracedFetch - *.test.ts Topology guards with no source counterpart (compose/kratos/keto/hydra/postgres/ci-gate) + *.test.ts Guards with no source counterpart (compose/kratos/keto/hydra/postgres/ci-gate/function-limits) http/ Request pipeline: app.ts (createApp), builtin-routes, context, body, cookie, static, safe-url (safeUrl + localPath), security-headers auth/ Identity + the session-JWT hot path: jwt · jwt-middleware · jwks · gen-jwks (CLI) ·