diffwiki 0.2.0-rc.f44d17c → 0.3.0-rc.202607211217.f5290fa

package/dist/bin.js

@@ -45,11 +45,112 @@ function withErrors(fn) {
 var collect = (value, previous) => previous.concat([value]);
 var splitTags = (raw) => raw.flatMap((t) => t.split(",")).map((t) => t.trim()).filter((t) => t.length > 0);
 
+// src/ui-server.ts
+import { spawn } from "child_process";
+import { platform } from "os";
+import fs from "fs/promises";
+import path from "path";
+import http from "http";
+import { resolveHome } from "diffwiki-core";
+var DEFAULT_PORT = 4321;
+function statePath() {
+  return path.join(resolveHome(), "ui.json");
+}
+async function readState() {
+  try {
+    return JSON.parse(await fs.readFile(statePath(), "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+async function writeState(state) {
+  await fs.mkdir(resolveHome(), { recursive: true });
+  await fs.writeFile(statePath(), `${JSON.stringify(state, null, 2)}
+`, "utf8");
+}
+async function clearState() {
+  await fs.rm(statePath(), { force: true });
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function openCommand() {
+  switch (platform()) {
+    case "darwin":
+      return { cmd: "open", args: (u) => [u] };
+    case "win32":
+      return { cmd: "cmd", args: (u) => ["/c", "start", "", u] };
+    default:
+      return { cmd: "xdg-open", args: (u) => [u] };
+  }
+}
+function openBrowser(url) {
+  const { cmd, args } = openCommand();
+  spawn(cmd, args(url), { stdio: "ignore", detached: true }).unref();
+}
+function waitForServer(url, timeoutMs = 3e4) {
+  const deadline = Date.now() + timeoutMs;
+  return new Promise((resolve) => {
+    const tick = () => {
+      const req = http.get(url, (res) => {
+        res.resume();
+        resolve(true);
+      });
+      req.on("error", () => {
+        if (Date.now() > deadline) resolve(false);
+        else setTimeout(tick, 500);
+      });
+    };
+    tick();
+  });
+}
+async function startUi(port = DEFAULT_PORT) {
+  const child = spawn("npx", ["-y", "diffwiki-app@latest", "--port", String(port)], {
+    env: { ...process.env, PORT: String(port), HOST: "127.0.0.1" },
+    detached: true,
+    stdio: "ignore"
+  });
+  if (child.pid === void 0) {
+    throw new Error("failed to spawn diffwiki-app");
+  }
+  child.on("close", () => {
+    void clearState();
+  });
+  child.unref();
+  const state = {
+    pid: child.pid,
+    port,
+    url: `http://127.0.0.1:${port}`,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await writeState(state);
+  return state;
+}
+async function stopUi() {
+  const state = await readState();
+  if (!state) return void 0;
+  try {
+    if (platform() === "win32") process.kill(state.pid);
+    else process.kill(-state.pid);
+  } catch {
+  }
+  await clearState();
+  return state;
+}
+
 // src/cli.ts
 var icon = (level) => level === "ok" ? "\u2713" : level === "warn" ? "!" : "\u2716";
 function createProgram() {
   const program = new Command();
   program.name("diffwiki").description("A git-based knowledge base").version(version).showHelpAfterError();
+  program.action(() => {
+    program.outputHelp();
+  });
   program.command("list").description("List all collections").action(
     withErrors(async () => {
       const collections = await listCollections();
@@ -144,6 +245,47 @@ function createProgram() {
       }
     })
   );
+  program.command("up").description("Start the diffwiki UI (latest published diffwiki-app)").option("-p, --port <port>", "port to serve on", "4321").action(
+    withErrors(async (opts) => {
+      const existing = await readState();
+      if (existing && isAlive(existing.pid)) {
+        console.log(`UI already running at ${existing.url} (pid ${existing.pid})`);
+        return;
+      }
+      const state = await startUi(Number(opts.port));
+      const ok = await waitForServer(state.url);
+      console.log(
+        ok ? `UI started at ${state.url} (pid ${state.pid})` : `Launched (pid ${state.pid}) but ${state.url} did not respond yet \u2014 check \`diffwiki status\``
+      );
+    })
+  );
+  program.command("down").description("Stop the running diffwiki UI").action(
+    withErrors(async () => {
+      const stopped = await stopUi();
+      console.log(stopped ? `Stopped UI (pid ${stopped.pid})` : "UI is not running.");
+    })
+  );
+  program.command("status").description("Show whether the diffwiki UI is running").action(
+    withErrors(async () => {
+      const state = await readState();
+      if (state && isAlive(state.pid)) {
+        console.log(`running \xB7 ${state.url} \xB7 pid ${state.pid} \xB7 since ${state.startedAt}`);
+      } else {
+        console.log("stopped");
+      }
+    })
+  );
+  program.command("open").description("Open the diffwiki UI in the browser (starting it if needed)").option("-p, --port <port>", "port to serve on", "4321").action(
+    withErrors(async (opts) => {
+      let state = await readState();
+      if (!state || !isAlive(state.pid)) {
+        state = await startUi(Number(opts.port));
+        await waitForServer(state.url);
+      }
+      openBrowser(state.url);
+      console.log(`Opening ${state.url}`);
+    })
+  );
   return program;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffwiki",
-  "version": "0.2.0-rc.f44d17c",
+  "version": "0.3.0-rc.202607211217.f5290fa",
   "description": "diffwiki command-line interface",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "commander": "^13.0.0",
-    "diffwiki-core": "0.2.0-rc.f44d17c"
+    "diffwiki-core": "0.3.0-rc.202607211217.f5290fa"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"