@testchimp/cli 0.1.3 → 0.1.5

package/README.md

@@ -40,6 +40,8 @@ export TESTCHIMP_API_KEY=...   # required (often read from project MCP env; neve
 testchimp --help
 testchimp get-requirement-coverage --branch-name main --help
 testchimp create-user-story --platform-file-path plans/stories/foo.md --title "Checkout"
+testchimp list-screen-states --json-input '{}'
+testchimp upsert-screen-states --json-input '{"screenStates":[{"screen":"Checkout","states":["empty","filled"]}]}'
 ```
 
 - **stdout:** API response JSON.

package/dist/cli/program.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-export declare const PACKAGE_VERSION = "0.1.1";
+export declare const PACKAGE_VERSION = "0.1.4";
 export declare function buildCliProgram(): Command;

package/dist/cli/program.js

@@ -5,7 +5,7 @@ import { DEFAULT_BACKEND, postMcp } from "../core/client.js";
 import { deepMerge } from "../core/merge.js";
 import { runTool } from "../core/tools.js";
 import { TOOL_DEFINITIONS } from "../core/tools.js";
-export const PACKAGE_VERSION = "0.1.1";
+export const PACKAGE_VERSION = "0.1.4";
 function parseJsonInput(raw) {
     if (raw == null || raw.trim() === "")
         return {};
@@ -157,6 +157,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)
@@ -374,6 +398,28 @@ export function buildCliProgram() {
         const out = await runTool("get-truecoverage-event-metadata-keys", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("list-screen-states")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-screen-states").description)
+        .addOption(jsonInputOption())
+        .option("--environment <s>", "optional environment tag (forward compatibility)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.environment)
+            body.environment = String(opts.environment);
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("list-screen-states", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("upsert-screen-states")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "upsert-screen-states").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("upsert-screen-states", merged, { postMcp });
+        console.log(out);
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/schemas.d.ts

@@ -39,6 +39,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

@@ -46,6 +46,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

@@ -34,7 +34,9 @@ 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.",
         inputSchema: S.listCoverageInput,
         execute: async (args, { postMcp }) => {
             const json = await postMcp("/api/mcp/list_requirement_coverage", listCoverageBody(args));
@@ -97,7 +99,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 +110,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/dist/mcp/server.js

@@ -2,7 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { postMcp } from "../core/client.js";
 import { TOOL_DEFINITIONS, runTool } from "../core/tools.js";
-const PACKAGE_VERSION = "0.1.0";
+const PACKAGE_VERSION = "0.1.4";
 function textResult(json) {
     return {
         content: [{ type: "text", text: json }],

package/package.json

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