@shapeshift-labs/frontier-swarm 0.5.19 → 0.5.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-swarm",
-  "version": "0.5.19",
+  "version": "0.5.21",
   "description": "Hierarchical swarm plans, lanes, compute profiles, ownership policy, events, and proofs for Frontier agent work.",
   "type": "module",
   "license": "MIT",
@@ -27,8 +27,7 @@
     "dist",
     "README.md",
     "LICENSE",
-    "benchmarks/package-bench.mjs",
-    "benchmarks/package-bench-*.mjs"
+    "benchmarks/package-bench.mjs"
   ],
   "engines": {
     "node": ">=18"
@@ -36,14 +35,13 @@
   "scripts": {
     "build": "node build.mjs",
     "test": "npm run build && npm run typecheck && node test/smoke.mjs && node test/fuzz.mjs --cases 700",
-    "prepack": "npm run lint && npm run readme:packages:check && npm run test",
+    "prepack": "npm run readme:packages:check && npm run test",
     "typecheck": "node build.mjs --typecheck",
     "fuzz": "npm run build && node test/fuzz.mjs",
     "bench": "npm run build && node --expose-gc benchmarks/package-bench.mjs --out benchmarks/results/frontier-swarm-package-bench-latest.json",
     "pack:dry": "npm pack --dry-run",
     "readme:packages": "node benchmarks/package-readme-sections.mjs",
-    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check",
-    "lint": "node scripts/strict-source-policy.mjs"
+    "readme:packages:check": "node benchmarks/package-readme-sections.mjs --check"
   },
   "keywords": [
     "frontier",

package/benchmarks/package-bench-fixtures.mjs

@@ -1,95 +0,0 @@
-import {
-  createSwarmMergeBundle,
-  createSwarmTraceShard
-} from '../dist/index.js';
-
-export function makeBenchManifest() {
-  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' }
-  };
-}
-
-export function makeBenchTasks(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;
-}
-
-export function makeBenchBundles(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;
-}
-
-export function makeBenchTraceBundles(plan, count, offset = 0) {
-  const bundles = [];
-  for (let i = 0; i < Math.min(count, plan.jobs.length); i += 1) {
-    const job = plan.jobs[(i + offset) % plan.jobs.length];
-    const region = `region.${i % 8}`;
-    const traceShard = createSwarmTraceShard({
-      jobId: job.id,
-      lane: job.lane,
-      subject: 'bench-trace',
-      rowWindows: [{ start: i * 10, end: i * 10 + 4, rowCount: 5, firstDivergenceAt: i % 5 === 0 ? i * 10 + 2 : undefined, deltaFields: ['state.value'] }],
-      hypotheses: [{ sourcePath: job.task.targetRefs[0], symbol: `benchSymbol${i}`, region, confidence: i % 5 === 0 ? 'high' : 'medium' }],
-      executableOwnershipRegions: [{
-        id: region,
-        sourcePath: job.task.targetRefs[0],
-        symbol: `benchSymbol${i}`,
-        selectors: [`${region}.*`],
-        affectedTests: ['node trace-gate.mjs'],
-        riskLevel: i % 5 === 0 ? 'medium' : 'low'
-      }],
-      focusedTests: ['node trace-gate.mjs'],
-      referenceEvidence: [{ path: `agent-runs/bench/${job.id}/reference-trace.jsonl`, kind: 'trace' }]
-    });
-    bundles.push(createSwarmMergeBundle({
-      job,
-      result: {
-        jobId: job.id,
-        status: 'verified',
-        changedPaths: [job.task.targetRefs[0] ?? `src/runtime/file-${i}.ts`],
-        changedRegions: [region],
-        verification: [{ status: 0 }]
-      },
-      patchPath: `agent-runs/bench/${job.id}/changes.patch`,
-      traceShards: [traceShard]
-    }));
-  }
-  return bundles;
-}

package/benchmarks/package-bench-rows.mjs

@@ -1,211 +0,0 @@
-import {
-  checkSwarmOwnership,
-  createSwarmAdaptiveLoadPlan,
-  createSwarmContextPack,
-  createSwarmHotspotReport,
-  createSwarmLanePlaybook,
-  createSwarmMergeAdmission,
-  createSwarmManifest,
-  createSwarmEventStream,
-  createSwarmLeases,
-  createSwarmMergeBundle,
-  createSwarmMergeIndex,
-  createSwarmOracleCorpus,
-  createSwarmPatchStackPlan,
-  createSwarmPayoffVector,
-  createSwarmReplayBundle,
-  createSwarmParityOracle,
-  createSwarmDivergenceReport,
-  createSwarmWatchpointPlan,
-  createSwarmDebugHandoff,
-  createSwarmEvidenceIndex,
-  createSwarmBlackboard,
-  createSwarmBottleneckReport,
-  createSwarmFixtureCatalog,
-  createSwarmProgressModel,
-  createSwarmPlan,
-  createSwarmProof,
-  createSwarmQueueOverlay,
-  createSwarmQueueSnapshot,
-  createSwarmRun,
-  createSwarmRunCheckpoint,
-  createSwarmSchedule,
-  createSwarmStrategyTournament,
-  createSwarmTraceIndex,
-  decodeSwarmJsonl,
-  defineSwarmTasks,
-  encodeSwarmJsonl,
-  querySwarmTraceIndex,
-  routeSwarmEventToMailboxes,
-  resolveSwarmCompute,
-  validateSwarmManifest
-} from '../dist/index.js';
-import {
-  makeBenchBundles,
-  makeBenchManifest,
-  makeBenchTasks,
-  makeBenchTraceBundles
-} from './package-bench-fixtures.mjs';
-
-export function createPackageBenchRows({ taskCount, measure }) {
-  const manifest = createSwarmManifest(makeBenchManifest());
-  const tasks = defineSwarmTasks(makeBenchTasks(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 = makeBenchBundles(plan, 32);
-  let mergeIndex = createSwarmMergeIndex({ bundles });
-
-  return [
-    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 = makeBenchBundles(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('trace-index-' + taskCount, 16, () => {
-      const traceBundles = makeBenchTraceBundles(plan, 24, cursor++);
-      const traceIndex = createSwarmTraceIndex({ bundles: traceBundles, generatedAt: 7000 + cursor++ });
-      const query = querySwarmTraceIndex(traceIndex, { region: 'region.2', textIncludes: 'benchSymbol' });
-      return traceIndex.summary.shardCount + traceIndex.summary.executableOwnershipRegionCount + query.summary.shardCount;
-    }),
-    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('strategy-tournament-' + taskCount, 16, () => createSwarmStrategyTournament({
-      strategies: [{ id: 'search' }, { id: 'verify' }, { id: 'review' }],
-      games: [{ id: 'merge-admission' }, { id: 'projection-route' }],
-      matches: Array.from({ length: 24 }, (_, index) => ({
-        payoff: createSwarmPayoffVector({
-          strategyId: ['search', 'verify', 'review'][index % 3],
-          gameId: index % 2 === 0 ? 'merge-admission' : 'projection-route',
-          outcome: index % 5 === 0 ? 'undefined' : index % 3 === 0 ? 'candidate' : 'verified',
-          components: {
-            correctness: (index % 10) / 10,
-            evidence: ((index + 3) % 10) / 10,
-            reviewCost: { value: ((index + 5) % 10) / 10, direction: 'minimize', weight: 0.5 }
-          },
-          search: { attempts: index + 1, durationMs: 1000 + index * 10, tokens: 2000 + index * 100 },
-          certificate: { commands: ['npm test'], durationMs: 500 + index }
-        })
-      })),
-      generatedAt: 9000 + cursor++
-    }).standings.length),
-    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;
-    })
-  ];
-}

package/benchmarks/package-bench-runtime.mjs

@@ -1,94 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { performance } from 'node:perf_hooks';
-import { fileURLToPath } from 'node:url';
-
-export function createPackageBenchPaths(metaUrl) {
-  const dirname = path.dirname(fileURLToPath(metaUrl));
-  const packageDir = path.resolve(dirname, '..');
-  return {
-    packageDir,
-    repoRoot: path.basename(path.dirname(packageDir)) === 'packages'
-      ? path.resolve(packageDir, '..', '..')
-      : packageDir
-  };
-}
-
-export function createMeasure(rounds) {
-  return 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
-    };
-  };
-}
-
-export 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;
-}
-
-export function readPositiveInt(value, fallback) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
-}
-
-export function resolveOutPath(repoRoot, out) {
-  return out ? path.resolve(repoRoot, out) : null;
-}
-
-export function readPackageVersion(packageDir) {
-  return JSON.parse(fs.readFileSync(path.join(packageDir, 'package.json'), 'utf8')).version;
-}
-
-export function writeBenchReport(report, outPath) {
-  if (!outPath) return;
-  fs.mkdirSync(path.dirname(outPath), { recursive: true });
-  fs.writeFileSync(outPath, JSON.stringify(report, null, 2) + '\n');
-}
-
-export function printBenchReport(report, { outPath, repoRoot }) {
-  console.log(report.package + ' package benchmark');
-  console.log('Node ' + report.node + ' on ' + report.platform + ', tasks=' + report.taskCount + ', rounds=' + report.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 report.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));
-}
-
-export 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 percentile(sorted, pct) {
-  return sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * pct))];
-}

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

@@ -1,8 +0,0 @@
-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[], options?: {
-    increaseReadyWindow?: boolean;
-}): 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

@@ -1 +0,0 @@
-{"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,EAC9C,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,IAAI,CAuBN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,iCAAiC,EAAE,IAAI,CAAC,GAAG,iCAAiC,CAK9H"}

package/dist/adaptive-load-decisions.js

@@ -1,133 +0,0 @@
-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, options = {}) {
-    if (options.increaseReadyWindow !== false && 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');
-    }
-    if (observation.concurrencyKey) {
-        increaseAdaptiveRecordLimit(limits.maxConcurrencyKeyConcurrency, maxLimits.maxConcurrencyKeyConcurrency, observation.concurrencyKey, observation, decisions, 'concurrency-key');
-    }
-}
-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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}