@htekdev/actions-debugger 1.0.26 → 1.0.28

package/dist/cli/output.js

@@ -0,0 +1,311 @@
+/**
+ * Output formatters for CLI commands.
+ * Supports text (human-friendly), json (machine-parseable), and md (markdown).
+ */
+/**
+ * Detect the appropriate output format.
+ * TTY → text, piped → json, or explicit user choice.
+ */
+export function detectFormat(explicit) {
+    if (explicit && explicit !== "auto")
+        return explicit;
+    return process.stdout.isTTY ? "text" : "json";
+}
+// ─── Lookup ─────────────────────────────────────────────────────────────────
+export function formatLookupOutput(results, format) {
+    if (format === "json") {
+        return JSON.stringify({ matches: results.map(entryToJson) }, null, 2);
+    }
+    if (format === "md") {
+        return formatLookupMd(results);
+    }
+    return formatLookupText(results);
+}
+function formatLookupText(results) {
+    if (results.length === 0) {
+        return "No matching errors found.\n\nTry `actions-debugger search <keyword>` for broader results.";
+    }
+    return results.map((entry) => {
+        const lines = [
+            `✓ Match: ${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.label || fc.language}:`);
+                for (const line of fc.code.trim().split("\n")) {
+                    lines.push(`    ${line}`);
+                }
+            }
+        }
+        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}`);
+            }
+        }
+        return lines.join("\n");
+    }).join("\n\n---\n\n");
+}
+function formatLookupMd(results) {
+    if (results.length === 0) {
+        return "No matching errors found.";
+    }
+    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) {
+            for (const fc of entry.fix_code) {
+                lines.push("", `\`\`\`${fc.language}`, fc.code.trim(), "```");
+            }
+        }
+        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})`);
+            }
+        }
+        return lines.join("\n");
+    }).join("\n\n---\n\n");
+}
+// ─── Search ─────────────────────────────────────────────────────────────────
+export function formatSearchOutput(results, format) {
+    if (format === "json") {
+        return JSON.stringify({ matches: results.map(entryToJson) }, null, 2);
+    }
+    if (format === "md") {
+        return formatSearchMd(results);
+    }
+    return formatSearchText(results);
+}
+function formatSearchText(results) {
+    if (results.length === 0) {
+        return "No results found. Try different keywords or browse with `actions-debugger categories`.";
+    }
+    const lines = [`Found ${results.length} result(s):`, ""];
+    for (const entry of results) {
+        lines.push(`  ${entry.title}`);
+        lines.push(`    ${entry.category} | ${entry.severity} | ${entry.root_cause.trim().split("\n")[0]}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatSearchMd(results) {
+    if (results.length === 0)
+        return "No results found.";
+    const lines = [`## Search Results (${results.length})`, ""];
+    for (const entry of results) {
+        lines.push(`### ${entry.title}`);
+        lines.push(`**Category:** ${entry.category} | **Severity:** ${entry.severity}`);
+        lines.push("", entry.root_cause.trim().split("\n")[0], "");
+    }
+    return lines.join("\n");
+}
+// ─── Diagnose ───────────────────────────────────────────────────────────────
+export function formatDiagnoseOutput(findings, format) {
+    if (format === "json") {
+        return JSON.stringify({ findings }, null, 2);
+    }
+    if (format === "md") {
+        return formatDiagnoseMd(findings);
+    }
+    return formatDiagnoseText(findings);
+}
+function formatDiagnoseText(findings) {
+    if (findings.length === 0) {
+        return "✅ No issues found. Workflow looks good!";
+    }
+    const lines = [`Found ${findings.length} issue(s):`, ""];
+    const icons = { critical: "🔴", high: "🟠", medium: "🟡", low: "🔵" };
+    for (const f of findings) {
+        lines.push(`  ${icons[f.severity] || "•"} [${f.severity}] ${f.message}`);
+        lines.push(`    Fix: ${f.fix}`);
+        if (f.fix_code) {
+            for (const line of f.fix_code.split("\n")) {
+                lines.push(`      ${line}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatDiagnoseMd(findings) {
+    if (findings.length === 0)
+        return "✅ No issues found.";
+    const lines = [`## Workflow Analysis — ${findings.length} issue(s)`, ""];
+    for (const f of findings) {
+        lines.push(`- **[${f.severity}]** ${f.message}`);
+        lines.push(`  - Fix: ${f.fix}`);
+        if (f.fix_code) {
+            lines.push("  ```", `  ${f.fix_code}`, "  ```");
+        }
+    }
+    return lines.join("\n");
+}
+// ─── Suggest ────────────────────────────────────────────────────────────────
+export function formatSuggestOutput(results, format) {
+    if (format === "json") {
+        return JSON.stringify({ suggestions: results.map(entryToJson) }, null, 2);
+    }
+    if (format === "md") {
+        return formatSuggestMd(results);
+    }
+    return formatSuggestText(results);
+}
+function formatSuggestText(results) {
+    if (results.length === 0) {
+        return "No matching suggestions. Try `actions-debugger lookup <exact error message>` for better results.";
+    }
+    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.label || fc.language}:`);
+            for (const line of fc.code.trim().split("\n")) {
+                lines.push(`    ${line}`);
+            }
+        }
+    }
+    if (results.length > 1) {
+        lines.push("", "  Other possible matches:");
+        for (const entry of results.slice(1)) {
+            lines.push(`    - ${entry.title} (${entry.category})`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatSuggestMd(results) {
+    if (results.length === 0)
+        return "No matching suggestions.";
+    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) {
+        for (const fc of best.fix_code) {
+            lines.push("", `\`\`\`${fc.language}`, fc.code.trim(), "```");
+        }
+    }
+    if (results.length > 1) {
+        lines.push("", "**Other possible matches:**");
+        for (const entry of results.slice(1)) {
+            lines.push(`- ${entry.title} (${entry.category})`);
+        }
+    }
+    return lines.join("\n");
+}
+// ─── Categories ─────────────────────────────────────────────────────────────
+export function formatCategoriesOutput(categories, format) {
+    if (format === "json") {
+        return JSON.stringify({
+            categories: categories.map((c) => ({
+                name: c.name,
+                count: c.count,
+                severities: c.severities,
+            })),
+        }, null, 2);
+    }
+    if (format === "md") {
+        return formatCategoriesMd(categories);
+    }
+    return formatCategoriesText(categories);
+}
+function formatCategoriesText(categories) {
+    const total = categories.reduce((sum, c) => sum + c.count, 0);
+    const nameWidth = Math.max(...categories.map((c) => c.name.length), 10);
+    const lines = [
+        `Error Categories (${total} total errors)`,
+        "",
+        `${"Category".padEnd(nameWidth)}  Count  Severities`,
+        "─".repeat(nameWidth + 40),
+    ];
+    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.padEnd(nameWidth)}  ${String(cat.count).padStart(5)}  ${sevParts.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+function formatCategoriesMd(categories) {
+    const total = categories.reduce((sum, c) => sum + c.count, 0);
+    const lines = [
+        `## Error Categories (${total} total)`,
+        "",
+        "| 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(", ")} |`);
+    }
+    return lines.join("\n");
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function entryToJson(entry) {
+    return {
+        id: entry.id,
+        title: entry.title,
+        category: entry.category,
+        severity: entry.severity,
+        root_cause: entry.root_cause.trim(),
+        fix: entry.fix.trim(),
+        fix_code: entry.fix_code?.map((fc) => ({ language: fc.language, code: fc.code.trim() })),
+        prevention: entry.prevention,
+        docs: entry.docs,
+        tags: entry.tags,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,IAAI,QAAQ,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,QAAwB,CAAC;IACrE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,MAAoB;IAC5E,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,2FAA2F,CAAC;IACrG,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG;YACZ,YAAY,KAAK,CAAC,KAAK,EAAE;YACzB,eAAe,KAAK,CAAC,QAAQ,gBAAgB,KAAK,CAAC,QAAQ,EAAE;YAC7D,EAAE;YACF,iBAAiB,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;YAC1C,EAAE;YACF,UAAU,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;SAC7B,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,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC5C,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC9B,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,mBAAmB,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;YAC5C,EAAE;YACF,YAAY,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;SAC/B,CAAC;QAEF,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAChE,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,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,MAAoB;IAC5E,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,wFAAwF,CAAC;IAClG,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAErD,MAAM,KAAK,GAAG,CAAC,sBAAsB,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,QAAQ,oBAAoB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,oBAAoB,CAAC,QAA6B,EAAE,MAAoB;IACtF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA6B;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,yCAAyC,CAAC;IACnD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,SAAS,QAAQ,CAAC,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,GAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAE9F,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA6B;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAEvD,MAAM,KAAK,GAAG,CAAC,0BAA0B,QAAQ,CAAC,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB,CAAC,OAAqB,EAAE,MAAoB;IAC7E,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAqB;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,kGAAkG,CAAC;IAC5G,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG;QACZ,oBAAoB,IAAI,CAAC,KAAK,EAAE;QAChC,eAAe,IAAI,CAAC,QAAQ,gBAAgB,IAAI,CAAC,QAAQ,EAAE;QAC3D,EAAE;QACF,iBAAiB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;QACzC,EAAE;QACF,UAAU,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KAC5B,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,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,OAAqB;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IAE5D,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,mBAAmB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;QAC3C,EAAE;QACF,YAAY,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KAC9B,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAChE,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,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,sBAAsB,CAAC,UAA0B,EAAE,MAAoB;IACrF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;SACJ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,UAA0B;IACtD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG;QACZ,qBAAqB,KAAK,gBAAgB;QAC1C,EAAE;QACF,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,qBAAqB;QACpD,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;KAC3B,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,CACR,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA0B;IACpD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG;QACZ,wBAAwB,KAAK,SAAS;QACtC,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,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAE/E,SAAS,WAAW,CAAC,KAAiB;IACpC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE;QACnC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/entry.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Unified entry point for @htekdev/actions-debugger.
+ *
+ * Detection logic:
+ * - Known subcommand (lookup, search, diagnose, suggest-fix, categories) → CLI mode
+ * - --help, --version, or flag starting with - → CLI mode (commander handles it)
+ * - No args or --mcp → MCP server mode (backward compatible)
+ * - Unknown arg → MCP server mode (fallback)
+ */
+export {};
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/entry.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * Unified entry point for @htekdev/actions-debugger.
+ *
+ * Detection logic:
+ * - Known subcommand (lookup, search, diagnose, suggest-fix, categories) → CLI mode
+ * - --help, --version, or flag starting with - → CLI mode (commander handles it)
+ * - No args or --mcp → MCP server mode (backward compatible)
+ * - Unknown arg → MCP server mode (fallback)
+ */
+const CLI_COMMANDS = ["lookup", "search", "diagnose", "suggest-fix", "categories"];
+const firstArg = process.argv[2];
+if (!firstArg || firstArg === "--mcp") {
+    // MCP server mode — dynamic import to keep startup fast for CLI
+    import("./mcp.js");
+}
+else if (CLI_COMMANDS.includes(firstArg) ||
+    firstArg === "--help" ||
+    firstArg === "-h" ||
+    firstArg === "--version" ||
+    firstArg === "-V") {
+    // CLI mode
+    import("./cli/main.js");
+}
+else {
+    // Unknown arg — fallback to MCP for backward compat
+    import("./mcp.js");
+}
+export {};
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;AAEnF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjC,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;IACtC,gEAAgE;IAChE,MAAM,CAAC,UAAU,CAAC,CAAC;AACrB,CAAC;KAAM,IACL,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/B,QAAQ,KAAK,QAAQ;IACrB,QAAQ,KAAK,IAAI;IACjB,QAAQ,KAAK,WAAW;IACxB,QAAQ,KAAK,IAAI,EACjB,CAAC;IACD,WAAW;IACX,MAAM,CAAC,eAAe,CAAC,CAAC;AAC1B,CAAC;KAAM,CAAC;IACN,oDAAoD;IACpD,MAAM,CAAC,UAAU,CAAC,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -1,12 +1,11 @@
-#!/usr/bin/env node
 /**
- * @htekdev/actions-debugger — MCP server entry point.
+ * @htekdev/actions-debugger — Programmatic API exports.
  *
  * 65+ real GitHub Actions errors, queryable by agents.
- * Runs as a stdio MCP server for Claude Desktop, Copilot CLI, Cursor, etc.
  *
- * Usage:
- *   npx @htekdev/actions-debugger
+ * For MCP server: import from "@htekdev/actions-debugger/mcp"
+ * For CLI: npx @htekdev/actions-debugger <command>
+ * For library: import { lookupError, searchErrors } from "@htekdev/actions-debugger"
  *
  * Source: https://htek.dev/articles/github-actions-debugging-guide
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,44 +1,19 @@
-#!/usr/bin/env node
 /**
- * @htekdev/actions-debugger — MCP server entry point.
+ * @htekdev/actions-debugger — Programmatic API exports.
  *
  * 65+ real GitHub Actions errors, queryable by agents.
- * Runs as a stdio MCP server for Claude Desktop, Copilot CLI, Cursor, etc.
  *
- * Usage:
- *   npx @htekdev/actions-debugger
+ * For MCP server: import from "@htekdev/actions-debugger/mcp"
+ * For CLI: npx @htekdev/actions-debugger <command>
+ * For library: import { lookupError, searchErrors } from "@htekdev/actions-debugger"
  *
  * Source: https://htek.dev/articles/github-actions-debugging-guide
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { loadErrorDatabase } from "./db/loader.js";
-import { registerTools } from "./server.js";
-// Re-export programmatic API
+// Core API exports
 export { loadErrorDatabase } from "./db/loader.js";
 export { lookupError } from "./tools/lookup-error.js";
 export { diagnoseWorkflow } from "./tools/diagnose-workflow.js";
 export { suggestFix } from "./tools/suggest-fix.js";
 export { listCategories } from "./tools/list-categories.js";
 export { searchErrors } from "./tools/search-errors.js";
-/**
- * Start the MCP server if running as CLI.
- */
-async function main() {
-    const db = await loadErrorDatabase();
-    const server = new Server({ name: "actions-debugger", version: "1.0.0" }, { capabilities: { tools: {} } });
-    registerTools(server, db);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-// Only start server when running as CLI (not when imported as library)
-const isMainModule = process.argv[1] &&
-    (process.argv[1].endsWith("index.js") ||
-        process.argv[1].endsWith("actions-debugger"));
-if (isMainModule) {
-    main().catch((err) => {
-        console.error("Fatal error:", err);
-        process.exit(1);
-    });
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAWxD;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,MAAM,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAElD,IAAI,YAAY,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ * Starts the stdio MCP server for Claude Desktop, Copilot CLI, Cursor, etc.
+ *
+ * Usage:
+ *   npx @htekdev/actions-debugger       (no subcommand → MCP mode)
+ *   node dist/mcp.js
+ */
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/mcp.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ * Starts the stdio MCP server for Claude Desktop, Copilot CLI, Cursor, etc.
+ *
+ * Usage:
+ *   npx @htekdev/actions-debugger       (no subcommand → MCP mode)
+ *   node dist/mcp.js
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadErrorDatabase } from "./db/loader.js";
+import { registerTools } from "./server.js";
+async function main() {
+    const db = await loadErrorDatabase();
+    const server = new Server({ name: "actions-debugger", version: "1.1.0" }, { capabilities: { tools: {} } });
+    registerTools(server, db);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/errors/runner-environment/container-job-entrypoint-overridden.yml

@@ -0,0 +1,90 @@
+id: runner-environment-080
+title: "Container job ENTRYPOINT silently overridden by GitHub Actions runner"
+category: runner-environment
+severity: silent-failure
+tags:
+  - container
+  - docker
+  - entrypoint
+  - job-container
+  - dockerfile
+  - initialization
+patterns:
+  - regex: 'ENTRYPOINT.*not.*execut|entrypoint.*not.*run|entrypoint.*overrid|custom.*entrypoint.*skip'
+    flags: 'i'
+  - regex: 'container.*init.*fail|setup.*script.*not.*run'
+    flags: 'i'
+error_messages:
+  - "Custom initialization script did not run in container job"
+  - "Expected environment setup from ENTRYPOINT was missing"
+  - "Docker container ENTRYPOINT not executing in GitHub Actions"
+root_cause: |
+  When a workflow job uses a container image via the container: key, the GitHub
+  Actions runner creates the container with --entrypoint "", explicitly replacing
+  any ENTRYPOINT defined in the Docker image with an empty string. This is by
+  design: the runner must inject its own workspace setup and process management
+  before any user steps run.
+
+  As a result, ENTRYPOINT instructions in the container Dockerfile are silently
+  ignored. Steps then run via docker exec into the already-running container, so
+  the ENTRYPOINT never fires. Initialization logic that developers expect to run
+  (environment setup, tool configuration, user switching) simply does not happen.
+
+  This is distinct from Docker container ACTIONS (action.yml with runs.using:
+  docker), which DO execute ENTRYPOINT as specified. The override only applies to
+  workflow job containers (jobs.<id>.container:).
+fix: |
+  Choose one of these approaches:
+
+  1. Move initialization to CMD. GitHub Actions does not override CMD, and the
+     docker container options: field lets you pass --entrypoint pointing to your
+     init script.
+
+  2. Use the container options: field to specify the entrypoint explicitly:
+     options: --entrypoint /path/to/init.sh
+
+  3. Add an explicit initialization step at the top of the job. This is the most
+     transparent approach: the step runs before other steps and is visible in logs.
+
+  4. Switch to a Docker container ACTION (action.yml) if you need ENTRYPOINT
+     semantics and own the action definition.
+fix_code:
+  - language: yaml
+    label: "Option A: Override entrypoint via container options"
+    code: |
+      jobs:
+        build:
+          runs-on: ubuntu-latest
+          container:
+            image: my-custom-image:latest
+            options: --entrypoint /usr/local/bin/my-init.sh
+          steps:
+            - name: Run build
+              run: make build
+
+  - language: yaml
+    label: "Option B: Run initialization as an explicit first step (most transparent)"
+    code: |
+      jobs:
+        build:
+          runs-on: ubuntu-latest
+          container:
+            image: my-custom-image:latest
+          steps:
+            - name: Initialize environment
+              run: /usr/local/bin/my-init.sh
+            - name: Run build
+              run: make build
+prevention:
+  - "Do not rely on ENTRYPOINT for initialization in workflow job containers"
+  - "Use CMD for default command arguments; keep setup in workflow steps or the options: field"
+  - "Test container behavior locally with docker run --entrypoint '' myimage bash to simulate GitHub Actions"
+  - "Use Docker container actions (action.yml with runs.using: docker) when ENTRYPOINT execution is required"
+  - "Document any ENTRYPOINT logic removal in a comment in the Dockerfile"
+docs:
+  - url: "https://docs.github.com/en/actions/reference/dockerfile-support-for-github-actions"
+    label: "Dockerfile support for GitHub Actions"
+  - url: "https://docs.github.com/en/actions/using-jobs/running-jobs-in-a-container"
+    label: "Running jobs in a container"
+  - url: "https://github.com/actions/runner/issues/1964"
+    label: "actions/runner#1964: Docker entrypoint not executing in container jobs (open, 8 reactions)"