@icode-js/icode 3.0.2

package/src/commands/ai.js

@@ -0,0 +1,287 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { getAiCommandOptions } from '../core/ai-config.js'
+import { formatAiCommitSummary } from '../core/ai-commit-summary.js'
+import { IcodeError } from '../core/errors.js'
+import { logger } from '../core/logger.js'
+import { runAiCodeReviewWorkflow } from '../workflows/ai-codereview-workflow.js'
+import { runAiCommitWorkflow } from '../workflows/ai-commit-workflow.js'
+import { runAiConflictWorkflow } from '../workflows/ai-conflict-workflow.js'
+import { runAiExplainWorkflow } from '../workflows/ai-explain-workflow.js'
+
+function printMainHelp() {
+  process.stdout.write(`
+Usage:
+  icode ai <subcommand> [options]
+
+Subcommands:
+  commit        AI 生成提交信息（会参考本地 hook/commitlint 规范）
+  conflict      AI 冲突解决建议
+  codereview    AI 代码评审
+  explain       AI 解释 Git diff
+
+Tips:
+  icode ai <subcommand> -h  查看子命令参数说明
+
+Examples:
+  icode ai commit --apply -y
+  icode ai conflict
+  icode ai codereview --base origin/main --head HEAD
+  icode ai explain --base origin/main --head HEAD
+`)
+}
+
+function printCommitHelp() {
+  process.stdout.write(`
+Usage:
+  icode ai commit [options]
+
+Options:
+  --apply                 直接使用 AI 信息执行 commit
+  --lang <zh|en>          输出语言，默认 zh
+  --profile <name>        指定 AI profile
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify             commit 时跳过 hook/husky 校验
+  -y, --yes               自动确认（跳过确认提示）
+  -h, --help              查看帮助
+`)
+}
+
+function printConflictHelp() {
+  process.stdout.write(`
+Usage:
+  icode ai conflict [options]
+
+Options:
+  --profile <name>        指定 AI profile
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  -h, --help              查看帮助
+`)
+}
+
+function printCodeReviewHelp() {
+  process.stdout.write(`
+Usage:
+  icode ai codereview [options]
+
+Options:
+  --base <ref>            指定分支 diff 基线；未传时默认评审暂存区 + 工作区改动
+  --head <ref>            指定分支 diff 终点，默认 HEAD
+  --focus <text>          评审重点（安全/性能/测试等）
+  --profile <name>        指定 AI profile
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --dump-response         输出 AI 原始响应（调试数据格式）
+  -h, --help              查看帮助
+`)
+}
+
+function printExplainHelp() {
+  process.stdout.write(`
+Usage:
+  icode ai explain [options]
+
+Options:
+  --base <ref>            diff 基线，默认 origin/<defaultBranch>；不可用时回退到本地默认分支
+  --head <ref>            diff 终点，默认 HEAD
+  --profile <name>        指定 AI profile
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --dump-response         输出 AI 原始响应（调试数据格式）
+  -h, --help              查看帮助
+`)
+}
+
+function resolveBooleanOption(cliValue, configValue, fallback = false) {
+  if (typeof cliValue === 'boolean') {
+    return cliValue
+  }
+  if (typeof configValue === 'boolean') {
+    return configValue
+  }
+  if (typeof configValue === 'string') {
+    const normalized = configValue.trim().toLowerCase()
+    if (['true', '1', 'yes', 'y', 'on'].includes(normalized)) {
+      return true
+    }
+    if (['false', '0', 'no', 'n', 'off'].includes(normalized)) {
+      return false
+    }
+  }
+  return fallback
+}
+
+function resolveStringOption(cliValue, configValue, fallback = '') {
+  if (typeof cliValue === 'string' && cliValue.trim()) {
+    return cliValue
+  }
+  if (typeof configValue === 'string' && configValue.trim()) {
+    return configValue
+  }
+  return fallback
+}
+
+// Execute `icode ai commit` and surface the full applied commit message in logs.
+async function runCommitSubcommand(rawArgs) {
+  const scopedOptions = getAiCommandOptions('commit')
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      apply: { type: 'boolean' },
+      lang: { type: 'string' },
+      profile: { type: 'string' },
+      'repo-mode': { type: 'string' },
+      'no-verify': { type: 'boolean' },
+      yes: { type: 'boolean', short: 'y' },
+      help: { type: 'boolean', short: 'h' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printCommitHelp()
+    return
+  }
+
+  const result = await runAiCommitWorkflow({
+    apply: resolveBooleanOption(parsed.values.apply, scopedOptions.apply, false),
+    lang: resolveStringOption(parsed.values.lang, scopedOptions.lang, 'zh'),
+    profile: resolveStringOption(parsed.values.profile, scopedOptions.profile, ''),
+    repoMode: resolveStringOption(parsed.values['repo-mode'], scopedOptions.repoMode, 'auto'),
+    noVerify: resolveBooleanOption(parsed.values['no-verify'], scopedOptions.noVerify, false),
+    yes: resolveBooleanOption(parsed.values.yes, scopedOptions.yes, false)
+  })
+
+  if (result.canceled) {
+    return
+  }
+
+  if (result.applied) {
+    logger.success(`AI commit 已应用:\n${formatAiCommitSummary(result.commitId, result.commitMessage)}`)
+  }
+}
+
+async function runConflictSubcommand(rawArgs) {
+  const scopedOptions = getAiCommandOptions('conflict')
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      profile: { type: 'string' },
+      'repo-mode': { type: 'string' },
+      help: { type: 'boolean', short: 'h' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printConflictHelp()
+    return
+  }
+
+  const result = await runAiConflictWorkflow({
+    profile: resolveStringOption(parsed.values.profile, scopedOptions.profile, ''),
+    repoMode: resolveStringOption(parsed.values['repo-mode'], scopedOptions.repoMode, 'auto')
+  })
+
+  logger.info(`冲突文件: ${result.conflictedFiles.join(', ')}`)
+  process.stdout.write(`\n${result.suggestion}\n`)
+}
+
+async function runCodeReviewSubcommand(rawArgs) {
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      base: { type: 'string' },
+      head: { type: 'string' },
+      focus: { type: 'string' },
+      profile: { type: 'string' },
+      'repo-mode': { type: 'string' },
+      'dump-response': { type: 'boolean' },
+      help: { type: 'boolean', short: 'h' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printCodeReviewHelp()
+    return
+  }
+
+  const result = await runAiCodeReviewWorkflow({
+    baseRef: resolveStringOption(parsed.values.base, '', ''),
+    headRef: resolveStringOption(parsed.values.head, '', ''),
+    focus: resolveStringOption(parsed.values.focus, '', ''),
+    profile: resolveStringOption(parsed.values.profile, '', ''),
+    repoMode: resolveStringOption(parsed.values['repo-mode'], '', 'auto'),
+    dumpResponse: resolveBooleanOption(parsed.values['dump-response'], undefined, false)
+  })
+
+  logger.info(`Code Review 范围: ${result.rangeSpec}`)
+  process.stdout.write(`\n${result.review}\n`)
+}
+
+async function runExplainSubcommand(rawArgs) {
+  const scopedOptions = getAiCommandOptions('explain')
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      base: { type: 'string' },
+      head: { type: 'string' },
+      profile: { type: 'string' },
+      'repo-mode': { type: 'string' },
+      'dump-response': { type: 'boolean' },
+      help: { type: 'boolean', short: 'h' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printExplainHelp()
+    return
+  }
+
+  const result = await runAiExplainWorkflow({
+    baseRef: resolveStringOption(parsed.values.base, scopedOptions.base, ''),
+    headRef: resolveStringOption(parsed.values.head, scopedOptions.head, ''),
+    profile: resolveStringOption(parsed.values.profile, scopedOptions.profile, ''),
+    repoMode: resolveStringOption(parsed.values['repo-mode'], scopedOptions.repoMode, 'auto'),
+    dumpResponse: resolveBooleanOption(parsed.values['dump-response'], scopedOptions.dumpResponse, false)
+  })
+
+  logger.info(`Explain 范围: ${result.rangeSpec}`)
+  process.stdout.write(`\n${result.explanation}\n`)
+}
+
+export async function runAiCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+
+  if (!args.length || args[0] === '--help' || args[0] === '-h') {
+    printMainHelp()
+    return
+  }
+
+  const [subcommand, ...subcommandArgs] = args
+
+  if (subcommand === 'commit') {
+    await runCommitSubcommand(subcommandArgs)
+    return
+  }
+
+  if (subcommand === 'conflict') {
+    await runConflictSubcommand(subcommandArgs)
+    return
+  }
+
+  if (subcommand === 'codereview' || subcommand === 'review') {
+    await runCodeReviewSubcommand(subcommandArgs)
+    return
+  }
+
+  if (subcommand === 'explain') {
+    await runExplainSubcommand(subcommandArgs)
+    return
+  }
+
+  throw new IcodeError(`未知 ai 子命令: ${subcommand}`, {
+    code: 'AI_SUBCOMMAND_UNKNOWN',
+    exitCode: 2
+  })
+}

package/src/commands/checkout.js

@@ -0,0 +1,59 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { logger } from '../core/logger.js'
+import { runCheckoutWorkflow } from '../workflows/checkout-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode checkout <branch> [base] [options]
+
+Arguments:
+  <branch>               目标分支名（必填）
+  [base]                 新建分支基线，默认主分支
+
+Options:
+  -y, --yes              自动确认（跳过交互提示）
+  --push-origin          新建分支后立即推送到 origin
+  --pull-main            切换后同步主分支到当前分支
+  --repo-mode <mode>     仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify            跳过 hook/husky 校验
+  -h, --help             查看帮助
+
+Notes:
+  若本地与远程都不存在，会从基线分支创建。
+`)
+}
+
+export async function runCheckoutCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+  const parsed = parseArgs({
+    args,
+    allowPositionals: true,
+    options: {
+      yes: { type: 'boolean', short: 'y', default: false },
+      help: { type: 'boolean', short: 'h', default: false },
+      'push-origin': { type: 'boolean', default: false },
+      'pull-main': { type: 'boolean', default: false },
+      'repo-mode': { type: 'string', default: 'auto' },
+      'no-verify': { type: 'boolean', default: false }
+    }
+  })
+
+  if (parsed.values.help || parsed.positionals.length < 1) {
+    printHelp()
+    return
+  }
+
+  const [branchName, baseBranchName] = parsed.positionals
+  const result = await runCheckoutWorkflow({
+    branchName,
+    baseBranchName,
+    pushOrigin: parsed.values['push-origin'],
+    pullMain: parsed.values['pull-main'],
+    repoMode: parsed.values['repo-mode'],
+    noVerify: parsed.values['no-verify']
+  })
+
+  logger.success(`checkout 完成: ${result.branchName}`)
+}

package/src/commands/clean.js

@@ -0,0 +1,65 @@
+import { parseArgs } from 'node:util'
+import { logger } from '../core/logger.js'
+import { runCleanWorkflow } from '../workflows/clean-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode clean [options]
+
+Options:
+  --merged-target <branch>   基于该分支判断“已合并”状态，默认主分支
+  --keep <branch|csv>        额外保留分支，可重复使用或逗号分隔
+  --remote                   同时删除远程分支
+  --force                    强制删除本地分支（-D）
+  -y, --yes                  自动确认（跳过确认提示）
+  --repo-mode <mode>         仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  -h, --help                 查看帮助
+
+Notes:
+  默认保护当前分支/主分支/受保护分支。
+
+Examples:
+  icode clean
+  icode clean --merged-target main --keep release,hotfix
+  icode clean --remote --force -y
+`)
+}
+
+export async function runCleanCommand(rawArgs) {
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      'merged-target': { type: 'string' },
+      keep: { type: 'string', multiple: true, default: [] },
+      remote: { type: 'boolean', default: false },
+      force: { type: 'boolean', default: false },
+      yes: { type: 'boolean', short: 'y', default: false },
+      'repo-mode': { type: 'string', default: 'auto' },
+      help: { type: 'boolean', short: 'h', default: false }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runCleanWorkflow({
+    mergedTarget: parsed.values['merged-target'],
+    keep: parsed.values.keep,
+    remote: parsed.values.remote,
+    force: parsed.values.force,
+    yes: parsed.values.yes,
+    repoMode: parsed.values['repo-mode']
+  })
+
+  if (result.canceled) {
+    return
+  }
+
+  logger.success(
+    `clean 完成: 本地删除 ${result.deletedLocal.length} 个, 远程删除 ${result.deletedRemote.length} 个`
+  )
+}

package/src/commands/codereview.js

@@ -0,0 +1,52 @@
+import { parseArgs } from 'node:util'
+import { logger } from '../core/logger.js'
+import { runAiCodeReviewWorkflow } from '../workflows/ai-codereview-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode codereview [options]
+
+Options:
+  --base <ref>            指定分支 diff 基线；未传时默认评审暂存区 + 工作区改动
+  --head <ref>            指定分支 diff 终点，默认 HEAD
+  --focus <text>          评审重点（安全/性能/测试等）
+  --profile <name>        指定 AI profile
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --dump-response         输出 AI 原始响应（调试数据格式）
+  -h, --help              查看帮助
+`)
+}
+
+export async function runCodeReviewCommand(rawArgs) {
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      base: { type: 'string' },
+      head: { type: 'string' },
+      focus: { type: 'string' },
+      profile: { type: 'string' },
+      'repo-mode': { type: 'string' },
+      'dump-response': { type: 'boolean' },
+      help: { type: 'boolean', short: 'h' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runAiCodeReviewWorkflow({
+    baseRef: typeof parsed.values.base === 'string' ? parsed.values.base : '',
+    headRef: typeof parsed.values.head === 'string' ? parsed.values.head : '',
+    focus: typeof parsed.values.focus === 'string' ? parsed.values.focus : '',
+    profile: typeof parsed.values.profile === 'string' ? parsed.values.profile : '',
+    repoMode: typeof parsed.values['repo-mode'] === 'string' ? parsed.values['repo-mode'] : 'auto',
+    dumpResponse: parsed.values['dump-response'] === true
+  })
+
+  logger.info(`Code Review 范围: ${result.rangeSpec}`)
+  process.stdout.write(`\n${result.review}\n`)
+}