plotcoder-board 0.1.20 → 0.1.22

package/README.md

@@ -41,7 +41,7 @@ Every board verb goes through one command kernel, `src/board/reducer.js`, and th
 
 - **The wall.** Tap the words to type, drag the paper to move. Lasso to select, then Group. Drag a card's handle onto another card for an arrow. ⌘Z takes back any change, whichever door made it.
 - **`window.plotcoder`** on the page, for a console or a CDP session.
-- **The MCP server**, published to npm as `plotcoder-board`: `npx -y plotcoder-board@latest` is the server, `npx -y plotcoder-board@latest call <tool> '{json}'` one call from a shell, `npx -y plotcoder-board@latest serve` the hosted door on a port (a `Dockerfile` is here too). Inside the repo it is `scripts/plotcoder-mcp.mjs`, wired for Cursor in `.cursor/mcp.json` and for Claude Code in `.mcp.json` (run `npm ci` once first). A version tag (`v0.2.0`) publishes it, with `NPM_TOKEN` in the repo's secrets. Eighty tools: reading (`list_board`, `read_wall`, `read_pages`, `read_character`, `page_count`, `list_words`, `list_workflows`, `segment_brief`, `compare_structure`); the card, cast, place and when (`set_when`), group (with `add_to_group`) and arrow verbs, `set_logline`, `set_target`, `set_rank`, `set_plant`, `write_scene`, `edit_scene`, `move_scene`, `organize`, `apply_template` with `list_structures`, `save_structure`, `remove_structure`; `leave_question` and `ask_again`; `undo` and `redo`; the project's `list_boards`, `open_board`, `new_board`, `rename_board`, `delete_board`, `set_premise`, `rename_project` and the reminders; Fountain and Final Draft both ways, Markdown and plain text out (`export_markdown`, `export_text`); the production half (`lock_numbers`, `unlock_numbers`, `start_revision`, `end_revision`); the project as a file both ways (`export_project`, `import_project`); and, through the account door, `list_projects`, `open_project`, `new_project`, `delete_project`, `empty_account`, `delete_account`, `add_picture`, `add_take`, `list_takes`, `list_files`, `remove_file`, `build_segment`. If the dev app is open, a tool call lands on the wall within a second; if not, it edits the board file and the wall catches up on the next load.
+- **The MCP server**, published to npm as `plotcoder-board`: `npx -y plotcoder-board@latest` is the server, `npx -y plotcoder-board@latest call <tool> '{json}'` one call from a shell, `npx -y plotcoder-board@latest serve` the hosted door on a port (a `Dockerfile` is here too). Inside the repo it is `scripts/plotcoder-mcp.mjs`, wired for Cursor in `.cursor/mcp.json` and for Claude Code in `.mcp.json` (run `npm ci` once first). A version tag (`v0.2.0`) publishes it, with `NPM_TOKEN` in the repo's secrets. Eighty-one tools: reading (`list_board`, `read_wall`, `read_pages`, `read_character`, `page_count`, `list_words`, `list_workflows`, `segment_brief`, `compare_structure`); the card, cast, place and when (`set_when`), group (with `add_to_group`) and arrow verbs, `set_logline`, `set_target`, `set_rank`, `set_plant` (with `later` and `at`) and `set_payoff`, `write_scene`, `edit_scene`, `move_scene`, `organize`, `apply_template` with `list_structures`, `save_structure`, `remove_structure`; `leave_question` and `ask_again`; `undo` and `redo`; the project's `list_boards`, `open_board`, `new_board`, `rename_board`, `delete_board`, `set_premise`, `rename_project` and the reminders; Fountain and Final Draft both ways, Markdown and plain text out (`export_markdown`, `export_text`); the production half (`lock_numbers`, `unlock_numbers`, `start_revision`, `end_revision`); the project as a file both ways (`export_project`, `import_project`); and, through the account door, `list_projects`, `open_project`, `new_project`, `delete_project`, `empty_account`, `delete_account`, `add_picture`, `add_take`, `list_takes`, `list_files`, `remove_file`, `build_segment`. If the dev app is open, a tool call lands on the wall within a second; if not, it edits the board file and the wall catches up on the next load.
 - **The account door.** With `PLOTCODER_EMAIL` and `PLOTCODER_PASSWORD` in the agent's environment — the writer's own — and no dev app answering, the same server works the writer's project on the account directly, and every change lands live on every open wall. `PLOTCODER_PROJECT` picks a project by name or id. No account yet? `claim_account` makes one with the writer's email and a password they chose. The on-ramp — the doors, what to call first, the rules — is in the app behind *Are you an agent? Start here* and served at [plotcoder.com/llms.txt](https://plotcoder.com/llms.txt), both from `src/board/agents.js`.
 
 An agent should call the tools, never fake mouse drags. The skill in `.cursor/skills/plotcoder-board/SKILL.md` says how; `.claude/skills/plotcoder-board` is a symlink to the same file.
@@ -99,4 +99,4 @@ next round into a test of `claim_account` instead of the door it meant to test.
 
 ## Status
 
-Version 0.1.20. A project of boards; sign in with your email and a password from the PlotCoder mark and your projects follow you to every device, share one with another writer by email and write it together live, or stay signed out and work on this device as before. Pages sit beside the wall: a scene's text lives on its card, measures it, paginates to the industry's rules, prints, goes out and comes in as Fountain or Final Draft, and goes out as Markdown or plain text for a collaborator in Google Docs. It installs as a progressive web app and opens offline; plotcoder.com serves over HTTPS. The wall, beats, card length, groups, arrows, pan and zoom, save and open, and the agent surface are in use.
+Version 0.1.22. A project of boards; sign in with your email and a password from the PlotCoder mark and your projects follow you to every device, share one with another writer by email and write it together live, or stay signed out and work on this device as before. Pages sit beside the wall: a scene's text lives on its card, measures it, paginates to the industry's rules, prints, goes out and comes in as Fountain or Final Draft, and goes out as Markdown or plain text for a collaborator in Google Docs. It installs as a progressive web app and opens offline; plotcoder.com serves over HTTPS. The wall, beats, card length, groups, arrows, pan and zoom, save and open, and the agent surface are in use.

package/package.json

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

package/scripts/plotcoder-mcp-server.mjs

@@ -73,6 +73,8 @@ import {
   reidentifyProject,
   renameProject,
   castElsewhere,
+  landingsOn,
+  laterBoards,
   liftCast,
   mergeRoster,
   sameRoster,
@@ -577,6 +579,27 @@ function elsewhereIds(boardId) {
   if (!lastHeld?.project) return [];
   return Object.keys(castElsewhere(lastHeld.project, lastHeld.boards, boardId ?? lastHeld.project.activeBoardId));
 }
+/** Everything a reading of one board needs to know about the rest of the project (R51, R58), from the last project read. */
+function readOptions(boardId, state = null) {
+  if (!lastHeld?.project) return { elsewhere: [] };
+  const id = boardId ?? lastHeld.project.activeBoardId;
+  const boards = state ? { ...lastHeld.boards, [id]: state } : lastHeld.boards;
+  return { elsewhere: elsewhereIds(id), laterBoards: laterBoards(lastHeld.project, boards), paidBy: landingsOn(lastHeld.project, boards, id).paid };
+}
+/** A card's number as the reading prints it: the lock's when locked, else its place in story order. */
+function sceneLabel(state, noteId) {
+  const numbers = state.lock ? sceneNumbers(storyOrder(state), state.lock) : null;
+  const numbered = numbers?.get?.(noteId);
+  if (numbered) return numbered;
+  const index = storyOrder(state).findIndex((note) => note.id === noteId);
+  return index >= 0 ? String(index + 1) : "?";
+}
+/** "Ep 1, sc 4": a scene on another board, named by the board's place in the project and the scene's in its story (R58). */
+function episodeLabel(project, boards, boardId, noteId) {
+  const index = project.boards.findIndex((meta) => meta.id === boardId);
+  const state = isBoardState(boards[boardId]) ? normalizeState(boards[boardId]) : null;
+  return `Ep ${index + 1}${state && noteId ? `, sc ${sceneLabel(state, noteId)}` : ""}`;
+}
 async function readProjectUncached() {
   const viaAccount = await throughAccount(accountReadProject);
   if (viaAccount) return viaAccount;
@@ -786,9 +809,8 @@ const findingKey = (finding) => `${finding.kind}|${finding.ids.join(",")}|${find
 function noteChange(before, after, boardId = null) {
   // The same reading read_wall gives: a person cast on another board is not
   // asked about, so a write's tail never names a question the reading does not.
-  const options = { elsewhere: elsewhereIds(boardId) };
-  const was = readWall(before, options);
-  const now = readWall(after, options);
+  const was = readWall(before, readOptions(boardId, before));
+  const now = readWall(after, readOptions(boardId, after));
   const wasKeys = new Set(was.findings.map(findingKey));
   const nowKeys = new Set(now.findings.map(findingKey));
   lastChange = {
@@ -974,19 +996,25 @@ function runtimeKinds(state) {
 
 function summarize(state) {
   const nameOf = new Map(state.characters.map((character) => [character.id, character.name]));
+  // What lands here from the other boards' folds (R58), from the last project read.
+  const paidByHere = lastHeld?.project ? landingsOn(lastHeld.project, { ...lastHeld.boards, [lastHeld.project.activeBoardId]: state }, lastHeld.project.activeBoardId).paid : [];
   const notes = storyOrder(state)
     .map((note) => {
       const cast = note.characterIds.map((id) => nameOf.get(id) ?? id);
       const who = cast.length ? `, cast: ${cast.join(", ")}` : "";
       // The board it pays off on, named here as read_wall names it (round fifteen, entry 44).
-      const plant = note.plants ? (note.payoffBoardId ? `, plants → pays off later on "${lastHeld?.project?.boards?.find((meta) => meta.id === note.payoffBoardId)?.name ?? note.payoffBoardId}"` : ", plants") : "";
+      const laterName = note.payoffBoardId ? (lastHeld?.project?.boards?.find((meta) => meta.id === note.payoffBoardId)?.name ?? note.payoffBoardId) : null;
+      const laterAt = note.payoffBoardId && note.payoffNoteId && lastHeld?.project ? ` at ${episodeLabel(lastHeld.project, lastHeld.boards, note.payoffBoardId, note.payoffNoteId)} "${lastHeld.boards[note.payoffBoardId]?.notes?.find((item) => item.id === note.payoffNoteId)?.headline ?? note.payoffNoteId}"` : "";
+      const plant = note.plants ? (note.payoffBoardId ? `, plants → pays off later on "${laterName}"${laterAt || ", no scene there claimed yet"}` : ", plants") : "";
+      // The receiving end (R58): what this card pays off from another board, composed from the project.
+      const pays = paidByHere.filter((item) => item.id === note.id).map((item) => `, pays off "${item.fromHeadline}" from "${item.fromBoardName}" (${episodeLabel(lastHeld.project, lastHeld.boards, item.fromBoardId, item.fromNoteId)})`).join("");
       const snap = state.revision?.snapshot?.[note.id];
       const revised = snap && (snap.headline !== note.headline || snap.change !== note.change || (snap.text ?? "") !== (note.text ?? "") || (snap.location ?? "") !== (note.location ?? "")) ? `, changed in ${state.revision.color}` : "";
       const place = note.location ? `, at: ${note.location}` : "";
       const when = note.when ? `, when: ${note.when}` : "";
       const count = formatPages(noteEighths(note));
       const pages = isMeasured(note) ? `${count} ${count === "1" ? "page" : "pages"}, written` : note.lengthEighths === null ? "about a page, unsized" : `${count} ${count === "1" ? "page" : "pages"}`;
-      return `  - ${note.id} [${note.rank ?? "scene"}, ${pages}${who}${place}${when}${plant}${revised}] — "${note.headline}" (${note.color}) at ${Math.round(note.x)},${Math.round(note.y)}`;
+      return `  - ${note.id} [${note.rank ?? "scene"}, ${pages}${who}${place}${when}${plant}${pays}${revised}] — "${note.headline}" (${note.color}) at ${Math.round(note.x)},${Math.round(note.y)}`;
     })
     .join("\n");
   const cast = state.characters
@@ -1424,8 +1452,10 @@ server.registerTool(
     const { project: projectForRead } = await readProject();
     const readBoardMeta = boardById(projectForRead, readBoardId ?? projectForRead.activeBoardId);
     const { boards: boardsForRead } = await readProject();
-    const elsewhereForRead = castElsewhere(projectForRead, boardsForRead, readBoardId ?? projectForRead.activeBoardId);
-    const reading = readWall(state, { elsewhere: Object.keys(elsewhereForRead) });
+    const readId = readBoardId ?? projectForRead.activeBoardId;
+    const boardsNow = { ...boardsForRead, [readId]: state };
+    const elsewhereForRead = castElsewhere(projectForRead, boardsForRead, readId);
+    const reading = readWall(state, { elsewhere: Object.keys(elsewhereForRead), laterBoards: laterBoards(projectForRead, boardsNow), paidBy: landingsOn(projectForRead, boardsNow, readId).paid });
     lastReading = { findings: reading.findings };
     sinceRead.length = 0;
     const runs = describeRuns(reading, state).map((line, index) => {
@@ -1466,7 +1496,8 @@ server.registerTool(
       ...(reading.setups.length
         ? describeSetups(reading, state).map((line) => `  - ${line}`)
         : ["  (no arrow is marked as a setup)"]),
-      ...reading.later.map((item) => `  - "${state.notes.find((note) => note.id === item.id)?.headline ?? item.id}" is folded and pays off later, on "${boardById(projectForRead, item.boardId)?.name ?? item.boardId}"`),
+      ...reading.later.map((item) => `  - "${state.notes.find((note) => note.id === item.id)?.headline ?? item.id}" is folded and pays off later, on "${boardById(projectForRead, item.boardId)?.name ?? item.boardId}"${item.noteId ? `, at ${episodeLabel(projectForRead, boardsNow, item.boardId, item.noteId)} "${boardsNow[item.boardId]?.notes?.find((note) => note.id === item.noteId)?.headline ?? item.noteId}"` : " — no scene there claims it yet"}`),
+      ...reading.paidBy.map((item) => `  - "${state.notes.find((note) => note.id === item.id)?.headline ?? item.id}" pays off "${item.fromHeadline}" from "${item.fromBoardName}" (${episodeLabel(projectForRead, boardsNow, item.fromBoardId, item.fromNoteId)}), one board earlier`),
       "questions the wall raises:",
       ...(reading.findings.length
         ? reading.findings.map((finding) => `  - [${finding.kind}] ${finding.text}${finding.ids.length ? ` (ids: ${finding.ids.join(", ")})` : ""}`)
@@ -1517,8 +1548,8 @@ server.registerTool(
     const wanted = args.questions?.length ? args.questions : args.kind ? [{ kind: args.kind, ids: args.ids, why: args.why }] : [];
     if (!wanted.length) return ok("Say which question: its kind as read_wall names it (and ids when that kind is asked more than once), or a list under questions.");
     const { state, boardId: leaveBoardId } = await readBoard();
-    const readOptions = { elsewhere: elsewhereIds(leaveBoardId) };
-    const reading = readWall(state, readOptions);
+    const readOptions_ = readOptions(leaveBoardId, state);
+    const reading = readWall(state, readOptions_);
     const replies = [];
     const toLeave = [];
     for (const want of wanted) {
@@ -1558,7 +1589,7 @@ server.registerTool(
       after = out.state;
       for (const item of toLeave) replies.push(`Left, for now: [${item.finding.kind}] ${item.finding.text}${item.why ? ` — "${item.why}"` : ""}`);
     }
-    const still = readWall(after, readOptions).findings;
+    const still = readWall(after, readOptions(leaveBoardId, after)).findings;
     const tail = toLeave.length
       ? `${where(live)} ${once("leave-rule", "The wall keeps the writer's word and asks a left question again on its own when it would read differently; ask_again brings one back now. ")}The wall still asks ${still.length === 0 ? "nothing" : `${still.length}: ${still.map((finding) => `[${finding.kind}] ${finding.text}`).join(" ")}`}.`
       : "";
@@ -1579,7 +1610,7 @@ server.registerTool(
     if (held.length === 0) return ok(`Nothing of kind "${args.kind}"${args.ids ? ` about ids ${args.ids.join(", ")}` : ""} is left. read_wall lists what is, under "left, for now".`);
     const { result, live } = await commit({ type: "ask_again", kind: args.kind, ids: args.ids });
     const again = await readBoard();
-    const reading = readWall(again.state, { elsewhere: elsewhereIds(again.boardId) });
+    const reading = readWall(again.state, readOptions(again.boardId, again.state));
     const back = reading.findings.filter((finding) => held.some((item) => item.kind === finding.kind && sameList(item.ids, finding.ids)));
     return ok(
       `Asked again${where(live)}: ${held.length} question${held.length === 1 ? "" : "s"} of kind "${args.kind}" ${held.length === 1 ? "is" : "are"} no longer left${back.length ? ` — the wall asks ${back.length === 1 ? "it" : `${back.length} of them`} now: ${back.map((finding) => finding.text).join(" ")}` : " — and the wall no longer asks it; the question had already changed"}.`,
@@ -2542,11 +2573,12 @@ server.registerTool(
   {
     title: "Fold the corner",
     description:
-      `Fold the corner of cards — mark them as planting something — or unfold them. ${wordSentence("corner")} The setup arrow is create_arrow with kind 'setup'. A fold that pays off in a later episode: pass later, another board of the project by name, id or number — a board that exists; new_board makes one — and the wall stops asking where it comes back, listing the card under the reading's 'later' instead of 'payoffs'; later '' forgets it. 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'. A fold that pays off in a later episode: pass later, another board of the project by name, id or number — a board that exists; new_board makes one — and, once you know it, at: the scene on that board that pays it off, by id or headline. A board alone is a promise: the reading lists the card under 'later' and, once that board holds cards, asks which scene until one claims it; with at, both boards' readings name the payoff and the paying-off card says so. later '' forgets the board; at '' keeps the board and forgets the scene. set_payoff makes the same claim from the other board. Folding never moves a card.`,
     inputSchema: {
       ids: z.array(z.string()).min(1),
       plants: z.boolean(),
       later: z.string().optional(),
+      at: z.string().optional(),
     },
   },
   async (args) => {
@@ -2554,15 +2586,29 @@ server.registerTool(
     // The kernel cannot check the board exists; this door can, before anything lands.
     let target = null;
     let forgetting = false;
-    if (args.plants && args.later !== undefined) {
-      const { project } = await readProject();
-      const { boardId: current } = await readBoard();
-      if (args.later.trim() === "") {
+    let atNote = null;
+    let atClearing = false;
+    if (args.plants && (args.later !== undefined || args.at !== undefined)) {
+      const { project, boards } = await readProject();
+      const { state: here, boardId: current } = await readBoard();
+      if (args.later !== undefined && args.later.trim() === "") {
         forgetting = true;
       } else {
-        target = findBoard(project, args.later);
+        // `at` alone means the board the fold already names.
+        const key = args.later ?? here.notes.find((note) => args.ids.includes(note.id) && note.payoffBoardId)?.payoffBoardId;
+        if (!key) return ok("Say which board with later before at: a scene belongs to a board.");
+        target = findBoard(project, String(key));
         if (!target) return ok(`No board called "${args.later}" yet. A fold pays off later on a board of the project: new_board "${args.later}" makes it (empty), open_board back to this one, then set_plant again with later.`);
         if (target.id === (current ?? project.activeBoardId)) return ok(`"${target.name}" is this board. A payoff on the same board is a setup arrow: create_arrow from the fold to the scene, kind 'setup'.`);
+        if (args.at !== undefined) {
+          if (args.at.trim() === "") atClearing = true;
+          else {
+            const there = isBoardState(boards[target.id]) ? normalizeState(boards[target.id]) : emptyState();
+            const wanted = args.at.trim().toLowerCase();
+            atNote = there.notes.find((note) => note.id === args.at.trim()) ?? there.notes.find((note) => note.headline.trim().toLowerCase() === wanted) ?? null;
+            if (!atNote) return ok(`No card on "${target.name}" with id or headline "${args.at}". open_board there and list_board for its cards; or leave at out and the fold stays a promise on that board.`);
+          }
+        }
       }
     }
     // The fold and the board it pays off on land as one change: one ⌘Z on the wall.
@@ -2576,10 +2622,14 @@ server.registerTool(
           laterLine = " The board it paid off on is forgotten; read_wall asks again until a setup arrow or a board pays it off.";
         }
       } else if (target) {
-        const named = step({ type: "set_payoff_board", ids: args.ids, boardId: target.id });
+        const named = step({ type: "set_payoff_board", ids: args.ids, boardId: target.id, noteId: atNote?.id ?? null });
         if (named.changed) result = named.result;
         const here = current().notes.filter((note) => args.ids.includes(note.id));
-        laterLine = ` ${here.length} card(s) pay off later, on "${target.name}": read_wall stops asking where they come back, and the card says so.`;
+        laterLine = atNote
+          ? ` ${here.length} card(s) pay off at "${atNote.headline}" on "${target.name}": both boards' readings name it, and that card says what it pays off.`
+          : atClearing
+            ? ` ${here.length} card(s) pay off later, on "${target.name}", and no scene there is claimed: read_wall asks which once that board holds cards.`
+            : ` ${here.length} card(s) pay off later, on "${target.name}": the card says so, and read_wall asks which scene once that board holds cards — set_plant with at, or set_payoff from that board, names it.`;
       }
       return { result, laterLine };
     });
@@ -2597,6 +2647,52 @@ server.registerTool(
 
 // --- Characters -------------------------------------------------------
 
+// The receiving end of a series plant (R58), claimed from the board it lands
+// on: the same record set_plant's `at` writes, on the fold's own card, so one
+// claim has one owner. Two board switches around one frame on the fold's
+// board, which is where undo takes it back.
+server.registerTool(
+  "set_payoff",
+  {
+    title: "Pay off a fold from another board",
+    description:
+      "Say that a card on this board pays off a fold of another board of the project: id (the card here), from (that board, by name, id or number), and fold (the folded card there, by id or headline). The claim is written on the fold's card — the twin of set_plant with later and at — so both boards' readings name it and the card here says what it pays off. fold '' takes back every claim of that board on this card. The wall's other board is opened for the write and this one reopened after; undo on that board takes the claim back.",
+    inputSchema: { id: z.string(), from: z.union([z.string().min(1), z.number()]), fold: z.string() },
+  },
+  async (args) => {
+    const { project, boards } = await readProject();
+    const { state: here, boardId } = await readBoard();
+    const hereId = boardId ?? project.activeBoardId;
+    const card = here.notes.find((note) => note.id === args.id);
+    if (!card) return ok(`No card with id ${args.id} on this board. Call list_board.`);
+    const source = findBoard(project, String(args.from));
+    if (!source) return ok(`No board matches "${args.from}". Call list_boards for the real ones.`);
+    if (source.id === hereId) return ok(`"${source.name}" is this board. A payoff on the same board is a setup arrow: create_arrow from the fold to this card, kind 'setup'.`);
+    const there = isBoardState(boards[source.id]) ? normalizeState(boards[source.id]) : emptyState();
+    const clearing = args.fold.trim() === "";
+    const wanted = args.fold.trim().toLowerCase();
+    const folds = clearing
+      ? there.notes.filter((note) => note.plants && note.payoffBoardId === hereId && note.payoffNoteId === card.id)
+      : [there.notes.find((note) => note.id === args.fold.trim()) ?? there.notes.find((note) => note.headline.trim().toLowerCase() === wanted)].filter(Boolean);
+    if (!folds.length) return ok(clearing ? `No fold of "${source.name}" claims "${card.headline}".` : `No card on "${source.name}" with id or headline "${args.fold}". open_board there and list_board for its cards.`);
+    if (!clearing && !folds[0].plants) return ok(`"${folds[0].headline}" on "${source.name}" is not folded: nothing to pay off. set_plant it there first, with later "${boardById(project, hereId)?.name ?? hereId}".`);
+    const held = await readProject();
+    await openBoardEverywhere(held.project, held.boards, held.rev, held.base, source.id);
+    const { changed } = await commitAll(`set_payoff "${card.headline}"`, (step) => {
+      for (const fold of folds) step({ type: "set_payoff_board", ids: [fold.id], boardId: clearing ? hereId : hereId, noteId: clearing ? null : card.id });
+    });
+    const back = await readProject();
+    const { live } = await openBoardEverywhere(back.project, back.boards, back.rev, back.base, hereId);
+    if (!changed) return ok(`No change: ${clearing ? "nothing was claimed" : `"${folds[0].headline}" already pays off at "${card.headline}"`}.`);
+    return ok(
+      clearing
+        ? `"${card.headline}" no longer pays off ${folds.map((fold) => `"${fold.headline}"`).join(", ")} from "${source.name}"; ${folds.length === 1 ? "that fold is" : "those folds are"} a promise on this board again${where(live)}. This board is open again; undo on "${source.name}" takes it back.`
+        : `"${card.headline}" pays off "${folds[0].headline}" from "${source.name}" (${episodeLabel(project, { ...boards, [hereId]: here }, source.id, folds[0].id)})${where(live)}. The fold's card there says "paid off in ${episodeLabel(project, { ...boards, [hereId]: here }, hereId, card.id)}", this card says what it pays off, and both readings list it. This board is open again; undo on "${source.name}" takes the claim back.`,
+      { fold: folds.map((fold) => fold.id), board: source.id, card: card.id },
+    );
+  },
+);
+
 server.registerTool(
   "add_character",
   {

package/src/board/project.d.ts

@@ -85,6 +85,11 @@ export declare function liftCast(
 ): { project: ProjectRecord; boards: Record<string, BoardState>; changed: boolean };
 export type CastElsewhere = Record<string, Array<{ board: string; boardId: string; cards: number }>>;
 export declare function castElsewhere(project: ProjectRecord, boards: Record<string, BoardState>, activeBoardId: string): CastElsewhere;
+
+/** A fold on another board that lands here (R58): the fold's board, card and colour, and the paying-off card here (null while waiting). */
+export type Landing = { id: string | null; fromBoardId: string; fromBoardName: string; fromNoteId: string; fromHeadline: string; fromColor: string };
+export declare function landingsOn(project: ProjectRecord, boards: Record<string, BoardState>, boardId: string): { paid: Array<Landing & { id: string }>; waiting: Landing[] };
+export declare function laterBoards(project: ProjectRecord, boards: Record<string, BoardState>): Record<string, { name: string; cards: number; noteIds: string[] }>;
 export declare function mergeRoster(
   project: ProjectRecord,
   state: BoardState,

package/src/board/project.js

@@ -220,6 +220,42 @@ export function castElsewhere(project, boards, activeBoardId) {
   return map;
 }
 
+/**
+ * What lands on a board from the folds of the project's other boards (R58):
+ * `paid` — folds that name a scene here, keyed for the paying-off card;
+ * `waiting` — folds that name this board and no scene on it yet (or a scene
+ * that is gone). The receiving board carries no record of its own; this is
+ * composed from the project, the way castElsewhere composes the cast.
+ */
+export function landingsOn(project, boards, boardId) {
+  const here = boards[boardId];
+  const hereIds = new Set((here?.notes ?? []).map((note) => note.id));
+  const paid = [];
+  const waiting = [];
+  for (const meta of project.boards) {
+    if (meta.id === boardId) continue;
+    const state = boards[meta.id];
+    if (!state) continue;
+    for (const note of state.notes) {
+      if (!note.plants || note.payoffBoardId !== boardId) continue;
+      const landing = { fromBoardId: meta.id, fromBoardName: meta.name, fromNoteId: note.id, fromHeadline: note.headline, fromColor: note.color };
+      if (note.payoffNoteId && hereIds.has(note.payoffNoteId)) paid.push({ ...landing, id: note.payoffNoteId });
+      else waiting.push({ ...landing, id: note.payoffNoteId ?? null });
+    }
+  }
+  return { paid, waiting };
+}
+
+/** Every board's name, card count and card ids, for the reading to judge a fold's promise by (R58). */
+export function laterBoards(project, boards) {
+  const map = {};
+  for (const meta of project.boards) {
+    const state = boards[meta.id];
+    map[meta.id] = { name: meta.name, cards: state?.notes?.length ?? 0, noteIds: (state?.notes ?? []).map((note) => note.id) };
+  }
+  return map;
+}
+
 function touch(project, patch, now) {
   return { ...project, ...patch, updatedAt: now };
 }

package/src/board/readWall.d.ts

@@ -61,8 +61,10 @@ export type WallReading = {
   /** Every planted card: the scene that pays it off (first setup arrow, by wall order), or null while unpaid. */
   /** For each folded card, the cards its setup arrows land on, in wall order; empty when unpaid. */
   payoffs: Record<string, string[]>;
-  /** Folded cards that pay off on another board of the project (R50): the card and the board. */
-  later: { id: string; boardId: string }[];
+  /** Folded cards that pay off on another board of the project (R50): the card, the board, and the scene there that claims it (R58) or null while the board is a promise. */
+  later: { id: string; boardId: string; noteId: string | null }[];
+  /** Cards here that pay off a fold of another board (R58), composed by the door from the project. */
+  paidBy: Array<{ id: string; fromBoardId: string; fromBoardName: string; fromNoteId: string; fromHeadline: string; fromColor: string }>;
   /** The questions the wall asks now. A left one (R53) is not here while its words hold. */
   findings: Finding[];
   /** Questions the writer has left, for now: the same question, with when it was left. */
@@ -78,6 +80,10 @@ export declare function readWall(
   options?: {
     /** Cast ids on a card of another board of the project (R51): not asked about as uncast here. */
     elsewhere?: string[];
+    /** Every board of the project by id (R58): a fold's promise is asked about once that board holds cards and no scene claims it. */
+    laterBoards?: Record<string, { name: string; cards: number; noteIds: string[] }>;
+    /** Folds of other boards that land on cards here (R58). */
+    paidBy?: Array<{ id: string; fromBoardId: string; fromBoardName: string; fromNoteId: string; fromHeadline: string; fromColor: string }>;
   },
 ): WallReading;
 export declare function describeRuns(reading: WallReading, state: BoardState): string[];

package/src/board/readWall.js

@@ -165,6 +165,11 @@ export function readWall(state, options = {}) {
   // People on a card of another board of the project (R51) are cast, and
   // are not asked about here.
   const elsewhere = new Set(Array.isArray(options.elsewhere) ? options.elsewhere : []);
+  // The project's other boards, for a fold that pays off later (R58): a board
+  // that holds cards and no claimed scene is a promise the wall asks about.
+  const boardsHeld = options.laterBoards && typeof options.laterBoards === "object" ? options.laterBoards : null;
+  // Folds of other boards that land on a card here (R58), composed by the door.
+  const paidBy = Array.isArray(options.paidBy) ? options.paidBy : [];
   const order = storyOrder(state);
   const beats = order.filter((note) => note.rank === "beat");
 
@@ -380,7 +385,13 @@ export function readWall(state, options = {}) {
   }
   // A fold that pays off on another board (R50) is not unpaid: it is listed
   // under `later`, and the door that knows the project names the board.
-  const later = order.filter((note) => note.plants && note.payoffBoardId).map((note) => ({ id: note.id, boardId: note.payoffBoardId }));
+  const later = order
+    .filter((note) => note.plants && note.payoffBoardId)
+    .map((note) => {
+      const held = boardsHeld?.[note.payoffBoardId];
+      const claimed = Boolean(note.payoffNoteId && (!held || held.noteIds.includes(note.payoffNoteId)));
+      return { id: note.id, boardId: note.payoffBoardId, noteId: claimed ? note.payoffNoteId : null };
+    });
   for (const note of order) {
     if (note.plants && !paysOff.has(note.id) && !note.payoffBoardId) {
       findings.push({
@@ -390,6 +401,20 @@ export function readWall(state, options = {}) {
       });
     }
   }
+  // A board's name is a promise; a scene is the payoff (R58). Once the board
+  // has cards, the wall asks which one, until a scene there claims the fold.
+  for (const item of later) {
+    const held = boardsHeld?.[item.boardId];
+    if (!held || held.cards === 0 || item.noteId) continue;
+    const note = byId.get(item.id);
+    findings.push({
+      kind: "unpaid",
+      ids: [item.id],
+      text: `${quote(note)} pays off later, on "${held.name}", but no scene there claims it yet. Which one?`,
+    });
+  }
+  const hereIds = new Set(order.map((note) => note.id));
+  const paidHere = paidBy.filter((item) => hereIds.has(item.id));
 
   // The cast (R29): someone who vanishes for a stretch, or never appears.
   const total = boardEighths(state);
@@ -463,6 +488,7 @@ export function readWall(state, options = {}) {
     setups,
     payoffs,
     later,
+    paidBy: paidHere,
     findings: asked,
     left,
   };

package/src/board/reducer.d.ts

@@ -81,6 +81,8 @@ export type BoardNote = {
   plants: boolean;
   /** When folded: the id of another board of the project where it pays off (R50), or null. */
   payoffBoardId: string | null;
+  /** The scene on that board that pays it off (R58), or null while the board is only a promise. */
+  payoffNoteId: string | null;
   /** Where the scene happens (R37): a phrase in the writer's words; empty until set. */
   location: string;
   /** When the scene happens, as the writer says it — "night", "day four, dawn" — printed after the place on the heading (R55). Empty when unsaid. */
@@ -184,7 +186,7 @@ export type Command =
   | ({ type: "update_character"; id: string } & Partial<Record<CharacterField, string>>)
   | { type: "set_cast"; ids: string[]; characterIds: string[] }
   | { type: "set_plant"; ids: string[]; plants: boolean }
-  | { type: "set_payoff_board"; ids: string[]; boardId: string | null }
+  | { type: "set_payoff_board"; ids: string[]; boardId: string | null; noteId?: string | null }
   | { type: "set_location"; ids: string[]; location: string }
   | { type: "set_when"; ids: string[]; when: string }
   | { type: "apply_template"; template: string; beats?: Array<{ name: string; prompt: string; at: number }> }

package/src/board/reducer.js

@@ -249,8 +249,10 @@ export function seedState(now = nowIso()) {
     text: "",
     plants: false,
     // A fold that pays off on another board — a later episode — names it here;
-    // null claims nothing (R50).
+    // null claims nothing (R50). The scene there that pays it off, once one
+    // does (R58); null while the board is a promise.
     payoffBoardId: null,
+    payoffNoteId: null,
     createdAt: now,
     updatedAt: now,
   });
@@ -346,6 +348,8 @@ export function normalizeState(value) {
     const plants = note?.plants === true;
     // Cards written before R50 pay off on their own board or not at all.
     const payoffBoardId = plants && typeof note?.payoffBoardId === "string" && note.payoffBoardId ? note.payoffBoardId : null;
+    // Cards written before R58 name a board and no scene on it.
+    const payoffNoteId = payoffBoardId && typeof note?.payoffNoteId === "string" && note.payoffNoteId ? note.payoffNoteId : null;
     // Cards written before R37 have no place; a scene is nowhere until it is.
     const location = typeof note?.location === "string" ? note.location : "";
     // Cards written before R55 have no when; a scene is at no time until it is.
@@ -360,6 +364,7 @@ export function normalizeState(value) {
       sameIds(note.characterIds, characterIds) &&
       note.plants === plants &&
       note.payoffBoardId === payoffBoardId &&
+      note.payoffNoteId === payoffNoteId &&
       note.location === location &&
       note.when === when &&
       note.text === text
@@ -367,7 +372,7 @@ export function normalizeState(value) {
       return note;
     }
     patched = true;
-    return { ...note, rank, lengthEighths, characterIds, plants, payoffBoardId, location, when, text };
+    return { ...note, rank, lengthEighths, characterIds, plants, payoffBoardId, payoffNoteId, location, when, text };
   });
 
   // Boards written before the production half (Roadmap 2, item 8) have no
@@ -453,6 +458,7 @@ export function applyCommand(state, command, now = nowIso()) {
         characterIds: knownCast(command.characterIds, state.characters ?? []),
         plants: command.plants === true,
         payoffBoardId: null,
+        payoffNoteId: null,
         location: cleanPlace(command.location),
         when: cleanWhen(command.when),
         text: typeof command.text === "string" ? command.text : "",
@@ -624,6 +630,7 @@ export function applyCommand(state, command, now = nowIso()) {
           // says what went should say these (round fifteen, entry 17).
           plants: gone.plants === true,
           payoffBoardId: gone.payoffBoardId ?? null,
+          payoffNoteId: gone.payoffNoteId ?? null,
           arrows: taken.map((arrow) => ({ ...arrow, fromHeadline: headlineOf(arrow.from), toHeadline: headlineOf(arrow.to) })),
           joined: joined ? { ...joined, fromHeadline: headlineOf(joined.from), toHeadline: headlineOf(joined.to) } : null,
           groups: left,
@@ -909,6 +916,7 @@ export function applyCommand(state, command, now = nowIso()) {
         characterIds: [],
         plants: false,
         payoffBoardId: null,
+        payoffNoteId: null,
         location: "",
         when: "",
         text: "",
@@ -1040,8 +1048,9 @@ export function applyCommand(state, command, now = nowIso()) {
         if (!ids.has(note.id)) return note;
         // Unfolding forgets where it paid off; a claim that no longer stands.
         const payoffBoardId = plants ? note.payoffBoardId : null;
-        if (note.plants === plants && note.payoffBoardId === payoffBoardId) return note;
-        const next = bump(note, { plants, payoffBoardId }, now);
+        const payoffNoteId = plants ? (note.payoffNoteId ?? null) : null;
+        if (note.plants === plants && note.payoffBoardId === payoffBoardId && note.payoffNoteId === payoffNoteId) return note;
+        const next = bump(note, { plants, payoffBoardId, payoffNoteId }, now);
         touched.push(next);
         return next;
       });
@@ -1053,14 +1062,18 @@ export function applyCommand(state, command, now = nowIso()) {
     // stops asking where it comes back, and the reading says where. The
     // kernel cannot check the board exists; the door that knows the project
     // does. Null takes the claim back.
+    // With noteId, the scene on that board that pays it off (R58): the
+    // receiving end, kept here on the fold so one claim has one owner. A
+    // board alone is a promise; a note is the payoff.
     case "set_payoff_board": {
       const ids = new Set(command.ids);
       if (ids.size === 0) return { state, changed: false };
       const payoffBoardId = typeof command.boardId === "string" && command.boardId ? command.boardId : null;
+      const payoffNoteId = payoffBoardId && typeof command.noteId === "string" && command.noteId ? command.noteId : null;
       const touched = [];
       const notes = state.notes.map((note) => {
-        if (!ids.has(note.id) || !note.plants || note.payoffBoardId === payoffBoardId) return note;
-        const next = bump(note, { payoffBoardId }, now);
+        if (!ids.has(note.id) || !note.plants || (note.payoffBoardId === payoffBoardId && (note.payoffNoteId ?? null) === payoffNoteId)) return note;
+        const next = bump(note, { payoffBoardId, payoffNoteId }, now);
         touched.push(next);
         return next;
       });