metheus-governance-mcp-cli 0.2.45 → 0.2.47

package/cli.mjs

@@ -3616,6 +3616,28 @@ function appendToolAliasesToToolsListResponse(responseObj, canonicalToAlias) {
   return responseObj;
 }
 
+function rewriteToolsListToSafeAliasesOnly(responseObj, canonicalToAlias) {
+  const result = safeObject(responseObj.result);
+  const tools = ensureArray(result.tools);
+  const out = [];
+  const used = new Set();
+
+  for (const tool of tools) {
+    const safeTool = safeObject(tool);
+    const canonicalName = String(safeTool.name || "").trim();
+    if (!canonicalName) continue;
+    const aliasName = String(canonicalToAlias.get(canonicalName) || "").trim();
+    const finalName = aliasName || canonicalName;
+    if (used.has(finalName)) continue;
+    used.add(finalName);
+    out.push({ ...safeTool, name: finalName });
+  }
+
+  result.tools = out;
+  responseObj.result = result;
+  return responseObj;
+}
+
 function rewriteAliasedToolCallToCanonical(requestObj, aliasToCanonical) {
   if (!isJsonRpcMethod(requestObj, "tools/call")) return requestObj;
   const params = safeObject(requestObj.params);
@@ -3697,17 +3719,20 @@ function appendProjectHintToInitialize(responseObj, args, options = {}) {
   const projectSummaryTool = displayToolNameForClient("project.summary", useSafeToolAliases);
   const projectDescribeTool = displayToolNameForClient("project.describe", useSafeToolAliases);
   const projectGetTool = displayToolNameForClient("project.get", useSafeToolAliases);
+  const ctxpackEnsureTool = displayToolNameForClient("ctxpack.ensure", useSafeToolAliases);
   const ctxpackMergeBriefTool = displayToolNameForClient("ctxpack.merge.brief", useSafeToolAliases);
   const ctxpackMergeExecuteTool = displayToolNameForClient("ctxpack.merge.execute", useSafeToolAliases);
   const hintLines = [
     "High-priority project bootstrap rule:",
     ...(useSafeToolAliases
       ? [
-          "- This session supports safe MCP tool aliases (underscore format). Prefer `project_summary` / `ctxpack_ensure` / `workitem_list`; dotted names are also accepted.",
+          "- This session uses safe MCP tool aliases (underscore format). Use `project_summary` / `ctxpack_ensure` / `workitem_list` style names, not dotted names.",
         ]
       : []),
     `- MUST call \`${projectSummaryTool}\` first when the user provides only a Project ID or asks project overview/agenda.`,
     `- \`${projectDescribeTool}\` and \`${projectGetTool}\` are aliases of \`${projectSummaryTool}\`.`,
+    `- Never handle a bare Project ID by local file/transcript search before \`${projectSummaryTool}\` succeeds.`,
+    `- Run \`${ctxpackEnsureTool}\` only after \`${projectSummaryTool}\`, and only when additional ctxpack refresh/export context is needed.`,
     "- After project summary, use workitem/evidence/decision tools as follow-up.",
     `- Before any ctxpack merge, call \`${ctxpackMergeBriefTool}\` first, share recommendation to owner, get explicit owner confirmation, then call \`${ctxpackMergeExecuteTool}\`.`,
     "- IMPORTANT: When calling ANY tool, always include your current working directory / project folder path as the `workspace_dir` argument. This enables ctxpack files to be synced to the correct workspace location.",
@@ -3716,7 +3741,13 @@ function appendProjectHintToInitialize(responseObj, args, options = {}) {
     hintLines.splice(1, 0, `- Default project_id is ${args.projectID}.`);
   }
   const hint = `${hintLines.join("\n")}\n`;
-  const current = String(result.instructions || "").trimEnd();
+  let current = String(result.instructions || "").trimEnd();
+  if (current) {
+    current = current.replace(
+      /If a user provides only Project ID,\s*call ctxpack\.ensure first[^.\n]*[.\n]?/gi,
+      `If a user provides only Project ID, call ${projectSummaryTool} first. Then call ${ctxpackEnsureTool} only if additional ctxpack refresh is needed.\n`,
+    );
+  }
   result.instructions = current ? `${hint}\n${current}` : hint;
   responseObj.result = result;
   return responseObj;
@@ -4650,7 +4681,7 @@ async function runProxy(flags) {
               const aliasMaps = buildToolAliasMaps(tools);
               sessionToolAliasToCanonical = aliasMaps.aliasToCanonical;
               sessionToolCanonicalToAlias = aliasMaps.canonicalToAlias;
-              patched = appendToolAliasesToToolsListResponse(patched, sessionToolCanonicalToAlias);
+              patched = rewriteToolsListToSafeAliasesOnly(patched, sessionToolCanonicalToAlias);
             }
           } else if (isJsonRpcMethod(requestObj, "initialize")) {
             patched = appendProjectHintToInitialize(patched, args, {

package/package.json

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