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

Files

T

Reuven d9db4e7663 feat(ruflo-workflows): v0.2.0 — adopt plugin contract + 10-tool MCP surface + lifecycle state machine (ADR-0001)

This is the FINAL plugin in the ruflo family. ADR-0001 here completes
the plugin-contract retrofit across all 33 plugins.

Surface: 10 workflow_* MCP tools (create/run/execute/status/list/pause/
resume/cancel/delete/template) backed by full state machine
(created → running ↔ paused → completed/cancelled).

- ADR-0001 (Proposed) at docs/adrs/0001-workflows-contract.md
- README adds Compatibility (pin v3.6), 10-tool MCP surface table,
  Lifecycle state machine diagram + transition table (5 states +
  4 transitions), workflow_execute documented as stateless path,
  Namespace coordination (claims workflows-state; defers to
  ruflo-agentdb ADR-0001), Verification + Architecture Decisions
- plugin.json bumps 0.1.0 → 0.2.0; description names the 10 tools +
  state machine; keywords add mcp, workflow-templates, pause-resume,
  lifecycle
- scripts/smoke.sh — 11 structural checks: version + keywords, both
  skills + agent + command present, all 10 workflow_* tools referenced,
  v3.6 pin, namespace coordination, workflows-state claimed, 5
  lifecycle states + 4 transitions documented, workflow_execute
  stateless path, ADR Proposed, no wildcard tools

Verification: bash plugins/ruflo-workflows/scripts/smoke.sh → 11/11

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

2026-05-04 20:49:54 -04:00

3.3 KiB

Raw Blame History

ruflo-workflows

Workflow automation with templates, orchestration, and full state-machine lifecycle management.

Install

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-workflows@ruflo

Features

Workflow creation: Define multi-step processes with conditions and parallel execution
Templates: Reusable workflow patterns for common operations
Lifecycle management: Execute, pause, resume, cancel running workflows
Approval gates: Manual pause points for human review

Commands

/workflow -- List workflows, check status, view templates

Skills

workflow-create -- Create reusable workflow templates
workflow-run -- Execute and manage running workflows

Compatibility

CLI: pinned to @claude-flow/cli v3.6 major+minor.
Verification: bash plugins/ruflo-workflows/scripts/smoke.sh is the contract.

MCP surface (10 tools)

All defined at v3/@claude-flow/cli/src/mcp-tools/workflow-tools.ts:

Tool	Purpose
`workflow_create`	Create a new workflow definition
`workflow_run`	Run a workflow with inputs
`workflow_execute`	Execute a one-shot workflow without persistence
`workflow_status`	Inspect a running workflow
`workflow_list`	List workflows
`workflow_pause`	Pause a running workflow
`workflow_resume`	Resume a paused workflow
`workflow_cancel`	Cancel a workflow
`workflow_delete`	Delete a workflow definition
`workflow_template`	Manage workflow templates

Lifecycle state machine

created ──run──→ running ──pause──→ paused ──resume──→ running
                    │                  │
                    │                  └──cancel──→ cancelled
                    │
                    ├──complete──→ completed
                    └──cancel────→ cancelled

State	Allowed transitions
`created`	`running` (via `workflow_run`), `cancelled` (via `workflow_cancel`)
`running`	`paused` (via `workflow_pause`), `completed` (auto), `cancelled` (via `workflow_cancel`)
`paused`	`running` (via `workflow_resume`), `cancelled` (via `workflow_cancel`)
`completed`	terminal
`cancelled`	terminal

workflow_execute is the stateless path — fire-and-forget, no persisted state machine.

Namespace coordination

This plugin owns the workflows-state AgentDB namespace (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

workflows-state indexes workflow definitions, current state, run history, and template metadata. Accessed via memory_* (namespace-routed).

Verification

bash plugins/ruflo-workflows/scripts/smoke.sh
# Expected: "11 passed, 0 failed"

Architecture Decisions

ADR-0001 — ruflo-workflows plugin contract (10-tool MCP surface, lifecycle state machine, smoke as contract)

ruflo-agentdb — namespace convention owner
ruflo-loop-workers — sibling automation surface (loops are recurring; workflows are stateful pipelines)
ruflo-sparc — SPARC phase transitions can be modeled as workflows

3.3 KiB Raw Blame History