opencode-command-hooks 0.1.0

package/dist/config/agent.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Agent configuration resolution and loading for command hooks
+ *
+ * Handles finding and parsing agent markdown files (.opencode/agent/*.md or
+ * ~/.config/opencode/agent/*.md) to extract command_hooks from YAML frontmatter.
+ * These hooks are applied when the specific subagent is invoked via the task tool.
+ */
+import type { CommandHooksConfig } from "../types/hooks.js";
+/**
+ * Resolve agent markdown file path by agent name
+ *
+ * Searches for agent markdown files in the following order:
+ * 1. Project-level: .opencode/agent/{name}.md
+ * 2. User-level: ~/.config/opencode/agent/{name}.md
+ *
+ * Returns the first existing path found, or null if no file exists.
+ *
+ * @param agentName - Name of the agent to resolve (without .md extension)
+ * @returns Promise resolving to absolute path of the agent markdown file, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const path = await resolveAgentPath("engineer");
+ * // Returns: "/Users/example/project/.opencode/agent/engineer.md" (if exists)
+ * // Or: "/Users/example/.config/opencode/agent/engineer.md" (if project path doesn't exist)
+ * // Or: null (if neither exists)
+ * ```
+ */
+export declare function resolveAgentPath(agentName: string): Promise<string | null>;
+/**
+ * Load command_hooks from an agent's markdown file
+ *
+ * Attempts to resolve the agent markdown file and extract command_hooks
+ * from its YAML frontmatter. Returns an empty config if the file doesn't
+ * exist or contains no valid hooks.
+ *
+ * **Caching:** This function uses the caching from loadMarkdownConfig() internally.
+ * Multiple calls for the same agent will only read the file once.
+ *
+ * Error handling:
+ * - If agent file doesn't exist: returns empty config
+ * - If file exists but has no frontmatter: returns empty config
+ * - If frontmatter is malformed: logs warning, returns empty config
+ * - If no command_hooks field: returns empty config
+ * - Never throws errors - always returns a valid config
+ *
+ * @param agentName - Name of the agent to load configuration for
+ * @returns Promise resolving to CommandHooksConfig (may be empty)
+ *
+ * @example
+ * ```typescript
+ * const config = await loadAgentConfig("engineer");
+ * // Returns: { tool: [...], session: [...] } with agent-specific hooks
+ * // Or: { tool: [], session: [] } if no valid hooks found
+ * ```
+ */
+export declare function loadAgentConfig(agentName: string): Promise<CommandHooksConfig>;
+/**
+ * Load and merge agent-specific configuration with global configuration
+ *
+ * Combines global command hooks with agent-specific hooks, where agent hooks
+ * take precedence for the specific agent context. This is useful when you want
+ * to apply both global hooks and agent-specific hooks together.
+ *
+ * The merge follows the same precedence rules as mergeConfigs:
+ * - Agent hooks with the same ID replace global hooks
+ * - Agent hooks with unique IDs are added alongside global hooks
+ *
+ * @param agentName - Name of the agent to load configuration for
+ * @returns Promise resolving to merged CommandHooksConfig
+ *
+ * @example
+ * ```typescript
+ * const { config } = await loadAgentConfigWithGlobal("engineer");
+ * // Returns merged config with both global and engineer-specific hooks
+ * ```
+ */
+export declare function loadAgentConfigWithGlobal(agentName: string): Promise<{
+    config: CommandHooksConfig;
+    agentPath: string | null;
+}>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/config/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/config/agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqChF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBpF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAanE"}

package/dist/config/agent.js

@@ -0,0 +1,145 @@
+/**
+ * Agent configuration resolution and loading for command hooks
+ *
+ * Handles finding and parsing agent markdown files (.opencode/agent/*.md or
+ * ~/.config/opencode/agent/*.md) to extract command_hooks from YAML frontmatter.
+ * These hooks are applied when the specific subagent is invoked via the task tool.
+ */
+import { join } from "path";
+import { homedir } from "os";
+import { loadMarkdownConfig } from "./markdown.js";
+import { logger } from "../logging.js";
+/**
+ * Resolve agent markdown file path by agent name
+ *
+ * Searches for agent markdown files in the following order:
+ * 1. Project-level: .opencode/agent/{name}.md
+ * 2. User-level: ~/.config/opencode/agent/{name}.md
+ *
+ * Returns the first existing path found, or null if no file exists.
+ *
+ * @param agentName - Name of the agent to resolve (without .md extension)
+ * @returns Promise resolving to absolute path of the agent markdown file, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const path = await resolveAgentPath("engineer");
+ * // Returns: "/Users/example/project/.opencode/agent/engineer.md" (if exists)
+ * // Or: "/Users/example/.config/opencode/agent/engineer.md" (if project path doesn't exist)
+ * // Or: null (if neither exists)
+ * ```
+ */
+export async function resolveAgentPath(agentName) {
+    // Validate agent name to prevent directory traversal
+    if (!agentName || agentName.includes("/") || agentName.includes("..")) {
+        logger.debug(`Invalid agent name: ${agentName}`);
+        return null;
+    }
+    const agentFileName = `${agentName}.md`;
+    // Check project-level agent file
+    const projectAgentPath = join(process.cwd(), ".opencode", "agent", agentFileName);
+    try {
+        const projectFile = Bun.file(projectAgentPath);
+        if (await projectFile.exists()) {
+            logger.debug(`Found project agent file: ${projectAgentPath}`);
+            return projectAgentPath;
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.debug(`Error checking project agent file ${projectAgentPath}: ${message}`);
+    }
+    // Check user-level agent file
+    const userAgentPath = join(homedir(), ".config", "opencode", "agent", agentFileName);
+    try {
+        const userFile = Bun.file(userAgentPath);
+        if (await userFile.exists()) {
+            logger.debug(`Found user agent file: ${userAgentPath}`);
+            return userAgentPath;
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.debug(`Error checking user agent file ${userAgentPath}: ${message}`);
+    }
+    logger.debug(`No agent file found for: ${agentName}`);
+    return null;
+}
+/**
+ * Load command_hooks from an agent's markdown file
+ *
+ * Attempts to resolve the agent markdown file and extract command_hooks
+ * from its YAML frontmatter. Returns an empty config if the file doesn't
+ * exist or contains no valid hooks.
+ *
+ * **Caching:** This function uses the caching from loadMarkdownConfig() internally.
+ * Multiple calls for the same agent will only read the file once.
+ *
+ * Error handling:
+ * - If agent file doesn't exist: returns empty config
+ * - If file exists but has no frontmatter: returns empty config
+ * - If frontmatter is malformed: logs warning, returns empty config
+ * - If no command_hooks field: returns empty config
+ * - Never throws errors - always returns a valid config
+ *
+ * @param agentName - Name of the agent to load configuration for
+ * @returns Promise resolving to CommandHooksConfig (may be empty)
+ *
+ * @example
+ * ```typescript
+ * const config = await loadAgentConfig("engineer");
+ * // Returns: { tool: [...], session: [...] } with agent-specific hooks
+ * // Or: { tool: [], session: [] } if no valid hooks found
+ * ```
+ */
+export async function loadAgentConfig(agentName) {
+    // Resolve the agent path
+    const agentPath = await resolveAgentPath(agentName);
+    if (!agentPath) {
+        logger.debug(`No agent file found for: ${agentName}, returning empty config`);
+        return { tool: [], session: [] };
+    }
+    // Load the markdown config using the existing function
+    const config = await loadMarkdownConfig(agentPath);
+    if (config.tool?.length === 0 && config.session?.length === 0) {
+        logger.debug(`Agent ${agentName} has no command_hooks in frontmatter`);
+    }
+    else {
+        logger.debug(`Loaded agent config for ${agentName}: ${config.tool?.length ?? 0} tool hooks, ${config.session?.length ?? 0} session hooks`);
+    }
+    return config;
+}
+/**
+ * Load and merge agent-specific configuration with global configuration
+ *
+ * Combines global command hooks with agent-specific hooks, where agent hooks
+ * take precedence for the specific agent context. This is useful when you want
+ * to apply both global hooks and agent-specific hooks together.
+ *
+ * The merge follows the same precedence rules as mergeConfigs:
+ * - Agent hooks with the same ID replace global hooks
+ * - Agent hooks with unique IDs are added alongside global hooks
+ *
+ * @param agentName - Name of the agent to load configuration for
+ * @returns Promise resolving to merged CommandHooksConfig
+ *
+ * @example
+ * ```typescript
+ * const { config } = await loadAgentConfigWithGlobal("engineer");
+ * // Returns merged config with both global and engineer-specific hooks
+ * ```
+ */
+export async function loadAgentConfigWithGlobal(agentName) {
+    const [globalConfig, agentConfig] = await Promise.all([
+        import("./global.js").then((m) => m.loadGlobalConfig()),
+        loadAgentConfig(agentName),
+    ]);
+    return {
+        config: {
+            tool: [...(globalConfig.tool ?? []), ...(agentConfig.tool ?? [])],
+            session: [...(globalConfig.session ?? []), ...(agentConfig.session ?? [])],
+        },
+        agentPath: await resolveAgentPath(agentName),
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/config/agent.js.map

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

package/dist/config/global.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Global configuration parser for loading hooks from .opencode/command-hooks.jsonc
+ *
+ * Searches for .opencode/command-hooks.jsonc starting from the current working
+ * directory and walking up the directory tree. Parses JSONC format as CommandHooksConfig.
+ */
+import type { CommandHooksConfig } from "../types/hooks.js";
+/**
+ * Load and parse global command hooks configuration
+ *
+ * Searches for .opencode/command-hooks.jsonc starting from the current working
+ * directory and walking up. Parses the entire file as CommandHooksConfig.
+ *
+ * **Caching:** This function implements in-memory caching to avoid repeated file
+ * system reads on every tool call. The cache is checked first; if null, the config
+ * is loaded from disk and cached for subsequent calls.
+ *
+ * Error handling:
+ * - If no config file found: returns empty config (not an error)
+ * - If config file is malformed: logs warning, returns empty config
+ * - If file is not a valid CommandHooksConfig: logs warning, returns empty config
+ * - Never throws errors - always returns a valid config
+ *
+ * @returns Promise resolving to CommandHooksConfig (may be empty)
+ */
+export declare function loadGlobalConfig(): Promise<CommandHooksConfig>;
+/**
+ * Clear the global config cache
+ *
+ * Forces the next call to loadGlobalConfig() to reload from disk.
+ * Useful for testing or when config files may have changed.
+ *
+ * @internal For testing purposes
+ */
+export declare function clearGlobalConfigCache(): void;
+//# sourceMappingURL=global.d.ts.map

package/dist/config/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../src/config/global.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA0I5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAmFpE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}

package/dist/config/global.js

@@ -0,0 +1,219 @@
+/**
+ * Global configuration parser for loading hooks from .opencode/command-hooks.jsonc
+ *
+ * Searches for .opencode/command-hooks.jsonc starting from the current working
+ * directory and walking up the directory tree. Parses JSONC format as CommandHooksConfig.
+ */
+import { join, dirname } from "path";
+import { logger } from "../logging.js";
+/**
+ * In-memory cache for global configuration
+ * Stores the loaded config to avoid repeated file system reads on every tool call.
+ * Set to null to force a reload on the next loadGlobalConfig() call.
+ */
+let cachedConfig = null;
+/**
+ * Strip comments from JSONC content
+ * Handles both line comments and block comments
+ */
+function stripJsoncComments(content) {
+    let result = "";
+    let i = 0;
+    while (i < content.length) {
+        // Check for line comment
+        if (content[i] === "/" && content[i + 1] === "/") {
+            // Skip until end of line
+            while (i < content.length && content[i] !== "\n") {
+                i++;
+            }
+            // Keep the newline
+            if (i < content.length) {
+                result += "\n";
+                i++;
+            }
+            continue;
+        }
+        // Check for block comment
+        if (content[i] === "/" && content[i + 1] === "*") {
+            // Skip until */
+            i += 2;
+            while (i < content.length - 1) {
+                if (content[i] === "*" && content[i + 1] === "/") {
+                    i += 2;
+                    break;
+                }
+                // Preserve newlines to maintain line numbers
+                if (content[i] === "\n") {
+                    result += "\n";
+                }
+                i++;
+            }
+            continue;
+        }
+        // Regular character
+        result += content[i];
+        i++;
+    }
+    return result;
+}
+/**
+ * Parse JSON content, handling parse errors gracefully
+ */
+function parseJson(content) {
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse JSON: ${message}`);
+    }
+}
+/**
+ * Check if a value is a valid CommandHooksConfig object
+ */
+function isValidCommandHooksConfig(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const obj = value;
+    // Both tool and session are optional
+    if (obj.tool !== undefined && !Array.isArray(obj.tool)) {
+        return false;
+    }
+    if (obj.session !== undefined && !Array.isArray(obj.session)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Find command hooks config file by walking up directory tree
+ * Looks for .opencode/command-hooks.jsonc
+ */
+async function findConfigFile(startDir) {
+    let currentDir = startDir;
+    // Limit search depth to avoid infinite loops
+    const maxDepth = 20;
+    let depth = 0;
+    while (depth < maxDepth) {
+        // Try .opencode/command-hooks.jsonc
+        const configPath = join(currentDir, ".opencode", "command-hooks.jsonc");
+        try {
+            const file = Bun.file(configPath);
+            if (await file.exists()) {
+                logger.debug(`Found config file: ${configPath}`);
+                return configPath;
+            }
+        }
+        catch {
+            // Continue searching
+        }
+        // Move up one directory
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached filesystem root
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    logger.debug(`No config file found after searching ${depth} directories`);
+    return null;
+}
+/**
+ * Load and parse global command hooks configuration
+ *
+ * Searches for .opencode/command-hooks.jsonc starting from the current working
+ * directory and walking up. Parses the entire file as CommandHooksConfig.
+ *
+ * **Caching:** This function implements in-memory caching to avoid repeated file
+ * system reads on every tool call. The cache is checked first; if null, the config
+ * is loaded from disk and cached for subsequent calls.
+ *
+ * Error handling:
+ * - If no config file found: returns empty config (not an error)
+ * - If config file is malformed: logs warning, returns empty config
+ * - If file is not a valid CommandHooksConfig: logs warning, returns empty config
+ * - Never throws errors - always returns a valid config
+ *
+ * @returns Promise resolving to CommandHooksConfig (may be empty)
+ */
+export async function loadGlobalConfig() {
+    // Check cache first
+    if (cachedConfig !== null) {
+        logger.debug(`Returning cached global config: ${cachedConfig.tool?.length ?? 0} tool hooks, ${cachedConfig.session?.length ?? 0} session hooks`);
+        return cachedConfig;
+    }
+    try {
+        // Find config file
+        const configPath = await findConfigFile(process.cwd());
+        if (!configPath) {
+            logger.debug(`No .opencode/command-hooks.jsonc file found, using empty config`);
+            const emptyConfig = { tool: [], session: [] };
+            cachedConfig = emptyConfig;
+            return emptyConfig;
+        }
+        // Read file
+        let content;
+        try {
+            const file = Bun.file(configPath);
+            content = await file.text();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.info(`Failed to read config file ${configPath}: ${message}`);
+            const emptyConfig = { tool: [], session: [] };
+            cachedConfig = emptyConfig;
+            return emptyConfig;
+        }
+        // Parse JSONC
+        let parsed;
+        try {
+            const stripped = stripJsoncComments(content);
+            parsed = parseJson(stripped);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.info(`Failed to parse config file ${configPath}: ${message}`);
+            const emptyConfig = { tool: [], session: [] };
+            cachedConfig = emptyConfig;
+            return emptyConfig;
+        }
+        // Validate entire file as CommandHooksConfig
+        if (!isValidCommandHooksConfig(parsed)) {
+            logger.info(`Config file is not a valid CommandHooksConfig (expected { tool?: [], session?: [] }), using empty config`);
+            const emptyConfig = { tool: [], session: [] };
+            cachedConfig = emptyConfig;
+            return emptyConfig;
+        }
+        // Return with defaults for missing arrays
+        const result = {
+            tool: parsed.tool ?? [],
+            session: parsed.session ?? [],
+        };
+        logger.debug(`Loaded global config: ${result.tool?.length ?? 0} tool hooks, ${result.session?.length ?? 0} session hooks`);
+        // Cache the result
+        cachedConfig = result;
+        return result;
+    }
+    catch (error) {
+        // Catch-all for unexpected errors
+        const message = error instanceof Error ? error.message : String(error);
+        logger.info(`Unexpected error loading global config: ${message}`);
+        const emptyConfig = { tool: [], session: [] };
+        cachedConfig = emptyConfig;
+        return emptyConfig;
+    }
+}
+/**
+ * Clear the global config cache
+ *
+ * Forces the next call to loadGlobalConfig() to reload from disk.
+ * Useful for testing or when config files may have changed.
+ *
+ * @internal For testing purposes
+ */
+export function clearGlobalConfigCache() {
+    logger.debug("Clearing global config cache");
+    cachedConfig = null;
+}
+//# sourceMappingURL=global.js.map

package/dist/config/global.js.map

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

package/dist/config/markdown.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Markdown configuration parser for loading hooks from agent and slash-command markdown files
+ *
+ * Parses YAML frontmatter from markdown files and extracts command_hooks configuration.
+ * Supports both agent markdown files (typically in .opencode/agents/) and slash-command
+ * markdown files (typically in .opencode/commands/).
+ */
+import type { AgentHooks, CommandHooksConfig } from "../types/hooks.js";
+/**
+ * Extract YAML frontmatter from markdown content
+ *
+ * Frontmatter is defined as content between the first `---` and second `---`
+ * at the start of the file. Returns the raw YAML string (without delimiters).
+ *
+ * @param content - Full markdown file content
+ * @returns Raw YAML string, or null if no frontmatter found
+ *
+ * @example
+ * ```
+ * ---
+ * name: my-agent
+ * command_hooks:
+ *   tool: [...]
+ * ---
+ *
+ * # Agent content
+ * ```
+ * Returns the YAML between the delimiters
+ */
+export declare function extractYamlFrontmatter(content: string): string | null;
+/**
+ * Parse YAML content and return the parsed object
+ *
+ * Handles YAML parsing errors gracefully by returning null.
+ * Does not throw errors - callers should check for null return value.
+ *
+ * @param yamlContent - Raw YAML string to parse
+ * @returns Parsed YAML object, or null if parsing failed
+ */
+export declare function parseYamlFrontmatter(content: string): unknown;
+/**
+ * Parse simplified agent hooks from YAML frontmatter content
+ *
+ * Extracts and validates the new simplified `hooks` format from agent markdown
+ * frontmatter. Returns null if no hooks are present or if parsing fails.
+ *
+ * @param yamlContent - Raw YAML string from frontmatter
+ * @param agentName - Name of the agent (used for auto-generating hook IDs)
+ * @returns Parsed AgentHooks object, or null if no valid hooks found
+ *
+ * @example
+ * ```yaml
+ * hooks:
+ *   before:
+ *     - run: "echo starting"
+ *   after:
+ *     - run: ["npm run test"]
+ *       inject: "Results:\n{stdout}"
+ * ```
+ */
+export declare function parseAgentHooks(yamlContent: string): AgentHooks | null;
+/**
+ * Convert simplified agent hooks to internal CommandHooksConfig format
+ *
+ * Takes the simplified AgentHooks format and converts it to the internal
+ * ToolHook[] format with auto-generated IDs and proper when clauses.
+ *
+ * @param agentHooks - Simplified agent hooks configuration
+ * @param agentName - Name of the agent (used for hook ID generation)
+ * @returns CommandHooksConfig with tool hooks converted to internal format
+ *
+ * @example
+ * ```typescript
+ * const simpleHooks: AgentHooks = {
+ *   after: [{ run: "npm run test", inject: "Results: {stdout}" }]
+ * };
+ * const config = convertToCommandHooksConfig(simpleHooks, "engineer");
+ * // Results in: { tool: [{ id: "engineer-after-0", when: {...}, run: ..., inject: ... }] }
+ * ```
+ */
+export declare function convertToCommandHooksConfig(agentHooks: AgentHooks, agentName: string): CommandHooksConfig;
+/**
+ * Load and parse command hooks configuration from a markdown file
+ *
+ * Reads a markdown file, extracts YAML frontmatter, parses it, and extracts
+ * either the new simplified `hooks` format or the legacy `command_hooks` format.
+ *
+ * **Caching:** This function implements in-memory caching per file path to avoid
+ * repeated file reads. The cache is checked first; if not found, the file is read
+ * from disk and cached for subsequent calls.
+ *
+ * Error handling:
+ * - If file doesn't exist: returns empty config (not an error)
+ * - If no frontmatter found: returns empty config
+ * - If YAML is malformed: logs warning, returns empty config
+ * - If hooks format is invalid: logs warning, returns empty config
+ * - Never throws errors - always returns a valid config
+ *
+ * @param filePath - Absolute path to the markdown file
+ * @returns Promise resolving to CommandHooksConfig (may be empty)
+ *
+ * @example
+ * ```typescript
+ * const config = await loadMarkdownConfig("/path/to/agent.md");
+ * // Returns { tool: [...], session: [...] } or { tool: [], session: [] }
+ * ```
+ */
+export declare function loadMarkdownConfig(filePath: string): Promise<CommandHooksConfig>;
+/**
+ * Clear the markdown config cache for a specific file
+ *
+ * Forces the next call to loadMarkdownConfig() for this file to reload from disk.
+ * Useful for testing or when config files may have changed.
+ *
+ * @param filePath - Path to clear from cache, or undefined to clear all
+ * @internal For testing purposes
+ */
+export declare function clearMarkdownConfigCache(filePath?: string): void;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/config/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/config/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkB,kBAAkB,EAAY,MAAM,mBAAmB,CAAC;AAWlG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAClB,UAAU,GAAG,IAAI,CA8CnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAqCpB;AA2ED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACrC,QAAQ,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA+H7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAQhE"}