Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
docs(architecture): list the history page and storage quota tables
Corey Olson1757623f70b7
diff --git a/docs/architecture.md b/docs/architecture.mdindex 5b1801ab..50f1d14f 100644--- a/docs/architecture.md+++ b/docs/architecture.md@@ -87,6 +87,12 @@ Everything durable lives on one volume at `/data`: `auth.sqlite`, then `devices.| `journal_record` | `boards/<board>.journal.sqlite` | Per record: sequence, arrival time, kind (move or request), sealed payload, sender kind, sender account, agent or machine name. | The next snapshot covers it. || `journal_registration` | `boards/<board>.journal.sqlite` | Per seat a move registered: the target seat, its creator, the move's sequence and the sealed move's digest, so a replica checks who created a seat. | The board is deleted or expires. || `journal_snapshot` | `boards/<board>.journal.sqlite` | One sealed snapshot: the sequence it covers, arrival time, sealed payload, sender. | The next snapshot replaces it. |+| `page_meta` | `boards/<board>.journal.sqlite` | The board id and the history page format. | The board is deleted or expires. |+| `page_object` | `boards/<board>.journal.sqlite` | Per sealed history page: its id, the sequence it reaches, the sealed payload, its child page ids and its creation time. | Collection deletes a page that no current root, pin or staged upload reaches. |+| `page_upload` | `boards/<board>.journal.sqlite` | Per staged page upload: id, the sender's account id, kind and agent or machine name, the sequence it covers and its expiry. | It is published, or it expires. |+| `page_upload_object` | `boards/<board>.journal.sqlite` | Which sealed pages a staged upload holds: the upload id and the page id. | Its upload is deleted. |+| `page_pin` | `boards/<board>.journal.sqlite` | Per read in flight: id, the reader's account id, kind and agent or machine name, the root page it reads and its expiry. | It expires. |+| `storage_warning` | `boards/storage-quota.sqlite` | Per board refused for account storage: the board, the account id and login in clear, the bytes used and allowed, and the bytes the refused write needed. | The board's next stored checkpoint, or the board is unlinked. |Once a day the relay copies each journal into `backups/` and keeps each copy for 14 days; deleting a board deletes its copies at once (`relay/retention.js`). After 60 days without activity the relay warns on the next contact, and at 90 days it deletes the board.diff --git a/docs/architecture.test.js b/docs/architecture.test.jsindex 4137ecbc..093672f4 100644--- a/docs/architecture.test.js+++ b/docs/architecture.test.js@@ -13,6 +13,8 @@ import { test } from 'node:test';import { createRelayAuth } from '../relay/auth.js';import { createDeviceStore } from '../relay/device-store.js';import { createRelayJournal } from '../relay/journal.js';+import { createRelayPages } from '../relay/page-store.js';+import { createStorageQuota } from '../relay/storage-quota.js';const ROOT = join(import.meta.dirname, '..');const PAGE = readFileSync(join(ROOT, 'docs', 'architecture.md'), 'utf8');@@ -89,11 +91,13 @@ function liveTables() {auth.close();const boards = join(folder, 'boards');createRelayJournal({ directory: boards, boardId: '0'.repeat(32) }).close();+ createRelayPages({ directory: boards, boardId: '0'.repeat(32) }).close();+ createStorageQuota({ directory: boards, auth: { withBoard: (board, work) => work() } }).close();const devices = createDeviceStore({ directory: boards });devices.begin('1', 'a'.repeat(22));devices.close();const tables = new Set();- for (const file of [join(folder, 'auth.sqlite'), join(boards, 'devices.sqlite'), join(boards, '0'.repeat(32) + '.journal.sqlite')]) {+ for (const file of [join(folder, 'auth.sqlite'), join(boards, 'devices.sqlite'), join(boards, '0'.repeat(32) + '.journal.sqlite'), join(boards, 'storage-quota.sqlite')]) {const db = new DatabaseSync(file, { readOnly: true });try {for (const row of db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").all()) tables.add(row.name);