@leejungkiin/awkit 1.0.9 → 1.1.1

package/symphony/mcp/tools/workspace.js

@@ -0,0 +1,143 @@
+/**
+ * Symphony MCP Tools — Workspace Management
+ * 
+ * Tools for workspace/git operations:
+ * - symphony_workspace_status: Get workspace info + diff stats
+ * - symphony_merge_task: Trigger auto-merge pipeline
+ */
+const { z } = require('zod');
+const workspaceManager = require('../../core/workspace-manager');
+const mergePipeline = require('../../core/merge-pipeline');
+
+const tools = [];
+
+// ─── symphony_workspace_status ──────────────────────────────────────────────
+
+tools.push({
+    name: 'symphony_workspace_status',
+    description: 'Get workspace info for a task — branch, path, diff stats, and commit log.',
+    schema: {
+        task_id: z.string().describe('Task ID to check workspace for'),
+    },
+    handler: async ({ task_id }) => {
+        try {
+            const ws = workspaceManager.getWorkspace(task_id);
+
+            if (!ws) {
+                return {
+                    content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            exists: false,
+                            message: `No active workspace for task ${task_id}`,
+                        }),
+                    }],
+                };
+            }
+
+            // Get repo path from workspace path
+            const path = require('path');
+            const repoPath = getRepoPath(ws.path);
+
+            const diff = mergePipeline.getDiff(task_id, repoPath);
+            const log = mergePipeline.getBranchLog(task_id, repoPath);
+            const conflicts = mergePipeline.checkConflicts(task_id, repoPath);
+
+            return {
+                content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        exists: true,
+                        workspace: {
+                            id: ws.id,
+                            path: ws.path,
+                            branch: ws.branch,
+                            type: ws.type,
+                            created_at: ws.created_at,
+                        },
+                        diff: {
+                            files: diff.files,
+                            insertions: diff.insertions,
+                            deletions: diff.deletions,
+                        },
+                        commits: log.length,
+                        commitLog: log.slice(0, 10),
+                        hasConflicts: conflicts.hasConflicts,
+                        conflictingFiles: conflicts.conflictingFiles,
+                    }),
+                }],
+            };
+        } catch (error) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: error.message }) }],
+                isError: true,
+            };
+        }
+    },
+});
+
+// ─── symphony_merge_task ────────────────────────────────────────────────────
+
+tools.push({
+    name: 'symphony_merge_task',
+    description: 'Run auto-merge pipeline for a completed task: rebase → merge → cleanup.',
+    schema: {
+        task_id: z.string().describe('Task ID to merge'),
+        repo_path: z.string().optional().describe('Repository path (auto-detected if omitted)'),
+    },
+    handler: async ({ task_id, repo_path }) => {
+        try {
+            const ws = workspaceManager.getWorkspace(task_id);
+            if (!ws) {
+                return {
+                    content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'error',
+                            message: `No active workspace for task ${task_id}`,
+                        }),
+                    }],
+                    isError: true,
+                };
+            }
+
+            const repoPath = repo_path || getRepoPath(ws.path);
+            const result = mergePipeline.autoMerge(task_id, repoPath);
+
+            return {
+                content: [{
+                    type: 'text',
+                    text: JSON.stringify(result),
+                }],
+                isError: result.status === 'error',
+            };
+        } catch (error) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: error.message }) }],
+                isError: true,
+            };
+        }
+    },
+});
+
+// ─── Helper ─────────────────────────────────────────────────────────────────
+
+/**
+ * Derive the main repo path from a workspace path.
+ * Workspaces are typically in .symphony/workspaces/<task-id> relative to repo.
+ */
+function getRepoPath(wsPath) {
+    const path = require('path');
+    // Walk up from workspace to find .git
+    let current = path.dirname(wsPath);
+    for (let i = 0; i < 5; i++) {
+        const gitDir = path.join(current, '.git');
+        const fs = require('fs');
+        if (fs.existsSync(gitDir)) return current;
+        current = path.dirname(current);
+    }
+    // Fallback: assume workspace is in .symphony/workspaces/ under repo root
+    return path.resolve(wsPath, '..', '..', '..');
+}
+
+module.exports = tools;

package/symphony/next.config.mjs

@@ -0,0 +1,7 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  // Allow requiring CommonJS core modules from API routes
+  serverExternalPackages: ['better-sqlite3'],
+};
+
+export default nextConfig;

package/symphony/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "awkit-symphony",
+  "version": "0.1.0",
+  "description": "Multi-Agent Orchestration for AI Coding Assistants — task management, git isolation, file locking, and real-time dashboard",
+  "keywords": [
+    "ai",
+    "multi-agent",
+    "orchestration",
+    "mcp",
+    "git",
+    "worktree",
+    "dashboard",
+    "coding-assistant"
+  ],
+  "license": "MIT",
+  "main": "core/orchestrator.js",
+  "bin": {
+    "symphony": "./cli/index.js"
+  },
+  "files": [
+    "core/",
+    "cli/",
+    "mcp/",
+    "lib/",
+    "app/",
+    "scripts/",
+    "symphony.config.js",
+    "next.config.mjs",
+    "jsconfig.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "next dev -p 3100",
+    "build": "next build",
+    "start": "next start -p 3100",
+    "postinstall": "node scripts/postinstall.js",
+    "cli": "node cli/index.js",
+    "mcp": "node mcp/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.6.2",
+    "commander": "^14.0.3",
+    "nanoid": "^3.3.11",
+    "next": "16.1.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "zod": "^4.3.6"
+  }
+}

package/symphony/scripts/postinstall.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+/**
+ * Symphony Postinstall Script
+ * Automatically builds the Next.js dashboard after `npm install`.
+ * Skips build during development (when running from source directory).
+ */
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const ROOT = path.join(__dirname, '..');
+
+// Skip if .next/ already exists (already built)
+if (fs.existsSync(path.join(ROOT, '.next'))) {
+    console.log('✅ Symphony dashboard already built — skipping.');
+    process.exit(0);
+}
+
+// Skip if we're in a CI environment that doesn't need the dashboard
+if (process.env.CI || process.env.SYMPHONY_SKIP_BUILD) {
+    console.log('⏭️  Skipping Symphony build (CI or SYMPHONY_SKIP_BUILD set).');
+    process.exit(0);
+}
+
+console.log('');
+console.log('🎼 Symphony — Building dashboard...');
+console.log('   This only happens once after installation.');
+console.log('');
+
+try {
+    execSync('npx next build', {
+        cwd: ROOT,
+        stdio: 'inherit',
+        env: { ...process.env, NODE_ENV: 'production' },
+    });
+    console.log('');
+    console.log('✅ Symphony dashboard built successfully!');
+    console.log('   Run `symphony start` to launch.');
+    console.log('');
+} catch (err) {
+    console.error('');
+    console.error('⚠️  Symphony dashboard build failed.');
+    console.error('   You can manually build later with: symphony build');
+    console.error('   The CLI commands will still work without the dashboard.');
+    console.error('');
+    // Don't fail the install — CLI/MCP still work without dashboard
+    process.exit(0);
+}

package/symphony/symphony.config.js

@@ -0,0 +1,41 @@
+/**
+ * Symphony Configuration
+ * Default settings for the AWKit Symphony orchestration platform.
+ */
+module.exports = {
+    // Server
+    port: 3100,
+
+    // Concurrency
+    maxAgents: 3,
+
+    // Workspace
+    workspace: {
+        root: '.symphony/workspaces',
+        type: 'hybrid',       // 'worktree' | 'clone' | 'hybrid'
+        cloneThreshold: 30,   // files > 30 → full clone instead of worktree
+    },
+
+    // Git
+    git: {
+        autoMerge: true,
+        targetBranch: 'main',
+        branchPrefix: 'symphony/',
+    },
+
+    // File Locks
+    locks: {
+        strategy: 'pessimistic',
+        autoRelease: 3600,    // seconds — auto-release stuck locks
+    },
+
+    // Dashboard
+    dashboard: {
+        theme: 'dark',
+    },
+
+    // Database
+    db: {
+        path: null, // null = auto-detect (~/.symphony/symphony.db or .symphony/symphony.db)
+    },
+};

package/templates/conductor-tracks.md

@@ -0,0 +1,38 @@
+# 🎼 Strategic Tracks — Conductor Roadmap
+
+> This file is managed by the Conductor (Gemini CLI).
+> Antigravity IDE reads this for context. CLI writes strategic updates.
+
+---
+
+## Active Tracks
+
+### Track 1: [Track Name]
+- **Goal:** [What we're trying to achieve]
+- **Status:** 🔵 Planning | 🟢 In Progress | ✅ Done
+- **Milestones:**
+  - [ ] Milestone 1
+  - [ ] Milestone 2
+  - [ ] Milestone 3
+- **Key Decisions:**
+  - [Decision 1 — rationale]
+- **Notes:**
+  - [Any important context]
+
+---
+
+## Completed Tracks
+
+<!-- Move completed tracks here for reference -->
+
+---
+
+## Decision Log
+
+| Date | Decision | Rationale | Track |
+|------|----------|-----------|-------|
+| YYYY-MM-DD | ... | ... | #1 |
+
+---
+
+*Last updated by Conductor: [timestamp]*

package/templates/workflow_dual_mode_template.md

@@ -34,7 +34,7 @@ description: [Short description of the workflow]
 ### Phase 1: Context & Setup
 1. **Understand Intent:**
    - "Bạn muốn làm gì với [Command]?"
-   - (AI analyzes context from `.project-identity` & `.beads`)
+   - (AI analyzes context from `.project-identity` & `.symphony`)
 
 2. **Configuration:**
    - [Question 1]
@@ -68,7 +68,7 @@ description: [Short description of the workflow]
    - Locations of artifacts.
 
 2. **Memory Sync:**
-   - Auto-sync with Beads (Task) & Brain (Knowledge).
+   - Auto-sync with Symphony (Task) & Brain (Knowledge).
 
 3. **Next Steps Menu:**
    ```markdown
@@ -79,9 +79,9 @@ description: [Short description of the workflow]
 
 ---
 
-## 🧠 Brain & Beads Integration
+## 🧠 Brain & Symphony Integration
 
-- **Input:** Check `bd list --status in_progress` to resume context.
+- **Input:** Check `symphony_available_tasks(filter="my")` to resume context.
 - **Output:**
-  - Create/Update Beads task.
+  - Create/Update Symphony task.
   - Create Brain memory file if knowledge is valuable.

package/workflows/_uncategorized/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

package/workflows/_uncategorized/decompile.md

@@ -0,0 +1,67 @@
+---
+description: 📦 Decompile APK/XAPK/JAR/AAR Android và phân tích cấu trúc + trích xuất API
+---
+
+# /decompile — Android Reverse Engineering & API Extraction
+
+// turbo-all
+
+## Workflow
+
+### 1. Xác định file target
+
+Nếu user cung cấp đường dẫn file → dùng luôn.
+Nếu không → hỏi user đường dẫn đến file `.apk`, `.xapk`, `.jar`, hoặc `.aar`.
+
+### 2. Kiểm tra & cài đặt dependencies
+
+```bash
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/check-deps.sh
+```
+
+Parse output tìm `INSTALL_REQUIRED:` và `INSTALL_OPTIONAL:`.
+
+**Nếu thiếu required deps**, cài từng cái:
+```bash
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/install-dep.sh java
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/install-dep.sh jadx
+```
+
+**Nếu thiếu optional deps** (vineflower, dex2jar), hỏi user có muốn cài không. Khuyến nghị cài cả hai.
+
+Sau khi cài, chạy lại `check-deps.sh` để verify. KHÔNG tiếp tục nếu required deps chưa OK.
+
+### 3. Decompile
+
+```bash
+# APK/XAPK → dùng jadx (xử lý resources tốt)
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/decompile.sh <file>
+
+# JAR/AAR + có Fernflower → ưu tiên fernflower
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/decompile.sh --engine fernflower <file>
+
+# Nếu jadx có warnings hoặc muốn chất lượng cao nhất → chạy cả hai
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/decompile.sh --engine both <file>
+
+# Cho app bị obfuscate → thêm --deobf
+bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/decompile.sh --deobf <file>
+```
+
+### 4. Phân tích cấu trúc
+
+1. Đọc `AndroidManifest.xml` từ resources directory
+2. Nếu XAPK, review `xapk-manifest.json`
+3. List package structure top-level
+4. Xác định Activity chính, Application class, architecture pattern
+5. Báo cáo summary cho user
+
+### 5. Đề xuất bước tiếp theo
+
+Hỏi user muốn làm gì tiếp:
+- **Trace call flows**: "Tôi có thể theo luồng thực thi từ Activity đến API calls"
+- **Extract APIs**: "Tôi có thể tìm tất cả HTTP endpoints và tài liệu hóa"
+  ```bash
+  bash ~/.gemini/antigravity/skills/android-re-analyzer/scripts/find-api-calls.sh <output>/sources/
+  ```
+- **Phân tích class cụ thể**: "Chỉ cho tôi class hoặc feature cần phân tích"
+- **Rebuild app**: "Muốn rebuild thành Kotlin hiện đại? → chuyển sang skill `smali-to-kotlin`"

package/workflows/_uncategorized/skill-health.md

@@ -4,9 +4,9 @@ description: 🩺 Kiểm tra tình trạng độ bền và sự ổn định c
 
 # 🩺 AWK Skill & Workflow Health Check
 
-> **Workflow này tính toán độ "Health" (khỏe mạnh) của các agentic workflows dựa trên dữ liệu từ Beads và Linting.**
+> **Workflow này tính toán độ "Health" (khỏe mạnh) của các agentic workflows dựa trên dữ liệu từ Symphony và Linting.**
 > - Phát hiện Token Creep (khi SKILL.md phình to).
-> - Phát hiện High Correction Rate (khi 1 Bead in_progress quá lâu hoặc có comment phàn nàn).
+> - Phát hiện High Correction Rate (khi 1 task in_progress quá lâu hoặc có comment phàn nàn).
 
 ---
 
@@ -18,12 +18,12 @@ awkit lint || true
 ```
 Nếu có cảnh báo, khuyên User sử dụng `/refactor` để chẻ nhỏ files nhằm tiết kiệm Context Window.
 
-## 2. Kiểm tra hiệu suất chạy (Beads-Driven)
-Lấy top 5 Beads (Tasks) mới nhất ở trạng thái `done` hoặc `in_progress` để đánh giá thời gian chênh lệch:
+## 2. Kiểm tra hiệu suất chạy (Symphony-Driven)
+Lấy top 5 tasks mới nhất ở trạng thái `done` hoặc `in_progress` để đánh giá thời gian chênh lệch:
 
-```bash
-bd list --status done --limit 5
-bd list --status in_progress
+```
+symphony_available_tasks(filter="all")
+symphony_status()
 ```
 
 **Phân tích của hệ thống AI**:

package/workflows/ads/ads-audit.md

@@ -2,7 +2,7 @@
 description: 📊 Tự động phân tích & báo cáo hiệu suất Google Ads hàng ngày (Dual-Mode v5.0)
 ---
 
-# WORKFLOW: /ads-audit - The Ads Analyst (Dual-Mode + Beads)
+# WORKFLOW: /ads-audit - The Ads Analyst (Dual-Mode + Symphony)
 
 > **Mode A (Expert):** `/adsExpert [id]` -> Auto check & create tasks.
 > **Mode B (Guided):** `/ads-audit` -> Chọn Account -> Phân tích -> Hướng dẫn chi tiết.
@@ -49,16 +49,16 @@ User nhận được tóm tắt và menu chọn hành động:
 
 ➡️ **Chiến lược tiếp theo:**
 1️⃣ 🧹 Dọn dẹp rác ngay (Review & Pause)
-2️⃣ 📿 Tạo task Beads để xử lý sau
+2️⃣ 🎵 Tạo task Symphony để xử lý sau
 3️⃣ 📝 Xem báo cáo đầy đủ
 4️⃣ 🔍 Phân tích sâu hơn (`/ads-analyst`)
 ```
 
-### Phase 5: Beads Integration
+### Phase 5: Symphony Integration
 - Nếu chọn **2 (Create Task)**:
     - AI tự động tạo các tasks:
-        - `bd create "Pause Keyword X (Waste 200k)" --label ads`
-        - `bd create "Review Campaign Y (CPA too high)" --label ads`
+        - `symphony_create_task(title="Pause Keyword X (Waste 200k)")`
+        - `symphony_create_task(title="Review Campaign Y (CPA too high)")`
 
 ---
 

package/workflows/ads/ads-optimize.md

@@ -37,21 +37,21 @@ User chọn mục tiêu:
 
 ### Phase 3: Action Execution
 - AI thực hiện thay đổi thông qua MCP (nếu tool hỗ trợ write).
-- Nếu MCP chưa hỗ trợ write (an toàn): -> **Tạo Beads Task hướng dẫn chi tiết.**
+- Nếu MCP chưa hỗ trợ write (an toàn): -> **Tạo Symphony Task hướng dẫn chi tiết.**
 
-### Phase 4: Beads Integration (Task Generation)
+### Phase 4: Symphony Integration (Task Generation)
 
-**Tạo Action Plan trong Beads:**
+**Tạo Action Plan trong Symphony:**
 
-```bash
+```
 # Example: Cut Waste Plan
-bd create "Ads Optimization: Cut Waste [Date]" --priority 1
-bd create "Add 5 Negative Keywords" --parent [ParentID] --note "burn, hack, free,..."
-bd create "Exclude 10 Mobile App Placements" --parent [ParentID]
+symphony_create_task(title="Ads Optimization: Cut Waste [Date]", priority=1)
+symphony_create_task(title="Add 5 Negative Keywords", description="burn, hack, free,...")
+symphony_create_task(title="Exclude 10 Mobile App Placements")
 
 # Example: Scale Plan
-bd create "Ads Optimization: Scale Up [Date]" --priority 0
-bd create "Increase Budget: Campaign A (+20%)" --parent [ParentID]
+symphony_create_task(title="Ads Optimization: Scale Up [Date]", priority=2)
+symphony_create_task(title="Increase Budget: Campaign A (+20%)")
 ```
 
 ---
@@ -92,6 +92,6 @@ Sau khi hoàn thành workflow, AI **PHẢI** ghi log vào file `brain/ads_histor
 
 ## ⚠️ NEXT STEPS:
 ```
-1️⃣ Xác nhận task trong Beads (`/todo`)
+1️⃣ Xác nhận task trong Symphony (`/todo`)
 2️⃣ Kiểm tra lại Audit (`/ads-audit`)
 ```

package/workflows/ads/adsExpert.md

@@ -49,23 +49,23 @@ AI tự động check các rules sau:
 
 **Without `--auto-fix`:**
 - Tổng hợp lỗi vào Report.
-- Tạo Beads Tasks cho các lỗi R1, R2.
+- Tạo Symphony Tasks cho các lỗi R1, R2.
 
 **With `--auto-fix`:**
 - **R1 (Wasted Spend):** Auto-pause Keyword/Ad Group.
-- **R2, R3, R4:** Tạo Beads Task.
+- **R2, R3, R4:** Tạo Symphony Task.
 
-### 4. Beads Integration
+### 4. Symphony Integration
 
 ```bash
 # R1: Wasted Spend -> Critical Task
-bd create "Pause Waste: [Keyword] ($$ Spend, 0 Conv)" --label ads-waste --priority 0
+symphony_create_task(title="Pause Waste: [Keyword] ($$ Spend, 0 Conv)", priority=1)
 
 # R2: High CPA -> Investigation Task
-bd create "Investigate High CPA: [Campaign] (CPA: $$)" --label ads-optimize --priority 1
+symphony_create_task(title="Investigate High CPA: [Campaign] (CPA: $$)", priority=1)
 
 # R5: Good Mover -> Scale Task
-bd create "Scale Up: [Campaign] (ROAS: 2.5)" --label ads-scale --priority 1
+symphony_create_task(title="Scale Up: [Campaign] (ROAS: 2.5)", priority=1)
 ```
 
 ### 5. Report Generation
@@ -83,7 +83,7 @@ Tạo file: `reports/ads/[date]_expert_audit.md`
 ## 🚨 Actions Taken (Auto-Fix)
 - Paused Keyword: "free download" (Spent 200k, 0 conv)
 
-## 📿 Beads Tasks Created
+## 📿 Symphony Tasks Created
 1. [P0] Pause Waste: "cheat codes" (Spent 150k, 0 conv) #123
 2. [P1] Investigate High CPA: "Competitor Campaign" #124
 3. [P1] Scale Up: "Brand Campaign" #125