@testchimp/cli 0.1.25 → 0.1.27

package/dist/cli/program.js

@@ -284,15 +284,33 @@ export function buildCliProgram() {
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-test-scenarios").description)
         .addOption(jsonInputOption())
         .option("--scenario-ordinal-ids <csv>", "comma-separated TS-<n> numeric ids")
+        .option("--external-ids <csv>", "comma-separated external TMS ids (e.g. C12345,PROJ-101); server matches exact then numerical part")
         .action(async (opts) => {
         const body = {};
         if (opts.scenarioOrdinalIds) {
-            body.scenarioOrdinalIds = String(opts.scenarioOrdinalIds)
+            const ids = String(opts.scenarioOrdinalIds)
                 .split(",")
                 .map((s) => Number(s.trim()))
                 .filter((n) => Number.isFinite(n) && n > 0);
+            if (ids.length > 0)
+                body.scenarioOrdinalIds = ids;
+        }
+        if (opts.externalIds) {
+            const ids = String(opts.externalIds)
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+            if (ids.length > 0)
+                body.externalIds = ids;
         }
         const merged = mergeBodies(body, opts.jsonInput);
+        // Drop empty arrays so refine / merge with json-input does not fail misleadingly.
+        if (Array.isArray(merged.scenarioOrdinalIds) && merged.scenarioOrdinalIds.length === 0) {
+            delete merged.scenarioOrdinalIds;
+        }
+        if (Array.isArray(merged.externalIds) && merged.externalIds.length === 0) {
+            delete merged.externalIds;
+        }
         const out = await runTool("get-test-scenarios", merged, { postMcp });
         console.log(out);
     });
@@ -918,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

@@ -226,7 +226,8 @@ 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>>;
+    scenarioOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
+    externalIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const getManualSessionDetailsInput: z.ZodObject<{
     manualSessionId: z.ZodString;
@@ -923,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";
@@ -1233,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<{
@@ -1294,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

@@ -111,8 +111,12 @@ export const getUserStoriesInput = z
 });
 export const getTestScenariosInput = z
     .object({
-    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).min(1),
-});
+    scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).min(1).optional(),
+    /** Full TMS external ids (e.g. C12345, PROJ-101). Server matches exact then numerical part. */
+    externalIds: z.array(z.string().min(1)).min(1).optional(),
+})
+    .refine((v) => (v.scenarioOrdinalIds != null && v.scenarioOrdinalIds.length > 0) ||
+    (v.externalIds != null && v.externalIds.length > 0), { message: "Provide scenarioOrdinalIds and/or externalIds (non-empty)" });
 export const getManualSessionDetailsInput = z.object({
     manualSessionId: z.string().min(1),
 });
@@ -413,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

@@ -258,15 +258,20 @@ export const TOOL_DEFINITIONS = [
     },
     {
         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.",
+        description: "Fetch test scenarios from the TestChimp platform by ordinal id (numeric part of TS-<n>) " +
+            "and/or external TMS ids (e.g. C12345, PROJ-101 — server strips prefixes and matches numerical part). " +
+            "Returns full plan markdown content, title, platform file path, linked user story ordinal ids, " +
+            "and external_source / external_system_id when present. " +
+            "Use when plan files are not yet synced to the repo, or when linking imported tests to scenarios by TMS id.",
         inputSchema: S.getTestScenariosInput,
         execute: async (args, { postMcp }) => {
             const a = args;
-            return postMcp("/api/mcp/get_test_scenarios", {
-                scenarioOrdinalIds: a.scenarioOrdinalIds,
-            });
+            const body = {};
+            if (a.scenarioOrdinalIds?.length)
+                body.scenarioOrdinalIds = a.scenarioOrdinalIds;
+            if (a.externalIds?.length)
+                body.externalIds = a.externalIds;
+            return postMcp("/api/mcp/get_test_scenarios", body);
         },
     },
     {
@@ -323,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.",
@@ -778,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.25",
+  "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",