superlocalmemory 2.8.5 → 3.0.0
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.
- package/CHANGELOG.md +11 -0
- package/LICENSE +9 -1
- package/NOTICE +63 -0
- package/README.md +165 -480
- package/bin/slm +17 -449
- package/bin/slm-npm +2 -2
- package/bin/slm.bat +4 -2
- package/conftest.py +5 -0
- package/docs/api-reference.md +284 -0
- package/docs/architecture.md +149 -0
- package/docs/auto-memory.md +150 -0
- package/docs/cli-reference.md +276 -0
- package/docs/compliance.md +191 -0
- package/docs/configuration.md +182 -0
- package/docs/getting-started.md +102 -0
- package/docs/ide-setup.md +261 -0
- package/docs/mcp-tools.md +220 -0
- package/docs/migration-from-v2.md +170 -0
- package/docs/profiles.md +173 -0
- package/docs/troubleshooting.md +310 -0
- package/{configs → ide/configs}/antigravity-mcp.json +3 -3
- package/ide/configs/chatgpt-desktop-mcp.json +16 -0
- package/{configs → ide/configs}/claude-desktop-mcp.json +3 -3
- package/{configs → ide/configs}/codex-mcp.toml +4 -4
- package/{configs → ide/configs}/continue-mcp.yaml +4 -3
- package/{configs → ide/configs}/continue-skills.yaml +6 -6
- package/ide/configs/cursor-mcp.json +15 -0
- package/{configs → ide/configs}/gemini-cli-mcp.json +2 -2
- package/{configs → ide/configs}/jetbrains-mcp.json +2 -2
- package/{configs → ide/configs}/opencode-mcp.json +2 -2
- package/{configs → ide/configs}/perplexity-mcp.json +2 -2
- package/{configs → ide/configs}/vscode-copilot-mcp.json +2 -2
- package/{configs → ide/configs}/windsurf-mcp.json +3 -3
- package/{configs → ide/configs}/zed-mcp.json +2 -2
- package/{hooks → ide/hooks}/context-hook.js +9 -20
- package/ide/hooks/memory-list-skill.js +70 -0
- package/ide/hooks/memory-profile-skill.js +101 -0
- package/ide/hooks/memory-recall-skill.js +62 -0
- package/ide/hooks/memory-remember-skill.js +68 -0
- package/ide/hooks/memory-reset-skill.js +160 -0
- package/{hooks → ide/hooks}/post-recall-hook.js +2 -2
- package/ide/integrations/langchain/README.md +106 -0
- package/ide/integrations/langchain/langchain_superlocalmemory/__init__.py +9 -0
- package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py +201 -0
- package/ide/integrations/langchain/pyproject.toml +38 -0
- package/{src/learning → ide/integrations/langchain}/tests/__init__.py +1 -0
- package/ide/integrations/langchain/tests/test_chat_message_history.py +215 -0
- package/ide/integrations/langchain/tests/test_security.py +117 -0
- package/ide/integrations/llamaindex/README.md +81 -0
- package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/__init__.py +9 -0
- package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py +316 -0
- package/ide/integrations/llamaindex/pyproject.toml +43 -0
- package/{src/lifecycle → ide/integrations/llamaindex}/tests/__init__.py +1 -2
- package/ide/integrations/llamaindex/tests/test_chat_store.py +294 -0
- package/ide/integrations/llamaindex/tests/test_security.py +241 -0
- package/{skills → ide/skills}/slm-build-graph/SKILL.md +6 -6
- package/{skills → ide/skills}/slm-list-recent/SKILL.md +5 -5
- package/{skills → ide/skills}/slm-recall/SKILL.md +5 -5
- package/{skills → ide/skills}/slm-remember/SKILL.md +6 -6
- package/{skills → ide/skills}/slm-show-patterns/SKILL.md +7 -7
- package/{skills → ide/skills}/slm-status/SKILL.md +9 -9
- package/{skills → ide/skills}/slm-switch-profile/SKILL.md +9 -9
- package/package.json +13 -22
- package/pyproject.toml +85 -0
- package/scripts/build-dmg.sh +417 -0
- package/scripts/install-skills.ps1 +334 -0
- package/{install.ps1 → scripts/install.ps1} +36 -4
- package/{install.sh → scripts/install.sh} +14 -13
- package/scripts/postinstall.js +2 -2
- package/scripts/start-dashboard.ps1 +52 -0
- package/scripts/start-dashboard.sh +41 -0
- package/scripts/sync-wiki.ps1 +127 -0
- package/scripts/sync-wiki.sh +82 -0
- package/scripts/test-dmg.sh +161 -0
- package/scripts/test-npm-package.ps1 +252 -0
- package/scripts/test-npm-package.sh +207 -0
- package/scripts/verify-install.ps1 +294 -0
- package/scripts/verify-install.sh +266 -0
- package/src/superlocalmemory/__init__.py +0 -0
- package/src/superlocalmemory/attribution/__init__.py +9 -0
- package/src/superlocalmemory/attribution/mathematical_dna.py +235 -0
- package/src/superlocalmemory/attribution/signer.py +153 -0
- package/src/superlocalmemory/attribution/watermark.py +189 -0
- package/src/superlocalmemory/cli/__init__.py +5 -0
- package/src/superlocalmemory/cli/commands.py +245 -0
- package/src/superlocalmemory/cli/main.py +89 -0
- package/src/superlocalmemory/cli/migrate_cmd.py +55 -0
- package/src/superlocalmemory/cli/post_install.py +99 -0
- package/src/superlocalmemory/cli/setup_wizard.py +129 -0
- package/src/superlocalmemory/compliance/__init__.py +0 -0
- package/src/superlocalmemory/compliance/abac.py +204 -0
- package/src/superlocalmemory/compliance/audit.py +314 -0
- package/src/superlocalmemory/compliance/eu_ai_act.py +131 -0
- package/src/superlocalmemory/compliance/gdpr.py +294 -0
- package/src/superlocalmemory/compliance/lifecycle.py +158 -0
- package/src/superlocalmemory/compliance/retention.py +232 -0
- package/src/superlocalmemory/compliance/scheduler.py +148 -0
- package/src/superlocalmemory/core/__init__.py +0 -0
- package/src/superlocalmemory/core/config.py +391 -0
- package/src/superlocalmemory/core/embeddings.py +293 -0
- package/src/superlocalmemory/core/engine.py +701 -0
- package/src/superlocalmemory/core/hooks.py +65 -0
- package/src/superlocalmemory/core/maintenance.py +172 -0
- package/src/superlocalmemory/core/modes.py +140 -0
- package/src/superlocalmemory/core/profiles.py +234 -0
- package/src/superlocalmemory/core/registry.py +117 -0
- package/src/superlocalmemory/dynamics/__init__.py +0 -0
- package/src/superlocalmemory/dynamics/fisher_langevin_coupling.py +223 -0
- package/src/superlocalmemory/encoding/__init__.py +0 -0
- package/src/superlocalmemory/encoding/consolidator.py +485 -0
- package/src/superlocalmemory/encoding/emotional.py +125 -0
- package/src/superlocalmemory/encoding/entity_resolver.py +525 -0
- package/src/superlocalmemory/encoding/entropy_gate.py +104 -0
- package/src/superlocalmemory/encoding/fact_extractor.py +775 -0
- package/src/superlocalmemory/encoding/foresight.py +91 -0
- package/src/superlocalmemory/encoding/graph_builder.py +302 -0
- package/src/superlocalmemory/encoding/observation_builder.py +160 -0
- package/src/superlocalmemory/encoding/scene_builder.py +183 -0
- package/src/superlocalmemory/encoding/signal_inference.py +90 -0
- package/src/superlocalmemory/encoding/temporal_parser.py +426 -0
- package/src/superlocalmemory/encoding/type_router.py +235 -0
- package/src/superlocalmemory/hooks/__init__.py +3 -0
- package/src/superlocalmemory/hooks/auto_capture.py +111 -0
- package/src/superlocalmemory/hooks/auto_recall.py +93 -0
- package/src/superlocalmemory/hooks/ide_connector.py +204 -0
- package/src/superlocalmemory/hooks/rules_engine.py +99 -0
- package/src/superlocalmemory/infra/__init__.py +3 -0
- package/src/superlocalmemory/infra/auth_middleware.py +82 -0
- package/src/superlocalmemory/infra/backup.py +317 -0
- package/src/superlocalmemory/infra/cache_manager.py +267 -0
- package/src/superlocalmemory/infra/event_bus.py +381 -0
- package/src/superlocalmemory/infra/rate_limiter.py +135 -0
- package/src/{webhook_dispatcher.py → superlocalmemory/infra/webhook_dispatcher.py} +104 -101
- package/src/superlocalmemory/learning/__init__.py +0 -0
- package/src/superlocalmemory/learning/adaptive.py +172 -0
- package/src/superlocalmemory/learning/behavioral.py +490 -0
- package/src/superlocalmemory/learning/behavioral_listener.py +94 -0
- package/src/superlocalmemory/learning/bootstrap.py +298 -0
- package/src/superlocalmemory/learning/cross_project.py +399 -0
- package/src/superlocalmemory/learning/database.py +376 -0
- package/src/superlocalmemory/learning/engagement.py +323 -0
- package/src/superlocalmemory/learning/features.py +138 -0
- package/src/superlocalmemory/learning/feedback.py +316 -0
- package/src/superlocalmemory/learning/outcomes.py +255 -0
- package/src/superlocalmemory/learning/project_context.py +366 -0
- package/src/superlocalmemory/learning/ranker.py +155 -0
- package/src/superlocalmemory/learning/source_quality.py +303 -0
- package/src/superlocalmemory/learning/workflows.py +309 -0
- package/src/superlocalmemory/llm/__init__.py +0 -0
- package/src/superlocalmemory/llm/backbone.py +316 -0
- package/src/superlocalmemory/math/__init__.py +0 -0
- package/src/superlocalmemory/math/fisher.py +356 -0
- package/src/superlocalmemory/math/langevin.py +398 -0
- package/src/superlocalmemory/math/sheaf.py +257 -0
- package/src/superlocalmemory/mcp/__init__.py +0 -0
- package/src/superlocalmemory/mcp/resources.py +245 -0
- package/src/superlocalmemory/mcp/server.py +61 -0
- package/src/superlocalmemory/mcp/tools.py +18 -0
- package/src/superlocalmemory/mcp/tools_core.py +305 -0
- package/src/superlocalmemory/mcp/tools_v28.py +223 -0
- package/src/superlocalmemory/mcp/tools_v3.py +286 -0
- package/src/superlocalmemory/retrieval/__init__.py +0 -0
- package/src/superlocalmemory/retrieval/agentic.py +295 -0
- package/src/superlocalmemory/retrieval/ann_index.py +223 -0
- package/src/superlocalmemory/retrieval/bm25_channel.py +185 -0
- package/src/superlocalmemory/retrieval/bridge_discovery.py +170 -0
- package/src/superlocalmemory/retrieval/engine.py +390 -0
- package/src/superlocalmemory/retrieval/entity_channel.py +179 -0
- package/src/superlocalmemory/retrieval/fusion.py +78 -0
- package/src/superlocalmemory/retrieval/profile_channel.py +105 -0
- package/src/superlocalmemory/retrieval/reranker.py +154 -0
- package/src/superlocalmemory/retrieval/semantic_channel.py +232 -0
- package/src/superlocalmemory/retrieval/strategy.py +96 -0
- package/src/superlocalmemory/retrieval/temporal_channel.py +175 -0
- package/src/superlocalmemory/server/__init__.py +1 -0
- package/src/superlocalmemory/server/api.py +248 -0
- package/src/superlocalmemory/server/routes/__init__.py +4 -0
- package/src/superlocalmemory/server/routes/agents.py +107 -0
- package/src/superlocalmemory/server/routes/backup.py +91 -0
- package/src/superlocalmemory/server/routes/behavioral.py +127 -0
- package/src/superlocalmemory/server/routes/compliance.py +160 -0
- package/src/superlocalmemory/server/routes/data_io.py +188 -0
- package/src/superlocalmemory/server/routes/events.py +183 -0
- package/src/superlocalmemory/server/routes/helpers.py +85 -0
- package/src/superlocalmemory/server/routes/learning.py +273 -0
- package/src/superlocalmemory/server/routes/lifecycle.py +116 -0
- package/src/superlocalmemory/server/routes/memories.py +399 -0
- package/src/superlocalmemory/server/routes/profiles.py +219 -0
- package/src/superlocalmemory/server/routes/stats.py +346 -0
- package/src/superlocalmemory/server/routes/v3_api.py +365 -0
- package/src/superlocalmemory/server/routes/ws.py +82 -0
- package/src/superlocalmemory/server/security_middleware.py +57 -0
- package/src/superlocalmemory/server/ui.py +245 -0
- package/src/superlocalmemory/storage/__init__.py +0 -0
- package/src/superlocalmemory/storage/access_control.py +182 -0
- package/src/superlocalmemory/storage/database.py +594 -0
- package/src/superlocalmemory/storage/migrations.py +303 -0
- package/src/superlocalmemory/storage/models.py +406 -0
- package/src/superlocalmemory/storage/schema.py +726 -0
- package/src/superlocalmemory/storage/v2_migrator.py +317 -0
- package/src/superlocalmemory/trust/__init__.py +0 -0
- package/src/superlocalmemory/trust/gate.py +130 -0
- package/src/superlocalmemory/trust/provenance.py +124 -0
- package/src/superlocalmemory/trust/scorer.py +347 -0
- package/src/superlocalmemory/trust/signals.py +153 -0
- package/ui/index.html +278 -5
- package/ui/js/auto-settings.js +70 -0
- package/ui/js/dashboard.js +90 -0
- package/ui/js/fact-detail.js +92 -0
- package/ui/js/feedback.js +2 -2
- package/ui/js/ide-status.js +102 -0
- package/ui/js/math-health.js +98 -0
- package/ui/js/recall-lab.js +127 -0
- package/ui/js/settings.js +2 -2
- package/ui/js/trust-dashboard.js +73 -0
- package/api_server.py +0 -724
- package/bin/aider-smart +0 -72
- package/bin/superlocalmemoryv2-learning +0 -4
- package/bin/superlocalmemoryv2-list +0 -3
- package/bin/superlocalmemoryv2-patterns +0 -4
- package/bin/superlocalmemoryv2-profile +0 -3
- package/bin/superlocalmemoryv2-recall +0 -3
- package/bin/superlocalmemoryv2-remember +0 -3
- package/bin/superlocalmemoryv2-reset +0 -3
- package/bin/superlocalmemoryv2-status +0 -3
- package/configs/chatgpt-desktop-mcp.json +0 -16
- package/configs/cursor-mcp.json +0 -15
- package/docs/SECURITY-QUICK-REFERENCE.md +0 -214
- package/hooks/memory-list-skill.js +0 -139
- package/hooks/memory-profile-skill.js +0 -273
- package/hooks/memory-recall-skill.js +0 -114
- package/hooks/memory-remember-skill.js +0 -127
- package/hooks/memory-reset-skill.js +0 -274
- package/mcp_server.py +0 -1800
- package/requirements-core.txt +0 -22
- package/requirements-learning.txt +0 -12
- package/requirements.txt +0 -12
- package/src/agent_registry.py +0 -411
- package/src/auth_middleware.py +0 -61
- package/src/auto_backup.py +0 -459
- package/src/behavioral/__init__.py +0 -49
- package/src/behavioral/behavioral_listener.py +0 -203
- package/src/behavioral/behavioral_patterns.py +0 -275
- package/src/behavioral/cross_project_transfer.py +0 -206
- package/src/behavioral/outcome_inference.py +0 -194
- package/src/behavioral/outcome_tracker.py +0 -193
- package/src/behavioral/tests/__init__.py +0 -4
- package/src/behavioral/tests/test_behavioral_integration.py +0 -108
- package/src/behavioral/tests/test_behavioral_patterns.py +0 -150
- package/src/behavioral/tests/test_cross_project_transfer.py +0 -142
- package/src/behavioral/tests/test_mcp_behavioral.py +0 -139
- package/src/behavioral/tests/test_mcp_report_outcome.py +0 -117
- package/src/behavioral/tests/test_outcome_inference.py +0 -107
- package/src/behavioral/tests/test_outcome_tracker.py +0 -96
- package/src/cache_manager.py +0 -518
- package/src/compliance/__init__.py +0 -48
- package/src/compliance/abac_engine.py +0 -149
- package/src/compliance/abac_middleware.py +0 -116
- package/src/compliance/audit_db.py +0 -215
- package/src/compliance/audit_logger.py +0 -148
- package/src/compliance/retention_manager.py +0 -289
- package/src/compliance/retention_scheduler.py +0 -186
- package/src/compliance/tests/__init__.py +0 -4
- package/src/compliance/tests/test_abac_enforcement.py +0 -95
- package/src/compliance/tests/test_abac_engine.py +0 -124
- package/src/compliance/tests/test_abac_mcp_integration.py +0 -118
- package/src/compliance/tests/test_audit_db.py +0 -123
- package/src/compliance/tests/test_audit_logger.py +0 -98
- package/src/compliance/tests/test_mcp_audit.py +0 -128
- package/src/compliance/tests/test_mcp_retention_policy.py +0 -125
- package/src/compliance/tests/test_retention_manager.py +0 -131
- package/src/compliance/tests/test_retention_scheduler.py +0 -99
- package/src/compression/__init__.py +0 -25
- package/src/compression/cli.py +0 -150
- package/src/compression/cold_storage.py +0 -217
- package/src/compression/config.py +0 -72
- package/src/compression/orchestrator.py +0 -133
- package/src/compression/tier2_compressor.py +0 -228
- package/src/compression/tier3_compressor.py +0 -153
- package/src/compression/tier_classifier.py +0 -148
- package/src/db_connection_manager.py +0 -536
- package/src/embedding_engine.py +0 -63
- package/src/embeddings/__init__.py +0 -47
- package/src/embeddings/cache.py +0 -70
- package/src/embeddings/cli.py +0 -113
- package/src/embeddings/constants.py +0 -47
- package/src/embeddings/database.py +0 -91
- package/src/embeddings/engine.py +0 -247
- package/src/embeddings/model_loader.py +0 -145
- package/src/event_bus.py +0 -562
- package/src/graph/__init__.py +0 -36
- package/src/graph/build_helpers.py +0 -74
- package/src/graph/cli.py +0 -87
- package/src/graph/cluster_builder.py +0 -188
- package/src/graph/cluster_summary.py +0 -148
- package/src/graph/constants.py +0 -47
- package/src/graph/edge_builder.py +0 -162
- package/src/graph/entity_extractor.py +0 -95
- package/src/graph/graph_core.py +0 -226
- package/src/graph/graph_search.py +0 -231
- package/src/graph/hierarchical.py +0 -207
- package/src/graph/schema.py +0 -99
- package/src/graph_engine.py +0 -52
- package/src/hnsw_index.py +0 -628
- package/src/hybrid_search.py +0 -46
- package/src/learning/__init__.py +0 -217
- package/src/learning/adaptive_ranker.py +0 -682
- package/src/learning/bootstrap/__init__.py +0 -69
- package/src/learning/bootstrap/constants.py +0 -93
- package/src/learning/bootstrap/db_queries.py +0 -316
- package/src/learning/bootstrap/sampling.py +0 -82
- package/src/learning/bootstrap/text_utils.py +0 -71
- package/src/learning/cross_project_aggregator.py +0 -857
- package/src/learning/db/__init__.py +0 -40
- package/src/learning/db/constants.py +0 -44
- package/src/learning/db/schema.py +0 -279
- package/src/learning/engagement_tracker.py +0 -628
- package/src/learning/feature_extractor.py +0 -708
- package/src/learning/feedback_collector.py +0 -806
- package/src/learning/learning_db.py +0 -915
- package/src/learning/project_context_manager.py +0 -572
- package/src/learning/ranking/__init__.py +0 -33
- package/src/learning/ranking/constants.py +0 -84
- package/src/learning/ranking/helpers.py +0 -278
- package/src/learning/source_quality_scorer.py +0 -676
- package/src/learning/synthetic_bootstrap.py +0 -755
- package/src/learning/tests/test_adaptive_ranker.py +0 -325
- package/src/learning/tests/test_adaptive_ranker_v28.py +0 -60
- package/src/learning/tests/test_aggregator.py +0 -306
- package/src/learning/tests/test_auto_retrain_v28.py +0 -35
- package/src/learning/tests/test_e2e_ranking_v28.py +0 -82
- package/src/learning/tests/test_feature_extractor_v28.py +0 -93
- package/src/learning/tests/test_feedback_collector.py +0 -294
- package/src/learning/tests/test_learning_db.py +0 -602
- package/src/learning/tests/test_learning_db_v28.py +0 -110
- package/src/learning/tests/test_learning_init_v28.py +0 -48
- package/src/learning/tests/test_outcome_signals.py +0 -48
- package/src/learning/tests/test_project_context.py +0 -292
- package/src/learning/tests/test_schema_migration.py +0 -319
- package/src/learning/tests/test_signal_inference.py +0 -397
- package/src/learning/tests/test_source_quality.py +0 -351
- package/src/learning/tests/test_synthetic_bootstrap.py +0 -429
- package/src/learning/tests/test_workflow_miner.py +0 -318
- package/src/learning/workflow_pattern_miner.py +0 -655
- package/src/lifecycle/__init__.py +0 -54
- package/src/lifecycle/bounded_growth.py +0 -239
- package/src/lifecycle/compaction_engine.py +0 -226
- package/src/lifecycle/lifecycle_engine.py +0 -355
- package/src/lifecycle/lifecycle_evaluator.py +0 -257
- package/src/lifecycle/lifecycle_scheduler.py +0 -130
- package/src/lifecycle/retention_policy.py +0 -285
- package/src/lifecycle/tests/test_bounded_growth.py +0 -193
- package/src/lifecycle/tests/test_compaction.py +0 -179
- package/src/lifecycle/tests/test_lifecycle_engine.py +0 -137
- package/src/lifecycle/tests/test_lifecycle_evaluation.py +0 -177
- package/src/lifecycle/tests/test_lifecycle_scheduler.py +0 -127
- package/src/lifecycle/tests/test_lifecycle_search.py +0 -109
- package/src/lifecycle/tests/test_mcp_compact.py +0 -149
- package/src/lifecycle/tests/test_mcp_lifecycle_status.py +0 -114
- package/src/lifecycle/tests/test_retention_policy.py +0 -162
- package/src/mcp_tools_v28.py +0 -281
- package/src/memory/__init__.py +0 -36
- package/src/memory/cli.py +0 -205
- package/src/memory/constants.py +0 -39
- package/src/memory/helpers.py +0 -28
- package/src/memory/schema.py +0 -166
- package/src/memory-profiles.py +0 -595
- package/src/memory-reset.py +0 -491
- package/src/memory_compression.py +0 -989
- package/src/memory_store_v2.py +0 -1155
- package/src/migrate_v1_to_v2.py +0 -629
- package/src/pattern_learner.py +0 -34
- package/src/patterns/__init__.py +0 -24
- package/src/patterns/analyzers.py +0 -251
- package/src/patterns/learner.py +0 -271
- package/src/patterns/scoring.py +0 -171
- package/src/patterns/store.py +0 -225
- package/src/patterns/terminology.py +0 -140
- package/src/provenance_tracker.py +0 -312
- package/src/qualixar_attribution.py +0 -139
- package/src/qualixar_watermark.py +0 -78
- package/src/query_optimizer.py +0 -511
- package/src/rate_limiter.py +0 -83
- package/src/search/__init__.py +0 -20
- package/src/search/cli.py +0 -77
- package/src/search/constants.py +0 -26
- package/src/search/engine.py +0 -241
- package/src/search/fusion.py +0 -122
- package/src/search/index_loader.py +0 -114
- package/src/search/methods.py +0 -162
- package/src/search_engine_v2.py +0 -401
- package/src/setup_validator.py +0 -482
- package/src/subscription_manager.py +0 -391
- package/src/tree/__init__.py +0 -59
- package/src/tree/builder.py +0 -185
- package/src/tree/nodes.py +0 -202
- package/src/tree/queries.py +0 -257
- package/src/tree/schema.py +0 -80
- package/src/tree_manager.py +0 -19
- package/src/trust/__init__.py +0 -45
- package/src/trust/constants.py +0 -66
- package/src/trust/queries.py +0 -157
- package/src/trust/schema.py +0 -95
- package/src/trust/scorer.py +0 -299
- package/src/trust/signals.py +0 -95
- package/src/trust_scorer.py +0 -44
- package/ui/app.js +0 -1588
- package/ui/js/graph-cytoscape-monolithic-backup.js +0 -1168
- package/ui/js/graph-cytoscape.js +0 -1168
- package/ui/js/graph-d3-backup.js +0 -32
- package/ui/js/graph.js +0 -32
- package/ui_server.py +0 -266
- /package/docs/{ACCESSIBILITY.md → v2-archive/ACCESSIBILITY.md} +0 -0
- /package/docs/{ARCHITECTURE.md → v2-archive/ARCHITECTURE.md} +0 -0
- /package/docs/{CLI-COMMANDS-REFERENCE.md → v2-archive/CLI-COMMANDS-REFERENCE.md} +0 -0
- /package/docs/{COMPRESSION-README.md → v2-archive/COMPRESSION-README.md} +0 -0
- /package/docs/{FRAMEWORK-INTEGRATIONS.md → v2-archive/FRAMEWORK-INTEGRATIONS.md} +0 -0
- /package/docs/{MCP-MANUAL-SETUP.md → v2-archive/MCP-MANUAL-SETUP.md} +0 -0
- /package/docs/{MCP-TROUBLESHOOTING.md → v2-archive/MCP-TROUBLESHOOTING.md} +0 -0
- /package/docs/{PATTERN-LEARNING.md → v2-archive/PATTERN-LEARNING.md} +0 -0
- /package/docs/{PROFILES-GUIDE.md → v2-archive/PROFILES-GUIDE.md} +0 -0
- /package/docs/{RESET-GUIDE.md → v2-archive/RESET-GUIDE.md} +0 -0
- /package/docs/{SEARCH-ENGINE-V2.2.0.md → v2-archive/SEARCH-ENGINE-V2.2.0.md} +0 -0
- /package/docs/{SEARCH-INTEGRATION-GUIDE.md → v2-archive/SEARCH-INTEGRATION-GUIDE.md} +0 -0
- /package/docs/{UI-SERVER.md → v2-archive/UI-SERVER.md} +0 -0
- /package/docs/{UNIVERSAL-INTEGRATION.md → v2-archive/UNIVERSAL-INTEGRATION.md} +0 -0
- /package/docs/{V2.2.0-OPTIONAL-SEARCH.md → v2-archive/V2.2.0-OPTIONAL-SEARCH.md} +0 -0
- /package/docs/{WINDOWS-INSTALL-README.txt → v2-archive/WINDOWS-INSTALL-README.txt} +0 -0
- /package/docs/{WINDOWS-POST-INSTALL.txt → v2-archive/WINDOWS-POST-INSTALL.txt} +0 -0
- /package/docs/{example_graph_usage.py → v2-archive/example_graph_usage.py} +0 -0
- /package/{completions → ide/completions}/slm.bash +0 -0
- /package/{completions → ide/completions}/slm.zsh +0 -0
- /package/{configs → ide/configs}/cody-commands.json +0 -0
- /package/{install-skills.sh → scripts/install-skills.sh} +0 -0
|
@@ -1,153 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
|
|
4
|
-
"""
|
|
5
|
-
Tier 3 compression logic.
|
|
6
|
-
Compresses memories to bullet points only format.
|
|
7
|
-
"""
|
|
8
|
-
|
|
9
|
-
import sqlite3
|
|
10
|
-
import json
|
|
11
|
-
import re
|
|
12
|
-
from datetime import datetime
|
|
13
|
-
from pathlib import Path
|
|
14
|
-
from typing import List
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
MEMORY_DIR = Path.home() / ".claude-memory"
|
|
18
|
-
DB_PATH = MEMORY_DIR / "memory.db"
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
class Tier3Compressor:
|
|
22
|
-
"""Compress memories to bullet points only (Tier 3)."""
|
|
23
|
-
|
|
24
|
-
def __init__(self, db_path: Path = DB_PATH):
|
|
25
|
-
self.db_path = db_path
|
|
26
|
-
|
|
27
|
-
def compress_to_tier3(self, memory_id: int) -> bool:
|
|
28
|
-
"""
|
|
29
|
-
Compress memory to bullet points only.
|
|
30
|
-
|
|
31
|
-
Args:
|
|
32
|
-
memory_id: ID of memory to compress
|
|
33
|
-
|
|
34
|
-
Returns:
|
|
35
|
-
True if compression succeeded, False otherwise
|
|
36
|
-
"""
|
|
37
|
-
conn = sqlite3.connect(self.db_path)
|
|
38
|
-
try:
|
|
39
|
-
cursor = conn.cursor()
|
|
40
|
-
|
|
41
|
-
# Get Tier 2 compressed content
|
|
42
|
-
cursor.execute('''
|
|
43
|
-
SELECT content, tier FROM memories WHERE id = ?
|
|
44
|
-
''', (memory_id,))
|
|
45
|
-
result = cursor.fetchone()
|
|
46
|
-
|
|
47
|
-
if not result:
|
|
48
|
-
return False
|
|
49
|
-
|
|
50
|
-
content, current_tier = result
|
|
51
|
-
|
|
52
|
-
# Skip if in wrong tier
|
|
53
|
-
if current_tier != 3:
|
|
54
|
-
return False
|
|
55
|
-
|
|
56
|
-
# Try to parse as Tier 2 compressed content
|
|
57
|
-
try:
|
|
58
|
-
compressed_content = json.loads(content)
|
|
59
|
-
|
|
60
|
-
# Check if already Tier 3
|
|
61
|
-
if isinstance(compressed_content, dict) and 'bullets' in compressed_content:
|
|
62
|
-
return True # Already Tier 3
|
|
63
|
-
|
|
64
|
-
# Get summary from Tier 2
|
|
65
|
-
if isinstance(compressed_content, dict) and 'summary' in compressed_content:
|
|
66
|
-
summary = compressed_content.get('summary', '')
|
|
67
|
-
tier2_archived_at = compressed_content.get('compressed_at')
|
|
68
|
-
original_length = compressed_content.get('original_length', 0)
|
|
69
|
-
else:
|
|
70
|
-
# Not Tier 2 format, treat as plain text
|
|
71
|
-
summary = content
|
|
72
|
-
tier2_archived_at = None
|
|
73
|
-
original_length = len(content)
|
|
74
|
-
|
|
75
|
-
except (json.JSONDecodeError, TypeError):
|
|
76
|
-
# Not JSON, treat as plain text
|
|
77
|
-
summary = content
|
|
78
|
-
tier2_archived_at = None
|
|
79
|
-
original_length = len(content)
|
|
80
|
-
|
|
81
|
-
# Convert summary to bullet points (max 5)
|
|
82
|
-
bullet_points = self._summarize_to_bullets(summary)
|
|
83
|
-
|
|
84
|
-
# Ultra-compressed version
|
|
85
|
-
ultra_compressed = {
|
|
86
|
-
'bullets': bullet_points,
|
|
87
|
-
'tier2_archived_at': tier2_archived_at,
|
|
88
|
-
'original_length': original_length,
|
|
89
|
-
'compressed_to_tier3_at': datetime.now().isoformat()
|
|
90
|
-
}
|
|
91
|
-
|
|
92
|
-
# Update memory
|
|
93
|
-
cursor.execute('''
|
|
94
|
-
UPDATE memories
|
|
95
|
-
SET content = ?, tier = 3, updated_at = CURRENT_TIMESTAMP
|
|
96
|
-
WHERE id = ?
|
|
97
|
-
''', (json.dumps(ultra_compressed), memory_id))
|
|
98
|
-
|
|
99
|
-
conn.commit()
|
|
100
|
-
finally:
|
|
101
|
-
conn.close()
|
|
102
|
-
return True
|
|
103
|
-
|
|
104
|
-
def _summarize_to_bullets(self, summary: str, max_bullets: int = 5) -> List[str]:
|
|
105
|
-
"""
|
|
106
|
-
Convert summary to bullet points.
|
|
107
|
-
|
|
108
|
-
Args:
|
|
109
|
-
summary: Summary text
|
|
110
|
-
max_bullets: Maximum number of bullets
|
|
111
|
-
|
|
112
|
-
Returns:
|
|
113
|
-
List of bullet point strings
|
|
114
|
-
"""
|
|
115
|
-
# Split into sentences
|
|
116
|
-
sentences = re.split(r'[.!?]+', summary)
|
|
117
|
-
|
|
118
|
-
bullets = []
|
|
119
|
-
|
|
120
|
-
for sent in sentences:
|
|
121
|
-
sent = sent.strip()
|
|
122
|
-
|
|
123
|
-
if len(sent) < 10:
|
|
124
|
-
continue
|
|
125
|
-
|
|
126
|
-
# Truncate long sentences
|
|
127
|
-
if len(sent) > 80:
|
|
128
|
-
sent = sent[:77] + '...'
|
|
129
|
-
|
|
130
|
-
bullets.append(sent)
|
|
131
|
-
|
|
132
|
-
if len(bullets) >= max_bullets:
|
|
133
|
-
break
|
|
134
|
-
|
|
135
|
-
return bullets if bullets else ['[No summary available]']
|
|
136
|
-
|
|
137
|
-
def compress_all_tier3(self) -> int:
|
|
138
|
-
"""Compress all memories that are in Tier 3."""
|
|
139
|
-
conn = sqlite3.connect(self.db_path)
|
|
140
|
-
try:
|
|
141
|
-
cursor = conn.cursor()
|
|
142
|
-
|
|
143
|
-
cursor.execute('SELECT id FROM memories WHERE tier = 3')
|
|
144
|
-
memory_ids = [row[0] for row in cursor.fetchall()]
|
|
145
|
-
finally:
|
|
146
|
-
conn.close()
|
|
147
|
-
|
|
148
|
-
compressed_count = 0
|
|
149
|
-
for memory_id in memory_ids:
|
|
150
|
-
if self.compress_to_tier3(memory_id):
|
|
151
|
-
compressed_count += 1
|
|
152
|
-
|
|
153
|
-
return compressed_count
|
|
@@ -1,148 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
# SPDX-License-Identifier: MIT
|
|
3
|
-
# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
|
|
4
|
-
"""
|
|
5
|
-
Tier classification logic for memory compression.
|
|
6
|
-
Classifies memories into tiers based on age and access patterns.
|
|
7
|
-
"""
|
|
8
|
-
|
|
9
|
-
import sqlite3
|
|
10
|
-
from datetime import datetime
|
|
11
|
-
from pathlib import Path
|
|
12
|
-
from typing import List, Dict, Tuple
|
|
13
|
-
|
|
14
|
-
from compression.config import CompressionConfig
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
MEMORY_DIR = Path.home() / ".claude-memory"
|
|
18
|
-
DB_PATH = MEMORY_DIR / "memory.db"
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
class TierClassifier:
|
|
22
|
-
"""Classify memories into compression tiers based on age and access patterns."""
|
|
23
|
-
|
|
24
|
-
def __init__(self, db_path: Path = DB_PATH):
|
|
25
|
-
self.db_path = db_path
|
|
26
|
-
self.config = CompressionConfig()
|
|
27
|
-
self._ensure_schema()
|
|
28
|
-
|
|
29
|
-
def _ensure_schema(self):
|
|
30
|
-
"""Add tier and access tracking columns if not present."""
|
|
31
|
-
conn = sqlite3.connect(self.db_path)
|
|
32
|
-
try:
|
|
33
|
-
cursor = conn.cursor()
|
|
34
|
-
|
|
35
|
-
# Check if tier column exists
|
|
36
|
-
cursor.execute("PRAGMA table_info(memories)")
|
|
37
|
-
columns = [row[1] for row in cursor.fetchall()]
|
|
38
|
-
|
|
39
|
-
if 'tier' not in columns:
|
|
40
|
-
cursor.execute('ALTER TABLE memories ADD COLUMN tier INTEGER DEFAULT 1')
|
|
41
|
-
cursor.execute('CREATE INDEX IF NOT EXISTS idx_tier ON memories(tier)')
|
|
42
|
-
|
|
43
|
-
if 'last_accessed' not in columns:
|
|
44
|
-
cursor.execute('ALTER TABLE memories ADD COLUMN last_accessed TIMESTAMP')
|
|
45
|
-
|
|
46
|
-
if 'access_count' not in columns:
|
|
47
|
-
cursor.execute('ALTER TABLE memories ADD COLUMN access_count INTEGER DEFAULT 0')
|
|
48
|
-
|
|
49
|
-
# Create memory_archive table if not exists
|
|
50
|
-
cursor.execute('''
|
|
51
|
-
CREATE TABLE IF NOT EXISTS memory_archive (
|
|
52
|
-
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
53
|
-
memory_id INTEGER UNIQUE NOT NULL,
|
|
54
|
-
full_content TEXT NOT NULL,
|
|
55
|
-
archived_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
|
56
|
-
FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
|
|
57
|
-
)
|
|
58
|
-
''')
|
|
59
|
-
cursor.execute('CREATE INDEX IF NOT EXISTS idx_archive_memory ON memory_archive(memory_id)')
|
|
60
|
-
|
|
61
|
-
conn.commit()
|
|
62
|
-
finally:
|
|
63
|
-
conn.close()
|
|
64
|
-
|
|
65
|
-
def classify_memories(self) -> List[Tuple[int, int]]:
|
|
66
|
-
"""
|
|
67
|
-
Classify all memories into tiers based on age and access.
|
|
68
|
-
|
|
69
|
-
Returns:
|
|
70
|
-
List of (tier, memory_id) tuples
|
|
71
|
-
"""
|
|
72
|
-
if not self.config.enabled:
|
|
73
|
-
return []
|
|
74
|
-
|
|
75
|
-
now = datetime.now()
|
|
76
|
-
conn = sqlite3.connect(self.db_path)
|
|
77
|
-
try:
|
|
78
|
-
cursor = conn.cursor()
|
|
79
|
-
|
|
80
|
-
# Get all memories with access tracking
|
|
81
|
-
cursor.execute('''
|
|
82
|
-
SELECT id, created_at, last_accessed, access_count, importance, tier
|
|
83
|
-
FROM memories
|
|
84
|
-
''')
|
|
85
|
-
memories = cursor.fetchall()
|
|
86
|
-
|
|
87
|
-
tier_updates = []
|
|
88
|
-
|
|
89
|
-
for memory_id, created_at, last_accessed, access_count, importance, current_tier in memories:
|
|
90
|
-
created = datetime.fromisoformat(created_at)
|
|
91
|
-
age_days = (now - created).days
|
|
92
|
-
|
|
93
|
-
# Override: High-importance memories stay in Tier 1
|
|
94
|
-
if self.config.preserve_high_importance and importance and importance >= 8:
|
|
95
|
-
tier = 1
|
|
96
|
-
# Recently accessed stays in Tier 1
|
|
97
|
-
elif self.config.preserve_recently_accessed and last_accessed:
|
|
98
|
-
last_access = datetime.fromisoformat(last_accessed)
|
|
99
|
-
if (now - last_access).days < 7:
|
|
100
|
-
tier = 1
|
|
101
|
-
else:
|
|
102
|
-
tier = self._classify_by_age(age_days)
|
|
103
|
-
# Age-based classification
|
|
104
|
-
else:
|
|
105
|
-
tier = self._classify_by_age(age_days)
|
|
106
|
-
|
|
107
|
-
# Only update if tier changed
|
|
108
|
-
if tier != current_tier:
|
|
109
|
-
tier_updates.append((tier, memory_id))
|
|
110
|
-
|
|
111
|
-
# Update tier field
|
|
112
|
-
if tier_updates:
|
|
113
|
-
cursor.executemany('''
|
|
114
|
-
UPDATE memories SET tier = ? WHERE id = ?
|
|
115
|
-
''', tier_updates)
|
|
116
|
-
conn.commit()
|
|
117
|
-
|
|
118
|
-
finally:
|
|
119
|
-
conn.close()
|
|
120
|
-
return tier_updates
|
|
121
|
-
|
|
122
|
-
def _classify_by_age(self, age_days: int) -> int:
|
|
123
|
-
"""Classify memory tier based on age."""
|
|
124
|
-
if age_days < self.config.tier2_threshold_days:
|
|
125
|
-
return 1 # Recent
|
|
126
|
-
elif age_days < self.config.tier3_threshold_days:
|
|
127
|
-
return 2 # Active
|
|
128
|
-
else:
|
|
129
|
-
return 3 # Archived
|
|
130
|
-
|
|
131
|
-
def get_tier_stats(self) -> Dict[str, int]:
|
|
132
|
-
"""Get count of memories in each tier."""
|
|
133
|
-
conn = sqlite3.connect(self.db_path)
|
|
134
|
-
try:
|
|
135
|
-
cursor = conn.cursor()
|
|
136
|
-
|
|
137
|
-
cursor.execute('''
|
|
138
|
-
SELECT tier, COUNT(*) FROM memories GROUP BY tier
|
|
139
|
-
''')
|
|
140
|
-
stats = dict(cursor.fetchall())
|
|
141
|
-
finally:
|
|
142
|
-
conn.close()
|
|
143
|
-
|
|
144
|
-
return {
|
|
145
|
-
'tier1': stats.get(1, 0),
|
|
146
|
-
'tier2': stats.get(2, 0),
|
|
147
|
-
'tier3': stats.get(3, 0)
|
|
148
|
-
}
|