@leejungkiin/awkit 1.1.6 → 1.1.9

package/symphony/core/agent-manager.js

@@ -1,357 +0,0 @@
-/**
- * Symphony Agent Manager
- * Project-scoped agent operations with skill-based task matching.
- * 
- * Agents are configuration templates attached to projects.
- * Each Antigravity window attaches to one agent via session_id.
- * Agents have skills that determine which tasks they can be assigned.
- */
-const { getDb } = require('./db');
-
-const IDLE_THRESHOLD_MINUTES = 15;
-
-// ─── CRUD Operations ────────────────────────────────────────────────────────
-
-/**
- * Create a new project-scoped agent.
- * @param {string} id - Agent ID (e.g., 'giacngo-dev')
- * @param {string} projectId - Project ID
- * @param {string} name - Display name
- * @param {string[]} [skills] - Array of skill strings
- * @param {Object} [opts] - { icon, color, max_concurrent }
- * @returns {Object} Created agent
- */
-function createAgent(id, projectId, name, skills = [], opts = {}) {
-    const db = getDb();
-
-    // Validate project exists
-    const project = db.prepare('SELECT id FROM projects WHERE id = ?').get(projectId);
-    if (!project) {
-        throw new Error(`Project not found: ${projectId}. Register it first.`);
-    }
-
-    // Check for duplicate
-    const existing = db.prepare('SELECT id FROM project_agents WHERE id = ?').get(id);
-    if (existing) {
-        throw new Error(`Agent already exists: ${id}`);
-    }
-
-    db.prepare(`
-        INSERT INTO project_agents (id, project_id, name, skills, icon, color, max_concurrent)
-        VALUES (?, ?, ?, ?, ?, ?, ?)
-    `).run(
-        id,
-        projectId,
-        name,
-        JSON.stringify(skills),
-        opts.icon || '🤖',
-        opts.color || '#8888a0',
-        opts.max_concurrent || 1
-    );
-
-    return getAgent(id);
-}
-
-/**
- * Get a single agent by ID.
- * @param {string} id - Agent ID
- * @returns {Object|null}
- */
-function getAgent(id) {
-    const db = getDb();
-    const row = db.prepare('SELECT * FROM project_agents WHERE id = ?').get(id);
-    return row ? normalizeAgent(row) : null;
-}
-
-/**
- * List agents with optional filters.
- * @param {Object} [filter] - { project, status }
- * @returns {Object[]}
- */
-function listAgents(filter = {}) {
-    const db = getDb();
-    const conditions = [];
-    const params = [];
-
-    if (filter.project) {
-        conditions.push('project_id = ?');
-        params.push(filter.project);
-    }
-    if (filter.status) {
-        conditions.push('status = ?');
-        params.push(filter.status);
-    }
-
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-    const rows = db.prepare(`SELECT * FROM project_agents ${where} ORDER BY project_id ASC, created_at ASC`).all(...params);
-    return rows.map(normalizeAgent);
-}
-
-/**
- * Update agent fields.
- * @param {string} id - Agent ID
- * @param {Object} fields - { name, skills, icon, color, max_concurrent }
- * @returns {Object} Updated agent
- */
-function updateAgent(id, fields) {
-    const db = getDb();
-    const allowed = ['name', 'icon', 'color', 'max_concurrent'];
-    const sets = [];
-    const params = [];
-
-    for (const key of allowed) {
-        if (fields[key] !== undefined) {
-            sets.push(`${key} = ?`);
-            params.push(fields[key]);
-        }
-    }
-
-    // Handle skills separately (needs JSON)
-    if (fields.skills !== undefined) {
-        sets.push('skills = ?');
-        params.push(JSON.stringify(fields.skills));
-    }
-
-    if (sets.length === 0) return getAgent(id);
-
-    params.push(id);
-    db.prepare(`UPDATE project_agents SET ${sets.join(', ')} WHERE id = ?`).run(...params);
-    return getAgent(id);
-}
-
-/**
- * Remove an agent (must be offline).
- * @param {string} id - Agent ID
- * @returns {boolean}
- */
-function removeAgent(id) {
-    const db = getDb();
-    const agent = db.prepare('SELECT * FROM project_agents WHERE id = ?').get(id);
-    if (!agent) throw new Error(`Agent not found: ${id}`);
-    if (agent.status === 'working') {
-        throw new Error(`Cannot remove working agent: ${id}. Detach first.`);
-    }
-    db.prepare('DELETE FROM project_agents WHERE id = ?').run(id);
-    return true;
-}
-
-// ─── Session Management ─────────────────────────────────────────────────────
-
-/**
- * Attach an Antigravity window (session) to an agent.
- * @param {string} agentId - Agent ID
- * @param {string} sessionId - Conversation/session ID
- * @returns {Object} Updated agent
- */
-function attachSession(agentId, sessionId) {
-    const db = getDb();
-    const agent = db.prepare('SELECT * FROM project_agents WHERE id = ?').get(agentId);
-    if (!agent) throw new Error(`Agent not found: ${agentId}`);
-
-    if (agent.session_id && agent.session_id !== sessionId && agent.status !== 'offline') {
-        throw new Error(`Agent ${agentId} already attached to session ${agent.session_id}`);
-    }
-
-    db.prepare(`
-        UPDATE project_agents 
-        SET session_id = ?, status = 'idle', last_active_at = datetime('now'), idle_since = datetime('now')
-        WHERE id = ?
-    `).run(sessionId, agentId);
-
-    return getAgent(agentId);
-}
-
-/**
- * Detach a session from an agent.
- * Releases any claimed tasks.
- * @param {string} agentId - Agent ID
- * @returns {Object} Updated agent
- */
-function detachSession(agentId) {
-    const db = getDb();
-    const agent = db.prepare('SELECT * FROM project_agents WHERE id = ?').get(agentId);
-    if (!agent) throw new Error(`Agent not found: ${agentId}`);
-
-    // Reset any in-progress tasks back to ready
-    if (agent.current_task_id) {
-        db.prepare(`
-            UPDATE tasks SET status = 'ready', agent_id = NULL 
-            WHERE agent_id = ? AND status IN ('claimed', 'in_progress')
-        `).run(agentId);
-    }
-
-    db.prepare(`
-        UPDATE project_agents 
-        SET session_id = NULL, status = 'offline', current_task_id = NULL, idle_since = NULL
-        WHERE id = ?
-    `).run(agentId);
-
-    return getAgent(agentId);
-}
-
-/**
- * Update agent's last activity timestamp (call on every meaningful action).
- * @param {string} agentId - Agent ID
- */
-function touchActivity(agentId) {
-    const db = getDb();
-    db.prepare(`
-        UPDATE project_agents 
-        SET last_active_at = datetime('now'), idle_since = NULL
-        WHERE id = ?
-    `).run(agentId);
-}
-
-/**
- * Mark agent as working on a task.
- * @param {string} agentId - Agent ID
- * @param {string} taskId - Task ID
- * @returns {Object} Updated agent
- */
-function startWork(agentId, taskId) {
-    const db = getDb();
-    db.prepare(`
-        UPDATE project_agents 
-        SET status = 'working', current_task_id = ?, last_active_at = datetime('now'), idle_since = NULL
-        WHERE id = ?
-    `).run(taskId, agentId);
-    return getAgent(agentId);
-}
-
-/**
- * Mark agent as idle (after task completion).
- * @param {string} agentId - Agent ID
- * @returns {Object} Updated agent
- */
-function markIdle(agentId) {
-    const db = getDb();
-    db.prepare(`
-        UPDATE project_agents 
-        SET status = 'idle', current_task_id = NULL, idle_since = datetime('now')
-        WHERE id = ?
-    `).run(agentId);
-    return getAgent(agentId);
-}
-
-// ─── Skill Matching ─────────────────────────────────────────────────────────
-
-/**
- * Find agents matching task skill requirements.
- * @param {string[]} taskSkills - Required skills for the task
- * @param {string} [projectId] - Limit to one project
- * @returns {Object[]} Matching agents sorted by relevance
- */
-function findMatchingAgents(taskSkills, projectId) {
-    const agents = listAgents(projectId ? { project: projectId } : {});
-
-    if (!taskSkills || taskSkills.length === 0) {
-        // No skill requirements — all agents match
-        return agents.filter(a => a.status !== 'offline');
-    }
-
-    return agents
-        .filter(a => a.status !== 'offline')
-        .filter(a => {
-            // Agent must have at least 1 matching skill
-            return taskSkills.some(s => a.skills.includes(s));
-        })
-        .map(a => {
-            const matchCount = taskSkills.filter(s => a.skills.includes(s)).length;
-            return { ...a, matchCount, matchPercent: Math.round((matchCount / taskSkills.length) * 100) };
-        })
-        .sort((a, b) => {
-            // Prefer idle over working
-            if (a.status === 'idle' && b.status !== 'idle') return -1;
-            if (b.status === 'idle' && a.status !== 'idle') return 1;
-            // Then by match count
-            return b.matchCount - a.matchCount;
-        });
-}
-
-/**
- * Find agents that have been idle beyond the threshold.
- * @param {number} [thresholdMinutes] - Minutes of inactivity
- * @returns {Object[]} Idle agents
- */
-function findIdleAgents(thresholdMinutes = IDLE_THRESHOLD_MINUTES) {
-    const db = getDb();
-    const rows = db.prepare(`
-        SELECT * FROM project_agents 
-        WHERE status IN ('idle', 'working') 
-        AND idle_since IS NOT NULL 
-        AND datetime(idle_since, '+' || ? || ' minutes') < datetime('now')
-    `).all(thresholdMinutes);
-    return rows.map(normalizeAgent);
-}
-
-/**
- * Suggest reassignment for idle agents (cross-project).
- * Returns agents with matching ready tasks from any project.
- * @returns {Object[]} Array of { agent, suggestedTasks }
- */
-function suggestReassignment() {
-    const db = getDb();
-    const idleAgents = findIdleAgents();
-    const suggestions = [];
-
-    for (const agent of idleAgents) {
-        // Find ready tasks matching this agent's skills (any project)
-        const readyTasks = db.prepare(`
-            SELECT * FROM tasks WHERE status = 'ready' ORDER BY priority ASC, sort_order ASC LIMIT 10
-        `).all();
-
-        const matchingTasks = readyTasks.filter(t => {
-            const reqSkills = t.required_skills ? JSON.parse(t.required_skills) : [];
-            if (reqSkills.length === 0) return true; // No skill req → matches all
-            return reqSkills.some(s => agent.skills.includes(s));
-        });
-
-        if (matchingTasks.length > 0) {
-            suggestions.push({
-                agent,
-                suggestedTasks: matchingTasks.slice(0, 3),
-            });
-        }
-    }
-
-    return suggestions;
-}
-
-// ─── Helpers ────────────────────────────────────────────────────────────────
-
-/**
- * Normalize a raw DB row into a clean agent object.
- */
-function normalizeAgent(row) {
-    return {
-        id: row.id,
-        projectId: row.project_id,
-        name: row.name,
-        skills: row.skills ? JSON.parse(row.skills) : [],
-        status: row.status,
-        sessionId: row.session_id,
-        currentTask: row.current_task_id,
-        lastActiveAt: row.last_active_at,
-        idleSince: row.idle_since,
-        maxConcurrent: row.max_concurrent || 1,
-        icon: row.icon || '🤖',
-        color: row.color || '#8888a0',
-        createdAt: row.created_at,
-    };
-}
-
-module.exports = {
-    createAgent,
-    getAgent,
-    listAgents,
-    updateAgent,
-    removeAgent,
-    attachSession,
-    detachSession,
-    touchActivity,
-    startWork,
-    markIdle,
-    findMatchingAgents,
-    findIdleAgents,
-    suggestReassignment,
-};

package/symphony/core/context-bus.js

@@ -1,100 +0,0 @@
-/**
- * Symphony Context Bus
- * Event pub/sub for inter-agent communication.
- * Agents broadcast changes (schema updates, API changes, etc.)
- * so other agents can adapt their work.
- */
-const { getDb } = require('./db');
-
-/**
- * Publish an event to the context bus.
- * @param {string} agentId - Publishing agent
- * @param {string} eventType - Event type (file_modified, api_changed, schema_updated, etc.)
- * @param {Object} payload - Event payload { files, description, impact }
- * @param {string} [taskId] - Related task
- */
-function publish(agentId, eventType, payload, taskId = null) {
-    const db = getDb();
-    db.prepare(`
-    INSERT INTO events (agent_id, task_id, event_type, payload)
-    VALUES (?, ?, ?, ?)
-  `).run(agentId, taskId, eventType, JSON.stringify(payload));
-}
-
-/**
- * Query events with optional filters.
- * @param {Object} [filter] - { since, eventType, agentId, limit }
- * @returns {Object[]}
- */
-function query(filter = {}) {
-    const db = getDb();
-    const conditions = [];
-    const params = [];
-
-    if (filter.since) {
-        conditions.push('created_at > ?');
-        params.push(filter.since);
-    }
-    if (filter.eventType) {
-        conditions.push('event_type = ?');
-        params.push(filter.eventType);
-    }
-    if (filter.agentId) {
-        conditions.push('agent_id = ?');
-        params.push(filter.agentId);
-    }
-
-    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-    const limit = filter.limit ? `LIMIT ${parseInt(filter.limit)}` : 'LIMIT 50';
-
-    const rows = db.prepare(`
-    SELECT * FROM events ${where} ORDER BY created_at DESC ${limit}
-  `).all(...params);
-
-    return rows.map(row => ({
-        ...row,
-        payload: row.payload ? JSON.parse(row.payload) : null,
-    }));
-}
-
-/**
- * Get most recent events.
- * @param {number} [limit=10]
- * @returns {Object[]}
- */
-function getRecent(limit = 10) {
-    return query({ limit });
-}
-
-/**
- * Get events related to specific files.
- * @param {string[]} files - File paths to check
- * @param {number} [limit=20]
- * @returns {Object[]}
- */
-function getFileEvents(files, limit = 20) {
-    const db = getDb();
-    const rows = db.prepare(`
-    SELECT * FROM events 
-    WHERE event_type IN ('file_modified', 'schema_updated', 'api_changed')
-    ORDER BY created_at DESC
-    LIMIT ?
-  `).all(limit);
-
-    return rows
-        .map(row => ({
-            ...row,
-            payload: row.payload ? JSON.parse(row.payload) : null,
-        }))
-        .filter(event => {
-            if (!event.payload?.files) return false;
-            return event.payload.files.some(f => files.includes(f));
-        });
-}
-
-module.exports = {
-    publish,
-    query,
-    getRecent,
-    getFileEvents,
-};

package/symphony/core/db.js

@@ -1,223 +0,0 @@
-/**
- * Symphony Database Module
- * SQLite database wrapper with auto-migration.
- */
-const Database = require('better-sqlite3');
-const path = require('path');
-const fs = require('fs');
-
-const SCHEMA = `
--- Tasks table (source of truth for all work items)
-CREATE TABLE IF NOT EXISTS tasks (
-  id TEXT PRIMARY KEY,
-  title TEXT NOT NULL,
-  description TEXT,
-  status TEXT NOT NULL DEFAULT 'ready',
-  priority INTEGER DEFAULT 2,
-  sort_order INTEGER DEFAULT 0,
-  acceptance TEXT,
-  phase TEXT,
-  epic_id TEXT,
-  agent_id TEXT,
-  estimated_files TEXT,
-  workspace_path TEXT,
-  branch TEXT,
-  progress INTEGER DEFAULT 0,
-  created_at DATETIME DEFAULT (datetime('now')),
-  claimed_at DATETIME,
-  completed_at DATETIME,
-  summary TEXT
-);
-
--- File locks (prevent 2 agents editing same file)
-CREATE TABLE IF NOT EXISTS file_locks (
-  file_path TEXT PRIMARY KEY,
-  agent_id TEXT NOT NULL,
-  task_id TEXT NOT NULL,
-  acquired_at DATETIME DEFAULT (datetime('now'))
-);
-
--- Agent registry (connected IDE sessions)
-CREATE TABLE IF NOT EXISTS agents (
-  id TEXT PRIMARY KEY,
-  name TEXT,
-  status TEXT DEFAULT 'idle',
-  current_task_id TEXT,
-  specialties TEXT DEFAULT '[]',
-  color TEXT DEFAULT '#8888a0',
-  max_concurrent INTEGER DEFAULT 1,
-  connected_at DATETIME DEFAULT (datetime('now')),
-  last_heartbeat DATETIME DEFAULT (datetime('now')),
-  workspace_path TEXT
-);
-
--- Context Bus events (inter-agent communication)
-CREATE TABLE IF NOT EXISTS events (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  agent_id TEXT NOT NULL,
-  task_id TEXT,
-  event_type TEXT NOT NULL,
-  payload TEXT,
-  created_at DATETIME DEFAULT (datetime('now'))
-);
-
--- Workspaces (git worktree tracking)
-CREATE TABLE IF NOT EXISTS workspaces (
-  id TEXT PRIMARY KEY,
-  task_id TEXT NOT NULL,
-  type TEXT DEFAULT 'worktree',
-  path TEXT NOT NULL,
-  branch TEXT NOT NULL,
-  status TEXT DEFAULT 'active',
-  created_at DATETIME DEFAULT (datetime('now')),
-  merged_at DATETIME
-);
-
--- Indexes for performance
-CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
-CREATE INDEX IF NOT EXISTS idx_tasks_agent ON tasks(agent_id);
-CREATE INDEX IF NOT EXISTS idx_locks_agent ON file_locks(agent_id);
-CREATE INDEX IF NOT EXISTS idx_events_time ON events(created_at);
-CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
-
--- Project-scoped agents (multi-agent architecture)
-CREATE TABLE IF NOT EXISTS project_agents (
-  id TEXT PRIMARY KEY,
-  project_id TEXT NOT NULL,
-  name TEXT NOT NULL,
-  skills TEXT DEFAULT '[]',
-  status TEXT DEFAULT 'offline',
-  session_id TEXT,
-  current_task_id TEXT,
-  last_active_at TEXT,
-  idle_since TEXT,
-  max_concurrent INTEGER DEFAULT 1,
-  icon TEXT DEFAULT '🤖',
-  color TEXT DEFAULT '#8888a0',
-  created_at DATETIME DEFAULT (datetime('now'))
-);
-
-CREATE INDEX IF NOT EXISTS idx_project_agents_project ON project_agents(project_id);
-CREATE INDEX IF NOT EXISTS idx_project_agents_status ON project_agents(status);
-CREATE INDEX IF NOT EXISTS idx_project_agents_session ON project_agents(session_id);
-`;
-
-let _db = null;
-
-/**
- * Get or create the database connection (singleton).
- * @param {string} [dbPath] - Optional custom path for the database file.
- * @returns {Database} better-sqlite3 instance
- */
-function getDb(dbPath) {
-  if (_db) return _db;
-
-  const resolvedPath = dbPath || resolveDbPath();
-  const dir = path.dirname(resolvedPath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-
-  _db = new Database(resolvedPath);
-  _db.pragma('journal_mode = WAL');
-  _db.pragma('foreign_keys = ON');
-
-  // Run schema migrations
-  _db.exec(SCHEMA);
-
-  // Run incremental migrations
-  runMigrations(_db);
-
-  return _db;
-}
-
-/**
- * Run incremental schema migrations for existing databases.
- */
-function runMigrations(db) {
-  const cols = db.pragma('table_info(tasks)').map(c => c.name);
-  if (!cols.includes('sort_order')) {
-    db.exec('ALTER TABLE tasks ADD COLUMN sort_order INTEGER DEFAULT 0');
-  }
-  if (!cols.includes('project_id')) {
-    db.exec('ALTER TABLE tasks ADD COLUMN project_id TEXT');
-  }
-  const agentCols = db.pragma('table_info(agents)').map(c => c.name);
-  if (!agentCols.includes('specialties')) {
-    db.exec('ALTER TABLE agents ADD COLUMN specialties TEXT DEFAULT "[]"');
-  }
-  if (!agentCols.includes('color')) {
-    db.exec('ALTER TABLE agents ADD COLUMN color TEXT DEFAULT "#8888a0"');
-  }
-  if (!agentCols.includes('max_concurrent')) {
-    db.exec('ALTER TABLE agents ADD COLUMN max_concurrent INTEGER DEFAULT 1');
-  }
-
-  // Add required_skills to tasks
-  const taskCols2 = db.pragma('table_info(tasks)').map(c => c.name);
-  if (!taskCols2.includes('required_skills')) {
-    db.exec("ALTER TABLE tasks ADD COLUMN required_skills TEXT DEFAULT '[]'");
-  }
-
-  // Add conversation_id to tasks (Hybrid approach C)
-  if (!taskCols2.includes('conversation_id')) {
-    db.exec('ALTER TABLE tasks ADD COLUMN conversation_id TEXT');
-  }
-
-  // Ensure notes table exists
-  const notesTbl = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='notes'").get();
-  if (!notesTbl) {
-    db.exec(`
-      CREATE TABLE notes (
-        id TEXT PRIMARY KEY,
-        task_id TEXT,
-        project_id TEXT NOT NULL,
-        type TEXT NOT NULL,
-        title TEXT NOT NULL,
-        content TEXT,
-        file_path TEXT,
-        conversation_id TEXT,
-        metadata TEXT DEFAULT '{}',
-        created_at DATETIME DEFAULT (datetime('now')),
-        updated_at DATETIME DEFAULT (datetime('now'))
-      );
-      CREATE INDEX idx_notes_task ON notes(task_id);
-      CREATE INDEX idx_notes_project ON notes(project_id);
-      CREATE INDEX idx_notes_type ON notes(type);
-      CREATE INDEX idx_notes_conversation ON notes(conversation_id);
-    `);
-  }
-}
-
-/**
- * Resolve database file path.
- * CENTRALIZED: Always use ~/.gemini/antigravity/symphony/symphony.db
- * This ensures CLI and API (core.mjs) share the same database.
- */
-function resolveDbPath() {
-  const home = process.env.HOME || process.env.USERPROFILE;
-  const symphonyDir = path.join(home, '.gemini', 'antigravity', 'symphony');
-  if (!fs.existsSync(symphonyDir)) {
-    fs.mkdirSync(symphonyDir, { recursive: true });
-  }
-  return path.join(symphonyDir, 'symphony.db');
-}
-
-/**
- * Close the database connection.
- */
-function close() {
-  if (_db) {
-    _db.close();
-    _db = null;
-  }
-}
-
-/**
- * Reset the singleton (for testing).
- */
-function reset() {
-  close();
-}
-
-module.exports = { getDb, close, reset };