aiwg 2026.10.4 → 2026.10.5

package/agentic/code/plugins/agent-loop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loop",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Iterative AI coding loops with automatic recovery - iteration beats perfection",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/agent-persistence/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-persistence",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Human-in-the-loop (HITL) gate definitions for agent operations. Provides reusable YAML gates for destructive-action authorization, false-positive override, and recovery escalation. Loaded by agent loops and orchestrators that need bounded human checkpoints.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/agentic-installer/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-installer",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Structured YAML manifests for reproducible, agent-driven software installation across platforms. Scripts are the primary artifact; agentic instructions handle adaptation and recovery.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/aiwg-dev/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "aiwg-dev",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Developer tooling for building AIWG itself and AIWG addons/frameworks. Not for end users — install explicitly with `aiwg use aiwg-dev`.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/aiwg-evals/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "aiwg-evals",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Automated evaluation framework for agent quality, based on KAMI benchmark methodology and ReAct patterns",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/auto-memory/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-memory",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Automatic memory seed templates for AIWG projects",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/browser-control/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-control",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Drive a real, user-installed Chromium-derived browser from an AIWG agent. Wraps @playwright/mcp with a setup wizard, health-check doctor, allow-list enforcement, and an opinionated agent persona that respects authorization and audit boundaries.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/color-palette/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "color-palette",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Color palette selection and review tooling with color theory fundamentals, current trend research, and accessibility analysis.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/compound-memory/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "compound-memory",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Governed orchestration across AIWG line memory, semantic memory, and llm-wiki.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/context-curator/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-curator",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Context curation and distractor filtering for production-grade agent reliability",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/daemon/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "daemon",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Persistent daemon session capabilities: Concierge front-end, session memory, scheduler integration",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/doc-intelligence/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "doc-intelligence",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Documentation intelligence addon for scraping, extraction, analysis, and generated-docs auditing.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/droid-bridge/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "droid-bridge",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "MCP server bridging Claude Code to Factory Droid for batch operations and automated fixes",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/forensics/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "forensics",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Digital forensics and incident response framework with 14 specialized agents covering target profiling, evidence acquisition, log/memory/container/cloud analysis, IOC extraction, and reporting.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/guided-implementation/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "guided-implementation",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Bounded iteration control for autonomous issue-to-code implementation",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/hooks/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "hooks",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Claude Code hooks for workflow tracing and observability.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/knowledge-base/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "knowledge-base",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Knowledge-base / wiki framework with skills for ingestion, query, and lint. Build a structured, citable corpus with cross-references and concept pages.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/line-memory/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "line-memory",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Bounded, plain-text project memory with least-recently-used retention.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/llm-wiki/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-wiki",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "LLM-maintained markdown wiki that compounds as sources are ingested. Thin topology declaration on the semantic memory kernel — ships schema profiles and page templates, no custom mechanics.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/marketing/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "marketing",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Marketing automation framework with 37 specialized agents for campaign management.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/media-curator/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "media-curator",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Media archive management framework with 7 specialized agents for source discovery, acquisition (yt-dlp / Internet Archive / Bandcamp), quality assessment, metadata tagging, and provenance tracking.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/nlp-prod/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nlp-prod",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Tools, skills, and CLI extensions for designing and productionizing LLM inference pipelines. Pattern-guided, slim by default, eval-first.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/ops/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ops",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Operational infrastructure framework with 12 specialized agents covering incident response, runbook execution, fleet inventory, certificate lifecycle, and disaster recovery planning.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/prose-integration/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "prose-integration",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Tools for reading, parsing, validating, and executing OpenProse programs from AIWG workflows",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/research/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "research",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Research workflow framework with 9 specialized agents for discovery, acquisition, synthesis, citation management, GRADE quality assessment, and OAIS-compliant archival.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/rlm/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rlm",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "RLM-inspired recursive context decomposition for processing arbitrarily large codebases and document corpora through programmatic sub-agent delegation",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/sdlc/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "sdlc",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Complete SDLC framework with 180+ specialized agents for software development lifecycle management.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/security-engineering/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "security-engineering",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Applied security framework for cryptographic primitive selection, chain-of-trust design, authentication factor analysis, supply-chain trust, and physical-threat modeling. Complements OWASP-style application audits.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/semantic-memory/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "semantic-memory",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Topology-agnostic semantic memory operations: ingest, lint, query-capture, and structured event logging. Consumers declare a memory topology in their manifest.json; kernel skills read that contract to parameterize behavior.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/skill-factory/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-factory",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Build, enhance, validate, and package Claude skills end-to-end. Coordinates skill-builder, skill-enhancer, quality-checker, and skill-packager via the skill-architect agent.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/star-prompt/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "star-prompt",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Tasteful prompt to encourage users to star the repository after successful command completion",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/testing-quality/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "testing-quality",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Evidence-bound test conformance, platform protocols, normalization transactions and research-guided testing workflows",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/twelve-factor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "twelve-factor",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Design-time and audit-time workflows for Twelve-Factor and modern 12+ Factor cloud-native application practices.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/uat-mcp/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "uat-mcp",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Agent-executable acceptance testing via MCP connections — generate, execute, and report on UAT plans that validate MCP tool surfaces.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/utils/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "utils",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Core AIWG utilities for context regeneration and workspace management.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/validation-complete/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "validation-complete",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Validation Complete for AIWG",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/verbalized-sampling/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "verbalized-sampling",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Training-free prompting technique that improves output diversity by 1.6-2.1x through verbalized probability distributions, addressing RLHF mode collapse",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/voice/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "voice",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Voice profile system for consistent, authentic writing.",
   "author": {
     "name": "AIWG Contributors",

package/agentic/code/plugins/writing/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "writing",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Writing quality validation and AI pattern detection.",
   "author": {
     "name": "AIWG Contributors",

package/dist/src/artifacts/cli.js

@@ -20,6 +20,7 @@ import path from 'node:path';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { GRAPH_CONFIGS, OPERATIONAL_DISCOVERY_TYPES, OPERATIONAL_SHOW_TYPES, isOperationalShowType, loadUserGraphConfigs, loadGlobalGraphConfigs, orderedGraphEntries, } from './types.js';
+import { resolveIndexWorkers } from './index-preparation.js';
 import { SUPPORTED_VIEWS } from './corpus-views/renderers.js';
 import { parseResourceSelector, readVerifiedRegularFile, } from '../resources/web-release.js';
 import { findPackageRoot } from '../cli/find-package-root.js';
@@ -332,6 +333,7 @@ export function printIndexUsage() {
     console.log('  Session import defaults: 67108864 bytes per record, 1073741824 bytes (1 GiB) per source; source 0 is unlimited.');
     console.log('  --exclude <id-or-glob> (repeatable): skip session IDs or absolute path globs; adds to sessions.import.exclude and AIWG_SESSIONS_IMPORT_EXCLUDE (comma-separated).');
     console.log('  Import limits: CLI flag > AIWG_SESSIONS_IMPORT_MAX_RECORD_BYTES / AIWG_SESSIONS_IMPORT_MAX_SOURCE_BYTES > workspace config > default.');
+    console.log('  build/refresh --index-workers <n>: preparation processes (0 = serial); flag > AIWG_INDEX_WORKERS > automatic CPU/memory limits.');
     console.log('  sync [--backend fortemi-core] [--graph <name> | --all] [--repo <name>]');
     console.log('       [--privacy private|sanitized|public] [--generated-at <iso>] [--json]');
     console.log('  --graph <name>  Target a specific graph (framework, project, codebase, source, user, or user-defined)');
@@ -503,6 +505,7 @@ async function handleBuild(args) {
         console.log('Usage: aiwg index build [options]');
         console.log('');
         console.log('Options:');
+        console.log('  --index-workers <n> Preparation processes (0 = serial); overrides AIWG_INDEX_WORKERS');
         console.log('  --force          Full rebuild (ignore checksums, re-index everything)');
         console.log('  --verbose        Show detailed progress during indexing');
         console.log('  --all            Build all known graphs (including user-defined)');
@@ -530,6 +533,15 @@ async function handleBuild(args) {
         console.log('  aiwg index sync --all');
         return;
     }
+    let workers;
+    try {
+        workers = resolveIndexWorkers(parseFlagValue(args, '--index-workers', 'Error: --index-workers requires a value'));
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+        return;
+    }
     // Dynamic import to keep the CLI router lightweight
     const { buildIndex } = await import('./index-builder.js');
     const cwd = process.cwd();
@@ -554,7 +566,7 @@ async function handleBuild(args) {
         // --graph X: build the JSON graph if X is one; otherwise X may be a
         // research-corpus markdown view, rendered below.
         if (graph in GRAPH_CONFIGS) {
-            await buildIndex(cwd, { force, verbose, scope, includeIgnored, graph, explicit: true });
+            await buildIndex(cwd, { force, verbose, scope, includeIgnored, workers, graph, explicit: true });
             jsonBuilt = true;
             builtGraphs.add(graph);
         }
@@ -562,7 +574,7 @@ async function handleBuild(args) {
     else if (all) {
         // Build all known graphs — user asked for everything, but don't hard-error on missing dirs
         for (const [name] of orderedGraphEntries(Object.entries(GRAPH_CONFIGS))) {
-            await buildIndex(cwd, { force, verbose, includeIgnored, graph: name, explicit: false });
+            await buildIndex(cwd, { force, verbose, includeIgnored, workers, graph: name, explicit: false });
             builtGraphs.add(name);
         }
         jsonBuilt = true;
@@ -571,7 +583,7 @@ async function handleBuild(args) {
         // Default: build graphs with defaultBuild=true; skip gracefully if their dirs don't exist
         for (const [name, config] of orderedGraphEntries(Object.entries(GRAPH_CONFIGS))) {
             if (config.defaultBuild) {
-                await buildIndex(cwd, { force, verbose, includeIgnored, scope: name === Object.keys(GRAPH_CONFIGS)[0] ? scope : undefined, graph: name, explicit: false });
+                await buildIndex(cwd, { force, verbose, includeIgnored, workers, scope: name === Object.keys(GRAPH_CONFIGS)[0] ? scope : undefined, graph: name, explicit: false });
                 builtGraphs.add(name);
             }
         }

package/dist/src/artifacts/index-builder.js

@@ -24,7 +24,7 @@ import { FRAMEWORK_RELATIONS_REVISION } from './framework-source-digest.js';
 import { normalizeOperationalState } from './operational-state.js';
 import { DEFAULT_PROJECT_AIWG_DIR, resolveProjectAiwgDir, } from '../config/project-artifacts.js';
 import { normalizeStateTransferProjection } from './state-transfer.js';
-import { runIndexPreparation } from './index-preparation.js';
+import { resolveIndexWorkers, runIndexPreparation } from './index-preparation.js';
 import { collectGraphIndexFiles, findArtifactFiles, indexPathFor } from './index-files.js';
 function absoluteEntryPath(cwd, entryPath, graph) {
     if ((!graph || graph === 'project') && entryPath.startsWith(`${DEFAULT_PROJECT_AIWG_DIR}/`)) {
@@ -911,6 +911,7 @@ export function prepareIndexArtifact(job) {
 }
 export async function buildIndex(cwd, options = {}) {
     const { force = false, verbose = false, scope, includeIgnored = false, outputDir, graph, explicit = true } = options;
+    const workers = resolveIndexWorkers(options.workers);
     const startTime = Date.now();
     const log = options.quiet ? (..._args) => { } : console.log;
     // Ensure user-defined graphs are loaded
@@ -1119,7 +1120,7 @@ export async function buildIndex(cwd, options = {}) {
             jobs.push({ fullPath, relativePath, mtimeMs: stat.mtimeMs, birthtimeMs: stat.birthtimeMs, sizeBytes: stat.size,
                 ...(!force && existingEntries[relativePath] ? { existingChecksum: existingEntries[relativePath].checksum } : {}) });
         }
-    const preparation = await runIndexPreparation(jobs, prepareIndexArtifact, import.meta.url, options.workers);
+    const preparation = await runIndexPreparation(jobs, prepareIndexArtifact, import.meta.url, workers, options.onDiagnostic ?? (message => console.warn(`Index preparation: ${message}`)));
     const preparedArtifacts = new Map(jobs.map((job, index) => [job.fullPath, preparation.results[index]]));
     for (const fullPath of files) {
         const relativePath = indexPathFor(cwd, fullPath, graph);

package/dist/src/artifacts/index-preparation.js

@@ -1,65 +1,130 @@
 /** Bounded artifact-local preparation; ordered graph reduction stays in index-builder. */
 import os from 'node:os';
-import { Worker } from 'node:worker_threads';
+import { fork } from 'node:child_process';
+import { signalChild } from '../process/signal-child.mjs';
+const MIB = 1024 ** 2;
+const WORKER_HEAP_MB = 256;
+// Leave room for V8's young generation, executable code, IPC and native allocations.
+const WORKER_BUDGET_BYTES = 512 * MIB;
+// Parsing and metadata extraction amplify input size; do large files only after the pool exits.
+const MAX_WORKER_ARTIFACT_BYTES = MIB;
+export function resolveIndexWorkers(requested, env = process.env) {
+    const value = requested ?? env.AIWG_INDEX_WORKERS;
+    if (requested === undefined && (value === undefined || value === ''))
+        return undefined;
+    if ((typeof value === 'string' && !/^\d+$/.test(value))
+        || !Number.isSafeInteger(Number(value)) || Number(value) < 0) {
+        throw new Error(`${requested === undefined ? 'AIWG_INDEX_WORKERS' : '--index-workers'} must be a nonnegative safe integer (0 = serial)`);
+    }
+    return Number(value);
+}
 export function indexPreparationWorkers(jobs, requested, cores = os.availableParallelism(), memory = Math.min(os.freemem(), process.availableMemory?.() ?? Infinity), totalBytes = 0) {
-    if (requested !== undefined && (!Number.isInteger(requested) || requested < 0))
-        throw new Error('Index workers must be a nonnegative integer');
+    requested = resolveIndexWorkers(requested);
     if (jobs < 64 || cores < 3 || requested === 0 || requested === 1)
         return 0;
-    // Thread startup costs dominate lightweight scans even at thousands of files.
-    // Explicit thread requests bypass only this conservative automatic workload gate.
-    if (requested === undefined && (jobs < 1000 || !Number.isFinite(totalBytes) || totalBytes < 16 * 1024 ** 2))
+    // Process startup costs dominate lightweight scans even at thousands of files.
+    // Explicit requests bypass only this conservative automatic workload gate.
+    if (requested === undefined && (jobs < 1000 || !Number.isFinite(totalBytes) || totalBytes < 16 * MIB))
         return 0;
-    const byMemory = Math.floor((memory - 512 * 1024 ** 2) / (256 * 1024 ** 2));
+    const byMemory = Math.floor((memory - 512 * MIB) / WORKER_BUDGET_BYTES);
     const bounded = Math.max(0, Math.min(requested ?? 4, 4, cores - 1, byMemory, jobs));
     return bounded >= 2 ? bounded : 0;
 }
-export async function runIndexPreparation(jobs, serial, moduleUrl, requested) {
-    const workerCount = indexPreparationWorkers(jobs.length, requested, undefined, undefined, jobs.reduce((total, job) => total + job.sizeBytes, 0));
+export async function runIndexPreparation(jobs, serial, moduleUrl, requested, onDiagnostic) {
+    const diagnostics = [];
+    const diagnose = (message) => { diagnostics.push(message); onDiagnostic?.(message); };
+    const eligible = jobs.map((job, index) => ({ job, index })).filter(({ job }) => Number.isFinite(job.sizeBytes) && job.sizeBytes >= 0 && job.sizeBytes <= MAX_WORKER_ARTIFACT_BYTES);
+    const workerCount = indexPreparationWorkers(eligible.length, requested, undefined, undefined, eligible.reduce((total, { job }) => total + job.sizeBytes, 0));
     if (!workerCount)
-        return { results: jobs.map(serial), workerCount: 0 };
+        return { results: jobs.map(serial), workerCount: 0, diagnostics };
     const results = new Array(jobs.length), workers = [];
+    const closed = [];
     let next = 0, completed = 0, stopped = false;
     try {
         await new Promise((resolve, reject) => {
-            const fail = (error) => { stopped = true; reject(error); };
+            // Stop dispatch on a process failure. Reap the entire pool before retrying
+            // unfinished work in the main isolate, avoiding overlapping memory peaks.
+            const recover = (message) => {
+                if (stopped)
+                    return;
+                stopped = true;
+                diagnose(`${message}; retrying unfinished preparation serially`);
+                resolve();
+            };
             const dispatch = (worker) => {
-                if (!stopped && next < jobs.length) {
-                    const index = next++;
-                    worker.postMessage({ index, job: jobs[index] });
+                if (stopped || next >= eligible.length)
+                    return;
+                const { index, job } = eligible[next++];
+                try {
+                    worker.send({ index, job }, error => { if (error)
+                        recover(`Index preparation IPC failed for ${job.relativePath}: ${error.message}`); });
+                }
+                catch (error) {
+                    recover(`Index preparation IPC failed for ${job.relativePath}: ${error instanceof Error ? error.message : String(error)}`);
                 }
             };
-            for (let index = 0; index < workerCount; index++) {
-                const worker = new Worker(new URL('./index-worker.mjs', import.meta.url), {
-                    workerData: { moduleUrl }, execArgv: [], resourceLimits: { maxOldGenerationSizeMb: 256 },
+            for (let index = 0; index < workerCount && !stopped; index++) {
+                // A worker_threads resourceLimit is not a process boundary: V8 can abort
+                // Node during allocation before its isolate-limit error is delivered.
+                // A child heap fatal/SIGABRT is instead an ordinary, recoverable exit.
+                const worker = fork(new URL('./index-worker.mjs', import.meta.url), [moduleUrl], {
+                    execArgv: [`--max-old-space-size=${WORKER_HEAP_MB}`, '--max-semi-space-size=16'],
+                    stdio: ['ignore', 'ignore', 'pipe', 'ipc'], serialization: 'advanced',
                 });
                 workers.push(worker);
-                worker.on('error', fail);
-                worker.on('exit', code => { if (!stopped && completed < jobs.length)
-                    fail(new Error(`Index preparation worker exited early (${code})`)); });
-                worker.on('message', message => {
+                closed.push(new Promise(done => worker.once('close', () => done())));
+                let stderr = '';
+                let activePath = '<startup>';
+                worker.stderr?.on('data', chunk => { stderr = (stderr + String(chunk)).slice(-8192); });
+                worker.on('error', error => recover(`Index preparation worker failed for ${activePath}: ${error.message}`));
+                worker.on('exit', (code, signal) => {
+                    const oom = /heap out of memory|ERR_WORKER_OUT_OF_MEMORY/i.test(stderr) ? ' (heap out of memory)' : '';
+                    recover(`Index preparation worker exited early for ${activePath} (${signal ?? code})${oom}`);
+                });
+                worker.on('message', (message) => {
                     if (stopped)
                         return;
                     if (message.error) {
-                        fail(new Error(message.error));
+                        stopped = true;
+                        reject(new Error(message.error));
                         return;
                     }
                     results[message.index] = message.result;
                     completed++;
-                    if (completed === jobs.length) {
+                    if (completed === eligible.length) {
                         stopped = true;
                         resolve();
                     }
-                    else
+                    else {
+                        activePath = eligible[next]?.job.relativePath ?? '<idle>';
                         dispatch(worker);
+                    }
                 });
+                activePath = eligible[next]?.job.relativePath ?? '<idle>';
                 dispatch(worker);
             }
         });
-        return { results, workerCount };
     }
     finally {
-        await Promise.all(workers.map(worker => worker.terminate()));
+        stopped = true;
+        for (const worker of workers)
+            if (worker.exitCode === null && worker.signalCode === null)
+                signalChild(worker, 'SIGKILL');
+        await Promise.all(closed);
+    }
+    const largeCount = jobs.length - eligible.length;
+    if (largeCount)
+        diagnose(`${largeCount} artifact(s) above the worker size threshold prepared serially`);
+    for (let index = 0; index < jobs.length; index++) {
+        if (!results[index]) {
+            try {
+                results[index] = serial(jobs[index]);
+            }
+            catch (error) {
+                throw new Error(`${jobs[index].relativePath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
     }
+    return { results, workerCount, diagnostics };
 }
 //# sourceMappingURL=index-preparation.js.map