@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/framework/templates/REGISTRY.json

@@ -697,96 +697,6 @@
       "technology": "azure",
       "applicableStacks": ["blazor-azure"]
     },
-    {
-      "id": "azure-pipelines",
-      "name": "Azure Pipelines YAML",
-      "path": "infrastructure/azure/azure-pipelines-deploy.yml",
-      "location": "framework",
-      "category": "infrastructure",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Replaced by GitHub Actions workflows",
-      "outputName": "azure-pipelines-deploy.yml",
-      "placeholders": ["PROJECT_NAME"],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": true,
-      "deprecationReason": "CI/CD migrated from Azure DevOps to GitHub Actions",
-      "technology": "azure",
-      "applicableStacks": ["blazor-azure"]
-    },
-    {
-      "id": "azure-devops-build-dotnet",
-      "name": "Azure DevOps - Build .NET Template",
-      "path": "infrastructure/azure/pipelines/templates/build-dotnet.yml",
-      "location": "framework",
-      "category": "infrastructure",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Replaced by GitHub Actions workflows",
-      "outputName": "build-dotnet.yml",
-      "placeholders": [],
-      "stackSpecific": false,
-      "engine": "none",
-      "deprecated": true,
-      "deprecationReason": "CI/CD migrated from Azure DevOps to GitHub Actions",
-      "technology": "azure-devops",
-      "applicableStacks": ["blazor-azure"]
-    },
-    {
-      "id": "azure-devops-deploy-container-app",
-      "name": "Azure DevOps - Deploy Container Apps Template",
-      "path": "infrastructure/azure/pipelines/templates/deploy-container-app.yml",
-      "location": "framework",
-      "category": "infrastructure",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Replaced by GitHub Actions workflows",
-      "outputName": "deploy-container-app.yml",
-      "placeholders": [],
-      "stackSpecific": false,
-      "engine": "none",
-      "deprecated": true,
-      "deprecationReason": "CI/CD migrated from Azure DevOps to GitHub Actions",
-      "technology": "azure-devops",
-      "applicableStacks": ["blazor-azure"]
-    },
-    {
-      "id": "azure-devops-deploy-app-service",
-      "name": "Azure DevOps - Deploy App Service Template",
-      "path": "infrastructure/azure/pipelines/templates/deploy-app-service.yml",
-      "location": "framework",
-      "category": "infrastructure",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Replaced by GitHub Actions workflows",
-      "outputName": "deploy-app-service.yml",
-      "placeholders": [],
-      "stackSpecific": false,
-      "engine": "none",
-      "deprecated": true,
-      "deprecationReason": "CI/CD migrated from Azure DevOps to GitHub Actions",
-      "technology": "azure-devops",
-      "applicableStacks": ["blazor-azure"]
-    },
-    {
-      "id": "azure-devops-infra-deploy",
-      "name": "Azure DevOps - Infrastructure Deployment Template",
-      "path": "infrastructure/azure/pipelines/templates/infra-deploy.yml",
-      "location": "framework",
-      "category": "infrastructure",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Replaced by GitHub Actions workflows",
-      "outputName": "infra-deploy.yml",
-      "placeholders": [],
-      "stackSpecific": false,
-      "engine": "none",
-      "deprecated": true,
-      "deprecationReason": "CI/CD migrated from Azure DevOps to GitHub Actions",
-      "technology": "azure-devops",
-      "applicableStacks": ["blazor-azure"]
-    },
     {
       "id": "azure-dockerfile",
       "name": "Dockerfile (Azure)",
@@ -1061,167 +971,69 @@
       "technology": "dotnet",
       "applicableStacks": ["blazor-azure", "nextjs-supabase"]
     },
-    {
-      "id": "story",
-      "name": "User Stories",
-      "path": "story.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "clarify",
-      "required": false,
-      "description": "[DEPRECATED] Use create-story.js command instead",
-      "outputName": "story.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Replaced by src/commands/create-story.js CLI command",
-      "technology": null
-    },
-    {
-      "id": "simulation",
-      "name": "User Simulation",
-      "path": "simulation.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "clarify",
-      "required": false,
-      "description": "[DEPRECATED] Never used in practice",
-      "outputName": "simulation.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Template was never used in actual workflows",
-      "technology": null
-    },
     {
       "id": "ui-mockups",
       "name": "UI Mockups",
-      "path": "ui-mockups.md",
+      "path": "docs/ui-mockups.md",
       "location": "framework",
       "category": "documentation",
       "phase": "uiux",
       "required": false,
-      "description": "[DEPRECATED] Never used in practice",
+      "description": "Wireframes and layout specifications with ASCII mockups and responsive breakpoints",
       "outputName": "ui-mockups.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Template was never used in actual workflows",
-      "technology": null
+      "placeholders": ["FEATURE_NAME", "DATE"],
+      "stackSpecific": false,
+      "engine": "handlebars",
+      "deprecated": false,
+      "technology": "handlebars"
     },
     {
       "id": "ui-flows",
       "name": "UI Flows",
-      "path": "ui-flows.md",
+      "path": "docs/ui-flows.md",
       "location": "framework",
       "category": "documentation",
       "phase": "uiux",
       "required": false,
-      "description": "[DEPRECATED] Never used in practice",
+      "description": "User flows and interaction patterns with state diagrams and edge cases",
       "outputName": "ui-flows.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Template was never used in actual workflows",
-      "technology": null
+      "placeholders": ["FEATURE_NAME", "DATE"],
+      "stackSpecific": false,
+      "engine": "handlebars",
+      "deprecated": false,
+      "technology": "handlebars"
     },
     {
       "id": "ui-components",
       "name": "UI Components",
-      "path": "ui-components.md",
+      "path": "docs/ui-components.md",
       "location": "framework",
       "category": "documentation",
       "phase": "uiux",
       "required": false,
-      "description": "[DEPRECATED] design-system.css is sufficient",
+      "description": "Component specifications mapping UI elements to FluentUI/MudBlazor components with props and events",
       "outputName": "ui-components.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Replaced by ui/design-system.css template",
-      "technology": null
+      "placeholders": ["FEATURE_NAME", "DATE", "STACK"],
+      "stackSpecific": false,
+      "engine": "handlebars",
+      "deprecated": false,
+      "technology": "handlebars"
     },
     {
-      "id": "ui-design-system-doc",
-      "name": "UI Design System Documentation",
-      "path": "ui-design-system.md",
+      "id": "ui-design-system",
+      "name": "UI Design System",
+      "path": "docs/ui-design-system.md",
       "location": "framework",
       "category": "documentation",
       "phase": "uiux",
       "required": false,
-      "description": "[DEPRECATED] Replaced by design-system-examples.md",
+      "description": "Design system documentation with color palette, typography, spacing, and semantic tokens",
       "outputName": "ui-design-system.md",
-      "placeholders": ["PROJECT_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Replaced by examples/design-system-examples.md",
-      "technology": null
-    },
-    {
-      "id": "clarify-questions",
-      "name": "Clarification Questions",
-      "path": "clarify-questions.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "clarify",
-      "required": false,
-      "description": "[DEPRECATED] Use AskUserQuestion tool instead",
-      "outputName": "clarify-questions.md",
-      "placeholders": ["FEATURE_NAME"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Replaced by AskUserQuestion tool in Claude Code",
-      "technology": null
-    },
-    {
-      "id": "sprint-status",
-      "name": "Sprint Status",
-      "path": "sprint-status.yaml",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "implement",
-      "required": false,
-      "description": "[DEPRECATED] Generated by CLI, not a template",
-      "outputName": "sprint-status.yaml",
-      "placeholders": ["DATE"],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Generated by create-story.js command, not a user template",
-      "technology": null
-    },
-    {
-      "id": "state-template",
-      "name": "State Template",
-      "path": "state.template.json",
-      "location": "framework",
-      "category": "code",
-      "phase": "setup",
-      "required": false,
-      "description": "[DEPRECATED] Not a user template",
-      "outputName": "state.json",
-      "placeholders": [],
-      "stackSpecific": true,
-      "stacks": ["blazor-azure"],
-      "engine": "custom",
-      "deprecated": true,
-      "deprecationReason": "Internal state file, not a user-facing template",
-      "technology": null
+      "placeholders": ["FEATURE_NAME", "DATE", "PROJECT_NAME"],
+      "stackSpecific": false,
+      "engine": "handlebars",
+      "deprecated": false,
+      "technology": "handlebars"
     },
     {
       "id": "github-workflow-dotnet-build",
@@ -1625,13 +1437,13 @@
     }
   ],
   "stats": {
-    "total": 78,
-    "framework": 69,
-    "deprecated": 14,
+    "total": 68,
+    "framework": 59,
+    "deprecated": 0,
     "byCategory": {
-      "documentation": 5,
-      "code": 25,
-      "infrastructure": 23,
+      "documentation": 4,
+      "code": 24,
+      "infrastructure": 18,
       "context": 2,
       "examples": 2,
       "integration": 4,
@@ -1644,24 +1456,27 @@
       "typescript": 1,
       "sql": 3,
       "bicep": 8,
-      "azure": 10,
+      "azure": 9,
       "docker": 5,
-      "handlebars": 19,
-      "css": 1
+      "handlebars": 22,
+      "css": 1,
+      "github-actions": 9
     },
     "byPhase": {
-      "setup": 2,
+      "setup": 1,
       "proposal": 1,
-      "uiux": 3,
+      "uiux": 6,
       "design": 10,
       "clarify": 0,
       "tasks": 1,
-      "implement": 40,
-      "completed": 1
+      "implement": 34,
+      "completed": 1,
+      "build": 3,
+      "deploy": 4
     },
     "required": 5,
-    "optional": 61,
-    "applicableToMultipleStacks": 38
+    "optional": 63,
+    "applicableToMultipleStacks": 42
   },
   "migrationNotes": {
     "v1ToV2": {

package/framework/templates/code/dotnet/contracts/contracts.cs.hbs

@@ -0,0 +1,172 @@
+// ====================================================================
+// Feature: {{FEATURE_NAME_TITLE}}
+// Contracts: DTOs, Interfaces, Enums, Value Objects
+// Generated: {{DATE}}
+// Author: {{AUTHOR}}
+// ====================================================================
+//
+// IMPORTANT: This file was generated from schema-analysis.md
+// All field names, types, and relationships are based on REAL database schema
+// DO NOT modify without checking schema-analysis.md first!
+//
+// ====================================================================
+
+namespace {{NAMESPACE}}.Features.{{FEATURE_NAME_PASCAL}};
+
+// ====================================================================
+// DTOs (Data Transfer Objects)
+// ====================================================================
+// Pattern: Use records for immutability
+// Pattern: All DTOs must have XML documentation
+// Pattern: Use nullable reference types appropriately
+// ====================================================================
+
+{{#each dtos}}
+/// <summary>
+/// {{this.description}}
+/// </summary>
+{{#if this.isCreateDto}}
+public record {{this.name}}(
+{{#each this.fields}}
+    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
+{{/each}}
+);
+{{else if this.isUpdateDto}}
+public record {{this.name}}(
+{{#each this.fields}}
+    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
+{{/each}}
+);
+{{else}}
+/// <summary>
+/// Response DTO for {{this.entityName}}
+/// </summary>
+public record {{this.name}}(
+{{#each this.fields}}
+    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
+{{/each}}
+);
+{{/if}}
+
+{{/each}}
+
+// ====================================================================
+// Service Interfaces
+// ====================================================================
+// Pattern: All async methods must accept CancellationToken
+// Pattern: Use Task<TResult?> for operations that may return null
+// Pattern: Document exceptions in XML comments
+// ====================================================================
+
+{{#each interfaces}}
+/// <summary>
+/// {{this.description}}
+/// </summary>
+public interface {{this.name}}
+{
+{{#each this.methods}}
+    /// <summary>
+    /// {{this.description}}
+    /// </summary>
+{{#if this.exceptions}}
+{{#each this.exceptions}}
+    /// <exception cref="{{this.type}}">{{this.condition}}</exception>
+{{/each}}
+{{/if}}
+    Task<{{this.returnType}}{{#if this.nullable}}?{{/if}}> {{this.name}}({{#each this.parameters}}{{this.type}} {{this.name}}{{#unless @last}}, {{/unless}}{{/each}}, CancellationToken ct);
+
+{{/each}}
+}
+
+{{/each}}
+
+// ====================================================================
+// Enums
+// ====================================================================
+
+{{#each enums}}
+/// <summary>
+/// {{this.description}}
+/// </summary>
+public enum {{this.name}}
+{
+{{#each this.values}}
+    /// <summary>
+    /// {{this.description}}
+    /// </summary>
+    {{this.name}}{{#if this.value}} = {{this.value}}{{/if}}{{#unless @last}},{{/unless}}
+{{/each}}
+}
+
+{{/each}}
+
+// ====================================================================
+// Value Objects (if applicable)
+// ====================================================================
+
+{{#each valueObjects}}
+/// <summary>
+/// {{this.description}}
+/// </summary>
+public record {{this.name}}
+{
+{{#each this.properties}}
+    /// <summary>
+    /// {{this.description}}
+    /// </summary>
+    public {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}} { get; init; }{{#if this.default}} = {{this.default}};{{/if}}
+{{/each}}
+
+{{#if this.validation}}
+    /// <summary>
+    /// Validates the value object
+    /// </summary>
+    public bool IsValid()
+    {
+        {{this.validation}}
+    }
+{{/if}}
+}
+
+{{/each}}
+
+// ====================================================================
+// Request/Response Wrappers (if using CQRS)
+// ====================================================================
+
+{{#if useCQRS}}
+{{#each commands}}
+/// <summary>
+/// Command: {{this.description}}
+/// </summary>
+public record {{this.name}}(
+{{#each this.parameters}}
+    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
+{{/each}}
+);
+
+{{/each}}
+
+{{#each queries}}
+/// <summary>
+/// Query: {{this.description}}
+/// </summary>
+public record {{this.name}}(
+{{#each this.parameters}}
+    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
+{{/each}}
+);
+
+{{/each}}
+{{/if}}
+
+// ====================================================================
+// Notes
+// ====================================================================
+// - All field names match database schema (see schema-analysis.md)
+// - Nullability matches database constraints
+// - Complex types (JSONB → JsonObject) correctly mapped
+// - Relationships preserved in navigation properties
+// - Immutable records used for DTOs (recommended pattern)
+// - CancellationToken required for all async operations
+// ====================================================================

package/framework/templates/context/CONTEXT-FEATURE.md

@@ -262,7 +262,7 @@ morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
 
 ## File Paths
 
-- **Outputs Directory:** `.morph/project/outputs/{{FEATURE_NAME}}/`
+- **Outputs Directory:** `.morph/features/{{FEATURE_NAME}}/`
 - **Proposal:** `{{PROPOSAL_PATH}}`
 - **Spec:** `{{SPEC_PATH}}`
 - **Contracts:** `{{CONTRACTS_PATH}}`

package/framework/templates/context/CONTEXT.md

@@ -170,11 +170,11 @@ morph-spec generate recap {feature}
 ```
 
 ### Key Paths
-- **Outputs:** `.morph/project/outputs/{feature}/`
-- **Standards:** `.morph/project/standards/` (project overrides)
+- **Outputs:** `.morph/features/{feature}/`
+- **Standards:** `.morph/context/` (project overrides)
 - **Config:** `.morph/config/config.json`
 - **State:** `.morph/state.json`
-- **Templates:** `.morph/templates/`
+- **Templates:** `.morph/framework/templates/`
 
 ---