@shapeshift-labs/frontier-swarm-codex 0.2.0 → 0.4.0

package/README.md

@@ -4,7 +4,7 @@ Node Codex CLI runner adapter for Frontier swarm plans.
 
 `frontier-swarm-codex` executes `@shapeshift-labs/frontier-swarm` plans with the Codex CLI. It owns Node process spawning, prompt rendering, worktree/snapshot workspace setup, command shaping, JSONL output capture, last-message capture, optional verification commands, changed-path ownership checks, and swarm result/proof artifacts.
 
-The default Codex compute profile is `gpt-5.5` with `model_reasoning_effort="xhigh"`. The pure `frontier-swarm` package stays runtime-neutral.
+The default swarm compute profile records `gpt-5.5` with `model_reasoning_effort="xhigh"` for planning. The Codex CLI invocation defaults to the local Codex config instead of forwarding planned model flags, because model availability and accepted flag values vary by Codex binary and account. Pass `--model ...`, `--model-policy plan`, or `modelPolicy: 'plan'` when a runner should force the planned profile. The pure `frontier-swarm` package stays runtime-neutral.
 
 
 ## Related Packages
@@ -38,7 +38,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-workflow`](https://www.npmjs.com/package/@shapeshift-labs/frontier-workflow): Serializable durable workflow/process manifests for Frontier apps, including steps, waits, approvals, timers, retries, expected patches, compensation, records, timelines, and registry graph output.
 - [`@shapeshift-labs/frontier-worker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-worker): Serializable worker and edge task descriptors for Frontier apps, including queues, idempotency keys, retry and timeout policy, declared reads/writes/effects, snapshots, patch outputs, produced assets, execution records, logs, trace links, proof hashes, dedupe indexes, and registry graph output.
 - [`@shapeshift-labs/frontier-queue`](https://www.npmjs.com/package/@shapeshift-labs/frontier-queue): Serializable durable queue state, leases, retries, dedupe keys, patch-carrying jobs, dead-letter records, replay evidence, and queue inspection for Frontier apps.
-- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, task queues, event streams, run records, changed-path checks, and proof artifacts for Frontier agent work.
+- [`@shapeshift-labs/frontier-swarm`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm): Hierarchical swarm plans, lanes, compute profiles, ownership policy, semantic ownership regions, task queues, event streams, run records, merge bundles, merge indexes, queue overlays, merge admission, changed-path checks, and proof artifacts for Frontier agent work.
 - [`@shapeshift-labs/frontier-kv`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv): Serializable in-memory key/value state for Frontier apps, including TTL, versioned compare-and-set, batched patch mutations, scans, watchers, snapshots, JSONL event evidence, and replay verification.
 - [`@shapeshift-labs/frontier-kv-locks`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv-locks): Lease-style lock records on top of Frontier KV, including acquire, renew, release, fencing tokens, expiration, owner evidence, and replayable lock events.
 - [`@shapeshift-labs/frontier-kv-rate-limit`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv-rate-limit): Patch-native rate limit buckets for Frontier KV, including fixed windows, sliding windows, token buckets, deterministic refill, consume evidence, and reset records.
@@ -184,6 +184,13 @@ frontier-swarm-codex run \
   --link-path packages \
   --link-node-modules true \
   --sandbox workspace-write
+
+frontier-swarm stop --run agent-runs/codex-swarm/run-1
+
+frontier-swarm collect \
+  --run agent-runs/codex-swarm/run-1 \
+  --outDir agent-runs/codex-swarm/run-1/collected \
+  --branch-prefix codex/swarm-slice
 ```
 
 ## API
@@ -199,6 +206,7 @@ const plan = createCodexSwarmPlan({ manifest, tasks });
 await runCodexSwarm(plan, {
   outDir: 'agent-runs/codex-swarm/run-1',
   maxConcurrency: 4,
+  modelPolicy: 'config-default',
   workspace: {
     mode: 'copy',
     root: '../agent-workspaces',
@@ -211,6 +219,10 @@ await runCodexSwarm(plan, {
 });
 ```
 
+App-specific adapters should keep orchestration inside this package and use hooks for local policy. `prepareJobWorkspace` can link generated package artifacts or shared fixtures, `renderJobPrompt` can append product-specific migration rules, `changedPathFilter` can hide runner-owned symlinks from ownership checks, and `onJobStarted`/`onJobFinished`/`onSwarmFinished` can mirror lifecycle records into project-specific JSONL streams.
+
+Use `modelPolicy: 'config-default'` for portable swarms that should respect each machine's Codex config. Use `modelPolicy: 'plan'` only when the installed Codex CLI and account are known to accept the planned model IDs. `approval: 'full-auto'` and `--approval-policy full-auto` are normalized to the current `--ask-for-approval never` spelling.
+
 ## Minimal Repro Workspaces
 
 Large monorepos do not need one full git worktree per worker. The adapter supports four workspace modes:
@@ -220,24 +232,46 @@ Large monorepos do not need one full git worktree per worker. The adapter suppor
 - `copy`: create a minimal copied workspace from declared includes, task `files`, `sourceRefs`, `targetRefs`, and task `snapshotIncludes`.
 - `snapshot`: same minimal-copy mechanics with snapshot-oriented naming for legacy SNES-style task manifests.
 
-For `copy` and `snapshot`, the runner excludes heavy paths by default (`.git`, `node_modules`, `dist`, coverage, agent-runs, ROM/test artifacts) and passes `--skip-git-repo-check` to Codex. It snapshots the copied workspace before and after execution so changed-path ownership checks still work without git metadata. Use `linkPaths` for heavy shared directories such as `packages`, corpora, ROMs, or research checkouts that should not be duplicated. Task JSON may also declare `snapshotIncludes`, `snapshotExcludes`, `snapshotArtifactIncludes`, and `snapshotLinkPaths`.
+For `copy` and `snapshot`, the runner excludes heavy paths by default (`.git`, `node_modules`, `dist`, coverage, agent-runs, ROM/test artifacts) and passes `--skip-git-repo-check` to Codex. It snapshots the copied workspace before and after execution so changed-path ownership checks still work without git metadata. Runner-owned artifacts are recorded in `workspace-proof.json` and filtered out of ownership checks, which keeps parent dirty files and copied workspace logs from falsely failing useful workers. Each job also writes `changes.patch` when a patch can be derived and `merge.json` with the touched owned files, evidence paths, verification results, queue item IDs, risk, and merge disposition. Use `linkPaths` for heavy shared directories such as `packages`, corpora, ROMs, or research checkouts that should not be duplicated. Task JSON may also declare `snapshotIncludes`, `snapshotExcludes`, `snapshotArtifactIncludes`, `snapshotLinkPaths`, `requiredIncludes`, and `optionalIncludes`.
 
 ## Scalable Scheduling
 
-`runCodexSwarm` uses `@shapeshift-labs/frontier-swarm` schedules and leases internally. Jobs become runnable only when their dependency DAG is satisfied, lane/compute/contention limits have capacity, and a lease can be issued for the local Codex worker. This keeps the public runner simple while making the execution model compatible with much larger queues and external lease-backed workers.
+`runCodexSwarm` uses `@shapeshift-labs/frontier-swarm` schedules and leases internally. Jobs become runnable only when their dependency DAG is satisfied, lane/compute/contention limits have capacity, and a lease can be issued for the local Codex worker. Browser lanes can declare capabilities, port pools, profile directory prefixes, and lower lane concurrency in the upstream swarm manifest. This keeps the public runner simple while making the execution model compatible with much larger queues and external lease-backed workers.
 
 Task JSON may declare `dependsOn`, `concurrencyKey`, `budget`, and `review`; the adapter carries those fields into the compiled plan and prompt.
 
+Each run writes event streams under `streams/`, a `coordinator-dashboard.json` snapshot, `pids.json`, workspace proofs, patch files, merge bundles, and job results with merge-readiness classification. `frontier-swarm stop --run <run-dir>` reads the pid manifest and terminates live worker processes without manually hunting process state.
+
+`frontier-swarm collect --run <run-dir>` derives status from immutable worker overlays instead of asking workers to edit a central queue. It scans `merge.json` files and writes:
+
+- `ready-to-apply/` for auto-mergeable verified slices,
+- `needs-human-port/` for patch candidates and discovery-only results,
+- `failed-evidence/` for failed workers, blockers, ownership violations, or failed required commands,
+- `stale-against-head/` for patch bundles that no longer apply.
+
+It also writes `merge-index.json` and `queue-overlay.json` so coordinator dashboards can show stale patches, conflicts, derived queue status, and ready merge pressure without scraping every worker directory. The optional `--branch-prefix` adds suggested tiny patch branch names to each collected bundle so accepted slices can become one small branch/commit per surface, evidence path, and queue status overlay.
+
+`frontier-swarm apply --collection <collection-dir>` reviews the `ready-to-apply/` bucket and writes `apply-ledger.json`. It defaults to `--dry-run`, which runs `git apply --check` without mutating the checkout. Non-dry-run apply refuses a dirty worktree unless `--allow-dirty` is passed, and can optionally create small branches with `--branch-prefix` and commits with `--commit`.
+
+`frontier-swarm score --collection <collection-dir>` applies each collected bundle in a throwaway workspace and writes `patch-score.json`. Use `--focused-command` for the gate that proves the slice and `--global-command` with `--global-glob` for shared-code smoke/type/build gates. Scores are classified as `accepted-clean`, `accepted-needs-port`, `conflict`, `test-fail`, `stale`, or `evidence-only`, so the coordinator can review the best patch candidates before manually reading every bundle.
+
 ## Surface
 
 - `createCodexSwarmPlan`
 - `coerceCodexSwarmManifestInput`
 - `coerceCodexSwarmTasksInput`
 - `createCodexWorkspacePlan`
+- `createSwarmWorkspaceManifest`, `createSwarmWorkspaceProof`
 - `prepareCodexWorkspace`
 - `runCodexSwarm`
 - `runCodexJob`
 - `buildCodexArgs`
+- `normalizeCodexModelFlag`, `normalizeCodexApprovalPolicy`
+- `initFileSwarmEventStream`, `appendFileSwarmEvent`, `writeSwarmCoordinatorSnapshot`
+- `appendCodexPidManifest`, `readCodexPidManifest`, `stopCodexSwarmRun`
+- `collectCodexSwarmRun`
+- `applyCodexSwarmCollection`
+- `scoreCodexSwarmPatches`
 - `renderCodexPrompt`
 - `spawnCodexExecutor`
 
@@ -249,7 +283,7 @@ Run the package-local benchmark:
 npm run bench
 ```
 
-The benchmark writes `benchmarks/results/frontier-swarm-codex-package-bench-latest.json` when run from the monorepo. These are Frontier-only package measurements for input coercion, Codex argument construction, and prompt rendering.
+The benchmark writes `benchmarks/results/frontier-swarm-codex-package-bench-latest.json` when run from the monorepo. These are Frontier-only package measurements for input coercion, Codex argument construction, model/approval compatibility normalization, workspace manifest creation, and prompt rendering.
 
 ## Source Repository
 

package/benchmarks/package-bench.mjs

@@ -5,6 +5,10 @@ import { fileURLToPath } from 'node:url';
 import {
   buildCodexArgs,
   createCodexSwarmPlan,
+  createCodexWorkspacePlan,
+  createSwarmWorkspaceManifest,
+  normalizeCodexApprovalPolicy,
+  normalizeCodexModelFlag,
   renderCodexPrompt
 } from '../dist/index.js';
 
@@ -27,7 +31,11 @@ const paths = {
   eventsPath: 'events.jsonl',
   stderrPath: 'stderr.log',
   lastMessagePath: 'last.md',
-  evidenceDir: 'evidence'
+  evidenceDir: 'evidence',
+  workspaceProofPath: 'workspace-proof.json',
+  patchPath: 'changes.patch',
+  mergeBundlePath: 'merge.json',
+  pidManifestPath: 'pids.json'
 };
 
 const rows = [
@@ -35,7 +43,16 @@ const rows = [
     plan = createCodexSwarmPlan(input);
     return plan.jobs.length;
   }),
-  measure('build-args-' + taskCount, 64, () => buildCodexArgs(plan.jobs[cursor++ % plan.jobs.length], { outDir: '.', workspacePath: '.', paths }).length),
+  measure('build-args-config-default-' + taskCount, 64, () => buildCodexArgs(plan.jobs[cursor++ % plan.jobs.length], { outDir: '.', workspacePath: '.', paths }).length),
+  measure('build-args-plan-model-' + taskCount, 64, () => buildCodexArgs(plan.jobs[cursor++ % plan.jobs.length], { outDir: '.', workspacePath: '.', paths, modelPolicy: 'plan', approval: 'full-auto' }).length),
+  measure('workspace-manifest-' + taskCount, 32, () => {
+    const workspacePlan = createCodexWorkspacePlan(plan.jobs[cursor++ % plan.jobs.length], {
+      outDir: '.',
+      workspace: { mode: 'copy', includes: ['AGENTS.md', 'package.json'], linkPaths: ['packages'], linkNodeModules: true }
+    });
+    return createSwarmWorkspaceManifest(workspacePlan).includeCount;
+  }),
+  measure('compat-normalize', 256, () => (normalizeCodexModelFlag('default') ? 1 : 0) + normalizeCodexApprovalPolicy('full-auto').length),
   measure('render-prompt-' + taskCount, 32, () => renderCodexPrompt(plan.jobs[cursor++ % plan.jobs.length], { workspacePath: '.', paths }).length)
 ];
 

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { coerceCodexSwarmManifestInput, coerceCodexSwarmTasksInput, createCodexSwarmPlan, runCodexSwarm } from './index.js';
+import { applyCodexSwarmCollection, coerceCodexSwarmManifestInput, coerceCodexSwarmTasksInput, collectCodexSwarmRun, createCodexSwarmPlan, runCodexSwarm, scoreCodexSwarmPatches, stopCodexSwarmRun } from './index.js';
 const args = parseArgs(process.argv.slice(2));
 const command = args._[0] ?? 'plan';
 try {
@@ -20,8 +20,11 @@ try {
             codexPath: stringArg(args.codex),
             maxConcurrency: numberArg(args.maxConcurrency ?? args['max-concurrency'], 1),
             sandbox: stringArg(args.sandbox),
-            approval: stringArg(args.approval ?? args['ask-for-approval']),
+            approval: stringArg(args.approval ?? args['ask-for-approval'] ?? args['approval-policy']),
             model: stringArg(args.model),
+            modelPolicy: modelPolicyArg(args.modelPolicy ?? args['model-policy']),
+            forwardPlanModel: boolArg(args.forwardPlanModel ?? args['forward-plan-model'], false),
+            forwardPlanReasoningEffort: boolArg(args.forwardPlanReasoningEffort ?? args['forward-plan-reasoning-effort'], false),
             reasoningEffort: stringArg(args.reasoningEffort ?? args['reasoning-effort']),
             profile: stringArg(args.profile),
             dryRun: boolArg(args.dryRun ?? args['dry-run'], false),
@@ -53,6 +56,66 @@ try {
         if (!ok)
             process.exitCode = 1;
     }
+    else if (command === 'stop') {
+        const run = String(args.run ?? args.pidManifest ?? args['pid-manifest'] ?? '');
+        if (!run)
+            throw new Error('stop requires --run <run-dir|swarm-results.json|pids.json>');
+        const signal = String(args.signal ?? 'SIGTERM');
+        const result = await stopCodexSwarmRun({ run, signal });
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.ok)
+            process.exitCode = 1;
+    }
+    else if (command === 'collect') {
+        const run = String(args.run ?? '');
+        if (!run)
+            throw new Error('collect requires --run <run-dir|swarm-results.json>');
+        const result = await collectCodexSwarmRun({
+            run,
+            outDir: stringArg(args.outDir ?? args.out),
+            checkStale: boolArg(args.checkStale ?? args['check-stale'], true),
+            branchPrefix: stringArg(args.branchPrefix ?? args['branch-prefix'])
+        });
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.ok)
+            process.exitCode = 1;
+    }
+    else if (command === 'apply') {
+        const result = await applyCodexSwarmCollection({
+            collection: stringArg(args.collection),
+            run: stringArg(args.run),
+            outDir: stringArg(args.outDir ?? args.out),
+            bucket: bucketArg(args.bucket),
+            jobIds: listArg(args.job ?? args.jobId ?? args['job-id']),
+            dryRun: boolArg(args.dryRun ?? args['dry-run'], true),
+            allowDirty: boolArg(args.allowDirty ?? args['allow-dirty'], false),
+            commit: boolArg(args.commit, false),
+            branchPrefix: stringArg(args.branchPrefix ?? args['branch-prefix']),
+            limit: numberArg(args.limit, undefined)
+        });
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.ok)
+            process.exitCode = 1;
+    }
+    else if (command === 'score') {
+        const result = await scoreCodexSwarmPatches({
+            collection: stringArg(args.collection),
+            run: stringArg(args.run),
+            outDir: stringArg(args.outDir ?? args.out),
+            bucket: bucketArg(args.bucket),
+            jobIds: listArg(args.job ?? args.jobId ?? args['job-id']),
+            workspaceIncludes: listArg(args.include),
+            workspaceExcludes: listArg(args.exclude),
+            focusedCommands: commandListArg(args.focusedCommand ?? args['focused-command']),
+            globalCommands: commandListArg(args.globalCommand ?? args['global-command']),
+            globalGlobs: listArg(args.globalGlob ?? args['global-glob']),
+            limit: numberArg(args.limit, undefined),
+            keepWorkspaces: boolArg(args.keepWorkspaces ?? args['keep-workspaces'], false)
+        });
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.ok)
+            process.exitCode = 1;
+    }
     else {
         throw new Error(`unknown command: ${command}`);
     }
@@ -118,12 +181,34 @@ function numberArg(value, fallback) {
 function stringArg(value) {
     return typeof value === 'string' && value.length > 0 ? value : undefined;
 }
+function modelPolicyArg(value) {
+    const policy = stringArg(value);
+    if (policy === undefined)
+        return undefined;
+    if (policy === 'config-default' || policy === 'plan' || policy === 'explicit')
+        return policy;
+    throw new Error(`unsupported --model-policy ${policy}; expected config-default, plan, or explicit`);
+}
 function readWorkspaceMode(value) {
     const mode = stringArg(value);
     if (mode === 'snapshot' || mode === 'copy' || mode === 'git-worktree')
         return mode;
     return 'current';
 }
+function bucketArg(value) {
+    const bucket = stringArg(value);
+    if (bucket === undefined)
+        return undefined;
+    if (bucket === 'all' || bucket === 'ready-to-apply' || bucket === 'needs-human-port' || bucket === 'failed-evidence' || bucket === 'stale-against-head')
+        return bucket;
+    throw new Error(`unsupported --bucket ${bucket}`);
+}
+function commandListArg(value) {
+    if (value === undefined)
+        return undefined;
+    const raw = Array.isArray(value) ? value : [String(value)];
+    return raw.map((command) => command.trim()).filter(Boolean).map((command) => ({ name: command, command: 'sh', args: ['-c', command], required: true }));
+}
 function boolArg(value, fallback) {
     if (value === undefined)
         return fallback;

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,19 @@
-import { createSwarmProof, type FrontierSwarmJob, type FrontierSwarmJobResultInput, type FrontierSwarmLease, type FrontierSwarmManifestInput, type FrontierSwarmPlan, type FrontierSwarmPlanInput, type FrontierSwarmRun, type FrontierSwarmTaskInput } from '@shapeshift-labs/frontier-swarm';
+import { createSwarmProof, type FrontierSwarmCommand, type FrontierSwarmEventInput, type FrontierSwarmEventStream, type FrontierSwarmJob, type FrontierSwarmJobResultInput, type FrontierSwarmMergeBundle, type FrontierSwarmMergeIndex, type FrontierSwarmLease, type FrontierSwarmManifestInput, type FrontierSwarmPlan, type FrontierSwarmPlanInput, type FrontierSwarmQueueOverlay, type FrontierSwarmRun, type FrontierSwarmTaskInput } from '@shapeshift-labs/frontier-swarm';
 export declare const FRONTIER_SWARM_CODEX_DEFAULT_MODEL = "gpt-5.5";
 export declare const FRONTIER_SWARM_CODEX_DEFAULT_REASONING_EFFORT = "xhigh";
+export declare const FRONTIER_SWARM_CODEX_WORKSPACE_MANIFEST_KIND = "frontier.swarm-codex.workspace-manifest";
+export declare const FRONTIER_SWARM_CODEX_WORKSPACE_MANIFEST_VERSION = 1;
+export declare const FRONTIER_SWARM_CODEX_WORKSPACE_PROOF_KIND = "frontier.swarm-codex.workspace-proof";
+export declare const FRONTIER_SWARM_CODEX_WORKSPACE_PROOF_VERSION = 1;
+export declare const FRONTIER_SWARM_CODEX_PID_MANIFEST_KIND = "frontier.swarm-codex.pid-manifest";
+export declare const FRONTIER_SWARM_CODEX_PID_MANIFEST_VERSION = 1;
+export declare const FRONTIER_SWARM_CODEX_COLLECTION_KIND = "frontier.swarm-codex.collection";
+export declare const FRONTIER_SWARM_CODEX_COLLECTION_VERSION = 1;
+export declare const FRONTIER_SWARM_CODEX_APPLY_LEDGER_KIND = "frontier.swarm-codex.apply-ledger";
+export declare const FRONTIER_SWARM_CODEX_APPLY_LEDGER_VERSION = 1;
+export declare const FRONTIER_SWARM_CODEX_PATCH_SCORE_KIND = "frontier.swarm-codex.patch-score";
+export declare const FRONTIER_SWARM_CODEX_PATCH_SCORE_VERSION = 1;
+export type FrontierCodexModelPolicy = 'config-default' | 'plan' | 'explicit';
 export type FrontierCodexSwarmWorkspaceMode = 'current' | 'git-worktree' | 'snapshot' | 'copy';
 export interface FrontierCodexSwarmWorkspaceInput {
     mode?: FrontierCodexSwarmWorkspaceMode;
@@ -11,6 +24,10 @@ export interface FrontierCodexSwarmWorkspaceInput {
     excludes?: readonly string[];
     artifactIncludes?: readonly string[];
     linkPaths?: readonly string[];
+    requiredIncludes?: readonly string[];
+    optionalIncludes?: readonly string[];
+    strategy?: 'fs-cp' | 'rsync' | 'git-archive' | string;
+    guardRoot?: string;
     linkNodeModules?: boolean;
     skipGitRepoCheck?: boolean;
 }
@@ -21,9 +38,12 @@ export interface FrontierCodexSwarmRunOptions {
     maxConcurrency?: number;
     workspace?: FrontierCodexSwarmWorkspaceInput;
     sandbox?: string;
-    approval?: string;
-    model?: string;
-    reasoningEffort?: string;
+    approval?: string | false;
+    model?: string | false;
+    modelPolicy?: FrontierCodexModelPolicy;
+    forwardPlanModel?: boolean;
+    forwardPlanReasoningEffort?: boolean;
+    reasoningEffort?: string | false;
     profile?: string;
     ephemeral?: boolean;
     dryRun?: boolean;
@@ -32,6 +52,15 @@ export interface FrontierCodexSwarmRunOptions {
     jobTimeoutMs?: number;
     addDirs?: readonly string[];
     executor?: FrontierCodexExecutor;
+    eventStream?: FrontierSwarmEventStream;
+    coordinatorSnapshotPath?: string;
+    pidManifestPath?: string;
+    prepareJobWorkspace?: FrontierCodexJobWorkspaceHook;
+    renderJobPrompt?: FrontierCodexJobPromptHook;
+    changedPathFilter?: FrontierCodexChangedPathFilter;
+    onJobStarted?: FrontierCodexJobStartedHook;
+    onJobFinished?: FrontierCodexJobFinishedHook;
+    onSwarmFinished?: FrontierCodexSwarmFinishedHook;
 }
 export interface FrontierCodexWorkspacePlan {
     mode: FrontierCodexSwarmWorkspaceMode;
@@ -41,6 +70,10 @@ export interface FrontierCodexWorkspacePlan {
     excludes: string[];
     artifactIncludes: string[];
     linkPaths: string[];
+    requiredIncludes: string[];
+    optionalIncludes: string[];
+    strategy: string;
+    guardRoot?: string;
     linkNodeModules: boolean;
     replace: boolean;
     skipGitRepoCheck: boolean;
@@ -52,6 +85,195 @@ export interface FrontierCodexJobPaths {
     stderrPath: string;
     lastMessagePath: string;
     evidenceDir: string;
+    workspaceProofPath: string;
+    patchPath: string;
+    mergeBundlePath: string;
+    pidManifestPath: string;
+}
+export type FrontierCodexCollectBucket = 'ready-to-apply' | 'needs-human-port' | 'failed-evidence' | 'stale-against-head';
+export interface FrontierCodexCollectInput {
+    run: string;
+    outDir?: string;
+    cwd?: string;
+    checkStale?: boolean;
+    branchPrefix?: string;
+}
+export interface FrontierCodexCollectedBundle {
+    bucket: FrontierCodexCollectBucket;
+    jobId: string;
+    mergePath: string;
+    outputDir: string;
+    bundle: FrontierSwarmMergeBundle;
+}
+export interface FrontierCodexCollectResult {
+    kind: typeof FRONTIER_SWARM_CODEX_COLLECTION_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_COLLECTION_VERSION;
+    ok: boolean;
+    runDir: string;
+    outDir: string;
+    generatedAt: number;
+    buckets: Record<FrontierCodexCollectBucket, FrontierCodexCollectedBundle[]>;
+    mergeIndex: FrontierSwarmMergeIndex;
+    queueOverlay: FrontierSwarmQueueOverlay;
+    summary: Record<FrontierCodexCollectBucket, number> & {
+        total: number;
+    };
+}
+export type FrontierCodexApplyStatus = 'checked' | 'applied' | 'committed' | 'skipped' | 'failed';
+export interface FrontierCodexApplyInput {
+    collection?: string;
+    run?: string;
+    outDir?: string;
+    cwd?: string;
+    bucket?: FrontierCodexCollectBucket | 'all';
+    jobIds?: readonly string[];
+    dryRun?: boolean;
+    allowDirty?: boolean;
+    commit?: boolean;
+    branchPrefix?: string;
+    limit?: number;
+}
+export interface FrontierCodexApplyEntry {
+    jobId: string;
+    status: FrontierCodexApplyStatus;
+    bundlePath: string;
+    patchPath?: string;
+    branchName?: string;
+    commit?: string;
+    dryRun: boolean;
+    commands: Array<{
+        command: string[];
+        status: number;
+        stdoutTail: string[];
+        stderrTail: string[];
+    }>;
+    error?: string;
+}
+export interface FrontierCodexApplyResult {
+    kind: typeof FRONTIER_SWARM_CODEX_APPLY_LEDGER_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_APPLY_LEDGER_VERSION;
+    ok: boolean;
+    cwd: string;
+    collectionDir: string;
+    outDir: string;
+    generatedAt: number;
+    dryRun: boolean;
+    entries: FrontierCodexApplyEntry[];
+    summary: {
+        total: number;
+        checked: number;
+        applied: number;
+        committed: number;
+        skipped: number;
+        failed: number;
+    };
+}
+export type FrontierCodexPatchScoreStatus = 'accepted-clean' | 'accepted-needs-port' | 'conflict' | 'test-fail' | 'stale' | 'evidence-only';
+export interface FrontierCodexPatchScoreInput {
+    collection?: string;
+    run?: string;
+    outDir?: string;
+    cwd?: string;
+    bucket?: FrontierCodexCollectBucket | 'all';
+    jobIds?: readonly string[];
+    workspaceIncludes?: readonly string[];
+    workspaceExcludes?: readonly string[];
+    focusedCommands?: readonly (string | FrontierSwarmCommand)[];
+    globalCommands?: readonly (string | FrontierSwarmCommand)[];
+    globalGlobs?: readonly string[];
+    limit?: number;
+    keepWorkspaces?: boolean;
+}
+export interface FrontierCodexPatchScoreEntry {
+    jobId: string;
+    status: FrontierCodexPatchScoreStatus;
+    score: number;
+    bundlePath: string;
+    patchPath?: string;
+    workspacePath?: string;
+    changedPaths: string[];
+    reasons: string[];
+    commands: Array<{
+        command: string[];
+        status: number;
+        stdoutTail: string[];
+        stderrTail: string[];
+    }>;
+}
+export interface FrontierCodexPatchScoreResult {
+    kind: typeof FRONTIER_SWARM_CODEX_PATCH_SCORE_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_PATCH_SCORE_VERSION;
+    ok: boolean;
+    cwd: string;
+    collectionDir: string;
+    outDir: string;
+    generatedAt: number;
+    entries: FrontierCodexPatchScoreEntry[];
+    summary: Record<FrontierCodexPatchScoreStatus, number> & {
+        total: number;
+    };
+}
+export interface FrontierCodexWorkspaceManifest {
+    kind: typeof FRONTIER_SWARM_CODEX_WORKSPACE_MANIFEST_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_WORKSPACE_MANIFEST_VERSION;
+    id: string;
+    mode: FrontierCodexSwarmWorkspaceMode;
+    root: string;
+    path: string;
+    includes: string[];
+    excludes: string[];
+    artifactIncludes: string[];
+    linkPaths: string[];
+    requiredIncludes: string[];
+    optionalIncludes: string[];
+    strategy: string;
+    guardRoot?: string;
+    linkNodeModules: boolean;
+    skipGitRepoCheck: boolean;
+}
+export interface FrontierCodexWorkspaceProof {
+    kind: typeof FRONTIER_SWARM_CODEX_WORKSPACE_PROOF_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_WORKSPACE_PROOF_VERSION;
+    id: string;
+    generatedAt: number;
+    manifest: FrontierCodexWorkspaceManifest;
+    copiedPaths: string[];
+    linkedPaths: string[];
+    missingRequired: string[];
+    missingOptional: string[];
+    ignoredChangedPaths: string[];
+    summary: {
+        copiedCount: number;
+        linkedCount: number;
+        missingRequiredCount: number;
+        missingOptionalCount: number;
+        ignoredChangedPathCount: number;
+    };
+}
+export interface FrontierCodexPidEntry {
+    pid: number;
+    role: 'parent' | 'codex' | string;
+    runId?: string;
+    jobId?: string;
+    startedAt: number;
+    command?: string[];
+}
+export interface FrontierCodexPidManifest {
+    kind: typeof FRONTIER_SWARM_CODEX_PID_MANIFEST_KIND;
+    version: typeof FRONTIER_SWARM_CODEX_PID_MANIFEST_VERSION;
+    runId?: string;
+    entries: FrontierCodexPidEntry[];
+}
+export interface FrontierCodexStopResult {
+    ok: boolean;
+    pidManifestPath: string;
+    signal: NodeJS.Signals;
+    stopped: number[];
+    missing: number[];
+    errors: Array<{
+        pid: number;
+        error: string;
+    }>;
 }
 export interface FrontierCodexExecutorInput {
     job: FrontierSwarmJob;
@@ -71,6 +293,34 @@ export interface FrontierCodexExecutorResult {
     error?: unknown;
 }
 export type FrontierCodexExecutor = (input: FrontierCodexExecutorInput) => Promise<FrontierCodexExecutorResult>;
+export interface FrontierCodexJobHookInput {
+    job: FrontierSwarmJob;
+    cwd: string;
+    outDir: string;
+    workspacePath: string;
+    workspacePlan: FrontierCodexWorkspacePlan;
+    paths: FrontierCodexJobPaths;
+}
+export interface FrontierCodexJobPromptHookInput extends FrontierCodexJobHookInput {
+    prompt: string;
+}
+export interface FrontierCodexJobStartedHookInput extends FrontierCodexJobHookInput {
+    prompt: string;
+    args: string[];
+}
+export interface FrontierCodexJobFinishedHookInput {
+    job: FrontierSwarmJob;
+    result: FrontierSwarmJobResultInput;
+}
+export interface FrontierCodexSwarmFinishedHookInput {
+    result: FrontierCodexSwarmRunResult;
+}
+export type FrontierCodexJobWorkspaceHook = (input: FrontierCodexJobHookInput) => Promise<void> | void;
+export type FrontierCodexJobPromptHook = (input: FrontierCodexJobPromptHookInput) => Promise<string> | string;
+export type FrontierCodexChangedPathFilter = (paths: readonly string[], input: FrontierCodexJobHookInput) => readonly string[];
+export type FrontierCodexJobStartedHook = (input: FrontierCodexJobStartedHookInput) => Promise<void> | void;
+export type FrontierCodexJobFinishedHook = (input: FrontierCodexJobFinishedHookInput) => Promise<void> | void;
+export type FrontierCodexSwarmFinishedHook = (input: FrontierCodexSwarmFinishedHookInput) => Promise<void> | void;
 export interface FrontierCodexSwarmRunResult {
     ok: boolean;
     outDir: string;
@@ -92,6 +342,8 @@ export declare function buildCodexArgs(job: FrontierSwarmJob, input: FrontierCod
     workspacePath: string;
     paths: FrontierCodexJobPaths;
 }): string[];
+export declare function normalizeCodexModelFlag(model: string | false | null | undefined): string | undefined;
+export declare function normalizeCodexApprovalPolicy(approval: string | false | null | undefined): 'untrusted' | 'on-failure' | 'on-request' | 'never' | undefined;
 export declare function renderCodexPrompt(job: FrontierSwarmJob, input: {
     workspacePath: string;
     paths: FrontierCodexJobPaths;
@@ -99,4 +351,24 @@ export declare function renderCodexPrompt(job: FrontierSwarmJob, input: {
 export declare function spawnCodexExecutor(input: FrontierCodexExecutorInput): Promise<FrontierCodexExecutorResult>;
 export declare function prepareCodexWorkspace(job: FrontierSwarmJob, options: FrontierCodexSwarmRunOptions): Promise<string>;
 export declare function createCodexWorkspacePlan(job: FrontierSwarmJob, options: FrontierCodexSwarmRunOptions): FrontierCodexWorkspacePlan;
+export declare function createSwarmWorkspaceManifest(plan: FrontierCodexWorkspacePlan): FrontierCodexWorkspaceManifest;
+export declare function createSwarmWorkspaceProof(plan: FrontierCodexWorkspacePlan, input?: {
+    ignoredChangedPaths?: readonly string[];
+    generatedAt?: number;
+}): Promise<FrontierCodexWorkspaceProof>;
+export declare function initFileSwarmEventStream(stream: FrontierSwarmEventStream | undefined): Promise<void>;
+export declare function appendFileSwarmEvent(stream: FrontierSwarmEventStream | undefined, event: FrontierSwarmEventInput): Promise<void>;
+export declare function writeSwarmCoordinatorSnapshot(file: string, input: FrontierCodexSwarmRunResult & {
+    eventStream?: FrontierSwarmEventStream;
+    pidManifestPath?: string;
+}): Promise<void>;
+export declare function appendCodexPidManifest(file: string, entry: FrontierCodexPidEntry, runId?: string): Promise<void>;
+export declare function readCodexPidManifest(file: string): Promise<FrontierCodexPidManifest>;
+export declare function stopCodexSwarmRun(input: {
+    run: string;
+    signal?: NodeJS.Signals;
+}): Promise<FrontierCodexStopResult>;
+export declare function collectCodexSwarmRun(input: FrontierCodexCollectInput): Promise<FrontierCodexCollectResult>;
+export declare function applyCodexSwarmCollection(input: FrontierCodexApplyInput): Promise<FrontierCodexApplyResult>;
+export declare function scoreCodexSwarmPatches(input: FrontierCodexPatchScoreInput): Promise<FrontierCodexPatchScoreResult>;
 //# sourceMappingURL=index.d.ts.map