@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/context/CONTEXT-FEATURE.md

@@ -0,0 +1,276 @@
+# {{FEATURE_NAME}} - Feature Context
+
+> Auto-generated by MORPH-SPEC Framework
+> Last updated: {{TIMESTAMP}}
+
+## Feature Overview
+
+**Name:** {{FEATURE_NAME}}
+**Phase:** {{PHASE}} ({{WORKFLOW_TYPE}})
+**Status:** {{STATUS}}
+**Complexity:** {{COMPLEXITY}}
+
+{{#if DESCRIPTION}}
+{{DESCRIPTION}}
+{{/if}}
+
+---
+
+## Progress Tracking
+
+### Current Phase: {{PHASE}}
+
+{{PHASE_DESCRIPTION}}
+
+**Completed Phases:**
+{{#each COMPLETED_PHASES}}
+- ✅ {{name}} - {{completedAt}}
+{{/each}}
+
+**Next Phases:**
+{{#each UPCOMING_PHASES}}
+- ⏭️ {{name}}
+{{/each}}
+
+### Task Progress
+
+**Total Tasks:** {{TASKS_TOTAL}}
+**Completed:** {{TASKS_COMPLETED}} ({{TASKS_PROGRESS}}%)
+**In Progress:** {{TASKS_IN_PROGRESS}}
+**Blocked:** {{TASKS_BLOCKED}}
+
+{{#if CURRENT_TASK}}
+**Current Task:** {{CURRENT_TASK.id}} - {{CURRENT_TASK.title}}
+{{/if}}
+
+---
+
+## Active Agents ({{ACTIVE_AGENTS_COUNT}})
+
+### Team Structure
+
+{{#if TEAM_LEAD}}
+**Team Lead:** {{TEAM_LEAD.title}} (`{{TEAM_LEAD.id}}`)
+{{/if}}
+
+{{#each SQUADS}}
+### {{leader.title}} Squad
+**Leader:** `{{leader.id}}`
+**Members ({{members.length}}):**
+{{#each members}}
+- {{title}} (`{{id}}`) {{#if status}}[{{status}}]{{/if}}
+{{/each}}
+{{/each}}
+
+### Validators (Run in Hooks)
+{{#each VALIDATORS}}
+- {{title}} (`{{id}}`)
+{{/each}}
+
+---
+
+## Agent Teams
+
+{{#if AGENT_TEAMS_DECISION}}
+{{#if AGENT_TEAMS_DECISION.useAgentTeams}}
+✅ **Agent Teams Recommended**
+
+**Reason:** {{AGENT_TEAMS_DECISION.reason}}
+**Display Mode:** {{AGENT_TEAMS_DECISION.displayMode}}
+**Total Teammates:** {{AGENT_TEAMS_DECISION.totalTeammates}}
+
+**Team Composition:**
+- Team Lead: {{AGENT_TEAMS_DECISION.teamLead}}
+- Domain Leaders: {{AGENT_TEAMS_DECISION.squads}}
+- Validators (hooks): {{AGENT_TEAMS_DECISION.validators}}
+
+{{else}}
+❌ **Single Session Recommended**
+
+**Reason:** {{AGENT_TEAMS_DECISION.reason}}
+**Recommendation:** {{AGENT_TEAMS_DECISION.recommendation}}
+{{/if}}
+{{/if}}
+
+---
+
+## Outputs Generated
+
+{{#each OUTPUTS}}
+### {{type}}
+**Status:** {{#if generated}}✅ Generated{{else}}⏳ Pending{{/if}}
+{{#if path}}**Path:** `{{path}}`{{/if}}
+{{#if generatedAt}}**Generated:** {{generatedAt}}{{/if}}
+{{/each}}
+
+---
+
+## Decisions Log
+
+{{#each DECISIONS}}
+### ADR-{{id}}: {{title}}
+
+**Status:** {{status}}
+**Date:** {{date}}
+**Decided By:** {{decidedBy}}
+
+**Context:** {{context}}
+
+**Decision:** {{decision}}
+
+{{#if constraints}}
+**Constraints for Validators:**
+```json
+{{constraints}}
+```
+{{/if}}
+
+{{#if alternatives}}
+**Alternatives Considered:**
+{{#each alternatives}}
+- {{name}}: {{rationale}}
+{{/each}}
+{{/if}}
+
+---
+{{/each}}
+
+{{#unless DECISIONS}}
+No decisions documented yet. Decisions will be logged in `decisions.md` during Design phase.
+{{/unless}}
+
+---
+
+## Validation Status
+
+{{#if VALIDATION_RESULTS}}
+### Latest Validation ({{VALIDATION_TIMESTAMP}})
+
+**Overall:** {{#if VALIDATION_PASSED}}✅ PASSED{{else}}❌ FAILED{{/if}}
+
+{{#each VALIDATION_RESULTS}}
+#### {{validator}}
+**Status:** {{#if passed}}✅ PASSED{{else}}❌ FAILED{{/if}}
+{{#if issues}}
+**Issues ({{issues.length}}):**
+{{#each issues}}
+- [{{severity}}] {{message}} ({{file}}:{{line}})
+{{/each}}
+{{/if}}
+{{/each}}
+
+{{else}}
+No validation runs yet. Validators run automatically via checkpoints.
+{{/if}}
+
+---
+
+## Tasks Breakdown
+
+{{#each TASKS}}
+### {{id}}: {{title}}
+
+**Status:** {{status}}
+{{#if priority}}**Priority:** {{priority}}{{/if}}
+{{#if estimatedFiles}}**Estimated Files:** {{estimatedFiles}}{{/if}}
+{{#if dependencies}}**Dependencies:** {{dependencies}}{{/if}}
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+{{#if agent}}**Assigned Agent:** `{{agent}}`{{/if}}
+
+{{#if checkpointAfter}}🔖 **Checkpoint after this task**{{/if}}
+
+{{#if completedAt}}✅ Completed: {{completedAt}}{{/if}}
+{{#if blockedReason}}❌ Blocked: {{blockedReason}}{{/if}}
+
+---
+{{/each}}
+
+---
+
+## Checkpoints
+
+{{#each CHECKPOINTS}}
+### {{timestamp}}
+**Phase:** {{phase}}
+**Tasks Completed:** {{tasksCompleted}}/{{tasksTotal}}
+
+{{#if note}}
+**Note:** {{note}}
+{{/if}}
+
+{{#if validation}}
+**Validation:** {{validation.passed}}/{{validation.total}} checks passed
+{{#if validation.issues}}
+- Issues: {{validation.issues}}
+{{/if}}
+{{/if}}
+
+---
+{{/each}}
+
+---
+
+## Related Standards
+
+{{#each RELATED_STANDARDS}}
+### {{name}}
+**Path:** `{{path}}`
+{{#if relevantSections}}
+**Relevant Sections:** {{relevantSections}}
+{{/if}}
+{{/each}}
+
+---
+
+## Quick Actions
+
+### Continue Implementation
+```bash
+# Start next task
+morph-spec task next {{FEATURE_NAME}}
+
+# Complete current task (runs validators)
+morph-spec task done {{FEATURE_NAME}} {{CURRENT_TASK_ID}}
+
+# Generate recap after task completion
+morph-spec generate recap {{FEATURE_NAME}}
+```
+
+### Advance Phase
+```bash
+# Check prerequisites and advance
+morph-spec phase advance {{FEATURE_NAME}}
+
+# Validate current phase before advancing
+morph-spec validate-phase {{FEATURE_NAME}} {{PHASE}}
+```
+
+### Validation
+```bash
+# Run all validators for active agents
+morph-spec validate {{FEATURE_NAME}}
+
+# Run specific validator
+morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
+```
+
+---
+
+## File Paths
+
+- **Outputs Directory:** `.morph/project/outputs/{{FEATURE_NAME}}/`
+- **Proposal:** `{{PROPOSAL_PATH}}`
+- **Spec:** `{{SPEC_PATH}}`
+- **Contracts:** `{{CONTRACTS_PATH}}`
+- **Tasks:** `{{TASKS_PATH}}`
+- **Decisions:** `{{DECISIONS_PATH}}`
+- **Recap:** `{{RECAP_PATH}}`
+
+---
+
+*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
+*Feature ID: {{FEATURE_ID}}*

package/framework/templates/context/CONTEXT.md

@@ -0,0 +1,181 @@
+# {{PROJECT_NAME}} - Project Context
+
+> Auto-generated by MORPH-SPEC Framework
+> Last updated: {{TIMESTAMP}}
+
+## Project Overview
+
+**Name:** {{PROJECT_NAME}}
+**Type:** {{PROJECT_TYPE}}
+**Repository:** {{REPOSITORY_URL}}
+
+{{PROJECT_DESCRIPTION}}
+
+---
+
+## Technology Stack
+
+### Frontend
+{{#if BLAZOR_ENABLED}}- **Blazor Server** {{BLAZOR_VERSION}}{{/if}}
+{{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
+{{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
+
+### Backend
+- **.NET** {{DOTNET_VERSION}}
+{{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
+{{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
+{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
+{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
+
+### Database
+{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
+{{#if SUPABASE_ENABLED}}- **Supabase** (PostgreSQL + Auth + Storage + RLS)
+  - Project: {{SUPABASE_PROJECT_ID}}
+  - Region: {{SUPABASE_REGION}}
+{{/if}}
+
+### Infrastructure
+{{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
+{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
+{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
+{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
+{{/if}}
+
+{{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
+  - API: {{EASYPANEL_API_URL}}
+  - Web: {{EASYPANEL_WEB_URL}}
+{{/if}}
+
+---
+
+## Active Features
+
+{{#each ACTIVE_FEATURES}}
+### {{name}} ({{phase}})
+**Status:** {{status}}
+**Complexity:** {{complexity}}
+**Active Agents:** {{activeAgents}}
+
+{{#if description}}{{description}}{{/if}}
+
+**Progress:**
+- Tasks: {{tasks.completed}}/{{tasks.total}}
+- Outputs: {{outputs}}
+
+{{/each}}
+
+---
+
+## Project Standards
+
+### Coding Standards
+{{#each PROJECT_STANDARDS}}
+- [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
+{{/each}}
+
+### Inferred Patterns
+{{#if INFERRED_STANDARDS}}
+{{INFERRED_STANDARDS}}
+{{/if}}
+
+---
+
+## Active Agents ({{AGENT_COUNT}})
+
+### Tier 1: Orchestrators
+{{#each TIER_1_AGENTS}}
+- **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
+{{/each}}
+
+### Tier 2: Domain Leaders
+{{#each TIER_2_AGENTS}}
+- **{{title}}** (`{{id}}`) - {{domains}}
+{{/each}}
+
+### Tier 3: Specialists
+{{#each TIER_3_AGENTS}}
+- **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
+{{/each}}
+
+---
+
+## Agent Teams Status
+
+{{#if AGENT_TEAMS_ENABLED}}
+✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
+
+**Spawn Thresholds:**
+- Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
+- Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
+- Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
+- Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
+
+{{else}}
+❌ **Disabled** - Use single session with subagents
+{{/if}}
+
+---
+
+## Recent Checkpoints
+
+{{#each RECENT_CHECKPOINTS}}
+### {{timestamp}}
+**Feature:** {{feature}}
+**Phase:** {{phase}}
+**Note:** {{note}}
+
+{{#if validation}}
+**Validation:** {{validation.passed}}/{{validation.total}} checks passed
+{{/if}}
+
+{{/each}}
+
+---
+
+{{#if DEVOPS_ENABLED}}
+## DevOps Integration
+
+**Organization:** {{DEVOPS_ORG}}
+**Project:** {{DEVOPS_PROJECT}}
+
+- **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
+- **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
+- **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
+
+---
+
+{{/if}}
+
+## Quick Reference
+
+### Workflow Commands
+```bash
+# Detect agents for feature
+morph-spec detect-agents "{feature description}"
+
+# Initialize new feature
+morph-spec state init
+
+# Generate design system
+morph-spec generate design-system {feature}
+
+# Advance to next phase
+morph-spec phase advance {feature}
+
+# Mark task complete (runs validators)
+morph-spec task done {feature} {task-id}
+
+# Generate recap
+morph-spec generate recap {feature}
+```
+
+### Key Paths
+- **Outputs:** `.morph/project/outputs/{feature}/`
+- **Standards:** `.morph/project/standards/` (project overrides)
+- **Config:** `.morph/config/config.json`
+- **State:** `.morph/state.json`
+- **Templates:** `.morph/templates/`
+
+---
+
+*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*

package/framework/templates/docs/proposal.md

@@ -0,0 +1,182 @@
+# 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}
+
+---
+
+## 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-supabase")}}
+### Technical Approach
+
+| Layer | Technology | Role |
+|-------|-----------|------|
+| **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
+| **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
+| **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
+| **Infra** | EasyPanel + 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-supabase")}}
+## Cost Estimate
+
+| Resource | Provider | Monthly Cost | Notes |
+|----------|----------|-------------|-------|
+| Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
+| VPS (EasyPanel) | {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} |
+
+---
+
+## Dependencies
+
+- [ ] {Dependency 1} - {status}
+- [ ] {Dependency 2} - {status}
+
+---
+
+## Estimated Effort
+
+| Phase | Estimate |
+|-------|----------|
+| Design & Spec | {X}h |
+{{#if (eq STACK "nextjs-supabase")}}| 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}
+
+---
+
+{{#if (eq STACK "blazor-azure")}}
+## Approval
+
+| Role | Name | Decision | Date |
+|------|------|----------|------|
+| Product Owner | | Pending | |
+| Tech Lead | | Pending | |
+
+---
+
+{{/if}}
+## Next Steps
+
+Once approved:
+1. Create detailed `spec.md` with technical design
+{{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
+3. Record decisions in `decisions.md`
+4. Break down into `tasks.md`
+5. Begin implementation
+{{else}}2. Break down into `tasks.md`
+3. Begin implementation
+{{/if}}
+
+---
+
+*Created with MORPH Framework*