openmoneta-dev-kit 1.9.0

package/scripts/debug-hooks.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# debug-hooks.sh — kiểm tra nhanh trạng thái hooks OpenMoneta trong 1 project.
+#
+# Usage:
+#   bash ~/.cursor/scripts/debug-hooks.sh /path/to/project
+#   bash ~/.cursor/scripts/debug-hooks.sh .                  # default
+
+set -euo pipefail
+
+PROJECT="${1:-$(pwd)}"
+if [[ -d "$PROJECT" ]]; then
+  PROJECT="$(cd "$PROJECT" && pwd -P)"
+fi
+
+MARKER="$PROJECT/.cursor/.docs-index-read"
+CHANGES="$PROJECT/.cursor/.session-changes.json"
+INDEX="$PROJECT/docs/INDEX.md"
+
+echo "OpenMoneta Hook Debug"
+echo "====================="
+echo "Project: $PROJECT"
+echo "Version: $(cat "$HOME/.cursor/.openmoneta-version" 2>/dev/null || echo "unknown")"
+echo ""
+
+echo "Project files:"
+[[ -f "$INDEX" ]] && echo "  OK docs/INDEX.md: $INDEX" || echo "  MISSING docs/INDEX.md: $INDEX"
+[[ -d "$PROJECT/plans" ]] && echo "  OK plans/: $PROJECT/plans" || echo "  MISSING plans/: $PROJECT/plans"
+echo ""
+
+echo "Session markers:"
+[[ -f "$MARKER" ]] && echo "  OK docs marker exists: $MARKER" || echo "  MISSING docs marker: $MARKER"
+[[ -f "$CHANGES" ]] && echo "  OK session changes: $CHANGES" || echo "  MISSING session changes: $CHANGES"
+echo ""
+
+echo "Installed hooks:"
+for hook in inject-process-context.sh check-plan-exists.sh enforce-docs-first.sh track-changes.sh verify-completion.sh; do
+  path="$HOME/.cursor/hooks/$hook"
+  if [[ -x "$path" ]]; then
+    echo "  OK executable: $path"
+  elif [[ -f "$path" ]]; then
+    echo "  WARN not executable: $path"
+  else
+    echo "  MISSING: $path"
+  fi
+done
+echo ""
+
+echo "Quick enforce-docs-first check:"
+if [[ -f "$HOME/.cursor/hooks/enforce-docs-first.sh" ]]; then
+  printf '{"workspace_roots":["%s"],"tool_name":"Read","tool_input":{"file_path":"%s/src/example.ts"}}\n' "$PROJECT" "$PROJECT" \
+    | bash "$HOME/.cursor/hooks/enforce-docs-first.sh"
+else
+  echo "  Cannot run: enforce-docs-first.sh missing"
+fi

package/scripts/init-project.sh

@@ -0,0 +1,438 @@
+#!/usr/bin/env bash
+# init-project.sh — Khởi tạo cấu trúc OpenMoneta Dev Kit cho 1 project (v1.7.x Lean Mode).
+#
+# IDEMPOTENT: chạy nhiều lần sẽ re-sync file managed và giữ các block riêng của project.
+#
+# v1.7.x chỉ tạo 4 file thiết yếu cho AI navigation:
+#   - AGENTS.md           — quy trình 6 bước
+#   - docs/INDEX.md       — entry point + Token Routing
+#   - plans/INDEX.md      — bảng theo dõi plans
+#   - .gitignore          — patterns chuẩn
+#
+# Các file/folder khác (tests/, .env.test, docs/architecture, CHANGELOG, ...) chỉ tạo khi user yêu cầu cụ thể (on-demand skills).
+#
+# Usage: bash ~/.cursor/scripts/init-project.sh [project-path]
+#        (default: pwd)
+
+set -euo pipefail
+
+PROJECT_DIR="${1:-$(pwd)}"
+PROJECT_DIR="$(cd "$PROJECT_DIR" 2>/dev/null && pwd || echo "$PROJECT_DIR")"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd || pwd)"
+SCRIPT_HOME="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd || echo "")"
+
+if [[ ! -d "$PROJECT_DIR" ]]; then
+  echo "[!] Project dir không tồn tại: $PROJECT_DIR" >&2
+  exit 1
+fi
+
+OPENMONETA_HOME="${OPENMONETA_HOME:-}"
+if [[ -z "$OPENMONETA_HOME" ]]; then
+  if [[ -n "$SCRIPT_HOME" && -d "$SCRIPT_HOME/templates" ]]; then
+    OPENMONETA_HOME="$SCRIPT_HOME"
+  elif [[ -d "$HOME/.cursor/templates" ]]; then
+    OPENMONETA_HOME="$HOME/.cursor"
+  elif [[ -d "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/templates" ]]; then
+    OPENMONETA_HOME="${XDG_CONFIG_HOME:-$HOME/.config}/opencode"
+  else
+    OPENMONETA_HOME="$HOME/.cursor"
+  fi
+fi
+
+TEMPLATES="$OPENMONETA_HOME/templates"
+if [[ ! -d "$TEMPLATES" ]]; then
+  echo "[!] Templates dir không tồn tại: $TEMPLATES" >&2
+  echo "    Cài Cursor:   bash install.sh" >&2
+  echo "    Cài OpenCode: bash install-opencode.sh" >&2
+  exit 1
+fi
+KIT_VERSION=$(cat "$OPENMONETA_HOME/.openmoneta-version" 2>/dev/null || echo "1.7.x")
+
+echo "==> Init OpenMoneta Dev Kit (Lean Mode v$KIT_VERSION) cho: $PROJECT_DIR"
+echo ""
+
+cd "$PROJECT_DIR"
+
+CREATED=()
+UPDATED=()
+SKIPPED=()
+BACKUPS=()
+SYNC_BACKUP_DIR=""
+
+ensure_dir() {
+  local dir="$1"
+  if [[ ! -d "$dir" ]]; then
+    mkdir -p "$dir"
+    CREATED+=("dir: $dir/")
+  fi
+}
+
+copy_if_missing() {
+  local src="$1"
+  local dst="$2"
+  if [[ -f "$dst" ]]; then
+    SKIPPED+=("file: $dst (đã tồn tại)")
+    return
+  fi
+  cp "$src" "$dst"
+  CREATED+=("file: $dst")
+}
+
+ensure_sync_backup_dir() {
+  if [[ -z "$SYNC_BACKUP_DIR" ]]; then
+    SYNC_BACKUP_DIR=".cursor/backups/init-sync-$(date +%Y%m%d-%H%M%S)"
+    mkdir -p "$SYNC_BACKUP_DIR"
+  fi
+}
+
+backup_before_sync() {
+  local dst="$1"
+  ensure_sync_backup_dir
+  local safe_name
+  safe_name="${dst//\//__}"
+  cp -p "$dst" "$SYNC_BACKUP_DIR/$safe_name"
+  BACKUPS+=("$dst -> $SYNC_BACKUP_DIR/$safe_name")
+}
+
+extract_block() {
+  local src="$1"
+  local block="$2"
+  local out="$3"
+  local begin="<!-- BEGIN $block -->"
+  local end="<!-- END $block -->"
+
+  awk -v begin="$begin" -v end="$end" '
+    $0 == begin { in_block = 1; found_begin = 1; next }
+    $0 == end {
+      if (in_block) { found_end = 1 }
+      in_block = 0
+      next
+    }
+    in_block { print }
+    END { exit(found_begin && found_end ? 0 : 1) }
+  ' "$src" > "$out"
+}
+
+extract_section_body() {
+  local src="$1"
+  local heading="$2"
+  local out="$3"
+
+  awk -v heading="$heading" '
+    $0 == heading { in_section = 1; found = 1; next }
+    in_section && /^##[[:space:]]/ { exit }
+    in_section { print }
+    END { exit(found ? 0 : 1) }
+  ' "$src" > "$out"
+}
+
+extract_between_sections() {
+  local src="$1"
+  local start_heading="$2"
+  local stop_heading="$3"
+  local out="$4"
+
+  awk -v start_heading="$start_heading" -v stop_heading="$stop_heading" '
+    $0 == start_heading { in_range = 1; found = 1; print; next }
+    in_range && $0 == stop_heading { exit }
+    in_range { print }
+    END { exit(found ? 0 : 1) }
+  ' "$src" > "$out"
+}
+
+extract_section_table() {
+  local src="$1"
+  local heading="$2"
+  local out="$3"
+
+  awk -v heading="$heading" '
+    $0 == heading { in_section = 1; next }
+    in_section && /^##[[:space:]]/ { exit }
+    in_section && /^\|/ {
+      if (pending_blank) {
+        print ""
+        pending_blank = 0
+      }
+      found = 1
+      print
+      next
+    }
+    in_section && found && /^[[:space:]]*$/ {
+      pending_blank = 1
+      next
+    }
+    END { exit(found ? 0 : 1) }
+  ' "$src" > "$out"
+}
+
+replace_block() {
+  local target="$1"
+  local block="$2"
+  local content_file="$3"
+  local tmp
+  tmp=$(mktemp)
+
+  local begin="<!-- BEGIN $block -->"
+  local end="<!-- END $block -->"
+
+  awk -v begin="$begin" -v end="$end" -v content_file="$content_file" '
+    $0 == begin {
+      print
+      while ((getline line < content_file) > 0) {
+        print line
+      }
+      close(content_file)
+      in_block = 1
+      next
+    }
+    $0 == end {
+      in_block = 0
+      print
+      next
+    }
+    !in_block { print }
+  ' "$target" > "$tmp"
+
+  mv "$tmp" "$target"
+}
+
+sync_agents_md() {
+  local src="$TEMPLATES/AGENTS.md.tpl"
+  local dst="AGENTS.md"
+
+  if [[ ! -f "$dst" ]]; then
+    cp "$src" "$dst"
+    CREATED+=("file: $dst")
+    return
+  fi
+
+  local rendered override
+  rendered=$(mktemp)
+  override=$(mktemp)
+  cp "$src" "$rendered"
+
+  if ! extract_block "$dst" "PROJECT OVERRIDE" "$override"; then
+    {
+      echo "<!-- Nội dung AGENTS.md cũ được giữ lại khi migrate sang managed sync. Hãy review và rút gọn nếu cần. -->"
+      echo ""
+      cat "$dst"
+    } > "$override"
+  fi
+
+  replace_block "$rendered" "PROJECT OVERRIDE" "$override"
+
+  if cmp -s "$rendered" "$dst"; then
+    SKIPPED+=("file: $dst (đã sync, không đổi)")
+    rm -f "$rendered" "$override"
+    return
+  fi
+
+  backup_before_sync "$dst"
+  mv "$rendered" "$dst"
+  rm -f "$override"
+  UPDATED+=("sync: $dst (giữ PROJECT OVERRIDE)")
+}
+
+sync_docs_index() {
+  local src="$TEMPLATES/docs-INDEX.md.tpl"
+  local dst="docs/INDEX.md"
+
+  if [[ ! -f "$dst" ]]; then
+    cp "$src" "$dst"
+    CREATED+=("file: $dst")
+    return
+  fi
+
+  local rendered content
+  rendered=$(mktemp)
+  cp "$src" "$rendered"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT DOC STRUCTURE" "$content" || extract_section_body "$dst" "## Cấu trúc tài liệu" "$content"; then
+    replace_block "$rendered" "PROJECT DOC STRUCTURE" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT MODULES" "$content" || extract_section_body "$dst" "## Modules hiện có" "$content"; then
+    replace_block "$rendered" "PROJECT MODULES" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT TOKEN ROUTING" "$content" || extract_section_body "$dst" "## Feature / Keyword → Module (Token Routing)" "$content"; then
+    replace_block "$rendered" "PROJECT TOKEN ROUTING" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT DOCS NOTES" "$content" || extract_section_body "$dst" "## Ghi chú riêng của dự án" "$content"; then
+    replace_block "$rendered" "PROJECT DOCS NOTES" "$content"
+  fi
+  rm -f "$content"
+
+  if cmp -s "$rendered" "$dst"; then
+    SKIPPED+=("file: $dst (đã sync, không đổi)")
+    rm -f "$rendered"
+    return
+  fi
+
+  backup_before_sync "$dst"
+  mv "$rendered" "$dst"
+  UPDATED+=("sync: $dst (giữ DOC STRUCTURE / MODULES / TOKEN ROUTING / DOCS NOTES)")
+}
+
+sync_plans_index() {
+  local src="$TEMPLATES/plans-INDEX.md.tpl"
+  local dst="plans/INDEX.md"
+
+  if [[ ! -f "$dst" ]]; then
+    cp "$src" "$dst"
+    CREATED+=("file: $dst")
+    return
+  fi
+
+  local rendered content
+  rendered=$(mktemp)
+  cp "$src" "$rendered"
+
+  content=$(mktemp)
+  if extract_block "$dst" "ACTIVE PLANS" "$content" || extract_section_body "$dst" "## Active (đang triển khai)" "$content"; then
+    replace_block "$rendered" "ACTIVE PLANS" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT PLANS EXTRA" "$content" || extract_between_sections "$dst" "## Done (đã hoàn thành, chưa archive)" "## Archived" "$content"; then
+    replace_block "$rendered" "PROJECT PLANS EXTRA" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "ARCHIVED PLANS" "$content" || extract_section_body "$dst" "## Archived (đã Done, đã move sang plans/archive/)" "$content" || extract_section_body "$dst" "## Archived" "$content"; then
+    replace_block "$rendered" "ARCHIVED PLANS" "$content"
+  fi
+  rm -f "$content"
+
+  content=$(mktemp)
+  if extract_block "$dst" "PROJECT PLANS NOTES" "$content" || extract_section_body "$dst" "## Ghi chú riêng của dự án" "$content"; then
+    replace_block "$rendered" "PROJECT PLANS NOTES" "$content"
+  fi
+  rm -f "$content"
+
+  if cmp -s "$rendered" "$dst"; then
+    SKIPPED+=("file: $dst (đã sync, không đổi)")
+    rm -f "$rendered"
+    return
+  fi
+
+  backup_before_sync "$dst"
+  mv "$rendered" "$dst"
+  UPDATED+=("sync: $dst (giữ ACTIVE PLANS / PLANS EXTRA / ARCHIVED PLANS / PLANS NOTES)")
+}
+
+sync_opencode_project_guard() {
+  # Guard is now global-only (~/.config/opencode/plugins/).
+  # Just clean up any old project-level plugins from pre-v1.9 migration.
+  rm -rf ".opencode/plugins" ".opencode/plugin" 2>/dev/null || true
+}
+
+# === Bước 1: Tạo cấu trúc thư mục tối thiểu ===
+echo "==> Tạo thư mục tối thiểu..."
+ensure_dir "docs"
+ensure_dir "docs/modules"
+ensure_dir "plans"
+ensure_dir "plans/archive"
+ensure_dir ".cursor"
+
+# === Bước 2: Sync managed templates, giữ block riêng của project ===
+echo "==> Sync managed templates..."
+
+sync_agents_md
+sync_docs_index
+sync_plans_index
+sync_opencode_project_guard
+
+# === Bước 3: .gitignore với patterns chuẩn ===
+echo "==> Update .gitignore..."
+GITIGNORE=".gitignore"
+PATTERNS=(
+  ".cursor/.session-changes.json"
+  ".cursor/.docs-index-read"
+  ".cursor/.openmoneta-guard-loaded.json"
+  ".cursor/.changelog-baseline"
+  ".cursor/.last-test-result"
+  ".cursor/.ui-session.json"
+)
+
+if [[ ! -f "$GITIGNORE" ]]; then
+  {
+    echo "# OpenMoneta Dev Kit"
+    printf '%s\n' "${PATTERNS[@]}"
+  } > "$GITIGNORE"
+  CREATED+=("file: .gitignore")
+else
+  ADDED=0
+  TO_ADD=()
+  for p in "${PATTERNS[@]}"; do
+    if ! grep -qFx "$p" "$GITIGNORE"; then
+      TO_ADD+=("$p")
+      ADDED=1
+    fi
+  done
+  if [[ $ADDED -eq 1 ]]; then
+    {
+      echo ""
+      echo "# OpenMoneta Dev Kit"
+      printf '%s\n' "${TO_ADD[@]}"
+    } >> "$GITIGNORE"
+    CREATED+=("update: .gitignore (thêm ${#TO_ADD[@]} patterns)")
+  else
+    SKIPPED+=("file: .gitignore (đã có patterns)")
+  fi
+fi
+
+# === Báo cáo ===
+echo ""
+echo "================================================"
+echo "✅ Init OpenMoneta Dev Kit (Lean Mode) hoàn tất."
+echo "================================================"
+echo ""
+echo "Đã tạo (${#CREATED[@]}):"
+if [[ ${#CREATED[@]} -gt 0 ]]; then
+  for item in "${CREATED[@]}"; do
+    echo "  + $item"
+  done
+fi
+if [[ ${#UPDATED[@]} -gt 0 ]]; then
+  echo ""
+  echo "Đã update (${#UPDATED[@]}):"
+  for item in "${UPDATED[@]}"; do
+    echo "  ~ $item"
+  done
+fi
+if [[ ${#BACKUPS[@]} -gt 0 ]]; then
+  echo ""
+  echo "Backup trước khi sync (${#BACKUPS[@]}):"
+  for item in "${BACKUPS[@]}"; do
+    echo "  - $item"
+  done
+fi
+if [[ ${#SKIPPED[@]} -gt 0 ]]; then
+  echo ""
+  echo "Đã skip (${#SKIPPED[@]}):"
+  for item in "${SKIPPED[@]}"; do
+    echo "  - $item"
+  done
+fi
+echo ""
+echo "Bước tiếp theo:"
+echo "  1. Đọc AGENTS.md (quy trình 6 bước, Adaptive Planning + B6 conditional)."
+echo "  2. Edit docs/INDEX.md → mô tả modules + cập nhật bảng Token Routing."
+echo ""
+echo "On-demand (chỉ khi user yêu cầu):"
+echo "  - Test (Playwright/Vitest):  chạy skill 'automated-testing' khi cần."
+echo "  - Test bypass auth:          chạy skill 'auth-bypass-testing' khi cần."
+echo "  - Security audit:            chạy skill 'security-checklist' khi cần."
+echo "  - Architecture docs:         tự tạo docs/architecture/ khi dự án lớn."
+echo "  - Project CHANGELOG:         tự tạo CHANGELOG.md khi cần publish release."

package/scripts/list-affected-modules.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+# list-affected-modules.sh — infer module slug từ .session-changes.json hoặc danh sách path.
+#
+# Usage:
+#   bash list-affected-modules.sh .cursor/.session-changes.json
+#   bash list-affected-modules.sh                   # default .cursor/.session-changes.json
+#   echo "apps/landing/src/x.ts" | bash list-affected-modules.sh -    # đọc paths từ stdin
+#
+# Output: 1 module slug per line (sorted, unique). Format: <slug>\t<docs_path>\t<source_path>
+
+set -euo pipefail
+
+INPUT="${1:-.cursor/.session-changes.json}"
+
+read_paths() {
+  if [[ "$INPUT" == "-" ]]; then
+    cat
+  elif [[ -f "$INPUT" ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      jq -r '.changes[]?.path // empty' "$INPUT"
+    else
+      grep -oE '"path"[[:space:]]*:[[:space:]]*"[^"]+"' "$INPUT" | sed 's/.*"\([^"]*\)"$/\1/'
+    fi
+  else
+    echo "[!] Input không tồn tại: $INPUT" >&2
+    return 1
+  fi
+}
+
+infer() {
+  awk -F/ '
+    # Skip empty
+    NF == 0 { next }
+    # Whitelist không phải code module
+    /^docs\// { next }
+    /^plans\// { next }
+    /^tests\// { next }
+    /^scripts\// { next }
+    /^infra\// { next }
+    /^logs\// { next }
+    /^\.cursor\// { next }
+    /^node_modules\// { next }
+    $0 == "AGENTS.md" { next }
+    $0 == "CHANGELOG.md" { next }
+    $0 == "README.md" { next }
+    $0 == ".gitignore" { next }
+    $0 == ".env.example" { next }
+
+    # apps/<x>/...
+    /^apps\// && NF >= 2 {
+      slug = "apps-" $2
+      print slug "\tdocs/modules/" slug "\tapps/" $2
+      next
+    }
+    # packages/<x>/...
+    /^packages\// && NF >= 2 {
+      slug = "packages-" $2
+      print slug "\tdocs/modules/" slug "\tpackages/" $2
+      next
+    }
+    # src/modules/<x>/...
+    /^src\/modules\// && NF >= 3 {
+      print $3 "\tdocs/modules/" $3 "\tsrc/modules/" $3
+      next
+    }
+    # src/<x>/... (single-repo, không có modules/)
+    /^src\// && NF >= 2 && $2 != "modules" {
+      print $2 "\tdocs/modules/" $2 "\tsrc/" $2
+      next
+    }
+  ' | sort -u
+}
+
+read_paths | infer