@polymorphism-tech/morph-spec 8.34.2 → 8.35.0

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

@@ -1,167 +1,167 @@
-# 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*
+# 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/docs/ui-mockups.md

@@ -1,98 +1,98 @@
-# UI Mockups & Wireframes: {{titleCase FEATURE_NAME}}
-
-| Field | Value |
-|-------|-------|
-| **Feature** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
-
----
-
-## Screen Inventory
-
-| Screen ID | Name | Route | Priority |
-|-----------|------|-------|----------|
-| **S001** | {Screen Name} | /path | High |
-| **S002** | {Screen Name} | /path | Medium |
-
----
-
-## S001: {Primary Screen}
-
-### Desktop Layout
-
-```
-┌─────────────────────────────────────┐
-│  Header                    [User ▼] │
-├─────────────────────────────────────┤
-│                                     │
-│  [Title]                            │
-│                                     │
-│  ┌──────────────────────────────┐  │
-│  │ Main Content Area            │  │
-│  │                              │  │
-│  │  [Card 1]    [Card 2]        │  │
-│  │                              │  │
-│  │  ┌────────────────────────┐  │  │
-│  │  │ Data Table             │  │  │
-│  │  │ ...                    │  │  │
-│  │  └────────────────────────┘  │  │
-│  └──────────────────────────────┘  │
-│                                     │
-└─────────────────────────────────────┘
-```
-
-### Mobile Layout
-
-```
-┌──────────────────────┐
-│ ☰  Title    [User ▼]│
-├──────────────────────┤
-│                      │
-│ [Card 1]             │
-│                      │
-│ [Card 2]             │
-│                      │
-│ [View All Items]     │
-│                      │
-└──────────────────────┘
-```
-
----
-
-## States
-
-### Loading
-- Show skeleton placeholders
-- Spinner for primary content
-
-### Empty
-- Icon + message
-- Clear call-to-action button
-
-### Error
-- Warning icon
-- User-friendly message
-- Retry button
-
-### Success (After Action)
-- Toast notification
-- Auto-dismiss after 3s
-
----
-
-## Interactions
-
-- **Hover**: Subtle elevation increase
-- **Click**: Scale down (0.98)
-- **Transitions**: Fade-in 200ms
-
----
-
-## Accessibility
-- [ ] 44x44px minimum touch targets
-- [ ] Focus indicators visible
-- [ ] Proper heading hierarchy (H1 → H2 → H3)
-
----
-
-*Generated with MORPH Framework*
+# UI Mockups & Wireframes: {{titleCase FEATURE_NAME}}
+
+| Field | Value |
+|-------|-------|
+| **Feature** | {{FEATURE_NAME}} |
+| **Created** | {{DATE}} |
+
+---
+
+## Screen Inventory
+
+| Screen ID | Name | Route | Priority |
+|-----------|------|-------|----------|
+| **S001** | {Screen Name} | /path | High |
+| **S002** | {Screen Name} | /path | Medium |
+
+---
+
+## S001: {Primary Screen}
+
+### Desktop Layout
+
+```
+┌─────────────────────────────────────┐
+│  Header                    [User ▼] │
+├─────────────────────────────────────┤
+│                                     │
+│  [Title]                            │
+│                                     │
+│  ┌──────────────────────────────┐  │
+│  │ Main Content Area            │  │
+│  │                              │  │
+│  │  [Card 1]    [Card 2]        │  │
+│  │                              │  │
+│  │  ┌────────────────────────┐  │  │
+│  │  │ Data Table             │  │  │
+│  │  │ ...                    │  │  │
+│  │  └────────────────────────┘  │  │
+│  └──────────────────────────────┘  │
+│                                     │
+└─────────────────────────────────────┘
+```
+
+### Mobile Layout
+
+```
+┌──────────────────────┐
+│ ☰  Title    [User ▼]│
+├──────────────────────┤
+│                      │
+│ [Card 1]             │
+│                      │
+│ [Card 2]             │
+│                      │
+│ [View All Items]     │
+│                      │
+└──────────────────────┘
+```
+
+---
+
+## States
+
+### Loading
+- Show skeleton placeholders
+- Spinner for primary content
+
+### Empty
+- Icon + message
+- Clear call-to-action button
+
+### Error
+- Warning icon
+- User-friendly message
+- Retry button
+
+### Success (After Action)
+- Toast notification
+- Auto-dismiss after 3s
+
+---
+
+## Interactions
+
+- **Hover**: Subtle elevation increase
+- **Click**: Scale down (0.98)
+- **Transitions**: Fade-in 200ms
+
+---
+
+## Accessibility
+- [ ] 44x44px minimum touch targets
+- [ ] Focus indicators visible
+- [ ] Proper heading hierarchy (H1 → H2 → H3)
+
+---
+
+*Generated with MORPH Framework*

package/framework/templates/dotnet/ai-kit/Directory.Build.props

@@ -0,0 +1,25 @@
+<Project>
+
+  <!--
+    Propriedades comuns a TODOS os projetos do Morph.AiKit.
+
+    NAO escreva versao de pacote aqui nem em nenhum .csproj: as versoes vivem em
+    Directory.Packages.props, GERADO por scripts/generate-ai-pin-props.js a partir de
+    framework/ai-pin.json. Com Central Package Management ligado, um <PackageReference>
+    com atributo Version vira erro de restore (NU1008) — e por isso que um .csproj nao
+    consegue divergir do pin.
+  -->
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+
+    <!-- Um kit cujo proposito e gritar nao pode engolir warning. -->
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+
+    <Deterministic>true</Deterministic>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+</Project>

package/framework/templates/dotnet/ai-kit/Directory.Packages.props

@@ -0,0 +1,26 @@
+<Project>
+  <!-- GERADO por scripts/generate-ai-pin-props.js a partir de framework/ai-pin.json. Não editar à mão — mexer no pin é mexer em framework/ai-pin.json. -->
+  <!-- pinnedAt: 2026-09-08 · fonte: https://api.nuget.org/v3/registration5-semver1/{id}/index.json -->
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+  <!-- Pacotes de IA (framework/ai-pin.json → packages) -->
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.Agents.AI" Version="1.20.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI" Version="10.9.0" />
+    <PackageVersion Include="OpenAI" Version="2.13.0" />
+    <PackageVersion Include="Google.GenAI" Version="1.21.0" />
+    <PackageVersion Include="ModelContextProtocol" Version="2.2.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI.Evaluation" Version="10.9.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Quality" Version="10.9.0" />
+    <PackageVersion Include="Microsoft.Extensions.AI.Evaluation.Reporting" Version="10.9.0" />
+  </ItemGroup>
+
+  <!-- Build e teste (framework/ai-pin.json → toolchain) -->
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.9.0" />
+    <PackageVersion Include="xunit.v3" Version="4.0.0" />
+    <PackageVersion Include="xunit.runner.visualstudio" Version="4.0.0" />
+  </ItemGroup>
+</Project>

package/framework/templates/dotnet/ai-kit/Morph.AiKit.sln

@@ -0,0 +1,56 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72D-47B6-A68D-7590B98EB39B}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Morph.AiKit", "src\Morph.AiKit\Morph.AiKit.csproj", "{0577D911-1F1E-422E-A1CD-23379F308B05}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{0AB3BF05-4346-4AA6-1389-037BE0695223}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Morph.AiKit.Tests", "tests\Morph.AiKit.Tests\Morph.AiKit.Tests.csproj", "{A0543CA3-CC90-45F6-940E-3F58570BB4D3}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|x64.Build.0 = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Debug|x86.Build.0 = Debug|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|x64.ActiveCfg = Release|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|x64.Build.0 = Release|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|x86.ActiveCfg = Release|Any CPU
+		{0577D911-1F1E-422E-A1CD-23379F308B05}.Release|x86.Build.0 = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|x64.Build.0 = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Debug|x86.Build.0 = Debug|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|x64.ActiveCfg = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|x64.Build.0 = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|x86.ActiveCfg = Release|Any CPU
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{0577D911-1F1E-422E-A1CD-23379F308B05} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{A0543CA3-CC90-45F6-940E-3F58570BB4D3} = {0AB3BF05-4346-4AA6-1389-037BE0695223}
+	EndGlobalSection
+EndGlobal

package/framework/templates/dotnet/ai-kit/NuGet.config

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  <clear /> e o ponto deste arquivo: sem ele o restore herda os feeds da maquina
+  (ou do runner) e "compila aqui, quebra no CI" volta a ser possivel. O kit
+  restaura de nuget.org e de mais nada.
+-->
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>