@c9up/helix 0.1.4 → 0.1.5

package/dist/runtime/suite.d.ts

@@ -6,6 +6,7 @@
  * collection to one `runTestFile` call via AsyncLocalStorage, so parallel
  * invocations never share state.
  */
+import { AsyncLocalStorage } from "node:async_hooks";
 export type TestFn = () => void | Promise<void>;
 export type SuiteFn = () => void;
 export type HookType = "beforeAll" | "afterAll" | "beforeEach" | "afterEach";
@@ -30,6 +31,31 @@ export interface SuiteNode {
     children: Array<SuiteNode | TestNode>;
     hooks: Hook[];
 }
+interface CollectionContext {
+    root: SuiteNode;
+    stack: SuiteNode[];
+}
+/**
+ * Collection registry. Holds the `AsyncLocalStorage` scope used per test-file
+ * run plus a fallback root for direct DSL use.
+ *
+ * CRITICAL (H5): this state is pinned to `globalThis`, NOT held as module-local
+ * variables. A consumer's test does `import { describe } from '@c9up/helix'`
+ * while the runner drives collection via `@c9up/helix/runtime/worker`. If those
+ * two specifiers resolve to DISTINCT module instances of this file (src vs dist,
+ * or an ESM/CJS dual instance under the tsx loader), a module-local registry
+ * means the test's `describe`/`test` register into one instance while the worker
+ * opens its collection scope on the other — so the worker collects 0 tests.
+ * A single globalThis-backed registry removes that hazard entirely.
+ */
+interface CollectionRegistry {
+    storage: AsyncLocalStorage<CollectionContext>;
+    fallbackRoot: SuiteNode;
+    fallbackStack: SuiteNode[];
+}
+declare global {
+    var __helixCollectionRegistry: CollectionRegistry | undefined;
+}
 export declare function resetRoot(): SuiteNode;
 export declare function getRoot(): SuiteNode;
 /**

package/dist/runtime/suite.d.ts.map

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

package/dist/runtime/suite.js

@@ -17,28 +17,31 @@ function makeSuite(name, mode, parent) {
         hooks: [],
     };
 }
-/**
- * Scoped collection context. Each `runTestFile` invocation opens its own
- * store so concurrent runs never see each other's registrations.
- */
-const storage = new AsyncLocalStorage();
-/**
- * Fallback context used when the DSL is called outside `runTestFile` (e.g.,
- * unit tests that drive `describe`/`test` directly). `resetRoot` replaces
- * this; `getRoot` returns it.
- */
-let fallbackRoot = makeSuite("", "run", undefined);
-let fallbackStack = [fallbackRoot];
+function registry() {
+    let r = globalThis.__helixCollectionRegistry;
+    if (!r) {
+        const root = makeSuite("", "run", undefined);
+        r = {
+            storage: new AsyncLocalStorage(),
+            fallbackRoot: root,
+            fallbackStack: [root],
+        };
+        globalThis.__helixCollectionRegistry = r;
+    }
+    return r;
+}
 function currentContext() {
-    const scoped = storage.getStore();
+    const r = registry();
+    const scoped = r.storage.getStore();
     if (scoped)
         return scoped;
-    return { root: fallbackRoot, stack: fallbackStack };
+    return { root: r.fallbackRoot, stack: r.fallbackStack };
 }
 export function resetRoot() {
-    fallbackRoot = makeSuite("", "run", undefined);
-    fallbackStack = [fallbackRoot];
-    return fallbackRoot;
+    const r = registry();
+    r.fallbackRoot = makeSuite("", "run", undefined);
+    r.fallbackStack = [r.fallbackRoot];
+    return r.fallbackRoot;
 }
 export function getRoot() {
     return currentContext().root;
@@ -50,7 +53,7 @@ export function getRoot() {
 export async function withCollection(body) {
     const root = makeSuite("", "run", undefined);
     const ctx = { root, stack: [root] };
-    await storage.run(ctx, async () => {
+    await registry().storage.run(ctx, async () => {
         await body();
     });
     return root;

package/dist/runtime/suite.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/helix",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Helix — framework-agnostic test runtime for the Ream ecosystem (Vitest-compatible runner, spies, container overrides, time-travel). Per-package fakes live in each package's /testing.",
   "license": "MIT",
   "type": "module",
@@ -42,8 +42,8 @@
   },
   "files": [
     "bin",
-    "src",
     "dist",
+    "index.*.node",
     "README.md",
     "LICENSE"
   ],

package/src/cli/coverage/aggregate.ts

@@ -1,231 +0,0 @@
-/**
- * Aggregation: merge N raw coverage entries (possibly for the same file
- * from different workers) into a single `CoverageSummary` with per-file
- * and total line / function counts.
- *
- * Range merging strategy mirrors `v8-to-istanbul`:
- *   - Walk ranges OUTERMOST-first so inner ranges OVERWRITE the outer
- *     count for the lines they cover. A `count: 0` inner range carved
- *     out of a `count: 5` outer correctly marks those inner lines as
- *     uncovered, matching V8's block-coverage semantics. The previous
- *     `Math.max` strategy hid uncovered branches behind their outer
- *     function's hit count.
- *   - V8 emits BYTE offsets (UTF-8); we convert via Buffer.byteLength
- *     so non-ASCII source code maps lines correctly.
- *   - When two workers cover the same file:
- *       - if their `source` differs (cache-busting query loaded different
- *         content), we keep the longer source (best-effort) but emit a
- *         warning — offsets are only consistent within one source.
- *       - functions are deduplicated by `(name, startOffset)` so the
- *         lcov FNF count doesn't double.
- */
-
-import type {
-	CoverageSummary,
-	FileSummary,
-	RawFileCoverage,
-	Totals,
-	V8Function,
-} from "./types.js";
-
-/**
- * Build a function `byteOffset → 1-based line number` over `source`.
- * V8 offsets are UTF-8 byte offsets, so we walk the string code-unit by
- * code-unit and accumulate byte length to keep both indices in sync.
- *
- * Returns `[mapper, totalBytes]`. `totalBytes` is needed so callers can
- * detect offsets pointing past EOF (corrupt input) and clamp.
- */
-function buildOffsetToLine(
-	source: string,
-): [(offset: number) => number, number] {
-	const lineStarts: number[] = [0];
-	let byteIndex = 0;
-	for (let i = 0; i < source.length; i += 1) {
-		const code = source.charCodeAt(i);
-		// UTF-16 surrogate pair → encodes a single 4-byte UTF-8 char.
-		if (code >= 0xd800 && code <= 0xdbff && i + 1 < source.length) {
-			const next = source.charCodeAt(i + 1);
-			if (next >= 0xdc00 && next <= 0xdfff) {
-				byteIndex += 4;
-				i += 1;
-				continue;
-			}
-		}
-		// Lone surrogate or BMP char — Buffer.byteLength of one code unit:
-		//   < 0x80   → 1 byte
-		//   < 0x800  → 2 bytes
-		//   else     → 3 bytes (BMP non-surrogate)
-		if (code < 0x80) {
-			byteIndex += 1;
-			if (code === 10 /* \n */) lineStarts.push(byteIndex);
-		} else if (code < 0x800) {
-			byteIndex += 2;
-		} else {
-			byteIndex += 3;
-		}
-	}
-	const totalBytes = byteIndex;
-	const mapper = (offset: number): number => {
-		const clamped = Math.max(0, Math.min(offset, totalBytes));
-		// Binary search for the largest lineStart <= clamped.
-		let lo = 0;
-		let hi = lineStarts.length - 1;
-		while (lo < hi) {
-			const mid = (lo + hi + 1) >>> 1;
-			if (lineStarts[mid] <= clamped) lo = mid;
-			else hi = mid - 1;
-		}
-		return lo + 1;
-	};
-	return [mapper, totalBytes];
-}
-
-function computeFileSummary(entry: RawFileCoverage): FileSummary {
-	const [offsetToLine] = buildOffsetToLine(entry.source);
-	const lineHitsMap = new Map<number, number>();
-	const functionHits: FileSummary["functionHits"] = [];
-	let fnCovered = 0;
-	// Apply ranges across ALL functions in one global pass, sorted by
-	// span DESC. The whole-file pseudo-function (largest span) lands
-	// first; inner functions and their inner ranges overwrite — so a
-	// never-called inner function correctly drops its lines back to
-	// count=0 even though the script itself executed at count=1.
-	const allRanges: Array<{
-		startOffset: number;
-		endOffset: number;
-		count: number;
-	}> = [];
-	for (const fn of entry.functions) {
-		for (const r of fn.ranges) {
-			if (r.endOffset > r.startOffset) allRanges.push(r);
-		}
-	}
-	allRanges.sort((a, b) => {
-		const spanA = a.endOffset - a.startOffset;
-		const spanB = b.endOffset - b.startOffset;
-		if (spanA !== spanB) return spanB - spanA;
-		return a.startOffset - b.startOffset;
-	});
-	for (const r of allRanges) {
-		const startLine = offsetToLine(r.startOffset);
-		const endLine = offsetToLine(r.endOffset - 1);
-		for (let line = startLine; line <= endLine; line += 1) {
-			lineHitsMap.set(line, r.count);
-		}
-	}
-	for (const fn of entry.functions) {
-		const firstRange = fn.ranges[0];
-		// Skip pseudo-functions / synthetic entries with no usable range so
-		// reports don't carry `FN:0,name` (lcov rejects line < 1).
-		if (!firstRange) continue;
-		const fnCount = firstRange.count;
-		const fnLine = offsetToLine(firstRange.startOffset);
-		if (fnCount > 0) fnCovered += 1;
-		functionHits.push({
-			name: fn.functionName || "(anonymous)",
-			line: Math.max(1, fnLine),
-			count: fnCount,
-		});
-	}
-	const lineHits = Array.from(lineHitsMap.entries())
-		.map(([line, count]) => ({ line, count }))
-		.sort((a, b) => a.line - b.line);
-	const linesCovered = lineHits.filter((h) => h.count > 0).length;
-	const linesTotal = lineHits.length;
-	const fnTotal = functionHits.length;
-	return {
-		file: entry.file,
-		lines: { covered: linesCovered, total: linesTotal },
-		// Statements ≈ lines (V8 doesn't expose AST statement boundaries —
-		// matches Vitest's v8 provider).
-		statements: { covered: linesCovered, total: linesTotal },
-		functions: { covered: fnCovered, total: fnTotal },
-		// Branches deferred; report 0/0 so reporters / thresholds can still
-		// format the field consistently.
-		branches: { covered: 0, total: 0 },
-		lineHits,
-		functionHits,
-	};
-}
-
-/**
- * Merge two raw entries for the same file. Functions are deduplicated by
- * `(name, startOffset)` so concatenation doesn't double FNF in lcov.
- * If `source` differs, we keep the longer one (best effort) and emit a
- * stderr advisory — offsets only line up within one source.
- */
-function mergeRaw(a: RawFileCoverage, b: RawFileCoverage): RawFileCoverage {
-	if (a.source && b.source && a.source !== b.source) {
-		process.stderr.write(
-			`helix-coverage: ${a.file} has divergent source content across workers — line attribution may be off\n`,
-		);
-	}
-	const seen = new Set<string>();
-	const merged: V8Function[] = [];
-	for (const fn of [...a.functions, ...b.functions]) {
-		const startOffset = fn.ranges[0]?.startOffset ?? -1;
-		const key = `${fn.functionName}@${startOffset}`;
-		if (seen.has(key)) continue;
-		seen.add(key);
-		merged.push(fn);
-	}
-	return {
-		file: a.file,
-		source: a.source.length >= b.source.length ? a.source : b.source,
-		functions: merged,
-	};
-}
-
-function pct(covered: number, total: number): number {
-	if (total === 0) return 100;
-	return Math.round((covered / total) * 10000) / 100;
-}
-
-export function aggregate(raw: RawFileCoverage[]): CoverageSummary {
-	const byFile = new Map<string, RawFileCoverage>();
-	for (const entry of raw) {
-		// Skip files we couldn't read source for — emitting a 1-line ghost
-		// summary based on collapsed line=1 mapping is worse than omission.
-		if (!entry.source) {
-			process.stderr.write(
-				`helix-coverage: skipping ${entry.file} — source unreadable\n`,
-			);
-			continue;
-		}
-		const prev = byFile.get(entry.file);
-		byFile.set(entry.file, prev ? mergeRaw(prev, entry) : entry);
-	}
-	const files = Array.from(byFile.values())
-		.map(computeFileSummary)
-		// Files that ended up with 0 lines / 0 functions (no V8 data) are
-		// dropped — they distort per-file averages and clutter the table.
-		.filter((f) => f.lines.total > 0 || f.functions.total > 0)
-		.sort((a, b) => a.file.localeCompare(b.file));
-
-	const totals: Totals = {
-		lines: { covered: 0, total: 0, pct: 0 },
-		statements: { covered: 0, total: 0, pct: 0 },
-		functions: { covered: 0, total: 0, pct: 0 },
-		branches: { covered: 0, total: 0, pct: 0 },
-	};
-	for (const f of files) {
-		totals.lines.covered += f.lines.covered;
-		totals.lines.total += f.lines.total;
-		totals.statements.covered += f.statements.covered;
-		totals.statements.total += f.statements.total;
-		totals.functions.covered += f.functions.covered;
-		totals.functions.total += f.functions.total;
-		totals.branches.covered += f.branches.covered;
-		totals.branches.total += f.branches.total;
-	}
-	totals.lines.pct = pct(totals.lines.covered, totals.lines.total);
-	totals.statements.pct = pct(
-		totals.statements.covered,
-		totals.statements.total,
-	);
-	totals.functions.pct = pct(totals.functions.covered, totals.functions.total);
-	totals.branches.pct = pct(totals.branches.covered, totals.branches.total);
-
-	return { files, total: totals };
-}

package/src/cli/coverage/collect.ts

@@ -1,63 +0,0 @@
-/**
- * Reads every `coverage-*.json` produced by the V8 profiler in a given
- * directory, decodes `file://` URLs, and returns a normalised list of
- * `RawFileCoverage` entries (one per unique script URL).
- *
- * Workers write coverage via `NODE_V8_COVERAGE=<dir>` — the orchestrator
- * sets this env var on every spawn and reads the directory after all
- * workers exit. Multiple workers may record the same file; we return ALL
- * entries here and let `aggregate.ts` merge.
- */
-
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { RawFileCoverage, V8CoverageFile } from "./types.js";
-
-export async function collect(dir: string): Promise<RawFileCoverage[]> {
-	let entries: string[];
-	try {
-		entries = await readdir(dir);
-	} catch {
-		return [];
-	}
-	const jsonFiles = entries.filter((e) => e.endsWith(".json"));
-	const all: RawFileCoverage[] = [];
-	for (const name of jsonFiles) {
-		const p = path.join(dir, name);
-		let parsed: V8CoverageFile;
-		try {
-			const raw = await readFile(p, "utf8");
-			parsed = JSON.parse(raw) as V8CoverageFile;
-		} catch {
-			continue;
-		}
-		for (const script of parsed.result ?? []) {
-			if (!script.url?.startsWith("file://")) continue;
-			// V8 sometimes appends `?query` params (our worker uses them as
-			// cache-busters) — strip them so the same file from two workers
-			// merges correctly.
-			const cleanUrl = script.url.split("?")[0];
-			let file: string;
-			try {
-				file = fileURLToPath(cleanUrl);
-			} catch {
-				continue;
-			}
-			let source = "";
-			try {
-				source = await readFile(file, "utf8");
-			} catch {
-				// Source read may fail for transient temp files or modules that
-				// have been GC'd — leave empty; downstream stages fall back to
-				// offset-only computation.
-			}
-			all.push({
-				file,
-				source,
-				functions: script.functions ?? [],
-			});
-		}
-	}
-	return all;
-}

package/src/cli/coverage/diff/base.ts

@@ -1,46 +0,0 @@
-/**
- * Resolve the default base ref to diff against. Tries, in order:
- *   1. `origin/main`
- *   2. `origin/master`
- *   3. local `main`
- *   4. local `master`
- *
- * Returns `undefined` if none of those exist (so the caller can warn
- * instead of failing the run). Throws when the `git` binary itself is
- * missing — the caller distinguishes "no repo / no ref" (skip
- * gracefully) from "git not installed" (configuration error).
- */
-
-import { spawnSync } from "node:child_process";
-
-const CANDIDATES = ["origin/main", "origin/master", "main", "master"];
-
-export class GitMissingError extends Error {
-	constructor() {
-		super("git binary not found on PATH");
-		this.name = "GitMissingError";
-	}
-}
-
-function runGit(cwd: string, args: string[]): { ok: boolean } {
-	const result = spawnSync("git", args, {
-		cwd,
-		stdio: ["ignore", "pipe", "pipe"],
-	});
-	const err = result.error as NodeJS.ErrnoException | undefined;
-	if (err?.code === "ENOENT") throw new GitMissingError();
-	return { ok: result.status === 0 };
-}
-
-function refExists(cwd: string, ref: string): boolean {
-	return runGit(cwd, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`])
-		.ok;
-}
-
-export function resolveBaseRef(cwd: string): string | undefined {
-	if (!runGit(cwd, ["rev-parse", "--git-dir"]).ok) return undefined;
-	for (const cand of CANDIDATES) {
-		if (refExists(cwd, cand)) return cand;
-	}
-	return undefined;
-}

package/src/cli/coverage/diff/index.ts

@@ -1,160 +0,0 @@
-/**
- * Diff-coverage facade — wires base resolution → git diff → parser →
- * overlay → reporters → thresholds. Called by `run.ts` after the
- * full-tree finalise.
- */
-
-import { mkdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { enforce } from "../thresholds.js";
-import type {
-	CoverageSummary,
-	Thresholds,
-	ThresholdViolation,
-} from "../types.js";
-import { GitMissingError, resolveBaseRef } from "./base.js";
-import { overlay } from "./overlay.js";
-import { parseDiff } from "./parse.js";
-import { diffJson, diffTextSummary } from "./reporters.js";
-import type { DiffOptions, DiffSummary } from "./types.js";
-
-export type { DiffOptions, DiffSummary } from "./types.js";
-
-export interface DiffFinaliseInput extends DiffOptions {
-	root: string;
-	coverage: CoverageSummary;
-}
-
-export interface DiffFinaliseResult {
-	summary: DiffSummary;
-	violations: ThresholdViolation[];
-	textReport: string;
-	reportFiles: string[];
-	/** When `undefined`, the diff stage was skipped (not in a repo, no
-	 *  base ref, etc.) — callers should print `warning` and move on. */
-	warning?: string;
-}
-
-/**
- * Wrap the diff totals into a `CoverageSummary`-shaped object so we can
- * reuse the full-tree `enforce()` helper. Only `lines`/`statements` are
- * populated; `functions`/`branches` are unsupported in diff mode and are
- * rejected upfront in `validateDiffThresholds`.
- */
-function toCoverageSummary(diff: DiffSummary): CoverageSummary {
-	return {
-		files: [],
-		total: {
-			lines: {
-				covered: diff.total.covered,
-				total: diff.total.added,
-				pct: diff.total.pct,
-			},
-			statements: {
-				covered: diff.total.covered,
-				total: diff.total.added,
-				pct: diff.total.pct,
-			},
-			functions: { covered: 0, total: 0, pct: 100 },
-			branches: { covered: 0, total: 0, pct: 100 },
-		},
-	};
-}
-
-function violationLine(
-	metric: keyof Thresholds,
-	actual: number,
-	threshold: number,
-): string {
-	return `coverage-diff: ${metric} ${actual.toFixed(1)} < threshold ${threshold}`;
-}
-
-/**
- * Reject `functions`/`branches` thresholds in diff mode — we only track
- * line-level diff coverage today, so silently passing those metrics
- * would let users gate on metrics that always read 100%.
- */
-function validateDiffThresholds(t: Thresholds | undefined): void {
-	if (!t) return;
-	const unsupported: string[] = [];
-	if (typeof t.functions === "number" && t.functions > 0)
-		unsupported.push("functions");
-	if (typeof t.branches === "number" && t.branches > 0)
-		unsupported.push("branches");
-	if (unsupported.length > 0) {
-		throw new Error(
-			`diff-cov thresholds: ${unsupported.join(", ")} are not supported (line-only). Drop those keys.`,
-		);
-	}
-}
-
-export async function finaliseDiff(
-	input: DiffFinaliseInput,
-): Promise<DiffFinaliseResult> {
-	validateDiffThresholds(input.thresholds);
-
-	const cwd = input.cwd ?? input.root;
-	let base: string | undefined;
-	try {
-		base = input.base ?? resolveBaseRef(cwd);
-	} catch (err) {
-		if (err instanceof GitMissingError) {
-			return {
-				summary: { files: [], total: { added: 0, covered: 0, pct: 100 } },
-				violations: [],
-				textReport: "",
-				reportFiles: [],
-				warning: "diff-cov: git binary not found on PATH. Skipping.",
-			};
-		}
-		throw err;
-	}
-	if (!base) {
-		return {
-			summary: { files: [], total: { added: 0, covered: 0, pct: 100 } },
-			violations: [],
-			textReport: "",
-			reportFiles: [],
-			warning:
-				"diff-cov: no git base ref resolved (origin/main, main, master). Skipping.",
-		};
-	}
-
-	let diffMap: ReturnType<typeof parseDiff>;
-	try {
-		diffMap = parseDiff({ cwd, base });
-	} catch (err) {
-		return {
-			summary: { files: [], total: { added: 0, covered: 0, pct: 100 } },
-			violations: [],
-			textReport: "",
-			reportFiles: [],
-			warning: `diff-cov: ${err instanceof Error ? err.message : String(err)}`,
-		};
-	}
-
-	const summary = overlay(input.coverage, diffMap);
-
-	const reportFiles: string[] = [];
-	const outputDir = input.outputDir ?? path.join(input.root, "coverage");
-	await mkdir(outputDir, { recursive: true });
-	const file = path.join(outputDir, "coverage-diff.json");
-	await writeFile(file, diffJson(summary, input.root), "utf8");
-	reportFiles.push(file);
-
-	const textReport = diffTextSummary(summary, input.root);
-
-	let violations: ThresholdViolation[] = [];
-	if (input.thresholds) {
-		violations = enforce(toCoverageSummary(summary), input.thresholds);
-	}
-
-	return { summary, violations, textReport, reportFiles };
-}
-
-/** Reformat threshold violations with the `coverage-diff:` prefix. */
-export function diffViolationSummary(violations: ThresholdViolation[]): string {
-	return violations
-		.map((v) => violationLine(v.metric, v.actual, v.threshold))
-		.join("\n");
-}