@claude-flow/cli 3.32.9 → 3.32.11
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/.proven-config-version +1 -0
- 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/planner.md +374 -374
- 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/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/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/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/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/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 +339 -339
- 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 +484 -484
- package/.claude/commands/github/swarm-pr.md +287 -287
- package/.claude/commands/github/sync-coordinator.md +302 -302
- 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/eval/human-relevance-frozen-v1.json +17 -17
- package/.claude/evolve-proof/generation-0.json +211 -211
- package/.claude/evolve-proof/real-generation-0.json +406 -406
- package/.claude/evolve-proof/real-generation-1.json +406 -406
- package/.claude/helpers/.helpers-version +1 -1
- 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 +0 -0
- 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 +156 -156
- package/.claude/helpers/github-setup.sh +45 -45
- 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/helpers.manifest.json +2 -2
- package/.claude/helpers/hook-handler.cjs +0 -0
- package/.claude/helpers/intelligence.cjs +0 -0
- 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 +503 -503
- 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 +105 -105
- package/.claude/helpers/security-scanner.sh +127 -127
- package/.claude/helpers/session.js +157 -157
- 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 +0 -0
- package/.claude/helpers/statusline.js +340 -340
- 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/proven-config.json +42 -0
- package/.claude/proven-config.manifest.json +37 -37
- package/.claude/proven-config.signed.json +41 -41
- 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/browser/SKILL.md +204 -204
- package/.claude/skills/dual-mode/README.md +71 -71
- package/.claude/skills/dual-mode/dual-collect.md +103 -103
- package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
- package/.claude/skills/dual-mode/dual-spawn.md +81 -81
- package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
- package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
- package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
- package/.claude/skills/github-code-review/SKILL.md +1125 -1125
- package/.claude/skills/github-multi-repo/SKILL.md +862 -862
- package/.claude/skills/github-project-management/SKILL.md +1262 -1262
- package/.claude/skills/github-release-management/SKILL.md +1064 -1064
- package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
- package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
- package/.claude/skills/pair-programming/SKILL.md +1202 -1202
- package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
- package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
- package/.claude/skills/skill-builder/SKILL.md +910 -910
- package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
- package/.claude/skills/stream-chain/SKILL.md +560 -560
- package/.claude/skills/swarm-advanced/SKILL.md +970 -970
- 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 +691 -691
- package/README.md +419 -419
- package/bin/cli.js +314 -314
- package/bin/mcp-server.js +224 -224
- package/bin/preinstall.cjs +2 -2
- package/catalog-manifest.json +2 -2
- package/dist/src/autopilot-state.js +24 -7
- package/dist/src/benchmarks/gaia-critic.js +24 -24
- package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
- package/dist/src/commands/completions.js +409 -409
- package/dist/src/commands/daemon.js +44 -44
- package/dist/src/commands/embeddings.js +26 -26
- package/dist/src/commands/hive-mind.js +97 -97
- package/dist/src/commands/hooks.js +31 -10
- package/dist/src/commands/init.js +202 -34
- package/dist/src/commands/memory.js +12 -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/config/proven-config.js +2 -2
- package/dist/src/funnel/disclosure.js +13 -2
- package/dist/src/funnel/messages.d.ts +12 -10
- package/dist/src/funnel/messages.js +83 -11
- package/dist/src/init/claudemd-generator.js +231 -231
- package/dist/src/init/executor.js +453 -453
- package/dist/src/init/helper-signing.js +2 -2
- package/dist/src/init/helpers-generator.js +751 -751
- package/dist/src/init/statusline-generator.js +24 -24
- package/dist/src/mcp-tools/agentdb-tools.js +15 -15
- package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
- package/dist/src/mcp-tools/browser-tools.js +8 -0
- package/dist/src/mcp-tools/hooks-tools.js +21 -0
- package/dist/src/mcp-tools/memory-tools.js +4 -3
- package/dist/src/memory/graph-edge-writer.js +22 -22
- package/dist/src/memory/memory-bridge.js +248 -158
- package/dist/src/memory/memory-initializer.js +407 -407
- package/dist/src/memory/rabitq-index.js +5 -5
- package/dist/src/parser.js +25 -9
- package/dist/src/proxy/verify.js +2 -2
- package/dist/src/runtime/headless.js +28 -28
- package/dist/src/services/distill-tuning.js +7 -7
- package/dist/src/services/headless-worker-executor.js +84 -84
- package/dist/src/services/memory-distillation.js +4 -4
- package/dist/src/services/worker-daemon.js +7 -4
- package/dist/src/transfer/deploy-seraphine.js +23 -23
- package/package.json +137 -137
- package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
- package/plugins/ruflo-metaharness/README.md +72 -72
- package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
- package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
- package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
- package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
- package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
- package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
- package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
- package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
- package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
- package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
- package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
- package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
- package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
- package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
- package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
- package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
- package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
- package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
- package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
- package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
- package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
- package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
- package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
- package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
- package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
- package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
- package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
- package/plugins/ruflo-metaharness/scripts/smoke.sh +2356 -2356
- package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
- package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
- package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
- package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
- package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
- package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
- package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
- package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
- package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
- package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
- package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
- package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
- package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
- package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
- package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
- package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
- package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
- package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
- package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
- package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
- package/scripts/postinstall.cjs +153 -153
|
@@ -1,272 +1,272 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
// audit-trend.mjs — diff two oia-audit records to detect drift over time.
|
|
3
|
-
//
|
|
4
|
-
// The iter-7 oia-audit composite worker stores timestamped records under
|
|
5
|
-
// the `metaharness-audit` memory namespace. This script reads two such
|
|
6
|
-
// records and surfaces the delta:
|
|
7
|
-
// - composite worst severity change (clean → low, low → medium, etc.)
|
|
8
|
-
// - per-component (oia / threat-model / mcp-scan) status change
|
|
9
|
-
// - new HIGH-severity findings introduced
|
|
10
|
-
// - findings cleared
|
|
11
|
-
//
|
|
12
|
-
// Pairs with iter-7's oia-audit + iter-8's weekly cron — accumulated
|
|
13
|
-
// records enable drift detection without ad-hoc tooling.
|
|
14
|
-
//
|
|
15
|
-
// USAGE
|
|
16
|
-
// node scripts/audit-trend.mjs --baseline audit-<ts1>.json --current audit-<ts2>.json
|
|
17
|
-
// node scripts/audit-trend.mjs --baseline-key audit-2026-06-01... --current-key audit-2026-06-15...
|
|
18
|
-
// # pulls both from memory namespace `metaharness-audit`
|
|
19
|
-
// node scripts/audit-trend.mjs ... --alert-on-worsening
|
|
20
|
-
// node scripts/audit-trend.mjs ... --format json
|
|
21
|
-
//
|
|
22
|
-
// EXIT CODES
|
|
23
|
-
// 0 ok (no worsening, or --alert-on-worsening not set)
|
|
24
|
-
// 1 --alert-on-worsening AND composite severity worsened
|
|
25
|
-
// 2 config error or input not found
|
|
26
|
-
|
|
27
|
-
import { readFileSync, existsSync } from 'node:fs';
|
|
28
|
-
import { spawnSync } from 'node:child_process';
|
|
29
|
-
// iter 38 — structural-distance drift via ADR-152 §3.1 production module.
|
|
30
|
-
// Falls back to null if either record predates iter-38 oia-audit (no
|
|
31
|
-
// fingerprint field) — graceful degradation, never throws.
|
|
32
|
-
import { similarity } from './_similarity.mjs';
|
|
33
|
-
// iter 63 — shared SEVERITY_RANK from _harness.mjs (was a local literal
|
|
34
|
-
// missing info/warn/error/critical, which caused NaN-compare hazards).
|
|
35
|
-
import { SEVERITY_RANK, rankSeverity } from './_harness.mjs';
|
|
36
|
-
|
|
37
|
-
// iter 63 — SEVERITY_RANK moved to _harness.mjs (imported above)
|
|
38
|
-
const NS = process.env.AUDIT_TREND_NAMESPACE || 'metaharness-audit';
|
|
39
|
-
const CLI_PKG = process.env.CLI_CORE === '1'
|
|
40
|
-
? '@claude-flow/cli-core@alpha'
|
|
41
|
-
: '@claude-flow/cli@latest';
|
|
42
|
-
|
|
43
|
-
const ARGS = (() => {
|
|
44
|
-
const a = {
|
|
45
|
-
baseline: null, current: null,
|
|
46
|
-
baselineKey: null, currentKey: null,
|
|
47
|
-
alertOnWorsening: false, format: 'table',
|
|
48
|
-
// iter 38 — structural-distance gate (ADR-152 §3.1 dep)
|
|
49
|
-
alertOnDistanceBelow: null,
|
|
50
|
-
};
|
|
51
|
-
for (let i = 2; i < process.argv.length; i++) {
|
|
52
|
-
const v = process.argv[i];
|
|
53
|
-
if (v === '--baseline') a.baseline = process.argv[++i];
|
|
54
|
-
else if (v === '--current') a.current = process.argv[++i];
|
|
55
|
-
else if (v === '--baseline-key') a.baselineKey = process.argv[++i];
|
|
56
|
-
else if (v === '--current-key') a.currentKey = process.argv[++i];
|
|
57
|
-
else if (v === '--alert-on-worsening') a.alertOnWorsening = true;
|
|
58
|
-
else if (v === '--alert-on-distance-below') a.alertOnDistanceBelow = Number(process.argv[++i]);
|
|
59
|
-
else if (v === '--format') a.format = process.argv[++i];
|
|
60
|
-
}
|
|
61
|
-
return a;
|
|
62
|
-
})();
|
|
63
|
-
|
|
64
|
-
function memRetrieve(key) {
|
|
65
|
-
const r = spawnSync('npx', [
|
|
66
|
-
CLI_PKG, 'memory', 'retrieve',
|
|
67
|
-
'--namespace', NS, '--key', key,
|
|
68
|
-
], { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf-8', shell: process.platform === 'win32' });
|
|
69
|
-
if (r.status !== 0) return null;
|
|
70
|
-
const m = /\{[\s\S]*\}/.exec(r.stdout || '');
|
|
71
|
-
if (!m) return null;
|
|
72
|
-
try { return JSON.parse(m[0]); } catch { return null; }
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
function loadRecord(label, filePath, memKey) {
|
|
76
|
-
if (filePath) {
|
|
77
|
-
if (!existsSync(filePath)) {
|
|
78
|
-
console.error(`audit-trend: ${label} file not found: ${filePath}`);
|
|
79
|
-
process.exit(2);
|
|
80
|
-
}
|
|
81
|
-
try { return JSON.parse(readFileSync(filePath, 'utf-8')); }
|
|
82
|
-
catch (e) {
|
|
83
|
-
console.error(`audit-trend: ${label} file invalid JSON: ${e.message}`);
|
|
84
|
-
process.exit(2);
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
if (memKey) {
|
|
88
|
-
const rec = memRetrieve(memKey);
|
|
89
|
-
if (!rec) {
|
|
90
|
-
console.error(`audit-trend: ${label} key not found in namespace ${NS}: ${memKey}`);
|
|
91
|
-
process.exit(2);
|
|
92
|
-
}
|
|
93
|
-
return rec;
|
|
94
|
-
}
|
|
95
|
-
console.error(`audit-trend: --${label} or --${label}-key is required`);
|
|
96
|
-
process.exit(2);
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
function main() {
|
|
100
|
-
const baseline = loadRecord('baseline', ARGS.baseline, ARGS.baselineKey);
|
|
101
|
-
const current = loadRecord('current', ARGS.current, ARGS.currentKey);
|
|
102
|
-
|
|
103
|
-
// Sanity: both must look like oia-audit records (composite + components).
|
|
104
|
-
if (!baseline.composite || !current.composite) {
|
|
105
|
-
console.error('audit-trend: snapshots must contain `composite` (from oia-audit.mjs)');
|
|
106
|
-
process.exit(2);
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
const baseWorst = String(baseline.composite.worst || 'clean').toLowerCase();
|
|
110
|
-
const currWorst = String(current.composite.worst || 'clean').toLowerCase();
|
|
111
|
-
// iter 63 — safe rankSeverity() eliminates NaN-compare when either
|
|
112
|
-
// severity is unknown (was a latent bug in audit-trend's drift verdict).
|
|
113
|
-
const deltaRank = rankSeverity(currWorst) - rankSeverity(baseWorst);
|
|
114
|
-
const worsened = deltaRank > 0;
|
|
115
|
-
const improved = deltaRank < 0;
|
|
116
|
-
|
|
117
|
-
// Per-component status change. Each `components.{oiaManifest, threatModel,
|
|
118
|
-
// mcpScan}` has degraded:bool + exitCode + (for threat-model) json.worst.
|
|
119
|
-
const componentDelta = (label, b, c) => {
|
|
120
|
-
if (!b || !c) return { label, delta: 'missing' };
|
|
121
|
-
if (b.degraded !== c.degraded) {
|
|
122
|
-
return { label, delta: c.degraded ? 'became degraded' : 'recovered from degraded' };
|
|
123
|
-
}
|
|
124
|
-
if (b.exitCode !== c.exitCode) {
|
|
125
|
-
return { label, delta: `exit code ${b.exitCode} → ${c.exitCode}` };
|
|
126
|
-
}
|
|
127
|
-
return { label, delta: 'unchanged' };
|
|
128
|
-
};
|
|
129
|
-
const components = {
|
|
130
|
-
oiaManifest: componentDelta('oia-manifest', baseline.components?.oiaManifest, current.components?.oiaManifest),
|
|
131
|
-
threatModel: componentDelta('threat-model', baseline.components?.threatModel, current.components?.threatModel),
|
|
132
|
-
mcpScan: componentDelta('mcp-scan', baseline.components?.mcpScan, current.components?.mcpScan),
|
|
133
|
-
};
|
|
134
|
-
|
|
135
|
-
// mcp-scan findings — what was introduced vs cleared.
|
|
136
|
-
const baseFindings = Array.isArray(baseline.components?.mcpScan?.json?.findings)
|
|
137
|
-
? baseline.components.mcpScan.json.findings : [];
|
|
138
|
-
const currFindings = Array.isArray(current.components?.mcpScan?.json?.findings)
|
|
139
|
-
? current.components.mcpScan.json.findings : [];
|
|
140
|
-
const fingerprint = (f) => `${f.severity}:${f.id ?? '-'}:${f.server ?? '-'}:${f.tool ?? '-'}:${(f.message ?? '').slice(0, 80)}`;
|
|
141
|
-
const baseSet = new Set(baseFindings.map(fingerprint));
|
|
142
|
-
const currSet = new Set(currFindings.map(fingerprint));
|
|
143
|
-
const introduced = currFindings.filter((f) => !baseSet.has(fingerprint(f)));
|
|
144
|
-
const cleared = baseFindings.filter((f) => !currSet.has(fingerprint(f)));
|
|
145
|
-
|
|
146
|
-
// iter 38 — structural distance via ADR-152 §3.1 similarity().
|
|
147
|
-
// Both records need a fingerprint (score+genome) — iter-38 oia-audit
|
|
148
|
-
// adds it; older records skip with verdict 'unavailable'.
|
|
149
|
-
let structuralDistance = null;
|
|
150
|
-
if (baseline.fingerprint?.score && baseline.fingerprint?.genome
|
|
151
|
-
&& current.fingerprint?.score && current.fingerprint?.genome) {
|
|
152
|
-
const sim = similarity(baseline.fingerprint, current.fingerprint);
|
|
153
|
-
structuralDistance = {
|
|
154
|
-
overall: sim.overall,
|
|
155
|
-
// Distance is the complement of similarity in [0,1]
|
|
156
|
-
distance: Number((1 - sim.overall).toFixed(4)),
|
|
157
|
-
components: sim.components,
|
|
158
|
-
verdict: sim.overall >= 0.95 ? 'near-identical'
|
|
159
|
-
: sim.overall >= 0.80 ? 'minor-drift'
|
|
160
|
-
: sim.overall >= 0.50 ? 'moderate-drift'
|
|
161
|
-
: 'major-drift',
|
|
162
|
-
};
|
|
163
|
-
} else {
|
|
164
|
-
structuralDistance = {
|
|
165
|
-
verdict: 'unavailable',
|
|
166
|
-
reason: 'one or both records predate iter-38 oia-audit fingerprint bundling',
|
|
167
|
-
};
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
// Distance alert is independent of severity worsening — a harness can
|
|
171
|
-
// structurally drift while keeping the same worst-severity verdict.
|
|
172
|
-
const distanceAlertTriggered = ARGS.alertOnDistanceBelow != null
|
|
173
|
-
&& structuralDistance.overall != null
|
|
174
|
-
&& structuralDistance.overall < ARGS.alertOnDistanceBelow;
|
|
175
|
-
|
|
176
|
-
const payload = {
|
|
177
|
-
baseline: {
|
|
178
|
-
startedAt: baseline.startedAt,
|
|
179
|
-
composite: baseline.composite,
|
|
180
|
-
},
|
|
181
|
-
current: {
|
|
182
|
-
startedAt: current.startedAt,
|
|
183
|
-
composite: current.composite,
|
|
184
|
-
},
|
|
185
|
-
delta: {
|
|
186
|
-
worst: { baseline: baseWorst, current: currWorst, rankDelta: deltaRank,
|
|
187
|
-
verdict: worsened ? 'worsened' : (improved ? 'improved' : 'unchanged') },
|
|
188
|
-
components,
|
|
189
|
-
findings: {
|
|
190
|
-
introducedCount: introduced.length,
|
|
191
|
-
clearedCount: cleared.length,
|
|
192
|
-
introduced: introduced.slice(0, 20), // truncate for output sanity
|
|
193
|
-
cleared: cleared.slice(0, 20),
|
|
194
|
-
},
|
|
195
|
-
// iter 38 — structural distance via ADR-152 §3.1
|
|
196
|
-
structuralDistance,
|
|
197
|
-
},
|
|
198
|
-
alert: (ARGS.alertOnWorsening || ARGS.alertOnDistanceBelow != null) ? {
|
|
199
|
-
triggered: worsened || distanceAlertTriggered,
|
|
200
|
-
reasons: [
|
|
201
|
-
ARGS.alertOnWorsening && worsened
|
|
202
|
-
? `composite worst ${baseWorst} → ${currWorst}` : null,
|
|
203
|
-
distanceAlertTriggered
|
|
204
|
-
? `structural similarity ${structuralDistance.overall} < threshold ${ARGS.alertOnDistanceBelow}` : null,
|
|
205
|
-
].filter(Boolean),
|
|
206
|
-
} : null,
|
|
207
|
-
generatedAt: new Date().toISOString(),
|
|
208
|
-
};
|
|
209
|
-
|
|
210
|
-
if (ARGS.format === 'json') {
|
|
211
|
-
console.log(JSON.stringify(payload, null, 2));
|
|
212
|
-
} else {
|
|
213
|
-
console.log(`# audit-trend`);
|
|
214
|
-
console.log('');
|
|
215
|
-
console.log(`Baseline: ${baseline.startedAt}`);
|
|
216
|
-
console.log(`Current: ${current.startedAt}`);
|
|
217
|
-
console.log('');
|
|
218
|
-
console.log(`| Metric | Baseline | Current | Verdict |`);
|
|
219
|
-
console.log(`|---|---|---|---|`);
|
|
220
|
-
const verdictIcon = worsened ? '⚠ worsened' : (improved ? '✓ improved' : '— unchanged');
|
|
221
|
-
console.log(`| composite worst | ${baseWorst} | ${currWorst} | ${verdictIcon} |`);
|
|
222
|
-
for (const [label, c] of Object.entries(components)) {
|
|
223
|
-
console.log(`| ${label} | — | — | ${c.delta} |`);
|
|
224
|
-
}
|
|
225
|
-
console.log('');
|
|
226
|
-
console.log(`Findings: **+${introduced.length} introduced**, **−${cleared.length} cleared**`);
|
|
227
|
-
if (introduced.length > 0) {
|
|
228
|
-
console.log('');
|
|
229
|
-
console.log('## Introduced findings');
|
|
230
|
-
console.log('');
|
|
231
|
-
console.log('| Severity | Server | Tool | Message |');
|
|
232
|
-
console.log('|---|---|---|---|');
|
|
233
|
-
for (const f of introduced.slice(0, 20)) {
|
|
234
|
-
console.log(`| ${f.severity ?? '-'} | ${f.server ?? '-'} | ${f.tool ?? '-'} | ${(f.message ?? '').slice(0, 80)} |`);
|
|
235
|
-
}
|
|
236
|
-
}
|
|
237
|
-
if (cleared.length > 0) {
|
|
238
|
-
console.log('');
|
|
239
|
-
console.log('## Cleared findings');
|
|
240
|
-
console.log('');
|
|
241
|
-
for (const f of cleared.slice(0, 5)) {
|
|
242
|
-
console.log(`- ${f.severity ?? '-'} ${f.id ?? '-'} (${f.server ?? '-'}/${f.tool ?? '-'})`);
|
|
243
|
-
}
|
|
244
|
-
}
|
|
245
|
-
console.log('');
|
|
246
|
-
// iter 38 — structural distance row
|
|
247
|
-
if (structuralDistance.verdict !== 'unavailable') {
|
|
248
|
-
console.log(`## Structural distance (ADR-152 §3.1)`);
|
|
249
|
-
console.log('');
|
|
250
|
-
console.log(`| Metric | Value |`);
|
|
251
|
-
console.log(`|---|---:|`);
|
|
252
|
-
console.log(`| overall similarity | ${structuralDistance.overall.toFixed(4)} |`);
|
|
253
|
-
console.log(`| distance (1 − sim) | ${structuralDistance.distance.toFixed(4)} |`);
|
|
254
|
-
console.log(`| verdict | **${structuralDistance.verdict}** |`);
|
|
255
|
-
console.log('');
|
|
256
|
-
} else {
|
|
257
|
-
console.log(`Structural distance: _unavailable — ${structuralDistance.reason}_`);
|
|
258
|
-
console.log('');
|
|
259
|
-
}
|
|
260
|
-
if (payload.alert) {
|
|
261
|
-
if (payload.alert.triggered) {
|
|
262
|
-
console.log(`⚠ **ALERT**: ${payload.alert.reasons.join('; ')}`);
|
|
263
|
-
} else {
|
|
264
|
-
console.log(`✓ no alert triggered`);
|
|
265
|
-
}
|
|
266
|
-
}
|
|
267
|
-
}
|
|
268
|
-
|
|
269
|
-
if (payload.alert?.triggered) process.exit(1);
|
|
270
|
-
}
|
|
271
|
-
|
|
272
|
-
main();
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// audit-trend.mjs — diff two oia-audit records to detect drift over time.
|
|
3
|
+
//
|
|
4
|
+
// The iter-7 oia-audit composite worker stores timestamped records under
|
|
5
|
+
// the `metaharness-audit` memory namespace. This script reads two such
|
|
6
|
+
// records and surfaces the delta:
|
|
7
|
+
// - composite worst severity change (clean → low, low → medium, etc.)
|
|
8
|
+
// - per-component (oia / threat-model / mcp-scan) status change
|
|
9
|
+
// - new HIGH-severity findings introduced
|
|
10
|
+
// - findings cleared
|
|
11
|
+
//
|
|
12
|
+
// Pairs with iter-7's oia-audit + iter-8's weekly cron — accumulated
|
|
13
|
+
// records enable drift detection without ad-hoc tooling.
|
|
14
|
+
//
|
|
15
|
+
// USAGE
|
|
16
|
+
// node scripts/audit-trend.mjs --baseline audit-<ts1>.json --current audit-<ts2>.json
|
|
17
|
+
// node scripts/audit-trend.mjs --baseline-key audit-2026-06-01... --current-key audit-2026-06-15...
|
|
18
|
+
// # pulls both from memory namespace `metaharness-audit`
|
|
19
|
+
// node scripts/audit-trend.mjs ... --alert-on-worsening
|
|
20
|
+
// node scripts/audit-trend.mjs ... --format json
|
|
21
|
+
//
|
|
22
|
+
// EXIT CODES
|
|
23
|
+
// 0 ok (no worsening, or --alert-on-worsening not set)
|
|
24
|
+
// 1 --alert-on-worsening AND composite severity worsened
|
|
25
|
+
// 2 config error or input not found
|
|
26
|
+
|
|
27
|
+
import { readFileSync, existsSync } from 'node:fs';
|
|
28
|
+
import { spawnSync } from 'node:child_process';
|
|
29
|
+
// iter 38 — structural-distance drift via ADR-152 §3.1 production module.
|
|
30
|
+
// Falls back to null if either record predates iter-38 oia-audit (no
|
|
31
|
+
// fingerprint field) — graceful degradation, never throws.
|
|
32
|
+
import { similarity } from './_similarity.mjs';
|
|
33
|
+
// iter 63 — shared SEVERITY_RANK from _harness.mjs (was a local literal
|
|
34
|
+
// missing info/warn/error/critical, which caused NaN-compare hazards).
|
|
35
|
+
import { SEVERITY_RANK, rankSeverity } from './_harness.mjs';
|
|
36
|
+
|
|
37
|
+
// iter 63 — SEVERITY_RANK moved to _harness.mjs (imported above)
|
|
38
|
+
const NS = process.env.AUDIT_TREND_NAMESPACE || 'metaharness-audit';
|
|
39
|
+
const CLI_PKG = process.env.CLI_CORE === '1'
|
|
40
|
+
? '@claude-flow/cli-core@alpha'
|
|
41
|
+
: '@claude-flow/cli@latest';
|
|
42
|
+
|
|
43
|
+
const ARGS = (() => {
|
|
44
|
+
const a = {
|
|
45
|
+
baseline: null, current: null,
|
|
46
|
+
baselineKey: null, currentKey: null,
|
|
47
|
+
alertOnWorsening: false, format: 'table',
|
|
48
|
+
// iter 38 — structural-distance gate (ADR-152 §3.1 dep)
|
|
49
|
+
alertOnDistanceBelow: null,
|
|
50
|
+
};
|
|
51
|
+
for (let i = 2; i < process.argv.length; i++) {
|
|
52
|
+
const v = process.argv[i];
|
|
53
|
+
if (v === '--baseline') a.baseline = process.argv[++i];
|
|
54
|
+
else if (v === '--current') a.current = process.argv[++i];
|
|
55
|
+
else if (v === '--baseline-key') a.baselineKey = process.argv[++i];
|
|
56
|
+
else if (v === '--current-key') a.currentKey = process.argv[++i];
|
|
57
|
+
else if (v === '--alert-on-worsening') a.alertOnWorsening = true;
|
|
58
|
+
else if (v === '--alert-on-distance-below') a.alertOnDistanceBelow = Number(process.argv[++i]);
|
|
59
|
+
else if (v === '--format') a.format = process.argv[++i];
|
|
60
|
+
}
|
|
61
|
+
return a;
|
|
62
|
+
})();
|
|
63
|
+
|
|
64
|
+
function memRetrieve(key) {
|
|
65
|
+
const r = spawnSync('npx', [
|
|
66
|
+
CLI_PKG, 'memory', 'retrieve',
|
|
67
|
+
'--namespace', NS, '--key', key,
|
|
68
|
+
], { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf-8', shell: process.platform === 'win32' });
|
|
69
|
+
if (r.status !== 0) return null;
|
|
70
|
+
const m = /\{[\s\S]*\}/.exec(r.stdout || '');
|
|
71
|
+
if (!m) return null;
|
|
72
|
+
try { return JSON.parse(m[0]); } catch { return null; }
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function loadRecord(label, filePath, memKey) {
|
|
76
|
+
if (filePath) {
|
|
77
|
+
if (!existsSync(filePath)) {
|
|
78
|
+
console.error(`audit-trend: ${label} file not found: ${filePath}`);
|
|
79
|
+
process.exit(2);
|
|
80
|
+
}
|
|
81
|
+
try { return JSON.parse(readFileSync(filePath, 'utf-8')); }
|
|
82
|
+
catch (e) {
|
|
83
|
+
console.error(`audit-trend: ${label} file invalid JSON: ${e.message}`);
|
|
84
|
+
process.exit(2);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
if (memKey) {
|
|
88
|
+
const rec = memRetrieve(memKey);
|
|
89
|
+
if (!rec) {
|
|
90
|
+
console.error(`audit-trend: ${label} key not found in namespace ${NS}: ${memKey}`);
|
|
91
|
+
process.exit(2);
|
|
92
|
+
}
|
|
93
|
+
return rec;
|
|
94
|
+
}
|
|
95
|
+
console.error(`audit-trend: --${label} or --${label}-key is required`);
|
|
96
|
+
process.exit(2);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
function main() {
|
|
100
|
+
const baseline = loadRecord('baseline', ARGS.baseline, ARGS.baselineKey);
|
|
101
|
+
const current = loadRecord('current', ARGS.current, ARGS.currentKey);
|
|
102
|
+
|
|
103
|
+
// Sanity: both must look like oia-audit records (composite + components).
|
|
104
|
+
if (!baseline.composite || !current.composite) {
|
|
105
|
+
console.error('audit-trend: snapshots must contain `composite` (from oia-audit.mjs)');
|
|
106
|
+
process.exit(2);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
const baseWorst = String(baseline.composite.worst || 'clean').toLowerCase();
|
|
110
|
+
const currWorst = String(current.composite.worst || 'clean').toLowerCase();
|
|
111
|
+
// iter 63 — safe rankSeverity() eliminates NaN-compare when either
|
|
112
|
+
// severity is unknown (was a latent bug in audit-trend's drift verdict).
|
|
113
|
+
const deltaRank = rankSeverity(currWorst) - rankSeverity(baseWorst);
|
|
114
|
+
const worsened = deltaRank > 0;
|
|
115
|
+
const improved = deltaRank < 0;
|
|
116
|
+
|
|
117
|
+
// Per-component status change. Each `components.{oiaManifest, threatModel,
|
|
118
|
+
// mcpScan}` has degraded:bool + exitCode + (for threat-model) json.worst.
|
|
119
|
+
const componentDelta = (label, b, c) => {
|
|
120
|
+
if (!b || !c) return { label, delta: 'missing' };
|
|
121
|
+
if (b.degraded !== c.degraded) {
|
|
122
|
+
return { label, delta: c.degraded ? 'became degraded' : 'recovered from degraded' };
|
|
123
|
+
}
|
|
124
|
+
if (b.exitCode !== c.exitCode) {
|
|
125
|
+
return { label, delta: `exit code ${b.exitCode} → ${c.exitCode}` };
|
|
126
|
+
}
|
|
127
|
+
return { label, delta: 'unchanged' };
|
|
128
|
+
};
|
|
129
|
+
const components = {
|
|
130
|
+
oiaManifest: componentDelta('oia-manifest', baseline.components?.oiaManifest, current.components?.oiaManifest),
|
|
131
|
+
threatModel: componentDelta('threat-model', baseline.components?.threatModel, current.components?.threatModel),
|
|
132
|
+
mcpScan: componentDelta('mcp-scan', baseline.components?.mcpScan, current.components?.mcpScan),
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
// mcp-scan findings — what was introduced vs cleared.
|
|
136
|
+
const baseFindings = Array.isArray(baseline.components?.mcpScan?.json?.findings)
|
|
137
|
+
? baseline.components.mcpScan.json.findings : [];
|
|
138
|
+
const currFindings = Array.isArray(current.components?.mcpScan?.json?.findings)
|
|
139
|
+
? current.components.mcpScan.json.findings : [];
|
|
140
|
+
const fingerprint = (f) => `${f.severity}:${f.id ?? '-'}:${f.server ?? '-'}:${f.tool ?? '-'}:${(f.message ?? '').slice(0, 80)}`;
|
|
141
|
+
const baseSet = new Set(baseFindings.map(fingerprint));
|
|
142
|
+
const currSet = new Set(currFindings.map(fingerprint));
|
|
143
|
+
const introduced = currFindings.filter((f) => !baseSet.has(fingerprint(f)));
|
|
144
|
+
const cleared = baseFindings.filter((f) => !currSet.has(fingerprint(f)));
|
|
145
|
+
|
|
146
|
+
// iter 38 — structural distance via ADR-152 §3.1 similarity().
|
|
147
|
+
// Both records need a fingerprint (score+genome) — iter-38 oia-audit
|
|
148
|
+
// adds it; older records skip with verdict 'unavailable'.
|
|
149
|
+
let structuralDistance = null;
|
|
150
|
+
if (baseline.fingerprint?.score && baseline.fingerprint?.genome
|
|
151
|
+
&& current.fingerprint?.score && current.fingerprint?.genome) {
|
|
152
|
+
const sim = similarity(baseline.fingerprint, current.fingerprint);
|
|
153
|
+
structuralDistance = {
|
|
154
|
+
overall: sim.overall,
|
|
155
|
+
// Distance is the complement of similarity in [0,1]
|
|
156
|
+
distance: Number((1 - sim.overall).toFixed(4)),
|
|
157
|
+
components: sim.components,
|
|
158
|
+
verdict: sim.overall >= 0.95 ? 'near-identical'
|
|
159
|
+
: sim.overall >= 0.80 ? 'minor-drift'
|
|
160
|
+
: sim.overall >= 0.50 ? 'moderate-drift'
|
|
161
|
+
: 'major-drift',
|
|
162
|
+
};
|
|
163
|
+
} else {
|
|
164
|
+
structuralDistance = {
|
|
165
|
+
verdict: 'unavailable',
|
|
166
|
+
reason: 'one or both records predate iter-38 oia-audit fingerprint bundling',
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// Distance alert is independent of severity worsening — a harness can
|
|
171
|
+
// structurally drift while keeping the same worst-severity verdict.
|
|
172
|
+
const distanceAlertTriggered = ARGS.alertOnDistanceBelow != null
|
|
173
|
+
&& structuralDistance.overall != null
|
|
174
|
+
&& structuralDistance.overall < ARGS.alertOnDistanceBelow;
|
|
175
|
+
|
|
176
|
+
const payload = {
|
|
177
|
+
baseline: {
|
|
178
|
+
startedAt: baseline.startedAt,
|
|
179
|
+
composite: baseline.composite,
|
|
180
|
+
},
|
|
181
|
+
current: {
|
|
182
|
+
startedAt: current.startedAt,
|
|
183
|
+
composite: current.composite,
|
|
184
|
+
},
|
|
185
|
+
delta: {
|
|
186
|
+
worst: { baseline: baseWorst, current: currWorst, rankDelta: deltaRank,
|
|
187
|
+
verdict: worsened ? 'worsened' : (improved ? 'improved' : 'unchanged') },
|
|
188
|
+
components,
|
|
189
|
+
findings: {
|
|
190
|
+
introducedCount: introduced.length,
|
|
191
|
+
clearedCount: cleared.length,
|
|
192
|
+
introduced: introduced.slice(0, 20), // truncate for output sanity
|
|
193
|
+
cleared: cleared.slice(0, 20),
|
|
194
|
+
},
|
|
195
|
+
// iter 38 — structural distance via ADR-152 §3.1
|
|
196
|
+
structuralDistance,
|
|
197
|
+
},
|
|
198
|
+
alert: (ARGS.alertOnWorsening || ARGS.alertOnDistanceBelow != null) ? {
|
|
199
|
+
triggered: worsened || distanceAlertTriggered,
|
|
200
|
+
reasons: [
|
|
201
|
+
ARGS.alertOnWorsening && worsened
|
|
202
|
+
? `composite worst ${baseWorst} → ${currWorst}` : null,
|
|
203
|
+
distanceAlertTriggered
|
|
204
|
+
? `structural similarity ${structuralDistance.overall} < threshold ${ARGS.alertOnDistanceBelow}` : null,
|
|
205
|
+
].filter(Boolean),
|
|
206
|
+
} : null,
|
|
207
|
+
generatedAt: new Date().toISOString(),
|
|
208
|
+
};
|
|
209
|
+
|
|
210
|
+
if (ARGS.format === 'json') {
|
|
211
|
+
console.log(JSON.stringify(payload, null, 2));
|
|
212
|
+
} else {
|
|
213
|
+
console.log(`# audit-trend`);
|
|
214
|
+
console.log('');
|
|
215
|
+
console.log(`Baseline: ${baseline.startedAt}`);
|
|
216
|
+
console.log(`Current: ${current.startedAt}`);
|
|
217
|
+
console.log('');
|
|
218
|
+
console.log(`| Metric | Baseline | Current | Verdict |`);
|
|
219
|
+
console.log(`|---|---|---|---|`);
|
|
220
|
+
const verdictIcon = worsened ? '⚠ worsened' : (improved ? '✓ improved' : '— unchanged');
|
|
221
|
+
console.log(`| composite worst | ${baseWorst} | ${currWorst} | ${verdictIcon} |`);
|
|
222
|
+
for (const [label, c] of Object.entries(components)) {
|
|
223
|
+
console.log(`| ${label} | — | — | ${c.delta} |`);
|
|
224
|
+
}
|
|
225
|
+
console.log('');
|
|
226
|
+
console.log(`Findings: **+${introduced.length} introduced**, **−${cleared.length} cleared**`);
|
|
227
|
+
if (introduced.length > 0) {
|
|
228
|
+
console.log('');
|
|
229
|
+
console.log('## Introduced findings');
|
|
230
|
+
console.log('');
|
|
231
|
+
console.log('| Severity | Server | Tool | Message |');
|
|
232
|
+
console.log('|---|---|---|---|');
|
|
233
|
+
for (const f of introduced.slice(0, 20)) {
|
|
234
|
+
console.log(`| ${f.severity ?? '-'} | ${f.server ?? '-'} | ${f.tool ?? '-'} | ${(f.message ?? '').slice(0, 80)} |`);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
if (cleared.length > 0) {
|
|
238
|
+
console.log('');
|
|
239
|
+
console.log('## Cleared findings');
|
|
240
|
+
console.log('');
|
|
241
|
+
for (const f of cleared.slice(0, 5)) {
|
|
242
|
+
console.log(`- ${f.severity ?? '-'} ${f.id ?? '-'} (${f.server ?? '-'}/${f.tool ?? '-'})`);
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
console.log('');
|
|
246
|
+
// iter 38 — structural distance row
|
|
247
|
+
if (structuralDistance.verdict !== 'unavailable') {
|
|
248
|
+
console.log(`## Structural distance (ADR-152 §3.1)`);
|
|
249
|
+
console.log('');
|
|
250
|
+
console.log(`| Metric | Value |`);
|
|
251
|
+
console.log(`|---|---:|`);
|
|
252
|
+
console.log(`| overall similarity | ${structuralDistance.overall.toFixed(4)} |`);
|
|
253
|
+
console.log(`| distance (1 − sim) | ${structuralDistance.distance.toFixed(4)} |`);
|
|
254
|
+
console.log(`| verdict | **${structuralDistance.verdict}** |`);
|
|
255
|
+
console.log('');
|
|
256
|
+
} else {
|
|
257
|
+
console.log(`Structural distance: _unavailable — ${structuralDistance.reason}_`);
|
|
258
|
+
console.log('');
|
|
259
|
+
}
|
|
260
|
+
if (payload.alert) {
|
|
261
|
+
if (payload.alert.triggered) {
|
|
262
|
+
console.log(`⚠ **ALERT**: ${payload.alert.reasons.join('; ')}`);
|
|
263
|
+
} else {
|
|
264
|
+
console.log(`✓ no alert triggered`);
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
if (payload.alert?.triggered) process.exit(1);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
main();
|