start-vibing 2.0.45 → 2.0.46

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "start-vibing",
-	"version": "2.0.45",
+	"version": "2.0.46",
 	"description": "Setup Claude Code agents, skills, and hooks in your project. Smart copy that preserves your custom domains and configurations.",
 	"type": "module",
 	"bin": {

package/template/.claude/CLAUDE.md

@@ -39,7 +39,9 @@ The stop-validator categorizes changed files and maps them to CLAUDE.md sections
 | Config files | Stack, Configuration |
 | Hooks/scripts | Workflow, Stop Hook Validations |
 
-If ONLY "Last Change" was modified but categorized source files changed, `CLAUDE_MD_SHALLOW_UPDATE` blocks completion.
+If ONLY "Last Change" was modified but **significant** categorized source files changed, `CLAUDE_MD_SHALLOW_UPDATE` blocks completion.
+
+**Exempt (minor changes):** < 3 categorized files AND < 30 lines changed AND no new files = Last Change only is OK.
 
 ---
 

package/template/.claude/hooks/stop-validator.ts

@@ -820,13 +820,133 @@ The stop hook will BLOCK until CLAUDE.md is updated with ALL relevant sections.
 	};
 }
 
+// ============================================================================
+// CHANGE RELEVANCE ASSESSMENT
+// ============================================================================
+
+/**
+ * Minimum thresholds for changes to be considered "relevant enough" to require
+ * updating CLAUDE.md sections beyond "Last Change".
+ *
+ * Minor changes (small fixes, typos, internal refactors) that don't affect
+ * project rules, flows, or patterns should NOT require deep section updates.
+ */
+const RELEVANCE_THRESHOLDS = {
+	/** Minimum total lines added+removed across categorized files to require section updates */
+	minLinesChanged: 30,
+	/** Minimum number of categorized files changed to require section updates */
+	minFilesChanged: 3,
+	/** If ANY new files were created in categorized areas, always require section updates */
+	newFilesAlwaysRelevant: true,
+};
+
+/**
+ * Assess whether the changes in categorized files are significant enough
+ * to require updating CLAUDE.md sections beyond "Last Change".
+ *
+ * Returns true if changes are relevant (should require deep updates).
+ * Returns false if changes are minor (Last Change only is acceptable).
+ */
+function areChangesRelevantForClaudeMd(
+	categories: Array<{ category: string; sections: string[]; files: string[] }>
+): boolean {
+	const totalCategorizedFiles = categories.reduce((sum, c) => sum + c.files.length, 0);
+
+	// Check for new files (new files = new patterns/features = always relevant)
+	if (RELEVANCE_THRESHOLDS.newFilesAlwaysRelevant) {
+		try {
+			const untrackedRaw = execSync('git ls-files --others --exclude-standard', {
+				cwd: PROJECT_DIR,
+				encoding: 'utf8',
+				stdio: ['pipe', 'pipe', 'pipe'],
+			}).trim();
+			const newInLastCommitRaw = execSync('git diff --name-only --diff-filter=A HEAD~1 HEAD 2>/dev/null || echo ""', {
+				cwd: PROJECT_DIR,
+				encoding: 'utf8',
+				stdio: ['pipe', 'pipe', 'pipe'],
+			}).trim();
+
+			const newFiles = [...untrackedRaw.split('\n'), ...newInLastCommitRaw.split('\n')].filter(Boolean);
+			const allCategorizedFiles = categories.flatMap((c) => c.files);
+			const newCategorizedFiles = newFiles.filter((f) =>
+				allCategorizedFiles.some((cf) => f.includes(cf) || cf.includes(f))
+			);
+
+			if (newCategorizedFiles.length > 0) {
+				return true; // New files in categorized areas = always relevant
+			}
+		} catch {
+			// Can't determine, continue with other checks
+		}
+	}
+
+	// Check minimum files threshold
+	if (totalCategorizedFiles < RELEVANCE_THRESHOLDS.minFilesChanged) {
+		// Few files changed - check if the diff is substantial
+		try {
+			const allCategorizedFiles = categories.flatMap((c) => c.files);
+			let totalLinesChanged = 0;
+
+			// Try to get numstat from various diff sources
+			const numstatCommands = [
+				'git diff --numstat',
+				'git diff --cached --numstat',
+				'git diff --numstat HEAD~1 HEAD',
+			];
+
+			for (const cmd of numstatCommands) {
+				try {
+					const numstat = execSync(cmd, {
+						cwd: PROJECT_DIR,
+						encoding: 'utf8',
+						stdio: ['pipe', 'pipe', 'pipe'],
+					}).trim();
+
+					if (!numstat) continue;
+
+					for (const line of numstat.split('\n')) {
+						const parts = line.split('\t');
+						if (parts.length < 3) continue;
+						const added = parseInt(parts[0] || '0', 10) || 0;
+						const removed = parseInt(parts[1] || '0', 10) || 0;
+						const file = parts[2] || '';
+
+						// Only count lines in categorized files
+						if (allCategorizedFiles.some((cf) => file.includes(cf) || cf.includes(file))) {
+							totalLinesChanged += added + removed;
+						}
+					}
+
+					if (totalLinesChanged > 0) break;
+				} catch {
+					continue;
+				}
+			}
+
+			if (totalLinesChanged < RELEVANCE_THRESHOLDS.minLinesChanged) {
+				return false; // Small diff + few files = minor change, Last Change is enough
+			}
+		} catch {
+			// Can't determine line count, fall through to relevant
+		}
+	}
+
+	return true; // Meets thresholds = relevant, require section updates
+}
+
 /**
- * NEW VALIDATION: Checks if CLAUDE.md was updated but only the "Last Change"
- * section was modified (shallow update). When source files in categorized areas
- * changed, CLAUDE.md sections beyond Last Change should also be updated.
+ * Content depth validation: Checks if CLAUDE.md was updated but only the
+ * "Last Change" section was modified (shallow update).
  *
- * This catches the common pattern where Claude updates only "Last Change"
- * but ignores updating the actual rules/flows that changed.
+ * ALLOWS shallow updates when changes are minor:
+ * - Few files changed (< 3 categorized files)
+ * - Small diff (< 30 lines total in categorized files)
+ * - No new files created in categorized areas
+ *
+ * BLOCKS shallow updates when changes are significant:
+ * - Many categorized files changed
+ * - Large diffs that likely introduce new rules/flows
+ * - New files created (new patterns/features)
  */
 function validateClaudeMdContentDepth(modifiedFiles: string[]): ValidationError | null {
 	const significantFiles = getSignificantFiles(modifiedFiles);
@@ -842,6 +962,11 @@ function validateClaudeMdContentDepth(modifiedFiles: string[]): ValidationError
 	const categories = categorizeChangedFiles(significantFiles);
 	if (categories.length === 0) return null; // No categorizable changes, Last Change is enough
 
+	// RELEVANCE CHECK: Skip if changes are minor/not relevant enough
+	if (!areChangesRelevantForClaudeMd(categories)) {
+		return null; // Minor changes - Last Change only is acceptable
+	}
+
 	// Try to detect if only "Last Change" section was modified in CLAUDE.md
 	// Check git diff of CLAUDE.md (staged, unstaged, or last commit)
 	let claudeMdDiff = '';
@@ -881,6 +1006,7 @@ function validateClaudeMdContentDepth(modifiedFiles: string[]): ValidationError
 	if (!onlyLastChange) return null; // Other sections were also modified, good
 
 	// Build specific guidance for what sections need updating
+	const totalFiles = categories.reduce((sum, c) => sum + c.files.length, 0);
 	const sectionGuidance = categories
 		.map((c) => {
 			const uniqueSections = [...new Set(c.sections)];
@@ -891,14 +1017,16 @@ function validateClaudeMdContentDepth(modifiedFiles: string[]): ValidationError
 
 	return {
 		type: 'CLAUDE_MD_SHALLOW_UPDATE',
-		message: `CLAUDE.md was updated but ONLY "Last Change" was modified. ${categories.length} change category(ies) require updating additional rule/flow sections.`,
+		message: `CLAUDE.md was updated but ONLY "Last Change" was modified. ${categories.length} category(ies) with ${totalFiles} file(s) require updating additional rule/flow sections.`,
 		action: `
 ================================================================================
 CLAUDE.MD SHALLOW UPDATE DETECTED - MUST UPDATE RELEVANT SECTIONS
 ================================================================================
 
 You updated CLAUDE.md but ONLY modified the "Last Change" section.
-This is NOT sufficient when source files that affect rules/flows were changed.
+The changes are significant enough to require updating rule/flow sections.
+
+(Minor changes with < ${RELEVANCE_THRESHOLDS.minFilesChanged} files and < ${RELEVANCE_THRESHOLDS.minLinesChanged} lines are exempt from this check.)
 
 CHANGES DETECTED THAT REQUIRE SECTION UPDATES:
 
@@ -919,18 +1047,12 @@ For EACH category above, review the corresponding CLAUDE.md section and:
 3. If a FLOW changed (e.g., new middleware, data fetching pattern):
    → UPDATE Workflow, Architecture, or Next.js App Router Patterns
 
-4. If NOTHING changed in rules/flows (just implementation):
-   → Add a comment in the relevant section noting the implementation
-
-EXAMPLES:
-  - Changed how users are fetched? → Update HTTP Requests section
-  - Changed button styles? → Update Design System section
-  - Added new page? → Update Architecture section
-  - Changed form validation? → Update Critical Rules section
+4. If NOTHING changed in rules/flows (just implementation details):
+   → This should not happen for significant changes. Review again.
 
 RULE: "Last Change" documents WHAT was done.
       Other sections document HOW things work NOW.
-      Both must be current.
+      Both must be current for significant changes.
 
 The stop hook will BLOCK until relevant sections are also updated.
 ================================================================================`,