oh-my-claudecode 0.2.4 → 0.2.7

package/dist/hooks/design-detector.js

@@ -0,0 +1,251 @@
+/**
+ * Design Task Detector
+ *
+ * Detects when a user message indicates a frontend/design task.
+ * Used to route messages to Nodens subagent.
+ */
+/**
+ * HIGH confidence design keywords — strongly indicate design tasks
+ */
+const HIGH_CONFIDENCE_KEYWORDS = [
+    // Component/UI terms
+    "component",
+    "ui",
+    "interface",
+    "design",
+    "button",
+    "card",
+    "form",
+    "modal",
+    "dialog",
+    "sidebar",
+    "navbar",
+    "menu",
+    "dropdown",
+    "tooltip",
+    "popover",
+    "accordion",
+    "tab",
+    "carousel",
+    // Layout/styling
+    "layout",
+    "responsive",
+    "mobile-first",
+    "breakpoint",
+    "css",
+    "tailwind",
+    "style",
+    "theme",
+    "dark mode",
+    "flexbox",
+    "grid",
+    // Accessibility
+    "accessibility",
+    "wcag",
+    "aria",
+    "semantic html",
+    "keyboard navigation",
+    "screen reader",
+    // Design system
+    "design system",
+    "design tokens",
+    "component library",
+    "storybook",
+];
+/**
+ * MEDIUM confidence design keywords — suggest design tasks
+ */
+const MEDIUM_CONFIDENCE_KEYWORDS = [
+    // Framework/library specific
+    "react",
+    "vue",
+    "svelte",
+    "angular",
+    "next.js",
+    "nuxt",
+    "astro",
+    "solid",
+    // UI libraries
+    "shadcn",
+    "material-ui",
+    "chakra",
+    "radix",
+    "ant-design",
+    "storybook",
+    // General design
+    "color",
+    "typography",
+    "animation",
+    "transition",
+    "interaction",
+    "user experience",
+    "ux",
+    "ui/ux",
+    "mockup",
+    "prototype",
+    "wireframe",
+    "styling",
+    "style",
+    // Styling tools
+    "sass",
+    "less",
+    "postcss",
+    "emotion",
+    "styled-components",
+    "css-in-js",
+];
+/**
+ * LOW confidence design keywords — weak signal for design tasks
+ * Used as fallback when other keywords are present
+ */
+const LOW_CONFIDENCE_KEYWORDS = [
+    "design",
+    "build",
+    "create",
+    "make",
+    "implement",
+    "polish",
+    "refine",
+    "improve",
+    "visual",
+    "appearance",
+];
+/**
+ * Negative patterns — indicate this is NOT a design task
+ */
+const NEGATIVE_PATTERNS = [
+    /\bdesign\s+(pattern|doc|document|spec)\b/i, // "design document", "design spec"
+    /\bsystem\s+design\b/i, // "system design" (infrastructure)
+    /\b(database|schema|architecture|algorithm|data|api|network)\s+design\b/i, // Non-UI design
+    /\bdesign\s+(system|database|schema|architecture|algorithm|data|api|network|relational|query)\b/i, // "design system", "design database"
+    /\bdesign\s+a\s+(relational\s+)?(database|system|algorithm|schema|api|network|backend|server)\b/i, // "design a database"
+];
+/**
+ * Detects if a user message indicates a design task.
+ *
+ * Strategy:
+ * 1. Check for HIGH confidence keywords (component, ui, interface, etc.)
+ * 2. If not found, check MEDIUM confidence keywords (react, vue, animation, etc.)
+ * 3. If not found, check LOW confidence keywords
+ * 4. Verify no negative patterns are present
+ * 5. Return confidence level and matched keywords
+ *
+ * @param userMessage - The user's input message
+ * @returns Detection result with confidence and matched keywords
+ */
+export function detectDesignTask(userMessage) {
+    const message = userMessage.toLowerCase().trim();
+    // Very short messages unlikely to be design tasks
+    if (message.length < 8) {
+        return {
+            isDesignTask: false,
+            confidence: "low",
+            keywords: [],
+            reason: "Message too short to detect design task",
+        };
+    }
+    // Check for negative patterns first (filter out false positives)
+    for (const pattern of NEGATIVE_PATTERNS) {
+        if (pattern.test(message)) {
+            return {
+                isDesignTask: false,
+                confidence: "low",
+                keywords: [],
+                reason: `Matched negative pattern: ${pattern.source}`,
+            };
+        }
+    }
+    // Check HIGH confidence keywords
+    const highMatches = findMatchingKeywords(message, HIGH_CONFIDENCE_KEYWORDS);
+    if (highMatches.length > 0) {
+        return {
+            isDesignTask: true,
+            confidence: "high",
+            keywords: highMatches,
+            reason: `Found high-confidence design keywords: ${highMatches.join(", ")}`,
+        };
+    }
+    // Check MEDIUM confidence keywords
+    const mediumMatches = findMatchingKeywords(message, MEDIUM_CONFIDENCE_KEYWORDS);
+    if (mediumMatches.length >= 2) {
+        // Require at least 2 medium keywords
+        return {
+            isDesignTask: true,
+            confidence: "medium",
+            keywords: mediumMatches,
+            reason: `Found multiple medium-confidence keywords: ${mediumMatches.join(", ")}`,
+        };
+    }
+    // Check if there's a high context for design (e.g., specific frameworks + design intent)
+    if (mediumMatches.length === 1) {
+        const frameworks = ["react", "vue", "svelte", "angular", "next.js", "nuxt", "astro"];
+        const isFramework = frameworks.some(fw => message.includes(fw));
+        const designIntents = [
+            "build",
+            "create",
+            "make",
+            "design",
+            "style",
+            "implement",
+            "component",
+        ];
+        const hasDesignIntent = designIntents.some(intent => message.includes(intent));
+        if (isFramework && hasDesignIntent) {
+            return {
+                isDesignTask: true,
+                confidence: "medium",
+                keywords: mediumMatches,
+                reason: `Framework + design intent detected: ${mediumMatches.join(", ")}`,
+            };
+        }
+    }
+    // Check LOW confidence keywords as last resort
+    const lowMatches = findMatchingKeywords(message, LOW_CONFIDENCE_KEYWORDS);
+    if (lowMatches.length >= 2) {
+        return {
+            isDesignTask: true,
+            confidence: "low",
+            keywords: lowMatches,
+            reason: `Found low-confidence design keywords: ${lowMatches.join(", ")}`,
+        };
+    }
+    // No design task detected
+    return {
+        isDesignTask: false,
+        confidence: "low",
+        keywords: [],
+        reason: "No design keywords or patterns detected",
+    };
+}
+/**
+ * Finds matching keywords in a message
+ * @param message - The message to search in
+ * @param keywords - The keywords to match
+ * @returns Array of matched keywords (unique)
+ */
+function findMatchingKeywords(message, keywords) {
+    const matched = new Set();
+    for (const keyword of keywords) {
+        // Use word boundaries to avoid partial matches
+        // "component" should match "component" but not "decompose"
+        const pattern = new RegExp(`\\b${keyword}\\b`, "i");
+        if (pattern.test(message)) {
+            matched.add(keyword);
+        }
+    }
+    return Array.from(matched);
+}
+/**
+ * Export for testing
+ * Finds keywords in message without case sensitivity
+ */
+export function findDesignKeywords(message) {
+    const highMatches = findMatchingKeywords(message, HIGH_CONFIDENCE_KEYWORDS);
+    if (highMatches.length > 0)
+        return highMatches;
+    const mediumMatches = findMatchingKeywords(message, MEDIUM_CONFIDENCE_KEYWORDS);
+    if (mediumMatches.length > 0)
+        return mediumMatches;
+    return findMatchingKeywords(message, LOW_CONFIDENCE_KEYWORDS);
+}
+//# sourceMappingURL=design-detector.js.map

package/dist/hooks/design-detector.js.map

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

package/dist/hooks/index.d.ts

@@ -6,6 +6,9 @@ export { RULES_INJECTOR_HOOK_SCRIPT, getRulesInjectorHookConfig } from "./rules-
 export { WRITE_GUARD_HOOK_SCRIPT, getWriteGuardHookConfig } from "./write-guard.js";
 export { CTHULHU_AUTO_HOOK_SCRIPT, getCthulhuAutoHookConfig } from "./cthulhu-auto.js";
 export { MEMORY_OVERRIDE_HOOK_SCRIPT, getMemoryOverrideHookConfig } from "./memory-override.js";
+export { YITH_CAPTURE_HOOK_SCRIPT, getYithCaptureHookConfig } from "./yith-capture.js";
+export { WEB_RESEARCH_DETECTOR_HOOK_SCRIPT, getWebResearchDetectorHookConfig } from "./web-research-hook.js";
+export { DESIGN_DETECTOR_HOOK_SCRIPT, getDesignDetectorHookConfig } from "./design-detector-hook.js";
 export interface HookDefinition {
     name: HookName;
     event: "PreToolUse" | "PostToolUse" | "Stop" | "Notification" | "SessionStart";

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAE/F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,cAAc,CAAA;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AA+BD,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAkDhD,CAAA;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAG9E;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAqBzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAA;AAC5G,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAEpG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,cAAc,CAAA;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AA2CD,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAuEhD,CAAA;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAG9E;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAqBzF"}

package/dist/hooks/index.js

@@ -5,6 +5,9 @@ export { RULES_INJECTOR_HOOK_SCRIPT, getRulesInjectorHookConfig } from "./rules-
 export { WRITE_GUARD_HOOK_SCRIPT, getWriteGuardHookConfig } from "./write-guard.js";
 export { CTHULHU_AUTO_HOOK_SCRIPT, getCthulhuAutoHookConfig } from "./cthulhu-auto.js";
 export { MEMORY_OVERRIDE_HOOK_SCRIPT, getMemoryOverrideHookConfig } from "./memory-override.js";
+export { YITH_CAPTURE_HOOK_SCRIPT, getYithCaptureHookConfig } from "./yith-capture.js";
+export { WEB_RESEARCH_DETECTOR_HOOK_SCRIPT, getWebResearchDetectorHookConfig } from "./web-research-hook.js";
+export { DESIGN_DETECTOR_HOOK_SCRIPT, getDesignDetectorHookConfig } from "./design-detector-hook.js";
 import { TODO_CONTINUATION_HOOK_SCRIPT, getTodoContinuationHookConfig, } from "./todo-continuation.js";
 import { ELDER_LOOP_HOOK_SCRIPT, getElderLoopHookConfig, } from "./elder-loop.js";
 import { COMMENT_CHECKER_HOOK_SCRIPT, getCommentCheckerHookConfig, } from "./comment-checker.js";
@@ -12,6 +15,9 @@ import { RULES_INJECTOR_HOOK_SCRIPT, getRulesInjectorHookConfig, } from "./rules
 import { WRITE_GUARD_HOOK_SCRIPT, getWriteGuardHookConfig, } from "./write-guard.js";
 import { CTHULHU_AUTO_HOOK_SCRIPT, getCthulhuAutoHookConfig, } from "./cthulhu-auto.js";
 import { MEMORY_OVERRIDE_HOOK_SCRIPT, getMemoryOverrideHookConfig, } from "./memory-override.js";
+import { YITH_CAPTURE_HOOK_SCRIPT, getYithCaptureHookConfig, } from "./yith-capture.js";
+import { WEB_RESEARCH_DETECTOR_HOOK_SCRIPT, getWebResearchDetectorHookConfig, } from "./web-research-hook.js";
+import { DESIGN_DETECTOR_HOOK_SCRIPT, getDesignDetectorHookConfig, } from "./design-detector-hook.js";
 /** All hook definitions for the plugin */
 export const ALL_HOOK_DEFINITIONS = [
     {
@@ -63,6 +69,27 @@ export const ALL_HOOK_DEFINITIONS = [
         scriptContent: MEMORY_OVERRIDE_HOOK_SCRIPT,
         config: getMemoryOverrideHookConfig(),
     },
+    {
+        name: "yith-capture",
+        event: "Stop",
+        scriptPath: "~/.claude/hooks/yith-capture.sh",
+        scriptContent: YITH_CAPTURE_HOOK_SCRIPT,
+        config: getYithCaptureHookConfig(),
+    },
+    {
+        name: "web-research-detector",
+        event: "PreToolUse",
+        scriptPath: "~/.claude/hooks/web-research-detector.sh",
+        scriptContent: WEB_RESEARCH_DETECTOR_HOOK_SCRIPT,
+        config: getWebResearchDetectorHookConfig(),
+    },
+    {
+        name: "design-detector",
+        event: "PreToolUse",
+        scriptPath: "~/.claude/hooks/design-detector.sh",
+        scriptContent: DESIGN_DETECTOR_HOOK_SCRIPT,
+        config: getDesignDetectorHookConfig(),
+    },
 ];
 /** Get hooks that should be installed, respecting disabled_hooks config */
 export function getEnabledHooks(config) {

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAA;AAC5G,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAUpG,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iCAAiC,EACjC,gCAAgC,GACjC,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAA;AAElC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACpD;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,sCAAsC;QAClD,aAAa,EAAE,6BAA6B;QAC5C,MAAM,EAAE,6BAA6B,EAAE;KACxC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,+BAA+B;QAC3C,aAAa,EAAE,sBAAsB;QACrC,MAAM,EAAE,sBAAsB,EAAE;KACjC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,aAAa;QACpB,UAAU,EAAE,oCAAoC;QAChD,aAAa,EAAE,2BAA2B;QAC1C,MAAM,EAAE,2BAA2B,EAAE;KACtC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,mCAAmC;QAC/C,aAAa,EAAE,0BAA0B;QACzC,MAAM,EAAE,0BAA0B,EAAE;KACrC;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,gCAAgC;QAC5C,aAAa,EAAE,uBAAuB;QACtC,MAAM,EAAE,uBAAuB,EAAE;KAClC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,UAAU,EAAE,iCAAiC;QAC7C,aAAa,EAAE,wBAAwB;QACvC,MAAM,EAAE,wBAAwB,EAAE;KACnC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,cAAc;QACrB,UAAU,EAAE,oCAAoC;QAChD,aAAa,EAAE,2BAA2B;QAC1C,MAAM,EAAE,2BAA2B,EAAE;KACtC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,iCAAiC;QAC7C,aAAa,EAAE,wBAAwB;QACvC,MAAM,EAAE,wBAAwB,EAAE;KACnC;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,0CAA0C;QACtD,aAAa,EAAE,iCAAiC;QAChD,MAAM,EAAE,gCAAgC,EAAE;KAC3C;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,oCAAoC;QAChD,aAAa,EAAE,2BAA2B;QAC1C,MAAM,EAAE,2BAA2B,EAAE;KACtC;CACF,CAAA;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,MAA4B;IAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAA;IACrD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAChE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,YAA8B;IAC7D,MAAM,YAAY,GAA6B;QAC7C,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;KACjB,CAAA;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/dist/hooks/web-research-detector.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Web Research Detector
+ *
+ * Identifies when user messages indicate a need for web research.
+ * Used by web-research hook and agent prompts to enforce current knowledge.
+ */
+/**
+ * Categories of web research triggers
+ */
+export declare enum WebResearchTriggerType {
+    VERSION_CHECK = "version_check",// "latest", "v3.5", "2024", version numbers
+    FRAMEWORK_SPECIFIC = "framework",// React, Vue, Next.js, etc.
+    DATE_SENSITIVE = "date_sensitive",// "what's new", "breaking changes", "deprecation"
+    LIBRARY_UPDATE = "library_update",// "npm updates", "package releases"
+    BEST_PRACTICES = "best_practices",// "best practice for X in 2024", "modern approach"
+    CURRENT_STATUS = "current_status"
+}
+/**
+ * A detected web research trigger
+ */
+export interface WebResearchTrigger {
+    type: WebResearchTriggerType;
+    pattern: string;
+    context?: string;
+}
+/**
+ * Confidence levels for web research need
+ */
+export type ResearchConfidence = "must" | "should" | "maybe";
+/**
+ * Result of web research detection
+ */
+export interface WebResearchDetectionResult {
+    trigger: WebResearchTrigger | null;
+    confidence: ResearchConfidence;
+    reason?: string;
+}
+/**
+ * Configuration for web research detector
+ */
+export interface WebResearchDetectorConfig {
+    enabled: boolean;
+    min_confidence?: "must" | "should" | "maybe";
+    trigger_types?: WebResearchTriggerType[];
+}
+/**
+ * Detects if a user message indicates web research is needed.
+ *
+ * Strategy:
+ * 1. Check for "MUST" confidence triggers first (version checks, breaking changes)
+ * 2. If not found, check "SHOULD" triggers (frameworks, best practices)
+ * 3. If not found, return "MAYBE" or null
+ *
+ * @param userMessage - The user's input message
+ * @returns Detection result with trigger and confidence level
+ */
+export declare function detectWebResearchNeeded(userMessage: string): WebResearchDetectionResult;
+//# sourceMappingURL=web-research-detector.d.ts.map

package/dist/hooks/web-research-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-research-detector.d.ts","sourceRoot":"","sources":["../../src/hooks/web-research-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,sBAAsB;IAChC,aAAa,kBAAkB,CAAO,4CAA4C;IAClF,kBAAkB,cAAc,CAAM,4BAA4B;IAClE,cAAc,mBAAmB,CAAK,kDAAkD;IACxF,cAAc,mBAAmB,CAAK,oCAAoC;IAC1E,cAAc,mBAAmB,CAAK,mDAAmD;IACzF,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAClC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC5C,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAA;CACzC;AA4GD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,CAuEvF"}

package/dist/hooks/web-research-detector.js

@@ -0,0 +1,205 @@
+/**
+ * Web Research Detector
+ *
+ * Identifies when user messages indicate a need for web research.
+ * Used by web-research hook and agent prompts to enforce current knowledge.
+ */
+/**
+ * Categories of web research triggers
+ */
+export var WebResearchTriggerType;
+(function (WebResearchTriggerType) {
+    WebResearchTriggerType["VERSION_CHECK"] = "version_check";
+    WebResearchTriggerType["FRAMEWORK_SPECIFIC"] = "framework";
+    WebResearchTriggerType["DATE_SENSITIVE"] = "date_sensitive";
+    WebResearchTriggerType["LIBRARY_UPDATE"] = "library_update";
+    WebResearchTriggerType["BEST_PRACTICES"] = "best_practices";
+    WebResearchTriggerType["CURRENT_STATUS"] = "current_status";
+})(WebResearchTriggerType || (WebResearchTriggerType = {}));
+/**
+ * Pattern definitions for web research detection
+ * Each pattern has: regex, trigger type, confidence level
+ */
+const TRIGGER_PATTERNS = [
+    // ─── VERSION CHECKS (MUST confidence) ─────────────────────────────────────
+    // Explicit v-prefix version numbers like "v3.5", "v18", "v2.3.0"
+    {
+        pattern: /\bv\d+(?:\.\d+)?(?:\.\d+)?(?:-\w+)?/,
+        trigger: WebResearchTriggerType.VERSION_CHECK,
+        confidence: "must",
+    },
+    // Semantic versioning patterns "2.3.0", "3.5", "18.0"
+    {
+        pattern: /\b(\d+\.\d+(?:\.\d+)?)\b/,
+        trigger: WebResearchTriggerType.VERSION_CHECK,
+        confidence: "must",
+    },
+    // "latest version", "latest update", "latest release"
+    {
+        pattern: /\b(latest\s+(version|release|update|api))\b/i,
+        trigger: WebResearchTriggerType.VERSION_CHECK,
+        confidence: "must",
+    },
+    // Years (2023, 2024, 2025)
+    {
+        pattern: /\b(202[3-9])\b/,
+        trigger: WebResearchTriggerType.VERSION_CHECK,
+        confidence: "should",
+    },
+    // ─── FRAMEWORK-SPECIFIC (SHOULD confidence) ─────────────────────────────────
+    // Major frameworks: React, Vue, Angular, Svelte, Next.js, Nuxt, etc.
+    {
+        pattern: /\b(React|Vue|Angular|Svelte|Next\.js|Nuxt|Ember\.js|Astro|Remix|SolidJS)\b/i,
+        trigger: WebResearchTriggerType.FRAMEWORK_SPECIFIC,
+        confidence: "should",
+    },
+    // Node.js, Python, Go, Rust version references
+    {
+        pattern: /\b(Node\.js|Python|Go|Rust|Java|C#)\s+(\d+|LTS|latest)\b/i,
+        trigger: WebResearchTriggerType.FRAMEWORK_SPECIFIC,
+        confidence: "should",
+    },
+    // Popular packages: TypeScript, Webpack, Vitest, Playwright, etc.
+    {
+        pattern: /\b(TypeScript|Webpack|Vite|Turbopack|Playwright|Cypress|Jest|Vitest|ESLint|Prettier)\b/i,
+        trigger: WebResearchTriggerType.FRAMEWORK_SPECIFIC,
+        confidence: "should",
+    },
+    // ─── DATE-SENSITIVE QUERIES (MUST confidence) ─────────────────────────────
+    // "breaking changes", "what changed", "deprecat*"
+    {
+        pattern: /\b(breaking\s+changes|what\s+changed|deprecat\w+|removed\s+in)\b/i,
+        trigger: WebResearchTriggerType.DATE_SENSITIVE,
+        confidence: "must",
+    },
+    // "what's new", "what's the latest", "anything new"
+    {
+        pattern: /\b(what'?s\s+new|what'?s\s+the\s+latest|anything\s+new)\b/i,
+        trigger: WebResearchTriggerType.DATE_SENSITIVE,
+        confidence: "must",
+    },
+    // "current best practice", "modern approach", "in 2024"
+    {
+        pattern: /\b(current\s+best\s+practice|modern\s+approach|modern\s+way|best\s+way\s+to)\b/i,
+        trigger: WebResearchTriggerType.DATE_SENSITIVE,
+        confidence: "should",
+    },
+    // ─── LIBRARY/PACKAGE UPDATES (SHOULD confidence) ──────────────────────────
+    // "npm", "package.json", "dependencies", "updates"
+    {
+        pattern: /\b(npm\s+update|package\s+update|latest\s+version|new\s+release)\b/i,
+        trigger: WebResearchTriggerType.LIBRARY_UPDATE,
+        confidence: "should",
+    },
+    // ─── BEST PRACTICES (SHOULD confidence) ────────────────────────────────────
+    // "best practice for X", "recommended way to"
+    {
+        pattern: /\b(best\s+practice|best\s+way|recommended\s+way|recommended\s+approach)\b/i,
+        trigger: WebResearchTriggerType.BEST_PRACTICES,
+        confidence: "should",
+    },
+    // ─── CURRENT STATUS (SHOULD confidence) ────────────────────────────────────
+    // "is X still maintained", "is X still supported", "does X still work"
+    {
+        pattern: /\b(is\s+.*\s+(still\s+)?(maintained|supported|used|working|active))\b/i,
+        trigger: WebResearchTriggerType.CURRENT_STATUS,
+        confidence: "should",
+    },
+    // "dead project", "abandoned", "no longer maintained"
+    {
+        pattern: /\b(dead\s+project|abandoned|no\s+longer\s+maintained|unmaintained)\b/i,
+        trigger: WebResearchTriggerType.CURRENT_STATUS,
+        confidence: "should",
+    },
+];
+/**
+ * Detects if a user message indicates web research is needed.
+ *
+ * Strategy:
+ * 1. Check for "MUST" confidence triggers first (version checks, breaking changes)
+ * 2. If not found, check "SHOULD" triggers (frameworks, best practices)
+ * 3. If not found, return "MAYBE" or null
+ *
+ * @param userMessage - The user's input message
+ * @returns Detection result with trigger and confidence level
+ */
+export function detectWebResearchNeeded(userMessage) {
+    // Normalize the input
+    const message = userMessage.toLowerCase().trim();
+    // Avoid obvious false positives
+    // "my latest project" should not trigger on "latest"
+    // "design document" should not trigger as "design"
+    const isFalsePositive = (text) => {
+        // Very short messages probably don't need web research
+        if (text.length < 10)
+            return true;
+        // Avoid false positives from common phrases
+        const falsePositivePhrases = [
+            /\bmy\s+latest\s+/i, // "my latest project"
+            /\bthe\s+latest\s+trends\b/i, // "the latest trends"
+            /\bliterally\s+/i, // "literally latest"
+        ];
+        return falsePositivePhrases.some(phrase => phrase.test(text));
+    };
+    if (isFalsePositive(message)) {
+        return { trigger: null, confidence: "maybe" };
+    }
+    // Collect all matches with their confidence levels
+    let bestMatch = null;
+    let bestConfidenceLevel = 0; // must = 3, should = 2, maybe = 1
+    const confidenceLevels = { must: 3, should: 2, maybe: 1 };
+    for (const { pattern, trigger, confidence } of TRIGGER_PATTERNS) {
+        if (pattern.test(message)) {
+            const match = message.match(pattern);
+            const confidenceValue = confidenceLevels[confidence];
+            // Keep the match with the highest confidence level
+            if (confidenceValue > bestConfidenceLevel) {
+                bestConfidenceLevel = confidenceValue;
+                bestMatch = {
+                    trigger: {
+                        type: trigger,
+                        pattern: match?.[0] || "",
+                        context: extractContext(message, match?.[0]),
+                    },
+                    confidence,
+                };
+            }
+        }
+    }
+    if (bestMatch) {
+        return {
+            ...bestMatch,
+            reason: bestMatch.confidence === "must"
+                ? `Found strong indicator: "${bestMatch.trigger.pattern}"`
+                : `Found indicator: "${bestMatch.trigger.pattern}"`,
+        };
+    }
+    // No triggers found, but check if message is asking about current/new information
+    // This gives us a low "maybe" confidence for general queries
+    if (/\b(how|what|why|when|where|which)\b/i.test(message)) {
+        return {
+            trigger: null,
+            confidence: "maybe",
+            reason: "Generic question detected",
+        };
+    }
+    return { trigger: null, confidence: "maybe" };
+}
+/**
+ * Extracts context around a matched pattern for informational purposes.
+ * @param text - The full text
+ * @param pattern - The matched pattern
+ * @returns A substring with context (up to 80 chars)
+ */
+function extractContext(text, pattern) {
+    if (!pattern)
+        return undefined;
+    const index = text.indexOf(pattern);
+    if (index === -1)
+        return undefined;
+    const start = Math.max(0, index - 20);
+    const end = Math.min(text.length, index + pattern.length + 20);
+    const context = text.substring(start, end).trim();
+    return context.length <= 80 ? context : context.substring(0, 77) + "...";
+}
+//# sourceMappingURL=web-research-detector.js.map

package/dist/hooks/web-research-detector.js.map

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

package/dist/hooks/web-research-hook.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Web Research Detector Hook
+ *
+ * PreToolUse hook that detects when user messages indicate a need for web research.
+ * Injects system context reminding agents about enforcing current knowledge.
+ *
+ * When triggered, it warns the agent that web research may be needed and suggests
+ * searching for current information before providing answers.
+ */
+export declare const WEB_RESEARCH_DETECTOR_HOOK_SCRIPT = "#!/usr/bin/env bash\n# oh-my-claudecode: Web Research Detector PreToolUse Hook\n# Fires on tool use to detect web research needs and inject enforcement context.\n\nset -euo pipefail\n\nCLAUDE_API_PROMPT=\"${CLAUDE_API_PROMPT:-}\"\n\n# Extract a simple heuristic from the prompt: look for version patterns or date-sensitive keywords\n# This is a bash-level heuristic that doesn't need the full TypeScript detector\n\n# Check for version patterns: v1.0, 2024, latest, etc.\nif echo \"$CLAUDE_API_PROMPT\" | grep -qiE '\\b(v[0-9]+\\.[0-9]+|20[0-9]{2}|latest\\s+(version|release|update)|breaking\\s+changes|what.?s\\s+new)\\b'; then\n  echo \"[WEB RESEARCH ENFORCEMENT]\"\n  echo \"Detected request that may require current knowledge (version check, date-sensitive info).\"\n  echo \"If you don't have current information available, consider:\"\n  echo \"  1. Using WebSearch to find the latest information\"\n  echo \"  2. Checking official documentation for the most recent updates\"\n  echo \"  3. Being explicit about knowledge cutoff limitations\"\n  echo \"\"\nfi\n";
+export declare function getWebResearchDetectorHookConfig(): object;
+//# sourceMappingURL=web-research-hook.d.ts.map

package/dist/hooks/web-research-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-research-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/web-research-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,iCAAiC,gjCAqB7C,CAAA;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAUzD"}