claude-prism 1.2.7 → 1.4.0

package/lib/handoff.mjs

@@ -0,0 +1,204 @@
+/**
+ * claude-prism — HANDOFF.md Generation
+ * Shared logic for auto-generating session handoff documents
+ */
+
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+/**
+ * Generate HANDOFF.md content from current project state
+ * @param {string} projectRoot - Project root directory
+ * @returns {string} Markdown content for HANDOFF.md
+ */
+export function generateHandoff(projectRoot) {
+  const sections = [];
+  sections.push('# HANDOFF — Session Transition Document\n');
+  sections.push(`> Auto-generated by claude-prism at ${new Date().toISOString()}\n`);
+
+  // 1. Plan progress
+  const planInfo = getActivePlanInfo(projectRoot);
+  sections.push('## Status\n');
+  if (planInfo) {
+    const { total, done, planName } = planInfo;
+    const pct = total > 0 ? Math.round((done / total) * 100) : 0;
+    sections.push(`- Active plan: \`${planName}\``);
+    sections.push(`- Progress: ${done}/${total} tasks (${pct}%)`);
+    if (planInfo.nextBatch) {
+      sections.push(`- Next batch: ${planInfo.nextBatch}`);
+    }
+  } else {
+    sections.push('- No active plan file found');
+  }
+
+  // 2. Current git state
+  sections.push('\n## Current State\n');
+  const gitInfo = getGitInfo(projectRoot);
+  sections.push(`- Branch: \`${gitInfo.branch}\``);
+  if (gitInfo.uncommitted > 0) {
+    sections.push(`- Uncommitted changes: ${gitInfo.uncommitted} file(s)`);
+  } else {
+    sections.push('- Working tree clean');
+  }
+  if (gitInfo.recentCommits.length > 0) {
+    sections.push('\nRecent commits:');
+    for (const commit of gitInfo.recentCommits) {
+      sections.push(`- ${commit}`);
+    }
+  }
+
+  // 3. Next steps (derived from plan)
+  sections.push('\n## Next Steps\n');
+  if (planInfo && planInfo.nextTasks.length > 0) {
+    for (const task of planInfo.nextTasks) {
+      sections.push(`- [ ] ${task}`);
+    }
+  } else {
+    sections.push('- Review current state and determine next action');
+  }
+
+  // 4. Decisions placeholder
+  sections.push('\n## Decisions Made\n');
+  sections.push('- (Populated by session context — review plan file for architectural decisions)');
+
+  // 5. Known issues
+  sections.push('\n## Known Issues\n');
+  sections.push('- (None auto-detected — review test results and build output)');
+
+  return sections.join('\n') + '\n';
+}
+
+/**
+ * Read active plan file and extract progress info
+ */
+export function getActivePlanInfo(projectRoot) {
+  const plansDir = join(projectRoot, '.prism', 'plans');
+  if (!existsSync(plansDir)) return null;
+
+  const planFiles = readdirSync(plansDir)
+    .filter(f => f.endsWith('.md'))
+    .sort()
+    .reverse();
+
+  if (planFiles.length === 0) return null;
+
+  const planName = planFiles[0];
+  const content = readFileSync(join(plansDir, planName), 'utf8');
+
+  return parsePlanContent(content, planName);
+}
+
+/**
+ * Parse plan markdown content for progress info
+ * @param {string} content - Plan file content
+ * @param {string} planName - Plan filename
+ * @returns {{ planName, total, done, nextBatch, nextTasks, currentBatchFiles }}
+ */
+export function parsePlanContent(content, planName) {
+  const lines = content.split('\n');
+  let total = 0;
+  let done = 0;
+  let nextBatch = null;
+  const nextTasks = [];
+  let currentBatchFiles = [];
+  let inUnfinishedBatch = false;
+  let currentBatchName = '';
+
+  for (const line of lines) {
+    const checkboxMatch = line.match(/^[-*]\s+\[([ x])\]\s+(.+)/);
+    if (checkboxMatch) {
+      total++;
+      if (checkboxMatch[1] === 'x') {
+        done++;
+      } else {
+        if (!inUnfinishedBatch) {
+          // First unfinished task — we're in the current batch
+          inUnfinishedBatch = true;
+        }
+        if (nextTasks.length < 5) {
+          nextTasks.push(checkboxMatch[2]);
+        }
+      }
+    }
+
+    // Detect batch headers
+    const batchMatch = line.match(/^#{1,3}\s+Batch\s+\d+[:\s]*(.+)?/i);
+    if (batchMatch) {
+      if (!nextBatch && inUnfinishedBatch) {
+        // Already past it
+      } else if (!nextBatch) {
+        // Check if there are unchecked items below
+      }
+      currentBatchName = batchMatch[0];
+    }
+
+    // Track file references in current batch
+    if (inUnfinishedBatch) {
+      const fileMatch = line.match(/`([^`]+\.\w+)`/);
+      if (fileMatch && fileMatch[1].includes('/')) {
+        currentBatchFiles.push(fileMatch[1]);
+      }
+    }
+  }
+
+  // Find the first batch with uncompleted items
+  let batchDone = 0;
+  let batchTotal = 0;
+  let foundFirstUncompleted = false;
+  for (const line of lines) {
+    const batchMatch = line.match(/^#{1,3}\s+(Batch\s+\d+[:\s]*.+)/i);
+    if (batchMatch) {
+      if (batchTotal > 0 && batchDone < batchTotal && !foundFirstUncompleted) {
+        nextBatch = currentBatchName;
+        foundFirstUncompleted = true;
+      }
+      currentBatchName = batchMatch[1];
+      batchDone = 0;
+      batchTotal = 0;
+    }
+    const cb = line.match(/^[-*]\s+\[([ x])\]/);
+    if (cb) {
+      batchTotal++;
+      if (cb[1] === 'x') batchDone++;
+    }
+  }
+  if (!foundFirstUncompleted && batchTotal > 0 && batchDone < batchTotal) {
+    nextBatch = currentBatchName;
+  }
+
+  return { planName, total, done, nextBatch, nextTasks, currentBatchFiles };
+}
+
+/**
+ * Get git status info
+ */
+function getGitInfo(projectRoot) {
+  const info = { branch: 'unknown', uncommitted: 0, recentCommits: [] };
+
+  try {
+    info.branch = execSync('git rev-parse --abbrev-ref HEAD', {
+      cwd: projectRoot, encoding: 'utf8', timeout: 5000
+    }).trim();
+  } catch { /* not a git repo */ }
+
+  try {
+    const status = execSync('git status --porcelain', {
+      cwd: projectRoot, encoding: 'utf8', timeout: 5000
+    }).trim();
+    if (status) {
+      info.uncommitted = status.split('\n').filter(Boolean).length;
+    }
+  } catch { /* ignore */ }
+
+  try {
+    const log = execSync('git log --oneline -3', {
+      cwd: projectRoot, encoding: 'utf8', timeout: 5000
+    }).trim();
+    if (log) {
+      info.recentCommits = log.split('\n');
+    }
+  } catch { /* ignore */ }
+
+  return info;
+}

package/lib/installer.mjs

@@ -46,6 +46,12 @@ export async function init(projectDir, options = {}) {
     copyFileSync(join(runnersDir, 'pre-tool.mjs'), join(hooksDir, 'pre-tool.mjs'));
     copyFileSync(join(runnersDir, 'post-tool.mjs'), join(hooksDir, 'post-tool.mjs'));
 
+    // Copy new event runners
+    copyFileSync(join(runnersDir, 'precompact.mjs'), join(hooksDir, 'precompact.mjs'));
+    copyFileSync(join(runnersDir, 'session-end.mjs'), join(hooksDir, 'session-end.mjs'));
+    copyFileSync(join(runnersDir, 'subagent-start.mjs'), join(hooksDir, 'subagent-start.mjs'));
+    copyFileSync(join(runnersDir, 'task-completed.mjs'), join(hooksDir, 'task-completed.mjs'));
+
     // Copy rule logic files
     const rulesDestDir = join(claudeDir, 'rules');
     mkdirSync(rulesDestDir, { recursive: true });
@@ -54,11 +60,17 @@ export async function init(projectDir, options = {}) {
     copyFileSync(join(hooksSourceDir, 'test-tracker.mjs'), join(rulesDestDir, 'test-tracker.mjs'));
     copyFileSync(join(hooksSourceDir, 'plan-enforcement.mjs'), join(rulesDestDir, 'plan-enforcement.mjs'));
 
+    // Copy new handler rule files
+    copyFileSync(join(hooksSourceDir, 'precompact-handler.mjs'), join(rulesDestDir, 'precompact-handler.mjs'));
+    copyFileSync(join(hooksSourceDir, 'session-end-handler.mjs'), join(rulesDestDir, 'session-end-handler.mjs'));
+    copyFileSync(join(hooksSourceDir, 'subagent-scope-injector.mjs'), join(rulesDestDir, 'subagent-scope-injector.mjs'));
+    copyFileSync(join(hooksSourceDir, 'task-plan-sync.mjs'), join(rulesDestDir, 'task-plan-sync.mjs'));
+
     // Copy lib dependencies
     const libDestDir = join(claudeDir, 'lib');
     mkdirSync(libDestDir, { recursive: true });
     const libSourceDir = join(__dirname);
-    for (const file of ['state.mjs', 'config.mjs', 'utils.mjs', 'messages.mjs', 'pipeline.mjs', 'session.mjs']) {
+    for (const file of ['state.mjs', 'config.mjs', 'utils.mjs', 'messages.mjs', 'pipeline.mjs', 'session.mjs', 'handoff.mjs', 'webhook.mjs']) {
       copyFileSync(join(libSourceDir, file), join(libDestDir, file));
     }
 
@@ -69,8 +81,11 @@ export async function init(projectDir, options = {}) {
   // 4. Inject rules into CLAUDE.md
   injectRules(projectDir);
 
-  // 5. Create .claude-prism.json config
-  const configPath = join(projectDir, '.claude-prism.json');
+  // 5. Create .prism/ directory with config.json
+  const prismDir = join(projectDir, '.prism');
+  mkdirSync(prismDir, { recursive: true });
+
+  const configPath = join(prismDir, 'config.json');
   if (!existsSync(configPath)) {
     writeFileSync(configPath, JSON.stringify({
       version: 1,
@@ -85,7 +100,13 @@ export async function init(projectDir, options = {}) {
   // Write version file
   const pkgPath = join(__dirname, '..', 'package.json');
   const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-  writeFileSync(join(claudeDir, '.prism-version'), pkg.version);
+  writeFileSync(join(prismDir, '.version'), pkg.version);
+
+  // Create .prism/.gitignore (version file is local-only)
+  const prismGitignore = join(prismDir, '.gitignore');
+  if (!existsSync(prismGitignore)) {
+    writeFileSync(prismGitignore, '.version\n');
+  }
 }
 
 /**
@@ -107,9 +128,13 @@ export function check(projectDir) {
     && readFileSync(claudeMdPath, 'utf8').includes('<!-- PRISM:START -->');
 
   const hooks = existsSync(join(claudeDir, 'hooks', 'pre-tool.mjs'))
-    && existsSync(join(claudeDir, 'hooks', 'post-tool.mjs'));
+    && existsSync(join(claudeDir, 'hooks', 'post-tool.mjs'))
+    && existsSync(join(claudeDir, 'hooks', 'precompact.mjs'))
+    && existsSync(join(claudeDir, 'hooks', 'session-end.mjs'))
+    && existsSync(join(claudeDir, 'hooks', 'subagent-start.mjs'))
+    && existsSync(join(claudeDir, 'hooks', 'task-completed.mjs'));
 
-  const config = existsSync(join(projectDir, '.claude-prism.json'));
+  const config = existsSync(join(projectDir, '.prism', 'config.json'));
 
   return {
     commands,
@@ -151,7 +176,7 @@ export function uninstall(projectDir) {
   }
 
   // 3. Remove hooks
-  for (const hook of ['pre-tool.mjs', 'post-tool.mjs', 'user-prompt.mjs']) {
+  for (const hook of ['pre-tool.mjs', 'post-tool.mjs', 'user-prompt.mjs', 'precompact.mjs', 'session-end.mjs', 'subagent-start.mjs', 'task-completed.mjs']) {
     const p = join(claudeDir, 'hooks', hook);
     if (existsSync(p)) rmSync(p);
   }
@@ -175,7 +200,7 @@ export function uninstall(projectDir) {
     if (settings.hooks) {
       for (const [event, hookList] of Object.entries(settings.hooks)) {
         settings.hooks[event] = hookList.filter(
-          h => !h.hooks?.some(hh => hh.command?.includes('pre-tool') || hh.command?.includes('post-tool') || hh.command?.includes('user-prompt') || hh.command?.includes('commit-guard') || hh.command?.includes('debug-loop') || hh.command?.includes('test-tracker') || hh.command?.includes('scope-guard'))
+          h => !h.hooks?.some(hh => hh.command?.includes('pre-tool') || hh.command?.includes('post-tool') || hh.command?.includes('user-prompt') || hh.command?.includes('commit-guard') || hh.command?.includes('debug-loop') || hh.command?.includes('test-tracker') || hh.command?.includes('scope-guard') || hh.command?.includes('precompact') || hh.command?.includes('session-end') || hh.command?.includes('subagent-start') || hh.command?.includes('task-completed'))
         );
         if (settings.hooks[event].length === 0) delete settings.hooks[event];
       }
@@ -183,15 +208,31 @@ export function uninstall(projectDir) {
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
   }
 
-  // 6. Remove config files
-  const configPath = join(projectDir, '.claude-prism.json');
+  // 6. Remove config files (new + legacy paths)
+  const prismDir = join(projectDir, '.prism');
+  const configPath = join(prismDir, 'config.json');
   if (existsSync(configPath)) rmSync(configPath);
-  const legacyConfigPath = join(projectDir, '.prism.json');
-  if (existsSync(legacyConfigPath)) rmSync(legacyConfigPath);
-
-  // Remove version file
-  const versionFile = join(claudeDir, '.prism-version');
+  const versionFile = join(prismDir, '.version');
   if (existsSync(versionFile)) rmSync(versionFile);
+  const prismGitignore = join(prismDir, '.gitignore');
+  if (existsSync(prismGitignore)) rmSync(prismGitignore);
+  // Remove .prism/ directory if empty
+  if (existsSync(prismDir)) {
+    try {
+      const remaining = readdirSync(prismDir);
+      if (remaining.length === 0) rmSync(prismDir, { recursive: true });
+    } catch { /* ignore */ }
+  }
+
+  // Legacy config paths
+  const legacyConfig = join(projectDir, '.claude-prism.json');
+  if (existsSync(legacyConfig)) rmSync(legacyConfig);
+  const legacyConfig2 = join(projectDir, '.prism.json');
+  if (existsSync(legacyConfig2)) rmSync(legacyConfig2);
+
+  // Legacy version file
+  const legacyVersion = join(claudeDir, '.prism-version');
+  if (existsSync(legacyVersion)) rmSync(legacyVersion);
 }
 
 /**
@@ -215,14 +256,72 @@ export async function update(projectDir) {
     } catch { /* not our package, proceed normally */ }
   }
 
-  // Migration: rename .prism.json to .claude-prism.json
+  const claudeDir = join(projectDir, '.claude');
+
+  // Migration chain: .prism.json → .claude-prism.json → .prism/config.json
+  const prismDir = join(projectDir, '.prism');
+  mkdirSync(prismDir, { recursive: true });
+
   const oldConfigPath = join(projectDir, '.prism.json');
-  const newConfigPath = join(projectDir, '.claude-prism.json');
-  if (existsSync(oldConfigPath) && !existsSync(newConfigPath)) {
-    renameSync(oldConfigPath, newConfigPath);
+  const midConfigPath = join(projectDir, '.claude-prism.json');
+  const configPath = join(prismDir, 'config.json');
+
+  // Step 1: .prism.json → .claude-prism.json (legacy v0.x)
+  if (existsSync(oldConfigPath) && !existsSync(midConfigPath) && !existsSync(configPath)) {
+    renameSync(oldConfigPath, configPath);
+  }
+  // Step 2: .claude-prism.json → .prism/config.json (legacy v1.x)
+  if (existsSync(midConfigPath) && !existsSync(configPath)) {
+    renameSync(midConfigPath, configPath);
+  }
+  // Clean up leftover legacy configs
+  if (existsSync(oldConfigPath)) rmSync(oldConfigPath);
+  if (existsSync(midConfigPath)) rmSync(midConfigPath);
+
+  // Migration: .claude/.prism-version → .prism/.version
+  const legacyVersionFile = join(claudeDir, '.prism-version');
+  const newVersionFile = join(prismDir, '.version');
+  if (existsSync(legacyVersionFile)) {
+    if (!existsSync(newVersionFile)) {
+      renameSync(legacyVersionFile, newVersionFile);
+    } else {
+      rmSync(legacyVersionFile);
+    }
+  }
+
+  // Migration: docs/plans/ → .prism/plans/
+  const legacyPlansDir = join(projectDir, 'docs', 'plans');
+  const newPlansDir = join(prismDir, 'plans');
+  if (existsSync(legacyPlansDir)) {
+    mkdirSync(newPlansDir, { recursive: true });
+    const planFiles = readdirSync(legacyPlansDir).filter(f => f.endsWith('.md'));
+    for (const f of planFiles) {
+      const src = join(legacyPlansDir, f);
+      const dest = join(newPlansDir, f);
+      if (!existsSync(dest)) {
+        renameSync(src, dest);
+      }
+    }
+    // Clean up empty legacy plans dir
+    try {
+      const remaining = readdirSync(legacyPlansDir);
+      if (remaining.length === 0) {
+        rmSync(legacyPlansDir, { recursive: true });
+        // Also remove docs/ if empty
+        const docsDir = join(projectDir, 'docs');
+        if (existsSync(docsDir) && readdirSync(docsDir).length === 0) {
+          rmSync(docsDir, { recursive: true });
+        }
+      }
+    } catch { /* ignore */ }
+  }
+
+  // Create .prism/.gitignore (.version is local-only)
+  const prismGitignore = join(prismDir, '.gitignore');
+  if (!existsSync(prismGitignore)) {
+    writeFileSync(prismGitignore, '.version\n');
   }
 
-  const configPath = newConfigPath;
   let hooks = true;
 
   if (existsSync(configPath)) {
@@ -230,8 +329,6 @@ export async function update(projectDir) {
     hooks = config.hooks?.['commit-guard']?.enabled !== false;
   }
 
-  const claudeDir = join(projectDir, '.claude');
-
   // Migration: remove all legacy files from previous versions
   const legacyFiles = [
     // Legacy flat commands
@@ -251,6 +348,8 @@ export async function update(projectDir) {
     join(claudeDir, 'rules', 'turn-reporter.mjs'),
     // Removed lib files
     join(claudeDir, 'lib', 'adapter.mjs'),
+    // Legacy version file (moved to .prism/.version)
+    join(claudeDir, '.prism-version'),
   ];
   for (const p of legacyFiles) {
     if (existsSync(p)) rmSync(p);
@@ -318,7 +417,7 @@ export function doctor(projectDir, options = {}) {
   }
 
   // Check hooks
-  for (const hook of ['pre-tool.mjs', 'post-tool.mjs']) {
+  for (const hook of ['pre-tool.mjs', 'post-tool.mjs', 'precompact.mjs', 'session-end.mjs', 'subagent-start.mjs', 'task-completed.mjs']) {
     if (!existsSync(join(claudeDir, 'hooks', hook))) {
       issues.push(`Missing hook: ${hook}`);
       fixes.push('Run `prism update` to restore missing files');
@@ -338,9 +437,9 @@ export function doctor(projectDir, options = {}) {
     }
   }
 
-  // Check config
-  if (!existsSync(join(projectDir, '.claude-prism.json'))) {
-    issues.push('Missing .claude-prism.json config');
+  // Check config (.prism/config.json)
+  if (!existsSync(join(projectDir, '.prism', 'config.json'))) {
+    issues.push('Missing .prism/config.json');
     fixes.push('Run `prism init` to create config');
   }
 
@@ -359,6 +458,7 @@ export function doctor(projectDir, options = {}) {
     { path: join(claudeDir, 'rules', 'alignment.mjs'), label: 'Legacy alignment rule' },
     { path: join(claudeDir, 'hooks', 'user-prompt.mjs'), label: 'Legacy user-prompt hook' },
     { path: join(projectDir, '.prism.json'), label: 'Legacy .prism.json config' },
+    { path: join(projectDir, '.claude-prism.json'), label: 'Legacy .claude-prism.json config' },
   ];
   for (const { path, label } of legacyCheck) {
     if (existsSync(path)) {
@@ -368,7 +468,7 @@ export function doctor(projectDir, options = {}) {
   }
 
   // Check version mismatch
-  const versionFile = join(claudeDir, '.prism-version');
+  const versionFile = join(projectDir, '.prism', '.version');
   if (existsSync(versionFile)) {
     const installedVersion = readFileSync(versionFile, 'utf8').trim();
     const pkgPath = join(__dirname, '..', 'package.json');
@@ -404,7 +504,7 @@ export function stats(projectDir, options = {}) {
   const pkgPath = join(__dirname, '..', 'package.json');
   const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
 
-  const configPath = join(projectDir, '.claude-prism.json');
+  const configPath = join(projectDir, '.prism', 'config.json');
   let hookConfig = {};
 
   if (existsSync(configPath)) {
@@ -417,9 +517,12 @@ export function stats(projectDir, options = {}) {
   }
 
   let planFiles = 0;
-  const plansDir = join(projectDir, 'docs', 'plans');
+  const plansDir = join(projectDir, '.prism', 'plans');
+  const legacyPlansDir = join(projectDir, 'docs', 'plans');
   if (existsSync(plansDir)) {
     planFiles = readdirSync(plansDir).filter(f => f.endsWith('.md')).length;
+  } else if (existsSync(legacyPlansDir)) {
+    planFiles = readdirSync(legacyPlansDir).filter(f => f.endsWith('.md')).length;
   }
 
   const omc = detectOmc(options.homeDir);
@@ -513,7 +616,7 @@ export function dryRun(projectDir, options = {}) {
 
   // Hooks
   if (hooks) {
-    for (const hook of ['pre-tool.mjs', 'post-tool.mjs']) {
+    for (const hook of ['pre-tool.mjs', 'post-tool.mjs', 'precompact.mjs', 'session-end.mjs', 'subagent-start.mjs', 'task-completed.mjs']) {
       const target = join(claudeDir, 'hooks', hook);
       actions.push({
         type: 'hook',
@@ -522,7 +625,7 @@ export function dryRun(projectDir, options = {}) {
       });
     }
 
-    for (const rule of ['commit-guard.mjs', 'test-tracker.mjs', 'plan-enforcement.mjs']) {
+    for (const rule of ['commit-guard.mjs', 'test-tracker.mjs', 'plan-enforcement.mjs', 'precompact-handler.mjs', 'session-end-handler.mjs', 'subagent-scope-injector.mjs', 'task-plan-sync.mjs']) {
       const target = join(claudeDir, 'rules', rule);
       actions.push({
         type: 'rule',
@@ -531,7 +634,7 @@ export function dryRun(projectDir, options = {}) {
       });
     }
 
-    for (const lib of ['state.mjs', 'config.mjs', 'utils.mjs', 'messages.mjs', 'pipeline.mjs', 'session.mjs']) {
+    for (const lib of ['state.mjs', 'config.mjs', 'utils.mjs', 'messages.mjs', 'pipeline.mjs', 'session.mjs', 'handoff.mjs', 'webhook.mjs']) {
       const target = join(claudeDir, 'lib', lib);
       actions.push({
         type: 'lib',
@@ -550,9 +653,9 @@ export function dryRun(projectDir, options = {}) {
   });
 
   // Config
-  const configPath = join(projectDir, '.claude-prism.json');
+  const configPath = join(projectDir, '.prism', 'config.json');
   if (!existsSync(configPath)) {
-    actions.push({ type: 'config', path: '.claude-prism.json', status: 'create' });
+    actions.push({ type: 'config', path: '.prism/config.json', status: 'create' });
   }
 
   return { actions };

package/lib/messages.mjs

@@ -7,7 +7,11 @@ const MESSAGES = {
   'commit-guard.warn.no-test': '🌈 Prism > No test run detected this session. Run tests before committing.',
   'commit-guard.warn.stale': '🌈 Prism > Last test run was {minutes}min ago. Run tests before committing.',
   'test-tracker.warn.failed': '🌈 Prism 📊 Tests FAILED. Fix before committing.',
-  'plan-enforcement.warn.no-plan': '🌈 Prism > Editing {count} unique source files without a plan. Create a plan at docs/plans/ per EUDEC DECOMPOSE protocol.',
+  'plan-enforcement.warn.no-plan': '🌈 Prism > Editing {count} unique source files without a plan. Create a plan at .prism/plans/ per EUDEC DECOMPOSE protocol.',
+  'precompact-handler.info.saved': '🌈 Prism > HANDOFF.md auto-saved before compaction.',
+  'session-end-handler.info.saved': '🌈 Prism > Session summary saved to PROJECT-MEMORY.md.',
+  'subagent-scope-injector.info.scope': '🌈 Prism Scope >',
+  'task-plan-sync.info.updated': '🌈 Prism > Plan updated: {task}. Progress: {done}/{total} ({pct}%)',
 };
 
 export function getMessage(_lang, key, params = {}) {

package/lib/webhook.mjs

@@ -0,0 +1,57 @@
+/**
+ * claude-prism — HTTP Webhook Dispatcher
+ * Non-blocking fire-and-forget webhook notifications
+ */
+
+/**
+ * Dispatch a webhook event to configured endpoints
+ * @param {Object} config - Prism config with webhooks array
+ * @param {string} event - Event name (e.g. 'compaction', 'session-end', 'batch-complete')
+ * @param {Object} payload - Event payload data
+ * @returns {Promise<void>}
+ */
+export async function dispatchWebhook(config, event, payload) {
+  const webhooks = config.webhooks || [];
+  if (webhooks.length === 0) return;
+
+  const body = JSON.stringify({
+    event,
+    timestamp: new Date().toISOString(),
+    source: 'claude-prism',
+    payload
+  });
+
+  const promises = [];
+
+  for (const hook of webhooks) {
+    // Filter by subscribed events
+    if (hook.events && hook.events.length > 0 && !hook.events.includes(event)) {
+      continue;
+    }
+
+    if (!hook.url) continue;
+
+    const headers = {
+      'Content-Type': 'application/json',
+      'User-Agent': 'claude-prism-webhook/1.0',
+      ...(hook.headers || {})
+    };
+
+    // Fire-and-forget with timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5000);
+
+    const p = fetch(hook.url, {
+      method: 'POST',
+      headers,
+      body,
+      signal: controller.signal
+    })
+      .catch(() => { /* silent fail — webhooks are best-effort */ })
+      .finally(() => clearTimeout(timeoutId));
+
+    promises.push(p);
+  }
+
+  await Promise.allSettled(promises);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "1.2.7",
+  "version": "1.4.0",
   "description": "EUDEC methodology framework for AI coding agents — Essence, Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {
@@ -30,7 +30,10 @@
     "bin/",
     "lib/",
     "hooks/",
+    "scripts/",
     "templates/",
+    ".claude-plugin/",
+    "plugin-hooks.json",
     "README.md",
     "CHANGELOG.md"
   ],