@nimbus-sh/worker 0.1.2 → 0.1.4

package/dist/npm/r2-cache.d.ts

@@ -1,20 +1,16 @@
 /**
- * r2-cache.ts — L3 cross-tenant npm cache backed by R2 [W4]
- *               + L2 colo cache via `caches.default` [cache-and-scrub P3]
+ * r2-cache.ts — cross-tenant npm cache backed by R2 and caches.default.
  *
  * Purpose
  * ───────
- * Mirrors the Pyodide / Python Workers Package Bundling System pattern
- * (EW/SPEC at wiki.cfdata.org). The supervisor DO already maintains a
- * per-tenant SQLite cache (src/npm-cache.ts). This module adds an L3
- * cross-tenant tier in R2 so that one tenant's first-install of a package
- * benefits every subsequent tenant on the platform — the win that drops
- * Mossaic-class cold installs from ~60 s to a target ≤ 15 s.
+ * The supervisor DO already maintains a per-tenant SQLite cache. This
+ * module adds a cross-tenant tier in R2 so that one tenant's first install
+ * of a package benefits subsequent tenants on the platform.
  *
  * Caching layers (top-down):
  *   L1 — per-DO SQLite (warmest, in-memory; ~1 ms per file)
- *   L2 — `caches.default` (per-colo; ~50-500 µs hit / ~5-30 ms cold) ← P3 wins
- *   L3 — R2 (global; ~30-100 ms regional)               ← THIS MODULE
+ *   L2 — caches.default (per-colo; ~50-500 µs hit / ~5-30 ms cold)
+ *   L3 — R2 (global; ~30-100 ms regional)
  *   L4 — registry.npmjs.org origin (~100-300 ms cross-region)
  *
  * Two buckets, two key shapes:
@@ -38,24 +34,18 @@
  *   (deploy without buckets created, or wrangler dev without remote
  *   buckets), all R2 calls return null on read and no-op on write. The
  *   installer falls through to the existing network-fetch path with
- *   identical behaviour to today's main.
+ *   identical behaviour to the uncached install path.
  *
- * NOT in W4 scope (deferred):
+ * Deliberately out of scope here:
  *   - Streamed R2 reads via ReadableStream<Uint8Array> RPC return type
- *     (W7 — Streams over RPC). Today: bytes returned via structured-clone
+ *     Today: bytes returned via structured-clone
  *     subject to the 32 MiB cap. Packages > 30 MiB skip the R2 path and
  *     stream directly from npm.
- *   - npm publish webhook → cache invalidation (CT2 future).
- *   - L2 Cache API (D3.5) — separate work.
- *
- * References:
- *   - audit/sections/CF-INTERNAL-OPTIMIZATION-RESEARCH.md §D
- *   - audit/_drafts/D-npm-install.md (per-section provenance)
- *   - audit/sections/W4-plan.md
+ *   - npm publish webhook -> cache invalidation.
  */
 import type { CacheTier, CacheKind } from '../_shared/cache-stats.js';
 /**
- * Per-call cache-stat event (cache-observability wave). R2CacheClient
+ * Per-call cache-stat event (cache metrics support). R2CacheClient
  * accumulates these in instance state so the SupervisorRPC caller can
  * drain + forward to the DO isolate (where /api/_diag/cache reads from).
  * The local-singleton-write approach would be invisible to the DO's
@@ -76,7 +66,7 @@ export type R2CacheStatEvent = {
  *  everything atomically (e.g. if the storage shape changes or a bug
  *  poisoned a class of keys). */
 export declare const R2_CACHE_PREFIX = "v1";
-/** Packument TTL — 60 min (cache-observability wave; was 5 min pre-wave).
+/** Packument TTL — 60 min (cache metrics support; was 5 min pre-wave).
  *
  *  Rationale for the bump (~12× longer than pre-wave):
  *
@@ -154,18 +144,17 @@ export declare const L2_KEY_HOST = "https://nimbus-cache.invalid";
 /**
  * Compose the R2 object key for a tarball.
  *
- * Scheme A from W4-plan §3: `t/<name>/<version>.tgz`. Scope-prefixed
+ * Tarball keys use `t/<name>/<version>.tgz`. Scope-prefixed
  * names (`@scope/pkg`) keep their `@` and `/` because R2 keys allow any
  * UTF-8; we don't URL-encode them. Examples:
  *
  *   react@19.0.0                  → `v1/t/react/19.0.0.tgz`
  *   @vitejs/plugin-react@4.3.4    → `v1/t/@vitejs/plugin-react/4.3.4.tgz`
  *
- * The integrity digest is NOT in the key (Scheme B was rejected per
- * W4-plan §3; reads validate integrity post-fetch). Scheme A enables
- * pipelining: as soon as the resolver yields {name, version}, the
- * install facet can speculatively kick off getTarball() in parallel
- * with the network fetch.
+ * The integrity digest is not in the key; reads validate integrity
+ * post-fetch. This shape enables pipelining: as soon as the resolver yields
+ * {name, version}, the install facet can speculatively kick off getTarball()
+ * in parallel with the network fetch.
  */
 export declare function tarballKey(name: string, version: string): string;
 /** Compose the R2 object key for a packument. */
@@ -174,7 +163,6 @@ export declare function packumentKey(name: string): string;
  * Per-instance counters surfaced for tests / probes. Read via
  * `R2CacheClient.stats()`. Track at the FUNCTION boundary level so a
  * call that hits L2 bumps `l2HitsPackument` but NOT `l3GetsPackument`,
- * and vice versa. The probe at audit/probes/cache-and-scrub/* asserts
  * "after the first call, no more l3GetsPackument" — structurally
  * proving the L2 layer is functional even when local-dev wall-clock
  * latency is too noisy to demonstrate 5×.

package/dist/npm/r2-cache.d.ts.map

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

package/dist/npm/r2-cache.js

@@ -1,20 +1,16 @@
 /**
- * r2-cache.ts — L3 cross-tenant npm cache backed by R2 [W4]
- *               + L2 colo cache via `caches.default` [cache-and-scrub P3]
+ * r2-cache.ts — cross-tenant npm cache backed by R2 and caches.default.
  *
  * Purpose
  * ───────
- * Mirrors the Pyodide / Python Workers Package Bundling System pattern
- * (EW/SPEC at wiki.cfdata.org). The supervisor DO already maintains a
- * per-tenant SQLite cache (src/npm-cache.ts). This module adds an L3
- * cross-tenant tier in R2 so that one tenant's first-install of a package
- * benefits every subsequent tenant on the platform — the win that drops
- * Mossaic-class cold installs from ~60 s to a target ≤ 15 s.
+ * The supervisor DO already maintains a per-tenant SQLite cache. This
+ * module adds a cross-tenant tier in R2 so that one tenant's first install
+ * of a package benefits subsequent tenants on the platform.
  *
  * Caching layers (top-down):
  *   L1 — per-DO SQLite (warmest, in-memory; ~1 ms per file)
- *   L2 — `caches.default` (per-colo; ~50-500 µs hit / ~5-30 ms cold) ← P3 wins
- *   L3 — R2 (global; ~30-100 ms regional)               ← THIS MODULE
+ *   L2 — caches.default (per-colo; ~50-500 µs hit / ~5-30 ms cold)
+ *   L3 — R2 (global; ~30-100 ms regional)
  *   L4 — registry.npmjs.org origin (~100-300 ms cross-region)
  *
  * Two buckets, two key shapes:
@@ -38,26 +34,20 @@
  *   (deploy without buckets created, or wrangler dev without remote
  *   buckets), all R2 calls return null on read and no-op on write. The
  *   installer falls through to the existing network-fetch path with
- *   identical behaviour to today's main.
+ *   identical behaviour to the uncached install path.
  *
- * NOT in W4 scope (deferred):
+ * Deliberately out of scope here:
  *   - Streamed R2 reads via ReadableStream<Uint8Array> RPC return type
- *     (W7 — Streams over RPC). Today: bytes returned via structured-clone
+ *     Today: bytes returned via structured-clone
  *     subject to the 32 MiB cap. Packages > 30 MiB skip the R2 path and
  *     stream directly from npm.
- *   - npm publish webhook → cache invalidation (CT2 future).
- *   - L2 Cache API (D3.5) — separate work.
- *
- * References:
- *   - audit/sections/CF-INTERNAL-OPTIMIZATION-RESEARCH.md §D
- *   - audit/_drafts/D-npm-install.md (per-section provenance)
- *   - audit/sections/W4-plan.md
+ *   - npm publish webhook -> cache invalidation.
  */
 /** Schema version baked into every cache key. Bump to invalidate
  *  everything atomically (e.g. if the storage shape changes or a bug
  *  poisoned a class of keys). */
 export const R2_CACHE_PREFIX = 'v1';
-/** Packument TTL — 60 min (cache-observability wave; was 5 min pre-wave).
+/** Packument TTL — 60 min (cache metrics support; was 5 min pre-wave).
  *
  *  Rationale for the bump (~12× longer than pre-wave):
  *
@@ -180,18 +170,17 @@ async function l2Put(key, body) {
 /**
  * Compose the R2 object key for a tarball.
  *
- * Scheme A from W4-plan §3: `t/<name>/<version>.tgz`. Scope-prefixed
+ * Tarball keys use `t/<name>/<version>.tgz`. Scope-prefixed
  * names (`@scope/pkg`) keep their `@` and `/` because R2 keys allow any
  * UTF-8; we don't URL-encode them. Examples:
  *
  *   react@19.0.0                  → `v1/t/react/19.0.0.tgz`
  *   @vitejs/plugin-react@4.3.4    → `v1/t/@vitejs/plugin-react/4.3.4.tgz`
  *
- * The integrity digest is NOT in the key (Scheme B was rejected per
- * W4-plan §3; reads validate integrity post-fetch). Scheme A enables
- * pipelining: as soon as the resolver yields {name, version}, the
- * install facet can speculatively kick off getTarball() in parallel
- * with the network fetch.
+ * The integrity digest is not in the key; reads validate integrity
+ * post-fetch. This shape enables pipelining: as soon as the resolver yields
+ * {name, version}, the install facet can speculatively kick off getTarball()
+ * in parallel with the network fetch.
  */
 export function tarballKey(name, version) {
     return `${R2_CACHE_PREFIX}/t/${name}/${version}.tgz`;

package/dist/npm/resolve-facet.d.ts

@@ -59,9 +59,9 @@
  *   over the wire). For warm sessions, ~500 B per cached entry × at
  *   most 5000 entries = 2.5 MB, well under the 32 MB RPC cap.
  *
- *   Cache writes flow back via env.SUPERVISOR.putRegistryEntries in
- *   waves (every 50 resolved packages or end-of-phase, whichever first).
- *   Doesn't block forward progress.
+ *   Cache writes flow back via env.SUPERVISOR.putRegistryEntries in batches
+ *   of 50 resolved packages or at end-of-phase. They do not block forward
+ *   progress.
  */
 import type { ResolvedPackage } from './resolver.js';
 export interface FacetCachedEntry {
@@ -72,8 +72,7 @@ export interface FacetCachedEntry {
     tarballUrl: string;
     integrity: string;
     depsJson: string;
-    /** X.5-F R2: required peerDependencies (optionals filtered). Optional
-     *  for backward compat with supervisor builds that pre-date X.5-F. */
+    /** Required peerDependencies with optionals filtered. */
     peerDepsJson?: string;
     exportsJson: string;
     main: string;
@@ -94,15 +93,13 @@ export interface ResolveFacetSpec {
     fetchTimeoutMs: number;
     /** Cap on retries for transient failures. */
     retries: number;
-    /** W11: when true, FRAMEWORK_REQUIRED_PACKAGES (vite, …) are exempted
-     *  from the skip list. See audit/sections/W11-plan.md §3.0. */
+    /** When true, framework-required packages such as vite bypass the skip list. */
     frameworkAware?: boolean;
 }
 /**
- * W6.5: Telemetry-event mirror of `RegistryEvent` (defined in
- * `src/wasm-swap-registry.ts`). The facet cannot import the registry
- * (preamble has no import surface), so the type is duplicated here.
- * Parity is gated by audit/probes/w6.5/regression/event-fires-from-facet.mjs.
+ * Telemetry-event mirror of `RegistryEvent`. The facet cannot import the
+ * registry directly because the preamble has no import surface, so the type
+ * is duplicated here.
  */
 export type FacetRegistryEvent = {
     type: 'swap';
@@ -127,12 +124,9 @@ export interface ResolveFacetResult {
      *  `[resolve-facet] <line>`. Bounded to ~one line per resolved spec. */
     messages: string[];
     /**
-     * W6.5: registry decisions taken inside the facet (swap / transitive-
-     * skip / reject). Drained by the supervisor and forwarded to the
-     * registry sink via `emitRegistryEvent`. See npm-installer.ts.
-     *
-     * Note: throw-path reject events do NOT reach this field today (the
-     * facet throws before returning). Documented gap in W6.5-plan §5.3.
+     * Registry decisions taken inside the facet. Successful returns are drained
+     * by the supervisor and forwarded to the registry sink. Throw-path rejects
+     * do not reach this field because the facet returns through the error path.
      */
     registryEvents: FacetRegistryEvent[];
     /** Counter snapshot at end of phase. Mirrors src/diag-counters.ts shape

package/dist/npm/resolve-facet.d.ts.map

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

package/dist/npm/resolve-facet.js

@@ -59,9 +59,9 @@
  *   over the wire). For warm sessions, ~500 B per cached entry × at
  *   most 5000 entries = 2.5 MB, well under the 32 MB RPC cap.
  *
- *   Cache writes flow back via env.SUPERVISOR.putRegistryEntries in
- *   waves (every 50 resolved packages or end-of-phase, whichever first).
- *   Doesn't block forward progress.
+ *   Cache writes flow back via env.SUPERVISOR.putRegistryEntries in batches
+ *   of 50 resolved packages or at end-of-phase. They do not block forward
+ *   progress.
  */
 // ── Facet function ──────────────────────────────────────────────────────
 //
@@ -440,22 +440,16 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
     };
     // X.5-F R1: names the user typed at the top level + required peer-deps
     // bypass SKIP_PACKAGES. Populated lazily as the BFS walk discovers
-    // peer-deps. See audit/sections/X5F-plan.md §6.1-§6.2.
     const topLevelNames = new Set(Object.keys(spec.specs));
     /** Resolve one spec: cache-hit or fetch packument. */
     const resolveOne = async (name, range) => {
         // @ts-ignore — SHOULD_SKIP_PACKAGE provided by preamble.
         if (!topLevelNames.has(name) && SHOULD_SKIP_PACKAGE(name, !!spec.frameworkAware))
             return null;
-        // W6: registry transitive policy. Swap rewrites name in flight;
-        // 'fail' rejects throw; 'warn' rejects log [skip] and drop.
-        // W6.5: each decision also pushes a RegistryEvent into __pendingEvents
-        // (preamble-provided), drained by the supervisor after the facet
-        // returns. NOTE: the throw-path reject case below stops execution
-        // BEFORE __DRAIN_EVENTS is read by the caller — so reject events
-        // from the facet are an accepted incomplete-coverage gap (W6.5-plan
-        // §5.3). We still push them in case a future caller change drains
-        // events from the rejected ResolveFacetResult.
+        // Registry transitive policy. Swaps rewrite names in flight; 'fail'
+        // rejects throw; 'warn' rejects log [skip] and drop. Decisions are also
+        // pushed into the preamble-provided event buffer, which the supervisor
+        // drains after successful facet returns.
         let effName = name;
         // @ts-ignore — SHOULD_SWAP provided by preamble.
         const __swap = SHOULD_SWAP(name);
@@ -489,9 +483,9 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
                 // registry reject without relying on message-prefix string
                 // matching. Mirror of supervisor-side RegistryRejectError.
                 const err = new Error(`npm install rejected: ${__fail.from} — ${__fail.reason}`);
-                err.__w6_reject = true;
-                err.__w6_reject_from = __fail.from;
-                err.__w6_reject_reason = __fail.reason;
+                err.__nimbus_registry_reject = true;
+                err.__nimbus_registry_reject_from = __fail.from;
+                err.__nimbus_registry_reject_reason = __fail.reason;
                 throw err;
             }
         }
@@ -632,8 +626,6 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
     // killed the install once X.5-26b made lightningcss `transitive:
     // 'fail'`. The user only typed `npm install drizzle-orm`; expo-sqlite
     // and its mobile-build chain are best-effort by intent. See
-    // audit/sections/X5-drizzle-plan.md §2 (revised) and the trace probe
-    // audit/probes/x5-drizzle/investigation/04-trace-lightningcss-from-drizzle.mjs.
     const bestEffortNames = new Set();
     const queue2 = Object.entries(spec.specs);
     // F-2 profiling: emit per-layer width when host marks the diag flag.
@@ -677,14 +669,10 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
                 return pkg;
             }
             catch (e) {
-                // W6: REJECT_INSTALL with transitive='fail' throws from
-                // resolveOne tagged with `__w6_reject = true`. Propagate
-                // those — turning them into "UNHANDLED" log lines would
-                // silently partial-install. Other UNHANDLEDs continue to
-                // log + drop. Detection via own-property survives the
-                // postMessage / fn.toString() boundary (prototype is lost
-                // on that boundary, so `instanceof` would not work).
-                if (e && typeof e === 'object' && e.__w6_reject === true) {
+                // REJECT_INSTALL with transitive='fail' throws from resolveOne
+                // with an own-property tag. Propagate those; turning them into
+                // "UNHANDLED" log lines would silently partial-install.
+                if (e && typeof e === 'object' && e.__nimbus_registry_reject === true) {
                     // X.5-drizzle: REJECT_INSTALL transitive='fail' that fires
                     // INSIDE an X.5-J best-effort optional-peer subtree
                     // (R2.5 enqueue) softly skips the offending package
@@ -692,7 +680,6 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
                     // not explicitly ask for the optional-peer-rooted
                     // subtree; mirror npm's --omit=optional behaviour for
                     // its descendants. See VERIFY-9D4B61D §6 + the trace
-                    // probe at audit/probes/x5-drizzle/investigation/
                     // 04-trace-lightningcss-from-drizzle.mjs for the
                     // canonical drizzle-orm → expo-sqlite → expo → @expo/
                     // metro-config → lightningcss chain.
@@ -772,7 +759,6 @@ export const resolveTreeInFacet = async function resolveTreeInFacet(spec, env) {
             // Uses preamble-injected SHOULD_REJECT_FAIL +
             // SHOULD_WARN_SKIP_TRANSITIVE accessors (the facet body is
             // serialised via fn.toString() and cannot import lookupReject).
-            // See audit/sections/X5J-plan.md §3 for the full rationale and
             // §3.6 for why we soft-skip BOTH transitive='fail' (loud reject)
             // and transitive='warn' optional peers — symmetry with the
             // existing transitive walk's silent-skip of warn-tier peers, plus

package/dist/npm/resolve-one-facet.d.ts

@@ -1,13 +1,11 @@
 /**
- * resolve-one-facet.ts — F-2 frontier-coordinator per-package task body.
+ * resolve-one-facet.ts — per-package resolution task body.
  *
  * Why this exists
  * ───────────────
- * F-2 (cleanup-not-done wave) replaces the single resolve-facet that
- * runs the WHOLE BFS in one isolate with a frontier-coordinator at the
- * supervisor that submits each layer of N packages as N independent
- * fanout tasks. This file is the per-task body — one packument fetch +
- * version pick + edge-extraction.
+ * The supervisor coordinates each dependency layer and submits packages as
+ * independent fanout tasks. This file is the per-task body: one packument
+ * fetch, one version pick, and edge extraction.
  *
  * Each task runs inside a Worker Loader isolate (NimbusFanoutPool routes
  * automatically: <5 = in-DO, ≥5 = peer-DO). The isolate is short-lived;
@@ -35,17 +33,17 @@
  *     out of the returned `pkg` and decides what goes in layer N+1.
  *   - Cycle detection: the supervisor maintains the `seen` set across
  *     layers. The task only sees one (name, range) per call.
- *   - X.5-drizzle best-effort tagging: the supervisor maintains the
+ *   - Best-effort optional-peer tagging: the supervisor maintains the
  *     bestEffortNames set; the task returns the `pkg` raw and the
  *     supervisor decides whether a downstream reject silent-skips or
  *     propagates.
- *   - X.5-F top-level handling: the supervisor maintains topLevelNames.
+ *   - Top-level handling: the supervisor maintains topLevelNames.
  *     `topLevel` is passed in per task so SKIP_PACKAGES bypass works.
  *
  * What the task DOES do
  * ─────────────────────
  *   1. Apply SKIP_PACKAGES filter (unless `topLevel`).
- *   2. Apply W6 swap / warn-skip / reject-fail registry policy.
+ *   2. Apply swap / warn-skip / reject-fail registry policy.
  *   3. Try in-task cache from `cachedHit` (one entry shipped from
  *      supervisor's NpmCache).
  *   4. R2 packument cache race (250 ms timeout) via env.SUPERVISOR
@@ -115,7 +113,7 @@ export interface ResolveOneResult {
     cacheWrites: any[];
     /** [npm] log lines, forwarded by the supervisor. */
     messages: string[];
-    /** W6.5 telemetry events to emitRegistryEvent. */
+    /** Registry telemetry events to emitRegistryEvent. */
     events: FacetRegistryEvent[];
     /**
      * Diagnostic: how many bytes the task fetched/decoded. Folded into
@@ -149,9 +147,8 @@ export interface ResolveOneResult {
         cacheKind: 'packument';
     }>;
     /**
-     * W6 reject. The supervisor inspects this and either propagates
-     * (regular path) or silent-skips (X.5-drizzle best-effort path) —
-     * the task doesn't see bestEffortNames.
+     * Registry reject. The supervisor inspects this and either propagates it
+     * or silent-skips best-effort optional-peer paths.
      */
     error?: {
         type: 'w6-reject';

package/dist/npm/resolve-one-facet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-one-facet.d.ts","sourceRoot":"","sources":["../../src/npm/resolve-one-facet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-one-facet.d.ts","sourceRoot":"","sources":["../../src/npm/resolve-one-facet.ts"],"names":[],"mappings":"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"}

package/dist/npm/resolve-one-facet.js

@@ -1,13 +1,11 @@
 /**
- * resolve-one-facet.ts — F-2 frontier-coordinator per-package task body.
+ * resolve-one-facet.ts — per-package resolution task body.
  *
  * Why this exists
  * ───────────────
- * F-2 (cleanup-not-done wave) replaces the single resolve-facet that
- * runs the WHOLE BFS in one isolate with a frontier-coordinator at the
- * supervisor that submits each layer of N packages as N independent
- * fanout tasks. This file is the per-task body — one packument fetch +
- * version pick + edge-extraction.
+ * The supervisor coordinates each dependency layer and submits packages as
+ * independent fanout tasks. This file is the per-task body: one packument
+ * fetch, one version pick, and edge extraction.
  *
  * Each task runs inside a Worker Loader isolate (NimbusFanoutPool routes
  * automatically: <5 = in-DO, ≥5 = peer-DO). The isolate is short-lived;
@@ -35,17 +33,17 @@
  *     out of the returned `pkg` and decides what goes in layer N+1.
  *   - Cycle detection: the supervisor maintains the `seen` set across
  *     layers. The task only sees one (name, range) per call.
- *   - X.5-drizzle best-effort tagging: the supervisor maintains the
+ *   - Best-effort optional-peer tagging: the supervisor maintains the
  *     bestEffortNames set; the task returns the `pkg` raw and the
  *     supervisor decides whether a downstream reject silent-skips or
  *     propagates.
- *   - X.5-F top-level handling: the supervisor maintains topLevelNames.
+ *   - Top-level handling: the supervisor maintains topLevelNames.
  *     `topLevel` is passed in per task so SKIP_PACKAGES bypass works.
  *
  * What the task DOES do
  * ─────────────────────
  *   1. Apply SKIP_PACKAGES filter (unless `topLevel`).
- *   2. Apply W6 swap / warn-skip / reject-fail registry policy.
+ *   2. Apply swap / warn-skip / reject-fail registry policy.
  *   3. Try in-task cache from `cachedHit` (one entry shipped from
  *      supervisor's NpmCache).
  *   4. R2 packument cache race (250 ms timeout) via env.SUPERVISOR
@@ -99,7 +97,7 @@ export const resolveOnePackumentInFacet = async function resolveOnePackumentInFa
     if (!spec.topLevel && SHOULD_SKIP_PACKAGE(spec.name, !!spec.frameworkAware)) {
         return out(null, 0, 'skipped');
     }
-    // 2. W6 registry policy.
+    // 2. Registry policy.
     let effName = spec.name;
     // @ts-ignore — preamble.
     const __swap = SHOULD_SWAP(spec.name);

package/dist/npm/resolver.d.ts

@@ -74,7 +74,6 @@ export declare function resolvePackage(name: string, versionRange: string, cache
  * W11: pass `opts.frameworkAware = true` when the project is detected as
  * one of {next, astro, nuxt, remix, sveltekit, vite, wrangler} so that
  * `vite` (and any future FRAMEWORK_REQUIRED_PACKAGES additions) actually
- * land in node_modules. See audit/sections/W11-plan.md §3.0.
  */
 export declare function resolveTree(specs: Record<string, string>, cache: NpmCache, onResolved?: (pkg: ResolvedPackage) => void, onProgress?: (msg: string) => void, fetchFn?: FetchFn, opts?: {
     frameworkAware?: boolean;
@@ -103,7 +102,6 @@ export declare function shouldSkipPackage(name: string): boolean;
  * Callers detect framework presence via `framework-detect.ts` BEFORE
  * starting resolution and thread the flag through `resolveTree`.
  *
- * See audit/sections/W11-plan.md §3.0.
  */
 export declare function shouldSkipPackageWithFramework(name: string, frameworkAware: boolean): boolean;
 //# sourceMappingURL=resolver.d.ts.map

package/dist/npm/resolver.d.ts.map

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

package/dist/npm/resolver.js

@@ -462,7 +462,6 @@ function versionToResolved(vData) {
  * when there are no required peers, so downstream code can use a single
  * truthiness check.
  *
- * X.5-F R2 — see audit/sections/X5F-plan.md §3.
  */
 function extractRequiredPeers(vData) {
     const peers = vData.peerDependencies;
@@ -507,7 +506,6 @@ function registryCacheToResolved(entry) {
  * W11: pass `opts.frameworkAware = true` when the project is detected as
  * one of {next, astro, nuxt, remix, sveltekit, vite, wrangler} so that
  * `vite` (and any future FRAMEWORK_REQUIRED_PACKAGES additions) actually
- * land in node_modules. See audit/sections/W11-plan.md §3.0.
  */
 export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn, opts) {
     const frameworkAware = !!(opts && opts.frameworkAware);
@@ -516,13 +514,11 @@ export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn,
     // X.5-F R1: names the user typed at the top level (or that are
     // required peer-deps of an installed package — see R2 below) bypass
     // SKIP_PACKAGES. Transitive `dependencies` walks do NOT add to this
-    // set, preserving silent-skip for build-tool noise. See audit/sections/
     // X5F-plan.md §6.1.
     const topLevelNames = new Set(Object.keys(specs));
     // X.5-G G1: names that came from a parent's `optionalDependencies`.
     // These are best-effort per npm 4828 — fetch failures and platform-
     // native-binding detection silent-skip them rather than propagating
-    // as install errors. See audit/sections/X5G-plan.md §2.
     const optionalNames = new Set();
     // X.5-drizzle: names enqueued by the X.5-J top-level optional-peer
     // path (R2.5) and ALL their transitive descendants. The user did not
@@ -530,15 +526,12 @@ export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn,
     // best-effort convenience. When a `transitive: 'fail'` REJECT_INSTALL
     // fires for a name in this set, we silent-skip the offending name +
     // log a notice, instead of throwing and killing the parent install.
-    // Mirrors src/npm-resolve-facet.ts. See audit/sections/X5-drizzle-plan.md.
     const bestEffortNames = new Set();
     const queue = Object.entries(specs);
     const limit = pLimit(RESOLVE_CONCURRENCY);
     // F-2 profiling support: emit per-layer width when
     // NIMBUS_DIAG_INSTALL_PIPELINE=1 (same flag used by VFS pipeline diag).
-    // Used by audit/probes/f2-resolver-fanout/ to measure the BFS-frontier
     // width distribution against the top-30 cohort. Zero cost in prod
-    // (env not set). See audit/sections/F2-RESOLVER-FANOUT-plan.md.
     const __f2Diag = (globalThis.process?.env?.NIMBUS_DIAG_INSTALL_PIPELINE === '1');
     let __f2LayerN = 0;
     while (queue.length > 0) {
@@ -685,7 +678,6 @@ export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn,
             // X.5-G G1: enqueue transitive optionalDependencies, tagged so
             // resolveOne skips platform-native bindings silently and any
             // fetch failure becomes optional-dep-skip rather than fail. See
-            // audit/sections/X5G-plan.md §2 for the npm 4828 rationale.
             if (pkg.optionalDependencies) {
                 for (const [depName, depRange] of Object.entries(pkg.optionalDependencies)) {
                     if (!resolved.has(depName) && !seen.has(depName)) {
@@ -699,7 +691,6 @@ export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn,
             // X.5-F R2: enqueue REQUIRED peer-deps (optionals already
             // filtered in versionToResolved). Mark them as topLevelNames so
             // they bypass SKIP_PACKAGES — ts-jest needs typescript even
-            // though typescript is in SKIP_PACKAGES. See audit/sections/
             // X5F-plan.md §3 for the bug evidence and §6.2 for the fix.
             if (pkg.peerDependencies) {
                 for (const [peerName, peerRange] of Object.entries(pkg.peerDependencies)) {
@@ -732,7 +723,6 @@ export async function resolveTree(specs, cache, onResolved, onProgress, fetchFn,
             // still hard-fail via the R2 path above (peerDependencies set
             // excludes optionals); transitive REQUIRED deps in REJECT_INSTALL
             // also still hard-fail via the dep walk's resolveOne reject path.
-            // See audit/sections/X5J-plan.md §3 for the full rationale.
             if (topLevelNames.has(pkg.name)) {
                 const allPeers = pkg.__allPeerDependencies;
                 if (allPeers) {
@@ -829,7 +819,6 @@ export function computeHoistPlan(resolved) {
 // from the user's installed `vite` to call createServer() — so when a
 // framework is detected, `vite` must actually land in node_modules.
 // `shouldSkipPackageWithFramework({ frameworkAware: true })` exempts
-// it. See audit/sections/W11-plan.md §3.0.
 //
 // X.5-G: `rollup` removed from SKIP_PACKAGES because it's now in
 // WASM_SWAPS (rollup → @rollup/wasm-node). SKIP would mask the swap at
@@ -881,7 +870,6 @@ export function shouldSkipPackage(name) {
  * Callers detect framework presence via `framework-detect.ts` BEFORE
  * starting resolution and thread the flag through `resolveTree`.
  *
- * See audit/sections/W11-plan.md §3.0.
  */
 export function shouldSkipPackageWithFramework(name, frameworkAware) {
     if (frameworkAware && FRAMEWORK_REQUIRED_PACKAGES.has(name))

package/dist/observability/oom-discriminator.d.ts

@@ -33,8 +33,6 @@
  *   - per-facet-id: single slot, one object.
  *
  * Snapshot ≤40 KB even with both rings full. Verified by
- * audit/probes/w5/functional/ring-persistence.mjs (failures) and
- * audit/probes/c-prime/recovery-events/ (recovery — Phase 1 C'.2).
  */
 import type { OomCause } from './oom-classify.js';
 export interface RpcFrame {