@testchimp/cli 0.1.81 → 0.1.83

package/README.md

@@ -48,11 +48,15 @@ testchimp promote-perf-baseline --run-id 01ABC --env-class CI
 testchimp compare-perf-to-baseline --run-id 01ABC --max-p95-regression-percent 10
 testchimp list-related-perf-tests --scenario-titles "Checkout,Refund"
 testchimp list-api-operation-interactions --operation-id 01XYZ --interaction-type REAL --limit 100
+testchimp list-meeting-filter-options
+testchimp list-meetings --from 2026-09-01 --to 2026-09-30 --domain customer.com --label Sales --search "pricing"
+testchimp get-meeting-transcript --meeting-id <meeting-id> --summary-only
 ```
 
 - **stdout:** API response JSON.
 - **stderr:** progress for `provision-ephemeral-environment-and-wait` (“still waiting…” polls).
 - **performance gate:** `compare-perf-to-baseline` still prints its JSON response but exits nonzero when `regressed` is `true` (top-level or under `comparison`).
+- **Meetings:** `list-meetings` / `list-meeting-filter-options` cover team-wide Meeting Bots meetings only (same filters as the Meetings page). `--from` / `--to` take `YYYY-MM-DD` (inclusive local days), ISO datetimes, or epoch millis; `--label`, `--participant`, `--domain` are repeatable or comma-separated.
 - **Flags:** default for each subcommand; **`--json-input '<json>'`** or **`--json-input @file.json`** merges over flags (JSON wins on conflicts). Use JSON for nested bodies (e.g. TrueCoverage scopes).
 
 ## Migration from `testchimp-mcp-client`

package/dist/cli/program.js

@@ -485,16 +485,89 @@ export function buildCliProgram() {
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-meeting-transcript").description)
         .addOption(jsonInputOption())
         .option("--meeting-id <id>", "meeting id (calendar event id, or URL hash for ad-hoc; same as Studio folder under ~/.testchimp/data/meetings/)")
+        .option("--summary-only", "return only the post-meeting summary (omit the transcript body)")
         .action(async (opts) => {
         const body = {};
         if (opts.meetingId) {
             body.meetingId = String(opts.meetingId).trim();
         }
+        if (opts.summaryOnly) {
+            body.summaryOnly = true;
+        }
         const merged = mergeBodies(body, opts.jsonInput);
         if (!merged.meetingId || String(merged.meetingId).trim() === "") {
             throw new Error("meetingId is required (--meeting-id)");
         }
-        const out = await runTool("get-meeting-transcript", { meetingId: String(merged.meetingId).trim() }, { postMcp });
+        const out = await runTool("get-meeting-transcript", {
+            meetingId: String(merged.meetingId).trim(),
+            ...(merged.summaryOnly ? { summaryOnly: true } : {}),
+        }, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("get-meeting-set")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-meeting-set").description)
+        .addOption(jsonInputOption())
+        .option("--meeting-set-id <id>", "meeting-set ULID (from `/testchimp using meeting-set context <id>`)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.meetingSetId) {
+            body.meetingSetId = String(opts.meetingSetId).trim();
+        }
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.meetingSetId || String(merged.meetingSetId).trim() === "") {
+            throw new Error("meetingSetId is required (--meeting-set-id)");
+        }
+        const out = await runTool("get-meeting-set", { meetingSetId: String(merged.meetingSetId).trim() }, { postMcp });
+        console.log(out);
+    });
+    const collectRepeatable = (value, previous = []) => [
+        ...previous,
+        ...value.split(",").map((s) => s.trim()).filter(Boolean),
+    ];
+    program
+        .command("list-meetings")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-meetings").description)
+        .addOption(jsonInputOption())
+        .option("--from <date>", "inclusive start: YYYY-MM-DD (local start of day), ISO datetime, or epoch millis")
+        .option("--to <date>", "inclusive end: YYYY-MM-DD (local end of day), ISO datetime, or epoch millis")
+        .option("--label <label>", "label filter (repeatable or comma-separated; OR, case-insensitive)", collectRepeatable)
+        .option("--participant <emailOrUserId>", "participant filter by email or user id (repeatable or comma-separated; OR)", collectRepeatable)
+        .option("--domain <domain>", "participant email domain filter (repeatable or comma-separated; OR)", collectRepeatable)
+        .option("--search <text>", "full-text search over title + transcript")
+        .option("--page-size <n>", "page size (default 50, max 200; max 25 when searching)")
+        .option("--page-token <token>", "nextPageToken from the previous page")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.from)
+            body.from = String(opts.from).trim();
+        if (opts.to)
+            body.to = String(opts.to).trim();
+        if (opts.label?.length)
+            body.labels = opts.label;
+        if (opts.participant?.length)
+            body.participantKeys = opts.participant;
+        if (opts.domain?.length)
+            body.participantDomains = opts.domain;
+        if (opts.search)
+            body.searchText = String(opts.search);
+        if (opts.pageSize) {
+            const n = Number(opts.pageSize);
+            if (!Number.isInteger(n) || n <= 0)
+                throw new Error("--page-size must be a positive integer");
+            body.pageSize = n;
+        }
+        if (opts.pageToken)
+            body.pageToken = String(opts.pageToken).trim();
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("list-meetings", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("list-meeting-filter-options")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-meeting-filter-options").description)
+        .action(async () => {
+        const out = await runTool("list-meeting-filter-options", {}, { postMcp });
         console.log(out);
     });
     program

package/dist/core/dates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse a date bound to epoch millis: epoch millis, ISO date (`2026-09-01`), or ISO datetime.
+ * Date-only values use local time: start of day, or end of day when `endOfDay` is set
+ * (so `--to 2026-09-30` includes meetings on the 30th).
+ */
+export declare function parseDateBoundToMillis(raw: string | number, endOfDay?: boolean): number;

package/dist/core/dates.js

@@ -0,0 +1,30 @@
+const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+const EPOCH_MILLIS = /^\d{10,}$/;
+/**
+ * Parse a date bound to epoch millis: epoch millis, ISO date (`2026-09-01`), or ISO datetime.
+ * Date-only values use local time: start of day, or end of day when `endOfDay` is set
+ * (so `--to 2026-09-30` includes meetings on the 30th).
+ */
+export function parseDateBoundToMillis(raw, endOfDay = false) {
+    if (typeof raw === "number") {
+        if (!Number.isFinite(raw))
+            throw new Error(`Invalid date: ${raw}`);
+        return Math.trunc(raw);
+    }
+    const value = String(raw).trim();
+    if (EPOCH_MILLIS.test(value))
+        return Number(value);
+    if (DATE_ONLY.test(value)) {
+        const [y, m, d] = value.split("-").map(Number);
+        const date = endOfDay ? new Date(y, m - 1, d, 23, 59, 59, 999) : new Date(y, m - 1, d, 0, 0, 0, 0);
+        if (date.getFullYear() !== y || date.getMonth() !== m - 1 || date.getDate() !== d) {
+            throw new Error(`Invalid date: ${value}`);
+        }
+        return date.getTime();
+    }
+    const millis = Date.parse(value);
+    if (Number.isNaN(millis)) {
+        throw new Error(`Invalid date: ${value} (use YYYY-MM-DD, an ISO datetime, or epoch millis)`);
+    }
+    return millis;
+}

package/dist/core/schemas.d.ts

@@ -291,7 +291,24 @@ export declare const getManualSessionDetailsInput: z.ZodObject<{
 }, z.core.$strip>;
 export declare const getMeetingTranscriptInput: z.ZodObject<{
     meetingId: z.ZodString;
+    summaryOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+export declare const getMeetingSetInput: z.ZodObject<{
+    meetingSetId: z.ZodString;
+}, z.core.$strip>;
+export declare const listMeetingsInput: z.ZodObject<{
+    from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    to: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    startDateMillis: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    endDateMillis: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    participantKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    participantDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    searchText: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const listMeetingFilterOptionsInput: z.ZodObject<{}, z.core.$strip>;
 export declare const getIssueDetailsInput: z.ZodObject<{
     issueId: z.ZodString;
 }, z.core.$strip>;

package/dist/core/schemas.js

@@ -170,7 +170,36 @@ export const getManualSessionDetailsInput = z.object({
 export const getMeetingTranscriptInput = z.object({
     /** Calendar event id, or URL hash for ad-hoc meetings */
     meetingId: z.string().min(1),
-});
+    /** Return only the post-meeting summary (transcript body omitted). */
+    summaryOnly: z.boolean().optional(),
+});
+export const getMeetingSetInput = z.object({
+    /** ULID from `/testchimp using meeting-set context <id>` (Meetings page → Start Chat) */
+    meetingSetId: z.string().min(1),
+});
+export const listMeetingsInput = z.object({
+    /** Inclusive start bound: YYYY-MM-DD (local start of day), ISO datetime, or epoch millis. */
+    from: z.union([z.string().min(1), z.number()]).optional(),
+    /** Inclusive end bound: YYYY-MM-DD (local end of day), ISO datetime, or epoch millis. */
+    to: z.union([z.string().min(1), z.number()]).optional(),
+    /** Raw inclusive start (epoch millis); `from` wins when both are set. */
+    startDateMillis: z.union([z.string().min(1), z.number()]).optional(),
+    /** Raw inclusive end (epoch millis); `to` wins when both are set. */
+    endDateMillis: z.union([z.string().min(1), z.number()]).optional(),
+    /** OR filter, case-insensitive (exact values from list-meeting-filter-options). */
+    labels: z.array(z.string().min(1)).optional(),
+    /** OR filter: participant user ids or emails (keys from list-meeting-filter-options). */
+    participantKeys: z.array(z.string().min(1)).optional(),
+    /** OR filter: participant email domains (e.g. customer.com). */
+    participantDomains: z.array(z.string().min(1)).optional(),
+    /** Full-text search over title + transcript (web-search syntax: quotes, OR, -exclude). */
+    searchText: z.string().optional(),
+    /** Default 50, max 200 (max 25 when searchText is set). */
+    pageSize: z.number().int().positive().optional(),
+    /** nextPageToken from the previous page. */
+    pageToken: z.string().min(1).optional(),
+});
+export const listMeetingFilterOptionsInput = z.object({});
 export const getIssueDetailsInput = z.object({
     /** Accepts #B-123, B-123, #B123, B123, or plain 123 */
     issueId: z.string().min(1),

package/dist/core/tools.js

@@ -2,6 +2,7 @@ import { normalizeScope } from "./normalize.js";
 import { runProvisionEphemeralEnvironmentAndWait } from "./ephemeralWait.js";
 import * as S from "./schemas.js";
 import { resolveGitHeadSha } from "./gitSha.js";
+import { parseDateBoundToMillis } from "./dates.js";
 import { buildAgentTraceabilityPayload, resolveToolchainVersions } from "./agentTraceability.js";
 function platformToProtoEnum(platform) {
     switch (platform) {
@@ -388,16 +389,78 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "get-meeting-transcript",
         description: "Fetch a cloud-synced Meeting Bots transcript by meeting id (calendar event id, or URL hash " +
-            "for ad-hoc meetings). Prefer local ~/.testchimp/data/meetings/<meeting-id>/transcript.md " +
+            "for ad-hoc meetings). Returns title, start time, post-meeting summary, and transcript. " +
+            "Use summaryOnly to fetch just the summary (much smaller) and pull the full transcript only " +
+            "when the summary is not enough. Prefer local ~/.testchimp/data/meetings/<meeting-id>/transcript.md " +
             "when present on Studio / the recording machine.",
         inputSchema: S.getMeetingTranscriptInput,
         execute: async (args, { postMcp }) => {
             const a = args;
             return postMcp("/api/mcp/get_meeting_transcript", {
                 meetingId: a.meetingId,
+                ...(a.summaryOnly ? { summaryOnly: true } : {}),
             });
         },
     },
+    {
+        kebab: "get-meeting-set",
+        description: "Fetch a meeting-set context by id (ULID from `/testchimp using meeting-set context <id>`, " +
+            "created on the Meetings page via Start Chat). Returns the filters / search text applied and " +
+            "the meetings in scope (id, title, start). Fetch each meeting with get-meeting-transcript " +
+            "(summaryOnly first). Sets expire after 7 days.",
+        inputSchema: S.getMeetingSetInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/get_meeting_set", {
+                meetingSetId: a.meetingSetId,
+            });
+        },
+    },
+    {
+        kebab: "list-meetings",
+        description: "List / search cloud-synced Meeting Bots meetings, newest first, like the Meetings page " +
+            "filters + search. Team-wide meetings only (visibility: all team members). Filters: from / to " +
+            "(YYYY-MM-DD, ISO datetime, or epoch millis; inclusive), labels, participantKeys (user id or " +
+            "email), participantDomains, searchText (full-text over title + transcript; hits include a " +
+            "searchSnippet with matches wrapped in ⟦ ⟧). Returns meetingId, title, startMillis, labels, " +
+            "participants, summaryStatus; page with nextPageToken. Use list-meeting-filter-options for exact " +
+            "label / domain / participant values, then get-meeting-transcript (summaryOnly first) per hit.",
+        inputSchema: S.listMeetingsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            const start = a.from ?? a.startDateMillis;
+            const end = a.to ?? a.endDateMillis;
+            if (start != null)
+                body.startDateMillis = String(parseDateBoundToMillis(start));
+            if (end != null)
+                body.endDateMillis = String(parseDateBoundToMillis(end, true));
+            if (a.labels?.length)
+                body.labels = a.labels.map((v) => v.trim());
+            if (a.participantKeys?.length)
+                body.participantKeys = a.participantKeys.map((v) => v.trim());
+            if (a.participantDomains?.length) {
+                body.participantDomains = a.participantDomains.map((v) => v.trim().replace(/^@/, ""));
+            }
+            if (a.searchText?.trim())
+                body.searchText = a.searchText.trim();
+            if (a.pageSize != null)
+                body.pageSize = a.pageSize;
+            if (a.pageToken)
+                body.pageToken = a.pageToken;
+            return postMcp("/api/mcp/list_meetings", body);
+        },
+    },
+    {
+        kebab: "list-meeting-filter-options",
+        description: "List the labels, participants (key = user id or email, with display name), and participant " +
+            "email domains that appear on team-wide Meeting Bots meetings. Use the exact values as " +
+            "list-meetings filters (labels, participantKeys, participantDomains).",
+        inputSchema: S.listMeetingFilterOptionsInput,
+        execute: async (_args, { postMcp }) => {
+            return postMcp("/api/mcp/list_meeting_filter_options", {});
+        },
+    },
     {
         kebab: "get-issue-details",
         description: "Fetch a TestChimp issue (bug) by ordinal id. Accepts flexible issueId formats: " +

package/dist/core/tools.test.js

@@ -73,4 +73,93 @@ describe("get-meeting-transcript", () => {
         });
         assert.deepEqual(JSON.parse(result), JSON.parse(response));
     });
+    it("passes summaryOnly when requested", async () => {
+        let body;
+        await runTool("get-meeting-transcript", { meetingId: "evt-123", summaryOnly: true }, {
+            postMcp: async (_path, b) => {
+                body = b;
+                return "{}";
+            },
+        });
+        assert.deepEqual(body, { meetingId: "evt-123", summaryOnly: true });
+    });
+});
+describe("get-meeting-set", () => {
+    it("posts meetingSetId to get_meeting_set", async () => {
+        let request;
+        await runTool("get-meeting-set", { meetingSetId: "01J9Z3X5V4ABCDEF0123456789" }, {
+            postMcp: async (path, body) => {
+                request = { path, body };
+                return "{}";
+            },
+        });
+        assert.deepEqual(request, {
+            path: "/api/mcp/get_meeting_set",
+            body: { meetingSetId: "01J9Z3X5V4ABCDEF0123456789" },
+        });
+    });
+});
+describe("list-meetings", () => {
+    async function capture(args) {
+        let request;
+        await runTool("list-meetings", args, {
+            postMcp: async (path, body) => {
+                request = { path, body };
+                return "{}";
+            },
+        });
+        return request;
+    }
+    it("maps filters and converts date-only bounds to inclusive local-day millis", async () => {
+        const request = await capture({
+            from: "2026-09-01",
+            to: "2026-09-30",
+            labels: ["Sales "],
+            participantKeys: ["buyer@customer.com"],
+            participantDomains: ["@customer.com"],
+            searchText: " pricing ",
+            pageSize: 10,
+            pageToken: "tok",
+        });
+        assert.deepEqual(request, {
+            path: "/api/mcp/list_meetings",
+            body: {
+                startDateMillis: String(new Date(2026, 8, 1, 0, 0, 0, 0).getTime()),
+                endDateMillis: String(new Date(2026, 8, 30, 23, 59, 59, 999).getTime()),
+                labels: ["Sales"],
+                participantKeys: ["buyer@customer.com"],
+                participantDomains: ["customer.com"],
+                searchText: "pricing",
+                pageSize: 10,
+                pageToken: "tok",
+            },
+        });
+    });
+    it("accepts ISO datetimes and raw epoch millis, and omits empty filters", async () => {
+        const request = await capture({ from: "2026-09-01T10:00:00Z", endDateMillis: "1790000000000" });
+        assert.deepEqual(request, {
+            path: "/api/mcp/list_meetings",
+            body: {
+                startDateMillis: String(Date.parse("2026-09-01T10:00:00Z")),
+                endDateMillis: "1790000000000",
+            },
+        });
+        assert.deepEqual(await capture({}), { path: "/api/mcp/list_meetings", body: {} });
+    });
+    it("rejects unparseable dates", async () => {
+        await assert.rejects(() => capture({ from: "last tuesday" }), /Invalid date/);
+        await assert.rejects(() => capture({ to: "2026-02-30" }), /Invalid date/);
+    });
+});
+describe("list-meeting-filter-options", () => {
+    it("posts an empty body to list_meeting_filter_options", async () => {
+        let request;
+        await runTool("list-meeting-filter-options", {}, {
+            postMcp: async (path, body) => {
+                request = { path, body };
+                return "{}";
+            },
+        });
+        assert.deepEqual(request, { path: "/api/mcp/list_meeting_filter_options", body: {} });
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testchimp/cli",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "description": "TestChimp CLI and MCP server — coverage, plans, EaaS, TrueCoverage, API operations (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",