@auto-ai/agent 2.1.97 → 2.1.101

package/tools-runtime/code-tool/src/index.ts

@@ -0,0 +1,204 @@
+import { mkdir, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { z } from 'zod/v4'
+import { runApply } from './actions/apply.js'
+import { runInspect } from './actions/inspect.js'
+import { runPrepare } from './actions/prepare.js'
+import { runRead } from './actions/read.js'
+import { runRecord } from './actions/record.js'
+import { runScript } from './actions/run.js'
+import { runSearch } from './actions/search.js'
+import { runStatus } from './actions/status.js'
+import { configure, requireCodeWorkDir, resetConfigure, getCachedConfigure } from './hooks.js'
+import { buildCodeToolSessionAppend } from './sessionAppend.js'
+import { initWsSession } from './wsInit.js'
+
+export { configure, resetConfigure, initWsSession, buildCodeToolSessionAppend }
+export { resolveCodeWorkDir } from './workspace.js'
+export type { CodeToolConfigureHooks } from './hooks.js'
+export { isEnabledInAgentConfig } from './agentConfig.js'
+export type { CodeToolWsInitContext, CodeToolWsInitResult } from './wsInit.js'
+
+export function ensureConfigured(): void {
+  const cached = getCachedConfigure()
+  if (cached) {
+    configure(cached)
+  }
+}
+
+const inputSchema = z.discriminatedUnion('action', [
+  z.object({
+    action: z.literal('prepare'),
+  }),
+  z.object({
+    action: z.literal('inspect'),
+    brief: z.boolean().optional(),
+  }),
+  z.object({
+    action: z.literal('record'),
+    section: z.string().min(1),
+    content: z.string().min(1),
+    mode: z.enum(['upsert', 'append']).default('upsert'),
+  }),
+  z.object({
+    action: z.literal('read'),
+    path: z.string().min(1),
+    offset: z.number().int().positive().optional(),
+    limit: z.number().int().positive().optional(),
+  }),
+  z.object({
+    action: z.literal('search'),
+    pattern: z.string().min(1),
+    glob: z.string().optional(),
+  }),
+  z.object({
+    action: z.literal('apply'),
+    patches: z
+      .array(
+        z.object({
+          path: z.string().min(1),
+          old_string: z.string(),
+          new_string: z.string(),
+        }),
+      )
+      .min(1),
+  }),
+  z.object({
+    action: z.literal('run'),
+    script: z.string().min(1),
+  }),
+  z.object({
+    action: z.literal('status'),
+  }),
+])
+
+async function writeResult(
+  toolResultsDir: string | undefined,
+  payload: unknown,
+): Promise<string | undefined> {
+  if (!toolResultsDir) return undefined
+  await mkdir(toolResultsDir, { recursive: true })
+  const file = join(toolResultsDir, `code-tool-${Date.now()}.json`)
+  await writeFile(file, JSON.stringify(payload, null, 2), 'utf8')
+  return file
+}
+
+export const CodeTool = {
+  name: 'CodeTool',
+  description: async () =>
+    '代码开发工作区：加载 code.md、读写仓库、record 沉淀、受控脚本',
+  prompt: async () => {
+    let dir = '(未配置)'
+    try {
+      dir = requireCodeWorkDir()
+    } catch {
+      // init 前 prompt 序列化
+    }
+    return `# CodeTool — 代码开发（唯一入口，codeWorkDir=${dir}）
+
+项目规范来自 **code.md**（本工具加载与维护）。禁止对 codeWorkDir 内业务文件使用裸 Read/Edit/Write/Glob/Grep。
+
+## action 分工
+| action | 用途 |
+| prepare | 确认 codeWorkDir |
+| inspect | 加载 code.md + 项目摘要（涉及仓库的开发/分析前必调） |
+| read / search | 读代码、搜内容 |
+| apply | 受控补丁改业务文件（禁止改 code.md） |
+| run | package.json scripts 白名单 |
+| record | 增量更新 code.md |
+| status | git 简要状态 |
+
+## 标准流程
+1. prepare → inspect
+2. 若无 code.md：record 首建 overview、commands（可据 inspect 的 tree/manifest）
+3. read/search 理解 → apply 修改 → run 验证
+4. 发现非显而易见信息时 record（architecture / commands / patterns / gotchas）
+5. 任务完成前 record 收尾；需 clone/commit 等用 GitTool
+
+## record 时机
+- 摸清模块/调用链 → section architecture
+- 非常规 build/test/环境 → commands、gotchas
+- 可复用改法 → patterns
+- 删掉后下次会做错才写，不写显而易见内容`
+  },
+  inputSchema,
+  maxResultSizeChars: 120_000,
+  isEnabled: () => true,
+  isReadOnly: (input: z.infer<typeof inputSchema>) =>
+    input.action === 'inspect' ||
+    input.action === 'read' ||
+    input.action === 'search' ||
+    input.action === 'status' ||
+    input.action === 'prepare',
+  isConcurrencySafe: (input: z.infer<typeof inputSchema>) =>
+    input.action === 'inspect' || input.action === 'read' || input.action === 'search',
+  isDestructive: (input: z.infer<typeof inputSchema>) =>
+    input.action === 'apply' || input.action === 'record' || input.action === 'run',
+  checkPermissions: async () => ({ behavior: 'ask' as const, updatedInput: {} }),
+  validateInput: async (input: unknown) => {
+    const parsed = inputSchema.safeParse(input)
+    if (!parsed.success) {
+      return {
+        result: false as const,
+        message: parsed.error.message,
+        errorCode: 0,
+      }
+    }
+    try {
+      requireCodeWorkDir()
+      return { result: true as const }
+    } catch (e) {
+      return {
+        result: false as const,
+        message: e instanceof Error ? e.message : String(e),
+        errorCode: 0,
+      }
+    }
+  },
+  call: async (input: z.infer<typeof inputSchema>, ctx: { toolResultsDir?: string }) => {
+    let data: Record<string, unknown>
+    switch (input.action) {
+      case 'prepare':
+        data = await runPrepare()
+        break
+      case 'inspect':
+        data = await runInspect(Boolean(input.brief))
+        break
+      case 'record':
+        data = await runRecord({
+          section: input.section,
+          content: input.content,
+          mode: input.mode,
+        })
+        break
+      case 'read':
+        data = await runRead(input.path, input.offset, input.limit)
+        break
+      case 'search':
+        data = await runSearch(input.pattern, input.glob)
+        break
+      case 'apply':
+        data = await runApply(input.patches)
+        break
+      case 'run':
+        data = await runScript(input.script)
+        break
+      case 'status':
+        data = await runStatus()
+        break
+      default:
+        throw new Error('unknown action')
+    }
+    const resultFile = await writeResult(ctx.toolResultsDir, data)
+    return { data: { ...data, resultFile } }
+  },
+  renderToolUseMessage: (input: { action?: string }) =>
+    `CodeTool: ${input.action ?? '…'}`,
+  renderToolResultMessage: () => 'CodeTool 完成',
+  mapToolResultToToolResultBlockParam: (output: { data?: Record<string, unknown> }) => ({
+    type: 'text' as const,
+    text: JSON.stringify(output.data ?? output, null, 2),
+  }),
+}
+
+export default CodeTool

package/tools-runtime/code-tool/src/memory/constants.ts

@@ -0,0 +1,13 @@
+/** 项目指令文件名（替代 CLAUDE.md） */
+export const CODE_MD = 'code.md'
+export const CODE_LOCAL_MD = 'code.local.md'
+export const CODE_MD_IN_CLAUDE_DIR = '.claude/code.md'
+export const RULES_DIR = '.claude/rules'
+
+export const MEMORY_INSTRUCTION_PROMPT =
+  'Codebase and user instructions are shown below. Be sure to adhere to these instructions. IMPORTANT: These instructions OVERRIDE any default behavior and you MUST follow them exactly as written.'
+
+/** 与宿主 claudemd 一致的单文件体积上限 */
+export const MAX_MEMORY_CHARACTER_COUNT = 40_000
+
+export const MAX_INCLUDE_DEPTH = 5

package/tools-runtime/code-tool/src/memory/loadCodeMd.ts

@@ -0,0 +1,194 @@
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { dirname, join, parse, relative } from 'node:path'
+import {
+  CODE_LOCAL_MD,
+  CODE_MD,
+  CODE_MD_IN_CLAUDE_DIR,
+  MAX_MEMORY_CHARACTER_COUNT,
+  MEMORY_INSTRUCTION_PROMPT,
+  RULES_DIR,
+} from './constants.js'
+import type { MemoryFileInfo, MemoryType } from './types.js'
+
+type LoadOptions = {
+  projectRoot: string
+  excludes?: string[]
+  maxChars?: number
+}
+
+/** 简单 frontmatter 剥离（paths 行忽略，全文作为 content） */
+function stripFrontmatter(raw: string): { content: string; globs?: string[] } {
+  if (!raw.startsWith('---')) {
+    return { content: raw }
+  }
+  const end = raw.indexOf('---', 3)
+  if (end === -1) {
+    return { content: raw }
+  }
+  const body = raw.slice(end + 3).replace(/^\n/, '')
+  const fm = raw.slice(3, end)
+  const pathsMatch = fm.match(/^paths:\s*(.+)$/m)
+  if (!pathsMatch) {
+    return { content: body }
+  }
+  const paths = pathsMatch[1]
+    .split(',')
+    .map(p => p.trim())
+    .filter(p => p.length > 0 && p !== '**')
+  return { content: body, globs: paths.length > 0 ? paths : undefined }
+}
+
+function normalizePath(p: string): string {
+  return p.replaceAll('\\', '/')
+}
+
+/** 路径是否被 exclude  glob 命中（简单前缀/包含匹配） */
+function isExcluded(filePath: string, excludes: string[]): boolean {
+  if (excludes.length === 0) return false
+  const norm = normalizePath(filePath)
+  for (const pat of excludes) {
+    const p = normalizePath(pat.trim())
+    if (!p) continue
+    if (p.includes('*')) {
+      if (norm.includes(p.replace(/\*\*/g, '').replace(/\*/g, ''))) return true
+    } else if (norm === p || norm.endsWith(p)) {
+      return true
+    }
+  }
+  return false
+}
+
+async function fileExists(path: string): Promise<boolean> {
+  try {
+    await stat(path)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function readMemoryFile(
+  filePath: string,
+  type: MemoryType,
+): Promise<MemoryFileInfo | null> {
+  try {
+    const raw = await readFile(filePath, 'utf8')
+    const trimmed = raw.trim()
+    if (!trimmed) return null
+    const { content, globs } = stripFrontmatter(raw)
+    if (!content.trim()) return null
+    return { path: filePath, type, content, globs }
+  } catch {
+    return null
+  }
+}
+
+/** 递归加载 .claude/rules 下无条件 .md */
+async function loadRulesDir(
+  rulesDir: string,
+  type: MemoryType,
+  processed: Set<string>,
+): Promise<MemoryFileInfo[]> {
+  const out: MemoryFileInfo[] = []
+  let entries: import('node:fs').Dirent[]
+  try {
+    entries = await readdir(rulesDir, { withFileTypes: true })
+  } catch {
+    return out
+  }
+  for (const e of entries) {
+    const p = join(rulesDir, e.name)
+    if (e.isDirectory()) {
+      out.push(...(await loadRulesDir(p, type, processed)))
+    } else if (e.isFile() && e.name.endsWith('.md')) {
+      const key = normalizePath(p)
+      if (processed.has(key)) continue
+      processed.add(key)
+      const info = await readMemoryFile(p, type)
+      if (info && !info.globs) out.push(info)
+    }
+  }
+  return out
+}
+
+/**
+ * 从 projectRoot 向上遍历，加载 code.md / code.local.md / .claude/code.md / rules。
+ * 业务语义：替代宿主 claudemd.getMemoryFiles + getClaudeMds，仅认 code.md 文件名。
+ */
+export async function collectMemoryFiles(
+  projectRoot: string,
+  excludes: string[] = [],
+): Promise<MemoryFileInfo[]> {
+  const result: MemoryFileInfo[] = []
+  const processed = new Set<string>()
+
+  const dirs: string[] = []
+  let cur = projectRoot
+  const root = parse(cur).root
+  while (cur !== root) {
+    dirs.push(cur)
+    cur = dirname(cur)
+  }
+  dirs.reverse()
+
+  for (const dir of dirs) {
+    const candidates: { path: string; type: MemoryType }[] = [
+      { path: join(dir, CODE_MD), type: 'Project' },
+      { path: join(dir, '.claude', 'code.md'), type: 'Project' },
+      { path: join(dir, CODE_LOCAL_MD), type: 'Local' },
+    ]
+    for (const { path, type } of candidates) {
+      if (isExcluded(path, excludes)) continue
+      const key = normalizePath(path)
+      if (processed.has(key)) continue
+      if (!(await fileExists(path))) continue
+      processed.add(key)
+      const info = await readMemoryFile(path, type)
+      if (info) result.push(info)
+    }
+    const rulesPath = join(dir, RULES_DIR)
+    result.push(...(await loadRulesDir(rulesPath, 'Project', processed)))
+  }
+
+  return result
+}
+
+export function formatCodeMd(memoryFiles: MemoryFileInfo[]): string {
+  const parts: string[] = []
+  for (const file of memoryFiles) {
+    const content = file.content.trim()
+    if (!content) continue
+    const desc =
+      file.type === 'Project'
+        ? ' (project instructions, checked into the codebase)'
+        : " (user's private project instructions, not checked in)"
+    parts.push(`Contents of ${file.path}${desc}:\n\n${content}`)
+  }
+  if (parts.length === 0) return ''
+  return `${MEMORY_INSTRUCTION_PROMPT}\n\n${parts.join('\n\n')}`
+}
+
+/**
+ * 加载并格式化 code.md 记忆文本。
+ */
+export async function loadCodeMd(options: LoadOptions): Promise<string> {
+  const files = await collectMemoryFiles(
+    options.projectRoot,
+    options.excludes ?? [],
+  )
+  let text = formatCodeMd(files)
+  const max = options.maxChars ?? MAX_MEMORY_CHARACTER_COUNT
+  if (text.length > max) {
+    text = `${text.slice(0, max)}\n\n[truncated: code memory exceeded ${max} characters]`
+  }
+  return text
+}
+
+/** inspect 用：是否已有根 code.md */
+export async function hasRootCodeMd(projectRoot: string): Promise<boolean> {
+  return fileExists(join(projectRoot, CODE_MD))
+}
+
+export function getCodeMdPath(projectRoot: string): string {
+  return join(projectRoot, CODE_MD)
+}

package/tools-runtime/code-tool/src/memory/types.ts

@@ -0,0 +1,9 @@
+export type MemoryType = 'Project' | 'Local' | 'User' | 'Managed'
+
+export type MemoryFileInfo = {
+  path: string
+  type: MemoryType
+  content: string
+  parent?: string
+  globs?: string[]
+}

package/tools-runtime/code-tool/src/mergeSection.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, test } from 'bun:test'
+import { mergeSectionIntoCodeMd, assertWithinSize } from './mergeSection.js'
+import { buildInitialCodeMdTemplate } from './codeMdTemplate.js'
+
+describe('mergeSection', () => {
+  test('upsert architecture section', () => {
+    const base = buildInitialCodeMdTemplate()
+    const out = mergeSectionIntoCodeMd(
+      base,
+      'architecture',
+      '模块 A 在 src/a',
+      'upsert',
+    )
+    expect(out).toContain('## architecture')
+    expect(out).toContain('模块 A 在 src/a')
+  })
+
+  test('append adds dated line', () => {
+    const base = '## gotchas\n\n'
+    const out = mergeSectionIntoCodeMd(base, 'gotchas', 'need env', 'append')
+    expect(out).toContain('need env')
+    expect(out).toMatch(/-\s+\d{4}-\d{2}-\d{2}:/)
+  })
+
+  test('assertWithinSize throws when too large', () => {
+    expect(() => assertWithinSize('x'.repeat(50_000))).toThrow()
+  })
+})

package/tools-runtime/code-tool/src/mergeSection.ts

@@ -0,0 +1,68 @@
+import { MAX_MEMORY_CHARACTER_COUNT } from './memory/constants.js'
+
+const KNOWN_SECTIONS = new Set([
+  'overview',
+  'architecture',
+  'commands',
+  'gotchas',
+  'patterns',
+  'learnings',
+])
+
+function normalizeHeading(name: string): string {
+  return name.trim().toLowerCase()
+}
+
+/**
+ * 将 content 合并进 markdown 的 ## section。
+ * mode=upsert 替换该节正文；append 在节末追加带日期的列表项。
+ */
+export function mergeSectionIntoCodeMd(
+  existing: string,
+  section: string,
+  content: string,
+  mode: 'upsert' | 'append',
+): string {
+  const key = normalizeHeading(section)
+  const heading =
+    key === 'learnings' || !KNOWN_SECTIONS.has(key)
+      ? 'Learnings'
+      : section.charAt(0).toUpperCase() + section.slice(1).toLowerCase()
+
+  const sectionRegex = new RegExp(
+    `(^##\\s+${escapeRegExp(heading)}\\s*$)([\\s\\S]*?)(?=^##\\s+|\\Z)`,
+    'im',
+  )
+  const trimmedContent = content.trim()
+  const dateLine = `- ${new Date().toISOString().slice(0, 10)}: ${trimmedContent.replace(/\n/g, ' ')}`
+
+  if (sectionRegex.test(existing)) {
+    return existing.replace(sectionRegex, (_m, h: string, body: string) => {
+      const prev = body.trim()
+      if (mode === 'append') {
+        if (prev.includes(trimmedContent)) return `${h}\n\n${prev}\n`
+        return `${h}\n\n${prev}\n${dateLine}\n`
+      }
+      return `${h}\n\n${trimmedContent}\n\n`
+    })
+  }
+
+  const block =
+    mode === 'append'
+      ? `## ${heading}\n\n${dateLine}\n`
+      : `## ${heading}\n\n${trimmedContent}\n`
+  return `${existing.trimEnd()}\n\n${block}`
+}
+
+function escapeRegExp(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+/** 合并后超过上限则抛错（fail-fast） */
+export function assertWithinSize(text: string): void {
+  if (text.length > MAX_MEMORY_CHARACTER_COUNT) {
+    throw new Error(
+      `code.md 超过 ${MAX_MEMORY_CHARACTER_COUNT} 字符，请精简后再 record`,
+    )
+  }
+}

package/tools-runtime/code-tool/src/pathGuard.ts

@@ -0,0 +1,31 @@
+import { isAbsolute, join, normalize, relative, resolve } from 'node:path'
+import { CODE_LOCAL_MD, CODE_MD } from './memory/constants.js'
+
+/** 业务仓库内相对路径校验，禁止逃逸 codeWorkDir */
+export function resolveInWorkDir(
+  codeWorkDir: string,
+  relPath: string,
+): string {
+  const base = resolve(codeWorkDir)
+  const target = resolve(base, normalize(relPath))
+  const rel = relative(base, target)
+  if (rel.startsWith('..') || isAbsolute(rel)) {
+    throw new Error(`路径越界: ${relPath}`)
+  }
+  return target
+}
+
+/** apply 禁止修改 code.md / code.local.md */
+export function assertApplyPathAllowed(relPath: string): void {
+  const norm = relPath.replaceAll('\\', '/')
+  const base = norm.split('/').pop() ?? norm
+  if (base === CODE_MD || base === CODE_LOCAL_MD) {
+    throw new Error(
+      `禁止通过 apply 修改 ${base}，请使用 CodeTool action=record`,
+    )
+  }
+}
+
+export function getCodeMdAbsolutePath(codeWorkDir: string): string {
+  return join(resolve(codeWorkDir), CODE_MD)
+}

package/tools-runtime/code-tool/src/projectScan.ts

@@ -0,0 +1,61 @@
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { join } from 'node:path'
+
+const MANIFEST_NAMES = [
+  'package.json',
+  'go.mod',
+  'Cargo.toml',
+  'pyproject.toml',
+  'pom.xml',
+  'Makefile',
+]
+
+/** 扫描项目 manifest 与浅层目录树，供 inspect 使用 */
+export async function scanProjectBrief(
+  codeWorkDir: string,
+  maxDepth = 2,
+): Promise<{ manifests: Record<string, string>; tree: string[] }> {
+  const manifests: Record<string, string> = {}
+  for (const name of MANIFEST_NAMES) {
+    const p = join(codeWorkDir, name)
+    try {
+      const st = await stat(p)
+      if (st.isFile()) {
+        const raw = await readFile(p, 'utf8')
+        manifests[name] = raw.length > 8000 ? `${raw.slice(0, 8000)}…` : raw
+      }
+    } catch {
+      // 不存在则跳过
+    }
+  }
+  const tree: string[] = []
+  await walkDir(codeWorkDir, '', 0, maxDepth, tree)
+  return { manifests, tree }
+}
+
+async function walkDir(
+  root: string,
+  rel: string,
+  depth: number,
+  maxDepth: number,
+  out: string[],
+): Promise<void> {
+  if (depth > maxDepth) return
+  const full = rel ? join(root, rel) : root
+  let entries: import('node:fs').Dirent[]
+  try {
+    entries = await readdir(full, { withFileTypes: true })
+  } catch {
+    return
+  }
+  const sorted = entries
+    .filter(e => !e.name.startsWith('.') && e.name !== 'node_modules')
+    .sort((a, b) => a.name.localeCompare(b.name))
+  for (const e of sorted.slice(0, 40)) {
+    const childRel = rel ? `${rel}/${e.name}` : e.name
+    out.push(`${'  '.repeat(depth)}${e.name}${e.isDirectory() ? '/' : ''}`)
+    if (e.isDirectory() && depth < maxDepth) {
+      await walkDir(root, childRel, depth + 1, maxDepth, out)
+    }
+  }
+}

package/tools-runtime/code-tool/src/sessionAppend.ts

@@ -0,0 +1,38 @@
+/**
+ * 会话级 system append：替代 code-dev Skill 的 shell 注入。
+ * 在宿主 configureCodeRuntimeTool 之后调用。
+ */
+import { runInspect } from './actions/inspect.js'
+
+/** 生成首轮 appendSystemPrompt 中的 CodeTool 上下文（inspect --brief） */
+export async function buildCodeToolSessionAppend(): Promise<string> {
+  const data = await runInspect(true)
+  const lines: string[] = [
+    'System reminder: 本会话已启用 CodeTool，业务代码仓库是唯一开发入口。',
+    '分析/阅读/修改仓库、架构文档、code.md 时必须使用 CodeTool，禁止对 codeWorkDir 使用裸 Read/Edit/Write/Glob/Grep/Bash 改业务文件。',
+    '标准流程：prepare → inspect → read/search → apply → run；无 code.md 时用 record 首建 overview/commands；复杂 git 用 GitTool（若已启用）。',
+    `codeWorkDir: ${String(data.codeWorkDir ?? '')}`,
+  ]
+
+  const mem = String(data.codeMemory ?? '').trim()
+  if (mem) {
+    lines.push('', '## code.md 摘要', mem)
+  } else {
+    lines.push(
+      '',
+      '（尚无 code.md；开发任务开始后请 CodeTool action=record 首建并写入 overview/commands）',
+    )
+  }
+
+  const tree = data.tree
+  if (Array.isArray(tree) && tree.length > 0) {
+    lines.push('', '## 仓库目录（摘要）', ...tree.slice(0, 30).map(String))
+  }
+
+  const manifests = data.manifests
+  if (Array.isArray(manifests) && manifests.length > 0) {
+    lines.push('', '## 清单文件', manifests.join(', '))
+  }
+
+  return lines.join('\n')
+}

package/tools-runtime/code-tool/src/workspace.ts

@@ -0,0 +1,24 @@
+/**
+ * Code 工作目录解析：与 GitTool 共用 WS_GIT_WORK_DIR / operWorkspaceDir/repo 约定，两包互不 import。
+ */
+
+import { isAbsolute, join } from 'node:path'
+
+const CODE_REPO_SUBDIR = 'repo'
+
+/**
+ * 解析代码工作目录：优先 CODE_WORK_DIR，其次 WS_GIT_WORK_DIR，默认 operWorkspaceDir/repo。
+ */
+export function resolveCodeWorkDir(operWorkspaceDir: string): string {
+  const fromCode = process.env.CODE_WORK_DIR?.trim() ?? ''
+  if (fromCode) {
+    return isAbsolute(fromCode)
+      ? fromCode
+      : join(operWorkspaceDir, fromCode)
+  }
+  const fromGit = process.env.WS_GIT_WORK_DIR?.trim() ?? ''
+  if (!fromGit) {
+    return join(operWorkspaceDir, CODE_REPO_SUBDIR)
+  }
+  return isAbsolute(fromGit) ? fromGit : join(operWorkspaceDir, fromGit)
+}