viepilot 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -9,8 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Enhanced
 
-- **M1.15 / Phase 18 (FEAT-004) in progress** — npm publish distribution scaffold: package publish metadata, release scripts, secure GitHub Actions `release-npm` workflow, and maintainer publish/rollback guide. Final registry smoke verify is blocked pending npm publish auth.
+- **M1.17 / Phase 21 (ENH-013) completed** — realigned README metrics (`npm run readme:sync` with `cloc`) and moved `.viepilot` to local-only (`.gitignore` + untracked index).
+- **M1.15 / Phase 18 (FEAT-004) completed** — npm distribution flow is now fully closed: publish pipeline passes and package released to npm as `viepilot@1.0.1`.
 - **M1.15 / Phase 19 (FEAT-005) completed** — installer now supports keyboard selector UX (arrow/space/enter), added `viepilot uninstall` command (`--target`, `--yes`, `--dry-run`), and switched dev installer to copy-first flow to avoid symlink-based skill discovery failures.
+- **M1.16 / Phase 20 (FEAT-006) completed** — added README LOC auto-sync command (`npm run readme:sync`) driven by `cloc` with non-blocking fallback, installer `cloc` dependency checks/guidance, and a donate section in README with PayPal/MOMO links.
 
 ### Fixed
 
@@ -19,6 +21,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Documentation
 
 - `README.md`, `docs/user/quick-start.md` — updated install wizard controls and uninstall command examples.
+- `README.md`, `docs/troubleshooting.md`, `docs/user/quick-start.md` — documented README metric sync flow, `cloc` fallback/install guidance, and maintainer usage.
 - `docs/troubleshooting.md` — added selector TTY fallback guidance and uninstall/reinstall recovery flow for legacy symlink installs.
 - `README.md` — Project Scale LOC + M1.11 completion banner; Documentation row includes `api/`
 - `.viepilot/audit-report.md` — PASS after README metric sync (`/vp-audit`)

package/README.md

@@ -16,13 +16,19 @@ ViePilot là bộ skill framework cho phép AI assistant (Claude, GPT, etc.) ph
 
 ViePilot is a skill framework that enables AI assistants to develop projects **autonomously**, with **control points**, and **recovery capability**. Built with professional standards: Semantic Versioning, Conventional Commits, Keep a Changelog.
 
+### Support ViePilot
+
+Nếu ViePilot giúp ích cho bạn, bạn có thể ủng hộ một ly cafe:
+- PayPal: [https://paypal.me/SATCODING](https://paypal.me/SATCODING)
+- MOMO: [https://me.momo.vn/aMINujUPTbIRtbTli6Fd](https://me.momo.vn/aMINujUPTbIRtbTli6Fd)
+
 ---
 
 ## Quy mô dự án / Project Scale
 
 | Chỉ số / Metric | Giá trị / Value |
 |-----------------|-----------------|
-| Total LOC | **~24,000+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
+| Total LOC | **~22,384+** (`.md`, `.js`, `.cjs`, `.yml`, `.json`, `.sh`; không gồm `node_modules`) |
 | Skills | **14** |
 | Workflows | **12** |
 | Templates | **16** (Project: 11, Phase: 5) |
@@ -31,6 +37,8 @@ ViePilot is a skill framework that enables AI assistants to develop projects **a
 | ViePilot phases (repo) | **15** hoàn thành (xem `.viepilot/TRACKER.md`) |
 | Standards | 5 (SemVer, Commits, Changelog, Comments, Contributors) |
 
+> Metric `Total LOC` có thể được refresh tự động bằng `npm run readme:sync` (dùng `cloc`; nếu thiếu `cloc` script sẽ fallback an toàn).
+
 ### Phân bổ / Breakdown
 
 | Thành phần / Component | Số lượng / Count | Mô tả / Description |

package/dev-install.sh

@@ -31,6 +31,20 @@ echo "  Target: $CURSOR_SKILLS_DIR, $VIEPILOT_DIR"
 echo "  Profile: $INSTALL_PROFILE"
 echo ""
 
+check_cloc_dependency() {
+    if command -v cloc >/dev/null 2>&1; then
+        echo -e "  ${GREEN}✓${NC} cloc detected"
+        return 0
+    fi
+
+    echo -e "${YELLOW}  cloc not found.${NC}"
+    echo "  README LOC auto-sync will fallback safely, but metrics won't refresh automatically."
+    echo "  Install suggestion:"
+    echo "    - macOS: brew install cloc"
+    echo "    - Ubuntu/Debian: sudo apt-get install -y cloc"
+    echo "    - Windows: choco install cloc"
+}
+
 # Confirm
 if [ "$AUTO_YES" != "1" ]; then
     read -p "This will replace existing installation with dev files. Continue? (y/n) " -n 1 -r
@@ -95,6 +109,7 @@ echo -e "  ${GREEN}✓${NC} templates"
 echo -e "  ${GREEN}✓${NC} bin"
 echo -e "  ${GREEN}✓${NC} lib"
 echo -e "  ${GREEN}✓${NC} ui-components"
+check_cloc_dependency
 
 # Count installed
 SKILL_COUNT=$(ls -d "$CURSOR_SKILLS_DIR"/vp-*/ 2>/dev/null | wc -l | tr -d ' ')

package/docs/troubleshooting.md

@@ -41,6 +41,22 @@ npx viepilot install --target cursor-agent --yes
 
 ---
 
+### README LOC metric is not updating
+
+**Cause**: `cloc` is not installed, so `readme:sync` skips update by design.
+
+```bash
+# Install cloc (macOS)
+brew install cloc
+
+# Then rerun metric sync
+npm run readme:sync
+```
+
+On Linux/Windows, use your package manager (`apt`, `dnf`, `choco`) to install `cloc`.
+
+---
+
 ### `./install.sh: Permission denied`
 
 **Cause**: Script not executable.

package/docs/user/quick-start.md

@@ -48,6 +48,12 @@ vp-tools help
 # Hiển thị targets + ViePilot CLI Tools
 ```
 
+Optional (maintainers):
+```bash
+npm run readme:sync
+# refresh README Total LOC metrics via cloc
+```
+
 ---
 
 ## Step 2: Create a New Project

package/install.sh

@@ -40,6 +40,50 @@ echo "  ViePilot: $VIEPILOT_DIR"
 echo "  Profile: $INSTALL_PROFILE"
 echo ""
 
+install_cloc_best_effort() {
+    if command -v cloc >/dev/null 2>&1; then
+        echo "  ✓ cloc detected"
+        return 0
+    fi
+
+    echo -e "${YELLOW}  cloc not found.${NC}"
+    echo "  README metric auto-sync can still run with fallback, but LOC refresh will be skipped."
+    echo "  Suggested install:"
+    echo "    - macOS: brew install cloc"
+    echo "    - Ubuntu/Debian: sudo apt-get install -y cloc"
+    echo "    - Windows: choco install cloc"
+
+    if [ "$AUTO_YES" = "1" ]; then
+        return 0
+    fi
+
+    read -p "  Attempt automatic cloc install now (best effort)? (y/n) " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        return 0
+    fi
+
+    if command -v brew >/dev/null 2>&1; then
+        brew install cloc || true
+    elif command -v apt-get >/dev/null 2>&1; then
+        sudo apt-get update && sudo apt-get install -y cloc || true
+    elif command -v dnf >/dev/null 2>&1; then
+        sudo dnf install -y cloc || true
+    elif command -v yum >/dev/null 2>&1; then
+        sudo yum install -y cloc || true
+    elif command -v pacman >/dev/null 2>&1; then
+        sudo pacman -Sy --noconfirm cloc || true
+    else
+        echo -e "${YELLOW}  Could not detect supported package manager. Install cloc manually.${NC}"
+    fi
+
+    if command -v cloc >/dev/null 2>&1; then
+        echo "  ✓ cloc installed"
+    else
+        echo -e "${YELLOW}  cloc is still unavailable; continuing without blocking installation.${NC}"
+    fi
+}
+
 # Confirm installation
 if [ "$AUTO_YES" != "1" ]; then
     read -p "Continue with installation? (y/n) " -n 1 -r
@@ -102,6 +146,9 @@ chmod +x "$VIEPILOT_DIR/bin/vp-tools.cjs"
 chmod +x "$VIEPILOT_DIR/bin/viepilot.cjs"
 echo "    ✓ vp-tools.cjs + viepilot.cjs + lib/cli-shared.cjs"
 
+echo "  Checking optional dependency for README metric sync..."
+install_cloc_best_effort
+
 # Create symlink in PATH (optional)
 echo ""
 if [ "$AUTO_YES" != "1" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viepilot",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "**Autonomous Vibe Coding Framework / Bộ khung phát triển tự động có kiểm soát**",
   "main": "index.js",
   "bin": {
@@ -14,6 +14,7 @@
     "test": "jest",
     "test:coverage": "jest --coverage",
     "test:watch": "jest --watch",
+    "readme:sync": "node scripts/sync-readme-metrics.cjs",
     "lint:cli": "node --check bin/vp-tools.cjs && node --check bin/viepilot.cjs",
     "verify:release": "npm run lint:cli && npm test && npm pack --dry-run",
     "prepublishOnly": "npm run verify:release",

package/skills/vp-auto/SKILL.md

@@ -63,6 +63,7 @@ If required task details are missing, do not implement until task contract is re
 
 **Updates on milestone complete:**
 - `README.md` — version badge, skills/workflows counts, Skills Reference table, Workflows table, Project Structure, Completion Status
+- `README.md` metrics — run `npm run readme:sync` when script exists; if `cloc` missing, continue with logged guidance (non-blocking)
 
 **After:** Project built, or paused for user intervention.
 </objective>

package/workflows/autonomous.md

@@ -323,6 +323,11 @@ fi
 Update README.md — **generic updates (all projects)**:
 1. Any version number mentions: update to `$ACTUAL_VERSION`
 2. Any "last updated" or "as of" date references
+3. If project contains `README` metrics table and `scripts/sync-readme-metrics.cjs`, run:
+   ```bash
+   npm run readme:sync || true
+   ```
+   - If `cloc` is unavailable, script must log guidance and continue (non-blocking).
 
 **viepilot framework only** (skip if `skills/` directory does not exist):
 ```bash