imsg-mcp 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and follows [Semantic Versioning](https://semver.org/).
 
+# [1.6.0](https://github.com/george43g/imsg-mcp/compare/v1.5.0...v1.6.0) (2026-07-19)
+
+
+### Bug Fixes
+
+* **cli:** friendlier windowDays + humans usage; add `resolve` console verb ([4a5f389](https://github.com/george43g/imsg-mcp/commit/4a5f3892d6ca9d0683c49c44b9052190552bc7f9))
+* **db:** detect unsent messages via content-absence, not the lying date columns ([8a2c5e2](https://github.com/george43g/imsg-mcp/commit/8a2c5e2544f5393f7380a1fb4126e782e81e111c))
+* **tui:** filter-commit (Enter) loads the matched thread, not just the cursor ([3666d4a](https://github.com/george43g/imsg-mcp/commit/3666d4a1a6febbdae935fb1406fcf4a39cd9f1ab))
+
+
+### Features
+
+* **mcp:** resolve_conversation — free-form name → ranked threads in one call ([68485ab](https://github.com/george43g/imsg-mcp/commit/68485ab470b7b7a555719769169107d17c94a1cd))
+
+# [1.5.0](https://github.com/george43g/imsg-mcp/compare/v1.4.0...v1.5.0) (2026-07-19)
+
+
+### Bug Fixes
+
+* **analytics:** bound getMessagesInWindow so opening a pane can't OOM-kill ([708ba7a](https://github.com/george43g/imsg-mcp/commit/708ba7ab223d8c8a6f2d37b51979490630b5f24a))
+* **analytics:** make the relationship leaderboard actually rank ([60159ee](https://github.com/george43g/imsg-mcp/commit/60159ee52776077b8ee5ef6019ec464b3e92c87d))
+* **humans:** getChatStats double-counted messages shared across legs ([e1a17cb](https://github.com/george43g/imsg-mcp/commit/e1a17cbe3a2570249122a4c7a86c69dbabf82ec8))
+* **media:** correct yap/hear transcriber invocations ([f272e15](https://github.com/george43g/imsg-mcp/commit/f272e15aa34d2fc9db5ecbf344025d6aeb3a57a1))
+* **snippets:** unsent last message no longer leaks "DWm" into the preview ([185d073](https://github.com/george43g/imsg-mcp/commit/185d0738d43a5386682e5dc0fbc25e706c1edcea))
+* **test:** make CLI e2e cold-safe (no dependency on a warm slugs.db) ([a00b1a8](https://github.com/george43g/imsg-mcp/commit/a00b1a86f854e7ba8e96ddc9230460f8bab929d7))
+* **tui:** compose-new modal no longer quits the TUI on a "q" recipient ([78589b1](https://github.com/george43g/imsg-mcp/commit/78589b10184ccedc31796a8e840b91245f1a8149))
+* **tui:** stop the near-top loader re-firing when it can't page back further ([1639698](https://github.com/george43g/imsg-mcp/commit/1639698b88e19aa090a64f396810fc400e21542d))
+
+
+### Features
+
+* **analytics:** expose all 7 analytics via CLI + console with json/yaml ([ac619e9](https://github.com/george43g/imsg-mcp/commit/ac619e904ef7b1aaea6becaa00b896f932d737fc))
+
 # [1.4.0](https://github.com/george43g/imsg-mcp/compare/v1.3.2...v1.4.0) (2026-07-13)
 
 

package/README.md

@@ -58,6 +58,14 @@ imsg export weekend-crew~imsg~d4e5 \
   --output ~/weekend-crew.md
 ```
 
+Relationship analytics from the CLI (all 7 types; add `--json` / `--yaml` to script them):
+
+```bash
+imsg analytics relationship_leaderboard      # top relationships by volume × reciprocity × recency
+imsg analytics daily_heatmap                 # ASCII 7×24 activity grid
+imsg analytics messaging_streaks --json      # machine-readable for pipelines
+```
+
 Full walkthrough with screenshots: [**docs/WORKFLOWS.md**](docs/WORKFLOWS.md).
 
 ---
@@ -65,7 +73,7 @@ Full walkthrough with screenshots: [**docs/WORKFLOWS.md**](docs/WORKFLOWS.md).
 ## MCP tools
 
 <details>
-<summary><b>16 tools shipped (click to expand)</b></summary>
+<summary><b>17 tools shipped (click to expand)</b></summary>
 
 | Tool | Purpose |
 |------|---------|
@@ -82,12 +90,13 @@ Full walkthrough with screenshots: [**docs/WORKFLOWS.md**](docs/WORKFLOWS.md).
 | `chat_analytics` | Pre-aggregated stats (heatmaps, leaderboards, etc). |
 | `list_contacts` / `search_contacts` | Browse/search contacts (name, phone, email). |
 | `get_contact` | One contact with all handles **+ the thread slug per handle**. |
+| `resolve_conversation` | Free-form name/phrase → ranked threads (contacts + thread names + message content) in one call. |
 | `resolve_handle` | Phone/email → contact name. |
 | `init_human` | Scaffold a [humans/v1 relationship file](skills/humans/SKILL.md) for a contact or your top N relationships. |
 
 </details>
 
-Contacts are also on the CLI: `imsg contacts search <query>`, `imsg contacts show <handle-or-id>` (handles → thread slugs), `imsg contacts resolve <handle>`, `imsg contacts list`.
+Contacts are also on the CLI: `imsg contacts search <query>`, `imsg contacts show <handle-or-id>` (handles → thread slugs), `imsg contacts resolve <handle>`, `imsg contacts list`. Turn a name into a thread in one shot with `imsg resolve "selena"` (add `--json`/`--yaml` to script it).
 
 Full reference (CLI subcommands + MCP tools + every flag): [**docs/TOOLS.md**](docs/TOOLS.md).
 

package/dist/cli.js

@@ -3,10 +3,10 @@ import { existsSync, realpathSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
-import { c as checkLocalAccess, f as formatAccessReport, t as installShutdownHandlers, u as registerCleanup, G as looksLikeThreadSlug } from "./shutdown-CqGQKFmr.js";
+import { c as checkLocalAccess, f as formatAccessReport, I as IMPLEMENTED_TYPES, J as ANALYTIC_INFO, v as installShutdownHandlers, w as registerCleanup, K as looksLikeThreadSlug } from "./shutdown-Vh0gjb6m.js";
+import { A as APP_VERSION, t as toYaml } from "./meta-CkA7wU7_.js";
 import { spawn } from "node:child_process";
 import { join, dirname } from "node:path";
-import { A as APP_VERSION } from "./meta-CGz9n7A2.js";
 function distRoot() {
   return dirname(fileURLToPath(import.meta.url));
 }
@@ -149,12 +149,30 @@ async function withClient(run) {
     client.close();
   }
 }
-async function printToolResult(client, name, args, timeoutMs) {
+async function printToolResult(client, name, args, timeoutMs, format) {
   const result = await client.callTool(name, args, timeoutMs);
   const text = result.content?.[0]?.text ?? JSON.stringify(result, null, 2);
   if (result.isError) throw new Error(text);
+  if (format === "json" || format === "yaml") {
+    const payload = result.structuredContent ?? result;
+    console.log(format === "json" ? JSON.stringify(payload, null, 2) : toYaml(payload));
+    return;
+  }
   console.log(text);
 }
+function pickFormat(opts) {
+  if (opts.json) return "json";
+  if (opts.yaml) return "yaml";
+  return "pretty";
+}
+function parseWindowDays(value, fallback) {
+  if (value === void 0 || value === "") return fallback;
+  const n = Number(value);
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new Error(`windowDays must be a positive number of days, got "${value}".`);
+  }
+  return n;
+}
 function parseConsoleInput(line) {
   const parts = [];
   let current = "";
@@ -212,6 +230,13 @@ async function runConsoleCommand(cmd, args, client) {
         limit: Number(args[1] ?? 20)
       });
       return;
+    case "resolve":
+      if (!args[0]) throw new Error("Usage: resolve <name-or-phrase> [limit]");
+      await printToolResult(client, "resolve_conversation", {
+        query: args[0],
+        limit: Number(args[1] ?? 10)
+      });
+      return;
     case "wait":
       if (!args[0]) throw new Error("Usage: wait <chat> [timeoutSeconds]");
       await printToolResult(
@@ -271,13 +296,32 @@ async function runConsoleCommand(cmd, args, client) {
       } else if (verb === "top") {
         await printToolResult(client, "chat_analytics", {
           type: "relationship_leaderboard",
-          windowDays: Number(args[1] ?? 365)
+          windowDays: parseWindowDays(args[1], 1825)
         });
       } else {
-        throw new Error(`Unknown humans verb: ${verb}. Use init|top.`);
+        const prefix = verb && verb !== "help" ? `Unknown humans verb: ${verb}.
+` : "";
+        throw new Error(
+          `${prefix}Usage:
+  humans init <contact|slug>
+  humans init top [n]
+  humans top [days]`
+        );
       }
       return;
     }
+    case "analytics":
+    case "stats": {
+      const type = args[0];
+      if (!type || !IMPLEMENTED_TYPES.includes(type)) {
+        throw new Error(`Usage: analytics <${IMPLEMENTED_TYPES.join("|")}> [windowDays]`);
+      }
+      const fmtArg = args[args.length - 1];
+      const format = fmtArg === "json" ? "json" : fmtArg === "yaml" ? "yaml" : "pretty";
+      const windowDays = args[1] && /^\d+$/.test(args[1]) ? Number(args[1]) : ANALYTIC_INFO[type].defaultWindowDays;
+      await printToolResult(client, "chat_analytics", { type, windowDays }, void 0, format);
+      return;
+    }
     case "logs":
       await printToolResult(client, "get_logs", args[0] ? { tail: Number(args[0]) } : {});
       return;
@@ -322,10 +366,13 @@ Available commands:
   messages [chat] [n]  Show recent messages
   unread [n]           Show unread messages
   search <query> [n]   Search messages
+  resolve <name> [n]   Resolve a name/phrase to ranked conversations
   wait <chat> [secs]   Wait for a reply (default 60s)
   send <target> <msg>  Send a message
   contacts [verb]      Contacts: list [n] [offset] | search <q> [n] | resolve <handle> | show <handle-or-id>
   humans <verb>        Relationship files: init <contact|slug> | init top [n] | top [days]
+  analytics <type> [days] [json|yaml]
+                       Analytics: ${IMPLEMENTED_TYPES.join(" | ")}
   logs [tail]          Show server debug logs
   last-error           Show last send failure
   tools                List available MCP tools
@@ -342,22 +389,42 @@ async function runInteractiveConsole() {
   console.log(CONSOLE_HELP);
   console.log("");
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = () => rl.question(color.cyan("imsg> "), async (line) => {
-    const trimmed = line.trim();
-    if (!trimmed) {
-      prompt();
-      return;
-    }
-    const { cmd, args } = parseConsoleInput(trimmed);
-    try {
-      await runConsoleCommand(cmd, args, client);
-    } catch (error) {
-      log(error instanceof Error ? error.message : String(error), "err");
+  const queue = [];
+  let processing = false;
+  let closed = false;
+  const finish = () => {
+    client.close();
+    process.exit(0);
+  };
+  const drain = async () => {
+    if (processing) return;
+    processing = true;
+    while (queue.length > 0) {
+      const line = queue.shift();
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      const { cmd, args } = parseConsoleInput(trimmed);
+      try {
+        await runConsoleCommand(cmd, args, client);
+      } catch (error) {
+        log(error instanceof Error ? error.message : String(error), "err");
+      }
+      console.log("");
     }
-    console.log("");
-    prompt();
+    processing = false;
+    if (closed) finish();
+    else rl.prompt();
+  };
+  rl.setPrompt(color.cyan("imsg> "));
+  rl.prompt();
+  rl.on("line", (line) => {
+    queue.push(line);
+    void drain();
+  });
+  rl.on("close", () => {
+    closed = true;
+    if (!processing && queue.length === 0) finish();
   });
-  prompt();
   installShutdownHandlers();
   registerCleanup(() => client.close());
 }
@@ -379,8 +446,8 @@ async function runExportCommand(target, opts) {
   const { existsSync: existsSync2, mkdirSync, copyFileSync, statSync } = await import("node:fs");
   const { homedir } = await import("node:os");
   const { dirname: dirname2, join: join2, isAbsolute, resolve } = await import("node:path");
-  const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-CqGQKFmr.js").then((n) => n.X);
-  const { IMessageDB } = await import("./imessage-db-C8WKHFQA.js").then((n) => n.i);
+  const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-Vh0gjb6m.js").then((n) => n.$);
+  const { IMessageDB } = await import("./imessage-db-Dg_EPYPC.js").then((n) => n.i);
   const { streamExport } = await import("./exportStream-BCoZYUUZ.js");
   const { parseUserDate } = await import("./dateParse-DJXMfq3a.js");
   const format = normalizeFormat(opts.format ?? "md");
@@ -514,6 +581,17 @@ program.command("unread").description("Show unread messages across all conversat
 program.command("search").description("Search messages by text content").argument("<query>", "Search query").argument("[limit]", "Number of results", "20").action(async (query, limit) => {
   await withClient((c) => printToolResult(c, "search_messages", { query, limit: Number(limit) }));
 });
+program.command("resolve").description("Resolve a free-form name/phrase to ranked conversations (contacts + threads)").argument("<query>", 'Name or phrase, e.g. "Selena"').argument("[limit]", "Max ranked matches", "10").option("--json", "Output structured JSON").option("--yaml", "Output structured YAML").action(async (query, limit, opts) => {
+  await withClient(
+    (c) => printToolResult(
+      c,
+      "resolve_conversation",
+      { query, limit: Number(limit) },
+      void 0,
+      pickFormat(opts)
+    )
+  );
+});
 program.command("wait").description("Wait for a reply in a conversation").argument("<chat>", "Phone number, email, or thread slug").argument("[timeout]", "Timeout in seconds", "60").action(async (chat, timeout) => {
   await withClient(
     (c) => printToolResult(
@@ -567,14 +645,32 @@ humansCommand.command("init").description(
   const args = opts.top ? { top: Number(opts.top) } : contact?.includes("~") ? { threadSlug: contact } : { contact };
   await withClient((c) => printToolResult(c, "init_human", args));
 });
-humansCommand.command("top").description("Show the relationship leaderboard (volume × reciprocity × recency, last year)").argument("[windowDays]", "Days of history to rank", "365").action(async (windowDays) => {
+humansCommand.command("top").description("Show the relationship leaderboard (volume × reciprocity × recency, last 5 years)").argument("[windowDays]", "Days of history to rank", "1825").option("--json", "Output structured JSON").option("--yaml", "Output structured YAML").action(async (windowDays, opts) => {
   await withClient(
-    (c) => printToolResult(c, "chat_analytics", {
-      type: "relationship_leaderboard",
-      windowDays: Number(windowDays)
-    })
+    (c) => printToolResult(
+      c,
+      "chat_analytics",
+      { type: "relationship_leaderboard", windowDays: parseWindowDays(windowDays, 1825) },
+      void 0,
+      pickFormat(opts)
+    )
   );
 });
+const analyticsCommand = program.command("analytics").alias("stats").description("Run chat analytics (streaks, response times, heatmap, tapbacks, wrapped, …)");
+for (const type of IMPLEMENTED_TYPES) {
+  const info = ANALYTIC_INFO[type];
+  analyticsCommand.command(type).description(info.description).argument("[windowDays]", "Days of history to analyze", String(info.defaultWindowDays)).option("--json", "Output structured JSON").option("--yaml", "Output structured YAML").action(async (windowDays, opts) => {
+    await withClient(
+      (c) => printToolResult(
+        c,
+        "chat_analytics",
+        { type, windowDays: parseWindowDays(windowDays, info.defaultWindowDays) },
+        void 0,
+        pickFormat(opts)
+      )
+    );
+  });
+}
 program.command("logs").description("Show server debug logs").argument("[tail]", "Show only last N lines").action(async (tail) => {
   await withClient((c) => printToolResult(c, "get_logs", tail ? { tail: Number(tail) } : {}));
 });
@@ -599,7 +695,7 @@ program.command("tui").description("Launch the read-only terminal UI").option("-
 });
 program.command("export <target>").description("Export a conversation to a file (md/csv/json/ndjson)").option("-f, --format <fmt>", "Output format: md (default), csv, json, ndjson", "md").option("--since <date>", "Earliest date (ISO or relative, e.g. '3 months ago')").option("--until <date>", "Latest date (ISO or relative)").option("-o, --output <path>", "Output path (default: ~/imsg-export-<target>-<YYYY-MM-DD>.<ext>)").option("--include-attachments", "Copy attachments next to the export").option("--attachments-dir <path>", "Where to copy attachments (default: <output>.attachments/)").option("--page-size <n>", "Messages per DB page (100-5000)", "1000").action(runExportCommand);
 program.command("setup").description("Autodetect DB paths and emit an MCP host config snippet").option("-w, --write <host>", 'Write into a host config: "claude" or "cursor"').option("-r, --runtime <runtime>", 'Runtime command: "npx" (default), "bunx", or "global"').option("--print-only", "Just print the snippet (default behaviour)").action(async (opts) => {
-  const { probeMachine, buildMcpSnippet, writeHostConfig } = await import("./setup-BDnz3OuH.js");
+  const { probeMachine, buildMcpSnippet, writeHostConfig } = await import("./setup-CysR5gId.js");
   const report = probeMachine();
   if (!report.imsgDb.readable) {
     log(`✗ Messages DB is not readable: ${report.imsgDb.path}`, "err");
@@ -690,6 +786,9 @@ if (invokedAsScript) {
   });
 }
 export {
+  parseConsoleInput,
+  parseWindowDays,
+  runConsoleCommand,
   runExportCommand
 };
 //# sourceMappingURL=cli.js.map