core-memory 1.1.0__tar.gz → 1.1.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1069) hide show
  1. core_memory-1.1.2/PKG-INFO +453 -0
  2. core_memory-1.1.2/README.md +368 -0
  3. core_memory-1.1.2/core_memory/__init__.py +231 -0
  4. core_memory-1.1.2/core_memory/_version.py +4 -0
  5. core_memory-1.1.2/core_memory/association/__init__.py +4 -0
  6. core_memory-1.1.2/core_memory/association/crawler_contract.py +1104 -0
  7. core_memory-1.1.2/core_memory/association/edge_lifecycle.py +201 -0
  8. core_memory-1.1.2/core_memory/association/health.py +199 -0
  9. core_memory-1.1.2/core_memory/association/preview.py +210 -0
  10. core_memory-1.1.2/core_memory/association/slo.py +182 -0
  11. core_memory-1.1.2/core_memory/claim/conflict_review.py +245 -0
  12. core_memory-1.1.2/core_memory/claim/epistemic.py +66 -0
  13. core_memory-1.1.2/core_memory/claim/extraction.py +312 -0
  14. core_memory-1.1.2/core_memory/claim/registry.py +115 -0
  15. core_memory-1.1.2/core_memory/claim/resolver.py +109 -0
  16. core_memory-1.1.2/core_memory/claim/turn_integration.py +131 -0
  17. core_memory-1.1.2/core_memory/claim/update_policy.py +247 -0
  18. core_memory-1.1.2/core_memory/cli/__init__.py +579 -0
  19. core_memory-1.1.2/core_memory/cli/__main__.py +3 -0
  20. core_memory-1.1.2/core_memory/cli/compat.py +154 -0
  21. core_memory-1.1.2/core_memory/cli/diagnostics.py +198 -0
  22. core_memory-1.1.2/core_memory/cli/handlers/__init__.py +1 -0
  23. core_memory-1.1.2/core_memory/cli/handlers/graph.py +140 -0
  24. core_memory-1.1.2/core_memory/cli/handlers/integrations.py +89 -0
  25. core_memory-1.1.2/core_memory/cli/handlers/memory.py +84 -0
  26. core_memory-1.1.2/core_memory/cli/handlers/metrics.py +158 -0
  27. core_memory-1.1.2/core_memory/cli/handlers/migrate.py +155 -0
  28. core_memory-1.1.2/core_memory/cli/handlers/ops.py +108 -0
  29. core_memory-1.1.2/core_memory/cli/handlers/semantic.py +124 -0
  30. core_memory-1.1.2/core_memory/cli/handlers/setup.py +977 -0
  31. core_memory-1.1.2/core_memory/cli/handlers/store.py +153 -0
  32. core_memory-1.1.2/core_memory/cli/parsers/__init__.py +1 -0
  33. core_memory-1.1.2/core_memory/cli/parsers/extended.py +223 -0
  34. core_memory-1.1.2/core_memory/cli/parsers/memory.py +39 -0
  35. core_memory-1.1.2/core_memory/cli/parsers/ops.py +86 -0
  36. core_memory-1.1.2/core_memory/config/feature_flags.py +199 -0
  37. core_memory-1.1.2/core_memory/config/settings.py +168 -0
  38. core_memory-1.1.2/core_memory/data/incidents.json +21 -0
  39. core_memory-1.1.2/core_memory/data/structural_relation_map.json +10 -0
  40. core_memory-1.1.2/core_memory/data/topic_aliases.json +27 -0
  41. core_memory-1.1.2/core_memory/entity/__init__.py +37 -0
  42. core_memory-1.1.2/core_memory/entity/merge_flow.py +29 -0
  43. core_memory-1.1.2/core_memory/entity/quality.py +60 -0
  44. core_memory-1.1.2/core_memory/entity/registry.py +27 -0
  45. core_memory-1.1.2/core_memory/entity/retrieval.py +155 -0
  46. core_memory-1.1.2/core_memory/entity/speaker_resolver.py +151 -0
  47. core_memory-1.1.2/core_memory/graph/__init__.py +47 -0
  48. core_memory-1.1.2/core_memory/graph/api.py +61 -0
  49. core_memory-1.1.2/core_memory/graph/core.py +1111 -0
  50. core_memory-1.1.2/core_memory/graph/edge_weights.py +213 -0
  51. core_memory-1.1.2/core_memory/graph/junctions.py +496 -0
  52. core_memory-1.1.2/core_memory/graph/roadmap.py +967 -0
  53. core_memory-1.1.2/core_memory/graph/root_cause.py +1380 -0
  54. core_memory-1.1.2/core_memory/graph/semantic.py +65 -0
  55. core_memory-1.1.2/core_memory/graph/storylines.py +162 -0
  56. core_memory-1.1.2/core_memory/graph/structural.py +77 -0
  57. core_memory-1.1.2/core_memory/graph/traversal.py +302 -0
  58. core_memory-1.1.2/core_memory/graph/worldlines.py +246 -0
  59. core_memory-1.1.2/core_memory/identifiers.py +19 -0
  60. core_memory-1.1.2/core_memory/integrations/__init__.py +49 -0
  61. core_memory-1.1.2/core_memory/integrations/api.py +659 -0
  62. core_memory-1.1.2/core_memory/integrations/bead_authoring.py +19 -0
  63. core_memory-1.1.2/core_memory/integrations/crewai/memory.py +188 -0
  64. core_memory-1.1.2/core_memory/integrations/github/__init__.py +3 -0
  65. core_memory-1.1.2/core_memory/integrations/github/connector.py +289 -0
  66. core_memory-1.1.2/core_memory/integrations/http/server.py +2763 -0
  67. core_memory-1.1.2/core_memory/integrations/langchain/memory.py +157 -0
  68. core_memory-1.1.2/core_memory/integrations/mcp/agent_guide.py +65 -0
  69. core_memory-1.1.2/core_memory/integrations/mcp/cli.py +348 -0
  70. core_memory-1.1.2/core_memory/integrations/mcp/constants.py +5 -0
  71. core_memory-1.1.2/core_memory/integrations/mcp/core-memory-agent-guide.md +187 -0
  72. core_memory-1.1.2/core_memory/integrations/mcp/errors.py +35 -0
  73. core_memory-1.1.2/core_memory/integrations/mcp/protocol_server.py +639 -0
  74. core_memory-1.1.2/core_memory/integrations/mcp/registry.py +480 -0
  75. core_memory-1.1.2/core_memory/integrations/mcp/tools/__init__.py +1 -0
  76. core_memory-1.1.2/core_memory/integrations/mcp/tools/capture.py +87 -0
  77. core_memory-1.1.2/core_memory/integrations/mcp/tools/capture_session.py +38 -0
  78. core_memory-1.1.2/core_memory/integrations/mcp/tools/ingest.py +298 -0
  79. core_memory-1.1.2/core_memory/integrations/mcp/tools/ingest_discord.py +172 -0
  80. core_memory-1.1.2/core_memory/integrations/mcp/tools/ingest_slack.py +153 -0
  81. core_memory-1.1.2/core_memory/integrations/mcp/tools/ingest_zoom.py +237 -0
  82. core_memory-1.1.2/core_memory/integrations/mcp/tools/recall.py +11 -0
  83. core_memory-1.1.2/core_memory/integrations/mcp/tools/status.py +80 -0
  84. core_memory-1.1.2/core_memory/integrations/mcp/tools/sync_transcript_snapshot.py +428 -0
  85. core_memory-1.1.2/core_memory/integrations/mcp/tools/transcript_snapshot_state.py +202 -0
  86. core_memory-1.1.2/core_memory/integrations/mcp/typed_read.py +343 -0
  87. core_memory-1.1.2/core_memory/integrations/mcp/typed_write.py +362 -0
  88. core_memory-1.1.2/core_memory/integrations/migration.py +57 -0
  89. core_memory-1.1.2/core_memory/integrations/obsidian/__init__.py +4 -0
  90. core_memory-1.1.2/core_memory/integrations/obsidian/protocol.py +20 -0
  91. core_memory-1.1.2/core_memory/integrations/obsidian/vault.py +164 -0
  92. core_memory-1.1.2/core_memory/integrations/openclaw/__init__.py +13 -0
  93. core_memory-1.1.2/core_memory/integrations/openclaw/agent_end_bridge.py +357 -0
  94. core_memory-1.1.2/core_memory/integrations/openclaw/compaction_bridge.py +81 -0
  95. core_memory-1.1.2/core_memory/integrations/openclaw/compaction_queue.py +58 -0
  96. core_memory-1.1.2/core_memory/integrations/openclaw/flags.py +26 -0
  97. core_memory-1.1.2/core_memory/integrations/openclaw/hosted_capture_bridge.py +309 -0
  98. core_memory-1.1.2/core_memory/integrations/openclaw/onboard.py +240 -0
  99. core_memory-1.1.2/core_memory/integrations/openclaw/read_bridge.py +164 -0
  100. core_memory-1.1.2/core_memory/integrations/openclaw/runtime.py +107 -0
  101. core_memory-1.1.2/core_memory/integrations/pydanticai/__init__.py +32 -0
  102. core_memory-1.1.2/core_memory/integrations/pydanticai/memory_tools.py +409 -0
  103. core_memory-1.1.2/core_memory/integrations/pydanticai/run.py +266 -0
  104. core_memory-1.1.2/core_memory/integrations/pydanticai/semantic_tasks.py +201 -0
  105. core_memory-1.1.2/core_memory/integrations/recall_payload.py +131 -0
  106. core_memory-1.1.2/core_memory/integrations/remote/__init__.py +2 -0
  107. core_memory-1.1.2/core_memory/integrations/remote/semantic_tasks.py +318 -0
  108. core_memory-1.1.2/core_memory/integrations/springai/bridge.py +15 -0
  109. core_memory-1.1.2/core_memory/llm_client.py +81 -0
  110. core_memory-1.1.2/core_memory/management/__init__.py +1491 -0
  111. core_memory-1.1.2/core_memory/memory.py +200 -0
  112. core_memory-1.1.2/core_memory/persistence/backend.py +483 -0
  113. core_memory-1.1.2/core_memory/persistence/bead_hygiene_contract.py +232 -0
  114. core_memory-1.1.2/core_memory/persistence/calibration.py +301 -0
  115. core_memory-1.1.2/core_memory/persistence/dreamer_candidate_store.py +274 -0
  116. core_memory-1.1.2/core_memory/persistence/entity_merge_flow.py +400 -0
  117. core_memory-1.1.2/core_memory/persistence/entity_registry.py +332 -0
  118. core_memory-1.1.2/core_memory/persistence/event_schema_audit.py +226 -0
  119. core_memory-1.1.2/core_memory/persistence/events.py +431 -0
  120. core_memory-1.1.2/core_memory/persistence/failure_patterns.py +75 -0
  121. core_memory-1.1.2/core_memory/persistence/goal_lifecycle_v2.py +224 -0
  122. core_memory-1.1.2/core_memory/persistence/graph/__init__.py +6 -0
  123. core_memory-1.1.2/core_memory/persistence/graph/factory.py +90 -0
  124. core_memory-1.1.2/core_memory/persistence/graph/graphiti_backend.py +295 -0
  125. core_memory-1.1.2/core_memory/persistence/graph/kuzu_backend.py +272 -0
  126. core_memory-1.1.2/core_memory/persistence/graph/neo4j_backend.py +170 -0
  127. core_memory-1.1.2/core_memory/persistence/graph/protocol.py +70 -0
  128. core_memory-1.1.2/core_memory/persistence/junction_roadmap.py +81 -0
  129. core_memory-1.1.2/core_memory/persistence/myelination_manifest.py +90 -0
  130. core_memory-1.1.2/core_memory/persistence/myelination_rewards.py +688 -0
  131. core_memory-1.1.2/core_memory/persistence/promotion_service.py +689 -0
  132. core_memory-1.1.2/core_memory/persistence/retrieval_feedback.py +233 -0
  133. core_memory-1.1.2/core_memory/persistence/semantic_lifecycle.py +194 -0
  134. core_memory-1.1.2/core_memory/persistence/semantic_task_receipts.py +293 -0
  135. core_memory-1.1.2/core_memory/persistence/side_effect_outbox.py +148 -0
  136. core_memory-1.1.2/core_memory/persistence/source_hydration.py +111 -0
  137. core_memory-1.1.2/core_memory/persistence/store.py +834 -0
  138. core_memory-1.1.2/core_memory/persistence/store_add_bead_ops.py +245 -0
  139. core_memory-1.1.2/core_memory/persistence/store_add_helpers.py +160 -0
  140. core_memory-1.1.2/core_memory/persistence/store_approval_ops.py +181 -0
  141. core_memory-1.1.2/core_memory/persistence/store_claim_ops.py +534 -0
  142. core_memory-1.1.2/core_memory/persistence/store_compaction_ops.py +157 -0
  143. core_memory-1.1.2/core_memory/persistence/store_dream_bootstrap_ops.py +44 -0
  144. core_memory-1.1.2/core_memory/persistence/store_failure_ops.py +74 -0
  145. core_memory-1.1.2/core_memory/persistence/store_index_heads_ops.py +50 -0
  146. core_memory-1.1.2/core_memory/persistence/store_lifecycle_ops.py +140 -0
  147. core_memory-1.1.2/core_memory/persistence/store_management_ops.py +890 -0
  148. core_memory-1.1.2/core_memory/persistence/store_projection_ops.py +64 -0
  149. core_memory-1.1.2/core_memory/persistence/store_promotion_ops.py +39 -0
  150. core_memory-1.1.2/core_memory/persistence/store_query.py +74 -0
  151. core_memory-1.1.2/core_memory/persistence/store_relationship_ops.py +232 -0
  152. core_memory-1.1.2/core_memory/persistence/store_text_hygiene_ops.py +140 -0
  153. core_memory-1.1.2/core_memory/persistence/store_validation_helpers.py +220 -0
  154. core_memory-1.1.2/core_memory/persistence/sync_targets.py +33 -0
  155. core_memory-1.1.2/core_memory/persistence/turn_archive.py +309 -0
  156. core_memory-1.1.2/core_memory/policy/association_inference_v21.py +201 -0
  157. core_memory-1.1.2/core_memory/policy/bead_judge.py +483 -0
  158. core_memory-1.1.2/core_memory/policy/bead_typing.py +200 -0
  159. core_memory-1.1.2/core_memory/policy/hygiene.py +182 -0
  160. core_memory-1.1.2/core_memory/policy/promotion.py +9 -0
  161. core_memory-1.1.2/core_memory/policy/promotion_contract.py +9 -0
  162. core_memory-1.1.2/core_memory/policy/rationale.py +280 -0
  163. core_memory-1.1.2/core_memory/policy/semantic_task_runtime.py +385 -0
  164. core_memory-1.1.2/core_memory/policy/semantic_task_verifier.py +298 -0
  165. core_memory-1.1.2/core_memory/policy/turn_memory_authoring.py +401 -0
  166. core_memory-1.1.2/core_memory/provider_config.py +196 -0
  167. core_memory-1.1.2/core_memory/reporting/__init__.py +13 -0
  168. core_memory-1.1.2/core_memory/retrieval/__init__.py +39 -0
  169. core_memory-1.1.2/core_memory/retrieval/adapters/__init__.py +1 -0
  170. core_memory-1.1.2/core_memory/retrieval/adapters/pipehouse_adapter.py +92 -0
  171. core_memory-1.1.2/core_memory/retrieval/agent.py +1012 -0
  172. core_memory-1.1.2/core_memory/retrieval/causal_recall.py +587 -0
  173. core_memory-1.1.2/core_memory/retrieval/chunk_evidence.py +268 -0
  174. core_memory-1.1.2/core_memory/retrieval/contracts.py +419 -0
  175. core_memory-1.1.2/core_memory/retrieval/fanout.py +175 -0
  176. core_memory-1.1.2/core_memory/retrieval/hybrid.py +258 -0
  177. core_memory-1.1.2/core_memory/retrieval/junctions.py +58 -0
  178. core_memory-1.1.2/core_memory/retrieval/lexical.py +297 -0
  179. core_memory-1.1.2/core_memory/retrieval/lifecycle.py +96 -0
  180. core_memory-1.1.2/core_memory/retrieval/pipeline/__init__.py +190 -0
  181. core_memory-1.1.2/core_memory/retrieval/pipeline/canonical.py +1629 -0
  182. core_memory-1.1.2/core_memory/retrieval/rerank.py +344 -0
  183. core_memory-1.1.2/core_memory/retrieval/roadmap.py +109 -0
  184. core_memory-1.1.2/core_memory/retrieval/roadmap_planner.py +873 -0
  185. core_memory-1.1.2/core_memory/retrieval/segments.py +79 -0
  186. core_memory-1.1.2/core_memory/retrieval/semantic_index.py +1810 -0
  187. core_memory-1.1.2/core_memory/retrieval/tools/memory.py +88 -0
  188. core_memory-1.1.2/core_memory/retrieval/vector_backend.py +570 -0
  189. core_memory-1.1.2/core_memory/retrieval/visible_corpus.py +109 -0
  190. core_memory-1.1.2/core_memory/runtime/__init__.py +9 -0
  191. core_memory-1.1.2/core_memory/runtime/associations/__init__.py +29 -0
  192. core_memory-1.1.2/core_memory/runtime/associations/coverage.py +3475 -0
  193. core_memory-1.1.2/core_memory/runtime/dreamer/__init__.py +1 -0
  194. core_memory-1.1.2/core_memory/runtime/dreamer/analysis.py +685 -0
  195. core_memory-1.1.2/core_memory/runtime/dreamer/assembly_depth.py +44 -0
  196. core_memory-1.1.2/core_memory/runtime/dreamer/candidates.py +1188 -0
  197. core_memory-1.1.2/core_memory/runtime/dreamer/convergence.py +209 -0
  198. core_memory-1.1.2/core_memory/runtime/dreamer/eval.py +370 -0
  199. core_memory-1.1.2/core_memory/runtime/dreamer/geometry.py +216 -0
  200. core_memory-1.1.2/core_memory/runtime/dreamer/goal_decay.py +179 -0
  201. core_memory-1.1.2/core_memory/runtime/dreamer/goal_discovery.py +190 -0
  202. core_memory-1.1.2/core_memory/runtime/dreamer/goal_filters.py +47 -0
  203. core_memory-1.1.2/core_memory/runtime/dreamer/identity_value_research.py +132 -0
  204. core_memory-1.1.2/core_memory/runtime/dreamer/longitudinal.py +259 -0
  205. core_memory-1.1.2/core_memory/runtime/dreamer/projection.py +293 -0
  206. core_memory-1.1.2/core_memory/runtime/dreamer/refinement.py +272 -0
  207. core_memory-1.1.2/core_memory/runtime/dreamer/research.py +441 -0
  208. core_memory-1.1.2/core_memory/runtime/dreamer/tension_discovery.py +126 -0
  209. core_memory-1.1.2/core_memory/runtime/engine.py +889 -0
  210. core_memory-1.1.2/core_memory/runtime/event_schemas.py +42 -0
  211. core_memory-1.1.2/core_memory/runtime/flush/__init__.py +1 -0
  212. core_memory-1.1.2/core_memory/runtime/flush/flush_flow.py +374 -0
  213. core_memory-1.1.2/core_memory/runtime/flush/flush_state.py +89 -0
  214. core_memory-1.1.2/core_memory/runtime/goals/__init__.py +21 -0
  215. core_memory-1.1.2/core_memory/runtime/goals/progress.py +863 -0
  216. core_memory-1.1.2/core_memory/runtime/hygiene/__init__.py +5 -0
  217. core_memory-1.1.2/core_memory/runtime/hygiene/seed_backfill.py +188 -0
  218. core_memory-1.1.2/core_memory/runtime/ingest/__init__.py +41 -0
  219. core_memory-1.1.2/core_memory/runtime/ingest/chunk_turns.py +340 -0
  220. core_memory-1.1.2/core_memory/runtime/ingest/data_insight.py +70 -0
  221. core_memory-1.1.2/core_memory/runtime/ingest/external_evidence.py +881 -0
  222. core_memory-1.1.2/core_memory/runtime/ingest/source_envelope.py +292 -0
  223. core_memory-1.1.2/core_memory/runtime/ingest/source_events.py +137 -0
  224. core_memory-1.1.2/core_memory/runtime/observability/__init__.py +8 -0
  225. core_memory-1.1.2/core_memory/runtime/observability/calibration.py +7 -0
  226. core_memory-1.1.2/core_memory/runtime/observability/myelination.py +294 -0
  227. core_memory-1.1.2/core_memory/runtime/observability/myelination_rewards.py +39 -0
  228. core_memory-1.1.2/core_memory/runtime/observability/retrieval_feedback.py +23 -0
  229. core_memory-1.1.2/core_memory/runtime/observability/reviewer_quick_value.py +293 -0
  230. core_memory-1.1.2/core_memory/runtime/observability/self_model_drift.py +226 -0
  231. core_memory-1.1.2/core_memory/runtime/observability/tension_meter.py +208 -0
  232. core_memory-1.1.2/core_memory/runtime/passes/__init__.py +1 -0
  233. core_memory-1.1.2/core_memory/runtime/passes/agent_authored_contract.py +338 -0
  234. core_memory-1.1.2/core_memory/runtime/passes/agent_crawler_invoke.py +156 -0
  235. core_memory-1.1.2/core_memory/runtime/passes/decision_pass.py +33 -0
  236. core_memory-1.1.2/core_memory/runtime/passes/enrichment.py +431 -0
  237. core_memory-1.1.2/core_memory/runtime/post_write/__init__.py +7 -0
  238. core_memory-1.1.2/core_memory/runtime/post_write/bead_commit.py +136 -0
  239. core_memory-1.1.2/core_memory/runtime/queue/__init__.py +1 -0
  240. core_memory-1.1.2/core_memory/runtime/queue/jobs.py +393 -0
  241. core_memory-1.1.2/core_memory/runtime/queue/side_effect_queue.py +700 -0
  242. core_memory-1.1.2/core_memory/runtime/queue/side_effects.py +145 -0
  243. core_memory-1.1.2/core_memory/runtime/queue/worker.py +113 -0
  244. core_memory-1.1.2/core_memory/runtime/semantic_tasks/__init__.py +46 -0
  245. core_memory-1.1.2/core_memory/runtime/semantic_tasks/contracts.py +55 -0
  246. core_memory-1.1.2/core_memory/runtime/semantic_tasks/receipts.py +21 -0
  247. core_memory-1.1.2/core_memory/runtime/semantic_tasks/runtime.py +25 -0
  248. core_memory-1.1.2/core_memory/runtime/semantic_tasks/verifier.py +7 -0
  249. core_memory-1.1.2/core_memory/runtime/session/__init__.py +1 -0
  250. core_memory-1.1.2/core_memory/runtime/session/goal_lifecycle.py +138 -0
  251. core_memory-1.1.2/core_memory/runtime/session/live_session.py +53 -0
  252. core_memory-1.1.2/core_memory/runtime/session/session_enrichment_delta.py +955 -0
  253. core_memory-1.1.2/core_memory/runtime/session/session_start_flow.py +171 -0
  254. core_memory-1.1.2/core_memory/runtime/state.py +340 -0
  255. core_memory-1.1.2/core_memory/runtime/turn/__init__.py +1 -0
  256. core_memory-1.1.2/core_memory/runtime/turn/ingress.py +217 -0
  257. core_memory-1.1.2/core_memory/runtime/turn/reauthoring.py +1156 -0
  258. core_memory-1.1.2/core_memory/runtime/turn/receipt.py +289 -0
  259. core_memory-1.1.2/core_memory/runtime/turn/semantic_state.py +386 -0
  260. core_memory-1.1.2/core_memory/runtime/turn/turn_flow.py +582 -0
  261. core_memory-1.1.2/core_memory/runtime/turn/turn_prep.py +154 -0
  262. core_memory-1.1.2/core_memory/runtime/turn/turn_quality.py +75 -0
  263. core_memory-1.1.2/core_memory/schema/__init__.py +3 -0
  264. core_memory-1.1.2/core_memory/schema/agent_authored_updates.py +687 -0
  265. core_memory-1.1.2/core_memory/schema/agent_authoring_spec.py +90 -0
  266. core_memory-1.1.2/core_memory/schema/bead_projection.py +148 -0
  267. core_memory-1.1.2/core_memory/schema/event_schemas.py +41 -0
  268. core_memory-1.1.2/core_memory/schema/models.py +901 -0
  269. core_memory-1.1.2/core_memory/schema/normalization.py +646 -0
  270. core_memory-1.1.2/core_memory/schema/promotion.py +404 -0
  271. core_memory-1.1.2/core_memory/schema/promotion_contract.py +50 -0
  272. core_memory-1.1.2/core_memory/schema/semantic_tasks.py +183 -0
  273. core_memory-1.1.2/core_memory/schema/storyline_overlay.py +101 -0
  274. core_memory-1.1.2/core_memory/schema/turn.py +138 -0
  275. core_memory-1.1.2/core_memory/schema/turn_receipt.py +96 -0
  276. core_memory-1.1.2/core_memory/soul/__init__.py +61 -0
  277. core_memory-1.1.2/core_memory/soul/assembly_depth.py +239 -0
  278. core_memory-1.1.2/core_memory/soul/dreamer_bridge.py +796 -0
  279. core_memory-1.1.2/core_memory/soul/goals.py +195 -0
  280. core_memory-1.1.2/core_memory/soul/identity_value_signals.py +150 -0
  281. core_memory-1.1.2/core_memory/soul/injection.py +105 -0
  282. core_memory-1.1.2/core_memory/soul/integrity.py +190 -0
  283. core_memory-1.1.2/core_memory/soul/store.py +488 -0
  284. core_memory-1.1.2/core_memory/soul/summary.py +1178 -0
  285. core_memory-1.1.2/core_memory/soul/tension_signals.py +89 -0
  286. core_memory-1.1.2/core_memory/transcript_ingest.py +609 -0
  287. core_memory-1.1.2/core_memory/write_pipeline/rolling_window.py +347 -0
  288. core_memory-1.1.2/core_memory/write_pipeline/tokenizer.py +126 -0
  289. core_memory-1.1.2/core_memory.egg-info/PKG-INFO +453 -0
  290. core_memory-1.1.2/core_memory.egg-info/SOURCES.txt +776 -0
  291. core_memory-1.1.2/core_memory.egg-info/requires.txt +82 -0
  292. core_memory-1.1.2/pyproject.toml +107 -0
  293. core_memory-1.1.2/tests/test_adapter_boundary_pydanticai.py +88 -0
  294. core_memory-1.1.2/tests/test_adapter_contract_markers.py +23 -0
  295. core_memory-1.1.2/tests/test_adapter_parity_matrix_contract.py +291 -0
  296. core_memory-1.1.2/tests/test_agent_authored_contract_flags.py +67 -0
  297. core_memory-1.1.2/tests/test_agent_authored_contract_validation.py +264 -0
  298. core_memory-1.1.2/tests/test_agent_authored_runtime_gate.py +441 -0
  299. core_memory-1.1.2/tests/test_agent_authored_typed_ingress.py +423 -0
  300. core_memory-1.1.2/tests/test_agent_crawler_invoke.py +114 -0
  301. core_memory-1.1.2/tests/test_agent_led_write_integrity.py +292 -0
  302. core_memory-1.1.2/tests/test_agentic_traversal_prereqs.py +184 -0
  303. core_memory-1.1.2/tests/test_approval_workflow.py +158 -0
  304. core_memory-1.1.2/tests/test_architecture_guards.py +230 -0
  305. core_memory-1.1.2/tests/test_assembly_depth.py +137 -0
  306. core_memory-1.1.2/tests/test_association_classifier_fallback.py +191 -0
  307. core_memory-1.1.2/tests/test_association_confidence_compat.py +38 -0
  308. core_memory-1.1.2/tests/test_association_coverage.py +1499 -0
  309. core_memory-1.1.2/tests/test_association_crawler_contract.py +357 -0
  310. core_memory-1.1.2/tests/test_association_health.py +174 -0
  311. core_memory-1.1.2/tests/test_association_inference_v21_contract.py +92 -0
  312. core_memory-1.1.2/tests/test_association_pass_strengthened.py +171 -0
  313. core_memory-1.1.2/tests/test_association_quality_policy.py +108 -0
  314. core_memory-1.1.2/tests/test_association_slo.py +102 -0
  315. core_memory-1.1.2/tests/test_authority_enforcement.py +59 -0
  316. core_memory-1.1.2/tests/test_auto_archive_hold.py +28 -0
  317. core_memory-1.1.2/tests/test_backend_capabilities.py +132 -0
  318. core_memory-1.1.2/tests/test_backfill_causal_links.py +35 -0
  319. core_memory-1.1.2/tests/test_backfill_causal_links_targeted.py +30 -0
  320. core_memory-1.1.2/tests/test_bead_field_judge.py +384 -0
  321. core_memory-1.1.2/tests/test_bead_projection.py +96 -0
  322. core_memory-1.1.2/tests/test_bead_session_id.py +55 -0
  323. core_memory-1.1.2/tests/test_bead_storyline_goal_quality.py +495 -0
  324. core_memory-1.1.2/tests/test_bead_titles.py +78 -0
  325. core_memory-1.1.2/tests/test_bead_typing_semantic_task.py +123 -0
  326. core_memory-1.1.2/tests/test_benchmark_locomo_like.py +221 -0
  327. core_memory-1.1.2/tests/test_both_valid_resolution.py +500 -0
  328. core_memory-1.1.2/tests/test_canonical_hydration_contract.py +163 -0
  329. core_memory-1.1.2/tests/test_canonical_metadata_filters.py +97 -0
  330. core_memory-1.1.2/tests/test_canonical_path_enforcement.py +49 -0
  331. core_memory-1.1.2/tests/test_capture_recall_aliases.py +150 -0
  332. core_memory-1.1.2/tests/test_causal_benchmark.py +295 -0
  333. core_memory-1.1.2/tests/test_causal_continuity_benchmark.py +1040 -0
  334. core_memory-1.1.2/tests/test_causal_pipeline_ungating.py +180 -0
  335. core_memory-1.1.2/tests/test_causal_recall_pipeline.py +236 -0
  336. core_memory-1.1.2/tests/test_causal_segments.py +333 -0
  337. core_memory-1.1.2/tests/test_centrality_r3.py +36 -0
  338. core_memory-1.1.2/tests/test_chunk_evidence_retrieval.py +267 -0
  339. core_memory-1.1.2/tests/test_chunk_turn_ingest.py +177 -0
  340. core_memory-1.1.2/tests/test_claim_flags.py +51 -0
  341. core_memory-1.1.2/tests/test_claim_grounding_dedup.py +178 -0
  342. core_memory-1.1.2/tests/test_claim_turn_integration.py +98 -0
  343. core_memory-1.1.2/tests/test_claim_update_policy.py +279 -0
  344. core_memory-1.1.2/tests/test_cli_compat_module.py +88 -0
  345. core_memory-1.1.2/tests/test_cli_diagnostics.py +35 -0
  346. core_memory-1.1.2/tests/test_cli_dreamer_candidates.py +68 -0
  347. core_memory-1.1.2/tests/test_cli_grouped_surface.py +149 -0
  348. core_memory-1.1.2/tests/test_cli_handler_modules.py +136 -0
  349. core_memory-1.1.2/tests/test_cli_integration_handlers.py +43 -0
  350. core_memory-1.1.2/tests/test_cli_ops_split.py +19 -0
  351. core_memory-1.1.2/tests/test_cli_parser_extended.py +80 -0
  352. core_memory-1.1.2/tests/test_cli_semantic.py +85 -0
  353. core_memory-1.1.2/tests/test_compaction_queue_bridge.py +36 -0
  354. core_memory-1.1.2/tests/test_conflict_review.py +301 -0
  355. core_memory-1.1.2/tests/test_crewai_memory_save.py +48 -0
  356. core_memory-1.1.2/tests/test_data_insight_ingest.py +142 -0
  357. core_memory-1.1.2/tests/test_demo_transcript_ingest.py +206 -0
  358. core_memory-1.1.2/tests/test_deterministic_semantic_authority.py +81 -0
  359. core_memory-1.1.2/tests/test_dreamer_analysis.py +122 -0
  360. core_memory-1.1.2/tests/test_dreamer_candidate_families_dv2.py +268 -0
  361. core_memory-1.1.2/tests/test_dreamer_candidates.py +129 -0
  362. core_memory-1.1.2/tests/test_dreamer_eval.py +200 -0
  363. core_memory-1.1.2/tests/test_dreamer_geometry.py +146 -0
  364. core_memory-1.1.2/tests/test_dreamer_identity_value.py +140 -0
  365. core_memory-1.1.2/tests/test_dreamer_research.py +226 -0
  366. core_memory-1.1.2/tests/test_dreamer_theme_synthesis.py +402 -0
  367. core_memory-1.1.2/tests/test_e2e_lifecycle_query.py +76 -0
  368. core_memory-1.1.2/tests/test_e2e_program_scenarios.py +187 -0
  369. core_memory-1.1.2/tests/test_e2e_sidecar_per_turn.py +49 -0
  370. core_memory-1.1.2/tests/test_edge_lifecycle.py +243 -0
  371. core_memory-1.1.2/tests/test_edge_weights.py +239 -0
  372. core_memory-1.1.2/tests/test_effort_tiers_and_association_hops.py +405 -0
  373. core_memory-1.1.2/tests/test_enforcement_matrix.py +97 -0
  374. core_memory-1.1.2/tests/test_engine_invariants.py +116 -0
  375. core_memory-1.1.2/tests/test_enrichment_slice_b.py +163 -0
  376. core_memory-1.1.2/tests/test_entity_persistence_boundaries.py +61 -0
  377. core_memory-1.1.2/tests/test_epistemic_conflict.py +322 -0
  378. core_memory-1.1.2/tests/test_evaluate_candidates.py +34 -0
  379. core_memory-1.1.2/tests/test_event_import_migration_guard.py +110 -0
  380. core_memory-1.1.2/tests/test_event_module_aliases.py +22 -0
  381. core_memory-1.1.2/tests/test_event_schema_audit.py +125 -0
  382. core_memory-1.1.2/tests/test_external_evidence.py +330 -0
  383. core_memory-1.1.2/tests/test_external_versioning_and_confidence.py +522 -0
  384. core_memory-1.1.2/tests/test_f_r2_hash_vector_determinism.py +297 -0
  385. core_memory-1.1.2/tests/test_f_rw1_tokenizer.py +178 -0
  386. core_memory-1.1.2/tests/test_f_rw2_selection_score.py +232 -0
  387. core_memory-1.1.2/tests/test_f_s1_validity_collapse.py +95 -0
  388. core_memory-1.1.2/tests/test_f_w1_enrichment_queue.py +373 -0
  389. core_memory-1.1.2/tests/test_f_w2_gate_severity.py +82 -0
  390. core_memory-1.1.2/tests/test_fanout.py +276 -0
  391. core_memory-1.1.2/tests/test_flush_async_side_effects.py +125 -0
  392. core_memory-1.1.2/tests/test_flush_cycle_guard.py +63 -0
  393. core_memory-1.1.2/tests/test_flush_report_artifact.py +52 -0
  394. core_memory-1.1.2/tests/test_flush_sequence_trace.py +27 -0
  395. core_memory-1.1.2/tests/test_future_projection.py +147 -0
  396. core_memory-1.1.2/tests/test_github_connector.py +234 -0
  397. core_memory-1.1.2/tests/test_goal_decay.py +162 -0
  398. core_memory-1.1.2/tests/test_goal_discovery.py +107 -0
  399. core_memory-1.1.2/tests/test_goal_lifecycle.py +126 -0
  400. core_memory-1.1.2/tests/test_goal_lifecycle_v2.py +163 -0
  401. core_memory-1.1.2/tests/test_goal_progress.py +358 -0
  402. core_memory-1.1.2/tests/test_graph_active_association_view_regressions.py +228 -0
  403. core_memory-1.1.2/tests/test_graph_backend_capabilities.py +105 -0
  404. core_memory-1.1.2/tests/test_graph_backend_factory.py +88 -0
  405. core_memory-1.1.2/tests/test_graph_backend_neo4j_parity.py +300 -0
  406. core_memory-1.1.2/tests/test_graph_backend_protocol.py +58 -0
  407. core_memory-1.1.2/tests/test_graph_r2.py +43 -0
  408. core_memory-1.1.2/tests/test_graphiti_backend.py +217 -0
  409. core_memory-1.1.2/tests/test_group_transcript_ingest.py +270 -0
  410. core_memory-1.1.2/tests/test_hard_agent_authorship.py +389 -0
  411. core_memory-1.1.2/tests/test_http_contract_async_ops.py +63 -0
  412. core_memory-1.1.2/tests/test_http_dreamer_candidates.py +84 -0
  413. core_memory-1.1.2/tests/test_http_dreamer_geometry.py +76 -0
  414. core_memory-1.1.2/tests/test_http_goal_progress.py +66 -0
  415. core_memory-1.1.2/tests/test_http_ingress.py +640 -0
  416. core_memory-1.1.2/tests/test_http_inspect_endpoints.py +62 -0
  417. core_memory-1.1.2/tests/test_http_mcp_typed_writes.py +140 -0
  418. core_memory-1.1.2/tests/test_http_myelination.py +106 -0
  419. core_memory-1.1.2/tests/test_http_recall_endpoint.py +195 -0
  420. core_memory-1.1.2/tests/test_http_soul_endpoints_complete.py +111 -0
  421. core_memory-1.1.2/tests/test_http_soul_goals.py +62 -0
  422. core_memory-1.1.2/tests/test_http_soul_integrity.py +43 -0
  423. core_memory-1.1.2/tests/test_idempotency_effects.py +50 -0
  424. core_memory-1.1.2/tests/test_ingest_adapters.py +446 -0
  425. core_memory-1.1.2/tests/test_init_wizard.py +556 -0
  426. core_memory-1.1.2/tests/test_inspect_api.py +66 -0
  427. core_memory-1.1.2/tests/test_integrations_api.py +65 -0
  428. core_memory-1.1.2/tests/test_junction_projection.py +257 -0
  429. core_memory-1.1.2/tests/test_junction_roadmap.py +591 -0
  430. core_memory-1.1.2/tests/test_kuzu_graph_backend.py +150 -0
  431. core_memory-1.1.2/tests/test_lexical_field_weights.py +69 -0
  432. core_memory-1.1.2/tests/test_llm_client.py +82 -0
  433. core_memory-1.1.2/tests/test_locomo_benchmark.py +261 -0
  434. core_memory-1.1.2/tests/test_longitudinal_benchmark_v2.py +129 -0
  435. core_memory-1.1.2/tests/test_mcp_agent_guide.py +60 -0
  436. core_memory-1.1.2/tests/test_mcp_capture_handler.py +44 -0
  437. core_memory-1.1.2/tests/test_mcp_cli.py +79 -0
  438. core_memory-1.1.2/tests/test_mcp_ingest_handler.py +374 -0
  439. core_memory-1.1.2/tests/test_mcp_mount_static.py +36 -0
  440. core_memory-1.1.2/tests/test_mcp_protocol_client_smoke.py +79 -0
  441. core_memory-1.1.2/tests/test_mcp_protocol_scaffold.py +46 -0
  442. core_memory-1.1.2/tests/test_mcp_protocol_server_live.py +82 -0
  443. core_memory-1.1.2/tests/test_mcp_status_recall_handlers.py +54 -0
  444. core_memory-1.1.2/tests/test_mcp_typed_writes.py +187 -0
  445. core_memory-1.1.2/tests/test_memory_engine.py +76 -0
  446. core_memory-1.1.2/tests/test_memory_management.py +926 -0
  447. core_memory-1.1.2/tests/test_memory_quality_meters.py +356 -0
  448. core_memory-1.1.2/tests/test_memory_search_smoke_eval.py +34 -0
  449. core_memory-1.1.2/tests/test_memory_store_public_boundary_contract.py +99 -0
  450. core_memory-1.1.2/tests/test_metrics_dreamer_eval_cli.py +59 -0
  451. core_memory-1.1.2/tests/test_metrics_longitudinal_cli.py +60 -0
  452. core_memory-1.1.2/tests/test_metrics_myelination_cli.py +67 -0
  453. core_memory-1.1.2/tests/test_migration.py +58 -0
  454. core_memory-1.1.2/tests/test_multi_source_seeding.py +286 -0
  455. core_memory-1.1.2/tests/test_myelination_experiment.py +91 -0
  456. core_memory-1.1.2/tests/test_myelination_manifest_read.py +55 -0
  457. core_memory-1.1.2/tests/test_myelination_rewards.py +752 -0
  458. core_memory-1.1.2/tests/test_myelination_wiring.py +224 -0
  459. core_memory-1.1.2/tests/test_neo4j_live.py +98 -0
  460. core_memory-1.1.2/tests/test_neo4j_shadow_guardrails.py +70 -0
  461. core_memory-1.1.2/tests/test_obsidian_sync_target.py +141 -0
  462. core_memory-1.1.2/tests/test_openclaw_agent_end_bridge.py +60 -0
  463. core_memory-1.1.2/tests/test_openclaw_flags.py +115 -0
  464. core_memory-1.1.2/tests/test_openclaw_hosted_capture_bridge.py +94 -0
  465. core_memory-1.1.2/tests/test_openclaw_integration.py +59 -0
  466. core_memory-1.1.2/tests/test_openclaw_plugin_modules.py +67 -0
  467. core_memory-1.1.2/tests/test_openclaw_read_bridge.py +112 -0
  468. core_memory-1.1.2/tests/test_operational_event.py +137 -0
  469. core_memory-1.1.2/tests/test_package_root_public_surface.py +86 -0
  470. core_memory-1.1.2/tests/test_persistence_encryption_compat.py +87 -0
  471. core_memory-1.1.2/tests/test_pre_oss_matrix.py +36 -0
  472. core_memory-1.1.2/tests/test_process_flush_checkpoint_bead.py +74 -0
  473. core_memory-1.1.2/tests/test_provider_config.py +55 -0
  474. core_memory-1.1.2/tests/test_provider_dependencies.py +45 -0
  475. core_memory-1.1.2/tests/test_public_generic_naming.py +74 -0
  476. core_memory-1.1.2/tests/test_pydanticai_adapter.py +109 -0
  477. core_memory-1.1.2/tests/test_pydanticai_memory_tools.py +310 -0
  478. core_memory-1.1.2/tests/test_pydanticai_semantic_tasks.py +156 -0
  479. core_memory-1.1.2/tests/test_pypi_mcp_verification.py +23 -0
  480. core_memory-1.1.2/tests/test_qdrant_embedded_backend.py +127 -0
  481. core_memory-1.1.2/tests/test_qdrant_external_embeddings.py +233 -0
  482. core_memory-1.1.2/tests/test_r3_graph_semantic.py +64 -0
  483. core_memory-1.1.2/tests/test_rationale_extraction.py +291 -0
  484. core_memory-1.1.2/tests/test_recall_as_of.py +148 -0
  485. core_memory-1.1.2/tests/test_recall_orchestrator.py +160 -0
  486. core_memory-1.1.2/tests/test_recall_result_contract.py +199 -0
  487. core_memory-1.1.2/tests/test_recording_source_attribution_e2e.py +317 -0
  488. core_memory-1.1.2/tests/test_release_surface_consistency.py +79 -0
  489. core_memory-1.1.2/tests/test_remote_semantic_tasks.py +191 -0
  490. core_memory-1.1.2/tests/test_req_judge_directive.py +97 -0
  491. core_memory-1.1.2/tests/test_retrieval_e2e_qdrant_kuzu.py +425 -0
  492. core_memory-1.1.2/tests/test_retrieval_feedback_dv2.py +126 -0
  493. core_memory-1.1.2/tests/test_retrieval_parity_and_hydration.py +93 -0
  494. core_memory-1.1.2/tests/test_retrieval_semantic_backend.py +78 -0
  495. core_memory-1.1.2/tests/test_reviewer_quick_value_v2.py +40 -0
  496. core_memory-1.1.2/tests/test_roadmap_planner.py +563 -0
  497. core_memory-1.1.2/tests/test_root_cause_trace.py +65 -0
  498. core_memory-1.1.2/tests/test_runtime_association_pass.py +37 -0
  499. core_memory-1.1.2/tests/test_runtime_decision_pass.py +19 -0
  500. core_memory-1.1.2/tests/test_runtime_engine_boundaries.py +55 -0
  501. core_memory-1.1.2/tests/test_runtime_jobs.py +93 -0
  502. core_memory-1.1.2/tests/test_runtime_jobs_enqueue.py +84 -0
  503. core_memory-1.1.2/tests/test_runtime_jobs_layering.py +22 -0
  504. core_memory-1.1.2/tests/test_runtime_jobs_run.py +69 -0
  505. core_memory-1.1.2/tests/test_runtime_side_effect_queue.py +186 -0
  506. core_memory-1.1.2/tests/test_runtime_split_modules.py +65 -0
  507. core_memory-1.1.2/tests/test_schema_models_normalization.py +81 -0
  508. core_memory-1.1.2/tests/test_schema_normalization.py +64 -0
  509. core_memory-1.1.2/tests/test_seed_quality_backfill.py +133 -0
  510. core_memory-1.1.2/tests/test_semantic_active_k.py +32 -0
  511. core_memory-1.1.2/tests/test_semantic_autodrain.py +186 -0
  512. core_memory-1.1.2/tests/test_semantic_backend_abstraction.py +121 -0
  513. core_memory-1.1.2/tests/test_semantic_backend_docs.py +36 -0
  514. core_memory-1.1.2/tests/test_semantic_backend_modes.py +41 -0
  515. core_memory-1.1.2/tests/test_semantic_cached_embeddings.py +75 -0
  516. core_memory-1.1.2/tests/test_semantic_doctor.py +132 -0
  517. core_memory-1.1.2/tests/test_semantic_lifecycle_boundaries.py +45 -0
  518. core_memory-1.1.2/tests/test_semantic_reauthoring.py +577 -0
  519. core_memory-1.1.2/tests/test_semantic_required_mode_contract.py +121 -0
  520. core_memory-1.1.2/tests/test_semantic_required_mode_provider_regression.py +94 -0
  521. core_memory-1.1.2/tests/test_semantic_task_boundary_compat.py +20 -0
  522. core_memory-1.1.2/tests/test_semantic_task_contracts.py +10 -0
  523. core_memory-1.1.2/tests/test_semantic_task_runtime.py +338 -0
  524. core_memory-1.1.2/tests/test_semantic_task_verifier.py +132 -0
  525. core_memory-1.1.2/tests/test_semantic_write_receipts.py +356 -0
  526. core_memory-1.1.2/tests/test_session_enrichment_delta.py +986 -0
  527. core_memory-1.1.2/tests/test_session_first_write_authority.py +44 -0
  528. core_memory-1.1.2/tests/test_session_purity_invariants.py +63 -0
  529. core_memory-1.1.2/tests/test_session_surface.py +21 -0
  530. core_memory-1.1.2/tests/test_sidecar_contracts.py +40 -0
  531. core_memory-1.1.2/tests/test_sidecar_hook.py +69 -0
  532. core_memory-1.1.2/tests/test_sidecar_sync_session_semantics.py +33 -0
  533. core_memory-1.1.2/tests/test_sidecar_worker.py +58 -0
  534. core_memory-1.1.2/tests/test_soul_apply_update.py +100 -0
  535. core_memory-1.1.2/tests/test_soul_dreamer_bridge.py +339 -0
  536. core_memory-1.1.2/tests/test_soul_dreamer_endpoints.py +63 -0
  537. core_memory-1.1.2/tests/test_soul_goals.py +141 -0
  538. core_memory-1.1.2/tests/test_soul_injection.py +189 -0
  539. core_memory-1.1.2/tests/test_soul_integrity.py +156 -0
  540. core_memory-1.1.2/tests/test_soul_proposal_semantic_task.py +206 -0
  541. core_memory-1.1.2/tests/test_soul_store.py +249 -0
  542. core_memory-1.1.2/tests/test_soul_summary.py +425 -0
  543. core_memory-1.1.2/tests/test_speaker_attribution.py +257 -0
  544. core_memory-1.1.2/tests/test_store_add_bead_side_effects.py +51 -0
  545. core_memory-1.1.2/tests/test_store_claim_ops.py +330 -0
  546. core_memory-1.1.2/tests/test_store_dream_bootstrap_ops_delegation.py +34 -0
  547. core_memory-1.1.2/tests/test_store_hygiene_behavior.py +27 -0
  548. core_memory-1.1.2/tests/test_store_integrity.py +57 -0
  549. core_memory-1.1.2/tests/test_store_json_diagnostics.py +25 -0
  550. core_memory-1.1.2/tests/test_store_reporting_boundaries.py +15 -0
  551. core_memory-1.1.2/tests/test_storylines.py +336 -0
  552. core_memory-1.1.2/tests/test_structural_features_radius1.py +36 -0
  553. core_memory-1.1.2/tests/test_structural_inference_hardening.py +56 -0
  554. core_memory-1.1.2/tests/test_supersession_guards.py +29 -0
  555. core_memory-1.1.2/tests/test_sync_structural_pipeline.py +50 -0
  556. core_memory-1.1.2/tests/test_tension_discovery.py +142 -0
  557. core_memory-1.1.2/tests/test_test_suite_health_guard.py +153 -0
  558. core_memory-1.1.2/tests/test_trace_depth_api.py +57 -0
  559. core_memory-1.1.2/tests/test_trace_results_include_chain_nodes.py +56 -0
  560. core_memory-1.1.2/tests/test_transcript_ingest_surfaces.py +255 -0
  561. core_memory-1.1.2/tests/test_trigger_authority_markers.py +24 -0
  562. core_memory-1.1.2/tests/test_trigger_orchestrator.py +41 -0
  563. core_memory-1.1.2/tests/test_trigger_orchestrator_flush.py +39 -0
  564. core_memory-1.1.2/tests/test_trigger_orchestrator_flush_recovery.py +39 -0
  565. core_memory-1.1.2/tests/test_turn_archive.py +141 -0
  566. core_memory-1.1.2/tests/test_turn_archive_get_turn.py +42 -0
  567. core_memory-1.1.2/tests/test_turn_association_visibility.py +51 -0
  568. core_memory-1.1.2/tests/test_turn_decision_pass.py +83 -0
  569. core_memory-1.1.2/tests/test_turn_event_to_retrieval_contract.py +71 -0
  570. core_memory-1.1.2/tests/test_turn_hydration.py +75 -0
  571. core_memory-1.1.2/tests/test_turn_memory_authoring.py +207 -0
  572. core_memory-1.1.2/tests/test_turn_schema_capture.py +123 -0
  573. core_memory-1.1.2/tests/test_vector_embedding_reads.py +68 -0
  574. core_memory-1.1.2/tests/test_worldline_derivation.py +197 -0
  575. core_memory-1.1.0/PKG-INFO +0 -617
  576. core_memory-1.1.0/README.md +0 -550
  577. core_memory-1.1.0/core_memory/__init__.py +0 -61
  578. core_memory-1.1.0/core_memory/_version.py +0 -4
  579. core_memory-1.1.0/core_memory/association/__init__.py +0 -4
  580. core_memory-1.1.0/core_memory/association/crawler_contract.py +0 -707
  581. core_memory-1.1.0/core_memory/association/health.py +0 -71
  582. core_memory-1.1.0/core_memory/association/preview.py +0 -88
  583. core_memory-1.1.0/core_memory/association/slo.py +0 -159
  584. core_memory-1.1.0/core_memory/claim/extraction.py +0 -273
  585. core_memory-1.1.0/core_memory/claim/registry.py +0 -112
  586. core_memory-1.1.0/core_memory/claim/resolver.py +0 -104
  587. core_memory-1.1.0/core_memory/claim/turn_integration.py +0 -78
  588. core_memory-1.1.0/core_memory/claim/update_policy.py +0 -185
  589. core_memory-1.1.0/core_memory/cli.py +0 -386
  590. core_memory-1.1.0/core_memory/cli_compat.py +0 -147
  591. core_memory-1.1.0/core_memory/cli_diagnostics.py +0 -156
  592. core_memory-1.1.0/core_memory/cli_handlers_graph.py +0 -114
  593. core_memory-1.1.0/core_memory/cli_handlers_integrations.py +0 -91
  594. core_memory-1.1.0/core_memory/cli_handlers_metrics.py +0 -158
  595. core_memory-1.1.0/core_memory/cli_handlers_ops.py +0 -108
  596. core_memory-1.1.0/core_memory/cli_handlers_store.py +0 -156
  597. core_memory-1.1.0/core_memory/cli_memory_handlers.py +0 -64
  598. core_memory-1.1.0/core_memory/cli_parser_extended.py +0 -212
  599. core_memory-1.1.0/core_memory/cli_parser_memory.py +0 -32
  600. core_memory-1.1.0/core_memory/cli_parser_ops.py +0 -71
  601. core_memory-1.1.0/core_memory/dreamer.py +0 -526
  602. core_memory-1.1.0/core_memory/entity/__init__.py +0 -35
  603. core_memory-1.1.0/core_memory/entity/merge_flow.py +0 -400
  604. core_memory-1.1.0/core_memory/entity/registry.py +0 -216
  605. core_memory-1.1.0/core_memory/entity/retrieval.py +0 -121
  606. core_memory-1.1.0/core_memory/graph/__init__.py +0 -4
  607. core_memory-1.1.0/core_memory/graph/_api_impl.py +0 -1075
  608. core_memory-1.1.0/core_memory/graph/api.py +0 -60
  609. core_memory-1.1.0/core_memory/graph/semantic.py +0 -65
  610. core_memory-1.1.0/core_memory/graph/structural.py +0 -60
  611. core_memory-1.1.0/core_memory/graph/traversal.py +0 -241
  612. core_memory-1.1.0/core_memory/integrations/__init__.py +0 -44
  613. core_memory-1.1.0/core_memory/integrations/api.py +0 -600
  614. core_memory-1.1.0/core_memory/integrations/crewai/memory.py +0 -167
  615. core_memory-1.1.0/core_memory/integrations/http/server.py +0 -856
  616. core_memory-1.1.0/core_memory/integrations/langchain/memory.py +0 -135
  617. core_memory-1.1.0/core_memory/integrations/mcp/typed_read.py +0 -324
  618. core_memory-1.1.0/core_memory/integrations/mcp/typed_write.py +0 -173
  619. core_memory-1.1.0/core_memory/integrations/migration.py +0 -58
  620. core_memory-1.1.0/core_memory/integrations/openclaw_agent_end_bridge.py +0 -342
  621. core_memory-1.1.0/core_memory/integrations/openclaw_compaction_bridge.py +0 -81
  622. core_memory-1.1.0/core_memory/integrations/openclaw_compaction_queue.py +0 -58
  623. core_memory-1.1.0/core_memory/integrations/openclaw_flags.py +0 -183
  624. core_memory-1.1.0/core_memory/integrations/openclaw_onboard.py +0 -85
  625. core_memory-1.1.0/core_memory/integrations/openclaw_read_bridge.py +0 -164
  626. core_memory-1.1.0/core_memory/integrations/openclaw_runtime.py +0 -101
  627. core_memory-1.1.0/core_memory/integrations/pydanticai/__init__.py +0 -28
  628. core_memory-1.1.0/core_memory/integrations/pydanticai/memory_tools.py +0 -332
  629. core_memory-1.1.0/core_memory/integrations/pydanticai/run.py +0 -236
  630. core_memory-1.1.0/core_memory/integrations/springai/bridge.py +0 -15
  631. core_memory-1.1.0/core_memory/persistence/backend.py +0 -383
  632. core_memory-1.1.0/core_memory/persistence/events.py +0 -328
  633. core_memory-1.1.0/core_memory/persistence/promotion_service.py +0 -451
  634. core_memory-1.1.0/core_memory/persistence/store.py +0 -77
  635. core_memory-1.1.0/core_memory/persistence/store_add_bead_ops.py +0 -196
  636. core_memory-1.1.0/core_memory/persistence/store_add_helpers.py +0 -155
  637. core_memory-1.1.0/core_memory/persistence/store_claim_ops.py +0 -339
  638. core_memory-1.1.0/core_memory/persistence/store_compaction_ops.py +0 -201
  639. core_memory-1.1.0/core_memory/persistence/store_core_delegates_mixin.py +0 -505
  640. core_memory-1.1.0/core_memory/persistence/store_dream_bootstrap_ops.py +0 -59
  641. core_memory-1.1.0/core_memory/persistence/store_failure_ops.py +0 -74
  642. core_memory-1.1.0/core_memory/persistence/store_index_heads_ops.py +0 -50
  643. core_memory-1.1.0/core_memory/persistence/store_lifecycle_ops.py +0 -22
  644. core_memory-1.1.0/core_memory/persistence/store_projection_ops.py +0 -64
  645. core_memory-1.1.0/core_memory/persistence/store_promotion_ops.py +0 -120
  646. core_memory-1.1.0/core_memory/persistence/store_query.py +0 -74
  647. core_memory-1.1.0/core_memory/persistence/store_relationship_ops.py +0 -152
  648. core_memory-1.1.0/core_memory/persistence/store_reporting_promotion_mixin.py +0 -162
  649. core_memory-1.1.0/core_memory/persistence/store_text_hygiene_ops.py +0 -40
  650. core_memory-1.1.0/core_memory/persistence/store_validation_helpers.py +0 -143
  651. core_memory-1.1.0/core_memory/persistence/write_ops.py +0 -31
  652. core_memory-1.1.0/core_memory/policy/association_inference_v21.py +0 -135
  653. core_memory-1.1.0/core_memory/policy/bead_typing.py +0 -159
  654. core_memory-1.1.0/core_memory/policy/hygiene.py +0 -339
  655. core_memory-1.1.0/core_memory/policy/promotion.py +0 -375
  656. core_memory-1.1.0/core_memory/policy/promotion_contract.py +0 -42
  657. core_memory-1.1.0/core_memory/reporting/__init__.py +0 -13
  658. core_memory-1.1.0/core_memory/retrieval/__init__.py +0 -2
  659. core_memory-1.1.0/core_memory/retrieval/failure_patterns.py +0 -79
  660. core_memory-1.1.0/core_memory/retrieval/hybrid.py +0 -118
  661. core_memory-1.1.0/core_memory/retrieval/lexical.py +0 -227
  662. core_memory-1.1.0/core_memory/retrieval/lifecycle.py +0 -113
  663. core_memory-1.1.0/core_memory/retrieval/pipeline/__init__.py +0 -169
  664. core_memory-1.1.0/core_memory/retrieval/pipeline/canonical.py +0 -1289
  665. core_memory-1.1.0/core_memory/retrieval/pipeline/explain.py +0 -25
  666. core_memory-1.1.0/core_memory/retrieval/rerank.py +0 -344
  667. core_memory-1.1.0/core_memory/retrieval/semantic_index.py +0 -1415
  668. core_memory-1.1.0/core_memory/retrieval/tools/memory.py +0 -66
  669. core_memory-1.1.0/core_memory/retrieval/trace.py +0 -34
  670. core_memory-1.1.0/core_memory/retrieval/vector_backend.py +0 -369
  671. core_memory-1.1.0/core_memory/retrieval/visible_corpus.py +0 -144
  672. core_memory-1.1.0/core_memory/runtime/__init__.py +0 -5
  673. core_memory-1.1.0/core_memory/runtime/agent_authored_contract.py +0 -137
  674. core_memory-1.1.0/core_memory/runtime/agent_crawler_invoke.py +0 -135
  675. core_memory-1.1.0/core_memory/runtime/decision_pass.py +0 -17
  676. core_memory-1.1.0/core_memory/runtime/dreamer_candidates.py +0 -684
  677. core_memory-1.1.0/core_memory/runtime/dreamer_eval.py +0 -211
  678. core_memory-1.1.0/core_memory/runtime/engine.py +0 -527
  679. core_memory-1.1.0/core_memory/runtime/enrichment.py +0 -212
  680. core_memory-1.1.0/core_memory/runtime/flush_flow.py +0 -278
  681. core_memory-1.1.0/core_memory/runtime/flush_state.py +0 -89
  682. core_memory-1.1.0/core_memory/runtime/ingress.py +0 -178
  683. core_memory-1.1.0/core_memory/runtime/jobs.py +0 -329
  684. core_memory-1.1.0/core_memory/runtime/live_session.py +0 -53
  685. core_memory-1.1.0/core_memory/runtime/longitudinal_benchmark.py +0 -259
  686. core_memory-1.1.0/core_memory/runtime/myelination.py +0 -202
  687. core_memory-1.1.0/core_memory/runtime/retrieval_feedback.py +0 -221
  688. core_memory-1.1.0/core_memory/runtime/reviewer_quick_value.py +0 -281
  689. core_memory-1.1.0/core_memory/runtime/session_start_flow.py +0 -158
  690. core_memory-1.1.0/core_memory/runtime/side_effect_queue.py +0 -390
  691. core_memory-1.1.0/core_memory/runtime/side_effects.py +0 -133
  692. core_memory-1.1.0/core_memory/runtime/state.py +0 -314
  693. core_memory-1.1.0/core_memory/runtime/turn_archive.py +0 -270
  694. core_memory-1.1.0/core_memory/runtime/turn_flow.py +0 -388
  695. core_memory-1.1.0/core_memory/runtime/turn_prep.py +0 -50
  696. core_memory-1.1.0/core_memory/runtime/turn_quality.py +0 -67
  697. core_memory-1.1.0/core_memory/runtime/worker.py +0 -103
  698. core_memory-1.1.0/core_memory/schema/__init__.py +0 -2
  699. core_memory-1.1.0/core_memory/schema/models.py +0 -609
  700. core_memory-1.1.0/core_memory/schema/normalization.py +0 -238
  701. core_memory-1.1.0/core_memory/write_pipeline/rolling_window.py +0 -349
  702. core_memory-1.1.0/core_memory/write_pipeline/tokenizer.py +0 -123
  703. core_memory-1.1.0/core_memory.egg-info/PKG-INFO +0 -617
  704. core_memory-1.1.0/core_memory.egg-info/SOURCES.txt +0 -493
  705. core_memory-1.1.0/core_memory.egg-info/requires.txt +0 -58
  706. core_memory-1.1.0/pyproject.toml +0 -82
  707. core_memory-1.1.0/tests/test_adapter_contract_markers.py +0 -23
  708. core_memory-1.1.0/tests/test_adapter_parity_matrix_contract.py +0 -289
  709. core_memory-1.1.0/tests/test_agent_authored_contract_flags.py +0 -53
  710. core_memory-1.1.0/tests/test_agent_authored_contract_validation.py +0 -90
  711. core_memory-1.1.0/tests/test_agent_authored_runtime_gate.py +0 -345
  712. core_memory-1.1.0/tests/test_agent_crawler_invoke.py +0 -98
  713. core_memory-1.1.0/tests/test_association_confidence_compat.py +0 -34
  714. core_memory-1.1.0/tests/test_association_crawler_contract.py +0 -332
  715. core_memory-1.1.0/tests/test_association_health.py +0 -72
  716. core_memory-1.1.0/tests/test_association_inference_v21_contract.py +0 -65
  717. core_memory-1.1.0/tests/test_association_pass_strengthened.py +0 -67
  718. core_memory-1.1.0/tests/test_association_quality_policy.py +0 -76
  719. core_memory-1.1.0/tests/test_association_slo.py +0 -92
  720. core_memory-1.1.0/tests/test_authority_enforcement.py +0 -59
  721. core_memory-1.1.0/tests/test_auto_archive_hold.py +0 -27
  722. core_memory-1.1.0/tests/test_backfill_causal_links.py +0 -28
  723. core_memory-1.1.0/tests/test_backfill_causal_links_targeted.py +0 -26
  724. core_memory-1.1.0/tests/test_bead_session_id.py +0 -56
  725. core_memory-1.1.0/tests/test_benchmark_locomo_like.py +0 -183
  726. core_memory-1.1.0/tests/test_canonical_hydration_contract.py +0 -140
  727. core_memory-1.1.0/tests/test_canonical_metadata_filters.py +0 -62
  728. core_memory-1.1.0/tests/test_canonical_path_enforcement.py +0 -50
  729. core_memory-1.1.0/tests/test_centrality_r3.py +0 -31
  730. core_memory-1.1.0/tests/test_claim_flags.py +0 -51
  731. core_memory-1.1.0/tests/test_claim_turn_integration.py +0 -97
  732. core_memory-1.1.0/tests/test_claim_update_policy.py +0 -177
  733. core_memory-1.1.0/tests/test_cli_compat_module.py +0 -64
  734. core_memory-1.1.0/tests/test_cli_diagnostics.py +0 -35
  735. core_memory-1.1.0/tests/test_cli_dreamer_candidates.py +0 -68
  736. core_memory-1.1.0/tests/test_cli_grouped_surface.py +0 -129
  737. core_memory-1.1.0/tests/test_cli_handler_modules.py +0 -98
  738. core_memory-1.1.0/tests/test_cli_integration_handlers.py +0 -43
  739. core_memory-1.1.0/tests/test_cli_ops_split.py +0 -19
  740. core_memory-1.1.0/tests/test_cli_parser_extended.py +0 -68
  741. core_memory-1.1.0/tests/test_compaction_queue_bridge.py +0 -36
  742. core_memory-1.1.0/tests/test_dreamer_analysis.py +0 -121
  743. core_memory-1.1.0/tests/test_dreamer_candidate_families_dv2.py +0 -268
  744. core_memory-1.1.0/tests/test_dreamer_candidates.py +0 -129
  745. core_memory-1.1.0/tests/test_dreamer_eval.py +0 -112
  746. core_memory-1.1.0/tests/test_e2e_lifecycle_query.py +0 -78
  747. core_memory-1.1.0/tests/test_e2e_program_scenarios.py +0 -192
  748. core_memory-1.1.0/tests/test_e2e_sidecar_per_turn.py +0 -50
  749. core_memory-1.1.0/tests/test_enforcement_matrix.py +0 -99
  750. core_memory-1.1.0/tests/test_evaluate_candidates.py +0 -29
  751. core_memory-1.1.0/tests/test_event_import_migration_guard.py +0 -46
  752. core_memory-1.1.0/tests/test_event_module_aliases.py +0 -22
  753. core_memory-1.1.0/tests/test_f_r2_hash_vector_determinism.py +0 -215
  754. core_memory-1.1.0/tests/test_f_rw1_tokenizer.py +0 -175
  755. core_memory-1.1.0/tests/test_f_rw2_selection_score.py +0 -230
  756. core_memory-1.1.0/tests/test_f_s1_validity_collapse.py +0 -95
  757. core_memory-1.1.0/tests/test_f_w1_enrichment_queue.py +0 -156
  758. core_memory-1.1.0/tests/test_f_w2_gate_severity.py +0 -81
  759. core_memory-1.1.0/tests/test_flush_async_side_effects.py +0 -129
  760. core_memory-1.1.0/tests/test_flush_cycle_guard.py +0 -56
  761. core_memory-1.1.0/tests/test_flush_report_artifact.py +0 -41
  762. core_memory-1.1.0/tests/test_flush_sequence_trace.py +0 -28
  763. core_memory-1.1.0/tests/test_graph_active_association_view_regressions.py +0 -141
  764. core_memory-1.1.0/tests/test_graph_r2.py +0 -42
  765. core_memory-1.1.0/tests/test_http_contract_async_ops.py +0 -35
  766. core_memory-1.1.0/tests/test_http_dreamer_candidates.py +0 -84
  767. core_memory-1.1.0/tests/test_http_ingress.py +0 -470
  768. core_memory-1.1.0/tests/test_http_inspect_endpoints.py +0 -63
  769. core_memory-1.1.0/tests/test_http_mcp_typed_writes.py +0 -112
  770. core_memory-1.1.0/tests/test_idempotency_effects.py +0 -52
  771. core_memory-1.1.0/tests/test_inspect_api.py +0 -62
  772. core_memory-1.1.0/tests/test_integrations_api.py +0 -69
  773. core_memory-1.1.0/tests/test_lexical_field_weights.py +0 -23
  774. core_memory-1.1.0/tests/test_longitudinal_benchmark_v2.py +0 -127
  775. core_memory-1.1.0/tests/test_mcp_typed_writes.py +0 -94
  776. core_memory-1.1.0/tests/test_memory_engine.py +0 -78
  777. core_memory-1.1.0/tests/test_memory_search_smoke_eval.py +0 -35
  778. core_memory-1.1.0/tests/test_metrics_dreamer_eval_cli.py +0 -59
  779. core_memory-1.1.0/tests/test_metrics_longitudinal_cli.py +0 -60
  780. core_memory-1.1.0/tests/test_metrics_myelination_cli.py +0 -67
  781. core_memory-1.1.0/tests/test_migration.py +0 -59
  782. core_memory-1.1.0/tests/test_myelination_experiment.py +0 -91
  783. core_memory-1.1.0/tests/test_neo4j_shadow_guardrails.py +0 -71
  784. core_memory-1.1.0/tests/test_openclaw_agent_end_bridge.py +0 -46
  785. core_memory-1.1.0/tests/test_openclaw_flags.py +0 -64
  786. core_memory-1.1.0/tests/test_openclaw_integration.py +0 -62
  787. core_memory-1.1.0/tests/test_openclaw_read_bridge.py +0 -112
  788. core_memory-1.1.0/tests/test_package_root_public_surface.py +0 -34
  789. core_memory-1.1.0/tests/test_pre_oss_matrix.py +0 -35
  790. core_memory-1.1.0/tests/test_process_flush_checkpoint_bead.py +0 -76
  791. core_memory-1.1.0/tests/test_pydanticai_adapter.py +0 -101
  792. core_memory-1.1.0/tests/test_pydanticai_memory_tools.py +0 -286
  793. core_memory-1.1.0/tests/test_r3_graph_semantic.py +0 -64
  794. core_memory-1.1.0/tests/test_release_surface_consistency.py +0 -69
  795. core_memory-1.1.0/tests/test_retrieval_feedback_dv2.py +0 -102
  796. core_memory-1.1.0/tests/test_retrieval_parity_and_hydration.py +0 -93
  797. core_memory-1.1.0/tests/test_retrieval_semantic_backend.py +0 -72
  798. core_memory-1.1.0/tests/test_retrieval_trace_compat.py +0 -29
  799. core_memory-1.1.0/tests/test_reviewer_quick_value_v2.py +0 -35
  800. core_memory-1.1.0/tests/test_runtime_association_pass.py +0 -37
  801. core_memory-1.1.0/tests/test_runtime_decision_pass.py +0 -19
  802. core_memory-1.1.0/tests/test_runtime_engine_boundaries.py +0 -56
  803. core_memory-1.1.0/tests/test_runtime_jobs.py +0 -93
  804. core_memory-1.1.0/tests/test_runtime_jobs_enqueue.py +0 -64
  805. core_memory-1.1.0/tests/test_runtime_jobs_layering.py +0 -21
  806. core_memory-1.1.0/tests/test_runtime_jobs_run.py +0 -69
  807. core_memory-1.1.0/tests/test_runtime_side_effect_queue.py +0 -171
  808. core_memory-1.1.0/tests/test_runtime_split_modules.py +0 -65
  809. core_memory-1.1.0/tests/test_schema_models_normalization.py +0 -81
  810. core_memory-1.1.0/tests/test_schema_normalization.py +0 -29
  811. core_memory-1.1.0/tests/test_semantic_active_k.py +0 -27
  812. core_memory-1.1.0/tests/test_semantic_backend_abstraction.py +0 -76
  813. core_memory-1.1.0/tests/test_semantic_backend_docs.py +0 -33
  814. core_memory-1.1.0/tests/test_semantic_backend_modes.py +0 -33
  815. core_memory-1.1.0/tests/test_semantic_doctor.py +0 -86
  816. core_memory-1.1.0/tests/test_semantic_required_mode_contract.py +0 -108
  817. core_memory-1.1.0/tests/test_semantic_required_mode_provider_regression.py +0 -68
  818. core_memory-1.1.0/tests/test_session_first_write_authority.py +0 -40
  819. core_memory-1.1.0/tests/test_session_purity_invariants.py +0 -63
  820. core_memory-1.1.0/tests/test_session_surface.py +0 -21
  821. core_memory-1.1.0/tests/test_sidecar_contracts.py +0 -41
  822. core_memory-1.1.0/tests/test_sidecar_hook.py +0 -72
  823. core_memory-1.1.0/tests/test_sidecar_sync_session_semantics.py +0 -33
  824. core_memory-1.1.0/tests/test_sidecar_worker.py +0 -55
  825. core_memory-1.1.0/tests/test_store_add_bead_delegation.py +0 -36
  826. core_memory-1.1.0/tests/test_store_add_helpers_delegation.py +0 -49
  827. core_memory-1.1.0/tests/test_store_autonomy_ops_delegation.py +0 -50
  828. core_memory-1.1.0/tests/test_store_claim_ops.py +0 -173
  829. core_memory-1.1.0/tests/test_store_compaction_ops_delegation.py +0 -35
  830. core_memory-1.1.0/tests/test_store_constraints_delegation.py +0 -38
  831. core_memory-1.1.0/tests/test_store_core_delegates_mixin.py +0 -22
  832. core_memory-1.1.0/tests/test_store_dream_bootstrap_ops_delegation.py +0 -33
  833. core_memory-1.1.0/tests/test_store_failure_ops_delegation.py +0 -52
  834. core_memory-1.1.0/tests/test_store_hygiene_delegation.py +0 -32
  835. core_memory-1.1.0/tests/test_store_index_heads_ops_delegation.py +0 -48
  836. core_memory-1.1.0/tests/test_store_integrity.py +0 -57
  837. core_memory-1.1.0/tests/test_store_json_ops_delegation.py +0 -52
  838. core_memory-1.1.0/tests/test_store_lifecycle_ops_delegation.py +0 -29
  839. core_memory-1.1.0/tests/test_store_metrics_runtime_delegation.py +0 -40
  840. core_memory-1.1.0/tests/test_store_projection_ops_delegation.py +0 -33
  841. core_memory-1.1.0/tests/test_store_promotion_policy_delegation.py +0 -28
  842. core_memory-1.1.0/tests/test_store_promotion_service_boundaries.py +0 -38
  843. core_memory-1.1.0/tests/test_store_query_session_delegation.py +0 -48
  844. core_memory-1.1.0/tests/test_store_rationale_delegation.py +0 -39
  845. core_memory-1.1.0/tests/test_store_relationship_ops_delegation.py +0 -47
  846. core_memory-1.1.0/tests/test_store_reporting_boundaries.py +0 -35
  847. core_memory-1.1.0/tests/test_store_reporting_promotion_mixin.py +0 -23
  848. core_memory-1.1.0/tests/test_store_retrieval_context_delegation.py +0 -43
  849. core_memory-1.1.0/tests/test_store_text_hygiene_ops_delegation.py +0 -41
  850. core_memory-1.1.0/tests/test_store_validation_helpers_delegation.py +0 -33
  851. core_memory-1.1.0/tests/test_structural_features_radius1.py +0 -31
  852. core_memory-1.1.0/tests/test_structural_inference_hardening.py +0 -50
  853. core_memory-1.1.0/tests/test_supersession_guards.py +0 -29
  854. core_memory-1.1.0/tests/test_sync_structural_pipeline.py +0 -45
  855. core_memory-1.1.0/tests/test_trace_results_include_chain_nodes.py +0 -50
  856. core_memory-1.1.0/tests/test_trigger_authority_markers.py +0 -25
  857. core_memory-1.1.0/tests/test_trigger_orchestrator.py +0 -43
  858. core_memory-1.1.0/tests/test_trigger_orchestrator_flush.py +0 -40
  859. core_memory-1.1.0/tests/test_trigger_orchestrator_flush_recovery.py +0 -40
  860. core_memory-1.1.0/tests/test_turn_archive.py +0 -48
  861. core_memory-1.1.0/tests/test_turn_archive_get_turn.py +0 -43
  862. core_memory-1.1.0/tests/test_turn_association_visibility.py +0 -50
  863. core_memory-1.1.0/tests/test_turn_decision_pass.py +0 -85
  864. core_memory-1.1.0/tests/test_turn_event_to_retrieval_contract.py +0 -74
  865. core_memory-1.1.0/tests/test_turn_hydration.py +0 -67
  866. {core_memory-1.1.0 → core_memory-1.1.2}/LICENSE +0 -0
  867. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/association/quarantine.py +0 -0
  868. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/__init__.py +0 -0
  869. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/answer_policy.py +0 -0
  870. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/answer_signals.py +0 -0
  871. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/outcomes.py +0 -0
  872. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/prompt_definitions.py +0 -0
  873. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/resolver_helpers.py +0 -0
  874. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/retrieval_planner.py +0 -0
  875. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/claim/validation.py +0 -0
  876. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/config/__init__.py +0 -0
  877. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/config/defaults/__init__.py +0 -0
  878. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/config/defaults/domain_tags.yaml +0 -0
  879. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/config/defaults/query_expansions.yaml +0 -0
  880. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/config/loader.py +0 -0
  881. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/crewai/__init__.py +0 -0
  882. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/http/__init__.py +0 -0
  883. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/langchain/__init__.py +0 -0
  884. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/langchain/retriever.py +0 -0
  885. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/mcp/__init__.py +0 -0
  886. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/neo4j/__init__.py +0 -0
  887. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/neo4j/client.py +0 -0
  888. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/neo4j/config.py +0 -0
  889. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/neo4j/mapper.py +0 -0
  890. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/neo4j/sync.py +0 -0
  891. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/integrations/springai/__init__.py +0 -0
  892. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/__init__.py +0 -0
  893. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/archive_index.py +0 -0
  894. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/encryption.py +0 -0
  895. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/io_utils.py +0 -0
  896. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/metrics_ops.py +0 -0
  897. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/query_ops.py +0 -0
  898. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/rolling_record_store.py +0 -0
  899. {core_memory-1.1.0/core_memory/runtime → core_memory-1.1.2/core_memory/persistence}/session_surface.py +0 -0
  900. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_autonomy_ops.py +0 -0
  901. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_constraints.py +0 -0
  902. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_contract.py +0 -0
  903. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_init_ops.py +0 -0
  904. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_json_ops.py +0 -0
  905. {core_memory-1.1.0/core_memory/reporting → core_memory-1.1.2/core_memory/persistence}/store_metrics_runtime.py +0 -0
  906. {core_memory-1.1.0/core_memory/reporting → core_memory-1.1.2/core_memory/persistence}/store_rationale.py +0 -0
  907. {core_memory-1.1.0/core_memory/reporting → core_memory-1.1.2/core_memory/persistence}/store_reporting.py +0 -0
  908. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_retrieval_context.py +0 -0
  909. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/persistence/store_session_ops.py +0 -0
  910. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/policy/association_contract.py +0 -0
  911. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/policy/incidents.py +0 -0
  912. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/py.typed +0 -0
  913. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/config.py +0 -0
  914. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/context_recall.py +0 -0
  915. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/evidence_scoring.py +0 -0
  916. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/normalize.py +0 -0
  917. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/pipeline/catalog.py +0 -0
  918. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/pipeline/convergence.py +0 -0
  919. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/pipeline/search.py +0 -0
  920. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/pipeline/snap.py +0 -0
  921. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/quality_gate.py +0 -0
  922. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/query_norm.py +0 -0
  923. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/tools/__init__.py +0 -0
  924. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/tools/memory_reason.py +0 -0
  925. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/tools/memory_search.py +0 -0
  926. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/retrieval/types.py +0 -0
  927. {core_memory-1.1.0/core_memory/runtime → core_memory-1.1.2/core_memory/runtime/observability}/observability.py +0 -0
  928. {core_memory-1.1.0/core_memory/runtime → core_memory-1.1.2/core_memory/runtime/observability}/retrieval_value_overrides.py +0 -0
  929. {core_memory-1.1.0/core_memory/runtime → core_memory-1.1.2/core_memory/runtime/passes}/association_pass.py +0 -0
  930. {core_memory-1.1.0/core_memory/runtime → core_memory-1.1.2/core_memory/runtime/queue}/compaction_queue.py +0 -0
  931. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/temporal/__init__.py +0 -0
  932. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/temporal/resolution.py +0 -0
  933. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/write_pipeline/__init__.py +0 -0
  934. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/write_pipeline/consolidate.py +0 -0
  935. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/write_pipeline/continuity_injection.py +0 -0
  936. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory/write_pipeline/orchestrate.py +0 -0
  937. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory.egg-info/dependency_links.txt +0 -0
  938. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory.egg-info/entry_points.txt +0 -0
  939. {core_memory-1.1.0 → core_memory-1.1.2}/core_memory.egg-info/top_level.txt +0 -0
  940. {core_memory-1.1.0 → core_memory-1.1.2}/setup.cfg +0 -0
  941. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_archive_index.py +0 -0
  942. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_association_pass_contract.py +0 -0
  943. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_association_policy_contract.py +0 -0
  944. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_association_quarantine_dedupe.py +0 -0
  945. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_association_slo_cli.py +0 -0
  946. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_association_type_policy.py +0 -0
  947. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_backend_parity.py +0 -0
  948. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_benchmark_dreamer_correlation.py +0 -0
  949. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_canonical_contract_mirror.py +0 -0
  950. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_catalog_relation_source.py +0 -0
  951. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_answer_policy.py +0 -0
  952. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_extraction.py +0 -0
  953. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_first_answering_rc2.py +0 -0
  954. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_outcomes.py +0 -0
  955. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_prompt_definitions.py +0 -0
  956. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_registry.py +0 -0
  957. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_resolver.py +0 -0
  958. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_resolver_helpers.py +0 -0
  959. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_resolver_temporal.py +0 -0
  960. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_retrieval_canonical_integration.py +0 -0
  961. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_retrieval_planner.py +0 -0
  962. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_claim_schema_roundtrip.py +0 -0
  963. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_cli_canonical_health.py +0 -0
  964. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_cli_taxonomy.py +0 -0
  965. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_compaction.py +0 -0
  966. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_compression_ratio.py +0 -0
  967. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_continuity_injection_authority.py +0 -0
  968. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_continuity_read_path_isolation.py +0 -0
  969. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_contradiction_supersession_rc3.py +0 -0
  970. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_decide_promotion.py +0 -0
  971. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_decision_conflicts.py +0 -0
  972. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_demo_import_side_effects.py +0 -0
  973. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_demo_observability_api.py +0 -0
  974. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_demo_public_read_path_purity.py +0 -0
  975. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_e2e.py +0 -0
  976. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_edge_traversal_logging.py +0 -0
  977. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_edges.py +0 -0
  978. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_entity_aware_retrieval.py +0 -0
  979. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_entity_merge_flow.py +0 -0
  980. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_entity_registry.py +0 -0
  981. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_example_contract_labels.py +0 -0
  982. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_explain_contains_snaps_and_scores.py +0 -0
  983. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_f_r1_config_extraction.py +0 -0
  984. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_f_rw4_rolling_dedup.py +0 -0
  985. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_fusion_tie_break.py +0 -0
  986. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_http_async_jobs.py +0 -0
  987. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_http_continuity_endpoint.py +0 -0
  988. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_http_mcp_typed_reads.py +0 -0
  989. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_hybrid_determinism.py +0 -0
  990. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_hygiene_curated.py +0 -0
  991. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_incident_alias_match.py +0 -0
  992. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_incident_boost_is_deterministic.py +0 -0
  993. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_index_projection_cache.py +0 -0
  994. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_intent_weighted_rerank.py +0 -0
  995. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_langchain_adapter_contract.py +0 -0
  996. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_lexical_recall_smoke.py +0 -0
  997. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_live_session_authority.py +0 -0
  998. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_mcp_typed_reads.py +0 -0
  999. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_causal_fallback.py +0 -0
  1000. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_contract.py +0 -0
  1001. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_feature_flags.py +0 -0
  1002. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_field_mapping.py +0 -0
  1003. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_next_action_policy.py +0 -0
  1004. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_execute_surface_metadata.py +0 -0
  1005. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_search_internal_isolation.py +0 -0
  1006. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_search_request_canonical.py +0 -0
  1007. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_search_tool_wrapper.py +0 -0
  1008. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_memory_search_typed_confidence_unified.py +0 -0
  1009. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_metrics.py +0 -0
  1010. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_metrics_aggregation.py +0 -0
  1011. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_metrics_reviewer_quick_value_cli.py +0 -0
  1012. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_models_schema_alignment.py +0 -0
  1013. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_neo4j_cli.py +0 -0
  1014. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_neo4j_client_upsert_contract.py +0 -0
  1015. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_neo4j_mapping_contract.py +0 -0
  1016. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_neo4j_scaffold.py +0 -0
  1017. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_neo4j_sync.py +0 -0
  1018. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_normalization_rank_fallback.py +0 -0
  1019. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_persistence_shim_import_audit.py +0 -0
  1020. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_promotion.py +0 -0
  1021. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_promotion_kpis.py +0 -0
  1022. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_promotion_slate.py +0 -0
  1023. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_quality_gate_bucket_thresholds.py +0 -0
  1024. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_query_anchor_resolution.py +0 -0
  1025. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rationale_recall.py +0 -0
  1026. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rebuild_integrity.py +0 -0
  1027. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_required_fields_v2.py +0 -0
  1028. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_reranker_feature_extraction.py +0 -0
  1029. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_reranker_scoring_is_bounded.py +0 -0
  1030. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieval_convergence_rc1.py +0 -0
  1031. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieval_eval_grounding_details.py +0 -0
  1032. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieval_evidence_scoring.py +0 -0
  1033. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieval_foundation.py +0 -0
  1034. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieval_path_purity.py +0 -0
  1035. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieve_deep_recall.py +0 -0
  1036. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_retrieve_query_expansion.py +0 -0
  1037. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rolling_fifo_determinism.py +0 -0
  1038. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rolling_record_store.py +0 -0
  1039. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rolling_surface_contract.py +0 -0
  1040. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rolling_surface_owner.py +0 -0
  1041. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_rolling_surface_separation.py +0 -0
  1042. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_runtime_jobs_cli.py +0 -0
  1043. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_schema_models_serialization.py +0 -0
  1044. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_schema_quality_report.py +0 -0
  1045. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_schema_string_enums.py +0 -0
  1046. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_schema_unknown_field_visibility.py +0 -0
  1047. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_search_typed_filters_work.py +0 -0
  1048. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_search_typed_relation_filters.py +0 -0
  1049. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_search_typed_time_range.py +0 -0
  1050. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_secret_redaction.py +0 -0
  1051. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_semantic_build_lock.py +0 -0
  1052. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_session_first_query_authority.py +0 -0
  1053. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_session_start_boundary.py +0 -0
  1054. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_session_start_retrieval_semantics.py +0 -0
  1055. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_sidecar_cli.py +0 -0
  1056. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_snap_confidence_labels.py +0 -0
  1057. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_snap_deterministic.py +0 -0
  1058. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_snap_unknowns_safe.py +0 -0
  1059. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_springai_bridge.py +0 -0
  1060. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_sqlite_backend.py +0 -0
  1061. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_store_boundary_contract.py +0 -0
  1062. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_store_contract.py +0 -0
  1063. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_store_init_ops.py +0 -0
  1064. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_store_shim_import_audit.py +0 -0
  1065. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_temporal_only_grounding_guard.py +0 -0
  1066. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_temporal_resolution_helpers.py +0 -0
  1067. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_topic_key_tagging.py +0 -0
  1068. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_write_pipeline_consolidate_parity.py +0 -0
  1069. {core_memory-1.1.0 → core_memory-1.1.2}/tests/test_write_pipeline_internalization.py +0 -0
@@ -0,0 +1,453 @@
1
+ Metadata-Version: 2.4
2
+ Name: core-memory
3
+ Version: 1.1.2
4
+ Summary: Persistent causal agent memory with lossless compaction
5
+ Author-email: John Inniger <john@linelead.io>
6
+ Maintainer-email: John Inniger <john@linelead.io>
7
+ License: Apache-2.0
8
+ Project-URL: Homepage, https://github.com/JohnnyFiv3r/Core-Memory
9
+ Project-URL: Repository, https://github.com/JohnnyFiv3r/Core-Memory
10
+ Project-URL: Issues, https://github.com/JohnnyFiv3r/Core-Memory/issues
11
+ Keywords: memory,agent,causal,beads,compaction
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: Apache Software License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Requires-Python: >=3.10
20
+ Description-Content-Type: text/markdown
21
+ License-File: LICENSE
22
+ Requires-Dist: pyyaml>=6.0
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest; extra == "dev"
25
+ Requires-Dist: ruff; extra == "dev"
26
+ Requires-Dist: mypy; extra == "dev"
27
+ Provides-Extra: http
28
+ Requires-Dist: fastapi; extra == "http"
29
+ Requires-Dist: uvicorn; extra == "http"
30
+ Requires-Dist: httpx; extra == "http"
31
+ Provides-Extra: mcp
32
+ Requires-Dist: fastapi; extra == "mcp"
33
+ Requires-Dist: uvicorn; extra == "mcp"
34
+ Requires-Dist: httpx; extra == "mcp"
35
+ Requires-Dist: mcp<2,>=1.27.1; extra == "mcp"
36
+ Provides-Extra: pydanticai
37
+ Requires-Dist: pydantic-ai; extra == "pydanticai"
38
+ Provides-Extra: semantic
39
+ Requires-Dist: numpy; extra == "semantic"
40
+ Requires-Dist: faiss-cpu; extra == "semantic"
41
+ Provides-Extra: tokenizer
42
+ Requires-Dist: tiktoken; extra == "tokenizer"
43
+ Provides-Extra: openai
44
+ Requires-Dist: openai; extra == "openai"
45
+ Provides-Extra: anthropic
46
+ Requires-Dist: anthropic; extra == "anthropic"
47
+ Provides-Extra: google
48
+ Requires-Dist: google-genai; extra == "google"
49
+ Provides-Extra: qdrant
50
+ Requires-Dist: qdrant-client[fastembed]>=1.9; extra == "qdrant"
51
+ Provides-Extra: kuzu
52
+ Requires-Dist: kuzu>=0.4; extra == "kuzu"
53
+ Provides-Extra: chromadb
54
+ Requires-Dist: chromadb; extra == "chromadb"
55
+ Provides-Extra: pgvector
56
+ Requires-Dist: psycopg[binary]; extra == "pgvector"
57
+ Provides-Extra: langchain
58
+ Requires-Dist: langchain-core; extra == "langchain"
59
+ Provides-Extra: crewai
60
+ Requires-Dist: crewai; extra == "crewai"
61
+ Provides-Extra: neo4j
62
+ Requires-Dist: neo4j; extra == "neo4j"
63
+ Provides-Extra: graphiti
64
+ Requires-Dist: graphiti-core>=0.3; extra == "graphiti"
65
+ Requires-Dist: neo4j>=5.0; extra == "graphiti"
66
+ Provides-Extra: obsidian
67
+ Provides-Extra: encryption
68
+ Requires-Dist: cryptography; extra == "encryption"
69
+ Provides-Extra: all
70
+ Requires-Dist: fastapi; extra == "all"
71
+ Requires-Dist: uvicorn; extra == "all"
72
+ Requires-Dist: httpx; extra == "all"
73
+ Requires-Dist: mcp<2,>=1.27.1; extra == "all"
74
+ Requires-Dist: pydantic-ai; extra == "all"
75
+ Requires-Dist: numpy; extra == "all"
76
+ Requires-Dist: faiss-cpu; extra == "all"
77
+ Requires-Dist: openai; extra == "all"
78
+ Requires-Dist: anthropic; extra == "all"
79
+ Requires-Dist: google-genai; extra == "all"
80
+ Requires-Dist: tiktoken; extra == "all"
81
+ Requires-Dist: neo4j; extra == "all"
82
+ Requires-Dist: qdrant-client[fastembed]>=1.9; extra == "all"
83
+ Requires-Dist: kuzu>=0.4; extra == "all"
84
+ Dynamic: license-file
85
+
86
+ <p align="center">
87
+ <img src="https://raw.githubusercontent.com/JohnnyFiv3r/Core-Memory/master/docs/assets/core-memory-hero-banner.jpg" alt="Core Memory banner" />
88
+ </p>
89
+
90
+ <p align="center">
91
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="Apache-2.0 License"></a>
92
+ <a href="#"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+"></a>
93
+ </p>
94
+
95
+ <p align="center">
96
+ <b>Causal memory for AI agents.</b><br>
97
+ Structured memory objects + causal trace over durable events — so agents can recall <i>why</i>, not just <i>what</i>.
98
+ </p>
99
+
100
+ <p align="center">
101
+ <a href="#quick-start">Quickstart</a> · <a href="#features">Features</a> · <a href="#supported-clients">Supported Clients</a> · <a href="#contributing">Contributing</a>
102
+ </p>
103
+
104
+ ## Core Memory
105
+
106
+ Give your AI agents persistent memory built for the way conversations actually work. Core Memory is a plug and play, self-hosted conversational memory MCP server that captures each turn as a memory object, builds causal links as the dialogue unfolds, and recalls with full evidence. Works with Claude Code, Cursor, ChatGPT, or any MCP-compatible client.
107
+
108
+ Transcripts are where most decision making actually happens, across agent conversations, email threads, and Slack. Yet every tool treats them as a noisier version of a document. Core Memory is built specifically for that problem.
109
+
110
+ **Remember every turn:** Each turn produces a memory object linked to prior turns by typed causal edges. Claims are tracked and superseded when contradicted, so memory stays truthful as the dialogue develops.
111
+
112
+ **Stored as a causal graph:** Memory objects are linked by the relationship between them, like `caused_by`, `contradicts`, and `supports`. When you ask a question, your agent follows the chain of reasoning, not just a ranked vector similarity score. Every result shows you the path of causality between the memory events.
113
+
114
+ **Depth on demand:** Tune recall(query, effort="low" | "medium" | "high") for your needs. Fast lookup when that is enough, full causal traversal when the question needs it. The orchestrator decides.
115
+
116
+ **Rolling context injection on a budget:** Compacted memory objects carry only their title, type, and causal associations, allowing 10+ sessions of history to be injected for a fraction of the token cost of naive loading. Promoted objects stay full context when active, and the agent can expand any compacted memory on demand with a single tool call.
117
+
118
+ <p align="center">
119
+ <a href="https://youtu.be/56uyTJEnOAA">
120
+ <img src="https://raw.githubusercontent.com/JohnnyFiv3r/Core-Memory/master/docs/assets/core-memory-live-demo-still.jpg" alt="Core Memory live demo (click to watch on YouTube)" width="100%" />
121
+ </a>
122
+ </p>
123
+
124
+ <p align="center"><a href="https://youtu.be/56uyTJEnOAA">Watch the Core Memory live demo on YouTube</a></p>
125
+
126
+ ---
127
+
128
+ ## Quick Start
129
+
130
+ Core Memory auto-detects your embeddings provider from OPENAI_API_KEY, GEMINI_API_KEY, or GOOGLE_API_KEY. No configuration needed.
131
+
132
+ ```bash
133
+ uvx "core-memory[mcp]" mcp serve
134
+ ```
135
+
136
+ Core Memory starts on http://localhost:8000/mcp and stores data in ~/.core-memory/store.
137
+
138
+ For Claude Code, add to your MCP config:
139
+
140
+ ```json
141
+ {
142
+ "mcpServers": {
143
+ "core-memory": {
144
+ "type": "streamable-http",
145
+ "url": "http://localhost:8000/mcp"
146
+ }
147
+ }
148
+ }
149
+ ```
150
+
151
+ Start a new conversation. MCP exposes `recall`, `capture`, `capture_session`, and governed `maintain` tools the model can call. Per-turn capture requires the model to follow the bundled agent guide; automatic capture for every turn requires a supported client adapter or lifecycle hook.
152
+
153
+ Or install directly from PyPI for Python SDK use:
154
+
155
+ ```bash
156
+ pip install "core-memory[mcp]"
157
+ ```
158
+
159
+ To ingest existing transcripts, use the CLI command:
160
+
161
+ `core-memory ingest transcript my-transcript.jsonl`
162
+
163
+ Or call the ingest tool directly from any connected MCP client. Accepts JSONL or JSON with user/assistant, human/ai, or customer/agent roles.
164
+
165
+ See the [full setup guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/mcp/quickstart.md) for MCP client configuration and adapter configurations for OpenClaw, PydanticAI, LangChain, and SpringAI.
166
+
167
+ ---
168
+
169
+ ## Features
170
+
171
+ **Transcript-native storage:** Built specifically for conversational data, each turn is normalized into a memory object rather than chunked and indexed alongside authored documents.
172
+
173
+ **Per-turn capture via MCP tools:** The MCP server exposes `capture` and `capture_session` as tools. When a client adapter or lifecycle hook is configured, every turn is captured automatically. With stock MCP clients (Claude, ChatGPT), the model follows the bundled agent guide to call capture after state-bearing turns. Use `capture_session` at conversation end as a lossless safety net.
174
+
175
+ **Rolling context injection on a budget:** Compacted memory objects carry only their title, type, and causal associations, fitting 10+ sessions of history into a fraction of the token cost of naive loading.
176
+
177
+ **Causal graph, not a flat index:** Memory objects are linked by typed relationships (caused_by, contradicts, supports, and more), so recall follows reasoning chains instead of ranking similarity scores.
178
+
179
+ **Claims tracked and superseded:** Statements like "user prefers PostgreSQL" are monitored and updated when later turns contradict them. Memory stays truthful, not just full.
180
+
181
+ **Full context is always retrievable:** Full transcripts are preserved and linked via turn and session_ID references, so full context is always a tool call away.
182
+
183
+ **Inspectable retrieval with provenance:** Every recall() returns the source conversation, the traversal path that found it, and a verifiable hash. Retrieval is never a black box.
184
+
185
+ **Depth on demand:** recall(query, effort="low" | "medium" | "high") scales from fast lookup to full causal traversal. The orchestrator decides what the question needs.
186
+
187
+ **Self-hosted MCP:** Streamable-HTTP server at /mcp with a canonical agent guide that loads at connection. For stock MCP clients (Claude, ChatGPT), paste the operating-protocol block printed by `core-memory mcp install` into your custom instructions so the model calls recall/capture/capture_session on every turn. Owned control-plane agents can also use `maintain` for governed approval, cleanup, and removal workflows.
188
+
189
+ **Auto-detected embedding model:** Picks up OPENAI_API_KEY, GEMINI_API_KEY, or GOOGLE_API_KEY from your environment. Runs in degraded mode with one hint if none are set.
190
+
191
+ **Plug and play adoption:** Your data stays on your infrastructure. No cloud dependencies. A single MCP server setup works across any MCP-compatible client.
192
+
193
+ <p align="center">
194
+ <img src="https://raw.githubusercontent.com/JohnnyFiv3r/Core-Memory/master/docs/assets/core-memory-causal-graph.png" alt="Core Memory causal graph alongside the grounded bead JSON returned by recall()" width="100%" />
195
+ </p>
196
+
197
+ <p align="center"><i>The causal memory graph (left) and the grounded bead JSON returned by <code>recall()</code> (right) — type, entities, session_id, and source_turn_ids make every retrieval inspectable.</i></p>
198
+
199
+ ---
200
+
201
+ ## Supported Clients
202
+
203
+ **MCP Connection**
204
+ Any client that can connect to MCP streamable-HTTP servers can use Core Memory through the `/mcp` endpoint. See the [MCP Quickstart](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/mcp/quickstart.md) for setup instructions and example client configuration.
205
+
206
+ **Adapter Layer**
207
+ Use Core Memory as a memory backend directly within your agent harness:
208
+
209
+ | Client | Plugin | Quickstart | Integration Guide | API Reference | Adapter Spec |
210
+ |------------|---------|------------|-------------------|---------------|--------------|
211
+ | OpenClaw | [Plugin](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/plugins/openclaw-core-memory-bridge/openclaw.plugin.json) and [Skill](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/plugins/openclaw-core-memory-bridge/skills/core-memory/SKILL.md) | [Quickstart](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/openclaw/quickstart.md) and [Setup Guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/openclaw/plugin-setup.md) | [Guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/openclaw/integration-guide.md) | [API Reference](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/openclaw/api-reference.md) | [Adapter Spec](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/adapters/openclaw.md) |
212
+ | PydanticAI | — | [Quickstart](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/pydanticai/quickstart.md) | [Guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/pydanticai/integration-guide.md) | [API Reference](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/pydanticai/api-reference.md) | [Adapter Spec](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/adapters/pydanticai.md) |
213
+ | SpringAI | — | [Quickstart](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/springai/quickstart.md) | [Guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/springai/integration-guide.md) | [API Reference](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/springai/api-reference.md) | [Adapter Spec](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/springai_adapter.md) |
214
+ | LangChain | — | [Quickstart](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/langchain/quickstart.md) | [Guide](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/langchain/integration-guide.md) | [API Reference](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/langchain/api-reference.md) | [Adapter Spec](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/adapters/langchain.md) |
215
+
216
+ OpenClaw v2026.6.8+ requires `plugins.entries.core-memory-bridge.hooks.allowConversationAccess=true`; see the [runtime install notes](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/integrations/openclaw/openclaw-v2026.6.8-install.md).
217
+
218
+ ---
219
+
220
+ <p align="center">
221
+ <img src="https://raw.githubusercontent.com/JohnnyFiv3r/Core-Memory/master/docs/assets/core-memory-architecture-new.png" alt="Core Memory Architecture Diagram" />
222
+ </p>
223
+
224
+ ## How It Works
225
+
226
+ Core Memory separates retrieval from writes, connected through session-scoped storage. Each agent turn follows the same loop:
227
+
228
+ **Capture:** Call `capture()` after each turn, or let a client adapter do it automatically. With MCP, the model follows the bundled agent guide to call capture after state-bearing turns; use `capture_session` at the end of a conversation as a lossless safety net. Each turn becomes a memory object typed as a decision, lesson, outcome, evidence, or context. An agent judge assigns typed causal associations (caused_by, contradicts, supports, and more), and claims are tracked and superseded when later turns update them. Nothing is filtered before storage — the LLM assigns structure, not importance.
229
+
230
+ **Recall:** recall(query, effort="low" | "medium" | "high") is the single read verb. Before each agent turn, a bounded context packet is built from the rolling window: promoted memory objects at full context, compacted ones as lightweight stubs. effort="low" runs lexical and semantic anchor search. effort="medium" adds temporal routing. effort="high" runs the full orchestration pipeline: causal traversal, multi-hop chains, goal resolution, and claim-slot enrichment. The orchestrator decides what the question needs.
231
+
232
+ **Grounding:** Every recall() returns a RecallResult — not just the memory, but the source conversation it came from, the traversal path that found it, and a verifiable hash. The result carries per-memory evidence records and a planning trace showing exactly which retrieval surfaces fired. Retrieval is deterministic from indexed state.
233
+
234
+ **Maintain:** Memory objects are either promoted (full context in the rolling window) or compacted to title, type, and associations only. Compacted objects remain queryable and their associations stay intact — the agent expands any on demand with a single tool call. Myelination (edge strengthening over time) is available as an opt-in feature; rarely-accessed memory compacts naturally.
235
+
236
+
237
+ **Core Concepts**
238
+
239
+ **Memory Object**
240
+ A memory object is a structured unit of recall typed as a decision, lesson, outcome, evidence, context, or another typed event. Each object is either promoted (full context in the rolling window) or compacted (title, type, and associations only). Promoted objects are immediately available; compacted objects can be expanded on demand via a single tool call.
241
+
242
+ **Rolling Window**
243
+ Before each agent turn, Core Memory builds a bounded context packet from the rolling window — the session-scoped set of memory objects visible to the current conversation. Promoted objects contribute full context; compacted stubs contribute their title, type, and associations. The rolling window allows 10+ sessions of history to fit within a standard token budget.
244
+
245
+ **Associations**
246
+ Associations are typed causal or temporal links between memory objects, assigned by an agent judge from a fixed 28-label taxonomy (caused_by, contradicts, supports, and more). Associations remain queryable even as memory objects compact. Unlike semantic similarity links, associations encode the reason one memory relates to another.
247
+
248
+ **Claims**
249
+ Claims are verifiable statements extracted from conversation turns and tracked across sessions. When a later turn contradicts an existing claim, the association graph is updated — the prior claim is superseded, not deleted. The full history of a changing belief is preserved while the current state remains accurate.
250
+
251
+ **Retrieval Pipeline**
252
+ Three canonical surfaces, exposed through recall(query, effort=...):
253
+
254
+ * `search` — lexical and semantic anchor retrieval (`effort="low"`)
255
+ * `trace` — causal traversal from search anchors (`effort="medium"`)
256
+ * `execute` — full orchestration: search + trace + goal resolution + claim-slot enrichment (`effort="high"`)
257
+
258
+ Hydration is explicit post-selection source recovery (turn/tools/adjacent) — not a general retrieval mode and not the same as the rolling window. Retrieval is deterministic from indexed state.
259
+
260
+ **RecallResult**
261
+ Every `recall()` returns a typed `RecallResult` with `evidence[]` (memory objects with grounding hashes), `sources[]`, `steps[]` (which surfaces fired and in what order), `resolved_goals[]`, and `claim_slots{}`. Stable across MCP, REST, and Python SDK.
262
+
263
+ **Semantic Readiness**
264
+
265
+ Core Memory auto-detects your embeddings provider from `OPENAI_API_KEY`, `GEMINI_API_KEY`, or `GOOGLE_API_KEY`. If none is set, it runs in degraded lexical mode — BM25 keyword recall, no semantic anchors.
266
+
267
+ | Profile | How to get there |
268
+ |---|---|
269
+ | Minimal MCP (degraded) | No API key; set `CORE_MEMORY_CANONICAL_SEMANTIC_MODE=degraded_allowed` to suppress the warning |
270
+ | MCP + semantic recall | Set `OPENAI_API_KEY` (or Gemini/Google), then run `core-memory graph semantic-build` |
271
+ | Production (Qdrant/pgvector) | Set `CORE_MEMORY_VECTOR_BACKEND=qdrant` or `pgvector`; see semantic backend docs |
272
+
273
+ The `CORE_MEMORY_CANONICAL_SEMANTIC_MODE` env var controls failure behavior:
274
+
275
+ | Mode | Behavior |
276
+ |---|---|
277
+ | `required` (default) | Fails closed when semantic backend is unavailable |
278
+ | `degraded_allowed` | Lexical fallback with degraded recall markers |
279
+
280
+ First-run recall quality with no semantic backend: keyword matches only, no similarity-ranked anchors.
281
+
282
+ **Multi-Store Fan-Out** *(experimental)*
283
+
284
+ Core Memory can fan out recall queries to PipeHouse and merge external evidence:
285
+
286
+ | Env var | Purpose |
287
+ |---|---|
288
+ | `CORE_MEMORY_PIPEHOUSE_URL` | Enables PipeHouse evidence retrieval |
289
+ | `CORE_MEMORY_STORE_WEIGHTS` | Comma-separated weights for `core_memory,pipehouse` (default `1.0,1.0`) |
290
+
291
+ Fan-out is skipped when none of these are set. Results are normalized, weighted, and merged into the standard `RecallResult`.
292
+
293
+ **Storage Backend**
294
+
295
+ | Backend | Use case |
296
+ |---|---|
297
+ | `local-faiss` | Development, single-process only (`[semantic]`) |
298
+ | `qdrant` | Production, distributed (`[qdrant]`) |
299
+ | `pgvector` | Production, Postgres-native (`[pgvector]`) |
300
+ | `chromadb` | Development alternative (`[chromadb]`) |
301
+
302
+ Set via CORE_MEMORY_VECTOR_BACKEND. Avoid local-faiss for multi-worker deployments. See semantic backend docs.
303
+
304
+ Learn more in the [architecture docs](docs/architecture_overview.md).
305
+
306
+ ---
307
+
308
+ ## Recall Example
309
+
310
+ **Request**
311
+
312
+ ```python
313
+ from core_memory import recall
314
+
315
+ result = recall(
316
+ "what database did we decide on for Project Heron?",
317
+ effort="high",
318
+ root="~/.core-memory"
319
+ )
320
+ ```
321
+
322
+ **Response**
323
+
324
+ ```json
325
+ {
326
+ "contract": "recall_result",
327
+ "schema_version": "recall_result.v1",
328
+ "status": "answered",
329
+ "answer": "PostgreSQL",
330
+ "why": "Decision recorded in session 2026-04-12: PostgreSQL selected for Project Heron tenant config",
331
+ "evidence": [
332
+ {
333
+ "bead_id": "b_a3f9c2",
334
+ "type": "decision",
335
+ "title": "PostgreSQL selected for Project Heron tenant config",
336
+ "content_excerpt": "We decided to use PostgreSQL for the main tenant config database.",
337
+ "score": 0.94,
338
+ "grounding_hash": "sha256:e3b0c44..."
339
+ }
340
+ ],
341
+ "sources": [
342
+ {
343
+ "turn_id": "turn_042",
344
+ "session_id": "session_2026_04_12",
345
+ "bead_id": "b_a3f9c2",
346
+ "speaker": "user",
347
+ "ts": "2026-04-12T14:23:00Z"
348
+ }
349
+ ],
350
+ "steps": [
351
+ { "tier": "semantic", "status": "ok", "result_count": 3, "why": "anchor search" },
352
+ { "tier": "causal", "status": "ok", "result_count": 1, "why": "causal chains resolved" }
353
+ ],
354
+ "planning": {
355
+ "selected_effort": "high",
356
+ "reason": "full orchestration: search + trace + goal resolution + claim enrichment"
357
+ },
358
+ "claim_slots": {
359
+ "project_heron.database": {
360
+ "subject": "project_heron",
361
+ "slot": "database",
362
+ "current_value": "PostgreSQL",
363
+ "status": "active",
364
+ "current_claim_id": "claim_b3f1a9",
365
+ "chain_seq": 1,
366
+ "grounding_hash": "sha256:e3b0c44..."
367
+ }
368
+ },
369
+ "resolved_goals": [],
370
+ "warnings": []
371
+ }
372
+ ```
373
+
374
+ ---
375
+
376
+ ## Documentation
377
+
378
+ **Repo Map**
379
+ ```
380
+ core_memory/
381
+ ├── persistence/
382
+ ├── schema/
383
+ ├── retrieval/
384
+ ├── graph/
385
+ ├── write_pipeline/
386
+ ├── runtime/
387
+ ├── association/
388
+ ├── integrations/
389
+ ├── policy/
390
+ └── cli.py
391
+ ```
392
+ Other useful folders:
393
+
394
+ * examples/ runnable examples
395
+ * tests/ behavioral and regression coverage
396
+ * docs/ architecture, integration guides, and contracts
397
+ * plugins/ OpenClaw bridge assets
398
+ * demo/ live demo app and assets
399
+
400
+ ---
401
+
402
+ ## Contributing
403
+ ```bash
404
+ git clone https://github.com/JohnnyFiv3r/Core-Memory.git
405
+ cd Core-Memory
406
+ python3 -m venv .venv
407
+ source .venv/bin/activate
408
+ pip install -U pip
409
+ pip install -e ".[dev]"
410
+ core-memory --help
411
+ python3 -c "import core_memory; print('core_memory import ok')"
412
+ pytest
413
+ ```
414
+
415
+ For a core-deps-only run that matches CI and avoids optional backend/live
416
+ integration skips:
417
+
418
+ ```bash
419
+ pytest tests/ -m "not optional_backend and not neo4j_live" -x -q --tb=short
420
+ ```
421
+
422
+ Optional backend coverage is exercised by the all-extras CI job. Live Neo4j
423
+ coverage is kept in the explicit `neo4j_live` workflow lane.
424
+
425
+ Useful docs:
426
+
427
+ [CONTRIBUTING.md](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/CONTRIBUTING.md)
428
+ [Public Surface](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/public_surface.md)
429
+ [Test Suite](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/test_suite.md)
430
+ [Index](https://github.com/JohnnyFiv3r/Core-Memory/blob/master/docs/index.md)
431
+
432
+ ---
433
+
434
+ ## Maintainers
435
+
436
+ Core Memory is maintained by:
437
+
438
+ [John Inniger](https://github.com/JohnnyFiv3r) (@JohnnyFiv3r)
439
+ [Chris Dedow](https://github.com/chrisdedow) (@chrisdedow)
440
+
441
+ For bugs and feature requests, please open an issue. For anything else related to the project, feel free to reach out to the maintainers directly.
442
+
443
+ ---
444
+
445
+ ## Inspiration
446
+
447
+ Inspired in part by Steve Yegge's writing on beads and memory systems: https://github.com/steveyegge/beads
448
+
449
+ ---
450
+
451
+ <p align="center">
452
+ <a href="LICENSE">Apache-2.0 License</a> · <a href="CODE_OF_CONDUCT.md">Code of Conduct</a> · <a href="CHANGELOG.md">Changelog</a>
453
+ </p>