superlocalmemory 4.1.13 → 4.1.14

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 (740) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +48 -0
  3. package/README.md +3 -3
  4. package/package.json +1 -8
  5. package/plugin/.claude-plugin/plugin.json +1 -1
  6. package/plugin/CLAUDE.md +3 -3
  7. package/plugin/agents/slm-governance-advisor.md +1 -1
  8. package/plugin/agents/slm-loop-runner.md +1 -1
  9. package/plugin/agents/slm-memory-advisor.md +1 -1
  10. package/plugin/agents/slm-optimize-advisor.md +1 -1
  11. package/plugin/requirements.txt +1 -1
  12. package/plugin/skills/slm-cache/SKILL.md +1 -1
  13. package/plugin/skills/slm-compress/SKILL.md +1 -1
  14. package/plugin/skills/slm-governance/SKILL.md +1 -1
  15. package/plugin/skills/slm-graph/SKILL.md +1 -1
  16. package/plugin/skills/slm-loop/SKILL.md +1 -1
  17. package/plugin/skills/slm-mesh/SKILL.md +1 -1
  18. package/plugin/skills/slm-profile/SKILL.md +1 -1
  19. package/plugin/skills/slm-recall/SKILL.md +1 -1
  20. package/plugin/skills/slm-remember/SKILL.md +1 -1
  21. package/plugin/skills/slm-scope/SKILL.md +1 -1
  22. package/plugin/skills/slm-session/SKILL.md +1 -1
  23. package/plugin/skills/slm-status/SKILL.md +1 -1
  24. package/plugin-src/agents/slm-memory-advisor.md +1 -1
  25. package/plugin-src/agents/slm-optimize-advisor.md +1 -1
  26. package/plugin-src/rules/AGENTS.md +1 -1
  27. package/plugin-src/skills/slm-cache/SKILL.md +1 -1
  28. package/plugin-src/skills/slm-compress/SKILL.md +1 -1
  29. package/plugin-src/skills/slm-governance/SKILL.md +1 -1
  30. package/plugin-src/skills/slm-graph/SKILL.md +1 -1
  31. package/plugin-src/skills/slm-loop/SKILL.md +1 -1
  32. package/plugin-src/skills/slm-mesh/SKILL.md +1 -1
  33. package/plugin-src/skills/slm-profile/SKILL.md +1 -1
  34. package/plugin-src/skills/slm-recall/SKILL.md +1 -1
  35. package/plugin-src/skills/slm-remember/SKILL.md +1 -1
  36. package/plugin-src/skills/slm-scope/SKILL.md +1 -1
  37. package/plugin-src/skills/slm-session/SKILL.md +1 -1
  38. package/plugin-src/skills/slm-status/SKILL.md +1 -1
  39. package/scripts/postinstall.js +71 -2
  40. package/pyproject.toml +0 -250
  41. package/src/superlocalmemory/__init__.py +0 -82
  42. package/src/superlocalmemory/access/__init__.py +0 -3
  43. package/src/superlocalmemory/access/rbac.py +0 -575
  44. package/src/superlocalmemory/attribution/__init__.py +0 -9
  45. package/src/superlocalmemory/attribution/signer.py +0 -173
  46. package/src/superlocalmemory/attribution/watermark.py +0 -189
  47. package/src/superlocalmemory/brain/__init__.py +0 -5
  48. package/src/superlocalmemory/brain/truth.py +0 -418
  49. package/src/superlocalmemory/cli/__init__.py +0 -5
  50. package/src/superlocalmemory/cli/__main__.py +0 -17
  51. package/src/superlocalmemory/cli/_lazy_init.py +0 -115
  52. package/src/superlocalmemory/cli/cache_cmd.py +0 -198
  53. package/src/superlocalmemory/cli/commands.py +0 -4710
  54. package/src/superlocalmemory/cli/compress_cmd.py +0 -151
  55. package/src/superlocalmemory/cli/context_commands.py +0 -193
  56. package/src/superlocalmemory/cli/daemon.py +0 -909
  57. package/src/superlocalmemory/cli/db_migrate.py +0 -150
  58. package/src/superlocalmemory/cli/diagnostics_cmd.py +0 -101
  59. package/src/superlocalmemory/cli/escape_hatch.py +0 -220
  60. package/src/superlocalmemory/cli/evidence_cmd.py +0 -103
  61. package/src/superlocalmemory/cli/gdpr_cmd.py +0 -792
  62. package/src/superlocalmemory/cli/gdpr_io.py +0 -109
  63. package/src/superlocalmemory/cli/help_cmd.py +0 -197
  64. package/src/superlocalmemory/cli/host_upgrades.py +0 -189
  65. package/src/superlocalmemory/cli/ingest_cmd.py +0 -327
  66. package/src/superlocalmemory/cli/json_output.py +0 -81
  67. package/src/superlocalmemory/cli/loop_cmd.py +0 -187
  68. package/src/superlocalmemory/cli/main.py +0 -1145
  69. package/src/superlocalmemory/cli/mesh_cmd.py +0 -38
  70. package/src/superlocalmemory/cli/migrate_cmd.py +0 -55
  71. package/src/superlocalmemory/cli/ops_cmd.py +0 -281
  72. package/src/superlocalmemory/cli/optimize_cmd.py +0 -179
  73. package/src/superlocalmemory/cli/optimize_constants.py +0 -31
  74. package/src/superlocalmemory/cli/pending_store.py +0 -296
  75. package/src/superlocalmemory/cli/proxy_cmd.py +0 -108
  76. package/src/superlocalmemory/cli/scale_engine_cmd.py +0 -56
  77. package/src/superlocalmemory/cli/service_installer.py +0 -373
  78. package/src/superlocalmemory/cli/setup_wizard.py +0 -1162
  79. package/src/superlocalmemory/cli/summary_cmd.py +0 -215
  80. package/src/superlocalmemory/cli/version_banner.py +0 -202
  81. package/src/superlocalmemory/cli/wizard_v3426_options.py +0 -129
  82. package/src/superlocalmemory/code_graph/__init__.py +0 -46
  83. package/src/superlocalmemory/code_graph/blast_radius.py +0 -177
  84. package/src/superlocalmemory/code_graph/bridge/__init__.py +0 -36
  85. package/src/superlocalmemory/code_graph/bridge/entity_resolver.py +0 -490
  86. package/src/superlocalmemory/code_graph/bridge/event_listeners.py +0 -206
  87. package/src/superlocalmemory/code_graph/bridge/fact_enricher.py +0 -159
  88. package/src/superlocalmemory/code_graph/bridge/hebbian_linker.py +0 -170
  89. package/src/superlocalmemory/code_graph/bridge/maintenance.py +0 -220
  90. package/src/superlocalmemory/code_graph/bridge/temporal_checker.py +0 -152
  91. package/src/superlocalmemory/code_graph/changes.py +0 -363
  92. package/src/superlocalmemory/code_graph/communities.py +0 -299
  93. package/src/superlocalmemory/code_graph/config.py +0 -154
  94. package/src/superlocalmemory/code_graph/database.py +0 -526
  95. package/src/superlocalmemory/code_graph/extractors/__init__.py +0 -95
  96. package/src/superlocalmemory/code_graph/extractors/python.py +0 -413
  97. package/src/superlocalmemory/code_graph/extractors/typescript.py +0 -556
  98. package/src/superlocalmemory/code_graph/flows.py +0 -350
  99. package/src/superlocalmemory/code_graph/git_hooks.py +0 -226
  100. package/src/superlocalmemory/code_graph/graph_engine.py +0 -295
  101. package/src/superlocalmemory/code_graph/graph_store.py +0 -335
  102. package/src/superlocalmemory/code_graph/incremental.py +0 -200
  103. package/src/superlocalmemory/code_graph/models.py +0 -130
  104. package/src/superlocalmemory/code_graph/parser.py +0 -687
  105. package/src/superlocalmemory/code_graph/resolver.py +0 -321
  106. package/src/superlocalmemory/code_graph/search.py +0 -460
  107. package/src/superlocalmemory/code_graph/service.py +0 -95
  108. package/src/superlocalmemory/code_graph/watcher.py +0 -207
  109. package/src/superlocalmemory/compliance/__init__.py +0 -0
  110. package/src/superlocalmemory/compliance/abac.py +0 -204
  111. package/src/superlocalmemory/compliance/audit.py +0 -385
  112. package/src/superlocalmemory/compliance/eu_ai_act.py +0 -101
  113. package/src/superlocalmemory/compliance/gdpr.py +0 -1479
  114. package/src/superlocalmemory/compliance/lifecycle.py +0 -158
  115. package/src/superlocalmemory/compliance/retention.py +0 -415
  116. package/src/superlocalmemory/compliance/scheduler.py +0 -217
  117. package/src/superlocalmemory/contracts/__init__.py +0 -1
  118. package/src/superlocalmemory/contracts/schemas/agent-experience-v1.schema.json +0 -92
  119. package/src/superlocalmemory/contracts/schemas/agent-integration-contract-v2.schema.json +0 -46
  120. package/src/superlocalmemory/contracts/schemas/cognitive-turn-receipt-v1.schema.json +0 -59
  121. package/src/superlocalmemory/contracts/v402.py +0 -62
  122. package/src/superlocalmemory/core/__init__.py +0 -0
  123. package/src/superlocalmemory/core/actor_context.py +0 -166
  124. package/src/superlocalmemory/core/admission.py +0 -769
  125. package/src/superlocalmemory/core/backend_orchestrator.py +0 -637
  126. package/src/superlocalmemory/core/block_hygiene.py +0 -147
  127. package/src/superlocalmemory/core/community_summary.py +0 -267
  128. package/src/superlocalmemory/core/component_healer.py +0 -144
  129. package/src/superlocalmemory/core/component_registry.py +0 -514
  130. package/src/superlocalmemory/core/config.py +0 -2204
  131. package/src/superlocalmemory/core/consolidation_engine.py +0 -983
  132. package/src/superlocalmemory/core/context_cache.py +0 -574
  133. package/src/superlocalmemory/core/derivation_lineage.py +0 -246
  134. package/src/superlocalmemory/core/embedding_worker.py +0 -208
  135. package/src/superlocalmemory/core/embeddings.py +0 -1052
  136. package/src/superlocalmemory/core/engine.py +0 -1395
  137. package/src/superlocalmemory/core/engine_capabilities.py +0 -24
  138. package/src/superlocalmemory/core/engine_ingestion.py +0 -983
  139. package/src/superlocalmemory/core/engine_lock.py +0 -75
  140. package/src/superlocalmemory/core/engine_wiring.py +0 -776
  141. package/src/superlocalmemory/core/entity_community.py +0 -178
  142. package/src/superlocalmemory/core/error_envelope.py +0 -60
  143. package/src/superlocalmemory/core/evidence_bundle.py +0 -528
  144. package/src/superlocalmemory/core/fact_consolidator.py +0 -812
  145. package/src/superlocalmemory/core/file_lock.py +0 -92
  146. package/src/superlocalmemory/core/graph_analyzer.py +0 -456
  147. package/src/superlocalmemory/core/graph_metrics.py +0 -597
  148. package/src/superlocalmemory/core/graph_pruner.py +0 -939
  149. package/src/superlocalmemory/core/health_monitor.py +0 -338
  150. package/src/superlocalmemory/core/hooks.py +0 -65
  151. package/src/superlocalmemory/core/ingest_gate.py +0 -133
  152. package/src/superlocalmemory/core/ingest_policy.py +0 -38
  153. package/src/superlocalmemory/core/ingestion_command.py +0 -1042
  154. package/src/superlocalmemory/core/injection.py +0 -434
  155. package/src/superlocalmemory/core/install_detector.py +0 -131
  156. package/src/superlocalmemory/core/key_expander.py +0 -138
  157. package/src/superlocalmemory/core/lifecycle_state.py +0 -153
  158. package/src/superlocalmemory/core/maintenance.py +0 -777
  159. package/src/superlocalmemory/core/maintenance_scheduler.py +0 -507
  160. package/src/superlocalmemory/core/materialization_control.py +0 -20
  161. package/src/superlocalmemory/core/mcp_embedder_proxy.py +0 -89
  162. package/src/superlocalmemory/core/memory_health.py +0 -266
  163. package/src/superlocalmemory/core/mode_capability.py +0 -111
  164. package/src/superlocalmemory/core/modes.py +0 -168
  165. package/src/superlocalmemory/core/mutations.py +0 -688
  166. package/src/superlocalmemory/core/ollama_embedder.py +0 -266
  167. package/src/superlocalmemory/core/ollama_validator.py +0 -315
  168. package/src/superlocalmemory/core/operation_policy.py +0 -92
  169. package/src/superlocalmemory/core/operation_policy_registry.py +0 -542
  170. package/src/superlocalmemory/core/operation_request.py +0 -127
  171. package/src/superlocalmemory/core/ops_remediation.py +0 -542
  172. package/src/superlocalmemory/core/pii.py +0 -105
  173. package/src/superlocalmemory/core/platform_utils.py +0 -138
  174. package/src/superlocalmemory/core/profiles.py +0 -234
  175. package/src/superlocalmemory/core/progressive_abstraction.py +0 -208
  176. package/src/superlocalmemory/core/projection_drain.py +0 -380
  177. package/src/superlocalmemory/core/queue_consumer.py +0 -168
  178. package/src/superlocalmemory/core/ram_lock.py +0 -160
  179. package/src/superlocalmemory/core/rate_limit.py +0 -151
  180. package/src/superlocalmemory/core/recall_gate.py +0 -95
  181. package/src/superlocalmemory/core/recall_pipeline.py +0 -1337
  182. package/src/superlocalmemory/core/recall_queue.py +0 -377
  183. package/src/superlocalmemory/core/recall_worker.py +0 -414
  184. package/src/superlocalmemory/core/registry.py +0 -121
  185. package/src/superlocalmemory/core/remember_admission.py +0 -161
  186. package/src/superlocalmemory/core/remember_runtime.py +0 -1190
  187. package/src/superlocalmemory/core/remote_mode.py +0 -214
  188. package/src/superlocalmemory/core/reranker_worker.py +0 -338
  189. package/src/superlocalmemory/core/safe_fs.py +0 -108
  190. package/src/superlocalmemory/core/scale_autopromote.py +0 -196
  191. package/src/superlocalmemory/core/scale_engine.py +0 -915
  192. package/src/superlocalmemory/core/score_contract.py +0 -82
  193. package/src/superlocalmemory/core/security_primitives.py +0 -672
  194. package/src/superlocalmemory/core/session_identity.py +0 -98
  195. package/src/superlocalmemory/core/shadow_router.py +0 -319
  196. package/src/superlocalmemory/core/slm_disabled.py +0 -85
  197. package/src/superlocalmemory/core/status_contract.py +0 -108
  198. package/src/superlocalmemory/core/store_pipeline.py +0 -1404
  199. package/src/superlocalmemory/core/summarizer.py +0 -200
  200. package/src/superlocalmemory/core/tier_manager.py +0 -461
  201. package/src/superlocalmemory/core/topic_signature.py +0 -156
  202. package/src/superlocalmemory/core/transactions/__init__.py +0 -78
  203. package/src/superlocalmemory/core/transactions/concrete_owners.py +0 -604
  204. package/src/superlocalmemory/core/transactions/erasure.py +0 -825
  205. package/src/superlocalmemory/core/transactions/manifest.py +0 -255
  206. package/src/superlocalmemory/core/transactions/manifest_key.py +0 -155
  207. package/src/superlocalmemory/core/transactions/obligations.py +0 -272
  208. package/src/superlocalmemory/core/transactions/owners.py +0 -114
  209. package/src/superlocalmemory/core/transactions/reconciler.py +0 -285
  210. package/src/superlocalmemory/core/transactions/service.py +0 -330
  211. package/src/superlocalmemory/core/worker_pool.py +0 -377
  212. package/src/superlocalmemory/core/working_memory.py +0 -288
  213. package/src/superlocalmemory/dynamics/__init__.py +0 -0
  214. package/src/superlocalmemory/dynamics/activation_guided_quantization.py +0 -374
  215. package/src/superlocalmemory/dynamics/eap_scheduler.py +0 -294
  216. package/src/superlocalmemory/dynamics/ebbinghaus_langevin_coupling.py +0 -171
  217. package/src/superlocalmemory/dynamics/fisher_langevin_coupling.py +0 -227
  218. package/src/superlocalmemory/encoding/__init__.py +0 -0
  219. package/src/superlocalmemory/encoding/auto_linker.py +0 -308
  220. package/src/superlocalmemory/encoding/cognitive_consolidator.py +0 -899
  221. package/src/superlocalmemory/encoding/consolidator.py +0 -472
  222. package/src/superlocalmemory/encoding/context_generator.py +0 -175
  223. package/src/superlocalmemory/encoding/emotional.py +0 -189
  224. package/src/superlocalmemory/encoding/entity_reflexion.py +0 -200
  225. package/src/superlocalmemory/encoding/entity_resolver.py +0 -687
  226. package/src/superlocalmemory/encoding/entropy_gate.py +0 -101
  227. package/src/superlocalmemory/encoding/fact_extractor.py +0 -877
  228. package/src/superlocalmemory/encoding/foresight.py +0 -93
  229. package/src/superlocalmemory/encoding/graph_builder.py +0 -346
  230. package/src/superlocalmemory/encoding/observation_builder.py +0 -177
  231. package/src/superlocalmemory/encoding/prospective_markers.py +0 -262
  232. package/src/superlocalmemory/encoding/scene_builder.py +0 -410
  233. package/src/superlocalmemory/encoding/signal_inference.py +0 -90
  234. package/src/superlocalmemory/encoding/temporal_parser.py +0 -432
  235. package/src/superlocalmemory/encoding/temporal_validator.py +0 -572
  236. package/src/superlocalmemory/encoding/type_router.py +0 -237
  237. package/src/superlocalmemory/evaluation/__init__.py +0 -13
  238. package/src/superlocalmemory/evaluation/calibration.py +0 -308
  239. package/src/superlocalmemory/evolution/__init__.py +0 -29
  240. package/src/superlocalmemory/evolution/blind_verifier.py +0 -122
  241. package/src/superlocalmemory/evolution/budget.py +0 -356
  242. package/src/superlocalmemory/evolution/evolution_store.py +0 -619
  243. package/src/superlocalmemory/evolution/llm_dispatch.py +0 -559
  244. package/src/superlocalmemory/evolution/model_selection.py +0 -175
  245. package/src/superlocalmemory/evolution/mutation_generator.py +0 -226
  246. package/src/superlocalmemory/evolution/skill_activator.py +0 -270
  247. package/src/superlocalmemory/evolution/skill_evolver.py +0 -928
  248. package/src/superlocalmemory/evolution/triggers.py +0 -376
  249. package/src/superlocalmemory/evolution/types.py +0 -114
  250. package/src/superlocalmemory/graph/__init__.py +0 -9
  251. package/src/superlocalmemory/graph/cozo_adjacency.py +0 -122
  252. package/src/superlocalmemory/graph/cozo_backend.py +0 -751
  253. package/src/superlocalmemory/hooks/__init__.py +0 -3
  254. package/src/superlocalmemory/hooks/_outcome_common.py +0 -523
  255. package/src/superlocalmemory/hooks/adapter_base.py +0 -347
  256. package/src/superlocalmemory/hooks/antigravity_adapter.py +0 -171
  257. package/src/superlocalmemory/hooks/auto_capture.py +0 -133
  258. package/src/superlocalmemory/hooks/auto_invoker.py +0 -521
  259. package/src/superlocalmemory/hooks/auto_parameterize.py +0 -147
  260. package/src/superlocalmemory/hooks/auto_recall.py +0 -191
  261. package/src/superlocalmemory/hooks/auto_recall_hook.py +0 -251
  262. package/src/superlocalmemory/hooks/before_web_hook.py +0 -131
  263. package/src/superlocalmemory/hooks/claude_code_hooks.py +0 -637
  264. package/src/superlocalmemory/hooks/codex_assets.py +0 -251
  265. package/src/superlocalmemory/hooks/codex_hooks.py +0 -186
  266. package/src/superlocalmemory/hooks/context_payload.py +0 -311
  267. package/src/superlocalmemory/hooks/copilot_adapter.py +0 -208
  268. package/src/superlocalmemory/hooks/cross_platform_connector.py +0 -90
  269. package/src/superlocalmemory/hooks/cursor_adapter.py +0 -173
  270. package/src/superlocalmemory/hooks/hook_daemon.py +0 -295
  271. package/src/superlocalmemory/hooks/hook_handlers.py +0 -822
  272. package/src/superlocalmemory/hooks/ide_connector.py +0 -246
  273. package/src/superlocalmemory/hooks/memory_protocol.py +0 -158
  274. package/src/superlocalmemory/hooks/portable_kit.py +0 -755
  275. package/src/superlocalmemory/hooks/post_tool_async_hook.py +0 -183
  276. package/src/superlocalmemory/hooks/post_tool_outcome_hook.py +0 -351
  277. package/src/superlocalmemory/hooks/prewarm_auth.py +0 -187
  278. package/src/superlocalmemory/hooks/rules_engine.py +0 -99
  279. package/src/superlocalmemory/hooks/session_registry.py +0 -330
  280. package/src/superlocalmemory/hooks/stop_outcome_hook.py +0 -138
  281. package/src/superlocalmemory/hooks/sync_loop.py +0 -114
  282. package/src/superlocalmemory/hooks/topic_shift_hook.py +0 -302
  283. package/src/superlocalmemory/hooks/user_prompt_hook.py +0 -131
  284. package/src/superlocalmemory/hooks/user_prompt_rehash_hook.py +0 -210
  285. package/src/superlocalmemory/infra/__init__.py +0 -3
  286. package/src/superlocalmemory/infra/auth_middleware.py +0 -145
  287. package/src/superlocalmemory/infra/backup.py +0 -974
  288. package/src/superlocalmemory/infra/backup_obligations.py +0 -423
  289. package/src/superlocalmemory/infra/cache_manager.py +0 -267
  290. package/src/superlocalmemory/infra/cloud_backup.py +0 -788
  291. package/src/superlocalmemory/infra/daemon_identity.py +0 -300
  292. package/src/superlocalmemory/infra/data_root.py +0 -238
  293. package/src/superlocalmemory/infra/event_bus.py +0 -637
  294. package/src/superlocalmemory/infra/local_diagnostics.py +0 -327
  295. package/src/superlocalmemory/infra/pid_manager.py +0 -193
  296. package/src/superlocalmemory/infra/process_identity.py +0 -180
  297. package/src/superlocalmemory/infra/process_reaper.py +0 -624
  298. package/src/superlocalmemory/infra/rate_limiter.py +0 -228
  299. package/src/superlocalmemory/infra/self_heal.py +0 -401
  300. package/src/superlocalmemory/infra/version_integrity.py +0 -229
  301. package/src/superlocalmemory/ingestion/__init__.py +0 -13
  302. package/src/superlocalmemory/ingestion/adapter_manager.py +0 -255
  303. package/src/superlocalmemory/ingestion/base_adapter.py +0 -171
  304. package/src/superlocalmemory/ingestion/calendar_adapter.py +0 -349
  305. package/src/superlocalmemory/ingestion/credentials.py +0 -125
  306. package/src/superlocalmemory/ingestion/gmail_adapter.py +0 -378
  307. package/src/superlocalmemory/ingestion/parsers.py +0 -100
  308. package/src/superlocalmemory/ingestion/transcript_adapter.py +0 -161
  309. package/src/superlocalmemory/integrations/__init__.py +0 -1
  310. package/src/superlocalmemory/integrations/bounded_loops_mcp.py +0 -431
  311. package/src/superlocalmemory/integrations/bounded_loops_v051.py +0 -236
  312. package/src/superlocalmemory/learning/__init__.py +0 -0
  313. package/src/superlocalmemory/learning/adaptive.py +0 -172
  314. package/src/superlocalmemory/learning/arm_catalog.py +0 -97
  315. package/src/superlocalmemory/learning/assertion_miner.py +0 -403
  316. package/src/superlocalmemory/learning/bandit.py +0 -654
  317. package/src/superlocalmemory/learning/bandit_cache.py +0 -131
  318. package/src/superlocalmemory/learning/behavioral.py +0 -542
  319. package/src/superlocalmemory/learning/bootstrap.py +0 -298
  320. package/src/superlocalmemory/learning/consolidation_cycle.py +0 -398
  321. package/src/superlocalmemory/learning/consolidation_quantization_worker.py +0 -115
  322. package/src/superlocalmemory/learning/consolidation_worker.py +0 -261
  323. package/src/superlocalmemory/learning/cross_project.py +0 -408
  324. package/src/superlocalmemory/learning/database.py +0 -698
  325. package/src/superlocalmemory/learning/dedup_hnsw.py +0 -413
  326. package/src/superlocalmemory/learning/engagement.py +0 -487
  327. package/src/superlocalmemory/learning/engagement_features.py +0 -279
  328. package/src/superlocalmemory/learning/ensemble.py +0 -309
  329. package/src/superlocalmemory/learning/entity_compiler.py +0 -356
  330. package/src/superlocalmemory/learning/fact_outcome_joins.py +0 -207
  331. package/src/superlocalmemory/learning/features.py +0 -138
  332. package/src/superlocalmemory/learning/feedback.py +0 -724
  333. package/src/superlocalmemory/learning/forgetting_scheduler.py +0 -375
  334. package/src/superlocalmemory/learning/hnsw_dedup.py +0 -69
  335. package/src/superlocalmemory/learning/labeler.py +0 -85
  336. package/src/superlocalmemory/learning/legacy_migration.py +0 -316
  337. package/src/superlocalmemory/learning/lightgbm_subprocess.py +0 -236
  338. package/src/superlocalmemory/learning/memory_merge.py +0 -175
  339. package/src/superlocalmemory/learning/model_cache.py +0 -267
  340. package/src/superlocalmemory/learning/model_rollback.py +0 -281
  341. package/src/superlocalmemory/learning/outcome_queue.py +0 -306
  342. package/src/superlocalmemory/learning/outcomes.py +0 -286
  343. package/src/superlocalmemory/learning/pattern_miner.py +0 -465
  344. package/src/superlocalmemory/learning/pattern_miner_constants.py +0 -90
  345. package/src/superlocalmemory/learning/pcos.py +0 -291
  346. package/src/superlocalmemory/learning/project_context.py +0 -366
  347. package/src/superlocalmemory/learning/propensity.py +0 -131
  348. package/src/superlocalmemory/learning/ranker.py +0 -300
  349. package/src/superlocalmemory/learning/ranker_common.py +0 -163
  350. package/src/superlocalmemory/learning/ranker_retrain_legacy.py +0 -210
  351. package/src/superlocalmemory/learning/ranker_retrain_online.py +0 -423
  352. package/src/superlocalmemory/learning/reward.py +0 -888
  353. package/src/superlocalmemory/learning/reward_archive.py +0 -223
  354. package/src/superlocalmemory/learning/reward_boost.py +0 -211
  355. package/src/superlocalmemory/learning/reward_from_outcomes.py +0 -365
  356. package/src/superlocalmemory/learning/reward_model.py +0 -144
  357. package/src/superlocalmemory/learning/reward_proxy.py +0 -578
  358. package/src/superlocalmemory/learning/shadow_test.py +0 -524
  359. package/src/superlocalmemory/learning/signal_kinds.py +0 -79
  360. package/src/superlocalmemory/learning/signal_worker.py +0 -268
  361. package/src/superlocalmemory/learning/signals.py +0 -646
  362. package/src/superlocalmemory/learning/skill_performance_miner.py +0 -422
  363. package/src/superlocalmemory/learning/source_quality.py +0 -828
  364. package/src/superlocalmemory/learning/trigram_index.py +0 -548
  365. package/src/superlocalmemory/learning/workflows.py +0 -309
  366. package/src/superlocalmemory/llm/__init__.py +0 -0
  367. package/src/superlocalmemory/llm/backbone.py +0 -364
  368. package/src/superlocalmemory/loops/__init__.py +0 -58
  369. package/src/superlocalmemory/loops/budget.py +0 -58
  370. package/src/superlocalmemory/loops/engine.py +0 -174
  371. package/src/superlocalmemory/loops/ledger.py +0 -298
  372. package/src/superlocalmemory/loops/models.py +0 -152
  373. package/src/superlocalmemory/loops/rules.py +0 -52
  374. package/src/superlocalmemory/math/__init__.py +0 -0
  375. package/src/superlocalmemory/math/ebbinghaus.py +0 -352
  376. package/src/superlocalmemory/math/fisher.py +0 -356
  377. package/src/superlocalmemory/math/fisher_quantized.py +0 -255
  378. package/src/superlocalmemory/math/hopfield.py +0 -282
  379. package/src/superlocalmemory/math/langevin.py +0 -411
  380. package/src/superlocalmemory/math/polar_quant.py +0 -414
  381. package/src/superlocalmemory/math/qjl.py +0 -115
  382. package/src/superlocalmemory/math/sheaf.py +0 -261
  383. package/src/superlocalmemory/math/turbo_quant.py +0 -318
  384. package/src/superlocalmemory/mcp/__init__.py +0 -0
  385. package/src/superlocalmemory/mcp/_daemon_proxy.py +0 -203
  386. package/src/superlocalmemory/mcp/_pool_adapter.py +0 -181
  387. package/src/superlocalmemory/mcp/_stdin_guard.py +0 -60
  388. package/src/superlocalmemory/mcp/agent_context.py +0 -115
  389. package/src/superlocalmemory/mcp/cli_fallback.py +0 -602
  390. package/src/superlocalmemory/mcp/http_transport.py +0 -85
  391. package/src/superlocalmemory/mcp/profiles.py +0 -154
  392. package/src/superlocalmemory/mcp/resources.py +0 -281
  393. package/src/superlocalmemory/mcp/server.py +0 -480
  394. package/src/superlocalmemory/mcp/session_binding.py +0 -98
  395. package/src/superlocalmemory/mcp/shared.py +0 -112
  396. package/src/superlocalmemory/mcp/tools.py +0 -18
  397. package/src/superlocalmemory/mcp/tools_active.py +0 -958
  398. package/src/superlocalmemory/mcp/tools_brain.py +0 -298
  399. package/src/superlocalmemory/mcp/tools_code_graph.py +0 -1717
  400. package/src/superlocalmemory/mcp/tools_context.py +0 -239
  401. package/src/superlocalmemory/mcp/tools_core.py +0 -1112
  402. package/src/superlocalmemory/mcp/tools_evolution.py +0 -343
  403. package/src/superlocalmemory/mcp/tools_learning.py +0 -393
  404. package/src/superlocalmemory/mcp/tools_loops.py +0 -345
  405. package/src/superlocalmemory/mcp/tools_mesh.py +0 -429
  406. package/src/superlocalmemory/mcp/tools_ops.py +0 -115
  407. package/src/superlocalmemory/mcp/tools_optimize.py +0 -322
  408. package/src/superlocalmemory/mcp/tools_summaries.py +0 -147
  409. package/src/superlocalmemory/mcp/tools_v28.py +0 -292
  410. package/src/superlocalmemory/mcp/tools_v3.py +0 -398
  411. package/src/superlocalmemory/mcp/tools_v33.py +0 -507
  412. package/src/superlocalmemory/mesh/__init__.py +0 -12
  413. package/src/superlocalmemory/mesh/broker.py +0 -812
  414. package/src/superlocalmemory/mesh/broker_security.py +0 -470
  415. package/src/superlocalmemory/mesh/discovery.py +0 -365
  416. package/src/superlocalmemory/mesh/lock_protocol.py +0 -313
  417. package/src/superlocalmemory/mesh/node_identity.py +0 -97
  418. package/src/superlocalmemory/mesh/outbox_remote.py +0 -429
  419. package/src/superlocalmemory/mesh/remote_sync.py +0 -829
  420. package/src/superlocalmemory/mesh/state_sync.py +0 -286
  421. package/src/superlocalmemory/migrations/__init__.py +0 -5
  422. package/src/superlocalmemory/migrations/v3_4_25_to_v3_4_26.py +0 -144
  423. package/src/superlocalmemory/optimize/NOTICE +0 -6
  424. package/src/superlocalmemory/optimize/__init__.py +0 -0
  425. package/src/superlocalmemory/optimize/adapters/__init__.py +0 -68
  426. package/src/superlocalmemory/optimize/adapters/_agent_registry.py +0 -120
  427. package/src/superlocalmemory/optimize/adapters/anthropic_adapter.py +0 -112
  428. package/src/superlocalmemory/optimize/adapters/openai_adapter.py +0 -122
  429. package/src/superlocalmemory/optimize/adapters/wrap.py +0 -228
  430. package/src/superlocalmemory/optimize/cache/__init__.py +0 -31
  431. package/src/superlocalmemory/optimize/cache/boundary_store.py +0 -488
  432. package/src/superlocalmemory/optimize/cache/centroid_store.py +0 -199
  433. package/src/superlocalmemory/optimize/cache/context_key.py +0 -67
  434. package/src/superlocalmemory/optimize/cache/exact.py +0 -88
  435. package/src/superlocalmemory/optimize/cache/invalidation.py +0 -36
  436. package/src/superlocalmemory/optimize/cache/key_builder.py +0 -111
  437. package/src/superlocalmemory/optimize/cache/manager.py +0 -737
  438. package/src/superlocalmemory/optimize/cache/semantic.py +0 -637
  439. package/src/superlocalmemory/optimize/cache/stampede.py +0 -50
  440. package/src/superlocalmemory/optimize/compress/__init__.py +0 -17
  441. package/src/superlocalmemory/optimize/compress/align.py +0 -159
  442. package/src/superlocalmemory/optimize/compress/ccr.py +0 -116
  443. package/src/superlocalmemory/optimize/compress/prose_llmlingua.py +0 -71
  444. package/src/superlocalmemory/optimize/compress/router.py +0 -667
  445. package/src/superlocalmemory/optimize/config/__init__.py +0 -56
  446. package/src/superlocalmemory/optimize/config/defaults.py +0 -43
  447. package/src/superlocalmemory/optimize/config/schema.py +0 -327
  448. package/src/superlocalmemory/optimize/config/store.py +0 -270
  449. package/src/superlocalmemory/optimize/metrics/__init__.py +0 -8
  450. package/src/superlocalmemory/optimize/metrics/counters.py +0 -155
  451. package/src/superlocalmemory/optimize/metrics/estimator.py +0 -87
  452. package/src/superlocalmemory/optimize/metrics/exporters.py +0 -77
  453. package/src/superlocalmemory/optimize/metrics/persistence.py +0 -115
  454. package/src/superlocalmemory/optimize/proxy/__init__.py +0 -28
  455. package/src/superlocalmemory/optimize/proxy/_helpers.py +0 -730
  456. package/src/superlocalmemory/optimize/proxy/anthropic_surface.py +0 -375
  457. package/src/superlocalmemory/optimize/proxy/capture.py +0 -550
  458. package/src/superlocalmemory/optimize/proxy/gemini_surface.py +0 -528
  459. package/src/superlocalmemory/optimize/proxy/lifecycle.py +0 -126
  460. package/src/superlocalmemory/optimize/proxy/openai_surface.py +0 -465
  461. package/src/superlocalmemory/optimize/proxy/server.py +0 -199
  462. package/src/superlocalmemory/optimize/proxy/vertex_surface.py +0 -246
  463. package/src/superlocalmemory/optimize/storage/__init__.py +0 -0
  464. package/src/superlocalmemory/optimize/storage/db.py +0 -1185
  465. package/src/superlocalmemory/optimize/storage/schema.py +0 -205
  466. package/src/superlocalmemory/parameterization/__init__.py +0 -47
  467. package/src/superlocalmemory/parameterization/cross_project.py +0 -12
  468. package/src/superlocalmemory/parameterization/pattern_extractor.py +0 -584
  469. package/src/superlocalmemory/parameterization/pii_filter.py +0 -106
  470. package/src/superlocalmemory/parameterization/prompt_injector.py +0 -219
  471. package/src/superlocalmemory/parameterization/prompt_lifecycle.py +0 -281
  472. package/src/superlocalmemory/parameterization/soft_prompt_generator.py +0 -542
  473. package/src/superlocalmemory/parameterization/workflow_miner.py +0 -17
  474. package/src/superlocalmemory/reliability/__init__.py +0 -45
  475. package/src/superlocalmemory/reliability/join_liveness.py +0 -301
  476. package/src/superlocalmemory/reliability/prior_distance.py +0 -243
  477. package/src/superlocalmemory/retrieval/__init__.py +0 -0
  478. package/src/superlocalmemory/retrieval/agentic.py +0 -367
  479. package/src/superlocalmemory/retrieval/ann_index.py +0 -235
  480. package/src/superlocalmemory/retrieval/bm25_channel.py +0 -451
  481. package/src/superlocalmemory/retrieval/bridge_discovery.py +0 -253
  482. package/src/superlocalmemory/retrieval/channel_registry.py +0 -154
  483. package/src/superlocalmemory/retrieval/channel_status.py +0 -117
  484. package/src/superlocalmemory/retrieval/engine.py +0 -1615
  485. package/src/superlocalmemory/retrieval/entity_channel.py +0 -994
  486. package/src/superlocalmemory/retrieval/forgetting_filter.py +0 -160
  487. package/src/superlocalmemory/retrieval/fusion.py +0 -81
  488. package/src/superlocalmemory/retrieval/graph_adjacency.py +0 -219
  489. package/src/superlocalmemory/retrieval/hopfield_channel.py +0 -465
  490. package/src/superlocalmemory/retrieval/profile_channel.py +0 -105
  491. package/src/superlocalmemory/retrieval/quantization_aware_search.py +0 -147
  492. package/src/superlocalmemory/retrieval/remote_reranker.py +0 -758
  493. package/src/superlocalmemory/retrieval/reranker.py +0 -674
  494. package/src/superlocalmemory/retrieval/scope_policy.py +0 -126
  495. package/src/superlocalmemory/retrieval/semantic_channel.py +0 -638
  496. package/src/superlocalmemory/retrieval/spreading.py +0 -288
  497. package/src/superlocalmemory/retrieval/spreading_activation.py +0 -616
  498. package/src/superlocalmemory/retrieval/strategy.py +0 -248
  499. package/src/superlocalmemory/retrieval/temporal_channel.py +0 -433
  500. package/src/superlocalmemory/retrieval/temporal_frame.py +0 -102
  501. package/src/superlocalmemory/retrieval/temporal_utils.py +0 -122
  502. package/src/superlocalmemory/retrieval/temporal_validity_filter.py +0 -499
  503. package/src/superlocalmemory/retrieval/time_window.py +0 -181
  504. package/src/superlocalmemory/retrieval/vector_store.py +0 -863
  505. package/src/superlocalmemory/server/__init__.py +0 -1
  506. package/src/superlocalmemory/server/api.py +0 -310
  507. package/src/superlocalmemory/server/asset_versions.py +0 -171
  508. package/src/superlocalmemory/server/bandit_loops.py +0 -158
  509. package/src/superlocalmemory/server/config_file.py +0 -90
  510. package/src/superlocalmemory/server/consolidation_runner.py +0 -140
  511. package/src/superlocalmemory/server/egress_policy.py +0 -258
  512. package/src/superlocalmemory/server/loopback.py +0 -85
  513. package/src/superlocalmemory/server/middleware/__init__.py +0 -11
  514. package/src/superlocalmemory/server/middleware/security_headers.py +0 -144
  515. package/src/superlocalmemory/server/origin.py +0 -55
  516. package/src/superlocalmemory/server/profile_runtime.py +0 -515
  517. package/src/superlocalmemory/server/rbac_enforce.py +0 -194
  518. package/src/superlocalmemory/server/recall_health.py +0 -343
  519. package/src/superlocalmemory/server/recall_serializer.py +0 -320
  520. package/src/superlocalmemory/server/route_mutations.py +0 -104
  521. package/src/superlocalmemory/server/routes/__init__.py +0 -4
  522. package/src/superlocalmemory/server/routes/abstraction.py +0 -314
  523. package/src/superlocalmemory/server/routes/adapters.py +0 -63
  524. package/src/superlocalmemory/server/routes/agents.py +0 -303
  525. package/src/superlocalmemory/server/routes/backup.py +0 -869
  526. package/src/superlocalmemory/server/routes/behavioral.py +0 -659
  527. package/src/superlocalmemory/server/routes/brain.py +0 -1892
  528. package/src/superlocalmemory/server/routes/chat.py +0 -393
  529. package/src/superlocalmemory/server/routes/compliance.py +0 -533
  530. package/src/superlocalmemory/server/routes/config_api.py +0 -703
  531. package/src/superlocalmemory/server/routes/data_io.py +0 -329
  532. package/src/superlocalmemory/server/routes/entity.py +0 -237
  533. package/src/superlocalmemory/server/routes/events.py +0 -214
  534. package/src/superlocalmemory/server/routes/evolution.py +0 -510
  535. package/src/superlocalmemory/server/routes/helpers.py +0 -499
  536. package/src/superlocalmemory/server/routes/ingest.py +0 -137
  537. package/src/superlocalmemory/server/routes/insights.py +0 -366
  538. package/src/superlocalmemory/server/routes/learning.py +0 -834
  539. package/src/superlocalmemory/server/routes/learning_telemetry.py +0 -154
  540. package/src/superlocalmemory/server/routes/lifecycle.py +0 -184
  541. package/src/superlocalmemory/server/routes/memories.py +0 -1661
  542. package/src/superlocalmemory/server/routes/mesh.py +0 -517
  543. package/src/superlocalmemory/server/routes/mesh_lock.py +0 -54
  544. package/src/superlocalmemory/server/routes/mesh_state.py +0 -63
  545. package/src/superlocalmemory/server/routes/optimize.py +0 -197
  546. package/src/superlocalmemory/server/routes/prewarm.py +0 -173
  547. package/src/superlocalmemory/server/routes/profiles.py +0 -292
  548. package/src/superlocalmemory/server/routes/ratelimit.py +0 -132
  549. package/src/superlocalmemory/server/routes/rbac.py +0 -366
  550. package/src/superlocalmemory/server/routes/stats.py +0 -385
  551. package/src/superlocalmemory/server/routes/tiers.py +0 -222
  552. package/src/superlocalmemory/server/routes/timeline.py +0 -258
  553. package/src/superlocalmemory/server/routes/token.py +0 -90
  554. package/src/superlocalmemory/server/routes/v3_api.py +0 -3023
  555. package/src/superlocalmemory/server/routes/ws.py +0 -171
  556. package/src/superlocalmemory/server/security_middleware.py +0 -89
  557. package/src/superlocalmemory/server/ui.py +0 -354
  558. package/src/superlocalmemory/server/unified_daemon.py +0 -6326
  559. package/src/superlocalmemory/server/write_identity.py +0 -195
  560. package/src/superlocalmemory/storage/__init__.py +0 -0
  561. package/src/superlocalmemory/storage/_migration_internals.py +0 -638
  562. package/src/superlocalmemory/storage/_schema_version.py +0 -174
  563. package/src/superlocalmemory/storage/access_log.py +0 -170
  564. package/src/superlocalmemory/storage/admission_codec.py +0 -129
  565. package/src/superlocalmemory/storage/admission_journal.py +0 -843
  566. package/src/superlocalmemory/storage/agent_experience.py +0 -546
  567. package/src/superlocalmemory/storage/backup.py +0 -531
  568. package/src/superlocalmemory/storage/correction_cases.py +0 -670
  569. package/src/superlocalmemory/storage/database.py +0 -3180
  570. package/src/superlocalmemory/storage/deferred_writes.py +0 -209
  571. package/src/superlocalmemory/storage/embedding_codec.py +0 -200
  572. package/src/superlocalmemory/storage/embedding_migrator.py +0 -672
  573. package/src/superlocalmemory/storage/erasure_fence.py +0 -45
  574. package/src/superlocalmemory/storage/execution_learning.py +0 -285
  575. package/src/superlocalmemory/storage/external_evidence.py +0 -359
  576. package/src/superlocalmemory/storage/generation_fence.py +0 -63
  577. package/src/superlocalmemory/storage/lineage_retention.py +0 -236
  578. package/src/superlocalmemory/storage/logical_edges.py +0 -86
  579. package/src/superlocalmemory/storage/memory_write.py +0 -115
  580. package/src/superlocalmemory/storage/migration_runner.py +0 -895
  581. package/src/superlocalmemory/storage/migration_v33.py +0 -140
  582. package/src/superlocalmemory/storage/migrations/M001_add_signal_features_columns.py +0 -67
  583. package/src/superlocalmemory/storage/migrations/M002_model_state_history.py +0 -107
  584. package/src/superlocalmemory/storage/migrations/M003_migration_log.py +0 -38
  585. package/src/superlocalmemory/storage/migrations/M004_cross_platform_sync_log.py +0 -46
  586. package/src/superlocalmemory/storage/migrations/M005_bandit_tables.py +0 -75
  587. package/src/superlocalmemory/storage/migrations/M006_action_outcomes_reward.py +0 -75
  588. package/src/superlocalmemory/storage/migrations/M007_pending_outcomes.py +0 -63
  589. package/src/superlocalmemory/storage/migrations/M009_model_lineage.py +0 -94
  590. package/src/superlocalmemory/storage/migrations/M010_evolution_config.py +0 -80
  591. package/src/superlocalmemory/storage/migrations/M011_archive_and_merge.py +0 -87
  592. package/src/superlocalmemory/storage/migrations/M012_shadow_observations.py +0 -72
  593. package/src/superlocalmemory/storage/migrations/M013_bi_temporal_columns.py +0 -55
  594. package/src/superlocalmemory/storage/migrations/M014_v345_scale_ready.py +0 -45
  595. package/src/superlocalmemory/storage/migrations/M015_add_pinned_column.py +0 -58
  596. package/src/superlocalmemory/storage/migrations/M016_add_scope_support.py +0 -120
  597. package/src/superlocalmemory/storage/migrations/M017_ccq_scope_column.py +0 -79
  598. package/src/superlocalmemory/storage/migrations/M018_ingestion_operations.py +0 -120
  599. package/src/superlocalmemory/storage/migrations/M019_derivation_lineage.py +0 -54
  600. package/src/superlocalmemory/storage/migrations/M020_model_state_integrity.py +0 -52
  601. package/src/superlocalmemory/storage/migrations/M021_ingestion_log_profile.py +0 -108
  602. package/src/superlocalmemory/storage/migrations/M022_entity_aliases_profile.py +0 -86
  603. package/src/superlocalmemory/storage/migrations/M023_mesh_profile_isolation.py +0 -194
  604. package/src/superlocalmemory/storage/migrations/M024_rbac_users_roles.py +0 -87
  605. package/src/superlocalmemory/storage/migrations/M025_perf_indexes.py +0 -90
  606. package/src/superlocalmemory/storage/migrations/M026_rbac_memberships_fk.py +0 -136
  607. package/src/superlocalmemory/storage/migrations/M027_transferable_patterns_profile.py +0 -163
  608. package/src/superlocalmemory/storage/migrations/M028_fact_entity_associations.py +0 -305
  609. package/src/superlocalmemory/storage/migrations/M029_behavioral_history_indexes.py +0 -137
  610. package/src/superlocalmemory/storage/migrations/M030_entity_explorer_indexes.py +0 -93
  611. package/src/superlocalmemory/storage/migrations/M031_dead_letter_operations.py +0 -80
  612. package/src/superlocalmemory/storage/migrations/M032_write_coordinator_admission.py +0 -188
  613. package/src/superlocalmemory/storage/migrations/M033_projection_transactions.py +0 -148
  614. package/src/superlocalmemory/storage/migrations/M034_obligation_integrity.py +0 -58
  615. package/src/superlocalmemory/storage/migrations/M035_erasure_receipts.py +0 -113
  616. package/src/superlocalmemory/storage/migrations/M036_vector_row_map.py +0 -107
  617. package/src/superlocalmemory/storage/migrations/M037_manifest_hmac_version.py +0 -162
  618. package/src/superlocalmemory/storage/migrations/M038_learning_feedback_channel.py +0 -77
  619. package/src/superlocalmemory/storage/migrations/M039_scene_fact_members.py +0 -137
  620. package/src/superlocalmemory/storage/migrations/M040_agent_experience_receipts.py +0 -254
  621. package/src/superlocalmemory/storage/migrations/M041_external_evidence_receipts.py +0 -189
  622. package/src/superlocalmemory/storage/migrations/M042_correction_case_ledger.py +0 -245
  623. package/src/superlocalmemory/storage/migrations/M043_quarantine_display_summaries.py +0 -512
  624. package/src/superlocalmemory/storage/migrations/M044_play_carries_its_own_evidence.py +0 -127
  625. package/src/superlocalmemory/storage/migrations/M045_fact_outcome_score.py +0 -158
  626. package/src/superlocalmemory/storage/migrations/M046_prospective_memory_has_its_own_name.py +0 -620
  627. package/src/superlocalmemory/storage/migrations/M047_fisher_vectors_are_stored_like_every_other_vector.py +0 -306
  628. package/src/superlocalmemory/storage/migrations/M048_upcoming_holds_only_what_is_upcoming.py +0 -229
  629. package/src/superlocalmemory/storage/migrations/M049_a_schema_version_marker_is_one_row.py +0 -201
  630. package/src/superlocalmemory/storage/migrations/M050_execution_learning_v2.py +0 -70
  631. package/src/superlocalmemory/storage/migrations/__init__.py +0 -103
  632. package/src/superlocalmemory/storage/migrations.py +0 -333
  633. package/src/superlocalmemory/storage/models.py +0 -500
  634. package/src/superlocalmemory/storage/projection_outbox.py +0 -346
  635. package/src/superlocalmemory/storage/quantized_store.py +0 -280
  636. package/src/superlocalmemory/storage/read_connection.py +0 -115
  637. package/src/superlocalmemory/storage/retention_policy.py +0 -860
  638. package/src/superlocalmemory/storage/schema.py +0 -1108
  639. package/src/superlocalmemory/storage/schema_code_graph.py +0 -282
  640. package/src/superlocalmemory/storage/schema_v32.py +0 -382
  641. package/src/superlocalmemory/storage/schema_v3410.py +0 -159
  642. package/src/superlocalmemory/storage/schema_v3411.py +0 -149
  643. package/src/superlocalmemory/storage/schema_v343.py +0 -315
  644. package/src/superlocalmemory/storage/schema_v345.py +0 -109
  645. package/src/superlocalmemory/storage/schema_v347.py +0 -140
  646. package/src/superlocalmemory/storage/sqlite_vectors.py +0 -169
  647. package/src/superlocalmemory/storage/v2_migrator.py +0 -466
  648. package/src/superlocalmemory/storage/write_coordinator.py +0 -949
  649. package/src/superlocalmemory/storage/write_lock.py +0 -88
  650. package/src/superlocalmemory/summaries/__init__.py +0 -37
  651. package/src/superlocalmemory/summaries/base.py +0 -267
  652. package/src/superlocalmemory/summaries/daily_reflection.py +0 -340
  653. package/src/superlocalmemory/summaries/non_answer.py +0 -223
  654. package/src/superlocalmemory/summaries/project_work_log.py +0 -440
  655. package/src/superlocalmemory/summaries/session_summary.py +0 -311
  656. package/src/superlocalmemory/trust/__init__.py +0 -0
  657. package/src/superlocalmemory/trust/gate.py +0 -171
  658. package/src/superlocalmemory/trust/provenance.py +0 -124
  659. package/src/superlocalmemory/trust/scorer.py +0 -413
  660. package/src/superlocalmemory/trust/signals.py +0 -153
  661. package/src/superlocalmemory/ui/assets/slm-icon-white.svg +0 -64
  662. package/src/superlocalmemory/ui/assets/slm-icon.svg +0 -36
  663. package/src/superlocalmemory/ui/css/brain.css +0 -409
  664. package/src/superlocalmemory/ui/css/design-system.css +0 -696
  665. package/src/superlocalmemory/ui/css/legacy-dashboard.css +0 -663
  666. package/src/superlocalmemory/ui/css/neural-glass.css +0 -1599
  667. package/src/superlocalmemory/ui/css/od-bridge.css +0 -158
  668. package/src/superlocalmemory/ui/favicon.svg +0 -36
  669. package/src/superlocalmemory/ui/index.html +0 -1638
  670. package/src/superlocalmemory/ui/js/agents.js +0 -192
  671. package/src/superlocalmemory/ui/js/auto-settings.js +0 -624
  672. package/src/superlocalmemory/ui/js/brain.js +0 -1400
  673. package/src/superlocalmemory/ui/js/clusters.js +0 -326
  674. package/src/superlocalmemory/ui/js/compliance.js +0 -307
  675. package/src/superlocalmemory/ui/js/core.js +0 -566
  676. package/src/superlocalmemory/ui/js/dashboard.js +0 -503
  677. package/src/superlocalmemory/ui/js/event-delegation.js +0 -113
  678. package/src/superlocalmemory/ui/js/events.js +0 -178
  679. package/src/superlocalmemory/ui/js/fact-detail.js +0 -142
  680. package/src/superlocalmemory/ui/js/feedback.js +0 -339
  681. package/src/superlocalmemory/ui/js/graph-event-bus.js +0 -83
  682. package/src/superlocalmemory/ui/js/graph-filters.js +0 -220
  683. package/src/superlocalmemory/ui/js/graph-ui.js +0 -214
  684. package/src/superlocalmemory/ui/js/ide-status.js +0 -115
  685. package/src/superlocalmemory/ui/js/init.js +0 -54
  686. package/src/superlocalmemory/ui/js/knowledge-graph.js +0 -945
  687. package/src/superlocalmemory/ui/js/lifecycle.js +0 -387
  688. package/src/superlocalmemory/ui/js/math-health.js +0 -114
  689. package/src/superlocalmemory/ui/js/memories.js +0 -394
  690. package/src/superlocalmemory/ui/js/memory-chat.js +0 -371
  691. package/src/superlocalmemory/ui/js/memory-timeline.js +0 -265
  692. package/src/superlocalmemory/ui/js/modal.js +0 -733
  693. package/src/superlocalmemory/ui/js/ng-entities.js +0 -298
  694. package/src/superlocalmemory/ui/js/ng-health.js +0 -208
  695. package/src/superlocalmemory/ui/js/ng-ingestion.js +0 -203
  696. package/src/superlocalmemory/ui/js/ng-mesh.js +0 -374
  697. package/src/superlocalmemory/ui/js/ng-shell.js +0 -524
  698. package/src/superlocalmemory/ui/js/ng-skills.js +0 -663
  699. package/src/superlocalmemory/ui/js/od-agents.js +0 -588
  700. package/src/superlocalmemory/ui/js/od-auth-gate.js +0 -257
  701. package/src/superlocalmemory/ui/js/od-backup.js +0 -878
  702. package/src/superlocalmemory/ui/js/od-boundedloops.js +0 -324
  703. package/src/superlocalmemory/ui/js/od-brain.js +0 -1095
  704. package/src/superlocalmemory/ui/js/od-compliance-ext.js +0 -301
  705. package/src/superlocalmemory/ui/js/od-components.js +0 -147
  706. package/src/superlocalmemory/ui/js/od-entities.js +0 -622
  707. package/src/superlocalmemory/ui/js/od-graph.js +0 -776
  708. package/src/superlocalmemory/ui/js/od-health.js +0 -579
  709. package/src/superlocalmemory/ui/js/od-mcp.js +0 -508
  710. package/src/superlocalmemory/ui/js/od-memories.js +0 -1499
  711. package/src/superlocalmemory/ui/js/od-mesh.js +0 -645
  712. package/src/superlocalmemory/ui/js/od-operations.js +0 -1268
  713. package/src/superlocalmemory/ui/js/od-ops-health.js +0 -417
  714. package/src/superlocalmemory/ui/js/od-optimize.js +0 -828
  715. package/src/superlocalmemory/ui/js/od-settings.js +0 -1275
  716. package/src/superlocalmemory/ui/js/od-shell.js +0 -819
  717. package/src/superlocalmemory/ui/js/od-skills.js +0 -600
  718. package/src/superlocalmemory/ui/js/od-team.js +0 -265
  719. package/src/superlocalmemory/ui/js/optimize.js +0 -191
  720. package/src/superlocalmemory/ui/js/profiles.js +0 -362
  721. package/src/superlocalmemory/ui/js/quick-actions.js +0 -334
  722. package/src/superlocalmemory/ui/js/recall-lab.js +0 -373
  723. package/src/superlocalmemory/ui/js/search.js +0 -86
  724. package/src/superlocalmemory/ui/js/settings.js +0 -556
  725. package/src/superlocalmemory/ui/js/timeline.js +0 -62
  726. package/src/superlocalmemory/ui/js/trust-dashboard.js +0 -225
  727. package/src/superlocalmemory/ui/vendor/bootstrap-icons/bootstrap-icons.css +0 -2018
  728. package/src/superlocalmemory/ui/vendor/bootstrap-icons/fonts/bootstrap-icons.woff +0 -0
  729. package/src/superlocalmemory/ui/vendor/bootstrap-icons/fonts/bootstrap-icons.woff2 +0 -0
  730. package/src/superlocalmemory/ui/vendor/bootstrap.bundle.min.js +0 -7
  731. package/src/superlocalmemory/ui/vendor/bootstrap.min.css +0 -6
  732. package/src/superlocalmemory/ui/vendor/d3.v7.min.js +0 -2
  733. package/src/superlocalmemory/ui/vendor/graphology-library.min.js +0 -2
  734. package/src/superlocalmemory/ui/vendor/graphology.umd.min.js +0 -2
  735. package/src/superlocalmemory/ui/vendor/inter-ui/inter-variable.min.css +0 -8
  736. package/src/superlocalmemory/ui/vendor/inter-ui/variable/InterVariable-Italic.woff2 +0 -0
  737. package/src/superlocalmemory/ui/vendor/inter-ui/variable/InterVariable.woff2 +0 -0
  738. package/src/superlocalmemory/ui/vendor/sigma.min.js +0 -1
  739. package/src/superlocalmemory/vector/__init__.py +0 -9
  740. package/src/superlocalmemory/vector/lancedb_backend.py +0 -366
@@ -1,788 +0,0 @@
1
- # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
2
- # Licensed under AGPL-3.0-or-later - see LICENSE file
3
- # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
4
-
5
- """SuperLocalMemory V3.4.10 "Fortress" — Cloud Backup Infrastructure.
6
-
7
- Pushes local SQLite backups to configured cloud destinations:
8
- - Google Drive (OAuth2 + Drive API v3)
9
- - GitHub (PAT + Releases API)
10
-
11
- All credentials stored in OS keychain via `keyring` library.
12
- All operations are non-blocking and failure-tolerant.
13
-
14
- Part of Qualixar | Author: Varun Pratap Bhardwaj
15
- """
16
-
17
- from __future__ import annotations
18
-
19
- import json
20
- import logging
21
- import os
22
- import sqlite3
23
- import tempfile
24
- from datetime import datetime, UTC, timezone
25
- from pathlib import Path
26
- from typing import Any
27
-
28
- from superlocalmemory.infra.data_root import canonical_data_root
29
- from superlocalmemory.storage.memory_write import memory_write
30
-
31
- logger = logging.getLogger("superlocalmemory.cloud_backup")
32
-
33
- MEMORY_DIR = None # test-only compatibility override
34
- DB_PATH = None # test-only compatibility override
35
- KEYRING_SERVICE = "superlocalmemory"
36
-
37
-
38
- def _memory_dir() -> Path:
39
- return Path(MEMORY_DIR) if MEMORY_DIR is not None else canonical_data_root()
40
-
41
-
42
- def _default_db_path() -> Path:
43
- return Path(DB_PATH) if DB_PATH is not None else _memory_dir() / "memory.db"
44
-
45
- # Stage-9 fix: hoist NoKeyringError to module scope. Previously each function
46
- # did `from keyring.errors import NoKeyringError` INSIDE the same try whose
47
- # `import keyring` could fail — leaving the name unbound when the `except
48
- # (ImportError, NoKeyringError)` tuple was evaluated, which raised
49
- # UnboundLocalError on every keyring-free host (headless Linux / minimal
50
- # Docker) and made the plaintext fallback unreachable. A sentinel subclass is
51
- # used when keyring is absent so the except-tuple is always valid and simply
52
- # never matches.
53
- try:
54
- from keyring.errors import NoKeyringError as _NoKeyringError
55
- except Exception: # keyring not installed at all
56
- class _NoKeyringError(Exception):
57
- """Sentinel — keyring unavailable; this is never raised."""
58
-
59
- # ---------------------------------------------------------------------------
60
- # Credential management (OS keychain)
61
- # ---------------------------------------------------------------------------
62
-
63
-
64
- def _get_credential_store() -> Path:
65
- """Fallback plaintext-local-file credential store for systems without a keychain."""
66
- return _memory_dir() / ".credentials.json"
67
-
68
-
69
- def _atomic_write_creds(store_path: Path, data: dict) -> None:
70
- """Write credential data atomically at 0o600 from creation.
71
-
72
- Uses os.open with O_CREAT|O_WRONLY|O_TRUNC|O_NOFOLLOW and mode 0o600 so
73
- the file is never world-readable — not even for an instant. The payload
74
- is written to a temp file in the SAME directory (guaranteeing same device),
75
- fsynced, and then renamed into place via os.replace() so the old store
76
- survives any crash between write and rename (atomic on POSIX).
77
-
78
- Mirrors the pattern used in optimize/proxy/capture.py:111-112.
79
- """
80
- parent = store_path.parent
81
- parent.mkdir(parents=True, exist_ok=True)
82
- # Ensure the directory itself is private — 0o700 (owner rwx only)
83
- try:
84
- os.chmod(parent, 0o700)
85
- except OSError:
86
- pass # Best-effort; existing dirs may be fine already
87
-
88
- payload = json.dumps(data).encode()
89
-
90
- # Write to a temp file in the SAME directory (same filesystem → atomic rename)
91
- tmp_fd, tmp_name = tempfile.mkstemp(dir=parent, prefix=".creds-")
92
- try:
93
- # Re-open with 0o600; mkstemp already creates with 0o600 on POSIX.
94
- # Use os.open with O_NOFOLLOW on the temp name to refuse symlink tricks.
95
- os.close(tmp_fd)
96
- flags = os.O_WRONLY | os.O_TRUNC | getattr(os, "O_NOFOLLOW", 0)
97
- fd = os.open(tmp_name, flags, 0o600)
98
- try:
99
- os.write(fd, payload)
100
- os.fsync(fd)
101
- finally:
102
- os.close(fd)
103
- os.replace(tmp_name, store_path)
104
- except Exception:
105
- # Clean up the temp file if rename failed; let caller log & re-raise
106
- try:
107
- os.unlink(tmp_name)
108
- except FileNotFoundError:
109
- pass
110
- raise
111
-
112
-
113
- def _store_credential(key: str, value: str) -> bool:
114
- """Store a credential in the OS keychain (macOS/Windows/Linux).
115
-
116
- Falls back to a plaintext local file (owner read/write only, 0o600) on
117
- headless Linux or if the keyring backend is unavailable.
118
- """
119
- # Try OS keychain first (macOS Keychain, Windows Credential Locker, Linux SecretService)
120
- try:
121
- import keyring
122
- keyring.set_password(KEYRING_SERVICE, key, value)
123
- return True
124
- except (ImportError, _NoKeyringError):
125
- pass # No keyring backend — use fallback
126
- except Exception as exc:
127
- logger.debug("Keyring store failed, using fallback: %s", exc)
128
-
129
- # Fallback: plaintext local file, atomic write at 0o600 from creation
130
- try:
131
- store_path = _get_credential_store()
132
- existing: dict = {}
133
- if store_path.exists():
134
- try:
135
- existing = json.loads(store_path.read_text())
136
- except json.JSONDecodeError as exc:
137
- logger.warning(
138
- "Credential store corrupt (JSON decode error), starting fresh: %s", exc
139
- )
140
- existing[key] = value
141
- _atomic_write_creds(store_path, existing)
142
- return True
143
- except Exception as exc:
144
- logger.warning("Failed to store credential '%s': %s", key, exc)
145
- return False
146
-
147
-
148
- def _get_credential(key: str) -> str | None:
149
- """Retrieve a credential from the OS keychain or fallback store."""
150
- # Try OS keychain first
151
- try:
152
- import keyring
153
- val = keyring.get_password(KEYRING_SERVICE, key)
154
- if val is not None:
155
- return val
156
- except (ImportError, _NoKeyringError):
157
- pass
158
- except Exception:
159
- pass
160
-
161
- # Fallback: plaintext local file
162
- try:
163
- store_path = _get_credential_store()
164
- if store_path.exists():
165
- try:
166
- data = json.loads(store_path.read_text())
167
- return data.get(key)
168
- except json.JSONDecodeError as exc:
169
- logger.warning(
170
- "Credential store corrupt (JSON decode error), cannot read key '%s': %s",
171
- key,
172
- exc,
173
- )
174
- return None
175
- except Exception:
176
- pass
177
-
178
- return None
179
-
180
-
181
- def _delete_credential(key: str) -> bool:
182
- """Delete a credential from the OS keychain and fallback store."""
183
- deleted = False
184
-
185
- try:
186
- import keyring
187
- keyring.delete_password(KEYRING_SERVICE, key)
188
- deleted = True
189
- except (ImportError, _NoKeyringError):
190
- pass
191
- except Exception:
192
- pass
193
-
194
- # Also clean from fallback store — atomic write at 0o600
195
- try:
196
- store_path = _get_credential_store()
197
- if store_path.exists():
198
- try:
199
- data = json.loads(store_path.read_text())
200
- except json.JSONDecodeError as exc:
201
- logger.warning(
202
- "Credential store corrupt (JSON decode error) during delete of '%s': %s",
203
- key,
204
- exc,
205
- )
206
- return deleted
207
- if key in data:
208
- del data[key]
209
- _atomic_write_creds(store_path, data)
210
- deleted = True
211
- except Exception as exc:
212
- logger.warning("Failed to delete credential '%s' from fallback store: %s", key, exc)
213
-
214
- return deleted
215
-
216
-
217
- # ---------------------------------------------------------------------------
218
- # Destination registry (backed by SQLite)
219
- # ---------------------------------------------------------------------------
220
-
221
-
222
- def get_destinations(db_path: Path | None = None) -> list[dict[str, Any]]:
223
- """List all configured backup destinations."""
224
- path = db_path or _default_db_path()
225
- if not path.exists():
226
- return []
227
- conn = sqlite3.connect(str(path))
228
- conn.row_factory = sqlite3.Row
229
- try:
230
- rows = conn.execute(
231
- "SELECT * FROM backup_destinations ORDER BY created_at"
232
- ).fetchall()
233
- return [dict(r) for r in rows]
234
- except sqlite3.OperationalError:
235
- return []
236
- finally:
237
- conn.close()
238
-
239
-
240
- def add_destination(
241
- destination_type: str,
242
- display_name: str,
243
- config: dict[str, Any],
244
- credentials_ref: str = "",
245
- db_path: Path | None = None,
246
- ) -> str:
247
- """Register a new backup destination. Returns destination ID."""
248
- from superlocalmemory.storage.models import _new_id
249
-
250
- dest_id = _new_id()
251
- path = db_path or _default_db_path()
252
- with memory_write(path) as conn:
253
- conn.execute(
254
- "INSERT INTO backup_destinations "
255
- "(id, destination_type, display_name, credentials_ref, config, "
256
- "created_at, enabled) VALUES (?, ?, ?, ?, ?, ?, 1)",
257
- (dest_id, destination_type, display_name, credentials_ref,
258
- json.dumps(config), datetime.now(UTC).isoformat()),
259
- )
260
- logger.info("Added backup destination: %s (%s)", display_name, destination_type)
261
- return dest_id
262
-
263
-
264
- def remove_destination(dest_id: str, db_path: Path | None = None) -> bool:
265
- """Remove a backup destination and its credentials."""
266
- path = db_path or _default_db_path()
267
- try:
268
- # Fetch credentials_ref with a short read before taking the write lock.
269
- import sqlite3 as _sqlite3
270
- creds_ref = None
271
- try:
272
- with _sqlite3.connect(str(path)) as rconn:
273
- row = rconn.execute(
274
- "SELECT credentials_ref FROM backup_destinations WHERE id = ?",
275
- (dest_id,),
276
- ).fetchone()
277
- creds_ref = row[0] if row else None
278
- except Exception:
279
- pass
280
- if creds_ref:
281
- _delete_credential(creds_ref)
282
- with memory_write(path) as conn:
283
- conn.execute("DELETE FROM backup_destinations WHERE id = ?", (dest_id,))
284
- return True
285
- except Exception as exc:
286
- logger.error("Failed to remove destination %s: %s", dest_id, exc)
287
- return False
288
-
289
-
290
- def update_sync_status(
291
- dest_id: str,
292
- status: str,
293
- error: str = "",
294
- db_path: Path | None = None,
295
- ) -> None:
296
- """Update the sync status of a destination."""
297
- path = db_path or _default_db_path()
298
- try:
299
- with memory_write(path) as conn:
300
- conn.execute(
301
- "UPDATE backup_destinations SET last_sync_at = ?, "
302
- "last_sync_status = ?, last_sync_error = ? WHERE id = ?",
303
- (datetime.now(UTC).isoformat(), status, error, dest_id),
304
- )
305
- except Exception:
306
- pass
307
-
308
-
309
- # ---------------------------------------------------------------------------
310
- # Google Drive integration
311
- # ---------------------------------------------------------------------------
312
-
313
-
314
- def connect_google_drive(auth_code: str, redirect_uri: str) -> dict[str, Any]:
315
- """Complete Google Drive OAuth2 flow and register as a destination.
316
-
317
- Args:
318
- auth_code: Authorization code from OAuth2 consent screen redirect.
319
- redirect_uri: The redirect URI used in the OAuth2 flow.
320
-
321
- Returns:
322
- Dict with destination_id, user_email, and status.
323
- """
324
- try:
325
- from google.oauth2.credentials import Credentials
326
- from google_auth_oauthlib.flow import Flow
327
- except ImportError:
328
- return {"error": "google-auth-oauthlib not installed. Run: pip install google-auth-oauthlib google-api-python-client"}
329
-
330
- # OAuth2 client config (public client — no secret needed for installed apps)
331
- client_config = {
332
- "installed": {
333
- "client_id": _get_credential("gdrive_client_id") or "",
334
- "client_secret": _get_credential("gdrive_client_secret") or "",
335
- "auth_uri": "https://accounts.google.com/o/oauth2/auth",
336
- "token_uri": "https://oauth2.googleapis.com/token",
337
- "redirect_uris": ["http://localhost"],
338
- }
339
- }
340
-
341
- if not client_config["installed"]["client_id"]:
342
- return {"error": "Google OAuth client not configured. Set client_id via dashboard."}
343
-
344
- try:
345
- flow = Flow.from_client_config(
346
- client_config,
347
- scopes=[
348
- "openid",
349
- "https://www.googleapis.com/auth/drive.file",
350
- "https://www.googleapis.com/auth/userinfo.email",
351
- ],
352
- redirect_uri=redirect_uri,
353
- )
354
- flow.fetch_token(code=auth_code)
355
- creds = flow.credentials
356
-
357
- # Store refresh token in keychain
358
- cred_key = "gdrive_refresh_token"
359
- _store_credential(cred_key, creds.refresh_token or "")
360
- _store_credential("gdrive_access_token", creds.token or "")
361
-
362
- # Get user email for display
363
- from googleapiclient.discovery import build
364
- service = build("oauth2", "v2", credentials=creds)
365
- user_info = service.userinfo().get().execute()
366
- email = user_info.get("email", "unknown")
367
-
368
- # Register destination
369
- dest_id = add_destination(
370
- destination_type="google_drive",
371
- display_name=f"Google Drive ({email})",
372
- config={"email": email, "folder": "SLM-Backup"},
373
- credentials_ref=cred_key,
374
- )
375
-
376
- return {"destination_id": dest_id, "email": email, "status": "connected"}
377
-
378
- except Exception as exc:
379
- logger.error("Google Drive connection failed: %s", exc)
380
- return {"error": str(exc)}
381
-
382
-
383
- def _get_drive_service() -> Any | None:
384
- """Build an authenticated Google Drive service."""
385
- try:
386
- from google.oauth2.credentials import Credentials
387
- from googleapiclient.discovery import build
388
-
389
- refresh_token = _get_credential("gdrive_refresh_token")
390
- client_id = _get_credential("gdrive_client_id")
391
- client_secret = _get_credential("gdrive_client_secret")
392
-
393
- if not all([refresh_token, client_id, client_secret]):
394
- return None
395
-
396
- creds = Credentials(
397
- token=_get_credential("gdrive_access_token"),
398
- refresh_token=refresh_token,
399
- token_uri="https://oauth2.googleapis.com/token",
400
- client_id=client_id,
401
- client_secret=client_secret,
402
- )
403
- return build("drive", "v3", credentials=creds)
404
- except Exception as exc:
405
- logger.warning("Failed to build Drive service: %s", exc)
406
- return None
407
-
408
-
409
- def sync_to_google_drive(backup_path: Path, dest_config: dict) -> bool:
410
- """Upload a backup file to Google Drive."""
411
- service = _get_drive_service()
412
- if service is None:
413
- logger.warning("Google Drive not connected")
414
- return False
415
-
416
- try:
417
- from googleapiclient.http import MediaFileUpload
418
-
419
- folder_name = dest_config.get("folder", "SLM-Backup")
420
-
421
- # Find or create the SLM-Backup folder
422
- query = f"name='{folder_name}' and mimeType='application/vnd.google-apps.folder' and trashed=false"
423
- results = service.files().list(q=query, spaces="drive", fields="files(id)").execute()
424
- folders = results.get("files", [])
425
-
426
- if folders:
427
- folder_id = folders[0]["id"]
428
- else:
429
- folder_meta = {
430
- "name": folder_name,
431
- "mimeType": "application/vnd.google-apps.folder",
432
- }
433
- folder = service.files().create(body=folder_meta, fields="id").execute()
434
- folder_id = folder["id"]
435
-
436
- # Upload the backup file
437
- file_meta = {"name": backup_path.name, "parents": [folder_id]}
438
-
439
- # Check if file already exists (update instead of create duplicate)
440
- existing = service.files().list(
441
- q=f"name='{backup_path.name}' and '{folder_id}' in parents and trashed=false",
442
- spaces="drive",
443
- fields="files(id)",
444
- ).execute().get("files", [])
445
-
446
- media = MediaFileUpload(
447
- str(backup_path),
448
- mimetype="application/x-sqlite3",
449
- resumable=True,
450
- )
451
-
452
- if existing:
453
- service.files().update(
454
- fileId=existing[0]["id"],
455
- media_body=media,
456
- ).execute()
457
- else:
458
- service.files().create(
459
- body=file_meta,
460
- media_body=media,
461
- fields="id",
462
- ).execute()
463
-
464
- logger.info("Uploaded %s to Google Drive/%s", backup_path.name, folder_name)
465
- return True
466
-
467
- except Exception as exc:
468
- logger.error("Google Drive upload failed: %s", exc)
469
- return False
470
-
471
-
472
- # ---------------------------------------------------------------------------
473
- # GitHub integration
474
- # ---------------------------------------------------------------------------
475
-
476
-
477
- def connect_github(pat: str, repo_name: str = "slm-backup") -> dict[str, Any]:
478
- """Register GitHub as a backup destination using a PAT.
479
-
480
- Args:
481
- pat: Personal Access Token with 'repo' scope.
482
- repo_name: Name for the backup repo (created if doesn't exist).
483
-
484
- Returns:
485
- Dict with destination_id, username, repo, and status.
486
- """
487
- import httpx
488
-
489
- headers = {
490
- "Authorization": f"token {pat}",
491
- "Accept": "application/vnd.github.v3+json",
492
- }
493
-
494
- try:
495
- # Verify PAT and get username
496
- resp = httpx.get("https://api.github.com/user", headers=headers, timeout=15)
497
- if resp.status_code != 200:
498
- return {"error": f"Invalid GitHub token (HTTP {resp.status_code})"}
499
-
500
- username = resp.json()["login"]
501
- full_repo = f"{username}/{repo_name}"
502
-
503
- # Check if repo exists, create if not
504
- resp = httpx.get(f"https://api.github.com/repos/{full_repo}", headers=headers, timeout=15)
505
- repo_created = False
506
- if resp.status_code == 404:
507
- resp = httpx.post(
508
- "https://api.github.com/user/repos",
509
- headers=headers,
510
- json={
511
- "name": repo_name,
512
- "private": True,
513
- "description": "SuperLocalMemory automated backup — managed by SLM",
514
- "auto_init": True, # Creates initial commit with README
515
- },
516
- timeout=15,
517
- )
518
- if resp.status_code not in (200, 201):
519
- return {"error": f"Failed to create repo: {resp.text}"}
520
- repo_created = True
521
-
522
- # Ensure repo has at least one commit (for Releases API to work)
523
- if not repo_created:
524
- commits_resp = httpx.get(
525
- f"https://api.github.com/repos/{full_repo}/commits",
526
- headers=headers,
527
- params={"per_page": 1},
528
- timeout=15,
529
- )
530
- if commits_resp.status_code != 200 or not commits_resp.json():
531
- # Empty repo — create initial file via Contents API
532
- import base64
533
- readme = base64.b64encode(
534
- b"# SLM Backup\nAutomated SuperLocalMemory backup.\nEach release = one backup snapshot.\n"
535
- ).decode()
536
- httpx.put(
537
- f"https://api.github.com/repos/{full_repo}/contents/README.md",
538
- headers=headers,
539
- json={"message": "init: SLM backup repo", "content": readme},
540
- timeout=15,
541
- )
542
-
543
- # Store PAT in keychain
544
- cred_key = "github_pat"
545
- _store_credential(cred_key, pat)
546
-
547
- # Register destination
548
- dest_id = add_destination(
549
- destination_type="github",
550
- display_name=f"GitHub ({full_repo})",
551
- config={"username": username, "repo": repo_name, "full_repo": full_repo},
552
- credentials_ref=cred_key,
553
- )
554
-
555
- return {"destination_id": dest_id, "username": username, "repo": full_repo, "status": "connected"}
556
-
557
- except Exception as exc:
558
- logger.error("GitHub connection failed: %s", exc)
559
- return {"error": str(exc)}
560
-
561
-
562
- def sync_to_github(backup_files: list[Path] | Path, dest_config: dict) -> bool:
563
- """Upload backup files as GitHub Release assets.
564
-
565
- Creates ONE release per sync, with ALL database backups as assets.
566
- Uses Releases API to avoid Git LFS (100MB file limit per asset,
567
- 2GB per release — plenty for SLM databases).
568
-
569
- Args:
570
- backup_files: Single path or list of paths to upload.
571
- dest_config: Destination config with full_repo key.
572
- """
573
- import httpx
574
-
575
- # Accept both single path and list
576
- if isinstance(backup_files, Path):
577
- backup_files = [backup_files]
578
-
579
- pat = _get_credential("github_pat")
580
- if not pat:
581
- logger.warning("GitHub PAT not found in keychain")
582
- return False
583
-
584
- headers = {
585
- "Authorization": f"token {pat}",
586
- "Accept": "application/vnd.github.v3+json",
587
- }
588
-
589
- full_repo = dest_config.get("full_repo", "")
590
- if not full_repo:
591
- return False
592
-
593
- try:
594
- timestamp = datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S")
595
- tag_name = f"backup-{timestamp}"
596
- total_mb = sum(f.stat().st_size for f in backup_files) / (1024 * 1024)
597
- file_list = ", ".join(f"{f.name} ({f.stat().st_size / 1024 / 1024:.1f} MB)" for f in backup_files)
598
-
599
- # Create ONE release for all files
600
- release_resp = httpx.post(
601
- f"https://api.github.com/repos/{full_repo}/releases",
602
- headers=headers,
603
- json={
604
- "tag_name": tag_name,
605
- "name": f"SLM Backup {timestamp}",
606
- "body": f"Automated backup — {len(backup_files)} databases ({total_mb:.1f} MB total)\n\n{file_list}",
607
- "draft": False,
608
- "prerelease": False,
609
- },
610
- timeout=30,
611
- )
612
-
613
- if release_resp.status_code not in (200, 201):
614
- logger.error("GitHub release creation failed: %s", release_resp.text[:200])
615
- return False
616
-
617
- upload_url = release_resp.json()["upload_url"].split("{")[0]
618
- uploaded = 0
619
-
620
- # Upload each database as a separate asset on the same release
621
- for backup_path in backup_files:
622
- try:
623
- with open(backup_path, "rb") as f:
624
- upload_resp = httpx.post(
625
- upload_url,
626
- params={"name": backup_path.name},
627
- headers={
628
- "Authorization": f"token {pat}",
629
- "Content-Type": "application/octet-stream",
630
- },
631
- content=f.read(),
632
- timeout=600,
633
- )
634
- if upload_resp.status_code in (200, 201):
635
- uploaded += 1
636
- logger.info("Uploaded %s to release %s", backup_path.name, tag_name)
637
- else:
638
- logger.warning("Failed to upload %s: %s", backup_path.name, upload_resp.text[:100])
639
- except Exception as exc:
640
- logger.warning("Failed to upload %s: %s", backup_path.name, exc)
641
-
642
- logger.info("GitHub sync: %d/%d files uploaded to release %s", uploaded, len(backup_files), tag_name)
643
-
644
- # Cleanup: keep only last MAX_GITHUB_RELEASES releases to prevent repo bloat
645
- _cleanup_old_releases(full_repo, headers)
646
-
647
- return uploaded > 0
648
-
649
- except Exception as exc:
650
- logger.error("GitHub sync failed: %s", exc)
651
- return False
652
-
653
-
654
- MAX_GITHUB_RELEASES = 5 # Keep last 5 backups, delete older ones
655
-
656
-
657
- def _cleanup_old_releases(full_repo: str, headers: dict) -> None:
658
- """Delete old GitHub releases to prevent repo storage from exploding.
659
-
660
- Keeps the most recent MAX_GITHUB_RELEASES releases and deletes the rest.
661
- """
662
- import httpx
663
-
664
- try:
665
- resp = httpx.get(
666
- f"https://api.github.com/repos/{full_repo}/releases",
667
- headers=headers,
668
- params={"per_page": 100},
669
- timeout=15,
670
- )
671
- if resp.status_code != 200:
672
- return
673
-
674
- releases = resp.json()
675
- if len(releases) <= MAX_GITHUB_RELEASES:
676
- return
677
-
678
- # Sort by creation date (newest first), delete everything after MAX
679
- releases.sort(key=lambda r: r.get("created_at", ""), reverse=True)
680
- to_delete = releases[MAX_GITHUB_RELEASES:]
681
-
682
- for release in to_delete:
683
- release_id = release["id"]
684
- tag = release.get("tag_name", "")
685
-
686
- # Delete release
687
- httpx.delete(
688
- f"https://api.github.com/repos/{full_repo}/releases/{release_id}",
689
- headers=headers,
690
- timeout=15,
691
- )
692
- # Delete the tag too (releases leave orphan tags)
693
- httpx.delete(
694
- f"https://api.github.com/repos/{full_repo}/git/refs/tags/{tag}",
695
- headers=headers,
696
- timeout=15,
697
- )
698
- logger.info("Cleaned up old release: %s", tag)
699
-
700
- logger.info("GitHub cleanup: removed %d old releases, kept %d", len(to_delete), MAX_GITHUB_RELEASES)
701
-
702
- except Exception as exc:
703
- logger.warning("GitHub release cleanup failed (non-critical): %s", exc)
704
-
705
-
706
- # ---------------------------------------------------------------------------
707
- # Sync orchestrator
708
- # ---------------------------------------------------------------------------
709
-
710
-
711
- def _find_latest_backup_set(backup_dir: Path) -> list[Path]:
712
- """Find the latest complete backup set (all DBs from the same timestamp).
713
-
714
- Returns list of backup files (memory + all companions) from the most
715
- recent backup run.
716
- """
717
- # Find latest memory backup to get the timestamp
718
- memory_backups = sorted(
719
- backup_dir.glob("memory-*.db"),
720
- key=lambda f: f.stat().st_mtime,
721
- reverse=True,
722
- )
723
- if not memory_backups:
724
- return []
725
-
726
- latest = memory_backups[0]
727
- # Extract timestamp+suffix from "memory-20260414-212803-cloud-sync.db"
728
- ts_suffix = latest.name.replace("memory-", "").replace(".db", "")
729
-
730
- # Find all companion DB backups with the same timestamp
731
- backup_set = [latest]
732
- for f in backup_dir.iterdir():
733
- if f == latest or not f.name.endswith(".db"):
734
- continue
735
- if ts_suffix in f.name:
736
- backup_set.append(f)
737
-
738
- return backup_set
739
-
740
-
741
- def sync_all_destinations(db_path: Path | None = None) -> dict[str, Any]:
742
- """Sync latest backup set (ALL databases) to all enabled cloud destinations."""
743
- path = db_path or _default_db_path()
744
- results: dict[str, Any] = {}
745
-
746
- destinations = get_destinations(path)
747
- if not destinations:
748
- return {"synced": 0, "message": "No cloud destinations configured"}
749
-
750
- backup_dir = path.parent / "backups"
751
- if not backup_dir.exists():
752
- return {"synced": 0, "message": "No backups directory"}
753
-
754
- backup_set = _find_latest_backup_set(backup_dir)
755
- if not backup_set:
756
- return {"synced": 0, "message": "No backup files found"}
757
-
758
- synced = 0
759
- db_names = [f.name for f in backup_set]
760
- total_size_mb = sum(f.stat().st_size for f in backup_set) / (1024 * 1024)
761
-
762
- for dest in destinations:
763
- if not dest.get("enabled"):
764
- continue
765
-
766
- dest_id = dest["id"]
767
- dest_type = dest["destination_type"]
768
- config = json.loads(dest.get("config", "{}"))
769
-
770
- try:
771
- if dest_type == "google_drive":
772
- ok = all(sync_to_google_drive(f, config) for f in backup_set)
773
- elif dest_type == "github":
774
- ok = sync_to_github(backup_set, config)
775
- else:
776
- ok = False
777
-
778
- status = "success" if ok else "failed"
779
- update_sync_status(dest_id, status, db_path=path)
780
- if ok:
781
- synced += 1
782
- results[dest_id] = {"type": dest_type, "status": status}
783
-
784
- except Exception as exc:
785
- update_sync_status(dest_id, "failed", str(exc), db_path=path)
786
- results[dest_id] = {"type": dest_type, "status": "failed", "error": str(exc)}
787
-
788
- return {"synced": synced, "total": len(destinations), "results": results}