[{"data":1,"prerenderedAt":3732},["ShallowReactive",2],{"navigation_docs":3,"-reference-kraft-lite":639,"-reference-kraft-lite-surround":3727},[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":597,"body":641,"description":3721,"extension":3722,"links":3723,"meta":3724,"navigation":2258,"path":598,"seo":3725,"stem":599,"__hash__":3726},"docs\u002F5.reference\u002F12.kraft-lite.md",{"type":642,"value":643,"toc":3692},"minimark",[644,657,662,677,797,812,844,849,863,866,891,906,910,917,928,931,984,1213,1220,1262,1266,1273,1276,1319,1336,1344,1370,1373,1379,1430,1441,1447,1516,1520,1523,1592,1606,1621,1644,1654,1658,1669,1684,1688,1691,1717,1730,1749,1752,1784,1805,1812,1838,1860,1864,1870,2025,2031,2124,2128,2147,2153,2156,2160,2182,2196,2199,2213,2217,2228,2232,2235,2242,2270,2281,2295,2302,2312,2315,2324,2331,2335,2348,2407,2416,2420,2423,2433,2443,2446,2449,2453,2464,2470,2479,2487,2499,2506,2510,2513,2593,2602,2651,2658,2664,2667,2671,2687,2694,2728,2732,2739,2749,2756,2759,2762,2766,2781,2971,2980,2997,3006,3020,3031,3036,3054,3071,3091,3096,3114,3142,3146,3153,3178,3193,3198,3230,3436,3439,3561,3566,3607,3613,3648,3658,3677,3688],[645,646,647,648,651,652,656],"p",{},"Look up how the ",[649,650,231],"a",{"href":232}," plugin resolves a chain, runs a node and keeps its state. The skills run the ",[653,654,655],"code",{},"kl.py"," verbs named here. You rarely type one yourself, but the skills' output names them, and this page says what each does and refuses.",[658,659,661],"h2",{"id":660},"chain-sources","Chain sources",[645,663,664,665,668,669,672,673,676],{},"Lite reads the files Kraft reads, a ",[653,666,667],{},"library.yaml"," and its ",[653,670,671],{},"chains\u002F*.yaml",", and expands ",[653,674,675],{},"extends"," as Kraft does: library components first, then a chain that extends another chain. A chain comes from one of four places:",[678,679,680,713,734,767],"ol",{},[681,682,683,690,691,694,695,698,699,702,703,705,706,709,710,689],"li",{},[684,685,686,689],"strong",{},[653,687,688],{},"--chain PATH","."," A chain file, told by its ",[653,692,693],{},".yaml"," or ",[653,696,697],{},".yml"," ending or a ",[653,700,701],{},"\u002F"," in the name. Its ",[653,704,675],{}," resolve against your library, else the bundled one. A file in ",[653,707,708],{},".kraft\u002Fchains\u002F"," is the exception: it is a repo chain, run as its ",[653,711,712],{},"repo:\u003Cid>",[681,714,715,718,719,722,723,725,726,729,730,733],{},[684,716,717],{},"The repo library."," The ",[653,720,721],{},".kraft\u002F"," folder at the repo root, addressed as ",[653,724,712],{},", for example ",[653,727,728],{},"repo:ship",". Lite has no repo ID of its own, so ",[653,731,732],{},"repo:"," stands for this repo. Inside that library a bare name means its own entry, as in Kraft.",[681,735,736,739,740,743,744,747,748,751,752,755,756,758,759,762,763,766],{},[684,737,738],{},"Your library."," The directory Kraft reads its configuration from: ",[653,741,742],{},"$KRAFT_CONFIG_DIR"," when set (or its 1.x name ",[653,745,746],{},"$KRAFT_TEMPLATES_DIR","), else ",[653,749,750],{},"$KRAFT_HOME\u002Fconfig",", else ",[653,753,754],{},"~\u002F.kraft\u002Fconfig",". The first one set is the one, even without a ",[653,757,667],{}," in it: Lite then reads the bundled one, as in step 4. Your library replaces the bundled library wholesale, with no layering, as it does in Kraft. A bare name such as ",[653,760,761],{},"default"," means an entry here, and ",[653,764,765],{},"kraft-default:\u003Cname>"," means the bundled entry.",[681,768,769,772,773,776,777,780,781,784,785,788,789,792,793,796],{},[684,770,771],{},"The bundled library."," A copy of Kraft's packaged ",[653,774,775],{},"config\u002Flibrary.yaml"," and ",[653,778,779],{},"config\u002Fchains\u002F",", shipped with the plugin and kept identical by a test. It is Kraft's built-in add-on, ",[653,782,783],{},"kraft-default",". Kraft seeds a new home with a ",[653,786,787],{},"chains\u002Fdefault.yaml"," that is only ",[653,790,791],{},"extends: kraft-default:default"," (and the same for ",[653,794,795],{},"quick-task","), so a stock home runs the bundled chains.",[645,798,799,800,803,804,807,808,811],{},"A repo library differs from Kraft's in two ways. Lite reads the working tree, not the default branch's commit, and there is no acceptance step, because you are already running in that checkout. An edit to ",[653,801,802],{},".kraft\u002Fchains\u002Fship.yaml"," counts at your next ",[653,805,806],{},"start",", committed or not. See ",[649,809,810],{"href":476},"repo libraries"," for what the folder holds.",[645,813,814,815,818,819,821,822,825,826,828,829,831,832,835,836,839,840,843],{},"With no ",[653,816,817],{},"--chain",", ",[653,820,806],{}," runs ",[653,823,824],{},"repo:default"," when the repo library has a ",[653,827,787],{},", and ",[653,830,761],{}," otherwise. ",[653,833,834],{},"kl.py chains --available"," lists every chain ID Lite can see, with the library it came from and its file. A reference to any other add-on, such as ",[653,837,838],{},"acme:ship",", is refused by name: Lite loads no add-ons. A repo library can't name ",[653,841,842],{},"kraft-default:"," either, since Kraft's lists the add-ons it builds on and Lite reads no such list.",[845,846,848],"h3",{"id":847},"reading-the-yaml","Reading the YAML",[645,850,851,852,855,856,776,859,862],{},"Lite needs nothing installed. When PyYAML is importable it reads with ",[653,853,854],{},"yaml.safe_load",", the reader Kraft uses. Otherwise it uses a built-in reader for the subset Kraft's own files are written in: block and flow collections, plain and quoted scalars, ",[653,857,858],{},"|",[653,860,861],{},">"," block scalars, and comments.",[645,864,865],{},"The built-in reader refuses what it can't be sure to read as PyYAML would, and names the file and line:",[867,868,869,872,879,882,885,888],"ul",{},[681,870,871],{},"anchors, aliases and tags",[681,873,874,875,878],{},"merge keys (",[653,876,877],{},"\u003C\u003C",")",[681,880,881],{},"more than one document",[681,883,884],{},"complex keys",[681,886,887],{},"multi-line quoted scalars",[681,889,890],{},"plain scalars PyYAML would read as a timestamp",[645,892,893,894,818,897,818,900,694,903,689],{},"Quote the value, or install PyYAML. The reader also refuses what PyYAML itself rejects: a tab outside a quoted or block scalar's text or a comment, and a plain scalar that starts with an indicator such as ",[653,895,896],{},"%",[653,898,899],{},",",[653,901,902],{},"]",[653,904,905],{},"? ",[658,907,909],{"id":908},"bindings","Bindings",[645,911,912,913,689],{},"Lite supplies the order, the gates and the caps, and calls whatever you already use for each task. A task with nothing of yours to run follows Kraft's own method for it, the spec writer and the planner included: see ",[649,914,916],{"href":915},"#krafts-methods","Kraft's methods",[645,918,919,920,923,924,927],{},"A task runs on its default unless ",[653,921,922],{},".kraft-lite\u002Fbindings.yaml"," binds it to something else. The file is optional, so is every entry in it, and a chain runs with no file at all. ",[653,925,926],{},"\u002Fkraft-lite:init"," writes one from what it finds in the repo, listing only the entries that differ from the defaults.",[645,929,930],{},"The file has three sections, plus a fourth for children:",[867,932,933,951,963,978],{},[681,934,935,938,939,942,943,946,947,950],{},[653,936,937],{},"tasks",": by the library component's name (",[653,940,941],{},"spec_author","), or by canonical path, ",[653,944,945],{},"node.step.task"," (",[653,948,949],{},"implementation.main.implement","), the paths Kraft's overrides use.",[681,952,953,956,957,694,960,689],{},[653,954,955],{},"builtins",": by ref, such as ",[653,958,959],{},"kraft.verify_changed_test_scopes",[653,961,962],{},"kraft.mr_rebase",[681,964,965,968,969,818,972,694,975,689],{},[653,966,967],{},"forge",": by target, such as ",[653,970,971],{},"mr.open_draft",[653,973,974],{},"mr.ci",[653,976,977],{},"mr.merge",[681,979,980,983],{},[653,981,982],{},"slice",": the same three sections, read only in a child walking a slice, ahead of everything else.",[985,986,991],"pre",{"className":987,"code":988,"language":989,"meta":990,"style":990},"language-yaml shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","tasks:\n  spec_author:\n    kind: skill\n    skill: superpowers:brainstorming\n    prompt: Agree requirements and write a spec before any code.\n  verification.review.code_review:\n    kind: skip\n    why: the merge request review covers it\nbuiltins:\n  kraft.verify_changed_test_scopes:\n    kind: subprocess\n    command: [just, test]\nforge:\n  mr.ci:\n    kind: subprocess\n    command: [gh, pr, checks]\nslice:\n  tasks:\n    implementer:\n      kind: prompt\n      prompt: Implement the slice's tasks test first, one at a time.\n","yaml","",[653,992,993,1005,1013,1026,1037,1048,1056,1066,1077,1084,1092,1102,1122,1129,1137,1146,1168,1175,1183,1191,1202],{"__ignoreMap":990},[994,995,998,1001],"span",{"class":996,"line":997},"line",1,[994,999,937],{"class":1000},"sb7M8",[994,1002,1004],{"class":1003},"s7iLA",":\n",[994,1006,1008,1011],{"class":996,"line":1007},2,[994,1009,1010],{"class":1000},"  spec_author",[994,1012,1004],{"class":1003},[994,1014,1016,1019,1022],{"class":996,"line":1015},3,[994,1017,1018],{"class":1000},"    kind",[994,1020,1021],{"class":1003},": ",[994,1023,1025],{"class":1024},"semJd","skill\n",[994,1027,1029,1032,1034],{"class":996,"line":1028},4,[994,1030,1031],{"class":1000},"    skill",[994,1033,1021],{"class":1003},[994,1035,1036],{"class":1024},"superpowers:brainstorming\n",[994,1038,1040,1043,1045],{"class":996,"line":1039},5,[994,1041,1042],{"class":1000},"    prompt",[994,1044,1021],{"class":1003},[994,1046,1047],{"class":1024},"Agree requirements and write a spec before any code.\n",[994,1049,1051,1054],{"class":996,"line":1050},6,[994,1052,1053],{"class":1000},"  verification.review.code_review",[994,1055,1004],{"class":1003},[994,1057,1059,1061,1063],{"class":996,"line":1058},7,[994,1060,1018],{"class":1000},[994,1062,1021],{"class":1003},[994,1064,1065],{"class":1024},"skip\n",[994,1067,1069,1072,1074],{"class":996,"line":1068},8,[994,1070,1071],{"class":1000},"    why",[994,1073,1021],{"class":1003},[994,1075,1076],{"class":1024},"the merge request review covers it\n",[994,1078,1080,1082],{"class":996,"line":1079},9,[994,1081,955],{"class":1000},[994,1083,1004],{"class":1003},[994,1085,1087,1090],{"class":996,"line":1086},10,[994,1088,1089],{"class":1000},"  kraft.verify_changed_test_scopes",[994,1091,1004],{"class":1003},[994,1093,1095,1097,1099],{"class":996,"line":1094},11,[994,1096,1018],{"class":1000},[994,1098,1021],{"class":1003},[994,1100,1101],{"class":1024},"subprocess\n",[994,1103,1105,1108,1111,1114,1116,1119],{"class":996,"line":1104},12,[994,1106,1107],{"class":1000},"    command",[994,1109,1110],{"class":1003},": [",[994,1112,1113],{"class":1024},"just",[994,1115,818],{"class":1003},[994,1117,1118],{"class":1024},"test",[994,1120,1121],{"class":1003},"]\n",[994,1123,1125,1127],{"class":996,"line":1124},13,[994,1126,967],{"class":1000},[994,1128,1004],{"class":1003},[994,1130,1132,1135],{"class":996,"line":1131},14,[994,1133,1134],{"class":1000},"  mr.ci",[994,1136,1004],{"class":1003},[994,1138,1140,1142,1144],{"class":996,"line":1139},15,[994,1141,1018],{"class":1000},[994,1143,1021],{"class":1003},[994,1145,1101],{"class":1024},[994,1147,1149,1151,1153,1156,1158,1161,1163,1166],{"class":996,"line":1148},16,[994,1150,1107],{"class":1000},[994,1152,1110],{"class":1003},[994,1154,1155],{"class":1024},"gh",[994,1157,818],{"class":1003},[994,1159,1160],{"class":1024},"pr",[994,1162,818],{"class":1003},[994,1164,1165],{"class":1024},"checks",[994,1167,1121],{"class":1003},[994,1169,1171,1173],{"class":996,"line":1170},17,[994,1172,982],{"class":1000},[994,1174,1004],{"class":1003},[994,1176,1178,1181],{"class":996,"line":1177},18,[994,1179,1180],{"class":1000},"  tasks",[994,1182,1004],{"class":1003},[994,1184,1186,1189],{"class":996,"line":1185},19,[994,1187,1188],{"class":1000},"    implementer",[994,1190,1004],{"class":1003},[994,1192,1194,1197,1199],{"class":996,"line":1193},20,[994,1195,1196],{"class":1000},"      kind",[994,1198,1021],{"class":1003},[994,1200,1201],{"class":1024},"prompt\n",[994,1203,1205,1208,1210],{"class":996,"line":1204},21,[994,1206,1207],{"class":1000},"      prompt",[994,1209,1021],{"class":1003},[994,1211,1212],{"class":1024},"Implement the slice's tasks test first, one at a time.\n",[645,1214,1215,1216,1219],{},"An entry has a ",[653,1217,1218],{},"kind",":",[867,1221,1222,1235,1242,1252],{},[681,1223,1224,1227,1228,1230,1231,1234],{},[653,1225,1226],{},"skill",": invoke ",[653,1229,1226],{},". It needs a ",[653,1232,1233],{},"prompt"," too, which runs instead if the skill isn't installed, so a renamed skill degrades to an instruction.",[681,1236,1237,1239,1240,689],{},[653,1238,1233],{},": follow the ",[653,1241,1233],{},[681,1243,1244,1247,1248,1251],{},[653,1245,1246],{},"subprocess",": run ",[653,1249,1250],{},"command",", a list of arguments, with no shell.",[681,1253,1254,1257,1258,1261],{},[653,1255,1256],{},"skip",": run nothing. It needs a ",[653,1259,1260],{},"why",", which is shown when the task is skipped.",[845,1263,1265],{"id":1264},"which-binding-wins","Which binding wins",[645,1267,1268,1269,1272],{},"The first match wins: the task's canonical path, then each library component it extends, nearest first, then its ref (a builtin task) or target (a forge task). A child walking a slice looks in ",[653,1270,1271],{},"slice:"," first, then in its built-in slice defaults, then in the top-level sections.",[645,1274,1275],{},"With no match, the task runs on its default:",[867,1277,1278,1297,1307],{},[681,1279,1280,1281,1284,1285,1287,1288,1290,1291,1293,1294,1296],{},"An ",[684,1282,1283],{},"agent"," task runs its ",[653,1286,1226],{}," if that is installed in this harness. Else, when the skill is one of ",[649,1289,916],{"href":915},", it runs its ",[653,1292,1233],{}," and that method, and otherwise its ",[653,1295,1233],{}," alone.",[681,1298,1299,1300,1284,1302,1304,1305,689],{},"A ",[684,1301,1246],{},[653,1303,1250],{},", split like a shell and run without one, as Kraft runs it. A command Lite can't split, such as one with an unclosed quote, stops ",[653,1306,806],{},[681,1308,1299,1309,694,1312,1314,1315,1318],{},[684,1310,1311],{},"builtin",[684,1313,967],{}," task runs an instruction Lite carries for every ref and target Kraft allows, written for this repo's forge. The verify task's ",[653,1316,1317],{},"suite: full"," asks for the full suite, as Kraft runs it.",[645,1320,1321,1322,1325,1326,818,1329,776,1332,1335],{},"Every task that runs a skill or a prompt, bound or default, gets the task's ",[653,1323,1324],{},"steering"," text appended. Its ",[653,1327,1328],{},"profile",[653,1330,1331],{},"model",[653,1333,1334],{},"effort"," reach the session as hints for choosing a sub-agent's model.",[645,1337,1338,1340,1341,1343],{},[653,1339,806],{}," works out the instruction for every task before it writes anything. A bindings file Lite can't use, or a task with no instruction, stops ",[653,1342,806],{}," and names the entry. The file is read again on every dispatch.",[645,1345,1299,1346,1348,1349,1351,1352,1354,1355,1358,1359,1362,1363,1366,1367,1369],{},[653,1347,937],{}," key that names no task of the chain, by path or component, doesn't stop ",[653,1350,806],{},", since it may be meant for another chain. ",[653,1353,806],{}," lists it under ",[653,1356,1357],{},"unused_bindings"," instead, as ",[653,1360,1361],{},"tasks.\u003Ckey>",", or ",[653,1364,1365],{},"slice.tasks.\u003Ckey>"," for a ",[653,1368,1271],{}," key that names no task a slice runs. A misspelt key would otherwise leave its task on the default without a word.",[658,1371,916],{"id":1372},"krafts-methods",[645,1374,1375],{},[1376,1377,1378],"em",{},"Added in 2.6",[645,1380,1381,1382,1385,1386,1389,1390,818,1393,818,1396,818,1399,1402,1403,1405,1406,1408,1409,1412,1413,1415,1416,1418,1419,1422,1423,1426,1427,689],{},"Lite ships the methods a Kraft worker follows, in ",[653,1383,1384],{},"methods\u002F",": one file per ",[653,1387,1388],{},"kraft:\u003Cname>"," skill the library names (",[653,1391,1392],{},"kraft:spec",[653,1394,1395],{},"kraft:plan",[653,1397,1398],{},"kraft:code-review",[653,1400,1401],{},"kraft:fix-loop-judge"," and the rest), copied unchanged from Kraft. A task whose ",[653,1404,1226],{}," is ",[653,1407,1388],{},", or a bare ",[653,1410,1411],{},"\u003Cname>",", that isn't installed here gets its ",[653,1414,1233],{},", its ",[653,1417,1324],{},", then a ",[653,1420,1421],{},"## Method"," section telling the agent to read that method's file and follow it. Its ",[653,1424,1425],{},"source"," ends ",[653,1428,1429],{},"(shipped method)",[645,1431,1432,1433,1436,1437,1440],{},"A binding for the task still wins. A ",[653,1434,1435],{},"kind: skill"," binding gets the method only when its own skill is a Kraft method that isn't installed. ",[653,1438,1439],{},"kraft:review-feedback"," is the exception: it reads a file Kraft's forge adapter writes, so Lite skips it by default, since Lite's review step already reports what the review bots said. Bind it to run something else.",[645,1442,1443,1444,1446],{},"The method text names things only a Kraft worker has. The ",[653,1445,1421],{}," section tells the agent how to read them here:",[867,1448,1449,1464,1475,1495,1501],{},[681,1450,1451,1452,1455,1456,1459,1460,1463],{},"A result file (",[653,1453,1454],{},"$KRAFT_RESULT_PATH",") and its ",[653,1457,1458],{},"status",": the agent reports the same fields in its reply. A review's ",[653,1461,1462],{},"findings"," are what a step fails on.",[681,1465,1466,1467,1470,1471,1474],{},"A review package (",[653,1468,1469],{},"$KRAFT_REVIEW_PACKAGE","): the branch's diff against its base. Lite gives no fingerprints, so ",[653,1472,1473],{},"same_as"," tags and the judge's fingerprint trend are absent.",[681,1476,1477,776,1480,1483,1484,1487,1488,776,1491,1494],{},[653,1478,1479],{},"kraft view",[653,1481,1482],{},"kraft item"," commands (events, merged merge requests, labels, pipelines, job logs, ",[653,1485,1486],{},"mr-label","): git and the forge's own CLI instead. Lite keeps no event log, so ",[653,1489,1490],{},"kraft:work-brief",[653,1492,1493],{},"kraft:review-brief"," work from git history and the chain's state.",[681,1496,1497,1500],{},[653,1498,1499],{},"needs_context",": the agent stops and asks you.",[681,1502,1503,1506,1507,1510,1511,1515],{},[653,1504,1505],{},"kraft:chain-review"," lists components with ",[653,1508,1509],{},"kraft admin templates library",", which needs Kraft installed, and Lite can't apply a revision anyway (see ",[649,1512,1514],{"href":1513},"#gates","Gates",").",[658,1517,1519],{"id":1518},"what-lite-reads-past-and-what-it-refuses","What Lite reads past, and what it refuses",[645,1521,1522],{},"Lite runs inside one session, so it can't enforce a budget, a time cap, an allowed-tools list, a sandbox or a harness choice. It reads past these keys, so a chain that sets them still runs:",[867,1524,1525,1535,1573,1579],{},[681,1526,1527,1530,1531,1534],{},[653,1528,1529],{},"policy",", all but a node's ",[653,1532,1533],{},"max_attempts",", which caps its fix loop.",[681,1536,1537,818,1540,818,1543,818,1546,818,1549,818,1552,818,1555,818,1558,818,1561,818,1564,818,1567,776,1570,689],{},[653,1538,1539],{},"wait",[653,1541,1542],{},"scope",[653,1544,1545],{},"execution",[653,1547,1548],{},"harness",[653,1550,1551],{},"inputs",[653,1553,1554],{},"skippable",[653,1556,1557],{},"icon",[653,1559,1560],{},"timeout",[653,1562,1563],{},"fallback",[653,1565,1566],{},"runner",[653,1568,1569],{},"reviewers",[653,1571,1572],{},"pipeline",[681,1574,1575,1578],{},[653,1576,1577],{},"escalation",". An escalation is you, as for a fix loop past its cap.",[681,1580,1581,1582,1585,1586,1405,1589,689],{},"A gate's ",[653,1583,1584],{},"auto_review",", unless its ",[653,1587,1588],{},"auto_review_mode",[653,1590,1591],{},"checks_first",[645,1593,1594,1595,1597,1598,1601,1602,1605],{},"Lite does read ",[653,1596,525],{},", on an exec node and on its steps, and ",[653,1599,1600],{},"state"," reports it. The ",[653,1603,1604],{},"next"," skill tells the agent that a read_only scope changes nothing: no writes, no commits, no tests, no files left behind. Lite doesn't check that afterwards, as Kraft does, so the rule is the agent's to keep.",[645,1607,1608,1609,1612,1613,1616,1617,1620],{},"A gate whose reviewer checks first (",[653,1610,1611],{},"auto_review_mode: checks_first",") runs that reviewer before the gate reaches you, in a sub-agent that may not change files. On a ",[653,1614,1615],{},"reject"," it sends the work back with the reviewer's note. Otherwise you get the gate with that note first. The reviewer never approves. A reviewer that ",[653,1618,1619],{},"decides"," (the default) is read past: in Lite it would be your own session approving its own gate.",[645,1622,1623,1624,1626,1627,828,1630,1633,1634,1637,1638,694,1640,1643],{},"Lite stops, naming the file and the key, at what it can't walk without changing what the chain means: a reference to an add-on other than ",[653,1625,783],{},", a step's or a task's own ",[653,1628,1629],{},"on_failure",[653,1631,1632],{},"on_conflict"," under ",[653,1635,1636],{},"on_base_changed",". It also refuses the cases Kraft refuses, such as an unknown builtin ref or forge target, or a key ",[653,1639,1636],{},[653,1641,1642],{},"on_merge_rejected"," doesn't have.",[645,1645,1646,1647,1653],{},"Lite checks what it needs to walk a chain, not everything Kraft would. Before relying on a chain you wrote, run ",[649,1648,1650],{"href":1649},"\u002Freference\u002Fcli\u002Fserver#admin-templates-lint",[653,1651,1652],{},"kraft admin templates lint --dir"," on its folder: that is the full check.",[658,1655,1657],{"id":1656},"how-a-node-runs","How a node runs",[645,1659,1660,1661,1664,1665,1668],{},"A chain is nodes, and a node is either an ",[684,1662,1663],{},"exec"," node or a ",[684,1666,1667],{},"gate",". An exec node holds steps, each of tasks. Lite runs the steps in order, and the tasks inside one step in any order or in parallel. A step fails when a task in it fails or reports findings of critical or important severity, and no later step runs after that. A verb that meets a node missing from the frozen chain fails rather than guessing.",[645,1670,1671,1672,1675,1676,1679,1680,1683],{},"When a task has ",[653,1673,1674],{},"produces",", Lite records the file it wrote with ",[653,1677,1678],{},"kl.py produced --kind \u003Ckind> --path \u003Cfile>",". A gate whose ",[653,1681,1682],{},"artifact"," names that kind then presents the newest such file.",[845,1685,1687],{"id":1686},"fix-loop-order","Fix-loop order",[645,1689,1690],{},"A node that fails goes through its fix loop, in Kraft's order:",[678,1692,1693,1699,1702,1705,1714],{},[681,1694,1695,1696,1698],{},"If the node has an ",[653,1697,1629],{}," and a task failed, that runs once, then the node runs again from its first step.",[681,1700,1701],{},"A builtin or forge task that fails with no findings, such as missing credentials, stops for you. It spends no attempt.",[681,1703,1704],{},"Each cycle spends an attempt. From the second, the loop's judge, if it has one, rules first: continue, stop for you, or finish with the findings left.",[681,1706,1707,1708,1710,1711,1713],{},"Past the cap, the chain stops and shows you every attempt's output. The cap is the loop's ",[653,1709,1533],{},", else the node policy's ",[653,1712,1533],{},", else 3.",[681,1715,1716],{},"The loop's repair steps run, then the whole node again from its first step.",[645,1718,1719,1720,818,1722,1725,1726,1729],{},"A step that moved the branch's base, such as a rebase or sync that did work, hasn't failed. If the node has ",[653,1721,1636],{},[653,1723,1724],{},"kl.py restart"," reopens the walk at its ",[653,1727,1728],{},"restart_from"," node and every node through this one, with their attempts reset. A node restarts at most three times.",[645,1731,1732,1733,1735,1736,1739,1740,1725,1743,1745,1746,1748],{},"The merge task can report that the forge's merge train or merge queue dropped the merge request. If the node has ",[653,1734,1642],{},", as the bundled default's ",[653,1737,1738],{},"merge"," does, its repair steps run. Then ",[653,1741,1742],{},"kl.py restart --merge-rejected",[653,1744,1728],{}," node through this one, so the merge request's checks and the final gate are answered again. A node is sent back this way at most three times. Without ",[653,1747,1642],{},", a drop stops for you.",[845,1750,1514],{"id":1751},"gates",[645,1753,1754,1755,1758,1759,1761,1762,1765,1766,1768,1769,1772,1773,1775,1776,1779,1780,1783],{},"A gate is a node of its own, with a ",[653,1756,1757],{},"message",", an ",[653,1760,1682],{},", and where a rejection goes. You ",[653,1763,1764],{},"approve"," it or ",[653,1767,1615],{}," it. ",[653,1770,1771],{},"close"," is refused on a gate, and ",[653,1774,1764],{}," on an exec node. A rejection reopens the node the gate's ",[653,1777,1778],{},"reject_to"," names, else the nearest exec node before it, and every node after that, carrying your note. ",[653,1781,1782],{},"reject --from-node"," lands the rejection on another node.",[645,1785,1786,1787,1790,1791,1794,1795,1797,1798,1800,1801,1804],{},"The ",[653,1788,1789],{},"chain_finalized"," gate, and any gate with ",[653,1792,1793],{},"artifact_required",", needs its document, as in Kraft: ",[653,1796,1764],{}," is refused while no file of its ",[653,1799,1682],{}," kind is recorded and on disk. Reject it ",[653,1802,1803],{},"--from-node"," the node that writes the document, so that node runs again.",[645,1806,1807,1808,1811],{},"A gate on a ",[653,1809,1810],{},"chain_revision"," artifact is the one case Lite can't finish: it can't apply a change set to a running chain. If the proposal changes anything, Lite says so and offers two ways on: approve without the change, or stop and start again on an edited copy of the chain's file.",[645,1813,1814,1815,1817,1818,1821,1822,1825,1826,1828,1829,818,1831,694,1834,1837],{},"A proposal that changes nothing passes without asking, as in Kraft: ",[653,1816,1667],{}," closes it and prints ",[653,1819,1820],{},"passed_unchanged"," with the proposal's ",[653,1823,1824],{},"rationale",". That takes the change set Kraft's chain review writes: one fenced JSON block with a ",[653,1827,1824],{}," and no ",[653,1830,1256],{},[653,1832,1833],{},"add",[653,1835,1836],{},"overrides",", and no slicing proposal waiting at the gate. Anything else comes to you.",[645,1839,1840,1841,1843,1844,1846,1847,1849,1850,1852,1853,776,1856,1859],{},"That file is the frozen chain's ",[653,1842,1425],{}," when it is a path, else the one ",[653,1845,834],{}," lists for its ID. A ",[653,1848,732],{}," chain's copy goes in ",[653,1851,708],{}," under a new ID. The new run passes the approved spec and plan with ",[653,1854,1855],{},"--spec",[653,1857,1858],{},"--plan",", so it starts at the chain revision.",[845,1861,1863],{"id":1862},"state-fields","State fields",[645,1865,1866,1869],{},[653,1867,1868],{},"kl.py state"," is all a session needs to carry on, so a cleared context loses nothing. It reports:",[1871,1872,1873,1886],"table",{},[1874,1875,1876],"thead",{},[1877,1878,1879,1883],"tr",{},[1880,1881,1882],"th",{},"Field",[1880,1884,1885],{},"Holds",[1887,1888,1889,1915,1928,1943,1956,1969,1978,2000],"tbody",{},[1877,1890,1891,1907],{},[1892,1893,1894,818,1897,818,1900,818,1902,818,1904],"td",{},[653,1895,1896],{},"chain_id",[653,1898,1899],{},"node",[653,1901,1218],{},[653,1903,1458],{},[653,1905,1906],{},"note",[1892,1908,1909,1910,694,1912,1914],{},"The chain's ID, the live node, ",[653,1911,1663],{},[653,1913,1667],{},", its status and its note.",[1877,1916,1917,1925],{},[1892,1918,1919,818,1922],{},[653,1920,1921],{},"attempt",[653,1923,1924],{},"cap",[1892,1926,1927],{},"Fix attempts spent and the cap.",[1877,1929,1930,1934],{},[1892,1931,1932],{},[653,1933,525],{},[1892,1935,1936,1937,1940,1941,689],{},"For an exec node, whether the node is read_only. Each step in ",[653,1938,1939],{},"steps"," carries its own ",[653,1942,525],{},[1877,1944,1945,1953],{},[1892,1946,1947,818,1950],{},[653,1948,1949],{},"backend",[653,1951,1952],{},"sliced",[1892,1954,1955],{},"Where state lives, and the slice state once a run is sliced.",[1877,1957,1958,1963],{},[1892,1959,1960],{},[653,1961,1962],{},"produced",[1892,1964,1965,1966,689],{},"Each document kind the run recorded, mapped to its newest file, so a later task finds it, as opening the merge request finds ",[653,1967,1968],{},"mr_meta",[1877,1970,1971,1975],{},[1892,1972,1973],{},[653,1974,1939],{},[1892,1976,1977],{},"For an exec node, its tasks, as dispatch records (below).",[1877,1979,1980,1994],{},[1892,1981,1982,818,1984,818,1987,818,1990,818,1992],{},[653,1983,1629],{},[653,1985,1986],{},"on_failure_ran",[653,1988,1989],{},"fix_loop",[653,1991,1636],{},[653,1993,1642],{},[1892,1995,1996,1997,1999],{},"For an exec node, the recovery blocks and whether ",[653,1998,1629],{}," has run.",[1877,2001,2002,2006],{},[1892,2003,2004],{},[653,2005,1667],{},[1892,2007,2008,2009,2011,2012,668,2014,2011,2017,2019,2020,2022,2023,689],{},"For a gate: the ",[653,2010,1757],{},", the ",[653,2013,1682],{},[653,2015,2016],{},"artifact_path",[653,2018,1778],{}," node, whether it is the ",[653,2021,1789],{}," or the slice gate, and whether it has ",[653,2024,1793],{},[645,2026,2027,2028,2030],{},"Each task in ",[653,2029,1939],{}," is one dispatch record:",[1871,2032,2033,2041],{},[1874,2034,2035],{},[1877,2036,2037,2039],{},[1880,2038,1882],{},[1880,2040,1885],{},[1887,2042,2043,2053,2079,2091,2100],{},[1877,2044,2045,2050],{},[1892,2046,2047],{},[653,2048,2049],{},"path",[1892,2051,2052],{},"The task's canonical path.",[1877,2054,2055,2059],{},[1892,2056,2057],{},[653,2058,1218],{},[1892,2060,2061,2062,818,2064,818,2066,694,2068,2070,2071,818,2073,818,2075,694,2077,689],{},"How it runs: ",[653,2063,1226],{},[653,2065,1233],{},[653,2067,1246],{},[653,2069,1256],{},", with ",[653,2072,1226],{},[653,2074,1233],{},[653,2076,1250],{},[653,2078,1260],{},[1877,2080,2081,2088],{},[1892,2082,2083,818,2085],{},[653,2084,1674],{},[653,2086,2087],{},"hints",[1892,2089,2090],{},"The document kind it writes, and the model hints.",[1877,2092,2093,2097],{},[1892,2094,2095],{},[653,2096,1425],{},[1892,2098,2099],{},"The rule that chose the binding.",[1877,2101,2102,2113],{},[1892,2103,2104,818,2107,818,2110],{},[653,2105,2106],{},"task_kind",[653,2108,2109],{},"ref",[653,2111,2112],{},"target",[1892,2114,2115,2116,818,2118,818,2120,694,2122,689],{},"From the chain, whatever binding ran it: ",[653,2117,1283],{},[653,2119,1311],{},[653,2121,967],{},[653,2123,1246],{},[658,2125,2127],{"id":2126},"start-with-a-spec-or-a-plan","Start with a spec or a plan",[645,2129,2130,776,2133,2136,2137,2139,2140,2142,2143,2146],{},[653,2131,2132],{},"start --spec PATH",[653,2134,2135],{},"start --plan PATH"," hand over documents you already have. For each kind, Lite drops the gate that approves it, never the ",[653,2138,1789],{}," gate, and the exec node whose tasks all produce it. A surviving gate whose ",[653,2141,1778],{}," named a dropped node falls back to the nearest exec node before it. A surviving ",[653,2144,2145],{},"on_base_changed.restart_from"," that named a dropped node moves to the nearest kept exec node before it, else the first one kept.",[645,2148,2149,2150,2152],{},"That last rule is Lite's own: Kraft drops such an ",[653,2151,1636],{},", and Lite keeps the restart, as a slice's child chain keeps it.",[645,2154,2155],{},"Lite records the path, relative to the repo when the file is inside it, and doesn't copy the file. The gates that remain present it as that kind's artifact. With neither flag, the chain writes both documents itself.",[658,2157,2159],{"id":2158},"state-storage","State storage",[645,2161,2162,2163,2166,2167,2170,2171,2174,2175,2177,2178,2181],{},"State is in ",[653,2164,2165],{},"bd"," when the repo has it, otherwise in ",[653,2168,2169],{},".kraft-lite\u002Fchain.jsonl",". The ",[653,2172,2173],{},"bd export"," format is the same either way, so adopting ",[653,2176,2165],{}," later is ",[653,2179,2180],{},"bd import",", not a migration.",[645,2183,2184,2187,2188,2191,2192,2195],{},[653,2185,2186],{},"\u002Fkraft-lite:status"," lists what is in the directory, and ",[653,2189,2190],{},"kl.py chains"," is the verb behind it. ",[653,2193,2194],{},"kl.py summary"," reports one run back: per-node times split into work and waiting at a gate, attempts against their caps, gates answered and rejection notes.",[645,2197,2198],{},"To make that possible, every write also records the wall-clock time it happened, the seconds already spent waiting at a gate, and the attempts already spent, because a later write would otherwise overwrite each one. It counts no tokens and no money, because Lite runs inside your session and never sees them.",[645,2200,2201,2202,2204,2205,2208,2209,2212],{},"A directory can hold several chains. Every ",[653,2203,655],{}," verb that reads or writes a chain takes ",[653,2206,2207],{},"--chain-id \u003Cid>",". With one unfinished chain the flag is optional, and with two or more it is required: Lite refuses to guess which run a gate belongs to. Each run's frozen chain lives in ",[653,2210,2211],{},".kraft-lite\u002Fchains\u002F\u003Cchain-id>.json",", one per run, so two runs can walk different chains side by side.",[658,2214,2216],{"id":2215},"slices","Slices",[645,2218,2219,2220,2223,2224,2227],{},"Slices split a plan across sessions, so its parts run in parallel. The session that walks the feature chain becomes the ",[684,2221,2222],{},"controller",". Each slice is a part of the plan that stands alone, built by its own ",[684,2225,2226],{},"child"," session.",[845,2229,2231],{"id":2230},"when-to-slice","When to slice",[645,2233,2234],{},"Slice only what stands alone: a part that uses no other part's work, and is coherent enough for its own tests and its own build, verify and review loop. A slice of one or two tasks almost never qualifies, and six slices are plenty. Smaller independent tasks run as sub-agents in one session, which is the default. A plan that strains one context is a reason to look for such parts, not a reason to slice.",[645,2236,2237,2238,2241],{},"The plan says how it splits in a ",[653,2239,2240],{},"## Slices"," section, in Kraft's grammar, so the same plan slices the same way in Kraft:",[985,2243,2247],{"className":2244,"code":2245,"language":2246,"meta":990,"style":990},"language-markdown shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","## Slices\n\n- **Slice 1: CSV writer.** Tasks 2-3.\n- **Slice 2: Import validator.** Tasks 4, 5.\n","markdown",[653,2248,2249,2254,2260,2265],{"__ignoreMap":990},[994,2250,2251],{"class":996,"line":997},[994,2252,2253],{},"## Slices\n",[994,2255,2256],{"class":996,"line":1007},[994,2257,2259],{"emptyLinePlaceholder":2258},true,"\n",[994,2261,2262],{"class":996,"line":1015},[994,2263,2264],{},"- **Slice 1: CSV writer.** Tasks 2-3.\n",[994,2266,2267],{"class":996,"line":1028},[994,2268,2269],{},"- **Slice 2: Import validator.** Tasks 4, 5.\n",[645,2271,2272,2273,2276,2277,2280],{},"Task numbers name the plan's ",[653,2274,2275],{},"### Task N"," headings. Every task sits in exactly one slice. A task in no slice, task 1 here, is groundwork, which Lite builds as a first slice, ",[653,2278,2279],{},"groundwork",", that the others come after.",[645,2282,2283,2286,2287,2290,2291,2294],{},[653,2284,2285],{},"kl.py plan-slices"," reads the section and prints the proposal's slices, or refuses it with the reason. A plan without the section gets a proposed grouping by the same rule. ",[653,2288,2289],{},"plan-slices --check FILE"," refuses a proposal that leaves a plan task out. ",[653,2292,2293],{},"approve --slices"," runs the same check and refuses the same way. Either way the proposal shows which slices run in parallel, and gives each helper or fixture that two slices would create one owner.",[645,2296,2297,2298,2301],{},"Independent slices are the default, and the form Kraft shares. Lite also lets a slice come after another, for one built on another's merged work, as the bullet's last sentence: ",[653,2299,2300],{},"- **Slice 3: Export command.** Task 6. Comes after slice 1."," That is Lite's own extension, and it costs early starts and rebases (below).",[645,2303,2304,2305,2308,2309,2311],{},"A plan that uses ",[653,2306,2307],{},"Comes after slice N."," can't be sliced by Kraft: Kraft refuses its ",[653,2310,2240],{}," section and runs the plan unsliced, as one work item.",[645,2313,2314],{},"The proposal is shown at the slice gate, and your answer is the approval. A plan whose parts don't stand alone isn't sliced: the controller says so, and the chain continues as one. Slicing is accepted only at that gate. A rejection leaves no slice behind.",[645,2316,2317,2318,2320,2321,2323],{},"Sending the chain back with ",[653,2319,1782],{}," keeps the slices only when the plan stands. A rewind to the slice gate or earlier retires them: ",[653,2322,2215],{}," lists none, and the chain is sliced again, from a new proposal, at the slice gate.",[645,2325,2326,2327,2330],{},"A rewind to the first build node is refused while every slice is done, because it would close again at once with nothing redone. Reopen the slices to redo first, with ",[653,2328,2329],{},"slice-set --slice KEY --status running",". A rewind to a node after the first build node leaves the slices as they are.",[845,2332,2334],{"id":2333},"where-a-chain-slices","Where a chain slices",[645,2336,2337,2338,2340,2341,2343,2344,2347],{},"Lite finds the places from the chain's shape, never from node names, so a chain you wrote slices as the default does. ",[653,2339,1600],{}," marks the slice gate, and ",[653,2342,2215],{}," reports the ",[653,2345,2346],{},"shape"," it found.",[867,2349,2350,2363,2376,2388],{},[681,2351,1786,2352,2355,2356,2359,2360,689],{},[684,2353,2354],{},"first build node"," is the first exec node none of whose tasks produces a document. When a node produces the ",[653,2357,2358],{},"plan",", or a gate presents it, it is the first such node after the last of them, so a check node before the plan, or between the plan and its gate, isn't it. In the default chain, ",[653,2361,2362],{},"implementation",[681,2364,1786,2365,2368,2369,2371,2372,2375],{},[684,2366,2367],{},"slice gate"," is the last gate before the first build node, and is never the ",[653,2370,1789],{}," gate. In the default chain, ",[653,2373,2374],{},"chain_revision_approval",". In a chain with a plan gate and then the build, the plan gate.",[681,2377,1786,2378,2381,2382,2384,2385,689],{},[684,2379,2380],{},"MR node"," is the first node with a forge task that targets ",[653,2383,971],{},". It must come after the first build node. In the default chain, ",[653,2386,2387],{},"draft_merge_request",[681,2389,1786,2390,2393,2394,818,2396,818,2399,818,2402,776,2404,689],{},[684,2391,2392],{},"child chain"," is the nodes after the slice gate and before the first gate after the MR node, less every gate and every exec node that produces a document some gate presents. In the default chain: ",[653,2395,2362],{},[653,2397,2398],{},"verification",[653,2400,2401],{},"describe_merge_request",[653,2403,2387],{},[653,2405,2406],{},"merge_request_feedback",[645,2408,2409,2410,2412,2413,2415],{},"A chain without that shape is walked unsliced. ",[653,2411,2293],{}," refuses on it and names the missing piece, such as \"no gate before the first build node\", which is what Kraft's ",[653,2414,795],{}," chain lacks.",[845,2417,2419],{"id":2418},"controller-and-children","Controller and children",[645,2421,2422],{},"The controller starts a child for each slice whose \"comes after\" slices are merged, so independent slices run in parallel. A slice that comes after exactly one slice may start early, from that slice's branch, once that slice is in review or ready to merge. The controller logs that choice. A slice that comes after two or more waits until all of them are merged.",[645,2424,2425,2426,2429,2430,2432],{},"A child walks the child chain (above), cut from the controller's frozen chain. It starts with ",[653,2427,2428],{},"kl.py start --slice-of \u003Cstate checkout>\u002Fchain.json --title \"\u003Cslice>\"",", so it never resolves a library itself and walks exactly what the controller froze. A kept node's ",[653,2431,2145],{}," that names a dropped node moves to the nearest kept exec node before it, else to the child chain's first node.",[645,2434,2435,2436,2438,2439,2442],{},"The child's ",[653,2437,1271],{}," bindings win over everything else. Without them, the agent tasks of the first build node run the ",[653,2440,2441],{},"subagent-driven-development"," skill, whatever component they extend. The changed-scope tests run only the paths the slice touches, and the merge request's automated review is skipped, because the controller's review is that review. CI runs the full suite.",[645,2444,2445],{},"Where Lite would stop for you, the child asks the controller, never you. The controller answers, reviews each child's merge request, merges, archives the finished child, and keeps the run's state. Every sub-agent and child gets a model set on purpose: the cheapest for reading and relaying, the middle for implementation and child sessions, the strongest for reviews and judgement calls.",[645,2447,2448],{},"The controller doesn't start a child until you have finished giving instructions for the run. Say \"go\" when you have.",[845,2450,2452],{"id":2451},"two-merge-request-modes","Two merge request modes",[645,2454,2455,2456,2459,2460,2463],{},"The default is the ",[684,2457,2458],{},"feature"," mode. Each slice opens its merge request into a feature branch, and the controller reviews it and merges it there on green CI. When every slice is in, the controller opens the merge request from the feature branch to ",[653,2461,2462],{},"main",", and its review covers how the slices fit together. You approve and merge that one.",[645,2465,2466,2467,2469],{},"Before the MR node, an exec node that produces nothing, such as ",[653,2468,2398],{}," in the default chain, runs only its changed-scope tests over the feature branch's diff, where CI can't cover it. Every other node runs as in an unsliced chain, and you answer its gates.",[645,2471,2472,2473,2475,2476,2478],{},"In the ",[684,2474,2462],{}," mode, each slice opens its own merge request to ",[653,2477,2462],{},". The controller reviews it and reports, and you merge it. The feature mode is the nearest thing to Kraft's slices, which end in one merge request. The main mode is like filing the slices as separate Kraft work items.",[645,2480,2481,2482,2484,2485,689],{},"A slice is merged only once you merge it. A slice after exactly one other need not wait for that: while that slice is in review or ready to merge, it can start early from its branch, and it moves onto ",[653,2483,2462],{}," when you merge that slice. A slice that comes after two or more waits until you have merged them all, then starts from ",[653,2486,2462],{},[645,2488,2489,2490,2492,2493,776,2496,2498],{},"In the main mode, every node after the first build node closes with nothing to do, as there is no single merge to watch. Two kinds wait until you have merged every slice merge request: the ",[653,2491,1789],{}," gate, and a node that merges a merge request (",[653,2494,2495],{},"final_review",[653,2497,1738],{}," in the default chain).",[645,2500,2501,2502,2505],{},"Set the mode in ",[653,2503,2504],{},".kraft-lite\u002Fslices.json",", or say so when the run starts.",[845,2507,2509],{"id":2508},"who-decides-what","Who decides what",[645,2511,2512],{},"These are the defaults:",[1871,2514,2515,2528],{},[1874,2516,2517],{},[1877,2518,2519,2522,2525],{},[1880,2520,2521],{},"Decision",[1880,2523,2524],{},"Setting",[1880,2526,2527],{},"Default",[1887,2529,2530,2542,2554,2566,2581],{},[1877,2531,2532,2535,2540],{},[1892,2533,2534],{},"A plan question a child raises",[1892,2536,2537],{},[653,2538,2539],{},"plan_question",[1892,2541,2222],{},[1877,2543,2544,2547,2552],{},[1892,2545,2546],{},"Its review verdict on a slice",[1892,2548,2549],{},[653,2550,2551],{},"slice_review",[1892,2553,2222],{},[1877,2555,2556,2559,2564],{},[1892,2557,2558],{},"Approving and merging a slice merge request into the feature branch",[1892,2560,2561],{},[653,2562,2563],{},"merge_slice",[1892,2565,2222],{},[1877,2567,2568,2573,2578],{},[1892,2569,2570,2571],{},"The merge request from the feature branch to ",[653,2572,2462],{},[1892,2574,2575],{},[653,2576,2577],{},"merge_main",[1892,2579,2580],{},"user",[1877,2582,2583,2586,2591],{},[1892,2584,2585],{},"A push outside the child's own slice branch",[1892,2587,2588],{},[653,2589,2590],{},"push_outside_branch",[1892,2592,2580],{},[645,2594,2595,2596,2598,2599,1219],{},"Change any of them for one run by saying so when it starts, or as a standing rule in ",[653,2597,2504],{},", which you commit beside ",[653,2600,2601],{},"bindings.yaml",[985,2603,2607],{"className":2604,"code":2605,"language":2606,"meta":990,"style":990},"language-json shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","{\n  \"mode\": \"main\",\n  \"rights\": { \"merge_slice\": \"user\" }\n}\n","json",[653,2608,2609,2614,2627,2646],{"__ignoreMap":990},[994,2610,2611],{"class":996,"line":997},[994,2612,2613],{"class":1003},"{\n",[994,2615,2616,2619,2621,2624],{"class":996,"line":1007},[994,2617,2618],{"class":1000},"  \"mode\"",[994,2620,1021],{"class":1003},[994,2622,2623],{"class":1024},"\"main\"",[994,2625,2626],{"class":1003},",\n",[994,2628,2629,2632,2635,2638,2640,2643],{"class":996,"line":1015},[994,2630,2631],{"class":1000},"  \"rights\"",[994,2633,2634],{"class":1003},": { ",[994,2636,2637],{"class":1000},"\"merge_slice\"",[994,2639,1021],{"class":1003},[994,2641,2642],{"class":1024},"\"user\"",[994,2644,2645],{"class":1003}," }\n",[994,2647,2648],{"class":996,"line":1028},[994,2649,2650],{"class":1003},"}\n",[645,2652,2653,2654,2657],{},"A right you leave out keeps its default. An unknown key or value is refused, naming it. ",[653,2655,2656],{},"kl.py settings"," prints what is in effect.",[645,2659,2660,2661,689],{},"The controller writes down every call it makes on its own: the question, the answer and why. It shows you the log when you next check in, and again before the work wraps up, while a call is still cheap to overturn. The log is ",[653,2662,2663],{},".kraft-lite\u002Fdecisions\u002F\u003Cchain-id>.jsonl",[645,2665,2666],{},"The controller may hold a critical question, or one that is costly to undo, for you. The child keeps working on whatever doesn't depend on it. Silence is never an answer: a held question stays at the top of every status until you answer it. A decision that is only yours, such as a push the child wasn't given, is passed up to you with the words to type and the session to type them in.",[845,2668,2670],{"id":2669},"the-state-branch","The state branch",[645,2672,2673,2676,2677,2680,2681,828,2683,2686],{},[653,2674,2675],{},".kraft-lite\u002F"," isn't in git, and a cloud container comes back as a fresh clone. After every change the controller exports the run to a branch of its own and pushes it. The export is the feature chain's and the slices' records, its frozen chain (",[653,2678,2679],{},"chain.json",") and the decisions log. A resumed controller imports it before it writes anything. An export made by an older Kraft Lite has no ",[653,2682,2679],{},[653,2684,2685],{},"import"," refuses it.",[645,2688,2689,2690,2693],{},"In a cloud session the state branch is the controller's own session branch. Locally it is the feature branch's name plus ",[653,2691,2692],{},"-state",". It holds state only, never product code, specs or plans, and is never merged. Specs and plans reach the children as messages. At the end the controller lists the branches that are safe for you to delete.",[645,2695,2696,2697,818,2700,818,2703,776,2706,2709,2710,828,2713,2716,2717,2720,2721,2723,2724,2727],{},"Add ",[653,2698,2699],{},".kraft-lite\u002Fdecisions\u002F",[653,2701,2702],{},".kraft-lite\u002Fmessages\u002F",[653,2704,2705],{},".kraft-lite\u002Fproposals\u002F",[653,2707,2708],{},".kraft-lite\u002Freviews\u002F"," to ",[653,2711,2712],{},".gitignore",[653,2714,2715],{},".kraft-lite\u002Fregistry.yaml.migrated"," if ",[653,2718,2719],{},"migrate"," left one. ",[653,2722,926],{}," tells you to. Commit ",[653,2725,2726],{},".kraft-lite\u002Fharnesses\u002F",": it holds what a run learned about your harness.",[845,2729,2731],{"id":2730},"harness-support","Harness support",[645,2733,2734,2735,2738],{},"Slices need four abilities from the harness: start a child session, message it, be messaged by it, and archive it. The controller also needs a way to check in later. The guides in ",[653,2736,2737],{},"skills\u002Frun-slices\u002Freferences\u002F"," map them to the tools of Claude Code, Codex, Cursor, Gemini CLI, Antigravity, Amp and OpenCode, and mark the ones they couldn't confirm.",[645,2740,2741,2742,2744,2745,2748],{},"Where a harness lacks an ability, there is a fallback. A child on the same machine writes to a file under ",[653,2743,2702],{},". A child on another machine comments on its own draft merge request. A controller that can't be woken says so, and you run ",[653,2746,2747],{},"\u002Fkraft-lite:run-slices"," to continue the run.",[645,2750,2751,2752,2755],{},"On a harness with no guide, or for an ability its guide marks unconfirmed, the controller looks before it falls back. It checks its own tools, Kraft's harness profile, the CLI's help and the official docs, running only read-only commands. It writes what it confirmed, with the source and version, to ",[653,2753,2754],{},".kraft-lite\u002Fharnesses\u002F\u003Charness>.md",", which is meant to be committed.",[645,2757,2758],{},"The next run reads that file first, as claims to check: it runs only the harness's own commands from it, and lists them to you before you say \"go\". It tells you what it found, and offers the file as a guide to ship.",[645,2760,2761],{},"If the harness can't start a session at all, the controller walks the slices itself, one after another, and the run goes on. A cloud child can't message a controller on another machine. For a local controller with cloud children, merge request comments are the channel.",[845,2763,2765],{"id":2764},"slice-verbs","Slice verbs",[645,2767,2768,2769,2771,2772,2774,2775,2777,2778,2780],{},"The skills run these. ",[653,2770,1868],{}," also reports ",[653,2773,1952],{}," once a run is sliced. ",[653,2776,2215],{}," reports ",[653,2779,2346],{},", the slice gate, first build node and MR node it found, or why the chain can't be sliced.",[1871,2782,2783,2793],{},[1874,2784,2785],{},[1877,2786,2787,2790],{},[1880,2788,2789],{},"Verb",[1880,2791,2792],{},"What it does",[1887,2794,2795,2805,2827,2848,2857,2899,2909,2927,2937,2958],{},[1877,2796,2797,2802],{},[1892,2798,2799],{},[653,2800,2801],{},"approve --slices FILE",[1892,2803,2804],{},"Approves the slice gate and creates the slices. It refuses a bad proposal (below) and writes nothing.",[1877,2806,2807,2812],{},[1892,2808,2809],{},[653,2810,2811],{},"start --slice-of FILE",[1892,2813,2814,2815,2817,2818,2820,2821,818,2823,694,2825,689],{},"Starts a child on the child chain cut from the exported ",[653,2816,2679],{}," at FILE, with the ",[653,2819,1271],{}," bindings. It takes no ",[653,2822,817],{},[653,2824,1855],{},[653,2826,1858],{},[1877,2828,2829,2834],{},[1892,2830,2831],{},[653,2832,2833],{},"plan-slices [--plan FILE]",[1892,2835,2836,2837,2839,2840,2842,2843,2290,2846],{},"Prints a proposal's ",[653,2838,2215],{}," from the ",[653,2841,2240],{}," section of the chain's plan, or of FILE, groundwork first. It refuses a section out of grammar. ",[653,2844,2845],{},"--check PROPOSAL",[1376,2847,1378],{},[1877,2849,2850,2854],{},[1892,2851,2852],{},[653,2853,2215],{},[1892,2855,2856],{},"Lists the slices, and which may start or must rebase (below).",[1877,2858,2859,2864],{},[1892,2860,2861],{},[653,2862,2863],{},"slice-set --slice KEY",[1892,2865,2866,2867,818,2870,818,2873,694,2876,2879,2880,818,2883,818,2886,818,2889,818,2892,818,2895,2898],{},"Sets ",[653,2868,2869],{},"--status",[653,2871,2872],{},"--session",[653,2874,2875],{},"--branch",[653,2877,2878],{},"--fork",". Statuses: ",[653,2881,2882],{},"waiting",[653,2884,2885],{},"starting",[653,2887,2888],{},"running",[653,2890,2891],{},"in_review",[653,2893,2894],{},"ready_to_merge",[653,2896,2897],{},"merged",". The last slice merged closes the run. A call that changes nothing writes nothing.",[1877,2900,2901,2906],{},[1892,2902,2903],{},[653,2904,2905],{},"settings",[1892,2907,2908],{},"Prints the mode and the rights in effect.",[1877,2910,2911,2916],{},[1892,2912,2913],{},[653,2914,2915],{},"decide",[1892,2917,2918,2919,2922,2923,2926],{},"Logs a decision, under a slice with ",[653,2920,2921],{},"--slice KEY",", which must name one of the run's slices. With ",[653,2924,2925],{},"--held",", holds the question for you.",[1877,2928,2929,2934],{},[1892,2930,2931],{},[653,2932,2933],{},"answer --decision ID --answer TEXT",[1892,2935,2936],{},"Records your answer to a held question. A decision that isn't held is refused.",[1877,2938,2939,2944],{},[1892,2940,2941],{},[653,2942,2943],{},"decisions",[1892,2945,2946,2947,2949,2950,2953,2954,2957],{},"Lists the log. ",[653,2948,2925],{}," shows held questions, ",[653,2951,2952],{},"--unreported"," what is new or newly answered since the last report, and ",[653,2955,2956],{},"--mark"," marks those reported.",[1877,2959,2960,2968],{},[1892,2961,2962,818,2965],{},[653,2963,2964],{},"export --to DIR",[653,2966,2967],{},"import --from DIR",[1892,2969,2970],{},"Copy a run to the state branch's checkout, and back. An import never overwrites a newer local record or decision: it keeps the copy written more times, so a clock that runs behind can't keep a stale one.",[645,2972,2973,2975,2976,2979],{},[653,2974,2293],{}," refuses a plan with a cycle, an unknown ",[653,2977,2978],{},"after",", a duplicate key, an empty task list, a task in two slices, a plan task in no slice or a bad branch. Nothing is written.",[645,2981,2982,2984,2985,2988,2989,2992,2993,2996],{},[653,2983,2215],{}," gives each slice's status, what it comes after, its session and branch, and ",[653,2986,2987],{},"cut_from",", the slice it was cut early from. ",[653,2990,2991],{},"ready"," lists those whose \"comes after\" slices are all merged. ",[653,2994,2995],{},"early"," lists those that come after exactly one slice, which is in review or ready to merge.",[645,2998,2999,3002,3003,3005],{},[653,3000,3001],{},"base_moved"," lists the slices that need a rebase. A slice is listed when it was cut early from a slice whose branch has since moved, or from a slice already listed. Each one rebases onto the new tip of the slice its ",[653,3004,2987],{}," names.",[645,3007,3008,3011,3012,694,3014,3016,3017,3019],{},[653,3009,3010],{},"slice-set"," starts a waiting slice only from ",[653,3013,2991],{},[653,3015,2995],{},", and moves one never started no further than ",[653,3018,2888],{},". It records a slice merged only once every slice it comes after is merged, so a slice cut early from another's branch merges after that one.",[645,3021,3022,3023,3025,3026,3028,3029,689],{},"A slice that goes back from review to work, or records a new ",[653,3024,2878],{},", puts each slice cut early from it in ",[653,3027,3001],{},", then each slice cut early from those. A slice leaves the list when it records the fork of its rebase with ",[653,3030,2878],{},[645,3032,3033,3035],{},[653,3034,3010],{}," refuses three inputs:",[867,3037,3038,3044,3049],{},[681,3039,3040,3041,3043],{},"a ",[653,3042,2878],{}," that isn't 4 to 64 hex digits",[681,3045,3040,3046,3048],{},[653,3047,2875],{}," that isn't a good branch name (below)",[681,3050,3040,3051,3053],{},[653,3052,2872],{}," that is empty or holds whitespace",[645,3055,3056,3058,3059,3061,3062,3064,3065,3067,3068,3070],{},[653,3057,1771],{}," refuses to close a sliced run's first build node until every slice is done: merged, or in ",[653,3060,2462],{}," mode merged or ready to merge. In ",[653,3063,2462],{}," mode, ",[653,3066,1771],{}," on an exec node and ",[653,3069,1764],{}," on a gate refuse to close a node that waits for your merges until every slice is merged. The refusal names the slices that aren't.",[645,3072,3073,3075,3076,3079,3080,3082,3083,3086,3087,3090],{},[653,3074,2685],{}," refuses a directory with no ",[653,3077,3078],{},"records.jsonl",", naming the path, and a chain ID that ",[653,3081,806],{}," wouldn't mint (",[653,3084,3085],{},"kl-"," and 8 of ",[653,3088,3089],{},"0-9a-f","), before it reads or writes a file. It also refuses an export holding a record that isn't its chain's epic, node, run or slice under the ID it was minted with (naming each), or a line it can't read (naming the file and line). It writes nothing.",[645,3092,3093,3095],{},[653,3094,2685],{}," ranks decisions as it ranks records: it keeps the copy written more times, and compares stamps as times. A copy that is still held can't take back an answer given on a machine whose clock runs behind.",[645,3097,3098,3100,3101,3103,3104,776,3107,3110,3111,3113],{},[653,3099,2293],{}," also refuses a task listed twice in one slice, a slice named twice in one ",[653,3102,2978],{},", and a key that isn't 1 to 40 lowercase letters, digits, ",[653,3105,3106],{},"-",[653,3108,3109],{},"_",", starting with a letter or digit. It refuses a key the plan or a slice doesn't take, naming it, so a misspelt ",[653,3112,2978],{}," isn't dropped.",[645,3115,3116,3117,3119,3120,3123,3124,3126,3127,818,3129,694,3131,3134,3135,3138,3139,3141],{},"A bad branch is one that isn't a string, holds whitespace, starts with ",[653,3118,3106],{},", or is one git refuses (",[653,3121,3122],{},"..",", a part starting with ",[653,3125,689],{},", an ending of ",[653,3128,701],{},[653,3130,689],{},[653,3132,3133],{},".lock",", or any of ",[653,3136,3137],{},"~^:?*[\\","). A feature branch that is also the state branch is bad, and so is any feature branch in ",[653,3140,2462],{}," mode, which has none.",[658,3143,3145],{"id":3144},"move-an-older-directory","Move an older directory",[645,3147,3148,3149,3152],{},"Before Kraft Lite walked Kraft's own chains, a repo bound hooks in ",[653,3150,3151],{},".kraft-lite\u002Fregistry.yaml",", and a run froze one of the plugin's JSON chains. A directory in that state is carried over, not stranded:",[985,3154,3158],{"className":3155,"code":3156,"language":3157,"meta":990,"style":990},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","python3 \"$CLAUDE_PLUGIN_ROOT\u002Fkl.py\" migrate\n","bash",[653,3159,3160],{"__ignoreMap":990},[994,3161,3162,3166,3169,3172,3175],{"class":996,"line":997},[994,3163,3165],{"class":3164},"szw1H","python3",[994,3167,3168],{"class":1024}," \"",[994,3170,3171],{"class":1003},"$CLAUDE_PLUGIN_ROOT",[994,3173,3174],{"class":1024},"\u002Fkl.py\"",[994,3176,3177],{"class":1024}," migrate\n",[645,3179,3180,3181,3183,3184,818,3187,776,3190,3192],{},"Until then, a verb that meets a legacy registry, or an unfinished run in the old format, refuses with one line telling you to run ",[653,3182,2719],{},". Only ",[653,3185,3186],{},"chains",[653,3188,3189],{},"detect",[653,3191,2719],{}," run beside a registry that has no bindings file.",[645,3194,3195,3197],{},[653,3196,2719],{}," does two things:",[867,3199,3200,3215],{},[681,3201,3202,3207,3208,3211,3212,3214],{},[684,3203,3204,3205,689],{},"The registry becomes ",[653,3206,2601],{}," Each hook maps to the task, ref or target that now does its job (the table below). A binding that says what the default already says is dropped, and so is a hook V1 has no task for. The command lists what it dropped. Comments aren't carried. The old file is renamed ",[653,3209,3210],{},"registry.yaml.migrated",": add it to ",[653,3213,2712],{},", or delete it.",[681,3216,3217,3220,3221,3223,3224,3226,3227,689],{},[684,3218,3219],{},"Each unfinished run moves to a new ID"," on Kraft's bundled ",[653,3222,761],{},", not a ",[653,3225,761],{}," from your library or the repo's. Closed nodes stay closed, and the node the run was at keeps its attempts and note. The old run is closed and labelled ",[653,3228,3229],{},"kraft-migrated-to:\u003Cnew id>",[1871,3231,3232,3242],{},[1874,3233,3234],{},[1877,3235,3236,3239],{},[1880,3237,3238],{},"Old hook",[1880,3240,3241],{},"Binding it becomes",[1887,3243,3244,3269,3289,3303,3321,3334,3353,3372,3392,3405,3419],{},[1877,3245,3246,3257],{},[1892,3247,3248,818,3251,818,3254],{},[653,3249,3250],{},"on.spec.requested",[653,3252,3253],{},"on.plan.requested",[653,3255,3256],{},"on.chain.review_ready",[1892,3258,3259,1021,3261,818,3263,818,3266],{},[653,3260,937],{},[653,3262,941],{},[653,3264,3265],{},"plan_author",[653,3267,3268],{},"revise_chain",[1877,3270,3271,3279],{},[1892,3272,3273,818,3276],{},[653,3274,3275],{},"on.implementation.start",[653,3277,3278],{},"on.review.local.run",[1892,3280,3281,1021,3283,818,3286],{},[653,3282,937],{},[653,3284,3285],{},"implementer",[653,3287,3288],{},"code_review",[1877,3290,3291,3296],{},[1892,3292,3293],{},[653,3294,3295],{},"on.mr.describe",[1892,3297,3298,1021,3300],{},[653,3299,937],{},[653,3301,3302],{},"describe_mr",[1877,3304,3305,3313],{},[1892,3306,3307,818,3310],{},[653,3308,3309],{},"on.test.run",[653,3311,3312],{},"on.mr.rebase",[1892,3314,3315,1021,3317,818,3319],{},[653,3316,955],{},[653,3318,959],{},[653,3320,962],{},[1877,3322,3323,3328],{},[1892,3324,3325],{},[653,3326,3327],{},"on.mr.open",[1892,3329,3330,1021,3332],{},[653,3331,967],{},[653,3333,971],{},[1877,3335,3336,3344],{},[1892,3337,3338,818,3341],{},[653,3339,3340],{},"on.ci.poll",[653,3342,3343],{},"on.review.mr.run",[1892,3345,3346,1021,3348,818,3350],{},[653,3347,967],{},[653,3349,974],{},[653,3351,3352],{},"mr.automated_review",[1877,3354,3355,3363],{},[1892,3356,3357,818,3360],{},[653,3358,3359],{},"on.merge",[653,3361,3362],{},"on.merge.watch",[1892,3364,3365,1021,3367,818,3369],{},[653,3366,967],{},[653,3368,977],{},[653,3370,3371],{},"mr.post_merge_ci",[1877,3373,3374,3382],{},[1892,3375,3376,818,3379],{},[653,3377,3378],{},"on.slice.implementation.start",[653,3380,3381],{},"on.slice.test.run",[1892,3383,3384,1021,3386,818,3389],{},[653,3385,982],{},[653,3387,3388],{},"tasks.implementer",[653,3390,3391],{},"builtins.kraft.verify_changed_test_scopes",[1877,3393,3394,3402],{},[1892,3395,3396,818,3399],{},[653,3397,3398],{},"on.env.prepare",[653,3400,3401],{},"on.repos.scan",[1892,3403,3404],{},"dropped: Kraft's worktree setup has no such task",[1877,3406,3407,3412],{},[1892,3408,3409],{},[653,3410,3411],{},"on.mr.sync",[1892,3413,3414,3415,3418],{},"dropped: it pulled the merge request into the branch, and V1's ",[653,3416,3417],{},"mr.sync"," pushes the branch",[1877,3420,3421,3426],{},[1892,3422,3423],{},[653,3424,3425],{},"on.human_review.requested",[1892,3427,3428,3429,3431,3432,3435],{},"dropped: presenting the work for sign-off is the ",[653,3430,2495],{}," gate's job; ",[653,3433,3434],{},"write_summary"," only writes the brief it shows",[645,3437,3438],{},"A legacy node becomes one or more V1 nodes, so a run lands on the same work:",[1871,3440,3441,3451],{},[1874,3442,3443],{},[1877,3444,3445,3448],{},[1880,3446,3447],{},"Legacy node",[1880,3449,3450],{},"V1 nodes",[1887,3452,3453,3465,3478,3489,3508,3519,3533,3549],{},[1877,3454,3455,3462],{},[1892,3456,3457,818,3460],{},[653,3458,3459],{},"spec",[653,3461,2358],{},[1892,3463,3464],{},"Each becomes the node and its approval gate.",[1877,3466,3467,3472],{},[1892,3468,3469],{},[653,3470,3471],{},"chain_review",[1892,3473,3474,776,3476],{},[653,3475,1810],{},[653,3477,2374],{},[1877,3479,3480,3485],{},[1892,3481,3482],{},[653,3483,3484],{},"verify",[1892,3486,3487],{},[653,3488,2398],{},[1877,3490,3491,3496],{},[1892,3492,3493],{},[653,3494,3495],{},"open_mr",[1892,3497,3498,818,3501,818,3504,776,3506],{},[653,3499,3500],{},"work_brief",[653,3502,3503],{},"local_review",[653,3505,2401],{},[653,3507,2387],{},[1877,3509,3510,3515],{},[1892,3511,3512],{},[653,3513,3514],{},"mr_checks",[1892,3516,3517],{},[653,3518,2406],{},[1877,3520,3521,3526],{},[1892,3522,3523],{},[653,3524,3525],{},"human_review",[1892,3527,3528,776,3531],{},[653,3529,3530],{},"work_item_summary",[653,3532,2495],{},[1877,3534,3535,3539],{},[1892,3536,3537],{},[653,3538,1738],{},[1892,3540,3541,818,3544,776,3547],{},[653,3542,3543],{},"mark_ready",[653,3545,3546],{},"external_approval",[653,3548,1738],{},[1877,3550,3551,3556],{},[1892,3552,3553],{},[653,3554,3555],{},"post_merge_watch",[1892,3557,3558],{},[653,3559,3560],{},"post_merge_ci",[645,3562,3563,3565],{},[653,3564,2719],{}," refuses, and migrates nothing, when it finds:",[867,3567,3568,3571,3574,3577,3586,3595],{},[681,3569,3570],{},"a run that is sliced, or a slice's child run;",[681,3572,3573],{},"a run on a custom chain, or on one with nodes the old default lacked;",[681,3575,3576],{},"a run whose chain record is missing;",[681,3578,3579,3580,3582,3583,3585],{},"a registry binding a hook outside the table. Take it out, run ",[653,3581,2719],{},", then add its binding to ",[653,3584,2601],{}," by hand, keyed by task name;",[681,3587,3588,3589,3591,3592,3594],{},"a registry entry that would make a bindings file Lite refuses, such as a ",[653,3590,1226],{}," with no ",[653,3593,1233],{},". Correct it in the registry;",[681,3596,3597,3598,776,3600,3603,3604,3606],{},"both ",[653,3599,2601],{},[653,3601,3602],{},"registry.yaml",", because it would overwrite the bindings. Move yours aside, run ",[653,3605,2719],{},", and merge the two by hand.",[645,3608,3609,3610,3612],{},"For a run it refuses, finish it on the previous Kraft Lite version, or abandon it, then run ",[653,3611,2719],{}," again:",[985,3614,3616],{"className":3155,"code":3615,"language":3157,"meta":990,"style":990},"python3 \"$CLAUDE_PLUGIN_ROOT\u002Fkl.py\" migrate --abandon \u003Cchain-id>\n",[653,3617,3618],{"__ignoreMap":990},[994,3619,3620,3622,3624,3626,3628,3631,3635,3639,3642,3645],{"class":996,"line":997},[994,3621,3165],{"class":3164},[994,3623,3168],{"class":1024},[994,3625,3171],{"class":1003},[994,3627,3174],{"class":1024},[994,3629,3630],{"class":1024}," migrate",[994,3632,3634],{"class":3633},"ssYy9"," --abandon",[994,3636,3638],{"class":3637},"sklAV"," \u003C",[994,3640,3641],{"class":1024},"chain-i",[994,3643,3644],{"class":1003},"d",[994,3646,3647],{"class":3637},">\n",[645,3649,3650,3653,3654,3657],{},[653,3651,3652],{},"--abandon"," closes the run's open records, each labelled ",[653,3655,3656],{},"kraft-abandoned",", and deletes nothing: the records and the frozen chain stay. It refuses an ID that isn't an unfinished run in the old format.",[645,3659,3660,3661,3663,3664,776,3667,3669,3670,776,3673,3676],{},"A run that finished in the old format has nothing to move, and blocks nothing. ",[653,3662,1600],{}," reports it ",[653,3665,3666],{},"done",[653,3668,3186],{}," lists it. Every other verb that reads its chain, ",[653,3671,3672],{},"summary",[653,3674,3675],{},"export"," among them, refuses, because its reports need the previous Kraft Lite.",[645,3678,3679,3681,3682,3684,3685,3687],{},[653,3680,2719],{}," is safe to run twice: it renames the registry last, so a run interrupted halfway finishes when you run it again. With nothing left to move, it reports nothing moved. A state export written before Lite carried ",[653,3683,2679],{}," is refused by ",[653,3686,2685],{},", which says it came from an older Kraft Lite.",[3689,3690,3691],"style",{},"html pre.shiki code .sb7M8, html code.shiki .sb7M8{--shiki-light:#024C1A;--shiki-default:#024C1A;--shiki-dark:#72F088}html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}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 .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}",{"title":990,"searchDepth":1007,"depth":1007,"links":3693},[3694,3697,3700,3701,3702,3708,3709,3710,3720],{"id":660,"depth":1007,"text":661,"children":3695},[3696],{"id":847,"depth":1015,"text":848},{"id":908,"depth":1007,"text":909,"children":3698},[3699],{"id":1264,"depth":1015,"text":1265},{"id":1372,"depth":1007,"text":916},{"id":1518,"depth":1007,"text":1519},{"id":1656,"depth":1007,"text":1657,"children":3703},[3704,3706,3707],{"id":1686,"depth":1015,"text":3705},"Fix-​loop order",{"id":1751,"depth":1015,"text":1514},{"id":1862,"depth":1015,"text":1863},{"id":2126,"depth":1007,"text":2127},{"id":2158,"depth":1007,"text":2159},{"id":2215,"depth":1007,"text":2216,"children":3711},[3712,3713,3714,3715,3716,3717,3718,3719],{"id":2230,"depth":1015,"text":2231},{"id":2333,"depth":1015,"text":2334},{"id":2418,"depth":1015,"text":2419},{"id":2451,"depth":1015,"text":2452},{"id":2508,"depth":1015,"text":2509},{"id":2669,"depth":1015,"text":2670},{"id":2730,"depth":1015,"text":2731},{"id":2764,"depth":1015,"text":2765},{"id":3144,"depth":1007,"text":3145},"Chain sources, bindings, fix-loop order, what Lite reads past or refuses, state fields, slice verbs and the move from an older directory.","md",null,{},{"title":597,"description":3721},"DrF69UljPXbX12RX7NBtmqxEDJHX3H0qzzXE_8uYahk",[3728,3730],{"title":593,"path":594,"stem":595,"description":3729,"children":-1},"The Kraft extension's commands, keys, settings, row buttons, search, status bar, board scope, Restricted Mode and the versions it works with.",{"title":10,"path":602,"stem":606,"description":3731,"children":-1},"Security, data and privacy, release news, status and support, architecture and how to contribute.",1794749043717]