Distillation

Date: Sep 16, 2026

• 🟡 (13:27) Added regular file packages/core/src/cgroup-memory.ts; it imports readFileSync from node:fs and posix from node:path, defines CgroupMembership (version: 1 | 2, path), CgroupMemoryFiles (version: 1 | 2, directory, mountPoint, root), ReadTextFile, readTextFile(path), and decodeProcPath(value).
• 🔴 (13:27) User requires available-memory headroom to be recalculated so capacity is never admitted from a stale cgroup directory or a cached discovery miss.
• 🔴 (13:27) User requires inherited cgroup boundaries to fail closed when unreadable, ensuring sibling usage is never subtracted from the wrong scope.
• 🔴 (13:27) User requires embedding-pool sizing to avoid multiplying memory pressure on constrained hosts; each worker adds a full approximately 680 MB baseline, and the sizing logic uses a ×0.7 factor.
• 🔴 (13:27) User requires memory-limit adjustments to be monotonic: they may only lower the available-memory figure, never raise it, so they never increase memory use.
• 🟡 (13:27) Added cgroup-memory test coverage including v1/v2 membership and mount fixtures, escaped proc-path decoding, inherited-boundary handling, and the explicit case fails closed when an inherited boundary is unreadable.
• 🟡 (13:27) Added/updated pool-sizing test never raises the figure (monotonic — can only reduce memory use) and retained the expectation desiredEmbedPoolSize(7 * GB) equals DEFAULT_MAX_EMBED_POOL; deterministic memory controls shown include _setContainerFreeForTest(64 * GB).