@testchimp/cli 0.1.27 → 0.1.28

package/dist/cli/program.js

@@ -1134,6 +1134,68 @@ export function buildCliProgram() {
         }
         console.log(await runTool("upsert-plans-support-file", merged, { postMcp }));
     });
+    program
+        .command("list-api-operation-services")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-api-operation-services").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        console.log(await runTool("list-api-operation-services", merged, { postMcp }));
+    });
+    program
+        .command("list-api-operations")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-api-operations").description)
+        .addOption(jsonInputOption())
+        .option("--root-file-path <path>", "Repo-relative OpenAPI root path (preferred service resource id)")
+        .option("--service-key <key>", "Internal service key alias")
+        .option("--include-manual", "Include MANUAL test_mode coverage in previews")
+        .option("--include-removed", "Include soft-deleted (REMOVED) operations")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.rootFilePath)
+            body.rootFilePath = String(opts.rootFilePath);
+        if (opts.serviceKey)
+            body.serviceKey = String(opts.serviceKey);
+        if (opts.includeManual)
+            body.includeManual = true;
+        if (opts.includeRemoved)
+            body.includeRemoved = true;
+        const merged = mergeBodies(body, opts.jsonInput);
+        console.log(await runTool("list-api-operations", merged, { postMcp }));
+    });
+    program
+        .command("get-api-operation-detail")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-api-operation-detail").description)
+        .addOption(jsonInputOption())
+        .option("--id <ulid>", "TestChimp operation id (ULID PK) — preferred")
+        .option("--root-file-path <path>", "Repo-relative OpenAPI root path")
+        .option("--service-key <key>", "Internal service key")
+        .option("--oas-operation-id <id>", "OpenAPI operationId")
+        .option("--http-method <method>", "HTTP method (with --path-template)")
+        .option("--path-template <path>", "OpenAPI path template (with --http-method)")
+        .option("--include-manual", "Include MANUAL test_mode coverage")
+        .option("--include-removed", "Include soft-deleted schema fields / response codes")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.id)
+            body.id = String(opts.id);
+        if (opts.rootFilePath)
+            body.rootFilePath = String(opts.rootFilePath);
+        if (opts.serviceKey)
+            body.serviceKey = String(opts.serviceKey);
+        if (opts.oasOperationId)
+            body.oasOperationId = String(opts.oasOperationId);
+        if (opts.httpMethod)
+            body.httpMethod = String(opts.httpMethod);
+        if (opts.pathTemplate)
+            body.pathTemplate = String(opts.pathTemplate);
+        if (opts.includeManual)
+            body.includeManual = true;
+        if (opts.includeRemoved)
+            body.includeRemoved = true;
+        const merged = mergeBodies(body, opts.jsonInput);
+        console.log(await runTool("get-api-operation-detail", merged, { postMcp }));
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/schemas.d.ts

@@ -1415,3 +1415,21 @@ export declare const upsertPlansSupportFileInput: z.ZodObject<{
     content: z.ZodString;
 }, z.core.$strip>;
 export declare const listWorkflowCatalogInput: z.ZodObject<{}, z.core.$strip>;
+/** API operation coverage (OpenAPI ops + denorm coverage) — CLI ≥ 0.1.28 */
+export declare const listApiOperationServicesInput: z.ZodObject<{}, z.core.$strip>;
+export declare const listApiOperationsInput: z.ZodObject<{
+    rootFilePath: z.ZodOptional<z.ZodString>;
+    serviceKey: z.ZodOptional<z.ZodString>;
+    includeManual: z.ZodOptional<z.ZodBoolean>;
+    includeRemoved: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const getApiOperationDetailInput: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    rootFilePath: z.ZodOptional<z.ZodString>;
+    serviceKey: z.ZodOptional<z.ZodString>;
+    oasOperationId: z.ZodOptional<z.ZodString>;
+    httpMethod: z.ZodOptional<z.ZodString>;
+    pathTemplate: z.ZodOptional<z.ZodString>;
+    includeManual: z.ZodOptional<z.ZodBoolean>;
+    includeRemoved: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;

package/dist/core/schemas.js

@@ -770,3 +770,47 @@ export const upsertPlansSupportFileInput = z.object({
     content: z.string().min(1),
 });
 export const listWorkflowCatalogInput = z.object({});
+/** API operation coverage (OpenAPI ops + denorm coverage) — CLI ≥ 0.1.28 */
+export const listApiOperationServicesInput = z.object({});
+export const listApiOperationsInput = z.object({
+    /** Preferred: repo-relative OpenAPI root path. */
+    rootFilePath: z.string().optional(),
+    /** Alias for rootFilePath resolution; internal service key. */
+    serviceKey: z.string().optional(),
+    includeManual: z.boolean().optional(),
+    includeRemoved: z.boolean().optional(),
+});
+export const getApiOperationDetailInput = z
+    .object({
+    /** TestChimp operation id (ULID PK). Preferred. */
+    id: z.string().optional(),
+    rootFilePath: z.string().optional(),
+    serviceKey: z.string().optional(),
+    oasOperationId: z.string().optional(),
+    httpMethod: z.string().optional(),
+    pathTemplate: z.string().optional(),
+    includeManual: z.boolean().optional(),
+    includeRemoved: z.boolean().optional(),
+})
+    .superRefine((v, ctx) => {
+    const id = v.id?.trim();
+    const root = v.rootFilePath?.trim();
+    const service = v.serviceKey?.trim();
+    const oas = v.oasOperationId?.trim();
+    const method = v.httpMethod?.trim();
+    const path = v.pathTemplate?.trim();
+    const hasService = !!(root || service);
+    if (id)
+        return;
+    if (oas && hasService)
+        return;
+    if (method && path && hasService)
+        return;
+    if (oas && !hasService)
+        return; // server allows project-wide oas fallback
+    ctx.addIssue({
+        code: "custom",
+        message: "Provide --id (TestChimp operation ULID), or --root-file-path/--service-key with --oas-operation-id, " +
+            "or --root-file-path/--service-key with --http-method and --path-template",
+    });
+});

package/dist/core/tools.js

@@ -1075,6 +1075,60 @@ export const TOOL_DEFINITIONS = [
         inputSchema: S.listWorkflowCatalogInput,
         execute: async (_args, { postMcp }) => postMcp("/api/mcp/list_workflow_catalog", {}),
     },
+    {
+        kebab: "list-api-operation-services",
+        description: "List API operation service resources for the project (configured OpenAPI root file paths + operation counts). " +
+            "Use rootFilePath as the service resource id for list-api-operations / get-api-operation-detail.",
+        inputSchema: S.listApiOperationServicesInput,
+        execute: async (_args, { postMcp }) => postMcp("/api/mcp/list_api_operation_services", {}),
+    },
+    {
+        kebab: "list-api-operations",
+        description: "List API operations for a service resource with covering-test previews and coverageSummary scores " +
+            "(same payload as the Operations list UI). Prefer --root-file-path (repo-relative OpenAPI root).",
+        inputSchema: S.listApiOperationsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.rootFilePath != null && a.rootFilePath.trim() !== "")
+                body.rootFilePath = a.rootFilePath.trim();
+            if (a.serviceKey != null && a.serviceKey.trim() !== "")
+                body.serviceKey = a.serviceKey.trim();
+            if (a.includeManual != null)
+                body.includeManual = a.includeManual;
+            if (a.includeRemoved != null)
+                body.includeRemoved = a.includeRemoved;
+            return postMcp("/api/mcp/list_api_operations", body);
+        },
+    },
+    {
+        kebab: "get-api-operation-detail",
+        description: "Fetch detailed API operation coverage (request/query/response fields, response codes, covering tests) — " +
+            "same payload as the Operation detail UI. Prefer TestChimp operation id (--id ULID); " +
+            "or rootFilePath + oasOperationId; or rootFilePath + httpMethod + pathTemplate.",
+        inputSchema: S.getApiOperationDetailInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {};
+            if (a.id != null && a.id.trim() !== "")
+                body.id = a.id.trim();
+            if (a.rootFilePath != null && a.rootFilePath.trim() !== "")
+                body.rootFilePath = a.rootFilePath.trim();
+            if (a.serviceKey != null && a.serviceKey.trim() !== "")
+                body.serviceKey = a.serviceKey.trim();
+            if (a.oasOperationId != null && a.oasOperationId.trim() !== "")
+                body.oasOperationId = a.oasOperationId.trim();
+            if (a.httpMethod != null && a.httpMethod.trim() !== "")
+                body.httpMethod = a.httpMethod.trim();
+            if (a.pathTemplate != null && a.pathTemplate.trim() !== "")
+                body.pathTemplate = a.pathTemplate.trim();
+            if (a.includeManual != null)
+                body.includeManual = a.includeManual;
+            if (a.includeRemoved != null)
+                body.includeRemoved = a.includeRemoved;
+            return postMcp("/api/mcp/get_api_operation_detail", body);
+        },
+    },
 ];
 const TOOL_BY_KEBAB = new Map(TOOL_DEFINITIONS.map((t) => [t.kebab, t]));
 export function getToolDefinition(kebab) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@testchimp/cli",
-  "version": "0.1.27",
-  "description": "TestChimp CLI and MCP server \u2014 coverage, plans, EaaS, TrueCoverage (calls /api/mcp/*)",
+  "version": "0.1.28",
+  "description": "TestChimp CLI and MCP server \u2014 coverage, plans, EaaS, TrueCoverage, API operations (calls /api/mcp/*)",
   "type": "module",
   "main": "dist/bin/testchimp.js",
   "types": "dist/bin/testchimp.d.ts",