[{"_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","de83e3bbcdc3294abd7004ecd572082ee22fda36","path","apps/server/src/questions/service.ts","oid","54d03288c99f6ebc62854dabb6aa156f878cbe31","size",14464,"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, 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, 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 const create = Store.create;\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};\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/**\n * Ask one or more decisions, and put each in the plan.\n *\n * One planning turn may need several answers, but every answer has its own\n * lifecycle: people can save or cancel one without making the others final.\n * Each record is registered before its node exists, because a client receiving\n * the plan update will immediately try to open it and must not be told there\n * is no such thing.\n */\nexport async function ask(\n\tplan: Plan,\n\tserver: Server,\n\troomId: string,\n\tdefinition: Definition,\n): Promise {\n\tif (definition.questions.length === 0) {\n\t\tQuestion.reject(\"A questionnaire needs at least one question\");\n\t}\n\n\tlet waiting = definition.questions.map(question => {\n\t\tlet single = { questions: [question] };\n\t\t// Its own identity, not borrowed from the question. They are different\n\t\t// things, and a lookup that matched either would be a bug waiting for a\n\t\t// question whose id happened to resemble its widget's.\n\t\tlet id = ulid();\n\t\tlet settled = Store.ask(plan.questions, id, single, id);\n\n\t\t// The dialect calls the question text `prompt`; the domain calls it\n\t\t// `question`. Translating here keeps the document's vocabulary its own.\n\t\tlet mutation = room.insertQuestionnaire(plan.document, {\n\t\t\tid,\n\t\t\tquestions: [{\n\t\t\t\tid: question.id,\n\t\t\t\theader: question.header,\n\t\t\t\tprompt: question.question,\n\t\t\t\tmultiple: question.multiple,\n\t\t\t\toptions: question.options.map(option => ({\n\t\t\t\t\tid: option.id,\n\t\t\t\t\tlabel: option.label,\n\t\t\t\t\t...(option.description ? { description: option.description } : {}),\n\t\t\t\t})),\n\t\t\t}],\n\t\t});\n\n\t\tplan.records.set(id, { id, definition: single, status: \"open\" });\n\t\tif (mutation) Service.publish(plan, server, roomId, mutation);\n\t\tbroadcast(server, roomId, {\n\t\t\tkind: \"question:asked\",\n\t\t\tts: 0,\n\t\t\tid,\n\t\t\tdefinition: single,\n\t\t\twidget: id,\n\t\t});\n\t\treturn settled;\n\t});\n\n\t// Promise.all retains the planner's order even when people settle cards in\n\t// another order, so each returned outcome still names the ask that made it.\n\treturn Promise.all(waiting);\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 {\n\tlet outcome = Store.edit(plan.questions, msg.id, msg.patch);\n\treply(ws, msg.rid, { kind: \"question:edit\", ts: 0, id: msg.id, ...outcome });\n\n\t// A no-op patch is acknowledged but not relayed: peers have nothing to do\n\t// with it and it did not move the revision.\n\tif (!outcome.open || !outcome.accepted || !outcome.applied) return;\n\n\trelay(ws, {\n\t\tkind: \"question:edit\",\n\t\tts: 0,\n\t\tid: msg.id,\n\t\topen: true,\n\t\taccepted: true,\n\t\tapplied: true,\n\t\trevision: outcome.revision,\n\t\tpatch: msg.patch,\n\t\teditor: ws.data.handle,\n\t});\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\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\n\ttry {\n\t\tlet mutation = room.projectAnswer(plan.document, msg.id, answers, settled);\n\t\tif (mutation) Service.publish(plan, server, roomId, mutation);\n\t} catch (err) {\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: err instanceof Error ? err.message : \"could not record the answer\",\n\t\t});\n\t}\n\n\tStore.commit(plan.questions, claimed.claim);\n\tif (record) {\n\t\tplan.records.set(msg.id, {\n\t\t\t...record,\n\t\t\tstatus: \"answered\",\n\t\t\tanswers,\n\t\t\tresolver: ws.data.handle,\n\t\t\tat,\n\t\t});\n\t}\n\tplan.sink.touch();\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\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\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\n\ttry {\n\t\tlet mutation = room.removeQuestionnaire(plan.document, msg.id);\n\t\tif (mutation) Service.publish(plan, server, roomId, mutation);\n\t} catch (err) {\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:\", err);\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\n\tStore.commit(plan.questions, claimed.claim);\n\tlet record = plan.records.get(msg.id);\n\tif (record) {\n\t\tplan.records.set(msg.id, { ...record, status: \"cancelled\", resolver: ws.data.handle });\n\t}\n\tplan.sink.touch();\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\tquestion: string;\n\tblocks: Array<{ index: number; digest: string }>;\n};\n\n/**\n * Move the canonical cards that the planner just related.\n *\n * The first related block is the card's home in the plan; the full anchor set\n * still drives the count, wash, and Show in plan walk. Records are inserted in\n * ask order, so cards sharing a home stay in the planner's original sequence.\n */\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",1794572086795,"sidebar","expanded"]