/** * 工作区统一笔记校验:对所有含 .agents/notes/ 的仓库跑三条门禁。 * * 用法(在 meta 仓库根目录): * node .agents/scripts/verify-notes.ts # 全部仓库 * node .agents/scripts/verify-notes.ts lpt-be # 只查指定仓库 * node .agents/scripts/verify-notes.ts --changed # 只查工作区里有未提交改动的仓库 * * 为什么需要它:agent 只在 meta 启动,笔记却分散在各子仓库。逐个仓库切 cwd * 手敲长命令既容易漏仓,也容易在错误目录下静默通过(AGENT_NOTE_ROOT 缺省指向 * cwd/.agents/notes,目录不存在时脚本会报 0 篇通过)。这里统一由 meta 视角驱动。 */ import { execFileSync } from "node:child_process"; import { existsSync, readdirSync, statSync } from "node:fs"; import { join, resolve } from "node:path"; const workspaceRoot = resolve(import.meta.dirname, "../.."); const skillDir = join(workspaceRoot, ".agents/skills/write-notes-like-deepseek/scripts"); /** 三条硬门禁:目录结构、头部骨架、归档封印。锚点体检是软报告,不进门禁。 */ const CHECKS = [ { script: "verify-agent-note-tree.ts", label: "tree" }, { script: "verify-agent-note-format.ts", label: "format" }, { script: "verify-archived-agent-notes.ts", label: "archive" }, ]; const argv = process.argv.slice(2); const changedOnly = argv.includes("--changed"); const explicitRepos = argv.filter((a) => !a.startsWith("--")); interface Target { name: string; root: string; } /** meta 自身 + 各子仓库。没有 .agents/notes 的仓库不参与,避免凭空造结构。 */ function discoverTargets(): { targets: Target[]; broken: string[] } { const targets: Target[] = []; const broken: string[] = []; const add = (name: string, dir: string) => { const agentsDir = join(dir, ".agents"); const notes = join(agentsDir, "notes"); if (existsSync(notes) && statSync(notes).isDirectory()) { targets.push({ name, root: notes }); return; } // 有 .agents/ 但没 notes/:只有「git 记录里曾经有过 notes」才是误删; // 从未有过的仓库(如只放 roles 的 lpt-docs)属正常状态,静默跳过。 if (existsSync(agentsDir) && hadNotesInGit(dir)) { broken.push(`${name}: git 记录里有 .agents/notes/,但工作区已不存在(疑似误删)`); } }; add("meta", workspaceRoot); for (const entry of readdirSync(workspaceRoot, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) { if (!entry.isDirectory() || entry.name.startsWith(".")) continue; const dir = join(workspaceRoot, entry.name); // 子项目是独立 git 仓库;没有 .git 的目录(如 node_modules 之外的空壳)不算 if (!existsSync(join(dir, ".git"))) continue; add(entry.name, dir); } return { targets, broken }; } /** 该仓库 git 索引里是否出现过 .agents/notes/ 下的文件。 */ function hadNotesInGit(dir: string): boolean { try { const out = execFileSync("git", ["ls-files", ".agents/notes"], { cwd: dir, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }); return out.trim().length > 0; } catch { return false; } } /** --changed:用 git status 判断该仓库工作区是否有改动(含未跟踪),跳过干净的仓库。 */ function hasLocalChanges(dir: string): boolean { try { const out = execFileSync("git", ["status", "--porcelain"], { cwd: dir, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }); return out.trim().length > 0; } catch { return true; // 判断不了就照常校验,宁多勿漏 } } const discovered = discoverTargets(); let targets = discovered.targets; if (discovered.broken.length > 0) { for (const b of discovered.broken) console.error(`✗ ${b}`); console.error("误删笔记目录不应静默跳过门禁;用 git checkout 恢复后再跑。"); process.exit(1); } if (explicitRepos.length > 0) { const known = new Set(targets.map((t) => t.name)); const unknown = explicitRepos.filter((r) => !known.has(r)); if (unknown.length > 0) { console.error(`未知仓库:${unknown.join(", ")}(有 .agents/notes 的仓库:${[...known].join(", ")})`); process.exit(1); } targets = targets.filter((t) => explicitRepos.includes(t.name)); } if (changedOnly) { targets = targets.filter((t) => hasLocalChanges(t.root === join(workspaceRoot, ".agents/notes") ? workspaceRoot : resolve(t.root, "../.."))); if (targets.length === 0) { console.log("ok: 工作区无改动,跳过笔记校验"); process.exit(0); } } if (targets.length === 0) { console.log("ok: 没有仓库包含 .agents/notes,无需校验"); process.exit(0); } interface Failure { repo: string; check: string; output: string; } const failures: Failure[] = []; for (const target of targets) { for (const check of CHECKS) { const scriptPath = join(skillDir, check.script); if (!existsSync(scriptPath)) { failures.push({ repo: target.name, check: check.label, output: `脚本缺失:${scriptPath}` }); continue; } try { // AGENT_NOTE_ROOT 显式指定,避免脚本回落到 cwd 而校验错仓库 execFileSync(process.execPath, [scriptPath], { cwd: workspaceRoot, env: { ...process.env, AGENT_NOTE_ROOT: target.root }, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"], }); } catch (error) { const err = error as { stdout?: string; stderr?: string }; failures.push({ repo: target.name, check: check.label, output: `${err.stdout ?? ""}${err.stderr ?? ""}`.trim(), }); } } } if (failures.length > 0) { for (const f of failures) { console.error(`\n✗ ${f.repo} [${f.check}]`); for (const line of f.output.split("\n")) console.error(` ${line}`); } console.error(`\n${failures.length} 项校验失败,修完再交。`); process.exit(1); } console.log(`ok: ${targets.map((t) => t.name).join(", ")} — 三条门禁全部通过`);