issue-flow 0.8.0 → 0.10.0

package/dist/chunk-S67Q4I2O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/issues/registry.ts","../src/issues/hash.ts","../src/issues/relations.ts","../src/issues/providers/github.ts","../src/issues/providers/local.ts","../src/issues/bootstrap.ts","../src/issues/resolver.ts","../src/issues/context.ts"],"sourcesContent":["import type { IssueProvider } from './provider.js';\nimport type { IssueSource } from './types.js';\n\n/**\n * Registry of Issue providers.\n *\n * Adding an origin is creating a provider file and registering one line here\n * (or from the caller's side), so nothing in src/commands/ needs to know the\n * list of sources.\n */\nconst providers = new Map<IssueSource, IssueProvider>();\n\n/**\n * Register a provider under its own `name`.\n *\n * Registering the same source twice replaces the previous entry, which is what\n * lets tests substitute a real provider with a fake one.\n */\nexport function registerProvider(provider: IssueProvider): void {\n  providers.set(provider.name, provider);\n}\n\n/** Sources currently registered, in registration order. */\nexport function getRegisteredSources(): IssueSource[] {\n  return [...providers.keys()];\n}\n\n/**\n * Look up a provider by origin.\n *\n * @throws when the origin is not registered, listing what is available so the\n * caller knows which sources they can pick instead.\n */\nexport function getProvider(source: IssueSource): IssueProvider {\n  const provider = providers.get(source);\n  if (provider === undefined) {\n    const available = getRegisteredSources();\n    const hint =\n      available.length > 0\n        ? `Available sources: ${available.join(', ')}.`\n        : 'No Issue providers are registered.';\n    throw new Error(`Unknown Issue source: '${source}'. ${hint}`);\n  }\n  return provider;\n}\n\n/** Drop every registration. Intended for test isolation. */\nexport function clearProviders(): void {\n  providers.clear();\n}\n","import { createHash } from 'node:crypto';\n\n/**\n * Content hashing shared by every Issue provider.\n *\n * The hash is what lets the resolver tell \"the local and the remote Issue are\n * the same demand\" from \"they diverged\", so it has to be stable across\n * platforms: Windows checkouts store CRLF, editors add or drop trailing\n * newlines, and neither should count as a content change.\n */\n\n/** Normalizes line endings (CRLF/CR to LF) and trims the edges. */\nfunction normalizeText(value: string): string {\n  return value.replace(/\\r\\n?/g, '\\n').trim();\n}\n\n/**\n * Returns `sha256:<hex>` for the given title and body.\n *\n * The payload is a canonical JSON object rather than a concatenation, so text\n * moved from the title into the body always changes the hash.\n */\nexport function hashIssueContent(title: string, body: string): string {\n  const payload = JSON.stringify({\n    title: normalizeText(title),\n    body: normalizeText(body),\n  });\n  const digest = createHash('sha256').update(payload, 'utf8').digest('hex');\n  return `sha256:${digest}`;\n}\n","import type { IssueRelations } from './types.js';\n\n/**\n * Pure helpers around {@link IssueRelations}.\n *\n * Everything here is origin-agnostic: a provider maps its own payload into\n * these shapes, and the textual heuristic below is the shared fallback for\n * repositories that express hierarchy and dependencies in Markdown instead of\n * through a structured API.\n */\n\n/** Relations of an Issue nothing is known about — every field empty. */\nexport function emptyRelations(id: string): IssueRelations {\n  return {\n    id,\n    parent: null,\n    children: [],\n    blockedBy: [],\n    blocking: [],\n    references: [],\n    referencedBy: [],\n    heuristic: [],\n  };\n}\n\n/** Whether an Issue relates to nothing at all (mentions included). */\nexport function hasNoRelations(relations: IssueRelations): boolean {\n  return (\n    relations.parent === null &&\n    relations.children.length === 0 &&\n    relations.blockedBy.length === 0 &&\n    relations.blocking.length === 0\n  );\n}\n\n/** Deduplicate preserving order, dropping empty entries and `self`. */\nexport function uniqueIds(ids: readonly string[], self?: string): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const raw of ids) {\n    const id = raw.trim();\n    if (id === '' || id === self || seen.has(id)) continue;\n    seen.add(id);\n    out.push(id);\n  }\n  return out;\n}\n\n/** What {@link parseTextualRelations} can recover from a Markdown body. */\nexport interface TextualRelations {\n  children: string[];\n  blockedBy: string[];\n  blocking: string[];\n  /** Every other `#N` cited, with no relation attached to it. */\n  references: string[];\n}\n\n/**\n * Code spans and fenced blocks, blanked out before scanning.\n *\n * A snippet that happens to contain `#42` (a shell comment, a CSS colour, a\n * diff hunk header) is documentation, not a dependency — and it is exactly the\n * kind of false positive that would put an unrelated Issue in front of the user\n * as \"part of this hierarchy\".\n */\nfunction stripCode(body: string): string {\n  return body.replace(/```[\\s\\S]*?```/g, ' ').replace(/`[^`\\n]*`/g, ' ');\n}\n\n/**\n * Keyword forms accepted before a list of ids, per relation kind.\n *\n * Portuguese spellings sit next to the English ones because issues are written\n * in the language of the team, not of the tool: a repository whose issues say\n * \"Depende de #50\" would otherwise get an empty graph while an identical\n * English-language repository gets a full one.\n */\nconst BLOCKED_BY =\n  /\\b(?:depends[- ]on|depends upon|blocked[- ]by|requires|depende[ -]de|dependente[ -]de|bloquead[ao] por|requer)\\b\\s*:?\\s*/gi;\nconst BLOCKING = /\\b(?:blocks|blocking|bloqueia|bloqueando)\\b\\s*:?\\s*/gi;\n\n/** A task list item (`- [ ] #12 …`), the Markdown spelling of a sub-issue. */\nconst TASK_ITEM = /^[ \\t]*[-*]\\s*\\[[ xX]\\]\\s*(.*)$/gm;\n\n/** Every `#N` that is not glued to a word character (`abc#12` is not a citation). */\nconst ANY_ID = /(?:^|[^\\w#])#(\\d+)\\b/g;\n\n/**\n * Ids of the `#a, #b and #c` run that starts exactly at `text`.\n *\n * Anchored on purpose: the keyword must be immediately followed by the list, so\n * \"blocked by the API redesign discussed in #12\" contributes nothing — the\n * sentence names a cause, not a dependency.\n */\nfunction idsFrom(text: string): string[] {\n  const ids: string[] = [];\n  const id = /#(\\d+)/y;\n  let cursor = 0;\n\n  while (cursor < text.length) {\n    id.lastIndex = cursor;\n    const match = id.exec(text);\n    if (match === null) break;\n    ids.push(match[1] as string);\n    cursor = id.lastIndex;\n\n    // A parenthetical after an id is a gloss, not the end of the list:\n    // \"Depends on #50 (discovery) and #51 (ordering)\" names two dependencies.\n    const gloss = /^\\s*\\([^)]*\\)/.exec(text.slice(cursor));\n    if (gloss !== null) {\n      cursor += gloss[0].length;\n    }\n\n    // Consume the separator between two ids of the same list.\n    const separator = /^\\s*(?:,|and\\b|e\\b|&)\\s*/i.exec(text.slice(cursor));\n    if (separator === null) break;\n    cursor += separator[0].length;\n  }\n\n  return ids;\n}\n\nfunction collect(body: string, keyword: RegExp): string[] {\n  const ids: string[] = [];\n  keyword.lastIndex = 0;\n  let match = keyword.exec(body);\n  while (match !== null) {\n    ids.push(...idsFrom(body.slice(keyword.lastIndex)));\n    match = keyword.exec(body);\n  }\n  return ids;\n}\n\n/**\n * Best-effort hierarchy and dependencies from a Markdown body.\n *\n * Heuristic by construction, and documented as such everywhere it surfaces: a\n * repository that never adopted GitHub's Sub-issues or Issue Dependencies still\n * expresses the same information in prose, and refusing to read it would leave\n * most repositories with an empty graph. The trade-off is accepted with three\n * guards — code is stripped first, only explicit keywords create a relation,\n * and everything else is demoted to a plain reference, which no consumer orders\n * execution by.\n *\n * `self` (the Issue's own id) is filtered out of every list: a body that says\n * \"part 2 of #51\" while being #51 must not depend on itself.\n */\nexport function parseTextualRelations(body: string, self?: string): TextualRelations {\n  const text = stripCode(body ?? '');\n\n  const blockedBy = collect(text, BLOCKED_BY);\n  const blocking = collect(text, BLOCKING);\n\n  const children: string[] = [];\n  TASK_ITEM.lastIndex = 0;\n  let item = TASK_ITEM.exec(text);\n  while (item !== null) {\n    const content = item[1] ?? '';\n    // The citation must **open** the item, which is how GitHub's own task lists\n    // reference an issue (`- [ ] #21 Title`). A checklist entry that merely\n    // mentions an issue in its prose (\"- [ ] Reuse the graph of issue #50\") is\n    // a note, not a sub-issue — and treating it as one was the most common\n    // false positive this heuristic produced on real bodies.\n    const first = /^\\s*\\[?#(\\d+)\\b/.exec(content);\n    if (first?.[1] !== undefined) {\n      children.push(first[1]);\n    }\n    item = TASK_ITEM.exec(text);\n  }\n\n  const classified = new Set([...blockedBy, ...blocking, ...children]);\n  const references: string[] = [];\n  ANY_ID.lastIndex = 0;\n  let cited = ANY_ID.exec(text);\n  while (cited !== null) {\n    const id = cited[1] as string;\n    if (!classified.has(id)) {\n      references.push(id);\n    }\n    // Overlapping matches: `#1 #2` shares the separator, so rewind by one.\n    ANY_ID.lastIndex = Math.max(ANY_ID.lastIndex - 1, cited.index + 1);\n    cited = ANY_ID.exec(text);\n  }\n\n  return {\n    children: uniqueIds(children, self),\n    blockedBy: uniqueIds(blockedBy, self),\n    blocking: uniqueIds(blocking, self),\n    references: uniqueIds(references, self),\n  };\n}\n\n/**\n * Merge structured relations with the textual fallback, recording which\n * identifiers exist only because of the heuristic.\n *\n * Structured data always wins the ordering of a list (it is listed first), and\n * an id present in both is *not* marked heuristic — it was confirmed by an API.\n */\nexport function mergeRelations(\n  structured: Omit<IssueRelations, 'heuristic'>,\n  textual: TextualRelations,\n): IssueRelations {\n  const self = structured.id;\n\n  const children = uniqueIds([...structured.children, ...textual.children], self);\n  const blockedBy = uniqueIds([...structured.blockedBy, ...textual.blockedBy], self);\n  const blocking = uniqueIds([...structured.blocking, ...textual.blocking], self);\n  const references = uniqueIds([...structured.references, ...textual.references], self);\n\n  const fromApi = new Set([\n    ...structured.children,\n    ...structured.blockedBy,\n    ...structured.blocking,\n    ...(structured.parent === null ? [] : [structured.parent]),\n  ]);\n  const heuristic = uniqueIds(\n    [...textual.children, ...textual.blockedBy, ...textual.blocking].filter(\n      (id) => !fromApi.has(id),\n    ),\n    self,\n  );\n\n  return {\n    id: self,\n    parent: structured.parent,\n    children,\n    blockedBy,\n    blocking,\n    references,\n    referencedBy: uniqueIds(structured.referencedBy, self),\n    heuristic,\n  };\n}\n","import { run } from '../../utils/shell.js';\nimport { hashIssueContent } from '../hash.js';\nimport type { IssueProvider } from '../provider.js';\nimport { emptyRelations, mergeRelations, parseTextualRelations, uniqueIds } from '../relations.js';\nimport type { Issue, IssueDraft, IssueRelations, IssueState } from '../types.js';\n\n/** Fields requested from `gh issue view`, in the order the PRD specifies. */\nconst VIEW_FIELDS = 'number,title,body,labels,state,url,createdAt,updatedAt';\n\n/** Timeout for the availability probes, matching the `init` prerequisite checks. */\nconst PROBE_TIMEOUT_MS = 10_000;\n\n/**\n * gh reports a missing Issue on stderr with one of these phrasings. The match\n * must stay issue-specific: a bare /not found/ would also swallow\n * `gh: command not found`, turning a broken environment into \"issue absent\".\n * Anything else on a non-zero exit is a real failure (network, auth, gh not\n * installed) and must surface as a thrown error.\n */\nconst NOT_FOUND_PATTERN =\n  /could not resolve to an issue|no issues? found|issue not found|could not find any issue/i;\n\ninterface GhLabel {\n  name?: unknown;\n}\n\ninterface GhIssuePayload {\n  number?: unknown;\n  title?: unknown;\n  body?: unknown;\n  labels?: unknown;\n  state?: unknown;\n  url?: unknown;\n  createdAt?: unknown;\n  updatedAt?: unknown;\n}\n\nfunction normalizeState(state: unknown): IssueState {\n  return String(state ?? '').toUpperCase() === 'CLOSED' ? 'closed' : 'open';\n}\n\nfunction normalizeLabels(labels: unknown): string[] {\n  if (!Array.isArray(labels)) return [];\n  return labels\n    .map((label: GhLabel | string) => (typeof label === 'string' ? label : label?.name))\n    .filter((name): name is string => typeof name === 'string' && name.length > 0);\n}\n\nfunction toIssue(payload: GhIssuePayload): Issue {\n  const title = typeof payload.title === 'string' ? payload.title : '';\n  const body = typeof payload.body === 'string' ? payload.body : '';\n  const number = typeof payload.number === 'number' ? payload.number : null;\n  const url = typeof payload.url === 'string' && payload.url.length > 0 ? payload.url : null;\n\n  return {\n    id: number === null ? '' : String(number),\n    number,\n    title,\n    body,\n    labels: normalizeLabels(payload.labels),\n    state: normalizeState(payload.state),\n    source: 'github',\n    remoteRef: url,\n    createdAt: typeof payload.createdAt === 'string' ? payload.createdAt : '',\n    updatedAt: typeof payload.updatedAt === 'string' ? payload.updatedAt : '',\n    contentHash: hashIssueContent(title, body),\n    raw: payload,\n  };\n}\n\n/** Strip a leading `#` so both `23` and `#23` are accepted. */\nfunction normalizeId(id: string): string {\n  return id.trim().replace(/^#/, '');\n}\n\n/** Page size for the relation endpoints — one page is enough in practice. */\nconst API_PAGE_SIZE = 100;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * `gh api <path>`, parsed as JSON.\n *\n * Answers `null` for every failure — a disabled feature (404), a plan without\n * Issue Dependencies (403), a network hiccup or unparseable output. That is the\n * whole graceful-degradation contract of `fetchRelations`: a source that cannot\n * answer contributes nothing instead of failing the discovery.\n */\nasync function ghApiJson(path: string): Promise<unknown> {\n  try {\n    const result = await run('gh', ['api', path]);\n    if (result.exitCode !== 0) return null;\n    return JSON.parse(result.stdout) as unknown;\n  } catch {\n    return null;\n  }\n}\n\n/** `number` of an Issue-shaped payload, as a string id. */\nfunction issueNumberOf(value: unknown): string | null {\n  if (!isRecord(value)) return null;\n  const number = value.number;\n  return typeof number === 'number' && Number.isInteger(number) ? String(number) : null;\n}\n\n/** Ids of an array of Issue-shaped payloads, skipping anything unusable. */\nfunction issueNumbersOf(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return uniqueIds(\n    value.map((entry) => issueNumberOf(entry) ?? '').filter((entry) => entry !== ''),\n  );\n}\n\n/**\n * Issues that cited this one, from the timeline's `cross-referenced` events.\n *\n * Pull Requests are filtered out: they reference the Issue as *work on it*, not\n * as another demand to schedule.\n */\nfunction crossReferences(timeline: unknown, self: string): string[] {\n  if (!Array.isArray(timeline)) return [];\n\n  const ids: string[] = [];\n  for (const event of timeline) {\n    if (!isRecord(event) || event.event !== 'cross-referenced') continue;\n    const source = isRecord(event.source) ? event.source : null;\n    const issue = isRecord(source?.issue) ? source.issue : null;\n    if (issue === null || issue.pull_request !== undefined) continue;\n    const number = issueNumberOf(issue);\n    if (number !== null) ids.push(number);\n  }\n\n  return uniqueIds(ids, self);\n}\n\nfunction extractIssueNumber(output: string): string | null {\n  return output.match(/\\/issues\\/(\\d+)/)?.[1] ?? null;\n}\n\n/**\n * Issue provider backed by the GitHub CLI.\n *\n * Every call goes through `run` (execa, no shell) so tests can mock the shell\n * layer instead of the network, and so the Issue content is identical across\n * every pipeline phase.\n */\nexport class GitHubIssueProvider implements IssueProvider {\n  readonly name = 'github' as const;\n\n  /** True when gh is installed and authenticated. Never throws. */\n  async isAvailable(): Promise<boolean> {\n    try {\n      const version = await run('gh', ['--version'], { timeout: PROBE_TIMEOUT_MS });\n      if (version.exitCode !== 0) return false;\n\n      const auth = await run('gh', ['auth', 'status'], { timeout: PROBE_TIMEOUT_MS });\n      return auth.exitCode === 0;\n    } catch {\n      return false;\n    }\n  }\n\n  async get(id: string): Promise<Issue | null> {\n    const issueId = normalizeId(id);\n    const result = await run('gh', ['issue', 'view', issueId, '--json', VIEW_FIELDS]);\n\n    if (result.exitCode !== 0) {\n      const detail = (result.stderr || result.stdout).trim();\n      if (NOT_FOUND_PATTERN.test(detail)) return null;\n      throw new Error(\n        `Failed to fetch GitHub issue #${issueId}: ${detail || 'gh issue view failed'}`,\n      );\n    }\n\n    let payload: GhIssuePayload;\n    try {\n      payload = JSON.parse(result.stdout);\n    } catch {\n      throw new Error(\n        `Failed to parse gh output for issue #${issueId}: ${result.stdout.slice(0, 200)}`,\n      );\n    }\n\n    return toIssue(payload);\n  }\n\n  async create(draft: IssueDraft): Promise<Issue> {\n    const args = ['issue', 'create', '--title', draft.title, '--body', draft.body];\n    for (const label of draft.labels) {\n      args.push('--label', label);\n    }\n\n    const result = await run('gh', args);\n    if (result.exitCode !== 0) {\n      const detail = (result.stderr || result.stdout).trim();\n      throw new Error(`Failed to create GitHub issue: ${detail || 'gh issue create failed'}`);\n    }\n\n    const number = extractIssueNumber(result.stdout);\n    if (!number) {\n      throw new Error(\n        `GitHub issue creation did not report an issue URL: ${result.stdout.trim() || '(no output)'}`,\n      );\n    }\n\n    const created = await this.get(number);\n    if (!created) {\n      throw new Error(`GitHub issue #${number} was created but could not be read back`);\n    }\n    return created;\n  }\n\n  /**\n   * Hierarchy and dependencies of an Issue, reconciled from three GitHub\n   * mechanisms that only partially overlap:\n   *\n   * 1. **Sub-issues** (`/sub_issues` plus the `parent` field of the Issue\n   *    payload) — the native hierarchy;\n   * 2. **Issue Dependencies** (`/dependencies/blocked_by` and `/blocking`);\n   * 3. the **textual heuristic** over the body, for repositories that adopted\n   *    neither and write `Depends on #12` or `- [ ] #13` instead.\n   *\n   * Cross-references (`referencedBy`) come from the issue timeline, which is\n   * the only place GitHub reports \"who cited me\" without a search query.\n   *\n   * Every source is queried independently and is allowed to fail on its own: an\n   * organization without Issue Dependencies enabled answers 404 for two of the\n   * five calls, and that has to cost the caller those two fields, never the\n   * whole discovery. Only what could be read is reported — nothing here throws.\n   */\n  async fetchRelations(id: string): Promise<IssueRelations> {\n    const issueId = normalizeId(id);\n    if (!/^\\d+$/.test(issueId)) {\n      // A non-numeric identifier cannot address a GitHub REST endpoint; the\n      // Issue simply has no relations we can discover.\n      return emptyRelations(issueId);\n    }\n\n    const base = `repos/{owner}/{repo}/issues/${issueId}`;\n    const [payload, subIssues, blockedBy, blocking, timeline] = await Promise.all([\n      ghApiJson(base),\n      ghApiJson(`${base}/sub_issues?per_page=${API_PAGE_SIZE}`),\n      ghApiJson(`${base}/dependencies/blocked_by?per_page=${API_PAGE_SIZE}`),\n      ghApiJson(`${base}/dependencies/blocking?per_page=${API_PAGE_SIZE}`),\n      ghApiJson(`${base}/timeline?per_page=${API_PAGE_SIZE}`),\n    ]);\n\n    const issue = isRecord(payload) ? payload : null;\n    // Without the REST payload the body still comes from `gh issue view`, so a\n    // repository where only the REST API is blocked keeps the textual fallback.\n    const body = typeof issue?.body === 'string' ? issue.body : await this.bodyFallback(issueId);\n\n    const structured = {\n      id: issueId,\n      parent: issueNumberOf(issue?.parent),\n      children: issueNumbersOf(subIssues),\n      blockedBy: issueNumbersOf(blockedBy),\n      blocking: issueNumbersOf(blocking),\n      references: [],\n      referencedBy: crossReferences(timeline, issueId),\n    };\n\n    return mergeRelations(structured, parseTextualRelations(body, issueId));\n  }\n\n  /** Body of an Issue when the REST payload could not be read. Never throws. */\n  private async bodyFallback(issueId: string): Promise<string> {\n    try {\n      return (await this.get(issueId))?.body ?? '';\n    } catch {\n      return '';\n    }\n  }\n\n  async close(id: string): Promise<void> {\n    const issueId = normalizeId(id);\n    const result = await run('gh', ['issue', 'close', issueId]);\n\n    if (result.exitCode !== 0) {\n      const detail = (result.stderr || result.stdout).trim();\n      throw new Error(\n        `Failed to close GitHub issue #${issueId}: ${detail || 'gh issue close failed'}`,\n      );\n    }\n  }\n}\n\n/** Shared instance; providers are stateless, so a singleton is enough. */\nexport const githubIssueProvider = new GitHubIssueProvider();\n","import { constants } from 'node:fs';\nimport { access, mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { ZodError } from 'zod';\nimport { isoNow } from '../../core/state-manager.js';\nimport { issueMetadataSchema } from '../../schemas.js';\nimport type { IssuePaths } from '../../storage/paths.js';\nimport { resolveIssuePaths, resolveProjectPaths } from '../../storage/resolve.js';\nimport { writeFileAtomic } from '../../utils/fs.js';\nimport { getProjectRoot } from '../../utils/git.js';\nimport { run } from '../../utils/shell.js';\nimport { hashIssueContent } from '../hash.js';\nimport type { IssueProvider } from '../provider.js';\nimport type { Issue, IssueDraft, IssueMetadata } from '../types.js';\n\n/** Timeout for the optional remote probes done while allocating an identifier. */\nconst REMOTE_PROBE_TIMEOUT_MS = 10_000;\n\nfunction isNotFound(err: unknown): boolean {\n  const code = (err as NodeJS.ErrnoException).code;\n  return code === 'ENOENT' || code === 'ENOTDIR';\n}\n\n/**\n * True when `dir` already is a writable directory, or does not exist yet but\n * would be created successfully by `mkdir(dir, { recursive: true })` — i.e.\n * its nearest existing ancestor is a writable directory.\n *\n * Never mutates the filesystem: `isAvailable()` only needs to answer \"could\n * this work\", which must not leave a `~/.issue-flow/projects/<id>/` directory\n * behind for a project that ends up never using local issues (every other\n * source is queried on every resolution, so this runs far more often than the\n * provider is actually chosen).\n */\nasync function isWritableDirectory(dir: string): Promise<boolean> {\n  let current = dir;\n  for (;;) {\n    let stats: Awaited<ReturnType<typeof stat>>;\n    try {\n      stats = await stat(current);\n    } catch (err: unknown) {\n      if (!isNotFound(err)) return false;\n      const parent = dirname(current);\n      if (parent === current) return false; // reached the filesystem root\n      current = parent;\n      continue;\n    }\n    if (!stats.isDirectory()) return false;\n    try {\n      await access(current, constants.W_OK);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\n/**\n * Identifiers become path segments, so anything that could escape the issues\n * directory is rejected before it reaches `join`.\n */\nfunction normalizeId(id: string): string {\n  const normalized = id.trim().replace(/^#/, '');\n  if (normalized.length === 0) {\n    throw new Error('Local issue identifier cannot be empty');\n  }\n  if (/[/\\\\]/.test(normalized) || normalized === '.' || normalized === '..') {\n    throw new Error(`Invalid local issue identifier: '${id}'`);\n  }\n  return normalized;\n}\n\nfunction toNumber(id: string): number | null {\n  return /^\\d+$/.test(id) ? Number.parseInt(id, 10) : null;\n}\n\n/**\n * Title lives in the leading H1, body is everything after it.\n *\n * Only the first non-empty line is considered: an H1 further down belongs to\n * the body (issue descriptions routinely use headings), so promoting it would\n * silently retitle the Issue.\n */\nexport function parseIssueMarkdown(content: string): { title: string; body: string } {\n  const lines = content.replace(/\\r\\n?/g, '\\n').split('\\n');\n  const headingIndex = lines.findIndex((line) => line.trim().length > 0);\n  const heading = headingIndex === -1 ? undefined : lines[headingIndex].match(/^#[ \\t]+(.*)$/);\n\n  if (!heading) {\n    return { title: '', body: lines.join('\\n').trim() };\n  }\n\n  return {\n    title: heading[1].trim(),\n    body: lines\n      .slice(headingIndex + 1)\n      .join('\\n')\n      .trim(),\n  };\n}\n\nfunction renderIssueMarkdown(title: string, body: string): string {\n  return `# ${title}\\n\\n${body.trim()}\\n`;\n}\n\n/**\n * Issue provider backed by plain files in the project's global storage\n * directory (`~/.issue-flow/projects/<project-id>/issues/<id>/`).\n *\n * Enables the whole pipeline without any network access: no gh, no remote, no\n * authentication. `issue.md` is the source of truth for the content and\n * `metadata.json` for everything else; the content hash is always recomputed\n * from the file so a hand-edited issue.md is never reported as unchanged.\n *\n * Every path goes through `resolveIssuePaths()`, exactly like the pipeline\n * commands, so an issue that still only exists under the legacy\n * `<projectRoot>/issues/` tree is migrated on first read instead of coming back\n * as \"not found\".\n */\nexport class LocalFileIssueProvider implements IssueProvider {\n  readonly name = 'local' as const;\n\n  private readonly configuredRoot?: string;\n  private cachedRoot?: string;\n\n  /**\n   * @param projectRoot Repository the issues belong to. It is no longer the\n   * literal parent of an `issues/` directory: it is the root the project id —\n   * and therefore the global storage directory — is derived from.\n   */\n  constructor(projectRoot?: string) {\n    this.configuredRoot = projectRoot;\n  }\n\n  /**\n   * True whenever the project's global storage directory already is — or\n   * could be — a writable directory. Never mutates the filesystem, never\n   * throws.\n   *\n   * A brand new project has no directory of its own until something writes, so\n   * \"does it already exist\" would report the provider as unavailable exactly\n   * when it is about to create the very first issue — `isWritableDirectory`\n   * walks up to the nearest existing ancestor instead of requiring the leaf to\n   * be there already.\n   */\n  async isAvailable(): Promise<boolean> {\n    try {\n      const { projectDir } = await resolveProjectPaths({ projectRoot: await this.root() });\n      return await isWritableDirectory(projectDir);\n    } catch {\n      return false;\n    }\n  }\n\n  async get(id: string): Promise<Issue | null> {\n    const issueId = normalizeId(id);\n    const markdownPath = await this.issueFile(issueId);\n\n    let raw: string;\n    try {\n      raw = await readFile(markdownPath, 'utf-8');\n    } catch (err: unknown) {\n      if (isNotFound(err)) return null;\n      throw err;\n    }\n\n    const { title: headingTitle, body } = parseIssueMarkdown(raw);\n    const metadata = await this.readMetadata(issueId);\n    const title = headingTitle || metadata?.title || '';\n\n    if (metadata) {\n      return {\n        id: metadata.id,\n        number: metadata.number,\n        title,\n        body,\n        labels: metadata.labels,\n        state: metadata.state,\n        source: 'local',\n        remoteRef: metadata.remote?.ref ?? null,\n        createdAt: metadata.createdAt,\n        updatedAt: metadata.updatedAt,\n        contentHash: hashIssueContent(title, body),\n        raw: metadata,\n      };\n    }\n\n    // metadata.json is optional: an issue.md dropped in by hand still works,\n    // with timestamps taken from the file itself.\n    const stats = await stat(markdownPath);\n    return {\n      id: issueId,\n      number: toNumber(issueId),\n      title,\n      body,\n      labels: [],\n      state: 'open',\n      source: 'local',\n      remoteRef: null,\n      createdAt: stats.birthtime.toISOString(),\n      updatedAt: stats.mtime.toISOString(),\n      contentHash: hashIssueContent(title, body),\n    };\n  }\n\n  async create(draft: IssueDraft): Promise<Issue> {\n    // An explicit id is how a mirror keeps the identifier of the Issue it\n    // mirrors: allocating a fresh one would make `issue-flow run <n>` see two\n    // unrelated Issues instead of one demand in two places.\n    const id = draft.id === undefined ? String(await this.allocateNumber()) : normalizeId(draft.id);\n    const paths = await this.paths(id);\n\n    await mkdir(paths.issueDir, { recursive: true });\n\n    // Exclusive create (the 'wx' flag, O_EXCL under the hood) instead of a\n    // check-then-write: two concurrent `create()` calls racing the same id\n    // would both pass a plain existence check before either writes, and the\n    // second would then silently overwrite the first through the atomic\n    // temp+rename writer. The OS now rejects the loser instead.\n    try {\n      await writeFile(paths.issueFile, renderIssueMarkdown(draft.title, draft.body), {\n        encoding: 'utf-8',\n        flag: 'wx',\n      });\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'EEXIST') {\n        throw new Error(\n          `Local issue '${id}' already exists at ${paths.issueFile}. ` +\n            'Remove it or pick another identifier before creating a new Issue.',\n        );\n      }\n      throw err;\n    }\n\n    const timestamp = isoNow();\n    const metadata: IssueMetadata = {\n      schemaVersion: 1,\n      id,\n      number: toNumber(id),\n      source: 'local',\n      title: draft.title,\n      labels: draft.labels,\n      state: 'open',\n      createdAt: timestamp,\n      updatedAt: timestamp,\n      contentHash: hashIssueContent(draft.title, draft.body),\n      ...(draft.remote ? { remote: draft.remote } : {}),\n    };\n\n    await this.writeMetadata(id, metadata);\n\n    return {\n      id,\n      number: metadata.number,\n      title: draft.title,\n      body: draft.body.trim(),\n      labels: draft.labels,\n      state: 'open',\n      source: 'local',\n      remoteRef: draft.remote?.ref ?? null,\n      createdAt: timestamp,\n      updatedAt: timestamp,\n      contentHash: metadata.contentHash,\n      raw: metadata,\n    };\n  }\n\n  async close(id: string): Promise<void> {\n    const issue = await this.get(id);\n    if (!issue) {\n      const issueDir = (await this.paths(normalizeId(id))).issueDir;\n      throw new Error(`Local issue '${normalizeId(id)}' not found at ${issueDir}`);\n    }\n\n    const issueId = normalizeId(id);\n    const existing = await this.readMetadata(issueId);\n\n    await this.writeMetadata(issueId, {\n      schemaVersion: 1,\n      id: issue.id,\n      number: issue.number,\n      source: existing?.source ?? 'local',\n      title: issue.title,\n      labels: issue.labels,\n      state: 'closed',\n      createdAt: issue.createdAt,\n      updatedAt: isoNow(),\n      contentHash: issue.contentHash,\n      ...(existing?.remote ? { remote: existing.remote } : {}),\n    });\n  }\n\n  /**\n   * Next free identifier: above every local number and, when GitHub answers,\n   * above every remote one too. Sharing a numbering space with the remote is\n   * what makes a naive `localMax + 1` collide the moment someone opens an Issue\n   * on GitHub.\n   */\n  async allocateNumber(): Promise<number> {\n    const [local, remote] = await Promise.all([this.highestLocalNumber(), highestRemoteNumber()]);\n    return Math.max(local, remote) + 1;\n  }\n\n  private async root(): Promise<string> {\n    if (this.configuredRoot !== undefined) return this.configuredRoot;\n    this.cachedRoot ??= await getProjectRoot();\n    return this.cachedRoot;\n  }\n\n  /**\n   * Every artifact of one issue, from the same resolver the pipeline commands\n   * use — which is also what triggers the migration of a legacy-only issue.\n   */\n  private async paths(id: string): Promise<IssuePaths> {\n    return resolveIssuePaths(id, { projectRoot: await this.root() });\n  }\n\n  private async issueFile(id: string): Promise<string> {\n    return (await this.paths(id)).issueFile;\n  }\n\n  private async metadataFile(id: string): Promise<string> {\n    return (await this.paths(id)).metadataFile;\n  }\n\n  /** Parsed metadata.json, or `null` when the file is absent. */\n  private async readMetadata(id: string): Promise<IssueMetadata | null> {\n    const path = await this.metadataFile(id);\n\n    let raw: string;\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch (err: unknown) {\n      if (isNotFound(err)) return null;\n      throw err;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch (err: unknown) {\n      throw new Error(`Invalid JSON in ${path}: ${(err as Error).message}`);\n    }\n\n    try {\n      return issueMetadataSchema.parse(parsed);\n    } catch (err: unknown) {\n      if (err instanceof ZodError) {\n        const details = err.issues\n          .map((issue) => `  - ${issue.path.join('.') || '(root)'}: ${issue.message}`)\n          .join('\\n');\n        throw new Error(`Invalid issue metadata at ${path}:\\n${details}`);\n      }\n      throw err;\n    }\n  }\n\n  private async writeMetadata(id: string, metadata: IssueMetadata): Promise<void> {\n    await writeFileAtomic(await this.metadataFile(id), `${JSON.stringify(metadata, null, 2)}\\n`);\n  }\n\n  /**\n   * Highest number across every `<issuesDir>/<id>/metadata.json` and numeric\n   * directory name.\n   *\n   * Resolving `issuesDir` also migrates the legacy tree when it is the only one\n   * that exists, which is what keeps an already-taken number from being handed\n   * out a second time after adopting the global storage.\n   */\n  private async highestLocalNumber(): Promise<number> {\n    const { issuesDir: dir } = await resolveProjectPaths({ projectRoot: await this.root() });\n\n    let entries: string[];\n    try {\n      entries = (await readdir(dir, { withFileTypes: true }))\n        .filter((entry) => entry.isDirectory())\n        .map((entry) => entry.name);\n    } catch (err: unknown) {\n      if (isNotFound(err)) return 0;\n      throw err;\n    }\n\n    const numbers = await Promise.all(\n      entries.map(async (name) => {\n        const fromName = toNumber(name) ?? 0;\n        // A directory whose metadata is unreadable still occupies its number.\n        const fromMetadata = await this.readMetadata(name)\n          .then((metadata) => metadata?.number ?? 0)\n          .catch(() => 0);\n        return Math.max(fromName, fromMetadata);\n      }),\n    );\n\n    return numbers.reduce((max, value) => Math.max(max, value), 0);\n  }\n}\n\n/** How many of the most-recently-created issues/PRs to inspect per probe. */\nconst REMOTE_PROBE_SAMPLE_SIZE = 20;\n\n/**\n * Highest number already taken on GitHub, or 0 when the remote is unreachable.\n *\n * Issues and pull requests share one counter, so both are probed: allocating\n * above the newest Issue alone would still collide with an open PR. Every\n * failure degrades to 0 — being offline must not block local creation.\n *\n * `gh ... list` defaults to sorting by creation date descending, which lines\n * up with number order in the overwhelming majority of repos — but that sort\n * is an implementation detail, not a contract. Rather than trust that the\n * single most-recent entry is also the highest-numbered one, a small sample\n * is fetched and the max is taken across it, which also tolerates the rare\n * case of a transferred issue whose creation date and number disagree.\n */\nasync function highestRemoteNumber(): Promise<number> {\n  const probes = [\n    ['issue', 'list'],\n    ['pr', 'list'],\n  ];\n\n  const results = await Promise.all(\n    probes.map(async (args) => {\n      try {\n        const result = await run(\n          'gh',\n          [\n            ...args,\n            '--state',\n            'all',\n            '--limit',\n            String(REMOTE_PROBE_SAMPLE_SIZE),\n            '--json',\n            'number',\n          ],\n          { timeout: REMOTE_PROBE_TIMEOUT_MS },\n        );\n        if (result.exitCode !== 0) return 0;\n\n        const parsed = JSON.parse(result.stdout);\n        if (!Array.isArray(parsed)) return 0;\n        return parsed.reduce((max: number, entry: unknown) => {\n          const n = (entry as { number?: unknown } | null)?.number;\n          return typeof n === 'number' ? Math.max(max, n) : max;\n        }, 0);\n      } catch {\n        return 0;\n      }\n    }),\n  );\n\n  return results.reduce((max, value) => Math.max(max, value), 0);\n}\n\n/** Shared instance resolving the project root lazily via git. */\nexport const localFileIssueProvider = new LocalFileIssueProvider();\n","import { githubIssueProvider } from './providers/github.js';\nimport { localFileIssueProvider } from './providers/local.js';\nimport { getRegisteredSources, registerProvider } from './registry.js';\n\n/**\n * Register the providers that ship with issue-flow.\n *\n * Idempotent and non-destructive: an origin that is already registered is left\n * untouched, so a test (or a future plugin) can install its own provider before\n * the first `resolveIssue` call without having it replaced by the built-in one.\n */\nexport function ensureProvidersRegistered(): void {\n  const registered = new Set(getRegisteredSources());\n\n  if (!registered.has('github')) {\n    registerProvider(githubIssueProvider);\n  }\n  if (!registered.has('local')) {\n    registerProvider(localFileIssueProvider);\n  }\n}\n","import { createInterface, type Interface as ReadlineInterface } from 'node:readline';\nimport { loadIssuesConfig } from '../config.js';\nimport { printInfo, printWarning } from '../ui/logger.js';\nimport { ensureProvidersRegistered } from './bootstrap.js';\nimport { getProvider, getRegisteredSources } from './registry.js';\nimport type { Issue, IssueSource, IssuesConfig, ResolvedIssue } from './types.js';\n\n/**\n * Failure to settle on an Issue. Carries the exit code the CLI should return,\n * so callers propagate it instead of inventing their own.\n */\nexport class IssueResolutionError extends Error {\n  readonly exitCode: number;\n\n  constructor(message: string, exitCode = 1) {\n    super(message);\n    this.name = 'IssueResolutionError';\n    this.exitCode = exitCode;\n  }\n}\n\nexport interface ResolveIssueOptions {\n  /** Already-resolved provider configuration. Defaults to loadIssuesConfig(). */\n  config?: IssuesConfig;\n  /** Origins to query. Defaults to every registered source. */\n  sources?: IssueSource[];\n  /**\n   * Whether a prompt may be shown. Defaults to a real TTY outside CI, which is\n   * what keeps `ask` from ever blocking a headless run.\n   */\n  interactive?: boolean;\n  /** Input stream for the conflict prompt. Defaults to process.stdin. */\n  stdin?: NodeJS.ReadableStream;\n  /** Output stream for the conflict prompt. Defaults to process.stdout. */\n  stdout?: NodeJS.WritableStream;\n  /** Informational sink. Defaults to printInfo. */\n  info?: (message: string) => void;\n  /** Warning sink. Defaults to printWarning. */\n  warn?: (message: string) => void;\n}\n\n/** How many invalid answers are tolerated before the prompt gives up. */\nconst MAX_PROMPT_ATTEMPTS = 3;\n\n/**\n * Labels shown to users for the built-in origins. An origin registered from\n * outside this package is displayed under its own name, so a new provider needs\n * no entry here.\n */\nconst SOURCE_LABELS: Record<string, string> = {\n  github: 'GitHub',\n  local: 'local',\n};\n\nfunction sourceLabel(source: IssueSource): string {\n  return SOURCE_LABELS[source] ?? source;\n}\n\n/** Same label, capitalized for the numbered prompt ('local' -> 'Local'). */\nfunction promptLabel(source: IssueSource): string {\n  const label = sourceLabel(source);\n  return label.charAt(0).toUpperCase() + label.slice(1);\n}\n\ninterface Candidate {\n  source: IssueSource;\n  issue: Issue | null;\n  /** Why the origin produced nothing, used only to explain a total miss. */\n  reason: string | null;\n}\n\n/** A candidate that actually produced an Issue. */\ninterface FoundCandidate extends Candidate {\n  issue: Issue;\n}\n\nfunction errorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n\n/**\n * Read one origin without letting it break the others.\n *\n * An unavailable provider or a failed read degrades to \"no candidate\" plus a\n * reason: as long as another origin has the Issue the pipeline keeps going, and\n * when nothing is found the reasons are surfaced in the final error so a broken\n * environment is never reported as a missing Issue.\n */\nasync function fetchCandidate(\n  source: IssueSource,\n  id: string,\n  warn: (message: string) => void,\n): Promise<Candidate> {\n  let provider: ReturnType<typeof getProvider>;\n  try {\n    provider = getProvider(source);\n  } catch (err) {\n    return { source, issue: null, reason: errorMessage(err) };\n  }\n\n  let available: boolean;\n  try {\n    available = await provider.isAvailable();\n  } catch (err) {\n    return { source, issue: null, reason: `provider unavailable (${errorMessage(err)})` };\n  }\n  if (!available) {\n    return { source, issue: null, reason: 'provider unavailable' };\n  }\n\n  try {\n    const issue = await provider.get(id);\n    return { source, issue, reason: issue === null ? 'not found' : null };\n  } catch (err) {\n    const reason = errorMessage(err);\n    // A real failure (network, auth, corrupted metadata) must be visible even\n    // when the other origin answers.\n    warn(`Could not read issue '${id}' from ${sourceLabel(source)}: ${reason}`);\n    return { source, issue: null, reason };\n  }\n}\n\nfunction shortHash(hash: string): string {\n  const hex = hash.startsWith('sha256:') ? hash.slice('sha256:'.length) : hash;\n  return hex.slice(0, 12);\n}\n\n/** One line per origin describing what differs, without dumping every body. */\nfunction describeCandidate(source: IssueSource, issue: Issue): string {\n  const lines = issue.body.length === 0 ? 0 : issue.body.split('\\n').length;\n  return (\n    `  ${sourceLabel(source).padEnd(6)} title: \"${issue.title}\" | body: ${lines} line(s), ` +\n    `${issue.body.length} char(s) | updated: ${issue.updatedAt} | hash: ${shortHash(issue.contentHash)}`\n  );\n}\n\n/** 'local and GitHub', 'local, GitHub and memory' — origins in query order. */\nfunction listSources(candidates: FoundCandidate[]): string {\n  const labels = candidates.map((candidate) => sourceLabel(candidate.source));\n  if (labels.length <= 1) {\n    return labels.join('');\n  }\n  return `${labels.slice(0, -1).join(', ')} and ${labels[labels.length - 1]}`;\n}\n\n/**\n * Turn a readline interface into an awaitable line reader.\n *\n * Lines are queued instead of read on demand: `rl.question` drops whatever\n * arrives between two questions, which silently loses a piped answer typed\n * ahead of the prompt. Resolves `null` once the input is exhausted, so EOF ends\n * the prompt instead of hanging the process.\n */\nfunction createLineReader(\n  rl: ReadlineInterface,\n  output: NodeJS.WritableStream,\n): (query: string) => Promise<string | null> {\n  const queued: string[] = [];\n  let pending: ((line: string | null) => void) | null = null;\n  let closed = false;\n\n  rl.on('line', (line: string) => {\n    if (pending !== null) {\n      const resolve = pending;\n      pending = null;\n      resolve(line);\n      return;\n    }\n    queued.push(line);\n  });\n  rl.on('close', () => {\n    closed = true;\n    if (pending !== null) {\n      const resolve = pending;\n      pending = null;\n      resolve(null);\n    }\n  });\n\n  return (query: string) =>\n    new Promise<string | null>((resolve) => {\n      const buffered = queued.shift();\n      if (buffered !== undefined) {\n        resolve(buffered);\n        return;\n      }\n      if (closed) {\n        resolve(null);\n        return;\n      }\n      output.write(query);\n      pending = resolve;\n    });\n}\n\n/**\n * Interactive choice between the divergent versions.\n *\n * The options are numbered from the origins that actually answered, so a third\n * provider simply shows up as `[3] Memory` without this function knowing which\n * origins exist. Cancel is always the last option.\n */\nasync function promptChoice(\n  sources: IssueSource[],\n  stdin: NodeJS.ReadableStream,\n  stdout: NodeJS.WritableStream,\n  warn: (message: string) => void,\n): Promise<IssueSource | 'cancel'> {\n  const options = sources.map((source, index) => `[${index + 1}] ${promptLabel(source)}`);\n  const cancelOption = sources.length + 1;\n  const query = `Which version should be used? ${options.join('  ')}  [${cancelOption}] Cancel: `;\n  const numbers = Array.from({ length: cancelOption }, (_, index) => String(index + 1));\n  const accepted = `${numbers.slice(0, -1).join(', ')} or ${numbers[numbers.length - 1]}`;\n\n  const rl = createInterface({ input: stdin, output: stdout });\n  const ask = createLineReader(rl, stdout);\n  try {\n    for (let attempt = 0; attempt < MAX_PROMPT_ATTEMPTS; attempt++) {\n      const answer = await ask(query);\n      if (answer === null) {\n        return 'cancel';\n      }\n      const choice = answer.trim();\n      const picked = sources[Number(choice) - 1];\n      if (choice.length > 0 && picked !== undefined) {\n        return picked;\n      }\n      if (choice === String(cancelOption)) {\n        return 'cancel';\n      }\n      warn(`Invalid choice: '${choice}'. Enter ${accepted}.`);\n    }\n    return 'cancel';\n  } finally {\n    rl.close();\n  }\n}\n\nfunction isInteractiveByDefault(): boolean {\n  const ci = process.env.CI;\n  const inCi = ci !== undefined && ci !== '' && ci !== '0' && ci.toLowerCase() !== 'false';\n  return Boolean(process.stdin.isTTY) && !inCi;\n}\n\nfunction buildResolved(\n  issue: Issue,\n  source: IssueSource,\n  local: Issue | null,\n  github: Issue | null,\n  divergent: boolean,\n): ResolvedIssue {\n  return { issue, source, local, github, divergent };\n}\n\n/** Origin `conflictPolicy` points at, or `null` for 'ask'. */\nfunction policyTarget(policy: IssuesConfig['conflictPolicy']): IssueSource | null {\n  if (policy === 'prefer-local') {\n    return 'local';\n  }\n  if (policy === 'prefer-github') {\n    return 'github';\n  }\n  return null;\n}\n\n/**\n * Single entry point every command uses to decide which Issue the pipeline\n * works on.\n *\n * The logic is written against the origins that answered, never against a fixed\n * list of sources: registering a new provider is enough for it to take part in\n * the resolution, be reported in a divergence and appear in the prompt.\n *\n * Scenarios:\n * - only one origin has it -> that one, no questions asked;\n * - several, same contentHash -> equivalence is reported and the preferred\n *   origin wins, without a prompt;\n * - several, different content -> the divergence is reported and\n *   `conflictPolicy` decides (`ask` prompts on a TTY, falls back to\n *   `preferredProvider` with a warning anywhere else);\n * - none -> IssueResolutionError, which carries the CLI exit code.\n */\nexport async function resolveIssue(\n  id: string,\n  opts: ResolveIssueOptions = {},\n): Promise<ResolvedIssue> {\n  const info = opts.info ?? printInfo;\n  const warn = opts.warn ?? printWarning;\n  const config = opts.config ?? (await loadIssuesConfig({ warn }));\n\n  ensureProvidersRegistered();\n  const sources = opts.sources ?? getRegisteredSources();\n\n  // Each origin is an independent I/O call (network for GitHub, disk for\n  // local); querying them concurrently instead of one-by-one keeps the total\n  // latency at the slowest origin instead of the sum of all of them, without\n  // changing which candidate wins (order is preserved by Promise.all).\n  const candidates: Candidate[] = await Promise.all(\n    sources.map((source) => fetchCandidate(source, id, warn)),\n  );\n\n  const issueOf = (source: IssueSource): Issue | null =>\n    candidates.find((candidate) => candidate.source === source)?.issue ?? null;\n  const local = issueOf('local');\n  const github = issueOf('github');\n\n  const found = candidates.filter(\n    (candidate): candidate is FoundCandidate => candidate.issue !== null,\n  );\n\n  if (found.length === 0) {\n    const details = candidates\n      .map((candidate) => `${sourceLabel(candidate.source)}: ${candidate.reason ?? 'not found'}`)\n      .join('; ');\n    const where = details.length > 0 ? ` (${details})` : '';\n    throw new IssueResolutionError(`Issue '${id}' not found in any registered origin${where}`);\n  }\n\n  const build = (candidate: FoundCandidate, divergent: boolean): ResolvedIssue =>\n    buildResolved(candidate.issue, candidate.source, local, github, divergent);\n\n  const firstFound = found[0] as FoundCandidate;\n  if (found.length === 1) {\n    return build(firstFound, false);\n  }\n\n  // Several origins have it. The preferred one wins whenever it is among them;\n  // otherwise the first origin queried does, so an unrelated preference never\n  // leaves the pipeline without an Issue.\n  const preferred =\n    found.find((candidate) => candidate.source === config.preferredProvider) ?? firstFound;\n\n  const distinct = new Set(found.map((candidate) => candidate.issue.contentHash));\n  if (distinct.size === 1) {\n    info(\n      `Issue '${id}' has identical content in ${listSources(found)}; using ${sourceLabel(preferred.source)}.`,\n    );\n    return build(preferred, false);\n  }\n\n  info(`Issue '${id}' differs between origins:`);\n  for (const candidate of found) {\n    info(describeCandidate(candidate.source, candidate.issue));\n  }\n\n  const target = policyTarget(config.conflictPolicy);\n  if (target !== null) {\n    const chosen = found.find((candidate) => candidate.source === target);\n    if (chosen !== undefined) {\n      info(`Conflict policy '${config.conflictPolicy}': using the ${sourceLabel(target)} version.`);\n      return build(chosen, true);\n    }\n    // The policy names an origin that has no version of this Issue: say so\n    // instead of silently picking for the user under its name.\n    warn(\n      `Conflict policy '${config.conflictPolicy}' does not apply to Issue '${id}' ` +\n        `(${sourceLabel(target)} has no version of it); using ${sourceLabel(preferred.source)}.`,\n    );\n    return build(preferred, true);\n  }\n\n  const interactive = opts.interactive ?? isInteractiveByDefault();\n  if (!interactive) {\n    warn(\n      `Divergent Issue '${id}' and conflict policy 'ask' in a non-interactive environment; ` +\n        `using the preferred provider (${sourceLabel(preferred.source)}).`,\n    );\n    return build(preferred, true);\n  }\n\n  const choice = await promptChoice(\n    found.map((candidate) => candidate.source),\n    opts.stdin ?? process.stdin,\n    opts.stdout ?? process.stdout,\n    warn,\n  );\n  if (choice === 'cancel') {\n    throw new IssueResolutionError(\n      `Cancelled: Issue '${id}' diverges between ${listSources(found)}.`,\n    );\n  }\n  const picked = found.find((candidate) => candidate.source === choice) as FoundCandidate;\n  return build(picked, true);\n}\n","import { printError } 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      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    return { ok: false, code: 1 };\n  }\n}\n"],"mappings":"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","names":["normalizeId"]}

package/dist/chunk-SP7DD4ID.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+import {
+  readFileWithGrace,
+  runPhaseWithRetry
+} from "./chunk-UUY4PCWW.js";
+import {
+  issuePlaceholders,
+  resolveCommandIssue
+} from "./chunk-S67Q4I2O.js";
+import {
+  isTransientFailure
+} from "./chunk-HDV3YDTG.js";
+import {
+  runHeadless
+} from "./chunk-MXTGCD5C.js";
+import {
+  publishPhaseMetrics
+} from "./chunk-PPLIXZI5.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
+import {
+  getIssuePaths,
+  getProjectRoot,
+  recordUserStoryNumbering,
+  resolveIssuePaths,
+  resolveProjectPaths
+} from "./chunk-VYFKOUUR.js";
+import {
+  getGlobalTimeout,
+  isoNow,
+  loadTaskPlan,
+  printError,
+  printInfo,
+  printSuccess,
+  printWarning,
+  saveTaskPlan,
+  taskPlanSchema
+} from "./chunk-V5OHFSW4.js";
+
+// src/commands/plan.ts
+import { mkdir, readFile as readFile2 } from "fs/promises";
+
+// src/storage/user-story-numbering.ts
+import { readdir, readFile } from "fs/promises";
+var USER_STORY_ID_PAD = 3;
+function formatUserStoryId(n) {
+  return `US-${String(n).padStart(USER_STORY_ID_PAD, "0")}`;
+}
+function parseUserStoryNumber(id) {
+  const matches = id.match(/\d+/g);
+  if (!matches || matches.length === 0) return null;
+  const value = Number.parseInt(matches[matches.length - 1], 10);
+  return Number.isNaN(value) ? null : value;
+}
+async function readUserStoryIds(tasksPath) {
+  let raw;
+  try {
+    raw = await readFile(tasksPath, "utf-8");
+  } catch {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || !Array.isArray(parsed.userStories)) {
+      return null;
+    }
+    return parsed.userStories.map(
+      (story) => typeof story === "object" && story !== null && typeof story.id === "string" ? story.id : null
+    ).filter((id) => id !== null);
+  } catch {
+    return null;
+  }
+}
+async function findHighestUserStoryNumber(options = {}) {
+  const { excludeIssueId, ...rootOptions } = options;
+  const { projectId, issuesDir } = await resolveProjectPaths(rootOptions);
+  let entries;
+  try {
+    entries = (await readdir(issuesDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch (error) {
+    if (error?.code === "ENOENT") return null;
+    throw new Error(
+      `Could not scan the project's User Story history at ${issuesDir}: ${error.message}. Fix the storage directory, or pass --start-us <n> to set the numbering explicitly.`,
+      { cause: error }
+    );
+  }
+  let best = null;
+  for (const issueId of entries) {
+    if (excludeIssueId !== void 0 && issueId === excludeIssueId) continue;
+    const { tasksFile } = getIssuePaths(projectId, issueId, { env: options.env });
+    const ids = await readUserStoryIds(tasksFile);
+    if (!ids) continue;
+    for (const id of ids) {
+      const value = parseUserStoryNumber(id);
+      if (value === null) continue;
+      if (best === null || value > best.number) {
+        best = { number: value, issueId, storyId: id };
+      }
+    }
+  }
+  return best;
+}
+async function resolveUserStoryNumbering(options) {
+  const { issueNumber, continueFlag, startUs, now, ...rootOptions } = options;
+  const decidedAt = (now ?? isoNow)();
+  if (startUs !== void 0) {
+    const decision2 = {
+      nextNumber: startUs,
+      source: "start-us",
+      issueNumber,
+      decidedAt
+    };
+    return {
+      decision: decision2,
+      message: `User Story numbering forced to ${formatUserStoryId(startUs)} via --start-us.`
+    };
+  }
+  const highest = await findHighestUserStoryNumber({ ...rootOptions, excludeIssueId: issueNumber });
+  if (highest === null) {
+    const decision2 = {
+      nextNumber: 1,
+      source: "none",
+      issueNumber,
+      decidedAt
+    };
+    return {
+      decision: decision2,
+      message: `Starting User Story numbering at ${formatUserStoryId(1)} (no previous history found for this project).`
+    };
+  }
+  const nextNumber = highest.number + 1;
+  const decision = {
+    nextNumber,
+    source: "history",
+    issueNumber,
+    decidedAt,
+    detail: `${highest.storyId} (issue #${highest.issueId})`
+  };
+  const via = continueFlag ? " via --continue" : "";
+  return {
+    decision,
+    message: `Continuing User Story numbering from ${formatUserStoryId(nextNumber)}${via} \u2014 last used was ${highest.storyId} (issue #${highest.issueId}).`
+  };
+}
+async function determineUserStoryNumbering(options) {
+  const { projectRoot: projectRootOption, ...rest } = options;
+  const projectRoot = projectRootOption ?? await getProjectRoot();
+  const outcome = await resolveUserStoryNumbering({ ...rest, projectRoot });
+  await recordUserStoryNumbering(projectRoot, outcome.decision, {
+    env: options.env,
+    now: options.now
+  });
+  return { ...outcome, nextUserStoryId: formatUserStoryId(outcome.decision.nextNumber) };
+}
+
+// src/commands/plan.ts
+async function runPlan(issue, resolvedIssue, numbering) {
+  const issueNumber = issue.replace(/^#/, "");
+  const paths = await resolveIssuePaths(issueNumber);
+  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);
+  if (!resolution.ok) {
+    return resolution.code;
+  }
+  const prdPath = paths.prdFile;
+  let prdContent;
+  try {
+    prdContent = await readFile2(prdPath, "utf-8");
+  } catch {
+    printError(`PRD not found at ${prdPath}. Run 'issue-flow prd ${issueNumber}' first.`);
+    return 1;
+  }
+  const tasksPath = paths.tasksFile;
+  const {
+    message: numberingMessage,
+    nextUserStoryId,
+    decision: { nextNumber }
+  } = await determineUserStoryNumbering({
+    issueNumber,
+    continueFlag: numbering?.continueFlag,
+    startUs: numbering?.startUs
+  });
+  printInfo(numberingMessage);
+  const template = await loadPrompt("plan");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __PRD_CONTENT__: prdContent,
+    __TASKS_PATH__: tasksPath,
+    __NEXT_US_NUMBER__: nextUserStoryId,
+    ...issuePlaceholders(resolution.resolved)
+  });
+  await mkdir(paths.issueDir, { recursive: true });
+  const outcome = await runPhaseWithRetry({
+    phase: "plan",
+    attempt: async () => {
+      const startedAtMs = Date.now();
+      const result = await runHeadless({
+        prompt,
+        maxTurns: 25,
+        timeout: getGlobalTimeout() ?? 3e5,
+        // json (not text) so the CLI reports usage: the envelope's `result`
+        // field carries the same assistant text this phase already consumed.
+        outputFormat: "json",
+        allowedTools: ["Bash", "Read", "Glob", "Grep", "Write"],
+        addDirs: [paths.issueDir],
+        statusMessage: `Converting PRD to task plan for issue #${issueNumber}...`
+      });
+      publishPhaseMetrics("plan", result.cost, startedAtMs);
+      if (!result.success) {
+        return {
+          ok: false,
+          transient: isTransientFailure(1, result.error ?? ""),
+          error: `Task plan generation failed: ${result.error}`
+        };
+      }
+      let rawContent;
+      try {
+        rawContent = await readFileWithGrace(tasksPath);
+      } catch {
+        return { ok: false, transient: true, error: `tasks.json was not created at ${tasksPath}` };
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(rawContent);
+      } catch {
+        return { ok: false, transient: true, error: "tasks.json contains invalid JSON" };
+      }
+      const validation = taskPlanSchema.safeParse(parsed);
+      if (!validation.success) {
+        const issues = validation.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        return {
+          ok: false,
+          transient: true,
+          error: `tasks.json does not match expected schema:
+${issues}`
+        };
+      }
+      return { ok: true };
+    }
+  });
+  if (!outcome.ok) {
+    printError(outcome.error ?? `Task plan generation failed for issue #${issueNumber}`);
+    return 1;
+  }
+  const plan = await loadTaskPlan(tasksPath);
+  plan.pipeline.jsonCompleted = true;
+  await saveTaskPlan(tasksPath, plan);
+  const generatedLowest = plan.userStories.map((story) => parseUserStoryNumber(story.id)).filter((value) => value !== null).reduce(
+    (lowest, value) => lowest === null ? value : Math.min(lowest, value),
+    null
+  );
+  if (generatedLowest !== null && generatedLowest < nextNumber) {
+    printWarning(
+      `The generated plan starts at ${formatUserStoryId(generatedLowest)}, not the requested ${nextUserStoryId}. User Story ids may collide with earlier issues of this project \u2014 re-run 'issue-flow plan ${issueNumber} --start-us ${nextNumber}' if that matters.`
+    );
+  }
+  printSuccess(`Task plan saved to ${tasksPath} (${plan.userStories.length} stories)`);
+  return 0;
+}
+
+export {
+  runPlan
+};
+//# sourceMappingURL=chunk-SP7DD4ID.js.map

package/dist/chunk-SP7DD4ID.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/plan.ts","../src/storage/user-story-numbering.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { runHeadless } from '../core/headless.js';\nimport { readFileWithGrace, runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { ResolvedIssue } from '../issues/types.js';\nimport { taskPlanSchema } from '../schemas.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport {\n  determineUserStoryNumbering,\n  formatUserStoryId,\n  parseUserStoryNumber,\n} from '../storage/user-story-numbering.js';\nimport { printError, printInfo, printSuccess, printWarning } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\n/** `--continue` / `--start-us <n>` override of the numbering cascade (issue #36). */\nexport interface PlanUserStoryNumberingOptions {\n  continueFlag?: boolean;\n  startUs?: number;\n}\n\nexport async function runPlan(\n  issue: string,\n  resolvedIssue?: ResolvedIssue,\n  numbering?: PlanUserStoryNumberingOptions,\n): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const paths = await resolveIssuePaths(issueNumber);\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\n\n  // Read the PRD\n  const prdPath = paths.prdFile;\n  let prdContent: string;\n  try {\n    prdContent = await readFile(prdPath, 'utf-8');\n  } catch {\n    printError(`PRD not found at ${prdPath}. Run 'issue-flow prd ${issueNumber}' first.`);\n    return 1;\n  }\n\n  const tasksPath = paths.tasksFile;\n\n  // Resolve the User Story numbering continuity (issue #36), log where the\n  // decision came from — never silently — and persist it into the project's\n  // metadata.json for audit before the prompt is even built, so the record on\n  // disk always matches what the prompt was told.\n  const {\n    message: numberingMessage,\n    nextUserStoryId,\n    decision: { nextNumber },\n  } = await determineUserStoryNumbering({\n    issueNumber,\n    continueFlag: numbering?.continueFlag,\n    startUs: numbering?.startUs,\n  });\n  printInfo(numberingMessage);\n\n  const template = await loadPrompt('plan');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __PRD_CONTENT__: prdContent,\n    __TASKS_PATH__: tasksPath,\n    __NEXT_US_NUMBER__: nextUserStoryId,\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  await mkdir(paths.issueDir, { recursive: true });\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'plan',\n    attempt: async () => {\n      const startedAtMs = Date.now();\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 25,\n        timeout: getGlobalTimeout() ?? 300_000,\n        // json (not text) so the CLI reports usage: the envelope's `result`\n        // field carries the same assistant text this phase already consumed.\n        outputFormat: 'json',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep', 'Write'],\n        addDirs: [paths.issueDir],\n        statusMessage: `Converting PRD to task plan for issue #${issueNumber}...`,\n      });\n      // One event per attempt; the reducer sums them into the phase total.\n      publishPhaseMetrics('plan', result.cost, startedAtMs);\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `Task plan generation failed: ${result.error}`,\n        };\n      }\n\n      // Verify the file was created, tolerating a brief FS-visibility lag.\n      let rawContent: string;\n      try {\n        rawContent = await readFileWithGrace(tasksPath);\n      } catch {\n        return { ok: false, transient: true, error: `tasks.json was not created at ${tasksPath}` };\n      }\n\n      // Validate JSON structure — a content defect, not a timing issue, but\n      // still worth a bounded retry since it's a fresh Claude invocation.\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(rawContent);\n      } catch {\n        return { ok: false, transient: true, error: 'tasks.json contains invalid JSON' };\n      }\n\n      // Validate with zod schema\n      const validation = taskPlanSchema.safeParse(parsed);\n      if (!validation.success) {\n        const issues = validation.error.issues\n          .map((i) => `  - ${i.path.join('.')}: ${i.message}`)\n          .join('\\n');\n        return {\n          ok: false,\n          transient: true,\n          error: `tasks.json does not match expected schema:\\n${issues}`,\n        };\n      }\n\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `Task plan generation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  // Ensure pipeline state reflects completion of this phase\n  const plan = await loadTaskPlan(tasksPath);\n  plan.pipeline.jsonCompleted = true;\n  await saveTaskPlan(tasksPath, plan);\n\n  // The numbering is a prompt instruction, not a programmatic rewrite, so the\n  // generated plan can still ignore it. Say so out loud instead of leaving the\n  // log and metadata.json claiming a numbering the file on disk contradicts.\n  const generatedLowest = plan.userStories\n    .map((story) => parseUserStoryNumber(story.id))\n    .filter((value): value is number => value !== null)\n    .reduce<number | null>(\n      (lowest, value) => (lowest === null ? value : Math.min(lowest, value)),\n      null,\n    );\n  if (generatedLowest !== null && generatedLowest < nextNumber) {\n    printWarning(\n      `The generated plan starts at ${formatUserStoryId(generatedLowest)}, not the requested ` +\n        `${nextUserStoryId}. User Story ids may collide with earlier issues of this project — ` +\n        `re-run 'issue-flow plan ${issueNumber} --start-us ${nextNumber}' if that matters.`,\n    );\n  }\n\n  printSuccess(`Task plan saved to ${tasksPath} (${plan.userStories.length} stories)`);\n  return 0;\n}\n","import { readdir, readFile } from 'node:fs/promises';\nimport { isoNow } from '../core/state-manager.js';\nimport { getProjectRoot } from '../utils/git.js';\nimport { recordUserStoryNumbering } from './compat.js';\nimport { getIssuePaths } from './paths.js';\nimport { type ResolveIssuePathsOptions, resolveProjectPaths } from './resolve.js';\nimport type { UserStoryNumberingDecision } from './schemas.js';\n\n/**\n * Continuity of `US-NNN` numbering across `plan` executions of the same\n * project (issue #36).\n *\n * The User Story `id` field is free-form — `userStorySchema` in\n * `src/schemas.ts` only requires a non-empty string, no `US-NNN` regex is\n * enforced — so every reader here tolerates an id that does not carry a\n * trailing number instead of throwing on it.\n */\n\nconst USER_STORY_ID_PAD = 3;\n\n/** `16` -> `'US-016'`. Numbers past 999 are not padded further. */\nexport function formatUserStoryId(n: number): string {\n  return `US-${String(n).padStart(USER_STORY_ID_PAD, '0')}`;\n}\n\n/**\n * Extract the last run of digits from a User Story id, or `null` when none is\n * found. Tolerant by design: an id like `US-001` yields `1`, but so does a\n * free-form one such as `story-1` or `v2-US-007` (the last digit run, `007`,\n * wins over the `2` version prefix) — only an id with no digits at all (e.g.\n * `add-auth`) is ignored.\n */\nexport function parseUserStoryNumber(id: string): number | null {\n  const matches = id.match(/\\d+/g);\n  if (!matches || matches.length === 0) return null;\n\n  const value = Number.parseInt(matches[matches.length - 1], 10);\n  return Number.isNaN(value) ? null : value;\n}\n\nexport interface HighestUserStoryNumberResult {\n  number: number;\n  /** Issue directory name the winning story came from. */\n  issueId: string;\n  /** Verbatim id of the winning story. */\n  storyId: string;\n}\n\n/**\n * Loose read of one `tasks.json`: only cares about `userStories[].id` and\n * tolerates every failure (missing file, invalid JSON, unexpected shape) by\n * returning `null` — a sibling issue mid-migration, or with a corrupt plan,\n * must not abort the whole project scan.\n */\nasync function readUserStoryIds(tasksPath: string): Promise<string[] | null> {\n  let raw: string;\n  try {\n    raw = await readFile(tasksPath, 'utf-8');\n  } catch {\n    return null;\n  }\n\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (\n      typeof parsed !== 'object' ||\n      parsed === null ||\n      !Array.isArray((parsed as { userStories?: unknown }).userStories)\n    ) {\n      return null;\n    }\n\n    return (parsed as { userStories: unknown[] }).userStories\n      .map((story) =>\n        typeof story === 'object' &&\n        story !== null &&\n        typeof (story as { id?: unknown }).id === 'string'\n          ? (story as { id: string }).id\n          : null,\n      )\n      .filter((id): id is string => id !== null);\n  } catch {\n    return null;\n  }\n}\n\nexport interface FindHighestUserStoryNumberOptions extends ResolveIssuePathsOptions {\n  /**\n   * Issue directory to leave out of the scan — the issue the numbering is\n   * being resolved for. Re-planning an issue overwrites its own `tasks.json`,\n   * so counting the plan about to be replaced would push the numbering forward\n   * on every `plan` re-run of the same issue.\n   */\n  excludeIssueId?: string;\n}\n\n/**\n * Highest User Story number already used anywhere in the project, scanning\n * every `<issuesDir>/<id>/tasks.json` regardless of which issue produced it —\n * that project-wide scope is what makes `US-NNN` unambiguous across issues.\n * The issue named by `excludeIssueId` is skipped, so re-planning is idempotent.\n *\n * `null` means no readable `tasks.json` was found (the project's first `plan`\n * run ever, or a brand-new project directory). A storage directory that exists\n * but cannot be read throws instead: silently restarting at `US-001` because\n * `~/.issue-flow` was momentarily unreadable is the worst outcome this feature\n * can produce.\n */\nexport async function findHighestUserStoryNumber(\n  options: FindHighestUserStoryNumberOptions = {},\n): Promise<HighestUserStoryNumberResult | null> {\n  const { excludeIssueId, ...rootOptions } = options;\n  const { projectId, issuesDir } = await resolveProjectPaths(rootOptions);\n\n  let entries: string[];\n  try {\n    entries = (await readdir(issuesDir, { withFileTypes: true }))\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => entry.name);\n  } catch (error) {\n    // ENOENT is the legitimate \"no history yet\" case. Any other failure\n    // (EACCES, EIO, an unavailable mount) must not be reported as an empty\n    // history, or the numbering would restart silently.\n    if ((error as NodeJS.ErrnoException)?.code === 'ENOENT') return null;\n    throw new Error(\n      `Could not scan the project's User Story history at ${issuesDir}: ` +\n        `${(error as Error).message}. Fix the storage directory, or pass --start-us <n> ` +\n        'to set the numbering explicitly.',\n      { cause: error },\n    );\n  }\n\n  let best: HighestUserStoryNumberResult | null = null;\n\n  for (const issueId of entries) {\n    if (excludeIssueId !== undefined && issueId === excludeIssueId) continue;\n    // Never hand-build an artifact path (see src/storage/CLAUDE.md): asking\n    // getIssuePaths() keeps a rename of `tasks.json` a one-file change instead\n    // of silently making this scan find nothing.\n    const { tasksFile } = getIssuePaths(projectId, issueId, { env: options.env });\n    const ids = await readUserStoryIds(tasksFile);\n    if (!ids) continue;\n\n    for (const id of ids) {\n      const value = parseUserStoryNumber(id);\n      if (value === null) continue;\n      if (best === null || value > best.number) {\n        best = { number: value, issueId, storyId: id };\n      }\n    }\n  }\n\n  return best;\n}\n\nexport interface ResolveUserStoryNumberingOptions extends ResolveIssuePathsOptions {\n  /** Issue the decision is being made for — carried into the audit record. */\n  issueNumber: string;\n  /** `--continue` was passed explicitly. Purely cosmetic on the log message:\n   * the resolved number is identical to the automatic default. */\n  continueFlag?: boolean;\n  /** `--start-us <n>` was passed. Wins outright over any history. */\n  startUs?: number;\n  /** Timestamp source, injectable for tests. */\n  now?: () => string;\n}\n\nexport interface UserStoryNumberingOutcome {\n  decision: UserStoryNumberingDecision;\n  /** Ready-to-print explanation of where the decision came from — the CLI\n   * must never resolve this silently (issue #36). */\n  message: string;\n}\n\n/**\n * Resolve the numbering cascade of #36:\n *\n * 1. `--start-us <n>` wins outright — history is not even scanned, since the\n *    whole point is to ignore it.\n * 2. Otherwise the project's history is scanned for the highest number used\n *    so far. This is what running with no flag at all does automatically,\n *    and what `--continue` names explicitly (the two produce the same\n *    number; the flag only changes the log message).\n * 3. No history found (the project's first `plan` ever) starts at `US-001`.\n *\n * Pure with respect to `metadata.json` — this only reads `tasks.json` files,\n * never writes. Persisting the decision is {@link determineUserStoryNumbering}\n * below, via `recordUserStoryNumbering()` in `compat.ts`.\n */\nexport async function resolveUserStoryNumbering(\n  options: ResolveUserStoryNumberingOptions,\n): Promise<UserStoryNumberingOutcome> {\n  const { issueNumber, continueFlag, startUs, now, ...rootOptions } = options;\n  const decidedAt = (now ?? isoNow)();\n\n  if (startUs !== undefined) {\n    const decision: UserStoryNumberingDecision = {\n      nextNumber: startUs,\n      source: 'start-us',\n      issueNumber,\n      decidedAt,\n    };\n    return {\n      decision,\n      message: `User Story numbering forced to ${formatUserStoryId(startUs)} via --start-us.`,\n    };\n  }\n\n  // The issue being planned is excluded from the scan: `plan` overwrites its\n  // own `tasks.json`, so counting the plan it is about to replace would push\n  // the numbering forward on every re-run of `plan` for the same issue.\n  const highest = await findHighestUserStoryNumber({ ...rootOptions, excludeIssueId: issueNumber });\n\n  if (highest === null) {\n    const decision: UserStoryNumberingDecision = {\n      nextNumber: 1,\n      source: 'none',\n      issueNumber,\n      decidedAt,\n    };\n    return {\n      decision,\n      message: `Starting User Story numbering at ${formatUserStoryId(1)} (no previous history found for this project).`,\n    };\n  }\n\n  const nextNumber = highest.number + 1;\n  const decision: UserStoryNumberingDecision = {\n    nextNumber,\n    source: 'history',\n    issueNumber,\n    decidedAt,\n    detail: `${highest.storyId} (issue #${highest.issueId})`,\n  };\n  const via = continueFlag ? ' via --continue' : '';\n  return {\n    decision,\n    message:\n      `Continuing User Story numbering from ${formatUserStoryId(nextNumber)}${via} ` +\n      `— last used was ${highest.storyId} (issue #${highest.issueId}).`,\n  };\n}\n\nexport interface DetermineUserStoryNumberingOptions extends ResolveUserStoryNumberingOptions {\n  /** Repository root. Defaults to the git toplevel of the current directory. */\n  projectRoot?: string;\n}\n\nexport interface UserStoryNumberingResult extends UserStoryNumberingOutcome {\n  /** `decision.nextNumber` formatted as `US-NNN`, ready for the prompt. */\n  nextUserStoryId: string;\n}\n\n/**\n * The entry point commands use: resolve the cascade and persist the decision\n * into `metadata.json` in one call, so no call site can log/prompt with one\n * decision and audit a different one.\n */\nexport async function determineUserStoryNumbering(\n  options: DetermineUserStoryNumberingOptions,\n): Promise<UserStoryNumberingResult> {\n  const { projectRoot: projectRootOption, ...rest } = options;\n  const projectRoot = projectRootOption ?? (await getProjectRoot());\n\n  const outcome = await resolveUserStoryNumbering({ ...rest, projectRoot });\n  await recordUserStoryNumbering(projectRoot, outcome.decision, {\n    env: options.env,\n    now: options.now,\n  });\n\n  return { ...outcome, nextUserStoryId: formatUserStoryId(outcome.decision.nextNumber) };\n}\n"],"mappings":"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","names":["readFile","decision","readFile"]}

package/dist/{chunk-36ECROTC.js → chunk-UH4KAJBJ.js}

@@ -2,34 +2,34 @@
 import {
   readFileWithGrace,
   runPhaseWithRetry
-} from "./chunk-RQW5W4XC.js";
+} from "./chunk-UUY4PCWW.js";
 import {
   issuePlaceholders,
   resolveCommandIssue
-} from "./chunk-HSGTZ3CT.js";
+} from "./chunk-S67Q4I2O.js";
 import {
   isTransientFailure
 } from "./chunk-HDV3YDTG.js";
 import {
   runHeadless
-} from "./chunk-JWZKV3CL.js";
+} from "./chunk-MXTGCD5C.js";
 import {
   publishPhaseMetrics
-} from "./chunk-QO2MWMAZ.js";
+} from "./chunk-PPLIXZI5.js";
 import {
   applyPlaceholders,
   loadPrompt
 } from "./chunk-SLHZPB3C.js";
 import {
   resolveIssuePaths
-} from "./chunk-BASRRXAM.js";
+} from "./chunk-VYFKOUUR.js";
 import {
   getGlobalTimeout,
   loadTaskPlan,
   printError,
   printSuccess,
   saveTaskPlan
-} from "./chunk-BH7DYADV.js";
+} from "./chunk-V5OHFSW4.js";
 
 // src/commands/prd.ts
 import { mkdir } from "fs/promises";
@@ -103,4 +103,4 @@ async function runPrd(issue, resolvedIssue) {
 export {
   runPrd
 };
-//# sourceMappingURL=chunk-36ECROTC.js.map
+//# sourceMappingURL=chunk-UH4KAJBJ.js.map

package/dist/{chunk-RQW5W4XC.js → chunk-UUY4PCWW.js}

@@ -7,7 +7,7 @@ import {
   getSessionPublisher,
   isoNow,
   printRetry
-} from "./chunk-BH7DYADV.js";
+} from "./chunk-V5OHFSW4.js";
 
 // src/core/phase-runner.ts
 import { readFile } from "fs/promises";
@@ -55,4 +55,4 @@ export {
   runPhaseWithRetry,
   readFileWithGrace
 };
-//# sourceMappingURL=chunk-RQW5W4XC.js.map
+//# sourceMappingURL=chunk-UUY4PCWW.js.map