@testchimp/cli 0.1.20 → 0.1.22

package/dist/cli/program.js

@@ -5,6 +5,7 @@ import { DEFAULT_BACKEND, postMcp } from "../core/client.js";
 import { deepMerge } from "../core/merge.js";
 import { runTool } from "../core/tools.js";
 import { TOOL_DEFINITIONS } from "../core/tools.js";
+import { resolveGitHeadSha } from "../core/gitSha.js";
 import { PACKAGE_VERSION } from "../core/version.js";
 export { PACKAGE_VERSION };
 function parseRecordTypesCsv(raw) {
@@ -393,6 +394,39 @@ export function buildCliProgram() {
         const out = await runTool("mark-plan-items-implementation-done", merged, { postMcp });
         console.log(out);
     });
+    program
+        .command("update-plan-items-lifecycle-status")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-plan-items-lifecycle-status").description)
+        .addOption(jsonInputOption())
+        .option("--entity-type <type>", "story | scenario")
+        .option("--ordinal-id <n>", "numeric US-/TS- ordinal")
+        .option("--status <status>", "draft | ready | in progress | blocked | done | archived")
+        .action(async (opts) => {
+        const body = {};
+        if (opts.entityType)
+            body.entityType = String(opts.entityType).trim();
+        if (opts.ordinalId != null && String(opts.ordinalId).trim() !== "") {
+            body.ordinalId = Number(String(opts.ordinalId).trim());
+        }
+        if (opts.status)
+            body.status = String(opts.status).trim();
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.entityType || String(merged.entityType).trim() === "") {
+            throw new Error("entity-type is required (story | scenario)");
+        }
+        if (merged.ordinalId == null || !Number.isFinite(merged.ordinalId) || merged.ordinalId <= 0) {
+            throw new Error("ordinal-id is required (positive integer)");
+        }
+        if (!merged.status || String(merged.status).trim() === "") {
+            throw new Error("status is required (draft | ready | in progress | blocked | done | archived)");
+        }
+        const out = await runTool("update-plan-items-lifecycle-status", {
+            entityType: String(merged.entityType).trim(),
+            ordinalId: merged.ordinalId,
+            status: String(merged.status).trim(),
+        }, { postMcp });
+        console.log(out);
+    });
     program
         .command("update-test-scenario")
         .description(TOOL_DEFINITIONS.find((t) => t.kebab === "update-test-scenario").description)
@@ -904,43 +938,40 @@ export function buildCliProgram() {
         .addOption(jsonInputOption())
         .requiredOption("--workflow-id <id>", "Catalog workflow id")
         .requiredOption("--workflow-execution-id <ulid>", "Stable ULID for the whole run")
-        .requiredOption("--action-type <type>", "CREATED|UPDATED|DELETED|ANALYZED|ACTION_COMPLETED|ACTION_FAILED")
+        .requiredOption("--action-type <type>", "CREATED|UPDATED|DELETED|ANALYZED|IMPLEMENTED|ACTION_COMPLETED|ACTION_FAILED")
         .option("--policy-file <name>", "Policy filename")
         .option("--policy-version <semver>", "Policy version from frontmatter")
         .option("--git-sha <sha>", "Current HEAD sha")
         .option("--actor-type <type>", "LOCAL_AGENT|CLOUD_AGENT (or local-agent|cloud-agent)")
         .option("--user-id <id>", "Optional user id for traceability")
         .option("--branch-name <name>", "Git branch")
-        .option("--entity-type <type>", "test|story|scenario|issue|workflow|…")
+        .requiredOption("--entity-type <type>", "USER_STORY|SCENARIO|SMART_TEST|POLICY|ISSUE|TEST_EXECUTION|TEST_INVOCATION_BATCH|EXPLORATION|EVENT|WORKFLOW")
         .option("--entity-identity <ordinal>", "Project-scoped ordinal id (mutually exclusive with --test-json)")
         .option("--test-json <json>", "TestLocator JSON (folderPath/fileName/testSuite/testName)")
-        .option("--detail-json <json>", "Optional detail payload")
         .action(async (opts) => {
         const body = {
             workflowId: String(opts.workflowId),
             workflowExecutionId: String(opts.workflowExecutionId),
             actionType: String(opts.actionType),
+            entityType: String(opts.entityType),
         };
         if (opts.policyFile)
             body.policyFile = String(opts.policyFile);
         if (opts.policyVersion)
             body.policyVersion = String(opts.policyVersion);
-        if (opts.gitSha)
-            body.gitSha = String(opts.gitSha);
+        const gitSha = resolveGitHeadSha(opts.gitSha ? String(opts.gitSha) : undefined);
+        if (gitSha)
+            body.gitSha = gitSha;
         if (opts.actorType)
             body.actorType = String(opts.actorType);
         if (opts.userId)
             body.userId = String(opts.userId);
         if (opts.branchName)
             body.branchName = String(opts.branchName);
-        if (opts.entityType)
-            body.entityType = String(opts.entityType);
         if (opts.entityIdentity)
             body.entityIdentity = String(opts.entityIdentity);
         if (opts.testJson)
             body.test = JSON.parse(String(opts.testJson));
-        if (opts.detailJson)
-            body.detailJson = String(opts.detailJson);
         const merged = mergeBodies(body, opts.jsonInput);
         console.log(await runTool("report-agent-action", merged, { postMcp }));
     });
@@ -976,6 +1007,28 @@ export function buildCliProgram() {
             console.log(await runTool(kebab, merged, { postMcp }));
         });
     }
+    program
+        .command("upsert-policy")
+        .description(TOOL_DEFINITIONS.find((t) => t.kebab === "upsert-policy").description)
+        .addOption(jsonInputOption())
+        .option("--policy-file-name <name>", "e.g. connect-to-test-env.policy.md")
+        .option("--content <markdown>", "full markdown including frontmatter")
+        .option("--content-file <path>", "read markdown from file")
+        .action(async (opts) => {
+        let content = opts.content;
+        if (opts.contentFile)
+            content = await readFile(String(opts.contentFile), "utf8");
+        const body = {};
+        if (opts.policyFileName)
+            body.policyFileName = String(opts.policyFileName);
+        if (content)
+            body.content = content;
+        const merged = mergeBodies(body, opts.jsonInput);
+        if (!merged.policyFileName || !merged.content) {
+            throw new Error("Provide --policy-file-name and --content or --content-file (or full body via --json-input)");
+        }
+        console.log(await runTool("upsert-policy", merged, { postMcp }));
+    });
     program.on("--help", () => {
         /* default */
     });

package/dist/core/gitSha.d.ts

@@ -0,0 +1,2 @@
+/** Current git HEAD when running in a repo; used when agents omit git_sha on report-agent-action. */
+export declare function resolveGitHeadSha(provided?: string): string | undefined;

package/dist/core/gitSha.js

@@ -0,0 +1,14 @@
+import { execSync } from "node:child_process";
+/** Current git HEAD when running in a repo; used when agents omit git_sha on report-agent-action. */
+export function resolveGitHeadSha(provided) {
+    const trimmed = provided?.trim();
+    if (trimmed) {
+        return trimmed;
+    }
+    try {
+        return execSync("git rev-parse HEAD", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/core/schemas.d.ts

@@ -70,6 +70,11 @@ export declare const markPlanItemsImplementationDoneInput: z.ZodObject<{
     scenarioOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
     userStoryOrdinalIds: z.ZodOptional<z.ZodArray<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$strip>;
+export declare const updatePlanItemsLifecycleStatusInput: z.ZodObject<{
+    entityType: z.ZodString;
+    ordinalId: z.ZodCoercedNumber<unknown>;
+    status: z.ZodString;
+}, z.core.$strip>;
 export declare const getUserStoriesInput: z.ZodObject<{
     userStoryOrdinalIds: z.ZodArray<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
@@ -1021,6 +1026,19 @@ export declare const agentActorTypeSchema: z.ZodEnum<{
     "local-agent": "local-agent";
     "cloud-agent": "cloud-agent";
 }>;
+/** Closed vocabulary for report-agent-action entity_type (agent_workflow.proto AgentActionEntityType). */
+export declare const agentActionEntityTypeSchema: z.ZodEnum<{
+    SMART_TEST: "SMART_TEST";
+    SCENARIO: "SCENARIO";
+    ISSUE: "ISSUE";
+    TEST_EXECUTION: "TEST_EXECUTION";
+    USER_STORY: "USER_STORY";
+    POLICY: "POLICY";
+    TEST_INVOCATION_BATCH: "TEST_INVOCATION_BATCH";
+    EXPLORATION: "EXPLORATION";
+    EVENT: "EVENT";
+    WORKFLOW: "WORKFLOW";
+}>;
 export declare const agentActionTypeSchema: z.ZodEnum<{
     failed: "failed";
     CREATED: "CREATED";
@@ -1029,6 +1047,7 @@ export declare const agentActionTypeSchema: z.ZodEnum<{
     ANALYZED: "ANALYZED";
     ACTION_COMPLETED: "ACTION_COMPLETED";
     ACTION_FAILED: "ACTION_FAILED";
+    IMPLEMENTED: "IMPLEMENTED";
     created: "created";
     updated: "updated";
     deleted: "deleted";
@@ -1036,6 +1055,7 @@ export declare const agentActionTypeSchema: z.ZodEnum<{
     completed: "completed";
     action_completed: "action_completed";
     action_failed: "action_failed";
+    implemented: "implemented";
 }>;
 export declare const reportAgentActionInput: z.ZodObject<{
     workflowId: z.ZodString;
@@ -1051,7 +1071,18 @@ export declare const reportAgentActionInput: z.ZodObject<{
     }>>;
     userId: z.ZodOptional<z.ZodString>;
     branchName: z.ZodOptional<z.ZodString>;
-    entityType: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodEnum<{
+        SMART_TEST: "SMART_TEST";
+        SCENARIO: "SCENARIO";
+        ISSUE: "ISSUE";
+        TEST_EXECUTION: "TEST_EXECUTION";
+        USER_STORY: "USER_STORY";
+        POLICY: "POLICY";
+        TEST_INVOCATION_BATCH: "TEST_INVOCATION_BATCH";
+        EXPLORATION: "EXPLORATION";
+        EVENT: "EVENT";
+        WORKFLOW: "WORKFLOW";
+    }>;
     entityIdentity: z.ZodOptional<z.ZodString>;
     test: z.ZodOptional<z.ZodObject<{
         folderPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1067,6 +1098,7 @@ export declare const reportAgentActionInput: z.ZodObject<{
         ANALYZED: "ANALYZED";
         ACTION_COMPLETED: "ACTION_COMPLETED";
         ACTION_FAILED: "ACTION_FAILED";
+        IMPLEMENTED: "IMPLEMENTED";
         created: "created";
         updated: "updated";
         deleted: "deleted";
@@ -1074,8 +1106,8 @@ export declare const reportAgentActionInput: z.ZodObject<{
         completed: "completed";
         action_completed: "action_completed";
         action_failed: "action_failed";
+        implemented: "implemented";
     }>;
-    detailJson: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const getLastRunWorkflowDetailInput: z.ZodObject<{
     workflowId: z.ZodString;
@@ -1097,4 +1129,8 @@ export declare const getPolicyInput: z.ZodObject<{
 export declare const listPoliciesInput: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const upsertPolicyInput: z.ZodObject<{
+    policyFileName: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
 export declare const listWorkflowCatalogInput: z.ZodObject<{}, z.core.$strip>;

package/dist/core/schemas.js

@@ -69,6 +69,13 @@ export const markPlanItemsImplementationDoneInput = z.object({
     scenarioOrdinalIds: z.array(z.coerce.number().int().positive()).optional(),
     userStoryOrdinalIds: z.array(z.coerce.number().int().positive()).optional(),
 });
+export const updatePlanItemsLifecycleStatusInput = z.object({
+    /** story | scenario (also accepts user_story / USER_STORY / SCENARIO) */
+    entityType: z.string().min(1),
+    ordinalId: z.coerce.number().int().positive(),
+    /** draft | ready | in progress | blocked | done | archived */
+    status: z.string().min(1),
+});
 export const getUserStoriesInput = z
     .object({
     userStoryOrdinalIds: z.array(z.coerce.number().int().positive()).min(1),
@@ -501,6 +508,19 @@ export const reportRequirementQualityFindingsInput = z
     }
 });
 export const agentActorTypeSchema = z.enum(["LOCAL_AGENT", "CLOUD_AGENT", "local-agent", "cloud-agent"]);
+/** Closed vocabulary for report-agent-action entity_type (agent_workflow.proto AgentActionEntityType). */
+export const agentActionEntityTypeSchema = z.enum([
+    "USER_STORY",
+    "SCENARIO",
+    "SMART_TEST",
+    "POLICY",
+    "ISSUE",
+    "TEST_EXECUTION",
+    "TEST_INVOCATION_BATCH",
+    "EXPLORATION",
+    "EVENT",
+    "WORKFLOW",
+]);
 export const agentActionTypeSchema = z.enum([
     "CREATED",
     "UPDATED",
@@ -508,6 +528,7 @@ export const agentActionTypeSchema = z.enum([
     "ANALYZED",
     "ACTION_COMPLETED",
     "ACTION_FAILED",
+    "IMPLEMENTED",
     "created",
     "updated",
     "deleted",
@@ -516,6 +537,7 @@ export const agentActionTypeSchema = z.enum([
     "failed",
     "action_completed",
     "action_failed",
+    "implemented",
 ]);
 export const reportAgentActionInput = z
     .object({
@@ -527,20 +549,83 @@ export const reportAgentActionInput = z
     actorType: agentActorTypeSchema.optional(),
     userId: z.string().optional(),
     branchName: z.string().optional(),
-    entityType: z.string().optional(),
+    entityType: agentActionEntityTypeSchema,
     /** Project-scoped ordinal id (or explicitly provided execution/batch id). Mutually exclusive with `test`. */
     entityIdentity: z.string().optional(),
     /** SmartTest TestLocator. Mutually exclusive with `entityIdentity`. */
     test: testLocatorSchema.optional(),
     actionType: agentActionTypeSchema,
-    detailJson: z.string().optional(),
 })
     .superRefine((val, ctx) => {
-    if (val.test && val.entityIdentity) {
+    const actionNorm = val.actionType.toString().toUpperCase().replace(/-/g, "_");
+    const isCompletion = actionNorm === "ACTION_COMPLETED" ||
+        actionNorm === "ACTION_FAILED" ||
+        actionNorm === "COMPLETED" ||
+        actionNorm === "FAILED";
+    if (isCompletion) {
+        if (val.entityType !== "WORKFLOW") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "ACTION_COMPLETED / ACTION_FAILED require entityType WORKFLOW",
+                path: ["entityType"],
+            });
+        }
+        const identity = (val.entityIdentity ?? "").trim();
+        if (identity === "" || identity !== val.workflowId.trim()) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "entityIdentity must equal workflowId for WORKFLOW completion",
+                path: ["entityIdentity"],
+            });
+        }
+        if (val.test) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "test must not be set for WORKFLOW completion",
+                path: ["test"],
+            });
+        }
+        return;
+    }
+    if (val.entityType === "WORKFLOW") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "WORKFLOW entityType is only valid with ACTION_COMPLETED / ACTION_FAILED",
+            path: ["entityType"],
+        });
+        return;
+    }
+    if (actionNorm === "IMPLEMENTED" &&
+        val.entityType !== "USER_STORY" &&
+        val.entityType !== "SCENARIO") {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
-            message: "Provide either test (TestLocator) or entityIdentity (ordinal), not both",
-            path: ["test"],
+            message: "IMPLEMENTED is only valid for USER_STORY or SCENARIO",
+            path: ["entityType"],
+        });
+    }
+    if (val.entityType === "SMART_TEST") {
+        if (!val.test) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "SMART_TEST requires test (TestLocator)",
+                path: ["test"],
+            });
+        }
+        if (val.entityIdentity != null && val.entityIdentity.trim() !== "") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "SMART_TEST forbids entityIdentity; use test (TestLocator)",
+                path: ["entityIdentity"],
+            });
+        }
+        return;
+    }
+    if (!(val.entityIdentity ?? "").trim()) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `entityIdentity is required for ${val.entityType}`,
+            path: ["entityIdentity"],
         });
     }
 });
@@ -564,4 +649,8 @@ export const getPolicyInput = z.object({
 export const listPoliciesInput = z.object({
     workflowId: z.string().optional(),
 });
+export const upsertPolicyInput = z.object({
+    policyFileName: z.string().min(1),
+    content: z.string().min(1),
+});
 export const listWorkflowCatalogInput = z.object({});

package/dist/core/tools.js

@@ -1,6 +1,7 @@
 import { normalizeScope } from "./normalize.js";
 import { runProvisionEphemeralEnvironmentAndWait } from "./ephemeralWait.js";
 import * as S from "./schemas.js";
+import { resolveGitHeadSha } from "./gitSha.js";
 function platformToProtoEnum(platform) {
     switch (platform) {
         case "ios":
@@ -344,6 +345,21 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/mark_plan_items_implementation_done", body);
         },
     },
+    {
+        kebab: "update-plan-items-lifecycle-status",
+        description: "Update lifecycle_fields.status for one user story or test scenario (DB only; does not rewrite plan markdown). " +
+            "entityType: story | scenario; ordinalId: numeric US-/TS- ordinal; status: draft | ready | in progress | blocked | done | archived. " +
+            "Used after /testchimp implement to set status to ready (unless policy overrides).",
+        inputSchema: S.updatePlanItemsLifecycleStatusInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/update_plan_items_lifecycle_status", {
+                entityType: a.entityType,
+                ordinalId: a.ordinalId,
+                status: a.status,
+            });
+        },
+    },
     {
         kebab: "get-eaas-config",
         description: "Return the project's BunnyShell (Environment-as-a-Service) settings. Secrets are never returned.",
@@ -779,10 +795,15 @@ export const TOOL_DEFINITIONS = [
     {
         kebab: "report-agent-action",
         description: "Report a mutating agent action under a stable workflow-execution-id (ULID). " +
-            "First call for an id creates the workflow_executions row; later calls append agent_actions. " +
-            "Identity: pass `test` (TestLocator: folderPath/fileName/testSuite/testName) for SmartTests, " +
-            "or `entityIdentity` as a project-scoped ordinal id for stories/scenarios/issues " +
-            "(or an execution/batch id only when the prompt explicitly provided it). Do not use platform UUIDs.",
+            "First call for an id creates the workflow_executions row; later calls append Activity " +
+            "timeline rows (AGENT_WORKFLOW_ACTIVITY). " +
+            "Actions land on the entity's Activity timeline (plans, issues, SmartTest file). " +
+            "entityType: USER_STORY | SCENARIO | SMART_TEST | POLICY | ISSUE | TEST_EXECUTION | " +
+            "TEST_INVOCATION_BATCH | EXPLORATION | EVENT | WORKFLOW. " +
+            "actionType: CREATED | UPDATED | DELETED | ANALYZED | IMPLEMENTED | ACTION_COMPLETED | ACTION_FAILED. " +
+            "Identity: SMART_TEST uses `test` (TestLocator: folderPath/fileName/testSuite/testName); " +
+            "other artifact types use `entityIdentity` (ordinal / filename / opaque id). Do not use platform UUIDs. " +
+            "Completion (ACTION_COMPLETED / ACTION_FAILED): entityType WORKFLOW and entityIdentity = catalog workflow_id.",
         inputSchema: S.reportAgentActionInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -801,29 +822,27 @@ export const TOOL_DEFINITIONS = [
                 workflowExecutionId: a.workflowExecutionId,
                 actionType,
                 actorType,
+                entityType: a.entityType,
             };
             if (a.policyFile)
                 body.policyFile = a.policyFile;
             if (a.policyVersion)
                 body.policyVersion = a.policyVersion;
-            if (a.gitSha)
-                body.gitSha = a.gitSha;
+            const gitSha = resolveGitHeadSha(a.gitSha);
+            if (gitSha)
+                body.gitSha = gitSha;
             if (a.userId)
                 body.userId = a.userId;
             else if (process.env.TESTCHIMP_USER_ID)
                 body.userId = process.env.TESTCHIMP_USER_ID;
             if (a.branchName)
                 body.branchName = a.branchName;
-            if (a.entityType)
-                body.entityType = a.entityType;
             if (a.test) {
                 body.test = a.test;
             }
             else if (a.entityIdentity) {
                 body.entityIdentity = a.entityIdentity;
             }
-            if (a.detailJson)
-                body.detailJson = a.detailJson;
             return postMcp("/api/mcp/report_agent_action", body);
         },
     },
@@ -873,7 +892,7 @@ export const TOOL_DEFINITIONS = [
     },
     {
         kebab: "get-policy",
-        description: "Fetch a workflow policy file by name (e.g. run-qa.policy.md) from the platform POLICY_FILE store.",
+        description: "Fetch a workflow policy file by name (e.g. run-qa.policy.md) from the platform POLICY_FILE store. Filename is coerced to *.policy.md (same as upsert-policy).",
         inputSchema: S.getPolicyInput,
         execute: async (args, { postMcp }) => {
             const a = args;
@@ -892,6 +911,18 @@ export const TOOL_DEFINITIONS = [
             return postMcp("/api/mcp/list_policies", body);
         },
     },
+    {
+        kebab: "upsert-policy",
+        description: "Create or update a workflow policy file on the platform (plans/knowledge/policies/*.policy.md). policyFileName is coerced to *.policy.md (same as get-policy). Prefer after writing the file locally so the policy is available immediately (git sync also works later).",
+        inputSchema: S.upsertPolicyInput,
+        execute: async (args, { postMcp }) => {
+            const a = args;
+            return postMcp("/api/mcp/upsert_policy", {
+                policyFileName: a.policyFileName,
+                content: a.content,
+            });
+        },
+    },
     {
         kebab: "list-workflow-catalog",
         description: "List supported TestChimp workflows with Active / Disabled / Missing Config status for the project.",

package/package.json

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