codex-plugin-doctor 1.39.0 → 1.41.0

package/README.md

@@ -330,7 +330,7 @@ codex-plugin-doctor check . --json --runtime --verbose-runtime
 
 `check --profile ci|strict|publish` applies named validation policies. `ci` keeps default behavior, `strict` fails on warnings, and `publish` fails on warnings while enabling runtime probing by default.
 
-`check --explain` adds inline rule catalog context to text reports, including why a finding matters, a more detailed fix path, and a compact example.
+`check --explain` adds a deduplicated `Next Actions` summary plus inline rule catalog context to text reports, including the problem summary, rule category, why a finding matters, a more detailed fix path, a compact example, and the matching `codex-plugin-doctor explain <finding-id>` follow-up command.
 
 `check --badge-json` emits Shields endpoint-compatible JSON such as `{"schemaVersion":1,"label":"doctor","message":"PASS","color":"brightgreen"}`. `check --badge-markdown` emits a static shields.io Markdown badge for README or release notes. Badge output is intentionally limited to single package checks, not `check --installed`.
 
@@ -402,9 +402,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - uses: Esquetta/CodexPluginDoctor@v1.39.0
+      - uses: Esquetta/CodexPluginDoctor@v1.41.0
         with:
-          version: "1.39.0"
+          version: "1.41.0"
           path: .
           runtime: "true"
           policy: codex-publish

package/dist/core/init-git-hooks.js

@@ -95,7 +95,7 @@ async function writeHook(hookPath, content, force) {
 export async function removeGitHooks(targetPath) {
     const rootPath = path.resolve(targetPath);
     const hooksDir = path.join(rootPath, ".git", "hooks");
-    const hookNames = [`pre-commit${hookExtension}`, `pre-push${hookExtension}`, "pre-commit", "pre-push"];
+    const hookNames = Array.from(new Set([`pre-commit${hookExtension}`, `pre-push${hookExtension}`, "pre-commit", "pre-push"]));
     const removed = [];
     const skipped = [];
     for (const name of hookNames) {

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

@@ -55,6 +55,15 @@ export function renderTextReport(result, options = {}) {
     }
     const failures = result.findings.filter((finding) => finding.severity === "fail");
     const warnings = result.findings.filter((finding) => finding.severity === "warn");
+    if (explain) {
+        const nextActions = Array.from(new Set([...failures, ...warnings].map((finding) => finding.suggestedFix))).slice(0, 5);
+        if (nextActions.length > 0) {
+            lines.push("", "Next Actions", "------------");
+            for (const [index, action] of nextActions.entries()) {
+                lines.push(`${index + 1}. ${action}`);
+            }
+        }
+    }
     const appendSection = (title, items, marker) => {
         if (items.length === 0) {
             return;
@@ -76,9 +85,12 @@ export function renderTextReport(result, options = {}) {
             if (explain) {
                 const rule = findRuleDefinition(finding.id);
                 if (rule) {
+                    lines.push(`  Problem: ${rule.summary}`);
+                    lines.push(`  Rule: ${rule.category}, ${rule.defaultSeverity}`);
                     lines.push(`  Why: ${rule.why}`);
                     lines.push(`  Fix detail: ${rule.fix}`);
                     lines.push(`  Example: ${rule.example}`);
+                    lines.push(`  Learn more: codex-plugin-doctor explain ${finding.id}`);
                 }
             }
         }

package/package.json

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