@leejungkiin/awkit 1.3.8 → 1.4.0

package/bin/awk.js

@@ -290,35 +290,87 @@ function checkSymphony({ silent = false } = {}) {
     }
 }
 
-function cmdInstall(platformArg) {
+function cmdInstall(args = []) {
     log('');
     log(`${C.cyan}${C.bold}╔══════════════════════════════════════════════════════════╗${C.reset}`);
     log(`${C.cyan}${C.bold}║     🚀 AWK v${AWK_VERSION} — Antigravity Workflow Kit        ║${C.reset}`);
     log(`${C.cyan}${C.bold}╚══════════════════════════════════════════════════════════╝${C.reset}`);
     log('');
 
-    // Platform selection
-    let platform = platformArg || getActivePlatform();
+    const isUpdate = args.includes('--update');
+    let selectedPlatforms = [];
 
-    if (!PLATFORMS[platform]) {
-        err(`Unknown platform: ${platform}.`);
-        return;
+    if (args.includes('--all') || args.includes('-a') || args.includes('all')) {
+        selectedPlatforms = Object.keys(PLATFORMS);
+    } else {
+        if (args.includes('--gemini') || args.includes('-g') || args.includes('antigravity')) selectedPlatforms.push('antigravity');
+        if (args.includes('--claude') || args.includes('-c') || args.includes('cline')) selectedPlatforms.push('cline');
+        if (args.includes('--codex') || args.includes('-x')) selectedPlatforms.push('codex');
+
+        const pIdx = args.indexOf('--platform');
+        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') {
+            legacyArg = args[0];
+        }
+        
+        if (legacyArg && PLATFORMS[legacyArg] && !selectedPlatforms.includes(legacyArg)) {
+            selectedPlatforms.push(legacyArg);
+        }
+    }
+
+    if (selectedPlatforms.length === 0) {
+        if (isUpdate) {
+            selectedPlatforms = [getActivePlatform()];
+        } else {
+            log(`${C.cyan}Select platforms to install (e.g., type "1,2", "all", or "1,2,3"):${C.reset}`);
+            log(`  1. Gemini Code Assist (antigravity)`);
+            log(`  2. Claude Code (cline - local project)`);
+            log(`  3. Codex CLI (codex)`);
+            log(`  4. All of the above`);
+            const choice = promptChoice('Choice', '4').trim().toLowerCase();
+            
+            if (choice === '4' || choice === 'all' || choice === '') {
+                selectedPlatforms = Object.keys(PLATFORMS);
+            } else {
+                if (choice.includes('1')) selectedPlatforms.push('antigravity');
+                if (choice.includes('2')) selectedPlatforms.push('cline');
+                if (choice.includes('3')) selectedPlatforms.push('codex');
+            }
+        }
     }
 
-    activePlatform = platform;
-    savePlatform(platform);
+    if (selectedPlatforms.length === 0) {
+        selectedPlatforms = [getActivePlatform()];
+    }
 
-    const plat = PLATFORMS[platform];
-    const target = plat.globalRoot;
+    log(`${C.cyan}Installing to: ${selectedPlatforms.map(p => PLATFORMS[p].name).join(', ')}${C.reset}`);
 
-    info(`Installing for ${C.bold}${plat.name}${C.reset}...`);
-    log('');
+    // Main installation loop
+    for (const platform of selectedPlatforms) {
+        if (!PLATFORMS[platform]) {
+            err(`Unknown platform: ${platform}.`);
+            continue;
+        }
 
-    // 0. Check Symphony dependency
-    info('Checking dependencies...');
-    checkSymphony();
+        activePlatform = platform;
+        if (platform === selectedPlatforms[0]) {
+            savePlatform(platform); // Store primary platform
+        }
+
+        const plat = PLATFORMS[platform];
+        const target = plat.globalRoot;
+
+        log('');
+        info(`Installing for ${C.bold}${plat.name}${C.reset}...`);
+        log('');
+
+        // 0. Check Symphony dependency
+        info('Checking dependencies...');
+        checkSymphony({ silent: platform !== selectedPlatforms[0] });
 
-    // 1. Ensure target dirs exist
+        // 1. Ensure target dirs exist
     info('Creating directories...');
     const dirKeys = Object.values(plat.dirs);
     for (const dir of dirKeys) {
@@ -462,6 +514,7 @@ function cmdInstall(platformArg) {
     }
     log(`${C.cyan}👉 Run 'awkit doctor' to verify installation.${C.reset}`);
     log('');
+    } // End of platform loop
 }
 
 /**
@@ -570,7 +623,7 @@ function cmdUpdate() {
         }
         log('');
         info('Applying new workflows, skills & schemas...');
-        cmdInstall();
+        cmdInstall(['--update']);
         return;
     }
 
@@ -579,7 +632,7 @@ function cmdUpdate() {
         ok(`Already on latest version (v${AWK_VERSION}) — could not verify with npm`);
     } else {
         info(`Upgrading from v${installedVersion} → v${AWK_VERSION} (local only, npm unreachable)`);
-        cmdInstall();
+        cmdInstall(['--update']);
     }
 }
 
@@ -1327,6 +1380,46 @@ function cmdSync() {
     log('');
 }
 
+async function cmdAdmin() {
+    info('Mở Symphony Dashboard...');
+    try {
+        const http = require('http');
+        const isRunning = await new Promise((resolve) => {
+            const req = http.get('http://localhost:3100', (res) => {
+                resolve(true);
+            }).on('error', () => {
+                resolve(false);
+            });
+            req.setTimeout(1000, () => {
+                req.destroy();
+                resolve(false);
+            });
+        });
+
+        if (!isRunning) {
+            info('Symphony service chưa chạy. Đang khởi động ngầm...');
+            const { spawn } = require('child_process');
+            const child = spawn('symphony', ['start'], {
+                detached: true,
+                stdio: 'ignore'
+            });
+            child.unref();
+            
+            info('Vui lòng đợi 3 giây để service khởi động...');
+            await new Promise(r => setTimeout(r, 3000));
+        }
+
+        try {
+            execSync('symphony dashboard', { stdio: 'inherit' });
+        } catch (_) {
+            err('Không thể mở Symphony Dashboard.');
+        }
+    } catch (e) {
+        err('Không thể khởi động Symphony Dashboard.');
+        dim('Vui lòng cài đặt: npm install -g @leejungkiin/awkit-symphony');
+    }
+}
+
 function cmdHelp() {
     const line = `${C.gray}${'─'.repeat(56)}${C.reset}`;
     log('');
@@ -1362,6 +1455,12 @@ function cmdHelp() {
     log(`  ${C.green}sync${C.reset}                Full sync: harvest + install (one shot)`);
     log('');
 
+    // Symphony
+    log(`${C.bold}🎶  Symphony${C.reset}`);
+    log(line);
+    log(`  ${C.green}admin${C.reset}               Khởi động Symphony Dashboard`);
+    log('');
+
     // Packs
     log(`${C.bold}📦  Skill Packs${C.reset}`);
     log(line);
@@ -1604,7 +1703,12 @@ function buildProjectIdentity(projectName, projectType, cwd, date) {
     };
 
     return {
+        _comments: {
+            projectId: 'Auto-generated. DO NOT change — used by Symphony for task scoping.',
+            trello: 'Fill in your Trello board/list/card names. Run "awkit trello info" to verify.',
+        },
         projectName,
+        projectId: bundleBase,
         projectType: cfg.projectType,
         ...(cfg.bundleIdentifier && { bundleIdentifier: cfg.bundleIdentifier }),
         ...(cfg.packageName && { packageName: cfg.packageName }),
@@ -1616,6 +1720,11 @@ function buildProjectIdentity(projectName, projectType, cwd, date) {
                 features: ['analytics', 'crashlytics', 'remote-config', 'auth'],
             },
         },
+        trello: {
+            board: 'Your Board Name',
+            list: 'Your List Name',
+            card: 'Your Card Name',
+        },
         projectStage: 'development',
         codingStandards: cfg.codingStandards,
         projectGoals: [],
@@ -1784,25 +1893,38 @@ async function cmdInit(forceFlag = false) {
         ok(`${workspaceName} created`);
     }
 
-    // ── 3.5. .trello-config.json ───────────────────────────────────────────────
+    // ── 3.5. Trello config (embedded in .project-identity) ──────────────────────
+    // Migration: If .trello-config.json exists but identity has no trello key, merge it in
     const trelloConfigPath = path.join(cwd, '.trello-config.json');
-    if (fs.existsSync(trelloConfigPath) && !forceFlag) {
-        warn('.trello-config.json already exists — skipping (use --force to overwrite)');
+    if (fs.existsSync(trelloConfigPath)) {
+        try {
+            const oldCfg = JSON.parse(fs.readFileSync(trelloConfigPath, 'utf8'));
+            const currentIdentity = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+            if (!currentIdentity.trello) {
+                currentIdentity.trello = {
+                    board: oldCfg.BOARD_NAME || oldCfg.board || 'Your Board Name',
+                    list: oldCfg.LIST_NAME || oldCfg.list || 'Your List',
+                    card: oldCfg.CARD_NAME || oldCfg.card || 'Your Card',
+                };
+                fs.writeFileSync(identityPath, JSON.stringify(currentIdentity, null, 2) + '\n');
+                ok('Migrated Trello config from .trello-config.json → .project-identity');
+                dim('You can safely delete .trello-config.json now.');
+            }
+        } catch (_) { /* ignore migration errors */ }
     } 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');
-        }
+        // Ensure identity has trello placeholder if not already present
+        try {
+            const currentIdentity = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+            if (!currentIdentity.trello) {
+                currentIdentity.trello = {
+                    board: 'Your Board Name',
+                    list: 'Your List',
+                    card: 'Your Card',
+                };
+                fs.writeFileSync(identityPath, JSON.stringify(currentIdentity, null, 2) + '\n');
+                ok('Added Trello config placeholder to .project-identity');
+            }
+        } catch (_) { /* ignore */ }
     }
 
     const trelloCred = trelloLoadCredentials();
@@ -1894,7 +2016,7 @@ async function cmdInit(forceFlag = false) {
     log('');
     dim(`Type:       ${projectType}`);
     dim(`Firebase:   analytics, crashlytics, remote-config, auth`);
-    dim(`Files:      .project-identity, ${workspaceName}, CODEBASE.md, .trello-config.json`);
+    dim(`Files:      .project-identity, ${workspaceName}, CODEBASE.md`);
     dim(`Symphony:     task tracking ready)`);
     log('');
     log(`${C.cyan}👉 Open ${workspaceName} in VS Code to get started.${C.reset}`);
@@ -2111,10 +2233,28 @@ function trelloLoadCredentials() {
 }
 
 /**
- * Load Trello project config from .trello-config.json in CWD.
+ * Load Trello project config from .project-identity (preferred) or .trello-config.json (fallback).
  * Returns { board, list, card } or null.
  */
 function trelloLoadProjectConfig() {
+    // 1. Try .project-identity → trello key
+    const identityPath = path.join(process.cwd(), '.project-identity');
+    if (fs.existsSync(identityPath)) {
+        try {
+            const identity = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+            if (identity.trello) {
+                const t = identity.trello;
+                const board = t.board || t.BOARD_NAME;
+                const list = t.list || t.LIST_NAME;
+                const card = t.card || t.CARD_NAME;
+                if (board && list && card) {
+                    return { board, list, card };
+                }
+            }
+        } catch (_) { /* ignore parse error */ }
+    }
+
+    // 2. Fallback: .trello-config.json
     const configPath = path.join(process.cwd(), '.trello-config.json');
     if (!fs.existsSync(configPath)) return null;
     try {
@@ -2141,8 +2281,8 @@ function trelloExec(cliArgs, retries = 3) {
         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.`);
+        err('Trello config not found. Add "trello" key to .project-identity or create .trello-config.json.');
+        log(`  Run ${C.cyan}awkit init${C.reset} to set up, or add manually to .project-identity.`);
         return false;
     }
 
@@ -2191,9 +2331,12 @@ function trelloHelp() {
     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(`  ${C.green}awkit trello info${C.reset}                 Show card details`);
+    log(`  ${C.green}awkit trello checklists${C.reset}           List checklists on card`);
+    log(`  ${C.green}awkit trello comments${C.reset}             List comments 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(`  ${C.gray}Project config: "trello" key in .project-identity (fallback: .trello-config.json)${C.reset}`);
     log('');
 }
 
@@ -2206,12 +2349,28 @@ function cmdTrello(args) {
         return;
     }
 
-    if (!text) {
+    const noTextCmds = ['info', 'checklists', 'comments'];
+    if (!text && !noTextCmds.includes(subCmd)) {
         err(`Missing argument for 'trello ${subCmd}'. Usage: awkit trello ${subCmd} <text>`);
         return;
     }
 
     switch (subCmd) {
+        case 'info':
+            info(`Fetching card details...`);
+            trelloExec(['card:show']);
+            break;
+
+        case 'checklists':
+            info(`Fetching card checklists...`);
+            trelloExec(['card:checklists']);
+            break;
+
+        case 'comments':
+            info(`Fetching card comments...`);
+            trelloExec(['card:comments']);
+            break;
+
         case 'desc':
             info(`Updating card description...`);
             trelloExec(['card:update', '--description', text]);
@@ -2344,17 +2503,7 @@ const [, , command, ...args] = process.argv;
             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(args);
             break;
         case 'uninstall':
             cmdUninstall();
@@ -2398,6 +2547,9 @@ const [, , command, ...args] = process.argv;
         case 'telegram':
             cmdTelegram(args);
             break;
+        case 'admin':
+            cmdAdmin();
+            break;
         case 'help':
         case '--help':
         case '-h':

package/core/AGENTS.md

@@ -0,0 +1,38 @@
+# Agent Instructions
+
+This project uses **Symphony** for task management and issue tracking.
+
+## Quick Reference
+
+```bash
+symphony_available_tasks          # Find available work
+symphony_claim_task <id>          # Claim a task
+symphony_report_progress <id>     # Report progress
+symphony_complete_task <id>       # Complete work
+symphony_status                   # Check system status
+```
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+
+**MANDATORY WORKFLOW:**
+
+1. **File issues for remaining work** — Create tasks for anything that needs follow-up
+2. **Run quality gates** (if code changed) — Tests, linters, builds
+3. **Update task status** — Complete finished work, update in-progress items
+4. **PUSH TO REMOTE** — This is MANDATORY:
+   ```bash
+   git pull --rebase
+   git push
+   git status  # MUST show "up to date with origin"
+   ```
+5. **Clean up** — Clear stashes, prune remote branches
+6. **Verify** — All changes committed AND pushed
+7. **Hand off** — Provide context for next session
+
+**CRITICAL RULES:**
+- Work is NOT complete until `git push` succeeds
+- NEVER stop before pushing — that leaves work stranded locally
+- NEVER say "ready to push when you are" — YOU must push
+- If push fails, resolve and retry until it succeeds