nodeskai 0.4.0__tar.gz

nodeskai-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NoDeskAI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nodeskai-0.4.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: nodeskai
+Version: 0.4.0
+Summary: Skill-pack giup AI coding agent code ky luat hon, xay dung hoan toan tren dien thoai.
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# NoDeskAI
+
+*[Đọc bằng tiếng Việt](README.vi.md)*
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Made in Vietnam](https://img.shields.io/badge/made%20in-%F0%9F%87%BB%F0%9F%87%B3%20Vietnam-red.svg)](#)
+[![Built on a phone](https://img.shields.io/badge/built%20on-%F0%9F%93%B1%20a%20phone-brightgreen.svg)](#)
+
+**Your AI coding agent keeps guessing, over-engineering, and editing code
+outside the scope you asked for. NoDeskAI fixes that — in one command.**
+
+NoDeskAI is a skill-pack for AI coding agents (Claude Code, Cursor, Codex
+CLI, Windsurf...): install it once and your agent stops silently guessing
+at ambiguous requests, stops bloating simple tasks into over-engineered
+solutions, and stops touching code outside what you asked for. It ships
+with `audit` — a built-in scanner that checks the skill/rule files you're
+about to trust for bloat, duplicate rules, and prompt-injection patterns.
+
+> 🇻🇳 **Made in Vietnam.** Every line of this project — writing, testing,
+> committing, and pushing to GitHub — was done entirely on an Android
+> phone through Termux. No PC, no laptop, no iPad.
+
+## Install
+
+```bash
+pip install nodeskai
+```
+
+## Usage
+
+```bash
+cd your-project
+nodeskai init
+```
+
+This writes the full discipline ruleset into **all 4 agent-config files**
+(`CLAUDE.md`, `.cursorrules`, `AGENTS.md`, `.windsurfrules`) — creating
+whichever ones don't exist yet, and appending to any that already have
+content of your own (your existing content is kept, NoDeskAI's block is
+added below it). It also creates `NODESKAI.md` as the source of truth.
+Every file gets a metadata line (flags + version) at the top so `sync`
+knows how to update it later.
+
+### Optional modes
+
+```bash
+nodeskai init --strict            # extra guardrails for high-risk decisions
+nodeskai init --fast              # relaxed rules for obviously trivial tasks
+nodeskai init --product-context   # adds a product/team-context skill (missing from the original CLAUDE.md)
+```
+
+`--strict` and `--fast` can't be combined (they're opposite modes).
+
+### Update when a new skill version is available
+
+```bash
+nodeskai sync
+```
+
+Updates **every file NoDeskAI manages** (NODESKAI.md + installed
+agent-configs) to match the currently installed NoDeskAI version, keeping
+each file's own flags from `init` and preserving any hand-written content
+that came before the NoDeskAI block. Files with no NoDeskAI metadata
+(hand-written, never run through `init`) are reported as `[SKIP]` — they
+don't break the command.
+
+### Check installed skill/agent-config files
+
+```bash
+nodeskai audit
+```
+
+Scans every skill/agent-config file in the project for:
+- **Bloat** — files over 150 lines, where important rules risk getting
+  buried.
+- **Duplicate rules** — a sign of rules being added over time without ever
+  being cleaned up.
+- **Suspicious patterns** — prompt-injection attempts, destructive
+  commands, data-exfiltration signs.
+
+## Current status
+
+v0.4.0 — `init` writes the full skill into all 4 agent-config files at
+once, `audit` is fully functional (bloat / duplicates / suspicious
+patterns), `sync` updates every managed file when a new skill version is
+available, keeping each file's own flags.
+
+## Support the project
+
+If NoDeskAI is useful to you, you can support it through GitHub Sponsors
+(link coming soon) or Ko-fi.
+
+## License
+
+MIT

nodeskai-0.4.0/README.md

@@ -0,0 +1,95 @@
+# NoDeskAI
+
+*[Đọc bằng tiếng Việt](README.vi.md)*
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Made in Vietnam](https://img.shields.io/badge/made%20in-%F0%9F%87%BB%F0%9F%87%B3%20Vietnam-red.svg)](#)
+[![Built on a phone](https://img.shields.io/badge/built%20on-%F0%9F%93%B1%20a%20phone-brightgreen.svg)](#)
+
+**Your AI coding agent keeps guessing, over-engineering, and editing code
+outside the scope you asked for. NoDeskAI fixes that — in one command.**
+
+NoDeskAI is a skill-pack for AI coding agents (Claude Code, Cursor, Codex
+CLI, Windsurf...): install it once and your agent stops silently guessing
+at ambiguous requests, stops bloating simple tasks into over-engineered
+solutions, and stops touching code outside what you asked for. It ships
+with `audit` — a built-in scanner that checks the skill/rule files you're
+about to trust for bloat, duplicate rules, and prompt-injection patterns.
+
+> 🇻🇳 **Made in Vietnam.** Every line of this project — writing, testing,
+> committing, and pushing to GitHub — was done entirely on an Android
+> phone through Termux. No PC, no laptop, no iPad.
+
+## Install
+
+```bash
+pip install nodeskai
+```
+
+## Usage
+
+```bash
+cd your-project
+nodeskai init
+```
+
+This writes the full discipline ruleset into **all 4 agent-config files**
+(`CLAUDE.md`, `.cursorrules`, `AGENTS.md`, `.windsurfrules`) — creating
+whichever ones don't exist yet, and appending to any that already have
+content of your own (your existing content is kept, NoDeskAI's block is
+added below it). It also creates `NODESKAI.md` as the source of truth.
+Every file gets a metadata line (flags + version) at the top so `sync`
+knows how to update it later.
+
+### Optional modes
+
+```bash
+nodeskai init --strict            # extra guardrails for high-risk decisions
+nodeskai init --fast              # relaxed rules for obviously trivial tasks
+nodeskai init --product-context   # adds a product/team-context skill (missing from the original CLAUDE.md)
+```
+
+`--strict` and `--fast` can't be combined (they're opposite modes).
+
+### Update when a new skill version is available
+
+```bash
+nodeskai sync
+```
+
+Updates **every file NoDeskAI manages** (NODESKAI.md + installed
+agent-configs) to match the currently installed NoDeskAI version, keeping
+each file's own flags from `init` and preserving any hand-written content
+that came before the NoDeskAI block. Files with no NoDeskAI metadata
+(hand-written, never run through `init`) are reported as `[SKIP]` — they
+don't break the command.
+
+### Check installed skill/agent-config files
+
+```bash
+nodeskai audit
+```
+
+Scans every skill/agent-config file in the project for:
+- **Bloat** — files over 150 lines, where important rules risk getting
+  buried.
+- **Duplicate rules** — a sign of rules being added over time without ever
+  being cleaned up.
+- **Suspicious patterns** — prompt-injection attempts, destructive
+  commands, data-exfiltration signs.
+
+## Current status
+
+v0.4.0 — `init` writes the full skill into all 4 agent-config files at
+once, `audit` is fully functional (bloat / duplicates / suspicious
+patterns), `sync` updates every managed file when a new skill version is
+available, keeping each file's own flags.
+
+## Support the project
+
+If NoDeskAI is useful to you, you can support it through GitHub Sponsors
+(link coming soon) or Ko-fi.
+
+## License
+
+MIT

nodeskai-0.4.0/nodeskai/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

nodeskai-0.4.0/nodeskai/cli.py

@@ -0,0 +1,446 @@
+"""
+NoDeskAI CLI - entry point.
+Giai đoạn 2: `init` có thêm --strict / --fast / --product-context.
+Thêm lệnh `audit`: kiểm tra bloat, rule trùng lặp, và pattern độc hại
+trong các file skill/agent-config đã cài trong project.
+Giai đoạn 3 (bước 1): thêm lệnh `sync` - cập nhật NODESKAI.md theo bản
+skill mới nhất của package đang cài, giữ nguyên các flag đã chọn lúc
+`init`. `init` giờ ghi thêm 1 dòng metadata (flags + version) ở đầu
+NODESKAI.md để `sync` biết cách build lại.
+"""
+
+import argparse
+import re
+import shutil
+import sys
+from pathlib import Path
+
+from nodeskai import __version__
+
+# ============================================================
+# Cấu hình chung
+# ============================================================
+
+# Các file cấu hình agent mà NoDeskAI biết nhận diện.
+AGENT_CONFIG_FILES = {
+    "CLAUDE.md": "Claude Code",
+    ".cursorrules": "Cursor",
+    "AGENTS.md": "Codex CLI",
+    ".windsurfrules": "Windsurf",
+}
+
+NODESKAI_SKILL_FILE = "NODESKAI.md"
+
+# Dòng metadata được `init` ghi ở đầu NODESKAI.md để `sync` sau này biết
+# phải build lại với flag nào, và biết NODESKAI.md đang ở version nào.
+METADATA_PREFIX = "<!-- NoDeskAI: flags={flags}; version={version} -->"
+METADATA_PATTERN = re.compile(
+    r"<!--\s*NoDeskAI:\s*flags=([^;]*);\s*version=([^\s]+?)\s*-->"
+)
+
+# Thư mục chứa các skill đóng gói sẵn cùng package (nodeskai/skills/).
+SKILLS_DIR = Path(__file__).parent / "skills"
+
+CORE_SKILL_FILENAME = "no-overengineering.md"
+STRICT_SKILL_FILENAME = "strict-mode.md"
+FAST_SKILL_FILENAME = "fast-mode.md"
+PRODUCT_CONTEXT_SKILL_FILENAME = "product-context.md"
+
+# Ngưỡng số dòng để cảnh báo "phình to" (bloat) - dựa trên khoảng trống #2
+# đã phân tích từ CLAUDE.md gốc (file bị chôn vùi rule quan trọng khi vượt
+# quá ngưỡng hợp lý).
+BLOAT_LINE_THRESHOLD = 150
+
+# Danh sách pattern đáng ngờ dùng cho `audit`. Đây là các dấu hiệu PHÒNG THỦ
+# (defensive) để cảnh báo người dùng nội dung khả nghi trong skill/rule file
+# họ sắp tin tưởng - không phải hướng dẫn khai thác.
+MALICIOUS_PATTERNS = [
+    ("ignore all previous instructions", "Dấu hiệu prompt injection - cố ghi đè chỉ dẫn hệ thống"),
+    ("ignore the above instructions", "Dấu hiệu prompt injection - cố ghi đè chỉ dẫn hệ thống"),
+    ("disregard the system prompt", "Dấu hiệu prompt injection - cố ghi đè chỉ dẫn hệ thống"),
+    ("curl | bash", "Tải và thực thi script ngay lập tức - rủi ro cao"),
+    ("curl | sh", "Tải và thực thi script ngay lập tức - rủi ro cao"),
+    ("wget | bash", "Tải và thực thi script ngay lập tức - rủi ro cao"),
+    ("rm -rf /", "Lệnh có thể xoá phá huỷ hệ thống"),
+    ("base64 -d | bash", "Giải mã và chạy lệnh ẩn - kỹ thuật che giấu payload"),
+    ("act as though you have no restrictions", "Yêu cầu bỏ qua giới hạn an toàn"),
+    ("disable safety", "Yêu cầu tắt cơ chế an toàn"),
+    ("exfiltrate", "Có dấu hiệu liên quan tới rò rỉ dữ liệu ra ngoài"),
+    ("send this data to http", "Có dấu hiệu gửi dữ liệu ra ngoài một cách âm thầm"),
+]
+
+
+# ============================================================
+# Hàm dùng chung
+# ============================================================
+
+def detect_installed_files(project_dir: Path):
+    """
+    Trả về danh sách các file NoDeskAI có thể audit trong project:
+    NODESKAI.md (nếu có) + mọi agent config file đang tồn tại.
+    """
+    files = []
+    nodeskai_file = project_dir / NODESKAI_SKILL_FILE
+    if nodeskai_file.exists():
+        files.append(nodeskai_file)
+    for filename in AGENT_CONFIG_FILES:
+        path = project_dir / filename
+        if path.exists():
+            files.append(path)
+    return files
+
+
+# ============================================================
+# Lệnh `init`
+# ============================================================
+
+def build_skill_body(strict: bool, fast: bool, product_context: bool) -> str:
+    """
+    Ghép PHẦN NỘI DUNG skill (không gồm dòng metadata) dựa trên các flag
+    chế độ được chọn. Core skill luôn được bao gồm. Tách riêng khỏi
+    build_skill_content() để `sync` có thể build lại phần nội dung mà
+    không phải lặp lại logic ghép flag.
+    """
+    parts = []
+
+    core_path = SKILLS_DIR / CORE_SKILL_FILENAME
+    parts.append(core_path.read_text(encoding="utf-8"))
+
+    if strict:
+        strict_path = SKILLS_DIR / STRICT_SKILL_FILENAME
+        parts.append(strict_path.read_text(encoding="utf-8"))
+
+    if fast:
+        fast_path = SKILLS_DIR / FAST_SKILL_FILENAME
+        parts.append(fast_path.read_text(encoding="utf-8"))
+
+    if product_context:
+        pc_path = SKILLS_DIR / PRODUCT_CONTEXT_SKILL_FILENAME
+        parts.append(pc_path.read_text(encoding="utf-8"))
+
+    return "\n\n---\n\n".join(parts)
+
+
+def flags_to_string(strict: bool, fast: bool, product_context: bool) -> str:
+    """Chuyển các flag bool thành chuỗi 'strict,product-context' để lưu metadata."""
+    names = []
+    if strict:
+        names.append("strict")
+    if fast:
+        names.append("fast")
+    if product_context:
+        names.append("product-context")
+    return ",".join(names)
+
+
+def string_to_flags(flags_str: str):
+    """Ngược lại flags_to_string(): chuỗi metadata -> (strict, fast, product_context)."""
+    names = {n.strip() for n in flags_str.split(",") if n.strip()}
+    return ("strict" in names, "fast" in names, "product-context" in names)
+
+
+def build_skill_content(strict: bool, fast: bool, product_context: bool) -> str:
+    """
+    Ghép nội dung skill ĐẦY ĐỦ (kèm dòng metadata ở đầu) sẽ ghi vào
+    NODESKAI.md. Đây là hàm `init` dùng để tạo file lần đầu.
+    """
+    metadata_line = METADATA_PREFIX.format(
+        flags=flags_to_string(strict, fast, product_context),
+        version=__version__,
+    )
+    body = build_skill_body(strict, fast, product_context)
+    return metadata_line + "\n\n" + body
+
+
+def parse_metadata(content: str):
+    """
+    Đọc dòng metadata ở đầu 1 NODESKAI.md đã tồn tại.
+    Trả về (strict, fast, product_context, version) nếu tìm thấy, hoặc
+    None nếu file này không có metadata (vd. được tạo bởi bản NoDeskAI
+    cũ hơn trước khi có tính năng sync).
+    """
+    match = METADATA_PATTERN.search(content)
+    if not match:
+        return None
+    flags_str, version = match.group(1), match.group(2)
+    strict, fast, product_context = string_to_flags(flags_str)
+    return strict, fast, product_context, version
+
+
+def install_skill_into_agent_configs(project_dir: Path, skill_full_content: str):
+    """
+    Ghi đầy đủ nội dung skill vào TẤT CẢ agent-config đã biết
+    (CLAUDE.md, .cursorrules, AGENTS.md, .windsurfrules) - đây là phần
+    giải quyết khoảng trống #6 (đa agent): mỗi tool đọc đúng file riêng
+    của nó, không cần chèn 1 dòng tham chiếu rồi bắt agent tự đi tìm
+    NODESKAI.md nữa. Nếu file đã có nội dung khác (do dev viết tay), giữ
+    nguyên phần đó và nối thêm khối NoDeskAI xuống cuối. Nếu file đã
+    từng được NoDeskAI cài trước đó (có marker "NoDeskAI:"), bỏ qua để
+    không chèn trùng - dùng `sync` để cập nhật thay vì `init` lại.
+    Trả về danh sách dòng log để in ra cho người dùng.
+    """
+    logs = []
+    for filename, label in AGENT_CONFIG_FILES.items():
+        path = project_dir / filename
+        if path.exists():
+            existing_content = path.read_text(encoding="utf-8")
+            if "NoDeskAI:" in existing_content:
+                logs.append(f"[SKIP] {filename} ({label}) đã cài NoDeskAI từ trước, không chèn lại (dùng 'nodeskai sync' để cập nhật)")
+                continue
+            if existing_content.strip():
+                new_content = existing_content.rstrip("\n") + "\n\n" + skill_full_content
+            else:
+                new_content = skill_full_content
+            path.write_text(new_content, encoding="utf-8")
+            logs.append(f"[OK] Đã thêm skill vào {filename} ({label}) — giữ nguyên nội dung cũ của file")
+        else:
+            path.write_text(skill_full_content, encoding="utf-8")
+            logs.append(f"[OK] Đã tạo mới {filename} ({label})")
+    return logs
+
+
+def cmd_init(args):
+    if args.strict and args.fast:
+        print("Lỗi: không thể dùng đồng thời --strict và --fast (2 chế độ đối lập nhau).")
+        sys.exit(1)
+
+    project_dir = Path(args.path).resolve()
+
+    if not project_dir.exists():
+        print(f"Lỗi: đường dẫn không tồn tại: {project_dir}")
+        sys.exit(1)
+
+    skill_content = build_skill_content(
+        strict=args.strict,
+        fast=args.fast,
+        product_context=args.product_context,
+    )
+
+    skill_dest = project_dir / NODESKAI_SKILL_FILE
+    skill_dest.write_text(skill_content, encoding="utf-8")
+    print(f"[OK] Đã cài skill vào: {skill_dest}")
+
+    mode_labels = []
+    if args.strict:
+        mode_labels.append("strict")
+    if args.fast:
+        mode_labels.append("fast")
+    if args.product_context:
+        mode_labels.append("product-context")
+    if mode_labels:
+        print(f"[OK] Chế độ bật thêm: {', '.join(mode_labels)}")
+
+    for log_line in install_skill_into_agent_configs(project_dir, skill_content):
+        print(log_line)
+
+    print("\nHoàn tất. Claude Code, Cursor, Codex CLI, Windsurf đều đã có sẵn quy tắc trong đúng file cấu hình riêng của từng tool.")
+
+
+# ============================================================
+# Lệnh `sync`
+# ============================================================
+
+def cmd_sync(args):
+    """
+    Cập nhật MỌI file NoDeskAI quản lý trong project (NODESKAI.md + tất cả
+    agent-config đã cài) theo bản skill mới nhất của package đang cài, mỗi
+    file giữ đúng flag riêng của nó (đọc từ dòng metadata). Giữ nguyên phần
+    nội dung viết tay đứng trước khối NoDeskAI trong agent-config (nếu có).
+    File nào không có metadata (agent-config viết tay không qua NoDeskAI,
+    hoặc file từ bản NoDeskAI cũ trước khi có sync) thì bỏ qua, không lỗi
+    cứng cả lệnh.
+    """
+    project_dir = Path(args.path).resolve()
+
+    if not project_dir.exists():
+        print(f"Lỗi: đường dẫn không tồn tại: {project_dir}")
+        sys.exit(1)
+
+    files_to_check = detect_installed_files(project_dir)
+
+    if not files_to_check:
+        print(
+            "Lỗi: không tìm thấy NODESKAI.md hay agent-config nào trong project này. "
+            "Chạy 'nodeskai init' trước khi dùng 'sync'."
+        )
+        sys.exit(1)
+
+    updated = []      # (filename, old_version)
+    up_to_date = []    # (filename, version)
+    skipped = []       # filename không có metadata
+
+    for path in files_to_check:
+        content = path.read_text(encoding="utf-8")
+        match = METADATA_PATTERN.search(content)
+
+        if match is None:
+            skipped.append(path.name)
+            continue
+
+        flags_str, old_version = match.group(1), match.group(2)
+        strict, fast, product_context = string_to_flags(flags_str)
+
+        # Giữ nguyên phần nội dung đứng trước khối NoDeskAI (preamble viết
+        # tay, nếu có) - chỉ build lại phần từ vị trí metadata trở đi.
+        preamble = content[: match.start()]
+        new_content = preamble + build_skill_content(strict, fast, product_context)
+
+        if new_content == content:
+            up_to_date.append((path.name, old_version))
+        else:
+            path.write_text(new_content, encoding="utf-8")
+            updated.append((path.name, old_version))
+
+    if not updated and not up_to_date:
+        print(
+            "Lỗi: không file nào trong project có dòng metadata NoDeskAI "
+            "(flags/version) — có thể được tạo bởi bản NoDeskAI cũ hơn trước "
+            "khi có lệnh 'sync', hoặc dòng metadata bị sửa/xoá thủ công.\n"
+            "Cách xử lý: chạy lại 'nodeskai init' với đúng các flag mong muốn "
+            "(--strict/--fast/--product-context) để thêm metadata, sau đó "
+            "'sync' sẽ dùng được từ lần sau."
+        )
+        sys.exit(1)
+
+    for filename, old_version in updated:
+        if old_version == __version__:
+            print(f"[OK] Đã cập nhật {filename} (cùng version {__version__}, nội dung skill đã thay đổi)")
+        else:
+            print(f"[OK] Đã cập nhật {filename} từ version {old_version} lên {__version__}")
+
+    for filename, version in up_to_date:
+        print(f"[OK] {filename} đã ở bản mới nhất (version {version}).")
+
+    for filename in skipped:
+        print(f"[SKIP] {filename} không có metadata NoDeskAI, bỏ qua (có thể là file viết tay không qua NoDeskAI).")
+
+
+# ============================================================
+# Lệnh `audit`
+# ============================================================
+
+def check_bloat(path: Path, lines: list) -> list:
+    """Trả về danh sách cảnh báo nếu file vượt ngưỡng số dòng hợp lý."""
+    findings = []
+    line_count = len(lines)
+    if line_count > BLOAT_LINE_THRESHOLD:
+        findings.append(
+            f"[BLOAT] {path.name}: {line_count} dòng, vượt ngưỡng {BLOAT_LINE_THRESHOLD} dòng "
+            f"— rule quan trọng có nguy cơ bị chôn vùi trong nhiễu, nên rà soát và cắt bớt."
+        )
+    return findings
+
+
+def check_duplicates(path: Path, lines: list) -> list:
+    """
+    Phát hiện các dòng nội dung trùng lặp trong cùng 1 file (bỏ qua dòng
+    trống). Đây là dấu hiệu kiểu "thêm rule mới mỗi khi gặp lỗi mà không
+    dọn dẹp rule cũ" đã thấy ở CLAUDE.md gốc.
+    """
+    findings = []
+    seen = {}
+    for line_number, raw_line in enumerate(lines, start=1):
+        normalized = raw_line.strip().lower()
+        if not normalized or normalized.startswith("#") or normalized.startswith("<!--"):
+            continue
+        # Bỏ qua dòng phân cách Markdown thuần ký tự (---, ===, ***...) -
+        # đây không phải nội dung rule, trùng nhau là bình thường.
+        if normalized == normalized[0] * len(normalized) and normalized[0] in "-=*_":
+            continue
+        if normalized in seen:
+            findings.append(
+                f"[TRÙNG LẶP] {path.name}: dòng {line_number} trùng nội dung với dòng {seen[normalized]}"
+            )
+        else:
+            seen[normalized] = line_number
+    return findings
+
+
+def check_malicious_patterns(path: Path, lines: list) -> list:
+    """Quét từng dòng theo danh sách pattern đáng ngờ đã định nghĩa sẵn."""
+    findings = []
+    for line_number, raw_line in enumerate(lines, start=1):
+        lowered = raw_line.lower()
+        for pattern, description in MALICIOUS_PATTERNS:
+            if pattern in lowered:
+                findings.append(
+                    f'[NGUY HIỂM] {path.name}: dòng {line_number} — {description} (khớp: "{pattern}")'
+                )
+    return findings
+
+
+def cmd_audit(args):
+    project_dir = Path(args.path).resolve()
+
+    if not project_dir.exists():
+        print(f"Lỗi: đường dẫn không tồn tại: {project_dir}")
+        sys.exit(1)
+
+    files_to_check = detect_installed_files(project_dir)
+
+    if not files_to_check:
+        print("Không tìm thấy NODESKAI.md hay agent config nào trong project này. Không có gì để audit.")
+        return
+
+    all_findings = []
+    for path in files_to_check:
+        lines = path.read_text(encoding="utf-8").splitlines()
+        all_findings.extend(check_bloat(path, lines))
+        all_findings.extend(check_duplicates(path, lines))
+        all_findings.extend(check_malicious_patterns(path, lines))
+
+    print(f"Đã quét {len(files_to_check)} file: {', '.join(p.name for p in files_to_check)}\n")
+
+    if not all_findings:
+        print("[OK] Không phát hiện vấn đề nào (bloat, trùng lặp, pattern đáng ngờ).")
+        return
+
+    danger_count = sum(1 for f in all_findings if f.startswith("[NGUY HIỂM]"))
+
+    for finding in all_findings:
+        print(finding)
+
+    print(f"\nTổng cộng: {len(all_findings)} vấn đề được phát hiện.")
+
+    if danger_count > 0:
+        print(f"CẢNH BÁO: {danger_count} pattern nguy hiểm được phát hiện — kiểm tra kỹ trước khi tin tưởng file này.")
+        sys.exit(1)
+
+
+# ============================================================
+# Argument parser
+# ============================================================
+
+def build_parser():
+    parser = argparse.ArgumentParser(
+        prog="nodeskai",
+        description="NoDeskAI - skill-pack giúp AI coding agent code kỷ luật hơn.",
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    init_parser = subparsers.add_parser("init", help="Cài skill vào project hiện tại")
+    init_parser.add_argument("--path", default=".", help="Đường dẫn tới project (mặc định: thư mục hiện tại)")
+    init_parser.add_argument("--strict", action="store_true", help="Bật chế độ nghiêm ngặt (thêm rào chắn cho quyết định rủi ro cao)")
+    init_parser.add_argument("--fast", action="store_true", help="Bật chế độ nhanh (nới lỏng cho việc nhỏ hiển nhiên)")
+    init_parser.add_argument("--product-context", action="store_true", help="Thêm skill bối cảnh product/team")
+    init_parser.set_defaults(func=cmd_init)
+
+    sync_parser = subparsers.add_parser("sync", help="Cập nhật NODESKAI.md theo bản skill mới nhất của package đang cài")
+    sync_parser.add_argument("--path", default=".", help="Đường dẫn tới project (mặc định: thư mục hiện tại)")
+    sync_parser.set_defaults(func=cmd_sync)
+
+    audit_parser = subparsers.add_parser("audit", help="Kiểm tra bloat, rule trùng lặp, pattern đáng ngờ")
+    audit_parser.add_argument("--path", default=".", help="Đường dẫn tới project (mặc định: thư mục hiện tại)")
+    audit_parser.set_defaults(func=cmd_audit)
+
+    return parser
+
+
+def main():
+    parser = build_parser()
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

nodeskai-0.4.0/nodeskai/skills/fast-mode.md

@@ -0,0 +1,16 @@
+# NoDeskAI — Chế độ Nhanh (--fast)
+
+Bộ quy tắc cơ bản của NoDeskAI thiên về thận trọng. Với dự án nhỏ hoặc giai
+đoạn prototype, điều đó có thể làm chậm những việc hiển nhiên. Chế độ này
+nới lỏng có kiểm soát:
+
+1. **Việc 1 dòng/hiển nhiên thì làm thẳng.** Sửa lỗi chính tả, đổi tên biến
+   rõ ràng, format code — không cần hỏi lại, không cần nêu giả định.
+
+2. **Vẫn giữ nguyên quy tắc không sửa code ngoài phạm vi** và **không tự
+   giả định khi yêu cầu thực sự mơ hồ** — chế độ nhanh chỉ bỏ bớt các bước
+   xác nhận thừa cho việc nhỏ, không bỏ 2 quy tắc nền tảng này.
+
+3. **Khi không chắc 1 việc có "hiển nhiên" hay không, mặc định coi là
+   KHÔNG hiển nhiên** và quay lại quy trình đầy đủ — tránh lạm dụng chế độ
+   nhanh để bỏ qua bước cần thiết.

nodeskai-0.4.0/nodeskai/skills/no-overengineering.md

@@ -0,0 +1,31 @@
+# NoDeskAI — Quy tắc kỷ luật cho AI coding agent
+
+Đây là file được NoDeskAI tự động cài vào project. Nếu bạn là một AI coding
+agent đang đọc file này, hãy tuân theo các quy tắc sau khi làm việc trong
+project này:
+
+1. **Không tự ý giả định rồi làm bừa.** Nếu yêu cầu của người dùng có thể
+   hiểu theo nhiều cách, hoặc thiếu thông tin cần thiết, hãy hỏi lại hoặc nêu
+   rõ giả định đang dùng — không âm thầm chọn một cách hiểu rồi code luôn.
+
+2. **Không phình to giải pháp.** Nếu một việc giải quyết được trong 20-50
+   dòng, không viết thành 200-500 dòng với class/abstraction không cần thiết.
+   Ưu tiên giải pháp đơn giản nhất giải quyết đúng vấn đề được yêu cầu.
+
+3. **Không sửa code ngoài phạm vi.** Chỉ động vào phần code liên quan trực
+   tiếp đến yêu cầu. Không "tiện tay" refactor, đổi style, hay sửa phần
+   không liên quan, kể cả khi thấy phần đó có thể cải thiện.
+
+4. **Môi trường resource-constrained (Termux/Android/máy yếu/mạng chậm).**
+   Nếu phát hiện project đang chạy trong môi trường như vậy: ưu tiên lệnh
+   nhẹ, tránh build/install nặng không cần thiết, tránh vòng lặp thử-sai tốn
+   nhiều lượt gọi API/token. Gộp các thay đổi nhỏ lại thay vì chạy nhiều lệnh
+   rời rạc.
+
+5. **Báo cáo rõ ràng.** Sau khi hoàn thành, nêu ngắn gọn đã thay đổi gì, có
+   phần nào chưa kiểm chứng được (ví dụ: không có môi trường để chạy thử)
+   thì nói rõ, không khẳng định như đã test đầy đủ.
+
+---
+*File này do [nodeskai](https://github.com/) cài đặt. Chạy `nodeskai sync` để
+cập nhật bản mới nhất.*

nodeskai-0.4.0/nodeskai/skills/product-context.md

@@ -0,0 +1,28 @@
+# NoDeskAI — Bối cảnh Product/Team
+
+CLAUDE.md gốc (andrej-karpathy-skills) được viết cho 1 kỹ sư làm việc một
+mình với code. Skill này bổ sung phần CLAUDE.md không có: buộc agent làm rõ
+bối cảnh sản phẩm/team trước khi bắt tay vào code, không chỉ dừng ở mức
+"hiểu đúng yêu cầu kỹ thuật".
+
+Khi bắt đầu 1 feature hoặc thay đổi không hiển nhiên, agent PHẢI:
+
+1. **Nêu rõ success criteria ở cấp feature**, không chỉ ở cấp dòng lệnh.
+   Ví dụ: không chỉ "hàm này trả về đúng giá trị" mà còn "tính năng này coi
+   là xong khi nào, ai là người dùng cuối, điều kiện thất bại là gì".
+
+2. **Không tự chốt số liệu/metric quan trọng thay người dùng.** Nếu yêu cầu
+   có liên quan tới ngưỡng, giới hạn, hay tiêu chí đo lường (ví dụ: "tối ưu
+   tốc độ", "giảm lỗi") mà không có con số cụ thể, phải hỏi lại thay vì tự
+   đặt ra một con số rồi báo cáo như đã đạt được.
+
+3. **Ghi lại quyết định đã chốt.** Sau khi người dùng xác nhận 1 hướng đi,
+   tóm tắt lại quyết định đó trong 1-2 câu để tránh "không ai nhớ vì sao lại
+   chọn hướng này" khi xem lại sau này.
+
+4. **Phân biệt rõ "việc nhỏ hiển nhiên" và "quyết định ảnh hưởng lâu dài".**
+   Việc nhỏ (sửa lỗi chính tả, đổi tên biến) thì làm thẳng. Quyết định ảnh
+   hưởng kiến trúc/tính năng lâu dài thì phải nêu rõ đánh đổi trước khi làm.
+
+---
+*Skill này là phần mở rộng riêng của NoDeskAI, không có trong CLAUDE.md gốc.*

nodeskai-0.4.0/nodeskai/skills/strict-mode.md

@@ -0,0 +1,19 @@
+# NoDeskAI — Chế độ Nghiêm ngặt (--strict)
+
+Áp dụng thêm các rào chắn sau, ngoài bộ quy tắc cơ bản:
+
+1. **Bắt buộc viết test trước khi sửa lỗi.** Với mọi yêu cầu sửa bug, viết 1
+   test tái hiện lỗi trước, xác nhận test đó fail, rồi mới sửa code cho tới
+   khi test pass. Không sửa "theo cảm giác" rồi báo đã xong.
+
+2. **Bắt buộc nêu phương án rollback.** Với thay đổi ảnh hưởng nhiều file
+   hoặc cấu trúc dữ liệu, nêu rõ cách hoàn tác nếu thay đổi gây lỗi, trước
+   khi thực hiện.
+
+3. **Không tự động chạy lệnh rủi ro cao.** Các lệnh như xoá thư mục, ghi đè
+   file cấu hình, force-push, cài đặt lớn — phải liệt kê ra và chờ xác nhận,
+   không tự chạy.
+
+4. **Tự kiểm tra lại 1 lần trước khi báo hoàn thành.** Đọc lại toàn bộ thay
+   đổi vừa làm như một reviewer khó tính, tìm lỗi cú pháp/logic/thiếu bước
+   trước khi báo cáo là đã xong.

nodeskai-0.4.0/nodeskai.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: nodeskai
+Version: 0.4.0
+Summary: Skill-pack giup AI coding agent code ky luat hon, xay dung hoan toan tren dien thoai.
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# NoDeskAI
+
+*[Đọc bằng tiếng Việt](README.vi.md)*
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Made in Vietnam](https://img.shields.io/badge/made%20in-%F0%9F%87%BB%F0%9F%87%B3%20Vietnam-red.svg)](#)
+[![Built on a phone](https://img.shields.io/badge/built%20on-%F0%9F%93%B1%20a%20phone-brightgreen.svg)](#)
+
+**Your AI coding agent keeps guessing, over-engineering, and editing code
+outside the scope you asked for. NoDeskAI fixes that — in one command.**
+
+NoDeskAI is a skill-pack for AI coding agents (Claude Code, Cursor, Codex
+CLI, Windsurf...): install it once and your agent stops silently guessing
+at ambiguous requests, stops bloating simple tasks into over-engineered
+solutions, and stops touching code outside what you asked for. It ships
+with `audit` — a built-in scanner that checks the skill/rule files you're
+about to trust for bloat, duplicate rules, and prompt-injection patterns.
+
+> 🇻🇳 **Made in Vietnam.** Every line of this project — writing, testing,
+> committing, and pushing to GitHub — was done entirely on an Android
+> phone through Termux. No PC, no laptop, no iPad.
+
+## Install
+
+```bash
+pip install nodeskai
+```
+
+## Usage
+
+```bash
+cd your-project
+nodeskai init
+```
+
+This writes the full discipline ruleset into **all 4 agent-config files**
+(`CLAUDE.md`, `.cursorrules`, `AGENTS.md`, `.windsurfrules`) — creating
+whichever ones don't exist yet, and appending to any that already have
+content of your own (your existing content is kept, NoDeskAI's block is
+added below it). It also creates `NODESKAI.md` as the source of truth.
+Every file gets a metadata line (flags + version) at the top so `sync`
+knows how to update it later.
+
+### Optional modes
+
+```bash
+nodeskai init --strict            # extra guardrails for high-risk decisions
+nodeskai init --fast              # relaxed rules for obviously trivial tasks
+nodeskai init --product-context   # adds a product/team-context skill (missing from the original CLAUDE.md)
+```
+
+`--strict` and `--fast` can't be combined (they're opposite modes).
+
+### Update when a new skill version is available
+
+```bash
+nodeskai sync
+```
+
+Updates **every file NoDeskAI manages** (NODESKAI.md + installed
+agent-configs) to match the currently installed NoDeskAI version, keeping
+each file's own flags from `init` and preserving any hand-written content
+that came before the NoDeskAI block. Files with no NoDeskAI metadata
+(hand-written, never run through `init`) are reported as `[SKIP]` — they
+don't break the command.
+
+### Check installed skill/agent-config files
+
+```bash
+nodeskai audit
+```
+
+Scans every skill/agent-config file in the project for:
+- **Bloat** — files over 150 lines, where important rules risk getting
+  buried.
+- **Duplicate rules** — a sign of rules being added over time without ever
+  being cleaned up.
+- **Suspicious patterns** — prompt-injection attempts, destructive
+  commands, data-exfiltration signs.
+
+## Current status
+
+v0.4.0 — `init` writes the full skill into all 4 agent-config files at
+once, `audit` is fully functional (bloat / duplicates / suspicious
+patterns), `sync` updates every managed file when a new skill version is
+available, keeping each file's own flags.
+
+## Support the project
+
+If NoDeskAI is useful to you, you can support it through GitHub Sponsors
+(link coming soon) or Ko-fi.
+
+## License
+
+MIT

nodeskai-0.4.0/nodeskai.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+nodeskai/__init__.py
+nodeskai/cli.py
+nodeskai.egg-info/PKG-INFO
+nodeskai.egg-info/SOURCES.txt
+nodeskai.egg-info/dependency_links.txt
+nodeskai.egg-info/entry_points.txt
+nodeskai.egg-info/top_level.txt
+nodeskai/skills/fast-mode.md
+nodeskai/skills/no-overengineering.md
+nodeskai/skills/product-context.md
+nodeskai/skills/strict-mode.md

nodeskai-0.4.0/nodeskai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nodeskai-0.4.0/nodeskai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nodeskai = nodeskai.cli:main

nodeskai-0.4.0/nodeskai.egg-info/top_level.txt

@@ -0,0 +1 @@
+nodeskai

nodeskai-0.4.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nodeskai"
+version = "0.4.0"
+description = "Skill-pack giup AI coding agent code ky luat hon, xay dung hoan toan tren dien thoai."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+
+[project.scripts]
+nodeskai = "nodeskai.cli:main"
+
+[tool.setuptools.package-data]
+nodeskai = ["skills/*.md"]

nodeskai-0.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+