yarlo-plugin-board 0.1.2 → 0.2.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAA,MAAM,MAAM,EAAE,WAcb,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA6C/C,QAAA,MAAM,MAAM,EAAE,WAwCb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -1,14 +1,75 @@
+import { spawn } from "node:child_process";
+import { serve } from "@hono/node-server";
+import { createBoardApp } from "./board-server.js";
+const DEFAULT_PORT = 3847;
+/**
+ * Parses `--port <n>` from plugin CLI args.
+ *
+ * @param args - Arguments after `yarlo board`
+ * @returns Valid TCP port
+ */
+function parsePort(args) {
+    const idx = args.indexOf("--port");
+    if (idx >= 0 && args[idx + 1]) {
+        const n = Number.parseInt(args[idx + 1], 10);
+        if (!Number.isNaN(n) && n > 0 && n < 65536) {
+            return n;
+        }
+    }
+    return DEFAULT_PORT;
+}
+/**
+ * Opens the given URL in the system default browser.
+ *
+ * @param url - HTTP URL to open
+ */
+function openBrowser(url) {
+    const platform = process.platform;
+    if (platform === "darwin") {
+        spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
+        return;
+    }
+    if (platform === "win32") {
+        spawn("cmd", ["/c", "start", "", url], {
+            detached: true,
+            stdio: "ignore",
+            windowsHide: true,
+        }).unref();
+        return;
+    }
+    spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
+}
 const plugin = {
     name: "board",
-    version: "0.1.2",
+    version: "0.2.1",
     description: "Kanban board view for yarlo tasks",
     commands: [
         {
             name: "board",
             description: "Open the task board in your browser",
-            async run(_args, _ctx) {
-                console.log("Board plugin - coming soon!");
-                console.log("This will open a local web UI for managing tasks.");
+            async run(args, ctx) {
+                const port = parsePort(args);
+                const app = createBoardApp(ctx);
+                const server = serve({
+                    fetch: app.fetch,
+                    port,
+                    hostname: "127.0.0.1",
+                }, (info) => {
+                    const url = `http://127.0.0.1:${info.port}/`;
+                    console.log(`Board running at ${url}`);
+                    console.log("Press Ctrl+C to stop.");
+                    openBrowser(url);
+                });
+                const shutdown = () => {
+                    server.close(() => {
+                        process.exit(0);
+                    });
+                };
+                process.once("SIGINT", shutdown);
+                process.once("SIGTERM", shutdown);
+                await new Promise(() => {
+                    /* keep process alive until signals */
+                });
             },
         },
     ],

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAgB;IAC1B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,mCAAmC;IAChD,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,qCAAqC;YAClD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI;gBACnB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACnE,CAAC;SACF;KACF;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"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"}

package/dist/status-field.d.ts

@@ -0,0 +1,9 @@
+import type { YarloConfig } from "yarlo-types";
+/**
+ * Returns ordered status column keys for the Kanban board from `config.fields`.
+ *
+ * @param config - Loaded yarlo project configuration
+ * @returns Option list for the `status` single_select field, or sensible defaults
+ */
+export declare function getStatusColumnOptions(config: YarloConfig): string[];
+//# sourceMappingURL=status-field.d.ts.map

package/dist/status-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-field.d.ts","sourceRoot":"","sources":["../source/status-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAWpE"}

package/dist/status-field.js

@@ -0,0 +1,23 @@
+const DEFAULT_STATUS_OPTIONS = [
+    "backlog",
+    "todo",
+    "in_progress",
+    "done",
+    "cancelled",
+];
+/**
+ * Returns ordered status column keys for the Kanban board from `config.fields`.
+ *
+ * @param config - Loaded yarlo project configuration
+ * @returns Option list for the `status` single_select field, or sensible defaults
+ */
+export function getStatusColumnOptions(config) {
+    const def = config.fields.find((f) => f.name === "status");
+    if (def?.type === "single_select" &&
+        Array.isArray(def.options) &&
+        def.options.length > 0) {
+        return [...def.options];
+    }
+    return [...DEFAULT_STATUS_OPTIONS];
+}
+//# sourceMappingURL=status-field.js.map

package/dist/status-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-field.js","sourceRoot":"","sources":["../source/status-field.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG;IAC7B,SAAS;IACT,MAAM;IACN,aAAa;IACb,MAAM;IACN,WAAW;CACH,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC3D,IACE,GAAG,EAAE,IAAI,KAAK,eAAe;QAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1B,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EACtB,CAAC;QACD,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC;AACrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarlo-plugin-board",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,14 +12,17 @@
     }
   },
   "dependencies": {
+    "@hono/node-server": "^1.13.0",
     "hono": "^4.7.0",
-    "yarlo-types": "0.1.2"
+    "zod": "^3.24.0",
+    "yarlo-types": "0.1.3"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && cp source/board-ui.html dist/board-ui.html",
     "dev": "tsc --watch"
   }
 }

package/source/board-server.test.ts

@@ -0,0 +1,164 @@
+import { describe, expect, it, vi } from "vitest";
+import type {
+  Task,
+  UpdateTaskInput,
+  YarloConfig,
+  YarloPluginContext,
+} from "yarlo-types";
+import { DEFAULT_CONFIG } from "yarlo-types";
+import { createBoardApp } from "./board-server.js";
+
+/**
+ * Minimal task fixture for API serialization tests.
+ */
+function baseTask(overrides: Partial<Task> = {}): Task {
+  return {
+    id: "t1",
+    title: "Task",
+    content: "Body",
+    fields: { status: "backlog", priority: "low" },
+    created_at: "2024-01-01T00:00:00.000Z",
+    updated_at: "2024-01-02T00:00:00.000Z",
+    file_path: "/tmp/t1.md",
+    ...overrides,
+  };
+}
+
+/**
+ * Builds a plugin context with default mocked task operations.
+ */
+function mockContext(
+  overrides: Partial<YarloPluginContext> = {},
+): YarloPluginContext {
+  const config: YarloConfig = {
+    ...DEFAULT_CONFIG,
+    yarlo_version: "0.1.0",
+  };
+  const task = baseTask();
+  const ctx: YarloPluginContext = {
+    config,
+    configDir: "/c",
+    projectDir: "/p",
+    tasks: {
+      list: vi.fn(async () => [task]),
+      get: vi.fn(async (id: string) => {
+        if (id === "t1") return task;
+        throw new Error(`Task "${id}" not found`);
+      }),
+      create: vi.fn(),
+      update: vi.fn(async (_id: string, input: UpdateTaskInput) => ({
+        ...task,
+        title: input.title ?? task.title,
+        content: input.content ?? task.content,
+        fields: { ...task.fields, ...(input.fields ?? {}) },
+        updated_at: "2024-01-03T00:00:00.000Z",
+      })),
+      delete: vi.fn(),
+    },
+    ...overrides,
+  };
+  return ctx;
+}
+
+describe("createBoardApp", () => {
+  it("GET /api/board returns columns, tasks, and fieldDefinitions", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/board");
+    expect(res.status).toBe(200);
+    const json = (await res.json()) as {
+      columns: string[];
+      tasks: Array<{ id: string; title: string }>;
+      fieldDefinitions: unknown[];
+    };
+    expect(json.columns).toContain("backlog");
+    expect(json.tasks).toHaveLength(1);
+    expect(json.tasks[0]!.id).toBe("t1");
+    expect(json.fieldDefinitions).toEqual(ctx.config.fields);
+    expect(ctx.tasks.list).toHaveBeenCalledOnce();
+  });
+
+  it("GET /api/tasks/:id returns 200 when task exists", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/t1");
+    expect(res.status).toBe(200);
+    const json = (await res.json()) as { task: { id: string; title: string } };
+    expect(json.task.id).toBe("t1");
+    expect(json.task.title).toBe("Task");
+  });
+
+  it("GET /api/tasks/:id returns 404 when task is missing", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/missing");
+    expect(res.status).toBe(404);
+  });
+
+  it("PATCH /api/tasks/:id returns 400 for invalid JSON", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/t1", {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: "not-json{",
+    });
+    expect(res.status).toBe(400);
+  });
+
+  it("PATCH /api/tasks/:id returns 400 when body has no updatable fields", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/t1", {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({}),
+    });
+    expect(res.status).toBe(400);
+  });
+
+  it("PATCH /api/tasks/:id returns 400 for invalid status value", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/t1", {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ status: "__not_a_column__" }),
+    });
+    expect(res.status).toBe(400);
+    const json = (await res.json()) as { error: string };
+    expect(json.error).toMatch(/Invalid status/i);
+  });
+
+  it("PATCH /api/tasks/:id returns updated task when title is sent", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/api/tasks/t1", {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ title: "Renamed" }),
+    });
+    expect(res.status).toBe(200);
+    const json = (await res.json()) as { task: { title: string } };
+    expect(json.task.title).toBe("Renamed");
+    expect(ctx.tasks.update).toHaveBeenCalledWith("t1", { title: "Renamed" });
+  });
+
+  it("GET / serves board-ui.html", async () => {
+    const ctx = mockContext();
+    const app = createBoardApp(ctx);
+
+    const res = await app.request("http://localhost/");
+    expect(res.status).toBe(200);
+    const text = await res.text();
+    expect(text.length).toBeGreaterThan(100);
+    expect(text).toMatch(/html/i);
+  });
+});

package/source/board-server.ts

@@ -0,0 +1,199 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Hono } from "hono";
+import { z } from "zod";
+import type { FieldDefinition, Task, UpdateTaskInput, YarloPluginContext } from "yarlo-types";
+import { getStatusColumnOptions } from "./status-field.js";
+
+const patchBodySchema = z
+  .object({
+    status: z.string().min(1).optional(),
+    title: z.string().optional(),
+    content: z.string().optional(),
+    fields: z.record(z.unknown()).optional(),
+  })
+  .refine(
+    (d) =>
+      d.status !== undefined ||
+      d.title !== undefined ||
+      d.content !== undefined ||
+      d.fields !== undefined,
+    { message: "At least one of status, title, content, or fields is required" },
+  );
+
+export type BoardTaskJson = {
+  id: string;
+  title: string;
+  status: unknown;
+  priority: unknown;
+  labels: unknown;
+  assignee: unknown;
+  due_date: unknown;
+  estimate: unknown;
+  updated_at: string;
+};
+
+export type BoardTaskDetailJson = {
+  id: string;
+  title: string;
+  content: string;
+  fields: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+};
+
+/**
+ * Maps a task to a JSON-safe shape for the board UI (no file paths).
+ *
+ * @param task - Task from yarlo storage
+ * @returns Serializable board card payload
+ */
+function serializeBoardTask(task: Task): BoardTaskJson {
+  const f = task.fields;
+  return {
+    id: task.id,
+    title: task.title,
+    status: f.status ?? null,
+    priority: f.priority ?? null,
+    labels: f.labels ?? null,
+    assignee: f.assignee ?? null,
+    due_date: f.due_date ?? null,
+    estimate: f.estimate ?? null,
+    updated_at: task.updated_at,
+  };
+}
+
+/**
+ * Full task payload for detail view and PATCH responses (no file_path).
+ *
+ * @param task - Task from yarlo storage
+ * @returns Serializable task detail
+ */
+function serializeBoardTaskDetail(task: Task): BoardTaskDetailJson {
+  return {
+    id: task.id,
+    title: task.title,
+    content: task.content,
+    fields: { ...task.fields },
+    created_at: task.created_at,
+    updated_at: task.updated_at,
+  };
+}
+
+function isNotFoundMessage(msg: string): boolean {
+  return (
+    msg.includes("not found") ||
+    msg.includes("Ambiguous ID") ||
+    msg.includes("Ambiguous")
+  );
+}
+
+/**
+ * Builds the Hono app for the local board (HTML UI + JSON API).
+ *
+ * @param ctx - Plugin context with task operations and config
+ * @returns Configured Hono instance
+ */
+export function createBoardApp(ctx: YarloPluginContext): Hono {
+  const app = new Hono();
+  const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+
+  app.get("/", async (c) => {
+    const htmlPath = path.join(moduleDir, "board-ui.html");
+    const html = await fs.readFile(htmlPath, "utf-8");
+    return c.html(html);
+  });
+
+  app.get("/api/board", async (c) => {
+    const columns = getStatusColumnOptions(ctx.config);
+    const tasks = await ctx.tasks.list();
+    const fieldDefinitions: FieldDefinition[] = ctx.config.fields;
+    return c.json({
+      columns,
+      tasks: tasks.map(serializeBoardTask),
+      fieldDefinitions,
+    });
+  });
+
+  app.get("/api/tasks/:id", async (c) => {
+    const id = c.req.param("id");
+    try {
+      const task = await ctx.tasks.get(id);
+      return c.json({ task: serializeBoardTaskDetail(task) });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      if (isNotFoundMessage(msg)) {
+        return c.json({ error: msg }, 404);
+      }
+      return c.json({ error: msg }, 500);
+    }
+  });
+
+  app.patch("/api/tasks/:id", async (c) => {
+    const id = c.req.param("id");
+    let body: unknown;
+    try {
+      body = await c.req.json();
+    } catch {
+      return c.json({ error: "Invalid JSON body" }, 400);
+    }
+
+    const parsed = patchBodySchema.safeParse(body);
+    if (!parsed.success) {
+      const flat = parsed.error.flatten();
+      const refineMsg = parsed.error.errors.find((e) => e.code === "custom");
+      return c.json(
+        {
+          error: refineMsg?.message ?? "Validation failed",
+          details: flat,
+        },
+        400,
+      );
+    }
+
+    const columns = getStatusColumnOptions(ctx.config);
+    const fieldPatch: Record<string, unknown> = {};
+    if (parsed.data.fields) {
+      Object.assign(fieldPatch, parsed.data.fields);
+    }
+    if (parsed.data.status !== undefined) {
+      fieldPatch.status = parsed.data.status;
+    }
+
+    const statusValue =
+      typeof fieldPatch.status === "string" ? fieldPatch.status : undefined;
+    if (statusValue !== undefined && !columns.includes(statusValue)) {
+      return c.json(
+        {
+          error: `Invalid status: must be one of: ${columns.join(", ")}`,
+        },
+        400,
+      );
+    }
+
+    const updateInput: UpdateTaskInput = {};
+    if (parsed.data.title !== undefined) {
+      updateInput.title = parsed.data.title;
+    }
+    if (parsed.data.content !== undefined) {
+      updateInput.content = parsed.data.content;
+    }
+    if (Object.keys(fieldPatch).length > 0) {
+      updateInput.fields = fieldPatch;
+    }
+
+    try {
+      const task = await ctx.tasks.update(id, updateInput);
+      return c.json({ task: serializeBoardTaskDetail(task) });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      if (isNotFoundMessage(msg)) {
+        return c.json({ error: msg }, 404);
+      }
+      return c.json({ error: msg }, 500);
+    }
+  });
+
+  return app;
+}