pi-vault-mind 0.12.10 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+
+## 0.13.0 / 0.5.0 — 2026-06-28
+
+### Added
+
+- **Arrow.js chat UI refactor** — reactive composer (`chat/arrow/`), model chip in the input bar, mentionable badges with preview popup, per-assistant-message action row (copy/info/rewind), keyboard-navigable session popover, and Arrow-based permission modals.
+- **`@agent` dispatch command** — Obsidian palette command that picks a vault-mind role, prompts for an instruction, and calls `POST /vault-mind/dispatch`; also adds `VaultMindClient.scan()` for immediate tag-based scanning.
+- **Marksman LSP tool wrappers** — `vm_backlinks`, `vm_broken_links`, `vm_related` with graceful degradation when `marksman` is unavailable.
+- **Setup model-router picker** — vault init now lets users choose the primary chat model and fallback model sequence, writing choices directly into `.pi/model-router.json`.
+- **`op://` 1Password resolution** — Modal setup resolves `op://` references via the 1Password CLI and stores the actual token in the Obsidian keychain; test-connection now sends the bearer token and reports detailed errors.
+
+### Changed
+
+- `docs/ROADMAP.md` is now the single source of truth for project direction; `docs/NEXT_STEPS.md` is deprecated.
+- `packages/obsidian/package.json` version now tracks the plugin manifest version.
+
+### Fixed
+
+- PVM_API_TOKEN injection into the `pi` subprocess via `resolveToken()` in `ChatTab.mount()`.
+- Modal test connection failing silently because it did not send an `Authorization` header.
+
 ## 0.8.0 - 2026-06-24
 
 ### Added

package/dist/src/server.d.ts

@@ -4,7 +4,7 @@
  * Endpoints:
  *   GET  /vault-mind/status     → { running, dispatches, vaults, uptime }
  *   POST /vault-mind/scan       → scan a file for @agent markers { file }
- *   POST /vault-mind/dispatch   → fire a manual dispatch
+ *   POST /vault-mind/dispatch   → fire a manual dispatch { role, instruction, file?, vault? }
  *   POST /vault-mind/context    → push active editor context from Obsidian { filePath, selection, cursor }
  *   GET  /vault-mind/context    → latest editor context (file, cursor, selection) for pi agents
  *

package/dist/src/server.js

@@ -4,7 +4,7 @@
  * Endpoints:
  *   GET  /vault-mind/status     → { running, dispatches, vaults, uptime }
  *   POST /vault-mind/scan       → scan a file for @agent markers { file }
- *   POST /vault-mind/dispatch   → fire a manual dispatch
+ *   POST /vault-mind/dispatch   → fire a manual dispatch { role, instruction, file?, vault? }
  *   POST /vault-mind/context    → push active editor context from Obsidian { filePath, selection, cursor }
  *   GET  /vault-mind/context    → latest editor context (file, cursor, selection) for pi agents
  *
@@ -33,7 +33,7 @@ import { queryGraph } from "./graph.js";
 import { searchFts, searchHybrid, upsertEntry } from "./lance.js";
 import { DEFAULT_CONFIG } from "./types.js";
 import { ensureDir, expandHome, findConfig, loadConfig, resolveInitCollectionName, shrinkHome, } from "./utils.js";
-import { processQueue, scanFile, startWatcher, stopWatcher } from "./watcher.js";
+import { createManualDispatch, processQueue, scanFile, startWatcher, stopWatcher, } from "./watcher.js";
 export function createServerState(port = 11435) {
     return { server: null, wss: null, port, startTime: 0 };
 }
@@ -85,7 +85,7 @@ export function startServer(pi, serverState, watcherState) {
         }
     }
     serverState.vaultPath = vaultPath;
-    serverState.server = http.createServer((req, res) => {
+    serverState.server = http.createServer(async (req, res) => {
         // CORS for localhost-only access
         res.setHeader("Access-Control-Allow-Origin", `http://localhost:${serverState.port}`);
         res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
@@ -116,7 +116,7 @@ export function startServer(pi, serverState, watcherState) {
                         res.end(JSON.stringify({ error: "Method not allowed" }));
                         return;
                     }
-                    handleDispatch(req, res, pi, watcherState);
+                    await handleDispatch(req, res, pi, watcherState, serverState);
                     break;
                 case "/vault-mind/context":
                     if (req.method === "POST") {
@@ -427,11 +427,61 @@ function handleScan(req, res, pi, watcherState) {
         }
     });
 }
-function handleDispatch(req, res, _pi, _watcherState) {
+async function handleDispatch(req, res, pi, watcherState, serverState) {
+    let body;
+    try {
+        body = await readJsonBody(req);
+    }
+    catch {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "Invalid JSON body" }));
+        return;
+    }
+    if (!body || typeof body !== "object") {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "Expected a JSON object body" }));
+        return;
+    }
+    if (!("role" in body) || typeof body.role !== "string" || body.role.trim() === "") {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "Missing or invalid 'role' field" }));
+        return;
+    }
+    if (!("instruction" in body) ||
+        typeof body.instruction !== "string" ||
+        body.instruction.trim() === "") {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "Missing or invalid 'instruction' field" }));
+        return;
+    }
+    if ("file" in body && body.file !== undefined && typeof body.file !== "string") {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "'file' must be a string when provided" }));
+        return;
+    }
+    if ("vault" in body && body.vault !== undefined && typeof body.vault !== "string") {
+        res.writeHead(400);
+        res.end(JSON.stringify({ error: "'vault' must be a string when provided" }));
+        return;
+    }
+    const role = body.role.trim();
+    const instruction = body.instruction.trim();
+    const file = "file" in body && typeof body.file === "string" ? body.file : undefined;
+    const vault = "vault" in body && typeof body.vault === "string" ? body.vault : undefined;
+    const vaultPath = vault || serverState.vaultPath || process.cwd();
+    const result = createManualDispatch(pi, watcherState, {
+        role,
+        instruction,
+        filePath: file,
+        vaultPath,
+    });
+    if ("error" in result) {
+        res.writeHead(500);
+        res.end(JSON.stringify({ error: result.error }));
+        return;
+    }
     res.writeHead(200);
-    res.end(JSON.stringify({
-        message: "Manual dispatch not yet implemented. Use /vm watcher status for state.",
-    }));
+    res.end(JSON.stringify({ ok: true, jobId: result.jobId, message: result.message }));
 }
 async function handleVaultMindContextUpdate(req, res, serverState) {
     const body = (await readJsonBody(req));

package/dist/src/tools/marksman.d.ts

@@ -0,0 +1,93 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+export declare const isMarksmanAvailable: () => Promise<boolean>;
+export type LspPosition = {
+    line: number;
+    character: number;
+};
+export type LspRange = {
+    start: LspPosition;
+    end: LspPosition;
+};
+export type LspLocation = {
+    uri: string;
+    range: LspRange;
+};
+export type LspDocumentLink = {
+    range: LspRange;
+    target?: string;
+    tooltip?: string;
+};
+export type LspDiagnostic = {
+    range: LspRange;
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message: string;
+};
+export type WorkspaceDiagnosticItem = {
+    uri: string;
+    kind?: number;
+    items: LspDiagnostic[];
+};
+export interface IMarksmanClient {
+    initialize(): Promise<void>;
+    openDocument(uri: string, text?: string): Promise<void>;
+    closeDocument(uri: string): Promise<void>;
+    documentLinks(uri: string): Promise<LspDocumentLink[]>;
+    documentSymbols(uri: string): Promise<unknown[]>;
+    references(uri: string, position: LspPosition): Promise<LspLocation[]>;
+    workspaceDiagnostics(): Promise<WorkspaceDiagnosticItem[]>;
+    shutdown(): Promise<void>;
+}
+export declare class MarksmanClient implements IMarksmanClient {
+    #private;
+    constructor(vaultPath: string);
+    initialize(): Promise<void>;
+    openDocument(uri: string, text?: string): Promise<void>;
+    closeDocument(uri: string): Promise<void>;
+    documentLinks(uri: string): Promise<LspDocumentLink[]>;
+    documentSymbols(uri: string): Promise<unknown[]>;
+    references(uri: string, position: LspPosition): Promise<LspLocation[]>;
+    workspaceDiagnostics(): Promise<WorkspaceDiagnosticItem[]>;
+    shutdown(): Promise<void>;
+}
+type Backlink = {
+    file: string;
+    target?: string;
+    range?: LspRange;
+};
+export declare const backlinksForNote: (client: IMarksmanClient, vaultPath: string, note: string) => Promise<{
+    note: string;
+    backlinks: Backlink[];
+}>;
+type BrokenLink = {
+    file: string;
+    message: string;
+    range?: LspRange;
+};
+export declare const brokenLinks: (client: IMarksmanClient, vaultPath: string) => Promise<{
+    broken: BrokenLink[];
+}>;
+type Edge = {
+    from: string;
+    to: string;
+    type: "backlink" | "forward";
+};
+export declare const relatedNotes: (client: IMarksmanClient, vaultPath: string, entity: string, depth?: number) => Promise<{
+    entity: string;
+    depth: number;
+    nodes: string[];
+    edges: Edge[];
+    titles: Record<string, string>;
+}>;
+export declare const vmBacklinksTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    note: Type.TString;
+}>, Record<string, unknown>, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+export declare const vmBrokenLinksTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{}>, Record<string, unknown>, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+export declare const vmRelatedTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    entity: Type.TString;
+    depth: Type.TOptional<Type.TNumber>;
+}>, Record<string, unknown>, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+export declare const registerMarksmanTools: (pi: ExtensionAPI) => void;
+export {};