@flowriki/agent 0.1.0-beta.42 → 0.1.0-beta.43

package/dist/cli.js

@@ -14,6 +14,7 @@ import {
   helperRunner,
   mirrorCheckTargets,
   openRunSession,
+  parseGherkin,
   prepareBrowsers,
   replayCase,
   replayFlow,
@@ -22,7 +23,7 @@ import {
   runtimeValue,
   start,
   status
-} from "./chunk-FKD5OAUV.js";
+} from "./chunk-ZMHE47A5.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -218,6 +219,20 @@ var ServiceClient = class {
     return this.call(`/api/agent/library?${query}`);
   }
   /** Test cases written, edited or linked in one commit; duplicates skipped. */
+  readCases(projectId, refs) {
+    const ids = refs.filter((r) => /^tc_/.test(r.trim()));
+    const names = refs.filter((r) => !/^tc_/.test(r.trim()));
+    const q = new URLSearchParams({ projectId, ...ids.length ? { ids: ids.join(",") } : {}, ...names.length ? { names: names.join("|") } : {} });
+    return this.call(`/api/agent/cases/read?${q}`);
+  }
+  /** Test cases written down — business steps, no flows yet — on Claude's
+   *  working branch. */
+  writeCases(projectId, groups, changeId) {
+    return this.call(
+      `/api/agent/cases/batch?projectId=${encodeURIComponent(projectId)}`,
+      { method: "POST", body: JSON.stringify({ groups, ...changeId ? { changeId } : {} }) }
+    );
+  }
   saveLibrary(projectId, input) {
     return this.call(`/api/agent/library?projectId=${encodeURIComponent(projectId)}`, { method: "POST", body: JSON.stringify(input) });
   }
@@ -839,6 +854,11 @@ THE MODEL \u2014 get this right before recording anything:
 - A TEST CASE is the test. It strings flows together as rows (in the same
   browser, or a new one for a second person) and switches on the checks it is
   about. Build it with preview_case, then save_case \u2014 which runs it first.
+- A test case can be WRITTEN BEFORE IT IS AUTOMATED: business steps (Given /
+  When / Then) and no flows \u2014 imported from a spreadsheet, or written with
+  write_test_cases. To automate one, record the flows its steps need, then
+  save_case with the SAME name in the SAME folder: that fills it, and its
+  business steps stay. Its Then lines are the checks to switch on.
 - SIGN-IN is shared setup: a flow or case that needs somebody signed in uses a
   sign-in profile from the catalog (start_flow's signIn), never typed login steps.
   None yet? Make it: record the login as a flow that ends with a check proving
@@ -1293,6 +1313,86 @@ ${page}`);
         return text(out);
       }
     },
+    {
+      name: "read_test_cases",
+      title: "Read test cases",
+      description: "Read test cases by id (tc_\u2026) or exact name: their feature, business steps (Given / When / Then), whether they are automated, and the flows they run. Read a case's steps before automating it.",
+      inputSchema: {
+        type: "object",
+        properties: { projectId: { type: "string" }, cases: { type: "array", items: { type: "string" }, description: "Ids or names." } },
+        required: ["cases"],
+        additionalProperties: false
+      },
+      annotations: { readOnlyHint: true },
+      run: async (args) => {
+        const projectId = await projectFor(args["projectId"]);
+        const refs = Array.isArray(args["cases"]) ? args["cases"].map(String) : [];
+        const { cases, missing } = await service.readCases(projectId, refs);
+        const parts = cases.map((c) => [
+          `${c.folder} \u203A ${c.name} (${c.id}) \u2014 ${c.automated ? `automated, rows: ${c.rows.join(" \u2192 ")}` : "not automated yet"}`,
+          ...c.description ? [`  ${c.description}`] : [],
+          ...c.businessSteps.length ? c.businessSteps.map((s) => `  ${s.keyword} ${s.text}`) : ["  (no business steps written)"]
+        ].join("\n"));
+        if (missing.length) parts.push(`Not found: ${missing.join(", ")} \u2014 project_catalog lists the test cases.`);
+        return text(parts.join("\n\n") || "No test cases found.");
+      }
+    },
+    {
+      name: "write_test_cases",
+      title: "Write test cases down, before automating them",
+      description: "Write test cases as business steps \u2014 Given / When / Then \u2014 with no flows yet, grouped by feature (the case folder), on Claude's working branch for review. They show as not automated until a test case with the same name is saved into the same folder with save_case, which keeps these steps. A case its folder already has is skipped. Use it when asked to write, plan or list test cases; record and save_case only when asked to automate.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          projectId: { type: "string" },
+          features: {
+            type: "array",
+            description: 'One entry per feature (case folder), e.g. "Account \u2013 Sign up".',
+            items: {
+              type: "object",
+              properties: {
+                feature: { type: "string" },
+                cases: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      name: { type: "string", description: 'The scenario it proves, e.g. "A taken email is refused".' },
+                      description: { type: "string" },
+                      steps: { type: "array", description: `Given / When / Then lines, e.g. "Given the sign-up form is open", "When I sign up with a taken email", "Then I see 'That email is taken'". And / But continue the line above.`, items: { type: "string" } }
+                    },
+                    required: ["name", "steps"],
+                    additionalProperties: false
+                  }
+                }
+              },
+              required: ["feature", "cases"],
+              additionalProperties: false
+            }
+          },
+          branch: { type: "string", description: "Optional: the id of one of Claude's open branches to write to (list_my_branches). Default: the working branch." }
+        },
+        required: ["features"],
+        additionalProperties: false
+      },
+      run: async (args) => {
+        const projectId = await projectFor(args["projectId"]);
+        const features = Array.isArray(args["features"]) ? args["features"] : [];
+        const groups = features.map((f) => ({
+          folder: String(f.feature ?? "").trim(),
+          cases: (Array.isArray(f.cases) ? f.cases : []).map((c) => {
+            const lines = Array.isArray(c.steps) ? c.steps.map(String) : [];
+            const steps = parseGherkin(lines.join("\n"));
+            if (!steps) throw new Error(`the steps of "${String(c.name ?? "")}" must each start with Given, When, Then, And or But`);
+            return { name: String(c.name ?? "").trim(), ...typeof c.description === "string" ? { description: c.description } : {}, businessSteps: steps };
+          })
+        }));
+        const done = await service.writeCases(projectId, groups, str(args["branch"]));
+        catalogs.delete(projectId);
+        const skipped = done.skipped.length ? ` Skipped ${done.skipped.length} the folder already had: ${done.skipped.map((s) => `"${s.name}"`).join(", ")}.` : "";
+        return text(`Wrote ${done.created.length} test case${done.created.length === 1 ? "" : "s"}, not automated yet, on Claude's working branch ${done.branch}.${skipped}`);
+      }
+    },
     {
       name: "create_sign_in",
       title: "Make a sign-in profile",

package/dist/engine.js

@@ -9,7 +9,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-FKD5OAUV.js";
+} from "./chunk-ZMHE47A5.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.42",
+  "version": "0.1.0-beta.43",
   "description": "Run Flowriki UI tests on your own computer. Connects this machine to your Flowriki account.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",