@leejungkiin/awkit 1.3.8 → 1.4.2

package/skills/gitnexus/gitnexus-impact-analysis/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: gitnexus-impact-analysis
+description: "Use when the user wants to know what will break if they change something, or needs safety analysis before editing code. Examples: \"Is it safe to change X?\", \"What depends on this?\", \"What will break?\""
+---
+
+# Impact Analysis with GitNexus
+
+## When to Use
+
+- "Is it safe to change this function?"
+- "What will break if I modify X?"
+- "Show me the blast radius"
+- "Who uses this code?"
+- Before making non-trivial code changes
+- Before committing — to understand what your changes affect
+
+## Workflow
+
+```
+1. gitnexus_impact({target: "X", direction: "upstream"})  → What depends on this
+2. READ gitnexus://repo/{name}/processes                   → Check affected execution flows
+3. gitnexus_detect_changes()                               → Map current git changes to affected flows
+4. Assess risk and report to user
+```
+
+> If "Index is stale" → run `npx gitnexus analyze` in terminal.
+
+## Checklist
+
+```
+- [ ] gitnexus_impact({target, direction: "upstream"}) to find dependents
+- [ ] Review d=1 items first (these WILL BREAK)
+- [ ] Check high-confidence (>0.8) dependencies
+- [ ] READ processes to check affected execution flows
+- [ ] gitnexus_detect_changes() for pre-commit check
+- [ ] Assess risk level and report to user
+```
+
+## Understanding Output
+
+| Depth | Risk Level       | Meaning                  |
+| ----- | ---------------- | ------------------------ |
+| d=1   | **WILL BREAK**   | Direct callers/importers |
+| d=2   | LIKELY AFFECTED  | Indirect dependencies    |
+| d=3   | MAY NEED TESTING | Transitive effects       |
+
+## Risk Assessment
+
+| Affected                       | Risk     |
+| ------------------------------ | -------- |
+| <5 symbols, few processes      | LOW      |
+| 5-15 symbols, 2-5 processes    | MEDIUM   |
+| >15 symbols or many processes  | HIGH     |
+| Critical path (auth, payments) | CRITICAL |
+
+## Tools
+
+**gitnexus_impact** — the primary tool for symbol blast radius:
+
+```
+gitnexus_impact({
+  target: "validateUser",
+  direction: "upstream",
+  minConfidence: 0.8,
+  maxDepth: 3
+})
+
+→ d=1 (WILL BREAK):
+  - loginHandler (src/auth/login.ts:42) [CALLS, 100%]
+  - apiMiddleware (src/api/middleware.ts:15) [CALLS, 100%]
+
+→ d=2 (LIKELY AFFECTED):
+  - authRouter (src/routes/auth.ts:22) [CALLS, 95%]
+```
+
+**gitnexus_detect_changes** — git-diff based impact analysis:
+
+```
+gitnexus_detect_changes({scope: "staged"})
+
+→ Changed: 5 symbols in 3 files
+→ Affected: LoginFlow, TokenRefresh, APIMiddlewarePipeline
+→ Risk: MEDIUM
+```
+
+## Example: "What breaks if I change validateUser?"
+
+```
+1. gitnexus_impact({target: "validateUser", direction: "upstream"})
+   → d=1: loginHandler, apiMiddleware (WILL BREAK)
+   → d=2: authRouter, sessionManager (LIKELY AFFECTED)
+
+2. READ gitnexus://repo/my-app/processes
+   → LoginFlow and TokenRefresh touch validateUser
+
+3. Risk: 2 direct callers, 2 processes = MEDIUM
+```

package/skills/gitnexus/gitnexus-refactoring/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: gitnexus-refactoring
+description: "Use when the user wants to rename, extract, split, move, or restructure code safely. Examples: \"Rename this function\", \"Extract this into a module\", \"Refactor this class\", \"Move this to a separate file\""
+---
+
+# Refactoring with GitNexus
+
+## When to Use
+
+- "Rename this function safely"
+- "Extract this into a module"
+- "Split this service"
+- "Move this to a new file"
+- Any task involving renaming, extracting, splitting, or restructuring code
+
+## Workflow
+
+```
+1. gitnexus_impact({target: "X", direction: "upstream"})  → Map all dependents
+2. gitnexus_query({query: "X"})                            → Find execution flows involving X
+3. gitnexus_context({name: "X"})                           → See all incoming/outgoing refs
+4. Plan update order: interfaces → implementations → callers → tests
+```
+
+> If "Index is stale" → run `npx gitnexus analyze` in terminal.
+
+## Checklists
+
+### Rename Symbol
+
+```
+- [ ] gitnexus_rename({symbol_name: "oldName", new_name: "newName", dry_run: true}) — preview all edits
+- [ ] Review graph edits (high confidence) and ast_search edits (review carefully)
+- [ ] If satisfied: gitnexus_rename({..., dry_run: false}) — apply edits
+- [ ] gitnexus_detect_changes() — verify only expected files changed
+- [ ] Run tests for affected processes
+```
+
+### Extract Module
+
+```
+- [ ] gitnexus_context({name: target}) — see all incoming/outgoing refs
+- [ ] gitnexus_impact({target, direction: "upstream"}) — find all external callers
+- [ ] Define new module interface
+- [ ] Extract code, update imports
+- [ ] gitnexus_detect_changes() — verify affected scope
+- [ ] Run tests for affected processes
+```
+
+### Split Function/Service
+
+```
+- [ ] gitnexus_context({name: target}) — understand all callees
+- [ ] Group callees by responsibility
+- [ ] gitnexus_impact({target, direction: "upstream"}) — map callers to update
+- [ ] Create new functions/services
+- [ ] Update callers
+- [ ] gitnexus_detect_changes() — verify affected scope
+- [ ] Run tests for affected processes
+```
+
+## Tools
+
+**gitnexus_rename** — automated multi-file rename:
+
+```
+gitnexus_rename({symbol_name: "validateUser", new_name: "authenticateUser", dry_run: true})
+→ 12 edits across 8 files
+→ 10 graph edits (high confidence), 2 ast_search edits (review)
+→ Changes: [{file_path, edits: [{line, old_text, new_text, confidence}]}]
+```
+
+**gitnexus_impact** — map all dependents first:
+
+```
+gitnexus_impact({target: "validateUser", direction: "upstream"})
+→ d=1: loginHandler, apiMiddleware, testUtils
+→ Affected Processes: LoginFlow, TokenRefresh
+```
+
+**gitnexus_detect_changes** — verify your changes after refactoring:
+
+```
+gitnexus_detect_changes({scope: "all"})
+→ Changed: 8 files, 12 symbols
+→ Affected processes: LoginFlow, TokenRefresh
+→ Risk: MEDIUM
+```
+
+**gitnexus_cypher** — custom reference queries:
+
+```cypher
+MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "validateUser"})
+RETURN caller.name, caller.filePath ORDER BY caller.filePath
+```
+
+## Risk Rules
+
+| Risk Factor         | Mitigation                                |
+| ------------------- | ----------------------------------------- |
+| Many callers (>5)   | Use gitnexus_rename for automated updates |
+| Cross-area refs     | Use detect_changes after to verify scope  |
+| String/dynamic refs | gitnexus_query to find them               |
+| External/public API | Version and deprecate properly            |
+
+## Example: Rename `validateUser` to `authenticateUser`
+
+```
+1. gitnexus_rename({symbol_name: "validateUser", new_name: "authenticateUser", dry_run: true})
+   → 12 edits: 10 graph (safe), 2 ast_search (review)
+   → Files: validator.ts, login.ts, middleware.ts, config.json...
+
+2. Review ast_search edits (config.json: dynamic reference!)
+
+3. gitnexus_rename({symbol_name: "validateUser", new_name: "authenticateUser", dry_run: false})
+   → Applied 12 edits across 8 files
+
+4. gitnexus_detect_changes({scope: "all"})
+   → Affected: LoginFlow, TokenRefresh
+   → Risk: MEDIUM — run tests for these flows
+```

package/skills/lucylab-tts/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: lucylab-tts
+description: |
+  Công cụ tạo Text-to-Speech (TTS) sử dụng API của LucyLab với nhiều giọng đọc khác nhau.
+  Hỗ trợ tạo giọng đọc từ kịch bản có sẵn, quản lý voice library và xuất file âm thanh chất lượng cao.
+metadata:
+  stage: workflow
+  version: "1.0"
+  requires: "python3, requests"
+  tags: [tts, lucylab, voice, audio, text-to-speech]
+trigger: explicit
+activation_keywords:
+  - "/lucylab"
+  - "/tts"
+  - "chuyển văn bản thành giọng nói"
+  - "tạo giọng đọc"
+  - "đọc script"
+  - "tạo tts"
+---
+
+# 🎙️ LucyLab TTS (Text-to-Speech Generator)
+
+> **Mục tiêu**: Tự động hóa quá trình tạo giọng đọc (Voiceover) từ văn bản hoặc kịch bản phân cảnh (Scenes) bằng API của LucyLab, hỗ trợ nhiều giọng đọc vùng miền và giới tính khác nhau. Được tách ra thành skill độc lập để dễ dàng gọi từ các workflow khác (ví dụ: short-maker).
+
+## 📡 Chế độ hoạt động (Triggers)
+
+- **Plain Text Mode**: Nhập một đoạn văn bản (text), Tool sẽ dùng một giọng mặc định để đọc toàn bộ.
+- **Script Scenes Mode**: Nhập kịch bản phân cảnh (SCENE 1, SCENE 2,...). Tool sẽ tự động phân tách từng câu thoại của mỗi cảnh và gọi LucyLab API để tạo các file lẻ. Rất phù hợp với quá trình tạo video tự động (Short Maker).
+
+## 🧱 Quy trình hoạt động (Mandatory Flow)
+
+0. **Giai đoạn Setup (Authentication)**: AI CẦN PHẢI KIỂM TRA QUYỀN TRUY CẬP TRƯỚC TIÊN:
+   - Quét file `.env` (tại thư mục làm việc hiện tại hoặc `~/.gemini/antigravity/.env`) tìm `LUCYLAB_BEARER`. Nếu KHÔNG TỒN TẠI, AI phải yêu cầu người dùng cung cấp API Key của LucyLab để lưu vào `.env`. Tuyệt đối không được chạy script trực tiếp để tránh lỗi do thiếu Authorization.
+1. **Chuẩn bị Kịch bản**: Kịch bản cần được đưa vào file text (ví dụ: `script.txt`) chứa thoại, hoặc truyền trực tiếp chữ thông qua `--text`.
+2. **Chọn Giọng đọc**: Dựa trên danh sách giọng trong `~/.gemini/antigravity/skills/lucylab-tts/resources/voices_library.json` hoặc truyền trực tiếp `--voice <id>`. Có các template phân nhóm: Nam/Nữ, miền Bắc/Nam.
+3. **Thực thi Tạo Audio**: 
+   - Tool kích hoạt script Python nằm trong: `~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py`.
+   - Tool tự động lấy `LUCYLAB_BEARER` từ `.env` (hỗ trợ .env cục bộ hoặc ~/.gemini/antigravity/.env).
+4. **Hậu kiểm Output**: 
+   - Files MP3/WAV sẽ được lưu vào thư mục định sẵn (mặc định `outputs/tts-lucylab/<voice-slug>/`) với các file như `scene-01.mp3`, `scene-02.mp3`...
+   - Sẵn sàng dùng kết hợp với FFmpeg để ráp vào video.
+
+## 💻 Cấu trúc lệnh (CLI Reference)
+
+Để gọi engine TTS, bạn có thể thực thi lệnh thông qua bash:
+
+```bash
+# Đọc một đoạn text đơn giản (không chia cảnh)
+python ~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py \
+    --text "Chào mừng bạn đến với hệ thống." \
+    --voice "12345:Giọng chuẩn" \
+    --mode plain \
+    --out-dir "outputs/sample"
+
+# Đọc từ kịch bản chia cảnh, chọn nhiều giọng từ thư viện
+python ~/.gemini/antigravity/skills/lucylab-tts/scripts/lucylab_tts.py \
+    --text-file "script.txt" \
+    --mode auto \
+    --voice-json "/Users/trungkientn/.gemini/antigravity/skills/lucylab-tts/resources/voices_library.json" \
+    --voices "Nam miền Bắc" \
+    --out-dir "outputs/tts"
+```
+
+> ⚠️ **Lưu ý**: Chắc chắn rằng biến môi trường `LUCYLAB_BEARER` đã được cấu hình trong dự án hiện tại (`.env`) hoặc `~/.gemini/antigravity/skills/lucylab-tts/scripts/.env` để được phép Authentication.