@testchimp/cli 0.1.1 → 0.1.3

package/dist/cli/program.js

@@ -95,6 +95,22 @@ export function buildCliProgram() {
         const out = await runTool("get-execution-history", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("fetch-execution-report")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "fetch-execution-report").description)
+        .addOption(jsonInputOption())
+        .option("--batch-invocation-id <id>")
+        .option("--job-id <id>")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.batchInvocationId)
+            body.batchInvocationId = String(opts.batchInvocationId);
+        if (opts.jobId)
+            body.jobId = String(opts.jobId);
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("fetch-execution-report", merged, { postMcp });
+        console.log(out);
+    });
     program
         .command("create-user-story")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "create-user-story").description)

package/dist/core/schemas.d.ts

@@ -23,6 +23,10 @@ export declare const listExecutionInput: z.ZodObject<{
     }, z.core.$strip>>;
     branchName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const fetchExecutionReportInput: z.ZodObject<{
+    batchInvocationId: z.ZodOptional<z.ZodString>;
+    jobId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const createUserStoryInput: z.ZodObject<{
     platformFilePath: z.ZodString;
     title: z.ZodString;
@@ -68,3 +72,14 @@ export declare const getBunnyshellWorkflowJobLogsInput: z.ZodObject<{
     bnsEnvironmentId: z.ZodString;
     workflowJobId: z.ZodString;
 }, z.core.$strip>;
+/** ListScreenStatesRequest JSON (proto camelCase). */
+export declare const listScreenStatesInput: z.ZodObject<{
+    environment: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** UpsertScreenStatesRequest JSON (proto camelCase). */
+export declare const upsertScreenStatesInput: z.ZodObject<{
+    screenStates: z.ZodArray<z.ZodObject<{
+        screen: z.ZodOptional<z.ZodString>;
+        states: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/core/schemas.js

@@ -19,6 +19,21 @@ export const listExecutionInput = z.object({
     scope: scopeSchema,
     branchName: z.string().optional(),
 });
+export const fetchExecutionReportInput = z
+    .object({
+    batchInvocationId: z.string().optional(),
+    jobId: z.string().optional(),
+})
+    .superRefine((v, ctx) => {
+    const batch = (v.batchInvocationId ?? "").trim();
+    const job = (v.jobId ?? "").trim();
+    if ((batch === "" && job === "") || (batch !== "" && job !== "")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide exactly one of batchInvocationId or jobId",
+        });
+    }
+});
 export const createUserStoryInput = z.object({
     platformFilePath: z.string().min(1),
     title: z.string().min(1),
@@ -64,3 +79,15 @@ export const getBunnyshellWorkflowJobLogsInput = z.object({
     bnsEnvironmentId: z.string().min(1),
     workflowJobId: z.string().min(1),
 });
+/** ListScreenStatesRequest JSON (proto camelCase). */
+export const listScreenStatesInput = z.object({
+    environment: z.string().optional(),
+});
+const screenStatesEntrySchema = z.object({
+    screen: z.string().optional(),
+    states: z.array(z.string()),
+});
+/** UpsertScreenStatesRequest JSON (proto camelCase). */
+export const upsertScreenStatesInput = z.object({
+    screenStates: z.array(screenStatesEntrySchema).min(1),
+});

package/dist/core/tools.js

@@ -51,6 +51,21 @@ export const TOOL_DEFINITIONS = [
             return json;
         },
     },
+    {
+        kebab: "fetch-execution-report",
+        description: "Fetch a detailed execution report for failing SmartTests, given a batchInvocationId (batch run) or jobId (single run). " +
+            "Returns only failing tests and includes error details and a trace viewer URL when available.",
+        inputSchema: S.fetchExecutionReportInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.batchInvocationId != null && a.batchInvocationId.trim() !== "")
+                body.batchInvocationId = a.batchInvocationId.trim();
+            if (a.jobId != null && a.jobId.trim() !== "")
+                body.jobId = a.jobId.trim();
+            return postMcp("/api/mcp/fetch_execution_report", body);
+        },
+    },
     {
         kebab: "create-user-story",
         description: "Create a user story on the TestChimp project and its plan file stub. " +
@@ -252,6 +267,29 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/truecoverage_event_metadata_keys", { eventTitle: a.eventTitle });
         },
     },
+    {
+        kebab: "list-screen-states",
+        description: "Fetch the project's screen/state vocabulary (relational atlas) for SmartTests and traces. " +
+            "Optional environment field is accepted for forward compatibility; v1 may be project-global.",
+        inputSchema: S.listScreenStatesInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.environment != null && a.environment.trim() !== "")
+                body.environment = a.environment.trim();
+            return postMcp("/api/mcp/list_screen_states", body);
+        },
+    },
+    {
+        kebab: "upsert-screen-states",
+        description: "Merge screen names and state strings into the project's relational atlas (idempotent upsert). " +
+            "Body uses camelCase screenStates: [{ screen, states: string[] }, ...] per UpsertScreenStatesRequest.",
+        inputSchema: S.upsertScreenStatesInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/upsert_screen_states", { screenStates: a.screenStates });
+        },
+    },
 ];
 const TOOL_BY_KEBAB = new Map(TOOL_DEFINITIONS.map((t) => [t.kebab, t]));
 export function getToolDefinition(kebab) {

package/package.json

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