@andyqiu/codeforge 0.3.10 → 0.3.12

package/dist/adr-init.js

@@ -0,0 +1,207 @@
+// lib/adr-init.ts
+import { spawnSync } from "node:child_process";
+import { existsSync, promises as fsp } from "node:fs";
+import * as path from "node:path";
+import * as url from "node:url";
+function resolveAssetsRoot() {
+  const here = path.dirname(url.fileURLToPath(import.meta.url));
+  let dir = here;
+  for (let i = 0;i < 6; i++) {
+    if (existsSync(path.join(dir, "package.json")) && existsSync(path.join(dir, "assets", "adr-init"))) {
+      return path.join(dir, "assets", "adr-init");
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  throw new Error(`assets/adr-init/ 未找到（从 ${here} 上溯 6 层）；` + `如果是 npm 安装请检查 package.json "files" 字段是否包含 "assets/"`);
+}
+function isGitRepo(cwd) {
+  try {
+    const r = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    return r.status === 0;
+  } catch {
+    return false;
+  }
+}
+function runGitConfigHooksPath(cwd) {
+  try {
+    const r = spawnSync("git", ["config", "core.hooksPath", ".githooks"], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    if (r.status === 0)
+      return { ok: true };
+    return { ok: false, error: (r.stderr ?? "").trim() || `exit=${r.status}` };
+  } catch (e) {
+    return { ok: false, error: e instanceof Error ? e.message : String(e) };
+  }
+}
+async function runAdrInit(opts = {}) {
+  const cwd = path.resolve(opts.cwd ?? process.cwd());
+  const force = !!opts.force;
+  const dryRun = !!opts.dryRun;
+  const writePrepare = !!opts.writePrepare;
+  const installPrePush = opts.installPrePush !== false;
+  const result = {
+    ok: true,
+    wrote: [],
+    skipped: [],
+    backedUp: [],
+    suggestions: [],
+    warnings: [],
+    dryRun
+  };
+  if (!isGitRepo(cwd)) {
+    result.ok = false;
+    result.reason = "not_git_repo";
+    result.warnings.push(`${cwd} 不是 git 仓库；adr-init 需要 git 才能下发 hooks`);
+    return result;
+  }
+  let assetsRoot;
+  try {
+    assetsRoot = resolveAssetsRoot();
+  } catch (e) {
+    result.ok = false;
+    result.reason = "assets_not_found";
+    result.warnings.push(e instanceof Error ? e.message : String(e));
+    return result;
+  }
+  const ts = new Date().toISOString().replace(/[:.]/g, "-");
+  const plan = [
+    { src: "scripts/adr-check.mjs", dst: "scripts/adr-check.mjs" },
+    { src: "scripts/adr-index-sync.mjs", dst: "scripts/adr-index-sync.mjs" },
+    { src: "docs/adr/README.md", dst: "docs/adr/README.md" },
+    { src: "docs/adr/template.md", dst: "docs/adr/template.md" },
+    {
+      src: ".github/pull_request_template.md",
+      dst: ".github/pull_request_template.md"
+    },
+    { src: "githooks/pre-commit.sh", dst: ".githooks/pre-commit", chmod: 493 }
+  ];
+  if (installPrePush) {
+    plan.push({
+      src: "githooks/pre-push.sh",
+      dst: ".githooks/pre-push",
+      chmod: 493
+    });
+  }
+  for (const item of plan) {
+    const srcAbs = path.join(assetsRoot, item.src);
+    const dstAbs = path.join(cwd, item.dst);
+    if (!existsSync(srcAbs)) {
+      result.warnings.push(`资产缺失：${item.src}（跳过 ${item.dst}）`);
+      continue;
+    }
+    if (existsSync(dstAbs)) {
+      if (!force) {
+        result.skipped.push(item.dst);
+        continue;
+      }
+      const bakRel = `${item.dst}.bak.${ts}`;
+      if (!dryRun) {
+        try {
+          await fsp.copyFile(dstAbs, path.join(cwd, bakRel));
+        } catch (e) {
+          result.ok = false;
+          result.reason = "io_error";
+          result.warnings.push(`备份 ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+          return result;
+        }
+      }
+      result.backedUp.push(bakRel);
+    }
+    if (!dryRun) {
+      try {
+        await fsp.mkdir(path.dirname(dstAbs), { recursive: true });
+        await fsp.copyFile(srcAbs, dstAbs);
+        if (item.chmod !== undefined) {
+          try {
+            await fsp.chmod(dstAbs, item.chmod);
+          } catch (e) {
+            if (process.platform !== "win32") {
+              result.warnings.push(`chmod ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+            }
+          }
+        }
+      } catch (e) {
+        result.ok = false;
+        result.reason = "io_error";
+        result.warnings.push(`写入 ${item.dst} 失败：${e instanceof Error ? e.message : String(e)}`);
+        return result;
+      }
+    }
+    result.wrote.push(item.dst);
+  }
+  if (!dryRun) {
+    const r = runGitConfigHooksPath(cwd);
+    if (r.ok) {
+      result.suggestions.push("已运行：git config core.hooksPath .githooks（hooks 已启用）");
+    } else {
+      result.warnings.push(`自动启用 hooks 失败：${r.error ?? "未知错误"}；请手动执行 git config core.hooksPath .githooks`);
+    }
+  } else {
+    result.suggestions.push("[dry-run] 将运行：git config core.hooksPath .githooks");
+  }
+  const pkgPath = path.join(cwd, "package.json");
+  const isNpm = existsSync(pkgPath);
+  if (isNpm) {
+    if (writePrepare) {
+      try {
+        const raw = await fsp.readFile(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        const existing = (pkg.scripts && typeof pkg.scripts.prepare === "string" ? pkg.scripts.prepare : "") ?? "";
+        const target = "git config core.hooksPath .githooks";
+        if (existing.includes(target)) {
+          result.suggestions.push(`package.json scripts.prepare 已含目标命令，无需改动`);
+        } else {
+          const bakRel = `package.json.bak.${ts}`;
+          if (!dryRun) {
+            try {
+              await fsp.copyFile(pkgPath, path.join(cwd, bakRel));
+            } catch (e) {
+              result.warnings.push(`备份 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+            }
+          }
+          result.backedUp.push(bakRel);
+          if (existing.includes("husky")) {
+            result.warnings.push(`package.json scripts.prepare 已含 husky，仍合并写入；如有问题可回滚 ${bakRel}`);
+          }
+          const merged = existing ? `${existing} && ${target}` : target;
+          pkg.scripts = { ...pkg.scripts ?? {}, prepare: merged };
+          if (!dryRun) {
+            try {
+              await fsp.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + `
+`, "utf8");
+            } catch (e) {
+              result.ok = false;
+              result.reason = "io_error";
+              result.warnings.push(`写入 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+              return result;
+            }
+          }
+          result.wrote.push("package.json");
+        }
+      } catch (e) {
+        result.warnings.push(`读取 package.json 失败：${e instanceof Error ? e.message : String(e)}`);
+      }
+    } else {
+      result.suggestions.push(`(可选) 在 package.json scripts.prepare 追加："git config core.hooksPath .githooks"，` + `或下次跑 codeforge adr-init --write-prepare 自动合并（写前自动 backup package.json）`);
+    }
+  } else {
+    result.suggestions.push("非 npm 项目：请在 README / AGENTS.md 提醒首次 clone 后跑 git config core.hooksPath .githooks");
+  }
+  return result;
+}
+var adr_init_default = { runAdrInit, resolveAssetsRoot };
+export {
+  runAdrInit,
+  resolveAssetsRoot,
+  adr_init_default as default
+};