@polymorphism-tech/morph-spec 8.47.0 → 9.1.0

package/framework/templates/docs/proposal.md

@@ -1,192 +0,0 @@
-# Feature Proposal: {{titleCase FEATURE_NAME}}
-
-> Proposal for a new feature. This document describes WHAT and WHY.
-> For technical details, see `spec.md`.
-
-## Metadata
-
-| Field | Value |
-|-------|-------|
-| **Proposed** | {{DATE}} |
-| **Author** | {{AUTHOR}} |
-| **Status** | Draft / Under Review / Approved / Rejected |
-| **Priority** | High / Medium / Low |
-{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
-
----
-
-## Overview
-
-{Brief 2-3 sentence summary of the feature}
-
----
-
-## Acceptance Criteria
-
-Verifiable conditions that mean this feature is done:
-
-- [ ] {Criterion 1 — observable / testable}
-- [ ] {Criterion 2}
-- [ ] {Criterion 3}
-
----
-
-## Problem Statement
-
-### What is the problem?
-
-{Describe the problem this feature solves. Be specific.}
-
-### Who is affected?
-
-{Who suffers from this problem? End users? Developers? Operations?}
-
-### What is the impact?
-
-{What is the impact of NOT solving this problem?}
-- User productivity loss: {X}
-- Revenue/Cost impact: {X}
-- User satisfaction: {X}
-
----
-
-## Proposed Solution
-
-### Overview
-
-{Describe the proposed solution in 2-3 paragraphs}
-
-### Key Features
-
-1. **{Feature 1}** - {brief description}
-2. **{Feature 2}** - {brief description}
-3. **{Feature 3}** - {brief description}
-
-{{#if (eq STACK "nextjs-neon")}}
-### Technical Approach
-
-| Layer | Technology | Role |
-|-------|-----------|------|
-| **Database** | Neon (PostgreSQL + RLS) | {tables, policies, storage} |
-| **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
-| **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
-| **Infra** | Coolify + Docker | {deployment, SSL} |
-{{/if}}
-
-### User Journey
-
-```
-1. User {initial action}
-2. System {response}
-3. User {next action}
-4. System {final result}
-```
-
----
-
-{{#if (eq STACK "nextjs-neon")}}
-## Cost Estimate
-
-| Resource | Provider | Monthly Cost | Notes |
-|----------|----------|-------------|-------|
-| Neon | Free / Launch | $0 - $19 | {DB, Connection Pooling, Branching} |
-| VPS (Coolify) | {provider} | ${X} | {API + Web containers} |
-| External APIs | {provider} | ${X} | {if applicable} |
-| **Total** | | **${X}/month** | |
-
----
-
-{{/if}}
-## Success Metrics
-
-How will we know this feature is successful?
-
-| Metric | Current | Target |
-|--------|---------|--------|
-| {Metric 1} | {X} | {Y} |
-| {Metric 2} | {X} | {Y} |
-
----
-
-## Scope
-
-### In Scope
-
-- {Item 1 that is included}
-- {Item 2 that is included}
-- {Item 3 that is included}
-
-### Out of Scope
-
-- {Item 1 that is NOT included}
-- {Item 2 that is NOT included}
-
-### Future Considerations
-
-- {Item that could be added later}
-
----
-
-## Risks & Concerns
-
-| Risk | Likelihood | Impact | Mitigation |
-|------|------------|--------|------------|
-| {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
-| {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |
-
----
-
-## Conflitos com o acervo
-
-UCs (`.morph/specs/usecases/`), ADRs ativos (`.morph/specs/adrs/`) and `.morph/context/*.md` that
-this request contradicts. `Nenhum conflito encontrado.` when there is none — the section is always present.
-
-| Fonte | O que diz hoje | O que o pedido muda | Decisão |
-|-------|----------------|---------------------|---------|
-| {UC-133} | {Public Sans + Lora em toda a interface} | {admin passa a Geist} | {vale o novo no admin; a vitrine mantém o antigo — decisions.md ADR-001} |
-
----
-
-## Dependencies
-
-- [ ] {Dependency 1} - {status}
-- [ ] {Dependency 2} - {status}
-
----
-
-## Estimated Effort
-
-| Phase | Estimate |
-|-------|----------|
-| Design & Spec | {X}h |
-{{#if (eq STACK "nextjs-neon")}}| Database & Migrations | {X}h |
-| Backend API | {X}h |
-| Frontend | {X}h |
-{{else}}| Implementation | {X}h |
-{{/if}}| Testing | {X}h |
-| **Total** | **{X}h** |
-
----
-
-## Questions & Clarifications
-
-1. {Question 1 that needs answering}
-2. {Question 2 that needs answering}
-
----
-
-## Next Steps
-
-Once approved:
-1. Create detailed `spec.md` with technical design
-{{#if (eq STACK "nextjs-neon")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
-3. Record decisions in `decisions.md`
-4. Break down into `tasks.json`
-5. Begin implementation
-{{else}}2. Break down into `tasks.json`
-3. Begin implementation
-{{/if}}
-
----
-
-*Created with MORPH Framework*

package/framework/templates/docs/spec.md

@@ -1,57 +0,0 @@
-# Feature Specification: {{titleCase FEATURE_NAME}}
-
-| Field | Value |
-|-------|-------|
-| **ID** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
-| **Stack** | {{STACK}} |
-
-> Behavior lives in the use cases (`2-plan/usecases/UC-*.md`). This file says HOW they are realized —
-> do not repeat postconditions here.
-
-## Architecture
-
-{Components, how they connect, main data flows. Enough to implement without basic questions.}
-
-### Data Model
-
-| Entity | Field | Type | Notes |
-|--------|-------|------|-------|
-| {Entity} | {field} | {type} | {constraint, index, relation} |
-
-### Contracts
-
-```
-{METHOD} /api/{route}
-Request:  { ... }
-Response: { ... }  |  ProblemDetails 400/404/409
-```
-
-## Technical edge cases
-
-- {Edge case} → {how it is handled}
-
-## UCs e ADRs que esta feature altera ou revoga
-
-> Read by `morph-spec finish`: in the archive commit, each row marks the project acervo — a UC turns
-> `status: superseded` + `superseded_by` (+ `scope` when partial); an ADR leaves `.morph/specs/adrs/`
-> (total) or keeps its file with the scope where it still holds (partial). Columns are positional.
-> `morph-spec usecase check {feature}` reports a bad row while this file can still change (it freezes at Gate 2).
-> Nothing revoked → replace the table with `Nenhum.`
-
-| Id | Mudança | Substituto | Escopo em que o antigo ainda vale |
-|----|---------|------------|-----------------------------------|
-| UC-{nn} | parcial | UC-{nn} | {where the old one still holds} |
-| {feature}/ADR-{nnn} | total | — | — |
-
-## Contrato de implementação
-
-- **Standards:** {ids from `morph-spec standards --find`, plus `architecture-code-comments` and the stack's test standard}
-- **Proibições desta feature:** {beyond MORPH.md "Stack baked-in", or "nenhuma"}
-- **Verificação de runtime:** {how the stack comes up (`morph-spec e2e up {feature}`), which flows the evaluator navigates, which become Playwright specs, auth setup — or why it does not apply}
-- **Baseline:** {the COMMAND that measures it — `dotnet test`, `npm test` — never a number}
-- **Pré-requisito:** {a PREDICATE — `git merge-base --is-ancestor origin/main HEAD` exits 0 — never a SHA}
-
-## Out of Scope
-
-- {Item}

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

@@ -1,52 +0,0 @@
-# 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 +0,0 @@
-# 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*

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

@@ -1,167 +0,0 @@
-# UI Flows: {{titleCase FEATURE_NAME}}
-
-| Field | Value |
-|-------|-------|
-| **Feature** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
-
----
-
-## User Stories
-
-### US001: {Primary User Story}
-
-**As** a {user type}
-**I want** to {capability}
-**So that** {benefit}
-
-**Acceptance Criteria:**
-1. {Criterion 1}
-2. {Criterion 2}
-
----
-
-## Flow Inventory
-
-| Flow ID | Name | Priority |
-|---------|------|----------|
-| **F001** | Create New Item | High |
-| **F002** | Edit Existing Item | High |
-| **F003** | Delete Item | Medium |
-
----
-
-## F001: Create New Item
-
-### Happy Path
-
-```
-START
-  ↓
-[User clicks "Add New"]
-  ↓
-[Modal opens with form]
-  ↓
-[User fills required fields]
-  ↓
-[User clicks "Submit"]
-  ↓
-[Validation passes] ✓
-  ↓
-[API call: POST /api/items]
-  ↓
-[Success response]
-  ↓
-[Modal closes]
-  ↓
-[Success toast: "Item created"]
-  ↓
-[Table refreshes]
-  ↓
-END
-```
-
-**Duration:** 15-30 seconds
-**Success Rate Target:** 95%
-
----
-
-### Alternative Path: Validation Error
-
-```
-[User clicks "Submit"]
-  ↓
-[Validation fails] ✕
-  ↓
-[Error messages shown inline]
-  ↓
-[User corrects errors]
-  ↓
-[Real-time validation clears errors]
-  ↓
-→ Returns to Happy Path
-```
-
----
-
-### Edge Cases
-
-| Scenario | Behavior |
-|----------|----------|
-| **Duplicate Name** | Show warning, allow submit |
-| **Network Error** | Show error toast, preserve data |
-| **Session Expired** | Redirect to login |
-
----
-
-## F002: Edit Existing Item
-
-```
-[User clicks "Edit"]
-  ↓
-[Modal opens with pre-filled form]
-  ↓
-[User modifies fields]
-  ↓
-[User clicks "Save"]
-  ↓
-[API call: PUT /api/items/{id}]
-  ↓
-[Success toast]
-  ↓
-[Table refreshes]
-END
-```
-
----
-
-## F003: Delete Item
-
-```
-[User clicks "Delete"]
-  ↓
-[Confirmation dialog: "Delete item?"]
-  ↓
-[User confirms]
-  ↓
-[API call: DELETE /api/items/{id}]
-  ↓
-[Success toast]
-  ↓
-[Table refreshes]
-END
-```
-
----
-
-## Toast Notifications
-
-| Event | Type | Message | Duration |
-|-------|------|---------|----------|
-| **Item Created** | Success | "Item created successfully" | 3s |
-| **Item Updated** | Success | "Item updated successfully" | 3s |
-| **Item Deleted** | Success | "Item deleted successfully" | 3s |
-| **Error** | Error | "Something went wrong" | 5s |
-
----
-
-## Keyboard Shortcuts
-
-| Shortcut | Action |
-|----------|--------|
-| **Ctrl+N** | New Item |
-| **Escape** | Close modal |
-| **Enter** | Submit form |
-
----
-
-## Performance Targets
-
-| Flow | Target |
-|------|--------|
-| **Create Item** | < 2s (API response) |
-| **Search** | < 500ms |
-
----
-
-*Generated with MORPH Framework*

package/framework/templates/examples/spec-examples.md

@@ -1,91 +0,0 @@
-# Spec Template Reference
-
-> **Layer:** 3 | **Load:** on-demand | **Keywords:** spec, specification, template
-
-**The canonical template is `docs/spec.md` of the template system** (REGISTRY id `spec`),
-resolved from the installed package — see `framework/templates/README.md`.
-
-This file contains extended examples for each spec section.
-
----
-
-## Example: Entity (Pseudo-code)
-
-```csharp
-class ProcessingJob {
-  Guid Id
-  string OriginalPhotoUrl     // Azure Blob URL, max 500 chars
-  string? ProcessedPhotoUrl   // Nullable, populated after processing
-  ProcessingStatus Status     // Enum: Pending, Processing, Completed, Failed
-  DateTime CreatedAt
-  ICollection<ExecutionLog> Logs  // 1:N relationship
-}
-
-enum ProcessingStatus {
-  Pending = 0, Processing = 1, Completed = 2,  // Normal flow
-  Failed = 100                                   // Error states (high values)
-}
-```
-
-## Example: Command (Pseudo-code)
-
-```csharp
-UploadPhotoCommand {
-  Input: IFormFile photo, string? email
-  Output: Guid jobId
-
-  Handler:
-    1. Validate file (size <= 10MB, type in [.jpg, .png])
-    2. Upload to Azure Blob Storage
-    3. Create ProcessingJob entity (status = Pending)
-    4. Enqueue Hangfire background job
-    5. Return jobId
-}
-```
-
-## Example: API Endpoints
-
-```csharp
-PhotoProcessingController {
-  POST /api/upload        → multipart/form-data → { jobId: Guid }
-  GET  /api/status/{id}   → jobId → { status, progress, createdAt }
-  GET  /api/download/{id} → jobId → Redirect to Blob URL or 404
-}
-```
-
-## Example: Flow
-
-```
-Upload Flow (Actor: User)
-1. User selects photo → System validates (size, type) → If invalid: show error
-2. User sees preview → clicks "Upload"
-3. System creates ProcessingJob → uploads to Blob → enqueues Hangfire job → returns jobId
-4. System navigates to /processing/{jobId} → polls every 5s
-End State: User on progress page, job processing in background
-```
-
-## Example: ADR
-
-### ADR-001: Use Hangfire for Background Jobs
-**Status:** Accepted
-**Context:** Need background processing for AI photo transformation (30-120s).
-**Decision:** Hangfire (self-hosted).
-**Alternatives:**
-1. Azure Functions — serverless, auto-scaling, but cold start + $10/mo for 50k jobs
-2. Hangfire — zero cost, simpler, but scales with app
-3. Quartz.NET — more features, but steeper learning curve
-**Trade-offs:** Simplicity vs Features (Hangfire sufficient for MVP)
-
-## Example: Cost Estimate
-
-| Resource | SKU | Monthly | Justification |
-|----------|-----|---------|---------------|
-| Blob Storage | LRS | $0.02 | Store photos, low redundancy OK |
-| Azure SQL | Basic | $4.99 | < 100k jobs/month |
-| Container App | Consumption | $0.49 | Scale to zero |
-| Hangfire | Self-hosted | $0.00 | In-process |
-| **Total** | | **~$5.50** | |
-
----
-
-*MORPH-SPEC by Polymorphism Tech*