@htekdev/actions-debugger 1.0.0

package/dist/server.js

@@ -0,0 +1,164 @@
+/**
+ * MCP Server setup — registers all tools with the MCP server.
+ */
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { lookupError, formatLookupResult } from "./tools/lookup-error.js";
+import { diagnoseWorkflow, formatDiagnosticResult } from "./tools/diagnose-workflow.js";
+import { suggestFix, formatSuggestResult } from "./tools/suggest-fix.js";
+import { listCategories, formatCategoryList } from "./tools/list-categories.js";
+import { searchErrors, formatSearchResult } from "./tools/search-errors.js";
+const CATEGORIES = [
+    "yaml-syntax",
+    "silent-failures",
+    "runner-environment",
+    "permissions-auth",
+    "caching-artifacts",
+    "triggers",
+    "concurrency-timing",
+    "known-unsolved",
+];
+const TOOLS = [
+    {
+        name: "lookup_error",
+        description: "Match a GitHub Actions error message against the known error database. Returns matching errors with root cause and fix.",
+        inputSchema: {
+            type: "object",
+            required: ["error_message"],
+            properties: {
+                error_message: {
+                    type: "string",
+                    description: "The error message from GitHub Actions logs",
+                },
+                max_results: {
+                    type: "number",
+                    description: "Maximum results to return (default: 3)",
+                },
+            },
+        },
+    },
+    {
+        name: "diagnose_workflow",
+        description: "Analyze a GitHub Actions workflow YAML for common issues. Returns a list of potential problems with severity and fixes.",
+        inputSchema: {
+            type: "object",
+            required: ["workflow_yaml"],
+            properties: {
+                workflow_yaml: {
+                    type: "string",
+                    description: "The workflow YAML content to analyze",
+                },
+            },
+        },
+    },
+    {
+        name: "suggest_fix",
+        description: "Given error context (error message, workflow snippet, runner OS), suggest the most likely fix with code examples.",
+        inputSchema: {
+            type: "object",
+            required: ["error_context"],
+            properties: {
+                error_context: {
+                    type: "string",
+                    description: "Description of the problem — error message, what you're trying to do, runner OS, etc.",
+                },
+                category: {
+                    type: "string",
+                    description: "Error category to narrow search (optional)",
+                    enum: CATEGORIES,
+                },
+            },
+        },
+    },
+    {
+        name: "list_categories",
+        description: "List all error categories with error counts and descriptions.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "search_errors",
+        description: "Search the error database by keyword, tag, or category.",
+        inputSchema: {
+            type: "object",
+            required: ["query"],
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query — matches against title, root_cause, fix, tags",
+                },
+                category: {
+                    type: "string",
+                    description: "Filter by category (optional)",
+                    enum: CATEGORIES,
+                },
+                severity: {
+                    type: "string",
+                    description: "Filter by severity (optional)",
+                    enum: ["error", "warning", "silent-failure", "limitation"],
+                },
+                max_results: {
+                    type: "number",
+                    description: "Maximum results to return (default: 10)",
+                },
+            },
+        },
+    },
+];
+/**
+ * Register all tools with the MCP server.
+ */
+export function registerTools(server, db) {
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "lookup_error": {
+                const { error_message, max_results } = args;
+                const results = lookupError(db, error_message, max_results ?? 3);
+                return {
+                    content: [{ type: "text", text: formatLookupResult(results) }],
+                };
+            }
+            case "diagnose_workflow": {
+                const { workflow_yaml } = args;
+                const findings = diagnoseWorkflow(db, workflow_yaml);
+                return {
+                    content: [{ type: "text", text: formatDiagnosticResult(findings) }],
+                };
+            }
+            case "suggest_fix": {
+                const { error_context, category } = args;
+                const results = suggestFix(db, error_context, category);
+                return {
+                    content: [{ type: "text", text: formatSuggestResult(results) }],
+                };
+            }
+            case "list_categories": {
+                const categories = listCategories(db);
+                return {
+                    content: [{ type: "text", text: formatCategoryList(categories) }],
+                };
+            }
+            case "search_errors": {
+                const { query, category, severity, max_results } = args;
+                const results = searchErrors(db, query, {
+                    category,
+                    severity,
+                    maxResults: max_results ?? 10,
+                });
+                return {
+                    content: [{ type: "text", text: formatSearchResult(results) }],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/diagnose-workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * diagnose_workflow tool — analyze workflow YAML for common mistakes.
+ */
+import type { ErrorDatabase, DiagnosticFinding } from "../db/types.js";
+/**
+ * Diagnose a workflow YAML for common issues.
+ */
+export declare function diagnoseWorkflow(db: ErrorDatabase, workflowYaml: string): DiagnosticFinding[];
+/**
+ * Format diagnostic findings as a human-readable string.
+ */
+export declare function formatDiagnosticResult(findings: DiagnosticFinding[]): string;
+//# sourceMappingURL=diagnose-workflow.d.ts.map

package/dist/tools/diagnose-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose-workflow.d.ts","sourceRoot":"","sources":["../../src/tools/diagnose-workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGvE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CA4C5E"}

package/dist/tools/diagnose-workflow.js

@@ -0,0 +1,53 @@
+/**
+ * diagnose_workflow tool — analyze workflow YAML for common mistakes.
+ */
+import { analyzeWorkflow } from "../utils/yaml-parser.js";
+/**
+ * Diagnose a workflow YAML for common issues.
+ */
+export function diagnoseWorkflow(db, workflowYaml) {
+    return analyzeWorkflow(workflowYaml);
+}
+/**
+ * Format diagnostic findings as a human-readable string.
+ */
+export function formatDiagnosticResult(findings) {
+    if (findings.length === 0) {
+        return "✅ No issues found. Workflow looks good!";
+    }
+    const grouped = {
+        critical: [],
+        high: [],
+        medium: [],
+        low: [],
+    };
+    for (const f of findings) {
+        grouped[f.severity].push(f);
+    }
+    const lines = [
+        `## Workflow Analysis — ${findings.length} issue(s) found`,
+        "",
+    ];
+    const severityLabels = {
+        critical: "🔴 Critical",
+        high: "🟠 High",
+        medium: "🟡 Medium",
+        low: "🔵 Low",
+    };
+    for (const [sev, label] of Object.entries(severityLabels)) {
+        const items = grouped[sev];
+        if (items.length === 0)
+            continue;
+        lines.push(`### ${label} (${items.length})`);
+        for (const f of items) {
+            lines.push(`- **${f.message}**`);
+            lines.push(`  Fix: ${f.fix}`);
+            if (f.fix_code) {
+                lines.push(`  \`\`\`\n  ${f.fix_code}\n  \`\`\``);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=diagnose-workflow.js.map

package/dist/tools/diagnose-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose-workflow.js","sourceRoot":"","sources":["../../src/tools/diagnose-workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAiB,EACjB,YAAoB;IAEpB,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA6B;IAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,yCAAyC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAwC;QACnD,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,EAAE;KACR,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,0BAA0B,QAAQ,CAAC,MAAM,iBAAiB;QAC1D,EAAE;KACH,CAAC;IAEF,MAAM,cAAc,GAA2B;QAC7C,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,WAAW;QACnB,GAAG,EAAE,QAAQ;KACd,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/list-categories.d.ts

@@ -0,0 +1,13 @@
+/**
+ * list_categories tool — list all error categories with counts.
+ */
+import type { ErrorDatabase, CategoryInfo } from "../db/types.js";
+/**
+ * List all categories with error counts and severity breakdown.
+ */
+export declare function listCategories(db: ErrorDatabase): CategoryInfo[];
+/**
+ * Format category list as human-readable string.
+ */
+export declare function formatCategoryList(categories: CategoryInfo[]): string;
+//# sourceMappingURL=list-categories.d.ts.map

package/dist/tools/list-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.d.ts","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhG;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,YAAY,EAAE,CAqBhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAuBrE"}

package/dist/tools/list-categories.js

@@ -0,0 +1,51 @@
+/**
+ * list_categories tool — list all error categories with counts.
+ */
+/**
+ * List all categories with error counts and severity breakdown.
+ */
+export function listCategories(db) {
+    const categories = [];
+    for (const [name, entries] of db.categories) {
+        const severities = {
+            error: 0,
+            warning: 0,
+            "silent-failure": 0,
+            limitation: 0,
+        };
+        for (const entry of entries) {
+            severities[entry.severity]++;
+        }
+        categories.push({ name, count: entries.length, severities });
+    }
+    // Sort by count descending
+    categories.sort((a, b) => b.count - a.count);
+    return categories;
+}
+/**
+ * Format category list as human-readable string.
+ */
+export function formatCategoryList(categories) {
+    const totalErrors = categories.reduce((sum, c) => sum + c.count, 0);
+    const lines = [
+        `## Error Categories (${totalErrors} total errors)`,
+        "",
+        "| Category | Count | Severities |",
+        "|----------|-------|------------|",
+    ];
+    for (const cat of categories) {
+        const sevParts = [];
+        if (cat.severities.error)
+            sevParts.push(`${cat.severities.error} error`);
+        if (cat.severities.warning)
+            sevParts.push(`${cat.severities.warning} warning`);
+        if (cat.severities["silent-failure"])
+            sevParts.push(`${cat.severities["silent-failure"]} silent`);
+        if (cat.severities.limitation)
+            sevParts.push(`${cat.severities.limitation} limitation`);
+        lines.push(`| \`${cat.name}\` | ${cat.count} | ${sevParts.join(", ")} |`);
+    }
+    lines.push("", `*Source: [GitHub Actions Debugging Guide](https://htek.dev/articles/github-actions-debugging-guide)*`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=list-categories.js.map

package/dist/tools/list-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.js","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAiB;IAC9C,MAAM,UAAU,GAAmB,EAAE,CAAC;IAEtC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAkC;YAChD,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,gBAAgB,EAAE,CAAC;YACnB,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,2BAA2B;IAC3B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA0B;IAC3D,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG;QACZ,wBAAwB,WAAW,gBAAgB;QACnD,EAAE;QACF,mCAAmC;QACnC,mCAAmC;KACpC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC;QACzE,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;QAC/E,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClG,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,aAAa,CAAC,CAAC;QAExF,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,KAAK,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sGAAsG,CAAC,CAAC;IAEvH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/lookup-error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * lookup_error tool — match error messages against the known error database.
+ */
+import type { ErrorDatabase, ErrorEntry } from "../db/types.js";
+export interface LookupErrorInput {
+    error_message: string;
+    max_results?: number;
+}
+/**
+ * Look up an error message in the database.
+ * Returns matching errors with root cause and fix.
+ */
+export declare function lookupError(db: ErrorDatabase, errorMessage: string, maxResults?: number): ErrorEntry[];
+/**
+ * Format lookup results as a human-readable MCP response.
+ */
+export declare function formatLookupResult(results: ErrorEntry[]): string;
+//# sourceMappingURL=lookup-error.d.ts.map

package/dist/tools/lookup-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-error.d.ts","sourceRoot":"","sources":["../../src/tools/lookup-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG9E,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,MAAU,GACrB,UAAU,EAAE,CAGd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAwDhE"}

package/dist/tools/lookup-error.js

@@ -0,0 +1,67 @@
+/**
+ * lookup_error tool — match error messages against the known error database.
+ */
+import { lookupByPattern } from "../db/search.js";
+/**
+ * Look up an error message in the database.
+ * Returns matching errors with root cause and fix.
+ */
+export function lookupError(db, errorMessage, maxResults = 3) {
+    const results = lookupByPattern(db, errorMessage, maxResults);
+    return results.map(r => r.entry);
+}
+/**
+ * Format lookup results as a human-readable MCP response.
+ */
+export function formatLookupResult(results) {
+    if (results.length === 0) {
+        return [
+            "No matching errors found in the database.",
+            "",
+            "**Suggestions:**",
+            "1. Enable debug logging: set `ACTIONS_STEP_DEBUG` secret to `true`",
+            "2. Run `actionlint` on your workflow files",
+            "3. Check the full guide: https://htek.dev/articles/github-actions-debugging-guide",
+        ].join("\n");
+    }
+    return results
+        .map((entry, i) => {
+        const lines = [
+            `## ${i > 0 ? `Match ${i + 1}: ` : ""}${entry.title}`,
+            "",
+            `**Category:** ${entry.category} | **Severity:** ${entry.severity}`,
+            "",
+            `**Root Cause:**`,
+            entry.root_cause.trim(),
+            "",
+            `**Fix:**`,
+            entry.fix.trim(),
+        ];
+        if (entry.fix_code?.length) {
+            lines.push("");
+            for (const fc of entry.fix_code) {
+                lines.push(`\`\`\`${fc.language}`);
+                lines.push(fc.code.trim());
+                lines.push("```");
+            }
+        }
+        if (entry.prevention?.length) {
+            lines.push("", "**Prevention:**");
+            for (const p of entry.prevention) {
+                lines.push(`- ${p}`);
+            }
+        }
+        if (entry.docs?.length) {
+            lines.push("", "**Docs:**");
+            for (const d of entry.docs) {
+                lines.push(`- [${d.label}](${d.url})`);
+            }
+        }
+        if (entry.source?.article) {
+            lines.push("", `**Source:** [Full Guide](${entry.source.article})`);
+        }
+        return lines.join("\n");
+    })
+        .join("\n\n---\n\n");
+}
+//# sourceMappingURL=lookup-error.js.map

package/dist/tools/lookup-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-error.js","sourceRoot":"","sources":["../../src/tools/lookup-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOlD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,EAAiB,EACjB,YAAoB,EACpB,aAAqB,CAAC;IAEtB,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,2CAA2C;YAC3C,EAAE;YACF,kBAAkB;YAClB,oEAAoE;YACpE,4CAA4C;YAC5C,mFAAmF;SACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG;YACZ,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;YACrD,EAAE;YACF,iBAAiB,KAAK,CAAC,QAAQ,oBAAoB,KAAK,CAAC,QAAQ,EAAE;YACnE,EAAE;YACF,iBAAiB;YACjB,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE;YACvB,EAAE;YACF,UAAU;YACV,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;SACjB,CAAC;QAEF,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAClC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;SACD,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/tools/search-errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * search_errors tool — full-text search across the error database.
+ */
+import type { ErrorDatabase, ErrorEntry } from "../db/types.js";
+/**
+ * Search the error database by keyword, tag, or category.
+ */
+export declare function searchErrors(db: ErrorDatabase, query: string, options?: {
+    category?: string;
+    severity?: string;
+    maxResults?: number;
+}): ErrorEntry[];
+/**
+ * Format search results as human-readable string.
+ */
+export declare function formatSearchResult(results: ErrorEntry[]): string;
+//# sourceMappingURL=search-errors.d.ts.map

package/dist/tools/search-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-errors.d.ts","sourceRoot":"","sources":["../../src/tools/search-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,UAAU,EAAE,CAGd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAqBhE"}

package/dist/tools/search-errors.js

@@ -0,0 +1,33 @@
+/**
+ * search_errors tool — full-text search across the error database.
+ */
+import { searchByKeyword } from "../db/search.js";
+/**
+ * Search the error database by keyword, tag, or category.
+ */
+export function searchErrors(db, query, options) {
+    const results = searchByKeyword(db, query, options);
+    return results.map(r => r.entry);
+}
+/**
+ * Format search results as human-readable string.
+ */
+export function formatSearchResult(results) {
+    if (results.length === 0) {
+        return "No results found. Try a different search query or browse categories with `list_categories`.";
+    }
+    const lines = [
+        `## Search Results (${results.length} match${results.length === 1 ? "" : "es"})`,
+        "",
+    ];
+    for (const entry of results) {
+        lines.push(`### ${entry.title}`);
+        lines.push(`**ID:** ${entry.id} | **Category:** ${entry.category} | **Severity:** ${entry.severity}`);
+        lines.push("");
+        lines.push(entry.root_cause.trim().split("\n")[0] + "...");
+        lines.push("");
+    }
+    lines.push(`*Source: [Full Guide](https://htek.dev/articles/github-actions-debugging-guide)*`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=search-errors.js.map

package/dist/tools/search-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-errors.js","sourceRoot":"","sources":["../../src/tools/search-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAiB,EACjB,KAAa,EACb,OAIC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,6FAA6F,CAAC;IACvG,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,sBAAsB,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG;QAChF,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE,oBAAoB,KAAK,CAAC,QAAQ,oBAAoB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IAE/F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/suggest-fix.d.ts

@@ -0,0 +1,13 @@
+/**
+ * suggest_fix tool — contextual fix suggestions.
+ */
+import type { ErrorDatabase, ErrorEntry } from "../db/types.js";
+/**
+ * Suggest a fix given broader error context.
+ */
+export declare function suggestFix(db: ErrorDatabase, errorContext: string, category?: string): ErrorEntry[];
+/**
+ * Format suggest_fix results.
+ */
+export declare function formatSuggestResult(results: ErrorEntry[]): string;
+//# sourceMappingURL=suggest-fix.d.ts.map

package/dist/tools/suggest-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-fix.d.ts","sourceRoot":"","sources":["../../src/tools/suggest-fix.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;GAEG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,EAAE,CAUd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CA8CjE"}

package/dist/tools/suggest-fix.js

@@ -0,0 +1,62 @@
+/**
+ * suggest_fix tool — contextual fix suggestions.
+ */
+import { lookupByPattern, searchByKeyword } from "../db/search.js";
+/**
+ * Suggest a fix given broader error context.
+ */
+export function suggestFix(db, errorContext, category) {
+    // Try regex matching first
+    let results = lookupByPattern(db, errorContext, 5);
+    // If no regex matches, try keyword search
+    if (results.length === 0) {
+        results = searchByKeyword(db, errorContext, { category, maxResults: 5 });
+    }
+    return results.map(r => r.entry);
+}
+/**
+ * Format suggest_fix results.
+ */
+export function formatSuggestResult(results) {
+    if (results.length === 0) {
+        return [
+            "No matching errors found for this context.",
+            "",
+            "**Try:**",
+            "1. Paste the exact error message for a more precise match",
+            "2. Search by category: `search_errors` with a category filter",
+            "3. Check the full guide: https://htek.dev/articles/github-actions-debugging-guide",
+        ].join("\n");
+    }
+    const best = results[0];
+    const lines = [
+        `## Suggested Fix: ${best.title}`,
+        "",
+        `**Category:** ${best.category} | **Severity:** ${best.severity}`,
+        "",
+        `**Root Cause:**`,
+        best.root_cause.trim(),
+        "",
+        `**Fix:**`,
+        best.fix.trim(),
+    ];
+    if (best.fix_code?.length) {
+        lines.push("");
+        for (const fc of best.fix_code) {
+            lines.push(`\`\`\`${fc.language}`);
+            lines.push(fc.code.trim());
+            lines.push("```");
+        }
+    }
+    if (results.length > 1) {
+        lines.push("", "**Other possible matches:**");
+        for (const entry of results.slice(1)) {
+            lines.push(`- ${entry.title} (${entry.category})`);
+        }
+    }
+    if (best.source?.article) {
+        lines.push("", `**Source:** [Full Guide](${best.source.article})`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=suggest-fix.js.map

package/dist/tools/suggest-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-fix.js","sourceRoot":"","sources":["../../src/tools/suggest-fix.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,EAAiB,EACjB,YAAoB,EACpB,QAAiB;IAEjB,2BAA2B;IAC3B,IAAI,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAEnD,0CAA0C;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,4CAA4C;YAC5C,EAAE;YACF,UAAU;YACV,2DAA2D;YAC3D,+DAA+D;YAC/D,mFAAmF;SACpF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG;QACZ,qBAAqB,IAAI,CAAC,KAAK,EAAE;QACjC,EAAE;QACF,iBAAiB,IAAI,CAAC,QAAQ,oBAAoB,IAAI,CAAC,QAAQ,EAAE;QACjE,EAAE;QACF,iBAAiB;QACjB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QACtB,EAAE;QACF,UAAU;QACV,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;KAChB,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,6BAA6B,CAAC,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/utils/pattern-matcher.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Regex pattern safety utilities.
+ * Validates that user-contributed regex patterns are safe to execute.
+ */
+/**
+ * Check if a regex pattern is safe to use at runtime.
+ * Returns true if safe, false if potentially dangerous.
+ */
+export declare function isRegexSafe(pattern: string): boolean;
+/**
+ * Safely execute a regex match with timeout protection.
+ * Truncates input to prevent unbounded matching.
+ */
+export declare function safeMatch(pattern: string, flags: string, input: string, maxInputLength?: number): boolean;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/utils/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAgBpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAe,GAC9B,OAAO,CAST"}

package/dist/utils/pattern-matcher.js

@@ -0,0 +1,50 @@
+/**
+ * Regex pattern safety utilities.
+ * Validates that user-contributed regex patterns are safe to execute.
+ */
+/** Maximum allowed regex source length */
+const MAX_REGEX_LENGTH = 500;
+/** Patterns that suggest catastrophic backtracking */
+const DANGEROUS_PATTERNS = [
+    /\(\.\*\)\+/, // (.*)+
+    /\(\.\+\)\+/, // (.+)+
+    /\(\[^\\]\]\*\)\+/, // ([^x]*)+
+    /\(\.\{[^}]+\}\)\+/, // (.{n})+
+    /\(\.\*\)\{/, // (.*){
+];
+/**
+ * Check if a regex pattern is safe to use at runtime.
+ * Returns true if safe, false if potentially dangerous.
+ */
+export function isRegexSafe(pattern) {
+    if (pattern.length > MAX_REGEX_LENGTH)
+        return false;
+    // Try to compile it
+    try {
+        new RegExp(pattern);
+    }
+    catch {
+        return false;
+    }
+    // Check for known dangerous patterns
+    for (const dangerous of DANGEROUS_PATTERNS) {
+        if (dangerous.test(pattern))
+            return false;
+    }
+    return true;
+}
+/**
+ * Safely execute a regex match with timeout protection.
+ * Truncates input to prevent unbounded matching.
+ */
+export function safeMatch(pattern, flags, input, maxInputLength = 10_000) {
+    const truncated = input.slice(0, maxInputLength);
+    try {
+        const re = new RegExp(pattern, flags);
+        return re.test(truncated);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/utils/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../src/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0CAA0C;AAC1C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,sDAAsD;AACtD,MAAM,kBAAkB,GAAG;IACzB,YAAY,EAAY,QAAQ;IAChC,YAAY,EAAY,QAAQ;IAChC,kBAAkB,EAAM,WAAW;IACnC,mBAAmB,EAAK,UAAU;IAClC,YAAY,EAAY,QAAQ;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAEpD,oBAAoB;IACpB,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,KAAa,EACb,KAAa,EACb,iBAAyB,MAAM;IAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}