soulcraft/brainy
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 335 Packages Wiki Activity Actions

docs(8.0): consistency-model concept + snapshots guide — Db API replaces branching docs

Browse source
This commit is contained in:
David Snelling 2026-06-11 08:37:26 -07:00
parent e5feae4104
commit cc8037db10
23 changed files with 1053 additions and 1871 deletions
Download patch file Download diff file Expand all files Collapse all files

13
.claude/skills/architecture.md
View file

@ -11,15 +11,12 @@
- **BaseStorage** (`src/storage/baseStorage.ts`): Base implementation with built-in type-aware partitioning (TypeAwareStorageAdapter was removed -- functionality merged into BaseStorage).
- **Adapters** (`src/storage/adapters/`):
- `fileSystemStorage.ts` -- local filesystem
- `opfsStorage.ts` -- browser Origin Private File System (formerly browserStorage.ts)
- `memoryStorage.ts` -- in-memory
- `s3CompatibleStorage.ts` -- generic S3-compatible (AWS, MinIO, etc.)
- `r2Storage.ts` -- Cloudflare R2
- `gcsStorage.ts` -- Google Cloud Storage
- `azureBlobStorage.ts` -- Azure Blob Storage
- Supporting: `batchS3Operations.ts`, `optimizedS3Search.ts`
- **COW** (`src/storage/cow/`): Copy-on-Write infrastructure for versioning and branching
- CommitLog, CommitObject, CommitBuilder, BlobStorage, RefManager, TreeObject
- `baseStorageAdapter.ts` -- shared adapter base (counts, batch ops)
- Cloud + OPFS adapters were removed in 8.0 (cloud backup is operator tooling)
- **Generational MVCC / Db API** (`src/db/`): immutable `Db` values over generation-stamped records
- `db.ts` (the `Db` value), `generationStore.ts` (record layer + commit protocol), `types.ts`, `errors.ts`, `whereMatcher.ts`
- Design record: `docs/ADR-001-generational-mvcc.md`; replaced the pre-8.0 COW branching + versioning subsystems
### Vector Search (`src/hnsw/`)
- `hnswIndex.ts` -- HNSW-based approximate nearest neighbor search