@orchestrator-claude/cli 1.7.2 → 1.7.3

package/dist/templates/base/.orchestrator/patterns/legacy/php/laravel.patterns.json

@@ -0,0 +1,396 @@
+{
+  "id": "php-laravel",
+  "stack": {
+    "language": "php",
+    "framework": "laravel",
+    "versions": ["6.x", "7.x", "8.x", "9.x", "10.x", "11.x"],
+    "ecosystem": "composer"
+  },
+  "detection": {
+    "indicators": [
+      {
+        "type": "file",
+        "path": "artisan",
+        "confidence": 0.90,
+        "description": "Laravel Artisan CLI tool"
+      },
+      {
+        "type": "file",
+        "path": "composer.json",
+        "contains": "laravel/framework",
+        "confidence": 0.95,
+        "description": "Laravel framework dependency in Composer"
+      },
+      {
+        "type": "file",
+        "path": "composer.json",
+        "contains": "illuminate/",
+        "confidence": 0.85,
+        "description": "Laravel Illuminate components"
+      },
+      {
+        "type": "directory",
+        "path": "app/Http/Controllers",
+        "confidence": 0.80,
+        "description": "Laravel controllers directory"
+      },
+      {
+        "type": "directory",
+        "path": "app/Models",
+        "confidence": 0.75,
+        "description": "Laravel 8+ models directory"
+      },
+      {
+        "type": "directory",
+        "path": "database/migrations",
+        "confidence": 0.80,
+        "description": "Laravel migrations directory"
+      },
+      {
+        "type": "file",
+        "path": "config/app.php",
+        "confidence": 0.70,
+        "description": "Laravel application config"
+      },
+      {
+        "type": "directory",
+        "path": "resources/views",
+        "confidence": 0.70,
+        "description": "Laravel Blade views"
+      },
+      {
+        "type": "file",
+        "path": "routes/web.php",
+        "confidence": 0.85,
+        "description": "Laravel web routes"
+      }
+    ],
+    "minConfidence": 0.80
+  },
+  "patterns": {
+    "routes": {
+      "description": "HTTP route definitions",
+      "files": [
+        "routes/web.php",
+        "routes/api.php",
+        "routes/channels.php",
+        "routes/console.php",
+        "routes/*.php"
+      ],
+      "regex": [
+        "Route::(get|post|put|patch|delete|options|any)\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "Route::resource\\s*\\(\\s*['\"]([^'\"]+)['\"]\\s*,\\s*['\"]?([^'\"]+)['\"]?",
+        "Route::apiResource\\s*\\(\\s*['\"]([^'\"]+)['\"]\\s*,\\s*['\"]?([^'\"]+)['\"]?",
+        "Route::group\\s*\\(",
+        "Route::middleware\\s*\\([^)]+\\)\\s*->\\s*(get|post|put|patch|delete)\\s*\\(\\s*['\"]([^'\"]+)['\"]"
+      ],
+      "extractors": {
+        "method": 1,
+        "path": 2,
+        "controller": 3
+      }
+    },
+    "controllers": {
+      "description": "Controller classes",
+      "files": [
+        "app/Http/Controllers/**/*.php",
+        "app/Http/Controllers/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Controller)\\s+extends\\s+Controller",
+        "class\\s+(\\w+)\\s+extends\\s+Controller",
+        "public\\s+function\\s+(index|show|store|update|destroy|create|edit)\\s*\\(",
+        "public\\s+function\\s+(\\w+)\\s*\\([^)]*Request",
+        "@param\\s+Request\\s+\\$request"
+      ],
+      "extractors": {
+        "className": 1,
+        "methodName": 1
+      }
+    },
+    "models": {
+      "description": "Eloquent models and entities",
+      "files": [
+        "app/Models/**/*.php",
+        "app/Models/*.php",
+        "app/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+)\\s+extends\\s+Model",
+        "class\\s+(\\w+)\\s+extends\\s+Authenticatable",
+        "class\\s+(\\w+)\\s+extends\\s+Pivot",
+        "protected\\s+\\$table\\s*=\\s*['\"]([^'\"]+)['\"]",
+        "protected\\s+\\$fillable\\s*=\\s*\\[",
+        "protected\\s+\\$guarded\\s*=\\s*\\[",
+        "protected\\s+\\$hidden\\s*=\\s*\\[",
+        "protected\\s+\\$casts\\s*=\\s*\\[",
+        "public\\s+function\\s+(\\w+)\\s*\\(\\)\\s*:\\s*HasMany",
+        "public\\s+function\\s+(\\w+)\\s*\\(\\)\\s*:\\s*BelongsTo",
+        "public\\s+function\\s+(\\w+)\\s*\\(\\)\\s*:\\s*BelongsToMany"
+      ],
+      "extractors": {
+        "modelName": 1,
+        "tableName": 2,
+        "relationName": 1
+      }
+    },
+    "migrations": {
+      "description": "Database migrations",
+      "files": [
+        "database/migrations/*.php"
+      ],
+      "regex": [
+        "Schema::create\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "Schema::table\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "Schema::drop\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "\\$table->(\\w+)\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "\\$table->foreign\\s*\\(\\s*['\"]([^'\"]+)['\"]",
+        "\\$table->index\\s*\\(\\s*['\"]([^'\"]+)['\"]"
+      ],
+      "extractors": {
+        "tableName": 1,
+        "columnType": 1,
+        "columnName": 2
+      }
+    },
+    "middleware": {
+      "description": "HTTP middleware",
+      "files": [
+        "app/Http/Middleware/**/*.php",
+        "app/Http/Middleware/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Middleware)",
+        "class\\s+(\\w+)\\s+",
+        "public\\s+function\\s+handle\\s*\\(\\s*Request\\s+\\$request",
+        "public\\s+function\\s+handle\\s*\\(\\s*\\$request\\s*,\\s*Closure\\s+\\$next"
+      ],
+      "extractors": {
+        "className": 1
+      }
+    },
+    "services": {
+      "description": "Service layer classes",
+      "files": [
+        "app/Services/**/*.php",
+        "app/Services/*.php",
+        "app/Service/**/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Service)",
+        "class\\s+(\\w+)\\s+",
+        "public\\s+function\\s+(\\w+)\\s*\\("
+      ],
+      "extractors": {
+        "serviceName": 1,
+        "methodName": 1
+      }
+    },
+    "repositories": {
+      "description": "Repository pattern implementations",
+      "files": [
+        "app/Repositories/**/*.php",
+        "app/Repositories/*.php",
+        "app/Repository/**/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Repository)",
+        "class\\s+(\\w+)\\s+implements\\s+\\w+RepositoryInterface",
+        "public\\s+function\\s+(find|findById|findAll|create|update|delete)\\s*\\("
+      ],
+      "extractors": {
+        "repoName": 1,
+        "methodName": 1
+      }
+    },
+    "jobs": {
+      "description": "Queue jobs and async tasks",
+      "files": [
+        "app/Jobs/**/*.php",
+        "app/Jobs/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+)\\s+implements\\s+ShouldQueue",
+        "class\\s+(\\w+Job)",
+        "public\\s+function\\s+handle\\s*\\("
+      ],
+      "extractors": {
+        "jobName": 1
+      }
+    },
+    "events": {
+      "description": "Event classes",
+      "files": [
+        "app/Events/**/*.php",
+        "app/Events/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Event)",
+        "class\\s+(\\w+)\\s+",
+        "use\\s+Dispatchable"
+      ],
+      "extractors": {
+        "eventName": 1
+      }
+    },
+    "listeners": {
+      "description": "Event listeners",
+      "files": [
+        "app/Listeners/**/*.php",
+        "app/Listeners/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Listener)",
+        "class\\s+(\\w+)\\s+",
+        "public\\s+function\\s+handle\\s*\\(\\s*(\\w+)"
+      ],
+      "extractors": {
+        "listenerName": 1,
+        "eventType": 2
+      }
+    },
+    "requests": {
+      "description": "Form request validation classes",
+      "files": [
+        "app/Http/Requests/**/*.php",
+        "app/Http/Requests/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Request)\\s+extends\\s+FormRequest",
+        "public\\s+function\\s+rules\\s*\\(\\)",
+        "public\\s+function\\s+authorize\\s*\\(\\)"
+      ],
+      "extractors": {
+        "requestName": 1
+      }
+    },
+    "tests": {
+      "description": "PHPUnit tests",
+      "files": [
+        "tests/**/*Test.php",
+        "tests/**/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+Test)\\s+extends\\s+TestCase",
+        "public\\s+function\\s+(test\\w+)\\s*\\(",
+        "@test"
+      ],
+      "extractors": {
+        "testClass": 1,
+        "testMethod": 1
+      }
+    },
+    "providers": {
+      "description": "Service providers",
+      "files": [
+        "app/Providers/**/*.php",
+        "app/Providers/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+ServiceProvider)\\s+extends\\s+ServiceProvider",
+        "public\\s+function\\s+register\\s*\\(",
+        "public\\s+function\\s+boot\\s*\\("
+      ],
+      "extractors": {
+        "providerName": 1
+      }
+    },
+    "commands": {
+      "description": "Artisan console commands",
+      "files": [
+        "app/Console/Commands/**/*.php",
+        "app/Console/Commands/*.php"
+      ],
+      "regex": [
+        "class\\s+(\\w+)\\s+extends\\s+Command",
+        "protected\\s+\\$signature\\s*=\\s*['\"]([^'\"]+)['\"]",
+        "protected\\s+\\$description\\s*=\\s*['\"]([^'\"]+)['\"]",
+        "public\\s+function\\s+handle\\s*\\("
+      ],
+      "extractors": {
+        "commandClass": 1,
+        "signature": 2,
+        "description": 3
+      }
+    },
+    "config": {
+      "description": "Configuration files",
+      "files": [
+        "config/*.php"
+      ],
+      "regex": [
+        "return\\s+\\[",
+        "['\"]([^'\"]+)['\"]\\s*=>",
+        "env\\s*\\(\\s*['\"]([^'\"]+)['\"]"
+      ],
+      "extractors": {
+        "configKey": 1,
+        "envVar": 2
+      }
+    },
+    "views": {
+      "description": "Blade template views",
+      "files": [
+        "resources/views/**/*.blade.php"
+      ],
+      "regex": [
+        "@extends\\s*\\(['\"]([^'\"]+)['\"]\\)",
+        "@section\\s*\\(['\"]([^'\"]+)['\"]\\)",
+        "@include\\s*\\(['\"]([^'\"]+)['\"]\\)",
+        "@component\\s*\\(['\"]([^'\"]+)['\"]\\)",
+        "{{\\s*\\$([a-zA-Z_]\\w*)\\s*}}"
+      ],
+      "extractors": {
+        "layoutName": 1,
+        "sectionName": 1,
+        "includeName": 1,
+        "variableName": 1
+      }
+    }
+  },
+  "metrics": {
+    "complexity": {
+      "cyclomaticComplexity": {
+        "tool": "phpmd",
+        "threshold": 10
+      },
+      "maintainabilityIndex": {
+        "tool": "phpmetrics",
+        "threshold": 65
+      }
+    },
+    "quality": {
+      "codeStandards": {
+        "tool": "phpcs",
+        "standard": "PSR-12"
+      },
+      "staticAnalysis": {
+        "tool": "phpstan",
+        "level": 5
+      }
+    }
+  },
+  "exclusions": {
+    "directories": [
+      "vendor/",
+      "node_modules/",
+      "storage/",
+      "bootstrap/cache/",
+      "public/",
+      ".git/"
+    ],
+    "files": [
+      "*.min.js",
+      "*.min.css",
+      "_ide_helper.php"
+    ]
+  },
+  "metadata": {
+    "author": "implementer-agent",
+    "created": "2026-01-23",
+    "lastUpdated": "2026-01-23",
+    "version": "1.0.0",
+    "tested": true,
+    "coverage": "Laravel 6.x - 11.x"
+  }
+}

package/dist/templates/base/.orchestrator/templates/legacy/README.md

@@ -0,0 +1,296 @@
+# Legacy Analysis Templates
+
+**Version:** 1.0
+**Created:** 2026-01-23
+**RFC:** RFC-004-LEGACY-ANALYSIS-WORKFLOW.md
+
+---
+
+## Purpose
+
+Templates provide consistent structure for artifacts generated during legacy analysis. All templates use [Handlebars](https://handlebarsjs.com/) syntax for variable interpolation and logic.
+
+---
+
+## Template Files
+
+| Template | Phase | Description |
+|----------|-------|-------------|
+| `discovery-report.md.hbs` | DISCOVER | Technology stack detection and structure overview |
+| `inventory.json.schema` | INVENTORY | JSON schema for asset catalog |
+| `analysis-report.md.hbs` | ANALYZE | Code quality and technical debt analysis |
+| `dead-code-report.md.hbs` | ANALYZE | Dead code identification and locations |
+| `tech-debt.md.hbs` | ANALYZE | Technical debt catalog with priorities |
+| `api-spec.yaml.hbs` | MAP | OpenAPI 3.0 API specification |
+| `database-schema.md.hbs` | MAP | Database schema documentation with ER diagram |
+| `business-rules.md.hbs` | DOCUMENT | Business rules extracted from code |
+| `migration-roadmap.md.hbs` | RECOMMEND | Migration strategy and phased roadmap |
+| `final-report.md.hbs` | RECOMMEND | Executive summary consolidating all findings |
+
+---
+
+## Handlebars Syntax
+
+### Variables
+
+```handlebars
+{{projectName}}
+{{stack.language}}
+{{stack.framework}}
+```
+
+### Conditionals
+
+```handlebars
+{{#if hasTests}}
+  Test coverage: {{coverage}}%
+{{else}}
+  No tests found
+{{/if}}
+```
+
+### Loops
+
+```handlebars
+{{#each routes}}
+  - {{method}} {{path}}
+{{/each}}
+```
+
+### Helpers
+
+```handlebars
+{{uppercase stack.framework}}
+{{formatDate analysis.completedAt}}
+{{pluralize issueCount "issue"}}
+```
+
+---
+
+## Severity Classification
+
+All templates that report issues MUST use this classification (from AGENT-PROMPT-STANDARDS v1.1):
+
+| Severity | Emoji | Meaning |
+|----------|-------|---------|
+| `CRITICAL` | ❌ | Blocks progress, security risk, data loss |
+| `HIGH` | ⚠️ | Significant issue, violates architecture |
+| `MEDIUM` | ⚡ | Quality issue, technical debt |
+| `LOW` | ℹ️ | Minor improvement, style |
+
+### Example Usage
+
+```markdown
+## Findings
+
+### ❌ CRITICAL
+- **SEC-001**: SQL injection vulnerability
+  - Location: `src/api/users.php:45`
+  - Impact: Data breach risk
+  - Fix: Use parameterized queries
+
+### ⚠️ HIGH
+- **ARCH-001**: Circular dependency detected
+  - Location: ServiceA -> ServiceB -> ServiceA
+  - Impact: Hard to test, fragile
+  - Fix: Introduce interface, dependency injection
+```
+
+---
+
+## Template Development Guidelines
+
+### DO
+- Use semantic variable names (`{{controllerCount}}` not `{{c}}`)
+- Include examples in comments
+- Provide fallback values for optional fields
+- Follow AGENT-PROMPT-STANDARDS severity classification
+- Use Mermaid for diagrams when applicable
+- Include location (file:line) for all findings
+
+### DON'T
+- Hardcode values (use variables)
+- Expose secrets in templates
+- Use complex logic (keep templates simple)
+- Assume all fields are present (use conditionals)
+- Mix concerns (one template per artifact type)
+
+---
+
+## Mermaid Diagrams
+
+Templates use [Mermaid](https://mermaid.js.org/) for visual diagrams:
+
+### Entity-Relationship Diagram
+
+```mermaid
+erDiagram
+    CUSTOMER ||--o{ ORDER : places
+    ORDER ||--|{ LINE_ITEM : contains
+    CUSTOMER {
+        int id PK
+        string name
+        string email UK
+    }
+```
+
+### Flowchart
+
+```mermaid
+flowchart TD
+    A[Start] --> B{Has Tests?}
+    B -->|Yes| C[Run Tests]
+    B -->|No| D[Skip Tests]
+    C --> E[Deploy]
+    D --> E
+```
+
+### Sequence Diagram
+
+```mermaid
+sequenceDiagram
+    User->>Controller: HTTP Request
+    Controller->>Service: Business Logic
+    Service->>Repository: Database Query
+    Repository-->>Service: Data
+    Service-->>Controller: Response
+    Controller-->>User: HTTP Response
+```
+
+---
+
+## Adding a New Template
+
+### 1. Create Template File
+
+```bash
+touch .orchestrator/templates/legacy/my-artifact.md.hbs
+```
+
+### 2. Define Template Structure
+
+```handlebars
+# {{artifactName}}
+
+**Generated:** {{generatedAt}}
+**Agent:** {{agentName}}
+
+---
+
+## Summary
+
+{{summary}}
+
+---
+
+## Details
+
+{{#each items}}
+### {{name}}
+- **Type:** {{type}}
+- **Location:** {{location}}
+- **Severity:** {{severity}}
+{{/each}}
+```
+
+### 3. Document Variables
+
+Add to README.md:
+
+```markdown
+### my-artifact.md.hbs
+
+**Phase:** MY_PHASE
+**Variables:**
+- `artifactName` (string): Name of the artifact
+- `generatedAt` (ISO8601): Generation timestamp
+- `agentName` (string): Generating agent
+- `summary` (string): Brief summary
+- `items` (array): List of findings
+  - `name` (string)
+  - `type` (string)
+  - `location` (string)
+  - `severity` (CRITICAL|HIGH|MEDIUM|LOW)
+```
+
+### 4. Test Template
+
+Create test data and render:
+
+```javascript
+const Handlebars = require('handlebars');
+const template = fs.readFileSync('my-artifact.md.hbs', 'utf8');
+const render = Handlebars.compile(template);
+const output = render(testData);
+```
+
+---
+
+## Variable Conventions
+
+### Naming
+- Use camelCase: `controllerCount`, `apiEndpoints`
+- Use descriptive names: `databaseTableCount` not `dbtc`
+- Use plurals for arrays: `routes`, `models`, `findings`
+
+### Types
+- **String**: `projectName`, `stackLanguage`
+- **Number**: `fileCount`, `lineOfCode`
+- **Boolean**: `hasTests`, `isLegacy`
+- **Date**: `analyzedAt`, `createdAt` (ISO8601 format)
+- **Array**: `routes`, `models`, `findings`
+- **Object**: `stack`, `metrics`, `analysis`
+
+### Required vs Optional
+
+Mark optional variables in documentation:
+
+```markdown
+- `projectName` (string, required): Project name
+- `description` (string, optional): Project description
+- `tests` (array, optional): Test files found
+```
+
+---
+
+## Validation
+
+Templates are validated before rendering:
+
+1. **Syntax Validation**: Valid Handlebars syntax
+2. **Variable Validation**: All referenced variables provided
+3. **Output Validation**: Generated artifact matches expected schema
+4. **Security Validation**: No secrets exposed in output
+
+---
+
+## References
+
+- [Handlebars Documentation](https://handlebarsjs.com/)
+- [Mermaid Documentation](https://mermaid.js.org/)
+- [AGENT-PROMPT-STANDARDS](../../../project-guidelines/agents/AGENT-PROMPT-STANDARDS.md)
+- [RFC-004 Legacy Analysis Workflow](../../../project-guidelines/rfcs/RFC-004-LEGACY-ANALYSIS-WORKFLOW.md)
+
+---
+
+## Directory Contents
+
+```
+templates/legacy/
+├── README.md                      # This file
+├── discovery-report.md.hbs        # Discovery phase
+├── inventory.json.schema          # Inventory schema
+├── analysis-report.md.hbs         # Analysis phase
+├── dead-code-report.md.hbs        # Dead code findings
+├── tech-debt.md.hbs               # Technical debt catalog
+├── api-spec.yaml.hbs              # API specification
+├── database-schema.md.hbs         # Database schema
+├── business-rules.md.hbs          # Business rules
+├── migration-roadmap.md.hbs       # Migration roadmap
+└── final-report.md.hbs            # Final report
+```
+
+---
+
+**Maintained by:** Orchestrator System
+**Last Updated:** 2026-01-23