@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/docs/COMMAND-FLOWS.md

@@ -1,368 +0,0 @@
-# morph-spec — Command Flow Diagrams
-
-> Each diagram shows the sequence of CLI calls and internal function calls for each slash command.
-
----
-
-## 1. /morph-proposal
-
-```mermaid
-flowchart TD
-    START(["/morph-proposal FEATURE"]) --> A
-
-    A["state get FEATURE"] --> B{"Exists?"}
-    B -->|yes| C["Identify current phase\nResume from where it stopped"]
-    B -->|no| D["Start Phase 0 from scratch"]
-    C --> D
-
-    subgraph P0 ["PHASE 0 — PROPOSAL"]
-        D --> E["detect-agents INPUT"]
-        E --> E1["loadAgentsConfig() ← agents.json"]
-        E1 --> E2["detectAgents() — keyword matching"]
-        E2 --> E3["analyzeRequestComplexity()"]
-        E3 --> E4["getStandardsListForAgent()\nloadStandardsForAgent()"]
-        E4 --> F["Render proposal.md via template"]
-        F --> G1["state set FEATURE status draft"]
-        G1 --> G2["state set FEATURE phase proposal"]
-        G2 --> G3["state mark-output FEATURE proposal"]
-        G3 --> G4["state add-agent FEATURE agent-id × N"]
-        G4 --> PAUSE0(["⏸ GATE — approve proposal"])
-    end
-
-    PAUSE0 -->|approved| H
-
-    subgraph P1 ["PHASE 1 — SETUP (auto, no gate)"]
-        H["Read .morph/context/"] --> I["Confirm detected stack"]
-        I --> J["List active agents"]
-        J --> J2["state set FEATURE phase setup"]
-    end
-
-    J2 --> UICHECK{"uiux-designer\nin activeAgents?"}
-
-    subgraph P15 ["PHASE 1.5 — UI/UX (conditional)"]
-        UICHECK -->|yes| L["Generate wireframes + design system\n(.claude/skills/phase-uiux/SKILL.md)"]
-        L --> PAUSEUI(["⏸ GATE — approve UI/UX"])
-    end
-
-    UICHECK -->|no| M
-    PAUSEUI -->|approved| M
-
-    subgraph P2 ["PHASE 2 — DESIGN"]
-        M["Generate spec.md\n(.claude/skills/phase-design/SKILL.md)"] --> N["Generate contracts.cs"]
-        N --> O["Generate decisions.md with ADRs"]
-        O --> P["Estimate costs per resource"]
-        P --> Q1["state mark-output FEATURE spec"]
-        Q1 --> Q2["state mark-output FEATURE contracts"]
-        Q2 --> Q3["state mark-output FEATURE decisions"]
-        Q3 --> PAUSE2(["⏸ GATE — approve design"])
-    end
-
-    PAUSE2 -->|approved| R
-
-    subgraph P3 ["PHASE 3 — CLARIFY"]
-        R["Identify ambiguities in spec\n(.claude/skills/phase-clarify/SKILL.md)"] --> S["Generate 3-7 questions"]
-        S --> WAIT(["⏳ Waiting for user answers"])
-        WAIT -->|answered| T["Update spec with clarifications\nand edge cases"]
-        T --> T2["state set FEATURE phase clarify"]
-    end
-
-    T2 --> U
-
-    subgraph P4 ["PHASE 4 — TASKS"]
-        U["Break spec into tasks T001-TXXX\n(.claude/skills/phase-tasks/SKILL.md)"] --> V["Define order and dependencies"]
-        V --> W["Checkpoints every 3 tasks"]
-        W --> X1["state mark-output FEATURE tasks"]
-        X1 --> X2["state set FEATURE tasks.total N"]
-        X2 --> PAUSE4(["⏸ GATE — approve tasks"])
-    end
-
-    PAUSE4 -->|approved| END(["✅ Planning complete\nRun /morph-apply FEATURE"])
-```
-
----
-
-## 2. /morph-apply
-
-```mermaid
-flowchart TD
-    START(["/morph-apply FEATURE"]) --> A
-
-    A["state get FEATURE"] --> B{"All phases\ncomplete?"}
-    B -->|no| ERR(["❌ ERROR — phase X not complete\nRun /morph-proposal FEATURE"])
-    B -->|yes| C
-
-    subgraph PREP ["INITIALIZATION"]
-        C["Read 1-design/spec.md + 3-tasks/tasks.md + 1-design/contracts.cs"] --> D
-        D["Read framework/standards/\n.morph/context/"] --> E1
-        E1["state set FEATURE phase implement"] --> E2
-        E2["state set FEATURE status in_progress"] --> E3
-        E3["state set FEATURE tasks.total N"]
-    end
-
-    E3 --> LOOP_START
-
-    subgraph LOOP ["LOOP — For each task in order"]
-        LOOP_START["Select next task"] --> F
-        F["task start FEATURE task-id"] --> F1
-        F1["spawn task-manager.cjs start"] --> G
-        G["Implement code\nfollowing contracts.cs + standards"] --> H
-        H["task done FEATURE task-id"] --> H1
-        H1["spawn task-manager.cjs done"] --> VAL_START
-
-        subgraph VAL ["Automatic validators (hooks)"]
-            VAL_START["security-expert\nSQL injection, XSS, hardcoded secrets"] --> V2
-            V2["architecture-expert\nIDbContextFactory, async/await, DI order"] --> V3
-            V3["packages-validator\nNuGet conflicts, vulnerabilities"] --> V4
-            V4["blazor-concurrency-validator\nLifecycle, thread safety"]
-        end
-
-        V4 --> VRESULT{"Validation\npassed?"}
-        VRESULT -->|no| FIX["Fix violations\nDO NOT use --skip-validation"] --> H
-        VRESULT -->|yes| CHK{"task_count\nmultiple of 3?"}
-        CHK -->|yes| CP["state checkpoint FEATURE\nstate list"]
-        CHK -->|no| NEXT
-        CP --> NEXT{"Next task\nexists?"}
-        NEXT -->|yes| LOOP_START
-    end
-
-    NEXT -->|no| FIN1
-
-    subgraph FIN ["FINALIZATION"]
-        FIN1["generate recap FEATURE"] --> FIN2
-        FIN2["extractFeatureMetadata()\nWrites 4-implement/recap.md"] --> FIN3
-        FIN3["state set FEATURE status done"] --> FIN4
-        FIN4["state mark-output FEATURE recap"] --> FIN5
-        FIN5["phase advance FEATURE"]
-    end
-
-    FIN5 --> END(["✅ Feature complete\nRun /morph-archive FEATURE"])
-```
-
----
-
-## 3. /morph-status
-
-```mermaid
-flowchart TD
-    START(["/morph-status"]) --> A
-
-    A["state list"] --> B
-    B["StateManager.getSummary()"] --> C
-    C["StateManager.listFeatures()"] --> D
-    D["Read .morph/state.json"] --> DASH
-
-    DASH["Display dashboard\nfeatures | phases | tasks X/Y | agents | costs"] --> EXTRA
-
-    EXTRA{"Specific feature\nrequested?"} -->|yes| G
-    EXTRA -->|no| CHECK
-
-    G["state get FEATURE"] --> G1["StateManager.getFeature()"] --> CHECK
-
-    subgraph CHECK_BLOCK ["Additional checks"]
-        CHECK["Check .morph/config/config.json"] --> CHECK2
-        CHECK2["Check .morph/framework/standards/ present"] --> CHECK3
-        CHECK3["Check .morph/archive/\ncompleted features"]
-    end
-
-    CHECK3 --> SUGEST["Suggest next actions\n/morph-proposal | /morph-apply | /morph-archive"]
-
-    SUGEST --> END(["✅ Dashboard displayed"])
-```
-
----
-
-## 4. /morph-archive
-
-```mermaid
-flowchart TD
-    START(["/morph-archive FEATURE"]) --> A
-
-    A["Read .morph/features/FEATURE/3-tasks/tasks.md"] --> B
-    B{"All tasks\ncomplete?"} -->|no| ERR(["❌ Feature not ready\nFinish pending tasks first"])
-    B -->|yes| C
-
-    C(["Confirm with user\nthat archiving is OK"]) --> D
-
-    subgraph RECAP ["RECAP"]
-        D["Update 4-implement/recap.md"] --> D1
-        D1["Fill in final metrics\n(tasks, time, actual vs estimated cost)"] --> D2
-        D2["Document lessons learned"]
-    end
-
-    D2 --> E{"Does spec define permanent\nsystem behavior?"}
-
-    E -->|yes| F["Extract spec → .morph/specs/DOMAIN/\nBecomes the 'current truth' of the system"]
-    F --> G
-    E -->|no| G
-
-    subgraph MOVE ["MOVE"]
-        G["Move full directory:\n.morph/features/FEATURE/\n→ .morph/archive/FEATURE/"]
-    end
-
-    G --> H
-
-    subgraph METRICS ["METRICS UPDATE"]
-        H["Increment completed features counter"] --> I
-        I["Update total accumulated cost"] --> J
-        J["Update total time spent"]
-    end
-
-    J --> END(["✅ Feature archived at\n.morph/archive/FEATURE/"])
-```
-
----
-
-## 5. /morph-infra
-
-```mermaid
-flowchart TD
-    START(["/morph-infra ACTION"]) --> ROUTE
-
-    ROUTE{"Action?"}
-
-    ROUTE -->|init| INIT_1
-    ROUTE -->|validate| VAL_1
-    ROUTE -->|plan| PLAN_1
-    ROUTE -->|deploy| DEP_1
-    ROUTE -->|destroy| DES_1
-
-    subgraph INIT ["INIT — Initialize IaC"]
-        INIT_1["Copy templates from\n.morph/framework/templates/infrastructure/"] --> INIT_2
-        INIT_2["Create infra/ structure\nmain.bicep\nparameters.dev.json, parameters.prod.json\nmodules/*.bicep"] --> INIT_3
-        INIT_3["Replace placeholders\nAPP_NAME, SUBSCRIPTION_ID\nRESOURCE_GROUP"] --> INIT_4
-        INIT_4["Document structure in decisions.md"]
-        INIT_4 --> INIT_END(["✅ Done — run /morph-infra validate"])
-    end
-
-    subgraph VALIDATE ["VALIDATE — Validate Templates"]
-        VAL_1["az bicep build --file infra/main.bicep"] --> VAL_2
-        VAL_2["Check required parameters"] --> VAL_3{"No errors?"}
-        VAL_3 -->|yes| VAL_OK(["✅ Templates valid"])
-        VAL_3 -->|no| VAL_ERR(["❌ Report syntax errors"])
-    end
-
-    subgraph PLAN ["PLAN — Preview Changes"]
-        PLAN_1["az account show"] --> PLAN_2{"Authenticated\nto Azure?"}
-        PLAN_2 -->|no| PLAN_ERR(["❌ Run az login"])
-        PLAN_2 -->|yes| PLAN_3["az deployment group what-if\n--template-file infra/main.bicep\n--parameters parameters.ENV.json"]
-        PLAN_3 --> PLAN_4["Display summary:\nCREATE / MODIFY / DELETE\n+ estimated costs"]
-        PLAN_4 --> PLAN_PAUSE(["⏸ GATE — wait for approval\nbefore running deploy"])
-    end
-
-    subgraph DEPLOY ["DEPLOY — Execute Deploy"]
-        DEP_1["Verify plan approval"] --> DEP_2
-        DEP_2["az group create --name rg-APP-ENV\n--location brazilsouth"] --> DEP_3
-        DEP_3["az deployment group create\n--template-file infra/main.bicep\n--parameters parameters.ENV.json"] --> DEP_4
-        DEP_4["Capture outputs:\nContainer App URL\nSQL Connection String\nKey Vault URI"] --> DEP_5
-        DEP_5["Update documentation\nwith deploy info"]
-        DEP_5 --> DEP_END(["✅ Deploy complete"])
-    end
-
-    subgraph DESTROY ["DESTROY — Remove Resources"]
-        DES_1(["⚠️ WARNING: irreversible action"]) --> DES_2
-        DES_2["List all resources\nthat will be deleted"] --> DES_3
-        DES_3(["⏸ GATE — require explicit confirmation\n'yes, delete'"]) --> DES_4
-        DES_4["az group delete --name rg-APP-ENV\n--yes --no-wait"]
-        DES_4 --> DES_END(["✅ Resources removed"])
-    end
-```
-
----
-
-## 6. /morph-preflight
-
-```mermaid
-flowchart TD
-    START(["/morph-preflight azure"]) --> C1
-
-    subgraph CHECKS ["7 SEQUENTIAL CHECKS"]
-        C1["Check 1 — Package Conflicts\ndotnet restore --verbosity normal\ngrep NU1605 NU1608"] --> R1{"OK?"}
-        R1 -->|✅| C2
-        R1 -->|❌| FIX1["Fix: declare Azure.Identity\nwith explicit version in .csproj"] --> C2
-
-        C2["Check 2 — EF Core Migrations\ndotnet ef migrations has-pending-model-changes\n--project src/Infrastructure --startup-project src/Web"] --> R2{"OK?"}
-        R2 -->|✅| C3
-        R2 -->|❌| FIX2["Fix: dotnet ef migrations add NAME"] --> C3
-
-        C3["Check 3 — Dockerfile\ndocker build --check .\nVerify multi-stage, EXPOSE, ENTRYPOINT"] --> R3{"Applicable\nand OK?"}
-        R3 -->|✅ or N/A| C4
-        R3 -->|❌| FIX3["Fix: correct Dockerfile"] --> C4
-
-        C4["Check 4 — Blazor .NET 10 Assets\ngrep RequiresAspNetWebAssets *.csproj"] --> R4{"OK?"}
-        R4 -->|✅ or N/A| C5
-        R4 -->|❌| FIX4["Fix: add RequiresAspNetWebAssets=true\nto .csproj"] --> C5
-
-        C5["Check 5 — Bicep Syntax\naz bicep build --file infra/main.bicep --stdout"] --> R5{"OK?"}
-        R5 -->|✅| C6
-        R5 -->|❌| FIX5["Fix: correct Bicep syntax errors"] --> C6
-
-        C6["Check 6 — Key Vault Config\ngrep KeyVaultUri appsettings*.json\ngrep IsDevelopment Program.cs"] --> R6{"OK?"}
-        R6 -->|✅| C7
-        R6 -->|❌| FIX6["Fix: add KeyVaultUri\nDO NOT gate on IsDevelopment"] --> C7
-
-        C7["Check 7 — Connection Strings\ngrep 'Password= Pwd= Secret='\nappsettings*.json excluding Development"] --> R7{"OK?"}
-        R7 -->|✅| SUM
-        R7 -->|⚠️| WARN["Warning: move secrets to Key Vault"] --> SUM
-    end
-
-    SUM["Display summary\nN passed / N failed / N warnings"] --> RESULT
-
-    RESULT{"Any\nfailures?"} -->|yes| BLOCK(["❌ BLOCKED\nDo not deploy until resolved!"])
-    RESULT -->|no| PASS(["✅ Ready to deploy to Azure"])
-```
-
----
-
-## 7. /morph-troubleshoot
-
-```mermaid
-flowchart TD
-    START(["/morph-troubleshoot KEYWORDS"]) --> A
-
-    A["troubleshootCommand(keywords, options)"] --> LISTCAT
-
-    LISTCAT{"--list-categories?"} -->|yes| CATS["getCategories()\nList: blazor, efcore, azure, auth, deploy"]
-    CATS --> END_CATS(["✅ Categories displayed"])
-
-    LISTCAT -->|no| L1_START
-
-    subgraph L1 ["Level 1 — Known Issues Index (Primary)"]
-        L1_START["searchIndex(searchTerms, options)"] --> L1A
-        L1A["Search JSON database\nof known issues"] --> L1B{"Filter\n--category?"}
-        L1B -->|yes| L1C["Filter by category"]
-        L1B -->|no| L1D["Match all keywords"]
-        L1C --> L1RESULT
-        L1D --> L1RESULT["Return matches with score"]
-    end
-
-    L1RESULT --> CHECK1{"Enough\nresults?"}
-    CHECK1 -->|yes| FORMAT
-
-    subgraph L2 ["Level 2 — Grep Standards (Automatic fallback)"]
-        CHECK1 -->|no| L2_START["searchGrep(searchTerms, options)"]
-        L2_START --> L2A["grep framework/standards/*.md"]
-        L2A --> L2B["grep .morph/framework/standards/*.md"]
-        L2B --> L2C["Deduplicate against Level 1 results"]
-        L2C --> L2D["Merge and limit to 10 results"]
-    end
-
-    L2D --> CHECK2{"Enough\nresults?"}
-    CHECK2 -->|yes| FORMAT
-
-    subgraph L3 ["Level 3 — Web Search (If needed)"]
-        CHECK2 -->|no| L3_START["WebSearch — external sources"]
-        L3_START --> L3A["site:github.com/dotnet/aspnetcore ERROR\nsite:github.com/dotnet/efcore ERROR"]
-        L3_START --> L3B["site:stackoverflow.com blazor ERROR\nsite:stackoverflow.com azure ERROR"]
-        L3_START --> L3C["site:learn.microsoft.com ERROR\nsite:learn.microsoft.com/azure ERROR"]
-        L3A & L3B & L3C --> L3MERGE["Consolidate relevant links"]
-    end
-
-    L3MERGE --> FORMAT
-
-    subgraph FMT ["Output Formatting"]
-        FORMAT["formatResult(result, verbose)\nRoot cause + Solution + Fix code"] --> FSUM
-        FSUM["formatSummary(stats)\nTotal found per level (L1/L2/L3)"]
-    end
-
-    FSUM --> END(["✅ Results displayed\nin standard format"])
-```

package/docs/claude-alignment-report.md

@@ -1,137 +0,0 @@
-# Claude Code Native Alignment Report — Round 2
-
-> **Date:** 2026-02-22
-> **Status:** Implemented
-> **Scope:** Memory/rules layer — building on Round 1 (commit 8c806c2)
-
----
-
-## Summary
-
-Round 2 of Claude Code native alignment identifies and adopts two native patterns from the official Claude Code memory documentation that were missed in Round 1:
-
-1. **`.claude/rules/*.md`** — Path-scoped, auto-loading instruction files
-2. **`@import` in CLAUDE.md** — Auto-import external files into session context
-
----
-
-## Native Patterns Now Adopted
-
-### 1. Path-Scoped Rules (`.claude/rules/`)
-
-**What it is:** Claude Code natively supports modular instruction files placed in `.claude/rules/`. Files without `paths:` frontmatter apply globally; files with `paths:` frontmatter auto-load only when Claude is working with matching files.
-
-**What we implemented:**
-
-| File | Scope | Paths |
-|------|-------|-------|
-| `morph-workflow.md` | Always active | (none — global) |
-| `csharp-standards.md` | C# files | `**/*.cs`, `**/*.csproj` |
-| `frontend-standards.md` | Blazor/TS/CSS | `**/*.razor`, `**/*.tsx`, `**/*.ts`, `**/*.css` |
-| `testing-standards.md` | Test files | `tests/**`, `**/*.test.*`, `**/*.spec.*`, `**/*Tests.cs` |
-| `infrastructure-standards.md` | Infra files | `**/*.bicep`, `**/Dockerfile`, `**/pipelines/**` |
-
-**Source material:** Distilled from `framework/standards/` (core/coding.md, backend/dotnet/core.md, core/testing.md, frontend/blazor/pitfalls.md, infrastructure/azure/azure.md, frontend/nextjs/nextjs-patterns.md).
-
-**Why it matters:** Previously, standards were buried in `.morph/framework/standards/` — Claude had to navigate deep paths to access them, and they were never automatically loaded. Path-scoped rules ensure Claude sees the right standards *automatically* when working on the right files, without any manual intervention.
-
-**Installation:** `morph-spec init` copies `framework/rules/` → `.claude/rules/` (step 9a in `initCommand()`).
-
-### 2. `@import` in CLAUDE.md
-
-**What it is:** Claude Code supports `@path/to/file` syntax inside CLAUDE.md to auto-import external files into the session context at startup.
-
-**What we implemented:** Added `@.morph/context/README.md` to `framework/CLAUDE.md`:
-
-```markdown
-## PROJECT CONTEXT
-
-@.morph/context/README.md
-```
-
-**Why it matters:** Previously, `framework/CLAUDE.md` referenced `.morph/context/README.md` only in text (e.g., "run `morph-spec detect` to see your stack"). The file was never actually loaded. Now, every Claude Code session in a user project automatically starts with the project context (stack, architecture, technologies) pre-loaded — no manual reading required.
-
----
-
-## What Remains Over-Engineered
-
-### Partially Redundant: Session Context Injection vs Auto Memory
-
-The `UserPromptSubmit` hook injects context into every session. This overlaps with:
-- Auto memory (`~/.claude/projects/.../memory/`) — Claude Code's native persistent context layer
-- The new `@import` in CLAUDE.md — project context auto-loaded at startup
-
-**Verdict:** Keep the hook for now. It handles dynamic state (current feature, active phase) that auto memory doesn't cover. Revisit in Round 3 — the hook may be reducible to only inject feature-specific state, not static project context.
-
-### Level 3–4 Skills Rarely Used
-
-`framework/skills/level-3-technologies/` and `level-4-patterns/` contain 30+ files that are rarely invoked. They're installed to `.claude/skills/` via symlinks/copies during init.
-
-**Verdict:** Keep for now — they're passive (loaded on-demand via `/skill-name`). Consider documenting them as "on-demand only" in the `morph-workflow.md` rule. Long-term, Level 3–4 could be removed from auto-install and accessed directly from `framework/skills/` when needed.
-
-### 37 Agents in `agents.json`
-
-The agent system has 37 agents across 4 tiers. For most projects, only 5–8 agents are active at any given time.
-
-**Verdict:** Acceptable complexity. Agents drive spawn prompts and workflow orchestration — they can't be replaced by documentation. The activation-by-keyword system (Tier 3) already limits unnecessary activation.
-
----
-
-## What Was Intentionally Kept (Justified)
-
-| Feature | Justification |
-|---------|--------------|
-| `state.json` + state machine | Claude Code has no native feature-tracking equivalent; phase enforcement requires runtime state |
-| `protect-spec-files.js` hook | Dynamically checks approval gate state before allowing spec file edits — cannot be replaced by static `permissions.deny` |
-| All 12 Claude Code hooks | Context injection (dynamic), output tracking (direct JSON I/O), tool failure logging all provide value beyond native capabilities |
-| `.morph/framework/standards/` | Deep reference library for agents; the rules layer distills it but doesn't replace it |
-| `permissions.deny` for state.json + framework | Already replaced `protect-readonly-files.js` hook in Round 1 — this is the right native approach |
-| Skills hierarchy (Level 0–2) | Level 0 (meta), Level 1 (phase workflows), Level 2 (domains) are actively invoked via `/skill-name` syntax |
-
----
-
-## Roadmap: Round 3 Candidates
-
-In priority order:
-
-1. **Session context hook reduction** — Trim `UserPromptSubmit` hook to inject only feature-specific dynamic state, relying on `@import` + rules for static context. Reduces hook complexity.
-
-2. **Level 3–4 skill audit** — Measure actual usage frequency. If consistently low, move these to a "pull-on-demand" model (reference from framework, not installed to `.claude/skills/`).
-
-3. **`morph-workflow.md` rule enhancement** — Add current workflow/phase detection so the always-active rule provides live feature status context (currently requires `morph-spec status` command).
-
-4. **User-level rules layer (`~/.claude/rules/`)** — A potential personal workflow preferences file for Polymorphism Tech developers (e.g., preferred stack defaults, commit message style). Not currently used.
-
-5. **Rules auto-update on `morph-spec update`** — Currently rules are only installed during `init`. The `update` command should sync `.claude/rules/` when framework rules change.
-
----
-
-## Files Changed in Round 2
-
-| Action | File |
-|--------|------|
-| Created | `framework/rules/morph-workflow.md` |
-| Created | `framework/rules/csharp-standards.md` |
-| Created | `framework/rules/frontend-standards.md` |
-| Created | `framework/rules/testing-standards.md` |
-| Created | `framework/rules/infrastructure-standards.md` |
-| Updated | `framework/CLAUDE.md` — added `@.morph/context/README.md` import |
-| Updated | `src/commands/project/init.js` — added step 9a: rules copy to `.claude/rules/` |
-| Created | `docs/claude-alignment-report.md` (this file) |
-
----
-
-## Round 1 Reference (commit 8c806c2)
-
-Round 1 implemented 7 tasks:
-1. Fixed circular hook bug in `track-output-creation.js`
-2. Native `permissions.deny` replaced `protect-readonly-files.js`
-3. Skills installed to `.claude/skills/` (flat, with symlinks on non-Windows)
-4. Global statusline installed to `~/.claude/`
-5. `PostToolUseFailure` hook: `handle-tool-failure.js`
-6. Standards registry: `framework/standards/STANDARDS.json` (74 entries)
-7. `framework/phases.json` — canonical phase definitions
-
----
-
-*MORPH-SPEC by Polymorphism Tech*

package/docs/examples/order-management/contracts.cs

@@ -1,84 +0,0 @@
-// ============================================================
-// CONTRACTS: Order Management — Level 2 (Business Logic)
-// Example of correctly filled contracts-level2.cs template
-// Feature: order-management | Date: 2026-02-23
-// ============================================================
-
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-using MediatR;
-
-// ===== AGGREGATE ROOT =====
-// Implementado em: Domain/Orders/Aggregates/Order.cs
-//
-// Invariants (do spec.md > Aggregate Blueprint):
-//   - Confirm() só é válido se Status == Draft E Items.Any()
-//   - AddItem() lança DomainException se Status != Draft
-//   - Cancel() é válido de Draft ou Confirmed → Cancelled (terminal)
-
-namespace ExampleApp.Domain.Orders.Events;
-
-// ===== DOMAIN EVENTS =====
-
-public record OrderCreatedEvent(Guid OrderId, Guid UserId) : DomainEvent;
-public record OrderConfirmedEvent(Guid OrderId, Guid UserId, decimal Total) : DomainEvent; // Total as decimal for event serialization; Money value object lives inside the Aggregate
-public record OrderCancelledEvent(Guid OrderId, string Reason) : DomainEvent;
-
-namespace ExampleApp.Application.Orders.Commands;
-
-// ===== COMMANDS (CQRS) =====
-
-public record CreateOrderCommand(Guid UserId, List<CreateOrderItemRequest> Items)
-    : IRequest<CreateOrderResult>;
-public record CreateOrderResult(Guid OrderId);
-
-public record ConfirmOrderCommand(Guid OrderId) : IRequest;
-public record CancelOrderCommand(Guid OrderId, string Reason) : IRequest;
-
-namespace ExampleApp.Application.Orders.Queries;
-
-// ===== QUERIES =====
-
-public record GetOrderQuery(Guid OrderId) : IRequest<OrderDto?>;
-
-// PagedResult<T> — defined in Shared/Common/PagedResult.cs (shared framework type)
-public record ListOrdersByUserQuery(Guid UserId, int Page = 1, int PageSize = 20)
-    : IRequest<PagedResult<OrderDto>>;
-
-namespace ExampleApp.Application.Orders;
-
-// ===== DTOs (read models — nunca expõe o Aggregate diretamente) =====
-
-public record OrderDto(
-    Guid Id,
-    Guid UserId,
-    string Status,
-    decimal Total,
-    List<OrderItemDto> Items,
-    DateTime CreatedAt,
-    DateTime? UpdatedAt
-);
-
-public record OrderItemDto(Guid ProductId, int Quantity, decimal UnitPrice, decimal Subtotal);
-
-public record CreateOrderItemRequest(Guid ProductId, int Quantity, decimal UnitPrice);
-
-namespace ExampleApp.Domain.Orders;
-
-// ===== REPOSITORY (um por Aggregate Root) =====
-
-public interface IOrderRepository
-{
-    Task<Order?> GetAsync(Guid id, CancellationToken ct = default);
-    Task<List<Order>> GetByUserAsync(Guid userId, CancellationToken ct = default);
-    Task AddAsync(Order order, CancellationToken ct = default);
-    Task UpdateAsync(Order order, CancellationToken ct = default);
-    Task<bool> ExistsAsync(Guid id, CancellationToken ct = default);
-}
-
-// ===== EXCEPTIONS =====
-
-public class OrderNotFoundException(Guid id) : DomainException($"Order '{id}' not found.");
-public class OrderInvalidStateException(string message) : DomainException(message);

package/docs/examples/order-management/proposal.md

@@ -1,24 +0,0 @@
-# Proposal: Order Management
-
-**Feature:** order-management
-**Type:** Business Logic (Level 2)
-**Stack:** .NET 10 / C# 14, Blazor Server, EF Core, Azure SQL
-
-## User Story
-
-Como usuário autenticado, quero criar e gerenciar pedidos de compra para que eu possa
-acompanhar o status dos meus pedidos e receber notificações de mudanças.
-
-## Acceptance Criteria
-
-- [ ] Usuário pode criar um pedido com 1+ itens
-- [ ] Pedido começa no status Draft
-- [ ] Pedido só pode ser Confirmado se tiver pelo menos 1 item
-- [ ] Pedido Confirmado não pode receber mais itens
-- [ ] Total do pedido é calculado automaticamente
-- [ ] Sistema notifica quando pedido é Confirmado
-
-## Out of Scope
-
-- Pagamento (feature separada)
-- Envio/logística