@andyqiu/codeforge 0.5.29 → 0.6.1

package/scripts/merge-agents-md.mjs

@@ -1,228 +0,0 @@
-#!/usr/bin/env node
-/**
- * scripts/merge-agents-md.mjs — install.sh / install.ps1 共用的 AGENTS.md 智能合并 CLI
- *
- * 阶段 C.4 抽取：
- *   - 取代 install.sh / install.ps1 各自内嵌的 inline node script
- *   - 算法语义与 lib/agents-merge.ts 严格一致（单一来源）
- *   - 自带实现而不是 import lib/agents-merge.ts，因为 install 时 lib/ 可能不可访问
- *     （npm install / 全局安装场景），CLI 必须自包含
- *
- * 用法：
- *   node scripts/merge-agents-md.mjs --target <path/to/AGENTS.md> --template <path/to/kh-instructions.md>
- *
- * 选项：
- *   --target <path>       目标 AGENTS.md 路径（必填）
- *   --template <path>     KH instructions 模板路径（必填）
- *   --dry-run             仅打印将要做什么，不实际写文件
- *   --no-backup           跳过 .bak 备份（默认会备份）
- *   --quiet               静默模式（仅错误输出）
- *   -h / --help           帮助
- *
- * 退出码：
- *   0 = 成功（或 dry-run）
- *   1 = 参数错误
- *   2 = 模板文件不存在
- *   3 = 写文件失败
- *
- * 任何失败都不应影响 install 主流程：调用方应检查返回码并自行决定是否容忍。
- *
- * 算法：见 lib/agents-merge.ts 的 JSDoc。三个分支：
- *   1. 已存在 marker 块  → 替换块内（marker 自身保留）
- *   2. 不存在 marker 块  → 顶部插入新块（原内容下移）
- *   3. 文件不存在        → 生成短版骨架
- *
- * 单一来源声明：
- *   本脚本是 sh / ps1 共用入口（C.4）。如需修改算法，
- *   也要同步 lib/agents-merge.ts（TypeScript 端，给 plugin 内部用）。
- *   install.sh / install.ps1 不再持有算法实现，调用本 CLI。
- */
-
-import { readFileSync, writeFileSync, copyFileSync, existsSync } from "node:fs"
-import { basename } from "node:path"
-import process from "node:process"
-
-const KH_MARKER_START = "<!-- knowledge-hub:start -->"
-const KH_MARKER_END = "<!-- knowledge-hub:end -->"
-const START_PREFIX = "<!-- knowledge-hub:start"
-const END_PREFIX = "<!-- knowledge-hub:end"
-
-// ────────────────────────────────────────────────────────────────────
-// 算法：与 lib/agents-merge.ts 一致
-// ────────────────────────────────────────────────────────────────────
-
-function findMarkerLine(text, prefix, fromLine = 0) {
-  const lines = text.split("\n")
-  for (let i = fromLine; i < lines.length; i++) {
-    if (lines[i].trimStart().startsWith(prefix)) return i
-  }
-  return -1
-}
-
-function normalizeTemplate(tpl) {
-  return tpl.replace(/\n+$/g, "")
-}
-
-function backupSuffix(now = new Date()) {
-  const pad = (n) => String(n).padStart(2, "0")
-  return (
-    `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
-    `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`
-  )
-}
-
-function backupPath(originalPath, now = new Date()) {
-  return `${originalPath}.bak.${backupSuffix(now)}`
-}
-
-function createDefault(template) {
-  const tpl = normalizeTemplate(template)
-  return [
-    "# 项目 AGENTS.md",
-    "",
-    KH_MARKER_START,
-    "",
-    tpl,
-    "",
-    KH_MARKER_END,
-    "",
-    "## 项目专属约定",
-    "",
-    "（在此添加本项目特有的开发约定）",
-    "",
-  ].join("\n")
-}
-
-/**
- * 智能合并主入口。返回 { content, mode }。
- *
- * mode 可能值：
- *   - "replaced"  已存在 marker 块，替换块内
- *   - "inserted"  顶部插入新块
- *   - "created"   文件不存在，生成短版
- */
-function mergeAgentsMd({ template, existing }) {
-  const tpl = normalizeTemplate(template)
-
-  if (existing == null || existing.length === 0) {
-    return { content: createDefault(tpl), mode: "created" }
-  }
-
-  const startIdx = findMarkerLine(existing, START_PREFIX)
-  const endIdx = startIdx === -1 ? -1 : findMarkerLine(existing, END_PREFIX, startIdx + 1)
-
-  if (startIdx !== -1 && endIdx !== -1) {
-    const lines = existing.split("\n")
-    const before = lines.slice(0, startIdx + 1)
-    const after = lines.slice(endIdx)
-    const middle = ["", tpl, ""]
-    return {
-      content: [...before, ...middle, ...after].join("\n"),
-      mode: "replaced",
-    }
-  }
-
-  const block = `${KH_MARKER_START}\n\n${tpl}\n\n${KH_MARKER_END}\n\n`
-  return {
-    content: block + existing,
-    mode: "inserted",
-  }
-}
-
-// ────────────────────────────────────────────────────────────────────
-// CLI
-// ────────────────────────────────────────────────────────────────────
-
-const HELP = `
-scripts/merge-agents-md.mjs — AGENTS.md 智能合并 CLI
-
-用法：
-  node scripts/merge-agents-md.mjs --target <path> --template <path> [选项]
-
-选项：
-  --target <path>       目标 AGENTS.md 路径（必填）
-  --template <path>     KH instructions 模板路径（必填）
-  --dry-run             仅打印将要做什么
-  --no-backup           跳过 .bak 备份（默认会备份）
-  --quiet               静默模式
-  -h / --help           本帮助
-
-退出码：
-  0 成功    1 参数错误    2 模板缺失    3 写文件失败
-`
-
-function parseArgs(argv) {
-  const args = { target: null, template: null, dryRun: false, backup: true, quiet: false }
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i]
-    if (a === "-h" || a === "--help") {
-      process.stdout.write(HELP)
-      process.exit(0)
-    } else if (a === "--target") args.target = argv[++i]
-    else if (a === "--template") args.template = argv[++i]
-    else if (a === "--dry-run") args.dryRun = true
-    else if (a === "--no-backup") args.backup = false
-    else if (a === "--quiet") args.quiet = true
-    else {
-      process.stderr.write(`未知参数: ${a}\n${HELP}`)
-      process.exit(1)
-    }
-  }
-  return args
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2))
-  if (!args.target || !args.template) {
-    process.stderr.write("错误：--target 和 --template 都必须指定\n" + HELP)
-    process.exit(1)
-  }
-
-  const log = args.quiet ? () => {} : (msg) => process.stdout.write(msg + "\n")
-
-  // 读模板
-  if (!existsSync(args.template)) {
-    process.stderr.write(`模板文件不存在: ${args.template}\n`)
-    process.exit(2)
-  }
-  const template = readFileSync(args.template, "utf8")
-
-  // 读现有 AGENTS.md（可能不存在）
-  const existing = existsSync(args.target) ? readFileSync(args.target, "utf8") : null
-
-  // 合并
-  const result = mergeAgentsMd({ template, existing })
-
-  if (args.dryRun) {
-    log(`[dry-run] mode=${result.mode}  target=${args.target}`)
-    log(`[dry-run] 将写入 ${result.content.length} 字节`)
-    if (existing && args.backup) {
-      log(`[dry-run] 将备份到 ${backupPath(args.target)}`)
-    }
-    process.exit(0)
-  }
-
-  // 备份
-  if (existing && args.backup) {
-    const bak = backupPath(args.target)
-    try {
-      copyFileSync(args.target, bak)
-      log(`  ✓ 已备份原 AGENTS.md → ${basename(bak)}`)
-    } catch (err) {
-      process.stderr.write(`备份失败: ${err.message}\n`)
-      process.exit(3)
-    }
-  }
-
-  // 写入
-  try {
-    writeFileSync(args.target, result.content, "utf8")
-    log(`  ✓ AGENTS.md ${result.mode}: ${args.target}`)
-    process.exit(0)
-  } catch (err) {
-    process.stderr.write(`写入失败: ${err.message}\n`)
-    process.exit(3)
-  }
-}
-
-main()