@intentius/chant 0.124.16 → 0.124.18

package/dist/components/fan-out-run.js

@@ -31,16 +31,17 @@
  * ## Or one approval per wave
  *
  * `waveGate` (#3049) is the other mode. Each wave is planned once the waves
- * before it applied, and its gate binds that wave's set digest. Gate names,
- * the digest and the gate decision come from the wave engine
- * (`../wave-engine.ts`, #3766), which `chant run wave` uses too. See
+ * before it applied, and its gate binds that wave's set digest. The loop,
+ * gate names, the digest and the gate decision come from the wave engine
+ * (`../wave-engine.ts`, #3766), which `chant run wave` uses too; this module
+ * hands it the steps a fan-out plans, decides and applies a wave with. See
  * {@link runGatedWaves}.
  */
 import { deployContext, runComponentDeploy, } from "./driver.js";
 import { downstreamWithin, remainingFanOut } from "./fan-out.js";
 import { evaluateGate, gitGateLedgerPort } from "../op/gate.js";
 import { planWaveComponent } from "./wave-plan.js";
-import { decideWaveGate, waveGateName, waveSetDigest } from "../wave-engine.js";
+import { decideWaveGate, runWaveLoop, waveGateName, waveSetDigest } from "../wave-engine.js";
 /** Thrown when `FanOutWaveGate.only` names a wave whose predecessors have not all applied. */
 export class EarlierWaveNotAppliedError extends Error {
     constructor(wave, earlier, components) {
@@ -230,131 +231,145 @@ async function runGatedWaves(plan, active, components, registry, options, waveGa
         }
     };
     options.onProgress?.({ type: "run-start", waves: plan.waves });
-    for (const [waveIndex, wave] of plan.waves.entries()) {
-        const waveNum = waveIndex + 1;
-        const runnable = wave.filter((name) => left.has(name) && !blockedBy.has(name));
-        if (waveGate.only !== undefined && waveNum < waveGate.only) {
-            if (runnable.length > 0)
-                throw new EarlierWaveNotAppliedError(waveGate.only, waveNum, runnable);
-            continue;
-        }
-        if (waveGate.only !== undefined && waveNum > waveGate.only)
-            break;
-        if (runnable.length === 0)
-            continue;
-        const gateName = waveGateName(waveGate.gate, waveNum);
-        const contexts = new Map(runnable.map((name) => [name, fanOutContext(options, name)]));
-        const planned = await Promise.all(runnable.map((name) => planComponent(byName.get(name), contexts.get(name), componentOutputs)));
-        const members = [];
-        const plansFor = new Map();
-        const waveFailures = [];
-        for (const p of planned) {
-            if ("error" in p) {
-                waveFailures.push({ component: p.component, error: p.error });
-                continue;
+    await runWaveLoop({
+        first: 1,
+        onward: (_k, outcome) => outcome === "next",
+        async plan({ k: waveNum }) {
+            const wave = plan.waves[waveNum - 1];
+            if (!wave)
+                return { end: "stop" };
+            const runnable = wave.filter((name) => left.has(name) && !blockedBy.has(name));
+            if (waveGate.only !== undefined && waveNum < waveGate.only) {
+                if (runnable.length > 0)
+                    throw new EarlierWaveNotAppliedError(waveGate.only, waveNum, runnable);
+                return { end: "next" };
             }
-            members.push(...p.members);
-            plansFor.set(p.component, p.plans);
-        }
-        let digest;
-        try {
-            // A wave where nothing planned has no set, and so no digest.
-            digest = members.length > 0 ? waveSetDigest(members) : "";
-        }
-        catch (err) {
-            // Two components planning the same root: there is no one plan for it.
-            const error = err instanceof Error ? err.message : String(err);
-            for (const name of plansFor.keys())
-                waveFailures.push({ component: name, error });
-            plansFor.clear();
-            digest = "";
-        }
-        for (const f of waveFailures) {
-            failed.push(f.component);
-            results.push(planFailure(f.component, f.error ?? "plan failed"));
-            markBlocked(f.component);
-        }
-        const toRun = runnable.filter((name) => plansFor.has(name));
-        const record = {
-            wave: waveNum,
-            op: waveGate.op,
-            gate: gateName,
-            components: [...runnable].sort(),
-            digest,
-            members: [...members].sort((a, b) => a.member.localeCompare(b.member)),
-            status: "failed",
-            ...(waveFailures.length > 0 ? { failed: waveFailures } : {}),
-        };
-        if (toRun.length === 0) {
-            waves.push(record);
-            options.onWaveSettled?.(record);
-            continue;
-        }
-        const check = await decideWaveGate(gates.port, {
-            op: waveGate.op,
-            gate: gateName,
-            digest,
-            description: waveGate.description ?? `wave ${waveNum} of ${plan.waves.length}: ${toRun.join(", ")}`,
-            ...(waveGate.timeout ? { timeout: waveGate.timeout } : {}),
-            ...(options.now ? { now: options.now } : {}),
-        });
-        if (!check.satisfied) {
-            // Nothing in this wave ran, and no later wave is planned: its plan
-            // would read outputs this wave has not written.
-            const stopped = {
+            if (waveGate.only !== undefined && waveNum > waveGate.only)
+                return { end: "stop" };
+            if (runnable.length === 0)
+                return { end: "next" };
+            const gateName = waveGateName(waveGate.gate, waveNum);
+            const contexts = new Map(runnable.map((name) => [name, fanOutContext(options, name)]));
+            const planned = await Promise.all(runnable.map((name) => planComponent(byName.get(name), contexts.get(name), componentOutputs)));
+            const members = [];
+            const plansFor = new Map();
+            const waveFailures = [];
+            for (const p of planned) {
+                if ("error" in p) {
+                    waveFailures.push({ component: p.component, error: p.error });
+                    continue;
+                }
+                members.push(...p.members);
+                plansFor.set(p.component, p.plans);
+            }
+            return { go: { runnable, gateName, contexts, members, plansFor, waveFailures } };
+        },
+        digest(_at, { members, plansFor, waveFailures }) {
+            try {
+                // A wave where nothing planned has no set, and so no digest.
+                return members.length > 0 ? waveSetDigest(members) : "";
+            }
+            catch (err) {
+                // Two components planning the same root: there is no one plan for it.
+                const error = err instanceof Error ? err.message : String(err);
+                for (const name of plansFor.keys())
+                    waveFailures.push({ component: name, error });
+                plansFor.clear();
+                return "";
+            }
+        },
+        async decide({ k: waveNum }, { runnable, gateName, members, plansFor, waveFailures }, digest) {
+            for (const f of waveFailures) {
+                failed.push(f.component);
+                results.push(planFailure(f.component, f.error ?? "plan failed"));
+                markBlocked(f.component);
+            }
+            const toRun = runnable.filter((name) => plansFor.has(name));
+            const record = {
+                wave: waveNum,
+                op: waveGate.op,
+                gate: gateName,
+                components: [...runnable].sort(),
+                digest,
+                members: [...members].sort((a, b) => a.member.localeCompare(b.member)),
+                status: "failed",
+                ...(waveFailures.length > 0 ? { failed: waveFailures } : {}),
+            };
+            if (toRun.length === 0) {
+                waves.push(record);
+                options.onWaveSettled?.(record);
+                return { end: "next" };
+            }
+            const check = await decideWaveGate(gates.port, {
+                op: waveGate.op,
+                gate: gateName,
+                digest,
+                description: waveGate.description ?? `wave ${waveNum} of ${plan.waves.length}: ${toRun.join(", ")}`,
+                ...(waveGate.timeout ? { timeout: waveGate.timeout } : {}),
+                ...(options.now ? { now: options.now } : {}),
+            });
+            if (!check.satisfied) {
+                // Nothing in this wave ran, and no later wave is planned: its plan
+                // would read outputs this wave has not written.
+                const stopped = {
+                    ...record,
+                    status: "gated",
+                    ...(check.mismatch?.approved ? { approved: check.mismatch.approved } : {}),
+                };
+                waves.push(stopped);
+                options.onWaveSettled?.(stopped);
+                gatedFact = check.pending;
+                return { end: "stop" };
+            }
+            return { go: { check, record, toRun } };
+        },
+        async apply({ k: waveNum }, { contexts, plansFor, waveFailures }, { check, record, toRun }) {
+            options.onProgress?.({ type: "wave-start", wave: waveNum, components: toRun });
+            const waveResults = await Promise.all(toRun.map(async (name) => {
+                options.onProgress?.({ type: "component-start", wave: waveNum, component: name });
+                const plans = plansFor.get(name);
+                const ctx = { ...contexts.get(name), ...(Object.keys(plans).length > 0 ? { plans } : {}) };
+                const result = await runComponentDeploy(byName.get(name), ctx, registry, componentOutputs, options.onProgress, gates);
+                options.onProgress?.({
+                    type: "component-done",
+                    wave: waveNum,
+                    component: name,
+                    status: result.status === "fail" ? "failed" : result.status,
+                });
+                options.onComponentSettled?.(result, componentOutputs[name]);
+                return result;
+            }));
+            results.push(...waveResults);
+            for (const result of waveResults) {
+                if (result.status === "ok") {
+                    completed.push(result.component);
+                    continue;
+                }
+                if (result.status === "fail") {
+                    failed.push(result.component);
+                    waveFailures.push({ component: result.component });
+                }
+                else {
+                    gatedFact ?? (gatedFact = result.gate);
+                }
+                markBlocked(result.component);
+            }
+            const settled = {
                 ...record,
-                status: "gated",
-                ...(check.mismatch?.approved ? { approved: check.mismatch.approved } : {}),
+                status: waveFailures.length > 0 ? "failed" : "applied",
+                approvedBy: check.resolution.resolvedBy,
+                ...(waveFailures.length > 0 ? { failed: waveFailures } : {}),
             };
-            waves.push(stopped);
-            options.onWaveSettled?.(stopped);
-            gatedFact = check.pending;
-            break;
-        }
-        options.onProgress?.({ type: "wave-start", wave: waveNum, components: toRun });
-        const waveResults = await Promise.all(toRun.map(async (name) => {
-            options.onProgress?.({ type: "component-start", wave: waveNum, component: name });
-            const plans = plansFor.get(name);
-            const ctx = { ...contexts.get(name), ...(Object.keys(plans).length > 0 ? { plans } : {}) };
-            const result = await runComponentDeploy(byName.get(name), ctx, registry, componentOutputs, options.onProgress, gates);
+            waves.push(settled);
+            options.onWaveSettled?.(settled);
             options.onProgress?.({
-                type: "component-done",
+                type: "wave-done",
                 wave: waveNum,
-                component: name,
-                status: result.status === "fail" ? "failed" : result.status,
+                status: waveFailures.length > 0 ? "failed" : waveResults.some((r) => r.status === "gated") ? "gated" : "ok",
             });
-            options.onComponentSettled?.(result, componentOutputs[name]);
-            return result;
-        }));
-        results.push(...waveResults);
-        for (const result of waveResults) {
-            if (result.status === "ok") {
-                completed.push(result.component);
-                continue;
-            }
-            if (result.status === "fail") {
-                failed.push(result.component);
-                waveFailures.push({ component: result.component });
-            }
-            else {
-                gatedFact ?? (gatedFact = result.gate);
-            }
-            markBlocked(result.component);
-        }
-        const settled = {
-            ...record,
-            status: waveFailures.length > 0 ? "failed" : "applied",
-            approvedBy: check.resolution.resolvedBy,
-            ...(waveFailures.length > 0 ? { failed: waveFailures } : {}),
-        };
-        waves.push(settled);
-        options.onWaveSettled?.(settled);
-        options.onProgress?.({
-            type: "wave-done",
-            wave: waveNum,
-            status: waveFailures.length > 0 ? "failed" : waveResults.some((r) => r.status === "gated") ? "gated" : "ok",
-        });
-    }
+            return "next";
+        },
+    });
     const blocked = [...blockedBy.entries()]
         .sort(([a], [b]) => a.localeCompare(b))
         .map(([component, by]) => ({ component, reason: "blocked", blockedBy: by }));

package/dist/config-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-sandbox.d.ts","sourceRoot":"","sources":["../src/config-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmDtG;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAA4B,GACxC,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAUlF"}
+{"version":3,"file":"config-sandbox.d.ts","sourceRoot":"","sources":["../src/config-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAoDtG;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,IAAI,IAAI,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAK5E;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAA4B,GACxC,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAUlF"}

package/dist/config-sandbox.js

@@ -1,5 +1,6 @@
 import { dirname } from "node:path";
 import { importConfigModule, requireConfigModule } from "./config-import.js";
+import { esModuleNamespace } from "./module-interop.js";
 /**
  * chant #1113 — decides WHERE a project's `chant.config.ts` is evaluated.
  *
@@ -77,7 +78,10 @@ export function resetSandboxConfigEvaluationForTests() {
  * evaluated, never how its result is read.
  */
 export function selectConfigExport(namespace) {
-    return namespace.default ?? namespace.config ?? namespace;
+    // A config tsx compiled as CommonJS arrives as `{ default: module.exports }`
+    // under a native import (#3897); read the module's own namespace instead.
+    const ns = esModuleNamespace(namespace);
+    return ns.default ?? ns.config ?? ns;
 }
 /**
  * Evaluate a project's `chant.config.ts` and return its configuration object,

package/dist/discovery/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/discovery/import.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/discovery/import.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAclC"}

package/dist/discovery/import.js

@@ -1,5 +1,6 @@
 import { DiscoveryError } from "../errors.js";
 import { ensureTypeScriptLoader } from "../ts-loader.js";
+import { esModuleNamespace } from "../module-interop.js";
 /**
  * Modules whose evaluation threw, and the error each threw with (#2368).
  *
@@ -54,7 +55,7 @@ export async function importModule(path) {
         throw failed;
     try {
         ensureTypeScriptLoader();
-        return await import(path);
+        return esModuleNamespace(await import(path));
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown import error";

package/dist/discovery/sandbox/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/discovery/sandbox/driver.ts"],"names":[],"mappings":"AA8DA,MAAM,WAAW,qBAAqB;IACpC,qIAAqI;IACrI,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,oNAAoN;IACpN,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAsB3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAoH3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6CrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAgGjF"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/discovery/sandbox/driver.ts"],"names":[],"mappings":"AAgEA,MAAM,WAAW,qBAAqB;IACpC,qIAAqI;IACrI,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,oNAAoN;IACpN,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAsB3E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAqH3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA8CrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiGjF"}

package/dist/discovery/sandbox/driver.js

@@ -56,6 +56,8 @@ const POST_SYNTH_MODULE = join(dirname(DISCOVERY_DIR), "lint", "post-synth.ts");
 // file, so the driver's `setBuildParams` call below mutates the one object
 // every bundled import observes.
 const PARAMS_MODULE = join(dirname(DISCOVERY_DIR), "params.ts");
+// #3897: a project file tsx compiled as CommonJS reads as its own namespace.
+const INTEROP_MODULE = join(dirname(DISCOVERY_DIR), "module-interop.ts");
 /** Escape a value for embedding as a JS/TS source-level literal. */
 function lit(value) {
     return JSON.stringify(value);
@@ -116,6 +118,7 @@ export function generateDriverSource(options) {
         `import { classifyChildError } from ${lit(CHILD_ERRORS_MODULE)};`,
         `import { getProvenance } from ${lit(PROVENANCE_MODULE)};`,
         `import { setBuildParams } from ${lit(PARAMS_MODULE)};`,
+        `import { esModuleNamespace } from ${lit(INTEROP_MODULE)};`,
         `import { writeSync } from "node:fs";`,
         ``,
         `const BUILD_ROOT = ${lit(buildRoot)};`,
@@ -163,7 +166,7 @@ export function generateDriverSource(options) {
         `  const errors = [];`,
     ];
     for (const file of files) {
-        lines.push(`  importing = ${lit(file)};`, `  try {`, `    const mod = await import(${lit(file)});`, `    modules.push({ file: ${lit(file)}, exports: mod });`, `  } catch (err) {`, `    errors.push(classifyChildError(${lit(file)}, err).toJSON());`, `  }`, `  importing = undefined;`);
+        lines.push(`  importing = ${lit(file)};`, `  try {`, `    const mod = esModuleNamespace(await import(${lit(file)}));`, `    modules.push({ file: ${lit(file)}, exports: mod });`, `  } catch (err) {`, `    errors.push(classifyChildError(${lit(file)}, err).toJSON());`, `  }`, `  importing = undefined;`);
     }
     lines.push(``, `  let entities = new Map();`, `  try {`, `    entities = collectEntities(modules, BUILD_ROOT);`, `  } catch (err) {`, `    errors.push(classifyChildError(errFile(err), err, "resolution").toJSON());`, `    await send({ entitySet: { entities: [] }, errors, provenanceByName: {} });`, `    return;`, `  }`, ``, 
     // Recorded BEFORE resolveAttrRefs/encode — not for the parent's own
@@ -198,6 +201,7 @@ export function generateConfigDriverSource(configPath) {
     return [
         `import { classifyChildError } from ${lit(CHILD_ERRORS_MODULE)};`,
         `import { scanConfigWireSafety } from ${lit(CONFIG_WIRE_MODULE)};`,
+        `import { esModuleNamespace } from ${lit(INTEROP_MODULE)};`,
         `import { writeSync } from "node:fs";`,
         ``,
         ...sendFunctionSource(),
@@ -205,7 +209,7 @@ export function generateConfigDriverSource(configPath) {
         `async function main() {`,
         `  let namespace;`,
         `  try {`,
-        `    namespace = await import(${lit(configPath)});`,
+        `    namespace = esModuleNamespace(await import(${lit(configPath)}));`,
         `  } catch (err) {`,
         `    await send({ kind: "chant-config", ok: false, error: classifyChildError(${lit(configPath)}, err).toJSON() });`,
         `    return;`,
@@ -273,6 +277,7 @@ export function generatePolicyDriverSource(policyPaths) {
         `import { classifyChildError } from ${lit(CHILD_ERRORS_MODULE)};`,
         `import { decodePolicyBuildResult, scanPolicyDiagnostics, PolicyWireError } from ${lit(POLICY_WIRE_MODULE)};`,
         `import { runPostSynthChecks, isPostSynthCheck } from ${lit(POST_SYNTH_MODULE)};`,
+        `import { esModuleNamespace } from ${lit(INTEROP_MODULE)};`,
         `import { writeSync } from "node:fs";`,
         ``,
         ...sendFunctionSource(),
@@ -315,7 +320,7 @@ export function generatePolicyDriverSource(policyPaths) {
     // the same order `loadPolicyChecks` collects in, so the diagnostics sequence
     // matches the in-process one exactly.
     for (const policyPath of policyPaths) {
-        lines.push(`  try {`, `    const mod = await import(${lit(policyPath)});`, `    for (const value of Object.values(mod)) {`, `      if (isPostSynthCheck(value)) checks.push(guard(value, ${lit(policyPath)}));`, `    }`, `  } catch (err) {`, `    await fail(${lit(policyPath)}, err, "import");`, `    return;`, `  }`);
+        lines.push(`  try {`, `    const mod = esModuleNamespace(await import(${lit(policyPath)}));`, `    for (const value of Object.values(mod)) {`, `      if (isPostSynthCheck(value)) checks.push(guard(value, ${lit(policyPath)}));`, `    }`, `  } catch (err) {`, `    await fail(${lit(policyPath)}, err, "import");`, `    return;`, `  }`);
     }
     lines.push(``, `  let diagnostics;`, `  try {`, `    diagnostics = runPostSynthChecks(checks, buildResult, request.env ?? undefined);`, `  } catch (err) {`, `    await fail("", err, "resolution");`, `    return;`, `  }`, ``, `  await send({ kind: "chant-policy", ok: true, diagnostics });`, `}`, ``, 
     // Registered synchronously at module top level — see the doc above on why

package/dist/lexicon-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lexicon-module.d.ts","sourceRoot":"","sources":["../src/lexicon-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAExE;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAiBvG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,EAAE,MAAM,EACf,SAAS,SAAM,GACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,EAClD,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBxB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3G;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5D;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAYpG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAsB,EAC/B,KAAK,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAe,GAC/C,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAe,GAC/C,MAAM,EAAE,CAEV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI9D;AAUD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAMpG;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAW1H"}
+{"version":3,"file":"lexicon-module.d.ts","sourceRoot":"","sources":["../src/lexicon-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAQH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAExE;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAiBvG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,EAAE,MAAM,EACf,SAAS,SAAM,GACd;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,EAClD,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBxB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3G;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5D;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAYpG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAsB,EAC/B,KAAK,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAe,GAC/C,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAe,GAC/C,MAAM,EAAE,CAEV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI9D;AAUD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAMpG;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAW1H"}

package/dist/lexicon-module.js

@@ -27,6 +27,7 @@ import { createRequire } from "node:module";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 import { ensureTypeScriptLoader } from "./ts-loader.js";
+import { esModuleNamespace } from "./module-interop.js";
 /** The lexicon name an entry declares, whichever form it takes. */
 export function lexiconDeclarationName(entry) {
     return typeof entry === "string" ? entry : entry.name;
@@ -156,7 +157,7 @@ export async function importLexiconModule(name) {
         return undefined;
     try {
         ensureTypeScriptLoader();
-        return (await import(path));
+        return esModuleNamespace((await import(path)));
     }
     catch (err) {
         throw new Error(`lexicon "${name}" is declared with module ${path}, which could not be loaded: ` +
@@ -227,7 +228,7 @@ export function resolveFromProject(spec, fromDir = process.cwd()) {
 export async function importLexiconPackage(spec, fromDir = process.cwd()) {
     try {
         ensureTypeScriptLoader();
-        return (await import(spec));
+        return esModuleNamespace((await import(spec)));
     }
     catch (err) {
         const pkg = packageNameOf(spec);
@@ -236,6 +237,6 @@ export async function importLexiconPackage(spec, fromDir = process.cwd()) {
         const resolved = resolveFromProject(spec, fromDir);
         if (resolved === undefined)
             throw err;
-        return (await import(pathToFileURL(resolved).href));
+        return esModuleNamespace((await import(pathToFileURL(resolved).href)));
     }
 }

package/dist/lint/policy-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-import.d.ts","sourceRoot":"","sources":["../../src/lint/policy-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,iEAAiE;AACjE,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,4IAA4I;AAC5I,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED,2HAA2H;AAC3H,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ3F"}
+{"version":3,"file":"policy-import.d.ts","sourceRoot":"","sources":["../../src/lint/policy-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,iEAAiE;AACjE,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,4IAA4I;AAC5I,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED,2HAA2H;AAC3H,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ3F"}

package/dist/lint/policy-import.js

@@ -23,6 +23,7 @@
  * that might forget to ask.
  */
 import { ensureTypeScriptLoader } from "../ts-loader.js";
+import { esModuleNamespace } from "../module-interop.js";
 /** Whether this process must run project policy modules inside the sandbox boundary instead of here. */
 let armed = false;
 /**
@@ -58,5 +59,5 @@ export async function importPolicyModule(policyPath) {
         throw new Error(`Refusing to import the policy module ${policyPath} into the chant process under --sandbox: it is project-authored code and must be imported inside the sandbox boundary (packages/core/src/lint/policy-sandbox.ts's runProjectPolicies).`);
     }
     ensureTypeScriptLoader();
-    return (await import(policyPath));
+    return esModuleNamespace((await import(policyPath)));
 }

package/dist/lint/rule-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-loader.d.ts","sourceRoot":"","sources":["../../src/lint/rule-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAgDvC;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsC5E"}
+{"version":3,"file":"rule-loader.d.ts","sourceRoot":"","sources":["../../src/lint/rule-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAiDvC;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsC5E"}

package/dist/lint/rule-loader.js

@@ -1,6 +1,7 @@
 import { readdirSync, existsSync } from "fs";
 import { dirname, join, resolve } from "path";
 import { ensureTypeScriptLoader } from "../ts-loader.js";
+import { esModuleNamespace } from "../module-interop.js";
 /**
  * Type guard to check if a value conforms to the LintRule interface.
  */
@@ -74,7 +75,7 @@ export async function loadLocalRules(projectDir) {
         let mod;
         try {
             ensureTypeScriptLoader();
-            mod = await import(filePath);
+            mod = esModuleNamespace(await import(filePath));
         }
         catch (err) {
             throw new Error(`Failed to load rule file "${file}": ${err instanceof Error ? err.message : String(err)}`);

package/dist/module-interop.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The namespace a project module was authored with, whichever module format
+ * tsx compiled it to (#3897).
+ *
+ * A `.ts` file with no `"type": "module"` `package.json` above it is compiled
+ * by tsx as CommonJS: `exports.default = ...` plus a non-enumerable
+ * `__esModule: true` marker. The compiled CLI loads project files with a
+ * native `import()`, and Node hands a CommonJS module back as a namespace
+ * whose `default` is the whole `module.exports`. So `export default x` arrives
+ * as `namespace.default.default`. Under the source CLI tsx's ESM loader sits
+ * in front of the `import()` and does this interop itself, which is why the
+ * nesting only showed up once the CLI ran compiled (#3879).
+ *
+ * When `namespace.default` carries the `__esModule` marker, the module's real
+ * namespace is that exports object: this returns a copy of it with the marker
+ * left out. Anything else, including an ES module whose default export is an
+ * object that happens to have a `default` key, is returned unchanged.
+ */
+export declare function esModuleNamespace<T extends Record<string, unknown>>(namespace: T): T;
+//# sourceMappingURL=module-interop.d.ts.map

package/dist/module-interop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-interop.d.ts","sourceRoot":"","sources":["../src/module-interop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAWpF"}

package/dist/module-interop.js

@@ -0,0 +1,39 @@
+/**
+ * The namespace a project module was authored with, whichever module format
+ * tsx compiled it to (#3897).
+ *
+ * A `.ts` file with no `"type": "module"` `package.json` above it is compiled
+ * by tsx as CommonJS: `exports.default = ...` plus a non-enumerable
+ * `__esModule: true` marker. The compiled CLI loads project files with a
+ * native `import()`, and Node hands a CommonJS module back as a namespace
+ * whose `default` is the whole `module.exports`. So `export default x` arrives
+ * as `namespace.default.default`. Under the source CLI tsx's ESM loader sits
+ * in front of the `import()` and does this interop itself, which is why the
+ * nesting only showed up once the CLI ran compiled (#3879).
+ *
+ * When `namespace.default` carries the `__esModule` marker, the module's real
+ * namespace is that exports object: this returns a copy of it with the marker
+ * left out. Anything else, including an ES module whose default export is an
+ * object that happens to have a `default` key, is returned unchanged.
+ */
+export function esModuleNamespace(namespace) {
+    // `in` before the read: a vitest factory mock throws on reading an export
+    // it does not define, and most modules have no `default` at all.
+    if (namespace === null || typeof namespace !== "object" || !("default" in namespace))
+        return namespace;
+    const exported = namespace.default;
+    if (!isCommonJsEsModule(exported))
+        return namespace;
+    const unwrapped = {};
+    for (const key of Object.keys(exported)) {
+        if (key !== "__esModule")
+            unwrapped[key] = exported[key];
+    }
+    return unwrapped;
+}
+/** A CommonJS `module.exports` that a compiler marked as an ES module. */
+function isCommonJsEsModule(value) {
+    return (value !== null &&
+        (typeof value === "object" || typeof value === "function") &&
+        value.__esModule === true);
+}

package/dist/op/discover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/op/discover.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG1E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA6GD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6CrF;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2GAA2G;IAC3G,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2C/F"}
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/op/discover.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAI1E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA6GD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6CrF;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2GAA2G;IAC3G,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2C/F"}

package/dist/op/discover.js

@@ -6,6 +6,7 @@ import { hasDiscoveryMarkerSync } from "../discovery/files.js";
 import { resolveDiscoveryGlobs } from "../config.js";
 import { isStewardDeclaration } from "./steward.js";
 import { ensureTypeScriptLoader } from "../ts-loader.js";
+import { esModuleNamespace } from "../module-interop.js";
 async function findGitRoot(cwd) {
     const rt = getRuntime();
     const result = await rt.spawn(["git", "rev-parse", "--show-toplevel"], { cwd });
@@ -132,7 +133,7 @@ export async function discoverOps(opts) {
     for (const filePath of files) {
         try {
             ensureTypeScriptLoader();
-            const mod = (await import(filePath));
+            const mod = esModuleNamespace((await import(filePath)));
             const exported = opsExportedBy(mod);
             // A file may hold a steward and no Op (#2731): the steward sits beside
             // the Ops it runs, and `discoverStewards` reads it from here.
@@ -180,7 +181,7 @@ export async function discoverStewards(opts) {
         let mod;
         try {
             ensureTypeScriptLoader();
-            mod = (await import(filePath));
+            mod = esModuleNamespace((await import(filePath)));
         }
         catch (err) {
             errors.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);

package/dist/op/op-waves-run.d.ts

@@ -561,7 +561,13 @@ export declare function opWaveHooksAtBase(options: {
 }): OpWaveHooksFile;
 /** Whether `policy` lets a wave with these members through without an approval. */
 export declare function opWaveNeedsApproval(policy: OpWaveGatePolicy, members: readonly OpWaveMember[]): boolean;
-/** Plan, decide and apply one wave, or one part of a wide wave. */
+/**
+ * Plan, decide and apply one wave, or one part of a wide wave: the wave
+ * engine's loop (`runWaveLoop`, #3766) over this module's steps. An apply
+ * that comes back `replan` plans the wave again (#3821), at most
+ * {@link OP_WAVE_MAX_REPLANS} times; a `rest` wave goes on through the waves
+ * its plan command found.
+ */
 export declare function runOpWave(options: RunOpWaveOptions): Promise<RunOpWaveResult>;
 /** How many times one wave job plans again when its apply asks to (#3821). */
 export declare const OP_WAVE_MAX_REPLANS = 10;