agentic-flow 1.7.3 → 1.7.5

package/.claude/agents/test-neural.md

@@ -1,8 +1,3 @@
----
-name: test-neural
-description: Test agent for validating neural network tool access
----
-
 # Test Neural Agent
 
 Test agent for validating neural network tool access.

package/.claude/answer.md

@@ -0,0 +1 @@
+A program walks into a bar and orders a beer. As it is waiting for its drink, it hears a guy next to it say, 'Wow, the bartender can brew beer in just 5 minutes!' The program turns to the man and says, 'I don't know, I'm still trying to debug my couple of weeks old code and I still can't tell what it's doing. A 5 minute beer?

package/.claude/settings.json

@@ -9,33 +9,32 @@
   },
   "permissions": {
     "allow": [
-      "Bash(npx claude-flow:*)",
+      "Bash(npx claude-flow *)",
       "Bash(npm run lint)",
       "Bash(npm run test:*)",
-      "Bash(npm test:*)",
+      "Bash(npm test *)",
       "Bash(git status)",
-      "Bash(git diff:*)",
-      "Bash(git log:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
+      "Bash(git diff *)",
+      "Bash(git log *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
       "Bash(git push)",
-      "Bash(git config:*)",
-      "Bash(git tag:*)",
-      "Bash(git branch:*)",
-      "Bash(git checkout:*)",
-      "Bash(git stash:*)",
-      "Bash(jq:*)",
-      "Bash(node:*)",
-      "Bash(which:*)",
+      "Bash(git config *)",
+      "Bash(git tag *)",
+      "Bash(git branch *)",
+      "Bash(git checkout *)",
+      "Bash(git stash *)",
+      "Bash(jq *)",
+      "Bash(node *)",
+      "Bash(which *)",
       "Bash(pwd)",
-      "Bash(ls:*)",
-      "mcp__ruv-swarm",
-      "mcp__claude-flow@alpha",
-      "mcp__flow-nexus",
-      "WebSearch"
+      "Bash(ls *)"
     ],
     "deny": [
-      "Bash(rm -rf /)"
+      "Bash(rm -rf /)",
+      "Bash(curl * | bash)",
+      "Bash(wget * | sh)",
+      "Bash(eval *)"
     ]
   },
   "hooks": {

package/CHANGELOG.md

@@ -5,123 +5,6 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.7.3] - 2025-10-19
-
-### Fixed
-- **CRITICAL: Skills Installation Path** - Fixed skills to install at top level for Claude Code discovery
-  - **Before**: Skills installed to `.claude/skills/agentic-flow/[skill-name]/` (WRONG - nested subdirectory)
-  - **After**: Skills install to `.claude/skills/[skill-name]/` (CORRECT - top level)
-  - Claude Code requires skills at top level, NOT in subdirectories
-  - Affects `npx agentic-flow skills create` command
-  - All 4 example skills (agentdb-vector-search, agentdb-memory-patterns, swarm-orchestration, reasoningbank-intelligence) now install correctly
-
-### Migration
-If you installed skills with v1.7.2:
-```bash
-# Move skills from subdirectory to top level
-cd .claude/skills
-mv agentic-flow/* .
-rmdir agentic-flow
-# Restart Claude Code
-```
-
-Or simply reinstall:
-```bash
-rm -rf .claude/skills
-npx agentic-flow@latest skills create
-```
-
-## [1.7.2] - 2025-10-19
-
-### Added
-- **Skills System Integration** - Full CLI support for Claude Code Skills management
-  - `npx agentic-flow skills list` - List all installed skills (personal + project)
-  - `npx agentic-flow skills init` - Initialize skills directories (~/.claude/skills and .claude/skills)
-  - `npx agentic-flow skills create` - Create agentic-flow example skills (AgentDB, swarm, reasoningbank)
-  - `npx agentic-flow skills init-builder` - Install skill-builder framework for creating custom skills
-  - `npx agentic-flow skills help` - Show comprehensive skills command documentation
-  - Skills automatically discovered by Claude Code across all surfaces (Claude.ai, CLI, SDK, API)
-
-### Changed
-- **README Updates** - Added comprehensive Skills System documentation
-  - New Skills System section with Quick Start guide
-  - Updated Quick Navigation table to highlight Skills
-  - Updated CLI Commands section with all 5 skills commands
-  - Added skill structure examples with YAML frontmatter
-  - Listed 5 built-in skills: skill-builder, agentdb-memory-patterns, agentdb-vector-search, reasoningbank-intelligence, swarm-orchestration
-
-### Documentation
-- Updated both main README.md and npm package README.md with identical Skills documentation
-- Added skills to Quick Navigation for easy discovery
-- Included benefits: reusable, discoverable, structured, progressive, validated
-
-## [1.7.1] - 2025-10-19
-
-### Fixed
-- **CRITICAL: Skills Top-Level Installation** - Fixed skills to install at top level for Claude Code discovery
-  - **Claude Code requires**: `~/.claude/skills/[skill-name]/` (top level)
-  - **NOT supported**: `~/.claude/skills/namespace/[skill-name]/` (nested subdirectories)
-  - All skills now correctly install at top level: `~/.claude/skills/skill-builder/`, `~/.claude/skills/swarm-orchestration/`, etc.
-  - Skills are now properly discovered by Claude Code after restart
-  - Reverted incorrect v1.7.0 namespace changes that broke skill discovery
-
-### Changed
-- Updated `skills-manager.ts` to install all skills at top level (removed nested namespace)
-- Moved skill source files from `agentic-flow/` subdirectory to top level in `.claude/skills/`
-- Simplified source detection paths
-
-### Documentation
-- Added `docs/plans/skills/SKILLS_TOP_LEVEL_FIX.md` - Explanation of fix and testing
-- Updated `docs/plans/skills/SKILL_INSTALLATION_ANALYSIS.md` - Corrected with top-level requirement
-- Deprecated `docs/plans/skills/MIGRATION_v1.7.0.md` - Namespace approach was incorrect
-
-### Migration
-If you installed skills with v1.7.0:
-```bash
-# Move skills from namespace to top level
-cd ~/.claude/skills
-for skill in agentic-flow/*; do
-  mv "agentic-flow/$skill" "$(basename $skill)"
-done
-rm -rf agentic-flow
-# Restart Claude Code
-```
-
-Or simply reinstall:
-```bash
-npx agentic-flow skills init personal --with-builder
-```
-
-## [1.6.6] - 2025-10-18
-
-### Changed
-
-- **AgentDB v1.0.5** - Updated to latest version with browser bundle support
-  - Now includes `dist/agentdb.min.js` (196KB) and `dist/agentdb.js` (380KB) for CDN usage
-  - Browser bundles support direct import via unpkg/jsDelivr
-  - Source maps included for debugging
-  - WASM backend fully functional in browser environments
-
-## [1.6.5] - 2025-10-18
-
-### Changed
-
-- **AgentDB Dependency** - Updated to use published npm package instead of local file reference
-  - Changed from `"agentdb": "file:../packages/agentdb"` to `"agentdb": "^1.0.4"`
-  - Now uses stable published version from npm registry
-  - Includes all 20 MCP tools (10 core AgentDB + 10 learning tools)
-  - Easier installation and dependency management for end users
-
-### Added
-
-- **AgentDB v1.0.4 Integration** - Complete MCP learning system now available
-  - 10 learning tools: learning_start_session, learning_end_session, learning_predict, learning_feedback, learning_train, learning_metrics, learning_transfer, learning_explain, experience_record, reward_signal
-  - Q-learning with epsilon-greedy exploration
-  - Multi-dimensional reward system (success 40%, efficiency 30%, quality 20%, cost 10%)
-  - Experience replay buffer with prioritized sampling
-  - Transfer learning between similar tasks
-  - Session management with state persistence
-
 ## [1.6.4] - 2025-10-16
 
 ### 🚀 QUIC Transport - Production Ready (100% Complete)

package/README.md

@@ -17,7 +17,7 @@
 |-------------|---------------|---------------|
 | [Quick Start](#-quick-start) | [Agent Booster](#-core-components) | [Agent List](#-agent-types) |
 | [Deployment Options](#-deployment-options) | [ReasoningBank](#-core-components) | [MCP Tools](#-mcp-tools-213-total) |
-| [Model Optimization](#-model-optimization) | [Skills System](#-skills-system-claude-code-integration) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
+| [Model Optimization](#-model-optimization) | [Multi-Model Router](#-using-the-multi-model-router) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
 
 ---
 
@@ -53,19 +53,33 @@ Most AI coding agents are **painfully slow** and **frustratingly forgetful**. Th
 | Component | Description | Performance | Documentation |
 |-----------|-------------|-------------|---------------|
 | **Agent Booster** | Ultra-fast local code transformations via Rust/WASM (auto-detects edits) | 352x faster, $0 cost | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster) |
+| **AgentDB** | State-of-the-art memory with causal reasoning, reflexion, and skill learning | p95 < 50ms, 80% hit rate | [Docs](./src/agentdb/README.md) |
 | **ReasoningBank** | Persistent learning memory system with semantic search | 46% faster, 100% success | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/reasoningbank) |
 | **Multi-Model Router** | Intelligent cost optimization across 100+ LLMs | 85-99% cost savings | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/router) |
 | **QUIC Transport** | Ultra-low latency agent communication via Rust/WASM QUIC protocol | 50-70% faster than TCP, 0-RTT | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/crates/agentic-flow-quic) |
 
-**CLI Usage**: Multi-Model Router via `--optimize`, Agent Booster (automatic), ReasoningBank (API only), QUIC Transport (API only)
-**Programmatic**: All components importable: `agentic-flow/router`, `agentic-flow/reasoningbank`, `agentic-flow/agent-booster`, `agentic-flow/transport/quic`
+**CLI Usage**:
+- **AgentDB**: Full CLI with 17 commands (`npx agentdb <command>`)
+- **Multi-Model Router**: Via `--optimize` flag
+- **Agent Booster**: Automatic on code edits
+- **ReasoningBank**: API only
+- **QUIC Transport**: API only
+
+**Programmatic**: All components importable: `agentic-flow/agentdb`, `agentic-flow/router`, `agentic-flow/reasoningbank`, `agentic-flow/agent-booster`, `agentic-flow/transport/quic`
 
 **Get Started:**
 ```bash
+# CLI: AgentDB memory operations
+npx agentdb reflexion store "session-1" "implement_auth" 0.95 true "Success!"
+npx agentdb skill search "authentication" 10
+npx agentdb causal query "" "code_quality" 0.8
+npx agentdb learner run
+
 # CLI: Auto-optimization (Agent Booster runs automatically on code edits)
 npx agentic-flow --agent coder --task "Build a REST API" --optimize
 
 # Programmatic: Import any component
+import { ReflexionMemory, SkillLibrary, CausalMemoryGraph } from 'agentic-flow/agentdb';
 import { ModelRouter } from 'agentic-flow/router';
 import * as reasoningbank from 'agentic-flow/reasoningbank';
 import { AgentBooster } from 'agentic-flow/agent-booster';
@@ -248,18 +262,10 @@ npx agentic-flow mcp status  # Check server status
 npx agentic-flow --list              # List all 79 agents
 npx agentic-flow agent info coder    # Get agent details
 npx agentic-flow agent create        # Create custom agent
-
-# Skills management (NEW in v1.5.11+)
-npx agentic-flow skills list         # List all installed skills
-npx agentic-flow skills init         # Initialize skills directories
-npx agentic-flow skills create       # Create agentic-flow example skills
-npx agentic-flow skills init-builder # Install skill-builder framework
-npx agentic-flow skills help         # Show skills help
 ```
 
 **Built-in MCP Tools** (7): agent execution, list agents, create agent, agent info, conflicts check, model optimizer, list all agents
 **External MCP Servers**: claude-flow (101 tools), flow-nexus (96 tools), agentic-payments (10 tools)
-**Skills System**: Create reusable AI workflows with YAML frontmatter and progressive disclosure
 
 ---
 
@@ -375,76 +381,6 @@ for (const file of files) {
 
 ---
 
-## 🎓 Skills System (Claude Code Integration)
-
-**NEW in v1.5.11+**: Create reusable AI workflows with proper YAML frontmatter, progressive disclosure, and Claude Code integration.
-
-### What Are Skills?
-
-Skills are structured AI workflows that Claude can autonomously discover and execute across all surfaces (Claude.ai, Claude Code, SDK, API). Each skill is a self-contained SKILL.md file with YAML frontmatter defining its capabilities.
-
-### Quick Start
-
-```bash
-# Initialize skills directories
-npx agentic-flow skills init         # Creates ~/.claude/skills and .claude/skills
-
-# Install skill-builder framework (for creating custom skills)
-npx agentic-flow skills init-builder # Adds skill-builder to your project
-
-# Create example agentic-flow skills
-npx agentic-flow skills create       # Creates AgentDB, swarm, reasoningbank skills
-
-# List all installed skills
-npx agentic-flow skills list         # Shows personal and project skills
-
-# Get help
-npx agentic-flow skills help         # Show all commands and usage
-```
-
-### Skill Structure
-
-Every skill requires a SKILL.md file with YAML frontmatter:
-
-```yaml
----
-name: "Skill Name"                    # REQUIRED: Max 64 chars
-description: "What this skill does    # REQUIRED: Max 1024 chars
-and when Claude should use it."       # Include BOTH what & when
----
-
-# Skill Name
-
-## What This Skill Does
-[Instructions for Claude]
-
-## Quick Start
-[Basic usage examples]
-
-## Prerequisites
-[Requirements]
-```
-
-### Built-in Skills
-
-- **skill-builder** - Create new Claude Code Skills with proper structure
-- **agentdb-memory-patterns** - Persistent memory patterns for AI agents
-- **agentdb-vector-search** - Semantic search with AgentDB
-- **reasoningbank-intelligence** - Adaptive learning and pattern recognition
-- **swarm-orchestration** - Multi-agent coordination workflows
-
-### Benefits
-
-- ✅ **Reusable**: Share skills across projects and teams
-- ✅ **Discoverable**: Claude finds and uses skills automatically
-- ✅ **Structured**: YAML frontmatter ensures consistency
-- ✅ **Progressive**: Expand details only when needed
-- ✅ **Validated**: Built-in validation catches errors early
-
-**Learn More:** [Skills Documentation](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/.claude/skills)
-
----
-
 ## 🎛️ Programmatic API
 
 ### Multi-Model Router