diff --git a/docs/web/dist/assets/index-CbQCMg9o.js b/docs/web/dist/assets/index-CNcHcO5J.js similarity index 95% rename from docs/web/dist/assets/index-CbQCMg9o.js rename to docs/web/dist/assets/index-CNcHcO5J.js index 971f37f..0ee3903 100644 --- a/docs/web/dist/assets/index-CbQCMg9o.js +++ b/docs/web/dist/assets/index-CNcHcO5J.js @@ -8,18 +8,18 @@ Error generating stack: `+e.message+` `+e.stack}}var Je=Object.prototype.hasOwnProperty,Ye=t.unstable_scheduleCallback,Xe=t.unstable_cancelCallback,Ze=t.unstable_shouldYield,Qe=t.unstable_requestPaint,$e=t.unstable_now,et=t.unstable_getCurrentPriorityLevel,tt=t.unstable_ImmediatePriority,nt=t.unstable_UserBlockingPriority,rt=t.unstable_NormalPriority,it=t.unstable_LowPriority,at=t.unstable_IdlePriority,ot=t.log,st=t.unstable_setDisableYieldValue,ct=null,lt=null;function ut(e){if(typeof ot==`function`&&st(e),lt&&typeof lt.setStrictMode==`function`)try{lt.setStrictMode(ct,e)}catch{}}var dt=Math.clz32?Math.clz32:mt,ft=Math.log,pt=Math.LN2;function mt(e){return e>>>=0,e===0?32:31-(ft(e)/pt|0)|0}var ht=256,gt=262144,_t=4194304;function vt(e){var t=e&42;if(t!==0)return t;switch(e&-e){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:return 64;case 128:return 128;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:return e&-e;case 262144:case 524288:case 1048576:case 2097152:return e&3932160;case 4194304:case 8388608:case 16777216:case 33554432:return e&62914560;case 67108864:return 67108864;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 0;default:return e}}function yt(e,t,n){var r=e.pendingLanes;if(r===0)return 0;var i=0,a=e.suspendedLanes,o=e.pingedLanes;e=e.warmLanes;var s=r&134217727;return s===0?(s=r&~a,s===0?o===0?n||(n=r&~e,n!==0&&(i=vt(n))):i=vt(o):i=vt(s)):(r=s&~a,r===0?(o&=s,o===0?n||(n=s&~e,n!==0&&(i=vt(n))):i=vt(o)):i=vt(r)),i===0?0:t!==0&&t!==i&&(t&a)===0&&(a=i&-i,n=t&-t,a>=n||a===32&&n&4194048)?t:i}function bt(e,t){return(e.pendingLanes&~(e.suspendedLanes&~e.pingedLanes)&t)===0}function xt(e,t){t&8&&(t|=t&32);var n=e.entangledLanes;if(n!==0)for(e=e.entanglements,n&=t;0n;n++)t.push(e);return t}function Tt(e,t){e.pendingLanes|=t,t!==268435456&&(e.suspendedLanes=0,e.pingedLanes=0,e.warmLanes=0)}function Et(e,t,n,r,i,a){var o=e.pendingLanes;e.pendingLanes=n,e.suspendedLanes=0,e.pingedLanes=0,e.warmLanes=0,e.expiredLanes&=n,e.entangledLanes&=n,e.errorRecoveryDisabledLanes&=n,e.shellSuspendCounter=0;var s=e.entanglements,c=e.expirationTimes,l=e.hiddenUpdates;for(n=o&~n;0=wr),Dr=` `,Or=!1;function kr(e,t){switch(e){case`keyup`:return Sr.indexOf(t.keyCode)!==-1;case`keydown`:return t.keyCode!==229;case`keypress`:case`mousedown`:case`focusout`:return!0;default:return!1}}function Ar(e){return e=e.detail,typeof e==`object`&&`data`in e?e.data:null}var jr=!1;function Mr(e,t){switch(e){case`compositionend`:return Ar(t);case`keypress`:return t.which===32?(Or=!0,Dr):null;case`textInput`:return e=t.data,e===Dr&&Or?null:e;default:return null}}function Nr(e,t){if(jr)return e===`compositionend`||!Cr&&kr(e,t)?(e=Gn(),Wn=Un=Hn=null,jr=!1,e):null;switch(e){case`paste`:return null;case`keypress`:if(!(t.ctrlKey||t.altKey||t.metaKey)||t.ctrlKey&&t.altKey){if(t.char&&1=t)return{node:n,offset:t-e};e=r}a:{for(;n;){if(n.nextSibling){n=n.nextSibling;break a}n=n.parentNode}n=void 0}n=ni(n)}}function ii(e,t){return e&&t?e===t?!0:e&&e.nodeType===3?!1:t&&t.nodeType===3?ii(e,t.parentNode):`contains`in e?e.contains(t):e.compareDocumentPosition?!!(e.compareDocumentPosition(t)&16):!1:!1}function ai(e){e=e!=null&&e.ownerDocument!=null&&e.ownerDocument.defaultView!=null?e.ownerDocument.defaultView:window;for(var t=ti(e.document);t instanceof e.HTMLIFrameElement;){try{var n=typeof t.contentWindow.location.href==`string`}catch{n=!1}if(n)e=t.contentWindow;else break;t=ti(e.document)}return t}function oi(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&(t===`input`&&(e.type===`text`||e.type===`search`||e.type===`tel`||e.type===`url`||e.type===`password`)||t===`textarea`||e.contentEditable===`true`)}var si=zn&&`documentMode`in document&&11>=document.documentMode,ci=null,li=null,ui=null,di=!1;function fi(e,t,n){var r=n.window===n?n.document:n.nodeType===9?n:n.ownerDocument;di||ci==null||ci!==ti(r)||(r=ci,`selectionStart`in r&&oi(r)?r={start:r.selectionStart,end:r.selectionEnd}:(r=(r.ownerDocument&&r.ownerDocument.defaultView||window).getSelection(),r={anchorNode:r.anchorNode,anchorOffset:r.anchorOffset,focusNode:r.focusNode,focusOffset:r.focusOffset}),ui&&ei(ui,r)||(ui=r,r=Jf(li,`onSelect`),0>=o,i-=o,ca=1<<32-dt(t)+i|n<h?(g=d,d=null):g=d.sibling;var _=p(i,d,s[h],c);if(_===null){d===null&&(d=g);break}e&&d&&_.alternate===null&&t(i,d),o=a(_,o,h),u===null?l=_:u.sibling=_,u=_,d=g}if(h===s.length)return n(i,d),A&&ua(i,h),l;if(d===null){for(;hg?(_=h,h=null):_=h.sibling;var y=p(i,h,v.value,l);if(y===null){h===null&&(h=_);break}e&&h&&y.alternate===null&&t(i,h),o=a(y,o,g),d===null?u=y:d.sibling=y,d=y,h=_}if(v.done)return n(i,h),A&&ua(i,g),u;if(h===null){for(;!v.done;g++,v=c.next())v=f(i,v.value,l),v!==null&&(o=a(v,o,g),d===null?u=v:d.sibling=v,d=v);return A&&ua(i,g),u}for(h=r(h);!v.done;g++,v=c.next())v=m(h,i,g,v.value,l),v!==null&&(e&&(_=v.alternate,_!==null&&h.delete(_.key===null?g:_.key)),o=a(v,o,g),d===null?u=v:d.sibling=v,d=v);return e&&h.forEach(function(e){return t(i,e)}),A&&ua(i,g),u}function _(e,r,a,c){if(typeof a==`object`&&a&&a.type===ce&&a.key===null&&a.props.ref===void 0&&(a=a.props.children),typeof a==`object`&&a){switch(a.$$typeof){case oe:a:{for(var l=a.key;r!==null;){if(r.key===l){if(l=a.type,l===ce){if(r.tag===7){n(e,r.sibling),c=i(r,a.props.children),vo(c,a),c.return=e,e=c;break a}}else if(r.elementType===l||typeof l==`object`&&l&&l.$$typeof===_e&&uo(l)===r.type){n(e,r.sibling),c=i(r,a.props),vo(c,a),c.return=e,e=c;break a}n(e,r);break}t(e,r),r=r.sibling}a.type===ce?(c=Yi(a.props.children,e.mode,c,a.key),vo(c,a),c.return=e,e=c):(c=Ji(a.type,a.key,a.props,null,e.mode,c),vo(c,a),c.return=e,e=c)}return o(e);case se:a:{for(l=a.key;r!==null;){if(r.key===l){if(r.tag===4&&r.stateNode.containerInfo===a.containerInfo&&r.stateNode.implementation===a.implementation){n(e,r.sibling),c=i(r,a.children||[]),c.return=e,e=c;break a}n(e,r);break}t(e,r),r=r.sibling}c=Qi(a,e.mode,c),c.return=e,e=c}return o(e);case _e:return a=uo(a),_(e,r,a,c)}if(De(a))return h(e,r,a,c);if(we(a)){if(l=we(a),typeof l!=`function`)throw Error(s(150));return a=l.call(a),g(e,r,a,c)}if(typeof a.then==`function`)return _(e,r,_o(a),c);if(a.$$typeof===fe)return _(e,r,Ia(e,a),c);yo(e,a)}return typeof a==`string`&&a!==``||typeof a==`number`||typeof a==`bigint`?(a=``+a,r!==null&&r.tag===6?(n(e,r.sibling),c=i(r,a),c.return=e,e=c):(n(e,r),c=Xi(a,e.mode,c),c.return=e,e=c),o(e)):n(e,r)}return function(e,t,n,r){try{go=0;var i=_(e,t,n,r);return ho=null,i}catch(t){if(t===io||t===oo)throw t;var a=Wi(29,t,null,e.mode);return a.lanes=r,a.return=e,a}}}var xo=bo(!0),So=bo(!1),Co=!1;function wo(e){e.updateQueue={baseState:e.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,lanes:0,hiddenCallbacks:null},callbacks:null}}function To(e,t){e=e.updateQueue,t.updateQueue===e&&(t.updateQueue={baseState:e.baseState,firstBaseUpdate:e.firstBaseUpdate,lastBaseUpdate:e.lastBaseUpdate,shared:e.shared,callbacks:null})}function Eo(e){return{lane:e,tag:0,payload:null,callback:null,next:null}}function Do(e,t,n){var r=e.updateQueue;if(r===null)return null;if(r=r.shared,W&2){var i=r.pending;return i===null?t.next=t:(t.next=i.next,i.next=t),r.pending=t,t=Vi(e),Bi(e,null,n),t}return Li(e,r,t,n),Vi(e)}function Oo(e,t,n){if(t=t.updateQueue,t!==null&&(t=t.shared,n&4194048)){var r=t.lanes;r&=e.pendingLanes,n|=r,t.lanes=n,Ot(e,n)}}function ko(e,t){var n=e.updateQueue,r=e.alternate;if(r!==null&&(r=r.updateQueue,n===r)){var i=null,a=null;if(n=n.firstBaseUpdate,n!==null){do{var o={lane:n.lane,tag:n.tag,payload:n.payload,callback:null,next:null};a===null?i=a=o:a=a.next=o,n=n.next}while(n!==null);a===null?i=a=t:a=a.next=t}else i=a=t;n={baseState:r.baseState,firstBaseUpdate:i,lastBaseUpdate:a,shared:r.shared,callbacks:r.callbacks},e.updateQueue=n}else e=n.lastBaseUpdate,e===null?n.firstBaseUpdate=t:e.next=t,n.lastBaseUpdate=t}var Ao=!1;function jo(){if(Ao){var e=Ya;if(e!==null)throw e}}function Mo(e,t,n,r){Ao=!1;var i=e.updateQueue;Co=!1;var a=i.firstBaseUpdate,o=i.lastBaseUpdate,s=i.shared.pending;if(s!==null){i.shared.pending=null;var c=s,l=c.next;c.next=null,o===null?a=l:o.next=l,o=c;var u=e.alternate;u!==null&&(u=u.updateQueue,s=u.lastBaseUpdate,s!==o&&(s===null?u.firstBaseUpdate=l:s.next=l,u.lastBaseUpdate=c))}if(a!==null){var d=i.baseState;o=0,u=l=c=null,s=a;do{var f=s.lane&-536870913,p=f!==s.lane;if(p?(q&f)===f:(r&f)===f){f!==0&&f===Ja&&(Ao=!0),u!==null&&(u=u.next={lane:0,tag:s.tag,payload:s.payload,callback:null,next:null});a:{var m=e,h=s;f=t;var g=n;switch(h.tag){case 1:if(m=h.payload,typeof m==`function`){d=m.call(g,d,f);break a}d=m;break a;case 3:m.flags=m.flags&-65537|128;case 0:if(m=h.payload,f=typeof m==`function`?m.call(g,d,f):m,f==null)break a;d=S({},d,f);break a;case 2:Co=!0}}f=s.callback,f!==null&&(e.flags|=64,p&&(e.flags|=8192),p=i.callbacks,p===null?i.callbacks=[f]:p.push(f))}else p={lane:f,tag:s.tag,payload:s.payload,callback:s.callback,next:null},u===null?(l=u=p,c=d):u=u.next=p,o|=f;if(s=s.next,s===null){if(s=i.shared.pending,s===null)break;p=s,s=p.next,p.next=null,i.lastBaseUpdate=p,i.shared.pending=null}}while(1);u===null&&(c=d),i.baseState=c,i.firstBaseUpdate=l,i.lastBaseUpdate=u,a===null&&(i.shared.lanes=0),sd|=o,e.lanes=o,e.memoizedState=d}}function No(e,t){if(typeof e!=`function`)throw Error(s(191,e));e.call(t)}function Po(e,t){var n=e.callbacks;if(n!==null)for(e.callbacks=null,e=0;ea?a:8;var o=C.T,s={};s.types=o===null?null:o.types,C.T=s,_c(e,!1,t,n);try{var c=i(),l=C.S;l!==null&&l(s,c),typeof c==`object`&&c&&typeof c.then==`function`?gc(e,t,Qa(c,r),jd(e)):gc(e,t,r,jd(e))}catch(n){gc(e,t,{then:function(){},status:`rejected`,reason:n},jd())}finally{w.p=a,o!==null&&s.types!==null&&(o.types=s.types),C.T=o}}function oc(){}function sc(e,t,n,r){if(e.tag!==5)throw Error(s(476));var i=cc(e).queue;ac(e,i,t,Oe,n===null?oc:function(){return lc(e),n(r)})}function cc(e){var t=e.memoizedState;if(t!==null)return t;t={memoizedState:Oe,baseState:Oe,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:vs,lastRenderedState:Oe},next:null};var n={};return t.next={memoizedState:n,baseState:n,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:vs,lastRenderedState:n},next:null},e.memoizedState=t,e=e.alternate,e!==null&&(e.memoizedState=t),t}function lc(e){var t=cc(e);t.next===null&&(t=e.alternate.memoizedState),gc(e,t.next.queue,{},jd())}function uc(){return Fa(sh)}function dc(){return I().memoizedState}function fc(){return I().memoizedState}function pc(e){for(var t=e.return;t!==null;){switch(t.tag){case 24:case 3:var n=jd();e=Eo(n);var r=Do(t,e,n);r!==null&&(Pd(r,t,n),Oo(r,t,n)),t={cache:Va()},e.payload=t;return}t=t.return}}function mc(e,t,n){var r=jd();n={lane:r,revertLane:0,gesture:null,action:n,hasEagerState:!1,eagerState:null,next:null},vc(e)?yc(t,n):(n=Ri(e,t,n,r),n!==null&&(Pd(n,e,r),bc(n,t,r)))}function hc(e,t,n){gc(e,t,n,jd())}function gc(e,t,n,r){var i={lane:r,revertLane:0,gesture:null,action:n,hasEagerState:!1,eagerState:null,next:null};if(vc(e))yc(t,i);else{var a=e.alternate;if(e.lanes===0&&(a===null||a.lanes===0)&&(a=t.lastRenderedReducer,a!==null))try{var o=t.lastRenderedState,s=a(o,n);if(i.hasEagerState=!0,i.eagerState=s,$r(s,o))return Li(e,t,i,0),G===null&&Ii(),!1}catch{}if(n=Ri(e,t,i,r),n!==null)return Pd(n,e,r),bc(n,t,r),!0}return!1}function _c(e,t,n,r){if(r={lane:2,revertLane:Pf(),gesture:null,action:r,hasEagerState:!1,eagerState:null,next:null},vc(e)){if(t)throw Error(s(479))}else t=Ri(e,n,r,2),t!==null&&Pd(t,e,2)}function vc(e){var t=e.alternate;return e===M||t!==null&&t===M}function yc(e,t){$o=Qo=!0;var n=e.pending;n===null?t.next=t:(t.next=n.next,n.next=t),e.pending=t}function bc(e,t,n){if(n&4194048){var r=t.lanes;r&=e.pendingLanes,n|=r,t.lanes=n,Ot(e,n)}}var xc={readContext:Fa,use:gs,useCallback:F,useContext:F,useEffect:F,useImperativeHandle:F,useLayoutEffect:F,useInsertionEffect:F,useMemo:F,useReducer:F,useRef:F,useState:F,useDebugValue:F,useDeferredValue:F,useTransition:F,useSyncExternalStore:F,useId:F,useHostTransitionStatus:F,useFormState:F,useActionState:F,useOptimistic:F,useMemoCache:F,useCacheRefresh:F,useEffectEvent:F},Sc={readContext:Fa,use:gs,useCallback:function(e,t){return ps().memoizedState=[e,t===void 0?null:t],e},useContext:Fa,useEffect:Ks,useImperativeHandle:function(e,t,n){n=n==null?null:n.concat([e]),Ws(4194308,4,Qs.bind(null,t,e),n)},useLayoutEffect:function(e,t){return Ws(4194308,4,e,t)},useInsertionEffect:function(e,t){Ws(4,2,e,t)},useMemo:function(e,t){var n=ps();t=t===void 0?null:t;var r=e();if(es){ut(!0);try{e()}finally{ut(!1)}}return n.memoizedState=[r,t],r},useReducer:function(e,t,n){var r=ps();if(n!==void 0){var i=n(t);if(es){ut(!0);try{n(t)}finally{ut(!1)}}}else i=t;return r.memoizedState=r.baseState=i,e={pending:null,lanes:0,dispatch:null,lastRenderedReducer:e,lastRenderedState:i},r.queue=e,e=e.dispatch=mc.bind(null,M,e),[r.memoizedState,e]},useRef:function(e){var t=ps();return e={current:e},t.memoizedState=e},useState:function(e){e=Os(e);var t=e.queue,n=hc.bind(null,M,t);return t.dispatch=n,[e.memoizedState,n]},useDebugValue:ec,useDeferredValue:function(e,t){return rc(ps(),e,t)},useTransition:function(){var e=Os(!1);return e=ac.bind(null,M,e.queue,!0,!1),ps().memoizedState=e,[!1,e]},useSyncExternalStore:function(e,t,n){var r=M,i=ps();if(A){if(n===void 0)throw Error(s(407));n=n()}else{if(n=t(),G===null)throw Error(s(349));q&127||Cs(r,t,n)}i.memoizedState=n;var a={value:n,getSnapshot:t};return i.queue=a,Ks(Ts.bind(null,r,a,e),[e]),r.flags|=2048,Hs(9,{destroy:void 0},ws.bind(null,r,a,n,t),null),n},useId:function(){var e=ps(),t=G.identifierPrefix;if(A){var n=la,r=ca;n=(r&~(1<<32-dt(r)-1)).toString(32)+n,t=`_`+t+`R_`+n,n=ts++,0<\/script>`,a=a.removeChild(a.firstChild);break;case`select`:a=typeof r.is==`string`?o.createElement(`select`,{is:r.is}):o.createElement(`select`),r.multiple?a.multiple=!0:r.size&&(a.size=r.size);break;default:a=typeof r.is==`string`?o.createElement(i,{is:r.is}):o.createElement(i)}}a[Ft]=t,a[It]=r;a:for(o=t.child;o!==null;){if(o.tag===5||o.tag===6)a.appendChild(o.stateNode);else if(o.tag!==4&&o.tag!==27&&o.child!==null){o.child.return=o,o=o.child;continue}if(o===t)break a;for(;o.sibling===null;){if(o.return===null||o.return===t)break a;o=o.return}o.sibling.return=o.return,o=o.sibling}t.stateNode=a;a:switch(np(a,i,r),i){case`button`:case`input`:case`select`:case`textarea`:r=!!r.autoFocus;break a;case`img`:r=!0;break a;default:r=!1}r&&vl(t)}}return z(t),t.subtreeFlags&=-33554433,yl(t,t.type,e===null?null:e.memoizedProps,t.pendingProps,n),null;case 6:if(e&&t.stateNode!=null)e.memoizedProps!==r&&vl(t);else{if(typeof r!=`string`&&t.stateNode===null)throw Error(s(166));if(e=Fe.current,xa(t)){if(e=t.stateNode,n=t.memoizedProps,r=null,i=O,i!==null)switch(i.tag){case 27:case 5:r=i.memoizedProps}e[Ft]=t,e=!!(e.nodeValue===n||r!==null&&!0===r.suppressHydrationWarning||ep(e.nodeValue,n)),e||va(t,!0)}else e=lp(e).createTextNode(r),e[Ft]=t,t.stateNode=e}return z(t),null;case 31:if(n=t.memoizedState,e===null||e.memoizedState!==null){if(r=xa(t),n!==null){if(e===null){if(!r)throw Error(s(318));if(e=t.memoizedState,e=e===null?null:e.dehydrated,!e)throw Error(s(557));e[Ft]=t}else Sa(),!(t.flags&128)&&(t.memoizedState=null),t.flags|=4;z(t),e=!1}else n=Ca(),e!==null&&e.memoizedState!==null&&(e.memoizedState.hydrationErrors=n),e=!0;if(!e)return t.flags&256?(Ko(t),t):(Ko(t),null);if(t.flags&128)throw Error(s(558))}return z(t),null;case 13:if(r=t.memoizedState,e===null||e.memoizedState!==null&&e.memoizedState.dehydrated!==null){if(i=xa(t),r!==null&&r.dehydrated!==null){if(e===null){if(!i)throw Error(s(318));if(i=t.memoizedState,i=i===null?null:i.dehydrated,!i)throw Error(s(317));i[Ft]=t}else Sa(),!(t.flags&128)&&(t.memoizedState=null),t.flags|=4;z(t),i=!1}else i=Ca(),e!==null&&e.memoizedState!==null&&(e.memoizedState.hydrationErrors=i),i=!0;if(!i)return t.flags&256?(Ko(t),t):(Ko(t),null)}return Ko(t),t.flags&128?(t.lanes=n,t):(n=r!==null,e=e!==null&&e.memoizedState!==null,n&&(r=t.child,i=null,r.alternate!==null&&r.alternate.memoizedState!==null&&r.alternate.memoizedState.cachePool!==null&&(i=r.alternate.memoizedState.cachePool.pool),a=null,r.memoizedState!==null&&r.memoizedState.cachePool!==null&&(a=r.memoizedState.cachePool.pool),a!==i&&(r.flags|=2048)),n!==e&&n&&(t.child.flags|=8192),xl(t,t.updateQueue),z(t),null);case 4:return Re(),e===null&&Wf(t.stateNode.containerInfo),t.flags|=67108864,z(t),null;case 10:return ka(t.type),z(t),null;case 19:if(Yo(t),r=t.memoizedState,r===null)return z(t),null;if(i=!!(t.flags&128),a=r.rendering,a===null){if(i)Sl(r,!1);else{if(Y!==0||e!==null&&e.flags&128)for(e=t.child;e!==null;){if(a=Xo(e),a!==null){for(t.flags|=128,Sl(r,!1),e=a.updateQueue,t.updateQueue=e,xl(t,e),t.subtreeFlags=0,e=n,n=t.child;n!==null;)qi(n,e),n=n.sibling;return Jo(t,qo.current&1|2),A&&ua(t,r.treeForkCount),t.child}e=e.sibling}r.tail!==null&&$e()>_d&&(t.flags|=128,i=!0,Sl(r,!1),t.lanes=4194304)}}else{if(!i){if(e=Xo(a),e!==null){if(t.flags|=128,i=!0,e=e.updateQueue,t.updateQueue=e,xl(t,e),Sl(r,!0),r.tail===null&&r.tailMode!==`collapsed`&&r.tailMode!==`visible`&&!a.alternate&&!A)return z(t),null}else 2*$e()-r.renderingStartTime>_d&&n!==536870912&&(t.flags|=128,i=!0,Sl(r,!1),t.lanes=4194304)}r.isBackwards?(a.sibling=t.child,t.child=a):(e=r.last,e===null?t.child=a:e.sibling=a,r.last=a)}if(r.tail!==null){e=r.tail;a:{for(n=e;n!==null;){if(n.alternate!==null){n=!1;break a}n=n.sibling}n=!0}return r.rendering=e,r.tail=e.sibling,r.renderingStartTime=$e(),e.sibling=null,a=qo.current,a=i?a&1|2:a&1,r.tailMode===`visible`||r.tailMode===`collapsed`||!n||A?Jo(t,a):(n=a,T(Bo,t),T(qo,n),Vo===null&&(Vo=t)),A&&ua(t,r.treeForkCount),e}return z(t),null;case 22:case 23:return Ko(t),zo(),r=t.memoizedState!==null,e===null?r&&(t.flags|=8192):e.memoizedState!==null!==r&&(t.flags|=8192),r?n&536870912&&!(t.flags&128)&&(z(t),t.subtreeFlags&6&&(t.flags|=8192)):z(t),n=t.updateQueue,n!==null&&xl(t,n.retryQueue),n=null,e!==null&&e.memoizedState!==null&&e.memoizedState.cachePool!==null&&(n=e.memoizedState.cachePool.pool),r=null,t.memoizedState!==null&&t.memoizedState.cachePool!==null&&(r=t.memoizedState.cachePool.pool),r!==n&&(t.flags|=2048),e!==null&&Me(eo),null;case 24:return n=null,e!==null&&(n=e.memoizedState.cache),t.memoizedState.cache!==n&&(t.flags|=2048),ka(j),z(t),null;case 25:return null;case 30:return t.flags|=33554432,z(t),null}throw Error(s(156,t.tag))}function wl(e,t){switch(pa(t),t.tag){case 1:return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 3:return ka(j),Re(),e=t.flags,e&65536&&!(e&128)?(t.flags=e&-65537|128,t):null;case 26:case 27:case 5:return Be(t),null;case 31:if(t.memoizedState!==null){if(Ko(t),t.alternate===null)throw Error(s(340));Sa()}return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 13:if(Ko(t),e=t.memoizedState,e!==null&&e.dehydrated!==null){if(t.alternate===null)throw Error(s(340));Sa()}return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 19:return Yo(t),e=t.flags,e&65536?(t.flags=e&-65537|128,e=t.memoizedState,e!==null&&(e.rendering=null,e.tail=null),t.flags|=4,t):null;case 4:return Re(),null;case 10:return ka(t.type),null;case 22:case 23:return Ko(t),zo(),e!==null&&Me(eo),e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 24:return ka(j),null;case 25:return null;default:return null}}function Tl(e,t){switch(pa(t),t.tag){case 3:ka(j),Re();break;case 26:case 27:case 5:Be(t);break;case 4:Re();break;case 31:t.memoizedState!==null&&Ko(t);break;case 13:Ko(t);break;case 19:Yo(t);break;case 10:ka(t.type);break;case 22:case 23:Ko(t),zo(),e!==null&&Me(eo);break;case 24:ka(j)}}function El(e,t){try{var n=t.updateQueue,r=n===null?null:n.lastEffect;if(r!==null){var i=r.next;n=i;do{if((n.tag&e)===e){r=void 0;var a=n.create,o=n.inst;r=a(),o.destroy=r}n=n.next}while(n!==i)}}catch(e){Z(t,t.return,e)}}function Dl(e,t,n){try{var r=t.updateQueue,i=r===null?null:r.lastEffect;if(i!==null){var a=i.next;r=a;do{if((r.tag&e)===e){var o=r.inst,s=o.destroy;if(s!==void 0){o.destroy=void 0,i=t;var c=n,l=s;try{l()}catch(e){Z(i,c,e)}}}r=r.next}while(r!==a)}}catch(e){Z(t,t.return,e)}}function Ol(e){var t=e.updateQueue;if(t!==null){var n=e.stateNode;try{Po(t,n)}catch(t){Z(e,e.return,t)}}}function kl(e,t,n){n.props=kc(e.type,e.memoizedProps),n.state=e.memoizedState;try{n.componentWillUnmount()}catch(n){Z(e,t,n)}}function Al(e,t){try{var n=e.ref;if(n!==null){switch(e.tag){case 26:case 27:case 5:var r=e.stateNode;break;case 30:var i=e.stateNode,a=ki(e.memoizedProps,i);(i.ref===null||i.ref.name!==a)&&(i.ref=Pp(a)),r=i.ref;break;case 7:if(e.stateNode===null){var o=new Fp(e);h(e.child,!1,Qp,o,void 0,void 0),e.stateNode=o}r=e.stateNode;break;default:r=e.stateNode}typeof n==`function`?e.refCleanup=n(r):n.current=r}}catch(n){Z(e,t,n)}}function jl(e,t){var n=e.ref,r=e.refCleanup;if(n!==null){if(typeof r==`function`)try{r()}catch(n){Z(e,t,n)}finally{e.refCleanup=null,e=e.alternate,e!=null&&(e.refCleanup=null)}else if(typeof n==`function`)try{n(null)}catch(n){Z(e,t,n)}else n.current=null}}function Ml(e,t){if((e.tag===5||e.tag===27||e.tag===6)&&e.alternate===null&&t!==null)for(var n=0;n title`))),np(r,t,n),r[Ft]=e,E(r),t=r;break a;case`link`:if(a=Gm(`link`,`href`,i).get(t+(n.href||``))){for(o=0;og&&(o=g,g=h,h=o);var _=ri(s,h),v=ri(s,g);if(_&&v&&(p.rangeCount!==1||p.anchorNode!==_.node||p.anchorOffset!==_.offset||p.focusNode!==v.node||p.focusOffset!==v.offset)){var y=d.createRange();y.setStart(_.node,_.offset),p.removeAllRanges(),h>g?(p.addRange(y),p.extend(v.node,v.offset)):(y.setEnd(v.node,v.offset),p.addRange(y))}}}}for(d=[],p=s;p=p.parentNode;)p.nodeType===1&&d.push({element:p,left:p.scrollLeft,top:p.scrollTop});for(typeof s.focus==`function`&&s.focus(),s=0;sn?32:n,C.T=null,n=wd,wd=null;var a=bd,o=Sd;if(X=0,xd=bd=null,Sd=0,W&6)throw Error(s(331));var c=W;if(W|=4,Zu(a.current),Uu(a,a.current,o,n),W=c,Df(0,!1),lt&&typeof lt.onPostCommitFiberRoot==`function`)try{lt.onPostCommitFiberRoot(ct,a)}catch{}return!0}finally{w.p=i,C.T=r,uf(e,t)}}function pf(e,t,n){t=ea(n,t),t=Fc(e.stateNode,t,2),e=Do(e,t,2),e!==null&&(Tt(e,2),Ef(e))}function Z(e,t,n){if(e.tag===3)pf(e,e,n);else for(;t!==null;){if(t.tag===3){pf(t,e,n);break}if(t.tag===1){var r=t.stateNode;if(typeof t.type.getDerivedStateFromError==`function`||typeof r.componentDidCatch==`function`&&(yd===null||!yd.has(r))){e=ea(n,e),n=Ic(2),r=Do(t,n,2),r!==null&&(Lc(n,r,t,e),Tt(r,2),Ef(r));break}}t=t.return}}function mf(e,t,n){var r=e.pingCache;if(r===null){r=e.pingCache=new td;var i=new Set;r.set(t,i)}else i=r.get(t),i===void 0&&(i=new Set,r.set(t,i));i.has(n)||(ad=!0,i.add(n),e=hf.bind(null,e,t,n),t.then(e,e))}function hf(e,t,n){var r=e.pingCache;r!==null&&r.delete(t),e.pingedLanes|=e.suspendedLanes&n,e.warmLanes&=~n,G===e&&(q&n)===n&&(Y===4||Y===3&&(q&62914560)===q&&300>$e()-hd?W&2?ld|=n:Vd(e,0):ld|=n,dd===q&&(dd=0)),Ef(e)}function gf(e,t){t===0&&(t=Ct()),e=zi(e,t),e!==null&&(Tt(e,t),Ef(e))}function _f(e){var t=e.memoizedState,n=0;t!==null&&(n=t.retryLane),gf(e,n)}function vf(e,t){var n=0;switch(e.tag){case 31:case 13:var r=e.stateNode,i=e.memoizedState;i!==null&&(n=i.retryLane);break;case 19:r=e.stateNode;break;case 22:r=e.stateNode._retryCache;break;default:throw Error(s(314))}r!==null&&r.delete(t),gf(e,n)}function yf(e,t){return Ye(e,t)}var bf=null,xf=null,Sf=!1,Cf=!1,wf=!1,Tf=0;function Ef(e){e!==xf&&e.next===null&&(xf===null?bf=xf=e:xf=xf.next=e),Cf=!0,Sf||(Sf=!0,Nf())}function Df(e,t){if(!wf&&Cf){wf=!0;do for(var n=!1,r=bf;r!==null;){if(!t){if(e!==0){var i=r.pendingLanes;if(i===0)var a=0;else{var o=r.suspendedLanes,s=r.pingedLanes;a=(1<<31-dt(42|e)+1)-1,a&=i&~(o&~s),a=a&201326741?a&201326741|1:a?a|2:0}a!==0&&(n=!0,Mf(r,a))}else a=q,a=yt(r,r===G?a:0,r.cancelPendingCommit!==null||r.timeoutHandle!==-1),!(a&3)||bt(r,a)||(n=!0,Mf(r,a))}r=r.next}while(n);wf=!1}}function Of(){kf()}function kf(){Cf=Sf=!1;var e=0;Tf!==0&&hp()&&(e=Tf);for(var t=$e(),n=null,r=bf;r!==null;){var i=r.next,a=Af(r,t);a===0?(r.next=null,n===null?bf=i:n.next=i,i===null&&(xf=n)):(n=r,(e!==0||a&3)&&(Cf=!0)),r=i}X!==0&&X!==5||Df(e,!1),Tf!==0&&(Tf=0)}function Af(e,t){for(var n=e.suspendedLanes,r=e.pingedLanes,i=e.expirationTimes,a=e.pendingLanes&-62914561;0s)break;var u=c.transferSize,d=c.initiatorType;u&&ap(d)&&(c=c.responseEnd,o+=u*(c$m){s.length=o;break}f=new Promise(jp.bind(f)),s.push(f)}}}if(0`u`?null:document;function Tm(e,t,n){var r=wm;if(r&&typeof t==`string`&&t){var i=hn(t);i=`link[rel="`+e+`"][href="`+i+`"]`,typeof n==`string`&&(i+=`[crossorigin="`+n+`"]`),ym.has(i)||(ym.add(i),e={rel:e,crossOrigin:n,href:t},r.querySelector(i)===null&&(t=r.createElement(`link`),np(t,`link`,e),E(t),r.head.appendChild(t)))}}function Em(e){xm.D(e),Tm(`dns-prefetch`,e,null)}function Dm(e,t){xm.C(e,t),Tm(`preconnect`,e,t)}function Om(e,t,n){xm.L(e,t,n);var r=wm;if(r&&e&&t){var i=`link[rel="preload"][as="`+hn(t)+`"]`;t===`image`&&n&&n.imageSrcSet?(i+=`[imagesrcset="`+hn(n.imageSrcSet)+`"]`,typeof n.imageSizes==`string`&&(i+=`[imagesizes="`+hn(n.imageSizes)+`"]`)):i+=`[href="`+hn(e)+`"]`;var a=i;switch(t){case`style`:a=Pm(e);break;case`script`:a=Rm(e)}if(!(vm.has(a)||(e=S({rel:`preload`,href:t===`image`&&n&&n.imageSrcSet?void 0:e,as:t},n),vm.set(a,e),r.querySelector(i)!==null||t===`style`&&r.querySelector(Fm(a))||t===`script`&&r.querySelector(zm(a))))){var o=r.createElement(`link`);np(o,`link`,e),t===`style`&&(o[Ut]=!0,o.onload=o.onerror=function(){Yt(o)}),E(o),r.head.appendChild(o)}}}function km(e,t){xm.m(e,t);var n=wm;if(n&&e){var r=t&&typeof t.as==`string`?t.as:`script`,i=`link[rel="modulepreload"][as="`+hn(r)+`"][href="`+hn(e)+`"]`,a=i;switch(r){case`audioworklet`:case`paintworklet`:case`serviceworker`:case`sharedworker`:case`worker`:case`script`:a=Rm(e)}if(!vm.has(a)&&(e=S({rel:`modulepreload`,href:e},t),vm.set(a,e),n.querySelector(i)===null)){switch(r){case`audioworklet`:case`paintworklet`:case`serviceworker`:case`sharedworker`:case`worker`:case`script`:if(n.querySelector(zm(a)))return}r=n.createElement(`link`),np(r,`link`,e),E(r),n.head.appendChild(r)}}}function Am(e,t,n){xm.S(e,t,n);var r=wm;if(r&&e){var i=Jt(r).hoistableStyles,a=Pm(e);t||=`default`;var o=i.get(a);if(!o){var s={loading:0,preload:null};if(o=r.querySelector(Fm(a)))s.loading=5;else{e=S({rel:`stylesheet`,href:e,"data-precedence":t},n),(n=vm.get(a))&&Hm(e,n);var c=o=r.createElement(`link`);E(c),np(c,`link`,e),c._p=new Promise(function(e,t){c.onload=e,c.onerror=t}),c.addEventListener(`load`,function(){s.loading|=1}),c.addEventListener(`error`,function(){s.loading|=2}),s.loading|=4,Vm(o,t,r)}o={type:`stylesheet`,instance:o,count:1,state:s},i.set(a,o)}}}function jm(e,t){xm.X(e,t);var n=wm;if(n&&e){var r=Jt(n).hoistableScripts,i=Rm(e),a=r.get(i);a||(a=n.querySelector(zm(i)),a||(e=S({src:e,async:!0},t),(t=vm.get(i))&&Um(e,t),a=n.createElement(`script`),E(a),np(a,`link`,e),n.head.appendChild(a)),a={type:`script`,instance:a,count:1,state:null},r.set(i,a))}}function Mm(e,t){xm.M(e,t);var n=wm;if(n&&e){var r=Jt(n).hoistableScripts,i=Rm(e),a=r.get(i);a||(a=n.querySelector(zm(i)),a||(e=S({src:e,async:!0,type:`module`},t),(t=vm.get(i))&&Um(e,t),a=n.createElement(`script`),E(a),np(a,`link`,e),n.head.appendChild(a)),a={type:`script`,instance:a,count:1,state:null},r.set(i,a))}}function Nm(e,t,n,r){var i=(i=Fe.current)?bm(i):null;if(!i)throw Error(s(446));switch(e){case`meta`:case`title`:return null;case`style`:return typeof n.precedence==`string`&&typeof n.href==`string`?(n=Pm(n.href),t=Jt(i).hoistableStyles,r=t.get(n),r||(r={type:`style`,instance:null,count:0,state:null},t.set(n,r)),r):{type:`void`,instance:null,count:0,state:null};case`link`:if(n.rel===`stylesheet`&&typeof n.href==`string`&&typeof n.precedence==`string`){e=Pm(n.href);var a=Jt(i).hoistableStyles,o=a.get(e);if(o||(i=i.ownerDocument||i,o={type:`stylesheet`,instance:null,count:0,state:{loading:0,preload:null}},a.set(e,o),(a=i.querySelector(Fm(e)))?a._p||(o.instance=a,o.state.loading=5):(a=vm.get(e),a||(a={rel:`preload`,as:`style`,href:n.href,crossOrigin:n.crossOrigin,integrity:n.integrity,media:n.media,hrefLang:n.hrefLang,referrerPolicy:n.referrerPolicy},vm.set(e,a)),Lm(i,e,a,o.state))),t&&r===null)throw Error(s(528,``));return o}if(t&&r!==null)throw Error(s(529,``));return null;case`script`:return t=n.async,n=n.src,typeof n==`string`&&t&&typeof t!=`function`&&typeof t!=`symbol`?(n=Rm(n),t=Jt(i).hoistableScripts,r=t.get(n),r||(r={type:`script`,instance:null,count:0,state:null},t.set(n,r)),r):{type:`void`,instance:null,count:0,state:null};default:throw Error(s(444,e))}}function Pm(e){return`href="`+hn(e)+`"`}function Fm(e){return`link[rel="stylesheet"][`+e+`]`}function Im(e){return S({},e,{"data-precedence":e.precedence,precedence:null})}function Lm(e,t,n,r){if(t=e.querySelector(`link[rel="preload"][as="style"][`+t+`]`)){if(!0!==t[Ut]){r.loading=1;return}}else t=e.createElement(`link`),t[Ut]=!0,t.onload=t.onerror=Yt.bind(null,t),np(t,`link`,n),E(t),e.head.appendChild(t);r.preload=t,t.addEventListener(`load`,function(){return r.loading|=1}),t.addEventListener(`error`,function(){return r.loading|=2})}function Rm(e){return`[src="`+hn(e)+`"]`}function zm(e){return`script[async]`+e}function Bm(e,t,n){if(t.count++,t.instance===null)switch(t.type){case`style`:var r=e.querySelector(`style[data-href~="`+hn(n.href)+`"]`);if(r)return t.instance=r,E(r),r;var i=S({},n,{"data-href":n.href,"data-precedence":n.precedence,href:null,precedence:null});return r=(e.ownerDocument||e).createElement(`style`),E(r),np(r,`style`,i),Vm(r,n.precedence,e),t.instance=r;case`stylesheet`:i=Pm(n.href);var a=e.querySelector(Fm(i));if(a)return t.state.loading|=4,t.instance=a,E(a),a;r=Im(n),(i=vm.get(i))&&Hm(r,i),a=(e.ownerDocument||e).createElement(`link`),E(a);var o=a;return o._p=new Promise(function(e,t){o.onload=e,o.onerror=t}),np(a,`link`,r),t.state.loading|=4,Vm(a,n.precedence,e),t.instance=a;case`script`:return a=Rm(n.src),(i=e.querySelector(zm(a)))?(t.instance=i,E(i),i):(r=n,(i=vm.get(a))&&(r=S({},n),Um(r,i)),e=e.ownerDocument||e,i=e.createElement(`script`),E(i),np(i,`link`,r),e.head.appendChild(i),t.instance=i);case`void`:return null;default:throw Error(s(443,t.type))}else t.type===`stylesheet`&&!(t.state.loading&4)&&(r=t.instance,t.state.loading|=4,Vm(r,n.precedence,e));return t.instance}function Vm(e,t,n){for(var r=n.querySelectorAll(`link[rel="stylesheet"][data-precedence],style[data-precedence]`),i=r.length?r[r.length-1]:null,a=i,o=0;o title`):null)}function qm(e,t,n){if(n===1||t.itemProp!=null)return!1;switch(e){case`meta`:case`title`:return!0;case`style`:if(typeof t.precedence!=`string`||typeof t.href!=`string`||t.href===``)break;return!0;case`link`:if(typeof t.rel!=`string`||typeof t.href!=`string`||t.href===``||t.onLoad||t.onError)break;switch(t.rel){case`stylesheet`:return e=t.disabled,typeof t.precedence==`string`&&e==null;default:return!0}case`script`:if(t.async&&typeof t.async!=`function`&&typeof t.async!=`symbol`&&!t.onLoad&&!t.onError&&t.src&&typeof t.src==`string`)return!0}return!1}function Jm(e,t){return e===`img`&&t.src!=null&&t.src!==``&&t.onLoad==null&&t.loading!==`lazy`}function Ym(e){return!(e.type===`stylesheet`&&!(e.state.loading&3))}function Xm(e){return(e.width||100)*(e.height||100)*(typeof devicePixelRatio==`number`?devicePixelRatio:1)*.25}function Zm(e,t){typeof t.decode==`function`&&(e.imgCount++,t.complete||(e.imgBytes+=Xm(t),e.suspenseyImages.push(t)),e=rh.bind(e),t.decode().then(e,e))}function Qm(e,t,n,r){if(n.type===`stylesheet`&&(typeof r.media!=`string`||!1!==matchMedia(r.media).matches)&&!(n.state.loading&4)){if(n.instance===null){var i=Pm(r.href),a=t.querySelector(Fm(i));if(a){t=a._p,typeof t==`object`&&t&&typeof t.then==`function`&&(e.count++,e=nh.bind(e),t.then(e,e)),n.state.loading|=4,n.instance=a,E(a);return}a=t.ownerDocument||t,r=Im(r),(i=vm.get(i))&&Hm(r,i),a=a.createElement(`link`),E(a);var o=a;o._p=new Promise(function(e,t){o.onload=e,o.onerror=t}),np(a,`link`,r),n.instance=a}e.stylesheets===null&&(e.stylesheets=new Map),e.stylesheets.set(n,t),(t=n.state.preload)&&!(n.state.loading&3)&&(e.count++,n=nh.bind(e),t.addEventListener(`load`,n),t.addEventListener(`error`,n))}}var $m=0;function eh(e,t){return e.stylesheets&&e.count===0&&ah(e,e.stylesheets),0$m?50:800)+t);return e.unsuspend=n,function(){e.unsuspend=null,clearTimeout(r),clearTimeout(i)}}:null}function th(e){if(e.count===0&&(e.imgCount===0||!e.waitingForImages)){if(e.stylesheets)ah(e,e.stylesheets);else if(e.unsuspend){var t=e.unsuspend;e.unsuspend=null,t()}}}function nh(){this.count--,th(this)}function rh(){this.imgCount--,th(this)}var ih=null;function ah(e,t){e.stylesheets=null,e.unsuspend!==null&&(e.count++,ih=new Map,t.forEach(oh,e),ih=null,nh.call(e))}function oh(e,t){if(!(t.state.loading&4)){var n=ih.get(e);if(n)var r=n.get(null);else{n=new Map,ih.set(e,n);for(var i=e.querySelectorAll(`link[data-precedence],style[data-precedence]`),a=0;a{function n(){if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__<`u`&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE==`function`)try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(n)}catch(e){console.error(e)}}n(),t.exports=s()}));n();var l=c(),u=e((e=>{var t=Symbol.for(`react.transitional.element`),n=Symbol.for(`react.fragment`);function r(e,n,r){var i=null;if(r!==void 0&&(i=``+r),n.key!==void 0&&(i=``+n.key),`key`in n)for(var a in r={},n)a!==`key`&&(r[a]=n[a]);else r=n;return n=r.ref,{$$typeof:t,type:e,key:i,ref:n===void 0?null:n,props:r}}e.Fragment=n,e.jsx=r,e.jsxs=r})),d=e(((e,t)=>{t.exports=u()}))();function f({rel:e,name:t,alt:n,caption:r,feature:i=``}){return(0,d.jsxs)(`figure`,{className:`shot ${i}`,children:[(0,d.jsx)(`a`,{href:`${e}img/${t}`,target:`_blank`,rel:`noopener noreferrer`,children:(0,d.jsx)(`img`,{src:`${e}img/${t}`,alt:n,loading:`lazy`,decoding:`async`})}),r&&(0,d.jsx)(`figcaption`,{children:r})]})}function p({children:e,label:t}){return(0,d.jsxs)(`div`,{className:`code-block`,children:[t&&(0,d.jsx)(`span`,{className:`code-label`,children:t}),(0,d.jsx)(`pre`,{children:(0,d.jsx)(`code`,{children:e})})]})}function m({children:e}){return(0,d.jsx)(`kbd`,{className:`kbd`,children:e})}function h({tone:e=`ok`,children:t}){return(0,d.jsx)(`span`,{className:`badge badge-${e}`,children:t})}function g({kicker:e,title:t,lede:n}){return(0,d.jsxs)(`header`,{className:`page-head`,children:[e&&(0,d.jsx)(`p`,{className:`kicker`,children:e}),(0,d.jsx)(`h1`,{children:t}),n&&(0,d.jsx)(`p`,{className:`lede`,children:n})]})}function _({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsxs)(`div`,{className:`hero`,children:[(0,d.jsxs)(`div`,{children:[(0,d.jsx)(`p`,{className:`kicker yellow`,children:`docker · github actions · kubernetes`}),(0,d.jsxs)(`h1`,{children:[`DevOps scaffolding,`,(0,d.jsx)(`br`,{}),`deterministically.`]}),(0,d.jsx)(`p`,{className:`lede`,children:`DevOpsGen reads your Go or Node.js project and writes a complete, opinionated DevOps baseline: hardened Dockerfile, GitHub Actions pipeline and ready-to-apply Kubernetes manifests — with dry-run plans, automatic backups and config validation built in.`}),(0,d.jsxs)(`div`,{className:`hero-cta`,children:[(0,d.jsx)(`a`,{className:`btn`,href:`${e}getting-started/`,children:`Get started`}),(0,d.jsx)(`a`,{className:`btn btn-pink`,href:`${e}wizard/`,children:`Take the wizard tour`})]})]}),(0,d.jsx)(f,{rel:e,name:`wizard.png`,alt:`DevOpsGen interactive wizard running in a Windows terminal, asking for the project stack`,caption:`The interactive wizard — press Enter to accept smart defaults.`,feature:`shot-feature`})]}),(0,d.jsx)(`h2`,{children:`Why DevOpsGen`}),(0,d.jsxs)(`div`,{className:`cards`,children:[(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Deterministic`}),(0,d.jsxs)(`p`,{children:[`Same inputs, same bytes — every run. Machine-friendly for code review: a second generation with `,(0,d.jsx)(`code`,{children:`--force`}),` produces bit-identical files.`]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Safe by default`}),(0,d.jsxs)(`p`,{children:[`Existing files are never overwritten without `,(0,d.jsx)(`code`,{children:`--force`}),`. Overwrites get`,` `,(0,d.jsx)(`code`,{children:`.bak`}),` backups, failed runs roll back automatically, and`,` `,(0,d.jsx)(`code`,{children:`--dry-run`}),` prints the full plan first.`]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Validated output`}),(0,d.jsx)(`p`,{children:`Built-in validation checks Dockerfile structure, GitHub Actions workflow wiring and Kubernetes manifests (selector consistency, port ranges, Ingress paths) before anything ships.`})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Stack aware`}),(0,d.jsxs)(`p`,{children:[`Detects Go and Node.js projects (npm, pnpm, Express, Next.js, Vite, NestJS) from`,` `,(0,d.jsx)(`code`,{children:`go.mod`}),` / `,(0,d.jsx)(`code`,{children:`package.json`}),` and tailors templates accordingly.`]})]})]}),(0,d.jsx)(`h2`,{children:`Everything a project needs on day one`}),(0,d.jsxs)(`p`,{children:[`One `,(0,d.jsx)(`code`,{children:`init`}),` command writes the whole baseline tree. Preview the real terminal output of every command below — all screenshots are live captures, not mockups.`]}),(0,d.jsx)(p,{label:`generated in one command`,children:`$ devopsgen init --stack go --ci github-actions --registry ghcr --image you/myapp --port 8080 created 5 file(s), replaced 0 file(s) in . -exit code: 0`}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`init-success.png`,alt:`Terminal showing a successful DevOpsGen init run creating five files with exit code 0`,caption:`init — first run creates the complete baseline and exits 0.`}),(0,d.jsx)(f,{rel:e,name:`init-conflict.png`,alt:`Terminal showing DevOpsGen refusing to overwrite five files and exiting with code 3`,caption:`init on a second run refuses to overwrite files — exit code 3 without --force.`}),(0,d.jsx)(f,{rel:e,name:`dry-run.png`,alt:`Terminal showing a DevOpsGen dry-run plan listing replace and conflict entries before exiting with code 3`,caption:`--dry-run prints the exact write plan, unresolved conflicts included.`})]}),(0,d.jsx)(`h2`,{children:`What gets generated`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Template set`}),(0,d.jsx)(`th`,{children:`Files`}),(0,d.jsx)(`th`,{children:`Purpose`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`docker`}),` (+ `,(0,d.jsx)(`code`,{children:`.dockerignore`}),`)`]}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`Dockerfile`})}),(0,d.jsxs)(`td`,{children:[`Hardened multi-stage build (Go runs as `,(0,d.jsx)(`code`,{children:`USER 1000:1000`}),` on a scratch base). For Node.js, RUN steps and install/prune commands follow the detected package manager (npm / pnpm) and lockfile. The generated `,(0,d.jsx)(`code`,{children:`.dockerignore`}),` `,`keeps state, tool caches and env files out of the image.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`github-actions`})}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.github/workflows/ci.yml`})}),(0,d.jsx)(`td`,{children:`Runs your tests when a test command is configured, then builds and pushes the image with both the commit SHA tag and your alias tag, authenticating to the chosen registry via secrets.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`kubernetes`})}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`deployment.yaml`}),`, `,(0,d.jsx)(`code`,{children:`service.yaml`}),`, optional `,(0,d.jsx)(`code`,{children:`ingress.yaml`})]}),(0,d.jsxs)(`td`,{children:[`DNS 1035-safe resource names, container port wiring, resource requests and limits, health probes when `,(0,d.jsx)(`code`,{children:`--health-path`}),` is given, and an optional host-based Ingress (RFC 1123 hostname).`]})]})]})]})}),(0,d.jsx)(`h2`,{children:`Explore the docs`}),(0,d.jsx)(`div`,{className:`cards core`,children:x.filter(e=>e.path!==``).map(t=>(0,d.jsxs)(`a`,{className:`card`,style:{display:`block`},href:`${e}${t.path}/`,children:[(0,d.jsx)(`h3`,{children:t.path.replace(/-/g,` `)}),(0,d.jsx)(`p`,{children:t.description})]},t.path))}),(0,d.jsx)(`h2`,{children:`Command cheatsheet`}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`help.png`,alt:`Terminal showing the full devopsgen help output listing all commands`,caption:`devopsgen --help — all commands at a glance.`}),(0,d.jsx)(f,{rel:e,name:`list.png`,alt:`Terminal showing the devopsgen list output with available stacks, app types and registries`,caption:`devopsgen list — supported stacks, app types and registries.`}),(0,d.jsx)(f,{rel:e,name:`version.png`,alt:`Terminal showing the devopsgen version output`,caption:`devopsgen version.`})]})]})}function v({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`getting started`,title:`Zero to CI in one command`,lede:`Install DevOpsGen, point it at any Go or Node.js project, and get a full Docker + GitHub Actions + Kubernetes baseline in seconds.`}),(0,d.jsx)(`h2`,{children:`Install`}),(0,d.jsx)(p,{label:`go install (go 1.22+)`,children:`go install devopsgen.dev/devopsgen@latest`}),(0,d.jsxs)(`p`,{children:[`Or grab a prebuilt binary from the project`,` `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen/releases`,target:`_blank`,rel:`noopener noreferrer`,children:`GitHub releases`}),`, or build from source:`]}),(0,d.jsx)(p,{label:`from source`,children:`git clone https://github.com/Bangkahdev/DevOpsGen.git +exit code: 0`}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`init-success.png`,alt:`Terminal showing a successful DevOpsGen init run creating five files with exit code 0`,caption:`init — first run creates the complete baseline and exits 0.`}),(0,d.jsx)(f,{rel:e,name:`dry-run.png`,alt:`Terminal showing a DevOpsGen dry-run plan listing five create entries with exit code 0`,caption:`--dry-run on a fresh project prints the pure create plan and exits 0.`}),(0,d.jsx)(f,{rel:e,name:`dry-run-force.png`,alt:`Terminal showing a DevOpsGen dry-run force plan where every file would be replaced, exit code 0`,caption:`--dry-run --force previews the full replace plan — still nothing written.`})]}),(0,d.jsx)(`h2`,{children:`What gets generated`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Template set`}),(0,d.jsx)(`th`,{children:`Files`}),(0,d.jsx)(`th`,{children:`Purpose`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`docker`}),` (+ `,(0,d.jsx)(`code`,{children:`.dockerignore`}),`)`]}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`Dockerfile`})}),(0,d.jsxs)(`td`,{children:[`Hardened multi-stage build (Go runs as `,(0,d.jsx)(`code`,{children:`USER 1000:1000`}),` on a scratch base). For Node.js, RUN steps and install/prune commands follow the detected package manager (npm / pnpm) and lockfile. The generated `,(0,d.jsx)(`code`,{children:`.dockerignore`}),` `,`keeps state, tool caches and env files out of the image.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`github-actions`})}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.github/workflows/ci.yml`})}),(0,d.jsx)(`td`,{children:`Runs your tests when a test command is configured, then builds and pushes the image with both the commit SHA tag and your alias tag, authenticating to the chosen registry via secrets.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`kubernetes`})}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`deployment.yaml`}),`, `,(0,d.jsx)(`code`,{children:`service.yaml`}),`, optional `,(0,d.jsx)(`code`,{children:`ingress.yaml`})]}),(0,d.jsxs)(`td`,{children:[`DNS 1035-safe resource names, container port wiring, resource requests and limits, health probes when `,(0,d.jsx)(`code`,{children:`--health-path`}),` is given, and an optional host-based Ingress (RFC 1123 hostname).`]})]})]})]})}),(0,d.jsx)(`h2`,{children:`Explore the docs`}),(0,d.jsx)(`div`,{className:`cards core`,children:x.filter(e=>e.path!==``).map(t=>(0,d.jsxs)(`a`,{className:`card`,style:{display:`block`},href:`${e}${t.path}/`,children:[(0,d.jsx)(`h3`,{children:t.path.replace(/-/g,` `)}),(0,d.jsx)(`p`,{children:t.description})]},t.path))}),(0,d.jsx)(`h2`,{children:`Command cheatsheet`}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`help.png`,alt:`Terminal showing the full devopsgen help output listing all commands`,caption:`devopsgen --help — all commands at a glance.`}),(0,d.jsx)(f,{rel:e,name:`list.png`,alt:`Terminal showing the devopsgen list output with available stacks, app types and registries`,caption:`devopsgen list — supported stacks, app types and registries.`}),(0,d.jsx)(f,{rel:e,name:`version.png`,alt:`Terminal showing the devopsgen version output`,caption:`devopsgen version.`})]})]})}function v({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`getting started`,title:`Zero to CI in one command`,lede:`Install DevOpsGen, point it at any Go or Node.js project, and get a full Docker + GitHub Actions + Kubernetes baseline in seconds.`}),(0,d.jsx)(`h2`,{children:`Install`}),(0,d.jsx)(p,{label:`go install (go 1.22+)`,children:`go install devopsgen.dev/devopsgen@latest`}),(0,d.jsxs)(`p`,{children:[`Or grab a prebuilt binary from the project`,` `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen/releases`,target:`_blank`,rel:`noopener noreferrer`,children:`GitHub releases`}),`, or build from source:`]}),(0,d.jsx)(p,{label:`from source`,children:`git clone https://github.com/Bangkahdev/DevOpsGen.git cd DevOpsGen make build`}),(0,d.jsx)(`h2`,{children:`Two ways to run it`}),(0,d.jsxs)(`ul`,{className:`step-list`,children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Interactive:`}),` run `,(0,d.jsx)(`code`,{children:`devopsgen init`}),` in a terminal — the wizard detects your stack and interviews you step by step.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Headless:`}),` pass every required parameter as flags — the process never waits for stdin, which makes it script- and CI-friendly.`]})]}),(0,d.jsx)(`h2`,{children:`Headless quickstart`}),(0,d.jsx)(p,{label:`inside your project`,children:`devopsgen init --stack go --ci github-actions --registry ghcr --image you/myapp --port 8080`}),(0,d.jsx)(f,{rel:e,name:`init-success.png`,alt:`Terminal capture of devopsgen init completing successfully and reporting five files created`,caption:`A successful first run — five files created, exit code 0.`,feature:`shot-feature`}),(0,d.jsx)(`p`,{children:`Inside a Go project this writes:`}),(0,d.jsx)(p,{label:`what you get`,children:`.github/workflows/ci.yml # tests (when configured), docker build & push kubernetes/deployment.yaml # image, port, resources, optional probes kubernetes/service.yaml # cluster service for the app kubernetes/ingress.yaml # only with --ingress Dockerfile # hardened multi-stage build -.dockerignore # slim build context, secrets excluded`}),(0,d.jsxs)(`div`,{className:`callout`,children:[`Second runs are safe: DevOpsGen refuses to overwrite without `,(0,d.jsx)(`code`,{children:`--force`}),` and exits with code 3 — see `,(0,d.jsx)(`a`,{href:`${e}init/`,children:`the init reference`}),`.`]}),(0,d.jsx)(`h2`,{children:`Next steps`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Prefer point-and-press? Tour the `,(0,d.jsx)(`a`,{href:`${e}wizard/`,children:`interactive wizard`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Every `,(0,d.jsx)(`code`,{children:`init`}),` flag explained: `,(0,d.jsx)(`a`,{href:`${e}init/`,children:`init command`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Building your own CI around it? Read the `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]})]})]})}function y({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`interactive wizard`,title:`The TUI wizard`,lede:`When you run devopsgen init in a real terminal without a flags-only invocation, a keyboard-driven wizard takes over — Enter accepts the recommended default at every step.`}),(0,d.jsx)(f,{rel:e,name:`wizard.png`,alt:`DevOpsGen wizard TUI showing the stack selection list with a highlighted highlighted selection and instructions`,caption:`Step 1 — stack choice. DevOpsGen pre-selects what its detector recommends.`,feature:`shot-feature`}),(0,d.jsx)(`h2`,{children:`How the interview flows`}),(0,d.jsxs)(`ul`,{className:`step-list`,children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Stack`}),` — `,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`, pre-selected by the detector.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Application type`}),` (Node.js only) — express, nextjs, vite, nestjs or generic.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Commands`}),` — optional build / test / start commands; Enter keeps the defaults harvested from the project files.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Port`}),` — the application port, 1–65535, validated on the spot.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Registry`}),` — Docker Hub or GHCR (same as the`,` `,(0,d.jsx)(`code`,{children:`--registry`}),` flag).`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Container image`}),` — `,(0,d.jsx)(`code`,{children:`namespace/repository`}),`, no host, no tag.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Kubernetes`}),` — whether to emit manifests, plus an optional host-based`,` `,(0,d.jsx)(`strong`,{children:`Ingress`}),` (RFC 1123 hostname).`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Summary & confirm`}),` — review every chosen value, confirm, and the files are written to the project root.`]})]}),(0,d.jsxs)(`div`,{className:`callout callout-info`,children:[`A wizard run is fully replayable: the same answers as equivalent flags. To automate the same result, pass the flags headless (`,(0,d.jsx)(`a`,{href:`${e}init/`,children:`init reference`}),`).`]}),(0,d.jsx)(`h2`,{children:`Keyboard`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Key`}),(0,d.jsx)(`th`,{children:`Action`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(m,{children:`Enter`})}),(0,d.jsx)(`td`,{children:`Confirm current selection / printed default`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsxs)(`td`,{children:[(0,d.jsx)(m,{children:`↑`}),` `,(0,d.jsx)(m,{children:`↓`})]}),(0,d.jsx)(`td`,{children:`Move within list choices`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:`typed text`}),(0,d.jsx)(`td`,{children:`Fill textual answers (port, image, host)`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(m,{children:`Ctrl+C`})}),(0,d.jsx)(`td`,{children:`Abort the wizard without writing anything`})]})]})]})}),(0,d.jsx)(`h2`,{children:`Safety during the run`}),(0,d.jsxs)(`p`,{children:[`Everything until the final confirmation is bound to memory only — aborting leaves the project untouched. The write itself follows the same rules as headless mode: never-overwrite-unless-`,(0,d.jsx)(`code`,{children:`--force`}),`, backups, and rollback on mid-run failure.`]})]})}function b({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen init`,lede:`Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.`}),(0,d.jsx)(p,{label:`synopsis`,children:`devopsgen init [flags]`}),(0,d.jsx)(`h2`,{children:`Flags`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Flag`}),(0,d.jsx)(`th`,{children:`Default`}),(0,d.jsx)(`th`,{children:`Description`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--stack`}),(0,d.jsx)(`td`,{children:`auto-detected`}),(0,d.jsxs)(`td`,{children:[`Project stack: `,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--app-type`}),(0,d.jsx)(`td`,{children:`auto-detected`}),(0,d.jsxs)(`td`,{children:[`Application type (see `,(0,d.jsx)(`code`,{children:`devopsgen list`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ci`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`github-actions`})}),(0,d.jsx)(`td`,{children:`CI provider.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--registry`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`dockerhub`})}),(0,d.jsxs)(`td`,{children:[`Container registry: `,(0,d.jsx)(`code`,{children:`dockerhub`}),` or `,(0,d.jsx)(`code`,{children:`ghcr`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--image`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsxs)(`td`,{children:[`Image repository as `,(0,d.jsx)(`code`,{children:`namespace/repository`}),` — no host and no tag.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--tag`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`latest`})}),(0,d.jsx)(`td`,{children:`Additional image tag alias.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--port`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Application port, 1–65535.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--k8s`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`true`})}),(0,d.jsx)(`td`,{children:`Generate Kubernetes manifests.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ingress`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsxs)(`td`,{children:[`Enable Kubernetes Ingress (requires `,(0,d.jsx)(`code`,{children:`--ingress-host`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ingress-host`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Ingress hostname, validated as RFC 1123.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--health-path`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`HTTP health probe path wired into manifests.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--build-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Build command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--build-path`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.`})}),(0,d.jsx)(`td`,{children:`Go package path to build inside the container.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--start-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Startup command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--test-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Test command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--output-dir`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.`})}),(0,d.jsx)(`td`,{children:`Output directory.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--dry-run`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsx)(`td`,{children:`Simulate without writing anything.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--force`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsx)(`td`,{children:`Overwrite existing regular files.`})]})]})]})}),(0,d.jsx)(`h2`,{children:`Success & conflicts`}),(0,d.jsxs)(`p`,{children:[`A clean run writes every template and exits with`,` `,(0,d.jsx)(h,{tone:`ok`,children:`0`}),`. A second run over an existing project stops before touching anything and exits with `,(0,d.jsx)(h,{tone:`warn`,children:`3`}),` until you add `,(0,d.jsx)(`code`,{children:`--force`}),`:`]}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`init-success.png`,alt:`devopsgen init success output with exit code 0`,caption:`First run: five files created, exit code 0.`}),(0,d.jsx)(f,{rel:e,name:`init-conflict.png`,alt:`devopsgen init conflict error refusing to overwrite files with exit code 3`,caption:`Re-run without --force: exit code 3, zero files touched.`})]}),(0,d.jsx)(`h2`,{children:`Preview plans with --dry-run`}),(0,d.jsxs)(`p`,{children:[(0,d.jsx)(`code`,{children:`--dry-run`}),` prints the byte-plan: which files would be created, which would be replaced, and which are in conflict. With a conflict present it exits`,` `,(0,d.jsx)(h,{tone:`warn`,children:`3`}),`; combined with `,(0,d.jsx)(`code`,{children:`--force`}),` a fully green plan exits`,` `,(0,d.jsx)(h,{tone:`ok`,children:`0`}),` without writing anything:`]}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`dry-run.png`,alt:`devopsgen dry-run plan output showing replace and conflict entries with exit code 3`,caption:`--dry-run over an existing project: conflict entries, exit code 3.`}),(0,d.jsx)(f,{rel:e,name:`dry-run-force.png`,alt:`devopsgen dry-run force plan output where every file would be replaced, exit code 0`,caption:`--dry-run --force: every file replaced in plan form, exit code 0.`})]}),(0,d.jsx)(`h2`,{children:`Config validation`}),(0,d.jsxs)(`p`,{children:[`Invalid configuration fails fast with `,(0,d.jsx)(h,{tone:`err`,children:`2`}),` before any file is planned — e.g. an image that must be `,(0,d.jsx)(`code`,{children:`namespace/repository`}),` without host or tag, a port outside 1–65535, or an Ingress without a host:`]}),(0,d.jsx)(f,{rel:e,name:`invalid-config.png`,alt:`devopsgen init failing config validation on an invalid image with exit code 2`,caption:`Config errors exit with code 2 and never write files.`,feature:`shot-feature`}),(0,d.jsxs)(`div`,{className:`callout callout-ok`,children:[`Overwrites performed with `,(0,d.jsx)(`code`,{children:`--force`}),` keep the previous content as`,` `,(0,d.jsx)(`code`,{children:`.devopsgen.bak`}),` backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.`]})]})}function ee({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen detect`,lede:`Inspect the current project and report what DevOpsGen would scaffold for it: the programming stack, the exact files that shaped the decision, and the candidate application types.`}),(0,d.jsx)(f,{rel:e,name:`detect.png`,alt:`devopsgen detect output in a terminal reporting stack go with indicators go.mod`,caption:`devopsgen detect inside a Go module — chain of evidence straight from the filesystem.`,feature:`shot-feature`}),(0,d.jsx)(`h2`,{children:`Reading the output`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Line`}),(0,d.jsx)(`th`,{children:`Meaning`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`stack: go`})}),(0,d.jsxs)(`td`,{children:[`The detected programming stack (`,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`indicators: go.mod, ...`})}),(0,d.jsx)(`td`,{children:`The files that produced evidence — your audit trail for why the stack matched.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`app-type candidates: binary`})}),(0,d.jsx)(`td`,{children:`Application types plausible for this project; the wizard default comes from here too.`})]})]})]})}),(0,d.jsx)(`h2`,{children:`How it decides`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Go — `,(0,d.jsx)(`code`,{children:`go.mod`}),` and its module directive looking like`,` `,(0,d.jsx)(`code`,{children:`module example.com/app`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Node.js — `,(0,d.jsx)(`code`,{children:`package.json`}),`, plus its dependencies, and lockfile flavours (npm / pnpm) that later steer Docker image commands.`]}),(0,d.jsxs)(`li`,{children:[`Ambiguity or zero indicators produce a distinct exit code (5) so scripts can branch safely — see `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]})]}),(0,d.jsxs)(`div`,{className:`callout`,children:[`Detection semantics: DevOpsGen detects in the current working directory, not in`,` `,(0,d.jsx)(`code`,{children:`--output-dir`}),`. Run it from the project you want scanned.`]})]})}function te({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen validate`,lede:`Statically lint DevOpsGen output — Dockerfiles, GitHub Actions workflows and Kubernetes manifests — so problems surface on your laptop instead of pipeline number forty.`}),(0,d.jsx)(f,{rel:e,name:`validate.png`,alt:`devopsgen validate passing with the message internal validation passed and exit code 0`,caption:`Everything checks out — exit code 0.`,feature:`shot-feature`}),(0,d.jsx)(p,{label:`synopsis`,children:`devopsgen validate [flags] # validate the current project -devopsgen validate --output-dir ./configs`}),(0,d.jsx)(`h2`,{children:`What it checks`}),(0,d.jsxs)(`div`,{className:`cards`,children:[(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Docker`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`code`,{children:`FROM`}),` instruction is present`]}),(0,d.jsxs)(`li`,{children:[`no `,(0,d.jsx)(`code`,{children:`docker login`}),` (credentials) inside image builds`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`code`,{children:`COPY`}),`/`,(0,d.jsx)(`code`,{children:`ADD`}),` free of shell chaining (`,(0,d.jsx)(`code`,{children:`&&`}),`, `,(0,d.jsx)(`code`,{children:`||`}),`, `,(0,d.jsx)(`code`,{children:`2>/dev/null`}),`)`]})]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`GitHub Actions`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`parses as a single workflow document with `,(0,d.jsx)(`code`,{children:`name`}),`, `,(0,d.jsx)(`code`,{children:`on`}),`, `,(0,d.jsx)(`code`,{children:`jobs`}),` and steps`]}),(0,d.jsxs)(`li`,{children:[`a `,(0,d.jsx)(`code`,{children:`actions/checkout`}),` step exists`]}),(0,d.jsx)(`li`,{children:`the image push references the commit SHA tag`}),(0,d.jsx)(`li`,{children:`no unrendered template actions leak into the output`})]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Kubernetes`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Deployment: selector ↔ template label consistency, unique container names, integer `,(0,d.jsx)(`code`,{children:`containerPort`}),` in 1–65535`]}),(0,d.jsxs)(`li`,{children:[`Service: selector plus `,(0,d.jsx)(`code`,{children:`port`}),`/`,(0,d.jsx)(`code`,{children:`targetPort`}),` pairs`]}),(0,d.jsxs)(`li`,{children:[`Ingress: `,(0,d.jsx)(`code`,{children:`networking.k8s.io/v1`}),`, valid `,(0,d.jsx)(`code`,{children:`pathType`}),`, wired `,(0,d.jsx)(`code`,{children:`backend.service`})]}),(0,d.jsx)(`li`,{children:`Service ↔ Ingress backends stay consistent`})]})]})]}),(0,d.jsx)(`h2`,{children:`Exit behaviour`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`ok`,children:`0`}),` — all documents passed.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`err`,children:`4`}),` — a document failed lint rules, does not parse, or required artifacts are missing.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`warn`,children:`1`}),` — the output directory itself could not be read.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`err`,children:`2`}),` — malformed input (invalid flags).`]})]}),(0,d.jsxs)(`p`,{children:[`Combine with `,(0,d.jsx)(`code`,{children:`devopsgen init`}),` in CI: generate, commit, validate, deploy — the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),` page maps every failure class.`]}),(0,d.jsxs)(`p`,{children:[`Combine with `,(0,d.jsx)(`code`,{children:`devopsgen init`}),` in CI: generate, commit, validate, deploy — the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),` page maps every failure class.`]})]})}function ne({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`ci integration`,title:`Exit codes`,lede:`Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Code`}),(0,d.jsx)(`th`,{children:`Classification`}),(0,d.jsx)(`th`,{children:`Meaning`}),(0,d.jsx)(`th`,{children:`Typical example`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`0`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-ok`,children:`success`})}),(0,d.jsx)(`td`,{children:`Everything requested completed; dry-run plans that resolved cleanly also end here.`}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`init`}),` created 5 files; `,(0,d.jsx)(`code`,{children:`--dry-run --force`}),` plan is green.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`1`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`general error`})}),(0,d.jsx)(`td`,{children:`Unexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.`}),(0,d.jsxs)(`td`,{children:[`Disk full while writing `,(0,d.jsx)(`code`,{children:`deployment.yaml`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`2`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`invalid input`})}),(0,d.jsx)(`td`,{children:`Configuration failed validation before anything was planned or written.`}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`--image BANGKAH/my-app`}),`; port `,(0,d.jsx)(`code`,{children:`-1`}),`; Ingress without host.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`3`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-warn`,children:`conflict`})}),(0,d.jsxs)(`td`,{children:[`Target files already exist and would be overwritten; nothing was written. Retried with `,(0,d.jsx)(`code`,{children:`--force`}),`.`]}),(0,d.jsxs)(`td`,{children:[`Second `,(0,d.jsx)(`code`,{children:`init`}),` without `,(0,d.jsx)(`code`,{children:`--force`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`4`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`validation failed`})}),(0,d.jsx)(`td`,{children:`Rejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.`}),(0,d.jsx)(`td`,{children:`A workflow that never publishes the commit SHA tag.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`5`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-warn`,children:`detection`})}),(0,d.jsx)(`td`,{children:`Stack detection was ambiguous or found nothing at all.`}),(0,d.jsxs)(`td`,{children:[`Empty directory without `,(0,d.jsx)(`code`,{children:`go.mod`}),` / `,(0,d.jsx)(`code`,{children:`package.json`}),`.`]})]})]})]})}),(0,d.jsx)(`h2`,{children:`In practice`}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`invalid-config.png`,alt:`devopsgen exiting with code 2 after failing image validation`,caption:`Exit 2 — config rejected before planning.`}),(0,d.jsx)(f,{rel:e,name:`init-conflict.png`,alt:`devopsgen exiting with code 3 on existing files`,caption:`Exit 3 — conflict, nothing written.`})]}),(0,d.jsx)(p,{label:`shell script branching`,children:`devopsgen init --stack go --registry ghcr --image you/myapp --port 8080 +.dockerignore # slim build context, secrets excluded`}),(0,d.jsxs)(`div`,{className:`callout`,children:[`Second runs are safe: DevOpsGen refuses to overwrite without `,(0,d.jsx)(`code`,{children:`--force`}),` and exits with code 3 — see `,(0,d.jsx)(`a`,{href:`${e}init/`,children:`the init reference`}),`.`]}),(0,d.jsx)(`h2`,{children:`Next steps`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Prefer point-and-press? Tour the `,(0,d.jsx)(`a`,{href:`${e}wizard/`,children:`interactive wizard`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Every `,(0,d.jsx)(`code`,{children:`init`}),` flag explained: `,(0,d.jsx)(`a`,{href:`${e}init/`,children:`init command`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Building your own CI around it? Read the `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]})]})]})}function y({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`interactive wizard`,title:`The TUI wizard`,lede:`When you run devopsgen init in a real terminal without a flags-only invocation, a keyboard-driven wizard takes over — Enter accepts the recommended default at every step.`}),(0,d.jsx)(f,{rel:e,name:`wizard.png`,alt:`DevOpsGen wizard TUI showing the stack selection list with a highlighted highlighted selection and instructions`,caption:`Step 1 — stack choice. DevOpsGen pre-selects what its detector recommends.`,feature:`shot-feature`}),(0,d.jsx)(`h2`,{children:`How the interview flows`}),(0,d.jsxs)(`ul`,{className:`step-list`,children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Stack`}),` — `,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`, pre-selected by the detector.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Application type`}),` (Node.js only) — express, nextjs, vite, nestjs or generic.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Commands`}),` — optional build / test / start commands; Enter keeps the defaults harvested from the project files.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Port`}),` — the application port, 1–65535, validated on the spot.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Registry`}),` — Docker Hub or GHCR (same as the`,` `,(0,d.jsx)(`code`,{children:`--registry`}),` flag).`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Container image`}),` — `,(0,d.jsx)(`code`,{children:`namespace/repository`}),`, no host, no tag.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Kubernetes`}),` — whether to emit manifests, plus an optional host-based`,` `,(0,d.jsx)(`strong`,{children:`Ingress`}),` (RFC 1123 hostname).`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`strong`,{children:`Summary & confirm`}),` — review every chosen value, confirm, and the files are written to the project root.`]})]}),(0,d.jsxs)(`div`,{className:`callout callout-info`,children:[`A wizard run is fully replayable: the same answers as equivalent flags. To automate the same result, pass the flags headless (`,(0,d.jsx)(`a`,{href:`${e}init/`,children:`init reference`}),`).`]}),(0,d.jsx)(`h2`,{children:`Keyboard`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Key`}),(0,d.jsx)(`th`,{children:`Action`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(m,{children:`Enter`})}),(0,d.jsx)(`td`,{children:`Confirm current selection / printed default`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsxs)(`td`,{children:[(0,d.jsx)(m,{children:`↑`}),` `,(0,d.jsx)(m,{children:`↓`})]}),(0,d.jsx)(`td`,{children:`Move within list choices`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:`typed text`}),(0,d.jsx)(`td`,{children:`Fill textual answers (port, image, host)`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(m,{children:`Ctrl+C`})}),(0,d.jsx)(`td`,{children:`Abort the wizard without writing anything`})]})]})]})}),(0,d.jsx)(`h2`,{children:`Safety during the run`}),(0,d.jsxs)(`p`,{children:[`Everything until the final confirmation is bound to memory only — aborting leaves the project untouched. The write itself follows the same rules as headless mode: never-overwrite-unless-`,(0,d.jsx)(`code`,{children:`--force`}),`, backups, and rollback on mid-run failure.`]})]})}function b({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen init`,lede:`Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.`}),(0,d.jsx)(p,{label:`synopsis`,children:`devopsgen init [flags]`}),(0,d.jsx)(`h2`,{children:`Flags`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Flag`}),(0,d.jsx)(`th`,{children:`Default`}),(0,d.jsx)(`th`,{children:`Description`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--stack`}),(0,d.jsx)(`td`,{children:`auto-detected`}),(0,d.jsxs)(`td`,{children:[`Project stack: `,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--app-type`}),(0,d.jsx)(`td`,{children:`auto-detected`}),(0,d.jsxs)(`td`,{children:[`Application type (see `,(0,d.jsx)(`code`,{children:`devopsgen list`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ci`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`github-actions`})}),(0,d.jsx)(`td`,{children:`CI provider.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--registry`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`dockerhub`})}),(0,d.jsxs)(`td`,{children:[`Container registry: `,(0,d.jsx)(`code`,{children:`dockerhub`}),` or `,(0,d.jsx)(`code`,{children:`ghcr`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--image`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsxs)(`td`,{children:[`Image repository as `,(0,d.jsx)(`code`,{children:`namespace/repository`}),` — no host and no tag.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--tag`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`latest`})}),(0,d.jsx)(`td`,{children:`Additional image tag alias.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--port`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Application port, 1–65535.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--k8s`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`true`})}),(0,d.jsx)(`td`,{children:`Generate Kubernetes manifests.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ingress`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsxs)(`td`,{children:[`Enable Kubernetes Ingress (requires `,(0,d.jsx)(`code`,{children:`--ingress-host`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--ingress-host`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Ingress hostname, validated as RFC 1123.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--health-path`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`HTTP health probe path wired into manifests.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--build-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Build command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--build-path`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.`})}),(0,d.jsx)(`td`,{children:`Go package path to build inside the container.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--start-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Startup command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--test-cmd`}),(0,d.jsx)(`td`,{children:`—`}),(0,d.jsx)(`td`,{children:`Test command.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--output-dir`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`.`})}),(0,d.jsx)(`td`,{children:`Output directory.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--dry-run`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsx)(`td`,{children:`Simulate without writing anything.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`flag-name`,children:`--force`}),(0,d.jsx)(`td`,{children:`off`}),(0,d.jsx)(`td`,{children:`Overwrite existing regular files.`})]})]})]})}),(0,d.jsx)(`h2`,{children:`Success & conflict behaviour`}),(0,d.jsxs)(`p`,{children:[`A clean run writes every template and exits with`,` `,(0,d.jsx)(h,{tone:`ok`,children:`0`}),`. A second run over an existing project stops before touching anything and exits with `,(0,d.jsx)(h,{tone:`warn`,children:`3`}),` until you add `,(0,d.jsx)(`code`,{children:`--force`}),`; a detailed walkthrough of that re-run path is on the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes page`}),`.`]}),(0,d.jsx)(f,{rel:e,name:`init-success.png`,alt:`devopsgen init success output with exit code 0`,caption:`First run: five files created, exit code 0.`,feature:`shot-feature`}),(0,d.jsx)(`h2`,{children:`Preview plans with --dry-run`}),(0,d.jsxs)(`p`,{children:[(0,d.jsx)(`code`,{children:`--dry-run`}),` prints the byte-plan and writes nothing. On a fresh project it lists pure `,(0,d.jsx)(`code`,{children:`create`}),` rows and exits`,` `,(0,d.jsx)(h,{tone:`ok`,children:`0`}),`; combined with `,(0,d.jsx)(`code`,{children:`--force`}),` over an existing project it lists the exact files that would be `,(0,d.jsx)(`code`,{children:`replace`}),`d — still`,` `,(0,d.jsx)(h,{tone:`ok`,children:`0`}),`:`]}),(0,d.jsxs)(`div`,{className:`screen-strip`,children:[(0,d.jsx)(f,{rel:e,name:`dry-run.png`,alt:`devopsgen dry-run plan output showing five create entries with exit code 0`,caption:`--dry-run on a fresh project: pure create plan, exit code 0.`}),(0,d.jsx)(f,{rel:e,name:`dry-run-force.png`,alt:`devopsgen dry-run force plan output where every file would be replaced, exit code 0`,caption:`--dry-run --force: every file replaced in plan form, exit code 0.`})]}),(0,d.jsx)(`h2`,{children:`Config validation`}),(0,d.jsxs)(`p`,{children:[`Invalid configuration fails fast with `,(0,d.jsx)(h,{tone:`err`,children:`2`}),` before any file is planned and never writes files — e.g. an image that must be`,` `,(0,d.jsx)(`code`,{children:`namespace/repository`}),` without host or tag, a port outside 1–65535, or an Ingress without a host. The full code table lives on the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes page`}),`.`]}),(0,d.jsxs)(`div`,{className:`callout callout-ok`,children:[`Overwrites performed with `,(0,d.jsx)(`code`,{children:`--force`}),` keep the previous content as`,` `,(0,d.jsx)(`code`,{children:`.devopsgen.bak`}),` backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.`]})]})}function ee({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen detect`,lede:`Inspect the current project and report what DevOpsGen would scaffold for it: the programming stack, the exact files that shaped the decision, and the candidate application types.`}),(0,d.jsx)(f,{rel:e,name:`detect.png`,alt:`devopsgen detect output in a terminal reporting stack go with indicators go.mod`,caption:`devopsgen detect inside a Go module — chain of evidence straight from the filesystem.`,feature:`shot-feature`}),(0,d.jsx)(`h2`,{children:`Reading the output`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Line`}),(0,d.jsx)(`th`,{children:`Meaning`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`stack: go`})}),(0,d.jsxs)(`td`,{children:[`The detected programming stack (`,(0,d.jsx)(`code`,{children:`go`}),` or `,(0,d.jsx)(`code`,{children:`nodejs`}),`).`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`indicators: go.mod, ...`})}),(0,d.jsx)(`td`,{children:`The files that produced evidence — your audit trail for why the stack matched.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{children:(0,d.jsx)(`code`,{children:`app-type candidates: binary`})}),(0,d.jsx)(`td`,{children:`Application types plausible for this project; the wizard default comes from here too.`})]})]})]})}),(0,d.jsx)(`h2`,{children:`How it decides`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Go — `,(0,d.jsx)(`code`,{children:`go.mod`}),` and its module directive looking like`,` `,(0,d.jsx)(`code`,{children:`module example.com/app`}),`.`]}),(0,d.jsxs)(`li`,{children:[`Node.js — `,(0,d.jsx)(`code`,{children:`package.json`}),`, plus its dependencies, and lockfile flavours (npm / pnpm) that later steer Docker image commands.`]}),(0,d.jsxs)(`li`,{children:[`Ambiguity or zero indicators produce a distinct exit code (5) so scripts can branch safely — see `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]})]}),(0,d.jsxs)(`div`,{className:`callout`,children:[`Detection semantics: DevOpsGen detects in the current working directory, not in`,` `,(0,d.jsx)(`code`,{children:`--output-dir`}),`. Run it from the project you want scanned.`]})]})}function te({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`command reference`,title:`devopsgen validate`,lede:`Statically lint DevOpsGen output — Dockerfiles, GitHub Actions workflows and Kubernetes manifests — so problems surface on your laptop instead of pipeline number forty.`}),(0,d.jsx)(f,{rel:e,name:`validate.png`,alt:`devopsgen validate passing with the message internal validation passed and exit code 0`,caption:`Everything checks out — exit code 0.`,feature:`shot-feature`}),(0,d.jsx)(p,{label:`synopsis`,children:`devopsgen validate [flags] # validate the current project +devopsgen validate --output-dir ./configs`}),(0,d.jsx)(`h2`,{children:`What it checks`}),(0,d.jsxs)(`div`,{className:`cards`,children:[(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Docker`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`code`,{children:`FROM`}),` instruction is present`]}),(0,d.jsxs)(`li`,{children:[`no `,(0,d.jsx)(`code`,{children:`docker login`}),` (credentials) inside image builds`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(`code`,{children:`COPY`}),`/`,(0,d.jsx)(`code`,{children:`ADD`}),` free of shell chaining (`,(0,d.jsx)(`code`,{children:`&&`}),`, `,(0,d.jsx)(`code`,{children:`||`}),`, `,(0,d.jsx)(`code`,{children:`2>/dev/null`}),`)`]})]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`GitHub Actions`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`parses as a single workflow document with `,(0,d.jsx)(`code`,{children:`name`}),`, `,(0,d.jsx)(`code`,{children:`on`}),`, `,(0,d.jsx)(`code`,{children:`jobs`}),` and steps`]}),(0,d.jsxs)(`li`,{children:[`a `,(0,d.jsx)(`code`,{children:`actions/checkout`}),` step exists`]}),(0,d.jsx)(`li`,{children:`the image push references the commit SHA tag`}),(0,d.jsx)(`li`,{children:`no unrendered template actions leak into the output`})]})]}),(0,d.jsxs)(`div`,{className:`card`,children:[(0,d.jsx)(`h3`,{children:`Kubernetes`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[`Deployment: selector ↔ template label consistency, unique container names, integer `,(0,d.jsx)(`code`,{children:`containerPort`}),` in 1–65535`]}),(0,d.jsxs)(`li`,{children:[`Service: selector plus `,(0,d.jsx)(`code`,{children:`port`}),`/`,(0,d.jsx)(`code`,{children:`targetPort`}),` pairs`]}),(0,d.jsxs)(`li`,{children:[`Ingress: `,(0,d.jsx)(`code`,{children:`networking.k8s.io/v1`}),`, valid `,(0,d.jsx)(`code`,{children:`pathType`}),`, wired `,(0,d.jsx)(`code`,{children:`backend.service`})]}),(0,d.jsx)(`li`,{children:`Service ↔ Ingress backends stay consistent`})]})]})]}),(0,d.jsx)(`h2`,{children:`Exit behaviour`}),(0,d.jsxs)(`ul`,{children:[(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`ok`,children:`0`}),` — all documents passed.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`err`,children:`4`}),` — a document failed lint rules, does not parse, or required artifacts are missing.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`warn`,children:`1`}),` — the output directory itself could not be read.`]}),(0,d.jsxs)(`li`,{children:[(0,d.jsx)(h,{tone:`err`,children:`2`}),` — malformed input (invalid flags).`]})]}),(0,d.jsxs)(`p`,{children:[`Combine with `,(0,d.jsx)(`code`,{children:`devopsgen init`}),` in CI: generate, commit, validate, deploy — the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),` page maps every failure class.`]}),(0,d.jsxs)(`p`,{children:[`Combine with `,(0,d.jsx)(`code`,{children:`devopsgen init`}),` in CI: generate, commit, validate, deploy — the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),` page maps every failure class.`]})]})}function ne({rel:e}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(g,{kicker:`ci integration`,title:`Exit codes`,lede:`Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.`}),(0,d.jsx)(`div`,{className:`table-wrap`,children:(0,d.jsxs)(`table`,{children:[(0,d.jsx)(`thead`,{children:(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`th`,{children:`Code`}),(0,d.jsx)(`th`,{children:`Classification`}),(0,d.jsx)(`th`,{children:`Meaning`}),(0,d.jsx)(`th`,{children:`Typical example`})]})}),(0,d.jsxs)(`tbody`,{children:[(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`0`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-ok`,children:`success`})}),(0,d.jsx)(`td`,{children:`Everything requested completed; dry-run plans that resolved cleanly also end here.`}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`init`}),` created 5 files; `,(0,d.jsx)(`code`,{children:`--dry-run --force`}),` plan is green.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`1`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`general error`})}),(0,d.jsx)(`td`,{children:`Unexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.`}),(0,d.jsxs)(`td`,{children:[`Disk full while writing `,(0,d.jsx)(`code`,{children:`deployment.yaml`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`2`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`invalid input`})}),(0,d.jsx)(`td`,{children:`Configuration failed validation before anything was planned or written.`}),(0,d.jsxs)(`td`,{children:[(0,d.jsx)(`code`,{children:`--image BANGKAH/my-app`}),`; port `,(0,d.jsx)(`code`,{children:`-1`}),`; Ingress without host.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`3`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-warn`,children:`conflict`})}),(0,d.jsxs)(`td`,{children:[`Target files already exist and would be overwritten; nothing was written. Retried with `,(0,d.jsx)(`code`,{children:`--force`}),`.`]}),(0,d.jsxs)(`td`,{children:[`Second `,(0,d.jsx)(`code`,{children:`init`}),` without `,(0,d.jsx)(`code`,{children:`--force`}),`.`]})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`4`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-err`,children:`validation failed`})}),(0,d.jsx)(`td`,{children:`Rejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.`}),(0,d.jsx)(`td`,{children:`A workflow that never publishes the commit SHA tag.`})]}),(0,d.jsxs)(`tr`,{children:[(0,d.jsx)(`td`,{className:`num`,children:`5`}),(0,d.jsx)(`td`,{children:(0,d.jsx)(`span`,{className:`badge badge-warn`,children:`detection`})}),(0,d.jsx)(`td`,{children:`Stack detection was ambiguous or found nothing at all.`}),(0,d.jsxs)(`td`,{children:[`Empty directory without `,(0,d.jsx)(`code`,{children:`go.mod`}),` / `,(0,d.jsx)(`code`,{children:`package.json`}),`.`]})]})]})]})}),(0,d.jsx)(`h2`,{children:`In practice`}),(0,d.jsx)(f,{rel:e,name:`validate.png`,alt:`devopsgen validate reporting internal validation passed with exit code 0`,caption:`Exit 0 — internal validation passed.`,feature:`shot-feature`}),(0,d.jsx)(p,{label:`shell script branching`,children:`devopsgen init --stack go --registry ghcr --image you/myapp --port 8080 case $? in 0) echo "ready" ;; 3) devopsgen init --force --stack go --registry ghcr --image you/myapp --port 8080 ;; 2) echo "fix your flags" >&2 ;; *) echo "see devopsgen validate output" >&2 ;; -esac`}),(0,d.jsx)(`div`,{className:`callout callout-info`,children:`Codes are part of DevOpsGen's compatibility promise: bumping a major version may add new codes, but existing ones keep their meaning.`})]})}var re=`https://bangkahdev.github.io/DevOpsGen/`,x=[{path:``,component:_,title:`DevOpsGen — DevOps scaffolding for Go & Node.js projects`,description:`DevOpsGen generates production-ready Dockerfiles, GitHub Actions pipelines and Kubernetes manifests for Go and Node.js projects, with safe dry-run plans, automatic backups and config validation.`,keywords:`DevOpsGen, dockerfile generator, github actions generator, kubernetes manifests, go, nodejs, scaffolding, ci cd`,ogImage:`img/init-success.png`},{path:`getting-started`,component:v,title:`Getting Started — DevOpsGen Docs`,description:`Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.`,keywords:`DevOpsGen install, go install, quickstart, getting started`,ogImage:`img/init-success.png`},{path:`wizard`,component:y,title:`Interactive Wizard — DevOpsGen Docs`,description:`DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.`,keywords:`DevOpsGen wizard, tui, bubbletea, interactive`,ogImage:`img/wizard.png`},{path:`init`,component:b,title:`init command — DevOpsGen Docs`,description:`Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.`,keywords:`devopsgen init, flags, dry-run, force, image, ingress`,ogImage:`img/init-success.png`},{path:`detect`,component:ee,title:`detect command — DevOpsGen Docs`,description:`devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.`,keywords:`devopsgen detect, stack detection, go.mod, package.json`,ogImage:`img/detect.png`},{path:`validate`,component:te,title:`validate command — DevOpsGen Docs`,description:`devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.`,keywords:`devopsgen validate, dockerfile lint, workflow lint, kubernetes manifest lint`,ogImage:`img/validate.png`},{path:`exit-codes`,component:ne,title:`Exit codes — DevOpsGen Docs`,description:`Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.`,keywords:`devopsgen exit codes, ci integration, pipeline status`,ogImage:`img/invalid-config.png`}],ie=[{label:`Overview`,items:[`getting-started`,`wizard`]},{label:`Command reference`,items:[`init`,`detect`,`validate`]},{label:`Operations`,items:[`exit-codes`]}];function S({rel:e,activePath:t,children:n}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(`a`,{className:`skip`,href:`#main`,children:`skip to content`}),(0,d.jsxs)(`header`,{className:`topbar`,children:[(0,d.jsxs)(`a`,{className:`brand`,href:e||`./`,children:[(0,d.jsx)(`span`,{className:`brand-mark`,children:`DG`}),(0,d.jsx)(`span`,{className:`brand-name`,children:`DevOpsGen`}),(0,d.jsx)(`span`,{className:`brand-sub`,children:`DOCS`})]}),(0,d.jsx)(`a`,{className:`gh-pill`,href:`https://github.com/Bangkahdev/DevOpsGen`,rel:`noopener noreferrer`,target:`_blank`,children:`GitHub`})]}),(0,d.jsxs)(`div`,{className:`shell`,children:[(0,d.jsxs)(`aside`,{className:`sidebar`,"aria-label":`Documentation navigation`,children:[(0,d.jsx)(`a`,{className:`side-link side-home${t===``?` is-active`:``}`,href:e||`./`,children:`Home`}),ie.map(n=>(0,d.jsxs)(`div`,{className:`side-group`,children:[(0,d.jsx)(`p`,{className:`group-label`,children:n.label}),(0,d.jsx)(`ul`,{children:n.items.map(n=>{let r=x.find(e=>e.path===n);return(0,d.jsx)(`li`,{children:(0,d.jsx)(`a`,{className:`side-link${t===n?` is-active`:``}`,href:`${e}${n}/`,"aria-current":t===n?`page`:void 0,children:r?r.path.replace(/-/g,` `):n})},n)})})]},n.label))]}),(0,d.jsx)(`main`,{id:`main`,children:n})]}),(0,d.jsxs)(`footer`,{className:`footer`,children:[(0,d.jsxs)(`p`,{children:[`DevOpsGen — deterministic DevOps scaffolding for Go & Node.js.`,` `,(0,d.jsx)(`a`,{href:`${e}getting-started/`,children:`Get started`}),` or browse the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]}),(0,d.jsxs)(`p`,{className:`footer-links`,children:[(0,d.jsx)(`a`,{href:re,children:`canonical site`}),` · `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen`,children:`source code`})]})]})]})}var ae=x.find(e=>e.path===location.pathname.replace(/\/$/,``).replace(/^.*\//,``))??null,oe=ae&&ae.path===``?``:`../`,se=ae??x[0];(0,l.createRoot)(document.getElementById(`root`)).render((0,d.jsx)(S,{rel:oe,activePath:ae?ae.path:``,children:(0,d.jsx)(se.component,{rel:oe})})); \ No newline at end of file +esac`}),(0,d.jsx)(`div`,{className:`callout callout-info`,children:`Codes are part of DevOpsGen's compatibility promise: bumping a major version may add new codes, but existing ones keep their meaning.`})]})}var re=`https://bangkahdev.github.io/DevOpsGen/`,x=[{path:``,component:_,title:`DevOpsGen — DevOps scaffolding for Go & Node.js projects`,description:`DevOpsGen generates production-ready Dockerfiles, GitHub Actions pipelines and Kubernetes manifests for Go and Node.js projects, with safe dry-run plans, automatic backups and config validation.`,keywords:`DevOpsGen, dockerfile generator, github actions generator, kubernetes manifests, go, nodejs, scaffolding, ci cd`,ogImage:`img/init-success.png`},{path:`getting-started`,component:v,title:`Getting Started — DevOpsGen Docs`,description:`Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.`,keywords:`DevOpsGen install, go install, quickstart, getting started`,ogImage:`img/init-success.png`},{path:`wizard`,component:y,title:`Interactive Wizard — DevOpsGen Docs`,description:`DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.`,keywords:`DevOpsGen wizard, tui, bubbletea, interactive`,ogImage:`img/wizard.png`},{path:`init`,component:b,title:`init command — DevOpsGen Docs`,description:`Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.`,keywords:`devopsgen init, flags, dry-run, force, image, ingress`,ogImage:`img/init-success.png`},{path:`detect`,component:ee,title:`detect command — DevOpsGen Docs`,description:`devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.`,keywords:`devopsgen detect, stack detection, go.mod, package.json`,ogImage:`img/detect.png`},{path:`validate`,component:te,title:`validate command — DevOpsGen Docs`,description:`devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.`,keywords:`devopsgen validate, dockerfile lint, workflow lint, kubernetes manifest lint`,ogImage:`img/validate.png`},{path:`exit-codes`,component:ne,title:`Exit codes — DevOpsGen Docs`,description:`Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.`,keywords:`devopsgen exit codes, ci integration, pipeline status`,ogImage:`img/validate.png`}],ie=[{label:`Overview`,items:[`getting-started`,`wizard`]},{label:`Command reference`,items:[`init`,`detect`,`validate`]},{label:`Operations`,items:[`exit-codes`]}];function S({rel:e,activePath:t,children:n}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(`a`,{className:`skip`,href:`#main`,children:`skip to content`}),(0,d.jsxs)(`header`,{className:`topbar`,children:[(0,d.jsxs)(`a`,{className:`brand`,href:e||`./`,children:[(0,d.jsx)(`span`,{className:`brand-mark`,children:`DG`}),(0,d.jsx)(`span`,{className:`brand-name`,children:`DevOpsGen`}),(0,d.jsx)(`span`,{className:`brand-sub`,children:`DOCS`})]}),(0,d.jsx)(`a`,{className:`gh-pill`,href:`https://github.com/Bangkahdev/DevOpsGen`,rel:`noopener noreferrer`,target:`_blank`,children:`GitHub`})]}),(0,d.jsxs)(`div`,{className:`shell`,children:[(0,d.jsxs)(`aside`,{className:`sidebar`,"aria-label":`Documentation navigation`,children:[(0,d.jsx)(`a`,{className:`side-link side-home${t===``?` is-active`:``}`,href:e||`./`,children:`Home`}),ie.map(n=>(0,d.jsxs)(`div`,{className:`side-group`,children:[(0,d.jsx)(`p`,{className:`group-label`,children:n.label}),(0,d.jsx)(`ul`,{children:n.items.map(n=>{let r=x.find(e=>e.path===n);return(0,d.jsx)(`li`,{children:(0,d.jsx)(`a`,{className:`side-link${t===n?` is-active`:``}`,href:`${e}${n}/`,"aria-current":t===n?`page`:void 0,children:r?r.path.replace(/-/g,` `):n})},n)})})]},n.label))]}),(0,d.jsx)(`main`,{id:`main`,children:n})]}),(0,d.jsxs)(`footer`,{className:`footer`,children:[(0,d.jsxs)(`p`,{children:[`DevOpsGen — deterministic DevOps scaffolding for Go & Node.js.`,` `,(0,d.jsx)(`a`,{href:`${e}getting-started/`,children:`Get started`}),` or browse the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]}),(0,d.jsxs)(`p`,{className:`footer-links`,children:[(0,d.jsx)(`a`,{href:re,children:`canonical site`}),` · `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen`,children:`source code`})]})]})]})}var ae=x.find(e=>e.path===location.pathname.replace(/\/$/,``).replace(/^.*\//,``))??null,oe=ae&&ae.path===``?``:`../`,se=ae??x[0];(0,l.createRoot)(document.getElementById(`root`)).render((0,d.jsx)(S,{rel:oe,activePath:ae?ae.path:``,children:(0,d.jsx)(se.component,{rel:oe})})); \ No newline at end of file diff --git a/docs/web/dist/exit-codes/index.html b/docs/web/dist/exit-codes/index.html index 260969d..984bd7e 100644 --- a/docs/web/dist/exit-codes/index.html +++ b/docs/web/dist/exit-codes/index.html @@ -12,16 +12,16 @@ - + - + -
DGDevOpsGenDOCSGitHub

ci integration

Exit codes

Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.

CodeClassificationMeaningTypical example
0successEverything requested completed; dry-run plans that resolved cleanly also end here.init created 5 files; --dry-run --force plan is green.
1general errorUnexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.Disk full while writing deployment.yaml.
2invalid inputConfiguration failed validation before anything was planned or written.--image BANGKAH/my-app; port -1; Ingress without host.
3conflictTarget files already exist and would be overwritten; nothing was written. Retried with --force.Second init without --force.
4validation failedRejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.A workflow that never publishes the commit SHA tag.
5detectionStack detection was ambiguous or found nothing at all.Empty directory without go.mod / package.json.

In practice

devopsgen exiting with code 2 after failing image validation
Exit 2 — config rejected before planning.
devopsgen exiting with code 3 on existing files
Exit 3 — conflict, nothing written.
shell script branching
devopsgen init --stack go --registry ghcr --image you/myapp --port 8080
+
DGDevOpsGenDOCSGitHub
ci integration
Exit codes
Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.
CodeClassificationMeaningTypical example
0successEverything requested completed; dry-run plans that resolved cleanly also end here.init created 5 files; --dry-run --force plan is green.
1general errorUnexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.Disk full while writing deployment.yaml.
2invalid inputConfiguration failed validation before anything was planned or written.--image BANGKAH/my-app; port -1; Ingress without host.
3conflictTarget files already exist and would be overwritten; nothing was written. Retried with --force.Second init without --force.
4validation failedRejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.A workflow that never publishes the commit SHA tag.
5detectionStack detection was ambiguous or found nothing at all.Empty directory without go.mod / package.json.
In practice
devopsgen validate reporting internal validation passed with exit code 0
Exit 0 — internal validation passed.
shell script branching
devopsgen init --stack go --registry ghcr --image you/myapp --port 8080
 case $? in
   0) echo "ready" ;;
   3) devopsgen init --force --stack go --registry ghcr --image you/myapp --port 8080 ;;
diff --git a/docs/web/dist/img/dry-run.png b/docs/web/dist/img/dry-run.png
index 239b232..48723f8 100644
Binary files a/docs/web/dist/img/dry-run.png and b/docs/web/dist/img/dry-run.png differ
diff --git a/docs/web/dist/img/init-conflict.png b/docs/web/dist/img/init-conflict.png
deleted file mode 100644
index 5bc87d0..0000000
Binary files a/docs/web/dist/img/init-conflict.png and /dev/null differ
diff --git a/docs/web/dist/img/invalid-config.png b/docs/web/dist/img/invalid-config.png
deleted file mode 100644
index 15681aa..0000000
Binary files a/docs/web/dist/img/invalid-config.png and /dev/null differ
diff --git a/docs/web/dist/index.html b/docs/web/dist/index.html
index 761f54a..4581a33 100644
--- a/docs/web/dist/index.html
+++ b/docs/web/dist/index.html
@@ -23,6 +23,6 @@
 
 
DGDevOpsGenDOCSGitHub
docker · github actions · kubernetes
DevOps scaffolding,
deterministically.
DevOpsGen reads your Go or Node.js project and writes a complete, opinionated DevOps baseline: hardened Dockerfile, GitHub Actions pipeline and ready-to-apply Kubernetes manifests — with dry-run plans, automatic backups and config validation built in.
Get startedTake the wizard tour
DevOpsGen interactive wizard running in a Windows terminal, asking for the project stack
The interactive wizard — press Enter to accept smart defaults.
Why DevOpsGen
Deterministic
Same inputs, same bytes — every run. Machine-friendly for code review: a second generation with --force produces bit-identical files.
Safe by default
Existing files are never overwritten without --force. Overwrites get .bak backups, failed runs roll back automatically, and --dry-run prints the full plan first.
Validated output
Built-in validation checks Dockerfile structure, GitHub Actions workflow wiring and Kubernetes manifests (selector consistency, port ranges, Ingress paths) before anything ships.
Stack aware
Detects Go and Node.js projects (npm, pnpm, Express, Next.js, Vite, NestJS) from go.mod / package.json and tailors templates accordingly.
Everything a project needs on day one
One init command writes the whole baseline tree. Preview the real terminal output of every command below — all screenshots are live captures, not mockups.
generated in one command
$ devopsgen init --stack go --ci github-actions --registry ghcr --image you/myapp --port 8080
 created 5 file(s), replaced 0 file(s) in .
-exit code: 0
Terminal showing a successful DevOpsGen init run creating five files with exit code 0
init — first run creates the complete baseline and exits 0.
Terminal showing DevOpsGen refusing to overwrite five files and exiting with code 3
init on a second run refuses to overwrite files — exit code 3 without --force.
Terminal showing a DevOpsGen dry-run plan listing replace and conflict entries before exiting with code 3
--dry-run prints the exact write plan, unresolved conflicts included.
What gets generated
Template setFilesPurpose
docker (+ .dockerignore)DockerfileHardened multi-stage build (Go runs as USER 1000:1000 on a scratch base). For Node.js, RUN steps and install/prune commands follow the detected package manager (npm / pnpm) and lockfile. The generated .dockerignore keeps state, tool caches and env files out of the image.
github-actions.github/workflows/ci.ymlRuns your tests when a test command is configured, then builds and pushes the image with both the commit SHA tag and your alias tag, authenticating to the chosen registry via secrets.
kubernetesdeployment.yaml, service.yaml, optional ingress.yamlDNS 1035-safe resource names, container port wiring, resource requests and limits, health probes when --health-path is given, and an optional host-based Ingress (RFC 1123 hostname).
Explore the docs
getting started
Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.
wizard
DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.
init
Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.
detect
devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.
validate
devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.
exit codes
Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.
Command cheatsheet
Terminal showing the full devopsgen help output listing all commands
devopsgen --help — all commands at a glance.
Terminal showing the devopsgen list output with available stacks, app types and registries
devopsgen list — supported stacks, app types and registries.
Terminal showing the devopsgen version output
devopsgen version.

+exit code: 0
Terminal showing a successful DevOpsGen init run creating five files with exit code 0
init — first run creates the complete baseline and exits 0.
Terminal showing a DevOpsGen dry-run plan listing five create entries with exit code 0
--dry-run on a fresh project prints the pure create plan and exits 0.
Terminal showing a DevOpsGen dry-run force plan where every file would be replaced, exit code 0
--dry-run --force previews the full replace plan — still nothing written.
What gets generated
Template setFilesPurpose
docker (+ .dockerignore)DockerfileHardened multi-stage build (Go runs as USER 1000:1000 on a scratch base). For Node.js, RUN steps and install/prune commands follow the detected package manager (npm / pnpm) and lockfile. The generated .dockerignore keeps state, tool caches and env files out of the image.
github-actions.github/workflows/ci.ymlRuns your tests when a test command is configured, then builds and pushes the image with both the commit SHA tag and your alias tag, authenticating to the chosen registry via secrets.
kubernetesdeployment.yaml, service.yaml, optional ingress.yamlDNS 1035-safe resource names, container port wiring, resource requests and limits, health probes when --health-path is given, and an optional host-based Ingress (RFC 1123 hostname).
Explore the docs
getting started
Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.
wizard
DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.
init
Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.
detect
devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.
validate
devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.
exit codes
Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.
Command cheatsheet
Terminal showing the full devopsgen help output listing all commands
devopsgen --help — all commands at a glance.
Terminal showing the devopsgen list output with available stacks, app types and registries
devopsgen list — supported stacks, app types and registries.
Terminal showing the devopsgen version output
devopsgen version.

 
 
\ No newline at end of file
diff --git a/docs/web/dist/init/index.html b/docs/web/dist/init/index.html
index a416db1..b644eda 100644
--- a/docs/web/dist/init/index.html
+++ b/docs/web/dist/init/index.html
@@ -21,6 +21,6 @@
   
 
 
-
DGDevOpsGenDOCSGitHub
command reference
devopsgen init
Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.
synopsis
devopsgen init [flags]
Flags
FlagDefaultDescription
--stackauto-detectedProject stack: go or nodejs.
--app-typeauto-detectedApplication type (see devopsgen list).
--cigithub-actionsCI provider.
--registrydockerhubContainer registry: dockerhub or ghcr.
--image—Image repository as namespace/repository — no host and no tag.
--taglatestAdditional image tag alias.
--port—Application port, 1–65535.
--k8strueGenerate Kubernetes manifests.
--ingressoffEnable Kubernetes Ingress (requires --ingress-host).
--ingress-host—Ingress hostname, validated as RFC 1123.
--health-path—HTTP health probe path wired into manifests.
--build-cmd—Build command.
--build-path.Go package path to build inside the container.
--start-cmd—Startup command.
--test-cmd—Test command.
--output-dir.Output directory.
--dry-runoffSimulate without writing anything.
--forceoffOverwrite existing regular files.
Success & conflicts
A clean run writes every template and exits with 0. A second run over an existing project stops before touching anything and exits with 3 until you add --force:
devopsgen init success output with exit code 0
First run: five files created, exit code 0.
devopsgen init conflict error refusing to overwrite files with exit code 3
Re-run without --force: exit code 3, zero files touched.
Preview plans with --dry-run
--dry-run prints the byte-plan: which files would be created, which would be replaced, and which are in conflict. With a conflict present it exits 3; combined with --force a fully green plan exits 0 without writing anything:
devopsgen dry-run plan output showing replace and conflict entries with exit code 3
--dry-run over an existing project: conflict entries, exit code 3.
devopsgen dry-run force plan output where every file would be replaced, exit code 0
--dry-run --force: every file replaced in plan form, exit code 0.
Config validation
Invalid configuration fails fast with 2 before any file is planned — e.g. an image that must be namespace/repository without host or tag, a port outside 1–65535, or an Ingress without a host:
devopsgen init failing config validation on an invalid image with exit code 2
Config errors exit with code 2 and never write files.
Overwrites performed with --force keep the previous content as <file>.devopsgen.bak backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.

+
DGDevOpsGenDOCSGitHub
command reference
devopsgen init
Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.
synopsis
devopsgen init [flags]
Flags
FlagDefaultDescription
--stackauto-detectedProject stack: go or nodejs.
--app-typeauto-detectedApplication type (see devopsgen list).
--cigithub-actionsCI provider.
--registrydockerhubContainer registry: dockerhub or ghcr.
--image—Image repository as namespace/repository — no host and no tag.
--taglatestAdditional image tag alias.
--port—Application port, 1–65535.
--k8strueGenerate Kubernetes manifests.
--ingressoffEnable Kubernetes Ingress (requires --ingress-host).
--ingress-host—Ingress hostname, validated as RFC 1123.
--health-path—HTTP health probe path wired into manifests.
--build-cmd—Build command.
--build-path.Go package path to build inside the container.
--start-cmd—Startup command.
--test-cmd—Test command.
--output-dir.Output directory.
--dry-runoffSimulate without writing anything.
--forceoffOverwrite existing regular files.
Success & conflict behaviour
A clean run writes every template and exits with 0. A second run over an existing project stops before touching anything and exits with 3 until you add --force; a detailed walkthrough of that re-run path is on the exit codes page.
devopsgen init success output with exit code 0
First run: five files created, exit code 0.
Preview plans with --dry-run
--dry-run prints the byte-plan and writes nothing. On a fresh project it lists pure create rows and exits 0; combined with --force over an existing project it lists the exact files that would be replaced — still 0:
devopsgen dry-run plan output showing five create entries with exit code 0
--dry-run on a fresh project: pure create plan, exit code 0.
devopsgen dry-run force plan output where every file would be replaced, exit code 0
--dry-run --force: every file replaced in plan form, exit code 0.
Config validation
Invalid configuration fails fast with 2 before any file is planned and never writes files — e.g. an image that must be namespace/repository without host or tag, a port outside 1–65535, or an Ingress without a host. The full code table lives on the exit codes page.
Overwrites performed with --force keep the previous content as <file>.devopsgen.bak backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.

 
 
\ No newline at end of file
diff --git a/docs/web/img/dry-run.png b/docs/web/img/dry-run.png
index 239b232..48723f8 100644
Binary files a/docs/web/img/dry-run.png and b/docs/web/img/dry-run.png differ
diff --git a/docs/web/img/init-conflict.png b/docs/web/img/init-conflict.png
deleted file mode 100644
index 5bc87d0..0000000
Binary files a/docs/web/img/init-conflict.png and /dev/null differ
diff --git a/docs/web/img/invalid-config.png b/docs/web/img/invalid-config.png
deleted file mode 100644
index 15681aa..0000000
Binary files a/docs/web/img/invalid-config.png and /dev/null differ
diff --git a/docs/web/public/img/dry-run.png b/docs/web/public/img/dry-run.png
index 239b232..48723f8 100644
Binary files a/docs/web/public/img/dry-run.png and b/docs/web/public/img/dry-run.png differ
diff --git a/docs/web/public/img/init-conflict.png b/docs/web/public/img/init-conflict.png
deleted file mode 100644
index 5bc87d0..0000000
Binary files a/docs/web/public/img/init-conflict.png and /dev/null differ
diff --git a/docs/web/public/img/invalid-config.png b/docs/web/public/img/invalid-config.png
deleted file mode 100644
index 15681aa..0000000
Binary files a/docs/web/public/img/invalid-config.png and /dev/null differ
diff --git a/docs/web/src/pages/ExitCodes.jsx b/docs/web/src/pages/ExitCodes.jsx
index 45cb3ea..b948d59 100644
--- a/docs/web/src/pages/ExitCodes.jsx
+++ b/docs/web/src/pages/ExitCodes.jsx
@@ -72,20 +72,13 @@ export default function ExitCodes({ rel }) {

In practice

-
- - -
+ {`devopsgen init --stack go --registry ghcr --image you/myapp --port 8080 case $? in diff --git a/docs/web/src/pages/Home.jsx b/docs/web/src/pages/Home.jsx index bc8c172..799e2c2 100644 --- a/docs/web/src/pages/Home.jsx +++ b/docs/web/src/pages/Home.jsx @@ -88,15 +88,15 @@ exit code: 0`} />
diff --git a/docs/web/src/pages/InitCmd.jsx b/docs/web/src/pages/InitCmd.jsx index d7e79cb..d0ccb51 100644 --- a/docs/web/src/pages/InitCmd.jsx +++ b/docs/web/src/pages/InitCmd.jsx @@ -120,40 +120,36 @@ export default function InitCmd({ rel }) { -

Success & conflicts

+

Success & conflict behaviour

A clean run writes every template and exits with{' '} 0. A second run over an existing project stops before touching - anything and exits with 3 until you add --force: + anything and exits with 3 until you add --force; a + detailed walkthrough of that re-run path is on the{' '} + exit codes page.

-
- - -
+

Preview plans with --dry-run

- --dry-run prints the byte-plan: which files would be created, which would be - replaced, and which are in conflict. With a conflict present it exits{' '} - 3; combined with --force a fully green plan exits{' '} - 0 without writing anything: + --dry-run prints the byte-plan and writes nothing. On a fresh project it lists + pure create rows and exits{' '} + 0; combined with --force over an existing project it + lists the exact files that would be replaced — still{' '} + 0:

Config validation

Invalid configuration fails fast with 2 before any file is - planned — e.g. an image that must be namespace/repository without host or - tag, a port outside 1–65535, or an Ingress without a host: + planned and never writes files — e.g. an image that must be{' '} + namespace/repository without host or tag, a port outside 1–65535, or an + Ingress without a host. The full code table lives on the{' '} + exit codes page.

-
Overwrites performed with --force keep the previous content as{' '} <file>.devopsgen.bak backups, and any failure mid-run triggers a diff --git a/docs/web/src/routes.jsx b/docs/web/src/routes.jsx index f3320cf..032ade9 100644 --- a/docs/web/src/routes.jsx +++ b/docs/web/src/routes.jsx @@ -71,6 +71,6 @@ export const ROUTES = [ description: 'Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.', keywords: 'devopsgen exit codes, ci integration, pipeline status', - ogImage: 'img/invalid-config.png', + ogImage: 'img/validate.png', }, ];