@n-dx/core 0.1.0

package/packages/web/dist/server/port.js

@@ -0,0 +1,134 @@
+/**
+ * Port availability detection and dynamic allocation.
+ *
+ * Provides utilities for checking whether a TCP port is available and
+ * finding the next available port within a configurable range.
+ *
+ * Used by the server startup code to gracefully fall back when the
+ * configured port (default 3117) is already occupied.
+ */
+import { createServer, createConnection } from "node:net";
+/** Default port range for fallback allocation. */
+export const DEFAULT_PORT = 3117;
+export const PORT_RANGE_START = 3117;
+export const PORT_RANGE_END = 3200;
+/**
+ * Check if a specific port is available for binding.
+ *
+ * Uses a two-phase approach:
+ * 1. Try to connect — if something is already listening, report unavailable.
+ * 2. If nothing is listening, try to bind — catches EACCES and other bind errors.
+ *
+ * This avoids SO_REUSEADDR false positives where a bind-only check might
+ * succeed even though the port is already occupied by another process.
+ */
+export function checkPort(port) {
+    return new Promise((resolve) => {
+        // Phase 1: try to connect — detects if a server is already listening
+        const sock = createConnection({ port, host: "127.0.0.1" });
+        sock.once("connect", () => {
+            sock.destroy();
+            resolve({ available: false, port, error: "EADDRINUSE" });
+        });
+        sock.once("error", (connErr) => {
+            sock.destroy();
+            if (connErr.code === "ECONNREFUSED") {
+                // Nothing listening — phase 2: try to bind to catch permission errors
+                const server = createServer();
+                server.once("error", (err) => {
+                    resolve({ available: false, port, error: err.code ?? err.message });
+                });
+                server.listen(port, () => {
+                    server.close(() => {
+                        resolve({ available: true, port });
+                    });
+                });
+            }
+            else {
+                // Other connection error (e.g., timeout) — treat as unavailable
+                resolve({ available: false, port, error: connErr.code ?? connErr.message });
+            }
+        });
+    });
+}
+/**
+ * Check if a port is available, retrying on transient failures.
+ *
+ * Wraps {@link checkPort} with a configurable retry loop to handle timing
+ * issues during process transitions.  When a server has just been stopped, its
+ * port may remain in OS TIME_WAIT state for a short period and appear
+ * unavailable even though no process is actively listening.  Retrying with
+ * exponential back-off gives the OS time to release the port without forcing
+ * the caller to fall back to a different port number.
+ *
+ * Retries are skipped immediately for non-transient errors such as `EACCES`
+ * (permission denied), since those require external intervention and will
+ * not resolve on their own.
+ *
+ * @param port  TCP port number to check.
+ * @param opts  Retry configuration.  Defaults suit most startup scenarios.
+ */
+export async function checkPortWithRetry(port, opts = {}) {
+    const maxRetries = opts.maxRetries ?? 5;
+    const initialDelayMs = opts.retryDelayMs ?? 100;
+    const backoffFactor = opts.backoffFactor ?? 2;
+    let result = await checkPort(port);
+    if (result.available)
+        return result;
+    // Permission errors won't resolve with retries — fail fast.
+    if (result.error === "EACCES")
+        return result;
+    let delay = initialDelayMs;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        await new Promise((r) => setTimeout(r, delay));
+        result = await checkPort(port);
+        if (result.available)
+            return result;
+        // Stop retrying if we hit a non-transient error.
+        if (result.error === "EACCES")
+            return result;
+        delay = Math.round(delay * backoffFactor);
+    }
+    return result;
+}
+/**
+ * Find the next available port in a range.
+ *
+ * Tries the `preferred` port first (with optional retries to handle transient
+ * unavailability during process transitions), then scans sequentially from
+ * `rangeStart` to `rangeEnd` (inclusive). Skips the preferred port during the
+ * scan since it was already tried.
+ *
+ * Pass `retryOpts` to give the preferred port several retry attempts before
+ * falling back to the range scan.  This is useful when the preferred port was
+ * just released by a recently stopped server (TIME_WAIT state).
+ *
+ * @throws {Error} If no port is available in the entire range.
+ */
+export async function findAvailablePort(preferred, rangeStart = PORT_RANGE_START, rangeEnd = PORT_RANGE_END, retryOpts) {
+    // Try the preferred port first (with retries if opts provided)
+    const check = retryOpts !== undefined
+        ? await checkPortWithRetry(preferred, retryOpts)
+        : await checkPort(preferred);
+    if (check.available) {
+        return { port: preferred, isOriginal: true, requestedPort: preferred };
+    }
+    // If the error is a permission issue, don't try other ports in the same range
+    // — the user likely needs elevated privileges
+    if (check.error === "EACCES") {
+        throw new Error(`Permission denied for port ${preferred}. ` +
+            `Try a port above 1024 or run with elevated privileges.`);
+    }
+    // Scan the range for an available port
+    for (let p = rangeStart; p <= rangeEnd; p++) {
+        if (p === preferred)
+            continue; // already tried
+        const result = await checkPort(p);
+        if (result.available) {
+            return { port: p, isOriginal: false, requestedPort: preferred };
+        }
+    }
+    throw new Error(`No available port found in range ${rangeStart}–${rangeEnd}. ` +
+        `All ports are in use.`);
+}
+//# sourceMappingURL=port.js.map

package/packages/web/dist/server/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/server/port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE1D,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AA4CnC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,qEAAqE;QACrE,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAA8B,EAAE,EAAE;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACpC,sEAAsE;gBACtE,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;oBAClD,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtE,CAAC,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;oBACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;wBAChB,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBACrC,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,gEAAgE;gBAChE,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,OAAyB,EAAE;IAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IAE9C,IAAI,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAEpC,4DAA4D;IAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAE7C,IAAI,KAAK,GAAG,cAAc,CAAC;IAC3B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QACpC,iDAAiD;QACjD,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,aAAqB,gBAAgB,EACrC,WAAmB,cAAc,EACjC,SAA4B;IAE5B,+DAA+D;IAC/D,MAAM,KAAK,GAAG,SAAS,KAAK,SAAS;QACnC,CAAC,CAAC,MAAM,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC;QAChD,CAAC,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IACzE,CAAC;IAED,8EAA8E;IAC9E,8CAA8C;IAC9C,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,8BAA8B,SAAS,IAAI;YAC3C,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,gBAAgB;QAE/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,oCAAoC,UAAU,IAAI,QAAQ,IAAI;QAC9D,uBAAuB,CACxB,CAAC;AACJ,CAAC"}

package/packages/web/dist/server/pr-markdown-refresh-diagnostics.d.ts

@@ -0,0 +1,59 @@
+export type PRMarkdownRefreshDiagnosticCode = "missing_git" | "not_repo" | "unresolved_main_or_origin_main" | "auth_fetch_denied" | "network_dns_error" | "fetch_failed" | "rev_parse_failed" | "diff_failed";
+export type PRMarkdownRefreshPreflightFailureCode = "NOT_A_REPO" | "MISSING_BASE_REF" | "FETCH_DENIED" | "NETWORK_DNS_ERROR" | "DETACHED_HEAD" | "SHALLOW_CLONE";
+export type PRMarkdownRefreshFailureCode = PRMarkdownRefreshDiagnosticCode | PRMarkdownRefreshPreflightFailureCode;
+export type PRMarkdownRefreshFailureStage = "preflight" | "fetch" | "rev-parse" | "diff" | "semantic-diff" | "mixed";
+export type PRMarkdownRefreshDiffStageStatus = "succeeded" | "failed" | "not_run";
+export type PRMarkdownRefreshGuidanceCategory = "environment_fix" | "fetch_retry" | "local_history_remediation";
+export type PRMarkdownRefreshGitSubcommand = "version" | "rev-parse" | "fetch" | "diff";
+export type PRMarkdownRefreshFailureCommandStageId = "preflight" | "fetch" | "rev_parse" | "name_status_diff" | "semantic_diff_numstat";
+export interface PRMarkdownRefreshFailureCommandExecution {
+    stderr?: string;
+    exitCode?: number | null;
+}
+export interface PRMarkdownRefreshGuidance {
+    category: PRMarkdownRefreshGuidanceCategory;
+    summary: string;
+    commands: string[];
+}
+export interface PRMarkdownRefreshFailure {
+    type: "pr_markdown_refresh_failure";
+    code: PRMarkdownRefreshFailureCode;
+    stage: PRMarkdownRefreshFailureStage;
+    stageStatuses?: {
+        nameStatusDiff: PRMarkdownRefreshDiffStageStatus;
+        semanticDiff: PRMarkdownRefreshDiffStageStatus;
+    };
+    summary: string;
+    remediationCommands: string[];
+    guidanceCategory: PRMarkdownRefreshGuidanceCategory;
+    commandSuggestions: string[];
+    command: {
+        gitSubcommand: PRMarkdownRefreshGitSubcommand;
+        subcommand?: string;
+        stageId?: PRMarkdownRefreshFailureCommandStageId;
+        stderr?: string;
+        exitCode?: number | null;
+        stderrExcerpt: string;
+        reproduce: string[];
+    };
+}
+export declare const GIT_CREDENTIAL_HELPER_COMMAND = "sourcevision git-credential-helper";
+interface PRMarkdownRefreshPreflightErrorContract {
+    code: PRMarkdownRefreshPreflightFailureCode;
+    summary: string;
+    remediationCommands: string[];
+}
+export declare function classifyPRMarkdownRefreshFailureCode(input: unknown): PRMarkdownRefreshDiagnosticCode | null;
+export declare function classifyPRMarkdownRefreshPreflightCode(input: unknown, diagnosticCode?: PRMarkdownRefreshDiagnosticCode | null): PRMarkdownRefreshPreflightFailureCode | null;
+export declare function resolvePRMarkdownRefreshPreflightErrorContract(input: unknown, diagnosticCode?: PRMarkdownRefreshDiagnosticCode | null): PRMarkdownRefreshPreflightErrorContract | null;
+export declare function validatePRMarkdownRefreshPreflightErrorContract(input: unknown): boolean;
+export declare function shouldUsePRMarkdownFallbackForCode(code: PRMarkdownRefreshDiagnosticCode): boolean;
+export declare function shouldUsePRMarkdownFallback(input: unknown): boolean;
+export declare function getPRMarkdownRefreshRemediationHints(code: PRMarkdownRefreshDiagnosticCode): string[];
+export declare function resolvePRMarkdownRefreshGuidance(code: PRMarkdownRefreshDiagnosticCode): PRMarkdownRefreshGuidance;
+export declare function buildPRMarkdownRefreshFailure(code: PRMarkdownRefreshDiagnosticCode, details: string, options: {
+    semanticDiffInspection: boolean;
+    nameStatusDiffSucceeded: boolean;
+    commandExecution?: PRMarkdownRefreshFailureCommandExecution;
+}): PRMarkdownRefreshFailure;
+export {};

package/packages/web/dist/server/pr-markdown-refresh-diagnostics.js

@@ -0,0 +1,429 @@
+export const GIT_CREDENTIAL_HELPER_COMMAND = "sourcevision git-credential-helper";
+const FALLBACK_TRIGGER_CODES = new Set([
+    "missing_git",
+    "not_repo",
+    "unresolved_main_or_origin_main",
+    "auth_fetch_denied",
+    "network_dns_error",
+    "fetch_failed",
+    "rev_parse_failed",
+    "diff_failed",
+]);
+const REMEDIATION_HINTS = {
+    missing_git: [
+        "Install Git and ensure `git` is available on PATH, then retry refresh.",
+    ],
+    not_repo: [
+        "Run refresh from a cloned Git repository (a directory containing `.git`).",
+    ],
+    unresolved_main_or_origin_main: [
+        "Check that `main` or `origin/main` exists (`git rev-parse --verify main` and `git rev-parse --verify origin/main`), then fetch or create one before retrying.",
+    ],
+    auth_fetch_denied: [
+        `Run \`${GIT_CREDENTIAL_HELPER_COMMAND}\` to set up git credentials, then retry refresh.`,
+    ],
+    network_dns_error: [
+        "Remote host could not be reached. Verify DNS/network/VPN/proxy connectivity to your git remote and retry refresh.",
+    ],
+    fetch_failed: [
+        "Run `git fetch origin main` manually and verify remote connectivity.",
+    ],
+    rev_parse_failed: [
+        "Verify the base ref resolves (`git rev-parse --verify main` or `git rev-parse --verify origin/main`) and retry refresh.",
+    ],
+    diff_failed: [
+        "Run `git diff main...HEAD --name-status` (or `origin/main...HEAD`) to reproduce and fix the diff error, then retry refresh.",
+    ],
+};
+const FETCH_ERROR_TOKENS = [
+    "fetch_denied",
+    "authentication failed",
+    "authorization failed",
+    "access denied",
+    "could not read username",
+    "terminal prompts disabled",
+    "http basic: access denied",
+    "the requested url returned error: 401",
+    "the requested url returned error: 403",
+];
+const NETWORK_ERROR_TOKENS = [
+    "network_dns_error",
+    "could not resolve host",
+    "name or service not known",
+    "temporary failure in name resolution",
+    "failed to connect to",
+    "connection timed out",
+    "network is unreachable",
+    "no route to host",
+    "connection refused",
+];
+const LOCAL_HISTORY_ERROR_TOKENS = [
+    "bad revision",
+    "unknown revision or path not in the working tree",
+    "invalid symmetric difference expression",
+    "fatal: ambiguous argument",
+    "no merge base",
+    "not something we can merge",
+];
+const SHALLOW_CLONE_ERROR_TOKENS = [
+    "shallow clone",
+    "shallow repository",
+    "is shallow",
+    "--unshallow",
+    "git fetch --depth",
+    "shallow update not allowed",
+];
+const PREFLIGHT_ERROR_CATALOG = {
+    NOT_A_REPO: {
+        summary: "The refresh command is running outside a Git repository.",
+        remediationCommands: [
+            "git rev-parse --is-inside-work-tree",
+            "cd <repository-root>",
+            "sourcevision pr-markdown <project-dir>",
+        ],
+    },
+    MISSING_BASE_REF: {
+        summary: "Neither `main` nor `origin/main` could be resolved for diff preflight.",
+        remediationCommands: [
+            "git rev-parse --verify main",
+            "git rev-parse --verify origin/main",
+            "git fetch origin main",
+        ],
+    },
+    FETCH_DENIED: {
+        summary: "Remote fetch was denied due to missing/invalid credentials.",
+        remediationCommands: [
+            GIT_CREDENTIAL_HELPER_COMMAND,
+            "git fetch origin main",
+        ],
+    },
+    NETWORK_DNS_ERROR: {
+        summary: "Remote host could not be resolved or reached over the network.",
+        remediationCommands: [
+            "git remote -v",
+            "git fetch origin main",
+        ],
+    },
+    DETACHED_HEAD: {
+        summary: "HEAD is detached, so PR diff preflight cannot infer branch context.",
+        remediationCommands: [
+            "git status --short --branch",
+            "git switch -c <branch-name>",
+            "git rev-parse --abbrev-ref HEAD",
+        ],
+    },
+    SHALLOW_CLONE: {
+        summary: "Repository history is shallow and does not contain enough commits for base diffing.",
+        remediationCommands: [
+            "git rev-parse --is-shallow-repository",
+            "git fetch --unshallow",
+            "git fetch origin main --depth=200",
+        ],
+    },
+};
+function getErrorText(input) {
+    if (typeof input === "string")
+        return input;
+    if (!(input instanceof Error))
+        return "";
+    const err = input;
+    const stderrRaw = typeof err.stderr === "string" ? err.stderr : err.stderr?.toString("utf-8") ?? "";
+    return `${stderrRaw}\n${err.message ?? ""}`.trim();
+}
+function normalizeText(input) {
+    return getErrorText(input).toLowerCase();
+}
+export function classifyPRMarkdownRefreshFailureCode(input) {
+    const normalized = normalizeText(input);
+    if (!normalized)
+        return null;
+    if (normalized.includes("git is not available on path")
+        || (normalized.includes("git") && normalized.includes("enoent"))
+        || normalized.includes("spawn git enoent")) {
+        return "missing_git";
+    }
+    if (normalized.includes("not a git repository")
+        || normalized.includes("outside repository")) {
+        return "not_repo";
+    }
+    if (normalized.includes("could not resolve a base branch")
+        || normalized.includes("unresolved")
+            && normalized.includes("origin/main")) {
+        return "unresolved_main_or_origin_main";
+    }
+    if (FETCH_ERROR_TOKENS.some((token) => normalized.includes(token))) {
+        return "auth_fetch_denied";
+    }
+    if (NETWORK_ERROR_TOKENS.some((token) => normalized.includes(token))) {
+        return "network_dns_error";
+    }
+    if (normalized.includes("failed to fetch")
+        || normalized.includes("fetch failed")
+        || normalized.includes("couldn't find remote ref")
+        || normalized.includes("remote ref does not exist")
+        || (normalized.includes("git fetch") && normalized.includes("failed"))) {
+        return "fetch_failed";
+    }
+    if (normalized.includes("detached_head")
+        || normalized.includes("head is detached")) {
+        return "rev_parse_failed";
+    }
+    if (normalized.includes("rev-parse")
+        || normalized.includes("rev parse")) {
+        return "rev_parse_failed";
+    }
+    if (LOCAL_HISTORY_ERROR_TOKENS.some((token) => normalized.includes(token))
+        || normalized.includes("fatal: bad object")) {
+        return "diff_failed";
+    }
+    if (normalized.includes("failed to compute git diff")
+        || normalized.includes("failed to inspect semantic diff details")
+        || normalized.includes("diff failed")
+        || (normalized.includes("git diff") && normalized.includes("failed"))) {
+        return "diff_failed";
+    }
+    return null;
+}
+export function classifyPRMarkdownRefreshPreflightCode(input, diagnosticCode) {
+    const normalized = normalizeText(input);
+    if (!normalized)
+        return null;
+    if (SHALLOW_CLONE_ERROR_TOKENS.some((token) => normalized.includes(token))) {
+        return "SHALLOW_CLONE";
+    }
+    if (normalized.includes("detached_head") || normalized.includes("head is detached")) {
+        return "DETACHED_HEAD";
+    }
+    if (normalized.includes("not a git repository")
+        || normalized.includes("outside repository")
+        || diagnosticCode === "not_repo") {
+        return "NOT_A_REPO";
+    }
+    if (normalized.includes("could not resolve a base branch")
+        || (normalized.includes("unresolved") && normalized.includes("origin/main"))
+        || diagnosticCode === "unresolved_main_or_origin_main") {
+        return "MISSING_BASE_REF";
+    }
+    if (FETCH_ERROR_TOKENS.some((token) => normalized.includes(token)) || diagnosticCode === "auth_fetch_denied") {
+        return "FETCH_DENIED";
+    }
+    if (NETWORK_ERROR_TOKENS.some((token) => normalized.includes(token)) || diagnosticCode === "network_dns_error") {
+        return "NETWORK_DNS_ERROR";
+    }
+    return null;
+}
+export function resolvePRMarkdownRefreshPreflightErrorContract(input, diagnosticCode) {
+    const code = classifyPRMarkdownRefreshPreflightCode(input, diagnosticCode);
+    if (!code)
+        return null;
+    const spec = PREFLIGHT_ERROR_CATALOG[code];
+    return {
+        code,
+        summary: spec.summary,
+        remediationCommands: [...spec.remediationCommands],
+    };
+}
+export function validatePRMarkdownRefreshPreflightErrorContract(input) {
+    if (!input || typeof input !== "object")
+        return false;
+    const candidate = input;
+    if (typeof candidate.code !== "string")
+        return false;
+    if (!(candidate.code in PREFLIGHT_ERROR_CATALOG))
+        return false;
+    if (typeof candidate.summary !== "string" || candidate.summary.trim().length === 0)
+        return false;
+    if (!Array.isArray(candidate.remediationCommands) || candidate.remediationCommands.length === 0)
+        return false;
+    return candidate.remediationCommands.every((command) => typeof command === "string" && command.trim().length > 0);
+}
+export function shouldUsePRMarkdownFallbackForCode(code) {
+    return FALLBACK_TRIGGER_CODES.has(code);
+}
+export function shouldUsePRMarkdownFallback(input) {
+    const code = classifyPRMarkdownRefreshFailureCode(input);
+    return code ? shouldUsePRMarkdownFallbackForCode(code) : false;
+}
+export function getPRMarkdownRefreshRemediationHints(code) {
+    return REMEDIATION_HINTS[code];
+}
+export function resolvePRMarkdownRefreshGuidance(code) {
+    if (code === "auth_fetch_denied" || code === "network_dns_error" || code === "fetch_failed") {
+        return {
+            category: "fetch_retry",
+            summary: "Remote fetch failed. Resolve connectivity/credentials, then retry refresh.",
+            commands: [
+                "git fetch origin main",
+                "sourcevision pr-markdown <project-dir>",
+            ],
+        };
+    }
+    if (code === "rev_parse_failed" || code === "unresolved_main_or_origin_main" || code === "diff_failed") {
+        return {
+            category: "local_history_remediation",
+            summary: "Local branch/history state is incomplete for semantic diff generation.",
+            commands: [
+                "git rev-parse --verify main",
+                "git rev-parse --verify origin/main",
+                "git diff main...HEAD --name-status",
+            ],
+        };
+    }
+    return {
+        category: "environment_fix",
+        summary: "Environment preflight failed before refresh could run.",
+        commands: [
+            "git --version",
+            "sourcevision pr-markdown <project-dir>",
+        ],
+    };
+}
+function compactWhitespace(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function stderrExcerpt(details, maxLength = 240) {
+    const compact = compactWhitespace(details);
+    if (compact.length <= maxLength)
+        return compact;
+    return `${compact.slice(0, maxLength - 3)}...`;
+}
+function redactSensitiveValues(input) {
+    return input
+        .replace(/(https?:\/\/[^/\s:@]+):[^@\s/]+@/gi, "$1:***@")
+        .replace(/(authorization:\s*(?:basic|bearer)\s+)[^\s]+/gi, "$1***")
+        .replace(/\b(token|password|secret|api[_-]?key)\s*[:=]\s*[^\s]+/gi, "$1=***")
+        .replace(/\b(gh[pousr]_[A-Za-z0-9_]{8,})\b/g, "***");
+}
+function sanitizeCommandStderr(raw) {
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    const redacted = redactSensitiveValues(trimmed);
+    return redacted.length > 4000 ? `${redacted.slice(0, 3997)}...` : redacted;
+}
+function parseComparisonRange(details) {
+    const singleQuoteMatch = /for '([^']+\.\.\.[^']+)'/i.exec(details);
+    if (singleQuoteMatch?.[1])
+        return singleQuoteMatch[1];
+    const backtickMatch = /for `([^`]+\.\.\.[^`]+)`/i.exec(details);
+    if (backtickMatch?.[1])
+        return backtickMatch[1];
+    return null;
+}
+function inferDiffSubcommand(details, semanticDiffInspection) {
+    const range = parseComparisonRange(details) ?? "main...HEAD";
+    const mode = semanticDiffInspection ? "--numstat" : "--name-status";
+    return `git --no-pager diff --no-ext-diff --no-textconv ${mode} ${range}`;
+}
+export function buildPRMarkdownRefreshFailure(code, details, options) {
+    const guidance = resolvePRMarkdownRefreshGuidance(code);
+    const preflight = resolvePRMarkdownRefreshPreflightErrorContract(details, code);
+    const commandStderr = sanitizeCommandStderr(options.commandExecution?.stderr ?? details);
+    const commandExitCode = options.commandExecution?.exitCode;
+    if (code === "diff_failed") {
+        const semanticDiffFailed = options.semanticDiffInspection;
+        const nameStatusDiffStatus = semanticDiffFailed
+            ? options.nameStatusDiffSucceeded ? "succeeded" : "failed"
+            : "failed";
+        const semanticDiffStatus = semanticDiffFailed ? "failed" : "not_run";
+        const stage = semanticDiffFailed && nameStatusDiffStatus === "succeeded"
+            ? "mixed"
+            : semanticDiffFailed
+                ? "semantic-diff"
+                : "diff";
+        return {
+            type: "pr_markdown_refresh_failure",
+            code,
+            stage,
+            stageStatuses: {
+                nameStatusDiff: nameStatusDiffStatus,
+                semanticDiff: semanticDiffStatus,
+            },
+            summary: guidance.summary,
+            remediationCommands: guidance.commands,
+            guidanceCategory: guidance.category,
+            commandSuggestions: guidance.commands,
+            command: {
+                gitSubcommand: "diff",
+                subcommand: inferDiffSubcommand(details, semanticDiffFailed),
+                stageId: semanticDiffFailed ? "semantic_diff_numstat" : "name_status_diff",
+                ...(commandStderr ? { stderr: commandStderr } : {}),
+                ...(commandExitCode !== undefined ? { exitCode: commandExitCode } : {}),
+                stderrExcerpt: stderrExcerpt(commandStderr ?? details),
+                reproduce: [
+                    "git diff main...HEAD --name-status",
+                    "git diff origin/main...HEAD --name-status",
+                    "sourcevision pr-markdown <project-dir>",
+                ],
+            },
+        };
+    }
+    if (code === "fetch_failed" || code === "auth_fetch_denied" || code === "network_dns_error") {
+        return {
+            type: "pr_markdown_refresh_failure",
+            code,
+            stage: "fetch",
+            summary: guidance.summary,
+            remediationCommands: guidance.commands,
+            guidanceCategory: guidance.category,
+            commandSuggestions: guidance.commands,
+            command: {
+                gitSubcommand: "fetch",
+                stageId: "fetch",
+                ...(commandStderr ? { stderr: commandStderr } : {}),
+                ...(commandExitCode !== undefined ? { exitCode: commandExitCode } : {}),
+                stderrExcerpt: stderrExcerpt(commandStderr ?? details),
+                reproduce: [
+                    "git fetch origin main",
+                    "sourcevision pr-markdown <project-dir>",
+                ],
+            },
+        };
+    }
+    if (code === "rev_parse_failed" || code === "unresolved_main_or_origin_main") {
+        return {
+            type: "pr_markdown_refresh_failure",
+            code,
+            stage: "rev-parse",
+            summary: guidance.summary,
+            remediationCommands: guidance.commands,
+            guidanceCategory: guidance.category,
+            commandSuggestions: guidance.commands,
+            command: {
+                gitSubcommand: "rev-parse",
+                stageId: "rev_parse",
+                ...(commandStderr ? { stderr: commandStderr } : {}),
+                ...(commandExitCode !== undefined ? { exitCode: commandExitCode } : {}),
+                stderrExcerpt: stderrExcerpt(commandStderr ?? details),
+                reproduce: [
+                    "git rev-parse --verify main",
+                    "git rev-parse --verify origin/main",
+                    "sourcevision pr-markdown <project-dir>",
+                ],
+            },
+        };
+    }
+    return {
+        type: "pr_markdown_refresh_failure",
+        code: preflight?.code ?? code,
+        stage: "preflight",
+        summary: preflight?.summary ?? guidance.summary,
+        remediationCommands: preflight?.remediationCommands ?? guidance.commands,
+        guidanceCategory: guidance.category,
+        commandSuggestions: guidance.commands,
+        command: {
+            gitSubcommand: "version",
+            stageId: "preflight",
+            ...(commandStderr ? { stderr: commandStderr } : {}),
+            ...(commandExitCode !== undefined ? { exitCode: commandExitCode } : {}),
+            stderrExcerpt: stderrExcerpt(commandStderr ?? details),
+            reproduce: [
+                "git --version",
+                "sourcevision pr-markdown <project-dir>",
+            ],
+        },
+    };
+}
+//# sourceMappingURL=pr-markdown-refresh-diagnostics.js.map

package/packages/web/dist/server/pr-markdown-refresh-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-markdown-refresh-diagnostics.js","sourceRoot":"","sources":["../../src/server/pr-markdown-refresh-diagnostics.ts"],"names":[],"mappings":"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"}