@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/content/.morph/templates/service.cs

@@ -1,139 +1,139 @@
-// ============================================================
-// SERVICE TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.Extensions.Logging;
-
-namespace MyProject.Application.Features.{Feature}.Services;
-
-/// <summary>
-/// Service for managing {Feature} operations.
-/// </summary>
-public class {Feature}Service(
-    I{Feature}Repository repository,
-    ILogger<{Feature}Service> logger) : I{Feature}Service
-{
-    /// <inheritdoc />
-    public async Task<{Feature}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting {Feature} with ID {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken);
-        if (entity is null)
-        {
-            logger.LogWarning("{Feature} with ID {Id} not found", id);
-            return null;
-        }
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task<List<{Feature}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting all {Feature}s");
-
-        var entities = await repository.GetAllAsync(cancellationToken);
-        return entities.Select(MapToDto).ToList();
-    }
-
-    /// <inheritdoc />
-    public async Task<{Feature}Dto> CreateAsync(
-        Create{Feature}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Creating new {Feature}: {Name}", request.Name);
-
-        // Validate
-        await ValidateCreateAsync(request, cancellationToken);
-
-        // Create entity
-        var entity = Domain.Entities.{Feature}.Create(request.Name);
-
-        // Save
-        await repository.AddAsync(entity, cancellationToken);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Created {Feature} with ID {Id}", entity.Id);
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task UpdateAsync(
-        int id,
-        Update{Feature}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Updating {Feature} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {Feature}NotFoundException(id);
-
-        // Validate
-        await ValidateUpdateAsync(entity, request, cancellationToken);
-
-        // Update entity
-        entity.UpdateName(request.Name);
-
-        // Save
-        repository.Update(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Updated {Feature} {Id}", id);
-    }
-
-    /// <inheritdoc />
-    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Deleting {Feature} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {Feature}NotFoundException(id);
-
-        // Soft delete or remove
-        repository.Remove(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Deleted {Feature} {Id}", id);
-    }
-
-    #region Private Methods
-
-    private static {Feature}Dto MapToDto(Domain.Entities.{Feature} entity)
-    {
-        return new {Feature}Dto(
-            entity.Id,
-            entity.Name,
-            entity.Status,
-            entity.CreatedAt,
-            entity.UpdatedAt
-        );
-    }
-
-    private async Task ValidateCreateAsync(
-        Create{Feature}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-        // Example: Check for duplicates
-        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
-        // if (existing is not null)
-        //     throw new ValidationException("Name already exists");
-
-        await Task.CompletedTask;
-    }
-
-    private async Task ValidateUpdateAsync(
-        Domain.Entities.{Feature} entity,
-        Update{Feature}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-
-        await Task.CompletedTask;
-    }
-
-    #endregion
-}
+// ============================================================
+// SERVICE TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.Extensions.Logging;
+
+namespace MyProject.Application.Features.{Feature}.Services;
+
+/// <summary>
+/// Service for managing {Feature} operations.
+/// </summary>
+public class {Feature}Service(
+    I{Feature}Repository repository,
+    ILogger<{Feature}Service> logger) : I{Feature}Service
+{
+    /// <inheritdoc />
+    public async Task<{Feature}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
+    {
+        logger.LogDebug("Getting {Feature} with ID {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken);
+        if (entity is null)
+        {
+            logger.LogWarning("{Feature} with ID {Id} not found", id);
+            return null;
+        }
+
+        return MapToDto(entity);
+    }
+
+    /// <inheritdoc />
+    public async Task<List<{Feature}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
+    {
+        logger.LogDebug("Getting all {Feature}s");
+
+        var entities = await repository.GetAllAsync(cancellationToken);
+        return entities.Select(MapToDto).ToList();
+    }
+
+    /// <inheritdoc />
+    public async Task<{Feature}Dto> CreateAsync(
+        Create{Feature}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Creating new {Feature}: {Name}", request.Name);
+
+        // Validate
+        await ValidateCreateAsync(request, cancellationToken);
+
+        // Create entity
+        var entity = Domain.Entities.{Feature}.Create(request.Name);
+
+        // Save
+        await repository.AddAsync(entity, cancellationToken);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Created {Feature} with ID {Id}", entity.Id);
+
+        return MapToDto(entity);
+    }
+
+    /// <inheritdoc />
+    public async Task UpdateAsync(
+        int id,
+        Update{Feature}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Updating {Feature} {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken)
+            ?? throw new {Feature}NotFoundException(id);
+
+        // Validate
+        await ValidateUpdateAsync(entity, request, cancellationToken);
+
+        // Update entity
+        entity.UpdateName(request.Name);
+
+        // Save
+        repository.Update(entity);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Updated {Feature} {Id}", id);
+    }
+
+    /// <inheritdoc />
+    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Deleting {Feature} {Id}", id);
+
+        var entity = await repository.GetByIdAsync(id, cancellationToken)
+            ?? throw new {Feature}NotFoundException(id);
+
+        // Soft delete or remove
+        repository.Remove(entity);
+        await repository.SaveChangesAsync(cancellationToken);
+
+        logger.LogInformation("Deleted {Feature} {Id}", id);
+    }
+
+    #region Private Methods
+
+    private static {Feature}Dto MapToDto(Domain.Entities.{Feature} entity)
+    {
+        return new {Feature}Dto(
+            entity.Id,
+            entity.Name,
+            entity.Status,
+            entity.CreatedAt,
+            entity.UpdatedAt
+        );
+    }
+
+    private async Task ValidateCreateAsync(
+        Create{Feature}Request request,
+        CancellationToken cancellationToken)
+    {
+        // Add validation logic here
+        // Example: Check for duplicates
+        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
+        // if (existing is not null)
+        //     throw new ValidationException("Name already exists");
+
+        await Task.CompletedTask;
+    }
+
+    private async Task ValidateUpdateAsync(
+        Domain.Entities.{Feature} entity,
+        Update{Feature}Request request,
+        CancellationToken cancellationToken)
+    {
+        // Add validation logic here
+
+        await Task.CompletedTask;
+    }
+
+    #endregion
+}

package/content/.morph/templates/sprint-status.yaml

@@ -1,68 +1,68 @@
-# MORPH-SPEC Sprint Status
-# Auto-updated by create-story.js and update-sprint-status.js
-# Tracks story-level progress within a feature/epic
-
-feature: {{FEATURE_NAME}}
-epic: {{EPIC_NAME}}
-sprint: {{SPRINT_NUMBER}}
-created: {{DATE}}
-updated: {{DATE}}
-
-# Story progression
-stories:
-  - id: {{STORY_ID_1}}
-    title: {{STORY_TITLE_1}}
-    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_1}}.md
-    status: ready           # ready | in_progress | ready_for_qa | done
-    assigned: {{AGENT}}     # sm | dev | qa
-    created: {{DATE}}
-    started: null
-    completed: null
-
-  - id: {{STORY_ID_2}}
-    title: {{STORY_TITLE_2}}
-    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_2}}.md
-    status: pending
-    assigned: sm
-    created: {{DATE}}
-    started: null
-    completed: null
-
-# Progress metrics
-metrics:
-  total_stories: {{TOTAL_STORIES}}
-  ready: {{READY_COUNT}}
-  in_progress: {{IN_PROGRESS_COUNT}}
-  ready_for_qa: {{QA_COUNT}}
-  done: {{DONE_COUNT}}
-  completion_percent: {{COMPLETION_PERCENT}}
-
-# Current focus
-current:
-  story_id: {{CURRENT_STORY_ID}}
-  agent: {{CURRENT_AGENT}}
-  phase: implementation  # planning | implementation | review
-
-# Next story to work on
-next:
-  story_id: {{NEXT_STORY_ID}}
-  recommendation: "Story {{NEXT_STORY_ID}} is ready for development"
-
----
-# Usage Notes:
-#
-# Status Transitions:
-# pending → ready (SM creates story with full context)
-# ready → in_progress (Dev starts implementation)
-# in_progress → ready_for_qa (Dev completes, adds Dev Notes)
-# ready_for_qa → done (QA approves, adds QA Notes)
-#
-# Fresh Chat Pattern (BMAD-inspired):
-# Each story should run in a FRESH Claude session to avoid context pollution
-#
-# Example workflow:
-# 1. SM: node bin/create-story.js scheduled-reports SR-001
-# 2. Dev: Open NEW chat → /dev → Implement SR-001
-# 3. QA: Open NEW chat → /qa → Review SR-001
-#
-# This prevents token bloat and reduces hallucinations
+# MORPH-SPEC Sprint Status
+# Auto-updated by create-story.js and update-sprint-status.js
+# Tracks story-level progress within a feature/epic
+
+feature: {{FEATURE_NAME}}
+epic: {{EPIC_NAME}}
+sprint: {{SPRINT_NUMBER}}
+created: {{DATE}}
+updated: {{DATE}}
+
+# Story progression
+stories:
+  - id: {{STORY_ID_1}}
+    title: {{STORY_TITLE_1}}
+    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_1}}.md
+    status: ready           # ready | in_progress | ready_for_qa | done
+    assigned: {{AGENT}}     # sm | dev | qa
+    created: {{DATE}}
+    started: null
+    completed: null
+
+  - id: {{STORY_ID_2}}
+    title: {{STORY_TITLE_2}}
+    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_2}}.md
+    status: pending
+    assigned: sm
+    created: {{DATE}}
+    started: null
+    completed: null
+
+# Progress metrics
+metrics:
+  total_stories: {{TOTAL_STORIES}}
+  ready: {{READY_COUNT}}
+  in_progress: {{IN_PROGRESS_COUNT}}
+  ready_for_qa: {{QA_COUNT}}
+  done: {{DONE_COUNT}}
+  completion_percent: {{COMPLETION_PERCENT}}
+
+# Current focus
+current:
+  story_id: {{CURRENT_STORY_ID}}
+  agent: {{CURRENT_AGENT}}
+  phase: implementation  # planning | implementation | review
+
+# Next story to work on
+next:
+  story_id: {{NEXT_STORY_ID}}
+  recommendation: "Story {{NEXT_STORY_ID}} is ready for development"
+
+---
+# Usage Notes:
+#
+# Status Transitions:
+# pending → ready (SM creates story with full context)
+# ready → in_progress (Dev starts implementation)
+# in_progress → ready_for_qa (Dev completes, adds Dev Notes)
+# ready_for_qa → done (QA approves, adds QA Notes)
+#
+# Fresh Chat Pattern (BMAD-inspired):
+# Each story should run in a FRESH Claude session to avoid context pollution
+#
+# Example workflow:
+# 1. SM: node bin/create-story.js scheduled-reports SR-001
+# 2. Dev: Open NEW chat → /dev → Implement SR-001
+# 3. QA: Open NEW chat → /qa → Review SR-001
+#
+# This prevents token bloat and reduces hallucinations