openmoneta-dev-kit 2.2.1 → 2.3.1

package/README.md

@@ -1,8 +1,8 @@
 # OpenMoneta Dev Kit
 
-> Biến **Cursor IDE / OpenCode** thành một **team developer hoàn chỉnh** với quy trình 6 bước (Lean Mode), adaptive planning, hooks enforcement, token-aware doc routing và sub-agents on-demand.
+> Biến **Cursor IDE / OpenCode / Claude Code** thành một **team developer hoàn chỉnh** với quy trình 6 bước (Lean Mode), adaptive planning, hooks enforcement, token-aware doc routing và sub-agents on-demand.
 
-[![version](https://img.shields.io/badge/version-1.12.0-blue.svg)](./VERSION)
+[![version](https://img.shields.io/badge/version-2.3.0-blue.svg)](./VERSION)
 [![docs](https://img.shields.io/badge/docs-Vietnamese-green.svg)](./docs/INDEX.md)
 [![platform](https://img.shields.io/badge/platform-macOS%20|%20Linux%20|%20Windows-lightgrey.svg)]()
 [![npm](https://img.shields.io/npm/v/openmoneta-dev-kit)](https://www.npmjs.com/package/openmoneta-dev-kit)
@@ -13,16 +13,18 @@
 npm install -g openmoneta-dev-kit && openmoneta install
 ```
 
-1 lệnh cài cho cả Cursor + OpenCode. Sau đó khởi tạo project:
+1 lệnh cài cho cả Cursor + OpenCode. Dùng Claude Code? Cài thêm `openmoneta install --claude`. Sau đó khởi tạo project:
 
 ```bash
 cd /path/to/project
 openmoneta init
+openmoneta init --claude   # nếu dùng Claude Code (tạo shim CLAUDE.md)
 ```
 
 | Lệnh mới | Tương đương lệnh cũ |
 |---|---|
 | `openmoneta install` | `install.sh` + `install-opencode.sh` |
+| `openmoneta install --claude` | `install-claude-code.sh` |
 | `openmoneta init` | `init-project.sh .` |
 | `openmoneta check` | `update.sh --check` |
 | `openmoneta update --yes` | `update.sh --yes` |
@@ -58,13 +60,14 @@ bash ~/OpenMoneta-Dev-Kit/install.sh
 - **11 skills** (4 core + 1 core conditional + 6 on-demand) — phân tích yêu cầu, thiết kế module, plan, systematic debugging, safe push, test, security, bảo trì docs
 - **`openmoneta docs`** — audit module README thiếu/lỗi thời (stale) + skill `docs-maintenance` backfill docs cho dự án cũ
 - **4 sub-agents** — 1 core + 3 on-demand (security-auditor, qa-autonomous, ui-tester)
-- **4 hooks + plugin** — enforce token-aware reading, adaptive plan scope, và verify cuối phiên (module README + close plan); OpenCode đạt parity qua plugin guard `session.idle`
+- **4 hooks + plugin + adapter** — enforce token-aware reading, adaptive plan scope, và verify cuối phiên (module README + close plan); OpenCode đạt parity qua plugin guard `session.idle`, Claude Code qua hook adapter mỏng tái dùng bash hooks gốc
 - **Token Routing** — bảng map keyword → module giúp AI giảm 70-90% token đọc
 - **npm package** — `npm install -g openmoneta-dev-kit`, không cần git, không cần clone
 - **Auto-update check** — notify khi có version mới (cache 24h)
 - **Adaptive Planning** — task nhỏ không cần plan; task lớn/rủi ro tạo plan Draft, user review
 - **Safe Push** — sync remote trước push, không đè code người khác
 - **OpenCode Support** — global rules/skills/agents + plugin guard
+- **Claude Code Support** — hook adapter + manifest install vào `~/.claude/` (không đụng skills/agents riêng của user) + shim `CLAUDE.md` → `@AGENTS.md` ([docs/12-claude-code.md](./docs/12-claude-code.md))
 
 ## Đóng góp
 

package/VERSION

@@ -1 +1 @@
-2.2.1
+2.3.1

package/claude/agents/qa-autonomous.md

@@ -0,0 +1,39 @@
+---
+name: qa-autonomous
+description: ON-DEMAND ONLY. Dùng khi user explicitly yêu cầu viết unit/integration test. KHÔNG tự trigger trong quy trình bình thường.
+---
+
+Bạn là **qa-autonomous** của OpenMoneta Dev Kit trong Claude Code.
+
+Chỉ dùng khi user yêu cầu viết test hoặc primary agent cần isolation cho test loop.
+
+## Workflow
+
+1. Đọc plan active và Acceptance Criteria/Test Plan nếu có.
+2. Đọc skill `test-strategy` nếu available.
+3. Phát hiện stack qua config (`package.json`, `pyproject.toml`, `go.mod`, ...).
+4. Viết test focused theo behavior, không skip test.
+5. Chạy test liên quan, đọc lỗi đầy đủ, fix root cause, retest.
+6. Dừng sau tối đa 5 vòng nếu không fix được, báo root cause và blocker.
+
+## Quy tắc
+
+- Fix code khi code sai; chỉ sửa test khi assertion/test setup sai.
+- Không dùng `.skip`, `xit`, comment-out test để pass.
+- Một lần thay đổi, một lần verify.
+
+## Output
+
+```markdown
+## QA Result
+
+PASS | FAIL
+
+- Tool:
+- Attempts:
+- Tests added/changed:
+- AC verified:
+- Blocker nếu fail:
+```
+
+Luôn trả lời bằng tiếng Việt.

package/claude/agents/requirement-analyst.md

@@ -0,0 +1,51 @@
+---
+name: requirement-analyst
+description: Dùng proactively khi user request mơ hồ, lớn (>5 file ảnh hưởng), hoặc cần explore rộng codebase/tài liệu để hiểu impact trước khi lập plan. Read-only, không code.
+tools: Read, Grep, Glob
+---
+
+Bạn là **requirement-analyst** của OpenMoneta Dev Kit trong Claude Code.
+
+## Vai trò
+
+Bạn được gọi khi yêu cầu user **mơ hồ hoặc lớn**, cần đọc nhiều tài liệu/codebase mà không tốn context của parent. Bạn KHÔNG code, KHÔNG edit file. Output là **báo cáo phân tích + danh sách câu hỏi** để parent đem hỏi user.
+
+## Workflow
+
+1. Đọc `docs/INDEX.md` của workspace (nếu có) — luôn ưu tiên đầu tiên.
+2. Đọc `plans/INDEX.md` để kiểm tra plan active/overlap.
+3. Đọc module README liên quan qua Token Routing (`docs/modules/<name>/README.md`).
+4. Đọc source vừa đủ để hiểu impact, KHÔNG scan toàn bộ repo.
+5. Tóm tắt yêu cầu, giả thuyết, edge cases, rủi ro, impact.
+6. Đề xuất câu hỏi critical: làm rõ yêu cầu, phân tích mọi trường hợp, phản biện và đề xuất phương án tối ưu hơn nếu có. Mỗi câu có 2-4 options với trade-off; KHÔNG hỏi câu user đã ngầm trả lời.
+
+## Output
+
+```markdown
+# Requirement Analysis Report
+
+## Yêu cầu (diễn đạt lại)
+<1 đoạn>
+
+## Giả thuyết
+- ...
+
+## Edge cases
+- ...
+
+## Rủi ro
+- ...
+
+## Impact
+| File/Module | Mức độ | Ghi chú |
+|---|---|---|
+| ... | High/Med/Low | ... |
+
+## Câu hỏi đề xuất hỏi user
+1. ...
+
+## Khuyến nghị tiếp theo
+<hỏi user / đủ info để tạo plan / đủ info để code>
+```
+
+Luôn trả lời bằng tiếng Việt, súc tích — parent sẽ đọc và đem đi tiếp, đừng lan man.

package/claude/agents/security-auditor.md

@@ -0,0 +1,44 @@
+---
+name: security-auditor
+description: ON-DEMAND ONLY. Dùng khi user yêu cầu security audit (OWASP, scan secrets, dependency CVE) hoặc task chạm auth/payment/PII cần audit độc lập. Read-only, không sửa file.
+tools: Read, Grep, Glob, Bash
+---
+
+Bạn là **security-auditor** của OpenMoneta Dev Kit trong Claude Code.
+
+Chỉ dùng khi user yêu cầu security audit hoặc task chạm auth/payment/PII/admin/permission và primary agent muốn audit độc lập.
+
+## Workflow
+
+1. Xác định scope từ `.cursor/.session-changes.json` nếu có, hoặc từ plan active trong `plans/`.
+2. Audit OWASP Top 10 trong phạm vi file liên quan.
+3. Scan secrets bằng công cụ read-only (`rg`, `git ls-files`, audit package manager nếu phù hợp).
+4. Chỉ report HIGH/CRITICAL dependency CVE nếu có.
+5. KHÔNG sửa file. Bash chỉ dùng cho lệnh read-only (rg/git/audit).
+
+## Output
+
+```markdown
+# Security Audit Report
+
+## Scope
+- ...
+
+## OWASP Checklist
+- A01 Access Control: Pass/Issue/N/A — ...
+- ...
+
+## Secrets Scan
+- ...
+
+## Dependency CVE
+- ...
+
+## Recommendations
+1. ...
+
+## Verdict
+PASS | FAIL — <kết luận ngắn>
+```
+
+Luôn trả lời bằng tiếng Việt.

package/claude/agents/ui-tester.md

@@ -0,0 +1,40 @@
+---
+name: ui-tester
+description: ON-DEMAND ONLY. Dùng khi user yêu cầu UI test (Playwright multi-viewport mobile/tablet/desktop, visual regression, fix CSS rồi retest). KHÔNG tự trigger trong quy trình bình thường.
+---
+
+Bạn là **ui-tester** của OpenMoneta Dev Kit trong Claude Code.
+
+Chỉ dùng khi user yêu cầu UI test, visual regression, hoặc test-fix giao diện.
+
+## Workflow
+
+1. Đọc plan active hoặc yêu cầu user để xác định AC UI.
+2. Kiểm tra Playwright đã cài chưa; nếu chưa, hỏi/đề xuất cài.
+3. Chạy multi-viewport: mobile, tablet, desktop.
+4. Lưu screenshot vào `tests/screenshots/<slug>/iter-<n>/`.
+5. Đọc lỗi/screenshot, fix CSS/component, retest.
+6. Sau mỗi 2 vòng, tóm tắt thay đổi và hỏi user nếu hướng visual chưa chắc chắn.
+7. Hard limit 5 vòng trước khi escalate.
+
+## Quy tắc
+
+- Screenshot thật, không đoán bằng đọc code.
+- Không sửa test để né lỗi visual thật.
+- Cleanup state tạm khi hoàn tất.
+
+## Output
+
+```markdown
+## UI Test Result
+
+PASS | FAIL
+
+- Viewports:
+- Screenshots:
+- Attempts:
+- Issues fixed:
+- Blocker nếu fail:
+```
+
+Luôn trả lời bằng tiếng Việt.

package/claude/hooks/bash-guard.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# bash-guard.sh — Claude Code PreToolUse (matcher: Bash).
+# Chặn shell command đọc/search source TRƯỚC khi đọc docs/INDEX.md (và docs/decisions/
+# nếu project có Decision Memory). Port từ openmoneta-guard.ts v1.8.6 (OpenCode).
+#
+# Phạm vi: CHỈ chặn search/read (rg|grep|find|fd|ls|tree|cat|sed|awk|head|tail).
+# Write-qua-shell (tee, redirect, sed -i vào file) là known limitation v1 — xem ADR-0009.
+#
+# Output: deny qua hookSpecificOutput; cho qua = exit 0 KHÔNG output (không auto-approve).
+
+set -euo pipefail
+
+INPUT_JSON=$(cat 2>/dev/null || echo '{}')
+command -v jq >/dev/null 2>&1 || exit 0
+
+TOOL_NAME=$(echo "$INPUT_JSON" | jq -r '.tool_name // ""')
+[[ "$TOOL_NAME" == "Bash" ]] || exit 0
+
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+COMMAND=$(echo "$INPUT_JSON" | jq -r '.tool_input.command // ""')
+[[ -z "$CWD" || -z "$COMMAND" ]] && exit 0
+
+# Project không dùng OpenMoneta → bỏ qua.
+INDEX_FILE="$CWD/docs/INDEX.md"
+[[ -f "$INDEX_FILE" ]] || exit 0
+
+MARKER="$CWD/.cursor/.docs-index-read"
+DECISIONS_INDEX="$CWD/docs/decisions/INDEX.md"
+DECISIONS_MARKER="$CWD/.cursor/.decisions-read"
+
+deny() {
+  local msg="$1"
+  jq -n --arg msg "$msg" '{
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: $msg
+    }
+  }'
+  exit 0
+}
+
+NORMALIZED=$(printf '%s' "$COMMAND" | tr '\n' ' ')
+
+# Command tự đọc docs/INDEX.md → set marker, cho qua.
+case "$NORMALIZED" in
+  *"docs/INDEX.md"*)
+    mkdir -p "$CWD/.cursor"
+    touch "$MARKER"
+    exit 0
+    ;;
+esac
+
+# Command đọc docs/decisions/ → set decisions marker, cho qua.
+case "$NORMALIZED" in
+  *"docs/decisions"*)
+    mkdir -p "$CWD/.cursor"
+    touch "$DECISIONS_MARKER"
+    exit 0
+    ;;
+esac
+
+# Không phải lệnh search/read → cho qua (giữ phạm vi hẹp, tránh false positive).
+if ! printf '%s' "$NORMALIZED" | grep -qE '(^|[;&|() ])(rg|grep|find|fd|ls|tree|cat|sed|awk|head|tail)([ ]|$)'; then
+  exit 0
+fi
+
+# Allowlist (SAFE_READ_HINTS — parity openmoneta-guard.ts): command nhắm vào docs/config → cho qua,
+# TRỪ KHI command cũng chứa source hint (vd `rg foo src/ docs/`).
+HAS_SOURCE_HINT=0
+case "$NORMALIZED" in
+  *"apps/"*|*"packages/"*|*"src/"*|*"lib/"*|*"components/"*|*"server/"*|*"modules/"*|*"pages/"*|*"/app/"*)
+    HAS_SOURCE_HINT=1
+    ;;
+esac
+
+if [[ "$HAS_SOURCE_HINT" -eq 0 ]]; then
+  case "$NORMALIZED" in
+    *"docs/"*|*"plans/"*|*".cursor/"*|*".opencode/"*|*".claude/"*|*".github/"*|*".vscode/"*|*"AGENTS.md"*|*"CLAUDE.md"*|*"README"*|*"CHANGELOG"*|*"LICENSE"*|*"package.json"*|*"tsconfig"*|*"vite.config"*|*"playwright.config"*|*"biome.config"*|*"vitest.config"*|*"astro.config"*|*".gitignore"*|*"Dockerfile"*)
+      exit 0
+      ;;
+  esac
+fi
+
+# === Gate 1: docs-first ===
+if [[ ! -f "$MARKER" ]]; then
+  deny "Bạn đang chạy shell command đọc/search source code TRƯỚC khi đọc docs/INDEX.md. Vi phạm token-aware reading (skill requirement-analysis Bước 1).
+
+Command bị chặn: $COMMAND
+
+QUY TRÌNH ĐÚNG (BẮT BUỘC, theo thứ tự):
+1. Read $CWD/docs/INDEX.md TRƯỚC TIÊN.
+2. Tìm keyword task trong bảng 'Feature/Keyword → Module' để biết module liên quan.
+3. Read docs/modules/<matched-module>/README.md cho mỗi module liên quan.
+4. CHỈ rồi mới search/read source code của module đó.
+
+Sau khi đọc docs/INDEX.md, marker .cursor/.docs-index-read được set và mọi command source khác trong session sẽ được cho qua."
+fi
+
+# === Gate 2: decisions-read (Decision Memory / chống flip-flop kiến trúc) ===
+if [[ -f "$DECISIONS_INDEX" && ! -f "$DECISIONS_MARKER" ]]; then
+  deny "Bạn đang chạy shell command search source code TRƯỚC khi đọc docs/decisions/ (trí nhớ quyết định kiến trúc). Vi phạm Bước 1 (skill requirement-analysis 1.3b).
+
+Command bị chặn: $COMMAND
+
+HÀNH ĐỘNG NGAY:
+→ Read $DECISIONS_INDEX (set marker .cursor/.decisions-read), tìm ADR liên quan tới module bạn sắp đụng, đọc ADR đó nếu định đổi kiến trúc, sau đó retry command.
+
+LƯU Ý: Muốn ĐỔI/ĐẢO kiến trúc đã Accepted → phải supersede tường minh (skill decision-recorder), KHÔNG revert lặng lẽ."
+fi
+
+exit 0

package/claude/hooks/posttooluse-adapter.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# posttooluse-adapter.sh — Claude Code PostToolUse (Edit|Write|NotebookEdit) → core/track-changes.sh.
+# Silent track file đã sửa vào <workspace>/.cursor/.session-changes.json (verify-completion dùng).
+
+set -euo pipefail
+
+INPUT_JSON=$(cat 2>/dev/null || echo '{}')
+command -v jq >/dev/null 2>&1 || exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CORE_DIR="${OPENMONETA_CORE_HOOKS:-$SCRIPT_DIR/core}"
+CORE_HOOK="$CORE_DIR/track-changes.sh"
+[[ -f "$CORE_HOOK" ]] || exit 0
+
+TOOL_NAME=$(echo "$INPUT_JSON" | jq -r '.tool_name // ""')
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+[[ -z "$TOOL_NAME" || -z "$CWD" ]] && exit 0
+
+case "$TOOL_NAME" in
+  Write|Edit|NotebookEdit) ;;
+  *) exit 0 ;;
+esac
+
+case "$TOOL_NAME" in
+  Edit) MAPPED_TOOL="StrReplace" ;;
+  NotebookEdit) MAPPED_TOOL="EditNotebook" ;;
+  *) MAPPED_TOOL="Write" ;;
+esac
+
+CURSOR_INPUT=$(echo "$INPUT_JSON" | jq --arg tool "$MAPPED_TOOL" --arg cwd "$CWD" '{
+  tool_name: $tool,
+  tool_input: ((.tool_input // {}) + (if (.tool_input.notebook_path // "") != "" then {target_notebook: .tool_input.notebook_path} else {} end)),
+  workspace_roots: [$cwd]
+}')
+
+# Silent — không decision, không message.
+echo "$CURSOR_INPUT" | bash "$CORE_HOOK" >/dev/null 2>&1 || true
+exit 0

package/claude/hooks/pretooluse-adapter.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# pretooluse-adapter.sh — Claude Code PreToolUse → bash hooks Cursor (single source of truth).
+#
+# Map:
+#   Read|Glob|Grep            → core/enforce-docs-first.sh
+#   Write|Edit|NotebookEdit   → core/check-plan-exists.sh  (Edit→StrReplace, NotebookEdit→EditNotebook)
+#
+# Ngữ nghĩa permission (QUAN TRỌNG):
+#   - Hook gốc trả {"permission":"deny"}  → output hookSpecificOutput.permissionDecision="deny".
+#   - Hook gốc trả {"permission":"allow"} → exit 0 KHÔNG output. Với Claude Code,
+#     permissionDecision="allow" nghĩa là AUTO-APPROVE (bỏ qua permission dialog) —
+#     adapter tuyệt đối không được phát "allow" để không vô hiệu hóa permission system.
+
+set -euo pipefail
+
+INPUT_JSON=$(cat 2>/dev/null || echo '{}')
+
+# Không có jq → fail-open giống hooks gốc (không block agent).
+command -v jq >/dev/null 2>&1 || exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CORE_DIR="${OPENMONETA_CORE_HOOKS:-$SCRIPT_DIR/core}"
+
+TOOL_NAME=$(echo "$INPUT_JSON" | jq -r '.tool_name // ""')
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+[[ -z "$TOOL_NAME" || -z "$CWD" ]] && exit 0
+
+case "$TOOL_NAME" in
+  Read|Glob|Grep)
+    CORE_HOOK="$CORE_DIR/enforce-docs-first.sh"
+    MAPPED_TOOL="$TOOL_NAME"
+    ;;
+  Write|Edit|NotebookEdit)
+    CORE_HOOK="$CORE_DIR/check-plan-exists.sh"
+    case "$TOOL_NAME" in
+      Edit) MAPPED_TOOL="StrReplace" ;;
+      NotebookEdit) MAPPED_TOOL="EditNotebook" ;;
+      *) MAPPED_TOOL="Write" ;;
+    esac
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+[[ -f "$CORE_HOOK" ]] || exit 0
+
+# Build input Cursor-format. NotebookEdit: notebook_path → target_notebook (field hooks gốc parse).
+CURSOR_INPUT=$(echo "$INPUT_JSON" | jq --arg tool "$MAPPED_TOOL" --arg cwd "$CWD" '{
+  tool_name: $tool,
+  tool_input: ((.tool_input // {}) + (if (.tool_input.notebook_path // "") != "" then {target_notebook: .tool_input.notebook_path} else {} end)),
+  workspace_roots: [$cwd]
+}')
+
+CORE_OUTPUT=$(echo "$CURSOR_INPUT" | bash "$CORE_HOOK" 2>/dev/null || echo '{"permission": "allow"}')
+
+PERMISSION=$(echo "$CORE_OUTPUT" | jq -r '.permission // "allow"' 2>/dev/null || echo "allow")
+
+if [[ "$PERMISSION" == "deny" ]]; then
+  echo "$CORE_OUTPUT" | jq '{
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      permissionDecision: "deny",
+      permissionDecisionReason: (.agent_message // "Blocked by OpenMoneta Dev Kit hook.")
+    }
+  }'
+fi
+
+exit 0

package/claude/hooks/sessionstart-adapter.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# sessionstart-adapter.sh — Claude Code SessionStart → core/inject-process-context.sh.
+#
+# Khác Cursor 2 điểm chủ đích:
+# 1. CHỈ reset markers (.docs-index-read / .decisions-read) khi source = startup|clear.
+#    Claude Code còn fire SessionStart ở resume/compact GIỮA phiên làm việc — reset lúc đó
+#    sẽ chặn oan agent đang làm dở task.
+# 2. KHÔNG inject lại full quy trình 6 bước (OPENMONETA_SKIP_SUMMARY=1) — project đã nạp
+#    quy trình qua CLAUDE.md → @AGENTS.md, inject nữa là nạp đôi tốn token.
+#    Chỉ output update notice (nếu có) — stdout của SessionStart được đưa vào context.
+
+set -euo pipefail
+
+INPUT_JSON=$(cat 2>/dev/null || echo '{}')
+command -v jq >/dev/null 2>&1 || exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CORE_DIR="${OPENMONETA_CORE_HOOKS:-$SCRIPT_DIR/core}"
+CORE_HOOK="$CORE_DIR/inject-process-context.sh"
+[[ -f "$CORE_HOOK" ]] || exit 0
+
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+SOURCE=$(echo "$INPUT_JSON" | jq -r '.source // "startup"')
+[[ -z "$CWD" ]] && exit 0
+
+case "$SOURCE" in
+  startup|clear) ;;
+  *) exit 0 ;;  # resume|compact: giữ nguyên markers, không inject gì thêm
+esac
+
+CLAUDE_HOME="${OPENMONETA_HOME:-$HOME/.claude}"
+
+CURSOR_INPUT=$(jq -n --arg cwd "$CWD" '{workspace_roots: [$cwd]}')
+
+# Core hook: reset markers + auto-register registry (~/.claude/.openmoneta-projects)
+# + check update notice (cache 24h). SKIP_SUMMARY để không nạp đôi quy trình.
+CORE_OUTPUT=$(echo "$CURSOR_INPUT" | OPENMONETA_HOME="$CLAUDE_HOME" OPENMONETA_SKIP_SUMMARY=1 bash "$CORE_HOOK" 2>/dev/null || echo '{}')
+
+NOTICE=$(echo "$CORE_OUTPUT" | jq -r '.additional_context // ""' 2>/dev/null || echo "")
+if [[ -n "$NOTICE" ]]; then
+  printf '%s\n' "$NOTICE"
+fi
+
+exit 0

package/claude/hooks/stop-adapter.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# stop-adapter.sh — Claude Code Stop → core/verify-completion.sh (block cứng như Cursor).
+#
+# verify-completion.sh nhận loop_count từ harness Cursor; Claude Code không có sẵn nên
+# adapter tự đếm qua state file key theo session_id (2 session song song đếm độc lập):
+#   <workspace>/.cursor/.claude-stop-loop-<session_id>.json
+# Pass → xóa state. Fail → tăng count; core hook tự graceful escape khi count >= 4.
+#
+# Output khi block: {"decision": "block", "reason": ...} — Claude tiếp tục làm việc.
+
+set -euo pipefail
+
+INPUT_JSON=$(cat 2>/dev/null || echo '{}')
+command -v jq >/dev/null 2>&1 || exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CORE_DIR="${OPENMONETA_CORE_HOOKS:-$SCRIPT_DIR/core}"
+CORE_HOOK="$CORE_DIR/verify-completion.sh"
+[[ -f "$CORE_HOOK" ]] || exit 0
+
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+SESSION_ID=$(echo "$INPUT_JSON" | jq -r '.session_id // "default"')
+STOP_HOOK_ACTIVE=$(echo "$INPUT_JSON" | jq -r '.stop_hook_active // false')
+[[ -z "$CWD" ]] && exit 0
+
+# Sanitize session_id cho tên file.
+SESSION_KEY=$(printf '%s' "$SESSION_ID" | tr -c 'a-zA-Z0-9_-' '_')
+STATE_FILE="$CWD/.cursor/.claude-stop-loop-${SESSION_KEY}.json"
+
+LOOP_COUNT=0
+if [[ "$STOP_HOOK_ACTIVE" == "true" && -f "$STATE_FILE" ]]; then
+  LOOP_COUNT=$(jq -r '.count // 0' "$STATE_FILE" 2>/dev/null || echo 0)
+fi
+
+CURSOR_INPUT=$(jq -n --arg cwd "$CWD" --argjson lc "$LOOP_COUNT" '{
+  workspace_roots: [$cwd],
+  loop_count: $lc
+}')
+
+# OPENMONETA_HOME=~/.claude để core hook tìm scripts/list-affected-modules.sh
+# trong claude home (máy chỉ có Claude Code không có ~/.cursor/scripts).
+CORE_OUTPUT=$(echo "$CURSOR_INPUT" | OPENMONETA_HOME="${OPENMONETA_HOME:-$HOME/.claude}" bash "$CORE_HOOK" 2>/dev/null || echo '{"continue": true}')
+
+# Lưu ý: KHÔNG dùng `.continue // true` — toán tử `//` của jq coi `false` như null
+# nên `false // true` ra `true` (mất tín hiệu block).
+CONTINUE=$(echo "$CORE_OUTPUT" | jq -r 'if .continue == false then "false" else "true" end' 2>/dev/null || echo "true")
+
+if [[ "$CONTINUE" == "false" ]]; then
+  mkdir -p "$CWD/.cursor"
+  jq -n --argjson c "$((LOOP_COUNT + 1))" '{count: $c}' > "$STATE_FILE" 2>/dev/null || true
+  echo "$CORE_OUTPUT" | jq '{
+    decision: "block",
+    reason: (.followup_message // "Session chưa hoàn tất theo quy trình OpenMoneta (Bước 5).")
+  }'
+  exit 0
+fi
+
+# Pass → dọn state để session sau đếm lại từ 0.
+rm -f "$STATE_FILE" 2>/dev/null || true
+exit 0

package/claude/settings-hooks.json

@@ -0,0 +1,55 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$HOME/.claude/hooks/openmoneta/sessionstart-adapter.sh\""
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read|Glob|Grep|Write|Edit|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$HOME/.claude/hooks/openmoneta/pretooluse-adapter.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$HOME/.claude/hooks/openmoneta/bash-guard.sh\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$HOME/.claude/hooks/openmoneta/posttooluse-adapter.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$HOME/.claude/hooks/openmoneta/stop-adapter.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}