agentic-flow 1.9.4 → 1.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +246 -0
  2. package/dist/proxy/adaptive-proxy.js +224 -0
  3. package/dist/proxy/anthropic-to-gemini.js +2 -2
  4. package/dist/proxy/http2-proxy-optimized.js +191 -0
  5. package/dist/proxy/http2-proxy.js +381 -0
  6. package/dist/proxy/http3-proxy-old.js +331 -0
  7. package/dist/proxy/http3-proxy.js +51 -0
  8. package/dist/proxy/websocket-proxy.js +406 -0
  9. package/dist/utils/adaptive-pool-sizing.js +414 -0
  10. package/dist/utils/auth.js +52 -0
  11. package/dist/utils/circular-rate-limiter.js +391 -0
  12. package/dist/utils/compression-middleware.js +149 -0
  13. package/dist/utils/connection-pool.js +184 -0
  14. package/dist/utils/dynamic-compression.js +298 -0
  15. package/dist/utils/http2-multiplexing.js +319 -0
  16. package/dist/utils/lazy-auth.js +311 -0
  17. package/dist/utils/rate-limiter.js +48 -0
  18. package/dist/utils/response-cache.js +211 -0
  19. package/dist/utils/server-push.js +251 -0
  20. package/dist/utils/streaming-optimizer.js +141 -0
  21. package/dist/utils/zero-copy-buffer.js +286 -0
  22. package/docs/.claude-flow/metrics/performance.json +3 -3
  23. package/docs/.claude-flow/metrics/task-metrics.json +3 -3
  24. package/docs/DOCKER-VERIFICATION.md +207 -0
  25. package/docs/ISSUE-55-VALIDATION.md +171 -0
  26. package/docs/NPX_AGENTDB_SETUP.md +175 -0
  27. package/docs/OPTIMIZATIONS.md +460 -0
  28. package/docs/PHASE2-IMPLEMENTATION-SUMMARY.md +275 -0
  29. package/docs/PHASE2-PHASE3-COMPLETE-SUMMARY.md +453 -0
  30. package/docs/PHASE3-IMPLEMENTATION-SUMMARY.md +357 -0
  31. package/docs/PUBLISH_GUIDE.md +438 -0
  32. package/docs/README.md +217 -0
  33. package/docs/RELEASE-v1.10.0-COMPLETE.md +382 -0
  34. package/docs/archive/.agentdb-instructions.md +66 -0
  35. package/docs/archive/AGENT-BOOSTER-STATUS.md +292 -0
  36. package/docs/archive/CHANGELOG-v1.3.0.md +120 -0
  37. package/docs/archive/COMPLETION_REPORT_v1.7.1.md +335 -0
  38. package/docs/archive/IMPLEMENTATION_SUMMARY_v1.7.1.md +241 -0
  39. package/docs/archive/SUPABASE-INTEGRATION-COMPLETE.md +357 -0
  40. package/docs/archive/TESTING_QUICK_START.md +223 -0
  41. package/docs/archive/TOOL-EMULATION-INTEGRATION-ISSUE.md +669 -0
  42. package/docs/archive/VALIDATION_v1.7.1.md +234 -0
  43. package/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
  44. package/docs/releases/PUBLISH_CHECKLIST_v1.10.0.md +396 -0
  45. package/docs/releases/PUBLISH_SUMMARY_v1.7.1.md +198 -0
  46. package/docs/releases/RELEASE_NOTES_v1.10.0.md +464 -0
  47. package/docs/releases/RELEASE_NOTES_v1.7.0.md +297 -0
  48. package/docs/releases/RELEASE_v1.7.1.md +327 -0
  49. package/package.json +1 -1
  50. package/scripts/claude +31 -0
  51. package/validation/docker-npm-validation.sh +170 -0
  52. package/validation/simple-npm-validation.sh +131 -0
  53. package/validation/test-gemini-exclusiveMinimum-fix.ts +142 -0
  54. package/validation/test-gemini-models.ts +200 -0
  55. package/validation/validate-v1.10.0-docker.sh +296 -0
  56. package/wasm/reasoningbank/reasoningbank_wasm_bg.js +2 -2
  57. package/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
  58. package/docs/INDEX.md +0 -279
  59. package/docs/guides/.claude-flow/metrics/agent-metrics.json +0 -1
  60. package/docs/guides/.claude-flow/metrics/performance.json +0 -9
  61. package/docs/guides/.claude-flow/metrics/task-metrics.json +0 -10
  62. package/docs/router/.claude-flow/metrics/agent-metrics.json +0 -1
  63. package/docs/router/.claude-flow/metrics/performance.json +0 -9
  64. package/docs/router/.claude-flow/metrics/task-metrics.json +0 -10
  65. /package/docs/{TEST-V1.7.8.Dockerfile → docker-tests/TEST-V1.7.8.Dockerfile} +0 -0
  66. /package/docs/{TEST-V1.7.9-NODE20.Dockerfile → docker-tests/TEST-V1.7.9-NODE20.Dockerfile} +0 -0
  67. /package/docs/{TEST-V1.7.9.Dockerfile → docker-tests/TEST-V1.7.9.Dockerfile} +0 -0
  68. /package/docs/{v1.7.1-QUICK-START.md → guides/QUICK-START-v1.7.1.md} +0 -0
  69. /package/docs/{INTEGRATION-COMPLETE.md → integration-docs/INTEGRATION-COMPLETE.md} +0 -0
  70. /package/docs/{LANDING-PAGE-PROVIDER-CONTENT.md → providers/LANDING-PAGE-PROVIDER-CONTENT.md} +0 -0
  71. /package/docs/{PROVIDER-FALLBACK-GUIDE.md → providers/PROVIDER-FALLBACK-GUIDE.md} +0 -0
  72. /package/docs/{PROVIDER-FALLBACK-SUMMARY.md → providers/PROVIDER-FALLBACK-SUMMARY.md} +0 -0
  73. /package/docs/{QUIC_FINAL_STATUS.md → quic/QUIC_FINAL_STATUS.md} +0 -0
  74. /package/docs/{README_QUIC_PHASE1.md → quic/README_QUIC_PHASE1.md} +0 -0
  75. /package/docs/{AGENTDB_TESTING.md → testing/AGENTDB_TESTING.md} +0 -0
@@ -0,0 +1,296 @@
1
+ #!/bin/bash
2
+ # v1.10.0 Docker Validation Script
3
+ # Validates all multi-protocol proxy features in isolated environment
4
+
5
+ set -e
6
+
7
+ echo "🔍 v1.10.0 Multi-Protocol Proxy Validation"
8
+ echo "=========================================="
9
+ echo ""
10
+
11
+ # Colors
12
+ GREEN='\033[0;32m'
13
+ RED='\033[0;31m'
14
+ YELLOW='\033[1;33m'
15
+ NC='\033[0m' # No Color
16
+
17
+ # Configuration
18
+ DOCKER_IMAGE="agentic-flow-v1.10.0-test"
19
+ TEST_API_KEY="test-api-key-$(date +%s)"
20
+
21
+ # Cleanup function
22
+ cleanup() {
23
+ echo ""
24
+ echo "🧹 Cleaning up..."
25
+ docker ps -a | grep "$DOCKER_IMAGE" | awk '{print $1}' | xargs -r docker stop 2>/dev/null || true
26
+ docker ps -a | grep "$DOCKER_IMAGE" | awk '{print $1}' | xargs -r docker rm 2>/dev/null || true
27
+ }
28
+
29
+ trap cleanup EXIT
30
+
31
+ # Test results
32
+ TESTS_PASSED=0
33
+ TESTS_FAILED=0
34
+
35
+ test_result() {
36
+ local test_name=$1
37
+ local result=$2
38
+
39
+ if [ $result -eq 0 ]; then
40
+ echo -e "${GREEN}✅ PASS${NC}: $test_name"
41
+ ((TESTS_PASSED++))
42
+ else
43
+ echo -e "${RED}❌ FAIL${NC}: $test_name"
44
+ ((TESTS_FAILED++))
45
+ fi
46
+ }
47
+
48
+ # Step 1: Build Docker image
49
+ echo "📦 Step 1: Building Docker image..."
50
+ docker build -f Dockerfile.multi-protocol -t $DOCKER_IMAGE . > /dev/null 2>&1
51
+ test_result "Docker image build" $?
52
+
53
+ # Step 2: Test TypeScript compilation
54
+ echo ""
55
+ echo "🔧 Step 2: Validating TypeScript compilation..."
56
+ docker run --rm $DOCKER_IMAGE npm run build > /tmp/docker-build.log 2>&1
57
+ if grep -q "error TS" /tmp/docker-build.log; then
58
+ # Check if errors are only in unrelated files
59
+ if grep -q "error TS" /tmp/docker-build.log | grep -v "federation\|memory/Shared\|onnx-local\|supabase-adapter"; then
60
+ test_result "TypeScript compilation (proxy files)" 1
61
+ else
62
+ test_result "TypeScript compilation (proxy files)" 0
63
+ fi
64
+ else
65
+ test_result "TypeScript compilation" 0
66
+ fi
67
+
68
+ # Step 3: Test HTTP/1.1 Proxy
69
+ echo ""
70
+ echo "🌐 Step 3: Testing HTTP/1.1 Proxy..."
71
+ docker run -d --name ${DOCKER_IMAGE}-http1 \
72
+ -e GOOGLE_GEMINI_API_KEY=test-key \
73
+ -p 3000:3000 \
74
+ $DOCKER_IMAGE \
75
+ node dist/proxy/anthropic-to-gemini.js > /dev/null 2>&1
76
+
77
+ sleep 3
78
+
79
+ # Check if proxy started
80
+ if curl -s http://localhost:3000/health > /dev/null 2>&1; then
81
+ test_result "HTTP/1.1 Proxy startup" 0
82
+ else
83
+ test_result "HTTP/1.1 Proxy startup" 1
84
+ fi
85
+
86
+ docker stop ${DOCKER_IMAGE}-http1 > /dev/null 2>&1
87
+ docker rm ${DOCKER_IMAGE}-http1 > /dev/null 2>&1
88
+
89
+ # Step 4: Test HTTP/2 Proxy
90
+ echo ""
91
+ echo "🚀 Step 4: Testing HTTP/2 Proxy..."
92
+ docker run -d --name ${DOCKER_IMAGE}-http2 \
93
+ -e GOOGLE_GEMINI_API_KEY=test-key \
94
+ -e PROXY_API_KEYS=$TEST_API_KEY \
95
+ -p 3001:3001 \
96
+ $DOCKER_IMAGE \
97
+ node dist/proxy/http2-proxy.js > /dev/null 2>&1
98
+
99
+ sleep 3
100
+
101
+ # Check if proxy started
102
+ if docker logs ${DOCKER_IMAGE}-http2 2>&1 | grep -q "HTTP/2 Proxy running"; then
103
+ test_result "HTTP/2 Proxy startup" 0
104
+ else
105
+ test_result "HTTP/2 Proxy startup" 1
106
+ fi
107
+
108
+ # Check security features
109
+ if docker logs ${DOCKER_IMAGE}-http2 2>&1 | grep -q "Rate limiting enabled"; then
110
+ test_result "HTTP/2 Rate limiting configuration" 0
111
+ else
112
+ test_result "HTTP/2 Rate limiting configuration" 1
113
+ fi
114
+
115
+ docker stop ${DOCKER_IMAGE}-http2 > /dev/null 2>&1
116
+ docker rm ${DOCKER_IMAGE}-http2 > /dev/null 2>&1
117
+
118
+ # Step 5: Test Optimized HTTP/2 Proxy
119
+ echo ""
120
+ echo "⚡ Step 5: Testing Optimized HTTP/2 Proxy..."
121
+ docker run -d --name ${DOCKER_IMAGE}-optimized \
122
+ -e GOOGLE_GEMINI_API_KEY=test-key \
123
+ -e PROXY_API_KEYS=$TEST_API_KEY \
124
+ -p 3002:3001 \
125
+ $DOCKER_IMAGE \
126
+ node dist/proxy/http2-proxy-optimized.js > /dev/null 2>&1
127
+
128
+ sleep 3
129
+
130
+ # Check if optimizations are enabled
131
+ if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Connection pooling enabled"; then
132
+ test_result "Connection pooling enabled" 0
133
+ else
134
+ test_result "Connection pooling enabled" 1
135
+ fi
136
+
137
+ if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Response caching enabled"; then
138
+ test_result "Response caching enabled" 0
139
+ else
140
+ test_result "Response caching enabled" 1
141
+ fi
142
+
143
+ if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Streaming optimization enabled"; then
144
+ test_result "Streaming optimization enabled" 0
145
+ else
146
+ test_result "Streaming optimization enabled" 1
147
+ fi
148
+
149
+ if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Compression enabled"; then
150
+ test_result "Compression enabled" 0
151
+ else
152
+ test_result "Compression enabled" 1
153
+ fi
154
+
155
+ docker stop ${DOCKER_IMAGE}-optimized > /dev/null 2>&1
156
+ docker rm ${DOCKER_IMAGE}-optimized > /dev/null 2>&1
157
+
158
+ # Step 6: Test WebSocket Proxy
159
+ echo ""
160
+ echo "🔌 Step 6: Testing WebSocket Proxy..."
161
+ docker run -d --name ${DOCKER_IMAGE}-ws \
162
+ -e GOOGLE_GEMINI_API_KEY=test-key \
163
+ -p 8080:8080 \
164
+ $DOCKER_IMAGE \
165
+ node dist/proxy/websocket-proxy.js > /dev/null 2>&1
166
+
167
+ sleep 3
168
+
169
+ if docker logs ${DOCKER_IMAGE}-ws 2>&1 | grep -q "WebSocket proxy running"; then
170
+ test_result "WebSocket Proxy startup" 0
171
+ else
172
+ test_result "WebSocket Proxy startup" 1
173
+ fi
174
+
175
+ # Check DoS protection
176
+ if docker logs ${DOCKER_IMAGE}-ws 2>&1 | grep -q "DoS protection"; then
177
+ test_result "WebSocket DoS protection" 0
178
+ else
179
+ test_result "WebSocket DoS protection" 1
180
+ fi
181
+
182
+ docker stop ${DOCKER_IMAGE}-ws > /dev/null 2>&1
183
+ docker rm ${DOCKER_IMAGE}-ws > /dev/null 2>&1
184
+
185
+ # Step 7: Test Adaptive Proxy
186
+ echo ""
187
+ echo "🎯 Step 7: Testing Adaptive Multi-Protocol Proxy..."
188
+ docker run -d --name ${DOCKER_IMAGE}-adaptive \
189
+ -e GOOGLE_GEMINI_API_KEY=test-key \
190
+ -p 3003:3000 \
191
+ $DOCKER_IMAGE \
192
+ node dist/proxy/adaptive-proxy.js > /dev/null 2>&1
193
+
194
+ sleep 3
195
+
196
+ if docker logs ${DOCKER_IMAGE}-adaptive 2>&1 | grep -q "Adaptive"; then
197
+ test_result "Adaptive Proxy startup" 0
198
+ else
199
+ test_result "Adaptive Proxy startup" 1
200
+ fi
201
+
202
+ docker stop ${DOCKER_IMAGE}-adaptive > /dev/null 2>&1
203
+ docker rm ${DOCKER_IMAGE}-adaptive > /dev/null 2>&1
204
+
205
+ # Step 8: Test Utility Files
206
+ echo ""
207
+ echo "🛠️ Step 8: Testing Utility Files..."
208
+
209
+ # Check if utility files were built
210
+ docker run --rm $DOCKER_IMAGE ls dist/utils/ > /tmp/utils-files.txt 2>&1
211
+
212
+ if grep -q "connection-pool.js" /tmp/utils-files.txt; then
213
+ test_result "Connection pool utility compiled" 0
214
+ else
215
+ test_result "Connection pool utility compiled" 1
216
+ fi
217
+
218
+ if grep -q "response-cache.js" /tmp/utils-files.txt; then
219
+ test_result "Response cache utility compiled" 0
220
+ else
221
+ test_result "Response cache utility compiled" 1
222
+ fi
223
+
224
+ if grep -q "streaming-optimizer.js" /tmp/utils-files.txt; then
225
+ test_result "Streaming optimizer utility compiled" 0
226
+ else
227
+ test_result "Streaming optimizer utility compiled" 1
228
+ fi
229
+
230
+ if grep -q "compression-middleware.js" /tmp/utils-files.txt; then
231
+ test_result "Compression middleware utility compiled" 0
232
+ else
233
+ test_result "Compression middleware utility compiled" 1
234
+ fi
235
+
236
+ if grep -q "rate-limiter.js" /tmp/utils-files.txt; then
237
+ test_result "Rate limiter utility compiled" 0
238
+ else
239
+ test_result "Rate limiter utility compiled" 1
240
+ fi
241
+
242
+ if grep -q "auth.js" /tmp/utils-files.txt; then
243
+ test_result "Auth utility compiled" 0
244
+ else
245
+ test_result "Auth utility compiled" 1
246
+ fi
247
+
248
+ # Step 9: Test Documentation
249
+ echo ""
250
+ echo "📚 Step 9: Validating Documentation..."
251
+
252
+ if [ -f "docs/OPTIMIZATIONS.md" ]; then
253
+ test_result "OPTIMIZATIONS.md exists" 0
254
+ else
255
+ test_result "OPTIMIZATIONS.md exists" 1
256
+ fi
257
+
258
+ if grep -q "Connection Pooling" docs/OPTIMIZATIONS.md 2>/dev/null; then
259
+ test_result "Documentation includes optimizations" 0
260
+ else
261
+ test_result "Documentation includes optimizations" 1
262
+ fi
263
+
264
+ # Step 10: Test CHANGELOG
265
+ echo ""
266
+ echo "📝 Step 10: Validating CHANGELOG..."
267
+
268
+ if grep -q "1.10.0" CHANGELOG.md; then
269
+ test_result "CHANGELOG includes v1.10.0" 0
270
+ else
271
+ test_result "CHANGELOG includes v1.10.0" 1
272
+ fi
273
+
274
+ if grep -q "Phase 1 Optimizations" CHANGELOG.md; then
275
+ test_result "CHANGELOG includes optimization details" 0
276
+ else
277
+ test_result "CHANGELOG includes optimization details" 1
278
+ fi
279
+
280
+ # Summary
281
+ echo ""
282
+ echo "=========================================="
283
+ echo "📊 VALIDATION SUMMARY"
284
+ echo "=========================================="
285
+ echo -e "Total Tests: $((TESTS_PASSED + TESTS_FAILED))"
286
+ echo -e "${GREEN}Passed: $TESTS_PASSED${NC}"
287
+ echo -e "${RED}Failed: $TESTS_FAILED${NC}"
288
+ echo ""
289
+
290
+ if [ $TESTS_FAILED -eq 0 ]; then
291
+ echo -e "${GREEN}✅ ALL TESTS PASSED - Ready for v1.10.0 release!${NC}"
292
+ exit 0
293
+ else
294
+ echo -e "${YELLOW}⚠️ Some tests failed - Review before publishing${NC}"
295
+ exit 1
296
+ fi
@@ -258,7 +258,7 @@ export function log(message) {
258
258
  wasm.log(ptr0, len0);
259
259
  }
260
260
 
261
- function __wbg_adapter_6(arg0, arg1, arg2) {
261
+ function __wbg_adapter_4(arg0, arg1, arg2) {
262
262
  wasm.__wbindgen_export_5(arg0, arg1, addHeapObject(arg2));
263
263
  }
264
264
 
@@ -540,7 +540,7 @@ export function __wbindgen_cast_2241b6af4c4b2941(arg0, arg1) {
540
540
 
541
541
  export function __wbindgen_cast_8eb6fd44e7238d11(arg0, arg1) {
542
542
  // Cast intrinsic for `Closure(Closure { dtor_idx: 62, function: Function { arguments: [Externref], shim_idx: 63, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
543
- const ret = makeMutClosure(arg0, arg1, 62, __wbg_adapter_6);
543
+ const ret = makeMutClosure(arg0, arg1, 62, __wbg_adapter_4);
544
544
  return addHeapObject(ret);
545
545
  };
546
546
 
package/docs/INDEX.md DELETED
@@ -1,279 +0,0 @@
1
- # Agentic Flow Documentation Index
2
-
3
- Complete documentation for the Agentic Flow multi-agent orchestration system.
4
-
5
- ## 📋 Quick Navigation
6
-
7
- ### 🚀 Start Here
8
- - **[README](../README.md)** - Project overview and getting started
9
- - **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC methodology
10
- - **[PACKAGE_STRUCTURE.md](architecture/PACKAGE_STRUCTURE.md)** - Package organization and structure
11
- - **[STANDALONE_PROXY_GUIDE.md](guides/STANDALONE_PROXY_GUIDE.md)** - Standalone proxy server setup
12
-
13
- ---
14
-
15
- ## 📚 Documentation Categories
16
-
17
- ### 📖 [User Guides](guides/)
18
- Practical guides and tutorials for using the system.
19
-
20
- - [Agent SDK Guide](guides/agent-sdk.md) - Building custom agents
21
- - [Docker Agent Usage](guides/DOCKER_AGENT_USAGE.md) - Running agents in containers
22
- - [Alternative LLM Models](guides/ALTERNATIVE_LLM_MODELS.md) - Using different language models
23
- - [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Real-world patterns
24
- - [NPM Publishing Guide](guides/NPM-PUBLISH.md) - Package publishing
25
- - [ONNX CLI Usage](guides/ONNX_CLI_USAGE.md) - ONNX command-line interface
26
- - [ONNX Optimization Guide](guides/ONNX_OPTIMIZATION_GUIDE.md) - Performance optimization
27
- - [OpenRouter Deployment](guides/OPENROUTER_DEPLOYMENT.md) - OpenRouter setup
28
-
29
- ### 🏗️ [Architecture](architecture/)
30
- System design, planning, and technical architecture.
31
-
32
- - [Executive Summary](architecture/EXECUTIVE_SUMMARY.md) - High-level overview
33
- - [Integration Status](architecture/INTEGRATION-STATUS.md) - Current integration status
34
- - [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical research findings
35
- - [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture
36
- - [Improvement Plan](architecture/IMPROVEMENT_PLAN.md) - System improvement roadmap
37
- - [Quick Wins](architecture/QUICK_WINS.md) - High-impact improvements
38
-
39
- ### 🔌 [Integrations](integrations/)
40
- Integration guides for external services and frameworks.
41
-
42
- - [Claude Agents Integration](integrations/CLAUDE_AGENTS_INTEGRATION.md) - Claude agents setup
43
- - [Claude Flow Integration](integrations/CLAUDE_FLOW_INTEGRATION.md) - Claude Flow orchestration
44
- - [Flow Nexus Integration](integrations/FLOW-NEXUS-INTEGRATION.md) - Cloud platform integration
45
- - [FastMCP CLI Integration](integrations/FASTMCP_CLI_INTEGRATION.md) - MCP command-line tools
46
- - [FastMCP Implementation Plan](integrations/fastmcp-implementation-plan.md) - Detailed MCP strategy
47
- - [FastMCP POC Integration](integrations/fastmcp-poc-integration.md) - Proof of concept
48
-
49
- ### 🔧 [Router Documentation](router/)
50
- Multi-model router configuration and usage.
51
-
52
- - [Router Overview](router/README.md) - Router system overview
53
- - [Router User Guide](router/ROUTER_USER_GUIDE.md) - Using the router
54
- - [Router Config Reference](router/ROUTER_CONFIG_REFERENCE.md) - Configuration options
55
- - [Top 20 Models Matrix](router/TOP20_MODELS_MATRIX.md) - Model comparison guide
56
-
57
- ### ✅ [Testing & Validation](testing/)
58
- Current test results and development testing documentation.
59
-
60
- - [Testing Overview](testing/README.md) - Current testing documentation
61
- - [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md) - Multi-agent testing
62
- - [Final Testing Summary](testing/FINAL-TESTING-SUMMARY.md) - Comprehensive coverage
63
- - [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md) - Regression testing
64
- - [Streaming & MCP Validation](testing/STREAMING-AND-MCP-VALIDATION.md) - Integration tests
65
-
66
- For production validation reports, see [Validation Reports](validation-reports/)
67
-
68
- ### 🔍 [MCP Validation](mcp-validation/)
69
- Model Context Protocol implementation and validation.
70
-
71
- - [MCP Validation Overview](mcp-validation/README.md) - MCP testing documentation
72
- - [Implementation Summary](mcp-validation/IMPLEMENTATION-SUMMARY.md) - MCP implementation
73
- - [CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md) - CLI tool testing
74
- - [Strange Loops Test](mcp-validation/strange-loops-test.md) - Advanced patterns
75
-
76
- ### 📦 [Version Releases](version-releases/)
77
- Version-specific release notes and publishing documentation.
78
-
79
- - [Release Overview](version-releases/README.md) - Release documentation index
80
- - [v1.5.11 Publication Report](version-releases/PUBLICATION_REPORT_v1.5.11.md) - Latest release
81
- - [v1.5.9 Release Summary](version-releases/v1.5.9-RELEASE-SUMMARY.md) - Previous release
82
- - [v1.5.9 Docker Verification](version-releases/v1.5.9-DOCKER-VERIFICATION.md) - Docker validation
83
-
84
- ### 🧠 [ReasoningBank](reasoningbank/)
85
- Cognitive memory system with pattern recognition and adaptive learning.
86
-
87
- - [ReasoningBank Overview](reasoningbank/README.md) - Feature documentation index
88
- - [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md) - System architecture
89
- - [Backends](reasoningbank/REASONINGBANK_BACKENDS.md) - Storage backend options
90
- - [Validation](reasoningbank/REASONINGBANK_VALIDATION.md) - Testing and validation
91
- - [Benchmarks](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md) - Performance metrics
92
-
93
- ### ✅ [Validation Reports](validation-reports/)
94
- Comprehensive testing, benchmarking, and quality assurance reports.
95
-
96
- - [Validation Overview](validation-reports/README.md) - Testing documentation index
97
- - [Performance Benchmarks](validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md) - Optimization analysis
98
- - [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md) - Container testing
99
- - [Regression Tests](validation-reports/NO_REGRESSIONS_CONFIRMED.md) - Stability verification
100
- - [Alpha Validation](validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md) - Release validation
101
-
102
- ### 🔌 [Integration Documentation](integration-docs/)
103
- System integrations, implementations, and compatibility reports.
104
-
105
- - [Integration Overview](integration-docs/README.md) - Integration documentation index
106
- - [Agent Booster](integration-docs/AGENT-BOOSTER-INTEGRATION.md) - Ultra-fast code editing
107
- - [Claude Flow](integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md) - Orchestration integration
108
- - [WASM Integration](integration-docs/WASM_INTEGRATION_COMPLETE.md) - WebAssembly support
109
- - [CLI Tools](integration-docs/CLI-INTEGRATION-COMPLETE.md) - Command-line integration
110
-
111
- ### 🔬 [Quantum Research](quantum-research/)
112
- Quantum computing research, literature reviews, and experimental plans.
113
-
114
- - [Quantum Overview](quantum-research/README.md) - Research documentation index
115
- - [Literature Review](quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md) - Comprehensive research
116
- - [Observer-Agnostic Experiment](../examples/Observer-Agnostic%20Measurement%20and%20No-Retrocausal%20Marginals%20Theorem/) - Quantum measurement testing
117
-
118
- ### 🗄️ [Validation Archive](validation/)
119
- Historical validation reports and test archives.
120
-
121
- - [Validation Archive](validation/README.md) - Archived test reports
122
-
123
- ### 📦 [Archived](archived/)
124
- Historical documentation, completed implementations, and validation reports.
125
-
126
- #### Validation Reports (Archived)
127
- - Version-specific validation (v1.1.10, v1.1.11)
128
- - MCP proxy validation
129
- - OpenRouter integration validation
130
- - Docker deployment validation
131
- - SDK integration reports
132
- - Model validation reports
133
-
134
- #### Completed Implementations
135
- - [Research Complete](archived/RESEARCH_COMPLETE.txt) - Historical research
136
- - [FastMCP Complete](archived/FASTMCP_COMPLETE.md) - FastMCP completion
137
- - [Flow Nexus Complete](archived/FLOW-NEXUS-COMPLETE.md) - Flow Nexus completion
138
- - [OpenRouter Proxy Complete](archived/OPENROUTER_PROXY_COMPLETE.md) - OpenRouter completion
139
- - [Package Complete](archived/PACKAGE-COMPLETE.md) - Package completion
140
- - [SDK Setup Complete](archived/SDK-SETUP-COMPLETE.md) - SDK setup completion
141
- - ONNX implementation reports
142
- - Integration confirmation reports
143
-
144
- #### Historical Guides
145
- - ONNX integration guides (superseded by current guides)
146
- - Optimization summaries (superseded)
147
- - Provider instruction optimization
148
- - Tool instruction enhancements
149
-
150
- #### Research & Planning
151
- - ONNX Phi4 research
152
- - ONNX Runtime integration planning
153
- - Phi4 hyperoptimization plans
154
-
155
- ---
156
-
157
- ## 🎯 Reading Paths
158
-
159
- ### Path 1: New Users (30 minutes)
160
- 1. [Main README](../README.md) - Project overview (10 min)
161
- 2. [Claude Config](CLAUDE.md) - Development setup (10 min)
162
- 3. [User Guides](guides/) - Practical tutorials (10 min)
163
-
164
- ### Path 2: Developers (1.5 hours)
165
- 1. [Architecture Overview](architecture/EXECUTIVE_SUMMARY.md) - System design (20 min)
166
- 2. [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Code patterns (40 min)
167
- 3. [Integration Guides](integrations/) - External services (20 min)
168
- 4. [Testing Documentation](testing/) - Quality assurance (10 min)
169
-
170
- ### Path 3: System Architects (2 hours)
171
- 1. [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical findings (30 min)
172
- 2. [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture (45 min)
173
- 3. [Integration Status](architecture/INTEGRATION-STATUS.md) - Current state (20 min)
174
- 4. [Router Documentation](router/) - Configuration and usage (15 min)
175
- 5. [MCP Validation](mcp-validation/) - Protocol implementation (10 min)
176
-
177
- ---
178
-
179
- ## 📊 Key Features
180
-
181
- ### Multi-Agent Orchestration
182
- - Hierarchical, mesh, and hybrid topologies
183
- - Parallel and sequential execution patterns
184
- - Claude Flow integration for coordination
185
- - 54+ specialized agent types
186
-
187
- ### SPARC Methodology
188
- - Specification → Pseudocode → Architecture → Refinement → Completion
189
- - Test-driven development workflow
190
- - Automated task orchestration
191
- - Neural pattern learning
192
-
193
- ### Model Router
194
- - Multi-model support (Claude, OpenRouter, ONNX, Gemini)
195
- - Intelligent model selection
196
- - Cost optimization
197
- - Performance monitoring
198
-
199
- ### Cloud Integration
200
- - Flow Nexus platform support
201
- - E2B sandbox execution
202
- - Real-time streaming and monitoring
203
- - 70+ MCP orchestration tools
204
-
205
- ---
206
-
207
- ## 🔗 External Resources
208
-
209
- ### Official Documentation
210
- - [Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk/overview)
211
- - [Model Context Protocol](https://modelcontextprotocol.io/)
212
- - [Agentic Flow GitHub](https://github.com/ruvnet/agentic-flow)
213
- - [Flow Nexus Platform](https://flow-nexus.ruv.io)
214
-
215
- ### Community
216
- - [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
217
-
218
- ---
219
-
220
- ## 📞 Getting Help
221
-
222
- ### Documentation Questions
223
- 1. Check the relevant category above
224
- 2. Review the README for each section
225
- 3. Search for specific topics in the index
226
-
227
- ### Implementation Support
228
- 1. Review [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md)
229
- 2. Check [Integration Guides](integrations/)
230
- 3. Consult [Router Documentation](router/)
231
-
232
- ### Architecture Questions
233
- 1. Read [Architecture Documentation](architecture/)
234
- 2. Review [Router Documentation](router/)
235
- 3. Check [Integration Status](architecture/INTEGRATION-STATUS.md)
236
-
237
- ---
238
-
239
- ## 🎯 Quick Links
240
-
241
- - **License**: [MIT License](LICENSE)
242
- - **Changelog**: [CHANGELOG.md](../CHANGELOG.md)
243
- - **Contributing**: See main [README](../README.md)
244
- - **Issues**: [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
245
-
246
- ---
247
-
248
- ## 📂 Documentation Organization
249
-
250
- ### Active Documentation
251
- All current and actively maintained documentation is organized in the category directories above.
252
-
253
- ### Archived Content
254
- Historical reports, completed implementations, and superseded guides are in the [archived/](archived/) directory for reference.
255
-
256
- ---
257
-
258
- **Documentation Status**: ✅ Reorganized and up-to-date
259
- **Last Updated**: October 14, 2025
260
-
261
- ## 📋 Recent Documentation Updates
262
-
263
- **v2.7.0 Reorganization (Oct 14, 2025)**:
264
- - Created `reasoningbank/` for all ReasoningBank feature documentation
265
- - Created `validation-reports/` for production testing and validation
266
- - Created `integration-docs/` for system integration documentation
267
- - Created `quantum-research/` for quantum computing research
268
- - Created `version-releases/` for release notes and changelogs
269
- - Added comprehensive README files to all new categories
270
- - Consolidated loose files into organized subdirectories
271
- - Improved navigation and discoverability
272
-
273
- **v2.0 Reorganization (Oct 6, 2025)**:
274
- - Created dedicated `releases/` directory for version-specific documentation
275
- - Consolidated testing reports into `testing/` directory
276
- - Separated MCP validation into dedicated `mcp-validation/` section
277
- - Added comprehensive READMEs to all major sections
278
- - Archived historical v1.1.x releases for cleaner navigation
279
- - Improved documentation index with better categorization
@@ -1,9 +0,0 @@
1
- {
2
- "startTime": 1759674877006,
3
- "totalTasks": 1,
4
- "successfulTasks": 1,
5
- "failedTasks": 0,
6
- "totalAgents": 0,
7
- "activeAgents": 0,
8
- "neuralEvents": 0
9
- }
@@ -1,10 +0,0 @@
1
- [
2
- {
3
- "id": "cmd-hooks-1759674877140",
4
- "type": "hooks",
5
- "success": true,
6
- "duration": 7.498020000000054,
7
- "timestamp": 1759674877147,
8
- "metadata": {}
9
- }
10
- ]
@@ -1,9 +0,0 @@
1
- {
2
- "startTime": 1759674801537,
3
- "totalTasks": 1,
4
- "successfulTasks": 1,
5
- "failedTasks": 0,
6
- "totalAgents": 0,
7
- "activeAgents": 0,
8
- "neuralEvents": 0
9
- }
@@ -1,10 +0,0 @@
1
- [
2
- {
3
- "id": "cmd-hooks-1759674801675",
4
- "type": "hooks",
5
- "success": true,
6
- "duration": 6.8613129999999956,
7
- "timestamp": 1759674801682,
8
- "metadata": {}
9
- }
10
- ]