codex-plugin-doctor 1.76.0 → 1.78.0

package/dist/reporting/render-mcp-prompt-diff-report.d.ts

@@ -0,0 +1,2 @@
+import type { McpPromptDiffReport } from "../core/mcp-prompt-diff.js";
+export declare function renderMcpPromptDiffReport(report: McpPromptDiffReport): string;

package/dist/reporting/render-mcp-prompt-diff-report.js

@@ -0,0 +1,48 @@
+import { describePromptLocation } from "./render-mcp-prompt-file-report.js";
+import { quoteServerText } from "./quote-server-text.js";
+export function renderMcpPromptDiffReport(report) {
+    const comparison = report.comparison;
+    return [
+        "Offline MCP Prompt Diff",
+        "=======================",
+        `Status: ${report.status}`,
+        `Scope: ${report.scope}`,
+        `Comparison complete: ${comparison.complete}`,
+        ...(comparison.reason === null ? [] : [`Reason: ${comparison.reason}`]),
+        `Added: ${comparison.added ?? "not compared"}`,
+        `Removed: ${comparison.removed ?? "not compared"}`,
+        `Changed: ${comparison.changed ?? "not compared"}`,
+        `Unchanged: ${comparison.unchanged ?? "not compared"}`,
+        `Breaking: ${comparison.breaking ?? "not compared"}`,
+        `Unclassified: ${comparison.unclassified ?? "not compared"}`,
+        `Comparison coverage: ${report.coverage.comparison}`,
+        `Definition coverage: ${report.coverage.definitions}`,
+        `Compatibility: ${report.coverage.compatibility}`,
+        `Server catalog: ${report.coverage.serverCatalog}`,
+        `Prompt retrieval: ${report.coverage.promptRetrieval}`,
+        `Impact classification: ${report.coverage.impactClassification}`,
+        "Only the supplied responses are compared. Impact labels are argument heuristics: a compatible label or an unchanged result does not establish compatibility.",
+        ...["before", "after"].flatMap((side) => {
+            const source = report[side];
+            const label = side === "before" ? "Before" : "After";
+            return [
+                `${label} input: ${source.status}; prompts checked: ${source.inspection.promptsChecked}; bytes read: ${source.source.bytesRead}`,
+                ...(source.inspection.reason === null ? [] : [`${label} reason: ${source.inspection.reason}`]),
+                ...source.findings.map((finding) => {
+                    const locator = finding.location ? ` [${side} ${describePromptLocation(finding.location)}]` : "";
+                    return `${label} ${finding.severity.toUpperCase()} ${finding.id}${locator}: ${finding.message}\n  ${finding.suggestedFix}`;
+                })
+            ];
+        }),
+        ...report.changes.map((change) => {
+            const locations = [
+                ...(change.beforePromptIndex === null ? [] : [`before prompt ${change.beforePromptIndex}`]),
+                ...(change.afterPromptIndex === null ? [] : [`after prompt ${change.afterPromptIndex}`])
+            ];
+            const impact = `${change.impact}${change.reasons.length ? ` (${change.reasons.join(", ")})` : ""}`;
+            const name = change.name === undefined ? "" : ` ${quoteServerText(change.name)}`;
+            const at = (change.locations ?? []).map((location) => `\n  At ${location.argument === null ? "(prompt)" : `argument ${quoteServerText(location.argument)}`}: ${location.reason}`).join("");
+            return `${change.kind.toUpperCase()}${name} [${locations.join(" -> ")}]${change.fields.length ? `: ${change.fields.join(", ")}` : ""}\n  Impact: ${impact}${at}`;
+        })
+    ].join("\n");
+}

package/dist/reporting/render-mcp-prompt-file-report.d.ts

@@ -0,0 +1,5 @@
+import type { PromptCatalogLocation } from "../core/mcp-prompt-definition.js";
+import type { McpPromptFileReport } from "../core/mcp-prompt-file.js";
+/** Describes a finding location by one-based positions only, such as "prompt 2, argument 1, related argument 3". */
+export declare function describePromptLocation(location: PromptCatalogLocation): string;
+export declare function renderMcpPromptFileReport(report: McpPromptFileReport): string;

package/dist/reporting/render-mcp-prompt-file-report.js

@@ -0,0 +1,33 @@
+/** Describes a finding location by one-based positions only, such as "prompt 2, argument 1, related argument 3". */
+export function describePromptLocation(location) {
+    return [
+        `prompt ${location.promptIndex}`,
+        ...(location.argumentIndex === undefined ? [] : [`argument ${location.argumentIndex}`]),
+        ...(location.relatedPromptIndex === undefined ? [] : [`related prompt ${location.relatedPromptIndex}`]),
+        ...(location.relatedArgumentIndex === undefined ? [] : [`related argument ${location.relatedArgumentIndex}`])
+    ].join(", ");
+}
+export function renderMcpPromptFileReport(report) {
+    return [
+        "Offline MCP Prompt Definitions",
+        "==============================",
+        `Status: ${report.status}`,
+        `Scope: ${report.scope}`,
+        `Source: ${report.source.kind} (${report.source.format})`,
+        `Bytes read: ${report.source.bytesRead}`,
+        `Inspection complete: ${report.inspection.complete}`,
+        `Prompts checked: ${report.inspection.promptsChecked}`,
+        `More pages advertised: ${report.inspection.hasNextCursor ?? "unknown"}`,
+        ...(report.inspection.reason === null ? [] : [`Reason: ${report.inspection.reason}`]),
+        `Definition coverage: ${report.coverage.definitions}`,
+        `Discovery: ${report.coverage.discovery}`,
+        `Server catalog: ${report.coverage.serverCatalog}`,
+        `Prompt retrieval: ${report.coverage.promptRetrieval}`,
+        `Full conformance: ${report.coverage.fullConformance}`,
+        "Only the supplied file was inspected. Its provenance and server completeness are not established.",
+        ...report.findings.map((finding) => {
+            const locator = finding.location ? ` [${describePromptLocation(finding.location)}]` : "";
+            return `${finding.severity.toUpperCase()} ${finding.id}${locator}: ${finding.message}\n  ${finding.suggestedFix}`;
+        })
+    ].join("\n");
+}

package/dist/reporting/render-mcp-tool-diff-markdown.js

@@ -1,23 +1,10 @@
-import { quoteServerText } from "./quote-server-text.js";
+import { markdownCodeSpan } from "./quote-server-text.js";
 function count(value) {
     return value === null || value === undefined ? "not compared" : String(value);
 }
 function toolIndex(value) {
     return value === null ? "-" : String(value);
 }
-// Names and pointers come from the server, so they are quoted and put in a code span, where Markdown,
-// HTML, mentions, and links stay inert; the fence outgrows any backtick run, and pipes are escaped for the table.
-function code(text) {
-    const quoted = quoteServerText(text);
-    let run = 0;
-    let longest = 0;
-    for (const character of quoted) {
-        run = character === "`" ? run + 1 : 0;
-        longest = Math.max(longest, run);
-    }
-    const fence = "`".repeat(longest + 1);
-    return `${fence}${quoted.replace(/\|/gu, "\\|")}${fence}`;
-}
 export function renderMcpToolDiffMarkdown(report) {
     const comparison = report.comparison;
     const named = report.changes.some((change) => change.name !== undefined);
@@ -31,9 +18,9 @@ export function renderMcpToolDiffMarkdown(report) {
         `| ${count(comparison.added)} | ${count(comparison.removed)} | ${count(comparison.changed)} | ${count(comparison.unchanged)} | ${count(comparison.breaking)} | ${count(comparison.unclassified)} |`
     ];
     if (report.changes.length > 0) {
-        lines.push("", "### Changes", "", named ? "| Change | Tool | Before tool | After tool | Fields | Impact | Reasons |" : "| Change | Before tool | After tool | Fields | Impact | Reasons |", named ? "| --- | --- | --- | --- | --- | --- | --- |" : "| --- | --- | --- | --- | --- | --- |", ...report.changes.map((change) => `| ${change.kind}${named ? ` | ${change.name === undefined ? "-" : code(change.name)}` : ""} | ${toolIndex(change.beforeToolIndex)} | ${toolIndex(change.afterToolIndex)} | ${change.fields.map((field) => `\`${field}\``).join(", ") || "-"} | **${change.impact}** | ${change.reasons.map((reason) => `\`${reason}\``).join(", ") || "-"} |`));
+        lines.push("", "### Changes", "", named ? "| Change | Tool | Before tool | After tool | Fields | Impact | Reasons |" : "| Change | Before tool | After tool | Fields | Impact | Reasons |", named ? "| --- | --- | --- | --- | --- | --- | --- |" : "| --- | --- | --- | --- | --- | --- |", ...report.changes.map((change) => `| ${change.kind}${named ? ` | ${change.name === undefined ? "-" : markdownCodeSpan(change.name)}` : ""} | ${toolIndex(change.beforeToolIndex)} | ${toolIndex(change.afterToolIndex)} | ${change.fields.map((field) => `\`${field}\``).join(", ") || "-"} | **${change.impact}** | ${change.reasons.map((reason) => `\`${reason}\``).join(", ") || "-"} |`));
     }
-    const located = report.changes.flatMap((change) => (change.locations ?? []).map((location) => `| ${change.name === undefined ? "-" : code(change.name)} | \`${location.reason}\` | ${location.pointer === "" ? "(tool)" : code(location.pointer)} |`));
+    const located = report.changes.flatMap((change) => (change.locations ?? []).map((location) => `| ${change.name === undefined ? "-" : markdownCodeSpan(change.name)} | \`${location.reason}\` | ${location.pointer === "" ? "(tool)" : markdownCodeSpan(location.pointer)} |`));
     if (located.length > 0) {
         lines.push("", "### Locations", "", "| Tool | Reason | Location |", "| --- | --- | --- |", ...located);
     }

package/dist/run-cli.d.ts

@@ -1,6 +1,9 @@
 import { discoverMcpServer } from "./core/mcp-discovery.js";
 import { captureMcpToolCatalog, inspectMcpToolCatalog } from "./core/mcp-tool-catalog.js";
 import { captureStdioMcpToolCatalog } from "./core/mcp-stdio-tool-catalog.js";
+import { captureMcpPromptCatalog, captureStdioMcpPromptCatalog } from "./core/mcp-prompt-catalog.js";
+import { compareMcpPromptFiles } from "./core/mcp-prompt-diff.js";
+import { inspectMcpPromptFile } from "./core/mcp-prompt-file.js";
 import { inspectMcpToolFile } from "./core/mcp-tool-file.js";
 import { compareMcpToolFiles } from "./core/mcp-tool-diff.js";
 import { buildCorpusQualityMetricsDiffReport, buildCorpusQualityMetricsReport } from "./core/corpus-quality-metrics.js";
@@ -23,6 +26,10 @@ export interface RunCliOptions {
     inspectMcpToolCatalogImpl?: typeof inspectMcpToolCatalog;
     captureMcpToolCatalogImpl?: typeof captureMcpToolCatalog;
     captureStdioMcpToolCatalogImpl?: typeof captureStdioMcpToolCatalog;
+    compareMcpPromptFilesImpl?: typeof compareMcpPromptFiles;
+    inspectMcpPromptFileImpl?: typeof inspectMcpPromptFile;
+    captureMcpPromptCatalogImpl?: typeof captureMcpPromptCatalog;
+    captureStdioMcpPromptCatalogImpl?: typeof captureStdioMcpPromptCatalog;
     discoverMcpServerImpl?: typeof discoverMcpServer;
     terminalContext?: CliTerminalContext;
     runCheckImpl?: typeof runCheck;