@testchimp/cli 0.1.4 → 0.1.6

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);
@@ -157,6 +166,30 @@ export function buildCliProgram() {
         const out = await runTool("update-user-story", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("mark-plan-items-implementation-done")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "mark-plan-items-implementation-done").description)
+        .addOption(jsonInputOption())
+        .option("--scenario-ordinal-ids <csv>", "comma-separated TS-<n> numeric ids")
+        .option("--user-story-ordinal-ids <csv>", "comma-separated US-<n> numeric ids")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.scenarioOrdinalIds) {
+            body.scenarioOrdinalIds = String(opts.scenarioOrdinalIds)
+                .split(",")
+                .map((s) => Number(s.trim()))
+                .filter((n) => Number.isFinite(n) && n > 0);
+        }
+        if (opts.userStoryOrdinalIds) {
+            body.userStoryOrdinalIds = String(opts.userStoryOrdinalIds)
+                .split(",")
+                .map((s) => Number(s.trim()))
+                .filter((n) => Number.isFinite(n) && n > 0);
+        }
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("mark-plan-items-implementation-done", merged, { postMcp });
+        console.log(out);
+    });
     program
         .command("update-test-scenario")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-test-scenario").description)

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>;
@@ -39,6 +60,10 @@ export declare const createTestScenarioInput: z.ZodObject<{
 export declare const updatePlanMarkdownInput: z.ZodObject<{
     content: z.ZodString;
 }, z.core.$strip>;
+export declare const markPlanItemsImplementationDoneInput: z.ZodObject<{
+    scenarioOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+    userStoryOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>;
 export declare const emptyInput: z.ZodObject<{}, z.core.$strip>;
 export declare const getBranchSpecificEndpointConfigInput: z.ZodObject<{
     branchName: 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({
@@ -46,6 +57,10 @@ export const createTestScenarioInput = z.object({
 export const updatePlanMarkdownInput = z.object({
     content: z.string().min(1),
 });
+export const markPlanItemsImplementationDoneInput = z.object({
+    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).optional(),
+    userStoryOrdinalIds: z.array(z.coerce.number().int().positive()).optional(),
+});
 export const emptyInput = z.object({});
 export const getBranchSpecificEndpointConfigInput = z.object({
     branchName: z.string().optional(),

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,13 +40,33 @@ 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 = [
     {
         kebab: "get-requirement-coverage",
         description: "Fetch requirement (scenario) coverage under an optional platform-rooted folder scope (tests/... or plans/...). " +
-            "Use branchName (Git branch) and scope.filePaths (paths under platform tests root) rather than internal ids.",
+            "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. 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));
@@ -43,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));
@@ -97,7 +129,8 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "update-user-story",
         description: "Sync a user story markdown file to the platform after local edits. " +
-            "Parses frontmatter (id: US-..., title, priority, status) and updates the linked support file and entity.",
+            "Parses frontmatter (id: US-..., title, priority) and updates the linked support file and entity. " +
+            "Implementation status is not stored in markdown; use mark-plan-items-implementation-done.",
         inputSchema: S.updatePlanMarkdownInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -107,13 +140,29 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "update-test-scenario",
         description: "Sync a test scenario markdown file to the platform after local edits. " +
-            "Parses frontmatter (id: TS-..., story: US-..., title, priority, status) and updates linking if story changes.",
+            "Parses frontmatter (id: TS-..., story: US-..., title, priority) and updates linking if story changes. " +
+            "Implementation status is not stored in markdown; use mark-plan-items-implementation-done.",
         inputSchema: S.updatePlanMarkdownInput,
         execute: async (args, { postMcp }) => {
             const a = args;
             return postMcp("/api/mcp/update_test_scenario", { content: a.content });
         },
     },
+    {
+        kebab: "mark-plan-items-implementation-done",
+        description: "Mark user stories and/or test scenarios implementation-complete in platform lifecycle (DB only; does not rewrite plan markdown). " +
+            "Use scenarioOrdinalIds / userStoryOrdinalIds (numeric parts of TS-<n> / US-<n>).",
+        inputSchema: S.markPlanItemsImplementationDoneInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.scenarioOrdinalIds?.length)
+                body.scenarioOrdinalIds = a.scenarioOrdinalIds;
+            if (a.userStoryOrdinalIds?.length)
+                body.userStoryOrdinalIds = a.userStoryOrdinalIds;
+            return postMcp("/api/mcp/mark_plan_items_implementation_done", body);
+        },
+    },
     {
         kebab: "get-eaas-config",
         description: "Return the project's BunnyShell (Environment-as-a-Service) settings. Secrets are never returned.",

package/package.json

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