@flowriki/agent 0.1.0-beta.50 → 0.1.0-beta.52

package/dist/{chunk-GLZFHC64.js → chunk-KDW65RBE.js}

@@ -17,7 +17,7 @@ import path3 from "path";
 import fs4 from "fs";
 import path4 from "path";
 
-// ../test-model/dist/chunk-QDXJLOQJ.js
+// ../test-model/dist/chunk-I5COYCQ5.js
 import { z as z2 } from "zod";
 import { z } from "zod";
 var PLATFORMS = ["web", "android", "ios"];
@@ -86,8 +86,8 @@ var DeviceChoiceSchema = z.discriminatedUnion("kind", [
   }).strict()
 ]);
 var MobileConfigSchema = z.object({
-  android: AndroidAppSchema.optional(),
-  ios: IosAppSchema.optional(),
+  android: AndroidAppSchema.partial({ appPackage: true }).optional(),
+  ios: IosAppSchema.partial({ bundleId: true }).optional(),
   /** Between runs: keep the app's data (stays signed in), or start clean. */
   reset: z.enum(["keepData", "fresh"]).default("keepData"),
   /** Where runs go when nobody says — absent means whatever is available. */
@@ -98,6 +98,10 @@ var mobileOf = (config) => {
   const parsed = MobileConfigSchema.safeParse(config?.mobile ?? {});
   return parsed.success ? parsed.data : MobileConfigSchema.parse({});
 };
+var EnvironmentAppsSchema = z.object({
+  android: AndroidAppSchema.optional(),
+  ios: IosAppSchema.optional()
+});
 var DeviceInfoSchema = z.object({
   id: z.string(),
   name: z.string(),
@@ -1684,6 +1688,14 @@ var BugSchema = z7.object({
   updatedAt: z7.string()
 }).strict();
 var STOP = new Set("a an the and or of to in on for with by is are be as at it this that from user users can should must shall will when then given".split(" "));
+function exploreSummary(markdown) {
+  const screens = /^Screens:\s*(\d+)\s*$/im.exec(markdown)?.[1];
+  return {
+    exploredAt: /^Explored:\s*(\S+)\s*$/im.exec(markdown)?.[1] ?? null,
+    environment: /^Environment:\s*(.+?)\s*$/im.exec(markdown)?.[1] ?? null,
+    screens: screens ? Number(screens) : null
+  };
+}
 var CODEBASE_TAGS = ["all", "web", "android", "ios", "mobile", "other"];
 var CODEBASE_TAG_NAME = { all: "All combined", web: "Web", android: "Android", ios: "iOS", mobile: "Mobile", other: "Other" };
 var CodebaseIndexSchema = z8.object({
@@ -2518,11 +2530,11 @@ var CLOUD_HUBS = {
 function appOf(target) {
   if (target.platform === "android") {
     const app2 = target.mobile.android;
-    if (!app2) throw new Error("This project has no Android app set up \u2014 add it in Settings \u2192 Mobile.");
+    if (!app2?.appPackage) throw new Error("This environment has not named its Android app \u2014 add its package in Settings \u2192 Environments.");
     return { id: app2.appPackage, ...app2.appActivity ? { activity: app2.appActivity } : {}, ...app2.build ? { build: app2.build } : {} };
   }
   const app = target.mobile.ios;
-  if (!app) throw new Error("This project has no iOS app set up \u2014 add it in Settings \u2192 Mobile.");
+  if (!app?.bundleId) throw new Error("This environment has not named its iOS app \u2014 add its bundle ID in Settings \u2192 Environments.");
   return { id: app.bundleId, ...app.build ? { build: app.build } : {} };
 }
 async function localBuild(build) {
@@ -4053,6 +4065,8 @@ export {
   isMobile,
   stepRefusedOn,
   platformsOf,
+  AndroidAppSchema,
+  IosAppSchema,
   CLOUD_PROVIDERS,
   CLOUD_PROVIDER_NAME,
   DeviceChoiceSchema,
@@ -4086,6 +4100,7 @@ export {
   PrerequisiteProblem,
   expandForRun,
   DeliveredHelperSchema,
+  exploreSummary,
   CODEBASE_TAG_NAME,
   codebaseIndexOf,
   runWhereOf,

package/dist/{chunk-KRWHHKSS.js → chunk-Z3SL46OX.js}

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  AndroidAppSchema,
   ArtifactPolicySchema,
   AuthReferenceSchema,
   CHECKS,
@@ -13,6 +14,7 @@ import {
   ExecutionEnvironmentSchema,
   FeatureSchema,
   FlowDocumentSchema,
+  IosAppSchema,
   MobileLane,
   PrerequisiteProblem,
   RecordedAssertionSchema,
@@ -65,7 +67,7 @@ import {
   textIndependent,
   validateActors,
   webCloudOf
-} from "./chunk-GLZFHC64.js";
+} from "./chunk-KDW65RBE.js";
 
 // src/engine/machine.ts
 import fs from "fs";
@@ -73,7 +75,7 @@ import os from "os";
 import path from "path";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
-var AGENT_VERSION = "0.1.0-beta.50";
+var AGENT_VERSION = "0.1.0-beta.52";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -133,7 +135,7 @@ async function checkMachine() {
     }
   } catch {
   }
-  const { mobileDoctor: mobileDoctor2 } = await import("./dist-Z3WSTACX.js");
+  const { mobileDoctor: mobileDoctor2 } = await import("./dist-R2I4D66B.js");
   return {
     agentVersion: AGENT_VERSION,
     node: process.versions.node,
@@ -6157,7 +6159,7 @@ function toSummary(row) {
   };
 }
 
-// ../repository-store/dist/chunk-7ZZULR2K.js
+// ../repository-store/dist/chunk-QF7BTHZB.js
 var FLOWRIKI_DIR = ".flowriki";
 var FEATURES_DIR = `${FLOWRIKI_DIR}/features`;
 var CONFIG_PATH = `${FLOWRIKI_DIR}/config.json`;
@@ -6219,12 +6221,18 @@ function readEnvironments(raw) {
   const seen = /* @__PURE__ */ new Set();
   for (const entry of raw) {
     if (!entry || typeof entry !== "object") continue;
-    const { name, baseUrl } = entry;
+    const { name, baseUrl, android, ios } = entry;
     if (typeof name !== "string" || !name.trim()) continue;
     const key = name.trim().toLowerCase();
     if (seen.has(key)) continue;
     seen.add(key);
-    out.push({ name: name.trim(), baseUrl: typeof baseUrl === "string" ? baseUrl : "" });
+    const app = { android: AndroidAppSchema.safeParse(android), ios: IosAppSchema.safeParse(ios) };
+    out.push({
+      name: name.trim(),
+      baseUrl: typeof baseUrl === "string" ? baseUrl : "",
+      ...app.android.success ? { android: app.android.data } : {},
+      ...app.ios.success ? { ios: app.ios.data } : {}
+    });
   }
   return out;
 }
@@ -9726,6 +9734,7 @@ function assistantHandlers({ deps }) {
       const askId = randomUUID();
       const linked = foldersFor(project.id).filter((f) => f.exists).map((f) => f.path);
       const mode = command.args["mode"] === "ask" ? "ask" : command.args["mode"] === "do" ? "do" : void 0;
+      const brief = typeof command.args["brief"] === "string" && command.args["brief"].trim() ? command.args["brief"].slice(0, 4e4) : void 0;
       const started = assistant.ask({
         askId,
         prompt,
@@ -9733,6 +9742,7 @@ function assistantHandlers({ deps }) {
         projectName: project.name,
         ...linked.length ? { folders: linked } : {},
         ...mode ? { mode } : {},
+        ...brief ? { brief } : {},
         ...typeof sessionId === "string" ? { sessionId } : {},
         emit
       });
@@ -10068,10 +10078,13 @@ var ASK_MODE_TOOLS = [
 function buildAskArgs(opts) {
   const ask = opts.mode === "ask";
   const folders = opts.folders ?? [];
+  const brief = opts.brief?.trim();
   const guidance = [
-    `You are the Flowriki assistant for the project "${opts.projectName}" (id ${opts.projectId}). Use the Flowriki tools, and pass projectId "${opts.projectId}" wherever a tool takes one. Start with project_brief: it is this project's memory.`,
+    `You are the Flowriki assistant for the project "${opts.projectName}" (id ${opts.projectId}). Use the Flowriki tools, and pass projectId "${opts.projectId}" wherever a tool takes one. ` + (brief ? "The project brief below is this project's memory for this job: read it first." : "Start with project_brief: it is this project's memory."),
     ask ? "ASK MODE: answer the question; change nothing. Cite what you rely on as [[testCase:<its id, tc_\u2026>]], [[knowledge:features/checkout.md]] or [[file:path/in/repo.ts]]." : "DO MODE: do what is asked, on Claude's working branch, for a person to review. Ask in the chat and wait before publishing, deleting, or sending anything to another system. End by writing a short summary of what you did with write_knowledge (memory/sessions/<date>-<topic>.md, append) so the next session knows.",
-    folders.length ? `The project's code is in ${folders.join(" and ")}. Read it with Read, Grep and Glob when it helps; you cannot change it.` : ""
+    folders.length ? `The project's code is in ${folders.join(" and ")}. Read it with Read, Grep and Glob when it helps; you cannot change it.` : "",
+    brief ? `
+${brief}` : ""
   ].filter(Boolean).join("\n");
   const flowriki = ask ? ASK_MODE_TOOLS.map((t) => `mcp__${MCP_SERVER_NAME}__${t}`) : [`mcp__${MCP_SERVER_NAME}`];
   const files = folders.length ? ["Read", "Grep", "Glob"] : [];

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   runtimeValue,
   start,
   status
-} from "./chunk-KRWHHKSS.js";
+} from "./chunk-Z3SL46OX.js";
 import {
   CLOUD_PROVIDERS,
   CLOUD_PROVIDER_NAME,
@@ -32,6 +32,7 @@ import {
   RecordedStepSchema,
   checkMobileAssertion,
   codebaseIndexOf,
+  exploreSummary,
   isMobile,
   listDevices,
   locate,
@@ -48,7 +49,7 @@ import {
   screenLines,
   stepRefusedOn,
   targetFor
-} from "./chunk-GLZFHC64.js";
+} from "./chunk-KDW65RBE.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -325,6 +326,10 @@ var ServiceClient = class {
     return this.call(this.scoped(`/bugs/${encodeURIComponent(id)}`, projectId), { method: "PATCH", body: JSON.stringify(body) });
   }
   // ── Knowledge, sources, requirements ──────────────────────
+  /** The project's brief for a job: its slice of the knowledge. */
+  brief(projectId, scope) {
+    return this.call(this.scoped("/brief", projectId, { ...scope.platform ? { platform: scope.platform } : {}, ...scope.features?.length ? { features: scope.features.join(",") } : {} }));
+  }
   knowledgePages(projectId) {
     return this.call(this.scoped("/knowledge", projectId));
   }
@@ -985,7 +990,7 @@ Review and publish it here: ${review}`;
   async startMobile(platform, catalog) {
     const draft = this.draft;
     const mobile = catalog.mobile;
-    if (!mobile) throw new Error("this project has no phone apps set up \u2014 turn on Android or iOS in Settings \u2192 Mobile");
+    if (!mobile) throw new Error("this project has no phone apps set up \u2014 turn on Android or iOS in Settings \u2192 Platforms");
     const resolvers = draft.signIn || draft.device?.kind === "cloud" ? await this.prepare() : null;
     this.mobile = await openMobileSession({
       platform,
@@ -1233,7 +1238,10 @@ codebase/<folder>.md, which must start "# <folder>", then "Commit: <full sha>"
 and "Learned: <yyyy-mm-dd>" lines: that is how the Knowledge screen shows it
 as learned. codebase.json says which platform's code each folder holds (Web,
 Android, iOS, Mobile, All combined, Other): read the web folder's page for a
-website test and the phone folder's for an app test. Keep what you learn with write_knowledge (features/<name>.md,
+website test and the phone folder's for an app test. explore/<platform>.md is
+what the assistant saw WALKING that platform \u2014 screens, the words on them,
+journeys, rules it saw refused, vocabulary: read it before writing a test for
+that platform, because it says what a person sees; the code does not. Keep what you learn with write_knowledge (features/<name>.md,
 memory/decisions.md, a session summary), on Claude's branch for review \u2014
 never a password, key or token.
 
@@ -1412,7 +1420,7 @@ It is now the project these tools work on. Open it: ${service.origin}/projects/$
           const here = phones.filter((d) => d.platform === p);
           const farms = (c.mobile?.cloud ?? []).map((f) => CLOUD_PROVIDER_NAME[f.provider]);
           const chosen = c.mobile?.devices[p];
-          return `${p === "android" ? "Android" : "iOS"} app: ${app ?? "(not set up \u2014 Settings \u2192 Mobile)"}
+          return `${p === "android" ? "Android" : "iOS"} app: ${app ?? "(not named \u2014 Settings \u2192 Environments)"}
   Phones on this computer: ${here.length ? here.map((d) => `${d.name}${d.state === "ready" ? "" : ` (${d.state})`}`).join(", ") : "none"}` + (farms.length ? `
   Cloud device farms: ${farms.join(", ")}` : "") + `
   Runs: ${c.runWhere?.[p] === "cloud" ? "in the cloud" : "on this computer"}` + (chosen ? ` \u2014 ${chosen.kind === "local" ? chosen.name || chosen.id : `${CLOUD_PROVIDER_NAME[chosen.provider]}: ${chosen.device}`}` : "");
@@ -2009,11 +2017,19 @@ Use it with start_flow signIn {"profileId": "\u2026", "accountId": "${made.accou
     {
       name: "project_brief",
       title: "Read the project's memory",
-      description: "The project's own knowledge, in one call: About the product (product.md, and product/<web|android|ios>.md where a platform differs), memory/decisions.md, what each linked codebase folder was learned as and which platform's code it holds, and the list of feature pages and session summaries. Call it first in every conversation.",
-      inputSchema: { type: "object", properties: { projectId: { type: "string" } }, additionalProperties: false },
+      description: "The project's own knowledge, in one call: About the product (product.md, and product/<web|android|ios>.md where a platform differs), memory/decisions.md, what each linked codebase folder was learned as and which platform's code it holds, what each platform looked like when explored (explore/<platform>.md), and the list of feature pages and session summaries. Call it first in every conversation. With platform and/or features, the brief is the slice for that job: that platform's part and exploration, those features' notes, the code tagged for the platform, and who can sign in.",
+      inputSchema: { type: "object", properties: { projectId: { type: "string" }, platform: { type: "string", enum: ["web", "android", "ios"], description: "The platform the job is about." }, features: { type: "array", items: { type: "string" }, description: "The features (or case folders) the job is about, by name." } }, additionalProperties: false },
       annotations: { readOnlyHint: true },
       run: async (args) => {
         const projectId = await projectFor(args["projectId"]);
+        const platform = str(args["platform"]);
+        const features = Array.isArray(args["features"]) ? args["features"].filter((f) => typeof f === "string") : [];
+        if (platform || features.length) {
+          try {
+            return text((await service.brief(projectId, { ...platform ? { platform } : {}, features })).brief);
+          } catch {
+          }
+        }
         const { pages } = await service.knowledgePages(projectId);
         const read = async (path2) => pages.some((p) => p.path === path2) ? (await service.knowledgePage(projectId, path2)).content : null;
         const [product, glossary, decisions, web, android, ios, tagged] = await Promise.all(["product.md", "glossary.md", "memory/decisions.md", "product/web.md", "product/android.md", "product/ios.md", "codebase.json"].map(read));
@@ -2023,7 +2039,12 @@ Use it with start_flow signIn {"profileId": "\u2026", "accountId": "${made.accou
           const holds = tags[p.path.slice("codebase/".length, -".md".length)]?.tags ?? [];
           return `- ${p.path}${holds.length ? ` (${holds.map((t) => CODEBASE_TAG_NAME[t]).join(", ")} code)` : ""}: ${(await read(p.path))?.split("\n").filter((l) => l.trim()).slice(0, 3).join(" \xB7 ") ?? ""}`;
         }));
-        const shown = /* @__PURE__ */ new Set(["product.md", "glossary.md", "memory/decisions.md", "product/web.md", "product/android.md", "product/ios.md", "codebase.json", ...codebases.map((p) => p.path)]);
+        const explored = pages.filter((p) => p.path.startsWith("explore/"));
+        const walks = await Promise.all(explored.map(async (p) => {
+          const s = exploreSummary(await read(p.path) ?? "");
+          return `- ${p.path}: explored ${s.exploredAt ?? "?"}${s.environment ? ` in ${s.environment}` : ""}${s.screens !== null ? `, ${s.screens} screens` : ""} \u2014 read it with knowledge_read before testing that platform`;
+        }));
+        const shown = /* @__PURE__ */ new Set(["product.md", "glossary.md", "memory/decisions.md", "product/web.md", "product/android.md", "product/ios.md", "codebase.json", ...codebases.map((p) => p.path), ...explored.map((p) => p.path)]);
         const parts = [
           product ? `## About the product (product.md)
 ${product}` : "No About the product yet \u2014 the person writes it on the Knowledge screen; offer to help draft it.",
@@ -2039,6 +2060,8 @@ ${glossary}` : "",
 ${decisions}` : "",
           codebases.length ? `## Codebase, as learned
 ${headers.join("\n")}` : "No codebase learned yet.",
+          walks.length ? `## The product, as explored
+${walks.join("\n")}` : "",
           `## Other pages
 ${pages.filter((p) => !shown.has(p.path)).map((p) => `- ${p.path}`).join("\n") || "none"}`
         ];
@@ -2074,7 +2097,7 @@ ${pages.filter((p) => !shown.has(p.path)).map((p) => `- ${p.path}`).join("\n") |
     {
       name: "write_knowledge",
       title: "Write a knowledge page",
-      description: `Write what the project should remember, on Claude's working branch for review: product.md (About the product \u2014 the person's own description; write it only when they ask) and product/<web|android|ios>.md (what is particular to that platform's app), codebase/<folder>.md (what a linked folder holds \u2014 starting with "# <folder>", "Commit: <sha>" and "Learned: <yyyy-mm-dd>" lines, then routes, screens, forms and their validation, roles, APIs, flags; summarised, never copied code), features/<name>.md (screens, rules, quirks), memory/decisions.md (decisions and conventions), memory/sessions/<yyyy-mm-dd>-<topic>.md (what a job did). append: true adds to the end instead of replacing. Never a password, key or token \u2014 those are refused.`,
+      description: `Write what the project should remember, on Claude's working branch for review: product.md (About the product \u2014 the person's own description; write it only when they ask) and product/<web|android|ios>.md (what is particular to that platform's app), explore/<web|android|ios>.md (what you saw walking that platform: "# Explored: <Platform>", "Explored: <yyyy-mm-dd>", "Environment: <name>", "Screens: <n>" lines, then Screens, Journeys, Rules observed, Vocabulary, Suggested features), codebase/<folder>.md (what a linked folder holds \u2014 starting with "# <folder>", "Commit: <sha>" and "Learned: <yyyy-mm-dd>" lines, then routes, screens, forms and their validation, roles, APIs, flags; summarised, never copied code), features/<name>.md (screens, rules, quirks), memory/decisions.md (decisions and conventions), memory/sessions/<yyyy-mm-dd>-<topic>.md (what a job did). append: true adds to the end instead of replacing. Never a password, key or token \u2014 those are refused.`,
       inputSchema: {
         type: "object",
         properties: { projectId: { type: "string" }, path: { type: "string" }, content: { type: "string" }, append: { type: "boolean" }, branch: { type: "string" } },

package/dist/{dist-Z3WSTACX.js → dist-R2I4D66B.js}

@@ -44,7 +44,7 @@ import {
   textOf,
   toolEnv,
   typesSecrets
-} from "./chunk-GLZFHC64.js";
+} from "./chunk-KDW65RBE.js";
 export {
   AGENT_HOME,
   APPIUM_DIR,

package/dist/engine.js

@@ -9,8 +9,8 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-KRWHHKSS.js";
-import "./chunk-GLZFHC64.js";
+} from "./chunk-Z3SL46OX.js";
+import "./chunk-KDW65RBE.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

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