metheus-governance-mcp-cli 0.2.12 → 0.2.13

package/cli.mjs

@@ -35,12 +35,12 @@ function printUsage() {
       "Metheus Governance MCP CLI",
       "",
       "Usage:",
-      `  ${cmd} [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path>] [--flow <auto|device|callback|manual>]`,
+      `  ${cmd} [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path|auto>] [--flow <auto|device|callback|manual>]`,
       `  ${cmd} init [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--flow <auto|device|callback|manual>]`,
-      `  ${cmd} setup [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path>] [--name <server_name>]`,
+      `  ${cmd} setup [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path|auto>] [--name <server_name>]`,
       `  ${cmd} doctor [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--timeout-seconds <n>]`,
-      `  ${cmd} proxy [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path>] [--include-drafts <true|false>] [--auto-pull-on-conflict <true|false>] [--timeout-seconds <n>]`,
-      `  ${cmd} ctxpack pull [--project-id <uuid>] [--base-url <url>] [--workspace-dir <path>] [--paths <csv>] [--timeout-seconds <n>]`,
+      `  ${cmd} proxy [--project-id <uuid>] [--ctxpack-key <key>] [--base-url <url>] [--workspace-dir <path|auto>] [--include-drafts <true|false>] [--auto-pull-on-conflict <true|false>] [--timeout-seconds <n>]`,
+      `  ${cmd} ctxpack pull [--project-id <uuid>] [--base-url <url>] [--workspace-dir <path|auto>] [--paths <csv>] [--timeout-seconds <n>]`,
       `  ${cmd} auth status`,
       `  ${cmd} auth login [--base-url <url>] [--flow <auto|device|callback|manual>] [--keycloak-url <url>] [--realm <name>] [--client-id <id>] [--open-browser <true|false>] [--callback-port <n>] [--timeout-seconds <n>] [--manual <true|false>]`,
       `  ${cmd} auth set --token <jwt> [--refresh-token <token>] [--base-url <url>]`,
@@ -285,6 +285,13 @@ function resolveWorkspaceDir(rawPath) {
   return path.resolve(process.cwd());
 }
 
+function isAutoWorkspaceMode(rawValue) {
+  const value = String(rawValue || "")
+    .trim()
+    .toLowerCase();
+  return value === "auto" || value === "dynamic" || value === "client";
+}
+
 function fileURIToLocalPath(rawValue) {
   const value = String(rawValue || "").trim();
   if (!value || !/^file:\/\//i.test(value)) return "";
@@ -4004,13 +4011,17 @@ function resolveSetupContext(flags) {
   const ctxpackKey = String(flags["ctxpack-key"] || buildCtxpackKeyFromMeta(workspaceMeta) || "").trim();
   const baseURL = String(flags["base-url"] || DEFAULT_SITE_URL).trim().replace(/\/+$/, "");
   const workspaceDirRaw = String(flags["workspace-dir"] || "").trim();
-  const hasExplicitWorkspaceDir = workspaceDirRaw.length > 0;
-  const workspaceDir = resolveWorkspaceDir(hasExplicitWorkspaceDir ? workspaceDirRaw : process.cwd());
+  const workspaceAutoMode = isAutoWorkspaceMode(workspaceDirRaw);
+  const hasWorkspaceDirFlag = workspaceDirRaw.length > 0;
+  const shouldPinWorkspaceDir = !workspaceAutoMode;
+  const workspaceDir = resolveWorkspaceDir(
+    hasWorkspaceDirFlag && !workspaceAutoMode ? workspaceDirRaw : process.cwd(),
+  );
   const serverName = String(flags.name || DEFAULT_SERVER_NAME).trim() || DEFAULT_SERVER_NAME;
   const proxyArgs = ["--base-url", `${baseURL}/governance/mcp`];
-  // Default mode: do not pin workspace path in MCP registration.
-  // Let client runtime cwd resolve per open folder/workspace.
-  if (hasExplicitWorkspaceDir) {
+  // Default mode pins workspace path to where setup/init runs.
+  // Use --workspace-dir auto when runtime auto-detection is preferred.
+  if (shouldPinWorkspaceDir) {
     proxyArgs.push("--workspace-dir", workspaceDir);
   }
   if (projectID) proxyArgs.push("--project-id", projectID);
@@ -4020,7 +4031,8 @@ function resolveSetupContext(flags) {
     ctxpackKey,
     baseURL,
     workspaceDir,
-    hasExplicitWorkspaceDir,
+    shouldPinWorkspaceDir,
+    workspaceAutoMode,
     serverName,
     proxyArgs,
   };
@@ -4052,9 +4064,7 @@ function runSetupInternal(flags, options = {}) {
   process.stdout.write(ensureOnly ? "\nEnsure complete.\n" : "\nInstall complete.\n");
   process.stdout.write(`Server:    ${context.serverName}\n`);
   process.stdout.write(`Gateway:   ${context.baseURL}/governance/mcp\n`);
-  process.stdout.write(
-    `Workspace: ${context.hasExplicitWorkspaceDir ? context.workspaceDir : "auto (client current folder)"}\n`,
-  );
+  process.stdout.write(`Workspace: ${context.shouldPinWorkspaceDir ? context.workspaceDir : "auto (client current folder)"}\n`);
   process.stdout.write(`Project:   ${context.projectID || "auto-detect from .metheus_ctxpack_sync.json"}\n`);
   if (context.ctxpackKey) {
     process.stdout.write(`Ctxpack:   ${context.ctxpackKey}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metheus-governance-mcp-cli",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Metheus Governance MCP CLI (setup + stdio proxy)",
   "type": "module",
   "files": [