Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

feat(ruflo-daa): v0.2.0 β€” adopt plugin contract (ADR-0001, intelligence-pipeline alignment)

Reuvenb6d13ae98261
diff --git a/plugins/ruflo-daa/.claude-plugin/plugin.json b/plugins/ruflo-daa/.claude-plugin/plugin.json
index fbe7ace3e0..242f2b78cc 100644
--- a/plugins/ruflo-daa/.claude-plugin/plugin.json
+++ b/plugins/ruflo-daa/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-daa",
- "description": "Dynamic Agentic Architecture with cognitive patterns, knowledge sharing, and adaptive agents",
- "version": "0.1.0",
+ "description": "Dynamic Agentic Architecture β€” 8 daa_* MCP tools for adaptive agents (create/adapt), cognitive patterns, workflows (create/execute), knowledge sharing, and learning/performance metrics. Feeds the JUDGE phase of the 4-step intelligence pipeline.",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
@@ -13,6 +13,9 @@
"daa",
"cognitive",
"adaptive",
- "knowledge-sharing"
+ "knowledge-sharing",
+ "cognitive-patterns",
+ "workflows",
+ "mcp"
]
}
diff --git a/plugins/ruflo-daa/README.md b/plugins/ruflo-daa/README.md
index 4db3ea8a1e..4e30e73b6b 100644
--- a/plugins/ruflo-daa/README.md
+++ b/plugins/ruflo-daa/README.md
@@ -24,3 +24,46 @@ Dynamic Agentic Architecture with cognitive patterns, knowledge sharing, and ada
- `daa-agent` -- Create and adapt Dynamic Agentic Architecture agents
- `cognitive-pattern` -- Define cognitive patterns for agent reasoning
+
+## MCP surface (8 tools)
+
+All defined at `v3/@claude-flow/cli/src/mcp-tools/daa-tools.ts`:
+
+| Tool | Purpose |
+|------|---------|
+| `daa_agent_create` | Initialize an adaptive agent |
+| `daa_agent_adapt` | Trigger manual adaptation from feedback |
+| `daa_workflow_create` | Define a cognitive workflow |
+| `daa_workflow_execute` | Run a cognitive workflow |
+| `daa_knowledge_share` | Propagate learnings across agents |
+| `daa_learning_status` | Adaptation progress metrics |
+| `daa_cognitive_pattern` | Define a reasoning pattern |
+| `daa_performance_metrics` | Efficiency / accuracy stats |
+
+## Compatibility
+
+- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor.
+- **Verification:** `bash plugins/ruflo-daa/scripts/smoke.sh` is the contract.
+
+## Intelligence-pipeline alignment
+
+DAA cognitive patterns feed the **JUDGE** phase of the 4-step intelligence pipeline (RETRIEVE β†’ JUDGE β†’ DISTILL β†’ CONSOLIDATE) defined by [ruflo-intelligence ADR-0001](../ruflo-intelligence/docs/adrs/0001-intelligence-surface-completeness.md). When a task is routed via `hooks_route` and a similar past trajectory is retrieved, DAA cognitive patterns provide the structured reasoning to evaluate fit before adaptation.
+
+`daa_knowledge_share` writes pattern propagation events that `hooks_intelligence_learn` can consume during the DISTILL phase.
+
+## Namespace coordination
+
+This plugin owns the `daa-patterns` AgentDB namespace (kebab-case, follows the convention from [ruflo-agentdb ADR-0001 Β§"Namespace convention"](../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md)). Reserved namespaces (`pattern`, `claude-memories`, `default`) MUST NOT be shadowed.
+
+`daa-patterns` is accessed via `memory_*` tools (which route by namespace). The agent file's CLI examples are correct (`memory store --namespace daa-patterns`).
+
+## Verification
+
+```bash
+bash plugins/ruflo-daa/scripts/smoke.sh
+# Expected: "10 passed, 0 failed"
+```
+
+## Architecture Decisions
+
+- [`ADR-0001` β€” ruflo-daa plugin contract (pinning, namespace coordination, intelligence-pipeline alignment, smoke as contract)](./docs/adrs/0001-daa-contract.md)
diff --git a/plugins/ruflo-daa/docs/adrs/0001-daa-contract.md b/plugins/ruflo-daa/docs/adrs/0001-daa-contract.md
new file mode 100644
index 0000000000..ef4341aeda
--- /dev/null
+++ b/plugins/ruflo-daa/docs/adrs/0001-daa-contract.md
@@ -0,0 +1,53 @@
+---
+id: ADR-0001
+title: ruflo-daa plugin contract β€” pinning, namespace coordination, intelligence-pipeline alignment, smoke as contract
+status: Proposed
+date: 2026-05-04
+authors:
+ - reviewer (Claude Code)
+tags: [plugin, daa, cognitive, adaptive, knowledge-sharing, namespace, smoke-test]
+---
+
+## Context
+
+`ruflo-daa` (v0.1.0) wraps 8 `daa_*` MCP tools at `v3/@claude-flow/cli/src/mcp-tools/daa-tools.ts:90, 161, 223, 271, 322, 388, 444, 512`:
+
+| Tool | Purpose |
+|------|---------|
+| `daa_agent_create` | Initialize an adaptive agent |
+| `daa_agent_adapt` | Trigger manual adaptation from feedback |
+| `daa_workflow_create` | Define a cognitive workflow |
+| `daa_workflow_execute` | Run a cognitive workflow |
+| `daa_knowledge_share` | Propagate learnings across agents |
+| `daa_learning_status` | Adaptation progress metrics |
+| `daa_cognitive_pattern` | Define a reasoning pattern |
+| `daa_performance_metrics` | Efficiency / accuracy stats |
+
+All 8 are correctly referenced across the agent + 2 skills + 1 command. What's missing is the standard contract.
+
+## Decision
+
+1. Add this ADR (Proposed).
+2. README augment: Compatibility (pin v3.6), Namespace coordination (claims `daa-patterns`; defers to ruflo-agentdb ADR-0001), 8-tool surface table, intelligence-pipeline alignment note (DAA cognitive patterns feed the JUDGE phase per ruflo-intelligence ADR-0001), Verification + Architecture Decisions sections.
+3. Bump `0.1.0 β†’ 0.2.0`. Keywords add `cognitive-patterns`, `workflows`, `mcp`.
+4. `scripts/smoke.sh` β€” 10 structural checks: version + keywords; all 8 daa_* tools referenced; both skills + 1 command + 1 agent present with valid frontmatter; v3.6 pin; namespace coordination; intelligence-pipeline cross-reference; ADR Proposed; no wildcard tools.
+
+## Consequences
+
+**Positive:** plugin joins the cadence. DAA cognitive patterns now have an explicit cross-link to the 4-step intelligence pipeline.
+
+**Negative:** none material β€” plugin behavior unchanged.
+
+## Verification
+
+```bash
+bash plugins/ruflo-daa/scripts/smoke.sh
+# Expected: "10 passed, 0 failed"
+```
+
+## Related
+
+- `plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md` β€” namespace convention
+- `plugins/ruflo-intelligence/docs/adrs/0001-intelligence-surface-completeness.md` β€” 4-step pipeline DAA feeds
+- `plugins/ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md`
+- `v3/@claude-flow/cli/src/mcp-tools/daa-tools.ts` β€” 8 daa_* tools
diff --git a/plugins/ruflo-daa/scripts/smoke.sh b/plugins/ruflo-daa/scripts/smoke.sh
new file mode 100755
index 0000000000..f26ba966d9
--- /dev/null
+++ b/plugins/ruflo-daa/scripts/smoke.sh
@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -u
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PASS=0
+FAIL=0
+step() { printf "β†’ %s ... " "$1"; }
+ok() { printf "PASS\n"; PASS=$((PASS+1)); }
+bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
+
+step "1. plugin.json declares 0.2.0 with new keywords"
+v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+if [[ "$v" != "0.2.0" ]]; then bad "expected 0.2.0, got '$v'"; else
+ miss=""
+ for k in cognitive-patterns workflows mcp; do
+ grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
+ done
+ [[ -z "$miss" ]] && ok || bad "missing keywords:$miss"
+fi
+
+step "2. all 8 daa_* MCP tools referenced"
+miss=""
+for t in daa_agent_create daa_agent_adapt daa_workflow_create daa_workflow_execute daa_knowledge_share daa_learning_status daa_cognitive_pattern daa_performance_metrics; do
+ grep -rq "$t" "$ROOT" --include='*.md' || miss="$miss $t"
+done
+[[ -z "$miss" ]] && ok || bad "undocumented:$miss"
+
+step "3. both skills with valid frontmatter"
+miss=""
+for s in daa-agent cognitive-pattern; do
+ f="$ROOT/skills/$s/SKILL.md"
+ [[ -f "$f" ]] || { miss="$miss missing-$s"; continue; }
+ for k in 'name:' 'description:' 'allowed-tools:'; do
+ grep -q "^$k" "$f" || miss="$miss $s-no-$k"
+ done
+done
+[[ -z "$miss" ]] && ok || bad "$miss"
+
+step "4. agent + command present with valid frontmatter"
+miss=""
+for f in "$ROOT/agents/daa-specialist.md" "$ROOT/commands/daa.md"; do
+ [[ -f "$f" ]] || { miss="$miss missing-$(basename $f)"; continue; }
+ grep -q "^name:" "$f" || miss="$miss $(basename $f)-no-name"
+done
+[[ -z "$miss" ]] && ok || bad "$miss"
+
+step "5. README pins @claude-flow/cli to v3.6"
+grep -qE "@claude-flow/cli.*v3\.6|v3\.6.*claude-flow/cli" "$ROOT/README.md" \
+ && ok || bad "v3.6 pin missing"
+
+step "6. README defers to ruflo-agentdb namespace convention"
+grep -q "ruflo-agentdb" "$ROOT/README.md" \
+ && grep -q "Namespace convention" "$ROOT/README.md" \
+ && ok || bad "namespace coordination block incomplete"
+
+step "7. README aligns with intelligence 4-step pipeline (cross-reference)"
+grep -qE "4-step|JUDGE phase|intelligence pipeline" "$ROOT/README.md" \
+ && grep -q "ruflo-intelligence" "$ROOT/README.md" \
+ && ok || bad "intelligence pipeline cross-reference missing"
+
+step "8. daa-patterns namespace claimed"
+grep -q "daa-patterns" "$ROOT/README.md" \
+ && ok || bad "daa-patterns namespace not claimed"
+
+step "9. ADR-0001 exists with status Proposed"
+ADR="$ROOT/docs/adrs/0001-daa-contract.md"
+[[ -f "$ADR" ]] && grep -qE "^status:[[:space:]]*Proposed" "$ADR" \
+ && ok || bad "ADR missing or status != Proposed"
+
+step "10. no wildcard tool grants in skills"
+bad_skills=""
+for f in "$ROOT"/skills/*/SKILL.md; do
+ grep -q '^allowed-tools:[[:space:]]*\*' "$f" && bad_skills="$bad_skills $(basename $(dirname "$f"))"
+done
+[[ -z "$bad_skills" ]] && ok || bad "wildcard:$bad_skills"
+
+printf "\n%s passed, %s failed\n" "$PASS" "$FAIL"
+[[ $FAIL -eq 0 ]] || exit 1