claudemesh-cli 1.9.2 → 1.9.3

package/dist/entrypoints/cli.js

@@ -88,7 +88,7 @@ __export(exports_urls, {
   VERSION: () => VERSION,
   URLS: () => URLS
 });
-var URLS, VERSION = "1.9.2", env;
+var URLS, VERSION = "1.9.3", env;
 var init_urls = __esm(() => {
   URLS = {
     BROKER: process.env.CLAUDEMESH_BROKER_URL ?? "wss://ic.claudemesh.com/ws",
@@ -7083,6 +7083,61 @@ var init_recall = __esm(() => {
   init_exit_codes();
 });
 
+// src/cli/validators.ts
+function validateMessageId(input) {
+  if (!input) {
+    return {
+      ok: false,
+      code: "missing",
+      reason: "message id is required",
+      expected: "32-char base62 id, or ≥8-char prefix"
+    };
+  }
+  if (input.length < 8) {
+    return {
+      ok: false,
+      code: "too_short",
+      reason: `id is ${input.length} chars, needs ≥8`,
+      expected: "8+ chars (paste from a previous send/post output)"
+    };
+  }
+  if (input.length > 32) {
+    return {
+      ok: false,
+      code: "too_long",
+      reason: `id is ${input.length} chars, max 32`,
+      expected: "trim trailing characters"
+    };
+  }
+  if (!BASE62_RE.test(input)) {
+    return {
+      ok: false,
+      code: "bad_charset",
+      reason: "id contains characters outside [A-Za-z0-9]",
+      expected: "base62 only"
+    };
+  }
+  return { ok: true, value: { value: input, isPrefix: input.length < 32 } };
+}
+function renderValidationError(args, write = (s) => process.stderr.write(s)) {
+  write(`  \x1B[31m✘\x1B[0m ${args.verb} ${args.input}
+`);
+  write(`     ${args.result.reason}.
+`);
+  if (args.result.expected) {
+    write(`     expected: ${args.result.expected}
+`);
+  }
+  if (args.nearest) {
+    write(`     did you mean: \x1B[36m${args.nearest}\x1B[0m
+`);
+  }
+}
+var BASE62_RE;
+var init_validators = __esm(() => {
+  BASE62_RE = /^[A-Za-z0-9]+$/;
+});
+
 // src/commands/broker-actions.ts
 var exports_broker_actions = {};
 __export(exports_broker_actions, {
@@ -7246,17 +7301,44 @@ async function runForget(id, opts) {
   return EXIT.SUCCESS;
 }
 async function runMsgStatus(id, opts) {
-  if (!id) {
-    render.err("Usage: claudemesh msg-status <message-id>");
+  const v = validateMessageId(id);
+  if (!v.ok) {
+    if (opts.json) {
+      console.log(JSON.stringify({
+        ok: false,
+        error: "invalid_argument",
+        field: "messageId",
+        code: v.code,
+        reason: v.reason,
+        expected: v.expected
+      }));
+    } else {
+      renderValidationError({
+        verb: "msg-status",
+        input: id ?? "(missing)",
+        result: v
+      });
+    }
     return EXIT.INVALID_ARGS;
   }
+  const lookupId = v.value.value;
   return await withMesh({ meshSlug: opts.mesh ?? null }, async (client) => {
-    const result = await client.messageStatus(id);
+    const result = await client.messageStatus(lookupId);
     if (!result) {
-      if (opts.json)
-        console.log(JSON.stringify({ id, found: false }));
-      else
-        render.err(`Message ${id} not found or timed out.`);
+      if (opts.json) {
+        console.log(JSON.stringify({
+          ok: false,
+          error: "not_found",
+          id: lookupId,
+          isPrefix: v.value.isPrefix
+        }));
+      } else {
+        const hint = v.value.isPrefix ? `   no message id starts with ${dim('"' + lookupId + '"')} in this mesh.
+   try: claudemesh msg-status <full-32-char-id>` : `   message ${dim(lookupId.slice(0, 12) + "…")} not in queue (already drained, expired, or never sent in this mesh).`;
+        render.err(`message not found`);
+        process.stderr.write(hint + `
+`);
+      }
       return EXIT.NOT_FOUND;
     }
     if (opts.json) {
@@ -7388,6 +7470,7 @@ var init_broker_actions = __esm(() => {
   init_render();
   init_styles();
   init_exit_codes();
+  init_validators();
 });
 
 // src/commands/remind.ts
@@ -13748,6 +13831,7 @@ async function gate(ctx, opts) {
 }
 
 // src/entrypoints/cli.ts
+init_styles();
 installSignalHandlers();
 installErrorHandlers();
 var { command, positionals, flags } = parseArgv(process.argv);
@@ -13909,9 +13993,44 @@ Flags
   -y, --yes                        skip confirmations (= --approval-mode yolo)
   -q, --quiet                      suppress non-essential output
 `;
+function colorizeHelp(raw) {
+  const lines = raw.split(`
+`);
+  const SECTION_HEADER_RE = /^([A-Z][A-Za-z0-9 /+-]*?)(\s*\(.*\))?$/;
+  const VERB_ROW_RE = /^(\s{2})(claudemesh[^\s]*(?:\s+[^\s]+)*?)(\s{2,})(.*)$/;
+  const ALIAS_RE = /(\(alias[^)]*\))/g;
+  const out = [];
+  for (const line of lines) {
+    if (line.startsWith("claudemesh —")) {
+      out.push(orange(line));
+      continue;
+    }
+    if (line.trim() === "") {
+      out.push(line);
+      continue;
+    }
+    if (!line.startsWith(" ") && SECTION_HEADER_RE.test(line)) {
+      const m = line.match(SECTION_HEADER_RE);
+      const head = bold(clay(m[1]));
+      const meta = m[2] ? dim(m[2]) : "";
+      out.push(head + meta);
+      continue;
+    }
+    const verbMatch = line.match(VERB_ROW_RE);
+    if (verbMatch) {
+      const [, indent, syntax, gap, rest] = verbMatch;
+      const dimmedRest = rest.replace(ALIAS_RE, (m) => dim(m));
+      out.push(`${indent}${cyan(syntax)}${gap}${dimmedRest}`);
+      continue;
+    }
+    out.push(line);
+  }
+  return out.join(`
+`);
+}
 async function main() {
   if (flags.help || flags.h) {
-    console.log(HELP);
+    console.log(colorizeHelp(HELP));
     process.exit(EXIT.SUCCESS);
   }
   if (flags.version || flags.V) {
@@ -14727,4 +14846,4 @@ main().catch((err) => {
   process.exit(EXIT.INTERNAL_ERROR);
 });
 
-//# debugId=25CA2A7E4B8DBD3564756E2164756E21
+//# debugId=AEE2B186929FB60F64756E2164756E21