/** * worktree/layout.ts — 纯逻辑:worktree 名字校验、路径与分支推导、exclude 条目、续句文案。 * * 不 import pi、不碰 IO,`node --test` 可直跑。名字同时进**路径**与**git ref** 两处, * 所以两处不接受的东西都在这里挡掉(`..` 段、绝对路径、控制字符、首尾斜杠、`-` 开头的段)。 */ /** 写进 `/.git/info/exclude` 的那一行 —— 不加它,statusline 会把整棵 worktree 算成未跟踪。 */ export const EXCLUDE_ENTRY = ".worktrees/"; /** `validateName` 的结果。 */ export type ValidateResult = { ok: true; name: string } | { ok: false; reason: string }; /** 每个路径段允许的字符:字母、数字、点、下划线、连字符。 */ const SEGMENT = /^[A-Za-z0-9._-]+$/; /** * 校验并规范化 worktree 名字。 * * 返回的 `name` 已 `trim()`;失败时 `reason` 是给用户看的中文原因。 */ export function validateName(raw: string): ValidateResult { const name = typeof raw === "string" ? raw.trim() : ""; if (name === "") return { ok: false, reason: "worktree 名字不能为空" }; // 控制字符(含 NUL / 换行):git ref 不接受,路径上也只会制造麻烦 if (/[\u0000-\u001f]/.test(name)) return { ok: false, reason: "worktree 名字里不能有控制字符" }; if (name.startsWith("/")) return { ok: false, reason: "worktree 名字必须是相对名,不能以 / 开头" }; if (name.endsWith("/")) return { ok: false, reason: "worktree 名字不能以 / 结尾" }; if (name.includes("//")) return { ok: false, reason: "worktree 名字里不能有连续的 /" }; const segments = name.split("/"); for (const segment of segments) { if (segment === "" || segment === "." || segment === "..") { return { ok: false, reason: "worktree 名字里不能有 . 或 .. 段(会跑出 .worktrees/)" }; } if (!SEGMENT.test(segment)) { return { ok: false, reason: `worktree 名字的每一段只能含字母、数字、. _ -(非法段:"${segment}")` }; } } // git 会把 - 开头的参数当选项:名字首个字符是 - 一律拒绝 if (name.startsWith("-")) return { ok: false, reason: "worktree 名字不能以 - 开头" }; return { ok: true, name }; } /** `/.worktrees/`。`name` 应当是 `validateName` 通过的值。 */ export function worktreePath(repoRoot: string, name: string): string { const base = repoRoot.endsWith("/") ? repoRoot.slice(0, -1) : repoRoot; return `${base}/.worktrees/${name}`; } /** 分支名 = 名字(与 `git worktree add ` 的习惯一致,不另加命名空间)。 */ export function branchFor(name: string): string { return name; } /** * 切换成功后发给模型的那一句(面向模型的文案统一用英文)。 * * 带上路径(与分支,如果知道),让模型不必自己 `pwd` 就能确认自己在哪里;同时点明「续原任务」, * 免得它把切换当成一次新的用户请求。`branch` 为空(例如退出到主仓但读不到分支)时不提分支。 */ export function continuationText(path: string, branch: string): string { const where = branch ? `Entered git worktree ${path} on branch ${branch}` : `Entered ${path}`; return `${where}. The session working directory is now ${path} — continue the original task from here.`; }