@chamba/mcp 0.3.1 → 0.3.2

package/dist/main.js

@@ -585,6 +585,58 @@ function registerSummarizeToVault(server, logger, services) {
   );
 }
 
+// src/tools/vault-status.ts
+import { listVaultNotes, ObsidianDetector as ObsidianDetector3 } from "@chamba/core";
+var TOOL_NAME13 = "chamba_vault_status";
+var DESCRIPTION13 = "Diagnose the Obsidian vault connection: the resolved vault path, whether it was found, and the markdown notes chamba can actually see (the same set `chamba_load_context` searches). Use this to confirm the vault points at the vault root (the folder containing `.obsidian`), not at `.obsidian` itself.";
+var MAX_LISTED = 50;
+function registerVaultStatus(server, logger, services) {
+  server.registerTool(
+    TOOL_NAME13,
+    {
+      title: "Vault status",
+      description: DESCRIPTION13,
+      inputSchema: {}
+    },
+    async () => {
+      const detection = await new ObsidianDetector3(services.fs).detect({
+        explicitPath: services.obsidianVaultPath,
+        searchRoots: obsidianSearchRoots(services)
+      });
+      if (!detection.found || !detection.path) {
+        const text2 = `No Obsidian vault found.
+Set CHAMBA_OBSIDIAN_VAULT_PATH to your vault root (the folder containing .obsidian), or place the vault under a common location. Searched: ${obsidianSearchRoots(services).join(", ")}.`;
+        logger.info({ tool: TOOL_NAME13, found: false }, "vault-status");
+        return {
+          content: [{ type: "text", text: text2 }],
+          structuredContent: { found: false }
+        };
+      }
+      const paths = await listVaultNotes(services.fs, detection.path);
+      const names = paths.map((p) => p.slice(detection.path?.length ?? 0).replace(/^\/+/, ""));
+      const source = services.obsidianVaultPath ? "CHAMBA_OBSIDIAN_VAULT_PATH" : "autodetected";
+      logger.info({ tool: TOOL_NAME13, vault: detection.path, notes: names.length }, "vault-status");
+      const shown = names.slice(0, MAX_LISTED);
+      const more = names.length > MAX_LISTED ? `
+\u2026and ${names.length - MAX_LISTED} more` : "";
+      const text = `Vault: ${detection.path} (${source})
+Notes chamba can see: ${names.length}
+
+${shown.map((n) => `- ${n}`).join("\n")}${more}` + (names.length === 0 ? "\n\n\u26A0\uFE0F No notes found. If your path ends in `.obsidian`, point it at the parent folder instead." : "");
+      return {
+        content: [{ type: "text", text }],
+        structuredContent: {
+          found: true,
+          vaultPath: detection.path,
+          source,
+          noteCount: names.length,
+          notes: shown
+        }
+      };
+    }
+  );
+}
+
 // src/tools/workspace-init.ts
 import {
   joinPath as joinPath4,
@@ -594,14 +646,14 @@ import {
   WorkspaceScanner as WorkspaceScanner4
 } from "@chamba/core";
 import { z as z12 } from "zod";
-var TOOL_NAME13 = "chamba_workspace_init";
-var DESCRIPTION13 = "Scan the workspace and generate `.chamba/workspace.md` (description, languages, framework, conventions, active projects, folder map). Respects .gitignore/.dockerignore and never reads node_modules or binaries. If the file already exists it is NOT overwritten \u2014 its current contents are returned so the model/user decides what to do.";
+var TOOL_NAME14 = "chamba_workspace_init";
+var DESCRIPTION14 = "Scan the workspace and generate `.chamba/workspace.md` (description, languages, framework, conventions, active projects, folder map). Respects .gitignore/.dockerignore and never reads node_modules or binaries. If the file already exists it is NOT overwritten \u2014 its current contents are returned so the model/user decides what to do.";
 function registerWorkspaceInit(server, logger, services) {
   server.registerTool(
-    TOOL_NAME13,
+    TOOL_NAME14,
     {
       title: "Init workspace",
-      description: DESCRIPTION13,
+      description: DESCRIPTION14,
       inputSchema: {
         root: z12.string().optional().describe("Workspace root to scan. Defaults to the directory chamba runs in.")
       }
@@ -611,7 +663,7 @@ function registerWorkspaceInit(server, logger, services) {
       const wsPath = joinPath4(workspaceRoot, WORKSPACE_RELATIVE_PATH);
       if (await services.fs.exists(wsPath)) {
         const currentContents = await services.fs.readFile(wsPath);
-        logger.info({ tool: TOOL_NAME13, wsPath }, "workspace.md already exists, not overwriting");
+        logger.info({ tool: TOOL_NAME14, wsPath }, "workspace.md already exists, not overwriting");
         return {
           content: [
             {
@@ -631,7 +683,7 @@ ${currentContents}`
       await services.fs.mkdir(joinPath4(workspaceRoot, WORKSPACE_DIR4));
       await services.fs.writeFile(wsPath, markdown);
       logger.info(
-        { tool: TOOL_NAME13, wsPath, projects: workspace.projects.length },
+        { tool: TOOL_NAME14, wsPath, projects: workspace.projects.length },
         "workspace.md created"
       );
       return {
@@ -657,20 +709,20 @@ import {
   WORKSPACE_RELATIVE_PATH as WORKSPACE_RELATIVE_PATH2,
   WorkspaceScanner as WorkspaceScanner5
 } from "@chamba/core";
-var TOOL_NAME14 = "chamba_workspace_reload";
-var DESCRIPTION14 = "Re-scan the workspace and return a diff against the current `.chamba/workspace.md`. NEVER overwrites the file \u2014 the user may have hand-edited it. The model decides whether to apply changes.";
+var TOOL_NAME15 = "chamba_workspace_reload";
+var DESCRIPTION15 = "Re-scan the workspace and return a diff against the current `.chamba/workspace.md`. NEVER overwrites the file \u2014 the user may have hand-edited it. The model decides whether to apply changes.";
 function registerWorkspaceReload(server, logger, services) {
   server.registerTool(
-    TOOL_NAME14,
+    TOOL_NAME15,
     {
       title: "Reload workspace",
-      description: DESCRIPTION14,
+      description: DESCRIPTION15,
       inputSchema: {}
     },
     async () => {
       const wsPath = joinPath5(services.cwd, WORKSPACE_RELATIVE_PATH2);
       if (!await services.fs.exists(wsPath)) {
-        logger.info({ tool: TOOL_NAME14, wsPath }, "no workspace.md to reload");
+        logger.info({ tool: TOOL_NAME15, wsPath }, "no workspace.md to reload");
         return {
           content: [
             {
@@ -684,7 +736,7 @@ function registerWorkspaceReload(server, logger, services) {
       const scanner = new WorkspaceScanner5(services.fs);
       const rescanned = renderWorkspaceMarkdown2(await scanner.scan(services.cwd));
       if (textsEqual(current, rescanned)) {
-        logger.info({ tool: TOOL_NAME14, wsPath }, "workspace.md up to date");
+        logger.info({ tool: TOOL_NAME15, wsPath }, "workspace.md up to date");
         return {
           content: [
             {
@@ -694,7 +746,7 @@ function registerWorkspaceReload(server, logger, services) {
           ]
         };
       }
-      logger.info({ tool: TOOL_NAME14, wsPath }, "workspace.md differs from re-scan");
+      logger.info({ tool: TOOL_NAME15, wsPath }, "workspace.md differs from re-scan");
       return {
         content: [
           {
@@ -713,24 +765,24 @@ ${diffLines(current, rescanned)}
 
 // src/tools/workspace-show.ts
 import { joinPath as joinPath6, WORKSPACE_RELATIVE_PATH as WORKSPACE_RELATIVE_PATH3 } from "@chamba/core";
-var TOOL_NAME15 = "chamba_workspace_show";
-var DESCRIPTION15 = "Show the current workspace map. Reads `.chamba/workspace.md` from the workspace root and returns its contents. If no workspace file exists yet, says so \u2014 the model can then run chamba_workspace_init to create one.";
+var TOOL_NAME16 = "chamba_workspace_show";
+var DESCRIPTION16 = "Show the current workspace map. Reads `.chamba/workspace.md` from the workspace root and returns its contents. If no workspace file exists yet, says so \u2014 the model can then run chamba_workspace_init to create one.";
 function registerWorkspaceShow(server, logger, services) {
   server.registerTool(
-    TOOL_NAME15,
+    TOOL_NAME16,
     {
       title: "Show workspace",
-      description: DESCRIPTION15,
+      description: DESCRIPTION16,
       inputSchema: {}
     },
     async () => {
       const path = joinPath6(services.cwd, WORKSPACE_RELATIVE_PATH3);
       try {
         const contents = await services.fs.readFile(path);
-        logger.info({ tool: TOOL_NAME15, path }, "workspace.md read");
+        logger.info({ tool: TOOL_NAME16, path }, "workspace.md read");
         return { content: [{ type: "text", text: contents }] };
       } catch {
-        logger.info({ tool: TOOL_NAME15, path }, "no workspace.md found");
+        logger.info({ tool: TOOL_NAME16, path }, "no workspace.md found");
         return {
           content: [
             {
@@ -754,6 +806,7 @@ function createServer(logger, services = createNodeServices()) {
   registerWorkspaceReload(server, logger, services);
   registerLoadContext(server, logger, services);
   registerSummarizeToVault(server, logger, services);
+  registerVaultStatus(server, logger, services);
   registerGeneratePlan(server, logger, services);
   registerReviewPlan(server, logger, services);
   registerCreateWorktree(server, logger, services);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chamba/mcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "chamba MCP server — orchestration, workspace, worktree and Obsidian tools for any MCP-capable editor",
   "license": "MIT",
   "type": "module",
@@ -36,8 +36,8 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "pino": "^9.0.0",
     "zod": "^3.23.0",
-    "@chamba/adapters": "0.3.1",
-    "@chamba/core": "0.3.1"
+    "@chamba/adapters": "0.3.2",
+    "@chamba/core": "0.3.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",