issue-flow 0.12.0 → 0.14.0

package/dist/chunk-REO3PXXO.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import {
+  IssueResolutionError,
+  resolveIssue
+} from "./chunk-PZTWU277.js";
+import {
+  printError,
+  printWarning
+} from "./chunk-TYRNTSPJ.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-REO3PXXO.js.map

package/dist/chunk-REO3PXXO.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":[]}