@glubean/cli 0.7.0 → 0.8.0

package/dist/commands/load.d.ts

@@ -0,0 +1,54 @@
+import type { LoadArtifact } from "@glubean/sdk/load";
+/** A filesystem-safe result filename for a runner id. */
+export declare function loadResultFileName(runnerId: string): string;
+/** One plan's run outcome. */
+export interface LoadRunOutcome {
+    file: string;
+    runnerId: string;
+    artifact: LoadArtifact;
+}
+/** A per-file failure (e.g. an unimportable load file). */
+export interface LoadFileError {
+    file: string;
+    message: string;
+}
+/** Result of running a set of load files — completed outcomes + per-file errors. */
+export interface RunLoadFilesResult {
+    outcomes: LoadRunOutcome[];
+    errors: LoadFileError[];
+}
+/**
+ * Run each load file's plans in a CHILD PROCESS (`runLoadFileInSubprocess`) so the
+ * harness and the user file co-resolve one `@glubean/sdk`, and collect the
+ * artifacts. A single file's import failure (or a crash) is recorded as a per-file
+ * error and the rest still run — completed artifacts are never discarded because a
+ * LATER file is broken. The raw `{ vars, secrets }` flow to the child, which
+ * applies the process.env fallback. Free of fs writes / process exit / printing.
+ */
+export declare function runLoadFiles(files: string[], opts: {
+    vars: Record<string, string>;
+    secrets: Record<string, string>;
+    /** Project root the child runs in — drives runner resolution + bare imports. */
+    cwd: string;
+}): Promise<RunLoadFilesResult>;
+/** Write each outcome's artifact to `<glubeanDir>/<runnerId>.load.result.json`,
+ *  disambiguating ids that sanitize to the same filename so no artifact is lost. */
+export declare function writeLoadResults(outcomes: LoadRunOutcome[], glubeanDir: string): Promise<string[]>;
+/** Print a one-plan summary line block. The top `iterations` line is the
+ *  end-to-end (whole-transaction) view; when a scenario calls
+ *  `ctx.report.primaryComplete()` the artifact also carries a primary/end-to-end
+ *  phase split, surfaced as an extra line so an async-job run shows submit latency
+ *  vs full latency. (Exported for display tests.) */
+export declare function printOutcome(o: LoadRunOutcome): void;
+/** Options for the `load` command. */
+export interface LoadCommandOptions {
+    /** Env file basename (default: the active env, else `.env`). */
+    envFile?: string;
+}
+/**
+ * `glubean load [target]` — discover + run load plans under `target` (a file,
+ * directory, or glob; defaults to the cwd), write results, and exit non-zero if
+ * any plan fails.
+ */
+export declare function loadCommand(target: string | undefined, options?: LoadCommandOptions): Promise<void>;
+//# sourceMappingURL=load.d.ts.map

package/dist/commands/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/commands/load.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA0BtD,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;CACb,GACA,OAAO,CAAC,kBAAkB,CAAC,CAa7B;AAED;oFACoF;AACpF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AA2CD;;;;qDAIqD;AACrD,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAkFpD;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/dist/commands/load.js

@@ -0,0 +1,270 @@
+/**
+ * `glubean load [target]` — run performance plans (M4-c).
+ *
+ * Discovers `loadRunner()` exports in `.load.ts` files, runs each through the
+ * closed-model orchestrator (`@glubean/runner` `runLoad`) IN A CHILD PROCESS,
+ * writes each finalized `LoadArtifact` to `.glubean/<runnerId>.load.result.json`,
+ * prints a per-plan summary, and exits non-zero if any plan's `summary.pass` is
+ * false (a crash or a breached threshold). This is the dedicated load path —
+ * separate from `glubean run` (the per-test ProjectRunner), since load's
+ * execution model differs.
+ *
+ * Each `.load.ts` runs via `runLoadFileInSubprocess`, which spawns the
+ * project-local runner harness (as `glubean run` does) so the harness and the
+ * user file co-resolve one `@glubean/sdk` — no split-brain when a globally
+ * installed CLI runs against a project with its own non-deduped sdk.
+ */
+import { resolve, dirname } from "node:path";
+import { stat, readdir, writeFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { glob } from "node:fs/promises";
+import { loadProjectEnv, runLoadFileInSubprocess } from "@glubean/runner";
+import { resolveEnvFileName } from "../lib/active_env.js";
+import { findProjectConfig } from "./run.js";
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    cyan: "\x1b[36m",
+};
+// Mirror the run command's skip list (+ .glubean output) so a compiled `build/`
+// dir isn't walked — otherwise a built `.load.js` could double-run a plan.
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", ".glubean"]);
+// Directory/glob discovery matches SOURCE `.load.ts` only (like `glubean run`'s
+// `.ts`-only discovery), so a compiled `.load.js`/`.mjs` alongside it isn't run
+// twice. An explicit file target still runs whatever the user named.
+function isLoadSourceFile(name) {
+    return name.endsWith(".load.ts");
+}
+/** A filesystem-safe result filename for a runner id. */
+export function loadResultFileName(runnerId) {
+    const safe = runnerId.replace(/[^a-zA-Z0-9._-]/g, "_").replace(/^_+|_+$/g, "");
+    return `${safe || "load"}.load.result.json`;
+}
+/**
+ * Run each load file's plans in a CHILD PROCESS (`runLoadFileInSubprocess`) so the
+ * harness and the user file co-resolve one `@glubean/sdk`, and collect the
+ * artifacts. A single file's import failure (or a crash) is recorded as a per-file
+ * error and the rest still run — completed artifacts are never discarded because a
+ * LATER file is broken. The raw `{ vars, secrets }` flow to the child, which
+ * applies the process.env fallback. Free of fs writes / process exit / printing.
+ */
+export async function runLoadFiles(files, opts) {
+    const outcomes = [];
+    const errors = [];
+    for (const file of files) {
+        const res = await runLoadFileInSubprocess(file, {
+            vars: opts.vars,
+            secrets: opts.secrets,
+            cwd: opts.cwd,
+        });
+        for (const o of res.outcomes)
+            outcomes.push({ file, runnerId: o.runnerId, artifact: o.artifact });
+        for (const e of res.errors)
+            errors.push({ file, message: e.message });
+    }
+    return { outcomes, errors };
+}
+/** Write each outcome's artifact to `<glubeanDir>/<runnerId>.load.result.json`,
+ *  disambiguating ids that sanitize to the same filename so no artifact is lost. */
+export async function writeLoadResults(outcomes, glubeanDir) {
+    await mkdir(glubeanDir, { recursive: true });
+    // Track collisions case-INSENSITIVELY: on macOS/Windows, "Checkout" and
+    // "checkout" are the same directory entry, so an exact-string check would let
+    // the second overwrite the first.
+    const used = new Set();
+    const written = [];
+    for (const o of outcomes) {
+        let name = loadResultFileName(o.runnerId);
+        if (used.has(name.toLowerCase())) {
+            // Ids collapsed to the same filename — append `-N` so both survive.
+            const base = name.replace(/\.load\.result\.json$/, "");
+            let n = 2;
+            while (used.has(`${base}-${n}.load.result.json`.toLowerCase()))
+                n += 1;
+            name = `${base}-${n}.load.result.json`;
+        }
+        used.add(name.toLowerCase());
+        const path = resolve(glubeanDir, name);
+        await writeFile(path, JSON.stringify(o.artifact, null, 2), "utf-8");
+        written.push(path);
+    }
+    return written;
+}
+/** Recursively collect `.load.ts` files under a directory. */
+async function walkLoadFiles(dir, out) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name))
+                await walkLoadFiles(resolve(dir, entry.name), out);
+        }
+        else if (entry.isFile() && isLoadSourceFile(entry.name)) {
+            out.push(resolve(dir, entry.name));
+        }
+    }
+}
+/** Resolve a file / directory / glob target to a sorted, deduped `.load.ts` list. */
+async function resolveLoadFiles(target) {
+    const abs = resolve(target);
+    try {
+        const s = await stat(abs);
+        if (s.isFile())
+            return [abs];
+        if (s.isDirectory()) {
+            const files = [];
+            await walkLoadFiles(abs, files);
+            files.sort();
+            return files;
+        }
+    }
+    catch {
+        // not a path — try glob below
+    }
+    const files = [];
+    for await (const entry of glob(target, { cwd: process.cwd() })) {
+        const full = resolve(process.cwd(), entry);
+        if (!isLoadSourceFile(full))
+            continue;
+        const s = await stat(full).catch(() => null);
+        if (s?.isFile())
+            files.push(full);
+    }
+    files.sort();
+    return [...new Set(files)];
+}
+function pct(fraction) {
+    return `${(fraction * 100).toFixed(2)}%`;
+}
+/** Print a one-plan summary line block. The top `iterations` line is the
+ *  end-to-end (whole-transaction) view; when a scenario calls
+ *  `ctx.report.primaryComplete()` the artifact also carries a primary/end-to-end
+ *  phase split, surfaced as an extra line so an async-job run shows submit latency
+ *  vs full latency. (Exported for display tests.) */
+export function printOutcome(o) {
+    const s = o.artifact.summary;
+    const verdict = s.pass
+        ? `${colors.green}PASS${colors.reset}`
+        : `${colors.red}FAIL${colors.reset}`;
+    console.log(`${colors.bold}${o.runnerId}${colors.reset}  ${verdict}`);
+    console.log(`${colors.dim}  iterations ${s.totalIterations} (ok ${s.successfulIterations}, failed ${s.failedIterations})` +
+        `  errorRate ${pct(s.errorRate)}  p95 ${Math.round(s.latency.p95)}ms` +
+        `  throughput ${s.throughputPerSec.toFixed(1)}/s${colors.reset}`);
+    // Phase split (M5): the line above is end-to-end; show the primary phase (up to
+    // the primaryComplete boundary). `completed/started` indicates primary coverage —
+    // when fewer iterations complete primary than started, some failed before the
+    // boundary (a branch/error path); precise boundary coverage lands with M6.
+    if (s.primary) {
+        console.log(`${colors.dim}  primary (to boundary)  p95 ${Math.round(s.primary.latency.p95)}ms` +
+            `  throughput ${s.primary.throughputPerSec.toFixed(1)}/s` +
+            `  completed ${s.primary.completed}/${s.primary.started}${colors.reset}`);
+        if (s.primary.completed < s.primary.started) {
+            console.log(`${colors.yellow}  ⚠ ${s.primary.started - s.primary.completed} iteration(s) did not reach the primary boundary` +
+                ` (failed before it, or a branch skipped it)${colors.reset}`);
+        }
+    }
+    // Continuation / producer-release subsystem (M6): present once any iteration engaged
+    // release (released / rejected / duplicate / still pending). Show the slot model, how
+    // many slots were released, the backlog peak + back-pressure, then surface rejections,
+    // drain-timeout aborts, and coverage gaps as warnings.
+    const c = s.continuation;
+    if (c) {
+        console.log(`${colors.dim}  continuation (${o.artifact.runtime.slotModel})  released ${c.releasedProducerSlots}` +
+            `  backlog max ${c.maxBacklog}` +
+            (c.backpressureMs ? `  backpressure p95 ${Math.round(c.backpressureMs.p95)}ms` : "") +
+            `${colors.reset}`);
+        if (c.rejectedReleaseSignals > 0) {
+            console.log(`${colors.yellow}  ⚠ ${c.rejectedReleaseSignals} release(s) rejected (backlog full, drain bound, or run deadline)${colors.reset}`);
+        }
+        if (c.abortedByDrainTimeout > 0) {
+            console.log(`${colors.yellow}  ⚠ ${c.abortedByDrainTimeout} continuation(s) aborted by the drain timeout` +
+                ` (still in flight at finalize)${colors.reset}`);
+        }
+        if (c.duplicateReleaseSignals > 0) {
+            console.log(`${colors.yellow}  ⚠ ${c.duplicateReleaseSignals} duplicate release signal(s)` +
+                ` (one producer-release boundary per iteration)${colors.reset}`);
+        }
+        // Coverage gaps: only SOME iterations reached a primary boundary (a branch/error path
+        // skipped it), so the producer-release stats above reflect just that subset — warn,
+        // since `releaseCoverage` alone can read 100% while boundary coverage is partial.
+        if (c.primaryBoundaryCoverage < 1) {
+            console.log(`${colors.yellow}  ⚠ only ${pct(c.primaryBoundaryCoverage)} of iterations reached a primary boundary` +
+                ` — producer-release stats cover that subset${colors.reset}`);
+        }
+        if (c.releaseCoverage < 1) {
+            console.log(`${colors.dim}  release coverage ${pct(c.releaseCoverage)} of primary boundaries${colors.reset}`);
+        }
+    }
+    for (const t of s.thresholds) {
+        const mark = t.pass ? `${colors.green}✓${colors.reset}` : `${colors.red}✗${colors.reset}`;
+        const where = t.target ? `${t.scope}[${t.target}]` : t.scope;
+        console.log(`${colors.dim}  ${mark} ${where}.${t.metric} ${t.expression} (actual ${t.actual})${colors.reset}`);
+    }
+    // Non-fatal run-shape advisories (M6-d), e.g. a long tail poll that held the producer
+    // slot with no release.
+    for (const a of s.advisories ?? []) {
+        console.log(`${colors.yellow}  ⓘ ${a}${colors.reset}`);
+    }
+}
+/**
+ * `glubean load [target]` — discover + run load plans under `target` (a file,
+ * directory, or glob; defaults to the cwd), write results, and exit non-zero if
+ * any plan fails.
+ */
+export async function loadCommand(target, options = {}) {
+    console.log(`\n${colors.bold}${colors.blue}⚡ Glubean Load${colors.reset}\n`);
+    const files = await resolveLoadFiles(target ?? process.cwd());
+    if (files.length === 0) {
+        console.log(`${colors.yellow}No .load.ts files found${target ? ` for "${target}"` : ` in ${process.cwd()}`}.${colors.reset}`);
+        process.exit(1);
+    }
+    // Derive the project root from the discovered file (not the shell cwd) so a
+    // targeted run outside cwd uses the load file's project for runner resolution /
+    // env / `.glubean` output.
+    const { rootDir } = await findProjectConfig(dirname(files[0]));
+    // An EXPLICIT --env-file that's missing is an error (mirrors `glubean run`) —
+    // silently running with empty env could send load to the wrong target / run
+    // without credentials. Validate the env file up front so a missing one fails
+    // fast. A resolved default/active env file may be absent.
+    const userSpecifiedEnvFile = options.envFile !== undefined;
+    const envFileName = userSpecifiedEnvFile ? options.envFile : await resolveEnvFileName(rootDir);
+    if (userSpecifiedEnvFile && !existsSync(resolve(rootDir, envFileName))) {
+        console.log(`${colors.red}Error: env file '${envFileName}' not found in ${rootDir}${colors.reset}`);
+        process.exit(1);
+    }
+    // Plugin bootstrap happens INSIDE each subprocess (the harness registers
+    // matchers / protocol adapters before importing the load file), so the CLI no
+    // longer bootstraps here.
+    const { vars, secrets } = await loadProjectEnv(rootDir, envFileName);
+    // A single file's import failure (or crash) is collected (not thrown) so
+    // earlier/later files still produce + persist results. Pass the raw resolved
+    // env — the child re-applies the process.env fallback (a Proxy can't cross the
+    // process boundary), so shell/CI-supplied vars/secrets still resolve.
+    const { outcomes, errors } = await runLoadFiles(files, { vars, secrets, cwd: rootDir });
+    // Persist every completed artifact FIRST — a later broken file must not discard
+    // an expensive successful plan's result.
+    const written = await writeLoadResults(outcomes, resolve(rootDir, ".glubean"));
+    console.log();
+    let anyFail = false;
+    for (const o of outcomes) {
+        printOutcome(o);
+        if (!o.artifact.summary.pass)
+            anyFail = true;
+    }
+    for (const e of errors) {
+        console.log(`${colors.red}✗ ${e.message}${colors.reset}`);
+    }
+    if (written.length > 0) {
+        console.log(`\n${colors.dim}Wrote ${written.length} result file(s) to .glubean/${colors.reset}`);
+    }
+    if (outcomes.length === 0 && errors.length === 0) {
+        console.log(`${colors.yellow}No loadRunner() exports found in ${files.length} file(s).${colors.reset}`);
+    }
+    // Fail if any plan failed, any file errored, or nothing ran at all.
+    if (anyFail || errors.length > 0 || outcomes.length === 0)
+        process.exit(1);
+}
+//# sourceMappingURL=load.js.map

package/dist/commands/load.js.map

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

package/dist/commands/run.d.ts

@@ -1,3 +1,4 @@
+import type { GlubeanFileKind } from "@glubean/scanner";
 interface RunOptions {
     filter?: string;
     pick?: string;
@@ -108,6 +109,10 @@ interface RunOptions {
      */
     thresholds?: import("@glubean/sdk").ThresholdConfig;
 }
+export declare function findProjectConfig(startDir: string): Promise<{
+    rootDir: string;
+    configPath?: string;
+}>;
 /**
  * Map a file path to its Glubean kind by extension.
  * - `.test.ts` → "test"
@@ -120,7 +125,7 @@ interface RunOptions {
  * Returns undefined for non-Glubean files. The suite.kinds filter in
  * resolveTestFiles uses this to keep only files whose kind matches.
  */
-export type GlubeanFileKind = "test" | "contract" | "flow" | "bootstrap";
+export type { GlubeanFileKind };
 export declare function classifyGlubeanFile(filePath: string): GlubeanFileKind | undefined;
 /**
  * Per-suite resolution helper exposed for main.ts. Resolves a suite's
@@ -174,6 +179,7 @@ export declare function discoverTests(filePath: string): Promise<DiscoveredTest[
 export declare const __testing: {
     matchesTags: (testItem: DiscoveredTest, tags: string[], mode?: "or" | "and" | undefined) => boolean;
     matchesExcludeTags: (testItem: DiscoveredTest, excludeTags: string[]) => boolean;
+    isGlubeanTestFile: (name: string) => boolean;
 };
 declare function matchesTags(testItem: DiscoveredTest, tags: string[], mode?: "or" | "and"): boolean;
 /**
@@ -183,5 +189,4 @@ declare function matchesTags(testItem: DiscoveredTest, tags: string[], mode?: "o
  */
 declare function matchesExcludeTags(testItem: DiscoveredTest, excludeTags: string[]): boolean;
 export declare function runCommand(target: string | string[], options?: RunOptions): Promise<void>;
-export {};
 //# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

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

package/dist/commands/run.js

@@ -9,7 +9,7 @@ import { shouldSkipTest } from "../lib/skip.js";
 import { CLI_VERSION } from "../version.js";
 import { redactMetadataForUpload } from "../lib/redact-metadata.js";
 import { extractContractCases, extractFromSource } from "@glubean/scanner/static";
-import { extractContractFromFile, findTemplateMatch, loadProjectOverlays, matchesTemplateFilter, } from "@glubean/scanner";
+import { buildSuffixes, classifyByStem, extractContractFromFile, findTemplateMatch, GLUBEAN_KINDS, loadProjectOverlays, matchesTemplateFilter, } from "@glubean/scanner";
 import { applyEnvTemplating } from "@glubean/runner";
 // ANSI color codes for pretty output
 const colors = {
@@ -28,7 +28,7 @@ const CLOUD_MEMORY_LIMITS = {
     pro: 700,
 };
 const MEMORY_WARNING_THRESHOLD_MB = CLOUD_MEMORY_LIMITS.free * 0.67;
-async function findProjectConfig(startDir) {
+export async function findProjectConfig(startDir) {
     let dir = startDir;
     while (dir !== "/") {
         try {
@@ -77,13 +77,12 @@ function isGlob(target) {
 // calls execute and register overlays before discovery runs (attachment-
 // model §7.4). `discoverTests()` is responsible for distinguishing
 // bootstrap-only files from runnable-emitting ones.
-const TEST_FILE_SUFFIXES = [
-    ".test.ts",
-    ".contract.ts",
-    ".workflow.ts",
-    ".flow.ts",
-    ".bootstrap.ts",
-];
+// CLI target resolution for `glubean run` recognizes only `.ts` files across the
+// test-runner kinds (including bootstrap), derived from the canonical kind
+// registry (scanner/kinds.ts). `load` is EXCLUDED here: load plans run through
+// the dedicated `glubean load` command + the closed-model orchestrator, not the
+// per-test ProjectRunner, so `glubean run ./dir` must not sweep in `.load.ts`.
+const TEST_FILE_SUFFIXES = GLUBEAN_KINDS.filter((k) => k.kind !== "load").flatMap((k) => buildSuffixes(k.stems, [".ts"]));
 function isGlubeanTestFile(name) {
     return TEST_FILE_SUFFIXES.some((suffix) => name.endsWith(suffix));
 }
@@ -93,17 +92,9 @@ function isGlubeanTestFile(name) {
 // the static test path — a `.workflow.` substring would mis-route it into
 // contract extraction (which ignores `test()` exports), silently dropping its
 // tests (codex 0.6 P2).
-const RUNTIME_ARTIFACT_SUFFIXES = [
-    ".contract.ts",
-    ".contract.js",
-    ".contract.mjs",
-    ".workflow.ts",
-    ".workflow.js",
-    ".workflow.mjs",
-    ".flow.ts",
-    ".flow.js",
-    ".flow.mjs",
-];
+// Contract/workflow/flow artifact files (NOT bootstrap), all extensions —
+// derived from the canonical kind registry (scanner/kinds.ts).
+const RUNTIME_ARTIFACT_SUFFIXES = GLUBEAN_KINDS.filter((k) => k.runtimeArtifact && k.kind !== "bootstrap").flatMap((k) => buildSuffixes(k.stems));
 function isRuntimeExtractableArtifact(name) {
     return RUNTIME_ARTIFACT_SUFFIXES.some((suffix) => name.endsWith(suffix));
 }
@@ -125,15 +116,8 @@ async function walkTestFiles(dir, result) {
     }
 }
 export function classifyGlubeanFile(filePath) {
-    if (filePath.endsWith(".test.ts"))
-        return "test";
-    if (filePath.endsWith(".contract.ts"))
-        return "contract";
-    if (filePath.endsWith(".workflow.ts") || filePath.endsWith(".flow.ts"))
-        return "flow";
-    if (filePath.endsWith(".bootstrap.ts"))
-        return "bootstrap";
-    return undefined;
+    // `.ts`-only classification, by stem, from the canonical kind registry.
+    return classifyByStem(filePath, [".ts"]);
 }
 async function resolveSingleTarget(target) {
     const abs = resolve(target);
@@ -450,6 +434,7 @@ function matchesFilter(testItem, filter) {
 export const __testing = {
     matchesTags: (...args) => matchesTags(...args),
     matchesExcludeTags: (...args) => matchesExcludeTags(...args),
+    isGlubeanTestFile: (name) => isGlubeanTestFile(name),
 };
 function matchesTags(testItem, tags, mode = "or") {
     if (!testItem.meta.tags?.length)