@htekdev/actions-debugger 1.0.26 → 1.0.27

package/README.md

@@ -4,7 +4,7 @@
 [![npm](https://img.shields.io/npm/v/@htekdev/actions-debugger)](https://www.npmjs.com/package/@htekdev/actions-debugger)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-> 65+ real GitHub Actions errors, queryable by agents. MCP server + Copilot skills + error database.
+> 65+ real GitHub Actions errors, queryable by agents. CLI + MCP server + Copilot skills + error database.
 
 **Stop debugging the same CI failures over and over.** This repo packages 65+ real-world GitHub Actions error scenarios — with regex-matchable patterns, root causes, and copy-paste fixes — into formats that both humans and AI agents can consume.
 
@@ -12,13 +12,54 @@
 
 ```
 errors/              → Structured YAML error database (65+ entries)
-src/                 → MCP server (TypeScript + @modelcontextprotocol/sdk)
+src/                 → CLI + MCP server (TypeScript)
 .github/skills/      → Copilot CLI skills for CI debugging
 .github/agents/      → Copilot agent definition
 ```
 
 ## Quick Start
 
+### CLI (Zero Install)
+
+```bash
+# Look up an error
+npx @htekdev/actions-debugger lookup "Permission to org/repo.git denied"
+
+# Search by keyword
+npx @htekdev/actions-debugger search "OIDC" --category permissions-auth
+
+# Diagnose a workflow file
+npx @htekdev/actions-debugger diagnose .github/workflows/ci.yml
+
+# Get fix suggestions
+npx @htekdev/actions-debugger suggest-fix "artifact upload fails intermittently"
+
+# List all categories
+npx @htekdev/actions-debugger categories
+```
+
+#### Output Formats
+
+```bash
+# Text (default for TTY)
+npx @htekdev/actions-debugger lookup "error message"
+
+# JSON (default when piped, or explicit)
+npx @htekdev/actions-debugger lookup "error message" --format json
+
+# Markdown
+npx @htekdev/actions-debugger lookup "error message" --format md
+```
+
+#### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success / matches found |
+| 1 | No matches found |
+| 2 | Invalid input / parse error |
+| 3 | Database load error |
+
 ### As an MCP Server (Claude Desktop, Copilot CLI, Cursor, etc.)
 
 ```bash
@@ -47,10 +88,10 @@ Add to your MCP client config:
 
 ### As a Copilot CLI Skill (No MCP Required)
 
-Copy `.github/skills/actions-debugging/SKILL.md` to your repo's `.github/skills/` directory. Reference it in your agent:
+Copy `.github/skills/actions-debugging-cli/SKILL.md` to your repo's `.github/skills/` directory. Any agent with shell access can use the CLI — no MCP config needed.
 
 ```markdown
-> **Skill reference:** For CI debugging, use the `actions-debugging` skill.
+> **Skill reference:** For CI debugging, use the `actions-debugging-cli` skill.
 ```
 
 ### Programmatic (npm Package)

package/dist/cli/commands/categories.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command: categories — list all error categories.
+ */
+import type { Command } from "commander";
+export declare function registerCategoriesCommand(program: Command): void;
+//# sourceMappingURL=categories.d.ts.map

package/dist/cli/commands/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBhE"}

package/dist/cli/commands/categories.js

@@ -0,0 +1,26 @@
+/**
+ * CLI command: categories — list all error categories.
+ */
+import { loadErrorDatabase } from "../../db/loader.js";
+import { listCategories } from "../../tools/list-categories.js";
+import { detectFormat, formatCategoriesOutput } from "../output.js";
+export function registerCategoriesCommand(program) {
+    program
+        .command("categories")
+        .description("List all error categories with counts")
+        .option("--format <fmt>", "Output format: text, json, md")
+        .action(async (opts) => {
+        try {
+            const db = await loadErrorDatabase();
+            const categories = listCategories(db);
+            const format = detectFormat(opts.format);
+            console.log(formatCategoriesOutput(categories, format));
+            process.exit(0);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(3);
+        }
+    });
+}
+//# sourceMappingURL=categories.js.map

package/dist/cli/commands/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../../src/cli/commands/categories.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/diagnose.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command: diagnose — analyze a workflow YAML file for common issues.
+ */
+import type { Command } from "commander";
+export declare function registerDiagnoseCommand(program: Command): void;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/cli/commands/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diagnose.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B9D"}

package/dist/cli/commands/diagnose.js

@@ -0,0 +1,56 @@
+/**
+ * CLI command: diagnose — analyze a workflow YAML file for common issues.
+ */
+import { readFileSync } from "node:fs";
+import { loadErrorDatabase } from "../../db/loader.js";
+import { diagnoseWorkflow } from "../../tools/diagnose-workflow.js";
+import { detectFormat, formatDiagnoseOutput } from "../output.js";
+export function registerDiagnoseCommand(program) {
+    program
+        .command("diagnose <file>")
+        .description("Analyze a workflow YAML file for common issues")
+        .option("--format <fmt>", "Output format: text, json, md")
+        .action(async (file, opts) => {
+        try {
+            let yaml;
+            if (file === "-") {
+                // Read from stdin
+                yaml = await readStdin();
+            }
+            else {
+                try {
+                    yaml = readFileSync(file, "utf-8");
+                }
+                catch {
+                    console.error(`Error: Cannot read file '${file}'`);
+                    process.exit(2);
+                }
+            }
+            const db = await loadErrorDatabase();
+            const findings = diagnoseWorkflow(db, yaml);
+            const format = detectFormat(opts.format);
+            console.log(formatDiagnoseOutput(findings, format));
+            process.exit(findings.length > 0 ? 0 : 0); // 0 even if findings (analysis success)
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(3);
+        }
+    });
+}
+/**
+ * Read all data from stdin.
+ */
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        process.stdin.on("error", reject);
+        // If stdin is a TTY (no pipe), show a hint and wait briefly
+        if (process.stdin.isTTY) {
+            console.error("Reading workflow YAML from stdin... (Ctrl+D to end)");
+        }
+    });
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/cli/commands/diagnose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.js","sourceRoot":"","sources":["../../../src/cli/commands/diagnose.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAyB,EAAE,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,IAAY,CAAC;YAEjB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,kBAAkB;gBAClB,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,GAAG,CAAC,CAAC;oBACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,wCAAwC;QACrF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,SAAS,SAAS;IAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAElC,4DAA4D;QAC5D,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/lookup.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command: lookup — match error message against known issues.
+ */
+import type { Command } from "commander";
+export declare function registerLookupCommand(program: Command): void;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/cli/commands/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/lookup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB5D"}

package/dist/cli/commands/lookup.js

@@ -0,0 +1,27 @@
+/**
+ * CLI command: lookup — match error message against known issues.
+ */
+import { loadErrorDatabase } from "../../db/loader.js";
+import { lookupError } from "../../tools/lookup-error.js";
+import { detectFormat, formatLookupOutput } from "../output.js";
+export function registerLookupCommand(program) {
+    program
+        .command("lookup <error_message>")
+        .description("Match an error message against known issues")
+        .option("--max-results <n>", "Maximum number of results to return", "3")
+        .option("--format <fmt>", "Output format: text, json, md")
+        .action(async (errorMessage, opts) => {
+        try {
+            const db = await loadErrorDatabase();
+            const results = lookupError(db, errorMessage, parseInt(opts.maxResults, 10));
+            const format = detectFormat(opts.format);
+            console.log(formatLookupOutput(results, format));
+            process.exit(results.length > 0 ? 0 : 1);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(3);
+        }
+    });
+}
+//# sourceMappingURL=lookup.js.map

package/dist/cli/commands/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../../src/cli/commands/lookup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,GAAG,CAAC;SACvE,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,YAAoB,EAAE,IAA6C,EAAE,EAAE;QACpF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command: search — full-text search across the error database.
+ */
+import type { Command } from "commander";
+export declare function registerSearchCommand(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB5D"}

package/dist/cli/commands/search.js

@@ -0,0 +1,33 @@
+/**
+ * CLI command: search — full-text search across the error database.
+ */
+import { loadErrorDatabase } from "../../db/loader.js";
+import { searchErrors } from "../../tools/search-errors.js";
+import { detectFormat, formatSearchOutput } from "../output.js";
+export function registerSearchCommand(program) {
+    program
+        .command("search <query>")
+        .description("Search error database by keyword")
+        .option("--category <cat>", "Filter by category")
+        .option("--severity <sev>", "Filter by severity (error, warning, silent-failure, limitation)")
+        .option("--max-results <n>", "Maximum number of results to return", "10")
+        .option("--format <fmt>", "Output format: text, json, md")
+        .action(async (query, opts) => {
+        try {
+            const db = await loadErrorDatabase();
+            const results = searchErrors(db, query, {
+                category: opts.category,
+                severity: opts.severity,
+                maxResults: parseInt(opts.maxResults, 10),
+            });
+            const format = detectFormat(opts.format);
+            console.log(formatSearchOutput(results, format));
+            process.exit(results.length > 0 ? 0 : 1);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(3);
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;SAChD,MAAM,CAAC,kBAAkB,EAAE,iEAAiE,CAAC;SAC7F,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,IAAI,CAAC;SACxE,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAmF,EAAE,EAAE;QACnH,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE;gBACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;aAC1C,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/suggest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI command: suggest-fix — contextual fix suggestions.
+ */
+import type { Command } from "commander";
+export declare function registerSuggestCommand(program: Command): void;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/cli/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB7D"}

package/dist/cli/commands/suggest.js

@@ -0,0 +1,27 @@
+/**
+ * CLI command: suggest-fix — contextual fix suggestions.
+ */
+import { loadErrorDatabase } from "../../db/loader.js";
+import { suggestFix } from "../../tools/suggest-fix.js";
+import { detectFormat, formatSuggestOutput } from "../output.js";
+export function registerSuggestCommand(program) {
+    program
+        .command("suggest-fix <error_context>")
+        .description("Get contextual fix suggestions for an error")
+        .option("--category <cat>", "Narrow search to a specific category")
+        .option("--format <fmt>", "Output format: text, json, md")
+        .action(async (errorContext, opts) => {
+        try {
+            const db = await loadErrorDatabase();
+            const results = suggestFix(db, errorContext, opts.category);
+            const format = detectFormat(opts.format);
+            console.log(formatSuggestOutput(results, format));
+            process.exit(results.length > 0 ? 0 : 1);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(3);
+        }
+    });
+}
+//# sourceMappingURL=suggest.js.map

package/dist/cli/commands/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,6BAA6B,CAAC;SACtC,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,CAAC;SAClE,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,YAAoB,EAAE,IAA4C,EAAE,EAAE;QACnF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI main — commander program setup and command registration.
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/main.js

@@ -0,0 +1,20 @@
+/**
+ * CLI main — commander program setup and command registration.
+ */
+import { Command } from "commander";
+import { registerLookupCommand } from "./commands/lookup.js";
+import { registerSearchCommand } from "./commands/search.js";
+import { registerDiagnoseCommand } from "./commands/diagnose.js";
+import { registerSuggestCommand } from "./commands/suggest.js";
+import { registerCategoriesCommand } from "./commands/categories.js";
+const program = new Command()
+    .name("actions-debugger")
+    .description("65+ real GitHub Actions errors, queryable from your terminal")
+    .version("1.1.0");
+registerLookupCommand(program);
+registerSearchCommand(program);
+registerDiagnoseCommand(program);
+registerSuggestCommand(program);
+registerCategoriesCommand(program);
+program.parse();
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/output.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Output formatters for CLI commands.
+ * Supports text (human-friendly), json (machine-parseable), and md (markdown).
+ */
+import type { ErrorEntry, DiagnosticFinding, CategoryInfo } from "../db/types.js";
+export type OutputFormat = "text" | "json" | "md";
+/**
+ * Detect the appropriate output format.
+ * TTY → text, piped → json, or explicit user choice.
+ */
+export declare function detectFormat(explicit?: string): OutputFormat;
+export declare function formatLookupOutput(results: ErrorEntry[], format: OutputFormat): string;
+export declare function formatSearchOutput(results: ErrorEntry[], format: OutputFormat): string;
+export declare function formatDiagnoseOutput(findings: DiagnosticFinding[], format: OutputFormat): string;
+export declare function formatSuggestOutput(results: ErrorEntry[], format: OutputFormat): string;
+export declare function formatCategoriesOutput(categories: CategoryInfo[], format: OutputFormat): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAG5D;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAQtF;AAuFD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAQtF;AA8BD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAQhG;AAuCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAQvF;AAqED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAc/F"}

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":"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"}

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/package.json

@@ -1,18 +1,19 @@
 {
   "name": "@htekdev/actions-debugger",
-  "version": "1.0.26",
-  "description": "65+ real GitHub Actions errors, queryable by agents. MCP server + Copilot skills + error database.",
+  "version": "1.0.27",
+  "description": "65+ real GitHub Actions errors, queryable by agents. CLI + MCP server + Copilot skills + error database.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "actions-debugger": "./dist/index.js"
+    "actions-debugger": "./dist/entry.js"
   },
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
-    }
+    },
+    "./mcp": "./dist/mcp.js"
   },
   "files": [
     "dist",
@@ -27,7 +28,9 @@
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "validate-errors": "node --import tsx scripts/validate-errors.ts",
-    "start": "node dist/index.js",
+    "start": "node dist/mcp.js",
+    "start:mcp": "node dist/mcp.js",
+    "start:cli": "node dist/entry.js",
     "prepublishOnly": "npm run build"
   },
   "publishConfig": {
@@ -40,7 +43,8 @@
     "model-context-protocol",
     "copilot",
     "ci-cd",
-    "error-database"
+    "error-database",
+    "cli"
   ],
   "author": "Hector Flores <hector.flores@htek.dev> (https://htek.dev)",
   "license": "MIT",
@@ -54,6 +58,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
+    "commander": "^15.0.0",
     "glob": "^11.0.0",
     "js-yaml": "^4.1.0"
   },