Summary
Two major PRs have migrated large portions of the codebase into dedicated modules — provider/inference code into tinyagents (PR #4784, merged) and memory engine code into tinycortex (PR #4794, pending merge). Once PR #4794 is merged, three follow-up tasks are required before the migration can be considered complete.
Problem
Module extraction changes the internal boundaries of the codebase. Without explicit validation:
- Memory and inference behaviour may silently regress
- Existing user memory folders (from prior versions) may break on upgrade
- The new modular architecture has no sync connectors for external AI coding tools (Claude Code, Codex, etc.)
Tasks (unblock after PR #4794 merges)
1. Test memory and inference end-to-end
Verify that memory reads, writes, retrieval, and inference calls all work correctly now that the underlying code lives in tinycortex and tinyagents rather than inline in openhuman.
2. Backwards compatibility — existing memory folders must survive upgrade
Users upgrading from a pre-migration build must not lose their memory data or have their existing memory folders broken.
3. Expand memory engine — write sync modules for external connectors
Now that the memory engine lives in tinycortex as a standalone module, build sync adapters so external tools can read/write into it.
Acceptance criteria
- All three task groups above fully checked off
- No user-visible regression in memory or inference on a clean install or upgrade path
- At least two external sync connectors (Claude Code + one other) working against the new tinycortex module
Related
Summary
Two major PRs have migrated large portions of the codebase into dedicated modules — provider/inference code into
tinyagents(PR #4784, merged) and memory engine code intotinycortex(PR #4794, pending merge). Once PR #4794 is merged, three follow-up tasks are required before the migration can be considered complete.Problem
Module extraction changes the internal boundaries of the codebase. Without explicit validation:
Tasks (unblock after PR #4794 merges)
1. Test memory and inference end-to-end
Verify that memory reads, writes, retrieval, and inference calls all work correctly now that the underlying code lives in
tinycortexandtinyagentsrather than inline in openhuman.2. Backwards compatibility — existing memory folders must survive upgrade
Users upgrading from a pre-migration build must not lose their memory data or have their existing memory folders broken.
.openhuman/users/<id>/memory_treefolder structure loads correctly after upgrade3. Expand memory engine — write sync modules for external connectors
Now that the memory engine lives in
tinycortexas a standalone module, build sync adapters so external tools can read/write into it.Acceptance criteria
Related