@wirecat/cli-core 0.532.0 → 0.534.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ shape of this file.
 
 ## Unreleased
 
+## 0.534.0 — 01.11.2026
+
+### Added
+
+- **`parseMail` also returns `messageId`, `references`, `replyTo` and `date`**, and takes a third argument, the most
+  attachments to keep (`MAX_ATTACHMENTS`, 50, by default), so a command that lists one message's files can ask for all
+  of them.
+
+## 0.533.0 — 01.11.2026
+
+### Added
+
+- **A `search all` meeting transcript hit names its cue and its speaker**: `cue_ref`
+  (`meeting:<account>/<meeting>/<transcript>/<cue>`) and `sender_name` (marked untrusted). `meetings passage <cue_ref>
+  --before-n 3 --after-n 3` opens the lines around it; `ref` stays the meeting. Chat and summary hits are unchanged.
+  `SearchHit` from the meetings store carries the same cue as `ref` and `speakerName`; `MeetingSearchItem` carries
+  `cueRef` and `speakerName`.
+
+### Fixed
+
+- **A `serve` unit or launchd agent survives an upgrade with pnpm.** `server install` wrote the script's resolved
+  path, a versioned folder in pnpm's global store that the next upgrade removes, so the unit could not start until it
+  was installed again. It now writes the path the shim gave, a link pnpm points at the new version.
+
 ## 0.532.0 — 01.11.2026
 
 ### Added

package/dist/background/system.js

@@ -1,6 +1,6 @@
 import { execFile, spawn } from "node:child_process";
-import { closeSync, mkdirSync, openSync, realpathSync } from "node:fs";
-import { dirname } from "node:path";
+import { closeSync, mkdirSync, openSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
 import { CliError } from "@wirecat/cli-base";
 export const runProgram = (argv, env) => new Promise((resolve, reject) => {
@@ -14,7 +14,9 @@ export const runProgram = (argv, env) => new Promise((resolve, reject) => {
     });
 });
 export const thisMachine = () => {
-    const entry = [process.execPath, realpathSync(process.argv[1] ?? "")];
+    // The path as the package manager's shim gave it, not resolved: pnpm's global link keeps its name across upgrades
+    // while the folder it points at is versioned and removed by the next upgrade, which would leave the unit dead.
+    const entry = [process.execPath, resolve(process.argv[1] ?? "")];
     return {
         platform: process.platform,
         run: runProgram,

package/dist/cli/messenger/search-answers.js

@@ -275,7 +275,7 @@ const ALL_HIT_UNTRUSTED = {
     document: DOCUMENT_HIT_UNTRUSTED,
     note: undefined,
     event: ["title", "excerpt"],
-    meeting: ["title", "excerpt"],
+    meeting: ["title", "excerpt", "sender_name"],
 };
 export const allHitItem = (item) => item.kind === "meeting"
     ? {
@@ -289,6 +289,7 @@ export const allHitItem = (item) => item.kind === "meeting"
         offset_ms: item.startMs,
         scope: item.scope,
         id: String(item.id),
+        ...(item.cueRef === undefined ? {} : { cue_ref: item.cueRef, sender_name: item.speakerName ?? null }),
         untrusted: ALL_HIT_UNTRUSTED.meeting,
     }
     : defined({

package/dist/entities/hit.d.ts

@@ -22,6 +22,8 @@ export declare const hit: v.StrictObjectSchema<{
     readonly offset_ms: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
     /** A meeting passage's place: its transcript, chat or summary. */
     readonly scope: v.OptionalSchema<v.PicklistSchema<["transcript", "chat", "summary"], undefined>, undefined>;
+    /** A meeting transcript hit's cue, which `meetings passage` opens with the lines around it. */
+    readonly cue_ref: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
     /** A meeting passage's stored line, so two passages of one meeting stay apart; `search meetings` gives the same. */
     readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
     /** A message's files; absent when it has none. */

package/dist/entities/hit.js

@@ -24,6 +24,8 @@ export const hit = v.strictObject({
     offset_ms: v.optional(v.nullable(count)),
     /** A meeting passage's place: its transcript, chat or summary. */
     scope: v.optional(v.picklist(["transcript", "chat", "summary"])),
+    /** A meeting transcript hit's cue, which `meetings passage` opens with the lines around it. */
+    cue_ref: v.optional(reference),
     /** A meeting passage's stored line, so two passages of one meeting stay apart; `search meetings` gives the same. */
     id: v.optional(v.pipe(v.string(), v.minLength(1))),
     /** A message's files; absent when it has none. */

package/dist/entities/index.d.ts

@@ -4567,6 +4567,7 @@ export declare const ENTITIES: {
         readonly found_by: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["title", "words", "meaning"], undefined>, undefined>, undefined>;
         readonly offset_ms: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
         readonly scope: v.OptionalSchema<v.PicklistSchema<["transcript", "chat", "summary"], undefined>, undefined>;
+        readonly cue_ref: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly attachments: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
             readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/mail/index.d.ts

@@ -6,7 +6,7 @@ export { dropMissing, type Gone, tooManyGone } from "./gone.js";
 export { type AuthVerdicts, HEADER_FIELDS, headersOf, type MailHeaders, mailHeadersOf } from "./headers.js";
 export { type MailIdsInput, mailIds } from "./ids.js";
 export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
-export { type Address, htmlToText, looksLikeHtml, MAX_BODY_CHARS, type ParsedMail, parseMail, } from "./parse.js";
+export { type Address, htmlToText, looksLikeHtml, MAX_ATTACHMENTS, MAX_BODY_CHARS, type ParsedMail, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, type PresetName, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, type Probe, type ProbeGroup, probeMail, SUGGEST_RULE } from "./probe.js";
 export { type MailFolderProgress, mailProgress } from "./progress.js";

package/dist/mail/index.js

@@ -6,7 +6,7 @@ export { dropMissing, tooManyGone } from "./gone.js";
 export { HEADER_FIELDS, headersOf, mailHeadersOf } from "./headers.js";
 export { mailIds } from "./ids.js";
 export { decodedLabelName, decodeMailboxName, labelName, systemLabel } from "./labels.js";
-export { htmlToText, looksLikeHtml, MAX_BODY_CHARS, parseMail, } from "./parse.js";
+export { htmlToText, looksLikeHtml, MAX_ATTACHMENTS, MAX_BODY_CHARS, parseMail, } from "./parse.js";
 export { PRESET_NAMES, PRESETS, presetMatches } from "./presets.js";
 export { domainsToAge, groupKey, probeMail, SUGGEST_RULE } from "./probe.js";
 export { mailProgress } from "./progress.js";

package/dist/mail/parse.d.ts

@@ -8,6 +8,12 @@ export interface ParsedMail {
     to: Address[];
     cc: Address[];
     bcc: Address[];
+    replyTo: Address[];
+    date: string | null;
+    /** Message-ID as the first `<id>` the header holds, brackets kept; the header as written when it holds none. */
+    messageId: string | null;
+    /** Every `<id>` of References, in the header's order, brackets kept. */
+    references: string[];
     attachments: {
         id: number;
         name: string;
@@ -17,8 +23,10 @@ export interface ParsedMail {
     text: string;
 }
 export declare const MAX_BODY_CHARS = 1000000;
+/** What sync stores; a command that shows the files of one message passes its own limit. */
+export declare const MAX_ATTACHMENTS = 50;
 export declare const htmlToText: (html: string) => string;
 /** Some senders put their HTML in the text/plain part; its first tag gives it away. */
 export declare const looksLikeHtml: (text: string) => boolean;
 /** A raw RFC 5322 message, as IMAP's `BODY[]` holds it. */
-export declare const parseMail: (raw: Uint8Array, maxBodyChars?: number) => Promise<ParsedMail>;
+export declare const parseMail: (raw: Uint8Array, maxBodyChars?: number, maxAttachments?: number) => Promise<ParsedMail>;

package/dist/mail/parse.js

@@ -2,6 +2,9 @@ import { CliError } from "@wirecat/cli-base";
 import PostalMime, {} from "postal-mime";
 // The store cuts a body into pieces itself; this only guards against a pathological one, like a pasted log.
 export const MAX_BODY_CHARS = 1_000_000;
+/** What sync stores; a command that shows the files of one message passes its own limit. */
+export const MAX_ATTACHMENTS = 50;
+const BRACKETED_ID = /<[^<>\s]+>/g;
 const addresses = (list) => list
     .flatMap((entry) => entry.group ?? [entry])
     .flatMap(({ address, name }) => (address ? [{ email: address.toLowerCase(), name: name || null }] : []));
@@ -52,7 +55,7 @@ const bytesOf = (content) => typeof content === "string"
         ? content
         : new Uint8Array(content);
 /** A raw RFC 5322 message, as IMAP's `BODY[]` holds it. */
-export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS) => {
+export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS, maxAttachments = MAX_ATTACHMENTS) => {
     let email;
     try {
         email = await PostalMime.parse(raw);
@@ -68,7 +71,11 @@ export const parseMail = async (raw, maxBodyChars = MAX_BODY_CHARS) => {
         to: addresses(email.to ?? []),
         cc: addresses(email.cc ?? []),
         bcc: addresses(email.bcc ?? []),
-        attachments: email.attachments.slice(0, 50).map((part, id) => ({
+        replyTo: addresses(email.replyTo ?? []),
+        date: email.date ?? null,
+        messageId: email.messageId?.match(BRACKETED_ID)?.[0] ?? email.messageId ?? null,
+        references: email.references?.match(BRACKETED_ID) ?? [],
+        attachments: email.attachments.slice(0, maxAttachments).map((part, id) => ({
             id,
             name: (part.filename ?? `attachment-${id}`).slice(0, 200),
             mime: part.mimeType || null,

package/dist/meetings/store.d.ts

@@ -88,6 +88,8 @@ export interface SearchHit {
     id: number;
     text: string;
     startMs: number | null;
+    /** Who spoke a transcript hit's cue, as the transcript names them; absent for chat and summary hits. */
+    speakerName?: string | null;
     /** `corrected` when a query word matched only as a stored word recognition may have garbled. */
     match?: "words" | "corrected";
     /** For a `corrected` hit, the stored words each such query word matched in this passage. */

package/dist/meetings/testing/contract.js

@@ -62,7 +62,12 @@ export const meetingStoreContract = (make) => {
             assert.equal((await s.participants("example.com", 1)).length, 1);
             assert.equal((await s.participants("alice", 2)).length, 0);
             assert.deepEqual((await s.search("EXAMPLE")).map((h) => h.scope).sort(), ["chat", "summary", "transcript"]);
-            assert.equal((await s.search("Ship"))[0]?.startMs, 0);
+            const [ship] = await s.search("Ship");
+            assert.equal(ship?.startMs, 0);
+            const cue = t.rows.find((row) => row.id === ship?.id);
+            assert.ok(cue);
+            assert.equal(ship?.ref, `meeting:${d.meeting.accountId}/${d.meeting.id}/${t.transcript.id}/${cue.position}`, "a transcript hit names its cue");
+            assert.equal(ship?.speakerName, cue.speakerName);
         }),
         test("idempotence, updates and omitted parts retain history", async (s) => {
             const input = sampleMeeting();

package/dist/meetings/testing/memory.js

@@ -3,6 +3,7 @@ import { EVENT_QUERY } from "../event-query.js";
 import { MEETING_QUERY, meetingItem } from "../item.js";
 import { eventItem } from "../read-answers.js";
 import { MeetingError, positiveInteger } from "../reads.js";
+import { formatMeetingReference } from "../reference.js";
 const overlap = (start, end, from, to) => start !== null && start <= to && (end ?? start) >= from;
 /** A test store keeps no accounts: every id is an account of the `memory` provider. */
 const MEMORY_OWNER = (id) => ({ provider: "memory", account: String(id) });
@@ -107,11 +108,19 @@ export const memoryMeetingStore = () => {
                 const rows = d.transcripts
                     .filter((t) => t.transcript.supersededAt === null && t.transcript.deletedAt === null)
                     .flatMap((t) => t.rows.map((r) => ({
+                    ref: formatMeetingReference({
+                        type: "meeting",
+                        accountId: d.meeting.accountId,
+                        meetingId: d.meeting.id,
+                        transcriptId: t.transcript.id,
+                        cuePosition: r.position,
+                    }),
                     meetingId: d.meeting.id,
                     scope: "transcript",
                     id: r.id,
                     text: r.text,
                     startMs: r.startMs,
+                    speakerName: r.speakerName,
                 })));
                 rows.push(...d.chat.map((r) => ({
                     meetingId: d.meeting.id,

package/dist/services/search-all-meetings.d.ts

@@ -19,6 +19,9 @@ export interface MeetingSearchItem {
     scope: SearchHit["scope"];
     id: number;
     startMs: number | null;
+    /** A transcript hit's cue, `meeting:<account>/<meeting>/<transcript>/<cue>`, which `meetings passage` opens. */
+    cueRef?: string;
+    speakerName?: string | null;
 }
 export interface MeetingSearchCursor {
     accountId: number;

package/dist/services/search-all-meetings.js

@@ -104,6 +104,9 @@ const collectMeetings = async (store, account, request, query) => {
                     scope: hit.scope,
                     id: hit.id,
                     startMs: hit.startMs,
+                    ...(hit.scope === "transcript" && hit.ref !== undefined
+                        ? { cueRef: hit.ref, speakerName: hit.speakerName ?? null }
+                        : {}),
                 },
             });
             if (collected.items.length > request.limit) {

package/dist/store/sqlite/meetings.js

@@ -1,5 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
-import { joinKeyOf, MeetingError } from "../../meetings/index.js";
+import { formatMeetingReference, joinKeyOf, MeetingError } from "../../meetings/index.js";
 import { normalize } from "../normalize.js";
 import * as eventQueries from "./events.js";
 import { fromJson, int, page, str, toJson } from "./events.js";
@@ -515,17 +515,18 @@ const search = (database, query, filter) => {
         const rows = database
             .prepare(`WITH hit AS (SELECT rowid AS r FROM meeting_words WHERE meeting_words MATCH ?),
        picked AS (SELECT id, row_number() OVER (ORDER BY coalesce(started_at, 0) DESC, id) AS n FROM (${picked.sql}))
-       SELECT p.n, 0 AS kind, t.id AS a, r.position AS b, r.id, t.meeting_id, r.start_ms, coalesce(length(CAST(r.text AS BLOB)),0) AS bytes
+       SELECT p.n, 0 AS kind, t.id AS a, r.position AS b, r.id, t.meeting_id, r.start_ms, coalesce(length(CAST(r.text AS BLOB)),0) AS bytes,
+              r.speaker_name AS speaker, m.account_id
          FROM hit h JOIN meeting_transcript_rows r ON h.r % 4 = 1 AND r.id = h.r / 4
          JOIN meeting_transcripts t ON t.id = r.meeting_transcript_id
            AND t.superseded_at IS NULL AND t.deleted_at IS NULL
-         JOIN picked p ON p.id = t.meeting_id
+         JOIN picked p ON p.id = t.meeting_id JOIN meetings m ON m.id = t.meeting_id
        UNION ALL
-       SELECT p.n, 1, c.id, 0, c.id, c.meeting_id, NULL, coalesce(length(CAST(c.text AS BLOB)),0)
+       SELECT p.n, 1, c.id, 0, c.id, c.meeting_id, NULL, coalesce(length(CAST(c.text AS BLOB)),0), NULL, NULL
          FROM hit h JOIN meeting_chat_messages c ON h.r % 4 = 2 AND c.id = h.r / 4
          JOIN picked p ON p.id = c.meeting_id
        UNION ALL
-       SELECT p.n, 2, s.id, 0, s.id, s.meeting_id, NULL, coalesce(length(CAST(s.title AS BLOB)),0)+coalesce(length(CAST(s.overview AS BLOB)),0)+coalesce(length(CAST(s.sections AS BLOB)),0)+coalesce(length(CAST(s.next_steps AS BLOB)),0)+coalesce(length(CAST(s.content AS BLOB)),0)
+       SELECT p.n, 2, s.id, 0, s.id, s.meeting_id, NULL, coalesce(length(CAST(s.title AS BLOB)),0)+coalesce(length(CAST(s.overview AS BLOB)),0)+coalesce(length(CAST(s.sections AS BLOB)),0)+coalesce(length(CAST(s.next_steps AS BLOB)),0)+coalesce(length(CAST(s.content AS BLOB)),0), NULL, NULL
          FROM hit h JOIN meeting_summaries s ON h.r % 4 = 3 AND s.id = h.r / 4
          JOIN picked p ON p.id = s.meeting_id
        ORDER BY 1, 2, 3, 4 LIMIT 10001`)
@@ -540,7 +541,20 @@ const search = (database, query, filter) => {
         const scopes = ["transcript", "chat", "summary"];
         return rows.map((row) => {
             const scope = scopes[Number(row.kind)];
+            const cue = scope === "transcript"
+                ? {
+                    ref: formatMeetingReference({
+                        type: "meeting",
+                        accountId: Number(row.account_id),
+                        meetingId: Number(row.meeting_id),
+                        transcriptId: Number(row.a),
+                        cuePosition: Number(row.b),
+                    }),
+                    speakerName: row.speaker === null ? null : String(row.speaker),
+                }
+                : {};
             return {
+                ...cue,
                 meetingId: Number(row.meeting_id),
                 scope,
                 id: Number(row.id),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.532.0",
+  "version": "0.534.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",