packages/storage/README.md

# storage/ — non-session storage family

English | [中文](README.zh.md)

This family persists application data other than session event logs through named backends and typed data forms.

| Package | Role | ctx key |
|---|---|---|
| [`storage/`](storage/README.md) | Connects registered backends with typed data forms | `ctx.storage` |
| [`storage-json/`](storage-json/README.md) | Stores data in JSON files | registers backend `json` |
| [`storage-sqlite/`](storage-sqlite/README.md) | Stores data in SQLite | registers backend `sqlite` |
| [`storage-domain/`](storage-domain/README.md) | Provides validated domain-record storage | `ctx.storageDomain` |

Consumers use a data form rather than accessing a backend directly. The [domain storage decision](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.md) records the family design.

The subsystem reference — the backend contract, `StorageForms`, `DomainSpec`/`Domain`, `domain/changed` — is [docs/subsystems/storage.md](../../docs/subsystems/storage.md).
chore(storage,workspace): gates — coverage, catalogs, bilingual note 2026-07-24 22:49:57 +08:00			`# storage/ — non-session storage family`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`This family persists application data other than session event logs through named backends and typed data forms.`
chore(storage,workspace): gates — coverage, catalogs, bilingual note 2026-07-24 22:49:57 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`storage/`](storage/README.md) \| Connects registered backends with typed data forms \| `ctx.storage` \|
			\| [`storage-json/`](storage-json/README.md) \| Stores data in JSON files \| registers backend `json` \|
			\| [`storage-sqlite/`](storage-sqlite/README.md) \| Stores data in SQLite \| registers backend `sqlite` \|
			\| [`storage-domain/`](storage-domain/README.md) \| Provides validated domain-record storage \| `ctx.storageDomain` \|
chore(storage,workspace): gates — coverage, catalogs, bilingual note 2026-07-24 22:49:57 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`Consumers use a data form rather than accessing a backend directly. The [domain storage decision](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.md) records the family design.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
docs: reserve seam for complete capabilities 2026-08-09 15:34:32 +08:00			The subsystem reference — the backend contract, `StorageForms`, `DomainSpec`/`Domain`, `domain/changed` — is [docs/subsystems/storage.md](../../docs/subsystems/storage.md).