@pmate/cli 0.25.6 → 0.25.7

package/README.md

@@ -48,6 +48,10 @@ pmate notion create --private --title "Private Notes" --file ./notes.md
 pmate notion update <page-id-or-url> --file ./notes.md --append
 pmate vercel projects
 pmate vercel deploys --project web --last-week
+pmate im1 health
+pmate im1 threads --limit 20
+pmate im1 messages --thread "<conversationId-or-thread-name>" --limit 50
+pmate im1 reply --source cc --thread "<conversationId-or-thread-name>" --text "hello"
 ```
 
 Notes:
@@ -159,6 +163,33 @@ Notes:
 - Platform commands such as `pmate sts`, `pmate agent`, and `pmate app` still
   default to the `@pmate/cli` session.
 
+## IM1 / CC messages
+
+`pmate im1` reads CC messages through the local `cc-bot` service at
+`http://localhost:39223` by default. Override the base URL with
+`PMATE_IM1_BASE_URL` only when debugging another local service instance.
+
+Useful commands:
+
+```bash
+pmate im1 health
+pmate im1 threads --limit 20
+pmate im1 threads --q Bug --limit 10
+pmate im1 messages --thread "<conversationId-or-thread-name>" --limit 50
+pmate im1 reply --source cc --thread "<conversationId-or-thread-name>" --text "hello"
+```
+
+`threads` and `messages` output JSON by default. Thread rows include both
+`conversationId` and `threadKey`; prefer `conversationId` when scripting or
+passing a thread back into `messages`/`reply`. Add `--text` for compact
+human-readable output.
+
+CC sync is owned by the background service in `~/dev/pcs/cc-bot`, which runs
+under PM2, keeps TimescaleDB running, listens for new CC messages, and performs
+bounded 3-day backfill. `pmate im1 collect sync --source cc` is intentionally
+disabled. Legacy yelling/custom endpoint collection still uses
+`pmate im1 collect sync --source yelling` or `--endpoint`.
+
 ## Notion config
 
 Add a Notion integration token to `~/.pmate/config.yaml`:

package/dist/index.d.ts

@@ -550,18 +550,21 @@ type CollectCommandArgs = {
 } | {
     type: Command.Collect;
     action: "health";
+    json?: boolean;
 } | {
     type: Command.Collect;
     action: "threads";
     source?: "cc";
     query?: string;
     limit?: number;
+    json?: boolean;
 } | {
     type: Command.Collect;
     action: "messages";
     source?: "cc";
     thread: string;
     limit?: number;
+    json?: boolean;
 } | {
     type: Command.Collect;
     action: "reply";

package/dist/index.js

@@ -15772,6 +15772,10 @@ var CollectCommandHandler = class {
   async handleBotThreads(args) {
     const client = new Im1BotClient();
     const threads = await client.listThreads({ q: args.query, limit: args.limit });
+    if (args.json !== false) {
+      ui.plain(JSON.stringify({ ok: true, threads }, null, 2));
+      return;
+    }
     for (const thread of threads) {
       ui.plain(formatBotThread(thread));
     }
@@ -15779,6 +15783,10 @@ var CollectCommandHandler = class {
   async handleBotMessages(args) {
     const client = new Im1BotClient();
     const messages2 = await client.listMessages({ thread: args.thread, limit: args.limit });
+    if (args.json !== false) {
+      ui.plain(JSON.stringify({ ok: true, messages: messages2 }, null, 2));
+      return;
+    }
     for (const message of messages2.reverse()) {
       ui.plain(formatBotMessage(message));
     }
@@ -15790,11 +15798,7 @@ var CollectCommandHandler = class {
       text: args.text,
       dryRun: args.dryRun
     });
-    if (args.dryRun) {
-      ui.plain(JSON.stringify(result, null, 2));
-      return;
-    }
-    ui.success("im1 reply sent", { source: "cc", thread: args.thread });
+    ui.plain(JSON.stringify(result, null, 2));
   }
   async handleSync(args) {
     let browser = null;
@@ -16176,13 +16180,18 @@ function isExternalImageRef(imagePath) {
 function formatBotThread(thread) {
   const unread = thread.unread && thread.unread > 0 ? ` unread=${thread.unread}` : "";
   const time = thread.lastMessageAt ? ` ${thread.lastMessageAt}` : "";
-  const preview = thread.preview ? ` - ${thread.preview}` : "";
+  const preview = thread.preview ? ` - ${truncateCliPreview(thread.preview, 120)}` : "";
   return `${thread.name} (${thread.conversationId})${unread}${time}${preview}`;
 }
 function formatBotMessage(message) {
   const sender = message.sender ? `${message.sender}: ` : "";
   return `[${message.sentAt}] ${sender}${message.body}`;
 }
+function truncateCliPreview(value, maxLength) {
+  const normalized = value.replace(/\s+/g, " ").replace(/\u200B/g, "").trim();
+  if (normalized.length <= maxLength) return normalized;
+  return `${normalized.slice(0, Math.max(0, maxLength - 1)).trimEnd()}\u2026`;
+}
 function filterThreadsForSync(threads, target) {
   if (!target) {
     return threads;
@@ -25680,7 +25689,7 @@ function parseIm1Args(tokens) {
     return parseIm1CollectArgs(rest);
   }
   if (action === "health") {
-    return { type: "collect" /* Collect */, action: "health" };
+    return parseIm1HealthArgs(rest);
   }
   if (action === "threads") {
     return parseIm1ThreadsArgs(rest);
@@ -25693,11 +25702,27 @@ function parseIm1Args(tokens) {
   }
   throw new Error(`Unknown im1 action: ${action}`);
 }
+function parseIm1HealthArgs(tokens) {
+  const rest = [...tokens];
+  let json = false;
+  while (rest.length > 0) {
+    const token = rest.shift();
+    switch (token) {
+      case "--json":
+        json = true;
+        break;
+      default:
+        throw new Error(`Unknown im1 health option: ${token}`);
+    }
+  }
+  return { type: "collect" /* Collect */, action: "health", json };
+}
 function parseIm1ThreadsArgs(tokens) {
   const rest = [...tokens];
   let query;
   let limit;
   let source = "cc";
+  let json = true;
   while (rest.length > 0) {
     const token = rest.shift();
     switch (token) {
@@ -25714,17 +25739,24 @@ function parseIm1ThreadsArgs(tokens) {
       case "--limit":
         limit = parsePositiveInt2(requireValue11(rest, token), token);
         break;
+      case "--json":
+        json = true;
+        break;
+      case "--text":
+        json = false;
+        break;
       default:
         throw new Error(`Unknown im1 threads option: ${token}`);
     }
   }
-  return { type: "collect" /* Collect */, action: "threads", source, query, limit };
+  return { type: "collect" /* Collect */, action: "threads", source, query, limit, json };
 }
 function parseIm1MessagesArgs(tokens) {
   const rest = [...tokens];
   let thread;
   let limit;
   let source = "cc";
+  let json = true;
   while (rest.length > 0) {
     const token = rest.shift();
     switch (token) {
@@ -25741,6 +25773,12 @@ function parseIm1MessagesArgs(tokens) {
       case "--limit":
         limit = parsePositiveInt2(requireValue11(rest, token), token);
         break;
+      case "--json":
+        json = true;
+        break;
+      case "--text":
+        json = false;
+        break;
       default:
         throw new Error(`Unknown im1 messages option: ${token}`);
     }
@@ -25748,7 +25786,7 @@ function parseIm1MessagesArgs(tokens) {
   if (!thread) {
     throw new Error("Usage: im1 messages --thread <name|conversation-id> [--limit <n>]");
   }
-  return { type: "collect" /* Collect */, action: "messages", source, thread, limit };
+  return { type: "collect" /* Collect */, action: "messages", source, thread, limit, json };
 }
 function parseIm1CollectArgs(tokens) {
   const rest = [...tokens];
@@ -26081,9 +26119,9 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.gray("                  [--count <n>]")}`,
   `  ${import_chalk4.default.gray("                  --easy [--words <n>] [--digits <n>] [--separator <s>] [--count <n>]")}`,
   `  ${import_chalk4.default.cyan("im1")}               Read and reply to local CC messages through cc-bot`,
-  `  ${import_chalk4.default.gray("                  health")}`,
-  `  ${import_chalk4.default.gray("                  threads [--q <keyword>] [--limit <n>]")}`,
-  `  ${import_chalk4.default.gray("                  messages --thread <name|conversation-id> [--limit <n>]")}`,
+  `  ${import_chalk4.default.gray("                  health [--json]")}`,
+  `  ${import_chalk4.default.gray("                  threads [--q <keyword>] [--limit <n>] [--json|--text]")}`,
+  `  ${import_chalk4.default.gray("                  messages --thread <name|conversation-id> [--limit <n>] [--json|--text]")}`,
   `  ${import_chalk4.default.gray("                  collect sync [--thread <name|conversation-id>] (--source <cc|yelling> | --endpoint <url>)")}`,
   `  ${import_chalk4.default.gray("                  reply --thread <name> --text <text> (--source <cc|yelling> | --endpoint <url>)")}`,
   `  ${import_chalk4.default.cyan("collect")}          Legacy alias for CC/yelling collection`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/cli",
-  "version": "0.25.6",
+  "version": "0.25.7",
   "description": "CLI utilities for the pMate project",
   "license": "MIT",
   "bin": {