as-test 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Change Log
 
-## 2026-03-27 - 1.0.3
+## 2026-03-27 - v1.0.4
+
+### Build Command
+
+- fix: make `ast build` exit cleanly instead of hanging after work completes.
+- feat: make `ast build` print per-mode build results and a final summary.
+- feat: make `ast build` support `--parallel`, `--jobs`, and `--build-jobs`.
 
 ### Parallel Execution
 

package/bin/commands/build-core.js

@@ -102,6 +102,13 @@ function getSerialBuildWorkerPool() {
     }
     return serialBuildWorkerPool;
 }
+export async function closeSerialBuildWorkerPool() {
+    if (!serialBuildWorkerPool)
+        return;
+    const pool = serialBuildWorkerPool;
+    serialBuildWorkerPool = null;
+    await pool.close();
+}
 export async function getBuildInvocationPreview(configPath = DEFAULT_CONFIG_PATH, file, modeName, featureToggles = {}, overrides = {}) {
     const loadedConfig = loadConfig(configPath, false);
     const mode = applyMode(loadedConfig, modeName);

package/bin/commands/build.js

@@ -1,9 +1,11 @@
+import { closeSerialBuildWorkerPool, } from "./build-core.js";
 export { build } from "./build-core.js";
 export { formatInvocation, getBuildInvocationPreview } from "./build-core.js";
 export async function executeBuildCommand(rawArgs, configPath, selectedModes, deps) {
     const commandArgs = deps.resolveCommandArgs(rawArgs, "build");
     const listFlags = deps.resolveListFlags(rawArgs, "build");
     const featureToggles = deps.resolveFeatureToggles(rawArgs, "build");
+    const parallel = deps.resolveBuildParallelJobs(rawArgs);
     const buildFeatureToggles = {
         tryAs: featureToggles.tryAs,
         coverage: featureToggles.coverage,
@@ -13,5 +15,18 @@ export async function executeBuildCommand(rawArgs, configPath, selectedModes, de
         await deps.listExecutionPlan("build", configPath, commandArgs, modeTargets, listFlags);
         return;
     }
-    await deps.runBuildModes(configPath, commandArgs, modeTargets, buildFeatureToggles);
+    const previousBuildApi = process.env.AS_TEST_BUILD_API;
+    process.env.AS_TEST_BUILD_API = "1";
+    try {
+        await deps.runBuildModes(configPath, commandArgs, modeTargets, buildFeatureToggles, parallel);
+    }
+    finally {
+        if (previousBuildApi == undefined) {
+            delete process.env.AS_TEST_BUILD_API;
+        }
+        else {
+            process.env.AS_TEST_BUILD_API = previousBuildApi;
+        }
+        await closeSerialBuildWorkerPool();
+    }
 }

package/bin/index.js

@@ -9,7 +9,7 @@ import { executeFuzzCommand } from "./commands/fuzz.js";
 import { executeInitCommand } from "./commands/init.js";
 import { executeDoctorCommand } from "./commands/doctor.js";
 import { fuzz } from "./commands/fuzz-core.js";
-import { applyMode, getCliVersion, loadConfig, resolveModeNames, } from "./util.js";
+import { applyMode, formatTime, getCliVersion, loadConfig, resolveModeNames, } from "./util.js";
 import * as path from "path";
 import { spawnSync } from "child_process";
 import { glob } from "glob";
@@ -50,6 +50,7 @@ else if (COMMANDS.includes(args[0])) {
                 resolveCommandArgs,
                 resolveListFlags,
                 resolveFeatureToggles,
+                resolveBuildParallelJobs,
                 resolveExecutionModes,
                 listExecutionPlan,
                 runBuildModes,
@@ -226,6 +227,9 @@ function printCommandHelp(command) {
         process.stdout.write("  --mode <name[,name...]>  Run one or multiple named config modes\n");
         process.stdout.write("  --enable <feature>       Enable build feature (coverage|try-as)\n");
         process.stdout.write("  --disable <feature>      Disable build feature (coverage|try-as)\n");
+        process.stdout.write("  --parallel              Run files through an ordered worker pool using an automatic worker count\n");
+        process.stdout.write("  --jobs <n>               Run files through an ordered worker pool\n");
+        process.stdout.write("  --build-jobs <n>         Limit concurrent build tasks (defaults to --jobs)\n");
         process.stdout.write("  --list                   Preview resolved files/artifacts without building\n");
         process.stdout.write("  --list-modes             Preview configured and selected mode names\n");
         process.stdout.write("  --help, -h               Show this help\n");
@@ -597,6 +601,29 @@ function resolveJobs(rawArgs, command) {
     }
     return parallel ? 0 : 1;
 }
+function resolveBuildParallelJobs(rawArgs) {
+    const baseJobs = resolveJobs(rawArgs, "build");
+    let buildJobs = baseJobs;
+    let seenCommand = false;
+    for (let i = 0; i < rawArgs.length; i++) {
+        const arg = rawArgs[i];
+        if (!seenCommand) {
+            if (arg == "build")
+                seenCommand = true;
+            continue;
+        }
+        const buildParsed = parseNumberFlag(rawArgs, i, "--build-jobs");
+        if (buildParsed) {
+            if (buildParsed.number < 1) {
+                throw new Error("--build-jobs requires a positive integer");
+            }
+            buildJobs = buildParsed.number;
+            continue;
+        }
+    }
+    const jobs = Math.max(baseJobs, buildJobs);
+    return { jobs, buildJobs };
+}
 function resolveParallelJobs(rawArgs, command) {
     const baseJobs = resolveJobs(rawArgs, command);
     let buildJobs = baseJobs;
@@ -922,10 +949,46 @@ async function runTestSequential(runFlags, configPath, selectors, buildFeatureTo
         },
     };
 }
-async function runBuildModes(configPath, selectors, modes, buildFeatureToggles) {
+async function runBuildModes(configPath, selectors, modes, buildFeatureToggles, parallel) {
+    const files = await resolveSelectedFiles(configPath, selectors);
+    if (!files.length) {
+        throw await buildNoTestFilesMatchedError(configPath, selectors);
+    }
+    const effective = resolveEffectiveParallelJobs({
+        jobs: parallel.jobs,
+        buildJobs: parallel.buildJobs,
+        runJobs: parallel.buildJobs,
+    }, files.length);
+    const resolvedConfigPath = configPath ?? path.join(process.cwd(), "./as-test.config.json");
+    const loadedConfig = loadConfig(resolvedConfigPath, true);
+    const allStartedAt = Date.now();
+    let builtCount = 0;
     for (const modeName of modes) {
-        await build(configPath, selectors, modeName, buildFeatureToggles);
+        const startedAt = Date.now();
+        if (effective.buildJobs > 1) {
+            const pool = new BuildWorkerPool(effective.buildJobs);
+            try {
+                await runOrderedPool(files, effective.buildJobs, async (file) => {
+                    await pool.buildFileMode({
+                        configPath,
+                        file,
+                        modeName,
+                        featureToggles: buildFeatureToggles,
+                    });
+                });
+            }
+            finally {
+                await pool.close();
+            }
+        }
+        else {
+            await build(configPath, selectors, modeName, buildFeatureToggles);
+        }
+        builtCount += files.length;
+        const active = applyMode(loadedConfig, modeName).config;
+        process.stdout.write(`${chalk.bgGreenBright.black(" BUILT ")} ${modeName ?? "default"} ${chalk.dim(`(${active.buildOptions.target})`)} ${files.length} file(s) -> ${active.outDir} ${chalk.dim(formatTime(Date.now() - startedAt))}\n`);
     }
+    process.stdout.write(`${chalk.bold("Summary:")} built ${builtCount} file(s) across ${modes.length || 1} mode(s) in ${formatTime(Date.now() - allStartedAt)}\n`);
 }
 async function runRuntimeModes(runFlags, configPath, selectors, modes) {
     await ensureWebBrowsersReady(configPath, modes, runFlags.browser);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "as-test",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "author": "Jairus Tanaka",
   "repository": {
     "type": "git",