skills/ruvnet__ruflo
1
0
Fork 0
mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00
Code Issues Packages Projects Releases Wiki Activity
7,421 Commits 580 Branches 1,645 Tags
fix/agentbbs-peerhello-dedup
Commit Graph

10 Commits

Author SHA1 Message Date
ruvnet e332689b8c fix(release): harden hooks, statusline, security, and plugin MCP integration 2026-07-16 23:06:29 -04:00
ruv 73793eb91f darwin-plugins iter 3 — ruflo-plugin-creator: align smoke check-count claim in SKILL.md (10+ → ≥8) with ADR/README 2026-06-26 20:29:22 -04:00
ruv 99dd600e27 darwin-plugins iter 2 — ruflo-plugin-creator: fix validate-plugin contradiction (plugin.json must not have skills/commands/agents arrays) 2026-06-26 20:15:45 -04:00
ruv 6198abfab7 fix(plugins): reconcile stale smoke contract assertions across 23 plugins 
full-system-test surfaced 23/32 plugin smoke contracts failing on a
single drifted assertion: the smoke gate greps ADR-0001 for
`status: Proposed`, but those ADRs were long since promoted to
`Accepted` without updating the gate. Flip the assertion (label, grep,
message) Proposed -> Accepted only where the ADR is genuinely Accepted.

ruflo-core additionally had a stale version assertion (0.2.0 -> 0.2.2).

Left untouched: ruflo-adr, ruflo-browser, ruflo-intelligence — their
ADR-0001 is genuinely Proposed, so their smokes correctly assert it.
No plugin source or ADR changed — only the drifted test assertions.

All 32 plugin smoke contracts now pass; full-system-test is 4/4 green.

Co-Authored-By: RuFlo <ruv@ruv.net>
 2026-05-29 15:00:34 -04:00
rUv edde98f9eb feat(graph): ADR-130 — unified graph intelligence backend (P1-P6) (#2129) 
* feat(graph): ADR-130 Phase 1 — graph_edges schema + PQ encoder + edge writer

Acceptance criteria met (smoke-graph-schema-migration.mjs: 23/23 pass):
- graph_edges table added to MEMORY_SCHEMA_V3 with temporal columns:
  confidence, decay_rate, last_reinforced, witness_id, embedding_ref
- 4 indexes: source_id, target_id, relation, last_reinforced
- embedding-quantization.ts: Int8 global-scalar PQ (400 bytes/384-dim)
  inline:<base64> format; 392.6 KB/1000 edges (<500 KB target)
  inlineCosine() for zero-decode similarity ranking
- graph-edge-writer.ts: thin sql.js accessor with module-level db cache
  insertGraphEdge, queryEdgesBySource, countGraphEdges, _resetBridgeDb
  fire-and-forget pattern with flushDb after every write

Tracking: #2128 — ADR-130 Phase 1 complete

Co-Authored-By: RuFlo <ruv@ruv.net>

* feat(graph): ADR-130 P2+P3+P5 — graph-query, trajectory hooks, pathfinder

Phase 2 — agentdb_graph-query MCP tool (smoke: 21/21 pass):
- k-hop: recursive CTE over graph_edges (sql-cte backend)
- pagerank: simple personalized PageRank power iteration (PPR)
- semantic: cosine ranking on inline PQ embeddings
- complexityBudget enforcement: maxNodesVisited, maxDepth, maxMillis
- Falls back gracefully when graph-node native is available

Phase 3 — SONA trajectory-to-graph hooks (smoke: 10/10 pass):
- hooks_intelligence_trajectory-step: fire-and-forget 'trajectory-caused' edge
- hooks_post-task (success=true): fire-and-forget 'reinforced-by' edge
- Neither write blocks tool response (<200ms tool latency preserved)

Phase 5 — agentdb_graph-pathfinder MCP tool (smoke: 20/20 pass):
- 6 algorithm variants: personalized-pagerank, dynamic-mincut,
  spectral-sparsify, temporal-centrality, connected-component-churn,
  witness-chain-divergence
- depth > 5 clamped; non-existent seed returns empty paths not error
- complexityBudget.maxNodesVisited limits traversal

Tracking: #2128 — ADR-130 P2+P3+P5 complete

Co-Authored-By: RuFlo <ruv@ruv.net>

* feat(graph): ADR-130 Phase 4 — plugin adapter contract (GraphEdgesSource)

Smoke: 24/24 pass (smoke-graph-plugin-adapter.mjs)

- GraphEdgesSource class added to knowledge-graph-adapter.ts
  implements KnowledgeGraphSource; reads live edges from graph_edges
  via lazy import of @claude-flow/cli graph-edge-writer
  falls back to empty edge list when table unavailable (backward compat)
- createAutoGraphAdapter(): autoRegister path, no SublinearAdapter impl needed
- All 8 existing adapters retain exportAsSparseMatrix (no breaking changes)
- ruflo-plugin-creator SKILL.md: documents graph_adapter optional plugin.json
  field with edgeRelations, nodeTypes, autoRegister fields

Tracking: #2128 — ADR-130 Phase 4 complete

Co-Authored-By: RuFlo <ruv@ruv.net>

* feat(graph): ADR-130 Phase 6 — benchmark + CI integration + witness manifest

Benchmark results (scripts/benchmark-graph.mjs):
- Write throughput: 2345 ops/sec (>500 target ✓)
- SQLite footprint: 578 bytes/edge (<1KB target ✓); PQ raw: 400 bytes/edge ✓
- k-hop depth=1: p99=4.9ms (<10ms target ✓)
- k-hop depth=3: p99=0.1ms (<50ms target ✓)
- PQ encode p99: 0.063ms (<1ms target ✓)
- PQ decode p99: 0.031ms (<0.5ms target ✓)
- PQ cosine self-similarity: 1.000000 ✓
6/6 targets met

CI (.github/workflows/v3-ci.yml):
- graph-schema-smoke (ADR-130 P1)
- graph-query-smoke (ADR-130 P2+P5) — depends on schema
- graph-trajectory-smoke (ADR-130 P3) — depends on schema
- graph-plugin-adapter-smoke (ADR-130 P4) — depends on schema
- graph-benchmark (ADR-130 P6) — depends on all smoke jobs

Witness manifest updated via regen-witness.mjs

Tracking: #2128 — ADR-130 Phase 6 complete (all phases shipped)

Co-Authored-By: RuFlo <ruv@ruv.net>

* chore(release): v3.9.0 — ADR-130 graph intelligence P1-P3

Ships all 6 phases of ADR-130 unified graph intelligence backend:
- @claude-flow/cli@3.9.0 (latest, alpha, v3alpha)
- claude-flow@3.9.0 (latest, alpha, v3alpha)
- ruflo@3.9.0 (latest, alpha, v3alpha)

Key additions: graph_edges schema, PQ encoder, agentdb_graph-query,
agentdb_graph-pathfinder, SONA trajectory hooks, plugin adapter contract.
Benchmark: 2345 ops/sec write, 4.9ms k-hop p99, 6/6 targets met.

Tracking: #2128

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(graph): CI fixes — ADR-112 guidance, plugin TS types, pnpm install

Fix 3 CI failures from PR #2129:

1. Tool description (ADR-112): agentdb_graph-pathfinder was missing
   'Use when' guidance — added 'Use when agentdb_graph-query k-hop is
   not enough' + 'Prefer over prompt-level graph loops' text.
   audit-tool-descriptions: 325/325 pass (0 violations).

2. Plugin TypeScript build (ruflo-graph-intelligence): dynamic imports
   of '@claude-flow/cli/src/memory/graph-edge-writer.js' in
   knowledge-graph-adapter.ts caused TS2307 (module not found) in the
   plugin's isolated tsc context. Fixed with explicit @ts-ignore +
   local type alias for the module shape; fallback path unchanged.

3. CI install (graph smoke jobs): npm ci --workspace fails at root —
   the v3 workspace uses pnpm, not npm workspaces. Switched all 5
   graph job install/build steps to pnpm install + pnpm run build
   inside working-directory: v3, matching the Build V3 job pattern.

4th failure (Smoke / Node 24 ETIMEDOUT onnxruntime-node) is a transient
infra network timeout — pre-existing flake, not a regression.

Tracking: #2128

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(ci): graph smoke jobs — use pnpm -r build from v3 workspace root

The previous fix switched from npm to pnpm but still called
pnpm run build from within v3/@claude-flow/cli which fails because
that package uses composite TypeScript references to @claude-flow/shared
and @claude-flow/swarm — those must be built first.

Fix: all 5 graph smoke/benchmark CI jobs now run:
  cd v3 && pnpm install --frozen-lockfile && pnpm -r build
(exact same pattern as Build V3 and browser-rvf-create smoke jobs)

Tracking: #2128

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(smoke): resolve sql.js from CLI node_modules in schema + trajectory tests

smoke-graph-schema-migration.mjs and smoke-trajectory-graph-edges.mjs
called await import('sql.js') bare-specifier — which resolves relative
to the smoke script's location (repo root), not the CLI package.

In CI, sql.js is only installed under v3/@claude-flow/cli/node_modules.
Fix: use createRequire scoped to the CLI dist path so Node resolves
sql.js from the correct node_modules. Passes locally and in CI.

Tracking: #2128

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(smoke): resolve sql.js from v3 workspace root not cli dist path

createRequire from v3/@claude-flow/cli/dist/src/... doesn't find sql.js
because pnpm hoists it to v3/node_modules/ (workspace root), not the
individual package node_modules.

Fix: use createRequire(v3/package.json) as the base — this resolves
from v3/node_modules/ which is where pnpm installs shared deps with
default hoist settings.

Tracking: #2128

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(ci): #ADR-130 P1 — install root sql.js + symlink into v3/

graph-schema-smoke imports sql.js via createRequire on v3/package.json,
but sql.js is a transitive dep at the repo root — not declared in any
workspace package.json. `cd v3 && pnpm install` doesn't hoist it, so the
smoke fails with "Cannot find module 'sql.js'".

Same fix pattern as the #2120 memory smoke job: root `npm install` for
sql.js, then symlink it into v3/node_modules so the v3-scoped require
resolves correctly. No duplicate install.

Co-Authored-By: RuFlo <ruflo-bot@users.noreply.github.com>

* fix(ci): ADR-130 — switch graph smoke scripts to bare sql.js import

The createRequire(v3/package.json) pattern failed in CI because pnpm
install inside v3/ does not reliably expose sql.js to scripts run
from the repo root. Switch both smoke scripts to `await import('sql.js')`
(bare ESM specifier) which resolves from root node_modules — the same
pattern used by smoke-memory-stats-legacy-db.mjs which passes CI.

All 5 graph CI jobs now have an `npm install --legacy-peer-deps` root
deps step before the pnpm build step. The stale symlink step in the
graph-schema job is removed.

Co-Authored-By: RuFlo <ruv@ruv.net>

* fix(ci): #ADR-130 P2+P5 — same sql.js install + symlink for query/pathfinder smoke

Smoke passes locally (21/0) but fails CI (3/17) with "graph_edges DB
unavailable" — same root cause as the P1 smoke: sql.js isn't hoisted
into v3/node_modules where the v3-scoped createRequire expects it.

Apply the same fix: root `npm install` for sql.js, then symlink into
v3/node_modules.

Co-Authored-By: RuFlo <ruflo-bot@users.noreply.github.com>

---------

Co-authored-by: RuFlo <ruflo-bot@users.noreply.github.com>
 2026-05-24 23:46:50 -04:00
Reuven 02eee0bcdc docs(adr): bulk-update plugin contract ADR statuses (sweep) 
- 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>
 2026-05-09 15:10:42 -04:00
Reuven 003624f740 feat(ruflo-plugin-creator): v0.2.0 — scaffold the canonical contract + MCP-drift warnings (ADR-0001) 
The meta-plugin that creates new plugins now (a) follows the same
contract every other plugin adopted, and (b) propagates that contract
to every newly-scaffolded plugin. The retrofit work the loop is doing
right now becomes unnecessary for new plugins.

Drift fixed:
- create-plugin skill claimed "19 AgentDB controllers" (the same myth
  ruflo-agentdb ADR-0001 killed). Replaced with "15 controller-bridge
  tools; defer to agentdb_controllers runtime for canonical list".

Scaffolder updates (the create-plugin skill now generates):
- docs/adrs/0001-<name>-contract.md (Proposed)
- scripts/smoke.sh (≥8 structural checks)
- README sections: Compatibility (pin v3.6), Namespace coordination
  (defers to ruflo-agentdb ADR-0001), Verification, Architecture Decisions
- "MCP-tool drift to avoid" section warning new authors about the four
  real bugs found in sibling ADRs:
    1. embeddings_embed does not exist (use embeddings_generate)
    2. agentdb_hierarchical-* ignores namespace arg (use tier or memory_*)
    3. agentdb_pattern-* ignores namespace arg (ReasoningBank routes;
       fallback writes to pattern reserved)
    4. pattern (singular) ≠ patterns (plural) — different reserved namespaces

Plugin contract additions:
- ADR-0001 (Proposed) at docs/adrs/0001-plugin-creator-contract.md
- README adds Compatibility (pin v3.6), Canonical plugin contract block
  showing the scaffolded directory shape, MCP-tool drift table,
  Verification + Architecture Decisions
- plugin.json bumps 0.1.0 → 0.2.0; description names the canonical
  contract; keywords add mcp, scaffolding, contract-bootstrap
- scripts/smoke.sh — 10 structural checks: version + keywords, both
  skills + agent + command, scaffolder generates ADR + smoke + Compat +
  Namespace, scaffolder includes MCP-drift warnings, regression check
  on "19 controllers", v3.6 pin, Architecture Decisions section,
  ADR Proposed, validate-plugin present, no wildcard tools

Verification: bash plugins/ruflo-plugin-creator/scripts/smoke.sh → 10/10

Co-Authored-By: RuFlo <ruv@ruv.net>
 2026-05-04 20:29:01 -04:00
Reuven f25bcf2073 feat: add 10 new ruflo plugins, optimize all 32, add READMEs and user guide 
New plugins: ruflo-adr (ADR lifecycle), ruflo-ddd (domain-driven design),
ruflo-sparc (SPARC methodology), ruflo-neural-trader (trading strategies),
ruflo-ruvector (vector embeddings), ruflo-knowledge-graph (entity graphs),
ruflo-market-data (OHLCV ingestion), ruflo-migrations (schema management),
ruflo-observability (logging/tracing), ruflo-cost-tracker (token budgets).

Optimizations across all 32 plugins:
- All pass `claude plugin validate` (removed invalid manifest arrays)
- 51/51 skills have argument-hint frontmatter
- Model routing: 4 haiku, 24 sonnet, 2 opus (cost-optimized)
- Neural learning hooks on 25/30 agents
- Cross-references between 6 related plugin pairs
- Pathfinder graph traversal algo for researcher agent
- READMEs for all 32 plugins + plugins/README.md catalog
- discover-plugins skill updated with full 32-plugin catalog

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-04-29 23:46:54 -04:00
Reuven 0ced9bf85f fix: remove invalid skills/commands/agents arrays from plugin creator template 
The create-plugin skill was instructing agents to generate plugin.json
with skills, commands, and agents arrays — these fields cause
claude plugin validate to fail. Claude Code auto-discovers them.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-04-27 23:46:03 -04:00
Reuven 81418649c6 feat: add 19 Claude Code native plugins with 64 skills, 25 commands, 21 agents 
Complete plugin marketplace for Ruflo with validated Claude Code plugin format:

- ruflo-core: MCP server, status, doctor, plugin discovery
- ruflo-swarm: swarm coordination, Monitor, worktree isolation
- ruflo-autopilot: autonomous /loop completion with learning
- ruflo-intelligence: SONA neural patterns, trajectory learning, routing
- ruflo-agentdb: AgentDB controllers, HNSW vector search, RuVector
- ruflo-aidefence: AI safety scanning, PII detection, prompt defense
- ruflo-browser: Playwright browser automation, testing, scraping
- ruflo-jujutsu: git diff analysis, risk scoring, reviewer recs
- ruflo-wasm: sandboxed WASM agents and gallery sharing
- ruflo-workflows: workflow templates, orchestration, lifecycle
- ruflo-daa: Dynamic Agentic Architecture, cognitive patterns
- ruflo-ruvllm: local LLM inference, MicroLoRA, SONA, chat format
- ruflo-rvf: RVF portable memory, session persistence, transfer
- ruflo-loop-workers: background /loop workers, CronCreate
- ruflo-security-audit: CVE scanning, dependency checks
- ruflo-rag-memory: simple store/search/recall interface
- ruflo-testgen: test gap detection, TDD workflow
- ruflo-docs: doc generation, drift detection
- ruflo-plugin-creator: scaffold, validate, publish new plugins

All 19 pass `claude plugin validate`. Skills auto-discovered from
directory structure (not declared in plugin.json). Each skill wires
to ruflo MCP tools via allowed-tools frontmatter.

Includes: marketplace.json, GitHub Pages storefront, CI validation
workflow, minimalist README with USERGUIDE split.

Co-Authored-By: claude-flow <ruv@ruv.net>
 2026-04-27 23:07:33 -04:00