mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-11-09 14:04:06 +09:00
ReuvenandRuFlo
02eee0bcdc
- 27 plugins moved Proposed → Accepted (shipped versions, in marketplace) - 0 plugins kept as Proposed (all have real versions ≥ 0.2.0) Per-plugin breakdown: ruflo-aidefence v0.2.0 Accepted — 3-gate pattern, 6 aidefence_* tools ruflo-autopilot v0.2.0 Accepted — 10 autopilot_* tools, /loop integration ruflo-core v0.2.1 Accepted — MCP server contract, plugin-catalog discovery ruflo-cost-tracker v0.16.1 Accepted — namespace-routing fix, ADR-097 budget integration ruflo-daa v0.2.0 Accepted — 8 daa_* tools, intelligence-pipeline alignment ruflo-ddd v0.2.0 Accepted — AgentDB domain graph, SPARC Architecture-phase ruflo-docs v0.2.0 Accepted — document worker dispatch, drift detection ruflo-federation v0.2.0 Accepted — ADR-097 Phase 1+2, 3-gate alignment ruflo-goals v0.2.0 Accepted — 6 namespaces, GOAP + dossier ADR-099 ruflo-iot-cognitum v0.2.0 Accepted — 5-tier trust, 6 background workers ruflo-jujutsu v0.2.0 Accepted — 6 analyze_* tools, ADR-compliance cross-link ruflo-knowledge-graph v0.2.0 Accepted — embeddings_generate fix, pathfinder ruflo-loop-workers v0.2.0 Accepted — 12 worker triggers, 5 hooks_worker-* tools ruflo-market-data v0.2.0 Accepted — embeddings + namespace-routing bugs fixed ruflo-migrations v0.2.0 Accepted — namespace-routing bug fixed both skills ruflo-neural-trader v0.2.0 Accepted — 4 namespaces already compliant ruflo-observability v0.2.0 Accepted — namespace-routing bug fixed both skills ruflo-plugin-creator v0.2.0 Accepted — scaffolding templates updated with contract ruflo-rag-memory v0.2.0 Accepted — claude-memories reserved namespace consumer ruflo-ruvllm v0.2.0 Accepted — LLM-config + chat-format slice ownership ruflo-rvf v0.2.0 Accepted — portable-memory + session-persistence slice ruflo-security-audit v0.2.0 Accepted — 3-gate + audit_1776853149979 regression class ruflo-sparc v0.2.0 Accepted — all 5 SPARC phases cross-linked ruflo-swarm v0.2.0 Accepted — 12 MCP tools (4 swarm_* + 8 agent_*) ruflo-testgen v0.2.0 Accepted — testgaps worker + coverage CLI commands ruflo-wasm v0.2.0 Accepted — 10 wasm_* tools, ADR-070 cross-ref ruflo-workflows v0.2.0 Accepted — 10 workflow_* tools, SPARC phase transitions Each ADR received: updated: 2026-05-09 in frontmatter + Implementation status section noting version, marketplace presence, and contract element alignment. Co-Authored-By: RuFlo <ruv@ruv.net>
ruflo-loop-workers
Cache-aware /loop workers and CronCreate background automation. Substrate plugin for every recurring task in the ruflo family.
Install
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-loop-workers@ruflo
What's Included
- Loop Workers: Recurring tasks via
/loopwith ScheduleWakeup (delay <270s for prompt cache hits) - CronCreate: Background cron jobs for audit, optimization, and monitoring
- 12 Background Workers: ultralearn, optimize, consolidate, predict, audit, map, preload, deepdive, document, refactor, benchmark, testgaps
- Daemon Management: Start, stop, status, trigger, and enable workers
- ADR-091 Integration: Native Claude Code capabilities preferred over daemon polling
Requires
ruflo-coreplugin (provides MCP server)
Compatibility
- CLI: pinned to
@claude-flow/cliv3.6 major+minor. - Verification:
bash plugins/ruflo-loop-workers/scripts/smoke.shis the contract.
MCP surface (5 tools)
All defined at v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts:
| Tool | Purpose |
|---|---|
hooks_worker-list |
List available workers and their triggers |
hooks_worker-dispatch |
Dispatch a worker run with --trigger <worker-name> and optional --scope |
hooks_worker-status |
Inspect a running worker |
hooks_worker-detect |
Detect which workers should fire based on context |
hooks_worker-cancel |
Cancel a running worker |
12 worker triggers → consumer plugins
| Trigger | Consumer plugin | Purpose |
|---|---|---|
ultralearn |
ruflo-intelligence |
Bootstrap learning corpus from a deep codebase scan |
optimize |
ruflo-cost-tracker, ruflo-intelligence |
Performance + cost optimization recommendations |
consolidate |
ruflo-intelligence, ruflo-agentdb |
EWC++ memory consolidation |
predict |
ruflo-intelligence |
Predictive routing for upcoming tasks |
audit |
ruflo-security-audit, ruflo-aidefence |
Security + compliance audit pass |
map |
ruflo-knowledge-graph |
Build/refresh entity-relation knowledge graph |
preload |
ruflo-core, ruflo-rag-memory |
Warm caches before high-frequency operations |
deepdive |
ruflo-goals (deep-research) |
Multi-source investigation pass |
document |
ruflo-docs |
Generate API docs + drift detection |
refactor |
ruflo-jujutsu |
Diff-aware refactor recommendations |
benchmark |
ruflo-cost-tracker, ruflo-iot-cognitum |
Perf benchmarks |
testgaps |
ruflo-testgen |
Coverage gap detection + test generation |
Invocation pattern (CLI + MCP):
# CLI
npx @claude-flow/cli@latest hooks worker dispatch --trigger document --scope api
# MCP
mcp tool call hooks_worker-dispatch --json -- '{"trigger": "document", "scope": "api"}'
Cache-aware /loop integration
This plugin pairs with ruflo-autopilot ADR-0001 which owns the 270s cache-aware ScheduleWakeup heartbeat contract. Recommended fallback heartbeat is 270 seconds — under the 5-minute prompt-cache TTL so the next wake-up reads conversation context cached. Going past 300s pays a cache-miss; rounding to 5 minutes is the worst-of-both case.
For event-driven loops, arm a Monitor and let the 270s wake be the safety net.
Namespace coordination
This plugin owns the worker-history AgentDB namespace (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.
worker-history records dispatch events, durations, success/failure verdicts. Accessed via memory_* tools (namespace-routed).
Verification
bash plugins/ruflo-loop-workers/scripts/smoke.sh
# Expected: "12 passed, 0 failed"
Architecture Decisions
Related Plugins
ruflo-autopilot— owns the 270s cache-aware /loop heartbeat contractruflo-docs,ruflo-security-audit,ruflo-testgen,ruflo-knowledge-graph, etc. — worker-trigger consumers per the table aboveruflo-agentdb— namespace convention owner; backing store for worker-history