@fitlab-ai/agent-infra 0.7.3 → 0.7.5

package/dist/lib/task/resolve-ref.js

@@ -0,0 +1,150 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync, spawnSync } from 'node:child_process';
+import { normalizeShortIdInput } from "./short-id.js";
+const TASK_ID_RE = /^TASK-\d{8}-\d{6}$/;
+// Flat-structured workspace dirs that hold tasks under `{dir}/{taskId}/task.md`.
+// Note: `archive` uses a three-level YYYY/MM/DD layout and is handled separately.
+const FLAT_WORKSPACE_DIRS = ['active', 'blocked', 'completed'];
+function detectRepoRoot() {
+    try {
+        return execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        }).trim();
+    }
+    catch {
+        throw new Error('ai task: current directory is not inside a git repository');
+    }
+}
+function readShortIdLength(repoRoot) {
+    try {
+        const cfg = JSON.parse(fs.readFileSync(path.join(repoRoot, '.agents', '.airc.json'), 'utf8'));
+        const v = cfg?.task?.shortIdLength;
+        if (typeof v === 'number' && Number.isFinite(v) && v >= 1)
+            return v;
+    }
+    catch {
+        // fall through to default
+    }
+    return 2;
+}
+function resolveShortIdToTaskId(arg, repoRoot) {
+    const scriptPath = path.join(repoRoot, '.agents', 'scripts', 'task-short-id.js');
+    if (!fs.existsSync(scriptPath)) {
+        throw new Error(`task-short-id.js not found at ${scriptPath}`);
+    }
+    const result = spawnSync('node', [scriptPath, 'resolve', arg], {
+        encoding: 'utf8',
+        cwd: repoRoot
+    });
+    if (result.status !== 0) {
+        throw new Error((result.stderr || '').trim() || `failed to resolve '${arg}'`);
+    }
+    return result.stdout.trim();
+}
+function listSortedNumeric(dir, width) {
+    if (!fs.existsSync(dir))
+        return [];
+    const pattern = new RegExp(`^\\d{${width}}$`);
+    return fs
+        .readdirSync(dir)
+        .filter((entry) => pattern.test(entry))
+        .sort()
+        .reverse();
+}
+function findInArchive(repoRoot, taskId) {
+    // archive-tasks SKILL writes to .agents/workspace/archive/YYYY/MM/DD/{taskId}/task.md
+    // where YYYY/MM/DD comes from completed_at (or updated_at fallback) — NOT from
+    // the task id's creation date. So we cannot derive the path from taskId alone;
+    // walk the bounded YYYY/MM/DD tree instead. Newest-first to favor recent archives.
+    const archiveDir = path.join(repoRoot, '.agents', 'workspace', 'archive');
+    for (const year of listSortedNumeric(archiveDir, 4)) {
+        const yearDir = path.join(archiveDir, year);
+        for (const month of listSortedNumeric(yearDir, 2)) {
+            const monthDir = path.join(yearDir, month);
+            for (const day of listSortedNumeric(monthDir, 2)) {
+                const candidate = path.join(monthDir, day, taskId, 'task.md');
+                if (fs.existsSync(candidate))
+                    return candidate;
+            }
+        }
+    }
+    return null;
+}
+function findTaskMd(repoRoot, taskId) {
+    for (const sub of FLAT_WORKSPACE_DIRS) {
+        const candidate = path.join(repoRoot, '.agents', 'workspace', sub, taskId, 'task.md');
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return findInArchive(repoRoot, taskId);
+}
+/**
+ * Enumerate every task directory under the flat workspace states
+ * (active / blocked / completed) — archive is intentionally excluded so a
+ * full-tree scan never pulls in cold data. Ordered by state, then task id
+ * ascending, giving callers a deterministic traversal.
+ */
+function enumerateTaskDirs(repoRoot) {
+    const out = [];
+    for (const sub of FLAT_WORKSPACE_DIRS) {
+        const base = path.join(repoRoot, '.agents', 'workspace', sub);
+        if (!fs.existsSync(base))
+            continue;
+        for (const entry of fs.readdirSync(base).sort()) {
+            if (!TASK_ID_RE.test(entry))
+                continue;
+            const taskDir = path.join(base, entry);
+            if (!fs.existsSync(path.join(taskDir, 'task.md')))
+                continue;
+            out.push({ taskId: entry, taskDir });
+        }
+    }
+    return out;
+}
+/**
+ * Resolve a task ref (bare short id, `#N`, or `TASK-YYYYMMDD-HHMMSS`) to its
+ * task directory across active / blocked / completed / archive.
+ *
+ * The returned `message` on failure is command-agnostic (no `ai task <cmd>:`
+ * prefix); callers prepend their own prefix so each command keeps its existing
+ * stderr wording byte-for-byte.
+ */
+function resolveTaskRef(arg) {
+    const repoRoot = detectRepoRoot();
+    let taskId;
+    if (TASK_ID_RE.test(arg)) {
+        taskId = arg;
+    }
+    else {
+        const shortIdLength = readShortIdLength(repoRoot);
+        const normalized = normalizeShortIdInput(arg, { shortIdLength });
+        if (normalized.kind === 'error') {
+            return { ok: false, message: normalized.message };
+        }
+        if (normalized.kind === 'pass') {
+            return {
+                ok: false,
+                message: `'${arg}' is not a valid short id or TASK-id; ` +
+                    `expected bare digits, '#N', or 'TASK-YYYYMMDD-HHMMSS'`
+            };
+        }
+        try {
+            taskId = resolveShortIdToTaskId(normalized.value, repoRoot);
+        }
+        catch (e) {
+            return { ok: false, message: e.message };
+        }
+    }
+    const taskMdPath = findTaskMd(repoRoot, taskId);
+    if (!taskMdPath) {
+        return {
+            ok: false,
+            message: `task ${taskId} not found in active / blocked / completed / archive`
+        };
+    }
+    return { ok: true, repoRoot, taskId, taskDir: path.dirname(taskMdPath), taskMdPath };
+}
+export { resolveTaskRef, detectRepoRoot, enumerateTaskDirs, TASK_ID_RE };
+//# sourceMappingURL=resolve-ref.js.map

package/dist/lib/update.js

@@ -83,7 +83,7 @@ function syncFileRegistry(config, platformType, enabledTUIs) {
 }
 async function cmdUpdate() {
     console.log('');
-    console.log('  agent-infra update');
+    console.log('  ai update');
     console.log('  ==================================');
     console.log('');
     // check config exists

package/lib/init.ts

@@ -119,7 +119,7 @@ function parseLocalSources(input: string): SourceEntry[] {
 
 async function cmdInit(): Promise<void> {
   console.log('');
-  console.log('  agent-infra init');
+  console.log('  ai init');
   console.log('  ================================');
   console.log('  Optional template and skill sources can be added now or later in .agents/.airc.json.');
   console.log('');

package/lib/merge.ts

@@ -901,7 +901,7 @@ function printReport(report: MergeReport): void {
 async function cmdMerge(args: string[]): Promise<void> {
   const sourcePath = args[0];
   if (!sourcePath) {
-    throw new Error('Usage: agent-infra merge <source-path>');
+    throw new Error('Usage: ai merge <source-path>');
   }
 
   const resolvedSource = path.resolve(sourcePath);

package/lib/sandbox/commands/create.ts

@@ -840,7 +840,34 @@ export function ensureClaudeSettings(toolDir: string, hostHomeDir?: string): voi
   }
 }
 
-export function ensureCodexModelInheritance(toolDir: string, hostHomeDir?: string): void {
+function resolveHostCatalogPath(value: unknown, hostHomeDir: string): string | null {
+  if (typeof value !== 'string' || value === '') {
+    return null;
+  }
+  let resolved: string;
+  if (value === '~' || value.startsWith('~/') || value.startsWith('~\\')) {
+    resolved = path.join(hostHomeDir, value.slice(1).replace(/^[/\\]+/, ''));
+  } else if (path.isAbsolute(value)) {
+    resolved = value;
+  } else {
+    resolved = path.join(hostHomeDir, '.codex', value);
+  }
+  try {
+    if (!fs.statSync(resolved).isFile()) {
+      return null;
+    }
+    fs.accessSync(resolved, fs.constants.R_OK);
+    return resolved;
+  } catch {
+    return null;
+  }
+}
+
+export function ensureCodexModelInheritance(
+  toolDir: string,
+  hostHomeDir?: string,
+  containerCodexDir: string = '/home/devuser/.codex'
+): void {
   if (!hostHomeDir) {
     return;
   }
@@ -890,6 +917,22 @@ export function ensureCodexModelInheritance(toolDir: string, hostHomeDir?: strin
     changed = true;
   }
 
+  if (!Object.hasOwn(sandboxParsed, 'model_catalog_json')) {
+    const hostCatalogPath = resolveHostCatalogPath(hostParsed['model_catalog_json'], hostHomeDir);
+    if (hostCatalogPath) {
+      try {
+        const basename = path.basename(hostCatalogPath);
+        const destDir = path.join(toolDir, 'model-catalogs');
+        fs.mkdirSync(destDir, { recursive: true });
+        fs.copyFileSync(hostCatalogPath, path.join(destDir, basename));
+        sandboxParsed['model_catalog_json'] = path.posix.join(containerCodexDir, 'model-catalogs', basename);
+        changed = true;
+      } catch {
+        // Copy failed (e.g. permissions): skip catalog, keep scalar inheritance intact.
+      }
+    }
+  }
+
   if (changed) {
     fs.writeFileSync(sandboxConfigPath, `${toml.stringify(sandboxParsed)}\n`, 'utf8');
   }
@@ -1042,7 +1085,7 @@ function runEngineTaskCommand(engine: string, cmd: string, args: string[], opts:
 }
 
 export function buildImage(
-  config: SandboxCreateConfig,
+  config: Pick<SandboxCreateConfig, 'project' | 'imageName' | 'repoRoot'> & { engine?: string | null },
   tools: SandboxTool[],
   dockerfilePath: string,
   imageSignature: string,
@@ -1060,7 +1103,7 @@ export function buildImage(
     env?: NodeJS.ProcessEnv;
   } = {}
 ): void {
-  const selectedEngine = engine ?? detectEngine(config);
+  const selectedEngine = engine ?? detectEngine({ engine: config.engine });
   const { uid: hostUid, gid: hostGid } = resolveBuildUid({
     engine: selectedEngine,
     runFn,
@@ -1342,7 +1385,7 @@ export async function create(args: string[]): Promise<void> {
             }
             const codexEntry = effectiveResolvedTools.find(({ tool }) => tool.id === 'codex');
             if (codexEntry) {
-              ensureCodexModelInheritance(codexEntry.dir, effectiveConfig.home);
+              ensureCodexModelInheritance(codexEntry.dir, effectiveConfig.home, codexEntry.tool.containerMount);
               ensureCodexWorkspaceTrust(codexEntry.dir);
             }
             const geminiEntry = effectiveResolvedTools.find(({ tool }) => tool.id === 'gemini-cli');

package/lib/sandbox/commands/rm.ts

@@ -21,15 +21,27 @@ import { runOk, runSafe, runSafeEngine } from '../shell.ts';
 import { resolveTaskBranch } from '../task-resolver.ts';
 import { resolveTools, toolConfigDirCandidates, toolProjectDirCandidates } from '../tools.ts';
 import type { SandboxTool } from '../tools.ts';
+import { fetchSandboxRows } from './list-running.ts';
+import { lookupShortIdByBranch } from '../../task/short-id.ts';
 
-const USAGE = `Usage: ai sandbox rm <branch> [--all]`;
+const USAGE = `Usage:
+  ai sandbox rm <branch>                    Remove one sandbox (branch | TASK-id | short id)
+  ai sandbox rm --all [--dry-run] [--yes]   Remove every sandbox not bound to an active task
+  ai sandbox rm --purge                     Tear down ALL sandboxes for the project (containers, worktrees, image, VM)`;
 export { assertManagedPath } from '../managed-fs.ts';
 
 function projectToolDirs(config: SandboxConfig, tools: SandboxTool[]): string[] {
   return tools.flatMap((tool) => toolProjectDirCandidates(tool, config.project));
 }
 
-async function rmOne(config: SandboxConfig, tools: SandboxTool[], branch: string): Promise<void> {
+type RmOneOptions = { assumeYes?: boolean; quiet?: boolean };
+
+async function rmOne(
+  config: SandboxConfig,
+  tools: SandboxTool[],
+  branch: string,
+  options: RmOneOptions = {}
+): Promise<void> {
   assertValidBranchName(branch);
   const engine = detectEngine(config);
   let effectiveBranch = branch;
@@ -39,7 +51,9 @@ async function rmOne(config: SandboxConfig, tools: SandboxTool[], branch: string
     candidates: toolConfigDirCandidates(tool, config.project, branch)
   }));
 
-  p.intro(pc.cyan(`Removing sandbox for ${branch}`));
+  if (!options.quiet) {
+    p.intro(pc.cyan(`Removing sandbox for ${branch}`));
+  }
 
   const existing = runSafeEngine(engine, 'docker', ['ps', '-a', '--format', '{{.Names}}']).split('\n').filter(Boolean);
   const matchedContainers = containerNameCandidates(config, branch)
@@ -74,10 +88,12 @@ async function rmOne(config: SandboxConfig, tools: SandboxTool[], branch: string
 
   const existingWorktrees = worktreeCandidates.filter((candidate) => fs.existsSync(candidate));
   if (existingWorktrees.length > 0) {
-    const shouldRemoveWorktree = await p.confirm({
-      message: `Remove worktree(s): ${existingWorktrees.join(', ')}?`,
-      initialValue: true
-    });
+    const shouldRemoveWorktree = options.assumeYes
+      ? true
+      : await p.confirm({
+          message: `Remove worktree(s): ${existingWorktrees.join(', ')}?`,
+          initialValue: true
+        });
 
     if (p.isCancel(shouldRemoveWorktree)) {
       p.outro('Cancelled');
@@ -89,10 +105,12 @@ async function rmOne(config: SandboxConfig, tools: SandboxTool[], branch: string
         removeWorktreeDir(config.repoRoot, config.worktreeBase, worktree);
       }
 
-      const shouldDeleteBranch = await p.confirm({
-        message: `Also delete local branch '${effectiveBranch}'?`,
-        initialValue: true
-      });
+      const shouldDeleteBranch = options.assumeYes
+        ? true
+        : await p.confirm({
+            message: `Also delete local branch '${effectiveBranch}'?`,
+            initialValue: true
+          });
 
       if (!p.isCancel(shouldDeleteBranch) && shouldDeleteBranch) {
         if (!runOk('git', ['-C', config.repoRoot, 'branch', '-D', effectiveBranch])) {
@@ -116,20 +134,24 @@ async function rmOne(config: SandboxConfig, tools: SandboxTool[], branch: string
 
   const shareBranch = shareBranchDir(config, effectiveBranch);
   if (fs.existsSync(shareBranch)) {
-    const shouldRemoveShare = await p.confirm({
-      message: `Remove share dir for branch '${effectiveBranch}' (${shareBranch})?`,
-      initialValue: true
-    });
+    const shouldRemoveShare = options.assumeYes
+      ? true
+      : await p.confirm({
+          message: `Remove share dir for branch '${effectiveBranch}' (${shareBranch})?`,
+          initialValue: true
+        });
     if (!p.isCancel(shouldRemoveShare) && shouldRemoveShare) {
       removeManagedDir(config.shareBase, shareBranch);
       p.log.success(`Share dir removed: ${shareBranch}`);
     }
   }
 
-  p.outro(pc.green('Sandbox removed'));
+  if (!options.quiet) {
+    p.outro(pc.green('Sandbox removed'));
+  }
 }
 
-async function rmAll(config: SandboxConfig, tools: SandboxTool[]): Promise<void> {
+async function rmPurge(config: SandboxConfig, tools: SandboxTool[]): Promise<void> {
   const engine = detectEngine(config);
   p.intro(pc.cyan(`Removing all sandboxes for ${config.project}`));
 
@@ -231,6 +253,70 @@ async function rmAll(config: SandboxConfig, tools: SandboxTool[]): Promise<void>
   p.outro(pc.green('All project sandboxes removed'));
 }
 
+async function rmUnbound(
+  config: SandboxConfig,
+  tools: SandboxTool[],
+  options: { dryRun: boolean; assumeYes: boolean }
+): Promise<void> {
+  const engine = detectEngine(config);
+  const { running, nonRunning } = fetchSandboxRows(engine, sandboxLabel(config), sandboxBranchLabel(config));
+  const removable = [...running, ...nonRunning].filter(
+    (row) => row.branch && lookupShortIdByBranch(row.branch, config.repoRoot) === null
+  );
+
+  p.intro(pc.cyan(`Removing sandboxes not bound to an active task for ${config.project}`));
+
+  if (removable.length === 0) {
+    p.outro('No removable sandboxes: every container is bound to an active task (or none exist)');
+    return;
+  }
+
+  for (const row of removable) {
+    p.log.message(`${row.name}  ${row.branch}`);
+  }
+
+  if (options.dryRun) {
+    p.outro(`Dry run: ${removable.length} sandbox(es) would be removed, nothing deleted`);
+    return;
+  }
+
+  if (!options.assumeYes) {
+    if (!process.stdin.isTTY) {
+      throw new Error(
+        'Refusing to remove sandboxes without confirmation in a non-interactive shell; pass --yes to proceed.'
+      );
+    }
+    const confirmed = await p.confirm({
+      message: `Remove these ${removable.length} sandbox(es)?`,
+      initialValue: false
+    });
+    if (p.isCancel(confirmed) || !confirmed) {
+      p.outro('Cancelled');
+      return;
+    }
+  }
+
+  const failures: { branch: string; message: string }[] = [];
+  for (const row of removable) {
+    try {
+      await rmOne(config, tools, row.branch, { assumeYes: true, quiet: true });
+    } catch (error) {
+      failures.push({ branch: row.branch, message: error instanceof Error ? error.message : String(error) });
+    }
+  }
+
+  if (failures.length > 0) {
+    for (const failure of failures) {
+      p.log.error(`Failed to remove '${failure.branch}': ${failure.message}`);
+    }
+    throw new Error(
+      `Removed ${removable.length - failures.length}/${removable.length} sandbox(es); ${failures.length} failed`
+    );
+  }
+
+  p.outro(pc.green(`Removed ${removable.length} sandbox(es)`));
+}
+
 export async function rm(args: string[]): Promise<void> {
   const { values, positionals } = parseArgs({
     args,
@@ -238,6 +324,9 @@ export async function rm(args: string[]): Promise<void> {
     strict: true,
     options: {
       all: { type: 'boolean' },
+      purge: { type: 'boolean' },
+      'dry-run': { type: 'boolean' },
+      yes: { type: 'boolean', short: 'y' },
       help: { type: 'boolean', short: 'h' }
     }
   });
@@ -247,15 +336,35 @@ export async function rm(args: string[]): Promise<void> {
     return;
   }
 
-  if (!values.all && positionals.length !== 1) {
+  if (values.all && values.purge) {
+    throw new Error('--all and --purge are mutually exclusive');
+  }
+
+  if ((values['dry-run'] || values.yes) && !values.all) {
+    throw new Error('--dry-run and --yes only apply to --all');
+  }
+
+  if ((values.all || values.purge) && positionals.length > 0) {
+    throw new Error(`${values.all ? '--all' : '--purge'} does not take a branch argument`);
+  }
+
+  if (!values.all && !values.purge && positionals.length !== 1) {
     throw new Error(USAGE);
   }
 
   const config = loadConfig();
   const tools = resolveTools(config);
 
+  if (values.purge) {
+    await rmPurge(config, tools);
+    return;
+  }
+
   if (values.all) {
-    await rmAll(config, tools);
+    await rmUnbound(config, tools, {
+      dryRun: Boolean(values['dry-run']),
+      assumeYes: Boolean(values.yes)
+    });
     return;
   }
 

package/lib/sandbox/index.ts

@@ -6,9 +6,6 @@ Commands:
                                Enter sandbox or run a command. N (bare) is the
                                recommended form for task short ids (e.g.
                                'ai sandbox exec 11'); '#N' is also accepted.
-  start <branch | TASK-id | N | '#N'>
-                               Start an existing stopped sandbox container
-                               (e.g. after the Docker daemon restarted)
   ls                           List sandboxes for the current project (the '#'
                                column is a display-only row number; the 'SHORT'
                                column shows the active task short id, '-' if none)
@@ -16,7 +13,12 @@ Commands:
   rebuild [--quiet] [--refresh]
                                Rebuild the sandbox image (--refresh pulls base + tools)
   refresh                      Sync host Claude Code credentials to all sandbox copies
-  rm <branch> [--all]          Remove a sandbox or all sandboxes
+  rm <branch> | --all | --purge
+                               Remove one sandbox, all sandboxes not bound to an
+                               active task (--all), or tear down everything (--purge)
+  start <branch | TASK-id | N | '#N'>
+                               Start an existing stopped sandbox container
+                               (e.g. after the Docker daemon restarted)
   vm status|start|stop         Manage the sandbox VM (macOS) or check the backend (Windows)
 
 Run 'ai sandbox <command> --help' for details.`;
@@ -49,6 +51,21 @@ export async function runSandbox(args: string[]): Promise<void> {
       }
       break;
     }
+    case 'ls': {
+      const { ls } = await import('./commands/ls.ts');
+      ls(rest);
+      break;
+    }
+    case 'prune': {
+      const { prune } = await import('./commands/prune.ts');
+      await prune(rest);
+      break;
+    }
+    case 'rebuild': {
+      const { rebuild } = await import('./commands/rebuild.ts');
+      await rebuild(rest);
+      break;
+    }
     case 'refresh': {
       const { refresh } = await import('./commands/refresh.ts');
       const exitCode = await refresh(rest);
@@ -57,24 +74,14 @@ export async function runSandbox(args: string[]): Promise<void> {
       }
       break;
     }
-    case 'start': {
-      const { start } = await import('./commands/start.ts');
-      await start(rest);
-      break;
-    }
-    case 'ls': {
-      const { ls } = await import('./commands/ls.ts');
-      ls(rest);
-      break;
-    }
     case 'rm': {
       const { rm } = await import('./commands/rm.ts');
       await rm(rest);
       break;
     }
-    case 'prune': {
-      const { prune } = await import('./commands/prune.ts');
-      await prune(rest);
+    case 'start': {
+      const { start } = await import('./commands/start.ts');
+      await start(rest);
       break;
     }
     case 'vm': {
@@ -82,11 +89,6 @@ export async function runSandbox(args: string[]): Promise<void> {
       await vm(rest);
       break;
     }
-    case 'rebuild': {
-      const { rebuild } = await import('./commands/rebuild.ts');
-      await rebuild(rest);
-      break;
-    }
     default:
       throw new Error(`Unknown sandbox command: ${subcommand}`);
   }

package/lib/sandbox/readme-scaffold.ts

@@ -18,7 +18,7 @@ symlink under \`$HOME\` (e.g. \`.tmux.conf\` -> \`/home/devuser/.tmux.conf\`),
 overriding image defaults so your editor, shell, and tool preferences follow
 you across \`ai sandbox destroy + create\`.
 
-See: https://github.com/fitlab-ai/agent-infra/blob/main/README.md#user-level-dotfiles-channel
+See: https://github.com/fitlab-ai/agent-infra/blob/main/docs/en/sandbox.md#user-level-dotfiles-channel
 
 Common usage - drop files or symlinks here:
 
@@ -46,7 +46,7 @@ only writes \`README.md\` when it is missing, never when it already exists.
 （例如 \`.tmux.conf -> /home/devuser/.tmux.conf\`），覆盖镜像默认值，让你的编辑器、
 shell、工具偏好跨 \`ai sandbox destroy + create\` 持久存在。
 
-参考：https://github.com/fitlab-ai/agent-infra/blob/main/README.zh-CN.md#用户级-dotfiles-通道
+参考：https://github.com/fitlab-ai/agent-infra/blob/main/docs/zh-CN/sandbox.md#用户级-dotfiles-通道
 
 常见用法：把文件或符号链接放进来：
 
@@ -72,7 +72,7 @@ This directory is mounted **read-write** into every sandbox container of this
 project at \`/share/common\`, regardless of branch. Drop files here to share
 between host and any sandbox without polluting the git worktree.
 
-See: https://github.com/fitlab-ai/agent-infra/blob/main/README.md#host-sandbox-file-exchange
+See: https://github.com/fitlab-ai/agent-infra/blob/main/docs/en/sandbox.md#host-sandbox-file-exchange
 
 This file is safe to delete; the next \`ai sandbox create\` will re-create it.
 
@@ -83,7 +83,7 @@ This file is safe to delete; the next \`ai sandbox create\` will re-create it.
 该目录被以**读写**方式挂载到本项目所有 sandbox 容器的 \`/share/common\`，
 跨分支可见。可用来在宿主和任意 sandbox 之间传文件，无需弄脏 git worktree。
 
-参考：https://github.com/fitlab-ai/agent-infra/blob/main/README.zh-CN.md#宿主-沙箱文件交换
+参考：https://github.com/fitlab-ai/agent-infra/blob/main/docs/zh-CN/sandbox.md#宿主-沙箱文件交换
 
 该文件可以安全删除；下一次 \`ai sandbox create\` 会重新生成。
 `;
@@ -94,7 +94,7 @@ This directory is mounted **read-write** into the sandbox container of this
 project's current branch at \`/share/branch\`. Files here are exclusive to this
 branch's sandbox and do not leak across branches.
 
-See: https://github.com/fitlab-ai/agent-infra/blob/main/README.md#host-sandbox-file-exchange
+See: https://github.com/fitlab-ai/agent-infra/blob/main/docs/en/sandbox.md#host-sandbox-file-exchange
 
 This file is safe to delete; the next \`ai sandbox create\` will re-create it.
 
@@ -105,7 +105,7 @@ This file is safe to delete; the next \`ai sandbox create\` will re-create it.
 该目录被以**读写**方式挂载到本项目当前分支 sandbox 容器的 \`/share/branch\`，
 仅当前分支可见，不会跨分支泄漏。
 
-参考：https://github.com/fitlab-ai/agent-infra/blob/main/README.zh-CN.md#宿主-沙箱文件交换
+参考：https://github.com/fitlab-ai/agent-infra/blob/main/docs/zh-CN/sandbox.md#宿主-沙箱文件交换
 
 该文件可以安全删除；下一次 \`ai sandbox create\` 会重新生成。
 `;