API rules and ADR 0043: static modules, one clock and per-kind minters, layers with account/, the common/ rule #422

New issue

Closed

opened 2026-10-15 14:45:03 +00:00 by root · 10 comments

root commented

2026-10-15 14:45:03 +00:00

(Migrated from gitlab.core-project.space)

Parent

#421

What to build

The API's rules describe the wiring the owner decided, before any code moves. This is a docs-only change, the dedicated rule change the owner asked for (CLAUDE.md, "No rule edits in feature work").

A new ADR 0043 states four things:

feature modules are static;
the root module alone is dynamic and provides each feature's options, one shared clock and one minter per kind of identity (Room code, Game id, Guest, secret);
the API layers are common → config → mail → auth → games → account → devtools → room → .;
common/ admits what at least two features use and no single feature owns.

Seam: S3. No code change; the gate stays green on docs.

Acceptance criteria

ADR 0043 states the wiring, the clock and minters, the layer order with account, and the common/ admission rule, in the ADR format.
ADR 0026 keeps the engine. Its API line points to ADR 0043.
ADR 0027's sentence about one flat feature module is corrected.
The ADR index has a row for 0043, and 0026's row reflects the change.
The API standards' preamble lists the seven folders and the common/ rule.
Rule 1 lists the files of auth/, mail/, devtools/ and account/ that may import Nest.
Rule 2 reads: the clock and each identity minter are shared providers, and only their default may call Date.now, Math.random or randomBytes.
Rule 6 adds that tests replace providers by token through createApp's overrides.

## Parent #421 ## What to build The API's rules describe the wiring the owner decided, before any code moves. This is a docs-only change, the dedicated rule change the owner asked for (`CLAUDE.md`, "No rule edits in feature work"). A new ADR 0043 states four things: - feature modules are static; - the root module alone is dynamic and provides each feature's options, one shared clock and one minter per kind of identity (Room code, Game id, Guest, secret); - the API layers are `common → config → mail → auth → games → account → devtools → room → .`; - `common/` admits what at least two features use and no single feature owns. Seam: S3. No code change; the gate stays green on docs. ## Acceptance criteria - [ ] ADR 0043 states the wiring, the clock and minters, the layer order with `account`, and the `common/` admission rule, in the ADR format. - [ ] ADR 0026 keeps the engine. Its API line points to ADR 0043. - [ ] ADR 0027's sentence about one flat feature module is corrected. - [ ] The ADR index has a row for 0043, and 0026's row reflects the change. - [ ] The API standards' preamble lists the seven folders and the `common/` rule. - [ ] Rule 1 lists the files of `auth/`, `mail/`, `devtools/` and `account/` that may import Nest. - [ ] Rule 2 reads: the clock and each identity minter are shared providers, and only their default may call `Date.now`, `Math.random` or `randomBytes`. - [ ] Rule 6 adds that tests replace providers by token through `createApp`'s overrides.

root commented

2026-10-15 14:45:16 +00:00

(Migrated from gitlab.core-project.space)

mentioned in issue #423