* 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>