[{"_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","b770bd2d73e574dc736bd75d303b0f0feb4d8564","path","packages/protocol/plan.d.ts","oid","92d7a44c310e4600755962412861800d0d82713b","size",10823,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","import type { Frame, Request } from \"./index\";\n\ntype KIND = Frame & { kind: K };\n\n/**\n * The collaborative document.\n *\n * A plan is a Yjs document with a headless Lexical mirror on the server. The\n * server is the sole bootstrapper and the only authority on what the document\n * contains: clients send updates and are told whether they were accepted, but\n * never seed, and never decide.\n *\n * Binary payloads travel base64. There is one socket, it carries JSON, and a\n * text frame is legible in a network inspector when something goes wrong.\n */\nexport declare namespace Plan {\n\texport type Incoming = Request | Request | Awareness | Close;\n\n\texport type Outgoing =\n\t\t| Open.Reply\n\t\t| Ack\n\t\t| (Update & { sender?: string })\n\t\t| (Awareness & { sender?: string })\n\t\t| Anchors\n\t\t| Changes\n\t\t| Reset\n\t\t| Lifecycle;\n\n\t/**\n\t * A decision's place in the prose.\n\t *\n\t * A decision is settled in the sidecar and lives in the plan, and those are\n\t * two different places. Anchoring is what lets a reader move between them.\n\t *\n\t * The position is a Yjs relative position, so it survives edits above it.\n\t * The digest is the block's full canonical hash, which is how a position\n\t * that can no longer be resolved — after a move, or an epoch rotation — is\n\t * matched back to the block it meant.\n\t */\n\texport type Anchor = {\n\t\t/** The Yjs history `position` can be resolved in. */\n\t\tepoch: string;\n\t\t/** base64 `Y.encodeRelativePosition` of the anchored block. */\n\t\tposition: string;\n\t\t/** Canonical hash of the block, for rebasing. */\n\t\tdigest: string;\n\t\t/** Kept rather than guessed at when neither position nor digest resolves. */\n\t\torphaned?: true;\n\t};\n\n\t/** Why a relationship is not currently trustworthy. */\n\texport type AnchorReason =\n\t\t/** Never anchored. */\n\t\t| \"missing\"\n\t\t/** The plan changed beneath it. */\n\t\t| \"plan_changed\"\n\t\t/** The block it named is gone, or is no longer unique. */\n\t\t| \"orphaned\";\n\n\texport type AnchorSet = {\n\t\tanchors: Anchor[];\n\t\t/** True when the agent has yet to review this since the last change. */\n\t\tpending: boolean;\n\t\treason?: AnchorReason;\n\t};\n\n\t/**\n\t * Where each of a questionnaire's decisions lives in the plan.\n\t *\n\t * One set per question, not two. A question used to carry what it was about\n\t * and what its answer produced separately, on the theory that the two move\n\t * independently — and the agent, asked to tell them apart, anchored the\n\t * first block of the second and called it the first. What a reader wants is\n\t * the prose the decision lives in, which is what an accepted comment has\n\t * always carried.\n\t */\n\texport type WidgetAnchors = {\n\t\twidget: string;\n\t\tquestions: { [question: string]: AnchorSet };\n\t};\n\n\t/**\n\t * A phrase of the plan, as a comment marks it.\n\t *\n\t * An anchor names a whole block, which is the right grain for a decision but\n\t * not for a remark about one sentence in it. So a passage is the block run\n\t * plus a range inside it, and the range is expressed twice for the same\n\t * reason an anchor is: `start` and `end` are Yjs relative positions, so the\n\t * highlight stretches as somebody types inside the phrase, and `quote` is\n\t * what finds it again when they cannot be resolved — after a move, or an\n\t * epoch rotation.\n\t *\n\t * `quote` is a bounded locator rather than the whole phrase. `length` is the\n\t * real extent, so a passage longer than the bound is still recoverable:\n\t * find the prefix, then run on.\n\t */\n\texport type Passage = {\n\t\t/** The blocks it covers, first to last. */\n\t\tblocks: Anchor[];\n\t\t/** base64 `Y.encodeRelativePosition` of the range's start, in the first block. */\n\t\tstart: string;\n\t\t/** base64 `Y.encodeRelativePosition` of its end, in the last. */\n\t\tend: string;\n\t\t/** Bounded prefix of the marked text. */\n\t\tquote: string;\n\t\t/** Where the quote began, so a phrase repeated in one block is not guessed at. */\n\t\toffset: number;\n\t\t/** Characters the passage covers, across the whole run. */\n\t\tlength: number;\n\t\t/** Neither the positions nor the quote resolve. Kept rather than dropped. */\n\t\tdrifted?: true;\n\t};\n\n\t/**\n\t * What an accepted comment thread marks, and what accepting it produced.\n\t *\n\t * A thread keeps two, where a question keeps one, because these two have\n\t * different authors and so different shapes. `subject` is the passage a\n\t * person selected, and the server keeps it moving with the plan. `result`\n\t * is the prose the agent's revision produced, and only the agent can say\n\t * what that is — so it is an ordinary anchor set, reviewed and pending\n\t * exactly like a question's. Neither can stand for the other: a thread's\n\t * subject is usually the prose it asked to have rewritten.\n\t */\n\texport type ThreadAnchors = {\n\t\tthread: string;\n\t\tsubject: Passage;\n\t\tresult: AnchorSet;\n\t};\n\n\t/** Authoritative replacement snapshot of every relationship in the plan. */\n\texport type Anchors = KIND<\"plan:anchors\"> & {\n\t\tepoch: string;\n\t\twidgets: WidgetAnchors[];\n\t\tthreads: ThreadAnchors[];\n\t};\n\n\t/**\n\t * A place between blocks, named by the block still beside it.\n\t *\n\t * What the agent took out has no anchor of its own: a relative position\n\t * needs a live collaborative type and the departed block's is gone. So a\n\t * gap is described by a survivor and the side the content was on. That the\n\t * plan can never be emptied is what guarantees a survivor exists.\n\t */\n\texport type Gap = {\n\t\tat: Anchor;\n\t\tside: \"before\" | \"after\";\n\t};\n\n\t/** Enough of a block to recognise it in a list. */\n\texport type Excerpt = {\n\t\t/** The MDAST node type, or the component name for a dialect block. */\n\t\ttype: string;\n\t\t/** Bounded flattened text. */\n\t\tpreview: string;\n\t};\n\n\t/**\n\t * One thing the agent did to the plan, as a reader can find it.\n\t *\n\t * A move is one change rather than a disappearance and an arrival, because\n\t * a reader who is shown those separately has to work out for themselves\n\t * that they are the same block. A rewrite is `added` alone: something is\n\t * still there to look at, and marking a gap as well would put a tombstone\n\t * on the most common edit the agent makes.\n\t */\n\texport type Change =\n\t\t| ({ kind: \"added\"; at: Anchor } & Excerpt)\n\t\t| ({ kind: \"moved\"; at: Anchor; from: Gap } & Excerpt)\n\t\t| { kind: \"removed\"; at: Gap; blocks: Excerpt[] };\n\n\t/**\n\t * What the agent just did to the plan.\n\t *\n\t * Ephemeral, and deliberately not replayed on open: somebody arriving\n\t * afterwards is reading the plan, not watching it being written.\n\t */\n\texport type Changes = KIND<\"plan:changes\"> & {\n\t\tepoch: string;\n\t\tchanges: Change[];\n\t};\n\n\t/**\n\t * Bounds the server enforces, sent on open.\n\t *\n\t * Clients hold the same numbers so they can refuse early with the same\n\t * answer, rather than guessing and discovering the limit by rejection.\n\t */\n\texport type Limits = {\n\t\tsource: number;\n\t\tupdate: number;\n\t\tdepth: number;\n\t};\n\n\t/**\n\t * Join the document.\n\t *\n\t * A client that already holds state for `epoch` sends its state vector and\n\t * receives only the difference. Any other case — no epoch, or one the\n\t * server has since rotated — gets the whole document under the current one.\n\t */\n\texport namespace Open {\n\t\texport type Ask = KIND<\"plan:open\"> & {\n\t\t\tepoch?: string;\n\t\t\t/** base64 `Y.encodeStateVector` */\n\t\t\tvector?: string;\n\t\t};\n\n\t\texport type Reply = KIND<\"plan:open\"> & {\n\t\t\t/** Identifies one Yjs history. Updates from another are rejected. */\n\t\t\tepoch: string;\n\t\t\t/** Monotonic within an epoch. Useful for ordering and diagnostics. */\n\t\t\tseq: number;\n\t\t\t/** base64 `Y.encodeStateAsUpdate`, diffed against `vector` when given. */\n\t\t\tupdate: string;\n\t\t\t/** base64 awareness snapshot of everyone already connected. */\n\t\t\tawareness?: string;\n\t\t\t/** Document revision, for the agent's optimistic concurrency. */\n\t\t\trevision: number;\n\t\t\t/** Which prose each decision relates to, as an authoritative snapshot. */\n\t\t\tanchors: WidgetAnchors[];\n\t\t\t/** Which prose each comment thread marks, on the same terms. */\n\t\t\tthreads: ThreadAnchors[];\n\t\t\tlimits: Limits;\n\t\t};\n\t}\n\n\t/**\n\t * Submit a Yjs update.\n\t *\n\t * `id` makes a retry after a lost acknowledgement idempotent, so a client\n\t * that reconnects mid-flight can resend without risking a duplicate edit.\n\t */\n\texport type Submit = KIND<\"plan:update\"> & {\n\t\tepoch: string;\n\t\tid: string;\n\t\t/** base64 Yjs update */\n\t\tupdate: string;\n\t};\n\n\t/**\n\t * Confirms one submitted update.\n\t *\n\t * Separate from {@link Update} so the bytes are not echoed back to the\n\t * client that already applied them locally.\n\t */\n\texport type Ack = KIND<\"plan:ack\"> & {\n\t\tepoch: string;\n\t\tid: string;\n\t\tseq: number;\n\t};\n\n\t/** A committed update, relayed to everyone else. */\n\texport type Update = KIND<\"plan:update\"> & {\n\t\tepoch: string;\n\t\t/** base64 Yjs update */\n\t\tupdate: string;\n\t\tseq: number;\n\t};\n\n\t/** Ephemeral presence: cursors, selections, focus. Never persisted. */\n\texport type Awareness = KIND<\"plan:awareness\"> & {\n\t\tepoch: string;\n\t\t/** base64 y-protocols awareness update */\n\t\tupdate: string;\n\t};\n\n\t/** Leave the document. Presence is dropped; the room stays open. */\n\texport type Close = KIND<\"plan:close\">;\n\n\t/**\n\t * The epoch was replaced and local state is no longer valid.\n\t *\n\t * Clients discard their document and re-open. Undo history and cursors are\n\t * intentionally lost — this is the boundary where continuity ends.\n\t */\n\texport type Reset = KIND<\"plan:reset\"> & {\n\t\tepoch: string;\n\t\treason:\n\t\t\t/** Content was replaced wholesale. */\n\t\t\t| \"replaced\"\n\t\t\t/** A member cleared the plan. */\n\t\t\t| \"cleared\"\n\t\t\t/** History outgrew its budget and was compacted. */\n\t\t\t| \"compacted\"\n\t\t\t/** An update did not validate and the room was rebuilt. */\n\t\t\t| \"rebuilt\";\n\t};\n\n\t/** Durable implementation activity, published only after persistence. */\n\texport type Lifecycle = KIND<\"plan:lifecycle\"> & {\n\t\texecution: { state: \"idle\" | \"active\" };\n\t\tactivity?: ImplementationProgress;\n\t\thistory: Array<{\n\t\t\trun: {\n\t\t\t\tid: string;\n\t\t\t\tuser: string;\n\t\t\t\tclient: { name: string; version: string };\n\t\t\t\tsession: string;\n\t\t\t\tplanRevision: number;\n\t\t\t\tgraphVersion: number;\n\t\t\t\tgraphRevision: number;\n\t\t\t\trepository: string;\n\t\t\t\tbranch: string;\n\t\t\t\tcommit: string;\n\t\t\t\tstartedAt: string;\n\t\t\t};\n\t\t\tprogress: ImplementationProgress;\n\t\t\toutcome:\n\t\t\t\t| { kind: \"revision_requested\"; reason: string }\n\t\t\t\t| { kind: \"implemented\" }\n\t\t\t\t| { kind: \"delivered\" };\n\t\t}>;\n\t};\n\n\texport type Verification = {\n\t\tpassed: boolean;\n\t\tsummary: string;\n\t\treviewerMethod: string;\n\t\tevidence: Array<{ taskId: string; evidence: string[] }>;\n\t\ttasksNeedingWork: string[];\n\t};\n\n\texport type ImplementationProgress = {\n\t\ttasks: Array<{\n\t\t\tid: string;\n\t\t\tstate: \"queued\" | \"in_progress\" | \"blocked\" | \"completed\";\n\t\t\tblocker?: string;\n\t\t\tsummary?: string;\n\t\t\tpullRequest?: { url: string; state: \"open\" | \"merged\" | \"closed\" };\n\t\t}>;\n\t\tevents: Array<{ idempotencyKey: string; kind: string }>;\n\t\tverification?: Verification;\n\t};\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",1794437730928,"sidebar","expanded"]