unity-open-mcp 0.9.0 → 1.1.0

package/dist/process-diagnostics.d.ts

@@ -6,10 +6,27 @@
  * misleading for a GUI-launched Unity on macOS (it inherits `launchctl limit
  * maxfiles`, not the shell's ulimit). Documented in the tool response via
  * `launchContextCaveat`.
+ *
+ * This is the DEFAULT used when a project has not overridden the ceiling via
+ * `.unity-open-mcp/settings.json` (`resourcePressure.fdCeiling`). The actual
+ * ceiling applied to a sample is resolved by `readFdCeiling` in
+ * `project-settings.ts` and threaded into `computeFdHeadroom` /
+ * `analyzeFdTrend` so the math scales with the configured value (relevant for
+ * Unity 6 / CoreCLR runtimes whose internal ceiling may differ from Mono's
+ * classic 1024).
+ */
+export declare const FD_CEILING_DEFAULT = 1024;
+/**
+ * Absolute cap on the leak-detection threshold. The threshold is 10% of the
+ * resolved ceiling, but a very high configured ceiling (e.g. a CoreCLR runtime
+ * that legitimately sits over the Mono proxy) would otherwise push it so high
+ * that a real monotonic climb is missed — a climb of this many descriptors is a
+ * clear leak signal regardless of the ceiling. Kicks in once the ceiling exceeds
+ * ~5000 (10% of 5000 = 500).
  */
-export declare const FD_CEILING = 1024;
+export declare const FD_LEAK_DELTA_MAX = 500;
 /**
- * Headroom fraction (of FD_CEILING) at or below which the state is `warn`:
+ * Headroom fraction (of the resolved ceiling) at or below which the state is `warn`:
  * the Editor is approaching the Mono ceiling and an agent should surface the
  * trend so the operator can save + restart before the hang. ≥80% usage.
  */
@@ -51,15 +68,28 @@ export interface FdCountFailed {
     message: string;
 }
 export type FdCountResult = FdCountOk | FdCountFailed;
-/** Coarse pressure state derived from `computeFdHeadroom`. */
-export type FdPressureState = "ok" | "warn" | "critical" | "unknown";
+/**
+ * Coarse pressure state derived from `computeFdHeadroom`.
+ *
+ * `over_ceiling` is informational, NOT an alarm: the OS-level fd count (from
+ * `lsof` / `/proc` / `HandleCount`) already exceeds the Mono-ceiling proxy, but
+ * `lsof` counts ALL OS file descriptors (mmap'd assets, file watchers, regular
+ * `FileStream` handles) while only descriptors registered with Mono's
+ * IOSelector count toward the real trip point. So an asset-heavy project can
+ * legitimately sit over the proxy ceiling on a fresh, healthy process. The
+ * actionable signal there is the TREND (`rising` / `leaking`), not the
+ * absolute. The router only raises an operator warning on `over_ceiling` when
+ * the trend is actively climbing; a stable/no-history over-ceiling process
+ * gets a `pressureNote` instead of a `warning`.
+ */
+export type FdPressureState = "ok" | "warn" | "critical" | "over_ceiling" | "unknown";
 /** Headroom metric against the Mono fd ceiling. */
 export interface FdHeadroom {
-    /** Open fds / FD_CEILING, clamped to [0, 1] when count is known. */
+    /** Open fds / ceiling, clamped to [0, 1] when count is known. */
     pressureRatio: number;
-    /** FD_CEILING - count, clamped at 0. */
+    /** ceiling - count, clamped at 0. */
     headroom: number;
-    /** The fixed ceiling (Mono ~1024). */
+    /** The resolved ceiling (Mono ~1024 default, configurable per project). */
     ceiling: number;
     state: FdPressureState;
     /** `false` when the underlying count was an approximation (Windows). */
@@ -73,6 +103,38 @@ export interface FdHeadroom {
 export interface FdProbe {
     count(pid: number): FdCountResult;
 }
+/**
+ * Parse the stdout of a successful `lsof -p <pid>` run into an fd count.
+ * Pure (no I/O) so it can be unit-tested without spawning lsof. lsof prints
+ * a header line ("COMMAND PID USER FD TYPE ...") then one row per open file;
+ * only rows whose FD column is a numbered descriptor count (see
+ * {@link countLsofFdRows}). Empty stdout means the PID vanished between
+ * spawn and read.
+ */
+export declare function parseLsofStdout(stdout: string, pid: number): FdCountResult;
+/**
+ * Classify a failed `lsof -p <pid>` invocation. Pure (no I/O). `lsof` exits
+ * non-zero for several reasons: the PID is gone (the common case), but also
+ * privilege boundaries / SIP-protected handles — and in those cases it still
+ * prints FD rows to stdout before exiting 1. Node's `execFileSync` attaches
+ * that captured stdout to the error object as `err.stdout`; when present and
+ * non-empty, parse it instead of reporting not_found. Only map to not_found
+ * when there is no usable stdout AND the message indicates the PID is truly
+ * absent — a bare "exit code: 1" is ambiguous (privilege errors also exit 1).
+ *
+ * Two guardrails on the captured-stdout path:
+ *   - `err.stdout` is only parsed when it is genuinely a non-empty string.
+ *     When execFileSync fails at spawn (ENOENT/EPERM) the property exists but
+ *     is undefined/null; naive String() coercion turned that into the literal
+ *     "undefined" — one "line" — which parsed as a confident count of ZERO
+ *     fds, exactly the failed-probe-as-ok misreport FdCountFailed exists to
+ *     prevent.
+ *   - When the probe was killed by the FD_PROBE_TIMEOUT_MS timeout, any
+ *     captured stdout is a PARTIAL listing (lsof was still writing). The
+ *     parsed count is a lower bound, so it is flagged `approximate: true`
+ *     instead of being reported as an exact count.
+ */
+export declare function classifyLsofError(err: unknown, pid: number): FdCountResult;
 /** Read the active probe. Production callers use this via `countFileDescriptors`. */
 export declare function getFdProbe(): FdProbe;
 /**
@@ -91,7 +153,7 @@ export declare function setFdProbeForTest(fake: FdProbe | null): () => void;
  */
 export declare function countFileDescriptors(pid: number): FdCountResult;
 /**
- * Pure headroom math against the fixed Mono fd ceiling. The OS soft limit
+ * Pure headroom math against the Mono fd ceiling. The OS soft limit
  * (`ulimit -n`) is intentionally NOT used — it is a loose upper bound and is
  * misleading for GUI-launched Unity on macOS (inherits `launchctl limit
  * maxfiles`, not the shell ulimit).
@@ -99,8 +161,17 @@ export declare function countFileDescriptors(pid: number): FdCountResult;
  * `null` count (probe failed) → `state: "unknown"` with `reliable: false`. An
  * agent must NOT treat "unknown" as "ok"; it should surface the trend (if any
  * prior samples exist) and tell the operator the live count could not be read.
+ *
+ * `over_ceiling` (count >= ceiling) is informational: the OS-level count
+ * exceeded the Mono-ceiling proxy, but `lsof` over-counts relative to the
+ * IOSelector-registered descriptors that actually trip the hang. The router
+ * decides whether to alarm based on the TREND, not this absolute state.
+ *
+ * @param ceiling the resolved fd ceiling (default {@link FD_CEILING_DEFAULT});
+ *   passed in by the router from `readFdCeiling` so the math scales with a
+ *   project-configured override.
  */
-export declare function computeFdHeadroom(count: number | null, approximate?: boolean): FdHeadroom;
+export declare function computeFdHeadroom(count: number | null, approximate?: boolean, ceiling?: number): FdHeadroom;
 /** One fd sample recorded in the session-scoped ring. */
 export interface FdSample {
     /** Wall-clock timestamp (ms since epoch). */
@@ -121,9 +192,9 @@ export type FdTrendState = "no_history" | "stable" | "rising" | "leaking" | "unk
 export interface FdTrend {
     state: FdTrendState;
     /**
-     * First-to-last delta in fd count (negative for a leak — the count grew).
-     * `null` when there are fewer than two samples with known counts for the
-     * same PID.
+     * First-to-last delta in fd count (positive for a leak — the count grew;
+     * negative when it shrank). `null` when there are fewer than two samples
+     * with known counts for the same PID.
      */
     delta: number | null;
     /** Number of samples used for the trend (same-PID, known-count). */
@@ -132,15 +203,26 @@ export interface FdTrend {
 /**
  * Pure trend detector over a sample list. Only considers samples with a known
  * count for the SAME pid (a Unity restart changes the PID; the trend must not
- * mix pre- and post-restart samples). A monotonic climb of ≥10% of the
- * ceiling across ≥3 samples is `leaking`; a non-monotonic climb is `rising`;
- * otherwise `stable`. Fewer than two usable samples → `no_history`.
+ * mix pre- and post-restart samples). A strictly non-decreasing climb of at
+ * least the leak threshold (10% of the ceiling, capped at
+ * {@link FD_LEAK_DELTA_MAX}) across ≥2 samples is `leaking`; any other
+ * net-positive first-to-last delta (a non-monotonic climb, or a monotonic climb
+ * below the threshold) is `rising`; otherwise `stable`. Fewer than two usable
+ * samples → `no_history`. `leaking` is the actionable signal; `rising` is drift.
+ *
+ * @param ceiling the resolved fd ceiling (default {@link FD_CEILING_DEFAULT});
+ *   the leak threshold scales with it (capped at {@link FD_LEAK_DELTA_MAX}) so a
+ *   project that configures a higher ceiling (e.g. a CoreCLR runtime) does not
+ *   flag normal growth as a leak — while a very high ceiling cannot blind the
+ *   detector to a real climb.
  */
-export declare function analyzeFdTrend(samples: readonly FdSample[]): FdTrend;
+export declare function analyzeFdTrend(samples: readonly FdSample[], ceiling?: number): FdTrend;
 /**
  * Caveat string surfaced in the resource_pressure response so an agent (and
- * the operator) understand the launch-context nuance: the Mono ceiling, not
- * the OS soft limit, is the trip point; a GUI-launched Unity inherits
- * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit.
+ * the operator) understand the launch-context nuance: the Mono ceiling, not the
+ * OS soft limit, is the trip point; a GUI-launched Unity inherits
+ * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit. The
+ * resolved ceiling applied to the sample is reported separately in the
+ * response's `ceiling` / `ceilingSource` fields.
  */
 export declare const LAUNCH_CONTEXT_CAVEAT: string;

package/dist/process-diagnostics.js

@@ -16,8 +16,9 @@
 //   that is the real trip point for the Bee build-driver hang. The OS
 //   `ulimit -n` soft limit is only a loose upper bound and is misleading on
 //   macOS: a GUI-launched Unity inherits `launchctl limit maxfiles`, not the
-//   MCP server's shell `ulimit`. So we measure headroom against the fixed
-//   Mono ceiling (FD_CEILING), not the variable OS limit.
+//   MCP server's shell `ulimit`. So we measure headroom against the Mono
+//   ceiling (default FD_CEILING_DEFAULT = 1024, configurable per project via
+//   `.unity-open-mcp/settings.json`), not the variable OS limit.
 //
 // Cross-platform probe:
 //   - macOS: `lsof -p <pid>` (no /proc on macOS). Bounded execFileSync
@@ -36,10 +37,27 @@ import { readdirSync } from "node:fs";
  * misleading for a GUI-launched Unity on macOS (it inherits `launchctl limit
  * maxfiles`, not the shell's ulimit). Documented in the tool response via
  * `launchContextCaveat`.
+ *
+ * This is the DEFAULT used when a project has not overridden the ceiling via
+ * `.unity-open-mcp/settings.json` (`resourcePressure.fdCeiling`). The actual
+ * ceiling applied to a sample is resolved by `readFdCeiling` in
+ * `project-settings.ts` and threaded into `computeFdHeadroom` /
+ * `analyzeFdTrend` so the math scales with the configured value (relevant for
+ * Unity 6 / CoreCLR runtimes whose internal ceiling may differ from Mono's
+ * classic 1024).
+ */
+export const FD_CEILING_DEFAULT = 1024;
+/**
+ * Absolute cap on the leak-detection threshold. The threshold is 10% of the
+ * resolved ceiling, but a very high configured ceiling (e.g. a CoreCLR runtime
+ * that legitimately sits over the Mono proxy) would otherwise push it so high
+ * that a real monotonic climb is missed — a climb of this many descriptors is a
+ * clear leak signal regardless of the ceiling. Kicks in once the ceiling exceeds
+ * ~5000 (10% of 5000 = 500).
  */
-export const FD_CEILING = 1024;
+export const FD_LEAK_DELTA_MAX = 500;
 /**
- * Headroom fraction (of FD_CEILING) at or below which the state is `warn`:
+ * Headroom fraction (of the resolved ceiling) at or below which the state is `warn`:
  * the Editor is approaching the Mono ceiling and an agent should surface the
  * trend so the operator can save + restart before the hang. ≥80% usage.
  */
@@ -54,54 +72,140 @@ export const FD_PROBE_TIMEOUT_MS = 3_000;
 // ---------------------------------------------------------------------------
 // Platform-specific probe implementations.
 // ---------------------------------------------------------------------------
-/** macOS `lsof -p <pid>` scanner. Returns the line count (one line per fd). */
-function probeMacos(pid) {
-    let stdout;
-    try {
-        stdout = execFileSync("lsof", ["-p", String(pid)], {
-            encoding: "utf8",
-            timeout: FD_PROBE_TIMEOUT_MS,
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        // lsof exits non-zero when the PID is gone. Treat that as not_found.
-        if (/no such file|exit code: 1/i.test(message)) {
-            return {
-                count: null,
-                method: "lsof",
-                reason: "not_found",
-                message: `lsof reported no process for PID ${pid}.`,
-            };
+/**
+ * Count the actual file-descriptor rows in an `lsof -p` listing. Not every
+ * output row is an fd: `cwd` (working directory), `txt` (mapped executable and
+ * shared libraries — often dozens of rows on a loaded Editor), `rtd`, `del`,
+ * `ltz`/`ltx` rows describe directories and mmaps that Mono's IOSelector never
+ * registers. Counting every row systematically inflated the absolute fd count
+ * against the ~1024 Mono ceiling (an asset-heavy Editor maps hundreds of
+ * `txt` rows alone), skewing the warn/critical ratio states. The FD column
+ * index is located from the header; a row counts when its FD value starts with
+ * a digit (real fds are "0u"/"1w"/"255r"-style — number plus optional
+ * mode/lock letters). When no recognizable header exists (unusual), fall back
+ * to counting all rows so the probe never under-reports to zero.
+ */
+function countLsofFdRows(lines) {
+    if (lines.length === 0)
+        return 0;
+    const header = lines[0].trim().split(/\s+/);
+    const fdCol = header.indexOf("FD");
+    let count = 0;
+    for (let i = 1; i < lines.length; i++) {
+        if (fdCol >= 0) {
+            const fd = lines[i].trim().split(/\s+/)[fdCol];
+            if (fd !== undefined && /^\d/.test(fd))
+                count++;
+        }
+        else {
+            count++;
         }
+    }
+    return count;
+}
+/**
+ * Parse the stdout of a successful `lsof -p <pid>` run into an fd count.
+ * Pure (no I/O) so it can be unit-tested without spawning lsof. lsof prints
+ * a header line ("COMMAND PID USER FD TYPE ...") then one row per open file;
+ * only rows whose FD column is a numbered descriptor count (see
+ * {@link countLsofFdRows}). Empty stdout means the PID vanished between
+ * spawn and read.
+ */
+export function parseLsofStdout(stdout, pid) {
+    const lines = stdout.split(/\r?\n/).filter((l) => l.length > 0);
+    if (lines.length === 0) {
+        return {
+            count: null,
+            method: "lsof",
+            reason: "not_found",
+            message: `lsof produced no output for PID ${pid}.`,
+        };
+    }
+    return {
+        count: countLsofFdRows(lines),
+        method: "lsof",
+        approximate: false,
+    };
+}
+/**
+ * Classify a failed `lsof -p <pid>` invocation. Pure (no I/O). `lsof` exits
+ * non-zero for several reasons: the PID is gone (the common case), but also
+ * privilege boundaries / SIP-protected handles — and in those cases it still
+ * prints FD rows to stdout before exiting 1. Node's `execFileSync` attaches
+ * that captured stdout to the error object as `err.stdout`; when present and
+ * non-empty, parse it instead of reporting not_found. Only map to not_found
+ * when there is no usable stdout AND the message indicates the PID is truly
+ * absent — a bare "exit code: 1" is ambiguous (privilege errors also exit 1).
+ *
+ * Two guardrails on the captured-stdout path:
+ *   - `err.stdout` is only parsed when it is genuinely a non-empty string.
+ *     When execFileSync fails at spawn (ENOENT/EPERM) the property exists but
+ *     is undefined/null; naive String() coercion turned that into the literal
+ *     "undefined" — one "line" — which parsed as a confident count of ZERO
+ *     fds, exactly the failed-probe-as-ok misreport FdCountFailed exists to
+ *     prevent.
+ *   - When the probe was killed by the FD_PROBE_TIMEOUT_MS timeout, any
+ *     captured stdout is a PARTIAL listing (lsof was still writing). The
+ *     parsed count is a lower bound, so it is flagged `approximate: true`
+ *     instead of being reported as an exact count.
+ */
+export function classifyLsofError(err, pid) {
+    const message = err instanceof Error ? err.message : String(err);
+    const errObj = err && typeof err === "object"
+        ? err
+        : undefined;
+    const capturedStdout = typeof errObj?.stdout === "string" ? errObj.stdout : "";
+    // execFileSync timeout: Node kills the child (SIGTERM by default) and sets
+    // `code: "ETIMEDOUT"` / `killed: true` on the error. Stdout captured up to
+    // that point is a partial fd listing.
+    const timedOut = errObj?.code === "ETIMEDOUT" ||
+        (errObj?.killed === true && typeof errObj?.signal === "string");
+    const capturedLines = capturedStdout.split(/\r?\n/).filter((l) => l.length > 0);
+    if (capturedLines.length > 0) {
+        return {
+            count: countLsofFdRows(capturedLines),
+            method: "lsof",
+            approximate: timedOut,
+        };
+    }
+    if (timedOut) {
         return {
             count: null,
             method: "lsof",
             reason: "lsof_failed",
-            message: `lsof failed for PID ${pid}: ${message}`,
+            message: `lsof timed out after ${FD_PROBE_TIMEOUT_MS}ms for PID ${pid} with no output.`,
         };
     }
-    // `lsof -p <pid>` prints a header line ("COMMAND PID USER FD TYPE ...") then
-    // one line per open fd. Subtract the header. An empty/blank stdout means the
-    // PID vanished between the spawn and the read — treat as not_found.
-    const lines = stdout.split(/\r?\n/).filter((l) => l.length > 0);
-    if (lines.length === 0) {
+    if (/no such file|no process|not found/i.test(message)) {
         return {
             count: null,
             method: "lsof",
             reason: "not_found",
-            message: `lsof produced no output for PID ${pid}.`,
+            message: `lsof reported no process for PID ${pid}.`,
         };
     }
-    // Header is the first line; its FD column says "FD" literally. The rest are
-    // per-fd rows. Subtract 1 for the header.
     return {
-        count: Math.max(0, lines.length - 1),
+        count: null,
         method: "lsof",
-        approximate: false,
+        reason: "lsof_failed",
+        message: `lsof failed for PID ${pid}: ${message}`,
     };
 }
+/** macOS `lsof -p <pid>` scanner. Returns the line count (one line per fd). */
+function probeMacos(pid) {
+    let stdout;
+    try {
+        stdout = execFileSync("lsof", ["-p", String(pid)], {
+            encoding: "utf8",
+            timeout: FD_PROBE_TIMEOUT_MS,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+    }
+    catch (err) {
+        return classifyLsofError(err, pid);
+    }
+    return parseLsofStdout(stdout, pid);
+}
 /** Linux `/proc/<pid>/fd` directory entry count (no shell-out). */
 function probeLinux(pid) {
     let entries;
@@ -236,7 +340,7 @@ export function countFileDescriptors(pid) {
     return currentProbe.count(pid);
 }
 /**
- * Pure headroom math against the fixed Mono fd ceiling. The OS soft limit
+ * Pure headroom math against the Mono fd ceiling. The OS soft limit
  * (`ulimit -n`) is intentionally NOT used — it is a loose upper bound and is
  * misleading for GUI-launched Unity on macOS (inherits `launchctl limit
  * maxfiles`, not the shell ulimit).
@@ -244,22 +348,38 @@ export function countFileDescriptors(pid) {
  * `null` count (probe failed) → `state: "unknown"` with `reliable: false`. An
  * agent must NOT treat "unknown" as "ok"; it should surface the trend (if any
  * prior samples exist) and tell the operator the live count could not be read.
+ *
+ * `over_ceiling` (count >= ceiling) is informational: the OS-level count
+ * exceeded the Mono-ceiling proxy, but `lsof` over-counts relative to the
+ * IOSelector-registered descriptors that actually trip the hang. The router
+ * decides whether to alarm based on the TREND, not this absolute state.
+ *
+ * @param ceiling the resolved fd ceiling (default {@link FD_CEILING_DEFAULT});
+ *   passed in by the router from `readFdCeiling` so the math scales with a
+ *   project-configured override.
  */
-export function computeFdHeadroom(count, approximate = false) {
+export function computeFdHeadroom(count, approximate = false, ceiling = FD_CEILING_DEFAULT) {
     if (count === null || !Number.isFinite(count)) {
         return {
             pressureRatio: 0,
-            headroom: FD_CEILING,
-            ceiling: FD_CEILING,
+            headroom: ceiling,
+            ceiling,
             state: "unknown",
             reliable: false,
         };
     }
     const clamped = Math.max(0, count);
-    const pressureRatio = Math.min(1, clamped / FD_CEILING);
-    const headroom = Math.max(0, FD_CEILING - clamped);
+    const pressureRatio = Math.min(1, clamped / ceiling);
+    const headroom = Math.max(0, ceiling - clamped);
     let state;
-    if (approximate) {
+    if (clamped >= ceiling) {
+        // OS-level fd count already past the Mono-ceiling proxy. Informational,
+        // not an alarm — `lsof` over-counts (mmap/assets/watchers) vs the
+        // IOSelector-registered descriptors that trip the hang. The router keys
+        // the operator warning off the TREND for this state.
+        state = "over_ceiling";
+    }
+    else if (approximate) {
         // Windows HandleCount is naturally higher than Unix fds — only flag
         // critical, never warn, so an agent does not over-react.
         state = pressureRatio >= FD_CRITICAL_RATIO ? "critical" : "ok";
@@ -276,7 +396,7 @@ export function computeFdHeadroom(count, approximate = false) {
     return {
         pressureRatio,
         headroom,
-        ceiling: FD_CEILING,
+        ceiling,
         state,
         reliable: !approximate,
     };
@@ -284,11 +404,20 @@ export function computeFdHeadroom(count, approximate = false) {
 /**
  * Pure trend detector over a sample list. Only considers samples with a known
  * count for the SAME pid (a Unity restart changes the PID; the trend must not
- * mix pre- and post-restart samples). A monotonic climb of ≥10% of the
- * ceiling across ≥3 samples is `leaking`; a non-monotonic climb is `rising`;
- * otherwise `stable`. Fewer than two usable samples → `no_history`.
+ * mix pre- and post-restart samples). A strictly non-decreasing climb of at
+ * least the leak threshold (10% of the ceiling, capped at
+ * {@link FD_LEAK_DELTA_MAX}) across ≥2 samples is `leaking`; any other
+ * net-positive first-to-last delta (a non-monotonic climb, or a monotonic climb
+ * below the threshold) is `rising`; otherwise `stable`. Fewer than two usable
+ * samples → `no_history`. `leaking` is the actionable signal; `rising` is drift.
+ *
+ * @param ceiling the resolved fd ceiling (default {@link FD_CEILING_DEFAULT});
+ *   the leak threshold scales with it (capped at {@link FD_LEAK_DELTA_MAX}) so a
+ *   project that configures a higher ceiling (e.g. a CoreCLR runtime) does not
+ *   flag normal growth as a leak — while a very high ceiling cannot blind the
+ *   detector to a real climb.
  */
-export function analyzeFdTrend(samples) {
+export function analyzeFdTrend(samples, ceiling = FD_CEILING_DEFAULT) {
     if (samples.length === 0) {
         return { state: "no_history", delta: null, sampleCount: 0 };
     }
@@ -301,9 +430,11 @@ export function analyzeFdTrend(samples) {
     const first = usable[0].count;
     const last = usable[usable.length - 1].count;
     const delta = last - first;
-    // `rising` = strictly non-decreasing across all usable samples (each step
-    // ≥ the previous). `leaking` = rising AND the total climb is ≥10% of the
-    // Mono ceiling (a meaningful leak, not measurement noise).
+    // `leaking` = strictly non-decreasing across all usable samples AND the total
+    // climb ≥ the leak threshold (10% of the ceiling, capped at FD_LEAK_DELTA_MAX)
+    // — a meaningful monotonic leak. `rising` = a net-positive first-to-last delta
+    // that does NOT qualify as a leak (non-monotonic, or a monotonic climb below
+    // the threshold) — drift / measurement noise, not actionable by itself.
     let monotonic = true;
     for (let i = 1; i < usable.length; i++) {
         if (usable[i].count < usable[i - 1].count) {
@@ -311,7 +442,8 @@ export function analyzeFdTrend(samples) {
             break;
         }
     }
-    if (monotonic && delta >= FD_CEILING * 0.1) {
+    const leakThreshold = Math.min(ceiling * 0.1, FD_LEAK_DELTA_MAX);
+    if (monotonic && delta >= leakThreshold) {
         return { state: "leaking", delta, sampleCount: usable.length };
     }
     if (delta > 0) {
@@ -321,13 +453,19 @@ export function analyzeFdTrend(samples) {
 }
 /**
  * Caveat string surfaced in the resource_pressure response so an agent (and
- * the operator) understand the launch-context nuance: the Mono ceiling, not
- * the OS soft limit, is the trip point; a GUI-launched Unity inherits
- * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit.
+ * the operator) understand the launch-context nuance: the Mono ceiling, not the
+ * OS soft limit, is the trip point; a GUI-launched Unity inherits
+ * `launchctl limit maxfiles` (macOS) rather than the shell's ulimit. The
+ * resolved ceiling applied to the sample is reported separately in the
+ * response's `ceiling` / `ceilingSource` fields.
  */
-export const LAUNCH_CONTEXT_CAVEAT = "Headroom is measured against Mono's internal ~1024 file-descriptor ceiling " +
-    "(the real trip point for the Bee build-driver hang), NOT the OS soft limit " +
-    "(ulimit -n / launchctl limit maxfiles). A GUI-launched Unity inherits the " +
-    "desktop environment's file limit, not the MCP server's shell limit, so the " +
-    "OS soft limit is only a loose upper bound.";
+export const LAUNCH_CONTEXT_CAVEAT = "Headroom is measured against the Mono runtime's internal file-descriptor " +
+    "ceiling (default ~1024 — the real trip point for the Bee build-driver hang), " +
+    "NOT the OS soft limit (ulimit -n / launchctl limit maxfiles). A GUI-launched " +
+    "Unity inherits the desktop environment's file limit, not the MCP server's " +
+    "shell limit, so the OS soft limit is only a loose upper bound. The ceiling " +
+    "is configurable per project via `.unity-open-mcp/settings.json` " +
+    "(`resourcePressure.fdCeiling`) for runtimes whose internal limit differs " +
+    "from Mono's classic 1024 (e.g. Unity 6 / CoreCLR); the resolved value and " +
+    "its source are in the response's `ceiling` and `ceilingSource` fields.";
 //# sourceMappingURL=process-diagnostics.js.map

package/dist/process-diagnostics.js.map

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

package/dist/project-settings.d.ts

@@ -0,0 +1,36 @@
+/** Below this configured ceiling the value is rejected → default. */
+export declare const FD_CEILING_MIN = 64;
+/** Above this configured ceiling the value is clamped down. */
+export declare const FD_CEILING_MAX = 1000000;
+/**
+ * The `resourcePressure` slice. `JsonUtility` on the C# side ignores it; this
+ * module is the only reader. Optional end-to-end so a missing slice falls back
+ * to the default ceiling.
+ */
+export interface ResourcePressureSettings {
+    fdCeiling?: number;
+}
+/** Result of resolving the fd ceiling for a project. */
+export interface FdCeilingResolution {
+    /** The fd ceiling to apply (already clamped into range). */
+    ceiling: number;
+    /** `"config"` when a valid in-range value was read; `"default"` otherwise. */
+    source: "default" | "config";
+}
+/**
+ * Resolve the settings file path for a project root. Exported for tests.
+ * `resolve` (not `join`) anchors a RELATIVE project path against the server's
+ * cwd instead of producing a relative path that would be re-interpreted by
+ * later read calls — matching how every other project-rooted path is resolved.
+ */
+export declare function settingsFilePath(projectPath: string): string;
+/**
+ * Read the fd ceiling for a project from `.unity-open-mcp/settings.json`.
+ * Never throws: missing file, unparseable JSON, missing slice, or an invalid
+ * value all fall back to {@link FD_CEILING_DEFAULT} with `source: "default"`.
+ *
+ * Reads fresh on every call — `resource_pressure` is invoked infrequently
+ * (after heavy automation), and fresh reads let an operator change the setting
+ * without restarting the MCP server.
+ */
+export declare function readFdCeiling(projectPath: string): FdCeilingResolution;