[{"data":1,"prerenderedAt":4111},["ShallowReactive",2],{"navigation_docs":3,"-guides-run-coming-from-1-4":639,"-guides-run-coming-from-1-4-surround":4106},[4,32,71,234,285,600],{"title":5,"path":6,"stem":7,"children":8},"Get started","\u002Fget-started","1.get-started",[9,12,16,20,24,28],{"title":10,"path":6,"stem":11},"Overview","1.get-started\u002Findex",{"title":13,"path":14,"stem":15},"Why Kraft","\u002Fget-started\u002Fwhy-kraft","1.get-started\u002F0.why-kraft",{"title":17,"path":18,"stem":19},"Install","\u002Fget-started\u002Finstall","1.get-started\u002F1.install",{"title":21,"path":22,"stem":23},"Your first work item","\u002Fget-started\u002Ffirst-work-item","1.get-started\u002F2.first-work-item",{"title":25,"path":26,"stem":27},"The real chain","\u002Fget-started\u002Fthe-real-chain","1.get-started\u002F3.the-real-chain",{"title":29,"path":30,"stem":31},"FAQ","\u002Fget-started\u002Ffaq","1.get-started\u002F4.faq",{"title":33,"path":34,"stem":35,"children":36},"Concepts","\u002Fconcepts","2.concepts",[37,39,43,47,51,55,59,63,67],{"title":10,"path":34,"stem":38},"2.concepts\u002Findex",{"title":40,"path":41,"stem":42},"How a work item runs","\u002Fconcepts\u002Fhow-a-work-item-runs","2.concepts\u002F1.how-a-work-item-runs",{"title":44,"path":45,"stem":46},"Caps and budgets","\u002Fconcepts\u002Fcaps-and-budgets","2.concepts\u002F2.caps-and-budgets",{"title":48,"path":49,"stem":50},"Why a permission gate","\u002Fconcepts\u002Fpermission-gate","2.concepts\u002F3.permission-gate",{"title":52,"path":53,"stem":54},"Vocabulary","\u002Fconcepts\u002Fvocabulary","2.concepts\u002F4.vocabulary",{"title":56,"path":57,"stem":58},"Where a step runs","\u002Fconcepts\u002Fwhere-a-step-runs","2.concepts\u002F5.where-a-step-runs",{"title":60,"path":61,"stem":62},"How review and CI waits settle","\u002Fconcepts\u002Fhow-review-and-ci-waits-settle","2.concepts\u002F6.how-review-and-ci-waits-settle",{"title":64,"path":65,"stem":66},"How test scopes run","\u002Fconcepts\u002Fhow-test-scopes-run","2.concepts\u002F7.how-test-scopes-run",{"title":68,"path":69,"stem":70},"How workers and machines behave","\u002Fconcepts\u002Fhow-workers-and-machines-behave","2.concepts\u002F8.how-workers-and-machines-behave",{"title":72,"path":73,"stem":74,"children":75},"Guides","\u002Fguides","3.guides",[76,78,120,146,168,230],{"title":10,"path":73,"stem":77},"3.guides\u002Findex",{"title":79,"path":80,"stem":81,"children":82},"Day to day","\u002Fguides\u002Fday-to-day","3.guides\u002F1.day-to-day\u002Findex",[83,84,88,92,96,100,104,108,112,116],{"title":10,"path":80,"stem":81},{"title":85,"path":86,"stem":87},"Split work into slices","\u002Fguides\u002Fday-to-day\u002Fsplit-work-into-slices","3.guides\u002F1.day-to-day\u002F1.split-work-into-slices",{"title":89,"path":90,"stem":91},"The setup wizard on first start","\u002Fguides\u002Fday-to-day\u002Ffirst-run","3.guides\u002F1.day-to-day\u002F2.first-run",{"title":93,"path":94,"stem":95},"File a work item","\u002Fguides\u002Fday-to-day\u002Ffile-a-work-item","3.guides\u002F1.day-to-day\u002F3.file-a-work-item",{"title":97,"path":98,"stem":99},"Use Kraft from your agent","\u002Fguides\u002Fday-to-day\u002Fagent-integration","3.guides\u002F1.day-to-day\u002F4.agent-integration",{"title":101,"path":102,"stem":103},"Reviewing a change","\u002Fguides\u002Fday-to-day\u002Freview-a-change","3.guides\u002F1.day-to-day\u002F5.review-a-change",{"title":105,"path":106,"stem":107},"Raise a cap on a stopped item","\u002Fguides\u002Fday-to-day\u002Fraise-a-cap","3.guides\u002F1.day-to-day\u002F6.raise-a-cap",{"title":109,"path":110,"stem":111},"Kraft for VS Code","\u002Fguides\u002Fday-to-day\u002Fvscode","3.guides\u002F1.day-to-day\u002F7.vscode",{"title":113,"path":114,"stem":115},"Reach the board from your phone","\u002Fguides\u002Fday-to-day\u002Fkraft-on-a-phone","3.guides\u002F1.day-to-day\u002F8.kraft-on-a-phone",{"title":117,"path":118,"stem":119},"Get notified when an item needs you","\u002Fguides\u002Fday-to-day\u002Fnotifications","3.guides\u002F1.day-to-day\u002F9.notifications",{"title":121,"path":122,"stem":123,"children":124},"Customize and automate","\u002Fguides\u002Fcustomize","3.guides\u002F2.customize\u002Findex",[125,126,130,134,138,142],{"title":10,"path":122,"stem":123},{"title":127,"path":128,"stem":129},"Write your own chain","\u002Fguides\u002Fcustomize\u002Fwrite-your-own-chain","3.guides\u002F2.customize\u002F1.write-your-own-chain",{"title":131,"path":132,"stem":133},"Add a security review or a gate reviewer","\u002Fguides\u002Fcustomize\u002Fadd-review-agents","3.guides\u002F2.customize\u002F2.add-review-agents",{"title":135,"path":136,"stem":137},"Schedule or webhook work","\u002Fguides\u002Fcustomize\u002Fschedule-and-webhook-work","3.guides\u002F2.customize\u002F3.schedule-and-webhook-work",{"title":139,"path":140,"stem":141},"Share chains with add-ons","\u002Fguides\u002Fcustomize\u002Fshare-chains-with-addons","3.guides\u002F2.customize\u002F4.share-chains-with-addons",{"title":143,"path":144,"stem":145},"Publish an add-on","\u002Fguides\u002Fcustomize\u002Fpublish-an-add-on","3.guides\u002F2.customize\u002F5.publish-an-add-on",{"title":147,"path":148,"stem":149,"children":150},"Agents and harnesses","\u002Fguides\u002Fharnesses","3.guides\u002F3.harnesses\u002Findex",[151,152,156,160,164],{"title":10,"path":148,"stem":149},{"title":153,"path":154,"stem":155},"Switch a task to another harness","\u002Fguides\u002Fharnesses\u002Fswitch-harness","3.guides\u002F3.harnesses\u002F1.switch-harness",{"title":157,"path":158,"stem":159},"Add or override a harness","\u002Fguides\u002Fharnesses\u002Fadding-a-harness","3.guides\u002F3.harnesses\u002F2.adding-a-harness",{"title":161,"path":162,"stem":163},"Build a worker Kit","\u002Fguides\u002Fharnesses\u002Fworker-kit","3.guides\u002F3.harnesses\u002F3.worker-kit",{"title":165,"path":166,"stem":167},"Give a worker its login","\u002Fguides\u002Fharnesses\u002Fgive-a-worker-its-login","3.guides\u002F3.harnesses\u002F4.give-a-worker-its-login",{"title":169,"path":170,"stem":171,"children":172},"Run the server","\u002Fguides\u002Frun","3.guides\u002F4.run\u002Findex",[173,174,178,182,186,190,194,198,202,206,210,214,218,222,226],{"title":10,"path":170,"stem":171},{"title":175,"path":176,"stem":177},"Remote access","\u002Fguides\u002Frun\u002Fremote-access","3.guides\u002F4.run\u002F01.remote-access",{"title":179,"path":180,"stem":181},"Put a proxy in front of Kraft","\u002Fguides\u002Frun\u002Fput-a-proxy-in-front-of-kraft","3.guides\u002F4.run\u002F02.put-a-proxy-in-front-of-kraft",{"title":183,"path":184,"stem":185},"Restart Kraft without ending running steps","\u002Fguides\u002Frun\u002Frestart-kraft","3.guides\u002F4.run\u002F03.restart-kraft",{"title":187,"path":188,"stem":189},"Back up and restore the database","\u002Fguides\u002Frun\u002Fback-up-and-restore","3.guides\u002F4.run\u002F04.back-up-and-restore",{"title":191,"path":192,"stem":193},"Find the logs","\u002Fguides\u002Frun\u002Ffind-the-logs","3.guides\u002F4.run\u002F05.find-the-logs",{"title":195,"path":196,"stem":197},"Run Kraft as a service","\u002Fguides\u002Frun\u002Frun-as-a-service","3.guides\u002F4.run\u002F06.run-as-a-service",{"title":199,"path":200,"stem":201},"Upgrade Kraft","\u002Fguides\u002Frun\u002Fupgrade-kraft","3.guides\u002F4.run\u002F07.upgrade-kraft",{"title":203,"path":204,"stem":205},"Move onto kraft-default","\u002Fguides\u002Frun\u002Fupgrade-your-configuration","3.guides\u002F4.run\u002F08.upgrade-your-configuration",{"title":207,"path":208,"stem":209},"Coming from 1.4","\u002Fguides\u002Frun\u002Fcoming-from-1-4","3.guides\u002F4.run\u002F09.coming-from-1-4",{"title":211,"path":212,"stem":213},"Free disk space","\u002Fguides\u002Frun\u002Ffree-disk-space","3.guides\u002F4.run\u002F10.free-disk-space",{"title":215,"path":216,"stem":217},"Rotate the token","\u002Fguides\u002Frun\u002Frotate-the-token","3.guides\u002F4.run\u002F11.rotate-the-token",{"title":219,"path":220,"stem":221},"Run items in your own checkout","\u002Fguides\u002Frun\u002Frun-items-in-place","3.guides\u002F4.run\u002F12.run-items-in-place",{"title":223,"path":224,"stem":225},"Run a step on another machine","\u002Fguides\u002Frun\u002Frun-a-step-on-another-machine","3.guides\u002F4.run\u002F13.run-a-step-on-another-machine",{"title":227,"path":228,"stem":229},"Use the console from another machine","\u002Fguides\u002Frun\u002Fuse-the-console-from-another-machine","3.guides\u002F4.run\u002F14.use-the-console-from-another-machine",{"title":231,"path":232,"stem":233},"Kraft Lite","\u002Fguides\u002Fkraft-lite","3.guides\u002F5.kraft-lite",{"title":235,"path":236,"stem":237,"children":238},"Troubleshooting","\u002Ftroubleshooting","4.troubleshooting",[239,241,245,249,253,257,261,265,269,273,277,281],{"title":10,"path":236,"stem":240},"4.troubleshooting\u002Findex",{"title":242,"path":243,"stem":244},"Failed tasks and fix loops","\u002Ftroubleshooting\u002Ffailed-tasks-and-fix-loops","4.troubleshooting\u002F01.failed-tasks-and-fix-loops",{"title":246,"path":247,"stem":248},"Launch and setup stops","\u002Ftroubleshooting\u002Flaunch-and-setup-stops","4.troubleshooting\u002F02.launch-and-setup-stops",{"title":250,"path":251,"stem":252},"Caps, budgets and waits","\u002Ftroubleshooting\u002Fcaps-budgets-and-waits","4.troubleshooting\u002F03.caps-budgets-and-waits",{"title":254,"path":255,"stem":256},"Forge stops","\u002Ftroubleshooting\u002Fforge-stops","4.troubleshooting\u002F04.forge-stops",{"title":258,"path":259,"stem":260},"Worktree and git stops","\u002Ftroubleshooting\u002Fworktree-and-git-stops","4.troubleshooting\u002F05.worktree-and-git-stops",{"title":262,"path":263,"stem":264},"Sandbox and Kit stops","\u002Ftroubleshooting\u002Fsandbox-and-kit-stops","4.troubleshooting\u002F06.sandbox-and-kit-stops",{"title":266,"path":267,"stem":268},"A kind: os sandbox is refused","\u002Ftroubleshooting\u002Fos-sandbox-refusals","4.troubleshooting\u002F07.os-sandbox-refusals",{"title":270,"path":271,"stem":272},"Doctor failures","\u002Ftroubleshooting\u002Fdoctor-failures","4.troubleshooting\u002F08.doctor-failures",{"title":274,"path":275,"stem":276},"Starting and reaching Kraft","\u002Ftroubleshooting\u002Fstarting-and-reaching-kraft","4.troubleshooting\u002F09.starting-and-reaching-kraft",{"title":278,"path":279,"stem":280},"Add-on problems","\u002Ftroubleshooting\u002Faddon-problems","4.troubleshooting\u002F10.addon-problems",{"title":282,"path":283,"stem":284},"Add-on validation messages","\u002Ftroubleshooting\u002Faddon-validate-messages","4.troubleshooting\u002F11.addon-validate-messages",{"title":286,"path":287,"stem":288,"children":289},"Reference","\u002Freference","5.reference",[290,292,338,372,376,380,490,532,558,562,566,584,588,592,596],{"title":10,"path":287,"stem":291},"5.reference\u002Findex",{"title":293,"path":294,"stem":295,"children":296},"Web UI","\u002Freference\u002Fweb-ui","5.reference\u002F00.web-ui\u002Findex",[297,298,302,306,310,314,318,322,326,330,334],{"title":10,"path":294,"stem":295},{"title":299,"path":300,"stem":301},"Sidebar, search and keyboard","\u002Freference\u002Fweb-ui\u002Fsidebar-search-and-keyboard","5.reference\u002F00.web-ui\u002F0.sidebar-search-and-keyboard",{"title":303,"path":304,"stem":305},"The board","\u002Freference\u002Fweb-ui\u002Fboard","5.reference\u002F00.web-ui\u002F1.board",{"title":307,"path":308,"stem":309},"An item's page","\u002Freference\u002Fweb-ui\u002Fitem-page","5.reference\u002F00.web-ui\u002F2.item-page",{"title":311,"path":312,"stem":313},"Fix loops and test scopes","\u002Freference\u002Fweb-ui\u002Ffix-loops-and-test-scopes","5.reference\u002F00.web-ui\u002F3.fix-loops-and-test-scopes",{"title":315,"path":316,"stem":317},"Config before an item starts","\u002Freference\u002Fweb-ui\u002Fconfig-before-start","5.reference\u002F00.web-ui\u002F4.config-before-start",{"title":319,"path":320,"stem":321},"The review page","\u002Freference\u002Fweb-ui\u002Freview-page","5.reference\u002F00.web-ui\u002F5.review-page",{"title":323,"path":324,"stem":325},"Templates","\u002Freference\u002Fweb-ui\u002Ftemplates","5.reference\u002F00.web-ui\u002F6.templates",{"title":327,"path":328,"stem":329},"Settings","\u002Freference\u002Fweb-ui\u002Fsettings","5.reference\u002F00.web-ui\u002F7.settings",{"title":331,"path":332,"stem":333},"Analytics","\u002Freference\u002Fweb-ui\u002Fanalytics","5.reference\u002F00.web-ui\u002F8.analytics",{"title":335,"path":336,"stem":337},"The board on a phone","\u002Freference\u002Fweb-ui\u002Fon-a-phone","5.reference\u002F00.web-ui\u002F9.on-a-phone",{"title":339,"path":340,"stem":341,"children":342},"CLI","\u002Freference\u002Fcli","5.reference\u002F01.cli\u002Findex",[343,344,348,352,356,360,364,368],{"title":10,"path":340,"stem":341},{"title":345,"path":346,"stem":347},"Item verbs","\u002Freference\u002Fcli\u002Fitem","5.reference\u002F01.cli\u002F2.item",{"title":349,"path":350,"stem":351},"View verbs","\u002Freference\u002Fcli\u002Fview","5.reference\u002F01.cli\u002F3.view",{"title":353,"path":354,"stem":355},"Repo verbs","\u002Freference\u002Fcli\u002Frepo","5.reference\u002F01.cli\u002F4.repo",{"title":357,"path":358,"stem":359},"Server verbs","\u002Freference\u002Fcli\u002Fserver","5.reference\u002F01.cli\u002F5.server",{"title":361,"path":362,"stem":363},"Add-on verbs","\u002Freference\u002Fcli\u002Faddon","5.reference\u002F01.cli\u002F6.addon",{"title":365,"path":366,"stem":367},"Machine verbs","\u002Freference\u002Fcli\u002Fworker","5.reference\u002F01.cli\u002F7.worker",{"title":369,"path":370,"stem":371},"Forge verbs","\u002Freference\u002Fcli\u002Fforge","5.reference\u002F01.cli\u002F8.forge",{"title":373,"path":374,"stem":375},"Console","\u002Freference\u002Fconsole","5.reference\u002F01.console",{"title":377,"path":378,"stem":379},"Work item statuses","\u002Freference\u002Fstatuses","5.reference\u002F02.statuses",{"title":381,"path":382,"stem":383,"children":384},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F03.configuration\u002Findex",[385,386,404,408,412,416,420,424,428,466,470,474,478,482,486],{"title":10,"path":382,"stem":383},{"title":387,"path":388,"stem":389,"children":390},"repos.yaml","\u002Freference\u002Fconfiguration\u002Frepos","5.reference\u002F03.configuration\u002F02.repos\u002Findex",[391,392,396,400],{"title":10,"path":388,"stem":389},{"title":393,"path":394,"stem":395},"How connect proposes commands","\u002Freference\u002Fconfiguration\u002Frepos\u002Fconnect-proposals","5.reference\u002F03.configuration\u002F02.repos\u002F1.connect-proposals",{"title":397,"path":398,"stem":399},"detectors.yaml","\u002Freference\u002Fconfiguration\u002Frepos\u002Fdetectors","5.reference\u002F03.configuration\u002F02.repos\u002F2.detectors",{"title":401,"path":402,"stem":403},"Workspaces","\u002Freference\u002Fconfiguration\u002Frepos\u002Fworkspaces","5.reference\u002F03.configuration\u002F02.repos\u002F3.workspaces",{"title":405,"path":406,"stem":407},"policy.yaml","\u002Freference\u002Fconfiguration\u002Fpolicy","5.reference\u002F03.configuration\u002F03.policy",{"title":409,"path":410,"stem":411},"Library and chains","\u002Freference\u002Fconfiguration\u002Flibrary-and-chains","5.reference\u002F03.configuration\u002F04.library-and-chains",{"title":413,"path":414,"stem":415},"access.yaml","\u002Freference\u002Fconfiguration\u002Faccess","5.reference\u002F03.configuration\u002F06.access",{"title":417,"path":418,"stem":419},"intake.yaml","\u002Freference\u002Fconfiguration\u002Fintake","5.reference\u002F03.configuration\u002F07.intake",{"title":421,"path":422,"stem":423},"notify.yaml","\u002Freference\u002Fconfiguration\u002Fnotify","5.reference\u002F03.configuration\u002F08.notify",{"title":425,"path":426,"stem":427},"theme.yaml","\u002Freference\u002Fconfiguration\u002Ftheme","5.reference\u002F03.configuration\u002F09.theme",{"title":429,"path":430,"stem":431,"children":432},"Sandboxed workers","\u002Freference\u002Fconfiguration\u002Fsandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002Findex",[433,434,438,442,446,450,454,458,462],{"title":10,"path":430,"stem":431},{"title":435,"path":436,"stem":437},"Resource limits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fresource-limits","5.reference\u002F03.configuration\u002F10.sandbox\u002F1.resource-limits",{"title":439,"path":440,"stem":441},"Callbacks from a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcallbacks","5.reference\u002F03.configuration\u002F10.sandbox\u002F2.callbacks",{"title":443,"path":444,"stem":445},"Network policy","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fnetwork-policy","5.reference\u002F03.configuration\u002F10.sandbox\u002F3.network-policy",{"title":447,"path":448,"stem":449},"Credentials","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcredentials","5.reference\u002F03.configuration\u002F10.sandbox\u002F4.credentials",{"title":451,"path":452,"stem":453},"Kits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fkits","5.reference\u002F03.configuration\u002F10.sandbox\u002F5.kits",{"title":455,"path":456,"stem":457},"sandbox.yaml","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fsandbox-yaml","5.reference\u002F03.configuration\u002F10.sandbox\u002F6.sandbox-yaml",{"title":459,"path":460,"stem":461},"Git in a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fgit-in-a-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F7.git-in-a-sandbox",{"title":463,"path":464,"stem":465},"The OS sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fos-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F8.os-sandbox",{"title":467,"path":468,"stem":469},"Environment variables","\u002Freference\u002Fconfiguration\u002Fenvironment-variables","5.reference\u002F03.configuration\u002F11.environment-variables",{"title":471,"path":472,"stem":473},"Add-ons and collections","\u002Freference\u002Fconfiguration\u002Faddons","5.reference\u002F03.configuration\u002F12.addons",{"title":475,"path":476,"stem":477},"Repo libraries","\u002Freference\u002Fconfiguration\u002Frepo-libraries","5.reference\u002F03.configuration\u002F13.repo-libraries",{"title":479,"path":480,"stem":481},"update.yaml","\u002Freference\u002Fconfiguration\u002Fupdate","5.reference\u002F03.configuration\u002F14.update",{"title":483,"path":484,"stem":485},"workers.yaml","\u002Freference\u002Fconfiguration\u002Fworkers","5.reference\u002F03.configuration\u002F15.workers",{"title":487,"path":488,"stem":489},"forges.yaml","\u002Freference\u002Fconfiguration\u002Fforges","5.reference\u002F03.configuration\u002F16.forges",{"title":491,"path":492,"stem":493,"children":494},"Chain file keys","\u002Freference\u002Fchain-nodes","5.reference\u002F04.chain-nodes\u002Findex",[495,496,500,504,508,512,516,520,524,528],{"title":10,"path":492,"stem":493},{"title":497,"path":498,"stem":499},"The shipped chains","\u002Freference\u002Fchain-nodes\u002Fshipped-chains","5.reference\u002F04.chain-nodes\u002F1.shipped-chains",{"title":501,"path":502,"stem":503},"Subprocess tasks","\u002Freference\u002Fchain-nodes\u002Fsubprocess-tasks","5.reference\u002F04.chain-nodes\u002F2.subprocess-tasks",{"title":505,"path":506,"stem":507},"Fix loop and judge","\u002Freference\u002Fchain-nodes\u002Ffix-loop","5.reference\u002F04.chain-nodes\u002F3.fix-loop",{"title":509,"path":510,"stem":511},"Result file","\u002Freference\u002Fchain-nodes\u002Fresult-file","5.reference\u002F04.chain-nodes\u002F4.result-file",{"title":513,"path":514,"stem":515},"Merge queue and train drops","\u002Freference\u002Fchain-nodes\u002Fmerge-queue-drops","5.reference\u002F04.chain-nodes\u002F5.merge-queue-drops",{"title":517,"path":518,"stem":519},"What the final review approves","\u002Freference\u002Fchain-nodes\u002Ffinal-review-approval","5.reference\u002F04.chain-nodes\u002F6.final-review-approval",{"title":521,"path":522,"stem":523},"Waiting for a pipeline by ID","\u002Freference\u002Fchain-nodes\u002Fwait-for-a-pipeline","5.reference\u002F04.chain-nodes\u002F7.wait-for-a-pipeline",{"title":525,"path":526,"stem":527},"read_only","\u002Freference\u002Fchain-nodes\u002Fread-only","5.reference\u002F04.chain-nodes\u002F8.read-only",{"title":529,"path":530,"stem":531},"Step outputs","\u002Freference\u002Fchain-nodes\u002Fstep-outputs","5.reference\u002F04.chain-nodes\u002F9.step-outputs",{"title":533,"path":534,"stem":535,"children":536},"Agent harnesses","\u002Freference\u002Fharnesses","5.reference\u002F05.harnesses\u002Findex",[537,538,542,546,550,554],{"title":10,"path":534,"stem":535},{"title":539,"path":540,"stem":541},"Unattended runs","\u002Freference\u002Fharnesses\u002Funattended-runs","5.reference\u002F05.harnesses\u002F2.unattended-runs",{"title":543,"path":544,"stem":545},"Agent profiles","\u002Freference\u002Fharnesses\u002Fagent-profiles","5.reference\u002F05.harnesses\u002F3.agent-profiles",{"title":547,"path":548,"stem":549},"Harness definition files and harness profiles","\u002Freference\u002Fharnesses\u002Fharness-files","5.reference\u002F05.harnesses\u002F4.harness-files",{"title":551,"path":552,"stem":553},"Fallback and escalation","\u002Freference\u002Fharnesses\u002Ffallback-and-escalation","5.reference\u002F05.harnesses\u002F5.fallback-and-escalation",{"title":555,"path":556,"stem":557},"Cost reporting","\u002Freference\u002Fharnesses\u002Fcost-reporting","5.reference\u002F05.harnesses\u002F6.cost-reporting",{"title":559,"path":560,"stem":561},"Permission gate","\u002Freference\u002Fpermissions","5.reference\u002F06.permissions",{"title":563,"path":564,"stem":565},"Inbound triggers","\u002Freference\u002Ftriggers","5.reference\u002F07.triggers",{"title":567,"path":568,"stem":569,"children":570},"HTTP API","\u002Freference\u002Fhttp-api","5.reference\u002F08.http-api\u002Findex",[571,572,576,580],{"title":10,"path":568,"stem":569},{"title":573,"path":574,"stem":575},"Filing, reading and deciding work items","\u002Freference\u002Fhttp-api\u002Fwork-items","5.reference\u002F08.http-api\u002F2.work-items",{"title":577,"path":578,"stem":579},"The work item object","\u002Freference\u002Fhttp-api\u002Fwork-item-object","5.reference\u002F08.http-api\u002F4.work-item-object",{"title":581,"path":582,"stem":583},"Connecting a repo","\u002Freference\u002Fhttp-api\u002Fconnect-a-repo","5.reference\u002F08.http-api\u002F5.connect-a-repo",{"title":585,"path":586,"stem":587},"MCP tools","\u002Freference\u002Fmcp-tools","5.reference\u002F09.mcp-tools",{"title":589,"path":590,"stem":591},"Events","\u002Freference\u002Fevents","5.reference\u002F10.events",{"title":593,"path":594,"stem":595},"VS Code extension","\u002Freference\u002Fvscode-extension","5.reference\u002F11.vscode-extension",{"title":597,"path":598,"stem":599},"Kraft Lite reference","\u002Freference\u002Fkraft-lite","5.reference\u002F12.kraft-lite",{"title":601,"path":602,"stem":603,"children":604},"Project","\u002Fproject","6.project",[605,607,611,615,619,623,627,631,635],{"title":10,"path":602,"stem":606},"6.project\u002Findex",{"title":608,"path":609,"stem":610},"Security","\u002Fproject\u002Fsecurity","6.project\u002F1.security",{"title":612,"path":613,"stem":614},"Security in depth","\u002Fproject\u002Fsecurity-in-depth","6.project\u002F1.security-in-depth",{"title":616,"path":617,"stem":618},"Data and privacy","\u002Fproject\u002Fdata-and-privacy","6.project\u002F2.data-and-privacy",{"title":620,"path":621,"stem":622},"What's new","\u002Fproject\u002Fwhats-new","6.project\u002F3.whats-new",{"title":624,"path":625,"stem":626},"Status and support","\u002Fproject\u002Fstatus-and-support","6.project\u002F4.status-and-support",{"title":628,"path":629,"stem":630},"Architecture","\u002Fproject\u002Farchitecture","6.project\u002F5.architecture",{"title":632,"path":633,"stem":634},"Source map","\u002Fproject\u002Fsource-map","6.project\u002F6.source-map",{"title":636,"path":637,"stem":638},"Contributing","\u002Fproject\u002Fcontributing","6.project\u002F7.contributing",{"id":640,"title":207,"body":641,"description":4099,"extension":4100,"links":4101,"meta":4102,"navigation":4103,"path":208,"seo":4104,"stem":209,"__hash__":4105},"docs\u002F3.guides\u002F4.run\u002F09.coming-from-1-4.md",{"type":642,"value":643,"toc":4068},"minimark",[644,657,696,701,747,750,757,977,981,1017,1020,1027,1059,1062,1083,1090,1093,1105,1109,1190,1193,1299,1303,1570,1584,1679,1697,1700,1958,1962,2001,2103,2121,2124,2139,2147,2157,2537,2540,2546,3596,3599,3631,3640,3644,3651,3781,3784,3790,3794,3797,3841,3854,3869,3880,3888,3900,3933,3937,3956,4022,4042,4046,4064],[645,646,647,648,651,652,656],"p",{},"By the end you run the current release, coming from 1.4, and you have acted on each change that needs something from you. An update between 2.x releases needs only ",[649,650,199],"a",{"href":200},". A 1.5.0 release candidate or a 0.x home follows ",[649,653,655],{"href":654},"#from-a-release-candidate-or-0x","From a release candidate or 0.x",".",[658,659,660,677,687],"ul",{},[661,662,663,667,668,672,673,656],"li",{},[664,665,666],"strong",{},"On 1.4:"," follow ",[649,669,671],{"href":670},"#update-from-14","Update from 1.4",", then read ",[649,674,676],{"href":675},"#changes-that-need-action","Changes that need action",[661,678,679,682,683,656],{},[664,680,681],{},"Already ran 1.4's own update:"," go to ",[649,684,686],{"href":685},"#if-you-used-14s-update-anyway","If you used 1.4's update anyway",[661,688,689,682,692,656],{},[664,690,691],{},"Update went wrong:",[649,693,695],{"href":694},"#roll-back-to-14","Roll back to 1.4",[697,698,700],"h2",{"id":699},"before-you-start","Before you start",[658,702,703,711,730,744],{},[661,704,705,706,710],{},"You know how Kraft was installed: with uv or ",[707,708,709],"code",{},"install.sh",", with Homebrew, or with pipx. Step 4 differs for each.",[661,712,713,714,717,718,721,722,725,726,729],{},"On uv or pipx, you know the Python Kraft runs on and whether you use vector search. ",[707,715,716],{},"\"$(uv tool dir)\u002Fkraft-sdlc\u002Fbin\u002Fpython\" -V"," prints the Python. The ",[707,719,720],{},"embeddings"," line of ",[707,723,724],{},"kraft admin health"," says ",[707,727,728],{},"unavailable (the 'vector' extra is not installed"," when you don't have the extra.",[661,731,732,735,736,739,740,743],{},[707,733,734],{},"sqlite3"," or ",[707,737,738],{},"python3"," is on your ",[707,741,742],{},"PATH",", for the backup in step 1.",[661,745,746],{},"You can pick a moment when no agent runs, or you pause the running items first (step 3).",[697,748,671],{"id":749},"update-from-14",[645,751,752,753,756],{},"Don't update with 1.4's own ",[707,754,755],{},"kraft admin update",". That command runs in the release you have installed, and 1.4's mishandles a uv install and a pipx install, as step 4 says. Use your package manager:",[758,759,760,768,834,841,962],"ol",{},[661,761,762,763,767],{},"Back up the database, as step 1 of ",[649,764,766],{"href":765},"\u002Fguides\u002Frun\u002Fupgrade-kraft#upgrade","Upgrade"," says. 1.4 can't open the database the new release migrates. Keep the file name that step prints: a rollback to 1.4 needs it, and a later upgrade's backup never replaces it.",[661,769,770,771],{},"Do what has to come first. Each item names its change below:\n",[658,772,773,785,793,807,823],{},[661,774,775,776,779,780,784],{},"On a network bind, add each name you use to ",[707,777,778],{},"allowed_hosts"," (",[649,781,783],{"href":782},"#network-access","Network access",").",[661,786,787,788,779,791,784],{},"Behind a tunnel or reverse proxy on a loopback bind, make it send a loopback ",[707,789,790],{},"Host",[649,792,783],{"href":782},[661,794,795,796,799,800,779,803,784],{},"On a repo entry with ",[707,797,798],{},"test_command: \"\"",", set a real test command or ",[707,801,802],{},"enabled: false",[649,804,806],{"href":805},"#items-and-repos","Items and repos",[661,808,809,810,813,814,817,818,779,821,784],{},"On a repo whose ",[707,811,812],{},"sandbox:"," has no ",[707,815,816],{},"network:",", add one, or set ",[707,819,820],{},"unrestricted_network: true",[649,822,806],{"href":805},[661,824,825,826,829,830,784],{},"On a schedule with day of week ",[707,827,828],{},"7",", change or remove it unless you want it to fire on Sundays (",[649,831,833],{"href":832},"#config-directory-and-files","Config directory and files",[661,835,836,837,656],{},"Pause the running items, or wait until none run: 1.4 ends its agents when it stops. See ",[649,838,840],{"href":839},"\u002Fguides\u002Frun\u002Frestart-kraft#a-restart-leaves-local-steps-running","A restart leaves local steps running",[661,842,843,844],{},"Install the newest release with the tool you installed Kraft with:\n",[658,845,846,905,947],{},[661,847,848,854,855,858,859,862,863,866,867,870,871,877,878,881,882,885,886,889,890,893,894,897,898,900,901,904],{},[664,849,850,851,853],{},"uv or ",[707,852,709],{},":"," run ",[707,856,857],{},"uv tool install --force --python 3.X \"kraft-sdlc[vector]==\u003Cversion>\"",", with the Python you installed Kraft with for ",[707,860,861],{},"3.X"," and the release for ",[707,864,865],{},"\u003Cversion>",": the number without the ",[707,868,869],{},"v",", as the newest tag on the ",[649,872,876],{"href":873,"rel":874},"https:\u002F\u002Fgithub.com\u002FitsOmidKarami\u002Fkraft\u002Freleases\u002Flatest",[875],"nofollow","releases page"," shows it (tag ",[707,879,880],{},"v2.5.0"," is ",[707,883,884],{},"2.5.0","). For example, ",[707,887,888],{},"uv tool install --force --python 3.13 \"kraft-sdlc[vector]==2.5.0\"",". Leave out ",[707,891,892],{},"[vector]"," if you don't use vector search.",[895,896],"br",{},"1.4's update installs the new release without the ",[707,899,892],{}," extra and on uv's default Python, and leaves ",[707,902,903],{},"uv tool upgrade"," pointing at a file it has deleted.",[661,906,907,854,910,913,914,917,918,921,922],{},[664,908,909],{},"Homebrew:",[707,911,912],{},"brew update",", then ",[707,915,916],{},"brew info kraft",". It shows the version the tap offers, and ",[707,919,920],{},"brew info"," alone doesn't refresh the tap.",[658,923,924,935],{},[661,925,926,927,930,931,934],{},"If it still shows 1.4, the tap has no newer release yet, and ",[707,928,929],{},"brew upgrade kraft"," changes nothing: wait, or run ",[707,932,933],{},"brew uninstall kraft"," and install with uv as above.",[661,936,937,938,940,941,943,944,946],{},"Otherwise run ",[707,939,929],{},". 1.4's ",[707,942,755],{}," runs the same command, and loses nothing: the formula has no ",[707,945,892],{}," extra.",[661,948,949,854,952,955,956,958,959,961],{},[664,950,951],{},"pipx:",[707,953,954],{},"pipx install --force --python python3.X \"kraft-sdlc[vector]==\u003Cversion>\"",", with ",[707,957,865],{}," as above. 1.4's ",[707,960,755],{}," doesn't update a pipx install: it puts a second Kraft beside it with uv.",[661,963,964,965,968,969,972,973,976],{},"Restart the server with ",[707,966,967],{},"kraft admin restart",". With an item still active, a restart onto a new major version exits 1 and names ",[707,970,971],{},"--when-free"," and ",[707,974,975],{},"kraft admin stop --now",": wait for the item, or end its steps with the second. Otherwise it asks before it ends agents.",[697,978,980],{"id":979},"check-it-worked","Check it worked",[658,982,983,994],{},[661,984,985,972,988,990,991,993],{},[707,986,987],{},"kraft --version",[707,989,724],{}," print the release you installed, as step 5 of ",[649,992,766],{"href":765}," shows.",[661,995,996,999,1000,1003,1004,1003,1007,972,1010,1013,1014,1016],{},[707,997,998],{},"kraft admin doctor"," has a ",[707,1001,1002],{},"keys",", ",[707,1005,1006],{},"moved keys",[707,1008,1009],{},"tests",[707,1011,1012],{},"config"," row. Each names what the new release found in your files: ",[649,1015,676],{"href":675}," says what to do about it.",[697,1018,686],{"id":1019},"if-you-used-14s-update-anyway",[645,1021,1022,1023,1026],{},"On a uv install, an update run by 1.4 drops the ",[707,1024,1025],{},"vector"," extra and moves Kraft to uv's default Python. Restart right after it, and don't act on the board before:",[758,1028,1029,1035,1045],{},[661,1030,1031,1032,1034],{},"Run ",[707,1033,967],{}," as soon as the update finishes.",[661,1036,1037,1038,1040,1041,656],{},"Reinstall ",[707,1039,892],{}," with the uv command above, if you use vector search. Without it, vector search stops working: see ",[649,1042,1044],{"href":1043},"\u002Fguides\u002Frun\u002Fupgrade-kraft#add-vector-search","Add vector search",[661,1046,1047,1048,1050,1051,721,1053,1055,1056,656],{},"If you reinstalled the extra, run ",[707,1049,967],{}," once more, to be safe. The reinstall replaced files under the server you just restarted, as any update does, and a restarted server reads them fresh. The ",[707,1052,720],{},[707,1054,724],{}," then says ",[707,1057,1058],{},"available",[645,1060,1061],{},"Before the restart you may see:",[658,1063,1064,1067,1077],{},[661,1065,1066],{},"Items under the wrong heading, and a footer that names the new release. 1.4's server keeps running and serves the new interface, which misreads its board.",[661,1068,1069,1070,1072,1073,1076],{},"A banner over the board saying so. ",[707,1071,998],{},"'s ",[707,1074,1075],{},"restart"," row warns that the server runs a release older than the one installed.",[661,1078,1079,1082],{},[707,1080,1081],{},"Internal Server Error"," instead of the board, if Kraft ran on a Python other than uv's default. 1.4's update moved Kraft to another Python and deleted the files the running server serves, though its API still answers.",[645,1084,1085,1086,1089],{},"If you ran ",[707,1087,1088],{},"kraft admin update --restart"," (or restarted a service), 1.4 restarted the server without asking, which ended the agents of running items. Pause them first next time.",[697,1091,676],{"id":1092},"changes-that-need-action",[645,1094,1095,1096,1100,1101,1104],{},"The new release changes some 1.4 behaviour that the ",[649,1097,1099],{"href":1098},"\u002Fproject\u002Fstatus-and-support#versioning-and-stability","stability policy"," covers, such as ",[707,1102,1103],{},"--json"," fields and exit codes, which is why it is a major release. Your chains, library and other config files carry over as they are, apart from the changes here. Each item says what 1.4 did and what you do.",[1106,1107,783],"h3",{"id":1108},"network-access",[658,1110,1111,1132],{},[661,1112,1113,1119,1120,1122,1123,1125,1126,1128,1129,1131],{},[664,1114,1115,1116,1118],{},"A network bind checks the ",[707,1117,790],{}," a browser uses."," 1.4 skipped the check over plain HTTP, so a name missing from ",[707,1121,778],{}," may have worked. Before you update, add each exact name you use (no wildcards) on Settings › Access, or to ",[707,1124,778],{}," in ",[707,1127,413],{},". ",[707,1130,998],{}," warns when the bind is off loopback and the list is empty.",[661,1133,1134,1150,1151,972,1154,1157,1158,1160,1161,1165,1166],{},[664,1135,1136,1137,1139,1140,1003,1143,735,1146,1149],{},"A loopback bind answers 403 to a request whose ",[707,1138,790],{}," isn't ",[707,1141,1142],{},"localhost",[707,1144,1145],{},"127.0.0.1",[707,1147,1148],{},"[::1]",","," webhooks to ",[707,1152,1153],{},"POST \u002Fapi\u002Ftriggers",[707,1155,1156],{},"GET \u002Fapi\u002Fhealth"," included. 1.4 checked only browser requests, and ",[707,1159,778],{}," doesn't apply on a loopback bind. See ",[649,1162,1164],{"href":1163},"\u002Freference\u002Fhttp-api#who-may-call","Who may call",".\n",[658,1167,1168,1178],{},[661,1169,1170,1171,1128,1173,1177],{},"For the board behind cloudflared, ngrok, Caddy or nginx: bind beyond loopback, with a password, and list the name in ",[707,1172,778],{},[649,1174,1176],{"href":1175},"\u002Fguides\u002Frun\u002Fput-a-proxy-in-front-of-kraft#serve-the-board-behind-a-reverse-proxy","Serve the board behind a reverse proxy"," says what the proxy must pass.",[661,1179,1180,1181,1183,1184,1186,1187,1189],{},"For webhooks and scripts alone: have the proxy rewrite ",[707,1182,790],{}," to ",[707,1185,1142],{},". Read ",[649,1188,179],{"href":180}," first, because it also changes who has to sign in.",[1106,1191,806],{"id":1192},"items-and-repos",[658,1194,1195,1220,1241,1259,1270,1284],{},[661,1196,1197,1203,1204,1209,1210,1212,1213,1215,1216,1219],{},[664,1198,1199,1200,1202],{},"A sandbox with no ",[707,1201,816],{}," is refused."," Every agent launch into it stops the item as a configuration error. 1.4 ran a Codex or Cursor task with the worker's network unrestricted and no channel to Kraft, so gates weren't enforced. A repo that runs only Claude needs nothing. Otherwise add a ",[649,1205,1206,1208],{"href":444},[707,1207,816],{}," policy",", or set ",[707,1211,820],{}," to run as 1.4 did. Both keys together are refused, and ",[707,1214,998],{}," fails the ",[707,1217,1218],{},"egress"," row of each such repo.",[661,1221,1222,1227,1228,1231,1232,1234,1235,1237,1238,1240],{},[664,1223,1224,1226],{},[707,1225,798],{}," means the repo has no tests."," Its items pass ",[707,1229,1230],{},"verify"," without running one, where 1.4 stopped every item there. Before you update, set a real test command on such an entry, or ",[707,1233,802],{},". Afterwards the ",[707,1236,1009],{}," row of ",[707,1239,998],{}," names each one.",[661,1242,1243,1249,1250,1003,1253,1255,1256,656],{},[664,1244,1245,1248],{},[707,1246,1247],{},"kraft repo connect"," on a connected repo saves what its entry left undecided:"," a test command where it has none and no test scopes, and a setup command where none is declared. That can enable a repo saved disabled. It asks first in a terminal, and saves without asking with ",[707,1251,1252],{},"-y",[707,1254,1103],{}," or no terminal. A script that re-runs connect to check a repo should run ",[707,1257,1258],{},"kraft repo list",[661,1260,1261,1266,1267,1269],{},[664,1262,1263,1265],{},[707,1264,1247],{}," refuses a repo with no commit yet."," Commit its files first. ",[707,1268,998],{}," names each entry 1.4 left without a test or setup command where the new release finds one, with the connect command that saves it.",[661,1271,1272,1275,1276,1279,1280,1283],{},[664,1273,1274],{},"A repo with open items can't be disconnected."," ",[707,1277,1278],{},"kraft repo disconnect"," (and ",[707,1281,1282],{},"DELETE \u002Fapi\u002Frepos",") answers 409 until each item is done, cancelled or abandoned, paused and never-started ones included. Finish, cancel or abandon them first.",[661,1285,1286,1294,1295,1298],{},[664,1287,1288,1289,1293],{},"Cancel keeps the branch and ",[649,1290,1292],{"href":1291},"\u002Fconcepts\u002Fvocabulary#worktree","worktree",", and a merge request closed without merging stops its item."," 1.4 deleted the first and kept waiting on the second. To delete them, run ",[707,1296,1297],{},"kraft item abandon ID --reason \"...\" --yes",". For the merge request, reopen it from the item's page, retry or cancel.",[1106,1300,1302],{"id":1301},"scripts-json-output-and-the-api","Scripts, JSON output and the API",[658,1304,1305,1332,1355,1364,1381,1437,1449,1486,1512,1532],{},[661,1306,1307,1313,1314,1316,1317,1320,1321,972,1324,1327,1328,1331],{},[664,1308,1309,1312],{},[707,1310,1311],{},"agent_overrides"," is an object, not JSON text,"," in every ",[707,1315,1103],{}," answer that carries the item, the MCP tools' results and ",[707,1318,1319],{},"GET \u002Fapi\u002Fwork-items\u002F{id}",", and so are ",[707,1322,1323],{},"node_overrides",[707,1325,1326],{},"policy_override"," in the answers to an action. A script that runs ",[707,1329,1330],{},"json.loads"," on one reads it as an object instead. Setting the override works as in 1.4.",[661,1333,1334,1350,1351,1354],{},[664,1335,1336,1125,1339,1342,1343,1072,1347,656],{},[707,1337,1338],{},"budget_cap.cap_usd",[707,1340,1341],{},"kraft view show --json"," is the lower of the item's own cap and its ",[649,1344,1346],{"href":1345},"\u002Fconcepts\u002Fvocabulary#policy","policy",[707,1348,1349],{},"budget_usd"," Read ",[707,1352,1353],{},"budget_cap.key"," to tell which.",[661,1356,1357,1363],{},[664,1358,1359,1362],{},[707,1360,1361],{},"kraft view events -f --json"," prints one JSON object per line"," from the first line on, where 1.4 printed the backlog as an indented array. Read it line by line.",[661,1365,1366,1373,1374,1377,1378,656],{},[664,1367,1368,1369,1372],{},"An event has a ",[707,1370,1371],{},"node_id"," of its own."," A gate's events from before the update keep ",[707,1375,1376],{},"null",": read their node from ",[707,1379,1380],{},"gate",[661,1382,1383,1386,1387,1003,1390,1003,1393,1003,1396,1003,1399,1003,1402,1003,1405,1003,1408,1003,1411,1003,1414,1003,1417,1003,1420,972,1423,1426,1427,735,1430,1433,1434,1436],{},[664,1384,1385],{},"Action commands print one line, not the item's fields."," That covers ",[707,1388,1389],{},"kraft item approve",[707,1391,1392],{},"reject",[707,1394,1395],{},"pause",[707,1397,1398],{},"resume",[707,1400,1401],{},"retry",[707,1403,1404],{},"raise-budget",[707,1406,1407],{},"skip",[707,1409,1410],{},"complete",[707,1412,1413],{},"cancel",[707,1415,1416],{},"escalate",[707,1418,1419],{},"set-chain",[707,1421,1422],{},"resolve",[707,1424,1425],{},"reopen",", and ",[707,1428,1429],{},"kraft item review approve",[707,1431,1432],{},"request-changes"," at a pending gate. A script that read the fields should use ",[707,1435,1103],{},", which is unchanged.",[661,1438,1439,1444,1445,1448],{},[664,1440,1441,1443],{},[707,1442,967],{}," with no server running exits 1,"," where 1.4 exited 0. A script under ",[707,1446,1447],{},"set -e"," stops there: start the server first.",[661,1450,1451,1275,1454,1457,1458,972,1461,1464,1465,1468,1469,955,1472,1426,1475,1478,1479,1482,1483,656],{},[664,1452,1453],{},"A review comment names a file inside the repository, and a suggestion goes on new-side lines.",[707,1455,1456],{},"kraft item comment",", the MCP tool ",[707,1459,1460],{},"add_review_comment",[707,1462,1463],{},"POST \u002Fapi\u002Fwork-items\u002F{id}\u002Fthreads"," answer an absolute ",[707,1466,1467],{},"--file"," path, or one with ",[707,1470,1471],{},"..",[707,1473,1474],{},"422",[707,1476,1477],{},"--suggest"," with ",[707,1480,1481],{},"--side old"," exits 2. Use a repository-relative path and ",[707,1484,1485],{},"--side new",[661,1487,1488,1493,1494,1497,1498,1003,1501,1003,1504,1507,1508,1511],{},[664,1489,1490,1491,1149],{},"A model override that isn't a model ID is refused with ",[707,1492,1474],{}," such as ",[707,1495,1496],{},"--model \"my model\"",", by ",[707,1499,1500],{},"kraft item set-overrides",[707,1502,1503],{},"set-node-override",[707,1505,1506],{},"PATCH \u002Fapi\u002Fwork-items\u002F{id}"," and a retry that changes ",[707,1509,1510],{},"task_config.model",". 1.4 stored any text. One already stored stops its item at the next launch, and the reason names the command that clears it: run it.",[661,1513,1514,1275,1517,1520,1521,1524,1525,1528,1529,1531],{},[664,1515,1516],{},"A spend cap that stopped an item can't be escalated past, or raised to what the item spent.",[707,1518,1519],{},"kraft item escalate"," answers ",[707,1522,1523],{},"409"," on an item any spend cap stopped, the daily cap included, and ",[707,1526,1527],{},"kraft item raise-budget"," with a cap at or below the spend answers ",[707,1530,1474],{},". Raise the cap above the spend.",[661,1533,1534,1275,1542,1457,1545,1003,1548,972,1550,1552,1553,1165,1555],{},[664,1535,1536,1537,1541],{},"A ",[649,1538,1540],{"href":1539},"\u002Fconcepts\u002Fvocabulary#work-item","work item"," title is one line of plain text, and not blank.",[707,1543,1544],{},"kraft item create",[707,1546,1547],{},"create_work_item",[707,1549,1153],{},[707,1551,1506],{}," answer a title that is empty, only whitespace, holds a line break or holds a control character with ",[707,1554,1474],{},[658,1556,1557,1563],{},[661,1558,1559,1560,656],{},"A webhook or script that builds the title from text that can be empty or run over several lines needs a fallback and the first line, with the rest in ",[707,1561,1562],{},"description",[661,1564,1565,1566,1569],{},"A schedule's title and ",[664,1567,1568],{},"Duplicate"," of an older item are cleaned up instead: the first line is the title, and the rest goes to the top of the description.",[645,1571,1572,1583],{},[664,1573,1574,1575,1578,1579,1582],{},"Chains are named ",[707,1576,1577],{},"chain",", not ",[707,1580,1581],{},"template",", in commands, tools and the API."," The old names that still work need nothing:",[1585,1586,1587,1603],"table",{},[1588,1589,1590],"thead",{},[1591,1592,1593,1597,1600],"tr",{},[1594,1595,1596],"th",{},"Before",[1594,1598,1599],{},"Now",[1594,1601,1602],{},"What to do",[1604,1605,1606,1629,1648],"tbody",{},[1591,1607,1608,1615,1626],{},[1609,1610,1611,1612],"td",{},"The MCP tool ",[707,1613,1614],{},"set_chain_template",[1609,1616,1617,955,1620,1622,1623,1625],{},[707,1618,1619],{},"set_chain",[707,1621,1577],{}," for ",[707,1624,1581],{},"; the old tool name no longer exists",[1609,1627,1628],{},"Change an agent prompt or skill that names it.",[1591,1630,1631,1639,1643],{},[1609,1632,1633,1636,1637],{},[707,1634,1635],{},"chain_template"," in the MCP tool ",[707,1638,1547],{},[1609,1640,1641],{},[707,1642,1577],{},[1609,1644,1645,1646,656],{},"Use ",[707,1647,1577],{},[1591,1649,1650,1668,1673],{},[1609,1651,1652,1655,1656,1003,1659,1457,1662,972,1665],{},[707,1653,1654],{},"default_chain_template"," in the answers of ",[707,1657,1658],{},"kraft repo list --json",[707,1660,1661],{},"kraft repo connect --json",[707,1663,1664],{},"ensure_repo",[707,1666,1667],{},"GET \u002Fapi\u002Frepos",[1609,1669,1670],{},[707,1671,1672],{},"default_chain",[1609,1674,1675,1676,1678],{},"Read ",[707,1677,1672],{}," in a script that uses the key.",[645,1680,1681,1003,1684,1125,1686,1426,1688,1125,1690,972,1693,1696],{},[707,1682,1683],{},"kraft item set-chain --template",[707,1685,1635],{},[707,1687,1153],{},[707,1689,1654],{},[707,1691,1692],{},"POST",[707,1694,1695],{},"PATCH \u002Fapi\u002Frepos"," are still read.",[1106,1698,833],{"id":1699},"config-directory-and-files",[658,1701,1702,1776,1800,1819,1905],{},[661,1703,1704,1713,1714,1717,1718,1721,1722,1578,1724,1165,1726],{},[664,1705,1706,1707,1578,1710,656],{},"The config directory is ",[707,1708,1709],{},"$KRAFT_HOME\u002Fconfig\u002F",[707,1711,1712],{},"templates\u002F"," The first start renames yours, every file as it was, and leaves ",[707,1715,1716],{},"templates"," as a link, so a 1.4 process still running and a path in a script keep working. Started while the 1.4 server is still up, it exits \"already running\" and touches nothing. ",[707,1719,1720],{},"kraft admin doctor --json"," names the row ",[707,1723,1012],{},[707,1725,1716],{},[658,1727,1728,1738,1759],{},[661,1729,1730,1733,1734,1737],{},[707,1731,1732],{},"KRAFT_CONFIG_DIR"," names it, and ",[707,1735,1736],{},"KRAFT_TEMPLATES_DIR"," is still read when the new one is unset.",[661,1739,1536,1740,1743,1744,1746,1747,1749,1750,1752,1753,1755,1756,1758],{},[707,1741,1742],{},"config\u002F"," you made before the first start gets what it lacks moved in. What both hold stays in ",[707,1745,1712],{},", and the ",[707,1748,1012],{}," row names both until you merge them. If a unit or shell also sets ",[707,1751,1736],{}," to the old default, the server refuses to start until you merge ",[707,1754,1712],{}," into ",[707,1757,1742],{}," and remove it.",[661,1760,1761,1762,1764,1765,1768,1769,1772,1773,1775],{},"A directory you point at elsewhere is never renamed. A ",[707,1763,1716],{}," that is a link (a dotfiles repo) isn't renamed, merged or read, except its ",[707,1766,1767],{},"harnesses\u002F"," until a ",[707,1770,1771],{},"config\u002Fharnesses"," exists. The start warns, naming the target: set ",[707,1774,1732],{}," to it.",[661,1777,1778,1784,1785,1787,1788,1791,1792,1795,1796,1799],{},[664,1779,1780,1781,1783],{},"A schedule's day of week ",[707,1782,828],{}," is Sunday, as in cron."," 1.4 accepted ",[707,1786,828],{}," and never fired it, so a ",[707,1789,1790],{},"0 9 * * 7"," trigger fires every Sunday after the update: change or remove it first if that isn't what you want. Ranges (",[707,1793,1794],{},"1-5",") and steps (",[707,1797,1798],{},"*\u002F15",") work now.",[661,1801,1802,1808,1809,1812,1813,1072,1815,1818],{},[664,1803,1536,1804,1807],{},[707,1805,1806],{},"steering\u002F"," directory is no longer read."," Every 1.x start folded it into ",[707,1810,1811],{},"library.yaml",". On a 0.x home updated straight to the new release, copy those files' text into ",[707,1814,1811],{},[707,1816,1817],{},"steering:"," by hand.",[661,1820,1821,1275,1824,1072,1826,1828,1829,1832,1833,1183,1835,1125,1838,1426,1840,1832,1843,1183,1845,1847,1848,1275,1850,1852,1853,1855,1856,1426,1858,1861,1862,1165,1864],{},[664,1822,1823],{},"Keys moved, and every old place is still read.",[707,1825,998],{},[707,1827,1006],{}," row names each old place you still have. The first start moves ",[707,1830,1831],{},"triggers:"," from ",[707,1834,405],{},[707,1836,1837],{},"schedules:",[707,1839,417],{},[707,1841,1842],{},"max_concurrent",[707,1844,417],{},[707,1846,405],{}," unless that already sets one. Until it does, the server ignores an ",[707,1849,417],{},[707,1851,1842],{},", with a warning. A repo's ",[707,1854,1654],{}," is read as ",[707,1857,1672],{},[707,1859,1860],{},"board.group_by: template"," as ",[707,1863,1577],{},[658,1865,1866,1882],{},[661,1867,1868,1869,1872,1873,1875,1876,1878,1879,1881],{},"Each file a key moves between is rewritten, readable by you alone (",[707,1870,1871],{},"0600","). A moved trigger takes its comments with it, and a comment line above ",[707,1874,1831],{}," that sits over the next key stays in ",[707,1877,405],{},": delete it by hand. A comment on the ",[707,1880,1842],{}," line is dropped.",[661,1883,1884,1885,1887,1888,1891,1892,1003,1895,1898,1899,1901,1902,1904],{},"A trigger the schedule format refuses (1.4 ignored an extra key such as ",[707,1886,802],{},"), or one whose ",[707,1889,1890],{},"cron"," is outside its field (",[707,1893,1894],{},"0 24 * * *",[707,1896,1897],{},"0 9 * * 8",") or uses digits other than 0-9, stays in ",[707,1900,405],{},", still read and fired or skipped with a warning. Doctor's ",[707,1903,1006],{}," row names the key.",[661,1906,1907,1913,1914,1916,1917,1920,1921,1925,1926,1003,1929,1932,1933,1936,1937,1072,1941,1944,1945,1128,1948,1951,1952,972,1955,656],{},[664,1908,1909,1910,1912],{},"Four ",[707,1911,387],{}," keys aren't read."," A repo still carrying one loads, the log names it once, and the ",[707,1915,1002],{}," row warns, naming what replaced it. Replace ",[707,1918,1919],{},"default_model"," with a model per ",[649,1922,1924],{"href":1923},"\u002Fconcepts\u002Fvocabulary#harness-profile","harness profile"," under ",[707,1927,1928],{},"models:",[707,1930,1931],{},"submodules"," with an entry per submodule, and ",[707,1934,1935],{},"default_root_merge_policy"," with a ",[649,1938,1940],{"href":1939},"\u002Fconcepts\u002Fvocabulary#workspace","workspace",[707,1942,1943],{},"root_pointer_default",". Remove ",[707,1946,1947],{},"allow_cross_repo",[707,1949,1950],{},"gitlab_project"," is still read as ",[707,1953,1954],{},"forge: gitlab",[707,1956,1957],{},"project:",[1106,1959,1961],{"id":1960},"the-interface","The interface",[658,1963,1964,1970,1991],{},[661,1965,1966,1969],{},[664,1967,1968],{},"The new interface replaced the old one, and some pages moved."," Old addresses open the right page and keep their query string. No action: the table below lists the moves.",[661,1971,1972,1978,1979,1982,1983,1990],{},[664,1973,1974,1975,1977],{},"The first start rewrites ",[707,1976,425],{}," once"," so the look you had stays, and keeps the original as ",[707,1980,1981],{},"theme.yaml.pre-2.0",". The ",[649,1984,1985,1237,1988],{"href":426},[707,1986,1987],{},"palette",[707,1989,425],{}," says how an old key loads. If it looks wrong, pick the surface, accent and amount of colour on Settings › Appearance.",[661,1992,1993,1996,1997,656],{},[664,1994,1995],{},"The VS Code extension needs the same major version as Kraft."," Against a 1.4 server it shows the board but disables every action, and a 1.4 extension is read-only against a newer server. Update Kraft and the extension together: the messages are in ",[649,1998,2000],{"href":1999},"\u002Freference\u002Fvscode-extension#if-the-extension-is-read-only","VS Code",[1585,2002,2003,2011],{},[1588,2004,2005],{},[1591,2006,2007,2009],{},[1594,2008,1596],{},[1594,2010,1599],{},[1604,2012,2013,2025,2042,2062,2080],{},[1591,2014,2015,2018],{},[1609,2016,2017],{},"Settings › Chains, and the old Templates page",[1609,2019,2020,2021,2024],{},"Templates › Chains (",[707,2022,2023],{},"\u002Ftemplates\u002Fchains",")",[1591,2026,2027,2030],{},[1609,2028,2029],{},"Settings › Library and Steering",[1609,2031,2032,2033,2036,2037,2041],{},"Templates › Library (",[707,2034,2035],{},"\u002Ftemplates\u002Flibrary","); ",[649,2038,2040],{"href":2039},"\u002Fconcepts\u002Fvocabulary#steering-profile","steering profiles"," are library components",[1591,2043,2044,2053],{},[1609,2045,2046,2047,1003,2050,2024],{},"Settings › Notifications and Auto-intake (",[707,2048,2049],{},"\u002Fsettings\u002Fnotify",[707,2051,2052],{},"\u002Fsettings\u002Fintake",[1609,2054,2055,2056,972,2059],{},"Same names, at ",[707,2057,2058],{},"\u002Fsettings\u002Fnotifications",[707,2060,2061],{},"\u002Fsettings\u002Fauto-intake",[1591,2063,2064,2070],{},[1609,2065,2066,2067,2024],{},"The Search page (",[707,2068,2069],{},"\u002Fsearch",[1609,2071,2072,2073,779,2076,2079],{},"The board, with the search box on ",[664,2074,2075],{},"⌘K",[664,2077,2078],{},"Ctrl+K",") from any page",[1591,2081,2082,2095],{},[1609,2083,2084,2085,2088,2089,1003,2092,2024],{},"A bookmark that began with ",[707,2086,2087],{},"\u002Fng",", or an item's tab address (",[707,2090,2091],{},"\u002Fwork-items\u002FID#tab=changes",[707,2093,2094],{},"#node=NAME",[1609,2096,2097,2099,2100,2102],{},[707,2098,2087],{}," drops its prefix. A tab address opens the item's review page, and ",[707,2101,2094],{}," opens that node",[645,2104,2105,2106,2109,2110,1125,2113,2116,2117,2120],{},"The phone layout (under 768 pixels wide), Cursor's ",[707,2107,2108],{},"-I"," hook entry, and agent profiles written as ",[707,2111,2112],{},"providers:",[707,2114,2115],{},"harnesses.yaml"," (the older ",[707,2118,2119],{},"model:"," map still loads) need nothing.",[697,2122,695],{"id":2123},"roll-back-to-14",[645,2125,2126,2127,2130,2131,2134,2135,2138],{},"Starting a newer Kraft migrates ",[707,2128,2129],{},"run\u002Forchestrator.db"," forward in place, and there is no downgrade migration: 1.4 refuses a database a newer release migrated (",[707,2132,2133],{},"database schema vN is newer than code vM",", in ",[707,2136,2137],{},"run\u002Flogs\u002Fserver.log","). A rollback puts back the release, the database as 1.4 left it (schema 44) and the config files the newer release changed. It loses everything done since that backup: items filed, runs, approvals and their history.",[645,2140,2141,2142,2146],{},"You need the database as 1.4 left it: a ",[649,2143,2145],{"href":2144},"\u002Fguides\u002Frun\u002Fback-up-and-restore#back-up-the-database","backup you took before the update",", or the copy Kraft made when you first left 1.4. That copy isn't always the newest, because a later upgrade adds a newer one that 1.4 refuses. A 1.5.0 release candidate before 1.5.0rc12 made no copy, and only your own backup rolls back.",[645,2148,2149,2150,735,2153,2156],{},"The commands that name your Kraft home set ",[707,2151,2152],{},"home",[707,2154,2155],{},"run"," themselves, so each block works in a new terminal. Step 1 only checks: if it finds no database you stop there and stay on the new release.",[758,2158,2159,2277,2300,2376,2518,2526],{},[661,2160,2161,2162,2166,2167,2170,2171,2223,2234,2236,2237,2239,2240,2274,2276],{},"Pick a database that prints schema 44, before you stop anything. For Kraft's copy, follow ",[649,2163,2165],{"href":2164},"\u002Fguides\u002Frun\u002Fback-up-and-restore#find-the-copy-to-restore","Find the copy to restore"," and take the newest one that prints 44. For your own backup, set ",[707,2168,2169],{},"backup"," to its path and read its schema (a backup taken after the update doesn't print 44).",[2172,2173,2178],"pre",{"className":2174,"code":2175,"language":2176,"meta":2177,"style":2177},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","backup=\"$HOME\u002Fkraft-backup-20261002-093015.db\"\nsqlite3 -readonly \"$backup\" 'PRAGMA user_version'\n","bash","",[707,2179,2180,2202],{"__ignoreMap":2177},[2181,2182,2185,2188,2192,2196,2199],"span",{"class":2183,"line":2184},"line",1,[2181,2186,2169],{"class":2187},"s7iLA",[2181,2189,2191],{"class":2190},"sklAV","=",[2181,2193,2195],{"class":2194},"semJd","\"",[2181,2197,2198],{"class":2187},"$HOME",[2181,2200,2201],{"class":2194},"\u002Fkraft-backup-20261002-093015.db\"\n",[2181,2203,2205,2208,2212,2215,2218,2220],{"class":2183,"line":2204},2,[2181,2206,734],{"class":2207},"szw1H",[2181,2209,2211],{"class":2210},"ssYy9"," -readonly",[2181,2213,2214],{"class":2194}," \"",[2181,2216,2217],{"class":2187},"$backup",[2181,2219,2195],{"class":2194},[2181,2221,2222],{"class":2194}," 'PRAGMA user_version'\n",[2172,2224,2229],{"className":2225,"code":2227,"language":2228,"meta":2177},[2226],"language-text","44\n","text",[707,2230,2231],{"__ignoreMap":2177},[2181,2232,2227],{"className":2233},[2183],[895,2235],{},"Without the ",[707,2238,734],{}," command, Python prints the same:",[2172,2241,2243],{"className":2174,"code":2242,"language":2176,"meta":2177,"style":2177},"backup=\"$HOME\u002Fkraft-backup-20261002-093015.db\"\npython3 -c \"import sqlite3, sys; print(sqlite3.connect('file:' + sys.argv[1] + '?mode=ro', uri=True).execute('PRAGMA user_version').fetchone()[0])\" \"$backup\"\n",[707,2244,2245,2257],{"__ignoreMap":2177},[2181,2246,2247,2249,2251,2253,2255],{"class":2183,"line":2184},[2181,2248,2169],{"class":2187},[2181,2250,2191],{"class":2190},[2181,2252,2195],{"class":2194},[2181,2254,2198],{"class":2187},[2181,2256,2201],{"class":2194},[2181,2258,2259,2261,2264,2267,2269,2271],{"class":2183,"line":2204},[2181,2260,738],{"class":2207},[2181,2262,2263],{"class":2210}," -c",[2181,2265,2266],{"class":2194}," \"import sqlite3, sys; print(sqlite3.connect('file:' + sys.argv[1] + '?mode=ro', uri=True).execute('PRAGMA user_version').fetchone()[0])\"",[2181,2268,2214],{"class":2194},[2181,2270,2217],{"class":2187},[2181,2272,2273],{"class":2194},"\"\n",[895,2275],{},"Write down the path: step 4 uses it. If no copy prints 44 and you have no backup of your own, stop here.",[661,2278,2279,2280,2283,2284,2288,2289,735,2292,2295,2296,2299],{},"Stop Kraft with ",[707,2281,2282],{},"kraft admin stop",", or as ",[649,2285,2287],{"href":2286},"\u002Fguides\u002Frun\u002Frun-as-a-service#stop-a-service","Stop a service"," says when Kraft runs as a service: the service manager starts a stopped server again. Go on only when it prints ",[707,2290,2291],{},"kraft: stopped (pid N)",[707,2293,2294],{},"kraft: no server running",". If it prints ",[707,2297,2298],{},"kraft: pid N did not stop within 15s"," and exits 1, the server still runs: don't touch the database.",[661,2301,2302,2303,889,2307,2309,2310,2346,2355,2357,2358,2361,2362,2364,2365,2367,2368,2371,2372,656],{},"Install 1.4 with the Python you run Kraft on and the extra you have. On Homebrew, which can't install an older release, see ",[649,2304,2306],{"href":2305},"\u002Fguides\u002Frun\u002Fupgrade-kraft#pin-a-version","Pin a version",[707,2308,892],{}," if you don't use vector search:",[2172,2311,2313],{"className":2174,"code":2312,"language":2176,"meta":2177,"style":2177},"uv tool install --force --python 3.X \"kraft-sdlc[vector]==1.4.0\"\nkraft --version\n",[707,2314,2315,2338],{"__ignoreMap":2177},[2181,2316,2317,2320,2323,2326,2329,2332,2335],{"class":2183,"line":2184},[2181,2318,2319],{"class":2207},"uv",[2181,2321,2322],{"class":2194}," tool",[2181,2324,2325],{"class":2194}," install",[2181,2327,2328],{"class":2210}," --force",[2181,2330,2331],{"class":2210}," --python",[2181,2333,2334],{"class":2194}," 3.X",[2181,2336,2337],{"class":2194}," \"kraft-sdlc[vector]==1.4.0\"\n",[2181,2339,2340,2343],{"class":2183,"line":2204},[2181,2341,2342],{"class":2207},"kraft",[2181,2344,2345],{"class":2210}," --version\n",[2172,2347,2350],{"className":2348,"code":2349,"language":2228,"meta":2177},[2226],"kraft 1.4.0\n",[707,2351,2352],{"__ignoreMap":2177},[2181,2353,2349],{"className":2354},[2183],[895,2356],{},"If it prints another version, 1.4 isn't what your shell runs: read the error the install printed, and run ",[707,2359,2360],{},"command -v kraft"," to see which ",[707,2363,2342],{}," comes first on ",[707,2366,742],{},". If you skipped step 2, the web UI says ",[664,2369,2370],{},"An older Kraft is installed"," and points to ",[649,2373,2375],{"href":2374},"\u002Fguides\u002Frun\u002Fupgrade-kraft#pin-or-roll-back-a-version","Pin or roll back a version",[661,2377,2378,2379,955,2383,2385,2386,2449,2457,2236,2459,2239,2461,2515,2517],{},"Restore the database from step 1: follow steps 2 and 3 of ",[649,2380,2382],{"href":2381},"\u002Fguides\u002Frun\u002Fback-up-and-restore#restore-a-backup","Restore a backup",[707,2384,2169],{}," set to the file from step 1. Skip its step 1, because step 2 here stopped Kraft, and its steps 4 and 5, because steps 5 and 6 here handle the config directory and start Kraft. Then check the restored database:",[2172,2387,2389],{"className":2174,"code":2388,"language":2176,"meta":2177,"style":2177},"run=\"${KRAFT_RUN_DIR:-${KRAFT_HOME:-$HOME\u002F.kraft}\u002Frun}\"\nsqlite3 -readonly \"$run\u002Forchestrator.db\" 'PRAGMA user_version'\n",[707,2390,2391,2433],{"__ignoreMap":2177},[2181,2392,2393,2395,2397,2400,2403,2406,2409,2412,2414,2416,2419,2421,2423,2426,2428,2430],{"class":2183,"line":2184},[2181,2394,2155],{"class":2187},[2181,2396,2191],{"class":2190},[2181,2398,2399],{"class":2194},"\"${",[2181,2401,2402],{"class":2187},"KRAFT_RUN_DIR",[2181,2404,2405],{"class":2190},":-",[2181,2407,2408],{"class":2194},"${",[2181,2410,2411],{"class":2187},"KRAFT_HOME",[2181,2413,2405],{"class":2190},[2181,2415,2198],{"class":2187},[2181,2417,2418],{"class":2190},"\u002F",[2181,2420,656],{"class":2194},[2181,2422,2342],{"class":2187},[2181,2424,2425],{"class":2194},"}",[2181,2427,2418],{"class":2190},[2181,2429,2155],{"class":2187},[2181,2431,2432],{"class":2194},"}\"\n",[2181,2434,2435,2437,2439,2441,2444,2447],{"class":2183,"line":2204},[2181,2436,734],{"class":2207},[2181,2438,2211],{"class":2210},[2181,2440,2214],{"class":2194},[2181,2442,2443],{"class":2187},"$run",[2181,2445,2446],{"class":2194},"\u002Forchestrator.db\"",[2181,2448,2222],{"class":2194},[2172,2450,2452],{"className":2451,"code":2227,"language":2228,"meta":2177},[2226],[707,2453,2454],{"__ignoreMap":2177},[2181,2455,2227],{"className":2456},[2183],[895,2458],{},[707,2460,734],{},[2172,2462,2464],{"className":2174,"code":2463,"language":2176,"meta":2177,"style":2177},"run=\"${KRAFT_RUN_DIR:-${KRAFT_HOME:-$HOME\u002F.kraft}\u002Frun}\"\npython3 -c \"import sqlite3, sys; print(sqlite3.connect('file:' + sys.argv[1] + '?mode=ro', uri=True).execute('PRAGMA user_version').fetchone()[0])\" \"$run\u002Forchestrator.db\"\n",[707,2465,2466,2500],{"__ignoreMap":2177},[2181,2467,2468,2470,2472,2474,2476,2478,2480,2482,2484,2486,2488,2490,2492,2494,2496,2498],{"class":2183,"line":2184},[2181,2469,2155],{"class":2187},[2181,2471,2191],{"class":2190},[2181,2473,2399],{"class":2194},[2181,2475,2402],{"class":2187},[2181,2477,2405],{"class":2190},[2181,2479,2408],{"class":2194},[2181,2481,2411],{"class":2187},[2181,2483,2405],{"class":2190},[2181,2485,2198],{"class":2187},[2181,2487,2418],{"class":2190},[2181,2489,656],{"class":2194},[2181,2491,2342],{"class":2187},[2181,2493,2425],{"class":2194},[2181,2495,2418],{"class":2190},[2181,2497,2155],{"class":2187},[2181,2499,2432],{"class":2194},[2181,2501,2502,2504,2506,2508,2510,2512],{"class":2183,"line":2204},[2181,2503,738],{"class":2207},[2181,2505,2263],{"class":2210},[2181,2507,2266],{"class":2194},[2181,2509,2214],{"class":2194},[2181,2511,2443],{"class":2187},[2181,2513,2514],{"class":2194},"\u002Forchestrator.db\"\n",[895,2516],{},"If it prints another number, repeat steps 1 and 4 with a copy that prints 44. If it prints an error, no database is in place: read the message the restore printed, and run it again.",[661,2519,2520,2521,2525],{},"Put the config files back as 1.4 reads them: follow ",[649,2522,2524],{"href":2523},"#put-the-config-files-back","Put the config files back"," below, then return here for step 6.",[661,2527,2528,2529,2532,2533,2536],{},"Start Kraft with ",[707,2530,2531],{},"kraft admin start --detach",", or with ",[707,2534,2535],{},"kraft admin install-service"," if it ran as a service.",[1106,2538,2524],{"id":2539},"put-the-config-files-back",[645,2541,2542,2543,2545],{},"A rollback doesn't undo what the newer release changed in ",[707,2544,1709],{},". Do these four steps with Kraft stopped, then go on to step 6 above.",[758,2547,2548,3004,3191,3331],{},[661,2549,2550,2551,1925,2553,2556,2557,2560,2561,2604],{},"Check the directory. 1.4 reads ",[707,2552,1716],{},[707,2554,2555],{},"$KRAFT_HOME",", which is ",[707,2558,2559],{},"~\u002F.kraft"," unless you set it. If you skip this, 1.4 seeds a fresh default home beside yours, with no repos:",[2172,2562,2564],{"className":2174,"code":2563,"language":2176,"meta":2177,"style":2177},"home=\"${KRAFT_HOME:-$HOME\u002F.kraft}\"\nls -ld \"$home\u002Ftemplates\"\n",[707,2565,2566,2588],{"__ignoreMap":2177},[2181,2567,2568,2570,2572,2574,2576,2578,2580,2582,2584,2586],{"class":2183,"line":2184},[2181,2569,2152],{"class":2187},[2181,2571,2191],{"class":2190},[2181,2573,2399],{"class":2194},[2181,2575,2411],{"class":2187},[2181,2577,2405],{"class":2190},[2181,2579,2198],{"class":2187},[2181,2581,2418],{"class":2190},[2181,2583,656],{"class":2194},[2181,2585,2342],{"class":2187},[2181,2587,2432],{"class":2194},[2181,2589,2590,2593,2596,2598,2601],{"class":2183,"line":2204},[2181,2591,2592],{"class":2207},"ls",[2181,2594,2595],{"class":2210}," -ld",[2181,2597,2214],{"class":2194},[2181,2599,2600],{"class":2187},"$home",[2181,2602,2603],{"class":2194},"\u002Ftemplates\"\n",[658,2605,2606,2616,2746,2993],{},[661,2607,2608,2615],{},[664,2609,2610,2611,2614],{},"A link (",[707,2612,2613],{},"templates -> config","):"," nothing to do.",[661,2617,2618,2623,2624,2626,2627,2630,2631,2633,2634],{},[664,2619,2620,853],{},[707,2621,2622],{},"No such file or directory"," the link is gone. This moves nothing if ",[707,2625,1716],{}," exists, because ",[707,2628,2629],{},"mv"," would put ",[707,2632,1742],{}," inside it:",[2172,2635,2637],{"className":2174,"code":2636,"language":2176,"meta":2177,"style":2177},"home=\"${KRAFT_HOME:-$HOME\u002F.kraft}\"\nif [ -e \"$home\u002Ftemplates\" ] || [ -L \"$home\u002Ftemplates\" ]; then\n  echo \"$home\u002Ftemplates exists: nothing moved\"\nelse\n  mv \"$home\u002Fconfig\" \"$home\u002Ftemplates\"\nfi\n",[707,2638,2639,2661,2702,2715,2721,2740],{"__ignoreMap":2177},[2181,2640,2641,2643,2645,2647,2649,2651,2653,2655,2657,2659],{"class":2183,"line":2184},[2181,2642,2152],{"class":2187},[2181,2644,2191],{"class":2190},[2181,2646,2399],{"class":2194},[2181,2648,2411],{"class":2187},[2181,2650,2405],{"class":2190},[2181,2652,2198],{"class":2187},[2181,2654,2418],{"class":2190},[2181,2656,656],{"class":2194},[2181,2658,2342],{"class":2187},[2181,2660,2432],{"class":2194},[2181,2662,2663,2666,2669,2672,2674,2676,2679,2682,2685,2687,2690,2692,2694,2696,2699],{"class":2183,"line":2204},[2181,2664,2665],{"class":2190},"if",[2181,2667,2668],{"class":2187}," [ ",[2181,2670,2671],{"class":2190},"-e",[2181,2673,2214],{"class":2194},[2181,2675,2600],{"class":2187},[2181,2677,2678],{"class":2194},"\u002Ftemplates\"",[2181,2680,2681],{"class":2187}," ] ",[2181,2683,2684],{"class":2190},"||",[2181,2686,2668],{"class":2187},[2181,2688,2689],{"class":2190},"-L",[2181,2691,2214],{"class":2194},[2181,2693,2600],{"class":2187},[2181,2695,2678],{"class":2194},[2181,2697,2698],{"class":2187}," ]; ",[2181,2700,2701],{"class":2190},"then\n",[2181,2703,2705,2708,2710,2712],{"class":2183,"line":2704},3,[2181,2706,2707],{"class":2210},"  echo",[2181,2709,2214],{"class":2194},[2181,2711,2600],{"class":2187},[2181,2713,2714],{"class":2194},"\u002Ftemplates exists: nothing moved\"\n",[2181,2716,2718],{"class":2183,"line":2717},4,[2181,2719,2720],{"class":2190},"else\n",[2181,2722,2724,2727,2729,2731,2734,2736,2738],{"class":2183,"line":2723},5,[2181,2725,2726],{"class":2207},"  mv",[2181,2728,2214],{"class":2194},[2181,2730,2600],{"class":2187},[2181,2732,2733],{"class":2194},"\u002Fconfig\"",[2181,2735,2214],{"class":2194},[2181,2737,2600],{"class":2187},[2181,2739,2603],{"class":2194},[2181,2741,2743],{"class":2183,"line":2742},6,[2181,2744,2745],{"class":2190},"fi\n",[661,2747,2748,2751,2752,2754,2755,1072,2757,2759,2760,2762,2763,2765,2766,2768,2769,2772,2773,2777,2778],{},[664,2749,2750],{},"A real directory, not a link:"," the first start found a ",[707,2753,1742],{}," you had made and couldn't merge the two (",[707,2756,998],{},[707,2758,1012],{}," row named both). Move what ",[707,2761,1712],{}," still holds into ",[707,2764,1742],{},", keeping the copy you want of each, then set ",[707,2767,1712],{}," aside and link it. Nothing is deleted: delete ",[707,2770,2771],{},"templates.old-\u003Ctime>"," once 1.4 runs and ",[649,2774,2776],{"href":2775},"#check-the-rollback","Check the rollback"," passes:",[2172,2779,2781],{"className":2174,"code":2780,"language":2176,"meta":2177,"style":2177},"home=\"${KRAFT_HOME:-$HOME\u002F.kraft}\"\nold=\"$home\u002Ftemplates.old-$(date +%Y%m%d-%H%M%S)\"\nif [ -L \"$home\u002Ftemplates\" ] || [ ! -d \"$home\u002Ftemplates\" ]; then\n  echo \"$home\u002Ftemplates is not a real folder: nothing moved\"\nelif [ ! -d \"$home\u002Fconfig\" ]; then\n  echo \"$home\u002Fconfig is not a folder: nothing moved\"\nelif [ -e \"$old\" ]; then\n  echo \"$old is already there: run this again\"\nelse\n  mv \"$home\u002Ftemplates\" \"$old\" && ln -s config \"$home\u002Ftemplates\" && ls -ld \"$home\u002Ftemplates\"\nfi\n",[707,2782,2783,2805,2825,2861,2872,2893,2904,2924,2936,2941,2988],{"__ignoreMap":2177},[2181,2784,2785,2787,2789,2791,2793,2795,2797,2799,2801,2803],{"class":2183,"line":2184},[2181,2786,2152],{"class":2187},[2181,2788,2191],{"class":2190},[2181,2790,2399],{"class":2194},[2181,2792,2411],{"class":2187},[2181,2794,2405],{"class":2190},[2181,2796,2198],{"class":2187},[2181,2798,2418],{"class":2190},[2181,2800,656],{"class":2194},[2181,2802,2342],{"class":2187},[2181,2804,2432],{"class":2194},[2181,2806,2807,2810,2812,2814,2816,2819,2822],{"class":2183,"line":2204},[2181,2808,2809],{"class":2187},"old",[2181,2811,2191],{"class":2190},[2181,2813,2195],{"class":2194},[2181,2815,2600],{"class":2187},[2181,2817,2818],{"class":2194},"\u002Ftemplates.old-$(",[2181,2820,2821],{"class":2207},"date",[2181,2823,2824],{"class":2194}," +%Y%m%d-%H%M%S)\"\n",[2181,2826,2827,2829,2831,2833,2835,2837,2839,2841,2843,2845,2848,2851,2853,2855,2857,2859],{"class":2183,"line":2704},[2181,2828,2665],{"class":2190},[2181,2830,2668],{"class":2187},[2181,2832,2689],{"class":2190},[2181,2834,2214],{"class":2194},[2181,2836,2600],{"class":2187},[2181,2838,2678],{"class":2194},[2181,2840,2681],{"class":2187},[2181,2842,2684],{"class":2190},[2181,2844,2668],{"class":2187},[2181,2846,2847],{"class":2190},"!",[2181,2849,2850],{"class":2190}," -d",[2181,2852,2214],{"class":2194},[2181,2854,2600],{"class":2187},[2181,2856,2678],{"class":2194},[2181,2858,2698],{"class":2187},[2181,2860,2701],{"class":2190},[2181,2862,2863,2865,2867,2869],{"class":2183,"line":2717},[2181,2864,2707],{"class":2210},[2181,2866,2214],{"class":2194},[2181,2868,2600],{"class":2187},[2181,2870,2871],{"class":2194},"\u002Ftemplates is not a real folder: nothing moved\"\n",[2181,2873,2874,2877,2879,2881,2883,2885,2887,2889,2891],{"class":2183,"line":2723},[2181,2875,2876],{"class":2190},"elif",[2181,2878,2668],{"class":2187},[2181,2880,2847],{"class":2190},[2181,2882,2850],{"class":2190},[2181,2884,2214],{"class":2194},[2181,2886,2600],{"class":2187},[2181,2888,2733],{"class":2194},[2181,2890,2698],{"class":2187},[2181,2892,2701],{"class":2190},[2181,2894,2895,2897,2899,2901],{"class":2183,"line":2742},[2181,2896,2707],{"class":2210},[2181,2898,2214],{"class":2194},[2181,2900,2600],{"class":2187},[2181,2902,2903],{"class":2194},"\u002Fconfig is not a folder: nothing moved\"\n",[2181,2905,2907,2909,2911,2913,2915,2918,2920,2922],{"class":2183,"line":2906},7,[2181,2908,2876],{"class":2190},[2181,2910,2668],{"class":2187},[2181,2912,2671],{"class":2190},[2181,2914,2214],{"class":2194},[2181,2916,2917],{"class":2187},"$old",[2181,2919,2195],{"class":2194},[2181,2921,2698],{"class":2187},[2181,2923,2701],{"class":2190},[2181,2925,2927,2929,2931,2933],{"class":2183,"line":2926},8,[2181,2928,2707],{"class":2210},[2181,2930,2214],{"class":2194},[2181,2932,2917],{"class":2187},[2181,2934,2935],{"class":2194}," is already there: run this again\"\n",[2181,2937,2939],{"class":2183,"line":2938},9,[2181,2940,2720],{"class":2190},[2181,2942,2944,2946,2948,2950,2952,2954,2956,2958,2961,2964,2967,2970,2972,2974,2976,2978,2980,2982,2984,2986],{"class":2183,"line":2943},10,[2181,2945,2726],{"class":2207},[2181,2947,2214],{"class":2194},[2181,2949,2600],{"class":2187},[2181,2951,2678],{"class":2194},[2181,2953,2214],{"class":2194},[2181,2955,2917],{"class":2187},[2181,2957,2195],{"class":2194},[2181,2959,2960],{"class":2187}," && ",[2181,2962,2963],{"class":2207},"ln",[2181,2965,2966],{"class":2210}," -s",[2181,2968,2969],{"class":2194}," config",[2181,2971,2214],{"class":2194},[2181,2973,2600],{"class":2187},[2181,2975,2678],{"class":2194},[2181,2977,2960],{"class":2187},[2181,2979,2592],{"class":2207},[2181,2981,2595],{"class":2210},[2181,2983,2214],{"class":2194},[2181,2985,2600],{"class":2187},[2181,2987,2603],{"class":2194},[2181,2989,2991],{"class":2183,"line":2990},11,[2181,2992,2745],{"class":2190},[661,2994,2995,3000,3001,3003],{},[664,2996,2997,2999],{},[707,2998,1732],{}," points elsewhere:"," the directory was never renamed. Point 1.4's ",[707,3002,1736],{}," at it instead.",[661,3005,3006,3007],{},"Edit each file in this table:",[1585,3008,3009,3022],{},[1588,3010,3011],{},[1591,3012,3013,3016,3019],{},[1594,3014,3015],{},"File",[1594,3017,3018],{},"What to change for 1.4",[1594,3020,3021],{},"If you skip it",[1604,3023,3024,3063,3098,3129,3157,3179],{},[1591,3025,3026,3030,3055],{},[1609,3027,3028],{},[707,3029,417],{},[1609,3031,3032,3033,1861,3035,3038,3039,1861,3041,1003,3044,1861,3046,3049,3050,1861,3052],{},"Write each schedule's ",[707,3034,1890],{},[707,3036,3037],{},"*"," or a comma list of numbers: ",[707,3040,1794],{},[707,3042,3043],{},"1,2,3,4,5",[707,3045,1798],{},[707,3047,3048],{},"0,15,30,45",", day ",[707,3051,828],{},[707,3053,3054],{},"0",[1609,3056,1536,3057,3059,3060,3062],{},[707,3058,1890],{}," with day ",[707,3061,828],{}," never fires",[1591,3064,3065,3071,3089],{},[1609,3066,3067,972,3069],{},[707,3068,417],{},[707,3070,405],{},[1609,3072,3073,3074,3076,3077,3079,3080,3082,3083,3085,3086],{},"Move the ",[707,3075,1837],{}," list under a ",[707,3078,1831],{}," key in ",[707,3081,405],{},", then delete the ",[707,3084,1837],{}," key, even ",[707,3087,3088],{},"schedules: []",[1609,3090,3091,3092,725,3095],{},"Auto-intake stays off while ",[707,3093,3094],{},"health",[707,3096,3097],{},"ok",[1591,3099,3100,3104,3123],{},[1609,3101,3102],{},[707,3103,405],{},[1609,3105,3106,3107,3109,3110,3113,3114,3116,3117,1128,3120,3122],{},"Add the ",[707,3108,1831],{}," key yourself: a seeded ",[707,3111,3112],{},"# triggers:"," is a comment, so pasting under it breaks the file. If a ",[707,3115,1831],{}," key is already there, paste under it. Delete ",[707,3118,3119],{},"forge_poll_s",[707,3121,1842],{}," needs nothing",[1609,3124,3125,3126,2024],{},"Every new item is refused (",[707,3127,3128],{},"policy config invalid, refusing work",[1591,3130,3131,3135,3148],{},[1609,3132,3133],{},[707,3134,387],{},[1609,3136,3137,3138,1183,3141,3144,3145,3147],{},"Rename each ",[707,3139,3140],{},"default_chain:",[707,3142,3143],{},"default_chain_template:",". Where an entry has both, keep the value of ",[707,3146,1672],{}," and delete that line",[1609,3149,3150,3151,3153,3154],{},"Doctor's ",[707,3152,1002],{}," row fails and the repo files on ",[707,3155,3156],{},"default",[1591,3158,3159,3163,3176],{},[1609,3160,3161],{},[707,3162,2115],{},[1609,3164,3165,3166,3168,3169,3171,3172,3175],{},"Rewrite each ",[707,3167,2112],{}," profile as one ",[707,3170,2119],{}," map by provider and one ",[707,3173,3174],{},"effort:",", as in step 3",[1609,3177,3178],{},"1.4 refuses the whole file",[1591,3180,3181,3185,3188],{},[1609,3182,3183],{},[707,3184,425],{},[1609,3186,3187],{},"Restore the theme, as in step 4",[1609,3189,3190],{},"The board shows default colours, or no theme",[661,3192,3193,3194,3196,3197,3200,3201,3203,3204],{},"Rewrite a ",[707,3195,2112],{}," profile in 1.4's shape. 1.4 has one ",[707,3198,3199],{},"effort"," per profile: where the providers set different ones, pick one. A profile already in the ",[707,3202,2119],{}," shape needs nothing:",[2172,3205,3209],{"className":3206,"code":3207,"language":3208,"meta":2177,"style":2177},"language-yaml shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","# newer release\nstrong:\n  providers:\n    claude: { model: sonnet, effort: high }\n    codex: { model: gpt-5.6-terra, effort: high }\n# 1.4\nstrong:\n  model: { claude: sonnet, codex: gpt-5.6-terra }\n  effort: high\n","yaml",[707,3210,3211,3217,3225,3232,3261,3285,3290,3296,3321],{"__ignoreMap":2177},[2181,3212,3213],{"class":2183,"line":2184},[2181,3214,3216],{"class":3215},"sq92B","# newer release\n",[2181,3218,3219,3222],{"class":2183,"line":2204},[2181,3220,664],{"class":3221},"sb7M8",[2181,3223,3224],{"class":2187},":\n",[2181,3226,3227,3230],{"class":2183,"line":2704},[2181,3228,3229],{"class":3221},"  providers",[2181,3231,3224],{"class":2187},[2181,3233,3234,3237,3240,3243,3246,3249,3251,3253,3255,3258],{"class":2183,"line":2717},[2181,3235,3236],{"class":3221},"    claude",[2181,3238,3239],{"class":2187},": { ",[2181,3241,3242],{"class":3221},"model",[2181,3244,3245],{"class":2187},": ",[2181,3247,3248],{"class":2194},"sonnet",[2181,3250,1003],{"class":2187},[2181,3252,3199],{"class":3221},[2181,3254,3245],{"class":2187},[2181,3256,3257],{"class":2194},"high",[2181,3259,3260],{"class":2187}," }\n",[2181,3262,3263,3266,3268,3270,3272,3275,3277,3279,3281,3283],{"class":2183,"line":2723},[2181,3264,3265],{"class":3221},"    codex",[2181,3267,3239],{"class":2187},[2181,3269,3242],{"class":3221},[2181,3271,3245],{"class":2187},[2181,3273,3274],{"class":2194},"gpt-5.6-terra",[2181,3276,1003],{"class":2187},[2181,3278,3199],{"class":3221},[2181,3280,3245],{"class":2187},[2181,3282,3257],{"class":2194},[2181,3284,3260],{"class":2187},[2181,3286,3287],{"class":2183,"line":2742},[2181,3288,3289],{"class":3215},"# 1.4\n",[2181,3291,3292,3294],{"class":2183,"line":2906},[2181,3293,664],{"class":3221},[2181,3295,3224],{"class":2187},[2181,3297,3298,3301,3303,3306,3308,3310,3312,3315,3317,3319],{"class":2183,"line":2926},[2181,3299,3300],{"class":3221},"  model",[2181,3302,3239],{"class":2187},[2181,3304,3305],{"class":3221},"claude",[2181,3307,3245],{"class":2187},[2181,3309,3248],{"class":2194},[2181,3311,1003],{"class":2187},[2181,3313,3314],{"class":3221},"codex",[2181,3316,3245],{"class":2187},[2181,3318,3274],{"class":2194},[2181,3320,3260],{"class":2187},[2181,3322,3323,3326,3328],{"class":2183,"line":2938},[2181,3324,3325],{"class":3221},"  effort",[2181,3327,3245],{"class":2187},[2181,3329,3330],{"class":2194},"high\n",[661,3332,3333,3334,3336,3337,3339,3340,3342,3343,3346,3347,3350,3351,3353,3354,3357,3358,3579,3581,3582,3584,3585,1183,3588,3591,3592,3595],{},"Restore the theme. 1.4 takes its colours from ",[707,3335,1987],{},", which the newer release removed. Copy the file kept beside ",[707,3338,425],{}," over it: ",[707,3341,1981],{},", or the copy a 1.5.0 release candidate made (",[707,3344,3345],{},"theme.yaml.pre-1.5",", or ",[707,3348,3349],{},"theme.yaml.pre-ux2"," from rc5 to rc9) if one converted the theme first. The block moves the current ",[707,3352,425],{}," aside as ",[707,3355,3356],{},"theme.yaml.before-rollback-\u003Ctime>"," and copies only when the source exists. Delete the dated file once 1.4 shows the theme you want:",[2172,3359,3361],{"className":2174,"code":3360,"language":2176,"meta":2177,"style":2177},"home=\"${KRAFT_HOME:-$HOME\u002F.kraft}\"\ncopy=\"$home\u002Ftemplates\u002Ftheme.yaml.pre-2.0\"\nsaved=\"$home\u002Ftemplates\u002Ftheme.yaml.before-rollback-$(date +%Y%m%d-%H%M%S)\"\nif [ ! -f \"$copy\" ]; then\n  echo \"$copy is not a file: nothing changed. Set copy to the right file, or edit theme.yaml by hand\"\nelif [ -e \"$saved\" ]; then\n  echo \"$saved is already there: run this again\"\nelif [ -e \"$home\u002Ftemplates\u002Ftheme.yaml\" ] && ! mv \"$home\u002Ftemplates\u002Ftheme.yaml\" \"$saved\"; then\n  echo \"could not move theme.yaml aside: nothing changed\"\nelse\n  cp \"$copy\" \"$home\u002Ftemplates\u002Ftheme.yaml\" && ls -l \"$home\u002Ftemplates\u002Ftheme.yaml\" || echo \"the copy failed: the theme you had is at $saved, if there was one\"\nfi\n",[707,3362,3363,3385,3399,3417,3439,3450,3469,3479,3519,3526,3530,3574],{"__ignoreMap":2177},[2181,3364,3365,3367,3369,3371,3373,3375,3377,3379,3381,3383],{"class":2183,"line":2184},[2181,3366,2152],{"class":2187},[2181,3368,2191],{"class":2190},[2181,3370,2399],{"class":2194},[2181,3372,2411],{"class":2187},[2181,3374,2405],{"class":2190},[2181,3376,2198],{"class":2187},[2181,3378,2418],{"class":2190},[2181,3380,656],{"class":2194},[2181,3382,2342],{"class":2187},[2181,3384,2432],{"class":2194},[2181,3386,3387,3390,3392,3394,3396],{"class":2183,"line":2204},[2181,3388,3389],{"class":2187},"copy",[2181,3391,2191],{"class":2190},[2181,3393,2195],{"class":2194},[2181,3395,2600],{"class":2187},[2181,3397,3398],{"class":2194},"\u002Ftemplates\u002Ftheme.yaml.pre-2.0\"\n",[2181,3400,3401,3404,3406,3408,3410,3413,3415],{"class":2183,"line":2704},[2181,3402,3403],{"class":2187},"saved",[2181,3405,2191],{"class":2190},[2181,3407,2195],{"class":2194},[2181,3409,2600],{"class":2187},[2181,3411,3412],{"class":2194},"\u002Ftemplates\u002Ftheme.yaml.before-rollback-$(",[2181,3414,2821],{"class":2207},[2181,3416,2824],{"class":2194},[2181,3418,3419,3421,3423,3425,3428,3430,3433,3435,3437],{"class":2183,"line":2717},[2181,3420,2665],{"class":2190},[2181,3422,2668],{"class":2187},[2181,3424,2847],{"class":2190},[2181,3426,3427],{"class":2190}," -f",[2181,3429,2214],{"class":2194},[2181,3431,3432],{"class":2187},"$copy",[2181,3434,2195],{"class":2194},[2181,3436,2698],{"class":2187},[2181,3438,2701],{"class":2190},[2181,3440,3441,3443,3445,3447],{"class":2183,"line":2723},[2181,3442,2707],{"class":2210},[2181,3444,2214],{"class":2194},[2181,3446,3432],{"class":2187},[2181,3448,3449],{"class":2194}," is not a file: nothing changed. Set copy to the right file, or edit theme.yaml by hand\"\n",[2181,3451,3452,3454,3456,3458,3460,3463,3465,3467],{"class":2183,"line":2742},[2181,3453,2876],{"class":2190},[2181,3455,2668],{"class":2187},[2181,3457,2671],{"class":2190},[2181,3459,2214],{"class":2194},[2181,3461,3462],{"class":2187},"$saved",[2181,3464,2195],{"class":2194},[2181,3466,2698],{"class":2187},[2181,3468,2701],{"class":2190},[2181,3470,3471,3473,3475,3477],{"class":2183,"line":2906},[2181,3472,2707],{"class":2210},[2181,3474,2214],{"class":2194},[2181,3476,3462],{"class":2187},[2181,3478,2935],{"class":2194},[2181,3480,3481,3483,3485,3487,3489,3491,3494,3497,3499,3502,3504,3506,3508,3510,3512,3514,3517],{"class":2183,"line":2926},[2181,3482,2876],{"class":2190},[2181,3484,2668],{"class":2187},[2181,3486,2671],{"class":2190},[2181,3488,2214],{"class":2194},[2181,3490,2600],{"class":2187},[2181,3492,3493],{"class":2194},"\u002Ftemplates\u002Ftheme.yaml\"",[2181,3495,3496],{"class":2187}," ] && ",[2181,3498,2847],{"class":2190},[2181,3500,3501],{"class":2207}," mv",[2181,3503,2214],{"class":2194},[2181,3505,2600],{"class":2187},[2181,3507,3493],{"class":2194},[2181,3509,2214],{"class":2194},[2181,3511,3462],{"class":2187},[2181,3513,2195],{"class":2194},[2181,3515,3516],{"class":2187},"; ",[2181,3518,2701],{"class":2190},[2181,3520,3521,3523],{"class":2183,"line":2938},[2181,3522,2707],{"class":2210},[2181,3524,3525],{"class":2194}," \"could not move theme.yaml aside: nothing changed\"\n",[2181,3527,3528],{"class":2183,"line":2943},[2181,3529,2720],{"class":2190},[2181,3531,3532,3535,3537,3539,3541,3543,3545,3547,3549,3551,3554,3556,3558,3560,3563,3566,3569,3571],{"class":2183,"line":2990},[2181,3533,3534],{"class":2207},"  cp",[2181,3536,2214],{"class":2194},[2181,3538,3432],{"class":2187},[2181,3540,2195],{"class":2194},[2181,3542,2214],{"class":2194},[2181,3544,2600],{"class":2187},[2181,3546,3493],{"class":2194},[2181,3548,2960],{"class":2187},[2181,3550,2592],{"class":2207},[2181,3552,3553],{"class":2210}," -l",[2181,3555,2214],{"class":2194},[2181,3557,2600],{"class":2187},[2181,3559,3493],{"class":2194},[2181,3561,3562],{"class":2190}," ||",[2181,3564,3565],{"class":2210}," echo",[2181,3567,3568],{"class":2194}," \"the copy failed: the theme you had is at ",[2181,3570,3462],{"class":2187},[2181,3572,3573],{"class":2194},", if there was one\"\n",[2181,3575,3577],{"class":2183,"line":3576},12,[2181,3578,2745],{"class":2190},[895,3580],{},"With no copy, open ",[707,3583,425],{},", change ",[707,3586,3587],{},"group_by: chain",[707,3589,3590],{},"group_by: template"," and delete an ",[707,3593,3594],{},"editor:"," line, or delete the file. 1.4 refuses both, and its board then loads no theme.",[1106,3597,2776],{"id":3598},"check-the-rollback",[645,3600,1031,3601,913,3603,972,3606,3608,3609,3612,3613,3616,3617,3620,3621,3624,3625,3627,3628,3630],{},[707,3602,987],{},[707,3604,3605],{},"kraft admin templates lint",[707,3607,998],{},". It worked when ",[707,3610,3611],{},"--version"," prints ",[707,3614,3615],{},"kraft 1.4.0",", the board loads, ",[707,3618,3619],{},"templates lint"," exits 0, and ",[707,3622,3623],{},"doctor"," shows no failing ",[707,3626,1716],{}," row (1.4's name for the config directory row) or ",[707,3629,1002],{}," row.",[645,3632,3633,3634,3636,3637,3639],{},"Each row of the table in ",[649,3635,2524],{"href":2523}," names its symptom: a ",[707,3638,2133],{}," line means the database isn't the one 1.4 left, so repeat steps 1 and 4.",[1106,3641,3643],{"id":3642},"what-the-restore-leaves-behind","What the restore leaves behind",[645,3645,3646,3647,3650],{},"Restoring loses everything done on the newer release since the backup. It doesn't remove what those runs made outside the database: their worktrees under ",[707,3648,3649],{},"run\u002Fworktrees\u002F",", their branches, and any merge requests they opened. 1.4 knows nothing about them.",[658,3652,3653,3661],{},[661,3654,3655,1072,3657,3660],{},[707,3656,998],{},[707,3658,3659],{},"worktrees"," row lists a worktree with no work item. Delete the ones you don't need, and close any merge request yourself. 1.4's row also lists the worktrees of items you cancelled on 1.4, which its board doesn't show.",[661,3662,3663,3664,3667,3668,3722,2236,3724,3726,3727],{},"A worktree made after the update is one whose ID isn't in the database you restored. This lists the IDs that are, and ",[707,3665,3666],{},"-readonly"," makes a wrong path an error, not an empty database where Kraft is about to start:",[2172,3669,3671],{"className":2174,"code":3670,"language":2176,"meta":2177,"style":2177},"run=\"${KRAFT_RUN_DIR:-${KRAFT_HOME:-$HOME\u002F.kraft}\u002Frun}\"\nsqlite3 -readonly \"$run\u002Forchestrator.db\" \"select id from work_items\"\n",[707,3672,3673,3707],{"__ignoreMap":2177},[2181,3674,3675,3677,3679,3681,3683,3685,3687,3689,3691,3693,3695,3697,3699,3701,3703,3705],{"class":2183,"line":2184},[2181,3676,2155],{"class":2187},[2181,3678,2191],{"class":2190},[2181,3680,2399],{"class":2194},[2181,3682,2402],{"class":2187},[2181,3684,2405],{"class":2190},[2181,3686,2408],{"class":2194},[2181,3688,2411],{"class":2187},[2181,3690,2405],{"class":2190},[2181,3692,2198],{"class":2187},[2181,3694,2418],{"class":2190},[2181,3696,656],{"class":2194},[2181,3698,2342],{"class":2187},[2181,3700,2425],{"class":2194},[2181,3702,2418],{"class":2190},[2181,3704,2155],{"class":2187},[2181,3706,2432],{"class":2194},[2181,3708,3709,3711,3713,3715,3717,3719],{"class":2183,"line":2204},[2181,3710,734],{"class":2207},[2181,3712,2211],{"class":2210},[2181,3714,2214],{"class":2194},[2181,3716,2443],{"class":2187},[2181,3718,2446],{"class":2194},[2181,3720,3721],{"class":2194}," \"select id from work_items\"\n",[895,3723],{},[707,3725,734],{}," command:",[2172,3728,3730],{"className":2174,"code":3729,"language":2176,"meta":2177,"style":2177},"run=\"${KRAFT_RUN_DIR:-${KRAFT_HOME:-$HOME\u002F.kraft}\u002Frun}\"\npython3 -c \"import sqlite3, sys; [print(r[0]) for r in sqlite3.connect('file:' + sys.argv[1] + '?mode=ro', uri=True).execute('select id from work_items')]\" \"$run\u002Forchestrator.db\"\n",[707,3731,3732,3766],{"__ignoreMap":2177},[2181,3733,3734,3736,3738,3740,3742,3744,3746,3748,3750,3752,3754,3756,3758,3760,3762,3764],{"class":2183,"line":2184},[2181,3735,2155],{"class":2187},[2181,3737,2191],{"class":2190},[2181,3739,2399],{"class":2194},[2181,3741,2402],{"class":2187},[2181,3743,2405],{"class":2190},[2181,3745,2408],{"class":2194},[2181,3747,2411],{"class":2187},[2181,3749,2405],{"class":2190},[2181,3751,2198],{"class":2187},[2181,3753,2418],{"class":2190},[2181,3755,656],{"class":2194},[2181,3757,2342],{"class":2187},[2181,3759,2425],{"class":2194},[2181,3761,2418],{"class":2190},[2181,3763,2155],{"class":2187},[2181,3765,2432],{"class":2194},[2181,3767,3768,3770,3772,3775,3777,3779],{"class":2183,"line":2204},[2181,3769,738],{"class":2207},[2181,3771,2263],{"class":2210},[2181,3773,3774],{"class":2194}," \"import sqlite3, sys; [print(r[0]) for r in sqlite3.connect('file:' + sys.argv[1] + '?mode=ro', uri=True).execute('select id from work_items')]\"",[2181,3776,2214],{"class":2194},[2181,3778,2443],{"class":2187},[2181,3780,2514],{"class":2194},[697,3782,655],{"id":3783},"from-a-release-candidate-or-0x",[645,3785,3786,3787,3789],{},"In each case, back up the database first, as step 1 of ",[649,3788,766],{"href":765}," says, and keep the file name: a rollback to 1.4 needs it.",[1106,3791,3793],{"id":3792},"a-150-release-candidate","A 1.5.0 release candidate",[645,3795,3796],{},"Pause the running items first, or wait until none run.",[658,3798,3799,3811,3830],{},[661,3800,3801,1275,3804,3806,3807,3810],{},[664,3802,3803],{},"1.5.0rc14:",[707,3805,755],{}," follows the release-candidate channel. ",[707,3808,3809],{},"kraft admin update --channel stable"," waits for the next stable release.",[661,3812,3813,1275,3816,3818,3819,3821,3822,3825,3826,913,3828,656],{},[664,3814,3815],{},"1.5.0rc13:",[707,3817,755],{}," installs without ",[707,3820,892],{},", as 1.4's does. Use the ",[707,3823,3824],{},"uv tool install"," command from ",[649,3827,671],{"href":670},[707,3829,967],{},[661,3831,3832,1275,3835,3837,3838,3840],{},[664,3833,3834],{},"An earlier candidate:",[707,3836,755],{}," says you are up to date. Use the same ",[707,3839,3824],{}," command.",[645,3842,3843,3844,3846,3847,972,3849,3851,3852,656],{},"Restart with ",[707,3845,967],{}," unless the update did, then check ",[707,3848,987],{},[707,3850,724],{},". If vector search stopped, reinstall the extra as in ",[649,3853,1044],{"href":1043},[645,3855,1536,3856,3859,3860,3864,3865,3868],{},[707,3857,3858],{},"uv.lock"," an open item's setup wrote under rc14 was recorded without a digest, so a rebase can stop on it: ",[649,3861,3863],{"href":3862},"\u002Ftroubleshooting\u002Fworktree-and-git-stops#git-wouldnt-start-the-rebase","Git wouldn't start the rebase"," has the steps, ending in ",[707,3866,3867],{},"kraft item retry ID",". Items started on the new release record a digest.",[645,3870,3871,3872,3875,3876,3879],{},"An update run by rc14 pins one Python patch release where uv recorded none. Run ",[707,3873,3874],{},"grep python \"$(uv tool dir)\u002Fkraft-sdlc\u002Fuv-receipt.toml\"",", and if it shows a path, run the ",[707,3877,3878],{},"uv tool install --force --python 3.X …"," command once.",[1106,3881,3883,3884,3887],{"id":3882},"an-install-from-before-the-kraft-sdlc-rename","An install from before the ",[707,3885,3886],{},"kraft-sdlc"," rename",[645,3889,3890,3891,3893,3894,3896,3897,3899],{},"If ",[707,3892,755],{}," stops and names two commands, a ",[707,3895,2342],{}," uv tool still sits beside ",[707,3898,3886],{},". Run both:",[2172,3901,3903],{"className":2174,"code":3902,"language":2176,"meta":2177,"style":2177},"uv tool uninstall kraft\nuv tool install --force --reinstall kraft-sdlc\n",[707,3904,3905,3917],{"__ignoreMap":2177},[2181,3906,3907,3909,3911,3914],{"class":2183,"line":2184},[2181,3908,2319],{"class":2207},[2181,3910,2322],{"class":2194},[2181,3912,3913],{"class":2194}," uninstall",[2181,3915,3916],{"class":2194}," kraft\n",[2181,3918,3919,3921,3923,3925,3927,3930],{"class":2183,"line":2204},[2181,3920,2319],{"class":2207},[2181,3922,2322],{"class":2194},[2181,3924,2325],{"class":2194},[2181,3926,2328],{"class":2210},[2181,3928,3929],{"class":2210}," --reinstall",[2181,3931,3932],{"class":2194}," kraft-sdlc\n",[1106,3934,3936],{"id":3935},"a-0x-home","A 0.x home",[645,3938,3939,3940,3943,3944,3946,3947,3949,3950,3955],{},"A 0.x home holds a ",[707,3941,3942],{},"registry.yaml"," and no ",[707,3945,1811],{},". The server starts degraded and refuses new work until ",[707,3948,755],{}," replaces the configuration. Read the ",[649,3951,3954],{"href":3952,"rel":3953},"https:\u002F\u002Fgithub.com\u002FitsOmidKarami\u002Fkraft\u002Fblob\u002Fmain\u002FCHANGELOG.md#100",[875],"1.0.0 changelog"," first.",[758,3957,3958,3964,3970,3988,3999],{},[661,3959,3960,3961,3963],{},"Finish or abandon in-flight items, then stop the old server with ",[707,3962,2282],{},". Before 0.6.0, stop it in its own terminal. Back up the database as above.",[661,3965,3966,3967,993],{},"Install the newest release with the tool you installed Kraft with, as ",[649,3968,17],{"href":3969},"\u002Fget-started\u002Finstall#installation-methods",[661,3971,1031,3972,3974,3975,1183,3978,3981,3982,3984,3985,3987],{},[707,3973,755],{},", and answer ",[707,3976,3977],{},"y",[707,3979,3980],{},"Replace it? [y\u002FN]",", or pass ",[707,3983,1252],{},". With no terminal and no ",[707,3986,1252],{}," it exits 1. If the release feed is unreachable afterwards, it exits 1 with the configuration already replaced: running it again changes nothing, because no 0.x files are left.",[661,3989,1031,3990,3346,3992,3994,3995,3998],{},[707,3991,2531],{},[707,3993,967],{}," if a server runs: it still holds its degraded state. ",[707,3996,3997],{},"kraft admin reload"," loads the new configuration with no restart.",[661,4000,1031,4001,972,4003,3608,4005,4007,4008,725,4011,4013,4014,4017,4018,4021],{},[707,4002,987],{},[707,4004,724],{},[707,4006,3611],{}," prints a 2.x release and ",[707,4009,4010],{},"status",[707,4012,3097],{},". A ",[707,4015,4016],{},"degraded"," server with an ",[707,4019,4020],{},"invalid template"," row needs step 4.",[645,4023,4024,4025,779,4028,4031,4032,4034,4035,4037,4038,1072,4040,1818],{},"The old configuration stays whole in ",[707,4026,4027],{},"config.pre-v1-\u003Ctime>",[707,4029,4030],{},"templates.pre-v1-\u003Ctime>"," before a 2.x server has started). Most files carry across, and ",[707,4033,405],{}," keeps each key the format still has, printing the rest. Chains, the registry and ",[707,4036,1806],{}," stay only in the backup: copy the steering text into ",[707,4039,1811],{},[707,4041,1817],{},[697,4043,4045],{"id":4044},"next-steps","Next steps",[658,4047,4048,4053,4058],{},[661,4049,4050,4052],{},[649,4051,199],{"href":200},": the backup, the update and the check that every upgrade uses",[661,4054,4055,4057],{},[649,4056,187],{"href":188},": take the backup 1.4 needs and find the copy to roll back to",[661,4059,4060,4063],{},[649,4061,620],{"href":4062},"\u002Fproject\u002Fwhats-new#kraft-20-a-place-to-work-not-just-an-engine",": what you get for these changes",[4065,4066,4067],"style",{},"html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sq92B, html code.shiki .sq92B{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#BDC4CC}html pre.shiki code .sb7M8, html code.shiki .sb7M8{--shiki-light:#024C1A;--shiki-default:#024C1A;--shiki-dark:#72F088}",{"title":2177,"searchDepth":2204,"depth":2204,"links":4069},[4070,4071,4073,4074,4076,4083,4089,4098],{"id":699,"depth":2204,"text":700},{"id":749,"depth":2204,"text":4072},"Update from 1.​4",{"id":979,"depth":2204,"text":980},{"id":1019,"depth":2204,"text":4075},"If you used 1.​4's update anyway",{"id":1092,"depth":2204,"text":676,"children":4077},[4078,4079,4080,4081,4082],{"id":1108,"depth":2704,"text":783},{"id":1192,"depth":2704,"text":806},{"id":1301,"depth":2704,"text":1302},{"id":1699,"depth":2704,"text":833},{"id":1960,"depth":2704,"text":1961},{"id":2123,"depth":2204,"text":4084,"children":4085},"Roll back to 1.​4",[4086,4087,4088],{"id":2539,"depth":2704,"text":2524},{"id":3598,"depth":2704,"text":2776},{"id":3642,"depth":2704,"text":3643},{"id":3783,"depth":2204,"text":4090,"children":4091},"From a release candidate or 0.​x",[4092,4094,4096],{"id":3792,"depth":2704,"text":4093},"A 1.​5.​0 release candidate",{"id":3882,"depth":2704,"text":4095},"An install from before the kraft-​sdlc rename",{"id":3935,"depth":2704,"text":4097},"A 0.​x home",{"id":4044,"depth":2204,"text":4045},"Update a 1.4 install to the current release without losing the database, act on the changes that need it, and go back to 1.4 if the update goes wrong.","md",null,{},true,{"title":207,"description":4099},"z0sqQSTZviplb7F7C1KYnKRAmRNrQTU068uCXT08xC0",[4107,4109],{"title":203,"path":204,"stem":205,"description":4108,"children":-1},"Replace the full copies of Kraft's chains in your config with thin chains that extend the built-in kraft-default, so each upgrade brings you its changes and your edits stay.",{"title":211,"path":212,"stem":213,"description":4110,"children":-1},"See what the worktrees use, make room by archiving or abandoning items or from Settings › Storage, and set a limit with automatic clean-up.",1794749031859]