@leejungkiin/awkit 1.2.0 → 1.3.4

package/bin/awf.js

@@ -275,7 +275,6 @@ function cmdInstall() {
     dim(`Templates:  ${path.join(target, 'templates')}`);
     dim(`GEMINI.md:  ${TARGETS.geminiMd}`);
     log('');
-    log(`${C.cyan}👉 Type '/plan' in your AI chat to get started.${C.reset}`);
     log(`${C.cyan}👉 Run 'awf doctor' to verify installation.${C.reset}`);
     log('');
 }

package/bin/awk.js

@@ -28,7 +28,8 @@ const path = require('path');
 const https = require('https');
 const { execSync, spawnSync } = require('child_process');
 
-const AWK_VERSION = fs.readFileSync(path.join(__dirname, '..', 'VERSION'), 'utf8').trim();
+const packageJson = require(path.join(__dirname, '..', 'package.json'));
+const AWK_VERSION = packageJson.version;
 const AWK_ROOT = path.join(__dirname, '..');
 const HOME = process.env.HOME || process.env.USERPROFILE;
 
@@ -454,10 +455,7 @@ function cmdInstall(platformArg) {
     log('');
 
     if (platform === 'antigravity') {
-        log(`${C.cyan}👉 Type '/plan' in your AI chat to get started.${C.reset}`);
         log(`${C.cyan}👉 Run 'awkit init' in any project to initialize it.${C.reset}`);
-    } else if (platform === 'cline') {
-        log(`${C.cyan}👉 Type '/plan' in Cline chat to get started.${C.reset}`);
     } else if (platform === 'codex') {
         log(`${C.cyan}👉 Type '$skill' in Codex to invoke skills.${C.reset}`);
     }
@@ -1371,6 +1369,18 @@ function cmdHelp() {
     log(`  ${C.green}disable-pack${C.reset} <name> Uninstall a skill pack (backed up)`);
     log('');
 
+    // Trello
+    log(`${C.bold}📋  Trello${C.reset}`);
+    log(line);
+    log(`  ${C.green}trello desc${C.reset} <text>       Update card description`);
+    log(`  ${C.green}trello comment${C.reset} <text>    Add milestone comment`);
+    log(`  ${C.green}trello item${C.reset} <name>       Add checklist item`);
+    log(`  ${C.green}trello complete${C.reset} <name>   Mark checklist item ✅`);
+    log(`  ${C.green}trello block${C.reset} <reason>    Label card Blocked + comment`);
+    log(`  ${C.green}trello checklist${C.reset} <name>  Create new checklist`);
+    log(`  ${C.gray}  Auto-loads .trello-config.json + global credentials${C.reset}`);
+    log('');
+
     // Telegram
     log(`${C.bold}📨  Telegram${C.reset}`);
     log(line);
@@ -1719,7 +1729,7 @@ function buildCodebaseMd(projectName, projectType, identity) {
  *   CODEBASE.md
  *   .symphony/ (via Symphony)
  */
-function cmdInit(forceFlag = false) {
+async function cmdInit(forceFlag = false) {
     const cwd = process.cwd();
     const dirName = path.basename(cwd);
     // Convert dir name to PascalCase project name: my-app → MyApp, fitbite → Fitbite
@@ -1773,6 +1783,75 @@ function cmdInit(forceFlag = false) {
         ok(`${workspaceName} created`);
     }
 
+    // ── 3.5. .trello-config.json ───────────────────────────────────────────────
+    const trelloConfigPath = path.join(cwd, '.trello-config.json');
+    if (fs.existsSync(trelloConfigPath) && !forceFlag) {
+        warn('.trello-config.json already exists — skipping (use --force to overwrite)');
+    } else {
+        info('Creating .trello-config.json...');
+        const templatePath = path.join(TARGETS.antigravity, 'templates', 'configs', 'trello-config.json');
+        if (fs.existsSync(templatePath)) {
+            fs.copyFileSync(templatePath, trelloConfigPath);
+            ok('.trello-config.json created from template');
+        } else {
+            const defaultTrelloConfig = {
+                "BOARD_NAME": "Your Board Name",
+                "LIST_NAME": "Your Backlog List",
+                "CARD_NAME": "Project Card Name or ID"
+            };
+            fs.writeFileSync(trelloConfigPath, JSON.stringify(defaultTrelloConfig, null, 2) + '\n');
+            ok('.trello-config.json created with default values');
+        }
+    }
+
+    const trelloCred = trelloLoadCredentials();
+    if (!trelloCred) {
+        log('');
+        warn('Trello API Key & Token are not set.');
+        log(`  👉 To setup Trello integration, please get your credentials at: https://trello.com/app-key`);
+        
+        const readline = require('readline');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+
+        const question = (query) => new Promise(resolve => rl.question(query, resolve));
+
+        try {
+            const apiKey = (await question(`  ${C.yellow}Enter Trello API Key: ${C.reset}`)).trim();
+
+            if (apiKey) {
+                const tokenUrl = `https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=${apiKey}&name=AWKit`;
+                log('');
+                log(`  ${C.cyan}👉 Open this link to generate your Token:${C.reset}`);
+                log(`     ${C.green}${tokenUrl}${C.reset}`);
+                log('');
+            }
+
+            const apiToken = (await question(`  ${C.yellow}Enter Trello API Token: ${C.reset}`)).trim();
+
+            if (apiKey && apiToken) {
+                let profilePath = path.join(os.homedir(), '.zshrc');
+                if (!fs.existsSync(profilePath) && fs.existsSync(path.join(os.homedir(), '.bashrc'))) {
+                    profilePath = path.join(os.homedir(), '.bashrc');
+                }
+                
+                const exportLines = `\n# Trello API Credentials for AWKit\nexport TRELLO_KEY="${apiKey}"\nexport TRELLO_TOKEN="${apiToken}"\n`;
+                fs.appendFileSync(profilePath, exportLines);
+                
+                ok(`Credentials saved to ${profilePath}`);
+                log(`  ${C.cyan}👉 Please run 'source ~/${path.basename(profilePath)}' or restart your terminal to apply them.${C.reset}`);
+            } else {
+                warn('Setup skipped. Automated Trello sync will be disabled.');
+            }
+        } catch (e) {
+            warn('Failed to setup Trello interactively.');
+        } finally {
+            rl.close();
+        }
+    }
+
     // ── 4. CODEBASE.md ────────────────────────────────────────────────────────
     const codebasePath = path.join(cwd, 'CODEBASE.md');
     if (fs.existsSync(codebasePath) && !forceFlag) {
@@ -1808,7 +1887,7 @@ function cmdInit(forceFlag = false) {
     log('');
     dim(`Type:       ${projectType}`);
     dim(`Firebase:   analytics, crashlytics, remote-config, auth`);
-    dim(`Files:      .project-identity, ${workspaceName}, CODEBASE.md`);
+    dim(`Files:      .project-identity, ${workspaceName}, CODEBASE.md, .trello-config.json`);
     dim(`Symphony:     task tracking ready)`);
     log('');
     log(`${C.cyan}👉 Open ${workspaceName} in VS Code to get started.${C.reset}`);
@@ -2011,6 +2090,163 @@ function cmdTelegram(args) {
     }
 }
 
+// ─── Trello Integration ───────────────────────────────────────────────────────
+
+/**
+ * Load Trello credentials from environment variables.
+ * Returns { api_key, api_token } or null.
+ */
+function trelloLoadCredentials() {
+    if (process.env.TRELLO_KEY && process.env.TRELLO_TOKEN) {
+        return { api_key: process.env.TRELLO_KEY, api_token: process.env.TRELLO_TOKEN };
+    }
+    return null;
+}
+
+/**
+ * Load Trello project config from .trello-config.json in CWD.
+ * Returns { board, list, card } or null.
+ */
+function trelloLoadProjectConfig() {
+    const configPath = path.join(process.cwd(), '.trello-config.json');
+    if (!fs.existsSync(configPath)) return null;
+    try {
+        const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        return {
+            board: cfg.BOARD_NAME || cfg.board,
+            list: cfg.LIST_NAME || cfg.list,
+            card: cfg.CARD_NAME || cfg.card,
+        };
+    } catch (_) {
+        return null;
+    }
+}
+
+/**
+ * Execute a trello-cli command with auto-injected credentials and rate-limit retries.
+ */
+function trelloExec(cliArgs, retries = 3) {
+    const cred = trelloLoadCredentials();
+    const cfg = trelloLoadProjectConfig();
+    if (!cred) {
+        err('Trello credentials not found.');
+        log(`  Please export ${C.cyan}TRELLO_KEY${C.reset} and ${C.cyan}TRELLO_TOKEN${C.reset} in your ~/.zshrc`);
+        return false;
+    }
+    if (!cfg) {
+        err('.trello-config.json not found in current directory.');
+        log(`  Run ${C.cyan}awkit init${C.reset} to generate one, or create it manually.`);
+        return false;
+    }
+
+    const env = { ...process.env, TRELLO_KEY: cred.api_key, TRELLO_TOKEN: cred.api_token };
+    const fullArgs = [...cliArgs, '--board', cfg.board, '--list', cfg.list, '--card', cfg.card];
+
+    for (let attempt = 1; attempt <= retries; attempt++) {
+        const result = spawnSync('npx', ['--yes', 'trello-cli', ...fullArgs], {
+            env,
+            encoding: 'utf-8',
+            timeout: 30000,
+        });
+
+        const stdoutStr = result.stdout || '';
+        const stderrStr = result.stderr || '';
+        const combinedOut = stdoutStr + stderrStr;
+
+        if (stdoutStr) process.stdout.write(stdoutStr);
+        if (stderrStr) process.stderr.write(stderrStr);
+
+        if (result.status === 0) {
+            return true;
+        }
+
+        if (combinedOut.includes('429') || combinedOut.includes('Rate limit exceeded') || combinedOut.includes('Too Many Requests') || combinedOut.includes('API_TOKEN_LIMIT_EXCEEDED') || combinedOut.includes('API_KEY_LIMIT_EXCEEDED')) {
+            warn(`[Trello API] Rate limit hit (429). Waiting 10s before retry ${attempt}/${retries}...`);
+            // Sleep for 10 seconds to satisfy the 100 requests / 10s window boundary
+            spawnSync('sleep', ['10']);
+            continue;
+        }
+
+        warn(`Trello CLI returned non-zero exit code (${result.status}). Command: awkit trello ${cliArgs.join(' ')}`);
+        return false;
+    }
+    err('Trello CLI failed after multiple retries due to rate limits.');
+    return false;
+}
+
+function trelloHelp() {
+    log('');
+    log(`${C.cyan}${C.bold}📋 Trello Commands${C.reset}`);
+    log('');
+    log(`  ${C.green}awkit trello desc${C.reset} <text>        Update card description`);
+    log(`  ${C.green}awkit trello comment${C.reset} <text>     Add milestone comment to card`);
+    log(`  ${C.green}awkit trello item${C.reset} <name>        Add checklist item (incomplete)`);
+    log(`  ${C.green}awkit trello complete${C.reset} <name>    Mark checklist item ✅ complete`);
+    log(`  ${C.green}awkit trello block${C.reset} <reason>     Label card Blocked + comment`);
+    log(`  ${C.green}awkit trello checklist${C.reset} <name>   Create a new checklist on card`);
+    log('');
+    log(`  ${C.gray}Credentials: env vars TRELLO_KEY and TRELLO_TOKEN${C.reset}`);
+    log(`  ${C.gray}Project config: .trello-config.json in CWD${C.reset}`);
+    log('');
+}
+
+function cmdTrello(args) {
+    const subCmd = args[0];
+    const text = args.slice(1).join(' ');
+
+    if (!subCmd || subCmd === 'help') {
+        trelloHelp();
+        return;
+    }
+
+    if (!text && subCmd !== 'help') {
+        err(`Missing argument for 'trello ${subCmd}'. Usage: awkit trello ${subCmd} <text>`);
+        return;
+    }
+
+    switch (subCmd) {
+        case 'desc':
+            info(`Updating card description...`);
+            trelloExec(['card:update', '--desc', text]);
+            break;
+
+        case 'comment':
+            info(`Adding comment to card...`);
+            trelloExec(['card:comment', '--text', text]);
+            break;
+
+        case 'item':
+            // trello-cli doesn't support adding checklist items natively.
+            // We fall back to marking an item incomplete (which implicitly creates it in some versions)
+            // or inform the user to use the REST API.
+            info(`Adding checklist item: ${text}`);
+            warn('Note: trello-cli may not support adding items. Use REST API if this fails.');
+            trelloExec(['card:check-item', '--item', text, '--state', 'incomplete']);
+            break;
+
+        case 'complete':
+            info(`Marking item complete: ${text}`);
+            trelloExec(['card:check-item', '--item', text, '--state', 'complete']);
+            break;
+
+        case 'block':
+            info(`Blocking card with reason...`);
+            trelloExec(['card:label', '--label', 'Blocked']);
+            trelloExec(['card:comment', '--text', `⚠️ BLOCKED: ${text}`]);
+            break;
+
+        case 'checklist':
+            info(`Creating checklist: ${text}`);
+            trelloExec(['card:checklist', '-n', text]);
+            break;
+
+        default:
+            err(`Unknown trello subcommand: ${subCmd}`);
+            trelloHelp();
+            break;
+    }
+}
+
 // ─── Auto-Update Checker ──────────────────────────────────────────────────────
 
 function checkAutoUpdate() {
@@ -2056,66 +2292,71 @@ checkAutoUpdate();
 
 const [, , command, ...args] = process.argv;
 
-switch (command) {
-    case 'init':
-        cmdInit(args.includes('--force'));
-        break;
-    case 'install':
-        // Parse platform from either first arg or --platform flag
-        {
-            const pIdx = args.indexOf('--platform');
-            let platformArg = null;
-            if (pIdx !== -1 && args[pIdx + 1]) {
-                platformArg = args[pIdx + 1];
-            } else if (args[0] && !args[0].startsWith('-')) {
-                platformArg = args[0];
+(async () => {
+    switch (command) {
+        case 'init':
+            await cmdInit(args.includes('--force'));
+            break;
+        case 'install':
+            // Parse platform from either first arg or --platform flag
+            {
+                const pIdx = args.indexOf('--platform');
+                let platformArg = null;
+                if (pIdx !== -1 && args[pIdx + 1]) {
+                    platformArg = args[pIdx + 1];
+                } else if (args[0] && !args[0].startsWith('-')) {
+                    platformArg = args[0];
+                }
+                cmdInstall(platformArg);
             }
-            cmdInstall(platformArg);
-        }
-        break;
-    case 'uninstall':
-        cmdUninstall();
-        break;
-    case 'update':
-        cmdUpdate();
-        break;
-    case 'sync':
-        cmdSync();
-        break;
-    case 'status':
-        cmdStatus();
-        break;
-    case 'harvest':
-        cmdHarvest(args.includes('--dry-run'));
-        break;
-    case 'doctor':
-        cmdDoctor();
-        break;
-    case 'enable-pack':
-        cmdEnablePack(args[0]);
-        break;
-    case 'disable-pack':
-        cmdDisablePack(args[0]);
-        break;
-    case 'list-packs':
-        cmdListPacks();
-        break;
-    case 'version':
-    case '--version':
-    case '-v':
-        cmdVersion();
-        break;
-    case 'lint':
-        cmdLint();
-        break;
-    case 'tg':
-    case 'telegram':
-        cmdTelegram(args);
-        break;
-    case 'help':
-    case '--help':
-    case '-h':
-    default:
-        cmdHelp();
-        break;
-}
+            break;
+        case 'uninstall':
+            cmdUninstall();
+            break;
+        case 'update':
+            cmdUpdate();
+            break;
+        case 'sync':
+            cmdSync();
+            break;
+        case 'status':
+            cmdStatus();
+            break;
+        case 'harvest':
+            cmdHarvest(args.includes('--dry-run'));
+            break;
+        case 'doctor':
+            cmdDoctor();
+            break;
+        case 'enable-pack':
+            cmdEnablePack(args[0]);
+            break;
+        case 'disable-pack':
+            cmdDisablePack(args[0]);
+            break;
+        case 'list-packs':
+            cmdListPacks();
+            break;
+        case 'version':
+        case '--version':
+        case '-v':
+            cmdVersion();
+            break;
+        case 'lint':
+            cmdLint();
+            break;
+        case 'trello':
+            cmdTrello(args);
+            break;
+        case 'tg':
+        case 'telegram':
+            cmdTelegram(args);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+        default:
+            cmdHelp();
+            break;
+    }
+})();

package/core/GEMINI.md

@@ -50,19 +50,22 @@ Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 - AI models: Gemini 2.5+ only.
 - Firebase: Firebase AI Logic SDK.
 
-### 5-Gate Autonomous System (NEW v12.0)
+### 6-Gate Autonomous System (v12.1)
 - orchestrator PHẢI triage complexity (TRIVIAL/MODERATE/COMPLEX) trước mọi task.
-- COMPLEX tasks PHẢI qua 5 Gates tuần tự:
+- COMPLEX tasks PHẢI qua 6 Gates tuần tự:
   - Gate 1 (Spec): `brainstorm-agent` → BRIEF.md / spec document
+  - Gate 1.5 (Module Spec): `module-spec-writer` → per-module product specs (screens, flows, rules)
   - Gate 2 (Architecture): `spec-gate` → design doc + user approve
   - Gate 3 (Tasks): `symphony-enforcer` → tạo Symphony tickets
   - Gate 4 (Execution): code theo ticket, đối chiếu design doc
   - Gate 5 (Verification): `verification-gate` + `code-review`
+- Gate 1.5 MANDATORY khi: COMPLEX + >3 modules hoặc port/migration projects.
+- Gate 1.5 SKIP khi: TRIVIAL/MODERATE hoặc single-module projects.
 - TRIVIAL tasks bypass → thẳng Gate 4.
 - MODERATE tasks → Gate 3 + 4 + 5.
 - AI tự detect gate state — user KHÔNG CẦN gọi workflow bằng tay.
 - Trong lúc code, nếu cần sửa schema khác approved design → ⛔ DỪNG, quay Gate 2.
-- Chi tiết: xem `orchestrator/SKILL.md` (triage) + `spec-gate/SKILL.md` (Gate 2).
+- Chi tiết: xem `orchestrator/SKILL.md` (triage) + `module-spec-writer/SKILL.md` (Gate 1.5) + `spec-gate/SKILL.md` (Gate 2).
 
 ### NeuralMemory
 - Brain = projectId. Switch trước mọi nmem call.
@@ -109,6 +112,16 @@ Khi AI cần tự quyết định mà không hỏi user:
 - KHÔNG hỏi user về project structure.
 - CODEBASE.md outdated → ghi chú "⚠️ dùng /codebase-sync".
 
+### GitNexus (Code Intelligence)
+- Project đã index (`.gitnexus/` tồn tại) → PHẢI dùng GitNexus tools.
+- Trước khi edit symbol → `gitnexus_impact` check blast radius.
+- Trước khi commit → `gitnexus_detect_changes()` verify scope.
+- Risk HIGH/CRITICAL → PHẢI cảnh báo user trước khi sửa.
+- Explore code lạ → ưu tiên `gitnexus_query` thay vì grep thủ công.
+- Rename symbol → PHẢI dùng `gitnexus_rename` (dry_run trước).
+- Index stale → cảnh báo "⚠️ chạy `npx gitnexus analyze`".
+- Chi tiết: xem `gitnexus-intelligence/SKILL.md`.
+
 ### Two-Agent Flow (Conductor)
 - Antigravity CHỦ ĐỘNG gọi `gemini -p "..." --approval-mode plan` khi cần tầm nhìn rộng.
 - CLI dùng **quota pool riêng** → không ảnh hưởng Antigravity quota.
@@ -123,9 +136,10 @@ Khi AI cần tự quyết định mà không hỏi user:
 ## Routing
 
 - **Execution order:** `symphony-orchestrator` → `awf-session-restore` → `nm-memory-sync` → `symphony-enforcer` → `orchestrator` (triage + gate-check) → action
-- **Gate skills:** `orchestrator` (triage) → `brainstorm-agent` (G1) → `spec-gate` (G2) → `symphony-enforcer` (G3) → `verification-gate` (G5)
+- **Gate skills:** `orchestrator` (triage) → `brainstorm-agent` (G1) → `module-spec-writer` (G1.5) → `spec-gate` (G2) → `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`
+- **Workflows:** 75+ (`/xxx`). Core: `/init` `/code` `/debug` `/recap` `/next` `/todo` `/gitnexus`
 - **Shortcuts:** `/todo` `/done` `/next`
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.2.0",
+  "version": "1.3.4",
   "description": "Antigravity Workflow Kit. Unified AI agent orchestration system.",
   "main": "bin/awk.js",
   "bin": {
@@ -34,11 +34,10 @@
     "templates/",
     "docs/",
     "README.md",
-    "CHANGELOG.md",
-    "VERSION"
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "@leejungkiin/awkit-symphony": "^0.1.0",
     "@leejungkiin/gitnexus": "file:../gitnexus/gitnexus"
   }
-}
+}

package/skills/CATALOG.md

@@ -31,6 +31,10 @@
 | 11 | `awf-context-help` | `auto` | `/help`, stuck | — | — | ✅ Active |
 | 12 | `auto-save` | `auto` | Session end | — | — | ✅ Background |
 | 13 | `awf-version-tracker` | `auto` | Skill changes | — | — | ✅ Background |
+| 14 | `module-spec-writer` | `auto` | Gate 1.5 check fail | 1.5 | 1.0.0 | ✅ Active |
+| 15 | `spec-gate` | `auto` | Gate 2 check fail | 2 | 1.0.0 | ✅ Active |
+| 16 | `visual-design-gate` | `auto` | Gate 2.5 check fail | 2.5 | 1.0.0 | ✅ Active |
+| 17 | `trello-sync` | `auto` | Always | 2 | 3.0.0 | ✅ Active |
 
 ---