@polderlabs/bizar 4.0.0 → 4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. v4 ships as a single npm package bundling the dashboard server, opencode plugin, and typed SDK.",
   "type": "module",
   "bin": {
@@ -21,7 +21,7 @@
     "build:sdk": "tsc -p packages/sdk/tsconfig.json",
     "test:sdk": "npm test --prefix packages/sdk",
     "test:sdk:watch": "npm run test:watch --prefix packages/sdk",
-    "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/opencode-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/opencode-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs",
+    "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/opencode-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/opencode-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs",
     "build": "npm run build:sdk"
   },
   "keywords": [

package/plugins/bizar/index.ts

@@ -120,6 +120,7 @@ import { createBgStatusTool } from "./src/tools/bg-status.js";
 import { createBgCollectTool } from "./src/tools/bg-collect.js";
 import { createBgKillTool } from "./src/tools/bg-kill.js";
 import { createBgGetCommentsTool } from "./src/tools/bg-get-comments.js";
+import { createOpenKbTool } from "./src/tools/open-kb.js";
 
 // v0.4.0 — visual plan flow: settings, slash commands, plan tools
 import { SettingsStore } from "./src/settings.js";
@@ -941,6 +942,12 @@ function buildHooks(ctx: RuntimeContext, bg: BgDeps): Hooks {
       worktree: ctx.worktree,
       logger: ctx.logger,
     }),
+    // v4.0.0 — open the Bizar Memory vault in Obsidian. Available to
+    // all agents; no serve child required.
+    bizar_open_kb: createOpenKbTool({
+      worktree: ctx.worktree,
+      logger: ctx.logger,
+    }),
   };
   const tools = bg.instanceManager
     ? {

package/plugins/bizar/src/commands.ts

@@ -265,6 +265,7 @@ function parseFlags(tokens: string[]): ParsedFlags {
  *   - `/plan comments <slug> [id]`    — tool_invocation: bizar_get_plan_comments
  *   - `/plan wait <slug> [--timeout N]`
  *                                     — deferred (returns response; no tool call)
+ *   - `/kb`                          — open the Bizar Memory vault in Obsidian
  *   - `/help` / `/commands`           — help text
  */
 export function parseSlashCommand(
@@ -293,6 +294,8 @@ export function parseSlashCommand(
       return handlePlan(rest, ctx);
     case "bizar":
       return handleBizar(rest, ctx);
+    case "kb":
+      return handleKb(rest, ctx);
     case "help":
     case "commands":
       return helpResult();
@@ -1090,12 +1093,49 @@ function handleBizar(arg: string, ctx: ParseContext): SlashCommandResult {
   };
 }
 
+// --- /kb -----------------------------------------------------------------
+
+/**
+ * v4.0.0 — `/kb` opens the Bizar Memory vault in Obsidian.
+ *
+ * Behavior:
+ *   - Routes through the `bizar_open_kb` tool via tool_invocation.
+ *   - The tool resolves the vault path from .bizar/memory.json and
+ *     spawns Obsidian (or xdg-open as fallback).
+ *   - If memory isn't initialized, the tool returns a helpful message.
+ *
+ * No subcommands. With args, returns a help pointer.
+ */
+function handleKb(arg: string, _ctx: ParseContext): SlashCommandResult {
+  const trimmed = arg.trim();
+
+  if (trimmed !== "") {
+    return {
+      handled: true,
+      response:
+        `Unknown argument: \`${trimmed}\`. \`/kb\` takes no arguments.\n\n` +
+        `Use \`/kb\` to open the Bizar Memory vault in Obsidian.\n` +
+        `Use \`bizar memory status\` to see vault details.`,
+    };
+  }
+
+  return {
+    handled: true,
+    response: "Opening Bizar Memory vault in Obsidian…",
+    sideEffect: {
+      kind: "tool_invocation",
+      toolName: "bizar_open_kb",
+      args: {},
+    },
+  };
+}
+
 // --- /help ----------------------------------------------------------------
 
 function helpResult(): SlashCommandResult {
   return {
     handled: true,
-    response: "Available commands: /visual-plan [on|off|status], /plan new <slug> [template], /plan list, /plan open <slug>, /plan get <slug>, /plan add <slug>, /plan update <slug> <id>, /plan delete <slug> <id>, /plan comment <slug> [id] \"text\", /plan comments <slug> [id], /plan status <slug> <status>, /plan wait <slug> [--timeout N], /bizar, /bizar <args>, /help. See the dialog for full descriptions.",
+    response: "Available commands: /visual-plan [on|off|status], /plan new <slug> [template], /plan list, /plan open <slug>, /plan get <slug>, /plan add <slug>, /plan update <slug> <id>, /plan delete <slug> <id>, /plan comment <slug> [id] \"text\", /plan comments <slug> [id], /plan status <slug> <status>, /plan wait <slug> [--timeout N], /kb, /bizar, /bizar <args>, /help. See the dialog for full descriptions.",
     dialog: {
       id: generateId(),
       title: "Bizar Commands",
@@ -1117,6 +1157,7 @@ function helpResult(): SlashCommandResult {
           { cmd: "/plan wait <slug> [--timeout N]", desc: "Wait for feedback (deferred)" },
           { cmd: "/bizar", desc: "Launch the Bizar dashboard" },
           { cmd: "/bizar <args>", desc: "Route a request via the menu" },
+          { cmd: "/kb", desc: "Open the Bizar Memory vault in Obsidian" },
           { cmd: "/help | /commands", desc: "Show this help" },
         ],
         templates: [...KNOWN_TEMPLATES],

package/plugins/bizar/src/tools/open-kb.ts

@@ -0,0 +1,191 @@
+/**
+ * open-kb.ts
+ *
+ * v4.0.0 — `bizar_open_kb` tool.
+ *
+ * Resolves the project's Bizar Memory vault from `.bizar/memory.json`
+ * and opens it in Obsidian. Falls back to printing the vault path if
+ * Obsidian isn't installed or running headlessly.
+ *
+ * Behavior:
+ *   - Reads .bizar/memory.json from worktree
+ *   - Calls resolveVault() to determine vault path
+ *   - Spawns `obsidian <vaultPath>` as a detached child
+ *   - On ENOENT, tries `xdg-open "obsidian://open?path=<vaultPath>"`
+ *   - On no display server, prints the path so the user can `cd` to it
+ *
+ * No args. Returns a JSON string with { ok, vaultPath, opened, method }.
+ */
+
+import { tool } from "@opencode-ai/plugin";
+import { z } from "zod";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+
+import type { Logger } from "../logger.js";
+
+export interface OpenKbDeps {
+  worktree: string;
+  logger: Logger;
+}
+
+interface MemoryJson {
+  version?: number;
+  backend?: string;
+  projectId?: string;
+  memoryRepo?: {
+    mode?: string;
+    path?: string;
+    remote?: string | null;
+    branch?: string;
+    namespace?: string | null;
+  };
+  namespaces?: {
+    project?: string;
+    global?: string;
+    user?: string;
+  };
+}
+
+function loadMemoryJson(worktree: string): MemoryJson | null {
+  const p = join(worktree, ".bizar", "memory.json");
+  if (!existsSync(p)) return null;
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function resolveVaultPath(worktree: string, cfg: MemoryJson | null): string | null {
+  if (!cfg) return null;
+  const mr = cfg.memoryRepo || {};
+  const mode = mr.mode || "local-only";
+  const projectId = cfg.projectId || worktree.split("/").pop() || "unknown";
+
+  if (mode === "local-only") {
+    return join(worktree, ".obsidian");
+  }
+
+  // managed or linked
+  const rawPath = mr.path || "";
+  if (!rawPath) return null;
+  const expanded = rawPath.startsWith("~")
+    ? join(homedir(), rawPath.slice(1))
+    : rawPath;
+  return join(expanded, "projects", projectId);
+}
+
+export function createOpenKbTool(deps: OpenKbDeps) {
+  return tool({
+    description:
+      "Open the Bizar Memory vault in Obsidian. Resolves the vault path " +
+      "from .bizar/memory.json and spawns Obsidian with the path. " +
+      "If Obsidian isn't installed, prints the vault path so the user " +
+      "can open it manually. Available to all agents.",
+    args: {},
+    execute: async () => {
+      const cfg = loadMemoryJson(deps.worktree);
+
+      if (!cfg) {
+        return {
+          output: JSON.stringify({
+            ok: false,
+            error: "memory_not_initialized",
+            message:
+              "Run `bizar memory init` first to set up the Bizar Memory vault.",
+          }),
+        };
+      }
+
+      const vaultPath = resolveVaultPath(deps.worktree, cfg);
+
+      if (!vaultPath) {
+        return {
+          output: JSON.stringify({
+            ok: false,
+            error: "vault_path_unresolved",
+            message: "Could not resolve vault path from .bizar/memory.json",
+            config: cfg,
+          }),
+        };
+      }
+
+      if (!existsSync(vaultPath)) {
+        return {
+          output: JSON.stringify({
+            ok: false,
+            error: "vault_not_found",
+            vaultPath,
+            message: `Vault directory does not exist at ${vaultPath}. Run \`bizar memory init\` to create it.`,
+          }),
+        };
+      }
+
+      // Try `obsidian <path>` first
+      try {
+        const child = spawn("obsidian", [vaultPath], {
+          detached: true,
+          stdio: "ignore",
+        });
+        child.on("error", () => {
+          // Fall through to xdg-open attempt
+        });
+        child.unref();
+
+        // Give it a beat — if spawn succeeded, assume success
+        return {
+          output: JSON.stringify({
+            ok: true,
+            vaultPath,
+            opened: true,
+            method: "obsidian",
+            message: `Opened vault in Obsidian at ${vaultPath}`,
+          }),
+        };
+      } catch (err) {
+        deps.logger.warn(
+          `bizar: open-kb: obsidian spawn failed: ${err instanceof Error ? err.message : String(err)}`,
+        );
+        // fall through to xdg-open
+      }
+
+      // Fallback: xdg-open with obsidian:// URI
+      try {
+        const child = spawn(
+          "xdg-open",
+          [`obsidian://open?path=${encodeURIComponent(vaultPath)}`],
+          { detached: true, stdio: "ignore" },
+        );
+        child.on("error", (err) => {
+          deps.logger.warn(`bizar: open-kb: xdg-open failed: ${err.message}`);
+        });
+        child.unref();
+
+        return {
+          output: JSON.stringify({
+            ok: true,
+            vaultPath,
+            opened: true,
+            method: "xdg-open",
+            message: `Opened vault via xdg-open at ${vaultPath}`,
+          }),
+        };
+      } catch (err) {
+        // Last resort: just print the path
+        return {
+          output: JSON.stringify({
+            ok: false,
+            error: "no_obsidian",
+            vaultPath,
+            message:
+              `Could not launch Obsidian. Vault path: ${vaultPath}\n` +
+              `Install Obsidian (https://obsidian.md) and try again, or open the vault manually with \`obsidian ${vaultPath}\`.`,
+          }),
+        };
+      }
+    },
+  });
+}

package/plugins/bizar/tests/commands.test.ts

@@ -545,4 +545,40 @@ describe("parseSlashCommand — /help includes new subcommands", () => {
       expect(text).toContain(cmd);
     }
   });
+});
+
+// ===========================================================================
+// Group 11 — v4.0.0 /kb
+// ===========================================================================
+
+describe("parseSlashCommand — /kb", () => {
+  test("parses '/kb' slash command", () => {
+    const result = parseSlashCommand("/kb", baseCtx);
+    expect(result).not.toBeNull();
+    expect(result!.handled).toBe(true);
+    expect(result!.sideEffect).toEqual({
+      kind: "tool_invocation",
+      toolName: "bizar_open_kb",
+      args: {},
+    });
+  });
+
+  test("'/kb' with args returns help", () => {
+    const result = parseSlashCommand("/kb foo", baseCtx);
+    expect(result).not.toBeNull();
+    expect(result!.handled).toBe(true);
+    expect(result!.sideEffect).toBeUndefined();
+    expect(result!.response).toContain("Unknown argument");
+  });
+
+  test("'/kb' case-insensitive", () => {
+    const r = parseSlashCommand("/KB", baseCtx);
+    expect(r).not.toBeNull();
+    expect(r!.handled).toBe(true);
+    expect(r!.sideEffect).toEqual({
+      kind: "tool_invocation",
+      toolName: "bizar_open_kb",
+      args: {},
+    });
+  });
 });