@cdoing/core 0.1.0

package/dist/context-providers/types.js.map

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

package/dist/context-providers/url.d.ts

@@ -0,0 +1,27 @@
+/**
+ * URL Context Provider — @url
+ *
+ * Fetches a web page and converts it to clean markdown for context.
+ * Reuses the existing web_fetch tool logic under the hood.
+ *
+ * Usage: @url https://docs.example.com/api
+ *
+ * How it works:
+ *   1. User types @url followed by a URL
+ *   2. We fetch the page HTML
+ *   3. Strip tags, scripts, styles → extract readable text
+ *   4. Format as markdown and inject into the conversation
+ *
+ * Learning note: This provider REQUIRES an argument (the URL).
+ * The `requiresArg` flag tells the UI to keep the input open
+ * until the user provides the URL after the @ trigger.
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class UrlContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=url.d.ts.map

package/dist/context-providers/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/context-providers/url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKrF,qBAAa,kBAAmB,YAAW,eAAe;IACxD,EAAE,SAAS;IACX,OAAO,SAAU;IACjB,WAAW,SAAuC;IAClD,WAAW,UAAQ;IAEb,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CA8DrF"}

package/dist/context-providers/url.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * URL Context Provider — @url
+ *
+ * Fetches a web page and converts it to clean markdown for context.
+ * Reuses the existing web_fetch tool logic under the hood.
+ *
+ * Usage: @url https://docs.example.com/api
+ *
+ * How it works:
+ *   1. User types @url followed by a URL
+ *   2. We fetch the page HTML
+ *   3. Strip tags, scripts, styles → extract readable text
+ *   4. Format as markdown and inject into the conversation
+ *
+ * Learning note: This provider REQUIRES an argument (the URL).
+ * The `requiresArg` flag tells the UI to keep the input open
+ * until the user provides the URL after the @ trigger.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlContextProvider = void 0;
+/** Max chars for fetched content */
+const DEFAULT_MAX_CHARS = 15000;
+class UrlContextProvider {
+    id = "url";
+    trigger = "@url";
+    description = "Fetch and attach web page content";
+    requiresArg = true;
+    async resolve(arg, options) {
+        if (!arg || !arg.trim()) {
+            return {
+                label: "URL",
+                content: "[Please provide a URL after @url, e.g.: @url https://docs.example.com]",
+                metadata: { source: "web" },
+            };
+        }
+        const url = arg.trim();
+        const maxChars = options?.maxContentLength ?? DEFAULT_MAX_CHARS;
+        try {
+            // Fetch the URL content
+            const response = await fetch(url, {
+                headers: {
+                    "User-Agent": "Cdoing-Agent/1.0 (Context Fetcher)",
+                    "Accept": "text/html,text/plain,application/json",
+                },
+                signal: AbortSignal.timeout(15000), // 15 second timeout
+            });
+            if (!response.ok) {
+                return {
+                    label: `URL: ${url}`,
+                    content: `[Failed to fetch ${url}: HTTP ${response.status} ${response.statusText}]`,
+                    metadata: { source: "web" },
+                };
+            }
+            const contentType = response.headers.get("content-type") || "";
+            let body = await response.text();
+            // Convert HTML to readable text
+            if (contentType.includes("html")) {
+                body = htmlToText(body);
+            }
+            // Truncate if needed
+            let truncated = false;
+            if (body.length > maxChars) {
+                body = body.substring(0, maxChars);
+                truncated = true;
+            }
+            return {
+                label: `URL: ${url}`,
+                content: `## Web Content: ${url}\n\n${body}${truncated ? "\n\n... [content truncated]" : ""}`,
+                metadata: {
+                    source: url,
+                    truncated,
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                label: `URL: ${url}`,
+                content: `[Error fetching ${url}: ${message}]`,
+                metadata: { source: "web" },
+            };
+        }
+    }
+}
+exports.UrlContextProvider = UrlContextProvider;
+/**
+ * Convert HTML to readable plain text.
+ * Strips tags, scripts, styles, and normalizes whitespace.
+ *
+ * Learning note: This is a simple regex-based approach that works
+ * well enough for most pages. For production, you'd use a proper
+ * HTML parser like cheerio or jsdom.
+ */
+function htmlToText(html) {
+    return html
+        // Remove script and style blocks entirely
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "")
+        .replace(/<noscript[\s\S]*?<\/noscript>/gi, "")
+        // Convert common elements to markdown equivalents
+        .replace(/<h1[^>]*>(.*?)<\/h1>/gi, "\n# $1\n")
+        .replace(/<h2[^>]*>(.*?)<\/h2>/gi, "\n## $1\n")
+        .replace(/<h3[^>]*>(.*?)<\/h3>/gi, "\n### $1\n")
+        .replace(/<h[4-6][^>]*>(.*?)<\/h[4-6]>/gi, "\n#### $1\n")
+        .replace(/<li[^>]*>(.*?)<\/li>/gi, "- $1\n")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<p[^>]*>/gi, "\n")
+        .replace(/<\/p>/gi, "\n")
+        .replace(/<code[^>]*>(.*?)<\/code>/gi, "`$1`")
+        .replace(/<pre[^>]*>(.*?)<\/pre>/gis, "\n```\n$1\n```\n")
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, "[$2]($1)")
+        .replace(/<strong[^>]*>(.*?)<\/strong>/gi, "**$1**")
+        .replace(/<b[^>]*>(.*?)<\/b>/gi, "**$1**")
+        .replace(/<em[^>]*>(.*?)<\/em>/gi, "*$1*")
+        .replace(/<i[^>]*>(.*?)<\/i>/gi, "*$1*")
+        // Strip remaining HTML tags
+        .replace(/<[^>]+>/g, "")
+        // Decode common HTML entities
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        // Normalize whitespace
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=url.js.map

package/dist/context-providers/url.js.map

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

package/dist/effort/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Effort Level Control — Adjusts how deeply the agent analyzes requests.
+ *
+ * Inspired by Claude Code's --effort flag and Cursor's MAX mode.
+ *
+ * Effort levels:
+ *   - low:    Quick responses, minimal analysis. Good for simple questions.
+ *   - medium: Default. Balanced analysis and speed.
+ *   - high:   Deep analysis, reads more files, considers edge cases.
+ *   - max:    Extended thinking, comprehensive analysis, multiple passes.
+ *
+ * How it affects behavior:
+ *   - System prompt instructions change based on level
+ *   - Temperature may be adjusted
+ *   - Token limits are scaled
+ *   - The agent is instructed to use more/fewer tools
+ *
+ * Learning note: This is essentially a UX abstraction over multiple
+ * model parameters. Instead of asking users to tweak temperature,
+ * max tokens, and system prompt, they just say "try harder" or
+ * "be quick about it".
+ */
+/**
+ * Available effort levels, from quickest to most thorough.
+ */
+export type EffortLevel = "low" | "medium" | "high" | "max";
+/**
+ * Configuration values for each effort level.
+ */
+export interface EffortConfig {
+    /** How this level affects the system prompt */
+    systemPromptAddition: string;
+    /** Temperature override (null = use default) */
+    temperature: number | null;
+    /** Max tokens multiplier (1.0 = default) */
+    maxTokensMultiplier: number;
+    /** Max agent turns multiplier */
+    maxTurnsMultiplier: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Manages the current effort level and provides configuration.
+ */
+export declare class EffortManager {
+    private level;
+    /**
+     * Set the effort level.
+     */
+    setLevel(level: EffortLevel): void;
+    /**
+     * Get the current effort level.
+     */
+    getLevel(): EffortLevel;
+    /**
+     * Get the configuration for the current effort level.
+     */
+    getConfig(): EffortConfig;
+    /**
+     * Get the system prompt addition for the current level.
+     * Returns empty string for medium (default) level.
+     */
+    getSystemPromptAddition(): string;
+    /**
+     * Get all available levels with descriptions.
+     * Useful for displaying in help or settings UI.
+     */
+    static getAllLevels(): Array<{
+        level: EffortLevel;
+        description: string;
+    }>;
+    /**
+     * Parse an effort level from a string (case-insensitive).
+     * Returns null if the string is not a valid level.
+     */
+    static parse(input: string): EffortLevel | null;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effort/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAE7B,gDAAgD;IAChD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAE5B,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAsED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAyB;IAEtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAOlC;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;;OAGG;IACH,uBAAuB,IAAI,MAAM;IAIjC;;;OAGG;IACH,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzE;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAOhD"}

package/dist/effort/index.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Effort Level Control — Adjusts how deeply the agent analyzes requests.
+ *
+ * Inspired by Claude Code's --effort flag and Cursor's MAX mode.
+ *
+ * Effort levels:
+ *   - low:    Quick responses, minimal analysis. Good for simple questions.
+ *   - medium: Default. Balanced analysis and speed.
+ *   - high:   Deep analysis, reads more files, considers edge cases.
+ *   - max:    Extended thinking, comprehensive analysis, multiple passes.
+ *
+ * How it affects behavior:
+ *   - System prompt instructions change based on level
+ *   - Temperature may be adjusted
+ *   - Token limits are scaled
+ *   - The agent is instructed to use more/fewer tools
+ *
+ * Learning note: This is essentially a UX abstraction over multiple
+ * model parameters. Instead of asking users to tweak temperature,
+ * max tokens, and system prompt, they just say "try harder" or
+ * "be quick about it".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EffortManager = void 0;
+/**
+ * Predefined configurations for each effort level.
+ *
+ * Learning note: These are tuned to balance speed vs thoroughness.
+ * Lower effort = faster, cheaper, more concise.
+ * Higher effort = slower, more expensive, more comprehensive.
+ */
+const EFFORT_CONFIGS = {
+    low: {
+        systemPromptAddition: [
+            "# Effort: Low",
+            "Be very concise. Give the shortest correct answer.",
+            "- Skip detailed explanations unless asked",
+            "- Use the fewest tools possible",
+            "- Don't read files you don't need",
+            "- One-sentence summaries are fine",
+            "- Prefer quick fixes over comprehensive solutions",
+        ].join("\n"),
+        temperature: null,
+        maxTokensMultiplier: 0.5,
+        maxTurnsMultiplier: 0.5,
+        description: "Quick, minimal analysis",
+    },
+    medium: {
+        systemPromptAddition: "", // Default behavior, no additions needed
+        temperature: null,
+        maxTokensMultiplier: 1.0,
+        maxTurnsMultiplier: 1.0,
+        description: "Balanced (default)",
+    },
+    high: {
+        systemPromptAddition: [
+            "# Effort: High",
+            "Take extra care with this task. Be thorough.",
+            "- Read all relevant files before making changes",
+            "- Consider edge cases and error scenarios",
+            "- Verify your changes compile/run correctly",
+            "- Explain your reasoning for non-obvious decisions",
+            "- Search for related code that might need updating",
+        ].join("\n"),
+        temperature: null,
+        maxTokensMultiplier: 1.5,
+        maxTurnsMultiplier: 2.0,
+        description: "Deep analysis, thorough",
+    },
+    max: {
+        systemPromptAddition: [
+            "# Effort: Maximum",
+            "This is a critical task. Use maximum thoroughness.",
+            "- Exhaustively search the codebase for context",
+            "- Read ALL related files, tests, and documentation",
+            "- Consider architectural implications",
+            "- Check for breaking changes across the project",
+            "- Run tests and verify everything works",
+            "- Think step-by-step before making changes",
+            "- Consider multiple approaches and pick the best one",
+            "- Add proper error handling and edge case coverage",
+        ].join("\n"),
+        temperature: null,
+        maxTokensMultiplier: 2.0,
+        maxTurnsMultiplier: 3.0,
+        description: "Maximum thoroughness, extended thinking",
+    },
+};
+/**
+ * Manages the current effort level and provides configuration.
+ */
+class EffortManager {
+    level = "medium";
+    /**
+     * Set the effort level.
+     */
+    setLevel(level) {
+        if (!EFFORT_CONFIGS[level]) {
+            throw new Error(`Invalid effort level: ${level}. Use: low, medium, high, max`);
+        }
+        this.level = level;
+    }
+    /**
+     * Get the current effort level.
+     */
+    getLevel() {
+        return this.level;
+    }
+    /**
+     * Get the configuration for the current effort level.
+     */
+    getConfig() {
+        return EFFORT_CONFIGS[this.level];
+    }
+    /**
+     * Get the system prompt addition for the current level.
+     * Returns empty string for medium (default) level.
+     */
+    getSystemPromptAddition() {
+        return EFFORT_CONFIGS[this.level].systemPromptAddition;
+    }
+    /**
+     * Get all available levels with descriptions.
+     * Useful for displaying in help or settings UI.
+     */
+    static getAllLevels() {
+        return Object.entries(EFFORT_CONFIGS).map(([level, config]) => ({
+            level: level,
+            description: config.description,
+        }));
+    }
+    /**
+     * Parse an effort level from a string (case-insensitive).
+     * Returns null if the string is not a valid level.
+     */
+    static parse(input) {
+        const normalized = input.toLowerCase().trim();
+        if (normalized in EFFORT_CONFIGS) {
+            return normalized;
+        }
+        return null;
+    }
+}
+exports.EffortManager = EffortManager;
+//# sourceMappingURL=index.js.map

package/dist/effort/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/effort/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA2BH;;;;;;GAMG;AACH,MAAM,cAAc,GAAsC;IACxD,GAAG,EAAE;QACH,oBAAoB,EAAE;YACpB,eAAe;YACf,oDAAoD;YACpD,2CAA2C;YAC3C,iCAAiC;YACjC,mCAAmC;YACnC,mCAAmC;YACnC,mDAAmD;SACpD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,GAAG;QACxB,kBAAkB,EAAE,GAAG;QACvB,WAAW,EAAE,yBAAyB;KACvC;IAED,MAAM,EAAE;QACN,oBAAoB,EAAE,EAAE,EAAG,wCAAwC;QACnE,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,GAAG;QACxB,kBAAkB,EAAE,GAAG;QACvB,WAAW,EAAE,oBAAoB;KAClC;IAED,IAAI,EAAE;QACJ,oBAAoB,EAAE;YACpB,gBAAgB;YAChB,8CAA8C;YAC9C,iDAAiD;YACjD,2CAA2C;YAC3C,6CAA6C;YAC7C,oDAAoD;YACpD,oDAAoD;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,GAAG;QACxB,kBAAkB,EAAE,GAAG;QACvB,WAAW,EAAE,yBAAyB;KACvC;IAED,GAAG,EAAE;QACH,oBAAoB,EAAE;YACpB,mBAAmB;YACnB,oDAAoD;YACpD,gDAAgD;YAChD,oDAAoD;YACpD,uCAAuC;YACvC,iDAAiD;YACjD,yCAAyC;YACzC,4CAA4C;YAC5C,sDAAsD;YACtD,oDAAoD;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,GAAG;QACxB,kBAAkB,EAAE,GAAG;QACvB,WAAW,EAAE,yCAAyC;KACvD;CACF,CAAC;AAEF;;GAEG;AACH,MAAa,aAAa;IAChB,KAAK,GAAgB,QAAQ,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,KAAkB;QACzB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,+BAA+B,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,uBAAuB;QACrB,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,KAAK,EAAE,KAAoB;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,UAAU,IAAI,cAAc,EAAE,CAAC;YACjC,OAAO,UAAyB,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAzDD,sCAyDC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Hooks System — run user-configured shell commands before/after tool execution.
+ *
+ * Configuration stored in ~/.cdoing/hooks.json or .cdoing/hooks.json (project-level).
+ *
+ * Example hooks.json:
+ * {
+ *   "hooks": [
+ *     { "event": "pre:file_write", "command": "echo 'Writing file: {{file_path}}'" },
+ *     { "event": "post:shell_exec", "command": "echo 'Command finished'" },
+ *     { "event": "pre:*", "command": "echo 'Tool called: {{tool_name}}'" }
+ *   ]
+ * }
+ */
+export interface HookDefinition {
+    /** Event pattern: "pre:tool_name", "post:tool_name", "pre:*", "post:*" */
+    event: string;
+    /** Shell command to execute. Supports {{variable}} placeholders. */
+    command: string;
+    /** Timeout in ms (default: 10000) */
+    timeout?: number;
+}
+export interface HookResult {
+    hook: HookDefinition;
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export declare class HookManager {
+    private hooks;
+    private workingDir;
+    constructor(workingDir: string);
+    setWorkingDir(dir: string): void;
+    private loadHooks;
+    private loadFromFile;
+    /** Find hooks matching a given event */
+    private findHooks;
+    /** Run all hooks for an event */
+    runHooks(event: string, variables: Record<string, string>): Promise<HookResult[]>;
+    /** Execute a single hook */
+    private executeHook;
+    /** Check if any hooks are configured */
+    hasHooks(): boolean;
+    /** Get all configured hooks */
+    getHooks(): ReadonlyArray<HookDefinition>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAK9B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,YAAY;IAapB,wCAAwC;IACxC,OAAO,CAAC,SAAS;IAQjB,iCAAiC;IAC3B,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,UAAU,EAAE,CAAC;IAYxB,4BAA4B;IAC5B,OAAO,CAAC,WAAW;IAqCnB,wCAAwC;IACxC,QAAQ,IAAI,OAAO;IAInB,+BAA+B;IAC/B,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC;CAG1C"}

package/dist/hooks/index.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Hooks System — run user-configured shell commands before/after tool execution.
+ *
+ * Configuration stored in ~/.cdoing/hooks.json or .cdoing/hooks.json (project-level).
+ *
+ * Example hooks.json:
+ * {
+ *   "hooks": [
+ *     { "event": "pre:file_write", "command": "echo 'Writing file: {{file_path}}'" },
+ *     { "event": "post:shell_exec", "command": "echo 'Command finished'" },
+ *     { "event": "pre:*", "command": "echo 'Tool called: {{tool_name}}'" }
+ *   ]
+ * }
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+class HookManager {
+    hooks = [];
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+        this.loadHooks();
+    }
+    setWorkingDir(dir) {
+        this.workingDir = dir;
+        this.loadHooks();
+    }
+    loadHooks() {
+        this.hooks = [];
+        // Load global hooks
+        const globalFile = path.join(os.homedir(), ".cdoing", "hooks.json");
+        this.loadFromFile(globalFile);
+        // Load project hooks (overrides/supplements global)
+        const projectFile = path.join(this.workingDir, ".cdoing", "hooks.json");
+        this.loadFromFile(projectFile);
+    }
+    loadFromFile(filePath) {
+        try {
+            if (fs.existsSync(filePath)) {
+                const data = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+                if (Array.isArray(data.hooks)) {
+                    this.hooks.push(...data.hooks);
+                }
+            }
+        }
+        catch {
+            // skip invalid files
+        }
+    }
+    /** Find hooks matching a given event */
+    findHooks(event) {
+        const [phase, toolName] = event.split(":");
+        return this.hooks.filter((h) => {
+            const [hPhase, hTool] = h.event.split(":");
+            return hPhase === phase && (hTool === "*" || hTool === toolName);
+        });
+    }
+    /** Run all hooks for an event */
+    async runHooks(event, variables) {
+        const matching = this.findHooks(event);
+        if (matching.length === 0)
+            return [];
+        const results = [];
+        for (const hook of matching) {
+            const result = await this.executeHook(hook, variables);
+            results.push(result);
+        }
+        return results;
+    }
+    /** Execute a single hook */
+    executeHook(hook, variables) {
+        // Replace {{variable}} placeholders
+        let command = hook.command;
+        for (const [key, value] of Object.entries(variables)) {
+            command = command.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+        }
+        const timeout = hook.timeout || 10000;
+        return new Promise((resolve) => {
+            (0, child_process_1.exec)(command, {
+                cwd: this.workingDir,
+                timeout,
+                maxBuffer: 1024 * 1024,
+                env: { ...process.env },
+            }, (error, stdout, stderr) => {
+                if (error) {
+                    resolve({
+                        hook,
+                        success: false,
+                        output: stdout || "",
+                        error: stderr || error.message,
+                    });
+                }
+                else {
+                    resolve({
+                        hook,
+                        success: true,
+                        output: (stdout || "").trim(),
+                    });
+                }
+            });
+        });
+    }
+    /** Check if any hooks are configured */
+    hasHooks() {
+        return this.hooks.length > 0;
+    }
+    /** Get all configured hooks */
+    getHooks() {
+        return this.hooks;
+    }
+}
+exports.HookManager = HookManager;
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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