gm-orchestrator 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vachick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+# gm-orchestrator
+
+Autonomous AI sprint runner for [GraphMemory](https://github.com/graph-memory/graphmemory).
+
+Spawns Claude Code sessions to work through your tasks automatically — one task at a time,
+fresh context each session, no token bleed. You define the work in GraphMemory, hit Run, go do something else.
+
+```bash
+npm install -g gm-orchestrator
+gm-orchestrator
+```
+
+→ Opens `http://localhost:4242` in your browser. That's it.
+
+---
+
+## How it works
+
+```
+gm-orchestrator
+      ↓
+Reads tasks from GraphMemory (priority order, blockers respected)
+      ↓
+For each task:
+  spawn → claude --print "<task prompt>"
+  wait  → Claude calls tasks_move("done") when finished
+  next  → kill session, start fresh, repeat
+      ↓
+Notify you when sprint/epic is complete
+```
+
+Each Claude Code session gets a clean context window. No accumulation, no drift.
+
+---
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **[GraphMemory](https://github.com/graph-memory/graphmemory)** running locally (`graphmemory serve`)
+- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** installed (`npm install -g @anthropic-ai/claude-code`)
+- Claude Code connected to your GraphMemory instance via MCP
+
+---
+
+## Installation
+
+```bash
+npm install -g gm-orchestrator
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Start GraphMemory in your project
+cd /path/to/your-project
+graphmemory serve
+
+# 2. Start gm-orchestrator
+gm-orchestrator
+# → opens http://localhost:4242
+```
+
+On first run, the wizard walks you through selecting a project and configuring permissions.
+
+---
+
+## Browser UI
+
+The primary interface. Opens automatically at `http://localhost:4242`.
+
+### Dashboard
+Overview of your project: task queue sorted by priority, epics, done count for today.
+One click to start a sprint or select an epic.
+
+### Sprint Runner
+Live view while work is in progress:
+- Task queue with status (queued / running / done / cancelled)
+- Real-time Claude log stream — see exactly what Claude is doing
+- Progress bar and elapsed time per task
+- Stop button
+
+### Settings
+- GraphMemory connection (URL, project ID, API key)
+- Permissions — what Claude is allowed to do per session
+- Notifications — Telegram, webhook, desktop
+- Timeout and retry configuration
+
+---
+
+## Permissions
+
+Control what Claude Code can do in each session:
+
+```json
+{
+  "permissions": {
+    "writeFiles": true,
+    "runCommands": ["npm test", "npm run build", "git add", "git commit"],
+    "blockedCommands": ["git push", "npm publish"]
+  }
+}
+```
+
+Translates directly to `--allowedTools` flags passed to `claude --print`.
+Claude cannot run blocked commands even if it tries.
+
+---
+
+## Notifications
+
+Get notified when work is done — useful for long sprints.
+
+**Telegram:**
+```json
+{
+  "notifications": {
+    "telegram": {
+      "botToken": "...",
+      "chatId": "..."
+    },
+    "on": ["sprint_complete", "task_failed"]
+  }
+}
+```
+
+**Webhook** (generic POST — works with Slack, Discord, custom endpoints):
+```json
+{
+  "notifications": {
+    "webhook": {
+      "url": "https://your-endpoint.com/notify",
+      "headers": { "Authorization": "Bearer ..." }
+    }
+  }
+}
+```
+
+**Desktop** — native OS notification (macOS, Linux, Windows).
+
+---
+
+## Configuration
+
+Resolved in order — later sources override earlier:
+
+1. Defaults
+2. `.gm-orchestrator.json` in current directory
+3. Environment variables
+4. CLI flags
+
+### Config file
+
+```json
+{
+  "baseUrl": "http://localhost:3000",
+  "projectId": "my-app",
+  "apiKey": "",
+  "timeoutMs": 900000,
+  "pauseMs": 2000,
+  "maxRetries": 1,
+  "claudeArgs": [],
+  "permissions": {
+    "writeFiles": true,
+    "runCommands": ["npm test", "git commit"],
+    "blockedCommands": ["git push", "npm publish"]
+  },
+  "notifications": {
+    "telegram": {
+      "botToken": "",
+      "chatId": ""
+    }
+  }
+}
+```
+
+### Environment variables
+
+| Variable        | Maps to      |
+|-----------------|--------------|
+| `GM_BASE_URL`   | `baseUrl`    |
+| `GM_PROJECT_ID` | `projectId`  |
+| `GM_API_KEY`    | `apiKey`     |
+| `GM_TIMEOUT_MS` | `timeoutMs`  |
+| `GM_PORT`       | server port (default: 4242) |
+
+### All config options
+
+| Option       | Type       | Default           | Description                      |
+|--------------|------------|-------------------|----------------------------------|
+| `baseUrl`    | `string`   | `http://localhost:3000` | GraphMemory server URL     |
+| `projectId`  | `string`   | *(required)*      | GraphMemory project ID           |
+| `apiKey`     | `string`   |                   | API key (if GM auth is enabled)  |
+| `timeoutMs`  | `number`   | `900000` (15 min) | Per-task timeout in ms           |
+| `pauseMs`    | `number`   | `2000`            | Pause between tasks              |
+| `maxRetries` | `number`   | `1`               | Retries on timeout/error         |
+| `claudeArgs` | `string[]` | `[]`              | Extra args for `claude --print`  |
+| `dryRun`     | `boolean`  | `false`           | Preview prompts, don't run       |
+
+---
+
+## CLI (advanced)
+
+The browser UI is the primary interface. CLI commands are available for scripting and CI.
+
+```bash
+# Start UI (default)
+gm-orchestrator
+
+# Run sprint headless (no browser)
+gm-orchestrator sprint --project my-app
+
+# Run specific epic headless
+gm-orchestrator epic <epicId> --project my-app
+
+# Check task counts
+gm-orchestrator status --project my-app
+
+# Preview prompts without spawning Claude
+gm-orchestrator sprint --project my-app --dry-run
+```
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--project`, `-p` | GraphMemory project ID | env / config |
+| `--tag`, `-t` | Filter tasks by tag | |
+| `--timeout <min>` | Per-task timeout in minutes | 15 |
+| `--retries <n>` | Retries on timeout/error | 1 |
+| `--dry-run` | Preview prompts, don't spawn Claude | |
+| `--config` | Print resolved config and exit | |
+
+---
+
+## Programmatic API
+
+```ts
+import {
+  runSprint,
+  runEpic,
+  GraphMemoryClient,
+  ClaudeRunner,
+  TaskPoller,
+  consoleLogger,
+  loadConfig,
+} from 'gm-orchestrator';
+
+const config = loadConfig({ projectId: 'my-app' });
+const gm = new GraphMemoryClient({ baseUrl: config.baseUrl, projectId: config.projectId });
+
+const ports = {
+  gm,
+  runner: new ClaudeRunner(),
+  poller: new TaskPoller(gm),
+  logger: consoleLogger,
+};
+
+await runSprint(ports, config);
+await runEpic('epic-id', ports, config);
+```
+
+### Core functions
+- **`runSprint(ports, config)`** — run all todo/in_progress tasks by priority
+- **`runEpic(epicId, ports, config)`** — run all tasks in an epic
+- **`buildPrompt(task)`** — generate autonomous-execution prompt for a task
+
+### Utilities
+- **`sortByPriority(tasks)`** — sort by priority order
+- **`isTerminal(status)`** — check if status is done/cancelled
+- **`areBlockersResolved(task)`** — check all blockers are done
+- **`loadConfig(overrides?)`** — load and merge config
+- **`validateConfig(config)`** — validate (throws on missing projectId)
+
+### Infrastructure
+- **`GraphMemoryClient`** — GraphMemory REST client
+- **`ClaudeRunner`** — spawns claude --print sessions
+- **`TaskPoller`** — polls task status until completion
+- **`consoleLogger` / `silentLogger`** — logger implementations
+
+### Types
+`Task`, `Epic`, `TaskStatus`, `TaskPriority`, `EpicStatus`, `TaskRef`,
+`OrchestratorConfig`, `TaskRunResult`, `SprintStats`,
+`GraphMemoryPort`, `ClaudeRunnerPort`, `TaskPollerPort`, `Logger`
+
+---
+
+## License
+
+MIT

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+import { GraphMemoryClient } from '../infra/gm-client.js';
+import { ClaudeRunner } from '../infra/claude-runner.js';
+import { TaskPoller } from '../infra/task-poller.js';
+import { consoleLogger } from '../infra/logger.js';
+import { loadConfig, validateConfig, saveConfig } from '../infra/config.js';
+import { runSprint, runEpic } from '../core/orchestrator.js';
+import { createServer } from '../server/index.js';
+import { createApiRouter } from '../server/api.js';
+import { createWebSocketServer } from '../server/ws.js';
+import { createRunnerService } from '../server/runner-service.js';
+import { discoverServers } from '../infra/gm-discovery.js';
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const result = {
+        command: null,
+        epicId: null,
+        overrides: {},
+        printConfig: false,
+        headless: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (!result.command && !a.startsWith('-')) {
+            result.command = a;
+            continue;
+        }
+        if (result.command === 'epic' && !result.epicId && !a.startsWith('-')) {
+            result.epicId = a;
+            continue;
+        }
+        switch (a) {
+            case '--dry-run':
+                result.overrides.dryRun = true;
+                break;
+            case '--config':
+                result.printConfig = true;
+                break;
+            case '--headless':
+                result.headless = true;
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+                break;
+            case '--project':
+            case '-p':
+                result.overrides.projectId = args[++i];
+                break;
+            case '--tag':
+            case '-t':
+                result.overrides.tag = args[++i];
+                break;
+            case '--timeout':
+                result.overrides.timeoutMs = Number(args[++i]) * 60_000;
+                break;
+            case '--retries':
+                result.overrides.maxRetries = Number(args[++i]);
+                break;
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+gm-orchestrator — tokenless Claude Code orchestrator for GraphMemory
+
+USAGE
+  gm-orchestrator [command] [options]
+
+COMMANDS
+  serve                Start the web UI + API server on :4242 (default)
+  sprint               Run all todo/in_progress tasks sorted by priority
+  epic <epicId>        Run all tasks in an epic
+  status               Show task counts (no Claude sessions spawned)
+
+OPTIONS
+  --project, -p <id>   GraphMemory project ID  (or GM_PROJECT_ID env)
+  --tag, -t <tag>      Filter tasks by tag
+  --timeout <min>      Per-task timeout in minutes (default: 15)
+  --retries <n>        Retries on timeout/error (default: 1)
+  --dry-run            Preview prompts, don't spawn Claude
+  --headless           Run in CLI-only mode (skip server, require command)
+  --config             Print resolved config and exit
+
+CONFIG FILE  (.gm-orchestrator.json)
+  {
+    "baseUrl": "http://localhost:3000",
+    "projectId": "my-app",
+    "apiKey": "mgm-key-...",
+    "timeoutMs": 900000,
+    "maxRetries": 1,
+    "claudeArgs": []
+  }
+
+ENV VARS
+  GM_BASE_URL / GM_PROJECT_ID / GM_API_KEY / GM_TIMEOUT_MS
+`);
+}
+// ── Main ──────────────────────────────────────────────────────────────────
+async function main() {
+    const { command, epicId, overrides, printConfig, headless } = parseArgs(process.argv);
+    const config = loadConfig(overrides);
+    if (printConfig) {
+        const display = { ...config, apiKey: config.apiKey ? '***' : undefined };
+        console.log(JSON.stringify(display, null, 2));
+        return;
+    }
+    if (command === 'help') {
+        printHelp();
+        return;
+    }
+    // Default to server mode when no command given (unless --headless)
+    const effectiveCommand = command ?? (headless ? null : 'serve');
+    if (!effectiveCommand) {
+        printHelp();
+        return;
+    }
+    if (effectiveCommand === 'serve') {
+        const port = Number(process.env['GM_PORT']) || 4242;
+        consoleLogger.info(`gm-orchestrator v1.0.0 → http://localhost:${port}`);
+        // Server mode doesn't require projectId upfront — it's set via the UI
+        const { app, start, mountStaticUI } = createServer({ logger: consoleLogger });
+        const gmClient = new GraphMemoryClient({
+            baseUrl: config.baseUrl,
+            projectId: config.projectId || 'default',
+        });
+        // Create a no-op WS bus for now — replaced after server starts
+        const wsBusHolder = {
+            current: { broadcast() { }, get clientCount() { return 0; }, close: async () => { } },
+        };
+        const runner = createRunnerService({
+            config,
+            gm: gmClient,
+            runner: new ClaudeRunner(),
+            poller: new TaskPoller(gmClient),
+            logger: consoleLogger,
+            wsBus: { broadcast(e) { wsBusHolder.current.broadcast(e); }, get clientCount() { return wsBusHolder.current.clientCount; }, close() { return wsBusHolder.current.close(); } },
+        });
+        const apiRouter = createApiRouter({
+            config,
+            logger: consoleLogger,
+            gmDiscovery: { discoverServers },
+            gmClient,
+            runner,
+            saveConfig: (partial) => saveConfig(partial),
+        });
+        // Mount API routes before the catch-all static handler
+        app.use(apiRouter);
+        mountStaticUI();
+        const server = await start();
+        wsBusHolder.current = createWebSocketServer(server);
+        return;
+    }
+    validateConfig(config);
+    const gm = new GraphMemoryClient({
+        baseUrl: config.baseUrl,
+        projectId: config.projectId,
+        ...(config.apiKey !== undefined && { apiKey: config.apiKey }),
+    });
+    const ports = {
+        gm,
+        runner: new ClaudeRunner(),
+        poller: new TaskPoller(gm),
+        logger: consoleLogger,
+    };
+    if (effectiveCommand === 'status') {
+        const [todo, inProgress, done] = await Promise.all([
+            gm.listTasks({ status: 'todo' }),
+            gm.listTasks({ status: 'in_progress' }),
+            gm.listTasks({ status: 'done' }),
+        ]);
+        const epics = await gm.listEpics().catch(() => []);
+        consoleLogger.section(`Status — ${config.projectId}`);
+        console.log(`  todo:        ${todo.length}`);
+        console.log(`  in_progress: ${inProgress.length}`);
+        console.log(`  done:        ${done.length}`);
+        console.log(`  epics:       ${epics.length}`);
+        if (todo.length) {
+            consoleLogger.section('Next up');
+            todo.slice(0, 5).forEach((t) => consoleLogger.task(t));
+            if (todo.length > 5)
+                console.log(`  ... and ${todo.length - 5} more`);
+        }
+        return;
+    }
+    if (effectiveCommand === 'sprint') {
+        await runSprint(ports, config);
+        return;
+    }
+    if (effectiveCommand === 'epic') {
+        if (!epicId) {
+            consoleLogger.error('epic command requires an ID: gm-orchestrator epic <epicId>');
+            process.exit(1);
+        }
+        await runEpic(epicId, ports, config);
+        return;
+    }
+    consoleLogger.error(`Unknown command: ${effectiveCommand}`);
+    printHelp();
+    process.exit(1);
+}
+process.on('SIGINT', () => {
+    console.log('');
+    consoleLogger.warn('Interrupted — current Claude session may still be running');
+    consoleLogger.skip('Check GraphMemory UI for task status before resuming');
+    process.exit(0);
+});
+process.on('unhandledRejection', (err) => {
+    consoleLogger.error(`Unhandled: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+void main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,23 @@
+import type { GraphMemoryPort, ClaudeRunnerPort, TaskPollerPort, OrchestratorConfig, SprintStats } from './types.js';
+import type { Logger } from '../infra/logger.js';
+interface Ports {
+    gm: GraphMemoryPort;
+    runner: ClaudeRunnerPort;
+    poller: TaskPollerPort;
+    logger: Logger;
+}
+/**
+ * Orchestrates a full sprint: runs all todo/in_progress tasks in priority
+ * order, respecting blockers, retrying on failure, until none remain.
+ *
+ * Pure orchestration logic — all side effects go through injected ports.
+ * This makes the core fully testable without spawning Claude or hitting GM.
+ */
+export declare function runSprint(ports: Ports, config: OrchestratorConfig): Promise<SprintStats>;
+/**
+ * Runs all tasks belonging to an epic, in priority order with blocker checks.
+ * Marks the epic done when all tasks complete.
+ */
+export declare function runEpic(epicId: string, ports: Ports, config: OrchestratorConfig): Promise<SprintStats>;
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,WAAW,EAGZ,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,UAAU,KAAK;IACb,EAAE,EAAE,eAAe,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAiDtB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAyDtB"}