openmoneta-dev-kit 2.2.1 → 2.3.0

package/src/commands/update.js

@@ -25,9 +25,11 @@ function isKitRepo(dir) {
   }
 }
 
+const ALL_TARGETS = ["cursor", "opencode", "claude"]
+
 function readRegistry() {
   const seen = new Set()
-  for (const target of ["cursor", "opencode"]) {
+  for (const target of ALL_TARGETS) {
     let content
     try {
       content = fs.readFileSync(getProjectRegistry(target), "utf8")
@@ -49,7 +51,7 @@ function readRegistry() {
 
 function pruneRegistry() {
   let pruned = 0
-  for (const target of ["cursor", "opencode"]) {
+  for (const target of ALL_TARGETS) {
     const reg = getProjectRegistry(target)
     let content
     try {
@@ -119,7 +121,7 @@ function scanSeed(root, pkgRoot) {
     console.log(`  [!] Scan root không tồn tại: ${root}`)
     return
   }
-  const targets = ["cursor", "opencode"].filter((t) => isInstalled(t))
+  const targets = ALL_TARGETS.filter((t) => isInstalled(t))
   if (targets.length === 0) {
     console.log(`  [!] Chưa có install home nào để seed registry.`)
     return
@@ -196,6 +198,10 @@ async function run(args) {
     console.log(`\n  OpenMoneta Dev Kit`)
     console.log(`  Local : v${local || "unknown"}`)
     console.log(`  Latest: v${latest || "không xác định"}`)
+    for (const t of ALL_TARGETS) {
+      const v = installedVersion(t)
+      console.log(`  ${t.padEnd(8)}: ${v ? `v${v}` : "chưa cài"}`)
+    }
     if (latest && local && local !== latest) {
       console.log(`\n  🔔 Cập nhật có sẵn: v${local} → v${latest}`)
       console.log(`     Chạy: openmoneta update`)
@@ -205,7 +211,7 @@ async function run(args) {
     return
   }
 
-  if (!isInstalled("cursor") && !isInstalled("opencode")) {
+  if (!ALL_TARGETS.some((t) => isInstalled(t))) {
     console.log(`\n  ❌ Chưa cài OpenMoneta. Chạy: openmoneta install`)
     process.exit(1)
   }
@@ -214,7 +220,7 @@ async function run(args) {
   // Phải so version ĐÃ CÀI (installedVersion) với version sẽ cài (local) — KHÔNG chỉ
   // so source-vs-npm — nếu không, khi source==npm mà global cũ hơn sẽ skip nhầm.
   if (autoYes && !force && !allProjects && !scan) {
-    const targets = ["cursor", "opencode"].filter((t) => isInstalled(t))
+    const targets = ALL_TARGETS.filter((t) => isInstalled(t))
     const globalsCurrent = targets.length > 0 && targets.every((t) => installedVersion(t) === local)
     if (local && latest && local === latest && globalsCurrent) {
       console.log(`\n  ✅ Already at latest version (v${local}) + global đã đồng bộ, skipping. Dùng --force để cài lại.`)
@@ -258,6 +264,16 @@ async function run(args) {
     }
   }
 
+  if (isInstalled("claude")) {
+    console.log(`\n  ▶ Claude Code global...`)
+    try {
+      // Windows defer cho Claude Code (chưa có .ps1) — chạy bash trực tiếp.
+      execSync(`bash "${path.join(pkgRoot, "install-claude-code.sh")}" --yes`, { stdio: "inherit", cwd: pkgRoot })
+    } catch {
+      console.error(`  ⚠ Claude Code update failed`)
+    }
+  }
+
   console.log(`\n  ✅ Global update done.`)
 
   if (!skipProjects) {
@@ -326,7 +342,7 @@ async function run(args) {
     }
   }
 
-  console.log(`\n  🎉 Hoàn tất. Restart Cursor/OpenCode để áp dụng.`)
+  console.log(`\n  🎉 Hoàn tất. Restart Cursor/OpenCode/Claude Code để áp dụng.`)
 }
 
 module.exports = {

package/src/lib/paths.js

@@ -12,15 +12,18 @@ const XDG_CONFIG = process.env.XDG_CONFIG_HOME || path.join(HOME, ".config")
 
 const CURSOR_DIR = path.join(HOME, ".cursor")
 const OPENCODE_DIR = path.join(XDG_CONFIG, "opencode")
+const CLAUDE_DIR = path.join(HOME, ".claude")
 const REPO_DIR = path.join(HOME, "OpenMoneta-Dev-Kit") // legacy
 
 function versionFilePath(target) {
   if (target === "opencode") return path.join(OPENCODE_DIR, ".openmoneta-version")
+  if (target === "claude") return path.join(CLAUDE_DIR, ".openmoneta-version")
   return path.join(CURSOR_DIR, ".openmoneta-version")
 }
 
 function getProjectRegistry(target) {
   if (target === "opencode") return path.join(OPENCODE_DIR, ".openmoneta-projects")
+  if (target === "claude") return path.join(CLAUDE_DIR, ".openmoneta-projects")
   return path.join(CURSOR_DIR, ".openmoneta-projects")
 }
 
@@ -55,6 +58,7 @@ module.exports = {
   HOME,
   CURSOR_DIR,
   OPENCODE_DIR,
+  CLAUDE_DIR,
   REPO_DIR,
   versionFilePath,
   getProjectRegistry,

package/templates/AGENTS.md.tpl

@@ -1,6 +1,6 @@
 # AGENTS.md — Quy trình chuẩn (OpenMoneta Dev Kit v{{VERSION}})
 
-> File này được tạo từ `~/.cursor/templates/AGENTS.md.tpl`. Chạy `bash ~/.cursor/scripts/init-project.sh .` để re-sync (idempotent, giữ phần `<!-- BEGIN PROJECT OVERRIDE -->`).
+> File này được tạo từ `templates/AGENTS.md.tpl` của install home (`~/.cursor` | `~/.config/opencode` | `~/.claude`). Chạy `bash <home>/scripts/init-project.sh .` để re-sync (idempotent, giữ phần `<!-- BEGIN PROJECT OVERRIDE -->`). Claude Code đọc file này qua shim `CLAUDE.md` (`@AGENTS.md`).
 
 ## Nguyên tắc vàng
 
@@ -94,13 +94,13 @@
 
 ## Hooks enforce
 
-> Cursor dùng bash hooks (`~/.cursor/hooks/`). OpenCode dùng plugin guard `openmoneta-guard.ts` — `tool.execute.before/after` tương đương 2 hook đầu, `event:session.idle` tương đương `verify-completion` (re-prompt thay vì block cứng).
+> Cursor dùng bash hooks (`~/.cursor/hooks/`). OpenCode dùng plugin guard `openmoneta-guard.ts` — `tool.execute.before/after` tương đương 2 hook đầu, `event:session.idle` tương đương `verify-completion` (re-prompt thay vì block cứng). Claude Code dùng adapter (`~/.claude/hooks/openmoneta/`) dịch protocol → gọi lại bash hooks gốc; `Stop` hook block cứng như Cursor + matcher `Bash` chặn cả shell search trước docs-first.
 
 | Hook | Khi nào | Hậu quả |
 |---|---|---|
-| `enforce-docs-first` | preToolUse Read/Glob/Grep | BLOCK source code đọc nếu chưa Read `docs/INDEX.md`; nếu có `docs/decisions/INDEX.md` thì còn BLOCK đến khi đã đọc `docs/decisions/` (chống flip-flop kiến trúc) |
-| `check-plan-exists` | preToolUse Write/StrReplace/EditNotebook/Delete | ALLOW task thường không plan; BLOCK file nhạy cảm không plan, plan Draft, hoặc file ngoài scope plan |
-| `verify-completion` | stop (Cursor) / `session.idle` (OpenCode) | Cursor BLOCK kết thúc nếu Check 5/6/9/10/11 fail (gồm ADR supersede integrity + plan đổi kiến trúc thiếu ADR); OpenCode re-prompt nhắc hoàn tất, loop guard ≤4 lần |
+| `enforce-docs-first` | preToolUse Read/Glob/Grep (Claude Code: thêm Bash search) | BLOCK source code đọc nếu chưa Read `docs/INDEX.md`; nếu có `docs/decisions/INDEX.md` thì còn BLOCK đến khi đã đọc `docs/decisions/` (chống flip-flop kiến trúc) |
+| `check-plan-exists` | preToolUse Write/StrReplace/EditNotebook/Delete (Claude Code: Write/Edit/NotebookEdit) | ALLOW task thường không plan; BLOCK file nhạy cảm không plan, plan Draft, hoặc file ngoài scope plan |
+| `verify-completion` | stop (Cursor/Claude Code) / `session.idle` (OpenCode) | Cursor + Claude Code BLOCK kết thúc nếu Check 5/6/9/10/11 fail (gồm ADR supersede integrity + plan đổi kiến trúc thiếu ADR); OpenCode re-prompt nhắc hoàn tất, loop guard ≤4 lần |
 
 ## Override cho dự án này
 

package/uninstall.sh

@@ -89,5 +89,66 @@ else
   echo "✅ Đã uninstall."
 fi
 
+# === Claude Code (~/.claude) — surgical theo manifest ===
+# ~/.claude chứa data + skills/agents riêng của user → TUYỆT ĐỐI không rm -rf
+# thư mục chuẩn. Chỉ xóa item kit đã cài (ghi trong .openmoneta-manifest) + gỡ
+# hooks entries openmoneta khỏi settings.json.
+CLAUDE_DIR="$HOME/.claude"
+if [[ -f "$CLAUDE_DIR/.openmoneta-version" ]]; then
+  echo ""
+  echo "==> Gỡ Claude Code config ($CLAUDE_DIR)..."
+
+  MANIFEST="$CLAUDE_DIR/.openmoneta-manifest"
+  if [[ -f "$MANIFEST" ]]; then
+    while IFS= read -r item; do
+      [[ -z "$item" ]] && continue
+      case "$item" in
+        /*|*..*) continue ;;  # manifest chỉ chứa path tương đối an toàn
+      esac
+      if [[ -e "$CLAUDE_DIR/$item" ]]; then
+        rm -rf "${CLAUDE_DIR:?}/$item"
+        echo "  - $item"
+      fi
+    done < "$MANIFEST"
+    rm -f "$MANIFEST"
+  fi
+
+  SETTINGS="$CLAUDE_DIR/settings.json"
+  if [[ -f "$SETTINGS" ]] && command -v python3 >/dev/null 2>&1; then
+    python3 - "$SETTINGS" <<'PYEOF' || echo "  [!] Không parse được settings.json — gỡ hooks openmoneta thủ công nếu cần."
+import json, sys
+
+path = sys.argv[1]
+with open(path) as f:
+    settings = json.load(f)
+
+hooks = settings.get("hooks")
+if isinstance(hooks, dict):
+    def is_om(entry):
+        return any(
+            "hooks/openmoneta/" in (h.get("command") or "")
+            for h in entry.get("hooks", [])
+            if isinstance(h, dict)
+        )
+    for event in list(hooks.keys()):
+        if isinstance(hooks[event], list):
+            hooks[event] = [e for e in hooks[event] if not is_om(e)]
+            if not hooks[event]:
+                del hooks[event]
+    if not hooks:
+        del settings["hooks"]
+
+with open(path, "w") as f:
+    json.dump(settings, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+print("  - hooks entries openmoneta trong settings.json")
+PYEOF
+  fi
+
+  rm -f "$CLAUDE_DIR/.openmoneta-version" "$CLAUDE_DIR/.openmoneta-repo" \
+        "$CLAUDE_DIR/.openmoneta-installed-at" "$CLAUDE_DIR/.openmoneta-update-check"
+  echo "✅ Đã gỡ Claude Code config (skills/agents riêng của bạn giữ nguyên)."
+fi
+
 echo ""
-echo "Restart Cursor để áp dụng."
+echo "Restart Cursor/Claude Code để áp dụng."

package/update.sh

@@ -127,7 +127,8 @@ sync_project() {
 registry_files() {
   printf '%s\n' \
     "$HOME/.cursor/.openmoneta-projects" \
-    "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/.openmoneta-projects"
+    "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/.openmoneta-projects" \
+    "$HOME/.claude/.openmoneta-projects"
 }
 
 # === Helper: đọc registry (merge 2 home, bỏ dòng trống, dedup) ===
@@ -168,6 +169,7 @@ scan_seed() {
   [[ -f "$HOME/.cursor/.openmoneta-version" ]] && homes+=("$HOME/.cursor/.openmoneta-projects")
   [[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/.openmoneta-version" ]] && \
     homes+=("${XDG_CONFIG_HOME:-$HOME/.config}/opencode/.openmoneta-projects")
+  [[ -f "$HOME/.claude/.openmoneta-version" ]] && homes+=("$HOME/.claude/.openmoneta-projects")
   if [[ ${#homes[@]} -eq 0 ]]; then
     echo "  [!] Chưa có install home nào để seed registry."
     return 0
@@ -306,6 +308,19 @@ else
   echo "   Cài tay nếu cần: bash $REPO_DIR/install-opencode.sh"
 fi
 
+# === Step 2C: Global install (Claude Code) ===
+# CHỈ chạy nếu đã từng cài OpenMoneta cho Claude Code (opt-in qua install-claude-code.sh).
+# Không tự cài khi chỉ thấy binary `claude` — tránh đụng ~/.claude của user ngoài ý muốn.
+CLAUDE_DIR="$HOME/.claude"
+if [[ -f "$CLAUDE_DIR/.openmoneta-version" ]]; then
+  echo ""
+  echo "==> Phát hiện OpenMoneta for Claude Code → chạy install-claude-code.sh..."
+  bash "$REPO_DIR/install-claude-code.sh" --yes
+else
+  echo ""
+  echo "ℹ️  Chưa cài OpenMoneta cho Claude Code, bỏ qua. Opt-in: bash $REPO_DIR/install-claude-code.sh"
+fi
+
 echo ""
 echo "✅ Global update hoàn tất: v$CURRENT_VERSION → v$NEW_VERSION"
 echo ""