@c9up/helix 0.1.8 → 0.1.10

package/dist/runtime/asymmetric-brand.js

@@ -0,0 +1,18 @@
+/**
+ * The brand that marks an asymmetric matcher, and the guard that reads it.
+ *
+ * Its own module because both `asymmetric.ts` (which creates matchers) and
+ * `equals.ts` (which must recognise them) need it, and `asymmetric.ts` imports
+ * `equals.ts` — so neither can own it without a cycle. It used to be spelled as
+ * a literal on both sides: a rule written twice, where changing one side would
+ * silently stop `expect.any()` from being recognised and turn every matcher
+ * into a plain structural comparison.
+ */
+export const ASYMMETRIC_BRAND = "__helixAsymmetricMatcher";
+export function isAsymmetricMatcher(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    return (Reflect.get(value, ASYMMETRIC_BRAND) === true &&
+        typeof Reflect.get(value, "asymmetricMatch") === "function");
+}
+//# sourceMappingURL=asymmetric-brand.js.map

package/dist/runtime/asymmetric-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asymmetric-brand.js","sourceRoot":"","sources":["../../src/runtime/asymmetric-brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAU3D,MAAM,UAAU,mBAAmB,CAClC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,CACN,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,IAAI;QAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,UAAU,CAC3D,CAAC;AACH,CAAC"}

package/dist/runtime/asymmetric.d.ts

@@ -7,15 +7,8 @@
  * delegate to `asymmetricMatch` instead of doing structural comparison, so an
  * asymmetric matcher can appear anywhere inside an expected value.
  */
-declare const BRAND = "__helixAsymmetricMatcher";
-export interface AsymmetricMatcher {
-    readonly [BRAND]: true;
-    /** Return `true` when `actual` satisfies this matcher. */
-    asymmetricMatch(actual: unknown): boolean;
-    /** Human-readable label used in failure diagnostics. */
-    toString(): string;
-}
-export declare function isAsymmetricMatcher(value: unknown): value is AsymmetricMatcher;
+import { type AsymmetricMatcher, isAsymmetricMatcher } from "./asymmetric-brand.js";
+export { type AsymmetricMatcher, isAsymmetricMatcher };
 /** `expect.anything()` — matches any value except `null`/`undefined`. */
 export declare function anything(): AsymmetricMatcher;
 /** Constructor accepted by `expect.any(...)`, including primitive wrappers. */
@@ -30,5 +23,4 @@ export declare function stringMatching(pattern: string | RegExp): AsymmetricMatc
 export declare function objectContaining(subset: Record<string, unknown>): AsymmetricMatcher;
 /** `expect.arrayContaining(items)` — every item must appear in `actual`. */
 export declare function arrayContaining(items: readonly unknown[]): AsymmetricMatcher;
-export {};
 //# sourceMappingURL=asymmetric.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"asymmetric.d.ts","sourceRoot":"","sources":["../../src/runtime/asymmetric.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,QAAA,MAAM,KAAK,6BAA6B,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACvB,0DAA0D;IAC1D,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,IAAI,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,iBAAiB,CAO5B;AASD,yEAAyE;AACzE,wBAAgB,QAAQ,IAAI,iBAAiB,CAK5C;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAE5D,0EAA0E;AAC1E,wBAAgB,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAkBxD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAK/D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAO1E;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,iBAAiB,CAInB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,iBAAiB,CAK5E"}
+{"version":3,"file":"asymmetric.d.ts","sourceRoot":"","sources":["../../src/runtime/asymmetric.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEN,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,KAAK,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;AAWvD,yEAAyE;AACzE,wBAAgB,QAAQ,IAAI,iBAAiB,CAK5C;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAE5D,0EAA0E;AAC1E,wBAAgB,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAkBxD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAK/D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAO1E;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,iBAAiB,CAInB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,iBAAiB,CAK5E"}

package/dist/runtime/asymmetric.js

@@ -7,14 +7,10 @@
  * delegate to `asymmetricMatch` instead of doing structural comparison, so an
  * asymmetric matcher can appear anywhere inside an expected value.
  */
+import { ASYMMETRIC_BRAND, isAsymmetricMatcher, } from "./asymmetric-brand.js";
 import { equals, partialEquals } from "./equals.js";
-const BRAND = "__helixAsymmetricMatcher";
-export function isAsymmetricMatcher(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        value[BRAND] === true &&
-        typeof value.asymmetricMatch === "function");
-}
+export { isAsymmetricMatcher };
+const BRAND = ASYMMETRIC_BRAND;
 function make(label, match) {
     return { [BRAND]: true, asymmetricMatch: match, toString: () => label };
 }

package/dist/runtime/asymmetric.js.map

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

package/dist/runtime/bootstrap.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `tests/bootstrap.ts` — the AdonisJS bootstrap module.
+ *
+ * Adonis puts the run's plugins, runner hooks and suite hooks in one file that
+ * `bin/test.ts` imports before anything else:
+ *
+ *     // tests/bootstrap.ts
+ *     export const plugins = [assert(), apiClient()]
+ *     export const runnerHooks = { setup: [() => …], teardown: [() => …] }
+ *     export const configureSuite = (suite) => {
+ *       if (["functional", "e2e"].includes(suite.name)) {
+ *         return suite.setup(() => testUtils.httpServer().start())
+ *       }
+ *     }
+ *
+ * helix loads the same file with the same three exports — plus `filters` and
+ * `importer`, the two Japa `Config` fields Adonis sets in `bin/test.ts`, which
+ * helix has no equivalent of — so an Adonis `tests/bootstrap.ts` ports over
+ * unchanged. The CLI resolves it once and
+ * forwards the absolute path as `HELIX_BOOTSTRAP`, so it reaches the worker
+ * through BOTH orchestrators (the Rust engine and the TS pool spawn children
+ * that inherit the CLI's env).
+ *
+ * `runnerHooks` run ONCE for the whole run, in the process that spawns the
+ * workers — Japa's semantics. See `global-hooks.ts`. Everything else here is
+ * per worker because it has to be: a context macro, a filter, an importer only
+ * mean anything in the process that loads the test file.
+ */
+/** File names probed under the project root when none is configured. */
+export declare const BOOTSTRAP_FILENAMES: string[];
+/**
+ * Resolve the bootstrap file for `root`: an explicit path (from
+ * `helix.config`), else the conventional `tests/bootstrap.*`. Returns
+ * `undefined` when the project has none — having no bootstrap is the norm, not
+ * an error.
+ */
+export declare function resolveBootstrap(root: string, configured?: string): string | undefined;
+/**
+ * Import the bootstrap module named by `HELIX_BOOTSTRAP` and hand its exports
+ * to {@link configure}. A no-op when the variable is unset — which is what
+ * every project without a bootstrap file, and every direct `runTestFile`
+ * caller, sees.
+ */
+export declare function loadBootstrap(suite: string): Promise<void>;
+/** Test seam: forget that a bootstrap was loaded in this process. */
+export declare function resetBootstrap(): void;
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAeH,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,UAI/B,CAAC;AAuEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAYpB;AAKD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE;AAgCD,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/runtime/bootstrap.js

@@ -0,0 +1,166 @@
+/**
+ * `tests/bootstrap.ts` — the AdonisJS bootstrap module.
+ *
+ * Adonis puts the run's plugins, runner hooks and suite hooks in one file that
+ * `bin/test.ts` imports before anything else:
+ *
+ *     // tests/bootstrap.ts
+ *     export const plugins = [assert(), apiClient()]
+ *     export const runnerHooks = { setup: [() => …], teardown: [() => …] }
+ *     export const configureSuite = (suite) => {
+ *       if (["functional", "e2e"].includes(suite.name)) {
+ *         return suite.setup(() => testUtils.httpServer().start())
+ *       }
+ *     }
+ *
+ * helix loads the same file with the same three exports — plus `filters` and
+ * `importer`, the two Japa `Config` fields Adonis sets in `bin/test.ts`, which
+ * helix has no equivalent of — so an Adonis `tests/bootstrap.ts` ports over
+ * unchanged. The CLI resolves it once and
+ * forwards the absolute path as `HELIX_BOOTSTRAP`, so it reaches the worker
+ * through BOTH orchestrators (the Rust engine and the TS pool spawn children
+ * that inherit the CLI's env).
+ *
+ * `runnerHooks` run ONCE for the whole run, in the process that spawns the
+ * workers — Japa's semantics. See `global-hooks.ts`. Everything else here is
+ * per worker because it has to be: a context macro, a filter, an importer only
+ * mean anything in the process that loads the test file.
+ */
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { configure, } from "./configure.js";
+import { globalHooksHandledByParent } from "./global-hooks.js";
+import { applySuiteConfigure } from "./suite-config.js";
+import { resetTaps } from "./suite-taps.js";
+/** File names probed under the project root when none is configured. */
+export const BOOTSTRAP_FILENAMES = [
+    "tests/bootstrap.ts",
+    "tests/bootstrap.js",
+    "tests/bootstrap.mjs",
+];
+/** `filters` as exported — every field optional, so read each defensively. */
+function readFilters(imported) {
+    const source = Reflect.get(Object(imported), "filters");
+    if (source === null || typeof source !== "object")
+        return undefined;
+    const matchAll = Reflect.get(source, "matchAll");
+    return {
+        tags: stringList(source, "tags"),
+        groups: stringList(source, "groups"),
+        tests: stringList(source, "tests"),
+        matchAll: typeof matchAll === "boolean" ? matchAll : undefined,
+    };
+}
+function stringList(source, key) {
+    const value = Reflect.get(source, key);
+    if (!Array.isArray(value))
+        return undefined;
+    return value.filter((v) => typeof v === "string");
+}
+/** Everything about the module is optional — read defensively, never cast. */
+function readModule(imported) {
+    if (imported === null || typeof imported !== "object")
+        return {};
+    const plugins = Reflect.get(imported, "plugins");
+    const hooks = Reflect.get(imported, "runnerHooks");
+    const configureSuite = Reflect.get(imported, "configureSuite");
+    const importer = Reflect.get(imported, "importer");
+    return {
+        filters: readFilters(imported),
+        importer: typeof importer === "function"
+            ? (file) => importer(file)
+            : undefined,
+        plugins: Array.isArray(plugins)
+            ? plugins.filter((p) => typeof p === "function")
+            : undefined,
+        runnerHooks: hooks !== null && typeof hooks === "object"
+            ? {
+                setup: hookList(hooks, "setup"),
+                teardown: hookList(hooks, "teardown"),
+            }
+            : undefined,
+        configureSuite: typeof configureSuite === "function"
+            ? (suite) => configureSuite(suite)
+            : undefined,
+    };
+}
+function hookList(source, key) {
+    const value = Reflect.get(source, key);
+    if (!Array.isArray(value))
+        return undefined;
+    return value.filter((fn) => typeof fn === "function");
+}
+/**
+ * Resolve the bootstrap file for `root`: an explicit path (from
+ * `helix.config`), else the conventional `tests/bootstrap.*`. Returns
+ * `undefined` when the project has none — having no bootstrap is the norm, not
+ * an error.
+ */
+export function resolveBootstrap(root, configured) {
+    if (configured !== undefined && configured !== "") {
+        const absolute = path.isAbsolute(configured)
+            ? configured
+            : path.resolve(root, configured);
+        return existsSync(absolute) ? absolute : undefined;
+    }
+    for (const name of BOOTSTRAP_FILENAMES) {
+        const candidate = path.resolve(root, name);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/** Memoised so a worker that runs several files bootstraps exactly once. */
+let loaded;
+/**
+ * Import the bootstrap module named by `HELIX_BOOTSTRAP` and hand its exports
+ * to {@link configure}. A no-op when the variable is unset — which is what
+ * every project without a bootstrap file, and every direct `runTestFile`
+ * caller, sees.
+ */
+export async function loadBootstrap(suite) {
+    const file = process.env.HELIX_BOOTSTRAP;
+    const hasSuiteConfig = (process.env.HELIX_SUITE_CONFIG ?? "") !== "";
+    // The suite's own `configure` is applied here too, so it reaches the same
+    // hook arrays before `configure()` drains them. That means this runs even
+    // with no bootstrap file — a project may declare one without the other.
+    if ((file === undefined || file === "") && !hasSuiteConfig)
+        return;
+    loaded ??= applyBootstrap(file ?? "", suite);
+    return loaded;
+}
+async function applyBootstrap(file, suite) {
+    const module = file === "" ? {} : readModule(await import(pathToFileURL(file).href));
+    // `runnerHooks` belong to the run, not to this file. When the parent ran
+    // them — which it does whenever a bootstrap exists — the worker must not run
+    // them again: that is the difference between migrating once and migrating
+    // once per test file.
+    const parentRanThem = globalHooksHandledByParent();
+    const setup = parentRanThem ? [] : [...(module.runnerHooks?.setup ?? [])];
+    const teardown = parentRanThem
+        ? []
+        : [...(module.runnerHooks?.teardown ?? [])];
+    // `configureSuite` is handed to `configure()` rather than called here, so it
+    // runs where Japa runs it: after the plugins, which is what lets a plugin
+    // read it or replace it. The per-suite callback chains onto it — both get
+    // the same handle, so hooks either registers reach the arrays below.
+    await configure({
+        plugins: module.plugins,
+        filters: module.filters,
+        importer: module.importer,
+        configureSuite: async (handle) => {
+            module.configureSuite?.(handle);
+            await applySuiteConfigure(suite, handle);
+        },
+        setup,
+        teardown,
+        suite,
+    });
+}
+/** Test seam: forget that a bootstrap was loaded in this process. */
+export function resetBootstrap() {
+    loaded = undefined;
+    resetTaps();
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/runtime/bootstrap.js.map

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

package/dist/runtime/cli-args.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The run's command-line arguments, as seen from inside a worker.
+ *
+ * `bin/helix.js` parses the flags in the CLI process and forwards them to every
+ * worker through the environment (`HELIX_TAGS`, `HELIX_TESTS`, …), because a
+ * worker is spawned by either orchestrator (Node pool or the Rust engine) with
+ * a fixed instruction shape. Reading them back here is what lets both the
+ * runtime and a plugin (`api.cliArgs`, Japa parity) see the same filters.
+ *
+ * One named deviation from Japa's `CLIArgs`: values are parsed (`string[]`,
+ * `number`, `boolean`) rather than kept as raw CLI strings. They have been
+ * through the parser once already, on the CLI side, and handing a plugin
+ * `"500"` to re-parse would be worse — Japa's own raw form exists because its
+ * CLI hands the config manager unparsed argv, which helix's does not.
+ */
+/** Parsed CLI flags for the current run. */
+export interface CLIArgs {
+    /** Positionals — the paths or suite names typed on the command line. */
+    _?: string[];
+    /** `--list-pinned` — collect and print the pinned tests, run nothing. */
+    listPinned?: boolean;
+    /** `--tags` — `~@tag`/`!@tag` entries exclude. */
+    tags?: string[];
+    /** `--tests` — exact test titles. */
+    tests?: string[];
+    /** `--groups` — exact group titles. */
+    groups?: string[];
+    /** `--match-all` — require every `--tags` entry instead of any. */
+    matchAll?: boolean;
+    /** `--timeout`, in ms. */
+    timeout?: number;
+    /** `--retries` — extra attempts on failure. */
+    retries?: number;
+    /** `--grep` — helix extra: regex/substring over the full test name. */
+    grep?: string;
+    /** `--suite` — the suite name these files belong to. */
+    suite?: string;
+    /** `--files` — substrings matched against the test file path (Japa `--files`). */
+    files?: string[];
+    /** `--reporters` — the reporters activated for this run. */
+    reporters?: string[];
+    /** `--bail` — stop at the first failure. */
+    bail?: boolean;
+    /** `--bail-layer` — how far a bail reaches. */
+    bailLayer?: string;
+    /** `--failed` — this run replays the previous run's failures. */
+    failed?: boolean;
+    /** `--force-exit` — the CLI will `process.exit()` once the run ends. */
+    forceExit?: boolean;
+    /**
+     * `--help`. Always absent in a worker: the CLI prints its help and exits
+     * before spawning anything, so nothing here could ever have seen it. Declared
+     * for the same reason Japa declares it — a plugin reading `cliArgs.help`
+     * should get `undefined`, not a type error.
+     */
+    help?: boolean;
+    /**
+     * Japa's open record. A host that forwards its own `HELIX_*` variable, or a
+     * plugin that stashes something for another, has somewhere to put it without
+     * the type standing in the way.
+     */
+    [flag: string]: string | string[] | number | boolean | undefined;
+}
+/** Comma-separated env list → trimmed non-empty entries, or undefined. */
+export declare function envList(name: string): string[] | undefined;
+/** A non-negative integer env var, or undefined when unset/invalid. */
+export declare function envCount(name: string): number | undefined;
+/** `--tags` as forwarded by the CLI. */
+export declare function envTags(): string[] | undefined;
+/** `--match-all` as forwarded by the CLI. */
+export declare function envMatchAll(): boolean | undefined;
+export declare function cliArgs(): CLIArgs;
+/** Test seam: rebuild from the environment on the next access. */
+export declare function resetCLIArgs(): void;
+/** Every CLI flag the current worker can see, read fresh from the environment. */
+export declare function readCLIArgs(): CLIArgs;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/runtime/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../src/runtime/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACvB,wEAAwE;IACxE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACjE;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAQ1D;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKzD;AAED,wCAAwC;AACxC,wBAAgB,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAE9C;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,IAAI,OAAO,GAAG,SAAS,CAEjD;AAiBD,wBAAgB,OAAO,IAAI,OAAO,CAGjC;AAED,kEAAkE;AAClE,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,kFAAkF;AAClF,wBAAgB,WAAW,IAAI,OAAO,CAmBrC"}

package/dist/runtime/cli-args.js

@@ -0,0 +1,85 @@
+/**
+ * The run's command-line arguments, as seen from inside a worker.
+ *
+ * `bin/helix.js` parses the flags in the CLI process and forwards them to every
+ * worker through the environment (`HELIX_TAGS`, `HELIX_TESTS`, …), because a
+ * worker is spawned by either orchestrator (Node pool or the Rust engine) with
+ * a fixed instruction shape. Reading them back here is what lets both the
+ * runtime and a plugin (`api.cliArgs`, Japa parity) see the same filters.
+ *
+ * One named deviation from Japa's `CLIArgs`: values are parsed (`string[]`,
+ * `number`, `boolean`) rather than kept as raw CLI strings. They have been
+ * through the parser once already, on the CLI side, and handing a plugin
+ * `"500"` to re-parse would be worse — Japa's own raw form exists because its
+ * CLI hands the config manager unparsed argv, which helix's does not.
+ */
+/** Comma-separated env list → trimmed non-empty entries, or undefined. */
+export function envList(name) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === "")
+        return undefined;
+    const items = raw
+        .split(",")
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+    return items.length > 0 ? items : undefined;
+}
+/** A non-negative integer env var, or undefined when unset/invalid. */
+export function envCount(name) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === "")
+        return undefined;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n >= 0 ? n : undefined;
+}
+/** `--tags` as forwarded by the CLI. */
+export function envTags() {
+    return envList("HELIX_TAGS");
+}
+/** `--match-all` as forwarded by the CLI. */
+export function envMatchAll() {
+    return process.env.HELIX_MATCH_ALL === "1" ? true : undefined;
+}
+/** A boolean flag as forwarded by the CLI — absent stays `undefined`, as in Japa. */
+function envFlag(name) {
+    return process.env[name] === "1" ? true : undefined;
+}
+/**
+ * The run's flags, as ONE object.
+ *
+ * Japa hands its plugins a `cliArgs` they may edit — that is a documented way
+ * to steer a run from a plugin. Rebuilding it from the environment on every
+ * access would silently drop those edits, so it is built once and every reader
+ * (the plugin API, and the runtime's own filter resolution) shares it.
+ */
+let materialised;
+export function cliArgs() {
+    materialised ??= readCLIArgs();
+    return materialised;
+}
+/** Test seam: rebuild from the environment on the next access. */
+export function resetCLIArgs() {
+    materialised = undefined;
+}
+/** Every CLI flag the current worker can see, read fresh from the environment. */
+export function readCLIArgs() {
+    return {
+        tags: envTags(),
+        tests: envList("HELIX_TESTS"),
+        groups: envList("HELIX_GROUPS"),
+        matchAll: envMatchAll(),
+        timeout: envCount("HELIX_TIMEOUT"),
+        retries: envCount("HELIX_RETRIES"),
+        grep: process.env.HELIX_GREP,
+        suite: process.env.HELIX_SUITE,
+        files: envList("HELIX_FILES"),
+        reporters: envList("HELIX_REPORTERS"),
+        bail: envFlag("HELIX_BAIL"),
+        bailLayer: process.env.HELIX_BAIL_LAYER,
+        failed: envFlag("HELIX_FAILED"),
+        forceExit: envFlag("HELIX_FORCE_EXIT"),
+        listPinned: envFlag("HELIX_LIST_PINNED"),
+        _: envList("HELIX_POSITIONALS"),
+    };
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/runtime/cli-args.js.map

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

package/dist/runtime/cli-worker.js

@@ -23,9 +23,8 @@
  */
 import { writeSync } from "node:fs";
 import { createInterface } from "node:readline";
+import { FRAME_PREFIX, PRE_HANDSHAKE_NONCE } from "./ipc-protocol.js";
 import { runTestFile } from "./worker.js";
-const FRAME_PREFIX = "__HELIX_RESULT__";
-const PRE_HANDSHAKE_NONCE = "__helix_pre_handshake__";
 async function emit(msg) {
     const line = `${FRAME_PREFIX}${JSON.stringify(msg)}\n`;
     await new Promise((resolve, reject) => {

package/dist/runtime/cli-worker.js.map

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