@shapeshift-labs/frontier-swarm 0.5.9 → 0.5.11

package/benchmarks/package-bench.mjs

@@ -1,195 +1,28 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { performance } from 'node:perf_hooks';
-import { fileURLToPath } from 'node:url';
 import {
-  checkSwarmOwnership,
-  createSwarmAdaptiveLoadPlan,
-  createSwarmContextPack,
-  createSwarmHotspotReport,
-  createSwarmLanePlaybook,
-  createSwarmMergeAdmission,
-  createSwarmManifest,
-  createSwarmEventStream,
-  createSwarmLeases,
-  createSwarmMergeBundle,
-  createSwarmMergeIndex,
-  createSwarmOracleCorpus,
-  createSwarmPatchStackPlan,
-  createSwarmReplayBundle,
-  createSwarmParityOracle,
-  createSwarmDivergenceReport,
-  createSwarmWatchpointPlan,
-  createSwarmDebugHandoff,
-  createSwarmEvidenceIndex,
-  createSwarmBlackboard,
-  createSwarmBottleneckReport,
-  createSwarmFixtureCatalog,
-  createSwarmProgressModel,
-  createSwarmPlan,
-  createSwarmProof,
-  createSwarmQueueOverlay,
-  createSwarmQueueSnapshot,
-  createSwarmRun,
-  createSwarmRunCheckpoint,
-  createSwarmSchedule,
-  decodeSwarmJsonl,
-  defineSwarmTasks,
-  encodeSwarmJsonl,
-  routeSwarmEventToMailboxes,
-  resolveSwarmCompute,
-  validateSwarmManifest
-} from '../dist/index.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageDir = path.resolve(__dirname, '..');
-const repoRoot = path.basename(path.dirname(packageDir)) === 'packages'
-  ? path.resolve(packageDir, '..', '..')
-  : packageDir;
+  createMeasure,
+  createPackageBenchPaths,
+  parseArgs,
+  printBenchReport,
+  readPackageVersion,
+  readPositiveInt,
+  resolveOutPath,
+  writeBenchReport
+} from './package-bench-runtime.mjs';
+import { createPackageBenchRows } from './package-bench-rows.mjs';
+
+const { packageDir, repoRoot } = createPackageBenchPaths(import.meta.url);
 const args = parseArgs(process.argv.slice(2));
 const taskCount = readPositiveInt(args.tasks, 1000);
 const rounds = readPositiveInt(args.rounds, 30);
-const outPath = args.out ? path.resolve(repoRoot, args.out) : null;
-
-const manifest = createSwarmManifest(makeManifest());
-const tasks = defineSwarmTasks(makeTasks(taskCount));
-let plan = createSwarmPlan(manifest, tasks, { limit: 64 });
-let run = createSwarmRun({ plan });
-let jsonl = encodeSwarmJsonl([plan, run]);
-let cursor = 0;
-let schedule = createSwarmSchedule({ plan, maxReadyJobs: 128 });
-let leases = createSwarmLeases({ schedule, workerId: 'bench-worker', now: 1000, leaseMs: 60000, count: 16 });
-let eventStream = createSwarmEventStream({ runId: 'bench', root: 'agent-runs/bench/streams', lanes: manifest.lanes });
-let bundles = makeBundles(plan, 32);
-let mergeIndex = createSwarmMergeIndex({ bundles });
-
-const rows = [
-  measure('create-plan-' + taskCount, 8, () => {
-    plan = createSwarmPlan(manifest, tasks, { limit: 64, selectors: ['task'] });
-    return plan.jobs.length;
-  }),
-  measure('validate-manifest', 32, () => validateSwarmManifest(manifest).issues.length),
-  measure('resolve-compute-' + taskCount, 64, () => resolveSwarmCompute(manifest, tasks[cursor++ % tasks.length]).id.length),
-  measure('ownership-check-' + taskCount, 64, () => checkSwarmOwnership(plan.jobs[cursor++ % plan.jobs.length], ['src/runtime/file.ts']).violations.length),
-  measure('create-run-' + taskCount, 16, () => {
-    run = createSwarmRun({ plan });
-    return run.jobs.length;
-  }),
-  measure('jsonl-encode', 16, () => {
-    jsonl = encodeSwarmJsonl([plan, run]);
-    return jsonl.length;
-  }),
-  measure('jsonl-decode', 16, () => decodeSwarmJsonl(jsonl).length),
-  measure('proof', 16, () => createSwarmProof(plan).hash.length),
-  measure('schedule-lease-' + taskCount, 8, () => {
-    schedule = createSwarmSchedule({ plan, maxReadyJobs: 128, maxComputeConcurrency: { fast: 64, deep: 32 } });
-    leases = createSwarmLeases({ schedule, workerId: 'bench-worker', now: 1000 + cursor++, leaseMs: 60000, count: 16 });
-    return schedule.ready.length + leases.length;
-  }),
-  measure('adaptive-load-' + taskCount, 8, () => createSwarmAdaptiveLoadPlan({
-    plan,
-    schedule,
-    mode: 'balanced',
-    maxLimits: { maxReadyJobs: 128 },
-    currentLimits: { maxReadyJobs: 64 },
-    observations: [
-      { kind: 'semantic-empty', jobId: plan.jobs[cursor % plan.jobs.length].id, lane: plan.jobs[cursor % plan.jobs.length].lane },
-      { kind: 'log-noise', lane: 'runtime', value: 200000 }
-    ],
-    generatedAt: 1500 + cursor++
-  }).summary.decisionCount),
-  measure('queue-snapshot-' + taskCount, 8, () => {
-    const snapshot = createSwarmQueueSnapshot({ plan, run, leases, generatedAt: 2000 + cursor++ });
-    return snapshot.summary.jobCount + snapshot.summary.leaseCount;
-  }),
-  measure('run-checkpoint-' + taskCount, 16, () => createSwarmRunCheckpoint({ run, sequence: cursor++ }).hash.length),
-  measure('merge-bundle-' + taskCount, 32, () => createSwarmMergeBundle({
-    job: plan.jobs[cursor % plan.jobs.length],
-    result: {
-      jobId: plan.jobs[cursor++ % plan.jobs.length].id,
-      status: 'completed',
-      changedPaths: ['src/runtime/file.ts'],
-      verification: [{ status: 0 }]
-    },
-    patchPath: 'agent-runs/bench/changes.patch'
-  }).id.length),
-  measure('queue-overlay-' + taskCount, 16, () => createSwarmQueueOverlay({ bundles, generatedAt: 3000 + cursor++ }).summary.entryCount),
-  measure('merge-index-' + taskCount, 8, () => {
-    bundles = makeBundles(plan, 32);
-    mergeIndex = createSwarmMergeIndex({ bundles, generatedAt: 4000 + cursor++ });
-    return mergeIndex.summary.entryCount + mergeIndex.summary.conflictCount;
-  }),
-  measure('merge-admission-' + taskCount, 16, () => createSwarmMergeAdmission({ index: mergeIndex, maxReady: 8, maxChangedPaths: 16 }).summary.admittedCount),
-  measure('hotspot-report-' + taskCount, 16, () => createSwarmHotspotReport({ bundles, threshold: 3 }).summary.recommendationCount),
-  measure('context-pack-' + taskCount, 32, () => createSwarmContextPack({
-    job: plan.jobs[cursor % plan.jobs.length],
-    files: ['src/runtime/file.ts', 'test/runtime-smoke.mjs'],
-    apiMap: {
-      runtime: ['createRuntime', 'stepRuntime'],
-      tests: ['runtime smoke gate']
-    },
-    knownFailures: ['shared renderer gate is noisy on old snapshots'],
-    oracleCommands: [{ name: 'focused-gate', command: 'npm', args: ['test'], required: true }],
-    evidenceSchema: { type: 'object', required: ['ok', 'commands'] },
-    avoidInvestigating: ['unrelated route snapshots'],
-    playbookIds: ['runtime-playbook']
-  }).files.length),
-  measure('oracle-corpus-' + taskCount, 32, () => createSwarmOracleCorpus({
-    artifacts: [
-      { id: 'trace-runtime', path: 'oracles/runtime-trace.jsonl', kind: 'trace', tags: ['runtime', 'reference'], hash: 'fnv1a32:trace' },
-      { id: 'snapshot-routing', path: 'oracles/routing-snapshot.json', kind: 'snapshot', tags: ['routing', 'reference'] }
-    ]
-  }).summary.artifactCount),
-  measure('replay-debug-evidence-' + taskCount, 16, () => {
-    const replay = createSwarmReplayBundle({
-      commands: ['node replay.mjs'],
-      artifacts: [{ path: 'agent-runs/bench/trace.jsonl', kind: 'trace' }],
-      expectedEvidence: ['trace.jsonl']
-    });
-    const parity = createSwarmParityOracle({
-      comparators: [{ status: 'failed', expected: 1, actual: 2, operationIndex: cursor++ }]
-    });
-    const divergence = createSwarmDivergenceReport({
-      replayBundleIds: [replay.id],
-      observabilityPoints: [{ operationIndex: cursor, path: '/value' }],
-      expected: 1,
-      actual: 2
-    });
-    const watch = createSwarmWatchpointPlan({ watchpoints: [{ path: '/value', operator: 'changes' }] });
-    const handoff = createSwarmDebugHandoff({
-      replayBundleIds: [replay.id],
-      divergenceReportIds: [divergence.id],
-      watchpointPlanIds: [watch.id],
-      comparisons: parity.comparators
-    });
-    const evidence = createSwarmEvidenceIndex({ entries: [{ topic: 'bench', path: 'agent-runs/bench/evidence.json' }] });
-    const blackboard = createSwarmBlackboard({ entries: [{ topic: 'bench', text: 'divergence found', sourceIds: [divergence.id] }] });
-    const bottleneck = createSwarmBottleneckReport({ sources: [{ text: 'merge review bottleneck', changedPaths: ['src/runtime.ts'] }] });
-    const fixtures = createSwarmFixtureCatalog({ fixtures: [{ id: 'logged-in', tags: ['auth'] }] });
-    const progress = createSwarmProgressModel({ items: [{ id: 'bench', status: 'accepted' }] });
-    return handoff.commands.length + evidence.summary.entryCount + blackboard.summary.entryCount + bottleneck.summary.kindCount + fixtures.summary.fixtureCount + progress.summary.acceptedCount;
-  }),
-  measure('lane-playbook-' + taskCount, 16, () => createSwarmLanePlaybook({
-    lane: 'runtime',
-    successfulBundles: bundles,
-    notes: ['prefer narrow patches with focused evidence'],
-    commands: [{ name: 'runtime-smoke', command: 'npm', args: ['test'], required: true }],
-    avoidInvestigating: ['generated fixtures unless task owns them'],
-    evidencePatterns: ['evidence.json', 'commands.md']
-  }).successfulJobIds.length),
-  measure('patch-stack-plan-' + taskCount, 16, () => createSwarmPatchStackPlan({
-    index: mergeIndex,
-    maxStackSize: 8
-  }).summary.stackCount),
-  measure('event-route-' + taskCount, 64, () => {
-    eventStream = createSwarmEventStream({ runId: 'bench', root: 'agent-runs/bench/streams', lanes: manifest.lanes });
-    return routeSwarmEventToMailboxes(eventStream, { type: 'agent.evidence', jobId: plan.jobs[cursor++ % plan.jobs.length].id, lane: 'runtime' }).length;
-  })
-];
+const outPath = resolveOutPath(repoRoot, args.out);
+const rows = createPackageBenchRows({
+  taskCount,
+  measure: createMeasure(rounds)
+});
 
 const report = {
   package: '@shapeshift-labs/frontier-swarm',
-  version: readPackageVersion(),
+  version: readPackageVersion(packageDir),
   generatedAt: new Date().toISOString(),
   node: process.version,
   platform: process.platform + ' ' + process.arch,
@@ -198,125 +31,5 @@ const report = {
   rows
 };
 
-if (outPath) {
-  fs.mkdirSync(path.dirname(outPath), { recursive: true });
-  fs.writeFileSync(outPath, JSON.stringify(report, null, 2) + '\n');
-}
-
-console.log(report.package + ' package benchmark');
-console.log('Node ' + report.node + ' on ' + report.platform + ', tasks=' + taskCount + ', rounds=' + rounds);
-console.log('These are Frontier-only package measurements, not competitor comparisons.');
-console.log('');
-console.log(padRight('Fixture', 30) + padLeft('Median', 12) + padLeft('p95', 12));
-for (const row of rows) {
-  console.log(padRight(row.fixture, 30) + padLeft(formatUs(row.medianUs), 12) + padLeft(formatUs(row.p95Us), 12));
-}
-if (outPath) console.log('\nwrote ' + path.relative(repoRoot, outPath));
-
-function makeManifest() {
-  return {
-    compute: [
-      { id: 'deep', kind: 'codex', model: 'gpt-5.5', reasoningEffort: 'xhigh' },
-      { id: 'fast', kind: 'codex', model: 'gpt-5.4-mini', reasoningEffort: 'medium' }
-    ],
-    layers: [
-      { id: 'parent', childCompute: { implementation: 'deep', evidence: 'fast' } },
-      { id: 'implementation', parentId: 'parent' },
-      { id: 'evidence', parentId: 'parent' }
-    ],
-    lanes: [
-      { id: 'runtime', layer: 'implementation', allowedWrites: ['src/runtime/**'], evidencePrefix: 'evidence/runtime/' },
-      { id: 'tests', layer: 'evidence', allowedWrites: ['test/**'], evidencePrefix: 'evidence/tests/' }
-    ],
-    policy: { defaultCompute: 'fast' }
-  };
-}
-
-function makeTasks(count) {
-  const tasks = [];
-  for (let i = 0; i < count; i += 1) {
-    const lane = i % 3 === 0 ? 'tests' : 'runtime';
-    tasks.push({
-      id: 'task-' + i,
-      lane,
-      priority: i % 100,
-      targetRefs: [lane === 'tests' ? `test/file-${i}.mjs` : `src/runtime/file-${i}.ts`],
-      acceptance: ['task ' + i + ' passes']
-    });
-  }
-  return tasks;
-}
-
-function makeBundles(plan, count) {
-  const bundles = [];
-  for (let i = 0; i < Math.min(count, plan.jobs.length); i += 1) {
-    const job = plan.jobs[i];
-    bundles.push(createSwarmMergeBundle({
-      job,
-      result: {
-        jobId: job.id,
-        status: 'verified',
-        changedPaths: [job.task.targetRefs[0] ?? `src/runtime/file-${i}.ts`],
-        changedRegions: i % 2 === 0 ? [`region.${i}`] : [],
-        verification: [{ status: 0 }]
-      },
-      patchPath: `agent-runs/bench/${job.id}/changes.patch`
-    }));
-  }
-  return bundles;
-}
-
-function measure(fixture, operationsPerRound, fn) {
-  const samples = [];
-  let checksum = 0;
-  for (let round = 0; round < rounds; round += 1) {
-    const start = performance.now();
-    for (let op = 0; op < operationsPerRound; op += 1) checksum += Number(fn()) || 0;
-    const elapsed = performance.now() - start;
-    samples.push((elapsed * 1000) / operationsPerRound);
-  }
-  samples.sort((a, b) => a - b);
-  return {
-    fixture,
-    operationsPerRound,
-    medianUs: percentile(samples, 0.5),
-    p95Us: percentile(samples, 0.95),
-    checksum
-  };
-}
-
-function percentile(sorted, pct) {
-  return sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * pct))];
-}
-
-function formatUs(value) {
-  if (value >= 1000) return (value / 1000).toFixed(2) + 'ms';
-  return value.toFixed(2) + 'us';
-}
-
-function padRight(value, size) {
-  return String(value).padEnd(size);
-}
-
-function padLeft(value, size) {
-  return String(value).padStart(size);
-}
-
-function parseArgs(argv) {
-  const out = {};
-  for (let i = 0; i < argv.length; i += 1) {
-    if (argv[i] === '--out') out.out = argv[++i];
-    else if (argv[i] === '--tasks') out.tasks = argv[++i];
-    else if (argv[i] === '--rounds') out.rounds = argv[++i];
-  }
-  return out;
-}
-
-function readPositiveInt(value, fallback) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
-}
-
-function readPackageVersion() {
-  return JSON.parse(fs.readFileSync(path.join(packageDir, 'package.json'), 'utf8')).version;
-}
+writeBenchReport(report, outPath);
+printBenchReport(report, { outPath, repoRoot });

package/dist/adaptive-load-decisions.d.ts

@@ -0,0 +1,6 @@
+import type { FrontierSwarmScheduleLimits } from './plan.js';
+import type { FrontierSwarmAdaptiveLoadDecision, FrontierSwarmAdaptiveMode, FrontierSwarmAdaptiveObservation } from './adaptive-load-types.js';
+export declare function applyAdaptiveObservation(limits: FrontierSwarmScheduleLimits, minLimits: FrontierSwarmScheduleLimits, maxLimits: FrontierSwarmScheduleLimits, mode: FrontierSwarmAdaptiveMode, observation: FrontierSwarmAdaptiveObservation, decisions: FrontierSwarmAdaptiveLoadDecision[]): void;
+export declare function applyAdaptiveRecovery(limits: FrontierSwarmScheduleLimits, maxLimits: FrontierSwarmScheduleLimits, observation: FrontierSwarmAdaptiveObservation, decisions: FrontierSwarmAdaptiveLoadDecision[]): void;
+export declare function createAdaptiveDecision(input: Omit<FrontierSwarmAdaptiveLoadDecision, 'id'>): FrontierSwarmAdaptiveLoadDecision;
+//# sourceMappingURL=adaptive-load-decisions.d.ts.map

package/dist/adaptive-load-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-load-decisions.d.ts","sourceRoot":"","sources":["../src/adaptive-load-decisions.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAEV,iCAAiC,EACjC,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,2BAA2B,EACtC,SAAS,EAAE,2BAA2B,EACtC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,EAAE,gCAAgC,EAC7C,SAAS,EAAE,iCAAiC,EAAE,GAC7C,IAAI,CAmDN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,2BAA2B,EACtC,WAAW,EAAE,gCAAgC,EAC7C,SAAS,EAAE,iCAAiC,EAAE,GAC7C,IAAI,CAoBN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,iCAAiC,EAAE,IAAI,CAAC,GAAG,iCAAiC,CAK9H"}

package/dist/adaptive-load-decisions.js

@@ -0,0 +1,130 @@
+import { positiveNumber, stableHash } from './internal.js';
+import { clampAdaptiveLimit } from './adaptive-load-limits.js';
+import { adaptiveDecisionKeyForObservation, adaptiveDecisionTargetForObservation, adaptiveObservationIsCapacityBackpressure, adaptiveObservationShouldReduceReadyWindow } from './adaptive-load-observations.js';
+export function applyAdaptiveObservation(limits, minLimits, maxLimits, mode, observation, decisions) {
+    if (observation.kind === 'ready-capacity') {
+        decisions.push(createAdaptiveDecision({
+            action: 'hold',
+            target: 'max-ready-jobs',
+            previous: limits.maxReadyJobs,
+            next: limits.maxReadyJobs,
+            max: maxLimits.maxReadyJobs,
+            min: minLimits.maxReadyJobs,
+            reason: observation.reasons[0] ?? 'ready-capacity',
+            observationIds: [observation.id]
+        }));
+        return;
+    }
+    const target = adaptiveDecisionTargetForObservation(observation);
+    const key = adaptiveDecisionKeyForObservation(observation);
+    if (adaptiveObservationIsCapacityBackpressure(observation)) {
+        decisions.push(createAdaptiveDecision({
+            action: 'hold',
+            target,
+            ...(key ? { key } : {}),
+            reason: observation.reasons[0] ?? observation.kind,
+            observationIds: [observation.id]
+        }));
+        return;
+    }
+    if (target === 'lane' && key) {
+        decreaseAdaptiveRecordLimit(limits.maxLaneConcurrency, minLimits.maxLaneConcurrency, maxLimits.maxLaneConcurrency, key, mode, observation, decisions, target);
+    }
+    else if (target === 'concurrency-key' && key) {
+        decreaseAdaptiveRecordLimit(limits.maxConcurrencyKeyConcurrency, minLimits.maxConcurrencyKeyConcurrency, maxLimits.maxConcurrencyKeyConcurrency, key, mode, observation, decisions, target);
+    }
+    else if (target === 'compute' && key) {
+        decreaseAdaptiveRecordLimit(limits.maxComputeConcurrency, minLimits.maxComputeConcurrency, maxLimits.maxComputeConcurrency, key, mode, observation, decisions, target);
+    }
+    else if (target === 'resource' && key) {
+        decreaseAdaptiveRecordLimit(limits.resourceQuotas, minLimits.resourceQuotas, maxLimits.resourceQuotas, key, mode, observation, decisions, target);
+    }
+    if (adaptiveObservationShouldReduceReadyWindow(observation)) {
+        const previous = limits.maxReadyJobs ?? maxLimits.maxReadyJobs ?? 1;
+        const min = minLimits.maxReadyJobs ?? 1;
+        const max = maxLimits.maxReadyJobs ?? previous;
+        limits.maxReadyJobs = clampAdaptiveLimit(adaptiveReducedValue(previous, min, mode, observation), min, max);
+        decisions.push(createAdaptiveDecision({
+            action: limits.maxReadyJobs < previous ? 'decrease' : 'hold',
+            target: 'max-ready-jobs',
+            previous,
+            next: limits.maxReadyJobs,
+            max,
+            min,
+            reason: observation.reasons[0] ?? observation.kind,
+            observationIds: [observation.id]
+        }));
+    }
+}
+export function applyAdaptiveRecovery(limits, maxLimits, observation, decisions) {
+    if (limits.maxReadyJobs !== undefined && maxLimits.maxReadyJobs !== undefined && limits.maxReadyJobs < maxLimits.maxReadyJobs) {
+        const previous = limits.maxReadyJobs;
+        limits.maxReadyJobs = Math.min(maxLimits.maxReadyJobs, previous + 1);
+        decisions.push(createAdaptiveDecision({
+            action: 'increase',
+            target: 'max-ready-jobs',
+            previous,
+            next: limits.maxReadyJobs,
+            max: maxLimits.maxReadyJobs,
+            reason: observation.reasons[0] ?? observation.kind,
+            observationIds: [observation.id]
+        }));
+    }
+    if (observation.lane) {
+        increaseAdaptiveRecordLimit(limits.maxLaneConcurrency, maxLimits.maxLaneConcurrency, observation.lane, observation, decisions, 'lane');
+    }
+    if (observation.compute) {
+        increaseAdaptiveRecordLimit(limits.maxComputeConcurrency, maxLimits.maxComputeConcurrency, observation.compute, observation, decisions, 'compute');
+    }
+}
+export function createAdaptiveDecision(input) {
+    return {
+        id: 'swarm-adaptive-decision:' + stableHash([input.action, input.target, input.key, input.previous, input.next, input.reason, input.observationIds]),
+        ...input
+    };
+}
+function decreaseAdaptiveRecordLimit(record, minRecord, maxRecord, key, mode, observation, decisions, target) {
+    const previous = record[key] ?? maxRecord[key];
+    if (!positiveNumber(previous))
+        return;
+    const min = minRecord[key] ?? 1;
+    const max = maxRecord[key] ?? previous;
+    const next = clampAdaptiveLimit(adaptiveReducedValue(previous, min, mode, observation), min, max);
+    record[key] = next;
+    decisions.push(createAdaptiveDecision({
+        action: next < previous ? 'decrease' : 'hold',
+        target,
+        key,
+        previous,
+        next,
+        max,
+        min,
+        reason: observation.reasons[0] ?? observation.kind,
+        observationIds: [observation.id]
+    }));
+}
+function increaseAdaptiveRecordLimit(record, maxRecord, key, observation, decisions, target) {
+    const previous = record[key];
+    const max = maxRecord[key];
+    if (!positiveNumber(previous) || !positiveNumber(max) || previous >= max)
+        return;
+    record[key] = Math.min(max, previous + 1);
+    decisions.push(createAdaptiveDecision({
+        action: 'increase',
+        target,
+        key,
+        previous,
+        next: record[key],
+        max,
+        reason: observation.reasons[0] ?? observation.kind,
+        observationIds: [observation.id]
+    }));
+}
+function adaptiveReducedValue(previous, min, mode, observation) {
+    if (observation.kind === 'merge-conflict' || observation.kind === 'duplicate-output' || observation.kind === 'concurrency-key-capacity')
+        return min;
+    const severityFactor = observation.severity === 'critical' ? 0.45 : observation.severity === 'error' ? 0.55 : observation.severity === 'warning' ? 0.7 : 0.85;
+    const modeFactor = mode === 'conservative' ? 0.6 : mode === 'aggressive' ? 0.85 : 0.75;
+    return Math.max(min, Math.floor(previous * Math.min(severityFactor, modeFactor)));
+}
+//# sourceMappingURL=adaptive-load-decisions.js.map

package/dist/adaptive-load-decisions.js.map

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

package/dist/adaptive-load-limits.d.ts

@@ -0,0 +1,8 @@
+import type { FrontierSwarmScheduleLimits } from './plan.js';
+import type { FrontierSwarmAdaptiveLoadPlanInput, FrontierSwarmAdaptiveScheduleLimitsInput } from './adaptive-load-types.js';
+export declare function createAdaptiveMaxLimits(input: FrontierSwarmAdaptiveLoadPlanInput): FrontierSwarmScheduleLimits;
+export declare function createAdaptiveCurrentLimits(input: FrontierSwarmAdaptiveScheduleLimitsInput | undefined, maxLimits: FrontierSwarmScheduleLimits): FrontierSwarmScheduleLimits;
+export declare function createAdaptiveMinLimits(input: FrontierSwarmAdaptiveScheduleLimitsInput | undefined, maxLimits: FrontierSwarmScheduleLimits): FrontierSwarmScheduleLimits;
+export declare function clampAdaptiveLimits(value: FrontierSwarmScheduleLimits, minLimits: FrontierSwarmScheduleLimits, maxLimits: FrontierSwarmScheduleLimits): FrontierSwarmScheduleLimits;
+export declare function clampAdaptiveLimit(value: number, min: number, max: number): number;
+//# sourceMappingURL=adaptive-load-limits.d.ts.map

package/dist/adaptive-load-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-load-limits.d.ts","sourceRoot":"","sources":["../src/adaptive-load-limits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAE,kCAAkC,EAAE,wCAAwC,EAAE,MAAM,0BAA0B,CAAC;AAE7H,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kCAAkC,GAAG,2BAA2B,CA4B9G;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,wCAAwC,GAAG,SAAS,EAC3D,SAAS,EAAE,2BAA2B,GACrC,2BAA2B,CAU7B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,wCAAwC,GAAG,SAAS,EAC3D,SAAS,EAAE,2BAA2B,GACrC,2BAA2B,CAa7B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,2BAA2B,EAClC,SAAS,EAAE,2BAA2B,EACtC,SAAS,EAAE,2BAA2B,GACrC,2BAA2B,CAU7B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlF"}

package/dist/adaptive-load-limits.js

@@ -0,0 +1,105 @@
+import { cloneJsonValue, positiveNumber, uniqueStrings } from './internal.js';
+export function createAdaptiveMaxLimits(input) {
+    const plan = input.plan;
+    const jobCount = Math.max(1, plan?.jobs.length ?? input.schedule?.summary.jobCount ?? input.dashboard?.summary.jobCount ?? 1);
+    const raw = mergeAdaptiveScheduleLimitInputs(plan?.limits, input.maxLimits);
+    const maxReadyJobs = positiveNumber(raw.maxReadyJobs) ? Math.floor(raw.maxReadyJobs) : jobCount;
+    const maxLaneConcurrency = { ...raw.maxLaneConcurrency };
+    const maxConcurrencyKeyConcurrency = { ...raw.maxConcurrencyKeyConcurrency };
+    const maxComputeConcurrency = { ...raw.maxComputeConcurrency };
+    const resourceQuotas = { ...raw.resourceQuotas };
+    for (const job of plan?.jobs ?? []) {
+        maxLaneConcurrency[job.lane] = adaptivePositiveLimit(maxLaneConcurrency[job.lane], job.compute.maxConcurrency ?? maxReadyJobs);
+        maxConcurrencyKeyConcurrency[job.concurrencyKey] = adaptivePositiveLimit(maxConcurrencyKeyConcurrency[job.concurrencyKey], maxReadyJobs);
+        maxComputeConcurrency[job.compute.id] = adaptivePositiveLimit(maxComputeConcurrency[job.compute.id], job.compute.maxConcurrency ?? maxReadyJobs);
+        for (const [resource, amount] of Object.entries(job.resourceRequirements?.resources ?? {})) {
+            resourceQuotas[resource] = adaptivePositiveLimit(resourceQuotas[resource], Math.max(1, Math.ceil(amount), maxReadyJobs));
+        }
+        if (job.resourceRequirements?.browser?.required) {
+            resourceQuotas.browser = adaptivePositiveLimit(resourceQuotas.browser, maxReadyJobs);
+            resourceQuotas['browser-port'] = adaptivePositiveLimit(resourceQuotas['browser-port'], maxReadyJobs);
+        }
+    }
+    return {
+        maxReadyJobs,
+        maxLaneConcurrency: normalizeAdaptiveLimitRecord(maxLaneConcurrency),
+        maxConcurrencyKeyConcurrency: normalizeAdaptiveLimitRecord(maxConcurrencyKeyConcurrency),
+        maxComputeConcurrency: normalizeAdaptiveLimitRecord(maxComputeConcurrency),
+        resourceQuotas: normalizeAdaptiveLimitRecord(resourceQuotas)
+    };
+}
+export function createAdaptiveCurrentLimits(input, maxLimits) {
+    if (!input)
+        return cloneJsonValue(maxLimits);
+    const raw = mergeAdaptiveScheduleLimitInputs(maxLimits, input);
+    return {
+        ...(positiveNumber(raw.maxReadyJobs) ? { maxReadyJobs: Math.floor(raw.maxReadyJobs) } : {}),
+        maxLaneConcurrency: normalizeAdaptiveLimitRecord(raw.maxLaneConcurrency),
+        maxConcurrencyKeyConcurrency: normalizeAdaptiveLimitRecord(raw.maxConcurrencyKeyConcurrency),
+        maxComputeConcurrency: normalizeAdaptiveLimitRecord(raw.maxComputeConcurrency),
+        resourceQuotas: normalizeAdaptiveLimitRecord(raw.resourceQuotas)
+    };
+}
+export function createAdaptiveMinLimits(input, maxLimits) {
+    const raw = mergeAdaptiveScheduleLimitInputs(undefined, input);
+    const laneMinimums = Object.fromEntries(Object.keys(maxLimits.maxLaneConcurrency).map((key) => [key, 1]));
+    const keyMinimums = Object.fromEntries(Object.keys(maxLimits.maxConcurrencyKeyConcurrency).map((key) => [key, 1]));
+    const computeMinimums = Object.fromEntries(Object.keys(maxLimits.maxComputeConcurrency).map((key) => [key, 1]));
+    const resourceMinimums = Object.fromEntries(Object.keys(maxLimits.resourceQuotas).map((key) => [key, 1]));
+    return {
+        maxReadyJobs: adaptivePositiveLimit(raw.maxReadyJobs, 1),
+        maxLaneConcurrency: normalizeAdaptiveLimitRecord({ ...laneMinimums, ...raw.maxLaneConcurrency }),
+        maxConcurrencyKeyConcurrency: normalizeAdaptiveLimitRecord({ ...keyMinimums, ...raw.maxConcurrencyKeyConcurrency }),
+        maxComputeConcurrency: normalizeAdaptiveLimitRecord({ ...computeMinimums, ...raw.maxComputeConcurrency }),
+        resourceQuotas: normalizeAdaptiveLimitRecord({ ...resourceMinimums, ...raw.resourceQuotas })
+    };
+}
+export function clampAdaptiveLimits(value, minLimits, maxLimits) {
+    return {
+        ...(value.maxReadyJobs !== undefined || maxLimits.maxReadyJobs !== undefined ? {
+            maxReadyJobs: clampAdaptiveLimit(value.maxReadyJobs ?? maxLimits.maxReadyJobs ?? 1, minLimits.maxReadyJobs ?? 1, maxLimits.maxReadyJobs ?? value.maxReadyJobs ?? 1)
+        } : {}),
+        maxLaneConcurrency: clampAdaptiveRecord(value.maxLaneConcurrency, minLimits.maxLaneConcurrency, maxLimits.maxLaneConcurrency),
+        maxConcurrencyKeyConcurrency: clampAdaptiveRecord(value.maxConcurrencyKeyConcurrency, minLimits.maxConcurrencyKeyConcurrency, maxLimits.maxConcurrencyKeyConcurrency),
+        maxComputeConcurrency: clampAdaptiveRecord(value.maxComputeConcurrency, minLimits.maxComputeConcurrency, maxLimits.maxComputeConcurrency),
+        resourceQuotas: clampAdaptiveRecord(value.resourceQuotas, minLimits.resourceQuotas, maxLimits.resourceQuotas)
+    };
+}
+export function clampAdaptiveLimit(value, min, max) {
+    const upper = Math.max(1, Math.floor(max));
+    const lower = Math.min(upper, Math.max(1, Math.floor(min)));
+    return Math.min(upper, Math.max(lower, Math.floor(value)));
+}
+function mergeAdaptiveScheduleLimitInputs(left, right) {
+    return {
+        ...(right?.maxReadyJobs !== undefined ? { maxReadyJobs: right.maxReadyJobs } : left?.maxReadyJobs !== undefined ? { maxReadyJobs: left.maxReadyJobs } : {}),
+        maxLaneConcurrency: { ...(left?.maxLaneConcurrency ?? {}), ...(right?.maxLaneConcurrency ?? {}) },
+        maxConcurrencyKeyConcurrency: { ...(left?.maxConcurrencyKeyConcurrency ?? {}), ...(right?.maxConcurrencyKeyConcurrency ?? {}) },
+        maxComputeConcurrency: { ...(left?.maxComputeConcurrency ?? {}), ...(right?.maxComputeConcurrency ?? {}) },
+        resourceQuotas: { ...(left?.resourceQuotas ?? {}), ...(right?.resourceQuotas ?? {}) }
+    };
+}
+function normalizeAdaptiveLimitRecord(input = {}) {
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (positiveNumber(value))
+            out[key] = Math.max(1, Math.floor(value));
+    }
+    return out;
+}
+function clampAdaptiveRecord(value, minRecord, maxRecord) {
+    const keys = uniqueStrings([...Object.keys(value), ...Object.keys(minRecord), ...Object.keys(maxRecord)]);
+    const out = {};
+    for (const key of keys) {
+        const max = maxRecord[key];
+        if (!positiveNumber(max))
+            continue;
+        const min = minRecord[key] ?? 1;
+        out[key] = clampAdaptiveLimit(value[key] ?? max, min, max);
+    }
+    return out;
+}
+function adaptivePositiveLimit(value, fallback) {
+    return positiveNumber(value) ? Math.max(1, Math.floor(value)) : Math.max(1, Math.floor(fallback));
+}
+//# sourceMappingURL=adaptive-load-limits.js.map

package/dist/adaptive-load-limits.js.map

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

package/dist/adaptive-load-observations.d.ts

@@ -0,0 +1,16 @@
+import type { FrontierSwarmSchedule } from './scheduler.js';
+import type { FrontierSwarmCoordinatorDashboard } from './coordinator-dashboard-types.js';
+import type { FrontierSwarmAdaptiveDecisionTarget, FrontierSwarmAdaptiveObservation, FrontierSwarmAdaptiveObservationInput } from './adaptive-load-types.js';
+import type { FrontierSwarmMergeAdmission, FrontierSwarmMergeIndex, FrontierSwarmRun } from './index.js';
+export declare function normalizeAdaptiveObservations(input: readonly FrontierSwarmAdaptiveObservationInput[], generatedAt: number): FrontierSwarmAdaptiveObservation[];
+export declare function deriveAdaptiveScheduleObservations(schedule: FrontierSwarmSchedule | undefined, at: number): FrontierSwarmAdaptiveObservationInput[];
+export declare function deriveAdaptiveRunObservations(run: FrontierSwarmRun | undefined, at: number): FrontierSwarmAdaptiveObservationInput[];
+export declare function deriveAdaptiveMergeIndexObservations(index: FrontierSwarmMergeIndex | undefined, at: number): FrontierSwarmAdaptiveObservationInput[];
+export declare function deriveAdaptiveDashboardObservations(dashboard: FrontierSwarmCoordinatorDashboard | undefined, at: number): FrontierSwarmAdaptiveObservationInput[];
+export declare function deriveAdaptiveAdmissionObservations(admission: FrontierSwarmMergeAdmission | undefined, at: number): FrontierSwarmAdaptiveObservationInput[];
+export declare function adaptiveObservationShouldReduceReadyWindow(observation: FrontierSwarmAdaptiveObservation): boolean;
+export declare function adaptiveObservationIsCapacityBackpressure(observation: FrontierSwarmAdaptiveObservation): boolean;
+export declare function adaptiveDecisionTargetForObservation(observation: FrontierSwarmAdaptiveObservation): FrontierSwarmAdaptiveDecisionTarget;
+export declare function adaptiveDecisionKeyForObservation(observation: FrontierSwarmAdaptiveObservation): string | undefined;
+export declare function adaptiveObservationIsBottleneck(observation: FrontierSwarmAdaptiveObservation): boolean;
+//# sourceMappingURL=adaptive-load-observations.d.ts.map