@leejungkiin/awkit 1.7.6 → 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 ──────────────────────────────────────────────────
@@ -67,16 +68,18 @@ const PLATFORMS = {
         },
         supportsCustomModes: false,
         supportsSubagents: false,
+        isGlobal: true,
     },
     cline: {
         name: 'Cline (VS Code)',
-        globalRoot: process.cwd(), // Local to project
+        globalRoot: path.join(HOME, '.cline'),
         rulesFile: path.join(HOME, '.cline', 'rules', 'antigravity-rules.md'),
         versionFile: path.join(HOME, '.cline', 'awk_version'),
         dirs: {
-            workflows: '.clinerules',
-            skills: '.clinerules/skills',
+            workflows: 'rules',
+            skills: 'rules',
         },
+        isGlobal: true,
     },
     codex: {
         name: 'Codex (OpenAI)',
@@ -87,15 +90,17 @@ const PLATFORMS = {
             agents: 'agents',
             skills: '../.agents/skills',
         },
+        isGlobal: true,
     },
     claude: {
         name: 'Claude Code',
-        globalRoot: process.cwd(), // Local to project
+        globalRoot: path.join(HOME, '.claude'),
         rulesFile: 'CLAUDE.md',
-        versionFile: '.claude/awk_version',
+        versionFile: 'awk_version',
         dirs: {
-            skills: '.claude/skills',
+            skills: 'skills',
         },
+        isGlobal: true,
     },
     qwen: {
         name: 'Qwen Code',
@@ -105,15 +110,17 @@ const PLATFORMS = {
         dirs: {
             skills: 'skills',
         },
+        isGlobal: true,
     },
     cursor: {
         name: 'Cursor AI',
-        globalRoot: process.cwd(), // Local to project
-        rulesFile: '.cursor/rules/antigravity-rules.mdc',
-        versionFile: '.cursor/awk_version',
+        globalRoot: path.join(HOME, '.cursor'),
+        rulesFile: path.join(HOME, '.cursor', 'rules', 'antigravity-rules.mdc'),
+        versionFile: path.join(HOME, '.cursor', 'awk_version'),
         dirs: {
-            skills: '.cursor/rules',
+            skills: 'rules',
         },
+        isGlobal: true,
     }
 };
 
@@ -482,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');
 }
 
@@ -538,8 +544,19 @@ function cmdInstall(args = []) {
     const isUpdate = args.includes('--update');
     let selectedPlatforms = [];
 
-    if (args.includes('--all') || args.includes('-a') || args.includes('all')) {
-        selectedPlatforms = Object.keys(PLATFORMS);
+    const hasAll = args.includes('--all') || args.includes('-a') || args.includes('all');
+    const hasLocal = args.includes('--local') || args.includes('-l') || args.includes('local');
+
+    if (hasAll) {
+        // Mặc định --all chỉ cài đặt các platform Global
+        selectedPlatforms = Object.keys(PLATFORMS).filter(p => PLATFORMS[p].isGlobal);
+        if (hasLocal) {
+            // Nếu có cả --local thì cài tất cả các platform
+            selectedPlatforms = Object.keys(PLATFORMS);
+        }
+    } else if (hasLocal) {
+        // Chỉ cài các platform Local
+        selectedPlatforms = Object.keys(PLATFORMS).filter(p => !PLATFORMS[p].isGlobal);
     } else {
         if (args.includes('--gemini') || args.includes('-g') || args.includes('antigravity')) selectedPlatforms.push('antigravity');
         if (args.includes('--cline') || args.includes('cline')) selectedPlatforms.push('cline');
@@ -552,7 +569,7 @@ function cmdInstall(args = []) {
         let legacyArg = null;
         if (pIdx !== -1 && args[pIdx + 1]) {
             legacyArg = args[pIdx + 1];
-        } else if (args.length > 0 && !args[0].startsWith('-') && args[0] !== 'all' && args[0] !== '--update') {
+        } else if (args.length > 0 && !args[0].startsWith('-') && args[0] !== 'all' && args[0] !== '--update' && args[0] !== 'local') {
             legacyArg = args[0];
         }
 
@@ -569,17 +586,17 @@ function cmdInstall(args = []) {
             const defaultPlatform = getActivePlatform();
             const defaultChoice = String(Math.max(platformOrder.indexOf(defaultPlatform), 0) + 1);
             log(`${C.cyan}Select platforms to install (e.g., type "1,2", "all", or "1-6"):${C.reset}`);
-            log(`  1. Gemini Code Assist (antigravity)`);
-            log(`  2. Cline (VS Code)`);
-            log(`  3. Codex CLI (codex)`);
-            log(`  4. Claude Code (.claude/)`);
-            log(`  5. Qwen Code (~/.qwen/)`);
-            log(`  6. Cursor AI (.cursor/rules/)`);
-            log(`  7. All of the above`);
+            log(`  1. Gemini Code Assist (antigravity) [Global]`);
+            log(`  2. Cline (VS Code) [Global]`);
+            log(`  3. Codex CLI (codex) [Global]`);
+            log(`  4. Claude Code (.claude/) [Global]`);
+            log(`  5. Qwen Code (~/.qwen/) [Global]`);
+            log(`  6. Cursor AI (.cursor/rules/) [Global]`);
+            log(`  7. All platforms (1-6)`);
             log(`${C.gray}Press Enter to install only the active platform: ${PLATFORMS[defaultPlatform].name}.${C.reset}`);
             const choice = promptChoice('Choice', defaultChoice).trim().toLowerCase();
 
-            if (choice === '7' || choice === 'all') {
+            if (choice === '7' || choice === 'all' || choice === '1-6') {
                 selectedPlatforms = Object.keys(PLATFORMS);
             } else {
                 if (choice.includes('1')) selectedPlatforms.push('antigravity');
@@ -704,6 +721,8 @@ function cmdInstall(args = []) {
                 generateClineSkills(skillsSrc, skillsDest, coreSkills);
             } else if (platform === 'codex') {
                 generateCodexSkills(skillsSrc, skillsDest, coreSkills);
+                const codexSkillsDest = path.join(target, 'skills');
+                generateCodexSkills(skillsSrc, codexSkillsDest, coreSkills);
                 const agentsDest = path.join(target, plat.dirs.agents);
                 generateCodexAgents(skillsSrc, agentsDest, coreSkills);
             } else if (platform === 'claude') {
@@ -1011,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()) {
@@ -1054,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) {
@@ -1067,7 +1083,8 @@ async function cmdDoctor() {
     log('');
     log(`${C.bold}Runtime Profile:${C.reset}`);
     log(`  Profile: ${C.cyan}${installState.profile}${C.reset}`);
-    log(`  Optional packs: ${installState.enabledPacks?.length ? installState.enabledPacks.join(', ') : C.gray + 'none' + C.reset}`);
+    const visiblePacks = (installState.enabledPacks || []).filter(p => p !== 'reverse-engineering');
+    log(`  Optional packs: ${visiblePacks.length ? visiblePacks.join(', ') : C.gray + 'none' + C.reset}`);
 
     // Summary
     log('');
@@ -1929,7 +1946,8 @@ function cmdStatus() {
     }
 
     log(`  ${C.gray}Profile:${C.reset}         ${installState.profile}`);
-    log(`  ${C.gray}Optional packs:${C.reset}  ${installState.enabledPacks?.length ? installState.enabledPacks.join(', ') : 'none'}`);
+    const visiblePacksStatus = (installState.enabledPacks || []).filter(p => p !== 'reverse-engineering');
+    log(`  ${C.gray}Optional packs:${C.reset}  ${visiblePacksStatus.length ? visiblePacksStatus.join(', ') : 'none'}`);
 
     log('');
 
@@ -2318,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`);
@@ -4112,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}`);
@@ -4456,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 installed = depManager.installRtk();
-    if (!installed) return;
+const RTK_SHELL_MARKER = '# RTK Integration for AI Agents (AWKit)';
+const RTK_SHELL_END_MARKER = '# End RTK Integration for AI Agents (AWKit)';
 
-    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
@@ -4521,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);
     }
 }
 
@@ -4541,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/bin/codex-generators.js

@@ -16,9 +16,36 @@ function generateCodexAgentsMd(sourcePath, destPath) {
     console.log(`✅ Codex AGENTS.md generated at: ${destPath}`);
 }
 
+/**
+ * Recursively copies a skill directory preserving structure.
+ */
+function copySkillDir(src, dest) {
+    if (!fs.existsSync(src)) return 0;
+    fs.mkdirSync(dest, { recursive: true });
+
+    let count = 0;
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+        if (entry.name === '.DS_Store') continue;
+        if (entry.name === '__pycache__') continue;
+
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (entry.isDirectory()) {
+            count += copySkillDir(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+            count++;
+        }
+    }
+    return count;
+}
+
 /**
  * Generates Codex skills directory structure.
- * Copies SKILL.md and parses it.
+ * Copies the entire skill directory and parses/injects frontmatter to SKILL.md.
  */
 function generateCodexSkills(srcDir, destDir, selectedSkills = null) {
     if (!fs.existsSync(srcDir)) return;
@@ -37,11 +64,13 @@ function generateCodexSkills(srcDir, destDir, selectedSkills = null) {
         const skillFile = path.join(skillDir, 'SKILL.md');
         if (fs.existsSync(skillFile)) {
             const destSkillDir = path.join(destDir, skill);
-            fs.mkdirSync(destSkillDir, { recursive: true });
+            
+            // Copy the entire directory first
+            copySkillDir(skillDir, destSkillDir);
 
             const destPath = path.join(destSkillDir, 'SKILL.md');
 
-            let content = fs.readFileSync(skillFile, 'utf8');
+            let content = fs.readFileSync(destPath, 'utf8');
 
             if (content.startsWith('---\n')) {
                 if (!content.match(/^name:/m)) {

package/core/GEMINI.md

@@ -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.