@testchimp/cli 0.1.11 → 0.1.13

package/dist/cli/program.js

@@ -557,6 +557,22 @@ export function buildCliProgram() {
         const out = await runTool("list-screen-states", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("get-release")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "get-release").description)
+        .addOption(jsonInputOption())
+        .option("--version <version>", "Release version / label (McpGetReleaseRequest.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", { version: String(merged.version).trim() }, { postMcp });
+        console.log(out);
+    });
     program
         .command("upsert-screen-states")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "upsert-screen-states").description)

package/dist/core/schemas.d.ts

@@ -558,6 +558,9 @@ export declare const getBunnyshellWorkflowJobLogsInput: z.ZodObject<{
 export declare const listScreenStatesInput: z.ZodObject<{
     environment: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const getReleaseInput: z.ZodObject<{
+    version: z.ZodString;
+}, z.core.$strip>;
 /** UpsertScreenStatesRequest JSON (proto camelCase). */
 export declare const upsertScreenStatesInput: z.ZodObject<{
     screenStates: z.ZodArray<z.ZodObject<{

package/dist/core/schemas.js

@@ -235,6 +235,10 @@ export const getBunnyshellWorkflowJobLogsInput = z.object({
 export const listScreenStatesInput = z.object({
     environment: z.string().optional(),
 });
+export const getReleaseInput = z.object({
+    /** Release catalog version / label — maps to McpGetReleaseRequest.version */
+    version: z.string().min(1),
+});
 const screenStatesEntrySchema = z.object({
     screen: z.string().optional(),
     states: z.array(z.string()),

package/dist/core/tools.js

@@ -125,9 +125,11 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "create-user-story",
-        description: "Create a user story on the TestChimp project and its plan file stub. " +
-            "Always call this before writing a new story markdown file; use the returned ordinalId as US-<ordinalId> in frontmatter. " +
-            "platformFilePath must be under plans/stories/ and end with .md.",
+        description: "Create a user story on the TestChimp project and allocate a real US-<ordinalId>. " +
+            "Response includes content: canonical stub markdown already containing id: US-<ordinalId>. " +
+            "BLOCKING workflow: call this FIRST → Write the returned content to the repo plans/stories path " +
+            "(edit body as needed but keep id:) → call update-user-story with the full markdown. " +
+            "Never write story markdown that omits id. platformFilePath must be under plans/stories/ and end with .md.",
         inputSchema: S.createUserStoryInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -139,7 +141,12 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "create-test-scenario",
-        description: "Create a test scenario linked to a user story. platformFilePath must be under plans/scenarios/ and end with .md. " +
+        description: "Create a test scenario linked to a user story and allocate a real TS-<ordinalId>. " +
+            "Response includes content: canonical stub markdown already containing id: TS-<ordinalId> and story: US-<n>. " +
+            "BLOCKING workflow: call this FIRST → Write the returned content to the repo plans/scenarios path " +
+            "(edit body as needed but keep id: and story:) → call update-test-scenario with the full markdown. " +
+            "Never write scenario markdown that omits id. update-test-scenario rejects missing id/story with a clear error. " +
+            "platformFilePath must be under plans/scenarios/ and end with .md. " +
             "userStoryOrdinalId is the numeric part of the parent US-<n> id.",
         inputSchema: S.createTestScenarioInput,
         execute: async (args, { postMcp }) => {
@@ -154,8 +161,8 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "update-user-story",
         description: "Sync a user story markdown file to the platform after local edits. " +
-            "Parses frontmatter (id: US-..., title, priority) and updates the linked support file and entity. " +
-            "Implementation status is not stored in markdown; use mark-plan-items-implementation-done.",
+            "Requires frontmatter id: US-<n> (platform-issued). Missing id returns an error telling you to call create-user-story first. " +
+            "Parses frontmatter (id, title, priority) and updates the linked support file and entity.",
         inputSchema: S.updatePlanMarkdownInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -165,8 +172,8 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "update-test-scenario",
         description: "Sync a test scenario markdown file to the platform after local edits. " +
-            "Parses frontmatter (id: TS-..., story: US-..., title, priority) and updates linking if story changes. " +
-            "Implementation status is not stored in markdown; use mark-plan-items-implementation-done.",
+            "Requires frontmatter id: TS-<n> and story: US-<n>. Missing either returns an error telling you to call create-test-scenario first. " +
+            "Parses frontmatter and updates linking if story changes.",
         inputSchema: S.updatePlanMarkdownInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -459,6 +466,19 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/list_screen_states", body);
         },
     },
+    {
+        kebab: "get-release",
+        description: "Fetch release catalog details for a version/label in the current project " +
+            "(McpGetReleaseRequest/Response: cut git SHA, prior release + SHA, focus areas, payload). " +
+            "Pass version (CLI: --version). Authenticated via project API key.",
+        inputSchema: S.getReleaseInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            // McpGetReleaseRequest — camelCase JSON field names per JsonFormat
+            const body = { version: a.version.trim() };
+            return postMcp("/api/mcp/get_release", body);
+        },
+    },
     {
         kebab: "upsert-screen-states",
         description: "Merge screen names and state strings into the project's relational atlas (idempotent upsert). " +

package/package.json

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