agentic-flow 2.0.1-alpha → 2.0.1-alpha.3

package/agentic-flow/docs/README.md

@@ -1,217 +0,0 @@
-# Agentic-Flow Documentation
-
-Complete documentation for the agentic-flow platform - AI agent orchestration with 66 specialized agents, 213 MCP tools, ReasoningBank learning memory, and autonomous multi-agent swarms.
-
-## 📚 Documentation Structure
-
-### Core Documentation
-- **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC development environment setup
-
-### Quick Start & Guides
-- **[guides/](guides/)** - User guides, tutorials, and how-to documentation
-  - [Quick Start Guide](guides/QUICK-START-v1.7.1.md)
-  - [MCP Tools](guides/MCP-TOOLS.md)
-  - [Claude Code Integration](guides/CLAUDE-CODE-INTEGRATION.md)
-  - [Agent Booster](guides/AGENT-BOOSTER.md)
-  - [ReasoningBank](guides/REASONINGBANK.md)
-  - [Multi-Model Router](guides/MULTI-MODEL-ROUTER.md)
-  - [Deployment Guide](guides/DEPLOYMENT.md)
-
-### Architecture & Design
-- **[architecture/](architecture/)** - System architecture and design documents
-  - [Executive Summary](architecture/EXECUTIVE_SUMMARY.md)
-  - [Package Structure](architecture/PACKAGE_STRUCTURE.md)
-  - [QUIC Implementation](architecture/QUIC-IMPLEMENTATION-SUMMARY.md)
-  - [Integration Status](architecture/INTEGRATION-STATUS.md)
-  - [Improvement Plan](architecture/IMPROVEMENT_PLAN.md)
-
-### Integration Documentation
-- **[integration-docs/](integration-docs/)** - Integration guides and implementation summaries
-- **[integrations/](integrations/)** - Specific integration implementations
-  - [Claude Flow Integration](integrations/CLAUDE_FLOW_INTEGRATION.md)
-  - [Flow Nexus Integration](integrations/FLOW-NEXUS-INTEGRATION.md)
-  - [FastMCP Integration](integrations/FASTMCP_CLI_INTEGRATION.md)
-
-### Feature Documentation
-
-#### Provider & Router
-- **[providers/](providers/)** - Provider fallback and configuration
-  - [Provider Fallback Guide](providers/PROVIDER-FALLBACK-GUIDE.md)
-  - [Provider Fallback Summary](providers/PROVIDER-FALLBACK-SUMMARY.md)
-  - [Landing Page Provider Content](providers/LANDING-PAGE-PROVIDER-CONTENT.md)
-- **[router/](router/)** - Multi-model router documentation
-  - [Router User Guide](router/ROUTER_USER_GUIDE.md)
-  - [Router Config Reference](router/ROUTER_CONFIG_REFERENCE.md)
-
-#### QUIC Transport
-- **[quic/](quic/)** - QUIC protocol implementation
-  - [QUIC Status](quic/QUIC-STATUS.md)
-  - [Implementation Complete](quic/IMPLEMENTATION-COMPLETE-SUMMARY.md)
-  - [Final Validation](quic/FINAL-VALIDATION.md)
-  - [Performance Validation](quic/PERFORMANCE-VALIDATION.md)
-
-#### ReasoningBank
-- **[reasoningbank/](reasoningbank/)** - ReasoningBank learning memory system
-  - [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md)
-  - [Backends](reasoningbank/REASONINGBANK_BACKENDS.md)
-  - [Benchmark Results](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md)
-  - [Validation](reasoningbank/REASONINGBANK-VALIDATION.md)
-
-#### Supabase Integration
-- **[supabase/](supabase/)** - Supabase realtime federation
-  - [Quick Start](supabase/QUICKSTART.md)
-  - [Implementation Summary](supabase/IMPLEMENTATION-SUMMARY.md)
-  - [Test Report](supabase/TEST-REPORT.md)
-
-#### Federation
-- **[federation/](federation/)** - Agent federation and deployment
-  - [Deployment Validation](federation/DEPLOYMENT-VALIDATION-SUCCESS.md)
-  - [Debug Streaming](federation/DEBUG-STREAMING-COMPLETE.md)
-
-### Testing & Validation
-- **[testing/](testing/)** - Test documentation and results
-  - [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md)
-  - [Final Testing Summary](testing/FINAL-TESTING-SUMMARY.md)
-  - [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md)
-- **[validation/](validation/)** - Validation reports and processes
-- **[validation-reports/](validation-reports/)** - Detailed validation results
-  - [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md)
-  - [No Regressions Confirmed](validation-reports/NO_REGRESSIONS_CONFIRMED.md)
-- **[docker-tests/](docker-tests/)** - Docker test configurations
-
-### MCP Validation
-- **[mcp-validation/](mcp-validation/)** - Model Context Protocol validation
-  - [MCP CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md)
-  - [Implementation Summary](mcp-validation/IMPLEMENTATION-SUMMARY.md)
-
-### Benchmarks & Performance
-- **[benchmarks/](benchmarks/)** - Performance benchmarks
-  - [QUIC Results](benchmarks/quic-results.md)
-  - [Optimization Guide](benchmarks/optimization-guide.md)
-
-### Release Information
-- **[releases/](releases/)** - Release notes and GitHub issues
-  - [v1.8.13 Release](releases/RELEASE-v1.8.13.md)
-  - [v1.5.14 QUIC Transport](releases/v1.5.14-QUIC-TRANSPORT.md)
-  - [v1.4.6 ReasoningBank](releases/v1.4.6-reasoningbank-release.md)
-- **[version-releases/](version-releases/)** - Version-specific release documentation
-
-### Planning & Research
-- **[plans/](plans/)** - Feature plans and roadmaps
-  - [QUIC Implementation](plans/QUIC/)
-  - [Agent Booster](plans/agent-booster/)
-  - [Requesty](plans/requesty/)
-- **[quantum-goap/](quantum-goap/)** - Goal-Oriented Action Planning
-- **[quantum-research/](quantum-research/)** - Quantum research literature
-
-### Issues & Reports
-- **[issues/](issues/)** - Known issues and troubleshooting
-  - [Supabase Integration Issue](issues/ISSUE-SUPABASE-INTEGRATION.md)
-  - [Xenova Transformers Dependency](issues/ISSUE-xenova-transformers-dependency.md)
-- **[reports/](reports/)** - Status reports and completion summaries
-- **[reviews/](reviews/)** - Code and implementation reviews
-
-### Archived Documentation
-- **[archived/](archived/)** - Historical documentation (kept for reference)
-  - Old validation reports
-  - Deprecated integration guides
-  - Previous version documentation
-
-## 🚀 Quick Links
-
-### Getting Started
-1. [Quick Start Guide](guides/QUICK-START-v1.7.1.md)
-2. [Claude Code Setup](CLAUDE.md)
-3. [Installation Guide](guides/DEPLOYMENT.md)
-
-### Core Features
-- [66 Specialized Agents](CLAUDE.md#-available-agents-54-total)
-- [213 MCP Tools](guides/MCP-TOOLS.md)
-- [ReasoningBank Learning](reasoningbank/README.md)
-- [Multi-Model Router](router/README.md)
-- [QUIC Transport](quic/QUIC-STATUS.md)
-
-### Integration
-- [Claude Flow](integrations/CLAUDE_FLOW_INTEGRATION.md)
-- [Flow Nexus](integrations/FLOW-NEXUS-INTEGRATION.md)
-- [FastMCP](integrations/FASTMCP_CLI_INTEGRATION.md)
-- [Supabase](supabase/README.md)
-
-### Development
-- [Architecture Overview](architecture/EXECUTIVE_SUMMARY.md)
-- [SPARC Methodology](CLAUDE.md#sparc-workflow-phases)
-- [Testing Guide](testing/README.md)
-
-## 📖 Documentation Standards
-
-### File Organization
-- Use descriptive filenames in UPPERCASE-WITH-DASHES.md format
-- Group related docs in topic-specific directories
-- Keep root directory minimal (README, CLAUDE, LICENSE only)
-
-### Content Guidelines
-- Start with a clear title and description
-- Include table of contents for docs > 200 lines
-- Use code blocks with language identifiers
-- Add examples and use cases where applicable
-
-### Directory Structure
-```
-docs/
-├── README.md              # This file
-├── CLAUDE.md             # Claude Code config
-├── LICENSE               # License file
-├── architecture/         # System architecture
-├── guides/              # User guides
-├── integration-docs/    # Integration documentation
-├── integrations/        # Specific integrations
-├── testing/            # Test documentation
-├── releases/           # Release notes
-├── issues/             # Known issues
-├── providers/          # Provider configuration
-├── quic/              # QUIC implementation
-├── reasoningbank/     # ReasoningBank docs
-├── router/            # Router documentation
-├── supabase/          # Supabase integration
-└── archived/          # Historical docs
-```
-
-## 🔍 Search Tips
-
-### Finding Documentation
-- Use `grep -r "keyword" docs/` to search all docs
-- Check the appropriate category directory first
-- Look in archived/ for historical documentation
-
-### Common Topics
-- **Setup**: See guides/ and CLAUDE.md
-- **API Reference**: See integration-docs/
-- **Troubleshooting**: See issues/
-- **Performance**: See benchmarks/
-- **Releases**: See releases/ and version-releases/
-
-## 🤝 Contributing to Docs
-
-### Adding New Documentation
-1. Identify the appropriate directory
-2. Follow naming conventions
-3. Include proper frontmatter/headers
-4. Update this README index
-5. Add cross-references as needed
-
-### Updating Existing Docs
-1. Keep archived versions if major changes
-2. Update last modified date
-3. Maintain backward compatibility links
-4. Test all code examples
-
-## 📞 Support
-
-- **GitHub Issues**: https://github.com/ruvnet/agentic-flow/issues
-- **Documentation Updates**: Submit PR to docs/ directory
-- **Questions**: Check issues/ directory first
-
----
-
-**Last Updated**: November 6, 2025
-**Version**: 1.9.1

package/packages/agentic-jujutsu/.cargo/config.toml

@@ -1,14 +0,0 @@
-[target.x86_64-apple-darwin]
-rustflags = [
-  "-C", "link-arg=-undefined",
-  "-C", "link-arg=dynamic_lookup",
-]
-
-[target.aarch64-apple-darwin]
-rustflags = [
-  "-C", "link-arg=-undefined",
-  "-C", "link-arg=dynamic_lookup",
-]
-
-[target.x86_64-pc-windows-msvc]
-rustflags = ["-C", "link-arg=/FORCE:UNRESOLVED"]

package/packages/agentic-jujutsu/.claude-flow/metrics/agent-metrics.json

@@ -1 +0,0 @@
-{}

package/packages/agentic-jujutsu/.claude-flow/metrics/performance.json

@@ -1,87 +0,0 @@
-{
-  "startTime": 1764004764031,
-  "sessionId": "session-1764004764031",
-  "lastActivity": 1764004764031,
-  "sessionDuration": 0,
-  "totalTasks": 1,
-  "successfulTasks": 1,
-  "failedTasks": 0,
-  "totalAgents": 0,
-  "activeAgents": 0,
-  "neuralEvents": 0,
-  "memoryMode": {
-    "reasoningbankOperations": 0,
-    "basicOperations": 0,
-    "autoModeSelections": 0,
-    "modeOverrides": 0,
-    "currentMode": "auto"
-  },
-  "operations": {
-    "store": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "retrieve": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "query": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "list": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "delete": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "search": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    },
-    "init": {
-      "count": 0,
-      "totalDuration": 0,
-      "errors": 0
-    }
-  },
-  "performance": {
-    "avgOperationDuration": 0,
-    "minOperationDuration": null,
-    "maxOperationDuration": null,
-    "slowOperations": 0,
-    "fastOperations": 0,
-    "totalOperationTime": 0
-  },
-  "storage": {
-    "totalEntries": 0,
-    "reasoningbankEntries": 0,
-    "basicEntries": 0,
-    "databaseSize": 0,
-    "lastBackup": null,
-    "growthRate": 0
-  },
-  "errors": {
-    "total": 0,
-    "byType": {},
-    "byOperation": {},
-    "recent": []
-  },
-  "reasoningbank": {
-    "semanticSearches": 0,
-    "sqlFallbacks": 0,
-    "embeddingGenerated": 0,
-    "consolidations": 0,
-    "avgQueryTime": 0,
-    "cacheHits": 0,
-    "cacheMisses": 0
-  }
-}

package/packages/agentic-jujutsu/.claude-flow/metrics/task-metrics.json

@@ -1,10 +0,0 @@
-[
-  {
-    "id": "cmd-hooks-1764004764170",
-    "type": "hooks",
-    "success": true,
-    "duration": 7.742281000000048,
-    "timestamp": 1764004764178,
-    "metadata": {}
-  }
-]

package/packages/agentic-jujutsu/BUILD.md

@@ -1,292 +0,0 @@
-# Building agentic-jujutsu Native Binaries
-
-This document explains how to build and publish agentic-jujutsu with native binaries for all supported platforms.
-
-## Supported Platforms
-
-agentic-jujutsu supports 8 platforms through NAPI-RS:
-
-1. **Linux x64 GNU** (`linux-x64-gnu`) - Standard Linux distributions
-2. **Linux ARM64 GNU** (`linux-arm64-gnu`) - ARM64 Linux (Raspberry Pi 4+)
-3. **Linux x64 MUSL** (`linux-x64-musl`) - Alpine Linux x64
-4. **Linux ARM64 MUSL** (`linux-arm64-musl`) - Alpine Linux ARM64
-5. **Linux ARMv7** (`linux-arm-gnueabihf`) - ARM32 devices
-6. **macOS x64** (`darwin-x64`) - Intel Macs
-7. **macOS ARM64** (`darwin-arm64`) - Apple Silicon Macs (M1/M2/M3)
-8. **Windows x64** (`win32-x64-msvc`) - Windows 64-bit
-
-## Automated Builds via GitHub Actions
-
-The repository includes a GitHub Actions workflow that automatically builds binaries for all platforms.
-
-### Workflow: `.github/workflows/build-agentic-jujutsu.yml`
-
-**Triggers:**
-- Push to `main` branch (paths: `packages/agentic-jujutsu/**`)
-- Pull requests to `main`
-- Tags matching `agentic-jujutsu-v*` (e.g., `agentic-jujutsu-v2.3.6`)
-- Manual workflow dispatch
-
-**Build Matrix:**
-- Uses ubuntu-22.04 for all Linux builds
-- Uses macos-13 for Intel Mac builds
-- Uses macos-14 for Apple Silicon builds
-- Uses windows-2022 for Windows builds
-
-**Process:**
-1. Checks out code
-2. Sets up Node.js 20 and Rust toolchain
-3. Installs cross-compilation tools (for ARM targets)
-4. Builds native module with `napi build`
-5. Tests on native platforms
-6. Uploads artifacts
-
-### Publishing Process
-
-When a tag `agentic-jujutsu-v*` is pushed, the workflow automatically:
-
-1. **Downloads all platform binaries** from build artifacts
-2. **Creates platform-specific packages**:
-   - `agentic-jujutsu-darwin-x64`
-   - `agentic-jujutsu-darwin-arm64`
-   - `agentic-jujutsu-linux-x64-gnu`
-   - `agentic-jujutsu-linux-x64-musl`
-   - `agentic-jujutsu-linux-arm64-gnu`
-   - `agentic-jujutsu-linux-arm64-musl`
-   - `agentic-jujutsu-linux-arm-gnueabihf`
-   - `agentic-jujutsu-win32-x64-msvc`
-3. **Publishes platform packages** to npm
-4. **Publishes main package** with optionalDependencies
-
-## Manual Build Instructions
-
-### Prerequisites
-
-- Node.js 16+ (recommended: 20)
-- Rust toolchain (via rustup)
-- NAPI-RS CLI: `npm install -g @napi-rs/cli`
-
-### Building for Your Platform
-
-```bash
-cd packages/agentic-jujutsu
-npm install
-npm run build  # or: napi build --platform --release
-```
-
-This creates a `.node` file for your current platform:
-- `agentic-jujutsu.linux-x64-gnu.node` (on Linux)
-- `agentic-jujutsu.darwin-arm64.node` (on Apple Silicon Mac)
-- etc.
-
-### Cross-Compilation (Advanced)
-
-#### Linux ARM64 from x64:
-
-```bash
-# Install cross-compilation tools
-sudo apt-get install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
-
-# Add target
-rustup target add aarch64-unknown-linux-gnu
-
-# Build
-CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=aarch64-linux-gnu-gcc \
-  napi build --platform --release --target aarch64-unknown-linux-gnu
-```
-
-#### MUSL targets:
-
-```bash
-# Install musl tools
-sudo apt-get install musl-tools
-
-# Add target
-rustup target add x86_64-unknown-linux-musl
-
-# Build
-napi build --platform --release --target x86_64-unknown-linux-musl
-```
-
-## Releasing a New Version
-
-### Step 1: Update Version
-
-```bash
-cd packages/agentic-jujutsu
-npm version 2.3.6  # or patch/minor/major
-```
-
-### Step 2: Create and Push Tag
-
-```bash
-git add package.json
-git commit -m "chore: bump agentic-jujutsu to v2.3.6"
-git tag agentic-jujutsu-v2.3.6
-git push origin main --tags
-```
-
-### Step 3: Monitor GitHub Actions
-
-1. Go to: https://github.com/ruvnet/agentic-flow/actions
-2. Watch the "Build Agentic-Jujutsu Native Modules" workflow
-3. Verify all 8 platforms build successfully
-4. Verify publish job completes
-
-### Step 4: Verify npm Packages
-
-```bash
-# Check main package
-npm view agentic-jujutsu@2.3.6
-
-# Check platform packages
-npm view agentic-jujutsu-darwin-arm64@2.3.6
-npm view agentic-jujutsu-linux-x64-gnu@2.3.6
-# ... etc for all 8 platforms
-```
-
-## Testing Installation
-
-### Test on Your Platform
-
-```bash
-npm install agentic-jujutsu@2.3.6
-node -e "const {JjWrapper} = require('agentic-jujutsu'); console.log('✓ Loaded')"
-```
-
-### Test Platform-Specific Package
-
-```bash
-npm install agentic-jujutsu-darwin-arm64@2.3.6
-ls node_modules/agentic-jujutsu-darwin-arm64/*.node
-```
-
-## Troubleshooting
-
-### Build Fails on ARM Targets
-
-Ensure cross-compilation tools are installed:
-```bash
-sudo apt-get update
-sudo apt-get install -y \
-  gcc-aarch64-linux-gnu \
-  g++-aarch64-linux-gnu \
-  gcc-arm-linux-gnueabihf \
-  g++-arm-linux-gnueabihf
-```
-
-### Wrong .node File Name
-
-NAPI-RS creates files with platform suffix. The workflow handles mapping:
-- Build output: `agentic-jujutsu.linux-x64-gnu.node`
-- Artifact location: `npm/linux-x64-gnu/agentic-jujutsu.linux-x64-gnu.node`
-
-### Platform Package Not Found
-
-Platform packages must be published BEFORE the main package. The workflow does this automatically, but for manual publishing:
-
-```bash
-# 1. Build all platforms
-# 2. Publish platform packages first
-cd npm/darwin-arm64
-npm publish --access public
-
-# 3. Then publish main package
-cd ../..
-npm publish --access public
-```
-
-## Architecture
-
-### NAPI-RS Structure
-
-```
-packages/agentic-jujutsu/
-├── src/                       # Rust source code
-│   ├── lib.rs                 # NAPI bindings
-│   ├── operations.rs          # Jujutsu operations
-│   └── ...
-├── index.js                   # JavaScript entry point
-├── index.d.ts                 # TypeScript definitions
-├── *.node                     # Built native modules (gitignored)
-└── npm/                       # Platform packages (created by CI)
-    ├── darwin-arm64/
-    │   ├── package.json
-    │   └── agentic-jujutsu.darwin-arm64.node
-    ├── linux-x64-gnu/
-    │   ├── package.json
-    │   └── agentic-jujutsu.linux-x64-gnu.node
-    └── ...
-```
-
-### Loading Mechanism
-
-The main `index.js` checks your platform and loads the appropriate `.node` file:
-1. Tries local file (e.g., `./agentic-jujutsu.darwin-arm64.node`)
-2. Falls back to platform package (e.g., `require('agentic-jujutsu-darwin-arm64')`)
-
-This is why optionalDependencies are needed in `package.json`.
-
-## CI/CD Environment Variables
-
-The workflow requires the following GitHub secret:
-- `NPM_TOKEN` - npm access token with publish permissions
-
-**CRITICAL**: The automated workflow will fail without this secret configured. All platform builds will succeed, but the publish job will fail with `ENEEDAUTH` errors.
-
-To set up:
-1. Generate token at https://www.npmjs.com/settings/YOUR_USERNAME/tokens
-   - Token type: "Automation" (for CI/CD)
-   - Permissions: "Read and write" (for publishing)
-2. Add as repository secret at https://github.com/ruvnet/agentic-flow/settings/secrets/actions
-   - Name: `NPM_TOKEN`
-   - Value: Your npm automation token
-3. Verify in workflow runs that `NODE_AUTH_TOKEN` is set (masked in logs)
-
-### Manual Publishing (if NPM_TOKEN not configured)
-
-If the GitHub secret is not configured, you can publish manually after builds complete:
-
-```bash
-# Wait for all 8 platform builds to complete
-gh run watch <run-id>
-
-# Download artifacts
-gh run download <run-id> -D /tmp/artifacts
-
-# Build local binary
-cd packages/agentic-jujutsu
-npm install
-npm run build
-
-# Publish (requires npm login)
-npm whoami  # Verify authentication
-npm publish --access public
-```
-
-The main package includes the linux-x64-gnu binary by default, so it will work on Linux platforms immediately after manual publishing.
-
-## Performance Notes
-
-### Build Times (approximate)
-
-- Linux x64 GNU: ~3-4 minutes
-- Linux ARM64 (cross): ~4-5 minutes
-- macOS x64: ~4-5 minutes
-- macOS ARM64: ~3-4 minutes
-- Windows x64: ~5-6 minutes
-- MUSL targets: ~4-5 minutes
-
-### Binary Sizes
-
-- Linux GNU: ~27 MB
-- Linux MUSL: ~28 MB
-- macOS: ~4-5 MB (Apple's stripping)
-- Windows: ~4-5 MB
-
-## References
-
-- NAPI-RS Documentation: https://napi.rs/
-- GitHub Actions: https://docs.github.com/en/actions
-- Cross-compilation: https://rust-lang.github.io/rustup/cross-compilation.html
-