kiem-tra-go-tieng-viet

Cursor Agent Skill + dự án Speckit trên macOS — chẩn đoán và xử lý lỗi bàn phím liên quan:

Host tham chiếu: IMac.local / vt7211 · Barrier server → Windows · gõ VN bằng Telex hệ thống (EVKey optional).

Speckit feature: 001-secure-input-release — COMPLETE (2026-10-17). Xem SUCCESS-CRITERIA.md.

---

Mở workspace

open ~/.cursor/skills/kiem-tra-go-tieng-viet/kiem-tra-go-tieng-viet.code-workspace

Agent: đọc SKILL.md trước khi sửa lỗi lâu dài. Bộ nhớ sự cố: CONTEXT.md.

---

Cấu trúc thư mục

kiem-tra-go-tieng-viet/
├── SKILL.md                 # Hướng dẫn agent (entry skill)
├── CONTEXT.md               # Lịch sử sự cố + quyết định đã chốt
├── REFERENCE.md             # Lệnh / API (SACLock, ioreg, watchdog)
├── CHECKLIST-NHA-SI.md      # Checklist vận hành (Log Out path + remap)
├── README.md                # File này
├── kiem-tra-go-tieng-viet.code-workspace
├── scripts/                 # Công cụ CLI
├── specs/001-secure-input-release/   # Speckit feature
│   ├── spec.md
│   ├── plan.md
│   ├── tasks.md
│   ├── SUCCESS-CRITERIA.md
│   ├── KEYBOARD-GRABBER-ABTEST.md    # A/B: Barrier remap = root cause chữ
│   └── ANALYSIS.md
├── .specify/                # Speckit (constitution, templates, scripts)
└── .cursor/skills/speckit-* # Slash-skills Speckit cho Cursor

---

Cài symlink + watchdog (một lần)

bash ~/.cursor/skills/kiem-tra-go-tieng-viet/scripts/install-secure-input-watchdog.sh

Tạo/ cập nhật:

LaunchAgent: com.user.secure-input-watchdog (30s; SI cùng PID ≥90s → auto-lock; grace sau unlock).

---

Lệnh nhanh

# Chẩn đoán (luôn chạy trước)
diagnose-go-tieng-viet

# Lớp A — nhả Secure Input
nha-secure-input              # khóa màn hình; mở bằng MẬT KHẨU (tránh Touch ID)
nha-secure-input --check      # chỉ kiểm tra SI
# loginwindow kẹt lâu / không UI → Apple menu → Log Out (không Restart)

# Barrier sau khi SI = off
fix-barrier-keyboard
fix-barrier-keyboard --wait   # poll SI tắt rồi restart Barrier

# Lớp B — mất chữ trên Mac (SI đã off)
fix-keyboard-grabbers        # báo cáo + soft
fix-keyboard-grabbers --stop # ưu tiên quit Barrier (+ grabber khác)
fix-keyboard-grabbers --restore

# Soft fix gõ VN (Telex ưu tiên; EVKey tùy chọn)
fix-go-tieng-viet
fix-go-tieng-viet --lock
fix-go-tieng-viet --evkey

Regression lock API:

bash scripts/check-lock-api.sh
bash scripts/validate-watchdog-state.sh --self-test

---

Quyết định đã chốt (đừng đảo)

1. Khóa màn hình: chỉ SACLockScreenImmediate — không dùng path CGSession (đã chết trên macOS này).
2. Deep-stuck SI (loginwindow nhiều giờ, không UI): Log Out; không hứa soft-fix / không inject loginwindow.
3. Gõ VN ổn định: VietnameseIM Telex; EVKey không bắt buộc.
4. ~/barrier.conf: mọi keystroke(Super|Meta+chữ) = … phải comment. Bật lại → mất đúng chữ đó trên Mac.
   Backup gốc: ~/barrier.conf.bak-asv-20261017.
   Sang Windows: dùng Ctrl (Cmd không còn map qua Barrier).
5. AnyDesk autostart trên host này: đã Disabled / RunAtLoad=false.

Chi tiết dài: CONTEXT.md · A/B: KEYBOARD-GRABBER-ABTEST.md.

---

Scripts

---

Speckit

Slash skills trong .cursor/skills/speckit-* (specify, plan, tasks, implement, analyze, …).

Optional còn lại (không chặn đóng feature): Touch ID vs password nest-count; flag SECURE_INPUT_DEEP_STUCK — xem plan.md.

---

Phân nhánh khi user báo lỗi

diagnose-go-tieng-viet
        │
        ├─ SECURE_INPUT_ACTIVE=yes ──► nha-secure-input
        │         └─ vẫn on + loginwindow lâu ──► Log Out
        │
        ├─ SI=off + mất chữ Mac ──► xem BARRIER_CONF_ACTIVE_LETTER_REMAPS
        │         └─ hoặc fix-keyboard-grabbers --stop
        │
        └─ SI=off + chỉ phím Win hỏng ──► fix-barrier-keyboard

Checklist tay: CHECKLIST-NHA-SI.md.