@mrtrinhvn/ag-kit 1.0.8 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/.agent/skills/mini-antigravity-injection/SKILL.md +12 -10
  2. package/package.json +1 -1
  3. package/template/.agent/skills/mini-antigravity-injection/SKILL.md +12 -10
package/.agent/skills/mini-antigravity-injection/SKILL.md CHANGED
@@ -32,16 +32,18 @@ Khi bạn (AI) tự động tạo code `SelfHealingService` cho dự án mới,
32
32
  ### 1. Cơ Chế Bơm Kiến Thức Vĩ Mô (Skill & DNA Injection)
33
33
  - Code tự động đọc các file nguyên tắc lập trình của dự án (`.agent/GEMINI.md`, `clean-code/SKILL.md`...) và TIÊM vào System Prompt của LLM Bác Sĩ Cục Bộ. Đảm bảo nó code đúng văn phong của Antigravity.
34
34
 
35
- ### 2. Định Luật Cạn Kiệt Gen (Exhaustion Trigger)
36
- - Hệ thống bắt Stack Trace. Nếu lỗi Tool/Code gãy 3 lần (Vòng lặp bất tận) -> Kích Hoạt Tiểu-Antigravity chữa cháy tự động.
37
-
38
- ### 3. Hộp Cát Tử Thần (Sandbox) & Lá Chắn Ngữ Nghĩa (Semantic Shield)
39
- Tuyệt đối KHÔNG đẩy code vừa sinh thẳng vào Môi trường Thực Chiến.
40
- - **Phase 1 (Doctor):** Dùng prompt áp dụng `5-Whys` tìm Root Cause và viết mới lại file Code.
41
- - **Phase 2 (Syntax Test):** Build/Compile Dry-run qua trình biên dịch (VD: `tsc --noEmit`).
42
- - **Phase 3 (Semantic Shield):** Cốt lõi của sự Khôn ngoan! Hệ thống tự rà file Unit Test đi kèm (`*.spec.ts` hoặc `*.test.ts`). Chạy **Test Ngữ Nghĩa (Logic)** với file mới. Nếu Logic tính toán sai (dù cú pháp đúng) -> Đánh sập nhánh đó, cấm Hot-Reload.
43
-
44
- ### 4. Giao Kèo Docstring Định Danh (Docstring Identity Pact)
35
+ ## 2. Lõi Đột Biến Cấp Khẩn Cơ Sở (Agentic Healing Sandbox)
36
+
37
+ Thay vì đoán mò Code trong 1 lần như trước đây (One-Shot), Lõi Bác Sĩ giờ đây được tiến hóa thành **Sub-Agentic Healing**:
38
+ 1. **Meta-Sandbox (Chroot):** Copy file bị lỗi ra `/tmp/ag-workspace-${doctorId}/` để cách ly hoàn toàn với source code.
39
+ 2. **Triệu hồi Sub-Agent:** Gọi ngược `AgentRuntime.execute()` cấp cho Bác sĩ các quyền (Bash, Read/Write file). Bác sĩ sẽ tự đi vòng quanh ổ cứng, tự dịch TypeScript (`npx tsc`) để test lỗi cho đến khi Pass 100%.
40
+ 3. **3 Khóa Đỏ Chế Ngự (Red Locks):**
41
+ - **Chống Đệ Quy (Depth Limit):** Bác sĩ không được cấp quyền gọi lệnh vá lỗi để đẻ ra Bác sĩ khác.
42
+ - **Kill-Switch:** Nếu Bác sĩ ảo giác (ngáo) gõ lặp lại 1 lệnh lỗi 2 lần, tự động Force Kill và Rollback.
43
+ - **Giới hạn lặp:** Bác sĩ chỉ có 10 vòng lặp (10 attempts) để cứu bệnh nhân.
44
+ 4. **Semantic Shield:** Sau khi Bác Sĩ báo cáo "Finish", luồng gốc mới chạy `Unit Test` trên file Sandbox đó. Vượt qua Unit Test mới được phép Hot-Reload đè vào Source Code chính!
45
+
46
+ ### 3. Giao Kèo Docstring Định Danh (Docstring Identity Pact)
45
47
  - Ép Prompt của Bác Sĩ: Khai báo đa dòng ở đầu file Code mới: Sửa dòng nào? Tại sao sửa? Tuân thủ triết lý gì?
46
48
 
47
49
  ### 5. Nạp Nóng (Hot-Reload) & Sổ Ghi Chép Chung (Evolution Ledger)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrtrinhvn/ag-kit",
3
- "version": "1.0.8",
3
+ "version": "1.0.9",
4
4
  "description": "Antigravity Kit Base Framework - Generic Agentic AI Programming Core",
5
5
  "main": "index.js",
6
6
  "bin": {
package/template/.agent/skills/mini-antigravity-injection/SKILL.md CHANGED
@@ -32,16 +32,18 @@ Khi bạn (AI) tự động tạo code `SelfHealingService` cho dự án mới,
32
32
  ### 1. Cơ Chế Bơm Kiến Thức Vĩ Mô (Skill & DNA Injection)
33
33
  - Code tự động đọc các file nguyên tắc lập trình của dự án (`.agent/GEMINI.md`, `clean-code/SKILL.md`...) và TIÊM vào System Prompt của LLM Bác Sĩ Cục Bộ. Đảm bảo nó code đúng văn phong của Antigravity.
34
34
 
35
- ### 2. Định Luật Cạn Kiệt Gen (Exhaustion Trigger)
36
- - Hệ thống bắt Stack Trace. Nếu lỗi Tool/Code gãy 3 lần (Vòng lặp bất tận) -> Kích Hoạt Tiểu-Antigravity chữa cháy tự động.
37
-
38
- ### 3. Hộp Cát Tử Thần (Sandbox) & Lá Chắn Ngữ Nghĩa (Semantic Shield)
39
- Tuyệt đối KHÔNG đẩy code vừa sinh thẳng vào Môi trường Thực Chiến.
40
- - **Phase 1 (Doctor):** Dùng prompt áp dụng `5-Whys` tìm Root Cause và viết mới lại file Code.
41
- - **Phase 2 (Syntax Test):** Build/Compile Dry-run qua trình biên dịch (VD: `tsc --noEmit`).
42
- - **Phase 3 (Semantic Shield):** Cốt lõi của sự Khôn ngoan! Hệ thống tự rà file Unit Test đi kèm (`*.spec.ts` hoặc `*.test.ts`). Chạy **Test Ngữ Nghĩa (Logic)** với file mới. Nếu Logic tính toán sai (dù cú pháp đúng) -> Đánh sập nhánh đó, cấm Hot-Reload.
43
-
44
- ### 4. Giao Kèo Docstring Định Danh (Docstring Identity Pact)
35
+ ## 2. Lõi Đột Biến Cấp Khẩn Cơ Sở (Agentic Healing Sandbox)
36
+
37
+ Thay vì đoán mò Code trong 1 lần như trước đây (One-Shot), Lõi Bác Sĩ giờ đây được tiến hóa thành **Sub-Agentic Healing**:
38
+ 1. **Meta-Sandbox (Chroot):** Copy file bị lỗi ra `/tmp/ag-workspace-${doctorId}/` để cách ly hoàn toàn với source code.
39
+ 2. **Triệu hồi Sub-Agent:** Gọi ngược `AgentRuntime.execute()` cấp cho Bác sĩ các quyền (Bash, Read/Write file). Bác sĩ sẽ tự đi vòng quanh ổ cứng, tự dịch TypeScript (`npx tsc`) để test lỗi cho đến khi Pass 100%.
40
+ 3. **3 Khóa Đỏ Chế Ngự (Red Locks):**
41
+ - **Chống Đệ Quy (Depth Limit):** Bác sĩ không được cấp quyền gọi lệnh vá lỗi để đẻ ra Bác sĩ khác.
42
+ - **Kill-Switch:** Nếu Bác sĩ ảo giác (ngáo) gõ lặp lại 1 lệnh lỗi 2 lần, tự động Force Kill và Rollback.
43
+ - **Giới hạn lặp:** Bác sĩ chỉ có 10 vòng lặp (10 attempts) để cứu bệnh nhân.
44
+ 4. **Semantic Shield:** Sau khi Bác Sĩ báo cáo "Finish", luồng gốc mới chạy `Unit Test` trên file Sandbox đó. Vượt qua Unit Test mới được phép Hot-Reload đè vào Source Code chính!
45
+
46
+ ### 3. Giao Kèo Docstring Định Danh (Docstring Identity Pact)
45
47
  - Ép Prompt của Bác Sĩ: Khai báo đa dòng ở đầu file Code mới: Sửa dòng nào? Tại sao sửa? Tuân thủ triết lý gì?
46
48
 
47
49
  ### 5. Nạp Nóng (Hot-Reload) & Sổ Ghi Chép Chung (Evolution Ledger)