@testchimp/cli 0.1.26 → 0.1.28

package/dist/cli/program.js

@@ -936,6 +936,33 @@ export function buildCliProgram() {
         const out = await runTool("mark-semantic-tests-distinct", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("list-semantic-nearby")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "list-semantic-nearby").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("list-semantic-nearby", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("mark-entity-distinct")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "mark-entity-distinct").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("mark-entity-distinct", merged, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("unmark-entity-distinct")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "unmark-entity-distinct").description)
+        .addOption(jsonInputOption())
+        .action(async (opts) => {
+        const merged = mergeBodies({}, opts.jsonInput);
+        const out = await runTool("unmark-entity-distinct", merged, { postMcp });
+        console.log(out);
+    });
     program
         .command("get-requirement-quality-report")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-requirement-quality-report").description)
@@ -1107,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

@@ -924,6 +924,64 @@ export declare const markSemanticTestsDistinctInput: z.ZodObject<{
         testName: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
+/** LinkedEntityType names for semantic nearby (embedding-capable). */
+export declare const semanticNearbyEntityTypeSchema: z.ZodEnum<{
+    STORY: "STORY";
+    SCENARIO: "SCENARIO";
+    TEST: "TEST";
+    ISSUE: "ISSUE";
+    EVENT: "EVENT";
+}>;
+export declare const listSemanticNearbyInput: z.ZodObject<{
+    sourceEntityType: z.ZodEnum<{
+        STORY: "STORY";
+        SCENARIO: "SCENARIO";
+        TEST: "TEST";
+        ISSUE: "ISSUE";
+        EVENT: "EVENT";
+    }>;
+    sourceTest: z.ZodOptional<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>>;
+    sourceOrdinalId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    sourceEventTitle: z.ZodOptional<z.ZodString>;
+    targetEntityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        STORY: "STORY";
+        SCENARIO: "SCENARIO";
+        TEST: "TEST";
+        ISSUE: "ISSUE";
+        EVENT: "EVENT";
+    }>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const markEntityDistinctInput: z.ZodObject<{
+    entityType: z.ZodEnum<{
+        STORY: "STORY";
+        SCENARIO: "SCENARIO";
+        TEST: "TEST";
+        ISSUE: "ISSUE";
+        EVENT: "EVENT";
+    }>;
+    focusTest: z.ZodOptional<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>>;
+    otherTest: z.ZodOptional<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>>;
+    focusOrdinalId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    otherOrdinalId: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    focusEventTitle: z.ZodOptional<z.ZodString>;
+    otherEventTitle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /** RequirementSubjectType — proto enum names (JsonFormat camelCase on wire). */
 export declare const requirementSubjectTypeSchema: z.ZodEnum<{
     STORY: "STORY";
@@ -1234,11 +1292,11 @@ export declare const agentActionEntityTypeSchema: z.ZodEnum<{
     SCENARIO: "SCENARIO";
     ISSUE: "ISSUE";
     TEST_EXECUTION: "TEST_EXECUTION";
+    EVENT: "EVENT";
     USER_STORY: "USER_STORY";
     POLICY: "POLICY";
     TEST_INVOCATION_BATCH: "TEST_INVOCATION_BATCH";
     EXPLORATION: "EXPLORATION";
-    EVENT: "EVENT";
     WORKFLOW: "WORKFLOW";
 }>;
 export declare const agentActionTypeSchema: z.ZodEnum<{
@@ -1295,11 +1353,11 @@ export declare const reportAgentActionInput: z.ZodObject<{
         SCENARIO: "SCENARIO";
         ISSUE: "ISSUE";
         TEST_EXECUTION: "TEST_EXECUTION";
+        EVENT: "EVENT";
         USER_STORY: "USER_STORY";
         POLICY: "POLICY";
         TEST_INVOCATION_BATCH: "TEST_INVOCATION_BATCH";
         EXPLORATION: "EXPLORATION";
-        EVENT: "EVENT";
         WORKFLOW: "WORKFLOW";
     }>;
     entityIdentity: z.ZodOptional<z.ZodString>;
@@ -1357,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

@@ -417,6 +417,83 @@ export const markSemanticTestsDistinctInput = z.object({
     focusTest: testLocatorSchema,
     distinctTest: testLocatorSchema,
 });
+/** LinkedEntityType names for semantic nearby (embedding-capable). */
+export const semanticNearbyEntityTypeSchema = z.enum([
+    "STORY",
+    "SCENARIO",
+    "TEST",
+    "ISSUE",
+    "EVENT",
+]);
+export const listSemanticNearbyInput = z
+    .object({
+    sourceEntityType: semanticNearbyEntityTypeSchema,
+    sourceTest: testLocatorSchema.optional(),
+    sourceOrdinalId: z.union([z.number(), z.string()]).optional(),
+    sourceEventTitle: z.string().optional(),
+    targetEntityTypes: z.array(semanticNearbyEntityTypeSchema).optional(),
+    limit: z.number().int().positive().optional(),
+})
+    .superRefine((val, ctx) => {
+    if (val.sourceEntityType === "TEST" && !val.sourceTest) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "TEST requires sourceTest (TestLocator)",
+            path: ["sourceTest"],
+        });
+    }
+    if ((val.sourceEntityType === "STORY" ||
+        val.sourceEntityType === "SCENARIO" ||
+        val.sourceEntityType === "ISSUE") &&
+        (val.sourceOrdinalId == null || String(val.sourceOrdinalId).trim() === "")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${val.sourceEntityType} requires sourceOrdinalId`,
+            path: ["sourceOrdinalId"],
+        });
+    }
+    if (val.sourceEntityType === "EVENT" && !(val.sourceEventTitle ?? "").trim()) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "EVENT requires sourceEventTitle",
+            path: ["sourceEventTitle"],
+        });
+    }
+});
+export const markEntityDistinctInput = z
+    .object({
+    entityType: semanticNearbyEntityTypeSchema,
+    focusTest: testLocatorSchema.optional(),
+    otherTest: testLocatorSchema.optional(),
+    focusOrdinalId: z.union([z.number(), z.string()]).optional(),
+    otherOrdinalId: z.union([z.number(), z.string()]).optional(),
+    focusEventTitle: z.string().optional(),
+    otherEventTitle: z.string().optional(),
+})
+    .superRefine((val, ctx) => {
+    if (val.entityType === "TEST") {
+        if (!val.focusTest || !val.otherTest) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "TEST requires focusTest and otherTest",
+            });
+        }
+    }
+    else if (val.entityType === "EVENT") {
+        if (!(val.focusEventTitle ?? "").trim() || !(val.otherEventTitle ?? "").trim()) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "EVENT requires focusEventTitle and otherEventTitle",
+            });
+        }
+    }
+    else if (val.focusOrdinalId == null || val.otherOrdinalId == null) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${val.entityType} requires focusOrdinalId and otherOrdinalId`,
+        });
+    }
+});
 /** RequirementSubjectType — proto enum names (JsonFormat camelCase on wire). */
 export const requirementSubjectTypeSchema = z.enum(["STORY", "SCENARIO"]);
 /** RequirementFindingSeverity — proto enum names. */
@@ -693,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

@@ -328,6 +328,8 @@ export const TOOL_DEFINITIONS = [
             "Use simple fields for common creates, or pass the full curated contract via --json-input " +
             "(description, issueType, category, severity, status, reportedReleaseId, dueDateMillis, assignee, " +
             "linkTargets, labels, source, environment, attachments, artifactReference). " +
+            "For /testchimp implement TASK_ISSUE creates: set labels=[\"TestChimp Implement\"] (not source), " +
+            "severity from task priority, category (e.g. FUNCTIONAL), and linkTargets for STORY and/or SCENARIO ordinals. " +
             "Optional agentTraceability (or flat workflowId/policyFile/…) records CREATED Activity inline — " +
             "prefer this over a separate report-agent-action for issue creates. " +
             "Authenticated via project API key; project is resolved from the key.",
@@ -783,6 +785,75 @@ export const TOOL_DEFINITIONS = [
             });
         },
     },
+    {
+        kebab: "list-semantic-nearby",
+        description: "List semantically nearby entities across types (Story/Scenario/Test/Issue/Event). " +
+            "TEST uses TestLocator; STORY/SCENARIO/ISSUE use sourceOrdinalId; EVENT uses sourceEventTitle. " +
+            "Response TEST hits include TestLocator (never platform test_id).",
+        inputSchema: S.listSemanticNearbyInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {
+                sourceEntityType: a.sourceEntityType,
+            };
+            if (a.sourceTest)
+                body.sourceTest = a.sourceTest;
+            if (a.sourceOrdinalId != null)
+                body.sourceOrdinalId = Number(a.sourceOrdinalId);
+            if (a.sourceEventTitle)
+                body.sourceEventTitle = a.sourceEventTitle;
+            if (a.targetEntityTypes?.length)
+                body.targetEntityTypes = a.targetEntityTypes;
+            if (a.limit != null)
+                body.limit = a.limit;
+            return postMcp("/api/mcp/list_semantic_nearby", body);
+        },
+    },
+    {
+        kebab: "mark-entity-distinct",
+        description: "Mark two same-type entities as distinct. TEST uses TestLocators; " +
+            "STORY/SCENARIO/ISSUE use ordinals; EVENT uses titles.",
+        inputSchema: S.markEntityDistinctInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = { entityType: a.entityType };
+            if (a.focusTest)
+                body.focusTest = a.focusTest;
+            if (a.otherTest)
+                body.otherTest = a.otherTest;
+            if (a.focusOrdinalId != null)
+                body.focusOrdinalId = Number(a.focusOrdinalId);
+            if (a.otherOrdinalId != null)
+                body.otherOrdinalId = Number(a.otherOrdinalId);
+            if (a.focusEventTitle)
+                body.focusEventTitle = a.focusEventTitle;
+            if (a.otherEventTitle)
+                body.otherEventTitle = a.otherEventTitle;
+            return postMcp("/api/mcp/mark_entity_distinct", body);
+        },
+    },
+    {
+        kebab: "unmark-entity-distinct",
+        description: "Remove a distinct mark between two same-type entities (same identity rules as mark-entity-distinct).",
+        inputSchema: S.markEntityDistinctInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = { entityType: a.entityType };
+            if (a.focusTest)
+                body.focusTest = a.focusTest;
+            if (a.otherTest)
+                body.otherTest = a.otherTest;
+            if (a.focusOrdinalId != null)
+                body.focusOrdinalId = Number(a.focusOrdinalId);
+            if (a.otherOrdinalId != null)
+                body.otherOrdinalId = Number(a.otherOrdinalId);
+            if (a.focusEventTitle)
+                body.focusEventTitle = a.focusEventTitle;
+            if (a.otherEventTitle)
+                body.otherEventTitle = a.otherEventTitle;
+            return postMcp("/api/mcp/unmark_entity_distinct", body);
+        },
+    },
     {
         kebab: "get-requirement-quality-report",
         description: "Fetch the stored requirement quality report (metrics + findings with user states) for a user story or test scenario. " +
@@ -1004,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.26",
-  "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",