@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/feature/decisions.md

@@ -0,0 +1,187 @@
+# Architecture Decision Records - {{titleCase FEATURE_NAME}}
+
+## ADR-001: {Decision Title}
+
+**Date:** {{DATE}}
+**Status:** Proposed | Accepted | Deprecated | Superseded
+**Deciders:** MORPH Agents, Developer
+
+### Context
+
+{Describe the context and problem that led to this decision}
+
+### Decision
+
+{Describe the decision made}
+
+### Consequences
+
+**Pros:**
+- {Positive consequence 1}
+- {Positive consequence 2}
+
+**Cons:**
+- {Negative consequence 1}
+
+**Risks:**
+- {Identified risk}
+
+### Alternatives Considered
+
+#### Option A: {Name}
+- Pros: {advantages}
+- Cons: {disadvantages}
+- **Rejected because:** {reason}
+
+#### Option B: {Name}
+- Pros: {advantages}
+- Cons: {disadvantages}
+- **Rejected because:** {reason}
+
+{{#if (eq STACK "blazor-azure")}}
+### Affected Flows
+- **Main flow:** {ex: Upload -> Payment -> Generation -> Email}
+- **Alternative flow:** {ex: Upload -> Generation -> Payment -> Email}
+- **Free flow:** {ex: Upload -> Generation -> Download}
+
+### Impacted State Validations
+
+> **Reference:** `framework/standards/status-validation.md`
+
+| Service | Method | Accepted States |
+|---------|--------|-----------------|
+| {ServiceName} | {MethodName} | {ex: PendingPayment, Completed} |
+
+### UI Components with Special Behavior
+- {ex: FluentDialog requires initial Hidden="true"}
+- {ex: Modal needs @ref for programmatic control}
+{{/if}}
+
+---
+
+{{#if (eq STACK "blazor-azure")}}
+## ADR-002: Database Model
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need to define how {Feature} data will be stored.
+
+### Decision
+
+Use Azure SQL with the following model:
+- {Entity} table with {columns}
+- JSON columns for {flexible data}
+
+### Consequences
+
+**Pros:**
+- Fits within free tier (32GB)
+- Good query performance
+
+---
+
+## ADR-003: AI Integration
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Feature requires AI capabilities for {purpose}.
+
+### Decision
+
+Use MS Agent Framework with gpt-4o-mini model.
+
+### Consequences
+
+**Pros:**
+- Cost effective (~$0.15/1M input tokens)
+- Good enough quality for this use case
+
+**Cons:**
+- Slightly less capable than gpt-4o
+{{/if}}
+
+{{#if (eq STACK "nextjs-supabase")}}
+## ADR-002: Database Access Strategy
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need to decide how the .NET API accesses Supabase PostgreSQL.
+
+### Decision
+
+Use Dapper with Npgsql for direct SQL queries. No EF Core.
+
+### Consequences
+
+**Pros:**
+- Full control over SQL queries
+- Better performance (no ORM overhead)
+- Direct access to PostgreSQL features (jsonb, pgvector, functions)
+- RLS policies apply naturally through connection
+
+**Cons:**
+- No automatic migrations (use Supabase CLI instead)
+- Manual SQL query writing
+- No change tracking
+
+---
+
+## ADR-003: Auth Strategy
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need authentication for both Next.js frontend and .NET API.
+
+### Decision
+
+Use Supabase Auth with @supabase/ssr on frontend. Validate JWT tokens in .NET API middleware.
+
+### Consequences
+
+**Pros:**
+- Single auth provider for both layers
+- RLS policies work automatically with auth.uid()
+- Built-in social login, magic links, email/password
+- No separate auth service to maintain
+
+**Cons:**
+- Coupled to Supabase ecosystem
+- JWT secret must be shared with .NET API
+{{/if}}
+
+---
+
+## Template for New ADRs
+
+```markdown
+## ADR-XXX: {Title}
+
+**Date:**
+**Status:** Proposed | Accepted | Deprecated | Superseded
+
+### Context
+{Why is this decision needed?}
+
+### Decision
+{What was decided?}
+
+### Consequences
+**Pros:** {list}
+**Cons:** {list}
+```
+
+---
+
+*Generated by MORPH Framework*

package/framework/templates/feature/recap.md

@@ -0,0 +1,146 @@
+# Feature Recap: {{titleCase FEATURE_NAME}}
+
+## Summary
+
+| Field | Value |
+|-------|-------|
+| **Feature ID** | {{FEATURE_NAME}} |
+| **Completed** | {{DATE}} |
+| **Total Tasks** | {X} |
+| **Time Spent** | {X}h |
+| **Agents Used** | {list} |
+{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
+
+---
+
+## Tasks Completed
+
+| ID | Title | Category | Duration |
+|----|-------|----------|----------|
+| T001 | {title} | {{#if (eq STACK "nextjs-supabase")}}Database{{else}}{category}{{/if}} | {X}min |
+| T002 | {title} | {{#if (eq STACK "nextjs-supabase")}}Backend{{else}}{category}{{/if}} | {X}min |
+| T003 | {title} | {{#if (eq STACK "nextjs-supabase")}}Frontend{{else}}{category}{{/if}} | {X}min |
+
+---
+
+{{#if (eq STACK "nextjs-supabase")}}
+## Validation Results
+
+| Validator | Status | Details |
+|-----------|--------|---------|
+| contract-compliance | Pass/Fail | {details} |
+| architecture | Pass/Fail | {details} |
+| design-system | Pass/Fail | {details} |
+| coding-standards | Pass/Fail | {details} |
+
+---
+
+{{/if}}
+## What Was Delivered
+
+### Functionality
+- {Functionality 1 delivered}
+- {Functionality 2 delivered}
+- {Functionality 3 delivered}
+
+{{#if (eq STACK "nextjs-supabase")}}
+### Database (Supabase)
+- Tables: {list}
+- RLS Policies: {count} policies
+- Migrations: {count} files
+
+### Backend API (.NET)
+- Endpoints: {count} endpoints
+- Services: {list}
+
+### Frontend (Next.js)
+- Pages: {list}
+- Components: {list}
+{{/if}}
+
+---
+
+## Files Created
+
+```
+{{#if (eq STACK "nextjs-supabase")}}
+supabase/migrations/{files}
+backend/src/{files}
+frontend/src/{files}
+{{else}}
+{list of created files}
+{{/if}}
+```
+
+## Files Modified
+
+```
+{list of modified files}
+```
+
+---
+
+## Architecture Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| {Decision 1} | {Reason} |
+| {Decision 2} | {Reason} |
+
+See full ADRs in `decisions.md`
+
+---
+
+## Test Coverage
+
+| Type | Files | Coverage |
+|------|-------|----------|
+| {{#if (eq STACK "nextjs-supabase")}}Backend Unit{{else}}Unit Tests{{/if}} | {X} | {X}% |
+| {{#if (eq STACK "nextjs-supabase")}}Frontend Component{{else}}Integration Tests{{/if}} | {X} | {X}% |
+
+---
+
+## Lessons Learned
+
+### What Went Well
+- {Positive point 1}
+- {Positive point 2}
+
+### What Could Be Improved
+- {Improvement point 1}
+- {Improvement point 2}
+
+### Recommendations for Future
+- {Recommendation 1}
+- {Recommendation 2}
+
+---
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Tasks Completed | {X}/{X} |
+| Checkpoints Passed | {X} |
+{{#if (eq STACK "nextjs-supabase")}}| Validation Passes | {X}/{X} |
+{{else}}| Code Reviews | {X} |
+{{/if}}| Bugs Found | {X} |
+| Bugs Fixed | {X} |
+
+---
+
+## Related Resources
+
+- **Proposal:** `proposal.md`
+- **Spec:** `spec.md`
+{{#if (eq STACK "nextjs-supabase")}}- **Contracts (.NET):** `contracts.cs`
+- **Contracts (TS):** `contracts.ts`
+{{else}}- **Contracts:** `contracts.cs`
+{{/if}}- **Tasks:** `tasks.md`
+- **Decisions:** `decisions.md`
+{{#if (eq STACK "blazor-azure")}}- **Azure DevOps Epic:** {link}
+{{/if}}- **PR:** {link}
+
+---
+
+*Generated by MORPH Framework on {{DATE}}*

package/framework/templates/feature/tasks.md

@@ -0,0 +1,199 @@
+# Tasks - {{titleCase FEATURE_NAME}}
+
+> Implementation checklist for the feature.
+> Update status as you progress.
+
+| Task ID | Type | Title | Status |
+|---------|------|-------|--------|
+| T001 | {type} | {title} | Pending |
+| T002 | {type} | {title} | Pending |
+| T003 | {type} | {title} | In Progress |
+| T004 | {type} | {title} | Blocked |
+| T005 | {type} | {title} | Done |
+
+**Status Values:** `Pending | In Progress | Blocked | Done`
+
+---
+
+## Task Granularity
+
+### Ideal Task
+- 15-60 minutes of implementation
+- 1-5 files modified
+- Testable in isolation
+- Independent commit possible
+
+### Signs of Too Broad (Split)
+**Bad example:** "Implement feature"
+**Split into:**
+- T001: Define contracts and interfaces
+- T002: Implement data layer
+- T003: Implement business logic
+- T004: Create UI components
+- T005: Write tests
+
+### Signs of Too Granular (Merge)
+**Bad example:** "Create field A", "Create field B", "Create field C"
+**Merge into:** "Create data model with all fields"
+
+---
+
+## Gates & Reviews
+
+| Task ID | Type | Description | Status |
+|---------|------|-------------|--------|
+| T003 | Review | Review contracts and data model | Pending |
+| T006 | Review | Review implementation | Pending |
+| T009 | Approval | Approve UI before testing | Pending |
+
+---
+
+## Phase 1: Contracts & Data Model
+
+### T001: Define contracts and interfaces
+- **Type:** Contract
+- **Priority:** 1
+- **Estimate:** 30min
+- **Assigned:** {agent}
+- **Dependencies:** None
+
+**Description:**
+
+Define service interfaces and contracts.
+
+**Deliverables:**
+- [ ] Create: `{path-to-interface-file}`
+
+---
+
+### T002: Create data model
+- **Type:** {{#if (eq STACK "nextjs-supabase")}}Database{{else}}Domain{{/if}}
+- **Priority:** 1
+- **Estimate:** 45min
+- **Assigned:** {agent}
+- **Dependencies:** None
+
+**Description:**
+
+Create data model {{#if (eq STACK "nextjs-supabase")}}with migrations{{else}}with entities{{/if}}.
+
+**Deliverables:**
+- [ ] Create: `{path-to-model-file}`
+
+---
+
+## Phase 2: Implementation
+
+### T003: Implement data layer
+- **Type:** {{#if (eq STACK "nextjs-supabase")}}Repository{{else}}Infrastructure{{/if}}
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** {agent}
+- **Dependencies:** T001, T002
+
+**Description:**
+
+Implement data access layer.
+
+**Deliverables:**
+- [ ] Create: `{path-to-repository-file}`
+
+---
+
+### T004: Implement business logic
+- **Type:** Service
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** {agent}
+- **Dependencies:** T001, T003
+
+**Description:**
+
+Implement service layer with business logic.
+
+**Deliverables:**
+- [ ] Create: `{path-to-service-file}`
+
+---
+
+## Phase 3: UI Components
+
+### T005: Create list component
+- **Type:** UI
+- **Priority:** 2
+- **Estimate:** 45min
+- **Assigned:** {agent}
+- **Dependencies:** T004
+
+**Description:**
+
+Create component to list items.
+
+**Deliverables:**
+- [ ] Create: `{path-to-component-file}`
+
+---
+
+### T006: Create form component
+- **Type:** UI
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** {agent}
+- **Dependencies:** T005
+
+**Description:**
+
+Create component for create/edit.
+
+**Deliverables:**
+- [ ] Create: `{path-to-form-file}`
+
+---
+
+## Phase 4: Testing
+
+### T007: Write unit tests
+- **Type:** Test
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** {agent}
+- **Dependencies:** T004
+
+**Description:**
+
+Unit tests for service layer.
+
+**Deliverables:**
+- [ ] Create: `{path-to-test-file}`
+
+---
+
+### T008: Write integration tests
+- **Type:** Test
+- **Priority:** 3
+- **Estimate:** 1h
+- **Assigned:** {agent}
+- **Dependencies:** T007
+
+**Description:**
+
+Integration tests for {{#if (eq STACK "nextjs-supabase")}}API and database{{else}}repository and API{{/if}}.
+
+**Deliverables:**
+- [ ] Create: `{path-to-integration-test-file}`
+
+---
+
+## Summary
+
+| Phase | Tasks | Estimate |
+|-------|-------|----------|
+| Phase 1 | T001-T002 | {X}h |
+| Phase 2 | T003-T004 | {X}h |
+| Phase 3 | T005-T006 | {X}h |
+| Phase 4 | T007-T008 | {X}h |
+| **Total** | **8 tasks** | **{X}h** |
+
+---
+
+*Generated by MORPH Framework*

package/framework/templates/infrastructure/azure/Dockerfile.example

@@ -0,0 +1,82 @@
+# ==============================================================================
+# MORPH-SPEC - .NET 8 Blazor Server Dockerfile
+# Multi-stage build for production-ready container
+# ==============================================================================
+
+# ==============================================================================
+# Stage 1: Base Runtime
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
+
+# Set working directory
+WORKDIR /app
+
+# Expose ports
+EXPOSE 8080
+EXPOSE 8081
+
+# Create non-root user for security
+RUN adduser --disabled-password --gecos '' appuser && chown -R appuser /app
+USER appuser
+
+# ==============================================================================
+# Stage 2: Build
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+
+# Set working directory
+WORKDIR /src
+
+# Copy project files
+# Adjust paths according to your solution structure
+COPY ["src/YourApp/YourApp.csproj", "src/YourApp/"]
+COPY ["src/YourApp.Core/YourApp.Core.csproj", "src/YourApp.Core/"]
+COPY ["src/YourApp.Infrastructure/YourApp.Infrastructure.csproj", "src/YourApp.Infrastructure/"]
+
+# Restore dependencies
+RUN dotnet restore "src/YourApp/YourApp.csproj"
+
+# Copy all source code
+COPY . .
+
+# Build project
+WORKDIR "/src/src/YourApp"
+RUN dotnet build "YourApp.csproj" -c Release -o /app/build
+
+# ==============================================================================
+# Stage 3: Publish
+# ==============================================================================
+FROM build AS publish
+
+# Publish application
+RUN dotnet publish "YourApp.csproj" \
+    -c Release \
+    -o /app/publish \
+    /p:UseAppHost=false \
+    /p:PublishTrimmed=false \
+    /p:PublishSingleFile=false
+
+# ==============================================================================
+# Stage 4: Final
+# ==============================================================================
+FROM base AS final
+
+# Set working directory
+WORKDIR /app
+
+# Copy published files from publish stage
+COPY --from=publish /app/publish .
+
+# Set environment variables
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+ENV DOTNET_RUNNING_IN_CONTAINER=true
+ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
+
+# Health check endpoint
+# Adjust path to match your health check endpoint
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Set entry point
+ENTRYPOINT ["dotnet", "YourApp.dll"]