diffwiki 0.3.0 → 0.4.0-rc.202607220518.0ade9d3

package/dist/bin.js

@@ -9,9 +9,15 @@ import {
   doctor,
   getConfigValue,
   initRepoWiki,
+  installPlugin,
   listCollections,
+  listPlugins,
+  listSearchModes,
+  loadSearchProvider,
   query,
+  registerPlugin,
   removeArticle,
+  removePlugin,
   removeTags,
   setConfigValue,
   setTags,
@@ -45,6 +51,104 @@ 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() {
@@ -104,15 +208,72 @@ function createProgram() {
   registerTagCommand("add-tags", addTags);
   registerTagCommand("remove-tags", removeTags);
   registerTagCommand("update-tags", setTags);
-  program.command("query").description("Search articles (dummy \u2014 QMD coming later)").option("-c, --collection <name>", "limit to a collection").argument("[term]", "search term", "").action(
+  program.command("index").description("Rebuild the search index via the active plugin").option("--embed", "also build vector embeddings (may download models on first run)").action(
+    withErrors(async (opts) => {
+      const provider = await loadSearchProvider();
+      if (!provider) {
+        const installable = (await listSearchModes()).filter((m) => m.plugin !== "native");
+        console.log(
+          installable.length > 0 ? `No index-backed plugin active. Available modes: ${installable.map((m) => `${m.plugin}\xB7${m.type}`).join(", ")}` : "No search plugin installed \u2014 using native search (nothing to index). Install one with: diffwiki plugin install <spec>"
+        );
+        return;
+      }
+      try {
+        const indexed = await provider.reindex(await listCollections(), { embed: !!opts.embed });
+        console.log(`Indexed ${indexed} document(s).`);
+      } finally {
+        await provider.close();
+      }
+    })
+  );
+  program.command("query").description("Search articles via the resolved search engine (native fallback if none)").option("--engine <name>", "search engine/plugin (default: config defaultSearch, else native)").option("-c, --collection <name>", "limit to a collection").option("-t, --type <type>", "search type (engine-defined, e.g. keyword|semantic|hybrid)").argument("[term]", "search term", "").action(
     withErrors(async (term, opts) => {
-      const hits = await query(term, opts.collection);
-      console.log(`(dummy search \u2014 QMD coming later) ${hits.length} result(s)`);
+      const queryOpts = { engine: opts.engine, collection: opts.collection, type: opts.type };
+      const hits = await query(term, queryOpts);
+      console.log(`${hits.length} result(s)`);
       for (const hit of hits) {
-        console.log(`${hit.collection}	${hit.title}	${hit.path}`);
+        const line = `${hit.collection}	${hit.title}	${hit.path}`;
+        console.log(hit.snippet ? `${line}	${hit.snippet}` : line);
       }
     })
   );
+  const plugin = program.command("plugin").description("Manage search plugins");
+  plugin.command("install").description("Install a search plugin from an npm spec and provision it (setup)").argument("<spec>", "npm package spec (name, name@version, or path)").option("--no-setup", "skip the end-to-end setup after install").option("--prefetch-models", "pre-download models during setup (heavy)").action(
+    withErrors(async (spec, opts) => {
+      const record = await installPlugin(spec, {
+        setup: opts.setup,
+        prefetchModels: opts.prefetchModels
+      });
+      console.log(`Installed "${record.name}"${record.version ? ` v${record.version}` : ""}`);
+      if (!opts.setup) console.log("Skipped setup (--no-setup) \u2014 run: diffwiki index");
+    })
+  );
+  plugin.command("register").description("Register an existing executable as a search plugin").argument("<name>", "plugin name").requiredOption("--command <cmd...>", "command argv to spawn the plugin (e.g. node /abs/adapter.js)").action(
+    withErrors(async (name, opts) => {
+      const record = await registerPlugin(name, opts.command);
+      console.log(`Registered "${record.name}" \u2192 ${record.command.join(" ")}`);
+    })
+  );
+  plugin.command("list").description("List registered search plugins").action(
+    withErrors(async () => {
+      const plugins = await listPlugins();
+      if (plugins.length === 0) {
+        console.log("No plugins registered. Install one with: diffwiki plugin install <spec>");
+        return;
+      }
+      for (const p of plugins) {
+        console.log(
+          `${p.name}	${p.kind}	${p.version ?? "-"}	enabled=${p.enabled}	managed=${!!p.managed}	spawnable=${p.spawnable}`
+        );
+      }
+    })
+  );
+  plugin.command("remove").description("Remove a search plugin").argument("<name>", "plugin name").action(
+    withErrors(async (name) => {
+      await removePlugin(name);
+      console.log(`Removed "${name}"`);
+    })
+  );
   program.command("init").description("Initialize an in-repo wiki and register it globally").option("-c, --collection <name>", "collection name (default: repo name)").option("-p, --path <path>", "wiki path within the repo (default: wiki)").action(
     withErrors(async (opts) => {
       const entry = await initRepoWiki({
@@ -124,7 +285,7 @@ function createProgram() {
       console.log("Registered globally \u2014 discoverable via: diffwiki list");
     })
   );
-  program.command("config-set").description("Set a config value (e.g. defaultCollection)").argument("<key>", "config key").argument("<value>", "config value").action(
+  program.command("config-set").description("Set a config value (e.g. defaultCollection, or defaultSearch <engine[:type]>)").argument("<key>", "config key").argument("<value>", "config value").action(
     withErrors(async (key, value) => {
       await setConfigValue(key, value);
       console.log(`Set ${key} = ${value}`);
@@ -147,6 +308,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.3.0",
+  "version": "0.4.0-rc.202607220518.0ade9d3",
   "description": "diffwiki command-line interface",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "commander": "^13.0.0",
-    "diffwiki-core": "0.3.0"
+    "diffwiki-core": "0.4.0-rc.202607220518.0ade9d3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"