@icode-js/icode 3.2.0 → 3.4.0

package/src/core/platform/remote-url.js

@@ -0,0 +1,92 @@
+/**
+ * 解析 git remote URL。
+ * 支持 https://host/a/b.git、ssh://git@host:22/a/b.git、git@host:a/b.git 三种格式。
+ * 输出 { host, protocol, path, owner, repo, webUrl }；无法识别时返回 null。
+ */
+export function parseRemoteUrl(remoteUrl = '') {
+  const raw = String(remoteUrl || '').trim()
+  if (!raw) {
+    return null
+  }
+
+  let host = ''
+  let repoPath = ''
+  let protocol = 'https:'
+
+  if (/^https?:\/\//i.test(raw)) {
+    try {
+      const parsed = new URL(raw)
+      host = parsed.host
+      protocol = parsed.protocol
+      repoPath = parsed.pathname
+    } catch {
+      return null
+    }
+  } else if (/^ssh:\/\//i.test(raw)) {
+    try {
+      const parsed = new URL(raw)
+      // ssh 端口通常不是 web 端口，web 链接只保留主机名。
+      host = parsed.hostname
+      repoPath = parsed.pathname
+    } catch {
+      return null
+    }
+  } else {
+    const scpMatch = raw.match(/^(?:[^@]+@)?([^:/]+):(.+)$/)
+    if (!scpMatch) {
+      return null
+    }
+    host = scpMatch[1]
+    repoPath = scpMatch[2]
+  }
+
+  repoPath = repoPath.replace(/^\/+/, '').replace(/\/+$/, '').replace(/\.git$/i, '')
+  if (!host || !repoPath || !repoPath.includes('/')) {
+    return null
+  }
+
+  const segments = repoPath.split('/')
+  const repo = segments[segments.length - 1]
+  const owner = segments.slice(0, -1).join('/')
+
+  return {
+    host,
+    protocol,
+    path: repoPath,
+    owner,
+    repo,
+    webUrl: `${protocol}//${host}/${repoPath}`
+  }
+}
+
+/**
+ * 根据主机名推断代码托管平台。
+ * 输入为主机名与 { hosts } 显式映射（来自配置 platforms.hosts），输出 github | gitlab | gitee | gitea | ''。
+ */
+export function detectProviderFromHost(host = '', hostMap = {}) {
+  const normalizedHost = String(host || '').trim().toLowerCase()
+  if (!normalizedHost) {
+    return ''
+  }
+
+  const mapped = hostMap?.[normalizedHost] || hostMap?.[normalizedHost.replace(/:\d+$/, '')]
+  if (mapped) {
+    return String(mapped).trim().toLowerCase()
+  }
+
+  const bareHost = normalizedHost.replace(/:\d+$/, '')
+  if (bareHost === 'github.com' || bareHost.endsWith('.github.com') || bareHost.includes('github')) {
+    return 'github'
+  }
+  if (bareHost === 'gitee.com') {
+    return 'gitee'
+  }
+  if (bareHost === 'gitlab.com' || bareHost.includes('gitlab')) {
+    return 'gitlab'
+  }
+  if (bareHost === 'codeberg.org' || bareHost.includes('gitea') || bareHost.includes('forgejo')) {
+    return 'gitea'
+  }
+
+  return ''
+}

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

@@ -1,16 +1,46 @@
 import { IcodeError } from '../errors.js'
+import { createPlatformClient, performPlatformRemoteMerge } from '../platform/index.js'
+import { parseRemoteUrl } from '../platform/remote-url.js'
 import { requestGitLabRemoteMerge, resolveGitLabProjectUrlFromRemote } from './providers/gitlab.js'
 
+// 非 GitLab 平台统一走通用平台客户端：创建 PR -> 等待可合并 -> 合并。
+function createGenericProvider(provider) {
+  return {
+    resolveProjectUrlFromRemote(remoteUrl) {
+      return parseRemoteUrl(remoteUrl)?.webUrl || ''
+    },
+    async requestRemoteMerge(options) {
+      const client = createPlatformClient(options.projectUrl, {
+        provider,
+        token: String(options.apiKey || '').trim()
+      })
+      return performPlatformRemoteMerge(client, {
+        sourceBranch: options.sourceBranch,
+        targetBranch: options.targetBranch,
+        title: options.mergeRequestTitle,
+        body: options.mergeRequestDescription,
+        pollIntervalMs: options.pollIntervalMs,
+        maxAttempts: options.maxAttempts
+      })
+    }
+  }
+}
+
 const REMOTE_MERGE_PROVIDERS = {
   gitlab: {
     requestRemoteMerge: requestGitLabRemoteMerge,
     resolveProjectUrlFromRemote: resolveGitLabProjectUrlFromRemote
-  }
+  },
+  github: createGenericProvider('github'),
+  gitee: createGenericProvider('gitee'),
+  gitea: createGenericProvider('gitea')
 }
 
+export const REMOTE_MERGE_PROVIDER_NAMES = Object.keys(REMOTE_MERGE_PROVIDERS)
+
 // 按 provider 读取远程合并实现，缺失或不支持时统一抛出明确错误。
 function getRemoteMergeProvider(provider) {
-  const normalizedProvider = String(provider || '').trim()
+  const normalizedProvider = String(provider || '').trim().toLowerCase()
   if (!normalizedProvider) {
     throw new IcodeError('远程合并缺少 provider', {
       code: 'REMOTE_MERGE_PROVIDER_EMPTY',
@@ -20,7 +50,7 @@ function getRemoteMergeProvider(provider) {
 
   const handler = REMOTE_MERGE_PROVIDERS[normalizedProvider]
   if (!handler) {
-    throw new IcodeError(`当前仅支持: ${Object.keys(REMOTE_MERGE_PROVIDERS).join(', ')}，收到 provider=${normalizedProvider}`, {
+    throw new IcodeError(`当前仅支持: ${REMOTE_MERGE_PROVIDER_NAMES.join(', ')}，收到 provider=${normalizedProvider}`, {
       code: 'REMOTE_MERGE_PROVIDER_UNSUPPORTED',
       exitCode: 2
     })

package/src/core/tools/browser.js

@@ -0,0 +1,28 @@
+import { spawn } from 'node:child_process'
+
+/**
+ * 用系统默认浏览器打开 URL。
+ * 输入为 URL，输出是否成功拉起浏览器；失败时不抛错，调用方会把链接打印出来。
+ * 设置 ICODE_NO_BROWSER=1（或在 CI 中）时不打开。
+ */
+export function openInBrowser(url) {
+  if (!url || process.env.ICODE_NO_BROWSER === '1' || process.env.CI) {
+    return false
+  }
+
+  const platform = process.platform
+  const [command, args] = platform === 'darwin'
+    ? ['open', [url]]
+    : platform === 'win32'
+      ? ['cmd', ['/c', 'start', '""', url.replace(/&/g, '^&')]]
+      : ['xdg-open', [url]]
+
+  try {
+    const child = spawn(command, args, { stdio: 'ignore', detached: true })
+    child.on('error', () => {})
+    child.unref()
+    return true
+  } catch {
+    return false
+  }
+}

package/src/core/tools/commit-prompt.js

@@ -0,0 +1,137 @@
+import path from 'node:path'
+import { getAiConfig } from '../ai/config.js'
+import { chooseOne, input } from './interactive.js'
+import { c } from './theme.js'
+
+// 交互式提交信息向导：选类型 -> 选 scope -> 只写一句描述，尽量减少手动输入。
+
+const COMMIT_TYPES = [
+  { value: 'feat', label: 'feat', hint: '新功能' },
+  { value: 'fix', label: 'fix', hint: '修复问题' },
+  { value: 'refactor', label: 'refactor', hint: '重构（不改功能）' },
+  { value: 'perf', label: 'perf', hint: '性能优化' },
+  { value: 'docs', label: 'docs', hint: '文档' },
+  { value: 'style', label: 'style', hint: '格式调整（不影响逻辑）' },
+  { value: 'test', label: 'test', hint: '测试' },
+  { value: 'chore', label: 'chore', hint: '杂项 / 依赖 / 配置' },
+  { value: 'build', label: 'build', hint: '构建系统' },
+  { value: 'ci', label: 'ci', hint: 'CI 配置' },
+  { value: 'revert', label: 'revert', hint: '回退' }
+]
+
+// 这些目录名作为 scope 没有信息量，跳过取下一级。
+const GENERIC_DIRS = new Set(['src', 'lib', 'app', 'apps', 'packages', 'test', 'tests', '__tests__', 'components', 'pages', 'core', 'utils', 'common'])
+
+/**
+ * 根据改动文件推断 scope 候选：取最有意义的目录名或文件名，按出现次数排序。
+ * 输入为相对路径数组，输出 scope 字符串数组（最多 6 个）。
+ */
+export function suggestScopes(files = []) {
+  const counts = new Map()
+  for (const file of files) {
+    const segments = String(file).split('/').filter(Boolean)
+    const dirs = segments.slice(0, -1)
+    let candidate = dirs.find((dir) => !GENERIC_DIRS.has(dir.toLowerCase()) && !dir.startsWith('.'))
+    if (!candidate) {
+      const base = path.posix.basename(file).replace(/\.[^.]+$/, '')
+      candidate = base && !base.startsWith('.') ? base : ''
+    }
+    if (packagesScope(segments)) {
+      candidate = packagesScope(segments)
+    }
+    if (candidate) {
+      counts.set(candidate, (counts.get(candidate) || 0) + 1)
+    }
+  }
+  return [...counts.entries()]
+    .sort((a, b) => b[1] - a[1])
+    .map(([scope]) => scope.toLowerCase())
+    .slice(0, 6)
+}
+
+// monorepo 的 packages/<name>/... 直接用包名做 scope。
+function packagesScope(segments) {
+  const index = segments.findIndex((segment) => segment === 'packages' || segment === 'apps')
+  return index !== -1 && segments[index + 1] ? segments[index + 1] : ''
+}
+
+// 根据文件猜一个默认类型：只有文档 -> docs，只有测试 -> test，只有配置 -> chore。
+export function suggestType(files = []) {
+  if (!files.length) {
+    return 'feat'
+  }
+  if (files.every((file) => /\.(md|mdx|txt|rst)$/i.test(file) || /^docs\//.test(file))) {
+    return 'docs'
+  }
+  if (files.every((file) => /(^|\/)(__tests__|tests?)\/|\.(test|spec)\.[jt]sx?$/.test(file))) {
+    return 'test'
+  }
+  if (files.every((file) => /(^|\/)(package(-lock)?\.json|pnpm-lock\.yaml|yarn\.lock|\.[\w-]+rc(\.\w+)?|[\w-]+\.config\.\w+)$/.test(file))) {
+    return 'chore'
+  }
+  if (files.every((file) => /^\.github\/|\.gitlab-ci\.yml$/.test(file))) {
+    return 'ci'
+  }
+  return 'feat'
+}
+
+function hasAiProfile() {
+  try {
+    const config = getAiConfig()
+    return Boolean(config.activeProfile && config.profiles?.[config.activeProfile])
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 交互式生成提交信息。
+ * 输入为 { files, allowAi }，输出 { message } 或 { useAi: true } 或 { canceled: true }。
+ */
+export async function promptCommitMessage(options = {}) {
+  const files = options.files || []
+  const allowAi = options.allowAi !== false && hasAiProfile()
+
+  const mode = await chooseOne('提交信息怎么写？', [
+    ...(allowAi ? [{ value: 'ai', label: 'AI 生成', hint: '根据改动自动生成，确认后提交' }] : []),
+    { value: 'guided', label: '引导填写', hint: '选类型和范围，只写一句描述' },
+    { value: 'manual', label: '直接输入完整信息' },
+    { value: 'cancel', label: '取消' }
+  ], 0)
+
+  if (mode === 'cancel') {
+    return { canceled: true }
+  }
+  if (mode === 'ai') {
+    return { useAi: true }
+  }
+  if (mode === 'manual') {
+    const message = await input('提交信息', '')
+    return message ? { message } : { canceled: true }
+  }
+
+  const defaultType = suggestType(files)
+  const typeIndex = Math.max(0, COMMIT_TYPES.findIndex((item) => item.value === defaultType))
+  const type = await chooseOne('类型', COMMIT_TYPES, typeIndex, { filter: false })
+
+  const scopes = suggestScopes(files)
+  let scope = ''
+  if (scopes.length) {
+    scope = await chooseOne('影响范围 (scope)', [
+      ...scopes.map((item) => ({ value: item, label: item })),
+      { value: '', label: c.gray('不写 scope') },
+      { value: '__custom__', label: '自己输入…' }
+    ], 0, { filter: false })
+  }
+  if (scope === '__custom__' || (!scopes.length && options.askScope)) {
+    scope = await input('scope', '')
+  }
+
+  const fileHint = files.length === 1 ? `更新 ${path.posix.basename(files[0])}` : ''
+  const subject = await input(`描述 ${c.gray(`${type}${scope ? `(${scope})` : ''}: …`)}`, fileHint)
+  if (!subject) {
+    return { canceled: true }
+  }
+
+  return { message: `${type}${scope ? `(${scope})` : ''}: ${subject}` }
+}