@testchimp/cli 0.1.6 → 0.1.7

package/dist/cli/program.js

@@ -341,7 +341,7 @@ export function buildCliProgram() {
         const out = await runTool("list-rum-environments", merged, { postMcp });
         console.log(out);
     });
-    const truecoverageHelp = "Prefer --json-input with full request JSON (proto-shaped). Flags are optional shortcuts where listed.";
+    const truecoverageHelp = "Use --json-input with full request JSON (proto-shaped; set platform inside each ExecutionScope).";
     program
         .command("get-truecoverage-events")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-truecoverage-events").description + " " + truecoverageHelp)

package/dist/core/tools.js

@@ -273,31 +273,38 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "get-truecoverage-events",
-        description: "TrueCoverage event funnel summaries (ListEventsRequest JSON: baseExecutionScope, comparisonExecutionScope).",
+        description: "TrueCoverage event funnel summaries (ListEventsRequest JSON: baseExecutionScope, comparisonExecutionScope). " +
+            "Optional ExecutionScope.platform: WEB_EXECUTION_PLATFORM | IOS_EXECUTION_PLATFORM | ANDROID_EXECUTION_PLATFORM " +
+            "(filters RUM rows stamped via testchimp-rum-platform header: web=1, ios=2, android=3). " +
+            "Use automationEmitsOnly on comparisonExecutionScope for test-tagged emits only.",
         inputSchema: S.truecoverageJsonInput,
         execute: async (args, { postMcp }) => postMcp("/api/mcp/truecoverage_list_events", args ?? {}),
     },
     {
         kebab: "get-truecoverage-event-details",
-        description: "TrueCoverage drill-down for one event title (GetEventDetailsRequest JSON).",
+        description: "TrueCoverage drill-down for one event title (GetEventDetailsRequest JSON). " +
+            "Optional platform on baseExecutionScope / comparisonExecutionScope (WEB_EXECUTION_PLATFORM, IOS_EXECUTION_PLATFORM, ANDROID_EXECUTION_PLATFORM).",
         inputSchema: S.truecoverageJsonInput,
         execute: async (args, { postMcp }) => postMcp("/api/mcp/truecoverage_event_details", args ?? {}),
     },
     {
         kebab: "get-truecoverage-child-event-tree",
-        description: "TrueCoverage next-event tree for an event (ListChildEventTreeRequest JSON).",
+        description: "TrueCoverage next-event tree for an event (ListChildEventTreeRequest JSON). " +
+            "Optional platform on baseScope / coverageScope (inside each ExecutionScope).",
         inputSchema: S.truecoverageJsonInput,
         execute: async (args, { postMcp }) => postMcp("/api/mcp/truecoverage_list_child_event_tree", args ?? {}),
     },
     {
         kebab: "get-truecoverage-event-transition",
-        description: "TrueCoverage detailed transition summary between events (GetDetailedEventTransitionSummaryRequest JSON).",
+        description: "TrueCoverage detailed transition summary between events (GetDetailedEventTransitionSummaryRequest JSON). " +
+            "Optional platform on baseScope / coverageScope (inside each ExecutionScope).",
         inputSchema: S.truecoverageJsonInput,
         execute: async (args, { postMcp }) => postMcp("/api/mcp/truecoverage_detailed_event_transition", args ?? {}),
     },
     {
         kebab: "get-truecoverage-event-time-series",
-        description: "TrueCoverage time series for sessions or metrics (EventTimeSeriesRequest JSON).",
+        description: "TrueCoverage time series for sessions or metrics (EventTimeSeriesRequest JSON). " +
+            "Optional platform on baseExecutionScope.",
         inputSchema: S.truecoverageJsonInput,
         execute: async (args, { postMcp }) => postMcp("/api/mcp/truecoverage_event_time_series", args ?? {}),
     },

package/dist/core/truecoverageScope.d.ts

@@ -0,0 +1,16 @@
+/** Maps CLI/MCP shorthand to {@code com.aware.common.ExecutionPlatform} JSON enum names. */
+export declare function platformToProtoEnum(platform: "web" | "ios" | "android"): string;
+export type TruecoveragePlatformCli = "web" | "ios" | "android";
+export interface TruecoveragePlatformOpts {
+    base?: TruecoveragePlatformCli;
+    /** Secondary / coverage-aligned scope (`comparisonExecutionScope` or `coverageScope` per endpoint). */
+    comparison?: TruecoveragePlatformCli;
+}
+/** MCP/CLI top-level shortcuts (`basePlatform`, …) stripped before POST. */
+export declare function parseTruecoveragePlatformArgs(args: unknown): TruecoveragePlatformOpts | undefined;
+export declare function stripTruecoveragePlatformShortcuts(body: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Apply CLI/MCP platform shortcuts onto nested execution scopes (scope.platform in JSON wins).
+ */
+export declare function applyTruecoveragePlatforms(body: Record<string, unknown>, opts?: TruecoveragePlatformOpts): Record<string, unknown>;
+export declare function prepareTruecoverageRequestBody(args: unknown): Record<string, unknown>;

package/dist/core/truecoverageScope.js

@@ -0,0 +1,74 @@
+/** Maps CLI/MCP shorthand to {@code com.aware.common.ExecutionPlatform} JSON enum names. */
+export function platformToProtoEnum(platform) {
+    switch (platform) {
+        case "ios":
+            return "IOS_EXECUTION_PLATFORM";
+        case "android":
+            return "ANDROID_EXECUTION_PLATFORM";
+        default:
+            return "WEB_EXECUTION_PLATFORM";
+    }
+}
+function setScopePlatform(scope, platform) {
+    if (!scope)
+        return;
+    scope.platform = platformToProtoEnum(platform);
+}
+function pickPlatformCli(v) {
+    if (v === "web" || v === "ios" || v === "android")
+        return v;
+    return undefined;
+}
+/** MCP/CLI top-level shortcuts (`basePlatform`, …) stripped before POST. */
+export function parseTruecoveragePlatformArgs(args) {
+    if (args == null || typeof args !== "object")
+        return undefined;
+    const a = args;
+    const base = pickPlatformCli(a.basePlatform);
+    const comparison = pickPlatformCli(a.comparisonPlatform) ?? pickPlatformCli(a.coveragePlatform);
+    if (base == null && comparison == null)
+        return undefined;
+    return { base, comparison };
+}
+export function stripTruecoveragePlatformShortcuts(body) {
+    const { basePlatform: _b, comparisonPlatform: _c, coveragePlatform: _v, ...rest } = body;
+    return rest;
+}
+function mergeScopePlatform(scope, platform) {
+    if (scope == null || scope.platform != null)
+        return scope;
+    const next = { ...scope };
+    setScopePlatform(next, platform);
+    return next;
+}
+/**
+ * Apply CLI/MCP platform shortcuts onto nested execution scopes (scope.platform in JSON wins).
+ */
+export function applyTruecoveragePlatforms(body, opts) {
+    if (!opts)
+        return body;
+    const out = { ...body };
+    if (opts.base != null) {
+        const nextBase = mergeScopePlatform(out.baseExecutionScope, opts.base);
+        if (nextBase != null)
+            out.baseExecutionScope = nextBase;
+        const nextBaseScope = mergeScopePlatform(out.baseScope, opts.base);
+        if (nextBaseScope != null)
+            out.baseScope = nextBaseScope;
+    }
+    if (opts.comparison != null) {
+        const nextComp = mergeScopePlatform(out.comparisonExecutionScope, opts.comparison);
+        if (nextComp != null)
+            out.comparisonExecutionScope = nextComp;
+        const nextCov = mergeScopePlatform(out.coverageScope, opts.comparison);
+        if (nextCov != null)
+            out.coverageScope = nextCov;
+    }
+    return out;
+}
+export function prepareTruecoverageRequestBody(args) {
+    const raw = args ?? {};
+    const platformOpts = parseTruecoveragePlatformArgs(raw);
+    const stripped = stripTruecoveragePlatformShortcuts({ ...raw });
+    return applyTruecoveragePlatforms(stripped, platformOpts);
+}

package/package.json

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