ruvnet__ruflo/plugins/ruflo-workflows/commands/workflow.md at a73a2cbe32299d7635eee6b42ee32ce5bdb01fd7

mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00

Files

T

rUv a73a2cbe32 fix(routing): stale route cache + --explore false (3.10.8) (#2229 )

* feat(workflows): add native Workflow JS orchestration surface (ADR-0002)

ruflo-workflows now documents both workflow surfaces: the existing 10
workflow_* MCP tools and the native Claude Code Workflow JS capability
(.claude/workflows/*.js — agent/parallel/pipeline/phase fan-out).

- ADR-0002 (Accepted): adopts native orchestration alongside the MCP surface
- Reference workflow .claude/workflows/plugin-contract-audit.js (fans smoke
  contracts across all plugins, diagnoses failures in parallel)
- README: native orchestration section + four-hook API + surface decision table
- workflow-create/workflow-run skills, workflow-specialist agent, /workflow
  command made surface-aware
- plugin.json 0.3.0 -> 0.4.0; native-workflow keywords + component block
- smoke.sh reconciled (stale version + ADR-0001 status) and extended 11 -> 15
  checks; smoke-gaia.sh version assertion bumped to 0.4.0

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

* fix(routing): #bugB stale route cache + #bugC --explore false (3.10.8)

Two routing-learning correctness bugs from the intelligence audit's remaining
punch-list (docs/reviews/intelligence-system-audit-2026-05-29.md §Remediation).

- Bug B (stale route cache): QLearningRouter.update() only invalidated the
  whole route cache every 50 updates, so a freshly-learned Q-update stayed
  hidden behind a stale cached decision — feedback appeared to have no effect
  on routing in-process until 50 updates accumulated. Now update() invalidates
  the updated state's cache entry immediately (new invalidateCacheEntry).
  Verified: learned route flips coder→researcher within 10 updates (was 50+).

- Bug C (--explore false ignored): boolean flags dropped an explicit space-form
  value, forcing a default-true boolean (explore) to true even with
  , so exploitation could never be forced. parser.ts now
  consumes a true/false literal for boolean flags (--explore false / -e false),
  while --explore=false and --no-explore keep working. Verified deterministic.

+4 regression tests (15/15 bug-cluster pass); 52/52 parser tests pass; cli
build clean. Audit doc updated with full remediation status (3.10.7 + 3.10.8
shipped; SONA-default/MicroLoRA/EWC-Fisher/per-task-bandit deferred with
honest rationale — the latter two need an ADR/upstream fix, not a patch).

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

2026-05-29 13:02:15 -04:00

859 B

Raw Blame History

name, description

name	description
workflow	Workflow management -- list MCP workflows + templates and native .claude/workflows/*.js scripts

Manage workflows across both surfaces:

MCP workflows (persisted, lifecycle)

Call mcp__claude-flow__workflow_list to show all defined workflows
Call mcp__claude-flow__workflow_template to show available templates
Show workflow IDs, status (running/paused/completed), and step progress

Native workflows (`.claude/workflows/*.js`)

List the native orchestration scripts: ls .claude/workflows/*.js (each file's meta.name is its invocable name)
For each, read the export const meta block and show name + description + phase titles
Run one with the Workflow tool — Workflow({ name }) — or author a new one via the workflow-create skill

See ADR-0002 for when to use which surface.

859 B Raw Blame History

MCP workflows (persisted, lifecycle)

Native workflows (.claude/workflows/*.js)

859 B

Raw Blame History

Native workflows (`.claude/workflows/*.js`)