@stanco323/oh-my-claude-code 4.10.3

package/dist/installer/hooks.js

@@ -0,0 +1,448 @@
+/**
+ * Hook Scripts for Claude Code
+ * Hook system inspired by oh-my-opencode, adapted for Claude Code's native hooks
+ *
+ * Claude Code hooks are configured in settings.json and run as shell commands.
+ * These scripts receive JSON input via stdin and output JSON to modify behavior.
+ *
+ * This module provides Node.js scripts (.mjs) for cross-platform support (Windows, macOS, Linux).
+ * Bash scripts were deprecated in v3.8.6 and removed in v3.9.0.
+ */
+import { join, dirname } from "path";
+import { readFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { getConfigDir } from '../utils/config-dir.js';
+// =============================================================================
+// TEMPLATE LOADER (loads hook scripts from templates/hooks/)
+// =============================================================================
+/**
+ * Get the package root directory (where templates/ lives)
+ * Works for both development (src/), production (dist/), and CJS bundles (bridge/).
+ * When esbuild bundles to CJS, import.meta is replaced with {} so we
+ * fall back to __dirname which is natively available in CJS.
+ */
+function getPackageDir() {
+    // CJS bundle path (bridge/cli.cjs): from bridge/ go up 1 level to package root
+    if (typeof __dirname !== "undefined") {
+        return join(__dirname, "..");
+    }
+    // ESM path (works in dev via ts/dist)
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        // From src/installer/ or dist/installer/, go up two levels to package root
+        return join(__dirname, "..", "..");
+    }
+    catch {
+        // import.meta.url unavailable — last resort
+        return process.cwd();
+    }
+}
+/**
+ * Load a hook template file from templates/hooks/
+ * @param filename - The template filename (e.g., 'keyword-detector.sh')
+ * @returns The template content
+ * @throws If the template file is not found
+ */
+function loadTemplate(filename) {
+    const templatePath = join(getPackageDir(), "templates", "hooks", filename);
+    if (!existsSync(templatePath)) {
+        // .sh templates have been removed in favor of .mjs - return empty string for missing bash templates
+        return "";
+    }
+    return readFileSync(templatePath, "utf-8");
+}
+// =============================================================================
+// CONSTANTS AND UTILITIES
+// =============================================================================
+/** Minimum required Node.js version for hooks (must match package.json engines) */
+export const MIN_NODE_VERSION = 20;
+/** Check if running on Windows */
+export function isWindows() {
+    return process.platform === "win32";
+}
+/** Get the Claude config directory path (cross-platform) */
+export function getClaudeConfigDir() {
+    return getConfigDir();
+}
+/** Get the hooks directory path */
+export function getHooksDir() {
+    return join(getClaudeConfigDir(), "hooks");
+}
+/**
+ * Get the home directory environment variable for hook commands.
+ * Returns the appropriate syntax for the current platform.
+ */
+export function getHomeEnvVar() {
+    return isWindows() ? "%USERPROFILE%" : "$HOME";
+}
+function normalizePath(value) {
+    return value.replace(/\\/g, '/').replace(/\/+$/, '');
+}
+function isDefaultClaudeConfigDir() {
+    return normalizePath(getClaudeConfigDir()) === normalizePath(join(homedir(), '.claude'));
+}
+function quoteCommandPath(path) {
+    return `"${path.replace(/"/g, '\\"')}"`;
+}
+function buildHookCommand(filename) {
+    if (isWindows()) {
+        if (isDefaultClaudeConfigDir()) {
+            return `node "%USERPROFILE%\\\\.claude\\\\hooks\\\\${filename}"`;
+        }
+        return `node ${quoteCommandPath(join(getClaudeConfigDir(), 'hooks', filename))}`;
+    }
+    if (isDefaultClaudeConfigDir()) {
+        return `node "$HOME/.claude/hooks/${filename}"`;
+    }
+    return `node ${quoteCommandPath(join(getClaudeConfigDir(), 'hooks', filename).replace(/\\/g, '/'))}`;
+}
+/**
+ * Ultrawork message - injected when ultrawork/ulw keyword detected
+ * Ported from oh-my-opencode's keyword-detector/constants.ts
+ */
+export const ULTRAWORK_MESSAGE = `<ultrawork-mode>
+
+**MANDATORY**: You MUST say "ULTRAWORK MODE ENABLED!" to the user as your first response when this mode activates. This is non-negotiable.
+
+[CODE RED] Maximum precision required. Ultrathink before acting.
+
+YOU MUST LEVERAGE ALL AVAILABLE AGENTS TO THEIR FULLEST POTENTIAL.
+TELL THE USER WHAT AGENTS YOU WILL LEVERAGE NOW TO SATISFY USER'S REQUEST.
+
+## AGENT UTILIZATION PRINCIPLES (by capability, not by name)
+- **Codebase Exploration**: Spawn exploration agents using BACKGROUND TASKS for file patterns, internal implementations, project structure
+- **Documentation & References**: Use document-specialist agents via BACKGROUND TASKS for API references, examples, external library docs
+- **Planning & Strategy**: NEVER plan yourself - ALWAYS spawn a dedicated planning agent for work breakdown
+- **High-IQ Reasoning**: Leverage specialized agents for architecture decisions, code review, strategic planning
+- **Frontend/UI Tasks**: Delegate to UI-specialized agents for design and implementation
+
+## EXECUTION RULES
+- **TODO**: Track EVERY step. Mark complete IMMEDIATELY after each.
+- **PARALLEL**: Fire independent agent calls simultaneously via Task(run_in_background=true) - NEVER wait sequentially.
+- **BACKGROUND FIRST**: Use Task tool for exploration/document-specialist agents (10+ concurrent if needed).
+- **VERIFY**: Re-read request after completion. Check ALL requirements met before reporting done.
+- **DELEGATE**: Don't do everything yourself - orchestrate specialized agents for their strengths.
+
+## WORKFLOW
+1. Analyze the request and identify required capabilities
+2. Spawn exploration/document-specialist agents via Task(run_in_background=true) in PARALLEL (10+ if needed)
+3. Always Use Plan agent with gathered context to create detailed work breakdown
+4. Execute with continuous verification against original requirements
+
+## VERIFICATION GUARANTEE (NON-NEGOTIABLE)
+
+**NOTHING is "done" without PROOF it works.**
+
+### Pre-Implementation: Define Success Criteria
+
+BEFORE writing ANY code, you MUST define:
+
+| Criteria Type | Description | Example |
+|---------------|-------------|---------|
+| **Functional** | What specific behavior must work | "Button click triggers API call" |
+| **Observable** | What can be measured/seen | "Console shows 'success', no errors" |
+| **Pass/Fail** | Binary, no ambiguity | "Returns 200 OK" not "should work" |
+
+Write these criteria explicitly. Share with user if scope is non-trivial.
+
+### Execution & Evidence Requirements
+
+| Phase | Action | Required Evidence |
+|-------|--------|-------------------|
+| **Build** | Run build command | Exit code 0, no errors |
+| **Test** | Execute test suite | All tests pass (screenshot/output) |
+| **Manual Verify** | Test the actual feature | Demonstrate it works (describe what you observed) |
+| **Regression** | Ensure nothing broke | Existing tests still pass |
+
+**WITHOUT evidence = NOT verified = NOT done.**
+
+### TDD Workflow (when test infrastructure exists)
+
+1. **SPEC**: Define what "working" means (success criteria above)
+2. **RED**: Write failing test -> Run it -> Confirm it FAILS
+3. **GREEN**: Write minimal code -> Run test -> Confirm it PASSES
+4. **REFACTOR**: Clean up -> Tests MUST stay green
+5. **VERIFY**: Run full test suite, confirm no regressions
+6. **EVIDENCE**: Report what you ran and what output you saw
+
+### Verification Anti-Patterns (BLOCKING)
+
+| Violation | Why It Fails |
+|-----------|--------------|
+| "It should work now" | No evidence. Run it. |
+| "I added the tests" | Did they pass? Show output. |
+| "Fixed the bug" | How do you know? What did you test? |
+| "Implementation complete" | Did you verify against success criteria? |
+| Skipping test execution | Tests exist to be RUN, not just written |
+
+**CLAIM NOTHING WITHOUT PROOF. EXECUTE. VERIFY. SHOW EVIDENCE.**
+
+## ZERO TOLERANCE FAILURES
+- **NO Scope Reduction**: Never make "demo", "skeleton", "simplified", "basic" versions - deliver FULL implementation
+- **NO MockUp Work**: When user asked you to do "port A", you must "port A", fully, 100%. No Extra feature, No reduced feature, no mock data, fully working 100% port.
+- **NO Partial Completion**: Never stop at 60-80% saying "you can extend this..." - finish 100%
+- **NO Assumed Shortcuts**: Never skip requirements you deem "optional" or "can be added later"
+- **NO Premature Stopping**: Never declare done until ALL TODOs are completed and verified
+- **NO TEST DELETION**: Never delete or skip failing tests to make the build pass. Fix the code, not the tests.
+
+THE USER ASKED FOR X. DELIVER EXACTLY X. NOT A SUBSET. NOT A DEMO. NOT A STARTING POINT.
+
+</ultrawork-mode>
+
+---
+
+`;
+/**
+ * Ultrathink/Think mode message
+ * Ported from oh-my-opencode's think-mode hook
+ */
+export const ULTRATHINK_MESSAGE = `<think-mode>
+
+**ULTRATHINK MODE ENABLED** - Extended reasoning activated.
+
+You are now in deep thinking mode. Take your time to:
+1. Thoroughly analyze the problem from multiple angles
+2. Consider edge cases and potential issues
+3. Think through the implications of each approach
+4. Reason step-by-step before acting
+
+Use your extended thinking capabilities to provide the most thorough and well-reasoned response.
+
+</think-mode>
+
+---
+
+`;
+/**
+ * Search mode message
+ * Ported from oh-my-opencode's keyword-detector
+ */
+export const SEARCH_MESSAGE = `<search-mode>
+MAXIMIZE SEARCH EFFORT. Launch multiple background agents IN PARALLEL:
+- explore agents (codebase patterns, file structures)
+- document-specialist agents (remote repos, official docs, GitHub examples)
+Plus direct tools: Grep, Glob
+NEVER stop at first result - be exhaustive.
+</search-mode>
+
+---
+
+`;
+/**
+ * Analyze mode message
+ * Ported from oh-my-opencode's keyword-detector
+ */
+export const ANALYZE_MESSAGE = `<analyze-mode>
+ANALYSIS MODE. Gather context before diving deep:
+
+CONTEXT GATHERING (parallel):
+- 1-2 explore agents (codebase patterns, implementations)
+- 1-2 document-specialist agents (if external library involved)
+- Direct tools: Grep, Glob, LSP for targeted searches
+
+IF COMPLEX (architecture, multi-system, debugging after 2+ failures):
+- Consult architect agent for strategic guidance
+
+SYNTHESIZE findings before proceeding.
+</analyze-mode>
+
+---
+
+`;
+/**
+ * Code review mode message
+ * Replaces skills/code-review/SKILL.md after skill deletion
+ */
+export const CODE_REVIEW_MESSAGE = `<code-review-mode>
+[CODE REVIEW MODE ACTIVATED]
+Perform a comprehensive code review of the relevant changes or target area. Focus on correctness, maintainability, edge cases, regressions, and test adequacy before recommending changes.
+</code-review-mode>
+
+---
+
+`;
+/**
+ * Security review mode message
+ * Replaces skills/security-review/SKILL.md after skill deletion
+ */
+export const SECURITY_REVIEW_MESSAGE = `<security-review-mode>
+[SECURITY REVIEW MODE ACTIVATED]
+Perform a focused security review of the relevant changes or target area. Check trust boundaries, auth/authz, data exposure, input validation, command/file access, secrets handling, and escalation risks before recommending changes.
+</security-review-mode>
+
+---
+
+`;
+/**
+ * TDD mode message
+ * Replaces skills/tdd/SKILL.md after skill deletion
+ */
+export const TDD_MESSAGE = `<tdd-mode>
+[TDD MODE ACTIVATED]
+
+THE IRON LAW: NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST.
+Write code before test? DELETE IT. Start over. No exceptions.
+
+RED-GREEN-REFACTOR CYCLE:
+1. RED: Write failing test for NEXT functionality. Run it - MUST FAIL.
+2. GREEN: Write ONLY enough code to pass. No extras. Run test - MUST PASS.
+3. REFACTOR: Clean up. Run tests after EVERY change. Must stay green.
+4. REPEAT with next failing test.
+
+ENFORCEMENT:
+- Code written before test → STOP. Delete code. Write test first.
+- Test passes on first run → Test is wrong. Fix it to fail first.
+- Multiple features in one cycle → STOP. One test, one feature.
+
+Delegate to test-engineer agent for test strategy. The discipline IS the value.
+</tdd-mode>
+
+---
+
+`;
+/**
+ * Todo continuation prompt
+ * Ported from oh-my-opencode's todo-continuation-enforcer
+ */
+export const TODO_CONTINUATION_PROMPT = `[SYSTEM REMINDER - TODO CONTINUATION]
+
+Incomplete tasks remain in your todo list. Continue working on the next pending task.
+
+- Proceed without asking for permission
+- Mark each task complete when finished
+- Do not stop until all tasks are done`;
+/**
+ * Ralph mode message - injected when ralph keyword detected
+ * Auto-activates ultrawork for parallel execution
+ */
+export const RALPH_MESSAGE = `[RALPH + ULTRAWORK MODE ACTIVATED]
+
+Ralph mode auto-activates Ultrawork for maximum parallel execution. Follow these rules:
+
+### Parallel Execution
+- **PARALLEL**: Fire independent calls simultaneously - NEVER wait sequentially
+- **BACKGROUND FIRST**: Use Task(run_in_background=true) for long operations
+- **DELEGATE**: Route tasks to specialist agents immediately
+
+### Completion Requirements
+- Verify ALL requirements from the original task are met
+- Architect verification is MANDATORY before claiming completion
+- When FULLY complete, run \`/oh-my-claudecode:cancel\` to cleanly exit and clean up state files
+
+Continue working until the task is truly done.
+`;
+/**
+ * Prompt translation message - injected when non-English input detected
+ * Reminds users to write prompts in English for consistent agent routing
+ */
+export const PROMPT_TRANSLATION_MESSAGE = `[PROMPT TRANSLATION] Non-English input detected.
+When delegating via Task(), write prompt arguments in English for consistent agent routing.
+Respond to the user in their original language.
+`;
+// =============================================================================
+// NODE.JS HOOK SCRIPTS (Cross-platform: Windows, macOS, Linux)
+// =============================================================================
+/** Node.js keyword detector hook script - loaded from templates/hooks/keyword-detector.mjs */
+export const KEYWORD_DETECTOR_SCRIPT_NODE = loadTemplate("keyword-detector.mjs");
+/** Node.js stop continuation hook script - loaded from templates/hooks/stop-continuation.mjs */
+export const STOP_CONTINUATION_SCRIPT_NODE = loadTemplate("stop-continuation.mjs");
+/** Node.js persistent mode hook script - loaded from templates/hooks/persistent-mode.mjs */
+export const PERSISTENT_MODE_SCRIPT_NODE = loadTemplate("persistent-mode.mjs");
+/** Node.js code simplifier hook script - loaded from templates/hooks/code-simplifier.mjs */
+export const CODE_SIMPLIFIER_SCRIPT_NODE = loadTemplate("code-simplifier.mjs");
+/** Node.js session start hook script - loaded from templates/hooks/session-start.mjs */
+export const SESSION_START_SCRIPT_NODE = loadTemplate("session-start.mjs");
+/** Post-tool-use Node.js script - loaded from templates/hooks/post-tool-use.mjs */
+export const POST_TOOL_USE_SCRIPT_NODE = loadTemplate("post-tool-use.mjs");
+// =============================================================================
+// SETTINGS CONFIGURATION
+// =============================================================================
+/**
+ * Settings.json hooks configuration for Node.js (Cross-platform)
+ * Uses node to run .mjs scripts directly
+ */
+export const HOOKS_SETTINGS_CONFIG_NODE = {
+    hooks: {
+        UserPromptSubmit: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('keyword-detector.mjs'),
+                    },
+                ],
+            },
+        ],
+        SessionStart: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('session-start.mjs'),
+                    },
+                ],
+            },
+        ],
+        PreToolUse: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('pre-tool-use.mjs'),
+                    },
+                ],
+            },
+        ],
+        PostToolUse: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('post-tool-use.mjs'),
+                    },
+                ],
+            },
+        ],
+        PostToolUseFailure: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('post-tool-use-failure.mjs'),
+                    },
+                ],
+            },
+        ],
+        Stop: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('persistent-mode.mjs'),
+                    },
+                ],
+            },
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: buildHookCommand('code-simplifier.mjs'),
+                    },
+                ],
+            },
+        ],
+    },
+};
+/**
+ * Get the hooks settings config (Node.js only).
+ *
+ * @deprecated Hooks are now delivered via the plugin's hooks/hooks.json.
+ * settings.json hook entries are no longer written by the installer.
+ * Kept for test compatibility only.
+ */
+export function getHooksSettingsConfig() {
+    return HOOKS_SETTINGS_CONFIG_NODE;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/installer/hooks.js.map

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

package/dist/installer/index.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Installer Module
+ *
+ * Handles installation of OMC agents, commands, and configuration
+ * into the Claude Code config directory (~/.claude/).
+ *
+ * Cross-platform support via Node.js-based hook scripts (.mjs).
+ * Bash hook scripts were removed in v3.9.0.
+ */
+/** Claude Code configuration directory */
+export declare const CLAUDE_CONFIG_DIR: string;
+export declare const AGENTS_DIR: string;
+export declare const COMMANDS_DIR: string;
+export declare const SKILLS_DIR: string;
+export declare const HOOKS_DIR: string;
+export declare const HUD_DIR: string;
+export declare const SETTINGS_FILE: string;
+export declare const VERSION_FILE: string;
+/**
+ * Core commands - DISABLED for v3.0+
+ * All commands are now plugin-scoped skills managed by Claude Code.
+ * The installer no longer copies commands to ~/.claude/commands/
+ */
+export declare const CORE_COMMANDS: string[];
+/** Current version */
+export declare const VERSION: string;
+/** Installation result */
+export interface InstallResult {
+    success: boolean;
+    message: string;
+    installedAgents: string[];
+    installedCommands: string[];
+    installedSkills: string[];
+    hooksConfigured: boolean;
+    hookConflicts: Array<{
+        eventType: string;
+        existingCommand: string;
+    }>;
+    errors: string[];
+}
+/** Installation options */
+export interface InstallOptions {
+    force?: boolean;
+    version?: string;
+    verbose?: boolean;
+    skipClaudeCheck?: boolean;
+    forceHooks?: boolean;
+    refreshHooksInPlugin?: boolean;
+    skipHud?: boolean;
+}
+/**
+ * Read hudEnabled from .omc-config.json without importing auto-update
+ * (avoids circular dependency since auto-update imports from installer)
+ */
+export declare function isHudEnabledInConfig(): boolean;
+/**
+ * Detect whether a statusLine config belongs to oh-my-claudecode.
+ *
+ * Checks the command string for known OMC HUD paths so that custom
+ * (non-OMC) statusLine configurations are preserved during forced
+ * updates/reconciliation.
+ *
+ * @param statusLine - The statusLine setting object from settings.json
+ * @returns true if the statusLine was set by OMC
+ */
+export declare function isOmcStatusLine(statusLine: unknown): boolean;
+/**
+ * Detect whether a hook command belongs to oh-my-claudecode.
+ *
+ * Recognition strategy (any match is sufficient):
+ * 1. Command path contains "omc" as a path/word segment (e.g. `omc-hook.mjs`, `/omc/`)
+ * 2. Command path contains "oh-my-claudecode"
+ * 3. Command references a known OMC hook filename inside .claude/hooks/
+ *
+ * @param command - The hook command string
+ * @returns true if the command belongs to OMC
+ */
+export declare function isOmcHook(command: string): boolean;
+/**
+ * Check if the current Node.js version meets the minimum requirement
+ */
+export declare function checkNodeVersion(): {
+    valid: boolean;
+    current: number;
+    required: number;
+};
+/**
+ * Check if Claude Code is installed
+ * Uses 'where' on Windows, 'which' on Unix
+ */
+export declare function isClaudeInstalled(): boolean;
+/**
+ * Check if we're running in Claude Code plugin context
+ *
+ * When installed as a plugin, we should NOT copy files to ~/.claude/
+ * because the plugin system already handles file access via ${CLAUDE_PLUGIN_ROOT}.
+ *
+ * Detection method:
+ * - Check if CLAUDE_PLUGIN_ROOT environment variable is set (primary method)
+ * - This env var is set by the Claude Code plugin system when running plugin hooks
+ *
+ * @returns true if running in plugin context, false otherwise
+ */
+export declare function isRunningAsPlugin(): boolean;
+/**
+ * Check if we're running as a project-scoped plugin (not global)
+ *
+ * Project-scoped plugins are installed in the project's .claude/plugins/ directory,
+ * while global plugins are installed in ~/.claude/plugins/.
+ *
+ * When project-scoped, we should NOT modify global settings (like ~/.claude/settings.json)
+ * because the user explicitly chose project-level installation.
+ *
+ * @returns true if running as a project-scoped plugin, false otherwise
+ */
+export declare function isProjectScopedPlugin(): boolean;
+export declare function getInstalledOmcPluginRoots(): string[];
+/**
+ * Detect whether an installed Claude Code plugin already provides OMC agent
+ * markdown files, so the legacy ~/.claude/agents copy can be skipped.
+ */
+export declare function hasPluginProvidedAgentFiles(): boolean;
+export declare function getRuntimePackageRoot(): string;
+/**
+ * Extract the embedded OMC version from a CLAUDE.md file.
+ *
+ * Primary source of truth is the injected `<!-- OMC:VERSION:x.y.z -->` marker.
+ * Falls back to legacy headings that may include a version string inline.
+ */
+export declare function extractOmcVersionFromClaudeMd(content: string): string | null;
+/**
+ * Keep persisted setup metadata in sync with the installed OMC runtime version.
+ *
+ * This intentionally updates only already-configured users by default so
+ * installer/reconciliation flows do not accidentally mark fresh installs as if
+ * the interactive setup wizard had been completed.
+ */
+export declare function syncPersistedSetupVersion(options?: {
+    configPath?: string;
+    claudeMdPath?: string;
+    version?: string;
+    onlyIfConfigured?: boolean;
+}): boolean;
+/**
+ * Merge OMC content into existing CLAUDE.md using markers
+ * @param existingContent - Existing CLAUDE.md content (null if file doesn't exist)
+ * @param omcContent - New OMC content to inject
+ * @returns Merged content with markers
+ */
+export declare function mergeClaudeMd(existingContent: string | null, omcContent: string, version?: string): string;
+/**
+ * Install OMC agents, commands, skills, and hooks
+ */
+export declare function install(options?: InstallOptions): InstallResult;
+/**
+ * Check if OMC is already installed
+ */
+export declare function isInstalled(): boolean;
+/**
+ * Get installation info
+ */
+export declare function getInstallInfo(): {
+    version: string;
+    installedAt: string;
+    method: string;
+} | null;
+//# sourceMappingURL=index.d.ts.map

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

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