@chamba/mcp 0.5.2 → 0.6.1

package/dist/main.js

@@ -1,4 +1,6 @@
 // src/main.ts
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/logging.ts
@@ -646,14 +648,17 @@ ${shown.map((n) => `- ${n}`).join("\n")}${more}` + (names.length === 0 ? "\n\n\u
 // src/tools/workspace-init.ts
 import {
   joinPath as joinPath4,
+  ObsidianDetector as ObsidianDetector4,
   renderWorkspaceMarkdown,
+  VAULT_OVERVIEW_FILE,
+  VaultInitializer,
   WORKSPACE_DIR as WORKSPACE_DIR4,
   WORKSPACE_RELATIVE_PATH,
   WorkspaceScanner as WorkspaceScanner4
 } from "@chamba/core";
 import { z as z12 } from "zod";
 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.";
+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. When no Obsidian vault is available, it also bootstraps one at the workspace root and seeds a "Workspace overview" note (disable with createVault: false).';
 function registerWorkspaceInit(server, logger, services) {
   server.registerTool(
     TOOL_NAME14,
@@ -661,47 +666,49 @@ function registerWorkspaceInit(server, logger, services) {
       title: "Init workspace",
       description: DESCRIPTION14,
       inputSchema: {
-        root: z12.string().optional().describe("Workspace root to scan. Defaults to the directory chamba runs in.")
+        root: z12.string().optional().describe("Workspace root to scan. Defaults to the directory chamba runs in."),
+        createVault: z12.boolean().optional().describe("Bootstrap an Obsidian vault at the root when none is found (default true).")
       }
     },
-    async ({ root }) => {
+    async ({ root, createVault }) => {
       const workspaceRoot = root ?? services.cwd;
       const wsPath = joinPath4(workspaceRoot, WORKSPACE_RELATIVE_PATH);
-      if (await services.fs.exists(wsPath)) {
-        const currentContents = await services.fs.readFile(wsPath);
-        logger.info({ tool: TOOL_NAME14, wsPath }, "workspace.md already exists, not overwriting");
-        return {
-          content: [
-            {
-              type: "text",
-              text: `\`${WORKSPACE_RELATIVE_PATH}\` already exists at ${wsPath}; not overwriting.
-
-Current contents:
-
-${currentContents}`
-            }
-          ]
-        };
+      const workspace = await new WorkspaceScanner4(services.fs).scan(workspaceRoot);
+      const wsExisted = await services.fs.exists(wsPath);
+      let markdown;
+      if (wsExisted) {
+        markdown = await services.fs.readFile(wsPath);
+      } else {
+        markdown = renderWorkspaceMarkdown(workspace);
+        await services.fs.mkdir(joinPath4(workspaceRoot, WORKSPACE_DIR4));
+        await services.fs.writeFile(wsPath, markdown);
+      }
+      const wsLine = wsExisted ? `\`${WORKSPACE_RELATIVE_PATH}\` already exists at ${wsPath}; not overwriting.` : `Created \`${WORKSPACE_RELATIVE_PATH}\` at ${wsPath}.`;
+      let vaultLine = "Vault: skipped (createVault: false).";
+      if (createVault !== false) {
+        const detection = await new ObsidianDetector4(services.fs).detect({
+          explicitPath: services.obsidianVaultPath,
+          searchRoots: obsidianSearchRoots(services)
+        });
+        if (detection.found) {
+          vaultLine = `Vault: using the existing one at ${detection.path}; left it untouched.`;
+        } else {
+          const seeded = await new VaultInitializer(services.fs, services.clock).seed({
+            vaultPath: workspaceRoot,
+            workspace
+          });
+          vaultLine = `Vault: none found \u2014 created one at the workspace root and seeded \`${VAULT_OVERVIEW_FILE}\`. Add \`.obsidian/\` to .gitignore if you don't want it committed.`;
+          logger.info({ tool: TOOL_NAME14, vault: seeded.vaultPath }, "vault bootstrapped");
+        }
       }
-      const scanner = new WorkspaceScanner4(services.fs);
-      const workspace = await scanner.scan(workspaceRoot);
-      const markdown = renderWorkspaceMarkdown(workspace);
-      await services.fs.mkdir(joinPath4(workspaceRoot, WORKSPACE_DIR4));
-      await services.fs.writeFile(wsPath, markdown);
       logger.info(
-        { tool: TOOL_NAME14, wsPath, projects: workspace.projects.length },
-        "workspace.md created"
+        { tool: TOOL_NAME14, wsPath, wsExisted, projects: workspace.projects.length },
+        "workspace init"
       );
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Created \`${WORKSPACE_RELATIVE_PATH}\` at ${wsPath}.
+      return { content: [{ type: "text", text: `${wsLine}
+${vaultLine}
 
-${markdown}`
-          }
-        ]
-      };
+${markdown}` }] };
     }
   );
 }
@@ -827,7 +834,22 @@ function createServer(logger, services = createNodeServices()) {
 }
 
 // src/main.ts
+function readPackageVersion() {
+  try {
+    const pkgPath = fileURLToPath(new URL("../package.json", import.meta.url));
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 async function main() {
+  const flag = process.argv[2];
+  if (flag === "--version" || flag === "-v") {
+    process.stdout.write(`${readPackageVersion()}
+`);
+    return;
+  }
   const logger = createLogger();
   const server = createServer(logger);
   const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chamba/mcp",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "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.5.2",
-    "@chamba/core": "0.5.2"
+    "@chamba/core": "0.6.1",
+    "@chamba/adapters": "0.6.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",