@cleocode/core 2026.10.4 → 2026.10.5

package/dist/resources/darwin-backend.js

@@ -2,16 +2,23 @@
  * macOS ResourceMonitor backend.
  *
  * macOS has no PSI. This backend maps the kernel's own signals onto the
- * PSI-shaped {@link ResourceSample}, so `evaluateState` and the slot scaling
- * work unchanged:
+ * PSI-shaped {@link ResourceSample}, so `evaluateState`, the slot scaling and
+ * the governor's budgets work unchanged:
  *
  *   - `kern.memorystatus_vm_pressure_level` — the kernel's memory pressure
  *     verdict (1 normal, 2 warning, 4 critical), the signal jetsam acts on
- *   - `kern.memorystatus_level` — free memory as a percentage of RAM, counting
- *     reclaimable pages (unlike `os.freemem()`, which reports only the free
- *     page list and reads near zero on a healthy Mac)
- *   - `vm.swapusage` — swap in use (reported, not scored: macOS allocates
- *     swapfiles on demand, so used/total sits at 80–95% on a healthy Mac)
+ *   - `kern.memorystatus_level` — the share of RAM that is neither wired nor
+ *     held by the compressor (active + inactive + free + speculative pages).
+ *     Unlike `os.freemem()`, which reads near zero on a healthy Mac, it falls
+ *     only as memory is wired or compressed
+ *   - `vm.compressor_bytes_used` — RAM the compressor occupies (the
+ *     "Compressed" figure of Activity Monitor and vm_stat, read here without a
+ *     `vm_stat` spawn)
+ *   - `vm.swapusage` — swap in use
+ *   - `vm.page_{free,speculative,pageable_external,purgeable}_count` ×
+ *     `hw.pagesize` — memory the kernel can hand out without compressing or
+ *     swapping (free pages, file cache, purgeable caches): darwin's
+ *     `MemAvailable` (T13132)
  *   - `vm.loadavg` + `hw.perflevel{0,1}.logicalcpu` (or `hw.ncpu`) —
  *     run-queue length per effective core (CPU saturation)
  *
@@ -24,32 +31,71 @@
  * file read happens on the sample path; `sweepChildRss` (low frequency) uses
  * `ps`.
  *
- * ## Mapping
+ * ## Memory mapping (T13127)
  *
- * Memory (`globalPressure`): `some avg10` is the higher of a kernel-level score
- * (warning 15, critical 40) and a free-memory score (`2 × (20 − free%)`,
- * clamped at 0). `full avg10` is
- * 15 when the kernel reports critical. With the monitor's default thresholds
- * (hold 10 / backoff 20), a kernel warning holds and critical backs off.
+ * The kernel's own verdict decides whether memory is short NOW; the other
+ * signals only grade how short. Two scores, the higher wins:
  *
- * CPU (`cpuPressure`): effective cores are performance cores plus half the
- * efficiency cores (a 6P+12E machine counts as 12; `hw.ncpu` when the split is
- * unknown). With `r = load / cores`, `some = 100 × (r − 1) / r`
- * once `r > 1`: the share of runnable work that is waiting for a core. A box
- * running twice its cores scores 50. avg10/avg60/avg300 come from the 1/5/15
- * minute load averages. Memory is instantaneous in all three windows.
+ * - **Kernel warning or critical**: 15 or 40, plus severity. Above half of RAM
+ *   wired or compressed (`q`, from `1 − memorystatus_level`, or the
+ *   compressor's share when larger or the level is unreadable), each point of
+ *   `q` adds one; the swap the squeeze pushed out adds `50 × swap/RAM`, faded
+ *   in as `q` rises from {@link DARWIN_SWAP_RAMP} `[0.30, 0.50]`. Swap is never
+ *   counted while the kernel says normal: swapped pages linger for hours after
+ *   pressure has gone (idle apps keep them), so at a normal kernel level it is
+ *   history, not pressure.
+ * - **Headroom, at any level**: reclaimable memory in bytes (free +
+ *   speculative + file-backed + purgeable pages; memory neither wired nor
+ *   compressed when the page counts are unreadable), against
+ *   {@link darwinHeadroomFloorBytes} (a quarter of RAM, at least 6 GiB, at most
+ *   half of RAM). Below that floor the score rises to 30 as headroom runs out,
+ *   but while the kernel says normal it stops at
+ *   {@link DARWIN_NORMAL_HEADROOM_CAP} (15, the memory gate's resume
+ *   threshold): it can hold, never back off or keep a latched gate shut.
+ *   Anonymous memory apps hold is not headroom, which the neither-wired-nor-
+ *   compressed share counted as if it were (T13132). A box with large wired
+ *   local-model weights but plenty left is not short.
+ *
+ * With the monitor's thresholds (hold 10, backoff 20): a kernel warning alone
+ * holds; critical, or a warning with a hot squeeze and swap, backs off.
+ * Calibration: the 2026-10-03 incident shape (48 GiB, kernel warning, 41%
+ * neither wired nor compressed, 13.6 GiB swap) scores 38 (backoff); before
+ * T13127 it scored 15, so heavy work kept being admitted. A 16 GiB laptop at
+ * 44% wired or compressed with 6 GiB of old swap, an 8 GiB Air at 44% with
+ * 3 GiB, and a 64 GiB Mac with 40 GiB of wired model weights and 21 GiB left
+ * all score 0 at a normal kernel level.
+ *
+ * `full avg10` is 15 when the kernel reports critical. Memory is instantaneous
+ * in all three windows.
+ *
+ * ## CPU mapping
+ *
+ * Effective cores are performance cores plus half the efficiency cores (a
+ * 6P+12E machine counts as 12; `hw.ncpu` when the split is unknown). With
+ * `r = load / cores`, `some = 100 × (r − 1) / r` once `r > 1`: the share of
+ * runnable work that is waiting for a core. A box running twice its cores
+ * scores 50. avg10/avg60/avg300 come from the 1/5/15 minute load averages.
  *
  * @module resources/darwin-backend
  * @task T12981
+ * @task T13127
  * @epic T12978
  */
 import { execFile } from 'node:child_process';
 import { totalmem } from 'node:os';
+import { GIB_PER_WORKER } from '../tasks/heavy-tool-env.js';
+import { MEMORY_GATE_RESUME_AT_OR_BELOW } from './pressure-gate.js';
 /** The sysctl names one sample reads, in one exec. */
 export const DARWIN_SYSCTL_NAMES = [
     'kern.memorystatus_vm_pressure_level',
     'kern.memorystatus_level',
+    'vm.compressor_bytes_used',
     'vm.swapusage',
+    'vm.page_free_count',
+    'vm.page_speculative_count',
+    'vm.page_pageable_external_count',
+    'vm.page_purgeable_count',
+    'hw.pagesize',
     'vm.loadavg',
     'hw.ncpu',
     'hw.perflevel0.logicalcpu',
@@ -62,7 +108,8 @@ function parseSize(value) {
         return null;
     const n = Number.parseFloat(m[1]);
     const unit = { K: 1024, M: MIB, G: 1024 * MIB, T: 1024 * 1024 * MIB }[m[2] ?? ''] ?? 1;
-    return Number.isFinite(n) ? n * unit : null;
+    // Whole bytes: "1.88M" is not a whole number of bytes, and reports print bytes.
+    return Number.isFinite(n) ? Math.round(n * unit) : null;
 }
 /**
  * Parse `sysctl <names>` output (`name: value` per line).
@@ -106,9 +153,20 @@ export function parseDarwinSysctl(output) {
             loadAvg = [nums[0], nums[1], nums[2]];
         }
     }
+    const pageSize = int('hw.pagesize');
+    const freePages = int('vm.page_free_count');
+    const reclaimableBytes = pageSize === null || pageSize <= 0 || freePages === null
+        ? null
+        : pageSize *
+            (freePages +
+                (int('vm.page_speculative_count') ?? 0) +
+                (int('vm.page_pageable_external_count') ?? 0) +
+                (int('vm.page_purgeable_count') ?? 0));
     return {
         pressureLevel: int('kern.memorystatus_vm_pressure_level'),
+        reclaimableBytes,
         freePercent: int('kern.memorystatus_level'),
+        compressorBytes: int('vm.compressor_bytes_used'),
         swapTotalBytes,
         swapUsedBytes,
         loadAvg,
@@ -120,16 +178,121 @@ export function parseDarwinSysctl(output) {
 function clamp(n) {
     return Math.max(0, Math.min(100, n));
 }
+/** Kernel pressure-level scores on the PSI `some avg10` scale (warning, critical). */
+export const DARWIN_LEVEL_SCORES = Object.freeze({ warning: 15, critical: 40 });
+/**
+ * Share of RAM wired or compressed above which a kernel warning grows more
+ * severe (one point per percentage point of RAM).
+ */
+export const DARWIN_WARN_SQUEEZE_KNEE = 0.5;
+/**
+ * Squeeze range over which swap starts to count at a kernel warning, from not
+ * at all to in full: a cold compressor means the swap is not active.
+ */
+export const DARWIN_SWAP_RAMP = [0.3, 0.5];
+/** Score per unit of swap/RAM when swap counts in full. */
+const SWAP_WEIGHT = 50;
+/** The headroom score reached when no memory is left neither wired nor compressed. */
+const HEADROOM_SCORE_MAX = 30;
+/**
+ * The most headroom alone can score while the kernel says normal: the memory
+ * gate's resume threshold ({@link MEMORY_GATE_RESUME_AT_OR_BELOW}, 15), below
+ * backoff and the gate's refuse threshold (25). Low reclaimable memory can
+ * narrow admission (hold, half the budget) but never refuse heavy work or
+ * defer db-heavy (the sentient tick, exodus-on-open) on its own, and a gate
+ * latched by a passing kernel warning releases once the kernel is back to
+ * normal. Only a kernel warning or critical level goes past it (T13132, #1865
+ * review).
+ */
+export const DARWIN_NORMAL_HEADROOM_CAP = MEMORY_GATE_RESUME_AT_OR_BELOW;
+const GIB = 1024 ** 3;
+/**
+ * The headroom below which memory scores at any kernel level: a quarter of
+ * RAM, at least one heavy worker's footprint ({@link GIB_PER_WORKER} GiB), and
+ * never more than half of RAM (T13132, after the #1806 review: a fixed 6 GiB
+ * was a sliver of a large machine).
+ *
+ * @param totalBytes - physical RAM in bytes.
+ *
+ * @example
+ * ```ts
+ * darwinHeadroomFloorBytes(48 * 1024 ** 3); // 12 GiB
+ * darwinHeadroomFloorBytes(16 * 1024 ** 3); // 6 GiB
+ * darwinHeadroomFloorBytes(8 * 1024 ** 3);  // 4 GiB
+ * ```
+ */
+export function darwinHeadroomFloorBytes(totalBytes) {
+    return Math.min(totalBytes / 2, Math.max(totalBytes / 4, GIB_PER_WORKER * GIB));
+}
+/**
+ * Memory available without compressing or swapping, in bytes: the
+ * reclaimable page counts when readable, else the share of RAM neither wired
+ * nor compressed. `null` when neither is known.
+ *
+ * @param s - parsed signals.
+ * @param totalBytes - physical RAM in bytes.
+ */
+export function darwinHeadroomBytes(s, totalBytes) {
+    if (s.reclaimableBytes !== null)
+        return Math.max(0, Math.min(totalBytes, s.reclaimableBytes));
+    const squeeze = darwinSqueeze(s, totalBytes);
+    return squeeze === null ? null : (1 - squeeze) * totalBytes;
+}
 /**
- * Memory pressure score (PSI `some`-equivalent, 0–100) from darwin signals.
- * Returns `null` when neither the kernel level nor free% is readable.
+ * Share of RAM (0–1) that is wired or compressed: `1 − memorystatus_level`,
+ * or the compressor's share when that is larger or the level is unreadable.
+ * `null` when neither is known.
+ *
+ * @param s - parsed signals.
+ * @param totalBytes - physical RAM in bytes.
  */
-export function darwinMemorySome(s) {
-    if (s.pressureLevel === null && s.freePercent === null)
+export function darwinSqueeze(s, totalBytes) {
+    const fromLevel = s.freePercent === null ? null : 1 - clamp(s.freePercent) / 100;
+    const fromCompressor = s.compressorBytes === null || totalBytes <= 0
+        ? null
+        : Math.min(1, Math.max(0, s.compressorBytes / totalBytes));
+    if (fromLevel === null)
+        return fromCompressor;
+    return fromCompressor === null ? fromLevel : Math.max(fromLevel, fromCompressor);
+}
+/**
+ * Memory pressure score (PSI `some`-equivalent, 0–100) from darwin signals:
+ * the higher of the kernel-verdict score (warning or critical, graded by
+ * squeeze and swap) and the headroom score (see the module doc). Returns
+ * `null` when neither the kernel level nor the squeeze is readable.
+ *
+ * @param s - parsed signals.
+ * @param totalBytes - physical RAM in bytes (for the headroom and swap share).
+ *
+ * @example
+ * ```ts
+ * // kernel warning, 41% neither wired nor compressed, 13.6 GiB swap on 48 GiB
+ * darwinMemorySome(signals, 48 * 1024 ** 3); // → 38.2: backoff
+ * ```
+ */
+export function darwinMemorySome(s, totalBytes) {
+    const squeeze = darwinSqueeze(s, totalBytes);
+    const headroomBytes = darwinHeadroomBytes(s, totalBytes);
+    if (s.pressureLevel === null && squeeze === null && headroomBytes === null)
         return null;
-    const levelScore = s.pressureLevel === 4 ? 40 : s.pressureLevel === 2 ? 15 : 0;
-    const freeScore = s.freePercent === null ? 0 : Math.max(0, 2 * (20 - s.freePercent));
-    return clamp(Math.max(levelScore, freeScore));
+    let headroomScore = 0;
+    if (headroomBytes !== null && totalBytes > 0) {
+        const floor = darwinHeadroomFloorBytes(totalBytes);
+        headroomScore = HEADROOM_SCORE_MAX * Math.max(0, 1 - headroomBytes / floor);
+    }
+    if (s.pressureLevel !== 2 && s.pressureLevel !== 4) {
+        return clamp(Math.min(headroomScore, DARWIN_NORMAL_HEADROOM_CAP));
+    }
+    const base = s.pressureLevel === 4 ? DARWIN_LEVEL_SCORES.critical : DARWIN_LEVEL_SCORES.warning;
+    let severity = 0;
+    if (squeeze !== null) {
+        const [from, full] = DARWIN_SWAP_RAMP;
+        const weight = Math.max(0, Math.min(1, (squeeze - from) / (full - from)));
+        const swapShare = s.swapUsedBytes === null || totalBytes <= 0 ? 0 : Math.max(0, s.swapUsedBytes / totalBytes);
+        severity =
+            100 * Math.max(0, squeeze - DARWIN_WARN_SQUEEZE_KNEE) + SWAP_WEIGHT * weight * swapShare;
+    }
+    return clamp(Math.max(headroomScore, base + severity));
 }
 /**
  * Cores that absorb load: performance cores plus half the efficiency cores,
@@ -149,9 +312,14 @@ export function cpuSomeFromLoad(load, ncpu) {
 function line(avg10, avg60, avg300) {
     return { avg10, avg60, avg300, totalUs: 0 };
 }
-/** Build the memory and CPU PSI-equivalents from parsed signals. */
-export function darwinPressure(s) {
-    const some = darwinMemorySome(s);
+/**
+ * Build the memory and CPU PSI-equivalents from parsed signals.
+ *
+ * @param s - parsed signals.
+ * @param totalBytes - physical RAM in bytes.
+ */
+export function darwinPressure(s, totalBytes) {
+    const some = darwinMemorySome(s, totalBytes);
     const memory = some === null
         ? null
         : {
@@ -169,6 +337,18 @@ export function darwinPressure(s) {
     }
     return { memory, cpu };
 }
+/** The memory half of the parsed signals, as carried on the sample. */
+function darwinMemorySignals(s, totalBytes) {
+    return {
+        pressureLevel: s.pressureLevel,
+        availablePercent: s.freePercent,
+        compressorBytes: s.compressorBytes,
+        swapUsedBytes: s.swapUsedBytes,
+        swapTotalBytes: s.swapTotalBytes,
+        reclaimableBytes: s.reclaimableBytes,
+        totalBytes,
+    };
+}
 const defaultSysctl = (names) => new Promise((resolve, reject) => {
     execFile('/usr/sbin/sysctl', [...names], { timeout: 2000 }, (err, stdout) => {
         // sysctl exits non-zero when ONE name is unknown but still prints the
@@ -231,10 +411,12 @@ export class DarwinResourceBackend {
         catch {
             signals = null;
         }
-        const { memory, cpu } = signals ? darwinPressure(signals) : { memory: null, cpu: null };
-        const memAvailableBytes = signals?.freePercent != null
-            ? Math.round((signals.freePercent / 100) * this.totalMemBytes)
-            : null;
+        const { memory, cpu } = signals
+            ? darwinPressure(signals, this.totalMemBytes)
+            : { memory: null, cpu: null };
+        // darwin's MemAvailable: the reclaimable pages when readable (T13132).
+        const headroom = signals ? darwinHeadroomBytes(signals, this.totalMemBytes) : null;
+        const memAvailableBytes = headroom === null ? null : Math.round(headroom);
         const walObservations = [];
         for (const walPath of this.walPaths) {
             const info = await this.statFileFn(walPath);
@@ -247,6 +429,7 @@ export class DarwinResourceBackend {
             globalPressure: memory,
             slicePressure: null,
             cpuPressure: cpu,
+            darwinMemory: signals ? darwinMemorySignals(signals, this.totalMemBytes) : null,
             walObservations,
         };
     }

package/dist/resources/darwin-backend.js.map

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

package/dist/resources/governor.d.ts

@@ -14,11 +14,14 @@
  *   `getCleoHome()/locks/resource-<class>/` arbitrated by `proper-lockfile`
  *   (crash-stale auto-release ⇒ genuinely cross-process without a daemon),
  *   plus a point-sample of the {@link ResourceMonitor} taken INSIDE acquire.
- *   Generalizes the tool-semaphore engine (`tool-semaphore.ts`).
  * - `off` — pure pass-through.
  *
- * `interactive-cli` is NEVER gated; `full-build` is pinned to one machine-wide
- * slot regardless of pressure.
+ * `interactive-cli` is NEVER gated. The heavy classes (`test-run`,
+ * `scoped-build`, `full-build`) are not slot classes any more: they are
+ * admitted by the admission ledger (`admission-ledger.ts`, T13133), one byte
+ * budget and one FIFO queue shared with evidence runs, gated by memory
+ * pressure (T13127) and re-entrant for nested runs. The governor delegates to
+ * it, so there is one admission point for heavy work.
  *
  * A local slot whose holder process is provably gone is reaped at once instead
  * of waiting out the 10 min stale timeout (T12963), as the tool semaphore does
@@ -26,12 +29,16 @@
  *
  * @task T11999
  * @task T12963
+ * @task T13127
+ * @task T13133
  * @epic T11992
  * @adr resource-governor-never-oom-architecture §3.4
  */
-import { type AdmissionResult, type GovernorMode, type ResourceClass, type ResourceGrant } from '@cleocode/contracts';
+import type { AdmissionResult, GovernorMode, ResourceClass, ResourceGrant } from '@cleocode/contracts';
+import { type AdmissionIoError } from './admission-ledger.js';
 import type { ResourceSample } from './backend.js';
 import { ResourceMonitor } from './monitor.js';
+import { type MemoryGateReporter } from './pressure-gate.js';
 /**
  * Resolve the governor mode from `CLEO_RESOURCES_MODE`, once per process.
  * Unknown / unset values resolve to `'local'` — the production-safe default
@@ -51,48 +58,33 @@ export interface BudgetOptions {
     readonly headroomMb?: number;
     /** Estimated RAM per agent session (incl. ~300 MB MCP suite), MiB. Default 4096. */
     readonly agentEstRamMb?: number;
-    /**
-     * Estimated worst-case RAM for ONE `test-run` / `scoped-build`, in MiB.
-     * Default 24576 (24 GiB) — a full `pnpm run test` is permitted 6 vitest forks
-     * × a 4 GiB heap cap by `vitest.memory-safe.ts`, and the governor has to
-     * admit against what a run may actually hold, not what it usually holds.
-     *
-     * @task T12091
-     */
-    readonly testRunEstRamMb?: number;
-    /** `some avg10` (pp) at/above which test/build budgets halve. Default 10. */
+    /** `some avg10` (pp) above which background work is refused. Default 10. */
     readonly holdSomeAvg10?: number;
-    /** `some avg10` (pp) at/above which test/build budgets floor to 1. Default 25. */
+    /** `some avg10` (pp) above which db-heavy work is refused. Default 25. */
     readonly floorSomeAvg10?: number;
     /** Override CPU count (tests). Default {@link availableParallelism}. */
     readonly cpuCount?: number;
     /** Override total RAM bytes (tests). Default {@link totalmem}. */
     readonly totalMemBytes?: number;
-    /**
-     * Budget on MEMORY pressure alone, ignoring the CPU signal (T13119, T13150).
-     *
-     * For work that must not be deferred merely because the machine is busy: a
-     * required migration of the store being opened, whose deferral leaves the
-     * command reading an empty store. CPU saturation slows such work; it cannot
-     * exhaust memory, which is what the governor exists to prevent. On macOS
-     * the CPU signal is derived from the load average (T12981), so any machine
-     * whose load exceeds twice its effective cores (a CI runner under vitest, a
-     * Mac running agents) read as `backoff` and deferred it.
-     */
-    readonly ignoreCpuPressure?: boolean;
 }
 /**
  * Compute the slot budget for a class given a point-sample.
  *
  * - `interactive-cli` → `Infinity` (never gated).
- * - `full-build` → `1` machine-wide, pressure-independent.
+ * - `test-run` / `scoped-build` / `full-build` → admitted by the admission
+ *   ledger in bytes (T13133); the number here is a count view of that budget:
+ *   how many default-footprint runs it holds under the current pressure share
+ *   (`0` while the memory gate refuses, `1` when CPU-saturated, half at hold,
+ *   at least `1` otherwise).
  * - `agent-session` → `clamp(1, ⌊(MemAvailable − headroom)/estRamMb⌋, cpus−2)`.
- * - `test-run` / `scoped-build` → `clamp(1, ⌊(MemAvailable − headroom)/estRamMb⌋,
- *   ⌊cpus/4⌋)`, ×0.5 when `some>hold`, floored to 1 when `some>floor` (T12091:
- *   was core-only, which authorised 144 GiB of heap on a 62 GiB box).
  * - `llm-call` → `max(1, cpus−2)` (primarily gated by the llm-queue elsewhere).
- * - `db-heavy` → `1`, deferred (→0) under `backoff`-level pressure.
- * - `background-autonomous` → `1` only when pressure is `ok`, else `0`.
+ * - `db-heavy` → `1`, deferred (→0) under `backoff`-level MEMORY pressure.
+ * - `background-autonomous` → `1` only when MEMORY pressure is `ok`, else `0`.
+ *
+ * Only `test-run`/`scoped-build` count CPU saturation (the combined
+ * {@link pressureScore}); every other class is budgeted on memory alone
+ * (T13170), so a busy machine never defers a store migration or the sentient
+ * tick.
  *
  * @adr resource-governor-never-oom-architecture §3.4 (budgets)
  */
@@ -107,14 +99,13 @@ export { SLOT_LOCK_STALE_MS, SLOT_LOCK_UPDATE_MS } from './slot-holder.js';
 /** An ungated grant (no slot held, `slot: -1`): `off` mode, `interactive-cli`, a nested run, fail-open. */
 export declare function passThroughGrant(cls: ResourceClass): ResourceGrant;
 /** Why the governor could not keep its state: the errno code and the path, when known. */
-export interface GovernorIoError {
-    readonly code: string;
-    readonly path: string | null;
-}
+export type GovernorIoError = AdmissionIoError;
 /**
  * The code and path of an error that means "the governor cannot keep state here" (a sandbox that
  * blocks writes to the CLEO home, a read-only or full disk, a broken CLEO home), or null for any
- * other error, which is a bug and must not be hidden.
+ * other error, which is a bug and must not be hidden. The same rule as the admission ledger's.
+ *
+ * @param err - a caught error.
  */
 export declare function governorIoError(err: unknown): GovernorIoError | null;
 /**
@@ -141,7 +132,8 @@ export interface AcquireOptions extends BudgetOptions {
      * When `false`, a single non-blocking pass — returns a {@link ResourceDeferral}
      * immediately if no slot is free (admission semantics; spawn/wave clamp).
      * When `true` (default), polls until a slot frees or `timeoutMs` elapses
-     * (queue semantics; heavy ops). On timeout, returns a deferral.
+     * (queue semantics; heavy ops). On timeout, returns a deferral. A zero
+     * budget (pressure) defers at once.
      */
     readonly blocking?: boolean;
     /** Max wall-clock to wait in blocking mode (ms). Default 3_600_000. */
@@ -155,6 +147,11 @@ export interface AcquireOptions extends BudgetOptions {
     readonly sample?: ResourceSample;
     /** Inject a monitor (tests). Default a fresh {@link ResourceMonitor}. */
     readonly monitor?: ResourceMonitor;
+    /**
+     * Told when a blocking acquire waits on the memory gate, and when that wait
+     * ends in an admission (T13127).
+     */
+    readonly memoryPressure?: MemoryGateReporter;
 }
 /**
  * The Never-OOM admission gate. Stateless wrapper over the mode-resolved

package/dist/resources/governor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../src/resources/governor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAsB9D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAKlD;AAgBD;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAMD,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,aAAkB,GACvB,MAAM,CA8CR;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE1D;AAeD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM3E,2GAA2G;AAC3G,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAQlE;AAiBD,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAKpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GACtC,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAAC,CAQ/F;AAcD,oDAAoD;AACpD,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;OAUG;IACG,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6EtF;;;;;;;OAOG;YACW,oBAAoB;IAkClC,8DAA8D;IACxD,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzF;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAWhF;AAuCD,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAIxD;AAED,uCAAuC;AACvC,eAAO,MAAM,QAAQ,kBAAyB,CAAC"}
+{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../src/resources/governor.ts"],"names":[],"mappings":"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"}