@polymorphism-tech/morph-spec 3.1.0 → 4.2.0

package/stacks/blazor-azure/.morph/hooks/README.md

@@ -1,348 +0,0 @@
-# MORPH-SPEC Git Hooks
-
-Pre-commit hooks for automatic validation before committing.
-
-## Available Hooks
-
-| Hook | Description | Action |
-|------|-------------|--------|
-| `pre-commit-agents.sh` | Validates agents.json with JSON Schema | ❌ Blocks commit |
-| `pre-commit-specs.sh` | Validates spec.md has required sections | ❌ Blocks commit |
-| `pre-commit-tests.sh` | Checks if new code has tests | ⚠️ Warns only |
-| `pre-commit-all.sh` | Runs all hooks in sequence | ❌ Blocks if any fail |
-
-## Installation
-
-### Option 1: Install Individual Hooks
-
-```bash
-# Symlink all hooks at once
-ln -s ../../.morph/hooks/pre-commit-all.sh .git/hooks/pre-commit
-```
-
-### Option 2: Copy Hooks
-
-```bash
-# Copy master hook
-cp .morph/hooks/pre-commit-all.sh .git/hooks/pre-commit
-chmod +x .git/hooks/pre-commit
-```
-
-### Option 3: Use Existing Hooks
-
-If you already have `.git/hooks/pre-commit`, add this to the end:
-
-```bash
-# Run MORPH-SPEC validations
-bash .morph/hooks/pre-commit-all.sh || exit 1
-```
-
-## What Each Hook Does
-
-### pre-commit-agents.sh
-
-**Validates:** `agents.json` configuration
-
-**Checks:**
-- JSON Schema compliance
-- Required fields (id, name, emoji, type, etc.)
-- Keyword patterns (alphanumeric + hyphens/underscores)
-- No duplicate keywords
-- autoActivation for specialist agents
-
-**Example Output:**
-```
-🤖 Validating agent configuration...
-Detected changes to agents.json
-
-=== MORPH-SPEC Agent Validator ===
-
-Version: 1.0.0
-Core Agents: 6
-Specialist Agents: 4
-
-✓ Validation PASSED
-```
-
-### pre-commit-specs.sh
-
-**Validates:** `spec.md` files have required sections
-
-**Checks:**
-- `## 📋 Metadata`
-- `## 🎯 Overview`
-- `## 🏗️ Technical Design`
-- `## ✅ Acceptance Criteria`
-- Warns if no user stories found
-
-**Example Output:**
-```
-🔍 Validating spec files...
-Checking: .morph/outputs/my-feature/spec.md
-  ✓ All required sections found
-✓ All spec files are valid
-```
-
-### pre-commit-tests.sh
-
-**Validates:** New C# code has corresponding tests
-
-**Checks:**
-- Finds modified `.cs` files (excluding tests)
-- Looks for `*Tests.cs` or `Test*.cs`
-- Skips trivial files (DTOs, records, models)
-- **Warns only, doesn't block**
-
-**Example Output:**
-```
-🧪 Checking test coverage...
-  ✓ Test found for: Services/UserService.cs
-  ⚠️  No test found for: Services/PaymentService.cs
-
-⚠️  WARNING: Some files don't have tests
-   Override with: git commit --no-verify
-```
-
-### pre-commit-all.sh (Master Hook)
-
-**Runs:** All hooks in sequence
-
-**Output:**
-```
-╔════════════════════════════════════════════════╗
-║     MORPH-SPEC PRE-COMMIT VALIDATION           ║
-╚════════════════════════════════════════════════╝
-
-─────────────────────────────────────────────────
-🤖 Validating agent configuration...
-✓ No changes to agents.json
-
-─────────────────────────────────────────────────
-🔍 Validating spec files...
-✓ No spec files modified
-
-─────────────────────────────────────────────────
-🧪 Checking test coverage...
-  ✓ Test found for: Services/UserService.cs
-
-═════════════════════════════════════════════════
-✅ ALL PRE-COMMIT VALIDATIONS PASSED
-```
-
-## Bypassing Hooks
-
-If you need to commit without validation (e.g., WIP commit):
-
-```bash
-git commit --no-verify -m "WIP: work in progress"
-```
-
-**⚠️ Use sparingly** - hooks exist to prevent errors.
-
-## Customizing Hooks
-
-### Disable Specific Hooks
-
-Edit `.git/hooks/pre-commit` and comment out unwanted hooks:
-
-```bash
-HOOKS=(
-  "pre-commit-agents.sh"
-  "pre-commit-specs.sh"
-  "pre-commit-tests.sh"
-)
-```
-
-## Troubleshooting
-
-### Hook Not Running
-
-```bash
-# Check if hook exists
-ls -la .git/hooks/pre-commit
-
-# Check if executable
-chmod +x .git/hooks/pre-commit
-
-# Test manually
-bash .git/hooks/pre-commit
-```
-
-### Hook Fails Unexpectedly
-
-```bash
-# Run individual hook for debugging
-bash .morph/hooks/pre-commit-costs.sh
-
-# Check hook output
-bash -x .morph/hooks/pre-commit-costs.sh
-```
-
-## Benefits
-
-- ✅ **Prevents Errors:** Catches issues before commit
-- ✅ **Enforces Quality:** Requires tests, specs, ADRs
-- ✅ **Fast Feedback:** Fails early in dev workflow
-- ✅ **Consistent:** Same validation for entire team
-
----
-
-## Agent Teams Hooks (Claude Code)
-
-**New in MORPH 3.0:** Hooks for Claude Code's experimental Agent Teams feature.
-
-### Available Agent Teams Hooks
-
-| Hook | Event | Description | Action |
-|------|-------|-------------|--------|
-| `teammate-idle.js` | TeammateIdle | Validates teammate's work before proceeding | ❌ Blocks if errors |
-| `task-completed.js` | TaskCompleted | Validates task deliverables on completion | ❌ Blocks if errors |
-
-### teammate-idle.js
-
-**Triggered:** When a teammate in Agent Teams is idle and waiting for instructions
-**Purpose:** Quality gate to validate recent work before allowing teammate to proceed
-**Validates:** Security, code quality, standards compliance
-
-**Usage:**
-```bash
-node .morph/hooks/teammate-idle.js <feature-name> [--dry-run] [--verbose]
-```
-
-**Example:**
-```bash
-node .morph/hooks/teammate-idle.js user-authentication --verbose
-```
-
-**Output:**
-```
-🔔 TeammateIdle Hook Triggered
-   Feature: user-authentication
-   Event: Teammate is idle, validating recent work...
-
-🎯 Executing TeammateIdle hook for feature: user-authentication
-   Validators: security-expert
-
-🔍 Running security-expert validators...
-
-✅ TeammateIdle hook: All validators passed
-```
-
-**Configuration:**
-
-Validators are configured in `agents.json` for Tier 4 agents:
-
-```json
-{
-  "security-expert": {
-    "tier": 4,
-    "role": "validator",
-    "relationships": {
-      "runs_in": "hooks",
-      "hook_triggers": ["TeammateIdle", "TaskCompleted"]
-    },
-    "hook_behavior": {
-      "validates": [
-        "SQL injection (string concatenation in queries)",
-        "Hardcoded secrets (API keys, passwords, connection strings)",
-        "XSS (@Html.Raw usage in Razor/Blazor)"
-      ],
-      "severity": "error",
-      "blocks_on_fail": true
-    }
-  }
-}
-```
-
-### task-completed.js
-
-**Triggered:** When a task is marked as completed
-**Purpose:** Quality gate to validate task deliverables before marking done
-**Validates:** All active validators for the feature
-
-**Usage:**
-```bash
-node .morph/hooks/task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]
-```
-
-**Example:**
-```bash
-node .morph/hooks/task-completed.js user-authentication T003 --verbose
-```
-
-**Output:**
-```
-🔔 TaskCompleted Hook Triggered
-   Feature: user-authentication
-   Task: T003
-   Event: Task marked complete, validating deliverables...
-
-🎯 Executing TaskCompleted hook for feature: user-authentication
-   Validators: security-expert
-
-🔍 Running security-expert validators...
-
-❌ TaskCompleted hook: Validation FAILED
-
-🚫 ERRORS (blocking):
-   security-expert → security
-      • Hardcoded secret detected: API key in appsettings.json (appsettings.json:15)
-      • SQL injection risk: String concatenation in UserService.cs (UserService.cs:42)
-
-⛔ Hook execution BLOCKED - fix errors before proceeding
-
-💡 TIP: Fix the errors above before the task can be marked complete.
-```
-
-### Integration with Claude Code
-
-When Agent Teams is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), these hooks run automatically:
-
-1. **TeammateIdle**: When a teammate finishes work and waits
-2. **TaskCompleted**: When `morph-spec task done` is called
-
-**Claude Code Settings:**
-```json
-{
-  "hooks": {
-    "TeammateIdle": "node .morph/hooks/teammate-idle.js {feature}",
-    "TaskCompleted": "node .morph/hooks/task-completed.js {feature} {taskId}"
-  }
-}
-```
-
-### Dry Run Mode
-
-Test hooks without blocking:
-
-```bash
-# See what would run without executing
-node .morph/hooks/teammate-idle.js my-feature --dry-run
-
-# Output:
-# 🔍 DRY RUN - Would execute:
-#    - security-expert (severity: error)
-#      • SQL injection (string concatenation in queries)
-#      • Hardcoded secrets (API keys, passwords, connection strings)
-#      • XSS (@Html.Raw usage in Razor/Blazor)
-```
-
-### Hook Behavior Configuration
-
-| Field | Description | Values |
-|-------|-------------|--------|
-| `validates` | Array of validation checks | Descriptive strings |
-| `severity` | Error level | `"error"` (blocks) \| `"warning"` (warns only) |
-| `blocks_on_fail` | Block on failure | `true` (default) \| `false` |
-
-### Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | All validators passed |
-| 1 | Validation failed and blocked |
-| 2 | Configuration error (missing feature, etc.) |
-
----
-
-*MORPH-SPEC Framework - Git Hooks*

package/stacks/blazor-azure/.morph/hooks/pre-commit-agents.sh

@@ -1,24 +0,0 @@
-#!/bin/bash
-# MORPH-SPEC Pre-Commit Hook: Agent Configuration Validation
-# Uses validate-agents.js to check agents.json
-
-echo "🤖 Validating agent configuration..."
-
-# Check if agents.json is being modified
-if git diff --cached --name-only | grep -q 'agents\.json$'; then
-  echo "Detected changes to agents.json"
-
-  # Run validator
-  if ! npx morph-spec validate-agents-skills; then
-    echo ""
-    echo "❌ COMMIT BLOCKED: agents.json validation failed"
-    echo "   Fix errors above before committing"
-    exit 1
-  fi
-
-  echo "✓ agents.json is valid"
-else
-  echo "✓ No changes to agents.json"
-fi
-
-exit 0

package/stacks/blazor-azure/.morph/hooks/pre-commit-all.sh

@@ -1,48 +0,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/stacks/blazor-azure/.morph/hooks/pre-commit-specs.sh

@@ -1,49 +0,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/stacks/blazor-azure/.morph/hooks/task-completed.js

@@ -1,73 +0,0 @@
-#!/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/stacks/blazor-azure/.morph/hooks/teammate-idle.js

@@ -1,68 +0,0 @@
-#!/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();