[{"data":1,"prerenderedAt":1395},["ShallowReactive",2],{"navigation_docs":3,"-troubleshooting-caps-budgets-and-waits":639,"-troubleshooting-caps-budgets-and-waits-surround":1390},[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":250,"body":641,"description":1383,"extension":1384,"links":1385,"meta":1386,"navigation":1387,"path":251,"seo":1388,"stem":252,"__hash__":1389},"docs\u002F4.troubleshooting\u002F03.caps-budgets-and-waits.md",{"type":642,"value":643,"toc":1366},"minimark",[644,661,665,799,803,955,958,969,1002,1008,1011,1032,1050,1079,1082,1096,1104,1107,1132,1135,1142,1145,1149,1154,1157,1164,1168,1173,1184,1348],[645,646,647,648,652,653,656,657,660],"p",{},"The first column is the text the board and ",[649,650,651],"code",{},"kraft view show ID"," print. ",[649,654,655],{},"..."," stands for text that varies. A row either holds the whole fix or links to an entry below. ",[658,659,105],"a",{"href":106}," covers lifting a cap and retrying.",[662,663,44],"h2",{"id":664},"caps-and-budgets",[666,667,668,684],"table",{},[669,670,671],"thead",{},[672,673,674,678,681],"tr",{},[675,676,677],"th",{},"The reason says",[675,679,680],{},"What happened",[675,682,683],{},"Fix",[685,686,687,710,742,772],"tbody",{},[672,688,689,695,698],{},[690,691,692],"td",{},[649,693,694],{},"budget cap reached: ... on this work item",[690,696,697],{},"The item's own dollar cap refused the next launch.",[690,699,700,701,704,705,709],{},"Run ",[649,702,703],{},"kraft item raise-budget ID --usd N",": it raises the cap and retries in one step. Or select ",[706,707,708],"strong",{},"Raise cap"," on the item.",[672,711,712,717,720],{},[690,713,714],{},[649,715,716],{},"budget cap reached: ... today, across every work item",[690,718,719],{},"The daily cap, which nothing on the item raises, refused the next launch.",[690,721,722,723,726,727,729,730,733,734,737,738,741],{},"Raise ",[649,724,725],{},"budget.daily_usd"," in ",[649,728,405],{},", or wait for local midnight, then run ",[649,731,732],{},"kraft item retry ID",". ",[649,735,736],{},"raise-budget"," is refused, and the item's page offers ",[706,739,740],{},"Retry"," with no raise.",[672,743,744,753,764],{},[690,745,746,749,750],{},[649,747,748],{},"budget_usd reached ...",", ",[649,751,752],{},"token budget reached ...",[690,754,755,756,759,760,763],{},"A policy ",[649,757,758],{},"budget_usd"," or ",[649,761,762],{},"token_budget"," refused the next launch.",[690,765,766,767,771],{},"See ",[658,768,770],{"href":769},"#a-policy-budget-or-token-cap-refused-the-launch","A policy budget or token cap refused the launch",".",[672,773,774,779,789],{},[690,775,776],{},[649,777,778],{},"budget_usd cannot be checked: N launch(es) in ... reported no cost, and unknown spend is never counted as free ...",[690,780,781,782,786,787,771],{},"A launch ran on a ",[658,783,785],{"href":784},"\u002Fconcepts\u002Fvocabulary#harness","harness"," that reports no cost, on a model Kraft can't price, so it can't show the scope is under its ",[649,788,758],{},[690,790,700,791,794,795,771],{},[649,792,793],{},"kraft item set-policy ID --policy budget_usd=none",". See ",[658,796,798],{"href":797},"#a-budget-cap-cant-be-checked","A budget cap can't be checked",[662,800,802],{"id":801},"time-caps-and-waits","Time caps and waits",[666,804,805,815],{},[669,806,807],{},[672,808,809,811,813],{},[675,810,677],{},[675,812,680],{},[675,814,683],{},[685,816,817,837,858,890,905,924,940],{},[672,818,819,824,827],{},[690,820,821],{},[649,822,823],{},"\u003Cscope> hit its time cap of N minutes",[690,825,826],{},"A time cap ran out.",[690,828,700,829,832,833,794,835,771],{},[649,830,831],{},"kraft item set-policy ID --policy time_cap_minutes=240",", then ",[649,834,732],{},[658,836,105],{"href":106},[672,838,839,844,847],{},[690,840,841],{},[649,842,843],{},"\u003Cscope> hit its total time cap of N minutes",[690,845,846],{},"A scope's wall-clock cap, which waits and gates count toward, ran out.",[690,848,700,849,832,852,854,855,771],{},[649,850,851],{},"kraft item set-policy ID --policy total_time_cap_minutes=N",[649,853,732],{},". A node or task needs its path in the key, such as ",[649,856,857],{},"merge_request_feedback.ci.await_ci.total_time_cap_minutes=N",[672,859,860,870,876],{},[690,861,862,865,866],{},[649,863,864],{},"\u003Ctask> showed no output for N minutes"," ",[867,868,869],"em",{},"Added in 2.3",[690,871,872,873,771],{},"An agent session wrote nothing to its log for ",[649,874,875],{},"agent_idle_minutes",[690,877,878,879,882,883,885,886,726,888,771],{},"Read its log with ",[649,880,881],{},"kraft view logs ID",", then run ",[649,884,732],{},". If it was working, raise ",[649,887,875],{},[649,889,405],{},[672,891,892,897,900],{},[690,893,894],{},[649,895,896],{},"gate \u003Cgate> waited past its timeout of N minutes",[690,898,899],{},"A gate went undecided past its timeout.",[690,901,700,902,904],{},[649,903,732],{}," to reopen the gate, then decide it.",[672,906,907,912,915],{},[690,908,909],{},[649,910,911],{},"\u003Ctask> timed out waiting ...",[690,913,914],{},"An external wait (CI, a review) ran out.",[690,916,917,918,794,920,771],{},"Fix what the wait needed, then run ",[649,919,732],{},[658,921,923],{"href":922},"#waiting-on-ci-or-a-review","Waiting on CI or a review",[672,925,926,932,935],{},[690,927,928,929],{},"A CI or automated-review failure, with a suggested ",[706,930,931],{},"retry",[690,933,934],{},"CI failed for its own reasons, or a cancelled run has no successor.",[690,936,700,937,939],{},[649,938,732],{}," once CI has recovered.",[672,941,942,947,950],{},[690,943,944],{},[649,945,946],{},"rate_limit retries exhausted after N attempt(s)",[690,948,949],{},"The agent's provider kept refusing for a rate limit.",[690,951,952,953,771],{},"Wait for the limit to reset, then run ",[649,954,732],{},[662,956,770],{"id":957},"a-policy-budget-or-token-cap-refused-the-launch",[645,959,755,960,759,962,964,965,968],{},[649,961,758],{},[649,963,762],{}," refused the next launch. The message names the scope: ",[649,966,967],{},"the work item",", or a node, step or task path in backticks.",[645,970,971,973,974,976,977,979,980,982,983,759,985,988,989,749,991,994,995,997,998,1001],{},[649,972,736],{}," is refused for a ",[649,975,762],{}," or a path, and the item's page offers ",[706,978,740],{}," with no raise. ",[658,981,105],{"href":106}," has the fix for each scope: ",[706,984,708],{},[649,986,987],{},"kraft item raise-budget"," for the item-wide ",[649,990,758],{},[649,992,993],{},"kraft item set-policy"," for a ",[649,996,762],{},", and for a cap the chain sets on a path, ",[649,999,1000],{},"kraft item skip"," or a change to the chain.",[645,1003,1004,1005,1007],{},"The item's policy was fixed when it was filed, so editing ",[649,1006,405],{}," or the chain reaches only items filed afterwards.",[662,1009,798],{"id":1010},"a-budget-cap-cant-be-checked",[645,1012,1013,1014,1017,1018,1020,1021,1025,1026,1028,1029,1031],{},"A launch in that scope ran on a harness that reports tokens but no cost, on a model ",[649,1015,1016],{},"prices.json"," can't price. Kraft can't show the scope is under its ",[649,1019,758],{}," and won't count the launch as free. Which harnesses these are is on ",[658,1022,1024],{"href":1023},"\u002Freference\u002Fharnesses\u002Fcost-reporting#harnesses-that-report-no-cost","Harnesses that report no cost",". Raising ",[649,1027,758],{}," doesn't help: the stop stays while any ",[649,1030,758],{}," applies to the scope.",[1033,1034,1035,1046],"ol",{},[1036,1037,1038,1039,1041,1042,1045],"li",{},"Clear the item-wide cap with ",[649,1040,793],{},". Add ",[649,1043,1044],{},"--policy token_budget=N"," to keep a bound.",[1036,1047,700,1048,771],{},[649,1049,732],{},[645,1051,1052,1053,1056,1057,749,1060,1062,1063,1065,1066,1069,1070,1072,1073,1075,1076,1078],{},"The ",[649,1054,1055],{},"budget_usd=none"," fix clears a cap from the chain's own ",[649,1058,1059],{},"policy:",[649,1061,387],{}," or a ",[649,1064,405],{}," default too, but is refused under a ",[649,1067,1068],{},"maxima.work_item.budget_usd",", and doesn't lift a cap the chain set on a node, step or task. For those, skip that node with ",[649,1071,1000],{},", or bound that harness's scopes with ",[649,1074,762],{}," in place of ",[649,1077,758],{}," and file the item again.",[662,1080,923],{"id":1081},"waiting-on-ci-or-a-review",[645,1083,1084,1085,733,1088,1092,1093,771],{},"Kraft keeps checking on both waits. One that outlasts its timeout stops the item with ",[649,1086,1087],{},"\u003Ctask> timed out waiting",[658,1089,1091],{"href":1090},"#waiting-for-a-machine","A step waiting for a machine"," never stops the item with ",[649,1094,1095],{},"timed out waiting",[1097,1098,1100,1103],"h3",{"id":1099},"merge_request_feedback-waits-on-no-checks-yet",[649,1101,1102],{},"merge_request_feedback"," waits on \"no checks yet\"",[645,1105,1106],{},"The merge request has no CI checks, so nothing ever passes. Do one of these:",[1108,1109,1110,1113,1125],"ul",{},[1036,1111,1112],{},"Add CI that runs on merge requests.",[1036,1114,1115,1116,1119,1120,1124],{},"Set ",[649,1117,1118],{},"ci_checks: false"," on the repo's entry in ",[658,1121,1122],{"href":388},[649,1123,387],{},", so both CI waits, before and after the merge, pass at once.",[1036,1126,1127,1128,1131],{},"File the item on the ",[649,1129,1130],{},"quick-task"," chain.",[645,1133,1134],{},"A merge request that conflicts with its base branch doesn't wait here, although GitHub runs no checks on it. Kraft rebases the branch onto the base at once, and a conflict the rebase can't resolve stops the item instead of the wait running out.",[1097,1136,1138,1141],{"id":1137},"external_approval-keeps-waiting",[649,1139,1140],{},"external_approval"," keeps waiting",[645,1143,1144],{},"A branch rule on the forge requires an approving review. Have someone else approve the merge request, or remove the rule. Kraft checks again on its own.",[1097,1146,1148],{"id":1147},"on-gitlab-which-pipeline-counts","On GitLab, which pipeline counts",[645,1150,1151],{},[867,1152,1153],{},"Added in 2.2",[645,1155,1156],{},"Kraft reads the newest pipeline that ran for the branch's head commit, branch pipelines and merge request pipelines alike. A merged results pipeline counts too. It runs on a merge commit of the branch into its target, and Kraft accepts it when that merge commit was built from the current head.",[645,1158,1159,1160,1163],{},"Right after a push the log reads ",[649,1161,1162],{},"no pipeline for \u003Csha> yet"," until GitLab starts a pipeline for the new head. A line after it naming a merged results pipeline says why that one wasn't taken: it tested another commit, or its merge commit couldn't be read.",[1097,1165,1167],{"id":1166},"waiting-for-a-machine","Waiting for a machine",[645,1169,1170],{},[867,1171,1172],{},"Added in 2.4",[645,1174,1175,1176,1179,1180,1183],{},"A step placed on a machine waits while that machine is offline, full or disabled. A step placed on a group, or on ",[649,1177,1178],{},"any",", waits while none of its machines is free. Run ",[649,1181,1182],{},"kraft admin worker list",": an offline machine shows why, and a full one shows its slots in use. The step starts when the machine is back or a slot frees, and Kraft looks again every 30 seconds.",[666,1185,1186,1199],{},[669,1187,1188],{},[672,1189,1190,1193,1196],{},[675,1191,1192],{},"The item shows",[675,1194,1195],{},"What it means",[675,1197,1198],{},"Do this",[685,1200,1201,1214,1227,1250,1266,1290,1312,1336],{},[672,1202,1203,1208,1211],{},[690,1204,1205],{},[649,1206,1207],{},"waiting for gpu-box (offline: ...)",[690,1209,1210],{},"The machine is offline, and the text says why.",[690,1212,1213],{},"Fix what it names.",[672,1215,1216,1221,1224],{},[690,1217,1218],{},[649,1219,1220],{},"waiting for gpu-box (full)",[690,1222,1223],{},"Every slot of the machine is in use.",[690,1225,1226],{},"Wait for a slot.",[672,1228,1229,1234,1245],{},[690,1230,1231],{},[649,1232,1233],{},"waiting for gpu-box (disabled)",[690,1235,1236,1237,1240,1241,1244],{},"Someone turned the machine's ",[649,1238,1239],{},"enabled"," off, so it takes no new steps. It wins over ",[649,1242,1243],{},"offline"," in the text, because it is a choice.",[690,1246,700,1247,771],{},[649,1248,1249],{},"kraft admin worker enable gpu-box",[672,1251,1252,1260,1263],{},[690,1253,1254,749,1257],{},[649,1255,1256],{},"waiting for a machine in gpu",[649,1258,1259],{},"waiting for any machine allowed for kraft",[690,1261,1262],{},"None of the group's or the allowed machines is free.",[690,1264,1265],{},"Wait: the step starts on the first member that frees.",[672,1267,1268,1273,1285],{},[690,1269,1270],{},[649,1271,1272],{},"waiting for local (2 of 2 running)",[690,1274,1275,1276,726,1279,1284],{},"A local step waits for a slot of the local worker, which ",[649,1277,1278],{},"local: capacity",[658,1280,1282],{"href":1281},"\u002Fconcepts\u002Fhow-workers-and-machines-behave#the-local-worker",[649,1283,483],{}," limits. It has no session yet.",[690,1286,1287,1288,771],{},"Wait for a slot, or raise ",[649,1289,1278],{},[672,1291,1292,1297,1303],{},[690,1293,1294],{},[649,1295,1296],{},"waiting for local (disabled)",[690,1298,1299,1300,771],{},"The same wait, with ",[649,1301,1302],{},"local: enabled: false",[690,1304,1115,1305,1308,1309,771],{},[649,1306,1307],{},"local: enabled"," back to ",[649,1310,1311],{},"true",[672,1313,1314,1323,1333],{},[690,1315,1316,1319,1320],{},[649,1317,1318],{},"waiting for test group heavy: 36djfdgg is running it",", or ",[649,1321,1322],{},"... is running it on gpu-box",[690,1324,1325,1326,1332],{},"A test scope waits for another scope of its ",[658,1327,1329],{"href":1328},"\u002Freference\u002Fconfiguration\u002Frepos#concurrency_group",[649,1330,1331],{},"concurrency_group"," to finish on the same machine, the local worker or a remote one.",[690,1334,1335],{},"Wait: it starts when one ends.",[672,1337,1338,1343,1346],{},[690,1339,1340],{},[649,1341,1342],{},"waiting for test group heavy is held on 2 machines",[690,1344,1345],{},"Several machines of the group are held.",[690,1347,1335],{},[645,1349,1350,1351,1354,1355,1358,1359,1362,1363,1365],{},"To run the step elsewhere, change its placement with ",[649,1352,1353],{},"kraft item set-node-override ID --node N --runner local",". Kraft never runs the step anywhere else, and the wait doesn't count against the step's ",[649,1356,1357],{},"time_cap_minutes","; a ",[649,1360,1361],{},"total_time_cap_minutes"," still counts it. A step on a named machine or on ",[649,1364,1178],{}," shows its wait on the board too, whatever the reason.",{"title":1367,"searchDepth":1368,"depth":1368,"links":1369},"",2,[1370,1371,1372,1373,1374],{"id":664,"depth":1368,"text":44},{"id":801,"depth":1368,"text":802},{"id":957,"depth":1368,"text":770},{"id":1010,"depth":1368,"text":798},{"id":1081,"depth":1368,"text":923,"children":1375},[1376,1379,1381,1382],{"id":1099,"depth":1377,"text":1378},3,"merge_​request_​feedback waits on \"no checks yet\"",{"id":1137,"depth":1377,"text":1380},"external_​approval keeps waiting",{"id":1147,"depth":1377,"text":1148},{"id":1166,"depth":1377,"text":1167},"Fix a work item that stopped on a dollar, token or time cap, and one that waits on CI, a review, a gate or a machine and nothing moves.","md",null,{},true,{"title":250,"description":1383},"2FK9r04xHs8wlrzGcK2gen1uLvYK0bGVaJXThPFgk_c",[1391,1393],{"title":246,"path":247,"stem":248,"description":1392,"children":-1},"Fix a work item that stopped before its task ran, because Kraft refused the launch, couldn't make the worktree, or found a repo setting, registration or model it can't use.",{"title":254,"path":255,"stem":256,"description":1394,"children":-1},"Fix a work item that stopped because the forge refused its credentials, rate-limited it, couldn't be reached, or no longer matches the account the item first used.",1794749047080]