codex-plugin-doctor 0.19.0 → 0.20.0

package/README.md

@@ -330,15 +330,18 @@ jobs:
   doctor:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: Esquetta/CodexPluginDoctor@v0.9.0
+      - uses: actions/checkout@v4
+      - uses: Esquetta/CodexPluginDoctor@v0.20.0
         with:
-          version: "0.9.0"
+          version: "0.20.0"
           path: .
-          runtime: "false"
-```
-
-For runtime probing, SARIF output, installed plugin cache checks, and pinned release examples, see [GitHub Action Usage](./docs/engineering/github-action-usage.md).
+          runtime: "true"
+          policy: codex-publish
+          upload-artifact: "true"
+          artifact-name: codex-plugin-doctor-reports
+```
+
+The action writes `codex-plugin-doctor-summary.md`, `codex-plugin-doctor-report.json`, and optional `codex-plugin-doctor.sarif` files to `codex-plugin-doctor-reports`, appends the Markdown report to the GitHub Actions step summary, uploads the report directory as an artifact, and then returns the real validation exit code. For runtime probing, SARIF output, installed plugin cache checks, CI policy presets, and pinned release examples, see [GitHub Action Usage](./docs/engineering/github-action-usage.md).
 
 To self-test this repository after cloning it:
 

package/dist/core/init-ci.js

@@ -21,6 +21,13 @@ function buildWorkflow() {
         `          version: \"${packageVersion}\"`,
         "          path: .",
         "          runtime: \"true\"",
+        "          policy: codex-publish",
+        "          json: \"true\"",
+        "          markdown: \"true\"",
+        "          sarif: \"true\"",
+        "          upload-artifact: \"true\"",
+        "          step-summary: \"true\"",
+        "          artifact-name: codex-plugin-doctor-reports",
         ""
     ].join("\n");
 }

package/dist/core/output-contract.js

@@ -7,6 +7,12 @@ const publicSchemaDefinitions = [
         command: "codex-plugin-doctor check <path> --json",
         required: ["schemaVersion", "generatedAt", "summary", "findings"]
     },
+    {
+        id: "doctor.installed.check.json",
+        command: "codex-plugin-doctor check --installed --json",
+        outputKind: "doctor.installed.check",
+        required: ["schemaVersion", "kind", "generatedAt", "summary", "plugins"]
+    },
     {
         id: "doctor.security.json",
         command: "codex-plugin-doctor security <path> --json",

package/dist/reporting/render-installed-machine-report.d.ts

@@ -0,0 +1,37 @@
+import type { CompatibilityMatrix } from "../compatibility/compatibility-matrix.js";
+import type { InstalledPlugin } from "../core/discover-installed-plugins.js";
+import type { CheckResult, JsonReport } from "../domain/types.js";
+export interface InstalledCheckItem {
+    plugin: InstalledPlugin;
+    result: CheckResult;
+    compatibilityMatrix?: CompatibilityMatrix;
+}
+export interface InstalledCheckJsonReport {
+    schemaVersion: "1.0.0";
+    kind: "doctor.installed.check";
+    generatedAt: string;
+    summary: {
+        status: "pass" | "warn" | "fail";
+        checked: number;
+        pass: number;
+        warn: number;
+        fail: number;
+    };
+    plugins: Array<{
+        plugin: {
+            name: string;
+            version?: string;
+            rootPath: string;
+            relativePath: string;
+        };
+        report: JsonReport;
+        compatibilityMatrix?: CompatibilityMatrix;
+    }>;
+}
+export declare function buildInstalledJsonReport(items: InstalledCheckItem[], options: {
+    runtimeProbeEnabled: boolean;
+}): InstalledCheckJsonReport;
+export declare function renderInstalledJsonReport(items: InstalledCheckItem[], options: {
+    runtimeProbeEnabled: boolean;
+}): string;
+export declare function renderInstalledSarifReport(items: InstalledCheckItem[]): string;

package/dist/reporting/render-installed-machine-report.js

@@ -0,0 +1,56 @@
+import { buildJsonReport } from "./render-json-report.js";
+import { renderSarifReport } from "./render-sarif-report.js";
+function summarizeStatus(items) {
+    const pass = items.filter((item) => item.result.status === "pass").length;
+    const warn = items.filter((item) => item.result.status === "warn").length;
+    const fail = items.filter((item) => item.result.status === "fail").length;
+    return {
+        status: fail > 0 ? "fail" : warn > 0 ? "warn" : "pass",
+        checked: items.length,
+        pass,
+        warn,
+        fail
+    };
+}
+export function buildInstalledJsonReport(items, options) {
+    return {
+        schemaVersion: "1.0.0",
+        kind: "doctor.installed.check",
+        generatedAt: new Date().toISOString(),
+        summary: summarizeStatus(items),
+        plugins: items.map((item) => ({
+            plugin: {
+                name: item.plugin.name,
+                ...(item.plugin.version ? { version: item.plugin.version } : {}),
+                rootPath: item.plugin.rootPath,
+                relativePath: item.plugin.relativePath
+            },
+            report: buildJsonReport(item.result, options),
+            ...(item.compatibilityMatrix ? { compatibilityMatrix: item.compatibilityMatrix } : {})
+        }))
+    };
+}
+export function renderInstalledJsonReport(items, options) {
+    return JSON.stringify(buildInstalledJsonReport(items, options), null, 2);
+}
+export function renderInstalledSarifReport(items) {
+    const runs = items.flatMap((item) => {
+        const sarif = JSON.parse(renderSarifReport(item.result));
+        return sarif.runs.map((run) => ({
+            ...run,
+            automationDetails: {
+                id: item.plugin.name
+            },
+            properties: {
+                pluginName: item.plugin.name,
+                ...(item.plugin.version ? { pluginVersion: item.plugin.version } : {}),
+                pluginPath: item.plugin.rootPath
+            }
+        }));
+    });
+    return JSON.stringify({
+        version: "2.1.0",
+        $schema: "https://json.schemastore.org/sarif-2.1.0.json",
+        runs
+    }, null, 2);
+}

package/dist/run-cli.js

@@ -30,6 +30,7 @@ import { initPluginPackage, initPluginTemplates, isInitPluginTemplate } from "./
 import { runCheck } from "./index.js";
 import { buildGenericMcpDoctor, renderGenericMcpDoctor, renderGenericMcpDoctorJson } from "./mcp/generic-mcp-doctor.js";
 import { renderInstalledSummary } from "./reporting/render-installed-summary.js";
+import { renderInstalledJsonReport, renderInstalledSarifReport } from "./reporting/render-installed-machine-report.js";
 import { renderBadgeJson, renderBadgeMarkdown } from "./reporting/render-badge-report.js";
 import { renderCompatibilityScorecard } from "./reporting/render-compatibility-scorecard.js";
 import { renderCompatibilityReport } from "./reporting/render-compatibility-report.js";
@@ -1016,18 +1017,18 @@ export async function runCli(args, io = defaultIo, options = {}) {
         }
         const report = installedSummary
             ? renderInstalledSummary(checkedPlugins)
-            : checkedPlugins
-                .map((item) => sarifOutput
-                ? renderSarifReport(item.result)
-                : markdownOutput
-                    ? buildMarkdownReport(item.result, { runtimeProbeEnabled: effectiveRuntimeProbeEnabled })
-                    : jsonOutput
-                        ? renderJsonReport(item.result, { runtimeProbeEnabled: effectiveRuntimeProbeEnabled })
+            : sarifOutput
+                ? renderInstalledSarifReport(checkedPlugins)
+                : jsonOutput
+                    ? renderInstalledJsonReport(checkedPlugins, { runtimeProbeEnabled: effectiveRuntimeProbeEnabled })
+                    : checkedPlugins
+                        .map((item) => markdownOutput
+                        ? buildMarkdownReport(item.result, { runtimeProbeEnabled: effectiveRuntimeProbeEnabled })
                         : renderTextReport(item.result, {
                             ascii: outputPolicy.style === "ascii",
                             explain: explainFindings
                         }))
-                .join("\n\n");
+                        .join("\n\n");
         if (outputPath) {
             await writeFile(outputPath, report, "utf8");
         }

package/package.json

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