issue-flow 0.12.0 → 0.14.0

package/dist/chunk-HAKDLR6N.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+// src/storage/paths.ts
+import { createHash } from "crypto";
+import { homedir } from "os";
+import { basename, join, resolve } from "path";
+var GLOBAL_DIR_NAME = ".issue-flow";
+var GLOBAL_ROOT_ENV = "ISSUE_FLOW_HOME";
+var PROJECTS_DIR_NAME = "projects";
+var LOGS_DIR_NAME = "logs";
+var ISSUES_DIR_NAME = "issues";
+var QUEUES_DIR_NAME = "queues";
+var RUN_LOCK_FILENAME = "run.lock";
+var PROVIDERS_HEALTH_FILENAME = "providers.json";
+var SESSION_FILENAME = "session.json";
+var EVENTS_FILENAME = "events.jsonl";
+var ROTATED_EVENTS_FILENAME = "events.1.jsonl";
+var VERIFY_FILENAME = "verify.json";
+var RUN_LOG_FILENAME = "run.log";
+var ROTATED_RUN_LOG_FILENAME = "run.log.1";
+function getGlobalRoot(options = {}) {
+  const env = options.env ?? process.env;
+  const override = env[GLOBAL_ROOT_ENV]?.trim();
+  if (override) {
+    return resolve(override);
+  }
+  let home;
+  try {
+    home = homedir();
+  } catch {
+    home = "";
+  }
+  if (home.trim() === "") {
+    throw new Error(
+      `Unable to resolve the home directory for the global storage. Set ${GLOBAL_ROOT_ENV} to an explicit path.`
+    );
+  }
+  return join(home, GLOBAL_DIR_NAME);
+}
+function getDiagnosticsDir(options = {}) {
+  return join(getGlobalRoot(options), LOGS_DIR_NAME);
+}
+var SLUG_MAX_LENGTH = 32;
+var HASH_LENGTH = 12;
+var FALLBACK_SLUG = "project";
+function slugify(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, SLUG_MAX_LENGTH).replace(/-+$/g, "");
+  return slug === "" ? FALLBACK_SLUG : slug;
+}
+function projectIdFromRemote(remote, projectRoot) {
+  let seed;
+  let name;
+  if (remote) {
+    seed = `remote:${remote}`;
+    name = remote.split("/").pop() ?? "";
+  } else {
+    const absolute = resolve(projectRoot);
+    seed = `path:${absolute}`;
+    name = basename(absolute);
+  }
+  const hash = createHash("sha256").update(seed).digest("hex").slice(0, HASH_LENGTH);
+  return `${slugify(name)}-${hash}`;
+}
+function getProjectDir(projectId, options = {}) {
+  return join(getGlobalRoot(options), PROJECTS_DIR_NAME, projectId);
+}
+function getQueuePaths(projectId, queueId, options = {}) {
+  const queueDir = join(
+    getProjectDir(projectId, options),
+    QUEUES_DIR_NAME,
+    normalizeIssueNumber(queueId)
+  );
+  return { queueDir, planFile: join(queueDir, "execution-plan.json") };
+}
+function normalizeIssueNumber(issueNumber) {
+  const normalized = String(issueNumber).trim().replace(/^#/, "");
+  if (normalized.length === 0) {
+    throw new Error("Issue identifier cannot be empty");
+  }
+  if (/[/\\]/.test(normalized) || normalized === "." || normalized === "..") {
+    throw new Error(`Invalid issue identifier: '${issueNumber}'`);
+  }
+  return normalized;
+}
+function getIssuePaths(projectId, issueNumber, options = {}) {
+  const issueDir = join(
+    getProjectDir(projectId, options),
+    ISSUES_DIR_NAME,
+    normalizeIssueNumber(issueNumber)
+  );
+  return {
+    issueDir,
+    issueFile: join(issueDir, "issue.md"),
+    metadataFile: join(issueDir, "metadata.json"),
+    prdFile: join(issueDir, "prd.md"),
+    tasksFile: join(issueDir, "tasks.json"),
+    progressFile: join(issueDir, "progress.txt"),
+    analysisFile: join(issueDir, "analysis.md"),
+    sessionFile: join(issueDir, SESSION_FILENAME),
+    // The journal, and the single generation kept when it rotates. The
+    // snapshot above is the projection; this pair is the history.
+    eventsFile: join(issueDir, EVENTS_FILENAME),
+    rotatedEventsFile: join(issueDir, ROTATED_EVENTS_FILENAME),
+    runLogFile: join(issueDir, RUN_LOG_FILENAME),
+    rotatedRunLogFile: join(issueDir, ROTATED_RUN_LOG_FILENAME),
+    // "This issue looks larger than one run": written only when the signals
+    // agree, and read by a person rather than by the pipeline.
+    decompositionFile: join(issueDir, "decomposition.md"),
+    verifyFile: join(issueDir, VERIFY_FILENAME),
+    lastBranchFile: join(issueDir, ".last-branch"),
+    archiveDir: join(issueDir, "archive"),
+    prReviewDir: join(issueDir, "pr-review")
+  };
+}
+
+export {
+  GLOBAL_ROOT_ENV,
+  PROJECTS_DIR_NAME,
+  ISSUES_DIR_NAME,
+  QUEUES_DIR_NAME,
+  RUN_LOCK_FILENAME,
+  PROVIDERS_HEALTH_FILENAME,
+  SESSION_FILENAME,
+  EVENTS_FILENAME,
+  ROTATED_EVENTS_FILENAME,
+  VERIFY_FILENAME,
+  getGlobalRoot,
+  getDiagnosticsDir,
+  projectIdFromRemote,
+  getProjectDir,
+  getQueuePaths,
+  getIssuePaths
+};
+//# sourceMappingURL=chunk-HAKDLR6N.js.map

package/dist/chunk-HAKDLR6N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/paths.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { homedir } from 'node:os';\nimport { basename, join, resolve } from 'node:path';\nimport { getRemoteUrl, normalizeRemoteUrl } from '../utils/git.js';\n\n/** Directory created under the user's home when no override is provided. */\nexport const GLOBAL_DIR_NAME = '.issue-flow';\n\n/** Environment variable that relocates the whole global storage tree. */\nexport const GLOBAL_ROOT_ENV = 'ISSUE_FLOW_HOME';\n\n/** Directory under the global root holding one folder per project. */\nexport const PROJECTS_DIR_NAME = 'projects';\n\n/** Machine-wide structured diagnostic logs, independent of any project. */\nexport const LOGS_DIR_NAME = 'logs';\n\n/** Directory under a project holding one folder per issue. */\nexport const ISSUES_DIR_NAME = 'issues';\n\n/** Directory under a project holding one folder per multi-issue execution queue. */\nexport const QUEUES_DIR_NAME = 'queues';\n\n/** Run-ownership lock, a sibling of `issues/` inside the project directory. */\nexport const RUN_LOCK_FILENAME = 'run.lock';\n\n/** Persisted agent-provider health, shared by every run of one project. */\nexport const PROVIDERS_HEALTH_FILENAME = 'providers.json';\n\n/** Projection and journal filenames shared by storage and the web reader. */\nexport const SESSION_FILENAME = 'session.json';\nexport const EVENTS_FILENAME = 'events.jsonl';\nexport const ROTATED_EVENTS_FILENAME = 'events.1.jsonl';\n/**\n * Acceptance-contract evidence. Named here — and not at the call site — because\n * `verify/run-issue.ts` also writes it in standalone mode, where there is no\n * `IssuePaths` to ask: one constant, two callers, no second spelling.\n */\nexport const VERIFY_FILENAME = 'verify.json';\n\nexport const RUN_LOG_FILENAME = 'run.log';\nexport const ROTATED_RUN_LOG_FILENAME = 'run.log.1';\n\nexport interface GetGlobalRootOptions {\n  /** Environment source. Defaults to process.env. */\n  env?: NodeJS.ProcessEnv;\n}\n\n/**\n * Resolve the root directory of the global storage tree (`~/.issue-flow`).\n *\n * Every path under the global storage MUST be derived from this function: it is\n * the single seam where `ISSUE_FLOW_HOME` takes effect, which is what lets\n * tests, CI and sandboxes point the whole tree at a temporary directory instead\n * of touching the real `$HOME`. A call site that joins `homedir()` by hand\n * silently opts out of that isolation.\n *\n * Pure and synchronous: it never creates directories nor touches the\n * filesystem — callers decide when (and whether) the directory should exist.\n */\nexport function getGlobalRoot(options: GetGlobalRootOptions = {}): string {\n  const env = options.env ?? process.env;\n\n  const override = env[GLOBAL_ROOT_ENV]?.trim();\n  if (override) {\n    // A relative override is resolved against the CWD so that every consumer\n    // gets an absolute path, exactly as in the homedir() branch below.\n    return resolve(override);\n  }\n\n  // The only failure mode: an environment where the home directory cannot be\n  // determined (some containers and CI images). The override is the escape\n  // hatch, so the error names it.\n  let home: string;\n  try {\n    home = homedir();\n  } catch {\n    home = '';\n  }\n  if (home.trim() === '') {\n    throw new Error(\n      `Unable to resolve the home directory for the global storage. Set ${GLOBAL_ROOT_ENV} to an explicit path.`,\n    );\n  }\n\n  return join(home, GLOBAL_DIR_NAME);\n}\n\nexport function getDiagnosticsDir(options: GetGlobalRootOptions = {}): string {\n  return join(getGlobalRoot(options), LOGS_DIR_NAME);\n}\n\n/** Maximum length of the human-readable half of a project id. */\nconst SLUG_MAX_LENGTH = 32;\n\n/** Number of hex characters kept from the sha256 of the seed. */\nconst HASH_LENGTH = 12;\n\n/** Used when the repository name has no character that survives sanitization. */\nconst FALLBACK_SLUG = 'project';\n\n/**\n * Reduce an arbitrary repository name to a path-safe slug: lowercase, only\n * `[a-z0-9-]`, runs of separators collapsed, truncated to {@link SLUG_MAX_LENGTH}.\n */\nfunction slugify(name: string): string {\n  const slug = name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, SLUG_MAX_LENGTH)\n    .replace(/-+$/g, '');\n\n  return slug === '' ? FALLBACK_SLUG : slug;\n}\n\n/**\n * Derive a stable identifier for a project, in the form `<slug>-<hash12>`.\n *\n * The seed is canonical rather than local, so the same repository yields the\n * same id on any machine: `remote:<normalizedRemote>` whenever an `origin`\n * remote exists, falling back to `path:<absoluteProjectRoot>` when it does not.\n * That is what makes moving or renaming the local folder harmless for a cloned\n * repository — the history stays attached to the remote identity.\n *\n * The `remote:` / `path:` prefix is part of the hashed seed, so a project\n * identified by path can never collide with one identified by remote even if\n * the two strings were to coincide. The slug is only cosmetic (it makes the\n * directory recognizable); the hash carries the identity.\n *\n * Known limitation of the path fallback: for a repository with no `origin`\n * remote, the absolute path *is* the identity. Moving or renaming that folder\n * produces a different id, and the previous history is left behind under the\n * old one. Configuring a remote before adopting the global storage avoids it.\n */\nexport async function getProjectId(projectRoot: string): Promise<string> {\n  const remote = normalizeRemoteUrl(await getRemoteUrl(projectRoot));\n  return projectIdFromRemote(remote, projectRoot);\n}\n\n/**\n * Pure half of {@link getProjectId}: derive the id once the normalized remote\n * (or `null`) is already known.\n *\n * Exported so a caller that already resolved the remote for another reason\n * (e.g. {@link resolveStorageMode} in `compat.ts`, which also persists it into\n * `metadata.json`) can compute the id without shelling out to git a second\n * time.\n */\nexport function projectIdFromRemote(remote: string | null, projectRoot: string): string {\n  let seed: string;\n  let name: string;\n  if (remote) {\n    // `host/org/repo` -> the repository name is the last path segment.\n    seed = `remote:${remote}`;\n    name = remote.split('/').pop() ?? '';\n  } else {\n    const absolute = resolve(projectRoot);\n    seed = `path:${absolute}`;\n    name = basename(absolute);\n  }\n\n  const hash = createHash('sha256').update(seed).digest('hex').slice(0, HASH_LENGTH);\n\n  return `${slugify(name)}-${hash}`;\n}\n\n/**\n * Absolute directory of a project inside the global storage tree.\n *\n * `projectId` is expected to come from {@link getProjectId}, which already\n * guarantees a single safe path segment.\n */\nexport function getProjectDir(projectId: string, options: GetGlobalRootOptions = {}): string {\n  return join(getGlobalRoot(options), PROJECTS_DIR_NAME, projectId);\n}\n\n/**\n * Every artifact of one issue, resolved from a single place.\n *\n * Note that `prdFile` is the requirements document (`prd.md`) and `tasksFile`\n * is the task plan (`tasks.json`) — unlike `ResolvedPaths.prdFile` in\n * `types.ts`, which historically points at `tasks.json`.\n */\nexport interface IssuePaths {\n  issueDir: string;\n  issueFile: string;\n  metadataFile: string;\n  prdFile: string;\n  tasksFile: string;\n  progressFile: string;\n  analysisFile: string;\n  sessionFile: string;\n  eventsFile: string;\n  rotatedEventsFile: string;\n  runLogFile: string;\n  rotatedRunLogFile: string;\n  decompositionFile: string;\n  verifyFile: string;\n  lastBranchFile: string;\n  archiveDir: string;\n  prReviewDir: string;\n}\n\n/**\n * Artifacts of one multi-issue execution queue.\n *\n * A queue coordinates several issues that share a branch; each issue keeps its\n * own directory under {@link ISSUES_DIR_NAME} exactly as before, and only the\n * coordination state (order, per-issue status, shared branch, consolidated Pull\n * Request) lives here. That is what keeps a single-issue run byte-identical: it\n * never creates a queue at all.\n */\nexport interface QueuePaths {\n  queueDir: string;\n  planFile: string;\n}\n\n/**\n * Resolve the paths of one execution queue under the global storage.\n *\n * The queue id is the identifier of the primary issue — the first one the user\n * asked for — so re-running the same command finds the same queue and resumes\n * it instead of starting a parallel one.\n *\n * Pure and synchronous like every other helper here: nothing is created.\n */\nexport function getQueuePaths(\n  projectId: string,\n  queueId: string | number,\n  options: GetGlobalRootOptions = {},\n): QueuePaths {\n  const queueDir = join(\n    getProjectDir(projectId, options),\n    QUEUES_DIR_NAME,\n    normalizeIssueNumber(queueId),\n  );\n\n  return { queueDir, planFile: join(queueDir, 'execution-plan.json') };\n}\n\n/**\n * Issue identifiers become path segments, so anything that could escape the\n * issues directory is rejected before it reaches `join` — the same discipline\n * as `normalizeId()` in `issues/providers/local.ts`.\n *\n * Non-numeric identifiers (`auth-refactor`, `pr-184`) are first-class here:\n * the local provider already supports them, so the global storage must too.\n */\nfunction normalizeIssueNumber(issueNumber: string | number): string {\n  const normalized = String(issueNumber).trim().replace(/^#/, '');\n\n  if (normalized.length === 0) {\n    throw new Error('Issue identifier cannot be empty');\n  }\n  if (/[/\\\\]/.test(normalized) || normalized === '.' || normalized === '..') {\n    throw new Error(`Invalid issue identifier: '${issueNumber}'`);\n  }\n\n  return normalized;\n}\n\n/**\n * Resolve every path of a single issue under the global storage.\n *\n * This is the only place allowed to know the layout of an issue directory:\n * call sites ask for the artifact they need instead of joining names by hand,\n * so renaming or adding an artifact stays a one-file change.\n *\n * Pure and synchronous: nothing here creates directories or touches the\n * filesystem.\n */\nexport function getIssuePaths(\n  projectId: string,\n  issueNumber: string | number,\n  options: GetGlobalRootOptions = {},\n): IssuePaths {\n  const issueDir = join(\n    getProjectDir(projectId, options),\n    ISSUES_DIR_NAME,\n    normalizeIssueNumber(issueNumber),\n  );\n\n  return {\n    issueDir,\n    issueFile: join(issueDir, 'issue.md'),\n    metadataFile: join(issueDir, 'metadata.json'),\n    prdFile: join(issueDir, 'prd.md'),\n    tasksFile: join(issueDir, 'tasks.json'),\n    progressFile: join(issueDir, 'progress.txt'),\n    analysisFile: join(issueDir, 'analysis.md'),\n    sessionFile: join(issueDir, SESSION_FILENAME),\n    // The journal, and the single generation kept when it rotates. The\n    // snapshot above is the projection; this pair is the history.\n    eventsFile: join(issueDir, EVENTS_FILENAME),\n    rotatedEventsFile: join(issueDir, ROTATED_EVENTS_FILENAME),\n    runLogFile: join(issueDir, RUN_LOG_FILENAME),\n    rotatedRunLogFile: join(issueDir, ROTATED_RUN_LOG_FILENAME),\n    // \"This issue looks larger than one run\": written only when the signals\n    // agree, and read by a person rather than by the pipeline.\n    decompositionFile: join(issueDir, 'decomposition.md'),\n    verifyFile: join(issueDir, VERIFY_FILENAME),\n    lastBranchFile: join(issueDir, '.last-branch'),\n    archiveDir: join(issueDir, 'archive'),\n    prReviewDir: join(issueDir, 'pr-review'),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-J3SOTUVI.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+import {
+  isProcessAlive,
+  taskPlanSchema
+} from "./chunk-LBGHI4S2.js";
+import {
+  writeFileAtomic
+} from "./chunk-7Z4Y3VKM.js";
+
+// src/core/state-manager.ts
+import { readFile } from "fs/promises";
+import { ZodError } from "zod";
+
+// src/telemetry/reconcile.ts
+import { hostname } from "os";
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function reconcileInterruptedExecutions(plan) {
+  if (plan.executions === void 0 || plan.executions.length === 0) return plan;
+  let changed = false;
+  const executions = plan.executions.map((record) => {
+    if (record.status !== "running" || record.finishedAt !== null) return record;
+    const owner = record.owner;
+    if (owner === void 0 || owner === null) {
+      changed = true;
+      return { ...record, status: "interrupted", finishedAt: nowIso(), owner: null };
+    }
+    if (owner.host !== hostname()) return record;
+    if (isProcessAlive(owner.pid)) return record;
+    changed = true;
+    return { ...record, status: "interrupted", finishedAt: nowIso(), owner: null };
+  });
+  return changed ? { ...plan, executions } : plan;
+}
+
+// src/core/metrics.ts
+var USAGE_FIELDS = [
+  "inputTokens",
+  "outputTokens",
+  "cacheReadTokens",
+  "cacheCreationTokens",
+  "costUsd"
+];
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseCodexUsage(payload) {
+  if (!isRecord(payload)) return null;
+  const usage = {};
+  const inputTokens = num(payload.input_tokens);
+  const cachedInput = num(payload.cached_input_tokens);
+  const cacheWrite = num(payload.cache_write_input_tokens);
+  const outputTokens = num(payload.output_tokens);
+  if (inputTokens !== void 0) {
+    usage.inputTokens = cachedInput !== void 0 ? Math.max(0, inputTokens - cachedInput) : inputTokens;
+  }
+  if (outputTokens !== void 0) usage.outputTokens = outputTokens;
+  if (cachedInput !== void 0) usage.cacheReadTokens = cachedInput;
+  if (cacheWrite !== void 0) usage.cacheCreationTokens = cacheWrite;
+  return Object.keys(usage).length > 0 ? usage : null;
+}
+function parseUsage(payload) {
+  if (!isRecord(payload)) return null;
+  const usageRaw = isRecord(payload.usage) ? payload.usage : void 0;
+  const usage = {};
+  const inputTokens = usageRaw ? num(usageRaw.input_tokens) : void 0;
+  const outputTokens = usageRaw ? num(usageRaw.output_tokens) : void 0;
+  const cacheReadTokens = usageRaw ? num(usageRaw.cache_read_input_tokens) : void 0;
+  const cacheCreationTokens = usageRaw ? num(usageRaw.cache_creation_input_tokens) : void 0;
+  const costUsd = num(payload.total_cost_usd);
+  const legacyInput = num(payload.num_input_tokens);
+  const legacyOutput = num(payload.num_output_tokens);
+  const legacyCost = num(payload.cost_usd);
+  const resolvedInput = inputTokens ?? legacyInput;
+  const resolvedOutput = outputTokens ?? legacyOutput;
+  const resolvedCost = costUsd ?? legacyCost;
+  if (resolvedInput !== void 0) usage.inputTokens = resolvedInput;
+  if (resolvedOutput !== void 0) usage.outputTokens = resolvedOutput;
+  if (cacheReadTokens !== void 0) usage.cacheReadTokens = cacheReadTokens;
+  if (cacheCreationTokens !== void 0) usage.cacheCreationTokens = cacheCreationTokens;
+  if (resolvedCost !== void 0) usage.costUsd = resolvedCost;
+  const cliDurationMs = num(payload.duration_ms);
+  const apiDurationMs = num(payload.duration_api_ms);
+  const ttftMs = num(payload.ttft_ms) ?? num(payload.time_to_first_token_ms);
+  const numTurns = num(payload.num_turns);
+  if (cliDurationMs !== void 0) usage.cliDurationMs = cliDurationMs;
+  if (apiDurationMs !== void 0) usage.apiDurationMs = apiDurationMs;
+  if (ttftMs !== void 0) usage.ttftMs = ttftMs;
+  if (numTurns !== void 0) usage.numTurns = numTurns;
+  return Object.keys(usage).length > 0 ? usage : null;
+}
+function sumUsage(a, b) {
+  const result = {};
+  for (const field of USAGE_FIELDS) {
+    const left = a?.[field];
+    const right = b?.[field];
+    if (left === void 0 && right === void 0) continue;
+    result[field] = (left ?? 0) + (right ?? 0);
+  }
+  return result;
+}
+function divideUsage(usage, parts) {
+  const result = {};
+  if (!usage) return result;
+  const divisor = Number.isFinite(parts) && parts > 1 ? parts : 1;
+  for (const field of USAGE_FIELDS) {
+    const value = usage[field];
+    if (value === void 0) continue;
+    result[field] = field === "costUsd" ? value / divisor : Math.round(value / divisor);
+  }
+  return result;
+}
+function compactTokens(value) {
+  const abs = Math.abs(value);
+  if (abs >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (abs >= 1e3) return `${(value / 1e3).toFixed(1)}k`;
+  return String(Math.round(value));
+}
+function formatTokens(usage) {
+  if (!usage) return "";
+  const segments = [];
+  const io = [];
+  if (usage.inputTokens !== void 0) io.push(`${compactTokens(usage.inputTokens)} in`);
+  if (usage.outputTokens !== void 0) io.push(`${compactTokens(usage.outputTokens)} out`);
+  if (io.length > 0) segments.push(io.join(" / "));
+  const cache = usage.cacheReadTokens !== void 0 || usage.cacheCreationTokens !== void 0 ? (usage.cacheReadTokens ?? 0) + (usage.cacheCreationTokens ?? 0) : void 0;
+  if (cache !== void 0) segments.push(`${compactTokens(cache)} cache`);
+  if (usage.costUsd !== void 0) segments.push(`~$${usage.costUsd.toFixed(4)}`);
+  return segments.join(" \xB7 ");
+}
+function hasUsageData(usage) {
+  if (!usage) return false;
+  return USAGE_FIELDS.some((field) => usage[field] !== void 0);
+}
+
+// src/core/state-manager.ts
+function isoNow() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+async function loadTaskPlan(path) {
+  const content = await readFile(path, "utf-8");
+  const raw = JSON.parse(content);
+  try {
+    const parsed = taskPlanSchema.parse(raw);
+    const reconciled = reconcileInterruptedExecutions(parsed);
+    if (reconciled !== parsed) {
+      try {
+        await saveTaskPlan(path, reconciled);
+      } catch {
+      }
+    }
+    return reconciled;
+  } catch (err) {
+    if (err instanceof ZodError) {
+      const issues = err.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new Error(`Invalid tasks.json at ${path}:
+${issues}`);
+    }
+    throw err;
+  }
+}
+async function saveTaskPlan(path, plan) {
+  await writeFileAtomic(path, `${JSON.stringify(plan, null, 2)}
+`);
+}
+function initializeState(plan) {
+  const defaultPipeline = {
+    prdCompleted: false,
+    jsonCompleted: false,
+    executionCompleted: false,
+    reviewCompleted: false,
+    prCreated: false
+  };
+  return {
+    ...plan,
+    issueStatus: plan.issueStatus ?? "pending",
+    completedAt: plan.completedAt ?? null,
+    lastAttemptAt: plan.lastAttemptAt ?? null,
+    lastError: plan.lastError ?? null,
+    correctionCycle: plan.correctionCycle ?? 0,
+    maxCorrectionCycles: plan.maxCorrectionCycles ?? 3,
+    lastReviewFindings: plan.lastReviewFindings ?? null,
+    pipeline: plan.pipeline ? { ...defaultPipeline, ...plan.pipeline } : defaultPipeline
+  };
+}
+function hasPendingCorrection(plan) {
+  return Boolean(plan.lastReviewFindings);
+}
+function allStoriesPass(plan) {
+  if (plan.userStories.length === 0) {
+    return false;
+  }
+  return plan.userStories.every((story) => story.passes === true);
+}
+function selectActiveStory(stories) {
+  return [...stories].filter((story) => !story.passes).sort((a, b) => a.priority - b.priority)[0];
+}
+function markStoryPassing(plan, storyId) {
+  return {
+    ...plan,
+    userStories: plan.userStories.map(
+      (story) => story.id === storyId ? { ...story, passes: true } : story
+    )
+  };
+}
+function applyStoryMetrics(plan, storyIds, share, durationSeconds) {
+  if (storyIds.length === 0) return plan;
+  const targets = new Set(storyIds);
+  return {
+    ...plan,
+    userStories: plan.userStories.map((story) => {
+      if (!targets.has(story.id)) return story;
+      const updated = { ...story, ...sumUsage(story, share) };
+      if (story.durationSeconds !== void 0 || durationSeconds !== void 0) {
+        updated.durationSeconds = (story.durationSeconds ?? 0) + (durationSeconds ?? 0);
+      }
+      return updated;
+    })
+  };
+}
+function markIssueInProgress(plan, timestamp) {
+  const ts = timestamp ?? isoNow();
+  return {
+    ...plan,
+    issueStatus: "in_progress",
+    completedAt: null,
+    lastAttemptAt: ts
+  };
+}
+function markIssueCompleted(plan) {
+  const ts = isoNow();
+  return {
+    ...plan,
+    issueStatus: "completed",
+    completedAt: ts,
+    lastAttemptAt: ts,
+    lastError: null,
+    pipeline: plan.pipeline ? { ...plan.pipeline, executionCompleted: true } : plan.pipeline
+  };
+}
+function setLastError(plan, category, message) {
+  const ts = isoNow();
+  const error = {
+    category,
+    message,
+    at: ts
+  };
+  return {
+    ...plan,
+    lastAttemptAt: ts,
+    lastError: error
+  };
+}
+function clearLastError(plan, attemptStartedAt) {
+  const ts = isoNow();
+  if (plan.lastError && plan.lastError.at > attemptStartedAt) {
+    return {
+      ...plan,
+      lastAttemptAt: ts
+    };
+  }
+  return {
+    ...plan,
+    lastAttemptAt: ts,
+    lastError: null
+  };
+}
+function trimErrorMessage(message) {
+  return message.split("\n").filter((line) => line.trim().length > 0).slice(0, 8).join("\n");
+}
+
+export {
+  parseCodexUsage,
+  parseUsage,
+  sumUsage,
+  divideUsage,
+  formatTokens,
+  hasUsageData,
+  isoNow,
+  loadTaskPlan,
+  saveTaskPlan,
+  initializeState,
+  hasPendingCorrection,
+  allStoriesPass,
+  selectActiveStory,
+  markStoryPassing,
+  applyStoryMetrics,
+  markIssueInProgress,
+  markIssueCompleted,
+  setLastError,
+  clearLastError,
+  trimErrorMessage
+};
+//# sourceMappingURL=chunk-J3SOTUVI.js.map

package/dist/chunk-J3SOTUVI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/state-manager.ts","../src/telemetry/reconcile.ts","../src/core/metrics.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { ZodError } from 'zod';\nimport { taskPlanSchema } from '../schemas.js';\nimport { reconcileInterruptedExecutions } from '../telemetry/reconcile.js';\nimport type { LastError, PipelineState, TaskPlan, UserStory } from '../types.js';\nimport { writeFileAtomic } from '../utils/fs.js';\nimport { type ClaudeUsage, sumUsage } from './metrics.js';\n\n/**\n * Get the current ISO timestamp.\n */\nexport function isoNow(): string {\n  return new Date().toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\n/**\n * Load and parse a tasks.json file.\n * Validates that it has the expected structure.\n */\nexport async function loadTaskPlan(path: string): Promise<TaskPlan> {\n  const content = await readFile(path, 'utf-8');\n  const raw = JSON.parse(content);\n\n  try {\n    const parsed = taskPlanSchema.parse(raw) as TaskPlan;\n    const reconciled = reconcileInterruptedExecutions(parsed);\n    if (reconciled !== parsed) {\n      try {\n        await saveTaskPlan(path, reconciled);\n      } catch {\n        // Observational: a failed persist of interrupted status still returns\n        // the reconciled plan to this reader.\n      }\n    }\n    return reconciled;\n  } catch (err) {\n    if (err instanceof ZodError) {\n      const issues = err.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n');\n      throw new Error(`Invalid tasks.json at ${path}:\\n${issues}`);\n    }\n    throw err;\n  }\n}\n\n/**\n * Save a TaskPlan to disk atomically (write-to-temp + rename).\n * This prevents corruption if the process is interrupted during write.\n */\nexport async function saveTaskPlan(path: string, plan: TaskPlan): Promise<void> {\n  await writeFileAtomic(path, `${JSON.stringify(plan, null, 2)}\\n`);\n}\n\n/**\n * Initialize default state fields on a TaskPlan.\n * Fills in missing fields with defaults, matching the Bash script behavior.\n *\n * The opt-in fields (`pullRequest`, `prReview`, `pipeline.prReviewCompleted`)\n * are deliberately absent from the defaults: they ride along on the spread when\n * present and stay out of the file entirely when the phases never ran.\n */\nexport function initializeState(plan: TaskPlan): TaskPlan {\n  const defaultPipeline: PipelineState = {\n    prdCompleted: false,\n    jsonCompleted: false,\n    executionCompleted: false,\n    reviewCompleted: false,\n    prCreated: false,\n  };\n\n  return {\n    ...plan,\n    issueStatus: plan.issueStatus ?? 'pending',\n    completedAt: plan.completedAt ?? null,\n    lastAttemptAt: plan.lastAttemptAt ?? null,\n    lastError: plan.lastError ?? null,\n    correctionCycle: plan.correctionCycle ?? 0,\n    maxCorrectionCycles: plan.maxCorrectionCycles ?? 3,\n    lastReviewFindings: plan.lastReviewFindings ?? null,\n    pipeline: plan.pipeline ? { ...defaultPipeline, ...plan.pipeline } : defaultPipeline,\n  };\n}\n\n/**\n * Whether the issue has a review failure that execute must still address,\n * even if every userStories[].passes is already true.\n */\nexport function hasPendingCorrection(plan: TaskPlan): boolean {\n  return Boolean(plan.lastReviewFindings);\n}\n\n/**\n * Check if all user stories have passes=true.\n * Returns false if there are no stories.\n */\nexport function allStoriesPass(plan: TaskPlan): boolean {\n  if (plan.userStories.length === 0) {\n    return false;\n  }\n\n  return plan.userStories.every((story) => story.passes === true);\n}\n\n/**\n * The story `execute` should work on next: the highest-priority (lowest\n * `priority` number) story with `passes: false`. This is the exact same rule\n * `prompts/execute.md` gives the agent (\"pick the highest priority user\n * story where `passes: false`\") — kept here as a single, pure, exported\n * helper so the engine's `iteration:start` publication and the terminal\n * renderer read the same computed identity instead of two independent\n * heuristics.\n *\n * Pure: never mutates `stories`. Returns `undefined` when every story\n * already passes (or the plan has none).\n */\nexport function selectActiveStory(stories: readonly UserStory[]): UserStory | undefined {\n  return [...stories].filter((story) => !story.passes).sort((a, b) => a.priority - b.priority)[0];\n}\n\n/**\n * Mark a specific story as passing.\n */\nexport function markStoryPassing(plan: TaskPlan, storyId: string): TaskPlan {\n  return {\n    ...plan,\n    userStories: plan.userStories.map((story) =>\n      story.id === storyId ? { ...story, passes: true } : story,\n    ),\n  };\n}\n\n/**\n * Accumulate a usage share (and duration) onto the given stories.\n *\n * Pure, like the rest of this module: returns a new plan and never touches the\n * input. Accumulation is summing and treats `undefined` as \"not reported\": a\n * field neither the story nor the share carries stays absent, so a plan written\n * by a CLI that reports no usage never gains artificial zeros.\n *\n * The share is what `divideUsage()` already split across the stories that\n * completed in the same execute iteration — see core/engine.ts.\n */\nexport function applyStoryMetrics(\n  plan: TaskPlan,\n  storyIds: string[],\n  share: ClaudeUsage,\n  durationSeconds?: number,\n): TaskPlan {\n  if (storyIds.length === 0) return plan;\n\n  const targets = new Set(storyIds);\n\n  return {\n    ...plan,\n    userStories: plan.userStories.map((story) => {\n      if (!targets.has(story.id)) return story;\n\n      const updated: UserStory = { ...story, ...sumUsage(story, share) };\n      if (story.durationSeconds !== undefined || durationSeconds !== undefined) {\n        updated.durationSeconds = (story.durationSeconds ?? 0) + (durationSeconds ?? 0);\n      }\n      return updated;\n    }),\n  };\n}\n\n/**\n * Mark the issue as in_progress.\n */\nexport function markIssueInProgress(plan: TaskPlan, timestamp?: string): TaskPlan {\n  const ts = timestamp ?? isoNow();\n  return {\n    ...plan,\n    issueStatus: 'in_progress',\n    completedAt: null,\n    lastAttemptAt: ts,\n  };\n}\n\n/**\n * Mark the issue as completed.\n */\nexport function markIssueCompleted(plan: TaskPlan): TaskPlan {\n  const ts = isoNow();\n  return {\n    ...plan,\n    issueStatus: 'completed',\n    completedAt: ts,\n    lastAttemptAt: ts,\n    lastError: null,\n    pipeline: plan.pipeline ? { ...plan.pipeline, executionCompleted: true } : plan.pipeline,\n  };\n}\n\n/**\n * Set the lastError field on the task plan.\n */\nexport function setLastError(plan: TaskPlan, category: string, message: string): TaskPlan {\n  const ts = isoNow();\n  const error: LastError = {\n    category,\n    message,\n    at: ts,\n  };\n\n  return {\n    ...plan,\n    lastAttemptAt: ts,\n    lastError: error,\n  };\n}\n\n/**\n * Clear the lastError field, but only if it was set before the attempt started.\n * This prevents clearing errors that were set during the current attempt.\n */\nexport function clearLastError(plan: TaskPlan, attemptStartedAt: string): TaskPlan {\n  const ts = isoNow();\n\n  // If the error was set after the attempt started, keep it\n  if (plan.lastError && plan.lastError.at > attemptStartedAt) {\n    return {\n      ...plan,\n      lastAttemptAt: ts,\n    };\n  }\n\n  return {\n    ...plan,\n    lastAttemptAt: ts,\n    lastError: null,\n  };\n}\n\n/**\n * Trim an error message to at most 8 non-empty lines.\n */\nexport function trimErrorMessage(message: string): string {\n  return message\n    .split('\\n')\n    .filter((line) => line.trim().length > 0)\n    .slice(0, 8)\n    .join('\\n');\n}\n","import { hostname } from 'node:os';\nimport { isProcessAlive } from '../storage/lock.js';\nimport type { TaskPlan } from '../types.js';\n\nfunction nowIso(): string {\n  return new Date().toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\n/**\n * Convert orphan `running` records to `interrupted` using the two-signal\n * rule from `storage/lock.ts`: a pid on this host that is gone.\n *\n * A record owned by another host is left `running` — we cannot see that pid.\n */\nexport function reconcileInterruptedExecutions(plan: TaskPlan): TaskPlan {\n  if (plan.executions === undefined || plan.executions.length === 0) return plan;\n  let changed = false;\n  const executions = plan.executions.map((record) => {\n    if (record.status !== 'running' || record.finishedAt !== null) return record;\n    const owner = record.owner;\n    if (owner === undefined || owner === null) {\n      changed = true;\n      return { ...record, status: 'interrupted' as const, finishedAt: nowIso(), owner: null };\n    }\n    if (owner.host !== hostname()) return record;\n    if (isProcessAlive(owner.pid)) return record;\n    changed = true;\n    return { ...record, status: 'interrupted' as const, finishedAt: nowIso(), owner: null };\n  });\n  return changed ? { ...plan, executions } : plan;\n}\n","/**\n * Single source of truth for translating the `claude` CLI JSON output into\n * token/cost metrics.\n *\n * Three call sites consume this (headless json, headless stream-json and the\n * execute-phase executor); keeping the parsing here is what stops them from\n * diverging again the next time the CLI payload changes shape.\n */\n\nexport interface ClaudeUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  cacheReadTokens?: number;\n  cacheCreationTokens?: number;\n  costUsd?: number;\n  /** Envelope `duration_ms` — request onward, not process startup. */\n  cliDurationMs?: number;\n  /** Envelope `duration_api_ms` when the harness reports it. */\n  apiDurationMs?: number;\n  /** Time to first output, when the harness reports it. */\n  ttftMs?: number;\n  numTurns?: number;\n}\n\n/** Field names of {@link ClaudeUsage}, used by the summing helper. */\nconst USAGE_FIELDS = [\n  'inputTokens',\n  'outputTokens',\n  'cacheReadTokens',\n  'cacheCreationTokens',\n  'costUsd',\n] as const;\n\n/**\n * Coerce a value to a finite number, or undefined when it is absent/unusable.\n * Never throws — malformed payloads simply yield undefined.\n */\nfunction num(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\n/**\n * Parse a `claude` CLI result payload into a {@link ClaudeUsage}.\n *\n * Reads the current format (`total_cost_usd` plus a nested `usage` object) and\n * falls back to the legacy flat keys (`cost_usd`, `num_input_tokens`,\n * `num_output_tokens`) when the newer ones are absent.\n *\n * Returns null when the payload carries no recognizable field at all, and a\n * partial object when only some fields are present. Never throws.\n */\n/**\n * Parse a Codex `turn.completed.usage` object.\n *\n * Codex reports `input_tokens` including the cache (Decision 6 of #62), so\n * `inputTokens` is `input_tokens − cached_input_tokens`, clamped at 0. Codex\n * never reports USD; `costUsd` stays absent — \"not reported\", never zero.\n */\nexport function parseCodexUsage(payload: unknown): ClaudeUsage | null {\n  if (!isRecord(payload)) return null;\n\n  const usage: ClaudeUsage = {};\n  const inputTokens = num(payload.input_tokens);\n  const cachedInput = num(payload.cached_input_tokens);\n  const cacheWrite = num(payload.cache_write_input_tokens);\n  const outputTokens = num(payload.output_tokens);\n\n  if (inputTokens !== undefined) {\n    usage.inputTokens =\n      cachedInput !== undefined ? Math.max(0, inputTokens - cachedInput) : inputTokens;\n  }\n  if (outputTokens !== undefined) usage.outputTokens = outputTokens;\n  if (cachedInput !== undefined) usage.cacheReadTokens = cachedInput;\n  if (cacheWrite !== undefined) usage.cacheCreationTokens = cacheWrite;\n\n  return Object.keys(usage).length > 0 ? usage : null;\n}\n\nexport function parseUsage(payload: unknown): ClaudeUsage | null {\n  if (!isRecord(payload)) return null;\n\n  const usageRaw = isRecord(payload.usage) ? payload.usage : undefined;\n\n  const usage: ClaudeUsage = {};\n\n  const inputTokens = usageRaw ? num(usageRaw.input_tokens) : undefined;\n  const outputTokens = usageRaw ? num(usageRaw.output_tokens) : undefined;\n  const cacheReadTokens = usageRaw ? num(usageRaw.cache_read_input_tokens) : undefined;\n  const cacheCreationTokens = usageRaw ? num(usageRaw.cache_creation_input_tokens) : undefined;\n  const costUsd = num(payload.total_cost_usd);\n\n  // Legacy fallbacks — only consulted when the modern key is missing.\n  const legacyInput = num(payload.num_input_tokens);\n  const legacyOutput = num(payload.num_output_tokens);\n  const legacyCost = num(payload.cost_usd);\n\n  const resolvedInput = inputTokens ?? legacyInput;\n  const resolvedOutput = outputTokens ?? legacyOutput;\n  const resolvedCost = costUsd ?? legacyCost;\n\n  if (resolvedInput !== undefined) usage.inputTokens = resolvedInput;\n  if (resolvedOutput !== undefined) usage.outputTokens = resolvedOutput;\n  if (cacheReadTokens !== undefined) usage.cacheReadTokens = cacheReadTokens;\n  if (cacheCreationTokens !== undefined) usage.cacheCreationTokens = cacheCreationTokens;\n  if (resolvedCost !== undefined) usage.costUsd = resolvedCost;\n\n  const cliDurationMs = num(payload.duration_ms);\n  const apiDurationMs = num(payload.duration_api_ms);\n  const ttftMs = num(payload.ttft_ms) ?? num(payload.time_to_first_token_ms);\n  const numTurns = num(payload.num_turns);\n  if (cliDurationMs !== undefined) usage.cliDurationMs = cliDurationMs;\n  if (apiDurationMs !== undefined) usage.apiDurationMs = apiDurationMs;\n  if (ttftMs !== undefined) usage.ttftMs = ttftMs;\n  if (numTurns !== undefined) usage.numTurns = numTurns;\n\n  return Object.keys(usage).length > 0 ? usage : null;\n}\n\n/**\n * Sum two usages field by field.\n *\n * `undefined` means \"not reported\", not zero: a field absent on both sides\n * stays absent in the result, while a field present on a single side is\n * carried over untouched.\n */\nexport function sumUsage(\n  a: ClaudeUsage | null | undefined,\n  b: ClaudeUsage | null | undefined,\n): ClaudeUsage {\n  const result: ClaudeUsage = {};\n\n  for (const field of USAGE_FIELDS) {\n    const left = a?.[field];\n    const right = b?.[field];\n    if (left === undefined && right === undefined) continue;\n    result[field] = (left ?? 0) + (right ?? 0);\n  }\n\n  return result;\n}\n\n/**\n * Split a usage evenly across `parts`.\n *\n * This is the rateio used when several stories complete in the same execute\n * iteration: the iteration's tokens cannot be attributed to a single story, so\n * each one receives an equal share. Token counts are rounded to integers;\n * the cost keeps full precision.\n *\n * `parts <= 1` (or a non-finite value) returns the usage unchanged. Fields the\n * CLI never reported stay absent — dividing \"not reported\" still yields\n * \"not reported\", never zero.\n */\nexport function divideUsage(usage: ClaudeUsage | null | undefined, parts: number): ClaudeUsage {\n  const result: ClaudeUsage = {};\n  if (!usage) return result;\n\n  const divisor = Number.isFinite(parts) && parts > 1 ? parts : 1;\n\n  for (const field of USAGE_FIELDS) {\n    const value = usage[field];\n    if (value === undefined) continue;\n    result[field] = field === 'costUsd' ? value / divisor : Math.round(value / divisor);\n  }\n\n  return result;\n}\n\n/**\n * Compact token count: `1523` → `1.5k`, `2_400_000` → `2.4M`.\n */\nfunction compactTokens(value: number): string {\n  const abs = Math.abs(value);\n  if (abs >= 1_000_000) return `${(value / 1_000_000).toFixed(1)}M`;\n  if (abs >= 1_000) return `${(value / 1_000).toFixed(1)}k`;\n  return String(Math.round(value));\n}\n\n/**\n * Human-readable one-liner, e.g. `2 in / 4 out · 15.5k cache · ~$0.1607`.\n *\n * Segments whose data is missing are omitted entirely — callers can rely on an\n * empty string meaning \"no metrics at all\" and skip the line altogether rather\n * than printing zeros or NaN.\n */\nexport function formatTokens(usage: ClaudeUsage | null | undefined): string {\n  if (!usage) return '';\n\n  const segments: string[] = [];\n\n  const io: string[] = [];\n  if (usage.inputTokens !== undefined) io.push(`${compactTokens(usage.inputTokens)} in`);\n  if (usage.outputTokens !== undefined) io.push(`${compactTokens(usage.outputTokens)} out`);\n  if (io.length > 0) segments.push(io.join(' / '));\n\n  const cache =\n    usage.cacheReadTokens !== undefined || usage.cacheCreationTokens !== undefined\n      ? (usage.cacheReadTokens ?? 0) + (usage.cacheCreationTokens ?? 0)\n      : undefined;\n  if (cache !== undefined) segments.push(`${compactTokens(cache)} cache`);\n\n  if (usage.costUsd !== undefined) segments.push(`~$${usage.costUsd.toFixed(4)}`);\n\n  return segments.join(' · ');\n}\n\n/**\n * True when the usage carries at least one reported field. Handy for deciding\n * whether a metrics line or event is worth emitting at all.\n */\nexport function hasUsageData(usage: ClaudeUsage | null | undefined): boolean {\n  if (!usage) return false;\n  return USAGE_FIELDS.some((field) => usage[field] !== undefined);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-JN6D3MY6.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  sessionSnapshotSchema
+} from "./chunk-LBGHI4S2.js";
+
+// src/storage/session-file.ts
+import { readFile, stat as statFile } from "fs/promises";
+async function readSessionFile(filePath) {
+  let raw;
+  let mtimeMs;
+  try {
+    const [content, stat] = await Promise.all([readFile(filePath, "utf-8"), statFile(filePath)]);
+    raw = content;
+    mtimeMs = stat.mtimeMs;
+  } catch {
+    return null;
+  }
+  try {
+    const parsed = sessionSnapshotSchema.safeParse(JSON.parse(raw));
+    if (!parsed.success || parsed.data.sessionId === null) return null;
+    return { snapshot: parsed.data, updatedAtMs: mtimeMs };
+  } catch {
+    return null;
+  }
+}
+
+export {
+  readSessionFile
+};
+//# sourceMappingURL=chunk-JN6D3MY6.js.map

package/dist/chunk-JN6D3MY6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/session-file.ts"],"sourcesContent":["import { readFile, stat as statFile } from 'node:fs/promises';\nimport { sessionSnapshotSchema, type ValidatedSessionSnapshot } from '../schemas.js';\n\nexport interface ReadSessionFileResult {\n  snapshot: ValidatedSessionSnapshot;\n  updatedAtMs: number;\n}\n\n/**\n * Read and validate one `session.json`. Anything short of a fully valid file\n * (missing, mid-write, corrupted, written by an incompatible future version)\n * reads as \"not currently a session\" — a directory scan must never fail\n * because one file is momentarily inconsistent.\n */\nexport async function readSessionFile(filePath: string): Promise<ReadSessionFileResult | null> {\n  let raw: string;\n  let mtimeMs: number;\n  try {\n    const [content, stat] = await Promise.all([readFile(filePath, 'utf-8'), statFile(filePath)]);\n    raw = content;\n    mtimeMs = stat.mtimeMs;\n  } catch {\n    return null;\n  }\n\n  try {\n    const parsed = sessionSnapshotSchema.safeParse(JSON.parse(raw));\n    if (!parsed.success || parsed.data.sessionId === null) return null;\n    return { snapshot: parsed.data, updatedAtMs: mtimeMs };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";;;;;;AAAA,SAAS,UAAU,QAAQ,gBAAgB;AAc3C,eAAsB,gBAAgB,UAAyD;AAC7F,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,UAAM,CAAC,SAAS,IAAI,IAAI,MAAM,QAAQ,IAAI,CAAC,SAAS,UAAU,OAAO,GAAG,SAAS,QAAQ,CAAC,CAAC;AAC3F,UAAM;AACN,cAAU,KAAK;AAAA,EACjB,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,sBAAsB,UAAU,KAAK,MAAM,GAAG,CAAC;AAC9D,QAAI,CAAC,OAAO,WAAW,OAAO,KAAK,cAAc,KAAM,QAAO;AAC9D,WAAO,EAAE,UAAU,OAAO,MAAM,aAAa,QAAQ;AAAA,EACvD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/{chunk-LAFNLLQP.js → chunk-KMRFRXIT.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import {
-  getProjectRoot
-} from "./chunk-DIDUVL6O.js";
 import {
   printWarning
-} from "./chunk-BYZDPR7N.js";
+} from "./chunk-TYRNTSPJ.js";
+import {
+  getProjectRoot
+} from "./chunk-BEZ5BA5U.js";
 
 // src/core/prompt-resolver.ts
 import { existsSync } from "fs";
@@ -107,4 +107,4 @@ export {
   loadPrompt,
   applyPlaceholders
 };
-//# sourceMappingURL=chunk-LAFNLLQP.js.map
+//# sourceMappingURL=chunk-KMRFRXIT.js.map

package/dist/chunk-KT7JKOXB.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import {
+  readSessionFile
+} from "./chunk-JN6D3MY6.js";
+import {
+  PROJECTS_DIR_NAME,
+  RUN_LOCK_FILENAME,
+  getGlobalRoot,
+  getIssuePaths
+} from "./chunk-HAKDLR6N.js";
+import {
+  isProcessAlive,
+  isRunLockStale,
+  readRunLock
+} from "./chunk-LBGHI4S2.js";
+
+// src/execution/registry.ts
+import { readdir } from "fs/promises";
+import { join } from "path";
+function classifyRunLock(lock) {
+  if (!isProcessAlive(lock.pid)) return "orphan";
+  if (isRunLockStale(lock)) return "unsignaled";
+  return "running";
+}
+async function listLiveRuns(options = {}) {
+  const root = getGlobalRoot(options);
+  const projectsDir = join(root, PROJECTS_DIR_NAME);
+  let projectIds;
+  try {
+    const entries = await readdir(projectsDir, { withFileTypes: true });
+    projectIds = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch {
+    return [];
+  }
+  const runs = await Promise.all(
+    projectIds.map(async (projectId) => {
+      const lockFile = join(projectsDir, projectId, RUN_LOCK_FILENAME);
+      const lock = await readRunLock(lockFile);
+      if (lock === null) return null;
+      return enrichRun(projectId, lockFile, lock, options);
+    })
+  );
+  return runs.filter((run) => run !== null).sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+}
+async function enrichRun(projectId, lockFile, lock, options) {
+  const session = await readSessionFile(getIssuePaths(projectId, lock.target, options).sessionFile);
+  return {
+    projectId,
+    target: lock.target,
+    pid: lock.pid,
+    host: lock.host,
+    detached: lock.detached === true,
+    status: classifyRunLock(lock),
+    startedAt: lock.startedAt,
+    lastHeartbeatAt: lock.lastHeartbeatAt,
+    issue: session?.snapshot.issue.number ?? numericTarget(lock.target),
+    phase: session?.snapshot.currentPhase ?? null,
+    storiesCompleted: session?.snapshot.progress.storiesCompleted ?? null,
+    storiesTotal: session?.snapshot.progress.storiesTotal ?? null,
+    elapsedSeconds: session?.snapshot.elapsedSeconds ?? null,
+    lockFile
+  };
+}
+function numericTarget(target) {
+  return /^\d+$/.test(target) ? Number(target) : null;
+}
+
+export {
+  classifyRunLock,
+  listLiveRuns
+};
+//# sourceMappingURL=chunk-KT7JKOXB.js.map

package/dist/chunk-KT7JKOXB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/execution/registry.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { isProcessAlive, isRunLockStale, readRunLock } from '../storage/lock.js';\nimport {\n  type GetGlobalRootOptions,\n  getGlobalRoot,\n  getIssuePaths,\n  PROJECTS_DIR_NAME,\n  RUN_LOCK_FILENAME,\n} from '../storage/paths.js';\nimport type { RunLock } from '../storage/schemas.js';\nimport { readSessionFile } from '../storage/session-file.js';\n\nexport type LiveRunStatus = 'running' | 'unsignaled' | 'orphan';\n\nexport interface LiveRun {\n  projectId: string;\n  target: string;\n  pid: number;\n  host: string;\n  detached: boolean;\n  status: LiveRunStatus;\n  startedAt: string;\n  lastHeartbeatAt: string;\n  issue: number | null;\n  phase: string | null;\n  storiesCompleted: number | null;\n  storiesTotal: number | null;\n  elapsedSeconds: number | null;\n  lockFile: string;\n}\n\nexport function classifyRunLock(lock: RunLock): LiveRunStatus {\n  if (!isProcessAlive(lock.pid)) return 'orphan';\n  if (isRunLockStale(lock)) return 'unsignaled';\n  return 'running';\n}\n\n/**\n * Every run.lock under the global projects tree, enriched with session.json\n * when one exists. The lock is the source of truth for existence; the\n * snapshot only fills phase and progress.\n */\nexport async function listLiveRuns(options: GetGlobalRootOptions = {}): Promise<LiveRun[]> {\n  const root = getGlobalRoot(options);\n  const projectsDir = join(root, PROJECTS_DIR_NAME);\n  let projectIds: string[];\n  try {\n    const entries = await readdir(projectsDir, { withFileTypes: true });\n    projectIds = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);\n  } catch {\n    return [];\n  }\n\n  const runs = await Promise.all(\n    projectIds.map(async (projectId) => {\n      const lockFile = join(projectsDir, projectId, RUN_LOCK_FILENAME);\n      const lock = await readRunLock(lockFile);\n      if (lock === null) return null;\n      return enrichRun(projectId, lockFile, lock, options);\n    }),\n  );\n\n  return runs\n    .filter((run): run is LiveRun => run !== null)\n    .sort((a, b) => a.startedAt.localeCompare(b.startedAt));\n}\n\nasync function enrichRun(\n  projectId: string,\n  lockFile: string,\n  lock: RunLock,\n  options: GetGlobalRootOptions,\n): Promise<LiveRun> {\n  const session = await readSessionFile(getIssuePaths(projectId, lock.target, options).sessionFile);\n\n  return {\n    projectId,\n    target: lock.target,\n    pid: lock.pid,\n    host: lock.host,\n    detached: lock.detached === true,\n    status: classifyRunLock(lock),\n    startedAt: lock.startedAt,\n    lastHeartbeatAt: lock.lastHeartbeatAt,\n    issue: session?.snapshot.issue.number ?? numericTarget(lock.target),\n    phase: session?.snapshot.currentPhase ?? null,\n    storiesCompleted: session?.snapshot.progress.storiesCompleted ?? null,\n    storiesTotal: session?.snapshot.progress.storiesTotal ?? null,\n    elapsedSeconds: session?.snapshot.elapsedSeconds ?? null,\n    lockFile,\n  };\n}\n\nfunction numericTarget(target: string): number | null {\n  return /^\\d+$/.test(target) ? Number(target) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,eAAe;AACxB,SAAS,YAAY;AA+Bd,SAAS,gBAAgB,MAA8B;AAC5D,MAAI,CAAC,eAAe,KAAK,GAAG,EAAG,QAAO;AACtC,MAAI,eAAe,IAAI,EAAG,QAAO;AACjC,SAAO;AACT;AAOA,eAAsB,aAAa,UAAgC,CAAC,GAAuB;AACzF,QAAM,OAAO,cAAc,OAAO;AAClC,QAAM,cAAc,KAAK,MAAM,iBAAiB;AAChD,MAAI;AACJ,MAAI;AACF,UAAM,UAAU,MAAM,QAAQ,aAAa,EAAE,eAAe,KAAK,CAAC;AAClE,iBAAa,QAAQ,OAAO,CAAC,UAAU,MAAM,YAAY,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,IAAI;AAAA,EACvF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,OAAO,MAAM,QAAQ;AAAA,IACzB,WAAW,IAAI,OAAO,cAAc;AAClC,YAAM,WAAW,KAAK,aAAa,WAAW,iBAAiB;AAC/D,YAAM,OAAO,MAAM,YAAY,QAAQ;AACvC,UAAI,SAAS,KAAM,QAAO;AAC1B,aAAO,UAAU,WAAW,UAAU,MAAM,OAAO;AAAA,IACrD,CAAC;AAAA,EACH;AAEA,SAAO,KACJ,OAAO,CAAC,QAAwB,QAAQ,IAAI,EAC5C,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,cAAc,EAAE,SAAS,CAAC;AAC1D;AAEA,eAAe,UACb,WACA,UACA,MACA,SACkB;AAClB,QAAM,UAAU,MAAM,gBAAgB,cAAc,WAAW,KAAK,QAAQ,OAAO,EAAE,WAAW;AAEhG,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,KAAK;AAAA,IACb,KAAK,KAAK;AAAA,IACV,MAAM,KAAK;AAAA,IACX,UAAU,KAAK,aAAa;AAAA,IAC5B,QAAQ,gBAAgB,IAAI;AAAA,IAC5B,WAAW,KAAK;AAAA,IAChB,iBAAiB,KAAK;AAAA,IACtB,OAAO,SAAS,SAAS,MAAM,UAAU,cAAc,KAAK,MAAM;AAAA,IAClE,OAAO,SAAS,SAAS,gBAAgB;AAAA,IACzC,kBAAkB,SAAS,SAAS,SAAS,oBAAoB;AAAA,IACjE,cAAc,SAAS,SAAS,SAAS,gBAAgB;AAAA,IACzD,gBAAgB,SAAS,SAAS,kBAAkB;AAAA,IACpD;AAAA,EACF;AACF;AAEA,SAAS,cAAc,QAA+B;AACpD,SAAO,QAAQ,KAAK,MAAM,IAAI,OAAO,MAAM,IAAI;AACjD;","names":[]}