@dmmulroy/overseer 0.4.0 → 0.5.1

package/bin/os

@@ -82,8 +82,13 @@ if (command === "mcp") {
     console.error("Failed to start MCP server:", err.message);
     process.exit(1);
   });
-} else {
-  // All other commands - passthrough to native binary
+}
+// Handle `os ui` - start Task Viewer webapp
+else if (command === "ui") {
+  startUiServer(args.slice(1));
+}
+// All other commands - passthrough to native binary
+else {
   const child = spawn(getBinaryPath(), args, {
     stdio: "inherit",
   });
@@ -101,3 +106,89 @@ if (command === "mcp") {
     }
   });
 }
+
+/**
+ * Start the UI server
+ * Usage: os ui [port] [--port PORT] [--open]
+ */
+function startUiServer(uiArgs) {
+  // Parse args: positional port, --port flag, --open flag
+  let port = null;
+  let openBrowser = false;
+
+  for (let i = 0; i < uiArgs.length; i++) {
+    const arg = uiArgs[i];
+    if (arg === "--port" && i + 1 < uiArgs.length) {
+      port = parseInt(uiArgs[++i], 10);
+    } else if (arg === "--open") {
+      openBrowser = true;
+    } else if (arg === "--help" || arg === "-h") {
+      console.log(`Usage: os ui [port] [--port PORT] [--open]
+
+Options:
+  port          Port number (positional, default: 6969)
+  --port PORT   Port number (explicit flag)
+  --open        Open browser after starting
+
+Examples:
+  os ui              # Start on port 6969
+  os ui 8080         # Start on port 8080
+  os ui --port 3000  # Start on port 3000
+  os ui --open       # Start and open browser`);
+      process.exit(0);
+    } else if (/^\d+$/.test(arg) && port === null) {
+      // Positional port number
+      port = parseInt(arg, 10);
+    }
+  }
+
+  // Port precedence: --port > positional > PORT env > 6969
+  if (port === null && process.env.PORT) {
+    port = parseInt(process.env.PORT, 10);
+  }
+  if (port === null || isNaN(port)) {
+    port = 6969;
+  }
+
+  // Set up environment for the UI server
+  const binaryPath = getBinaryPath();
+  process.env.OVERSEER_CLI_PATH = binaryPath;
+  process.env.PORT = String(port);
+  process.env.NODE_ENV = "production";
+  
+  // Static files are in dist/ui/static/ relative to package root
+  const uiDir = join(__dirname, "..", "dist", "ui");
+  process.env.OVERSEER_UI_STATIC_ROOT = join(uiDir, "static");
+
+  // Change cwd to ui dir (serveStatic needs relative path from cwd)
+  process.chdir(uiDir);
+
+  const serverPath = join(uiDir, "server.js");
+  
+  if (!existsSync(serverPath)) {
+    console.error("UI server not found. The package may not have been built correctly.");
+    console.error(`Expected: ${serverPath}`);
+    process.exit(1);
+  }
+
+  // Open browser after server starts (if requested)
+  if (openBrowser) {
+    // Delay to let server start
+    setTimeout(() => {
+      const url = `http://localhost:${port}`;
+      const openCmd =
+        platform === "darwin" ? "open" :
+        platform === "win32" ? "start" : "xdg-open";
+      try {
+        execSync(`${openCmd} ${url}`, { stdio: "ignore" });
+      } catch {
+        // Ignore errors (e.g., no display)
+      }
+    }, 500);
+  }
+
+  import(serverPath).catch((err) => {
+    console.error("Failed to start UI server:", err.message);
+    process.exit(1);
+  });
+}

package/dist/api/tasks.d.ts

@@ -1,8 +1,24 @@
-import type { Task, TaskWithContext } from "../types.js";
+import type { Depth, Task, TaskWithContext, TaskTree, TaskProgress } from "../types.js";
+/**
+ * Task type aliases for depth (ergonomic sugar)
+ */
+export type TaskType = "milestone" | "task" | "subtask";
 export interface TaskFilter {
     parentId?: string;
     ready?: boolean;
     completed?: boolean;
+    /**
+     * Filter by depth: 0=milestones, 1=tasks, 2=subtasks.
+     * Maps to CLI: --milestones | --tasks | --subtasks
+     * Mutually exclusive with parentId and type.
+     */
+    depth?: Depth;
+    /**
+     * Filter by type: "milestone" | "task" | "subtask".
+     * Alias for depth (milestone=0, task=1, subtask=2).
+     * Mutually exclusive with parentId and depth.
+     */
+    type?: TaskType;
 }
 export interface CreateTaskInput {
     description: string;
@@ -43,7 +59,7 @@ export declare const tasks: {
     /**
      * Mark task as started.
      * Follows blockers to find startable work, cascades to deepest leaf.
-     * Creates VCS bookmark for started task.
+     * Creates VCS bookmark for started task and records start commit.
      * Returns the task that was actually started.
      *
      * **Requires VCS**: Must be in a jj or git repository.
@@ -83,5 +99,23 @@ export declare const tasks: {
      * Returns task with full context chain and inherited learnings, or null if no ready tasks.
      */
     nextReady(milestoneId?: string): Promise<TaskWithContext | null>;
+    /**
+     * Get task tree structure.
+     * If rootId provided, returns single tree rooted at that task.
+     * If no rootId, returns array of all milestone trees.
+     *
+     * **Warning:** Large trees may hit 50k output limit. Prefer scoping to specific milestone.
+     */
+    tree(rootId?: string): Promise<TaskTree | TaskTree[]>;
+    /**
+     * Search tasks by description.
+     * Returns tasks matching the query (case-insensitive substring match).
+     */
+    search(query: string): Promise<Task[]>;
+    /**
+     * Get progress summary for a milestone or all tasks.
+     * Returns aggregate counts: { total, completed, ready, blocked }
+     */
+    progress(rootId?: string): Promise<TaskProgress>;
 };
 //# sourceMappingURL=tasks.d.ts.map

package/dist/api/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;;OAGG;kBACiB,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQhD;;OAEG;YACW,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/C;;;OAGG;kBACiB,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD;;;OAGG;eACc,MAAM,SAAS,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;;;;;;OAOG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;;;;;;OAOG;iBAEG,MAAM,YACA;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;kBACiB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;oBACmB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;;OAGG;4BAC2B,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAKvE,CAAC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/api/tasks.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAQxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;;OAGG;kBACiB,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAgChD;;OAEG;YACW,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/C;;;OAGG;kBACiB,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD;;;OAGG;eACc,MAAM,SAAS,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;;;;;;OAOG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;;;;;;OAOG;iBAEG,MAAM,YACA;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;eACc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;kBACiB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;oBACmB,MAAM,aAAa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;;OAGG;4BAC2B,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAMtE;;;;;;OAMG;kBACiB,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAS3D;;;OAGG;kBACiB,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAI5C;;;OAGG;sBACqB,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAKvD,CAAC"}

package/dist/api/tasks.js

@@ -2,6 +2,12 @@
  * Tasks API - typed wrapper around os task commands
  */
 import { callCli } from "../cli.js";
+import { decodeTask, decodeTasks, decodeTaskWithContext, decodeTaskWithContextOrNull, decodeTaskTree, decodeTaskTrees, decodeTaskProgress, } from "../decoder.js";
+const TYPE_TO_DEPTH = {
+    milestone: 0,
+    task: 1,
+    subtask: 2,
+};
 /**
  * Tasks API exposed to VM sandbox
  */
@@ -11,6 +17,16 @@ export const tasks = {
      * Returns tasks without context chain or inherited learnings.
      */
     async list(filter) {
+        // Resolve type to depth if provided
+        const effectiveDepth = filter?.type !== undefined
+            ? TYPE_TO_DEPTH[filter.type]
+            : filter?.depth;
+        if (filter?.parentId !== undefined && effectiveDepth !== undefined) {
+            throw new Error("parentId and depth/type are mutually exclusive - use parentId alone; depth is implied by parent type");
+        }
+        if (filter?.depth !== undefined && filter?.type !== undefined) {
+            throw new Error("depth and type are mutually exclusive - use one or the other");
+        }
         const args = ["task", "list"];
         if (filter?.parentId)
             args.push("--parent", filter.parentId);
@@ -18,13 +34,21 @@ export const tasks = {
             args.push("--ready");
         if (filter?.completed)
             args.push("--completed");
-        return (await callCli(args));
+        if (effectiveDepth !== undefined) {
+            const depthFlags = {
+                0: "--milestones",
+                1: "--tasks",
+                2: "--subtasks",
+            };
+            args.push(depthFlags[effectiveDepth]);
+        }
+        return decodeTasks(await callCli(args)).unwrap("tasks.list");
     },
     /**
      * Get single task with full context chain and inherited learnings.
      */
     async get(id) {
-        return (await callCli(["task", "get", id]));
+        return decodeTaskWithContext(await callCli(["task", "get", id])).unwrap("tasks.get");
     },
     /**
      * Create new task.
@@ -41,7 +65,7 @@ export const tasks = {
         if (input.blockedBy && input.blockedBy.length > 0) {
             args.push("--blocked-by", input.blockedBy.join(","));
         }
-        return (await callCli(args));
+        return decodeTask(await callCli(args)).unwrap("tasks.create");
     },
     /**
      * Update existing task.
@@ -57,18 +81,18 @@ export const tasks = {
             args.push("--priority", String(input.priority));
         if (input.parentId)
             args.push("--parent", input.parentId);
-        return (await callCli(args));
+        return decodeTask(await callCli(args)).unwrap("tasks.update");
     },
     /**
      * Mark task as started.
      * Follows blockers to find startable work, cascades to deepest leaf.
-     * Creates VCS bookmark for started task.
+     * Creates VCS bookmark for started task and records start commit.
      * Returns the task that was actually started.
      *
      * **Requires VCS**: Must be in a jj or git repository.
      */
     async start(id) {
-        return (await callCli(["task", "start", id]));
+        return decodeTask(await callCli(["task", "start", id])).unwrap("tasks.start");
     },
     /**
      * Complete task with optional result and learnings.
@@ -87,13 +111,13 @@ export const tasks = {
                 args.push("--learning", learning);
             }
         }
-        return (await callCli(args));
+        return decodeTask(await callCli(args)).unwrap("tasks.complete");
     },
     /**
      * Reopen completed task.
      */
     async reopen(id) {
-        return (await callCli(["task", "reopen", id]));
+        return decodeTask(await callCli(["task", "reopen", id])).unwrap("tasks.reopen");
     },
     /**
      * Delete task (cascades to children and learnings).
@@ -122,7 +146,39 @@ export const tasks = {
         const args = ["task", "next-ready"];
         if (milestoneId)
             args.push("--milestone", milestoneId);
-        return (await callCli(args));
+        return decodeTaskWithContextOrNull(await callCli(args)).unwrap("tasks.nextReady");
+    },
+    /**
+     * Get task tree structure.
+     * If rootId provided, returns single tree rooted at that task.
+     * If no rootId, returns array of all milestone trees.
+     *
+     * **Warning:** Large trees may hit 50k output limit. Prefer scoping to specific milestone.
+     */
+    async tree(rootId) {
+        const args = ["task", "tree"];
+        if (rootId) {
+            args.push(rootId);
+            return decodeTaskTree(await callCli(args)).unwrap("tasks.tree");
+        }
+        return decodeTaskTrees(await callCli(args)).unwrap("tasks.tree");
+    },
+    /**
+     * Search tasks by description.
+     * Returns tasks matching the query (case-insensitive substring match).
+     */
+    async search(query) {
+        return decodeTasks(await callCli(["task", "search", query])).unwrap("tasks.search");
+    },
+    /**
+     * Get progress summary for a milestone or all tasks.
+     * Returns aggregate counts: { total, completed, ready, blocked }
+     */
+    async progress(rootId) {
+        const args = ["task", "progress"];
+        if (rootId)
+            args.push(rootId);
+        return decodeTaskProgress(await callCli(args)).unwrap("tasks.progress");
     },
 };
 //# sourceMappingURL=tasks.js.map

package/dist/api/tasks.js.map

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

package/dist/decoder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Runtime decoders for CLI JSON output.
+ * Validates structure matches expected types at runtime.
+ */
+import { Result } from "better-result";
+import { type Task, type TaskWithContext, type Learning, type TaskTree, type TaskProgress } from "./types.js";
+declare const DecodeError_base: import("better-result").TaggedErrorClass<"DecodeError", {
+    message: string;
+    path?: string;
+}>;
+/**
+ * Decode error with path context
+ */
+export declare class DecodeError extends DecodeError_base {
+}
+/**
+ * Decode a Learning from unknown JSON
+ */
+export declare function decodeLearning(v: unknown): Result<Learning, DecodeError>;
+/**
+ * Decode a Learning array
+ */
+export declare function decodeLearnings(v: unknown): Result<Learning[], DecodeError>;
+/**
+ * Decode a Task from unknown JSON
+ */
+export declare function decodeTask(v: unknown): Result<Task, DecodeError>;
+/**
+ * Decode a Task array
+ */
+export declare function decodeTasks(v: unknown): Result<Task[], DecodeError>;
+/**
+ * Decode TaskWithContext from unknown JSON
+ */
+export declare function decodeTaskWithContext(v: unknown): Result<TaskWithContext, DecodeError>;
+/**
+ * Decode nullable TaskWithContext (for nextReady)
+ */
+export declare function decodeTaskWithContextOrNull(v: unknown): Result<TaskWithContext | null, DecodeError>;
+/**
+ * Decode TaskTree from unknown JSON (recursive)
+ */
+export declare function decodeTaskTree(v: unknown): Result<TaskTree, DecodeError>;
+/**
+ * Decode TaskTree array (for tree without root ID)
+ */
+export declare function decodeTaskTrees(v: unknown): Result<TaskTree[], DecodeError>;
+/**
+ * Decode TaskProgress from unknown JSON
+ */
+export declare function decodeTaskProgress(v: unknown): Result<TaskProgress, DecodeError>;
+export {};
+//# sourceMappingURL=decoder.d.ts.map

package/dist/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../src/decoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AACpD,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,QAAQ,EAOb,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;;aAMT,MAAM;WACR,MAAM;;AALf;;GAEG;AACH,qBAAa,WAAY,SAAQ,gBAG7B;CAAG;AAgCP;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CA8BxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,CAiB3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CA6HhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAiBnE;AA6DD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CA2BtF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,CAAC,EAAE,OAAO,GACT,MAAM,CAAC,eAAe,GAAG,IAAI,EAAE,WAAW,CAAC,CAG7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAgCxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,CAiB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAqBhF"}