@leejungkiin/awkit 1.7.5 → 1.7.7

package/bin/awk.js

@@ -67,16 +67,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 +89,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 +109,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,
     }
 };
 
@@ -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') {
@@ -1067,7 +1086,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 +1949,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('');
 
@@ -2241,6 +2262,40 @@ function cmdGreet(args) {
     }
 }
 
+function cmdGoal(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        log('');
+        log(`${C.cyan}${C.bold}🎯 awkit goal — Codex Goal Mode Orchestrator${C.reset}`);
+        log('');
+        log('Usage:');
+        log('  awkit goal "<objective>"');
+        log('  awkit goal --status');
+        log('  awkit goal --pause');
+        log('  awkit goal --resume');
+        log('  awkit goal --cancel');
+        log('');
+        return;
+    }
+
+    try {
+        const scriptPath = path.join(__dirname, '..', 'scripts', 'codex-goal.js');
+        const passArgs = [];
+        
+        if (args.length > 0 && !args[0].startsWith('-')) {
+            passArgs.push('--prompt', args.join(' '));
+        } else {
+            passArgs.push(...args);
+        }
+
+        const result = spawnSync('node', [scriptPath, ...passArgs], { stdio: 'inherit' });
+        if (result.status !== 0) {
+            process.exit(result.status || 1);
+        }
+    } catch (e) {
+        err('Failed to execute Codex Goal Mode: ' + e.message);
+    }
+}
+
 function cmdHelp() {
     const line = `${C.gray}${'─'.repeat(56)}${C.reset}`;
     log('');
@@ -2339,6 +2394,16 @@ function cmdHelp() {
     log(`  ${C.gray}  -t, --timezone <tz>${C.reset} Timezone parameter`);
     log('');
 
+    // Goal Mode
+    log(`${C.bold}🎯  Goal Mode${C.reset}`);
+    log(line);
+    log(`  ${C.green}goal${C.reset} <objective>    Pursue a high-level goal using Codex Goal Conductor`);
+    log(`  ${C.green}goal --status${C.reset}       Check active goal status and task progress`);
+    log(`  ${C.green}goal --pause${C.reset}        Pause active goal execution loop`);
+    log(`  ${C.green}goal --resume${C.reset}       Resume paused goal execution`);
+    log(`  ${C.green}goal --cancel${C.reset}       Cancel and reset active goal session`);
+    log('');
+
     // Symphony
     log(`${C.bold}🎶  Symphony${C.reset}`);
     log(line);
@@ -2774,6 +2839,16 @@ function buildProjectIdentity(projectName, projectType, cwd, date) {
         automation: {
             autoQA: true,
             maxSelfCorrectionLoops: 3,
+            multiAgent: {
+                enabled: true,
+                routingMode: 'cost-optimized',
+                audioAlerts: true,
+                runners: {
+                    claude: 'claude',
+                    codex: 'codex',
+                    qwen: 'qwen'
+                }
+            },
             telegram: {
                 enabled: true,
                 chatId: "",
@@ -3021,6 +3096,16 @@ async function cmdInit(forceFlag = false) {
             currentIdentity.automation = {
                 autoQA: true,
                 maxSelfCorrectionLoops: 3,
+                multiAgent: {
+                    enabled: true,
+                    routingMode: 'cost-optimized',
+                    audioAlerts: true,
+                    runners: {
+                        claude: 'claude',
+                        codex: 'codex',
+                        qwen: 'qwen'
+                    }
+                },
                 telegram: {
                     enabled: true,
                     chatId: "",
@@ -3061,6 +3146,33 @@ async function cmdInit(forceFlag = false) {
                 currentIdentity.automation.maxSelfCorrectionLoops = 3;
                 changed = true;
             }
+            if (!currentIdentity.automation.multiAgent) {
+                currentIdentity.automation.multiAgent = {
+                    enabled: true,
+                    routingMode: 'cost-optimized',
+                    audioAlerts: true,
+                    runners: {
+                        claude: 'claude',
+                        codex: 'codex',
+                        qwen: 'qwen'
+                    }
+                };
+                changed = true;
+            } else {
+                if (!currentIdentity.automation.multiAgent.runners) {
+                    currentIdentity.automation.multiAgent.runners = {
+                        claude: 'claude',
+                        codex: 'codex',
+                        qwen: 'qwen'
+                    };
+                    changed = true;
+                } else {
+                    const runners = currentIdentity.automation.multiAgent.runners;
+                    if (!runners.claude) { runners.claude = 'claude'; changed = true; }
+                    if (!runners.codex) { runners.codex = 'codex'; changed = true; }
+                    if (!runners.qwen) { runners.qwen = 'qwen'; changed = true; }
+                }
+            }
             if (!currentIdentity.automation.obsidian) {
                 currentIdentity.automation.obsidian = { enabled: false, path: "", autoSync: false };
                 changed = true;
@@ -5150,6 +5262,9 @@ const [, , command, ...args] = process.argv;
         case 'greet':
             cmdGreet(args);
             break;
+        case 'goal':
+            cmdGoal(args);
+            break;
         case 'config-global':
             cmdGlobalConfig(args);
             break;

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)) {
@@ -76,7 +105,8 @@ function generateCodexAgents(srcDir, destDir, selectedSkills = null) {
         'problem-solving-pro',
         'swiftui-pro',
         'android-re-analyzer',
-        'brainstorm-agent'
+        'brainstorm-agent',
+        'codex-goal'
     ];
 
     let count = 0;

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,7 +116,8 @@ 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)
@@ -191,5 +196,5 @@ Complete>Shortcuts, Evidence>Assumptions, Standard>Custom, Explicit>Implicit, Te
 - **Gate skills:** `orchestrator` (triage) → `brainstorm-agent` (G1) → `module-spec-writer` (G1.5) → `spec-gate` (G2) → `visual-design-gate` (G2.5) → `symphony-enforcer` (G3) → `verification-gate` (G5)
 - **Code intelligence:** `gitnexus-intelligence` (impact analysis, blast radius, safe refactoring)
 - **Skill catalog:** xem `orchestrator/SKILL.md`
-- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach
-- **Shortcuts:** `/todo` `/done` `/next`
+- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach /goal
+- **Shortcuts:** `/todo` `/done` `/next` `/goal`

package/core/GEMINI.md.bak

@@ -191,5 +191,5 @@ Complete>Shortcuts, Evidence>Assumptions, Standard>Custom, Explicit>Implicit, Te
 - **Gate skills:** `orchestrator` (triage) → `brainstorm-agent` (G1) → `module-spec-writer` (G1.5) → `spec-gate` (G2) → `visual-design-gate` (G2.5) → `symphony-enforcer` (G3) → `verification-gate` (G5)
 - **Code intelligence:** `gitnexus-intelligence` (impact analysis, blast radius, safe refactoring)
 - **Skill catalog:** xem `orchestrator/SKILL.md`
-- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach
-- **Shortcuts:** `/todo` `/done` `/next`
+- **Workflows:** 75+ (/xxx). Core: /init /code /debug /recap /next /todo /gitnexus /teach /goal
+- **Shortcuts:** `/todo` `/done` `/next` `/goal`

package/core/skill-runtime-manifest.json

@@ -15,6 +15,7 @@
         "brainstorm-agent",
         "code-review",
         "codex-conductor",
+        "codex-goal",
         "gemini-conductor",
         "generate-gui-assets",
         "gitnexus-intelligence",

package/docs/history/implementation_plan.v1.md

@@ -1,58 +1,62 @@
-# Add Game Development Skills (Unity, Godot, Expo)
+# Implementation Plan - GreetingApp Feature
 
-Implement dedicated game development skills inside `main-awf/skills` to enhance the orchestrator's capability in building games using Unity, Godot, and Expo.
-
-## User Review Required
-
-> [!NOTE]
-> All new skills will be created directly in `skills/` of `main-awf` workspace and then deployed to `~/.gemini/antigravity` via `awkit install`.
-
-## Proposed Changes
-
-### AWKit Skills
+## Revision History
+| Version | Date | Description | Author |
+|---|---|---|---|
+| v1.0 | 2026-06-22 | Initial implementation plan for GreetingApp | Antigravity Orchestrator |
 
 ---
 
-#### [NEW] [unity-game-development/SKILL.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/unity-game-development/SKILL.md)
-Contains high-density instructions for Unity game development, enforcing:
-- C# coding style (PascalCase public, camelCase private, `m_` fields prefix).
-- Component-based architecture and ScriptableObjects for data-driven game structures.
-- Performance optimization: avoiding `Find`/`GetComponent` in hot paths (`Update()`), caching, object pooling.
-- Separate Editor code via `#if UNITY_EDITOR`.
-- Direct Unity MCP server integration.
-
-#### [NEW] [godot-game-development/SKILL.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/godot-game-development/SKILL.md)
-Contains guidelines for Godot 4.x game development, enforcing:
-- Godot 4 API standards (rejecting Godot 3 syntax).
-- GDScript style preferences (`@export`, `@onready`, `await` signals).
-- Composition-first scene tree structure over deep class inheritance.
-- Signal connection best practices (`signal.connect(callback)`).
-- Physics and locomotion handling via parameterless `move_and_slide()`.
-
-#### [NEW] [expo-game-development/SKILL.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/expo-game-development/SKILL.md)
-Contains instructions for Expo/React Native game development, covering:
-- High-frequency drawing techniques (React Native Skia, Expo GL/Three.js).
-- State optimization: keeping physics/game tick loop decoupled from heavy React re-renders.
-- User input handling (React Native Gesture Handler).
-- Game loop implementations using `requestAnimationFrame`.
-- Asset management and sound effects via `expo-av`.
+## 1. Objectives
+Implement the GreetingApp feature within the `main-awf` workspace, integrating:
+- A shared Greeting Engine at `core/GreetingEngine`.
+- CLI Interface command `awkit greet` in `bin/awk.js`.
+- REST API endpoint `GET /api/greet` in `symphony/app/api/greet/route.js`.
+- Light history logging via JSON Lines at `~/.gemini/antigravity/greeting_history.jsonl` (and local project fallback).
 
 ---
 
-#### [MODIFY] [CATALOG.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/CATALOG.md)
-Add the three new skills to the active skills table.
-
-#### [MODIFY] [TRIGGER_INDEX.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/TRIGGER_INDEX.md)
-Register keywords and triggers for the new game skills.
+## 2. Proposed Changes
+
+### Phase A: Core Engine and Locales
+#### 1. Locales Definition
+Create locales JSON files under `core/GreetingEngine/locales/`:
+- `en.json`: English templates.
+- `vi.json`: Vietnamese templates.
+- `ja.json`: Japanese templates.
+
+#### 2. Greeting Engine (`core/GreetingEngine/index.js`)
+Create the core processor. It will:
+- Parse `name` (default: "Guest"), `lang` (default: "en"), and `timezone` (default: local).
+- Determine time-of-day period (`morning` 5-11:59, `afternoon` 12-17:59, `evening` 18-21:59, `night` 22-4:59).
+- Load localization strings, format the template by replacing `{name}`, and return the object.
+- Record transactions to `greeting_history.jsonl`.
+- Provide stats functions.
+
+### Phase B: CLI Integration
+#### 1. CLI Commands (`bin/awk.js`)
+- Register the `greet` subcommand in the main switch-case.
+- Parse flags: `--name` / `-n`, `--lang` / `-l`, and `--timezone` / `-t` (or use system timezone).
+- Print the generated greeting and save to the history log.
+
+### Phase C: REST API Integration
+#### 1. API Route Handler (`symphony/app/api/greet/route.js`)
+- Define `GET` handler.
+- Extract `name`, `lang`, and `timezone` query parameters.
+- Call the Greeting Engine.
+- Return structured JSON response following spec.
 
 ---
 
-## Verification Plan
+## 3. Verification Plan
 
-### Automated Verification
-- Run `awkit status` to inspect mapping diffs.
-- Deploy to runtime using `awkit install`.
-- Verify CLI integration and syntax using `awkit doctor`.
+### Automated/Unit Tests
+- Verify engine resolves times and timezones correctly.
+- Verify fallback to `en` on unrecognized language inputs.
+- Verify JSON structure matches specifications.
 
 ### Manual Verification
-- Ask the user to verify the added skills locally or confirm availability in future workspace tasks.
+- Execute `node bin/awk.js greet --name="Alice" --lang="vi"`.
+- Execute `node bin/awk.js greet --name="Bob" --lang="ja"`.
+- Query Symphony REST API `/api/greet?name=Charlie&lang=en` locally.
+- Inspect the history log at the designated path.

package/docs/history/implementation_plan.v2.md

@@ -0,0 +1,87 @@
+# Implementation Plan - Codex Goal Mode Integration
+
+## Revision History
+| Version | Date | Description | Author |
+|---|---|---|---|
+| v1.0 | 2026-06-22 | Initial plan for Codex Goal Mode, skill, and workflow integration | Antigravity Orchestrator |
+
+---
+
+## Goal Description
+Implement a **Goal Mode** (including a new **Skill** and a **Workflow**) that utilizes the Codex goal-execution capabilities for centralized task orchestration. In this mode, Codex serves as the master coordinator (Goal Conductor), partitioning a high-level user goal into subtasks, tracking progress in Symphony, and delegating specific duties back to other specialized agents (Claude, Qwen, Gemini/AGY) or its own independent sub-agents (e.g., critic, coder, tester, ios-engineer) in a collaborative loop.
+
+---
+
+## User Review Required
+
+> [!IMPORTANT]
+> **Orchestration Loop Protocol:** Codex Goal Mode runs as a closed-loop execution system. Checkpoints are automatically bypassed when `goal_mode = true` (using best-effort AI verification) except for safety-critical, destructive, or security tasks.
+
+---
+
+## Open Questions
+- Do we want to support persistent background session resume for long-running goals (e.g., using `codex resume --last`)? *(Currently planned to support resume by storing execution states in `codex-reports/goals/`).*
+
+---
+
+## Proposed Changes
+
+### Core Orchestration Layer
+
+#### [NEW] [codex-goal.js](file:///Users/trungkientn/Dev/NodeJS/main-awf/scripts/codex-goal.js)
+Create a new script that coordinates the Goal loop:
+1. Initializes a goal workspace under `codex-reports/goals/<goal_id>/`.
+2. Sets `goal_mode = true` in the process context.
+3. Invokes Codex CLI to analyze the initial goal, parse it into subtasks, and map them to appropriate agents.
+4. Orchestrates task execution:
+   - For architecture & specs: Delegates to Claude via `scripts/claude-plan.js`.
+   - For coding/refactoring: Delegates to Qwen via `scripts/qwen-exec.js`.
+   - For general tasks/fallbacks: Delegates to AGY (Gemini).
+   - For reviews, tests, visual QA: Delegates to Codex sub-agents (`critic`, `tester`, `ios-visual-qa-strategist`).
+5. Tracks states, saves progress reports to `.md` files, and updates Symphony tickets.
+
+---
+
+### Workflows
+
+#### [NEW] [goal.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/workflows/lifecycle/goal.md)
+Define the `/goal` workflow containing:
+- Pre-requisites checks for Codex CLI.
+- Workflow subcommands: `/goal "[objective]"`, `/goal:status`, `/goal:resume`, `/goal:pause`, `/goal:cancel`.
+- Detailed description of the autonomous goal execution loop.
+- Fallback policies and recovery steps.
+
+---
+
+### Skills
+
+#### [NEW] [SKILL.md](file:///Users/trungkientn/Dev/NodeJS/main-awf/skills/codex-goal/SKILL.md)
+Create a new skill for the Codex Goal Orchestrator defining:
+- Developer instructions for the master Goal Conductor role.
+- Task breakdown schemas and JSON mapping format.
+- Sub-agent specifications (definitions, system prompts, capabilities).
+- Call-back protocols for Claude, Qwen, and AGY.
+
+---
+
+### CLI & Code Integration
+
+#### [MODIFY] [awk.js](file:///Users/trungkientn/Dev/NodeJS/main-awf/bin/awk.js)
+1. Register `goal` in the CLI command list and register the command parser.
+2. Include the new `/goal` and `/goal-mode` commands in the help usage block.
+3. Add the `codex-goal` skill folder to the default runtime list, ensuring it gets synced during `awkit install`.
+
+#### [MODIFY] [codex-generators.js](file:///Users/trungkientn/Dev/NodeJS/main-awf/bin/codex-generators.js)
+Add `codex-goal` to `SPECIALIST_SKILLS` list so that a Codex-compatible `.toml` agent spec is automatically generated for it.
+
+---
+
+## Verification Plan
+
+### Automated Tests
+- Run `node bin/awk.js doctor` to check installation state.
+- Run `awkit status` to ensure all files are synchronized.
+
+### Manual Verification
+- Execute `node bin/awk.js goal "Build a simple greeting command line tool"` and verify that the orchestration loop initializes the plan, registers tasks, calls Qwen for implementation, and reviews using the critic sub-agent.
+- Verify status checks, pause, and resume capabilities.

package/package.json

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