@polymorphism-tech/morph-spec 7.8.1 → 7.9.0

package/framework/templates/docs/schema-analysis.md

@@ -1,119 +1,119 @@
-# Schema Analysis - {{FEATURE_NAME_TITLE}}
-
-**Feature**: {{FEATURE_NAME}}
-**Date**: {{DATE}}
-**Method**: {{#if method}}{{method}}{{else}}Manual Code Analysis{{/if}}
-**Analyzed By**: {{AUTHOR}}
-
----
-
-## Summary
-
-**Tables Analyzed**: {{#if tableCount}}{{tableCount}}{{else}}0{{/if}}
-**Code Files Scanned**: {{#if fileCount}}{{fileCount}}{{else}}0{{/if}}
-**MCP Tools Used**: {{#if mcpUsed}}{{mcpUsed}}{{else}}No (manual analysis){{/if}}
-
----
-
-## Tables Analyzed
-
-{{#each tables}}
-### Table: {{this.name}}
-
-**Source:**
-{{#if this.mcpSource}}- MCP: {{this.mcpSource}}{{/if}}
-{{#if this.codeSource}}- Code: {{this.codeSource}}{{/if}}
-
-**Columns:**
-| Column Name | Type | Nullable | Default | Notes |
-|------------|------|----------|---------|-------|
-{{#each this.columns}}
-| {{this.name}} | {{this.type}} | {{#if this.nullable}}YES{{else}}NO{{/if}} | {{#if this.default}}{{this.default}}{{else}}-{{/if}} | {{#if this.notes}}{{this.notes}}{{else}}-{{/if}} |
-{{/each}}
-
-**Relationships:**
-{{#each this.relationships}}
-- {{this.description}}
-{{/each}}
-
-**Indexes:**
-{{#each this.indexes}}
-- {{this.description}}
-{{/each}}
-
----
-{{/each}}
-
-## ⚠️ CRITICAL FINDINGS
-
-### Field Name Mismatches (MUST FIX)
-
-{{#if fieldMismatches}}
-{{#each fieldMismatches}}
-- ❌ {{this.description}}
-{{/each}}
-{{else}}
-✅ No field name mismatches found
-{{/if}}
-
-### Type Mismatches
-
-{{#if typeMismatches}}
-{{#each typeMismatches}}
-- ⚠️ {{this.description}}
-{{/each}}
-{{else}}
-✅ No type mismatches found
-{{/if}}
-
-### Relationship Corrections
-
-{{#if relationshipIssues}}
-{{#each relationshipIssues}}
-- ⚠️ {{this.description}}
-{{/each}}
-{{else}}
-✅ All relationships correctly identified
-{{/if}}
-
----
-
-## Recommendations for contracts.cs
-
-Based on real schema analysis:
-
-\`\`\`csharp
-{{#each dtoRecommendations}}
-// {{this.tableName}} → {{this.dtoName}}
-public record {{this.dtoName}}(
-{{#each this.fields}}
-    {{this.type}} {{this.name}}{{#if this.nullable}}?{{/if}}{{#unless @last}},{{/unless}}  // {{#if this.comment}}{{this.comment}}{{/if}}
-{{/each}}
-);
-
-{{/each}}
-\`\`\`
-
----
-
-## Analysis Notes
-
-{{#if notes}}
-{{notes}}
-{{else}}
-_No additional notes._
-{{/if}}
-
----
-
-## Next Steps
-
-- [ ] Verify schema analysis with stakeholders
-- [ ] Generate `contracts.cs` using real field names
-- [ ] Update `spec.md` data model section with findings
-- [ ] Document any schema migrations needed in `decisions.md`
-
----
-
-*Generated by MORPH-SPEC v{{FRAMEWORK_VERSION}}*
-*Schema analysis helps prevent DTO field name mismatches and ensures contracts match real database schema*
+# Schema Analysis - {{FEATURE_NAME_TITLE}}
+
+**Feature**: {{FEATURE_NAME}}
+**Date**: {{DATE}}
+**Method**: {{#if method}}{{method}}{{else}}Manual Code Analysis{{/if}}
+**Analyzed By**: {{AUTHOR}}
+
+---
+
+## Summary
+
+**Tables Analyzed**: {{#if tableCount}}{{tableCount}}{{else}}0{{/if}}
+**Code Files Scanned**: {{#if fileCount}}{{fileCount}}{{else}}0{{/if}}
+**MCP Tools Used**: {{#if mcpUsed}}{{mcpUsed}}{{else}}No (manual analysis){{/if}}
+
+---
+
+## Tables Analyzed
+
+{{#each tables}}
+### Table: {{this.name}}
+
+**Source:**
+{{#if this.mcpSource}}- MCP: {{this.mcpSource}}{{/if}}
+{{#if this.codeSource}}- Code: {{this.codeSource}}{{/if}}
+
+**Columns:**
+| Column Name | Type | Nullable | Default | Notes |
+|------------|------|----------|---------|-------|
+{{#each this.columns}}
+| {{this.name}} | {{this.type}} | {{#if this.nullable}}YES{{else}}NO{{/if}} | {{#if this.default}}{{this.default}}{{else}}-{{/if}} | {{#if this.notes}}{{this.notes}}{{else}}-{{/if}} |
+{{/each}}
+
+**Relationships:**
+{{#each this.relationships}}
+- {{this.description}}
+{{/each}}
+
+**Indexes:**
+{{#each this.indexes}}
+- {{this.description}}
+{{/each}}
+
+---
+{{/each}}
+
+## ⚠️ CRITICAL FINDINGS
+
+### Field Name Mismatches (MUST FIX)
+
+{{#if fieldMismatches}}
+{{#each fieldMismatches}}
+- ❌ {{this.description}}
+{{/each}}
+{{else}}
+✅ No field name mismatches found
+{{/if}}
+
+### Type Mismatches
+
+{{#if typeMismatches}}
+{{#each typeMismatches}}
+- ⚠️ {{this.description}}
+{{/each}}
+{{else}}
+✅ No type mismatches found
+{{/if}}
+
+### Relationship Corrections
+
+{{#if relationshipIssues}}
+{{#each relationshipIssues}}
+- ⚠️ {{this.description}}
+{{/each}}
+{{else}}
+✅ All relationships correctly identified
+{{/if}}
+
+---
+
+## Recommendations for contracts.cs
+
+Based on real schema analysis:
+
+\`\`\`csharp
+{{#each dtoRecommendations}}
+// {{this.tableName}} → {{this.dtoName}}
+public record {{this.dtoName}}(
+{{#each this.fields}}
+    {{this.type}} {{this.name}}{{#if this.nullable}}?{{/if}}{{#unless @last}},{{/unless}}  // {{#if this.comment}}{{this.comment}}{{/if}}
+{{/each}}
+);
+
+{{/each}}
+\`\`\`
+
+---
+
+## Analysis Notes
+
+{{#if notes}}
+{{notes}}
+{{else}}
+_No additional notes._
+{{/if}}
+
+---
+
+## Next Steps
+
+- [ ] Verify schema analysis with stakeholders
+- [ ] Generate `contracts.cs` using real field names
+- [ ] Update `spec.md` data model section with findings
+- [ ] Document any schema migrations needed in `decisions.md`
+
+---
+
+*Generated by MORPH-SPEC v{{FRAMEWORK_VERSION}}*
+*Schema analysis helps prevent DTO field name mismatches and ensures contracts match real database schema*

package/framework/templates/docs/ui-components.md

@@ -1,52 +1,52 @@
-# UI Components: {{titleCase FEATURE_NAME}}
-
-| Field | Value |
-|-------|-------|
-| **Feature** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
-| **Stack** | {{STACK}} |
-
----
-
-{{#if (eq STACK "nextjs-neon")}}
-## Component Library: shadcn/ui
-
-### C001: Button
-
-```tsx
-import { Button } from '@/components/ui/button';
-
-<Button onClick={handleSave} disabled={!isValid}>
-  Save
-</Button>
-```
-
-### C002: Data Table
-
-```tsx
-import { DataTable } from '@/components/ui/data-table';
-
-<DataTable columns={columns} data={items} />
-```
-
-{{/if}}
-
----
-
-## Form Validation
-
-| Field | Rule | Error Message |
-|-------|------|---------------|
-| **Name** | Required, max 100 | "Name is required" |
-| **Email** | Valid email | "Invalid email" |
-
----
-
-## Accessibility
-- [ ] All inputs have labels
-- [ ] Error messages announced
-- [ ] Keyboard navigation works
-
----
-
-*Generated with MORPH Framework*
+# UI Components: {{titleCase FEATURE_NAME}}
+
+| Field | Value |
+|-------|-------|
+| **Feature** | {{FEATURE_NAME}} |
+| **Created** | {{DATE}} |
+| **Stack** | {{STACK}} |
+
+---
+
+{{#if (eq STACK "nextjs-neon")}}
+## Component Library: shadcn/ui
+
+### C001: Button
+
+```tsx
+import { Button } from '@/components/ui/button';
+
+<Button onClick={handleSave} disabled={!isValid}>
+  Save
+</Button>
+```
+
+### C002: Data Table
+
+```tsx
+import { DataTable } from '@/components/ui/data-table';
+
+<DataTable columns={columns} data={items} />
+```
+
+{{/if}}
+
+---
+
+## Form Validation
+
+| Field | Rule | Error Message |
+|-------|------|---------------|
+| **Name** | Required, max 100 | "Name is required" |
+| **Email** | Valid email | "Invalid email" |
+
+---
+
+## Accessibility
+- [ ] All inputs have labels
+- [ ] Error messages announced
+- [ ] Keyboard navigation works
+
+---
+
+*Generated with MORPH Framework*

package/framework/templates/docs/ui-design-system.md

@@ -1,76 +1,76 @@
-# UI Design System: {{titleCase FEATURE_NAME}}
-
-| Field | Value |
-|-------|-------|
-| **Feature** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
-| **Project** | {{PROJECT_NAME}} |
-
----
-
-## Color Palette
-
-### Primary Colors
-| Token | Value | Usage |
-|-------|-------|-------|
-| `--color-primary` | #0078D4 | Primary actions, links |
-| `--color-primary-hover` | #106EBE | Hover states |
-
-### Semantic Colors
-| Token | Value | Usage |
-|-------|-------|-------|
-| `--color-success` | #107C10 | Success states |
-| `--color-warning` | #F7630C | Warnings |
-| `--color-error` | #D13438 | Errors |
-
----
-
-## Typography
-
-| Token | Size | Weight | Usage |
-|-------|------|--------|-------|
-| `--text-h1` | 24px | 600 | Section headers |
-| `--text-body` | 14px | 400 | Body text |
-| `--text-caption` | 12px | 400 | Labels |
-
----
-
-## Spacing
-
-| Token | Value | Usage |
-|-------|-------|-------|
-| `--space-sm` | 8px | Compact spacing |
-| `--space-md` | 16px | Standard spacing |
-| `--space-lg` | 24px | Wide spacing |
-
----
-
-## Components
-
-### Buttons
-- **Primary**: `--color-primary` background, white text
-- **Secondary**: Transparent, `--color-primary` border
-- **Sizes**: Small (24px), Medium (32px), Large (40px)
-
-### Forms
-- **Input height**: 32px
-- **Focus**: 2px solid `--color-primary`
-- **Error**: 1px solid `--color-error`
-
----
-
-## Accessibility
-- [ ] 4.5:1 contrast ratio (WCAG AA)
-- [ ] Touch targets minimum 44x44px
-- [ ] Keyboard navigation supported
-
----
-
-## Responsive Breakpoints
-- **Mobile**: < 768px
-- **Tablet**: 768px - 1199px
-- **Desktop**: ≥ 1200px
-
----
-
-*Generated with MORPH Framework*
+# UI Design System: {{titleCase FEATURE_NAME}}
+
+| Field | Value |
+|-------|-------|
+| **Feature** | {{FEATURE_NAME}} |
+| **Created** | {{DATE}} |
+| **Project** | {{PROJECT_NAME}} |
+
+---
+
+## Color Palette
+
+### Primary Colors
+| Token | Value | Usage |
+|-------|-------|-------|
+| `--color-primary` | #0078D4 | Primary actions, links |
+| `--color-primary-hover` | #106EBE | Hover states |
+
+### Semantic Colors
+| Token | Value | Usage |
+|-------|-------|-------|
+| `--color-success` | #107C10 | Success states |
+| `--color-warning` | #F7630C | Warnings |
+| `--color-error` | #D13438 | Errors |
+
+---
+
+## Typography
+
+| Token | Size | Weight | Usage |
+|-------|------|--------|-------|
+| `--text-h1` | 24px | 600 | Section headers |
+| `--text-body` | 14px | 400 | Body text |
+| `--text-caption` | 12px | 400 | Labels |
+
+---
+
+## Spacing
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| `--space-sm` | 8px | Compact spacing |
+| `--space-md` | 16px | Standard spacing |
+| `--space-lg` | 24px | Wide spacing |
+
+---
+
+## Components
+
+### Buttons
+- **Primary**: `--color-primary` background, white text
+- **Secondary**: Transparent, `--color-primary` border
+- **Sizes**: Small (24px), Medium (32px), Large (40px)
+
+### Forms
+- **Input height**: 32px
+- **Focus**: 2px solid `--color-primary`
+- **Error**: 1px solid `--color-error`
+
+---
+
+## Accessibility
+- [ ] 4.5:1 contrast ratio (WCAG AA)
+- [ ] Touch targets minimum 44x44px
+- [ ] Keyboard navigation supported
+
+---
+
+## Responsive Breakpoints
+- **Mobile**: < 768px
+- **Tablet**: 768px - 1199px
+- **Desktop**: ≥ 1200px
+
+---
+
+*Generated with MORPH Framework*