plotcoder-board 0.1.9 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plotcoder-board",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/scripts/plotcoder-mcp-server.mjs

@@ -1563,7 +1563,9 @@ server.registerTool(
       "The workflows — the app's own, the same on every project; no project was read.\n" +
       WORKFLOWS.map(
         (workflow) =>
-          `- ${workflow.id} — ${workflow.name}\n  ask: "${workflow.ask}"\n  tools: ${workflow.tools.join(", ")}\n  keep: ${workflow.then}`,
+          `- ${workflow.id} — ${workflow.name}\n  ask: "${workflow.ask}"\n  tools: ${workflow.tools.join(", ")}\n  keep: ${workflow.then}${
+            workflow.needs ? `\n  the treatment should answer (ask the writer for what it leaves open; invent none of it):\n${workflow.needs.map((need) => `    - ${need.question} ${need.hint} → ${need.tool}`).join("\n")}` : ""
+          }`,
       ).join("\n"),
       WORKFLOWS,
     ),

package/src/board/workflows.d.ts

@@ -11,6 +11,8 @@ export type Workflow = {
   tools: string[];
   /** The rule the agent keeps while doing it. */
   then: string;
+  /** What the writer's material should say for the workflow to need no questions back, and the tool each answer lands in (R49). */
+  needs?: { question: string; hint: string; tool: string }[];
 };
 
 export declare const WORKFLOWS: readonly Workflow[];

package/src/board/workflows.js

@@ -17,6 +17,24 @@ export const WORKFLOWS = [
     ask: "Here is a treatment. Break it into a wall: one card per scene with a headline and what changes, the cast on each card, the places, and the major turns marked as beats.",
     tools: ["list_words", "read_wall", "list_reminders", "new_project", "new_board", "rename_project", "set_target", "create_note", "list_board", "add_character", "cast", "update_character", "set_location", "set_rank", "set_length", "set_plant", "create_arrow", "create_group", "organize"],
     then: "Start where the wall will live: on the account, new_project names it; in a folder, new_board for the writer's wall, then rename_project. Read the wall (read_wall) and say what it asks. A treatment is cards, one create_note each, with characters, location, rank and plants on the call; import_fountain is the door for pages, not a treatment — a scene's text measures its card.",
+    // What a treatment should say (R49): eleven blind runs asked the writer
+    // the same questions at the end of every build. Each is a fact the wall
+    // needs and the treatment could carry, and the tool it lands in. A writer
+    // who answers them in the treatment gets a wall with no questions back;
+    // an agent asks the ones the treatment leaves open, and invents none.
+    needs: [
+      { question: "How long is it?", hint: "An hour, a half-hour, a feature — or a page count, if you have one.", tool: "set_target" },
+      { question: "What is the central question, in one sentence?", hint: "And if this is one episode of something, what is the series about?", tool: "set_logline, set_premise" },
+      { question: "Which scenes are the turns?", hint: "Name them, or say \"propose them and I will strike\".", tool: "set_rank" },
+      { question: "Does it have acts?", hint: "If so, where does each break fall?", tool: "create_group" },
+      { question: "Where does each scene happen?", hint: "In your own words. A scene that moves through one location is still one place.", tool: "set_location" },
+      { question: "When does a scene happen, where that matters?", hint: "That night; the fourth of October. It goes in the headline for now.", tool: "the headline" },
+      { question: "Who is in each scene, and what do we call them?", hint: "A full name, or a role for someone unnamed — the man in 42. And who is only spoken of, never in a scene? They go in someone's notes, not the cast.", tool: "add_character, cast, update_character" },
+      { question: "What is planted, and where does it pay off?", hint: "Say \"later in the series\" when it pays off outside this episode, so the fold is deliberate.", tool: "set_plant, create_arrow" },
+      { question: "Which scenes do you already know run long or short?", hint: "A day in the story is not a page count; leave the rest unsized.", tool: "set_length" },
+      { question: "What are the project and the board called?", hint: "The series, and this episode.", tool: "rename_project, rename_board" },
+      { question: "What must not be invented?", hint: "Looks and voices are yours until you say; so is anything the treatment does not state.", tool: "update_character, later" },
+    ],
   },
   {
     id: "read-and-raise",