@zibby/cli 0.4.16 → 0.4.17

package/dist/commands/workflows/schedule.js

@@ -0,0 +1,10 @@
+var $=Object.create;var R=Object.defineProperty;var Z=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var W=Object.getPrototypeOf,z=Object.prototype.hasOwnProperty;var F=(u,f)=>()=>(f||u((f={exports:{}}).exports,f),f.exports);var j=(u,f,y,w)=>{if(f&&typeof f=="object"||typeof f=="function")for(let g of P(f))!z.call(u,g)&&g!==y&&R(u,g,{get:()=>f[g],enumerable:!(w=Z(f,g))||w.enumerable});return u};var V=(u,f,y)=>(y=u!=null?$(W(u)):{},j(f||!u||!u.__esModule?R(y,"default",{value:u,enumerable:!0}):y,u));var B=F((M,D)=>{(function(f,y){typeof M=="object"&&typeof D=="object"?D.exports=y():typeof define=="function"&&define.amd?define("cronstrue",[],y):typeof M=="object"?M.cronstrue=y():f.cronstrue=y()})(globalThis,()=>(()=>{"use strict";var u={949(g,d,m){Object.defineProperty(d,"__esModule",{value:!0}),d.CronParser=void 0;var r=m(515),b=(function(){function v(t,e,o){e===void 0&&(e=!0),o===void 0&&(o=!1),this.expression=t,this.dayOfWeekStartIndexZero=e,this.monthStartIndexZero=o}return v.prototype.parse=function(){var t,e,o=(t=this.expression)!==null&&t!==void 0?t:"";if(o==="@reboot")return e=["@reboot","","","","","",""],e;if(o.startsWith("@")){var n=this.parseSpecial(this.expression);e=this.extractParts(n)}else e=this.extractParts(this.expression);return this.normalize(e),this.validate(e),e},v.prototype.parseSpecial=function(t){var e={"@yearly":"0 0 1 1 *","@annually":"0 0 1 1 *","@monthly":"0 0 1 * *","@weekly":"0 0 * * 0","@daily":"0 0 * * *","@midnight":"0 0 * * *","@hourly":"0 * * * *","@reboot":"@reboot"},o=e[t];if(!o)throw new Error("Unknown special expression.");return o},v.prototype.extractParts=function(t){if(!this.expression)throw new Error("cron expression is empty");for(var e=t.trim().split(/[ ]+/),o=0;o<e.length;o++)if(e[o].includes(",")){var n=e[o].split(",").map(function(a){return a.trim()}).filter(function(a){return a!==""}).map(function(a){return isNaN(Number(a))?a:Number(a)}).filter(function(a){return a!==null&&a!==""});n.length===0&&n.push("*"),n.sort(function(a,s){return a!==null&&s!==null?a-s:0}),e[o]=n.map(function(a){return a!==null?a.toString():""}).join(",")}if(e.length<5)throw new Error("Expression has only ".concat(e.length," part").concat(e.length==1?"":"s",". At least 5 parts are required."));if(e.length==5)e.unshift(""),e.push("");else if(e.length==6){var i=/\d{4}$/.test(e[5])||e[4]=="?"||e[2]=="?";i?e.unshift(""):e.push("")}else if(e.length>7)throw new Error("Expression has ".concat(e.length," parts; too many!"));return e},v.prototype.normalize=function(t){var e=this;if(t[3]=t[3].replace("?","*"),t[5]=t[5].replace("?","*"),t[2]=t[2].replace("?","*"),t[0].indexOf("0/")==0&&(t[0]=t[0].replace("0/","*/")),t[1].indexOf("0/")==0&&(t[1]=t[1].replace("0/","*/")),t[2].indexOf("0/")==0&&(t[2]=t[2].replace("0/","*/")),t[3].indexOf("1/")==0&&(t[3]=t[3].replace("1/","*/")),t[4].indexOf("1/")==0&&(t[4]=t[4].replace("1/","*/")),t[6].indexOf("1/")==0&&(t[6]=t[6].replace("1/","*/")),t[5]=t[5].replace(/(^\d)|([^#/\s]\d)/g,function(l){var O=l.replace(/\D/,""),h=O;return e.dayOfWeekStartIndexZero?O=="7"&&(h="0"):h=(parseInt(O)-1).toString(),l.replace(O,h)}),t[5]=="L"&&(t[5]="6"),t[3]=="?"&&(t[3]="*"),t[3].indexOf("W")>-1&&(t[3].indexOf(",")>-1||t[3].indexOf("-")>-1))throw new Error("The 'W' character can be specified only when the day-of-month is a single day, not a range or list of days.");var o={SUN:0,MON:1,TUE:2,WED:3,THU:4,FRI:5,SAT:6};for(var n in o)t[5]=t[5].replace(new RegExp(n,"gi"),o[n].toString());t[4]=t[4].replace(/(^\d{1,2})|([^#/\s]\d{1,2})/g,function(l){var O=l.replace(/\D/,""),h=O;return e.monthStartIndexZero&&(h=(parseInt(O)+1).toString()),l.replace(O,h)});var i={JAN:1,FEB:2,MAR:3,APR:4,MAY:5,JUN:6,JUL:7,AUG:8,SEP:9,OCT:10,NOV:11,DEC:12};for(var a in i)t[4]=t[4].replace(new RegExp(a,"gi"),i[a].toString());t[0]=="0"&&(t[0]=""),!/\*|\-|\,|\//.test(t[2])&&(/\*|\//.test(t[1])||/\*|\//.test(t[0]))&&(t[2]+="-".concat(t[2]));for(var s=0;s<t.length;s++)if(t[s].indexOf(",")!=-1&&(t[s]=t[s].split(",").filter(function(l){return l!==""}).join(",")||"*"),t[s]=="*/1"&&(t[s]="*"),t[s].indexOf("/")>-1&&!/^\*|\-|\,/.test(t[s])){var c=null;switch(s){case 4:c="12";break;case 5:c="6";break;case 6:c="9999";break;default:c=null;break}if(c!==null){var p=t[s].split("/");t[s]="".concat(p[0],"-").concat(c,"/").concat(p[1])}}},v.prototype.validate=function(t){var e="0-9,\\-*/";this.validateOnlyExpectedCharactersFound(t[0],e),this.validateOnlyExpectedCharactersFound(t[1],e),this.validateOnlyExpectedCharactersFound(t[2],e),this.validateOnlyExpectedCharactersFound(t[3],"0-9,\\-*/LW"),this.validateOnlyExpectedCharactersFound(t[4],e),this.validateOnlyExpectedCharactersFound(t[5],"0-9,\\-*/L#"),this.validateOnlyExpectedCharactersFound(t[6],e),this.validateAnyRanges(t)},v.prototype.validateAnyRanges=function(t){r.default.secondRange(t[0]),r.default.minuteRange(t[1]),r.default.hourRange(t[2]),r.default.dayOfMonthRange(t[3]),r.default.monthRange(t[4],this.monthStartIndexZero),r.default.dayOfWeekRange(t[5],this.dayOfWeekStartIndexZero)},v.prototype.validateOnlyExpectedCharactersFound=function(t,e){var o=t.match(new RegExp("[^".concat(e,"]+"),"gi"));if(o&&o.length)throw new Error("Expression contains invalid values: '".concat(o.toString(),"'"))},v})();d.CronParser=b},333(g,d,m){Object.defineProperty(d,"__esModule",{value:!0}),d.ExpressionDescriptor=void 0;var r=m(823),b=m(949),v=(function(){function t(e,o){if(this.expression=e,this.options=o,this.expressionParts=new Array(5),!this.options.locale&&t.defaultLocale&&(this.options.locale=t.defaultLocale),!t.locales[this.options.locale]){var n=Object.keys(t.locales)[0];console.warn("Locale '".concat(this.options.locale,"' could not be found; falling back to '").concat(n,"'.")),this.options.locale=n}this.i18n=t.locales[this.options.locale],o.use24HourTimeFormat===void 0&&(o.use24HourTimeFormat=this.i18n.use24HourTimeFormatByDefault())}return t.toString=function(e,o){var n=o===void 0?{}:o,i=n.throwExceptionOnParseError,a=i===void 0?!0:i,s=n.verbose,c=s===void 0?!1:s,p=n.dayOfWeekStartIndexZero,l=p===void 0?!0:p,O=n.monthStartIndexZero,h=O===void 0?!1:O,S=n.use24HourTimeFormat,_=n.trimHoursLeadingZero,U=_===void 0?!1:_,X=n.locale,E=X===void 0?null:X,x=n.logicalAndDayFields,A=x===void 0?!1:x,k={throwExceptionOnParseError:a,verbose:c,dayOfWeekStartIndexZero:l,monthStartIndexZero:h,use24HourTimeFormat:S,trimHoursLeadingZero:U,locale:E,logicalAndDayFields:A};k.tzOffset&&console.warn("'tzOffset' option has been deprecated and is no longer supported.");var Y=new t(e,k);return Y.getFullDescription()},t.initialize=function(e,o){o===void 0&&(o="en"),t.specialCharacters=["/","-",",","*"],t.defaultLocale=o,e.load(t.locales)},t.prototype.getFullDescription=function(){var e,o,n="";try{var i=new b.CronParser(this.expression,this.options.dayOfWeekStartIndexZero,this.options.monthStartIndexZero);if(this.expressionParts=i.parse(),this.expressionParts[0]==="@reboot")return((o=(e=this.i18n).atReboot)===null||o===void 0?void 0:o.call(e))||"Run once, at startup";var a=this.getTimeOfDayDescription(),s=this.getDayOfMonthDescription(),c=this.getMonthDescription(),p=this.getDayOfWeekDescription(),l=this.getYearDescription();n+=a+s+p+c+l,n=this.transformVerbosity(n,!!this.options.verbose),n=n.charAt(0).toLocaleUpperCase()+n.substr(1)}catch(O){if(!this.options.throwExceptionOnParseError)n=this.i18n.anErrorOccuredWhenGeneratingTheExpressionD();else throw"".concat(O)}return n},t.prototype.getTimeOfDayDescription=function(){var e=this.expressionParts[0],o=this.expressionParts[1],n=this.expressionParts[2],i="";if(!r.StringUtilities.containsAny(o,t.specialCharacters)&&!r.StringUtilities.containsAny(n,t.specialCharacters)&&!r.StringUtilities.containsAny(e,t.specialCharacters))i+=this.i18n.atSpace()+this.formatTime(n,o,e);else if(!e&&o.indexOf("-")>-1&&!(o.indexOf(",")>-1)&&!(o.indexOf("/")>-1)&&!r.StringUtilities.containsAny(n,t.specialCharacters)){var a=o.split("-");i+=r.StringUtilities.format(this.i18n.everyMinuteBetweenX0AndX1(),this.formatTime(n,a[0],""),this.formatTime(n,a[1],""))}else if(!e&&n.indexOf(",")>-1&&n.indexOf("-")==-1&&n.indexOf("/")==-1&&!r.StringUtilities.containsAny(o,t.specialCharacters)){var s=n.split(",");i+=this.i18n.at();for(var c=0;c<s.length;c++)i+=" ",i+=this.formatTime(s[c],o,""),c<s.length-2&&(i+=","),c==s.length-2&&(i+=this.i18n.spaceAnd())}else{var p=this.getSecondsDescription(),l=this.getMinutesDescription(),O=this.getHoursDescription();if(i+=p,i&&l&&(i+=", "),i+=l,l===O)return i;i&&O&&(i+=", "),i+=O}return i},t.prototype.getSecondsDescription=function(){var e=this,o=this.getSegmentDescription(this.expressionParts[0],this.i18n.everySecond(),function(n){return n},function(n){return r.StringUtilities.format(e.i18n.everyX0Seconds(n),n)},function(n){return e.i18n.secondsX0ThroughX1PastTheMinute()},function(n){return n=="0"?"":parseInt(n)<20?e.i18n.atX0SecondsPastTheMinute(n):e.i18n.atX0SecondsPastTheMinuteGt20()||e.i18n.atX0SecondsPastTheMinute(n)});return o},t.prototype.getMinutesDescription=function(){var e=this,o=this.expressionParts[0],n=this.expressionParts[2],i=this.getSegmentDescription(this.expressionParts[1],this.i18n.everyMinute(),function(a){return a},function(a){return r.StringUtilities.format(e.i18n.everyX0Minutes(a),a)},function(a){return e.i18n.minutesX0ThroughX1PastTheHour()},function(a){var s,c;try{return a=="0"&&n.indexOf("/")==-1&&o==""?e.i18n.everyHour():a=="0"?((c=(s=e.i18n).onTheHour)===null||c===void 0?void 0:c.call(s))||e.i18n.atX0MinutesPastTheHour(a):parseInt(a)<20?e.i18n.atX0MinutesPastTheHour(a):e.i18n.atX0MinutesPastTheHourGt20()||e.i18n.atX0MinutesPastTheHour(a)}catch{return e.i18n.atX0MinutesPastTheHour(a)}});return i},t.prototype.getHoursDescription=function(){var e=this,o=this.expressionParts[2],n=0,i=[];o.split("/")[0].split(",").forEach(function(c){var p=c.split("-");p.length===2&&i.push({value:p[1],index:n+1}),n+=p.length});var a=0,s=this.getSegmentDescription(o,this.i18n.everyHour(),function(c){var p=i.find(function(O){return O.value===c&&O.index===a}),l=p&&e.expressionParts[1]!=="0";return a++,l?e.formatTime(c,"59",""):e.formatTime(c,"0","")},function(c){return r.StringUtilities.format(e.i18n.everyX0Hours(c),c)},function(c){return e.i18n.betweenX0AndX1()},function(c){return e.i18n.atX0()});return s},t.prototype.getDayOfWeekDescription=function(){var e=this,o=this.i18n.daysOfTheWeek(),n=null;return this.expressionParts[5]=="*"?n="":n=this.getSegmentDescription(this.expressionParts[5],this.i18n.commaEveryDay(),function(i,a){var s=i;i.indexOf("#")>-1?s=i.substring(0,i.indexOf("#")):i.indexOf("L")>-1&&(s=s.replace("L",""));var c=parseInt(s),p=e.i18n.daysOfTheWeekInCase?e.i18n.daysOfTheWeekInCase(a)[c]:o[c];if(i.indexOf("#")>-1){var l=null,O=i.substring(i.indexOf("#")+1),h=i.substring(0,i.indexOf("#"));switch(O){case"1":l=e.i18n.first(h);break;case"2":l=e.i18n.second(h);break;case"3":l=e.i18n.third(h);break;case"4":l=e.i18n.fourth(h);break;case"5":l=e.i18n.fifth(h);break}p=l+" "+p}return p},function(i){return parseInt(i)==1?"":r.StringUtilities.format(e.i18n.commaEveryX0DaysOfTheWeek(i),i)},function(i){var a=i.substring(0,i.indexOf("-")),s=e.expressionParts[3]!="*";return s?e.i18n.commaAndX0ThroughX1(a):e.i18n.commaX0ThroughX1(a)},function(i){var a=null;if(i.indexOf("#")>-1){var s=i.substring(i.indexOf("#")+1),c=i.substring(0,i.indexOf("#"));a=e.i18n.commaOnThe(s,c).trim()+e.i18n.spaceX0OfTheMonth()}else if(i.indexOf("L")>-1)a=e.i18n.commaOnTheLastX0OfTheMonth(i.replace("L",""));else{var p=e.expressionParts[3]!="*";p?e.options.logicalAndDayFields?a=e.i18n.commaOnlyOnX0(i):a=e.i18n.commaAndOnX0():a=e.i18n.commaOnlyOnX0(i)}return a}),n},t.prototype.getMonthDescription=function(){var e=this,o=this.i18n.monthsOfTheYear(),n=this.getSegmentDescription(this.expressionParts[4],"",function(i,a){return a&&e.i18n.monthsOfTheYearInCase?e.i18n.monthsOfTheYearInCase(a)[parseInt(i)-1]:o[parseInt(i)-1]},function(i){return parseInt(i)==1?"":r.StringUtilities.format(e.i18n.commaEveryX0Months(i),i)},function(i){return e.i18n.commaMonthX0ThroughMonthX1()||e.i18n.commaX0ThroughX1()},function(i){return e.i18n.commaOnlyInMonthX0?e.i18n.commaOnlyInMonthX0():e.i18n.commaOnlyInX0()});return n},t.prototype.getDayOfMonthDescription=function(){var e=this,o=null,n=this.expressionParts[3];switch(n){case"L":o=this.i18n.commaOnTheLastDayOfTheMonth();break;case"WL":case"LW":o=this.i18n.commaOnTheLastWeekdayOfTheMonth();break;default:var i=n.match(/(\d{1,2}W)|(W\d{1,2})/);if(i){var a=parseInt(i[0].replace("W","")),s=a==1?this.i18n.firstWeekday():r.StringUtilities.format(this.i18n.weekdayNearestDayX0(),a.toString());o=r.StringUtilities.format(this.i18n.commaOnTheX0OfTheMonth(),s);break}else{var c=n.match(/L-(\d{1,2})/);if(c){var p=c[1];o=r.StringUtilities.format(this.i18n.commaDaysBeforeTheLastDayOfTheMonth(p),p);break}else{if(n=="*"&&this.expressionParts[5]!="*")return"";o=this.getSegmentDescription(n,this.i18n.commaEveryDay(),function(l){return l=="L"?e.i18n.lastDay():e.i18n.dayX0?r.StringUtilities.format(e.i18n.dayX0(),l):l},function(l){return l=="1"?e.i18n.commaEveryDay():e.i18n.commaEveryX0Days(l)},function(l){return e.i18n.commaBetweenDayX0AndX1OfTheMonth(l)},function(l){return e.i18n.commaOnDayX0OfTheMonth(l)})}break}}return o},t.prototype.getYearDescription=function(){var e=this,o=this.getSegmentDescription(this.expressionParts[6],"",function(n){return/^\d+$/.test(n)?new Date(parseInt(n),1).getFullYear().toString():n},function(n){return r.StringUtilities.format(e.i18n.commaEveryX0Years(n),n)},function(n){return e.i18n.commaYearX0ThroughYearX1()||e.i18n.commaX0ThroughX1()},function(n){return e.i18n.commaOnlyInYearX0?e.i18n.commaOnlyInYearX0():e.i18n.commaOnlyInX0()});return o},t.prototype.getSegmentDescription=function(e,o,n,i,a,s){var c=null,p=e.indexOf("/")>-1,l=e.indexOf("-")>-1,O=e.indexOf(",")>-1;if(!e)c="";else if(e==="*")c=o;else if(!p&&!l&&!O)c=r.StringUtilities.format(s(e),n(e));else if(O){for(var h=e.split(","),S="",_=0;_<h.length;_++)if(_>0&&h.length>2&&(S+=",",_<h.length-1&&(S+=" ")),_>0&&h.length>1&&(_==h.length-1||h.length==2)&&(S+="".concat(this.i18n.spaceAnd()," ")),h[_].indexOf("/")>-1||h[_].indexOf("-")>-1){var U=h[_].indexOf("-")>-1&&h[_].indexOf("/")==-1,X=this.getSegmentDescription(h[_],o,n,i,U?this.i18n.commaX0ThroughX1:a,s);U&&(X=X.replace(", ","")),S+=X}else if(!p)S+=n(h[_]);else{var E=this.getSegmentDescription(h[_],o,n,i,a,s);E&&E.startsWith(", ")&&(E=E.substring(2)),S+=E}p?c=S:c=r.StringUtilities.format(s(e),S)}else if(p){var h=e.split("/");if(c=r.StringUtilities.format(i(h[1]),h[1]),h[0].indexOf("-")>-1){var x=this.generateRangeSegmentDescription(h[0],a,n);x.indexOf(", ")!=0&&(c+=", "),c+=x}else if(h[0].indexOf("*")==-1){var A=r.StringUtilities.format(s(h[0]),n(h[0]));A=A.replace(", ",""),c+=r.StringUtilities.format(this.i18n.commaStartingX0(),A)}}else l&&(c=this.generateRangeSegmentDescription(e,a,n));return c},t.prototype.generateRangeSegmentDescription=function(e,o,n){var i="",a=e.split("-"),s=n(a[0],1),c=n(a[1],2),p=o(e);return i+=r.StringUtilities.format(p,s,c),i},t.prototype.formatTime=function(e,o,n){var i=0,a=0,s=parseInt(e)+i,c=parseInt(o)+a;c>=60?(c-=60,s+=1):c<0&&(c+=60,s-=1),s>=24?s=s-24:s<0&&(s=24+s);var p="",l=!1;this.options.use24HourTimeFormat||(l=!!(this.i18n.setPeriodBeforeTime&&this.i18n.setPeriodBeforeTime()),p=l?"".concat(this.getPeriod(s)," "):" ".concat(this.getPeriod(s)),s>12&&(s-=12),s===0&&(s=12));var O="";n&&(O=":".concat(("00"+n).substring(n.length)));var h=s.toString(),S=("00"+h).substring(h.length),_=c.toString(),U=("00"+_).substring(_.length),X=this.options.trimHoursLeadingZero?h:S;return"".concat(l?p:"").concat(X,":").concat(U).concat(O).concat(l?"":p)},t.prototype.transformVerbosity=function(e,o){if(!o&&(e=e.replace(new RegExp(", ".concat(this.i18n.everyMinute()),"g"),""),e=e.replace(new RegExp(", ".concat(this.i18n.everyHour()),"g"),""),e=e.replace(new RegExp(this.i18n.commaEveryDay(),"g"),""),e=e.replace(/\, ?$/,""),this.i18n.conciseVerbosityReplacements))for(var n=0,i=Object.entries(this.i18n.conciseVerbosityReplacements());n<i.length;n++){var a=i[n],s=a[0],c=a[1];e=e.replace(new RegExp(s,"g"),c)}return e},t.prototype.getPeriod=function(e){return e>=12?this.i18n.pm&&this.i18n.pm()||"PM":this.i18n.am&&this.i18n.am()||"AM"},t.locales={},t})();d.ExpressionDescriptor=v},747(g,d,m){Object.defineProperty(d,"__esModule",{value:!0}),d.enLocaleLoader=void 0;var r=m(486),b=(function(){function v(){}return v.prototype.load=function(t){t.en=new r.en},v})();d.enLocaleLoader=b},486(g,d){Object.defineProperty(d,"__esModule",{value:!0}),d.en=void 0;var m=(function(){function r(){}return r.prototype.atX0SecondsPastTheMinuteGt20=function(){return null},r.prototype.atX0MinutesPastTheHourGt20=function(){return null},r.prototype.commaMonthX0ThroughMonthX1=function(){return null},r.prototype.commaYearX0ThroughYearX1=function(){return null},r.prototype.use24HourTimeFormatByDefault=function(){return!1},r.prototype.anErrorOccuredWhenGeneratingTheExpressionD=function(){return"An error occurred when generating the expression description. Check the cron expression syntax."},r.prototype.everyMinute=function(){return"every minute"},r.prototype.everyHour=function(){return"every hour"},r.prototype.atSpace=function(){return"At "},r.prototype.everyMinuteBetweenX0AndX1=function(){return"Every minute between %s and %s"},r.prototype.at=function(){return"At"},r.prototype.spaceAnd=function(){return" and"},r.prototype.everySecond=function(){return"every second"},r.prototype.everyX0Seconds=function(){return"every %s seconds"},r.prototype.secondsX0ThroughX1PastTheMinute=function(){return"seconds %s through %s past the minute"},r.prototype.atX0SecondsPastTheMinute=function(){return"at %s seconds past the minute"},r.prototype.everyX0Minutes=function(){return"every %s minutes"},r.prototype.minutesX0ThroughX1PastTheHour=function(){return"minutes %s through %s past the hour"},r.prototype.atX0MinutesPastTheHour=function(){return"at %s minutes past the hour"},r.prototype.everyX0Hours=function(){return"every %s hours"},r.prototype.betweenX0AndX1=function(){return"between %s and %s"},r.prototype.atX0=function(){return"at %s"},r.prototype.commaEveryDay=function(){return", every day"},r.prototype.commaEveryX0DaysOfTheWeek=function(){return", every %s days of the week"},r.prototype.commaX0ThroughX1=function(){return", %s through %s"},r.prototype.commaAndX0ThroughX1=function(){return", %s through %s"},r.prototype.first=function(){return"first"},r.prototype.second=function(){return"second"},r.prototype.third=function(){return"third"},r.prototype.fourth=function(){return"fourth"},r.prototype.fifth=function(){return"fifth"},r.prototype.commaOnThe=function(){return", on the "},r.prototype.spaceX0OfTheMonth=function(){return" %s of the month"},r.prototype.lastDay=function(){return"the last day"},r.prototype.commaOnTheLastX0OfTheMonth=function(){return", on the last %s of the month"},r.prototype.commaOnlyOnX0=function(){return", only on %s"},r.prototype.commaAndOnX0=function(){return", and on %s"},r.prototype.commaEveryX0Months=function(){return", every %s months"},r.prototype.commaOnlyInX0=function(){return", only in %s"},r.prototype.commaOnTheLastDayOfTheMonth=function(){return", on the last day of the month"},r.prototype.commaOnTheLastWeekdayOfTheMonth=function(){return", on the last weekday of the month"},r.prototype.commaDaysBeforeTheLastDayOfTheMonth=function(){return", %s days before the last day of the month"},r.prototype.firstWeekday=function(){return"first weekday"},r.prototype.weekdayNearestDayX0=function(){return"weekday nearest day %s"},r.prototype.commaOnTheX0OfTheMonth=function(){return", on the %s of the month"},r.prototype.commaEveryX0Days=function(){return", every %s days in a month"},r.prototype.commaBetweenDayX0AndX1OfTheMonth=function(){return", between day %s and %s of the month"},r.prototype.commaOnDayX0OfTheMonth=function(){return", on day %s of the month"},r.prototype.commaEveryHour=function(){return", every hour"},r.prototype.commaEveryX0Years=function(){return", every %s years"},r.prototype.commaStartingX0=function(){return", starting %s"},r.prototype.daysOfTheWeek=function(){return["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"]},r.prototype.monthsOfTheYear=function(){return["January","February","March","April","May","June","July","August","September","October","November","December"]},r.prototype.atReboot=function(){return"Run once, at startup"},r.prototype.onTheHour=function(){return"on the hour"},r})();d.en=m},515(g,d){Object.defineProperty(d,"__esModule",{value:!0});function m(b,v){if(!b)throw new Error(v)}var r=(function(){function b(){}return b.secondRange=function(v){for(var t=v.split(","),e=0;e<t.length;e++)if(!isNaN(parseInt(t[e],10))){var o=parseInt(t[e],10);m(o>=0&&o<=59,"seconds part must be >= 0 and <= 59")}},b.minuteRange=function(v){for(var t=v.split(","),e=0;e<t.length;e++)if(!isNaN(parseInt(t[e],10))){var o=parseInt(t[e],10);m(o>=0&&o<=59,"minutes part must be >= 0 and <= 59")}},b.hourRange=function(v){for(var t=v.split(","),e=0;e<t.length;e++)if(!isNaN(parseInt(t[e],10))){var o=parseInt(t[e],10);m(o>=0&&o<=23,"hours part must be >= 0 and <= 23")}},b.dayOfMonthRange=function(v){for(var t=v.split(","),e=0;e<t.length;e++)if(!isNaN(parseInt(t[e],10))){var o=parseInt(t[e],10);m(o>=1&&o<=31,"DOM part must be >= 1 and <= 31")}},b.monthRange=function(v,t){for(var e=v.split(","),o=0;o<e.length;o++)if(!isNaN(parseInt(e[o],10))){var n=parseInt(e[o],10);m(n>=1&&n<=12,t?"month part must be >= 0 and <= 11":"month part must be >= 1 and <= 12")}},b.dayOfWeekRange=function(v,t){for(var e=v.split(","),o=0;o<e.length;o++)if(!isNaN(parseInt(e[o],10))){var n=parseInt(e[o],10);m(n>=0&&n<=6,t?"DOW part must be >= 0 and <= 6":"DOW part must be >= 1 and <= 7")}},b})();d.default=r},823(g,d){Object.defineProperty(d,"__esModule",{value:!0}),d.StringUtilities=void 0;var m=(function(){function r(){}return r.format=function(b){for(var v=[],t=1;t<arguments.length;t++)v[t-1]=arguments[t];return b.replace(/%s/g,function(e){for(var o=[],n=1;n<arguments.length;n++)o[n-1]=arguments[n];return v.shift()})},r.containsAny=function(b,v){return v.some(function(t){return b.indexOf(t)>-1})},r})();d.StringUtilities=m}},f={};function y(g){var d=f[g];if(d!==void 0)return d.exports;var m=f[g]={exports:{}};return u[g](m,m.exports,y),m.exports}var w={};return(()=>{var g=w;Object.defineProperty(g,"__esModule",{value:!0}),g.toString=void 0;var d=y(333),m=y(747);d.ExpressionDescriptor.initialize(new m.enLocaleLoader),g.default=d.ExpressionDescriptor;var r=d.ExpressionDescriptor.toString;g.toString=r})(),w})())});var H=V(B(),1);import T from"chalk";import{readFileSync as J,existsSync as G}from"fs";import{homedir as K}from"os";import{join as q}from"path";var I={local:{name:"Local Development",apiUrl:"http://localhost:3001",accountApiUrl:"http://localhost:3001",frontendUrl:"http://localhost:3000",description:"Local backend running on port 3001"},prod:{name:"Production",apiUrl:process.env.ZIBBY_PROD_API_URL||"https://api-prod.zibby.app",accountApiUrl:process.env.ZIBBY_PROD_ACCOUNT_API_URL||"https://account-api-prod.zibby.app",frontendUrl:process.env.ZIBBY_PROD_FRONTEND_URL||"https://studio.zibby.dev",description:"Production environment"}};function N(){let u;if(process.env.ZIBBY_API_URL)u=process.env.ZIBBY_API_URL;else{let f=process.env.ZIBBY_ENV||"prod";I[f]?u=I[f].apiUrl:u=I.prod.apiUrl}try{let f=new URL(u);return f.protocol!=="http:"&&f.protocol!=="https:"?(console.error(`\u26A0\uFE0F  Invalid API URL protocol: ${f.protocol} (only http/https allowed)`),I.prod.apiUrl):u}catch{return console.error(`\u26A0\uFE0F  Invalid API URL: ${u}`),I.prod.apiUrl}}function Q(u){if(!u)return null;try{return H.default.toString(u,{use24HourTimeFormat:!1,verbose:!1})}catch{return null}}function ee(u){if(u)return u;let f=q(K(),".zibby","config.json");if(G(f))try{let y=JSON.parse(J(f,"utf-8"));if(y.sessionToken)return y.sessionToken}catch{}if(process.env.ZIBBY_API_KEY)return process.env.ZIBBY_API_KEY;console.error(T.red(`
+  Not authenticated`)),console.error(T.gray("  Run: zibby login")),console.error(T.gray(`  OR set ZIBBY_API_KEY env var
+`)),process.exit(1)}function te(u=[]){let f={};for(let y of u){let w=y.indexOf("=");if(w<=0)throw new Error(`-p expects key=value, got: ${y}`);f[y.slice(0,w)]=y.slice(w+1)}return f}async function L(u,f,y,w){let g=await fetch(f,{method:u,headers:{"Content-Type":"application/json",Authorization:`Bearer ${y}`},...w!==void 0?{body:JSON.stringify(w)}:{}}),d=await g.text(),m=null;try{m=d?JSON.parse(d):null}catch{}if(!g.ok){let r=m?.error||d||`HTTP ${g.status}`;throw new Error(`API ${u} ${g.status}: ${r}`)}return m}function C(u){if(!u)return T.gray("  (no schedule)");let f=Q(u.cron),y=[`  ${T.bold("Cron:")}     ${T.cyan(u.cron)}${f?T.gray(`  (${f})`):""}`,`  ${T.bold("Timezone:")} ${u.timezone||"UTC"}`];return u.input&&Object.keys(u.input).length&&y.push(`  ${T.bold("Input:")}    ${JSON.stringify(u.input)}`),u.createdAt&&y.push(`  ${T.bold("Created:")}  ${new Date(u.createdAt).toLocaleString()}`),u.updatedAt&&u.updatedAt!==u.createdAt&&y.push(`  ${T.bold("Updated:")}  ${new Date(u.updatedAt).toLocaleString()}`),y.join(`
+`)}async function ue(u,f,y,w={}){u||(console.error(T.red("Workflow UUID required.")),console.error(T.gray("Usage: zibby workflow schedule <uuid> [get|set <cron>|clear]")),process.exit(1));let g=ee(w.apiKey),d=N(),m=`${String(d).replace(/\/+$/,"")}/workflows/${encodeURIComponent(u)}/schedule`,r=(f||"get").toLowerCase();try{if(r==="get"){let b=await L("GET",m,g);console.log(T.bold(`
+Schedule for ${u}:`)),console.log(C(b?.schedule)),console.log("");return}if(r==="set"){y||(console.error(T.red("Missing cron expression.")),console.error(T.gray('Usage: zibby workflow schedule <uuid> set "0 9 * * 1-5"')),process.exit(1));let b={cron:y};w.tz&&(b.timezone=w.tz);let v=te(w.param||[]);Object.keys(v).length&&(b.input=v);let t=await L("POST",m,g,b);console.log(T.green(`
+\u2714 Schedule set for ${u}`)),console.log(C(t?.schedule)),console.log(T.gray("\n  EventBridge will fire on this cron. Watch with `zibby workflow logs -t`.")),console.log("");return}if(r==="clear"||r==="delete"||r==="remove"){await L("DELETE",m,g),console.log(T.green(`
+\u2714 Schedule cleared for ${u}
+`));return}console.error(T.red(`Unknown action: "${f}"`)),console.error(T.gray("Valid actions: get | set <cron> | clear")),process.exit(1)}catch(b){console.error(T.red(`
+\u2717 ${b.message}
+`)),process.exit(1)}}export{ue as scheduleCommand};

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/cli",
-  "version": "0.4.16",
+  "version": "0.4.17",
   "description": "Zibby CLI - Test automation generator and runner",
   "type": "module",
   "bin": {
@@ -35,12 +35,13 @@
     "@aws-sdk/client-sqs": "^3.1038.0",
     "@zibby/agent-workflow": "^0.3.2",
     "@zibby/core": "^0.3.6",
-    "@zibby/ui-memory": "^1.0.0",
     "@zibby/skills": "^0.1.11",
+    "@zibby/ui-memory": "^1.0.0",
     "adm-zip": "^0.5.17",
     "chalk": "^5.3.0",
     "cli-highlight": "^2.1.11",
     "commander": "^12.0.0",
+    "cronstrue": "^3.14.0",
     "dotenv": "^17.4.1",
     "express": "^4.18.2",
     "glob": "^13.0.0",
@@ -54,6 +55,7 @@
   },
   "files": [
     "dist/",
+    "templates/",
     "README.md",
     "LICENSE"
   ],

package/dist/templates/.claude/CLAUDE.md

@@ -0,0 +1,425 @@
+# Zibby project — how to write and ship workflows
+
+This file is auto-loaded by Claude Code / Cursor / Codex when working in
+this repo. It's the canonical reference for building Zibby workflows.
+
+You are an AI agent. The user describes what they want; you write the
+workflow code (graph + nodes + skills), test it locally, and deploy. The
+user shouldn't need to read the code you produce — they just describe
+the intent.
+
+---
+
+## 0. The 30-second tour
+
+```
+.zibby/workflows/<name>/
+├── workflow.json     # name, description, version, default agent
+├── graph.mjs         # graph topology (nodes + edges)
+├── nodes/            # one file per node — prompt + outputSchema + skills
+│   ├── plan.mjs
+│   ├── implement.mjs
+│   └── verify.mjs
+└── package.json      # @zibby/agent-workflow + zod, nothing else needed
+```
+
+Lifecycle:
+
+```bash
+zibby workflow new <name>            # scaffold (creates .zibby/workflows/<name>/)
+zibby workflow run <name> -p key=val # run locally — one-shot, no server
+zibby workflow start <name>          # run locally with hot-reload (server)
+zibby workflow validate <name>       # static check (graph topology, schemas, skills)
+zibby workflow deploy <name>         # push to Zibby Cloud, returns UUID
+zibby workflow trigger <uuid> -p ... # remote run
+zibby workflow schedule <uuid> set …  # recurring cron run (Unix 5-field)
+zibby workflow logs -t               # tail cloud logs
+```
+
+**Always `zibby workflow run` before `deploy`.** Local run is ~5s cold
+start; cloud is ~60s. Iterating in cloud is 12× slower.
+
+---
+
+## 1. Anatomy of a workflow
+
+### `workflow.json`
+
+```json
+{
+  "name": "code-review",
+  "description": "Review a git diff and return structured findings",
+  "version": "0.1.0",
+  "defaultAgent": "claude",
+  "stateSchema": {
+    "diff": "string",
+    "findings": "array"
+  }
+}
+```
+
+`defaultAgent` is one of: `claude`, `cursor`, `codex`, `gemini`. Any node
+can override with `agent: 'cursor'` in its config.
+
+### `graph.mjs`
+
+```js
+import { WorkflowGraph } from '@zibby/agent-workflow';
+import { z } from 'zod';
+import { planNode } from './nodes/plan.mjs';
+import { implementNode } from './nodes/implement.mjs';
+import { verifyNode } from './nodes/verify.mjs';
+
+export default function buildGraph() {
+  const graph = new WorkflowGraph();
+
+  graph.addNode('plan',      planNode);
+  graph.addNode('implement', implementNode);
+  graph.addNode('verify',    verifyNode);
+
+  graph.addEdge('plan', 'implement');
+  graph.addEdge('implement', 'verify');
+  graph.addEdge('verify', 'END');         // 'END' is the terminal sentinel
+
+  graph.setEntryPoint('plan');
+
+  return graph;
+}
+```
+
+### A node — `nodes/plan.mjs`
+
+```js
+import { z } from 'zod';
+
+export const planNode = {
+  name: 'plan',
+  agent: 'claude',                        // optional — falls back to defaultAgent
+  outputSchema: z.object({
+    steps: z.array(z.string()),
+    risks: z.array(z.string()),
+  }),
+  prompt: (state) => `
+You are planning a code change. The user wants:
+${state.userRequest}
+
+Return:
+- steps: ordered list of actions to take
+- risks: anything that might go wrong
+`,
+};
+```
+
+Three required fields on every LLM node: `name`, `outputSchema` (a Zod
+schema), `prompt` (string or function of state).
+
+### A custom-code node (no LLM)
+
+```js
+export const fetchDiffNode = {
+  name: 'fetch_diff',
+  outputSchema: z.object({ diff: z.string(), filesChanged: z.array(z.string()) }),
+  execute: async (context) => {
+    const { execSync } = await import('node:child_process');
+    const diff = execSync('git diff --staged', { encoding: 'utf-8' });
+    const filesChanged = execSync('git diff --staged --name-only', { encoding: 'utf-8' })
+      .trim().split('\n').filter(Boolean);
+    return { diff, filesChanged };
+  },
+};
+```
+
+Custom-code nodes use `execute(context)` instead of `prompt`. They skip
+the LLM entirely. Use them for deterministic work: git ops, file IO,
+HTTP calls, parsing.
+
+---
+
+## 2. State — read and write
+
+```js
+// READ — state is passed to prompt fns + execute fns as the first arg
+prompt: (state) => `Plan a change for: ${state.userRequest}`
+
+execute: async (state) => {
+  const diff = state.diff;                // read prior node output here
+  // ...
+}
+```
+
+**Each node's output is stored at `state[nodeName]`.** If `plan` returns
+`{ steps: [...], risks: [...] }`, the next node reads them as
+`state.plan.steps` and `state.plan.risks`.
+
+Initial input goes at the TOP of state (not nested under `input`). When
+the user runs `zibby workflow run code-review -p userRequest="fix login"`,
+the first node sees `state.userRequest = "fix login"`.
+
+**Don't use `state.set()` / `state.get()` inside `execute()`** — those
+are internal to the graph runtime. Just `return` a plain object that
+matches your `outputSchema`. The runtime puts it under `state[nodeName]`.
+
+---
+
+## 3. Conditional routing
+
+```js
+graph.addConditionalEdges('verify', (state) => {
+  if (state.verify.passed) return 'END';
+  if (state.verify.retries < 3) return 'implement';
+  return 'fail';
+});
+```
+
+The router function receives the full state, returns the name of the
+next node (or `'END'`). All possible target nodes must also be declared
+elsewhere via `addNode`.
+
+---
+
+## 4. Skills — pluggable MCP tool bundles
+
+A **skill** is a named bundle of MCP tools a node can opt into. Built-in
+skills: `browser`, `memory`. Custom skills: register them yourself.
+
+### Using a skill in a node
+
+```js
+export const navigateNode = {
+  name: 'navigate',
+  skills: ['browser'],                    // ← opt in
+  outputSchema: z.object({ url: z.string(), title: z.string() }),
+  prompt: (state) => `Navigate to ${state.target} and report the title.`,
+};
+```
+
+The agent (claude/cursor/codex/gemini) auto-discovers the skill's tools.
+`browser` exposes `mcp__playwright__browser_navigate`, `_snapshot`,
+`_click`, etc. The agent's `allowedTools` is set automatically — you
+don't list each tool.
+
+### Writing a custom skill
+
+```js
+// .zibby/workflows/<name>/skills/slack.mjs
+import { registerSkill } from '@zibby/agent-workflow';
+
+registerSkill({
+  id: 'slack',                            // referenced by `skills: ['slack']`
+  serverName: 'slack-mcp',
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-slack'],
+  allowedTools: ['mcp__slack__*'],
+  envKeys: ['SLACK_BOT_TOKEN'],           // required env to run
+  description: 'Read channels, post messages, search history',
+});
+```
+
+Then import it from your `graph.mjs` BEFORE building the graph:
+
+```js
+import './skills/slack.mjs';              // side-effect: registers the skill
+import { WorkflowGraph } from '@zibby/agent-workflow';
+// ...
+```
+
+Skills register on `globalThis` so any node that runs in this process
+can use them. In cloud, set required `envKeys` via
+`zibby workflow env set slack ZIBBY_SECRET SLACK_BOT_TOKEN=xoxb-...`.
+
+### Custom skill via a non-MCP function
+
+If you don't have an MCP server, expose a Node function directly:
+
+```js
+registerSkill({
+  id: 'jira-fetch',
+  resolve: () => null,                    // no MCP — use middleware instead
+  middleware: async () => async (nodeName, next, state) => {
+    // attach a JS-only helper. Less common — prefer MCP when possible.
+    state.jiraFetch = async (issueId) => { /* ... */ };
+    return next();
+  },
+});
+```
+
+---
+
+## 5. Agent strategies — claude / cursor / codex / gemini
+
+The same node can run under any agent — they all read `prompt`, return
+the same shaped `outputSchema`. Differences:
+
+| Agent  | Best for                          | Auth env                          |
+|--------|-----------------------------------|-----------------------------------|
+| claude | Reasoning, planning, structured output | `ANTHROPIC_API_KEY` or `CLAUDE_CODE_OAUTH_TOKEN` |
+| cursor | Code editing in a repo            | `CURSOR_API_KEY`                 |
+| codex  | Direct shell + code generation    | `OPENAI_API_KEY`                 |
+| gemini | Cheap volume tasks                | `GEMINI_API_KEY`                 |
+
+Pick per-node (override `defaultAgent`):
+
+```js
+graph.addNode('plan',      { ...planNode,      agent: 'claude' });
+graph.addNode('implement', { ...implementNode, agent: 'cursor' });
+graph.addNode('verify',    { ...verifyNode,    agent: 'codex'  });
+```
+
+Model overrides go in `.zibby.config.mjs`:
+
+```js
+export default {
+  models: {
+    plan:      'claude-opus-4-7',
+    implement: 'cursor-fast',
+    verify:    'gpt-5-codex',
+  },
+};
+```
+
+---
+
+## 6. Running and shipping
+
+### Local dry-run (FAST — do this every iteration)
+
+```bash
+zibby workflow run code-review -p userRequest="add rate limiting to /api"
+```
+
+One-shot run. ~5s cold, then ~2s per warm iteration when the agent has
+cached prompts. Reads + writes to your local filesystem (no cloud
+upload).
+
+### Static validate (FASTER — does NOT run any agent)
+
+```bash
+zibby workflow validate code-review
+```
+
+Checks: graph topology (no orphan nodes, entry point exists, edges
+reach END), node shapes (every node has `outputSchema`), skill
+references (every `skills: ['x']` is registered), schema validity. If
+this fails, `run` will definitely fail too — fix it first.
+
+### Deploy
+
+```bash
+zibby workflow deploy code-review
+#  → returns UUID, caches in .zibby-deploy.json
+```
+
+Bundles the workflow folder, uploads to Zibby Cloud. Cloud runs on
+Fargate, picks up per-node API keys you set via `zibby workflow env`.
+
+### Trigger remote run
+
+```bash
+zibby workflow trigger <uuid> -p userRequest="fix login bug" -t
+```
+
+`-t` tails logs in Heroku style. Cmd-C stops the tail (workflow keeps
+running in cloud).
+
+### Schedule recurring runs (cron)
+
+```bash
+# Set / update a schedule (standard Unix 5-field cron)
+zibby workflow schedule <uuid> set "0 9 * * 1-5"                          # 9am weekdays UTC
+zibby workflow schedule <uuid> set "*/15 * * * *"                         # every 15 min
+zibby workflow schedule <uuid> set "0 9 * * *" --tz America/Los_Angeles   # 9am LA time
+zibby workflow schedule <uuid> set "0 0 * * *" -p kind=nightly            # fixed input params
+
+# Inspect / clear
+zibby workflow schedule <uuid>                                            # show current
+zibby workflow schedule <uuid> clear                                      # remove
+```
+
+Backed by EventBridge Scheduler. Each scheduled fire goes through the
+same `runWorkflow` path as manual + webhook triggers — same Fargate
+container, same memory sync, same logs.
+
+Cron format is **standard Unix 5-field** (`minute hour day-of-month
+month day-of-week`). Use `crontab.guru` to debug expressions. The
+backend converts to EventBridge's 6-field form internally; you never
+see AWS's flavor.
+
+**Minimum interval is 5 minutes.** `* * * * *`, `*/2 * * * *`, etc.
+are rejected with 400. Use `*/5 * * * *` (every 5 min) or slower —
+this matches GitHub Actions cron's rule. Each fire = a full Fargate
+run = compute + LLM tokens + workflow-execution quota burn, so
+sub-5-min runs aren't economical at our pricing. If you genuinely
+need sub-minute reactivity, use the **webhook trigger** instead.
+
+A workflow has at most ONE schedule. `set` is upsert (create if absent,
+update if present). When the workflow is deleted, the schedule is
+cleaned up too.
+
+---
+
+## 7. Common pitfalls — read before debugging
+
+| Symptom                                          | Fix                                            |
+|--------------------------------------------------|------------------------------------------------|
+| `Node 'X' must define outputSchema`              | Add `outputSchema: z.object({...})` to the node config |
+| `Skill 'foo' not registered`                     | Import the skill file in graph.mjs BEFORE `new WorkflowGraph()` |
+| `state.previousNode is undefined` in a prompt    | Wrong order — add `graph.addEdge('previousNode', 'thisNode')` |
+| Custom-code node returns nothing                 | `return` an object matching `outputSchema`. `undefined` = failure |
+| Agent ignores your skill's tools                 | Add `skills: ['name']` to the node config, not just register |
+| Zod error: "Expected string, received undefined" | The previous node's outputSchema doesn't match its return — fix the producer, not the consumer |
+| `workflow trigger` works but `run` doesn't       | Local run reads env from `.env` / shell; cloud reads from `zibby workflow env`. Set both. |
+| Hangs forever on a node                          | Add `retries: 0` to fail fast while debugging; check the prompt isn't asking the agent to wait |
+
+---
+
+## 8. The agent's job (this is YOU)
+
+When the user says **"write me a workflow that does X"**:
+
+1. **Sketch the graph first.** What are the 2-5 nodes? Which can be
+   custom-code (deterministic) and which need an LLM (judgement)?
+2. **Run `zibby workflow new <name>`** to scaffold.
+3. **Edit the files** — `graph.mjs`, `nodes/*.mjs`. Use Zod for every
+   schema. Default to `claude` unless the user has a preference.
+4. **Run `zibby workflow validate <name>`.** Fix any reported issues.
+5. **Run `zibby workflow run <name> -p ...`** with a realistic input.
+   Watch the timeline output. If a node fails, read its `raw` output
+   to understand what the LLM returned vs what the schema expected.
+6. **Iterate on prompts** — the user shouldn't need to. If a node's
+   output doesn't match the schema, tighten the prompt or relax the
+   schema (in that order).
+7. **Once it works locally**, ask the user if they want to deploy.
+   Don't deploy without asking — cloud has cost.
+
+Read `.claude/commands/` for slash commands the user can invoke:
+`/new-workflow`, `/add-node`, `/add-skill`, `/validate-workflow`.
+
+---
+
+## 9. Quick reference
+
+```js
+import { WorkflowGraph, registerSkill, registerStrategy, AgentStrategy } from '@zibby/agent-workflow';
+import { z } from 'zod';
+
+// Graph
+const graph = new WorkflowGraph();
+graph.addNode(name, { prompt, outputSchema, execute, skills, agent, retries });
+graph.addEdge(from, to);
+graph.addConditionalEdges(from, (state) => 'nextNodeName');
+graph.setEntryPoint(name);
+
+// Skill
+registerSkill({ id, serverName, command, args, allowedTools, envKeys });
+
+// Strategy (rare — only when wrapping a non-built-in LLM)
+class MyAgent extends AgentStrategy { /* implement invoke() */ }
+registerStrategy(new MyAgent());
+
+// State (inside execute / prompt fns)
+//   READ:  state.someKey   or   state.previousNode.field
+//   WRITE: return { ... } from execute() — runtime puts it at state[nodeName]
+```
+
+That's the whole API. Anything else is either a convenience or a
+footgun — when in doubt, prefer the above.

package/dist/templates/.claude/commands/add-node.md

@@ -0,0 +1,63 @@
+---
+description: Add a node to an existing Zibby workflow graph
+argument-hint: <workflow-name> <node-purpose>
+---
+
+# /add-node
+
+The user wants to extend an existing workflow with a new node.
+
+**Arguments:** $ARGUMENTS
+
+## Steps
+
+1. **Find the workflow** — should be at `.zibby/workflows/<name>/`. If
+   the user didn't specify a name and there's only one workflow, use
+   that. If there are multiple, ask which.
+
+2. **Read the existing `graph.mjs`** to understand:
+   - Current node sequence
+   - State shape (what each prior node returns)
+   - Where the new node should slot in (before / after / parallel)
+
+3. **Decide LLM vs custom-code:**
+   - Custom-code (`execute`): the work is deterministic — git ops,
+     file IO, HTTP, parsing structured data, math
+   - LLM (`prompt`): the work needs judgement — summarization,
+     classification, generation, planning
+
+4. **Create the node file** at `.zibby/workflows/<name>/nodes/<node>.mjs`:
+
+   ```js
+   import { z } from 'zod';
+
+   export const myNode = {
+     name: 'my_node',
+     outputSchema: z.object({ /* what this returns to state */ }),
+     prompt: (state) => `…use state.previousNodeName.field…`,
+     // OR for custom-code:
+     // execute: async (state) => ({ /* match outputSchema */ }),
+   };
+   ```
+
+5. **Wire it into `graph.mjs`:**
+   - `import { myNode } from './nodes/my-node.mjs';`
+   - `graph.addNode('my_node', myNode);`
+   - `graph.addEdge('prev_node', 'my_node');`
+   - `graph.addEdge('my_node', 'next_node');` (or 'END')
+
+6. **Validate + run** to confirm it integrates:
+   ```bash
+   zibby workflow validate <name>
+   zibby workflow run <name> -p ...
+   ```
+
+7. **Report**: what node you added, how state changed, the test result.
+
+## Watch for
+
+- The new node's `prompt` references `state.X.field` — make sure that
+  field exists in the previous node's `outputSchema`. If it doesn't,
+  fix the producer schema, not the consumer prompt.
+- Don't change other nodes' schemas without telling the user — that's
+  a breaking change to downstream consumers.

package/dist/templates/.claude/commands/add-skill.md

@@ -0,0 +1,83 @@
+---
+description: Add a custom MCP skill to a Zibby workflow
+argument-hint: <workflow-name> <skill-purpose-or-mcp-server-name>
+---
+
+# /add-skill
+
+The user wants to add a custom skill (MCP tool bundle) to a workflow.
+
+**Arguments:** $ARGUMENTS
+
+## Steps
+
+1. **Identify the MCP server** the skill wraps:
+   - If the user named one (e.g. "slack", "linear", "filesystem"), find
+     the official MCP server. Standard ones live at
+     `@modelcontextprotocol/server-<name>`.
+   - If unsure, ask: "Which MCP server should this skill wrap, or
+     should it be a JS-only middleware?"
+
+2. **Find the workflow** at `.zibby/workflows/<name>/`. Create a
+   `skills/` subfolder if it doesn't exist.
+
+3. **Write `skills/<id>.mjs`:**
+
+   ```js
+   import { registerSkill } from '@zibby/agent-workflow';
+
+   registerSkill({
+     id: 'slack',                       // referenced by node `skills: ['slack']`
+     serverName: 'slack-mcp',
+     command: 'npx',
+     args: ['-y', '@modelcontextprotocol/server-slack'],
+     allowedTools: ['mcp__slack__*'],   // pattern of tools the agent gets access to
+     envKeys: ['SLACK_BOT_TOKEN'],
+     description: 'Read channels, post messages, search history',
+   });
+   ```
+
+4. **Import the skill file from `graph.mjs`** at the TOP, before
+   `new WorkflowGraph()`:
+
+   ```js
+   import './skills/slack.mjs';        // side-effect: registers the skill
+   import { WorkflowGraph } from '@zibby/agent-workflow';
+   // ...
+   ```
+
+5. **Opt nodes into the skill:**
+
+   ```js
+   graph.addNode('post_summary', {
+     ...postSummaryNode,
+     skills: ['slack'],                // ← agent gets slack tools here
+   });
+   ```
+
+6. **Document the env requirement.** Add to the workflow's README or
+   tell the user which env var they need to set:
+   - Locally: `export SLACK_BOT_TOKEN=xoxb-...` or put in `.env`
+   - Cloud: `zibby workflow env set <workflow> SLACK_BOT_TOKEN=...`
+
+7. **Validate + test:**
+   ```bash
+   zibby workflow validate <name>
+   zibby workflow run <name> -p ...
+   ```
+
+   The agent should now have access to `mcp__slack__*` tools in the
+   nodes that opted in.
+
+## When NOT to use a custom skill
+
+- If the work can be done with plain Node.js (HTTP call, file write,
+  git command) — use a custom-code node with `execute()` instead. MCP
+  skills are for tool surfaces the agent decides to use, not for
+  deterministic glue.
+
+## When to use `middleware` instead of MCP
+
+If you don't have an MCP server but want to attach a JS helper that
+nodes can use, see the "Custom skill via a non-MCP function" section
+of `.claude/CLAUDE.md`. This is rare — prefer MCP when one exists.