plotcoder-board 0.1.0 → 0.1.5

package/package.json

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

package/scripts/plotcoder-mcp-server.mjs

@@ -179,9 +179,10 @@ let accountTried = false;
 /** Why the door is shut when the writer's sign-in is set but failed. Every tool says this; none reads the file instead (round four, findings 5–7). */
 let accountRefusal = null;
 const NO_PROJECT_YET = "The account holds no project yet: new_project starts the writer's first.";
-/** The same, with the folder named only when the door skipped a sample wall there (round eight, finding 9). */
+/** The same, naming the account, with the folder named only when a wall in the folder was left alone (rounds eight and ten). */
 function noProjectYet() {
-  return accountDoor?.skippedFolder ? `${NO_PROJECT_YET} The sample wall in this folder was not uploaded.` : NO_PROJECT_YET;
+  const who = accountDoor?.email ? `The account, as ${accountDoor.email}, holds no project yet: new_project starts the writer's first.` : NO_PROJECT_YET;
+  return accountDoor?.skippedFolder ? `${who} The sample wall in this folder was not uploaded.` : who;
 }
 
 /** A door's answer — shut, or no project yet — thrown from a read and turned into a plain reply by every tool. Not an error. */
@@ -394,7 +395,8 @@ async function chooseProject(key) {
     });
     if (!work) {
       accountDoor.projectId = null;
-      accountDoor.skippedFolder = true;
+      // Only a folder that actually held a wall is worth a word.
+      accountDoor.skippedFolder = Boolean(file) || fs.existsSync(BOARD_FILE);
       return null;
     }
     record = { ...record, name: record.name || "From the agent" };
@@ -1122,7 +1124,7 @@ server.registerTool(
   {
     title: "Read the wall",
     description:
-      "Read the board back: the beats in wall order (rows top to bottom, cards left to right), the pages of scenes between consecutive beats, and the questions the wall raises — a run out of proportion with the others, a card with no change line, a card no arrow touches, two headlines that read like the same scene, a group too long to be one sequence, beats back to back with nothing between them (a chain of them is one question), cards that say no place once any card has one. These are questions, not fixes: put them to the writer and do not act on them unasked. It says nothing about how many beats there should be, and neither should you.",
+      "Read the board back: the beats in wall order (rows top to bottom, cards left to right), the pages of scenes between consecutive beats with the cards in each, every setup with the distance to its payoff, and the questions the wall raises — no beat marked yet; a run out of proportion with the others; beats back to back with nothing between them (a chain of them is one question); a card with a placeholder headline or no change line; a card no arrow touches; two headlines that read like the same scene; a group too long to be one sequence; a person in the cast on no card; a person gone for more than a third of the story and ten pages; a payoff before its setup on the wall; a folded card no setup arrow pays off; cards that say no place once any card has one. These are questions, not fixes: put them to the writer and do not act on them unasked. It says nothing about how many beats there should be, and neither should you.",
     inputSchema: {},
   },
   async () => {
@@ -1771,7 +1773,7 @@ server.registerTool(
   {
     title: "Fold the corner",
     description:
-      `Fold the corner of cards — mark them as planting something — or unfold them. ${wordSentence("corner")} One thing, three words: the card's corner is folded, plants is the flag, and read_wall calls a fold with no payoff yet 'unpaid'. The setup arrow is create_arrow with kind 'setup'. Folding never moves a card.`,
+      `Fold the corner of cards — mark them as planting something — or unfold them. ${wordSentence("corner")} The setup arrow is create_arrow with kind 'setup'. Folding never moves a card.`,
     inputSchema: {
       ids: z.array(z.string()).min(1),
       plants: z.boolean(),
@@ -2218,7 +2220,23 @@ server.registerTool(
     inputSchema: {},
   },
   async () => {
-    const { reminders, live, project, base } = await readProject();
+    let read;
+    try {
+      read = await readProject();
+    } catch (error) {
+      if (!(error instanceof DoorReply)) throw error;
+      // No project on the account yet: the house principles still exist, and
+      // an agent is told to read them before it changes anything (round ten).
+      const house = currentReminders(null);
+      return ok(
+        [
+          `reminders (${error.message.replace(/\.$/, "")}): ${house.length} — the house principles the app starts every project with; the writer's own will live on the project`,
+          ...house.map((item) => `  - ${item.id} (built in) — ${item.title}: ${item.body}`),
+        ].join("\n"),
+        house,
+      );
+    }
+    const { reminders, live, project, base } = read;
     const list = currentReminders(reminders);
     const own = list.filter((item) => !item.builtIn).length;
     return ok(

package/src/board/agents.js

@@ -42,7 +42,7 @@ export const AGENTS = {
       text: "Skip this when the account is the wall. Without an account, a wall is a folder: any folder, empty is fine — choose one that will outlive your session, never a scratch one. The app run from that folder shows the wall, and the server writes it there (PLOTCODER_ROOT, or the folder it is run from). A fresh folder holds the sample; new_board for the writer's wall, then rename_project. No app running? export_fountain is the wall in order, as text.",
     },
   ],
-  firstNote: "On the wall you will work, so after open_project or open_board, read_wall again. No server in front of you, and no shell to take the shell door? Nothing gets you in from inside the session: say so, and ask the person to wire the server and start a new session.",
+  firstNote: "These four are about the wall you will work, so after open_project or open_board, read_wall again. On an account with no project yet, read_wall has nothing to read and says so, and list_reminders gives the house principles every project starts with; new_project, then the four again. No server in front of you, and no shell to take the shell door? Nothing gets you in from inside the session: say so, and ask the person to wire the server and start a new session.",
   first: [
     { tool: "list_words", why: "the room's words, the app's meaning." },
     { tool: "read_wall", why: "what is here, and what it asks. A fresh folder holds a sample wall (Maya, Tom, the letter) and says so; it is not the writer's." },
@@ -69,8 +69,9 @@ export function agentsAsText() {
     lines.push(`- ${door.name}: ${door.text}`);
     if (door.code) lines.push("", "```", door.code, "```", "");
   }
-  lines.push("## Call these first", AGENTS.firstNote);
+  lines.push("## Call these first");
   AGENTS.first.forEach((item, index) => lines.push(`${index + 1}. ${item.tool} — ${item.why}`));
+  lines.push("", AGENTS.firstNote);
   lines.push("", "## Rules");
   for (const rule of AGENTS.rules) lines.push(`- ${rule}`);
   lines.push("", "## For the person", AGENTS.person, "", "## The guide", AGENTS.guide, "");

package/src/board/workflows.js

@@ -15,8 +15,8 @@ export const WORKFLOWS = [
     id: "break-a-treatment",
     name: "Break a treatment into a wall",
     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_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: "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.",
+    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.",
   },
   {
     id: "read-and-raise",