olympus-ai 1.0.0

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

@@ -0,0 +1,28 @@
+/**
+ * Comment Checker Constants
+ *
+ * Keywords and patterns for comment detection and filtering.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+/**
+ * BDD (Behavior-Driven Development) keywords that are acceptable in comments
+ */
+export declare const BDD_KEYWORDS: Set<string>;
+/**
+ * Prefixes for type checker and linter directives (acceptable comments)
+ */
+export declare const TYPE_CHECKER_PREFIXES: string[];
+/**
+ * Header message for comment detection
+ */
+export declare const HOOK_MESSAGE_HEADER = "COMMENT/DOCSTRING DETECTED - IMMEDIATE ACTION REQUIRED\n\nYour recent changes contain comments or docstrings, which triggered this hook.\nYou need to take immediate action. You must follow the conditions below.\n(Listed in priority order - you must always act according to this priority order)\n\nCRITICAL WARNING: This hook message MUST NEVER be ignored, even if you receive it multiple times.\nYou MUST provide corresponding explanation or action for EACH occurrence of this message.\nIgnoring this message or failing to respond appropriately is strictly prohibited.\n\nPRIORITY-BASED ACTION GUIDELINES:\n\n1. This is a comment/docstring that already existed before\n   -> Explain to the user that this is an existing comment/docstring and proceed (justify it)\n\n2. This is a newly written comment: but it's in given, when, then format\n   -> Tell the user it's a BDD comment and proceed (justify it)\n   -> Note: This applies to comments only, not docstrings\n\n3. This is a newly written comment/docstring: but it's a necessary comment/docstring\n   -> Tell the user why this comment/docstring is absolutely necessary and proceed (justify it)\n   -> Examples of necessary comments: complex algorithms, security-related, performance optimization, regex, mathematical formulas\n   -> Examples of necessary docstrings: public API documentation, complex module/class interfaces\n   -> IMPORTANT: Most docstrings are unnecessary if the code is self-explanatory. Only keep truly essential ones.\n\n4. This is a newly written comment/docstring: but it's an unnecessary comment/docstring\n   -> Apologize to the user and remove the comment/docstring.\n   -> Make the code itself clearer so it can be understood without comments/docstrings.\n   -> For verbose docstrings: refactor code to be self-documenting instead of adding lengthy explanations.\n\nCODE SMELL WARNING: Using comments as visual separators (e.g., \"// =========\", \"# ---\", \"// *** Section ***\")\nis a code smell. If you need separators, your file is too long or poorly organized.\nRefactor into smaller modules or use proper code organization instead of comment-based section dividers.\n\nMANDATORY REQUIREMENT: You must acknowledge this hook message and take one of the above actions.\nReview in the above priority order and take the corresponding action EVERY TIME this appears.\n\nDetected comments/docstrings:\n";
+/**
+ * Pattern for detecting line comments by language
+ */
+export declare const LINE_COMMENT_PATTERNS: Record<string, RegExp>;
+/**
+ * File extensions to language mapping
+ */
+export declare const EXTENSION_TO_LANGUAGE: Record<string, string>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/comment-checker/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,aASvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,UA4CjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,q1EAsC/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgCxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsCxD,CAAC"}

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

@@ -0,0 +1,189 @@
+/**
+ * Comment Checker Constants
+ *
+ * Keywords and patterns for comment detection and filtering.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+/**
+ * BDD (Behavior-Driven Development) keywords that are acceptable in comments
+ */
+export const BDD_KEYWORDS = new Set([
+    'given',
+    'when',
+    'then',
+    'arrange',
+    'act',
+    'assert',
+    'when & then',
+    'when&then',
+]);
+/**
+ * Prefixes for type checker and linter directives (acceptable comments)
+ */
+export const TYPE_CHECKER_PREFIXES = [
+    // Python
+    'type:',
+    'noqa',
+    'pyright:',
+    'ruff:',
+    'mypy:',
+    'pylint:',
+    'flake8:',
+    'pyre:',
+    'pytype:',
+    // JavaScript/TypeScript
+    'eslint-disable',
+    'eslint-enable',
+    'eslint-ignore',
+    'prettier-ignore',
+    'ts-ignore',
+    'ts-expect-error',
+    'ts-nocheck',
+    '@ts-ignore',
+    '@ts-expect-error',
+    '@ts-nocheck',
+    // Rust
+    'clippy::',
+    'allow(',
+    'deny(',
+    'warn(',
+    'forbid(',
+    // Go
+    'nolint',
+    'go:generate',
+    'go:build',
+    'go:embed',
+    // Coverage
+    'coverage:',
+    'c8 ignore',
+    'istanbul ignore',
+    // Biome
+    'biome-ignore',
+    // Regions
+    'region',
+    'endregion',
+    '#region',
+    '#endregion',
+];
+/**
+ * Header message for comment detection
+ */
+export const HOOK_MESSAGE_HEADER = `COMMENT/DOCSTRING DETECTED - IMMEDIATE ACTION REQUIRED
+
+Your recent changes contain comments or docstrings, which triggered this hook.
+You need to take immediate action. You must follow the conditions below.
+(Listed in priority order - you must always act according to this priority order)
+
+CRITICAL WARNING: This hook message MUST NEVER be ignored, even if you receive it multiple times.
+You MUST provide corresponding explanation or action for EACH occurrence of this message.
+Ignoring this message or failing to respond appropriately is strictly prohibited.
+
+PRIORITY-BASED ACTION GUIDELINES:
+
+1. This is a comment/docstring that already existed before
+   -> Explain to the user that this is an existing comment/docstring and proceed (justify it)
+
+2. This is a newly written comment: but it's in given, when, then format
+   -> Tell the user it's a BDD comment and proceed (justify it)
+   -> Note: This applies to comments only, not docstrings
+
+3. This is a newly written comment/docstring: but it's a necessary comment/docstring
+   -> Tell the user why this comment/docstring is absolutely necessary and proceed (justify it)
+   -> Examples of necessary comments: complex algorithms, security-related, performance optimization, regex, mathematical formulas
+   -> Examples of necessary docstrings: public API documentation, complex module/class interfaces
+   -> IMPORTANT: Most docstrings are unnecessary if the code is self-explanatory. Only keep truly essential ones.
+
+4. This is a newly written comment/docstring: but it's an unnecessary comment/docstring
+   -> Apologize to the user and remove the comment/docstring.
+   -> Make the code itself clearer so it can be understood without comments/docstrings.
+   -> For verbose docstrings: refactor code to be self-documenting instead of adding lengthy explanations.
+
+CODE SMELL WARNING: Using comments as visual separators (e.g., "// =========", "# ---", "// *** Section ***")
+is a code smell. If you need separators, your file is too long or poorly organized.
+Refactor into smaller modules or use proper code organization instead of comment-based section dividers.
+
+MANDATORY REQUIREMENT: You must acknowledge this hook message and take one of the above actions.
+Review in the above priority order and take the corresponding action EVERY TIME this appears.
+
+Detected comments/docstrings:
+`;
+/**
+ * Pattern for detecting line comments by language
+ */
+export const LINE_COMMENT_PATTERNS = {
+    // C-style: //, /* */
+    js: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    ts: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    jsx: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    tsx: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    java: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    c: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    cpp: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    cs: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    go: /\/\/.*$/gm,
+    rust: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    swift: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    kotlin: /\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    // Hash-style: #
+    py: /#.*$|'''[\s\S]*?'''|"""[\s\S]*?"""/gm,
+    rb: /#.*$|=begin[\s\S]*?=end/gm,
+    sh: /#.*$/gm,
+    bash: /#.*$/gm,
+    zsh: /#.*$/gm,
+    yaml: /#.*$/gm,
+    yml: /#.*$/gm,
+    toml: /#.*$/gm,
+    // HTML-style: <!-- -->
+    html: /<!--[\s\S]*?-->/gm,
+    xml: /<!--[\s\S]*?-->/gm,
+    vue: /<!--[\s\S]*?-->|\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    svelte: /<!--[\s\S]*?-->|\/\/.*$|\/\*[\s\S]*?\*\//gm,
+    // SQL-style: --
+    sql: /--.*$/gm,
+    // Lua-style: --
+    lua: /--.*$|--\[\[[\s\S]*?\]\]/gm,
+};
+/**
+ * File extensions to language mapping
+ */
+export const EXTENSION_TO_LANGUAGE = {
+    '.js': 'js',
+    '.mjs': 'js',
+    '.cjs': 'js',
+    '.ts': 'ts',
+    '.mts': 'ts',
+    '.cts': 'ts',
+    '.jsx': 'jsx',
+    '.tsx': 'tsx',
+    '.java': 'java',
+    '.c': 'c',
+    '.h': 'c',
+    '.cpp': 'cpp',
+    '.cc': 'cpp',
+    '.cxx': 'cpp',
+    '.hpp': 'cpp',
+    '.cs': 'cs',
+    '.go': 'go',
+    '.rs': 'rust',
+    '.swift': 'swift',
+    '.kt': 'kotlin',
+    '.kts': 'kotlin',
+    '.py': 'py',
+    '.pyi': 'py',
+    '.rb': 'rb',
+    '.sh': 'sh',
+    '.bash': 'bash',
+    '.zsh': 'zsh',
+    '.yaml': 'yaml',
+    '.yml': 'yml',
+    '.toml': 'toml',
+    '.html': 'html',
+    '.htm': 'html',
+    '.xml': 'xml',
+    '.vue': 'vue',
+    '.svelte': 'svelte',
+    '.sql': 'sql',
+    '.lua': 'lua',
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/comment-checker/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,OAAO;IACP,MAAM;IACN,MAAM;IACN,SAAS;IACT,KAAK;IACL,QAAQ;IACR,aAAa;IACb,WAAW;CACZ,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,OAAO;IACP,MAAM;IACN,UAAU;IACV,OAAO;IACP,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,SAAS;IACT,wBAAwB;IACxB,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,aAAa;IACb,OAAO;IACP,UAAU;IACV,QAAQ;IACR,OAAO;IACP,OAAO;IACP,SAAS;IACT,KAAK;IACL,QAAQ;IACR,aAAa;IACb,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,QAAQ;IACR,cAAc;IACd,UAAU;IACV,QAAQ;IACR,WAAW;IACX,SAAS;IACT,YAAY;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,qBAAqB;IACrB,EAAE,EAAE,4BAA4B;IAChC,EAAE,EAAE,4BAA4B;IAChC,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,4BAA4B;IACjC,IAAI,EAAE,4BAA4B;IAClC,CAAC,EAAE,4BAA4B;IAC/B,GAAG,EAAE,4BAA4B;IACjC,EAAE,EAAE,4BAA4B;IAChC,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,4BAA4B;IAClC,KAAK,EAAE,4BAA4B;IACnC,MAAM,EAAE,4BAA4B;IACpC,gBAAgB;IAChB,EAAE,EAAE,sCAAsC;IAC1C,EAAE,EAAE,2BAA2B;IAC/B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,uBAAuB;IACvB,IAAI,EAAE,mBAAmB;IACzB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,4CAA4C;IACjD,MAAM,EAAE,4CAA4C;IACpD,gBAAgB;IAChB,GAAG,EAAE,SAAS;IACd,gBAAgB;IAChB,GAAG,EAAE,4BAA4B;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;CACd,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Comment Checker Filters
+ *
+ * Filters to determine which comments should be flagged vs skipped.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+import type { CommentInfo, FilterResult } from './types.js';
+/**
+ * Filter for shebang comments (#!/usr/bin/env ...)
+ */
+export declare function filterShebangComments(comment: CommentInfo): FilterResult;
+/**
+ * Filter for BDD (Behavior-Driven Development) comments
+ */
+export declare function filterBddComments(comment: CommentInfo): FilterResult;
+/**
+ * Filter for type checker and linter directive comments
+ */
+export declare function filterDirectiveComments(comment: CommentInfo): FilterResult;
+/**
+ * Filter for docstring comments in non-public functions
+ * (More lenient - only flags excessive docstrings)
+ */
+export declare function filterDocstringComments(_comment: CommentInfo): FilterResult;
+/**
+ * Filter for copyright/license headers
+ */
+export declare function filterCopyrightComments(comment: CommentInfo): FilterResult;
+/**
+ * Filter for TODO/FIXME comments (these are acceptable)
+ */
+export declare function filterTodoComments(comment: CommentInfo): FilterResult;
+/**
+ * Apply all filters to a list of comments
+ * Returns only comments that should be flagged
+ */
+export declare function applyFilters(comments: CommentInfo[]): CommentInfo[];
+//# sourceMappingURL=filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/hooks/comment-checker/filters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE3E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAMxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAuBpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAU1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAI3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAqB1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAWrE;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAUnE"}

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

@@ -0,0 +1,126 @@
+/**
+ * Comment Checker Filters
+ *
+ * Filters to determine which comments should be flagged vs skipped.
+ *
+ * Adapted from oh-my-opencode's comment-checker hook.
+ */
+import { BDD_KEYWORDS, TYPE_CHECKER_PREFIXES } from './constants.js';
+/**
+ * Filter for shebang comments (#!/usr/bin/env ...)
+ */
+export function filterShebangComments(comment) {
+    const text = comment.text.trim();
+    if (text.startsWith('#!') && comment.lineNumber === 1) {
+        return { shouldSkip: true, reason: 'shebang' };
+    }
+    return { shouldSkip: false };
+}
+/**
+ * Filter for BDD (Behavior-Driven Development) comments
+ */
+export function filterBddComments(comment) {
+    // Don't filter docstrings
+    if (comment.isDocstring) {
+        return { shouldSkip: false };
+    }
+    const text = comment.text.toLowerCase().trim();
+    // Check for BDD keywords
+    for (const keyword of BDD_KEYWORDS) {
+        if (text.startsWith(`#${keyword}`) || text.startsWith(`// ${keyword}`)) {
+            return { shouldSkip: true, reason: `BDD keyword: ${keyword}` };
+        }
+        if (text.includes(keyword)) {
+            // More lenient check for keywords anywhere in comment
+            const words = text.split(/\s+/);
+            if (words.some(w => BDD_KEYWORDS.has(w.replace(/[^a-z&]/g, '')))) {
+                return { shouldSkip: true, reason: `BDD keyword detected` };
+            }
+        }
+    }
+    return { shouldSkip: false };
+}
+/**
+ * Filter for type checker and linter directive comments
+ */
+export function filterDirectiveComments(comment) {
+    const text = comment.text.toLowerCase().trim();
+    for (const prefix of TYPE_CHECKER_PREFIXES) {
+        if (text.includes(prefix.toLowerCase())) {
+            return { shouldSkip: true, reason: `directive: ${prefix}` };
+        }
+    }
+    return { shouldSkip: false };
+}
+/**
+ * Filter for docstring comments in non-public functions
+ * (More lenient - only flags excessive docstrings)
+ */
+export function filterDocstringComments(_comment) {
+    // We don't skip docstrings by default - they should be reviewed
+    // This filter is here for extensibility
+    return { shouldSkip: false };
+}
+/**
+ * Filter for copyright/license headers
+ */
+export function filterCopyrightComments(comment) {
+    const text = comment.text.toLowerCase();
+    const copyrightPatterns = [
+        'copyright',
+        'license',
+        'licensed under',
+        'spdx-license-identifier',
+        'all rights reserved',
+        'mit license',
+        'apache license',
+        'gnu general public',
+        'bsd license',
+    ];
+    for (const pattern of copyrightPatterns) {
+        if (text.includes(pattern)) {
+            return { shouldSkip: true, reason: 'copyright/license' };
+        }
+    }
+    return { shouldSkip: false };
+}
+/**
+ * Filter for TODO/FIXME comments (these are acceptable)
+ */
+export function filterTodoComments(comment) {
+    const text = comment.text.toUpperCase();
+    const todoPatterns = ['TODO', 'FIXME', 'HACK', 'XXX', 'NOTE', 'REVIEW'];
+    for (const pattern of todoPatterns) {
+        if (text.includes(pattern)) {
+            return { shouldSkip: true, reason: `todo marker: ${pattern}` };
+        }
+    }
+    return { shouldSkip: false };
+}
+/**
+ * All filters in order of application
+ */
+const ALL_FILTERS = [
+    filterShebangComments,
+    filterBddComments,
+    filterDirectiveComments,
+    filterCopyrightComments,
+    filterTodoComments,
+    filterDocstringComments,
+];
+/**
+ * Apply all filters to a list of comments
+ * Returns only comments that should be flagged
+ */
+export function applyFilters(comments) {
+    return comments.filter((comment) => {
+        for (const filter of ALL_FILTERS) {
+            const result = filter(comment);
+            if (result.shouldSkip) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=filters.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * 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 type { CommentCheckResult } from './types.js';
+/**
+ * Check content for comments
+ */
+export declare function checkForComments(filePath: string, content?: string, oldString?: string, newString?: string, edits?: Array<{
+    old_string: string;
+    new_string: string;
+}>): CommentCheckResult;
+/**
+ * Configuration for comment checker hook
+ */
+export interface CommentCheckerConfig {
+    /** Custom prompt to append instead of default */
+    customPrompt?: string;
+    /** Whether to enable the hook */
+    enabled?: boolean;
+}
+/**
+ * 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 declare function createCommentCheckerHook(config?: CommentCheckerConfig): {
+    /**
+     * PreToolUse - Track pending write/edit calls
+     */
+    preToolUse: (input: {
+        tool_name: string;
+        session_id: string;
+        tool_input: Record<string, unknown>;
+    }) => {
+        decision: string;
+    } | null;
+    /**
+     * PostToolUse - Check for comments after successful write/edit
+     */
+    postToolUse: (input: {
+        tool_name: string;
+        session_id: string;
+        tool_input: Record<string, unknown>;
+        tool_response?: string;
+    }) => string | null;
+};
+export type { CommentInfo, CommentCheckResult, PendingCall } from './types.js';
+export { applyFilters } from './filters.js';
+export { BDD_KEYWORDS, TYPE_CHECKER_PREFIXES, HOOK_MESSAGE_HEADER, LINE_COMMENT_PATTERNS, EXTENSION_TO_LANGUAGE, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/comment-checker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,KAAK,EAAe,kBAAkB,EAAe,MAAM,YAAY,CAAC;AA4I/E;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACxD,kBAAkB,CA0CpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,oBAAoB;IASlE;;OAEG;wBACiB;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,KAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkD/B;;OAEG;yBACkB;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAG,MAAM,GAAG,IAAI;EAqFpB;AAGD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC"}