@pmate/cli 0.25.6 → 0.25.8

package/README.md

@@ -48,6 +48,11 @@ 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 threads --search "titlte" --limit 5
+pmate im1 messages --thread "<conversationId-or-thread-name>" --limit 50
+pmate im1 reply --thread "<conversationId-or-thread-name>" --text "hello"
 ```
 
 Notes:
@@ -159,6 +164,38 @@ 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 threads --search "titlte" --limit 5
+pmate im1 messages --thread "<conversationId-or-thread-name>" --limit 50
+pmate im1 reply --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.
+
+Use `pmate im1 threads --search "<title>"` for fuzzy title lookup. It compares
+the lowercased search text against thread titles with edit distance, including
+nearby token/window matches for typos such as `titlte` vs `title`. JSON output
+includes `searchDistance` and `searchScore`.
+
+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` is CC-only and does not accept `--source`
+or custom `--endpoint` options.
+
 ## Notion config
 
 Add a Notion integration token to `~/.pmate/config.yaml`:

package/dist/index.d.ts

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

package/dist/index.js

@@ -15748,21 +15748,15 @@ var CollectCommandHandler = class {
       await this.handleBotMessages(args);
       return;
     }
-    if (args.source === "cc" && !args.endpoint) {
-      if (args.action === "sync") {
-        throw new Error(
-          'pmate im1 collect sync has moved to cc-bot. Start ~/dev/pcs/cc-bot and use "pmate im1 threads", "pmate im1 messages", or "pmate im1 reply".'
-        );
-      }
-      if (args.action === "reply") {
-        await this.handleBotReply(args);
-        return;
-      }
-    }
     if (args.action === "reply") {
-      await this.handleReply(args);
+      await this.handleBotReply(args);
       return;
     }
+    if (args.source === "cc" && !args.endpoint) {
+      throw new Error(
+        'CC sync has moved to cc-bot. Start ~/dev/pcs/cc-bot and use "pmate im1 threads", "pmate im1 messages", or "pmate im1 reply".'
+      );
+    }
     await this.handleSync(args);
   }
   async handleBotHealth() {
@@ -15771,14 +15765,24 @@ var CollectCommandHandler = class {
   }
   async handleBotThreads(args) {
     const client = new Im1BotClient();
-    const threads = await client.listThreads({ q: args.query, limit: args.limit });
-    for (const thread of threads) {
+    const fetchLimit = args.search ? Math.max(args.limit ?? 10, 200) : args.limit;
+    const threads = await client.listThreads({ q: args.query, limit: fetchLimit });
+    const outputThreads = args.search ? rankThreadsByTitleSearch(threads, args.search).slice(0, args.limit ?? 10) : threads;
+    if (args.json !== false) {
+      ui.plain(JSON.stringify({ ok: true, threads: outputThreads }, null, 2));
+      return;
+    }
+    for (const thread of outputThreads) {
       ui.plain(formatBotThread(thread));
     }
   }
   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 +15794,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;
@@ -16175,14 +16175,98 @@ function isExternalImageRef(imagePath) {
 }
 function formatBotThread(thread) {
   const unread = thread.unread && thread.unread > 0 ? ` unread=${thread.unread}` : "";
+  const distance = typeof thread.searchDistance === "number" ? ` distance=${thread.searchDistance}` : "";
   const time = thread.lastMessageAt ? ` ${thread.lastMessageAt}` : "";
-  const preview = thread.preview ? ` - ${thread.preview}` : "";
-  return `${thread.name} (${thread.conversationId})${unread}${time}${preview}`;
+  const preview = thread.preview ? ` - ${truncateCliPreview(thread.preview, 120)}` : "";
+  return `${thread.name} (${thread.conversationId})${unread}${distance}${time}${preview}`;
+}
+function rankThreadsByTitleSearch(threads, rawSearch) {
+  const search = normalizeSearchTitle(rawSearch);
+  if (!search) {
+    return threads.map((thread) => ({
+      ...thread,
+      search: rawSearch,
+      searchDistance: 0,
+      searchScore: 1
+    }));
+  }
+  return threads.map((thread) => {
+    const title = normalizeSearchTitle(thread.name);
+    const distance = fuzzyTitleDistance(search, title);
+    const score = 1 - distance / Math.max(search.replace(/\s+/g, "").length, 1);
+    return {
+      ...thread,
+      search: rawSearch,
+      searchDistance: distance,
+      searchScore: Number(Math.max(0, score).toFixed(4))
+    };
+  }).sort((left, right) => {
+    if ((left.searchDistance ?? 0) !== (right.searchDistance ?? 0)) {
+      return (left.searchDistance ?? 0) - (right.searchDistance ?? 0);
+    }
+    if ((left.searchScore ?? 0) !== (right.searchScore ?? 0)) {
+      return (right.searchScore ?? 0) - (left.searchScore ?? 0);
+    }
+    return compareNullableIsoDesc(left.lastMessageAt, right.lastMessageAt);
+  });
+}
+function fuzzyTitleDistance(search, title) {
+  if (!search) return 0;
+  if (!title) return search.length;
+  if (title.includes(search)) return 0;
+  const compactSearch = search.replace(/\s+/g, "");
+  const compactTitle = title.replace(/\s+/g, "");
+  const candidates = /* @__PURE__ */ new Set([title, compactTitle]);
+  for (const token of title.split(/\s+/)) {
+    if (token) candidates.add(token);
+  }
+  if (compactSearch && compactTitle.length >= compactSearch.length) {
+    for (let index = 0; index <= compactTitle.length - compactSearch.length; index += 1) {
+      candidates.add(compactTitle.slice(index, index + compactSearch.length));
+    }
+  }
+  let best = Number.POSITIVE_INFINITY;
+  for (const candidate of candidates) {
+    best = Math.min(best, damerauLevenshteinDistance(compactSearch || search, candidate));
+  }
+  return Number.isFinite(best) ? best : search.length;
+}
+function normalizeSearchTitle(value) {
+  return value.toLowerCase().normalize("NFKC").replace(/[\p{P}\p{S}]+/gu, " ").replace(/\s+/g, " ").trim();
+}
+function damerauLevenshteinDistance(left, right) {
+  const matrix = Array.from({ length: left.length + 1 }, () => Array(right.length + 1).fill(0));
+  for (let row = 0; row <= left.length; row += 1) matrix[row][0] = row;
+  for (let column = 0; column <= right.length; column += 1) matrix[0][column] = column;
+  for (let row = 1; row <= left.length; row += 1) {
+    for (let column = 1; column <= right.length; column += 1) {
+      const cost = left[row - 1] === right[column - 1] ? 0 : 1;
+      matrix[row][column] = Math.min(
+        matrix[row - 1][column] + 1,
+        matrix[row][column - 1] + 1,
+        matrix[row - 1][column - 1] + cost
+      );
+      if (row > 1 && column > 1 && left[row - 1] === right[column - 2] && left[row - 2] === right[column - 1]) {
+        matrix[row][column] = Math.min(matrix[row][column], matrix[row - 2][column - 2] + 1);
+      }
+    }
+  }
+  return matrix[left.length][right.length];
+}
+function compareNullableIsoDesc(left, right) {
+  const leftTime = left ? Date.parse(left) : 0;
+  const rightTime = right ? Date.parse(right) : 0;
+  return rightTime - leftTime;
 }
 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;
@@ -25674,13 +25758,10 @@ function parseIm1Args(tokens) {
   const rest = [...tokens];
   const action = rest.shift();
   if (!action) {
-    throw new Error("Usage: im1 collect sync (--source <cc|yelling> | --endpoint <url>) | im1 reply --thread <name> --text <text> (--source <cc|yelling> | --endpoint <url>)");
-  }
-  if (action === "collect") {
-    return parseIm1CollectArgs(rest);
+    throw new Error("Usage: im1 health | im1 threads [--q <keyword>] [--search <title>] | im1 messages --thread <name|conversation-id> | im1 reply --thread <name|conversation-id> --text <text>");
   }
   if (action === "health") {
-    return { type: "collect" /* Collect */, action: "health" };
+    return parseIm1HealthArgs(rest);
   }
   if (action === "threads") {
     return parseIm1ThreadsArgs(rest);
@@ -25693,47 +25774,60 @@ 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 search;
   let limit;
-  let source = "cc";
+  let json = true;
   while (rest.length > 0) {
     const token = rest.shift();
     switch (token) {
-      case "--source": {
-        const value = requireValue11(rest, token);
-        if (value !== "cc") throw new Error(`Unsupported im1 threads source: ${value}`);
-        source = value;
-        break;
-      }
       case "--q":
       case "--query":
         query = requireValue11(rest, token);
         break;
+      case "--search":
+        search = requireValue11(rest, token);
+        break;
       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", query, search, 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) {
-      case "--source": {
-        const value = requireValue11(rest, token);
-        if (value !== "cc") throw new Error(`Unsupported im1 messages source: ${value}`);
-        source = value;
-        break;
-      }
       case "--thread":
       case "--channel":
         thread = requireValue11(rest, token);
@@ -25741,6 +25835,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,33 +25848,10 @@ 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 };
-}
-function parseIm1CollectArgs(tokens) {
-  const rest = [...tokens];
-  const action = rest.shift();
-  if (action !== "sync") {
-    throw new Error(
-      "Usage: im1 collect sync [--thread <name|conversation-id>] (--source <cc|yelling> | --endpoint <url>)"
-    );
-  }
-  const target = parseTargetOptions(rest);
-  if (!target.source && !target.endpoint) {
-    throw new Error(
-      "Usage: im1 collect sync [--thread <name|conversation-id>] (--source <cc|yelling> | --endpoint <url>)"
-    );
-  }
-  return {
-    type: "collect" /* Collect */,
-    action: "sync",
-    source: target.source,
-    endpoint: target.endpoint,
-    thread: target.thread
-  };
+  return { type: "collect" /* Collect */, action: "messages", thread, limit, json };
 }
 function parseIm1ReplyArgs(tokens) {
   const rest = [...tokens];
-  const targetTokens = [];
   let thread;
   let text;
   let dryRun = false;
@@ -25791,61 +25868,21 @@ function parseIm1ReplyArgs(tokens) {
       case "--dry-run":
         dryRun = true;
         break;
-      case "--source":
-      case "--endpoint":
-        targetTokens.push(token, requireValue11(rest, token));
-        break;
       default:
         throw new Error(`Unknown im1 reply option: ${token}`);
     }
   }
   if (!thread || !text) {
-    throw new Error("Usage: im1 reply --thread <name> --text <text> (--source <cc|yelling> | --endpoint <url>)");
-  }
-  const target = parseTargetOptions(targetTokens);
-  if (!target.source && !target.endpoint) {
-    throw new Error("Usage: im1 reply --thread <name> --text <text> (--source <cc|yelling> | --endpoint <url>)");
+    throw new Error("Usage: im1 reply --thread <name|conversation-id> --text <text>");
   }
   return {
     type: "collect" /* Collect */,
     action: "reply",
-    source: target.source,
-    endpoint: target.endpoint,
     thread,
     text,
     dryRun
   };
 }
-function parseTargetOptions(tokens) {
-  const rest = [...tokens];
-  const options = {};
-  while (rest.length > 0) {
-    const token = rest.shift();
-    switch (token) {
-      case "--source": {
-        const value = requireValue11(rest, token);
-        if (value !== "cc" && value !== "yelling") {
-          throw new Error(`Unsupported im1 source: ${value}`);
-        }
-        options.source = value;
-        break;
-      }
-      case "--endpoint":
-        options.endpoint = requireValue11(rest, token);
-        break;
-      case "--thread":
-      case "--channel":
-        options.thread = requireValue11(rest, token);
-        break;
-      default:
-        throw new Error(`Unknown im1 option: ${token}`);
-    }
-  }
-  if (options.source && options.endpoint) {
-    throw new Error("Use either --source or --endpoint, not both.");
-  }
-  return options;
-}
 function requireValue11(tokens, optionName) {
   const value = tokens.shift();
   if (!value || value.startsWith("--")) {
@@ -26081,11 +26118,10 @@ 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("                  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.gray("                  health [--json]")}`,
+  `  ${import_chalk4.default.gray("                  threads [--q <keyword>] [--search <title>] [--limit <n>] [--json|--text]")}`,
+  `  ${import_chalk4.default.gray("                  messages --thread <name|conversation-id> [--limit <n>] [--json|--text]")}`,
+  `  ${import_chalk4.default.gray("                  reply --thread <name|conversation-id> --text <text> [--dryrun]")}`,
   `  ${import_chalk4.default.cyan("collect")}          Legacy alias for CC/yelling collection`,
   `  ${import_chalk4.default.gray("                  sync [--thread <name|conversation-id>] (--source <cc|yelling> | --endpoint <url>)")}`,
   `  ${import_chalk4.default.cyan("chat-room")}        Run social chat regression commands with PMate bot key JSON`,

package/package.json

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