@relayflows/core 0.0.1 → 1.0.0

package/dist/builtin-templates/code-review.yaml

@@ -0,0 +1,137 @@
+version: '1.0'
+name: code-review
+description: 'Blueprint-style parallel code review with deterministic diff capture.'
+swarm:
+  pattern: fan-out
+  maxConcurrency: 4
+  timeoutMs: 2400000
+  channel: swarm-code-review
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Aggregates review output and final recommendations'
+    permissions: { access: full }
+  - name: reviewer-architecture
+    cli: codex
+    role: 'Assesses architecture and maintainability'
+    permissions: { access: readonly }
+    interactive: false
+  - name: reviewer-correctness
+    cli: claude
+    role: 'Assesses correctness and testing'
+    permissions: { access: readonly }
+    interactive: false
+  - name: reviewer-security
+    cli: gemini
+    role: 'Assesses security posture and abuse resistance'
+    permissions: { access: readonly }
+    interactive: false
+workflows:
+  - name: parallel-review
+    description: 'Run focused reviews in parallel and synthesize final guidance.'
+    onError: fail
+    preflight:
+      - command: git diff --stat HEAD~1 2>/dev/null || git diff --stat 2>/dev/null || echo "No diff available"
+        description: 'Check there are changes to review'
+    steps:
+      # Deterministic: Capture diff for review
+      - name: capture-diff
+        type: deterministic
+        command: git diff HEAD~1 2>/dev/null || git diff 2>/dev/null || echo "No changes"
+        captureOutput: true
+
+      # Deterministic: Capture file list
+      - name: capture-files
+        type: deterministic
+        dependsOn: [capture-diff]
+        command: git diff --name-only HEAD~1 2>/dev/null || git diff --name-only 2>/dev/null || echo "No files"
+
+      # Agent: Prepare context
+      - name: prepare-context
+        type: agent
+        agent: lead
+        dependsOn: [capture-diff, capture-files]
+        task: |
+          Summarize change intent, impacted modules, and review priorities:
+          {{task}}
+
+          Changed files: {{steps.capture-files.output}}
+        verification:
+          type: output_contains
+          value: REVIEW_CONTEXT_READY
+
+      # Agent: Architecture review (parallel)
+      - name: architecture-pass
+        type: agent
+        agent: reviewer-architecture
+        dependsOn: [prepare-context]
+        task: |
+          Review architecture, coupling, and long-term maintainability:
+          {{steps.prepare-context.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+        verification:
+          type: output_contains
+          value: ARCH_REVIEW_COMPLETE
+
+      # Agent: Correctness review (parallel)
+      - name: correctness-pass
+        type: agent
+        agent: reviewer-correctness
+        dependsOn: [prepare-context]
+        task: |
+          Review behavior, tests, and likely regression paths:
+          {{steps.prepare-context.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+        verification:
+          type: output_contains
+          value: CORRECTNESS_REVIEW_COMPLETE
+
+      # Agent: Security review (parallel)
+      - name: security-pass
+        type: agent
+        agent: reviewer-security
+        dependsOn: [prepare-context]
+        task: |
+          Review attack surface, secret handling, and input validation:
+          {{steps.prepare-context.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+        verification:
+          type: output_contains
+          value: SECURITY_REVIEW_COMPLETE
+
+      # Agent: Consolidate findings
+      - name: consolidate
+        type: agent
+        agent: lead
+        dependsOn: [architecture-pass, correctness-pass, security-pass]
+        task: |
+          Produce merged findings, severity levels, and final recommendation.
+          Architecture review: {{steps.architecture-pass.output}}
+          Correctness review: {{steps.correctness-pass.output}}
+          Security review: {{steps.security-pass.output}}
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: reviews-complete
+      waitFor: [architecture-pass, correctness-pass, security-pass]
+      timeoutMs: 900000
+  consensusStrategy: majority
+state:
+  backend: memory
+  ttlMs: 21600000
+  namespace: code-review
+errorHandling:
+  strategy: fail-fast
+  notifyChannel: swarm-code-review

package/dist/builtin-templates/competitive.yaml

@@ -0,0 +1,107 @@
+version: '1.0'
+name: competitive
+description: 'Multiple agents independently implement solutions, then compare and select the best approach.'
+swarm:
+  pattern: competitive
+  maxConcurrency: 4
+  timeoutMs: 5400000
+  channel: swarm-competitive
+agents:
+  - name: lead
+    cli: claude
+    role: 'Defines spec, judges implementations, and selects winner'
+    permissions: { access: readwrite }
+  - name: team-alpha
+    cli: claude
+    role: 'Independent implementation team A'
+    permissions: { access: readwrite }
+  - name: team-beta
+    cli: codex
+    role: 'Independent implementation team B'
+    permissions: { access: readwrite }
+  - name: team-gamma
+    cli: gemini
+    role: 'Independent implementation team C'
+    permissions: { access: readwrite }
+workflows:
+  - name: competitive-build
+    description: 'Independent parallel implementations followed by comparison and selection.'
+    onError: fail
+    steps:
+      - name: define-spec
+        agent: lead
+        task: |
+          Define clear requirements, acceptance criteria, and evaluation rubric:
+          {{task}}
+        verification:
+          type: output_contains
+          value: SPEC_COMPLETE
+      - name: implement-alpha
+        agent: team-alpha
+        dependsOn: [define-spec]
+        task: |
+          Implement solution independently based on spec:
+          {{steps.define-spec.output}}
+
+          Do not coordinate with other teams. Focus on your best approach.
+        verification:
+          type: output_contains
+          value: IMPLEMENTATION_COMPLETE
+      - name: implement-beta
+        agent: team-beta
+        dependsOn: [define-spec]
+        task: |
+          Implement solution independently based on spec:
+          {{steps.define-spec.output}}
+
+          Do not coordinate with other teams. Focus on your best approach.
+        verification:
+          type: output_contains
+          value: IMPLEMENTATION_COMPLETE
+      - name: implement-gamma
+        agent: team-gamma
+        dependsOn: [define-spec]
+        task: |
+          Implement solution independently based on spec:
+          {{steps.define-spec.output}}
+
+          Do not coordinate with other teams. Focus on your best approach.
+        verification:
+          type: output_contains
+          value: IMPLEMENTATION_COMPLETE
+      - name: compare-solutions
+        agent: lead
+        dependsOn: [implement-alpha, implement-beta, implement-gamma]
+        task: |
+          Compare all implementations against the evaluation rubric.
+
+          Team Alpha: {{steps.implement-alpha.output}}
+          Team Beta: {{steps.implement-beta.output}}
+          Team Gamma: {{steps.implement-gamma.output}}
+
+          Analyze trade-offs, strengths, and weaknesses of each approach.
+        verification:
+          type: output_contains
+          value: COMPARISON_COMPLETE
+      - name: select-winner
+        agent: lead
+        dependsOn: [compare-solutions]
+        task: |
+          Select the winning implementation or synthesize the best elements.
+          Provide rationale and integration plan.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: implementations-complete
+      waitFor: [implement-alpha, implement-beta, implement-gamma]
+      timeoutMs: 3600000
+  consensusStrategy: majority
+state:
+  backend: memory
+  ttlMs: 21600000
+  namespace: competitive
+errorHandling:
+  strategy: continue
+  notifyChannel: swarm-competitive

package/dist/builtin-templates/documentation.yaml

@@ -0,0 +1,128 @@
+version: '1.0'
+name: documentation
+description: 'Blueprint-style documentation workflow with deterministic file operations.'
+swarm:
+  pattern: handoff
+  maxConcurrency: 1
+  timeoutMs: 3000000
+  channel: swarm-documentation
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Owns final editorial sign-off'
+  - name: researcher
+    cli: codex
+    role: 'Collects technical context and source details'
+    interactive: false
+  - name: writer
+    cli: codex
+    role: 'Drafts user-facing documentation'
+    permissions:
+      access: readwrite
+      files:
+        write: ['docs/**', '*.md', 'web/content/**']
+    interactive: false
+  - name: editor
+    cli: claude
+    role: 'Edits for accuracy, clarity, and structure'
+    permissions:
+      access: readwrite
+      files:
+        write: ['docs/**', '*.md', 'web/content/**']
+workflows:
+  - name: docs-production
+    description: 'Gather context, draft docs, edit, and publish summary.'
+    onError: skip
+    preflight:
+      - command: git status --porcelain
+        failIf: non-empty
+        description: 'Ensure working directory is clean'
+    steps:
+      # Deterministic: List existing docs
+      - name: list-docs
+        type: deterministic
+        command: find . -name "*.md" -o -name "*.mdx" 2>/dev/null | head -50 || echo "No docs found"
+
+      # Agent: Gather context
+      - name: gather-context
+        type: agent
+        agent: researcher
+        dependsOn: [list-docs]
+        task: |
+          Collect source context and required updates:
+          {{task}}
+
+          Existing documentation files:
+          {{steps.list-docs.output}}
+        verification:
+          type: output_contains
+          value: CONTEXT_COMPLETE
+
+      # Deterministic: Create docs branch
+      - name: create-branch
+        type: deterministic
+        dependsOn: [gather-context]
+        command: git checkout -b docs/{{branch-name}}
+
+      # Agent: Draft documentation
+      - name: draft
+        type: agent
+        agent: writer
+        dependsOn: [create-branch]
+        task: |
+          Draft documentation updates based on gathered context:
+          {{steps.gather-context.output}}
+        verification:
+          type: output_contains
+          value: DRAFT_COMPLETE
+
+      # Agent: Edit draft
+      - name: edit
+        type: agent
+        agent: editor
+        dependsOn: [draft]
+        task: |
+          Edit the draft for technical accuracy and readability:
+          {{steps.draft.output}}
+        verification:
+          type: output_contains
+          value: EDIT_COMPLETE
+
+      # Deterministic: Commit docs
+      - name: commit
+        type: deterministic
+        dependsOn: [edit]
+        command: 'git add -A && git commit -m "docs: {{steps.gather-context.output | first-line}}"'
+
+      # Deterministic: Push
+      - name: push
+        type: deterministic
+        dependsOn: [commit]
+        command: git push origin docs/{{branch-name}}
+
+      # Agent: Publish summary
+      - name: publish-summary
+        type: agent
+        agent: lead
+        dependsOn: [push]
+        task: |
+          Publish a final summary of documentation changes and open items.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: docs-ready
+      waitFor: [gather-context, draft, edit]
+      timeoutMs: 600000
+state:
+  backend: memory
+  ttlMs: 259200000
+  namespace: documentation
+errorHandling:
+  strategy: continue
+  notifyChannel: swarm-documentation

package/dist/builtin-templates/feature-dev.yaml

@@ -0,0 +1,146 @@
+version: '1.0'
+name: feature-dev
+description: 'Blueprint-style feature development with deterministic quality gates.'
+swarm:
+  pattern: hub-spoke
+  maxConcurrency: 2
+  timeoutMs: 3600000
+  channel: swarm-feature-dev
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Lead engineer coordinating delivery'
+    permissions: { access: full }
+  - name: planner
+    cli: codex
+    role: 'Plans implementation and acceptance criteria'
+    permissions: { access: readonly }
+    interactive: false
+  - name: developer
+    cli: codex
+    role: 'Implements planned changes'
+    permissions: { access: readwrite }
+    interactive: false
+  - name: reviewer
+    cli: claude
+    role: 'Reviews code quality and release risk'
+    permissions: { access: readonly }
+workflows:
+  - name: feature-delivery
+    description: 'Plan, implement, review, and finalize a feature request with quality gates.'
+    onError: retry
+    preflight:
+      - command: git status --porcelain
+        failIf: non-empty
+        description: 'Ensure working directory is clean'
+      - command: npm run type-check 2>/dev/null || echo "skip"
+        description: 'Run type checking if available'
+    steps:
+      # Agent: Planning
+      - name: plan
+        type: agent
+        agent: planner
+        task: |
+          Analyze the feature request and produce a concrete implementation plan:
+          {{task}}
+        retries: 1
+        verification:
+          type: output_contains
+          value: PLAN_COMPLETE
+
+      # Deterministic: Create feature branch
+      - name: create-branch
+        type: deterministic
+        dependsOn: [plan]
+        command: git checkout -b feature/{{branch-name}}
+
+      # Agent: Implementation
+      - name: implement
+        type: agent
+        agent: developer
+        dependsOn: [create-branch]
+        task: |
+          Implement the approved plan:
+          {{steps.plan.output}}
+        retries: 1
+        verification:
+          type: output_contains
+          value: IMPLEMENTATION_COMPLETE
+
+      # Deterministic: Lint
+      - name: lint
+        type: deterministic
+        dependsOn: [implement]
+        command: npm run lint:fix 2>/dev/null || npm run lint 2>/dev/null || echo "No lint configured"
+
+      # Deterministic: Run tests
+      - name: test
+        type: deterministic
+        dependsOn: [lint]
+        command: npm test 2>/dev/null || echo "No tests configured"
+
+      # Agent: Fix any failures (with iteration limit)
+      - name: fix-failures
+        type: agent
+        agent: developer
+        dependsOn: [test]
+        task: |
+          Review test results and fix any failures. If all tests passed, output TESTS_PASSED.
+          Test output: {{steps.test.output}}
+        maxIterations: 2
+        verification:
+          type: output_contains
+          value: TESTS_PASSED
+
+      # Deterministic: Stage and commit
+      - name: commit
+        type: deterministic
+        dependsOn: [fix-failures]
+        command: 'git add -A && git commit -m "feat: {{steps.plan.output | first-line}}"'
+
+      # Agent: Code review
+      - name: review
+        type: agent
+        agent: reviewer
+        dependsOn: [commit]
+        task: |
+          Review implementation quality, correctness, and test coverage:
+          {{steps.implement.output}}
+        verification:
+          type: output_contains
+          value: REVIEW_COMPLETE
+
+      # Deterministic: Push to remote
+      - name: push
+        type: deterministic
+        dependsOn: [review]
+        command: git push origin feature/{{branch-name}}
+
+      # Agent: Finalize
+      - name: finalize
+        type: agent
+        agent: lead
+        dependsOn: [push]
+        task: |
+          Summarize decisions and ship readiness for the feature.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: delivery-ready
+      waitFor: [plan, implement, review]
+      timeoutMs: 900000
+state:
+  backend: memory
+  ttlMs: 86400000
+  namespace: feature-dev
+errorHandling:
+  strategy: retry
+  maxRetries: 2
+  retryDelayMs: 5000
+  notifyChannel: swarm-feature-dev

package/dist/builtin-templates/refactor.yaml

@@ -0,0 +1,145 @@
+version: '1.0'
+name: refactor
+description: 'Blueprint-style refactor workflow with deterministic quality gates.'
+swarm:
+  pattern: hierarchical
+  maxConcurrency: 2
+  timeoutMs: 4500000
+  channel: swarm-refactor
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Owns scope, sequencing, and acceptance'
+    permissions: { access: full }
+  - name: architect
+    cli: codex
+    role: 'Designs target architecture and migration plan'
+    permissions: { access: readwrite }
+    interactive: false
+  - name: refactorer
+    cli: codex
+    role: 'Executes scoped refactor changes'
+    permissions: { access: readwrite }
+    interactive: false
+  - name: tester
+    cli: claude
+    role: 'Validates behavior parity and risk'
+    permissions: { access: readonly }
+workflows:
+  - name: refactor-execution
+    description: 'Analyze current system, design approach, refactor, and validate.'
+    onError: retry
+    preflight:
+      - command: git status --porcelain
+        failIf: non-empty
+        description: 'Ensure working directory is clean'
+      - command: npm test 2>/dev/null || echo "baseline"
+        description: 'Capture baseline test results'
+    steps:
+      # Agent: Analyze current design
+      - name: analyze
+        type: agent
+        agent: architect
+        task: |
+          Analyze current design and identify refactor opportunities:
+          {{task}}
+        verification:
+          type: output_contains
+          value: ANALYSIS_COMPLETE
+
+      # Agent: Design refactor plan
+      - name: design
+        type: agent
+        agent: architect
+        dependsOn: [analyze]
+        task: |
+          Provide incremental refactor plan with rollback notes:
+          {{steps.analyze.output}}
+        verification:
+          type: output_contains
+          value: PLAN_COMPLETE
+
+      # Deterministic: Create refactor branch
+      - name: create-branch
+        type: deterministic
+        dependsOn: [design]
+        command: git checkout -b refactor/{{branch-name}}
+
+      # Agent: Execute refactor
+      - name: refactor-code
+        type: agent
+        agent: refactorer
+        dependsOn: [create-branch]
+        task: |
+          Execute the refactor plan while preserving behavior:
+          {{steps.design.output}}
+        retries: 2
+        verification:
+          type: output_contains
+          value: REFACTOR_COMPLETE
+
+      # Deterministic: Run linting
+      - name: lint
+        type: deterministic
+        dependsOn: [refactor-code]
+        command: npm run lint:fix 2>/dev/null || npm run lint 2>/dev/null || echo "No lint configured"
+
+      # Deterministic: Run tests
+      - name: test
+        type: deterministic
+        dependsOn: [lint]
+        command: npm test
+
+      # Agent: Validate behavior parity
+      - name: validate
+        type: agent
+        agent: tester
+        dependsOn: [test]
+        task: |
+          Validate no regressions and ensure tests/quality checks pass:
+          {{steps.refactor-code.output}}
+          Test results: {{steps.test.output}}
+        verification:
+          type: output_contains
+          value: VALIDATION_COMPLETE
+
+      # Deterministic: Commit
+      - name: commit
+        type: deterministic
+        dependsOn: [validate]
+        command: 'git add -A && git commit -m "refactor: {{steps.design.output | first-line}}"'
+
+      # Deterministic: Push
+      - name: push
+        type: deterministic
+        dependsOn: [commit]
+        command: git push origin refactor/{{branch-name}}
+
+      # Agent: Handoff
+      - name: handoff
+        type: agent
+        agent: lead
+        dependsOn: [push]
+        task: |
+          Produce final refactor summary and open follow-up items.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: refactor-ready
+      waitFor: [analyze, design, refactor-code, validate]
+      timeoutMs: 900000
+state:
+  backend: memory
+  ttlMs: 604800000
+  namespace: refactor
+errorHandling:
+  strategy: retry
+  maxRetries: 2
+  retryDelayMs: 5000
+  notifyChannel: swarm-refactor