@almadar/std 17.0.1 → 17.0.3

package/behaviors/registry/cli/atoms/std-orb-supervise.orb

@@ -1 +1 @@
-{"typeContractVersion":1,"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"ChildSpec":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]},"name":"std-orb-supervise","version":"1.0.0","description":"std-orb-supervise — the `orb supervise [--watch <glob>]... [--debounce <ms>] -- <command> [args...]` command: it keeps one child process running under std-supervisor (restart policy permanent, so a crash restarts it) and restarts it a debounce after any file matching a --watch glob (relative to the working directory, recursive) changes. A restart signals the child with TERM, waits for its exit and only then respawns it, so two copies never run at once. The command is the word after `--` and must be `orb`: an os/spawn command is matched exactly against the exec grant and is a build-time literal, so only its arguments are read at run time. --debounce defaults to the debounceMs knob. The command stays open until TERM or INT stops the child and answers 200; a usage error answers 400 (exit 2); a failed watch, a failed spawn or a crash loop beyond the supervisor's restart intensity answers 500 (exit 1).","orbitals":[{"name":"OrbSuperviseOrbital","id":"orb_5PS5JJA1BB0NNTG5QV1A51ND0N","uses":[{"from":"almadar-std/orb-supervise","as":"Spec"},{"from":"std/behaviors/std-args","as":"Args"},{"from":"std/behaviors/std-supervisor","as":"Sup"}],"entity":{"name":"OrbSuperviseRun","id":"ent_GMRDVPAE1B70NPX132FREXW408","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"command","type":"array","default":[],"items":{"nullable":false,"type":"string"}},{"nullable":false,"name":"watches","type":"array","default":[],"items":{"nullable":false,"type":"string"}},{"nullable":false,"name":"debounce","type":"number","default":0},{"nullable":false,"name":"cursor","type":"number","default":0},{"nullable":false,"name":"pending","type":"string","default":""}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W","name":"ArgsCli","listens":[{"event":"SUPERVISE_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbSupervise"}}]},{"ref":"Sup.traits.Supervisor","id":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H","name":"Supervisor","config":{"strategy":{"nullable":false,"type":"string","default":"one-for-one"},"maxRestarts":{"nullable":false,"type":"number","default":5},"periodMs":{"nullable":false,"type":"number","default":60000},"command":{"nullable":false,"type":"string","default":"orb"}},"listens":[{"event":"SUPERVISE_START","triggers":"START","source":{"kind":"trait","trait":"OrbSupervise"}},{"event":"SUPERVISE_STOP","triggers":"STOP","source":{"kind":"trait","trait":"OrbSupervise"}},{"event":"SUPERVISE_RESTART","triggers":"RESTART","source":{"kind":"trait","trait":"OrbSupervise"}}]},{"name":"OrbSupervise","id":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","effectRow":[{"kind":"emit","resource":"SUPERVISE_ANSWERED"},{"kind":"emit","resource":"SUPERVISE_ARGS_PARSE"},{"kind":"emit","resource":"SUPERVISE_BOOT"},{"kind":"emit","resource":"SUPERVISE_RESTART"},{"kind":"emit","resource":"SUPERVISE_START"},{"kind":"emit","resource":"SUPERVISE_STOP"},{"kind":"emit","resource":"SUPERVISE_WATCH"},{"kind":"os/watch-files"},{"kind":"os/watch-signal"},{"kind":"set","resource":"@entity.command"},{"kind":"set","resource":"@entity.cursor"},{"kind":"set","resource":"@entity.debounce"},{"kind":"set","resource":"@entity.pending"},{"kind":"set","resource":"@entity.watches"}],"linkedEntity":"OrbSuperviseRun","linkedEntityId":"ent_GMRDVPAE1B70NPX132FREXW408","entityRefIds":{"OrbSuperviseRun":"ent_GMRDVPAE1B70NPX132FREXW408"},"emits":[{"event":"SUPERVISE_ANSWERED","eventId":"evt_ZF02NRQ222H1127SKRH4FV2CJC","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"event":"SUPERVISE_ARGS_PARSE","eventId":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","description":"Internal: parse the words before `--` against the --watch and --debounce flags.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"event":"SUPERVISE_BOOT","eventId":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","description":"Internal: start the child and the watchers.","tier":"internal"},{"event":"SUPERVISE_WATCH","eventId":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","description":"Internal: start the next --watch glob.","tier":"internal","payloadSchema":[{"nullable":false,"name":"at","type":"number","required":true}]},{"event":"SUPERVISE_START","eventId":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","description":"Internal: ask the supervisor to spawn this child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"children","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"items":{"nullable":false,"name":"","type":"ChildSpec","projectedFrom":{"type":"ChildSpec"}}}]},{"event":"SUPERVISE_STOP","eventId":"evt_D79N555SBXWNYTETPD9YBNPT1S","description":"Internal: ask the supervisor to stop the child.","tier":"internal"},{"event":"SUPERVISE_RESTART","eventId":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","description":"Internal: ask the supervisor to restart the child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"index","type":"number","required":true}]},{"event":"SUPERVISE_CHANGED","eventId":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","description":"A watched file changed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"path","type":"string"},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"SUPERVISE_WATCH_FAILED","eventId":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","description":"A --watch glob could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"SUPERVISE_SIGNALLED","eventId":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","description":"TERM or INT reached the process.","tier":"internal","payloadSchema":[{"nullable":false,"name":"signal","type":"string"}]},{"event":"SUPERVISE_SIGNAL_FAILED","eventId":"evt_HPPKB7ZD0DPG6P30755D59B2T8","description":"A signal could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]}],"listens":[{"event":"ARGS_PARSED","triggers":"SUPERVISE_ARGS_DONE","triggersId":"evt_GV42J072PTHBD8R969XWANT57E","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W"}},{"event":"SUPERVISOR_GAVE_UP","triggers":"SUPERVISE_GAVE_UP","triggersId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","source":{"kind":"trait","trait":"Supervisor","traitId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}},{"event":"SUPERVISOR_STOPPED","triggers":"SUPERVISE_STOPPED","triggersId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","source":{"kind":"trait","trait":"Supervisor","traitId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"running"},{"name":"stopping"}],"events":[{"key":"INIT","id":"evt_4HW9F7J28R14CF23FNF58YTRDQ","name":"Initialize"},{"key":"SUPERVISE_CALLED","id":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","name":"Supervise Called","description":"Run `orb supervise` with its arguments and working directory.","synonyms":"orb supervise, restart on change, keep running","payloadSchema":[{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"rawBody","type":"string","required":true}],"listened":true,"inbound":{"name":"cli-supervise","answers":"SUPERVISE_ANSWERED"}},{"key":"SUPERVISE_ARGS_DONE","id":"evt_GV42J072PTHBD8R969XWANT57E","name":"Supervise Args Done","description":"std-args's ARGS_PARSED: the words before `--`, parsed.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"flags","type":"Map<string,[string]>","required":true,"items":{"nullable":false,"name":"","type":"[string]","items":{"nullable":false,"name":"","type":"string"}}},{"nullable":false,"name":"positionals","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"errors","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"words","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"SUPERVISE_BOOT","id":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","name":"Supervise Boot","description":"Internal: start the child and the watchers.","tier":"internal"},{"key":"SUPERVISE_WATCH","id":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","name":"Supervise Watch","description":"Internal: start the next --watch glob.","tier":"internal","payloadSchema":[{"nullable":false,"name":"at","type":"number","required":true}]},{"key":"SUPERVISE_CHANGED","id":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","name":"Supervise Changed","description":"A watched file changed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"path","type":"string"},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"key":"SUPERVISE_WATCH_FAILED","id":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","name":"Supervise Watch Failed","description":"A --watch glob could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SUPERVISE_SIGNALLED","id":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","name":"Supervise Signalled","description":"TERM or INT reached the process.","tier":"internal","payloadSchema":[{"nullable":false,"name":"signal","type":"string"}]},{"key":"SUPERVISE_SIGNAL_FAILED","id":"evt_HPPKB7ZD0DPG6P30755D59B2T8","name":"Supervise Signal Failed","description":"A signal could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SUPERVISE_GAVE_UP","id":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","name":"Supervise Gave Up","description":"std-supervisor's SUPERVISOR_GAVE_UP: a spawn failed or the child crashed beyond the restart intensity.","payloadSchema":[{"nullable":false,"name":"reason","type":"string","required":true},{"nullable":false,"name":"child","type":"string","required":true},{"nullable":false,"name":"restarts","type":"number","required":true},{"nullable":false,"name":"error","type":"string"}],"listened":true},{"key":"SUPERVISE_STOPPED","id":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","name":"Supervise Stopped","description":"std-supervisor's SUPERVISOR_STOPPED: the child was signalled.","listened":true},{"key":"SUPERVISE_ANSWERED","id":"evt_ZF02NRQ222H1127SKRH4FV2CJC","name":"Supervise Answered","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"key":"SUPERVISE_ARGS_PARSE","id":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","name":"Supervise Args Parse","description":"Internal: parse the words before `--` against the --watch and --debounce flags.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"key":"SUPERVISE_START","id":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","name":"Supervise Start","description":"Internal: ask the supervisor to spawn this child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"children","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"items":{"nullable":false,"name":"","type":"ChildSpec","projectedFrom":{"type":"ChildSpec"}}}]},{"key":"SUPERVISE_STOP","id":"evt_D79N555SBXWNYTETPD9YBNPT1S","name":"Supervise Stop","description":"Internal: ask the supervisor to stop the child.","tier":"internal"},{"key":"SUPERVISE_RESTART","id":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","name":"Supervise Restart","description":"Internal: ask the supervisor to restart the child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"index","type":"number","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["and",["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],["not",["array/includes",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"--"]]],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["and",["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],["array/includes",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"--"]],"effects":[["let",[["argv",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"]]],["let",[["cut",["array/reduce",["array/range",["array/len","@argv"]],-1,["fn",["acc","i"],["if",["and",["<","@acc",0],["=",["array/nth","@argv","@i"],"--"]],"@i","@acc"]]]]],["do",["set","@entity.command",["array/drop","@argv",["+","@cut",1]]],["emit","SUPERVISE_ARGS_PARSE",{"stage":"supervise","argv":["array/take","@argv","@cut"],"flags":[{"name":"watch","aliases":[],"takesValue":true,"repeatable":true},{"name":"debounce","aliases":[],"takesValue":true,"repeatable":false}]}]]]]]},{"from":"ready","to":"ready","event":"SUPERVISE_ARGS_DONE","eventId":"evt_GV42J072PTHBD8R969XWANT57E","guard":["or",[">",["array/len","@payload.errors"],0],[">",["array/len","@payload.positionals"],0],["=",["array/len","@entity.command"],0],["!=",["array/first","@entity.command"],"orb"],["and",["object/has","@payload.flags","debounce"],["not",["validate/pattern",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""],"^[0-9]+$"]]]],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"running","event":"SUPERVISE_ARGS_DONE","eventId":"evt_GV42J072PTHBD8R969XWANT57E","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],[">",["array/len","@entity.command"],0],["=",["array/first","@entity.command"],"orb"],["or",["not",["object/has","@payload.flags","debounce"]],["validate/pattern",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""],"^[0-9]+$"]]],"effects":[["set","@entity.watches",["default",["object/get","@payload.flags","watch"],[]]],["set","@entity.debounce",["if",["object/has","@payload.flags","debounce"],["default",["str/to-number",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""]],"@config.debounceMs"],"@config.debounceMs"]],["set","@entity.cursor",0],["emit","SUPERVISE_BOOT",{}]]},{"from":"running","to":"running","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"running","to":"running","event":"SUPERVISE_BOOT","eventId":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","effects":[["os/watch-signal","TERM",{"key":"term","emit":{"onMessage":"SUPERVISE_SIGNALLED","failure":"SUPERVISE_SIGNAL_FAILED"}}],["os/watch-signal","INT",{"key":"int","emit":{"onMessage":"SUPERVISE_SIGNALLED","failure":"SUPERVISE_SIGNAL_FAILED"}}],["emit","SUPERVISE_START",{"children":[{"name":"child","command":"orb","args":["array/drop","@entity.command",1],"restart":"permanent"}]}],["emit","SUPERVISE_WATCH",{"at":0}]]},{"from":"running","to":"running","event":"SUPERVISE_WATCH","eventId":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","guard":["<","@entity.cursor",["array/len","@entity.watches"]],"effects":[["os/watch-files",{"anchor":"cwd","path":["array/nth","@entity.watches","@entity.cursor"]},{"key":"watch","emit":{"onMessage":"SUPERVISE_CHANGED","failure":"SUPERVISE_WATCH_FAILED"}}],["set","@entity.cursor",["+","@entity.cursor",1]],["emit","SUPERVISE_WATCH",{"at":["+","@entity.cursor",1]}]]},{"from":"running","to":"running","event":"SUPERVISE_CHANGED","eventId":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","effects":[["emit","SUPERVISE_RESTART",{"index":0}]]},{"from":"running","to":"stopping","event":"SUPERVISE_WATCH_FAILED","eventId":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","effects":[["set","@entity.pending",["str/concat","watch failed: ",["default","@payload.error","host failure"]]],["emit","SUPERVISE_STOP",{}]]},{"from":"running","to":"stopping","event":"SUPERVISE_SIGNALLED","eventId":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","effects":[["set","@entity.pending",""],["emit","SUPERVISE_STOP",{}]]},{"from":"running","to":"running","event":"SUPERVISE_SIGNAL_FAILED","eventId":"evt_HPPKB7ZD0DPG6P30755D59B2T8"},{"from":"running","to":"ready","event":"SUPERVISE_GAVE_UP","eventId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":["str/concat","supervisor gave up: ","@payload.reason"," (","@payload.child",")",["if",["validate/required","@payload.error"],["str/concat",": ",["default","@payload.error",""]],""]]}]]},{"from":"stopping","to":"stopping","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"stopping","to":"ready","event":"SUPERVISE_STOPPED","eventId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","guard":["=","@entity.pending",""],"effects":[["emit","SUPERVISE_ANSWERED",{"status":200,"body":"stopped"}]]},{"from":"stopping","to":"ready","event":"SUPERVISE_STOPPED","eventId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","guard":["!=","@entity.pending",""],"effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":"@entity.pending"}]]},{"from":"stopping","to":"ready","event":"SUPERVISE_GAVE_UP","eventId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":["str/concat","supervisor gave up: ","@payload.reason"," (","@payload.child",")",["if",["validate/required","@payload.error"],["str/concat",": ",["default","@payload.error",""]],""]]}]]}]},"config":{"debounceMs":{"nullable":false,"type":"number","default":3000,"label":"Default debounce (ms)","description":"How long file changes settle before the child restarts when --debounce is not given.","tier":"domain"}},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","fingerprint":"319b6464b1205c8d5ae85cea84f03cd536bc7c0f5e33aa12718b7d157199798d"}}],"pages":[{"name":"OrbSuperviseOrbitalStart","id":"pag_TDW5M7QS5EWJQ125136MXJDNEV","path":"","protocol":"boot","traits":[{"ref":"OrbSupervise","refId":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},{"ref":"ArgsCli","refId":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W"},{"ref":"Supervisor","refId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}]}],"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"ChildSpec":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]}}],"inbound":["cli-supervise"],"osGrants":{"fs":[],"exec":["orb"],"net":[],"env":["PATH","HOME"],"stdio":["out","err"],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":"**","modes":["read"]}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_GMRDVPAE1B70NPX132FREXW408":{"id":"ent_GMRDVPAE1B70NPX132FREXW408","kind":"entity","bakedName":"OrbSuperviseRun","curName":"OrbSuperviseRun","renames":[],"owner":"workspace"},"evt_4HW9F7J28R14CF23FNF58YTRDQ":{"id":"evt_4HW9F7J28R14CF23FNF58YTRDQ","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C":{"id":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","kind":"event","bakedName":"SUPERVISE_BOOT","curName":"SUPERVISE_BOOT","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_7V5GWYCEHV78XVXCTXN4V1H8DH":{"id":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","kind":"event","bakedName":"SUPERVISE_STOPPED","curName":"SUPERVISE_STOPPED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_D79N555SBXWNYTETPD9YBNPT1S":{"id":"evt_D79N555SBXWNYTETPD9YBNPT1S","kind":"event","bakedName":"SUPERVISE_STOP","curName":"SUPERVISE_STOP","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_DZYCXZXPDMV6T17KY56MV7S61Y":{"id":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","kind":"event","bakedName":"SUPERVISE_SIGNALLED","curName":"SUPERVISE_SIGNALLED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_F04A05S9MVMTDQY9QJRCN4G75Y":{"id":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","kind":"event","bakedName":"SUPERVISE_ARGS_PARSE","curName":"SUPERVISE_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_GV42J072PTHBD8R969XWANT57E":{"id":"evt_GV42J072PTHBD8R969XWANT57E","kind":"event","bakedName":"SUPERVISE_ARGS_DONE","curName":"SUPERVISE_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35":{"id":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","kind":"event","bakedName":"SUPERVISE_WATCH_FAILED","curName":"SUPERVISE_WATCH_FAILED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HPPKB7ZD0DPG6P30755D59B2T8":{"id":"evt_HPPKB7ZD0DPG6P30755D59B2T8","kind":"event","bakedName":"SUPERVISE_SIGNAL_FAILED","curName":"SUPERVISE_SIGNAL_FAILED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HRQKK0DYVMZDT1GE66BTGYEKZH":{"id":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","kind":"event","bakedName":"SUPERVISE_WATCH","curName":"SUPERVISE_WATCH","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JBSS3C6HCY8PF1EC62NT3EWPC5":{"id":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","kind":"event","bakedName":"SUPERVISE_CHANGED","curName":"SUPERVISE_CHANGED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JF4MJG30PXGBEHJMNMVX98T5HY":{"id":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","kind":"event","bakedName":"SUPERVISE_GAVE_UP","curName":"SUPERVISE_GAVE_UP","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT":{"id":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","kind":"event","bakedName":"SUPERVISE_CALLED","curName":"SUPERVISE_CALLED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_PAHXMZB268H34E74ZPZV5MRQ2F":{"id":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","kind":"event","bakedName":"SUPERVISE_START","curName":"SUPERVISE_START","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_ST5MQ86GG7883SYYZVZ3HAPFST":{"id":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","kind":"event","bakedName":"SUPERVISE_RESTART","curName":"SUPERVISE_RESTART","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_ZF02NRQ222H1127SKRH4FV2CJC":{"id":"evt_ZF02NRQ222H1127SKRH4FV2CJC","kind":"event","bakedName":"SUPERVISE_ANSWERED","curName":"SUPERVISE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"orb_5PS5JJA1BB0NNTG5QV1A51ND0N":{"id":"orb_5PS5JJA1BB0NNTG5QV1A51ND0N","kind":"orbital","bakedName":"OrbSuperviseOrbital","curName":"OrbSuperviseOrbital","renames":[],"owner":"workspace"},"pag_TDW5M7QS5EWJQ125136MXJDNEV":{"id":"pag_TDW5M7QS5EWJQ125136MXJDNEV","kind":"page","bakedName":"OrbSuperviseOrbitalStart","curName":"OrbSuperviseOrbitalStart","renames":[],"owner":"workspace"},"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H":{"id":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H","kind":"trait","bakedName":"Supervisor","curName":"Supervisor","renames":[],"owner":"workspace"},"trt_CW9DRGQ244H22AZRTANTMAVP3Y":{"id":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","kind":"trait","bakedName":"OrbSupervise","curName":"OrbSupervise","renames":[],"owner":"workspace"},"trt_VYKSG5597FMKQT4V0MJA7FMZ6W":{"id":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"}}}}
+{"typeContractVersion":1,"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"ChildSpec":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]},"name":"std-orb-supervise","version":"1.0.0","description":"std-orb-supervise — the `orb supervise [--watch <glob>]... [--debounce <ms>] -- <command> [args...]` command: it keeps one child process running under std-supervisor (restart policy permanent, so a crash restarts it) and restarts it a debounce after any file matching a --watch glob (relative to the working directory, recursive) changes. A restart signals the child with TERM, waits for its exit and only then respawns it, so two copies never run at once. The command is the word after `--` and must be `orb`: an os/spawn command is matched exactly against the exec grant and is a build-time literal, so only its arguments are read at run time. --debounce defaults to the debounceMs knob. The command stays open until TERM or INT stops the child and answers 200; a usage error answers 400 (exit 2); a failed watch, a failed spawn or a crash loop beyond the supervisor's restart intensity answers 500 (exit 1).","orbitals":[{"name":"OrbSuperviseOrbital","id":"orb_5PS5JJA1BB0NNTG5QV1A51ND0N","uses":[{"from":"almadar-std/orb-supervise","as":"Spec"},{"from":"std/behaviors/std-args","as":"Args"},{"from":"std/behaviors/std-supervisor","as":"Sup"}],"entity":{"name":"OrbSuperviseRun","id":"ent_GMRDVPAE1B70NPX132FREXW408","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"command","type":"array","default":[],"items":{"nullable":false,"type":"string"}},{"nullable":false,"name":"watches","type":"array","default":[],"items":{"nullable":false,"type":"string"}},{"nullable":false,"name":"debounce","type":"number","default":0},{"nullable":false,"name":"cursor","type":"number","default":0},{"nullable":false,"name":"pending","type":"string","default":""}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W","name":"ArgsCli","listens":[{"event":"SUPERVISE_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbSupervise"}}]},{"ref":"Sup.traits.Supervisor","id":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H","name":"Supervisor","config":{"strategy":{"nullable":false,"type":"string","default":"one-for-one"},"maxRestarts":{"nullable":false,"type":"number","default":5},"periodMs":{"nullable":false,"type":"number","default":60000},"command":{"nullable":false,"type":"string","default":"orb"}},"listens":[{"event":"SUPERVISE_START","triggers":"START","source":{"kind":"trait","trait":"OrbSupervise"}},{"event":"SUPERVISE_STOP","triggers":"STOP","source":{"kind":"trait","trait":"OrbSupervise"}},{"event":"SUPERVISE_RESTART","triggers":"RESTART","source":{"kind":"trait","trait":"OrbSupervise"}}]},{"name":"OrbSupervise","id":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","effectRow":[{"kind":"emit","resource":"SUPERVISE_ANSWERED"},{"kind":"emit","resource":"SUPERVISE_ARGS_PARSE"},{"kind":"emit","resource":"SUPERVISE_BOOT"},{"kind":"emit","resource":"SUPERVISE_RESTART"},{"kind":"emit","resource":"SUPERVISE_START"},{"kind":"emit","resource":"SUPERVISE_STOP"},{"kind":"emit","resource":"SUPERVISE_WATCH"},{"kind":"os/watch-files"},{"kind":"os/watch-signal"},{"kind":"set","resource":"@entity.command"},{"kind":"set","resource":"@entity.cursor"},{"kind":"set","resource":"@entity.debounce"},{"kind":"set","resource":"@entity.pending"},{"kind":"set","resource":"@entity.watches"}],"linkedEntity":"OrbSuperviseRun","linkedEntityId":"ent_GMRDVPAE1B70NPX132FREXW408","entityRefIds":{"OrbSuperviseRun":"ent_GMRDVPAE1B70NPX132FREXW408"},"emits":[{"event":"SUPERVISE_ANSWERED","eventId":"evt_ZF02NRQ222H1127SKRH4FV2CJC","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"event":"SUPERVISE_ARGS_PARSE","eventId":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","description":"Internal: parse the words before `--` against the --watch and --debounce flags.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"event":"SUPERVISE_BOOT","eventId":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","description":"Internal: start the child and the watchers.","tier":"internal"},{"event":"SUPERVISE_WATCH","eventId":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","description":"Internal: start the next --watch glob.","tier":"internal","payloadSchema":[{"nullable":false,"name":"at","type":"number","required":true}]},{"event":"SUPERVISE_START","eventId":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","description":"Internal: ask the supervisor to spawn this child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"children","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"items":{"nullable":false,"name":"","type":"ChildSpec","projectedFrom":{"type":"ChildSpec"}}}]},{"event":"SUPERVISE_STOP","eventId":"evt_D79N555SBXWNYTETPD9YBNPT1S","description":"Internal: ask the supervisor to stop the child.","tier":"internal"},{"event":"SUPERVISE_RESTART","eventId":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","description":"Internal: ask the supervisor to restart the child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"index","type":"number","required":true}]},{"event":"SUPERVISE_CHANGED","eventId":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","description":"A watched file changed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"path","type":"string"},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"SUPERVISE_WATCH_FAILED","eventId":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","description":"A --watch glob could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"SUPERVISE_SIGNALLED","eventId":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","description":"TERM or INT reached the process.","tier":"internal","payloadSchema":[{"nullable":false,"name":"signal","type":"string"}]},{"event":"SUPERVISE_SIGNAL_FAILED","eventId":"evt_HPPKB7ZD0DPG6P30755D59B2T8","description":"A signal could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]}],"listens":[{"event":"ARGS_PARSED","triggers":"SUPERVISE_ARGS_DONE","triggersId":"evt_GV42J072PTHBD8R969XWANT57E","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W"}},{"event":"SUPERVISOR_GAVE_UP","triggers":"SUPERVISE_GAVE_UP","triggersId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","source":{"kind":"trait","trait":"Supervisor","traitId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}},{"event":"SUPERVISOR_STOPPED","triggers":"SUPERVISE_STOPPED","triggersId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","source":{"kind":"trait","trait":"Supervisor","traitId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"running"},{"name":"stopping"}],"events":[{"key":"INIT","id":"evt_4HW9F7J28R14CF23FNF58YTRDQ","name":"Initialize"},{"key":"SUPERVISE_CALLED","id":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","name":"Supervise Called","description":"Run `orb supervise` with its arguments and working directory.","synonyms":"orb supervise, restart on change, keep running","payloadSchema":[{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"rawBody","type":"string","required":true}],"listened":true,"inbound":{"name":"cli-supervise","answers":"SUPERVISE_ANSWERED"}},{"key":"SUPERVISE_ARGS_DONE","id":"evt_GV42J072PTHBD8R969XWANT57E","name":"Supervise Args Done","description":"std-args's ARGS_PARSED: the words before `--`, parsed.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"flags","type":"Map<string,[string]>","required":true,"items":{"nullable":false,"name":"","type":"[string]","items":{"nullable":false,"name":"","type":"string"}}},{"nullable":false,"name":"positionals","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"errors","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"words","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"SUPERVISE_BOOT","id":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","name":"Supervise Boot","description":"Internal: start the child and the watchers.","tier":"internal"},{"key":"SUPERVISE_WATCH","id":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","name":"Supervise Watch","description":"Internal: start the next --watch glob.","tier":"internal","payloadSchema":[{"nullable":false,"name":"at","type":"number","required":true}]},{"key":"SUPERVISE_CHANGED","id":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","name":"Supervise Changed","description":"A watched file changed.","tier":"internal","payloadSchema":[{"nullable":false,"name":"path","type":"string"},{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"key":"SUPERVISE_WATCH_FAILED","id":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","name":"Supervise Watch Failed","description":"A --watch glob could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SUPERVISE_SIGNALLED","id":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","name":"Supervise Signalled","description":"TERM or INT reached the process.","tier":"internal","payloadSchema":[{"nullable":false,"name":"signal","type":"string"}]},{"key":"SUPERVISE_SIGNAL_FAILED","id":"evt_HPPKB7ZD0DPG6P30755D59B2T8","name":"Supervise Signal Failed","description":"A signal could not be watched.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SUPERVISE_GAVE_UP","id":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","name":"Supervise Gave Up","description":"std-supervisor's SUPERVISOR_GAVE_UP: a spawn failed or the child crashed beyond the restart intensity.","payloadSchema":[{"nullable":false,"name":"reason","type":"string","required":true},{"nullable":false,"name":"child","type":"string","required":true},{"nullable":false,"name":"restarts","type":"number","required":true},{"nullable":false,"name":"error","type":"string"}],"listened":true},{"key":"SUPERVISE_STOPPED","id":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","name":"Supervise Stopped","description":"std-supervisor's SUPERVISOR_STOPPED: the child was signalled.","listened":true},{"key":"SUPERVISE_ANSWERED","id":"evt_ZF02NRQ222H1127SKRH4FV2CJC","name":"Supervise Answered","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"key":"SUPERVISE_ARGS_PARSE","id":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","name":"Supervise Args Parse","description":"Internal: parse the words before `--` against the --watch and --debounce flags.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"key":"SUPERVISE_START","id":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","name":"Supervise Start","description":"Internal: ask the supervisor to spawn this child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"children","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"items":{"nullable":false,"name":"","type":"ChildSpec","projectedFrom":{"type":"ChildSpec"}}}]},{"key":"SUPERVISE_STOP","id":"evt_D79N555SBXWNYTETPD9YBNPT1S","name":"Supervise Stop","description":"Internal: ask the supervisor to stop the child.","tier":"internal"},{"key":"SUPERVISE_RESTART","id":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","name":"Supervise Restart","description":"Internal: ask the supervisor to restart the child.","tier":"internal","payloadSchema":[{"nullable":false,"name":"index","type":"number","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["and",["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],["not",["array/includes",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"--"]]],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"ready","event":"SUPERVISE_CALLED","eventId":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","guard":["and",["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],["array/includes",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"--"]],"effects":[["let",[["argv",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"]]],["let",[["cut",["array/reduce",["array/range",["array/len","@argv"]],-1,["fn",["acc","i"],["if",["and",["<","@acc",0],["=",["array/nth","@argv","@i"],"--"]],"@i","@acc"]]]]],["do",["set","@entity.command",["array/drop","@argv",["+","@cut",1]]],["emit","SUPERVISE_ARGS_PARSE",{"stage":"supervise","argv":["array/take","@argv","@cut"],"flags":[{"name":"watch","aliases":[],"takesValue":true,"repeatable":true},{"name":"debounce","aliases":[],"takesValue":true,"repeatable":false}]}]]]]]},{"from":"ready","to":"ready","event":"SUPERVISE_ARGS_DONE","eventId":"evt_GV42J072PTHBD8R969XWANT57E","guard":["or",[">",["array/len","@payload.errors"],0],[">",["array/len","@payload.positionals"],0],["=",["array/len","@entity.command"],0],["!=",["array/first","@entity.command"],"orb"],["and",["object/has","@payload.flags","debounce"],["not",["validate/pattern",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""],"^[0-9]+$"]]]],"effects":[["emit","SUPERVISE_ANSWERED",{"status":400,"body":"usage: orb supervise [--watch <glob>]... [--debounce <ms>] -- orb <args>..."}]]},{"from":"ready","to":"running","event":"SUPERVISE_ARGS_DONE","eventId":"evt_GV42J072PTHBD8R969XWANT57E","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],[">",["array/len","@entity.command"],0],["=",["array/first","@entity.command"],"orb"],["or",["not",["object/has","@payload.flags","debounce"]],["validate/pattern",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""],"^[0-9]+$"]]],"effects":[["set","@entity.watches",["default",["object/get","@payload.flags","watch"],[]]],["set","@entity.debounce",["if",["object/has","@payload.flags","debounce"],["default",["str/to-number",["default",["array/last",["default",["object/get","@payload.flags","debounce"],[]]],""]],"@config.debounceMs"],"@config.debounceMs"]],["set","@entity.cursor",0],["emit","SUPERVISE_BOOT",{}]]},{"from":"running","to":"running","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"running","to":"running","event":"SUPERVISE_BOOT","eventId":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","effects":[["os/watch-signal","TERM",{"key":"term","emit":{"onMessage":"SUPERVISE_SIGNALLED","failure":"SUPERVISE_SIGNAL_FAILED"}}],["os/watch-signal","INT",{"key":"int","emit":{"onMessage":"SUPERVISE_SIGNALLED","failure":"SUPERVISE_SIGNAL_FAILED"}}],["emit","SUPERVISE_START",{"children":[{"name":"child","command":"orb","args":["array/drop","@entity.command",1],"restart":"permanent"}]}],["emit","SUPERVISE_WATCH",{"at":0}]]},{"from":"running","to":"running","event":"SUPERVISE_WATCH","eventId":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","guard":["<","@entity.cursor",["array/len","@entity.watches"]],"effects":[["os/watch-files",{"anchor":"cwd","path":["array/nth","@entity.watches","@entity.cursor"]},{"key":"watch","emit":{"onMessage":"SUPERVISE_CHANGED","failure":"SUPERVISE_WATCH_FAILED"}}],["set","@entity.cursor",["+","@entity.cursor",1]],["emit","SUPERVISE_WATCH",{"at":["+","@entity.cursor",1]}]]},{"from":"running","to":"running","event":"SUPERVISE_CHANGED","eventId":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","effects":[["emit","SUPERVISE_RESTART",{"index":0}]]},{"from":"running","to":"stopping","event":"SUPERVISE_WATCH_FAILED","eventId":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","effects":[["set","@entity.pending",["str/concat","watch failed: ",["default","@payload.error","host failure"]]],["emit","SUPERVISE_STOP",{}]]},{"from":"running","to":"stopping","event":"SUPERVISE_SIGNALLED","eventId":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","effects":[["set","@entity.pending",""],["emit","SUPERVISE_STOP",{}]]},{"from":"running","to":"running","event":"SUPERVISE_SIGNAL_FAILED","eventId":"evt_HPPKB7ZD0DPG6P30755D59B2T8"},{"from":"running","to":"ready","event":"SUPERVISE_GAVE_UP","eventId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":["str/concat","supervisor gave up: ","@payload.reason"," (","@payload.child",")",["if",["validate/required","@payload.error"],["str/concat",": ",["default","@payload.error",""]],""]]}]]},{"from":"stopping","to":"stopping","event":"INIT","eventId":"evt_4HW9F7J28R14CF23FNF58YTRDQ"},{"from":"stopping","to":"ready","event":"SUPERVISE_STOPPED","eventId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","guard":["=","@entity.pending",""],"effects":[["emit","SUPERVISE_ANSWERED",{"status":200,"body":"stopped"}]]},{"from":"stopping","to":"ready","event":"SUPERVISE_STOPPED","eventId":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","guard":["!=","@entity.pending",""],"effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":"@entity.pending"}]]},{"from":"stopping","to":"ready","event":"SUPERVISE_GAVE_UP","eventId":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","effects":[["emit","SUPERVISE_ANSWERED",{"status":500,"body":["str/concat","supervisor gave up: ","@payload.reason"," (","@payload.child",")",["if",["validate/required","@payload.error"],["str/concat",": ",["default","@payload.error",""]],""]]}]]}]},"config":{"debounceMs":{"nullable":false,"type":"number","default":3000,"label":"Default debounce (ms)","description":"How long file changes settle before the child restarts when --debounce is not given.","tier":"domain"}},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","fingerprint":"319b6464b1205c8d5ae85cea84f03cd536bc7c0f5e33aa12718b7d157199798d"}}],"pages":[{"name":"OrbSuperviseOrbitalStart","id":"pag_TDW5M7QS5EWJQ125136MXJDNEV","path":"","protocol":"boot","traits":[{"ref":"OrbSupervise","refId":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},{"ref":"ArgsCli","refId":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W"},{"ref":"Supervisor","refId":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H"}]}],"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"ChildSpec":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"command","type":"string","required":true},{"nullable":false,"name":"args","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"restart","type":"string","values":["permanent","transient","temporary"],"required":true}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]}}],"inbound":["cli-supervise"],"osGrants":{"fs":[],"exec":[],"net":[],"env":["PATH","HOME"],"stdio":["out","err"],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":"**","modes":["read"]}],"exec":[{"anchor":"exe"}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_GMRDVPAE1B70NPX132FREXW408":{"id":"ent_GMRDVPAE1B70NPX132FREXW408","kind":"entity","bakedName":"OrbSuperviseRun","curName":"OrbSuperviseRun","renames":[],"owner":"workspace"},"evt_4HW9F7J28R14CF23FNF58YTRDQ":{"id":"evt_4HW9F7J28R14CF23FNF58YTRDQ","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C":{"id":"evt_5WQTZ8FXGPYRBFAQSSK2H4GY7C","kind":"event","bakedName":"SUPERVISE_BOOT","curName":"SUPERVISE_BOOT","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_7V5GWYCEHV78XVXCTXN4V1H8DH":{"id":"evt_7V5GWYCEHV78XVXCTXN4V1H8DH","kind":"event","bakedName":"SUPERVISE_STOPPED","curName":"SUPERVISE_STOPPED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_D79N555SBXWNYTETPD9YBNPT1S":{"id":"evt_D79N555SBXWNYTETPD9YBNPT1S","kind":"event","bakedName":"SUPERVISE_STOP","curName":"SUPERVISE_STOP","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_DZYCXZXPDMV6T17KY56MV7S61Y":{"id":"evt_DZYCXZXPDMV6T17KY56MV7S61Y","kind":"event","bakedName":"SUPERVISE_SIGNALLED","curName":"SUPERVISE_SIGNALLED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_F04A05S9MVMTDQY9QJRCN4G75Y":{"id":"evt_F04A05S9MVMTDQY9QJRCN4G75Y","kind":"event","bakedName":"SUPERVISE_ARGS_PARSE","curName":"SUPERVISE_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_GV42J072PTHBD8R969XWANT57E":{"id":"evt_GV42J072PTHBD8R969XWANT57E","kind":"event","bakedName":"SUPERVISE_ARGS_DONE","curName":"SUPERVISE_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35":{"id":"evt_HMA72R77E9KQ4HJ8BTJ3AM5B35","kind":"event","bakedName":"SUPERVISE_WATCH_FAILED","curName":"SUPERVISE_WATCH_FAILED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HPPKB7ZD0DPG6P30755D59B2T8":{"id":"evt_HPPKB7ZD0DPG6P30755D59B2T8","kind":"event","bakedName":"SUPERVISE_SIGNAL_FAILED","curName":"SUPERVISE_SIGNAL_FAILED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_HRQKK0DYVMZDT1GE66BTGYEKZH":{"id":"evt_HRQKK0DYVMZDT1GE66BTGYEKZH","kind":"event","bakedName":"SUPERVISE_WATCH","curName":"SUPERVISE_WATCH","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JBSS3C6HCY8PF1EC62NT3EWPC5":{"id":"evt_JBSS3C6HCY8PF1EC62NT3EWPC5","kind":"event","bakedName":"SUPERVISE_CHANGED","curName":"SUPERVISE_CHANGED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JF4MJG30PXGBEHJMNMVX98T5HY":{"id":"evt_JF4MJG30PXGBEHJMNMVX98T5HY","kind":"event","bakedName":"SUPERVISE_GAVE_UP","curName":"SUPERVISE_GAVE_UP","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT":{"id":"evt_JR7TPWDSGQWRBQ3T0KK1HB5HKT","kind":"event","bakedName":"SUPERVISE_CALLED","curName":"SUPERVISE_CALLED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_PAHXMZB268H34E74ZPZV5MRQ2F":{"id":"evt_PAHXMZB268H34E74ZPZV5MRQ2F","kind":"event","bakedName":"SUPERVISE_START","curName":"SUPERVISE_START","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_ST5MQ86GG7883SYYZVZ3HAPFST":{"id":"evt_ST5MQ86GG7883SYYZVZ3HAPFST","kind":"event","bakedName":"SUPERVISE_RESTART","curName":"SUPERVISE_RESTART","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"evt_ZF02NRQ222H1127SKRH4FV2CJC":{"id":"evt_ZF02NRQ222H1127SKRH4FV2CJC","kind":"event","bakedName":"SUPERVISE_ANSWERED","curName":"SUPERVISE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_CW9DRGQ244H22AZRTANTMAVP3Y"},"orb_5PS5JJA1BB0NNTG5QV1A51ND0N":{"id":"orb_5PS5JJA1BB0NNTG5QV1A51ND0N","kind":"orbital","bakedName":"OrbSuperviseOrbital","curName":"OrbSuperviseOrbital","renames":[],"owner":"workspace"},"pag_TDW5M7QS5EWJQ125136MXJDNEV":{"id":"pag_TDW5M7QS5EWJQ125136MXJDNEV","kind":"page","bakedName":"OrbSuperviseOrbitalStart","curName":"OrbSuperviseOrbitalStart","renames":[],"owner":"workspace"},"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H":{"id":"trt_CQFAHMGQ9TBMXB7FZWKHAR9C1H","kind":"trait","bakedName":"Supervisor","curName":"Supervisor","renames":[],"owner":"workspace"},"trt_CW9DRGQ244H22AZRTANTMAVP3Y":{"id":"trt_CW9DRGQ244H22AZRTANTMAVP3Y","kind":"trait","bakedName":"OrbSupervise","curName":"OrbSupervise","renames":[],"owner":"workspace"},"trt_VYKSG5597FMKQT4V0MJA7FMZ6W":{"id":"trt_VYKSG5597FMKQT4V0MJA7FMZ6W","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"}}}}