metheus-governance-mcp-cli 0.2.20 → 0.2.21

package/cli.mjs

@@ -1913,7 +1913,7 @@ async function runDoctor(flags) {
   );
 
   const syncStatus = String(summary.ctxpack_sync_status || "").trim();
-  if (["downloaded", "updated", "current"].includes(syncStatus)) {
+  if (["downloaded", "updated", "current", "home_fallback"].includes(syncStatus)) {
     addDoctorCheck(
       rows,
       "ok",
@@ -2489,20 +2489,15 @@ function syncCtxpackToLocalCache({
   const status = String(ctxpack?.status || "").trim() || "draft";
   const files = normalizeCtxpackFiles(ctxpack?.files);
   const resolvedWorkspaceDir = resolveWorkspaceDir(workspaceDir);
-  const cacheDir = path.join(ctxpackCacheRootDir(resolvedWorkspaceDir), projectID);
+  const isHomeFallback = isHomeWorkspaceRoot(resolvedWorkspaceDir) && !allowHomeWorkspaceRoot();
+  const cacheDir = path.join(
+    isHomeFallback ? homeCtxpackCacheRootDir() : ctxpackCacheRootDir(resolvedWorkspaceDir),
+    projectID,
+  );
   const metaPath = path.join(cacheDir, CTXPACK_META_FILENAME);
-  const workspaceMetaPath = path.join(resolvedWorkspaceDir, CTXPACK_META_FILENAME);
-
-  if (isHomeWorkspaceRoot(resolvedWorkspaceDir) && !allowHomeWorkspaceRoot()) {
-    return {
-      sync_status: "guarded",
-      sync_message:
-        "Workspace root resolved to home directory. Guardrail blocked ctxpack local write. Use --workspace-dir <project_path> or --workspace-dir auto.",
-      local_path: cacheDir,
-      workspace_path: resolvedWorkspaceDir,
-      local_file_count: 0,
-    };
-  }
+  const workspaceMetaPath = isHomeFallback
+    ? metaPath
+    : path.join(resolvedWorkspaceDir, CTXPACK_META_FILENAME);
 
   if (!workspaceSignalTrusted) {
     return {
@@ -2549,8 +2544,10 @@ function syncCtxpackToLocalCache({
       // Best-effort metadata refresh for workspace-root auto-detection.
     }
     return {
-      sync_status: "current",
-      sync_message: "Local ctxpack cache is up to date.",
+      sync_status: isHomeFallback ? "home_fallback" : "current",
+      sync_message: isHomeFallback
+        ? "Ctxpack cached in home directory. Workspace was not detected; use --workspace-dir for project-local cache."
+        : "Local ctxpack cache is up to date.",
       local_path: cacheDir,
       workspace_path: resolvedWorkspaceDir,
       local_file_count: files.length,
@@ -2571,10 +2568,12 @@ function syncCtxpackToLocalCache({
     fs.writeFileSync(workspaceMetaPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
 
     return {
-      sync_status: previousMeta ? "updated" : "downloaded",
-      sync_message: previousMeta
-        ? "Ctxpack updated to latest server version."
-        : "Ctxpack downloaded to local cache.",
+      sync_status: isHomeFallback ? "home_fallback" : (previousMeta ? "updated" : "downloaded"),
+      sync_message: isHomeFallback
+        ? "Ctxpack cached in home directory. Workspace was not detected; use --workspace-dir for project-local cache."
+        : (previousMeta
+          ? "Ctxpack updated to latest server version."
+          : "Ctxpack downloaded to local cache."),
       local_path: cacheDir,
       workspace_path: resolvedWorkspaceDir,
       local_file_count: files.length,

package/package.json

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