@icode-js/icode 3.0.2

package/src/core/shell.js

@@ -0,0 +1,77 @@
+import { spawn } from 'node:child_process'
+import { IcodeError } from './errors.js'
+
+function stringifyCommand(command, args) {
+  return [command, ...args].join(' ')
+}
+
+function formatFailureMessage(command, args, result) {
+  const baseMessage = `命令执行失败(${result.exitCode}): ${stringifyCommand(command, args)}`
+  const detailLines = [result.stderr, result.stdout].map((item) => item.trim()).filter(Boolean)
+
+  if (!detailLines.length) {
+    return baseMessage
+  }
+
+  return `${baseMessage}\n${detailLines.join('\n')}`
+}
+
+export async function runCommand(command, args = [], options = {}) {
+  const { cwd = process.cwd(), env = process.env, allowFailure = false } = options
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      cwd,
+      env,
+      stdio: ['ignore', 'pipe', 'pipe']
+    })
+
+    let stdout = ''
+    let stderr = ''
+
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk.toString()
+    })
+
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString()
+    })
+
+    child.on('error', (error) => {
+      reject(
+        new IcodeError(`执行命令失败: ${stringifyCommand(command, args)}`, {
+          cause: error,
+          code: 'COMMAND_SPAWN_ERROR',
+          meta: {
+            command,
+            args,
+            cwd
+          }
+        })
+      )
+    })
+
+    child.on('close', (exitCode) => {
+      const result = {
+        command,
+        args,
+        cwd,
+        exitCode,
+        stdout,
+        stderr
+      }
+
+      if (exitCode === 0 || allowFailure) {
+        resolve(result)
+        return
+      }
+
+      reject(
+        new IcodeError(formatFailureMessage(command, args, result), {
+          code: 'COMMAND_EXEC_ERROR',
+          meta: result
+        })
+      )
+    })
+  })
+}

package/src/workflows/ai-codereview-workflow.js

@@ -0,0 +1,126 @@
+import { askAi } from '../core/ai-client.js'
+import { resolveAiDiffRange } from '../core/ai-diff-range.js'
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { GitService } from '../core/git-service.js'
+
+function truncate(value, limit) {
+  const text = value || ''
+  if (text.length <= limit) {
+    return text
+  }
+  return `${text.slice(0, limit)}\n\n...<truncated>`
+}
+
+function joinSections(sections) {
+  return sections
+    .map((item) => (item || '').trim())
+    .filter(Boolean)
+    .join('\n\n')
+}
+
+export async function runAiCodeReviewWorkflow(options) {
+  const context = await resolveGitContext({
+    cwd: options.cwd,
+    repoMode: options.repoMode
+  })
+  const git = new GitService(context)
+
+  const explicitBase = Boolean((options.baseRef || '').trim())
+  const explicitHead = Boolean((options.headRef || '').trim())
+  const useRangeMode = explicitBase || explicitHead
+  const headRef = options.headRef || 'HEAD'
+
+  let rangeSpec = ''
+  let diff = ''
+  let stat = ''
+  let nameStatus = ''
+  let diffSource = 'three-dot-range'
+  let rangeError = null
+
+  if (useRangeMode) {
+    try {
+      const rangeResult = await resolveAiDiffRange({
+        git,
+        context,
+        baseRef: options.baseRef,
+        headRef,
+        explicitHead,
+        label: 'Code Review'
+      })
+      rangeSpec = rangeResult.rangeSpec
+      diff = rangeResult.diff
+    } catch (error) {
+      rangeError = error
+    }
+  }
+
+  if (diff.trim()) {
+    stat = await git.diffStat(rangeSpec)
+    nameStatus = await git.diffNameStatus(rangeSpec)
+  } else {
+    if (rangeError && useRangeMode) {
+      throw rangeError
+    }
+
+    // 默认回退策略: 当范围 diff 为空时，自动审查“未提交代码（暂存 + 工作区）”。
+    const stagedDiff = await git.diffStaged()
+    const workingDiff = await git.diffWorkingTree()
+
+    if (rangeError && !stagedDiff.trim() && !workingDiff.trim()) {
+      throw rangeError
+    }
+
+    if (!stagedDiff.trim() && !workingDiff.trim()) {
+      if (!useRangeMode) {
+        throw new IcodeError('暂存区/工作区没有代码改动。若要评审分支差异，请显式传入 --base 或 --head。', {
+          code: 'AI_CODEREVIEW_EMPTY_DIFF',
+          exitCode: 2
+        })
+      }
+
+      throw new IcodeError(`范围 ${rangeSpec} 内没有代码差异，且暂存区/工作区也没有改动。`, {
+        code: 'AI_CODEREVIEW_EMPTY_DIFF',
+        exitCode: 2
+      })
+    }
+
+    diffSource = 'uncommitted'
+    rangeSpec = 'uncommitted(staged+working-tree)'
+    diff = joinSections([
+      stagedDiff ? `--- STAGED DIFF ---\n${stagedDiff}` : '',
+      workingDiff ? `--- WORKING TREE DIFF ---\n${workingDiff}` : ''
+    ])
+    stat = joinSections([
+      stagedDiff ? `--- STAGED STAT ---\n${await git.diffStagedStat()}` : '',
+      workingDiff ? `--- WORKING TREE STAT ---\n${await git.diffStat()}` : ''
+    ])
+    nameStatus = joinSections([
+      stagedDiff ? `--- STAGED NAME STATUS ---\n${await git.diffStagedNameStatus()}` : '',
+      workingDiff ? `--- WORKING TREE NAME STATUS ---\n${await git.diffNameStatus()}` : ''
+    ])
+  }
+
+  const review = await askAi(
+    {
+      systemPrompt: '你是严格的软件代码审查工程师，请优先关注 bug、安全风险、行为回归、缺失测试。输出中文 Markdown。',
+      userPrompt: `请按如下结构输出：\n1. Findings（按严重度从高到低）\n2. Open Questions\n3. Summary\n\nFocus: ${options.focus || 'general'}\nRange: ${rangeSpec}\nDiff Source: ${diffSource}\n\nDiff Stat:\n${truncate(stat, 3000)}\n\nName Status:\n${truncate(nameStatus, 3000)}\n\nUnified Diff:\n${truncate(diff, 18000)}`
+    },
+    {
+      profile: options.profile,
+      dumpResponse: options.dumpResponse
+    }
+  )
+
+  if (!review || !review.trim()) {
+    throw new IcodeError('AI Code Review 返回为空，请检查 AI profile/model 是否可用后重试。', {
+      code: 'AI_CODEREVIEW_EMPTY_RESPONSE',
+      exitCode: 2
+    })
+  }
+
+  return {
+    rangeSpec,
+    review
+  }
+}

package/src/workflows/ai-commit-workflow.js

@@ -0,0 +1,128 @@
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { GitService } from '../core/git-service.js'
+import { logger } from '../core/logger.js'
+import { askAiJson } from '../core/ai-client.js'
+import { scanCommitConventions } from '../core/commit-conventions.js'
+import { confirm } from '../core/prompts.js'
+
+function normalizeCommitType(value) {
+  const allowed = new Set(['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'chore', 'build', 'ci', 'revert'])
+  const normalized = (value || '').trim().toLowerCase()
+  return allowed.has(normalized) ? normalized : 'chore'
+}
+
+function buildCommitMessage(parsed) {
+  const type = normalizeCommitType(parsed.type)
+  const scope = (parsed.scope || '').trim()
+  const subject = (parsed.subject || '').trim().replace(/\n/g, ' ')
+
+  if (!subject) {
+    throw new IcodeError('AI 未返回有效的提交标题(subject)。', {
+      code: 'AI_COMMIT_SUBJECT_EMPTY',
+      exitCode: 2
+    })
+  }
+
+  const header = scope ? `${type}(${scope}): ${subject}` : `${type}: ${subject}`
+  const body = (parsed.body || '').trim()
+  if (!body) {
+    return header
+  }
+
+  return `${header}\n\n${body}`
+}
+
+export async function runAiCommitWorkflow(options) {
+  const context = await resolveGitContext({
+    cwd: options.cwd,
+    repoMode: options.repoMode
+  })
+  const git = new GitService(context)
+
+  if (!options.silentContextLog) {
+    logger.info(`仓库根目录: ${context.topLevelPath}`)
+  }
+
+  let diff = await git.diffStaged()
+  let diffSource = 'staged'
+
+  if (!diff.trim()) {
+    diff = await git.diffWorkingTree()
+    diffSource = 'working-tree'
+  }
+
+  if (!diff.trim()) {
+    throw new IcodeError('没有可用于生成提交信息的代码改动。', {
+      code: 'AI_COMMIT_EMPTY_DIFF',
+      exitCode: 2
+    })
+  }
+
+  const limitedDiff = diff.length > 12000 ? `${diff.slice(0, 12000)}\n\n...<truncated>` : diff
+  const conventionContext = scanCommitConventions(context)
+  const conventionPrompt = conventionContext.hasConventions
+    ? `Local commit conventions were detected from repository hooks/config files. Follow these local rules first when generating the commit message.\n\n${conventionContext.summary}\n\n`
+    : ''
+
+  const language = (options.lang || 'zh').trim().toLowerCase() === 'en' ? 'English' : 'Chinese'
+
+  if (conventionContext.hasConventions && !options.silentContextLog) {
+    logger.info(`检测到提交规范配置，AI 将优先参考: ${conventionContext.sources.join(', ')}`)
+  }
+
+  const { parsed, text } = await askAiJson(
+    {
+      systemPrompt: `You are a senior software engineer. Generate a concise Conventional Commit message. Output JSON only. Language: ${language}.`,
+      userPrompt: `${conventionPrompt}Based on the following git diff, return JSON with fields:\n{\"type\":\"feat|fix|docs|style|refactor|perf|test|chore|build|ci|revert\",\"scope\":\"optional\",\"subject\":\"required one-line summary\",\"body\":\"optional details\"}\n\nDiff Source: ${diffSource}\n\nDiff:\n${limitedDiff}`
+    },
+    {
+      profile: options.profile
+    }
+  )
+
+  const commitMessage = buildCommitMessage(parsed)
+
+  logger.success(`AI 建议提交信息:\n${commitMessage}`)
+
+  if (!options.apply) {
+    return {
+      applied: false,
+      commitMessage,
+      raw: text
+    }
+  }
+
+  if (!options.yes) {
+    const accepted = await confirm('是否应用该提交信息并执行 commit ?', true)
+    if (!accepted) {
+      return {
+        applied: false,
+        commitMessage,
+        raw: text,
+        canceled: true
+      }
+    }
+  }
+
+  if (diffSource === 'working-tree') {
+    // 从 working-tree 生成信息时，提交前统一暂存，避免 commit 为空。
+    await git.stageAll()
+  }
+
+  await git.commit(commitMessage, {
+    noVerify: options.noVerify
+  })
+
+  const commitId = await git.revParseShort('HEAD')
+  if (commitId) {
+    logger.success(`AI commit 已创建: ${commitId}`)
+  }
+
+  return {
+    applied: true,
+    commitId,
+    commitMessage,
+    raw: text
+  }
+}

package/src/workflows/ai-conflict-workflow.js

@@ -0,0 +1,102 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { askAi } from '../core/ai-client.js'
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { GitService } from '../core/git-service.js'
+import { logger } from '../core/logger.js'
+
+function extractConflictBlocks(content, maxBlocks = 3, maxLines = 80) {
+  const lines = content.split('\n')
+  const blocks = []
+  let index = 0
+
+  while (index < lines.length && blocks.length < maxBlocks) {
+    if (!lines[index].startsWith('<<<<<<<')) {
+      index += 1
+      continue
+    }
+
+    const start = index
+    let end = index
+
+    while (end < lines.length && !lines[end].startsWith('>>>>>>>')) {
+      end += 1
+    }
+
+    if (end < lines.length) {
+      end += 1
+    }
+
+    const segment = lines.slice(start, Math.min(end, start + maxLines)).join('\n')
+    blocks.push(segment)
+    index = end
+  }
+
+  return blocks
+}
+
+export async function runAiConflictWorkflow(options) {
+  const context = await resolveGitContext({
+    cwd: options.cwd,
+    repoMode: options.repoMode
+  })
+  const git = new GitService(context)
+
+  const conflictedFiles = await git.listConflictedFiles()
+  if (!conflictedFiles.length) {
+    throw new IcodeError('当前没有检测到冲突文件。', {
+      code: 'AI_CONFLICT_NONE',
+      exitCode: 2
+    })
+  }
+
+  const snippets = []
+  for (const filePath of conflictedFiles.slice(0, 10)) {
+    const absolutePath = path.resolve(context.topLevelPath, filePath)
+    if (!fs.existsSync(absolutePath)) {
+      continue
+    }
+
+    const content = fs.readFileSync(absolutePath, 'utf8')
+    const blocks = extractConflictBlocks(content)
+    if (!blocks.length) {
+      continue
+    }
+
+    snippets.push({
+      filePath,
+      blocks
+    })
+  }
+
+  if (!snippets.length) {
+    throw new IcodeError('冲突文件中没有检测到可解析的冲突块。', {
+      code: 'AI_CONFLICT_BLOCKS_EMPTY',
+      exitCode: 2
+    })
+  }
+
+  const rawPayload = snippets
+    .map((item) => `FILE: ${item.filePath}\n${item.blocks.map((block, index) => `--- block ${index + 1} ---\n${block}`).join('\n')}`)
+    .join('\n\n')
+
+  const payload = rawPayload.length > 14000 ? `${rawPayload.slice(0, 14000)}\n\n...<truncated>` : rawPayload
+
+  logger.info(`检测到冲突文件: ${conflictedFiles.join(', ')}`)
+
+  const suggestion = await askAi(
+    {
+      systemPrompt: '你是资深代码合并助手。请基于冲突块给出可执行的合并方案。输出中文 Markdown。',
+      userPrompt: `请按以下格式输出:\n1) 每个文件的冲突原因\n2) 推荐保留哪一侧或如何融合\n3) 具体手工修改步骤\n4) 修改后需要执行的 git 命令\n\n冲突内容:\n${payload}`
+    },
+    {
+      profile: options.profile
+    }
+  )
+
+  return {
+    conflictedFiles,
+    suggestion
+  }
+}

package/src/workflows/ai-explain-workflow.js

@@ -0,0 +1,116 @@
+import { askAi } from '../core/ai-client.js'
+import { resolveAiDiffRange } from '../core/ai-diff-range.js'
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { GitService } from '../core/git-service.js'
+
+function truncate(value, limit) {
+  const text = value || ''
+  if (text.length <= limit) {
+    return text
+  }
+  return `${text.slice(0, limit)}\n\n...<truncated>`
+}
+
+function joinSections(sections) {
+  return sections
+    .map((item) => (item || '').trim())
+    .filter(Boolean)
+    .join('\n\n')
+}
+
+export async function runAiExplainWorkflow(options) {
+  const context = await resolveGitContext({
+    cwd: options.cwd,
+    repoMode: options.repoMode
+  })
+  const git = new GitService(context)
+
+  const headRef = options.headRef || 'HEAD'
+  const explicitBase = Boolean((options.baseRef || '').trim())
+  const explicitHead = Boolean((options.headRef || '').trim())
+  const explicitRange = explicitBase || explicitHead
+
+  let rangeSpec = ''
+  let diff = ''
+  let stat = ''
+  let nameStatus = ''
+  let diffSource = 'three-dot-range'
+  let rangeError = null
+
+  try {
+    const rangeResult = await resolveAiDiffRange({
+      git,
+      context,
+      baseRef: options.baseRef,
+      headRef,
+      explicitHead,
+      label: 'Explain'
+    })
+    rangeSpec = rangeResult.rangeSpec
+    diff = rangeResult.diff
+  } catch (error) {
+    rangeError = error
+  }
+
+  if (diff.trim()) {
+    stat = await git.diffStat(rangeSpec)
+    nameStatus = await git.diffNameStatus(rangeSpec)
+  } else {
+    if (rangeError && explicitRange) {
+      throw rangeError
+    }
+
+    const stagedDiff = await git.diffStaged()
+    const workingDiff = await git.diffWorkingTree()
+
+    if (rangeError && !stagedDiff.trim() && !workingDiff.trim()) {
+      throw rangeError
+    }
+
+    if (!stagedDiff.trim() && !workingDiff.trim()) {
+      throw new IcodeError(`范围 ${rangeSpec} 内没有代码差异，且暂存区/工作区也没有改动。`, {
+        code: 'AI_EXPLAIN_EMPTY_DIFF',
+        exitCode: 2
+      })
+    }
+
+    diffSource = 'uncommitted'
+    rangeSpec = 'uncommitted(staged+working-tree)'
+    diff = joinSections([
+      stagedDiff ? `--- STAGED DIFF ---\n${stagedDiff}` : '',
+      workingDiff ? `--- WORKING TREE DIFF ---\n${workingDiff}` : ''
+    ])
+    stat = joinSections([
+      stagedDiff ? `--- STAGED STAT ---\n${await git.diffStagedStat()}` : '',
+      workingDiff ? `--- WORKING TREE STAT ---\n${await git.diffStat()}` : ''
+    ])
+    nameStatus = joinSections([
+      stagedDiff ? `--- STAGED NAME STATUS ---\n${await git.diffStagedNameStatus()}` : '',
+      workingDiff ? `--- WORKING TREE NAME STATUS ---\n${await git.diffNameStatus()}` : ''
+    ])
+  }
+
+  const explanation = await askAi(
+    {
+      systemPrompt: '你是资深软件工程师，擅长把 Git diff 用自然语言讲清楚。',
+      userPrompt: `请用中文自然语言解释以下 Git diff，输出简洁清晰，面向不熟悉代码的同事。\n要求：\n1. 先给整体改动概览\n2. 再按文件或模块说明主要改动\n3. 如有可能影响行为/兼容性/风险点，请指出但不要过度推测\n4. 不要输出 JSON 或代码块，只输出自然语言（可用简短项目符号）\n\nRange: ${rangeSpec}\nDiff Source: ${diffSource}\n\nDiff Stat:\n${truncate(stat, 3000)}\n\nName Status:\n${truncate(nameStatus, 3000)}\n\nUnified Diff:\n${truncate(diff, 18000)}`
+    },
+    {
+      profile: options.profile,
+      dumpResponse: options.dumpResponse
+    }
+  )
+
+  if (!explanation || !explanation.trim()) {
+    throw new IcodeError('AI Explain 返回为空，请检查 AI profile/model 是否可用后重试。', {
+      code: 'AI_EXPLAIN_EMPTY_RESPONSE',
+      exitCode: 2
+    })
+  }
+
+  return {
+    rangeSpec,
+    explanation
+  }
+}

package/src/workflows/ai-risk-review-workflow.js

@@ -0,0 +1,49 @@
+import { askAiJson } from '../core/ai-client.js'
+
+function normalizeDecision(value) {
+  const normalized = (value || '').trim().toLowerCase()
+  if (['allow', 'warn', 'block'].includes(normalized)) {
+    return normalized
+  }
+  return 'warn'
+}
+
+function normalizeRisk(value) {
+  const normalized = (value || '').trim().toLowerCase()
+  if (['low', 'medium', 'high'].includes(normalized)) {
+    return normalized
+  }
+  return 'medium'
+}
+
+function truncate(value, limit) {
+  if (!value || value.length <= limit) {
+    return value
+  }
+
+  return `${value.slice(0, limit)}\n\n...<truncated>`
+}
+
+export async function runAiRiskReviewWorkflow({ git, context, currentBranch, targetBranches, profile }) {
+  const stat = await git.diffStat()
+  const nameStatus = await git.diffNameStatus()
+  const recentLog = await git.logOneline('', 25)
+
+  const { text, parsed } = await askAiJson(
+    {
+      systemPrompt: '你是资深发布风控助手。请根据改动给出 push 风险评估。输出 JSON。',
+      userPrompt: `请仅返回 JSON：\n{\"decision\":\"allow|warn|block\",\"riskLevel\":\"low|medium|high\",\"reasons\":[\"...\"],\"checks\":[\"...\"]}\n\n仓库根目录: ${context.topLevelPath}\n当前分支: ${currentBranch}\n目标分支: ${targetBranches.join(', ')}\n\nDiff Stat:\n${truncate(stat, 2500)}\n\nName Status:\n${truncate(nameStatus, 2500)}\n\nRecent Commits:\n${truncate(recentLog, 2500)}`
+    },
+    {
+      profile
+    }
+  )
+
+  return {
+    raw: text,
+    decision: normalizeDecision(parsed.decision),
+    riskLevel: normalizeRisk(parsed.riskLevel),
+    reasons: Array.isArray(parsed.reasons) ? parsed.reasons : [],
+    checks: Array.isArray(parsed.checks) ? parsed.checks : []
+  }
+}

package/src/workflows/checkout-workflow.js

@@ -0,0 +1,85 @@
+import { IcodeError } from '../core/errors.js'
+import { GitService } from '../core/git-service.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { logger } from '../core/logger.js'
+
+export async function runCheckoutWorkflow(input) {
+  if (!input.branchName) {
+    throw new IcodeError('缺少分支名: icode checkout <branch> [base]', {
+      code: 'CHECKOUT_BRANCH_REQUIRED',
+      exitCode: 2
+    })
+  }
+
+  const context = await resolveGitContext({
+    cwd: input.cwd,
+    repoMode: input.repoMode
+  })
+
+  const git = new GitService(context)
+  const branchName = input.branchName.trim()
+  const baseBranchName = input.baseBranchName?.trim() || context.defaultBranch
+
+  logger.info(`仓库根目录: ${context.topLevelPath}`)
+  if (context.inheritedFromParent) {
+    logger.warn('当前目录继承了父级 Git 仓库，命令将基于父仓库根目录执行。')
+  }
+
+  await git.fetch()
+
+  const localExists = await git.branchExistsLocal(branchName)
+  const remoteExists = await git.branchExistsRemote(branchName)
+
+  if (localExists) {
+    logger.info(`切换本地分支: ${branchName}`)
+    await git.checkout(branchName)
+  } else if (remoteExists) {
+    logger.info(`创建并跟踪远程分支: ${branchName}`)
+    await git.checkoutTracking(branchName)
+  } else {
+    const baseLocalExists = await git.branchExistsLocal(baseBranchName)
+    const baseRemoteExists = await git.branchExistsRemote(baseBranchName)
+
+    if (!baseLocalExists && !baseRemoteExists) {
+      throw new IcodeError(`基线分支不存在: ${baseBranchName}`, {
+        code: 'CHECKOUT_BASE_MISSING',
+        exitCode: 2
+      })
+    }
+
+    const fromRef = baseLocalExists ? baseBranchName : `origin/${baseBranchName}`
+    logger.info(`从 ${fromRef} 新建分支: ${branchName}`)
+    await git.checkoutNewBranch(branchName, fromRef)
+  }
+
+  if (input.pullMain && context.defaultBranch !== branchName) {
+    logger.info(`同步主分支到当前分支: ${context.defaultBranch}`)
+    await git.pull(context.defaultBranch, {
+      allowUnrelatedHistories: true,
+      noRebase: true
+    })
+  }
+
+  if (remoteExists) {
+    logger.info(`拉取远程分支: ${branchName}`)
+    await git.pull(branchName, {
+      allowUnrelatedHistories: true,
+      noRebase: true
+    })
+  }
+
+  if (input.pushOrigin && !remoteExists) {
+    logger.info(`推送新分支到远程: ${branchName}`)
+    await git.push(branchName, {
+      setUpstream: true,
+      noVerify: input.noVerify
+    })
+  }
+
+  return {
+    branchName,
+    baseBranchName,
+    remoteExists,
+    repoRoot: context.topLevelPath
+  }
+}