[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_229":-5,"_232":233,"_234":235},"routes/shell",{"_42":43,"_228":-5,"_229":-5,"_230":231},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":31,"_45":31,"_46":31,"_47":31,"_48":31,"_49":31,"_50":51,"_52":51,"_53":31,"_54":-7,"_55":-7,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70},"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","c487fb33414bd2219c5b08125a6680aeba9f0f68","path","apps/server/src/tasks/graphs.ts","oid","f8dc9393d9c5f7699c6a055d81137345947403f0","size",8068,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","/**\n * Durable implementation work belongs beside a plan, not inside its prose.\n *\n * The adapter owns document lookup and persistence. This model only decides\n * whether a graph is valid and which version may change at a given plan\n * revision, so a hosted backend can use the same rules as the local one.\n */\n\nexport type Task = {\n\tid: string;\n\ttitle: string;\n\tcontext: string;\n\tgoal: string;\n\tacceptance: string[];\n\tdependsOn: string[];\n};\n\nexport type Definition = {\n\ttasks: Task[];\n};\n\nexport type State = \"draft\" | \"approved\" | \"locked\" | \"superseded\";\n\nexport type Version = {\n\tnumber: number;\n\tplanRevision: number;\n\tstate: State;\n\tdefinition: Definition;\n};\n\nexport type Graph = {\n\tversions: Version[];\n};\n\nexport type GraphAdapter = {\n\t/** Runs the change against one current graph and plan revision. */\n\ttransact(\n\t\tdocument: Document,\n\t\tchange: (current: { graph: Graph | undefined; revision: number | undefined }) => Result,\n\t): Promise>;\n};\n\nexport type Result = { ok: true; value: T } | { ok: false; reason: string };\n\ntype Validation = Exclude, { ok: true }>;\n\nfunction copy(value: T): T {\n\treturn structuredClone(value);\n}\n\nfunction invalid(reason: string): Validation {\n\treturn { ok: false, reason };\n}\n\nfunction text(value: string): boolean {\n\treturn value.trim().length > 0;\n}\n\n/** Validate references before looking for cycles, for useful refusal reasons. */\nexport function validate(definition: unknown): Result {\n\tif (\n\t\t!definition || typeof definition !== \"object\"\n\t\t|| !Array.isArray((definition as Definition).tasks)\n\t) {\n\t\treturn invalid(\"task\");\n\t}\n\tlet valid = definition as Definition;\n\tlet ids = new Set();\n\tfor (let task of valid.tasks) {\n\t\tif (\n\t\t\t!task || typeof task !== \"object\" || !Array.isArray(task.acceptance)\n\t\t\t|| !Array.isArray(task.dependsOn)\n\t\t) {\n\t\t\treturn invalid(\"task\");\n\t\t}\n\t\tif (\n\t\t\ttypeof task.id !== \"string\" || typeof task.title !== \"string\"\n\t\t\t|| typeof task.context !== \"string\"\n\t\t\t|| typeof task.goal !== \"string\" || task.dependsOn.some(item => typeof item !== \"string\")\n\t\t) {\n\t\t\treturn invalid(\"task\");\n\t\t}\n\t\tif (!text(task.id) || !text(task.title) || !text(task.context) || !text(task.goal)) {\n\t\t\treturn invalid(\"task\");\n\t\t}\n\t\tif (ids.has(task.id)) return invalid(\"duplicate\");\n\t\tids.add(task.id);\n\t\tif (\n\t\t\ttask.acceptance.length < 2 || task.acceptance.length > 8\n\t\t\t|| task.acceptance.some(criterion => typeof criterion !== \"string\" || !text(criterion))\n\t\t) return invalid(\"acceptance\");\n\t}\n\n\tfor (let task of valid.tasks) {\n\t\tfor (let dependency of task.dependsOn) {\n\t\t\tif (!ids.has(dependency)) return invalid(\"missing\");\n\t\t\tif (dependency === task.id) return invalid(\"self\");\n\t\t}\n\t}\n\tlet visiting = new Set();\n\tlet visited = new Set();\n\tlet tasks = new Map(valid.tasks.map(task => [task.id, task]));\n\tfunction visit(id: string): boolean {\n\t\tif (visiting.has(id)) return true;\n\t\tif (visited.has(id)) return false;\n\t\tvisiting.add(id);\n\t\tlet cycle = tasks.get(id)?.dependsOn.some(visit) ?? false;\n\t\tvisiting.delete(id);\n\t\tvisited.add(id);\n\t\treturn cycle;\n\t}\n\n\tif (valid.tasks.some(task => visit(task.id))) return invalid(\"cycle\");\n\tif (\n\t\tvalid.tasks.length === 0 || !valid.tasks.some(task => task.dependsOn.length === 0)\n\t) {\n\t\treturn invalid(\"root\");\n\t}\n\treturn { ok: true, value: copy(valid) };\n}\n\nfunction current(graph: Graph): Version | undefined {\n\treturn graph.versions.at(-1);\n}\n\n/** Read a graph back from a sidecar without trusting handwritten JSON. */\nexport function restore(value: unknown): Graph | undefined {\n\tif (!value || typeof value !== \"object\" || !Array.isArray((value as Graph).versions)) {\n\t\treturn undefined;\n\t}\n\tlet graph = value as Graph;\n\tif (graph.versions.length === 0) return undefined;\n\tfor (let [index, version] of graph.versions.entries()) {\n\t\tif (\n\t\t\t!version || typeof version !== \"object\" || version.number !== index + 1\n\t\t\t|| !Number.isInteger(version.planRevision) || version.planRevision < 0\n\t\t\t|| ![\"draft\", \"approved\", \"locked\", \"superseded\"].includes(version.state)\n\t\t\t|| !validate(version.definition).ok\n\t\t) return undefined;\n\t}\n\treturn copy(graph);\n}\n\n/**\n * Mutations go through this service rather than directly to a snapshot. The\n * caller gives it an adapter so graph state remains a backend concern and\n * never becomes an MDX node.\n */\nexport class Graphs {\n\t#adapter: GraphAdapter;\n\n\tconstructor(adapter: GraphAdapter) {\n\t\tthis.#adapter = adapter;\n\t}\n\n\tasync #transact(\n\t\tdocument: Document,\n\t\tchange: (current: { graph: Graph | undefined; revision: number | undefined }) => Result,\n\t): Promise> {\n\t\tlet result = await this.#adapter.transact(document, current => {\n\t\t\tlet next = change({\n\t\t\t\tgraph: current.graph && copy(current.graph),\n\t\t\t\trevision: current.revision,\n\t\t\t});\n\t\t\treturn next.ok ? { ok: true, value: copy(next.value) } : next;\n\t\t});\n\t\treturn result.ok ? { ok: true, value: copy(result.value) } : result;\n\t}\n\n\tasync create(document: Document, definition: Definition): Promise> {\n\t\treturn await this.#transact(document, ({ graph, revision }) => {\n\t\t\tif (graph) return { ok: false, reason: \"exists\" };\n\t\t\tif (revision === undefined) return { ok: false, reason: \"missing-document\" };\n\t\t\tlet checked = validate(definition);\n\t\t\tif (!checked.ok) return checked;\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tvalue: {\n\t\t\t\t\tversions: [{\n\t\t\t\t\t\tnumber: 1,\n\t\t\t\t\t\tplanRevision: revision,\n\t\t\t\t\t\tstate: \"draft\",\n\t\t\t\t\t\tdefinition: checked.value,\n\t\t\t\t\t}],\n\t\t\t\t},\n\t\t\t};\n\t\t});\n\t}\n\n\tasync edit(document: Document, definition: Definition): Promise> {\n\t\treturn await this.#transact(document, ({ graph, revision }) => {\n\t\t\tlet version = graph && current(graph);\n\t\t\tif (!graph || !version) return { ok: false, reason: \"missing\" };\n\t\t\tif (version.state === \"locked\") return { ok: false, reason: \"locked\" };\n\t\t\tif (version.state === \"superseded\") return { ok: false, reason: \"superseded\" };\n\t\t\tif (revision === undefined) return { ok: false, reason: \"missing-document\" };\n\t\t\tlet checked = validate(definition);\n\t\t\tif (!checked.ok) return checked;\n\n\t\t\tif (version.state === \"draft\") {\n\t\t\t\tgraph.versions[graph.versions.length - 1] = {\n\t\t\t\t\t...graph.versions[graph.versions.length - 1],\n\t\t\t\t\tplanRevision: revision,\n\t\t\t\t\tdefinition: checked.value,\n\t\t\t\t};\n\t\t\t} else {\n\t\t\t\tgraph.versions.push({\n\t\t\t\t\tnumber: version.number + 1,\n\t\t\t\t\tplanRevision: revision,\n\t\t\t\t\tstate: \"draft\",\n\t\t\t\t\tdefinition: checked.value,\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn { ok: true, value: graph };\n\t\t});\n\t}\n\n\tasync approve(document: Document): Promise> {\n\t\treturn await this.#transact(document, ({ graph, revision }) => {\n\t\t\tlet version = graph && current(graph);\n\t\t\tif (!graph || !version) return { ok: false, reason: \"missing\" };\n\t\t\tif (version.state !== \"draft\") return { ok: false, reason: \"not-draft\" };\n\t\t\tif (revision === undefined) return { ok: false, reason: \"missing-document\" };\n\t\t\tif (version.planRevision !== revision) return { ok: false, reason: \"stale-plan\" };\n\t\t\tlet checked = validate(version.definition);\n\t\t\tif (!checked.ok) return checked;\n\n\t\t\tfor (let prior of graph.versions) {\n\t\t\t\tif (prior.state === \"approved\") prior.state = \"superseded\";\n\t\t\t}\n\t\t\tgraph.versions[graph.versions.length - 1] = {\n\t\t\t\t...graph.versions[graph.versions.length - 1],\n\t\t\t\tstate: \"approved\",\n\t\t\t\tdefinition: checked.value,\n\t\t\t};\n\t\t\treturn { ok: true, value: graph };\n\t\t});\n\t}\n\n\tasync start(document: Document): Promise> {\n\t\treturn await this.#transact(document, ({ graph, revision }) => {\n\t\t\tlet version = graph && current(graph);\n\t\t\tif (!graph || !version) return { ok: false, reason: \"missing\" };\n\t\t\tif (version.state !== \"approved\") return { ok: false, reason: \"not-approved\" };\n\t\t\tif (revision === undefined) return { ok: false, reason: \"missing-document\" };\n\t\t\tif (version.planRevision !== revision) return { ok: false, reason: \"stale-plan\" };\n\n\t\t\tgraph.versions[graph.versions.length - 1] = {\n\t\t\t\t...graph.versions[graph.versions.length - 1],\n\t\t\t\tstate: \"locked\",\n\t\t\t};\n\t\t\treturn { ok: true, value: graph };\n\t\t});\n\t}\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","organization",true,"site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[184,185,186,187,188,189,190,191,192,193,194,195,196],"navigation",{"_56":57,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150,"_151":152},"sources",[],"viewer","meta",{"_133":134,"_135":136,"_137":138,"_44":31,"_139":128,"_140":31,"_50":51,"_52":51},"branches",[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,131,132],"tags",[71,72,73,74],"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",[167,168,169],"documents",{"_162":163,"_164":165},"code",{"_158":159,"_160":161},"automations",{"_155":156,"_157":-5},"delivery",{"_153":51,"_154":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_166":165},"total",11,"issue",{"_170":160,"_172":182,"_15":160,"_174":183,"_54":41,"_176":31,"_177":41,"_178":161},{"_170":179,"_172":180,"_15":179,"_174":181,"_54":41,"_176":31,"_177":41,"_178":51},{"_170":171,"_172":173,"_15":171,"_174":175,"_54":41,"_176":31,"_177":41,"_178":165},"id","issues","name","Issues","filters",{},"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_170":160,"_172":182,"_15":160,"_174":227,"_54":41,"_176":31,"_177":41},{"_170":179,"_172":180,"_15":179,"_174":226,"_54":41,"_176":31,"_177":41},{"_170":171,"_172":173,"_15":171,"_174":225,"_54":41,"_176":31,"_177":41},{"_170":222,"_172":223,"_15":222,"_174":224,"_54":31,"_176":31,"_177":41},{"_170":219,"_172":220,"_15":219,"_174":221,"_54":31,"_176":31,"_177":41},{"_170":155,"_172":217,"_15":147,"_174":218,"_54":31,"_176":31,"_177":41},{"_170":157,"_172":214,"_15":215,"_174":216,"_54":31,"_176":31,"_177":41},{"_170":153,"_172":212,"_15":153,"_174":213,"_54":31,"_176":31,"_177":41},{"_170":208,"_172":209,"_15":210,"_174":211,"_54":31,"_176":31,"_177":41},{"_170":143,"_172":206,"_15":143,"_174":207,"_54":31,"_176":31,"_177":31},{"_170":203,"_172":204,"_15":203,"_174":205,"_54":31,"_176":31,"_177":31},{"_170":200,"_172":201,"_15":200,"_174":202,"_54":31,"_176":31,"_177":31},{"_170":197,"_172":198,"_15":197,"_174":199,"_54":31,"_176":31,"_177":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794611751931,"sidebar","expanded"]