import{bz as y,c8 as k,db as g,cx as w,dc as T,aM as c,o as x,bs as s,bC as V,az as u,r as t,z as e,dd as _,de as h,df as d,q as m,aK as v,a_ as j,F as z,bD as f,cs as C,ct as i,cu as o,y as a,cv as r}from"./index-p5QwxXYb.js";const A={name:"Guide",head(){return{title:k("App.guide")}},components:{task:g,job:w},data:()=>({states:T})},I=t("h1",{class:"ma-0"},"Cylc UI Quick Start",-1),L={class:"card-grid"},N=t("p",{class:"text-h4 text--primary"},"Tasks & Jobs",-1),S=t("p",null,[a(" A "),t("b",null,"task"),a(" represents a single unit of activity in a workflow. ")],-1),W=t("p",null,[a(" A "),t("b",null,"job"),a(" performs the activity of a task, by means of a "),t("b",null,"job script"),a(" submitted to a "),t("b",null,"job runner"),a(". ")],-1),$=t("p",null," One task can have multiple jobs, by automatic retry or manual triggering. ",-1),q={id:"task-job-state-table"},B=t("tr",null,[t("td",null,"Task"),t("td"),t("td",null,"Job")],-1),D={style:{"font-size":"2em"}},Q={style:{"font-size":"2em"}},U=t("p",null,[a(" A "),t("b",null,"waiting task"),a(" with "),t("b",null,"failed jobs"),a(" will "),t("b",null,"retry"),a(" after a delay. ")],-1),E=t("p",null,[a(" A "),t("b",null,"task"),a(" can only fail if it runs out of retries. ")],-1),F=t("p",{class:"text-h4 text--primary"},"Why Are We Waiting?",-1),G=t("p",null," Why has my task not started to run yet? ",-1),H=t("b",null,"dependencies",-1),J=t("b",null,"xtriggers",-1),O=t("b",null,"released",-1),R=t("p",null,[t("em",null,"Note: tasks downstream of queued (or runahead limited) tasks are not themselves shown as queued (or runahead limited) because they are not otherwise ready to run yet.")],-1),K=t("p",null,[t("em",null,"Note: external triggers (e.g. clock triggers) are not yet exposed in the UI.")],-1);function M(p,P,X,Y,Z,tt){const l=c("task"),b=c("job");return u(),x(V,{fluid:""},{default:s(()=>[I,t("div",L,[e(f,null,{default:s(()=>[e(_,{variant:"outlined",class:"pa-1"},{default:s(()=>[e(h,{"primary-title":""},{default:s(()=>[N]),_:1}),e(d,null,{default:s(()=>[S,W,$]),_:1}),t("table",q,[B,(u(!0),m(z,null,v(p.states,n=>(u(),m("tr",{key:n.name.name},[t("td",D,[e(l,{task:{state:n.name,task:{meanElapsedTime:30}},startTime:String(Date.now())},null,8,["task","startTime"])]),t("td",null,[t("span",null,j(n.name),1)]),t("td",Q,[e(b,{status:n.name},null,8,["status"])])]))),128))]),e(d,null,{default:s(()=>[U,E]),_:1})]),_:1})]),_:1}),e(f,null,{default:s(()=>[e(_,{variant:"outlined",class:"pa-1"},{default:s(()=>[e(h,{"primary-title":""},{default:s(()=>[F]),_:1}),e(d,null,{default:s(()=>[G,e(C,{lines:"three"},{default:s(()=>[e(i,null,{prepend:s(()=>[e(l,{style:{"font-size":"2em"},task:{state:"waiting"},class:"mr-4"})]),default:s(()=>[e(o,null,{default:s(()=>[a(" Waiting ")]),_:1}),e(r,null,{default:s(()=>[a(" The task is not ready to run yet - it is still waiting on upstream "),H,a(" or "),J,a(". ")]),_:1})]),_:1}),e(i,null,{prepend:s(()=>[e(l,{style:{"font-size":"2em"},task:{state:"waiting",isHeld:!0},class:"mr-4"})]),default:s(()=>[e(o,null,{default:s(()=>[a(" Held ")]),_:1}),e(r,null,{default:s(()=>[a(" The task won't run unless "),O,a(" from hold. Tasks can be held before they are ready to run (or after, prior to retriggering). ")]),_:1})]),_:1}),e(i,null,{prepend:s(()=>[e(l,{style:{"font-size":"2em"},task:{state:"waiting",isQueued:!0},class:"mr-4"})]),default:s(()=>[e(o,null,{default:s(()=>[a(" Queued ")]),_:1}),e(r,null,{default:s(()=>[a(" The task is ready to run but is held back by a queue, which restricts the number of active tasks. ")]),_:1})]),_:1}),e(i,null,{prepend:s(()=>[e(l,{style:{"font-size":"2em"},task:{state:"waiting",isRunahead:!0},class:"mr-4"})]),default:s(()=>[e(o,null,{default:s(()=>[a(" Runahead ")]),_:1}),e(r,null,{default:s(()=>[a(" The task is ready to run but is beyond the runahead limit, which restricts the number of active cycle points. ")]),_:1})]),_:1})]),_:1}),R,K]),_:1})]),_:1})]),_:1})])]),_:1})}const st=y(A,[["render",M]]);export{st as default};
