@leejungkiin/awkit 1.7.7 → 1.7.8

package/bin/awk.js

@@ -48,6 +48,7 @@ const { cmdI18n } = require('../scripts/i18n-helper');
 const { cmdStorage } = require('../scripts/artifact-storage');
 const { cmdPipeline } = require('../scripts/multi-model-pipeline');
 const depManager = require('../scripts/dependency-manager');
+const rtkRuntime = require('../scripts/exec-rtk');
 
 
 // ─── Platform Definitions ──────────────────────────────────────────────────
@@ -488,32 +489,31 @@ function flattenWorkflows(srcBase, destDir) {
 }
 
 /**
- * Install or update GEMINI.md into ~/.gemini/
+ * Install or update GEMINI.md into Antigravity rule locations.
  */
 function syncGeminiMd() {
     const srcGemini = path.join(AWK_ROOT, 'core', 'GEMINI.md');
-    const destGemini = TARGETS.geminiMd;
+    const primaryDest = TARGETS.geminiMd;
+    const legacyDest = path.join(PLATFORMS.antigravity.globalRoot, 'GEMINI.md');
+    const destinations = [...new Set([primaryDest, legacyDest])];
 
-    const destDir = path.dirname(destGemini);
-    if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+    for (const destGemini of destinations) {
+        const destDir = path.dirname(destGemini);
+        if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
 
-    // Read existing GEMINI.md if present
-    let existingContent = '';
-    if (fs.existsSync(destGemini)) {
-        existingContent = fs.readFileSync(destGemini, 'utf8');
+        if (fs.existsSync(destGemini)) {
+            const backupDir = path.join(PLATFORMS.antigravity.globalRoot, 'backup');
+            if (!fs.existsSync(backupDir)) fs.mkdirSync(backupDir, { recursive: true });
 
-        // Backup existing
-        const backupDir = path.join(destDir, 'antigravity', 'backup');
-        if (!fs.existsSync(backupDir)) fs.mkdirSync(backupDir, { recursive: true });
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const label = destGemini === legacyDest ? 'GEMINI_legacy' : 'GEMINI';
+            const backupPath = path.join(backupDir, `${label}_${timestamp}.md.bak`);
+            fs.copyFileSync(destGemini, backupPath);
+            dim(`Backup: ${backupPath}`);
+        }
 
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-        const backupPath = path.join(backupDir, `GEMINI_${timestamp}.md.bak`);
-        fs.copyFileSync(destGemini, backupPath);
-        dim(`Backup: ${backupPath}`);
+        fs.copyFileSync(srcGemini, destGemini);
     }
-
-    // Copy new GEMINI.md
-    fs.copyFileSync(srcGemini, destGemini);
     ok('GEMINI.md updated');
 }
 
@@ -1030,16 +1030,12 @@ async function cmdDoctor() {
         warn('schemas/ directory missing'); issues++;
     }
 
-    // 4.5. Check RTK & GitNexus Integration
+    // 4.5. Check optional RTK & GitNexus Integration
     if (depManager.checkRtk()) {
-        ok(`RTK (Rust Token Killer) is installed (v${depManager.getRtkVersion() || 'unknown'})`);
+        const rtkMode = rtkRuntime.getRtkMode();
+        ok(`RTK (Rust Token Killer) is installed (v${depManager.getRtkVersion() || 'unknown'}, mode: ${rtkMode.mode})`);
     } else {
-        warn('RTK (Rust Token Killer) not found.');
-        if (promptYN('Would you like to install RTK automatically now?')) {
-            depManager.installRtk();
-        } else {
-            issues++;
-        }
+        warn('RTK (Rust Token Killer) not found. Optional: run `awkit rtk setup`.');
     }
 
     if (depManager.checkGitnexus()) {
@@ -1073,7 +1069,8 @@ async function cmdDoctor() {
             ok('AWKit is up-to-date');
         }
         
-        const currentRtk = depManager.getRtkVersion();
+        const currentRtkMode = rtkRuntime.getRtkMode();
+        const currentRtk = currentRtkMode.mode === 'off' ? null : depManager.getRtkVersion();
         if (updates.latestRtk && currentRtk && isNewerVersion(updates.latestRtk, currentRtk)) {
             warn(`RTK update available: v${updates.latestRtk} (current: v${currentRtk})`);
         } else if (currentRtk) {
@@ -2339,7 +2336,7 @@ function cmdHelp() {
     log(`  ${C.green}update${C.reset}              Pull latest + reinstall`);
     log(`  ${C.green}lint${C.reset}                Run skill & workflow guards (check length, frontmatter)`);
     log(`  ${C.green}doctor${C.reset}              Check installation health`);
-    log(`  ${C.green}rtk setup${C.reset}           Auto-install and configure RTK wrapper`);
+    log(`  ${C.green}rtk status|setup|off${C.reset} Manage RTK output compression`);
     log(`  ${C.green}credentials list${C.reset}    List stored API keys`);
     log(`  ${C.green}credentials set${C.reset} <k> <v> Set API key (e.g., gemini_api_key, openrouter_api_key)`);
     log(`  ${C.green}set-openrouter${C.reset} <key>  Shorthand for setting OpenRouter API Key`);
@@ -4133,7 +4130,8 @@ async function checkAutoUpdate() {
             log('');
         }
         
-        const currentRtk = depManager.getRtkVersion();
+        const currentRtkMode = rtkRuntime.getRtkMode();
+        const currentRtk = currentRtkMode.mode === 'off' ? null : depManager.getRtkVersion();
         if (updates.latestRtk && currentRtk && isNewerVersion(updates.latestRtk, currentRtk)) {
             log('');
             log(`${C.yellow}${C.bold}🌟 [Thông báo] Có phiên bản mới cho RTK! (v${updates.latestRtk})${C.reset}`);
@@ -4477,35 +4475,12 @@ function cmdGitnexus(args) {
 
 // ─── RTK Integration ──────────────────────────────────────────────────────────
 
-async function cmdRtkSetup() {
-    log(`${C.cyan}${C.bold}╔═══════════════════════════════════════════════════════╗${C.reset}`);
-    log(`${C.cyan}${C.bold}║          ⚙️  RTK Auto-Setup & Configuration           ║${C.reset}`);
-    log(`${C.cyan}${C.bold}╚═══════════════════════════════════════════════════════╝${C.reset}`);
+const RTK_SHELL_MARKER = '# RTK Integration for AI Agents (AWKit)';
+const RTK_SHELL_END_MARKER = '# End RTK Integration for AI Agents (AWKit)';
 
-    const installed = depManager.installRtk();
-    if (!installed) return;
-
-    const zshrcPath = path.join(HOME, '.zshrc');
-    log(`\nConfiguring Shell Aliases in ~/.zshrc...`);
-    if (fs.existsSync(zshrcPath)) {
-        let zshrc = fs.readFileSync(zshrcPath, 'utf8');
-        
-        // Clean up old aliases to avoid collision
-        const oldAliases = [
-            'alias git="rtk git"',
-            'alias npm="rtk npm"',
-            'alias pnpm="rtk pnpm"',
-            'alias yarn="rtk yarn"',
-            'alias cargo="rtk cargo"'
-        ];
-        for (const oldAlias of oldAliases) {
-            if (zshrc.includes(oldAlias)) {
-                zshrc = zshrc.replace(new RegExp(`\\n?${oldAlias}\\n?`, 'g'), '\n');
-            }
-        }
-
-        const functionBlock = `
-# RTK Integration for AI Agents (AWKit)
+function getRtkShellBlock() {
+    return `
+${RTK_SHELL_MARKER}
 unalias npm pnpm yarn cargo git 2>/dev/null
 npm() {
     if [[ "$1" == "login" || "$1" == "adduser" || "$1" == "publish" ]]; then
@@ -4542,19 +4517,130 @@ git() {
         rtk git "$@"
     fi
 }
+${RTK_SHELL_END_MARKER}
 `;
-        // Clean up old RTK integration block if exists to allow updating
-        if (zshrc.includes('# RTK Integration for AI Agents (AWKit)')) {
-            const startIdx = zshrc.indexOf('# RTK Integration for AI Agents (AWKit)');
-            zshrc = zshrc.substring(0, startIdx);
+}
+
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function stripRtkShellBlock(content) {
+    const oldAliases = [
+        'alias git="rtk git"',
+        'alias npm="rtk npm"',
+        'alias pnpm="rtk pnpm"',
+        'alias yarn="rtk yarn"',
+        'alias cargo="rtk cargo"'
+    ];
+    let updated = content;
+    for (const oldAlias of oldAliases) {
+        updated = updated.replace(new RegExp(`^\\s*${escapeRegExp(oldAlias)}\\s*\\n?`, 'gm'), '');
+    }
+
+    const lines = updated.split('\n');
+    const start = lines.findIndex(line => line.trim() === RTK_SHELL_MARKER);
+    if (start === -1) return { content: updated, removed: updated !== content };
+
+    let end = lines.findIndex((line, index) => index >= start && line.trim() === RTK_SHELL_END_MARKER);
+    if (end === -1) {
+        const gitStart = lines.findIndex((line, index) => index >= start && line.trim() === 'git() {');
+        if (gitStart !== -1) {
+            end = lines.findIndex((line, index) => index > gitStart && line.trim() === '}');
         }
-        
-        zshrc += functionBlock;
-        fs.writeFileSync(zshrcPath, zshrc, 'utf8');
-        ok('Shell wrappers successfully added/updated in ~/.zshrc.');
-        log(`\n${C.cyan}Please reload your shell (source ~/.zshrc) to apply shifts.${C.reset}`);
-    } else {
-        warn('~/.zshrc not found. Skipping alias setup.');
+    }
+    if (end === -1) return { content: updated, removed: updated !== content };
+
+    lines.splice(start, end - start + 1);
+    return { content: lines.join('\n').replace(/\n{3,}/g, '\n\n'), removed: true };
+}
+
+function hasRtkShellBlock() {
+    const zshrcPath = path.join(HOME, '.zshrc');
+    return fs.existsSync(zshrcPath) && fs.readFileSync(zshrcPath, 'utf8').includes(RTK_SHELL_MARKER);
+}
+
+function removeRtkShellBlock({ quiet = false } = {}) {
+    const zshrcPath = path.join(HOME, '.zshrc');
+    if (!fs.existsSync(zshrcPath)) {
+        if (!quiet) warn('~/.zshrc not found. Shell wrappers already absent.');
+        return false;
+    }
+
+    const zshrc = fs.readFileSync(zshrcPath, 'utf8');
+    const stripped = stripRtkShellBlock(zshrc);
+    if (!stripped.removed) {
+        if (!quiet) ok('No AWKit RTK shell wrappers found.');
+        return false;
+    }
+
+    fs.writeFileSync(zshrcPath, stripped.content, 'utf8');
+    if (!quiet) ok('AWKit RTK shell wrappers removed from ~/.zshrc.');
+    return true;
+}
+
+function installRtkShellBlock() {
+    if (!depManager.checkRtk()) {
+        err('RTK binary not found. Run `awkit rtk setup` first.');
+        return;
+    }
+
+    const zshrcPath = path.join(HOME, '.zshrc');
+    const zshrc = fs.existsSync(zshrcPath) ? fs.readFileSync(zshrcPath, 'utf8') : '';
+    const stripped = stripRtkShellBlock(zshrc).content.trimEnd();
+    fs.writeFileSync(zshrcPath, `${stripped}\n${getRtkShellBlock()}`, 'utf8');
+    ok('Shell wrappers added to ~/.zshrc.');
+    warn('Reload shell with `source ~/.zshrc` to apply.');
+}
+
+function cmdRtkStatus() {
+    const mode = rtkRuntime.getRtkMode();
+    const installed = depManager.checkRtk();
+    const separator = `${C.gray}${'─'.repeat(56)}${C.reset}`;
+
+    log(`${C.cyan}${C.bold}RTK Status${C.reset}`);
+    log(separator);
+    log(`  Binary:       ${installed ? C.green + 'installed' + C.reset : C.yellow + 'not installed' + C.reset}`);
+    if (installed) log(`  Version:      ${depManager.getRtkVersion() || 'unknown'}`);
+    log(`  Mode:         ${C.bold}${mode.mode}${C.reset}`);
+    log(`  Mode source:  ${mode.source}`);
+    log(`  Global config:${rtkRuntime.getRtkConfigPath()}`);
+    log(`  Shell wrap:   ${hasRtkShellBlock() ? C.yellow + 'enabled in ~/.zshrc' + C.reset : C.green + 'off' + C.reset}`);
+    log('');
+    log(`  Modes: off = raw AWKit, safe = low-risk compression, proxy = track raw, aggressive = old broad wrappers`);
+}
+
+async function cmdRtkSetup() {
+    log(`${C.cyan}${C.bold}╔═══════════════════════════════════════════════════════╗${C.reset}`);
+    log(`${C.cyan}${C.bold}║              RTK Setup & Safe Configuration           ║${C.reset}`);
+    log(`${C.cyan}${C.bold}╚═══════════════════════════════════════════════════════╝${C.reset}`);
+
+    const installed = depManager.checkRtk() || depManager.installRtk();
+    if (!installed) return;
+
+    rtkRuntime.setGlobalRtkMode('safe');
+    ok('RTK mode set to safe.');
+    warn('Shell wrappers are opt-in now. Run `awkit rtk shell-on` only if you want git/npm aliases.');
+    cmdRtkStatus();
+}
+
+function cmdRtkOff() {
+    rtkRuntime.setGlobalRtkMode('off');
+    removeRtkShellBlock({ quiet: true });
+    ok('RTK disabled globally for AWKit.');
+    warn('Reload shell with `source ~/.zshrc` if wrappers were active.');
+}
+
+function cmdRtkMode(mode) {
+    if (!mode) {
+        err(`Usage: awkit rtk mode <${rtkRuntime.VALID_RTK_MODES.join('|')}>`);
+        return;
+    }
+    try {
+        rtkRuntime.setGlobalRtkMode(mode);
+        ok(`RTK mode set to ${mode}.`);
+    } catch (e) {
+        err(e.message);
     }
 }
 
@@ -4562,9 +4648,23 @@ async function cmdRtk(args) {
     const action = args[0];
     if (action === 'setup') {
         await cmdRtkSetup();
+    } else if (!action || action === 'status') {
+        cmdRtkStatus();
+    } else if (action === 'off') {
+        cmdRtkOff();
+    } else if (action === 'on') {
+        cmdRtkMode('safe');
+    } else if (action === 'mode') {
+        cmdRtkMode(args[1]);
+    } else if (rtkRuntime.VALID_RTK_MODES.includes(action)) {
+        cmdRtkMode(action);
+    } else if (action === 'shell-on') {
+        installRtkShellBlock();
+    } else if (action === 'shell-off') {
+        removeRtkShellBlock();
     } else {
         err(`Unknown rtk command: ${action || ''}`);
-        log(`  Available: setup`);
+        log(`  Available: status, setup, off, on, mode, shell-on, shell-off`);
     }
 }
 

package/core/GEMINI.md

@@ -123,6 +123,8 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 ### Communication (CAVEMAN ULTRA)
 - Chat: Tiếng Việt, tối đa 1-2 câu ngắn. Code/Docs: Tiếng Anh.
 - CẤM giải thích dài, chào hỏi. Chỉ xuất KẾT QUẢ.
+- Caveman chỉ nén prose chat. KHÔNG cắt/mất thông tin kỹ thuật: command output, error, stack trace, diff, JSON/API response, file path, line ref, test evidence.
+- Khi relay output, giữ nguyên dòng quan trọng; chỉ tóm tắt phần nhiễu xung quanh.
 - Planning artifacts (implementation_plan.md, walkthrough.md) VẪN chi tiết theo format chuẩn.
 - Tài liệu thảo luận & brainstorm (Brief, Requirements, Brainstorm) PHẢI dùng tiếng Việt (hoặc ngôn ngữ giao tiếp của User), chỉ Code/Architecture mới bắt buộc dùng tiếng Anh.
 
@@ -150,6 +152,12 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Commit: CHỈ qua `awkit gate git auto`. CẤM `git commit` trực tiếp qua bash.
 - Destructive command → double-confirm user. Không chắc → hỏi trước.
 
+### GStack Planning & Code Safety
+- **Office Hours & CEO Review**: Chạy `/office-hours` để thử nghiệm ý tưởng dưới góc nhìn startup/YC. Dùng `/plan-ceo-review` để đạt "trải nghiệm sản phẩm 10 sao" và quản lý phạm vi (scope).
+- **Eng Review & Data Safety**: Chốt kiến trúc và thiết kế dữ liệu. Quét an toàn SQL, concurrency/races, và enum completeness trước khi code.
+- **Pass 1 & Pass 2 Review**: Đánh giá code hai lượt (Pass 1: Critical - SQL/data safety, races, LLM boundary, shell injection, enum; Pass 2: Informational - logic/syntax).
+- **Fix-First Heuristic**: Tự động sửa lỗi cơ học (dead code, N+1 queries, stale comments) và hỏi ý kiến user đối với các quyết định rủi ro/kiến trúc.
+
 ### Subagent Orchestration & Protocol
 - **Định tuyến trước, Tìm kiếm sau:** Tuyệt đối không dùng `grep_search` hoặc `list_dir` diện rộng để định vị subagents (như `critic`). Bắt buộc tra cứu chỉ mục tại `skills/CATALOG.md`, `skills/TRIGGER_INDEX.md` hoặc `skills/review/SKILL.md` trước.
 - **Tận dụng Subagents Cô lập:** Sử dụng built-in subagents (`research` cho tìm kiếm codebase/log thô, `browser` cho các tác vụ UI) để tránh ô nhiễm context trên luồng chat chính.

package/core/GEMINI.md.bak

@@ -1,6 +1,6 @@
 # GEMINI.md — Antigravity v12.6
 
-> Rules only. Updated: 2026-06-15
+> Rules only. Updated: 2026-06-23
 
 ---
 
@@ -62,11 +62,12 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Build: CHỈ dùng `awkit build`. CẤM gọi native (`xcodebuild`, `./gradlew`, `npm run build`).
 - `automation.build.enabled: false` → DỪNG, báo user. KHÔNG fallback native.
 - Thêm params qua `--`: `awkit build -- -destination '...'`. Bypass wrapper = VI PHẠM.
+- **Chạy tác vụ nền (Background Tasks)**: Khi chạy các tác vụ nền hoặc tác vụ dài (>30 giây) như Codex CLI, PHẢI chạy qua wrapper `node scripts/exec-progress.js "<command>"` để hiển thị checklist tiến trình trực quan cho người dùng thay vì để trống màn hình.
 
 ### 7-Gate System
 - Triage: TRIVIAL (→ Gate 4 thẳng) | MODERATE (→ G3+4+5) | COMPLEX (→ all gates).
 - Gates: G1 brainstorm → G1.5 module-spec (COMPLEX+>3mod) → G2 spec-gate → G2.5 visual (skip nếu backend) → G3 symphony-enforcer → G4 execution → G5 verification.
-- **Goal Mode Override:** Khi đang ở goal mode (`/goal`, active Codex goal, hoặc user nói rõ "goal mode") → gates là checklist nội bộ, KHÔNG dừng chờ user approval ở G2/G2.5/G4 checkpoints. AI tự chọn best-effort, tự verify, ghi assumption, rồi tiếp tục tới khi goal complete/bị block thật sự. Safety/destructive/security vẫn phải hỏi.
+- **Goal Mode Override (NO-CONFIRM):** Khi đang ở goal mode (`/goal`, active Codex goal, hoặc user nói rõ "goal mode") → gates là checklist nội bộ, KHÔNG dừng chờ user approval ở bất kỳ bước nào (G2/G2.5/G4 checkpoints, prompt audit, style preview, grid configuration, specs approval, v.v.). AI tự động chọn phương án tối ưu (best-effort/recommended default), tự verify, ghi nhận giả định (assumptions) vào logs/walkthrough, rồi tiếp tục cho đến khi goal hoàn thành hoặc bị block thực sự bởi lỗi kỹ thuật/permission. Chỉ dừng lại hỏi ý kiến khi gặp lệnh thực sự nguy hại (destructive) hoặc nhạy cảm bảo mật quy định tại Safety Guardrails.
 - **Gate 4 Three-Phase:**
   - Phase A 🏗️ Infrastructure → B 🎨 UI Shell (mock) → C ⚡ Logic (real data).
   - COMPLEX+UI: 3 phases bắt buộc. MODERATE+UI: A+C gộp, B optional. TRIVIAL: bypass.
@@ -102,8 +103,11 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Sau khi dùng tool sửa code → KHÔNG in lại code trong chat. Tóm tắt bằng bullets.
 - Code block trong chat: tối đa 10 dòng. Show diff → dùng `render_diffs()`.
 
-### Image Generation Efficiency
-- Image gen: grid/spritesheet cho batch variants, không gen từng ảnh rời.
+### Image Generation & Asset Mandates (BẮT BUỘC)
+- **Cấm tự tạo SVG:** CẤM tự sinh, tự tạo hoặc thiết kế mã SVG cho các UI assets, biểu tượng trang trí, hoặc spritesheet (do chất lượng SVG tự tạo không đảm bảo và không bám sát thiết kế). BẮT BUỘC sử dụng Codex CLI để tạo hình ảnh và spritesheet UI.
+- **Sử dụng Skill bắt buộc:** Tuyệt đối sử dụng các skill `generate-gui-assets` và `hatch-pet` theo tài liệu tương ứng tại `/Users/trungkientn/.agents/skills/generate-gui-assets/SKILL.md` và `/Users/trungkientn/.codex/skills/hatch-pet/SKILL.md`.
+- **Thiết kế dùng Grid để tiết kiệm:** Bắt buộc thiết kế các assets (ngoại trừ background) bằng dạng Grid (spritesheet/atlas) để tối ưu chi phí và tài nguyên.
+- **Quy trình Grid & Tự Động Phê Duyệt:** Luôn ưu tiên tạo và kiểm chứng (verify) theo hướng lưới `8x6` trước. Nếu chất lượng quá xấu, tự động giảm dần số lượng item/kích thước grid xuống các cấu hình nhỏ hơn (ví dụ: 8x5, 6x6, 6x5, v.v.) mà KHÔNG cần hỏi ý kiến hoặc bắt user xác nhận lại (kể cả trong Normal hay Goal Mode).
 
 ### Proactive UI Asset Generation (MANDATORY)
 - **Asset Audit:** Trong Gate 2.5 (Visual Design) và Gate 4 Phase B (UI Shell), BẮT BUỘC rà soát mã nguồn/thiết kế để phát hiện các UI assets bị thiếu (nút bấm, panel, icon, pet, egg...).
@@ -112,12 +116,15 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - **Cấu trúc Lệnh:**
   - Đối với UI assets: `codex exec "Generate GUI asset: [Prompt/Style/Theme] and save it to [path] using the generate-gui-assets skill rules."`
   - Đối với Pet/Egg assets: `codex exec "Generate pet companion asset: [Pet Type/State] and save it to [path] using the hatch-pet skill rules and grid configuration [grid]."`
-- **Chi tiết & Approval:** Tự động thiết lập prompt chi tiết dựa trên Theme của App, tuân thủ tiêu chuẩn Solid Background và hỏi ý kiến user trước khi thực thi lệnh.
+- **Chi tiết & Approval:** Tự động thiết lập prompt chi tiết dựa trên Theme của App, tuân thủ tiêu chuẩn Solid Background và hỏi ý kiến user trước khi thực thi lệnh (Trừ Goal Mode hoặc trường hợp tự động giảm cấu hình lưới grid: Tự động phê duyệt prompt/cấu hình và thực thi lệnh không cần hỏi).
+
 
 
 ### Communication (CAVEMAN ULTRA)
 - Chat: Tiếng Việt, tối đa 1-2 câu ngắn. Code/Docs: Tiếng Anh.
 - CẤM giải thích dài, chào hỏi. Chỉ xuất KẾT QUẢ.
+- Caveman chỉ nén prose chat. KHÔNG cắt/mất thông tin kỹ thuật: command output, error, stack trace, diff, JSON/API response, file path, line ref, test evidence.
+- Khi relay output, giữ nguyên dòng quan trọng; chỉ tóm tắt phần nhiễu xung quanh.
 - Planning artifacts (implementation_plan.md, walkthrough.md) VẪN chi tiết theo format chuẩn.
 - Tài liệu thảo luận & brainstorm (Brief, Requirements, Brainstorm) PHẢI dùng tiếng Việt (hoặc ngôn ngữ giao tiếp của User), chỉ Code/Architecture mới bắt buộc dùng tiếng Anh.
 
@@ -145,6 +152,12 @@ symphony-orchestrator → awf-session-restore (gitnexus state) → nm-memory-syn
 - Commit: CHỈ qua `awkit gate git auto`. CẤM `git commit` trực tiếp qua bash.
 - Destructive command → double-confirm user. Không chắc → hỏi trước.
 
+### GStack Planning & Code Safety
+- **Office Hours & CEO Review**: Chạy `/office-hours` để thử nghiệm ý tưởng dưới góc nhìn startup/YC. Dùng `/plan-ceo-review` để đạt "trải nghiệm sản phẩm 10 sao" và quản lý phạm vi (scope).
+- **Eng Review & Data Safety**: Chốt kiến trúc và thiết kế dữ liệu. Quét an toàn SQL, concurrency/races, và enum completeness trước khi code.
+- **Pass 1 & Pass 2 Review**: Đánh giá code hai lượt (Pass 1: Critical - SQL/data safety, races, LLM boundary, shell injection, enum; Pass 2: Informational - logic/syntax).
+- **Fix-First Heuristic**: Tự động sửa lỗi cơ học (dead code, N+1 queries, stale comments) và hỏi ý kiến user đối với các quyết định rủi ro/kiến trúc.
+
 ### Subagent Orchestration & Protocol
 - **Định tuyến trước, Tìm kiếm sau:** Tuyệt đối không dùng `grep_search` hoặc `list_dir` diện rộng để định vị subagents (như `critic`). Bắt buộc tra cứu chỉ mục tại `skills/CATALOG.md`, `skills/TRIGGER_INDEX.md` hoặc `skills/review/SKILL.md` trước.
 - **Tận dụng Subagents Cô lập:** Sử dụng built-in subagents (`research` cho tìm kiếm codebase/log thô, `browser` cho các tác vụ UI) để tránh ô nhiễm context trên luồng chat chính.

package/core/skill-runtime-manifest.json

@@ -14,6 +14,7 @@
         "awf-version-tracker",
         "brainstorm-agent",
         "code-review",
+        "review",
         "codex-conductor",
         "codex-goal",
         "gemini-conductor",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "description": "Antigravity Workflow Kit v1.6 Unified AI agent orchestration system with Mindful Checkpoints.",
   "main": "bin/awk.js",
   "private": false,

package/scripts/exec-rtk.js

@@ -1,6 +1,83 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
 const { execSync } = require('child_process');
 
 let hasRtkCache = null;
+const HOME = os.homedir();
+const CONFIG_DIR = path.join(HOME, '.gemini', 'antigravity');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'rtk.json');
+const VALID_MODES = new Set(['off', 'proxy', 'safe', 'aggressive']);
+const DEFAULT_MODE = 'safe';
+
+function readJsonFile(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    } catch (_) {
+        return null;
+    }
+}
+
+function findProjectIdentity(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    const root = path.parse(dir).root;
+
+    while (dir !== root) {
+        const candidate = path.join(dir, '.project-identity');
+        if (fs.existsSync(candidate)) return readJsonFile(candidate);
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+
+function normalizeMode(mode) {
+    const normalized = String(mode || '').trim().toLowerCase();
+    return VALID_MODES.has(normalized) ? normalized : null;
+}
+
+function getGlobalRtkConfig() {
+    return readJsonFile(CONFIG_FILE) || {};
+}
+
+function getProjectRtkMode(startDir = process.cwd()) {
+    const identity = findProjectIdentity(startDir);
+    const rtkConfig = identity && identity.automation && identity.automation.rtk;
+    if (!rtkConfig) return null;
+    if (rtkConfig.enabled === false) return 'off';
+    return normalizeMode(rtkConfig.mode);
+}
+
+function getRtkMode(startDir = process.cwd()) {
+    const envMode = normalizeMode(process.env.AWKIT_RTK_MODE || process.env.RTK_MODE);
+    if (envMode) return { mode: envMode, source: 'env' };
+
+    const globalConfig = getGlobalRtkConfig();
+    const globalMode = normalizeMode(globalConfig.mode);
+    if (globalMode) return { mode: globalMode, source: CONFIG_FILE };
+
+    const projectMode = getProjectRtkMode(startDir);
+    if (projectMode) return { mode: projectMode, source: '.project-identity' };
+
+    return { mode: DEFAULT_MODE, source: 'default' };
+}
+
+function setGlobalRtkMode(mode) {
+    const normalized = normalizeMode(mode);
+    if (!normalized) {
+        throw new Error(`Invalid RTK mode: ${mode}. Expected: ${Array.from(VALID_MODES).join(', ')}`);
+    }
+
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify({
+        mode: normalized,
+        updatedAt: new Date().toISOString()
+    }, null, 2) + '\n');
+    return CONFIG_FILE;
+}
+
+function startsWithAny(command, prefixes) {
+    return prefixes.some(prefix => command === prefix || command.startsWith(`${prefix} `));
+}
 
 /**
  * Check if rtk binary is available in the current environment PATH.
@@ -26,12 +103,21 @@ function checkRtk() {
 function execRtkSync(command, options = {}) {
     const opts = { timeout: 30000, ...options };
     const trimmed = command.trim();
-    
-    // Only compress developer commands known to be verbose
-    const eligiblePrefixes = ['git ', 'npm ', 'cargo ', 'yarn ', 'pnpm ', 'grep ', 'find ', 'awkit trello '];
-    const extendedPrefixes = ['cat ', 'curl ', 'xcodebuild ', './gradlew ', 'swift ', 'flutter ', 'dart ', 'pod ', 'brew '];
-    const allEligible = [...eligiblePrefixes, ...extendedPrefixes];
-    const isEligible = allEligible.some(prefix => trimmed.startsWith(prefix));
+    const { mode } = getRtkMode();
+
+    const safeCommands = ['git status', 'git branch', 'git remote', 'git rev-parse', 'git log'];
+    const safePrefixes = ['git add', 'git commit', 'git push'];
+    const aggressivePrefixes = [
+        'git ', 'npm ', 'cargo ', 'yarn ', 'pnpm ', 'grep ', 'find ', 'awkit trello ',
+        'cat ', 'curl ', 'xcodebuild ', './gradlew ', 'swift ', 'flutter ', 'dart ', 'pod ', 'brew '
+    ];
+    const safeEligible = startsWithAny(trimmed, safeCommands) || startsWithAny(trimmed, safePrefixes);
+    const aggressiveEligible = aggressivePrefixes.some(prefix => trimmed.startsWith(prefix));
+    const isEligible = mode === 'aggressive' ? aggressiveEligible : safeEligible;
+
+    if (mode === 'off') {
+        return execSync(command, opts);
+    }
 
     if (!checkRtk()) {
         if (isEligible && !opts.stdio) {
@@ -41,17 +127,26 @@ function execRtkSync(command, options = {}) {
     }
 
     if (trimmed.startsWith('rtk ')) {
-        return execSync(command, options);
+        return execSync(command, opts);
+    }
+
+    if (mode === 'proxy' && aggressiveEligible) {
+        return execSync(`rtk proxy ${command}`, opts);
     }
 
     if (isEligible) {
-        return execSync(`rtk ${command}`, options);
+        return execSync(`rtk ${command}`, opts);
     }
 
-    return execSync(command, options);
+    return execSync(command, opts);
 }
 
 module.exports = {
     execRtkSync,
-    checkRtk
+    checkRtk,
+    getRtkMode,
+    getGlobalRtkConfig,
+    getRtkConfigPath: () => CONFIG_FILE,
+    setGlobalRtkMode,
+    VALID_RTK_MODES: Array.from(VALID_MODES)
 };

package/skills/CATALOG.md

@@ -25,7 +25,7 @@
 | 5 | `brainstorm-agent` | `manual` | `/brainstorm`, keywords | 5 | 1.0.0 | ✅ Active |
 | 6 | `awf-error-translator` | `auto` | Error detected | 6 | — | ✅ Active |
 | 7 | `awf-adaptive-language` | `auto` | Always | 7 | — | ✅ Active |
-| 8 | `awf-caveman` | `auto` | `.project-identity` check | 7.5 | 1.0.0 | ✅ Active |
+| 8 | `awf-caveman` | `auto` | `.project-identity` check | 7.5 | 1.0.1 | ✅ Active |
 | 9 | `ios-engineer` | `manual` | iOS tasks | — | — | ✅ Active |
 | 9 | `smali-to-kotlin` | `manual` | `/reverse-android` | 8 | — | ✅ Active |
 | 10 | `smali-to-swift` | `manual` | `/reverse-ios` | 9 | — | ✅ Active |

package/skills/awf-caveman/SKILL.md

@@ -4,7 +4,7 @@ description: >-
   Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman.
   Checks `.project-identity` for `communication.cavemanMode.enabled`. 
   Supports both Vietnamese and English.
-version: 1.0.0
+version: 1.0.1
 ---
 
 # AWF Caveman Mode
@@ -28,6 +28,17 @@ if config?.communication?.cavemanMode?.enabled == true:
 
 Áp dụng cho mọi phản hồi của AI (cả Tiếng Việt và Tiếng Anh). Mọi hàm lượng kỹ thuật phải giữ nguyên, CHỈ lược bỏ từ thừa.
 
+### Scope Guard
+
+Caveman chỉ được nén phần prose/chat. KHÔNG được cắt, viết tắt, tái diễn giải, hoặc gom nhóm các bằng chứng kỹ thuật cần độ chính xác cao:
+- Command output quan trọng.
+- Error message, stack trace, warning.
+- Diff, patch, JSON/API response.
+- File path, symbol name, line number.
+- Test/build evidence.
+
+Khi cần tiết kiệm token: tóm tắt phần nhiễu xung quanh, nhưng giữ nguyên các dòng kỹ thuật quyết định.
+
 1. **BỎ TỪ ĐỆM**: Bỏ mọi từ thừa, từ lịch sự ("Vâng", "Dạ", "Chắc chắn rồi", "Theo tôi thấy thì...", "Tôi hiểu ý anh...").
 2. **NÓI CỤT LỦN**: Đi thẳng vào vấn đề. Bắt đầu ngay bằng nguyên nhân lỗi hoặc hành động. Dùng câu mảnh (fragments).
 3. **KHÔNG GIẢI THÍCH DÀI DÒNG**: Dùng mũi tên `->` để chỉ nguyên nhân/kết quả.
@@ -55,6 +66,7 @@ if config?.communication?.cavemanMode?.enabled == true:
 Tạm thời ngưng Caveman (trở lại bình thường) khi:
 - Cảnh báo bảo mật quan trọng (Security warnings).
 - Hành động không thể hoàn tác (Xóa DB, git reset --hard).
+- Command output/error/diff là bằng chứng chính của task.
 - Các bước hướng dẫn quá phức tạp dễ gây hiểu nhầm nếu nói tắt.
 - Chữa cháy / Giải thích lỗi quá lắt léo cần rõ nghĩa.