flowviant 0.81.0 → 0.82.0

package/bin/lib/prompts.mjs

@@ -458,6 +458,43 @@ const kickoff = ({ message, askedByName, head, tail }) => {
   return `${scaffold}${fence('WHAT THEY SAID', message)}\n\n${tail}`;
 };
 
+/**
+ * A CAPTURE TAB (server: work_session.kind='capture', flagged on the job as
+ * `capture: true`) — the board's "New task" conversation. Its whole job is
+ * turning what the person says into STAGED cards a human lands; it edits
+ * nothing, and the permission profile enforces that (PLAN_PERM: read-only +
+ * MCP — the same fence the scratch planner runs behind). This prompt is the
+ * QUALITY half; the token scope and the permission list are the safety.
+ */
+export const SYSTEM_CAPTURE = `You are the human's own Claude, in their repository, with ONE job: turn what
+they say into well-cut task cards on their Flowviant board. You are READ-ONLY
+here — read code freely to ground what you stage; the permission profile
+refuses edits, and staging is the only write you have.
+
+MECHANICS OF THIS CHAT:
+
+1. NARRATE WHILE YOU WORK. Call stream_session_turn with short progress lines
+   as you read and stage. Your FINAL reply is delivered automatically when the
+   turn ends — do not repeat it through the tool. Keep replies short: what you
+   staged, or what you need to know — one line each.
+2. STAGE, NEVER FILE. stage_card proposes a new card; stage_card_edit proposes
+   a change to an existing one (read_card first — never replace fields you
+   have not seen). Everything you stage waits in an area the person reviews
+   and lands themselves; nothing you do reaches the board directly.
+3. ONE CARD PER SHIPPABLE UNIT. Break a big ask into the units that will build
+   it, in landing order. Never card-ify chatter, questions, or one unit split
+   thin.
+4. DEDUPE FIRST, EVERY TIME. Before staging, call list_cards (the OPEN QUEUE —
+   capped, and cards agents already hold are absent from it) and list_staged
+   (what earlier chats left). If the work exists, say so and point at it;
+   stage_card_edit it if the ask adds something. Never stage a twin.
+5. CLARIFY BEFORE STAGING. A vague ask gets one or two sharp questions and a
+   wait — never a staged guess. A clear ask gets staged without ceremony.
+6. A GOOD CARD: a title naming the outcome, a brief a stranger could start
+   from, acceptance criteria only when the person stated (or the code shows)
+   what done means. No sizes, no owners, no statuses — none of those are
+   yours to set, here or anywhere.`;
+
 export const WORK_TURN_KICKOFF = ({ sessionId, sessionName, message, askedByName }) =>
   kickoff({
     message,
@@ -468,6 +505,19 @@ export const WORK_TURN_KICKOFF = ({ sessionId, sessionName, message, askedByName
     tail: `Stream your reply with stream_session_turn as you work.`,
   });
 
+/** The capture chat's kickoff — the same shape as a work turn's, with the
+ *  head restating the posture so the message is read as capture input even
+ *  deep in a long conversation. */
+export const CAPTURE_TURN_KICKOFF = ({ sessionId, sessionName, message, askedByName }) =>
+  kickoff({
+    message,
+    askedByName,
+    head:
+      `Continue the task-capture chat${sessionName ? ` "${sessionName}"` : ''} — stage cards, change nothing.\n\n` +
+      `SESSION ID (pass this to stream_session_turn / the staging tools): ${sessionId}`,
+    tail: `Stream your reply with stream_session_turn as you work.`,
+  });
+
 /** The plain tab's kickoff: no session id (there is no tool to pass it to)
  *  and no streaming instruction — the final message is the reply. */
 export const WORK_TURN_KICKOFF_PLAIN = ({ sessionName, message, askedByName }) =>

package/bin/lib/work.mjs

@@ -52,7 +52,9 @@ import { c, note, ok, warn } from './ui.mjs';
 import { mcpFor, runTurn } from './claude.mjs';
 import {
   SYSTEM_WORK,
+  SYSTEM_CAPTURE,
   WORK_TURN_KICKOFF,
+  CAPTURE_TURN_KICKOFF,
   SYSTEM_WORK_PLAIN,
   WORK_TURN_KICKOFF_PLAIN,
   SYSTEM_PLAN,
@@ -2982,6 +2984,14 @@ export function createWorkManager({
             const message = [job.body, filesNote, adoptNote, carryNote]
               .filter(Boolean)
               .join('\n\n');
+            // A CAPTURE chat (the board's New task conversation): its own
+            // system prompt, its own kickoff, and the scratch planner's
+            // READ-ONLY permission profile — the prompt says stage-never-file
+            // and the profile is what makes "read-only" true rather than
+            // asserted. Server-flagged per job; a server too old to flag it
+            // simply runs an ordinary tab, which the web's version floor
+            // prevents ever being offered.
+            const captureTab = job.capture === true;
             const turnArgs = {
               // A plain tab has no tools to name and no session id to pass —
               // its kickoff asks for one complete report instead of a stream.
@@ -2991,18 +3001,26 @@ export function createWorkManager({
                     message,
                     askedByName: job.askedByName,
                   })
-                : WORK_TURN_KICKOFF({
+                : captureTab
+                  ? CAPTURE_TURN_KICKOFF({
+                      sessionId: job.sessionId,
+                      sessionName: job.sessionName,
+                      message,
+                      askedByName: job.askedByName,
+                    })
+                  : WORK_TURN_KICKOFF({
                     sessionId: job.sessionId,
                     sessionName: job.sessionName,
                     message,
                     askedByName: job.askedByName,
                   }),
+              planPerm: captureTab,
               // The adopt turn resumes the TERMINAL conversation by forking it
               // into this cwd (claude: --resume <id> --fork-session). After it
               // speaks once, the fork lives natively here and turn 2+ is the
               // ordinary --continue resume path, unchanged.
               ...(adopting ? { adoptResumeId: job.adopt.id } : {}),
-              system: plainTab ? SYSTEM_WORK_PLAIN : SYSTEM_WORK,
+              system: plainTab ? SYSTEM_WORK_PLAIN : captureTab ? SYSTEM_CAPTURE : SYSTEM_WORK,
               // Present only when the tab named one — see brainFor.
               ...brain,
               // The tab watches the CLI work. Claude needs the flag to speak

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowviant",
-  "version": "0.81.0",
+  "version": "0.82.0",
   "description": "Run your own coding CLIs as build agents for Flowviant \u2014 Claude Code, Codex or Antigravity, on your own credentials. Holds your sessions, keeps a worktree per tab, and ships branches on your word.",
   "type": "module",
   "bin": {