@mnemom/mnemom 0.17.24 → 0.17.25

package/dist/commands/agent-slack.d.ts

@@ -6,7 +6,8 @@
  *   mnemom agent slack login                 # store the bot + app-level tokens (0600)
  *   mnemom agent slack logout                # remove them
  *   mnemom agent slack status                # tokens, bot identity, router, live sessions
- *   mnemom agent slack post [--channel C] [--thread TS] [--icon-emoji E] <text…|->
+ *   mnemom agent slack post [--channel C] [--thread TS] [--icon-emoji E] [--] <text…|->
+ *                                            # --help prints usage; unknown flags are refused
  *   mnemom agent slack delete [--channel C] <ts>   # delete a message THIS session posted
  *   mnemom agent slack inbox [--peek]        # unread messages addressed to THIS session
  *   mnemom agent slack listen                # this session's channel server (spawned by --slack)
@@ -21,7 +22,15 @@ interface PostArgs {
     channel?: string;
     thread?: string;
     iconEmoji?: string;
+    /** `--help` / `-h` was given: print POST_USAGE and post nothing. */
+    help?: true;
     text: string;
 }
+export declare const POST_USAGE = "Usage: mnemom agent slack post [options] [--] <text\u2026|->\n\nPost a message to Slack as this session.\n\nOptions:\n  -c, --channel <C>     channel name or id (default: slack_channel from `mnemom agent config`)\n  -t, --thread <TS>     reply in the thread whose parent message has this ts\n      --icon-emoji <E>  emoji to show as the poster's icon\n  -h, --help            show this help and exit; nothing is posted\n\nText:\n  The remaining words, joined by spaces. `-` (or no words with a piped stdin) reads stdin.\n  Any other word starting with \"-\" before `--` is refused as an unknown flag. A message\n  that starts with \"-\" must come after `--`, e.g.  mnemom agent slack post -c C1 -- \"-1 on this\"";
+/**
+ * Parse `post` arguments. Before a `--` separator, `--help`/`-h` asks for usage and any
+ * other dash-word that is not a known flag is refused, so a typo or a guessed flag can
+ * never be posted as message text. Everything after `--` is text, verbatim.
+ */
 export declare function parsePostArgs(argv: string[]): PostArgs;
 export {};

package/dist/commands/agent-slack.js

@@ -6,7 +6,8 @@
  *   mnemom agent slack login                 # store the bot + app-level tokens (0600)
  *   mnemom agent slack logout                # remove them
  *   mnemom agent slack status                # tokens, bot identity, router, live sessions
- *   mnemom agent slack post [--channel C] [--thread TS] [--icon-emoji E] <text…|->
+ *   mnemom agent slack post [--channel C] [--thread TS] [--icon-emoji E] [--] <text…|->
+ *                                            # --help prints usage; unknown flags are refused
  *   mnemom agent slack delete [--channel C] <ts>   # delete a message THIS session posted
  *   mnemom agent slack inbox [--peek]        # unread messages addressed to THIS session
  *   mnemom agent slack listen                # this session's channel server (spawned by --slack)
@@ -121,15 +122,39 @@ async function status() {
     const allow = loadLauncherConfig().slackAllow ?? [];
     out(`allowed senders: ${allow.length ? allow.join(", ") : "none — no message will reach a session"}`);
 }
+export const POST_USAGE = `Usage: mnemom agent slack post [options] [--] <text…|->
+
+Post a message to Slack as this session.
+
+Options:
+  -c, --channel <C>     channel name or id (default: slack_channel from \`mnemom agent config\`)
+  -t, --thread <TS>     reply in the thread whose parent message has this ts
+      --icon-emoji <E>  emoji to show as the poster's icon
+  -h, --help            show this help and exit; nothing is posted
+
+Text:
+  The remaining words, joined by spaces. \`-\` (or no words with a piped stdin) reads stdin.
+  Any other word starting with "-" before \`--\` is refused as an unknown flag. A message
+  that starts with "-" must come after \`--\`, e.g.  mnemom agent slack post -c C1 -- "-1 on this"`;
+const POST_SHORT_FLAGS = new Set(["-c", "-t", "-h"]);
+/**
+ * Parse `post` arguments. Before a `--` separator, `--help`/`-h` asks for usage and any
+ * other dash-word that is not a known flag is refused, so a typo or a guessed flag can
+ * never be posted as message text. Everything after `--` is text, verbatim.
+ */
 export function parsePostArgs(argv) {
     const res = { text: "" };
     const words = [];
+    let unknown;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         const val = () => {
             const v = argv[++i];
-            if (v === undefined)
+            // A flag is never a value: `--channel --help` must not eat the --help. (A short
+            // dash-word that is not a flag stays a value: `--icon-emoji -1` is Slack's thumbsdown.)
+            if (v === undefined || v.startsWith("--") || POST_SHORT_FLAGS.has(v)) {
                 throw new Error(`mnemom agent slack post: ${a} needs a value.`);
+            }
             return v;
         };
         if (a === "--channel" || a === "-c")
@@ -138,18 +163,32 @@ export function parsePostArgs(argv) {
             res.thread = val();
         else if (a === "--icon-emoji")
             res.iconEmoji = val();
+        else if (a === "--help" || a === "-h")
+            res.help = true;
         else if (a === "--") {
             words.push(...argv.slice(i + 1));
             break;
         }
+        else if (a.startsWith("-") && a !== "-")
+            unknown ??= a;
         else
             words.push(a);
     }
+    // Help wins over an unknown flag: someone asking for usage should get it.
+    if (res.help)
+        return { help: true, text: "" };
+    if (unknown !== undefined) {
+        throw new Error(`mnemom agent slack post: unknown flag ${unknown}; put message text after --. See \`mnemom agent slack post --help\`.`);
+    }
     res.text = words.join(" ");
     return res;
 }
 async function post(argv) {
     const args = parsePostArgs(argv);
+    if (args.help) {
+        process.stdout.write(POST_USAGE + "\n");
+        return;
+    }
     let text = args.text;
     if (text === "-" || (!text && !process.stdin.isTTY))
         text = readFileSync(0, "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.24",
+  "version": "0.17.25",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {