feat(planner): add temporary production campaigns

Model finite production runs with quantity, duration, and confidence while keeping their derived demand in the ordinary factory solve. Present campaign totals compactly in the block editor and support completing or reactivating campaigns.\n\nCloses #160

Author: ApocDev

app/e2e/mut/temporary-campaign.e2e.ts

@@ -0,0 +1,92 @@
+import { DatabaseSync } from "node:sqlite";
+import { expect, test } from "@playwright/test";
+import { activeProjectDbFile, addGoal, createBlock, expectUndoTop } from "./helpers";
+
+test("temporary campaign derives a finite target and can be completed and reactivated", async ({
+  page,
+}) => {
+  const id = await createBlock(page);
+  await addGoal(page, "iron plate", "Iron plate");
+
+  await page.locator('button[aria-label^="Add a recipe that makes "]').click();
+  const recipePicker = page.getByRole("dialog", { name: /Recipes that make/ });
+  await recipePicker.locator('[data-recipe-candidate="iron-plate"]').click();
+  await expect(recipePicker).toBeHidden();
+
+  await page.getByRole("button", { name: "Make this block temporary", exact: true }).click();
+  const quantity = page.getByRole("button", { name: "Make 3,600", exact: true });
+  await expect(quantity).toBeVisible();
+  await quantity.click();
+  const quantityInput = page.locator('input[inputmode="decimal"]:focus');
+  await quantityInput.fill("5");
+  await quantityInput.press("Enter");
+
+  const durationUnit = page.getByTitle(
+    "Campaign duration unit — click to cycle seconds / minutes / hours",
+  );
+  await expect(durationUnit).toHaveText("h");
+  await durationUnit.click();
+  await expect(durationUnit).toHaveText("s");
+  await durationUnit.click();
+  await expect(durationUnit).toHaveText("min");
+  const duration = page.getByRole("textbox", { name: "Campaign duration" });
+  await duration.fill("30");
+  await duration.press("Enter");
+
+  const ironImport = page.getByRole("button", { name: /^Iron ore 40 total/ });
+  await expect(ironImport).toBeVisible();
+  await expect(ironImport.locator("[data-campaign-rate]")).toHaveText("0.022/s");
+  const balance = page.locator('[data-slot="card"]').filter({ hasText: "Block balance" });
+  await expect(balance.getByText(/^avg /)).toHaveCount(0);
+  await expect(balance.getByText("<0.01", { exact: true }).first()).toBeVisible();
+
+  await page.getByRole("combobox", { name: "Campaign confidence" }).click();
+  await page.getByRole("option", { name: "90% confidence" }).click();
+  const goal = page.locator('[data-goal="iron-plate"]');
+  await expect(goal).toContainText(/Make 5/);
+  await expect(goal).not.toContainText(/plan |\/s/);
+  await expectUndoTop(page, /Set campaign confidence|Edit block/);
+
+  await page.getByRole("button", { name: "Complete temporary campaign", exact: true }).click();
+  await expect(
+    page.getByRole("button", { name: "Reactivate temporary campaign", exact: true }),
+  ).toBeVisible();
+  await expect(page.getByRole("status").filter({ hasText: /removed from factory planning/ })).toBeVisible();
+
+  const completedDb = new DatabaseSync(activeProjectDbFile(), { readOnly: true });
+  try {
+    const row = completedDb.prepare("SELECT enabled, data FROM blocks WHERE id = ?").get(id) as {
+      enabled: number;
+      data: string;
+    };
+    const data = JSON.parse(row.data) as {
+      campaign?: { completedAt?: string; duration?: number };
+    };
+    expect(row.enabled).toBe(0);
+    expect(data.campaign?.duration).toBe(1800);
+    expect(data.campaign?.completedAt).toBeTruthy();
+  } finally {
+    completedDb.close();
+  }
+
+  await page
+    .getByRole("button", { name: "Reactivate temporary campaign", exact: true })
+    .click();
+  await expect(
+    page.getByRole("button", { name: "Complete temporary campaign", exact: true }),
+  ).toBeVisible();
+  await expect(page.getByRole("status").filter({ hasText: /campaign reactivated/ })).toBeVisible();
+
+  const activeDb = new DatabaseSync(activeProjectDbFile(), { readOnly: true });
+  try {
+    const row = activeDb.prepare("SELECT enabled, data FROM blocks WHERE id = ?").get(id) as {
+      enabled: number;
+      data: string;
+    };
+    const data = JSON.parse(row.data) as { campaign?: { completedAt?: string } };
+    expect(row.enabled).toBe(1);
+    expect(data.campaign?.completedAt).toBeUndefined();
+  } finally {
+    activeDb.close();
+  }
+});

app/src/components/block/balance-card.tsx

@@ -64,6 +64,7 @@ export function BalanceCard({
   const blockName = useStore(doc.store, (s) => s.blockName);
   const supplyPriority = useStore(doc.store, (s) => s.supplyPriority ?? 0);
   const supplyPriorities = useStore(doc.store, (s) => s.supplyPriorities ?? {});
+  const campaign = useStore(doc.store, (s) => s.campaign);
   const spoilables = useSpoilables();
   const showImports = !!res && (res.displayImports.length > 0 || res.displayExports.length === 0);
   const showExports = !!res?.displayExports.length;
@@ -338,6 +339,7 @@ export function BalanceCard({
                             kind={f.kind}
                             display={res.display?.[f.name]}
                             rate={f.rate}
+                            total={campaign ? f.rate * campaign.duration : undefined}
                             temp={f.temp}
                             link="import"
                             craftable={producible.has(f.name)}
@@ -441,6 +443,7 @@ export function BalanceCard({
                           kind={f.kind}
                           display={res.display?.[f.name]}
                           rate={f.rate}
+                          total={campaign ? f.rate * campaign.duration : undefined}
                           temp={f.temp}
                           link="export"
                           fuel={fuelSet.has(f.name)}

app/src/components/block/doc-store.test.ts

@@ -145,6 +145,40 @@ describe("goals", () => {
     expect(doc.store.state.goals[0].rate).toBe(7);
     expect(doc.store.state.goals[1].rate).toBe(0.5);
   });
+
+  it("converts goals into a finite temporary campaign and re-derives its rates", () => {
+    const doc = seeded();
+    doc.makeTemporary(3600);
+
+    expect(doc.store.state.campaign).toEqual({
+      duration: 3600,
+      confidence: "expected",
+      quantities: { "iron-plate": 7200, "copper-plate": 1800 },
+    });
+    doc.setCampaignQuantity("iron-plate", 1);
+    doc.setCampaignConfidence("90");
+    expect(doc.store.state.goals[0].rate * 3600).toBeCloseTo(Math.log(10), 5);
+
+    doc.setCampaignDuration(7200);
+    expect(doc.store.state.goals[0].rate * 7200).toBeCloseTo(Math.log(10), 5);
+    doc.setCampaignCompletedAt("2026-07-15T00:00:00.000Z");
+    expect(solveInputOf(doc.store.state).campaign?.completedAt).toBe("2026-07-15T00:00:00.000Z");
+  });
+
+  it("keeps campaign quantities aligned when goals change", () => {
+    const doc = seeded();
+    doc.makeTemporary();
+    doc.changeGoalItem("iron-plate", "steel-plate");
+    doc.removeGoal("copper-plate");
+    doc.addGoal("stone-brick");
+
+    expect(doc.store.state.campaign?.quantities).toEqual({
+      "steel-plate": 7200,
+      "stone-brick": 1,
+    });
+    doc.makeOngoing();
+    expect(doc.store.state.campaign).toBeNull();
+  });
 });
 
 describe("recipes", () => {
@@ -342,4 +376,16 @@ describe("solveInputOf", () => {
     doc2.hydrate(saved, "Iron");
     expect(solveInputOf(doc2.store.state)).toEqual(saved);
   });
+
+  it("round-trips temporary campaign intent", () => {
+    const doc = seeded();
+    doc.makeTemporary(7200);
+    doc.setCampaignQuantity("iron-plate", 3);
+    doc.setCampaignConfidence("95");
+    const saved = solveInputOf(doc.store.state);
+
+    const reloaded = createBlockDocStore();
+    reloaded.hydrate(saved, "Iron");
+    expect(solveInputOf(reloaded.store.state)).toEqual(saved);
+  });
 });