@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/framework/skills/level-1-workflows/morph-phase-design/references/spec-example.md

@@ -1,253 +0,0 @@
-# Feature Specification: Photo Processing Pipeline
-
-> Example of a well-structured spec.md. This is a filled-in reference — not a template.
-
-| Field | Value |
-|-------|-------|
-| **ID** | photo-processing |
-| **Status** | Approved |
-| **Created** | 2025-01-15 |
-| **Stack** | blazor-azure |
-| **Complexity** | Medium |
-| **Estimated Cost** | ~$5.50/month |
-| **Agents** | Core: All / Specialists: dotnet-senior, nextjs-expert, infra-architect |
-
----
-
-## Overview
-
-**Problem:** Users cannot submit photos for AI transformation — the core product value proposition is blocked.
-
-**Solution:** End-to-end pipeline: upload → Blob Storage → Hangfire background job → AI processing → download link.
-
-**Success Criteria:**
-- [ ] Upload endpoint accepts .jpg/.png up to 10MB and stores in Azure Blob
-- [ ] Background job processes photo and updates status to Completed within 120s (p95)
-- [ ] Status polling page reflects real-time processing progress
-- [ ] Failed jobs retry up to 3 times with exponential backoff
-
----
-
-## Requirements
-
-**Functional:**
-FR1: Upload photo (.jpg/.png, max 10MB) via Blazor form
-FR2: Store photo in Azure Blob Storage under `uploads/{jobId}`
-FR3: Enqueue Hangfire background job for AI processing
-FR4: Status polling endpoint returns `{ status, progress, createdAt }`
-FR5: Download endpoint redirects to Blob URL for completed jobs
-
-**Non-Functional:**
-NFR1: Processing time < 120s for p95 of requests
-NFR2: Upload endpoint < 2s response time
-NFR3: Retry 3x on AI API failure with 5s/30s/120s backoff
-
----
-
-## User Stories
-
-### US001: Upload Photo
-**As** an authenticated user **I want** to upload a photo **so that** the AI can transform it.
-
-**Acceptance Criteria:**
-1. Accepts .jpg and .png files only — rejects other formats with clear error
-2. Rejects files larger than 10MB with a specific error message
-3. Returns a `jobId` and redirects to `/processing/{jobId}` on success
-
-**Edge Cases:**
-- Network timeout during upload: show retry button
-- Duplicate upload: create new job each time (idempotency not required)
-
-### US002: Track Progress
-**As** a user who uploaded a photo **I want** to see real-time status **so that** I know when my photo is ready.
-
-**Acceptance Criteria:**
-1. Page polls `/api/status/{jobId}` every 5 seconds
-2. Shows status label: Pending / Processing / Completed / Failed
-3. Shows "Download" button when status = Completed
-
----
-
-## Technical Design
-
-### Stack
-
-| Component | Technology |
-|-----------|------------|
-| Frontend | Blazor Server |
-| Backend | .NET 10 / C# 14 Minimal API |
-| Background Jobs | Hangfire (self-hosted) |
-| Storage | Azure Blob Storage (LRS) |
-| Database | Azure SQL |
-
-### Data Model
-
-#### ProcessingJob
-
-| Column | Type | Constraints |
-|--------|------|-------------|
-| Id | Guid | PK, default NEWID() |
-| OriginalPhotoUrl | nvarchar(500) | NOT NULL |
-| ProcessedPhotoUrl | nvarchar(500) | NULL (populated after processing) |
-| Status | int | NOT NULL, default 0 (Pending) |
-| ErrorMessage | nvarchar(1000) | NULL |
-| RetryCount | int | NOT NULL, default 0 |
-| CreatedAt | datetime2 | NOT NULL, default GETUTCDATE() |
-| UpdatedAt | datetime2 | NOT NULL |
-
-#### ProcessingStatus Enum
-
-```csharp
-public enum ProcessingStatus
-{
-    Pending = 0,
-    Processing = 1,
-    Completed = 2,
-    Failed = 100
-}
-```
-
-### Contracts
-
-```csharp
-// Commands
-public record UploadPhotoCommand(IFormFile Photo, string? Email);
-public record UploadPhotoResult(Guid JobId);
-
-// Queries
-public record GetJobStatusQuery(Guid JobId);
-public record JobStatusDto(Guid JobId, ProcessingStatus Status, string? ProcessedPhotoUrl, DateTime CreatedAt);
-
-// Service Interface
-public interface IPhotoProcessingService
-{
-    Task<UploadPhotoResult> UploadAsync(UploadPhotoCommand command, CancellationToken ct);
-    Task<JobStatusDto> GetStatusAsync(GetJobStatusQuery query, CancellationToken ct);
-}
-
-// Hangfire Job
-public interface IPhotoProcessingJob
-{
-    Task ProcessAsync(Guid jobId, CancellationToken ct);
-}
-```
-
----
-
-## UI/UX Design
-
-### Upload Page (/upload)
-
-```
-┌─────────────────────────────────────┐
-│  Upload Photo                        │
-│  ─────────────────────────────────  │
-│  [📁 Select File] photo.jpg (2.3MB)  │
-│                                      │
-│  Allowed: JPG, PNG — Max: 10MB       │
-│                                      │
-│             [Upload →]               │
-│                                      │
-│  Error state:                        │
-│  ⚠ File too large. Max size is 10MB. │
-└─────────────────────────────────────┘
-```
-
-### Status Page (/processing/{jobId})
-
-```
-┌─────────────────────────────────────┐
-│  Processing your photo               │
-│  ─────────────────────────────────  │
-│  Status: ⏳ Processing               │
-│  ████████░░░░░░░  60%               │
-│                                      │
-│  Started: 2025-01-15 14:32:01        │
-│                                      │
-│  [Completed state]:                  │
-│  Status: ✅ Done!                    │
-│            [📥 Download]             │
-└─────────────────────────────────────┘
-```
-
----
-
-## Flows
-
-### Upload Flow
-**Trigger:** User submits photo form
-
-1. User selects file → client validates type/size before submit
-2. `POST /api/upload` — server validates, uploads to Blob at `uploads/{jobId}/original.jpg`
-3. Create `ProcessingJob` entity (status = Pending)
-4. Enqueue Hangfire job with `jobId`
-5. Return `{ jobId }` → client redirects to `/processing/{jobId}`
-
-**End State:** Job queued, user on status page
-
-### Processing Flow
-**Trigger:** Hangfire executes job
-
-1. Load `ProcessingJob` by Id, set status = Processing
-2. Download original from Blob Storage
-3. Call AI API (`POST /transform`, multipart/form-data)
-4. On success: upload result to `uploads/{jobId}/processed.jpg`, set status = Completed
-5. On failure: increment RetryCount, set status = Failed if RetryCount >= 3
-
-**End State:** Job = Completed (photo available) or Failed (user sees error)
-
----
-
-## Cost Estimate
-
-| Resource | SKU | Monthly | Justification |
-|----------|-----|---------|---------------|
-| Blob Storage | LRS | $0.02 | ~500 photos/month × 2 files × avg 3MB |
-| Azure SQL | Basic | $4.99 | < 100k jobs/month |
-| Container App | Consumption | $0.49 | Scale to zero when idle |
-| Hangfire | Self-hosted | $0.00 | In-process with Container App |
-| **Total** | | **~$5.50** | |
-
----
-
-## ADRs
-
-### ADR-001: Hangfire over Azure Functions for Background Processing
-**Status:** Accepted
-**Context:** Need async processing for AI photo transformation (30–120s duration).
-**Decision:** Hangfire (self-hosted in Container App)
-**Alternatives:**
-1. Azure Functions — serverless, auto-scaling, but cold start latency + $10/mo for 50k executions
-2. Quartz.NET — more features (CRON, clustering), steeper learning curve
-**Trade-offs:** Simplicity + zero cost vs scalability (Hangfire sufficient for MVP < 10k/month)
-
-### ADR-002: Polling over WebSockets for Status Updates
-**Status:** Accepted
-**Context:** Users need real-time feedback; SSE/WebSocket adds Blazor Hub complexity.
-**Decision:** 5-second HTTP polling from Blazor component
-**Trade-offs:** Slightly higher server load vs significantly simpler implementation; polling sufficient at MVP scale
-
----
-
-## Security
-
-| Action | Required Policy |
-|--------|-----------------|
-| Upload | Authenticated user |
-| View status | Owner of job (check UserId) |
-| Download | Owner of job (check UserId) |
-
----
-
-## Definition of Done
-
-- [ ] Upload endpoint working, validated with unit + integration tests
-- [ ] Hangfire job processes photos end-to-end in dev environment
-- [ ] Status page shows correct states (Pending/Processing/Completed/Failed)
-- [ ] Code review approved
-- [ ] Deployed to staging environment
-- [ ] `recap.md` generated with implementation notes
-
----
-
-*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json

@@ -1,38 +0,0 @@
-{
-  "sessionId": "",
-  "feature": "",
-  "phase": "",
-  "hooks": [
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:06:20"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:07"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:15"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:15"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:40"
-    }
-  ],
-  "skills": []
-}