agent-orchestration 0.5.0

package/dist/utils/contextSync.js

@@ -0,0 +1,124 @@
+/**
+ * Utility to sync orchestration state to activeContext.md
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { getDatabase } from '../database.js';
+import { TaskStatus } from '../models.js';
+/**
+ * Check if context sync is enabled via environment variable
+ */
+export function isContextSyncEnabled() {
+    const envVar = process.env.MCP_ORCH_SYNC_CONTEXT;
+    return envVar === 'true' || envVar === '1';
+}
+/**
+ * Get the path to activeContext.md
+ */
+function getContextPath() {
+    return path.join(process.cwd(), 'activeContext.md');
+}
+/**
+ * Sync the current orchestration state to activeContext.md
+ */
+export function syncToActiveContext() {
+    if (!isContextSyncEnabled()) {
+        return;
+    }
+    try {
+        const db = getDatabase();
+        // Get current state
+        const agents = db.listAgents();
+        const activeAgents = agents.filter((a) => ['active', 'busy'].includes(a.status));
+        const inProgressTasks = db.listTasks({ status: TaskStatus.IN_PROGRESS });
+        const pendingTasks = db.listTasks({ status: TaskStatus.PENDING });
+        const decisions = db.listMemory('decisions');
+        const context = db.listMemory('context');
+        // Get current focus
+        const focusEntry = db.getMemory('current_focus', 'context');
+        const currentFocus = focusEntry
+            ? String(focusEntry.value)
+            : '_Not set. Use `memory_set` with key "current_focus" in namespace "context"._';
+        // Build markdown content
+        const lines = [
+            '# Active Context',
+            '',
+            `_Last updated: ${new Date().toISOString()}_`,
+            '',
+            '## Current Focus',
+            '',
+            currentFocus,
+            '',
+            '## Active Agents',
+            '',
+        ];
+        if (activeAgents.length === 0) {
+            lines.push('_No active agents._');
+        }
+        else {
+            for (const agent of activeAgents) {
+                const statusEmoji = agent.status === 'busy' ? '🔵' : '🟢';
+                lines.push(`- ${statusEmoji} **${agent.name}** (${agent.role})`);
+            }
+        }
+        lines.push('', '## In Progress', '');
+        if (inProgressTasks.length === 0) {
+            lines.push('_No tasks in progress._');
+        }
+        else {
+            for (const task of inProgressTasks) {
+                const progress = task.metadata.progress ?? 0;
+                const assignee = task.assignedTo
+                    ? agents.find((a) => a.id === task.assignedTo)?.name ?? task.assignedTo.slice(0, 8)
+                    : 'unassigned';
+                lines.push(`- 🔄 **${task.title}** - ${assignee} (${progress}%)`);
+            }
+        }
+        lines.push('', '## Pending Tasks', '');
+        if (pendingTasks.length === 0) {
+            lines.push('_No pending tasks._');
+        }
+        else {
+            for (const task of pendingTasks.slice(0, 10)) {
+                const priority = task.priority !== 'normal' ? ` [${task.priority}]` : '';
+                lines.push(`- ⏳ ${task.title}${priority}`);
+            }
+            if (pendingTasks.length > 10) {
+                lines.push(`- _...and ${pendingTasks.length - 10} more_`);
+            }
+        }
+        lines.push('', '## Recent Decisions', '');
+        if (decisions.length === 0) {
+            lines.push('_No decisions recorded._');
+        }
+        else {
+            for (const decision of decisions.slice(0, 10)) {
+                const value = typeof decision.value === 'string'
+                    ? decision.value.slice(0, 100)
+                    : JSON.stringify(decision.value).slice(0, 100);
+                lines.push(`- **${decision.key}**: ${value}`);
+            }
+        }
+        lines.push('', '## Context Notes', '');
+        const otherContext = context.filter((c) => c.key !== 'current_focus');
+        if (otherContext.length === 0) {
+            lines.push('_No additional context._');
+        }
+        else {
+            for (const entry of otherContext.slice(0, 10)) {
+                const value = typeof entry.value === 'string'
+                    ? entry.value.slice(0, 80)
+                    : JSON.stringify(entry.value).slice(0, 80);
+                lines.push(`- **${entry.key}**: ${value}`);
+            }
+        }
+        lines.push('', '---', '', '_This file is auto-generated by the Agent Orchestration server._', '_Edit shared memory to update this context._');
+        // Write to file
+        fs.writeFileSync(getContextPath(), lines.join('\n'), 'utf-8');
+    }
+    catch (error) {
+        // Silently fail - this is a nice-to-have feature
+        console.error('Failed to sync activeContext.md:', error);
+    }
+}
+//# sourceMappingURL=contextSync.js.map

package/dist/utils/contextSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextSync.js","sourceRoot":"","sources":["../../src/utils/contextSync.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "agent-orchestration",
+  "version": "0.5.0",
+  "description": "Agent Orchestration - MCP server for multi-agent coordination across IDEs and CLI tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "agent-orchestration": "dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agents-md",
+    "cursor",
+    "ai-agents",
+    "orchestration",
+    "multi-agent",
+    "codex",
+    "aider",
+    "windsurf",
+    "copilot"
+  ],
+  "author": "Aris Setiawan <https://madebyaris.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/madebyaris/agent-orchestration#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/madebyaris/agent-orchestration.git"
+  },
+  "bugs": {
+    "url": "https://github.com/madebyaris/agent-orchestration/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "better-sqlite3": "^11.8.1",
+    "ulid": "^2.3.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/bin/cli.ts

@@ -0,0 +1,430 @@
+#!/usr/bin/env node
+/**
+ * CLI for Agent Orchestration
+ * 
+ * Commands:
+ *   init         - Creates AGENTS.md for cross-IDE/CLI compatibility
+ *   init-cursor  - Copies .cursor/rules/ for Cursor IDE
+ *   serve        - Run the MCP server (used by IDEs via npx)
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Path to the package root (dist/bin/cli.js -> ../../)
+const packageRoot = path.resolve(__dirname, '..', '..');
+
+function printUsage(): void {
+  console.log(`
+Agent Orchestration CLI
+
+Usage:
+  npx agent-orchestration init           Create AGENTS.md (works with any AI agent)
+  npx agent-orchestration init-cursor    Setup for Cursor IDE (.cursor/rules/)
+  npx agent-orchestration serve          Run the MCP server
+  npx agent-orchestration help           Show this help message
+
+Commands:
+  init          Creates AGENTS.md with full orchestration instructions.
+                Compatible with: OpenAI Codex, Google Jules, Cursor, Aider,
+                Windsurf, VS Code Copilot, and many more.
+
+  init-cursor   Sets up Cursor-specific rules in .cursor/rules/.
+                Also creates activeContext.md and updates .gitignore.
+
+  serve         Runs the MCP server. IDEs call this via their MCP config.
+                The server uses the current working directory as the project root.
+
+Example:
+  cd /path/to/my-project
+  npx agent-orchestration init
+`);
+}
+
+/**
+ * Generate the AGENTS.md content with full orchestration instructions
+ */
+function generateAgentsMd(): string {
+  return `# AGENTS.md
+
+This project uses **Agent Orchestration** for multi-agent coordination.
+
+## MCP Server Setup
+
+Add this to your IDE's MCP configuration:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "agent-orchestration": {
+      "command": "npx",
+      "args": ["-y", "agent-orchestration", "serve"],
+      "env": {
+        "MCP_ORCH_SYNC_CONTEXT": "true"
+      }
+    }
+  }
+}
+\`\`\`
+
+**Note**: Run from your project root. The server uses the current directory.
+
+---
+
+## First Action: Bootstrap
+
+Before doing any work, you MUST run:
+
+\`\`\`
+bootstrap
+\`\`\`
+
+This registers you with the orchestrator and shows:
+- Current project focus
+- Tasks assigned to you
+- Recent decisions
+
+---
+
+## If You Have a Specific Task
+
+If you were given a specific task to work on, run:
+
+\`\`\`
+claim_todo:
+  title: "<the task title>"
+\`\`\`
+
+This registers you AND claims the task in one call.
+
+---
+
+## Available Tools
+
+### Session Management
+| Tool | Description |
+|------|-------------|
+| \`bootstrap\` | Initialize session: register, get focus, tasks, decisions |
+| \`claim_todo\` | Register + claim a task in one call |
+| \`agent_whoami\` | Get your current agent info |
+
+### Agent Coordination
+| Tool | Description |
+|------|-------------|
+| \`agent_register\` | Register with the orchestration system |
+| \`agent_heartbeat\` | Send heartbeat to indicate you're active |
+| \`agent_list\` | List all registered agents |
+| \`agent_unregister\` | Unregister (releases all locks) |
+
+### Shared Memory
+| Tool | Description |
+|------|-------------|
+| \`memory_set\` | Store a value in shared memory |
+| \`memory_get\` | Retrieve a value from shared memory |
+| \`memory_list\` | List all keys in a namespace |
+| \`memory_delete\` | Delete a value from shared memory |
+
+### Task Management
+| Tool | Description |
+|------|-------------|
+| \`task_create\` | Create a new task |
+| \`task_claim\` | Claim a task to work on |
+| \`task_update\` | Update task status or progress |
+| \`task_complete\` | Mark task as completed |
+| \`task_list\` | List tasks with filters |
+| \`is_my_turn\` | Check if work is available |
+
+### Resource Locking
+| Tool | Description |
+|------|-------------|
+| \`lock_acquire\` | Acquire a lock on a file/resource |
+| \`lock_release\` | Release a held lock |
+| \`lock_check\` | Check if a resource is locked |
+| \`coordination_status\` | Get overall system status |
+
+---
+
+## Workflow for Main Orchestrator
+
+\`\`\`
+1. bootstrap                          # Start session
+2. memory_set current_focus "..."     # Set project focus
+3. task_create "Feature X"            # Create tasks
+4. coordination_status                # Monitor progress
+\`\`\`
+
+## Workflow for Sub-Agents
+
+\`\`\`
+1. claim_todo "Feature X"             # Register + claim
+2. lock_acquire "src/feature.ts"      # Lock before editing
+3. [do the work]
+4. task_complete <task_id> "Done"     # Complete the task
+5. agent_unregister                   # Clean up
+\`\`\`
+
+---
+
+## Memory Namespaces
+
+Use these namespaces for organization:
+
+| Namespace | Purpose | Example Keys |
+|-----------|---------|--------------|
+| \`context\` | Current state and focus | \`current_focus\`, \`current_branch\` |
+| \`decisions\` | Architectural decisions | \`auth_strategy\`, \`db_choice\` |
+| \`findings\` | Analysis results | \`perf_issues\`, \`security_audit\` |
+| \`blockers\` | Issues blocking progress | \`api_down\`, \`missing_deps\` |
+
+---
+
+## Coordination Patterns
+
+### Before Editing Files
+\`\`\`
+lock_check: { resource: "src/file.ts" }
+lock_acquire: { resource: "src/file.ts", reason: "Implementing feature" }
+\`\`\`
+
+### After Editing Files
+\`\`\`
+lock_release: { resource: "src/file.ts" }
+\`\`\`
+
+### Check Before Major Work
+\`\`\`
+is_my_turn
+\`\`\`
+
+### When Done
+\`\`\`
+task_complete: { task_id: "<id>", output: "Summary of changes" }
+agent_unregister
+\`\`\`
+
+---
+
+## Reference activeContext.md
+
+Check \`activeContext.md\` for current project state - it's auto-updated.
+`;
+}
+
+/**
+ * Run the MCP server
+ */
+async function runServer(): Promise<void> {
+  // Import and start the server
+  const { startServer } = await import('../index.js');
+  await startServer();
+}
+
+/**
+ * Initialize with AGENTS.md (cross-IDE compatible)
+ */
+function initAgentsMd(): void {
+  const cwd = process.cwd();
+  console.log(`\nInitializing Agent Orchestration (AGENTS.md) in: ${cwd}\n`);
+
+  // 1. Create AGENTS.md
+  const agentsMdPath = path.join(cwd, 'AGENTS.md');
+  if (!fs.existsSync(agentsMdPath)) {
+    fs.writeFileSync(agentsMdPath, generateAgentsMd());
+    console.log('✓ Created AGENTS.md');
+  } else {
+    console.log('✓ AGENTS.md already exists (not overwritten)');
+  }
+
+  // 2. Update .gitignore
+  updateGitignore(cwd);
+
+  // 3. Create activeContext.md
+  createActiveContext(cwd);
+
+  // 4. Print success message
+  console.log(`
+✓ Setup complete!
+
+AGENTS.md is now ready. This works with:
+  - OpenAI Codex
+  - Google Jules  
+  - Cursor
+  - Aider
+  - Windsurf
+  - VS Code Copilot
+  - And many more!
+
+MCP Server Config (add to your IDE):
+
+{
+  "mcpServers": {
+    "agent-orchestration": {
+      "command": "npx",
+      "args": ["-y", "agent-orchestration", "serve"],
+      "env": {
+        "MCP_ORCH_SYNC_CONTEXT": "true"
+      }
+    }
+  }
+}
+
+Then restart your IDE to activate the MCP server.
+`);
+}
+
+/**
+ * Initialize for Cursor IDE (copies .cursor/rules/)
+ */
+function initCursor(): void {
+  const cwd = process.cwd();
+  console.log(`\nInitializing Agent Orchestration for Cursor in: ${cwd}\n`);
+
+  // 1. Copy Cursor rules
+  const rulesSourceDir = path.join(packageRoot, '.cursor', 'rules');
+  const rulesTargetDir = path.join(cwd, '.cursor', 'rules');
+
+  if (fs.existsSync(rulesSourceDir)) {
+    fs.mkdirSync(rulesTargetDir, { recursive: true });
+
+    const ruleFiles = fs.readdirSync(rulesSourceDir);
+    for (const file of ruleFiles) {
+      if (file.endsWith('.mdc')) {
+        const source = path.join(rulesSourceDir, file);
+        const target = path.join(rulesTargetDir, file);
+        fs.copyFileSync(source, target);
+        console.log(`✓ Copied rule: .cursor/rules/${file}`);
+      }
+    }
+  } else {
+    console.log('⚠ Cursor rules not found in package. Skipping rule copy.');
+  }
+
+  // 2. Update .gitignore
+  updateGitignore(cwd);
+
+  // 3. Create activeContext.md
+  createActiveContext(cwd);
+
+  // 4. Print MCP config
+  console.log(`
+✓ Cursor setup complete!
+
+Add this to your ~/.cursor/mcp.json:
+
+{
+  "mcpServers": {
+    "agent-orchestration": {
+      "command": "npx",
+      "args": ["-y", "agent-orchestration", "serve"],
+      "env": {
+        "MCP_ORCH_SYNC_CONTEXT": "true"
+      }
+    }
+  }
+}
+
+Then restart Cursor to activate the MCP server.
+`);
+}
+
+/**
+ * Update .gitignore with orchestration entries
+ */
+function updateGitignore(cwd: string): void {
+  const gitignorePath = path.join(cwd, '.gitignore');
+  const ignoreEntry = '.agent-orchestration/';
+
+  let gitignoreContent = '';
+  if (fs.existsSync(gitignorePath)) {
+    gitignoreContent = fs.readFileSync(gitignorePath, 'utf-8');
+  }
+
+  if (!gitignoreContent.includes(ignoreEntry)) {
+    const newContent =
+      gitignoreContent.trim() + '\n\n# Agent Orchestration\n' + ignoreEntry + '\n';
+    fs.writeFileSync(gitignorePath, newContent);
+    console.log('✓ Added .agent-orchestration/ to .gitignore');
+  } else {
+    console.log('✓ .gitignore already contains .agent-orchestration/');
+  }
+}
+
+/**
+ * Create activeContext.md template
+ */
+function createActiveContext(cwd: string): void {
+  const activeContextPath = path.join(cwd, 'activeContext.md');
+  if (!fs.existsSync(activeContextPath)) {
+    const template = `# Active Context
+
+_Last updated: Initial setup_
+
+## Current Focus
+
+_Not set. Use \`memory_set\` with key "current_focus" in namespace "context"._
+
+## Active Agents
+
+_No active agents. Start the MCP server and register agents to see them here._
+
+## In Progress
+
+_No tasks in progress._
+
+## Pending Tasks
+
+_No pending tasks. Create tasks using the \`task_create\` tool._
+
+## Recent Decisions
+
+_No decisions recorded. Use \`memory_set\` in namespace "decisions" to record decisions._
+
+## Context Notes
+
+_No additional context._
+
+---
+
+_This file is auto-generated by the Agent Orchestration server._
+_Edit shared memory to update this context._
+`;
+    fs.writeFileSync(activeContextPath, template);
+    console.log('✓ Created activeContext.md');
+  } else {
+    console.log('✓ activeContext.md already exists');
+  }
+}
+
+// Main
+const args = process.argv.slice(2);
+const command = args[0];
+
+switch (command) {
+  case 'init':
+    initAgentsMd();
+    break;
+  case 'init-cursor':
+    initCursor();
+    break;
+  case 'serve':
+    runServer().catch((err) => {
+      console.error('Server error:', err);
+      process.exit(1);
+    });
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    printUsage();
+    break;
+  default:
+    if (command) {
+      console.error(`Unknown command: ${command}`);
+    }
+    printUsage();
+    process.exit(command ? 1 : 0);
+}