@polymorphism-tech/morph-spec 8.2.0 → 8.3.0

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

@@ -1,269 +0,0 @@
-# {{FEATURE_NAME}} - Feature Context
-
-> Auto-generated by MORPH-SPEC Framework
-> Last updated: {{TIMESTAMP}}
-
-## Feature Overview
-
-**Name:** {{FEATURE_NAME}}
-**Phase:** {{PHASE}}
-**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
-During the implement phase, track your work with the native `TaskCreate`/`TaskUpdate`
-tools. Persist progress by writing `tasks.json` (`2-plan/tasks.json`), touching ONLY
-the mutable fields `status`, `outputs`, and `notes` — via the `Write` tool or an `Edit`
-that touches only those fields. The plan contract (`title`, `description`,
-`dependencies`, `effort`, `doneCriteria`, `group`) is frozen after Gate 2. The recap is
-written by the implement skill; state syncs automatically via the `state-sync` hook.
-
-### Advance Phase
-```bash
-# Approve the current gate and scaffold the next phase folder in one step
-morph-spec advance {{FEATURE_NAME}}
-
-# Validate feature outputs
-morph-spec validate-feature {{FEATURE_NAME}}
-```
-
-### Validation
-```bash
-# Validate this feature's outputs against active standards
-morph-spec validate-feature {{FEATURE_NAME}}
-```
-
----
-
-## File Paths
-
-- **Outputs Directory:** `.morph/features/{{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

@@ -1,181 +0,0 @@
-# {{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 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 NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
-  - Project: {{NEON_PROJECT_ID}}
-  - Region: {{NEON_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 COOLIFY_ENABLED}}- **Coolify** (Docker Deployment via SSH)
-  - Server: {{COOLIFY_SERVER}}
-  - App: {{COOLIFY_APP_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
-# Check feature status and pending gates
-morph-spec status {feature}
-morph-spec approval-status {feature}
-
-# Approve the current gate and scaffold the next phase folder in one step
-morph-spec advance {feature}
-
-# Validate feature outputs
-morph-spec validate-feature {feature}
-
-# Archive a finished feature (after Gate 3)
-morph-spec archive {feature}
-```
-
-> Feature work starts by asking Claude Code to implement something — the proposal
-> phase is created for you. During the implement phase, task progress is tracked
-> with the native `TaskCreate`/`TaskUpdate` tools and persisted by writing
-> `tasks.json` (only `status`, `outputs`, `notes`); the recap is written by the
-> implement skill. State syncs automatically via the `state-sync` hook.
-
-### Key Paths
-- **Outputs:** `.morph/features/{feature}/`
-- **Standards:** `.morph/context/` (project overrides)
-- **Config:** `.morph/config/config.json`
-- **State:** `.morph/state.json`
-- **Templates:** `.morph/framework/templates/`
-
----
-
-*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*

package/src/lib/agents/metrics-aggregator.js

@@ -1,56 +0,0 @@
-/**
- * Project-level metrics aggregator
- *
- * Aggregates feature-level data from state.json into a project-wide
- * metrics summary. Pure computation — no I/O.
- */
-
-/**
- * Aggregate project-level metrics from state.json data.
- *
- * @param {Object} state - Parsed state.json content
- * @returns {Object} Aggregated metrics
- */
-export function aggregateProjectMetrics(state) {
-  const features = state?.features || {};
-  const featureNames = Object.keys(features);
-
-  const featureMetrics = featureNames.map(name => {
-    const f = features[name];
-    const tasks = f.tasks || {};
-    const taskIds = Object.keys(tasks);
-    const completedTasks = taskIds.filter(id => tasks[id]?.status === 'completed').length;
-    const dispatchLog = f.dispatchLog || [];
-
-    return {
-      name,
-      phase: f.phase || f.currentPhase || 'unknown',
-      taskCount: taskIds.length,
-      completedTasks,
-      dispatchCount: dispatchLog.length,
-    };
-  });
-
-  const totalFeatures = featureMetrics.length;
-  const completedFeatures = featureMetrics.filter(f => f.phase === 'review').length;
-  const totalTasks = featureMetrics.reduce((sum, f) => sum + f.taskCount, 0);
-  const completedTasks = featureMetrics.reduce((sum, f) => sum + f.completedTasks, 0);
-  const totalDispatches = featureMetrics.reduce((sum, f) => sum + f.dispatchCount, 0);
-  const completionRate = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
-  const avgTasksPerFeature = totalFeatures > 0 ? Math.round((totalTasks / totalFeatures) * 10) / 10 : 0;
-
-  return {
-    version: state?.version || 'unknown',
-    updatedAt: new Date().toISOString(),
-    summary: {
-      totalFeatures,
-      completedFeatures,
-      avgTasksPerFeature,
-      totalTasks,
-      completedTasks,
-      completionRate,
-      totalDispatches,
-    },
-    features: featureMetrics,
-  };
-}

package/src/lib/agents/metrics-calculator.js

@@ -1,125 +0,0 @@
-/**
- * Agent Metrics Calculator — Pure computation, no I/O.
- *
- * Calculates per-agent performance metrics from dispatch log entries.
- */
-
-/**
- * Calculate per-agent metrics from dispatch log entries.
- * @param {Array} dispatchLog - Array of dispatch entries
- * @returns {{ agents: Array, summary: Object }}
- */
-export function calculateMetrics(dispatchLog) {
-  if (!Array.isArray(dispatchLog) || dispatchLog.length === 0) {
-    return {
-      agents: [],
-      summary: { totalDispatches: 0, totalTasks: 0, completedTasks: 0, completionRate: 0, avgTaskDurationMs: null }
-    };
-  }
-
-  const agentMap = new Map();
-
-  for (const entry of dispatchLog) {
-    for (const agent of entry.agents || []) {
-      if (!agentMap.has(agent.id)) {
-        agentMap.set(agent.id, { dispatches: 0, tasksAssigned: 0, tasksCompleted: 0, durations: [] });
-      }
-      const acc = agentMap.get(agent.id);
-      acc.dispatches += 1;
-      acc.tasksAssigned += (agent.tasks || []).length;
-      acc.tasksCompleted += (agent.tasksCompleted || []).length;
-
-      if (agent.startedAt && agent.completedAt) {
-        const start = new Date(agent.startedAt).getTime();
-        const end = new Date(agent.completedAt).getTime();
-        if (!isNaN(start) && !isNaN(end) && end >= start) {
-          acc.durations.push(end - start);
-        }
-      }
-    }
-  }
-
-  const agents = [];
-  let totalDurationAll = 0;
-  let agentsWithDuration = 0;
-
-  for (const [id, acc] of agentMap) {
-    const totalDurationMs = acc.durations.length > 0
-      ? acc.durations.reduce((s, d) => s + d, 0)
-      : null;
-    const avgDurationMs = acc.durations.length > 0
-      ? Math.round(totalDurationMs / acc.durations.length)
-      : null;
-
-    if (totalDurationMs !== null) {
-      totalDurationAll += totalDurationMs;
-      agentsWithDuration++;
-    }
-
-    agents.push({
-      id,
-      dispatches: acc.dispatches,
-      tasksAssigned: acc.tasksAssigned,
-      tasksCompleted: acc.tasksCompleted,
-      completionRate: acc.tasksAssigned > 0 ? acc.tasksCompleted / acc.tasksAssigned : 0,
-      avgDurationMs,
-      totalDurationMs
-    });
-  }
-
-  agents.sort((a, b) => b.tasksCompleted - a.tasksCompleted);
-
-  const totalTasks = agents.reduce((s, a) => s + a.tasksAssigned, 0);
-  const completedTasks = agents.reduce((s, a) => s + a.tasksCompleted, 0);
-
-  return {
-    agents,
-    summary: {
-      totalDispatches: dispatchLog.length,
-      totalTasks,
-      completedTasks,
-      completionRate: totalTasks > 0 ? completedTasks / totalTasks : 0,
-      avgTaskDurationMs: completedTasks > 0 && totalDurationAll > 0
-        ? Math.round(totalDurationAll / completedTasks)
-        : null
-    }
-  };
-}
-
-/**
- * Format milliseconds as human-readable duration.
- * @param {number|null} ms
- * @returns {string}
- */
-export function formatDuration(ms) {
-  if (ms == null || ms < 0) return '\u2014';
-  if (ms === 0) return '0s';
-
-  const totalSeconds = Math.floor(ms / 1000);
-  const hours = Math.floor(totalSeconds / 3600);
-  const minutes = Math.floor((totalSeconds % 3600) / 60);
-  const seconds = totalSeconds % 60;
-
-  if (hours > 0) return `${hours}h ${minutes}m`;
-  if (minutes > 0) return `${minutes}m`;
-  return `${seconds}s`;
-}
-
-/**
- * Calculate cross-feature aggregated metrics.
- * @param {Object} features - state.features object
- * @returns {{ agents: Array, summary: Object, featureCount: number }}
- */
-export function calculateAggregatedMetrics(features) {
-  const allEntries = [];
-  let featureCount = 0;
-
-  for (const feature of Object.values(features || {})) {
-    featureCount++;
-    const log = feature.dispatchLog || [];
-    allEntries.push(...log);
-  }
-
-  const result = calculateMetrics(allEntries);
-  return { ...result, featureCount };
-}