akw-factory-floorsfloors.akwlabs.dev · ga

The mailroom

One append-only JSONL log per floor.

Every floor holds floor-mailroom.jsonl. The file is append-only: row 1 is always the initialization row, and nothing rewrites a row once it is written.

{"seq":1,"ts":"2026-09-01T20:31:44.812Z","floor":"floor-data","role":"data","event":"initialized","body":"mailroom opened for data by scripts/generators/mailroom.ts","schema_version":1}

The shape

Row number within this floor's mailroom, starting at 1 and rising without a gap. ISO-8601 UTC timestamp, written when the row was appended. The floor directory name. Always carries the `floor-` prefix. The role the floor serves — the floor name without its prefix. One of `initialized`, `delivered`, `dispatched`, `noted`. What happened, in one line. Shape version of the row. Bump it when `MailroomRow` changes.

One schema, not several

src/types.ts is the only hand-written schema in the repository. ts-to-zod derives src/generated/types.zod.ts from it, and the generators, the loaders, the Ink view and the tests all validate against that one derived schema.