issue-flow 0.11.1 → 0.13.0

package/dist/chunk-RKTEV6EG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/init.ts"],"sourcesContent":["import { execa } from 'execa';\nimport type { IssueSource } from '../issues/types.js';\nimport type { ScaffoldActionKind, ScaffoldPlan } from '../scaffold/plan.js';\nimport { printError, printInfo, printSuccess, printWarning } from '../ui/logger.js';\n\n/** Stable identifier of a check, used to decide whether it blocks. */\ntype CheckKey = 'claude' | 'gh' | 'git';\n\ninterface CheckResult {\n  key: CheckKey;\n  name: string;\n  passed: boolean;\n  detail: string;\n  hint?: string;\n}\n\nasync function checkClaude(): Promise<CheckResult> {\n  try {\n    const proc = await execa('claude', ['--version'], { reject: false, timeout: 10_000 });\n    if (proc.exitCode === 0) {\n      const version = proc.stdout?.toString().trim() ?? 'unknown';\n      return { key: 'claude', name: 'claude CLI', passed: true, detail: version };\n    }\n    return {\n      key: 'claude',\n      name: 'claude CLI',\n      passed: false,\n      detail: 'claude command failed',\n      hint: 'Install Claude Code: https://docs.anthropic.com/en/docs/claude-code',\n    };\n  } catch {\n    return {\n      key: 'claude',\n      name: 'claude CLI',\n      passed: false,\n      detail: 'claude not found',\n      hint: 'Install Claude Code: https://docs.anthropic.com/en/docs/claude-code',\n    };\n  }\n}\n\nasync function checkGh(): Promise<CheckResult> {\n  try {\n    const proc = await execa('gh', ['--version'], { reject: false, timeout: 10_000 });\n    if (proc.exitCode !== 0) {\n      return {\n        key: 'gh',\n        name: 'gh CLI',\n        passed: false,\n        detail: 'gh command failed',\n        hint: 'Install GitHub CLI: https://cli.github.com/',\n      };\n    }\n    const version = proc.stdout?.toString().split('\\n')[0]?.trim() ?? 'unknown';\n\n    // Check auth status\n    const auth = await execa('gh', ['auth', 'status'], { reject: false, timeout: 10_000 });\n    if (auth.exitCode !== 0) {\n      return {\n        key: 'gh',\n        name: 'gh CLI',\n        passed: false,\n        detail: `${version} (not authenticated)`,\n        hint: 'Run: gh auth login',\n      };\n    }\n    return { key: 'gh', name: 'gh CLI', passed: true, detail: `${version} (authenticated)` };\n  } catch {\n    return {\n      key: 'gh',\n      name: 'gh CLI',\n      passed: false,\n      detail: 'gh not found',\n      hint: 'Install GitHub CLI: https://cli.github.com/',\n    };\n  }\n}\n\nasync function checkGit(): Promise<CheckResult> {\n  try {\n    const proc = await execa('git', ['--version'], { reject: false, timeout: 10_000 });\n    if (proc.exitCode !== 0) {\n      return {\n        key: 'git',\n        name: 'git',\n        passed: false,\n        detail: 'git command failed',\n        hint: 'Install git: https://git-scm.com/',\n      };\n    }\n    const version = proc.stdout?.toString().trim() ?? 'unknown';\n\n    // Check if current directory is a git repo\n    const repo = await execa('git', ['rev-parse', '--is-inside-work-tree'], {\n      reject: false,\n      timeout: 5_000,\n    });\n    if (repo.exitCode !== 0) {\n      return {\n        key: 'git',\n        name: 'git',\n        passed: false,\n        detail: `${version} (not a git repository)`,\n        hint: 'Run this command inside a git repository',\n      };\n    }\n    return { key: 'git', name: 'git', passed: true, detail: `${version} (inside repo)` };\n  } catch {\n    return {\n      key: 'git',\n      name: 'git',\n      passed: false,\n      detail: 'git not found',\n      hint: 'Install git: https://git-scm.com/',\n    };\n  }\n}\n\nexport interface InitOptions {\n  /** Write the missing files instead of only reporting them. */\n  apply?: boolean;\n  /** Emit the plan as JSON — the bridge the initialization skill reads. */\n  json?: boolean;\n  /** Subdirectory the conventions apply to, in a monorepo. */\n  scope?: string;\n  /** Skip the convention report entirely and only check prerequisites. */\n  checkOnly?: boolean;\n}\n\nconst ACTION_ICON: Record<ScaffoldActionKind, string> = {\n  create: '+',\n  keep: '=',\n  review: '!',\n};\n\n/**\n * Render the plan for a human.\n *\n * `keep` lines are printed, not hidden: the most valuable thing this report\n * says is usually *what it is not going to touch*, and a list of only the\n * missing files would read as if the repository had nothing.\n */\nfunction renderPlan(plan: ScaffoldPlan, apply: boolean): void {\n  const creates = plan.actions.filter((a) => a.kind === 'create');\n  const reviews = plan.actions.filter((a) => a.kind === 'review');\n\n  console.log('');\n  printInfo(`Repository conventions (${plan.root})\\n`);\n\n  for (const item of plan.actions) {\n    console.log(`  ${ACTION_ICON[item.kind]} ${item.path}`);\n    console.log(`      ${item.reason}`);\n  }\n\n  if (plan.notes.length > 0) {\n    console.log('');\n    for (const note of plan.notes) {\n      printWarning(note);\n    }\n  }\n\n  console.log('');\n  if (creates.length === 0 && reviews.length === 0) {\n    printSuccess('This repository already declares everything Issue Flow would add.');\n    return;\n  }\n  if (creates.length === 0) {\n    printSuccess('Nothing to create.');\n    return;\n  }\n  if (!apply) {\n    printInfo(`${creates.length} file(s) would be created. Re-run with --apply to write them.`);\n  }\n}\n\n/**\n * Verify the prerequisites of the pipeline and report the repository's\n * conventions.\n *\n * `source` is the Issue origin the run is headed for. `gh` only blocks when\n * that origin is GitHub: no other origin shells out to it, so a missing or\n * unauthenticated gh is reported as a warning instead of failing the\n * environment. `claude` and `git` stay blocking for every origin, and the\n * default ('github') keeps the previous behaviour byte for byte.\n *\n * The convention report is additive: the prerequisite checks run first and still\n * decide the exit code, so an existing script calling `issue-flow init` sees the\n * same pass/fail it always did. Nothing is written without `--apply`.\n */\nexport async function runInit(\n  source: IssueSource = 'github',\n  options: InitOptions = {},\n): Promise<number> {\n  const json = options.json === true;\n\n  if (!json) {\n    printInfo('Checking prerequisites...\\n');\n  }\n\n  const results = await Promise.all([checkClaude(), checkGh(), checkGit()]);\n  const isBlocking = (r: CheckResult): boolean => r.key !== 'gh' || source === 'github';\n\n  if (!json) {\n    for (const r of results) {\n      if (r.passed) {\n        printSuccess(`${r.name}: ${r.detail}`);\n      } else if (isBlocking(r)) {\n        printError(`${r.name}: ${r.detail}`);\n        if (r.hint) {\n          console.log(`    ${r.hint}`);\n        }\n      } else {\n        printWarning(`${r.name}: ${r.detail} (not required for ${source} issues)`);\n      }\n    }\n  }\n\n  const allPassed = results.filter(isBlocking).every((r) => r.passed);\n\n  if (!json) {\n    console.log('');\n    if (allPassed) {\n      printSuccess('All prerequisites met. Ready to run the pipeline.');\n    } else {\n      printError('Some prerequisites are missing. Please fix the issues above.');\n    }\n  }\n\n  if (options.checkOnly === true) {\n    return allPassed ? 0 : 1;\n  }\n\n  // The conventions half. It never changes the exit code: a repository missing\n  // a template is not a broken environment, and failing here would break every\n  // script that treats `init` as a prerequisite gate.\n  let plan: ScaffoldPlan;\n  try {\n    const { planRepositoryScaffold } = await import('../scaffold/apply.js');\n    plan = await planRepositoryScaffold({ scope: options.scope ?? null });\n  } catch (err) {\n    if (json) {\n      console.log(\n        JSON.stringify(\n          { schemaVersion: 1, error: err instanceof Error ? err.message : String(err) },\n          null,\n          2,\n        ),\n      );\n      return allPassed ? 0 : 1;\n    }\n    printWarning(\n      `Could not inspect the repository conventions: ${err instanceof Error ? err.message : String(err)}`,\n    );\n    return allPassed ? 0 : 1;\n  }\n\n  let applied: { written: string[]; skipped: string[] } | null = null;\n  if (options.apply === true) {\n    const { applyScaffoldPlan } = await import('../scaffold/apply.js');\n    applied = await applyScaffoldPlan(plan);\n  }\n\n  if (json) {\n    console.log(\n      JSON.stringify(\n        {\n          schemaVersion: 1,\n          prerequisites: results.map((r) => ({\n            key: r.key,\n            passed: r.passed,\n            detail: r.detail,\n            blocking: isBlocking(r),\n          })),\n          root: plan.root,\n          // Content is omitted: a skill decides from the actions, and the bodies\n          // would make the payload unreadable for no gain.\n          actions: plan.actions.map(({ path, kind, tier, reason }) => ({\n            path,\n            kind,\n            tier,\n            reason,\n          })),\n          notes: plan.notes,\n          applied,\n        },\n        null,\n        2,\n      ),\n    );\n    return allPassed ? 0 : 1;\n  }\n\n  renderPlan(plan, options.apply === true);\n\n  if (applied !== null) {\n    console.log('');\n    for (const path of applied.written) {\n      printSuccess(`Created ${path}`);\n    }\n    for (const path of applied.skipped) {\n      printWarning(`Skipped ${path}: it already exists.`);\n    }\n    if (applied.written.length === 0) {\n      printInfo('Nothing was written — the repository already had everything.');\n    }\n  }\n\n  return allPassed ? 0 : 1;\n}\n"],"mappings":"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","names":[]}