Let configuration select the memory engine, gated by the registry (#18 §A5)

.gitignore

@@ -6,6 +6,12 @@ target/
 **/*.rs.bk
 *.pdb
 
+# Stray build artifacts. Two 3.6 MB Linux ELF executables with debug info were
+# committed at the repository root before this entry existed; both were produced
+# by an ad-hoc build, referenced by nothing, and carried in every clone.
+/rust_out
+/tmp
+
 # Coverage output
 /coverage/
 *.profraw

Cargo.toml

@@ -1,6 +1,6 @@
 [workspace]
-members = [".", "api", "core", "adapters/tinycortex", "adapters/remote"]
-default-members = [".", "api", "core", "adapters/tinycortex", "adapters/remote"]
+members = [".", "api", "core", "adapters/tinycortex", "adapters/remote", "conformance"]
+default-members = [".", "api", "core", "adapters/tinycortex", "adapters/remote", "conformance"]
 # `vendor/` holds engine submodules (tinycortex, tinybus, tinyagents), each of
 # which is its own workspace with its own lockfile. Same exclusion
 # `vendor/tinycortex` uses for its own nested vendor directory.
@@ -72,6 +72,13 @@ serde = { version = "1", features = ["derive"] }
 [dev-dependencies]
 # The mandatory-family tests are async.
 tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
+# `TestHostConfig`, for the driver-selection tests. A dev-dependency: the
+# facade must not carry a test double into a consumer's graph.
+tinymemory-api = { path = "api", features = ["test-support"] }
+# The reference driver and the behavioural suite, for the workspace-level
+# integration tests. A dev-dependency only: the facade must not carry a test
+# harness into a consumer's dependency graph.
+tinymemory-conformance = { path = "conformance" }
 
 [features]
 default = []

README.md

@@ -21,14 +21,30 @@ src/
 │                       binds as, and the fail-closed external-driver gate
 └── mandatory/          the three mandatory capability families, composed once
                         over the `Memory` storage trait
+core/                   tinymemory-core — the substance: ingestion, the summary
+                        tree, chunk storage, entities, the graph, the diff
+                        ledger, goals, tool-memory, and the Composio sync layer.
+                        The largest crate here by a wide margin, and the one a
+                        real host actually depends on. Unlike `api/` it is not
+                        dependency-light: today it links the TinyCortex engine,
+                        a bundled SQLite, and an HTTP stack unconditionally.
 adapters/
 ├── tinycortex/         the TinyCortex engine seen through the contract
 └── remote/             native HTTP dialects for Supermemory, Mem0, and Cognee
+crates/
+└── tinymemory-module/  the TinyBus loadable-module driver. Excluded from the
+                        workspace on purpose — see the note in `Cargo.toml`.
 vendor/
 ├── tinycortex/         the engine, pinned as a submodule
+├── tinyagents/         pinned TinyAgents submodule
 └── tinybus/            pinned TinyBus submodule
 ```
 
+Run `git submodule update --init --recursive` after cloning. Nothing in the
+workspace builds without it — `core` names `tinyagents` and `tinycortex` by
+path through `vendor/`, so an uninitialized checkout fails at manifest
+resolution rather than at compile time, which reads as a confusing error.
+
 ## The contract
 
 `MemoryProvider` is an object-safe trait with **three mandatory** capability

adapters/remote/Cargo.toml

@@ -3,7 +3,7 @@ name = "tinymemory-remote"
 publish = false
 version = "0.1.0"
 edition = "2021"
-rust-version = "1.85"
+rust-version = "1.96"
 license = "MIT"
 description = "HTTP adapters for self-hosted Supermemory, Mem0, and Cognee"
 repository = "https://github.com/tinyhumansai/tinymemory"

adapters/tinycortex/Cargo.toml

@@ -6,7 +6,7 @@ name = "tinymemory-tinycortex"
 publish = false
 version = "0.1.0"
 edition = "2021"
-rust-version = "1.85"
+rust-version = "1.96"
 license = "MIT"
 description = "TinyCortex engine adapter for the TinyMemory contract"
 repository = "https://github.com/tinyhumansai/tinymemory"
@@ -22,6 +22,28 @@ tinymemory-api = { path = "../../api" }
 # would defeat that and give a host two TinyCortex crates with two incompatible
 # `Memory` traits.
 tinycortex = { version = "0.1", default-features = false }
+# The optional capability families lifted here in issue #18 §C3 delegate to
+# `tinymemory-core` on a blocking thread — that is where the summary tree,
+# chunk store, entities, graph and diff ledger actually live. Depending on it
+# makes this adapter heavier than the mandatory-only version it replaces; §D
+# feature-gates that weight once §A3 has removed the direct engine call sites
+# core still has.
+tinymemory-core = { path = "../../core" }
+# `spawn_blocking`: every family method runs synchronous engine work off the
+# async executor rather than blocking it.
+tokio = { version = "1", features = ["rt"] }
+# Timestamps on ingest and diff records.
+chrono = { version = "0.4", features = ["serde"] }
+# The provider crosses a few value types by round-tripping them through JSON
+# where the engine and the contract describe the same shape under two names —
+# the duplication issue #18 §A1 exists to delete.
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+# Person ids are UUIDs on the engine side.
+uuid = { version = "1", features = ["v4"] }
+# The engine reports a failed profile write through the `log` facade rather
+# than returning it, so the host can decide what to do about it.
+log = "0.4"
 
 # `Memory` is an object-safe async trait.
 async-trait = "0.1"
@@ -43,3 +65,16 @@ unwrap_used = "warn"
 expect_used = "warn"
 panic = "warn"
 missing_errors_doc = "warn"
+
+[features]
+default = []
+# Git-backed diff snapshots, forwarded to `tinymemory-core`'s own gate. Off by
+# default because it is what drags `git2` / `libgit2-sys` / `libz-sys` — a
+# native build — into the graph. This adapter had no such dependency before
+# issue #18 §C3 lifted the diff family here, and making it unconditional would
+# hand every consumer a libgit2 build they never asked for.
+#
+# The gate reaches `capabilities()`: with the feature off the `Diff` family is
+# neither advertised nor reachable, so `audit_provider` still passes. Advertising
+# a family the build cannot serve is exactly what that audit exists to catch.
+memory-git = ["tinymemory-core/memory-git"]