@polymorphism-tech/morph-spec 4.8.19 → 4.9.0

package/src/utils/hooks-installer.js

@@ -8,14 +8,14 @@
  * Called by `morph-spec init` and `morph-spec update`.
  */
 
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { readFile, writeFile, mkdir, copyFile } from 'fs/promises';
 import { existsSync, chmodSync, readdirSync } from 'fs';
 import { homedir } from 'os';
 import { execSync } from 'child_process';
 
 /** Current hooks schema version — bump when hook definitions change */
-const HOOKS_VERSION = '2.8.0';
+const HOOKS_VERSION = '2.10.0';
 
 /** Marker for old dispatch.js (v1) */
 const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
@@ -103,11 +103,11 @@ const MORPH_HOOKS = [
     matcher: 'Bash',
     hooks: [{
       type: 'prompt',
-      prompt: `You are a guard for a morph-spec project. Read the bash command from the hook input and check:
-1. Does the command delete .morph/ (e.g. contains "rm" with "-r" or "-rf" and ".morph")? If yes, BLOCK.
-2. Does the command edit state.json directly via sed, jq, awk, echo, cat, or printf with a shell redirect (>)? If yes, BLOCK.
-3. Does the command write to .morph/framework/ via a shell redirect (>)? If yes, BLOCK.
-If any condition is true, respond: {"ok": false, "reason": "MORPH-SPEC: <brief explanation and suggested alternative using morph-spec CLI>"}
+      prompt: `You are a guard for a morph-spec project. Read the bash command from the hook input and check EXACTLY these 3 conditions. IMPORTANT: reading files (cat, head, tail, grep, less, bat) is NEVER blocked regardless of path.
+1. Does the command DELETE .morph/ or .morph/state.json or .morph/framework/ using rm -r, rm -rf, or rmdir? BLOCK only these exact paths. NOTE: deleting .morph/features/ subdirectories is NOT blocked.
+2. Does the command OVERWRITE .morph/state.json using a shell redirect (>) combined with sed, jq, awk, echo, cat, or printf? If yes, BLOCK.
+3. Does the command WRITE TO .morph/framework/ via a shell redirect (>) or Node.js fs.writeFileSync/appendFileSync on a path under .morph/framework/? READING .morph/framework/ is always allowed. Writing to .morph/features/, .morph/config/, .morph/context/ is allowed.
+If ANY of these 3 specific conditions matches, respond: {"ok": false, "reason": "MORPH-SPEC: [explain what was blocked]. To read agents/state use: morph-spec state get <feature> | morph-spec dispatch-agents <feature> <phase> --table | cat .morph/framework/agents.json (reading is always allowed). To update state use: morph-spec state set <feature> <key> <value>."}
 Otherwise respond: {"ok": true}`
     }]
   },
@@ -124,6 +124,14 @@ Otherwise respond: {"ok": true}`
       {
         type: 'command',
         command: 'node framework/hooks/claude-code/post-tool-use/context-refresh.js'
+      },
+      {
+        type: 'command',
+        command: 'node framework/hooks/claude-code/post-tool-use/skill-reminder.js'
+      },
+      {
+        type: 'command',
+        command: 'node framework/hooks/claude-code/post-tool-use/validator-feedback.js'
       }
     ]
   },
@@ -302,7 +310,6 @@ export async function installClaudeHooks(targetPath) {
   return { installed, updated: !alreadyCurrent };
 }
 
-/**
 /**
  * Resolve Python executable suitable for the statusLine command.
  *
@@ -398,6 +405,249 @@ export async function installGlobalStatusline(hooksSourceDir, globalClaudeDirOve
   return { installed: true, globalDir };
 }
 
+/**
+ * Install VS Code terminal settings to enable OSC title sequences.
+ *
+ * Sets `terminal.integrated.tabs.title` to include `${sequence}` so VS Code
+ * renders OSC 0 escape sequences written by the set-terminal-title hook.
+ *
+ * Idempotent — only writes if the setting is missing or doesn't already
+ * include `${sequence}`.
+ *
+ * @param {string} [homeDirOverride] - Override home directory (for testing)
+ * @returns {Promise<{ updated: boolean, path: string|null, alreadySet: boolean }>}
+ */
+export async function installVSCodeTerminalSettings(homeDirOverride = null) {
+  const home = homeDirOverride || homedir();
+
+  let settingsPath;
+  if (process.platform === 'win32') {
+    settingsPath = join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json');
+  } else if (process.platform === 'darwin') {
+    settingsPath = join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json');
+  } else {
+    settingsPath = join(home, '.config', 'Code', 'User', 'settings.json');
+  }
+
+  if (!existsSync(settingsPath)) {
+    return { updated: false, path: settingsPath, alreadySet: false };
+  }
+
+  let settings;
+  try {
+    settings = JSON.parse(await readFile(settingsPath, 'utf-8'));
+  } catch {
+    settings = {};
+  }
+
+  const KEY = 'terminal.integrated.tabs.title';
+  const current = settings[KEY] || '';
+  if (current.includes('${sequence}')) {
+    return { updated: false, path: settingsPath, alreadySet: true };
+  }
+
+  settings[KEY] = '${sequence}${separator}${local}';
+  await writeFile(settingsPath, JSON.stringify(settings, null, 4) + '\n', 'utf-8');
+  return { updated: true, path: settingsPath, alreadySet: false };
+}
+
+/**
+ * Install shell integration for Claude Code terminal title.
+ *
+ * Writes a wrapper function to the user's shell profile that:
+ * 1. Starts a background job watching ~/.claude/terminal_title
+ * 2. Updates the terminal tab title in real time via Console.Title (PS) / OSC 0 (bash)
+ * 3. Resets the title when the `claude` command exits
+ *
+ * On Windows: installs to PowerShell 5.1 and/or PowerShell 7 profiles.
+ * On Linux/macOS: installs to ~/.bashrc and/or ~/.zshrc (if they exist).
+ *
+ * Idempotent — skips if the integration block is already present.
+ *
+ * @param {string} [homeDirOverride] - Override home directory (for testing)
+ * @returns {Promise<{ installed: string[], skipped: string[], errors: string[] }>}
+ */
+export async function installShellIntegration(homeDirOverride = null) {
+  const home = homeDirOverride || homedir();
+  const installed = [];
+  const skipped = [];
+  const errors = [];
+
+  if (process.platform === 'win32') {
+    const profiles = [
+      join(home, 'Documents', 'WindowsPowerShell', 'Microsoft.PowerShell_profile.ps1'),
+      join(home, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1'),
+    ];
+    for (const profilePath of profiles) {
+      try {
+        const result = await _appendShellBlock(profilePath, _buildPowerShellBlock(), _psAlreadyInstalled);
+        if (result === 'installed') installed.push(profilePath);
+        else skipped.push(profilePath);
+      } catch (err) {
+        errors.push(profilePath + ': ' + err.message);
+      }
+    }
+  } else {
+    const bashBlock = _buildBashBlock();
+    for (const profilePath of [join(home, '.bashrc'), join(home, '.zshrc')]) {
+      if (!existsSync(profilePath)) continue;
+      try {
+        const result = await _appendShellBlock(profilePath, bashBlock, _bashAlreadyInstalled);
+        if (result === 'installed') installed.push(profilePath);
+        else skipped.push(profilePath);
+      } catch (err) {
+        errors.push(profilePath + ': ' + err.message);
+      }
+    }
+  }
+
+  return { installed, skipped, errors };
+}
+
+/** @returns {string} PowerShell integration block */
+function _buildPowerShellBlock() {
+  return [
+    '',
+    '# === Claude Code terminal title integration (morph-spec) ===',
+    '# Per-session title file prevents cross-session title contamination.',
+    '$script:_claudeExe = Get-Command claude -CommandType Application -ErrorAction SilentlyContinue |',
+    '    Select-Object -First 1 -ExpandProperty Source',
+    '',
+    'function _Start-ClaudeTitleWatcher {',
+    '    param([string]$TitleFile)',
+    '    $rs = [runspacefactory]::CreateRunspace()',
+    '    $rs.Open()',
+    '    $ps = [powershell]::Create()',
+    '    $ps.Runspace = $rs',
+    '    [void]$ps.AddScript({',
+    '        param($f)',
+    '        $last = ""',
+    '        while ($true) {',
+    '            if (Test-Path $f) {',
+    '                try {',
+    '                    $t = (Get-Content $f -Raw -ErrorAction Stop).Trim()',
+    '                    if ($t -and $t -ne $last) {',
+    '                        [Console]::Title = $t',
+    '                        $last = $t',
+    '                    }',
+    '                } catch {}',
+    '            }',
+    '            Start-Sleep -Milliseconds 500',
+    '        }',
+    '    }).AddArgument($TitleFile)',
+    '    $ps.BeginInvoke() | Out-Null',
+    '    return $ps',
+    '}',
+    '',
+    'function Invoke-Claude {',
+    '    [CmdletBinding()]',
+    '    param([Parameter(ValueFromRemainingArguments=$true)][string[]]$Arguments)',
+    '    if (-not $script:_claudeExe) { Write-Error "claude executable not found in PATH"; return }',
+    '    # Per-session file: each Invoke-Claude gets its own title file so multiple',
+    '    # open terminals don\'t overwrite each other\'s titles.',
+    '    $sessionTitleFile = Join-Path $HOME ".claude\\terminal_title_$(New-Guid)"',
+    '    $env:MORPH_TERMINAL_TITLE_FILE = $sessionTitleFile',
+    '    $watcher = _Start-ClaudeTitleWatcher -TitleFile $sessionTitleFile',
+    '    try {',
+    '        & $script:_claudeExe @Arguments',
+    '    } finally {',
+    '        try { $watcher.Stop(); $watcher.Dispose() } catch {}',
+    '        $env:MORPH_TERMINAL_TITLE_FILE = $null',
+    '        Remove-Item $sessionTitleFile -ErrorAction SilentlyContinue',
+    '        [Console]::Title = "PowerShell"',
+    '    }',
+    '}',
+    'Set-Alias -Name claude -Value Invoke-Claude -Force',
+    '# === End Claude Code terminal title integration (morph-spec) ===',
+  ].join('\n');
+}
+
+/** @returns {string} Bash/Zsh integration block */
+function _buildBashBlock() {
+  return [
+    '',
+    '# === Claude Code terminal title integration (morph-spec) ===',
+    '# Per-session title file prevents cross-session title contamination.',
+    '_claude_title_watcher() {',
+    '  local title_file="$1"',
+    '  local last_title=""',
+    '  while true; do',
+    '    if [ -f "$title_file" ]; then',
+    '      local current',
+    '      current=$(cat "$title_file" 2>/dev/null)',
+    '      if [ -n "$current" ] && [ "$current" != "$last_title" ]; then',
+    "        printf '\\e]0;%s\\a' \"$current\"",
+    '        last_title="$current"',
+    '      fi',
+    '    fi',
+    '    sleep 0.5',
+    '  done',
+    '}',
+    '',
+    'claude() {',
+    '  # Per-session file: each invocation gets its own title file so multiple',
+    '  # open terminals don\'t overwrite each other\'s titles.',
+    '  local SESSION_TITLE_FILE',
+    '  SESSION_TITLE_FILE="$HOME/.claude/terminal_title_$$_$RANDOM"',
+    '  export MORPH_TERMINAL_TITLE_FILE="$SESSION_TITLE_FILE"',
+    '  _claude_title_watcher "$SESSION_TITLE_FILE" &',
+    '  local WATCHER_PID=$!',
+    '  command claude "$@"',
+    '  local EXIT_CODE=$?',
+    '  kill "$WATCHER_PID" 2>/dev/null',
+    '  wait "$WATCHER_PID" 2>/dev/null',
+    '  unset MORPH_TERMINAL_TITLE_FILE',
+    '  rm -f "$SESSION_TITLE_FILE"',
+    "  printf '\\e]0;claude\\a'",
+    '  return $EXIT_CODE',
+    '}',
+    '# === End Claude Code terminal title integration (morph-spec) ===',
+  ].join('\n');
+}
+
+/** Check if PowerShell profile already has the integration */
+function _psAlreadyInstalled(content) {
+  return content.includes('Invoke-Claude') || content.includes('_Start-ClaudeTitleWatcher');
+}
+
+/** Check if bash/zsh profile already has the integration */
+function _bashAlreadyInstalled(content) {
+  return content.includes('_claude_title_watcher') || content.includes('command claude "$@"');
+}
+
+/**
+ * Append a shell block to a profile file if not already present.
+ * Creates the file (and parent dirs) if it doesn't exist.
+ * @param {string} profilePath
+ * @param {string} block
+ * @param {(content: string) => boolean} isInstalled
+ * @returns {Promise<'installed'|'skipped'>}
+ */
+async function _appendShellBlock(profilePath, block, isInstalled) {
+  let existing = '';
+  let isUtf16le = false;
+
+  if (existsSync(profilePath)) {
+    const raw = await readFile(profilePath);
+    // Detect UTF-16LE: starts with FF FE BOM or has null bytes in the first bytes
+    isUtf16le = (raw[0] === 0xFF && raw[1] === 0xFE) ||
+                (raw.length >= 4 && raw[1] === 0 && raw[3] === 0);
+    existing = isUtf16le ? raw.toString('utf16le').replace(/^\uFEFF/, '') : raw.toString('utf-8');
+  }
+
+  if (isInstalled(existing)) return 'skipped';
+
+  const dir = dirname(profilePath);
+  if (!existsSync(dir)) {
+    await mkdir(dir, { recursive: true });
+  }
+
+  // Always write as UTF-8; trim trailing whitespace from UTF-16LE-decoded content
+  const base = isUtf16le ? existing.trimEnd() + '\n' : existing;
+  await writeFile(profilePath, base + block + '\n', 'utf-8');
+  return 'installed';
+}
+
 /**
  * Remove old v1 agent-teams/dispatch.js hook entries.
  * @param {Object} settings

package/framework/hooks/dev/check-sync-health.js

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev Stop Hook: Sync Health Check (Advisory)
- *
- * Event: Stop
- * Scope: Framework codebase only (dev hook)
- *
- * When Claude stops, checks for out-of-sync conditions:
- *   1. Templates not in REGISTRY.json
- *   2. Standards not in STANDARDS.json
- *
- * Uses readdirSync (no git dependency, fast).
- * Returns advisory context if out-of-sync items found.
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readdirSync, readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { injectContext, pass } from '../shared/hook-response.js';
-
-/**
- * Recursively collect .md files from a directory.
- * @param {string} dir - Directory to scan
- * @param {string} [base] - Base path for relative paths
- * @returns {string[]} Relative paths
- */
-function collectMdFiles(dir, base) {
-  base = base || dir;
-  const results = [];
-  if (!existsSync(dir)) return results;
-
-  try {
-    const entries = readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const fullPath = join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (entry.name === 'node_modules') continue;
-        results.push(...collectMdFiles(fullPath, base));
-      } else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {
-        const rel = fullPath.replace(base + '/', '').replace(base + '\\', '').replace(/\\/g, '/');
-        results.push(rel);
-      }
-    }
-  } catch {
-    // Fail-open
-  }
-
-  return results;
-}
-
-try {
-  // Prevent infinite loop
-  if (process.env.MORPH_STOP_HOOK_ACTIVE === '1') pass();
-
-  const warnings = [];
-
-  // Check templates vs REGISTRY.json
-  const registryPath = 'framework/templates/REGISTRY.json';
-  if (existsSync(registryPath)) {
-    try {
-      const registry = JSON.parse(readFileSync(registryPath, 'utf-8'));
-      const registeredPaths = new Set((registry.templates || []).map(t => t.path));
-      const templateFiles = collectMdFiles('framework/templates');
-
-      const unregistered = templateFiles.filter(f => !registeredPaths.has(f));
-      if (unregistered.length > 0) {
-        warnings.push(`Templates not in REGISTRY.json (${unregistered.length}):`);
-        for (const f of unregistered.slice(0, 5)) {
-          warnings.push(`  - ${f}`);
-        }
-        if (unregistered.length > 5) {
-          warnings.push(`  ... and ${unregistered.length - 5} more`);
-        }
-      }
-    } catch {
-      // Skip on error
-    }
-  }
-
-  // Check standards vs STANDARDS.json
-  const standardsPath = 'framework/standards/STANDARDS.json';
-  if (existsSync(standardsPath)) {
-    try {
-      const registry = JSON.parse(readFileSync(standardsPath, 'utf-8'));
-      const registeredPaths = new Set((registry.standards || []).map(s => s.path));
-      const standardFiles = collectMdFiles('framework/standards');
-
-      const unregistered = standardFiles.filter(f => !registeredPaths.has(f));
-      if (unregistered.length > 0) {
-        warnings.push(`Standards not in STANDARDS.json (${unregistered.length}):`);
-        for (const f of unregistered.slice(0, 5)) {
-          warnings.push(`  - ${f}`);
-        }
-        if (unregistered.length > 5) {
-          warnings.push(`  ... and ${unregistered.length - 5} more`);
-        }
-        warnings.push('  Run: node scripts/generate-standards-registry.js');
-      }
-    } catch {
-      // Skip on error
-    }
-  }
-
-  if (warnings.length === 0) pass();
-
-  const message = [
-    'MORPH-SPEC Dev: Out-of-sync items detected:',
-    ...warnings.map(w => `  ${w}`),
-  ].join('\n');
-
-  injectContext(message);
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/hooks/dev/guard-version-numbers.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev PreToolUse Hook: Guard Version Numbers
- *
- * Event: PreToolUse | Matcher: Write|Edit
- * Scope: Framework codebase only (dev hook)
- *
- * Blocks Write/Edit to files that contain hardcoded version patterns
- * like "MORPH-SPEC v4.8.12". Version should only be in package.json.
- *
- * Checked extensions: .md, .cs, .css, .js (covers templates + source)
- * Exceptions: CHANGELOG.md, node_modules/, test/, package.json, package-lock.json
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readStdin } from '../shared/stdin-reader.js';
-import { getFilePath, getContentToValidate } from '../shared/payload-utils.js';
-import { block, pass } from '../shared/hook-response.js';
-
-const VERSION_PATTERN = /MORPH-SPEC\s+v\d+\.\d+\.\d+/;
-const CHECKED_EXTENSIONS = ['.md', '.cs', '.css', '.js', '.html', '.txt'];
-
-try {
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = getFilePath(payload);
-  if (!filePath) pass();
-
-  // Only check relevant file types
-  if (!CHECKED_EXTENSIONS.some(ext => filePath.endsWith(ext))) pass();
-
-  // Exceptions
-  if (filePath.includes('node_modules/')) pass();
-  if (filePath.endsWith('CHANGELOG.md')) pass();
-  if (filePath.includes('test/')) pass();
-  if (filePath.endsWith('package.json')) pass();
-  if (filePath.endsWith('package-lock.json')) pass();
-
-  const content = getContentToValidate(payload);
-  if (!content) pass();
-
-  if (VERSION_PATTERN.test(content)) {
-    block(
-      `MORPH-SPEC: Hardcoded version number detected in '${filePath}'.\n` +
-      `Version should only be in package.json. Use 'MORPH-SPEC by Polymorphism Tech' without version.\n` +
-      `Pattern found: ${content.match(VERSION_PATTERN)?.[0]}`
-    );
-  }
-
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/hooks/dev/sync-standards-registry.js

@@ -1,60 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev PostToolUse Hook: Standards Registry Sync Advisory
- *
- * Event: PostToolUse | Matcher: Write
- * Scope: Framework codebase only (dev hook)
- *
- * After a Write to framework/standards/**/*.md, checks if the file
- * is registered in framework/standards/STANDARDS.json.
- * If not, injects an advisory to regenerate the registry.
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { readStdin } from '../shared/stdin-reader.js';
-import { getFilePath } from '../shared/payload-utils.js';
-import { approve, pass } from '../shared/hook-response.js';
-
-try {
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = getFilePath(payload);
-  if (!filePath) pass();
-
-  // Only check framework/standards/**/*.md
-  if (!filePath.includes('framework/standards/')) pass();
-  if (!filePath.endsWith('.md')) pass();
-
-  // Skip meta files
-  const basename = filePath.split('/').pop();
-  if (basename === 'README.md') pass();
-  if (basename === 'STANDARDS.json') pass();
-
-  // Extract relative path from framework/standards/
-  const standardsIdx = filePath.indexOf('framework/standards/');
-  if (standardsIdx === -1) pass();
-  const relativePath = filePath.slice(standardsIdx + 'framework/standards/'.length);
-
-  // Read STANDARDS.json
-  const registryPath = 'framework/standards/STANDARDS.json';
-  if (!existsSync(registryPath)) pass();
-
-  const registry = JSON.parse(readFileSync(registryPath, 'utf-8'));
-  const registeredPaths = (registry.standards || []).map(s => s.path);
-
-  if (!registeredPaths.includes(relativePath)) {
-    approve(
-      `MORPH-SPEC: Standard '${relativePath}' is not in STANDARDS.json.\n` +
-      `Run: node scripts/generate-standards-registry.js`
-    );
-  }
-
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/hooks/dev/sync-template-registry.js

@@ -1,60 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev PostToolUse Hook: Template Registry Sync Advisory
- *
- * Event: PostToolUse | Matcher: Write
- * Scope: Framework codebase only (dev hook)
- *
- * After a Write to framework/templates/**/*.md, checks if the file
- * is registered in framework/templates/REGISTRY.json.
- * If not, injects an advisory to add the entry.
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { readStdin } from '../shared/stdin-reader.js';
-import { getFilePath } from '../shared/payload-utils.js';
-import { approve, pass } from '../shared/hook-response.js';
-
-try {
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = getFilePath(payload);
-  if (!filePath) pass();
-
-  // Only check framework/templates/**/*.md
-  if (!filePath.includes('framework/templates/')) pass();
-  if (!filePath.endsWith('.md')) pass();
-
-  // Skip meta files
-  const basename = filePath.split('/').pop();
-  if (basename === 'README.md') pass();
-  if (basename === 'REGISTRY.json') pass();
-
-  // Extract relative path from framework/templates/
-  const templateIdx = filePath.indexOf('framework/templates/');
-  if (templateIdx === -1) pass();
-  const relativePath = filePath.slice(templateIdx + 'framework/templates/'.length);
-
-  // Read REGISTRY.json
-  const registryPath = 'framework/templates/REGISTRY.json';
-  if (!existsSync(registryPath)) pass();
-
-  const registry = JSON.parse(readFileSync(registryPath, 'utf-8'));
-  const registeredPaths = (registry.templates || []).map(t => t.path);
-
-  if (!registeredPaths.includes(relativePath)) {
-    approve(
-      `MORPH-SPEC: Template '${relativePath}' is not in REGISTRY.json.\n` +
-      `Add an entry to framework/templates/REGISTRY.json with id, path, phase, and outputName fields.`
-    );
-  }
-
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}

package/framework/hooks/dev/validate-skill-format.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dev PreToolUse Hook: Validate Skill Frontmatter Format
- *
- * Event: PreToolUse | Matcher: Write|Edit
- * Scope: Framework codebase only (dev hook)
- *
- * Validates that SKILL.md files written to framework/skills/ have valid
- * YAML frontmatter with required `name:` and `description:` fields.
- *
- * Only validates on Write (full content). Edit operations pass through.
- * Simple regex parsing (no YAML library dependency).
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readStdin } from '../shared/stdin-reader.js';
-import { getFilePath, getContentToValidate, isWriteOperation } from '../shared/payload-utils.js';
-import { block, pass } from '../shared/hook-response.js';
-
-try {
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = getFilePath(payload);
-  if (!filePath) pass();
-
-  // Only check framework/skills/**/SKILL.md
-  if (!filePath.includes('framework/skills/')) pass();
-  if (!filePath.endsWith('SKILL.md')) pass();
-
-  // Only validate full Write operations (not Edit patches)
-  if (!isWriteOperation(payload)) pass();
-
-  const content = getContentToValidate(payload);
-  if (!content) pass();
-
-  // Check for YAML frontmatter delimiters
-  const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!frontmatterMatch) {
-    block(
-      `MORPH-SPEC: SKILL.md at '${filePath}' is missing YAML frontmatter.\n` +
-      'All skill files must start with --- delimited YAML frontmatter containing name: and description: fields.'
-    );
-  }
-
-  const frontmatter = frontmatterMatch[1];
-  const missing = [];
-
-  if (!/^name:/m.test(frontmatter)) {
-    missing.push('name:');
-  }
-  if (!/^description:/m.test(frontmatter)) {
-    missing.push('description:');
-  }
-
-  if (missing.length > 0) {
-    block(
-      `MORPH-SPEC: SKILL.md at '${filePath}' is missing required frontmatter fields:\n` +
-      missing.map(m => `  - ${m}`).join('\n') + '\n\n' +
-      'All skill files must have name: and description: in their YAML frontmatter.'
-    );
-  }
-
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}