[{"data":1,"prerenderedAt":2017},["ShallowReactive",2],{"navigation_docs":3,"-troubleshooting-why-did-my-item-stop":504,"-troubleshooting-why-did-my-item-stop-surround":2012},[4,28,51,187,214,469],{"title":5,"path":6,"stem":7,"children":8},"Get started","\u002Fget-started","1.get-started",[9,12,16,20,24],{"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},"FAQ","\u002Fget-started\u002Ffaq","1.get-started\u002F3.faq",{"title":29,"path":30,"stem":31,"children":32},"Concepts","\u002Fconcepts","2.concepts",[33,35,39,43,47],{"title":10,"path":30,"stem":34},"2.concepts\u002Findex",{"title":36,"path":37,"stem":38},"How a work item runs","\u002Fconcepts\u002Fhow-a-work-item-runs","2.concepts\u002F1.how-a-work-item-runs",{"title":40,"path":41,"stem":42},"Caps and budgets","\u002Fconcepts\u002Fcaps-and-budgets","2.concepts\u002F2.caps-and-budgets",{"title":44,"path":45,"stem":46},"Why a permission gate","\u002Fconcepts\u002Fpermission-gate","2.concepts\u002F3.permission-gate",{"title":48,"path":49,"stem":50},"Vocabulary","\u002Fconcepts\u002Fvocabulary","2.concepts\u002F4.vocabulary",{"title":52,"path":53,"stem":54,"children":55},"Guides","\u002Fguides","3.guides",[56,58,96,113,134,183],{"title":10,"path":53,"stem":57},"3.guides\u002Findex",{"title":59,"path":60,"stem":61,"children":62,"page":95},"Day to day","\u002Fguides\u002Fday-to-day","3.guides\u002F1.day-to-day",[63,67,71,75,79,83,87,91],{"title":64,"path":65,"stem":66},"The setup wizard on first start","\u002Fguides\u002Fday-to-day\u002Ffirst-run","3.guides\u002F1.day-to-day\u002F2.first-run",{"title":68,"path":69,"stem":70},"File a work item","\u002Fguides\u002Fday-to-day\u002Ffile-a-work-item","3.guides\u002F1.day-to-day\u002F3.file-a-work-item",{"title":72,"path":73,"stem":74},"Use Kraft from your agent","\u002Fguides\u002Fday-to-day\u002Fagent-integration","3.guides\u002F1.day-to-day\u002F4.agent-integration",{"title":76,"path":77,"stem":78},"Reviewing a change","\u002Fguides\u002Fday-to-day\u002Freview-a-change","3.guides\u002F1.day-to-day\u002F5.review-a-change",{"title":80,"path":81,"stem":82},"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":84,"path":85,"stem":86},"Kraft for VS Code","\u002Fguides\u002Fday-to-day\u002Fvscode","3.guides\u002F1.day-to-day\u002F7.vscode",{"title":88,"path":89,"stem":90},"Kraft on a phone","\u002Fguides\u002Fday-to-day\u002Fkraft-on-a-phone","3.guides\u002F1.day-to-day\u002F8.kraft-on-a-phone",{"title":92,"path":93,"stem":94},"Get notified when an item needs you","\u002Fguides\u002Fday-to-day\u002Fnotifications","3.guides\u002F1.day-to-day\u002F9.notifications",false,{"title":97,"path":98,"stem":99,"children":100,"page":95},"Customize and automate","\u002Fguides\u002Fcustomize","3.guides\u002F2.customize",[101,105,109],{"title":102,"path":103,"stem":104},"Write your own chain","\u002Fguides\u002Fcustomize\u002Fwrite-your-own-chain","3.guides\u002F2.customize\u002F1.write-your-own-chain",{"title":106,"path":107,"stem":108},"Add a security review or a gate reviewer","\u002Fguides\u002Fcustomize\u002Fadd-review-agents","3.guides\u002F2.customize\u002F2.add-review-agents",{"title":110,"path":111,"stem":112},"Schedule or webhook work","\u002Fguides\u002Fcustomize\u002Fschedule-and-webhook-work","3.guides\u002F2.customize\u002F3.schedule-and-webhook-work",{"title":114,"path":115,"stem":116,"children":117,"page":95},"Agents and harnesses","\u002Fguides\u002Fharnesses","3.guides\u002F3.harnesses",[118,122,126,130],{"title":119,"path":120,"stem":121},"Switch a task to another harness","\u002Fguides\u002Fharnesses\u002Fswitch-harness","3.guides\u002F3.harnesses\u002F1.switch-harness",{"title":123,"path":124,"stem":125},"Add or override a harness","\u002Fguides\u002Fharnesses\u002Fadding-a-harness","3.guides\u002F3.harnesses\u002F2.adding-a-harness",{"title":127,"path":128,"stem":129},"Build a worker Kit","\u002Fguides\u002Fharnesses\u002Fworker-kit","3.guides\u002F3.harnesses\u002F3.worker-kit",{"title":131,"path":132,"stem":133},"Give a worker its login","\u002Fguides\u002Fharnesses\u002Fgive-a-worker-its-login","3.guides\u002F3.harnesses\u002F4.give-a-worker-its-login",{"title":135,"path":136,"stem":137,"children":138,"page":95},"Run the server","\u002Fguides\u002Frun","3.guides\u002F4.run",[139,143,147,151,155,159,163,167,171,175,179],{"title":140,"path":141,"stem":142},"Remote access","\u002Fguides\u002Frun\u002Fremote-access","3.guides\u002F4.run\u002F01.remote-access",{"title":144,"path":145,"stem":146},"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":148,"path":149,"stem":150},"Restart Kraft without ending running agents","\u002Fguides\u002Frun\u002Frestart-kraft","3.guides\u002F4.run\u002F03.restart-kraft",{"title":152,"path":153,"stem":154},"Back up and restore the database","\u002Fguides\u002Frun\u002Fback-up-and-restore","3.guides\u002F4.run\u002F04.back-up-and-restore",{"title":156,"path":157,"stem":158},"Logs and disk space","\u002Fguides\u002Frun\u002Flogs-and-disk-space","3.guides\u002F4.run\u002F05.logs-and-disk-space",{"title":160,"path":161,"stem":162},"Run Kraft as a service","\u002Fguides\u002Frun\u002Frun-as-a-service","3.guides\u002F4.run\u002F06.run-as-a-service",{"title":164,"path":165,"stem":166},"Upgrade Kraft","\u002Fguides\u002Frun\u002Fupgrade-kraft","3.guides\u002F4.run\u002F07.upgrade-kraft",{"title":168,"path":169,"stem":170},"Upgrade your configuration","\u002Fguides\u002Frun\u002Fupgrade-your-configuration","3.guides\u002F4.run\u002F08.upgrade-your-configuration",{"title":172,"path":173,"stem":174},"Upgrade from 1.4","\u002Fguides\u002Frun\u002Fupgrade-from-1-4","3.guides\u002F4.run\u002F09.upgrade-from-1-4",{"title":176,"path":177,"stem":178},"Upgrade from 0.x or a release candidate","\u002Fguides\u002Frun\u002Fupgrade-from-0-x-or-a-release-candidate","3.guides\u002F4.run\u002F10.upgrade-from-0-x-or-a-release-candidate",{"title":180,"path":181,"stem":182},"Roll back to 1.4","\u002Fguides\u002Frun\u002Froll-back","3.guides\u002F4.run\u002F11.roll-back",{"title":184,"path":185,"stem":186},"Kraft Lite","\u002Fguides\u002Fkraft-lite","3.guides\u002F5.kraft-lite",{"title":188,"path":189,"stem":190,"children":191},"Troubleshooting","\u002Ftroubleshooting","4.troubleshooting",[192,194,198,202,206,210],{"title":10,"path":189,"stem":193},"4.troubleshooting\u002Findex",{"title":195,"path":196,"stem":197},"Why did my item stop?","\u002Ftroubleshooting\u002Fwhy-did-my-item-stop","4.troubleshooting\u002F1.why-did-my-item-stop",{"title":199,"path":200,"stem":201},"Stop reasons in detail","\u002Ftroubleshooting\u002Fstop-reasons-in-detail","4.troubleshooting\u002F2.stop-reasons-in-detail",{"title":203,"path":204,"stem":205},"Starting and reaching Kraft","\u002Ftroubleshooting\u002Fstarting-and-reaching-kraft","4.troubleshooting\u002F3.starting-and-reaching-kraft",{"title":207,"path":208,"stem":209},"Doctor failures","\u002Ftroubleshooting\u002Fdoctor-failures","4.troubleshooting\u002F4.doctor-failures",{"title":211,"path":212,"stem":213},"Sandbox and Kit stops","\u002Ftroubleshooting\u002Fsandbox-and-kit-stops","4.troubleshooting\u002F5.sandbox-and-kit-stops",{"title":215,"path":216,"stem":217,"children":218},"Reference","\u002Freference","5.reference",[219,221,259,281,285,375,393,419,423,427,461,465],{"title":10,"path":216,"stem":220},"5.reference\u002Findex",{"title":222,"path":223,"stem":224,"children":225},"Web UI","\u002Freference\u002Fweb-ui","5.reference\u002F00.web-ui\u002Findex",[226,227,231,235,239,243,247,251,255],{"title":10,"path":223,"stem":224},{"title":228,"path":229,"stem":230},"Sidebar, search, and keyboard","\u002Freference\u002Fweb-ui\u002Fsidebar-search-and-keyboard","5.reference\u002F00.web-ui\u002F0.sidebar-search-and-keyboard",{"title":232,"path":233,"stem":234},"The board","\u002Freference\u002Fweb-ui\u002Fboard","5.reference\u002F00.web-ui\u002F1.board",{"title":236,"path":237,"stem":238},"An item's page","\u002Freference\u002Fweb-ui\u002Fitem-page","5.reference\u002F00.web-ui\u002F2.item-page",{"title":240,"path":241,"stem":242},"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":244,"path":245,"stem":246},"Config before an item starts","\u002Freference\u002Fweb-ui\u002Fconfig-before-start","5.reference\u002F00.web-ui\u002F4.config-before-start",{"title":248,"path":249,"stem":250},"The review page","\u002Freference\u002Fweb-ui\u002Freview-page","5.reference\u002F00.web-ui\u002F5.review-page",{"title":252,"path":253,"stem":254},"Templates and Settings","\u002Freference\u002Fweb-ui\u002Ftemplates-and-settings","5.reference\u002F00.web-ui\u002F6.templates-and-settings",{"title":256,"path":257,"stem":258},"Analytics","\u002Freference\u002Fweb-ui\u002Fanalytics","5.reference\u002F00.web-ui\u002F7.analytics",{"title":260,"path":261,"stem":262,"children":263},"CLI","\u002Freference\u002Fcli","5.reference\u002F01.cli\u002Findex",[264,265,269,273,277],{"title":10,"path":261,"stem":262},{"title":266,"path":267,"stem":268},"Item verbs","\u002Freference\u002Fcli\u002Fitem","5.reference\u002F01.cli\u002F2.item",{"title":270,"path":271,"stem":272},"View verbs","\u002Freference\u002Fcli\u002Fview","5.reference\u002F01.cli\u002F3.view",{"title":274,"path":275,"stem":276},"Repo verbs","\u002Freference\u002Fcli\u002Frepo","5.reference\u002F01.cli\u002F4.repo",{"title":278,"path":279,"stem":280},"Admin verbs","\u002Freference\u002Fcli\u002Fadmin","5.reference\u002F01.cli\u002F5.admin",{"title":282,"path":283,"stem":284},"Work item statuses","\u002Freference\u002Fstatuses","5.reference\u002F02.statuses",{"title":286,"path":287,"stem":288,"children":289},"Configuration","\u002Freference\u002Fconfiguration","5.reference\u002F03.configuration\u002Findex",[290,291,309,313,317,321,325,329,333,337,371],{"title":10,"path":287,"stem":288},{"title":292,"path":293,"stem":294,"children":295},"repos.yaml","\u002Freference\u002Fconfiguration\u002Frepos","5.reference\u002F03.configuration\u002F02.repos\u002Findex",[296,297,301,305],{"title":10,"path":293,"stem":294},{"title":298,"path":299,"stem":300},"How connect proposes commands","\u002Freference\u002Fconfiguration\u002Frepos\u002Fconnect-proposals","5.reference\u002F03.configuration\u002F02.repos\u002F1.connect-proposals",{"title":302,"path":303,"stem":304},"detectors.yaml","\u002Freference\u002Fconfiguration\u002Frepos\u002Fdetectors","5.reference\u002F03.configuration\u002F02.repos\u002F2.detectors",{"title":306,"path":307,"stem":308},"Workspaces","\u002Freference\u002Fconfiguration\u002Frepos\u002Fworkspaces","5.reference\u002F03.configuration\u002F02.repos\u002F3.workspaces",{"title":310,"path":311,"stem":312},"policy.yaml","\u002Freference\u002Fconfiguration\u002Fpolicy","5.reference\u002F03.configuration\u002F03.policy",{"title":314,"path":315,"stem":316},"Library and chains","\u002Freference\u002Fconfiguration\u002Flibrary-and-chains","5.reference\u002F03.configuration\u002F04.library-and-chains",{"title":318,"path":319,"stem":320},"harnesses.yaml","\u002Freference\u002Fconfiguration\u002Fharnesses-file","5.reference\u002F03.configuration\u002F05.harnesses-file",{"title":322,"path":323,"stem":324},"access.yaml","\u002Freference\u002Fconfiguration\u002Faccess","5.reference\u002F03.configuration\u002F06.access",{"title":326,"path":327,"stem":328},"intake.yaml","\u002Freference\u002Fconfiguration\u002Fintake","5.reference\u002F03.configuration\u002F07.intake",{"title":330,"path":331,"stem":332},"notify.yaml","\u002Freference\u002Fconfiguration\u002Fnotify","5.reference\u002F03.configuration\u002F08.notify",{"title":334,"path":335,"stem":336},"theme.yaml","\u002Freference\u002Fconfiguration\u002Ftheme","5.reference\u002F03.configuration\u002F09.theme",{"title":338,"path":339,"stem":340,"children":341},"Sandboxed workers","\u002Freference\u002Fconfiguration\u002Fsandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002Findex",[342,343,347,351,355,359,363,367],{"title":10,"path":339,"stem":340},{"title":344,"path":345,"stem":346},"Resource limits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fresource-limits","5.reference\u002F03.configuration\u002F10.sandbox\u002F1.resource-limits",{"title":348,"path":349,"stem":350},"Callbacks from a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcallbacks","5.reference\u002F03.configuration\u002F10.sandbox\u002F2.callbacks",{"title":352,"path":353,"stem":354},"Network policy","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fnetwork-policy","5.reference\u002F03.configuration\u002F10.sandbox\u002F3.network-policy",{"title":356,"path":357,"stem":358},"Credentials","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fcredentials","5.reference\u002F03.configuration\u002F10.sandbox\u002F4.credentials",{"title":360,"path":361,"stem":362},"Kits","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fkits","5.reference\u002F03.configuration\u002F10.sandbox\u002F5.kits",{"title":364,"path":365,"stem":366},"sandbox.yaml","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fsandbox-yaml","5.reference\u002F03.configuration\u002F10.sandbox\u002F6.sandbox-yaml",{"title":368,"path":369,"stem":370},"Git in a sandbox","\u002Freference\u002Fconfiguration\u002Fsandbox\u002Fgit-in-a-sandbox","5.reference\u002F03.configuration\u002F10.sandbox\u002F7.git-in-a-sandbox",{"title":372,"path":373,"stem":374},"Environment variables","\u002Freference\u002Fconfiguration\u002Fenvironment-variables","5.reference\u002F03.configuration\u002F11.environment-variables",{"title":376,"path":377,"stem":378,"children":379},"Chain file keys","\u002Freference\u002Fchain-nodes","5.reference\u002F04.chain-nodes\u002Findex",[380,381,385,389],{"title":10,"path":377,"stem":378},{"title":382,"path":383,"stem":384},"Subprocess tasks","\u002Freference\u002Fchain-nodes\u002Fsubprocess-tasks","5.reference\u002F04.chain-nodes\u002F2.subprocess-tasks",{"title":386,"path":387,"stem":388},"Fix loop and judge","\u002Freference\u002Fchain-nodes\u002Ffix-loop","5.reference\u002F04.chain-nodes\u002F3.fix-loop",{"title":390,"path":391,"stem":392},"Result file","\u002Freference\u002Fchain-nodes\u002Fresult-file","5.reference\u002F04.chain-nodes\u002F4.result-file",{"title":394,"path":395,"stem":396,"children":397},"Agent harnesses","\u002Freference\u002Fharnesses","5.reference\u002F05.harnesses\u002Findex",[398,399,403,407,411,415],{"title":10,"path":395,"stem":396},{"title":400,"path":401,"stem":402},"Unattended runs","\u002Freference\u002Fharnesses\u002Funattended-runs","5.reference\u002F05.harnesses\u002F2.unattended-runs",{"title":404,"path":405,"stem":406},"Agent profiles","\u002Freference\u002Fharnesses\u002Fagent-profiles","5.reference\u002F05.harnesses\u002F3.agent-profiles",{"title":408,"path":409,"stem":410},"Harness definition files","\u002Freference\u002Fharnesses\u002Fharness-files","5.reference\u002F05.harnesses\u002F4.harness-files",{"title":412,"path":413,"stem":414},"Fallback and escalation","\u002Freference\u002Fharnesses\u002Ffallback-and-escalation","5.reference\u002F05.harnesses\u002F5.fallback-and-escalation",{"title":416,"path":417,"stem":418},"Cost reporting","\u002Freference\u002Fharnesses\u002Fcost-reporting","5.reference\u002F05.harnesses\u002F6.cost-reporting",{"title":420,"path":421,"stem":422},"Permission gate","\u002Freference\u002Fpermissions","5.reference\u002F06.permissions",{"title":424,"path":425,"stem":426},"Inbound triggers","\u002Freference\u002Ftriggers","5.reference\u002F07.triggers",{"title":428,"path":429,"stem":430,"children":431},"HTTP API","\u002Freference\u002Fhttp-api","5.reference\u002F08.http-api\u002Findex",[432,433,437,441,445,449,453,457],{"title":10,"path":429,"stem":430},{"title":434,"path":435,"stem":436},"Filing, reading and changing work items","\u002Freference\u002Fhttp-api\u002Fwork-items","5.reference\u002F08.http-api\u002F2.work-items",{"title":438,"path":439,"stem":440},"Gates, run control, ending and retry","\u002Freference\u002Fhttp-api\u002Fgates-run-control-and-ending","5.reference\u002F08.http-api\u002F3.gates-run-control-and-ending",{"title":442,"path":443,"stem":444},"The work item object","\u002Freference\u002Fhttp-api\u002Fwork-item-object","5.reference\u002F08.http-api\u002F4.work-item-object",{"title":446,"path":447,"stem":448},"Budget, events, diff and documents","\u002Freference\u002Fhttp-api\u002Fbudget-and-events","5.reference\u002F08.http-api\u002F5.budget-and-events",{"title":450,"path":451,"stem":452},"Repos, chains, harnesses and the server","\u002Freference\u002Fhttp-api\u002Frepos-chains-harnesses-and-server","5.reference\u002F08.http-api\u002F6.repos-chains-harnesses-and-server",{"title":454,"path":455,"stem":456},"Drafts","\u002Freference\u002Fhttp-api\u002Fdrafts","5.reference\u002F08.http-api\u002F7.drafts",{"title":458,"path":459,"stem":460},"Ops for each draft area","\u002Freference\u002Fhttp-api\u002Fdraft-ops","5.reference\u002F08.http-api\u002F8.draft-ops",{"title":462,"path":463,"stem":464},"MCP tools","\u002Freference\u002Fmcp-tools","5.reference\u002F09.mcp-tools",{"title":466,"path":467,"stem":468},"Events","\u002Freference\u002Fevents","5.reference\u002F10.events",{"title":470,"path":471,"stem":472,"children":473},"Security and project","\u002Fproject","6.project",[474,476,480,484,488,492,496,500],{"title":10,"path":471,"stem":475},"6.project\u002Findex",{"title":477,"path":478,"stem":479},"Security","\u002Fproject\u002Fsecurity","6.project\u002F1.security",{"title":481,"path":482,"stem":483},"Data and privacy","\u002Fproject\u002Fdata-and-privacy","6.project\u002F2.data-and-privacy",{"title":485,"path":486,"stem":487},"What's new in 2.0","\u002Fproject\u002Fwhats-new","6.project\u002F3.whats-new",{"title":489,"path":490,"stem":491},"Status and support","\u002Fproject\u002Fstatus-and-support","6.project\u002F4.status-and-support",{"title":493,"path":494,"stem":495},"Architecture","\u002Fproject\u002Farchitecture","6.project\u002F5.architecture",{"title":497,"path":498,"stem":499},"Source map","\u002Fproject\u002Fsource-map","6.project\u002F6.source-map",{"title":501,"path":502,"stem":503},"Contributing","\u002Fproject\u002Fcontributing","6.project\u002F7.contributing",{"id":505,"title":195,"body":506,"description":2005,"extension":2006,"links":2007,"meta":2008,"navigation":2009,"path":196,"seo":2010,"stem":197,"__hash__":2011},"docs\u002F4.troubleshooting\u002F1.why-did-my-item-stop.md",{"type":507,"value":508,"toc":1980},"minimark",[509,548,553,556,606,630,633,646,651,804,808,929,933,1021,1025,1205,1209,1329,1332,1444,1448,1553,1557,1563,1677,1681,1844,1847,1866,1869,1897,1900,1906,1912,1915,1939,1946,1949,1953],[510,511,512,513,518,519,523,524,528,529,532,533,537,538,542,543,547],"p",{},"Start here when a ",[514,515,517],"a",{"href":516},"\u002Fconcepts\u002Fvocabulary#work-item","work item"," appears under ",[520,521,522],"strong",{},"Needs you"," (",[525,526,527],"code",{},"needs_human"," in ",[525,530,531],{},"kraft view list","), or when one waits and nothing moves.\nFind the text Kraft shows in the tables under ",[514,534,536],{"href":535},"#find-your-reason","Find your reason",": each row has the fix, or links to an entry that has it.\nA pending gate and the two waits on CI or a review are not stops: ",[514,539,541],{"href":540},"#escalation-turns-and-things-that-are-not-a-stop","Escalation turns and things that are not a stop"," and ",[514,544,546],{"href":545},"#waiting-on-ci-or-a-review","Waiting on CI or a review"," cover them.",[549,550,552],"h2",{"id":551},"check-the-cause-before-you-retry","Check the cause before you retry",[510,554,555],{},"A retry without the cause reruns the same failure. Read the reason first, with these three commands:",[557,558,559,572],"table",{},[560,561,562],"thead",{},[563,564,565,569],"tr",{},[566,567,568],"th",{},"Command",[566,570,571],{},"What it shows",[573,574,575,586,596],"tbody",{},[563,576,577,583],{},[578,579,580],"td",{},[525,581,582],{},"kraft view show ID",[578,584,585],{},"The node it stopped on, and the reason.",[563,587,588,593],{},[578,589,590],{},[525,591,592],{},"kraft view events ID --type work_item_needs_human",[578,594,595],{},"The stop, with every field.",[563,597,598,603],{},[578,599,600],{},[525,601,602],{},"kraft view logs ID",[578,604,605],{},"The log of the session that stopped it.",[510,607,608,609,612,613,616,617,620,621,624,625,629],{},"Where a fix says ",[520,610,611],{},"retry",", run ",[525,614,615],{},"kraft item retry ID",", and add ",[525,618,619],{},"--steer \"...\""," to tell the agent what to do differently; a retry you run resets the node's attempt counters. In Claude Code, ",[525,622,623],{},"\u002Fkraft:triage"," reads all three and suggests the next step. The ",[514,626,628],{"href":627},"\u002Freference\u002Fevents#work_item_needs_human","events catalogue"," lists every field of a stop.",[549,631,536],{"id":632},"find-your-reason",[510,634,635,636,638,639,642,643,645],{},"The first column is the text Kraft shows, in the item's side panel, in ",[525,637,582],{}," and in the board's stop card. ",[525,640,641],{},"..."," stands for text that varies. A row either holds the whole fix, or links to an entry under ",[514,644,199],{"href":200},".",[647,648,650],"h3",{"id":649},"questions-failed-tasks-and-logins","Questions, failed tasks and logins",[557,652,653,666],{},[560,654,655],{},[563,656,657,660,663],{},[566,658,659],{},"The reason says",[566,661,662],{},"What happened",[566,664,665],{},"Fix",[573,667,668,684,700,727,774],{},[563,669,670,675,678],{},[578,671,672],{},[525,673,674],{},"needs_context: \u003Cquestion>",[578,676,677],{},"The agent asked a question it could not answer from the repo.",[578,679,680,681,645],{},"Answer it: ",[525,682,683],{},"kraft item resume ID --steer \"\u003Canswer>\"",[563,685,686,691,694],{},[578,687,688],{},[525,689,690],{},"task failed in node \u003Cnode>: ...",[578,692,693],{},"An agent task or command failed.",[578,695,696,697,699],{},"Read ",[525,698,602],{},", then retry with a steer that names the fix.",[563,701,702,707,710],{},[578,703,704,706],{},[525,705,690],{},", and the log shows an authentication or login error",[578,708,709],{},"The agent CLI is installed but not logged in.",[578,711,712,713,716,717,719,720,723,724,645],{},"Run the agent once in a terminal and log in (",[525,714,715],{},"claude"," for the shipped chains), then ",[525,718,615],{},". ",[525,721,722],{},"kraft admin doctor"," checks only that it is on ",[525,725,726],{},"PATH",[563,728,729,757,767],{},[578,730,731,732,736,737,740,741,740,744,740,747,740,750,753,754],{},"A ",[514,733,735],{"href":734},"\u002Fconcepts\u002Fvocabulary#forge","forge"," task (opening, syncing or merging the merge request), or a git push or fetch, failed, and the log shows ",[525,738,739],{},"HTTP 401",", ",[525,742,743],{},"Bad credentials",[525,745,746],{},"Authentication failed",[525,748,749],{},"could not read Username",[525,751,752],{},"Permission denied (publickey)"," or ",[525,755,756],{},"gh auth login",[578,758,759,760,740,763,766],{},"Kraft holds no forge token, and the forge refused what ",[525,761,762],{},"gh",[525,764,765],{},"glab"," or git sent.",[578,768,769,770,645],{},"See ",[514,771,773],{"href":772},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#forge-authentication-fails","Forge authentication fails",[563,775,776,796,799],{},[578,777,778,779,740,782,753,785,788,789,792,793,645],{},"The log shows ",[525,780,781],{},"Could not resolve host",[525,783,784],{},"Connection timed out",[525,786,787],{},"Connection refused"," on a forge or git call. The stop's ",[525,790,791],{},"facts.cause"," is ",[525,794,795],{},"forge_unreachable",[578,797,798],{},"The machine the server runs on could not reach the forge.",[578,800,801,802,645],{},"Check that machine's network, DNS and proxy settings, then ",[525,803,615],{},[647,805,807],{"id":806},"a-task-kraft-would-not-launch","A task Kraft would not launch",[557,809,810,820],{},[560,811,812],{},[563,813,814,816,818],{},[566,815,659],{},[566,817,662],{},[566,819,665],{},[573,821,822,838,864,884,907],{},[563,823,824,829,832],{},[578,825,826],{},[525,827,828],{},"could not start \u003Ctask> in node \u003Cnode>: ...",[578,830,831],{},"Kraft refused the launch, and the rest of the reason says why.",[578,833,834,835,837],{},"Fix the named cause, often with ",[525,836,722],{},", then retry. The rows below are the common causes.",[563,839,840,849,856],{},[578,841,842,845,846],{},[525,843,844],{},"could not start ..."," with ",[525,847,848],{},"cannot run: backend: auto, but no forge is recorded for this repo",[578,850,851,852,855],{},"The repo had no GitHub or GitLab ",[525,853,854],{},"origin"," when you connected it.",[578,857,769,858,645],{},[514,859,861],{"href":860},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#no-forge-is-recorded-for-this-repo",[525,862,863],{},"no forge is recorded for this repo",[563,865,866,873,876],{},[578,867,868,845,870],{},[525,869,844],{},[525,871,872],{},"declares neither test_scopes nor test_command in repos.yaml",[578,874,875],{},"The repo has no test command, and Kraft will not guess one.",[578,877,769,878,645],{},[514,879,881],{"href":880},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#declares-neither-test_scopes-nor-test_command",[525,882,883],{},"declares neither test_scopes nor test_command",[563,885,886,893,899],{},[578,887,888,845,890],{},[525,889,844],{},[525,891,892],{},"stored model override is not a model id: clear it with ...",[578,894,895,896,645],{},"A model override on the item or a node is not a model id, such as ",[525,897,898],{},"sonnet 4",[578,900,769,901,645],{},[514,902,904],{"href":903},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#stored-model-override-is-not-a-model-id",[525,905,906],{},"stored model override is not a model id",[563,908,909,914,921],{},[578,910,911],{},[525,912,913],{},"... nothing registers it for Claude Code: ...",[578,915,916,917,920],{},"No ",[525,918,919],{},"kraft"," MCP server is registered, so Kraft refused a Claude worker.",[578,922,769,923,645],{},[514,924,926],{"href":925},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#nothing-registers-it-for-claude-code",[525,927,928],{},"nothing registers it for Claude Code",[647,930,932],{"id":931},"setting-up-the-worktree","Setting up the worktree",[557,934,935,945],{},[560,936,937],{},[563,938,939,941,943],{},[566,940,659],{},[566,942,662],{},[566,944,665],{},[573,946,947,974,996],{},[563,948,949,959,966],{},[578,950,951,954,955,958],{},[525,952,953],{},"no user.name configured in \u003Crepo>; set it before Kraft can commit"," (or ",[525,956,957],{},"user.email",")",[578,960,961,962,645],{},"git has no commit identity for the repo, so Kraft would not make the item's ",[514,963,965],{"href":964},"\u002Fconcepts\u002Fvocabulary#worktree","worktree",[578,967,769,968,645],{},[514,969,971],{"href":970},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#no-username-configured",[525,972,973],{},"no user.name configured",[563,975,976,981,988],{},[578,977,978],{},[525,979,980],{},"no setup_command declared for \u003Crepo> in repos.yaml, so \u003Cid>'s worktree cannot be prepared. Declare one ...",[578,982,983,984,987],{},"The repo has no ",[525,985,986],{},"setup_command",", and Kraft will not guess what to run in a fresh worktree.",[578,989,769,990,645],{},[514,991,993],{"href":992},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#no-setup_command-declared",[525,994,995],{},"no setup_command declared",[563,997,998,1003,1009],{},[578,999,1000],{},[525,1001,1002],{},"setup command failed for \u003Cid>: '\u003Ccommand>': \u003Coutput>",[578,1004,1005,1006,1008],{},"The repo's ",[525,1007,986],{}," ran in the new worktree and exited non-zero, and the reason ends with its output.",[578,1010,1011,1012,1015,1016,1018,1019,645],{},"In the worktree (",[525,1013,1014],{},"cd \"$(kraft repo path ID)\"","), run the command yourself. Fix it, or the repo's ",[525,1017,986],{},", then ",[525,1020,615],{},[647,1022,1024],{"id":1023},"fix-loops-gates-and-reviews","Fix loops, gates and reviews",[557,1026,1027,1037],{},[560,1028,1029],{},[563,1030,1031,1033,1035],{},[566,1032,659],{},[566,1034,662],{},[566,1036,665],{},[573,1038,1039,1060,1091,1104,1141,1176,1192],{},[563,1040,1041,1046,1053],{},[578,1042,1043],{},[525,1044,1045],{},"\u003Cloop> exhausted after N fix cycle(s)",[578,1047,731,1048,1052],{},[514,1049,1051],{"href":1050},"\u002Fconcepts\u002Fvocabulary#fix-loop","fix loop"," spent its attempts without passing.",[578,1054,1055,1056,1059],{},"Read the findings (",[525,1057,1058],{},"kraft view events ID --type findings_measured","), then retry with a steer.",[563,1061,1062,1067,1075],{},[578,1063,1064],{},[525,1065,1066],{},"\u003Cnode>.on_base_changed exhausted after N restart(s) from '\u003Cnode>'",[578,1068,1069,1070,1074],{},"The ",[514,1071,1073],{"href":1072},"\u002Fconcepts\u002Fvocabulary#base-branch","base branch"," kept moving: each restart from the named node found it moved again, until the restarts ran out.",[578,1076,1077,1078,528,1081,1083,1084,1087,1088,645],{},"Retry once the base branch settles; a retry resets the count. To allow more restarts, raise that key under ",[525,1079,1080],{},"loops:",[525,1082,310],{},". The shipped chain restarts ",[525,1085,1086],{},"merge_request_feedback"," from ",[525,1089,1090],{},"verification",[563,1092,1093,1098,1101],{},[578,1094,1095],{},[525,1096,1097],{},"\u003Cgate> exhausted after N rejection(s)",[578,1099,1100],{},"A gate was rejected as many times as its chain allows.",[578,1102,1103],{},"Retry with a steer, or rework the spec or plan yourself.",[563,1105,1106,1114,1129],{},[578,1107,1108,753,1111],{},[525,1109,1110],{},"stuck: ...",[525,1112,1113],{},"judge: ...",[578,1115,1116,1117,1120,1121,1125,1126,1128],{},"A fix loop made no progress across cycles (",[525,1118,1119],{},"stuck","), or the loop's ",[514,1122,1124],{"href":1123},"\u002Fconcepts\u002Fvocabulary#judge","judge"," decided another repair attempt is not justified (",[525,1127,1124],{},").",[578,1130,1131,1132,1136,1137,1140],{},"Kraft has already tried an ",[514,1133,1135],{"href":1134},"\u002Fconcepts\u002Fvocabulary#escalation-turn","escalation turn"," on its own. Send a message with ",[525,1138,1139],{},"kraft item escalate ID --message \"...\"",", or retry with a steer.",[563,1142,1143,1148,1151],{},[578,1144,1145],{},[525,1146,1147],{},"the merge request was closed on the forge without merging",[578,1149,1150],{},"Someone or something other than Kraft closed the item's merge request without merging it.",[578,1152,1153,1154,740,1157,1160,1161,1164,1165,1169,1170,792,1173,1128],{},"The board offers ",[520,1155,1156],{},"Reopen !N",[520,1158,1159],{},"Open a new MR"," (only when the item had opened one) and ",[520,1162,1163],{},"Cancel item…",". See ",[514,1166,1168],{"href":1167},"\u002Freference\u002Fstatuses#mr-closed-externally","MR closed externally"," (the stop's ",[525,1171,1172],{},"stop.kind",[525,1174,1175],{},"mr_closed",[563,1177,1178,1183,1186],{},[578,1179,1180],{},[525,1181,1182],{},"a repair in node \u003Cnode> finished with concerns ...",[578,1184,1185],{},"A repair ran, but its agent doubted the result.",[578,1187,1188,1189,645],{},"Read the concerns in the reason, then retry with a steer, or ",[525,1190,1191],{},"kraft item skip ID",[563,1193,1194,1199,1202],{},[578,1195,1196],{},[525,1197,1198],{},"\u003Cscope> is read_only, but it changed the worktree: ...",[578,1200,1201],{},"A read-only step edited files.",[578,1203,1204],{},"Look at the named files, then retry.",[647,1206,1208],{"id":1207},"git-state-of-the-worktree","Git state of the worktree",[557,1210,1211,1221],{},[560,1212,1213],{},[563,1214,1215,1217,1219],{},[566,1216,659],{},[566,1218,662],{},[566,1220,665],{},[573,1222,1223,1239,1259,1275,1294,1312],{},[563,1224,1225,1230,1233],{},[578,1226,1227],{},[525,1228,1229],{},"the conflict in node \u003Cnode> cannot be resolved ...",[578,1231,1232],{},"Rebasing onto the base branch hit a conflict nobody resolved.",[578,1234,1235,1236,1238],{},"Resolve it in the worktree (",[525,1237,1014],{},"), commit, then retry.",[563,1240,1241,1250,1253],{},[578,1242,1243,1246,1247],{},[525,1244,1245],{},"untracked \u003Cpaths> would be overwritten by the base branch; move or delete it, then retry",", or ",[525,1248,1249],{},"git would not start the rebase onto the base branch ...",[578,1251,1252],{},"Kraft went to rebase the item onto its base branch, and git refused to start, so nothing was rebased.",[578,1254,769,1255,645],{},[514,1256,1258],{"href":1257},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#git-would-not-start-the-rebase","Git would not start the rebase",[563,1260,1261,1266,1269],{},[578,1262,1263],{},[525,1264,1265],{},"\u003Cworktree> has a \u003Cname> in progress: inspect it, then delete ...",[578,1267,1268],{},"The worktree holds a rebase, merge, cherry-pick, revert, bisect or autostash, so Kraft would not rebase or commit over it.",[578,1270,769,1271,645],{},[514,1272,1274],{"href":1273},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#a-git-operation-is-in-progress","A git operation is in progress",[563,1276,1277,1282,1285],{},[578,1278,1279],{},[525,1280,1281],{},"\u003Cworktree> is not on \u003Cbranch>; check it out by hand, then retry",[578,1283,1284],{},"The worktree's HEAD names another branch, so Kraft would not commit, rebase or push from it.",[578,1286,1287,1289,1290,1293],{},[525,1288,1014],{},", check that nothing of yours is on the named branch, ",[525,1291,1292],{},"git checkout \u003Cbranch>",", then retry.",[563,1295,1296,1301,1304],{},[578,1297,1298],{},[525,1299,1300],{},"origin\u002F\u003Cbranch> is at \u003Csha>, which Kraft did not push and this worktree does not have ...",[578,1302,1303],{},"Someone pushed commits to the item's merge request branch, and Kraft's push would have overwritten them.",[578,1305,1306,740,1308,1311],{},[525,1307,1014],{},[525,1309,1310],{},"git pull --rebase origin \u003Cbranch>"," to bring them in, then retry.",[563,1313,1314,1319,1322],{},[578,1315,1316],{},[525,1317,1318],{},"origin no longer has \u003Cbranch>, which Kraft pushed ...",[578,1320,1321],{},"The item's branch was deleted from origin, usually with its merge request merged or closed, and Kraft will not recreate it.",[578,1323,1324,1325,1328],{},"To publish the work anyway, run the two ",[525,1326,1327],{},"git update-ref -d"," commands the reason names in the item's worktree, then retry. Otherwise abandon the item.",[647,1330,40],{"id":1331},"caps-and-budgets",[557,1333,1334,1344],{},[560,1335,1336],{},[563,1337,1338,1340,1342],{},[566,1339,659],{},[566,1341,662],{},[566,1343,665],{},[573,1345,1346,1368,1394,1421],{},[563,1347,1348,1353,1356],{},[578,1349,1350],{},[525,1351,1352],{},"budget cap reached: ... on this work item",[578,1354,1355],{},"The item's own dollar cap refused the next launch.",[578,1357,1358,1359,1246,1362,1365,1366,645],{},"Raise that cap and retry in one step: ",[525,1360,1361],{},"kraft item raise-budget ID --usd N",[520,1363,1364],{},"Raise cap"," on the item. See ",[514,1367,80],{"href":81},[563,1369,1370,1378,1388],{},[578,1371,1372,740,1375],{},[525,1373,1374],{},"budget_usd reached ...",[525,1376,1377],{},"token budget reached ...",[578,1379,1380,1381,753,1384,1387],{},"A policy ",[525,1382,1383],{},"budget_usd",[525,1385,1386],{},"token_budget"," refused the next launch.",[578,1389,769,1390,645],{},[514,1391,1393],{"href":1392},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#a-policy-budget-or-token-cap-refused-the-launch","A policy budget or token cap refused the launch",[563,1395,1396,1401,1404],{},[578,1397,1398],{},[525,1399,1400],{},"budget cap reached: ... today, across every work item",[578,1402,1403],{},"The daily cap, which nothing on the item raises, refused the next launch.",[578,1405,1406,1407,528,1410,1412,1413,1416,1417,1420],{},"Raise ",[525,1408,1409],{},"budget.daily_usd",[525,1411,310],{},", or wait for local midnight, then retry. ",[525,1414,1415],{},"raise-budget"," is refused, and the item's page offers ",[520,1418,1419],{},"Retry"," with no raise.",[563,1422,1423,1428,1438],{},[578,1424,1425],{},[525,1426,1427],{},"budget_usd cannot be checked: N launch(es) in ... reported no cost, and unknown spend is never counted as free ...",[578,1429,1430,1431,1435,1436,645],{},"A launch ran on a ",[514,1432,1434],{"href":1433},"\u002Fconcepts\u002Fvocabulary#harness","harness"," that reports no cost, on a model Kraft cannot price, so it cannot show the scope is under its ",[525,1437,1383],{},[578,1439,769,1440,645],{},[514,1441,1443],{"href":1442},"\u002Ftroubleshooting\u002Fstop-reasons-in-detail#a-budget-cap-cannot-be-checked","A budget cap cannot be checked",[647,1445,1447],{"id":1446},"time-caps-and-waits","Time caps and waits",[557,1449,1450,1460],{},[560,1451,1452],{},[563,1453,1454,1456,1458],{},[566,1455,659],{},[566,1457,662],{},[566,1459,665],{},[573,1461,1462,1480,1499,1512,1527,1540],{},[563,1463,1464,1469,1472],{},[578,1465,1466],{},[525,1467,1468],{},"\u003Cscope> hit its time cap of N minutes",[578,1470,1471],{},"A time cap ran out.",[578,1473,1474,1475,1164,1478,645],{},"Raise it for this item, then retry: ",[525,1476,1477],{},"kraft item set-policy ID --policy time_cap_minutes=240",[514,1479,80],{"href":81},[563,1481,1482,1487,1490],{},[578,1483,1484],{},[525,1485,1486],{},"\u003Cscope> hit its total time cap of N minutes",[578,1488,1489],{},"A scope's wall-clock cap, which waits and gates count toward, ran out.",[578,1491,1474,1492,1495,1496,645],{},[525,1493,1494],{},"kraft item set-policy ID --policy total_time_cap_minutes=N",". A node or task needs its path in the key, such as ",[525,1497,1498],{},"merge_request_feedback.ci.await_ci.total_time_cap_minutes=N",[563,1500,1501,1506,1509],{},[578,1502,1503],{},[525,1504,1505],{},"gate \u003Cgate> waited past its timeout of N minutes",[578,1507,1508],{},"Nobody decided a gate in time.",[578,1510,1511],{},"Retry to reopen the gate, then decide it.",[563,1513,1514,1519,1522],{},[578,1515,1516],{},[525,1517,1518],{},"\u003Ctask> timed out waiting ...",[578,1520,1521],{},"An external wait (CI, a review) ran out.",[578,1523,769,1524,1526],{},[514,1525,546],{"href":545},". Retry once the outside is fixed.",[563,1528,1529,1534,1537],{},[578,1530,1531],{},[525,1532,1533],{},"rate_limit retries exhausted after N attempt(s)",[578,1535,1536],{},"The agent's provider kept refusing for a rate limit.",[578,1538,1539],{},"Wait for the limit to reset, then retry.",[563,1541,1542,1547,1550],{},[578,1543,1544,1545],{},"A CI or automated-review failure, with a suggested ",[520,1546,611],{},[578,1548,1549],{},"CI failed for its own reasons, or a cancelled run has no successor.",[578,1551,1552],{},"Retry once CI has recovered.",[647,1554,1556],{"id":1555},"the-sandbox-and-kits","The sandbox and Kits",[510,1558,1559,1560,1562],{},"These stops have their own page, ",[514,1561,211],{"href":212},". Each row below links to the entry for its text.",[557,1564,1565,1574],{},[560,1566,1567],{},[563,1568,1569,1571],{},[566,1570,659],{},[566,1572,1573],{},"See",[573,1575,1576,1589,1605,1621,1634,1648,1664],{},[563,1577,1578,1583],{},[578,1579,1580],{},[525,1581,1582],{},"... this launch is sandboxed in \u003Crepo> with no `network:` policy ...",[578,1584,1585],{},[514,1586,1588],{"href":1587},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#a-sandbox-with-no-network-policy","A sandbox with no network policy",[563,1590,1591,1599],{},[578,1592,1593,1246,1596],{},[525,1594,1595],{},"kraft: a process in the sandbox was killed by its memory limit (\u003Csize>)",[525,1597,1598],{},"... under its \u003Csize> memory limit (the runtime did not confirm it was the limit)",[578,1600,1601],{},[514,1602,1604],{"href":1603},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#find-your-reason","The memory-limit row",[563,1606,1607,1615],{},[578,1608,1609,1246,1612],{},[525,1610,1611],{},"the Kit \u003Cref> cannot be used: ...",[525,1613,1614],{},"the Kit \u003Cref> has not been fetched here yet ...",[578,1616,1617],{},[514,1618,1620],{"href":1619},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#a-kit-is-refused","A Kit is refused",[563,1622,1623,1628],{},[578,1624,1625],{},[525,1626,1627],{},"work item \u003Cid> runs sandboxed, and its workspace members \u003Cpaths> are not the checkouts Kraft made ...",[578,1629,1630],{},[514,1631,1633],{"href":1632},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#sandboxed-workspace-members","Sandboxed workspace members",[563,1635,1636,1642],{},[578,1637,1638,1641],{},[525,1639,1640],{},"workspace member \u003Cpath> of \u003Cworktree> has no checkout Kraft made ...",", and four more like it",[578,1643,1644],{},[514,1645,1647],{"href":1646},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#a-sandboxed-launch-would-not-mount-a-member","A sandboxed launch would not mount a member",[563,1649,1650,1658],{},[578,1651,1652,1246,1655],{},[525,1653,1654],{},"... runs sandboxed, and no connected repository is known for \u003Cpaths> ...",[525,1656,1657],{},"member \u003Cpath> of \u003Cid>: ...",[578,1659,1660],{},[514,1661,1663],{"href":1662},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#a-members-repository-cannot-be-checked-out","A member's repository cannot be checked out",[563,1665,1666,1671],{},[578,1667,1668],{},[525,1669,1670],{},"work item \u003Cid> runs sandboxed, and its worktree holds git repositories Kraft did not create: \u003Cpaths>. ...",[578,1672,1673],{},[514,1674,1676],{"href":1675},"\u002Ftroubleshooting\u002Fsandbox-and-kit-stops#a-nested-repository-kraft-did-not-create","A nested repository Kraft did not create",[647,1678,1680],{"id":1679},"restarts-and-crashes","Restarts and crashes",[557,1682,1683,1693],{},[560,1684,1685],{},[563,1686,1687,1689,1691],{},[566,1688,659],{},[566,1690,662],{},[566,1692,665],{},[573,1694,1695,1717,1743,1763,1786,1814],{},[563,1696,1697,1702,1705],{},[578,1698,1699],{},[525,1700,1701],{},"... are executed by the running Kraft daemon ...",[578,1703,1704],{},"A task that runs inside Kraft itself failed.",[578,1706,1707,1708,1711,1712,1716],{},"Update and restart Kraft with ",[525,1709,1710],{},"kraft admin update --restart",", after ",[514,1713,1715],{"href":1714},"\u002Fguides\u002Frun\u002Frestart-kraft#a-restart-ends-running-agents","pausing running items",", or skip the node.",[563,1718,1719,1724,1737],{},[578,1720,1721],{},[525,1722,1723],{},"reattach: running session, PID identity unconfirmed, no result (pid N is not alive)",[578,1725,1726,1727,740,1730,740,1733,1736],{},"Kraft was stopped or restarted (",[525,1728,1729],{},"kraft admin stop",[525,1731,1732],{},"restart",[525,1734,1735],{},"update --restart",", or the service) while the item's agent ran, and a clean stop ends every running agent.",[578,1738,1739,1740,645],{},"The board shows the item as failed. Retry. Pause running items before your next restart: see ",[514,1741,1742],{"href":1714},"A restart ends running agents",[563,1744,1745,1750,1753],{},[578,1746,1747],{},[525,1748,1749],{},"reattach crashed: \u003Cerror>",[578,1751,1752],{},"Kraft started and found the item's agent session still running, and the code that takes a running session over failed with the error shown. The agent's sandbox, if it had one, was closed.",[578,1754,1755,1756,1762],{},"Retry. If it happens again, ",[514,1757,1761],{"href":1758,"rel":1759},"https:\u002F\u002Fgithub.com\u002FitsOmidKarami\u002Fkraft\u002Fissues",[1760],"nofollow","open an issue"," with the error.",[563,1764,1765,1773,1776],{},[578,1766,1767,1246,1770],{},[525,1768,1769],{},"skip could not start a walk for the node after the skipped one",[525,1771,1772],{},"skip could not start a walk past the skipped scope",[578,1774,1775],{},"The skip is recorded, but the walk after it did not start.",[578,1777,1778,1779,1781,1782,1785],{},"Run the same ",[525,1780,1191],{}," again, with the same ",[525,1783,1784],{},"--path"," for a task or step. A retry would rerun the node you skipped.",[563,1787,1788,1798,1806],{},[578,1789,1790,1793,1794,1797],{},[525,1791,1792],{},"... but could not start a walk",", with or without ",[525,1795,1796],{},": \u003Cerror>"," after it",[578,1799,1800,1801,792,1803,645],{},"A resume, retry, escalation retry, gate decision, the rate-limit poller or the wait scheduler put the item back to running, and failed before the executor took it over. ",[525,1802,791],{},[525,1804,1805],{},"stranded",[578,1807,1808,1809,542,1811,1762],{},"Retry. After a gate decision the retry reruns the node the item stood on: decide the gate again if it comes back. If it recurs, run ",[525,1810,722],{},[514,1812,1761],{"href":1758,"rel":1813},[1760],[563,1815,1816,1829,1836],{},[578,1817,1818,740,1821,1824,1825,1828],{},[525,1819,1820],{},"executor crashed: ...",[525,1822,1823],{},"resume: ...",", or a ",[525,1826,1827],{},"reattach ..."," reason other than the ones above",[578,1830,1831,1832,1835],{},"Kraft crashed while the item ran: it was killed, or the machine went down. A restart you asked for gives the ",[525,1833,1834],{},"reattach"," row above, not this one.",[578,1837,1838,1839,542,1841,645],{},"Retry. If it happens again, run ",[525,1840,722],{},[514,1842,1761],{"href":1758,"rel":1843},[1760],[549,1845,541],{"id":1846},"escalation-turns-and-things-that-are-not-a-stop",[510,1848,1849,1850,1852,1853,528,1856,1858,1859,1862,1863,1865],{},"Some stops reach you only after Kraft has tried an ",[520,1851,1135],{}," on its\nown, up to three times (",[525,1854,1855],{},"auto_escalate_stuck_cap",[525,1857,310],{},"): a task\nthat failed after its recovery, an exhausted fix loop, and a ",[525,1860,1861],{},"stuck:"," stop.\n",[525,1864,602],{}," shows those turns. The other stops (a configuration or\nforge problem, a budget or time cap, a wait that ran out) come to you at once.",[510,1867,1868],{},"Three things look like a stop and are not one, or need a different move:",[1870,1871,1872,1882,1892],"ul",{},[1873,1874,1875,1876,753,1879,645],"li",{},"A pending gate is not a stop. It waits for your decision:\n",[525,1877,1878],{},"kraft item approve ID",[525,1880,1881],{},"kraft item reject ID --note \"...\"",[1873,1883,1884,1885,1888,1889,645],{},"If the work is heading the wrong way rather than failing, pause it and\nresume it with a steer: ",[525,1886,1887],{},"kraft item pause ID",", then\n",[525,1890,1891],{},"kraft item resume ID --steer \"...\"",[1873,1893,1894,1895,645],{},"To move past a node without running it, use ",[525,1896,1191],{},[549,1898,546],{"id":1899},"waiting-on-ci-or-a-review",[510,1901,1902,1903,645],{},"Kraft keeps checking on both waits. One that outlasts its timeout stops the item with ",[525,1904,1905],{},"\u003Ctask> timed out waiting",[647,1907,1909,1911],{"id":1908},"merge_request_feedback-waits-on-no-checks-yet",[525,1910,1086],{}," waits on \"no checks yet\"",[510,1913,1914],{},"The pull request has no CI checks, so nothing will ever pass. Do one of these:",[1870,1916,1917,1920,1932],{},[1873,1918,1919],{},"Add CI that runs on pull requests.",[1873,1921,1922,1923,1926,1927,1931],{},"Set ",[525,1924,1925],{},"ci_checks: false"," on the repo's entry in ",[514,1928,1929],{"href":293},[525,1930,292],{},", so both CI waits, before and after the merge, pass at once.",[1873,1933,1934,1935,1938],{},"File the item on the ",[525,1936,1937],{},"quick-task"," chain.",[647,1940,1942,1945],{"id":1941},"external_approval-keeps-waiting",[525,1943,1944],{},"external_approval"," keeps waiting",[510,1947,1948],{},"A branch rule on the forge requires an approving review. Have someone else approve the pull request, or remove the rule. Kraft checks again on its own.",[549,1950,1952],{"id":1951},"related","Related",[1870,1954,1955,1963,1968,1973],{},[1873,1956,1957,1959,1960,1962],{},[514,1958,207],{"href":208},": a failing ",[525,1961,722],{}," row, which often explains a stop.",[1873,1964,1965,1967],{},[514,1966,80],{"href":81},": lifting a budget or time cap and retrying.",[1873,1969,1970,1972],{},[514,1971,211],{"href":212},": the no-network-policy, memory-limit, Kit, workspace-member and nested-repository stops of a sandboxed item.",[1873,1974,1975,1979],{},[514,1976,1978],{"href":1977},"\u002Fproject\u002Fstatus-and-support#getting-help","Getting help",": where to ask when no reason here fits.",{"title":1981,"searchDepth":1982,"depth":1982,"links":1983},"",2,[1984,1985,1997,1998,2004],{"id":551,"depth":1982,"text":552},{"id":632,"depth":1982,"text":536,"children":1986},[1987,1989,1990,1991,1992,1993,1994,1995,1996],{"id":649,"depth":1988,"text":650},3,{"id":806,"depth":1988,"text":807},{"id":931,"depth":1988,"text":932},{"id":1023,"depth":1988,"text":1024},{"id":1207,"depth":1988,"text":1208},{"id":1331,"depth":1988,"text":40},{"id":1446,"depth":1988,"text":1447},{"id":1555,"depth":1988,"text":1556},{"id":1679,"depth":1988,"text":1680},{"id":1846,"depth":1982,"text":541},{"id":1899,"depth":1982,"text":546,"children":1999},[2000,2002],{"id":1908,"depth":1988,"text":2001},"merge_​request_​feedback waits on \"no checks yet\"",{"id":1941,"depth":1988,"text":2003},"external_​approval keeps waiting",{"id":1951,"depth":1982,"text":1952},"Find the reason a work item stopped and needs you, the fix for each, and what to do when an item waits on CI or a review.","md",null,{},true,{"title":195,"description":2005},"VO44zBuKjjG8TjBfRwy6HyXrfPrL3xbjshOMI75qoKQ",[2013,2015],{"title":10,"path":189,"stem":193,"description":2014,"children":-1},"Where to look when a work item stopped, the server will not start, or a doctor row fails.",{"title":199,"path":200,"stem":201,"description":2016,"children":-1},"The stop reasons that need more than one table row, each with what it means and the numbered fix.",1791801248528]