@tracemarketplace/cli 0.0.18 → 0.0.19

package/dist/submit-worker-state.js

@@ -0,0 +1,88 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { join } from "path";
+import { getSubmitLogPath, getSubmitWorkerStateDir } from "./config.js";
+export function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+export function writeSubmitWorkerState(profile, state, opts = {}) {
+    const dir = resolveStateDir(profile, opts.dir);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, `${state.pid}.json`), JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+export function removeSubmitWorkerState(profile, pid, opts = {}) {
+    const dir = resolveStateDir(profile, opts.dir);
+    const path = join(dir, `${pid}.json`);
+    if (!existsSync(path)) {
+        return;
+    }
+    try {
+        unlinkSync(path);
+    }
+    catch { }
+}
+export function listActiveSubmitWorkers(profile, opts = {}) {
+    const dir = resolveStateDir(profile, opts.dir);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const workers = [];
+    for (const entry of readdirSync(dir)) {
+        if (!entry.endsWith(".json")) {
+            continue;
+        }
+        const path = join(dir, entry);
+        const parsed = readSubmitWorkerStateFile(path);
+        if (!parsed || !isProcessRunning(parsed.pid)) {
+            try {
+                unlinkSync(path);
+            }
+            catch { }
+            continue;
+        }
+        workers.push(parsed);
+    }
+    return workers.sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+}
+export function createSubmitWorkerState(profile, pid, startedAt, readyChunkCount, readySessionCount) {
+    return {
+        pid,
+        startedAt,
+        readyChunkCount,
+        readySessionCount,
+        logPath: getSubmitLogPath(profile),
+    };
+}
+function resolveStateDir(profile, dir) {
+    return dir ?? getSubmitWorkerStateDir(profile);
+}
+function readSubmitWorkerStateFile(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, "utf-8"));
+        if (typeof value.pid !== "number"
+            || !Number.isInteger(value.pid)
+            || value.pid <= 0
+            || typeof value.startedAt !== "string"
+            || typeof value.readyChunkCount !== "number"
+            || typeof value.readySessionCount !== "number"
+            || typeof value.logPath !== "string") {
+            return null;
+        }
+        return {
+            pid: value.pid,
+            startedAt: value.startedAt,
+            readyChunkCount: value.readyChunkCount,
+            readySessionCount: value.readySessionCount,
+            logPath: value.logPath,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=submit-worker-state.js.map

package/dist/submit-worker-state.js.map

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

package/dist/submit-worker-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=submit-worker-state.test.d.ts.map

package/dist/submit-worker-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-worker-state.test.d.ts","sourceRoot":"","sources":["../src/submit-worker-state.test.ts"],"names":[],"mappings":""}

package/dist/submit-worker-state.test.js

@@ -0,0 +1,45 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, readFileSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { createSubmitWorkerState, listActiveSubmitWorkers, removeSubmitWorkerState, writeSubmitWorkerState, } from "./submit-worker-state.js";
+describe("submit worker state", () => {
+    const tempDirs = [];
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("lists active workers and prunes stale ones", () => {
+        const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+        tempDirs.push(dir);
+        writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 111, "2026-03-21T00:00:00.000Z", 3, 2), { dir });
+        writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 222, "2026-03-21T01:00:00.000Z", 1, 1), { dir });
+        vi.spyOn(process, "kill").mockImplementation((pid) => {
+            if (pid === 111) {
+                return true;
+            }
+            const err = new Error("missing");
+            err.code = "ESRCH";
+            throw err;
+        });
+        const workers = listActiveSubmitWorkers("prod", { dir });
+        expect(workers).toEqual([
+            createSubmitWorkerState("prod", 111, "2026-03-21T00:00:00.000Z", 3, 2),
+        ]);
+        expect(() => readFileSync(join(dir, "222.json"), "utf-8")).toThrow();
+    });
+    it("removes worker state files", () => {
+        const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+        tempDirs.push(dir);
+        writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 333, "2026-03-21T00:00:00.000Z", 2, 1), { dir });
+        removeSubmitWorkerState("prod", 333, { dir });
+        expect(() => readFileSync(join(dir, "333.json"), "utf-8")).toThrow();
+    });
+    it("prunes invalid state payloads", () => {
+        const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+        tempDirs.push(dir);
+        writeFileSync(join(dir, "bad.json"), JSON.stringify({ nope: true }), "utf-8");
+        expect(listActiveSubmitWorkers("prod", { dir })).toEqual([]);
+        expect(() => readFileSync(join(dir, "bad.json"), "utf-8")).toThrow();
+    });
+});
+//# sourceMappingURL=submit-worker-state.test.js.map

package/dist/submit-worker-state.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracemarketplace/cli",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "type": "module",
   "bin": {
     "tracemp": "dist/cli.js"
@@ -13,7 +13,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@tracemarketplace/shared": "^0.0.13",
+    "@tracemarketplace/shared": "^0.0.14",
     "better-sqlite3": "^12.8.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",

package/src/cli.ts

@@ -5,7 +5,7 @@ import { fileURLToPath } from "url";
 import { program } from "commander";
 import { loginCommand } from "./commands/login.js";
 import { whoamiCommand } from "./commands/whoami.js";
-import { submitCommand } from "./commands/submit.js";
+import { submitCommand, submitWorkerCommand } from "./commands/submit.js";
 import { statusCommand } from "./commands/status.js";
 import { historyCommand } from "./commands/history.js";
 import { autoSubmitCommand } from "./commands/auto-submit.js";
@@ -45,7 +45,7 @@ program
   .option("--tool <tool>", "Only submit from specific tool (claude-code|codex|cursor)")
   .option("--session <id>", "Only submit a specific session ID")
   .option("--dry-run", "Preview without submitting")
-  .option("--sync", "Wait for server acknowledgement instead of fire-and-forget")
+  .option("--sync", "Wait in the foreground instead of launching a background submit worker")
   .option("--created-since <duration>", "Only include sessions created within duration (e.g. 30d, 12h, 30m)", "30d")
   .action((opts) =>
     submitCommand({
@@ -58,6 +58,13 @@ program
     }).catch(handleError)
   );
 
+program
+  .command("submit-worker", { hidden: true })
+  .description("Background submit worker (internal)")
+  .requiredOption("--manifest <path>", "Submit worker manifest path")
+  .option("--profile <name>", profileOptionDescription)
+  .action((opts) => submitWorkerCommand({ profile: opts.profile, manifest: opts.manifest }).catch(handleError));
+
 program
   .command("status")
   .description("Show pending submissions and balance")

package/src/commands/status.ts

@@ -2,6 +2,7 @@ import chalk from "chalk";
 import { loadConfig, resolveProfile } from "../config.js";
 import { ApiClient } from "../api-client.js";
 import { loginCommandForProfile } from "../constants.js";
+import { listActiveSubmitWorkers } from "../submit-worker-state.js";
 
 export async function statusCommand(opts: { profile?: string } = {}): Promise<void> {
   const profile = resolveProfile(opts.profile);
@@ -16,13 +17,34 @@ export async function statusCommand(opts: { profile?: string } = {}): Promise<vo
     client.get("/api/v1/me") as Promise<{ email: string; balanceCents?: number; balance_cents?: number }>,
     client.get("/api/v1/submissions") as Promise<any[]>,
   ]);
+  const activeWorkers = listActiveSubmitWorkers(config.profile);
 
   const balance = ((me as any).balanceCents ?? (me as any).balance_cents ?? 0) / 100;
   console.log(chalk.gray("Profile:"), config.profile);
   console.log(chalk.gray("Server:"), config.serverUrl);
+  console.log(
+    chalk.bold("Background submit:"),
+    activeWorkers.length > 0
+      ? chalk.yellow(`running (${activeWorkers.length})`)
+      : chalk.gray("idle"),
+  );
   console.log(chalk.bold("Balance:"), chalk.green(`$${balance.toFixed(2)}`));
   console.log(chalk.bold("Submissions:"), (subs as any[]).length);
 
+  if (activeWorkers.length > 0) {
+    activeWorkers.slice(0, 3).forEach((worker) => {
+      console.log(
+        chalk.gray(
+          `  pid ${worker.pid} started ${worker.startedAt} ready ${worker.readyChunkCount} chunk(s) from ${worker.readySessionCount} session(s)`
+        )
+      );
+    });
+    if (activeWorkers.length > 3) {
+      console.log(chalk.gray(`  ...and ${activeWorkers.length - 3} more worker(s)`));
+    }
+    console.log(chalk.gray(`  Log: ${activeWorkers[0]!.logPath}`));
+  }
+
   const pending = (subs as any[]).filter((s) => s.acceptedCount === null);
   if (pending.length > 0) {
     console.log(chalk.yellow(`\n${pending.length} pending submission(s)`));

package/src/commands/submit.test.ts

@@ -0,0 +1,64 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { buildSubmitWorkerRuntime, parseSubmitWorkerManifest } from "./submit.js";
+
+const originalArgv = [...process.argv];
+const originalExecArgv = [...process.execArgv];
+
+describe("parseSubmitWorkerManifest", () => {
+  it("accepts valid session sources", () => {
+    const manifest = parseSubmitWorkerManifest(JSON.stringify({
+      createdAt: "2026-03-21T00:00:00.000Z",
+      readyChunkCount: 3,
+      readySessionCount: 2,
+      sources: [
+        {
+          tool: "codex_cli",
+          locator: "/tmp/session.jsonl",
+          label: "codex_cli:/tmp/session.jsonl",
+        },
+      ],
+    }));
+
+    expect(manifest.readyChunkCount).toBe(3);
+    expect(manifest.readySessionCount).toBe(2);
+    expect(manifest.sources).toHaveLength(1);
+  });
+
+  it("rejects invalid source payloads", () => {
+    expect(() => parseSubmitWorkerManifest(JSON.stringify({
+      sources: [{ tool: "not-a-tool", locator: 123, label: null }],
+    }))).toThrow("Invalid submit worker manifest.");
+  });
+});
+
+describe("buildSubmitWorkerRuntime", () => {
+  afterEach(() => {
+    process.argv = [...originalArgv];
+    Object.defineProperty(process, "execArgv", {
+      configurable: true,
+      value: [...originalExecArgv],
+    });
+  });
+
+  it("targets the hidden submit-worker command and strips inspect flags", () => {
+    process.argv = [process.execPath, "/tmp/tracemp-cli.js"];
+    Object.defineProperty(process, "execArgv", {
+      configurable: true,
+      value: ["--inspect=127.0.0.1:9229", "--loader", "tsx"],
+    });
+
+    expect(buildSubmitWorkerRuntime("prod", "/tmp/submit-job.json")).toEqual({
+      command: process.execPath,
+      args: [
+        "--loader",
+        "tsx",
+        "/tmp/tracemp-cli.js",
+        "submit-worker",
+        "--profile",
+        "prod",
+        "--manifest",
+        "/tmp/submit-job.json",
+      ],
+    });
+  });
+});

package/src/commands/submit.ts

@@ -1,10 +1,12 @@
-import { existsSync } from "fs";
+import { closeSync, existsSync, mkdirSync, openSync, unlinkSync, writeFileSync } from "fs";
 import { readFile } from "fs/promises";
+import { spawn } from "child_process";
+import { join } from "path";
 import chalk from "chalk";
 import ora from "ora";
 import inquirer from "inquirer";
 import { extractClaudeCode, extractCodex, extractCursor, type NormalizedTrace } from "@tracemarketplace/shared";
-import { loadConfig, loadState, resolveProfile, stateKey } from "../config.js";
+import { getConfigDir, getSubmitLogPath, loadConfig, loadState, resolveProfile, stateKey } from "../config.js";
 import { loginCommandForProfile } from "../constants.js";
 import {
   buildCursorSessionSource,
@@ -16,6 +18,7 @@ import {
   type SessionSource,
 } from "../flush.js";
 import { CURSOR_DB_PATH, findFiles } from "../sessions.js";
+import { createSubmitWorkerState, removeSubmitWorkerState, writeSubmitWorkerState } from "../submit-worker-state.js";
 
 interface SubmitOptions {
   profile?: string;
@@ -36,6 +39,18 @@ interface PlannedSession extends DiscoveredSession {
   pending: boolean;
 }
 
+interface SubmitWorkerOptions {
+  profile?: string;
+  manifest: string;
+}
+
+interface SubmitWorkerManifest {
+  createdAt: string;
+  readyChunkCount: number;
+  readySessionCount: number;
+  sources: SessionSource[];
+}
+
 function pushSessionIfNonEmpty(
   sessions: DiscoveredSession[],
   source: SessionSource,
@@ -269,24 +284,19 @@ export async function submitCommand(opts: SubmitOptions): Promise<void> {
     return;
   }
 
-  const uploadSpinner = ora(
-    opts.sync
-      ? `Submitting ${readyChunkCount} finalized chunk(s) to ${config.profile}...`
-      : `Queuing ${readyChunkCount} finalized chunk(s) to ${config.profile}...`
-  ).start();
+  const readySessions = plannedSessions.filter((session) => session.readyChunks > 0);
 
-  try {
-    const readySessions = plannedSessions.filter((session) => session.readyChunks > 0);
+  if (opts.sync) {
+    const uploadSpinner = ora(`Submitting ${readyChunkCount} finalized chunk(s) to ${config.profile}...`).start();
     const prefetchedTraces = new Map(readySessions.map((s) => [`${s.source.tool}:${s.source.locator}`, s.trace]));
-    const result = await flushTrackedSessions(
-      config,
-      readySessions.map((session) => session.source),
-      { includeIdleTracked: false, prefetchedTraces, sync: opts.sync }
-    );
-
-    uploadSpinner.stop();
+    try {
+      const result = await flushTrackedSessions(
+        config,
+        readySessions.map((session) => session.source),
+        { includeIdleTracked: false, prefetchedTraces, sync: true }
+      );
 
-    if (opts.sync) {
+      uploadSpinner.stop();
       const failedSessions = result.results.filter((session) => session.error && session.error !== "Empty session");
       console.log(chalk.green("\nSubmission complete!"));
       console.log(`  Uploaded chunks:   ${chalk.bold(result.uploadedChunks)}`);
@@ -302,20 +312,166 @@ export async function submitCommand(opts: SubmitOptions): Promise<void> {
           console.log(chalk.gray(`  ...and ${failedSessions.length - 3} more`));
         }
       }
-    } else {
-      console.log(chalk.green(`\nQueued ${readyChunkCount} chunk(s) — processing in background.`));
-      console.log(chalk.gray("  Run again to check confirmation status."));
+    } catch (e) {
+      uploadSpinner.fail("Submission failed");
+      console.error(chalk.red(String(e)));
+      process.exit(1);
+    }
+    return;
+  }
+
+  const launchSpinner = ora(`Starting background submit for ${readyChunkCount} finalized chunk(s)...`).start();
+
+  try {
+    const { logPath, pid } = spawnDetachedSubmitWorker(config.profile, {
+      createdAt: new Date().toISOString(),
+      readyChunkCount,
+      readySessionCount,
+      sources: readySessions.map((session) => session.source),
+    });
+
+    launchSpinner.stop();
+    console.log(chalk.green(`\nStarted background submit for ${readyChunkCount} chunk(s).`));
+    if (pid) {
+      console.log(chalk.gray(`  Worker PID: ${pid}`));
     }
+    console.log(chalk.gray(`  Log: ${logPath}`));
+    console.log(chalk.gray("  Run `tracemp status` later to check confirmation status."));
   } catch (e) {
-    uploadSpinner.fail("Submission failed");
+    launchSpinner.fail("Could not start background submit");
     console.error(chalk.red(String(e)));
     process.exit(1);
   }
 }
 
+export async function submitWorkerCommand(opts: SubmitWorkerOptions): Promise<void> {
+  const profile = resolveProfile(opts.profile);
+  try {
+    const manifest = parseSubmitWorkerManifest(await readFile(opts.manifest, "utf-8"));
+    const config = loadConfig(profile);
+    if (!config) {
+      throw new Error(`Not authenticated for profile '${profile}'. Run: ${loginCommandForProfile(profile)}`);
+    }
+
+    console.log(
+      `[${new Date().toISOString()}] submit worker starting profile=${profile} ready_chunks=${manifest.readyChunkCount} sessions=${manifest.readySessionCount}`
+    );
+
+    const result = await flushTrackedSessions(config, manifest.sources, { includeIdleTracked: false, sync: false });
+    const failedSessions = result.results.filter((session) => session.error && session.error !== "Empty session");
+
+    console.log(
+      `[${new Date().toISOString()}] submit worker queued chunks=${result.uploadedChunks} pending_sessions=${result.pendingSessions}`
+    );
+
+    if (failedSessions.length > 0) {
+      console.log(`[${new Date().toISOString()}] ${failedSessions.length} session(s) failed during submit:`);
+      failedSessions.slice(0, 10).forEach((session) => {
+        console.log(`  ${session.source.label}: ${session.error}`);
+      });
+      if (failedSessions.length > 10) {
+        console.log(`  ...and ${failedSessions.length - 10} more`);
+      }
+    }
+  } finally {
+    removeSubmitWorkerState(profile, process.pid);
+    try {
+      unlinkSync(opts.manifest);
+    } catch {}
+  }
+}
+
+export function buildSubmitWorkerRuntime(profile: string, manifestPath: string): { command: string; args: string[] } {
+  const cliEntrypoint = process.argv[1];
+  if (!cliEntrypoint) {
+    throw new Error("Unable to resolve tracemp CLI entrypoint for background submit.");
+  }
+
+  const execArgv = process.execArgv.filter((arg) => !arg.startsWith("--inspect"));
+  return {
+    command: process.execPath,
+    args: [...execArgv, cliEntrypoint, "submit-worker", "--profile", profile, "--manifest", manifestPath],
+  };
+}
+
+export function parseSubmitWorkerManifest(raw: string): SubmitWorkerManifest {
+  const parsed = JSON.parse(raw) as Partial<SubmitWorkerManifest>;
+  if (!Array.isArray(parsed.sources) || parsed.sources.some((source) => !isSessionSource(source))) {
+    throw new Error("Invalid submit worker manifest.");
+  }
+
+  return {
+    createdAt: typeof parsed.createdAt === "string" ? parsed.createdAt : new Date(0).toISOString(),
+    readyChunkCount: typeof parsed.readyChunkCount === "number" ? parsed.readyChunkCount : parsed.sources.length,
+    readySessionCount: typeof parsed.readySessionCount === "number" ? parsed.readySessionCount : parsed.sources.length,
+    sources: parsed.sources,
+  };
+}
+
 function describeSessionStatus(session: PlannedSession): string {
   if (session.readyChunks > 0 && session.pending) return "ready + pending";
   if (session.readyChunks > 0) return "ready";
   if (session.pending) return "pending";
   return "up-to-date";
 }
+
+function isSessionSource(value: unknown): value is SessionSource {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+
+  const source = value as Record<string, unknown>;
+  return (
+    (source.tool === "claude_code" || source.tool === "codex_cli" || source.tool === "cursor")
+    && typeof source.locator === "string"
+    && typeof source.label === "string"
+  );
+}
+
+function spawnDetachedSubmitWorker(
+  profile: string,
+  manifest: SubmitWorkerManifest
+): { logPath: string; pid: number | null } {
+  mkdirSync(getConfigDir(), { recursive: true });
+  const manifestPath = join(
+    getConfigDir(),
+    `submit-job-${Date.now()}-${process.pid}-${Math.random().toString(36).slice(2, 8)}.json`
+  );
+  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+
+  const logPath = getSubmitLogPath(profile);
+  const logFd = openSync(logPath, "a");
+
+  try {
+    const { command, args } = buildSubmitWorkerRuntime(profile, manifestPath);
+    const child = spawn(command, args, {
+      cwd: process.cwd(),
+      detached: true,
+      env: process.env,
+      stdio: ["ignore", logFd, logFd],
+    });
+    child.unref();
+
+    if (child.pid) {
+      writeSubmitWorkerState(
+        profile,
+        createSubmitWorkerState(
+          profile,
+          child.pid,
+          manifest.createdAt,
+          manifest.readyChunkCount,
+          manifest.readySessionCount,
+        ),
+      );
+    }
+
+    return { logPath, pid: child.pid ?? null };
+  } catch (err) {
+    try {
+      unlinkSync(manifestPath);
+    } catch {}
+    throw err;
+  } finally {
+    closeSync(logFd);
+  }
+}

package/src/config.ts

@@ -60,6 +60,14 @@ export function getAutoSubmitLogPath(profile?: string): string {
   return join(getConfigDir(), `auto-submit${profileSuffix(profile)}.log`);
 }
 
+export function getSubmitLogPath(profile?: string): string {
+  return join(getConfigDir(), `submit${profileSuffix(profile)}.log`);
+}
+
+export function getSubmitWorkerStateDir(profile?: string): string {
+  return join(getConfigDir(), `submit-workers${profileSuffix(profile)}`);
+}
+
 export function getDaemonStatePath(profile?: string): string {
   return join(getConfigDir(), `daemon-state${profileSuffix(profile)}.json`);
 }

package/src/submit-worker-state.test.ts

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, readFileSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import {
+  createSubmitWorkerState,
+  listActiveSubmitWorkers,
+  removeSubmitWorkerState,
+  writeSubmitWorkerState,
+} from "./submit-worker-state.js";
+
+describe("submit worker state", () => {
+  const tempDirs: string[] = [];
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it("lists active workers and prunes stale ones", () => {
+    const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+    tempDirs.push(dir);
+
+    writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 111, "2026-03-21T00:00:00.000Z", 3, 2), { dir });
+    writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 222, "2026-03-21T01:00:00.000Z", 1, 1), { dir });
+
+    vi.spyOn(process, "kill").mockImplementation((pid: number | NodeJS.Signals) => {
+      if (pid === 111) {
+        return true as never;
+      }
+      const err = new Error("missing") as NodeJS.ErrnoException;
+      err.code = "ESRCH";
+      throw err;
+    });
+
+    const workers = listActiveSubmitWorkers("prod", { dir });
+
+    expect(workers).toEqual([
+      createSubmitWorkerState("prod", 111, "2026-03-21T00:00:00.000Z", 3, 2),
+    ]);
+    expect(() => readFileSync(join(dir, "222.json"), "utf-8")).toThrow();
+  });
+
+  it("removes worker state files", () => {
+    const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+    tempDirs.push(dir);
+
+    writeSubmitWorkerState("prod", createSubmitWorkerState("prod", 333, "2026-03-21T00:00:00.000Z", 2, 1), { dir });
+    removeSubmitWorkerState("prod", 333, { dir });
+
+    expect(() => readFileSync(join(dir, "333.json"), "utf-8")).toThrow();
+  });
+
+  it("prunes invalid state payloads", () => {
+    const dir = mkdtempSync(join(tmpdir(), "tracemp-submit-workers-"));
+    tempDirs.push(dir);
+    writeFileSync(join(dir, "bad.json"), JSON.stringify({ nope: true }), "utf-8");
+
+    expect(listActiveSubmitWorkers("prod", { dir })).toEqual([]);
+    expect(() => readFileSync(join(dir, "bad.json"), "utf-8")).toThrow();
+  });
+});