@icode-js/icode 3.0.4 → 3.1.0

package/src/core/cli/update-notifier.js

@@ -0,0 +1,138 @@
+import { createRequire } from 'node:module'
+import { runCommand } from '../commands/shell.js'
+import { logger } from '../tools/logger.js'
+
+const require = createRequire(import.meta.url)
+const packageJson = require('../../../package.json')
+
+/**
+ * 规范化版本号，输出仅包含数字段的 semver 主体数组。
+ * 输入为字符串版本号，输出为数字数组；若格式不合法则返回 null。
+ */
+function normalizeVersionSegments(version) {
+  const normalized = String(version || '').trim()
+  if (!normalized) {
+    return null
+  }
+
+  const coreVersion = normalized.split('-')[0]
+  if (!/^\d+(?:\.\d+)*$/.test(coreVersion)) {
+    return null
+  }
+
+  return coreVersion.split('.').map((segment) => Number(segment))
+}
+
+/**
+ * 解析 npm view 返回的版本文本，兼容 JSON 字符串与纯文本两种输出。
+ * 输入为命令 stdout，输出为去空白后的版本号字符串。
+ */
+function parsePublishedVersion(stdout) {
+  const normalized = String(stdout || '').trim()
+  if (!normalized) {
+    return ''
+  }
+
+  try {
+    const parsed = JSON.parse(normalized)
+    if (typeof parsed === 'string') {
+      return parsed.trim()
+    }
+  } catch {
+    // npm 在异常场景下也可能输出纯文本版本号，这里保留原始文本继续解析。
+  }
+
+  return normalized.replace(/^"|"$/g, '').trim()
+}
+
+/**
+ * 比较两个版本号，判断远端版本是否严格高于当前版本。
+ * 输入为当前版本和远端版本，输出为布尔值。
+ */
+export function hasNewerVersion(currentVersion, latestVersion) {
+  const currentSegments = normalizeVersionSegments(currentVersion)
+  const latestSegments = normalizeVersionSegments(latestVersion)
+
+  if (!currentSegments || !latestSegments) {
+    return false
+  }
+
+  const maxLength = Math.max(currentSegments.length, latestSegments.length)
+  for (let index = 0; index < maxLength; index += 1) {
+    const currentValue = currentSegments[index] || 0
+    const latestValue = latestSegments[index] || 0
+
+    if (latestValue > currentValue) {
+      return true
+    }
+
+    if (latestValue < currentValue) {
+      return false
+    }
+  }
+
+  return false
+}
+
+/**
+ * 查询 npm registry 上当前包的最新发布版本。
+ * 输入为可选 runner/packageName，输出为最新版本号；失败时返回空字符串。
+ */
+export async function fetchLatestPublishedVersion(options = {}) {
+  const packageName = options.packageName || packageJson.name
+  const runner = options.runner || runCommand
+
+  try {
+    const result = await runner('npm', ['view', packageName, 'version', '--json'], {
+      allowFailure: true,
+      env: {
+        ...process.env,
+        NO_UPDATE_NOTIFIER: '1',
+        npm_config_update_notifier: 'false',
+        npm_config_loglevel: 'silent'
+      }
+    })
+
+    if (result.exitCode !== 0) {
+      return ''
+    }
+
+    return parsePublishedVersion(result.stdout)
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * 在命令成功结束后提示可用更新版本。
+ * 输入为可选 runner/warn/packageName/currentVersion，输出为通知结果对象。
+ */
+export async function notifyIfCliUpdateAvailable(options = {}) {
+  const packageName = options.packageName || packageJson.name
+  const currentVersion = options.currentVersion || packageJson.version
+  const warn = options.warn || logger.warn
+
+  const latestVersion = await fetchLatestPublishedVersion({
+    runner: options.runner,
+    packageName
+  })
+
+  if (!latestVersion || !hasNewerVersion(currentVersion, latestVersion)) {
+    return {
+      notified: false,
+      packageName,
+      currentVersion,
+      latestVersion
+    }
+  }
+
+  warn(`发现新版本可用: ${currentVersion} -> ${latestVersion}`)
+  warn(`更新命令: npm i -g ${packageName}@latest`)
+
+  return {
+    notified: true,
+    packageName,
+    currentVersion,
+    latestVersion
+  }
+}

package/src/core/{shell.js → commands/shell.js}

@@ -1,10 +1,18 @@
 import { spawn } from 'node:child_process'
-import { IcodeError } from './errors.js'
+import { IcodeError } from '../errors.js'
 
+/**
+ * 把命令与参数拼成可读字符串，供日志与报错复用。
+ * 输入为命令名与参数数组，输出为单行命令文本。
+ */
 function stringifyCommand(command, args) {
   return [command, ...args].join(' ')
 }
 
+/**
+ * 组合命令失败消息，尽量附带 stderr/stdout 便于定位问题。
+ * 输入为命令信息与执行结果，输出为最终错误文案。
+ */
 function formatFailureMessage(command, args, result) {
   const baseMessage = `命令执行失败(${result.exitCode}): ${stringifyCommand(command, args)}`
   const detailLines = [result.stderr, result.stdout].map((item) => item.trim()).filter(Boolean)
@@ -16,6 +24,10 @@ function formatFailureMessage(command, args, result) {
   return `${baseMessage}\n${detailLines.join('\n')}`
 }
 
+/**
+ * 执行外部命令并收集 stdout/stderr；允许按需把非零退出码作为普通结果返回。
+ * 输入为命令名、参数数组与执行选项，输出为标准化执行结果。
+ */
 export async function runCommand(command, args = [], options = {}) {
   const { cwd = process.cwd(), env = process.env, allowFailure = false } = options
 

package/src/core/{config-store.js → config/store.js}

@@ -1,7 +1,7 @@
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
-import { IcodeError } from './errors.js'
+import { IcodeError } from '../errors.js'
 
 const DEFAULT_CONFIG = {
   version: 1,
@@ -9,6 +9,12 @@ const DEFAULT_CONFIG = {
     repoMode: 'auto',
     defaultMainBranches: ['main', 'master']
   },
+  platforms: {
+    remoteMerge: {
+      provider: '',
+      apiKey: ''
+    }
+  },
   ai: {
     activeProfile: '',
     profiles: {},
@@ -74,6 +80,14 @@ export function readConfig() {
         ...cloneDefault().defaults,
         ...(parsed.defaults || {})
       },
+      platforms: {
+        ...cloneDefault().platforms,
+        ...(parsed.platforms || {}),
+        remoteMerge: {
+          ...cloneDefault().platforms.remoteMerge,
+          ...(parsed.platforms?.remoteMerge || {})
+        }
+      },
       ai: {
         ...cloneDefault().ai,
         ...(parsed.ai || {}),
@@ -176,8 +190,13 @@ function normalizeRepoKey(repoRootPath) {
 export function getRepoPolicy(repoRootPath) {
   const key = normalizeRepoKey(repoRootPath)
   const config = readConfig()
-  return config.repositories[key] || {
-    protectedBranches: []
+  return {
+    protectedBranches: [],
+    remoteMerge: {
+      enabled: true,
+      projectUrl: ''
+    },
+    ...(config.repositories[key] || {})
   }
 }
 
@@ -186,9 +205,42 @@ export function setRepoPolicy(repoRootPath, policy) {
   const config = readConfig()
   config.repositories[key] = {
     protectedBranches: [],
+    remoteMerge: {
+      enabled: true,
+      projectUrl: ''
+    },
     ...(config.repositories[key] || {}),
     ...policy
   }
   writeConfig(config)
   return config.repositories[key]
 }
+
+export function getPlatformConfig(platformName) {
+  const config = readConfig()
+  const name = String(platformName || '').trim()
+  if (!name) {
+    return {}
+  }
+
+  return config.platforms?.[name] || {}
+}
+
+export function setPlatformConfig(platformName, value) {
+  const config = readConfig()
+  const name = String(platformName || '').trim()
+  if (!name) {
+    throw new IcodeError('平台名称不能为空', { code: 'CONFIG_PLATFORM_EMPTY', exitCode: 2 })
+  }
+
+  config.platforms = {
+    ...(config.platforms || {}),
+    [name]: {
+      ...(config.platforms?.[name] || {}),
+      ...(value || {})
+    }
+  }
+
+  writeConfig(config)
+  return config.platforms[name]
+}

package/src/core/{git-context.js → git/context.js}

@@ -1,8 +1,9 @@
 import fs from 'node:fs'
 import path from 'node:path'
-import { readConfig } from './config-store.js'
-import { IcodeError } from './errors.js'
-import { runCommand } from './shell.js'
+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()
@@ -13,6 +14,24 @@ async function commandOutput(cwd, args, allowFailure = false) {
   return result
 }
 
+async function ensureGitRepository(cwd, options = {}) {
+  const confirmInit = options.confirm || confirm
+  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'])
+}
+
 async function detectDefaultBranch(topLevelPath, fallbackCandidates = ['main', 'master']) {
   const headRefResult = await commandOutput(topLevelPath, ['symbolic-ref', 'refs/remotes/origin/HEAD'], true)
   if (headRefResult.exitCode === 0) {
@@ -44,13 +63,9 @@ export async function resolveGitContext(options = {}) {
   const configRepoMode = config.defaults?.repoMode || 'auto'
   const repoMode = options.repoMode || configRepoMode
 
-  const inside = await commandOutput(cwd, ['rev-parse', '--is-inside-work-tree'], true)
-  if (inside.exitCode !== 0 || cleanOutput(inside.stdout) !== 'true') {
-    throw new IcodeError('当前目录不在 Git 仓库中。', {
-      code: 'NOT_IN_GIT_REPO',
-      exitCode: 2
-    })
-  }
+  await ensureGitRepository(cwd, {
+    confirm: options.confirm
+  })
 
   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-service.js → git/service.js}

@@ -1,14 +1,30 @@
-import { IcodeError } from './errors.js'
-import { buildHookHint, detectHookFailure } from './hook-diagnostics.js'
-import { logger } from './logger.js'
-import { runCommand } from './shell.js'
 import fs from 'node:fs'
 import path from 'node:path'
+import { buildHookHint, detectHookFailure } from './hook-diagnostics.js'
+import { runCommand } from '../commands/shell.js'
+import { IcodeError } from '../errors.js'
+import { logger } from '../tools/logger.js'
 
 function cleanOutput(text) {
   return (text || '').trim()
 }
 
+function parseGitLogRecords(output) {
+  return output
+    .split('\x1e')
+    .map((record) => record.trim())
+    .filter(Boolean)
+    .map((record) => {
+      const [hash = '', subject = '', body = ''] = record.split('\x1f')
+      return {
+        hash: hash.trim(),
+        subject: subject.trim(),
+        body: body.trim()
+      }
+    })
+    .filter((item) => item.hash && item.subject)
+}
+
 export class GitService {
   constructor(context) {
     this.context = context
@@ -77,6 +93,13 @@ export class GitService {
     return result.exitCode === 0
   }
 
+  async getRemoteUrl(remoteName = 'origin') {
+    const result = await this.exec(['remote', 'get-url', remoteName], {
+      allowFailure: true
+    })
+    return cleanOutput(result.stdout)
+  }
+
   async listLocalBranches() {
     const result = await this.exec(['for-each-ref', '--format=%(refname:short)', 'refs/heads'])
     return result.stdout
@@ -431,6 +454,23 @@ export class GitService {
       .filter(Boolean)
   }
 
+  // 读取指定 range 内的提交信息，返回按时间顺序排列的 hash/subject/body 列表。
+  async listCommitMessages(rangeSpec) {
+    const result = await this.exec(['log', '--reverse', '--format=%H%x1f%s%x1f%b%x1e', rangeSpec], {
+      allowFailure: true
+    })
+    return parseGitLogRecords(result.stdout)
+  }
+
+  // 读取单个 ref 的最新提交信息，供无法从 range 提取提交时回退使用。
+  async getCommitMessage(ref = 'HEAD') {
+    const result = await this.exec(['log', '-1', '--format=%H%x1f%s%x1f%b%x1e', ref], {
+      allowFailure: true
+    })
+    const commits = parseGitLogRecords(result.stdout)
+    return commits[0] || null
+  }
+
   async cherryPick(commits) {
     const normalized = Array.isArray(commits) ? commits : [commits]
     const list = normalized.map((item) => item.trim()).filter(Boolean)

package/src/core/remote-merge/client.js

@@ -0,0 +1,42 @@
+import { IcodeError } from '../errors.js'
+import { requestGitLabRemoteMerge, resolveGitLabProjectUrlFromRemote } from './providers/gitlab.js'
+
+const REMOTE_MERGE_PROVIDERS = {
+  gitlab: {
+    requestRemoteMerge: requestGitLabRemoteMerge,
+    resolveProjectUrlFromRemote: resolveGitLabProjectUrlFromRemote
+  }
+}
+
+// 按 provider 读取远程合并实现，缺失或不支持时统一抛出明确错误。
+function getRemoteMergeProvider(provider) {
+  const normalizedProvider = String(provider || '').trim()
+  if (!normalizedProvider) {
+    throw new IcodeError('远程合并缺少 provider', {
+      code: 'REMOTE_MERGE_PROVIDER_EMPTY',
+      exitCode: 2
+    })
+  }
+
+  const handler = REMOTE_MERGE_PROVIDERS[normalizedProvider]
+  if (!handler) {
+    throw new IcodeError(`当前仅支持: ${Object.keys(REMOTE_MERGE_PROVIDERS).join(', ')}，收到 provider=${normalizedProvider}`, {
+      code: 'REMOTE_MERGE_PROVIDER_UNSUPPORTED',
+      exitCode: 2
+    })
+  }
+
+  return handler
+}
+
+// 统一根据 provider 从 remote URL 解析项目地址，避免工作流层感知平台细节。
+export function resolveRemoteMergeProjectUrl(options = {}) {
+  const handler = getRemoteMergeProvider(options.provider)
+  return handler.resolveProjectUrlFromRemote(options.remoteUrl || '')
+}
+
+// 统一按 provider 调度远程合并请求，后续新增平台只需补 provider 实现。
+export async function requestRemoteMerge(options = {}) {
+  const handler = getRemoteMergeProvider(options.provider)
+  return handler.requestRemoteMerge(options)
+}