ripplo 0.4.5 → 0.4.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +162 -162
- package/package.json +5 -3
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{execFileSync as
|
|
3
|
-
`)}function
|
|
4
|
-
`),n=
|
|
2
|
+
import{execFileSync as Ra}from"child_process";import xa from"fs";import ut from"path";function tr(e){let t=Ca(e);return t??xn(e)}function xn(e){let t=ut.dirname(e);return Pa(ut.join(e,".ripplo"))?e:t===e?null:xn(t)}function Pa(e){try{return xa.statSync(e).isDirectory()}catch{return!1}}function Ca(e){let t=Ea(["rev-parse","--show-toplevel"],e);if(t==null)return null;let r=t.trim();return r.length===0?null:ut.isAbsolute(r)?r:ut.resolve(e,r)}function Ea(e,t){try{return Ra("git",e,{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]})}catch{return null}}import En from"fs";import ft from"path";import{config as Aa}from"dotenv";import{z as mt}from"zod";import Ke from"fs";import nr from"path";import{z as pt}from"zod";var Pn=nr.join(".ripplo","project.json"),rr=[".env",".env.local"],Ta=pt.object({envFiles:pt.array(pt.string().min(1)).optional(),projectId:pt.string().min(1)});function or(e){return nr.join(e,Pn)}function ir(e){let t=or(e);if(!Ke.existsSync(t))throw new Error(`ripplo: missing ${Pn}. Run \`ripplo init\` to create it.`);let r=JSON.parse(Ke.readFileSync(t,"utf8")),n=Ta.parse(r);return{envFiles:n.envFiles??rr,projectId:n.projectId}}function sr(e){let t=or(e);if(Ke.existsSync(t))try{return ir(e)}catch{return}}function Cn({cwd:e,envFiles:t,projectId:r}){let n=or(e);Ke.mkdirSync(nr.dirname(n),{recursive:!0});let o={projectId:r};t!=null&&!$a(t)&&(o.envFiles=[...t]),Ke.writeFileSync(n,JSON.stringify(o,null,2)+`
|
|
3
|
+
`)}function $a(e){return e.length!==rr.length?!1:e.every((t,r)=>t===rr[r])}function Tn(e){let r=sr(e)?.envFiles??[".env",".env.local"],n=ft.join(e,".ripplo");r.forEach(o=>{let i=ft.resolve(n,o);En.existsSync(i)&&Aa({override:!0,path:i,quiet:!0})}),ar=void 0}var Ia=mt.object({RIPPLO_APP_URL:mt.url(),RIPPLO_ENGINE_URL:mt.url(),RIPPLO_WEBHOOK_SECRET:mt.string().min(1)}),ar;function Ae(){return ar??=ja(),ar}function ja(){let e=Ia.safeParse(process.env);if(!e.success){let r=e.error.issues.map(s=>` ${s.path.join(".")}: ${s.message}`).join(`
|
|
4
|
+
`),n=lr(process.cwd()),o=n.map(s=>` ${s}`).join(`
|
|
5
5
|
`),i=n.length>0?`
|
|
6
6
|
|
|
7
7
|
Declared env file(s) not found at this path:
|
|
@@ -9,48 +9,48 @@ ${o}
|
|
|
9
9
|
If you're in a git worktree, the env file may not have been copied from the main checkout \u2014 recreate it (or symlink to a shared file outside the working tree).`:"";throw new Error(`ripplo: env config invalid:
|
|
10
10
|
${r}
|
|
11
11
|
|
|
12
|
-
Add missing values to the env file(s) declared in .ripplo/project.json.${i}`)}let t=e.data;return{appUrl:t.RIPPLO_APP_URL,engineUrl:t.RIPPLO_ENGINE_URL,webhookSecret:t.RIPPLO_WEBHOOK_SECRET}}function
|
|
13
|
-
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,E=h.scan(
|
|
12
|
+
Add missing values to the env file(s) declared in .ripplo/project.json.${i}`)}let t=e.data;return{appUrl:t.RIPPLO_APP_URL,engineUrl:t.RIPPLO_ENGINE_URL,webhookSecret:t.RIPPLO_WEBHOOK_SECRET}}function lr(e){let r=sr(e)?.envFiles??[],n=ft.join(e,".ripplo");return r.map(o=>ft.resolve(n,o)).filter(o=>!En.existsSync(o))}import fw from"yargs";import{hideBin as gw}from"yargs/helpers";import{graphql as np}from"gql.tada";var Na=Object.prototype.toString,je=Array.isArray||function(t){return Na.call(t)==="[object Array]"};function dr(e){return typeof e=="function"}function Oa(e){return je(e)?"array":typeof e}function cr(e){return e.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")}function $n(e,t){return e!=null&&typeof e=="object"&&t in e}function Da(e,t){return e!=null&&typeof e!="object"&&e.hasOwnProperty&&e.hasOwnProperty(t)}var La=RegExp.prototype.test;function _a(e,t){return La.call(e,t)}var Ua=/\S/;function Va(e){return!_a(Ua,e)}var Fa={"&":"&","<":"<",">":">",'"':""","'":"'","/":"/","`":"`","=":"="};function Ma(e){return String(e).replace(/[&<>"'`=\/]/g,function(r){return Fa[r]})}var Ha=/\s*/,Wa=/\s+/,An=/\s*=/,qa=/\s*\}/,Ba=/#|\^|\/|>|\{|&|=|!/;function za(e,t){if(!e)return[];var r=!1,n=[],o=[],i=[],s=!1,a=!1,l="",c=0;function d(){if(s&&!a)for(;i.length;)delete o[i.pop()];else i=[];s=!1,a=!1}var u,f,b;function w(_){if(typeof _=="string"&&(_=_.split(Wa,2)),!je(_)||_.length!==2)throw new Error("Invalid tags: "+_);u=new RegExp(cr(_[0])+"\\s*"),f=new RegExp("\\s*"+cr(_[1])),b=new RegExp("\\s*"+cr("}"+_[1]))}w(t||re.tags);for(var h=new Ye(e),v,E,V,B,L,F;!h.eos();){if(v=h.pos,V=h.scanUntil(u),V)for(var ie=0,$e=V.length;ie<$e;++ie)B=V.charAt(ie),Va(B)?(i.push(o.length),l+=B):(a=!0,r=!0,l+=" "),o.push(["text",B,v,v+1]),v+=1,B===`
|
|
13
|
+
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,E=h.scan(Ba)||"name",h.scan(Ha),E==="="?(V=h.scanUntil(An),h.scan(An),h.scanUntil(f)):E==="{"?(V=h.scanUntil(b),h.scan(qa),h.scanUntil(f),E="&"):V=h.scanUntil(f),!h.scan(f))throw new Error("Unclosed tag at "+h.pos);if(E==">"?L=[E,V,v,h.pos,l,c,r]:L=[E,V,v,h.pos],c++,o.push(L),E==="#"||E==="^")n.push(L);else if(E==="/"){if(F=n.pop(),!F)throw new Error('Unopened section "'+V+'" at '+v);if(F[1]!==V)throw new Error('Unclosed section "'+F[1]+'" at '+v)}else E==="name"||E==="{"||E==="&"?a=!0:E==="="&&w(V)}if(d(),F=n.pop(),F)throw new Error('Unclosed section "'+F[1]+'" at '+h.pos);return Ka(Ga(o))}function Ga(e){for(var t=[],r,n,o=0,i=e.length;o<i;++o)r=e[o],r&&(r[0]==="text"&&n&&n[0]==="text"?(n[1]+=r[1],n[3]=r[3]):(t.push(r),n=r));return t}function Ka(e){for(var t=[],r=t,n=[],o,i,s=0,a=e.length;s<a;++s)switch(o=e[s],o[0]){case"#":case"^":r.push(o),n.push(o),r=o[4]=[];break;case"/":i=n.pop(),i[5]=o[2],r=n.length>0?n[n.length-1][4]:t;break;default:r.push(o)}return t}function Ye(e){this.string=e,this.tail=e,this.pos=0}Ye.prototype.eos=function(){return this.tail===""};Ye.prototype.scan=function(t){var r=this.tail.match(t);if(!r||r.index!==0)return"";var n=r[0];return this.tail=this.tail.substring(n.length),this.pos+=n.length,n};Ye.prototype.scanUntil=function(t){var r=this.tail.search(t),n;switch(r){case-1:n=this.tail,this.tail="";break;case 0:n="";break;default:n=this.tail.substring(0,r),this.tail=this.tail.substring(r)}return this.pos+=n.length,n};function Ie(e,t){this.view=e,this.cache={".":this.view},this.parent=t}Ie.prototype.push=function(t){return new Ie(t,this)};Ie.prototype.lookup=function(t){var r=this.cache,n;if(r.hasOwnProperty(t))n=r[t];else{for(var o=this,i,s,a,l=!1;o;){if(t.indexOf(".")>0)for(i=o.view,s=t.split("."),a=0;i!=null&&a<s.length;)a===s.length-1&&(l=$n(i,s[a])||Da(i,s[a])),i=i[s[a++]];else i=o.view[t],l=$n(o.view,t);if(l){n=i;break}o=o.parent}r[t]=n}return dr(n)&&(n=n.call(this.view)),n};function G(){this.templateCache={_cache:{},set:function(t,r){this._cache[t]=r},get:function(t){return this._cache[t]},clear:function(){this._cache={}}}}G.prototype.clearCache=function(){typeof this.templateCache<"u"&&this.templateCache.clear()};G.prototype.parse=function(t,r){var n=this.templateCache,o=t+":"+(r||re.tags).join(":"),i=typeof n<"u",s=i?n.get(o):void 0;return s==null&&(s=za(t,r),i&&n.set(o,s)),s};G.prototype.render=function(t,r,n,o){var i=this.getConfigTags(o),s=this.parse(t,i),a=r instanceof Ie?r:new Ie(r,void 0);return this.renderTokens(s,a,n,t,o)};G.prototype.renderTokens=function(t,r,n,o,i){for(var s="",a,l,c,d=0,u=t.length;d<u;++d)c=void 0,a=t[d],l=a[0],l==="#"?c=this.renderSection(a,r,n,o,i):l==="^"?c=this.renderInverted(a,r,n,o,i):l===">"?c=this.renderPartial(a,r,n,i):l==="&"?c=this.unescapedValue(a,r):l==="name"?c=this.escapedValue(a,r,i):l==="text"&&(c=this.rawValue(a)),c!==void 0&&(s+=c);return s};G.prototype.renderSection=function(t,r,n,o,i){var s=this,a="",l=r.lookup(t[1]);function c(f){return s.render(f,r,n,i)}if(l){if(je(l))for(var d=0,u=l.length;d<u;++d)a+=this.renderTokens(t[4],r.push(l[d]),n,o,i);else if(typeof l=="object"||typeof l=="string"||typeof l=="number")a+=this.renderTokens(t[4],r.push(l),n,o,i);else if(dr(l)){if(typeof o!="string")throw new Error("Cannot use higher-order sections without the original template");l=l.call(r.view,o.slice(t[3],t[5]),c),l!=null&&(a+=l)}else a+=this.renderTokens(t[4],r,n,o,i);return a}};G.prototype.renderInverted=function(t,r,n,o,i){var s=r.lookup(t[1]);if(!s||je(s)&&s.length===0)return this.renderTokens(t[4],r,n,o,i)};G.prototype.indentPartial=function(t,r,n){for(var o=r.replace(/[^ \t]/g,""),i=t.split(`
|
|
14
14
|
`),s=0;s<i.length;s++)i[s].length&&(s>0||!n)&&(i[s]=o+i[s]);return i.join(`
|
|
15
|
-
`)};G.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=
|
|
16
|
-
`):`${e.status}: ${e.title}`;return{specNode:e.specNode,stepResult:o,toolOutput:i}}var
|
|
17
|
-
${r.summary}`,verdict:r.verdict};return Promise.resolve(n)}};import{z as
|
|
15
|
+
`)};G.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=dr(n)?n(t[1]):n[t[1]];if(s!=null){var a=t[6],l=t[5],c=t[4],d=s;l==0&&c&&(d=this.indentPartial(s,c,a));var u=this.parse(d,i);return this.renderTokens(u,r,n,d,o)}}};G.prototype.unescapedValue=function(t,r){var n=r.lookup(t[1]);if(n!=null)return n};G.prototype.escapedValue=function(t,r,n){var o=this.getConfigEscape(n)||re.escape,i=r.lookup(t[1]);if(i!=null)return typeof i=="number"&&o===re.escape?String(i):o(i)};G.prototype.rawValue=function(t){return t[1]};G.prototype.getConfigTags=function(t){return je(t)?t:t&&typeof t=="object"?t.tags:void 0};G.prototype.getConfigEscape=function(t){if(t&&typeof t=="object"&&!je(t))return t.escape};var re={name:"mustache.js",version:"4.2.0",tags:["{{","}}"],clearCache:void 0,escape:void 0,parse:void 0,render:void 0,Scanner:void 0,Context:void 0,Writer:void 0,set templateCache(e){Je.templateCache=e},get templateCache(){return Je.templateCache}},Je=new G;re.clearCache=function(){return Je.clearCache()};re.parse=function(t,r){return Je.parse(t,r)};re.render=function(t,r,n,o){if(typeof t!="string")throw new TypeError('Invalid template! Template should be a "string" but "'+Oa(t)+'" was given as the first argument for mustache#render(template, view, partials)');return Je.render(t,r,n,o)};re.escape=Ma;re.Scanner=Ye;re.Context=Ie;re.Writer=G;var In=re;function Xe({defs:e}){return e==null?{}:Object.fromEntries(Object.entries(e).map(([t,r])=>[t,Ya({def:r,name:t})]))}var Ja={boolean:!1,number:0,string:""};function Ya({def:e,name:t}){if(e.type==="env"){let r=process.env[e.key];if(r==null)throw new Error(`Environment variable "${e.key}" not set for variable "${t}"`);return r}return e.default??Ja[e.type]??""}function gt({ref:e,variables:t}){if(e.type==="static")return e.value;let r=t[e.name];if(r==null||typeof r=="object")throw new Error(`Variable "${e.name}" is not defined`);return r}function K({ref:e,variables:t}){let r=String(gt({ref:e,variables:t}));return ht({raw:r,variables:t})}function yt({ref:e,variables:t}){let r=gt({ref:e,variables:t});return typeof r=="string"?ht({raw:r,variables:t}):r}function ht({raw:e,variables:t}){return In.render(e,t,{},{escape:r=>r})}function ur({ref:e,variables:t}){let r=gt({ref:e,variables:t});if(typeof r=="number")return r;let n=Number(r);if(Number.isNaN(n))throw new TypeError(`Cannot convert "${String(r)}" to number`);return n}function Ne({name:e,store:t,value:r}){return{...t,[e]:r}}function U({locator:e,page:t,variables:r}){switch(e.by){case"testId":return t.getByTestId(jn(e.value,r));case"role":return t.getByRole(e.role,{exact:!0,name:e.name==null?void 0:jn(e.name,r)})}}function jn(e,t){return t==null?e:ht({raw:e,variables:t})}async function Nn({node:e,page:t,timeout:r}){await U({locator:e.source,page:t,variables:void 0}).dragTo(U({locator:e.target,page:t,variables:void 0}),{timeout:r})}async function On({node:e,page:t,timeout:r}){await U({locator:e.locator,page:t,variables:void 0}).click({button:"right",timeout:r})}function Dn({node:e,page:t,variables:r}){return t.once("dialog",async n=>{e.action==="accept"?await n.accept(e.promptText??void 0):await n.dismiss()}),{variables:r}}async function Ln({node:e,page:t,variables:r}){if(e.action==="write"){if(e.value==null)throw new Error("clipboard write requires a value");let o=K({ref:e.value,variables:r}),i=JSON.stringify(o);return await t.evaluate(`navigator.clipboard.writeText(${i})`),{variables:r}}if(e.variable==null)throw new Error("clipboard read requires a variable name to store the result");let n=String(await t.evaluate("navigator.clipboard.readText()"));return{variables:Ne({name:e.variable,store:r,value:n})}}async function _n({node:e,page:t}){let r=t.context();e.state==="granted"?await r.grantPermissions([e.permission]):await r.clearPermissions()}async function pr({node:e,page:t,timeout:r,variables:n}){switch(e.type){case"click":case"check":case"uncheck":case"clear":case"dblclick":case"focus":case"hover":case"scrollIntoView":return Qa({node:e,page:t,timeout:r,variables:n});case"rightClick":return await On({node:e,page:t,timeout:r}),{variables:n};case"goto":{let o=K({ref:e.url,variables:n});return await t.goto(o,{timeout:r,waitUntil:"domcontentloaded"}),await t.waitForLoadState("load",{timeout:r}),await t.waitForFunction("document.body != null && document.body.childElementCount > 0 && (document.body.textContent?.trim().length ?? 0) > 0",void 0,{timeout:r}),await t.evaluate("new Promise((resolve) => { requestAnimationFrame(() => requestAnimationFrame(() => resolve(undefined))); })"),{variables:n}}case"fill":return el({node:e,page:t,timeout:r,variables:n});case"select":return tl({node:e,page:t,timeout:r,variables:n});case"type":return rl({node:e,page:t,timeout:r,variables:n});case"press":return await Za({node:e,page:t,timeout:r}),{variables:n};case"drag":return await Nn({node:e,page:t,timeout:r}),{variables:n};case"upload":return nl({node:e,page:t,timeout:r,variables:n});case"extractText":return ol({node:e,page:t,timeout:r,variables:n});case"setVariable":{let o=yt({ref:e.value,variables:n});return{variables:Ne({name:e.variable,store:n,value:o})}}case"fail":throw new Error(e.message);case"setViewport":return await t.setViewportSize({height:e.height,width:e.width}),{variables:n};case"handleDialog":return Dn({node:e,page:t,variables:n});case"clipboard":return Ln({node:e,page:t,variables:n});case"setPermission":return await _n({node:e,page:t}),{variables:n}}}var Xa={check:"check",clear:"clear",click:"click",dblclick:"dblclick",focus:"focus",hover:"hover",scrollIntoView:"scrollIntoViewIfNeeded",uncheck:"uncheck"};async function Qa({node:e,page:t,timeout:r,variables:n}){return await U({locator:e.locator,page:t,variables:n})[Xa[e.type]]({timeout:r}),{variables:n}}async function Za({node:e,page:t,timeout:r}){e.locator==null?await t.keyboard.press(e.key):await U({locator:e.locator,page:t,variables:void 0}).press(e.key,{timeout:r})}async function el({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).fill(o,{timeout:r}),{variables:n}}async function tl({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).selectOption(o,{timeout:r}),{variables:n}}async function rl({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).pressSequentially(o,{timeout:r}),{variables:n}}async function nl({node:e,page:t,timeout:r,variables:n}){return await U({locator:e.locator,page:t,variables:n}).setInputFiles(e.files,{timeout:r}),{variables:n}}async function ol({node:e,page:t,timeout:r,variables:n}){let o=await U({locator:e.locator,page:t,variables:n}).textContent({timeout:r});if(o==null)throw new Error("extractText: element had no text content");return{variables:Ne({name:e.variable,store:n,value:o})}}import Ql from"@anthropic-ai/sdk";import{z as Un}from"zod";import{z as dl}from"zod";async function we({page:e,runStartTime:t,targets:r}){let n=e.viewportSize();if(n==null)throw new Error("Page has no viewport set");return{annotations:await al(r),snapshotTimestamp:Math.round(performance.now()-t),url:e.url(),viewportHeight:n.height,viewportWidth:n.width}}function il(e){return"locator"in e}function sl(e){let t=globalThis.__ripploRrwebMirror?.getId(e);return t!=null&&t>0?t:void 0}async function al(e){return(await Promise.all(e.map(r=>ll(r)))).filter(r=>r!=null)}async function ll(e){if(!il(e))return{height:0,label:e.label,rrwebNodeId:void 0,type:e.type,width:0,x:0,y:0};if(!await e.locator.isVisible().catch(()=>!1))return;let r=await e.locator.boundingBox().catch(()=>null);if(r==null)return;let n=await e.locator.evaluate(sl).catch(()=>{})??void 0;return{height:Math.round(r.height),label:e.label,rrwebNodeId:n,type:e.type,width:Math.round(r.width),x:Math.round(r.x),y:Math.round(r.y)}}function wt({node:e,page:t}){if(e.type==="assertUrl")return[{label:e.type,type:"urlBar"}];if(e.type==="drag"){let o=U({locator:e.source,page:t,variables:void 0}),i=U({locator:e.target,page:t,variables:void 0});return[{label:"drag-source",locator:o,type:"action"},{label:"drag-target",locator:i,type:"action"}]}if(!cl(e))return[];let r=e.type.startsWith("assert")?"assertion":"action",n=U({locator:e.locator,page:t,variables:void 0});return[{label:e.type,locator:n,type:r}]}function cl(e){return"locator"in e&&e.locator!=null}function y({description:e,execute:t,name:r,schema:n}){let o=dl.toJSONSchema(n,{target:"draft-2020-12"});return{anthropicTool:{description:e,input_schema:{...o,type:"object"},name:r},name:r,async execute(i,s){let a=n.parse(s);return{...await Promise.resolve(t(i,a)),kind:"action"}}}}async function k(e){let t=e.specNode==null?[]:wt({node:e.specNode,page:e.page}),r=await we({page:e.page,runStartTime:e.runStartTime,targets:t}),n=[...e.assertions],o={annotations:r.annotations,assertions:n,detail:e.detail,duration:Math.round(e.duration),nodeId:`agent-step-${String(e.stepIndex)}`,nodeType:e.nodeType,recordingEndMs:void 0,recordingStartMs:void 0,snapshotTimestamp:r.snapshotTimestamp,status:e.status,stepIndex:e.stepIndex,title:e.title,url:r.url,viewportHeight:r.viewportHeight,viewportWidth:r.viewportWidth},i=n.length>0?n.map(s=>`${s.status}: ${s.description} \u2014 ${s.detail??""}`).join(`
|
|
16
|
+
`):`${e.status}: ${e.title}`;return{specNode:e.specNode,stepResult:o,toolOutput:i}}var ul=Un.object({selector:Un.string().describe("CSS selector for the checkbox or radio button")}),Vn=y({description:"Assert that a checkbox or radio button is checked",name:"assert_checked",schema:ul,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).isChecked().catch(()=>!1),o=n?"passed":"failed",i=[{description:`Element ${t.selector} is checked`,detail:n?void 0:"Element is not checked",status:o}];return k({assertions:i,detail:n?"Element is checked":"Element is not checked",duration:performance.now()-r,nodeType:"assertChecked",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:o,stepIndex:e.stepIndex,title:`Assert checked: ${t.selector}`})}});import{z as Fn}from"zod";var pl=Fn.object({selector:Fn.string().describe("CSS selector for the element to check focus on")}),Mn=y({description:"Assert that an element has keyboard focus. Use for accessibility tab-order testing.",name:"assert_focused",schema:pl,execute:async(e,t)=>{let r=performance.now(),o=!!await e.page.locator(t.selector).evaluate("(el) => document.activeElement === el").catch(()=>!1),i=o?"passed":"failed",s=[{description:`Element ${t.selector} is focused`,detail:o?void 0:"Element does not have focus",status:i}];return k({assertions:s,detail:o?"Element is focused":"Element does not have focus",duration:performance.now()-r,nodeType:"assertFocused",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:i,stepIndex:e.stepIndex,title:`Assert focused: ${t.selector}`})}});import{z as mr}from"zod";var ml=mr.object({expected:mr.string().describe("The expected text content"),selector:mr.string().describe("CSS selector for the element to check")}),Hn=y({description:"Assert that an element's text content matches the expected value",name:"assert_text",schema:ml,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).textContent({timeout:5e3}).catch(()=>null),o=n!=null&&n.includes(t.expected),i=o?"passed":"failed",s=[{description:`Text contains "${t.expected}"`,detail:`Actual: "${n??"(not found)"}"`,status:i}];return k({assertions:s,detail:o?`Text matches: "${t.expected}"`:`Expected "${t.expected}", got "${n??"(not found)"}"`,duration:performance.now()-r,nodeType:"assertText",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:i,stepIndex:e.stepIndex,title:`Assert text: ${t.selector}`})}});import{z as fr}from"zod";var fl=fr.object({expected:fr.string().describe("Expected page title or substring"),operator:fr.enum(["equals","contains","startsWith","endsWith"]).describe("Comparison operator").default("contains")}),Wn=y({description:"Assert that the page title matches an expected value",name:"assert_title",schema:fl,execute:async(e,t)=>{let r=performance.now(),n=await e.page.title(),o=gl({actual:n,expected:t.expected,operator:t.operator}),i=o?"passed":"failed",s=[{description:`Title ${t.operator} "${t.expected}"`,detail:o?void 0:`Got: "${n}"`,status:i}],a=`agent-step-${String(e.stepIndex)}`,l={expected:{type:"static",value:t.expected},id:a,operator:t.operator,type:"assertTitle"};return k({assertions:s,detail:o?"Title matches":`Expected title ${t.operator} "${t.expected}", got "${n}"`,duration:performance.now()-r,nodeType:"assertTitle",page:e.page,runStartTime:e.runStartTime,specNode:l,status:i,stepIndex:e.stepIndex,title:`Assert title ${t.operator} "${t.expected}"`})}});function gl({actual:e,expected:t,operator:r}){return r==="equals"?e===t:r==="contains"?e.includes(t):r==="startsWith"?e.startsWith(t):r==="endsWith"?e.endsWith(t):!1}import{z as qn}from"zod";var yl=qn.object({selector:qn.string().describe("CSS selector for the element to check")}),Bn=y({description:"Assert that an element matching the selector is visible on the page",name:"assert_visible",schema:yl,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).isVisible().catch(()=>!1),o=n?"passed":"failed",i=[{description:`Element ${t.selector} is visible`,detail:n?"Element is visible":"Element is not visible",status:o}];return k({assertions:i,detail:n?"Element is visible":"Element is not visible",duration:performance.now()-r,nodeType:"assertVisible",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:o,stepIndex:e.stepIndex,title:`Assert visible: ${t.selector}`})}});import{z as zn}from"zod";var hl=zn.object({selector:zn.string().describe("CSS selector for the checkbox to check")}),Gn=y({description:"Check a checkbox matching the CSS selector",name:"check",schema:hl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).check({timeout:5e3}),k({assertions:[],detail:`Checked ${t.selector}`,duration:performance.now()-r,nodeType:"check",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Check ${t.selector}`})}});import{z as Kn}from"zod";var wl=Kn.object({selector:Kn.string().describe("CSS selector for the input to clear")}),Jn=y({description:"Clear the contents of an input field",name:"clear",schema:wl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).clear({timeout:5e3}),k({assertions:[],detail:`Cleared ${t.selector}`,duration:performance.now()-r,nodeType:"clear",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Clear ${t.selector}`})}});import{z as Yn}from"zod";var bl=Yn.object({selector:Yn.string().describe("CSS selector for the element to click")}),Xn=y({description:"Click an element matching the CSS selector",name:"click",schema:bl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({timeout:5e3}),k({assertions:[],detail:`Clicked ${t.selector}`,duration:performance.now()-r,nodeType:"click",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Click ${t.selector}`})}});import{z as gr}from"zod";var Sl=gr.object({action:gr.enum(["read","write"]).describe("Whether to read from or write to the clipboard"),value:gr.string().optional().describe("Text to write (required for write action)")}),Qn=y({description:"Read from or write to the browser clipboard. For write, provide the text value. For read, the clipboard contents are returned.",name:"clipboard",schema:Sl,execute:async(e,t)=>{let r=performance.now(),n=`agent-step-${String(e.stepIndex)}`;if(t.action==="write"){if(t.value==null)throw new Error("clipboard write requires a value");let s=JSON.stringify(t.value);await e.page.evaluate(`navigator.clipboard.writeText(${s})`);let a={action:"write",id:n,type:"clipboard",value:{type:"static",value:t.value}};return k({assertions:[],detail:`Wrote to clipboard: "${t.value}"`,duration:performance.now()-r,nodeType:"clipboard",page:e.page,runStartTime:e.runStartTime,specNode:a,status:"passed",stepIndex:e.stepIndex,title:"Clipboard write"})}let o=String(await e.page.evaluate("navigator.clipboard.readText()")),i={action:"read",id:n,type:"clipboard"};return k({assertions:[],detail:`Clipboard contents: "${o}"`,duration:performance.now()-r,nodeType:"clipboard",page:e.page,runStartTime:e.runStartTime,specNode:i,status:"passed",stepIndex:e.stepIndex,title:"Clipboard read"})}});import{z as bt}from"zod";var Zn=bt.object({summary:bt.string().describe("This is the ONLY output the user sees. If the agent profile specifies an Output format, follow those instructions exactly. Otherwise, provide a summary of your findings."),verdict:bt.enum(["pass","fail"]).describe("Whether the test passed or failed. If the agent profile defines Success Criteria, base this verdict on whether those criteria were met.")}),eo={anthropicTool:{description:"Call this tool when you have finished your evaluation. If the agent profile defines an Output section, the summary MUST follow those output instructions exactly. Otherwise, summarize your findings.",input_schema:{...bt.toJSONSchema(Zn,{target:"draft-2020-12"}),type:"object"},name:"complete_test"},name:"complete_test",execute(e,t){let r=Zn.parse(t),n={kind:"verdict",summary:r.summary,toolOutput:`Verdict: ${r.verdict}
|
|
17
|
+
${r.summary}`,verdict:r.verdict};return Promise.resolve(n)}};import{z as to}from"zod";var vl=to.object({selector:to.string().describe("CSS selector for the element to extract text from")}),ro=y({description:"Extract the text content of an element matching the CSS selector. Returns the text so you can use it in assertions or decisions.",name:"extract_text",schema:vl,execute:async(e,t)=>{let r=performance.now(),o=await e.page.locator(t.selector).textContent({timeout:5e3})??"";return k({assertions:[],detail:`Extracted text: "${o}"`,duration:performance.now()-r,nodeType:"extractText",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Extract text from ${t.selector}`})}});import{z as yr}from"zod";var kl=yr.object({selector:yr.string().describe("CSS selector for the input element"),value:yr.string().describe("The text to type into the element")}),no=y({description:"Clear and type text into an input element matching the CSS selector",name:"fill",schema:kl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).fill(t.value,{timeout:5e3}),k({assertions:[],detail:`Filled ${t.selector} with "${t.value}"`,duration:performance.now()-r,nodeType:"fill",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Fill ${t.selector}`})}});import{z as oo}from"zod";var Rl=oo.object({level:oo.string().describe("Filter by log level: 'error', 'warning', 'log', 'info', 'debug', or 'all'").default("all")}),io=y({description:"Get console log messages from the browser. Optionally filter by level (error, warning, log, info, debug, all).",name:"get_console_logs",schema:Rl,execute:(e,t)=>{let r=t.level==="all"?e.monitor.consoleEntries:e.monitor.consoleEntries.filter(o=>o.level===t.level);if(r.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:`No console ${t.level==="all"?"messages":t.level+" messages"} recorded.`};let n=r.map(o=>xl(o)).join(`
|
|
18
18
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(r.length)} console messages:
|
|
19
|
-
${n}`}}});function
|
|
20
|
-
`),s=n.length>
|
|
21
|
-
(showing last ${String(
|
|
22
|
-
${i}`}}});import{z as
|
|
19
|
+
${n}`}}});function xl(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as so}from"zod";var hr=50,Pl=so.object({urlFilter:so.string().describe("Optional regex to filter network entries by URL. Omit to see all.").default("")}),ao=y({description:"Get a summary of network requests/responses. Shows method, URL, status code, and content type. Optionally filter by URL regex.",name:"get_network_log",schema:Pl,execute:(e,t)=>{let r=t.urlFilter.length>0?new RegExp(t.urlFilter,"i"):void 0,n=r==null?e.monitor.networkEntries:e.monitor.networkEntries.filter(a=>r.test(a.url));if(n.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:"No network requests recorded."};let o=n.slice(-hr),i=o.map(a=>{let l=a.statusCode==null?"pending":String(a.statusCode),c=a.responseHeaders["content-type"]??"";return`${a.method} ${l} ${a.url} [${c}]`}).join(`
|
|
20
|
+
`),s=n.length>hr?`
|
|
21
|
+
(showing last ${String(hr)} of ${String(n.length)})`:"";return{specNode:void 0,stepResult:void 0,toolOutput:`${String(o.length)} network requests:${s}
|
|
22
|
+
${i}`}}});import{z as lo}from"zod";var Cl=lo.object({urlPattern:lo.string().describe("Regex pattern to match the request URL")}),co=y({description:"Get the full response body for a specific network request matching the URL pattern. Returns the most recent match.",name:"get_network_response",schema:Cl,execute:(e,t)=>{let r=new RegExp(t.urlPattern,"i"),n=e.monitor.networkEntries.filter(l=>r.test(l.url));if(n.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:`No network requests matching: ${t.urlPattern}`};let o=n.at(-1);if(o==null)return{specNode:void 0,stepResult:void 0,toolOutput:`No network requests matching: ${t.urlPattern}`};let i=o.statusCode==null?"pending":String(o.statusCode),s=Object.entries(o.responseHeaders).map(([l,c])=>` ${l}: ${c}`).join(`
|
|
23
23
|
`),a=o.responseBody??"(no body captured)";return{specNode:void 0,stepResult:void 0,toolOutput:`${o.method} ${i} ${o.url}
|
|
24
24
|
|
|
25
25
|
Response Headers:
|
|
26
26
|
${s}
|
|
27
27
|
|
|
28
28
|
Body:
|
|
29
|
-
${a}`}}});import{z as
|
|
29
|
+
${a}`}}});import{z as uo}from"zod";var El=uo.object({selector:uo.string().optional().describe("CSS selector to scope the tree to a subtree (defaults to full page)")}),po=y({description:"Get the accessibility tree (ARIA snapshot) of the current page or a specific element. Use this to verify ARIA roles, labels, states, and the semantic structure of the page.",name:"get_accessibility_tree",schema:El,execute:async(e,t)=>{let r=t.selector==null?e.page.locator(":root"):e.page.locator(t.selector);try{return{specNode:void 0,stepResult:void 0,toolOutput:await r.ariaSnapshot()}}catch{return{specNode:void 0,stepResult:void 0,toolOutput:"(unable to capture accessibility tree)"}}}});import{z as Tl}from"zod";var $l=Tl.object({}),mo=y({description:"Get a text representation of the current page content for inspection",name:"get_page_content",schema:$l,execute:async(e,t)=>{let r=await e.page.locator("body").textContent({timeout:5e3}),n=e.page.url(),o=await e.page.title();return{specNode:void 0,stepResult:void 0,toolOutput:`URL: ${n}
|
|
30
30
|
Title: ${o}
|
|
31
31
|
|
|
32
|
-
${r??""}`}}});import{z as
|
|
32
|
+
${r??""}`}}});import{z as Al}from"zod";var Il=Al.object({}),fo=y({description:"Get uncaught JavaScript exceptions (page errors) that have occurred. These are runtime errors thrown in the browser that were not caught by error handlers.",name:"get_page_errors",schema:Il,execute:(e,t)=>{if(e.monitor.pageErrors.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:"No page errors recorded."};let r=e.monitor.pageErrors.map((n,o)=>`--- Error ${String(o+1)} ---
|
|
33
33
|
${n}`).join(`
|
|
34
34
|
|
|
35
35
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(e.monitor.pageErrors.length)} page errors:
|
|
36
36
|
|
|
37
|
-
${r}`}}});import{z as
|
|
37
|
+
${r}`}}});import{z as go}from"zod";var jl=go.object({type:go.enum(["all","cookies","localStorage","sessionStorage"]).describe("Which storage to retrieve").default("all")}),ho=y({description:"Get browser storage state: cookies (with httpOnly, secure, sameSite flags), localStorage, and/or sessionStorage. Useful for verifying authentication state, security cookie flags, and stored data.",name:"get_storage",schema:jl,execute:async(e,t)=>({specNode:void 0,stepResult:void 0,toolOutput:[...t.type==="all"||t.type==="cookies"?[await Nl(e.page)]:[],...t.type==="all"||t.type==="localStorage"?[await yo(e.page,"localStorage")]:[],...t.type==="all"||t.type==="sessionStorage"?[await yo(e.page,"sessionStorage")]:[]].join(`
|
|
38
38
|
|
|
39
|
-
`)})});async function
|
|
39
|
+
`)})});async function Nl(e){let t=await e.context().cookies();if(t.length===0)return`## Cookies
|
|
40
40
|
(none)`;let r=t.map(n=>` ${n.name}=${n.value} (domain=${n.domain}, httpOnly=${String(n.httpOnly)}, secure=${String(n.secure)}, sameSite=${n.sameSite})`);return`## Cookies (${String(t.length)})
|
|
41
41
|
${r.join(`
|
|
42
|
-
`)}`}async function
|
|
43
|
-
${String(r)}`}import{z as
|
|
42
|
+
`)}`}async function yo(e,t){let r=await e.evaluate(`JSON.stringify(Object.fromEntries(Object.entries(${t})))`);return`## ${t}
|
|
43
|
+
${String(r)}`}import{z as wr}from"zod";var Ol=wr.object({action:wr.enum(["accept","dismiss"]).describe("Whether to accept or dismiss the dialog"),promptText:wr.string().optional().describe("Text to enter for prompt dialogs")}),wo=y({description:"Set up a handler for the next browser dialog (alert, confirm, prompt). Call this BEFORE the action that triggers the dialog.",name:"handle_dialog",schema:Ol,execute:(e,t)=>{let r=performance.now();e.page.once("dialog",async i=>{t.action==="accept"?await i.accept(t.promptText??void 0):await i.dismiss()});let n=`agent-step-${String(e.stepIndex)}`,o={action:t.action,id:n,type:"handleDialog"};return k({assertions:[],detail:`Dialog handler set: ${t.action}`,duration:performance.now()-r,nodeType:"handleDialog",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Handle dialog: ${t.action}`})}});import{z as bo}from"zod";var Dl=bo.object({selector:bo.string().describe("CSS selector for the element to hover over")}),So=y({description:"Hover over an element matching the CSS selector",name:"hover",schema:Dl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).hover({timeout:5e3}),k({assertions:[],detail:`Hovered over ${t.selector}`,duration:performance.now()-r,nodeType:"hover",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Hover ${t.selector}`})}});import{z as br}from"zod";var Ll=br.object({permission:br.string().describe("Permission name (e.g. geolocation, notifications, camera, clipboard-read)"),state:br.enum(["granted","prompt"]).describe("Permission state to set")}),vo=y({description:"Set a browser permission state (geolocation, notifications, camera, etc.)",name:"set_permission",schema:Ll,execute:async(e,t)=>{let r=performance.now(),n=e.page.context();t.state==="granted"?await n.grantPermissions([t.permission]):await n.clearPermissions();let i={id:`agent-step-${String(e.stepIndex)}`,permission:t.permission,state:t.state,type:"setPermission"};return k({assertions:[],detail:`Set ${t.permission} to ${t.state}`,duration:performance.now()-r,nodeType:"setPermission",page:e.page,runStartTime:e.runStartTime,specNode:i,status:"passed",stepIndex:e.stepIndex,title:`Set permission: ${t.permission} \u2192 ${t.state}`})}});import{z as ko}from"zod";var _l=ko.object({url:ko.string().describe("The URL to navigate to")}),Ro=y({description:"Navigate the browser to a URL",name:"navigate",schema:_l,execute:async(e,t)=>{let r=performance.now();await e.page.goto(t.url,{waitUntil:"domcontentloaded"});let o={id:`agent-step-${String(e.stepIndex)}`,type:"goto",url:{type:"static",value:t.url}};return k({assertions:[],detail:`Navigated to ${t.url}`,duration:performance.now()-r,nodeType:"goto",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Navigate to ${t.url}`})}});import{z as xo}from"zod";var Ul=xo.object({key:xo.string().describe("Key to press, e.g. 'Enter', 'Tab', 'Escape'")}),Po=y({description:"Press a keyboard key",name:"press",schema:Ul,execute:async(e,t)=>{let r=performance.now();await e.page.keyboard.press(t.key);let o={id:`agent-step-${String(e.stepIndex)}`,key:t.key,type:"press"};return k({assertions:[],detail:`Pressed ${t.key}`,duration:performance.now()-r,nodeType:"press",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Press ${t.key}`})}});import{z as Sr}from"zod";var Vl=Sr.object({height:Sr.number().int().positive().describe("Viewport height in pixels"),width:Sr.number().int().positive().describe("Viewport width in pixels")}),Co=y({description:"Resize the browser viewport to the specified dimensions. Use this to test responsive layouts at different screen sizes (e.g. mobile: 375x812, tablet: 768x1024, desktop: 1440x900).",name:"resize_viewport",schema:Vl,execute:async(e,t)=>{let r=performance.now();await e.page.setViewportSize({height:t.height,width:t.width});let n=`agent-step-${String(e.stepIndex)}`,o={height:t.height,id:n,type:"setViewport",width:t.width};return k({assertions:[],detail:`Resized viewport to ${String(t.width)}x${String(t.height)}`,duration:performance.now()-r,nodeType:"setViewport",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Resize viewport to ${String(t.width)}x${String(t.height)}`})}});import{z as Eo}from"zod";var Fl=Eo.object({selector:Eo.string().describe("CSS selector for the element to right-click")}),To=y({description:"Right-click an element to open the context menu",name:"right_click",schema:Fl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({button:"right",timeout:5e3}),k({assertions:[],detail:`Right-clicked ${t.selector}`,duration:performance.now()-r,nodeType:"rightClick",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Right-click ${t.selector}`})}});import{z as $o}from"zod";var Ml=$o.object({pattern:$o.string().describe("Regex pattern to search console log messages")}),Ao=y({description:"Search console log messages for a regex pattern. Returns matching entries.",name:"search_console",schema:Ml,execute:(e,t)=>{let r=new RegExp(t.pattern,"i"),n=e.monitor.consoleEntries.filter(i=>r.test(i.text));if(n.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:`No console messages matching: ${t.pattern}`};let o=n.map(i=>Hl(i)).join(`
|
|
44
44
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(n.length)} matching console messages:
|
|
45
|
-
${o}`}}});function
|
|
45
|
+
${o}`}}});function Hl(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as Io}from"zod";var Wl=Io.object({pattern:Io.string().describe("Regex pattern to search across network request URLs and response bodies")}),jo=y({description:"Search network requests and response bodies for a regex pattern. Useful for finding API calls, tokens, or specific data in responses.",name:"search_network",schema:Wl,execute:(e,t)=>{let r=new RegExp(t.pattern,"i"),n=e.monitor.networkEntries.filter(i=>r.test(i.url)||i.responseBody!=null&&r.test(i.responseBody));if(n.length===0)return{specNode:void 0,stepResult:void 0,toolOutput:`No network entries matching: ${t.pattern}`};let o=n.map(i=>{let s=i.statusCode==null?"pending":String(i.statusCode),a=r.test(i.url)?" [URL match]":"",l=i.responseBody!=null&&r.test(i.responseBody)?" [body match]":"";return`${i.method} ${s} ${i.url}${a}${l}`}).join(`
|
|
46
46
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(n.length)} matching network entries:
|
|
47
|
-
${o}`}}});import{z as
|
|
48
|
-
`),o=
|
|
47
|
+
${o}`}}});import{z as No}from"zod";var ql=20,Bl=2,zl=No.object({pattern:No.string().describe("Regex pattern to search for in the page HTML")}),Oo=y({description:"Search the current page's full HTML/DOM for a regex pattern. Returns matching lines with context. Useful for finding elements, attributes, text content, or hidden data without reading the entire page.",name:"search_page",schema:zl,execute:async(e,t)=>{let n=(await e.page.content()).split(`
|
|
48
|
+
`),o=Gl({contextLines:Bl,lines:n,maxResults:ql,pattern:t.pattern});return o.length===0?{specNode:void 0,stepResult:void 0,toolOutput:`No matches found for pattern: ${t.pattern}`}:{specNode:void 0,stepResult:void 0,toolOutput:o.join(`
|
|
49
49
|
---
|
|
50
|
-
`)}}});function
|
|
51
|
-
`);i.push(d)}),i}import{z as
|
|
52
|
-
${u.stack??""}`)}function c(u){let f=u.failure(),b=new
|
|
53
|
-
`);async function
|
|
50
|
+
`)}}});function Gl({contextLines:e,lines:t,maxResults:r,pattern:n}){let o=new RegExp(n,"i"),i=[];return t.forEach((s,a)=>{if(i.length>=r||!o.test(s))return;let l=Math.max(0,a-e),c=Math.min(t.length-1,a+e),d=t.slice(l,c+1).map((u,f)=>{let b=l+f+1;return`${l+f===a?">":" "} ${String(b)}: ${u}`}).join(`
|
|
51
|
+
`);i.push(d)}),i}import{z as vr}from"zod";var Kl=vr.object({selector:vr.string().describe("CSS selector for the select element"),value:vr.string().describe("The option value to select")}),Do=y({description:"Select an option from a dropdown/select element",name:"select",schema:Kl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).selectOption(t.value,{timeout:5e3}),k({assertions:[],detail:`Selected "${t.value}" in ${t.selector}`,duration:performance.now()-r,nodeType:"select",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Select ${t.value}`})}});import{z as Lo}from"zod";var Jl=Lo.object({selector:Lo.string().describe("CSS selector for the checkbox to uncheck")}),_o=y({description:"Uncheck a checkbox matching the CSS selector",name:"uncheck",schema:Jl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).uncheck({timeout:5e3}),k({assertions:[],detail:`Unchecked ${t.selector}`,duration:performance.now()-r,nodeType:"uncheck",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Uncheck ${t.selector}`})}});var St=class{method;requestHeaders;requestPostData;timestamp;url;responseBody=void 0;responseHeaders={};statusCode=void 0;constructor(t){this.method=t.method(),this.requestHeaders=t.headers(),this.requestPostData=t.postData()??void 0,this.timestamp=Date.now(),this.url=t.url()}applyResponse(t){this.statusCode=t.status(),this.responseHeaders=t.headers(),t.text().then(r=>{this.responseBody=r.length>1e5?`${r.slice(0,1e5)}... (truncated)`:r}).catch(()=>{this.responseBody="(unable to read body)"})}};function Qe(e){let t=[],r=[],n=[],o=new Map;function i(u){t.push({level:u.type(),text:u.text(),timestamp:Date.now(),url:u.location().url})}function s(u){let f=new St(u);o.set(u,f),r.push(f)}function a(u){let f=o.get(u.request());f!=null&&(o.delete(u.request()),f.applyResponse(u))}function l(u){n.push(`${u.message}
|
|
52
|
+
${u.stack??""}`)}function c(u){let f=u.failure(),b=new St(u);b.responseBody=`(request failed: ${f?.errorText??"unknown"})`,r.push(b)}e.on("console",i),e.on("request",s),e.on("response",a),e.on("pageerror",l),e.on("requestfailed",c);function d(){e.off("console",i),e.off("request",s),e.off("response",a),e.off("pageerror",l),e.off("requestfailed",c)}return{consoleEntries:t,detach:d,networkEntries:r,pageErrors:n}}var kr=[Ro,Xn,no,Po,Gn,_o,Do,So,mo,Oo,Jn,To,wo,Qn,vo,Bn,Hn,Wn,Vn,Mn,io,ao,co,fo,po,ho,Ao,jo,Co,ro,eo],Yl=new Map(kr.map(e=>[e.name,e])),Rr=kr.map(e=>e.anthropicTool),Uo=kr.map(e=>`- **${e.name}**: ${e.anthropicTool.description??""}`).join(`
|
|
53
|
+
`);async function Vo({input:e,monitor:t,name:r,page:n,runStartTime:o,stepIndex:i}){let s=Yl.get(r);if(s==null)throw new Error(`Unknown agent tool: ${r}`);return s.execute({monitor:t,page:n,runStartTime:o,stepIndex:i},e)}import Sv from"fs";import kv from"path";import Xl from"pino";var g=Xl({transport:{options:{ignore:"pid,hostname"},target:"pino-pretty"}});var Zl=50,Fo=16384;async function xr({baseUrl:e,executedPreconditions:t,extraVariables:r,onStep:n,page:o,runId:i,serverUrl:s,spec:a,systemPrompt:l,token:c,workflowContext:d}){let u=new Ql({apiKey:"ripplo",baseURL:`${s}/api/proxy/anthropic`,defaultHeaders:{Authorization:`Bearer ${c}`,"x-run-id":i}}),f=performance.now(),b=Qe(o);await ac({baseUrl:e,page:o});let w=rc({extraVariables:r,spec:a}),h=oc({baseUrl:e,executedPreconditions:t,spec:a,systemPrompt:l,variables:w,workflowContext:d}),v=ic({baseUrl:e,spec:a,variables:w}),V=[{content:sc({page:o,startUrl:v}),role:"user"}],B=[],L=[],F={findings:"",stepIndex:0,verdict:void 0};F=await ec({client:u,messages:V,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:L,state:F,steps:B,system:h}),F.verdict==null&&(F=await tc({client:u,messages:V,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:L,state:F,steps:B,system:h}));let ie=cc(L);return{findings:F.findings,generatedSpec:ie,monitor:b,steps:B,verdict:F.verdict??"fail"}}function Mo({result:e,state:t}){return{findings:e.newFindings.length>0?e.newFindings:t.findings,stepIndex:e.nextStepIndex,verdict:e.verdict??t.verdict}}async function ec({client:e,messages:t,monitor:r,onStep:n,page:o,runStartTime:i,specNodes:s,state:a,steps:l,system:c}){let d=a;for(let u=0;u<Zl;u++){g.info("Agent iteration %d",u+1);let f=await e.messages.create({max_tokens:Fo,messages:t,model:"server-controlled",system:c,tools:Rr}),b=await Ho({messages:t,monitor:r,onStep:n,page:o,response:f,runStartTime:i,specNodes:s,stepIndex:d.stepIndex,steps:l});if(d=Mo({result:b,state:d}),!b.continueLoop)break}return d}async function tc({client:e,messages:t,monitor:r,onStep:n,page:o,runStartTime:i,specNodes:s,state:a,steps:l,system:c}){g.warn("Agent exited without calling complete_test \u2014 forcing completion"),t.push({content:"You must call the complete_test tool now with your verdict and summary. Do not perform any more actions \u2014 just call complete_test.",role:"user"});let d=await e.messages.create({max_tokens:Fo,messages:t,model:"server-controlled",system:c,tool_choice:{name:"complete_test",type:"tool"},tools:Rr}),u=await Ho({messages:t,monitor:r,onStep:n,page:o,response:d,runStartTime:i,specNodes:s,stepIndex:a.stepIndex,steps:l});return Mo({result:u,state:a})}function rc({extraVariables:e,spec:t}){let r=nc(e,t?.variableNamespaces);return{...Xe({defs:t?.variables}),...r}}function nc(e,t){if(e==null||t==null)return{};let r=new Map;Object.entries(t).forEach(([o,i])=>{r.set(i,o)});let n={};return Object.entries(e).forEach(([o,i])=>{let s=r.get(o);Object.entries(i).forEach(([a,l])=>{n[s==null?a:`${s}.${a}`]=l})}),n}function oc({baseUrl:e,executedPreconditions:t,spec:r,systemPrompt:n,variables:o,workflowContext:i}){let s=i==null?"":[`
|
|
54
54
|
|
|
55
55
|
## Workflow Under Test`,`**Name:** ${i.name}`,`**Description:** ${i.description}`,`**Expected Outcome:** ${i.expectedOutcome}`,`
|
|
56
56
|
Focus your testing ONLY on this specific workflow. Do not test unrelated parts of the application.`].join(`
|
|
@@ -71,61 +71,61 @@ Do not repeat any of these steps.`,d=Object.entries(o),u=d.map(([b,w])=>`- **${b
|
|
|
71
71
|
|
|
72
72
|
## Resolved Variables
|
|
73
73
|
${u}`;return[`You are testing the application at: ${e}`,"Use the provided tools to navigate, interact with, and assert things about the page.","Use get_page_content to inspect the page when you need to understand what's on screen.","Follow the workflow steps to complete the task.",`
|
|
74
|
-
## Available Tools`,
|
|
74
|
+
## Available Tools`,Uo,s,c,a,f,`
|
|
75
75
|
## Agent Profile (HIGHEST PRIORITY \u2014 these instructions override any defaults above)`,n].join(`
|
|
76
|
-
`)}function
|
|
77
|
-
`),nextStepIndex:a,verdict:void 0};let u=[],f=a,b,w;for(let v of d){let E=await
|
|
78
|
-
`);return{continueLoop:b==null&&o.stop_reason==="tool_use",newFindings:h,nextStepIndex:f,verdict:b}}async function
|
|
76
|
+
`)}function ic({baseUrl:e,spec:t,variables:r}){if(t==null)return e;let n=t.nodes[t.entryNode];if(n==null||n.type!=="goto"||n.url.type!=="static")return e;let i=n.url.value.replaceAll(/\{\{(\w+)\}\}/g,(s,a)=>{let l=r[a];return l==null?`{{${a}}}`:typeof l=="object"?JSON.stringify(l):String(l)});return i.startsWith("http")?i:`${e}${i.startsWith("/")?"":"/"}${i}`}function sc({page:e,startUrl:t}){let r=e.url();return r!=="about:blank"&&r.length>0?`You are already on the page at ${r}. Begin testing from this page \u2014 do not navigate away unless the workflow requires it.`:`Navigate to ${t} and begin testing.`}async function ac({baseUrl:e,page:t}){let r=new URL(e).origin;await t.route("**/*",n=>{let o=n.request();return o.isNavigationRequest()&&new URL(o.url()).origin!==r?(g.warn("Blocked navigation to off-origin URL: %s",o.url()),n.abort("blockedbyclient")):n.continue()})}async function Ho({messages:e,monitor:t,onStep:r,page:n,response:o,runStartTime:i,specNodes:s,stepIndex:a,steps:l}){let c=o.content.filter(v=>v.type==="text").map(v=>v.text),d=o.content.filter(v=>v.type==="tool_use");if(d.length===0)return{continueLoop:!1,newFindings:c.join(`
|
|
77
|
+
`),nextStepIndex:a,verdict:void 0};let u=[],f=a,b,w;for(let v of d){let E=await lc({block:v,monitor:t,onStep:r,page:n,runStartTime:i,specNodes:s,stepIndex:f,steps:l});u.push(E.toolResult),f=E.nextStepIndex,E.verdict!=null&&(b=E.verdict,w=E.summary)}e.push({content:o.content,role:"assistant"},{content:u,role:"user"});let h=w??c.join(`
|
|
78
|
+
`);return{continueLoop:b==null&&o.stop_reason==="tool_use",newFindings:h,nextStepIndex:f,verdict:b}}async function lc({block:e,monitor:t,onStep:r,page:n,runStartTime:o,specNodes:i,stepIndex:s,steps:a}){try{let l=await Vo({input:e.input,monitor:t,name:e.name,page:n,runStartTime:o,stepIndex:s}),c={content:l.toolOutput,tool_use_id:e.id,type:"tool_result"};return l.kind==="verdict"?(g.info(" [%d] %s \u2014 verdict: %s",s,e.name,l.verdict),{nextStepIndex:s,summary:l.summary,toolResult:c,verdict:l.verdict}):(l.specNode!=null&&i.push(l.specNode),l.stepResult!=null?(a.push(l.stepResult),r?.(l.stepResult),g.info(" [%d] %s \u2014 %s",s,e.name,l.stepResult.status),{nextStepIndex:s+1,summary:void 0,toolResult:c,verdict:void 0}):(g.info(" [%d] %s \u2014 info",s,e.name),{nextStepIndex:s,summary:void 0,toolResult:c,verdict:void 0}))}catch(l){let c=l instanceof Error?l.message:"Unknown error";g.error(" [%d] %s \u2014 error: %s",s,e.name,c);let d=await we({page:n,runStartTime:o,targets:[]}),u={annotations:d.annotations,assertions:[],detail:`Error: ${c}`,duration:0,nodeId:`agent-step-${String(s)}`,nodeType:"click",recordingEndMs:void 0,recordingStartMs:void 0,snapshotTimestamp:d.snapshotTimestamp,status:"failed",stepIndex:s,title:`${e.name} (error)`,url:d.url,viewportHeight:d.viewportHeight,viewportWidth:d.viewportWidth};return a.push(u),r?.(u),{nextStepIndex:s+1,summary:void 0,toolResult:{content:`Error: ${c}`,is_error:!0,tool_use_id:e.id,type:"tool_result"},verdict:void 0}}}function cc(e){if(e.length===0)return{entryNode:"",nodes:{}};let t={};e.forEach((n,o)=>{let i=e[o+1],s=i==null?n:{...n,next:i.id};t[n.id]=s});let r=e[0];if(r==null)throw new Error("Expected at least one spec node after length check");return{entryNode:r.id,nodes:t}}function Pr({description:e,output:t,successCriteria:r}){let n=[`## Agent Identity
|
|
79
79
|
${e}`];t!=null&&t.length>0&&n.push(`## Output
|
|
80
80
|
${t}`),r!=null&&r.length>0&&n.push(`## Success Criteria
|
|
81
|
-
${r}`);let o=["## Completing Your Evaluation",'When you finish your evaluation, you MUST call the `complete_test` tool with your verdict ("pass" or "fail") and a `summary` string.',
|
|
81
|
+
${r}`);let o=["## Completing Your Evaluation",'When you finish your evaluation, you MUST call the `complete_test` tool with your verdict ("pass" or "fail") and a `summary` string.',dc({hasSuccessCriteria:r!=null&&r.length>0}),uc({hasOutput:t!=null&&t.length>0})];return n.push(o.join(`
|
|
82
82
|
`)),n.join(`
|
|
83
83
|
|
|
84
|
-
`)}function
|
|
84
|
+
`)}function dc({hasSuccessCriteria:e}){return e?"Base your verdict strictly on the Success Criteria defined above. A test passes ONLY if all success criteria are met, and fails if any criterion is not met. Individual step failures during exploration do not necessarily mean the test failed, but the success criteria are the ultimate authority for your verdict.":"Base your verdict on whether the workflow worked correctly. Individual step failures during exploration do not necessarily mean the test failed."}function uc({hasOutput:e}){return e?'The `summary` parameter is the ONLY output the user will see. You MUST use the `summary` field for EXACTLY the output described in the "Output" section above \u2014 nothing else. Do not describe what you did, do not list steps, do not add a test summary. The `summary` must contain ONLY what the Output section asks for, word for word if it specifies exact text.':"Include a brief summary of what you found in the `summary` parameter."}import{execFile as pc}from"child_process";import{createRequire as mc}from"module";import Wo from"fs";import qo from"path";import{chromium as Bo}from"playwright";async function Ce({headed:e}){process.env.PW_TEST_SCREENSHOT_NO_FONTS_READY="1";try{return await Bo.launch({headless:!e})}catch(t){throw fc(t)?new Error(`Playwright browsers are not installed. Run:
|
|
85
85
|
|
|
86
86
|
npx playwright install chromium
|
|
87
|
-
`):t}}async function
|
|
87
|
+
`):t}}async function Cr(){let e=Bo.executablePath();if(Wo.existsSync(e))return;g.info("Chromium not found. Installing via Playwright...");let t=mc(import.meta.url),r=qo.dirname(t.resolve("playwright/package.json")),n=qo.join(r,"cli.js");if(await new Promise((o,i)=>{pc(process.execPath,[n,"install","chromium"],s=>{if(s!=null){i(new Error(`Playwright install failed: ${s.message}`));return}o()})}),!Wo.existsSync(e))throw new Error(`Playwright browser installation failed. Try running manually:
|
|
88
88
|
|
|
89
89
|
npx playwright install chromium
|
|
90
|
-
`);g.info("\u2713 Chromium installed")}function
|
|
90
|
+
`);g.info("\u2713 Chromium installed")}function fc(e){return e instanceof Error?e.message.includes("Executable doesn't exist"):!1}import{mkdir as Er,writeFile as se}from"fs/promises";import J from"path";async function vt({context:e,page:t,runId:r,stepIndex:n,stepResult:o}){try{let i=J.join(process.cwd(),".ripplo","debug",r,"steps",String(n));await Er(i,{recursive:!0});let s={annotations:o.annotations,assertions:o.assertions,detail:o.detail,duration:o.duration,nodeId:o.nodeId,nodeType:o.nodeType,snapshotTimestamp:o.snapshotTimestamp,status:o.status,stepIndex:o.stepIndex,title:o.title,url:o.url,viewportHeight:o.viewportHeight,viewportWidth:o.viewportWidth};await Promise.all([se(J.join(i,"info.json"),JSON.stringify(s,null,2)),gc({context:e,page:t,stepDir:i})])}catch(i){let s=i instanceof Error?i.message:String(i);g.warn("Failed to write step debug data for step %d: %s",n,s)}}async function gc({context:e,page:t,stepDir:r}){let[n,o,i,s]=await Promise.all([t.content().catch(()=>"(unable to capture DOM)"),yc(t),hc({context:e,page:t}),t.screenshot({fullPage:!1}).catch(()=>{})]);await Promise.all([se(J.join(r,"dom.html"),n),se(J.join(r,"accessibility-tree.txt"),o),se(J.join(r,"storage.json"),JSON.stringify(i,null,2)),s==null?Promise.resolve():se(J.join(r,"screenshot.png"),s)])}async function yc(e){try{return await e.locator(":root").ariaSnapshot()}catch{return"(unable to capture accessibility tree)"}}async function hc({context:e,page:t}){let[r,n]=await Promise.all([t.evaluate(()=>({localStorage:Object.fromEntries(Array.from({length:localStorage.length},(o,i)=>{let s=localStorage.key(i);return s==null?void 0:[s,localStorage.getItem(s)??""]}).filter(o=>o!=null)),sessionStorage:Object.fromEntries(Array.from({length:sessionStorage.length},(o,i)=>{let s=sessionStorage.key(i);return s==null?void 0:[s,sessionStorage.getItem(s)??""]}).filter(o=>o!=null))})).catch(()=>({localStorage:{},sessionStorage:{}})),e.cookies().catch(()=>[])]);return{cookies:n,localStorage:r.localStorage,sessionStorage:r.sessionStorage}}async function kt({monitor:e,runId:t,steps:r,summary:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await Er(o,{recursive:!0}),await Promise.all([se(J.join(o,"summary.txt"),wc({steps:r,summary:n})),se(J.join(o,"console.log"),bc(e.consoleEntries)),se(J.join(o,"network.jsonl"),Sc(e.networkEntries)),se(J.join(o,"page-errors.log"),e.pageErrors.join(`
|
|
91
91
|
---
|
|
92
|
-
`))]),g.info("Debug artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write run debug summary: %s",i)}}function
|
|
93
|
-
`)}function
|
|
94
|
-
`)}function
|
|
95
|
-
`)}async function
|
|
92
|
+
`))]),g.info("Debug artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write run debug summary: %s",i)}}function wc({steps:e,summary:t}){return[`Run ID: ${t.runId}`,`Workflow: ${t.workflowName}`,`Status: ${t.status}`,`Duration: ${String(t.duration)}ms`,`Passed: ${String(t.passCount)}`,`Failed: ${String(t.failCount)}`,"","Steps:",...e.map(n=>` [${String(n.stepIndex)}] ${n.status==="passed"?"\u2713":"\u2717"} ${n.title} (${String(n.duration)}ms) \u2014 ${n.detail??"ok"}`)].join(`
|
|
93
|
+
`)}function bc(e){return e.map(t=>`[${new Date(t.timestamp).toISOString()}] [${t.level.toUpperCase()}] (${t.url}) ${t.text}`).join(`
|
|
94
|
+
`)}function Sc(e){return e.map(t=>JSON.stringify(t)).join(`
|
|
95
|
+
`)}async function zo({error:e,runId:t,stack:r,workflowName:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await Er(o,{recursive:!0});let i=r==null?e:`${e}
|
|
96
96
|
|
|
97
97
|
${r}`,s=[`Run ID: ${t}`,`Workflow: ${n}`,"Status: failed","",`Error: ${e}`,"",r==null?"":`Stack trace:
|
|
98
98
|
${r}`].join(`
|
|
99
|
-
`);await Promise.all([se(J.join(o,"error.txt"),i),se(J.join(o,"summary.txt"),s)]),g.info("Debug error artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write error debug artifacts: %s",i)}}import{readFileSync as
|
|
100
|
-
`)
|
|
101
|
-
`+
|
|
102
|
-
`),w={body:
|
|
99
|
+
`);await Promise.all([se(J.join(o,"error.txt"),i),se(J.join(o,"summary.txt"),s)]),g.info("Debug error artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write error debug artifacts: %s",i)}}import{readFileSync as vc}from"fs";import{createRequire as kc}from"module";import Go from"path";import{gzipSync as Rc}from"zlib";var xc=kc(import.meta.url),Pc=xc.resolve("rrweb"),Cc=Go.join(Go.dirname(Pc),"rrweb.umd.min.cjs"),Ec=vc(Cc,"utf8"),Tc=[";(function() {"," try {"," if (window.__ripploRrwebLoaded) return;"," window.__ripploRrwebLoaded = true;"," window.__ripploRrwebBuffer = [];"," window.__ripploRrwebDrain = function() {"," var out = window.__ripploRrwebBuffer;"," window.__ripploRrwebBuffer = [];"," return out;"," };"," var r = window.rrweb;"," if (r == null || r.record == null) {"," console.warn('[ripplo] rrweb global not found');"," return;"," }"," function startRecording() {"," if (window.__ripploRrwebStartedAt != null) return;"," window.__ripploRrwebStartedAt = Date.now();"," var stop = r.record({"," emit: function(event) { window.__ripploRrwebBuffer.push(event); },"," recordCanvas: false,"," recordCrossOriginIframes: false,"," });"," if (r.record.mirror) window.__ripploRrwebMirror = r.record.mirror;"," window.__ripploRrwebStop = stop;"," }"," window.__ripploRrwebStart = startRecording;"," // Auto-start on every bootstrap run so agent-driven tests (which don't"," // emit a 'first step' signal before navigating) capture from the start."," startRecording();"," } catch (err) {"," console.error('[ripplo] rrweb bootstrap failed', err && err.message ? err.message : err);"," }","})();"].join(`
|
|
100
|
+
`),$c=Ec+`
|
|
101
|
+
`+Tc;function Ac(){return globalThis.__ripploRrwebStartedAt}function Ic(){globalThis.__ripploRrwebStart?.()}function jc(){globalThis.__ripploRrwebStop?.()}function Nc(){return globalThis.__ripploRrwebDrain?.()??[]}async function Rt(e){let t,r=0;async function n(){await e.addScriptTag({content:$c}).catch(()=>{})}await n(),e.on("load",()=>{n()});async function o(){await e.evaluate(Ic).catch(()=>{});let l=await e.evaluate(Ac).catch(()=>{});typeof l=="number"&&(t??=l)}function i(){if(t!=null)return Date.now()-t}async function s(){let l=await e.evaluate(Nc).catch(()=>[]),c=l[0],d=l.at(-1);if(c==null||d==null)return;t??=c.timestamp;let u=t,f=l.map(h=>JSON.stringify(h)).join(`
|
|
102
|
+
`),w={body:Rc(Buffer.from(f,"utf8")),chunkIndex:r,endTimestamp:d.timestamp-u,eventCount:l.length,startTimestamp:c.timestamp-u};return r+=1,w}async function a(){await e.evaluate(jc).catch(()=>{})}return{currentOffsetMs:i,detach:a,start:o,takeChunk:s}}async function Tr({baseUrl:e,cookies:t,executedPreconditions:r,extraVariables:n,headed:o,runId:i,serverUrl:s,spec:a,streaming:l,systemPrompt:c,token:d,workflowContext:u}){let f=await Ce({headed:o}),b=await f.newContext({baseURL:e});t.length>0&&(await b.addCookies([...t]),g.info("Injected %d cookies from preconditions",t.length));let w=await b.newPage(),h=await Rt(w);async function v(){let B=await h.takeChunk();B!=null&&l.enqueueRecordingChunk(B)}let E=setInterval(()=>{v()},2e3);await h.start();try{let B=function(ae){let Ge={...ae,recordingEndMs:h.currentOffsetMs(),recordingStartMs:ae.recordingStartMs??h.currentOffsetMs()};l.enqueueStep(Ge),l.flushSteps(),vt({context:b,page:w,runId:i,stepIndex:Ge.stepIndex,stepResult:Ge})};var V=B;let L=await xr({baseUrl:e,executedPreconditions:r,extraVariables:n,onStep:B,page:w,runId:i,serverUrl:s,spec:a,systemPrompt:c,token:d,workflowContext:u}),F=L.verdict==="pass"?"passed":"failed";await l.complete({statusOverride:F,steps:L.steps,summary:L.findings});let ie=L.steps.filter(ae=>ae.status==="passed").length,$e=L.steps.filter(ae=>ae.status==="failed").length,_={duration:L.steps.reduce((ae,Ge)=>ae+Ge.duration,0),failCount:$e,passCount:ie,runId:i,status:F,workflowName:u.name};await kt({monitor:L.monitor,runId:i,steps:L.steps,summary:_}),g.info("Agent test complete: %d passed, %d failed",ie,$e),g.info(`
|
|
103
103
|
=== Agent Summary ===
|
|
104
|
-
%s`,L.findings)}finally{clearInterval(E),await h.detach(),await v(),await f.close()}}async function
|
|
104
|
+
%s`,L.findings)}finally{clearInterval(E),await h.detach(),await v(),await f.close()}}async function $r({expected:e,locator:t,operator:r,timeout:n}){let o=await t.textContent({timeout:n});return Ze({actual:o??"",expected:e,label:"Text",operator:r})}function xt({expected:e,operator:t,url:r}){return Ze({actual:r,expected:e,label:"URL",operator:t})}async function Ar({expected:e,locator:t,operator:r}){let n=await t.count();return ti({actual:n,expected:e,label:"Count",operator:r})}async function Ir({expected:e,locator:t,operator:r,timeout:n}){let o=await t.inputValue({timeout:n});return Ze({actual:o,expected:e,label:"Value",operator:r})}async function jr({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),{description:"Element is visible",detail:void 0,status:"passed"}}catch{return{description:"Element is visible",detail:"Element not visible",status:"failed"}}}async function Nr({locator:e,timeout:t}){try{return await e.waitFor({state:"hidden",timeout:t}),{description:"Element is not visible",detail:void 0,status:"passed"}}catch{return{description:"Element is not visible",detail:"Element still visible",status:"failed"}}}async function Ko({attribute:e,expected:t,locator:r,operator:n,timeout:o}){let i=await r.getAttribute(e,{timeout:o});return Ze({actual:i??"",expected:t,label:`Attribute "${e}"`,operator:n})}async function Jo({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),await e.isEnabled()?{description:"Element is enabled",detail:void 0,status:"passed"}:{description:"Element is enabled",detail:"Element is disabled",status:"failed"}}catch{return{description:"Element is enabled",detail:"Element not found",status:"failed"}}}async function Yo({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),await e.isDisabled()?{description:"Element is disabled",detail:void 0,status:"passed"}:{description:"Element is disabled",detail:"Element is enabled",status:"failed"}}catch{return{description:"Element is disabled",detail:"Element not found",status:"failed"}}}async function Xo({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),await e.isChecked()?{description:"Element is checked",detail:void 0,status:"passed"}:{description:"Element is checked",detail:"Element is not checked",status:"failed"}}catch{return{description:"Element is checked",detail:"Element not found",status:"failed"}}}async function Qo({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),await e.isChecked()?{description:"Element is not checked",detail:"Element is checked",status:"failed"}:{description:"Element is not checked",detail:void 0,status:"passed"}}catch{return{description:"Element is not checked",detail:"Element not found",status:"failed"}}}async function Zo({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),!await e.evaluate("(el) => document.activeElement === el")?{description:"Element is focused",detail:"Element is not focused",status:"failed"}:{description:"Element is focused",detail:void 0,status:"passed"}}catch{return{description:"Element is focused",detail:"Element not found",status:"failed"}}}async function ei({locator:e,timeout:t}){try{return await e.waitFor({state:"visible",timeout:t}),!!await e.evaluate("(el) => document.activeElement === el")?{description:"Element is not focused",detail:"Element is focused",status:"failed"}:{description:"Element is not focused",detail:void 0,status:"passed"}}catch{return{description:"Element is not focused",detail:"Element not found",status:"failed"}}}function Ze(e){let t=`${e.label} ${e.operator} "${e.expected}"`,r=Oc(e),n=r?void 0:`Got: "${e.actual}"`;return{description:t,detail:n,status:r?"passed":"failed"}}function Oc({actual:e,expected:t,operator:r}){return r==="equals"?e===t:r==="notEquals"?e!==t:r==="contains"?e.includes(t):r==="startsWith"?e.startsWith(t):r==="endsWith"?e.endsWith(t):new RegExp(t).test(e)}function ti(e){let t=`${e.label} ${e.operator} ${String(e.expected)}`,r=Dc(e),n=r?void 0:`Got: ${String(e.actual)}`;return{description:t,detail:n,status:r?"passed":"failed"}}function Dc({actual:e,expected:t,operator:r}){return r==="equals"?e===t:r==="notEquals"?e!==t:r==="greaterThan"?e>t:r==="greaterThanOrEqual"?e>=t:r==="lessThan"?e<t:e<=t}import{readdir as Mc,rm as Hc,stat as Wc}from"fs/promises";import ik from"os";import oi from"path";import{graphql as qc}from"gql.tada";import{print as Lc}from"graphql";var _c=15e3;async function S(e){let t=Lc(e.document),r=JSON.stringify({query:t,variables:e.variables}),n=`${e.config.ripploServerUrl}/graphql`,o;try{o=await fetch(n,{body:r,headers:{Authorization:`Bearer ${e.config.token}`,"Content-Type":"application/json"},method:"POST",signal:AbortSignal.timeout(_c)})}catch(s){let a=s instanceof Error?s.message:String(s);throw new Error(`Failed to connect to Ripplo server at ${e.config.ripploServerUrl}. Make sure \`npx ripplo\` is running and your internet connection is active. Details: ${a}`)}let i=await Uc({res:o,url:n});if(!Vc(i))throw new Error("Invalid GraphQL response");if(Fc(i))throw new Error(i.errors.map(s=>s.message).join(", "));if(i.data==null)throw new Error("No data returned from server");return i.data}async function Uc({res:e,url:t}){let r=await e.text();if(r.length===0)throw new Error(`Empty response from Ripplo server at ${t} (status ${String(e.status)}). The server may have restarted or the request was rejected before a body was sent.`);try{return JSON.parse(r)}catch{throw new Error(`Non-JSON response from Ripplo server at ${t} (status ${String(e.status)}): ${r.slice(0,200)}`)}}function Vc(e){return typeof e=="object"&&e!=null&&("data"in e||"errors"in e)}function Fc(e){return Array.isArray(e.errors)&&e.errors.length>0}var ri=oi.join(process.cwd(),".ripplo","debug"),ni=360*60*1e3,dk=qc(`
|
|
105
105
|
mutation RevokeCurrentCliToken {
|
|
106
106
|
revokeCurrentCliToken
|
|
107
107
|
}
|
|
108
|
-
`);async function
|
|
109
|
-
`))}}import
|
|
110
|
-
`),t}function
|
|
111
|
-
`,{mode:384})}function
|
|
112
|
-
\u2192 /ripplo:debug \u2014 check .ripplo/debug/<runId>/ artifacts`,status:"failed"}}function
|
|
113
|
-
Load \`/ripplo:setup\` skill for instructions on engine endpoint + webhook secret wiring.`,status:"failed"}:t.kind==="pass"?{description:`observer "${e}"`,detail:n.pollCount>1?`passed after ${String(n.pollCount)} polls (${
|
|
114
|
-
Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=t.reason,null)}async function Jd({apiUrl:e,observer:t,params:r,webhookSecret:n}){let o=JSON.stringify({observer:t,params:r});try{let i=await fetch(`${e}/execute-observer`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(qd)});if(!i.ok){let l=await i.text().catch(()=>"");return{kind:"transport-error",reason:`status ${String(i.status)}: ${l.slice(0,200)}`}}let s=await i.json(),a=Gd.safeParse(s);return a.success?!a.data.success||a.data.outcome==null?{kind:"transport-error",reason:a.data.error??"engine reported failure without outcome"}:a.data.outcome:{kind:"transport-error",reason:`invalid response shape: ${a.error.message}`}}catch(i){let s=i instanceof Error?i.message:String(i);return g.error("observer request failed: %s",s),{kind:"transport-error",reason:s}}}function Yd({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function mi(e){return`${String(Math.round(performance.now()-e))}ms`}async function Xd(e){return new Promise(t=>setTimeout(t,e))}async function Y({fn:e,label:t}){let r=performance.now(),n=await e();return g.info("%s: %dms",t,Math.round(performance.now()-r)),n}var Qd=1e4;async function Br({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return eu({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function Zd({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function eu({currentId:e,failFast:t,getRecordingOffsetMs:r,observerTransport:n,onStep:o,page:i,runStartTime:s,spec:a,variables:l}){let c=[],d=l,u=e;for(;u!=null;){let f=a.nodes[u];if(f==null)throw new Error(`Node "${u}" not found in spec`);let b=u,w=f.label??`${f.type} (${u})`;g.info("Executing node: %s [%s]",w,f.type);let h=await tu({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(Zd({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function tu({getRecordingOffsetMs:e,node:t,nodeId:r,observerTransport:n,page:o,runStartTime:i,variables:s}){let a=performance.now(),l=e?.(),c=t.label??`${t.type} (${t.id})`,d=Qd,u=gt({node:t,page:o});try{let f=await ru({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(E=>E.status==="failed"),h=await Y({label:`Snapshot [${c}]`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:w?"failed":"passed",stepIndex:0,title:c,url:h.url,variables:f.variables,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}catch(f){let b=Math.round(performance.now()-a),w=f instanceof Error?f.message:String(f),h=await Y({label:`Snapshot [${c}] (error)`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function ru({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(nu(e)){let s=await dr({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await iu({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function nu(e){return["goto","click","dblclick","fill","select","hover","press","check","uncheck","clear","rightClick","handleDialog","clipboard","setPermission","setViewport","fail","setVariable","extractText","upload","drag","scrollIntoView","type","focus"].includes(e.type)}function ou(e){return e.type.startsWith("assert")}async function iu({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!ou(e))throw new Error(`Unknown node type: ${e.type}`);let i=e;switch(i.type){case"assertVisible":case"assertNotVisible":case"assertEnabled":case"assertDisabled":case"assertChecked":case"assertNotChecked":case"assertFocused":case"assertNotFocused":return au({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=K({ref:i.expected,variables:o});return[await Er({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertUrl":{let s=K({ref:i.expected,variables:o});return[vt({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=K({ref:i.expected,variables:o});return[vt({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=cr({ref:i.expected,variables:o});return[await Tr({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=K({ref:i.expected,variables:o});return[await $r({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=K({ref:i.expected,variables:o});return[await Go({attribute:i.attribute,expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertObserver":{if(t==null)return[{description:`observer "${i.observer}"`,detail:"observer transport not configured \u2014 set engineUrl + webhookSecret in ripplo.config",status:"failed"}];let s={};return Object.entries(i.params).forEach(([a,l])=>{s[a]=Ce({ref:l,variables:o})}),[await pi({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var su={assertChecked:Yo,assertDisabled:Jo,assertEnabled:Ko,assertFocused:Qo,assertNotChecked:Xo,assertNotFocused:Zo,assertNotVisible:Ir,assertVisible:Ar};async function au({assertNode:e,page:t,timeout:r,variables:n}){let o=su[e.type];return[await o({locator:U({locator:e.locator,page:t,variables:n}),timeout:r})]}async function zr({baseUrl:e,browser:t,cookies:r,extraVariables:n,observerTransport:o,onRecordingChunk:i,onStep:s,runId:a,spec:l}){let c=await t.newContext({baseURL:e});g.info("Browser context created"),r.length>0&&await c.addCookies(r);let d=await c.newPage();g.info("Page created");let u=Ze(d),f=await St(d);async function b(){let _=await f.takeChunk();_!=null&&i?.(_)}let w=setInterval(()=>{b()},2e3),h=[],v=!1;function E(_){s?.(_),v||(v=!0,f.start()),h.push(wt({context:c,page:d,runId:a,stepIndex:_.stepIndex,stepResult:_}))}let V=lu(n,l.variableNamespaces),B={...Qe({defs:l.variables}),...V};g.info("Starting graph execution (entry: %s)",l.entryNode);let L=await Br({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:E,page:d,spec:l,variables:B});await Promise.allSettled(h);let F=L.steps.filter(_=>_.status==="passed").length,ie=L.steps.filter(_=>_.status==="failed").length,Ae={duration:L.steps.reduce((_,ae)=>_+ae.duration,0),failCount:ie,passCount:F,runId:a,status:ie>0?"failed":"passed",workflowName:""};return await bt({monitor:u,runId:a,steps:L.steps,summary:Ae}),clearInterval(w),await f.detach(),await b(),await c.close(),L.steps}function lu(e,t){if(e==null||t==null)return{};let r=new Map;Object.entries(t).forEach(([o,i])=>{r.set(i,o)});let n={};return Object.entries(e).forEach(([o,i])=>{let s=r.get(o);s!=null&&(n[s]={...n[s],...i})}),n}import{parseSetCookie as cu}from"set-cookie-parser";import{z as ee}from"zod";var fi=3e4,du=ee.object({data:ee.record(ee.string(),ee.record(ee.string(),ee.string())),error:ee.string().optional(),executed:ee.array(ee.string()),runId:ee.string(),success:ee.boolean()});async function Gr({project:e,webhookSecret:t,workflowSlug:r}){let n={apiUrl:void 0,cookies:[],data:{},executed:[]},o=e.workflows.find(a=>a.slug===r);if(o==null)return n;let i=e.engineBaseUrl.length===0?void 0:e.engineBaseUrl,s=o.preconditions;return s.length===0?{...n,apiUrl:i}:i==null?n:gi({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function Kr({apiUrl:e,cookies:t,data:r,executed:n,webhookSecret:o}){if(n.length!==0)try{let i=JSON.stringify({data:r,preconditions:n}),s=await fetch(`${e}/teardown-preconditions`,{body:i,headers:{"Content-Type":"application/json",...fu({cookies:t}),...ke({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(fi)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function gi({apiUrl:e,preconditionNames:t,webhookSecret:r}){let n=performance.now(),o=JSON.stringify({preconditions:t}),i=await fetch(`${e}/execute-preconditions`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(fi)});if(!i.ok){let c=await pu(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=du.safeParse(s);if(!a.success)throw new Error(`execute-preconditions response has invalid shape: ${a.error.message}`);if(!a.data.success){let c=a.data.error??"no error detail";throw new Error(`Precondition batch failed: ${c}`)}let l=gu({domain:new URL(e).hostname,res:i});return g.info("Preconditions resolved: %s (%dms)",a.data.executed.join(", "),Math.round(performance.now()-n)),{apiUrl:e,cookies:l,data:a.data.data,executed:a.data.executed}}var uu=ee.object({error:ee.string()});async function pu(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=mu(t),n=r==null?null:uu.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function mu(e){try{return JSON.parse(e)}catch{return null}}function fu({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function gu({domain:e,res:t}){let r=t.headers.getSetCookie();return cu(r,{decodeValues:!1}).map(o=>yu({cookie:o,domain:e}))}function yu({cookie:e,domain:t}){let r={domain:e.domain??t,httpOnly:e.httpOnly??!1,name:e.name,path:e.path??"/",secure:e.secure??!1,value:e.value};return e.sameSite!=null&&(r.sameSite=wu({raw:e.sameSite})),e.expires!=null?r.expires=Math.floor(e.expires.getTime()/1e3):e.maxAge!=null&&(r.expires=Math.floor(Date.now()/1e3)+e.maxAge),r}var hu={lax:"Lax",none:"None",strict:"Strict"};function wu({raw:e}){return hu[e.toLowerCase()]??"Lax"}async function Jr({engineBaseUrl:e,preconditionNames:t,webhookSecret:r}){let n=e.length===0?void 0:e;return n==null||t.length===0?{apiUrl:n,cookies:[],data:{},executed:[]}:gi({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as jt}from"gql.tada";async function Yr({agentProfileId:e,config:t,runId:r}){let n=await S({config:t,document:vu,variables:{agentProfileId:e??null,platform:"chromium",runId:r}});if(n.startRun==null)throw new Error("Failed to start run");let o=n.startRun.id,i=[];function s(d){let u=Su({config:t,runResultId:o,steps:[d]}).catch(f=>{g.error(f,"Failed to submit step %d",d.stepIndex)});i.push(u)}function a(d){let u=bu({chunk:d,config:t,runResultId:o}).catch(f=>{g.error(f,"Failed to submit recording chunk %d",d.chunkIndex)});i.push(u)}async function l(){await Promise.all(i)}async function c({statusOverride:d,steps:u,summary:f}){await Y({label:`flushSteps (${String(i.length)} steps)`,fn:()=>Promise.all(i)});let b=u.filter(E=>E.status==="passed").length,w=u.filter(E=>E.status==="failed").length,h=u.reduce((E,V)=>E+V.duration,0),v=d??(w>0?"failed":"passed");await Y({label:"completeRun",fn:()=>S({config:t,document:xu,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:v,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function bu({chunk:e,config:t,runResultId:r}){await S({config:t,document:Ru,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function Su({config:e,runResultId:t,steps:r}){let n=r.map(o=>({annotations:o.annotations.map(i=>({height:i.height,label:i.label,rrwebNodeId:i.rrwebNodeId??null,type:i.type,width:i.width,x:i.x,y:i.y})),assertions:o.assertions.map(i=>({description:i.description,detail:i.detail,status:i.status})),detail:o.detail,duration:o.duration,nodeType:o.nodeType,recordingEndMs:o.recordingEndMs??null,recordingStartMs:o.recordingStartMs??null,snapshotTimestamp:o.snapshotTimestamp,status:o.status,stepIndex:o.stepIndex,title:o.title,url:o.url,viewportHeight:o.viewportHeight,viewportWidth:o.viewportWidth}));await S({config:e,document:ku,variables:{runResultId:t,steps:n}})}var vu=jt(`
|
|
108
|
+
`);async function Or({maxRuns:e}){try{let r=(await Mc(ri,{withFileTypes:!0})).filter(c=>c.isDirectory()),n=Date.now(),o=await Promise.all(r.map(async c=>{let d=oi.join(ri,c.name),u=await Wc(d);return{dirPath:d,mtime:u.mtimeMs}})),i=o.filter(c=>n-c.mtime>ni),a=o.filter(c=>n-c.mtime<=ni).toSorted((c,d)=>d.mtime-c.mtime).slice(e),l=[...i,...a];if(l.length===0)return;await Promise.allSettled(l.map(c=>Hc(c.dirPath,{force:!0,recursive:!0}))),g.info("Pruned %d old debug run(s)",l.length)}catch{g.warn("Debug run pruning failed, ignoring")}}var Bc=5e3;async function Dr({appUrl:e}){try{await fetch(e,{method:"HEAD",signal:AbortSignal.timeout(Bc)})}catch(t){let r=t instanceof Error?t.message:String(t);throw g.debug("App URL reachability check failed: %s",r),new Error([`Could not reach your dev server at ${e}.`,"","Troubleshooting:",` 1. Make sure your app is running at ${e}`," 2. Check RIPPLO_APP_URL in the env file declared in .ripplo/project.json"," 3. If you're in a git worktree, RIPPLO_APP_URL and RIPPLO_ENGINE_URL must point at this worktree's dev server port (not main's)"].join(`
|
|
109
|
+
`))}}import nt from"fs";import Ee from"fs";import zc from"os";import et from"path";var Gc=".local",Kc=".ripplo";function Lr(e){return et.join(e,".ripplo",Gc)}function tt(e){let t=Lr(e);Ee.existsSync(t)||Ee.mkdirSync(t,{recursive:!0});let r=et.join(t,".gitignore");return Ee.existsSync(r)||Ee.writeFileSync(r,`*
|
|
110
|
+
`),t}function rt(e,t){return et.join(Lr(e),t)}function _r(){return et.join(zc.homedir(),Kc)}function Ur(){let e=_r();return Ee.existsSync(e)?Ee.chmodSync(e,448):Ee.mkdirSync(e,{mode:448,recursive:!0}),e}function be(e){return et.join(_r(),e)}function ne(){let e=process.env.RIPPLO_TOKEN;if(e!=null&&e.trim().length>0)return e.trim();let t=be("token");if(!nt.existsSync(t))return null;let r=nt.readFileSync(t,"utf8").trim();return r.length===0?null:r}function Vr(e){Ur(),nt.writeFileSync(be("token"),e+`
|
|
111
|
+
`,{mode:384})}function Fr(){let e=be("token");return nt.existsSync(e)?(nt.unlinkSync(e),!0):!1}import{z as me}from"zod";import{z as Pt}from"zod";var Jc=Pt.object({__codec:Pt.string().min(1),data:Pt.unknown(),version:Pt.number().int().positive()}),Ct=class extends Error{codec;currentVersion;gotVersion;constructor(t){super(`Unsupported ${t.codec} version ${String(t.gotVersion)} (current ${String(t.currentVersion)}). Upgrade Ripplo or rebuild with a compatible CLI.`),this.name="CodecVersionError",this.codec=t.codec,this.currentVersion=t.currentVersion,this.gotVersion=t.gotVersion}},Et=class extends Error{constructor(t){super(`Codec mismatch: expected "${t.expected}", got "${t.got}"`),this.name="CodecMismatchError"}};function Tt(e){return ii({legacy:void 0,migrators:[],name:e,schemas:[]})}function ii(e){return{initial:t=>Mr(t,{...e,schemas:[t]}),legacy:t=>ii({...e,legacy:t})}}function Mr(e,t){return{build:()=>Yc(e,t),legacy:r=>Mr(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return Mr(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function Yc(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>Xc(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function Xc(e,t,r){let{data:n,version:o}=Qc(t,r),i=si(t,n,o);return e.parse(i)}function Qc(e,t){let r=Jc.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new Et({expected:e.name,got:r.data.__codec});return{data:r.data.data,version:r.data.version}}if(e.legacy!=null&&e.legacy.detect(t))return{data:t,version:e.legacy.assumedVersion};throw new Error(`Cannot decode "${e.name}": value is not a codec envelope and no legacy detector matched.`)}function si(e,t,r){let n=e.schemas.length;if(r>n)throw new Ct({codec:e.name,currentVersion:n,gotVersion:r});if(r===n)return t;let o=e.schemas[r-1];if(o==null)throw new Error(`Codec "${e.name}" missing schema for v${String(r)}; cannot migrate.`);let i=o.parse(t),s=e.migrators[r-1];if(s==null)throw new Error(`Codec "${e.name}" missing migrator v${String(r)} \u2192 v${String(r+1)}.`);return si(e,s(i),r+1)}import{z as di}from"zod";import{z as Oe}from"zod";var Hr=Oe.object({depends:Oe.array(Oe.string().min(1)).optional().describe("Names of other preconditions that must be satisfied first. Resolved via topological sort; cycles are rejected at validation time."),description:Oe.string().min(1).describe("Human-readable description of what this precondition ensures"),returns:Oe.array(Oe.string().min(1)).optional().describe("Keys that the execute response's data field will contain. e.g. ['projectId', 'workflowId']. These are used for route param interpolation ({{projectId}}) and workflow variables. Declared here so generated types are strongly typed per precondition.")}).describe("A named precondition declared at the graph level. States reference these by name.");import{z as p}from"zod";import{z as Se}from"zod";var Zc=Se.object({by:Se.literal("testId"),value:Se.string().min(1)}),ed=Se.object({by:Se.literal("role"),name:Se.string().optional(),role:Se.string().min(1)}),T=Se.discriminatedUnion("by",[Zc,ed]);import{z as ai}from"zod";var ve=ai.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),$t=ai.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]);import{z as O}from"zod";var td=O.object({type:O.literal("static"),value:O.union([O.string(),O.number(),O.boolean()])}),At=O.object({name:O.string().min(1),type:O.literal("variable")}),It=O.discriminatedUnion("type",[td,At]),Q=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.string()}),At]),jt=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.number().int().nonnegative()}),At]),Wr=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.union([O.string(),O.number(),O.boolean()])}),At]);import{z as Z}from"zod";var Nt=Z.discriminatedUnion("type",[Z.object({default:Z.string().optional(),type:Z.literal("string")}),Z.object({default:Z.number().optional(),type:Z.literal("number")}),Z.object({default:Z.boolean().optional(),type:Z.literal("boolean")}),Z.object({key:Z.string().min(1),type:Z.literal("env")})]);var P={id:p.string().min(1).max(200),label:p.string().max(500).optional(),next:p.string().max(200).optional(),uiOnly:p.boolean().optional()},li=500,rd=p.object({...P,type:p.literal("goto"),url:Q}),nd=p.object({...P,locator:T,type:p.literal("click")}),od=p.object({...P,locator:T,type:p.literal("fill"),value:Q}),id=p.object({...P,locator:T,type:p.literal("select"),value:Q}),sd=p.object({...P,locator:T,type:p.literal("hover")}),ad=p.object({...P,key:p.string().min(1),locator:T.optional(),type:p.literal("press")}),ld=p.object({...P,locator:T,type:p.literal("check")}),cd=p.object({...P,locator:T,type:p.literal("uncheck")}),dd=p.object({...P,height:p.number().int().positive(),type:p.literal("setViewport"),width:p.number().int().positive()}),ud=p.object({...P,message:p.string().min(1),type:p.literal("fail")}),pd=p.object({...P,type:p.literal("setVariable"),value:It,variable:p.string().min(1)}),md=p.object({...P,locator:T,type:p.literal("extractText"),variable:p.string().min(1)}),fd=p.object({...P,files:p.array(p.string()).min(1),locator:T,type:p.literal("upload")}),gd=p.object({...P,locator:T,type:p.literal("dblclick")}),yd=p.object({...P,source:T,target:T,type:p.literal("drag")}),hd=p.object({...P,locator:T,type:p.literal("scrollIntoView")}),wd=p.object({...P,locator:T,type:p.literal("type"),value:Q}),bd=p.object({...P,locator:T,type:p.literal("focus")}),Sd=p.object({...P,locator:T,type:p.literal("clear")}),vd=p.object({...P,locator:T,type:p.literal("rightClick")}),kd=p.object({...P,action:p.enum(["accept","dismiss"]),promptText:p.string().optional(),type:p.literal("handleDialog")}),Rd=p.object({...P,action:p.enum(["read","write"]),type:p.literal("clipboard"),value:Q.optional(),variable:p.string().min(1).optional()}),xd=p.object({...P,permission:p.string().min(1),state:p.enum(["granted","prompt"]),type:p.literal("setPermission")}),Pd=p.object({...P,locator:T,type:p.literal("assertVisible")}),Cd=p.object({...P,locator:T,type:p.literal("assertNotVisible")}),Ed=p.object({...P,expected:Q,locator:T,operator:ve,type:p.literal("assertText")}),Td=p.object({...P,expected:Q,operator:ve,type:p.literal("assertUrl")}),$d=p.object({...P,expected:jt,locator:T,operator:$t,type:p.literal("assertCount")}),Ad=p.object({...P,expected:Q,locator:T,operator:ve,type:p.literal("assertValue")}),Id=p.object({...P,attribute:p.string().min(1),expected:Q,locator:T,operator:ve,type:p.literal("assertAttribute")}),jd=p.object({...P,locator:T,type:p.literal("assertEnabled")}),Nd=p.object({...P,locator:T,type:p.literal("assertDisabled")}),Od=p.object({...P,expected:Q,operator:ve,type:p.literal("assertTitle")}),Dd=p.object({...P,locator:T,type:p.literal("assertChecked")}),Ld=p.object({...P,locator:T,type:p.literal("assertNotChecked")}),_d=p.object({...P,locator:T,type:p.literal("assertFocused")}),Ud=p.object({...P,locator:T,type:p.literal("assertNotFocused")}),Vd=p.object({...P,budget:p.enum(["fast","slow","async"]),observer:p.string().min(1).max(200),params:p.record(p.string().max(200),Wr),type:p.literal("assertObserver")}),ci=p.discriminatedUnion("type",[rd,nd,od,id,sd,ad,ld,cd,Pd,Cd,Ed,Td,$d,Ad,Id,jd,Nd,dd,ud,pd,md,fd,gd,yd,hd,wd,bd,Sd,vd,kd,Rd,xd,Od,Dd,Ld,_d,Ud,Vd]),Ot=p.object({entryNode:p.string().min(1).max(200),nodes:p.record(p.string().max(200),ci).refine(e=>Object.keys(e).length<=li,`Workflow has more than ${String(li)} nodes`),uiOnly:p.boolean().optional(),variableNamespaces:p.record(p.string().max(200),p.string().max(500)).optional(),variables:p.record(p.string().max(200),Nt).optional()});var Fd=di.record(di.string().max(200),Hr),Md={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},Hd={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},qr=Tt("workflow-spec").legacy(Md).initial(Ot).build(),Wd=Tt("precondition-map").legacy(Hd).initial(Fd).build();import{z as Br}from"zod";var ui=["fast","slow","async"],qd=Br.object({budget:Br.enum(ui).describe("Polling budget tier: fast | slow | async"),description:Br.string().min(1).describe("Human-readable description of what this observer checks")}).describe("A named backend state observer. Tests assert against it with assert.backend(observer, params). Implementation lives on the user's server.");import{graphql as Ut,readFragment as Lt}from"gql.tada";import{z as oe}from"zod";import pi from"crypto";import{Webhook as Bd}from"standardwebhooks";function ke({body:e,secret:t}){let r=new Bd(t),n=`msg_${pi.randomUUID()}`,o=new Date,i=r.sign(n,o,e),s=Math.floor(o.getTime()/1e3);return{"webhook-id":n,"webhook-signature":i,"webhook-timestamp":String(s)}}function zr(){return`whsec_${pi.randomBytes(24).toString("base64")}`}var zd=15e4,Gd={async:{backoffMs:[500,1e3,2e3,5e3],timeoutMs:12e4},fast:{backoffMs:[100,250,500,1e3],timeoutMs:5e3},slow:{backoffMs:[250,500,1e3,2e3],timeoutMs:3e4}},Kd=oe.discriminatedUnion("kind",[oe.object({kind:oe.literal("pass")}),oe.object({kind:oe.literal("retry"),reason:oe.string()}),oe.object({kind:oe.literal("fail"),reason:oe.string()})]),Jd=oe.object({error:oe.string().optional(),outcome:Kd.optional(),success:oe.boolean()});async function mi({apiUrl:e,budget:t,observer:r,params:n,webhookSecret:o}){let i=Gd[t],s=performance.now(),a={lastReason:void 0,pollCount:0};for(;performance.now()-s<i.timeoutMs;){a.pollCount+=1;let l=await Xd({apiUrl:e,observer:r,params:n,webhookSecret:o}),c=Yd({observer:r,outcome:l,start:s,state:a});if(c!=null)return c;let d=i.timeoutMs-(performance.now()-s);if(d<=0)break;let u=Math.min(Qd({backoff:i.backoffMs,pollCount:a.pollCount}),d);await Zd(u)}return{description:`observer "${r}"`,detail:`budget "${t}" exhausted after ${String(a.pollCount)} poll(s) (${fi(s)}); last: ${a.lastReason??"no retry reason"}
|
|
112
|
+
\u2192 /ripplo:debug \u2014 check .ripplo/debug/<runId>/ artifacts`,status:"failed"}}function Yd({observer:e,outcome:t,start:r,state:n}){return t.kind==="transport-error"?{description:`observer "${e}"`,detail:`transport error after ${String(n.pollCount)} poll(s): ${t.reason}
|
|
113
|
+
Load \`/ripplo:setup\` skill for instructions on engine endpoint + webhook secret wiring.`,status:"failed"}:t.kind==="pass"?{description:`observer "${e}"`,detail:n.pollCount>1?`passed after ${String(n.pollCount)} polls (${fi(r)})`:void 0,status:"passed"}:t.kind==="fail"?{description:`observer "${e}"`,detail:`failed (invariant): ${t.reason} (after ${String(n.pollCount)} poll(s)) \u2014 ctx.fail stops polling immediately and is reserved for invariant violations (wrong shape, contradictory/forbidden state). For transient conditions like "not yet committed", "status not yet X", or "row not found", use ctx.retry(reason) so the runtime keeps polling until the budget expires.
|
|
114
|
+
Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=t.reason,null)}async function Xd({apiUrl:e,observer:t,params:r,webhookSecret:n}){let o=JSON.stringify({observer:t,params:r});try{let i=await fetch(`${e}/execute-observer`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(zd)});if(!i.ok){let l=await i.text().catch(()=>"");return{kind:"transport-error",reason:`status ${String(i.status)}: ${l.slice(0,200)}`}}let s=await i.json(),a=Jd.safeParse(s);return a.success?!a.data.success||a.data.outcome==null?{kind:"transport-error",reason:a.data.error??"engine reported failure without outcome"}:a.data.outcome:{kind:"transport-error",reason:`invalid response shape: ${a.error.message}`}}catch(i){let s=i instanceof Error?i.message:String(i);return g.error("observer request failed: %s",s),{kind:"transport-error",reason:s}}}function Qd({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function fi(e){return`${String(Math.round(performance.now()-e))}ms`}async function Zd(e){return new Promise(t=>setTimeout(t,e))}async function Y({fn:e,label:t}){let r=performance.now(),n=await e();return g.info("%s: %dms",t,Math.round(performance.now()-r)),n}var eu=1e4;async function Gr({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return ru({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function tu({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function ru({currentId:e,failFast:t,getRecordingOffsetMs:r,observerTransport:n,onStep:o,page:i,runStartTime:s,spec:a,variables:l}){let c=[],d=l,u=e;for(;u!=null;){let f=a.nodes[u];if(f==null)throw new Error(`Node "${u}" not found in spec`);let b=u,w=f.label??`${f.type} (${u})`;g.info("Executing node: %s [%s]",w,f.type);let h=await nu({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(tu({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function nu({getRecordingOffsetMs:e,node:t,nodeId:r,observerTransport:n,page:o,runStartTime:i,variables:s}){let a=performance.now(),l=e?.(),c=t.label??`${t.type} (${t.id})`,d=eu,u=wt({node:t,page:o});try{let f=await ou({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(E=>E.status==="failed"),h=await Y({label:`Snapshot [${c}]`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:w?"failed":"passed",stepIndex:0,title:c,url:h.url,variables:f.variables,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}catch(f){let b=Math.round(performance.now()-a),w=f instanceof Error?f.message:String(f),h=await Y({label:`Snapshot [${c}] (error)`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function ou({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(iu(e)){let s=await pr({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await au({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function iu(e){return["goto","click","dblclick","fill","select","hover","press","check","uncheck","clear","rightClick","handleDialog","clipboard","setPermission","setViewport","fail","setVariable","extractText","upload","drag","scrollIntoView","type","focus"].includes(e.type)}function su(e){return e.type.startsWith("assert")}async function au({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!su(e))throw new Error(`Unknown node type: ${e.type}`);let i=e;switch(i.type){case"assertVisible":case"assertNotVisible":case"assertEnabled":case"assertDisabled":case"assertChecked":case"assertNotChecked":case"assertFocused":case"assertNotFocused":return cu({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=K({ref:i.expected,variables:o});return[await $r({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertUrl":{let s=K({ref:i.expected,variables:o});return[xt({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=K({ref:i.expected,variables:o});return[xt({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=ur({ref:i.expected,variables:o});return[await Ar({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=K({ref:i.expected,variables:o});return[await Ir({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=K({ref:i.expected,variables:o});return[await Ko({attribute:i.attribute,expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertObserver":{if(t==null)return[{description:`observer "${i.observer}"`,detail:"observer transport not configured \u2014 set engineUrl + webhookSecret in ripplo.config",status:"failed"}];let s={};return Object.entries(i.params).forEach(([a,l])=>{s[a]=yt({ref:l,variables:o})}),[await mi({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var lu={assertChecked:Xo,assertDisabled:Yo,assertEnabled:Jo,assertFocused:Zo,assertNotChecked:Qo,assertNotFocused:ei,assertNotVisible:Nr,assertVisible:jr};async function cu({assertNode:e,page:t,timeout:r,variables:n}){let o=lu[e.type];return[await o({locator:U({locator:e.locator,page:t,variables:n}),timeout:r})]}async function Kr({baseUrl:e,browser:t,cookies:r,extraVariables:n,observerTransport:o,onRecordingChunk:i,onStep:s,runId:a,spec:l}){let c=await t.newContext({baseURL:e});g.info("Browser context created"),r.length>0&&await c.addCookies(r);let d=await c.newPage();g.info("Page created");let u=Qe(d),f=await Rt(d);async function b(){let _=await f.takeChunk();_!=null&&i?.(_)}let w=setInterval(()=>{b()},2e3),h=[],v=!1;function E(_){s?.(_),v||(v=!0,f.start()),h.push(vt({context:c,page:d,runId:a,stepIndex:_.stepIndex,stepResult:_}))}let V=du(n,l.variableNamespaces),B={...Xe({defs:l.variables}),...V};g.info("Starting graph execution (entry: %s)",l.entryNode);let L=await Gr({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:E,page:d,spec:l,variables:B});await Promise.allSettled(h);let F=L.steps.filter(_=>_.status==="passed").length,ie=L.steps.filter(_=>_.status==="failed").length,$e={duration:L.steps.reduce((_,ae)=>_+ae.duration,0),failCount:ie,passCount:F,runId:a,status:ie>0?"failed":"passed",workflowName:""};return await kt({monitor:u,runId:a,steps:L.steps,summary:$e}),clearInterval(w),await f.detach(),await b(),await c.close(),L.steps}function du(e,t){if(e==null||t==null)return{};let r=new Map;Object.entries(t).forEach(([o,i])=>{r.set(i,o)});let n={};return Object.entries(e).forEach(([o,i])=>{let s=r.get(o);s!=null&&(n[s]={...n[s],...i})}),n}import{parseSetCookie as uu}from"set-cookie-parser";import{z as ee}from"zod";var gi=3e4,pu=ee.object({data:ee.record(ee.string(),ee.record(ee.string(),ee.string())),error:ee.string().optional(),executed:ee.array(ee.string()),runId:ee.string(),success:ee.boolean()});async function Jr({project:e,webhookSecret:t,workflowSlug:r}){let n={apiUrl:void 0,cookies:[],data:{},executed:[]},o=e.workflows.find(a=>a.slug===r);if(o==null)return n;let i=e.engineBaseUrl.length===0?void 0:e.engineBaseUrl,s=o.preconditions;return s.length===0?{...n,apiUrl:i}:i==null?n:yi({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function Yr({apiUrl:e,cookies:t,data:r,executed:n,webhookSecret:o}){if(n.length!==0)try{let i=JSON.stringify({data:r,preconditions:n}),s=await fetch(`${e}/teardown-preconditions`,{body:i,headers:{"Content-Type":"application/json",...yu({cookies:t}),...ke({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(gi)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function yi({apiUrl:e,preconditionNames:t,webhookSecret:r}){let n=performance.now(),o=JSON.stringify({preconditions:t}),i=await fetch(`${e}/execute-preconditions`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(gi)});if(!i.ok){let c=await fu(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=pu.safeParse(s);if(!a.success)throw new Error(`execute-preconditions response has invalid shape: ${a.error.message}`);if(!a.data.success){let c=a.data.error??"no error detail";throw new Error(`Precondition batch failed: ${c}`)}let l=hu({domain:new URL(e).hostname,res:i});return g.info("Preconditions resolved: %s (%dms)",a.data.executed.join(", "),Math.round(performance.now()-n)),{apiUrl:e,cookies:l,data:a.data.data,executed:a.data.executed}}var mu=ee.object({error:ee.string()});async function fu(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=gu(t),n=r==null?null:mu.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function gu(e){try{return JSON.parse(e)}catch{return null}}function yu({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function hu({domain:e,res:t}){let r=t.headers.getSetCookie();return uu(r,{decodeValues:!1}).map(o=>wu({cookie:o,domain:e}))}function wu({cookie:e,domain:t}){let r={domain:e.domain??t,httpOnly:e.httpOnly??!1,name:e.name,path:e.path??"/",secure:e.secure??!1,value:e.value};return e.sameSite!=null&&(r.sameSite=Su({raw:e.sameSite})),e.expires!=null?r.expires=Math.floor(e.expires.getTime()/1e3):e.maxAge!=null&&(r.expires=Math.floor(Date.now()/1e3)+e.maxAge),r}var bu={lax:"Lax",none:"None",strict:"Strict"};function Su({raw:e}){return bu[e.toLowerCase()]??"Lax"}async function Xr({engineBaseUrl:e,preconditionNames:t,webhookSecret:r}){let n=e.length===0?void 0:e;return n==null||t.length===0?{apiUrl:n,cookies:[],data:{},executed:[]}:yi({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as Dt}from"gql.tada";async function Qr({agentProfileId:e,config:t,runId:r}){let n=await S({config:t,document:Ru,variables:{agentProfileId:e??null,platform:"chromium",runId:r}});if(n.startRun==null)throw new Error("Failed to start run");let o=n.startRun.id,i=[];function s(d){let u=ku({config:t,runResultId:o,steps:[d]}).catch(f=>{g.error(f,"Failed to submit step %d",d.stepIndex)});i.push(u)}function a(d){let u=vu({chunk:d,config:t,runResultId:o}).catch(f=>{g.error(f,"Failed to submit recording chunk %d",d.chunkIndex)});i.push(u)}async function l(){await Promise.all(i)}async function c({statusOverride:d,steps:u,summary:f}){await Y({label:`flushSteps (${String(i.length)} steps)`,fn:()=>Promise.all(i)});let b=u.filter(E=>E.status==="passed").length,w=u.filter(E=>E.status==="failed").length,h=u.reduce((E,V)=>E+V.duration,0),v=d??(w>0?"failed":"passed");await Y({label:"completeRun",fn:()=>S({config:t,document:Cu,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:v,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function vu({chunk:e,config:t,runResultId:r}){await S({config:t,document:Pu,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function ku({config:e,runResultId:t,steps:r}){let n=r.map(o=>({annotations:o.annotations.map(i=>({height:i.height,label:i.label,rrwebNodeId:i.rrwebNodeId??null,type:i.type,width:i.width,x:i.x,y:i.y})),assertions:o.assertions.map(i=>({description:i.description,detail:i.detail,status:i.status})),detail:o.detail,duration:o.duration,nodeType:o.nodeType,recordingEndMs:o.recordingEndMs??null,recordingStartMs:o.recordingStartMs??null,snapshotTimestamp:o.snapshotTimestamp,status:o.status,stepIndex:o.stepIndex,title:o.title,url:o.url,viewportHeight:o.viewportHeight,viewportWidth:o.viewportWidth}));await S({config:e,document:xu,variables:{runResultId:t,steps:n}})}var Ru=Dt(`
|
|
115
115
|
mutation StartRunCLI($runId: String!, $platform: String!, $agentProfileId: String) {
|
|
116
116
|
startRun(runId: $runId, platform: $platform, agentProfileId: $agentProfileId) {
|
|
117
117
|
id
|
|
118
118
|
}
|
|
119
119
|
}
|
|
120
|
-
`),
|
|
120
|
+
`),xu=Dt(`
|
|
121
121
|
mutation SubmitRunStepsCLI($runResultId: String!, $steps: [StepInput!]!) {
|
|
122
122
|
submitRunSteps(runResultId: $runResultId, steps: $steps)
|
|
123
123
|
}
|
|
124
|
-
`),
|
|
124
|
+
`),Pu=Dt(`
|
|
125
125
|
mutation SubmitRunRecordingChunkCLI($input: SubmitRunRecordingChunkInput!) {
|
|
126
126
|
submitRunRecordingChunk(input: $input)
|
|
127
127
|
}
|
|
128
|
-
`),
|
|
128
|
+
`),Cu=Dt(`
|
|
129
129
|
mutation CompleteRunCLI(
|
|
130
130
|
$runResultId: String!
|
|
131
131
|
$status: String!
|
|
@@ -148,7 +148,7 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
148
148
|
status
|
|
149
149
|
}
|
|
150
150
|
}
|
|
151
|
-
`);var
|
|
151
|
+
`);var Eu=12e4,_t=Ut(`
|
|
152
152
|
fragment WorkflowRun on Workflow {
|
|
153
153
|
id
|
|
154
154
|
slug
|
|
@@ -160,7 +160,7 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
160
160
|
preconditionName
|
|
161
161
|
}
|
|
162
162
|
}
|
|
163
|
-
`),
|
|
163
|
+
`),hi=Ut(`
|
|
164
164
|
fragment ProjectRun on Project {
|
|
165
165
|
id
|
|
166
166
|
cloudBaseUrl
|
|
@@ -169,13 +169,13 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
169
169
|
...WorkflowRun
|
|
170
170
|
}
|
|
171
171
|
}
|
|
172
|
-
`,[
|
|
172
|
+
`,[_t]),Tu=Ut(`
|
|
173
173
|
query ProjectRun($projectId: String!) {
|
|
174
174
|
project(id: $projectId) {
|
|
175
175
|
...ProjectRun
|
|
176
176
|
}
|
|
177
177
|
}
|
|
178
|
-
`,[
|
|
178
|
+
`,[hi]),$u=Ut(`
|
|
179
179
|
query AgentProfileRun($id: String!) {
|
|
180
180
|
agentProfile(id: $id) {
|
|
181
181
|
id
|
|
@@ -185,30 +185,30 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
185
185
|
successCriteria
|
|
186
186
|
}
|
|
187
187
|
}
|
|
188
|
-
`);async function
|
|
188
|
+
`);async function Zr({agentProfileDescription:e,agentProfileId:t,baseUrl:r,browser:n,config:o,headed:i,preconditionNames:s,runId:a,webhookSecret:l,workflowId:c}){let d="unknown",u,f,b=!1;try{b=n==null,f=Au({externalBrowser:n,headed:i});let w=s==null?void 0:Y({label:"Preconditions resolved",fn:()=>Xr({engineBaseUrl:o.engineUrl,preconditionNames:s,webhookSecret:l})}),[{project:h,workflow:v},E]=await Promise.all([Y({label:"Run context resolved",fn:()=>_u({config:o,workflowId:c})}),Y({label:"Streaming run started",fn:()=>Qr({agentProfileId:t,config:o,runId:a})}),Dr({appUrl:r})]);d=v.name,u=E;let V=Vu(v.spec);g.info("Executing workflow: %s",v.name),await Hu(ju({agentProfileDescription:e,agentProfileId:t,baseUrl:r,browserPromise:f,config:o,headed:i,ownsBrowser:b,preconditionPromise:w,project:h,runId:a,specData:V,streaming:u,webhookSecret:l,workflow:v}),Mu())}catch(w){throw await Iu({browserPromise:f,error:w,ownsBrowser:b,runId:a,streaming:u,workflowName:d}),w}}function Au({externalBrowser:e,headed:t}){return e!=null?Promise.resolve(e):Y({label:"Browser launched",fn:()=>Ce({headed:t})})}async function Iu({browserPromise:e,error:t,ownsBrowser:r,runId:n,streaming:o,workflowName:i}){let s=t instanceof Error?t.message:String(t),a=t instanceof Error?t.stack:void 0;await zo({error:s,runId:n,stack:a,workflowName:i}),o!=null&&await o.complete({statusOverride:"failed",steps:[],summary:s}).catch(()=>{}),r&&e!=null&&await(await e.catch(()=>{}))?.close()}async function ju({agentProfileDescription:e,agentProfileId:t,baseUrl:r,browserPromise:n,config:o,headed:i,ownsBrowser:s,preconditionPromise:a,project:l,runId:c,specData:d,streaming:u,webhookSecret:f,workflow:b}){let w=a??Y({label:"Preconditions resolved",fn:()=>Jr({project:Du(l),webhookSecret:f,workflowSlug:b.slug})}),[h,v]=await Promise.all([w,n]);if(t!=null){s&&await v.close(),await Nu({agentProfileDescription:e,agentProfileId:t,baseUrl:r,config:o,headed:i,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f,workflow:b});return}await Lu({baseUrl:r,browser:v,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f})}async function Nu({agentProfileDescription:e,agentProfileId:t,baseUrl:r,config:n,headed:o,preconditionResult:i,runId:s,specData:a,streaming:l,webhookSecret:c,workflow:d}){let u=e!=null&&e.length>0?e:await Uu({config:n,profileId:t});await Tr({baseUrl:r,cookies:i.cookies,executedPreconditions:i.executed,extraVariables:i.data,headed:o,runId:s,serverUrl:n.ripploServerUrl,spec:a,streaming:l,systemPrompt:u,token:n.token,workflowContext:{description:d.name,expectedOutcome:d.name,name:d.name}}),await wi({preconditionResult:i,webhookSecret:c})}var Ou=me.object({preconditions:me.array(me.string()),requiresKeys:me.array(me.object({namespace:me.string(),preconditionName:me.string()})),slug:me.string()});function Du(e){let t=(e.workflows??[]).map(r=>{let n=Lt(_t,r);return Ou.parse(n)});return{engineBaseUrl:e.engineBaseUrl,workflows:t}}async function Lu({baseUrl:e,browser:t,preconditionResult:r,runId:n,specData:o,streaming:i,webhookSecret:s}){let a=await Y({label:"Spec executed",fn:()=>Kr({baseUrl:e,browser:t,cookies:r.cookies,extraVariables:r.data,observerTransport:r.apiUrl==null?void 0:{apiUrl:r.apiUrl,webhookSecret:s},onRecordingChunk:i.enqueueRecordingChunk,onStep:i.enqueueStep,runId:n,spec:o})});await wi({preconditionResult:r,webhookSecret:s}),await i.complete({statusOverride:void 0,steps:a,summary:void 0});let l=a.filter(d=>d.status==="passed").length,c=a.filter(d=>d.status==="failed").length;g.info("Run complete: %d passed, %d failed",l,c)}async function wi({preconditionResult:e,webhookSecret:t}){e.apiUrl!=null&&await Yr({apiUrl:e.apiUrl,cookies:e.cookies,data:e.data,executed:e.executed,webhookSecret:t})}async function _u({config:e,workflowId:t}){let r=await S({config:e,document:Tu,variables:{projectId:e.projectId}});if(r.project==null)throw new Error("Project not found");let o={...Lt(hi,r.project),...e.engineUrl.length>0?{engineBaseUrl:e.engineUrl}:{}},s=(o.workflows??[]).find(l=>Lt(_t,l).id===t);if(s==null)throw new Error(`Workflow ${t} not found`);let a=Lt(_t,s);return{project:o,workflow:a}}async function Uu({config:e,profileId:t}){let r=await S({config:e,document:$u,variables:{id:t}});if(r.agentProfile==null)throw new Error(`Agent profile not found: ${t}`);let n=r.agentProfile,o=n.description;if(o==null||o.length===0)throw new Error(`Agent profile "${n.name}" has no description`);return g.info("Using agent profile: %s",n.name),Pr({description:o,output:n.output??void 0,successCriteria:n.successCriteria??void 0})}function Vu(e){if(e==null)throw new Error("Workflow has no spec");return qr.decode(e)}var Fu=me.coerce.number().int().positive().catch(Eu);function Mu(){return Fu.parse(process.env.RIPPLO_RUN_TIMEOUT_MS)}async function Hu(e,t){let r,n=new Promise((o,i)=>{r=setTimeout(()=>{i(new Error(`Run timed out after ${String(t)}ms`))},t)});try{await Promise.race([e,n])}finally{r!=null&&clearTimeout(r)}}import{exec as Gu}from"child_process";import{createAuthClient as Wu}from"better-auth/client";import{deviceAuthorizationClient as qu}from"better-auth/client/plugins";function bi({baseURL:e}){return Wu({baseURL:e,fetchOptions:{headers:{"User-Agent":"Ripplo CLI"}},plugins:[qu()]})}import{z as Si}from"zod";var Bu="https://ripplo.ai";function fe(){return en().RIPPLO_SERVER_URL}var zu=Si.object({RIPPLO_SERVER_URL:Si.string().min(1).default(Bu)}),vi;function en(){return vi??=zu.parse(process.env),vi}var Ku=5e3,ki="ripplo-cli";async function Ri({onDeviceCode:e,url:t}){let r=t??en().RIPPLO_SERVER_URL,n=bi({baseURL:r}),o=await n.device.code({client_id:ki});if(o.error!=null)throw new Error(`Failed to request device code: ${o.error.error_description}`);let{device_code:i,user_code:s,verification_uri_complete:a}=o.data;e({userCode:s,verificationUrl:a}),ep(a);let l=await Ju({authClient:n,deviceCode:i});return Vr(l),l}async function Ju({authClient:e,deviceCode:t}){for(;;){await Qu(Ku);let r=await e.device.token({client_id:ki,device_code:t,grant_type:"urn:ietf:params:oauth:grant-type:device_code"});if(r.data?.access_token!=null)return r.data.access_token;if(r.error==null)continue;if(!Xu(r.error.error))throw new Error(`Authorization failed: ${r.error.error_description}`)}}var Yu=new Set(["authorization_pending","slow_down"]);function Xu(e){return Yu.has(e)}function Qu(e){return new Promise(t=>{setTimeout(t,e)})}function Zu(){return process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open"}function ep(e){let t=Zu();Gu(`${t} "${e}"`,()=>{})}function De({serverUrl:e,token:t}){return{appUrl:"",cwd:process.cwd(),engineUrl:"",projectId:"",ripploServerUrl:e,token:t,webhookSecret:""}}import tp from"fs";import rp from"path";function I(e){return tp.existsSync(rp.join(e,".ripplo"))}var op=np(`
|
|
189
189
|
query AuthViewer {
|
|
190
190
|
currentUser {
|
|
191
191
|
name
|
|
192
192
|
email
|
|
193
193
|
}
|
|
194
194
|
}
|
|
195
|
-
`);async function
|
|
195
|
+
`);async function xi(){let e=fe(),t=ne();if(t!=null){let s=await tn({serverUrl:e,token:t});if(s!=null){process.stdout.write(`Already signed in as ${s.email}. Run \`ripplo auth logout\` to switch.
|
|
196
196
|
`);return}process.stdout.write(`Your saved session expired \u2014 let's sign you back in.
|
|
197
197
|
|
|
198
|
-
`)}let r=await
|
|
198
|
+
`)}let r=await Ri({url:e,onDeviceCode:s=>{process.stdout.write(`Opening your browser to finish sign-in.
|
|
199
199
|
`),process.stdout.write(`If it didn't open, visit: ${s.verificationUrl}
|
|
200
200
|
`),process.stdout.write(`Verification code: ${s.userCode}
|
|
201
201
|
|
|
202
202
|
`),process.stdout.write(`Waiting for you to approve...
|
|
203
|
-
`)}}),n=await
|
|
203
|
+
`)}}),n=await tn({serverUrl:e,token:r}),o=I(process.cwd()),i=o?"Welcome back":"Welcome to Ripplo";process.stdout.write(`
|
|
204
204
|
`),process.stdout.write(n==null?`${i}.
|
|
205
|
-
`:`${i}, ${
|
|
205
|
+
`:`${i}, ${ip(n)}.
|
|
206
206
|
`),process.stdout.write(`Session saved to ${be("token")}.
|
|
207
|
-
`),o||(process.stdout.write("\nNext: run `/ripplo:setup` in Claude Code to wire Ripplo into this project,\n"),process.stdout.write("or `npx ripplo init` to set it up by hand.\n"))}function
|
|
208
|
-
`)}function
|
|
207
|
+
`),o||(process.stdout.write("\nNext: run `/ripplo:setup` in Claude Code to wire Ripplo into this project,\n"),process.stdout.write("or `npx ripplo init` to set it up by hand.\n"))}function ip(e){let t=e.name.trim().split(/\s+/)[0];return t!=null&&t.length>0?t:e.email}async function tn({serverUrl:e,token:t}){try{let n=(await S({config:De({serverUrl:e,token:t}),document:op,variables:void 0})).currentUser;return n==null?null:{email:n.email,name:n.name}}catch{return null}}async function Pi(){let e=ne();e==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login`.\n"),process.exit(1));let t=fe(),r=await tn({serverUrl:t,token:e});r==null&&(process.stdout.write("Token rejected. Run `ripplo auth login` to re-authenticate.\n"),process.exit(1)),process.stdout.write(`Authenticated as ${r.name} <${r.email}> (${t})
|
|
208
|
+
`)}function Ci(){if(!Fr()){process.stdout.write(`No token to remove.
|
|
209
209
|
`);return}process.stdout.write(`Removed ${be("token")}
|
|
210
|
-
`)}import
|
|
211
|
-
`}async function Ut({cwd:e}){let t=rn.join(e,ce),r=await mm(t);return r==null?null:ap(Ni,r)}async function de({cwd:e,result:t}){let r=Oi(t),n=rn.join(e,ce);await tn.mkdir(rn.dirname(n),{recursive:!0}),await tn.writeFile(n,on(r),"utf8")}function Vt({compiled:e,existing:t}){if(t==null)return"missing";let r=on(Oi(e)),n=on(t);return r===n?"match":"stale"}async function mm(e){try{return await tn.readFile(e,"utf8")}catch(t){if(fm(t)&&t.code==="ENOENT")return null;throw t}}function fm(e){return e instanceof Error&&"code"in e}function gm(e){return function(r,n){return n===e||!ym(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function ym(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import Ht from"fs";import dn from"path";var an=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],xe=["**/*.gen.*","**/generated/**","**/*.d.ts","**/*.test.*","**/*.spec.*","**/node_modules/**","**/dist/**","**/build/**",".ripplo/**","**/*.md","**/.next/**","**/.turbo/**","**/.vercel/**","**/.svelte-kit/**","**/.nuxt/**","**/.astro/**","**/coverage/**","**/storybook-static/**","**/*.stories.*","**/*.story.*","**/cli/**","**/scripts/**","**/tools/**","**/__tests__/**","**/__mocks__/**","**/__fixtures__/**","**/*.config.*","**/*.setup.*","**/public/**","**/static/**","**/assets/**","**/migrations/**","**/prisma/migrations/**","**/scripts/**"];function Di(e){return e.data}function Li(e){return{as(t){return{data:{label:t,node:e}}}}}function Ft(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();hm(n);let o={};t.forEach(a=>{o[a.name]={depends:[...a.dependsOn],description:a.description,returns:[...a.returns]}});let i={};r.forEach(a=>{i[a.name]={budget:a.budget,description:a.description}});let s=n.map(a=>wm(a,t));return{observers:i,preconditions:o,tests:s}}function hm(e){let t=new Map;e.forEach(r=>{let n=t.get(r.id);if(n!=null)throw new Error(`Duplicate test id "${r.id}" used by "${n}" and "${r.name}"`);t.set(r.id,r.name)})}function wm(e,t){let r=e.id,{accessedKeys:n,vars:o}=Sm(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[bm(i),...s],l=vm(a,n,e.requiresKeys,e.uiOnly),c=[];Object.keys(e.requiresKeys).length>0&&n.size===0&&e.implemented&&c.push("Test requires preconditions but never references their data \u2014 destructure and use precondition data in steps()");let u=Rm(e.requires,t);return{additionalChecks:[],coverage:e.coverage,description:e.description,expectedOutcome:e.expectedOutcome,implemented:e.implemented,name:e.name,preconditions:u,requiresKeys:{...e.requiresKeys},slug:r,spec:l,warnings:c}}function bm(e){return Li({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function Sm(e){let t=new Set,r={};return Object.keys(e).forEach(n=>{r[n]=new Proxy({},{get(o,i){if(typeof i=="string"){let s=`${n}.${i}`;return t.add(s),`{{${s}}}`}}})}),{accessedKeys:t,vars:r}}function vm(e,t,r,n){let o={};e.forEach((a,l)=>{let c=`step-${String(l)}`,d=l<e.length-1?`step-${String(l+1)}`:void 0;o[c]=km(a,c,d)});let i={};t.forEach(a=>{i[a]={default:`test-${a}`,type:"string"}});let s={...r};return{entryNode:"step-0",nodes:o,uiOnly:n,variableNamespaces:s,variables:i}}function km(e,t,r){let{label:n,node:o}=Di(e);return{...o,id:t,label:n,next:r}}function Rm(e,t){let r=new Map(t.map(s=>[s.name,s])),n=[],o=new Set;function i(s){o.has(s)||(o.add(s),r.get(s)?.dependsOn.forEach(a=>{i(a)}),n.push(s))}return e.forEach(s=>{i(s)}),n}import{Webhook as yP,WebhookVerificationError as hP}from"standardwebhooks";import{z as $}from"zod";var bP=$.object({preconditions:$.array($.string().min(1))}),SP=$.object({data:$.record($.string(),$.record($.string(),$.string())),preconditions:$.array($.string().min(1))}),vP=$.object({observer:$.string().min(1).max(200),params:$.record($.string().max(200),$.union([$.string(),$.number(),$.boolean()]))}),xm=$.discriminatedUnion("kind",[$.object({kind:$.literal("pass")}),$.object({kind:$.literal("retry"),reason:$.string()}),$.object({kind:$.literal("fail"),reason:$.string()})]),kP=$.object({error:$.string().optional(),outcome:xm.optional(),success:$.boolean()});function Ue(e){let t=[];return e.tests.forEach(r=>{let n=Pm(r),o=i=>{t.push({...i,test:r.slug})};Gm.forEach(i=>{i(n,r,o)})}),{diagnostics:t}}function Pm(e){let t=[],r=e.spec.entryNode,n=new Set;for(;r!=null&&!n.has(r);){n.add(r);let o=e.spec.nodes[r];if(o==null)break;t.push(o),r=o.next}return t}function Cm(e,t,r){e.forEach(n=>{n.type==="assertText"&&"operator"in n&&n.operator!=="equals"&&r({message:`${n.type} uses operator "${n.operator}" \u2014 only "equals" is allowed for determinism`,rule:"exact-text-match",step:n.label??n.id})})}function Em(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&Ui(o.value)){let i=o.value.value;!Vi(i)&&Om(i)&&r({message:`fill() uses hardcoded value "${i}" \u2014 consider using precondition data via {{namespace.key}}`,rule:"no-hardcoded-data",step:o.label??o.id})}})}function Tm(e,t,r){if(Object.keys(t.spec.variables??{}).length===0)return;e.some(i=>JSON.stringify(i).includes("{{"))||r({message:"Test requires preconditions but steps() never references precondition data \u2014 destructure and use it",rule:"prefer-precondition-data",step:void 0})}function $m(e,t,r){e.forEach(n=>{(n.label==null||n.label.length===0)&&r({message:`Step "${n.id}" lacks .as("...") label \u2014 every step must be labeled`,rule:"missing-label",step:n.id})})}function Am(e,t,r){let n=new Map;e.forEach(o=>{if(o.label==null)return;let i=n.get(o.label);i==null?n.set(o.label,o.id):r({message:`Duplicate label "${o.label}" \u2014 also used by ${i}`,rule:"no-duplicate-labels",step:o.label})})}function Im(e,t,r){let n=0;e.forEach(o=>{Ve(o)?n=0:(n++,n===3&&r({message:"3+ consecutive actions without an assertion \u2014 add verification between actions",rule:"assert-after-action",step:o.label??o.id}))})}function jm(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!Ve(n)&&r({message:"Last step is an action, not an assertion \u2014 expectedOutcome should be verified by assertions at the end",rule:"assert-matches-outcome",step:n.label??n.id})}function Nm(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function Ui(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Vi(e){return e.includes("{{")}function Om(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function Ve(e){return e.type.startsWith("assert")}var Dm=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function Lm(e){return Dm.has(e.type)}function _m(e,t,r){!t.implemented||e.length===0||e.some(n=>Ve(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function Um(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>Ve(i)).length;if(n===0)return;let o=n/e.length;if(o<.15){let i=Math.round(o*100);r({message:`Only ${String(n)}/${String(e.length)} steps are assertions (${String(i)}%) \u2014 add more verification between actions`,rule:"low-assertion-ratio",step:void 0})}}function ln(e){if(!("locator"in e)||e.locator==null)return;let t=e.locator;return t.by==="role"?`role:${t.role}:${t.name??""}`:`testId:${t.value}`}function Vm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=ln(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&ln(c)===i)==null||s.some(c=>Lm(c)||Ve(c)&&ln(c)!==i)||r({message:`click "${n.label??n.id}" is followed only by assert.visible on the same locator \u2014 verifies nothing about the click's effect`,rule:"tautological-post-click-assert",step:n.label??n.id})})}var Fm=new Set(["the","is","a","an","and","or","of","to","in","on","at","for","that","this","with","be","are","was","were","it","its","as","by","from","after","before","should","will","can","still","but","not","no","so","if","then","than","user","users","page","view","shows","show","see","click","clicks","clicked","clickable","visible","appears","appear","displayed","stays","remains"]);function cn(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!Fm.has(t))}function Mm(e){let t=e.label==null?[]:cn(e.label);if(!("locator"in e)||e.locator==null)return t;let r=e.locator,n=r.by==="role"?r.name??"":r.value;return[...t,...cn(n)]}function Hm(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(cn(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>Ve(s));if(o.length===0)return;o.some(s=>Mm(s).some(a=>n.has(a)))||r({message:`No assertion references any keyword from expectedOutcome (${[...n].join(", ")}) \u2014 the outcome may not actually be verified`,rule:"expected-outcome-keyword-coverage",step:void 0})}var Wm=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function _i(e){if(e.type==="upload"||e.type==="handleDialog"&&e.action==="accept")return!0;if(e.type!=="click")return!1;let t=e.locator,r=t.by==="role"?t.name??"":t.value;return Wm.test(r)}function qm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!_i(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>_i(d)),a=s===-1?i.length:s;i.slice(0,a).some(d=>d.type==="assertObserver")||r({message:`"${n.label??n.id}" looks like it mutates backend state but no assert.backend(...) observer verifies it \u2014 the test can pass while the server is broken. You need to add an observer that checks the persisted result (see .ripplo/observers/ for examples). Only if this action truly does NOT change any server state (pure client-side interaction, presentation toggle, etc.) should you fall back to marking the step { uiOnly: true } to silence this rule.`,rule:"mutation-without-observer-coverage",step:n.label??n.id})})}function Bm(e,t,r){Object.keys(t.spec.variables??{}).length!==0&&e.forEach(o=>{if(o.type!=="assertObserver")return;let i=Object.entries(o.params);i.length===0||i.some(([,a])=>Ui(a)&&Vi(a.value))||r({message:`assert.backend "${o.label??o.id}" passes only hardcoded params while the test defines precondition variables \u2014 observer assertions should reference {{namespace.key}} so they match the actual precondition data`,rule:"observer-params-reference-variables",step:o.label??o.id})})}function zm(e,t,r){let n=new Set(Object.keys(t.spec.variables??{})),o=/\{\{([^{}]+?)\}\}/g;e.forEach(i=>{let a=[...JSON.stringify(i).matchAll(o)],l=[...new Set(a.map(u=>u[1]).filter(u=>u!=null&&!n.has(u)))];if(l.length===0)return;let c=l.map(u=>`{{${u}}}`).join(", "),d=[...new Set(l.map(u=>u.split(".")[0]??u))].join(", ");r({message:`"${i.label??i.id}" contains literal template string(s) ${c} \u2014 destructure the proxy in .steps(({ ${d} }) => \u2026) and pass the proxy value (e.g. \`${l[0]??""}\`) directly. Writing the template as a string bypasses type-checking and silently accepts typos.`,rule:"no-literal-template-strings",step:i.label??i.id})})}var Gm=[Cm,Em,zm,Tm,$m,Am,Im,jm,Nm,_m,Um,Vm,Hm,qm,Bm];import bf from"picomatch";import{execFileSync as Km,spawnSync as Jm}from"child_process";function X(e,t){return Km("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function Fi(e,t){let r=Jm("git",["show",e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]});if(r.status===0)return r.stdout;if(r.status===128)return null;throw new Error(`git show ${e} failed (${String(r.status)}): ${r.stderr}`)}import R from"typescript";import*as Mi from"remeda";var Hi=[["onClick","click"],["onContextMenu","click"],["onKeyDown","click"],["onKeyPress","click"],["onKeyUp","click"],["onSelect","click"],["onOpenChange","click"],["onPress","click"],["onActivate","click"],["onToggle","click"],["onOpen","click"],["onClose","click"],["onDismiss","click"],["onConfirm","click"],["onCancel","click"],["onApply","click"],["onClear","click"],["onSubmit","submit"],["onReset","submit"],["onDrop","drag"],["onDragEnd","drag"],["onDragEnter","drag"],["onDragLeave","drag"],["onDragOver","drag"],["onDragStart","drag"],["onValueChange","select"],["onSelectionChange","select"],["onChange","input"],["onCheckedChange","input"],["onInput","input"]],Ym=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Xm=[[/(?:^|[a-z])Button$/,"click"],[/(?:^|[a-z])(?:Link|NavLink|Anchor)$/,"navigate"],[/(?:^|[a-z])(?:Textarea|TextArea|Input|Field|SearchBox)$/,"input"],[/(?:^|[a-z])(?:Select|Combobox|ComboBox|Dropdown)$/,"select"],[/(?:^|[a-z])Form$/,"submit"]];function Mt({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>Qm({filePath:e,sf:r,stmt:n}))}function Qm({filePath:e,sf:t,stmt:r}){let n=ef(r);if(n==null||Zm(n))return[];let o=Wi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Mi.uniqueBy(o,i=>i.id)}function Zm(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function ef(e){if(R.isExportAssignment(e))return tf(e.expression);if(!rf(e))return null;if(R.isFunctionDeclaration(e)||R.isClassDeclaration(e))return e.name?.text??null;if(R.isVariableStatement(e)){let t=e.declarationList.declarations[0];return t!=null&&R.isIdentifier(t.name)?t.name.text:null}return null}function tf(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function rf(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function Wi(e,t){let r=nf(e,t),n=e.getChildren(t).flatMap(o=>Wi(o,t));return r==null?n:[r,...n]}function nf(e,t){let r=of(e);if(r==null)return null;let n=sf(r);if(n==null)return null;let o=uf(r,n);return o==null?null:{kind:n,label:o,line:wf(t,e.getStart(t))}}function of(e){return R.isJsxSelfClosingElement(e)&&R.isIdentifier(e.tagName)?{attrs:e.attributes,children:[],tag:e.tagName.text}:R.isJsxElement(e)&&R.isIdentifier(e.openingElement.tagName)?{attrs:e.openingElement.attributes,children:e.children,tag:e.openingElement.tagName.text}:null}function sf({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Ym.get(r)??null:lf(t,e)??cf(t)??df(e)}var af=new Map([["button",()=>"click"],["a",e=>ue(e,"href")==null?null:"navigate"],["input",e=>ue(e,"type")==="file"?"upload":"input"],["textarea",()=>"input"],["select",()=>"select"],["form",()=>"submit"]]);function lf(e,t){return af.get(e)?.(t)??null}function cf(e){return/^[A-Z]/.test(e)?Xm.find(([t])=>t.test(e))?.[1]??null:null}function df(e){return Hi.find(([t])=>ff(e,t))?.[1]??null}function uf({attrs:e,children:t,tag:r},n){return n==="navigate"?ue(e,"href")??ue(e,"to"):ue(e,"aria-label")??ue(e,"label")??ue(e,"title")??ue(e,"name")??ue(e,"placeholder")??(pf(r)?void 0:hf(t))??mf(e,n)}function pf(e){return e==="input"||e==="textarea"||e==="select"}function mf(e,t){let r=Hi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=gf(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return qi(n.body)}}function qi(e){if(R.isCallExpression(e)){let t=e.expression;return R.isIdentifier(t)?t.text:R.isPropertyAccessExpression(t)?t.name.text:void 0}return R.forEachChild(e,qi)}function ff(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function Bi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=Bi(e,t);return r==null?void 0:yf(r.initializer)}function gf(e,t){let r=Bi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function yf(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return Gi(e.expression)}function hf(e){let t=e.flatMap(r=>zi(r)).join(" ").trim();return t.length===0?void 0:t}function zi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=Gi(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>zi(t)):[]}function Gi(e){if(e!=null){if(R.isStringLiteral(e)||R.isNoSubstitutionTemplateLiteral(e))return e.text;if(R.isCallExpression(e)&&e.arguments.length===1){let t=e.arguments[0];if(t!=null&&(R.isStringLiteral(t)||R.isNoSubstitutionTemplateLiteral(t)))return t.text}}}function wf(e,t){return e.getLineAndCharacterOfPosition(t).line+1}var Sf=dn.join(".ripplo","coverage.d.ts");function Fe({cwd:e}){vf({cwd:e,ignorePaths:xe})}function vf({cwd:e,ignorePaths:t}){let r=Me({cwd:e,ignorePaths:t});xf({content:Rf(r),cwd:e})}function Me({cwd:e,ignorePaths:t}){let n=kf({cwd:e,ignorePaths:t}).flatMap(o=>un({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function kf({cwd:e,ignorePaths:t}){let r=X(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=bf([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o))}function un({cwd:e,file:t}){let r=Ht.readFileSync(dn.join(e,t),"utf8");return Mt({filePath:t,source:r}).map(n=>n.id)}function Rf(e){let t=`// GENERATED \u2014 do not edit
|
|
210
|
+
`)}import nn from"fs/promises";import on from"path";import{z as Vt}from"zod";import{z as Ei}from"zod";import{z as Le}from"zod";import{z as m}from"zod";import{z as Re}from"zod";import{z as ji}from"zod";import{z as D}from"zod";import{z as te}from"zod";import{z as rn}from"zod";import{z}from"zod";var sp=Vt.object({__codec:Vt.string().min(1),data:Vt.unknown(),version:Vt.number().int().positive()}),ap=class extends Error{codec;currentVersion;gotVersion;constructor(e){super(`Unsupported ${e.codec} version ${String(e.gotVersion)} (current ${String(e.currentVersion)}). Upgrade Ripplo or rebuild with a compatible CLI.`),this.name="CodecVersionError",this.codec=e.codec,this.currentVersion=e.currentVersion,this.gotVersion=e.gotVersion}},lp=class extends Error{constructor(e){super(`Codec mismatch: expected "${e.expected}", got "${e.got}"`),this.name="CodecMismatchError"}};function ln(e){return $i({legacy:void 0,migrators:[],name:e,schemas:[]})}function cp(e,t){let r=JSON.parse(t);return e.decode(r)}function $i(e){return{initial:t=>sn(t,{...e,schemas:[t]}),legacy:t=>$i({...e,legacy:t})}}function sn(e,t){return{build:()=>dp(e,t),legacy:r=>sn(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return sn(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function dp(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>up(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function up(e,t,r){let{data:n,version:o}=pp(t,r),i=Ai(t,n,o);return e.parse(i)}function pp(e,t){let r=sp.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new lp({expected:e.name,got:r.data.__codec});return{data:r.data.data,version:r.data.version}}if(e.legacy!=null&&e.legacy.detect(t))return{data:t,version:e.legacy.assumedVersion};throw new Error(`Cannot decode "${e.name}": value is not a codec envelope and no legacy detector matched.`)}function Ai(e,t,r){let n=e.schemas.length;if(r>n)throw new ap({codec:e.name,currentVersion:n,gotVersion:r});if(r===n)return t;let o=e.schemas[r-1];if(o==null)throw new Error(`Codec "${e.name}" missing schema for v${String(r)}; cannot migrate.`);let i=o.parse(t),s=e.migrators[r-1];if(s==null)throw new Error(`Codec "${e.name}" missing migrator v${String(r)} \u2192 v${String(r+1)}.`);return Ai(e,s(i),r+1)}var Ii=Le.object({depends:Le.array(Le.string().min(1)).optional().describe("Names of other preconditions that must be satisfied first. Resolved via topological sort; cycles are rejected at validation time."),description:Le.string().min(1).describe("Human-readable description of what this precondition ensures"),returns:Le.array(Le.string().min(1)).optional().describe("Keys that the execute response's data field will contain. e.g. ['projectId', 'workflowId']. These are used for route param interpolation ({{projectId}}) and workflow variables. Declared here so generated types are strongly typed per precondition.")}).describe("A named precondition declared at the graph level. States reference these by name."),mp=Re.object({by:Re.literal("testId"),value:Re.string().min(1)}),fp=Re.object({by:Re.literal("role"),name:Re.string().optional(),role:Re.string().min(1)}),A=Re.discriminatedUnion("by",[mp,fp]),ot=ji.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),gp=ji.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]),yp=D.object({type:D.literal("static"),value:D.union([D.string(),D.number(),D.boolean()])}),Ft=D.object({name:D.string().min(1),type:D.literal("variable")}),hp=D.discriminatedUnion("type",[yp,Ft]),le=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.string()}),Ft]),wp=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.number().int().nonnegative()}),Ft]),bp=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.union([D.string(),D.number(),D.boolean()])}),Ft]),Sp=te.discriminatedUnion("type",[te.object({default:te.string().optional(),type:te.literal("string")}),te.object({default:te.number().optional(),type:te.literal("number")}),te.object({default:te.boolean().optional(),type:te.literal("boolean")}),te.object({key:te.string().min(1),type:te.literal("env")})]),C={id:m.string().min(1).max(200),label:m.string().max(500).optional(),next:m.string().max(200).optional(),uiOnly:m.boolean().optional()},Ti=500,vp=m.object({...C,type:m.literal("goto"),url:le}),kp=m.object({...C,locator:A,type:m.literal("click")}),Rp=m.object({...C,locator:A,type:m.literal("fill"),value:le}),xp=m.object({...C,locator:A,type:m.literal("select"),value:le}),Pp=m.object({...C,locator:A,type:m.literal("hover")}),Cp=m.object({...C,key:m.string().min(1),locator:A.optional(),type:m.literal("press")}),Ep=m.object({...C,locator:A,type:m.literal("check")}),Tp=m.object({...C,locator:A,type:m.literal("uncheck")}),$p=m.object({...C,height:m.number().int().positive(),type:m.literal("setViewport"),width:m.number().int().positive()}),Ap=m.object({...C,message:m.string().min(1),type:m.literal("fail")}),Ip=m.object({...C,type:m.literal("setVariable"),value:hp,variable:m.string().min(1)}),jp=m.object({...C,locator:A,type:m.literal("extractText"),variable:m.string().min(1)}),Np=m.object({...C,files:m.array(m.string()).min(1),locator:A,type:m.literal("upload")}),Op=m.object({...C,locator:A,type:m.literal("dblclick")}),Dp=m.object({...C,source:A,target:A,type:m.literal("drag")}),Lp=m.object({...C,locator:A,type:m.literal("scrollIntoView")}),_p=m.object({...C,locator:A,type:m.literal("type"),value:le}),Up=m.object({...C,locator:A,type:m.literal("focus")}),Vp=m.object({...C,locator:A,type:m.literal("clear")}),Fp=m.object({...C,locator:A,type:m.literal("rightClick")}),Mp=m.object({...C,action:m.enum(["accept","dismiss"]),promptText:m.string().optional(),type:m.literal("handleDialog")}),Hp=m.object({...C,action:m.enum(["read","write"]),type:m.literal("clipboard"),value:le.optional(),variable:m.string().min(1).optional()}),Wp=m.object({...C,permission:m.string().min(1),state:m.enum(["granted","prompt"]),type:m.literal("setPermission")}),qp=m.object({...C,locator:A,type:m.literal("assertVisible")}),Bp=m.object({...C,locator:A,type:m.literal("assertNotVisible")}),zp=m.object({...C,expected:le,locator:A,operator:ot,type:m.literal("assertText")}),Gp=m.object({...C,expected:le,operator:ot,type:m.literal("assertUrl")}),Kp=m.object({...C,expected:wp,locator:A,operator:gp,type:m.literal("assertCount")}),Jp=m.object({...C,expected:le,locator:A,operator:ot,type:m.literal("assertValue")}),Yp=m.object({...C,attribute:m.string().min(1),expected:le,locator:A,operator:ot,type:m.literal("assertAttribute")}),Xp=m.object({...C,locator:A,type:m.literal("assertEnabled")}),Qp=m.object({...C,locator:A,type:m.literal("assertDisabled")}),Zp=m.object({...C,expected:le,operator:ot,type:m.literal("assertTitle")}),em=m.object({...C,locator:A,type:m.literal("assertChecked")}),tm=m.object({...C,locator:A,type:m.literal("assertNotChecked")}),rm=m.object({...C,locator:A,type:m.literal("assertFocused")}),nm=m.object({...C,locator:A,type:m.literal("assertNotFocused")}),om=m.object({...C,budget:m.enum(["fast","slow","async"]),observer:m.string().min(1).max(200),params:m.record(m.string().max(200),bp),type:m.literal("assertObserver")}),im=m.discriminatedUnion("type",[vp,kp,Rp,xp,Pp,Cp,Ep,Tp,qp,Bp,zp,Gp,Kp,Jp,Yp,Xp,Qp,$p,Ap,Ip,jp,Np,Op,Dp,Lp,_p,Up,Vp,Fp,Mp,Hp,Wp,Zp,em,tm,rm,nm,om]),Ni=m.object({entryNode:m.string().min(1).max(200),nodes:m.record(m.string().max(200),im).refine(e=>Object.keys(e).length<=Ti,`Workflow has more than ${String(Ti)} nodes`),uiOnly:m.boolean().optional(),variableNamespaces:m.record(m.string().max(200),m.string().max(500)).optional(),variables:m.record(m.string().max(200),Sp).optional()}),sm=Ei.record(Ei.string().max(200),Ii),am={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},lm={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},pP=ln("workflow-spec").legacy(am).initial(Ni).build(),mP=ln("precondition-map").legacy(lm).initial(sm).build(),cm=["fast","slow","async"],dm=rn.object({budget:rn.enum(cm).describe("Polling budget tier: fast | slow | async"),description:rn.string().min(1).describe("Human-readable description of what this observer checks")}).describe("A named backend state observer. Tests assert against it with assert.backend(observer, params). Implementation lives on the user's server."),ce=".ripplo/ripplo.lock",um=5e3,pm=z.record(z.string().max(200),z.string().max(200)),mm=z.object({coverage:z.array(z.string().max(500)).max(2e3).default([]),expectedOutcome:z.string().max(2e3),name:z.string().max(200),preconditions:z.array(z.string().max(200)).max(1e3),requiresKeys:pm,slug:z.string().max(200),spec:Ni}),fm=z.object({observers:z.record(z.string().max(200),dm),preconditions:z.record(z.string().max(200),Ii),tests:z.array(mm).max(um)}),Oi=ln("ripplo-lockfile").initial(fm).build();function Di(e){return{observers:e.observers,preconditions:e.preconditions,tests:e.tests.filter(t=>t.implemented).map(t=>({coverage:[...t.coverage],expectedOutcome:t.expectedOutcome,name:t.name,preconditions:[...t.preconditions],requiresKeys:{...t.requiresKeys},slug:t.slug,spec:t.spec}))}}function an(e){let t=Oi.encode(e);return`${JSON.stringify(t,hm(t),2)}
|
|
211
|
+
`}async function Mt({cwd:e}){let t=on.join(e,ce),r=await gm(t);return r==null?null:cp(Oi,r)}async function de({cwd:e,result:t}){let r=Di(t),n=on.join(e,ce);await nn.mkdir(on.dirname(n),{recursive:!0}),await nn.writeFile(n,an(r),"utf8")}function Ht({compiled:e,existing:t}){if(t==null)return"missing";let r=an(Di(e)),n=an(t);return r===n?"match":"stale"}async function gm(e){try{return await nn.readFile(e,"utf8")}catch(t){if(ym(t)&&t.code==="ENOENT")return null;throw t}}function ym(e){return e instanceof Error&&"code"in e}function hm(e){return function(r,n){return n===e||!wm(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function wm(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import it from"fs";import Bt from"path";var cn=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],xe=["**/*.gen.*","**/generated/**","**/*.d.ts","**/*.test.*","**/*.spec.*","**/node_modules/**","**/dist/**","**/build/**",".ripplo/**","**/*.md","**/.next/**","**/.turbo/**","**/.vercel/**","**/.svelte-kit/**","**/.nuxt/**","**/.astro/**","**/coverage/**","**/storybook-static/**","**/*.stories.*","**/*.story.*","**/cli/**","**/scripts/**","**/tools/**","**/__tests__/**","**/__mocks__/**","**/__fixtures__/**","**/*.config.*","**/*.setup.*","**/public/**","**/static/**","**/assets/**","**/migrations/**","**/prisma/migrations/**","**/scripts/**"];function Li(e){return e.data}function _i(e){return{as(t){return{data:{label:t,node:e}}}}}function Wt(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();bm(n);let o={};t.forEach(a=>{o[a.name]={depends:[...a.dependsOn],description:a.description,returns:[...a.returns]}});let i={};r.forEach(a=>{i[a.name]={budget:a.budget,description:a.description}});let s=n.map(a=>Sm(a,t));return{observers:i,preconditions:o,tests:s}}function bm(e){let t=new Map;e.forEach(r=>{let n=t.get(r.id);if(n!=null)throw new Error(`Duplicate test id "${r.id}" used by "${n}" and "${r.name}"`);t.set(r.id,r.name)})}function Sm(e,t){let r=e.id,{accessedKeys:n,vars:o}=km(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[vm(i),...s],l=Rm(a,n,e.requiresKeys,e.uiOnly),c=[];Object.keys(e.requiresKeys).length>0&&n.size===0&&e.implemented&&c.push("Test requires preconditions but never references their data \u2014 destructure and use precondition data in steps()");let u=Pm(e.requires,t);return{additionalChecks:[],coverage:e.coverage,description:e.description,expectedOutcome:e.expectedOutcome,implemented:e.implemented,name:e.name,preconditions:u,requiresKeys:{...e.requiresKeys},slug:r,spec:l,warnings:c}}function vm(e){return _i({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function km(e){let t=new Set,r={};return Object.keys(e).forEach(n=>{r[n]=new Proxy({},{get(o,i){if(typeof i=="string"){let s=`${n}.${i}`;return t.add(s),`{{${s}}}`}}})}),{accessedKeys:t,vars:r}}function Rm(e,t,r,n){let o={};e.forEach((a,l)=>{let c=`step-${String(l)}`,d=l<e.length-1?`step-${String(l+1)}`:void 0;o[c]=xm(a,c,d)});let i={};t.forEach(a=>{i[a]={default:`test-${a}`,type:"string"}});let s={...r};return{entryNode:"step-0",nodes:o,uiOnly:n,variableNamespaces:s,variables:i}}function xm(e,t,r){let{label:n,node:o}=Li(e);return{...o,id:t,label:n,next:r}}function Pm(e,t){let r=new Map(t.map(s=>[s.name,s])),n=[],o=new Set;function i(s){o.has(s)||(o.add(s),r.get(s)?.dependsOn.forEach(a=>{i(a)}),n.push(s))}return e.forEach(s=>{i(s)}),n}import{Webhook as xP,WebhookVerificationError as PP}from"standardwebhooks";import{z as $}from"zod";var EP=$.object({preconditions:$.array($.string().min(1))}),TP=$.object({data:$.record($.string(),$.record($.string(),$.string())),preconditions:$.array($.string().min(1))}),$P=$.object({observer:$.string().min(1).max(200),params:$.record($.string().max(200),$.union([$.string(),$.number(),$.boolean()]))}),Cm=$.discriminatedUnion("kind",[$.object({kind:$.literal("pass")}),$.object({kind:$.literal("retry"),reason:$.string()}),$.object({kind:$.literal("fail"),reason:$.string()})]),AP=$.object({error:$.string().optional(),outcome:Cm.optional(),success:$.boolean()});function _e(e){let t=[];return e.tests.forEach(r=>{let n=Em(r),o=i=>{t.push({...i,test:r.slug})};Jm.forEach(i=>{i(n,r,o)})}),{diagnostics:t}}function Em(e){let t=[],r=e.spec.entryNode,n=new Set;for(;r!=null&&!n.has(r);){n.add(r);let o=e.spec.nodes[r];if(o==null)break;t.push(o),r=o.next}return t}function Tm(e,t,r){e.forEach(n=>{n.type==="assertText"&&"operator"in n&&n.operator!=="equals"&&r({message:`${n.type} uses operator "${n.operator}" \u2014 only "equals" is allowed for determinism`,rule:"exact-text-match",step:n.label??n.id})})}function $m(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&Vi(o.value)){let i=o.value.value;!Fi(i)&&Lm(i)&&r({message:`fill() uses hardcoded value "${i}" \u2014 consider using precondition data via {{namespace.key}}`,rule:"no-hardcoded-data",step:o.label??o.id})}})}function Am(e,t,r){if(Object.keys(t.spec.variables??{}).length===0)return;e.some(i=>JSON.stringify(i).includes("{{"))||r({message:"Test requires preconditions but steps() never references precondition data \u2014 destructure and use it",rule:"prefer-precondition-data",step:void 0})}function Im(e,t,r){e.forEach(n=>{(n.label==null||n.label.length===0)&&r({message:`Step "${n.id}" lacks .as("...") label \u2014 every step must be labeled`,rule:"missing-label",step:n.id})})}function jm(e,t,r){let n=new Map;e.forEach(o=>{if(o.label==null)return;let i=n.get(o.label);i==null?n.set(o.label,o.id):r({message:`Duplicate label "${o.label}" \u2014 also used by ${i}`,rule:"no-duplicate-labels",step:o.label})})}function Nm(e,t,r){let n=0;e.forEach(o=>{Ue(o)?n=0:(n++,n===3&&r({message:"3+ consecutive actions without an assertion \u2014 add verification between actions",rule:"assert-after-action",step:o.label??o.id}))})}function Om(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!Ue(n)&&r({message:"Last step is an action, not an assertion \u2014 expectedOutcome should be verified by assertions at the end",rule:"assert-matches-outcome",step:n.label??n.id})}function Dm(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function Vi(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Fi(e){return e.includes("{{")}function Lm(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function Ue(e){return e.type.startsWith("assert")}var _m=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function Um(e){return _m.has(e.type)}function Vm(e,t,r){!t.implemented||e.length===0||e.some(n=>Ue(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function Fm(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>Ue(i)).length;if(n===0)return;let o=n/e.length;if(o<.15){let i=Math.round(o*100);r({message:`Only ${String(n)}/${String(e.length)} steps are assertions (${String(i)}%) \u2014 add more verification between actions`,rule:"low-assertion-ratio",step:void 0})}}function dn(e){if(!("locator"in e)||e.locator==null)return;let t=e.locator;return t.by==="role"?`role:${t.role}:${t.name??""}`:`testId:${t.value}`}function Mm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=dn(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&dn(c)===i)==null||s.some(c=>Um(c)||Ue(c)&&dn(c)!==i)||r({message:`click "${n.label??n.id}" is followed only by assert.visible on the same locator \u2014 verifies nothing about the click's effect`,rule:"tautological-post-click-assert",step:n.label??n.id})})}var Hm=new Set(["the","is","a","an","and","or","of","to","in","on","at","for","that","this","with","be","are","was","were","it","its","as","by","from","after","before","should","will","can","still","but","not","no","so","if","then","than","user","users","page","view","shows","show","see","click","clicks","clicked","clickable","visible","appears","appear","displayed","stays","remains"]);function un(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!Hm.has(t))}function Wm(e){let t=e.label==null?[]:un(e.label);if(!("locator"in e)||e.locator==null)return t;let r=e.locator,n=r.by==="role"?r.name??"":r.value;return[...t,...un(n)]}function qm(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(un(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>Ue(s));if(o.length===0)return;o.some(s=>Wm(s).some(a=>n.has(a)))||r({message:`No assertion references any keyword from expectedOutcome (${[...n].join(", ")}) \u2014 the outcome may not actually be verified`,rule:"expected-outcome-keyword-coverage",step:void 0})}var Bm=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function Ui(e){if(e.type==="upload"||e.type==="handleDialog"&&e.action==="accept")return!0;if(e.type!=="click")return!1;let t=e.locator,r=t.by==="role"?t.name??"":t.value;return Bm.test(r)}function zm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!Ui(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>Ui(d)),a=s===-1?i.length:s;i.slice(0,a).some(d=>d.type==="assertObserver")||r({message:`"${n.label??n.id}" looks like it mutates backend state but no assert.backend(...) observer verifies it \u2014 the test can pass while the server is broken. You need to add an observer that checks the persisted result (see .ripplo/observers/ for examples). Only if this action truly does NOT change any server state (pure client-side interaction, presentation toggle, etc.) should you fall back to marking the step { uiOnly: true } to silence this rule.`,rule:"mutation-without-observer-coverage",step:n.label??n.id})})}function Gm(e,t,r){Object.keys(t.spec.variables??{}).length!==0&&e.forEach(o=>{if(o.type!=="assertObserver")return;let i=Object.entries(o.params);i.length===0||i.some(([,a])=>Vi(a)&&Fi(a.value))||r({message:`assert.backend "${o.label??o.id}" passes only hardcoded params while the test defines precondition variables \u2014 observer assertions should reference {{namespace.key}} so they match the actual precondition data`,rule:"observer-params-reference-variables",step:o.label??o.id})})}function Km(e,t,r){let n=new Set(Object.keys(t.spec.variables??{})),o=/\{\{([^{}]+?)\}\}/g;e.forEach(i=>{let a=[...JSON.stringify(i).matchAll(o)],l=[...new Set(a.map(u=>u[1]).filter(u=>u!=null&&!n.has(u)))];if(l.length===0)return;let c=l.map(u=>`{{${u}}}`).join(", "),d=[...new Set(l.map(u=>u.split(".")[0]??u))].join(", ");r({message:`"${i.label??i.id}" contains literal template string(s) ${c} \u2014 destructure the proxy in .steps(({ ${d} }) => \u2026) and pass the proxy value (e.g. \`${l[0]??""}\`) directly. Writing the template as a string bypasses type-checking and silently accepts typos.`,rule:"no-literal-template-strings",step:i.label??i.id})})}var Jm=[Tm,$m,Km,Am,Im,jm,Nm,Om,Dm,Vm,Fm,Mm,qm,zm,Gm];import vf from"picomatch";import{execFileSync as Ym,spawnSync as Xm}from"child_process";function X(e,t){return Ym("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function Mi(e,t){let r=Xm("git",["show",e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]});if(r.status===0)return r.stdout;if(r.status===128)return null;throw new Error(`git show ${e} failed (${String(r.status)}): ${r.stderr}`)}import R from"typescript";import*as Hi from"remeda";var Wi=[["onClick","click"],["onContextMenu","click"],["onKeyDown","click"],["onKeyPress","click"],["onKeyUp","click"],["onSelect","click"],["onOpenChange","click"],["onPress","click"],["onActivate","click"],["onToggle","click"],["onOpen","click"],["onClose","click"],["onDismiss","click"],["onConfirm","click"],["onCancel","click"],["onApply","click"],["onClear","click"],["onSubmit","submit"],["onReset","submit"],["onDrop","drag"],["onDragEnd","drag"],["onDragEnter","drag"],["onDragLeave","drag"],["onDragOver","drag"],["onDragStart","drag"],["onValueChange","select"],["onSelectionChange","select"],["onChange","input"],["onCheckedChange","input"],["onInput","input"]],Qm=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Zm=[[/(?:^|[a-z])Button$/,"click"],[/(?:^|[a-z])(?:Link|NavLink|Anchor)$/,"navigate"],[/(?:^|[a-z])(?:Textarea|TextArea|Input|Field|SearchBox)$/,"input"],[/(?:^|[a-z])(?:Select|Combobox|ComboBox|Dropdown)$/,"select"],[/(?:^|[a-z])Form$/,"submit"]];function qt({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>ef({filePath:e,sf:r,stmt:n}))}function ef({filePath:e,sf:t,stmt:r}){let n=rf(r);if(n==null||tf(n))return[];let o=qi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Hi.uniqueBy(o,i=>i.id)}function tf(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function rf(e){if(R.isExportAssignment(e))return nf(e.expression);if(!of(e))return null;if(R.isFunctionDeclaration(e)||R.isClassDeclaration(e))return e.name?.text??null;if(R.isVariableStatement(e)){let t=e.declarationList.declarations[0];return t!=null&&R.isIdentifier(t.name)?t.name.text:null}return null}function nf(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function of(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function qi(e,t){let r=sf(e,t),n=e.getChildren(t).flatMap(o=>qi(o,t));return r==null?n:[r,...n]}function sf(e,t){let r=af(e);if(r==null)return null;let n=lf(r);if(n==null)return null;let o=mf(r,n);return o==null?null:{kind:n,label:o,line:Sf(t,e.getStart(t))}}function af(e){return R.isJsxSelfClosingElement(e)&&R.isIdentifier(e.tagName)?{attrs:e.attributes,children:[],tag:e.tagName.text}:R.isJsxElement(e)&&R.isIdentifier(e.openingElement.tagName)?{attrs:e.openingElement.attributes,children:e.children,tag:e.openingElement.tagName.text}:null}function lf({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Qm.get(r)??null:df(t,e)??uf(t)??pf(e)}var cf=new Map([["button",()=>"click"],["a",e=>ue(e,"href")==null?null:"navigate"],["input",e=>ue(e,"type")==="file"?"upload":"input"],["textarea",()=>"input"],["select",()=>"select"],["form",()=>"submit"]]);function df(e,t){return cf.get(e)?.(t)??null}function uf(e){return/^[A-Z]/.test(e)?Zm.find(([t])=>t.test(e))?.[1]??null:null}function pf(e){return Wi.find(([t])=>yf(e,t))?.[1]??null}function mf({attrs:e,children:t,tag:r},n){return n==="navigate"?ue(e,"href")??ue(e,"to"):ue(e,"aria-label")??ue(e,"label")??ue(e,"title")??ue(e,"name")??ue(e,"placeholder")??(ff(r)?void 0:bf(t))??gf(e,n)}function ff(e){return e==="input"||e==="textarea"||e==="select"}function gf(e,t){let r=Wi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=hf(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return Bi(n.body)}}function Bi(e){if(R.isCallExpression(e)){let t=e.expression;return R.isIdentifier(t)?t.text:R.isPropertyAccessExpression(t)?t.name.text:void 0}return R.forEachChild(e,Bi)}function yf(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function zi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=zi(e,t);return r==null?void 0:wf(r.initializer)}function hf(e,t){let r=zi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function wf(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return Ki(e.expression)}function bf(e){let t=e.flatMap(r=>Gi(r)).join(" ").trim();return t.length===0?void 0:t}function Gi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=Ki(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>Gi(t)):[]}function Ki(e){if(e!=null){if(R.isStringLiteral(e)||R.isNoSubstitutionTemplateLiteral(e))return e.text;if(R.isCallExpression(e)&&e.arguments.length===1){let t=e.arguments[0];if(t!=null&&(R.isStringLiteral(t)||R.isNoSubstitutionTemplateLiteral(t)))return t.text}}}function Sf(e,t){return e.getLineAndCharacterOfPosition(t).line+1}var kf=Bt.join(".ripplo","coverage.d.ts");function Ve({cwd:e}){Rf({cwd:e,ignorePaths:xe})}function Rf({cwd:e,ignorePaths:t}){let r=Fe({cwd:e,ignorePaths:t});Cf({content:Pf(r),cwd:e})}function Fe({cwd:e,ignorePaths:t}){let n=xf({cwd:e,ignorePaths:t}).flatMap(o=>pn({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function xf({cwd:e,ignorePaths:t}){let r=X(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=vf([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o)).filter(o=>it.existsSync(Bt.join(e,o)))}function pn({cwd:e,file:t}){let r=it.readFileSync(Bt.join(e,t),"utf8");return qt({filePath:t,source:r}).map(n=>n.id)}function Pf(e){let t=`// GENERATED \u2014 do not edit
|
|
212
212
|
import "@ripplo/testing";
|
|
213
213
|
|
|
214
214
|
declare module "@ripplo/testing" {
|
|
@@ -219,22 +219,22 @@ declare module "@ripplo/testing" {
|
|
|
219
219
|
`:`${t}${r}
|
|
220
220
|
}
|
|
221
221
|
}
|
|
222
|
-
`}function
|
|
223
|
-
`).map(a
|
|
222
|
+
`}function Cf({content:e,cwd:t}){let r=Bt.join(t,kf);it.existsSync(r)&&it.readFileSync(r,"utf8")===e||it.writeFileSync(r,e)}import Ji from"path";import{createJiti as Ef}from"jiti";var Tf=["getObservers","getPreconditions","getTests","getUnimplemented"];function $f(e){return e==null||typeof e!="object"?!1:Tf.every(t=>typeof Reflect.get(e,t)=="function")}function Af(e){return e===null?"null":Array.isArray(e)?"array":typeof e}async function j(e){let t=Ji.join(e,".ripplo","index.ts"),r=Ji.join(e,".ripplo");try{let o=await Ef(import.meta.url,{moduleCache:!1,sourceMaps:!0}).import(t),i=o!=null&&typeof o=="object"&&"default"in o?Reflect.get(o,"default"):o;if(!$f(i))return{error:`${t} must default-export a RipploBuilder (got ${Af(i)})`,ok:!1};let s=Wt(i);return{builder:i,ok:!0,result:s}}catch(n){return{error:jf(n,r),ok:!1}}}var If=/\(?([^\s()]{1,500}\.ts):(\d{1,10}):(\d{1,10})\)?$/;function jf(e,t){if(!(e instanceof Error))return String(e);let r=Nf(e.stack,t);return r==null?e.message:`${r} \u2014 ${e.message}`}function Nf(e,t){if(e==null)return;let n=e.split(`
|
|
223
|
+
`).map(a=>If.exec(a)).find(a=>a!=null&&a[1]!=null&&a[2]!=null&&a[3]!=null&&a[1].startsWith(t));if(n==null)return;let[,o,i,s]=n;return`${o??""}:${i??""}:${s??""}`}function x(e,t){return t==null?`Load \`/ripplo:${e}\` skill for instructions.`:`Load \`/ripplo:${e}\` skill for instructions on ${t}.`}function Yi(e){return e.length===1?x(e[0]):`REQUIRED before proceeding: load ${e.map(r=>`\`/ripplo:${r}\``).join(" AND ")} skills (load every one \u2014 each carries rules the others don't).`}async function Xi(e){let t=process.cwd(),r=await j(t);if(r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
224
224
|
`),process.stderr.write(`${x("create","DSL authoring + lint rules")}
|
|
225
|
-
`),process.exit(1)),e.check){let n=await
|
|
225
|
+
`),process.exit(1)),e.check){let n=await Mt({cwd:t}),o=Ht({compiled:r.result,existing:n});if(o==="match"){process.stdout.write(`${ce} is up to date
|
|
226
226
|
`);return}let i=o==="missing"?"missing":"out of date";process.stderr.write(`${ce} is ${i} \u2014 run \`ripplo compile\` and commit the result
|
|
227
227
|
`),process.stderr.write(`${x("setup")}
|
|
228
|
-
`),process.exit(1)}await de({cwd:t,result:r.result}),
|
|
229
|
-
`)}import ge from"process";import
|
|
230
|
-
`),ge.exit(1));let r=
|
|
228
|
+
`),process.exit(1)}await de({cwd:t,result:r.result}),Ve({cwd:t}),process.stdout.write(`wrote ${ce}
|
|
229
|
+
`)}import ge from"process";import Of from"fs";import Df from"path";import Lf from"picomatch";function Qi({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Fe({cwd:t,ignorePaths:r})),o=ts(e),i=_f({cwd:t,ignorePaths:r});return es({acknowledged:o,allStatements:n,unacked:i})}function Zi({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Fe({cwd:t,ignorePaths:r})),o=ts(e);return es({acknowledged:o,allStatements:n,unacked:n})}function es({acknowledged:e,allStatements:t,unacked:r}){let n=[...r].filter(i=>!e.has(i)).map(i=>({id:i,kind:"unacknowledged"})),o=[...e].filter(i=>!t.has(i)).map(i=>({id:i,kind:"stale"}));return[...n,...o]}function ts(e){return new Set(e.tests.flatMap(t=>t.coverage))}function _f({cwd:e,ignorePaths:t}){let r=Uf({cwd:e,ignorePaths:t}),n=new Set(r.flatMap(i=>Vf({cwd:e,file:i}))),o=new Set(r.flatMap(i=>Ff({cwd:e,file:i})?pn({cwd:e,file:i}):[]));return new Set([...o].filter(i=>!n.has(i)))}function Uf({cwd:e,ignorePaths:t}){let r=X(["diff","--name-only","HEAD","-z"],e),n=X(["ls-files","--others","--exclude-standard","-z"],e),o=Lf([...t]);return[...new Set([...r.split("\0"),...n.split("\0")])].filter(i=>i.length>0&&/\.(tsx|jsx)$/.test(i)).filter(i=>!o(i))}function Vf({cwd:e,file:t}){let r=Mi(`HEAD:${t}`,e);return r==null?[]:qt({filePath:t,source:r}).map(n=>n.id)}function Ff({cwd:e,file:t}){return Of.existsSync(Df.join(e,t))}async function rs(){let e=ge.cwd(),t=await j(e);t.ok||(ge.stderr.write(`Compilation failed: ${t.error}
|
|
230
|
+
`),ge.exit(1));let r=Fe({cwd:e,ignorePaths:xe}),n=Zi({compileResult:t.result,cwd:e,ignorePaths:xe}),o=n.filter(a=>a.kind==="unacknowledged"),i=n.filter(a=>a.kind==="stale"),s=r.length-o.length;ge.stdout.write(`Coverage: ${String(s)}/${String(r.length)} statements acknowledged
|
|
231
231
|
`),o.length>0&&(ge.stdout.write(`
|
|
232
232
|
Unacknowledged (${String(o.length)}):
|
|
233
233
|
`),o.forEach(a=>ge.stdout.write(` ${a.id}
|
|
234
234
|
`))),i.length>0&&(ge.stdout.write(`
|
|
235
235
|
Stale claims (${String(i.length)}):
|
|
236
236
|
`),i.forEach(a=>ge.stdout.write(` ${a.id}
|
|
237
|
-
`))),n.length>0&&ge.exit(1)}import
|
|
237
|
+
`))),n.length>0&&ge.exit(1)}import gn from"fs";import zf from"path";import{chromium as Gf}from"playwright";import{graphql as Hf}from"gql.tada";import ns from"fs";import mn from"path";function os(e){let t=ns.realpathSync(e),r=t,n=mn.dirname(r);for(;n!==r;){if(ns.existsSync(mn.join(r,".git")))return r;r=n,n=mn.dirname(r)}return t}function W(e){let t=ir(e),r=Ae(),n=ne();if(n==null)throw new Error("ripplo: not authenticated. Run `ripplo auth login`.");return{appUrl:r.appUrl,cwd:os(e),engineUrl:r.engineUrl,projectId:t.projectId,ripploServerUrl:fe(),token:n,webhookSecret:r.webhookSecret}}import st from"fs";var Mf="dev.pid";function is(e){return rt(e,Mf)}function Me(e){let t=is(e);if(!st.existsSync(t))return!1;let r=st.readFileSync(t,"utf8").trim(),n=Number.parseInt(r,10);if(!Number.isFinite(n)||n<=0)return!1;try{return process.kill(n,0),!0}catch{return!1}}function ss(e){tt(e);let t=is(e);st.writeFileSync(t,String(process.pid));let r=!1;return()=>{if(!r){r=!0;try{let n=st.readFileSync(t,"utf8").trim();Number.parseInt(n,10)===process.pid&&st.unlinkSync(t)}catch{}}}}var Wf=Hf(`
|
|
238
238
|
query DevSessionCheckHealth($projectId: String!, $cwd: String!) {
|
|
239
239
|
project(id: $projectId) {
|
|
240
240
|
id
|
|
@@ -243,18 +243,18 @@ Stale claims (${String(i.length)}):
|
|
|
243
243
|
}
|
|
244
244
|
}
|
|
245
245
|
}
|
|
246
|
-
`);function
|
|
246
|
+
`);function as(e){switch(e.status){case"active":return"\u2713 Dev session: ripplo watch is live for this directory";case"starting":return"! Dev session: `ripplo watch` is running locally but hasn't registered with the server yet. Wait a few seconds and re-run `npx ripplo doctor`. If it persists, check the watch process output for auth/network errors.";case"missing":return"\u2717 Dev session: no active ripplo watch. Start `npx ripplo watch` as a background process (separate from your app's dev server). Without it, `ripplo run` will refuse to dispatch and scope/coverage hooks won't arm."}}async function ls(e){let t=Me(e),r;try{r=W(e)}catch{return{status:t?"starting":"missing",type:"dev-session"}}return(await S({config:r,document:Wf,variables:{cwd:r.cwd,projectId:r.projectId}}).catch(()=>null))?.project?.devSession!=null?{status:"active",type:"dev-session"}:{status:t?"starting":"missing",type:"dev-session"}}import qf from"fs";import Bf from"path";async function cs(e){let t=Bf.join(e,".ripplo","index.ts");if(!qf.existsSync(t))return{appUrl:void 0,engineUrl:void 0,errors:[{message:".ripplo/index.ts not found",path:""}],valid:!1,warnings:[]};let r=await j(e);if(!r.ok)return{appUrl:void 0,engineUrl:void 0,errors:[{message:r.error,path:".ripplo/"}],valid:!1,warnings:[]};try{let n=Ae();return{appUrl:n.appUrl,engineUrl:n.engineUrl,errors:[],valid:!0,warnings:[]}}catch(n){return{appUrl:void 0,engineUrl:void 0,errors:[{message:n instanceof Error?n.message:String(n),path:""}],valid:!1,warnings:[]}}}async function fn(e){try{await fetch(e,{method:"HEAD",signal:AbortSignal.timeout(5e3)});return}catch{return`appUrl (${e}) is not responding. Make sure your dev server is running on that port.`}}async function ds({appUrl:e,engineUrl:t}){let r=t.startsWith("http://")||t.startsWith("https://")?t:`${e}${t}`;try{return(await fetch(`${r}/execute-preconditions`,{body:JSON.stringify({preconditions:[]}),headers:{"Content-Type":"application/json"},method:"PUT",signal:AbortSignal.timeout(5e3)})).ok?"Engine endpoint accepted an unsigned request \u2014 webhook signature verification may be missing.":void 0}catch{return}}function us(e){switch(e.type){case"settings":return!e.valid;case"env-files":return e.missing.length>0;case"token":return!e.exists;case"dev-server":return!e.reachable;case"dev-session":return e.status!=="active";case"preconditions":return e.count>0&&!e.configured;case"engine-endpoint":return!e.reachable;case"adapter-enabled":return e.status!=="enabled";case"webhook-verification":return!e.rejectsUnsigned;case"preconditions-validation":return!e.valid;case"workflows":return e.invalidNames.length>0;case"browser":return!e.installed;case"lockfile":return e.status!=="match";case"pre-commit-hook":return!e.installed}}async function ps(e){let t=await Yf(e),r={missing:lr(e),type:"env-files"},n=Xf(),o=Qf(),i=await j(e),s=Zf(i),a=rg(i),l=await Kf(e,i),c=Jf(e),d=await ng(t,i);return[t,r,n,...d,s,a,l,c,o]}async function Kf(e,t){if(!t.ok)return{status:"missing",type:"lockfile"};let r=await Mt({cwd:e});return{status:Ht({compiled:t.result,existing:r}),type:"lockfile"}}function Jf(e){let t=zf.join(e,".git","hooks","pre-commit");return gn.existsSync(t)?{installed:gn.readFileSync(t,"utf8").includes("ripplo compile --check"),type:"pre-commit-hook"}:{installed:!1,type:"pre-commit-hook"}}async function Yf(e){let t=await cs(e);return t.valid?{missingFields:[],type:"settings",valid:!0}:{missingFields:t.errors.map(n=>n.path).filter(n=>n.length>0),type:"settings",valid:!1}}function Xf(){let e=ne();return{exists:e!=null&&e.length>0,type:"token"}}function Qf(){let e=Gf.executablePath();return{installed:gn.existsSync(e),type:"browser"}}function Zf(e){if(!e.ok)return{errorCount:1,errors:[{message:e.error,path:""}],found:!1,type:"preconditions-validation",valid:!1};let t=eg(e.result.preconditions,e.result.tests);return{errorCount:t.length,errors:t,found:!0,type:"preconditions-validation",valid:t.length===0}}function eg(e,t){let r=[],n=new Set(Object.keys(e));return Object.entries(e).forEach(([o,i])=>{(i.depends??[]).forEach(s=>{n.has(s)||r.push({message:`Depends on non-existent precondition "${s}"`,path:`preconditions.${o}.depends`})})}),t.forEach(o=>{Object.entries(o.requiresKeys).forEach(([i,s])=>{n.has(s)||r.push({message:`Test "${o.slug}" requires non-existent precondition "${s}" (as ${i})`,path:`tests.${o.slug}.requiresKeys.${i}`})})}),tg(e).forEach(o=>{r.push({message:o,path:"preconditions"})}),r}function tg(e){let t=new Set,r=new Set,n=[];function o(i){if(r.has(i)){n.push(`Precondition "${i}" has a circular dependency`);return}t.has(i)||(t.add(i),r.add(i),(e[i]?.depends??[]).forEach(s=>{o(s)}),r.delete(i))}return Object.keys(e).forEach(i=>{o(i)}),n}function rg(e){if(!e.ok)return{invalidNames:[],invalidWorkflows:[],total:0,type:"workflows",valid:0};let t=e.result.tests.length;return{invalidNames:[],invalidWorkflows:[],total:t,type:"workflows",valid:t}}async function ng(e,t){if(!e.valid||!t.ok)return[];let r;try{let a=Ae();r={appUrl:a.appUrl,engineUrl:a.engineUrl,webhookSecret:a.webhookSecret}}catch{return[]}let n=[],o=await fn(r.appUrl)==null;n.push({appUrl:r.appUrl,reachable:o,type:"dev-server"});let i=await ls(process.cwd());n.push(i);let s=await og(r,t);return n.push(...s),n}async function og(e,t){let r=t.ok?Object.keys(t.result.preconditions).length:0,n=e.engineUrl.length>0,o={configured:n,count:r,endpointReachable:void 0,type:"preconditions"};if(r===0||!n)return[o];let i=ag(e.appUrl,e.engineUrl);if(i==null)return[o];let s=await fn(i)==null,a=[];if(a.push({configured:!0,count:r,endpointReachable:s,type:"preconditions"}),ms(e.engineUrl)&&a.push({reachable:s,type:"engine-endpoint",url:i}),!s)return a;let l=await ds({appUrl:e.appUrl,engineUrl:e.engineUrl});a.push({rejectsUnsigned:l==null,type:"webhook-verification"});let c=await ig({engineUrl:i,webhookSecret:e.webhookSecret});return a.push({status:c,type:"adapter-enabled",url:i}),a}async function ig({engineUrl:e,webhookSecret:t}){if(t.length===0)return"no-secret";let r=JSON.stringify({preconditions:[]});try{let n=await fetch(`${e}/execute-preconditions`,{body:r,headers:{"Content-Type":"application/json",...ke({body:r,secret:t})},method:"PUT",signal:AbortSignal.timeout(5e3)});return n.status===404?"disabled":n.status===401||n.status===403?"bad-secret":"enabled"}catch{return"unreachable"}}function sg(e){switch(e.status){case"enabled":return`\u2713 Adapter: enabled at ${e.url}`;case"disabled":return"\u2717 Adapter: disabled (handler returned 404). Set ENABLE_RIPPLO_TESTING=true in your app's env (e.g. apps/<app>/.env.local for Next.js) and restart the dev server.";case"bad-secret":return"\u2717 Adapter: webhook signature rejected. RIPPLO_WEBHOOK_SECRET seen by your dev server does not match the one in your env file.";case"unreachable":return`\u2717 Adapter: ${e.url} could not be reached for signed probe.`;case"no-secret":return"\u2717 Adapter: RIPPLO_WEBHOOK_SECRET is not set in your env file (declared in .ripplo/project.json)."}}function ms(e){return e.startsWith("http://")||e.startsWith("https://")}function ag(e,t){return ms(t)?t:`${e}${t}`}function fs(e){switch(e.type){case"settings":return dg(e);case"env-files":return ug(e);case"token":return pg(e);case"dev-server":return mg(e);case"dev-session":return as(e);case"preconditions":return yg(e);case"webhook-verification":return fg(e);case"preconditions-validation":return hg(e);case"workflows":return wg(e);case"browser":return gg(e);case"engine-endpoint":return e.reachable?`\u2713 Engine endpoint: ${e.url} is reachable`:`\u2717 Engine endpoint: ${e.url} is not reachable`;case"adapter-enabled":return sg(e);case"lockfile":return lg(e);case"pre-commit-hook":return cg(e)}}function lg(e){switch(e.status){case"match":return`\u2713 Lockfile: ${ce} is up to date`;case"missing":return`\u2717 Lockfile: ${ce} is missing \u2014 run \`ripplo compile\` and commit it`;case"stale":return`\u2717 Lockfile: ${ce} is out of date \u2014 run \`ripplo compile\` and commit it`}}function cg(e){return e.installed?"\u2713 Pre-commit hook: .git/hooks/pre-commit runs `ripplo compile --check`":"! Pre-commit hook: .git/hooks/pre-commit does not run `ripplo compile --check` \u2014 see the setup skill for the snippet"}function dg(e){return e.valid?"\u2713 Settings: Project configured":`\u2717 Settings: Missing fields: ${e.missingFields.join(", ")}`}function ug(e){return e.missing.length===0?"\u2713 Env files: declared files present":`\u2717 Env files: declared in .ripplo/project.json but missing:
|
|
247
247
|
${e.missing.map(r=>` ${r}`).join(`
|
|
248
248
|
`)}
|
|
249
|
-
If you're in a git worktree, copy the env file from the main checkout (or symlink to a shared file outside the working tree).`}function
|
|
249
|
+
If you're in a git worktree, copy the env file from the main checkout (or symlink to a shared file outside the working tree).`}function pg(e){return e.exists?"\u2713 Auth: Token found":"\u2717 Auth: No token found. Run `ripplo` to authenticate."}function mg(e){return e.reachable?`\u2713 Dev server: ${e.appUrl} is reachable`:`\u2717 Dev server: ${e.appUrl} is not responding. Make sure your dev server is running.`}function fg(e){return e.rejectsUnsigned?"\u2713 Webhook verification: Unsigned requests are correctly rejected":"\u2717 Webhook verification: Endpoint accepted an unsigned request \u2014 webhook signature verification may be missing or misconfigured."}function gg(e){return e.installed?"\u2713 Browser: Chromium installed":"\u2717 Browser: Chromium not installed. Run: npx playwright install chromium"}function yg(e){return e.count===0?"! Preconditions: None defined":e.configured?e.endpointReachable===void 0?`! Preconditions: ${String(e.count)} defined (could not verify endpoint)`:`\u2713 Preconditions: ${String(e.count)} defined, endpoint configured`:`\u2717 Preconditions: ${String(e.count)} defined but RIPPLO_ENGINE_URL is not set in your env file`}function hg(e){if(!e.found)return"\u2717 State graph: DSL compilation failed";if(e.valid)return"\u2713 State graph: Valid";let t=e.errors.map(r=>` - ${r.path===""?"":r.path+": "}${r.message}`);return`\u2717 State graph: ${String(e.errorCount)} validation error${e.errorCount===1?"":"s"}
|
|
250
250
|
${t.join(`
|
|
251
|
-
`)}`}function
|
|
251
|
+
`)}`}function wg(e){if(e.total===0)return"! Tests: No tests defined";if(e.invalidNames.length===0)return`\u2713 Tests: ${String(e.total)} valid`;let t=e.invalidWorkflows.map(r=>bg(r));return`\u2717 Tests: ${String(e.invalidNames.length)} invalid
|
|
252
252
|
${t.join(`
|
|
253
|
-
`)}`}function
|
|
253
|
+
`)}`}function bg(e){let t=e.errors.map(r=>" - "+(r.path===""?"":r.path+": ")+r.message);return" "+e.name+`:
|
|
254
254
|
`+t.join(`
|
|
255
|
-
`)}async function
|
|
255
|
+
`)}async function gs(){let e=process.cwd(),t=await ps(e),r=t.map(o=>fs(o));process.stdout.write(r.join(`
|
|
256
256
|
`)+`
|
|
257
|
-
`);let n=t.some(o=>
|
|
257
|
+
`);let n=t.some(o=>us(o));process.exit(n?1:0)}import{graphql as Gt,readFragment as Eg}from"gql.tada";import vg from"crypto";import{graphql as kg}from"gql.tada";import yn from"fs";import hn from"path";function zt(e){try{let t=hn.join(Sg(e),"HEAD"),r=yn.readFileSync(t,"utf8").trim(),n="ref: refs/heads/";return r.startsWith(n)?r.slice(n.length):r.length===0?void 0:r.slice(0,7)}catch{return}}function Sg(e){let t=hn.join(e,".git");if(yn.statSync(t).isDirectory())return t;let n=yn.readFileSync(t,"utf8").trim(),o="gitdir:";if(!n.startsWith(o))throw new Error(`unrecognized .git file at ${t}`);let i=n.slice(o.length).trim();if(i.length===0)throw new Error(`empty gitdir pointer at ${t}`);return hn.resolve(e,i)}var Rg=kg(`
|
|
258
258
|
mutation SyncDevSession(
|
|
259
259
|
$projectId: String!
|
|
260
260
|
$cwd: String!
|
|
@@ -272,12 +272,12 @@ ${t.join(`
|
|
|
272
272
|
id
|
|
273
273
|
}
|
|
274
274
|
}
|
|
275
|
-
`);async function at(e){let t=
|
|
275
|
+
`);async function at(e){let t=xg(e.compiled);return Cg({config:e.config,cwd:e.cwd,payload:t})}async function Te(e,t){let r=await j(e);if(!r.ok)throw new Error(`DSL compilation failed: ${r.error}`);let n=await at({compiled:r.result,config:t,cwd:e});return{compiled:r.result,devSessionId:n.devSessionId}}function xg(e){return{preconditions:Object.entries(e.preconditions).map(([t,r])=>({depends:[...r.depends??[]],description:r.description,name:t,returns:[...r.returns??[]]})),workflows:e.tests.map(t=>({expectedOutcome:t.expectedOutcome,name:t.name,preconditions:[...t.preconditions],requiresKeys:Object.entries(t.requiresKeys).map(([r,n])=>({namespace:r,preconditionName:n})),slug:t.slug,spec:t.implemented?JSON.stringify(t.spec):null}))}}function Pg(e){return vg.createHash("sha256").update(JSON.stringify(e)).digest("hex")}async function Cg({config:e,cwd:t,payload:r}){let n=Pg(r),o=zt(t),i=await S({config:e,document:Rg,variables:{branch:o??null,cwd:t,preconditions:r.preconditions.map(s=>({depends:[...s.depends],description:s.description,name:s.name,returns:[...s.returns]})),projectId:e.projectId,workflows:r.workflows.map(s=>({expectedOutcome:s.expectedOutcome,name:s.name,preconditions:[...s.preconditions],requiresKeys:s.requiresKeys.map(a=>({namespace:a.namespace,preconditionName:a.preconditionName})),slug:s.slug,spec:s.spec??null}))}});if(i.syncDevSession==null)throw new Error("syncDevSession returned null");return{devSessionId:i.syncDevSession.id,hash:n}}import ys from"figures";var lt={cross:ys.cross,tick:ys.tick};var ws=Gt(`
|
|
276
276
|
fragment WorkflowIdMCP on Workflow {
|
|
277
277
|
id
|
|
278
278
|
slug
|
|
279
279
|
}
|
|
280
|
-
`),
|
|
280
|
+
`),Tg=Gt(`
|
|
281
281
|
query ProjectWorkflowIdsMCP($projectId: String!, $cwd: String!) {
|
|
282
282
|
project(id: $projectId) {
|
|
283
283
|
id
|
|
@@ -289,14 +289,14 @@ ${t.join(`
|
|
|
289
289
|
}
|
|
290
290
|
}
|
|
291
291
|
}
|
|
292
|
-
`,[
|
|
292
|
+
`,[ws]),$g=Gt(`
|
|
293
293
|
mutation CreateRunMCP($workflowId: String!, $platforms: [String!]!, $concurrency: Int!) {
|
|
294
294
|
createRun(workflowId: $workflowId, platforms: $platforms, concurrency: $concurrency) {
|
|
295
295
|
id
|
|
296
296
|
status
|
|
297
297
|
}
|
|
298
298
|
}
|
|
299
|
-
`),
|
|
299
|
+
`),Ag=Gt(`
|
|
300
300
|
query RunStatusMCP($id: String!) {
|
|
301
301
|
run(id: $id) {
|
|
302
302
|
id
|
|
@@ -323,8 +323,8 @@ ${t.join(`
|
|
|
323
323
|
}
|
|
324
324
|
}
|
|
325
325
|
}
|
|
326
|
-
`);async function
|
|
327
|
-
${x("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await
|
|
326
|
+
`);async function Kt({config:e,ids:t}){let r=await Ig({config:e,ids:t}),n=await Promise.all(r.map(async s=>{try{let a=await Lg({config:e,workflowId:s.workflowId});return{entry:s,ok:!0,runId:a}}catch(a){let l=a instanceof Error?a.message:String(a);return{entry:s,message:l,ok:!1}}})),o=await Promise.all(n.map(async s=>{if(!s.ok)return{id:s.entry.id,runId:"",summary:`ERROR creating run: ${s.message}
|
|
327
|
+
${x("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await Ug({config:e,runId:l}),d=Dg({config:e,id:a.id,runId:l}),u=`.ripplo/debug/${l}/`;return{id:a.id,runId:l,summary:`View run: ${d}
|
|
328
328
|
Debug artifacts: ${u}
|
|
329
329
|
${x("debug","read summary.txt, accessibility-tree, network.jsonl before guessing")}
|
|
330
330
|
|
|
@@ -334,10 +334,10 @@ ${s.summary}`).join(`
|
|
|
334
334
|
|
|
335
335
|
---
|
|
336
336
|
|
|
337
|
-
`);return{results:o,summary:i}}async function
|
|
337
|
+
`);return{results:o,summary:i}}async function Ig({config:e,ids:t}){let r=await Te(e.cwd,e),n=await S({config:e,document:Tg,variables:{cwd:e.cwd,projectId:e.projectId}});if(n.project==null)throw new Error("Project not found");if(n.project.devSession==null)throw new Error("No active dev session. Start one by running `ripplo` (or `npx ripplo`) in your terminal, then try again.");let o=(n.project.workflows??[]).map(s=>Eg(ws,s));if(t.length===0)return o.map(s=>({id:s.slug,workflowId:s.id}));let i=r.compiled.tests.map(s=>s.slug);return t.map(s=>{let a=o.find(l=>l.slug===s);if(a==null)throw new Error(jg({compiledSlugs:i,slug:s}));return{id:s,workflowId:a.id}})}function jg({compiledSlugs:e,slug:t}){if(e.includes(t))return`Test "${t}" was synced from .ripplo/ but the server didn't return it. This is likely a server-state bug \u2014 check the server logs for the SyncDevSession mutation.`;let r=Ng({compiledSlugs:e,limit:3,slug:t}),n=r.length>0?`
|
|
338
338
|
Did you mean: ${r.join(", ")}?`:"";return`Test "${t}" is not registered in this dev session.${n}
|
|
339
|
-
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function
|
|
340
|
-
`)}function
|
|
339
|
+
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function Ng({compiledSlugs:e,limit:t,slug:r}){let n=new Set(r.split("-"));return e.map(i=>({candidate:i,score:Og(n,i)})).filter(i=>i.score>0).toSorted((i,s)=>s.score-i.score).slice(0,t).map(i=>i.candidate)}function Og(e,t){return t.split("-").filter(r=>e.has(r)).length}function Dg({config:e,id:t,runId:r}){let n=e.ripploServerUrl.replace(/:3000\b/,":3001"),o=new URL(n.endsWith("/")?n:`${n}/`);return new URL(`projects/${e.projectId}/workflows/${t}/runs/${r}`,o).toString()}async function Lg({config:e,workflowId:t}){let r=await S({config:e,document:$g,variables:{concurrency:1,platforms:["chromium"],workflowId:t}});if(r.createRun==null)throw new Error("Failed to create run");return r.createRun.id}var _g=2e3,hs=150;async function Ug({config:e,runId:t}){let r=0;for(;r<hs;){await Fg(_g),r+=1;let o=(await S({config:e,document:Ag,variables:{id:t}})).run;if(o==null)throw new Error(`Run ${t} not found`);if(!(o.status==="pending"||o.status==="running"))return Vg({results:o.results??[],runId:t,status:o.status})}return`Run ${t} timed out after polling ${String(hs)} times.`}function Vg({results:e,runId:t,status:r}){let n=[`Run ${t}: ${r.toUpperCase()}`];return e.forEach(o=>{n.push(` ${o.status}: ${String(o.passCount)} passed, ${String(o.failCount)} failed (${String(o.duration??0)}ms)`),o.summary!=null&&n.push(` Summary: ${o.summary}`),o.traceEntries.forEach(i=>{let s=i.status==="passed"?lt.tick:lt.cross,a=i.detail==null?"":` \u2014 ${i.detail}`;n.push(` ${s} ${i.title} (${String(i.duration)}ms)${a}`),i.assertions.forEach(l=>{let c=l.status==="passed"?lt.tick:lt.cross,d=l.detail==null?"":` \u2014 ${l.detail}`;n.push(` ${c} ${l.description}${d}`)})})}),n.join(`
|
|
340
|
+
`)}function Fg(e){return new Promise(t=>{setTimeout(t,e)})}import{graphql as Mg}from"gql.tada";var Hg=Mg(`
|
|
341
341
|
query DevSessionCheckPreflight($projectId: String!, $cwd: String!) {
|
|
342
342
|
project(id: $projectId) {
|
|
343
343
|
id
|
|
@@ -348,34 +348,34 @@ Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on
|
|
|
348
348
|
}
|
|
349
349
|
`);function ye(){try{return W(process.cwd())}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`${t}
|
|
350
350
|
`),process.stderr.write(`${x("setup")}
|
|
351
|
-
`),process.exit(1)}}async function he(e){(await S({config:e,document:
|
|
352
|
-
`),process.exit(1))}async function
|
|
353
|
-
`);let n=await Promise.allSettled(Array.from({length:t},()=>
|
|
351
|
+
`),process.exit(1)}}async function he(e){(await S({config:e,document:Hg,variables:{cwd:e.cwd,projectId:e.projectId}})).project?.devSession==null&&(process.stderr.write("No active dev session. Start `npx ripplo watch` as a background process (your app's dev server must also be running), then retry. Or run `/ripplo:start` in Claude Code.\n"),process.stderr.write(`${x("setup")}
|
|
352
|
+
`),process.exit(1))}async function bs({id:e,runs:t}){let r=ye();await he(r),process.stdout.write(`flake-detect "${e}" x${String(t)}...
|
|
353
|
+
`);let n=await Promise.allSettled(Array.from({length:t},()=>Kt({config:r,ids:[e]}))),o=0,i=0,s=new Map;n.forEach(l=>{if(l.status==="rejected"){i++;let d=l.reason instanceof Error?l.reason.message:"unknown error";s.set(d,(s.get(d)??0)+1);return}let c=l.value.results[0];if(c==null){i++;return}if(c.summary.includes("FAILED")||c.summary.includes("ERROR")){i++;let d=c.summary.split(`
|
|
354
354
|
`).find(u=>u.includes("FAILED")||u.includes("ERROR"))??"unknown failure";s.set(d,(s.get(d)??0)+1)}else o++});let a=t>0?i/t*100:0;process.stdout.write(`${String(o)} passed / ${String(i)} failed (${a.toFixed(1)}% flake)
|
|
355
355
|
`),s.size>0&&s.forEach((l,c)=>{process.stdout.write(` ${String(l)}x: ${c}
|
|
356
356
|
`)}),i>0&&process.stderr.write(`${x("flake-detect","parallel safety + race conditions")}
|
|
357
|
-
`),process.exit(i>0?1:0)}import
|
|
357
|
+
`),process.exit(i>0?1:0)}import Jt from"fs";import{graphql as qg}from"gql.tada";import Wg from"fs";function pe(e){return rt(e,"hooks-paused")}function M(e){return Wg.existsSync(pe(e))?!1:Me(e)}var Bg=qg(`
|
|
358
358
|
mutation CliSetHooksPaused($projectId: String!, $paused: Boolean!) {
|
|
359
359
|
setHooksPaused(projectId: $projectId, paused: $paused)
|
|
360
360
|
}
|
|
361
|
-
`);async function
|
|
362
|
-
`);return}
|
|
363
|
-
`)}async function
|
|
364
|
-
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function
|
|
361
|
+
`);async function Ss(){process.stdin.isTTY||(process.stderr.write("`ripplo hooks pause` must be invoked interactively from a terminal \u2014 refusing non-TTY invocation. Bypassing the gate is a human decision, not an agent decision.\n"),process.exit(1));let e=process.cwd();tt(e);let t=pe(e);if(Jt.existsSync(t)){process.stdout.write("Hooks already paused. Run `ripplo hooks resume` to re-enable.\n");return}Jt.writeFileSync(t,""),await ks(e,!0),process.stdout.write("Hooks paused. Pre-edit gates and stop enforcement are off until you run `ripplo hooks resume`.\n")}async function vs(){let e=process.cwd(),t=pe(e);if(!Jt.existsSync(t)){process.stdout.write(`Hooks already active.
|
|
362
|
+
`);return}Jt.unlinkSync(t),await ks(e,!1),process.stdout.write(`Hooks resumed.
|
|
363
|
+
`)}async function ks(e,t){let r;try{r=W(e)}catch{return}await S({config:r,document:Bg,variables:{paused:t,projectId:r.projectId}}).catch(()=>null)}import He from"fs";import We from"path";import{input as Ps,select as Cs}from"@inquirer/prompts";import{graphql as uy}from"gql.tada";import{exec as zg}from"child_process";import H from"fs";import q from"path";import{promisify as Gg}from"util";var Kg=["@ripplo/testing"],Rs=".ripplo/ripplo.lock linguist-generated=true",Jg=[".ripplo/debug/",".ripplo/.local/"],Yg=Gg(zg);async function xs({cwd:e,onStep:t}){t("Scaffolding project files..."),oy({cwd:e}),t("Updating .gitignore..."),iy(e),t("Marking ripplo.lock as generated..."),Zg(e),t("Installing dependencies...");let r=await Xg(e),n=[];if(r.ok||n.push({manualCommand:r.cmd,message:`Couldn't auto-install dev dependencies (${r.reason}). Run the command below, then run \`ripplo lint\` to compile the lockfile.`}),r.ok){t("Compiling initial lockfile...");let o=await Qg(e);o!=null&&n.push({manualCommand:void 0,message:o})}return t("Setting up browser..."),await Cr(),n}async function Xg(e){let t=ey({cwd:e,pm:ny(e)});g.info("Installing dependencies: %s",t);try{return await Yg(t,{cwd:e}),{ok:!0}}catch(r){let n=r instanceof Error?r.message.split(`
|
|
364
|
+
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function Qg(e){try{let t=await j(e);if(!t.ok)return;await de({cwd:e,result:t.result});return}catch(t){return`Couldn't compile initial lockfile: ${t instanceof Error?t.message:String(t)}.`}}function Zg(e){let t=q.join(e,".gitattributes"),r=H.existsSync(t)?H.readFileSync(t,"utf8"):"";if(r.includes(Rs))return;let n=r.length===0||r.endsWith(`
|
|
365
365
|
`)?"":`
|
|
366
|
-
`;H.writeFileSync(t,`${r}${n}${
|
|
367
|
-
`)}function
|
|
366
|
+
`;H.writeFileSync(t,`${r}${n}${Rs}
|
|
367
|
+
`)}function ey({cwd:e,pm:t}){let r=Kg.join(" ");return t==="pnpm"?ty(e)?`pnpm add -wD ${r}`:`pnpm add -D ${r}`:t==="yarn"?ry(e)?`yarn add -WD ${r}`:`yarn add -D ${r}`:t==="bun"?`bun add -d ${r}`:`npm install -D ${r}`}function ty(e){return H.existsSync(q.join(e,"pnpm-workspace.yaml"))||H.existsSync(q.join(e,"pnpm-workspace.yml"))}function ry(e){let t=q.join(e,"package.json");if(!H.existsSync(t))return!1;try{let r=JSON.parse(H.readFileSync(t,"utf8"));if(r==null||typeof r!="object"||!("workspaces"in r))return!1;let n=r.workspaces;return Array.isArray(n)||n!=null&&typeof n=="object"}catch{return!1}}function ny(e){return H.existsSync(q.join(e,"pnpm-lock.yaml"))?"pnpm":H.existsSync(q.join(e,"yarn.lock"))?"yarn":H.existsSync(q.join(e,"bun.lockb"))||H.existsSync(q.join(e,"bun.lock"))?"bun":"npm"}function oy({cwd:e}){let t=q.join(e,".ripplo"),r=q.join(t,"tests"),n=q.join(t,"preconditions"),o=q.join(t,"observers");H.mkdirSync(r,{recursive:!0}),H.mkdirSync(n,{recursive:!0}),H.mkdirSync(o,{recursive:!0}),ct(q.join(t,"index.ts"),sy),ct(q.join(n,"index.ts"),ay),ct(q.join(o,"index.ts"),ly),ct(q.join(r,"index.ts"),cy),ct(q.join(t,"tsconfig.json"),dy)}function ct(e,t){H.existsSync(e)||H.writeFileSync(e,t)}function iy(e){let t=q.join(e,".gitignore");if(!H.existsSync(t))return;let r=H.readFileSync(t,"utf8"),n=Jg.filter(i=>!r.includes(i));if(n.length===0)return;let o=r.endsWith(`
|
|
368
368
|
`)?"":`
|
|
369
369
|
`;H.writeFileSync(t,r+o+n.join(`
|
|
370
370
|
`)+`
|
|
371
|
-
`)}var
|
|
371
|
+
`)}var sy=`import { createRipplo } from "@ripplo/testing";
|
|
372
372
|
import { preconditions } from "./preconditions/index.js";
|
|
373
373
|
import { observers } from "./observers/index.js";
|
|
374
374
|
import { tests } from "./tests/index.js";
|
|
375
375
|
|
|
376
376
|
export { preconditions, observers, tests };
|
|
377
377
|
export default createRipplo({ preconditions, observers, tests });
|
|
378
|
-
`,
|
|
378
|
+
`,ay=`// Declare preconditions with \`precondition(name)\` from @ripplo/testing and collect them
|
|
379
379
|
// in the \`preconditions\` registry below. Every handle in this registry must be implemented
|
|
380
380
|
// in your app server's \`createEngine(ripplo, { preconditions: {...}, observers: {...} })\` call.
|
|
381
381
|
//
|
|
@@ -389,7 +389,7 @@ export default createRipplo({ preconditions, observers, tests });
|
|
|
389
389
|
// export const preconditions = { authLoggedIn };
|
|
390
390
|
|
|
391
391
|
export const preconditions = {};
|
|
392
|
-
`,
|
|
392
|
+
`,ly=`// Declare observers with \`observer(name)\` from @ripplo/testing and collect them in
|
|
393
393
|
// the \`observers\` registry below. Use them in tests via \`assert.backend(handle, params)\`.
|
|
394
394
|
//
|
|
395
395
|
// Example:
|
|
@@ -402,7 +402,7 @@ export const preconditions = {};
|
|
|
402
402
|
// export const observers = { orgNameIs };
|
|
403
403
|
|
|
404
404
|
export const observers = {};
|
|
405
|
-
`,
|
|
405
|
+
`,cy=`// Each test file under ./tests exports a TestDefinition. Import them here and add them
|
|
406
406
|
// to the \`tests\` array \u2014 that's what \`createRipplo({ ..., tests })\` receives.
|
|
407
407
|
//
|
|
408
408
|
// Example:
|
|
@@ -410,7 +410,7 @@ export const observers = {};
|
|
|
410
410
|
// export const tests = [myTest] as const;
|
|
411
411
|
|
|
412
412
|
export const tests = [] as const;
|
|
413
|
-
`,
|
|
413
|
+
`,dy=`{
|
|
414
414
|
"compilerOptions": {
|
|
415
415
|
"strict": true,
|
|
416
416
|
"noUncheckedIndexedAccess": true,
|
|
@@ -426,60 +426,60 @@ export const tests = [] as const;
|
|
|
426
426
|
"include": ["*.ts", "coverage.d.ts", "observers/**/*.ts", "preconditions/**/*.ts", "tests/**/*.ts"],
|
|
427
427
|
"exclude": ["node_modules"]
|
|
428
428
|
}
|
|
429
|
-
`;var
|
|
429
|
+
`;var py=uy(`
|
|
430
430
|
query InitProjects {
|
|
431
431
|
projects {
|
|
432
432
|
id
|
|
433
433
|
name
|
|
434
434
|
}
|
|
435
435
|
}
|
|
436
|
-
`),
|
|
437
|
-
`),process.exit(1));let o=await
|
|
436
|
+
`),wn=["../.env.local","../.env"];async function Es(e=gy()){let t=process.cwd(),r=ne();r==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let n=fe();my(t)&&(process.stdout.write(`\`.ripplo/index.ts\` already exists at ${t}. Delete it first if you want to re-init.
|
|
437
|
+
`),process.exit(1));let o=await fy({serverUrl:n,token:r});o.length===0&&(process.stdout.write("No projects found. Create one in the dashboard first, then re-run `ripplo init`.\n"),process.exit(1));let i=await hy(o,e.projectId),s=await wy(t,e.envFile),a=await by(e.appUrl),l=yy(a,e.engineUrl),c=We.resolve(We.join(t,".ripplo"),s);Cn({cwd:t,envFiles:[s],projectId:i}),ky({appUrl:a,engineUrl:l,filePath:c});let d=await xs({cwd:t,onStep:u=>{process.stdout.write(` ${u}
|
|
438
438
|
`)}});if(d.length>0){process.stdout.write(`Done with warnings:
|
|
439
439
|
`),d.forEach(u=>{process.stdout.write(` - ${u.message}
|
|
440
440
|
`),u.manualCommand!=null&&process.stdout.write(` run: ${u.manualCommand}
|
|
441
|
-
`)});return}process.stdout.write("Ready. Start `npx ripplo watch` as a background process (or run `/ripplo:start` in Claude Code), then write tests in `.ripplo/tests/`.\n")}function
|
|
442
|
-
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function
|
|
441
|
+
`)});return}process.stdout.write("Ready. Start `npx ripplo watch` as a background process (or run `/ripplo:start` in Claude Code), then write tests in `.ripplo/tests/`.\n")}function my(e){return He.existsSync(We.join(e,".ripplo","index.ts"))}async function fy({serverUrl:e,token:t}){return((await S({config:De({serverUrl:e,token:t}),document:py,variables:void 0})).projects??[]).map(n=>({id:n.id,name:n.name}))}function gy(){return{appUrl:void 0,engineUrl:void 0,envFile:void 0,projectId:void 0}}function yy(e,t){if(t!=null){try{new URL(t)}catch{process.stdout.write(`--engine-url is not a valid URL: ${t}
|
|
442
|
+
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function hy(e,t){if(t!=null){let r=e.find(n=>n.id===t);return r==null&&(process.stdout.write(`Unknown project id: ${t}
|
|
443
443
|
`),process.exit(1)),process.stdout.write(`Using project: ${r.name} (${r.id})
|
|
444
444
|
`),r.id}if(e.length===1){let r=e[0];if(r==null)throw new Error("unreachable");return process.stdout.write(`Using project: ${r.name} (${r.id})
|
|
445
|
-
`),r.id}return
|
|
446
|
-
`),process.exit(1)),t):
|
|
447
|
-
`),process.exit(1)}return e}return
|
|
445
|
+
`),r.id}return Cs({choices:e.map(r=>({name:r.name,value:r.id})),message:"Select a project"})}async function wy(e,t){return t!=null?(t.trim().length===0&&(process.stdout.write(`--env must not be empty
|
|
446
|
+
`),process.exit(1)),t):Sy(e)}async function by(e){if(e!=null){try{new URL(e)}catch{process.stdout.write(`--app-url is not a valid URL: ${e}
|
|
447
|
+
`),process.exit(1)}return e}return vy()}async function Sy(e){let t=We.join(e,".ripplo"),r=wn.find(o=>He.existsSync(We.resolve(t,o))),n=await Cs({choices:[...wn.map(o=>({name:r===o?`${o} (detected)`:o,value:o})),{name:"custom path",value:"__custom__"}],default:r??wn[0],message:"Which env file should ripplo write RIPPLO_APP_URL, RIPPLO_ENGINE_URL, and RIPPLO_WEBHOOK_SECRET to?"});return n!=="__custom__"?n:Ps({message:"Path to env file (relative to .ripplo/, e.g. ../apps/server/.env)",validate:o=>o.trim().length>0?!0:"required"})}async function vy(){return Ps({default:"http://localhost:3000",message:"Where does your dev server run? (RIPPLO_APP_URL)",validate:e=>{try{return new URL(e),!0}catch{return"must be a valid URL"}}})}function ky({appUrl:e,engineUrl:t,filePath:r}){He.mkdirSync(We.dirname(r),{recursive:!0});let n=He.existsSync(r)?He.readFileSync(r,"utf8"):"",o=[];if(/^RIPPLO_APP_URL=/m.test(n)||o.push(`RIPPLO_APP_URL=${e}`),/^RIPPLO_ENGINE_URL=/m.test(n)||o.push(`RIPPLO_ENGINE_URL=${t}`),/^RIPPLO_WEBHOOK_SECRET=/m.test(n)||o.push(`RIPPLO_WEBHOOK_SECRET=${zr()}`),o.length===0)return;let i=n.length===0||n.endsWith(`
|
|
448
448
|
`)?"":`
|
|
449
|
-
`;
|
|
449
|
+
`;He.writeFileSync(r,`${n}${i}${o.join(`
|
|
450
450
|
`)}
|
|
451
|
-
`)}import
|
|
451
|
+
`)}import bn from"fs";import Ts from"path";import*as $s from"remeda";async function As(e){let{ids:t,requireImplemented:r}=e,n=process.cwd(),o=await j(n);o.ok||(process.stderr.write(`Compilation failed: ${o.error}
|
|
452
452
|
`),process.stderr.write(`${x("create","DSL authoring + lint rules")}
|
|
453
|
-
`),process.exit(1)),await de({cwd:n,result:o.result});let i=
|
|
453
|
+
`),process.exit(1)),await de({cwd:n,result:o.result});let i=_e(o.result),s=t.length===0?i.diagnostics:i.diagnostics.filter(w=>t.includes(w.test)),a=$s.groupBy(s,w=>w.test);Object.entries(a).forEach(([w,h])=>{process.stderr.write(`
|
|
454
454
|
${w}
|
|
455
455
|
`),h.forEach(v=>{let E=v.step==null?"":` at "${v.step}"`;process.stderr.write(` [${v.rule}]${E}
|
|
456
456
|
`),process.stderr.write(` ${v.message}
|
|
457
457
|
`)})});let l=new Set(o.builder.getUnimplemented().tests),c=r.filter(w=>l.has(w));c.length>0&&(process.stderr.write(`
|
|
458
458
|
not-implemented
|
|
459
459
|
`),c.forEach(w=>{process.stderr.write(` ${w} is still marked .notImplemented()
|
|
460
|
-
`)}));let d=
|
|
460
|
+
`)}));let d=Cy(n);d.length>0&&(process.stderr.write(`
|
|
461
461
|
preconditions
|
|
462
462
|
`),d.forEach(w=>{process.stderr.write(` [hardcoded-identifier] ${w.file}
|
|
463
463
|
`),process.stderr.write(` ${w.message}
|
|
464
464
|
`)}));let u=s.length+c.length+d.length;u>0&&(process.stderr.write(`
|
|
465
465
|
${String(u)} error(s)
|
|
466
|
-
`),
|
|
467
|
-
`)}function
|
|
468
|
-
`))}var
|
|
466
|
+
`),Ry({diagnostics:s,hardcodeWarnings:d,stillStubbed:c}),process.exit(1));let f=o.result.tests.length,b=t.length===0?"all tests":`${String(t.length)} test(s)`;process.stdout.write(`\u2713 ripplo lint: ${b} passed (${String(f)} compiled, lockfile written)
|
|
467
|
+
`)}function Ry({diagnostics:e,hardcodeWarnings:t,stillStubbed:r}){let n=new Set;(e.length>0||r.length>0)&&n.add("create"),t.length>0&&n.add("explore"),n.forEach(o=>process.stderr.write(`${x(o)}
|
|
468
|
+
`))}var xy=/['"`][\w.+-]+@[\w.-]+\.[a-z]{2,}['"`]/i,Py=/['"`][0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}['"`]/i;function Cy(e){let t=Ts.join(e,".ripplo","preconditions");return bn.existsSync(t)?bn.readdirSync(t).filter(n=>n.endsWith(".ts")).flatMap(n=>Ey(Ts.join(t,n))):[]}function Ey(e){let t=bn.readFileSync(e,"utf8"),r=t.includes("ctx.uniqueEmail")||t.includes("ctx.uniqueId"),n=[],o=xy.exec(t);o!=null&&!r&&n.push({file:e,message:`hardcoded email literal ${o[0]} \u2014 use ctx.uniqueEmail() so parallel runs don't collide`});let i=Py.exec(t);return i!=null&&!r&&n.push({file:e,message:`hardcoded UUID-like literal ${i[0]} \u2014 use ctx.uniqueId() so parallel runs don't collide`}),n}import{graphql as Ty}from"gql.tada";var $y=Ty(`
|
|
469
469
|
query ProjectsList {
|
|
470
470
|
projects {
|
|
471
471
|
id
|
|
472
472
|
name
|
|
473
473
|
}
|
|
474
474
|
}
|
|
475
|
-
`);async function
|
|
476
|
-
`)}async function
|
|
475
|
+
`);async function Is(){let e=ne();e==null&&(process.stderr.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let t=fe(),n=((await S({config:De({serverUrl:t,token:e}),document:$y,variables:void 0})).projects??[]).map(o=>({id:o.id,name:o.name}));process.stdout.write(`${JSON.stringify({projects:n},null,2)}
|
|
476
|
+
`)}async function js(e){let t=ye();await he(t);let{results:r,summary:n}=await Kt({config:t,ids:e});process.stdout.write(`${n}
|
|
477
477
|
`);let o=r.some(i=>i.summary.includes("FAILED")||i.summary.includes("ERROR"));o&&(process.stderr.write(`Artifacts in .ripplo/debug/<runId>/ \u2014 read before re-running.
|
|
478
478
|
`),process.stderr.write(`${x("debug")}
|
|
479
|
-
`)),process.exit(o?1:0)}async function
|
|
479
|
+
`)),process.exit(o?1:0)}async function Ns(){let e=process.cwd(),t=W(e);try{let r=await Te(t.cwd,t),n=r.compiled.tests.length,o=Object.keys(r.compiled.preconditions).length;process.stdout.write(`synced ${String(n)} tests, ${String(o)} preconditions to dev session ${r.devSessionId}
|
|
480
480
|
`)}catch(r){let n=r instanceof Error?r.message:String(r);process.stderr.write(`ripplo sync failed: ${n}
|
|
481
481
|
`),process.stderr.write(`${x("setup","verify auth + server reachability")}
|
|
482
|
-
`),process.exit(1)}}import
|
|
482
|
+
`),process.exit(1)}}import vn from"fs";import{createClient as Ly}from"graphql-sse";import{graphql as Yt}from"gql.tada";import{print as Ds}from"graphql";import{availableParallelism as Ay}from"os";import Iy from"p-limit";var jy=Math.min(10,Ay()/2),Ny=Iy(jy),Sn=new Set;async function Os(e){if(!Sn.has(e.runId)){Sn.add(e.runId);try{await Ny(()=>Oy(e))}finally{Sn.delete(e.runId)}}}async function Oy({agentProfileDescription:e,agentProfileId:t,config:r,cwd:n,runId:o,workflowId:i,workflowSlug:s}){let a=await Ce({headed:!1});try{await Or({maxRuns:100});let l=n!=null&&s!=null?await Dy({cwd:n,workflowSlug:s}):void 0;await Zr({agentProfileDescription:e,agentProfileId:t,baseUrl:r.appUrl,browser:a,config:r,headed:!1,preconditionNames:l,runId:o,webhookSecret:r.webhookSecret,workflowId:i})}catch(l){g.error(l,"Runner error")}finally{await a.close()}}async function Dy({cwd:e,workflowSlug:t}){let r=await j(e);if(!r.ok)return;let n=r.result.tests.find(o=>o.slug===t);if(n!=null)return n.preconditions}var _y=15e3,Uy=Yt(`
|
|
483
483
|
subscription RunRequestedWatch($devSessionId: String!) {
|
|
484
484
|
runRequested(devSessionId: $devSessionId) {
|
|
485
485
|
agentProfileDescription
|
|
@@ -489,30 +489,30 @@ ${String(u)} error(s)
|
|
|
489
489
|
workflowSlug
|
|
490
490
|
}
|
|
491
491
|
}
|
|
492
|
-
`),
|
|
492
|
+
`),Vy=Yt(`
|
|
493
493
|
subscription HooksPausedWatch($projectId: String!) {
|
|
494
494
|
hooksPausedRequested(projectId: $projectId) {
|
|
495
495
|
paused
|
|
496
496
|
projectId
|
|
497
497
|
}
|
|
498
498
|
}
|
|
499
|
-
`),
|
|
499
|
+
`),Fy=Yt(`
|
|
500
500
|
mutation HeartbeatDevSessionWatch($id: String!) {
|
|
501
501
|
heartbeatDevSession(id: $id) {
|
|
502
502
|
id
|
|
503
503
|
}
|
|
504
504
|
}
|
|
505
|
-
`),
|
|
505
|
+
`),My=Yt(`
|
|
506
506
|
mutation EndDevSessionWatch($projectId: String!, $cwd: String!) {
|
|
507
507
|
endDevSession(projectId: $projectId, cwd: $cwd) {
|
|
508
508
|
id
|
|
509
509
|
}
|
|
510
510
|
}
|
|
511
|
-
`);async function
|
|
512
|
-
`),process.exit(1));let n=await
|
|
513
|
-
`);let d=async()=>{c(),a(),l(),await Promise.race([S({config:e,document:
|
|
514
|
-
`),
|
|
515
|
-
`),process.exit(1)}}var
|
|
511
|
+
`);async function Ls(){Qy();let e=By(process.cwd()),t=e.cwd,r=await j(t);r.ok||(process.stderr.write(`ripplo: DSL compilation failed: ${r.error}
|
|
512
|
+
`),process.exit(1));let n=await Ky(()=>at({compiled:r.result,config:e,cwd:t})),o=zt(t);o!=null&&g.info("watching branch %s in %s",o,t);let i=ss(t),s=Ly({headers:{Authorization:`Bearer ${e.token}`},retryAttempts:1/0,url:`${e.ripploServerUrl}/graphql`}),a=Hy({config:e,cwd:t,devSessionId:n.devSessionId,sseClient:s}),l=Wy({cwd:t,projectId:e.projectId,sseClient:s}),c=qy({config:e,devSessionId:n.devSessionId});process.stdout.write(`ripplo watch: ready as local executor for session ${n.devSessionId} (sync happens on each \`ripplo run\`; Ctrl-C to stop)
|
|
513
|
+
`);let d=async()=>{c(),a(),l(),await Promise.race([S({config:e,document:My,variables:{cwd:e.cwd,projectId:e.projectId}}).catch(()=>{}),new Promise(f=>setTimeout(f,3e3))]),i()},u=()=>{d().finally(()=>process.exit(0))};process.on("SIGINT",u),process.on("SIGTERM",u),process.on("SIGHUP",u),process.on("SIGBREAK",u),await new Promise(()=>{})}function Hy({config:e,cwd:t,devSessionId:r,sseClient:n}){return n.subscribe({query:Ds(Uy),variables:{devSessionId:r}},{complete:()=>{},error:o=>{g.error(o,"runRequested subscription error")},next:o=>{let i=o.data?.runRequested;i!=null&&(process.stdout.write(`ripplo: run ${i.runId} (${i.workflowSlug})
|
|
514
|
+
`),Os({agentProfileDescription:i.agentProfileDescription??void 0,agentProfileId:i.agentProfileId??void 0,config:e,cwd:t,runId:i.runId,workflowId:i.workflowId,workflowSlug:i.workflowSlug}).catch(s=>{g.error({err:s,runId:i.runId,workflowSlug:i.workflowSlug},"run execution failed; watch continuing")}))}})}function Wy({cwd:e,projectId:t,sseClient:r}){return r.subscribe({query:Ds(Vy),variables:{projectId:t}},{complete:()=>{},error:n=>{g.error(n,"hooksPaused subscription error")},next:n=>{let o=n.data?.hooksPausedRequested?.paused;if(o===!0){vn.writeFileSync(pe(e),"");return}o===!1&&vn.existsSync(pe(e))&&vn.unlinkSync(pe(e))}})}function qy({config:e,devSessionId:t}){let r=setInterval(()=>{S({config:e,document:Fy,variables:{id:t}}).catch(n=>{g.warn("heartbeat failed: %s",n instanceof Error?n.message:String(n))})},_y);return()=>{clearInterval(r)}}function By(e){try{return W(e)}catch(t){let r=t instanceof Error?t.message:String(t);process.stderr.write(`${r}
|
|
515
|
+
`),process.exit(1)}}var zy=1e3,Gy=6e4;async function Ky(e){let t=Date.now()+Gy,r;for(;Date.now()<t;){let n=await Jy(e);if(n.ok)return n.value;if(!Yy(n.message))throw n.error;r=n.error,await Xy(zy)}throw r instanceof Error?r:new Error("server never became ready")}async function Jy(e){try{return{ok:!0,value:await e()}}catch(t){let r=t instanceof Error?t.message:String(t);return{error:t,message:r,ok:!1}}}function Yy(e){return e.includes("status 502")||e.includes("ECONNREFUSED")||e.includes("Failed to connect")||e.includes("fetch failed")}function Xy(e){return new Promise(t=>setTimeout(t,e))}function Qy(){process.on("unhandledRejection",e=>{g.error({err:e},"unhandledRejection in watch; continuing")}),process.on("uncaughtException",e=>{g.error({err:e},"uncaughtException in watch; continuing")})}import{graphql as dt}from"gql.tada";var Zy=dt(`
|
|
516
516
|
query ScopeStatus($projectId: String!, $cwd: String!) {
|
|
517
517
|
project(id: $projectId) {
|
|
518
518
|
id
|
|
@@ -532,7 +532,7 @@ ${String(u)} error(s)
|
|
|
532
532
|
}
|
|
533
533
|
}
|
|
534
534
|
}
|
|
535
|
-
`),
|
|
535
|
+
`),eh=dt(`
|
|
536
536
|
query ScopeWorkflowBySlug($projectId: String!, $cwd: String!, $slug: String!) {
|
|
537
537
|
project(id: $projectId) {
|
|
538
538
|
id
|
|
@@ -545,7 +545,7 @@ ${String(u)} error(s)
|
|
|
545
545
|
}
|
|
546
546
|
}
|
|
547
547
|
}
|
|
548
|
-
`),
|
|
548
|
+
`),th=dt(`
|
|
549
549
|
mutation ScopeAddAgent($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
550
550
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
551
551
|
id
|
|
@@ -555,43 +555,43 @@ ${String(u)} error(s)
|
|
|
555
555
|
}
|
|
556
556
|
}
|
|
557
557
|
}
|
|
558
|
-
`),
|
|
558
|
+
`),rh=dt(`
|
|
559
559
|
mutation ScopeLink($id: ID!, $workflowId: String!) {
|
|
560
560
|
linkScopeItem(id: $id, workflowId: $workflowId) {
|
|
561
561
|
id
|
|
562
562
|
}
|
|
563
563
|
}
|
|
564
|
-
`),
|
|
564
|
+
`),nh=dt(`
|
|
565
565
|
mutation ScopeRemoveMany($ids: [ID!]!) {
|
|
566
566
|
removeScopeItems(ids: $ids)
|
|
567
567
|
}
|
|
568
|
-
`);async function
|
|
568
|
+
`);async function _s(e){let t=ye();await he(t);let n=(await S({config:t,document:Zy,variables:{cwd:t.cwd,projectId:t.projectId}})).project?.devSession?.scopeItems??[];if(e.format==="json"){process.stdout.write(`${JSON.stringify(n,null,2)}
|
|
569
569
|
`);return}if(n.length===0){process.stdout.write("No scope items. Add via `ripplo scope add <test-ids..>` (variadic) or from the dashboard.\n");return}n.forEach(o=>{let i=o.workflow;if(i==null){process.stdout.write(` [intent] (${o.id}) ${o.label??""}
|
|
570
570
|
`);return}let s=i.spec==null?"stub":"implemented";process.stdout.write(` [${s}] (${o.id}) ${i.slug} \u2014 ${i.name}
|
|
571
|
-
`)})}async function
|
|
571
|
+
`)})}async function Us({testIds:e}){let t=ye();await he(t),await Te(t.cwd,t);let n=(await S({config:t,document:th,variables:{cwd:t.cwd,projectId:t.projectId,workflowSlugs:[...e]}})).addAgentScopeItems??[];if(n.length===0){process.stdout.write(`No scope items added.
|
|
572
572
|
`);return}let o=n.map(i=>i.workflow?.slug??"?").join(", ");process.stdout.write(`Added ${String(n.length)} scope item(s): ${o}
|
|
573
|
-
`)}async function
|
|
574
|
-
`)}async function
|
|
575
|
-
`)}async function
|
|
573
|
+
`)}async function Vs({id:e,testId:t}){let r=ye();await he(r),await Te(r.cwd,r);let n=await oh({cfg:r,slug:t});await S({config:r,document:rh,variables:{id:e,workflowId:n}}),process.stdout.write(`Linked scope item ${e} to ${t}
|
|
574
|
+
`)}async function Fs({ids:e}){let t=ye();await he(t);let n=(await S({config:t,document:nh,variables:{ids:[...e]}})).removeScopeItems??0;process.stdout.write(`Removed ${String(n)} scope item(s)
|
|
575
|
+
`)}async function oh({cfg:e,slug:t}){let n=(await S({config:e,document:eh,variables:{cwd:e.cwd,projectId:e.projectId,slug:t}})).project?.devSession?.workflows?.[0];return n==null&&(process.stderr.write(`No workflow found with id "${t}". Create a stub first via the testing DSL.
|
|
576
576
|
`),process.stderr.write(`${x("create")}
|
|
577
|
-
`),process.exit(1)),n.id}async function
|
|
577
|
+
`),process.exit(1)),n.id}async function Ms(e){let t=process.cwd(),r=await j(t);r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
578
578
|
`),process.exit(1));let{tests:n}=r.builder.getUnimplemented();if(e.format==="summary"){n.length>0&&process.stdout.write(`tests: ${n.join(", ")}
|
|
579
579
|
`);return}let o={tests:n.map(i=>({id:i,implemented:!1}))};process.stdout.write(`${JSON.stringify(o,null,2)}
|
|
580
|
-
`)}import{z as
|
|
581
|
-
`).filter(t=>t.length>0)}function
|
|
582
|
-
`).filter(r=>r.length>0)}import{createHash as
|
|
583
|
-
`).filter(n=>n.length>0).filter(n=>
|
|
584
|
-
`),hookEventName:"UserPromptSubmit"}}});import
|
|
580
|
+
`)}import{z as ih}from"zod";function N(e,t){let r=ih.custom(n=>typeof n=="object"&&n!==null&&"hook_event_name"in n&&n.hook_event_name===e);return{event:e,run:async n=>await t(r.parse(n))??void 0}}import{createHash as d$}from"crypto";import Hs from"picomatch";function sh(e){return X(["diff","--name-only","HEAD"],e).split(`
|
|
581
|
+
`).filter(t=>t.length>0)}function Ws({cwd:e,ignoreGlobs:t,watchGlobs:r}){let n=Hs([...r]),o=Hs([...t]);return sh(e).filter(i=>n(i)&&!o(i))}function Xt(e,...t){return X(["diff","--name-only","HEAD","--",...t],e).split(`
|
|
582
|
+
`).filter(r=>r.length>0)}import{createHash as ah}from"crypto";import{mkdirSync as lh,readFileSync as qs,writeFileSync as ch}from"fs";import kn from"path";var dh=[".ts",".tsx",".js",".jsx"];function qe(e){let t=ah("sha256");return t.update(X(["rev-parse","HEAD"],e)),t.update("\0"),t.update(X(["diff","HEAD"],e)),t.update("\0"),X(["ls-files","--others","--exclude-standard"],e).split(`
|
|
583
|
+
`).filter(n=>n.length>0).filter(n=>dh.some(o=>n.endsWith(o))).toSorted((n,o)=>n.localeCompare(o)).forEach(n=>{t.update(n),t.update("\0"),t.update(uh(kn.join(e,n))),t.update("\0")}),t.digest("hex")}function Be(e,t){try{return qs(Bs(e,t),"utf8").trim()}catch{return null}}function ze(e,t,r){let n=Bs(e,t);lh(kn.dirname(n),{recursive:!0}),ch(n,r)}function Bs(e,t){return kn.join(e,".ripplo",".local",`${t}.hash`)}function uh(e){try{return qs(e)}catch{return Buffer.alloc(0)}}function Pe(){return{ignorePaths:xe,watchPaths:cn}}var zs=N("UserPromptSubmit",e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=qe(t);if(Be(t,"coverage-nudge")===r)return;let{ignorePaths:n,watchPaths:o}=Pe(),i=Ws({cwd:t,ignoreGlobs:n,watchGlobs:o});if(ze(t,"coverage-nudge",r),!(i.length===0||Xt(t,".ripplo/tests",".ripplo/preconditions",".ripplo/observers").length>0))return{hookSpecificOutput:{additionalContext:`SCOPE DRIFT: ${String(i.length)} app file(s) changed without .ripplo/tests updates. ${x("scope")}`,hookEventName:"UserPromptSubmit"}}});import Qt from"fs";import ph from"os";import Gs from"path";var Ks=N("PreToolUse",e=>{if(e.tool_name!=="ExitPlanMode"||!M(e.cwd))return;let t=mh();if(t==null)return;let r=Qt.readFileSync(t,"utf8");if(!/\.ripplo\/tests|Tests to implement|No e2e coverage needed/.test(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`Plan must cite ripplo test stubs. Add a "Tests to implement" section listing .ripplo/tests/<id>.ts per affected flow, OR add "No e2e coverage needed: <reason>" if this plan touches no user-facing behavior. ${x("explore")}`}}});function mh(){let e=Gs.join(ph.homedir(),".claude","plans");return Qt.existsSync(e)?Qt.readdirSync(e).filter(r=>r.endsWith(".md")).map(r=>Gs.join(e,r)).map(r=>({full:r,mtime:Qt.statSync(r).mtimeMs})).sort((r,n)=>n.mtime-r.mtime)[0]?.full??null:null}var Js=N("UserPromptSubmit",async e=>{if(e.permission_mode!=="plan"||!I(e.cwd)||!M(e.cwd))return;let t=await j(e.cwd);if(!t.ok)return;let{tests:r}=t.builder.getUnimplemented(),n=['Plan must include "Tests to implement" with .ripplo/tests/<id>.ts per affected flow (ExitPlanMode blocks otherwise).'];return r.length>0&&n.push(`Existing stubs: ${r.join(", ")}`),{hookSpecificOutput:{additionalContext:n.join(`
|
|
584
|
+
`),hookEventName:"UserPromptSubmit"}}});import fh from"path";import Ys from"picomatch";import{z as Xs}from"zod";var gh=Xs.looseObject({file_path:Xs.string()}),Qs=N("PostToolUse",async e=>{let t=gh.safeParse(e.tool_input);if(!t.success)return;let r=t.data.file_path,{cwd:n}=e;if(!I(n)||!M(n))return;let o=fh.relative(n,r);if(o.startsWith(".."))return;let{ignorePaths:i,watchPaths:s}=Pe(),a=Ys([...s]),l=Ys([...i]);if(!a(o)||l(o))return;let c=await j(n);if(!c.ok)return;let{tests:d}=c.builder.getUnimplemented();if(d.length!==0)return{hookSpecificOutput:{additionalContext:`Reminder: .notImplemented() stubs still present \u2014 tests: ${d.join(", ")}`,hookEventName:"PostToolUse"}}});import yh from"path";import{graphql as hh}from"gql.tada";import{z as Zs}from"zod";var wh=Zs.looseObject({file_path:Zs.string()}),bh=hh(`
|
|
585
585
|
mutation AutoScopeAdd($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
586
586
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
587
587
|
id
|
|
588
588
|
}
|
|
589
589
|
}
|
|
590
|
-
`),
|
|
591
|
-
${x("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),
|
|
590
|
+
`),ea=N("PostToolUse",async e=>{let t=wh.safeParse(e.tool_input);if(!t.success)return;let r=t.data.file_path;if(!/\/\.ripplo\/.*\.ts$/.test(r))return;let{cwd:n}=e;if(!I(n)||!M(n))return;let o=await j(n);if(!o.ok)return{decision:"block",reason:`Compilation failed: ${o.error}
|
|
591
|
+
${x("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),Ve({cwd:n});let{diagnostics:i}=_e(o.result);return i.length===0?Sh({compileResult:o,cwd:n}):{decision:"block",reason:`${i.map(a=>{let l=a.step==null?"":` at "${a.step}"`;return` [${a.rule}]${l} ${a.test}: ${a.message}`}).join(`
|
|
592
592
|
`)}
|
|
593
|
-
${x("create")}`}});async function
|
|
594
|
-
`).map(r=>r.slice(3).trim()).filter(r=>/^\.ripplo\/tests\/[^/]+\.ts$/.test(r)).map(r=>
|
|
593
|
+
${x("create")}`}});async function Sh({compileResult:e,cwd:t}){let r=vh(t);if(r.length===0)return;let n=new Set(e.result.tests.map(c=>c.slug)),o=r.filter(c=>n.has(c));if(o.length===0)return;let i;try{i=W(t)}catch{return}if(await at({compiled:e.result,config:i,cwd:t}).catch(c=>(g.warn("auto-sync failed: %s",c instanceof Error?c.message:String(c)),null))==null)return;let a=await S({config:i,document:bh,variables:{cwd:i.cwd,projectId:i.projectId,workflowSlugs:o}}).catch(c=>(g.warn("auto-scope failed: %s",c instanceof Error?c.message:String(c)),null));if(!(a==null||(a.addAgentScopeItems??[]).length===0))return{hookSpecificOutput:{additionalContext:`Auto-scoped ${o.join(", ")} (dirty tests).`,hookEventName:"PostToolUse"}}}function vh(e){let t;try{t=X(["status","--porcelain","--",".ripplo/tests"],e)}catch{return[]}return t.split(`
|
|
594
|
+
`).map(r=>r.slice(3).trim()).filter(r=>/^\.ripplo\/tests\/[^/]+\.ts$/.test(r)).map(r=>yh.basename(r,".ts")).filter(r=>r!=="index")}import{z as ta}from"zod";var kh=ta.looseObject({command:ta.string()}),Rh=/\bripplo\s+hooks\s+pause\b/,ra=N("PreToolUse",e=>{if(e.tool_name!=="Bash")return;let t=kh.safeParse(e.tool_input);if(!t.success||!Rh.test(t.data.command))return;let{cwd:r}=e;if(I(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:"`ripplo hooks pause` is a human-only escape hatch \u2014 agents can't bypass Ripplo guardrails on their own. If watch genuinely can't start (auth, server down, intentional offline work), surface the blocker to the user and ask them to run `npx ripplo hooks pause` themselves from their terminal."}}});import{parse as Th}from"shell-quote";import{z as ia}from"zod";import{existsSync as xh,mkdirSync as Ph,rmSync as hA,writeFileSync as Ch}from"fs";import Rn from"path";function na(e,t,r){let n=oa(e,t,r);Ph(Rn.dirname(n),{recursive:!0}),Ch(n,"")}function Zt(e,t,r){return xh(oa(e,t,r))}function Eh(e,t){return Rn.join(e,".ripplo",".local","skills-loaded",t)}function oa(e,t,r){return Rn.join(Eh(e,t),r)}var $h=ia.looseObject({command:ia.string()}),Ah="debug",Ih=new Set(["tail","head","less","more","wc","sort","uniq","awk","sed","grep"]),aa=N("PreToolUse",e=>{if(e.tool_name!=="Bash")return;let t=$h.safeParse(e.tool_input);if(!t.success)return;let r=jh(t.data.command);if(!Nh(r))return;let{cwd:n}=e;if(!I(n)||!M(n))return;let o=Dh(r);if(o!=null)return sa(`Don't pipe \`ripplo run\` through \`${o}\` \u2014 buffering filters hold all stdout until EOF, hiding live progress; if you kill the pipeline mid-run the run is orphaned on the server. Redirect to a file instead: \`ripplo run <id> > /tmp/run.log 2>&1\` and Read the file, or use \`run_in_background: true\`.`);if(!Zt(n,e.session_id,Ah))return sa("Running `ripplo run` requires the `/ripplo:debug` skill loaded first. Load `/ripplo:debug` then retry \u2014 it carries the artifact-read order, the 3-strike rule, and the no-grep-piping guidance for run failures.")});function jh(e){try{return Th(e)}catch{return[]}}function Nh(e){return e.some((t,r)=>t==="ripplo"&&e[r+1]==="run")}function Oh(e){return typeof e=="object"&&"op"in e&&e.op==="|"}function Dh(e){let t=e.find((r,n)=>{let o=e[n-1];return o!=null&&Oh(o)&&typeof r=="string"&&Ih.has(r)});return typeof t=="string"?t:null}function sa(e){return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:e}}}import Lh from"path";import{z as la}from"zod";var _h=new Set(["Edit","Write","NotebookEdit"]),Uh=la.looseObject({file_path:la.string()}),Vh="create",ca=N("PreToolUse",e=>{if(!_h.has(e.tool_name))return;let t=Uh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r)||!M(r))return;let n=Lh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n!==".ripplo"&&!n.startsWith(".ripplo/"))&&!Zt(r,e.session_id,Vh))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`Editing \`.ripplo/\` files (${n}) requires the \`/ripplo:create\` skill loaded first. Load \`/ripplo:create\` then retry \u2014 it carries the DSL builder shape, lint rules, and the parallelization guidance you'll need.`}}});import Fh from"path";import da from"picomatch";import{graphql as Mh}from"gql.tada";import{z as ua}from"zod";var Hh=new Set(["Edit","Write","NotebookEdit"]),Wh=ua.looseObject({file_path:ua.string()}),qh=Mh(`
|
|
595
595
|
query PreEditScopeGate($projectId: String!, $cwd: String!) {
|
|
596
596
|
project(id: $projectId) {
|
|
597
597
|
id
|
|
@@ -603,7 +603,7 @@ ${x("create")}`}});async function hh({compileResult:e,cwd:t}){let r=wh(t);if(r.l
|
|
|
603
603
|
}
|
|
604
604
|
}
|
|
605
605
|
}
|
|
606
|
-
`),
|
|
606
|
+
`),pa=N("PreToolUse",async e=>{if(!Hh.has(e.tool_name))return;let t=Wh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r)||!M(r))return;let n=Fh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n===".ripplo"||n.startsWith(".ripplo/")||!Bh(n)||await zh(r)))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`Scope empty; edit touches app code (${n}). Stub a test or \`scope add\` an existing one before proceeding \u2014 or acknowledge "no user-facing behavior" if pure refactor. Hook re-fires until scope is populated (or hooks paused via the web UI). ${Yi(["scope","create"])}`}}});function Bh(e){let{ignorePaths:t,watchPaths:r}=Pe(),n=da([...r]),o=da([...t]);return n(e)&&!o(e)}async function zh(e){let t;try{t=W(e)}catch{return!0}let r=await S({config:t,document:qh,variables:{cwd:t.cwd,projectId:t.projectId}}).catch(()=>null);return r==null?!0:(r.project?.devSession?.scopeItems??[]).length>0}import Gh from"fs";import Kh from"path";import{z as ma}from"zod";var Jh=new Set(["Edit","Write","NotebookEdit"]),Yh=ma.looseObject({file_path:ma.string()}),fa=N("PreToolUse",e=>{if(!Jh.has(e.tool_name))return;let t=Yh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r))return;let n=Kh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n!==".ripplo"&&!n.startsWith(".ripplo/"))&&!Gh.existsSync(pe(r))&&!Me(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`\`ripplo watch\` is not running, so this edit to \`${n}\` won't sync to the server and dev-mode guardrails won't fire. Run \`/ripplo:start\` (or spawn \`npx ripplo watch\` directly via Bash with run_in_background), then retry. The app's dev server also needs to be running \u2014 \`npx ripplo doctor\` reports both. If watch can't start (auth, server down, intentional offline work), the user can run \`npx ripplo hooks pause\` to bypass this gate; \`npx ripplo hooks resume\` re-enables it. ${x("start")}`}}});import{graphql as Xh}from"gql.tada";var Qh=Xh(`
|
|
607
607
|
query ScopeReminder($projectId: String!, $cwd: String!) {
|
|
608
608
|
project(id: $projectId) {
|
|
609
609
|
id
|
|
@@ -620,9 +620,9 @@ ${x("create")}`}});async function hh({compileResult:e,cwd:t}){let r=wh(t);if(r.l
|
|
|
620
620
|
}
|
|
621
621
|
}
|
|
622
622
|
}
|
|
623
|
-
`),
|
|
623
|
+
`),ga=N("UserPromptSubmit",async e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=qe(t);if(Be(t,"scope-reminder")===r)return;let n;try{n=W(t)}catch{return}let o=await S({config:n,document:Qh,variables:{cwd:n.cwd,projectId:n.projectId}}).catch(()=>null);if(o==null)return;ze(t,"scope-reminder",r);let i=o.project?.devSession?.scopeItems??[];return{hookSpecificOutput:{additionalContext:i.length===0?`RIPPLO SCOPE: empty. ${x("scope")}`:`RIPPLO SCOPE (${String(i.length)}):
|
|
624
624
|
${i.map(a=>{let l=a.workflow;return l==null?` [intent] (${a.id}) ${a.label??""}`:` [${l.spec==null?"stub":"implemented"}] (${a.id}) ${l.slug}`}).join(`
|
|
625
|
-
`)}`,hookEventName:"UserPromptSubmit"}}});var
|
|
625
|
+
`)}`,hookEventName:"UserPromptSubmit"}}});var Zh="# Ripplo \u2014 always-on session context\n\nEvery user-facing change in this repo ships with a deterministic, backend-aware test that proves it works end-to-end.\n\n## Load the right skill before acting \u2014 this is critical\n\nThe skills below carry the procedural detail you need to do Ripplo work correctly: precondition isolation, observer budget tiers, coverage IDs, scope discipline, artifact-read order on failures, parallelization patterns. **None of that is reproduced in this preamble** \u2014 only the always-on guardrails are. If you act on a Ripplo task without loading the matching skill, you will skip rules that exist to prevent specific past failure modes (cross-run data leakage, \"passing\" tests that never asserted backend state, cleared coverage gates without proof, etc.).\n\nMatch the task to a skill from the triage table; if unsure between two, load both. If completely unsure, load `/ripplo:explore` or `/ripplo:create`. Loading is cheap; acting under-informed is not.\n\n## Skill triage\n\n- Load `/ripplo:setup` skill for instructions on initializing Ripplo in a project; `ripplo doctor` reports the engine endpoint missing.\n- Load `/ripplo:explore` skill for instructions on planning/stubbing test coverage for a new project or new feature area.\n- Load `/ripplo:scope` skill for instructions on managing the working set of tests this session is responsible for.\n- Load `/ripplo:create` skill for instructions on authoring a single test spec for a user flow.\n- Load `/ripplo:run` skill for instructions on executing existing tests.\n- Load `/ripplo:debug` skill for instructions on a failed run; read artifacts in `.ripplo/debug/<runId>/` before re-running.\n- Load `/ripplo:flake-detect` skill for instructions on intermittent failures; parallelizes N runs (only use with evidence of flake).\n\n## Universal rules\n\n- **Two background processes must be running before feature work.** (1) The app's dev server, so the app is reachable; (2) `npx ripplo watch` (run `/ripplo:start` to spawn it, or invoke it directly via Bash with `run_in_background`), so the dev session is live. Without watch, scope/coverage hooks don't arm and `ripplo run` refuses to dispatch. Without the dev server, runs fail when they try to hit the app. `npx ripplo doctor` reports both.\n- **Two funnels.** Definitions \u2192 `createRipplo({ preconditions, observers, tests })` in `.ripplo/index.ts`. Implementations \u2192 `createEngine(ripplo, { preconditions, observers })` in your app server's `test/engine.ts`. Never call either elsewhere. TS enforces exhaustiveness across both.\n- **\"Done\" = app code delivers the behavior AND a passing test proves it.** Both halves. Shipping without a test isn't done; writing a test against broken UI/API isn't done.\n- **Scope is your job.** For any non-trivial change, enumerate every flow it could affect and either `scope add` existing tests or stub `.notImplemented()` tests. Don't wait to be told.\n- **`scope remove` is never for size/effort.** Valid only when an item is genuinely out of scope (wrong flow, duplicate, user said \"not this session,\" feature cut). \"Too many stubs\" \u2192 parallelize with subagents. Don't present \"implement vs. remove\" as a neutral A/B.\n- **Stub gates are not a question.** When `stop-enforce` blocks on `.notImplemented()` stubs, implement them \u2014 don't ask the user \"implement or defer?\", don't propose pausing hooks as option B. The fix isn't done until the test is. New scaffolding (precondition, observer, engine impl) is in-scope work, not follow-up.\n- **`uiOnly: true` is not a stub.** Observer wiring is in-scope for mutation flows; don't use it to silence observer lint.\n- **Never weaken a test to make it pass.** No `contains`/regex for exact text, no removed assertions, no fabricated locators. App lacks an accessible name \u2192 add one to the app, don't fall back to `testId()`. App bug \u2192 report with evidence.\n- **Artifacts first, re-run last.** Failed runs produce DOM, a11y tree, console, network, screenshots under `.ripplo/debug/<runId>/`. Read them. Never pipe `ripplo run` through `grep`/`tail`/`head`. Form a hypothesis citing an artifact line, make ONE change, re-run once.\n- **3-strike rule.** Same failure after 3 targeted fixes \u2192 stop and report. Repeated failure on the same step almost always means the diagnosis is wrong.\n- **`.ripplo/ripplo.lock` is committed, never hand-edited.** `ripplo lint` / `ripplo compile` regenerates it. Pre-commit runs `ripplo compile --check`.\n- **Scratch files live in `.ripplo/.local/`.** Never loose in `.ripplo/`.\n- **Worktrees are self-contained.** Each worktree has its own `.ripplo/` checkout, DevSession, scope, and debug artifacts. Auth and projectId are shared globally. Env files (typically gitignored) won't carry over to a fresh worktree \u2014 copy from main or point at a shared file. **If sibling worktrees run dev servers on different ports, the worktree's env file MUST update both `RIPPLO_APP_URL` and `RIPPLO_ENGINE_URL` to match the port that worktree's dev server is bound to** (e.g. main on `:3000`, this worktree on `:3001` \u2192 set `RIPPLO_APP_URL=http://localhost:3001` and `RIPPLO_ENGINE_URL=http://localhost:3001/ripplo` in the worktree's env file). Mismatched ports = `npx ripplo watch` (whether started via `/ripplo:start` or manually) talks to the wrong server, runs silently fail or hit the sibling worktree's app.\n- **DSL locators are semantic.** No `css` / `placeholder` / `waitFor` / `group`.\n- **New backend assertion?** Declare in `.ripplo/observers/index.ts`, implement in your app server's `engine.ts` (TS flags the missing impl).\n\n## Key files\n\n- `.ripplo/index.ts` \u2014 `createRipplo` call.\n- `.ripplo/{preconditions,observers,tests}/index.ts` \u2014 registry aggregators.\n- `.ripplo/project.json` \u2014 project id + env-file pointers.\n- `<app>/src/test/engine.ts` \u2014 single impl funnel via `createEngine`.\n- `packages/testing/README.md` (or the npm page for `@ripplo/testing`) \u2014 DSL reference.\n",ya=N("SessionStart",e=>{if(I(e.cwd))return{hookSpecificOutput:{additionalContext:Zh,hookEventName:"SessionStart"}}});import{execFileSync as ew}from"child_process";import tw from"path";import ha from"process";import{graphql as rw}from"gql.tada";import{z as er}from"zod";var nw=rw(`
|
|
626
626
|
query ScopeEnforce($projectId: String!, $cwd: String!) {
|
|
627
627
|
project(id: $projectId) {
|
|
628
628
|
id
|
|
@@ -641,14 +641,14 @@ ${i.map(a=>{let l=a.workflow;return l==null?` [intent] (${a.id}) ${a.label??""}
|
|
|
641
641
|
}
|
|
642
642
|
}
|
|
643
643
|
}
|
|
644
|
-
`),
|
|
644
|
+
`),ba=N("Stop",async e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=qe(t),n=Be(t,"stop-enforce")===r;if(n&&!e.stop_hook_active)return;let o=ow(t),i=await iw(t,o);if(ze(t,"stop-enforce",r),i.length!==0)return n&&e.stop_hook_active?{continue:!1,stopReason:`Stop-enforce: same repo state across consecutive stop attempts; agent appears stuck. Errors:
|
|
645
645
|
${i.join(`
|
|
646
646
|
|
|
647
647
|
`)}`}:{decision:"block",reason:i.join(`
|
|
648
648
|
|
|
649
|
-
`)}});function
|
|
649
|
+
`)}});function ow(e){return Xt(e,".ripplo/tests").filter(t=>t.endsWith(".ts")).map(t=>tw.basename(t,".ts")).filter(t=>t!=="index")}async function iw(e,t){let r=await j(e);if(!r.ok)return[`--- Compilation failed ---
|
|
650
650
|
${r.error}
|
|
651
|
-
${x("create")}`];await de({cwd:e,result:r.result}),
|
|
651
|
+
${x("create")}`];await de({cwd:e,result:r.result}),Ve({cwd:e});let n=await aw(e),o=[...new Set([...t,...n.scopedSlugsToRun])],i=lw(r,t),s=cw(r),a=sw(e,r),l=dw(e,o);return[i,s,a,l,n.error].filter(c=>c!=null)}function sw(e,t){let{ignorePaths:r}=Pe(),n=Qi({compileResult:t.result,cwd:e,ignorePaths:r});if(n.length===0)return null;let o=n.filter(a=>a.kind==="unacknowledged"),i=n.filter(a=>a.kind==="stale"),s=[];if(o.length>0){let a=o.map(l=>` ${l.id}`).join(`
|
|
652
652
|
`);s.push(`Unacknowledged interactions (add to a test's .coverage(...)):
|
|
653
653
|
${a}`)}if(i.length>0){let a=i.map(l=>` ${l.id}`).join(`
|
|
654
654
|
`);s.push(`Stale .coverage(...) claims (id no longer exists in source):
|
|
@@ -656,23 +656,23 @@ ${a}`)}return`--- Exhaustiveness ---
|
|
|
656
656
|
${s.join(`
|
|
657
657
|
|
|
658
658
|
`)}
|
|
659
|
-
${x("create")}`}async function
|
|
659
|
+
${x("create")}`}async function aw(e){let t;try{t=W(e)}catch{return{error:null,scopedSlugsToRun:[]}}let n=(await S({config:t,document:nw,variables:{cwd:t.cwd,projectId:t.projectId}}).catch(()=>null))?.project?.devSession?.scopeItems??[],o=n.flatMap(a=>{let l=a.workflow;return l==null?[` [intent] ${a.label??"(no label)"} \u2014 stub a test for this flow`]:l.spec==null?[` [stub] ${l.slug} \u2014 implement \`${l.name}\``]:[]}),i=n.flatMap(a=>a.workflow?.spec==null?[]:[a.workflow.slug]);return{error:o.length===0?null:`--- Testing Scope ---
|
|
660
660
|
${o.join(`
|
|
661
661
|
`)}
|
|
662
|
-
${x("create")}`,scopedSlugsToRun:i}}function
|
|
662
|
+
${x("create")}`,scopedSlugsToRun:i}}function lw(e,t){let{diagnostics:r}=_e(e.result),n=new Set(e.builder.getUnimplemented().tests),o=t.filter(a=>n.has(a));if(r.length===0&&o.length===0)return null;let i=r.map(a=>{let l=a.step==null?"":` at "${a.step}"`;return` [${a.rule}]${l} ${a.test}: ${a.message}`}),s=o.map(a=>` [not-implemented] ${a} is still marked .notImplemented()`);return`--- Ripplo Lint ---
|
|
663
663
|
${[...i,...s].join(`
|
|
664
664
|
`)}
|
|
665
|
-
${x("create")}`}function
|
|
665
|
+
${x("create")}`}function cw(e){let{tests:t}=e.builder.getUnimplemented();return t.length===0?null:`--- Unimplemented stubs ---
|
|
666
666
|
${t.join(", ")}
|
|
667
667
|
Implement the stub now. Do not ask the user "implement or defer?" \u2014 that framing is forbidden by /ripplo:create. New scaffolding (precondition, observer, engine impl) is in-scope, not follow-up.
|
|
668
|
-
${x("create")}`}function
|
|
668
|
+
${x("create")}`}function dw(e,t){if(t.length===0)return null;let r=pw(["run",...t],e);if(r.code===0)return null;let n=r.output.split(`
|
|
669
669
|
`).filter(o=>/FAILED/.test(o)).join(`
|
|
670
670
|
`);return n.length===0?null:`--- Ripplo Run Failures (${t.join(" ")}) ---
|
|
671
671
|
${n}
|
|
672
|
-
Artifacts: .ripplo/debug/<runId>/. ${x("debug")}`}var
|
|
673
|
-
`),process.exit(1));let r=await
|
|
674
|
-
`),process.exit(1)});function
|
|
675
|
-
`))}export{
|
|
672
|
+
Artifacts: .ripplo/debug/<runId>/. ${x("debug")}`}var uw=er.object({status:er.number().nullish(),stderr:er.unknown().optional(),stdout:er.unknown().optional()});function wa(e){return e instanceof Buffer?e.toString("utf8"):typeof e=="string"?e:""}function pw(e,t){let r=ha.argv[1];if(r==null)return{code:1,output:""};try{return{code:0,output:ew(ha.execPath,[r,...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}}catch(n){let o=uw.safeParse(n);if(!o.success)return{code:1,output:""};let i=`${wa(o.data.stdout)}${wa(o.data.stderr)}`;return{code:o.data.status??1,output:i}}}import{z as Sa}from"zod";var mw=Sa.looseObject({skill:Sa.string()}),va=N("PostToolUse",e=>{if(e.tool_name!=="Skill")return;let t=mw.safeParse(e.tool_input);if(!t.success)return;let r=/^ripplo:(.+)$/.exec(t.data.skill);if(r==null)return;let n=r[1];n!=null&&I(e.cwd)&&na(e.cwd,e.session_id,n)});Rw();Tn(process.cwd());var ka={"coverage-nudge":zs,"exit-plan-gate":Ks,"plan-reminder":Js,"post-edit-flag-stubs":Qs,"post-edit-lint":ea,"pre-bash-hooks-pause-gate":ra,"pre-bash-run-gate":aa,"pre-edit-ripplo-skill-gate":ca,"pre-edit-scope-gate":pa,"pre-edit-watch-gate":fa,"scope-reminder":ga,"session-preamble":ya,"stop-enforce":ba,"track-skill-load":va};async function yw(){await fw(gw(process.argv)).scriptName("ripplo").command("watch","Watch for run requests and execute locally",()=>{},()=>Ls()).command("auth <subcommand>","Manage authentication",kw).command("projects <subcommand>","Inspect Ripplo projects",vw).command("hooks <subcommand>","Pause or resume Ripplo hooks",Sw).command("init","Scaffold .ripplo/ in this project",e=>e.option("project",{type:"string"}).option("env",{type:"string"}).option("app-url",{type:"string"}).option("engine-url",{type:"string"}),e=>Es({appUrl:e["app-url"],engineUrl:e["engine-url"],envFile:e.env,projectId:e.project})).command("run [ids..]","Run tests in parallel",e=>{let t=[];return e.positional("ids",{array:!0,default:t,describe:"Test ids to run (all if omitted)",type:"string"})},e=>js(e.ids)).command("lint [ids..]","Compile and lint tests (all or specific ids)",e=>{let t=[];return e.positional("ids",{array:!0,default:t,describe:"Test ids to lint (all if omitted)",type:"string"}).option("require-implemented",{array:!0,default:t,describe:"Test ids that must not be .notImplemented() \u2014 fails if any still are",type:"string"})},e=>As({ids:e.ids,requireImplemented:e["require-implemented"]})).command("flake-detect <id>","Run N times to detect flakiness",e=>e.positional("id",{demandOption:!0,type:"string"}).option("runs",{default:10,type:"number"}),e=>bs({id:e.id,runs:e.runs})).command("sync","Push the compiled .ripplo/ resources to the server (no run)",()=>{},()=>Ns()).command("compile","Compile the DSL and write .ripplo/ripplo.lock",e=>e.option("check",{default:!1,describe:"Exit non-zero if the lockfile is missing or stale (does not write)",type:"boolean"}),e=>Xi({check:e.check})).command("cover","Audit all coverage statements",()=>{},()=>rs()).command("doctor","Check project health",()=>{},()=>gs()).command("status","Report unimplemented tests and preconditions",e=>e.option("format",{choices:["json","summary"],default:"json",describe:"Output format"}),e=>Ms({format:e.format})).command("scope <subcommand>","Manage testing scope",bw).command("hook <name>","Internal: run a Claude Code plugin hook",e=>e.positional("name",{choices:Object.keys(ka),demandOption:!0,type:"string"}),e=>hw(e.name)).strict().help().parse()}async function hw(e){let t=ka[e];t==null&&(process.stderr.write(`Unknown hook: ${e}
|
|
673
|
+
`),process.exit(1));let r=await ww(),n=r.trim()===""?{}:JSON.parse(r),o=await t.run(n);o!=null&&process.stdout.write(JSON.stringify(o))}function ww(){return new Promise((e,t)=>{if(process.stdin.isTTY){e("");return}let r=[];process.stdin.on("data",n=>r.push(n)),process.stdin.on("end",()=>{e(Buffer.concat(r).toString("utf8"))}),process.stdin.on("error",t)})}yw().catch(e=>{process.stderr.write(`${e instanceof Error?e.message:String(e)}
|
|
674
|
+
`),process.exit(1)});function bw(e){return e.command("status","Print the current scope",t=>t.option("format",{choices:["json","text"],default:"text",describe:"Output format"}),t=>_s({format:t.format})).command("add <test-ids..>","Bind one or more existing tests (stubs or implemented) to scope as agent intent",t=>{let r=[];return t.positional("test-ids",{array:!0,default:r,demandOption:!0,describe:"Slugs of existing workflows",type:"string"})},t=>Us({testIds:t["test-ids"]})).command("link <id> <test-id>","Link an existing scope item to a test",t=>t.positional("id",{demandOption:!0,describe:"Scope item id",type:"string"}).positional("test-id",{demandOption:!0,describe:"Slug of the workflow to link",type:"string"}),t=>Vs({id:t.id,testId:t["test-id"]})).command("remove <ids..>","Remove one or more scope items by id",t=>{let r=[];return t.positional("ids",{array:!0,default:r,demandOption:!0,describe:"Scope item ids",type:"string"})},t=>Fs({ids:t.ids})).demandCommand(1)}function Sw(e){return e.command("pause","Disable all Ripplo pre-edit gates and stop enforcement until resumed",()=>{},()=>Ss()).command("resume","Re-enable Ripplo hooks paused via `ripplo hooks pause`",()=>{},()=>vs()).demandCommand(1)}function vw(e){return e.command("list","List projects you have access to (JSON)",()=>{},()=>Is()).demandCommand(1)}function kw(e){return e.command("login","Authenticate via device flow",()=>{},()=>xi()).command("status","Show authentication status",()=>{},()=>Pi()).command("logout","Remove the saved token",()=>{},()=>{Ci()}).demandCommand(1)}function Rw(){let e=process.cwd(),t=tr(e);t!=null&&t!==e&&(process.chdir(t),process.stderr.write(`ripplo: resolved .ripplo/ at ${t}
|
|
675
|
+
`))}export{yw as main};
|
|
676
676
|
/*! Bundled license information:
|
|
677
677
|
|
|
678
678
|
mustache/mustache.mjs:
|