@testchimp/cli 0.1.23 → 0.1.26

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 = {};
@@ -281,15 +284,33 @@ export function buildCliProgram() {
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-test-scenarios").description)
         .addOption(jsonInputOption())
         .option("--scenario-ordinal-ids <csv>", "comma-separated TS-<n> numeric ids")
+        .option("--external-ids <csv>", "comma-separated external TMS ids (e.g. C12345,PROJ-101); server matches exact then numerical part")
         .action(async (opts) => {
         const body = {};
         if (opts.scenarioOrdinalIds) {
-            body.scenarioOrdinalIds = String(opts.scenarioOrdinalIds)
+            const ids = String(opts.scenarioOrdinalIds)
                 .split(",")
                 .map((s) => Number(s.trim()))
                 .filter((n) => Number.isFinite(n) && n > 0);
+            if (ids.length > 0)
+                body.scenarioOrdinalIds = ids;
+        }
+        if (opts.externalIds) {
+            const ids = String(opts.externalIds)
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+            if (ids.length > 0)
+                body.externalIds = ids;
         }
         const merged = mergeBodies(body, opts.jsonInput);
+        // Drop empty arrays so refine / merge with json-input does not fail misleadingly.
+        if (Array.isArray(merged.scenarioOrdinalIds) && merged.scenarioOrdinalIds.length === 0) {
+            delete merged.scenarioOrdinalIds;
+        }
+        if (Array.isArray(merged.externalIds) && merged.externalIds.length === 0) {
+            delete merged.externalIds;
+        }
         const out = await runTool("get-test-scenarios", merged, { postMcp });
         console.log(out);
     });
@@ -1064,6 +1085,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";
@@ -225,7 +226,8 @@ export declare const getUserStoriesInput: z.ZodObject<{
     userStoryOrdinalIds: z.ZodArray<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
 export declare const getTestScenariosInput: z.ZodObject<{
-    scenarioOrdinalIds: z.ZodArray<z.ZodCoercedNumber<unknown>>;
+    scenarioOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+    externalIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const getManualSessionDetailsInput: z.ZodObject<{
     manualSessionId: z.ZodString;
@@ -1350,4 +1352,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(),
@@ -110,8 +111,12 @@ export const getUserStoriesInput = z
 });
 export const getTestScenariosInput = z
     .object({
-    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).min(1),
-});
+    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).min(1).optional(),
+    /** Full TMS external ids (e.g. C12345, PROJ-101). Server matches exact then numerical part. */
+    externalIds: z.array(z.string().min(1)).min(1).optional(),
+})
+    .refine((v) => (v.scenarioOrdinalIds != null && v.scenarioOrdinalIds.length > 0) ||
+    (v.externalIds != null && v.externalIds.length > 0), { message: "Provide scenarioOrdinalIds and/or externalIds (non-empty)" });
 export const getManualSessionDetailsInput = z.object({
     manualSessionId: z.string().min(1),
 });
@@ -682,4 +687,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 }) => {
@@ -255,15 +258,20 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "get-test-scenarios",
-        description: "Fetch test scenarios from the TestChimp platform by ordinal id (numeric part of TS-<n>). " +
-            "Returns full plan markdown content, title, platform file path, and linked user story ordinal ids. " +
-            "Use when plan files are not yet synced to the repo.",
+        description: "Fetch test scenarios from the TestChimp platform by ordinal id (numeric part of TS-<n>) " +
+            "and/or external TMS ids (e.g. C12345, PROJ-101 — server strips prefixes and matches numerical part). " +
+            "Returns full plan markdown content, title, platform file path, linked user story ordinal ids, " +
+            "and external_source / external_system_id when present. " +
+            "Use when plan files are not yet synced to the repo, or when linking imported tests to scenarios by TMS id.",
         inputSchema: S.getTestScenariosInput,
         execute: async (args, { postMcp }) => {
             const a = args;
-            return postMcp("/api/mcp/get_test_scenarios", {
-                scenarioOrdinalIds: a.scenarioOrdinalIds,
-            });
+            const body = {};
+            if (a.scenarioOrdinalIds?.length)
+                body.scenarioOrdinalIds = a.scenarioOrdinalIds;
+            if (a.externalIds?.length)
+                body.externalIds = a.externalIds;
+            return postMcp("/api/mcp/get_test_scenarios", body);
         },
     },
     {
@@ -975,6 +983,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.26",
   "description": "TestChimp CLI and MCP server \u2014 coverage, plans, EaaS, TrueCoverage (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",