@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/content/.morph/hooks/pre-commit-all.sh

@@ -1,48 +1,48 @@
-#!/bin/bash
-# MORPH-SPEC Master Pre-Commit Hook
-# Runs all validation hooks in sequence
-
-echo "╔════════════════════════════════════════════════╗"
-echo "║     MORPH-SPEC PRE-COMMIT VALIDATION           ║"
-echo "╚════════════════════════════════════════════════╝"
-echo ""
-
-HOOKS_DIR="$(dirname "$0")"
-
-# Run all hooks in order
-HOOKS=(
-  "pre-commit-agents.sh"
-  "pre-commit-costs.sh"
-  "pre-commit-specs.sh"
-  "pre-commit-tests.sh"
-)
-
-HAS_FAILURES=false
-
-for hook in "${HOOKS[@]}"; do
-  HOOK_PATH="$HOOKS_DIR/$hook"
-
-  if [ ! -f "$HOOK_PATH" ]; then
-    echo "⚠️  Hook not found: $hook (skipping)"
-    continue
-  fi
-
-  echo "─────────────────────────────────────────────────"
-  if ! bash "$HOOK_PATH"; then
-    HAS_FAILURES=true
-    echo "❌ Hook failed: $hook"
-  fi
-  echo ""
-done
-
-echo "═════════════════════════════════════════════════"
-
-if [ "$HAS_FAILURES" = true ]; then
-  echo "❌ PRE-COMMIT VALIDATION FAILED"
-  echo "   Fix errors above before committing"
-  echo "   Or use: git commit --no-verify to skip"
-  exit 1
-fi
-
-echo "✅ ALL PRE-COMMIT VALIDATIONS PASSED"
-exit 0
+#!/bin/bash
+# MORPH-SPEC Master Pre-Commit Hook
+# Runs all validation hooks in sequence
+
+echo "╔════════════════════════════════════════════════╗"
+echo "║     MORPH-SPEC PRE-COMMIT VALIDATION           ║"
+echo "╚════════════════════════════════════════════════╝"
+echo ""
+
+HOOKS_DIR="$(dirname "$0")"
+
+# Run all hooks in order
+HOOKS=(
+  "pre-commit-agents.sh"
+  "pre-commit-costs.sh"
+  "pre-commit-specs.sh"
+  "pre-commit-tests.sh"
+)
+
+HAS_FAILURES=false
+
+for hook in "${HOOKS[@]}"; do
+  HOOK_PATH="$HOOKS_DIR/$hook"
+
+  if [ ! -f "$HOOK_PATH" ]; then
+    echo "⚠️  Hook not found: $hook (skipping)"
+    continue
+  fi
+
+  echo "─────────────────────────────────────────────────"
+  if ! bash "$HOOK_PATH"; then
+    HAS_FAILURES=true
+    echo "❌ Hook failed: $hook"
+  fi
+  echo ""
+done
+
+echo "═════════════════════════════════════════════════"
+
+if [ "$HAS_FAILURES" = true ]; then
+  echo "❌ PRE-COMMIT VALIDATION FAILED"
+  echo "   Fix errors above before committing"
+  echo "   Or use: git commit --no-verify to skip"
+  exit 1
+fi
+
+echo "✅ ALL PRE-COMMIT VALIDATIONS PASSED"
+exit 0

package/content/.morph/hooks/pre-commit-specs.sh

@@ -1,49 +1,49 @@
-#!/bin/bash
-# MORPH-SPEC Pre-Commit Hook: Spec Validation
-# Validates that spec.md files have required sections
-
-echo "🔍 Validating spec files..."
-
-# Find modified spec.md files
-SPEC_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep 'spec\.md$')
-
-if [ -z "$SPEC_FILES" ]; then
-  echo "✓ No spec files modified"
-  exit 0
-fi
-
-HAS_ERRORS=false
-
-for spec_file in $SPEC_FILES; do
-  echo "Checking: $spec_file"
-
-  # Required sections
-  REQUIRED_SECTIONS=(
-    "## 📋 Metadata"
-    "## 🎯 Overview"
-    "## 🏗️ Technical Design"
-    "## ✅ Acceptance Criteria"
-  )
-
-  for section in "${REQUIRED_SECTIONS[@]}"; do
-    if ! grep -q "$section" "$spec_file"; then
-      echo "  ❌ Missing section: $section"
-      HAS_ERRORS=true
-    fi
-  done
-
-  # Check if has at least one user story or requirement
-  if ! grep -qi "user story\|requirement\|acceptance criteria" "$spec_file"; then
-    echo "  ⚠️  Warning: No user stories or requirements found"
-  fi
-done
-
-if [ "$HAS_ERRORS" = true ]; then
-  echo ""
-  echo "❌ COMMIT BLOCKED: spec.md files are incomplete"
-  echo "   Add missing sections before committing"
-  exit 1
-fi
-
-echo "✓ All spec files are valid"
-exit 0
+#!/bin/bash
+# MORPH-SPEC Pre-Commit Hook: Spec Validation
+# Validates that spec.md files have required sections
+
+echo "🔍 Validating spec files..."
+
+# Find modified spec.md files
+SPEC_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep 'spec\.md$')
+
+if [ -z "$SPEC_FILES" ]; then
+  echo "✓ No spec files modified"
+  exit 0
+fi
+
+HAS_ERRORS=false
+
+for spec_file in $SPEC_FILES; do
+  echo "Checking: $spec_file"
+
+  # Required sections
+  REQUIRED_SECTIONS=(
+    "## 📋 Metadata"
+    "## 🎯 Overview"
+    "## 🏗️ Technical Design"
+    "## ✅ Acceptance Criteria"
+  )
+
+  for section in "${REQUIRED_SECTIONS[@]}"; do
+    if ! grep -q "$section" "$spec_file"; then
+      echo "  ❌ Missing section: $section"
+      HAS_ERRORS=true
+    fi
+  done
+
+  # Check if has at least one user story or requirement
+  if ! grep -qi "user story\|requirement\|acceptance criteria" "$spec_file"; then
+    echo "  ⚠️  Warning: No user stories or requirements found"
+  fi
+done
+
+if [ "$HAS_ERRORS" = true ]; then
+  echo ""
+  echo "❌ COMMIT BLOCKED: spec.md files are incomplete"
+  echo "   Add missing sections before committing"
+  exit 1
+fi
+
+echo "✓ All spec files are valid"
+exit 0

package/content/.morph/hooks/pre-commit-tests.sh

@@ -1,60 +1,60 @@
-#!/bin/bash
-# MORPH-SPEC Pre-Commit Hook: Test Coverage
-# Ensures new code has corresponding tests
-
-echo "🧪 Checking test coverage..."
-
-# Find modified C# files (excluding tests)
-CS_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cs$' | grep -v 'Tests\|Test\.cs$')
-
-if [ -z "$CS_FILES" ]; then
-  echo "✓ No production code modified"
-  exit 0
-fi
-
-MISSING_TESTS=false
-
-for cs_file in $CS_FILES; do
-  # Extract class name
-  class_name=$(basename "$cs_file" .cs)
-
-  # Look for corresponding test file
-  test_patterns=(
-    "*/${class_name}Tests.cs"
-    "*/${class_name}Test.cs"
-    "*/Test${class_name}.cs"
-  )
-
-  FOUND_TEST=false
-  for pattern in "${test_patterns[@]}"; do
-    if find . -path "$pattern" 2>/dev/null | grep -q .; then
-      FOUND_TEST=true
-      break
-    fi
-  done
-
-  if [ "$FOUND_TEST" = false ]; then
-    # Check if it's a trivial file (DTO, model, etc.)
-    if grep -qi 'record\|DTO\|Model\|Entity' "$cs_file" && ! grep -qi 'class.*{.*public.*{' "$cs_file"; then
-      echo "  ℹ️  Skipping trivial file: $cs_file"
-      continue
-    fi
-
-    echo "  ⚠️  No test found for: $cs_file"
-    MISSING_TESTS=true
-  else
-    echo "  ✓ Test found for: $cs_file"
-  fi
-done
-
-if [ "$MISSING_TESTS" = true ]; then
-  echo ""
-  echo "⚠️  WARNING: Some files don't have tests"
-  echo "   Consider adding tests before committing"
-  echo "   Override with: git commit --no-verify"
-  # Don't block, just warn
-  exit 0
-fi
-
-echo "✓ Test coverage looks good"
-exit 0
+#!/bin/bash
+# MORPH-SPEC Pre-Commit Hook: Test Coverage
+# Ensures new code has corresponding tests
+
+echo "🧪 Checking test coverage..."
+
+# Find modified C# files (excluding tests)
+CS_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cs$' | grep -v 'Tests\|Test\.cs$')
+
+if [ -z "$CS_FILES" ]; then
+  echo "✓ No production code modified"
+  exit 0
+fi
+
+MISSING_TESTS=false
+
+for cs_file in $CS_FILES; do
+  # Extract class name
+  class_name=$(basename "$cs_file" .cs)
+
+  # Look for corresponding test file
+  test_patterns=(
+    "*/${class_name}Tests.cs"
+    "*/${class_name}Test.cs"
+    "*/Test${class_name}.cs"
+  )
+
+  FOUND_TEST=false
+  for pattern in "${test_patterns[@]}"; do
+    if find . -path "$pattern" 2>/dev/null | grep -q .; then
+      FOUND_TEST=true
+      break
+    fi
+  done
+
+  if [ "$FOUND_TEST" = false ]; then
+    # Check if it's a trivial file (DTO, model, etc.)
+    if grep -qi 'record\|DTO\|Model\|Entity' "$cs_file" && ! grep -qi 'class.*{.*public.*{' "$cs_file"; then
+      echo "  ℹ️  Skipping trivial file: $cs_file"
+      continue
+    fi
+
+    echo "  ⚠️  No test found for: $cs_file"
+    MISSING_TESTS=true
+  else
+    echo "  ✓ Test found for: $cs_file"
+  fi
+done
+
+if [ "$MISSING_TESTS" = true ]; then
+  echo ""
+  echo "⚠️  WARNING: Some files don't have tests"
+  echo "   Consider adding tests before committing"
+  echo "   Override with: git commit --no-verify"
+  # Don't block, just warn
+  exit 0
+fi
+
+echo "✓ Test coverage looks good"
+exit 0

package/content/.morph/hooks/task-completed.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+/**
+ * TaskCompleted Hook - Claude Code Agent Teams
+ *
+ * Triggered when a task is marked as completed.
+ * Validates the task deliverables before allowing the task to be marked done.
+ *
+ * Usage (from Claude Code hooks):
+ *   task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]
+ *
+ * Exit codes:
+ *   0 - All validators passed
+ *   1 - Validation failed and blocked
+ *   2 - Configuration error
+ */
+
+import { executeHook, formatHookResults } from '../../../src/lib/hook-executor.js';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get project root (3 levels up from hooks dir)
+const projectPath = join(__dirname, '../../..');
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length < 2) {
+    console.error('Usage: task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]');
+    process.exit(2);
+  }
+
+  const featureName = args[0];
+  const taskId = args[1];
+  const dryRun = args.includes('--dry-run');
+  const verbose = args.includes('--verbose');
+
+  console.log('🔔 TaskCompleted Hook Triggered');
+  console.log(`   Feature: ${featureName}`);
+  console.log(`   Task: ${taskId}`);
+  console.log(`   Event: Task marked complete, validating deliverables...\n`);
+
+  try {
+    const results = await executeHook(projectPath, featureName, 'TaskCompleted', {
+      dryRun,
+      verbose
+    });
+
+    const output = formatHookResults(results, 'TaskCompleted');
+    console.log(output);
+
+    if (results.blocked) {
+      console.log('\n💡 TIP: Fix the errors above before the task can be marked complete.');
+      console.log(`   Run: morph-spec task done ${featureName} ${taskId} --skip-validation`);
+      console.log('   (Not recommended - only use if you know what you\'re doing)');
+      process.exit(1);
+    }
+
+    console.log('\n✅ Task deliverables validated successfully.');
+    process.exit(0);
+  } catch (err) {
+    console.error(`\n❌ Hook execution error: ${err.message}`);
+    if (verbose) {
+      console.error(err.stack);
+    }
+    process.exit(2);
+  }
+}
+
+main();

package/content/.morph/hooks/teammate-idle.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * TeammateIdle Hook - Claude Code Agent Teams
+ *
+ * Triggered when a teammate is idle and waiting for next instructions.
+ * Validates the teammate's recent work before allowing them to proceed.
+ *
+ * Usage (from Claude Code hooks):
+ *   teammate-idle.js <feature-name> [--dry-run] [--verbose]
+ *
+ * Exit codes:
+ *   0 - All validators passed
+ *   1 - Validation failed and blocked
+ *   2 - Configuration error
+ */
+
+import { executeHook, formatHookResults } from '../../../src/lib/hook-executor.js';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get project root (3 levels up from hooks dir)
+const projectPath = join(__dirname, '../../..');
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('Usage: teammate-idle.js <feature-name> [--dry-run] [--verbose]');
+    process.exit(2);
+  }
+
+  const featureName = args[0];
+  const dryRun = args.includes('--dry-run');
+  const verbose = args.includes('--verbose');
+
+  console.log('🔔 TeammateIdle Hook Triggered');
+  console.log(`   Feature: ${featureName}`);
+  console.log(`   Event: Teammate is idle, validating recent work...\n`);
+
+  try {
+    const results = await executeHook(projectPath, featureName, 'TeammateIdle', {
+      dryRun,
+      verbose
+    });
+
+    const output = formatHookResults(results, 'TeammateIdle');
+    console.log(output);
+
+    if (results.blocked) {
+      console.log('\n💡 TIP: Fix the errors above before the teammate can proceed.');
+      process.exit(1);
+    }
+
+    process.exit(0);
+  } catch (err) {
+    console.error(`\n❌ Hook execution error: ${err.message}`);
+    if (verbose) {
+      console.error(err.stack);
+    }
+    process.exit(2);
+  }
+}
+
+main();