@polymorphism-tech/morph-spec 4.6.0 → 4.7.0

package/.morph/framework/templates/examples/design-system-examples.md

@@ -1,357 +0,0 @@
-# Design System CSS Index Template
-
-> Template de indice estruturado para arquivos CSS grandes.
-> Copie este header para o inicio do seu `design-system.css`.
-
-## Indice Padrao
-
-```css
-/* ===========================================================================
-   {PROJECT_NAME} Design System
-   ===========================================================================
-
-   Indice de Secoes
-   ================
-
-   1-99:     Tokens e Variaveis CSS
-   100-199:  Reset e Base Styles
-   200-299:  Tipografia
-   300-399:  Layout e Containers
-   400-499:  Componentes Base (buttons, inputs, cards)
-   500-599:  Componentes Compostos (forms, tables, lists)
-   600-699:  Navegacao (header, sidebar, footer, menus)
-   700-799:  Paginas Especificas
-   800-849:  Modais e Overlays
-   850-899:  Animacoes e Keyframes
-   900-949:  Responsivo e Media Queries
-   950-979:  Utilities e Helpers
-   980-989:  Overrides de Fluent UI / MudBlazor
-   990-999:  Hotfixes e Temporarios
-
-   Convencoes de Nomenclatura
-   ==========================
-
-   Prefixo por Pagina:
-   - .home-*      : Pagina inicial
-   - .checkout-*  : Pagina de checkout
-   - .dashboard-* : Pagina de dashboard
-   - .auth-*      : Paginas de autenticacao
-
-   Prefixo por Componente:
-   - .btn-*       : Botoes
-   - .card-*      : Cards
-   - .modal-*     : Modais
-   - .form-*      : Formularios
-   - .nav-*       : Navegacao
-
-   Sufixos de Estado:
-   - *--active    : Estado ativo
-   - *--disabled  : Estado desabilitado
-   - *--loading   : Estado de loading
-   - *--error     : Estado de erro
-
-   Validacao:
-   morph-spec validate-css src/MyApp.Web
-
-   =========================================================================== */
-
-
-/* ===========================================================================
-   SECAO 1-99: TOKENS E VARIAVEIS CSS
-   =========================================================================== */
-
-:root {
-  /* Cores Primarias */
-  --primary: #3b82f6;
-  --primary-hover: #2563eb;
-  --primary-active: #1d4ed8;
-
-  /* Cores Secundarias */
-  --secondary: #6b7280;
-  --secondary-hover: #4b5563;
-
-  /* Cores Semanticas */
-  --success: #10b981;
-  --warning: #f59e0b;
-  --error: #ef4444;
-  --info: #06b6d4;
-
-  /* Neutros */
-  --neutral-50: #f9fafb;
-  --neutral-100: #f3f4f6;
-  --neutral-200: #e5e7eb;
-  --neutral-300: #d1d5db;
-  --neutral-400: #9ca3af;
-  --neutral-500: #6b7280;
-  --neutral-600: #4b5563;
-  --neutral-700: #374151;
-  --neutral-800: #1f2937;
-  --neutral-900: #111827;
-
-  /* Tipografia */
-  --font-family: 'Inter', system-ui, -apple-system, sans-serif;
-  --font-family-mono: 'JetBrains Mono', monospace;
-
-  --font-size-xs: 0.75rem;   /* 12px */
-  --font-size-sm: 0.875rem;  /* 14px */
-  --font-size-base: 1rem;    /* 16px */
-  --font-size-lg: 1.125rem;  /* 18px */
-  --font-size-xl: 1.25rem;   /* 20px */
-  --font-size-2xl: 1.5rem;   /* 24px */
-  --font-size-3xl: 1.875rem; /* 30px */
-  --font-size-4xl: 2.25rem;  /* 36px */
-
-  /* Espacamento (base 4px) */
-  --space-1: 0.25rem;  /* 4px */
-  --space-2: 0.5rem;   /* 8px */
-  --space-3: 0.75rem;  /* 12px */
-  --space-4: 1rem;     /* 16px */
-  --space-5: 1.25rem;  /* 20px */
-  --space-6: 1.5rem;   /* 24px */
-  --space-8: 2rem;     /* 32px */
-  --space-10: 2.5rem;  /* 40px */
-  --space-12: 3rem;    /* 48px */
-
-  /* Border Radius */
-  --radius-sm: 0.25rem;  /* 4px */
-  --radius-md: 0.5rem;   /* 8px */
-  --radius-lg: 0.75rem;  /* 12px */
-  --radius-xl: 1rem;     /* 16px */
-  --radius-full: 9999px;
-
-  /* Sombras */
-  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
-  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
-  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1);
-  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1);
-
-  /* Transicoes */
-  --transition-fast: 150ms ease;
-  --transition-normal: 300ms ease;
-  --transition-slow: 500ms ease;
-
-  /* Z-Index */
-  --z-dropdown: 1000;
-  --z-sticky: 1020;
-  --z-fixed: 1030;
-  --z-modal-backdrop: 1040;
-  --z-modal: 1050;
-  --z-popover: 1060;
-  --z-tooltip: 1070;
-}
-
-
-/* ===========================================================================
-   SECAO 100-199: RESET E BASE STYLES
-   =========================================================================== */
-
-/* ... */
-
-
-/* ===========================================================================
-   SECAO 200-299: TIPOGRAFIA
-   =========================================================================== */
-
-/* ... */
-
-
-/* ===========================================================================
-   SECAO 300-399: LAYOUT E CONTAINERS
-   =========================================================================== */
-
-.page-layout {
-  min-height: 100vh;
-  display: flex;
-  flex-direction: column;
-}
-
-.page-content {
-  flex: 1;
-  padding: var(--space-6);
-}
-
-.container {
-  width: 100%;
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 0 var(--space-4);
-}
-
-
-/* ===========================================================================
-   SECAO 400-499: COMPONENTES BASE
-   =========================================================================== */
-
-/* Botoes */
-.btn-primary { /* ... */ }
-.btn-secondary { /* ... */ }
-
-/* Cards */
-.card { /* ... */ }
-.card-premium { /* ... */ }
-
-/* Inputs */
-.input { /* ... */ }
-
-
-/* ===========================================================================
-   SECAO 500-599: COMPONENTES COMPOSTOS
-   =========================================================================== */
-
-/* Forms */
-.form-group { /* ... */ }
-.form-label { /* ... */ }
-
-/* Tables */
-.data-table { /* ... */ }
-
-
-/* ===========================================================================
-   SECAO 600-699: NAVEGACAO
-   =========================================================================== */
-
-.page-header-nav { /* ... */ }
-.page-footer { /* ... */ }
-.sidebar { /* ... */ }
-
-
-/* ===========================================================================
-   SECAO 700-799: PAGINAS ESPECIFICAS
-   =========================================================================== */
-
-/* Home */
-.home-hero { /* ... */ }
-.home-features { /* ... */ }
-
-/* Checkout */
-.checkout-form { /* ... */ }
-.checkout-summary { /* ... */ }
-
-
-/* ===========================================================================
-   SECAO 800-849: MODAIS E OVERLAYS
-   =========================================================================== */
-
-.modal-overlay {
-  position: fixed;
-  inset: 0;
-  background: rgba(0, 0, 0, 0.5);
-  backdrop-filter: blur(4px);
-  z-index: var(--z-modal-backdrop);
-}
-
-.modal-container {
-  position: fixed;
-  top: 50%;
-  left: 50%;
-  transform: translate(-50%, -50%);
-  z-index: var(--z-modal);
-}
-
-
-/* ===========================================================================
-   SECAO 850-899: ANIMACOES E KEYFRAMES
-   =========================================================================== */
-
-@keyframes slideInUp {
-  from {
-    opacity: 0;
-    transform: translateY(20px);
-  }
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-
-@keyframes scaleIn {
-  from {
-    opacity: 0;
-    transform: scale(0.95);
-  }
-  to {
-    opacity: 1;
-    transform: scale(1);
-  }
-}
-
-.animate-slideInUp {
-  animation: slideInUp var(--transition-normal) forwards;
-}
-
-.animate-scaleIn {
-  animation: scaleIn var(--transition-fast) forwards;
-}
-
-/* Stagger delays para animacoes em sequencia */
-.stagger-1 { animation-delay: 0.1s; }
-.stagger-2 { animation-delay: 0.2s; }
-.stagger-3 { animation-delay: 0.3s; }
-.stagger-4 { animation-delay: 0.4s; }
-.stagger-5 { animation-delay: 0.5s; }
-
-
-/* ===========================================================================
-   SECAO 900-949: RESPONSIVO E MEDIA QUERIES
-   =========================================================================== */
-
-@media (max-width: 768px) {
-  /* Tablet e Mobile */
-}
-
-@media (max-width: 480px) {
-  /* Mobile */
-}
-
-
-/* ===========================================================================
-   SECAO 950-979: UTILITIES E HELPERS
-   =========================================================================== */
-
-.sr-only {
-  position: absolute;
-  width: 1px;
-  height: 1px;
-  padding: 0;
-  margin: -1px;
-  overflow: hidden;
-  clip: rect(0, 0, 0, 0);
-  white-space: nowrap;
-  border: 0;
-}
-
-
-/* ===========================================================================
-   SECAO 980-989: OVERRIDES DE FLUENT UI / MUDBLAZOR
-   =========================================================================== */
-
-/* Fluent UI overrides */
-.fluent-card {
-  /* Customizacoes */
-}
-
-
-/* ===========================================================================
-   SECAO 990-999: HOTFIXES E TEMPORARIOS
-   =========================================================================== */
-
-/* TODO: Remover apos fix no componente X */
-```
-
-## Uso
-
-1. Copie o header para o inicio do seu `design-system.css`
-2. Substitua `{PROJECT_NAME}` pelo nome do seu projeto
-3. Adicione suas classes CSS nas secoes apropriadas
-4. Mantenha o indice atualizado conforme adiciona novas secoes
-
-## Beneficios
-
-- **Navegacao rapida:** Use Ctrl+G (go to line) para pular para secoes
-- **Organizacao clara:** Cada tipo de componente em sua secao
-- **Facil manutencao:** Encontre onde adicionar novos estilos
-- **Evita conflitos:** Prefixos por pagina previnem colisoes
-
----
-
-*Template MORPH-SPEC v2.2.0 by Polymorphism Tech*

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

@@ -1,90 +0,0 @@
-# Spec Template Reference
-
-> **Layer:** 3 | **Load:** on-demand | **Keywords:** spec, specification, template
-
-**Use the stack's `.morph/framework/templates/spec.md` as the canonical template.**
-
-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*

package/.morph/framework/templates/feature/decisions.md

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