metheus-governance-mcp-cli 0.2.287 → 0.2.288

package/README.md

@@ -379,7 +379,7 @@ Behavior:
 - `bot room-audit` now suggests executable runner routes for the managed server+local intersection. Room visibility is still reported, but a bot no longer has to appear in the admin list before route automation can prepare it.
 - `bot room-audit` defaults to `monitor` only unless you pass `--role` or `--roles`.
 - `bot room-audit --apply true` writes missing suggested routes into `~/.metheus/bot-runner.json` and disables overlapping enabled routes in the same project/provider/destination/bot scope that are outside the selected role set.
-- `runner project up` is the route preparation path for Telegram project operations: it runs the same room audit, applies the selected role routes, and starts polling only when you explicitly pass `--start true` or `--start-detached true`.
+- `runner project up` is the one-command direct CLI path for Telegram project operations: it runs the same room audit, applies the selected role routes, and starts detached polling by default unless you explicitly pass `--start false`.
 - `runner project up` can be narrowed with `--bot-name`, `--bot-id`, `--role`, or `--roles <csv>` when you do not want every suggested role route for that room.
 - `bot remove` without flags starts a guided numbered flow: provider -> bot entry -> confirm removal.
 - Telegram stores one bot file per entry under `~/.metheus/telegram-bots/<ServerBotName>.env` with generic fields:
@@ -421,6 +421,7 @@ metheus-governance-mcp-cli bot remove --provider telegram --bot-name <server_bot
 metheus-governance-mcp-cli bot verify --provider telegram --bot-name <server_bot_name> --json true
 metheus-governance-mcp-cli bot room-audit --provider telegram --project-id <project_uuid> --destination-label <room_label> --json true
 metheus-governance-mcp-cli bot room-audit --provider telegram --project-id <project_uuid> --destination-label <room_label> --apply true --json true
+metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label>
 metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label> --start false
 metheus-governance-mcp-cli runner start-detached --project-id <project_uuid> --provider telegram --destination-label <room_label>
 metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label> --bot-name <server_bot_name> --roles monitor,review --start false
@@ -555,7 +556,7 @@ metheus-governance-mcp-cli runner start --route-name telegram-monitor --concurre
 Route management:
 - `runner route add` creates one executable route by selecting the project, provider, role, server bot, and project chat destination in order.
 - `runner route add` now auto-uses the suggested route name, `5000` ms poll interval, and `enabled=true` unless you pass explicit flags or edit the route later.
-- `runner project up` is the shortest practical route bootstrap path for Telegram: it audits one project destination, writes any missing suggested routes, and prepares that destination for later launch. It starts polling only when you explicitly pass `--start true` or `--start-detached true`.
+- `runner project up` is the shortest practical route bootstrap path for Telegram: it audits one project destination, writes any missing suggested routes, and starts detached polling by default unless you explicitly pass `--start false`.
 - if room visibility probe fails but one or more enabled routes already exist for that project destination, `runner project up` now treats the probe failure as a warning and can still start those existing routes.
 - `runner project up --dry-run-delivery true` lets the started runner validate route execution without sending a real provider message.
 - In public Telegram bot conversations, the stored route role is treated as a hint only. Live room context, the current human request, and recent bot replies take priority over the stored route role hint when the local AI client decides how to answer.
@@ -568,6 +569,7 @@ Route management:
 Recommended operational path:
 
 ```bash
+metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label>
 metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label> --start false
 metheus-governance-mcp-cli runner start-detached --project-id <project_uuid> --provider telegram --destination-label <room_label>
 metheus-governance-mcp-cli runner project up --project-id <project_uuid> --provider telegram --destination-label <room_label> --bot-name <server_bot_name> --roles monitor,review --start false

package/cli.mjs

@@ -12292,12 +12292,17 @@ function resolveRunnerProjectUpExecutionPolicy(flags = {}) {
   const applyRequested = Object.prototype.hasOwnProperty.call(flags, "apply")
     ? boolFromRaw(flags.apply, true)
     : true;
-  const startDetachedRequested = Object.prototype.hasOwnProperty.call(flags, "start-detached")
-    ? boolFromRaw(flags["start-detached"], true)
-    : boolFromRaw(flags.detached, false);
+  const explicitStartDetachedRequested = Object.prototype.hasOwnProperty.call(flags, "start-detached");
+  const explicitDetachedAliasRequested = Object.prototype.hasOwnProperty.call(flags, "detached");
+  const explicitStartRequested = Object.prototype.hasOwnProperty.call(flags, "start");
   const startRequested = Object.prototype.hasOwnProperty.call(flags, "start")
     ? boolFromRaw(flags.start, true)
     : false;
+  const startDetachedRequested = explicitStartDetachedRequested
+    ? boolFromRaw(flags["start-detached"], true)
+    : (explicitDetachedAliasRequested
+      ? boolFromRaw(flags.detached, false)
+      : !explicitStartRequested);
   const shouldStartRunner = startRequested || startDetachedRequested;
   return {
     applyRequested,
@@ -12345,7 +12350,7 @@ async function buildRunnerProjectUpResult(flags = {}) {
   const ui = createPrompter();
   try {
     if (shouldRenderPromptChrome(flags)) {
-      ui.setFlow("RUNNER PROJECT UP", "Audit one project destination, create missing runner routes, and optionally start polling when explicitly requested");
+      ui.setFlow("RUNNER PROJECT UP", "Audit one project destination, create missing runner routes, and start detached polling by default unless --start false is passed");
     }
     const provider = String(flags.provider || "").trim()
       ? normalizeBotProvider(flags.provider)
@@ -19325,7 +19330,21 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
   try {
     const projectUpPolicy = resolveRunnerProjectUpExecutionPolicy({});
     push(
-      "runner_project_up_default_policy_is_prepare_only",
+      "runner_project_up_default_policy_prefers_detached_start",
+      projectUpPolicy.applyRequested === true
+        && projectUpPolicy.startRequested === false
+        && projectUpPolicy.startDetachedRequested === true
+        && projectUpPolicy.shouldStartRunner === true,
+      `apply=${projectUpPolicy.applyRequested} start=${projectUpPolicy.startRequested} detached=${projectUpPolicy.startDetachedRequested} shouldStart=${projectUpPolicy.shouldStartRunner}`,
+    );
+  } catch (err) {
+    push("runner_project_up_default_policy_prefers_detached_start", false, String(err?.message || err));
+  }
+
+  try {
+    const projectUpPolicy = resolveRunnerProjectUpExecutionPolicy({ start: false });
+    push(
+      "runner_project_up_explicit_start_false_keeps_prepare_only",
       projectUpPolicy.applyRequested === true
         && projectUpPolicy.startRequested === false
         && projectUpPolicy.startDetachedRequested === false
@@ -19333,7 +19352,7 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
       `apply=${projectUpPolicy.applyRequested} start=${projectUpPolicy.startRequested} detached=${projectUpPolicy.startDetachedRequested} shouldStart=${projectUpPolicy.shouldStartRunner}`,
     );
   } catch (err) {
-    push("runner_project_up_default_policy_is_prepare_only", false, String(err?.message || err));
+    push("runner_project_up_explicit_start_false_keeps_prepare_only", false, String(err?.message || err));
   }
 
   try {

package/package.json

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