@testchimp/cli 0.1.16 → 0.1.18

package/dist/cli/program.js

@@ -316,6 +316,59 @@ export function buildCliProgram() {
         }, { postMcp });
         console.log(out);
     });
+    program
+        .command("create-issue")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "create-issue").description)
+        .addOption(jsonInputOption())
+        .option("--title <title>", "Issue title (required unless provided via --json-input)")
+        .option("--description <text>", "Issue description (markdown supported)")
+        .option("--issue-type <type>", "BUG_ISSUE | SUGGESTION_ISSUE | OBSERVATION_ISSUE | TASK_ISSUE")
+        .option("--category <category>", "FUNCTIONAL | SECURITY | ACCESSIBILITY | PERFORMANCE | VISUAL | …")
+        .option("--severity <severity>", "LOW_SEVERITY | MEDIUM_SEVERITY | HIGH_SEVERITY | CRITICAL_SEVERITY")
+        .option("--status <status>", "ACTIVE | IGNORED | FIXED | DUPLICATE | IN_PROGRESS_BUG | ARCHIVED_BUG | BLOCKED")
+        .option("--reported-release-id <id>", "Release label/id to attach to the issue")
+        .option("--due-date-millis <ms>", "Due date as UTC epoch millis")
+        .option("--assignee <userId>", "Assignee user id")
+        .option("--labels <csv>", "Comma-separated labels")
+        .option("--source <name>", "External ingest source identifier (stored as label source:<name>)")
+        .option("--environment <name>", "Environment tag (defaults to QA when omitted)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.title)
+            body.title = String(opts.title).trim();
+        if (opts.description)
+            body.description = String(opts.description);
+        if (opts.issueType)
+            body.issueType = String(opts.issueType).trim();
+        if (opts.category)
+            body.category = String(opts.category).trim();
+        if (opts.severity)
+            body.severity = String(opts.severity).trim();
+        if (opts.status)
+            body.status = String(opts.status).trim();
+        if (opts.reportedReleaseId)
+            body.reportedReleaseId = String(opts.reportedReleaseId).trim();
+        if (opts.dueDateMillis != null)
+            body.dueDateMillis = Number(opts.dueDateMillis);
+        if (opts.assignee)
+            body.assignee = String(opts.assignee).trim();
+        if (opts.labels) {
+            body.labels = String(opts.labels)
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        if (opts.source)
+            body.source = String(opts.source).trim();
+        if (opts.environment)
+            body.environment = String(opts.environment).trim();
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.title || String(merged.title).trim() === "") {
+            throw new Error("title is required (--title or --json-input {\"title\":\"...\"})");
+        }
+        const out = await runTool("create-issue", 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)
@@ -620,6 +673,22 @@ export function buildCliProgram() {
         const out = await runTool("get-release", { version: String(merged.version).trim() }, { postMcp });
         console.log(out);
     });
+    program
+        .command("get-release-details")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-release-details").description)
+        .addOption(jsonInputOption())
+        .option("--version <version>", "Release version / label (McpGetReleaseDetailsRequest.version)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.version)
+            body.version = String(opts.version);
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.version || String(merged.version).trim() === "") {
+            throw new Error("version is required (--version or --json-input {\"version\":\"...\"})");
+        }
+        const out = await runTool("get-release-details", { version: String(merged.version).trim() }, { postMcp });
+        console.log(out);
+    });
     program
         .command("get-security-scan-config")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-security-scan-config").description)

package/dist/core/schemas.d.ts

@@ -99,6 +99,72 @@ export declare const updateIssueStatusInput: z.ZodObject<{
         NOT_IMPORTANT: "NOT_IMPORTANT";
     }>>;
 }, z.core.$strip>;
+export declare const createIssueInput: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    issueType: z.ZodOptional<z.ZodEnum<{
+        BUG_ISSUE: "BUG_ISSUE";
+        SUGGESTION_ISSUE: "SUGGESTION_ISSUE";
+        OBSERVATION_ISSUE: "OBSERVATION_ISSUE";
+        TASK_ISSUE: "TASK_ISSUE";
+    }>>;
+    category: z.ZodOptional<z.ZodEnum<{
+        ACCESSIBILITY: "ACCESSIBILITY";
+        SECURITY: "SECURITY";
+        VISUAL: "VISUAL";
+        PERFORMANCE: "PERFORMANCE";
+        FUNCTIONAL: "FUNCTIONAL";
+        NETWORK: "NETWORK";
+        USABILITY: "USABILITY";
+        COMPATIBILITY: "COMPATIBILITY";
+        DATA_INTEGRITY: "DATA_INTEGRITY";
+        INTERACTION: "INTERACTION";
+        LOCALIZATION: "LOCALIZATION";
+        RESPONSIVENESS: "RESPONSIVENESS";
+        LAYOUT: "LAYOUT";
+        VISUAL_REGRESSION: "VISUAL_REGRESSION";
+        MEMORY: "MEMORY";
+        PERFORMANCE_REGRESSION: "PERFORMANCE_REGRESSION";
+        MEMORY_REGRESSION: "MEMORY_REGRESSION";
+        FORM_VALIDATION_BUG: "FORM_VALIDATION_BUG";
+        OTHER: "OTHER";
+    }>>;
+    severity: z.ZodOptional<z.ZodEnum<{
+        LOW_SEVERITY: "LOW_SEVERITY";
+        MEDIUM_SEVERITY: "MEDIUM_SEVERITY";
+        HIGH_SEVERITY: "HIGH_SEVERITY";
+        CRITICAL_SEVERITY: "CRITICAL_SEVERITY";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        IGNORED: "IGNORED";
+        FIXED: "FIXED";
+        DUPLICATE: "DUPLICATE";
+        IN_PROGRESS_BUG: "IN_PROGRESS_BUG";
+        ARCHIVED_BUG: "ARCHIVED_BUG";
+        BLOCKED: "BLOCKED";
+    }>>;
+    reportedReleaseId: z.ZodOptional<z.ZodString>;
+    dueDateMillis: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    linkTargets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        toEntityType: z.ZodEnum<{
+            STORY: "STORY";
+            SCENARIO: "SCENARIO";
+            TEST: "TEST";
+            ISSUE: "ISSUE";
+            EXTERNAL: "EXTERNAL";
+            TEST_EXECUTION: "TEST_EXECUTION";
+            BATCH_INVOCATION: "BATCH_INVOCATION";
+        }>;
+        toEntityId: z.ZodString;
+    }, z.core.$strip>>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    source: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    artifactReference: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
 export declare const emptyInput: z.ZodObject<{}, z.core.$strip>;
 export declare const getBranchSpecificEndpointConfigInput: z.ZodObject<{
     branchName: z.ZodOptional<z.ZodString>;
@@ -581,6 +647,9 @@ export declare const listScreenStatesInput: z.ZodObject<{
 export declare const getReleaseInput: z.ZodObject<{
     version: z.ZodString;
 }, z.core.$strip>;
+export declare const getReleaseDetailsInput: z.ZodObject<{
+    version: z.ZodString;
+}, z.core.$strip>;
 export declare const getSecurityScanConfigInput: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/dist/core/schemas.js

@@ -99,6 +99,72 @@ export const updateIssueStatusInput = z.object({
         .enum(["INTENDED_BEHAVIOUR", "INACCURATE_ASSESSMENT", "NOT_IMPORTANT"])
         .optional(),
 });
+const linkedEntityTypeSchema = z.enum([
+    "STORY",
+    "SCENARIO",
+    "TEST",
+    "ISSUE",
+    "EXTERNAL",
+    "TEST_EXECUTION",
+    "BATCH_INVOCATION",
+]);
+const createIssueLinkTargetSchema = z.object({
+    toEntityType: linkedEntityTypeSchema,
+    toEntityId: z.string().min(1),
+});
+export const createIssueInput = z.object({
+    title: z.string().min(1),
+    description: z.string().optional(),
+    issueType: z
+        .enum(["BUG_ISSUE", "SUGGESTION_ISSUE", "OBSERVATION_ISSUE", "TASK_ISSUE"])
+        .optional(),
+    category: z
+        .enum([
+        "ACCESSIBILITY",
+        "SECURITY",
+        "VISUAL",
+        "PERFORMANCE",
+        "FUNCTIONAL",
+        "NETWORK",
+        "USABILITY",
+        "COMPATIBILITY",
+        "DATA_INTEGRITY",
+        "INTERACTION",
+        "LOCALIZATION",
+        "RESPONSIVENESS",
+        "LAYOUT",
+        "VISUAL_REGRESSION",
+        "MEMORY",
+        "PERFORMANCE_REGRESSION",
+        "MEMORY_REGRESSION",
+        "FORM_VALIDATION_BUG",
+        "OTHER",
+    ])
+        .optional(),
+    severity: z
+        .enum(["LOW_SEVERITY", "MEDIUM_SEVERITY", "HIGH_SEVERITY", "CRITICAL_SEVERITY"])
+        .optional(),
+    status: z
+        .enum([
+        "ACTIVE",
+        "IGNORED",
+        "FIXED",
+        "DUPLICATE",
+        "IN_PROGRESS_BUG",
+        "ARCHIVED_BUG",
+        "BLOCKED",
+    ])
+        .optional(),
+    reportedReleaseId: z.string().optional(),
+    dueDateMillis: z.coerce.number().optional(),
+    assignee: z.string().optional(),
+    linkTargets: z.array(createIssueLinkTargetSchema).optional(),
+    labels: z.array(z.string()).optional(),
+    source: z.string().optional(),
+    environment: z.string().optional(),
+    attachments: z.array(z.record(z.string(), z.unknown())).optional(),
+    artifactReference: z.record(z.string(), z.unknown()).optional(),
+});
 export const emptyInput = z.object({});
 export const getBranchSpecificEndpointConfigInput = z.object({
     branchName: z.string().optional(),
@@ -258,6 +324,10 @@ export const getReleaseInput = z.object({
     /** Release catalog version / label — maps to McpGetReleaseRequest.version */
     version: z.string().min(1),
 });
+export const getReleaseDetailsInput = z.object({
+    /** Release catalog version / label — maps to McpGetReleaseDetailsRequest.version */
+    version: z.string().min(1),
+});
 export const getSecurityScanConfigInput = z.object({
     id: z.string().min(1),
 });

package/dist/core/tools.js

@@ -250,6 +250,48 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/update_issue_status", body);
         },
     },
+    {
+        kebab: "create-issue",
+        description: "Create a TestChimp issue in the current project. title is required. " +
+            "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). " +
+            "Authenticated via project API key; project is resolved from the key.",
+        inputSchema: S.createIssueInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = { title: a.title.trim() };
+            if (a.description != null)
+                body.description = a.description;
+            if (a.issueType)
+                body.issueType = a.issueType;
+            if (a.category)
+                body.category = a.category;
+            if (a.severity)
+                body.severity = a.severity;
+            if (a.status)
+                body.status = a.status;
+            if (a.reportedReleaseId != null)
+                body.reportedReleaseId = a.reportedReleaseId;
+            if (a.dueDateMillis != null)
+                body.dueDateMillis = a.dueDateMillis;
+            if (a.assignee != null)
+                body.assignee = a.assignee;
+            if (a.linkTargets?.length)
+                body.linkTargets = a.linkTargets;
+            if (a.labels?.length)
+                body.labels = a.labels;
+            if (a.source != null)
+                body.source = a.source;
+            if (a.environment != null)
+                body.environment = a.environment;
+            if (a.attachments?.length)
+                body.attachments = a.attachments;
+            if (a.artifactReference != null)
+                body.artifactReference = a.artifactReference;
+            return postMcp("/api/mcp/create_issue", body);
+        },
+    },
     {
         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). " +
@@ -510,6 +552,19 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/get_release", body);
         },
     },
+    {
+        kebab: "get-release-details",
+        description: "Fetch gate-oriented release details for a version/label: scope, per-environment " +
+            "priority×status test stats, open issue stats, scan summaries, and detailed in-scope " +
+            "scenario/issue records (McpGetReleaseDetailsRequest/Response). Pass version (CLI: --version). " +
+            "Use for CI/agent release gating. Authenticated via project API key.",
+        inputSchema: S.getReleaseDetailsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = { version: a.version.trim() };
+            return postMcp("/api/mcp/get_release_details", body);
+        },
+    },
     {
         kebab: "get-security-scan-config",
         description: "Fetch security scan config by scan id (detail.dastCheckConfig / detail.sastCheckConfig / " +

package/package.json

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