@n-dx/web 0.1.0

package/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/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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"}

package/dist/server/prd-io.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Centralized PRD file I/O for web server routes.
+ *
+ * All web-server reads and writes of `.rex/prd.json` pass through this
+ * module. This replaces scattered `readFileSync`/`writeFileSync` calls
+ * across 6+ route files with a single, auditable access point.
+ *
+ * **Why sync?** HTTP route handlers in the web server use synchronous
+ * patterns. Rex's canonical store API (`FileStore.loadDocument()`) is
+ * async and includes schema validation + canonical JSON formatting.
+ * For hot-path reads where validation overhead is unnecessary (e.g.
+ * extracting stats, serving raw JSON), these sync helpers avoid the
+ * async conversion cost across dozens of handler functions.
+ *
+ * **Future migration path:** To switch to rex's async store, update
+ * this single module and convert callers to await.
+ *
+ * @module web/server/prd-io
+ */
+import type { PRDDocument } from "./rex-gateway.js";
+/**
+ * Check whether prd.json exists in the given rex directory.
+ */
+export declare function prdExists(rexDir: string): boolean;
+/**
+ * Load and parse prd.json synchronously. Returns null if not found or unparseable.
+ *
+ * Validates the schema version before returning. If the version is incompatible,
+ * logs a warning and returns null to prevent silent data corruption from
+ * operating on a document whose structure may have changed.
+ */
+export declare function loadPRDSync(rexDir: string): PRDDocument | null;
+/**
+ * Save a PRD document to prd.json synchronously.
+ */
+export declare function savePRDSync(rexDir: string, doc: PRDDocument): void;
+/**
+ * Resolve the path to prd.json in the given rex directory.
+ */
+export declare function prdPath(rexDir: string): string;

package/dist/server/prd-io.js

@@ -0,0 +1,66 @@
+/**
+ * Centralized PRD file I/O for web server routes.
+ *
+ * All web-server reads and writes of `.rex/prd.json` pass through this
+ * module. This replaces scattered `readFileSync`/`writeFileSync` calls
+ * across 6+ route files with a single, auditable access point.
+ *
+ * **Why sync?** HTTP route handlers in the web server use synchronous
+ * patterns. Rex's canonical store API (`FileStore.loadDocument()`) is
+ * async and includes schema validation + canonical JSON formatting.
+ * For hot-path reads where validation overhead is unnecessary (e.g.
+ * extracting stats, serving raw JSON), these sync helpers avoid the
+ * async conversion cost across dozens of handler functions.
+ *
+ * **Future migration path:** To switch to rex's async store, update
+ * this single module and convert callers to await.
+ *
+ * @module web/server/prd-io
+ */
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { SCHEMA_VERSION, isCompatibleSchema } from "./rex-gateway.js";
+/**
+ * Check whether prd.json exists in the given rex directory.
+ */
+export function prdExists(rexDir) {
+    return existsSync(join(rexDir, "prd.json"));
+}
+/**
+ * Load and parse prd.json synchronously. Returns null if not found or unparseable.
+ *
+ * Validates the schema version before returning. If the version is incompatible,
+ * logs a warning and returns null to prevent silent data corruption from
+ * operating on a document whose structure may have changed.
+ */
+export function loadPRDSync(rexDir) {
+    const prdPath = join(rexDir, "prd.json");
+    if (!existsSync(prdPath))
+        return null;
+    try {
+        const doc = JSON.parse(readFileSync(prdPath, "utf-8"));
+        if (!isCompatibleSchema(doc.schema)) {
+            console.warn(`[prd-io] Incompatible PRD schema: found "${doc.schema ?? "(missing)"}",` +
+                ` expected "${SCHEMA_VERSION}". Run "rex validate" to check your PRD.`);
+            return null;
+        }
+        return doc;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save a PRD document to prd.json synchronously.
+ */
+export function savePRDSync(rexDir, doc) {
+    const prdPath = join(rexDir, "prd.json");
+    writeFileSync(prdPath, JSON.stringify(doc, null, 2) + "\n");
+}
+/**
+ * Resolve the path to prd.json in the given rex directory.
+ */
+export function prdPath(rexDir) {
+    return join(rexDir, "prd.json");
+}
+//# sourceMappingURL=prd-io.js.map

package/dist/server/prd-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-io.js","sourceRoot":"","sources":["../../src/server/prd-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAgB,CAAC;QACtE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CACV,4CAA4C,GAAG,CAAC,MAAM,IAAI,WAAW,IAAI;gBACzE,cAAc,cAAc,0CAA0C,CACvE,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,GAAgB;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAClC,CAAC"}

package/dist/server/process-memory-tracker.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Per-process memory tracking with history and high-RSS warnings.
+ *
+ * Collects time-series RSS samples for individual hench task processes
+ * and stores them in bounded ring buffers. Flags processes whose RSS
+ * exceeds a configurable threshold.
+ *
+ * This is the web-server counterpart to hench's own ProcessMemoryTracker.
+ * Implemented separately to avoid adding a runtime dependency from
+ * @n-dx/web to hench (web reads hench data from disk, never imports it).
+ *
+ * @module @n-dx/web/server/process-memory-tracker
+ */
+export interface ProcessMemoryTrackerConfig {
+    maxSamples: number;
+    maxCompletedHistories: number;
+    rssWarningBytes: number;
+}
+export declare const DEFAULT_PROCESS_MEMORY_TRACKER_CONFIG: ProcessMemoryTrackerConfig;
+export interface ProcessMemorySample {
+    rssBytes: number;
+    timestamp: string;
+    epochMs: number;
+}
+export interface MemoryTrend {
+    isLeaking: boolean;
+    description: string;
+}
+export interface ProcessMemoryHistory {
+    taskId: string;
+    taskTitle: string;
+    pid: number;
+    samples: ProcessMemorySample[];
+    startedAt: string;
+    endedAt?: string;
+    trend?: MemoryTrend;
+    peakRssBytes: number;
+    currentRssBytes: number;
+}
+export interface LeakReport {
+    taskId: string;
+    taskTitle: string;
+    pid: number;
+    trend: MemoryTrend;
+    currentRssBytes: number;
+    peakRssBytes: number;
+    trackingDurationSec: number;
+    timestamp: string;
+}
+export interface LeakDetectionSummary {
+    activeProcesses: number;
+    completedProcesses: number;
+    leaks: LeakReport[];
+    health: "healthy" | "warning";
+    timestamp: string;
+}
+export declare class ProcessMemoryTracker {
+    private readonly _config;
+    private readonly _active;
+    private readonly _completed;
+    private readonly _now;
+    constructor(config?: Partial<ProcessMemoryTrackerConfig>, overrides?: {
+        now?: () => number;
+    });
+    get config(): Readonly<ProcessMemoryTrackerConfig>;
+    get activeCount(): number;
+    get completedCount(): number;
+    recordSample(taskId: string, taskTitle: string, pid: number, rssBytes: number): void;
+    markCompleted(taskId: string): void;
+    remove(taskId: string): void;
+    getHistory(taskId: string): ProcessMemoryHistory | undefined;
+    getAllHistories(): ProcessMemoryHistory[];
+    getActiveHistories(): ProcessMemoryHistory[];
+    detectLeaks(): LeakDetectionSummary;
+    getLeakAlerts(): LeakReport[];
+    reset(): void;
+    private _computeTrend;
+    private _buildHistory;
+}