@icode-js/icode 3.0.2

package/src/core/config-store.js

@@ -0,0 +1,194 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { IcodeError } from './errors.js'
+
+const DEFAULT_CONFIG = {
+  version: 1,
+  defaults: {
+    repoMode: 'auto',
+    defaultMainBranches: ['main', 'master']
+  },
+  ai: {
+    activeProfile: '',
+    profiles: {},
+    options: {}
+  },
+  repositories: {}
+}
+
+export function getConfigFilePath() {
+  if (process.env.ICODE_CONFIG_PATH) {
+    return path.resolve(process.env.ICODE_CONFIG_PATH)
+  }
+
+  const homePath = os.homedir()
+  const legacyPath = path.resolve(homePath, '.icode')
+  const modernPath = path.resolve(homePath, '.icode', 'config.json')
+
+  if (fs.existsSync(legacyPath)) {
+    const legacyStats = fs.statSync(legacyPath)
+    if (legacyStats.isFile()) {
+      return legacyPath
+    }
+  }
+
+  return modernPath
+}
+
+function ensureDirectory(filePath) {
+  const dirPath = path.dirname(filePath)
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true })
+  }
+}
+
+function cloneDefault() {
+  return JSON.parse(JSON.stringify(DEFAULT_CONFIG))
+}
+
+export function readConfig() {
+  const configPath = getConfigFilePath()
+  ensureDirectory(configPath)
+
+  if (!fs.existsSync(configPath)) {
+    const initial = cloneDefault()
+    fs.writeFileSync(configPath, JSON.stringify(initial, null, 2), 'utf8')
+    return initial
+  }
+
+  try {
+    const content = fs.readFileSync(configPath, 'utf8')
+    if (!content.trim()) {
+      const initial = cloneDefault()
+      fs.writeFileSync(configPath, JSON.stringify(initial, null, 2), 'utf8')
+      return initial
+    }
+
+    const parsed = JSON.parse(content)
+
+    return {
+      ...cloneDefault(),
+      ...parsed,
+      defaults: {
+        ...cloneDefault().defaults,
+        ...(parsed.defaults || {})
+      },
+      ai: {
+        ...cloneDefault().ai,
+        ...(parsed.ai || {}),
+        profiles: {
+          ...(parsed.ai?.profiles || {})
+        },
+        options: {
+          ...(parsed.ai?.options && typeof parsed.ai.options === 'object' && !Array.isArray(parsed.ai.options)
+            ? parsed.ai.options
+            : {})
+        }
+      },
+      repositories: {
+        ...(parsed.repositories || {})
+      }
+    }
+  } catch (error) {
+    throw new IcodeError(`配置文件解析失败: ${configPath}`, {
+      code: 'CONFIG_PARSE_ERROR',
+      cause: error
+    })
+  }
+}
+
+export function writeConfig(nextConfig) {
+  const configPath = getConfigFilePath()
+  ensureDirectory(configPath)
+  fs.writeFileSync(configPath, JSON.stringify(nextConfig, null, 2), 'utf8')
+}
+
+function splitPathSegments(pathExpression) {
+  return pathExpression
+    .split('.')
+    .map((segment) => segment.trim())
+    .filter(Boolean)
+}
+
+export function getValue(pathExpression) {
+  const config = readConfig()
+  const segments = splitPathSegments(pathExpression)
+
+  let pointer = config
+  for (const segment of segments) {
+    if (pointer == null || typeof pointer !== 'object') {
+      return undefined
+    }
+    pointer = pointer[segment]
+  }
+
+  return pointer
+}
+
+export function setValue(pathExpression, value) {
+  const config = readConfig()
+  const segments = splitPathSegments(pathExpression)
+
+  if (!segments.length) {
+    throw new IcodeError('配置路径不能为空', { code: 'CONFIG_PATH_EMPTY' })
+  }
+
+  let pointer = config
+  for (let index = 0; index < segments.length - 1; index += 1) {
+    const key = segments[index]
+    if (pointer[key] == null || typeof pointer[key] !== 'object') {
+      pointer[key] = {}
+    }
+    pointer = pointer[key]
+  }
+
+  pointer[segments[segments.length - 1]] = value
+  writeConfig(config)
+  return config
+}
+
+export function deleteValue(pathExpression) {
+  const config = readConfig()
+  const segments = splitPathSegments(pathExpression)
+
+  if (!segments.length) {
+    throw new IcodeError('配置路径不能为空', { code: 'CONFIG_PATH_EMPTY' })
+  }
+
+  let pointer = config
+  for (let index = 0; index < segments.length - 1; index += 1) {
+    pointer = pointer?.[segments[index]]
+    if (pointer == null || typeof pointer !== 'object') {
+      return config
+    }
+  }
+
+  delete pointer[segments[segments.length - 1]]
+  writeConfig(config)
+  return config
+}
+
+function normalizeRepoKey(repoRootPath) {
+  return path.resolve(repoRootPath)
+}
+
+export function getRepoPolicy(repoRootPath) {
+  const key = normalizeRepoKey(repoRootPath)
+  const config = readConfig()
+  return config.repositories[key] || {
+    protectedBranches: []
+  }
+}
+
+export function setRepoPolicy(repoRootPath, policy) {
+  const key = normalizeRepoKey(repoRootPath)
+  const config = readConfig()
+  config.repositories[key] = {
+    protectedBranches: [],
+    ...(config.repositories[key] || {}),
+    ...policy
+  }
+  writeConfig(config)
+  return config.repositories[key]
+}

package/src/core/errors.js

@@ -0,0 +1,25 @@
+export class IcodeError extends Error {
+  constructor(message, options = {}) {
+    super(message)
+    this.name = 'IcodeError'
+    this.code = options.code || 'ICODE_ERROR'
+    this.exitCode = options.exitCode || 1
+    this.meta = options.meta || {}
+    this.cause = options.cause
+  }
+}
+
+export function asIcodeError(error, fallbackMessage = '命令执行失败') {
+  if (error instanceof IcodeError) {
+    return error
+  }
+
+  const wrapped = new IcodeError(error?.message || fallbackMessage, {
+    cause: error,
+    meta: {
+      original: error
+    }
+  })
+
+  return wrapped
+}

package/src/core/git-context.js

@@ -0,0 +1,105 @@
+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'
+
+function cleanOutput(text) {
+  return (text || '').trim()
+}
+
+async function commandOutput(cwd, args, allowFailure = false) {
+  const result = await runCommand('git', args, { cwd, allowFailure })
+  return result
+}
+
+async function detectDefaultBranch(topLevelPath, fallbackCandidates = ['main', 'master']) {
+  const headRefResult = await commandOutput(topLevelPath, ['symbolic-ref', 'refs/remotes/origin/HEAD'], true)
+  if (headRefResult.exitCode === 0) {
+    const headRef = cleanOutput(headRefResult.stdout)
+    const branchName = headRef.replace('refs/remotes/origin/', '')
+    if (branchName) {
+      return branchName
+    }
+  }
+
+  for (const candidate of fallbackCandidates) {
+    const localRef = await commandOutput(topLevelPath, ['show-ref', '--verify', '--quiet', `refs/heads/${candidate}`], true)
+    if (localRef.exitCode === 0) {
+      return candidate
+    }
+
+    const remoteRef = await commandOutput(topLevelPath, ['show-ref', '--verify', '--quiet', `refs/remotes/origin/${candidate}`], true)
+    if (remoteRef.exitCode === 0) {
+      return candidate
+    }
+  }
+
+  return 'main'
+}
+
+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
+
+  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
+    })
+  }
+
+  const topLevelPath = cleanOutput((await commandOutput(cwd, ['rev-parse', '--show-toplevel'])).stdout)
+  const gitDirRaw = cleanOutput((await commandOutput(cwd, ['rev-parse', '--git-dir'])).stdout)
+  const commonDirRaw = cleanOutput((await commandOutput(cwd, ['rev-parse', '--git-common-dir'])).stdout)
+  const currentBranch = cleanOutput((await commandOutput(topLevelPath, ['branch', '--show-current'], true)).stdout)
+  const superproject = cleanOutput((await commandOutput(cwd, ['rev-parse', '--show-superproject-working-tree'], true)).stdout)
+
+  const inheritedFromParent = path.resolve(cwd) !== path.resolve(topLevelPath)
+  // strict 模式用于“防误操作”场景：如果当前目录只是父仓库的子目录，直接阻断。
+  if (repoMode === 'strict' && inheritedFromParent) {
+    throw new IcodeError(
+      `检测到父级仓库继承: 当前目录 ${cwd} 实际仓库根目录为 ${topLevelPath}。strict 模式已阻止继续执行。`,
+      {
+        code: 'PARENT_REPO_INHERITED',
+        exitCode: 2
+      }
+    )
+  }
+
+  const gitDir = path.isAbsolute(gitDirRaw) ? gitDirRaw : path.resolve(topLevelPath, gitDirRaw)
+  const commonDir = path.isAbsolute(commonDirRaw) ? commonDirRaw : path.resolve(topLevelPath, commonDirRaw)
+
+  const configuredHookPath = cleanOutput((await commandOutput(topLevelPath, ['config', '--get', 'core.hooksPath'], true)).stdout)
+  // hooksPath 可能是相对路径，也可能是绝对路径，统一转成绝对路径便于后续检测。
+  const hookPath = configuredHookPath
+    ? (path.isAbsolute(configuredHookPath) ? configuredHookPath : path.resolve(topLevelPath, configuredHookPath))
+    : path.resolve(gitDir, 'hooks')
+
+  const hasHuskyFolder = fs.existsSync(path.resolve(topLevelPath, '.husky'))
+  const hasHookPath = fs.existsSync(hookPath)
+
+  const defaultBranch = await detectDefaultBranch(
+    topLevelPath,
+    config.defaults?.defaultMainBranches || ['main', 'master']
+  )
+
+  return {
+    cwd,
+    repoMode,
+    topLevelPath,
+    gitDir,
+    commonDir,
+    currentBranch,
+    defaultBranch,
+    inheritedFromParent,
+    hasHuskyFolder,
+    hookPath,
+    hasHookPath,
+    isSubmodule: Boolean(superproject),
+    superprojectPath: superproject || null
+  }
+}