issue-flow 0.12.0 → 0.13.0

package/dist/chunk-DIG5XKQQ.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+import {
+  isProcessAlive,
+  taskPlanSchema
+} from "./chunk-NEZZ6KDR.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-DIG5XKQQ.js.map

package/dist/chunk-DIG5XKQQ.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-FZDR7CGH.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import {
+  IssueResolutionError,
+  resolveIssue
+} from "./chunk-PV4OX5TC.js";
+import {
+  printError,
+  printWarning
+} from "./chunk-IYV6KNVF.js";
+import {
+  actionOf,
+  classify,
+  requiresHumanAction
+} from "./chunk-XEYH6ZZI.js";
+
+// src/issues/context.ts
+function localIssueRef(id) {
+  return `issues/${id}/issue.md`;
+}
+function issueReference(issue) {
+  return issue.remoteRef ?? localIssueRef(issue.id);
+}
+var NO_LABELS = "(none)";
+function issuePlaceholders(resolved) {
+  const { issue } = resolved;
+  return {
+    __ISSUE_TITLE__: issue.title,
+    __ISSUE_BODY__: issue.body,
+    __ISSUE_LABELS__: issue.labels.length > 0 ? issue.labels.join(", ") : NO_LABELS,
+    __ISSUE_SOURCE__: resolved.source,
+    __ISSUE_URL__: issueReference(issue)
+  };
+}
+async function resolveCommandIssue(id, preResolved, options) {
+  if (preResolved !== void 0) {
+    return { ok: true, resolved: preResolved };
+  }
+  try {
+    return { ok: true, resolved: await resolveIssue(id, options) };
+  } catch (err) {
+    if (err instanceof IssueResolutionError) {
+      printError(err.message);
+      printAction(err.action);
+      return { ok: false, code: err.exitCode };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    printError(`Could not resolve issue '${id}': ${message}`);
+    printAction(actionOf(err) ?? requiredAction(message));
+    return { ok: false, code: 1 };
+  }
+}
+function requiredAction(message) {
+  const failure = classify({ source: "github", stderr: message });
+  if (!requiresHumanAction(failure.kind)) return null;
+  if (failure.kind === "authentication") {
+    return "Run `gh auth login` to authenticate the GitHub CLI";
+  }
+  return null;
+}
+function printAction(action) {
+  if (action !== null && action !== void 0 && action !== "") {
+    printWarning(`Action required: ${action}`);
+  }
+}
+
+export {
+  localIssueRef,
+  issuePlaceholders,
+  resolveCommandIssue
+};
+//# sourceMappingURL=chunk-FZDR7CGH.js.map

package/dist/chunk-FZDR7CGH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/issues/context.ts"],"sourcesContent":["import { actionOf, classify, requiresHumanAction } from '../resilience/errors.js';\nimport { printError, printWarning } from '../ui/logger.js';\nimport { IssueResolutionError, type ResolveIssueOptions, resolveIssue } from './resolver.js';\nimport type { Issue, ResolvedIssue } from './types.js';\n\n/**\n * Bridge between the resolved Issue and the phase prompts.\n *\n * Commands never fetch the Issue themselves: they resolve it once through\n * `resolveIssue` and hand the content to the template, so every phase sees the\n * exact same title/body regardless of where the demand came from.\n */\n\n/** Path of the markdown file a local Issue lives in. */\nexport function localIssueRef(id: string): string {\n  return `issues/${id}/issue.md`;\n}\n\n/**\n * Reference a human (or an agent) can follow to read the Issue: the remote URL\n * when there is one, the local file otherwise.\n */\nexport function issueReference(issue: Issue): string {\n  return issue.remoteRef ?? localIssueRef(issue.id);\n}\n\n/** Shown instead of an empty list so the prompt never renders a dangling label. */\nconst NO_LABELS = '(none)';\n\n/**\n * Placeholder values every phase template consumes, replacing the former\n * `gh issue view` instruction.\n */\nexport function issuePlaceholders(resolved: ResolvedIssue): Record<string, string> {\n  const { issue } = resolved;\n  return {\n    __ISSUE_TITLE__: issue.title,\n    __ISSUE_BODY__: issue.body,\n    __ISSUE_LABELS__: issue.labels.length > 0 ? issue.labels.join(', ') : NO_LABELS,\n    __ISSUE_SOURCE__: resolved.source,\n    __ISSUE_URL__: issueReference(issue),\n  };\n}\n\nexport type CommandIssue = { ok: true; resolved: ResolvedIssue } | { ok: false; code: number };\n\n/**\n * Resolve the Issue a command works on, turning a resolution failure into the\n * exit code the command returns.\n *\n * `preResolved` short-circuits the lookup: the pipeline decides the origin once\n * and passes the decision down, so a phase never re-queries the providers (and\n * never asks the user twice about the same divergence).\n *\n * `options` forwards resolver options — `run.ts` passes the configuration it\n * already loaded so `.issue-flow.json` is read (and warned about) only once.\n */\nexport async function resolveCommandIssue(\n  id: string,\n  preResolved?: ResolvedIssue,\n  options?: ResolveIssueOptions,\n): Promise<CommandIssue> {\n  if (preResolved !== undefined) {\n    return { ok: true, resolved: preResolved };\n  }\n\n  try {\n    return { ok: true, resolved: await resolveIssue(id, options) };\n  } catch (err) {\n    if (err instanceof IssueResolutionError) {\n      printError(err.message);\n      printAction(err.action);\n      return { ok: false, code: err.exitCode };\n    }\n    const message = err instanceof Error ? err.message : String(err);\n    printError(`Could not resolve issue '${id}': ${message}`);\n    printAction(actionOf(err) ?? requiredAction(message));\n    return { ok: false, code: 1 };\n  }\n}\n\n/**\n * What a human has to do about a failure that no amount of waiting fixes.\n *\n * The retry budget was already spent inside the providers — every `gh` call\n * goes through `run()` with the `network`/`rate_limit` policy — so by the time\n * a failure reaches here it is final. What is left to decide is whether it is\n * final *because a person has to act*, and that is what turns an opaque exit\n * code into an instruction.\n */\nfunction requiredAction(message: string): string | null {\n  const failure = classify({ source: 'github', stderr: message });\n  if (!requiresHumanAction(failure.kind)) return null;\n  if (failure.kind === 'authentication') {\n    return 'Run `gh auth login` to authenticate the GitHub CLI';\n  }\n  return null;\n}\n\nfunction printAction(action: string | null | undefined): void {\n  if (action !== null && action !== undefined && action !== '') {\n    printWarning(`Action required: ${action}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcO,SAAS,cAAc,IAAoB;AAChD,SAAO,UAAU,EAAE;AACrB;AAMO,SAAS,eAAe,OAAsB;AACnD,SAAO,MAAM,aAAa,cAAc,MAAM,EAAE;AAClD;AAGA,IAAM,YAAY;AAMX,SAAS,kBAAkB,UAAiD;AACjF,QAAM,EAAE,MAAM,IAAI;AAClB,SAAO;AAAA,IACL,iBAAiB,MAAM;AAAA,IACvB,gBAAgB,MAAM;AAAA,IACtB,kBAAkB,MAAM,OAAO,SAAS,IAAI,MAAM,OAAO,KAAK,IAAI,IAAI;AAAA,IACtE,kBAAkB,SAAS;AAAA,IAC3B,eAAe,eAAe,KAAK;AAAA,EACrC;AACF;AAeA,eAAsB,oBACpB,IACA,aACA,SACuB;AACvB,MAAI,gBAAgB,QAAW;AAC7B,WAAO,EAAE,IAAI,MAAM,UAAU,YAAY;AAAA,EAC3C;AAEA,MAAI;AACF,WAAO,EAAE,IAAI,MAAM,UAAU,MAAM,aAAa,IAAI,OAAO,EAAE;AAAA,EAC/D,SAAS,KAAK;AACZ,QAAI,eAAe,sBAAsB;AACvC,iBAAW,IAAI,OAAO;AACtB,kBAAY,IAAI,MAAM;AACtB,aAAO,EAAE,IAAI,OAAO,MAAM,IAAI,SAAS;AAAA,IACzC;AACA,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,eAAW,4BAA4B,EAAE,MAAM,OAAO,EAAE;AACxD,gBAAY,SAAS,GAAG,KAAK,eAAe,OAAO,CAAC;AACpD,WAAO,EAAE,IAAI,OAAO,MAAM,EAAE;AAAA,EAC9B;AACF;AAWA,SAAS,eAAe,SAAgC;AACtD,QAAM,UAAU,SAAS,EAAE,QAAQ,UAAU,QAAQ,QAAQ,CAAC;AAC9D,MAAI,CAAC,oBAAoB,QAAQ,IAAI,EAAG,QAAO;AAC/C,MAAI,QAAQ,SAAS,kBAAkB;AACrC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,YAAY,QAAyC;AAC5D,MAAI,WAAW,QAAQ,WAAW,UAAa,WAAW,IAAI;AAC5D,iBAAa,oBAAoB,MAAM,EAAE;AAAA,EAC3C;AACF;","names":[]}