@orchestrator-claude/cli 1.7.2 → 1.7.3

package/dist/index.d.ts

@@ -11,5 +11,5 @@
 /**
  * CLI version
  */
-export declare const CLI_VERSION = "1.7.2";
+export declare const CLI_VERSION = "1.7.3";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -20,7 +20,7 @@ import { OutputFormatter } from './formatters/OutputFormatter.js';
 /**
  * CLI version
  */
-export const CLI_VERSION = '1.7.2';
+export const CLI_VERSION = '1.7.3';
 /**
  * Main CLI function
  */

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

@@ -0,0 +1,360 @@
+# Legacy Analysis Pattern Sets
+
+**Version:** 1.0
+**Created:** 2026-01-23
+**RFC:** RFC-004-LEGACY-ANALYSIS-WORKFLOW.md
+
+---
+
+## Purpose
+
+Pattern sets provide deterministic, regex-based detection for legacy codebases. Each pattern set targets a specific language/framework combination and defines how to identify and catalog code assets.
+
+**Design Philosophy:** ~80% deterministic (patterns) + ~20% heuristic (LLM fallback)
+
+---
+
+## Pattern Set Schema
+
+```json
+{
+  "id": "language-framework",
+  "stack": {
+    "language": "php",
+    "framework": "laravel",
+    "versions": ["8.x", "9.x", "10.x", "11.x"]
+  },
+  "detection": {
+    "indicators": [
+      {
+        "type": "file | directory | content",
+        "path": "relative/path",
+        "contains": "optional-string-match",
+        "confidence": 0.0-1.0
+      }
+    ],
+    "minConfidence": 0.8
+  },
+  "patterns": {
+    "asset-type": {
+      "files": ["glob-pattern"],
+      "regex": ["regex-pattern"],
+      "extractors": {
+        "name": "capture-group-index",
+        "metadata": "optional-additional-data"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Detection System
+
+### Confidence Scoring
+
+Detection indicators are weighted by confidence scores:
+
+| Confidence | Meaning | Example |
+|------------|---------|---------|
+| 0.95-1.0 | Definitive indicator | `composer.json` contains `laravel/framework` |
+| 0.80-0.94 | Strong indicator | `artisan` file exists at root |
+| 0.60-0.79 | Moderate indicator | `app/Http/Controllers` directory exists |
+| 0.40-0.59 | Weak indicator | `.php` files present |
+| 0.0-0.39 | Very weak | Generic directory structure |
+
+**Total confidence** = sum of matched indicators' confidence scores (capped at 1.0)
+
+**Threshold**: Stack is detected if total confidence >= `minConfidence` (default: 0.8)
+
+### Fallback Behavior
+
+If no pattern set reaches `minConfidence`:
+1. Use heuristic LLM-based detection
+2. Analyze file extensions, directory structure, imports
+3. Generate generic inventory with lower precision
+4. Warn user about reduced accuracy
+
+---
+
+## Pattern Types
+
+### 1. File Indicators
+
+Detect specific files at known locations:
+
+```json
+{
+  "type": "file",
+  "path": "artisan",
+  "confidence": 0.9
+}
+```
+
+### 2. Content Indicators
+
+Check file content for specific strings:
+
+```json
+{
+  "type": "file",
+  "path": "package.json",
+  "contains": "\"express\":",
+  "confidence": 0.85
+}
+```
+
+### 3. Directory Indicators
+
+Detect characteristic directory structures:
+
+```json
+{
+  "type": "directory",
+  "path": "app/Models",
+  "confidence": 0.7
+}
+```
+
+---
+
+## Asset Pattern Definitions
+
+Each pattern defines how to find and extract a specific type of code asset.
+
+### Pattern Structure
+
+```json
+{
+  "routes": {
+    "files": ["routes/*.php", "config/routes.ts"],
+    "regex": [
+      "Route::(get|post|put|delete)\\(['\"]([^'\"]+)['\"]",
+      "app\\.(get|post|put|delete)\\(['\"]([^'\"]+)['\"]\\"
+    ],
+    "extractors": {
+      "method": 1,
+      "path": 2
+    }
+  }
+}
+```
+
+### Common Asset Types
+
+| Asset Type | Description | Typical Locations |
+|------------|-------------|-------------------|
+| `routes` | HTTP route definitions | `routes/*.php`, `config/routes.ts` |
+| `controllers` | Controller classes | `app/Http/Controllers/**/*.php` |
+| `models` | Data models / entities | `app/Models/**/*.php` |
+| `migrations` | Database migrations | `database/migrations/*.php` |
+| `middleware` | Request middleware | `app/Http/Middleware/*.php` |
+| `services` | Service classes | `app/Services/**/*.php` |
+| `repositories` | Repository pattern classes | `app/Repositories/**/*.php` |
+| `tests` | Test files | `tests/**/*.php` |
+| `validations` | Form validators / requests | `app/Http/Requests/**/*.php` |
+
+---
+
+## Regex Guidelines
+
+### DO
+- Use named capture groups when extracting data
+- Escape special characters properly
+- Test regex against real codebase samples
+- Prefer precision over recall (false positives expensive)
+
+### DON'T
+- Use overly greedy patterns (.*?)
+- Match across multiple lines without multiline flag
+- Assume consistent formatting (handle spaces/tabs)
+- Forget to escape regex metacharacters
+
+### Examples
+
+**Good:**
+```regex
+Route::(get|post|put|delete|patch)\s*\(\s*['"]([^'"]+)['"]
+```
+
+**Bad:**
+```regex
+Route.*\(.*\)
+```
+
+---
+
+## Adding a New Pattern Set
+
+### 1. Choose Directory Structure
+
+```bash
+.orchestrator/patterns/legacy/
+├── php/
+│   ├── laravel.patterns.json
+│   └── symfony.patterns.json
+├── node/
+│   ├── express.patterns.json
+│   └── nestjs.patterns.json
+└── python/
+    ├── django.patterns.json
+    └── flask.patterns.json
+```
+
+### 2. Define Detection Indicators
+
+Start with high-confidence indicators:
+
+```json
+{
+  "detection": {
+    "indicators": [
+      {
+        "type": "file",
+        "path": "manage.py",
+        "confidence": 0.95,
+        "description": "Django management script"
+      },
+      {
+        "type": "file",
+        "path": "requirements.txt",
+        "contains": "Django",
+        "confidence": 0.90
+      }
+    ],
+    "minConfidence": 0.85
+  }
+}
+```
+
+### 3. Define Asset Patterns
+
+For each asset type, specify:
+- File glob patterns to search
+- Regex patterns to match
+- Capture groups to extract data
+
+```json
+{
+  "patterns": {
+    "views": {
+      "files": ["app/views.py", "*/views.py"],
+      "regex": [
+        "def\\s+(\\w+)\\(request",
+        "@api_view\\(['\"]([^'\"]+)['\"]\\)"
+      ]
+    }
+  }
+}
+```
+
+### 4. Test Against Real Codebase
+
+Run legacy-discoverer agent against sample codebase:
+
+```bash
+# Expected output:
+Stack Detected: Python / Django
+Confidence: 0.95
+Assets Found: 45 routes, 23 models, 67 views
+```
+
+### 5. Iterate and Refine
+
+- Check false positives (assets detected incorrectly)
+- Check false negatives (assets missed)
+- Adjust regex patterns and confidence scores
+- Target: >= 90% accuracy
+
+---
+
+## Supported Stacks (v1.0)
+
+| Language | Framework | Pattern File | Status |
+|----------|-----------|--------------|--------|
+| PHP | Laravel | `php/laravel.patterns.json` | ✅ Implemented |
+| PHP | Symfony | `php/symfony.patterns.json` | 🔜 Planned |
+| Node | Express | `node/express.patterns.json` | 🔜 Planned |
+| Node | NestJS | `node/nestjs.patterns.json` | 🔜 Planned |
+| Python | Django | `python/django.patterns.json` | 🔜 Planned |
+| Python | Flask | `python/flask.patterns.json` | 🔜 Planned |
+| Java | Spring | `java/spring.patterns.json` | 🔜 Planned |
+
+**Roadmap:** Add 2-3 new stacks per release based on user demand.
+
+---
+
+## Validation
+
+Pattern sets are validated on load against JSON schema:
+
+### Required Fields
+- `id` (string)
+- `stack.language` (string)
+- `stack.framework` (string)
+- `detection.indicators` (array, min 1)
+- `detection.minConfidence` (number, 0.0-1.0)
+- `patterns` (object, min 1 asset type)
+
+### Optional Fields
+- `stack.versions` (array of strings)
+- `patterns.*.extractors` (object)
+- `metadata` (object)
+
+### Validation Errors
+
+Common errors and fixes:
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| Invalid regex | Unescaped special chars | Escape `(`, `)`, `[`, `]`, etc. |
+| Confidence out of range | Score < 0 or > 1.0 | Set 0.0 <= confidence <= 1.0 |
+| No patterns defined | Empty `patterns` object | Add at least one asset type |
+| Duplicate ID | Multiple pattern sets with same ID | Use unique IDs |
+
+---
+
+## Performance Considerations
+
+### Pattern Execution
+
+- Patterns run sequentially per asset type
+- Glob patterns executed first (filesystem scan)
+- Regex applied only to matched files
+- Results cached per codebase
+
+### Optimization Tips
+
+1. **Use specific globs**: `routes/*.php` better than `**/*.php`
+2. **Order regex by frequency**: Most common patterns first
+3. **Limit file scanning**: Exclude `node_modules/`, `vendor/`
+4. **Cache results**: Store inventory.json for reuse
+
+### Token Budget
+
+Pattern-based detection uses minimal tokens (~1-5k per codebase) compared to LLM-based heuristic detection (~50-100k).
+
+---
+
+## References
+
+- [RFC-004 Legacy Analysis Workflow](../../../project-guidelines/rfcs/RFC-004-LEGACY-ANALYSIS-WORKFLOW.md)
+- [Legacy Discoverer Agent](.claude/agents/legacy-discoverer.md)
+- [Pattern Set Examples](./examples/)
+
+---
+
+## Directory Contents
+
+```
+patterns/legacy/
+├── README.md                    # This file
+└── php/
+    └── laravel.patterns.json    # Laravel pattern set (v1.0)
+```
+
+---
+
+**Maintained by:** Orchestrator System
+**Last Updated:** 2026-01-23