[{"data":1,"prerenderedAt":2017},["ShallowReactive",2],{"navigation_docs":3,"-reference-cli-addon":639,"-reference-cli-addon-surround":2012},[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":361,"body":641,"description":2005,"extension":2006,"links":2007,"meta":2008,"navigation":2009,"path":362,"seo":2010,"stem":363,"__hash__":2011},"docs\u002F5.reference\u002F01.cli\u002F6.addon.md",{"type":642,"value":643,"toc":1976},"minimark",[644,674,679,896,900,904,910,925,932,1001,1006,1010,1020,1031,1048,1053,1062,1065,1070,1079,1086,1091,1100,1103,1108,1117,1120,1142,1147,1156,1159,1235,1239,1265,1272,1281,1286,1295,1298,1345,1349,1358,1371,1377,1382,1437,1471,1476,1485,1488,1507,1512,1521,1526,1531,1540,1551,1556,1565,1568,1588,1591,1610,1618,1623,1632,1642,1646,1651,1666,1720,1724,1728,1733,1742,1745,1802,1806,1819,1822,1840,1843,1851,1855,1860,1867,1899,1932,1952,1956,1972],[645,646,647,651,652,656,657,660,661,664,665,668,669,673],"p",{},[648,649,650],"code",{},"kraft admin addon"," manages add-ons and the collections they come from. The ",[653,654,655],"a",{"href":358},"server",", ",[653,658,659],{"href":366},"machine"," and ",[653,662,663],{"href":370},"forge"," verbs are on their own pages. Every verb here accepts ",[648,666,667],{},"--json","; the exceptions are in ",[653,670,672],{"href":671},"\u002Freference\u002Fcli#output-format","Output format",".",[675,676,678],"h2",{"id":677},"verbs-at-a-glance","Verbs at a glance",[680,681,682,695],"table",{},[683,684,685],"thead",{},[686,687,688,692],"tr",{},[689,690,691],"th",{},"Verb",[689,693,694],{},"What it does",[696,697,698,716,731,746,761,776,791,806,821,836,851,866,881],"tbody",{},[686,699,700,709],{},[701,702,703],"td",{},[653,704,706],{"href":705},"\u002Freference\u002Fcli\u002Faddon#admin-addon-collection-add",[648,707,708],{},"admin addon collection add",[701,710,711,712],{},"Adds a collection; installs nothing. ",[713,714,715],"em",{},"Added in 2.1",[686,717,718,726],{},[701,719,720],{},[653,721,723],{"href":722},"\u002Freference\u002Fcli\u002Faddon#admin-addon-collection-list",[648,724,725],{},"admin addon collection list",[701,727,728,729],{},"Lists the collections and what each publishes. ",[713,730,715],{},[686,732,733,741],{},[701,734,735],{},[653,736,738],{"href":737},"\u002Freference\u002Fcli\u002Faddon#admin-addon-collection-update",[648,739,740],{},"admin addon collection update",[701,742,743,744],{},"Fetches the newest catalogue. ",[713,745,715],{},[686,747,748,756],{},[701,749,750],{},[653,751,753],{"href":752},"\u002Freference\u002Fcli\u002Faddon#admin-addon-collection-auto-update",[648,754,755],{},"admin addon collection auto-update",[701,757,758,759],{},"Sets a collection's auto-update. ",[713,760,715],{},[686,762,763,771],{},[701,764,765],{},[653,766,768],{"href":767},"\u002Freference\u002Fcli\u002Faddon#admin-addon-collection-remove",[648,769,770],{},"admin addon collection remove",[701,772,773,774],{},"Forgets a collection. ",[713,775,715],{},[686,777,778,786],{},[701,779,780],{},[653,781,783],{"href":782},"\u002Freference\u002Fcli\u002Faddon#admin-addon-install",[648,784,785],{},"admin addon install",[701,787,788,789],{},"Installs an add-on and its missing ancestors, after a review. ",[713,790,715],{},[686,792,793,801],{},[701,794,795],{},[653,796,798],{"href":797},"\u002Freference\u002Fcli\u002Faddon#admin-addon-update",[648,799,800],{},"admin addon update",[701,802,803,804],{},"Updates installed add-ons, one review per tree. ",[713,805,715],{},[686,807,808,816],{},[701,809,810],{},[653,811,813],{"href":812},"\u002Freference\u002Fcli\u002Faddon#admin-addon-auto-update",[648,814,815],{},"admin addon auto-update",[701,817,818,819],{},"Sets one add-on's auto-update. ",[713,820,715],{},[686,822,823,831],{},[701,824,825],{},[653,826,828],{"href":827},"\u002Freference\u002Fcli\u002Faddon#admin-addon-enable",[648,829,830],{},"admin addon enable",[701,832,833,834],{},"Loads an installed add-on. ",[713,835,715],{},[686,837,838,846],{},[701,839,840],{},[653,841,843],{"href":842},"\u002Freference\u002Fcli\u002Faddon#admin-addon-disable",[648,844,845],{},"admin addon disable",[701,847,848,849],{},"Keeps an add-on installed but not loaded. ",[713,850,715],{},[686,852,853,861],{},[701,854,855],{},[653,856,858],{"href":857},"\u002Freference\u002Fcli\u002Faddon#admin-addon-uninstall",[648,859,860],{},"admin addon uninstall",[701,862,863,864],{},"Removes an installed add-on. ",[713,865,715],{},[686,867,868,876],{},[701,869,870],{},[653,871,873],{"href":872},"\u002Freference\u002Fcli\u002Faddon#admin-addon-list",[648,874,875],{},"admin addon list",[701,877,878,879],{},"Lists the installed add-ons. ",[713,880,715],{},[686,882,883,891],{},[701,884,885],{},[653,886,888],{"href":887},"\u002Freference\u002Fcli\u002Faddon#admin-addon-validate",[648,889,890],{},"admin addon validate",[701,892,893,894],{},"Checks a collection or add-on directory; installs nothing. ",[713,895,715],{},[675,897,899],{"id":898},"install-and-update-add-ons","Install and update add-ons",[645,901,902],{},[713,903,715],{},[905,906,908],"h3",{"id":907},"admin-addon-collection-add",[648,909,708],{},[911,912,918],"pre",{"className":913,"code":915,"language":916,"meta":917},[914],"language-text","kraft admin addon collection add [flags] SOURCE\n","text","",[648,919,920],{"__ignoreMap":917},[921,922,915],"span",{"className":923},[924],"line",[645,926,927,928,931],{},"Adds a collection from ",[648,929,930],{},"owner\u002Frepo"," (GitHub), a git URL or a directory. Installs nothing.",[680,933,934,950],{},[683,935,936],{},[686,937,938,941,944,947],{},[689,939,940],{},"Flag",[689,942,943],{},"Type",[689,945,946],{},"Default",[689,948,949],{},"Meaning",[696,951,952,968,984],{},[686,953,954,959,962,965],{},[701,955,956],{},[648,957,958],{},"--ref",[701,960,961],{},"branch, tag or commit",[701,963,964],{},"the default branch",[701,966,967],{},"What the collection follows.",[686,969,970,975,978,981],{},[701,971,972],{},[648,973,974],{},"--auto-update",[701,976,977],{},"switch",[701,979,980],{},"off",[701,982,983],{},"Every add-on installed from it updates itself.",[686,985,986,991,993,995],{},[701,987,988],{},[648,989,990],{},"--replace",[701,992,977],{},[701,994,980],{},[701,996,997,998],{},"Moves one already added from another source. The next update reviews it. ",[713,999,1000],{},"Added in 2.5",[1002,1003,1005],"h4",{"id":1004},"move-a-collection-to-another-source","Move a collection to another source",[645,1007,1008],{},[713,1009,1000],{},[645,1011,1012,1015,1016,1019],{},[648,1013,1014],{},"kraft admin addon collection add SOURCE --replace"," moves a collection already added under the same name to another repository or directory: a fork, a mirror or a local checkout. It writes the new source to ",[648,1017,1018],{},"addons.yaml",", and changes neither the lock nor the store.",[645,1021,1022,1023,1026,1027,1030],{},"The installed add-ons keep what they locked until ",[648,1024,1025],{},"kraft admin addon update"," shows the move, as ",[648,1028,1029],{},"collection URL changed: \u003Cold> -> \u003Cnew>",", and you accept it. From one directory to another, the update shows only what changed in the add-ons' files.",[645,1032,1033,1034,1036,1037,1040,1041,1043,1044,1047],{},"The move takes the new source whole: the old ",[648,1035,958],{}," is dropped, ",[648,1038,1039],{},"auto_update"," is kept from one git source to another, and a directory never auto-updates. Without ",[648,1042,990],{},", adding a taken name from another source is refused. To follow another branch of the same repository, ",[648,1045,1046],{},"collection add SOURCE --ref REF"," is enough.",[905,1049,1051],{"id":1050},"admin-addon-collection-list",[648,1052,725],{},[911,1054,1057],{"className":1055,"code":1056,"language":916,"meta":917},[914],"kraft admin addon collection list [flags]\n",[648,1058,1059],{"__ignoreMap":917},[921,1060,1056],{"className":1061},[924],[645,1063,1064],{},"Each collection, its source and the add-ons it published when last fetched. No network. It takes no flags.",[905,1066,1068],{"id":1067},"admin-addon-collection-update",[648,1069,740],{},[911,1071,1074],{"className":1072,"code":1073,"language":916,"meta":917},[914],"kraft admin addon collection update [flags] [NAME]\n",[648,1075,1076],{"__ignoreMap":917},[921,1077,1073],{"className":1078},[924],[645,1080,1081,1082,1085],{},"Fetches the newest catalogue of ",[648,1083,1084],{},"NAME",", or with no name of every collection from git. Installed add-ons don't change. It takes no flags.",[905,1087,1089],{"id":1088},"admin-addon-collection-auto-update",[648,1090,755],{},[911,1092,1095],{"className":1093,"code":1094,"language":916,"meta":917},[914],"kraft admin addon collection auto-update [flags] NAME on|off\n",[648,1096,1097],{"__ignoreMap":917},[921,1098,1094],{"className":1099},[924],[645,1101,1102],{},"Sets whether every add-on installed from the collection updates itself. It takes no flags.",[905,1104,1106],{"id":1105},"admin-addon-collection-remove",[648,1107,770],{},[911,1109,1112],{"className":1110,"code":1111,"language":916,"meta":917},[914],"kraft admin addon collection remove [flags] NAME\n",[648,1113,1114],{"__ignoreMap":917},[921,1115,1111],{"className":1116},[924],[645,1118,1119],{},"Forgets a collection. It takes no flags.",[680,1121,1122,1132],{},[683,1123,1124],{},[686,1125,1126,1129],{},[689,1127,1128],{},"Refusal",[689,1130,1131],{},"Cause",[696,1133,1134],{},[686,1135,1136,1139],{},[701,1137,1138],{},"Refused",[701,1140,1141],{},"One of its add-ons is installed.",[905,1143,1145],{"id":1144},"admin-addon-install",[648,1146,785],{},[911,1148,1151],{"className":1149,"code":1150,"language":916,"meta":917},[914],"kraft admin addon install [flags] ADDON@COLLECTION\n",[648,1152,1153],{"__ignoreMap":917},[921,1154,1150],{"className":1155},[924],[645,1157,1158],{},"Installs an add-on, and any of its ancestors that isn't installed, after one review.",[680,1160,1161,1173],{},[683,1162,1163],{},[686,1164,1165,1167,1169,1171],{},[689,1166,940],{},[689,1168,943],{},[689,1170,946],{},[689,1172,949],{},[696,1174,1175,1191,1204,1218],{},[686,1176,1177,1182,1185,1188],{},[701,1178,1179],{},[648,1180,1181],{},"--as",[701,1183,1184],{},"namespace",[701,1186,1187],{},"the add-on's own",[701,1189,1190],{},"Installs the add-on under another namespace.",[686,1192,1193,1197,1199,1201],{},[701,1194,1195],{},[648,1196,974],{},[701,1198,977],{},[701,1200,980],{},[701,1202,1203],{},"The add-on updates itself.",[686,1205,1206,1211,1213,1215],{},[701,1207,1208],{},[648,1209,1210],{},"--re-install",[701,1212,977],{},[701,1214,980],{},[701,1216,1217],{},"Takes the newest commit of an installed one, even at an unchanged version.",[686,1219,1220,1228,1230,1232],{},[701,1221,1222,656,1225],{},[648,1223,1224],{},"-y",[648,1226,1227],{},"--yes",[701,1229,977],{},[701,1231,980],{},[701,1233,1234],{},"Accepts the review without asking.",[1002,1236,1238],{"id":1237},"add-a-collection-and-install-from-it","Add a collection and install from it",[645,1240,1241,1244,1245,1247,1248,1251,1252,1254,1255,1258,1259,1261,1262,1264],{},[648,1242,1243],{},"kraft admin addon collection add SOURCE"," records a collection in ",[648,1246,1018],{}," under the name its ",[648,1249,1250],{},"collection.json"," declares. ",[648,1253,930],{}," is written as its full GitHub URL. ",[648,1256,1257],{},"kraft admin addon install ADDON@COLLECTION"," then fetches the add-on, checks it against this instance, and prints a review: what can change how far a run reaches first, then the rest. Nothing is installed until you accept it. ",[648,1260,1224],{}," accepts without asking; with no terminal and no ",[648,1263,1224],{}," the install is declined.",[645,1266,1267,1268,1271],{},"Any ancestor the add-on builds on that isn't installed is installed with it, in the same review; a disabled one is refused with the ",[648,1269,1270],{},"kraft admin addon enable"," to run.",[645,1273,1274,1277,1278,1280],{},[648,1275,1276],{},"--as ALIAS"," installs the add-on under another namespace. ",[648,1279,1210],{}," takes the commit the collection's ref names now, even when the add-on's version hasn't changed.",[905,1282,1284],{"id":1283},"admin-addon-update",[648,1285,800],{},[911,1287,1290],{"className":1288,"code":1289,"language":916,"meta":917},[914],"kraft admin addon update [flags] [ADDON@COLLECTION ...]\n",[648,1291,1292],{"__ignoreMap":917},[921,1293,1289],{"className":1294},[924],[645,1296,1297],{},"Updates the named add-ons, with their installed relatives' waiting updates, or all of them, after one review per tree of related add-ons.",[680,1299,1300,1312],{},[683,1301,1302],{},[686,1303,1304,1306,1308,1310],{},[689,1305,940],{},[689,1307,943],{},[689,1309,946],{},[689,1311,949],{},[696,1313,1314,1332],{},[686,1315,1316,1322,1324,1326],{},[701,1317,1318,656,1320],{},[648,1319,1224],{},[648,1321,1227],{},[701,1323,977],{},[701,1325,980],{},[701,1327,1328,1329,673],{},"Accepts every review. Exclusive with ",[648,1330,1331],{},"--check",[686,1333,1334,1338,1340,1342],{},[701,1335,1336],{},[648,1337,1331],{},[701,1339,977],{},[701,1341,980],{},[701,1343,1344],{},"Changes nothing; the exit code says what it found.",[1002,1346,1348],{"id":1347},"update-add-ons","Update add-ons",[645,1350,1351,1353,1354,1357],{},[648,1352,1025],{}," reviews every installed add-on that has an update: its version changed (its files, for a directory collection), or you changed its alias, ",[648,1355,1356],{},"ref"," or collection URL by hand. Add-ons that build on each other share one review.",[645,1359,1360,1361,1364,1365,1367,1368,1370],{},"An add-on that fails a check is reported and the others go on. A change that would break one of your own chains, a ",[648,1362,1363],{},"default_chain"," in ",[648,1366,387],{}," or an ",[648,1369,417],{}," schedule is refused and names the reference.",[645,1372,1373,1376],{},[648,1374,1375],{},"update"," exits 0 only when everything asked for was applied or current, and 1 when an update was refused, declined, held or failed, a held relative's included.",[645,1378,1379,1381],{},[648,1380,1331],{}," prints the reviews and changes nothing. Its exit code tells a scheduled job what it found:",[680,1383,1384,1395],{},[683,1385,1386],{},[686,1387,1388,1393],{},[689,1389,1390,1392],{},[648,1391,1331],{}," exit code",[689,1394,949],{},[696,1396,1397,1407,1417,1427],{},[686,1398,1399,1404],{},[701,1400,1401],{},[648,1402,1403],{},"0",[701,1405,1406],{},"Every add-on is current.",[686,1408,1409,1414],{},[701,1410,1411],{},[648,1412,1413],{},"1",[701,1415,1416],{},"An update is waiting or held by a range.",[686,1418,1419,1424],{},[701,1420,1421],{},[648,1422,1423],{},"2",[701,1425,1426],{},"An update would be refused, a relative's that breaks a chain included.",[686,1428,1429,1434],{},[701,1430,1431],{},[648,1432,1433],{},"3",[701,1435,1436],{},"It couldn't check.",[645,1438,1439,1440,1443,1444,1447,1448,1451,1452,1455,1456,1459,1460,1466,1467,673],{},"An add-on set to auto-update is checked after each server start and once a day while the server runs. ",[648,1441,1442],{},"kraft admin addon list"," marks it ",[648,1445,1446],{},"auto-update (collection)"," or ",[648,1449,1450],{},"auto-update (addon)","; its last outcome is on the ",[648,1453,1454],{},"add-on updates"," row of ",[648,1457,1458],{},"kraft admin doctor"," and in ",[653,1461,1463],{"href":1462},"\u002Freference\u002Fhttp-api#get-apihealth",[648,1464,1465],{},"GET \u002Fapi\u002Fhealth",". See ",[653,1468,1470],{"href":1469},"\u002Freference\u002Fconfiguration\u002Faddons#auto-update","Auto-update",[905,1472,1474],{"id":1473},"admin-addon-auto-update",[648,1475,815],{},[911,1477,1480],{"className":1478,"code":1479,"language":916,"meta":917},[914],"kraft admin addon auto-update [flags] ADDON@COLLECTION on|off\n",[648,1481,1482],{"__ignoreMap":917},[921,1483,1479],{"className":1484},[924],[645,1486,1487],{},"Sets one add-on's auto-update. It takes no flags.",[680,1489,1490,1498],{},[683,1491,1492],{},[686,1493,1494,1496],{},[689,1495,1128],{},[689,1497,1131],{},[696,1499,1500],{},[686,1501,1502,1504],{},[701,1503,1138],{},[701,1505,1506],{},"Its collection already auto-updates.",[905,1508,1510],{"id":1509},"admin-addon-enable",[648,1511,830],{},[911,1513,1516],{"className":1514,"code":1515,"language":916,"meta":917},[914],"kraft admin addon enable ADDON@COLLECTION\n",[648,1517,1518],{"__ignoreMap":917},[921,1519,1515],{"className":1520},[924],[645,1522,1523,1524,673],{},"Loads an installed add-on. It takes no flags and no ",[648,1525,667],{},[905,1527,1529],{"id":1528},"admin-addon-disable",[648,1530,845],{},[911,1532,1535],{"className":1533,"code":1534,"language":916,"meta":917},[914],"kraft admin addon disable ADDON@COLLECTION\n",[648,1536,1537],{"__ignoreMap":917},[921,1538,1534],{"className":1539},[924],[645,1541,1542,1543,1545,1546,1550],{},"Keeps an add-on installed and not loaded. It takes no flags and no ",[648,1544,667],{},". ",[653,1547,1549],{"href":1548},"#remove-an-add-on","Remove an add-on"," says when it is refused.",[905,1552,1554],{"id":1553},"admin-addon-uninstall",[648,1555,860],{},[911,1557,1560],{"className":1558,"code":1559,"language":916,"meta":917},[914],"kraft admin addon uninstall [flags] ADDON@COLLECTION\n",[648,1561,1562],{"__ignoreMap":917},[921,1563,1559],{"className":1564},[924],[645,1566,1567],{},"Removes an add-on. It takes no flags.",[680,1569,1570,1578],{},[683,1571,1572],{},[686,1573,1574,1576],{},[689,1575,1128],{},[689,1577,1131],{},[696,1579,1580],{},[686,1581,1582,1585],{},[701,1583,1584],{},"Refused, listing each reference",[701,1586,1587],{},"Your own config still references its namespace.",[1002,1589,1549],{"id":1590},"remove-an-add-on",[645,1592,1593,660,1596,1599,1600,656,1602,656,1604,1447,1606,1609],{},[648,1594,1595],{},"kraft admin addon uninstall",[648,1597,1598],{},"disable"," are refused while your library, a chain, ",[648,1601,387],{},[648,1603,417],{},[648,1605,405],{},[648,1607,1608],{},"harnesses.yaml"," still names the add-on's namespace. The refusal lists each reference.",[645,1611,1612,1613,1617],{},"A ",[653,1614,1616],{"href":1615},"\u002Fconcepts\u002Fvocabulary#worker","worker"," can't run the verbs that change add-ons.",[905,1619,1621],{"id":1620},"admin-addon-list",[648,1622,875],{},[911,1624,1627],{"className":1625,"code":1626,"language":916,"meta":917},[914],"kraft admin addon list [flags]\n",[648,1628,1629],{"__ignoreMap":917},[921,1630,1626],{"className":1631},[924],[645,1633,1634,1635,1638,1639,1641],{},"Every installed add-on (not the built-in ",[648,1636,1637],{},"kraft-default",", which ships with Kraft): namespace, version and commit, with its auto-update setting, why it isn't loaded, and a pending alias, ",[648,1640,1356],{}," or collection URL change. It takes no flags.",[905,1643,1645],{"id":1644},"the-built-in-kraft-default","The built-in kraft-default",[645,1647,1648],{},[713,1649,1650],{},"Added in 2.6",[645,1652,1653,1654,1657,1658,1447,1660,1663,1664,673],{},"The built-in ",[648,1655,1656],{},"kraft-default@kraft"," ships with Kraft and takes its version from Kraft's. A bare ",[648,1659,1375],{},[648,1661,1662],{},"update --check"," skips it. See ",[653,1665,278],{"href":279},[680,1667,1668,1676],{},[683,1669,1670],{},[686,1671,1672,1674],{},[689,1673,1128],{},[689,1675,1131],{},[696,1677,1678,1704],{},[686,1679,1680,1685],{},[701,1681,1682],{},[648,1683,1684],{},"error: kraft-default@kraft comes with Kraft; upgrading Kraft updates it",[701,1686,1687,656,1690,656,1692,656,1695,656,1698,1447,1700,1703],{},[648,1688,1689],{},"install",[648,1691,1375],{},[648,1693,1694],{},"auto-update",[648,1696,1697],{},"enable",[648,1699,1598],{},[648,1701,1702],{},"uninstall"," names it.",[686,1705,1706,1711],{},[701,1707,1708],{},[648,1709,1710],{},"error: the collection name 'kraft' is Kraft's own",[701,1712,1713,1716,1717,673],{},[648,1714,1715],{},"collection add"," names a collection ",[648,1718,1719],{},"kraft",[675,1721,1723],{"id":1722},"check-an-add-on","Check an add-on",[645,1725,1726],{},[713,1727,715],{},[905,1729,1731],{"id":1730},"admin-addon-validate",[648,1732,890],{},[911,1734,1737],{"className":1735,"code":1736,"language":916,"meta":917},[914],"kraft admin addon validate [flags] PATH\n",[648,1738,1739],{"__ignoreMap":917},[921,1740,1736],{"className":1741},[924],[645,1743,1744],{},"Checks a collection or a single add-on directory and installs nothing. Exits 1 on any problem.",[680,1746,1747,1759],{},[683,1748,1749],{},[686,1750,1751,1753,1755,1757],{},[689,1752,940],{},[689,1754,943],{},[689,1756,946],{},[689,1758,949],{},[696,1760,1761,1777],{},[686,1762,1763,1768,1771,1774],{},[701,1764,1765],{},[648,1766,1767],{},"--with",[701,1769,1770],{},"directory, repeatable",[701,1772,1773],{},"none",[701,1775,1776],{},"A collection or add-on directory to find a child add-on's parent in.",[686,1778,1779,1783,1785,1787],{},[701,1780,1781],{},[648,1782,667],{},[701,1784,977],{},[701,1786,980],{},[701,1788,1789,1790,656,1793,656,1796,660,1799,673],{},"Prints the report as an object with ",[648,1791,1792],{},"addons",[648,1794,1795],{},"problems",[648,1797,1798],{},"warnings",[648,1800,1801],{},"skipped",[1002,1803,1805],{"id":1804},"validate-a-collection-or-an-add-on","Validate a collection or an add-on",[645,1807,1808,1811,1812,1815,1816,673],{},[648,1809,1810],{},"PATH"," is a directory holding ",[648,1813,1814],{},".kraft\u002Fcollection.json",", or one holding ",[648,1817,1818],{},".kraft\u002Faddon.json",[645,1820,1821],{},"It checks each add-on's files against the size and content limits, both manifests, the Kraft version the add-on requires, and that every chain the add-on ships resolves.",[645,1823,1824,1825,1828,1829,660,1832,1835,1836,1839],{},"When the config directory holds a ",[648,1826,1827],{},"library.yaml",", it also checks the add-on as an install into that instance: its ",[648,1830,1831],{},"requires.harnesses",[648,1833,1834],{},"requires.profiles",", its namespace, and your own chains. With none, it prints a ",[648,1837,1838],{},"skipped:"," line naming those checks.",[645,1841,1842],{},"It prints one line per add-on with its version and digest, then each problem with its file, then warnings: a manifest key Kraft doesn't read, and a file that looks like part of the add-on layout and isn't.",[645,1844,1845,1846,1850],{},"It exits 0 when every add-on passes and 1 otherwise, so a collection's CI can run it on every push; ",[653,1847,1849],{"href":1848},"\u002Fguides\u002Fcustomize\u002Fpublish-an-add-on#run-validate-in-ci","Run validate in CI"," shows a job.",[1002,1852,1854],{"id":1853},"validate-a-child-add-on","Validate a child add-on",[645,1856,1857],{},[713,1858,1859],{},"Added in 2.3",[645,1861,1862,1863,1866],{},"An add-on that builds on another (",[648,1864,1865],{},"requires.addons",") is checked together with its parent and every ancestor above it. Validate looks for each one, in order:",[1868,1869,1870,1877,1890,1893],"ol",{},[1871,1872,1873,1874,1876],"li",{},"in ",[648,1875,1810],{},", when it is a collection that publishes the parent",[1871,1878,1879,1880,1883,1884,1886,1887,1889],{},"in each ",[648,1881,1882],{},"--with DIR",", a collection directory or a single add-on directory; repeat ",[648,1885,1767],{}," for more than one. A ",[648,1888,1767],{}," directory that holds neither manifest is a problem",[1871,1891,1892],{},"on this instance, as installed",[1871,1894,1895,1896,1898],{},"on this instance, as the current version of a collection added in ",[648,1897,1018],{},", which validate fetches into a temporary directory, so the instance isn't changed",[911,1900,1904],{"className":1901,"code":1902,"language":1903,"meta":917,"style":917},"language-bash shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","kraft admin addon validate .\u002Fpayments-addons --with .\u002Fcompany-addons\n","bash",[648,1905,1906],{"__ignoreMap":917},[921,1907,1909,1912,1916,1919,1922,1925,1929],{"class":924,"line":1908},1,[921,1910,1719],{"class":1911},"szw1H",[921,1913,1915],{"class":1914},"semJd"," admin",[921,1917,1918],{"class":1914}," addon",[921,1920,1921],{"class":1914}," validate",[921,1923,1924],{"class":1914}," .\u002Fpayments-addons",[921,1926,1928],{"class":1927},"ssYy9"," --with",[921,1930,1931],{"class":1914}," .\u002Fcompany-addons\n",[645,1933,1934,1935,1938,1939,1941,1942,1944,1945,1948,1949,673],{},"When none of them has the parent, validate still checks the child's own files, then exits 1 with ",[648,1936,1937],{},"its parent \u003Cid> could not be found in PATH, --with or this instance; pass its collection with --with",", alongside any other problem it finds. A tree that is a cycle, or deeper than 8 add-ons, is reported the same way. In ",[648,1940,667],{},", each entry of ",[648,1943,1792],{}," carries ",[648,1946,1947],{},"parent",", the parent's ID or ",[648,1950,1951],{},"null",[675,1953,1955],{"id":1954},"related","Related",[1957,1958,1959,1964],"ul",{},[1871,1960,1961,1963],{},[653,1962,139],{"href":140},": publish a collection and install an add-on from it.",[1871,1965,1966,1968,1969,1971],{},[653,1967,471],{"href":472},": the manifests, ",[648,1970,1018],{},", the lock, and when an add-on loads or updates.",[1973,1974,1975],"style",{},"html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":917,"searchDepth":1977,"depth":1977,"links":1978},2,[1979,1980,2000,2004],{"id":677,"depth":1977,"text":678},{"id":898,"depth":1977,"text":1981,"children":1982},"Install and update add-​ons",[1983,1985,1986,1987,1989,1990,1991,1992,1994,1995,1996,1997,1998],{"id":907,"depth":1984,"text":708},3,{"id":1050,"depth":1984,"text":725},{"id":1067,"depth":1984,"text":740},{"id":1088,"depth":1984,"text":1988},"admin addon collection auto-​update",{"id":1105,"depth":1984,"text":770},{"id":1144,"depth":1984,"text":785},{"id":1283,"depth":1984,"text":800},{"id":1473,"depth":1984,"text":1993},"admin addon auto-​update",{"id":1509,"depth":1984,"text":830},{"id":1528,"depth":1984,"text":845},{"id":1553,"depth":1984,"text":860},{"id":1620,"depth":1984,"text":875},{"id":1644,"depth":1984,"text":1999},"The built-​in kraft-​default",{"id":1722,"depth":1977,"text":2001,"children":2002},"Check an add-​on",[2003],{"id":1730,"depth":1984,"text":890},{"id":1954,"depth":1977,"text":1955},"The kraft admin addon verbs: add collections, install, update, remove and validate add-ons.","md",null,{},true,{"title":361,"description":2005},"CjZAqp4cl_5AJWqwRgh_lUmLmRWsRDxKjsZXCzaxYS4",[2013,2015],{"title":357,"path":358,"stem":359,"description":2014,"children":-1},"The kraft admin verbs that run this machine's server: start, stop, restart, update and reload it, check its health and inspect its templates and harnesses.",{"title":365,"path":366,"stem":367,"description":2016,"children":-1},"The kraft admin worker verbs: register, change and remove the machines that run steps, and run a machine's side.",1794749037144]