@orchestrator-claude/cli 1.7.2 → 1.7.3

package/dist/templates/workflows/README.md

@@ -0,0 +1,137 @@
+# Built-in Workflow Templates
+
+This directory contains the built-in workflow templates for the Orchestrator system. Each workflow defines a standardized process for different types of development tasks.
+
+## Available Workflows
+
+### 1. Feature Development (`feature-development.json`)
+
+**Purpose**: Standard workflow for implementing new features
+
+**Triggers**: `feature`, `new feature`, `implement`, `create`, `add`, `build`
+
+**Phases**:
+1. **RESEARCH** (optional) - Research and gather context
+2. **SPECIFY** - Generate specification document
+3. **PLAN** - Create technical implementation plan
+4. **TASKS** - Generate task backlog
+5. **IMPLEMENT** - Execute implementation (requires approval)
+
+**Quality Gates**:
+- SPECIFY, PLAN, TASKS: Require valid artifacts
+- IMPLEMENT: Tests must pass, 80% minimum coverage
+
+### 2. Bug Fix (`bug-fix.json`)
+
+**Purpose**: Workflow for fixing bugs and issues
+
+**Triggers**: `bug`, `fix`, `issue`, `error`, `broken`, `crash`, `problem`
+
+**Phases**:
+1. **ANALYZE** - Analyze and understand the bug
+2. **REPRODUCE** - Document reproduction steps
+3. **FIX** - Implement the fix (requires approval)
+4. **VERIFY** - Verify the fix works
+
+**Quality Gates**:
+- REPRODUCE: Requires valid artifact
+- FIX: Tests must pass
+- VERIFY: Tests must pass, requires valid artifact
+
+### 3. Refactoring (`refactoring.json`)
+
+**Purpose**: Workflow for code refactoring and improvements
+
+**Triggers**: `refactor`, `improve`, `cleanup`, `optimize`, `restructure`, `simplify`
+
+**Phases**:
+1. **ANALYZE** - Analyze code and identify improvements
+2. **PLAN** - Create refactoring plan
+3. **REFACTOR** - Execute refactoring (requires approval)
+4. **VERIFY** - Verify refactoring maintains functionality
+
+**Quality Gates**:
+- PLAN: Requires valid artifact
+- REFACTOR: Tests must pass, 80% minimum coverage (must maintain current)
+- VERIFY: Tests must pass
+
+## Schema
+
+All workflows must validate against: `src/domain/schemas/workflow.schema.json`
+
+## Testing
+
+Workflow templates are validated by tests in:
+`tests/unit/infrastructure/templates/workflows/built-in-workflows.test.ts`
+
+Run tests:
+```bash
+npm run test -- tests/unit/infrastructure/templates/workflows/
+```
+
+## Creating New Workflows
+
+To create a new workflow template:
+
+1. Create a JSON file in this directory following the schema
+2. Add comprehensive tests in the test file
+3. Ensure validation against the schema
+4. Document triggers, phases, and gates
+5. Update this README
+
+## Workflow Structure
+
+```json
+{
+  "name": "workflow-name",           // lowercase-with-hyphens
+  "displayName": "Display Name",
+  "description": "Detailed description",
+  "version": "1.0.0",                // Semantic version
+  "triggers": ["keyword1", "keyword2"],
+  "phases": [
+    {
+      "name": "PHASE_NAME",          // UPPERCASE_WITH_UNDERSCORES
+      "displayName": "Phase Name",
+      "agent": "agent-name",
+      "artifact": "artifact-file.md",
+      "optional": false,
+      "requiresApproval": false,
+      "gates": [
+        {
+          "type": "tests|coverage|artifact|lint|approval|custom",
+          "config": { /* gate-specific config */ }
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Gate Types
+
+- **tests**: Tests must pass before advancing
+  - Config: `{ mustPass: true }`
+- **coverage**: Code coverage requirements
+  - Config: `{ minimum: 80, maintainCurrent?: true }`
+- **artifact**: Artifact must exist and be valid
+  - Config: `{ required: true }`
+- **lint**: Linting must pass
+- **approval**: Human approval required
+- **custom**: Custom validation logic
+
+## Agent Mapping
+
+Built-in agents referenced in workflows:
+- `researcher` - Research and analysis agent
+- `specifier` - Specification generation agent
+- `planner` - Technical planning agent
+- `task-generator` - Task backlog generation agent
+- `implementer` - Code implementation agent
+- `reviewer` - Code review and verification agent
+
+## Version History
+
+- **1.0.0** (2025-01-06): Initial built-in workflows
+  - feature-development
+  - bug-fix
+  - refactoring

package/dist/templates/workflows/bug-fix.json

@@ -0,0 +1,73 @@
+{
+  "name": "bug-fix",
+  "displayName": "Bug Fix",
+  "description": "Workflow for fixing bugs and issues",
+  "version": "1.0.0",
+  "triggers": [
+    "bug",
+    "fix",
+    "issue",
+    "error",
+    "broken",
+    "crash",
+    "problem"
+  ],
+  "phases": [
+    {
+      "name": "ANALYZE",
+      "displayName": "Analysis",
+      "agent": "researcher",
+      "artifact": "bug-analysis.md",
+      "gates": []
+    },
+    {
+      "name": "REPRODUCE",
+      "displayName": "Reproduction",
+      "agent": "implementer",
+      "artifact": "reproduction-steps.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "FIX",
+      "displayName": "Fix Implementation",
+      "agent": "implementer",
+      "artifact": "fix-report.md",
+      "requiresApproval": true,
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "VERIFY",
+      "displayName": "Verification",
+      "agent": "reviewer",
+      "artifact": "verification-report.md",
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        },
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/templates/workflows/feature-development.json

@@ -0,0 +1,87 @@
+{
+  "name": "feature-development",
+  "displayName": "Feature Development",
+  "description": "Standard workflow for implementing new features",
+  "version": "1.0.0",
+  "triggers": [
+    "feature",
+    "new feature",
+    "implement",
+    "create",
+    "add",
+    "build"
+  ],
+  "phases": [
+    {
+      "name": "RESEARCH",
+      "displayName": "Research",
+      "agent": "researcher",
+      "artifact": "research-context.md",
+      "optional": true,
+      "gates": []
+    },
+    {
+      "name": "SPECIFY",
+      "displayName": "Specification",
+      "agent": "specifier",
+      "artifact": "spec.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "PLAN",
+      "displayName": "Technical Plan",
+      "agent": "planner",
+      "artifact": "plan.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "TASKS",
+      "displayName": "Task Generation",
+      "agent": "task-generator",
+      "artifact": "tasks.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "IMPLEMENT",
+      "displayName": "Implementation",
+      "agent": "implementer",
+      "artifact": "implementation-report.md",
+      "requiresApproval": true,
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        },
+        {
+          "type": "coverage",
+          "config": {
+            "minimum": 80
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/templates/workflows/legacy-analysis.json

@@ -0,0 +1,288 @@
+{
+  "id": "legacy-analysis",
+  "name": "Legacy Application Analysis",
+  "version": "1.0.0",
+  "type": "legacy_analysis",
+  "description": "Systematic analysis of legacy codebases to extract documentation, identify technical debt, and generate modernization roadmaps",
+  "phases": [
+    {
+      "id": "discover",
+      "name": "Discovery",
+      "description": "Explore codebase structure and detect technology stack",
+      "agent": "legacy-discoverer",
+      "artifacts": ["discovery-report.md"],
+      "gates": {
+        "required": ["discovery-report.md"],
+        "validations": [
+          "has-stack-detected",
+          "has-confidence-score",
+          "has-directory-structure"
+        ]
+      },
+      "requiresApproval": false,
+      "estimatedDuration": "30-60min"
+    },
+    {
+      "id": "inventory",
+      "name": "Inventory",
+      "description": "Catalog all assets, files, and components",
+      "agent": "legacy-discoverer",
+      "artifacts": ["inventory.json"],
+      "gates": {
+        "required": ["inventory.json"],
+        "validations": [
+          "has-asset-counts",
+          "has-metrics",
+          "json-valid"
+        ]
+      },
+      "requiresApproval": false,
+      "estimatedDuration": "30-60min"
+    },
+    {
+      "id": "analyze",
+      "name": "Analysis",
+      "description": "Deep analysis of code quality, technical debt, and security issues",
+      "agent": "code-archaeologist",
+      "artifacts": [
+        "analysis-report.md",
+        "dead-code-report.md",
+        "tech-debt.md"
+      ],
+      "gates": {
+        "required": ["analysis-report.md"],
+        "validations": [
+          "has-severity-classification",
+          "has-findings",
+          "no-secrets-exposed"
+        ]
+      },
+      "requiresApproval": false,
+      "estimatedDuration": "1-2h"
+    },
+    {
+      "id": "map",
+      "name": "Mapping",
+      "description": "Extract API specifications and database schema",
+      "agent": "api-extractor",
+      "secondaryAgents": ["schema-extractor"],
+      "parallelizable": true,
+      "artifacts": [
+        "api-spec.yaml",
+        "database-schema.md",
+        "integrations.md"
+      ],
+      "gates": {
+        "required": ["api-spec.yaml", "database-schema.md"],
+        "validations": [
+          "openapi-valid",
+          "has-mermaid-diagram",
+          "has-endpoints"
+        ]
+      },
+      "requiresApproval": false,
+      "estimatedDuration": "1-2h"
+    },
+    {
+      "id": "document",
+      "name": "Documentation",
+      "description": "Extract and document business rules and domain logic",
+      "agent": "business-rule-miner",
+      "artifacts": [
+        "business-rules.md",
+        "glossary.md",
+        "flow-diagrams.md"
+      ],
+      "gates": {
+        "required": ["business-rules.md"],
+        "validations": [
+          "has-rules-by-domain",
+          "has-locations",
+          "has-glossary"
+        ]
+      },
+      "requiresApproval": false,
+      "estimatedDuration": "1-2h"
+    },
+    {
+      "id": "recommend",
+      "name": "Recommendations",
+      "description": "Synthesize findings and generate migration roadmap",
+      "agent": "legacy-synthesizer",
+      "artifacts": [
+        "migration-roadmap.md",
+        "architecture-proposal.md",
+        "final-report.md"
+      ],
+      "gates": {
+        "required": ["migration-roadmap.md", "final-report.md"],
+        "validations": [
+          "has-phases",
+          "has-estimates",
+          "has-risks",
+          "has-quick-wins"
+        ]
+      },
+      "requiresApproval": true,
+      "estimatedDuration": "1-2h"
+    }
+  ],
+  "transitions": {
+    "discover": ["inventory"],
+    "inventory": ["analyze"],
+    "analyze": ["map"],
+    "map": ["document"],
+    "document": ["recommend"],
+    "recommend": []
+  },
+  "configuration": {
+    "patternSets": {
+      "basePath": ".orchestrator/patterns/legacy",
+      "fallbackBehavior": "heuristic",
+      "defaultStack": null
+    },
+    "templates": {
+      "basePath": ".orchestrator/templates/legacy"
+    },
+    "artifactPath": ".orchestrator/artifacts/legacy-analysis",
+    "allowParallelPhases": true,
+    "tokenBudgetPerPhase": 50000,
+    "checkpointFrequency": "per-phase"
+  },
+  "gates": {
+    "discover": {
+      "has-stack-detected": {
+        "type": "content-check",
+        "description": "Discovery report must identify technology stack",
+        "pattern": "Stack Detected:|Technology Stack:",
+        "severity": "CRITICAL"
+      },
+      "has-confidence-score": {
+        "type": "content-check",
+        "description": "Must include confidence score for stack detection",
+        "pattern": "Confidence:|confidence.*\\d+",
+        "severity": "HIGH"
+      },
+      "has-directory-structure": {
+        "type": "content-check",
+        "description": "Must document directory structure",
+        "pattern": "Directory Structure:|Structure:",
+        "severity": "MEDIUM"
+      }
+    },
+    "inventory": {
+      "has-asset-counts": {
+        "type": "json-field",
+        "description": "Must include counts for all asset types",
+        "field": "assets",
+        "severity": "CRITICAL"
+      },
+      "has-metrics": {
+        "type": "json-field",
+        "description": "Must include code metrics",
+        "field": "metrics",
+        "severity": "HIGH"
+      },
+      "json-valid": {
+        "type": "json-validation",
+        "description": "Inventory must be valid JSON",
+        "severity": "CRITICAL"
+      }
+    },
+    "analyze": {
+      "has-severity-classification": {
+        "type": "content-check",
+        "description": "Must classify findings by severity",
+        "pattern": "CRITICAL|HIGH|MEDIUM|LOW",
+        "severity": "CRITICAL"
+      },
+      "has-findings": {
+        "type": "content-check",
+        "description": "Must document findings",
+        "pattern": "Findings|Issues Identified",
+        "severity": "HIGH"
+      },
+      "no-secrets-exposed": {
+        "type": "security-check",
+        "description": "Must not expose secrets in reports",
+        "pattern": "password|api[_-]?key|secret|token",
+        "action": "fail-if-found",
+        "severity": "CRITICAL"
+      }
+    },
+    "map": {
+      "openapi-valid": {
+        "type": "openapi-validation",
+        "description": "API spec must be valid OpenAPI 3.0",
+        "version": "3.0",
+        "severity": "CRITICAL"
+      },
+      "has-mermaid-diagram": {
+        "type": "content-check",
+        "description": "Database schema must include Mermaid ER diagram",
+        "pattern": "```mermaid|erDiagram",
+        "severity": "HIGH"
+      },
+      "has-endpoints": {
+        "type": "content-check",
+        "description": "API spec must document endpoints",
+        "pattern": "paths:",
+        "severity": "CRITICAL"
+      }
+    },
+    "document": {
+      "has-rules-by-domain": {
+        "type": "content-check",
+        "description": "Business rules must be categorized by domain",
+        "pattern": "Domain:|Category:",
+        "severity": "HIGH"
+      },
+      "has-locations": {
+        "type": "content-check",
+        "description": "Rules must include source file locations",
+        "pattern": "Location:|File:",
+        "severity": "MEDIUM"
+      },
+      "has-glossary": {
+        "type": "artifact-exists",
+        "description": "Glossary of domain terms must exist",
+        "artifact": "glossary.md",
+        "severity": "MEDIUM"
+      }
+    },
+    "recommend": {
+      "has-phases": {
+        "type": "content-check",
+        "description": "Roadmap must include migration phases",
+        "pattern": "Phase \\d+|Migration Phase",
+        "severity": "CRITICAL"
+      },
+      "has-estimates": {
+        "type": "content-check",
+        "description": "Must include effort estimates",
+        "pattern": "Estimate:|Duration:|Effort:",
+        "severity": "HIGH"
+      },
+      "has-risks": {
+        "type": "content-check",
+        "description": "Must document risks and mitigations",
+        "pattern": "Risk:|Mitigation:",
+        "severity": "HIGH"
+      },
+      "has-quick-wins": {
+        "type": "content-check",
+        "description": "Should identify quick win opportunities",
+        "pattern": "Quick Win|Low Effort",
+        "severity": "MEDIUM"
+      }
+    }
+  },
+  "metadata": {
+    "author": "implementer-agent",
+    "created": "2026-01-23",
+    "lastUpdated": "2026-01-23",
+    "rfc": "RFC-004-LEGACY-ANALYSIS-WORKFLOW",
+    "targetVersion": "v1.7.0",
+    "status": "active"
+  }
+}

package/dist/templates/workflows/refactoring.json

@@ -0,0 +1,73 @@
+{
+  "name": "refactoring",
+  "displayName": "Refactoring",
+  "description": "Workflow for code refactoring and improvements",
+  "version": "1.0.0",
+  "triggers": [
+    "refactor",
+    "improve",
+    "cleanup",
+    "optimize",
+    "restructure",
+    "simplify"
+  ],
+  "phases": [
+    {
+      "name": "ANALYZE",
+      "displayName": "Analysis",
+      "agent": "researcher",
+      "artifact": "refactoring-analysis.md",
+      "gates": []
+    },
+    {
+      "name": "PLAN",
+      "displayName": "Refactoring Plan",
+      "agent": "planner",
+      "artifact": "refactoring-plan.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "REFACTOR",
+      "displayName": "Refactoring",
+      "agent": "implementer",
+      "artifact": "refactoring-report.md",
+      "requiresApproval": true,
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        },
+        {
+          "type": "coverage",
+          "config": {
+            "minimum": 80,
+            "maintainCurrent": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "VERIFY",
+      "displayName": "Verification",
+      "agent": "reviewer",
+      "artifact": "verification-report.md",
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/cli",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "description": "Orchestrator CLI - Thin Client",
   "type": "module",
   "main": "dist/index.js",