yarlo-plugin-board 0.1.2 → 0.2.1

package/source/index.ts

@@ -1,16 +1,87 @@
+import { spawn } from "node:child_process";
+import { serve } from "@hono/node-server";
 import type { YarloPlugin } from "yarlo-types";
+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: string[]): number {
+  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: string): void {
+  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: YarloPlugin = {
   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 = (): void => {
+          server.close(() => {
+            process.exit(0);
+          });
+        };
+
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+
+        await new Promise<void>(() => {
+          /* keep process alive until signals */
+        });
       },
     },
   ],

package/source/status-field.ts

@@ -0,0 +1,28 @@
+import type { YarloConfig } from "yarlo-types";
+
+const DEFAULT_STATUS_OPTIONS = [
+  "backlog",
+  "todo",
+  "in_progress",
+  "done",
+  "cancelled",
+] as const;
+
+/**
+ * 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: YarloConfig): string[] {
+  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];
+}

package/tsconfig.json

@@ -4,5 +4,6 @@
     "outDir": "dist",
     "rootDir": "source"
   },
-  "include": ["source"]
+  "include": ["source"],
+  "exclude": ["source/**/*.test.ts"]
 }

package/vitest.config.ts

@@ -0,0 +1,14 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineProject } from "vitest/config";
+
+const root = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineProject({
+  root,
+  test: {
+    name: "yarlo-plugin-board",
+    environment: "node",
+    include: ["source/**/*.test.ts"],
+  },
+});