@dev-pi2pie/word-counter 0.1.4-canary.1 → 0.1.4

package/README.md

@@ -151,8 +151,10 @@ word-counter --path ./examples/test-case-multi-files-support --jobs 4
 Quick policy:
 
 - no `--jobs` and `--jobs 1` are equivalent baseline behavior.
-- `--jobs > 1` enables concurrent `load+count`.
+- `--jobs 1`: async main-thread `load+count` baseline.
+- `--jobs > 1`: worker `load+count` with async fallback when workers are unavailable.
 - if requested `--jobs` exceeds host `suggestedMaxJobs` (from `--print-jobs-limit`), the CLI warns and runs with the suggested limit as a safety cap.
+- use `--quiet-warnings` to suppress non-fatal warning lines (for example jobs-limit advisory and worker-fallback warning).
 
 Inspect host jobs diagnostics:
 
@@ -160,6 +162,8 @@ Inspect host jobs diagnostics:
 word-counter --print-jobs-limit
 ```
 
+`--print-jobs-limit` must be used alone (no other inputs or runtime flags).
+
 For full policy details, JSON parity expectations (`--misc`, `--total-of whitespace,words`), and benchmark standards, see [`docs/batch-jobs-usage-guide.md`](docs/batch-jobs-usage-guide.md).
 
 ### Stable Path Resolution Contract
@@ -220,6 +224,8 @@ For additional usage details and troubleshooting, see [`docs/regex-usage-guide.m
 
 ### Debugging Diagnostics (`--debug`)
 
+Noise policy: default output shows errors + warnings; `--debug` enables diagnostics; `--verbose` enables per-item diagnostics; `--quiet-warnings` suppresses warnings.
+
 `--debug` remains the diagnostics gate and now defaults to `compact` event volume:
 
 - lifecycle/stage timing events
@@ -252,7 +258,7 @@ word-counter --path ./examples/test-case-multi-files-support --debug --debug-rep
 word-counter --path ./examples/test-case-multi-files-support --debug --debug-report ./logs/debug.jsonl --debug-tee
 ```
 
-Skip details stay debug-gated and can still be suppressed with `--quiet-skips`.
+Skip details stay debug-gated and can be suppressed with `--quiet-skips`.
 
 ## How It Works
 
@@ -491,8 +497,9 @@ Example (trimmed):
   "frontmatterType": "yaml",
   "total": 7,
   "items": [
-    { "name": "content", "source": "frontmatter", "result": { "total": 3 } },
-    { "name": "content", "source": "content", "result": { "total": 4 } }
+    { "name": "content", "source": "frontmatter", "result": { "total": 4 } },
+    { "name": "content", "source": "frontmatter", "result": { "total": 2 } },
+    { "name": "content", "source": "content", "result": { "total": 5 } }
   ]
 }
 ```
@@ -585,7 +592,7 @@ word-counter --include-whitespace "Hi\tthere\n"
 word-counter --misc "Hi\tthere\n"
 ```
 
-In the CLI, `--include-whitespace` implies with `--non-words` (same behavior as `--misc`). `--non-words` alone does not include whitespace. When enabled, whitespace counts appear under `nonWords.whitespace`, and `total = words + nonWords` (emoji + symbols + punctuation + whitespace). JSON output also includes top-level `counts` when `nonWords` is enabled. See `docs/schemas/whitespace-categories.md` for how whitespace is categorized.
+In the CLI, `--include-whitespace` implies `--non-words` (same behavior as `--misc`). `--non-words` alone does not include whitespace. When enabled, whitespace counts appear under `nonWords.whitespace`, and `total = words + nonWords` (emoji + symbols + punctuation + whitespace). JSON output also includes top-level `counts` when `nonWords` is enabled. See `docs/schemas/whitespace-categories.md` for how whitespace is categorized.
 
 Example JSON (trimmed):
 

package/dist/esm/bin.mjs

@@ -5,8 +5,8 @@ import { closeSync, createWriteStream, existsSync, mkdirSync, openSync, readFile
 import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import os from "node:os";
-import { readFile, readdir, stat } from "node:fs/promises";
 import { parseDocument } from "yaml";
+import { readFile, readdir, stat } from "node:fs/promises";
 
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -353,7 +353,7 @@ function parseJobsOption(value) {
 	return parsed;
 }
 function configureProgramOptions(program, parseMode) {
-	program.addOption(new Option("-m, --mode <mode>", "breakdown mode").choices(MODE_CHOICES).argParser(parseMode).default("chunk")).addOption(new Option("-f, --format <format>", "output format").choices(FORMAT_CHOICES).default("standard")).addOption(new Option("--section <section>", "document section mode").choices(SECTION_CHOICES).default("all")).addOption(new Option("--path-mode <mode>", "path resolution mode: auto (default) expands directories; manual treats --path values as literal files").choices(PATH_MODE_CHOICES).default("auto")).option("--latin-language <language>", "hint a language tag for Latin script text").option("--latin-tag <tag>", "hint a BCP 47 tag for Latin script text").option("--latin-locale <locale>", "legacy alias of --latin-language").option("--latin-hint <tag>=<pattern>", "add a custom Latin hint rule (repeatable)", collectLatinHintValue, []).option("--latin-hints-file <path>", "load custom Latin hint rules from a JSON file").option("--no-default-latin-hints", "disable built-in Latin hint rules").option("--han-language <language>", "hint a language tag for Han script text").option("--han-tag <tag>", "hint a BCP 47 tag for Han script text").option("--non-words", "collect emoji, symbols, and punctuation (excludes whitespace)").option("--include-whitespace", "include whitespace counts (implies with --non-words; same as --misc)").option("--misc", "collect non-words plus whitespace (alias for --include-whitespace)").option("--total-of <parts>", "override total composition (comma-separated): words,emoji,symbols,punctuation,whitespace", parseTotalOfOption).option("--pretty", "pretty print JSON output", false).option("--debug", "enable debug diagnostics on stderr").option("--verbose", "emit verbose per-file debug diagnostics (requires --debug)").option("--debug-report [path]", "write debug diagnostics to a report file").option("--debug-report-tee", "mirror debug diagnostics to both report file and stderr").option("--debug-tee", "alias of --debug-report-tee").option("--merged", "show merged aggregate output (default)").option("--per-file", "show per-file output plus merged summary").option("--jobs <n>", "concurrent file jobs in batch mode (default: 1; >1 enables worker load+count)", parseJobsOption, 1).option("--print-jobs-limit", "print suggested max --jobs for current host and exit").option("--no-progress", "disable batch progress indicator").option("--keep-progress", "keep final batch progress line visible in standard mode").option("--no-recursive", "disable recursive directory traversal").option("--quiet-skips", "hide skip diagnostics (applies when --debug is enabled)").option("--include-ext <exts>", "comma-separated extensions to include during directory scanning", collectExtensionOption, []).option("--exclude-ext <exts>", "comma-separated extensions to exclude during directory scanning", collectExtensionOption, []).option("--regex <pattern>", "regex filter for directory-scanned paths (applies to --path directories only)").option("-p, --path <path>", "read input from file or directory (directories expand in auto mode by default)", collectPathValue, []).argument("[text...]", "text to count").showHelpAfterError();
+	program.addOption(new Option("-m, --mode <mode>", "breakdown mode").choices(MODE_CHOICES).argParser(parseMode).default("chunk")).addOption(new Option("-f, --format <format>", "output format").choices(FORMAT_CHOICES).default("standard")).addOption(new Option("--section <section>", "document section mode").choices(SECTION_CHOICES).default("all")).addOption(new Option("--path-mode <mode>", "path resolution mode: auto (default) expands directories; manual treats --path values as literal files").choices(PATH_MODE_CHOICES).default("auto")).option("--latin-language <language>", "hint a language tag for Latin script text").option("--latin-tag <tag>", "hint a BCP 47 tag for Latin script text").option("--latin-locale <locale>", "legacy alias of --latin-language").option("--latin-hint <tag>=<pattern>", "add a custom Latin hint rule (repeatable)", collectLatinHintValue, []).option("--latin-hints-file <path>", "load custom Latin hint rules from a JSON file").option("--no-default-latin-hints", "disable built-in Latin hint rules").option("--han-language <language>", "hint a language tag for Han script text").option("--han-tag <tag>", "hint a BCP 47 tag for Han script text").option("--non-words", "collect emoji, symbols, and punctuation (excludes whitespace)").option("--include-whitespace", "include whitespace counts (implies --non-words; same as --misc)").option("--misc", "collect non-words plus whitespace (alias for --include-whitespace)").option("--total-of <parts>", "override total composition (comma-separated): words,emoji,symbols,punctuation,whitespace", parseTotalOfOption).option("--pretty", "pretty print JSON output", false).option("--debug", "enable debug diagnostics on stderr").option("--verbose", "emit verbose per-file debug diagnostics (requires --debug)").option("--debug-report [path]", "write debug diagnostics to a report file").option("--debug-report-tee", "mirror debug diagnostics to both report file and stderr").option("--debug-tee", "alias of --debug-report-tee").option("--merged", "show merged aggregate output (default)").option("--per-file", "show per-file output plus merged summary").option("--jobs <n>", "batch jobs in --path mode (1=async main-thread, >1=worker load+count)", parseJobsOption, 1).option("--print-jobs-limit", "print host jobs-limit JSON and exit (must be used alone)").option("--no-progress", "disable batch progress indicator").option("--keep-progress", "keep final batch progress line visible in standard mode").option("--no-recursive", "disable recursive directory traversal").option("--quiet-warnings", "suppress non-fatal warning diagnostics").option("--quiet-skips", "suppress debug skip output and per-file json skipped field").option("--include-ext <exts>", "comma-separated extensions to include during directory scanning", collectExtensionOption, []).option("--exclude-ext <exts>", "comma-separated extensions to exclude during directory scanning", collectExtensionOption, []).option("--regex <pattern>", "regex filter for directory-scanned paths (applies to --path directories only)").option("-p, --path <path>", "read input from file or directory (directories expand in auto mode by default)", collectPathValue, []).argument("[text...]", "text to count").showHelpAfterError();
 }
 
 //#endregion
@@ -428,7 +428,7 @@ var require_picocolors = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region src/cli/program/version-embedded.ts
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
-const EMBEDDED_PACKAGE_VERSION = "0.1.4-canary.1";
+const EMBEDDED_PACKAGE_VERSION = "0.1.4";
 
 //#endregion
 //#region src/cli/program/version.ts
@@ -1958,26 +1958,6 @@ function compactCollectorSegmentsInCountResult(result) {
 	}
 	stripCollectorSegmentsFromWordCounterResult(result);
 }
-async function buildBatchSummary(inputs, section, wcOptions, options = {}) {
-	const preserveCollectorSegments = options.preserveCollectorSegments ?? true;
-	const files = [];
-	for (const input of inputs) {
-		const result = section === "all" ? wc_default(input.content, wcOptions) : countSections(input.content, section, wcOptions);
-		if (!preserveCollectorSegments) compactCollectorSegmentsInCountResult(result);
-		files.push({
-			path: input.path,
-			result
-		});
-		options.onFileCounted?.({
-			completed: files.length,
-			total: inputs.length
-		});
-	}
-	return finalizeBatchSummaryFromFileResults(files, section, wcOptions, {
-		onFinalizeStart: options.onFinalizeStart,
-		preserveCollectorSegments: options.preserveCollectorSegments
-	});
-}
 function finalizeBatchSummaryFromFileResults(files, section, wcOptions, options = {}) {
 	const preserveCollectorSegments = options.preserveCollectorSegments ?? true;
 	if (!preserveCollectorSegments) for (const file of files) compactCollectorSegmentsInCountResult(file.result);
@@ -1999,6 +1979,26 @@ function finalizeBatchSummaryFromFileResults(files, section, wcOptions, options
 	};
 }
 
+//#endregion
+//#region src/cli/batch/jobs/queue.ts
+async function runBoundedQueue(total, requestedJobs, worker) {
+	if (total === 0) return [];
+	const safeRequestedJobs = Number.isFinite(requestedJobs) ? Math.floor(requestedJobs) : 1;
+	const concurrency = Math.max(1, Math.min(total, safeRequestedJobs));
+	const results = new Array(total);
+	let nextIndex = 0;
+	const runWorker = async () => {
+		while (true) {
+			const current = nextIndex;
+			nextIndex += 1;
+			if (current >= total) return;
+			results[current] = await worker(current);
+		}
+	};
+	await Promise.all(Array.from({ length: concurrency }, () => runWorker()));
+	return results;
+}
+
 //#endregion
 //#region src/cli/path/load.ts
 function isProbablyBinary(buffer) {
@@ -2017,67 +2017,48 @@ function isProbablyBinary(buffer) {
 }
 
 //#endregion
-//#region src/cli/batch/jobs/queue.ts
-async function runBoundedQueue(total, requestedJobs, worker) {
-	if (total === 0) return [];
-	const safeRequestedJobs = Number.isFinite(requestedJobs) ? Math.floor(requestedJobs) : 1;
-	const concurrency = Math.max(1, Math.min(total, safeRequestedJobs));
-	const results = new Array(total);
-	let nextIndex = 0;
-	const runWorker = async () => {
-		while (true) {
-			const current = nextIndex;
-			nextIndex += 1;
-			if (current >= total) return;
-			results[current] = await worker(current);
-		}
+//#region src/cli/batch/jobs/read-input.ts
+async function readBatchInput(path, options) {
+	if (!path) return {
+		type: "skip",
+		path: "",
+		reason: "not readable: missing path"
+	};
+	let buffer;
+	try {
+		buffer = await readFile(path);
+	} catch (error) {
+		if (isResourceLimitError(error)) throw createResourceLimitError(path, error, options.requestedJobs, options.limits);
+		return {
+			type: "skip",
+			path,
+			reason: `not readable: ${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+	if (isProbablyBinary(buffer)) return {
+		type: "skip",
+		path,
+		reason: "binary file"
+	};
+	return {
+		type: "file",
+		path,
+		content: buffer.toString("utf8")
 	};
-	await Promise.all(Array.from({ length: concurrency }, () => runWorker()));
-	return results;
 }
 
 //#endregion
-//#region src/cli/batch/jobs/load-count-experimental.ts
+//#region src/cli/batch/jobs/load-count.ts
 async function countBatchInputsWithJobs(filePaths, options) {
 	const limits = resolveBatchJobsLimit();
 	const total = filePaths.length;
 	let completed = 0;
 	const entries = await runBoundedQueue(filePaths.length, options.jobs, async (index) => {
-		const path = filePaths[index];
-		if (!path) {
-			completed += 1;
-			options.onFileProcessed?.({
-				completed,
-				total
-			});
-			return {
-				type: "skip",
-				skip: {
-					path: "",
-					reason: "not readable: missing path"
-				}
-			};
-		}
-		let buffer;
-		try {
-			buffer = await readFile(path);
-		} catch (error) {
-			if (isResourceLimitError(error)) throw createResourceLimitError(path, error, options.jobs, limits);
-			const message = error instanceof Error ? error.message : String(error);
-			completed += 1;
-			options.onFileProcessed?.({
-				completed,
-				total
-			});
-			return {
-				type: "skip",
-				skip: {
-					path,
-					reason: `not readable: ${message}`
-				}
-			};
-		}
-		if (isProbablyBinary(buffer)) {
+		const loaded = await readBatchInput(filePaths[index], {
+			requestedJobs: options.jobs,
+			limits
+		});
+		if (loaded.type === "skip") {
 			completed += 1;
 			options.onFileProcessed?.({
 				completed,
@@ -2086,13 +2067,12 @@ async function countBatchInputsWithJobs(filePaths, options) {
 			return {
 				type: "skip",
 				skip: {
-					path,
-					reason: "binary file"
+					path: loaded.path,
+					reason: loaded.reason
 				}
 			};
 		}
-		const content = buffer.toString("utf8");
-		const result = options.section === "all" ? wc_default(content, options.wcOptions) : countSections(content, options.section, options.wcOptions);
+		const result = options.section === "all" ? wc_default(loaded.content, options.wcOptions) : countSections(loaded.content, options.section, options.wcOptions);
 		if (!options.preserveCollectorSegments) compactCollectorSegmentsInCountResult(result);
 		completed += 1;
 		options.onFileProcessed?.({
@@ -2102,7 +2082,7 @@ async function countBatchInputsWithJobs(filePaths, options) {
 		return {
 			type: "file",
 			file: {
-				path,
+				path: loaded.path,
 				result
 			}
 		};
@@ -2123,7 +2103,7 @@ async function countBatchInputsWithJobs(filePaths, options) {
 }
 
 //#endregion
-//#region src/cli/batch/jobs/load-count-worker-experimental.ts
+//#region src/cli/batch/jobs/load-count-worker.ts
 var WorkerRouteUnavailableError = class extends Error {};
 function isFallbackFriendlyWorkerError(error) {
 	if (typeof error !== "object" || error === null) return false;
@@ -2133,7 +2113,7 @@ function isFallbackFriendlyWorkerError(error) {
 	return message.includes("Unknown file extension") || message.includes("Cannot find module");
 }
 async function countBatchInputsWithWorkerJobs(filePaths, options) {
-	if (process.env.WORD_COUNTER_DISABLE_EXPERIMENTAL_WORKERS === "1") throw new WorkerRouteUnavailableError("Worker route disabled by environment.");
+	if (process.env.WORD_COUNTER_DISABLE_WORKER_JOBS === "1" || process.env.WORD_COUNTER_DISABLE_EXPERIMENTAL_WORKERS === "1") throw new WorkerRouteUnavailableError("Worker route disabled by environment.");
 	let workerPoolModule;
 	try {
 		workerPoolModule = await import("./worker-pool.mjs");
@@ -2162,60 +2142,6 @@ async function countBatchInputsWithWorkerJobs(filePaths, options) {
 	}
 }
 
-//#endregion
-//#region src/cli/batch/jobs/load-only.ts
-async function loadBatchInputsWithJobs(filePaths, options) {
-	const limits = resolveBatchJobsLimit();
-	const entries = await runBoundedQueue(filePaths.length, options.jobs, async (index) => {
-		const path = filePaths[index];
-		if (!path) return {
-			type: "skip",
-			path: "",
-			reason: "not readable: missing path"
-		};
-		let buffer;
-		try {
-			buffer = await readFile(path);
-		} catch (error) {
-			if (isResourceLimitError(error)) throw createResourceLimitError(path, error, options.jobs, limits);
-			return {
-				type: "skip",
-				path,
-				reason: `not readable: ${error instanceof Error ? error.message : String(error)}`
-			};
-		}
-		if (isProbablyBinary(buffer)) return {
-			type: "skip",
-			path,
-			reason: "binary file"
-		};
-		return {
-			type: "file",
-			path,
-			content: buffer.toString("utf8")
-		};
-	});
-	const files = [];
-	const skipped = [];
-	for (const entry of entries) {
-		if (entry.type === "file") {
-			files.push({
-				path: entry.path,
-				content: entry.content
-			});
-			continue;
-		}
-		skipped.push({
-			path: entry.path,
-			reason: entry.reason
-		});
-	}
-	return {
-		files,
-		skipped
-	};
-}
-
 //#endregion
 //#region src/cli/batch/jobs/render.ts
 function finalizeBatchJobsSummary(files, section, wcOptions, options = {}) {
@@ -2565,165 +2491,115 @@ async function runBatchCount(options) {
 	});
 	let summary;
 	let routeSkips = [];
-	if (options.jobsStrategy === "load-only") {
-		const loadStartedAtMs = Date.now();
-		options.debug.emit("batch.load.start", {
-			files: resolved.files.length,
-			jobs: options.jobs,
-			strategy: options.jobsStrategy
-		});
-		const loaded = await loadBatchInputsWithJobs(resolved.files, { jobs: options.jobs });
-		const loadElapsedMs = Date.now() - loadStartedAtMs;
-		options.debug.emit("batch.load.complete", {
-			files: loaded.files.length,
-			skipped: loaded.skipped.length,
-			elapsedMs: loadElapsedMs,
-			strategy: options.jobsStrategy
-		});
-		options.debug.emit("batch.stage.timing", {
-			stage: "load",
-			elapsedMs: loadElapsedMs
-		});
-		const progressEnabled = options.progressReporter.enabled && loaded.files.length > 1;
-		options.debug.emit("batch.progress.start", {
-			enabled: progressEnabled,
-			total: loaded.files.length
-		});
-		if (progressEnabled) options.progressReporter.start(loaded.files.length, batchStartedAtMs);
-		const countStartedAtMs = Date.now();
-		let finalizeStartedAtMs = null;
-		let emittedCountTiming = false;
-		try {
-			summary = await buildBatchSummary(loaded.files, options.section, options.wcOptions, {
-				onFileCounted: (snapshot) => {
+	options.debug.emit("batch.load.start", {
+		files: resolved.files.length,
+		jobs: options.jobs,
+		strategy: options.jobsStrategy
+	});
+	options.debug.emit("batch.load.complete", {
+		files: 0,
+		skipped: 0,
+		elapsedMs: 0,
+		strategy: options.jobsStrategy
+	});
+	options.debug.emit("batch.stage.timing", {
+		stage: "load",
+		elapsedMs: 0
+	});
+	const progressEnabled = options.progressReporter.enabled && resolved.files.length > 1;
+	options.debug.emit("batch.progress.start", {
+		enabled: progressEnabled,
+		total: resolved.files.length
+	});
+	if (progressEnabled) options.progressReporter.start(resolved.files.length, batchStartedAtMs);
+	const countStartedAtMs = Date.now();
+	let finalizeStartedAtMs = null;
+	let emittedCountTiming = false;
+	try {
+		let counted;
+		if (options.jobs > 1) try {
+			counted = await countBatchInputsWithWorkerJobs(resolved.files, {
+				jobs: options.jobs,
+				section: options.section,
+				wcOptions: options.wcOptions,
+				preserveCollectorSegments: options.preserveCollectorSegments,
+				onFileProcessed: (snapshot) => {
 					if (progressEnabled) options.progressReporter.advance(snapshot);
-				},
-				onFinalizeStart: () => {
-					finalizeStartedAtMs = Date.now();
-					if (progressEnabled) options.progressReporter.startFinalizing();
-					const countElapsedMs = finalizeStartedAtMs - countStartedAtMs;
-					options.debug.emit("batch.stage.timing", {
-						stage: "count",
-						elapsedMs: countElapsedMs
-					});
-					emittedCountTiming = true;
-				},
-				preserveCollectorSegments: options.preserveCollectorSegments
+				}
 			});
-		} finally {
-			if (progressEnabled) options.progressReporter.finish();
-			options.debug.emit("batch.progress.complete", {
-				enabled: progressEnabled,
-				total: loaded.files.length
+			options.debug.emit("batch.jobs.executor", {
+				strategy: options.jobsStrategy,
+				executor: "worker-pool",
+				jobs: options.jobs
+			});
+		} catch (error) {
+			if (!(error instanceof WorkerRouteUnavailableError)) throw error;
+			options.emitWarning?.(`Worker executor unavailable; falling back to async load+count. (${error.message})`);
+			options.debug.emit("batch.jobs.executor", {
+				strategy: options.jobsStrategy,
+				executor: "async-fallback",
+				reason: error.message,
+				jobs: options.jobs
+			});
+			counted = await countBatchInputsWithJobs(resolved.files, {
+				jobs: options.jobs,
+				section: options.section,
+				wcOptions: options.wcOptions,
+				preserveCollectorSegments: options.preserveCollectorSegments,
+				onFileProcessed: (snapshot) => {
+					if (progressEnabled) options.progressReporter.advance(snapshot);
+				}
 			});
 		}
-		if (!emittedCountTiming) {
-			const countElapsedMs = Date.now() - countStartedAtMs;
-			options.debug.emit("batch.stage.timing", {
-				stage: "count",
-				elapsedMs: countElapsedMs
+		else {
+			counted = await countBatchInputsWithJobs(resolved.files, {
+				jobs: options.jobs,
+				section: options.section,
+				wcOptions: options.wcOptions,
+				preserveCollectorSegments: options.preserveCollectorSegments,
+				onFileProcessed: (snapshot) => {
+					if (progressEnabled) options.progressReporter.advance(snapshot);
+				}
+			});
+			options.debug.emit("batch.jobs.executor", {
+				strategy: options.jobsStrategy,
+				executor: "async-main",
+				jobs: options.jobs
 			});
 		}
-		const finalizeElapsedMs = finalizeStartedAtMs === null ? 0 : Date.now() - finalizeStartedAtMs;
-		options.debug.emit("batch.stage.timing", {
-			stage: "finalize",
-			elapsedMs: finalizeElapsedMs
-		});
-		routeSkips = loaded.skipped;
-	} else {
-		options.debug.emit("batch.load.start", {
-			files: resolved.files.length,
-			jobs: options.jobs,
-			strategy: options.jobsStrategy
-		});
-		options.debug.emit("batch.load.complete", {
-			files: 0,
-			skipped: 0,
-			elapsedMs: 0,
-			strategy: options.jobsStrategy
-		});
-		options.debug.emit("batch.stage.timing", {
-			stage: "load",
-			elapsedMs: 0
+		routeSkips = counted.skipped;
+		summary = finalizeBatchJobsSummary(counted.files, options.section, options.wcOptions, {
+			onFinalizeStart: () => {
+				finalizeStartedAtMs = Date.now();
+				if (progressEnabled) options.progressReporter.startFinalizing();
+				const countElapsedMs = finalizeStartedAtMs - countStartedAtMs;
+				options.debug.emit("batch.stage.timing", {
+					stage: "count",
+					elapsedMs: countElapsedMs
+				});
+				emittedCountTiming = true;
+			},
+			preserveCollectorSegments: options.preserveCollectorSegments
 		});
-		const progressEnabled = options.progressReporter.enabled && resolved.files.length > 1;
-		options.debug.emit("batch.progress.start", {
+	} finally {
+		if (progressEnabled) options.progressReporter.finish();
+		options.debug.emit("batch.progress.complete", {
 			enabled: progressEnabled,
 			total: resolved.files.length
 		});
-		if (progressEnabled) options.progressReporter.start(resolved.files.length, batchStartedAtMs);
-		const countStartedAtMs = Date.now();
-		let finalizeStartedAtMs = null;
-		let emittedCountTiming = false;
-		try {
-			let counted;
-			try {
-				counted = await countBatchInputsWithWorkerJobs(resolved.files, {
-					jobs: options.jobs,
-					section: options.section,
-					wcOptions: options.wcOptions,
-					preserveCollectorSegments: options.preserveCollectorSegments,
-					onFileProcessed: (snapshot) => {
-						if (progressEnabled) options.progressReporter.advance(snapshot);
-					}
-				});
-				options.debug.emit("batch.jobs.executor", {
-					strategy: options.jobsStrategy,
-					executor: "worker-pool",
-					jobs: options.jobs
-				});
-			} catch (error) {
-				if (!(error instanceof WorkerRouteUnavailableError)) throw error;
-				options.debug.emit("batch.jobs.executor", {
-					strategy: options.jobsStrategy,
-					executor: "async-fallback",
-					reason: error.message,
-					jobs: options.jobs
-				});
-				counted = await countBatchInputsWithJobs(resolved.files, {
-					jobs: options.jobs,
-					section: options.section,
-					wcOptions: options.wcOptions,
-					preserveCollectorSegments: options.preserveCollectorSegments,
-					onFileProcessed: (snapshot) => {
-						if (progressEnabled) options.progressReporter.advance(snapshot);
-					}
-				});
-			}
-			routeSkips = counted.skipped;
-			summary = finalizeBatchJobsSummary(counted.files, options.section, options.wcOptions, {
-				onFinalizeStart: () => {
-					finalizeStartedAtMs = Date.now();
-					if (progressEnabled) options.progressReporter.startFinalizing();
-					const countElapsedMs = finalizeStartedAtMs - countStartedAtMs;
-					options.debug.emit("batch.stage.timing", {
-						stage: "count",
-						elapsedMs: countElapsedMs
-					});
-					emittedCountTiming = true;
-				},
-				preserveCollectorSegments: options.preserveCollectorSegments
-			});
-		} finally {
-			if (progressEnabled) options.progressReporter.finish();
-			options.debug.emit("batch.progress.complete", {
-				enabled: progressEnabled,
-				total: resolved.files.length
-			});
-		}
-		if (!emittedCountTiming) {
-			const countElapsedMs = Date.now() - countStartedAtMs;
-			options.debug.emit("batch.stage.timing", {
-				stage: "count",
-				elapsedMs: countElapsedMs
-			});
-		}
-		const finalizeElapsedMs = finalizeStartedAtMs === null ? 0 : Date.now() - finalizeStartedAtMs;
+	}
+	if (!emittedCountTiming) {
+		const countElapsedMs = Date.now() - countStartedAtMs;
 		options.debug.emit("batch.stage.timing", {
-			stage: "finalize",
-			elapsedMs: finalizeElapsedMs
+			stage: "count",
+			elapsedMs: countElapsedMs
 		});
 	}
+	const finalizeElapsedMs = finalizeStartedAtMs === null ? 0 : Date.now() - finalizeStartedAtMs;
+	options.debug.emit("batch.stage.timing", {
+		stage: "finalize",
+		elapsedMs: finalizeElapsedMs
+	});
 	appendAll(summary.skipped, resolved.skipped);
 	appendAll(summary.skipped, routeSkips);
 	options.debug.emit("batch.aggregate.complete", {
@@ -2736,8 +2612,8 @@ async function runBatchCount(options) {
 
 //#endregion
 //#region src/cli/batch/jobs/strategy.ts
-function resolveBatchJobsStrategy(jobs) {
-	return jobs > 1 ? "load-count" : "load-only";
+function resolveBatchJobsStrategy(_jobs) {
+	return "load-count";
 }
 
 //#endregion
@@ -3060,6 +2936,12 @@ function formatInputReadError(error) {
 //#endregion
 //#region src/cli/runtime/batch.ts
 async function executeBatchCount({ argv, options, runtime, resolved, debug, teeEnabled }) {
+	const warningsEnabled = !Boolean(options.quietWarnings);
+	const emitWarning = (message) => {
+		if (!warningsEnabled) return;
+		const warningLine = message.startsWith("Warning:") ? message : `Warning: ${message}`;
+		console.error(import_picocolors.default.yellow(warningLine));
+	};
 	const batchOptions = {
 		scope: resolveBatchScope(argv),
 		pathMode: options.pathMode,
@@ -3071,7 +2953,7 @@ async function executeBatchCount({ argv, options, runtime, resolved, debug, teeE
 	const requestedJobs = options.jobs;
 	const jobsLimit = resolveBatchJobsLimit();
 	const jobs = clampRequestedJobs(requestedJobs, jobsLimit);
-	if (requestedJobs > jobsLimit.suggestedMaxJobs) console.error(import_picocolors.default.yellow(formatJobsAdvisoryWarning(requestedJobs, jobs, jobsLimit)));
+	if (requestedJobs > jobsLimit.suggestedMaxJobs) emitWarning(formatJobsAdvisoryWarning(requestedJobs, jobs, jobsLimit));
 	const jobsStrategy = resolveBatchJobsStrategy(jobs);
 	const debugEnabled = Boolean(options.debug);
 	const mirrorDebugToTerminal = debugEnabled && (!debug.reportPath || teeEnabled);
@@ -3089,16 +2971,19 @@ async function executeBatchCount({ argv, options, runtime, resolved, debug, teeE
 			clearOnFinish: !(mirrorDebugToTerminal || options.keepProgress)
 		}),
 		jobs,
-		jobsStrategy
+		jobsStrategy,
+		emitWarning
 	});
 	const showSkipDiagnostics = debugEnabled && !batchOptions.quietSkips;
+	const showSkipItems = showSkipDiagnostics && Boolean(options.verbose);
 	debug.emit("batch.skips.policy", {
 		enabled: showSkipDiagnostics,
+		items: showSkipItems,
 		quietSkips: batchOptions.quietSkips
 	});
 	if (showSkipDiagnostics) {
 		debug.emit("batch.skips.report", { count: summary.skipped.length });
-		if (options.verbose) for (const skip of summary.skipped) debug.emit("batch.skips.item", {
+		if (showSkipItems) for (const skip of summary.skipped) debug.emit("batch.skips.item", {
 			path: skip.path,
 			reason: skip.reason
 		}, { verbosity: "verbose" });