Storage Overview
AIWG storage subsystem
Storage Documentation
Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.
User-facing documentation for AIWG's pluggable storage adapter system (#934).
Pages
- Overview — what the storage system does, quick start, CLI surface, what's implemented vs deferred
- Security — credential handling, path traversal rejection, atomic writes, doctor validation
- Migration — the agent-owned storage operation command walkthrough
- Direct PostgreSQL — advanced canonical backend, roles, TLS, migration, and qualification
- PostgreSQL through PostgREST — optional HTTP transport, RPC boundaries, RLS, and limits
- Scalable backend contract — versioned capabilities,
data classes, consistency, and backend maturity
- Scalable migration protocol — checksum-backed
offline/online migration, approval, cutover, and rollback
- Qualification evidence — correctness-first concurrency, fault, recovery, and benchmark reports
Per-backend pages
| Backend | Page | Status |
|---|---|---|
| `fs` | backends/fs.md | READY (default) |
| `obsidian` | backends/obsidian.md | READY |
| `logseq` | backends/logseq.md | READY |
| `fortemi` | backends/fortemi.md | READY (alpha; legacy for search) |
| `notion` | backends/notion.md | STUB (#959) |
| `anythingllm` | backends/anythingllm.md | STUB (#960) |
| `s3` | backends/s3.md | STUB (#962) |
| `webdav` | backends/webdav.md | STUB (#963) |
Reference
- Full design: `.aiwg/architecture/storage-design.md`
- ADR: `.aiwg/architecture/adr-configurable-storage-backends.md`
- JSON Schema: `.aiwg/architecture/schemas/storage.config.v1.json`
- Research note: `.aiwg/architecture/research/storage-backends.md`
- Live backend status: the agent-owned storage operation
- Fortemi Core index/search packaging: `docs/fortemi-core-prebuilt-indices.md`