@testchimp/cli 0.1.26 → 0.1.27

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)

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

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. */

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

package/package.json

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