gm-orchestrator 0.2.0

package/dist/core/orchestrator.js

@@ -0,0 +1,173 @@
+import { sortByPriority, areBlockersResolved } from './task-utils.js';
+/**
+ * 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 async function runSprint(ports, config) {
+    const { gm, logger } = ports;
+    const startTime = Date.now();
+    const stats = { done: 0, cancelled: 0, retried: 0, errors: 0, skipped: 0, durationMs: 0 };
+    const failedIds = new Set();
+    const retryCounts = new Map();
+    logger.section(`Sprint — project: ${config.projectId}${config.tag ? `  tag: ${config.tag}` : ''}`);
+    while (true) {
+        const tagFilter = config.tag !== undefined ? { tag: config.tag } : {};
+        const [inProgress, todo] = await Promise.all([
+            gm.listTasks({ status: 'in_progress', ...tagFilter }),
+            gm.listTasks({ status: 'todo', ...tagFilter }),
+        ]);
+        // in_progress first (resuming), then todo sorted by priority
+        const queue = [
+            ...sortByPriority(inProgress),
+            ...sortByPriority(todo),
+        ].filter((t) => !failedIds.has(t.id));
+        if (!queue.length) {
+            logger.section('Sprint complete');
+            stats.durationMs = Date.now() - startTime;
+            logStats(logger, stats);
+            return stats;
+        }
+        const next = findNextRunnable(queue, logger);
+        if (!next) {
+            logger.warn(`${queue.length} tasks remain but all are blocked — stopping`);
+            queue.forEach((t) => logger.skip(`  blocked: ${t.title} (${t.id})`));
+            stats.durationMs = Date.now() - startTime;
+            logStats(logger, stats);
+            return stats;
+        }
+        const result = await runOneTask(next, ports, config);
+        await handleResult(result, next, {
+            gm, logger, stats, failedIds, retryCounts,
+            maxRetries: config.maxRetries,
+        });
+        await sleep(config.pauseMs);
+    }
+}
+/**
+ * Runs all tasks belonging to an epic, in priority order with blocker checks.
+ * Marks the epic done when all tasks complete.
+ */
+export async function runEpic(epicId, ports, config) {
+    const { gm, logger } = ports;
+    const startTime = Date.now();
+    const stats = { done: 0, cancelled: 0, retried: 0, errors: 0, skipped: 0, durationMs: 0 };
+    const epic = await gm.getEpic(epicId);
+    logger.section(`Epic: "${epic.title}" (${epicId})`);
+    logger.info(`Priority: ${epic.priority}  Status: ${epic.status}`);
+    const epicTaskIds = new Set((epic.tasks ?? []).map((t) => t.id));
+    const failedIds = new Set();
+    const retryCounts = new Map();
+    while (true) {
+        // Fetch fresh task data for all epic tasks
+        const allTasks = await Promise.all([...epicTaskIds].map((id) => gm.getTask(id).catch(() => null)));
+        const queue = sortByPriority(allTasks.filter((t) => t !== null &&
+            !['done', 'cancelled'].includes(t.status) &&
+            !failedIds.has(t.id)));
+        if (!queue.length) {
+            const allDone = allTasks.every((t) => t?.status === 'done');
+            if (allDone) {
+                logger.success('All epic tasks done — marking epic complete');
+                await gm.moveEpic(epicId, 'done');
+            }
+            logger.section('Epic complete');
+            stats.durationMs = Date.now() - startTime;
+            logStats(logger, stats);
+            return stats;
+        }
+        const next = findNextRunnable(queue, logger);
+        if (!next) {
+            logger.warn('All remaining epic tasks are blocked — stopping');
+            stats.durationMs = Date.now() - startTime;
+            logStats(logger, stats);
+            return stats;
+        }
+        const result = await runOneTask(next, ports, config);
+        await handleResult(result, next, {
+            gm, logger, stats, failedIds, retryCounts,
+            maxRetries: config.maxRetries,
+        });
+        await sleep(config.pauseMs);
+    }
+}
+// ── Internal ──────────────────────────────────────────────────────────────
+function findNextRunnable(queue, logger) {
+    for (const task of queue) {
+        if (areBlockersResolved(task))
+            return task;
+        logger.skip(`blocked: "${task.title}"`);
+    }
+    return null;
+}
+async function runOneTask(task, { gm, runner, poller, logger }, config) {
+    logger.task(task);
+    // Mark in_progress (idempotent)
+    if (task.status !== 'in_progress') {
+        await gm.moveTask(task.id, 'in_progress').catch((e) => {
+            logger.warn(`Could not mark in_progress: ${String(e)}`);
+        });
+    }
+    if (config.dryRun) {
+        logger.warn('[DRY RUN] Would spawn claude --print <prompt>');
+        await gm.moveTask(task.id, 'done').catch(() => { });
+        return 'dry_run';
+    }
+    // Spawn Claude Code session (fire and forget — poller drives completion)
+    const sessionPromise = runner.run(task, config).catch((e) => {
+        logger.warn(`Claude session error: ${String(e)}`);
+    });
+    // Poll GraphMemory until task reaches terminal state
+    const pollResult = await poller.waitForCompletion(task.id, {
+        timeoutMs: config.timeoutMs,
+    });
+    await sessionPromise; // let process clean up
+    if (pollResult === 'timeout') {
+        logger.error(`Timeout: "${task.title}" (${task.id})`);
+        return 'timeout';
+    }
+    if (pollResult === 'done') {
+        logger.success(`Done: "${task.title}"`);
+    }
+    else {
+        logger.warn(`Cancelled: "${task.title}"`);
+    }
+    return pollResult;
+}
+async function handleResult(result, task, ctx) {
+    const { gm, logger, stats, failedIds, retryCounts, maxRetries } = ctx;
+    if (result === 'done' || result === 'dry_run') {
+        stats.done++;
+        return;
+    }
+    if (result === 'cancelled') {
+        stats.cancelled++;
+        failedIds.add(task.id);
+        return;
+    }
+    // timeout | error
+    const retries = retryCounts.get(task.id) ?? 0;
+    if (retries < maxRetries) {
+        retryCounts.set(task.id, retries + 1);
+        stats.retried++;
+        logger.warn(`Retrying (${retries + 1}/${maxRetries}): ${task.id}`);
+        await gm.moveTask(task.id, 'todo').catch(() => { });
+    }
+    else {
+        stats.errors++;
+        failedIds.add(task.id);
+        logger.error(`Giving up on: ${task.id}`);
+        await gm.moveTask(task.id, 'cancelled').catch(() => { });
+    }
+}
+function logStats(logger, stats) {
+    const secs = Math.round(stats.durationMs / 1000);
+    logger.info(`✓ ${stats.done} done  ✗ ${stats.cancelled} cancelled  ` +
+        `↺ ${stats.retried} retried  ⚠ ${stats.errors} errors  ` +
+        `⏱ ${secs}s`);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/core/permissions.d.ts

@@ -0,0 +1,18 @@
+import type { Permissions } from './types.js';
+/**
+ * Translates user permission config into Claude Code --allowedTools flags.
+ *
+ * Rules:
+ * - "Read" is always included (cannot be disabled)
+ * - "Write" and "Edit" are included only when writeFiles is true
+ * - Each runCommands entry becomes "Bash(<command>)"
+ * - A command appearing in both runCommands and blockedCommands throws
+ * - mcpTools controls MCP tool inclusion: "all" | "none" | string[]
+ */
+export declare function buildAllowedTools(permissions: Permissions): string[];
+/**
+ * Returns true if the command is allowed, false if blocked.
+ * Uses substring matching against the blockedCommands list.
+ */
+export declare function validateCommand(cmd: string, permissions: Permissions): boolean;
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/core/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CA+BpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAI9E"}

package/dist/core/permissions.js

@@ -0,0 +1,42 @@
+/**
+ * Translates user permission config into Claude Code --allowedTools flags.
+ *
+ * Rules:
+ * - "Read" is always included (cannot be disabled)
+ * - "Write" and "Edit" are included only when writeFiles is true
+ * - Each runCommands entry becomes "Bash(<command>)"
+ * - A command appearing in both runCommands and blockedCommands throws
+ * - mcpTools controls MCP tool inclusion: "all" | "none" | string[]
+ */
+export function buildAllowedTools(permissions) {
+    // Validate: no command may appear in both runCommands and blockedCommands
+    const conflicts = permissions.runCommands.filter((cmd) => permissions.blockedCommands.some((blocked) => cmd.includes(blocked) || blocked.includes(cmd)));
+    if (conflicts.length > 0) {
+        throw new Error(`Permission conflict: commands appear in both runCommands and blockedCommands: ${conflicts.join(', ')}`);
+    }
+    const tools = ['Read'];
+    if (permissions.writeFiles) {
+        tools.push('Write', 'Edit');
+    }
+    for (const cmd of permissions.runCommands) {
+        tools.push(`Bash(${cmd})`);
+    }
+    // MCP tools
+    if (permissions.mcpTools === 'all') {
+        tools.push('mcp__*');
+    }
+    else if (permissions.mcpTools !== 'none') {
+        for (const tool of permissions.mcpTools) {
+            tools.push(tool);
+        }
+    }
+    return tools;
+}
+/**
+ * Returns true if the command is allowed, false if blocked.
+ * Uses substring matching against the blockedCommands list.
+ */
+export function validateCommand(cmd, permissions) {
+    return !permissions.blockedCommands.some((blocked) => cmd.includes(blocked));
+}
+//# sourceMappingURL=permissions.js.map

package/dist/core/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/core/permissions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,0EAA0E;IAC1E,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACvD,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAC9F,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iFAAiF,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,MAAM,CAAC,CAAC;IAEjC,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,YAAY;IACZ,IAAI,WAAW,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,WAAW,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,WAAwB;IACnE,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,CACtC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CACnC,CAAC;AACJ,CAAC"}

package/dist/core/prompt-builder.d.ts

@@ -0,0 +1,25 @@
+import type { Task, OrchestratorConfig } from './types.js';
+/**
+ * Builds a self-contained, autonomous prompt for a single Claude Code session.
+ *
+ * AI-first design principles applied here:
+ *
+ * 1. CONTEXT FRONT-LOADING — everything Claude needs is in the prompt.
+ *    No back-and-forth, no clarifying questions possible.
+ *
+ * 2. EXPLICIT CONTRACT — the only output we care about is tasks_move().
+ *    Claude doesn't need to write to stdout, return JSON, or signal in any
+ *    other way. This is the single integration point.
+ *
+ * 3. TOOL-FIRST INSTRUCTIONS — Claude is told to use GraphMemory tools
+ *    (tasks_get, skills_recall) before doing any work. This leverages the
+ *    existing knowledge graph instead of reasoning from scratch.
+ *
+ * 4. FAILURE MODES ARE EXPLICIT — Claude knows what to do when blocked,
+ *    impossible, or ambiguous. No hanging sessions.
+ *
+ * 5. MINIMAL PROMPT — only what's needed. The description might be empty
+ *    deliberately (Claude fetches full context via tasks_get). Don't pad.
+ */
+export declare function buildPrompt(task: Task, config: Pick<OrchestratorConfig, 'projectId'>): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/core/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/core/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,MAAM,CAoC7F"}

package/dist/core/prompt-builder.js

@@ -0,0 +1,84 @@
+/**
+ * Builds a self-contained, autonomous prompt for a single Claude Code session.
+ *
+ * AI-first design principles applied here:
+ *
+ * 1. CONTEXT FRONT-LOADING — everything Claude needs is in the prompt.
+ *    No back-and-forth, no clarifying questions possible.
+ *
+ * 2. EXPLICIT CONTRACT — the only output we care about is tasks_move().
+ *    Claude doesn't need to write to stdout, return JSON, or signal in any
+ *    other way. This is the single integration point.
+ *
+ * 3. TOOL-FIRST INSTRUCTIONS — Claude is told to use GraphMemory tools
+ *    (tasks_get, skills_recall) before doing any work. This leverages the
+ *    existing knowledge graph instead of reasoning from scratch.
+ *
+ * 4. FAILURE MODES ARE EXPLICIT — Claude knows what to do when blocked,
+ *    impossible, or ambiguous. No hanging sessions.
+ *
+ * 5. MINIMAL PROMPT — only what's needed. The description might be empty
+ *    deliberately (Claude fetches full context via tasks_get). Don't pad.
+ */
+export function buildPrompt(task, config) {
+    const sections = [];
+    sections.push(`# Autonomous Task Execution`);
+    sections.push(`You are running as an autonomous agent inside an orchestrator pipeline.\n` +
+        `Complete the task below WITHOUT asking for confirmation or clarification.\n` +
+        `The orchestrator has no stdin — it only watches GraphMemory task status.`);
+    sections.push(`## Task`);
+    sections.push(formatTaskHeader(task));
+    sections.push(`## Execution Protocol`);
+    sections.push(buildProtocol(task));
+    if (task.blockedBy?.length) {
+        sections.push(`## Resolved Blockers (for context)`);
+        sections.push(task.blockedBy.map((b) => `- ${b.title} (${b.id}) ✓`).join('\n'));
+    }
+    if (task.subtasks?.length) {
+        sections.push(`## Subtasks`);
+        sections.push(task.subtasks.map((s) => `- [${s.status === 'done' ? 'x' : ' '}] ${s.title} — \`${s.id}\``).join('\n'));
+    }
+    sections.push(`## Completion Signal`);
+    sections.push(`When done:      \`tasks_move("${task.id}", "done")\`\n` +
+        `When cancelled: \`tasks_move("${task.id}", "cancelled")\` + update description with reason\n\n` +
+        `**This is the only output the orchestrator reads. Do not skip it.**`);
+    return sections.join('\n\n');
+}
+function formatTaskHeader(task) {
+    const lines = [
+        `**ID**: \`${task.id}\``,
+        `**Title**: ${task.title}`,
+        `**Priority**: ${task.priority}`,
+    ];
+    if (task.tags?.length)
+        lines.push(`**Tags**: ${task.tags.join(', ')}`);
+    if (task.estimate)
+        lines.push(`**Estimate**: ${task.estimate}`);
+    if (task.dueDate)
+        lines.push(`**Due**: ${task.dueDate}`);
+    if (task.description) {
+        lines.push(`\n**Description**:\n${task.description}`);
+    }
+    else {
+        lines.push(`\n_(No description — fetch full context via tasks_get)_`);
+    }
+    return lines.join('\n');
+}
+function buildProtocol(task) {
+    const steps = [
+        `1. **Get full context**: \`tasks_get("${task.id}")\` — reads cross-links, attachments, notes`,
+        `2. **Check for recipes**: \`skills_recall("<task topic>")\` — use existing patterns if available`,
+        `3. **Do the work**: use all available tools (edit files, run commands, search code, etc.)`,
+    ];
+    if (task.subtasks?.length) {
+        steps.push(`4. **Subtasks**: complete each one and call \`tasks_move(subtaskId, "done")\` per subtask`);
+        steps.push(`5. **Signal completion**: \`tasks_move("${task.id}", "done")\``);
+    }
+    else {
+        steps.push(`4. **Signal completion**: \`tasks_move("${task.id}", "done")\``);
+    }
+    steps.push(`\n**If blocked or impossible**: call \`tasks_move("${task.id}", "cancelled")\` immediately ` +
+        `and update the task description with the specific blocker. Do not spin.`);
+    return steps.join('\n');
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/core/prompt-builder.js.map

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

package/dist/core/task-utils.d.ts

@@ -0,0 +1,5 @@
+import type { Task } from './types.js';
+export declare function sortByPriority(tasks: Task[]): Task[];
+export declare function isTerminal(status: string): boolean;
+export declare function areBlockersResolved(task: Task): boolean;
+//# sourceMappingURL=task-utils.d.ts.map

package/dist/core/task-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utils.d.ts","sourceRoot":"","sources":["../../src/core/task-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AASrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAUpD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAGvD"}

package/dist/core/task-utils.js

@@ -0,0 +1,27 @@
+const PRIORITY_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+export function sortByPriority(tasks) {
+    return [...tasks].sort((a, b) => {
+        const pa = PRIORITY_ORDER[a.priority] ?? 4;
+        const pb = PRIORITY_ORDER[b.priority] ?? 4;
+        if (pa !== pb)
+            return pa - pb;
+        // Secondary: earliest dueDate
+        const da = a.dueDate ? new Date(a.dueDate).getTime() : Infinity;
+        const db = b.dueDate ? new Date(b.dueDate).getTime() : Infinity;
+        return da - db;
+    });
+}
+export function isTerminal(status) {
+    return status === 'done' || status === 'cancelled';
+}
+export function areBlockersResolved(task) {
+    if (!task.blockedBy?.length)
+        return true;
+    return task.blockedBy.every((b) => b.status === 'done');
+}
+//# sourceMappingURL=task-utils.js.map

package/dist/core/task-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utils.js","sourceRoot":"","sources":["../../src/core/task-utils.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAiC;IACnD,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACP,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC9B,8BAA8B;QAC9B,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChE,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChE,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,WAAW,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,150 @@
+export type TaskStatus = 'todo' | 'in_progress' | 'done' | 'cancelled';
+export type TaskPriority = 'critical' | 'high' | 'medium' | 'low';
+export type EpicStatus = 'todo' | 'in_progress' | 'done' | 'cancelled';
+export interface TaskRef {
+    id: string;
+    title: string;
+    status: TaskStatus;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    tags?: string[];
+    dueDate?: string;
+    estimate?: string;
+    assignee?: string;
+    completedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    subtasks?: TaskRef[];
+    blockedBy?: TaskRef[];
+    blocks?: TaskRef[];
+    related?: TaskRef[];
+}
+export interface Epic {
+    id: string;
+    title: string;
+    description?: string;
+    status: EpicStatus;
+    priority: TaskPriority;
+    tags?: string[];
+    tasks?: TaskRef[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Permissions {
+    writeFiles: boolean;
+    runCommands: string[];
+    blockedCommands: string[];
+    mcpTools: 'all' | 'none' | string[];
+}
+export interface OrchestratorConfig {
+    baseUrl: string;
+    projectId: string;
+    apiKey?: string;
+    timeoutMs: number;
+    pauseMs: number;
+    maxRetries: number;
+    claudeArgs: string[];
+    dryRun: boolean;
+    tag?: string;
+}
+export type TaskRunResult = 'done' | 'cancelled' | 'timeout' | 'error' | 'dry_run' | 'blocked';
+export interface SprintStats {
+    done: number;
+    cancelled: number;
+    retried: number;
+    errors: number;
+    skipped: number;
+    durationMs: number;
+}
+export type ServerEvent = {
+    type: 'run:started';
+    payload: {
+        mode: 'sprint' | 'epic';
+        epicId?: string;
+    };
+} | {
+    type: 'run:stopped';
+} | {
+    type: 'run:complete';
+    payload: SprintStats;
+} | {
+    type: 'task:started';
+    payload: {
+        task: Task;
+    };
+} | {
+    type: 'task:done';
+    payload: {
+        task: Task;
+    };
+} | {
+    type: 'task:cancelled';
+    payload: {
+        task: Task;
+        reason?: string;
+    };
+} | {
+    type: 'task:timeout';
+    payload: {
+        task: Task;
+    };
+} | {
+    type: 'task:retrying';
+    payload: {
+        task: Task;
+        attempt: number;
+    };
+} | {
+    type: 'log:line';
+    payload: {
+        taskId: string;
+        line: string;
+    };
+} | {
+    type: 'error';
+    payload: {
+        message: string;
+    };
+};
+/**
+ * Everything the orchestrator needs from GraphMemory.
+ * Mock this in tests — never import gm-client directly in core logic.
+ */
+export interface GraphMemoryPort {
+    listTasks(opts?: {
+        status?: TaskStatus;
+        tag?: string;
+        limit?: number;
+    }): Promise<Task[]>;
+    getTask(taskId: string): Promise<Task>;
+    moveTask(taskId: string, status: TaskStatus): Promise<void>;
+    updateTask(taskId: string, fields: Partial<Task>): Promise<void>;
+    getEpic(epicId: string): Promise<Epic>;
+    listEpics(opts?: {
+        status?: EpicStatus;
+        limit?: number;
+    }): Promise<Epic[]>;
+    moveEpic(epicId: string, status: EpicStatus): Promise<void>;
+}
+/**
+ * Abstracts spawning Claude Code.
+ * Swap for a mock in tests.
+ */
+export interface ClaudeRunnerPort {
+    run(task: Task, config: OrchestratorConfig): Promise<void>;
+}
+/**
+ * Abstracts polling for task completion.
+ * Lets tests inject instant-resolve fakes.
+ */
+export interface TaskPollerPort {
+    waitForCompletion(taskId: string, opts: {
+        timeoutMs: number;
+    }): Promise<'done' | 'cancelled' | 'timeout'>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,5 @@
+// ─── GraphMemory Domain Types ─────────────────────────────────────────────
+// Mirrors the GraphMemory REST API response shapes.
+// All orchestrator logic is typed against these.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oDAAoD;AACpD,iDAAiD"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { runSprint, runEpic } from './core/orchestrator.js';
+export { buildPrompt } from './core/prompt-builder.js';
+export { sortByPriority, isTerminal, areBlockersResolved } from './core/task-utils.js';
+export type { TaskStatus, TaskPriority, EpicStatus, TaskRef, Task, Epic, OrchestratorConfig, TaskRunResult, SprintStats, GraphMemoryPort, ClaudeRunnerPort, TaskPollerPort, } from './core/types.js';
+export { GraphMemoryClient } from './infra/gm-client.js';
+export { ClaudeRunner } from './infra/claude-runner.js';
+export { TaskPoller } from './infra/task-poller.js';
+export { loadConfig, validateConfig } from './infra/config.js';
+export { consoleLogger, silentLogger } from './infra/logger.js';
+export type { Logger } from './infra/logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// ─── Public API ──────────────────────────────────────────────────────────
+// Core orchestration
+export { runSprint, runEpic } from './core/orchestrator.js';
+export { buildPrompt } from './core/prompt-builder.js';
+export { sortByPriority, isTerminal, areBlockersResolved } from './core/task-utils.js';
+// Infrastructure
+export { GraphMemoryClient } from './infra/gm-client.js';
+export { ClaudeRunner } from './infra/claude-runner.js';
+export { TaskPoller } from './infra/task-poller.js';
+export { loadConfig, validateConfig } from './infra/config.js';
+export { consoleLogger, silentLogger } from './infra/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAkBvF,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/infra/claude-runner.d.ts

@@ -0,0 +1,14 @@
+import type { ClaudeRunnerPort, Task, OrchestratorConfig } from '../core/types.js';
+export declare class ClaudeRunner implements ClaudeRunnerPort {
+    /**
+     * Spawns `claude --print <prompt>` as a child process.
+     * Streams stdout/stderr to the parent terminal.
+     * Resolves when the process exits (for any reason).
+     *
+     * Note: the orchestrator does NOT rely on process exit for completion
+     * detection — it polls GraphMemory task status instead. The session
+     * promise is awaited only for cleanup after the poller signals done.
+     */
+    run(task: Task, config: OrchestratorConfig): Promise<void>;
+}
+//# sourceMappingURL=claude-runner.d.ts.map

package/dist/infra/claude-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-runner.d.ts","sourceRoot":"","sources":["../../src/infra/claude-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGnF,qBAAa,YAAa,YAAW,gBAAgB;IACnD;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BjE"}