@stanco323/oh-my-claude-code 4.10.3

package/dist/hooks/comment-checker/index.js

@@ -0,0 +1,283 @@
+/**
+ * Comment Checker Hook
+ *
+ * Detects comments and docstrings in code changes and prompts Claude
+ * to justify or remove unnecessary comments.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ * Instead of using an external CLI binary, this implementation does
+ * comment detection directly in TypeScript.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { tmpdir } from 'os';
+import { HOOK_MESSAGE_HEADER, LINE_COMMENT_PATTERNS, EXTENSION_TO_LANGUAGE, } from './constants.js';
+import { applyFilters } from './filters.js';
+const DEBUG = process.env.COMMENT_CHECKER_DEBUG === '1';
+const DEBUG_FILE = path.join(tmpdir(), 'comment-checker-debug.log');
+function debugLog(...args) {
+    if (DEBUG) {
+        const msg = `[${new Date().toISOString()}] [comment-checker] ${args
+            .map((a) => (typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a)))
+            .join(' ')}\n`;
+        fs.appendFileSync(DEBUG_FILE, msg);
+    }
+}
+/**
+ * Get language from file extension
+ */
+function getLanguageFromPath(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return EXTENSION_TO_LANGUAGE[ext];
+}
+/**
+ * Detect comments in content using regex patterns
+ */
+function detectComments(content, filePath) {
+    const language = getLanguageFromPath(filePath);
+    if (!language) {
+        debugLog('unsupported language for:', filePath);
+        return [];
+    }
+    const pattern = LINE_COMMENT_PATTERNS[language];
+    if (!pattern) {
+        debugLog('no pattern for language:', language);
+        return [];
+    }
+    const comments = [];
+    // Reset regex state
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const matchStart = match.index;
+        const matchText = match[0];
+        // Calculate line number
+        const beforeMatch = content.substring(0, matchStart);
+        const lineNumber = beforeMatch.split('\n').length;
+        // Determine comment type
+        let commentType = 'line';
+        let isDocstring = false;
+        if (matchText.startsWith('/*') || matchText.startsWith('<!--')) {
+            commentType = 'block';
+        }
+        else if (matchText.startsWith("'''") ||
+            matchText.startsWith('"""') ||
+            matchText.startsWith('=begin')) {
+            commentType = 'docstring';
+            isDocstring = true;
+        }
+        comments.push({
+            text: matchText.trim(),
+            lineNumber,
+            filePath,
+            commentType,
+            isDocstring,
+        });
+    }
+    return comments;
+}
+/**
+ * Extract comments from new content (for Write tool)
+ */
+function extractCommentsFromContent(content, filePath) {
+    return detectComments(content, filePath);
+}
+/**
+ * Extract comments from new string (for Edit tool)
+ */
+function extractCommentsFromEdit(newString, filePath, oldString) {
+    // Only check comments that are newly added
+    const newComments = detectComments(newString, filePath);
+    if (oldString) {
+        const oldComments = detectComments(oldString, filePath);
+        const oldTexts = new Set(oldComments.map((c) => c.text));
+        // Filter out comments that existed before
+        return newComments.filter((c) => !oldTexts.has(c.text));
+    }
+    return newComments;
+}
+/**
+ * Format comments for output message
+ */
+function formatCommentMessage(comments) {
+    if (comments.length === 0) {
+        return '';
+    }
+    const grouped = new Map();
+    for (const comment of comments) {
+        const existing = grouped.get(comment.filePath) || [];
+        existing.push(comment);
+        grouped.set(comment.filePath, existing);
+    }
+    let message = HOOK_MESSAGE_HEADER;
+    for (const [filePath, fileComments] of grouped) {
+        message += `\nFile: ${filePath}\n`;
+        for (const comment of fileComments) {
+            const typeLabel = comment.isDocstring ? 'docstring' : comment.commentType;
+            message += `  Line ${comment.lineNumber} (${typeLabel}): ${comment.text.substring(0, 100)}${comment.text.length > 100 ? '...' : ''}\n`;
+        }
+    }
+    return message;
+}
+/**
+ * Check content for comments
+ */
+export function checkForComments(filePath, content, oldString, newString, edits) {
+    let allComments = [];
+    if (content) {
+        // Write tool - check entire content
+        allComments = extractCommentsFromContent(content, filePath);
+    }
+    else if (newString) {
+        // Edit tool - check new content
+        allComments = extractCommentsFromEdit(newString, filePath, oldString);
+    }
+    else if (edits && edits.length > 0) {
+        // MultiEdit tool - check all edits
+        for (const edit of edits) {
+            const editComments = extractCommentsFromEdit(edit.new_string, filePath, edit.old_string);
+            allComments.push(...editComments);
+        }
+    }
+    // Apply filters to remove acceptable comments
+    const flaggedComments = applyFilters(allComments);
+    debugLog(`found ${allComments.length} comments, ${flaggedComments.length} flagged after filtering`);
+    if (flaggedComments.length === 0) {
+        return {
+            hasComments: false,
+            count: 0,
+            comments: [],
+        };
+    }
+    return {
+        hasComments: true,
+        count: flaggedComments.length,
+        message: formatCommentMessage(flaggedComments),
+        comments: flaggedComments,
+    };
+}
+/**
+ * Pending calls tracking
+ */
+const pendingCalls = new Map();
+/**
+ * Create comment checker hook for Claude Code shell hooks
+ *
+ * This hook checks for comments in Write/Edit operations and injects
+ * a message prompting Claude to justify or remove unnecessary comments.
+ */
+export function createCommentCheckerHook(config) {
+    debugLog('createCommentCheckerHook called', { config });
+    return {
+        /**
+         * PreToolUse - Track pending write/edit calls
+         */
+        preToolUse: (input) => {
+            const toolLower = input.tool_name.toLowerCase();
+            if (toolLower !== 'write' &&
+                toolLower !== 'edit' &&
+                toolLower !== 'multiedit') {
+                return null;
+            }
+            const filePath = (input.tool_input.file_path ??
+                input.tool_input.filePath ??
+                input.tool_input.path);
+            const content = input.tool_input.content;
+            const oldString = (input.tool_input.old_string ??
+                input.tool_input.oldString);
+            const newString = (input.tool_input.new_string ??
+                input.tool_input.newString);
+            const edits = input.tool_input.edits;
+            if (!filePath) {
+                return null;
+            }
+            // Generate a call ID based on session and timestamp
+            const callId = `${input.session_id}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+            debugLog('registering pendingCall:', {
+                callId,
+                filePath,
+                tool: toolLower,
+            });
+            pendingCalls.set(callId, {
+                filePath,
+                content,
+                oldString,
+                newString,
+                edits,
+                tool: toolLower,
+                sessionId: input.session_id,
+                timestamp: Date.now(),
+            });
+            return null;
+        },
+        /**
+         * PostToolUse - Check for comments after successful write/edit
+         */
+        postToolUse: (input) => {
+            const toolLower = input.tool_name.toLowerCase();
+            if (toolLower !== 'write' &&
+                toolLower !== 'edit' &&
+                toolLower !== 'multiedit') {
+                return null;
+            }
+            // Find the pending call for this session
+            let pendingCall;
+            let callIdToDelete;
+            for (const [callId, call] of pendingCalls) {
+                if (call.sessionId === input.session_id && call.tool === toolLower) {
+                    pendingCall = call;
+                    callIdToDelete = callId;
+                    break;
+                }
+            }
+            if (!pendingCall) {
+                // Fall back to extracting from tool_input
+                const filePath = (input.tool_input.file_path ??
+                    input.tool_input.filePath ??
+                    input.tool_input.path);
+                if (!filePath) {
+                    return null;
+                }
+                pendingCall = {
+                    filePath,
+                    content: input.tool_input.content,
+                    oldString: (input.tool_input.old_string ??
+                        input.tool_input.oldString),
+                    newString: (input.tool_input.new_string ??
+                        input.tool_input.newString),
+                    edits: input.tool_input.edits,
+                    tool: toolLower,
+                    sessionId: input.session_id,
+                    timestamp: Date.now(),
+                };
+            }
+            if (callIdToDelete) {
+                pendingCalls.delete(callIdToDelete);
+            }
+            // Check if tool execution failed
+            if (input.tool_response) {
+                const responseLower = input.tool_response.toLowerCase();
+                const isToolFailure = responseLower.includes('error:') ||
+                    responseLower.includes('failed to') ||
+                    responseLower.includes('could not') ||
+                    responseLower.startsWith('error');
+                if (isToolFailure) {
+                    debugLog('skipping due to tool failure in response');
+                    return null;
+                }
+            }
+            // Check for comments
+            const result = checkForComments(pendingCall.filePath, pendingCall.content, pendingCall.oldString, pendingCall.newString, pendingCall.edits);
+            if (result.hasComments && result.message) {
+                debugLog('detected comments, returning message');
+                return config?.customPrompt || result.message;
+            }
+            return null;
+        },
+    };
+}
+// Re-export filters
+export { applyFilters } from './filters.js';
+// Re-export constants
+export { BDD_KEYWORDS, TYPE_CHECKER_PREFIXES, HOOK_MESSAGE_HEADER, LINE_COMMENT_PATTERNS, EXTENSION_TO_LANGUAGE, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/comment-checker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/comment-checker/index.ts"],"names":[],"mappings":"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"}

package/dist/hooks/comment-checker/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Comment Checker Types
+ *
+ * Type definitions for comment detection in code changes.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+/**
+ * Type of comment detected
+ */
+export type CommentType = 'line' | 'block' | 'docstring';
+/**
+ * Information about a detected comment
+ */
+export interface CommentInfo {
+    /** The comment text content */
+    text: string;
+    /** Line number where comment appears */
+    lineNumber: number;
+    /** File path containing the comment */
+    filePath: string;
+    /** Type of comment */
+    commentType: CommentType;
+    /** Whether this is a docstring */
+    isDocstring: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Pending tool call for comment checking
+ */
+export interface PendingCall {
+    /** File path being modified */
+    filePath: string;
+    /** New file content (for Write tool) */
+    content?: string;
+    /** Old string being replaced (for Edit tool) */
+    oldString?: string;
+    /** New string replacement (for Edit tool) */
+    newString?: string;
+    /** Multiple edits (for MultiEdit tool) */
+    edits?: Array<{
+        old_string: string;
+        new_string: string;
+    }>;
+    /** Tool that triggered this check */
+    tool: 'write' | 'edit' | 'multiedit';
+    /** Session ID */
+    sessionId: string;
+    /** Timestamp of the call */
+    timestamp: number;
+}
+/**
+ * Comments found in a file
+ */
+export interface FileComments {
+    /** File path */
+    filePath: string;
+    /** List of comments found */
+    comments: CommentInfo[];
+}
+/**
+ * Result of a comment filter
+ */
+export interface FilterResult {
+    /** Whether to skip this comment */
+    shouldSkip: boolean;
+    /** Reason for skipping */
+    reason?: string;
+}
+/**
+ * Function type for comment filters
+ */
+export type CommentFilter = (comment: CommentInfo) => FilterResult;
+/**
+ * Result of comment checking
+ */
+export interface CommentCheckResult {
+    /** Whether comments were detected */
+    hasComments: boolean;
+    /** Number of comments found */
+    count: number;
+    /** Message to inject if comments found */
+    message?: string;
+    /** Detailed comment information */
+    comments: CommentInfo[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/comment-checker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/comment-checker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,qCAAqC;IACrC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IACrC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,YAAY,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB"}

package/dist/hooks/comment-checker/types.js

@@ -0,0 +1,9 @@
+/**
+ * Comment Checker Types
+ *
+ * Type definitions for comment detection in code changes.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/comment-checker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/comment-checker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/hooks/directory-readme-injector/constants.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Directory README Injector Constants
+ *
+ * Constants for finding and injecting README files from directories.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+/** Storage directory for directory-readme-injector state */
+export declare const OMC_STORAGE_DIR: string;
+export declare const README_INJECTOR_STORAGE: string;
+/** README filename to search for */
+export declare const README_FILENAME = "README.md";
+/** AGENTS.md filename to search for (deepinit output) */
+export declare const AGENTS_FILENAME = "AGENTS.md";
+/** All context filenames to search for during directory walks */
+export declare const CONTEXT_FILENAMES: string[];
+/** Tools that trigger context file injection */
+export declare const TRACKED_TOOLS: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/directory-readme-injector/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,4DAA4D;AAC5D,eAAO,MAAM,eAAe,QAA0B,CAAC;AACvD,eAAO,MAAM,uBAAuB,QAGnC,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,UAAqC,CAAC;AAEpE,gDAAgD;AAChD,eAAO,MAAM,aAAa,UAAyC,CAAC"}

package/dist/hooks/directory-readme-injector/constants.js

@@ -0,0 +1,21 @@
+/**
+ * Directory README Injector Constants
+ *
+ * Constants for finding and injecting README files from directories.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/** Storage directory for directory-readme-injector state */
+export const OMC_STORAGE_DIR = join(homedir(), '.omc');
+export const README_INJECTOR_STORAGE = join(OMC_STORAGE_DIR, 'directory-readme');
+/** README filename to search for */
+export const README_FILENAME = 'README.md';
+/** AGENTS.md filename to search for (deepinit output) */
+export const AGENTS_FILENAME = 'AGENTS.md';
+/** All context filenames to search for during directory walks */
+export const CONTEXT_FILENAMES = [README_FILENAME, AGENTS_FILENAME];
+/** Tools that trigger context file injection */
+export const TRACKED_TOOLS = ['read', 'write', 'edit', 'multiedit'];
+//# sourceMappingURL=constants.js.map

package/dist/hooks/directory-readme-injector/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CACzC,eAAe,EACf,kBAAkB,CACnB,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAEpE,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC"}

package/dist/hooks/directory-readme-injector/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Directory README Injector Hook
+ *
+ * Automatically injects relevant README content from directories when files are accessed.
+ * Walks up the directory tree from accessed files to find and inject README.md files.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ * Adapted for Claude Code's shell hook system.
+ */
+export * from './types.js';
+export * from './constants.js';
+export * from './storage.js';
+/**
+ * Create directory README injector hook for Claude Code.
+ *
+ * @param workingDirectory - The working directory for resolving paths
+ * @returns Hook handlers for tool execution
+ */
+export declare function createDirectoryReadmeInjectorHook(workingDirectory: string): {
+    /**
+     * Process a tool execution and inject READMEs if relevant.
+     */
+    processToolExecution: (toolName: string, filePath: string, sessionID: string) => string;
+    /**
+     * Get context files (README.md, AGENTS.md) for a specific file without marking as injected.
+     */
+    getContextFilesForFile: (filePath: string) => string[];
+    /**
+     * @deprecated Use getContextFilesForFile instead
+     */
+    getReadmesForFile: (filePath: string) => string[];
+    /**
+     * Clear session cache when session ends.
+     */
+    clearSession: (sessionID: string) => void;
+    /**
+     * Check if a tool triggers README injection.
+     */
+    isTrackedTool: (toolName: string) => boolean;
+};
+/**
+ * Get README paths for a file (simple utility function).
+ */
+export declare function getReadmesForPath(filePath: string, workingDirectory?: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/directory-readme-injector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAsC7B;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,gBAAgB,EAAE,MAAM;IAsGtE;;OAEG;qCAES,MAAM,YACN,MAAM,aACL,MAAM,KAChB,MAAM;IAQT;;OAEG;uCACgC,MAAM,KAAG,MAAM,EAAE;IAQpD;;OAEG;kCAC2B,MAAM,KAAG,MAAM,EAAE;IAQ/C;;OAEG;8BACuB,MAAM,KAAG,IAAI;IAKvC;;OAEG;8BACuB,MAAM,KAAG,OAAO;EAI7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,EAAE,CAIV"}