@testchimp/cli 0.1.23 → 0.1.25

package/dist/cli/program.js

@@ -169,6 +169,7 @@ export function buildCliProgram() {
         .option("--environment <s>")
         .option("--branch-name <s>")
         .option("--scenario-id <id>")
+        .option("--test-id <id>")
         .option("--platform <web|ios|android>")
         .option("--file-paths <csv>")
         .option("--folder-path <path>")
@@ -182,6 +183,8 @@ export function buildCliProgram() {
             body.branchName = opts.branchName;
         if (opts.scenarioId)
             body.scenarioId = opts.scenarioId;
+        if (opts.testId)
+            body.testId = opts.testId;
         if (opts.platform)
             body.platform = opts.platform;
         const scope = {};
@@ -1064,6 +1067,28 @@ export function buildCliProgram() {
         }
         console.log(await runTool("upsert-policy", merged, { postMcp }));
     });
+    program
+        .command("upsert-plans-support-file")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "upsert-plans-support-file").description)
+        .addOption(jsonInputOption())
+        .option("--file-path <path>", "path relative to mapped plans root (e.g. knowledge/workflow_plans/run-qa/<ulid>.plan.md)")
+        .option("--content <markdown>", "full file content")
+        .option("--content-file <path>", "read content from local file")
+        .action(async (opts) => {
+        let content = opts.content;
+        if (opts.contentFile)
+            content = await readFile(String(opts.contentFile), "utf8");
+        const body = {};
+        if (opts.filePath)
+            body.filePath = String(opts.filePath);
+        if (content !== undefined)
+            body.content = content;
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.filePath || merged.content === undefined || merged.content === null) {
+            throw new Error("Provide --file-path and --content or --content-file (or full body via --json-input)");
+        }
+        console.log(await runTool("upsert-plans-support-file", merged, { postMcp }));
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/schemas.d.ts

@@ -38,6 +38,7 @@ export declare const listExecutionInput: z.ZodObject<{
     }, z.core.$strip>>;
     branchName: z.ZodOptional<z.ZodString>;
     scenarioId: z.ZodOptional<z.ZodString>;
+    testId: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
         web: "web";
         ios: "ios";
@@ -1350,4 +1351,8 @@ export declare const upsertPolicyInput: z.ZodObject<{
     policyFileName: z.ZodString;
     content: z.ZodString;
 }, z.core.$strip>;
+export declare const upsertPlansSupportFileInput: z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
 export declare const listWorkflowCatalogInput: z.ZodObject<{}, z.core.$strip>;

package/dist/core/schemas.js

@@ -33,6 +33,7 @@ export const listExecutionInput = z.object({
     scope: scopeSchema,
     branchName: z.string().optional(),
     scenarioId: z.string().optional(),
+    testId: z.string().optional(),
     platform: executionPlatformSchema.optional(),
     dimensionFilters: z.array(executionJobDimensionFilterSchema).optional(),
     limit: z.number().int().positive().max(500).optional(),
@@ -682,4 +683,9 @@ export const upsertPolicyInput = z.object({
     policyFileName: z.string().min(1),
     content: z.string().min(1),
 });
+export const upsertPlansSupportFileInput = z.object({
+    /** Path relative to mapped plans root (e.g. knowledge/workflow_plans/run-qa/<ulid>.plan.md). */
+    filePath: z.string().min(1),
+    content: z.string().min(1),
+});
 export const listWorkflowCatalogInput = z.object({});

package/dist/core/tools.js

@@ -69,6 +69,8 @@ function listExecutionBody(args) {
         body.branchName = args.branchName.trim();
     if (args.scenarioId != null && args.scenarioId.trim() !== "")
         body.scenarioId = args.scenarioId.trim();
+    if (args.testId != null && args.testId.trim() !== "")
+        body.testId = args.testId.trim();
     const dimensionFilters = [...(args.dimensionFilters ?? [])];
     if (args.platform != null) {
         const hasPlatformFilter = dimensionFilters.some((f) => f.dimension === "PLATFORM_EXECUTION_JOB_FILTER_DIMENSION");
@@ -139,7 +141,8 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "get-execution-history",
-        description: "Fetch SmartTest execution history for an optional platform-rooted folder scope, or for a scenario when scenarioId is set. " +
+        description: "Fetch SmartTest execution history for a testId (top 5 recent runs), an optional platform-rooted folder/file scope, or a scenario when scenarioId is set. " +
+            "Prefer testId when you have it from fetch-execution-report. Typically omit environment to avoid env scoping. " +
             "Use branchName and scope.filePaths as for coverage. Optional platform (web|ios|android) and dimensionFilters narrow results.",
         inputSchema: S.listExecutionInput,
         execute: async (args, { postMcp }) => {
@@ -975,6 +978,21 @@ export const TOOL_DEFINITIONS = [
             });
         },
     },
+    {
+        kebab: "upsert-plans-support-file",
+        description: "Create or update any file under the mapped plans root on the platform by relative path (no git commit/push required). " +
+            "Primary use: upload workflow execution plans at knowledge/workflow_plans/<workflow-id>/<workflow_execution_id>.plan.md after the Plan phase. " +
+            "filePath is relative to the plans mapped root (leading plans/ is stripped). Under workflow_plans/, filenames are coerced to *.plan.md and stored as WORKFLOW_EXECUTION_PLAN. " +
+            "Response includes supportFileId, filePath (canonical), filetype, created. Blocking step before Execute for cloud agents.",
+        inputSchema: S.upsertPlansSupportFileInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/upsert_plans_support_file", {
+                filePath: a.filePath,
+                content: a.content,
+            });
+        },
+    },
     {
         kebab: "list-workflow-catalog",
         description: "List supported TestChimp workflows with Active / Disabled / Missing Config status for the project.",

package/package.json

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