@testchimp/cli 0.1.8 → 0.1.10

package/dist/cli/program.js

@@ -197,6 +197,54 @@ export function buildCliProgram() {
         const out = await runTool("update-user-story", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("get-user-stories")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-user-stories").description)
+        .addOption(jsonInputOption())
+        .option("--user-story-ordinal-ids <csv>", "comma-separated US-<n> numeric ids")
+        .action(async (opts) => {
+        const body = {};
+        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("get-user-stories", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("get-test-scenarios")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-test-scenarios").description)
+        .addOption(jsonInputOption())
+        .option("--scenario-ordinal-ids <csv>", "comma-separated TS-<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);
+        }
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("get-test-scenarios", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("get-manual-session-details")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-manual-session-details").description)
+        .addOption(jsonInputOption())
+        .option("--manual-session-id <id>", "manual test session id (same as job id in the viewer URL)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.manualSessionId) {
+            body.manualSessionId = String(opts.manualSessionId).trim();
+        }
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("get-manual-session-details", 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)
@@ -460,6 +508,31 @@ export function buildCliProgram() {
         const out = await runTool("upsert-screen-states", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("list-semantic-similar-tests")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-semantic-similar-tests").description)
+        .addOption(jsonInputOption())
+        .option("--folder-path <path>", "folder under tests root, slash-separated")
+        .action(async (opts) => {
+        const body = {};
+        const scope = {};
+        if (opts.folderPath)
+            scope.folderPath = opts.folderPath;
+        if (Object.keys(scope).length)
+            body.scope = scope;
+        const merged = mergeBodies(body, opts.jsonInput);
+        const out = await runTool("list-semantic-similar-tests", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("mark-semantic-tests-distinct")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "mark-semantic-tests-distinct").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("mark-semantic-tests-distinct", merged, { postMcp });
+        console.log(out);
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/schemas.d.ts

@@ -70,6 +70,15 @@ 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 getUserStoriesInput: z.ZodObject<{
+    userStoryOrdinalIds: z.ZodArray<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const getTestScenariosInput: z.ZodObject<{
+    scenarioOrdinalIds: z.ZodArray<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const getManualSessionDetailsInput: z.ZodObject<{
+    manualSessionId: z.ZodString;
+}, z.core.$strip>;
 export declare const emptyInput: z.ZodObject<{}, z.core.$strip>;
 export declare const getBranchSpecificEndpointConfigInput: z.ZodObject<{
     branchName: z.ZodOptional<z.ZodString>;
@@ -114,3 +123,29 @@ export declare const upsertScreenStatesInput: z.ZodObject<{
         states: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const testLocatorSchema: z.ZodObject<{
+    folderPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fileName: z.ZodString;
+    testSuite: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    testName: z.ZodString;
+}, z.core.$strip>;
+export declare const listSemanticSimilarTestsInput: z.ZodObject<{
+    scope: 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>>;
+}, z.core.$strip>;
+export declare const markSemanticTestsDistinctInput: z.ZodObject<{
+    focusTest: z.ZodObject<{
+        folderPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fileName: z.ZodString;
+        testSuite: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        testName: z.ZodString;
+    }, z.core.$strip>;
+    distinctTest: z.ZodObject<{
+        folderPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fileName: z.ZodString;
+        testSuite: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        testName: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/core/schemas.js

@@ -69,6 +69,17 @@ 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 getUserStoriesInput = z
+    .object({
+    userStoryOrdinalIds: z.array(z.coerce.number().int().positive()).min(1),
+});
+export const getTestScenariosInput = z
+    .object({
+    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).min(1),
+});
+export const getManualSessionDetailsInput = z.object({
+    manualSessionId: z.string().min(1),
+});
 export const emptyInput = z.object({});
 export const getBranchSpecificEndpointConfigInput = z.object({
     branchName: z.string().optional(),
@@ -114,3 +125,16 @@ const screenStatesEntrySchema = z.object({
 export const upsertScreenStatesInput = z.object({
     screenStates: z.array(screenStatesEntrySchema).min(1),
 });
+export const testLocatorSchema = z.object({
+    folderPath: z.array(z.string()).optional(),
+    fileName: z.string().min(1),
+    testSuite: z.array(z.string()).optional(),
+    testName: z.string().min(1),
+});
+export const listSemanticSimilarTestsInput = z.object({
+    scope: scopeSchema,
+});
+export const markSemanticTestsDistinctInput = z.object({
+    focusTest: testLocatorSchema,
+    distinctTest: testLocatorSchema,
+});

package/dist/core/tools.js

@@ -159,6 +159,45 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/update_test_scenario", { content: a.content });
         },
     },
+    {
+        kebab: "get-user-stories",
+        description: "Fetch user stories from the TestChimp platform by ordinal id (numeric part of US-<n>). " +
+            "Returns full plan markdown content, title, and platform file path for each found story. " +
+            "Use when plan files are not yet synced to the repo.",
+        inputSchema: S.getUserStoriesInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/get_user_stories", {
+                userStoryOrdinalIds: a.userStoryOrdinalIds,
+            });
+        },
+    },
+    {
+        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.",
+        inputSchema: S.getTestScenariosInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/get_test_scenarios", {
+                scenarioOrdinalIds: a.scenarioOrdinalIds,
+            });
+        },
+    },
+    {
+        kebab: "get-manual-session-details",
+        description: "Fetch a manual test session by id. Returns project id, title, environment, steps " +
+            "(playwright commands, signed screenshot URLs, notes), and linked scenario ordinal ids. " +
+            "Use when authoring a SmartTest from a recorded manual session.",
+        inputSchema: S.getManualSessionDetailsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/get_manual_session_details", {
+                manualSessionId: a.manualSessionId,
+            });
+        },
+    },
     {
         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). " +
@@ -357,6 +396,32 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/upsert_screen_states", { screenStates: a.screenStates });
         },
     },
+    {
+        kebab: "list-semantic-similar-tests",
+        description: "List semantically similar SmartTest pairs in scope using TestLocators (no test_id). " +
+            "Pairs are deduped (A→B only when A.testId < B.testId). Distinct-marked pairs are excluded.",
+        inputSchema: S.listSemanticSimilarTestsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.scope != null)
+                body.scope = normalizeScope(a.scope);
+            return postMcp("/api/mcp/list_semantic_similar_tests", body);
+        },
+    },
+    {
+        kebab: "mark-semantic-tests-distinct",
+        description: "Mark two SmartTests as legitimately distinct (symmetric) using TestLocators. " +
+            "Agent/API calls use marked_by_user_id = 0.",
+        inputSchema: S.markSemanticTestsDistinctInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/mark_semantic_tests_distinct", {
+                focusTest: a.focusTest,
+                distinctTest: a.distinctTest,
+            });
+        },
+    },
 ];
 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.8",
+  "version": "0.1.10",
   "description": "TestChimp CLI and MCP server — coverage, plans, EaaS, TrueCoverage (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",