@phuetz/code-buddy 0.1.18 → 0.1.20

package/dist/git/worktree-sessions.js

@@ -0,0 +1,93 @@
+/**
+ * Worktree Multi-Session Manager
+ *
+ * Links git worktrees to Code Buddy sessions for parallel branch work.
+ * Singleton pattern for global coordination.
+ */
+import { execSync } from 'child_process';
+import * as path from 'path';
+import * as fs from 'fs';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// WorktreeSessionManager
+// ============================================================================
+export class WorktreeSessionManager {
+    static instance = null;
+    sessions = new Map();
+    constructor() {
+        logger.debug('WorktreeSessionManager initialized');
+    }
+    static getInstance() {
+        if (!WorktreeSessionManager.instance) {
+            WorktreeSessionManager.instance = new WorktreeSessionManager();
+        }
+        return WorktreeSessionManager.instance;
+    }
+    static resetInstance() {
+        WorktreeSessionManager.instance = null;
+    }
+    createWorktreeSession(branch, basePath) {
+        const worktreePath = path.join(basePath, '.worktrees', branch);
+        // Create the worktree directory
+        fs.mkdirSync(path.dirname(worktreePath), { recursive: true });
+        try {
+            execSync(`git worktree add "${worktreePath}" "${branch}"`, {
+                cwd: basePath,
+                stdio: 'pipe',
+            });
+        }
+        catch (err) {
+            // If worktree already exists or branch doesn't exist, create with -b
+            try {
+                execSync(`git worktree add -b "${branch}" "${worktreePath}"`, {
+                    cwd: basePath,
+                    stdio: 'pipe',
+                });
+            }
+            catch (innerErr) {
+                logger.warn(`Failed to create worktree for ${branch}`);
+                throw innerErr;
+            }
+        }
+        const session = {
+            branch,
+            worktreePath,
+            sessionId: `wt-${branch}-${Date.now()}`,
+            createdAt: Date.now(),
+        };
+        this.sessions.set(branch, session);
+        logger.info(`Worktree session created: ${branch} at ${worktreePath}`);
+        return session;
+    }
+    listWorktreeSessions() {
+        return Array.from(this.sessions.values());
+    }
+    getSessionForWorktree(worktreePath) {
+        for (const session of this.sessions.values()) {
+            if (session.worktreePath === worktreePath) {
+                return session;
+            }
+        }
+        return undefined;
+    }
+    cleanupWorktree(branch) {
+        const session = this.sessions.get(branch);
+        if (!session)
+            return false;
+        try {
+            execSync(`git worktree remove "${session.worktreePath}" --force`, {
+                stdio: 'pipe',
+            });
+        }
+        catch {
+            logger.warn(`Failed to remove worktree for ${branch}`);
+        }
+        this.sessions.delete(branch);
+        logger.info(`Worktree session cleaned up: ${branch}`);
+        return true;
+    }
+    isWorktreeActive(branch) {
+        return this.sessions.has(branch);
+    }
+}
+//# sourceMappingURL=worktree-sessions.js.map

package/dist/git/worktree-sessions.js.map

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

package/dist/hooks/advanced-hooks.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Advanced Hook System
+ *
+ * Extends the basic hook system with Claude Code-like capabilities:
+ * - Command hooks: run shell commands, parse JSON stdout for decisions
+ * - Prompt hooks: LLM-evaluated hooks (stub - returns allow with stored prompt)
+ * - Agent hooks: spawns subagent evaluation (stub - returns allow)
+ *
+ * Supports event matching with regex matchers, async fire-and-forget,
+ * one-shot hooks, and a registry for CRUD operations.
+ */
+export type AdvancedHookType = 'command' | 'prompt' | 'agent';
+export declare enum HookEvent {
+    PreToolUse = "PreToolUse",
+    PostToolUse = "PostToolUse",
+    PreBash = "PreBash",
+    PostBash = "PostBash",
+    PreEdit = "PreEdit",
+    PostEdit = "PostEdit",
+    SessionStart = "SessionStart",
+    SessionEnd = "SessionEnd",
+    PreCompact = "PreCompact",
+    Notification = "Notification",
+    SubagentStart = "SubagentStart",
+    SubagentStop = "SubagentStop",
+    PermissionRequest = "PermissionRequest",
+    TaskCompleted = "TaskCompleted"
+}
+export interface AdvancedHook {
+    name: string;
+    event: HookEvent;
+    type: AdvancedHookType;
+    matcher?: RegExp;
+    command?: string;
+    prompt?: string;
+    async?: boolean;
+    once?: boolean;
+}
+export interface HookDecision {
+    action: 'allow' | 'deny' | 'ask';
+    updatedInput?: Record<string, unknown>;
+    additionalContext?: string;
+    continue?: boolean;
+}
+export interface HookContext {
+    event: HookEvent;
+    toolName?: string;
+    input?: Record<string, unknown>;
+    output?: unknown;
+    [key: string]: unknown;
+}
+export declare class AdvancedHookRunner {
+    private workingDirectory;
+    private timeout;
+    constructor(workingDirectory?: string, timeout?: number);
+    /**
+     * Run a hook and return a decision
+     */
+    runHook(hook: AdvancedHook, context: HookContext): Promise<HookDecision>;
+    /**
+     * Fire-and-forget async hook execution
+     */
+    runHookAsync(hook: AdvancedHook, context: HookContext): Promise<void>;
+    /**
+     * Check if a hook matches a given event and optional tool name
+     */
+    matchesEvent(hook: AdvancedHook, event: HookEvent, toolName?: string): boolean;
+    private runCommandHook;
+    private runPromptHook;
+    private runAgentHook;
+}
+export declare class HookRegistry {
+    private hooks;
+    private firedOnceHooks;
+    /**
+     * Add a hook to the registry
+     */
+    addHook(hook: AdvancedHook): void;
+    /**
+     * Remove a hook by name
+     */
+    removeHook(name: string): boolean;
+    /**
+     * Get all hooks that match a given event, filtering out already-fired once hooks
+     */
+    getHooksForEvent(event: HookEvent, toolName?: string): AdvancedHook[];
+    /**
+     * Mark a once hook as fired
+     */
+    markFired(hookName: string): void;
+    /**
+     * List all registered hooks
+     */
+    listHooks(): AdvancedHook[];
+    /**
+     * Get a hook by name
+     */
+    getHook(name: string): AdvancedHook | undefined;
+    /**
+     * Clear all hooks
+     */
+    clear(): void;
+    /**
+     * Get the number of registered hooks
+     */
+    get size(): number;
+}
+export declare function getHookRegistry(): HookRegistry;
+export declare function getAdvancedHookRunner(workingDirectory?: string): AdvancedHookRunner;
+export declare function resetAdvancedHooks(): void;

package/dist/hooks/advanced-hooks.js

@@ -0,0 +1,256 @@
+/**
+ * Advanced Hook System
+ *
+ * Extends the basic hook system with Claude Code-like capabilities:
+ * - Command hooks: run shell commands, parse JSON stdout for decisions
+ * - Prompt hooks: LLM-evaluated hooks (stub - returns allow with stored prompt)
+ * - Agent hooks: spawns subagent evaluation (stub - returns allow)
+ *
+ * Supports event matching with regex matchers, async fire-and-forget,
+ * one-shot hooks, and a registry for CRUD operations.
+ */
+import { spawn } from 'child_process';
+import { logger } from '../utils/logger.js';
+export var HookEvent;
+(function (HookEvent) {
+    HookEvent["PreToolUse"] = "PreToolUse";
+    HookEvent["PostToolUse"] = "PostToolUse";
+    HookEvent["PreBash"] = "PreBash";
+    HookEvent["PostBash"] = "PostBash";
+    HookEvent["PreEdit"] = "PreEdit";
+    HookEvent["PostEdit"] = "PostEdit";
+    HookEvent["SessionStart"] = "SessionStart";
+    HookEvent["SessionEnd"] = "SessionEnd";
+    HookEvent["PreCompact"] = "PreCompact";
+    HookEvent["Notification"] = "Notification";
+    HookEvent["SubagentStart"] = "SubagentStart";
+    HookEvent["SubagentStop"] = "SubagentStop";
+    HookEvent["PermissionRequest"] = "PermissionRequest";
+    HookEvent["TaskCompleted"] = "TaskCompleted";
+})(HookEvent || (HookEvent = {}));
+// ============================================================================
+// AdvancedHookRunner
+// ============================================================================
+export class AdvancedHookRunner {
+    workingDirectory;
+    timeout;
+    constructor(workingDirectory = process.cwd(), timeout = 30000) {
+        this.workingDirectory = workingDirectory;
+        this.timeout = timeout;
+    }
+    /**
+     * Run a hook and return a decision
+     */
+    async runHook(hook, context) {
+        switch (hook.type) {
+            case 'command':
+                return this.runCommandHook(hook, context);
+            case 'prompt':
+                return this.runPromptHook(hook, context);
+            case 'agent':
+                return this.runAgentHook(hook, context);
+            default:
+                logger.warn(`Unknown hook type: ${hook.type}`, { source: 'AdvancedHookRunner' });
+                return { action: 'allow' };
+        }
+    }
+    /**
+     * Fire-and-forget async hook execution
+     */
+    async runHookAsync(hook, context) {
+        this.runHook(hook, context).catch((error) => {
+            logger.warn(`Async hook "${hook.name}" failed: ${error}`, { source: 'AdvancedHookRunner' });
+        });
+    }
+    /**
+     * Check if a hook matches a given event and optional tool name
+     */
+    matchesEvent(hook, event, toolName) {
+        if (hook.event !== event) {
+            return false;
+        }
+        if (hook.matcher && toolName) {
+            return hook.matcher.test(toolName);
+        }
+        // If no matcher, match all tools for that event
+        if (!hook.matcher) {
+            return true;
+        }
+        // Has matcher but no toolName provided - no match
+        return false;
+    }
+    async runCommandHook(hook, context) {
+        if (!hook.command) {
+            logger.warn(`Command hook "${hook.name}" has no command`, { source: 'AdvancedHookRunner' });
+            return { action: 'allow' };
+        }
+        return new Promise((resolve) => {
+            let timedOut = false;
+            const child = spawn(hook.command, [], {
+                cwd: this.workingDirectory,
+                shell: true,
+                env: {
+                    ...process.env,
+                    HOOK_EVENT: context.event,
+                    HOOK_TOOL: context.toolName || '',
+                    HOOK_INPUT: JSON.stringify(context.input || {}),
+                },
+            });
+            let stdout = '';
+            let stderr = '';
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+            }, this.timeout);
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                clearTimeout(timeoutId);
+                if (timedOut) {
+                    logger.warn(`Command hook "${hook.name}" timed out`, { source: 'AdvancedHookRunner' });
+                    resolve({ action: 'allow' });
+                    return;
+                }
+                if (code !== 0) {
+                    logger.warn(`Command hook "${hook.name}" exited with code ${code}: ${stderr}`, { source: 'AdvancedHookRunner' });
+                    resolve({ action: 'allow' });
+                    return;
+                }
+                try {
+                    const decision = JSON.parse(stdout.trim());
+                    if (decision.action && ['allow', 'deny', 'ask'].includes(decision.action)) {
+                        resolve(decision);
+                    }
+                    else {
+                        logger.warn(`Command hook "${hook.name}" returned invalid action`, { source: 'AdvancedHookRunner' });
+                        resolve({ action: 'allow' });
+                    }
+                }
+                catch {
+                    // Non-JSON output: if exit code 0, allow; non-zero handled above
+                    resolve({ action: 'allow' });
+                }
+            });
+            child.on('error', (error) => {
+                clearTimeout(timeoutId);
+                logger.warn(`Command hook "${hook.name}" failed: ${error.message}`, { source: 'AdvancedHookRunner' });
+                resolve({ action: 'allow' });
+            });
+        });
+    }
+    async runPromptHook(hook, _context) {
+        // Stub: returns allow with the prompt text stored as additional context
+        logger.debug(`Prompt hook "${hook.name}" evaluated (stub)`, { source: 'AdvancedHookRunner' });
+        return {
+            action: 'allow',
+            additionalContext: hook.prompt || undefined,
+        };
+    }
+    async runAgentHook(hook, _context) {
+        // Stub: returns allow
+        logger.debug(`Agent hook "${hook.name}" evaluated (stub)`, { source: 'AdvancedHookRunner' });
+        return { action: 'allow' };
+    }
+}
+// ============================================================================
+// HookRegistry
+// ============================================================================
+export class HookRegistry {
+    hooks = new Map();
+    firedOnceHooks = new Set();
+    /**
+     * Add a hook to the registry
+     */
+    addHook(hook) {
+        this.hooks.set(hook.name, hook);
+        logger.debug(`Hook "${hook.name}" registered for event ${hook.event}`, { source: 'HookRegistry' });
+    }
+    /**
+     * Remove a hook by name
+     */
+    removeHook(name) {
+        const deleted = this.hooks.delete(name);
+        this.firedOnceHooks.delete(name);
+        if (deleted) {
+            logger.debug(`Hook "${name}" removed`, { source: 'HookRegistry' });
+        }
+        return deleted;
+    }
+    /**
+     * Get all hooks that match a given event, filtering out already-fired once hooks
+     */
+    getHooksForEvent(event, toolName) {
+        const runner = new AdvancedHookRunner();
+        const matching = [];
+        for (const hook of this.hooks.values()) {
+            // Skip once hooks that already fired
+            if (hook.once && this.firedOnceHooks.has(hook.name)) {
+                continue;
+            }
+            if (runner.matchesEvent(hook, event, toolName)) {
+                matching.push(hook);
+            }
+        }
+        return matching;
+    }
+    /**
+     * Mark a once hook as fired
+     */
+    markFired(hookName) {
+        const hook = this.hooks.get(hookName);
+        if (hook?.once) {
+            this.firedOnceHooks.add(hookName);
+        }
+    }
+    /**
+     * List all registered hooks
+     */
+    listHooks() {
+        return Array.from(this.hooks.values());
+    }
+    /**
+     * Get a hook by name
+     */
+    getHook(name) {
+        return this.hooks.get(name);
+    }
+    /**
+     * Clear all hooks
+     */
+    clear() {
+        this.hooks.clear();
+        this.firedOnceHooks.clear();
+    }
+    /**
+     * Get the number of registered hooks
+     */
+    get size() {
+        return this.hooks.size;
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let registryInstance = null;
+let runnerInstance = null;
+export function getHookRegistry() {
+    if (!registryInstance) {
+        registryInstance = new HookRegistry();
+    }
+    return registryInstance;
+}
+export function getAdvancedHookRunner(workingDirectory) {
+    if (!runnerInstance || workingDirectory) {
+        runnerInstance = new AdvancedHookRunner(workingDirectory);
+    }
+    return runnerInstance;
+}
+export function resetAdvancedHooks() {
+    registryInstance = null;
+    runnerInstance = null;
+}
+//# sourceMappingURL=advanced-hooks.js.map

package/dist/hooks/advanced-hooks.js.map

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

package/dist/hooks/async-hooks.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Async Hook Manager
+ *
+ * Manages asynchronous hook execution with concurrency control,
+ * job tracking, and result collection. Completed hook results
+ * can be injected as system messages into the next conversation turn.
+ */
+import type { SmartHookConfig, SmartHookResult } from './smart-hooks.js';
+export type AsyncHookStatus = 'running' | 'completed' | 'failed' | 'timeout' | 'cancelled';
+export interface AsyncHookJob {
+    /** Unique job ID */
+    id: string;
+    /** Hook configuration */
+    hookConfig: SmartHookConfig;
+    /** Input data */
+    input: Record<string, any>;
+    /** Start timestamp */
+    startTime: number;
+    /** Current status */
+    status: AsyncHookStatus;
+    /** Result (when completed) */
+    result?: SmartHookResult;
+    /** Error message (when failed) */
+    error?: string;
+}
+export declare class AsyncHookManager {
+    private jobs;
+    private maxConcurrent;
+    private runner;
+    private completedSinceLastCheck;
+    private cancelTokens;
+    constructor(maxConcurrent?: number);
+    /**
+     * Submit an async hook for execution
+     */
+    submit(hook: SmartHookConfig, input: Record<string, any>): string;
+    /**
+     * Execute a job asynchronously
+     */
+    private executeJob;
+    /**
+     * Get a job by ID
+     */
+    getJob(jobId: string): AsyncHookJob | null;
+    /**
+     * Get all jobs completed since the last call to this method
+     */
+    getCompletedJobs(): AsyncHookJob[];
+    /**
+     * Get results formatted as system messages for the next conversation turn
+     */
+    getSystemMessages(): string[];
+    /**
+     * Clear all completed/failed jobs
+     */
+    clearCompleted(): void;
+    /**
+     * Cancel a running job
+     */
+    cancel(jobId: string): boolean;
+    /**
+     * Get the number of currently running jobs
+     */
+    getRunningCount(): number;
+    /**
+     * Get the total number of tracked jobs
+     */
+    getTotalCount(): number;
+    /**
+     * Dispose of all jobs and clean up
+     */
+    dispose(): void;
+}