issue-flow 0.17.0 → 0.19.1

package/dist/plan-PRORGS3L.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-import {
-  runPlan
-} from "./chunk-KZ5EY5XX.js";
-import "./chunk-32JSYXEK.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-3D4A4B46.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  runPlan
-};
-//# sourceMappingURL=plan-PRORGS3L.js.map

package/dist/pr-27RMQI5F.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-import {
-  issueClosesLines,
-  multiIssueContext,
-  runPr
-} from "./chunk-LPWPFIIB.js";
-import "./chunk-YUNBOUQH.js";
-import "./chunk-32JSYXEK.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-3D4A4B46.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  issueClosesLines,
-  multiIssueContext,
-  runPr
-};
-//# sourceMappingURL=pr-27RMQI5F.js.map

package/dist/pr-review-VNESMAMT.js

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-import {
-  exitCodeFor,
-  runPrReview
-} from "./chunk-Z5O2XBWA.js";
-import "./chunk-YUNBOUQH.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  exitCodeFor,
-  runPrReview
-};
-//# sourceMappingURL=pr-review-VNESMAMT.js.map

package/dist/prd-ZNC4T5BS.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-import {
-  runPrd
-} from "./chunk-ANI2NTR4.js";
-import "./chunk-32JSYXEK.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  runPrd
-};
-//# sourceMappingURL=prd-ZNC4T5BS.js.map

package/dist/ps-76L6ZAZL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ps.ts"],"sourcesContent":["import { z } from 'zod';\nimport { type LiveRun, listLiveRuns } from '../execution/registry.js';\nimport { formatDuration, printInfo } from '../ui/logger.js';\n\nexport const liveRunJsonSchema = z.object({\n  schemaVersion: z.literal(1),\n  runs: z.array(\n    z.object({\n      projectId: z.string(),\n      target: z.string(),\n      pid: z.number(),\n      host: z.string(),\n      detached: z.boolean(),\n      status: z.enum(['running', 'unsignaled', 'orphan']),\n      startedAt: z.string(),\n      lastHeartbeatAt: z.string(),\n      issue: z.number().nullable(),\n      phase: z.string().nullable(),\n      storiesCompleted: z.number().nullable(),\n      storiesTotal: z.number().nullable(),\n      elapsedSeconds: z.number().nullable(),\n    }),\n  ),\n});\n\nexport interface PsOptions {\n  json?: boolean;\n  watch?: boolean;\n}\n\nexport function formatPsTable(runs: readonly LiveRun[]): string[] {\n  if (runs.length === 0) return ['No issue-flow run is active on this machine.'];\n\n  const header = pad(['STATUS', 'ISSUE', 'PHASE', 'PROGRESS', 'ELAPSED', 'PID', 'PROJECT']);\n  const rows = runs.map((run) =>\n    pad([\n      run.status,\n      run.issue !== null ? `#${run.issue}` : run.target,\n      run.phase ?? '—',\n      run.storiesTotal !== null ? `${run.storiesCompleted ?? 0}/${run.storiesTotal}` : '—',\n      run.elapsedSeconds !== null ? formatDuration(run.elapsedSeconds) : '—',\n      String(run.pid),\n      `${run.projectId}${run.detached ? ' (bg)' : ''}`,\n    ]),\n  );\n  return [header, ...rows];\n}\n\nfunction pad(cells: string[]): string {\n  const widths = [12, 10, 12, 10, 10, 8, 24];\n  return cells.map((cell, i) => cell.padEnd(widths[i] ?? 12)).join(' ');\n}\n\nexport async function runPs(options: PsOptions = {}): Promise<number> {\n  const render = async () => {\n    const runs = await listLiveRuns();\n    if (options.json === true) {\n      const payload = liveRunJsonSchema.parse({\n        schemaVersion: 1,\n        runs: runs.map(({ lockFile: _lockFile, ...rest }) => rest),\n      });\n      printInfo(JSON.stringify(payload, null, 2));\n      return runs.length;\n    }\n    for (const line of formatPsTable(runs)) {\n      printInfo(line);\n    }\n    return runs.length;\n  };\n\n  if (options.watch === true) {\n    for (;;) {\n      await render();\n      await new Promise((resolve) => setTimeout(resolve, 2000));\n    }\n  }\n\n  await render();\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS;AAIX,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,eAAe,EAAE,QAAQ,CAAC;AAAA,EAC1B,MAAM,EAAE;AAAA,IACN,EAAE,OAAO;AAAA,MACP,WAAW,EAAE,OAAO;AAAA,MACpB,QAAQ,EAAE,OAAO;AAAA,MACjB,KAAK,EAAE,OAAO;AAAA,MACd,MAAM,EAAE,OAAO;AAAA,MACf,UAAU,EAAE,QAAQ;AAAA,MACpB,QAAQ,EAAE,KAAK,CAAC,WAAW,cAAc,QAAQ,CAAC;AAAA,MAClD,WAAW,EAAE,OAAO;AAAA,MACpB,iBAAiB,EAAE,OAAO;AAAA,MAC1B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,MAC3B,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,MAC3B,kBAAkB,EAAE,OAAO,EAAE,SAAS;AAAA,MACtC,cAAc,EAAE,OAAO,EAAE,SAAS;AAAA,MAClC,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,IACtC,CAAC;AAAA,EACH;AACF,CAAC;AAOM,SAAS,cAAc,MAAoC;AAChE,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC,8CAA8C;AAE7E,QAAM,SAAS,IAAI,CAAC,UAAU,SAAS,SAAS,YAAY,WAAW,OAAO,SAAS,CAAC;AACxF,QAAM,OAAO,KAAK;AAAA,IAAI,CAAC,QACrB,IAAI;AAAA,MACF,IAAI;AAAA,MACJ,IAAI,UAAU,OAAO,IAAI,IAAI,KAAK,KAAK,IAAI;AAAA,MAC3C,IAAI,SAAS;AAAA,MACb,IAAI,iBAAiB,OAAO,GAAG,IAAI,oBAAoB,CAAC,IAAI,IAAI,YAAY,KAAK;AAAA,MACjF,IAAI,mBAAmB,OAAO,eAAe,IAAI,cAAc,IAAI;AAAA,MACnE,OAAO,IAAI,GAAG;AAAA,MACd,GAAG,IAAI,SAAS,GAAG,IAAI,WAAW,UAAU,EAAE;AAAA,IAChD,CAAC;AAAA,EACH;AACA,SAAO,CAAC,QAAQ,GAAG,IAAI;AACzB;AAEA,SAAS,IAAI,OAAyB;AACpC,QAAM,SAAS,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,EAAE;AACzC,SAAO,MAAM,IAAI,CAAC,MAAM,MAAM,KAAK,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG;AACtE;AAEA,eAAsB,MAAM,UAAqB,CAAC,GAAoB;AACpE,QAAM,SAAS,YAAY;AACzB,UAAM,OAAO,MAAM,aAAa;AAChC,QAAI,QAAQ,SAAS,MAAM;AACzB,YAAM,UAAU,kBAAkB,MAAM;AAAA,QACtC,eAAe;AAAA,QACf,MAAM,KAAK,IAAI,CAAC,EAAE,UAAU,WAAW,GAAG,KAAK,MAAM,IAAI;AAAA,MAC3D,CAAC;AACD,gBAAU,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAC1C,aAAO,KAAK;AAAA,IACd;AACA,eAAW,QAAQ,cAAc,IAAI,GAAG;AACtC,gBAAU,IAAI;AAAA,IAChB;AACA,WAAO,KAAK;AAAA,EACd;AAEA,MAAI,QAAQ,UAAU,MAAM;AAC1B,eAAS;AACP,YAAM,OAAO;AACb,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAI,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,OAAO;AACb,SAAO;AACT;","names":[]}

package/dist/registry-XLHHYLTR.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-import {
-  classifyRunLock,
-  listLiveRuns
-} from "./chunk-RNFUVKC3.js";
-import "./chunk-RYOUZ6EK.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-export {
-  classifyRunLock,
-  listLiveRuns
-};
-//# sourceMappingURL=registry-XLHHYLTR.js.map

package/dist/resume-VLWIE264.js

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-import {
-  runPipeline
-} from "./chunk-HJBF4WD2.js";
-import "./chunk-B3TSS7BT.js";
-import "./chunk-LPWPFIIB.js";
-import "./chunk-Z5O2XBWA.js";
-import "./chunk-YUNBOUQH.js";
-import "./chunk-ANI2NTR4.js";
-import "./chunk-MI5TREN3.js";
-import {
-  PIPELINE_PHASES,
-  PipelineManager,
-  loadExecutionPlan,
-  nextQueueIssue
-} from "./chunk-A4H7P7T7.js";
-import "./chunk-ISZ54SVE.js";
-import "./chunk-KZXQWC7U.js";
-import "./chunk-2SUFAE6X.js";
-import "./chunk-6YQT3SSM.js";
-import "./chunk-SGTTR4XW.js";
-import "./chunk-CRGIQFUQ.js";
-import "./chunk-L6HSKTQE.js";
-import "./chunk-UWDCIFTP.js";
-import "./chunk-RCZJQUTC.js";
-import "./chunk-KZ5EY5XX.js";
-import "./chunk-32JSYXEK.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import {
-  parseJournal
-} from "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-C5TL7T4V.js";
-import "./chunk-3D4A4B46.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import {
-  resolveProjectPaths
-} from "./chunk-DV7HUC4Z.js";
-import {
-  printError,
-  printInfo,
-  printWarning
-} from "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import {
-  QUEUES_DIR_NAME,
-  getIssuePaths
-} from "./chunk-HAKDLR6N.js";
-import {
-  describePreflight,
-  preflightRepository
-} from "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import {
-  loadTaskPlan
-} from "./chunk-SOM4QA6C.js";
-import {
-  acquireRunLock,
-  describeRunLockOwner
-} from "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-
-// src/commands/resume.ts
-import { readdir, readFile } from "fs/promises";
-import { join } from "path";
-async function runResume(issue, options = {}) {
-  const mode = options.mode ?? "auto";
-  let project;
-  try {
-    project = await resolveProjectPaths();
-  } catch (err) {
-    printError(`Cannot resume: ${err instanceof Error ? err.message : String(err)}`);
-    return 1;
-  }
-  const acquisition = await acquireRunLock(project.runLockFile, { target: issue ?? "resume" });
-  if (!acquisition.ok) {
-    printError(
-      `Another issue-flow run owns this project: ${describeRunLockOwner(acquisition.owner)}.`
-    );
-    printInfo("Wait for it to finish, or stop that process before resuming.");
-    return 1;
-  }
-  const handle = acquisition.handle;
-  if (handle.reclaimedFrom !== null) {
-    printWarning(
-      `Taking over an interrupted run: ${describeRunLockOwner(handle.reclaimedFrom)}. Its lock was stale.`
-    );
-  }
-  try {
-    const targets = await findTargets(project, issue, options.all === true);
-    if (targets.length === 0) {
-      printInfo(
-        issue === void 0 ? "Nothing to resume: no issue in this project has an unfinished pipeline." : `Nothing to resume: issue #${issue} has no task plan in this project.`
-      );
-      return 0;
-    }
-    for (const target of targets) {
-      const code = await resumeOne(target, mode);
-      if (code !== 0) return code;
-    }
-    return 0;
-  } finally {
-    await handle.release();
-  }
-}
-async function resumeOne(target, mode) {
-  const phases = activePhases(target.plan);
-  const manager = new PipelineManager(target.plan, target.tasksFile, phases);
-  const next = manager.getNextPhase();
-  if (next === null) {
-    printInfo(`Issue #${target.issue} has every phase complete; nothing to resume.`);
-    return 0;
-  }
-  const interrupted = await lastUnfinishedPhase(target);
-  if (interrupted !== null) {
-    printInfo(`Issue #${target.issue} was interrupted during the '${interrupted}' phase.`);
-  }
-  const sameWork = interrupted === next;
-  const preflight = await preflightRepository({
-    expectedBranch: target.plan.noBranch === true ? null : target.plan.branchName,
-    intent: sameWork ? "resume-same-phase" : "new-phase"
-  });
-  if (!preflight.ok) {
-    printError(`Cannot resume issue #${target.issue}: the repository needs attention first.`);
-    for (const line of describePreflight(preflight)) {
-      printError(line);
-    }
-    return 1;
-  }
-  printInfo(`Resuming issue #${target.issue} from the '${next}' phase.`);
-  return runPipeline(target.issue, mode, next, void 0, void 0, { only: true });
-}
-function activePhases(plan) {
-  const base = plan.noBranch === true ? PIPELINE_PHASES.filter((phase) => phase !== "pr") : [...PIPELINE_PHASES];
-  return plan.prReview?.enabled === true ? [...base, "pr-review"] : base;
-}
-async function lastUnfinishedPhase(target) {
-  const content = `${await readIfPresent(target.rotatedEventsFile)}${await readIfPresent(target.eventsFile)}`;
-  if (content === "") return null;
-  const open = [];
-  for (const entry of parseJournal(content)) {
-    const event = entry.event;
-    if (event.type === "phase:start") {
-      open.push(event.phase);
-    } else if (event.type === "phase:end") {
-      const index = open.lastIndexOf(event.phase);
-      if (index >= 0) open.splice(index, 1);
-    }
-  }
-  return open.at(-1) ?? null;
-}
-async function readIfPresent(path) {
-  try {
-    return await readFile(path, "utf-8");
-  } catch {
-    return "";
-  }
-}
-async function findTargets(project, issue, all) {
-  if (issue !== void 0) {
-    const target = await loadTarget(project.projectId, issue);
-    return target === null ? [] : [target];
-  }
-  const queued = await queueTarget(project);
-  if (queued !== null && !all) return [queued];
-  const unfinished = await unfinishedTargets(project);
-  if (all) return unfinished;
-  return unfinished.slice(0, 1);
-}
-async function queueTarget(project) {
-  const queuesDir = join(project.projectDir, QUEUES_DIR_NAME);
-  let entries;
-  try {
-    entries = await readdir(queuesDir);
-  } catch {
-    return null;
-  }
-  for (const entry of entries) {
-    const plan = await loadExecutionPlan(join(queuesDir, entry, "execution-plan.json"));
-    if (plan === null) continue;
-    const next = nextQueueIssue(plan);
-    if (next === null) continue;
-    const target = await loadTarget(project.projectId, next.id);
-    if (target !== null) return target;
-  }
-  return null;
-}
-async function unfinishedTargets(project) {
-  let ids;
-  try {
-    ids = await readdir(project.issuesDir);
-  } catch {
-    return [];
-  }
-  const targets = [];
-  for (const id of ids) {
-    const target = await loadTarget(project.projectId, id);
-    if (target === null) continue;
-    if (target.plan.issueStatus === "completed") continue;
-    const manager = new PipelineManager(target.plan, target.tasksFile, activePhases(target.plan));
-    if (manager.getNextPhase() === null) continue;
-    targets.push(target);
-  }
-  return targets.sort((a, b) => attemptedAt(b.plan) - attemptedAt(a.plan));
-}
-function attemptedAt(plan) {
-  const at = Date.parse(plan.lastAttemptAt ?? "");
-  return Number.isNaN(at) ? 0 : at;
-}
-async function loadTarget(projectId, issue) {
-  let paths;
-  try {
-    paths = getIssuePaths(projectId, issue);
-  } catch {
-    return null;
-  }
-  try {
-    const plan = await loadTaskPlan(paths.tasksFile);
-    return {
-      issue,
-      plan,
-      tasksFile: paths.tasksFile,
-      eventsFile: paths.eventsFile,
-      rotatedEventsFile: paths.rotatedEventsFile
-    };
-  } catch {
-    return null;
-  }
-}
-export {
-  runResume
-};
-//# sourceMappingURL=resume-VLWIE264.js.map

package/dist/resume-VLWIE264.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/resume.ts"],"sourcesContent":["import { readdir, readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { parseJournal } from '../core/journal.js';\nimport { PIPELINE_PHASES, PipelineManager, type PipelinePhase } from '../core/pipeline.js';\nimport { loadTaskPlan } from '../core/state-manager.js';\nimport { loadExecutionPlan, nextQueueIssue } from '../execution/plan.js';\nimport { acquireRunLock, describeRunLockOwner, type RunLockHandle } from '../storage/lock.js';\nimport { getIssuePaths, QUEUES_DIR_NAME } from '../storage/paths.js';\nimport { resolveProjectPaths } from '../storage/resolve.js';\nimport type { TaskPlan } from '../types.js';\nimport { printError, printInfo, printWarning } from '../ui/logger.js';\nimport { describePreflight, preflightRepository } from '../utils/git.js';\nimport { runPipeline } from './run.js';\n\n/**\n * `issue-flow resume` — explicit recovery.\n *\n * Resumption already worked before this command existed, but only *implicitly*:\n * the user re-ran the same `run` and the pipeline happened to pick up where it\n * left off, because `PipelineManager` skips the phases already marked complete\n * and `nextQueueIssue()` treats a stale `in_progress` as \"do this one first\".\n * That is a coincidence of two mechanisms, not a contract — nothing said what\n * had been interrupted, nothing checked whether the repository was still in a\n * state to continue, and nothing distinguished \"carry on\" from \"start over\".\n *\n * This command makes each of those steps explicit, in this order:\n *\n * 1. **ownership** — a live owner refuses, a dead one is taken over;\n * 2. **plans** — `execution-plan.json` for a queue, `tasks.json` for an issue;\n * 3. **the journal** — the last `phase:start` with no `phase:end` is what was\n *    running when the process died, which is the one fact no snapshot keeps;\n * 4. **the preflight** — the repository is described, and a state a human has to\n *    settle stops the resume instead of being repaired;\n * 5. **the phase** — `PipelineManager.getNextPhase()`, the same answer `run`\n *    has always used, now stated out loud before anything runs.\n *\n * `run` is untouched: its auto-resume still works exactly as it did.\n */\n\nexport interface ResumeOptions {\n  /** Resume every unfinished issue of the project, not just one. */\n  all?: boolean;\n  /** Execution mode handed to the pipeline. Same values as `run`. */\n  mode?: string;\n}\n\ninterface ResumeTarget {\n  issue: string;\n  plan: TaskPlan;\n  tasksFile: string;\n  eventsFile: string;\n  rotatedEventsFile: string;\n}\n\nexport async function runResume(issue?: string, options: ResumeOptions = {}): Promise<number> {\n  const mode = options.mode ?? 'auto';\n\n  let project: Awaited<ReturnType<typeof resolveProjectPaths>>;\n  try {\n    project = await resolveProjectPaths();\n  } catch (err) {\n    printError(`Cannot resume: ${err instanceof Error ? err.message : String(err)}`);\n    return 1;\n  }\n\n  // 1. Ownership, before reading anything else: a resume that runs beside a\n  // live owner is the collision this whole layer exists to prevent.\n  const acquisition = await acquireRunLock(project.runLockFile, { target: issue ?? 'resume' });\n  if (!acquisition.ok) {\n    printError(\n      `Another issue-flow run owns this project: ${describeRunLockOwner(acquisition.owner)}.`,\n    );\n    printInfo('Wait for it to finish, or stop that process before resuming.');\n    return 1;\n  }\n  const handle: RunLockHandle = acquisition.handle;\n  if (handle.reclaimedFrom !== null) {\n    printWarning(\n      `Taking over an interrupted run: ${describeRunLockOwner(handle.reclaimedFrom)}. Its lock was stale.`,\n    );\n  }\n\n  try {\n    // 2. What is there to resume.\n    const targets = await findTargets(project, issue, options.all === true);\n    if (targets.length === 0) {\n      printInfo(\n        issue === undefined\n          ? 'Nothing to resume: no issue in this project has an unfinished pipeline.'\n          : `Nothing to resume: issue #${issue} has no task plan in this project.`,\n      );\n      return 0;\n    }\n\n    for (const target of targets) {\n      const code = await resumeOne(target, mode);\n      if (code !== 0) return code;\n    }\n    return 0;\n  } finally {\n    await handle.release();\n  }\n}\n\nasync function resumeOne(target: ResumeTarget, mode: string): Promise<number> {\n  const phases = activePhases(target.plan);\n  const manager = new PipelineManager(target.plan, target.tasksFile, phases);\n  const next = manager.getNextPhase();\n\n  if (next === null) {\n    printInfo(`Issue #${target.issue} has every phase complete; nothing to resume.`);\n    return 0;\n  }\n\n  // 3. What was running when the process died. The snapshot cannot answer this\n  // — it only knows the phase failed or never ended — so the journal does.\n  const interrupted = await lastUnfinishedPhase(target);\n  if (interrupted !== null) {\n    printInfo(`Issue #${target.issue} was interrupted during the '${interrupted}' phase.`);\n  }\n\n  // 4. The repository, described and never repaired. Continuing the very phase\n  // that was interrupted is the one case where uncommitted work is expected;\n  // anything else would be carrying changes into work they do not belong to.\n  const sameWork = interrupted === next;\n  const preflight = await preflightRepository({\n    expectedBranch: target.plan.noBranch === true ? null : target.plan.branchName,\n    intent: sameWork ? 'resume-same-phase' : 'new-phase',\n  });\n  if (!preflight.ok) {\n    printError(`Cannot resume issue #${target.issue}: the repository needs attention first.`);\n    for (const line of describePreflight(preflight)) {\n      printError(line);\n    }\n    return 1;\n  }\n\n  // 5. The phase, stated before anything runs.\n  printInfo(`Resuming issue #${target.issue} from the '${next}' phase.`);\n  return runPipeline(target.issue, mode, next, undefined, undefined, { only: true });\n}\n\n/** The phase set this plan's pipeline actually has, so `pr-review` is honoured. */\nfunction activePhases(plan: TaskPlan): readonly PipelinePhase[] {\n  const base =\n    plan.noBranch === true\n      ? PIPELINE_PHASES.filter((phase) => phase !== 'pr')\n      : [...PIPELINE_PHASES];\n  return plan.prReview?.enabled === true ? [...base, 'pr-review'] : base;\n}\n\n/**\n * The phase the journal shows as started and never ended.\n *\n * Both generations are read, oldest first, because a run long enough to rotate\n * its journal is exactly the kind that gets interrupted. A missing or\n * unreadable journal answers `null`: the resume continues from the plan, which\n * is what it did before a journal existed.\n */\nasync function lastUnfinishedPhase(target: ResumeTarget): Promise<string | null> {\n  const content = `${await readIfPresent(target.rotatedEventsFile)}${await readIfPresent(target.eventsFile)}`;\n  if (content === '') return null;\n\n  const open: string[] = [];\n  for (const entry of parseJournal(content)) {\n    const event = entry.event;\n    if (event.type === 'phase:start') {\n      open.push(event.phase);\n    } else if (event.type === 'phase:end') {\n      const index = open.lastIndexOf(event.phase);\n      if (index >= 0) open.splice(index, 1);\n    }\n  }\n  return open.at(-1) ?? null;\n}\n\nasync function readIfPresent(path: string): Promise<string> {\n  try {\n    return await readFile(path, 'utf-8');\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Which issues to resume.\n *\n * A named issue is taken at its word. Without one, the queue decides when there\n * is a queue — `nextQueueIssue()` is already the project's answer to \"which one\n * first\" — and otherwise the unfinished issues are ordered by when they were\n * last attempted, so `resume` alone picks up the most recent work.\n */\nasync function findTargets(\n  project: Awaited<ReturnType<typeof resolveProjectPaths>>,\n  issue: string | undefined,\n  all: boolean,\n): Promise<ResumeTarget[]> {\n  if (issue !== undefined) {\n    const target = await loadTarget(project.projectId, issue);\n    return target === null ? [] : [target];\n  }\n\n  const queued = await queueTarget(project);\n  if (queued !== null && !all) return [queued];\n\n  const unfinished = await unfinishedTargets(project);\n  if (all) return unfinished;\n  return unfinished.slice(0, 1);\n}\n\n/** The issue a queue would hand out next, when this project has a queue. */\nasync function queueTarget(\n  project: Awaited<ReturnType<typeof resolveProjectPaths>>,\n): Promise<ResumeTarget | null> {\n  const queuesDir = join(project.projectDir, QUEUES_DIR_NAME);\n  let entries: string[];\n  try {\n    entries = await readdir(queuesDir);\n  } catch {\n    return null;\n  }\n\n  for (const entry of entries) {\n    const plan = await loadExecutionPlan(join(queuesDir, entry, 'execution-plan.json'));\n    if (plan === null) continue;\n    const next = nextQueueIssue(plan);\n    if (next === null) continue;\n    const target = await loadTarget(project.projectId, next.id);\n    if (target !== null) return target;\n  }\n  return null;\n}\n\n/** Every issue whose plan is not finished, most recently attempted first. */\nasync function unfinishedTargets(\n  project: Awaited<ReturnType<typeof resolveProjectPaths>>,\n): Promise<ResumeTarget[]> {\n  let ids: string[];\n  try {\n    ids = await readdir(project.issuesDir);\n  } catch {\n    return [];\n  }\n\n  const targets: ResumeTarget[] = [];\n  for (const id of ids) {\n    const target = await loadTarget(project.projectId, id);\n    if (target === null) continue;\n    if (target.plan.issueStatus === 'completed') continue;\n    const manager = new PipelineManager(target.plan, target.tasksFile, activePhases(target.plan));\n    if (manager.getNextPhase() === null) continue;\n    targets.push(target);\n  }\n\n  return targets.sort((a, b) => attemptedAt(b.plan) - attemptedAt(a.plan));\n}\n\nfunction attemptedAt(plan: TaskPlan): number {\n  const at = Date.parse(plan.lastAttemptAt ?? '');\n  return Number.isNaN(at) ? 0 : at;\n}\n\nasync function loadTarget(projectId: string, issue: string): Promise<ResumeTarget | null> {\n  let paths: ReturnType<typeof getIssuePaths>;\n  try {\n    paths = getIssuePaths(projectId, issue);\n  } catch {\n    // Not a usable issue identifier — a stray file in `issues/`, for instance.\n    return null;\n  }\n\n  try {\n    const plan = await loadTaskPlan(paths.tasksFile);\n    return {\n      issue,\n      plan,\n      tasksFile: paths.tasksFile,\n      eventsFile: paths.eventsFile,\n      rotatedEventsFile: paths.rotatedEventsFile,\n    };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/review-7CREJDKB.js

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-import {
-  runReview
-} from "./chunk-MI5TREN3.js";
-import "./chunk-6YQT3SSM.js";
-import "./chunk-SGTTR4XW.js";
-import "./chunk-L6HSKTQE.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  runReview
-};
-//# sourceMappingURL=review-7CREJDKB.js.map

package/dist/routing-VCDYHSXA.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-import {
-  ROUTING_COMMAND_SCHEMA_VERSION,
-  runRoutingExplain,
-  runRoutingInspect,
-  runRoutingReport,
-  runRoutingUse,
-  writeRoutingPreference
-} from "./chunk-RCZJQUTC.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  ROUTING_COMMAND_SCHEMA_VERSION,
-  runRoutingExplain,
-  runRoutingInspect,
-  runRoutingReport,
-  runRoutingUse,
-  writeRoutingPreference
-};
-//# sourceMappingURL=routing-VCDYHSXA.js.map

package/dist/run-3MPORLF5.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-import {
-  publishIssueDetails,
-  publishStorySeed,
-  runPipeline
-} from "./chunk-HJBF4WD2.js";
-import "./chunk-B3TSS7BT.js";
-import "./chunk-LPWPFIIB.js";
-import "./chunk-Z5O2XBWA.js";
-import "./chunk-YUNBOUQH.js";
-import "./chunk-ANI2NTR4.js";
-import "./chunk-MI5TREN3.js";
-import "./chunk-A4H7P7T7.js";
-import "./chunk-ISZ54SVE.js";
-import "./chunk-KZXQWC7U.js";
-import "./chunk-2SUFAE6X.js";
-import "./chunk-6YQT3SSM.js";
-import "./chunk-SGTTR4XW.js";
-import "./chunk-CRGIQFUQ.js";
-import "./chunk-L6HSKTQE.js";
-import "./chunk-UWDCIFTP.js";
-import "./chunk-RCZJQUTC.js";
-import "./chunk-KZ5EY5XX.js";
-import "./chunk-32JSYXEK.js";
-import "./chunk-VE3IYNDN.js";
-import "./chunk-QMIQR7EE.js";
-import "./chunk-KMMASOA6.js";
-import "./chunk-HLAPOUEM.js";
-import "./chunk-7F7LGMVO.js";
-import "./chunk-UK4E2FUA.js";
-import "./chunk-WCCZJL7W.js";
-import "./chunk-DGRTJD5R.js";
-import "./chunk-D6ZBGJ3L.js";
-import "./chunk-C5TL7T4V.js";
-import "./chunk-3D4A4B46.js";
-import "./chunk-E6KXCV3T.js";
-import "./chunk-HY5HLFDU.js";
-import "./chunk-DV7HUC4Z.js";
-import "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-YII4U7ZD.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
-import "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
-export {
-  publishIssueDetails,
-  publishStorySeed,
-  runPipeline
-};
-//# sourceMappingURL=run-3MPORLF5.js.map

package/dist/usage-U7QNGCPK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/usage.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises';\nimport { loadTaskPlan } from '../core/state-manager.js';\nimport { getIssuePaths } from '../storage/paths.js';\nimport { resolveProjectPaths } from '../storage/resolve.js';\nimport { type GroupKey, groupBy, summarize } from '../telemetry/aggregate.js';\nimport { discardedExecutionCount } from '../telemetry/recorder.js';\nimport type { ExecutionRecord, ExecutionSummary } from '../telemetry/types.js';\nimport type { TaskPlan } from '../types.js';\nimport { printError, printInfo } from '../ui/logger.js';\n\nexport const USAGE_GROUP_KEYS = [\n  'harness',\n  'provider',\n  'model',\n  'purpose',\n  'status',\n] as const satisfies readonly GroupKey[];\n\nexport type UsageGroupKey = (typeof USAGE_GROUP_KEYS)[number];\n\nexport interface UsageOptions {\n  issue?: string;\n  since?: string;\n  by?: UsageGroupKey;\n  json?: boolean;\n}\n\nexport interface UsageReport {\n  issue: string | null;\n  since: string | null;\n  by: UsageGroupKey | null;\n  discarded: number;\n  total: ExecutionSummary;\n  groups: Array<{ key: string; summary: ExecutionSummary }>;\n}\n\nfunction sinceCutoff(since: string | undefined): number | null {\n  if (since === undefined || since === '') return null;\n  const parsed = Date.parse(since);\n  return Number.isNaN(parsed) ? null : parsed;\n}\n\nfunction afterCutoff(\n  records: readonly ExecutionRecord[],\n  cutoff: number | null,\n): ExecutionRecord[] {\n  if (cutoff === null) return [...records];\n  return records.filter((record) => Date.parse(record.startedAt) >= cutoff);\n}\n\nfunction formatUsd(amount: number): string {\n  return `$${amount.toFixed(2)}`;\n}\n\nfunction formatCost(summary: ExecutionSummary): string {\n  const parts: string[] = [];\n  if (summary.totalCost.reported > 0 || summary.totalCost.estimated === 0) {\n    if (summary.count > 0 && summary.totalCost.unknownExecutions < summary.count) {\n      parts.push(`${formatUsd(summary.totalCost.reported)} reportado`);\n    }\n  }\n  if (summary.totalCost.estimated > 0) {\n    parts.push(`${formatUsd(summary.totalCost.estimated)} estimado`);\n  }\n  if (summary.totalCost.unknownExecutions > 0) {\n    parts.push(`— desconhecido (${summary.totalCost.unknownExecutions})`);\n  }\n  return parts.length === 0 ? '—' : parts.join(' · ');\n}\n\nfunction formatTokens(summary: ExecutionSummary): string {\n  const total = summary.usage.inputTokens + summary.usage.outputTokens;\n  if (total >= 1_000_000) return `${(total / 1_000_000).toFixed(1)}M`;\n  if (total >= 1_000) return `${(total / 1_000).toFixed(1)}k`;\n  return String(total);\n}\n\nfunction successRate(summary: ExecutionSummary): string {\n  if (summary.count === 0) return '—';\n  const ok = summary.byStatus.completed ?? 0;\n  return `${((ok / summary.count) * 100).toFixed(1)}%`;\n}\n\nasync function loadPlans(\n  issue: string | undefined,\n): Promise<{ id: string; plan: TaskPlan }[] | null> {\n  let project: Awaited<ReturnType<typeof resolveProjectPaths>>;\n  try {\n    project = await resolveProjectPaths();\n  } catch (err) {\n    printError(`Not inside a usable project: ${err instanceof Error ? err.message : String(err)}`);\n    return null;\n  }\n\n  if (issue !== undefined) {\n    try {\n      const paths = getIssuePaths(project.projectId, issue);\n      return [{ id: issue, plan: await loadTaskPlan(paths.tasksFile) }];\n    } catch (err) {\n      printError(\n        `No telemetry for issue ${issue}: ${err instanceof Error ? err.message : String(err)}`,\n      );\n      return null;\n    }\n  }\n\n  let ids: string[];\n  try {\n    ids = await readdir(project.issuesDir);\n  } catch {\n    return [];\n  }\n\n  const loaded: { id: string; plan: TaskPlan }[] = [];\n  for (const id of ids) {\n    try {\n      loaded.push({\n        id,\n        plan: await loadTaskPlan(getIssuePaths(project.projectId, id).tasksFile),\n      });\n    } catch {\n      // An issue without a readable plan is not telemetry.\n    }\n  }\n  return loaded;\n}\n\nexport function buildUsageReport(\n  plans: { id: string; plan: TaskPlan }[],\n  options: UsageOptions,\n  discarded = 0,\n): UsageReport {\n  const cutoff = sinceCutoff(options.since);\n  const records = plans.flatMap(({ plan }) => afterCutoff(plan.executions ?? [], cutoff));\n  const total = summarize(records, discarded);\n  const groups =\n    options.by === undefined\n      ? []\n      : [...groupBy(records, options.by)].map(([key, summary]) => ({ key, summary }));\n  return {\n    issue: options.issue ?? (plans.length === 1 ? (plans[0]?.id ?? null) : null),\n    since: options.since ?? null,\n    by: options.by ?? null,\n    discarded,\n    total,\n    groups,\n  };\n}\n\nexport function formatUsageReport(report: UsageReport): string {\n  if (report.total.count === 0) {\n    return 'No execution telemetry recorded yet.';\n  }\n\n  const header = [\n    report.issue === null ? 'project' : `issue #${report.issue}`,\n    `${report.total.count} execução${report.total.count === 1 ? '' : 'ões'}`,\n    formatCost(report.total),\n  ].join(' · ');\n\n  if (report.by === null || report.groups.length === 0) {\n    return header;\n  }\n\n  const rows = report.groups.map((group) => {\n    const name = group.key.padEnd(14);\n    const count = String(group.summary.count).padStart(10);\n    const success = successRate(group.summary).padStart(8);\n    const tokens = formatTokens(group.summary).padStart(8);\n    return `${name}${count}${success}${tokens.padStart(10)}  ${formatCost(group.summary)}`;\n  });\n  const columns = `${report.by.padEnd(14)}${'execuções'.padStart(10)}${'sucesso'.padStart(8)}${'tokens'.padStart(10)}  custo`;\n  return [`${header}`, columns, ...rows].join('\\n');\n}\n\nexport async function runUsage(\n  issue: string | undefined,\n  options: UsageOptions = {},\n): Promise<number> {\n  const plans = await loadPlans(issue ?? options.issue);\n  if (plans === null) return 1;\n\n  if (options.since !== undefined && sinceCutoff(options.since) === null) {\n    printError(`Invalid --since date: ${options.since}`);\n    return 1;\n  }\n\n  const report = buildUsageReport(plans, { ...options, issue: issue ?? options.issue });\n  if (plans.length === 0 || (report.total.count === 0 && (issue ?? options.issue) !== undefined)) {\n    printInfo('No execution telemetry recorded yet.');\n    return 0;\n  }\n\n  if (options.json === true) {\n    printInfo(JSON.stringify(report, null, 2));\n    return 0;\n  }\n\n  printInfo(formatUsageReport(report));\n  return 0;\n}\n\nexport { discardedExecutionCount };\n"],"mappings":"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","names":[]}