[{"data":1,"prerenderedAt":1333},["ShallowReactive",2],{"navigation_docs":3,"-reference-chain-nodes-merge-queue-drops":639,"-reference-chain-nodes-merge-queue-drops-surround":1328},[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":513,"body":641,"description":1321,"extension":1322,"links":1323,"meta":1324,"navigation":1325,"path":514,"seo":1326,"stem":515,"__hash__":1327},"docs\u002F5.reference\u002F04.chain-nodes\u002F5.merge-queue-drops.md",{"type":642,"value":643,"toc":1317},"minimark",[644,651,663,674,711,714,729,825,835,838,844,850,857,864,871,897,910,915,929,1061,1067,1077,1090,1233,1247,1251,1260,1270,1283,1301,1313],[645,646,647],"p",{},[648,649,650],"em",{},"Added in 2.3",[645,652,653,654,658,659,662],{},"A ",[655,656,657],"strong",{},"GitLab merge train"," or ",[655,660,661],{},"GitHub merge queue"," doesn't merge a merge\nrequest when asked. It queues it, then runs a further pipeline on the merge\nrequest combined with the target branch and everything ahead of it. That\npipeline can fail after the merge request's own pipeline went green, because the\ntarget moved or because it runs tests the merge request pipeline doesn't.",[645,664,665,668,669,673],{},[655,666,667],{},"Detection."," Kraft reads from the forge, each time the ",[670,671,672],"code",{},"merge"," node runs,\nwhether the target branch merges through a train or queue. There is no setting\nto turn on. A repository without one waits for the merge exactly as before.",[675,676,677,689,696,705],"ul",{},[678,679,680,681,684,685,688],"li",{},"GitLab: the project must have both ",[670,682,683],{},"merge_trains_enabled"," and\n",[670,686,687],{},"merge_pipelines_enabled",". A project that doesn't report them, or a read the\nforge refuses (403 or 404), counts as having no train.",[678,690,691,692,695],{},"GitLab, queueing: on a train project Kraft adds the merge request through the\nmerge-train API with the reviewed commit's sha, so it never merges a head\nnobody reviewed. Only when the project read says there is no train does Kraft\nmerge with ",[670,693,694],{},"glab mr merge",".",[678,697,698,699,701,702,704],{},"GitLab, a failed project read: a read that fails any other way, such as a 5xx,\na timeout or an answer that isn't the project, fails the merge as a failed\n",[670,700,694],{}," would. On GitLab before 19.1 ",[670,703,694],{}," can merge\nwithout going through the train.",[678,706,707,708,710],{},"GitHub: the target branch has a merge queue. Kraft blames only a failed\nmerge-group run created after the merge request's latest enqueue, so a failure\nfrom an earlier drop is never held against the current head. When there is\nno such run, for example because the checks don't run on GitHub Actions, a\nremoval reason that names failed or timed-out checks or CI counts as ",[670,709,670],{},",\nand that reason is what the repair is given.",[645,712,713],{},"A read of the train or queue that fails says nothing about the merge, so Kraft\nkeeps waiting and notes it in the log. A drop is noticed on the next poll of the\nmerge wait. When the forge hasn't yet written why (no GitLab system note, no\nGitHub removal event for this entry), Kraft keeps waiting and reads it again on\nthe next poll, up to the merge wait's own timeout.",[645,715,716,719,720,723,724,728],{},[655,717,718],{},"The drop."," Each drop is recorded as a ",[670,721,722],{},"merge_queue_dropped"," event with its\ncause, the forge's reason, the failed jobs and the head. See the\n",[725,726,727],"a",{"href":590},"events",". The cause is one of five:",[730,731,732,748],"table",{},[733,734,735],"thead",{},[736,737,738,742,745],"tr",{},[739,740,741],"th",{},"Cause",[739,743,744],{},"What it means",[739,746,747],{},"What Kraft does",[749,750,751,768,784,799,812],"tbody",{},[736,752,753,758,761],{},[754,755,756],"td",{},[670,757,670],{},[754,759,760],{},"The train or queue jobs failed.",[754,762,763,764,767],{},"Rebases the branch onto the target as it is now, hands the failed jobs and their log tails to the ",[670,765,766],{},"repair",", then restarts.",[736,769,770,775,778],{},[754,771,772],{},[670,773,774],{},"conflict",[754,776,777],{},"The merge request no longer merges cleanly with the target.",[754,779,780,781,783],{},"Rebases the branch. A clean rebase restarts with no agent. A rebase that conflicts goes to the ",[670,782,766],{}," to resolve, then Kraft restarts.",[736,785,786,791,794],{},[754,787,788],{},[670,789,790],{},"not_added",[754,792,793],{},"GitLab only: the merge request never reached the train, because its own checks failed while it waited to be added.",[754,795,796,797,695],{},"Treated as ",[670,798,670],{},[736,800,801,806,809],{},[754,802,803],{},[670,804,805],{},"infra",[754,807,808],{},"The train or queue's own runners failed.",[754,810,811],{},"Asks the forge to queue the same head again, with no agent and no restart, up to 2 times. Then it stops for you.",[736,813,814,819,822],{},[754,815,816],{},[670,817,818],{},"other",[754,820,821],{},"A person took it off the train or queue, or the forge's reason can't be read.",[754,823,824],{},"Stops for you. Kraft never re-queues what a person removed, and no repair, recovery or escalation agent runs for it.",[645,826,827,830,831,834],{},[655,828,829],{},"The restart."," After the repair commits, or after a clean conflict rebase,\nKraft reopens the approved gates in the span, gives the span's fix loops a\nfresh count and re-runs from ",[670,832,833],{},"restart_from",". The head goes through the merge\nrequest's pipeline and your final review again, and is then queued again.",[645,836,837],{},"The next agent is told why in a note. The review brief opens with a \"Merge\ntrain\u002Fqueue rejection\" section giving the cause, the reason, the failed jobs and\nwhat the repair changed.",[645,839,840,843],{},[655,841,842],{},"What stops the item."," The repair must commit: a head the train already\nrejected would only be rejected again, so a repair that commits nothing, fails\nor asks a question stops for you.",[645,845,846,847,849],{},"When a repair had already committed before it\nstopped, whether it asked, failed, was paused or ran out of budget, the item is\nheld at ",[670,848,833],{}," with the span's gates reopened. A commit counts on the\nitem's branch in its own checkout or in any workspace member still to merge,\nnot only in the one whose merge request was dropped.",[645,851,852,853,856],{},"A repair that stopped before committing leaves the item on the merge node.\nWhatever brings it back there, a resume, the rate-limit retry or your\n",[670,854,855],{},"kraft item retry",", runs the repair again, with your steer, and never queues\nthe head the train rejected.",[645,858,859,860,863],{},"Only a retry from the chain's ",[670,861,862],{},"chain_finalized"," gate (or, with none, the last\ngate before the merge node), or from a node before it, goes through that gate\nand then queues the head again. A retry from a node after it, a later gate\nincluded, repairs again.",[645,865,866,867,870],{},"The same goes for a Kraft restart while the repair works or the restart is\nunder way: if a repair had started or the branch moved, the resume holds the\nitem there and stops for you. A retry then walks back through ",[670,868,869],{},"final_review",",\nand the commit is never merged unseen.",[645,872,873,876,877,880,881,883,884,887,888,892,893,896],{},[655,874,875],{},"The cap."," Rewinds are counted under ",[670,878,879],{},"\u003Cnode>.on_merge_rejected",": 3 attempts\nover 7 days unless ",[670,882,405],{}," names that key under ",[670,885,886],{},"loops:",". See\n",[725,889,891],{"href":890},"\u002Freference\u002Fconfiguration\u002Fpolicy#loop-keys","Loop keys",". Kraft checks it before\nthe repair agent runs, and at the cap the item stops with the kind ",[670,894,895],{},"cap",",\nwithout running an agent. A retry from a person resets it.",[645,898,899,902,903,906,907,909],{},[655,900,901],{},"Skipping a node."," When ",[670,904,905],{},"kraft item create --skip-nodes"," skips the node that\n",[670,908,833],{}," names, it moves to the nearest earlier exec node that is kept. If\nnone is left, the policy is dropped.",[911,912,914],"h2",{"id":913},"writing-the-node","Writing the node",[645,916,917,918,921,922,925,926,928],{},"The shipped ",[670,919,920],{},"default"," chain sets ",[670,923,924],{},"on_merge_rejected"," on its ",[670,927,672],{}," node:",[930,931,937],"pre",{"className":932,"code":933,"filename":934,"language":935,"meta":936,"style":936},"language-yaml shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","- id: merge\n  kind: exec\n  tasks:\n    - id: merge\n      extends: merge_mr\n  on_merge_rejected:\n    restart_from: merge_request_feedback\n    repair:\n      tasks:\n        - id: repair\n          extends: repair_merge_queue_failure\n","config\u002Fchains\u002Fdefault.yaml","yaml","",[670,938,939,959,970,979,991,1002,1010,1021,1029,1037,1050],{"__ignoreMap":936},[940,941,944,948,952,955],"span",{"class":942,"line":943},"line",1,[940,945,947],{"class":946},"s7iLA","- ",[940,949,951],{"class":950},"sb7M8","id",[940,953,954],{"class":946},": ",[940,956,958],{"class":957},"semJd","merge\n",[940,960,962,965,967],{"class":942,"line":961},2,[940,963,964],{"class":950},"  kind",[940,966,954],{"class":946},[940,968,969],{"class":957},"exec\n",[940,971,973,976],{"class":942,"line":972},3,[940,974,975],{"class":950},"  tasks",[940,977,978],{"class":946},":\n",[940,980,982,985,987,989],{"class":942,"line":981},4,[940,983,984],{"class":946},"    - ",[940,986,951],{"class":950},[940,988,954],{"class":946},[940,990,958],{"class":957},[940,992,994,997,999],{"class":942,"line":993},5,[940,995,996],{"class":950},"      extends",[940,998,954],{"class":946},[940,1000,1001],{"class":957},"merge_mr\n",[940,1003,1005,1008],{"class":942,"line":1004},6,[940,1006,1007],{"class":950},"  on_merge_rejected",[940,1009,978],{"class":946},[940,1011,1013,1016,1018],{"class":942,"line":1012},7,[940,1014,1015],{"class":950},"    restart_from",[940,1017,954],{"class":946},[940,1019,1020],{"class":957},"merge_request_feedback\n",[940,1022,1024,1027],{"class":942,"line":1023},8,[940,1025,1026],{"class":950},"    repair",[940,1028,978],{"class":946},[940,1030,1032,1035],{"class":942,"line":1031},9,[940,1033,1034],{"class":950},"      tasks",[940,1036,978],{"class":946},[940,1038,1040,1043,1045,1047],{"class":942,"line":1039},10,[940,1041,1042],{"class":946},"        - ",[940,1044,951],{"class":950},[940,1046,954],{"class":946},[940,1048,1049],{"class":957},"repair\n",[940,1051,1053,1056,1058],{"class":942,"line":1052},11,[940,1054,1055],{"class":950},"          extends",[940,1057,954],{"class":946},[940,1059,1060],{"class":957},"repair_merge_queue_failure\n",[645,1062,1063,1064,695],{},"The keys are in ",[725,1065,924],{"href":1066},"\u002Freference\u002Fchain-nodes#on_merge_rejected",[645,1068,1069,1070,1072,1073,1076],{},"A node with ",[670,1071,924],{}," can't also declare a ",[670,1074,1075],{},"fix_loop",": only the repair answers a drop, because a fix cycle's commit would be merged by the next measure unseen.",[645,1078,1079,1080,1083,1084,1086,1087,1089],{},"It may declare an ",[670,1081,1082],{},"on_failure",", on the node or on one of its own steps or tasks, for a merge that fails for another reason than a drop, but only a ",[725,1085,525],{"href":526}," one. Such a handler can wait, retry, comment or ask for approval again. Kraft then asks the forge to merge again in place, the head ",[670,1088,869],{}," approved.",[930,1091,1093],{"className":932,"code":1092,"language":935,"meta":936,"style":936},"- id: merge\n  kind: exec\n  tasks:\n    - id: merge\n      extends: merge_mr\n  on_failure:\n    read_only: true\n    tasks:\n      - id: wait\n        extends: await_external_approval\n  on_merge_rejected:\n    restart_from: merge_request_feedback\n    repair:\n      tasks:\n        - id: repair\n          extends: repair_merge_queue_failure\n",[670,1094,1095,1105,1113,1119,1129,1137,1144,1155,1162,1174,1184,1190,1199,1206,1213,1224],{"__ignoreMap":936},[940,1096,1097,1099,1101,1103],{"class":942,"line":943},[940,1098,947],{"class":946},[940,1100,951],{"class":950},[940,1102,954],{"class":946},[940,1104,958],{"class":957},[940,1106,1107,1109,1111],{"class":942,"line":961},[940,1108,964],{"class":950},[940,1110,954],{"class":946},[940,1112,969],{"class":957},[940,1114,1115,1117],{"class":942,"line":972},[940,1116,975],{"class":950},[940,1118,978],{"class":946},[940,1120,1121,1123,1125,1127],{"class":942,"line":981},[940,1122,984],{"class":946},[940,1124,951],{"class":950},[940,1126,954],{"class":946},[940,1128,958],{"class":957},[940,1130,1131,1133,1135],{"class":942,"line":993},[940,1132,996],{"class":950},[940,1134,954],{"class":946},[940,1136,1001],{"class":957},[940,1138,1139,1142],{"class":942,"line":1004},[940,1140,1141],{"class":950},"  on_failure",[940,1143,978],{"class":946},[940,1145,1146,1149,1151],{"class":942,"line":1012},[940,1147,1148],{"class":950},"    read_only",[940,1150,954],{"class":946},[940,1152,1154],{"class":1153},"ssYy9","true\n",[940,1156,1157,1160],{"class":942,"line":1023},[940,1158,1159],{"class":950},"    tasks",[940,1161,978],{"class":946},[940,1163,1164,1167,1169,1171],{"class":942,"line":1031},[940,1165,1166],{"class":946},"      - ",[940,1168,951],{"class":950},[940,1170,954],{"class":946},[940,1172,1173],{"class":957},"wait\n",[940,1175,1176,1179,1181],{"class":942,"line":1039},[940,1177,1178],{"class":950},"        extends",[940,1180,954],{"class":946},[940,1182,1183],{"class":957},"await_external_approval\n",[940,1185,1186,1188],{"class":942,"line":1052},[940,1187,1007],{"class":950},[940,1189,978],{"class":946},[940,1191,1193,1195,1197],{"class":942,"line":1192},12,[940,1194,1015],{"class":950},[940,1196,954],{"class":946},[940,1198,1020],{"class":957},[940,1200,1202,1204],{"class":942,"line":1201},13,[940,1203,1026],{"class":950},[940,1205,978],{"class":946},[940,1207,1209,1211],{"class":942,"line":1208},14,[940,1210,1034],{"class":950},[940,1212,978],{"class":946},[940,1214,1216,1218,1220,1222],{"class":942,"line":1215},15,[940,1217,1042],{"class":946},[940,1219,951],{"class":950},[940,1221,954],{"class":946},[940,1223,1049],{"class":957},[940,1225,1227,1229,1231],{"class":942,"line":1226},16,[940,1228,1055],{"class":950},[940,1230,954],{"class":946},[940,1232,1060],{"class":957},[645,1234,1235,1236,1239,1240,1243,1244,1246],{},"An ",[670,1237,1238],{},"on_base_changed"," on this node, or on any node with an ",[670,1241,1242],{},"mr.merge"," task after the ",[670,1245,862],{}," gate, must restart before that gate: a conflict resolution would otherwise be merged unseen.",[911,1248,1250],{"id":1249},"what-the-repair-and-the-escalation-do","What the repair and the escalation do",[645,1252,1253,1254,1256,1257,1259],{},"A node's ",[670,1255,924],{}," names the\nrepair and where the chain restarts. In the shipped chain the gates in the\nrestarted span include ",[670,1258,869],{},", so you see the repaired code before it\ngoes back onto the train.",[645,1261,1262,1263,1266,1267,1269],{},"If a read_only handler changes the worktree all the same, the item stops with\n",[670,1264,1265],{},"read_only_violated",", held at ",[670,1268,833],{}," with the span's gates reopened, so\nno retry merges the change unseen.",[645,1271,1272,1275,1276,1279,1280,1282],{},[655,1273,1274],{},"Escalation."," A commit made while the item is stopped on this node is never\nmerged in place, whether its ",[670,1277,1278],{},"escalation"," task made it or an escalation agent\ndid, Kraft's automatic one or one you sent. Kraft holds the item at\n",[670,1281,833],{}," with the span's gates reopened, the way it does after a\nrepair's commit.",[645,1284,1285,1286,1288,1289,1291,1292,1294,1295,1297,1298,1300],{},"A successful ",[670,1287,1278],{}," task that committed rewinds the chain there, under\nthe same cap, instead of re-running the node; one that changed nothing re-runs\nit. A tip Kraft can't read, before the escalation or after it, counts as a\nchange. An escalation agent's own ",[670,1290,855],{}," of this node, or of any\nnode after ",[670,1293,833],{},", restarts at ",[670,1296,833],{},"; one it names at or\nbefore ",[670,1299,833],{}," already passes the gates again, and runs as named.",[645,1302,1303,1304,1306,1307,1309,1310,1312],{},"Without ",[670,1305,924],{},", a drop stops the item at once, with the forge's\nreason in the stop, even when the drop comes on the re-measure after the\nnode's ",[670,1308,1082],{},". No ",[670,1311,1082],{}," or fix loop on the node runs for it, and\nno escalation agent is sent to the stop: Kraft never re-queues a merge request\non its own.",[1314,1315,1316],"style",{},"html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sb7M8, html code.shiki .sb7M8{--shiki-light:#024C1A;--shiki-default:#024C1A;--shiki-dark:#72F088}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}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 .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}",{"title":936,"searchDepth":961,"depth":961,"links":1318},[1319,1320],{"id":913,"depth":961,"text":914},{"id":1249,"depth":961,"text":1250},"How Kraft detects a drop from a GitLab merge train or GitHub merge queue, what each cause makes it do, and when the item stops.","md",null,{},true,{"title":513,"description":1321},"oO-RJ41QpW1bxArFSA5h3rc9Et84_JHlmSR-kV8WNzI",[1329,1331],{"title":509,"path":510,"stem":511,"description":1330,"children":-1},"The JSON file a task writes at $KRAFT_RESULT_PATH, and every field Kraft reads from it.",{"title":517,"path":518,"stem":519,"description":1332,"children":-1},"The head the approval of a chain_finalized gate pins, and what a later mr.merge task may merge once it is recorded.",1794749036069]