@icode-js/icode 3.0.2

package/src/commands/config.js

@@ -0,0 +1,513 @@
+import path from 'node:path'
+import { parseArgs } from 'node:util'
+import { askAi } from '../core/ai-client.js'
+import {
+  getAiCommandOptions,
+  getAiProfileForDisplay,
+  listAiCommandOptions,
+  listAiProfiles,
+  removeAiCommandOptions,
+  removeAiProfile,
+  upsertAiCommandOptions,
+  upsertAiProfile,
+  useAiProfile
+} from '../core/ai-config.js'
+import {
+  deleteValue,
+  getConfigFilePath,
+  getRepoPolicy,
+  getValue,
+  readConfig,
+  setRepoPolicy,
+  setValue
+} from '../core/config-store.js'
+import { parseConfigValue } from '../core/args.js'
+import { IcodeError } from '../core/errors.js'
+import { resolveGitContext } from '../core/git-context.js'
+import { logger } from '../core/logger.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode config <command> [...args]
+
+Arguments:
+  <command>                子命令（list/get/set/delete/ai/protect）
+
+Commands:
+  list                    查看全部配置
+  get <path>              读取指定配置项
+  set <path> <value>      写入配置项
+  delete <path>           删除配置项
+  ai <subcommand> [...]   AI profile 配置
+  protect list            查看受保护分支
+  protect add <branch...> 添加受保护分支
+  protect remove <branch...> 移除受保护分支
+
+Options:
+  --repo-mode <mode>      仓库模式: auto(自动继承父仓库) | strict(禁止继承)，仅影响 protect
+  -h, --help              查看帮助
+
+Examples:
+  icode config set defaults.repoMode strict
+  icode config get defaults.repoMode
+  icode config protect add main release
+  icode config ai set openai --format openai --base-url https://api.openai.com/v1 --api-key sk-xxx --model gpt-4o-mini --activate
+  icode config ai set ollama --format ollama --base-url http://127.0.0.1:11434 --model qwen2.5:7b --activate
+`)
+}
+
+function printAiHelp() {
+  process.stdout.write(`
+Usage:
+  icode config ai <subcommand> [options]
+
+Arguments:
+  <subcommand>             子命令（list/show/set/options/use/remove/test）
+
+Subcommands:
+  list                                  查看所有 AI profiles
+  show [profile]                        查看 profile 详情（默认当前激活）
+  set <profile> --format <openai|anthropic|ollama> --base-url <url> --api-key <key> --model <name> [--headers <json>] [--request-body <json>] [--activate]
+                                        创建/更新 profile
+  options <list|show|set|remove> [...]   设置命令默认 options
+  use <profile>                          切换默认 profile
+  remove <profile>                       删除 profile
+  test [profile]                         测试连通性（默认当前激活）
+
+Options (set):
+  --format <openai|anthropic|ollama>     接口格式（必填）
+  --base-url <url>                       API 地址
+  --api-key <key>                        API Key
+  --model <name>                         模型名称
+  --provider <name>                      自定义提供方标识（可选）
+  --temperature <num>                    采样温度（可选）
+  --max-tokens <num>                     最大输出 tokens（可选）
+  --headers <json>                       额外请求头 JSON
+  --request-body <json>                  额外请求体 JSON
+  --activate                             设置为默认 profile
+
+Common options:
+  -h, --help                             查看帮助
+
+Examples:
+  icode config ai list
+  icode config ai show
+  icode config ai set claude --format anthropic --base-url https://api.anthropic.com/v1 --api-key xxx --model claude-3-5-sonnet-20241022 --activate
+  icode config ai set zhipu --format openai --base-url https://open.bigmodel.cn/api/paas/v4 --api-key xxx --model glm-5 --request-body '{"thinking":{"type":"disabled"},"stream":false}' --activate
+  icode config ai options set commit --json '{"profile":"local","lang":"zh","yes":true}'
+  icode config ai options set push --json '{"aiProfile":"local","aiCommitLang":"zh"}'
+  icode config ai set ollama --format ollama --base-url http://127.0.0.1:11434 --model qwen2.5:7b --activate
+  icode config ai use claude
+  icode config ai test claude
+`)
+}
+
+function parseJsonObject(rawValue, fieldLabel = 'headers') {
+  if (!rawValue) {
+    return {}
+  }
+
+  try {
+    const parsed = JSON.parse(rawValue)
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      throw new Error(`${fieldLabel} 必须是 JSON 对象`)
+    }
+    return parsed
+  } catch (error) {
+    throw new IcodeError(`${fieldLabel} 解析失败: ${error.message}`, {
+      code: 'CONFIG_AI_HEADERS_INVALID',
+      exitCode: 2
+    })
+  }
+}
+
+function compactObject(value) {
+  const next = {}
+  Object.entries(value).forEach(([key, item]) => {
+    if (item !== undefined) {
+      next[key] = item
+    }
+  })
+  return next
+}
+
+function parseOptionsJson(rawValue) {
+  if (!rawValue) {
+    throw new IcodeError('缺少 --json 参数，示例: --json \'{"profile":"local"}\'', {
+      code: 'CONFIG_AI_OPTIONS_JSON_REQUIRED',
+      exitCode: 2
+    })
+  }
+
+  return parseJsonObject(rawValue)
+}
+
+function printAiOptionsHelp() {
+  process.stdout.write(`
+Usage:
+  icode config ai options <command> [options]
+
+Arguments:
+  <command>                子命令（list/show/set/remove）
+
+Commands:
+  list                      列出所有 scope 的默认 options
+  show <scope>              查看指定 scope 的默认 options
+  set <scope> --json <json> [--replace]
+                            写入 scope 默认 options
+  remove <scope>            删除 scope 默认 options
+
+Options (set):
+  --json <json>             JSON 对象字符串
+  --replace                 覆盖写入（默认合并）
+
+Common options:
+  -h, --help                查看帮助
+
+Available scope:
+  commit | conflict | explain | push
+
+Examples:
+  icode config ai options list
+  icode config ai options show commit
+  icode config ai options set commit --json '{"profile":"local","lang":"zh","yes":true}'
+  icode config ai options set explain --json '{"profile":"local","base":"origin/main"}'
+  icode config ai options set push --json '{"aiProfile":"local","aiCommitLang":"zh"}'
+  icode config ai options remove push
+`)
+}
+
+async function runAiOptionsCommand(args) {
+  if (!args.length || args[0] === '-h' || args[0] === '--help') {
+    printAiOptionsHelp()
+    return
+  }
+
+  const [action, ...rest] = args
+
+  if (action === 'list') {
+    process.stdout.write(`${JSON.stringify(listAiCommandOptions(), null, 2)}\n`)
+    return
+  }
+
+  if (action === 'show') {
+    const [scopeName] = rest
+    const scopedOptions = getAiCommandOptions(scopeName)
+    process.stdout.write(`${JSON.stringify(scopedOptions, null, 2)}\n`)
+    return
+  }
+
+  if (action === 'set') {
+    const parsed = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      options: {
+        json: { type: 'string' },
+        replace: { type: 'boolean', default: false }
+      }
+    })
+
+    const [scopeName] = parsed.positionals
+    if (!scopeName) {
+      throw new IcodeError('缺少 options 作用域: icode config ai options set <scope> --json ...', {
+        code: 'CONFIG_AI_OPTIONS_SCOPE_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    const next = upsertAiCommandOptions(scopeName, parseOptionsJson(parsed.values.json), {
+      replace: parsed.values.replace
+    })
+
+    logger.success(`AI options 已写入: ${scopeName}`)
+    process.stdout.write(`${JSON.stringify(next, null, 2)}\n`)
+    return
+  }
+
+  if (action === 'remove') {
+    const [scopeName] = rest
+    if (!scopeName) {
+      throw new IcodeError('缺少 options 作用域: icode config ai options remove <scope>', {
+        code: 'CONFIG_AI_OPTIONS_SCOPE_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    removeAiCommandOptions(scopeName)
+    logger.success(`AI options 已删除: ${scopeName}`)
+    return
+  }
+
+  throw new IcodeError(`未知 ai options 子命令: ${action}`, {
+    code: 'CONFIG_AI_OPTIONS_UNKNOWN_SUBCOMMAND',
+    exitCode: 2
+  })
+}
+
+async function runAiConfigCommand(args) {
+  if (!args.length || args[0] === '-h' || args[0] === '--help') {
+    printAiHelp()
+    return
+  }
+
+  const [action, ...rest] = args
+
+  if (action === 'options') {
+    await runAiOptionsCommand(rest)
+    return
+  }
+
+  if (action === 'list') {
+    const profiles = listAiProfiles()
+    if (!profiles.length) {
+      logger.warn('当前没有 AI profile。')
+      return
+    }
+
+    process.stdout.write(`${JSON.stringify(profiles, null, 2)}\n`)
+    return
+  }
+
+  if (action === 'show') {
+    const [profileName] = rest
+    const profile = getAiProfileForDisplay(profileName)
+    process.stdout.write(`${JSON.stringify(profile, null, 2)}\n`)
+    return
+  }
+
+  if (action === 'set') {
+    const parsed = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      options: {
+        provider: { type: 'string' },
+        format: { type: 'string' },
+        'base-url': { type: 'string' },
+        'api-key': { type: 'string' },
+        model: { type: 'string' },
+        temperature: { type: 'string' },
+        'max-tokens': { type: 'string' },
+        headers: { type: 'string' },
+        'request-body': { type: 'string' },
+        activate: { type: 'boolean', default: false }
+      }
+    })
+
+    const [profileName] = parsed.positionals
+    if (!profileName) {
+      throw new IcodeError('缺少 profile 名称: icode config ai set <profile> ...', {
+        code: 'CONFIG_AI_PROFILE_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    const profile = upsertAiProfile(profileName, compactObject({
+      provider: parsed.values.provider,
+      format: parsed.values.format,
+      baseUrl: parsed.values['base-url'],
+      apiKey: parsed.values['api-key'],
+      model: parsed.values.model,
+      temperature: parsed.values.temperature,
+      maxTokens: parsed.values['max-tokens'],
+      headers: parsed.values.headers ? parseJsonObject(parsed.values.headers, 'headers') : undefined,
+      requestBody: parsed.values['request-body'] ? parseJsonObject(parsed.values['request-body'], 'request-body') : undefined
+    }))
+
+    if (parsed.values.activate) {
+      useAiProfile(profileName)
+    }
+
+    logger.success(`AI profile 已写入: ${profile.name}`)
+    return
+  }
+
+  if (action === 'use') {
+    const [profileName] = rest
+    if (!profileName) {
+      throw new IcodeError('缺少 profile 名称: icode config ai use <profile>', {
+        code: 'CONFIG_AI_PROFILE_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    useAiProfile(profileName)
+    logger.success(`已切换 AI profile: ${profileName}`)
+    return
+  }
+
+  if (action === 'remove') {
+    const [profileName] = rest
+    if (!profileName) {
+      throw new IcodeError('缺少 profile 名称: icode config ai remove <profile>', {
+        code: 'CONFIG_AI_PROFILE_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    removeAiProfile(profileName)
+    logger.success(`已删除 AI profile: ${profileName}`)
+    return
+  }
+
+  if (action === 'test') {
+    const [profileName] = rest
+    const response = await askAi(
+      {
+        systemPrompt: 'You are an API connectivity checker.',
+        userPrompt: 'Return exactly one word: pong'
+      },
+      {
+        profile: profileName
+      }
+    )
+    logger.success(`AI 连通性测试成功: ${response}`)
+    return
+  }
+
+  throw new IcodeError(`未知 ai 子命令: ${action}`, {
+    code: 'CONFIG_AI_UNKNOWN_SUBCOMMAND',
+    exitCode: 2
+  })
+}
+
+async function resolvePolicyRoot(repoMode) {
+  try {
+    const context = await resolveGitContext({ repoMode })
+    return context.topLevelPath
+  } catch {
+    return path.resolve(process.cwd())
+  }
+}
+
+export async function runConfigCommand(rawArgs) {
+  if (rawArgs[0] === 'ai') {
+    await runAiConfigCommand(rawArgs.slice(1))
+    return
+  }
+
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      help: { type: 'boolean', short: 'h', default: false },
+      'repo-mode': { type: 'string', default: 'auto' }
+    }
+  })
+
+  if (parsed.values.help || parsed.positionals.length === 0) {
+    printHelp()
+    return
+  }
+
+  const [command, ...rest] = parsed.positionals
+
+  if (command === 'list') {
+    process.stdout.write(`${JSON.stringify(readConfig(), null, 2)}\n`)
+    logger.info(`配置文件路径: ${getConfigFilePath()}`)
+    return
+  }
+
+  if (command === 'get') {
+    const pathExpression = rest[0]
+    if (!pathExpression) {
+      throw new IcodeError('缺少配置路径: icode config get <path>', {
+        code: 'CONFIG_GET_PATH_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    const value = getValue(pathExpression)
+    if (value === undefined) {
+      logger.warn('配置不存在。')
+      return
+    }
+
+    if (typeof value === 'object') {
+      process.stdout.write(`${JSON.stringify(value, null, 2)}\n`)
+    } else {
+      process.stdout.write(`${value}\n`)
+    }
+
+    return
+  }
+
+  if (command === 'set') {
+    const [pathExpression, rawValue] = rest
+    if (!pathExpression || rawValue == null) {
+      throw new IcodeError('缺少参数: icode config set <path> <value>', {
+        code: 'CONFIG_SET_ARGUMENTS_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    const value = parseConfigValue(rawValue)
+    setValue(pathExpression, value)
+    logger.success(`已写入: ${pathExpression}`)
+    return
+  }
+
+  if (command === 'delete') {
+    const [pathExpression] = rest
+    if (!pathExpression) {
+      throw new IcodeError('缺少参数: icode config delete <path>', {
+        code: 'CONFIG_DELETE_PATH_REQUIRED',
+        exitCode: 2
+      })
+    }
+
+    deleteValue(pathExpression)
+    logger.success(`已删除: ${pathExpression}`)
+    return
+  }
+
+  if (command === 'protect') {
+    const [action, ...branches] = rest
+    const repoRoot = await resolvePolicyRoot(parsed.values['repo-mode'])
+    const currentPolicy = getRepoPolicy(repoRoot)
+    const currentProtected = new Set((currentPolicy.protectedBranches || []).map((item) => item.trim()).filter(Boolean))
+
+    if (action === 'list') {
+      process.stdout.write(`${[...currentProtected].join('\n')}\n`)
+      logger.info(`受保护分支作用仓库: ${repoRoot}`)
+      return
+    }
+
+    if (action === 'add') {
+      branches.forEach((branch) => {
+        const normalized = branch.trim()
+        if (normalized) {
+          currentProtected.add(normalized)
+        }
+      })
+
+      setRepoPolicy(repoRoot, {
+        protectedBranches: [...currentProtected]
+      })
+      logger.success(`受保护分支已更新: ${[...currentProtected].join(', ')}`)
+      return
+    }
+
+    if (action === 'remove') {
+      branches.forEach((branch) => {
+        currentProtected.delete(branch.trim())
+      })
+
+      setRepoPolicy(repoRoot, {
+        protectedBranches: [...currentProtected]
+      })
+      logger.success(`受保护分支已更新: ${[...currentProtected].join(', ')}`)
+      return
+    }
+
+    throw new IcodeError('protect 子命令仅支持: list | add | remove', {
+      code: 'CONFIG_PROTECT_INVALID_ACTION',
+      exitCode: 2
+    })
+  }
+
+  throw new IcodeError(`未知 config 子命令: ${command}`, {
+    code: 'CONFIG_UNKNOWN_SUBCOMMAND',
+    exitCode: 2
+  })
+}

package/src/commands/explain.js

@@ -0,0 +1,80 @@
+import { parseArgs } from 'node:util'
+import { getAiCommandOptions } from '../core/ai-config.js'
+import { logger } from '../core/logger.js'
+import { runAiExplainWorkflow } from '../workflows/ai-explain-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode 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
+}
+
+export async function runExplainCommand(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) {
+    printHelp()
+    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`)
+}

package/src/commands/help.js

@@ -0,0 +1,49 @@
+export function printMainHelp() {
+  process.stdout.write(`
+icode v3 - Git workflow CLI
+
+Usage:
+  icode <command> [options]
+
+Commands:
+  ai          AI 助手能力（提交信息/冲突建议/代码评审）
+  codereview  AI 代码评审（不带 ai 前缀）
+  checkout    切换/创建分支（本地/远程自动识别）
+  push        提交并推送，可合并到多个目标分支
+  sync        批量同步分支（fetch + pull）
+  clean       清理已合并分支（可删远程）
+  undo        向导式撤销/回滚（revert/reset）
+  migrate     迁移分支提交（cherry-pick）
+  tag         创建并推送 tag（支持自动命名）
+  config      查看和修改本地配置（含 AI profile）
+  explain     AI 解释 Git diff（自然语言）
+  info        查看当前 git 与配置环境
+  help        查看帮助（命令总览）
+
+Global options:
+  -d, --debug            开启调试日志（输出更多细节）
+  -h, --help             查看帮助
+
+Tips:
+  icode <command> -h     查看子命令完整参数说明
+
+Examples:
+  icode checkout feature/login main --push-origin
+  icode ai commit --apply -y
+  icode ai codereview
+  icode codereview --base origin/main --head HEAD
+  icode explain --base origin/main --head HEAD
+  icode push release test -m "feat: batch publish" -y
+  icode push release test --ai-commit -y
+  icode push release test -m "feat: keep merge commit" --local-merge -y
+  icode sync --all-local --merge-main
+  icode clean --remote --force -y
+  icode undo --mode revert --ref HEAD~1 -y
+  icode undo --recover abort
+  icode migrate feature/login release --push -y
+  icode migrate --interactive
+  icode push --no-verify -m "chore: bypass hooks"
+  icode config protect add main release
+  icode info
+`)
+}

package/src/commands/info.js

@@ -0,0 +1,57 @@
+import { parseArgs } from 'node:util'
+import { logger } from '../core/logger.js'
+import { runInfoWorkflow } from '../workflows/info-workflow.js'
+
+function printHelp() {
+  process.stdout.write(`
+Usage:
+  icode info [options]
+
+Options:
+  --repo-mode <mode>     仓库模式: auto(自动继承父仓库) | strict(禁止继承)
+  -h, --help             查看帮助
+
+Notes:
+  输出包含当前仓库、分支、hook 与 AI 配置概览。
+`)
+}
+
+export async function runInfoCommand(rawArgs) {
+  const parsed = parseArgs({
+    args: rawArgs,
+    allowPositionals: true,
+    options: {
+      'repo-mode': { type: 'string', default: 'auto' },
+      help: { type: 'boolean', short: 'h', default: false }
+    }
+  })
+
+  if (parsed.values.help) {
+    printHelp()
+    return
+  }
+
+  const result = await runInfoWorkflow({
+    repoMode: parsed.values['repo-mode']
+  })
+
+  const infoBlock = {
+    gitVersion: result.gitVersion,
+    configPath: result.configPath,
+    repoRoot: result.context.topLevelPath,
+    cwd: result.context.cwd,
+    inheritedFromParent: result.context.inheritedFromParent,
+    currentBranch: result.context.currentBranch,
+    defaultBranch: result.context.defaultBranch,
+    hookPath: result.context.hookPath,
+    hasHookPath: result.context.hasHookPath,
+    hasHuskyFolder: result.context.hasHuskyFolder,
+    isSubmodule: result.context.isSubmodule,
+    superprojectPath: result.context.superprojectPath,
+    protectedBranches: result.repoPolicy.protectedBranches || [],
+    ai: result.aiConfig
+  }
+
+  process.stdout.write(`${JSON.stringify(infoBlock, null, 2)}\n`)
+  logger.success('info 输出完成')
+}