@testchimp/cli 0.1.5 → 0.1.7

package/dist/cli/program.js

@@ -46,6 +46,7 @@ export function buildCliProgram() {
         .option("--release <s>")
         .option("--environment <s>")
         .option("--branch-name <s>")
+        .option("--platform <web|ios|android>")
         .option("--file-paths <csv>", "comma-separated paths under platform tests root")
         .option("--folder-path <path>", "folder under tests root, slash-separated")
         .action(async (opts) => {
@@ -56,6 +57,8 @@ export function buildCliProgram() {
             body.environment = opts.environment;
         if (opts.branchName)
             body.branchName = opts.branchName;
+        if (opts.platform)
+            body.platform = opts.platform;
         const scope = {};
         if (opts.filePaths)
             scope.filePaths = String(opts.filePaths).split(",").map((s) => s.trim()).filter(Boolean);
@@ -74,6 +77,8 @@ export function buildCliProgram() {
         .option("--release <s>")
         .option("--environment <s>")
         .option("--branch-name <s>")
+        .option("--scenario-id <id>")
+        .option("--platform <web|ios|android>")
         .option("--file-paths <csv>")
         .option("--folder-path <path>")
         .action(async (opts) => {
@@ -84,6 +89,10 @@ export function buildCliProgram() {
             body.environment = opts.environment;
         if (opts.branchName)
             body.branchName = opts.branchName;
+        if (opts.scenarioId)
+            body.scenarioId = opts.scenarioId;
+        if (opts.platform)
+            body.platform = opts.platform;
         const scope = {};
         if (opts.filePaths)
             scope.filePaths = String(opts.filePaths).split(",").map((s) => s.trim()).filter(Boolean);
@@ -332,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/schemas.d.ts

@@ -3,6 +3,10 @@ export declare const scopeSchema: z.ZodOptional<z.ZodObject<{
     filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
     folderPath: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
 }, z.core.$strip>>;
+export declare const executionJobDimensionFilterSchema: z.ZodObject<{
+    dimension: z.ZodString;
+    values: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
 export declare const listCoverageInput: z.ZodObject<{
     release: z.ZodOptional<z.ZodString>;
     environment: z.ZodOptional<z.ZodString>;
@@ -13,6 +17,11 @@ export declare const listCoverageInput: z.ZodObject<{
     includeNonCoveredUserStories: z.ZodOptional<z.ZodBoolean>;
     includeNonCoveredTestScenarios: z.ZodOptional<z.ZodBoolean>;
     branchName: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        ios: "ios";
+        android: "android";
+    }>>;
 }, z.core.$strip>;
 export declare const listExecutionInput: z.ZodObject<{
     release: z.ZodOptional<z.ZodString>;
@@ -22,6 +31,18 @@ export declare const listExecutionInput: z.ZodObject<{
         folderPath: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
     }, z.core.$strip>>;
     branchName: z.ZodOptional<z.ZodString>;
+    scenarioId: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        ios: "ios";
+        android: "android";
+    }>>;
+    dimensionFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodString;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const fetchExecutionReportInput: z.ZodObject<{
     batchInvocationId: z.ZodOptional<z.ZodString>;

package/dist/core/schemas.js

@@ -5,6 +5,11 @@ export const scopeSchema = z
     folderPath: z.union([z.array(z.string()), z.string()]).optional(),
 })
     .optional();
+const executionPlatformSchema = z.enum(["web", "ios", "android"]);
+export const executionJobDimensionFilterSchema = z.object({
+    dimension: z.string().min(1),
+    values: z.array(z.string()).min(1),
+});
 export const listCoverageInput = z.object({
     release: z.string().optional(),
     environment: z.string().optional(),
@@ -12,12 +17,18 @@ export const listCoverageInput = z.object({
     includeNonCoveredUserStories: z.boolean().optional(),
     includeNonCoveredTestScenarios: z.boolean().optional(),
     branchName: z.string().optional(),
+    platform: executionPlatformSchema.optional(),
 });
 export const listExecutionInput = z.object({
     release: z.string().optional(),
     environment: z.string().optional(),
     scope: scopeSchema,
     branchName: z.string().optional(),
+    scenarioId: z.string().optional(),
+    platform: executionPlatformSchema.optional(),
+    dimensionFilters: z.array(executionJobDimensionFilterSchema).optional(),
+    limit: z.number().int().positive().max(500).optional(),
+    offset: z.number().int().nonnegative().optional(),
 });
 export const fetchExecutionReportInput = z
     .object({

package/dist/core/tools.js

@@ -1,6 +1,16 @@
 import { normalizeScope } from "./normalize.js";
 import { runProvisionEphemeralEnvironmentAndWait } from "./ephemeralWait.js";
 import * as S from "./schemas.js";
+function platformToProtoEnum(platform) {
+    switch (platform) {
+        case "ios":
+            return "IOS_EXECUTION_PLATFORM";
+        case "android":
+            return "ANDROID_EXECUTION_PLATFORM";
+        default:
+            return "WEB_EXECUTION_PLATFORM";
+    }
+}
 function listCoverageBody(args) {
     const body = {};
     if (args.release != null)
@@ -16,6 +26,8 @@ function listCoverageBody(args) {
     }
     if (args.branchName != null && args.branchName.trim() !== "")
         body.branchName = args.branchName.trim();
+    if (args.platform != null)
+        body.platform = platformToProtoEnum(args.platform);
     return body;
 }
 function listExecutionBody(args) {
@@ -28,6 +40,24 @@ function listExecutionBody(args) {
         body.scope = normalizeScope(args.scope);
     if (args.branchName != null && args.branchName.trim() !== "")
         body.branchName = args.branchName.trim();
+    if (args.scenarioId != null && args.scenarioId.trim() !== "")
+        body.scenarioId = args.scenarioId.trim();
+    const dimensionFilters = [...(args.dimensionFilters ?? [])];
+    if (args.platform != null) {
+        const hasPlatformFilter = dimensionFilters.some((f) => f.dimension === "PLATFORM_EXECUTION_JOB_FILTER_DIMENSION");
+        if (!hasPlatformFilter) {
+            dimensionFilters.push({
+                dimension: "PLATFORM_EXECUTION_JOB_FILTER_DIMENSION",
+                values: [args.platform.toUpperCase()],
+            });
+        }
+    }
+    if (dimensionFilters.length > 0)
+        body.dimensionFilters = dimensionFilters;
+    if (args.limit != null)
+        body.limit = args.limit;
+    if (args.offset != null)
+        body.offset = args.offset;
     return body;
 }
 export const TOOL_DEFINITIONS = [
@@ -36,7 +66,7 @@ export const TOOL_DEFINITIONS = [
         description: "Fetch requirement (scenario) coverage under an optional platform-rooted folder scope (tests/... or plans/...). " +
             "Use scope.filePaths or scope.folderPath (platform tests/plans roots). Omit branchName for cross-branch coverage " +
             "(aggregates branch copies; execution jobs deduped by stable hash of tests-root-relative path + test name). " +
-            "Pass branchName only when results must be limited to one Git branch.",
+            "Pass branchName only when results must be limited to one Git branch. Optional platform (web|ios|android) filters rollup.",
         inputSchema: S.listCoverageInput,
         execute: async (args, { postMcp }) => {
             const json = await postMcp("/api/mcp/list_requirement_coverage", listCoverageBody(args));
@@ -45,8 +75,8 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "get-execution-history",
-        description: "Fetch SmartTest execution history for an optional platform-rooted folder scope. " +
-            "Use branchName and scope.filePaths as for coverage.",
+        description: "Fetch SmartTest execution history for an optional platform-rooted folder scope, or for a scenario when scenarioId is set. " +
+            "Use branchName and scope.filePaths as for coverage. Optional platform (web|ios|android) and dimensionFilters narrow results.",
         inputSchema: S.listExecutionInput,
         execute: async (args, { postMcp }) => {
             const json = await postMcp("/api/mcp/list_execution_history", listExecutionBody(args));
@@ -243,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.5",
+  "version": "0.1.7",
   "description": "TestChimp CLI and MCP server — coverage, plans, EaaS, TrueCoverage (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",