@icode-js/icode 3.0.2

package/src/commands/migrate.js

@@ -0,0 +1,86 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { IcodeError } from '../core/errors.js'
+import { logger } from '../core/logger.js'
+import { runMigrateWorkflow } from '../workflows/migrate-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode migrate <sourceBranch> <targetBranch> [options]
+  icode migrate --interactive
+
+Arguments:
+  <sourceBranch>         迁移来源分支（交互模式可省略）
+  <targetBranch>         迁移目标分支（交互模式可省略）
+
+Options:
+  -i, --interactive      交互模式（单选/多选 source/target 与迁移范围）
+  --range <spec>         指定提交范围，例如 main..feature-x（交互模式下若提供则直接使用）
+  --push                 迁移后自动推送 target 分支
+  -y, --yes              自动确认（跳过确认提示）
+  --repo-mode <mode>     仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify            推送时跳过 hook/husky 校验
+  -h, --help             查看帮助
+
+Notes:
+  默认迁移 target..source 的增量提交。
+
+Examples:
+  icode migrate feature/login release
+  icode migrate --interactive
+  icode migrate feature/login release --range HEAD~3..feature/login
+  icode migrate feature/login release --push -y
+`)
+}
+
+export async function runMigrateCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+  const parsed = parseArgs({
+    args,
+    allowPositionals: true,
+    options: {
+      interactive: { type: 'boolean', short: 'i', default: false },
+      range: { type: 'string' },
+      push: { type: 'boolean', default: false },
+      yes: { type: 'boolean', short: 'y', default: false },
+      'repo-mode': { type: 'string', default: 'auto' },
+      'no-verify': { type: 'boolean', default: false },
+      help: { type: 'boolean', short: 'h', default: false }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  if (parsed.positionals.length > 2) {
+    throw new IcodeError('参数过多: icode migrate 最多接收两个分支参数', {
+      code: 'MIGRATE_ARGS_TOO_MANY',
+      exitCode: 2
+    })
+  }
+
+  const [sourceBranch = '', targetBranch = ''] = parsed.positionals
+  const interactive = parsed.values.interactive || parsed.positionals.length < 2
+
+  const result = await runMigrateWorkflow({
+    sourceBranch,
+    targetBranch,
+    interactive,
+    range: parsed.values.range,
+    push: parsed.values.push,
+    yes: parsed.values.yes,
+    repoMode: parsed.values['repo-mode'],
+    noVerify: parsed.values['no-verify']
+  })
+
+  if (result.canceled) {
+    return
+  }
+
+  logger.success(
+    `migrate 完成: ${result.sourceBranch} -> ${result.targetBranch}, commits=${result.migratedCommits}, mode=${result.rangeMode || 'range'}`
+  )
+}

package/src/commands/push.js

@@ -0,0 +1,125 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { getAiCommandOptions } from '../core/ai-config.js'
+import { logger } from '../core/logger.js'
+import { runPushWorkflow } from '../workflows/push-workflow.js'
+
+function formatBranchStatus(status) {
+  const map = {
+    pushed: '已推送',
+    'merged-and-pushed': '已合并并推送',
+    'skipped-protected': '已跳过(受保护)',
+    'skipped-missing-remote': '已跳过(远程分支不存在)'
+  }
+
+  return map[status] || status
+}
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode push [targetBranch...] [options]
+
+Arguments:
+  [targetBranch...]      目标分支列表（可多个，空则默认当前分支）
+
+Options:
+  -m, --message <msg>         提交信息（未填会提示输入）
+  -y, --yes                   自动确认（跳过确认提示）
+  --local-merge               使用本地 merge 模式（默认，会切换分支并生成 merge commit）
+  --ai-commit                 push 前自动执行 AI commit（会参考本地 hook/commitlint 规范）
+  --ai-profile <name>         指定 AI profile（用于 --ai-commit）
+  --pull-main                 提交前将主分支同步到当前分支
+  --not-push-current          不推送当前分支，只处理目标分支
+  --force-protected           强制处理配置里的受保护分支
+  --repo-mode <mode>          仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify                 跳过 hook/husky 校验
+  -h, --help                  查看帮助
+
+Notes:
+  默认使用本地 merge 模式。
+  未指定 target 时默认处理当前分支。
+  布尔开关仅在命令行显式传入时生效（如 --ai-commit / --pull-main / --no-verify / -y）。
+`)
+}
+
+function resolveBooleanOption(cliValue, fallback = false) {
+  if (typeof cliValue === 'boolean') {
+    return cliValue
+  }
+  if (typeof cliValue === 'string') {
+    const normalized = cliValue.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
+}
+
+export function resolvePushWorkflowOptions(parsedValues, parsedPositionals, scopedOptions = {}) {
+  return {
+    targetBranches: parsedPositionals,
+    message: parsedValues.message,
+    // 显式传入开关才生效，避免配置项隐式开启 push 行为。
+    yes: resolveBooleanOption(parsedValues.yes, false),
+    aiCommit: resolveBooleanOption(parsedValues['ai-commit'], false),
+    aiCommitLang: resolveStringOption(undefined, scopedOptions.aiCommitLang, 'zh'),
+    aiProfile: resolveStringOption(parsedValues['ai-profile'], scopedOptions.aiProfile, ''),
+    pullMain: resolveBooleanOption(parsedValues['pull-main'], false),
+    notPushCurrent: resolveBooleanOption(parsedValues['not-push-current'], false),
+    forceProtected: resolveBooleanOption(parsedValues['force-protected'], false),
+    repoMode: resolveStringOption(parsedValues['repo-mode'], undefined, 'auto'),
+    noVerify: resolveBooleanOption(parsedValues['no-verify'], false)
+  }
+}
+
+export async function runPushCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+  const scopedOptions = getAiCommandOptions('push')
+  const parsed = parseArgs({
+    args,
+    allowPositionals: true,
+    options: {
+      message: { type: 'string', short: 'm' },
+      yes: { type: 'boolean', short: 'y' },
+      'local-merge': { type: 'boolean' },
+      'ai-commit': { type: 'boolean' },
+      'ai-profile': { type: 'string' },
+      help: { type: 'boolean', short: 'h' },
+      'pull-main': { type: 'boolean' },
+      'not-push-current': { type: 'boolean' },
+      'force-protected': { type: 'boolean' },
+      'repo-mode': { type: 'string' },
+      'no-verify': { type: 'boolean' }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runPushWorkflow(resolvePushWorkflowOptions(parsed.values, parsed.positionals, scopedOptions))
+
+  if (result.canceled) {
+    return
+  }
+
+  result.summary.forEach((item) => {
+    logger.info(`[结果] ${item.branch}: ${formatBranchStatus(item.status)}`)
+  })
+  logger.success(`push 完成，共处理 ${result.summary.length} 个分支。`)
+}

package/src/commands/sync.js

@@ -0,0 +1,74 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { logger } from '../core/logger.js'
+import { runSyncWorkflow } from '../workflows/sync-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode sync [branch...] [options]
+
+Arguments:
+  [branch...]             需要同步的分支列表（可多个）
+
+Options:
+  --all-local             自动同步全部本地分支
+  --merge-main            同步后把主分支 merge 到目标分支
+  --rebase                pull 时使用 rebase
+  --push                  同步后自动 push
+  -y, --yes               自动确认（跳过确认提示）
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify             push 时跳过 hook/husky 校验
+  -h, --help              查看帮助
+
+Notes:
+  未传分支时默认同步当前分支与主分支。
+
+Examples:
+  icode sync
+  icode sync --all-local
+  icode sync develop test --merge-main
+  icode sync release --push -y
+`)
+}
+
+export async function runSyncCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+  const parsed = parseArgs({
+    args,
+    allowPositionals: true,
+    options: {
+      'all-local': { type: 'boolean', default: false },
+      'merge-main': { type: 'boolean', default: false },
+      rebase: { type: 'boolean', default: false },
+      push: { type: 'boolean', default: false },
+      yes: { type: 'boolean', short: 'y', default: false },
+      'repo-mode': { type: 'string', default: 'auto' },
+      'no-verify': { type: 'boolean', default: false },
+      help: { type: 'boolean', short: 'h', default: false }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runSyncWorkflow({
+    branches: parsed.positionals,
+    allLocal: parsed.values['all-local'],
+    mergeMain: parsed.values['merge-main'],
+    rebase: parsed.values.rebase,
+    push: parsed.values.push,
+    yes: parsed.values.yes,
+    repoMode: parsed.values['repo-mode'],
+    noVerify: parsed.values['no-verify']
+  })
+
+  if (result.canceled) {
+    return
+  }
+
+  const summaryText = result.summary.map((item) => `${item.branch}:${item.status}`).join(', ')
+  logger.success(`sync 完成: ${summaryText}`)
+}

package/src/commands/tag.js

@@ -0,0 +1,53 @@
+import { parseArgs } from 'node:util'
+import { normalizeLegacyArgs } from '../core/args.js'
+import { logger } from '../core/logger.js'
+import { runTagWorkflow } from '../workflows/tag-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode tag [options]
+
+Options:
+  -n, --name <tag>         指定 tag 名（默认 vYYYYMMDD_NN）
+  -m, --message <msg>      tag 备注
+  --from <ref>             从指定分支/commit 创建 tag
+  --repo-mode <mode>       仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  --no-verify              跳过 hook/husky 校验
+  -h, --help               查看帮助
+
+Notes:
+  默认 tag 规则: vYYYYMMDD_NN（例如 v20260309_01）。
+`)
+}
+
+export async function runTagCommand(rawArgs) {
+  const args = normalizeLegacyArgs(rawArgs)
+  const parsed = parseArgs({
+    args,
+    allowPositionals: true,
+    options: {
+      name: { type: 'string', short: 'n' },
+      message: { type: 'string', short: 'm' },
+      from: { type: 'string' },
+      'repo-mode': { type: 'string', default: 'auto' },
+      'no-verify': { type: 'boolean', default: false },
+      help: { type: 'boolean', short: 'h', default: false }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runTagWorkflow({
+    tagName: parsed.values.name,
+    message: parsed.values.message,
+    fromRef: parsed.values.from,
+    repoMode: parsed.values['repo-mode'],
+    noVerify: parsed.values['no-verify']
+  })
+
+  logger.success(`tag 完成: ${result.tagName}`)
+}

package/src/commands/undo.js

@@ -0,0 +1,66 @@
+import { parseArgs } from 'node:util'
+import { logger } from '../core/logger.js'
+import { runUndoWorkflow } from '../workflows/undo-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode undo [options]
+
+Options:
+  --mode <mode>          回滚模式: revert | soft | mixed | hard
+  --ref <ref>            回滚目标，默认按 mode 自动给出
+  --recover <action>     冲突恢复策略: continue | abort | keep
+  -y, --yes              自动确认（跳过确认提示）
+  --repo-mode <mode>     仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  -h, --help             查看帮助
+
+Notes:
+  revert 模式会生成新提交；reset 模式会移动 HEAD。
+
+Examples:
+  icode undo
+  icode undo --mode revert --ref HEAD~2
+  icode undo --recover abort
+  icode undo --mode hard --ref HEAD~1 -y
+`)
+}
+
+export async function runUndoCommand(rawArgs) {
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      mode: { type: 'string' },
+      ref: { type: 'string' },
+      recover: { type: 'string' },
+      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 runUndoWorkflow({
+    mode: parsed.values.mode,
+    ref: parsed.values.ref,
+    recover: parsed.values.recover,
+    yes: parsed.values.yes,
+    repoMode: parsed.values['repo-mode']
+  })
+
+  if (result.canceled) {
+    return
+  }
+
+  if (result.resolvedOperation) {
+    logger.success(`undo 已处理未完成操作: ${result.resolvedOperation} -> ${result.recoverAction}`)
+    return
+  }
+
+  logger.success(`undo 完成: mode=${result.mode}, ref=${result.ref}`)
+}