@htekdev/actions-debugger 1.0.25 → 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"}