openmoneta-dev-kit 1.12.0 → 1.13.0

package/VERSION

@@ -1 +1 @@
-1.12.0
+1.13.0

package/hooks/inject-process-context.sh

@@ -10,12 +10,30 @@ set -euo pipefail
 
 INPUT_JSON=$(cat 2>/dev/null || echo '{}')
 
+# Auto-register project vào Cursor registry (seed cho `update --all-projects`).
+# Im lặng. Chỉ append khi: workspace có docs/INDEX.md, Cursor install home đã cài,
+# và path chưa có trong registry (dedup, chuẩn hoá pwd -P).
+register_project_cursor() {
+  local ws="$1"
+  [[ -n "$ws" && -f "$ws/docs/INDEX.md" ]] || return 0
+  [[ -f "$HOME/.cursor/.openmoneta-version" ]] || return 0
+  local reg="$HOME/.cursor/.openmoneta-projects"
+  local abs
+  abs="$(cd "$ws" 2>/dev/null && pwd -P)" || return 0
+  [[ -n "$abs" ]] || return 0
+  if [[ -f "$reg" ]] && grep -qFx "$abs" "$reg" 2>/dev/null; then
+    return 0
+  fi
+  echo "$abs" >> "$reg" 2>/dev/null || true
+}
+
 # Reset docs-index marker mỗi session (force re-read INDEX.md)
 if command -v jq >/dev/null 2>&1; then
   WORKSPACE_FROM_INPUT=$(echo "$INPUT_JSON" | jq -r '.workspace_roots[0] // ""' 2>/dev/null || echo "")
   if [[ -n "$WORKSPACE_FROM_INPUT" && -d "$WORKSPACE_FROM_INPUT/.cursor" ]]; then
     rm -f "$WORKSPACE_FROM_INPUT/.cursor/.docs-index-read" 2>/dev/null || true
   fi
+  register_project_cursor "$WORKSPACE_FROM_INPUT" 2>/dev/null || true
 fi
 
 # === Summary 6 bước (~45 dòng, ~650 tokens) ===

package/opencode/plugins/openmoneta-guard.ts

@@ -400,6 +400,33 @@ function clearVerifyLoop(root: string) {
   fs.rmSync(path.join(root, ".cursor", ".openmoneta-verify-loop.json"), { force: true })
 }
 
+// Auto-register project vào OpenCode registry (seed cho `update --all-projects`).
+// Im lặng + try/catch — seed không được phép làm fail guard. Chỉ append khi:
+// project có docs/INDEX.md, OpenCode install home đã cài, path chưa có trong registry.
+function registerProjectOpenCode(root: string) {
+  try {
+    if (!fs.existsSync(path.join(root, "docs", "INDEX.md"))) return
+    const home = process.env.HOME || process.env.USERPROFILE || ""
+    const xdg = process.env.XDG_CONFIG_HOME || path.join(home, ".config")
+    const ocHome = path.join(xdg, "opencode")
+    if (!fs.existsSync(path.join(ocHome, ".openmoneta-version"))) return
+    const reg = path.join(ocHome, ".openmoneta-projects")
+    const abs = fs.realpathSync(root)
+    let lines: string[] = []
+    if (fs.existsSync(reg)) {
+      lines = fs
+        .readFileSync(reg, "utf8")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean)
+    }
+    if (lines.includes(abs)) return
+    fs.appendFileSync(reg, `${abs}\n`)
+  } catch {
+    // im lặng
+  }
+}
+
 type SessionPromptClient = {
   session?: {
     prompt?: (input: {
@@ -434,7 +461,7 @@ export const OpenMonetaGuard = async (ctx: GuardContext) => {
       {
         loaded_at: new Date().toISOString(),
         root,
-        version: "1.11.0",
+        version: "1.13.0",
         load_count: globalState[globalKey],
       },
       null,
@@ -442,6 +469,9 @@ export const OpenMonetaGuard = async (ctx: GuardContext) => {
     )}\n`,
   )
 
+  // Seed project vào OpenCode registry để `update --all-projects` thấy project này.
+  registerProjectOpenCode(root)
+
   // OpenCode does not have Cursor's sessionStart hook, so reset the docs-first
   // marker when the plugin is loaded for a new OpenCode process/session.
   if (fs.existsSync(marker)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmoneta-dev-kit",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "OpenMoneta Dev Kit — Biến Cursor IDE / OpenCode thành team developer hoàn chỉnh với quy trình 6 bước, adaptive planning, hooks enforcement, và token-aware doc routing",
   "keywords": [
     "cursor",

package/skills/docs-maintenance/SKILL.md

@@ -42,14 +42,14 @@ Stale docs còn tệ hơn không có docs — session sau AI đọc sai, làm sa
 
 ## Workflow
 
-### 1. Lấy danh sách (deterministic)
+### 1. Lấy danh sách + soi ghost (deterministic)
 
 ```bash
-bash ~/.cursor/scripts/docs-audit.sh --worklist
-# Output TSV: <slug>\t<docsPath>\t<sourcePath>\t<missing|stale|ok>
+bash ~/.cursor/scripts/docs-audit.sh --worklist    # MISSING/STALE/ok (TSV: slug\tdocs\tsource\tstatus)
+bash ~/.cursor/scripts/docs-audit.sh --validate     # liệt kê GHOST (doc/INDEX trỏ source/module đã mất)
 ```
 
-(OpenCode: `~/.config/opencode/scripts/docs-audit.sh`.) Mode `audit` chỉ in report rồi dừng, không qua các bước dưới.
+(OpenCode: `~/.config/opencode/scripts/docs-audit.sh`.) **BẮT BUỘC chạy cả `--validate`** ở mọi mode để không bỏ sót ghost. Mode `audit` in cả 2 kết quả rồi dừng, không qua các bước tạo/sửa dưới.
 
 ### 2. (Repo lớn) đọc song song
 
@@ -75,7 +75,7 @@ Cho mỗi module status `stale`:
 ### 5. Sync `docs/INDEX.md`
 
 - Module mới → thêm dòng vào bảng "Modules hiện có" + **3-5 keyword (VN+EN)** vào bảng "Token Routing" (bắt buộc, để hook docs-first + token-aware reading hoạt động).
-- GHOST → báo user, đề xuất xóa dòng/thư mục (KHÔNG tự xóa nếu chưa chắc).
+- **GHOST** (từ `--validate` ở Bước 1) → LIỆT KÊ rõ từng ghost cho user. **KHÔNG tự xóa** — map slug→source là heuristic, có thể là module vừa đổi tên/di chuyển. Hỏi user bằng `AskQuestion` (xóa doc/dòng INDEX, hay map lại sang source mới); chỉ thao tác sau khi user xác nhận từng cái.
 
 ### 6. Report cuối
 

package/src/commands/update.js

@@ -57,6 +57,104 @@ function pruneRegistry() {
   return pruned
 }
 
+const SCAN_PRUNE_DIRS = new Set([
+  "node_modules",
+  ".git",
+  "Library",
+  ".Trash",
+  ".cache",
+  ".npm",
+  ".cargo",
+  ".gradle",
+  ".venv",
+  "dist",
+  "build",
+])
+
+function findProjects(root, maxDepth) {
+  const out = []
+  function walk(dir, depth) {
+    if (depth > maxDepth) return
+    if (isOpenmonetaProject(dir)) {
+      try {
+        fs.accessSync(path.join(dir, "AGENTS.md"))
+        out.push(dir)
+      } catch {
+        // thiếu AGENTS.md → không tính là OM project khi scan
+      }
+    }
+    let entries
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue
+      if (SCAN_PRUNE_DIRS.has(e.name) || e.name.startsWith(".")) continue
+      walk(path.join(dir, e.name), depth + 1)
+    }
+  }
+  walk(root, 0)
+  return out
+}
+
+function scanSeed(root, pkgRoot) {
+  let absRoot
+  try {
+    absRoot = fs.realpathSync(root)
+  } catch {
+    console.log(`  [!] Scan root không tồn tại: ${root}`)
+    return
+  }
+  const targets = ["cursor", "opencode"].filter((t) => isInstalled(t))
+  if (targets.length === 0) {
+    console.log(`  [!] Chưa có install home nào để seed registry.`)
+    return
+  }
+  let kitRoot
+  try {
+    kitRoot = fs.realpathSync(pkgRoot)
+  } catch {
+    kitRoot = pkgRoot
+  }
+  const uniq = [
+    ...new Set(
+      findProjects(absRoot, 5)
+        .map((p) => {
+          try {
+            return fs.realpathSync(p)
+          } catch {
+            return p
+          }
+        })
+        .filter((p) => p !== kitRoot)
+    ),
+  ]
+  let seeded = 0
+  for (const t of targets) {
+    const reg = getProjectRegistry(t)
+    let existing = new Set()
+    try {
+      existing = new Set(
+        fs
+          .readFileSync(reg, "utf8")
+          .split("\n")
+          .map((l) => l.trim())
+          .filter(Boolean)
+      )
+    } catch {
+      // registry chưa tồn tại → tạo mới khi append
+    }
+    const toAdd = uniq.filter((p) => !existing.has(p))
+    if (toAdd.length) {
+      fs.appendFileSync(reg, toAdd.map((p) => `${p}\n`).join(""))
+      seeded += toAdd.length
+    }
+  }
+  console.log(`  Scan: thấy ${uniq.length} OM project, seed ${seeded} entry mới.`)
+}
+
 function syncProject(initScript, dir) {
   if (isWindows()) {
     execSync(`bash "${initScript}" "${dir}"`, { stdio: "inherit", shell: true })
@@ -69,7 +167,14 @@ async function run(args) {
   const checkOnly = args.includes("--check")
   const autoYes = args.includes("--yes") || args.includes("-y")
   const skipProjects = args.includes("--skip-projects")
-  const allProjects = args.includes("--all-projects")
+  const scanIdx = args.indexOf("--scan")
+  const scan = scanIdx !== -1
+  let scanRoot = process.env.HOME || process.env.USERPROFILE || "."
+  if (scan) {
+    const next = args[scanIdx + 1]
+    if (next && !next.startsWith("-")) scanRoot = next
+  }
+  const allProjects = args.includes("--all-projects") || scan
   const force = args.includes("--force")
 
   const local = getLocalVersion()
@@ -140,6 +245,11 @@ async function run(args) {
     const initScript = path.join(pkgRoot, "scripts", "init-project.sh")
     const cwd = process.cwd()
 
+    if (scan) {
+      console.log(`\n  ▶ --scan: dò OM project để seed registry...`)
+      scanSeed(scanRoot, pkgRoot)
+    }
+
     if (allProjects) {
       const pruned = pruneRegistry()
       if (pruned > 0) console.log(`\n  ℹ Registry: prune ${pruned} entry chết.`)
@@ -196,4 +306,7 @@ async function run(args) {
   console.log(`\n  🎉 Hoàn tất. Restart Cursor/OpenCode để áp dụng.`)
 }
 
-module.exports = { run, _internal: { isOpenmonetaProject, readRegistry, pruneRegistry } }
+module.exports = {
+  run,
+  _internal: { isOpenmonetaProject, readRegistry, pruneRegistry, findProjects, scanSeed },
+}

package/update.ps1

@@ -7,6 +7,7 @@
 #   .\update.ps1 -Check                 # chỉ check, không cài
 #   .\update.ps1 -Project C:\path       # global + sync thêm project chỉ định
 #   .\update.ps1 -AllProjects           # global + sync MỌI project trong registry
+#   .\update.ps1 -Scan [-ScanRoot path] # dò OM project (mặc định $HOME) → seed registry → sync all
 #   .\update.ps1 -SkipProjects          # global only (old behavior)
 
 param(
@@ -15,6 +16,8 @@ param(
     [switch]$Check,
     [switch]$SkipProjects,
     [switch]$AllProjects,
+    [switch]$Scan,
+    [string]$ScanRoot,
     [string[]]$Project
 )
 
@@ -124,6 +127,49 @@ function Invoke-PruneRegistry {
     return $pruned
 }
 
+# Helper: scan tìm OM project (docs\INDEX.md + AGENTS.md) → seed registry mỗi home tồn tại
+function Invoke-ScanSeed {
+    $root = if ($ScanRoot) { $ScanRoot } else { $env:USERPROFILE }
+    $absRoot = (Resolve-Path $root -ErrorAction SilentlyContinue).Path
+    if (-not $absRoot) { Write-Host "  [!] Scan root không tồn tại: $root"; return }
+
+    $homes = @()
+    if (Test-Path (Join-Path $env:USERPROFILE ".cursor\.openmoneta-version")) {
+        $homes += (Join-Path $env:USERPROFILE ".cursor\.openmoneta-projects")
+    }
+    $ocBase = if ($env:XDG_CONFIG_HOME) { "$env:XDG_CONFIG_HOME\opencode" } else { "$env:USERPROFILE\.config\opencode" }
+    if (Test-Path (Join-Path $ocBase ".openmoneta-version")) {
+        $homes += (Join-Path $ocBase ".openmoneta-projects")
+    }
+    if ($homes.Count -eq 0) { Write-Host "  [!] Chưa có install home nào để seed registry."; return }
+
+    $prune = @('node_modules', '.git', 'Library', '.Trash', '.cache', '.npm', '.cargo', '.gradle', '.venv', 'dist', 'build')
+    Write-Host "  Scanning '$absRoot' (depth ~6)..."
+    $indexes = Get-ChildItem -Path $absRoot -Recurse -Depth 6 -Filter "INDEX.md" -File -ErrorAction SilentlyContinue |
+        Where-Object { (Split-Path $_.DirectoryName -Leaf) -eq "docs" }
+
+    $found = 0; $seeded = 0
+    $absKit = (Resolve-Path $RepoDir -ErrorAction SilentlyContinue).Path
+    foreach ($idx in $indexes) {
+        $proj = Split-Path (Split-Path $idx.FullName -Parent) -Parent
+        $skip = $false
+        foreach ($d in $prune) { if ($proj -like "*\$d\*" -or $proj -like "*\$d") { $skip = $true; break } }
+        if ($skip) { continue }
+        if (-not (Test-Path (Join-Path $proj "AGENTS.md"))) { continue }
+        $abs = (Resolve-Path $proj -ErrorAction SilentlyContinue).Path
+        if (-not $abs -or $abs -eq $absKit) { continue }
+        $found++
+        foreach ($reg in $homes) {
+            $existing = @()
+            if (Test-Path $reg) { $existing = Get-Content $reg | ForEach-Object { $_.Trim() } | Where-Object { $_ } }
+            if ($existing -contains $abs) { continue }
+            Add-Content -Path $reg -Value $abs
+            $seeded++
+        }
+    }
+    Write-Host "  Scan: thấy $found OM project, seed $seeded entry mới vào registry."
+}
+
 # Helper: collect projects to sync
 function Get-OpenMonetaProjects {
     $found = @()
@@ -262,6 +308,13 @@ if ($SkipProjects) {
     exit 0
 }
 
+if ($Scan) {
+    $AllProjects = $true
+    Write-Host ""
+    Write-Host "==> -Scan: dò OM project để seed registry..."
+    Invoke-ScanSeed
+}
+
 if ($AllProjects) {
     Write-Host ""
     Write-Host "==> -AllProjects: dọn registry + gom mọi project đã đăng ký..."

package/update.sh

@@ -9,6 +9,7 @@
 #   bash update.sh --check              # chỉ check, không cài
 #   bash update.sh --project /path      # global + sync thêm project chỉ định
 #   bash update.sh --all-projects       # global + sync MỌI project trong registry
+#   bash update.sh --scan [root]        # dò OM project (mặc định $HOME) → seed registry → sync all
 #   bash update.sh --skip-projects      # global only (old behavior)
 
 set -euo pipefail
@@ -22,31 +23,42 @@ SKIP_PROJECTS=0
 FORCE=0
 CHECK_ONLY=0
 ALL_PROJECTS=0
+SCAN=0
+SCAN_ROOT=""
 PROJECT_PATHS=()
 
-for arg in "$@"; do
-  case "$arg" in
+while [[ $# -gt 0 ]]; do
+  case "$1" in
     --yes|-y) AUTO_YES=1 ;;
     --force) FORCE=1 ;;
     --check) CHECK_ONLY=1 ;;
     --all-projects) ALL_PROJECTS=1 ;;
     --skip-projects) SKIP_PROJECTS=1 ;;
+    --scan)
+      SCAN=1
+      ALL_PROJECTS=1
+      if [[ -n "${2:-}" && "${2:-}" != -* ]]; then
+        SCAN_ROOT="$2"
+        shift
+      fi
+      ;;
     --help|-h)
-      grep '^#' "$0" | sed 's/^# \?//' | head -17
+      grep '^#' "$0" | sed 's/^# \?//' | head -18
       exit 0
       ;;
     --project)
-      shift
-      if [[ -n "${1:-}" && "${1:-}" != -* ]]; then
-        PROJECT_PATHS+=("$1")
+      if [[ -n "${2:-}" && "${2:-}" != -* ]]; then
+        PROJECT_PATHS+=("$2")
+        shift
       fi
       ;;
     *)
-      if [[ "$arg" != -* ]]; then
-        PROJECT_PATHS+=("$arg")
+      if [[ "$1" != -* ]]; then
+        PROJECT_PATHS+=("$1")
       fi
       ;;
   esac
+  shift
 done
 
 cd "$REPO_DIR"
@@ -146,6 +158,45 @@ prune_registry() {
   return 0
 }
 
+# === Helper: scan tìm OM project (docs/INDEX.md + AGENTS.md) → seed registry mỗi home tồn tại ===
+scan_seed() {
+  local root="${SCAN_ROOT:-$HOME}"
+  local abs_root
+  abs_root="$(cd "$root" 2>/dev/null && pwd -P)" || { echo "  [!] Scan root không tồn tại: $root"; return 0; }
+
+  local homes=()
+  [[ -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")
+  if [[ ${#homes[@]} -eq 0 ]]; then
+    echo "  [!] Chưa có install home nào để seed registry."
+    return 0
+  fi
+
+  echo "  Scanning '$abs_root' (maxdepth project ~5)..."
+  local found=0 seeded=0 idx proj abs reg
+  while IFS= read -r idx; do
+    proj="$(dirname "$(dirname "$idx")")"
+    [[ -f "$proj/AGENTS.md" ]] || continue
+    abs="$(cd "$proj" 2>/dev/null && pwd -P)" || continue
+    [[ -z "$abs" || "$abs" == "$REPO_DIR" ]] && continue
+    found=$((found + 1))
+    for reg in "${homes[@]}"; do
+      if [[ -f "$reg" ]] && grep -qFx "$abs" "$reg" 2>/dev/null; then
+        continue
+      fi
+      echo "$abs" >> "$reg"
+      seeded=$((seeded + 1))
+    done
+  done < <(find "$abs_root" -maxdepth 7 \
+      \( -name node_modules -o -name .git -o -name Library -o -name .Trash \
+         -o -name .cache -o -name .npm -o -name .cargo -o -name .gradle \
+         -o -name .venv -o -name dist -o -name build \) -prune -o \
+      -type f -path '*/docs/INDEX.md' -print 2>/dev/null)
+
+  echo "  Scan: thấy $found OM project, seed $seeded entry mới vào registry."
+}
+
 # === Helper: collect projects to sync ===
 collect_projects() {
   local found=()
@@ -293,6 +344,12 @@ print_registry_hint() {
   return 0
 }
 
+if [[ $SCAN -eq 1 ]]; then
+  echo ""
+  echo "==> --scan: dò OM project để seed registry..."
+  scan_seed
+fi
+
 if [[ $ALL_PROJECTS -eq 1 ]]; then
   echo ""
   echo "==> --all-projects: dọn registry + gom mọi project đã đăng ký..."