@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/content/.morph/state.json

@@ -1,18 +1,18 @@
-{
-  "$schema": "./templates/state.template.json",
-  "version": "2.1.1",
-  "project": {
-    "name": "{PROJECT_NAME}",
-    "type": "blazor-server",
-    "createdAt": null,
-    "updatedAt": null
-  },
-  "features": {},
-  "metadata": {
-    "totalFeatures": 0,
-    "completedFeatures": 0,
-    "totalCostEstimated": 0,
-    "totalTimeSpent": 0,
-    "lastUpdated": null
-  }
+{
+  "$schema": "./templates/state.template.json",
+  "version": "2.1.1",
+  "project": {
+    "name": "{PROJECT_NAME}",
+    "type": "blazor-server",
+    "createdAt": null,
+    "updatedAt": null
+  },
+  "features": {},
+  "metadata": {
+    "totalFeatures": 0,
+    "completedFeatures": 0,
+    "totalCostEstimated": 0,
+    "totalTimeSpent": 0,
+    "lastUpdated": null
+  }
 }

package/content/.morph/templates/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 FASE 2 (Design).
+{{/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 `morph-spec task done`.
+{{/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/content/.morph/templates/CONTEXT.md

@@ -0,0 +1,170 @@
+# {{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}}
+- **Entity Framework Core** {{EF_VERSION}}
+{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
+{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
+
+### Infrastructure
+- **Azure** ({{AZURE_LOCATION}})
+{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
+{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
+{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
+{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/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}}
+
+---
+
+## DevOps Integration
+
+{{#if DEVOPS_ENABLED}}
+**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}}
+
+{{else}}
+DevOps integration not configured.
+{{/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}}*