@claude-flow/cli 3.6.30 → 3.7.0-alpha.10
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/.claude/agents/analysis/analyze-code-quality.md +178 -178
- package/.claude/agents/analysis/code-analyzer.md +209 -209
- package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
- package/.claude/agents/architecture/arch-system-design.md +156 -156
- package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
- package/.claude/agents/browser/browser-agent.yaml +182 -182
- package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
- package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
- package/.claude/agents/consensus/gossip-coordinator.md +62 -62
- package/.claude/agents/consensus/performance-benchmarker.md +850 -850
- package/.claude/agents/consensus/quorum-manager.md +822 -822
- package/.claude/agents/consensus/raft-manager.md +62 -62
- package/.claude/agents/consensus/security-manager.md +621 -621
- package/.claude/agents/core/coder.md +452 -452
- package/.claude/agents/core/planner.md +374 -374
- package/.claude/agents/core/researcher.md +368 -368
- package/.claude/agents/core/reviewer.md +519 -519
- package/.claude/agents/core/tester.md +511 -511
- package/.claude/agents/custom/test-long-runner.md +44 -44
- package/.claude/agents/data/data-ml-model.md +444 -444
- package/.claude/agents/data/ml/data-ml-model.md +192 -192
- package/.claude/agents/development/backend/dev-backend-api.md +141 -141
- package/.claude/agents/development/dev-backend-api.md +344 -344
- package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
- package/.claude/agents/devops/ops-cicd-github.md +164 -164
- package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
- package/.claude/agents/documentation/docs-api-openapi.md +354 -354
- package/.claude/agents/flow-nexus/app-store.md +87 -87
- package/.claude/agents/flow-nexus/authentication.md +68 -68
- package/.claude/agents/flow-nexus/challenges.md +80 -80
- package/.claude/agents/flow-nexus/neural-network.md +87 -87
- package/.claude/agents/flow-nexus/payments.md +82 -82
- package/.claude/agents/flow-nexus/sandbox.md +75 -75
- package/.claude/agents/flow-nexus/swarm.md +75 -75
- package/.claude/agents/flow-nexus/user-tools.md +95 -95
- package/.claude/agents/flow-nexus/workflow.md +83 -83
- package/.claude/agents/github/code-review-swarm.md +377 -377
- package/.claude/agents/github/github-modes.md +172 -172
- package/.claude/agents/github/issue-tracker.md +575 -575
- package/.claude/agents/github/multi-repo-swarm.md +552 -552
- package/.claude/agents/github/pr-manager.md +437 -437
- package/.claude/agents/github/project-board-sync.md +508 -508
- package/.claude/agents/github/release-manager.md +604 -604
- package/.claude/agents/github/release-swarm.md +582 -582
- package/.claude/agents/github/repo-architect.md +397 -397
- package/.claude/agents/github/swarm-issue.md +572 -572
- package/.claude/agents/github/swarm-pr.md +427 -427
- package/.claude/agents/github/sync-coordinator.md +451 -451
- package/.claude/agents/github/workflow-automation.md +902 -902
- package/.claude/agents/goal/agent.md +815 -815
- package/.claude/agents/goal/goal-planner.md +72 -72
- package/.claude/agents/optimization/benchmark-suite.md +664 -664
- package/.claude/agents/optimization/load-balancer.md +430 -430
- package/.claude/agents/optimization/performance-monitor.md +671 -671
- package/.claude/agents/optimization/resource-allocator.md +673 -673
- package/.claude/agents/optimization/topology-optimizer.md +807 -807
- package/.claude/agents/payments/agentic-payments.md +126 -126
- package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
- package/.claude/agents/sparc/architecture.md +698 -698
- package/.claude/agents/sparc/pseudocode.md +519 -519
- package/.claude/agents/sparc/refinement.md +801 -801
- package/.claude/agents/sparc/specification.md +477 -477
- package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
- package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
- package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
- package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
- package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
- package/.claude/agents/sublinear/performance-optimizer.md +367 -367
- package/.claude/agents/sublinear/trading-predictor.md +245 -245
- package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
- package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
- package/.claude/agents/swarm/mesh-coordinator.md +962 -962
- package/.claude/agents/templates/automation-smart-agent.md +204 -204
- package/.claude/agents/templates/base-template-generator.md +289 -289
- package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
- package/.claude/agents/templates/github-pr-manager.md +176 -176
- package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
- package/.claude/agents/templates/memory-coordinator.md +186 -186
- package/.claude/agents/templates/orchestrator-task.md +138 -138
- package/.claude/agents/templates/performance-analyzer.md +198 -198
- package/.claude/agents/templates/sparc-coordinator.md +513 -513
- package/.claude/agents/testing/production-validator.md +394 -394
- package/.claude/agents/testing/tdd-london-swarm.md +243 -243
- package/.claude/agents/v3/adr-architect.md +184 -184
- package/.claude/agents/v3/aidefence-guardian.md +282 -282
- package/.claude/agents/v3/claims-authorizer.md +208 -208
- package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
- package/.claude/agents/v3/ddd-domain-expert.md +220 -220
- package/.claude/agents/v3/injection-analyst.md +236 -236
- package/.claude/agents/v3/memory-specialist.md +995 -995
- package/.claude/agents/v3/performance-engineer.md +1233 -1233
- package/.claude/agents/v3/pii-detector.md +151 -151
- package/.claude/agents/v3/reasoningbank-learner.md +213 -213
- package/.claude/agents/v3/security-architect-aidefence.md +410 -410
- package/.claude/agents/v3/security-architect.md +867 -867
- package/.claude/agents/v3/security-auditor.md +771 -771
- package/.claude/agents/v3/sparc-orchestrator.md +182 -182
- package/.claude/agents/v3/swarm-memory-manager.md +157 -157
- package/.claude/agents/v3/v3-integration-architect.md +205 -205
- package/.claude/commands/agents/README.md +50 -50
- package/.claude/commands/agents/agent-capabilities.md +140 -140
- package/.claude/commands/agents/agent-coordination.md +28 -28
- package/.claude/commands/agents/agent-spawning.md +28 -28
- package/.claude/commands/agents/agent-types.md +216 -216
- package/.claude/commands/agents/health.md +139 -139
- package/.claude/commands/agents/list.md +100 -100
- package/.claude/commands/agents/logs.md +130 -130
- package/.claude/commands/agents/metrics.md +122 -122
- package/.claude/commands/agents/pool.md +127 -127
- package/.claude/commands/agents/spawn.md +140 -140
- package/.claude/commands/agents/status.md +115 -115
- package/.claude/commands/agents/stop.md +102 -102
- package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
- package/.claude/commands/analysis/README.md +9 -9
- package/.claude/commands/analysis/bottleneck-detect.md +162 -162
- package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
- package/.claude/commands/analysis/performance-report.md +25 -25
- package/.claude/commands/analysis/token-efficiency.md +44 -44
- package/.claude/commands/analysis/token-usage.md +25 -25
- package/.claude/commands/automation/README.md +9 -9
- package/.claude/commands/automation/auto-agent.md +122 -122
- package/.claude/commands/automation/self-healing.md +105 -105
- package/.claude/commands/automation/session-memory.md +89 -89
- package/.claude/commands/automation/smart-agents.md +72 -72
- package/.claude/commands/automation/smart-spawn.md +25 -25
- package/.claude/commands/automation/workflow-select.md +25 -25
- package/.claude/commands/claude-flow-help.md +103 -103
- package/.claude/commands/claude-flow-memory.md +107 -107
- package/.claude/commands/claude-flow-swarm.md +205 -205
- package/.claude/commands/coordination/README.md +9 -9
- package/.claude/commands/coordination/agent-spawn.md +25 -25
- package/.claude/commands/coordination/init.md +44 -44
- package/.claude/commands/coordination/orchestrate.md +43 -43
- package/.claude/commands/coordination/spawn.md +45 -45
- package/.claude/commands/coordination/swarm-init.md +85 -85
- package/.claude/commands/coordination/task-orchestrate.md +25 -25
- package/.claude/commands/flow-nexus/app-store.md +123 -123
- package/.claude/commands/flow-nexus/challenges.md +119 -119
- package/.claude/commands/flow-nexus/login-registration.md +64 -64
- package/.claude/commands/flow-nexus/neural-network.md +133 -133
- package/.claude/commands/flow-nexus/payments.md +115 -115
- package/.claude/commands/flow-nexus/sandbox.md +82 -82
- package/.claude/commands/flow-nexus/swarm.md +86 -86
- package/.claude/commands/flow-nexus/user-tools.md +151 -151
- package/.claude/commands/flow-nexus/workflow.md +114 -114
- package/.claude/commands/github/README.md +11 -11
- package/.claude/commands/github/code-review-swarm.md +513 -513
- package/.claude/commands/github/code-review.md +25 -25
- package/.claude/commands/github/github-modes.md +146 -146
- package/.claude/commands/github/github-swarm.md +121 -121
- package/.claude/commands/github/issue-tracker.md +291 -291
- package/.claude/commands/github/issue-triage.md +25 -25
- package/.claude/commands/github/multi-repo-swarm.md +518 -518
- package/.claude/commands/github/pr-enhance.md +26 -26
- package/.claude/commands/github/pr-manager.md +169 -169
- package/.claude/commands/github/project-board-sync.md +470 -470
- package/.claude/commands/github/release-manager.md +337 -337
- package/.claude/commands/github/release-swarm.md +543 -543
- package/.claude/commands/github/repo-analyze.md +25 -25
- package/.claude/commands/github/repo-architect.md +366 -366
- package/.claude/commands/github/swarm-issue.md +481 -481
- package/.claude/commands/github/swarm-pr.md +284 -284
- package/.claude/commands/github/sync-coordinator.md +300 -300
- package/.claude/commands/github/workflow-automation.md +441 -441
- package/.claude/commands/hive-mind/README.md +17 -17
- package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
- package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
- package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
- package/.claude/commands/hive-mind/hive-mind.md +27 -27
- package/.claude/commands/hooks/README.md +11 -11
- package/.claude/commands/hooks/overview.md +57 -57
- package/.claude/commands/hooks/post-edit.md +117 -117
- package/.claude/commands/hooks/post-task.md +112 -112
- package/.claude/commands/hooks/pre-edit.md +113 -113
- package/.claude/commands/hooks/pre-task.md +111 -111
- package/.claude/commands/hooks/session-end.md +118 -118
- package/.claude/commands/hooks/setup.md +102 -102
- package/.claude/commands/memory/README.md +9 -9
- package/.claude/commands/memory/memory-persist.md +25 -25
- package/.claude/commands/memory/memory-search.md +25 -25
- package/.claude/commands/memory/memory-usage.md +25 -25
- package/.claude/commands/memory/neural.md +47 -47
- package/.claude/commands/monitoring/README.md +9 -9
- package/.claude/commands/monitoring/agent-metrics.md +25 -25
- package/.claude/commands/monitoring/agents.md +44 -44
- package/.claude/commands/monitoring/real-time-view.md +25 -25
- package/.claude/commands/monitoring/status.md +46 -46
- package/.claude/commands/monitoring/swarm-monitor.md +25 -25
- package/.claude/commands/optimization/README.md +9 -9
- package/.claude/commands/optimization/auto-topology.md +61 -61
- package/.claude/commands/optimization/cache-manage.md +25 -25
- package/.claude/commands/optimization/parallel-execute.md +25 -25
- package/.claude/commands/optimization/parallel-execution.md +49 -49
- package/.claude/commands/optimization/topology-optimize.md +25 -25
- package/.claude/commands/pair/README.md +260 -260
- package/.claude/commands/pair/commands.md +545 -545
- package/.claude/commands/pair/config.md +509 -509
- package/.claude/commands/pair/examples.md +511 -511
- package/.claude/commands/pair/modes.md +347 -347
- package/.claude/commands/pair/session.md +406 -406
- package/.claude/commands/pair/start.md +208 -208
- package/.claude/commands/sparc/analyzer.md +51 -51
- package/.claude/commands/sparc/architect.md +53 -53
- package/.claude/commands/sparc/ask.md +97 -97
- package/.claude/commands/sparc/batch-executor.md +54 -54
- package/.claude/commands/sparc/code.md +89 -89
- package/.claude/commands/sparc/coder.md +54 -54
- package/.claude/commands/sparc/debug.md +83 -83
- package/.claude/commands/sparc/debugger.md +54 -54
- package/.claude/commands/sparc/designer.md +53 -53
- package/.claude/commands/sparc/devops.md +109 -109
- package/.claude/commands/sparc/docs-writer.md +80 -80
- package/.claude/commands/sparc/documenter.md +54 -54
- package/.claude/commands/sparc/innovator.md +54 -54
- package/.claude/commands/sparc/integration.md +83 -83
- package/.claude/commands/sparc/mcp.md +117 -117
- package/.claude/commands/sparc/memory-manager.md +54 -54
- package/.claude/commands/sparc/optimizer.md +54 -54
- package/.claude/commands/sparc/orchestrator.md +131 -131
- package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
- package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
- package/.claude/commands/sparc/researcher.md +54 -54
- package/.claude/commands/sparc/reviewer.md +54 -54
- package/.claude/commands/sparc/security-review.md +80 -80
- package/.claude/commands/sparc/sparc-modes.md +174 -174
- package/.claude/commands/sparc/sparc.md +111 -111
- package/.claude/commands/sparc/spec-pseudocode.md +80 -80
- package/.claude/commands/sparc/supabase-admin.md +348 -348
- package/.claude/commands/sparc/swarm-coordinator.md +54 -54
- package/.claude/commands/sparc/tdd.md +54 -54
- package/.claude/commands/sparc/tester.md +54 -54
- package/.claude/commands/sparc/tutorial.md +79 -79
- package/.claude/commands/sparc/workflow-manager.md +54 -54
- package/.claude/commands/sparc.md +166 -166
- package/.claude/commands/stream-chain/pipeline.md +120 -120
- package/.claude/commands/stream-chain/run.md +69 -69
- package/.claude/commands/swarm/README.md +15 -15
- package/.claude/commands/swarm/analysis.md +95 -95
- package/.claude/commands/swarm/development.md +96 -96
- package/.claude/commands/swarm/examples.md +168 -168
- package/.claude/commands/swarm/maintenance.md +102 -102
- package/.claude/commands/swarm/optimization.md +117 -117
- package/.claude/commands/swarm/research.md +136 -136
- package/.claude/commands/swarm/swarm-analysis.md +8 -8
- package/.claude/commands/swarm/swarm-background.md +8 -8
- package/.claude/commands/swarm/swarm-init.md +19 -19
- package/.claude/commands/swarm/swarm-modes.md +8 -8
- package/.claude/commands/swarm/swarm-monitor.md +8 -8
- package/.claude/commands/swarm/swarm-spawn.md +19 -19
- package/.claude/commands/swarm/swarm-status.md +8 -8
- package/.claude/commands/swarm/swarm-strategies.md +8 -8
- package/.claude/commands/swarm/swarm.md +87 -87
- package/.claude/commands/swarm/testing.md +131 -131
- package/.claude/commands/training/README.md +9 -9
- package/.claude/commands/training/model-update.md +25 -25
- package/.claude/commands/training/neural-patterns.md +107 -107
- package/.claude/commands/training/neural-train.md +75 -75
- package/.claude/commands/training/pattern-learn.md +25 -25
- package/.claude/commands/training/specialization.md +62 -62
- package/.claude/commands/truth/start.md +142 -142
- package/.claude/commands/verify/check.md +49 -49
- package/.claude/commands/verify/start.md +127 -127
- package/.claude/commands/workflows/README.md +9 -9
- package/.claude/commands/workflows/development.md +77 -77
- package/.claude/commands/workflows/research.md +62 -62
- package/.claude/commands/workflows/workflow-create.md +25 -25
- package/.claude/commands/workflows/workflow-execute.md +25 -25
- package/.claude/commands/workflows/workflow-export.md +25 -25
- package/.claude/helpers/README.md +96 -96
- package/.claude/helpers/adr-compliance.sh +186 -186
- package/.claude/helpers/auto-commit.sh +178 -178
- package/.claude/helpers/auto-memory-hook.mjs +368 -368
- package/.claude/helpers/checkpoint-manager.sh +251 -251
- package/.claude/helpers/daemon-manager.sh +252 -252
- package/.claude/helpers/ddd-tracker.sh +144 -144
- package/.claude/helpers/github-safe.js +121 -121
- package/.claude/helpers/github-setup.sh +28 -28
- package/.claude/helpers/guidance-hook.sh +13 -13
- package/.claude/helpers/guidance-hooks.sh +102 -102
- package/.claude/helpers/health-monitor.sh +108 -108
- package/.claude/helpers/hook-handler.cjs +278 -278
- package/.claude/helpers/intelligence.cjs +1031 -1031
- package/.claude/helpers/learning-hooks.sh +329 -329
- package/.claude/helpers/learning-optimizer.sh +127 -127
- package/.claude/helpers/learning-service.mjs +1144 -1144
- package/.claude/helpers/memory.js +83 -83
- package/.claude/helpers/metrics-db.mjs +488 -488
- package/.claude/helpers/pattern-consolidator.sh +86 -86
- package/.claude/helpers/perf-worker.sh +160 -160
- package/.claude/helpers/post-commit +16 -16
- package/.claude/helpers/pre-commit +26 -26
- package/.claude/helpers/quick-start.sh +19 -19
- package/.claude/helpers/router.js +66 -66
- package/.claude/helpers/security-scanner.sh +127 -127
- package/.claude/helpers/session.js +135 -135
- package/.claude/helpers/setup-mcp.sh +18 -18
- package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
- package/.claude/helpers/statusline-hook.sh +21 -21
- package/.claude/helpers/statusline.cjs +575 -575
- package/.claude/helpers/statusline.js +321 -321
- package/.claude/helpers/swarm-comms.sh +353 -353
- package/.claude/helpers/swarm-hooks.sh +761 -761
- package/.claude/helpers/swarm-monitor.sh +210 -210
- package/.claude/helpers/sync-v3-metrics.sh +245 -245
- package/.claude/helpers/update-v3-progress.sh +165 -165
- package/.claude/helpers/v3-quick-status.sh +57 -57
- package/.claude/helpers/v3.sh +110 -110
- package/.claude/helpers/validate-v3-config.sh +215 -215
- package/.claude/helpers/worker-manager.sh +170 -170
- package/.claude/settings.json +182 -182
- package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
- package/.claude/skills/agentdb-learning/SKILL.md +545 -545
- package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
- package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
- package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
- package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
- package/.claude/skills/aidefence-scan.md +151 -151
- package/.claude/skills/aidefence.yaml +297 -297
- package/.claude/skills/browser/SKILL.md +204 -204
- package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
- package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
- package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
- package/.claude/skills/github-code-review/SKILL.md +1140 -1140
- package/.claude/skills/github-multi-repo/SKILL.md +874 -874
- package/.claude/skills/github-project-management/SKILL.md +1290 -1277
- package/.claude/skills/github-release-management/SKILL.md +1081 -1081
- package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
- package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
- package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
- package/.claude/skills/pair-programming/SKILL.md +1202 -1202
- package/.claude/skills/performance-analysis/SKILL.md +563 -563
- package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
- package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
- package/.claude/skills/secure-review.md +181 -181
- package/.claude/skills/skill-builder/SKILL.md +910 -910
- package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
- package/.claude/skills/stream-chain/SKILL.md +563 -563
- package/.claude/skills/swarm-advanced/SKILL.md +973 -973
- package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
- package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
- package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
- package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
- package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
- package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
- package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
- package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
- package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
- package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
- package/.claude/skills/verification-quality/SKILL.md +649 -649
- package/.claude/skills/worker-benchmarks/skill.md +135 -135
- package/.claude/skills/worker-integration/skill.md +154 -154
- package/README.md +393 -391
- package/bin/cli.js +220 -220
- package/bin/mcp-server.js +224 -224
- package/bin/preinstall.cjs +2 -2
- package/dist/src/commands/agent-wasm.js +2 -2
- package/dist/src/commands/agent-wasm.js.map +1 -1
- package/dist/src/commands/completions.js +409 -409
- package/dist/src/commands/daemon.d.ts.map +1 -1
- package/dist/src/commands/daemon.js +19 -3
- package/dist/src/commands/daemon.js.map +1 -1
- package/dist/src/commands/doctor.d.ts.map +1 -1
- package/dist/src/commands/doctor.js +105 -23
- package/dist/src/commands/doctor.js.map +1 -1
- package/dist/src/commands/embeddings.js +26 -26
- package/dist/src/commands/hive-mind.d.ts.map +1 -1
- package/dist/src/commands/hive-mind.js +122 -104
- package/dist/src/commands/hive-mind.js.map +1 -1
- package/dist/src/commands/hooks.d.ts.map +1 -1
- package/dist/src/commands/hooks.js +34 -21
- package/dist/src/commands/hooks.js.map +1 -1
- package/dist/src/commands/memory.d.ts.map +1 -1
- package/dist/src/commands/memory.js +68 -0
- package/dist/src/commands/memory.js.map +1 -1
- package/dist/src/commands/ruvector/backup.js +23 -23
- package/dist/src/commands/ruvector/benchmark.js +31 -31
- package/dist/src/commands/ruvector/import.js +14 -14
- package/dist/src/commands/ruvector/init.js +115 -115
- package/dist/src/commands/ruvector/migrate.js +99 -99
- package/dist/src/commands/ruvector/optimize.js +51 -51
- package/dist/src/commands/ruvector/setup.js +624 -624
- package/dist/src/commands/ruvector/status.js +38 -38
- package/dist/src/index.d.ts +5 -1
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +59 -18
- package/dist/src/index.js.map +1 -1
- package/dist/src/init/claudemd-generator.js +226 -226
- package/dist/src/init/executor.d.ts.map +1 -1
- package/dist/src/init/executor.js +511 -453
- package/dist/src/init/executor.js.map +1 -1
- package/dist/src/init/helpers-generator.js +645 -645
- package/dist/src/init/settings-generator.d.ts.map +1 -1
- package/dist/src/init/settings-generator.js +11 -5
- package/dist/src/init/settings-generator.js.map +1 -1
- package/dist/src/init/statusline-generator.js +858 -858
- package/dist/src/init/types.d.ts +7 -0
- package/dist/src/init/types.d.ts.map +1 -1
- package/dist/src/init/types.js.map +1 -1
- package/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
- package/dist/src/mcp-tools/agentdb-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/agentdb-tools.js +108 -0
- package/dist/src/mcp-tools/agentdb-tools.js.map +1 -1
- package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/hooks-tools.js +4 -2
- package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
- package/dist/src/mcp-tools/memory-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/memory-tools.js +19 -0
- package/dist/src/mcp-tools/memory-tools.js.map +1 -1
- package/dist/src/mcp-tools/neural-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/neural-tools.js +14 -1
- package/dist/src/mcp-tools/neural-tools.js.map +1 -1
- package/dist/src/mcp-tools/security-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/security-tools.js +28 -3
- package/dist/src/mcp-tools/security-tools.js.map +1 -1
- package/dist/src/mcp-tools/swarm-tools.d.ts.map +1 -1
- package/dist/src/mcp-tools/swarm-tools.js +72 -3
- package/dist/src/mcp-tools/swarm-tools.js.map +1 -1
- package/dist/src/mcp-tools/types.d.ts +4 -33
- package/dist/src/mcp-tools/types.d.ts.map +1 -1
- package/dist/src/mcp-tools/types.js +4 -14
- package/dist/src/mcp-tools/types.js.map +1 -1
- package/dist/src/mcp-tools/validate-input.d.ts +5 -57
- package/dist/src/mcp-tools/validate-input.d.ts.map +1 -1
- package/dist/src/mcp-tools/validate-input.js +5 -233
- package/dist/src/mcp-tools/validate-input.js.map +1 -1
- package/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
- package/dist/src/mcp-tools/wasm-agent-tools.js.map +1 -1
- package/dist/src/memory/intelligence.d.ts.map +1 -1
- package/dist/src/memory/intelligence.js +28 -3
- package/dist/src/memory/intelligence.js.map +1 -1
- package/dist/src/memory/memory-bridge.d.ts +69 -0
- package/dist/src/memory/memory-bridge.d.ts.map +1 -1
- package/dist/src/memory/memory-bridge.js +319 -66
- package/dist/src/memory/memory-bridge.js.map +1 -1
- package/dist/src/memory/memory-initializer.d.ts +5 -0
- package/dist/src/memory/memory-initializer.d.ts.map +1 -1
- package/dist/src/memory/memory-initializer.js +369 -363
- package/dist/src/memory/memory-initializer.js.map +1 -1
- package/dist/src/memory/neural-package-bridge.d.ts +48 -0
- package/dist/src/memory/neural-package-bridge.d.ts.map +1 -0
- package/dist/src/memory/neural-package-bridge.js +87 -0
- package/dist/src/memory/neural-package-bridge.js.map +1 -0
- package/dist/src/memory/rabitq-index.js +5 -5
- package/dist/src/memory/sona-optimizer.d.ts.map +1 -1
- package/dist/src/memory/sona-optimizer.js +1 -0
- package/dist/src/memory/sona-optimizer.js.map +1 -1
- package/dist/src/output.d.ts +6 -130
- package/dist/src/output.d.ts.map +1 -1
- package/dist/src/output.js +6 -511
- package/dist/src/output.js.map +1 -1
- package/dist/src/parser.d.ts +9 -0
- package/dist/src/parser.d.ts.map +1 -1
- package/dist/src/parser.js +11 -0
- package/dist/src/parser.js.map +1 -1
- package/dist/src/runtime/headless.js +28 -28
- package/dist/src/ruvector/agent-wasm.d.ts.map +1 -1
- package/dist/src/ruvector/agent-wasm.js +4 -1
- package/dist/src/ruvector/agent-wasm.js.map +1 -1
- package/dist/src/ruvector/index.d.ts +0 -2
- package/dist/src/ruvector/index.d.ts.map +1 -1
- package/dist/src/ruvector/index.js +8 -2
- package/dist/src/ruvector/index.js.map +1 -1
- package/dist/src/ruvector/model-router.d.ts +22 -1
- package/dist/src/ruvector/model-router.d.ts.map +1 -1
- package/dist/src/ruvector/model-router.js +125 -5
- package/dist/src/ruvector/model-router.js.map +1 -1
- package/dist/src/services/headless-worker-executor.js +84 -84
- package/dist/src/transfer/deploy-seraphine.js +23 -23
- package/dist/src/types.d.ts +10 -195
- package/dist/src/types.d.ts.map +1 -1
- package/dist/src/types.js +10 -35
- package/dist/src/types.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +6 -4
- package/scripts/deploy-ipfs-node.sh +153 -153
- package/scripts/postinstall.cjs +153 -153
- package/scripts/publish-registry.ts +345 -345
- package/scripts/publish.sh +57 -57
- package/scripts/setup-ipfs-registry.md +366 -366
- package/dist/src/services/event-stream.d.ts.map +0 -1
- package/dist/src/services/event-stream.js.map +0 -1
- package/dist/src/services/loop-worker-runner.d.ts.map +0 -1
- package/dist/src/services/loop-worker-runner.js.map +0 -1
- package/dist/src/services/runtime-capabilities.d.ts.map +0 -1
- package/dist/src/services/runtime-capabilities.js.map +0 -1
|
@@ -1,1031 +1,1031 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* Intelligence Layer (ADR-050)
|
|
4
|
-
*
|
|
5
|
-
* Closes the intelligence loop by wiring PageRank-ranked memory into
|
|
6
|
-
* the hook system. Pure CJS — no ESM imports of @claude-flow/memory.
|
|
7
|
-
*
|
|
8
|
-
* Data files (all under .claude-flow/data/):
|
|
9
|
-
* auto-memory-store.json — written by auto-memory-hook.mjs
|
|
10
|
-
* graph-state.json — serialized graph (nodes + edges + pageRanks)
|
|
11
|
-
* ranked-context.json — pre-computed ranked entries for fast lookup
|
|
12
|
-
* pending-insights.jsonl — append-only edit/task log
|
|
13
|
-
*/
|
|
14
|
-
|
|
15
|
-
'use strict';
|
|
16
|
-
|
|
17
|
-
const fs = require('fs');
|
|
18
|
-
const path = require('path');
|
|
19
|
-
|
|
20
|
-
const DATA_DIR = path.join(process.cwd(), '.claude-flow', 'data');
|
|
21
|
-
const STORE_PATH = path.join(DATA_DIR, 'auto-memory-store.json');
|
|
22
|
-
const GRAPH_PATH = path.join(DATA_DIR, 'graph-state.json');
|
|
23
|
-
const RANKED_PATH = path.join(DATA_DIR, 'ranked-context.json');
|
|
24
|
-
const PENDING_PATH = path.join(DATA_DIR, 'pending-insights.jsonl');
|
|
25
|
-
const SESSION_DIR = path.join(process.cwd(), '.claude-flow', 'sessions');
|
|
26
|
-
const SESSION_FILE = path.join(SESSION_DIR, 'current.json');
|
|
27
|
-
|
|
28
|
-
// ── Safety limits (fixes #1530, #1531) ─────────────────────────────────────
|
|
29
|
-
const MAX_DATA_FILE_SIZE = 10 * 1024 * 1024; // 10 MB — skip files larger than this
|
|
30
|
-
const MAX_GRAPH_NODES = 5000; // skip PageRank if graph exceeds this
|
|
31
|
-
|
|
32
|
-
// ── Stop words for trigram matching ──────────────────────────────────────────
|
|
33
|
-
|
|
34
|
-
const STOP_WORDS = new Set([
|
|
35
|
-
'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
|
|
36
|
-
'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
|
|
37
|
-
'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
|
|
38
|
-
'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
|
|
39
|
-
'before', 'after', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet',
|
|
40
|
-
'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few',
|
|
41
|
-
'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same',
|
|
42
|
-
'than', 'too', 'very', 'just', 'because', 'if', 'when', 'which',
|
|
43
|
-
'who', 'whom', 'this', 'that', 'these', 'those', 'it', 'its',
|
|
44
|
-
]);
|
|
45
|
-
|
|
46
|
-
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
47
|
-
|
|
48
|
-
function ensureDataDir() {
|
|
49
|
-
if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
function readJSON(filePath) {
|
|
53
|
-
// Safety: skip files exceeding MAX_DATA_FILE_SIZE (#1531)
|
|
54
|
-
try {
|
|
55
|
-
const stat = fs.statSync(filePath);
|
|
56
|
-
if (stat.size > MAX_DATA_FILE_SIZE) {
|
|
57
|
-
process.stderr.write("[INTELLIGENCE] WARN: Skipping " + path.basename(filePath) + " (" + Math.round(stat.size / 1048576) + "MB exceeds 10MB limit)\n");
|
|
58
|
-
return null;
|
|
59
|
-
}
|
|
60
|
-
} catch { /* file may not exist yet */ }
|
|
61
|
-
try {
|
|
62
|
-
if (fs.existsSync(filePath)) return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
|
|
63
|
-
} catch { /* corrupt file — start fresh */ }
|
|
64
|
-
return null;
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
function writeJSON(filePath, data) {
|
|
68
|
-
ensureDataDir();
|
|
69
|
-
fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
function tokenize(text) {
|
|
73
|
-
if (!text) return [];
|
|
74
|
-
return text.toLowerCase()
|
|
75
|
-
.replace(/[^a-z0-9\s-]/g, ' ')
|
|
76
|
-
.split(/\s+/)
|
|
77
|
-
.filter(w => w.length > 2 && !STOP_WORDS.has(w));
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
function trigrams(words) {
|
|
81
|
-
const t = new Set();
|
|
82
|
-
for (const w of words) {
|
|
83
|
-
for (let i = 0; i <= w.length - 3; i++) t.add(w.slice(i, i + 3));
|
|
84
|
-
}
|
|
85
|
-
return t;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
function jaccardSimilarity(setA, setB) {
|
|
89
|
-
if (setA.size === 0 && setB.size === 0) return 0;
|
|
90
|
-
let intersection = 0;
|
|
91
|
-
for (const item of setA) { if (setB.has(item)) intersection++; }
|
|
92
|
-
return intersection / (setA.size + setB.size - intersection);
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
// ── Deduplication helper (fixes #1518) ──────────────────────────────────────
|
|
96
|
-
|
|
97
|
-
function deduplicateById(entries) {
|
|
98
|
-
if (!entries || !Array.isArray(entries)) return entries;
|
|
99
|
-
const seen = new Map();
|
|
100
|
-
for (const entry of entries) {
|
|
101
|
-
const id = entry.id || entry.key;
|
|
102
|
-
if (id) {
|
|
103
|
-
seen.set(id, entry);
|
|
104
|
-
} else {
|
|
105
|
-
seen.set(`__no_id_${seen.size}`, entry);
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
return Array.from(seen.values());
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
// ADR-095 G6 — content-hash dedup. The April audit measured 5,706 entries
|
|
112
|
-
// in the auto-memory store with only ~20 unique by content; 5,686 dupes
|
|
113
|
-
// were the same MEMORY.md sections imported from sibling project dirs
|
|
114
|
-
// with different IDs. deduplicateById can't catch these (the IDs really
|
|
115
|
-
// are different); we need a content fingerprint.
|
|
116
|
-
//
|
|
117
|
-
// Fast non-cryptographic fingerprint — collisions on 64-bit FNV-1a are
|
|
118
|
-
// vanishingly rare for human prose at the scale of an auto-memory store.
|
|
119
|
-
// Whitespace-normalized so trivially-different formatting doesn't bypass dedup.
|
|
120
|
-
function fingerprintContent(text) {
|
|
121
|
-
if (typeof text !== 'string' || text.length === 0) return '0';
|
|
122
|
-
const norm = text.replace(/\s+/g, ' ').trim().toLowerCase();
|
|
123
|
-
// FNV-1a 64-bit (split into 32-bit halves to stay within Number safe int)
|
|
124
|
-
let h1 = 0x811c9dc5, h2 = 0xcbf29ce4;
|
|
125
|
-
for (let i = 0; i < norm.length; i++) {
|
|
126
|
-
const c = norm.charCodeAt(i);
|
|
127
|
-
h1 ^= c; h1 = Math.imul(h1, 0x01000193) >>> 0;
|
|
128
|
-
h2 ^= c; h2 = Math.imul(h2, 0x100000001b3 & 0xffffffff) >>> 0;
|
|
129
|
-
}
|
|
130
|
-
return `${h1.toString(16)}_${h2.toString(16)}_${norm.length}`;
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
function deduplicateByContent(entries) {
|
|
134
|
-
if (!entries || !Array.isArray(entries)) return entries;
|
|
135
|
-
const seen = new Map();
|
|
136
|
-
for (const entry of entries) {
|
|
137
|
-
const content = entry.content || entry.summary || entry.value || '';
|
|
138
|
-
const fp = fingerprintContent(typeof content === 'string' ? content : JSON.stringify(content));
|
|
139
|
-
if (!seen.has(fp)) {
|
|
140
|
-
seen.set(fp, entry);
|
|
141
|
-
} else {
|
|
142
|
-
// Keep the entry with the higher accessCount or earlier createdAt
|
|
143
|
-
const existing = seen.get(fp);
|
|
144
|
-
const existingAccess = existing.accessCount || 0;
|
|
145
|
-
const candidateAccess = entry.accessCount || 0;
|
|
146
|
-
if (candidateAccess > existingAccess) seen.set(fp, entry);
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
return Array.from(seen.values());
|
|
150
|
-
}
|
|
151
|
-
|
|
152
|
-
// ── Session state helpers ────────────────────────────────────────────────────
|
|
153
|
-
|
|
154
|
-
function sessionGet(key) {
|
|
155
|
-
try {
|
|
156
|
-
if (!fs.existsSync(SESSION_FILE)) return null;
|
|
157
|
-
const session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
|
|
158
|
-
return key ? (session.context || {})[key] : session.context;
|
|
159
|
-
} catch { return null; }
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
function sessionSet(key, value) {
|
|
163
|
-
try {
|
|
164
|
-
if (!fs.existsSync(SESSION_DIR)) fs.mkdirSync(SESSION_DIR, { recursive: true });
|
|
165
|
-
let session = {};
|
|
166
|
-
if (fs.existsSync(SESSION_FILE)) {
|
|
167
|
-
session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
|
|
168
|
-
}
|
|
169
|
-
if (!session.context) session.context = {};
|
|
170
|
-
session.context[key] = value;
|
|
171
|
-
session.updatedAt = new Date().toISOString();
|
|
172
|
-
fs.writeFileSync(SESSION_FILE, JSON.stringify(session, null, 2), 'utf-8');
|
|
173
|
-
} catch { /* best effort */ }
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
// ── PageRank ─────────────────────────────────────────────────────────────────
|
|
177
|
-
|
|
178
|
-
function computePageRank(nodes, edges, damping, maxIter) {
|
|
179
|
-
damping = damping || 0.85;
|
|
180
|
-
maxIter = maxIter || 30;
|
|
181
|
-
|
|
182
|
-
const ids = Object.keys(nodes);
|
|
183
|
-
const n = ids.length;
|
|
184
|
-
if (n === 0) return {};
|
|
185
|
-
|
|
186
|
-
// Build adjacency: outgoing edges per node
|
|
187
|
-
const outLinks = {};
|
|
188
|
-
const inLinks = {};
|
|
189
|
-
for (const id of ids) { outLinks[id] = []; inLinks[id] = []; }
|
|
190
|
-
for (const edge of edges) {
|
|
191
|
-
if (outLinks[edge.sourceId]) outLinks[edge.sourceId].push(edge.targetId);
|
|
192
|
-
if (inLinks[edge.targetId]) inLinks[edge.targetId].push(edge.sourceId);
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// Initialize ranks
|
|
196
|
-
const ranks = {};
|
|
197
|
-
for (const id of ids) ranks[id] = 1 / n;
|
|
198
|
-
|
|
199
|
-
// Power iteration (with dangling node redistribution)
|
|
200
|
-
for (let iter = 0; iter < maxIter; iter++) {
|
|
201
|
-
const newRanks = {};
|
|
202
|
-
let diff = 0;
|
|
203
|
-
|
|
204
|
-
// Collect rank from dangling nodes (no outgoing edges)
|
|
205
|
-
let danglingSum = 0;
|
|
206
|
-
for (const id of ids) {
|
|
207
|
-
if (outLinks[id].length === 0) danglingSum += ranks[id];
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
for (const id of ids) {
|
|
211
|
-
let sum = 0;
|
|
212
|
-
for (const src of inLinks[id]) {
|
|
213
|
-
const outCount = outLinks[src].length;
|
|
214
|
-
if (outCount > 0) sum += ranks[src] / outCount;
|
|
215
|
-
}
|
|
216
|
-
// Dangling rank distributed evenly + teleport
|
|
217
|
-
newRanks[id] = (1 - damping) / n + damping * (sum + danglingSum / n);
|
|
218
|
-
diff += Math.abs(newRanks[id] - ranks[id]);
|
|
219
|
-
}
|
|
220
|
-
|
|
221
|
-
for (const id of ids) ranks[id] = newRanks[id];
|
|
222
|
-
if (diff < 1e-6) break; // converged
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
return ranks;
|
|
226
|
-
}
|
|
227
|
-
|
|
228
|
-
// ── Edge building ────────────────────────────────────────────────────────────
|
|
229
|
-
|
|
230
|
-
function buildEdges(entries) {
|
|
231
|
-
const edges = [];
|
|
232
|
-
const byCategory = {};
|
|
233
|
-
|
|
234
|
-
for (const entry of entries) {
|
|
235
|
-
const cat = entry.category || entry.namespace || 'default';
|
|
236
|
-
if (!byCategory[cat]) byCategory[cat] = [];
|
|
237
|
-
byCategory[cat].push(entry);
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
// Temporal edges: entries from same sourceFile
|
|
241
|
-
const byFile = {};
|
|
242
|
-
for (const entry of entries) {
|
|
243
|
-
const file = (entry.metadata && entry.metadata.sourceFile) || null;
|
|
244
|
-
if (file) {
|
|
245
|
-
if (!byFile[file]) byFile[file] = [];
|
|
246
|
-
byFile[file].push(entry);
|
|
247
|
-
}
|
|
248
|
-
}
|
|
249
|
-
for (const file of Object.keys(byFile)) {
|
|
250
|
-
const group = byFile[file];
|
|
251
|
-
for (let i = 0; i < group.length - 1; i++) {
|
|
252
|
-
edges.push({
|
|
253
|
-
sourceId: group[i].id,
|
|
254
|
-
targetId: group[i + 1].id,
|
|
255
|
-
type: 'temporal',
|
|
256
|
-
weight: 0.5,
|
|
257
|
-
});
|
|
258
|
-
}
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
// Similarity edges within categories (Jaccard > 0.3).
|
|
262
|
-
// ADR-095 G6 perf: hoist the trigram computation outside the inner
|
|
263
|
-
// loop. Previously we re-tokenized + re-trigrammed group[j] for every
|
|
264
|
-
// i — O(n²) extra work for nothing. Now compute once per entry.
|
|
265
|
-
for (const cat of Object.keys(byCategory)) {
|
|
266
|
-
const group = byCategory[cat];
|
|
267
|
-
if (group.length < 2) continue;
|
|
268
|
-
|
|
269
|
-
// Cache trigram sets for every entry in the group.
|
|
270
|
-
const triCache = new Array(group.length);
|
|
271
|
-
for (let i = 0; i < group.length; i++) {
|
|
272
|
-
triCache[i] = trigrams(tokenize(group[i].content || group[i].summary || ''));
|
|
273
|
-
}
|
|
274
|
-
|
|
275
|
-
for (let i = 0; i < group.length; i++) {
|
|
276
|
-
const triA = triCache[i];
|
|
277
|
-
for (let j = i + 1; j < group.length; j++) {
|
|
278
|
-
const sim = jaccardSimilarity(triA, triCache[j]);
|
|
279
|
-
if (sim > 0.3) {
|
|
280
|
-
edges.push({
|
|
281
|
-
sourceId: group[i].id,
|
|
282
|
-
targetId: group[j].id,
|
|
283
|
-
type: 'similar',
|
|
284
|
-
weight: sim,
|
|
285
|
-
});
|
|
286
|
-
}
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
}
|
|
290
|
-
|
|
291
|
-
return edges;
|
|
292
|
-
}
|
|
293
|
-
|
|
294
|
-
// ── Bootstrap from MEMORY.md files ───────────────────────────────────────────
|
|
295
|
-
|
|
296
|
-
/**
|
|
297
|
-
* If auto-memory-store.json is empty, bootstrap by parsing MEMORY.md and
|
|
298
|
-
* topic files from the auto-memory directory. This removes the dependency
|
|
299
|
-
* on @claude-flow/memory for the initial seed.
|
|
300
|
-
*/
|
|
301
|
-
function bootstrapFromMemoryFiles() {
|
|
302
|
-
const entries = [];
|
|
303
|
-
const cwd = process.cwd();
|
|
304
|
-
|
|
305
|
-
// Search for auto-memory directories
|
|
306
|
-
const candidates = [
|
|
307
|
-
// Claude Code auto-memory (project-scoped)
|
|
308
|
-
path.join(require('os').homedir(), '.claude', 'projects'),
|
|
309
|
-
// Local project memory
|
|
310
|
-
path.join(cwd, '.claude-flow', 'memory'),
|
|
311
|
-
path.join(cwd, '.claude', 'memory'),
|
|
312
|
-
];
|
|
313
|
-
|
|
314
|
-
// Find MEMORY.md in project-scoped dirs
|
|
315
|
-
for (const base of candidates) {
|
|
316
|
-
if (!fs.existsSync(base)) continue;
|
|
317
|
-
|
|
318
|
-
// For the projects dir, scope to CURRENT project only (not all 51+ dirs)
|
|
319
|
-
if (base.endsWith('projects')) {
|
|
320
|
-
try {
|
|
321
|
-
const projectSlug = cwd.replace(/^\//, '').replace(/\//g, '-');
|
|
322
|
-
const memDir = path.join(base, projectSlug, 'memory');
|
|
323
|
-
if (fs.existsSync(memDir)) {
|
|
324
|
-
parseMemoryDir(memDir, entries);
|
|
325
|
-
}
|
|
326
|
-
} catch { /* skip */ }
|
|
327
|
-
} else if (fs.existsSync(base)) {
|
|
328
|
-
parseMemoryDir(base, entries);
|
|
329
|
-
}
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
return entries;
|
|
333
|
-
}
|
|
334
|
-
|
|
335
|
-
function parseMemoryDir(dir, entries) {
|
|
336
|
-
try {
|
|
337
|
-
const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
|
|
338
|
-
for (const file of files) {
|
|
339
|
-
const filePath = path.join(dir, file);
|
|
340
|
-
const content = fs.readFileSync(filePath, 'utf-8');
|
|
341
|
-
if (!content.trim()) continue;
|
|
342
|
-
|
|
343
|
-
// Parse markdown sections as separate entries
|
|
344
|
-
const sections = content.split(/^##?\s+/m).filter(Boolean);
|
|
345
|
-
for (let sIdx = 0; sIdx < sections.length; sIdx++) {
|
|
346
|
-
const section = sections[sIdx];
|
|
347
|
-
const lines = section.trim().split('\n');
|
|
348
|
-
const title = lines[0].trim();
|
|
349
|
-
const body = lines.slice(1).join('\n').trim();
|
|
350
|
-
if (!body || body.length < 10) continue;
|
|
351
|
-
|
|
352
|
-
const id = `mem-${file.replace('.md', '')}-${title.replace(/[^a-z0-9]/gi, '-').toLowerCase().slice(0, 30)}-${sIdx}`;
|
|
353
|
-
entries.push({
|
|
354
|
-
id,
|
|
355
|
-
key: title.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50),
|
|
356
|
-
content: body.slice(0, 500),
|
|
357
|
-
summary: title,
|
|
358
|
-
namespace: file === 'MEMORY.md' ? 'core' : file.replace('.md', ''),
|
|
359
|
-
type: 'semantic',
|
|
360
|
-
metadata: { sourceFile: filePath, bootstrapped: true },
|
|
361
|
-
createdAt: Date.now(),
|
|
362
|
-
});
|
|
363
|
-
}
|
|
364
|
-
}
|
|
365
|
-
} catch { /* skip unreadable dirs */ }
|
|
366
|
-
}
|
|
367
|
-
|
|
368
|
-
// ── Exported functions ───────────────────────────────────────────────────────
|
|
369
|
-
|
|
370
|
-
/**
|
|
371
|
-
* init() — Called from session-restore. Budget: <200ms.
|
|
372
|
-
* Reads auto-memory-store.json, builds graph, computes PageRank, writes caches.
|
|
373
|
-
* If store is empty, bootstraps from MEMORY.md files directly.
|
|
374
|
-
*/
|
|
375
|
-
function init() {
|
|
376
|
-
ensureDataDir();
|
|
377
|
-
|
|
378
|
-
// Check if graph-state.json is fresh (within 60s of store)
|
|
379
|
-
const graphState = readJSON(GRAPH_PATH);
|
|
380
|
-
let store = readJSON(STORE_PATH);
|
|
381
|
-
|
|
382
|
-
// Bootstrap from MEMORY.md files if store is empty
|
|
383
|
-
if (!store || !Array.isArray(store) || store.length === 0) {
|
|
384
|
-
const bootstrapped = bootstrapFromMemoryFiles();
|
|
385
|
-
if (bootstrapped.length > 0) {
|
|
386
|
-
store = bootstrapped;
|
|
387
|
-
writeJSON(STORE_PATH, store);
|
|
388
|
-
} else {
|
|
389
|
-
return { nodes: 0, edges: 0, message: 'No memory entries to index' };
|
|
390
|
-
}
|
|
391
|
-
}
|
|
392
|
-
|
|
393
|
-
// Deduplicate store entries by ID (fixes #1518 — 194MB → ~79KB)
|
|
394
|
-
let deduped = deduplicateById(store);
|
|
395
|
-
// ADR-095 G6: also dedupe by content fingerprint. The April audit
|
|
396
|
-
// measured 5,706 entries with only ~20 unique by content because the
|
|
397
|
-
// same MEMORY.md sections get imported from sibling project dirs with
|
|
398
|
-
// different IDs. deduplicateById can't catch that; deduplicateByContent
|
|
399
|
-
// can. Cuts the graph from O(n²) over near-identical duplicates down
|
|
400
|
-
// to O(unique²), which is the difference between a 100MB graph-state
|
|
401
|
-
// and a kilobytes-scale one for typical workloads.
|
|
402
|
-
const beforeContentDedup = deduped.length;
|
|
403
|
-
deduped = deduplicateByContent(deduped);
|
|
404
|
-
if (deduped.length < store.length) {
|
|
405
|
-
process.stderr.write(
|
|
406
|
-
`[INTELLIGENCE] Deduped store: ${store.length} -> ${deduped.length} entries ` +
|
|
407
|
-
`(by-id: ${store.length - beforeContentDedup} dropped, by-content: ${beforeContentDedup - deduped.length} dropped)\n`
|
|
408
|
-
);
|
|
409
|
-
writeJSON(STORE_PATH, deduped);
|
|
410
|
-
}
|
|
411
|
-
|
|
412
|
-
// Skip rebuild if graph is fresh and store hasn't changed
|
|
413
|
-
if (graphState && graphState.nodeCount === deduped.length) {
|
|
414
|
-
const age = Date.now() - (graphState.updatedAt || 0);
|
|
415
|
-
if (age < 60000) {
|
|
416
|
-
return {
|
|
417
|
-
nodes: graphState.nodeCount || Object.keys(graphState.nodes || {}).length,
|
|
418
|
-
edges: (graphState.edges || []).length,
|
|
419
|
-
message: 'Graph cache hit',
|
|
420
|
-
};
|
|
421
|
-
}
|
|
422
|
-
}
|
|
423
|
-
|
|
424
|
-
// Build nodes from deduped entries
|
|
425
|
-
const nodes = {};
|
|
426
|
-
for (const entry of deduped) {
|
|
427
|
-
const id = entry.id || entry.key || `entry-${Math.random().toString(36).slice(2, 8)}`;
|
|
428
|
-
nodes[id] = {
|
|
429
|
-
id,
|
|
430
|
-
category: entry.namespace || entry.type || 'default',
|
|
431
|
-
confidence: (entry.metadata && entry.metadata.confidence) || 0.5,
|
|
432
|
-
accessCount: (entry.metadata && entry.metadata.accessCount) || 0,
|
|
433
|
-
createdAt: entry.createdAt || Date.now(),
|
|
434
|
-
};
|
|
435
|
-
// Ensure entry has id for edge building
|
|
436
|
-
entry.id = id;
|
|
437
|
-
}
|
|
438
|
-
|
|
439
|
-
// Build edges
|
|
440
|
-
const edges = buildEdges(deduped);
|
|
441
|
-
|
|
442
|
-
// Compute PageRank (skip if graph too large — #1531)
|
|
443
|
-
const nodeCount = Object.keys(nodes).length;
|
|
444
|
-
let pageRanks = {};
|
|
445
|
-
if (nodeCount > MAX_GRAPH_NODES) {
|
|
446
|
-
process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank\n");
|
|
447
|
-
for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
|
|
448
|
-
} else {
|
|
449
|
-
pageRanks = computePageRank(nodes, edges, 0.85, 30);
|
|
450
|
-
}
|
|
451
|
-
|
|
452
|
-
// Write graph state
|
|
453
|
-
const graph = {
|
|
454
|
-
version: 1,
|
|
455
|
-
updatedAt: Date.now(),
|
|
456
|
-
nodeCount: Object.keys(nodes).length,
|
|
457
|
-
nodes,
|
|
458
|
-
edges,
|
|
459
|
-
pageRanks,
|
|
460
|
-
};
|
|
461
|
-
writeJSON(GRAPH_PATH, graph);
|
|
462
|
-
|
|
463
|
-
// Build ranked context for fast lookup
|
|
464
|
-
const rankedEntries = deduped.map(entry => {
|
|
465
|
-
const id = entry.id;
|
|
466
|
-
const content = entry.content || entry.value || '';
|
|
467
|
-
const summary = entry.summary || entry.key || '';
|
|
468
|
-
const words = tokenize(content + ' ' + summary);
|
|
469
|
-
return {
|
|
470
|
-
id,
|
|
471
|
-
content,
|
|
472
|
-
summary,
|
|
473
|
-
category: entry.namespace || entry.type || 'default',
|
|
474
|
-
confidence: nodes[id] ? nodes[id].confidence : 0.5,
|
|
475
|
-
pageRank: pageRanks[id] || 0,
|
|
476
|
-
accessCount: nodes[id] ? nodes[id].accessCount : 0,
|
|
477
|
-
words,
|
|
478
|
-
};
|
|
479
|
-
}).sort((a, b) => {
|
|
480
|
-
const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
|
|
481
|
-
const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
|
|
482
|
-
return scoreB - scoreA;
|
|
483
|
-
});
|
|
484
|
-
|
|
485
|
-
const ranked = {
|
|
486
|
-
version: 1,
|
|
487
|
-
computedAt: Date.now(),
|
|
488
|
-
entries: rankedEntries,
|
|
489
|
-
};
|
|
490
|
-
writeJSON(RANKED_PATH, ranked);
|
|
491
|
-
|
|
492
|
-
return {
|
|
493
|
-
nodes: Object.keys(nodes).length,
|
|
494
|
-
edges: edges.length,
|
|
495
|
-
message: 'Graph built and ranked',
|
|
496
|
-
};
|
|
497
|
-
}
|
|
498
|
-
|
|
499
|
-
/**
|
|
500
|
-
* getContext(prompt) — Called from route. Budget: <15ms.
|
|
501
|
-
* Matches prompt to ranked entries, returns top-5 formatted context.
|
|
502
|
-
*/
|
|
503
|
-
function getContext(prompt) {
|
|
504
|
-
if (!prompt) return null;
|
|
505
|
-
|
|
506
|
-
const ranked = readJSON(RANKED_PATH);
|
|
507
|
-
if (!ranked || !ranked.entries || ranked.entries.length === 0) return null;
|
|
508
|
-
|
|
509
|
-
const promptWords = tokenize(prompt);
|
|
510
|
-
if (promptWords.length === 0) return null;
|
|
511
|
-
const promptTrigrams = trigrams(promptWords);
|
|
512
|
-
|
|
513
|
-
const ALPHA = 0.6; // content match weight
|
|
514
|
-
const MIN_THRESHOLD = 0.05;
|
|
515
|
-
const TOP_K = 5;
|
|
516
|
-
|
|
517
|
-
// Score each entry
|
|
518
|
-
const scored = [];
|
|
519
|
-
for (const entry of ranked.entries) {
|
|
520
|
-
const entryTrigrams = trigrams(entry.words || []);
|
|
521
|
-
const contentMatch = jaccardSimilarity(promptTrigrams, entryTrigrams);
|
|
522
|
-
const score = ALPHA * contentMatch + (1 - ALPHA) * (entry.pageRank || 0);
|
|
523
|
-
if (score >= MIN_THRESHOLD) {
|
|
524
|
-
scored.push({ ...entry, score });
|
|
525
|
-
}
|
|
526
|
-
}
|
|
527
|
-
|
|
528
|
-
if (scored.length === 0) return null;
|
|
529
|
-
|
|
530
|
-
// Sort by score descending, take top-K
|
|
531
|
-
scored.sort((a, b) => b.score - a.score);
|
|
532
|
-
const topEntries = scored.slice(0, TOP_K);
|
|
533
|
-
|
|
534
|
-
// Boost previously matched patterns (implicit success: user continued working)
|
|
535
|
-
const prevMatched = sessionGet('lastMatchedPatterns');
|
|
536
|
-
|
|
537
|
-
// Store NEW matched IDs in session state for feedback
|
|
538
|
-
const matchedIds = topEntries.map(e => e.id);
|
|
539
|
-
sessionSet('lastMatchedPatterns', matchedIds);
|
|
540
|
-
|
|
541
|
-
// Only boost previous if they differ from current (avoid double-boosting)
|
|
542
|
-
if (prevMatched && Array.isArray(prevMatched)) {
|
|
543
|
-
const newSet = new Set(matchedIds);
|
|
544
|
-
const toBoost = prevMatched.filter(id => !newSet.has(id));
|
|
545
|
-
if (toBoost.length > 0) boostConfidence(toBoost, 0.03);
|
|
546
|
-
}
|
|
547
|
-
|
|
548
|
-
// Format output
|
|
549
|
-
const lines = ['[INTELLIGENCE] Relevant patterns for this task:'];
|
|
550
|
-
for (let i = 0; i < topEntries.length; i++) {
|
|
551
|
-
const e = topEntries[i];
|
|
552
|
-
const display = (e.summary || e.content || '').slice(0, 80);
|
|
553
|
-
const accessed = e.accessCount || 0;
|
|
554
|
-
lines.push(` * (${e.score.toFixed(2)}) ${display} [rank #${i + 1}, ${accessed}x accessed]`);
|
|
555
|
-
}
|
|
556
|
-
|
|
557
|
-
return lines.join('\n');
|
|
558
|
-
}
|
|
559
|
-
|
|
560
|
-
/**
|
|
561
|
-
* recordEdit(file) — Called from post-edit. Budget: <2ms.
|
|
562
|
-
* Appends to pending-insights.jsonl.
|
|
563
|
-
*/
|
|
564
|
-
function recordEdit(file) {
|
|
565
|
-
ensureDataDir();
|
|
566
|
-
const entry = JSON.stringify({
|
|
567
|
-
type: 'edit',
|
|
568
|
-
file: file || 'unknown',
|
|
569
|
-
timestamp: Date.now(),
|
|
570
|
-
sessionId: sessionGet('sessionId') || null,
|
|
571
|
-
});
|
|
572
|
-
fs.appendFileSync(PENDING_PATH, entry + '\n', 'utf-8');
|
|
573
|
-
}
|
|
574
|
-
|
|
575
|
-
/**
|
|
576
|
-
* feedback(success) — Called from post-task. Budget: <10ms.
|
|
577
|
-
* Boosts or decays confidence for last-matched patterns.
|
|
578
|
-
*/
|
|
579
|
-
function feedback(success) {
|
|
580
|
-
const matchedIds = sessionGet('lastMatchedPatterns');
|
|
581
|
-
if (!matchedIds || !Array.isArray(matchedIds)) return;
|
|
582
|
-
|
|
583
|
-
const amount = success ? 0.05 : -0.02;
|
|
584
|
-
boostConfidence(matchedIds, amount);
|
|
585
|
-
}
|
|
586
|
-
|
|
587
|
-
function boostConfidence(ids, amount) {
|
|
588
|
-
const ranked = readJSON(RANKED_PATH);
|
|
589
|
-
if (!ranked || !ranked.entries) return;
|
|
590
|
-
|
|
591
|
-
let changed = false;
|
|
592
|
-
for (const entry of ranked.entries) {
|
|
593
|
-
if (ids.includes(entry.id)) {
|
|
594
|
-
entry.confidence = Math.max(0, Math.min(1, (entry.confidence || 0.5) + amount));
|
|
595
|
-
entry.accessCount = (entry.accessCount || 0) + 1;
|
|
596
|
-
changed = true;
|
|
597
|
-
}
|
|
598
|
-
}
|
|
599
|
-
|
|
600
|
-
if (changed) writeJSON(RANKED_PATH, ranked);
|
|
601
|
-
|
|
602
|
-
// Also update graph-state confidence
|
|
603
|
-
const graph = readJSON(GRAPH_PATH);
|
|
604
|
-
if (graph && graph.nodes) {
|
|
605
|
-
for (const id of ids) {
|
|
606
|
-
if (graph.nodes[id]) {
|
|
607
|
-
graph.nodes[id].confidence = Math.max(0, Math.min(1, (graph.nodes[id].confidence || 0.5) + amount));
|
|
608
|
-
graph.nodes[id].accessCount = (graph.nodes[id].accessCount || 0) + 1;
|
|
609
|
-
}
|
|
610
|
-
}
|
|
611
|
-
writeJSON(GRAPH_PATH, graph);
|
|
612
|
-
}
|
|
613
|
-
}
|
|
614
|
-
|
|
615
|
-
/**
|
|
616
|
-
* consolidate() — Called from session-end. Budget: <500ms.
|
|
617
|
-
* Processes pending insights, rebuilds edges, recomputes PageRank.
|
|
618
|
-
*/
|
|
619
|
-
function consolidate() {
|
|
620
|
-
ensureDataDir();
|
|
621
|
-
|
|
622
|
-
let store = readJSON(STORE_PATH);
|
|
623
|
-
if (!store || !Array.isArray(store)) {
|
|
624
|
-
return { entries: 0, edges: 0, newEntries: 0, message: 'No store to consolidate' };
|
|
625
|
-
}
|
|
626
|
-
|
|
627
|
-
// Deduplicate store entries by ID before processing (fixes #1518)
|
|
628
|
-
const preDedupCount = store.length;
|
|
629
|
-
store = deduplicateById(store);
|
|
630
|
-
|
|
631
|
-
// 1. Process pending insights
|
|
632
|
-
let newEntries = 0;
|
|
633
|
-
if (fs.existsSync(PENDING_PATH)) {
|
|
634
|
-
const lines = fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean);
|
|
635
|
-
const editCounts = {};
|
|
636
|
-
for (const line of lines) {
|
|
637
|
-
try {
|
|
638
|
-
const insight = JSON.parse(line);
|
|
639
|
-
if (insight.file) {
|
|
640
|
-
editCounts[insight.file] = (editCounts[insight.file] || 0) + 1;
|
|
641
|
-
}
|
|
642
|
-
} catch { /* skip malformed */ }
|
|
643
|
-
}
|
|
644
|
-
|
|
645
|
-
// Create entries for frequently-edited files (3+ edits)
|
|
646
|
-
for (const [file, count] of Object.entries(editCounts)) {
|
|
647
|
-
if (count >= 3) {
|
|
648
|
-
const exists = store.some(e =>
|
|
649
|
-
(e.metadata && e.metadata.sourceFile === file && e.metadata.autoGenerated)
|
|
650
|
-
);
|
|
651
|
-
if (!exists) {
|
|
652
|
-
store.push({
|
|
653
|
-
id: `insight-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
|
|
654
|
-
key: `frequent-edit-${path.basename(file)}`,
|
|
655
|
-
content: `File ${file} was edited ${count} times this session — likely a hot path worth monitoring.`,
|
|
656
|
-
summary: `Frequently edited: ${path.basename(file)} (${count}x)`,
|
|
657
|
-
namespace: 'insights',
|
|
658
|
-
type: 'procedural',
|
|
659
|
-
metadata: { sourceFile: file, editCount: count, autoGenerated: true },
|
|
660
|
-
createdAt: Date.now(),
|
|
661
|
-
});
|
|
662
|
-
newEntries++;
|
|
663
|
-
}
|
|
664
|
-
}
|
|
665
|
-
}
|
|
666
|
-
|
|
667
|
-
// Clear pending
|
|
668
|
-
fs.writeFileSync(PENDING_PATH, '', 'utf-8');
|
|
669
|
-
}
|
|
670
|
-
|
|
671
|
-
// 2. Confidence decay for unaccessed entries
|
|
672
|
-
const graph = readJSON(GRAPH_PATH);
|
|
673
|
-
if (graph && graph.nodes) {
|
|
674
|
-
const now = Date.now();
|
|
675
|
-
for (const id of Object.keys(graph.nodes)) {
|
|
676
|
-
const node = graph.nodes[id];
|
|
677
|
-
const hoursSinceCreation = (now - (node.createdAt || now)) / (1000 * 60 * 60);
|
|
678
|
-
if (node.accessCount === 0 && hoursSinceCreation > 24) {
|
|
679
|
-
node.confidence = Math.max(0.05, (node.confidence || 0.5) - 0.005 * Math.floor(hoursSinceCreation / 24));
|
|
680
|
-
}
|
|
681
|
-
}
|
|
682
|
-
}
|
|
683
|
-
|
|
684
|
-
// 3. Rebuild edges with updated store
|
|
685
|
-
for (const entry of store) {
|
|
686
|
-
if (!entry.id) entry.id = `entry-${Math.random().toString(36).slice(2, 8)}`;
|
|
687
|
-
}
|
|
688
|
-
const edges = buildEdges(store);
|
|
689
|
-
|
|
690
|
-
// 4. Build updated nodes
|
|
691
|
-
const nodes = {};
|
|
692
|
-
for (const entry of store) {
|
|
693
|
-
nodes[entry.id] = {
|
|
694
|
-
id: entry.id,
|
|
695
|
-
category: entry.namespace || entry.type || 'default',
|
|
696
|
-
confidence: (graph && graph.nodes && graph.nodes[entry.id])
|
|
697
|
-
? graph.nodes[entry.id].confidence
|
|
698
|
-
: (entry.metadata && entry.metadata.confidence) || 0.5,
|
|
699
|
-
accessCount: (graph && graph.nodes && graph.nodes[entry.id])
|
|
700
|
-
? graph.nodes[entry.id].accessCount
|
|
701
|
-
: (entry.metadata && entry.metadata.accessCount) || 0,
|
|
702
|
-
createdAt: entry.createdAt || Date.now(),
|
|
703
|
-
};
|
|
704
|
-
}
|
|
705
|
-
|
|
706
|
-
// 5. Recompute PageRank (skip if graph too large — #1531)
|
|
707
|
-
const nodeCount = Object.keys(nodes).length;
|
|
708
|
-
let pageRanks = {};
|
|
709
|
-
if (nodeCount > MAX_GRAPH_NODES) {
|
|
710
|
-
process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank in consolidate\n");
|
|
711
|
-
for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
|
|
712
|
-
} else {
|
|
713
|
-
pageRanks = computePageRank(nodes, edges, 0.85, 30);
|
|
714
|
-
}
|
|
715
|
-
|
|
716
|
-
// 6. Write updated graph
|
|
717
|
-
writeJSON(GRAPH_PATH, {
|
|
718
|
-
version: 1,
|
|
719
|
-
updatedAt: Date.now(),
|
|
720
|
-
nodeCount: Object.keys(nodes).length,
|
|
721
|
-
nodes,
|
|
722
|
-
edges,
|
|
723
|
-
pageRanks,
|
|
724
|
-
});
|
|
725
|
-
|
|
726
|
-
// 7. Write updated ranked context
|
|
727
|
-
const rankedEntries = store.map(entry => {
|
|
728
|
-
const id = entry.id;
|
|
729
|
-
const content = entry.content || entry.value || '';
|
|
730
|
-
const summary = entry.summary || entry.key || '';
|
|
731
|
-
const words = tokenize(content + ' ' + summary);
|
|
732
|
-
return {
|
|
733
|
-
id,
|
|
734
|
-
content,
|
|
735
|
-
summary,
|
|
736
|
-
category: entry.namespace || entry.type || 'default',
|
|
737
|
-
confidence: nodes[id] ? nodes[id].confidence : 0.5,
|
|
738
|
-
pageRank: pageRanks[id] || 0,
|
|
739
|
-
accessCount: nodes[id] ? nodes[id].accessCount : 0,
|
|
740
|
-
words,
|
|
741
|
-
};
|
|
742
|
-
}).sort((a, b) => {
|
|
743
|
-
const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
|
|
744
|
-
const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
|
|
745
|
-
return scoreB - scoreA;
|
|
746
|
-
});
|
|
747
|
-
|
|
748
|
-
writeJSON(RANKED_PATH, {
|
|
749
|
-
version: 1,
|
|
750
|
-
computedAt: Date.now(),
|
|
751
|
-
entries: rankedEntries,
|
|
752
|
-
});
|
|
753
|
-
|
|
754
|
-
// 8. Persist updated store (deduped or with new insight entries)
|
|
755
|
-
if (newEntries > 0 || store.length < preDedupCount) writeJSON(STORE_PATH, store);
|
|
756
|
-
|
|
757
|
-
// 9. Save snapshot for delta tracking
|
|
758
|
-
const updatedGraph = readJSON(GRAPH_PATH);
|
|
759
|
-
const updatedRanked = readJSON(RANKED_PATH);
|
|
760
|
-
saveSnapshot(updatedGraph, updatedRanked);
|
|
761
|
-
|
|
762
|
-
return {
|
|
763
|
-
entries: store.length,
|
|
764
|
-
edges: edges.length,
|
|
765
|
-
newEntries,
|
|
766
|
-
message: 'Consolidated',
|
|
767
|
-
};
|
|
768
|
-
}
|
|
769
|
-
|
|
770
|
-
// ── Snapshot for delta tracking ─────────────────────────────────────────────
|
|
771
|
-
|
|
772
|
-
const SNAPSHOT_PATH = path.join(DATA_DIR, 'intelligence-snapshot.json');
|
|
773
|
-
|
|
774
|
-
function saveSnapshot(graph, ranked) {
|
|
775
|
-
const snap = {
|
|
776
|
-
timestamp: Date.now(),
|
|
777
|
-
nodes: graph ? Object.keys(graph.nodes || {}).length : 0,
|
|
778
|
-
edges: graph ? (graph.edges || []).length : 0,
|
|
779
|
-
pageRankSum: 0,
|
|
780
|
-
confidences: [],
|
|
781
|
-
accessCounts: [],
|
|
782
|
-
topPatterns: [],
|
|
783
|
-
};
|
|
784
|
-
|
|
785
|
-
if (graph && graph.pageRanks) {
|
|
786
|
-
for (const v of Object.values(graph.pageRanks)) snap.pageRankSum += v;
|
|
787
|
-
}
|
|
788
|
-
if (graph && graph.nodes) {
|
|
789
|
-
for (const n of Object.values(graph.nodes)) {
|
|
790
|
-
snap.confidences.push(n.confidence || 0.5);
|
|
791
|
-
snap.accessCounts.push(n.accessCount || 0);
|
|
792
|
-
}
|
|
793
|
-
}
|
|
794
|
-
if (ranked && ranked.entries) {
|
|
795
|
-
snap.topPatterns = ranked.entries.slice(0, 10).map(e => ({
|
|
796
|
-
id: e.id,
|
|
797
|
-
summary: (e.summary || '').slice(0, 60),
|
|
798
|
-
confidence: e.confidence || 0.5,
|
|
799
|
-
pageRank: e.pageRank || 0,
|
|
800
|
-
accessCount: e.accessCount || 0,
|
|
801
|
-
}));
|
|
802
|
-
}
|
|
803
|
-
|
|
804
|
-
// Keep history: append to array, cap at 50
|
|
805
|
-
let history = readJSON(SNAPSHOT_PATH);
|
|
806
|
-
if (!Array.isArray(history)) history = [];
|
|
807
|
-
history.push(snap);
|
|
808
|
-
if (history.length > 50) history = history.slice(-50);
|
|
809
|
-
writeJSON(SNAPSHOT_PATH, history);
|
|
810
|
-
}
|
|
811
|
-
|
|
812
|
-
/**
|
|
813
|
-
* stats() — Diagnostic report showing intelligence health and improvement.
|
|
814
|
-
* Can be called as: node intelligence.cjs stats [--json]
|
|
815
|
-
*/
|
|
816
|
-
function stats(outputJson) {
|
|
817
|
-
const graph = readJSON(GRAPH_PATH);
|
|
818
|
-
const ranked = readJSON(RANKED_PATH);
|
|
819
|
-
const history = readJSON(SNAPSHOT_PATH) || [];
|
|
820
|
-
const pending = fs.existsSync(PENDING_PATH)
|
|
821
|
-
? fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean).length
|
|
822
|
-
: 0;
|
|
823
|
-
|
|
824
|
-
// Current state
|
|
825
|
-
const nodes = graph ? Object.keys(graph.nodes || {}).length : 0;
|
|
826
|
-
const edges = graph ? (graph.edges || []).length : 0;
|
|
827
|
-
const density = nodes > 1 ? (2 * edges) / (nodes * (nodes - 1)) : 0;
|
|
828
|
-
|
|
829
|
-
// Confidence distribution
|
|
830
|
-
const confidences = [];
|
|
831
|
-
const accessCounts = [];
|
|
832
|
-
if (graph && graph.nodes) {
|
|
833
|
-
for (const n of Object.values(graph.nodes)) {
|
|
834
|
-
confidences.push(n.confidence || 0.5);
|
|
835
|
-
accessCounts.push(n.accessCount || 0);
|
|
836
|
-
}
|
|
837
|
-
}
|
|
838
|
-
confidences.sort((a, b) => a - b);
|
|
839
|
-
const confMin = confidences.length ? confidences[0] : 0;
|
|
840
|
-
const confMax = confidences.length ? confidences[confidences.length - 1] : 0;
|
|
841
|
-
const confMean = confidences.length ? confidences.reduce((s, c) => s + c, 0) / confidences.length : 0;
|
|
842
|
-
const confMedian = confidences.length ? confidences[Math.floor(confidences.length / 2)] : 0;
|
|
843
|
-
|
|
844
|
-
// Access stats
|
|
845
|
-
const totalAccess = accessCounts.reduce((s, c) => s + c, 0);
|
|
846
|
-
const accessedCount = accessCounts.filter(c => c > 0).length;
|
|
847
|
-
|
|
848
|
-
// PageRank stats
|
|
849
|
-
let prSum = 0, prMax = 0, prMaxId = '';
|
|
850
|
-
if (graph && graph.pageRanks) {
|
|
851
|
-
for (const [id, pr] of Object.entries(graph.pageRanks)) {
|
|
852
|
-
prSum += pr;
|
|
853
|
-
if (pr > prMax) { prMax = pr; prMaxId = id; }
|
|
854
|
-
}
|
|
855
|
-
}
|
|
856
|
-
|
|
857
|
-
// Top patterns by composite score
|
|
858
|
-
const topPatterns = (ranked && ranked.entries || []).slice(0, 10).map((e, i) => ({
|
|
859
|
-
rank: i + 1,
|
|
860
|
-
summary: (e.summary || '').slice(0, 60),
|
|
861
|
-
confidence: (e.confidence || 0.5).toFixed(3),
|
|
862
|
-
pageRank: (e.pageRank || 0).toFixed(4),
|
|
863
|
-
accessed: e.accessCount || 0,
|
|
864
|
-
score: (0.6 * (e.pageRank || 0) + 0.4 * (e.confidence || 0.5)).toFixed(4),
|
|
865
|
-
}));
|
|
866
|
-
|
|
867
|
-
// Edge type breakdown
|
|
868
|
-
const edgeTypes = {};
|
|
869
|
-
if (graph && graph.edges) {
|
|
870
|
-
for (const e of graph.edges) {
|
|
871
|
-
edgeTypes[e.type || 'unknown'] = (edgeTypes[e.type || 'unknown'] || 0) + 1;
|
|
872
|
-
}
|
|
873
|
-
}
|
|
874
|
-
|
|
875
|
-
// Delta from previous snapshot
|
|
876
|
-
let delta = null;
|
|
877
|
-
if (history.length >= 2) {
|
|
878
|
-
const prev = history[history.length - 2];
|
|
879
|
-
const curr = history[history.length - 1];
|
|
880
|
-
const elapsed = (curr.timestamp - prev.timestamp) / 1000;
|
|
881
|
-
const prevConfMean = prev.confidences.length
|
|
882
|
-
? prev.confidences.reduce((s, c) => s + c, 0) / prev.confidences.length : 0;
|
|
883
|
-
const currConfMean = curr.confidences.length
|
|
884
|
-
? curr.confidences.reduce((s, c) => s + c, 0) / curr.confidences.length : 0;
|
|
885
|
-
const prevAccess = prev.accessCounts.reduce((s, c) => s + c, 0);
|
|
886
|
-
const currAccess = curr.accessCounts.reduce((s, c) => s + c, 0);
|
|
887
|
-
|
|
888
|
-
delta = {
|
|
889
|
-
elapsed: elapsed < 3600 ? `${Math.round(elapsed / 60)}m` : `${(elapsed / 3600).toFixed(1)}h`,
|
|
890
|
-
nodes: curr.nodes - prev.nodes,
|
|
891
|
-
edges: curr.edges - prev.edges,
|
|
892
|
-
confidenceMean: currConfMean - prevConfMean,
|
|
893
|
-
totalAccess: currAccess - prevAccess,
|
|
894
|
-
};
|
|
895
|
-
}
|
|
896
|
-
|
|
897
|
-
// Trend over all history
|
|
898
|
-
let trend = null;
|
|
899
|
-
if (history.length >= 3) {
|
|
900
|
-
const first = history[0];
|
|
901
|
-
const last = history[history.length - 1];
|
|
902
|
-
const sessions = history.length;
|
|
903
|
-
const firstConfMean = first.confidences.length
|
|
904
|
-
? first.confidences.reduce((s, c) => s + c, 0) / first.confidences.length : 0;
|
|
905
|
-
const lastConfMean = last.confidences.length
|
|
906
|
-
? last.confidences.reduce((s, c) => s + c, 0) / last.confidences.length : 0;
|
|
907
|
-
trend = {
|
|
908
|
-
sessions,
|
|
909
|
-
nodeGrowth: last.nodes - first.nodes,
|
|
910
|
-
edgeGrowth: last.edges - first.edges,
|
|
911
|
-
confidenceDrift: lastConfMean - firstConfMean,
|
|
912
|
-
direction: lastConfMean > firstConfMean ? 'improving' :
|
|
913
|
-
lastConfMean < firstConfMean ? 'declining' : 'stable',
|
|
914
|
-
};
|
|
915
|
-
}
|
|
916
|
-
|
|
917
|
-
const report = {
|
|
918
|
-
graph: { nodes, edges, density: +density.toFixed(4) },
|
|
919
|
-
confidence: {
|
|
920
|
-
min: +confMin.toFixed(3), max: +confMax.toFixed(3),
|
|
921
|
-
mean: +confMean.toFixed(3), median: +confMedian.toFixed(3),
|
|
922
|
-
},
|
|
923
|
-
access: { total: totalAccess, patternsAccessed: accessedCount, patternsNeverAccessed: nodes - accessedCount },
|
|
924
|
-
pageRank: { sum: +prSum.toFixed(4), topNode: prMaxId, topNodeRank: +prMax.toFixed(4) },
|
|
925
|
-
edgeTypes,
|
|
926
|
-
pendingInsights: pending,
|
|
927
|
-
snapshots: history.length,
|
|
928
|
-
topPatterns,
|
|
929
|
-
delta,
|
|
930
|
-
trend,
|
|
931
|
-
};
|
|
932
|
-
|
|
933
|
-
if (outputJson) {
|
|
934
|
-
console.log(JSON.stringify(report, null, 2));
|
|
935
|
-
return report;
|
|
936
|
-
}
|
|
937
|
-
|
|
938
|
-
// Human-readable output
|
|
939
|
-
const bar = '+' + '-'.repeat(62) + '+';
|
|
940
|
-
console.log(bar);
|
|
941
|
-
console.log('|' + ' Intelligence Diagnostics (ADR-050)'.padEnd(62) + '|');
|
|
942
|
-
console.log(bar);
|
|
943
|
-
console.log('');
|
|
944
|
-
|
|
945
|
-
console.log(' Graph');
|
|
946
|
-
console.log(` Nodes: ${nodes}`);
|
|
947
|
-
console.log(` Edges: ${edges} (${Object.entries(edgeTypes).map(([t,c]) => `${c} ${t}`).join(', ') || 'none'})`);
|
|
948
|
-
console.log(` Density: ${(density * 100).toFixed(1)}%`);
|
|
949
|
-
console.log('');
|
|
950
|
-
|
|
951
|
-
console.log(' Confidence');
|
|
952
|
-
console.log(` Min: ${confMin.toFixed(3)}`);
|
|
953
|
-
console.log(` Max: ${confMax.toFixed(3)}`);
|
|
954
|
-
console.log(` Mean: ${confMean.toFixed(3)}`);
|
|
955
|
-
console.log(` Median: ${confMedian.toFixed(3)}`);
|
|
956
|
-
console.log('');
|
|
957
|
-
|
|
958
|
-
console.log(' Access');
|
|
959
|
-
console.log(` Total accesses: ${totalAccess}`);
|
|
960
|
-
console.log(` Patterns used: ${accessedCount}/${nodes}`);
|
|
961
|
-
console.log(` Never accessed: ${nodes - accessedCount}`);
|
|
962
|
-
console.log(` Pending insights: ${pending}`);
|
|
963
|
-
console.log('');
|
|
964
|
-
|
|
965
|
-
console.log(' PageRank');
|
|
966
|
-
console.log(` Sum: ${prSum.toFixed(4)} (should be ~1.0)`);
|
|
967
|
-
console.log(` Top node: ${prMaxId || '(none)'} (${prMax.toFixed(4)})`);
|
|
968
|
-
console.log('');
|
|
969
|
-
|
|
970
|
-
if (topPatterns.length > 0) {
|
|
971
|
-
console.log(' Top Patterns (by composite score)');
|
|
972
|
-
console.log(' ' + '-'.repeat(60));
|
|
973
|
-
for (const p of topPatterns) {
|
|
974
|
-
console.log(` #${p.rank} ${p.summary}`);
|
|
975
|
-
console.log(` conf=${p.confidence} pr=${p.pageRank} score=${p.score} accessed=${p.accessed}x`);
|
|
976
|
-
}
|
|
977
|
-
console.log('');
|
|
978
|
-
}
|
|
979
|
-
|
|
980
|
-
if (delta) {
|
|
981
|
-
console.log(` Last Delta (${delta.elapsed} ago)`);
|
|
982
|
-
const sign = v => v > 0 ? `+${v}` : `${v}`;
|
|
983
|
-
console.log(` Nodes: ${sign(delta.nodes)}`);
|
|
984
|
-
console.log(` Edges: ${sign(delta.edges)}`);
|
|
985
|
-
console.log(` Confidence: ${delta.confidenceMean >= 0 ? '+' : ''}${delta.confidenceMean.toFixed(4)}`);
|
|
986
|
-
console.log(` Accesses: ${sign(delta.totalAccess)}`);
|
|
987
|
-
console.log('');
|
|
988
|
-
}
|
|
989
|
-
|
|
990
|
-
if (trend) {
|
|
991
|
-
console.log(` Trend (${trend.sessions} snapshots)`);
|
|
992
|
-
console.log(` Node growth: ${trend.nodeGrowth >= 0 ? '+' : ''}${trend.nodeGrowth}`);
|
|
993
|
-
console.log(` Edge growth: ${trend.edgeGrowth >= 0 ? '+' : ''}${trend.edgeGrowth}`);
|
|
994
|
-
console.log(` Confidence drift: ${trend.confidenceDrift >= 0 ? '+' : ''}${trend.confidenceDrift.toFixed(4)}`);
|
|
995
|
-
console.log(` Direction: ${trend.direction.toUpperCase()}`);
|
|
996
|
-
console.log('');
|
|
997
|
-
}
|
|
998
|
-
|
|
999
|
-
if (!delta && !trend) {
|
|
1000
|
-
console.log(' No history yet — run more sessions to see deltas and trends.');
|
|
1001
|
-
console.log('');
|
|
1002
|
-
}
|
|
1003
|
-
|
|
1004
|
-
console.log(bar);
|
|
1005
|
-
return report;
|
|
1006
|
-
}
|
|
1007
|
-
|
|
1008
|
-
module.exports = { init, getContext, recordEdit, feedback, consolidate, stats };
|
|
1009
|
-
|
|
1010
|
-
// ── CLI entrypoint ──────────────────────────────────────────────────────────
|
|
1011
|
-
if (require.main === module) {
|
|
1012
|
-
const cmd = process.argv[2];
|
|
1013
|
-
const jsonFlag = process.argv.includes('--json');
|
|
1014
|
-
|
|
1015
|
-
const cmds = {
|
|
1016
|
-
init: () => { const r = init(); console.log(JSON.stringify(r)); },
|
|
1017
|
-
stats: () => { stats(jsonFlag); },
|
|
1018
|
-
consolidate: () => { const r = consolidate(); console.log(JSON.stringify(r)); },
|
|
1019
|
-
};
|
|
1020
|
-
|
|
1021
|
-
if (cmd && cmds[cmd]) {
|
|
1022
|
-
cmds[cmd]();
|
|
1023
|
-
} else {
|
|
1024
|
-
console.log('Usage: intelligence.cjs <stats|init|consolidate> [--json]');
|
|
1025
|
-
console.log('');
|
|
1026
|
-
console.log(' stats Show intelligence diagnostics and trends');
|
|
1027
|
-
console.log(' stats --json Output as JSON for programmatic use');
|
|
1028
|
-
console.log(' init Build graph and rank entries');
|
|
1029
|
-
console.log(' consolidate Process pending insights and recompute');
|
|
1030
|
-
}
|
|
1031
|
-
}
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Intelligence Layer (ADR-050)
|
|
4
|
+
*
|
|
5
|
+
* Closes the intelligence loop by wiring PageRank-ranked memory into
|
|
6
|
+
* the hook system. Pure CJS — no ESM imports of @claude-flow/memory.
|
|
7
|
+
*
|
|
8
|
+
* Data files (all under .claude-flow/data/):
|
|
9
|
+
* auto-memory-store.json — written by auto-memory-hook.mjs
|
|
10
|
+
* graph-state.json — serialized graph (nodes + edges + pageRanks)
|
|
11
|
+
* ranked-context.json — pre-computed ranked entries for fast lookup
|
|
12
|
+
* pending-insights.jsonl — append-only edit/task log
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
'use strict';
|
|
16
|
+
|
|
17
|
+
const fs = require('fs');
|
|
18
|
+
const path = require('path');
|
|
19
|
+
|
|
20
|
+
const DATA_DIR = path.join(process.cwd(), '.claude-flow', 'data');
|
|
21
|
+
const STORE_PATH = path.join(DATA_DIR, 'auto-memory-store.json');
|
|
22
|
+
const GRAPH_PATH = path.join(DATA_DIR, 'graph-state.json');
|
|
23
|
+
const RANKED_PATH = path.join(DATA_DIR, 'ranked-context.json');
|
|
24
|
+
const PENDING_PATH = path.join(DATA_DIR, 'pending-insights.jsonl');
|
|
25
|
+
const SESSION_DIR = path.join(process.cwd(), '.claude-flow', 'sessions');
|
|
26
|
+
const SESSION_FILE = path.join(SESSION_DIR, 'current.json');
|
|
27
|
+
|
|
28
|
+
// ── Safety limits (fixes #1530, #1531) ─────────────────────────────────────
|
|
29
|
+
const MAX_DATA_FILE_SIZE = 10 * 1024 * 1024; // 10 MB — skip files larger than this
|
|
30
|
+
const MAX_GRAPH_NODES = 5000; // skip PageRank if graph exceeds this
|
|
31
|
+
|
|
32
|
+
// ── Stop words for trigram matching ──────────────────────────────────────────
|
|
33
|
+
|
|
34
|
+
const STOP_WORDS = new Set([
|
|
35
|
+
'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
|
|
36
|
+
'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
|
|
37
|
+
'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
|
|
38
|
+
'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
|
|
39
|
+
'before', 'after', 'and', 'but', 'or', 'nor', 'not', 'so', 'yet',
|
|
40
|
+
'both', 'either', 'neither', 'each', 'every', 'all', 'any', 'few',
|
|
41
|
+
'more', 'most', 'other', 'some', 'such', 'no', 'only', 'own', 'same',
|
|
42
|
+
'than', 'too', 'very', 'just', 'because', 'if', 'when', 'which',
|
|
43
|
+
'who', 'whom', 'this', 'that', 'these', 'those', 'it', 'its',
|
|
44
|
+
]);
|
|
45
|
+
|
|
46
|
+
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
47
|
+
|
|
48
|
+
function ensureDataDir() {
|
|
49
|
+
if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true });
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function readJSON(filePath) {
|
|
53
|
+
// Safety: skip files exceeding MAX_DATA_FILE_SIZE (#1531)
|
|
54
|
+
try {
|
|
55
|
+
const stat = fs.statSync(filePath);
|
|
56
|
+
if (stat.size > MAX_DATA_FILE_SIZE) {
|
|
57
|
+
process.stderr.write("[INTELLIGENCE] WARN: Skipping " + path.basename(filePath) + " (" + Math.round(stat.size / 1048576) + "MB exceeds 10MB limit)\n");
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
} catch { /* file may not exist yet */ }
|
|
61
|
+
try {
|
|
62
|
+
if (fs.existsSync(filePath)) return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
|
|
63
|
+
} catch { /* corrupt file — start fresh */ }
|
|
64
|
+
return null;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function writeJSON(filePath, data) {
|
|
68
|
+
ensureDataDir();
|
|
69
|
+
fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function tokenize(text) {
|
|
73
|
+
if (!text) return [];
|
|
74
|
+
return text.toLowerCase()
|
|
75
|
+
.replace(/[^a-z0-9\s-]/g, ' ')
|
|
76
|
+
.split(/\s+/)
|
|
77
|
+
.filter(w => w.length > 2 && !STOP_WORDS.has(w));
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function trigrams(words) {
|
|
81
|
+
const t = new Set();
|
|
82
|
+
for (const w of words) {
|
|
83
|
+
for (let i = 0; i <= w.length - 3; i++) t.add(w.slice(i, i + 3));
|
|
84
|
+
}
|
|
85
|
+
return t;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
function jaccardSimilarity(setA, setB) {
|
|
89
|
+
if (setA.size === 0 && setB.size === 0) return 0;
|
|
90
|
+
let intersection = 0;
|
|
91
|
+
for (const item of setA) { if (setB.has(item)) intersection++; }
|
|
92
|
+
return intersection / (setA.size + setB.size - intersection);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// ── Deduplication helper (fixes #1518) ──────────────────────────────────────
|
|
96
|
+
|
|
97
|
+
function deduplicateById(entries) {
|
|
98
|
+
if (!entries || !Array.isArray(entries)) return entries;
|
|
99
|
+
const seen = new Map();
|
|
100
|
+
for (const entry of entries) {
|
|
101
|
+
const id = entry.id || entry.key;
|
|
102
|
+
if (id) {
|
|
103
|
+
seen.set(id, entry);
|
|
104
|
+
} else {
|
|
105
|
+
seen.set(`__no_id_${seen.size}`, entry);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return Array.from(seen.values());
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// ADR-095 G6 — content-hash dedup. The April audit measured 5,706 entries
|
|
112
|
+
// in the auto-memory store with only ~20 unique by content; 5,686 dupes
|
|
113
|
+
// were the same MEMORY.md sections imported from sibling project dirs
|
|
114
|
+
// with different IDs. deduplicateById can't catch these (the IDs really
|
|
115
|
+
// are different); we need a content fingerprint.
|
|
116
|
+
//
|
|
117
|
+
// Fast non-cryptographic fingerprint — collisions on 64-bit FNV-1a are
|
|
118
|
+
// vanishingly rare for human prose at the scale of an auto-memory store.
|
|
119
|
+
// Whitespace-normalized so trivially-different formatting doesn't bypass dedup.
|
|
120
|
+
function fingerprintContent(text) {
|
|
121
|
+
if (typeof text !== 'string' || text.length === 0) return '0';
|
|
122
|
+
const norm = text.replace(/\s+/g, ' ').trim().toLowerCase();
|
|
123
|
+
// FNV-1a 64-bit (split into 32-bit halves to stay within Number safe int)
|
|
124
|
+
let h1 = 0x811c9dc5, h2 = 0xcbf29ce4;
|
|
125
|
+
for (let i = 0; i < norm.length; i++) {
|
|
126
|
+
const c = norm.charCodeAt(i);
|
|
127
|
+
h1 ^= c; h1 = Math.imul(h1, 0x01000193) >>> 0;
|
|
128
|
+
h2 ^= c; h2 = Math.imul(h2, 0x100000001b3 & 0xffffffff) >>> 0;
|
|
129
|
+
}
|
|
130
|
+
return `${h1.toString(16)}_${h2.toString(16)}_${norm.length}`;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function deduplicateByContent(entries) {
|
|
134
|
+
if (!entries || !Array.isArray(entries)) return entries;
|
|
135
|
+
const seen = new Map();
|
|
136
|
+
for (const entry of entries) {
|
|
137
|
+
const content = entry.content || entry.summary || entry.value || '';
|
|
138
|
+
const fp = fingerprintContent(typeof content === 'string' ? content : JSON.stringify(content));
|
|
139
|
+
if (!seen.has(fp)) {
|
|
140
|
+
seen.set(fp, entry);
|
|
141
|
+
} else {
|
|
142
|
+
// Keep the entry with the higher accessCount or earlier createdAt
|
|
143
|
+
const existing = seen.get(fp);
|
|
144
|
+
const existingAccess = existing.accessCount || 0;
|
|
145
|
+
const candidateAccess = entry.accessCount || 0;
|
|
146
|
+
if (candidateAccess > existingAccess) seen.set(fp, entry);
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
return Array.from(seen.values());
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// ── Session state helpers ────────────────────────────────────────────────────
|
|
153
|
+
|
|
154
|
+
function sessionGet(key) {
|
|
155
|
+
try {
|
|
156
|
+
if (!fs.existsSync(SESSION_FILE)) return null;
|
|
157
|
+
const session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
|
|
158
|
+
return key ? (session.context || {})[key] : session.context;
|
|
159
|
+
} catch { return null; }
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function sessionSet(key, value) {
|
|
163
|
+
try {
|
|
164
|
+
if (!fs.existsSync(SESSION_DIR)) fs.mkdirSync(SESSION_DIR, { recursive: true });
|
|
165
|
+
let session = {};
|
|
166
|
+
if (fs.existsSync(SESSION_FILE)) {
|
|
167
|
+
session = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
|
|
168
|
+
}
|
|
169
|
+
if (!session.context) session.context = {};
|
|
170
|
+
session.context[key] = value;
|
|
171
|
+
session.updatedAt = new Date().toISOString();
|
|
172
|
+
fs.writeFileSync(SESSION_FILE, JSON.stringify(session, null, 2), 'utf-8');
|
|
173
|
+
} catch { /* best effort */ }
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// ── PageRank ─────────────────────────────────────────────────────────────────
|
|
177
|
+
|
|
178
|
+
function computePageRank(nodes, edges, damping, maxIter) {
|
|
179
|
+
damping = damping || 0.85;
|
|
180
|
+
maxIter = maxIter || 30;
|
|
181
|
+
|
|
182
|
+
const ids = Object.keys(nodes);
|
|
183
|
+
const n = ids.length;
|
|
184
|
+
if (n === 0) return {};
|
|
185
|
+
|
|
186
|
+
// Build adjacency: outgoing edges per node
|
|
187
|
+
const outLinks = {};
|
|
188
|
+
const inLinks = {};
|
|
189
|
+
for (const id of ids) { outLinks[id] = []; inLinks[id] = []; }
|
|
190
|
+
for (const edge of edges) {
|
|
191
|
+
if (outLinks[edge.sourceId]) outLinks[edge.sourceId].push(edge.targetId);
|
|
192
|
+
if (inLinks[edge.targetId]) inLinks[edge.targetId].push(edge.sourceId);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// Initialize ranks
|
|
196
|
+
const ranks = {};
|
|
197
|
+
for (const id of ids) ranks[id] = 1 / n;
|
|
198
|
+
|
|
199
|
+
// Power iteration (with dangling node redistribution)
|
|
200
|
+
for (let iter = 0; iter < maxIter; iter++) {
|
|
201
|
+
const newRanks = {};
|
|
202
|
+
let diff = 0;
|
|
203
|
+
|
|
204
|
+
// Collect rank from dangling nodes (no outgoing edges)
|
|
205
|
+
let danglingSum = 0;
|
|
206
|
+
for (const id of ids) {
|
|
207
|
+
if (outLinks[id].length === 0) danglingSum += ranks[id];
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
for (const id of ids) {
|
|
211
|
+
let sum = 0;
|
|
212
|
+
for (const src of inLinks[id]) {
|
|
213
|
+
const outCount = outLinks[src].length;
|
|
214
|
+
if (outCount > 0) sum += ranks[src] / outCount;
|
|
215
|
+
}
|
|
216
|
+
// Dangling rank distributed evenly + teleport
|
|
217
|
+
newRanks[id] = (1 - damping) / n + damping * (sum + danglingSum / n);
|
|
218
|
+
diff += Math.abs(newRanks[id] - ranks[id]);
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
for (const id of ids) ranks[id] = newRanks[id];
|
|
222
|
+
if (diff < 1e-6) break; // converged
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
return ranks;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
// ── Edge building ────────────────────────────────────────────────────────────
|
|
229
|
+
|
|
230
|
+
function buildEdges(entries) {
|
|
231
|
+
const edges = [];
|
|
232
|
+
const byCategory = {};
|
|
233
|
+
|
|
234
|
+
for (const entry of entries) {
|
|
235
|
+
const cat = entry.category || entry.namespace || 'default';
|
|
236
|
+
if (!byCategory[cat]) byCategory[cat] = [];
|
|
237
|
+
byCategory[cat].push(entry);
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
// Temporal edges: entries from same sourceFile
|
|
241
|
+
const byFile = {};
|
|
242
|
+
for (const entry of entries) {
|
|
243
|
+
const file = (entry.metadata && entry.metadata.sourceFile) || null;
|
|
244
|
+
if (file) {
|
|
245
|
+
if (!byFile[file]) byFile[file] = [];
|
|
246
|
+
byFile[file].push(entry);
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
for (const file of Object.keys(byFile)) {
|
|
250
|
+
const group = byFile[file];
|
|
251
|
+
for (let i = 0; i < group.length - 1; i++) {
|
|
252
|
+
edges.push({
|
|
253
|
+
sourceId: group[i].id,
|
|
254
|
+
targetId: group[i + 1].id,
|
|
255
|
+
type: 'temporal',
|
|
256
|
+
weight: 0.5,
|
|
257
|
+
});
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
// Similarity edges within categories (Jaccard > 0.3).
|
|
262
|
+
// ADR-095 G6 perf: hoist the trigram computation outside the inner
|
|
263
|
+
// loop. Previously we re-tokenized + re-trigrammed group[j] for every
|
|
264
|
+
// i — O(n²) extra work for nothing. Now compute once per entry.
|
|
265
|
+
for (const cat of Object.keys(byCategory)) {
|
|
266
|
+
const group = byCategory[cat];
|
|
267
|
+
if (group.length < 2) continue;
|
|
268
|
+
|
|
269
|
+
// Cache trigram sets for every entry in the group.
|
|
270
|
+
const triCache = new Array(group.length);
|
|
271
|
+
for (let i = 0; i < group.length; i++) {
|
|
272
|
+
triCache[i] = trigrams(tokenize(group[i].content || group[i].summary || ''));
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
for (let i = 0; i < group.length; i++) {
|
|
276
|
+
const triA = triCache[i];
|
|
277
|
+
for (let j = i + 1; j < group.length; j++) {
|
|
278
|
+
const sim = jaccardSimilarity(triA, triCache[j]);
|
|
279
|
+
if (sim > 0.3) {
|
|
280
|
+
edges.push({
|
|
281
|
+
sourceId: group[i].id,
|
|
282
|
+
targetId: group[j].id,
|
|
283
|
+
type: 'similar',
|
|
284
|
+
weight: sim,
|
|
285
|
+
});
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
return edges;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
// ── Bootstrap from MEMORY.md files ───────────────────────────────────────────
|
|
295
|
+
|
|
296
|
+
/**
|
|
297
|
+
* If auto-memory-store.json is empty, bootstrap by parsing MEMORY.md and
|
|
298
|
+
* topic files from the auto-memory directory. This removes the dependency
|
|
299
|
+
* on @claude-flow/memory for the initial seed.
|
|
300
|
+
*/
|
|
301
|
+
function bootstrapFromMemoryFiles() {
|
|
302
|
+
const entries = [];
|
|
303
|
+
const cwd = process.cwd();
|
|
304
|
+
|
|
305
|
+
// Search for auto-memory directories
|
|
306
|
+
const candidates = [
|
|
307
|
+
// Claude Code auto-memory (project-scoped)
|
|
308
|
+
path.join(require('os').homedir(), '.claude', 'projects'),
|
|
309
|
+
// Local project memory
|
|
310
|
+
path.join(cwd, '.claude-flow', 'memory'),
|
|
311
|
+
path.join(cwd, '.claude', 'memory'),
|
|
312
|
+
];
|
|
313
|
+
|
|
314
|
+
// Find MEMORY.md in project-scoped dirs
|
|
315
|
+
for (const base of candidates) {
|
|
316
|
+
if (!fs.existsSync(base)) continue;
|
|
317
|
+
|
|
318
|
+
// For the projects dir, scope to CURRENT project only (not all 51+ dirs)
|
|
319
|
+
if (base.endsWith('projects')) {
|
|
320
|
+
try {
|
|
321
|
+
const projectSlug = cwd.replace(/^\//, '').replace(/\//g, '-');
|
|
322
|
+
const memDir = path.join(base, projectSlug, 'memory');
|
|
323
|
+
if (fs.existsSync(memDir)) {
|
|
324
|
+
parseMemoryDir(memDir, entries);
|
|
325
|
+
}
|
|
326
|
+
} catch { /* skip */ }
|
|
327
|
+
} else if (fs.existsSync(base)) {
|
|
328
|
+
parseMemoryDir(base, entries);
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
return entries;
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
function parseMemoryDir(dir, entries) {
|
|
336
|
+
try {
|
|
337
|
+
const files = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
|
|
338
|
+
for (const file of files) {
|
|
339
|
+
const filePath = path.join(dir, file);
|
|
340
|
+
const content = fs.readFileSync(filePath, 'utf-8');
|
|
341
|
+
if (!content.trim()) continue;
|
|
342
|
+
|
|
343
|
+
// Parse markdown sections as separate entries
|
|
344
|
+
const sections = content.split(/^##?\s+/m).filter(Boolean);
|
|
345
|
+
for (let sIdx = 0; sIdx < sections.length; sIdx++) {
|
|
346
|
+
const section = sections[sIdx];
|
|
347
|
+
const lines = section.trim().split('\n');
|
|
348
|
+
const title = lines[0].trim();
|
|
349
|
+
const body = lines.slice(1).join('\n').trim();
|
|
350
|
+
if (!body || body.length < 10) continue;
|
|
351
|
+
|
|
352
|
+
const id = `mem-${file.replace('.md', '')}-${title.replace(/[^a-z0-9]/gi, '-').toLowerCase().slice(0, 30)}-${sIdx}`;
|
|
353
|
+
entries.push({
|
|
354
|
+
id,
|
|
355
|
+
key: title.toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 50),
|
|
356
|
+
content: body.slice(0, 500),
|
|
357
|
+
summary: title,
|
|
358
|
+
namespace: file === 'MEMORY.md' ? 'core' : file.replace('.md', ''),
|
|
359
|
+
type: 'semantic',
|
|
360
|
+
metadata: { sourceFile: filePath, bootstrapped: true },
|
|
361
|
+
createdAt: Date.now(),
|
|
362
|
+
});
|
|
363
|
+
}
|
|
364
|
+
}
|
|
365
|
+
} catch { /* skip unreadable dirs */ }
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
// ── Exported functions ───────────────────────────────────────────────────────
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* init() — Called from session-restore. Budget: <200ms.
|
|
372
|
+
* Reads auto-memory-store.json, builds graph, computes PageRank, writes caches.
|
|
373
|
+
* If store is empty, bootstraps from MEMORY.md files directly.
|
|
374
|
+
*/
|
|
375
|
+
function init() {
|
|
376
|
+
ensureDataDir();
|
|
377
|
+
|
|
378
|
+
// Check if graph-state.json is fresh (within 60s of store)
|
|
379
|
+
const graphState = readJSON(GRAPH_PATH);
|
|
380
|
+
let store = readJSON(STORE_PATH);
|
|
381
|
+
|
|
382
|
+
// Bootstrap from MEMORY.md files if store is empty
|
|
383
|
+
if (!store || !Array.isArray(store) || store.length === 0) {
|
|
384
|
+
const bootstrapped = bootstrapFromMemoryFiles();
|
|
385
|
+
if (bootstrapped.length > 0) {
|
|
386
|
+
store = bootstrapped;
|
|
387
|
+
writeJSON(STORE_PATH, store);
|
|
388
|
+
} else {
|
|
389
|
+
return { nodes: 0, edges: 0, message: 'No memory entries to index' };
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
// Deduplicate store entries by ID (fixes #1518 — 194MB → ~79KB)
|
|
394
|
+
let deduped = deduplicateById(store);
|
|
395
|
+
// ADR-095 G6: also dedupe by content fingerprint. The April audit
|
|
396
|
+
// measured 5,706 entries with only ~20 unique by content because the
|
|
397
|
+
// same MEMORY.md sections get imported from sibling project dirs with
|
|
398
|
+
// different IDs. deduplicateById can't catch that; deduplicateByContent
|
|
399
|
+
// can. Cuts the graph from O(n²) over near-identical duplicates down
|
|
400
|
+
// to O(unique²), which is the difference between a 100MB graph-state
|
|
401
|
+
// and a kilobytes-scale one for typical workloads.
|
|
402
|
+
const beforeContentDedup = deduped.length;
|
|
403
|
+
deduped = deduplicateByContent(deduped);
|
|
404
|
+
if (deduped.length < store.length) {
|
|
405
|
+
process.stderr.write(
|
|
406
|
+
`[INTELLIGENCE] Deduped store: ${store.length} -> ${deduped.length} entries ` +
|
|
407
|
+
`(by-id: ${store.length - beforeContentDedup} dropped, by-content: ${beforeContentDedup - deduped.length} dropped)\n`
|
|
408
|
+
);
|
|
409
|
+
writeJSON(STORE_PATH, deduped);
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
// Skip rebuild if graph is fresh and store hasn't changed
|
|
413
|
+
if (graphState && graphState.nodeCount === deduped.length) {
|
|
414
|
+
const age = Date.now() - (graphState.updatedAt || 0);
|
|
415
|
+
if (age < 60000) {
|
|
416
|
+
return {
|
|
417
|
+
nodes: graphState.nodeCount || Object.keys(graphState.nodes || {}).length,
|
|
418
|
+
edges: (graphState.edges || []).length,
|
|
419
|
+
message: 'Graph cache hit',
|
|
420
|
+
};
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
// Build nodes from deduped entries
|
|
425
|
+
const nodes = {};
|
|
426
|
+
for (const entry of deduped) {
|
|
427
|
+
const id = entry.id || entry.key || `entry-${Math.random().toString(36).slice(2, 8)}`;
|
|
428
|
+
nodes[id] = {
|
|
429
|
+
id,
|
|
430
|
+
category: entry.namespace || entry.type || 'default',
|
|
431
|
+
confidence: (entry.metadata && entry.metadata.confidence) || 0.5,
|
|
432
|
+
accessCount: (entry.metadata && entry.metadata.accessCount) || 0,
|
|
433
|
+
createdAt: entry.createdAt || Date.now(),
|
|
434
|
+
};
|
|
435
|
+
// Ensure entry has id for edge building
|
|
436
|
+
entry.id = id;
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
// Build edges
|
|
440
|
+
const edges = buildEdges(deduped);
|
|
441
|
+
|
|
442
|
+
// Compute PageRank (skip if graph too large — #1531)
|
|
443
|
+
const nodeCount = Object.keys(nodes).length;
|
|
444
|
+
let pageRanks = {};
|
|
445
|
+
if (nodeCount > MAX_GRAPH_NODES) {
|
|
446
|
+
process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank\n");
|
|
447
|
+
for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
|
|
448
|
+
} else {
|
|
449
|
+
pageRanks = computePageRank(nodes, edges, 0.85, 30);
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
// Write graph state
|
|
453
|
+
const graph = {
|
|
454
|
+
version: 1,
|
|
455
|
+
updatedAt: Date.now(),
|
|
456
|
+
nodeCount: Object.keys(nodes).length,
|
|
457
|
+
nodes,
|
|
458
|
+
edges,
|
|
459
|
+
pageRanks,
|
|
460
|
+
};
|
|
461
|
+
writeJSON(GRAPH_PATH, graph);
|
|
462
|
+
|
|
463
|
+
// Build ranked context for fast lookup
|
|
464
|
+
const rankedEntries = deduped.map(entry => {
|
|
465
|
+
const id = entry.id;
|
|
466
|
+
const content = entry.content || entry.value || '';
|
|
467
|
+
const summary = entry.summary || entry.key || '';
|
|
468
|
+
const words = tokenize(content + ' ' + summary);
|
|
469
|
+
return {
|
|
470
|
+
id,
|
|
471
|
+
content,
|
|
472
|
+
summary,
|
|
473
|
+
category: entry.namespace || entry.type || 'default',
|
|
474
|
+
confidence: nodes[id] ? nodes[id].confidence : 0.5,
|
|
475
|
+
pageRank: pageRanks[id] || 0,
|
|
476
|
+
accessCount: nodes[id] ? nodes[id].accessCount : 0,
|
|
477
|
+
words,
|
|
478
|
+
};
|
|
479
|
+
}).sort((a, b) => {
|
|
480
|
+
const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
|
|
481
|
+
const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
|
|
482
|
+
return scoreB - scoreA;
|
|
483
|
+
});
|
|
484
|
+
|
|
485
|
+
const ranked = {
|
|
486
|
+
version: 1,
|
|
487
|
+
computedAt: Date.now(),
|
|
488
|
+
entries: rankedEntries,
|
|
489
|
+
};
|
|
490
|
+
writeJSON(RANKED_PATH, ranked);
|
|
491
|
+
|
|
492
|
+
return {
|
|
493
|
+
nodes: Object.keys(nodes).length,
|
|
494
|
+
edges: edges.length,
|
|
495
|
+
message: 'Graph built and ranked',
|
|
496
|
+
};
|
|
497
|
+
}
|
|
498
|
+
|
|
499
|
+
/**
|
|
500
|
+
* getContext(prompt) — Called from route. Budget: <15ms.
|
|
501
|
+
* Matches prompt to ranked entries, returns top-5 formatted context.
|
|
502
|
+
*/
|
|
503
|
+
function getContext(prompt) {
|
|
504
|
+
if (!prompt) return null;
|
|
505
|
+
|
|
506
|
+
const ranked = readJSON(RANKED_PATH);
|
|
507
|
+
if (!ranked || !ranked.entries || ranked.entries.length === 0) return null;
|
|
508
|
+
|
|
509
|
+
const promptWords = tokenize(prompt);
|
|
510
|
+
if (promptWords.length === 0) return null;
|
|
511
|
+
const promptTrigrams = trigrams(promptWords);
|
|
512
|
+
|
|
513
|
+
const ALPHA = 0.6; // content match weight
|
|
514
|
+
const MIN_THRESHOLD = 0.05;
|
|
515
|
+
const TOP_K = 5;
|
|
516
|
+
|
|
517
|
+
// Score each entry
|
|
518
|
+
const scored = [];
|
|
519
|
+
for (const entry of ranked.entries) {
|
|
520
|
+
const entryTrigrams = trigrams(entry.words || []);
|
|
521
|
+
const contentMatch = jaccardSimilarity(promptTrigrams, entryTrigrams);
|
|
522
|
+
const score = ALPHA * contentMatch + (1 - ALPHA) * (entry.pageRank || 0);
|
|
523
|
+
if (score >= MIN_THRESHOLD) {
|
|
524
|
+
scored.push({ ...entry, score });
|
|
525
|
+
}
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
if (scored.length === 0) return null;
|
|
529
|
+
|
|
530
|
+
// Sort by score descending, take top-K
|
|
531
|
+
scored.sort((a, b) => b.score - a.score);
|
|
532
|
+
const topEntries = scored.slice(0, TOP_K);
|
|
533
|
+
|
|
534
|
+
// Boost previously matched patterns (implicit success: user continued working)
|
|
535
|
+
const prevMatched = sessionGet('lastMatchedPatterns');
|
|
536
|
+
|
|
537
|
+
// Store NEW matched IDs in session state for feedback
|
|
538
|
+
const matchedIds = topEntries.map(e => e.id);
|
|
539
|
+
sessionSet('lastMatchedPatterns', matchedIds);
|
|
540
|
+
|
|
541
|
+
// Only boost previous if they differ from current (avoid double-boosting)
|
|
542
|
+
if (prevMatched && Array.isArray(prevMatched)) {
|
|
543
|
+
const newSet = new Set(matchedIds);
|
|
544
|
+
const toBoost = prevMatched.filter(id => !newSet.has(id));
|
|
545
|
+
if (toBoost.length > 0) boostConfidence(toBoost, 0.03);
|
|
546
|
+
}
|
|
547
|
+
|
|
548
|
+
// Format output
|
|
549
|
+
const lines = ['[INTELLIGENCE] Relevant patterns for this task:'];
|
|
550
|
+
for (let i = 0; i < topEntries.length; i++) {
|
|
551
|
+
const e = topEntries[i];
|
|
552
|
+
const display = (e.summary || e.content || '').slice(0, 80);
|
|
553
|
+
const accessed = e.accessCount || 0;
|
|
554
|
+
lines.push(` * (${e.score.toFixed(2)}) ${display} [rank #${i + 1}, ${accessed}x accessed]`);
|
|
555
|
+
}
|
|
556
|
+
|
|
557
|
+
return lines.join('\n');
|
|
558
|
+
}
|
|
559
|
+
|
|
560
|
+
/**
|
|
561
|
+
* recordEdit(file) — Called from post-edit. Budget: <2ms.
|
|
562
|
+
* Appends to pending-insights.jsonl.
|
|
563
|
+
*/
|
|
564
|
+
function recordEdit(file) {
|
|
565
|
+
ensureDataDir();
|
|
566
|
+
const entry = JSON.stringify({
|
|
567
|
+
type: 'edit',
|
|
568
|
+
file: file || 'unknown',
|
|
569
|
+
timestamp: Date.now(),
|
|
570
|
+
sessionId: sessionGet('sessionId') || null,
|
|
571
|
+
});
|
|
572
|
+
fs.appendFileSync(PENDING_PATH, entry + '\n', 'utf-8');
|
|
573
|
+
}
|
|
574
|
+
|
|
575
|
+
/**
|
|
576
|
+
* feedback(success) — Called from post-task. Budget: <10ms.
|
|
577
|
+
* Boosts or decays confidence for last-matched patterns.
|
|
578
|
+
*/
|
|
579
|
+
function feedback(success) {
|
|
580
|
+
const matchedIds = sessionGet('lastMatchedPatterns');
|
|
581
|
+
if (!matchedIds || !Array.isArray(matchedIds)) return;
|
|
582
|
+
|
|
583
|
+
const amount = success ? 0.05 : -0.02;
|
|
584
|
+
boostConfidence(matchedIds, amount);
|
|
585
|
+
}
|
|
586
|
+
|
|
587
|
+
function boostConfidence(ids, amount) {
|
|
588
|
+
const ranked = readJSON(RANKED_PATH);
|
|
589
|
+
if (!ranked || !ranked.entries) return;
|
|
590
|
+
|
|
591
|
+
let changed = false;
|
|
592
|
+
for (const entry of ranked.entries) {
|
|
593
|
+
if (ids.includes(entry.id)) {
|
|
594
|
+
entry.confidence = Math.max(0, Math.min(1, (entry.confidence || 0.5) + amount));
|
|
595
|
+
entry.accessCount = (entry.accessCount || 0) + 1;
|
|
596
|
+
changed = true;
|
|
597
|
+
}
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
if (changed) writeJSON(RANKED_PATH, ranked);
|
|
601
|
+
|
|
602
|
+
// Also update graph-state confidence
|
|
603
|
+
const graph = readJSON(GRAPH_PATH);
|
|
604
|
+
if (graph && graph.nodes) {
|
|
605
|
+
for (const id of ids) {
|
|
606
|
+
if (graph.nodes[id]) {
|
|
607
|
+
graph.nodes[id].confidence = Math.max(0, Math.min(1, (graph.nodes[id].confidence || 0.5) + amount));
|
|
608
|
+
graph.nodes[id].accessCount = (graph.nodes[id].accessCount || 0) + 1;
|
|
609
|
+
}
|
|
610
|
+
}
|
|
611
|
+
writeJSON(GRAPH_PATH, graph);
|
|
612
|
+
}
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
/**
|
|
616
|
+
* consolidate() — Called from session-end. Budget: <500ms.
|
|
617
|
+
* Processes pending insights, rebuilds edges, recomputes PageRank.
|
|
618
|
+
*/
|
|
619
|
+
function consolidate() {
|
|
620
|
+
ensureDataDir();
|
|
621
|
+
|
|
622
|
+
let store = readJSON(STORE_PATH);
|
|
623
|
+
if (!store || !Array.isArray(store)) {
|
|
624
|
+
return { entries: 0, edges: 0, newEntries: 0, message: 'No store to consolidate' };
|
|
625
|
+
}
|
|
626
|
+
|
|
627
|
+
// Deduplicate store entries by ID before processing (fixes #1518)
|
|
628
|
+
const preDedupCount = store.length;
|
|
629
|
+
store = deduplicateById(store);
|
|
630
|
+
|
|
631
|
+
// 1. Process pending insights
|
|
632
|
+
let newEntries = 0;
|
|
633
|
+
if (fs.existsSync(PENDING_PATH)) {
|
|
634
|
+
const lines = fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean);
|
|
635
|
+
const editCounts = {};
|
|
636
|
+
for (const line of lines) {
|
|
637
|
+
try {
|
|
638
|
+
const insight = JSON.parse(line);
|
|
639
|
+
if (insight.file) {
|
|
640
|
+
editCounts[insight.file] = (editCounts[insight.file] || 0) + 1;
|
|
641
|
+
}
|
|
642
|
+
} catch { /* skip malformed */ }
|
|
643
|
+
}
|
|
644
|
+
|
|
645
|
+
// Create entries for frequently-edited files (3+ edits)
|
|
646
|
+
for (const [file, count] of Object.entries(editCounts)) {
|
|
647
|
+
if (count >= 3) {
|
|
648
|
+
const exists = store.some(e =>
|
|
649
|
+
(e.metadata && e.metadata.sourceFile === file && e.metadata.autoGenerated)
|
|
650
|
+
);
|
|
651
|
+
if (!exists) {
|
|
652
|
+
store.push({
|
|
653
|
+
id: `insight-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
|
|
654
|
+
key: `frequent-edit-${path.basename(file)}`,
|
|
655
|
+
content: `File ${file} was edited ${count} times this session — likely a hot path worth monitoring.`,
|
|
656
|
+
summary: `Frequently edited: ${path.basename(file)} (${count}x)`,
|
|
657
|
+
namespace: 'insights',
|
|
658
|
+
type: 'procedural',
|
|
659
|
+
metadata: { sourceFile: file, editCount: count, autoGenerated: true },
|
|
660
|
+
createdAt: Date.now(),
|
|
661
|
+
});
|
|
662
|
+
newEntries++;
|
|
663
|
+
}
|
|
664
|
+
}
|
|
665
|
+
}
|
|
666
|
+
|
|
667
|
+
// Clear pending
|
|
668
|
+
fs.writeFileSync(PENDING_PATH, '', 'utf-8');
|
|
669
|
+
}
|
|
670
|
+
|
|
671
|
+
// 2. Confidence decay for unaccessed entries
|
|
672
|
+
const graph = readJSON(GRAPH_PATH);
|
|
673
|
+
if (graph && graph.nodes) {
|
|
674
|
+
const now = Date.now();
|
|
675
|
+
for (const id of Object.keys(graph.nodes)) {
|
|
676
|
+
const node = graph.nodes[id];
|
|
677
|
+
const hoursSinceCreation = (now - (node.createdAt || now)) / (1000 * 60 * 60);
|
|
678
|
+
if (node.accessCount === 0 && hoursSinceCreation > 24) {
|
|
679
|
+
node.confidence = Math.max(0.05, (node.confidence || 0.5) - 0.005 * Math.floor(hoursSinceCreation / 24));
|
|
680
|
+
}
|
|
681
|
+
}
|
|
682
|
+
}
|
|
683
|
+
|
|
684
|
+
// 3. Rebuild edges with updated store
|
|
685
|
+
for (const entry of store) {
|
|
686
|
+
if (!entry.id) entry.id = `entry-${Math.random().toString(36).slice(2, 8)}`;
|
|
687
|
+
}
|
|
688
|
+
const edges = buildEdges(store);
|
|
689
|
+
|
|
690
|
+
// 4. Build updated nodes
|
|
691
|
+
const nodes = {};
|
|
692
|
+
for (const entry of store) {
|
|
693
|
+
nodes[entry.id] = {
|
|
694
|
+
id: entry.id,
|
|
695
|
+
category: entry.namespace || entry.type || 'default',
|
|
696
|
+
confidence: (graph && graph.nodes && graph.nodes[entry.id])
|
|
697
|
+
? graph.nodes[entry.id].confidence
|
|
698
|
+
: (entry.metadata && entry.metadata.confidence) || 0.5,
|
|
699
|
+
accessCount: (graph && graph.nodes && graph.nodes[entry.id])
|
|
700
|
+
? graph.nodes[entry.id].accessCount
|
|
701
|
+
: (entry.metadata && entry.metadata.accessCount) || 0,
|
|
702
|
+
createdAt: entry.createdAt || Date.now(),
|
|
703
|
+
};
|
|
704
|
+
}
|
|
705
|
+
|
|
706
|
+
// 5. Recompute PageRank (skip if graph too large — #1531)
|
|
707
|
+
const nodeCount = Object.keys(nodes).length;
|
|
708
|
+
let pageRanks = {};
|
|
709
|
+
if (nodeCount > MAX_GRAPH_NODES) {
|
|
710
|
+
process.stderr.write("[INTELLIGENCE] WARN: Graph has " + nodeCount + " nodes (>" + MAX_GRAPH_NODES + "), skipping PageRank in consolidate\n");
|
|
711
|
+
for (const id of Object.keys(nodes)) pageRanks[id] = 1 / nodeCount;
|
|
712
|
+
} else {
|
|
713
|
+
pageRanks = computePageRank(nodes, edges, 0.85, 30);
|
|
714
|
+
}
|
|
715
|
+
|
|
716
|
+
// 6. Write updated graph
|
|
717
|
+
writeJSON(GRAPH_PATH, {
|
|
718
|
+
version: 1,
|
|
719
|
+
updatedAt: Date.now(),
|
|
720
|
+
nodeCount: Object.keys(nodes).length,
|
|
721
|
+
nodes,
|
|
722
|
+
edges,
|
|
723
|
+
pageRanks,
|
|
724
|
+
});
|
|
725
|
+
|
|
726
|
+
// 7. Write updated ranked context
|
|
727
|
+
const rankedEntries = store.map(entry => {
|
|
728
|
+
const id = entry.id;
|
|
729
|
+
const content = entry.content || entry.value || '';
|
|
730
|
+
const summary = entry.summary || entry.key || '';
|
|
731
|
+
const words = tokenize(content + ' ' + summary);
|
|
732
|
+
return {
|
|
733
|
+
id,
|
|
734
|
+
content,
|
|
735
|
+
summary,
|
|
736
|
+
category: entry.namespace || entry.type || 'default',
|
|
737
|
+
confidence: nodes[id] ? nodes[id].confidence : 0.5,
|
|
738
|
+
pageRank: pageRanks[id] || 0,
|
|
739
|
+
accessCount: nodes[id] ? nodes[id].accessCount : 0,
|
|
740
|
+
words,
|
|
741
|
+
};
|
|
742
|
+
}).sort((a, b) => {
|
|
743
|
+
const scoreA = 0.6 * a.pageRank + 0.4 * a.confidence;
|
|
744
|
+
const scoreB = 0.6 * b.pageRank + 0.4 * b.confidence;
|
|
745
|
+
return scoreB - scoreA;
|
|
746
|
+
});
|
|
747
|
+
|
|
748
|
+
writeJSON(RANKED_PATH, {
|
|
749
|
+
version: 1,
|
|
750
|
+
computedAt: Date.now(),
|
|
751
|
+
entries: rankedEntries,
|
|
752
|
+
});
|
|
753
|
+
|
|
754
|
+
// 8. Persist updated store (deduped or with new insight entries)
|
|
755
|
+
if (newEntries > 0 || store.length < preDedupCount) writeJSON(STORE_PATH, store);
|
|
756
|
+
|
|
757
|
+
// 9. Save snapshot for delta tracking
|
|
758
|
+
const updatedGraph = readJSON(GRAPH_PATH);
|
|
759
|
+
const updatedRanked = readJSON(RANKED_PATH);
|
|
760
|
+
saveSnapshot(updatedGraph, updatedRanked);
|
|
761
|
+
|
|
762
|
+
return {
|
|
763
|
+
entries: store.length,
|
|
764
|
+
edges: edges.length,
|
|
765
|
+
newEntries,
|
|
766
|
+
message: 'Consolidated',
|
|
767
|
+
};
|
|
768
|
+
}
|
|
769
|
+
|
|
770
|
+
// ── Snapshot for delta tracking ─────────────────────────────────────────────
|
|
771
|
+
|
|
772
|
+
const SNAPSHOT_PATH = path.join(DATA_DIR, 'intelligence-snapshot.json');
|
|
773
|
+
|
|
774
|
+
function saveSnapshot(graph, ranked) {
|
|
775
|
+
const snap = {
|
|
776
|
+
timestamp: Date.now(),
|
|
777
|
+
nodes: graph ? Object.keys(graph.nodes || {}).length : 0,
|
|
778
|
+
edges: graph ? (graph.edges || []).length : 0,
|
|
779
|
+
pageRankSum: 0,
|
|
780
|
+
confidences: [],
|
|
781
|
+
accessCounts: [],
|
|
782
|
+
topPatterns: [],
|
|
783
|
+
};
|
|
784
|
+
|
|
785
|
+
if (graph && graph.pageRanks) {
|
|
786
|
+
for (const v of Object.values(graph.pageRanks)) snap.pageRankSum += v;
|
|
787
|
+
}
|
|
788
|
+
if (graph && graph.nodes) {
|
|
789
|
+
for (const n of Object.values(graph.nodes)) {
|
|
790
|
+
snap.confidences.push(n.confidence || 0.5);
|
|
791
|
+
snap.accessCounts.push(n.accessCount || 0);
|
|
792
|
+
}
|
|
793
|
+
}
|
|
794
|
+
if (ranked && ranked.entries) {
|
|
795
|
+
snap.topPatterns = ranked.entries.slice(0, 10).map(e => ({
|
|
796
|
+
id: e.id,
|
|
797
|
+
summary: (e.summary || '').slice(0, 60),
|
|
798
|
+
confidence: e.confidence || 0.5,
|
|
799
|
+
pageRank: e.pageRank || 0,
|
|
800
|
+
accessCount: e.accessCount || 0,
|
|
801
|
+
}));
|
|
802
|
+
}
|
|
803
|
+
|
|
804
|
+
// Keep history: append to array, cap at 50
|
|
805
|
+
let history = readJSON(SNAPSHOT_PATH);
|
|
806
|
+
if (!Array.isArray(history)) history = [];
|
|
807
|
+
history.push(snap);
|
|
808
|
+
if (history.length > 50) history = history.slice(-50);
|
|
809
|
+
writeJSON(SNAPSHOT_PATH, history);
|
|
810
|
+
}
|
|
811
|
+
|
|
812
|
+
/**
|
|
813
|
+
* stats() — Diagnostic report showing intelligence health and improvement.
|
|
814
|
+
* Can be called as: node intelligence.cjs stats [--json]
|
|
815
|
+
*/
|
|
816
|
+
function stats(outputJson) {
|
|
817
|
+
const graph = readJSON(GRAPH_PATH);
|
|
818
|
+
const ranked = readJSON(RANKED_PATH);
|
|
819
|
+
const history = readJSON(SNAPSHOT_PATH) || [];
|
|
820
|
+
const pending = fs.existsSync(PENDING_PATH)
|
|
821
|
+
? fs.readFileSync(PENDING_PATH, 'utf-8').trim().split('\n').filter(Boolean).length
|
|
822
|
+
: 0;
|
|
823
|
+
|
|
824
|
+
// Current state
|
|
825
|
+
const nodes = graph ? Object.keys(graph.nodes || {}).length : 0;
|
|
826
|
+
const edges = graph ? (graph.edges || []).length : 0;
|
|
827
|
+
const density = nodes > 1 ? (2 * edges) / (nodes * (nodes - 1)) : 0;
|
|
828
|
+
|
|
829
|
+
// Confidence distribution
|
|
830
|
+
const confidences = [];
|
|
831
|
+
const accessCounts = [];
|
|
832
|
+
if (graph && graph.nodes) {
|
|
833
|
+
for (const n of Object.values(graph.nodes)) {
|
|
834
|
+
confidences.push(n.confidence || 0.5);
|
|
835
|
+
accessCounts.push(n.accessCount || 0);
|
|
836
|
+
}
|
|
837
|
+
}
|
|
838
|
+
confidences.sort((a, b) => a - b);
|
|
839
|
+
const confMin = confidences.length ? confidences[0] : 0;
|
|
840
|
+
const confMax = confidences.length ? confidences[confidences.length - 1] : 0;
|
|
841
|
+
const confMean = confidences.length ? confidences.reduce((s, c) => s + c, 0) / confidences.length : 0;
|
|
842
|
+
const confMedian = confidences.length ? confidences[Math.floor(confidences.length / 2)] : 0;
|
|
843
|
+
|
|
844
|
+
// Access stats
|
|
845
|
+
const totalAccess = accessCounts.reduce((s, c) => s + c, 0);
|
|
846
|
+
const accessedCount = accessCounts.filter(c => c > 0).length;
|
|
847
|
+
|
|
848
|
+
// PageRank stats
|
|
849
|
+
let prSum = 0, prMax = 0, prMaxId = '';
|
|
850
|
+
if (graph && graph.pageRanks) {
|
|
851
|
+
for (const [id, pr] of Object.entries(graph.pageRanks)) {
|
|
852
|
+
prSum += pr;
|
|
853
|
+
if (pr > prMax) { prMax = pr; prMaxId = id; }
|
|
854
|
+
}
|
|
855
|
+
}
|
|
856
|
+
|
|
857
|
+
// Top patterns by composite score
|
|
858
|
+
const topPatterns = (ranked && ranked.entries || []).slice(0, 10).map((e, i) => ({
|
|
859
|
+
rank: i + 1,
|
|
860
|
+
summary: (e.summary || '').slice(0, 60),
|
|
861
|
+
confidence: (e.confidence || 0.5).toFixed(3),
|
|
862
|
+
pageRank: (e.pageRank || 0).toFixed(4),
|
|
863
|
+
accessed: e.accessCount || 0,
|
|
864
|
+
score: (0.6 * (e.pageRank || 0) + 0.4 * (e.confidence || 0.5)).toFixed(4),
|
|
865
|
+
}));
|
|
866
|
+
|
|
867
|
+
// Edge type breakdown
|
|
868
|
+
const edgeTypes = {};
|
|
869
|
+
if (graph && graph.edges) {
|
|
870
|
+
for (const e of graph.edges) {
|
|
871
|
+
edgeTypes[e.type || 'unknown'] = (edgeTypes[e.type || 'unknown'] || 0) + 1;
|
|
872
|
+
}
|
|
873
|
+
}
|
|
874
|
+
|
|
875
|
+
// Delta from previous snapshot
|
|
876
|
+
let delta = null;
|
|
877
|
+
if (history.length >= 2) {
|
|
878
|
+
const prev = history[history.length - 2];
|
|
879
|
+
const curr = history[history.length - 1];
|
|
880
|
+
const elapsed = (curr.timestamp - prev.timestamp) / 1000;
|
|
881
|
+
const prevConfMean = prev.confidences.length
|
|
882
|
+
? prev.confidences.reduce((s, c) => s + c, 0) / prev.confidences.length : 0;
|
|
883
|
+
const currConfMean = curr.confidences.length
|
|
884
|
+
? curr.confidences.reduce((s, c) => s + c, 0) / curr.confidences.length : 0;
|
|
885
|
+
const prevAccess = prev.accessCounts.reduce((s, c) => s + c, 0);
|
|
886
|
+
const currAccess = curr.accessCounts.reduce((s, c) => s + c, 0);
|
|
887
|
+
|
|
888
|
+
delta = {
|
|
889
|
+
elapsed: elapsed < 3600 ? `${Math.round(elapsed / 60)}m` : `${(elapsed / 3600).toFixed(1)}h`,
|
|
890
|
+
nodes: curr.nodes - prev.nodes,
|
|
891
|
+
edges: curr.edges - prev.edges,
|
|
892
|
+
confidenceMean: currConfMean - prevConfMean,
|
|
893
|
+
totalAccess: currAccess - prevAccess,
|
|
894
|
+
};
|
|
895
|
+
}
|
|
896
|
+
|
|
897
|
+
// Trend over all history
|
|
898
|
+
let trend = null;
|
|
899
|
+
if (history.length >= 3) {
|
|
900
|
+
const first = history[0];
|
|
901
|
+
const last = history[history.length - 1];
|
|
902
|
+
const sessions = history.length;
|
|
903
|
+
const firstConfMean = first.confidences.length
|
|
904
|
+
? first.confidences.reduce((s, c) => s + c, 0) / first.confidences.length : 0;
|
|
905
|
+
const lastConfMean = last.confidences.length
|
|
906
|
+
? last.confidences.reduce((s, c) => s + c, 0) / last.confidences.length : 0;
|
|
907
|
+
trend = {
|
|
908
|
+
sessions,
|
|
909
|
+
nodeGrowth: last.nodes - first.nodes,
|
|
910
|
+
edgeGrowth: last.edges - first.edges,
|
|
911
|
+
confidenceDrift: lastConfMean - firstConfMean,
|
|
912
|
+
direction: lastConfMean > firstConfMean ? 'improving' :
|
|
913
|
+
lastConfMean < firstConfMean ? 'declining' : 'stable',
|
|
914
|
+
};
|
|
915
|
+
}
|
|
916
|
+
|
|
917
|
+
const report = {
|
|
918
|
+
graph: { nodes, edges, density: +density.toFixed(4) },
|
|
919
|
+
confidence: {
|
|
920
|
+
min: +confMin.toFixed(3), max: +confMax.toFixed(3),
|
|
921
|
+
mean: +confMean.toFixed(3), median: +confMedian.toFixed(3),
|
|
922
|
+
},
|
|
923
|
+
access: { total: totalAccess, patternsAccessed: accessedCount, patternsNeverAccessed: nodes - accessedCount },
|
|
924
|
+
pageRank: { sum: +prSum.toFixed(4), topNode: prMaxId, topNodeRank: +prMax.toFixed(4) },
|
|
925
|
+
edgeTypes,
|
|
926
|
+
pendingInsights: pending,
|
|
927
|
+
snapshots: history.length,
|
|
928
|
+
topPatterns,
|
|
929
|
+
delta,
|
|
930
|
+
trend,
|
|
931
|
+
};
|
|
932
|
+
|
|
933
|
+
if (outputJson) {
|
|
934
|
+
console.log(JSON.stringify(report, null, 2));
|
|
935
|
+
return report;
|
|
936
|
+
}
|
|
937
|
+
|
|
938
|
+
// Human-readable output
|
|
939
|
+
const bar = '+' + '-'.repeat(62) + '+';
|
|
940
|
+
console.log(bar);
|
|
941
|
+
console.log('|' + ' Intelligence Diagnostics (ADR-050)'.padEnd(62) + '|');
|
|
942
|
+
console.log(bar);
|
|
943
|
+
console.log('');
|
|
944
|
+
|
|
945
|
+
console.log(' Graph');
|
|
946
|
+
console.log(` Nodes: ${nodes}`);
|
|
947
|
+
console.log(` Edges: ${edges} (${Object.entries(edgeTypes).map(([t,c]) => `${c} ${t}`).join(', ') || 'none'})`);
|
|
948
|
+
console.log(` Density: ${(density * 100).toFixed(1)}%`);
|
|
949
|
+
console.log('');
|
|
950
|
+
|
|
951
|
+
console.log(' Confidence');
|
|
952
|
+
console.log(` Min: ${confMin.toFixed(3)}`);
|
|
953
|
+
console.log(` Max: ${confMax.toFixed(3)}`);
|
|
954
|
+
console.log(` Mean: ${confMean.toFixed(3)}`);
|
|
955
|
+
console.log(` Median: ${confMedian.toFixed(3)}`);
|
|
956
|
+
console.log('');
|
|
957
|
+
|
|
958
|
+
console.log(' Access');
|
|
959
|
+
console.log(` Total accesses: ${totalAccess}`);
|
|
960
|
+
console.log(` Patterns used: ${accessedCount}/${nodes}`);
|
|
961
|
+
console.log(` Never accessed: ${nodes - accessedCount}`);
|
|
962
|
+
console.log(` Pending insights: ${pending}`);
|
|
963
|
+
console.log('');
|
|
964
|
+
|
|
965
|
+
console.log(' PageRank');
|
|
966
|
+
console.log(` Sum: ${prSum.toFixed(4)} (should be ~1.0)`);
|
|
967
|
+
console.log(` Top node: ${prMaxId || '(none)'} (${prMax.toFixed(4)})`);
|
|
968
|
+
console.log('');
|
|
969
|
+
|
|
970
|
+
if (topPatterns.length > 0) {
|
|
971
|
+
console.log(' Top Patterns (by composite score)');
|
|
972
|
+
console.log(' ' + '-'.repeat(60));
|
|
973
|
+
for (const p of topPatterns) {
|
|
974
|
+
console.log(` #${p.rank} ${p.summary}`);
|
|
975
|
+
console.log(` conf=${p.confidence} pr=${p.pageRank} score=${p.score} accessed=${p.accessed}x`);
|
|
976
|
+
}
|
|
977
|
+
console.log('');
|
|
978
|
+
}
|
|
979
|
+
|
|
980
|
+
if (delta) {
|
|
981
|
+
console.log(` Last Delta (${delta.elapsed} ago)`);
|
|
982
|
+
const sign = v => v > 0 ? `+${v}` : `${v}`;
|
|
983
|
+
console.log(` Nodes: ${sign(delta.nodes)}`);
|
|
984
|
+
console.log(` Edges: ${sign(delta.edges)}`);
|
|
985
|
+
console.log(` Confidence: ${delta.confidenceMean >= 0 ? '+' : ''}${delta.confidenceMean.toFixed(4)}`);
|
|
986
|
+
console.log(` Accesses: ${sign(delta.totalAccess)}`);
|
|
987
|
+
console.log('');
|
|
988
|
+
}
|
|
989
|
+
|
|
990
|
+
if (trend) {
|
|
991
|
+
console.log(` Trend (${trend.sessions} snapshots)`);
|
|
992
|
+
console.log(` Node growth: ${trend.nodeGrowth >= 0 ? '+' : ''}${trend.nodeGrowth}`);
|
|
993
|
+
console.log(` Edge growth: ${trend.edgeGrowth >= 0 ? '+' : ''}${trend.edgeGrowth}`);
|
|
994
|
+
console.log(` Confidence drift: ${trend.confidenceDrift >= 0 ? '+' : ''}${trend.confidenceDrift.toFixed(4)}`);
|
|
995
|
+
console.log(` Direction: ${trend.direction.toUpperCase()}`);
|
|
996
|
+
console.log('');
|
|
997
|
+
}
|
|
998
|
+
|
|
999
|
+
if (!delta && !trend) {
|
|
1000
|
+
console.log(' No history yet — run more sessions to see deltas and trends.');
|
|
1001
|
+
console.log('');
|
|
1002
|
+
}
|
|
1003
|
+
|
|
1004
|
+
console.log(bar);
|
|
1005
|
+
return report;
|
|
1006
|
+
}
|
|
1007
|
+
|
|
1008
|
+
module.exports = { init, getContext, recordEdit, feedback, consolidate, stats };
|
|
1009
|
+
|
|
1010
|
+
// ── CLI entrypoint ──────────────────────────────────────────────────────────
|
|
1011
|
+
if (require.main === module) {
|
|
1012
|
+
const cmd = process.argv[2];
|
|
1013
|
+
const jsonFlag = process.argv.includes('--json');
|
|
1014
|
+
|
|
1015
|
+
const cmds = {
|
|
1016
|
+
init: () => { const r = init(); console.log(JSON.stringify(r)); },
|
|
1017
|
+
stats: () => { stats(jsonFlag); },
|
|
1018
|
+
consolidate: () => { const r = consolidate(); console.log(JSON.stringify(r)); },
|
|
1019
|
+
};
|
|
1020
|
+
|
|
1021
|
+
if (cmd && cmds[cmd]) {
|
|
1022
|
+
cmds[cmd]();
|
|
1023
|
+
} else {
|
|
1024
|
+
console.log('Usage: intelligence.cjs <stats|init|consolidate> [--json]');
|
|
1025
|
+
console.log('');
|
|
1026
|
+
console.log(' stats Show intelligence diagnostics and trends');
|
|
1027
|
+
console.log(' stats --json Output as JSON for programmatic use');
|
|
1028
|
+
console.log(' init Build graph and rank entries');
|
|
1029
|
+
console.log(' consolidate Process pending insights and recompute');
|
|
1030
|
+
}
|
|
1031
|
+
}
|