@testchimp/cli 0.1.15 → 0.1.17

package/dist/cli/program.js

@@ -269,6 +269,106 @@ export function buildCliProgram() {
         const out = await runTool("get-manual-session-details", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("get-issue-details")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-issue-details").description)
+        .addOption(jsonInputOption())
+        .option("--issue-id <id>", "Issue ordinal id (#B-123, B-123, B123, or 123)")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.issueId)
+            body.issueId = String(opts.issueId).trim();
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.issueId || String(merged.issueId).trim() === "") {
+            throw new Error("issueId is required (--issue-id)");
+        }
+        const out = await runTool("get-issue-details", { issueId: String(merged.issueId).trim() }, { postMcp });
+        console.log(out);
+    });
+    program
+        .command("update-issue-status")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-issue-status").description)
+        .addOption(jsonInputOption())
+        .option("--issue-id <id>", "Issue ordinal id (#B-123, B-123, B123, or 123)")
+        .option("--status <status>", "ACTIVE | IGNORED | FIXED | DUPLICATE | IN_PROGRESS_BUG | ARCHIVED_BUG | BLOCKED")
+        .option("--ignore-reason <reason>", "When status=IGNORED: INTENDED_BEHAVIOUR | INACCURATE_ASSESSMENT | NOT_IMPORTANT")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.issueId)
+            body.issueId = String(opts.issueId).trim();
+        if (opts.status)
+            body.status = String(opts.status).trim();
+        if (opts.ignoreReason)
+            body.ignoreReason = String(opts.ignoreReason).trim();
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.issueId || String(merged.issueId).trim() === "") {
+            throw new Error("issueId is required (--issue-id)");
+        }
+        if (!merged.status || String(merged.status).trim() === "") {
+            throw new Error("status is required (ACTIVE | IGNORED | FIXED | DUPLICATE | IN_PROGRESS_BUG | ARCHIVED_BUG | BLOCKED)");
+        }
+        const out = await runTool("update-issue-status", {
+            issueId: String(merged.issueId).trim(),
+            status: String(merged.status).trim(),
+            ...(merged.ignoreReason
+                ? { ignoreReason: String(merged.ignoreReason).trim() }
+                : {}),
+        }, { 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)

package/dist/core/schemas.d.ts

@@ -79,6 +79,92 @@ export declare const getTestScenariosInput: z.ZodObject<{
 export declare const getManualSessionDetailsInput: z.ZodObject<{
     manualSessionId: z.ZodString;
 }, z.core.$strip>;
+export declare const getIssueDetailsInput: z.ZodObject<{
+    issueId: z.ZodString;
+}, z.core.$strip>;
+export declare const updateIssueStatusInput: z.ZodObject<{
+    issueId: z.ZodString;
+    status: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        IGNORED: "IGNORED";
+        FIXED: "FIXED";
+        DUPLICATE: "DUPLICATE";
+        IN_PROGRESS_BUG: "IN_PROGRESS_BUG";
+        ARCHIVED_BUG: "ARCHIVED_BUG";
+        BLOCKED: "BLOCKED";
+    }>;
+    ignoreReason: z.ZodOptional<z.ZodEnum<{
+        INTENDED_BEHAVIOUR: "INTENDED_BEHAVIOUR";
+        INACCURATE_ASSESSMENT: "INACCURATE_ASSESSMENT";
+        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>;

package/dist/core/schemas.js

@@ -80,6 +80,91 @@ export const getTestScenariosInput = z
 export const getManualSessionDetailsInput = z.object({
     manualSessionId: z.string().min(1),
 });
+export const getIssueDetailsInput = z.object({
+    /** Accepts #B-123, B-123, #B123, B123, or plain 123 */
+    issueId: z.string().min(1),
+});
+export const updateIssueStatusInput = z.object({
+    issueId: z.string().min(1),
+    status: z.enum([
+        "ACTIVE",
+        "IGNORED",
+        "FIXED",
+        "DUPLICATE",
+        "IN_PROGRESS_BUG",
+        "ARCHIVED_BUG",
+        "BLOCKED",
+    ]),
+    ignoreReason: z
+        .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(),

package/dist/core/tools.js

@@ -219,6 +219,79 @@ export const TOOL_DEFINITIONS = [
             });
         },
     },
+    {
+        kebab: "get-issue-details",
+        description: "Fetch a TestChimp issue (bug) by ordinal id. Accepts flexible issueId formats: " +
+            "#B-123, B-123, #B123, B123, or plain 123. Returns title, description, status, linked entities, " +
+            "artifact references, and short-lived signed URLs for GCS attachments/screenshots.",
+        inputSchema: S.getIssueDetailsInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/get_issue_details", {
+                issueId: a.issueId.trim(),
+            });
+        },
+    },
+    {
+        kebab: "update-issue-status",
+        description: "Update a TestChimp issue status by ordinal id (same flexible issueId formats as get-issue-details). " +
+            "status must be one of: ACTIVE, IGNORED, FIXED, DUPLICATE, IN_PROGRESS_BUG, ARCHIVED_BUG, BLOCKED. " +
+            "For /testchimp fix issue: set IN_PROGRESS_BUG after applying a code fix; set FIXED only after user confirmation / commits pushed. " +
+            "Optional ignoreReason when status is IGNORED: INTENDED_BEHAVIOUR | INACCURATE_ASSESSMENT | NOT_IMPORTANT.",
+        inputSchema: S.updateIssueStatusInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            const body = {
+                issueId: a.issueId.trim(),
+                status: a.status,
+            };
+            if (a.ignoreReason)
+                body.ignoreReason = a.ignoreReason;
+            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). " +

package/package.json

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