@testchimp/cli 0.1.8 → 0.1.9

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)

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>;

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(),

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). " +

package/package.json

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