@polymorphism-tech/morph-spec 8.2.1 → 8.4.0

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 };
-}