Distillation

Date: Sep 16, 2026

• 🔴 (12:23) User stated worker admission must never use a stale cgroup directory or cached cgroup-discovery miss; memoryFiles() in packages/core/src/cgroup-memory.ts therefore rereads /proc/self/cgroup and /proc/self/mountinfo on every call.
• 🔴 (12:24) User stated the Nomic v1.5 adaptive embedding cap never exceeds the model’s maximum sequence length.
• 🔴 (12:24) User stated an OOM lowers the embedding cap by a factor of 0.7 and respawns the worker on a fresh heap; repeated failure eventually latches FTS-only operation.
• 🔴 (12:24) User stated a constrained environment whose free memory never improves must never re-probe the embedding cap.
• 🔴 (12:24) User stated persisted cap reconciliation must ensure a memory-rich reboot never re-probes upward to a cap that the WASM heap has already shown it cannot support.
• 🔴 (12:24) User stated memory-gated worker-pool sizing is never below 1; the primary worker always runs.
• 🟡 (12:24) readLinuxCgroupMemoryHeadroomBytes() in packages/core/src/cgroup-memory.ts rereads cgroup membership and mount information, parses numeric usage with safe-integer validation, treats max or limits above Number.MAX_SAFE_INTEGER as infinity, and computes the minimum finite headroom while walking from the process cgroup to the mount point.
• 🟡 (12:24) In packages/core/src/cgroup-memory.ts, unreadable cgroup data fails closed with undefined; only the cgroup v2 mount root where files.root === "/" may omit its memory files, while every descendant boundary must remain readable to prevent subtracting sibling usage from the wrong scope.
• 🟡 (12:24) Assistant reported that the 3 admission defects had narrow implementation paths and counterexample tests in the working copy; planned next steps were to verify the exact Jujutsu candidate, prove each regression against the parent, run guard-removal mutants, and then perform broad validation.
• 🟡 (12:24) Jujutsu working-copy candidate was change tmzmtlss, commit e6d0f1ed, bookmark fix/embedding-runtime-admission, description fix(core): correct embedding runtime selection and admission; parent was change pxrvwsvv, commit 2cbf4006, bookmark main, description feat(cch): add seeds for Claude Code up to 2.1.272 (#1780). Both revisions reported conflict=false; unrelated bookmark fix/responses-private-references had a conflict warning.
• 🟡 (12:25) Working-copy diff contained exactly 18 files with 1818 insertions(+), 90 deletions(-): added packages/core/src/cgroup-memory.ts and packages/core/test/cgroup-memory.test.ts; modified packages/core/src/embedding/local.ts, packages/core/src/embedding/pool.ts, packages/core/src/embedding-cap.ts, packages/core/src/embedding-worker-types.ts, packages/core/src/embedding-worker.ts, packages/core/src/embedding.ts, packages/core/src/ort-native.ts, packages/core/test/embedding-cap.test.ts, packages/core/test/embedding-pool-memory.test.ts, packages/core/test/embedding-pool.test.ts, packages/core/test/embedding-worker-types.test.ts, packages/core/test/ort-native.test.ts, packages/gateway/script/bundle.ts, packages/gateway/script/ort-platform-package.ts, packages/gateway/test/bundle-exports.test.ts, and packages/gateway/test/ort-platform-package.test.ts.
• 🟡 (12:27) packages/core/src/embedding/local.ts exposes test hooks _setConstrainedMemoryForTest(), _setContainerFreeForTest(), and _setAvailableMemoryForTest(). constrainedMemoryLimit() uses process.constrainedMemory() and returns 0 for unknown, unsupported, unconstrained, non-finite, or non-positive values.
• 🟡 (12:27) availableMemoryHeadroom() in packages/core/src/embedding/local.ts combines constrainedMemoryLimit(), Linux readLinuxCgroupMemoryHeadroomBytes(), and—when available—process.availableMemory(). Bun bypasses process.availableMemory() because its implementation currently aliases host freemem() inside constrained cgroups; failures fall back through resolveMemoryHeadroom().
• 🟡 (12:27) containerFreeBytes() in packages/core/src/embedding/local.ts passes host freemem(), the constrained-memory limit, and available-memory headroom to clampFreeToContainerLimit(). computeInitialEmbedCap() divides this container-clamped free memory by Math.max(1, memDivisor) before calling memoryModelEmbedCap() and reconcileEmbedCap().
• 🟡 (12:27) persistEmbedCap() stores JSON containing cap, freeMemBytes, and optional positive knownBadCap in kv_meta under EMBED_CAP_KV_KEY using an upsert; persistence failure is best-effort and causes cap derivation to run again on the next start.
• 🟡 (12:27) Search confirmed packages/core/src/embedding-cap.ts exports clampFreeToContainerLimit() at line 160 and resolveMemoryHeadroom() at line 180.