codex-plugin-doctor 1.42.0 → 1.43.0

package/README.md

@@ -402,9 +402,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - uses: Esquetta/CodexPluginDoctor@v1.42.0
+      - uses: Esquetta/CodexPluginDoctor@v1.43.0
         with:
-          version: "1.42.0"
+          version: "1.43.0"
           path: .
           runtime: "true"
           policy: codex-publish

package/dist/reporting/recommended-commands.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult } from "../domain/types.js";
+export declare function buildRecommendedCommands(result: CheckResult): string[];

package/dist/reporting/recommended-commands.js

@@ -0,0 +1,17 @@
+function quoteCliArg(value) {
+    return JSON.stringify(value);
+}
+export function buildRecommendedCommands(result) {
+    if (result.findings.length === 0) {
+        return [];
+    }
+    const target = quoteCliArg(result.targetPath);
+    const commands = [
+        `codex-plugin-doctor doctor recommend ${target}`,
+        `codex-plugin-doctor fix ${target} --dry-run`
+    ];
+    if (result.findings.some((finding) => finding.fingerprint)) {
+        commands.push(`codex-plugin-doctor suppress add ${target}`);
+    }
+    return commands;
+}

package/dist/reporting/render-markdown-report.js

@@ -1,5 +1,6 @@
 import { formatFindingEvidenceLine } from "./format-finding-evidence.js";
 import { formatFindingFingerprintLine } from "./finding-fingerprint.js";
+import { buildRecommendedCommands } from "./recommended-commands.js";
 export function buildMarkdownReport(result, options) {
     const failCount = result.findings.filter((finding) => finding.severity === "fail").length;
     const warnCount = result.findings.filter((finding) => finding.severity === "warn").length;
@@ -77,5 +78,12 @@ export function buildMarkdownReport(result, options) {
             lines.push("");
         }
     }
+    const recommendedCommands = buildRecommendedCommands(result);
+    if (recommendedCommands.length > 0) {
+        lines.push("", "## Recommended Commands", "");
+        for (const command of recommendedCommands) {
+            lines.push(`- \`${command}\``);
+        }
+    }
     return lines.join("\n");
 }

package/dist/reporting/render-text-report.js

@@ -1,6 +1,7 @@
 import { findRuleDefinition } from "../rules/rule-catalog.js";
 import { formatFindingEvidenceLine } from "./format-finding-evidence.js";
 import { formatFindingFingerprintLine } from "./finding-fingerprint.js";
+import { buildRecommendedCommands } from "./recommended-commands.js";
 function getCounts(result) {
     const failCount = result.findings.filter((finding) => finding.severity === "fail").length;
     const warnCount = result.findings.filter((finding) => finding.severity === "warn").length;
@@ -118,5 +119,12 @@ export function renderTextReport(result, options = {}) {
         lines.push(`prompts/list: ${result.runtimeScorecard.promptsList}`);
         lines.push(`prompts/get: ${result.runtimeScorecard.promptGet}`);
     }
+    const recommendedCommands = buildRecommendedCommands(result);
+    if (recommendedCommands.length > 0) {
+        lines.push("", "Recommended Commands", "--------------------");
+        for (const command of recommendedCommands) {
+            lines.push(`- ${command}`);
+        }
+    }
     return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-plugin-doctor",
-  "version": "1.42.0",
+  "version": "1.43.0",
   "description": "CLI-first validator for Codex plugins, skills, and MCP package surfaces with runtime MCP protocol validation.",
   "type": "module",
   "main": "./dist/index.js",