@icode-js/icode 3.1.0 → 3.2.0

package/src/core/config/store.js

@@ -193,8 +193,7 @@ export function getRepoPolicy(repoRootPath) {
   return {
     protectedBranches: [],
     remoteMerge: {
-      enabled: true,
-      projectUrl: ''
+      enabled: true
     },
     ...(config.repositories[key] || {})
   }
@@ -206,8 +205,7 @@ export function setRepoPolicy(repoRootPath, policy) {
   config.repositories[key] = {
     protectedBranches: [],
     remoteMerge: {
-      enabled: true,
-      projectUrl: ''
+      enabled: true
     },
     ...(config.repositories[key] || {}),
     ...policy

package/src/core/git/context.js

@@ -3,7 +3,6 @@ import path from 'node:path'
 import { runCommand } from '../commands/shell.js'
 import { readConfig } from '../config/store.js'
 import { IcodeError } from '../errors.js'
-import { confirm } from '../tools/interactive.js'
 
 function cleanOutput(text) {
   return (text || '').trim()
@@ -14,22 +13,20 @@ async function commandOutput(cwd, args, allowFailure = false) {
   return result
 }
 
-async function ensureGitRepository(cwd, options = {}) {
-  const confirmInit = options.confirm || confirm
+/**
+ * 确认当前目录属于 Git 仓库。
+ * 输入为工作目录，输出为空；不在仓库中时直接抛错，不隐式初始化仓库。
+ */
+async function ensureGitRepository(cwd) {
   const inside = await commandOutput(cwd, ['rev-parse', '--is-inside-work-tree'], true)
   if (inside.exitCode === 0 && cleanOutput(inside.stdout) === 'true') {
     return
   }
 
-  const shouldInit = await confirmInit('当前目录还没有初始化 Git 仓库，是否现在执行 git init？')
-  if (!shouldInit) {
-    throw new IcodeError('当前目录不在 Git 仓库中。', {
-      code: 'NOT_IN_GIT_REPO',
-      exitCode: 2
-    })
-  }
-
-  await commandOutput(cwd, ['init'])
+  throw new IcodeError('当前目录不在 Git 仓库中。请先进入已有仓库，或手动执行 git init。', {
+    code: 'NOT_IN_GIT_REPO',
+    exitCode: 2
+  })
 }
 
 async function detectDefaultBranch(topLevelPath, fallbackCandidates = ['main', 'master']) {
@@ -57,15 +54,17 @@ async function detectDefaultBranch(topLevelPath, fallbackCandidates = ['main', '
   return 'main'
 }
 
+/**
+ * 解析当前 Git 仓库上下文。
+ * 输入为 cwd/repoMode 等选项，输出仓库根路径、git 目录、当前分支和默认分支等稳定上下文。
+ */
 export async function resolveGitContext(options = {}) {
   const cwd = path.resolve(options.cwd || process.cwd())
   const config = readConfig()
   const configRepoMode = config.defaults?.repoMode || 'auto'
   const repoMode = options.repoMode || configRepoMode
 
-  await ensureGitRepository(cwd, {
-    confirm: options.confirm
-  })
+  await ensureGitRepository(cwd)
 
   const topLevelPath = cleanOutput((await commandOutput(cwd, ['rev-parse', '--show-toplevel'])).stdout)
   const gitDirRaw = cleanOutput((await commandOutput(cwd, ['rev-parse', '--git-dir'])).stdout)

package/src/core/git/preconditions.js

@@ -0,0 +1,88 @@
+import { IcodeError } from '../errors.js'
+
+/**
+ * 读取当前仓库执行状态。
+ * 输入为 GitService 实例，输出当前分支、未完成操作和工作区改动摘要。
+ */
+export async function readGitSafetyState(git) {
+  const [currentBranch, operation, changes] = await Promise.all([
+    git.getCurrentBranch(),
+    git.getInProgressOperation(),
+    git.getStatusSummary()
+  ])
+
+  return {
+    currentBranch,
+    operation,
+    changes
+  }
+}
+
+/**
+ * 断言当前处于普通分支。
+ * 输入为分支名、命令名和错误码，输出为空；不满足时抛出 IcodeError。
+ */
+export function assertOnBranch(currentBranch, commandName, code) {
+  if (currentBranch) {
+    return
+  }
+
+  throw new IcodeError(`当前不在普通分支上，${commandName} 已停止。`, {
+    code,
+    exitCode: 2
+  })
+}
+
+/**
+ * 断言不存在未完成的 Git 操作。
+ * 输入为操作名、命令名和错误码，输出为空；检测到 merge/rebase/cherry-pick/revert 时抛错。
+ */
+export function assertNoPendingOperation(operation, commandName, code) {
+  if (!operation) {
+    return
+  }
+
+  throw new IcodeError(`检测到未完成的 Git 操作: ${operation}。请先完成或中止该操作，${commandName} 已停止。`, {
+    code,
+    exitCode: 2,
+    meta: {
+      operation
+    }
+  })
+}
+
+/**
+ * 断言不存在冲突文件。
+ * 输入为改动摘要、命令名和错误码，输出为空；存在冲突文件时抛错。
+ */
+export function assertNoConflictedFiles(changes, commandName, code) {
+  if (!changes || changes.conflicted === 0) {
+    return
+  }
+
+  throw new IcodeError(`存在 ${changes.conflicted} 个冲突文件，${commandName} 已停止。`, {
+    code,
+    exitCode: 2,
+    meta: {
+      changes
+    }
+  })
+}
+
+/**
+ * 断言工作区干净。
+ * 输入为改动摘要、命令名和错误码，输出为空；存在任何未提交改动时抛错。
+ */
+export function assertCleanWorktree(changes, commandName, code) {
+  if (changes && changes.clean) {
+    return
+  }
+
+  throw new IcodeError(`工作区存在未提交改动，${commandName} 已停止。请先执行 save 或手动清理。`, {
+    code,
+    exitCode: 2,
+    meta: {
+      changes
+    }
+  })
+}

package/src/core/git/service.js

@@ -9,6 +9,77 @@ function cleanOutput(text) {
   return (text || '').trim()
 }
 
+/**
+ * 解析 porcelain v1 单行状态。
+ * 输入为 `git status --porcelain` 的一行文本，输出为索引区状态、工作区状态和文件路径。
+ * 关键假设：本项目只需要稳定分类改动，不在这里还原 rename 的源路径细节。
+ */
+function parsePorcelainLine(line) {
+  const indexStatus = line.slice(0, 1)
+  const worktreeStatus = line.slice(1, 2)
+  const rawPath = line.slice(3).trim()
+  const separatorIndex = rawPath.indexOf(' -> ')
+  const filePath = separatorIndex === -1 ? rawPath : rawPath.slice(separatorIndex + 4)
+
+  return {
+    raw: line,
+    indexStatus,
+    worktreeStatus,
+    filePath
+  }
+}
+
+/**
+ * 汇总 porcelain 状态行。
+ * 输入为状态行数组，输出为 staged/unstaged/untracked/conflicted 计数和文件明细。
+ * 关键假设：`??` 表示未跟踪文件，`U` 或双边冲突组合表示未解决冲突。
+ */
+function summarizeStatusEntries(entries) {
+  const files = []
+  const summary = {
+    staged: 0,
+    unstaged: 0,
+    untracked: 0,
+    conflicted: 0,
+    files
+  }
+
+  for (const entry of entries) {
+    const isUntracked = entry.indexStatus === '?' && entry.worktreeStatus === '?'
+    const isConflicted = entry.indexStatus === 'U' ||
+      entry.worktreeStatus === 'U' ||
+      (entry.indexStatus === 'A' && entry.worktreeStatus === 'A') ||
+      (entry.indexStatus === 'D' && entry.worktreeStatus === 'D')
+    const hasStaged = !isUntracked && entry.indexStatus !== ' ' && entry.indexStatus !== '?' && !isConflicted
+    const hasUnstaged = !isUntracked && entry.worktreeStatus !== ' ' && entry.worktreeStatus !== '?' && !isConflicted
+
+    if (isUntracked) {
+      summary.untracked += 1
+    }
+    if (isConflicted) {
+      summary.conflicted += 1
+    }
+    if (hasStaged) {
+      summary.staged += 1
+    }
+    if (hasUnstaged) {
+      summary.unstaged += 1
+    }
+
+    files.push({
+      path: entry.filePath,
+      indexStatus: entry.indexStatus,
+      worktreeStatus: entry.worktreeStatus,
+      staged: hasStaged,
+      unstaged: hasUnstaged,
+      untracked: isUntracked,
+      conflicted: isConflicted
+    })
+  }
+
+  return summary
+}
+
 function parseGitLogRecords(output) {
   return output
     .split('\x1e')
@@ -76,6 +147,10 @@ export class GitService {
       return 'rebase'
     }
 
+    if (this.operationFileExists('MERGE_HEAD')) {
+      return 'merge'
+    }
+
     return null
   }
 
@@ -150,7 +225,9 @@ export class GitService {
   async pull(branchName, options = {}) {
     const args = ['pull', 'origin', branchName]
 
-    if (options.noRebase !== false) {
+    if (options.rebase) {
+      args.push('--rebase')
+    } else if (options.noRebase !== false) {
       args.push('--no-rebase')
     }
 
@@ -176,6 +253,16 @@ export class GitService {
     await this.exec(args)
   }
 
+  // 继续已解决冲突的 merge 操作，供 undo recover 统一恢复合并现场。
+  async mergeContinue() {
+    await this.exec(['merge', '--continue'])
+  }
+
+  // 中止未完成的 merge 操作，保留给显式 recover abort 使用，不自动清理用户现场。
+  async mergeAbort() {
+    await this.exec(['merge', '--abort'], { allowFailure: true })
+  }
+
   async rebase(fromRef) {
     await this.exec(['rebase', fromRef])
   }
@@ -190,12 +277,75 @@ export class GitService {
     return result.stdout
   }
 
+  /**
+   * 读取并解析工作区状态。
+   * 输入为空，输出为结构化改动摘要，供 ready/save 等场景命令复用。
+   */
+  async getStatusSummary() {
+    const output = await this.statusPorcelain()
+    const entries = output
+      .split('\n')
+      .map((line) => line.trimEnd())
+      .filter(Boolean)
+      .map(parsePorcelainLine)
+
+    return {
+      clean: entries.length === 0,
+      total: entries.length,
+      ...summarizeStatusEntries(entries)
+    }
+  }
+
   async hasChanges() {
     // 只要 porcelain 有输出，就说明暂存区、工作区或未跟踪文件存在改动。
     const output = await this.statusPorcelain()
     return cleanOutput(output).length > 0
   }
 
+  /**
+   * 读取当前分支的 upstream ref。
+   * 输入为空，输出为 upstream 短 ref；没有 upstream 时返回空字符串。
+   */
+  async getUpstreamRef() {
+    const result = await this.exec(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'], {
+      allowFailure: true
+    })
+
+    if (result.exitCode !== 0) {
+      return ''
+    }
+
+    return cleanOutput(result.stdout)
+  }
+
+  /**
+   * 读取当前 HEAD 与 upstream 的领先/落后数量。
+   * 输入为空，输出 upstream、ahead、behind；没有 upstream 时 explicitly 标记 configured=false。
+   */
+  async getUpstreamStatus() {
+    const upstream = await this.getUpstreamRef()
+    if (!upstream) {
+      return {
+        configured: false,
+        upstream: '',
+        ahead: 0,
+        behind: 0
+      }
+    }
+
+    const result = await this.exec(['rev-list', '--left-right', '--count', `${upstream}...HEAD`])
+    const [behindRaw = '0', aheadRaw = '0'] = cleanOutput(result.stdout).split(/\s+/)
+    const behind = Number.parseInt(behindRaw, 10)
+    const ahead = Number.parseInt(aheadRaw, 10)
+
+    return {
+      configured: true,
+      upstream,
+      ahead: Number.isInteger(ahead) ? ahead : 0,
+      behind: Number.isInteger(behind) ? behind : 0
+    }
+  }
+
   // 列出未被忽略的未跟踪文件，供 AI 工作流补全新文件 diff。
   async listUntrackedFiles() {
     const result = await this.exec(['ls-files', '--others', '--exclude-standard'])