@dmmulroy/overseer 0.1.0

package/dist/tests/integration.test.js

@@ -0,0 +1,378 @@
+/**
+ * End-to-end integration tests with real Rust CLI
+ *
+ * These tests require:
+ * - Rust CLI built at ../../os/target/debug/os
+ * - jj repository initialized in test directory
+ */
+import { describe, it, before, after } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+let testDir;
+let originalDbPath;
+let originalCliPath;
+let originalCliCwd;
+before(async () => {
+    // Create temporary directory for test database
+    testDir = await mkdtemp(join(tmpdir(), "overseer-test-"));
+    const dbPath = join(testDir, "overseer.db");
+    // Set DB path, CLI path, and CWD for tests
+    originalDbPath = process.env.OVERSEER_DB_PATH;
+    originalCliPath = process.env.OVERSEER_CLI_PATH;
+    originalCliCwd = process.env.OVERSEER_CLI_CWD;
+    process.env.OVERSEER_DB_PATH = dbPath;
+    // Point to debug binary (relative to mcp directory)
+    process.env.OVERSEER_CLI_PATH = join(process.cwd(), "../overseer/target/debug/os");
+    // Run CLI from test directory (where jj repo is)
+    process.env.OVERSEER_CLI_CWD = testDir;
+    // Initialize jj repo for VCS tests
+    await runCommand("jj", ["git", "init", "--colocate", testDir]);
+    await runCommand("jj", ["describe", "-m", "initial"], testDir);
+});
+after(async () => {
+    // Restore original env vars
+    if (originalDbPath === undefined) {
+        delete process.env.OVERSEER_DB_PATH;
+    }
+    else {
+        process.env.OVERSEER_DB_PATH = originalDbPath;
+    }
+    if (originalCliPath === undefined) {
+        delete process.env.OVERSEER_CLI_PATH;
+    }
+    else {
+        process.env.OVERSEER_CLI_PATH = originalCliPath;
+    }
+    if (originalCliCwd === undefined) {
+        delete process.env.OVERSEER_CLI_CWD;
+    }
+    else {
+        process.env.OVERSEER_CLI_CWD = originalCliCwd;
+    }
+    // Clean up test directory
+    if (testDir) {
+        await rm(testDir, { recursive: true, force: true });
+    }
+});
+/**
+ * Helper to run shell commands
+ */
+function runCommand(cmd, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(cmd, args, { cwd: cwd || testDir });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout?.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code === 0) {
+                resolve(stdout);
+            }
+            else {
+                reject(new Error(`Command failed: ${stderr || stdout}`));
+            }
+        });
+    });
+}
+/**
+ * Helper to execute code via executor directly
+ */
+async function executeCode(code) {
+    // Import execute directly to avoid MCP connection requirement
+    const { execute } = await import("../executor.js");
+    return await execute(code);
+}
+describe("Integration Tests", () => {
+    describe("Tasks API", () => {
+        it("should create and get task", async () => {
+            const result = await executeCode(`
+        const task = await tasks.create({
+          description: "Test task",
+          context: "Test context",
+          priority: 1
+        });
+        return task;
+      `);
+            assert.ok(result);
+            const task = result;
+            assert.ok(task.id);
+            assert.equal(task.description, "Test task");
+            assert.equal(task.priority, 1);
+            assert.equal(task.completed, false);
+            assert.equal(task.depth, 0);
+        });
+        it("should list tasks", async () => {
+            // Create a task first
+            await executeCode(`
+        await tasks.create({ description: "List test task" });
+      `);
+            const result = await executeCode(`
+        return await tasks.list();
+      `);
+            assert.ok(Array.isArray(result));
+            assert.ok(result.length > 0);
+        });
+        it("should create parent-child hierarchy", async () => {
+            const result = await executeCode(`
+        const parent = await tasks.create({
+          description: "Parent task",
+          priority: 1
+        });
+        
+        const child = await tasks.create({
+          description: "Child task",
+          parentId: parent.id,
+          priority: 2
+        });
+        
+        return { parent, child };
+      `);
+            assert.ok(result);
+            const { parent, child } = result;
+            assert.equal(parent.depth, 0);
+            assert.equal(child.depth, 1);
+            assert.equal(child.parentId, parent.id);
+        });
+        it("should get task with progressive context", async () => {
+            const result = await executeCode(`
+        const milestone = await tasks.create({
+          description: "Build API",
+          context: "REST API with auth",
+          priority: 1
+        });
+        
+        const task = await tasks.create({
+          description: "Add login endpoint",
+          context: "POST /auth/login",
+          parentId: milestone.id,
+          priority: 2
+        });
+        
+        const fetched = await tasks.get(task.id);
+        return fetched.context;
+      `);
+            assert.ok(result);
+            const context = result;
+            assert.equal(context.own, "POST /auth/login");
+            assert.equal(context.milestone, "REST API with auth");
+        });
+        it("should complete and reopen task", async () => {
+            const result = await executeCode(`
+        const task = await tasks.create({
+          description: "Completable task"
+        });
+        
+        const completed = await tasks.complete(task.id, "Done!");
+        const reopened = await tasks.reopen(completed.id);
+        
+        return { completed: completed.completed, reopened: reopened.completed };
+      `);
+            const statuses = result;
+            assert.equal(statuses.completed, true);
+            assert.equal(statuses.reopened, false);
+        });
+        it("should add and remove blockers", async () => {
+            const result = await executeCode(`
+        const task1 = await tasks.create({ description: "Task 1" });
+        const task2 = await tasks.create({ description: "Task 2" });
+        
+        await tasks.block(task1.id, task2.id);
+        const blocked = await tasks.get(task1.id);
+        
+        await tasks.unblock(task1.id, task2.id);
+        const unblocked = await tasks.get(task1.id);
+        
+        return {
+          blockedCount: blocked.blockedBy.length,
+          unblockedCount: unblocked.blockedBy.length
+        };
+      `);
+            const counts = result;
+            assert.equal(counts.blockedCount, 1);
+            assert.equal(counts.unblockedCount, 0);
+        });
+        it("should filter tasks by ready status", async () => {
+            const result = await executeCode(`
+        // Create blocked task
+        const blocker = await tasks.create({ description: "Blocker" });
+        const blocked = await tasks.create({
+          description: "Blocked",
+          blockedBy: [blocker.id]
+        });
+        
+        // Create ready task
+        const ready = await tasks.create({ description: "Ready" });
+        
+        const readyTasks = await tasks.list({ ready: true });
+        const blockedTask = readyTasks.find(t => t.id === blocked.id);
+        const readyTask = readyTasks.find(t => t.id === ready.id);
+        
+        return {
+          hasBlocked: !!blockedTask,
+          hasReady: !!readyTask
+        };
+      `);
+            const flags = result;
+            assert.equal(flags.hasBlocked, false, "Blocked task should not be ready");
+            assert.equal(flags.hasReady, true, "Unblocked task should be ready");
+        });
+    });
+    describe("Learnings API", () => {
+        it("should add and list learnings", async () => {
+            const result = await executeCode(`
+        const task = await tasks.create({ description: "Task with learning" });
+        
+        const learning = await learnings.add(
+          task.id,
+          "Use TypeScript for type safety"
+        );
+        
+        const list = await learnings.list(task.id);
+        
+        return { learning, list };
+      `);
+            assert.ok(result);
+            const { learning, list } = result;
+            assert.ok(learning.id);
+            assert.ok(Array.isArray(list));
+            assert.equal(list.length, 1);
+        });
+        it("should delete learning", async () => {
+            const result = await executeCode(`
+        const task = await tasks.create({ description: "Task" });
+        const learning = await learnings.add(task.id, "Test learning");
+        
+        await learnings.delete(learning.id);
+        const list = await learnings.list(task.id);
+        
+        return list.length;
+      `);
+            assert.equal(result, 0);
+        });
+        it("should include learnings in task get", async () => {
+            const result = await executeCode(`
+        const milestone = await tasks.create({
+          description: "Milestone"
+        });
+        await learnings.add(milestone.id, "Milestone learning");
+        
+        const task = await tasks.create({
+          description: "Task",
+          parentId: milestone.id
+        });
+        
+        const fetched = await tasks.get(task.id);
+        return fetched.learnings;
+      `);
+            assert.ok(result);
+            const inherited = result;
+            assert.ok(inherited.milestone);
+            assert.equal(inherited.milestone.length, 1);
+        });
+    });
+    describe("Error Handling", () => {
+        it("should handle nonexistent task ID", async () => {
+            try {
+                await executeCode(`
+          return await tasks.get("nonexistent_id");
+        `);
+                assert.fail("Should have thrown");
+            }
+            catch (err) {
+                assert.ok(err instanceof Error);
+                // CLI will return error for nonexistent ID
+            }
+        });
+        it("should handle cycle detection", async () => {
+            try {
+                await executeCode(`
+          const task1 = await tasks.create({ description: "Task 1" });
+          const task2 = await tasks.create({
+            description: "Task 2",
+            parentId: task1.id
+          });
+          
+          // Try to make task1 a child of task2 (would create cycle)
+          await tasks.update(task1.id, { parentId: task2.id });
+        `);
+                assert.fail("Should have thrown");
+            }
+            catch (err) {
+                assert.ok(err instanceof Error);
+                // CLI should reject the cycle
+            }
+        });
+        it("should handle depth limit", async () => {
+            try {
+                await executeCode(`
+          const task1 = await tasks.create({ description: "L0" });
+          const task2 = await tasks.create({ description: "L1", parentId: task1.id });
+          const task3 = await tasks.create({ description: "L2", parentId: task2.id });
+          
+          // Try to create L3 (exceeds max depth of 2)
+          await tasks.create({ description: "L3", parentId: task3.id });
+        `);
+                assert.fail("Should have thrown");
+            }
+            catch (err) {
+                assert.ok(err instanceof Error);
+                // CLI should reject exceeding max depth
+            }
+        });
+    });
+    describe("Complex Workflows", () => {
+        it("should handle full task lifecycle", async () => {
+            const result = await executeCode(`
+        // Create milestone
+        const milestone = await tasks.create({
+          description: "Build feature X",
+          context: "New feature for users",
+          priority: 1
+        });
+        
+        // Add milestone learning
+        await learnings.add(milestone.id, "Follow existing patterns");
+        
+        // Create subtask
+        const task = await tasks.create({
+          description: "Implement core logic",
+          context: "Handle edge cases",
+          parentId: milestone.id,
+          priority: 2
+        });
+        
+        // Get task with inherited context
+        const fetched = await tasks.get(task.id);
+        
+        // Start and complete task
+        await tasks.start(task.id);
+        await tasks.complete(task.id, "Implemented successfully");
+        
+        // Add learning
+        await learnings.add(task.id, "Consider performance", task.id);
+        
+        // Get final state
+        const final = await tasks.get(task.id);
+        
+        return {
+          hasContext: !!final.context.milestone,
+          hasLearnings: final.learnings.milestone.length > 0,
+          isCompleted: final.completed
+        };
+      `);
+            assert.ok(result);
+            const workflow = result;
+            assert.equal(workflow.hasContext, true);
+            assert.equal(workflow.hasLearnings, true);
+            assert.equal(workflow.isCompleted, true);
+        });
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/tests/integration.test.js.map

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

package/dist/tests/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/tests/server.test.d.ts.map

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

package/dist/tests/server.test.js

@@ -0,0 +1,53 @@
+/**
+ * Integration tests for MCP server
+ *
+ * Note: These tests use execute() directly instead of going through
+ * the MCP server request handling to avoid needing a connected transport.
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { execute } from "../executor.js";
+describe("MCP Server Execute Tool", () => {
+    describe("Basic Execution", () => {
+        it("should execute simple return statement", async () => {
+            const result = await execute("return 42;");
+            assert.equal(result, 42);
+        });
+        it("should execute async code with await", async () => {
+            const result = await execute(`
+        const promise = Promise.resolve("hello");
+        return await promise;
+      `);
+            assert.equal(result, "hello");
+        });
+        it("should return object results", async () => {
+            const result = await execute('return { id: "123", name: "test" };');
+            // Check properties instead of deep equality due to VM context
+            assert.equal(result.id, "123");
+            assert.equal(result.name, "test");
+        });
+    });
+    describe("Error Handling", () => {
+        it("should handle syntax errors in code", async () => {
+            try {
+                await execute("return {{{;");
+                assert.fail("Should have thrown");
+            }
+            catch (err) {
+                assert.ok(err instanceof Error);
+                assert.ok(err.message.length > 0);
+            }
+        });
+        it("should handle runtime errors", async () => {
+            try {
+                await execute('throw new Error("test error");');
+                assert.fail("Should have thrown");
+            }
+            catch (err) {
+                assert.ok(err instanceof Error);
+                assert.ok(err.message.includes("test error"));
+            }
+        });
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/tests/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../src/tests/server.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;;;OAG5B,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,qCAAqC,CAA4B,CAAC;YAC/F,8DAA8D;YAC9D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;gBAChC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,gCAAgC,CAAC,CAAC;gBAChD,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;gBAChC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Core domain types mirroring the Rust CLI output
+ */
+declare const TaskIdBrand: unique symbol;
+declare const LearningIdBrand: unique symbol;
+export type TaskId = string & {
+    readonly [TaskIdBrand]: never;
+};
+export type LearningId = string & {
+    readonly [LearningIdBrand]: never;
+};
+export declare function isTaskId(s: string): s is TaskId;
+export declare function isLearningId(s: string): s is LearningId;
+export declare function parseTaskId(s: string): TaskId;
+export declare function parseLearningId(s: string): LearningId;
+export interface Task {
+    id: TaskId;
+    parentId: TaskId | null;
+    description: string;
+    context: {
+        own: string;
+        parent?: string;
+        milestone?: string;
+    };
+    learnings: {
+        milestone: Learning[];
+        parent: Learning[];
+    };
+    priority: 1 | 2 | 3 | 4 | 5;
+    completed: boolean;
+    completedAt: string | null;
+    startedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    result: string | null;
+    commitSha: string | null;
+    depth: 0 | 1 | 2;
+    blockedBy: TaskId[];
+    blocks: TaskId[];
+}
+export interface Learning {
+    id: LearningId;
+    taskId: TaskId;
+    content: string;
+    sourceTaskId: TaskId | null;
+    createdAt: string;
+}
+/**
+ * CLI command errors
+ */
+export declare class CliError extends Error {
+    exitCode: number;
+    stderr: string;
+    constructor(message: string, exitCode: number, stderr: string);
+}
+export declare class CliTimeoutError extends Error {
+    constructor(message?: string);
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AACzC,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAGxE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,UAAU,CAEvD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAKrD;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,EAAE,QAAQ,EAAE,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAGxB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAKxB;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,SAA8B;CAIlD"}

package/dist/types.js

@@ -0,0 +1,42 @@
+/**
+ * Core domain types mirroring the Rust CLI output
+ */
+// Validation helpers
+export function isTaskId(s) {
+    return s.startsWith("task_") && s.length === 31; // "task_" + 26 ULID chars
+}
+export function isLearningId(s) {
+    return s.startsWith("lrn_") && s.length === 30; // "lrn_" + 26 ULID chars
+}
+export function parseTaskId(s) {
+    if (!isTaskId(s)) {
+        throw new Error(`Invalid TaskId: ${s}`);
+    }
+    return s;
+}
+export function parseLearningId(s) {
+    if (!isLearningId(s)) {
+        throw new Error(`Invalid LearningId: ${s}`);
+    }
+    return s;
+}
+/**
+ * CLI command errors
+ */
+export class CliError extends Error {
+    exitCode;
+    stderr;
+    constructor(message, exitCode, stderr) {
+        super(message);
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.name = "CliError";
+    }
+}
+export class CliTimeoutError extends Error {
+    constructor(message = "CLI command timeout (30s)") {
+        super(message);
+        this.name = "CliTimeoutError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,qBAAqB;AACrB,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,0BAA0B;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,yBAAyB;AAC3E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAoCD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,QAAgB,EAChB,MAAc;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QAGrB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,GAAG,2BAA2B;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@dmmulroy/overseer",
+  "version": "0.1.0",
+  "description": "Codemode MCP server for agent task management",
+  "type": "module",
+  "bin": {
+    "os": "bin/os"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "bin/",
+    "dist/"
+  ],
+  "optionalDependencies": {
+    "@dmmulroy/overseer-darwin-arm64": "0.1.0",
+    "@dmmulroy/overseer-darwin-x64": "0.1.0",
+    "@dmmulroy/overseer-linux-arm64": "0.1.0",
+    "@dmmulroy/overseer-linux-x64": "0.1.0",
+    "@dmmulroy/overseer-linux-arm64-musl": "0.1.0",
+    "@dmmulroy/overseer-linux-x64-musl": "0.1.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dmmulroy/overseer.git"
+  },
+  "keywords": [
+    "mcp",
+    "task-management",
+    "agent",
+    "claude",
+    "ai"
+  ],
+  "author": "Dillon Mulroy",
+  "license": "MIT"
+}