[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_228":-5,"_231":232,"_233":234},"routes/shell",{"_40":41,"_227":-5,"_228":-5,"_229":230},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","ad08c5156368cd4136eeef9e134bfe2cd8a82eff","path","apps/server/src/questions/service.ts","oid","83f62d4ca806cf36460dd25d4507ea08d366665c","size",21088,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","/**\n * Questions, as a room offers them.\n *\n * Two things have to stay in step: the record that owns an answer, and the\n * plan document that shows it. The record is authoritative — an agent\n * rewriting the prose around a decision cannot change the decision — but a\n * plan that does not show its own answers is not much of a plan.\n *\n * So resolving is ordered rather than parallel. The answer is claimed, written\n * into the document, and only then committed. If the document write fails the\n * claim is rolled back and the questionnaire is still open, which is a state\n * everyone already knows how to render.\n */\n\nimport { ulid } from \"@chopin/dialect\";\nimport * as Question from \"@chopin/question\";\n\nimport * as Anchors from \"./anchors\";\n\nimport * as room from \"../plan/room\";\nimport * as Store from \"./store\";\nimport { broadcast, fail, relay, reply, tell } from \"../wire\";\n\nimport type { Server } from \"bun\";\n// `Plan` is the room's plan here; the protocol namespace of the same name is\n// aliased so the two cannot be confused at a glance.\nimport type { Plan as Wired, Question as Wire, Request } from \"@chopin/protocol\";\nimport type { Answer, DecisionDefinition, Definition } from \"@chopin/question\";\nimport * as Service from \"../plan/service\";\n\nimport type { Plan } from \"../plan/service\";\nimport type { Socket, SocketData } from \"../wire\";\nimport type { Ended, Questions } from \"./store\";\n\nexport type { Questions } from \"./store\";\n\nexport type AskPlacement = {\n\trevision: number;\n\tblocks: Array>;\n};\n\nexport const create = Store.create;\nexport const dump = Store.dump;\nexport const restore = Store.restore;\nexport type { StoredOpen } from \"./store\";\n\n/**\n * Validate a questionnaire and give it durable identity.\n *\n * The domain assigns positional ids — `q0`, `o1` — which are fine while a\n * questionnaire is a single tool result and useless the moment it is a node in\n * a document the agent will rewrite around. Identity is minted once, here,\n * before anything references it.\n */\nexport function identify(raw: unknown): Definition {\n\tlet definition = Question.normalize(raw);\n\treturn {\n\t\tquestions: definition.questions.map(question => ({\n\t\t\t...question,\n\t\t\tid: ulid(),\n\t\t\toptions: question.options.map(option => ({ ...option, id: ulid() })),\n\t\t})),\n\t};\n}\n\n/** A questionnaire as it is stored beside the plan, so it survives a restart. */\nexport type Record = {\n\tid: string;\n\tdefinition: Definition;\n\tstatus: \"open\" | \"answered\" | \"cancelled\";\n\t/** Question id to the answer as it reads, for projection into the plan. */\n\tanswers?: { [question: string]: string };\n\tresolver?: string;\n\t/** When it was settled, Unix seconds. Absent on one settled before we recorded it. */\n\tat?: number;\n\t/** Where in the prose each of its decisions lives. */\n\tanchors?: Wired.WidgetAnchors;\n\t/**\n\t * Option-append idempotency keys to the option each created. Bounded by the\n\t * option limit, and durable so a retry after a restart still finds it.\n\t */\n\tappended?: { [key: string]: string };\n};\n\nfunction decide(\n\tentry: { status: \"answered\"; answers: Answer[] } | { status: \"cancelled\" },\n\tdefinition: Definition,\n): { [question: string]: string } {\n\tif (entry.status !== \"answered\") return {};\n\tlet out: { [question: string]: string } = {};\n\tdefinition.questions.forEach((question, index) => {\n\t\tlet answer = entry.answers[index];\n\t\tif (answer) out[question.id] = Question.summarize(answer);\n\t});\n\treturn out;\n}\n\n/** Ask each decision independently; register its record before publishing its node. */\nexport async function ask(\n\tplan: Plan,\n\tserver: Server,\n\troomId: string,\n\tdefinition: Definition,\n\tplacement?: AskPlacement,\n\tcreated?: () => void,\n): Promise {\n\tif (Service.implementationActive(plan)) throw new Error(\"implementation is active\");\n\tif (definition.questions.length === 0) {\n\t\tQuestion.reject(\"A questionnaire needs at least one question\");\n\t}\n\tlet asked: Array<{\n\t\tid: string;\n\t\tsingle: DecisionDefinition;\n\t\tvalue: room.QuestionnaireInsertion[\"value\"];\n\t\twaiting: Promise;\n\t\tat: room.QuestionnaireInsertion[\"at\"];\n\t}> = [];\n\tawait Service.exclusive(plan, async () => {\n\t\tlet anchors = placement ? validatePlacement(plan, definition, placement) : undefined;\n\t\tasked = definition.questions.map((question, index) => {\n\t\t\tlet single = Question.decision({ questions: [question] });\n\t\t\t// Widget and question identities are deliberately distinct.\n\t\t\tlet id = ulid();\n\t\t\tlet waiting = Store.ask(plan.questions, id, single, id);\n\t\t\tlet value = {\n\t\t\t\tid,\n\t\t\t\tquestions: [{\n\t\t\t\t\tid: question.id,\n\t\t\t\t\theader: question.header,\n\t\t\t\t\tprompt: question.question,\n\t\t\t\t\tmultiple: question.multiple,\n\t\t\t\t\toptions: question.options.map(option => ({\n\t\t\t\t\t\tid: option.id,\n\t\t\t\t\t\tlabel: option.label,\n\t\t\t\t\t\t...(option.description ? { description: option.description } : {}),\n\t\t\t\t\t})),\n\t\t\t\t}],\n\t\t\t};\n\t\t\tlet record: Record = { id, definition: single, status: \"open\" };\n\t\t\tif (anchors) {\n\t\t\t\trecord.anchors = Anchors.set(Anchors.read(record), question.id, anchors[index]!);\n\t\t\t}\n\t\t\tplan.records.set(id, record);\n\t\t\treturn { id, single, value, waiting, at: placement?.blocks[index]?.[0] };\n\t\t});\n\n\t\tlet mutation = room.insertQuestionnaires(\n\t\t\tplan.document,\n\t\t\tasked.map(item => ({\n\t\t\t\tvalue: item.value,\n\t\t\t\t...(item.at ? { at: item.at } : {}),\n\t\t\t})),\n\t\t);\n\t\tif (mutation) await Service.publish(plan, server, roomId, mutation);\n\t\telse await Service.persistExclusive(plan);\n\t\tfor (let item of asked) {\n\t\t\tbroadcast(server, roomId, {\n\t\t\t\tkind: \"question:asked\",\n\t\t\t\tts: 0,\n\t\t\t\tid: item.id,\n\t\t\t\tdefinition: item.single,\n\t\t\t\twidget: item.id,\n\t\t\t});\n\t\t}\n\t\tcreated?.();\n\t});\n\n\treturn Promise.all(asked.map(item => item.waiting));\n}\n\n/** Validate every placement before registering records or document nodes. */\nfunction validatePlacement(\n\tplan: Plan,\n\tdefinition: Definition,\n\tplacement: AskPlacement,\n): Wired.Anchor[][] {\n\tif (placement.revision !== plan.revision) {\n\t\tthrow new Error(\"The plan changed; read it again before asking.\");\n\t}\n\tif (placement.blocks.length !== definition.questions.length) {\n\t\tthrow new Error(\"Give one placement for every question.\");\n\t}\n\n\tlet digests = room.digests(plan.document);\n\treturn placement.blocks.map(blocks => {\n\t\tif (blocks.length === 0) {\n\t\t\tif (room.hasProse(plan.document)) {\n\t\t\t\tthrow new Error(\"Relate each question to prose, or write its context first.\");\n\t\t\t}\n\t\t\treturn [];\n\t\t}\n\n\t\treturn blocks.map(block => {\n\t\t\tlet current = digests[block.index];\n\t\t\tif (!current) throw new Error(`no block at index ${block.index}`);\n\t\t\tif (current !== block.digest) {\n\t\t\t\tthrow new Error(`block ${block.index} has changed; read the plan again`);\n\t\t\t}\n\t\t\treturn room.anchorAt(plan.document, block.index, current);\n\t\t});\n\t});\n}\n\n/** Everything still unanswered, for a client that has just joined. */\nexport function greet(plan: Plan, ws: Socket): void {\n\tlet open = Store.outstanding(plan.questions);\n\tif (open.length === 0) return;\n\ttell(ws, { kind: \"question:sync\", ts: 0, open });\n}\n\nexport function open(plan: Plan, ws: Socket, msg: Request): void {\n\treply(ws, msg.rid, { kind: \"question:open\", ts: 0, ...Store.snapshot(plan.questions, msg.id) });\n}\n\nexport function edit(plan: Plan, ws: Socket, msg: Request): void | Promise {\n\tlet outcome = Store.edit(plan.questions, msg.id, msg.patch);\n\tlet finish = () => {\n\t\treply(ws, msg.rid, { kind: \"question:edit\", ts: 0, id: msg.id, ...outcome });\n\t\t// A no-op patch is acknowledged but not relayed: peers have nothing to do\n\t\t// with it and it did not move the revision.\n\t\tif (!outcome.open || !outcome.accepted || !outcome.applied) return;\n\t\trelay(ws, {\n\t\t\tkind: \"question:edit\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\topen: true,\n\t\t\taccepted: true,\n\t\t\tapplied: true,\n\t\t\trevision: outcome.revision,\n\t\t\tpatch: msg.patch,\n\t\t\teditor: ws.data.handle,\n\t\t});\n\t};\n\tif (outcome.open && outcome.accepted && outcome.applied) {\n\t\treturn Service.persist(plan).then(finish, () => {\n\t\t\tfail(ws, msg.rid, \"could not save questionnaire draft\");\n\t\t});\n\t}\n\tfinish();\n}\n\nexport function focus(plan: Plan, ws: Socket, msg: Wire.Presence.Input): void {\n\tlet person = {\n\t\tclient: ws.data.client,\n\t\thandle: ws.data.handle,\n\t\t...(msg.question ? { question: msg.question } : {}),\n\t\t...(msg.field ? { field: msg.field } : {}),\n\t};\n\tif (!Store.focus(plan.questions, msg.id, person)) return;\n\trelay(ws, { kind: \"question:presence\", ts: 0, ...person, id: msg.id });\n}\n\nexport function away(plan: Plan, ws: Socket): void {\n\tfor (let id of Store.away(plan.questions, ws.data.client)) {\n\t\trelay(ws, {\n\t\t\tkind: \"question:presence\",\n\t\t\tts: 0,\n\t\t\tid,\n\t\t\tclient: ws.data.client,\n\t\t\thandle: ws.data.handle,\n\t\t});\n\t}\n}\n\nexport async function submit(\n\tplan: Plan,\n\tserver: Server,\n\troomId: string,\n\tws: Socket,\n\tmsg: Request,\n): Promise {\n\tif (Service.implementationActive(plan)) return fail(ws, msg.rid, \"implementation is active\");\n\tlet claimed = Store.claimSubmit(plan.questions, msg.id, msg.revision, ws.data.handle);\n\tif (!claimed.ok) {\n\t\treturn reply(ws, msg.rid, { kind: \"question:submit\", ts: 0, id: msg.id, ...claimed });\n\t}\n\n\tlet record = plan.records.get(msg.id);\n\tlet answers = record\n\t\t? decide({ status: \"answered\", answers: claimed.answers }, record.definition)\n\t\t: {};\n\n\t// Stamped once and used in both places, so the record and the plan cannot\n\t// disagree about when the room decided.\n\tlet at = Math.floor(Date.now() / 1_000);\n\tlet settled = { by: ws.data.handle, at: new Date(at * 1_000).toISOString() };\n\tlet mutationError: unknown;\n\tlet finish: (() => Store.Ended) | undefined;\n\tawait Service.exclusive(plan, async () => {\n\t\tlet mutation: room.Mutation | undefined;\n\t\ttry {\n\t\t\tmutation = room.projectAnswer(plan.document, msg.id, answers, settled);\n\t\t} catch (err) {\n\t\t\tmutationError = err;\n\t\t\treturn;\n\t\t}\n\t\tif (record) {\n\t\t\tplan.records.set(msg.id, {\n\t\t\t\t...record,\n\t\t\t\tstatus: \"answered\",\n\t\t\t\tanswers,\n\t\t\t\tresolver: ws.data.handle,\n\t\t\t\tat,\n\t\t\t});\n\t\t}\n\t\tfinish = Store.stage(plan.questions, claimed.claim);\n\t\tif (mutation) await Service.publish(plan, server, roomId, mutation);\n\t\telse await Service.persistExclusive(plan);\n\t});\n\tif (mutationError) {\n\t\t// The decision is not final if the plan could not be told about it.\n\t\tStore.rollback(plan.questions, claimed.claim);\n\t\treturn reply(ws, msg.rid, {\n\t\t\tkind: \"question:submit\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\tok: false,\n\t\t\treason: \"invalid\",\n\t\t\tmessage: mutationError instanceof Error\n\t\t\t\t? mutationError.message\n\t\t\t\t: \"could not record the answer\",\n\t\t});\n\t}\n\tfinish!();\n\n\treply(ws, msg.rid, {\n\t\tkind: \"question:submit\",\n\t\tts: 0,\n\t\tid: msg.id,\n\t\tok: true,\n\t\tanswers: claimed.answers,\n\t\tresolver: ws.data.handle,\n\t});\n\tbroadcast(server, roomId, {\n\t\tkind: \"question:resolved\",\n\t\tts: 0,\n\t\tid: msg.id,\n\t\tstatus: \"answered\",\n\t\tresolver: ws.data.handle,\n\t\tanswers: claimed.answers,\n\t});\n}\n\nconst ADD_OPTION_REFUSAL: { [reason in \"resolved\" | \"resolving\"]: string } = {\n\tresolved: \"This question has already been decided\",\n\tresolving: \"This question is being decided\",\n};\n\n/**\n * Append an option to an open question, for everyone.\n *\n * Ordering follows the rest of this module: the record, the open entry and the\n * plan projection change together under the plan's exclusive queue, the fenced\n * commit happens, and only then does anyone hear about it. The shared draft is\n * not touched, so nothing another member has already chosen can change.\n */\nexport async function addOption(\n\tplan: Plan,\n\tserver: Server,\n\troomId: string,\n\tws: Socket,\n\tmsg: Request,\n): Promise {\n\tlet refuse = (reason: Wire.AddOption.Refusal, message: string) =>\n\t\treply(ws, msg.rid, {\n\t\t\tkind: \"question:option\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\tok: false,\n\t\t\treason,\n\t\t\tmessage,\n\t\t});\n\tif (Service.implementationActive(plan)) {\n\t\treturn refuse(\"implementation\", \"An implementation is running; decisions cannot change\");\n\t}\n\n\tlet outcome: Wire.AddOption.Reply | undefined;\n\tlet added: Wire.OptionAdded | undefined;\n\tawait Service.exclusive(plan, async () => {\n\t\tlet record = plan.records.get(msg.id);\n\t\tlet entry = Store.get(plan.questions, msg.id);\n\t\tif (!record || !entry || record.status !== \"open\") {\n\t\t\toutcome = {\n\t\t\t\tkind: \"question:option\",\n\t\t\t\tts: 0,\n\t\t\t\tid: msg.id,\n\t\t\t\tok: false,\n\t\t\t\treason: \"resolved\",\n\t\t\t\tmessage: ADD_OPTION_REFUSAL.resolved,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tlet applied = typeof msg.key === \"string\" && Object.hasOwn(record.appended ?? {}, msg.key)\n\t\t\t? record.appended![msg.key]\n\t\t\t: undefined;\n\t\tlet existing = applied\n\t\t\t? entry.definition.questions[0].options.find(option => option.id === applied)\n\t\t\t: undefined;\n\t\tif (existing) {\n\t\t\toutcome = {\n\t\t\t\tkind: \"question:option\",\n\t\t\t\tts: 0,\n\t\t\t\tid: msg.id,\n\t\t\t\tok: true,\n\t\t\t\toption: existing,\n\t\t\t\tdefinition: entry.definition,\n\t\t\t\trepeated: true,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tif (entry.claim) {\n\t\t\toutcome = {\n\t\t\t\tkind: \"question:option\",\n\t\t\t\tts: 0,\n\t\t\t\tid: msg.id,\n\t\t\t\tok: false,\n\t\t\t\treason: \"resolving\",\n\t\t\t\tmessage: ADD_OPTION_REFUSAL.resolving,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\n\t\tlet result = Question.appendOption(entry.definition, {\n\t\t\tquestion: msg.question,\n\t\t\tkey: msg.key,\n\t\t\tlabel: msg.label,\n\t\t\t...(msg.description === undefined ? {} : { description: msg.description }),\n\t\t}, ulid());\n\t\tif (!result.ok) {\n\t\t\toutcome = {\n\t\t\t\tkind: \"question:option\",\n\t\t\t\tts: 0,\n\t\t\t\tid: msg.id,\n\t\t\t\tok: false,\n\t\t\t\treason: result.reason,\n\t\t\t\tmessage: result.message,\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\n\t\tlet previous = { record, definition: entry.definition };\n\t\tlet mutation: room.Mutation | undefined;\n\t\ttry {\n\t\t\tmutation = room.appendQuestionOption(plan.document, msg.id, msg.question, result.option);\n\t\t} catch (err) {\n\t\t\tconsole.error(\"[questions] could not add the option to the plan:\", err);\n\t\t\toutcome = {\n\t\t\t\tkind: \"question:option\",\n\t\t\t\tts: 0,\n\t\t\t\tid: msg.id,\n\t\t\t\tok: false,\n\t\t\t\treason: \"invalid\",\n\t\t\t\tmessage: \"Could not add the option\",\n\t\t\t};\n\t\t\treturn;\n\t\t}\n\t\tplan.records.set(msg.id, {\n\t\t\t...record,\n\t\t\tdefinition: result.definition,\n\t\t\tappended: { ...record.appended, [msg.key]: result.option.id },\n\t\t});\n\t\tStore.redefine(plan.questions, msg.id, result.definition);\n\t\ttry {\n\t\t\tif (mutation) await Service.publish(plan, server, roomId, mutation);\n\t\t\telse await Service.persistExclusive(plan);\n\t\t} catch (err) {\n\t\t\tplan.records.set(msg.id, previous.record);\n\t\t\tStore.restoreDefinition(plan.questions, msg.id, previous.definition);\n\t\t\tthrow err;\n\t\t}\n\t\toutcome = {\n\t\t\tkind: \"question:option\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\tok: true,\n\t\t\toption: result.option,\n\t\t\tdefinition: result.definition,\n\t\t};\n\t\tadded = {\n\t\t\tkind: \"question:option-added\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\tquestion: msg.question,\n\t\t\toption: result.option,\n\t\t\tdefinition: result.definition,\n\t\t\tby: ws.data.handle,\n\t\t};\n\t}).catch(err => {\n\t\tconsole.error(\"[questions] could not save the option:\", err);\n\t\toutcome = undefined;\n\t\tadded = undefined;\n\t});\n\n\tif (!outcome) return fail(ws, msg.rid, \"could not save the option\");\n\treply(ws, msg.rid, outcome);\n\tif (added) broadcast(server, roomId, added);\n}\n\n/**\n * Decline to answer.\n *\n * Terminal, and the node leaves the plan: a questionnaire cannot say it was\n * cancelled, so left in place it would read as one still waiting. The record\n * survives as history.\n */\nexport async function cancel(\n\tplan: Plan,\n\tserver: Server,\n\troomId: string,\n\tws: Socket,\n\tmsg: Request,\n): Promise {\n\tif (Service.implementationActive(plan)) return fail(ws, msg.rid, \"implementation is active\");\n\tlet claimed = Store.claimCancel(plan.questions, msg.id, ws.data.handle);\n\tif (!claimed.ok) {\n\t\treturn reply(ws, msg.rid, { kind: \"question:cancel\", ts: 0, id: msg.id, ...claimed });\n\t}\n\tlet mutationError: unknown;\n\tlet finish: (() => Store.Ended) | undefined;\n\tawait Service.exclusive(plan, async () => {\n\t\tlet mutation: room.Mutation | undefined;\n\t\ttry {\n\t\t\tmutation = room.removeQuestionnaire(plan.document, msg.id);\n\t\t} catch (err) {\n\t\t\tmutationError = err;\n\t\t\treturn;\n\t\t}\n\t\tlet record = plan.records.get(msg.id);\n\t\tif (record) {\n\t\t\tplan.records.set(msg.id, { ...record, status: \"cancelled\", resolver: ws.data.handle });\n\t\t}\n\t\tfinish = Store.stage(plan.questions, claimed.claim);\n\t\tif (mutation) await Service.publish(plan, server, roomId, mutation);\n\t\telse await Service.persistExclusive(plan);\n\t});\n\tif (mutationError) {\n\t\t// The questionnaire stays open and answerable, which is a state every\n\t\t// client already renders. Saying \"resolving\" is honest: the attempt is\n\t\t// over, and trying again is the right move.\n\t\tconsole.error(\"[questions] could not remove the node:\", mutationError);\n\t\tStore.rollback(plan.questions, claimed.claim);\n\t\treturn reply(ws, msg.rid, {\n\t\t\tkind: \"question:cancel\",\n\t\t\tts: 0,\n\t\t\tid: msg.id,\n\t\t\tok: false,\n\t\t\treason: \"resolving\",\n\t\t});\n\t}\n\tfinish!();\n\n\treply(ws, msg.rid, {\n\t\tkind: \"question:cancel\",\n\t\tts: 0,\n\t\tid: msg.id,\n\t\tok: true,\n\t\tresolver: ws.data.handle,\n\t});\n\tbroadcast(server, roomId, {\n\t\tkind: \"question:resolved\",\n\t\tts: 0,\n\t\tid: msg.id,\n\t\tstatus: \"cancelled\",\n\t\tresolver: ws.data.handle,\n\t});\n}\n\nexport function shutdown(questions: Questions): void {\n\tStore.shutdown(questions);\n}\n\n// -- relationships ---------------------------------------------------------\n\n/** Every questionnaire's relationships, as an authoritative snapshot. */\nexport function anchors(plan: Plan): Wired.WidgetAnchors[] {\n\treturn [...plan.records.values()].map(record => Anchors.read(record));\n}\n\n/**\n * Bring every relationship forward onto the document as it is now.\n *\n * Called after anything that moves prose around, which is most things. An\n * anchor whose block survived is re-expressed against it; one whose block was\n * rewritten is orphaned, and the agent is told it owes a review.\n */\nexport function rebase(plan: Plan): void {\n\tfor (let [id, record] of plan.records) {\n\t\tlet value = Anchors.read(record);\n\t\tlet questions: { [question: string]: Wired.AnchorSet } = {};\n\n\t\tfor (let [question, set] of Object.entries(value.questions)) {\n\t\t\tquestions[question] = carry(plan, set);\n\t\t}\n\n\t\tplan.records.set(id, { ...record, anchors: { widget: value.widget, questions } });\n\t}\n}\n\nfunction carry(plan: Plan, set: Wired.AnchorSet): Wired.AnchorSet {\n\tlet anchors = room.rebase(plan.document, set.anchors);\n\tlet lost = anchors.some(anchor => anchor.orphaned);\n\treturn {\n\t\tanchors,\n\t\tpending: set.pending || lost,\n\t\t...(lost ? { reason: \"orphaned\" as const } : set.reason ? { reason: set.reason } : {}),\n\t};\n}\n\n/** Mark answered results as needing review, after the plan changed beneath them. */\nexport function invalidate(plan: Plan, reason: Wired.AnchorReason): void {\n\tfor (let [id, record] of plan.records) {\n\t\tplan.records.set(id, { ...record, anchors: Anchors.invalidate(record, reason) });\n\t}\n}\n\n/** What the agent still owes a review on. */\nexport function outstanding(plan: Plan): Anchors.Pending[] {\n\treturn [...plan.records.values()].flatMap(record => Anchors.pending(record));\n}\n\n/** Replace where a decision lives with the blocks the agent reviewed it against. */\nexport function relate(\n\tplan: Plan,\n\twidget: string,\n\tquestion: string,\n\tblocks: Array<{ index: number; digest: string }>,\n): string | undefined {\n\tlet record = plan.records.get(widget);\n\tif (!record) return `no questionnaire ${widget}`;\n\n\tlet current = room.digests(plan.document);\n\tlet anchors: Wired.Anchor[] = [];\n\n\tfor (let block of blocks) {\n\t\tlet hash = current[block.index];\n\t\tif (!hash) return `no block at index ${block.index}`;\n\t\t// The digest is how the agent says which block it meant. If it does not\n\t\t// match, the plan moved between reading and anchoring, and quietly\n\t\t// anchoring the block that happens to be there now would be worse than\n\t\t// saying so.\n\t\tif (hash !== block.digest) return `block ${block.index} has changed; read the plan again`;\n\t\tanchors.push(room.anchorAt(plan.document, block.index, hash));\n\t}\n\n\tplan.records.set(widget, {\n\t\t...record,\n\t\tanchors: Anchors.set(Anchors.read(record), question, anchors),\n\t});\n\treturn undefined;\n}\n\nexport type Placement = {\n\twidget: string;\n\tblocks: Array<{ index: number; digest: string }>;\n};\n\n/** Move cards after their first related block, preserving ask order per block. */\nexport function place(plan: Plan, updates: Placement[]): room.Mutation | undefined {\n\tlet records = [...plan.records.values()];\n\tlet placements: room.QuestionnairePlacement[] = [];\n\tlet byWidget = new Map(updates.map(update => [update.widget, update]));\n\n\tfor (let record of records) {\n\t\tlet update = byWidget.get(record.id);\n\t\tif (!update || record.definition.questions.length !== 1 || update.blocks.length === 0) continue;\n\n\t\tlet home = update.blocks[0]!;\n\t\tlet before = records.slice(0, records.indexOf(record)).findLast(candidate => {\n\t\t\tif (candidate.definition.questions.length !== 1) return false;\n\t\t\tlet question = candidate.definition.questions[0];\n\t\t\tif (!question) return false;\n\t\t\tlet anchor = Anchors.read(candidate).questions[question.id]?.anchors[0];\n\t\t\treturn anchor !== undefined && room.matchesAnchor(plan.document, anchor, home.index);\n\t\t});\n\n\t\tplacements.push({ id: update.widget, at: home, ...(before ? { after: before.id } : {}) });\n\t}\n\n\treturn room.placeQuestionnaires(plan.document, placements);\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[183,184,185,186,187,188,189,190,191,192,193,194,195],"navigation",{"_54":55,"_139":140,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150},"sources",[],"viewer","meta",{"_131":132,"_133":134,"_135":136,"_42":31,"_137":126,"_138":31,"_48":49,"_50":49},"branches",[73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130],"tags",[69,70,71,72],"cloneUrl","https://git.nexthub.sh/githubnext/chopin.git","color-controls-slice-1","color-controls-slice-2","color-controls-slice-3","color-controls-slice-4","Krzysztof-Cieslak-patch-1","Krzysztof-Cieslak-patch-2","Maggie/app-preview-toolkit","Maggie/ci-playwright-install-timeout","Maggie/collaborative-visual-decision","Maggie/design-audit","Maggie/generic-visual-decision-runtime","Maggie/impeccable-chopin-metadata","Maggie/jev-chat-product","Maggie/jev-composed-assessment","Maggie/native-document-layouts","Maggie/openui-composition-product","Maggie/openui-composition-trial","Maggie/planner-visual-authoring","Maggie/planner-visual-requests","Maggie/visual-selection-eval","artifacts/pr-419-live-preview-20261009","automation/pr-maintenance-state","automation/use-effect/callout-disabled-picker-8cf9e49ba5c09471","automation/use-effect/collaboration-options-ref-4e3a5a08a879a5ae","automation/use-effect/room-workspace-effective-access-a57d40866c71bed0","chore/bun-1.4.2","color-controls","color-controls-plan","comments","design-pr-assets","design/archived-decisions-badge","design/channel-route-remount","design/chat-decision-entry","design/conversation-analysis-markers","design/decision-evidence","design/settled-line-icon","dev/integration","diagram-step-controls","feat/liveapp-frontend-pilot","feat/local-experiments","feat/local-launcher-tracer","fix/autolink-mdx-crash","github-pills/2-pills","github-pills/3-hover-card","maggie/app-preview-toolkit","maggie/ci-playwright-install-timeout","maggie/collaborative-visual-decision","maggie/design-audit","maggie/generic-visual-decision-runtime","maggie/impeccable-chopin-metadata","maggie/jev-composed-assessment","maggie/native-document-layouts","maggie/openui-composition-product","maggie/openui-composition-trial","maggie/planner-visual-authoring","maggie/planner-visual-requests","maggie/visual-selection-eval","main","plain-text-fence-chrome","tokens/09-copy","wireframes/2-renderer","wireframes/3-planner","description","Let's compose rich plans together","owner","githubnext","section","","head","empty","pins",[165,166,167],"documents",{"_160":161,"_162":163},"code",{"_156":157,"_158":159},"automations",{"_153":154,"_155":-5},"delivery",{"_151":49,"_152":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_164":163},"total",11,"issue",{"_168":158,"_170":181,"_15":158,"_172":182,"_52":174,"_175":31,"_176":174,"_177":159},{"_168":178,"_170":179,"_15":178,"_172":180,"_52":174,"_175":31,"_176":174,"_177":49},{"_168":169,"_170":171,"_15":169,"_172":173,"_52":174,"_175":31,"_176":174,"_177":163},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_168":158,"_170":181,"_15":158,"_172":226,"_52":174,"_175":31,"_176":174},{"_168":178,"_170":179,"_15":178,"_172":225,"_52":174,"_175":31,"_176":174},{"_168":169,"_170":171,"_15":169,"_172":224,"_52":174,"_175":31,"_176":174},{"_168":221,"_170":222,"_15":221,"_172":223,"_52":31,"_175":31,"_176":174},{"_168":218,"_170":219,"_15":218,"_172":220,"_52":31,"_175":31,"_176":174},{"_168":153,"_170":216,"_15":145,"_172":217,"_52":31,"_175":31,"_176":174},{"_168":155,"_170":213,"_15":214,"_172":215,"_52":31,"_175":31,"_176":174},{"_168":151,"_170":211,"_15":151,"_172":212,"_52":31,"_175":31,"_176":174},{"_168":207,"_170":208,"_15":209,"_172":210,"_52":31,"_175":31,"_176":174},{"_168":141,"_170":205,"_15":141,"_172":206,"_52":31,"_175":31,"_176":31},{"_168":202,"_170":203,"_15":202,"_172":204,"_52":31,"_175":31,"_176":31},{"_168":199,"_170":200,"_15":199,"_172":201,"_52":31,"_175":31,"_176":31},{"_168":196,"_170":197,"_15":196,"_172":198,"_52":31,"_175":31,"_176":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794536677153,"sidebar","expanded"]