@leejungkiin/awkit 1.7.4 → 1.7.6

package/scripts/multi-model-pipeline.js

@@ -3,11 +3,12 @@
  * Orchestrates tasks across Gemini Flash Medium, agy (Claude Opus), and Codex.
  */
 
-const { execSync } = require('child_process');
+const { execSync, spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
-const AGY_PATH = '/Users/trungkientn/.local/bin/agy';
+const AGY_PATH = path.join(os.homedir(), '.local', 'bin', 'agy');
 
 const C = {
     reset: '\x1b[0m',
@@ -25,6 +26,15 @@ const warn = (msg) => log(`${C.yellow}⚠${C.reset} ${msg}`);
 const err = (msg) => log(`${C.red}✖${C.reset} ${msg}`);
 const info = (msg) => log(`${C.cyan}ℹ${C.reset} ${msg}`);
 
+// Load configurations from .project-identity
+let config = {};
+try {
+    const configPath = path.join(__dirname, '..', '.project-identity');
+    if (fs.existsSync(configPath)) {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+} catch (_) {}
+
 function findAgy() {
     if (fs.existsSync(AGY_PATH)) {
         return AGY_PATH;
@@ -36,9 +46,135 @@ function findAgy() {
     }
 }
 
+function findClaudePath() {
+    if (config.automation?.multiAgent?.runners?.claude) {
+        const p = config.automation.multiAgent.runners.claude;
+        if (fs.existsSync(p)) return p;
+    }
+    const homeClaude = path.join(os.homedir(), '.claude', 'local', 'claude');
+    if (fs.existsSync(homeClaude)) return homeClaude;
+
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which claude"' : 'bash -lc "which claude"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+
+    return 'claude';
+}
+
+function findCodexPath() {
+    if (config.automation?.multiAgent?.runners?.codex) {
+        const p = config.automation.multiAgent.runners.codex;
+        if (fs.existsSync(p)) return p;
+    }
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which codex"' : 'bash -lc "which codex"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    return 'codex';
+}
+
+function findQwenPath() {
+    if (config.automation?.multiAgent?.runners?.qwen) {
+        const p = config.automation.multiAgent.runners.qwen;
+        if (fs.existsSync(p)) return p;
+    }
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which qwen"' : 'bash -lc "which qwen"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    return 'qwen';
+}
+
+function readGlobalConfig() {
+    const defaultConf = {
+        audioAlerts: true,
+        runners: {
+            claude: true,
+            codex: true,
+            qwen: true
+        }
+    };
+    try {
+        const globalConfigPath = path.join(os.homedir(), '.awkit_config.json');
+        if (fs.existsSync(globalConfigPath)) {
+            const parsed = JSON.parse(fs.readFileSync(globalConfigPath, 'utf8'));
+            return {
+                ...defaultConf,
+                ...parsed,
+                runners: {
+                    ...defaultConf.runners,
+                    ...(parsed.runners || {})
+                }
+            };
+        }
+    } catch (_) {}
+    return defaultConf;
+}
+
+function isRunnerEnabled(runnerName) {
+    const localVal = config.automation?.multiAgent?.runnersEnabled?.[runnerName];
+    if (localVal !== undefined) return localVal;
+
+    const globalConfig = readGlobalConfig();
+    const globalVal = globalConfig.runners?.[runnerName];
+    if (globalVal !== undefined) return globalVal;
+
+    return true;
+}
+
+function isRunnerAvailable(runnerName) {
+    if (!isRunnerEnabled(runnerName)) return false;
+    let p;
+    if (runnerName === 'claude') p = findClaudePath();
+    else if (runnerName === 'codex') p = findCodexPath();
+    else if (runnerName === 'qwen') p = findQwenPath();
+    else return false;
+
+    if (fs.existsSync(p)) return true;
+    try {
+        execSync(`which ${p} || command -v ${p}`, { stdio: 'ignore' });
+        return true;
+    } catch (_) {
+        return false;
+    }
+}
+
+
+function playAudioAlert(message = "Quy trình đã hoàn thành") {
+    // 1. Read global configuration
+    let globalAudio = true;
+    try {
+        const globalConfigPath = path.join(os.homedir(), '.awkit_config.json');
+        if (fs.existsSync(globalConfigPath)) {
+            const globalConfig = JSON.parse(fs.readFileSync(globalConfigPath, 'utf8'));
+            if (globalConfig.audioAlerts !== undefined) {
+                globalAudio = globalConfig.audioAlerts;
+            }
+        }
+    } catch (_) {}
+
+    // 2. Read local project identity config
+    let localAudio = config.automation?.multiAgent?.audioAlerts;
+
+    // Local configuration takes priority. If not defined, fallback to global config.
+    const audioEnabled = localAudio !== undefined ? localAudio : globalAudio;
+
+    if (audioEnabled) {
+        try {
+            execSync(`afplay /System/Library/Sounds/Glass.aiff && say "${message}"`, { stdio: 'ignore' });
+        } catch (_) {}
+    }
+}
+
 function runPlanStep(featureName) {
-    const agyBin = findAgy();
-    info(`Khởi chạy Lập kế hoạch Kiến trúc (Opus 4.6 via agy CLI)...`);
+    info(`Khởi chạy Lập kế hoạch Kiến trúc...`);
     
     // Ensure docs and docs/specs directories exist
     fs.mkdirSync(path.join(process.cwd(), 'docs', 'specs'), { recursive: true });
@@ -46,72 +182,178 @@ function runPlanStep(featureName) {
     const specFile = `docs/specs/${featureName.toLowerCase().replace(/\s+/g, '_')}_spec.md`;
     const prompt = `Thực hiện lập kế hoạch chi tiết cho tính năng '${featureName}'. Tạo PRD tại docs/PRD.md và Spec chi tiết tại ${specFile}. Hãy vẽ kèm sơ đồ Mermaid thể hiện luồng xử lý. Hãy phản hồi ngắn gọn bằng JSON tóm tắt các files đã tạo và mô tả kế hoạch.`;
 
-    const cmd = `"${agyBin}" --model claude-opus --print "${prompt.replace(/"/g, '\\"')}" < /dev/null`;
+    let planSuccess = false;
     
-    try {
-        log(`${C.gray}$ ${cmd}${C.reset}`);
-        const output = execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
-        log(output);
-        ok(`Hoàn thành lập kế hoạch kiến trúc.`);
-        ok(`PRD đã lưu tại docs/PRD.md`);
-        ok(`Spec đã lưu tại ${specFile}`);
-    } catch (e) {
-        err(`Lỗi lập kế hoạch: ${e.message}`);
-        process.exit(1);
+    if (isRunnerAvailable('claude')) {
+        const claudePath = findClaudePath();
+        try {
+            info(`Calling Claude CLI (${claudePath}) for Architect Planning...`);
+            log(`$ ${claudePath} -p "..." --print --no-session-persistence --permission-mode bypassPermissions`);
+            const result = spawnSync(claudePath, [
+                '-p', prompt,
+                '--print',
+                '--no-session-persistence',
+                '--permission-mode', 'bypassPermissions'
+            ], { encoding: 'utf8', timeout: 30000 }); // 30s timeout for Claude
+
+            if (result.status === 0) {
+                log(result.stdout);
+                planSuccess = true;
+            } else {
+                warn(`Claude planning failed: ${result.stderr || result.stdout}`);
+            }
+        } catch (e) {
+            warn(`Claude planning failed or timed out: ${e.message}. Falling back to agy (Gemini)...`);
+        }
+    } else {
+        info(`Claude CLI is disabled or not available. Falling back directly to agy (Gemini)...`);
+    }
+
+    if (!planSuccess) {
+        const agyBin = findAgy();
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const result = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', prompt
+            ], { encoding: 'utf8', timeout: 60000 });
+
+            if (result.status === 0) {
+                log(result.stdout);
+            } else {
+                err(`Lỗi lập kế hoạch: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi lập kế hoạch: ${e.message}`);
+            process.exit(1);
+        }
     }
+
+    ok(`Hoàn thành lập kế hoạch kiến trúc.`);
+    ok(`PRD đã lưu tại docs/PRD.md`);
+    ok(`Spec đã lưu tại ${specFile}`);
+    playAudioAlert("Kế hoạch kiến trúc đã hoàn thành");
 }
 
 function runUiStep(featureName) {
-    info(`Khởi chạy Thiết kế Shell & GUI Assets (Codex CLI)...`);
-    
     // Ensure assets/ui directory exists
     fs.mkdirSync(path.join(process.cwd(), 'assets', 'ui'), { recursive: true });
 
     // Step A: Prompt to generate layout demo preview HTML/CSS or mockup code
     const promptPreview = `Tạo UI Demo Preview dưới dạng HTML/CSS tĩnh hoặc SwiftUI shell cho tính năng '${featureName}' dựa trên tài liệu docs/PRD.md và spec hiện có. Lưu tệp demo vào assets/ui/demo_preview.html.`;
-    const cmdPreview = `codex exec "${promptPreview.replace(/"/g, '\\"')}" --sandbox read-only < /dev/null`;
 
-    try {
-        log(`${C.gray}$ ${cmdPreview}${C.reset}`);
-        const outPreview = execSync(cmdPreview, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
-        log(outPreview);
-        ok(`Đã sinh UI Demo Preview tại assets/ui/demo_preview.html`);
-    } catch (e) {
-        err(`Lỗi sinh UI Demo Preview: ${e.message}`);
-        process.exit(1);
-    }
+    if (isRunnerAvailable('codex')) {
+        info(`Khởi chạy Thiết kế Shell & GUI Assets (Codex CLI)...`);
+        const cmdPreview = `codex exec "${promptPreview.replace(/"/g, '\\"')}" -s read-only --skip-git-repo-check < /dev/null`;
+        try {
+            log(`${C.gray}$ ${cmdPreview}${C.reset}`);
+            const outPreview = execSync(cmdPreview, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+            log(outPreview);
+            ok(`Đã sinh UI Demo Preview tại assets/ui/demo_preview.html`);
+        } catch (e) {
+            err(`Lỗi sinh UI Demo Preview: ${e.message}`);
+            process.exit(1);
+        }
 
-    // Step B: Prompt to generate spritesheet/image assets
-    const promptAssets = `Tạo GUI assets (nút bấm, icons, pet companion, egg) dưới dạng spritesheet hoặc dạng assets lẻ dựa trên thiết kế của UI Demo Preview. Lưu tệp assets vào thư mục assets/ui/.`;
-    const cmdAssets = `codex exec "${promptAssets.replace(/"/g, '\\"')}" --sandbox read-only < /dev/null`;
+        // Step B: Prompt to generate spritesheet/image assets
+        const promptAssets = `Tạo GUI assets (nút bấm, icons, pet companion, egg) dưới dạng spritesheet hoặc dạng assets lẻ dựa trên thiết kế của UI Demo Preview. Lưu tệp assets vào thư mục assets/ui/.`;
+        const cmdAssets = `codex exec "${promptAssets.replace(/"/g, '\\"')}" -s read-only --skip-git-repo-check < /dev/null`;
+        try {
+            log(`${C.gray}$ ${cmdAssets}${C.reset}`);
+            const outAssets = execSync(cmdAssets, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+            log(outAssets);
+            ok(`Đã sinh GUI assets thành công vào assets/ui/`);
+        } catch (e) {
+            err(`Lỗi sinh GUI assets: ${e.message}`);
+            process.exit(1);
+        }
+    } else {
+        info(`Codex CLI is disabled or not available. Falling back to agy (Gemini)...`);
+        const agyBin = findAgy();
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const outPreview = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', promptPreview
+            ], { encoding: 'utf8', timeout: 60000 });
 
-    try {
-        log(`${C.gray}$ ${cmdAssets}${C.reset}`);
-        const outAssets = execSync(cmdAssets, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
-        log(outAssets);
-        ok(`Đã sinh GUI assets thành công vào assets/ui/`);
-    } catch (e) {
-        err(`Lỗi sinh GUI assets: ${e.message}`);
-        process.exit(1);
+            if (outPreview.status === 0) {
+                let code = outPreview.stdout;
+                const match = code.match(/```html\s*([\s\S]*?)```/i) || code.match(/```xml\s*([\s\S]*?)```/i);
+                if (match) {
+                    code = match[1];
+                }
+                fs.writeFileSync(path.join(process.cwd(), 'assets', 'ui', 'demo_preview.html'), code, 'utf8');
+                ok(`Đã sinh UI Demo Preview tại assets/ui/demo_preview.html`);
+            } else {
+                err(`Gemini UI Design failed: ${outPreview.stderr || outPreview.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi sinh UI Demo Preview qua Gemini: ${e.message}`);
+            process.exit(1);
+        }
     }
+    
+    playAudioAlert("Thiết kế giao diện đã hoàn thành");
 }
 
 function runCodeStep(featureName) {
-    const agyBin = findAgy();
-    info(`Khởi chạy Thực thi Viết Code (Gemini via agy CLI)...`);
+    const isCostOptimized = config.automation?.multiAgent?.routingMode === 'cost-optimized';
 
-    const promptCode = `Hãy thực hiện viết code cho tính năng '${featureName}' tuân thủ kế hoạch chi tiết trong implementation_plan.md và các spec giao diện trong docs/specs/. Sau đó tự động gọi critic subagent để review code.`;
-    const cmdCode = `"${agyBin}" --model gemini-2.5-flash --print "${promptCode.replace(/"/g, '\\"')}" < /dev/null`;
+    if (isCostOptimized && isRunnerAvailable('qwen')) {
+        info(`Khởi chạy Thực thi Viết Code (Qwen Coder CLI)...`);
+        const promptCode = `Hãy thực hiện viết code cho tính năng '${featureName}' tuân thủ kế hoạch chi tiết trong implementation_plan.md và các spec giao diện trong docs/specs/. Sau đó tự động gọi critic subagent để review code.`;
+        
+        try {
+            const qwenScript = path.join(__dirname, 'qwen-exec.js');
+            log(`$ node ${qwenScript} --prompt "..."`);
+            const result = spawnSync('node', [
+                qwenScript,
+                '--prompt', promptCode
+            ], { encoding: 'utf8', timeout: 180000 });
 
-    try {
-        log(`${C.gray}$ ${cmdCode}${C.reset}`);
-        const output = execSync(cmdCode, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
-        log(output);
-        ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
-    } catch (e) {
-        err(`Lỗi thực thi viết code: ${e.message}`);
-        process.exit(1);
+            if (result.status === 0) {
+                log(result.stdout);
+                ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
+            } else {
+                err(`Lỗi thực thi viết code Qwen: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi thực thi viết code Qwen: ${e.message}`);
+            process.exit(1);
+        }
+    } else {
+        const agyBin = findAgy();
+        if (isCostOptimized && !isRunnerAvailable('qwen')) {
+            info(`Qwen Coder CLI is disabled or not available. Falling back to agy (Gemini)...`);
+        }
+        info(`Khởi chạy Thực thi Viết Code (Gemini via agy CLI)...`);
+        const promptCode = `Hãy thực hiện viết code cho tính năng '${featureName}' tuân thủ kế hoạch chi tiết trong implementation_plan.md và các spec giao diện trong docs/specs/. Sau đó tự động gọi critic subagent để review code.`;
+
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const result = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', promptCode
+            ], { encoding: 'utf8', timeout: 180000 });
+
+            if (result.status === 0) {
+                log(result.stdout);
+                ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
+            } else {
+                err(`Lỗi thực thi viết code: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi thực thi viết code: ${e.message}`);
+            process.exit(1);
+        }
     }
+    
+    playAudioAlert("Viết mã nguồn đã hoàn thành");
 }
 
 function cmdPipeline(args) {

package/scripts/qwen-exec.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+/**
+ * Wrapper script to run Qwen CLI non-interactively within AWKit.
+ * Handles temporary files, sandbox options, and fallback protocols.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const args = process.argv.slice(2);
+let prompt = '';
+let promptFile = '';
+let outputFile = '';
+let sandbox = 'read-only';
+
+for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--prompt' && args[i + 1]) {
+        prompt = args[i + 1];
+        i++;
+    } else if (args[i] === '--prompt-file' && args[i + 1]) {
+        promptFile = args[i + 1];
+        i++;
+    } else if (args[i] === '--output' && args[i + 1]) {
+        outputFile = args[i + 1];
+        i++;
+    } else if (args[i] === '--sandbox' && args[i + 1]) {
+        sandbox = args[i + 1];
+        i++;
+    }
+}
+
+// Read prompt from file if specified
+if (promptFile && fs.existsSync(promptFile)) {
+    prompt = fs.readFileSync(promptFile, 'utf8');
+}
+
+if (!prompt) {
+    console.error('Error: Prompt is required. Use --prompt or --prompt-file');
+    process.exit(1);
+}
+
+// Load configurations from .project-identity
+let routingMode = 'cost-optimized';
+let config = {};
+
+try {
+    const identityPath = path.join(__dirname, '..', '.project-identity');
+    if (fs.existsSync(identityPath)) {
+        config = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+        if (config.automation?.multiAgent?.routingMode) {
+            routingMode = config.automation.multiAgent.routingMode;
+        }
+    }
+} catch (e) {
+    console.warn('⚠️ Could not load config from .project-identity, using defaults.');
+}
+
+// Dynamic Qwen CLI Path Detection
+function findQwenPath() {
+    // 1. Check config path
+    if (config.automation?.multiAgent?.runners?.qwen) {
+        const p = config.automation.multiAgent.runners.qwen;
+        if (fs.existsSync(p)) return p;
+    }
+    // 2. Try interactive shell which (resolves aliases/nvm)
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which qwen"' : 'bash -lc "which qwen"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    // 3. Basic command check
+    try {
+        const detected = execSync('which qwen || command -v qwen', { encoding: 'utf8' }).trim();
+        if (detected) return detected;
+    } catch (_) {}
+
+    return 'qwen';
+}
+
+const qwenPath = findQwenPath();
+
+// Verify Qwen CLI existence
+let qwenAvailable = false;
+try {
+    execSync(`[ -f "${qwenPath}" ] || command -v qwen`, { stdio: 'ignore' });
+    qwenAvailable = true;
+} catch (e) {
+    console.warn(`⚠️ Qwen CLI not found at ${qwenPath}`);
+}
+
+// Temporary file to pipe inputs securely
+const tempInputFile = path.join(__dirname, `temp_qwen_input_${Date.now()}.txt`);
+fs.writeFileSync(tempInputFile, prompt, 'utf8');
+
+let success = false;
+let finalOutput = '';
+
+if (qwenAvailable) {
+    console.log('🤖 Running code generation via Qwen CLI...');
+    try {
+        const cmd = `"${qwenPath}" --max-session-turns 1 -s ${sandbox} < "${tempInputFile}"`;
+        finalOutput = execSync(cmd, { encoding: 'utf8', timeout: 120000 });
+        success = true;
+    } catch (e) {
+        console.warn('⚠️ Qwen execution failed. Fallback triggered.');
+        console.error(e.message);
+    }
+}
+
+// Fallback to Gemini CLI (agy) if Qwen failed or unavailable
+if (!success) {
+    console.log('📡 Falling back to Gemini CLI (agy)...');
+    try {
+        const agyBin = 'agy';
+        const cmd = `"${agyBin}" --model gemini-3.5-flash --print "${prompt.replace(/"/g, '\\"')}" < /dev/null`;
+        finalOutput = execSync(cmd, { encoding: 'utf8', timeout: 60000 });
+        success = true;
+    } catch (e) {
+        console.error('❌ Fallback to Gemini CLI also failed:', e.message);
+    }
+}
+
+// Clean up temporary file
+try {
+    if (fs.existsSync(tempInputFile)) {
+        fs.unlinkSync(tempInputFile);
+    }
+} catch (_) {}
+
+// Output results
+if (success) {
+    if (outputFile) {
+        fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+        fs.writeFileSync(outputFile, finalOutput, 'utf8');
+        console.log(`✅ Output written to ${outputFile}`);
+    } else {
+        process.stdout.write(finalOutput);
+    }
+    process.exit(0);
+} else {
+    console.error('❌ Failed to execute code step with both Qwen and fallback Gemini.');
+    process.exit(1);
+}

package/skills/claude-planner/SKILL.md

@@ -45,3 +45,27 @@ When writing `brain/<projectId>/plan_prompt.md`, ensure it contains:
 4. NeuralMemory relevant constraints.
 5. Symphony tasks.
 6. The target format instructions for `implementation_plan.md`.
+
+## ⚙️ Configuration & Control Techniques
+
+### 1. Check Runner Status
+Verify if the Claude planner runner is enabled globally:
+```bash
+awkit config claude
+```
+
+### 2. Enable/Disable Runner
+To temporarily disable Claude planner (forcing fallback to Gemini standard models) or enable it:
+```bash
+awkit config claude off
+awkit config claude on
+```
+
+### 3. Check All Runners
+```bash
+awkit config runners
+```
+
+### 4. Active Routing & Fallback
+If `claude` is disabled or not installed on the system, the pipeline automatically routes Gate 2 architect planning to **Gemini Flash** via `agy` CLI using `gemini-3.5-flash`.
+

package/skills/codex-conductor/SKILL.md

@@ -130,6 +130,30 @@ Parallel:  gemini-conductor (different role, can coexist)
 Independent of: NeuralMemory
 ```
 
+## ⚙️ Configuration & Control Techniques
+
+### 1. Check Runner Status
+Verify if the Codex runner is enabled globally:
+```bash
+awkit config codex
+```
+
+### 2. Enable/Disable Runner
+To temporarily disable Codex runner (forcing fallback to Gemini standard models) or enable it:
+```bash
+awkit config codex off
+awkit config codex on
+```
+
+### 3. Check All Runners
+```bash
+awkit config runners
+```
+
+### 4. Active Routing & Fallback
+If `codex` is disabled or unavailable on the system, the pipeline automatically routes UI design tasks (Gate 2.5 shell design) to **Gemini Flash** via `agy` CLI using `gemini-3.5-flash` and performs automatic HTML code extraction to save code to `assets/ui/demo_preview.html`.
+
 ---
 
-*codex-conductor v1.1 — Modular Router Architecture*
+*codex-conductor v1.2 — Modular Router Architecture*
+