@testchimp/cli 0.1.7 → 0.1.9

package/dist/cli/program.d.ts

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

package/dist/cli/program.js

@@ -5,7 +5,26 @@ 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.4";
+export const PACKAGE_VERSION = "0.1.7";
+function parseRecordTypesCsv(raw) {
+    return String(raw)
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((s) => s.toLowerCase())
+        .map((s) => {
+        if (s === "automated")
+            return "smart_test";
+        if (s === "smarttest")
+            return "smart_test";
+        if (s === "smart_test")
+            return "smart_test";
+        if (s === "manual")
+            return "manual";
+        return s;
+    })
+        .filter((v) => v === "smart_test" || v === "manual");
+}
 function parseJsonInput(raw) {
     if (raw == null || raw.trim() === "")
         return {};
@@ -47,6 +66,9 @@ export function buildCliProgram() {
         .option("--environment <s>")
         .option("--branch-name <s>")
         .option("--platform <web|ios|android>")
+        .option("--record-types <csv>", "coverage sources: smart_test,manual (aliases: automated,smarttest)")
+        .option("--include-manual", "include manual sessions in addition to automated (default)")
+        .option("--manual-only", "manual-only coverage (no automated)")
         .option("--file-paths <csv>", "comma-separated paths under platform tests root")
         .option("--folder-path <path>", "folder under tests root, slash-separated")
         .action(async (opts) => {
@@ -59,6 +81,15 @@ export function buildCliProgram() {
             body.branchName = opts.branchName;
         if (opts.platform)
             body.platform = opts.platform;
+        let recordTypes;
+        if (opts.recordTypes)
+            recordTypes = parseRecordTypesCsv(String(opts.recordTypes));
+        if (opts.includeManual)
+            recordTypes = Array.from(new Set([...(recordTypes ?? ["smart_test"]), "manual"]));
+        if (opts.manualOnly)
+            recordTypes = ["manual"];
+        if (recordTypes && recordTypes.length > 0)
+            body.recordTypes = recordTypes;
         const scope = {};
         if (opts.filePaths)
             scope.filePaths = String(opts.filePaths).split(",").map((s) => s.trim()).filter(Boolean);
@@ -166,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

@@ -22,6 +22,12 @@ export declare const listCoverageInput: z.ZodObject<{
         ios: "ios";
         android: "android";
     }>>;
+    recordTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        smart_test: "smart_test";
+        manual: "manual";
+        SMART_TEST: "SMART_TEST";
+        MANUAL: "MANUAL";
+    }>>>;
 }, z.core.$strip>;
 export declare const listExecutionInput: z.ZodObject<{
     release: z.ZodOptional<z.ZodString>;
@@ -64,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

@@ -6,6 +6,7 @@ export const scopeSchema = z
 })
     .optional();
 const executionPlatformSchema = z.enum(["web", "ios", "android"]);
+const requirementCoverageRecordTypeSchema = z.enum(["smart_test", "manual", "SMART_TEST", "MANUAL"]);
 export const executionJobDimensionFilterSchema = z.object({
     dimension: z.string().min(1),
     values: z.array(z.string()).min(1),
@@ -18,6 +19,13 @@ export const listCoverageInput = z.object({
     includeNonCoveredTestScenarios: z.boolean().optional(),
     branchName: z.string().optional(),
     platform: executionPlatformSchema.optional(),
+    /**
+     * Which coverage sources to include.
+     *
+     * Omit for legacy default: SMART_TEST only.
+     * When provided, send proto enum names ("SMART_TEST", "MANUAL") or CLI-friendly aliases ("smart_test", "manual").
+     */
+    recordTypes: z.array(requirementCoverageRecordTypeSchema).optional(),
 });
 export const listExecutionInput = z.object({
     release: z.string().optional(),
@@ -61,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

@@ -28,6 +28,17 @@ function listCoverageBody(args) {
         body.branchName = args.branchName.trim();
     if (args.platform != null)
         body.platform = platformToProtoEnum(args.platform);
+    if (args.recordTypes != null && args.recordTypes.length > 0) {
+        const normalized = args.recordTypes.map((t) => {
+            const raw = String(t).trim();
+            if (raw === "manual")
+                return "MANUAL";
+            if (raw === "smart_test")
+                return "SMART_TEST";
+            return raw;
+        });
+        body.recordTypes = normalized;
+    }
     return body;
 }
 function listExecutionBody(args) {
@@ -148,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/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.4";
+const PACKAGE_VERSION = "0.1.7";
 function textResult(json) {
     return {
         content: [{ type: "text", text: json }],

package/package.json

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