claude-prism 0.5.2 → 0.6.0

package/hooks/alignment.mjs

@@ -33,7 +33,16 @@ export const alignment = {
       const dir = ctx.filePath.split('/').slice(0, -1).join('/') || '.';
       let scopeDirs = readJsonState(stateDir, 'scope-directories') || [];
 
-      if (!scopeDirs.includes(dir)) {
+      // Check if dir is within any existing base scope (subdirectory match)
+      const isWithinScope = scopeDirs.some(base =>
+        dir === base || dir.startsWith(base + '/')
+      );
+      // Also check if dir is a parent of an existing scope dir
+      const isParentOfScope = scopeDirs.some(base =>
+        base.startsWith(dir + '/')
+      );
+
+      if (!isWithinScope && !isParentOfScope && !scopeDirs.includes(dir)) {
         // First 3 unique directories establish the "base scope"
         if (scopeDirs.length < 3) {
           scopeDirs.push(dir);

package/hooks/debug-loop.mjs

@@ -69,6 +69,13 @@ export const debugLoop = {
   }
 };
 
+// Common statement prefixes that don't indicate "same area"
+const BOILERPLATE_RE = /^(?:import\s.*?from\s|import\s*\{|export\s+(?:default\s+)?(?:const|let|var|function|class|interface|type)\s|const\s|let\s|var\s|function\s|return\s)/;
+
+function stripBoilerplate(snippet) {
+  return snippet.replace(BOILERPLATE_RE, '').trim();
+}
+
 function analyzePattern(log) {
   if (log.length < 3) return null;
   const recent = log.slice(-3).map(e => e.snippet);
@@ -80,11 +87,18 @@ function analyzePattern(log) {
   const uniqueSnippets = new Set(recent).size;
   if (uniqueSnippets === 1) return 'divergent';
 
-  // Check for meaningful overlap using longer window
-  const baseSnippet = recent[0].slice(0, 40);
-  // Skip overlap check if base is too short for meaningful comparison
-  if (baseSnippet.length < 10) return uniqueSnippets <= 2 ? 'divergent' : 'convergent';
+  // Strip boilerplate prefixes before comparing (import X from, const, etc.)
+  const stripped = recent.map(stripBoilerplate);
+  const uniqueStripped = new Set(stripped).size;
+
+  // After stripping, if all unique → editing different areas
+  if (uniqueStripped === recent.length) return 'convergent';
+
+  // Check for meaningful overlap using stripped content
+  const baseSnippet = stripped[0].slice(0, 30);
+  if (baseSnippet.length < 10) return uniqueStripped <= 1 ? 'divergent' : 'convergent';
 
-  const overlap = recent.filter(s => s.includes(baseSnippet)).length;
-  return overlap >= 2 ? 'divergent' : 'convergent';
+  // Require all 3 to overlap (stricter than previous >= 2)
+  const overlap = stripped.filter(s => s.includes(baseSnippet)).length;
+  return overlap >= 3 ? 'divergent' : 'convergent';
 }

package/hooks/scope-guard.mjs

@@ -69,11 +69,19 @@ export const scopeGuard = {
     }
 
     if (hasPlan) {
-      warnAt *= 2;
-      blockAt *= 2;
+      const multiplier = config.planMultiplier || 3;
+      warnAt *= multiplier;
+      blockAt *= multiplier;
     }
 
     if (count >= blockAt) {
+      // With a plan: downgrade block → warn (planned large tasks are expected)
+      if (hasPlan) {
+        return {
+          type: 'warn',
+          message: getMessage(lang, 'scope-guard.block-with-plan', { count, blockAt })
+        };
+      }
       return {
         type: 'block',
         message: getMessage(lang, 'scope-guard.block', { count })
@@ -81,9 +89,10 @@ export const scopeGuard = {
     }
 
     if (count >= warnAt) {
+      const msgKey = hasPlan ? 'scope-guard.warn-with-plan' : 'scope-guard.warn';
       return {
         type: 'warn',
-        message: getMessage(lang, 'scope-guard.warn', { count })
+        message: getMessage(lang, msgKey, { count, blockAt })
       };
     }
 

package/lib/config.mjs

@@ -14,7 +14,7 @@ const DEFAULTS = {
     'commit-guard': { enabled: true, maxTestAge: 300 },
     'debug-loop': { enabled: true, warnAt: 3, blockAt: 5 },
     'test-tracker': { enabled: true },
-    'scope-guard': { enabled: true, warnAt: 4, blockAt: 7, agentWarnAt: 8, agentBlockAt: 12 },
+    'scope-guard': { enabled: true, warnAt: 4, blockAt: 7, agentWarnAt: 8, agentBlockAt: 12, planMultiplier: 3 },
     'alignment': { enabled: true, driftThreshold: 2 }
   }
 };

package/lib/installer.mjs

@@ -232,6 +232,22 @@ export async function update(projectDir) {
     if (existsSync(p)) rmSync(p);
   }
 
+  // Migration: remove legacy individual hook entries from settings.json
+  const settingsPath = join(claudeDir, 'settings.json');
+  if (existsSync(settingsPath)) {
+    const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    if (settings.hooks) {
+      const legacyCommands = ['commit-guard', 'debug-loop', 'test-tracker', 'scope-guard'];
+      for (const [event, hookList] of Object.entries(settings.hooks)) {
+        settings.hooks[event] = hookList.filter(
+          h => !h.hooks?.some(hh => legacyCommands.some(lc => hh.command?.includes(lc)))
+        );
+        if (settings.hooks[event].length === 0) delete settings.hooks[event];
+      }
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    }
+  }
+
   // Remove old config so init creates a fresh one
   if (existsSync(configPath)) rmSync(configPath);
 

package/lib/messages.mjs

@@ -10,7 +10,9 @@ const MESSAGES = {
   'debug-loop.warn.divergent': '🌈 Prism > Debug Loop: {name} edited {count} times on same area. Stop and investigate root cause.',
   'debug-loop.warn.convergent': '🌈 Prism > Debug Loop: {name} edited {count} times (different areas). Consider if this is expected.',
   'scope-guard.block': '🌈 Prism ✋ Scope Guard: {count} unique files modified without a plan. Run /prism to decompose before continuing.',
+  'scope-guard.block-with-plan': '🌈 Prism > Scope Guard: {count} files modified (plan threshold: {blockAt}). Verify changes stay within plan scope.',
   'scope-guard.warn': '🌈 Prism > Scope Guard: {count} unique files modified. Consider running /prism to decompose the task.',
+  'scope-guard.warn-with-plan': '🌈 Prism > Scope Guard: {count} files modified (plan threshold: {blockAt}). On track if within plan.',
   'scope-guard.plan-detected': '🌈 Prism 📋 Plan file detected. Scope thresholds raised.',
   'test-tracker.warn.failed': '🌈 Prism 📊 Tests FAILED. Fix before committing.',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-prism",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "AI coding problem decomposition tool — Understand, Decompose, Execute, Checkpoint.",
   "type": "module",
   "bin": {