@orchestrator-claude/cli 1.7.2 → 1.7.4

package/templates/base/.orchestrator/templates/legacy/business-rules.md.hbs

@@ -0,0 +1,449 @@
+# Business Rules: {{projectName}}
+
+**Generated:** {{generatedAt}}
+**Agent:** business-rule-miner
+**Workflow Phase:** DOCUMENT
+**Total Rules:** {{totalRules}}
+
+---
+
+## Executive Summary
+
+{{summary}}
+
+This document catalogs business rules extracted from the codebase. Rules are organized by domain and include source locations for traceability.
+
+---
+
+## Rules by Domain
+
+{{#each domains}}
+## Domain: {{name}}
+
+**Description:** {{description}}
+**Total Rules:** {{ruleCount}}
+
+{{#each rules}}
+### {{id}}: {{title}}
+
+**Priority:** {{priority}}
+**Type:** {{type}}
+**Source:** `{{source.file}}:{{source.line}}`
+
+**Rule:**
+{{rule}}
+
+**Context:**
+{{context}}
+
+{{#if constraints}}
+**Constraints:**
+{{#each constraints}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if validations}}
+**Validations:**
+{{#each validations}}
+- {{field}}: {{validation}} {{#if message}}({{message}}){{/if}}
+{{/each}}
+{{/if}}
+
+{{#if examples}}
+**Examples:**
+
+Valid:
+```{{language}}
+{{examples.valid}}
+```
+
+Invalid:
+```{{language}}
+{{examples.invalid}}
+```
+{{/if}}
+
+{{#if exceptions}}
+**Exceptions:**
+{{#each exceptions}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+
+{{/each}}
+
+---
+
+## Rules by Type
+
+### Validation Rules
+
+{{#if rulesByType.validation}}
+{{#each rulesByType.validation}}
+- **{{title}}** ({{domain}}) - `{{source.file}}:{{source.line}}`
+  - {{rule}}
+{{/each}}
+{{else}}
+No validation rules extracted.
+{{/if}}
+
+### Business Logic Rules
+
+{{#if rulesByType.businessLogic}}
+{{#each rulesByType.businessLogic}}
+- **{{title}}** ({{domain}}) - `{{source.file}}:{{source.line}}`
+  - {{rule}}
+{{/each}}
+{{else}}
+No business logic rules extracted.
+{{/if}}
+
+### Authorization Rules
+
+{{#if rulesByType.authorization}}
+{{#each rulesByType.authorization}}
+- **{{title}}** ({{domain}}) - `{{source.file}}:{{source.line}}`
+  - {{rule}}
+{{/each}}
+{{else}}
+No authorization rules extracted.
+{{/if}}
+
+### Calculation Rules
+
+{{#if rulesByType.calculation}}
+{{#each rulesByType.calculation}}
+- **{{title}}** ({{domain}}) - `{{source.file}}:{{source.line}}`
+  - {{rule}}
+{{/each}}
+{{else}}
+No calculation rules extracted.
+{{/if}}
+
+### State Transition Rules
+
+{{#if rulesByType.stateTransition}}
+{{#each rulesByType.stateTransition}}
+- **{{title}}** ({{domain}}) - `{{source.file}}:{{source.line}}`
+  - {{rule}}
+{{/each}}
+{{else}}
+No state transition rules extracted.
+{{/if}}
+
+---
+
+## Form Validations
+
+{{#if formValidations}}
+{{#each formValidations}}
+### {{formName}}
+
+**File:** `{{file}}`
+**Controller:** {{controller}}
+**Action:** {{action}}
+
+| Field | Rules | Custom Message |
+|-------|-------|----------------|
+{{#each fields}}
+| {{name}} | {{rules}} | {{message}} |
+{{/each}}
+
+{{#if customValidations}}
+**Custom Validations:**
+{{#each customValidations}}
+- {{name}}: {{logic}}
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+{{else}}
+No form validation classes found.
+{{/if}}
+
+---
+
+## Conditional Logic
+
+{{#if conditionalLogic}}
+Complex business logic extracted from conditional statements:
+
+{{#each conditionalLogic}}
+### {{title}}
+
+**Location:** `{{source.file}}:{{source.line}}`
+**Complexity:** {{complexity}} ({{#if highComplexity}}⚠️ High{{else}}Normal{{/if}})
+
+**Logic:**
+```{{language}}
+{{logic}}
+```
+
+**Interpretation:**
+{{interpretation}}
+
+{{#if simplification}}
+**Suggested Simplification:**
+```{{language}}
+{{simplification}}
+```
+{{/if}}
+
+---
+
+{{/each}}
+{{else}}
+No complex conditional logic extracted.
+{{/if}}
+
+---
+
+## Constants & Enums
+
+{{#if constants}}
+Business constants and enumerations:
+
+{{#each constants}}
+### {{name}}
+
+**Type:** {{type}}
+**File:** `{{file}}`
+
+{{#if values}}
+**Values:**
+{{#each values}}
+- `{{key}}` = {{value}} {{#if description}}// {{description}}{{/if}}
+{{/each}}
+{{/if}}
+
+{{#if usage}}
+**Usage:**
+{{usage}}
+{{/if}}
+
+---
+
+{{/each}}
+{{else}}
+No business constants extracted.
+{{/if}}
+
+---
+
+## Error Messages
+
+{{#if errorMessages}}
+Error messages that indicate business rules:
+
+{{#each errorMessages}}
+- **{{code}}**: "{{message}}" (`{{file}}:{{line}}`)
+  - Implied Rule: {{impliedRule}}
+{{/each}}
+{{else}}
+No error messages extracted.
+{{/if}}
+
+---
+
+## Permissions & Policies
+
+{{#if permissions}}
+{{#each permissions}}
+### {{resource}}
+
+**Policy Class:** `{{policyClass}}`
+**File:** `{{file}}`
+
+| Action | Rule | Rationale |
+|--------|------|-----------|
+{{#each actions}}
+| {{name}} | {{rule}} | {{rationale}} |
+{{/each}}
+
+---
+
+{{/each}}
+{{else}}
+No permission policies found.
+{{/if}}
+
+---
+
+## Workflows & State Machines
+
+{{#if workflows}}
+{{#each workflows}}
+### {{name}}
+
+**Entity:** {{entity}}
+**File:** `{{file}}`
+
+**States:**
+{{#each states}}
+- {{name}} ({{description}})
+{{/each}}
+
+**Transitions:**
+```mermaid
+stateDiagram-v2
+{{#each transitions}}
+    {{from}} --> {{to}}: {{event}}
+{{/each}}
+```
+
+**Transition Rules:**
+{{#each transitions}}
+- **{{event}}**: {{from}} → {{to}}
+  - Condition: {{condition}}
+  - Action: {{action}}
+{{/each}}
+
+---
+
+{{/each}}
+{{else}}
+No workflows or state machines detected.
+{{/if}}
+
+---
+
+## Rules Requiring Clarification
+
+{{#if ambiguousRules}}
+These rules need business stakeholder clarification:
+
+{{#each ambiguousRules}}
+### {{title}}
+
+**Location:** `{{source.file}}:{{source.line}}`
+**Issue:** {{issue}}
+
+**Current Implementation:**
+```{{language}}
+{{implementation}}
+```
+
+**Questions:**
+{{#each questions}}
+{{@index}}. {{this}}
+{{/each}}
+
+---
+
+{{/each}}
+{{else}}
+✅ All rules appear clear.
+{{/if}}
+
+---
+
+## Contradictory Rules
+
+{{#if contradictions}}
+⚠️ **Warning:** Potential rule contradictions detected:
+
+{{#each contradictions}}
+### {{title}}
+
+**Rule 1:** {{rule1}} (`{{location1}}`)
+**Rule 2:** {{rule2}} (`{{location2}}`)
+
+**Conflict:**
+{{conflict}}
+
+**Impact:**
+{{impact}}
+
+**Recommendation:**
+{{recommendation}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No rule contradictions detected.
+{{/if}}
+
+---
+
+## Missing Rules
+
+{{#if missingRules}}
+Areas where business rules appear to be missing:
+
+{{#each missingRules}}
+- **{{area}}**: {{description}}
+  - Location: {{location}}
+  - Risk: {{risk}}
+  - Recommendation: {{recommendation}}
+{{/each}}
+{{else}}
+No obvious gaps in business rules.
+{{/if}}
+
+---
+
+## Domain Glossary
+
+See full glossary in `glossary.md`.
+
+**Quick Reference:**
+
+{{#each glossary}}
+- **{{term}}**: {{definition}}
+{{/each}}
+
+---
+
+## Rule Coverage Matrix
+
+| Domain | Total Rules | Documented | Tested | Status |
+|--------|-------------|------------|--------|--------|
+{{#each coverageMatrix}}
+| {{domain}} | {{totalRules}} | {{documented}} ({{documentedPercent}}%) | {{tested}} ({{testedPercent}}%) | {{#if complete}}✅{{else}}⚠️{{/if}} |
+{{/each}}
+
+---
+
+## Next Steps
+
+1. Review ambiguous rules with business stakeholders
+2. Resolve rule contradictions
+3. Document missing rules
+4. Ensure all rules have test coverage
+5. Proceed to RECOMMEND phase for migration strategy
+
+---
+
+## Extraction Methodology
+
+**Techniques Used:**
+- Static analysis of validation rules
+- Pattern matching for conditional logic
+- Error message analysis
+- Policy class extraction
+- Enum and constant analysis
+
+**Coverage:**
+- Form validations: {{coverage.formValidations}}%
+- Business logic: {{coverage.businessLogic}}%
+- Authorization: {{coverage.authorization}}%
+- State machines: {{coverage.stateMachines}}%
+
+**Limitations:**
+- Cannot extract rules from dynamic/runtime conditions
+- May miss rules in front-end code
+- Complex business logic may require interpretation
+
+---
+
+**Generated by:** business-rule-miner agent
+**Standards:** AGENT-PROMPT-STANDARDS v1.1
+**RFC:** RFC-004-LEGACY-ANALYSIS-WORKFLOW