ripplo 0.4.0 → 0.4.1
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 +174 -156
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{execFileSync as
|
|
3
|
-
`)}function
|
|
2
|
+
import{execFileSync as ca}from"child_process";import da from"fs";import dt from"path";function Jt(e){let t=pa(e);return t??Sn(e)}function Sn(e){let t=dt.dirname(e);return ua(dt.join(e,".ripplo"))?e:t===e?null:Sn(t)}function ua(e){try{return da.statSync(e).isDirectory()}catch{return!1}}function pa(e){let t=ma(["rev-parse","--show-toplevel"],e);if(t==null)return null;let r=t.trim();return r.length===0?null:dt.isAbsolute(r)?r:dt.resolve(e,r)}function ma(e,t){try{return ca("git",e,{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]})}catch{return null}}import Rn from"fs";import mt from"path";import{config as ya}from"dotenv";import{z as pt}from"zod";import ze from"fs";import Yt from"path";import{z as ut}from"zod";var vn=Yt.join(".ripplo","project.json"),Kt=[".env",".env.local"],fa=ut.object({envFiles:ut.array(ut.string().min(1)).optional(),projectId:ut.string().min(1)});function Xt(e){return Yt.join(e,vn)}function Qt(e){let t=Xt(e);if(!ze.existsSync(t))throw new Error(`ripplo: missing ${vn}. Run \`ripplo init\` to create it.`);let r=JSON.parse(ze.readFileSync(t,"utf8")),n=fa.parse(r);return{envFiles:n.envFiles??Kt,projectId:n.projectId}}function Zt(e){let t=Xt(e);if(ze.existsSync(t))try{return Qt(e)}catch{return}}function kn({cwd:e,envFiles:t,projectId:r}){let n=Xt(e);ze.mkdirSync(Yt.dirname(n),{recursive:!0});let o={projectId:r};t!=null&&!ga(t)&&(o.envFiles=[...t]),ze.writeFileSync(n,JSON.stringify(o,null,2)+`
|
|
3
|
+
`)}function ga(e){return e.length!==Kt.length?!1:e.every((t,r)=>t===Kt[r])}function xn(e){let r=Zt(e)?.envFiles??[".env",".env.local"],n=mt.join(e,".ripplo");r.forEach(o=>{let i=mt.resolve(n,o);Rn.existsSync(i)&&ya({override:!0,path:i,quiet:!0})}),er=void 0}var ha=pt.object({RIPPLO_APP_URL:pt.url(),RIPPLO_ENGINE_URL:pt.url(),RIPPLO_WEBHOOK_SECRET:pt.string().min(1)}),er;function Ae(){return er??=wa(),er}function wa(){let e=ha.safeParse(process.env);if(!e.success){let r=e.error.issues.map(s=>` ${s.path.join(".")}: ${s.message}`).join(`
|
|
4
4
|
`),n=tr(process.cwd()),o=n.map(s=>` ${s}`).join(`
|
|
5
5
|
`),i=n.length>0?`
|
|
6
6
|
|
|
@@ -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 tr(e){let r=Zt(e)?.envFiles??[],n=mt.join(e,".ripplo");return r.map(o=>mt.resolve(n,o)).filter(o=>!
|
|
13
|
-
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,C=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 tr(e){let r=Zt(e)?.envFiles??[],n=mt.join(e,".ripplo");return r.map(o=>mt.resolve(n,o)).filter(o=>!Rn.existsSync(o))}import Dh from"yargs";import{hideBin as _h}from"yargs/helpers";import{graphql as qu}from"gql.tada";var ba=Object.prototype.toString,Ie=Array.isArray||function(t){return ba.call(t)==="[object Array]"};function nr(e){return typeof e=="function"}function Sa(e){return Ie(e)?"array":typeof e}function rr(e){return e.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")}function Pn(e,t){return e!=null&&typeof e=="object"&&t in e}function va(e,t){return e!=null&&typeof e!="object"&&e.hasOwnProperty&&e.hasOwnProperty(t)}var ka=RegExp.prototype.test;function Ra(e,t){return ka.call(e,t)}var xa=/\S/;function Pa(e){return!Ra(xa,e)}var Ea={"&":"&","<":"<",">":">",'"':""","'":"'","/":"/","`":"`","=":"="};function Ca(e){return String(e).replace(/[&<>"'`=\/]/g,function(r){return Ea[r]})}var Ta=/\s*/,Aa=/\s+/,En=/\s*=/,$a=/\s*\}/,Ia=/#|\^|\/|>|\{|&|=|!/;function ja(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(N){if(typeof N=="string"&&(N=N.split(Aa,2)),!Ie(N)||N.length!==2)throw new Error("Invalid tags: "+N);u=new RegExp(rr(N[0])+"\\s*"),f=new RegExp("\\s*"+rr(N[1])),b=new RegExp("\\s*"+rr("}"+N[1]))}w(t||te.tags);for(var h=new Je(e),S,C,_,q,j,U;!h.eos();){if(S=h.pos,_=h.scanUntil(u),_)for(var ie=0,Te=_.length;ie<Te;++ie)q=_.charAt(ie),Pa(q)?(i.push(o.length),l+=q):(a=!0,r=!0,l+=" "),o.push(["text",q,S,S+1]),S+=1,q===`
|
|
13
|
+
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,C=h.scan(Ia)||"name",h.scan(Ta),C==="="?(_=h.scanUntil(En),h.scan(En),h.scanUntil(f)):C==="{"?(_=h.scanUntil(b),h.scan($a),h.scanUntil(f),C="&"):_=h.scanUntil(f),!h.scan(f))throw new Error("Unclosed tag at "+h.pos);if(C==">"?j=[C,_,S,h.pos,l,c,r]:j=[C,_,S,h.pos],c++,o.push(j),C==="#"||C==="^")n.push(j);else if(C==="/"){if(U=n.pop(),!U)throw new Error('Unopened section "'+_+'" at '+S);if(U[1]!==_)throw new Error('Unclosed section "'+U[1]+'" at '+S)}else C==="name"||C==="{"||C==="&"?a=!0:C==="="&&w(_)}if(d(),U=n.pop(),U)throw new Error('Unclosed section "'+U[1]+'" at '+h.pos);return Oa(Na(o))}function Na(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 Oa(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 Je(e){this.string=e,this.tail=e,this.pos=0}Je.prototype.eos=function(){return this.tail===""};Je.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};Je.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 $e(e,t){this.view=e,this.cache={".":this.view},this.parent=t}$e.prototype.push=function(t){return new $e(t,this)};$e.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=Pn(i,s[a])||va(i,s[a])),i=i[s[a++]];else i=o.view[t],l=Pn(o.view,t);if(l){n=i;break}o=o.parent}r[t]=n}return nr(n)&&(n=n.call(this.view)),n};function z(){this.templateCache={_cache:{},set:function(t,r){this._cache[t]=r},get:function(t){return this._cache[t]},clear:function(){this._cache={}}}}z.prototype.clearCache=function(){typeof this.templateCache<"u"&&this.templateCache.clear()};z.prototype.parse=function(t,r){var n=this.templateCache,o=t+":"+(r||te.tags).join(":"),i=typeof n<"u",s=i?n.get(o):void 0;return s==null&&(s=ja(t,r),i&&n.set(o,s)),s};z.prototype.render=function(t,r,n,o){var i=this.getConfigTags(o),s=this.parse(t,i),a=r instanceof $e?r:new $e(r,void 0);return this.renderTokens(s,a,n,t,o)};z.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};z.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(Ie(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(nr(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}};z.prototype.renderInverted=function(t,r,n,o,i){var s=r.lookup(t[1]);if(!s||Ie(s)&&s.length===0)return this.renderTokens(t[4],r,n,o,i)};z.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
|
-
`)};z.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=nr(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)}}};z.prototype.unescapedValue=function(t,r){var n=r.lookup(t[1]);if(n!=null)return n};z.prototype.escapedValue=function(t,r,n){var o=this.getConfigEscape(n)||te.escape,i=r.lookup(t[1]);if(i!=null)return typeof i=="number"&&o===te.escape?String(i):o(i)};z.prototype.rawValue=function(t){return t[1]};z.prototype.getConfigTags=function(t){return Ie(t)?t:t&&typeof t=="object"?t.tags:void 0};z.prototype.getConfigEscape=function(t){if(t&&typeof t=="object"&&!Ie(t))return t.escape};var te={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){
|
|
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
|
+
`)};z.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=nr(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)}}};z.prototype.unescapedValue=function(t,r){var n=r.lookup(t[1]);if(n!=null)return n};z.prototype.escapedValue=function(t,r,n){var o=this.getConfigEscape(n)||te.escape,i=r.lookup(t[1]);if(i!=null)return typeof i=="number"&&o===te.escape?String(i):o(i)};z.prototype.rawValue=function(t){return t[1]};z.prototype.getConfigTags=function(t){return Ie(t)?t:t&&typeof t=="object"?t.tags:void 0};z.prototype.getConfigEscape=function(t){if(t&&typeof t=="object"&&!Ie(t))return t.escape};var te={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){Ge.templateCache=e},get templateCache(){return Ge.templateCache}},Ge=new z;te.clearCache=function(){return Ge.clearCache()};te.parse=function(t,r){return Ge.parse(t,r)};te.render=function(t,r,n,o){if(typeof t!="string")throw new TypeError('Invalid template! Template should be a "string" but "'+Sa(t)+'" was given as the first argument for mustache#render(template, view, partials)');return Ge.render(t,r,n,o)};te.escape=Ca;te.Scanner=Je;te.Context=$e;te.Writer=z;var Cn=te;function Ke({defs:e}){return e==null?{}:Object.fromEntries(Object.entries(e).map(([t,r])=>[t,Da({def:r,name:t})]))}var La={boolean:!1,number:0,string:""};function Da({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??La[e.type]??""}function Ye({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 G({ref:e,variables:t}){let r=String(Ye({ref:e,variables:t}));return or({raw:r,variables:t})}function or({raw:e,variables:t}){return Cn.render(e,t,{},{escape:r=>r})}function ir({ref:e,variables:t}){let r=Ye({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 je({name:e,store:t,value:r}){return{...t,[e]:r}}function D({locator:e,page:t,variables:r}){switch(e.by){case"testId":return t.getByTestId(Tn(e.value,r));case"role":return t.getByRole(e.role,{exact:!0,name:e.name==null?void 0:Tn(e.name,r)})}}function Tn(e,t){return t==null?e:or({raw:e,variables:t})}async function An({node:e,page:t,timeout:r}){await D({locator:e.source,page:t,variables:void 0}).dragTo(D({locator:e.target,page:t,variables:void 0}),{timeout:r})}async function $n({node:e,page:t,timeout:r}){await D({locator:e.locator,page:t,variables:void 0}).click({button:"right",timeout:r})}function In({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 jn({node:e,page:t,variables:r}){if(e.action==="write"){if(e.value==null)throw new Error("clipboard write requires a value");let o=G({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:je({name:e.variable,store:r,value:n})}}async function Nn({node:e,page:t}){let r=t.context();e.state==="granted"?await r.grantPermissions([e.permission]):await r.clearPermissions()}async function sr({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 Ua({node:e,page:t,timeout:r,variables:n});case"rightClick":return await $n({node:e,page:t,timeout:r}),{variables:n};case"goto":{let o=G({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 Fa({node:e,page:t,timeout:r,variables:n});case"select":return Ma({node:e,page:t,timeout:r,variables:n});case"type":return Wa({node:e,page:t,timeout:r,variables:n});case"press":return await Va({node:e,page:t,timeout:r}),{variables:n};case"drag":return await An({node:e,page:t,timeout:r}),{variables:n};case"upload":return Ha({node:e,page:t,timeout:r,variables:n});case"extractText":return qa({node:e,page:t,timeout:r,variables:n});case"setVariable":{let o=Ye({ref:e.value,variables:n});return{variables:je({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 In({node:e,page:t,variables:n});case"clipboard":return jn({node:e,page:t,variables:n});case"setPermission":return await Nn({node:e,page:t}),{variables:n}}}var _a={check:"check",clear:"clear",click:"click",dblclick:"dblclick",focus:"focus",hover:"hover",scrollIntoView:"scrollIntoViewIfNeeded",uncheck:"uncheck"};async function Ua({node:e,page:t,timeout:r,variables:n}){return await D({locator:e.locator,page:t,variables:n})[_a[e.type]]({timeout:r}),{variables:n}}async function Va({node:e,page:t,timeout:r}){e.locator==null?await t.keyboard.press(e.key):await D({locator:e.locator,page:t,variables:void 0}).press(e.key,{timeout:r})}async function Fa({node:e,page:t,timeout:r,variables:n}){let o=G({ref:e.value,variables:n});return await D({locator:e.locator,page:t,variables:n}).fill(o,{timeout:r}),{variables:n}}async function Ma({node:e,page:t,timeout:r,variables:n}){let o=G({ref:e.value,variables:n});return await D({locator:e.locator,page:t,variables:n}).selectOption(o,{timeout:r}),{variables:n}}async function Wa({node:e,page:t,timeout:r,variables:n}){let o=G({ref:e.value,variables:n});return await D({locator:e.locator,page:t,variables:n}).pressSequentially(o,{timeout:r}),{variables:n}}async function Ha({node:e,page:t,timeout:r,variables:n}){return await D({locator:e.locator,page:t,variables:n}).setInputFiles(e.files,{timeout:r}),{variables:n}}async function qa({node:e,page:t,timeout:r,variables:n}){let o=await D({locator:e.locator,page:t,variables:n}).textContent({timeout:r});if(o==null)throw new Error("extractText: element had no text content");return{variables:je({name:e.variable,store:n,value:o})}}import Ul from"@anthropic-ai/sdk";import{z as On}from"zod";import{z as Ya}from"zod";async function he({page:e,runStartTime:t,targets:r}){let n=e.viewportSize();if(n==null)throw new Error("Page has no viewport set");return{annotations:await Ga(r),snapshotTimestamp:Math.round(performance.now()-t),url:e.url(),viewportHeight:n.height,viewportWidth:n.width}}function Ba(e){return"locator"in e}function za(e){let t=globalThis.__ripploRrwebMirror?.getId(e);return t!=null&&t>0?t:void 0}async function Ga(e){return(await Promise.all(e.map(r=>Ja(r)))).filter(r=>r!=null)}async function Ja(e){if(!Ba(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(za).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 ft({node:e,page:t}){if(e.type==="assertUrl")return[{label:e.type,type:"urlBar"}];if(e.type==="drag"){let o=D({locator:e.source,page:t,variables:void 0}),i=D({locator:e.target,page:t,variables:void 0});return[{label:"drag-source",locator:o,type:"action"},{label:"drag-target",locator:i,type:"action"}]}if(!Ka(e))return[];let r=e.type.startsWith("assert")?"assertion":"action",n=D({locator:e.locator,page:t,variables:void 0});return[{label:e.type,locator:n,type:r}]}function Ka(e){return"locator"in e&&e.locator!=null}function y({description:e,execute:t,name:r,schema:n}){let o=Ya.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 v(e){let t=e.specNode==null?[]:ft({node:e.specNode,page:e.page}),r=await he({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 Xa=On.object({selector:On.string().describe("CSS selector for the checkbox or radio button")}),Ln=y({description:"Assert that a checkbox or radio button is checked",name:"assert_checked",schema:Xa,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 v({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 Dn}from"zod";var Qa=Dn.object({selector:Dn.string().describe("CSS selector for the element to check focus on")}),_n=y({description:"Assert that an element has keyboard focus. Use for accessibility tab-order testing.",name:"assert_focused",schema:Qa,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 v({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 ar}from"zod";var Za=ar.object({expected:ar.string().describe("The expected text content"),selector:ar.string().describe("CSS selector for the element to check")}),Un=y({description:"Assert that an element's text content matches the expected value",name:"assert_text",schema:Za,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 v({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 lr}from"zod";var el=lr.object({expected:lr.string().describe("Expected page title or substring"),operator:lr.enum(["equals","contains","startsWith","endsWith"]).describe("Comparison operator").default("contains")}),Vn=y({description:"Assert that the page title matches an expected value",name:"assert_title",schema:el,execute:async(e,t)=>{let r=performance.now(),n=await e.page.title(),o=tl({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 v({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 tl({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 Fn}from"zod";var rl=Fn.object({selector:Fn.string().describe("CSS selector for the element to check")}),Mn=y({description:"Assert that an element matching the selector is visible on the page",name:"assert_visible",schema:rl,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 v({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 Wn}from"zod";var nl=Wn.object({selector:Wn.string().describe("CSS selector for the checkbox to check")}),Hn=y({description:"Check a checkbox matching the CSS selector",name:"check",schema:nl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).check({timeout:5e3}),v({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 qn}from"zod";var ol=qn.object({selector:qn.string().describe("CSS selector for the input to clear")}),Bn=y({description:"Clear the contents of an input field",name:"clear",schema:ol,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).clear({timeout:5e3}),v({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 zn}from"zod";var il=zn.object({selector:zn.string().describe("CSS selector for the element to click")}),Gn=y({description:"Click an element matching the CSS selector",name:"click",schema:il,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({timeout:5e3}),v({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 cr}from"zod";var sl=cr.object({action:cr.enum(["read","write"]).describe("Whether to read from or write to the clipboard"),value:cr.string().optional().describe("Text to write (required for write action)")}),Jn=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 v({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 v({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 gt}from"zod";var Kn=gt.object({summary:gt.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:gt.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.")}),Yn={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:{...gt.toJSONSchema(Kn,{target:"draft-2020-12"}),type:"object"},name:"complete_test"},name:"complete_test",execute(e,t){let r=Kn.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 Xn}from"zod";var al=Xn.object({selector:Xn.string().describe("CSS selector for the element to extract text from")}),Qn=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:al,execute:async(e,t)=>{let r=performance.now(),o=await e.page.locator(t.selector).textContent({timeout:5e3})??"";return v({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 dr}from"zod";var ll=dr.object({selector:dr.string().describe("CSS selector for the input element"),value:dr.string().describe("The text to type into the element")}),Zn=y({description:"Clear and type text into an input element matching the CSS selector",name:"fill",schema:ll,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).fill(t.value,{timeout:5e3}),v({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 eo}from"zod";var cl=eo.object({level:eo.string().describe("Filter by log level: 'error', 'warning', 'log', 'info', 'debug', or 'all'").default("all")}),to=y({description:"Get console log messages from the browser. Optionally filter by level (error, warning, log, info, debug, all).",name:"get_console_logs",schema:cl,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=>dl(o)).join(`
|
|
18
18
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(r.length)} console messages:
|
|
19
|
-
${n}`}}});function
|
|
19
|
+
${n}`}}});function dl(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as ro}from"zod";var ur=50,ul=ro.object({urlFilter:ro.string().describe("Optional regex to filter network entries by URL. Omit to see all.").default("")}),no=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:ul,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(-ur),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
20
|
`),s=n.length>ur?`
|
|
21
21
|
(showing last ${String(ur)} of ${String(n.length)})`:"";return{specNode:void 0,stepResult:void 0,toolOutput:`${String(o.length)} network requests:${s}
|
|
22
|
-
${i}`}}});import{z as
|
|
22
|
+
${i}`}}});import{z as oo}from"zod";var pl=oo.object({urlPattern:oo.string().describe("Regex pattern to match the request URL")}),io=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:pl,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 so}from"zod";var ml=so.object({selector:so.string().optional().describe("CSS selector to scope the tree to a subtree (defaults to full page)")}),ao=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:ml,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 fl}from"zod";var gl=fl.object({}),lo=y({description:"Get a text representation of the current page content for inspection",name:"get_page_content",schema:gl,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 yl}from"zod";var hl=yl.object({}),co=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:hl,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 uo}from"zod";var wl=uo.object({type:uo.enum(["all","cookies","localStorage","sessionStorage"]).describe("Which storage to retrieve").default("all")}),mo=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:wl,execute:async(e,t)=>({specNode:void 0,stepResult:void 0,toolOutput:[...t.type==="all"||t.type==="cookies"?[await bl(e.page)]:[],...t.type==="all"||t.type==="localStorage"?[await po(e.page,"localStorage")]:[],...t.type==="all"||t.type==="sessionStorage"?[await po(e.page,"sessionStorage")]:[]].join(`
|
|
38
38
|
|
|
39
|
-
`)})});async function
|
|
39
|
+
`)})});async function bl(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 pr}from"zod";var
|
|
42
|
+
`)}`}async function po(e,t){let r=await e.evaluate(`JSON.stringify(Object.fromEntries(Object.entries(${t})))`);return`## ${t}
|
|
43
|
+
${String(r)}`}import{z as pr}from"zod";var Sl=pr.object({action:pr.enum(["accept","dismiss"]).describe("Whether to accept or dismiss the dialog"),promptText:pr.string().optional().describe("Text to enter for prompt dialogs")}),fo=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:Sl,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 v({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 go}from"zod";var vl=go.object({selector:go.string().describe("CSS selector for the element to hover over")}),yo=y({description:"Hover over an element matching the CSS selector",name:"hover",schema:vl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).hover({timeout:5e3}),v({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 mr}from"zod";var kl=mr.object({permission:mr.string().describe("Permission name (e.g. geolocation, notifications, camera, clipboard-read)"),state:mr.enum(["granted","prompt"]).describe("Permission state to set")}),ho=y({description:"Set a browser permission state (geolocation, notifications, camera, etc.)",name:"set_permission",schema:kl,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 v({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 wo}from"zod";var Rl=wo.object({url:wo.string().describe("The URL to navigate to")}),bo=y({description:"Navigate the browser to a URL",name:"navigate",schema:Rl,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 v({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 So}from"zod";var xl=So.object({key:So.string().describe("Key to press, e.g. 'Enter', 'Tab', 'Escape'")}),vo=y({description:"Press a keyboard key",name:"press",schema:xl,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 v({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 fr}from"zod";var Pl=fr.object({height:fr.number().int().positive().describe("Viewport height in pixels"),width:fr.number().int().positive().describe("Viewport width in pixels")}),ko=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:Pl,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 v({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 Ro}from"zod";var El=Ro.object({selector:Ro.string().describe("CSS selector for the element to right-click")}),xo=y({description:"Right-click an element to open the context menu",name:"right_click",schema:El,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({button:"right",timeout:5e3}),v({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 Po}from"zod";var Cl=Po.object({pattern:Po.string().describe("Regex pattern to search console log messages")}),Eo=y({description:"Search console log messages for a regex pattern. Returns matching entries.",name:"search_console",schema:Cl,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=>Tl(i)).join(`
|
|
44
44
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(n.length)} matching console messages:
|
|
45
|
-
${o}`}}});function
|
|
45
|
+
${o}`}}});function Tl(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as Co}from"zod";var Al=Co.object({pattern:Co.string().describe("Regex pattern to search across network request URLs and response bodies")}),To=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:Al,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 Ao}from"zod";var $l=20,Il=2,jl=Ao.object({pattern:Ao.string().describe("Regex pattern to search for in the page HTML")}),$o=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:jl,execute:async(e,t)=>{let n=(await e.page.content()).split(`
|
|
48
|
+
`),o=Nl({contextLines:Il,lines:n,maxResults:$l,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 gr}from"zod";var
|
|
52
|
-
${u.stack??""}`)}function c(u){let f=u.failure(),b=new yt(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 yr=[
|
|
53
|
-
`);async function
|
|
50
|
+
`)}}});function Nl({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 gr}from"zod";var Ol=gr.object({selector:gr.string().describe("CSS selector for the select element"),value:gr.string().describe("The option value to select")}),Io=y({description:"Select an option from a dropdown/select element",name:"select",schema:Ol,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).selectOption(t.value,{timeout:5e3}),v({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 jo}from"zod";var Ll=jo.object({selector:jo.string().describe("CSS selector for the checkbox to uncheck")}),No=y({description:"Uncheck a checkbox matching the CSS selector",name:"uncheck",schema:Ll,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).uncheck({timeout:5e3}),v({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 yt=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 Xe(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 yt(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 yt(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 yr=[bo,Gn,Zn,vo,Hn,No,Io,yo,lo,$o,Bn,xo,fo,Jn,ho,Mn,Un,Vn,Ln,_n,to,no,io,co,ao,mo,Eo,To,ko,Qn,Yn],Dl=new Map(yr.map(e=>[e.name,e])),hr=yr.map(e=>e.anthropicTool),Oo=yr.map(e=>`- **${e.name}**: ${e.anthropicTool.description??""}`).join(`
|
|
53
|
+
`);async function Lo({input:e,monitor:t,name:r,page:n,runStartTime:o,stepIndex:i}){let s=Dl.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 MS from"fs";import HS from"path";import _l from"pino";var g=_l({transport:{options:{ignore:"pid,hostname"},target:"pino-pretty"}});var Vl=50,Do=16384;async function wr({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 Ul({apiKey:"ripplo",baseURL:`${s}/api/proxy/anthropic`,defaultHeaders:{Authorization:`Bearer ${c}`,"x-run-id":i}}),f=performance.now(),b=Xe(o);await Gl({baseUrl:e,page:o});let w=Wl({extraVariables:r,spec:a}),h=ql({baseUrl:e,executedPreconditions:t,spec:a,systemPrompt:l,variables:w,workflowContext:d}),S=Bl({baseUrl:e,spec:a,variables:w}),_=[{content:zl({page:o,startUrl:S}),role:"user"}],q=[],j=[],U={findings:"",stepIndex:0,verdict:void 0};U=await Fl({client:u,messages:_,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:j,state:U,steps:q,system:h}),U.verdict==null&&(U=await Ml({client:u,messages:_,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:j,state:U,steps:q,system:h}));let ie=Kl(j);return{findings:U.findings,generatedSpec:ie,monitor:b,steps:q,verdict:U.verdict??"fail"}}function _o({result:e,state:t}){return{findings:e.newFindings.length>0?e.newFindings:t.findings,stepIndex:e.nextStepIndex,verdict:e.verdict??t.verdict}}async function Fl({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<Vl;u++){g.info("Agent iteration %d",u+1);let f=await e.messages.create({max_tokens:Do,messages:t,model:"server-controlled",system:c,tools:hr}),b=await Uo({messages:t,monitor:r,onStep:n,page:o,response:f,runStartTime:i,specNodes:s,stepIndex:d.stepIndex,steps:l});if(d=_o({result:b,state:d}),!b.continueLoop)break}return d}async function Ml({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:Do,messages:t,model:"server-controlled",system:c,tool_choice:{name:"complete_test",type:"tool"},tools:hr}),u=await Uo({messages:t,monitor:r,onStep:n,page:o,response:d,runStartTime:i,specNodes:s,stepIndex:a.stepIndex,steps:l});return _o({result:u,state:a})}function Wl({extraVariables:e,spec:t}){let r=Hl(e,t?.variableNamespaces);return{...Ke({defs:t?.variables}),...r}}function Hl(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 ql({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`,Oo,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 S of d){let C=await
|
|
78
|
-
`);return{continueLoop:b==null&&o.stop_reason==="tool_use",newFindings:h,nextStepIndex:f,verdict:b}}async function
|
|
76
|
+
`)}function Bl({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 zl({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 Gl({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 Uo({messages:e,monitor:t,onStep:r,page:n,response:o,runStartTime:i,specNodes:s,stepIndex:a,steps:l}){let c=o.content.filter(S=>S.type==="text").map(S=>S.text),d=o.content.filter(S=>S.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 S of d){let C=await Jl({block:S,monitor:t,onStep:r,page:n,runStartTime:i,specNodes:s,stepIndex:f,steps:l});u.push(C.toolResult),f=C.nextStepIndex,C.verdict!=null&&(b=C.verdict,w=C.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 Jl({block:e,monitor:t,onStep:r,page:n,runStartTime:o,specNodes:i,stepIndex:s,steps:a}){try{let l=await Lo({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 he({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 Kl(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 br({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.',Yl({hasSuccessCriteria:r!=null&&r.length>0}),Xl({hasOutput:t!=null&&t.length>0})];return n.push(o.join(`
|
|
82
82
|
`)),n.join(`
|
|
83
83
|
|
|
84
|
-
`)}function
|
|
84
|
+
`)}function Yl({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 Xl({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 Ql}from"child_process";import{createRequire as Zl}from"module";import Vo from"fs";import Fo from"path";import{chromium as Mo}from"playwright";async function Pe({headed:e}){process.env.PW_TEST_SCREENSHOT_NO_FONTS_READY="1";try{return await Mo.launch({headless:!e})}catch(t){throw ec(t)?new Error(`Playwright browsers are not installed. Run:
|
|
85
85
|
|
|
86
86
|
npx playwright install chromium
|
|
87
|
-
`):t}}async function Sr(){let e=
|
|
87
|
+
`):t}}async function Sr(){let e=Mo.executablePath();if(Vo.existsSync(e))return;g.info("Chromium not found. Installing via Playwright...");let t=Zl(import.meta.url),r=Fo.dirname(t.resolve("playwright/package.json")),n=Fo.join(r,"cli.js");if(await new Promise((o,i)=>{Ql(process.execPath,[n,"install","chromium"],s=>{if(s!=null){i(new Error(`Playwright install failed: ${s.message}`));return}o()})}),!Vo.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 ec(e){return e instanceof Error?e.message.includes("Executable doesn't exist"):!1}import{mkdir as vr,writeFile as se}from"fs/promises";import J from"path";async function ht({context:e,page:t,runId:r,stepIndex:n,stepResult:o}){try{let i=J.join(process.cwd(),".ripplo","debug",r,"steps",String(n));await vr(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)),tc({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 tc({context:e,page:t,stepDir:r}){let[n,o,i,s]=await Promise.all([t.content().catch(()=>"(unable to capture DOM)"),rc(t),nc({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 rc(e){try{return await e.locator(":root").ariaSnapshot()}catch{return"(unable to capture accessibility tree)"}}async function nc({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 wt({monitor:e,runId:t,steps:r,summary:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await vr(o,{recursive:!0}),await Promise.all([se(J.join(o,"summary.txt"),oc({steps:r,summary:n})),se(J.join(o,"console.log"),ic(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 oc({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 ic(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 Wo({error:e,runId:t,stack:r,workflowName:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await vr(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([
|
|
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 ac}from"fs";import{createRequire as lc}from"module";import Ho from"path";import{gzipSync as cc}from"zlib";var dc=lc(import.meta.url),uc=dc.resolve("rrweb"),pc=Ho.join(Ho.dirname(uc),"rrweb.umd.min.cjs"),mc=ac(pc,"utf8"),fc=[";(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
|
+
`),gc=mc+`
|
|
101
|
+
`+fc;function yc(){return globalThis.__ripploRrwebStartedAt}function hc(){globalThis.__ripploRrwebStart?.()}function wc(){globalThis.__ripploRrwebStop?.()}function bc(){return globalThis.__ripploRrwebDrain?.()??[]}async function bt(e){let t,r=0;async function n(){await e.addScriptTag({content:gc}).catch(()=>{})}await n(),e.on("load",()=>{n()});async function o(){await e.evaluate(hc).catch(()=>{});let l=await e.evaluate(yc).catch(()=>{});typeof l=="number"&&(t??=l)}function i(){if(t!=null)return Date.now()-t}async function s(){let l=await e.evaluate(bc).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:cc(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(wc).catch(()=>{})}return{currentOffsetMs:i,detach:a,start:o,takeChunk:s}}async function kr({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 Pe({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 bt(w);async function S(){let q=await h.takeChunk();q!=null&&l.enqueueRecordingChunk(q)}let C=setInterval(()=>{S()},2e3);await h.start();try{let q=function(le){let Be={...le,recordingEndMs:h.currentOffsetMs(),recordingStartMs:le.recordingStartMs??h.currentOffsetMs()};l.enqueueStep(Be),l.flushSteps(),ht({context:b,page:w,runId:i,stepIndex:Be.stepIndex,stepResult:Be})};var _=q;let j=await wr({baseUrl:e,executedPreconditions:r,extraVariables:n,onStep:q,page:w,runId:i,serverUrl:s,spec:a,systemPrompt:c,token:d,workflowContext:u}),U=j.verdict==="pass"?"passed":"failed";await l.complete({statusOverride:U,steps:j.steps,summary:j.findings});let ie=j.steps.filter(le=>le.status==="passed").length,Te=j.steps.filter(le=>le.status==="failed").length,N={duration:j.steps.reduce((le,Be)=>le+Be.duration,0),failCount:Te,passCount:ie,runId:i,status:U,workflowName:u.name};await wt({monitor:j.monitor,runId:i,steps:j.steps,summary:N}),g.info("Agent test complete: %d passed, %d failed",ie,Te),g.info(`
|
|
103
103
|
=== Agent Summary ===
|
|
104
|
-
%s`,j.findings)}finally{clearInterval(C),await h.detach(),await S(),await f.close()}}async function Rr({expected:e,locator:t,operator:r,timeout:n}){let o=await t.textContent({timeout:n});return
|
|
104
|
+
%s`,j.findings)}finally{clearInterval(C),await h.detach(),await S(),await f.close()}}async function Rr({expected:e,locator:t,operator:r,timeout:n}){let o=await t.textContent({timeout:n});return Qe({actual:o??"",expected:e,label:"Text",operator:r})}function St({expected:e,operator:t,url:r}){return Qe({actual:r,expected:e,label:"URL",operator:t})}async function xr({expected:e,locator:t,operator:r}){let n=await t.count();return Xo({actual:n,expected:e,label:"Count",operator:r})}async function Pr({expected:e,locator:t,operator:r,timeout:n}){let o=await t.inputValue({timeout:n});return Qe({actual:o,expected:e,label:"Value",operator:r})}async function Er({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 Cr({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 qo({attribute:e,expected:t,locator:r,operator:n,timeout:o}){let i=await r.getAttribute(e,{timeout:o});return Qe({actual:i??"",expected:t,label:`Attribute "${e}"`,operator:n})}async function Bo({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 zo({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 Go({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 Jo({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 Ko({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 Yo({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 Qe(e){let t=`${e.label} ${e.operator} "${e.expected}"`,r=Sc(e),n=r?void 0:`Got: "${e.actual}"`;return{description:t,detail:n,status:r?"passed":"failed"}}function Sc({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 Xo(e){let t=`${e.label} ${e.operator} ${String(e.expected)}`,r=vc(e),n=r?void 0:`Got: ${String(e.actual)}`;return{description:t,detail:n,status:r?"passed":"failed"}}function vc({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 Cc,rm as Tc,stat as Ac}from"fs/promises";import Ev from"os";import ei from"path";import{graphql as $c}from"gql.tada";import{print as kc}from"graphql";var Rc=15e3;async function k(e){let t=kc(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(Rc)})}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 xc({res:o,url:n});if(!Pc(i))throw new Error("Invalid GraphQL response");if(Ec(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 xc({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 Pc(e){return typeof e=="object"&&e!=null&&("data"in e||"errors"in e)}function Ec(e){return Array.isArray(e.errors)&&e.errors.length>0}var Qo=ei.join(process.cwd(),".ripplo","debug"),Zo=360*60*1e3,Iv=$c(`
|
|
105
105
|
mutation RevokeCurrentCliToken {
|
|
106
106
|
revokeCurrentCliToken
|
|
107
107
|
}
|
|
108
|
-
`);async function Tr({maxRuns:e}){try{let r=(await
|
|
109
|
-
`))}}import
|
|
110
|
-
`),t}function
|
|
111
|
-
`,{mode:384})}function Lr(){let e=
|
|
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 Dd({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",...Se({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(Id)});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=Od.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 _d({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function ci(e){return`${String(Math.round(performance.now()-e))}ms`}async function Ud(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 Vd=1e4;async function Wr({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return Md({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function Fd({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function Md({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 Wd({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(Fd({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function Wd({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=Vd,u=ft({node:t,page:o});try{let f=await Hd({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(C=>C.status==="failed"),h=await Y({label:`Snapshot [${c}]`,fn:()=>ye({page:o,runStartTime:i,targets:u})}),S=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:S,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:()=>ye({page:o,runStartTime:i,targets:u})}),S=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:S,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function Hd({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(qd(e)){let s=await sr({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await zd({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function qd(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 Bd(e){return e.type.startsWith("assert")}async function zd({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!Bd(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 Kd({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=G({ref:i.expected,variables:o});return[await Rr({expected:s,locator:L({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertUrl":{let s=G({ref:i.expected,variables:o});return[St({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=G({ref:i.expected,variables:o});return[St({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=ir({ref:i.expected,variables:o});return[await xr({expected:s,locator:L({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=G({ref:i.expected,variables:o});return[await Pr({expected:s,locator:L({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=G({ref:i.expected,variables:o});return[await Ho({attribute:i.attribute,expected:s,locator:L({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]=G({ref:l,variables:o})}),[await li({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var Gd={assertChecked:zo,assertDisabled:Bo,assertEnabled:qo,assertFocused:Ko,assertNotChecked:Go,assertNotFocused:Jo,assertNotVisible:Cr,assertVisible:Er};async function Kd({assertNode:e,page:t,timeout:r,variables:n}){let o=Gd[e.type];return[await o({locator:L({locator:e.locator,page:t,variables:n}),timeout:r})]}async function Hr({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=Ye(d),f=await bt(d);async function b(){let N=await f.takeChunk();N!=null&&i?.(N)}let w=setInterval(()=>{b()},2e3),h=[],S=!1;function C(N){s?.(N),S||(S=!0,f.start()),h.push(ht({context:c,page:d,runId:a,stepIndex:N.stepIndex,stepResult:N}))}let D=Jd(n,l.variableNamespaces),q={...Ke({defs:l.variables}),...D};g.info("Starting graph execution (entry: %s)",l.entryNode);let j=await Wr({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:C,page:d,spec:l,variables:q});await Promise.allSettled(h);let U=j.steps.filter(N=>N.status==="passed").length,oe=j.steps.filter(N=>N.status==="failed").length,Te={duration:j.steps.reduce((N,ae)=>N+ae.duration,0),failCount:oe,passCount:U,runId:a,status:oe>0?"failed":"passed",workflowName:""};return await wt({monitor:u,runId:a,steps:j.steps,summary:Te}),clearInterval(w),await f.detach(),await b(),await c.close(),j.steps}function Jd(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 Yd}from"set-cookie-parser";import{z as Z}from"zod";var di=3e4,Xd=Z.object({data:Z.record(Z.string(),Z.record(Z.string(),Z.string())),error:Z.string().optional(),executed:Z.array(Z.string()),runId:Z.string(),success:Z.boolean()});async function qr({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:ui({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function Br({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",...tu({cookies:t}),...Se({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(di)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function ui({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",...Se({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(di)});if(!i.ok){let c=await Zd(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=Xd.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=ru({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 Qd=Z.object({error:Z.string()});async function Zd(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=eu(t),n=r==null?null:Qd.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function eu(e){try{return JSON.parse(e)}catch{return null}}function tu({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function ru({domain:e,res:t}){let r=t.headers.getSetCookie();return Yd(r,{decodeValues:!1}).map(o=>nu({cookie:o,domain:e}))}function nu({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=iu({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 ou={lax:"Lax",none:"None",strict:"Strict"};function iu({raw:e}){return ou[e.toLowerCase()]??"Lax"}async function zr({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:[]}:ui({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as $t}from"gql.tada";async function Gr({agentProfileId:e,config:t,runId:r}){let n=await k({config:t,document:lu,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=au({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=su({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(C=>C.status==="passed").length,w=u.filter(C=>C.status==="failed").length,h=u.reduce((C,D)=>C+D.duration,0),S=d??(w>0?"failed":"passed");await Y({label:"completeRun",fn:()=>k({config:t,document:uu,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:S,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function su({chunk:e,config:t,runResultId:r}){await k({config:t,document:du,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function au({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 k({config:e,document:cu,variables:{runResultId:t,steps:n}})}var lu=$t(`
|
|
108
|
+
`);async function Tr({maxRuns:e}){try{let r=(await Cc(Qo,{withFileTypes:!0})).filter(c=>c.isDirectory()),n=Date.now(),o=await Promise.all(r.map(async c=>{let d=ei.join(Qo,c.name),u=await Ac(d);return{dirPath:d,mtime:u.mtimeMs}})),i=o.filter(c=>n-c.mtime>Zo),a=o.filter(c=>n-c.mtime<=Zo).toSorted((c,d)=>d.mtime-c.mtime).slice(e),l=[...i,...a];if(l.length===0)return;await Promise.allSettled(l.map(c=>Tc(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 Ic=5e3;async function Ar({appUrl:e}){try{await fetch(e,{method:"HEAD",signal:AbortSignal.timeout(Ic)})}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 tt from"fs";import Ee from"fs";import jc from"os";import Ze from"path";var Nc=".local",Oc=".ripplo";function $r(e){return Ze.join(e,".ripplo",Nc)}function Ir(e){let t=$r(e);Ee.existsSync(t)||Ee.mkdirSync(t,{recursive:!0});let r=Ze.join(t,".gitignore");return Ee.existsSync(r)||Ee.writeFileSync(r,`*
|
|
110
|
+
`),t}function et(e,t){return Ze.join($r(e),t)}function jr(){return Ze.join(jc.homedir(),Oc)}function Nr(){let e=jr();return Ee.existsSync(e)?Ee.chmodSync(e,448):Ee.mkdirSync(e,{mode:448,recursive:!0}),e}function we(e){return Ze.join(jr(),e)}function re(){let e=process.env.RIPPLO_TOKEN;if(e!=null&&e.trim().length>0)return e.trim();let t=we("token");if(!tt.existsSync(t))return null;let r=tt.readFileSync(t,"utf8").trim();return r.length===0?null:r}function Or(e){Nr(),tt.writeFileSync(we("token"),e+`
|
|
111
|
+
`,{mode:384})}function Lr(){let e=we("token");return tt.existsSync(e)?(tt.unlinkSync(e),!0):!1}import{z as pe}from"zod";import{z as vt}from"zod";var Lc=vt.object({__codec:vt.string().min(1),data:vt.unknown(),version:vt.number().int().positive()}),kt=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}},Rt=class extends Error{constructor(t){super(`Codec mismatch: expected "${t.expected}", got "${t.got}"`),this.name="CodecMismatchError"}};function xt(e){return ti({legacy:void 0,migrators:[],name:e,schemas:[]})}function ti(e){return{initial:t=>Dr(t,{...e,schemas:[t]}),legacy:t=>ti({...e,legacy:t})}}function Dr(e,t){return{build:()=>Dc(e,t),legacy:r=>Dr(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return Dr(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function Dc(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>_c(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function _c(e,t,r){let{data:n,version:o}=Uc(t,r),i=ri(t,n,o);return e.parse(i)}function Uc(e,t){let r=Lc.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new Rt({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 ri(e,t,r){let n=e.schemas.length;if(r>n)throw new kt({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 ri(e,s(i),r+1)}import{z as si}from"zod";import{z as Ne}from"zod";var _r=Ne.object({depends:Ne.array(Ne.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:Ne.string().min(1).describe("Human-readable description of what this precondition ensures"),returns:Ne.array(Ne.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 be}from"zod";var Vc=be.object({by:be.literal("testId"),value:be.string().min(1)}),Fc=be.object({by:be.literal("role"),name:be.string().optional(),role:be.string().min(1)}),T=be.discriminatedUnion("by",[Vc,Fc]);import{z as ni}from"zod";var Se=ni.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),Pt=ni.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]);import{z as M}from"zod";var Mc=M.object({type:M.literal("static"),value:M.union([M.string(),M.number(),M.boolean()])}),Ur=M.object({name:M.string().min(1),type:M.literal("variable")}),Et=M.discriminatedUnion("type",[Mc,Ur]),K=M.discriminatedUnion("type",[M.object({type:M.literal("static"),value:M.string()}),Ur]),Ct=M.discriminatedUnion("type",[M.object({type:M.literal("static"),value:M.number().int().nonnegative()}),Ur]);import{z as Q}from"zod";var Tt=Q.discriminatedUnion("type",[Q.object({default:Q.string().optional(),type:Q.literal("string")}),Q.object({default:Q.number().optional(),type:Q.literal("number")}),Q.object({default:Q.boolean().optional(),type:Q.literal("boolean")}),Q.object({key:Q.string().min(1),type:Q.literal("env")})]);var x={id:p.string().min(1).max(200),label:p.string().max(500).optional(),next:p.string().max(200).optional(),uiOnly:p.boolean().optional()},oi=500,Wc=p.object({...x,type:p.literal("goto"),url:K}),Hc=p.object({...x,locator:T,type:p.literal("click")}),qc=p.object({...x,locator:T,type:p.literal("fill"),value:K}),Bc=p.object({...x,locator:T,type:p.literal("select"),value:K}),zc=p.object({...x,locator:T,type:p.literal("hover")}),Gc=p.object({...x,key:p.string().min(1),locator:T.optional(),type:p.literal("press")}),Jc=p.object({...x,locator:T,type:p.literal("check")}),Kc=p.object({...x,locator:T,type:p.literal("uncheck")}),Yc=p.object({...x,height:p.number().int().positive(),type:p.literal("setViewport"),width:p.number().int().positive()}),Xc=p.object({...x,message:p.string().min(1),type:p.literal("fail")}),Qc=p.object({...x,type:p.literal("setVariable"),value:Et,variable:p.string().min(1)}),Zc=p.object({...x,locator:T,type:p.literal("extractText"),variable:p.string().min(1)}),ed=p.object({...x,files:p.array(p.string()).min(1),locator:T,type:p.literal("upload")}),td=p.object({...x,locator:T,type:p.literal("dblclick")}),rd=p.object({...x,source:T,target:T,type:p.literal("drag")}),nd=p.object({...x,locator:T,type:p.literal("scrollIntoView")}),od=p.object({...x,locator:T,type:p.literal("type"),value:K}),id=p.object({...x,locator:T,type:p.literal("focus")}),sd=p.object({...x,locator:T,type:p.literal("clear")}),ad=p.object({...x,locator:T,type:p.literal("rightClick")}),ld=p.object({...x,action:p.enum(["accept","dismiss"]),promptText:p.string().optional(),type:p.literal("handleDialog")}),cd=p.object({...x,action:p.enum(["read","write"]),type:p.literal("clipboard"),value:K.optional(),variable:p.string().min(1).optional()}),dd=p.object({...x,permission:p.string().min(1),state:p.enum(["granted","prompt"]),type:p.literal("setPermission")}),ud=p.object({...x,locator:T,type:p.literal("assertVisible")}),pd=p.object({...x,locator:T,type:p.literal("assertNotVisible")}),md=p.object({...x,expected:K,locator:T,operator:Se,type:p.literal("assertText")}),fd=p.object({...x,expected:K,operator:Se,type:p.literal("assertUrl")}),gd=p.object({...x,expected:Ct,locator:T,operator:Pt,type:p.literal("assertCount")}),yd=p.object({...x,expected:K,locator:T,operator:Se,type:p.literal("assertValue")}),hd=p.object({...x,attribute:p.string().min(1),expected:K,locator:T,operator:Se,type:p.literal("assertAttribute")}),wd=p.object({...x,locator:T,type:p.literal("assertEnabled")}),bd=p.object({...x,locator:T,type:p.literal("assertDisabled")}),Sd=p.object({...x,expected:K,operator:Se,type:p.literal("assertTitle")}),vd=p.object({...x,locator:T,type:p.literal("assertChecked")}),kd=p.object({...x,locator:T,type:p.literal("assertNotChecked")}),Rd=p.object({...x,locator:T,type:p.literal("assertFocused")}),xd=p.object({...x,locator:T,type:p.literal("assertNotFocused")}),Pd=p.object({...x,budget:p.enum(["fast","slow","async"]),observer:p.string().min(1).max(200),params:p.record(p.string().max(200),K),type:p.literal("assertObserver")}),ii=p.discriminatedUnion("type",[Wc,Hc,qc,Bc,zc,Gc,Jc,Kc,ud,pd,md,fd,gd,yd,hd,wd,bd,Yc,Xc,Qc,Zc,ed,td,rd,nd,od,id,sd,ad,ld,cd,dd,Sd,vd,kd,Rd,xd,Pd]),At=p.object({entryNode:p.string().min(1).max(200),nodes:p.record(p.string().max(200),ii).refine(e=>Object.keys(e).length<=oi,`Workflow has more than ${String(oi)} nodes`),uiOnly:p.boolean().optional(),variableNamespaces:p.record(p.string().max(200),p.string().max(500)).optional(),variables:p.record(p.string().max(200),Tt).optional()});var Ed=si.record(si.string().max(200),_r),Cd={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},Td={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},Vr=xt("workflow-spec").legacy(Cd).initial(At).build(),Ad=xt("precondition-map").legacy(Td).initial(Ed).build();import{z as Fr}from"zod";var ai=["fast","slow","async"],$d=Fr.object({budget:Fr.enum(ai).describe("Polling budget tier: fast | slow | async"),description:Fr.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 Nt,readFragment as It}from"gql.tada";import{z as ne}from"zod";import li from"crypto";import{Webhook as Id}from"standardwebhooks";function ve({body:e,secret:t}){let r=new Id(t),n=`msg_${li.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 Mr(){return`whsec_${li.randomBytes(24).toString("base64")}`}var jd=15e4,Nd={async:{backoffMs:[500,1e3,2e3,5e3],timeoutMs:12e4},fast:{backoffMs:[100,250,500,1e3],timeoutMs:5e3},slow:{backoffMs:[250,500,1e3,2e3],timeoutMs:3e4}},Od=ne.discriminatedUnion("kind",[ne.object({kind:ne.literal("pass")}),ne.object({kind:ne.literal("retry"),reason:ne.string()}),ne.object({kind:ne.literal("fail"),reason:ne.string()})]),Ld=ne.object({error:ne.string().optional(),outcome:Od.optional(),success:ne.boolean()});async function ci({apiUrl:e,budget:t,observer:r,params:n,webhookSecret:o}){let i=Nd[t],s=performance.now(),a={lastReason:void 0,pollCount:0};for(;performance.now()-s<i.timeoutMs;){a.pollCount+=1;let l=await _d({apiUrl:e,observer:r,params:n,webhookSecret:o}),c=Dd({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(Ud({backoff:i.backoffMs,pollCount:a.pollCount}),d);await Vd(u)}return{description:`observer "${r}"`,detail:`budget "${t}" exhausted after ${String(a.pollCount)} poll(s) (${di(s)}); last: ${a.lastReason??"no retry reason"}
|
|
112
|
+
\u2192 /ripplo:debug \u2014 check .ripplo/debug/<runId>/ artifacts`,status:"failed"}}function Dd({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 (${di(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 _d({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",...ve({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(jd)});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=Ld.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 Ud({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function di(e){return`${String(Math.round(performance.now()-e))}ms`}async function Vd(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 Fd=1e4;async function Wr({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return Wd({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function Md({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function Wd({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 Hd({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(Md({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function Hd({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=Fd,u=ft({node:t,page:o});try{let f=await qd({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(C=>C.status==="failed"),h=await Y({label:`Snapshot [${c}]`,fn:()=>he({page:o,runStartTime:i,targets:u})}),S=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:S,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:()=>he({page:o,runStartTime:i,targets:u})}),S=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:S,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function qd({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(Bd(e)){let s=await sr({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await Gd({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function Bd(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 zd(e){return e.type.startsWith("assert")}async function Gd({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!zd(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 Kd({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=G({ref:i.expected,variables:o});return[await Rr({expected:s,locator:D({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertUrl":{let s=G({ref:i.expected,variables:o});return[St({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=G({ref:i.expected,variables:o});return[St({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=ir({ref:i.expected,variables:o});return[await xr({expected:s,locator:D({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=G({ref:i.expected,variables:o});return[await Pr({expected:s,locator:D({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=G({ref:i.expected,variables:o});return[await qo({attribute:i.attribute,expected:s,locator:D({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]=G({ref:l,variables:o})}),[await ci({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var Jd={assertChecked:Go,assertDisabled:zo,assertEnabled:Bo,assertFocused:Ko,assertNotChecked:Jo,assertNotFocused:Yo,assertNotVisible:Cr,assertVisible:Er};async function Kd({assertNode:e,page:t,timeout:r,variables:n}){let o=Jd[e.type];return[await o({locator:D({locator:e.locator,page:t,variables:n}),timeout:r})]}async function Hr({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=Xe(d),f=await bt(d);async function b(){let N=await f.takeChunk();N!=null&&i?.(N)}let w=setInterval(()=>{b()},2e3),h=[],S=!1;function C(N){s?.(N),S||(S=!0,f.start()),h.push(ht({context:c,page:d,runId:a,stepIndex:N.stepIndex,stepResult:N}))}let _=Yd(n,l.variableNamespaces),q={...Ke({defs:l.variables}),..._};g.info("Starting graph execution (entry: %s)",l.entryNode);let j=await Wr({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:C,page:d,spec:l,variables:q});await Promise.allSettled(h);let U=j.steps.filter(N=>N.status==="passed").length,ie=j.steps.filter(N=>N.status==="failed").length,Te={duration:j.steps.reduce((N,le)=>N+le.duration,0),failCount:ie,passCount:U,runId:a,status:ie>0?"failed":"passed",workflowName:""};return await wt({monitor:u,runId:a,steps:j.steps,summary:Te}),clearInterval(w),await f.detach(),await b(),await c.close(),j.steps}function Yd(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 Xd}from"set-cookie-parser";import{z as Z}from"zod";var ui=3e4,Qd=Z.object({data:Z.record(Z.string(),Z.record(Z.string(),Z.string())),error:Z.string().optional(),executed:Z.array(Z.string()),runId:Z.string(),success:Z.boolean()});async function qr({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:pi({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function Br({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",...ru({cookies:t}),...ve({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(ui)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function pi({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",...ve({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(ui)});if(!i.ok){let c=await eu(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=Qd.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=nu({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 Zd=Z.object({error:Z.string()});async function eu(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=tu(t),n=r==null?null:Zd.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function tu(e){try{return JSON.parse(e)}catch{return null}}function ru({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function nu({domain:e,res:t}){let r=t.headers.getSetCookie();return Xd(r,{decodeValues:!1}).map(o=>ou({cookie:o,domain:e}))}function ou({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 iu={lax:"Lax",none:"None",strict:"Strict"};function su({raw:e}){return iu[e.toLowerCase()]??"Lax"}async function zr({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:[]}:pi({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as $t}from"gql.tada";async function Gr({agentProfileId:e,config:t,runId:r}){let n=await k({config:t,document:cu,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=lu({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=au({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(C=>C.status==="passed").length,w=u.filter(C=>C.status==="failed").length,h=u.reduce((C,_)=>C+_.duration,0),S=d??(w>0?"failed":"passed");await Y({label:"completeRun",fn:()=>k({config:t,document:pu,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:S,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function au({chunk:e,config:t,runResultId:r}){await k({config:t,document:uu,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function lu({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 k({config:e,document:du,variables:{runResultId:t,steps:n}})}var cu=$t(`
|
|
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
|
+
`),du=$t(`
|
|
121
121
|
mutation SubmitRunStepsCLI($runResultId: String!, $steps: [StepInput!]!) {
|
|
122
122
|
submitRunSteps(runResultId: $runResultId, steps: $steps)
|
|
123
123
|
}
|
|
124
|
-
`),
|
|
124
|
+
`),uu=$t(`
|
|
125
125
|
mutation SubmitRunRecordingChunkCLI($input: SubmitRunRecordingChunkInput!) {
|
|
126
126
|
submitRunRecordingChunk(input: $input)
|
|
127
127
|
}
|
|
128
|
-
`),
|
|
128
|
+
`),pu=$t(`
|
|
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 mu=12e4,jt=Nt(`
|
|
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
|
+
`),mi=Nt(`
|
|
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
|
-
`,[jt]),
|
|
172
|
+
`,[jt]),fu=Nt(`
|
|
173
173
|
query ProjectRun($projectId: String!) {
|
|
174
174
|
project(id: $projectId) {
|
|
175
175
|
...ProjectRun
|
|
176
176
|
}
|
|
177
177
|
}
|
|
178
|
-
`,[
|
|
178
|
+
`,[mi]),gu=Nt(`
|
|
179
179
|
query AgentProfileRun($id: String!) {
|
|
180
180
|
agentProfile(id: $id) {
|
|
181
181
|
id
|
|
@@ -185,20 +185,30 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
185
185
|
successCriteria
|
|
186
186
|
}
|
|
187
187
|
}
|
|
188
|
-
`);async function
|
|
189
|
-
query
|
|
190
|
-
|
|
188
|
+
`);async function Jr({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=yu({externalBrowser:n,headed:i});let w=s==null?void 0:Y({label:"Preconditions resolved",fn:()=>zr({engineBaseUrl:o.engineUrl,preconditionNames:s,webhookSecret:l})}),[{project:h,workflow:S},C]=await Promise.all([Y({label:"Run context resolved",fn:()=>Ru({config:o,workflowId:c})}),Y({label:"Streaming run started",fn:()=>Gr({agentProfileId:t,config:o,runId:a})}),Ar({appUrl:r})]);d=S.name,u=C;let _=Pu(S.spec);g.info("Executing workflow: %s",S.name),await Tu(wu({agentProfileDescription:e,agentProfileId:t,baseUrl:r,browserPromise:f,config:o,headed:i,ownsBrowser:b,preconditionPromise:w,project:h,runId:a,specData:_,streaming:u,webhookSecret:l,workflow:S}),Cu())}catch(w){throw await hu({browserPromise:f,error:w,ownsBrowser:b,runId:a,streaming:u,workflowName:d}),w}}function yu({externalBrowser:e,headed:t}){return e!=null?Promise.resolve(e):Y({label:"Browser launched",fn:()=>Pe({headed:t})})}async function hu({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 Wo({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 wu({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:()=>qr({project:vu(l),webhookSecret:f,workflowSlug:b.slug})}),[h,S]=await Promise.all([w,n]);if(t!=null){s&&await S.close(),await bu({agentProfileDescription:e,agentProfileId:t,baseUrl:r,config:o,headed:i,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f,workflow:b});return}await ku({baseUrl:r,browser:S,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f})}async function bu({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 xu({config:n,profileId:t});await kr({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 fi({preconditionResult:i,webhookSecret:c})}var Su=pe.object({preconditions:pe.array(pe.string()),requiresKeys:pe.array(pe.object({namespace:pe.string(),preconditionName:pe.string()})),slug:pe.string()});function vu(e){let t=(e.workflows??[]).map(r=>{let n=It(jt,r);return Su.parse(n)});return{engineBaseUrl:e.engineBaseUrl,workflows:t}}async function ku({baseUrl:e,browser:t,preconditionResult:r,runId:n,specData:o,streaming:i,webhookSecret:s}){let a=await Y({label:"Spec executed",fn:()=>Hr({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 fi({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 fi({preconditionResult:e,webhookSecret:t}){e.apiUrl!=null&&await Br({apiUrl:e.apiUrl,cookies:e.cookies,data:e.data,executed:e.executed,webhookSecret:t})}async function Ru({config:e,workflowId:t}){let r=await k({config:e,document:fu,variables:{projectId:e.projectId}});if(r.project==null)throw new Error("Project not found");let o={...It(mi,r.project),...e.engineUrl.length>0?{engineBaseUrl:e.engineUrl}:{}},s=(o.workflows??[]).find(l=>It(jt,l).id===t);if(s==null)throw new Error(`Workflow ${t} not found`);let a=It(jt,s);return{project:o,workflow:a}}async function xu({config:e,profileId:t}){let r=await k({config:e,document:gu,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),br({description:o,output:n.output??void 0,successCriteria:n.successCriteria??void 0})}function Pu(e){if(e==null)throw new Error("Workflow has no spec");return Vr.decode(e)}var Eu=pe.coerce.number().int().positive().catch(mu);function Cu(){return Eu.parse(process.env.RIPPLO_RUN_TIMEOUT_MS)}async function Tu(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 Ou}from"child_process";import{createAuthClient as Au}from"better-auth/client";import{deviceAuthorizationClient as $u}from"better-auth/client/plugins";function gi({baseURL:e}){return Au({baseURL:e,fetchOptions:{headers:{"User-Agent":"Ripplo CLI"}},plugins:[$u()]})}import{z as yi}from"zod";var Iu="https://ripplo.ai",ju={dev:"https://ripplo-dev.up.railway.app"};function me(){let e=process.argv.findIndex(o=>o.startsWith("--env"));if(e===-1)return rt().RIPPLO_SERVER_URL;let t=process.argv[e];if(t==null)return rt().RIPPLO_SERVER_URL;let r=t.includes("=")?t.split("=")[1]:process.argv[e+1];if(r==null)return rt().RIPPLO_SERVER_URL;let n=ju[r];if(n==null)throw new Error(`Unknown env "${r}". Use "dev" \u2014 or set RIPPLO_SERVER_URL.`);return n}var Nu=yi.object({RIPPLO_SERVER_URL:yi.string().min(1).default(Iu)}),hi;function rt(){return hi??=Nu.parse(process.env),hi}var Lu=5e3,wi="ripplo-cli";async function bi({onDeviceCode:e,url:t}){let r=t??rt().RIPPLO_SERVER_URL,n=gi({baseURL:r}),o=await n.device.code({client_id:wi});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}),Mu(a);let l=await Du({authClient:n,deviceCode:i});return Or(l),l}async function Du({authClient:e,deviceCode:t}){for(;;){await Vu(Lu);let r=await e.device.token({client_id:wi,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(!Uu(r.error.error))throw new Error(`Authorization failed: ${r.error.error_description}`)}}var _u=new Set(["authorization_pending","slow_down"]);function Uu(e){return _u.has(e)}function Vu(e){return new Promise(t=>{setTimeout(t,e)})}function Fu(){return process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open"}function Mu(e){let t=Fu();Ou(`${t} "${e}"`,()=>{})}function Oe({serverUrl:e,token:t}){return{appUrl:"",cwd:process.cwd(),engineUrl:"",projectId:"",ripploServerUrl:e,token:t,webhookSecret:""}}import Wu from"fs";import Hu from"path";function O(e){return Wu.existsSync(Hu.join(e,".ripplo"))}var Bu=qu(`
|
|
189
|
+
query AuthViewer {
|
|
190
|
+
currentUser {
|
|
191
|
+
name
|
|
192
|
+
email
|
|
193
|
+
}
|
|
191
194
|
}
|
|
192
|
-
`);async function Si(){let e=
|
|
193
|
-
`);return}process.stdout.write(`
|
|
194
|
-
|
|
195
|
-
`)}
|
|
196
|
-
`)
|
|
197
|
-
`)
|
|
198
|
-
|
|
199
|
-
`)
|
|
200
|
-
`)}
|
|
201
|
-
`}async function Lt({cwd:e}){let t=Xr.join(e,ce),r=await Xp(t);return r==null?null:zu($i,r)}async function de({cwd:e,result:t}){let r=Ii(t),n=Xr.join(e,ce);await Yr.mkdir(Xr.dirname(n),{recursive:!0}),await Yr.writeFile(n,Zr(r),"utf8")}function Dt({compiled:e,existing:t}){if(t==null)return"missing";let r=Zr(Ii(e)),n=Zr(t);return r===n?"match":"stale"}async function Xp(e){try{return await Yr.readFile(e,"utf8")}catch(t){if(Qp(t)&&t.code==="ENOENT")return null;throw t}}function Qp(e){return e instanceof Error&&"code"in e}function Zp(e){return function(r,n){return n===e||!em(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function em(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import Vt from"fs";import sn from"path";var rn=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],ke=["**/*.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 ji(e){return e.data}function Ni(e){return{as(t){return{data:{label:t,node:e}}}}}function _t(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();tm(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=>rm(a,t));return{observers:i,preconditions:o,tests:s}}function tm(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 rm(e,t){let r=e.id,{accessedKeys:n,vars:o}=om(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[nm(i),...s],l=im(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=am(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 nm(e){return Ni({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function om(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 im(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]=sm(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 sm(e,t,r){let{label:n,node:o}=ji(e);return{...o,id:t,label:n,next:r}}function am(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 Dx,WebhookVerificationError as _x}from"standardwebhooks";import{z as $}from"zod";var Vx=$.object({preconditions:$.array($.string().min(1))}),Fx=$.object({data:$.record($.string(),$.record($.string(),$.string())),preconditions:$.array($.string().min(1))}),Mx=$.object({observer:$.string().min(1).max(200),params:$.record($.string().max(200),$.string())}),lm=$.discriminatedUnion("kind",[$.object({kind:$.literal("pass")}),$.object({kind:$.literal("retry"),reason:$.string()}),$.object({kind:$.literal("fail"),reason:$.string()})]),Wx=$.object({error:$.string().optional(),outcome:lm.optional(),success:$.boolean()});function Le(e){let t=[];return e.tests.forEach(r=>{let n=cm(r),o=i=>{t.push({...i,test:r.slug})};Im.forEach(i=>{i(n,r,o)})}),{diagnostics:t}}function cm(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 dm(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 um(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&Li(o.value)){let i=o.value.value;!Di(i)&&wm(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 pm(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 mm(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 fm(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 gm(e,t,r){let n=0;e.forEach(o=>{De(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 ym(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!De(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 hm(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function Li(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Di(e){return e.includes("{{")}function wm(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function De(e){return e.type.startsWith("assert")}var bm=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function Sm(e){return bm.has(e.type)}function vm(e,t,r){!t.implemented||e.length===0||e.some(n=>De(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function km(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>De(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 nn(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 Rm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=nn(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&nn(c)===i)==null||s.some(c=>Sm(c)||De(c)&&nn(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 xm=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 on(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!xm.has(t))}function Pm(e){let t=e.label==null?[]:on(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,...on(n)]}function Em(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(on(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>De(s));if(o.length===0)return;o.some(s=>Pm(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 Cm=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function Oi(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 Cm.test(r)}function Tm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!Oi(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>Oi(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 Am(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])=>Li(a)&&Di(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 $m(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 Im=[dm,um,$m,pm,mm,fm,gm,ym,hm,vm,km,Rm,Em,Tm,Am];import rf from"picomatch";import{execFileSync as jm,spawnSync as Nm}from"child_process";function ne(e,t){return jm("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function _i(e,t){let r=Nm("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 Ui from"remeda";var Vi=[["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"]],Om=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Lm=[[/(?:^|[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 Ut({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>Dm({filePath:e,sf:r,stmt:n}))}function Dm({filePath:e,sf:t,stmt:r}){let n=Um(r);if(n==null||_m(n))return[];let o=Fi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Ui.uniqueBy(o,i=>i.id)}function _m(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function Um(e){if(R.isExportAssignment(e))return Vm(e.expression);if(!Fm(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 Vm(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function Fm(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function Fi(e,t){let r=Mm(e,t),n=e.getChildren(t).flatMap(o=>Fi(o,t));return r==null?n:[r,...n]}function Mm(e,t){let r=Wm(e);if(r==null)return null;let n=Hm(r);if(n==null)return null;let o=Km(r,n);return o==null?null:{kind:n,label:o,line:tf(t,e.getStart(t))}}function Wm(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 Hm({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Om.get(r)??null:Bm(t,e)??zm(t)??Gm(e)}var qm=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 Bm(e,t){return qm.get(e)?.(t)??null}function zm(e){return/^[A-Z]/.test(e)?Lm.find(([t])=>t.test(e))?.[1]??null:null}function Gm(e){return Vi.find(([t])=>Xm(e,t))?.[1]??null}function Km({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")??(Jm(r)?void 0:ef(t))??Ym(e,n)}function Jm(e){return e==="input"||e==="textarea"||e==="select"}function Ym(e,t){let r=Vi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=Qm(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return Mi(n.body)}}function Mi(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,Mi)}function Xm(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function Wi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=Wi(e,t);return r==null?void 0:Zm(r.initializer)}function Qm(e,t){let r=Wi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function Zm(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return qi(e.expression)}function ef(e){let t=e.flatMap(r=>Hi(r)).join(" ").trim();return t.length===0?void 0:t}function Hi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=qi(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>Hi(t)):[]}function qi(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 tf(e,t){return e.getLineAndCharacterOfPosition(t).line+1}var nf=sn.join(".ripplo","coverage.d.ts");function _e({cwd:e}){of({cwd:e,ignorePaths:ke})}function of({cwd:e,ignorePaths:t}){let r=Ue({cwd:e,ignorePaths:t});lf({content:af(r),cwd:e})}function Ue({cwd:e,ignorePaths:t}){let n=sf({cwd:e,ignorePaths:t}).flatMap(o=>an({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function sf({cwd:e,ignorePaths:t}){let r=ne(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=rf([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o))}function an({cwd:e,file:t}){let r=Vt.readFileSync(sn.join(e,t),"utf8");return Ut({filePath:t,source:r}).map(n=>n.id)}function af(e){let t=`// GENERATED \u2014 do not edit
|
|
195
|
+
`);async function Si(){let e=me(),t=re();if(t!=null){let s=await Kr({serverUrl:e,token:t});if(s!=null){process.stdout.write(`Already signed in as ${s.email}. Run \`ripplo auth logout\` to switch.
|
|
196
|
+
`);return}process.stdout.write(`Your saved session expired \u2014 let's sign you back in.
|
|
197
|
+
|
|
198
|
+
`)}let r=await bi({url:e,onDeviceCode:s=>{process.stdout.write(`Opening your browser to finish sign-in.
|
|
199
|
+
`),process.stdout.write(`If it didn't open, visit: ${s.verificationUrl}
|
|
200
|
+
`),process.stdout.write(`Verification code: ${s.userCode}
|
|
201
|
+
|
|
202
|
+
`),process.stdout.write(`Waiting for you to approve...
|
|
203
|
+
`)}}),n=await Kr({serverUrl:e,token:r}),o=O(process.cwd()),i=o?"Welcome back":"Welcome to Ripplo";process.stdout.write(`
|
|
204
|
+
`),process.stdout.write(n==null?`${i}.
|
|
205
|
+
`:`${i}, ${zu(n)}.
|
|
206
|
+
`),process.stdout.write(`Session saved to ${we("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 zu(e){let t=e.name.trim().split(/\s+/)[0];return t!=null&&t.length>0?t:e.email}async function Kr({serverUrl:e,token:t}){try{let n=(await k({config:Oe({serverUrl:e,token:t}),document:Bu,variables:void 0})).currentUser;return n==null?null:{email:n.email,name:n.name}}catch{return null}}async function vi(){let e=re();e==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login`.\n"),process.exit(1));let t=me(),r=await Kr({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 ki(){if(!Lr()){process.stdout.write(`No token to remove.
|
|
209
|
+
`);return}process.stdout.write(`Removed ${we("token")}
|
|
210
|
+
`)}import Xr from"fs/promises";import Qr from"path";import{z as Ot}from"zod";import{z as Ri}from"zod";import{z as Le}from"zod";import{z as m}from"zod";import{z as ke}from"zod";import{z as Ti}from"zod";import{z as W}from"zod";import{z as ee}from"zod";import{z as Yr}from"zod";import{z as B}from"zod";var Gu=Ot.object({__codec:Ot.string().min(1),data:Ot.unknown(),version:Ot.number().int().positive()}),Ju=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}},Ku=class extends Error{constructor(e){super(`Codec mismatch: expected "${e.expected}", got "${e.got}"`),this.name="CodecMismatchError"}};function tn(e){return Pi({legacy:void 0,migrators:[],name:e,schemas:[]})}function Yu(e,t){let r=JSON.parse(t);return e.decode(r)}function Pi(e){return{initial:t=>Zr(t,{...e,schemas:[t]}),legacy:t=>Pi({...e,legacy:t})}}function Zr(e,t){return{build:()=>Xu(e,t),legacy:r=>Zr(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return Zr(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function Xu(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>Qu(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function Qu(e,t,r){let{data:n,version:o}=Zu(t,r),i=Ei(t,n,o);return e.parse(i)}function Zu(e,t){let r=Gu.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new Ku({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 Ei(e,t,r){let n=e.schemas.length;if(r>n)throw new Ju({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 Ei(e,s(i),r+1)}var Ci=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."),ep=ke.object({by:ke.literal("testId"),value:ke.string().min(1)}),tp=ke.object({by:ke.literal("role"),name:ke.string().optional(),role:ke.string().min(1)}),A=ke.discriminatedUnion("by",[ep,tp]),nt=Ti.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),rp=Ti.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]),np=W.object({type:W.literal("static"),value:W.union([W.string(),W.number(),W.boolean()])}),rn=W.object({name:W.string().min(1),type:W.literal("variable")}),op=W.discriminatedUnion("type",[np,rn]),ae=W.discriminatedUnion("type",[W.object({type:W.literal("static"),value:W.string()}),rn]),ip=W.discriminatedUnion("type",[W.object({type:W.literal("static"),value:W.number().int().nonnegative()}),rn]),sp=ee.discriminatedUnion("type",[ee.object({default:ee.string().optional(),type:ee.literal("string")}),ee.object({default:ee.number().optional(),type:ee.literal("number")}),ee.object({default:ee.boolean().optional(),type:ee.literal("boolean")}),ee.object({key:ee.string().min(1),type:ee.literal("env")})]),P={id:m.string().min(1).max(200),label:m.string().max(500).optional(),next:m.string().max(200).optional(),uiOnly:m.boolean().optional()},xi=500,ap=m.object({...P,type:m.literal("goto"),url:ae}),lp=m.object({...P,locator:A,type:m.literal("click")}),cp=m.object({...P,locator:A,type:m.literal("fill"),value:ae}),dp=m.object({...P,locator:A,type:m.literal("select"),value:ae}),up=m.object({...P,locator:A,type:m.literal("hover")}),pp=m.object({...P,key:m.string().min(1),locator:A.optional(),type:m.literal("press")}),mp=m.object({...P,locator:A,type:m.literal("check")}),fp=m.object({...P,locator:A,type:m.literal("uncheck")}),gp=m.object({...P,height:m.number().int().positive(),type:m.literal("setViewport"),width:m.number().int().positive()}),yp=m.object({...P,message:m.string().min(1),type:m.literal("fail")}),hp=m.object({...P,type:m.literal("setVariable"),value:op,variable:m.string().min(1)}),wp=m.object({...P,locator:A,type:m.literal("extractText"),variable:m.string().min(1)}),bp=m.object({...P,files:m.array(m.string()).min(1),locator:A,type:m.literal("upload")}),Sp=m.object({...P,locator:A,type:m.literal("dblclick")}),vp=m.object({...P,source:A,target:A,type:m.literal("drag")}),kp=m.object({...P,locator:A,type:m.literal("scrollIntoView")}),Rp=m.object({...P,locator:A,type:m.literal("type"),value:ae}),xp=m.object({...P,locator:A,type:m.literal("focus")}),Pp=m.object({...P,locator:A,type:m.literal("clear")}),Ep=m.object({...P,locator:A,type:m.literal("rightClick")}),Cp=m.object({...P,action:m.enum(["accept","dismiss"]),promptText:m.string().optional(),type:m.literal("handleDialog")}),Tp=m.object({...P,action:m.enum(["read","write"]),type:m.literal("clipboard"),value:ae.optional(),variable:m.string().min(1).optional()}),Ap=m.object({...P,permission:m.string().min(1),state:m.enum(["granted","prompt"]),type:m.literal("setPermission")}),$p=m.object({...P,locator:A,type:m.literal("assertVisible")}),Ip=m.object({...P,locator:A,type:m.literal("assertNotVisible")}),jp=m.object({...P,expected:ae,locator:A,operator:nt,type:m.literal("assertText")}),Np=m.object({...P,expected:ae,operator:nt,type:m.literal("assertUrl")}),Op=m.object({...P,expected:ip,locator:A,operator:rp,type:m.literal("assertCount")}),Lp=m.object({...P,expected:ae,locator:A,operator:nt,type:m.literal("assertValue")}),Dp=m.object({...P,attribute:m.string().min(1),expected:ae,locator:A,operator:nt,type:m.literal("assertAttribute")}),_p=m.object({...P,locator:A,type:m.literal("assertEnabled")}),Up=m.object({...P,locator:A,type:m.literal("assertDisabled")}),Vp=m.object({...P,expected:ae,operator:nt,type:m.literal("assertTitle")}),Fp=m.object({...P,locator:A,type:m.literal("assertChecked")}),Mp=m.object({...P,locator:A,type:m.literal("assertNotChecked")}),Wp=m.object({...P,locator:A,type:m.literal("assertFocused")}),Hp=m.object({...P,locator:A,type:m.literal("assertNotFocused")}),qp=m.object({...P,budget:m.enum(["fast","slow","async"]),observer:m.string().min(1).max(200),params:m.record(m.string().max(200),ae),type:m.literal("assertObserver")}),Bp=m.discriminatedUnion("type",[ap,lp,cp,dp,up,pp,mp,fp,$p,Ip,jp,Np,Op,Lp,Dp,_p,Up,gp,yp,hp,wp,bp,Sp,vp,kp,Rp,xp,Pp,Ep,Cp,Tp,Ap,Vp,Fp,Mp,Wp,Hp,qp]),Ai=m.object({entryNode:m.string().min(1).max(200),nodes:m.record(m.string().max(200),Bp).refine(e=>Object.keys(e).length<=xi,`Workflow has more than ${String(xi)} 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()}),zp=Ri.record(Ri.string().max(200),Ci),Gp={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},Jp={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},Nx=tn("workflow-spec").legacy(Gp).initial(Ai).build(),Ox=tn("precondition-map").legacy(Jp).initial(zp).build(),Kp=["fast","slow","async"],Yp=Yr.object({budget:Yr.enum(Kp).describe("Polling budget tier: fast | slow | async"),description:Yr.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",Xp=5e3,Qp=B.record(B.string().max(200),B.string().max(200)),Zp=B.object({coverage:B.array(B.string().max(500)).max(2e3).default([]),expectedOutcome:B.string().max(2e3),name:B.string().max(200),preconditions:B.array(B.string().max(200)).max(1e3),requiresKeys:Qp,slug:B.string().max(200),spec:Ai}),em=B.object({observers:B.record(B.string().max(200),Yp),preconditions:B.record(B.string().max(200),Ci),tests:B.array(Zp).max(Xp)}),$i=tn("ripplo-lockfile").initial(em).build();function Ii(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 en(e){let t=$i.encode(e);return`${JSON.stringify(t,nm(t),2)}
|
|
211
|
+
`}async function Lt({cwd:e}){let t=Qr.join(e,ce),r=await tm(t);return r==null?null:Yu($i,r)}async function de({cwd:e,result:t}){let r=Ii(t),n=Qr.join(e,ce);await Xr.mkdir(Qr.dirname(n),{recursive:!0}),await Xr.writeFile(n,en(r),"utf8")}function Dt({compiled:e,existing:t}){if(t==null)return"missing";let r=en(Ii(e)),n=en(t);return r===n?"match":"stale"}async function tm(e){try{return await Xr.readFile(e,"utf8")}catch(t){if(rm(t)&&t.code==="ENOENT")return null;throw t}}function rm(e){return e instanceof Error&&"code"in e}function nm(e){return function(r,n){return n===e||!om(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function om(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import Vt from"fs";import an from"path";var nn=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],Re=["**/*.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 ji(e){return e.data}function Ni(e){return{as(t){return{data:{label:t,node:e}}}}}function _t(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();im(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 im(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}=lm(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[am(i),...s],l=cm(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=um(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 am(e){return Ni({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function lm(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 cm(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]=dm(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 dm(e,t,r){let{label:n,node:o}=ji(e);return{...o,id:t,label:n,next:r}}function um(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 Bx,WebhookVerificationError as zx}from"standardwebhooks";import{z as $}from"zod";var Jx=$.object({preconditions:$.array($.string().min(1))}),Kx=$.object({data:$.record($.string(),$.record($.string(),$.string())),preconditions:$.array($.string().min(1))}),Yx=$.object({observer:$.string().min(1).max(200),params:$.record($.string().max(200),$.string())}),pm=$.discriminatedUnion("kind",[$.object({kind:$.literal("pass")}),$.object({kind:$.literal("retry"),reason:$.string()}),$.object({kind:$.literal("fail"),reason:$.string()})]),Xx=$.object({error:$.string().optional(),outcome:pm.optional(),success:$.boolean()});function De(e){let t=[];return e.tests.forEach(r=>{let n=mm(r),o=i=>{t.push({...i,test:r.slug})};Lm.forEach(i=>{i(n,r,o)})}),{diagnostics:t}}function mm(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 fm(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 gm(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&Li(o.value)){let i=o.value.value;!Di(i)&&km(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 ym(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 hm(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 wm(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 bm(e,t,r){let n=0;e.forEach(o=>{_e(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 Sm(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!_e(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 vm(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function Li(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Di(e){return e.includes("{{")}function km(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function _e(e){return e.type.startsWith("assert")}var Rm=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function xm(e){return Rm.has(e.type)}function Pm(e,t,r){!t.implemented||e.length===0||e.some(n=>_e(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function Em(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>_e(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 on(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 Cm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=on(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&on(c)===i)==null||s.some(c=>xm(c)||_e(c)&&on(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 Tm=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 sn(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!Tm.has(t))}function Am(e){let t=e.label==null?[]:sn(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,...sn(n)]}function $m(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(sn(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>_e(s));if(o.length===0)return;o.some(s=>Am(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 Im=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function Oi(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 Im.test(r)}function jm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!Oi(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>Oi(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 Nm(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])=>Li(a)&&Di(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 Om(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 Lm=[fm,gm,Om,ym,hm,wm,bm,Sm,vm,Pm,Em,Cm,$m,jm,Nm];import af from"picomatch";import{execFileSync as Dm,spawnSync as _m}from"child_process";function oe(e,t){return Dm("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function _i(e,t){let r=_m("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 Ui from"remeda";var Vi=[["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"]],Um=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Vm=[[/(?:^|[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 Ut({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>Fm({filePath:e,sf:r,stmt:n}))}function Fm({filePath:e,sf:t,stmt:r}){let n=Wm(r);if(n==null||Mm(n))return[];let o=Fi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Ui.uniqueBy(o,i=>i.id)}function Mm(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function Wm(e){if(R.isExportAssignment(e))return Hm(e.expression);if(!qm(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 Hm(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function qm(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function Fi(e,t){let r=Bm(e,t),n=e.getChildren(t).flatMap(o=>Fi(o,t));return r==null?n:[r,...n]}function Bm(e,t){let r=zm(e);if(r==null)return null;let n=Gm(r);if(n==null)return null;let o=Qm(r,n);return o==null?null:{kind:n,label:o,line:sf(t,e.getStart(t))}}function zm(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 Gm({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Um.get(r)??null:Km(t,e)??Ym(t)??Xm(e)}var Jm=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 Km(e,t){return Jm.get(e)?.(t)??null}function Ym(e){return/^[A-Z]/.test(e)?Vm.find(([t])=>t.test(e))?.[1]??null:null}function Xm(e){return Vi.find(([t])=>tf(e,t))?.[1]??null}function Qm({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")??(Zm(r)?void 0:of(t))??ef(e,n)}function Zm(e){return e==="input"||e==="textarea"||e==="select"}function ef(e,t){let r=Vi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=rf(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return Mi(n.body)}}function Mi(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,Mi)}function tf(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function Wi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=Wi(e,t);return r==null?void 0:nf(r.initializer)}function rf(e,t){let r=Wi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function nf(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return qi(e.expression)}function of(e){let t=e.flatMap(r=>Hi(r)).join(" ").trim();return t.length===0?void 0:t}function Hi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=qi(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>Hi(t)):[]}function qi(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 lf=an.join(".ripplo","coverage.d.ts");function Ue({cwd:e}){cf({cwd:e,ignorePaths:Re})}function cf({cwd:e,ignorePaths:t}){let r=Ve({cwd:e,ignorePaths:t});pf({content:uf(r),cwd:e})}function Ve({cwd:e,ignorePaths:t}){let n=df({cwd:e,ignorePaths:t}).flatMap(o=>ln({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function df({cwd:e,ignorePaths:t}){let r=oe(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=af([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o))}function ln({cwd:e,file:t}){let r=Vt.readFileSync(an.join(e,t),"utf8");return Ut({filePath:t,source:r}).map(n=>n.id)}function uf(e){let t=`// GENERATED \u2014 do not edit
|
|
202
212
|
import "@ripplo/testing";
|
|
203
213
|
|
|
204
214
|
declare module "@ripplo/testing" {
|
|
@@ -209,32 +219,32 @@ declare module "@ripplo/testing" {
|
|
|
209
219
|
`:`${t}${r}
|
|
210
220
|
}
|
|
211
221
|
}
|
|
212
|
-
`}function
|
|
222
|
+
`}function pf({content:e,cwd:t}){let r=an.join(t,lf);Vt.existsSync(r)&&Vt.readFileSync(r,"utf8")===e||Vt.writeFileSync(r,e)}import mf from"path";import{createJiti as ff}from"jiti";var gf=["getObservers","getPreconditions","getTests","getUnimplemented"];function yf(e){return e==null||typeof e!="object"?!1:gf.every(t=>typeof Reflect.get(e,t)=="function")}function hf(e){return e===null?"null":Array.isArray(e)?"array":typeof e}async function I(e){let t=mf.join(e,".ripplo","index.ts");try{let n=await ff(import.meta.url,{moduleCache:!1}).import(t),o=n!=null&&typeof n=="object"&&"default"in n?Reflect.get(n,"default"):n;if(!yf(o))return{error:`${t} must default-export a RipploBuilder (got ${hf(o)})`,ok:!1};let i=_t(o);return{builder:o,ok:!0,result:i}}catch(r){return{error:r instanceof Error?r.message:String(r),ok:!1}}}function E(e,t){return t==null?`Load \`/ripplo:${e}\` skill for instructions.`:`Load \`/ripplo:${e}\` skill for instructions on ${t}.`}function Bi(e){return e.length===1?E(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 zi(e){let t=process.cwd(),r=await I(t);if(r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
213
223
|
`),process.stderr.write(`${E("create","DSL authoring + lint rules")}
|
|
214
224
|
`),process.exit(1)),e.check){let n=await Lt({cwd:t}),o=Dt({compiled:r.result,existing:n});if(o==="match"){process.stdout.write(`${ce} is up to date
|
|
215
225
|
`);return}let i=o==="missing"?"missing":"out of date";process.stderr.write(`${ce} is ${i} \u2014 run \`ripplo compile\` and commit the result
|
|
216
226
|
`),process.stderr.write(`${E("setup")}
|
|
217
|
-
`),process.exit(1)}await de({cwd:t,result:r.result}),
|
|
218
|
-
`)}import
|
|
219
|
-
`),
|
|
220
|
-
`),o.length>0&&(
|
|
227
|
+
`),process.exit(1)}await de({cwd:t,result:r.result}),Ue({cwd:t}),process.stdout.write(`wrote ${ce}
|
|
228
|
+
`)}import fe from"process";import wf from"fs";import bf from"path";import Sf from"picomatch";function Gi({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Ve({cwd:t,ignorePaths:r})),o=Yi(e),i=vf({cwd:t,ignorePaths:r});return Ki({acknowledged:o,allStatements:n,unacked:i})}function Ji({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Ve({cwd:t,ignorePaths:r})),o=Yi(e);return Ki({acknowledged:o,allStatements:n,unacked:n})}function Ki({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 Yi(e){return new Set(e.tests.flatMap(t=>t.coverage))}function vf({cwd:e,ignorePaths:t}){let r=kf({cwd:e,ignorePaths:t}),n=new Set(r.flatMap(i=>Rf({cwd:e,file:i}))),o=new Set(r.flatMap(i=>xf({cwd:e,file:i})?ln({cwd:e,file:i}):[]));return new Set([...o].filter(i=>!n.has(i)))}function kf({cwd:e,ignorePaths:t}){let r=oe(["diff","--name-only","HEAD","-z"],e),n=oe(["ls-files","--others","--exclude-standard","-z"],e),o=Sf([...t]);return[...new Set([...r.split("\0"),...n.split("\0")])].filter(i=>i.length>0&&/\.(tsx|jsx)$/.test(i)).filter(i=>!o(i))}function Rf({cwd:e,file:t}){let r=_i(`HEAD:${t}`,e);return r==null?[]:Ut({filePath:t,source:r}).map(n=>n.id)}function xf({cwd:e,file:t}){return wf.existsSync(bf.join(e,t))}async function Xi(){let e=fe.cwd(),t=await I(e);t.ok||(fe.stderr.write(`Compilation failed: ${t.error}
|
|
229
|
+
`),fe.exit(1));let r=Ve({cwd:e,ignorePaths:Re}),n=Ji({compileResult:t.result,cwd:e,ignorePaths:Re}),o=n.filter(a=>a.kind==="unacknowledged"),i=n.filter(a=>a.kind==="stale"),s=r.length-o.length;fe.stdout.write(`Coverage: ${String(s)}/${String(r.length)} statements acknowledged
|
|
230
|
+
`),o.length>0&&(fe.stdout.write(`
|
|
221
231
|
Unacknowledged (${String(o.length)}):
|
|
222
|
-
`),o.forEach(a=>
|
|
223
|
-
`))),i.length>0&&(
|
|
232
|
+
`),o.forEach(a=>fe.stdout.write(` ${a.id}
|
|
233
|
+
`))),i.length>0&&(fe.stdout.write(`
|
|
224
234
|
Stale claims (${String(i.length)}):
|
|
225
|
-
`),i.forEach(a=>
|
|
226
|
-
`))),n.length>0&&
|
|
235
|
+
`),i.forEach(a=>fe.stdout.write(` ${a.id}
|
|
236
|
+
`))),n.length>0&&fe.exit(1)}import dn from"fs";import Cf from"path";import{chromium as Tf}from"playwright";import Pf from"fs";import Ef from"path";async function Qi(e){let t=Ef.join(e,".ripplo","index.ts");if(!Pf.existsSync(t))return{appUrl:void 0,engineUrl:void 0,errors:[{message:".ripplo/index.ts not found",path:""}],valid:!1,warnings:[]};let r=await I(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 cn(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 Zi({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 es(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"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 ts(e){let t=await If(e),r={missing:tr(e),type:"env-files"},n=jf(),o=Nf(),i=await I(e),s=Of(i),a=_f(i),l=await Af(e,i),c=$f(e),d=await Uf(t,i);return[t,r,n,...d,s,a,l,c,o]}async function Af(e,t){if(!t.ok)return{status:"missing",type:"lockfile"};let r=await Lt({cwd:e});return{status:Dt({compiled:t.result,existing:r}),type:"lockfile"}}function $f(e){let t=Cf.join(e,".git","hooks","pre-commit");return dn.existsSync(t)?{installed:dn.readFileSync(t,"utf8").includes("ripplo compile --check"),type:"pre-commit-hook"}:{installed:!1,type:"pre-commit-hook"}}async function If(e){let t=await Qi(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 jf(){let e=re();return{exists:e!=null&&e.length>0,type:"token"}}function Nf(){let e=Tf.executablePath();return{installed:dn.existsSync(e),type:"browser"}}function Of(e){if(!e.ok)return{errorCount:1,errors:[{message:e.error,path:""}],found:!1,type:"preconditions-validation",valid:!1};let t=Lf(e.result.preconditions,e.result.tests);return{errorCount:t.length,errors:t,found:!0,type:"preconditions-validation",valid:t.length===0}}function Lf(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}`})})}),Df(e).forEach(o=>{r.push({message:o,path:"preconditions"})}),r}function Df(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 _f(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 Uf(e,t){if(!e.valid||!t.ok)return[];let r;try{let s=Ae();r={appUrl:s.appUrl,engineUrl:s.engineUrl,webhookSecret:s.webhookSecret}}catch{return[]}let n=[],o=await cn(r.appUrl)==null;n.push({appUrl:r.appUrl,reachable:o,type:"dev-server"});let i=await Vf(r,t);return n.push(...i),n}async function Vf(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=Wf(e.appUrl,e.engineUrl);if(i==null)return[o];let s=await cn(i)==null,a=[];if(a.push({configured:!0,count:r,endpointReachable:s,type:"preconditions"}),rs(e.engineUrl)&&a.push({reachable:s,type:"engine-endpoint",url:i}),!s)return a;let l=await Zi({appUrl:e.appUrl,engineUrl:e.engineUrl});a.push({rejectsUnsigned:l==null,type:"webhook-verification"});let c=await Ff({engineUrl:i,webhookSecret:e.webhookSecret});return a.push({status:c,type:"adapter-enabled",url:i}),a}async function Ff({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",...ve({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 Mf(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 rs(e){return e.startsWith("http://")||e.startsWith("https://")}function Wf(e,t){return rs(t)?t:`${e}${t}`}function ns(e){switch(e.type){case"settings":return Bf(e);case"env-files":return zf(e);case"token":return Gf(e);case"dev-server":return Jf(e);case"preconditions":return Xf(e);case"webhook-verification":return Kf(e);case"preconditions-validation":return Qf(e);case"workflows":return Zf(e);case"browser":return Yf(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 Mf(e);case"lockfile":return Hf(e);case"pre-commit-hook":return qf(e)}}function Hf(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 qf(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 Bf(e){return e.valid?"\u2713 Settings: Project configured":`\u2717 Settings: Missing fields: ${e.missingFields.join(", ")}`}function zf(e){return e.missing.length===0?"\u2713 Env files: declared files present":`\u2717 Env files: declared in .ripplo/project.json but missing:
|
|
227
237
|
${e.missing.map(r=>` ${r}`).join(`
|
|
228
238
|
`)}
|
|
229
|
-
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
|
|
239
|
+
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 Gf(e){return e.exists?"\u2713 Auth: Token found":"\u2717 Auth: No token found. Run `ripplo` to authenticate."}function Jf(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 Kf(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 Yf(e){return e.installed?"\u2713 Browser: Chromium installed":"\u2717 Browser: Chromium not installed. Run: npx playwright install chromium"}function Xf(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 Qf(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"}
|
|
230
240
|
${t.join(`
|
|
231
|
-
`)}`}function
|
|
241
|
+
`)}`}function Zf(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=>eg(r));return`\u2717 Tests: ${String(e.invalidNames.length)} invalid
|
|
232
242
|
${t.join(`
|
|
233
|
-
`)}`}function
|
|
243
|
+
`)}`}function eg(e){let t=e.errors.map(r=>" - "+(r.path===""?"":r.path+": ")+r.message);return" "+e.name+`:
|
|
234
244
|
`+t.join(`
|
|
235
245
|
`)}async function os(){let e=process.cwd(),t=await ts(e),r=t.map(o=>ns(o));process.stdout.write(r.join(`
|
|
236
246
|
`)+`
|
|
237
|
-
`);let n=t.some(o=>es(o));process.exit(n?1:0)}import{graphql as Mt,readFragment as
|
|
247
|
+
`);let n=t.some(o=>es(o));process.exit(n?1:0)}import{graphql as Mt,readFragment as lg}from"gql.tada";import rg from"crypto";import{graphql as ng}from"gql.tada";import un from"fs";import pn from"path";function Ft(e){try{let t=pn.join(tg(e),"HEAD"),r=un.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 tg(e){let t=pn.join(e,".git");if(un.statSync(t).isDirectory())return t;let n=un.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 pn.resolve(e,i)}var og=ng(`
|
|
238
248
|
mutation SyncDevSession(
|
|
239
249
|
$projectId: String!
|
|
240
250
|
$cwd: String!
|
|
@@ -252,12 +262,12 @@ ${t.join(`
|
|
|
252
262
|
id
|
|
253
263
|
}
|
|
254
264
|
}
|
|
255
|
-
`);async function ot(e){let t=
|
|
265
|
+
`);async function ot(e){let t=ig(e.compiled);return ag({config:e.config,cwd:e.cwd,payload:t})}async function Ce(e,t){let r=await I(e);if(!r.ok)throw new Error(`DSL compilation failed: ${r.error}`);let n=await ot({compiled:r.result,config:t,cwd:e});return{compiled:r.result,devSessionId:n.devSessionId}}function ig(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 sg(e){return rg.createHash("sha256").update(JSON.stringify(e)).digest("hex")}async function ag({config:e,cwd:t,payload:r}){let n=sg(r),o=Ft(t),i=await k({config:e,document:og,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 is from"figures";var it={cross:is.cross,tick:is.tick};var as=Mt(`
|
|
256
266
|
fragment WorkflowIdMCP on Workflow {
|
|
257
267
|
id
|
|
258
268
|
slug
|
|
259
269
|
}
|
|
260
|
-
`),
|
|
270
|
+
`),cg=Mt(`
|
|
261
271
|
query ProjectWorkflowIdsMCP($projectId: String!, $cwd: String!) {
|
|
262
272
|
project(id: $projectId) {
|
|
263
273
|
id
|
|
@@ -269,14 +279,14 @@ ${t.join(`
|
|
|
269
279
|
}
|
|
270
280
|
}
|
|
271
281
|
}
|
|
272
|
-
`,[as]),
|
|
282
|
+
`,[as]),dg=Mt(`
|
|
273
283
|
mutation CreateRunMCP($workflowId: String!, $platforms: [String!]!, $concurrency: Int!) {
|
|
274
284
|
createRun(workflowId: $workflowId, platforms: $platforms, concurrency: $concurrency) {
|
|
275
285
|
id
|
|
276
286
|
status
|
|
277
287
|
}
|
|
278
288
|
}
|
|
279
|
-
`),
|
|
289
|
+
`),ug=Mt(`
|
|
280
290
|
query RunStatusMCP($id: String!) {
|
|
281
291
|
run(id: $id) {
|
|
282
292
|
id
|
|
@@ -303,8 +313,8 @@ ${t.join(`
|
|
|
303
313
|
}
|
|
304
314
|
}
|
|
305
315
|
}
|
|
306
|
-
`);async function Wt({config:e,ids:t}){let r=await
|
|
307
|
-
${E("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await
|
|
316
|
+
`);async function Wt({config:e,ids:t}){let r=await pg({config:e,ids:t}),n=await Promise.all(r.map(async s=>{try{let a=await hg({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}
|
|
317
|
+
${E("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await bg({config:e,runId:l}),d=yg({config:e,id:a.id,runId:l}),u=`.ripplo/debug/${l}/`;return{id:a.id,runId:l,summary:`View run: ${d}
|
|
308
318
|
Debug artifacts: ${u}
|
|
309
319
|
${E("debug","read summary.txt, accessibility-tree, network.jsonl before guessing")}
|
|
310
320
|
|
|
@@ -314,10 +324,10 @@ ${s.summary}`).join(`
|
|
|
314
324
|
|
|
315
325
|
---
|
|
316
326
|
|
|
317
|
-
`);return{results:o,summary:i}}async function
|
|
327
|
+
`);return{results:o,summary:i}}async function pg({config:e,ids:t}){let r=await Ce(e.cwd,e),n=await k({config:e,document:cg,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=>lg(as,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(mg({compiledSlugs:i,slug:s}));return{id:s,workflowId:a.id}})}function mg({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=fg({compiledSlugs:e,limit:3,slug:t}),n=r.length>0?`
|
|
318
328
|
Did you mean: ${r.join(", ")}?`:"";return`Test "${t}" is not registered in this dev session.${n}
|
|
319
|
-
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function
|
|
320
|
-
`)}function
|
|
329
|
+
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function fg({compiledSlugs:e,limit:t,slug:r}){let n=new Set(r.split("-"));return e.map(i=>({candidate:i,score:gg(n,i)})).filter(i=>i.score>0).toSorted((i,s)=>s.score-i.score).slice(0,t).map(i=>i.candidate)}function gg(e,t){return t.split("-").filter(r=>e.has(r)).length}function yg({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 hg({config:e,workflowId:t}){let r=await k({config:e,document:dg,variables:{concurrency:1,platforms:["chromium"],workflowId:t}});if(r.createRun==null)throw new Error("Failed to create run");return r.createRun.id}var wg=2e3,ss=150;async function bg({config:e,runId:t}){let r=0;for(;r<ss;){await vg(wg),r+=1;let o=(await k({config:e,document:ug,variables:{id:t}})).run;if(o==null)throw new Error(`Run ${t} not found`);if(!(o.status==="pending"||o.status==="running"))return Sg({results:o.results??[],runId:t,status:o.status})}return`Run ${t} timed out after polling ${String(ss)} times.`}function Sg({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"?it.tick:it.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"?it.tick:it.cross,d=l.detail==null?"":` \u2014 ${l.detail}`;n.push(` ${c} ${l.description}${d}`)})})}),n.join(`
|
|
330
|
+
`)}function vg(e){return new Promise(t=>{setTimeout(t,e)})}import{graphql as kg}from"gql.tada";import ls from"fs";import mn from"path";function cs(e){let t=ls.realpathSync(e),r=t,n=mn.dirname(r);for(;n!==r;){if(ls.existsSync(mn.join(r,".git")))return r;r=n,n=mn.dirname(r)}return t}function X(e){let t=Qt(e),r=Ae(),n=re();if(n==null)throw new Error("ripplo: not authenticated. Run `ripplo auth login`.");return{appUrl:r.appUrl,cwd:cs(e),engineUrl:r.engineUrl,projectId:t.projectId,ripploServerUrl:me(),token:n,webhookSecret:r.webhookSecret}}var Rg=kg(`
|
|
321
331
|
query DevSessionCheckPreflight($projectId: String!, $cwd: String!) {
|
|
322
332
|
project(id: $projectId) {
|
|
323
333
|
id
|
|
@@ -326,30 +336,30 @@ Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on
|
|
|
326
336
|
}
|
|
327
337
|
}
|
|
328
338
|
}
|
|
329
|
-
`);function
|
|
339
|
+
`);function ge(){try{return X(process.cwd())}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`${t}
|
|
330
340
|
`),process.stderr.write(`${E("setup")}
|
|
331
|
-
`),process.exit(1)}}async function
|
|
332
|
-
`),process.exit(1))}async function ds({id:e,runs:t}){let r=
|
|
341
|
+
`),process.exit(1)}}async function ye(e){(await k({config:e,document:Rg,variables:{cwd:e.cwd,projectId:e.projectId}})).project?.devSession==null&&(process.stderr.write("No active dev session. Start one by running `ripplo` (or `npx ripplo`) in a terminal first.\n"),process.stderr.write(`${E("setup")}
|
|
342
|
+
`),process.exit(1))}async function ds({id:e,runs:t}){let r=ge();await ye(r),process.stdout.write(`flake-detect "${e}" x${String(t)}...
|
|
333
343
|
`);let n=await Promise.allSettled(Array.from({length:t},()=>Wt({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(`
|
|
334
344
|
`).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)
|
|
335
345
|
`),s.size>0&&s.forEach((l,c)=>{process.stdout.write(` ${String(l)}x: ${c}
|
|
336
346
|
`)}),i>0&&process.stderr.write(`${E("flake-detect","parallel safety + race conditions")}
|
|
337
|
-
`),process.exit(i>0?1:0)}import
|
|
338
|
-
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function
|
|
347
|
+
`),process.exit(i>0?1:0)}import Fe from"fs";import Me from"path";import{input as ms,select as fs}from"@inquirer/prompts";import{graphql as Hg}from"gql.tada";import{exec as xg}from"child_process";import F from"fs";import H from"path";import{promisify as Pg}from"util";var Eg=["@ripplo/testing"],us=".ripplo/ripplo.lock linguist-generated=true",Cg=[".ripplo/debug/",".ripplo/.local/"],Tg=Pg(xg);async function ps({cwd:e,onStep:t}){t("Scaffolding project files..."),Dg({cwd:e}),t("Updating .gitignore..."),_g(e),t("Marking ripplo.lock as generated..."),Ig(e),t("Installing dependencies...");let r=await Ag(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 $g(e);o!=null&&n.push({manualCommand:void 0,message:o})}return t("Setting up browser..."),await Sr(),n}async function Ag(e){let t=jg({cwd:e,pm:Lg(e)});g.info("Installing dependencies: %s",t);try{return await Tg(t,{cwd:e}),{ok:!0}}catch(r){let n=r instanceof Error?r.message.split(`
|
|
348
|
+
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function $g(e){try{let t=await I(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 Ig(e){let t=H.join(e,".gitattributes"),r=F.existsSync(t)?F.readFileSync(t,"utf8"):"";if(r.includes(us))return;let n=r.length===0||r.endsWith(`
|
|
339
349
|
`)?"":`
|
|
340
350
|
`;F.writeFileSync(t,`${r}${n}${us}
|
|
341
|
-
`)}function
|
|
351
|
+
`)}function jg({cwd:e,pm:t}){let r=Eg.join(" ");return t==="pnpm"?Ng(e)?`pnpm add -wD ${r}`:`pnpm add -D ${r}`:t==="yarn"?Og(e)?`yarn add -WD ${r}`:`yarn add -D ${r}`:t==="bun"?`bun add -d ${r}`:`npm install -D ${r}`}function Ng(e){return F.existsSync(H.join(e,"pnpm-workspace.yaml"))||F.existsSync(H.join(e,"pnpm-workspace.yml"))}function Og(e){let t=H.join(e,"package.json");if(!F.existsSync(t))return!1;try{let r=JSON.parse(F.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 Lg(e){return F.existsSync(H.join(e,"pnpm-lock.yaml"))?"pnpm":F.existsSync(H.join(e,"yarn.lock"))?"yarn":F.existsSync(H.join(e,"bun.lockb"))||F.existsSync(H.join(e,"bun.lock"))?"bun":"npm"}function Dg({cwd:e}){let t=H.join(e,".ripplo"),r=H.join(t,"tests"),n=H.join(t,"preconditions"),o=H.join(t,"observers");F.mkdirSync(r,{recursive:!0}),F.mkdirSync(n,{recursive:!0}),F.mkdirSync(o,{recursive:!0}),st(H.join(t,"index.ts"),Ug),st(H.join(n,"index.ts"),Vg),st(H.join(o,"index.ts"),Fg),st(H.join(r,"index.ts"),Mg),st(H.join(t,"tsconfig.json"),Wg)}function st(e,t){F.existsSync(e)||F.writeFileSync(e,t)}function _g(e){let t=H.join(e,".gitignore");if(!F.existsSync(t))return;let r=F.readFileSync(t,"utf8"),n=Cg.filter(i=>!r.includes(i));if(n.length===0)return;let o=r.endsWith(`
|
|
342
352
|
`)?"":`
|
|
343
353
|
`;F.writeFileSync(t,r+o+n.join(`
|
|
344
354
|
`)+`
|
|
345
|
-
`)}var
|
|
355
|
+
`)}var Ug=`import { createRipplo } from "@ripplo/testing";
|
|
346
356
|
import { preconditions } from "./preconditions/index.js";
|
|
347
357
|
import { observers } from "./observers/index.js";
|
|
348
358
|
import { tests } from "./tests/index.js";
|
|
349
359
|
|
|
350
360
|
export { preconditions, observers, tests };
|
|
351
361
|
export default createRipplo({ preconditions, observers, tests });
|
|
352
|
-
`,
|
|
362
|
+
`,Vg=`// Declare preconditions with \`precondition(name)\` from @ripplo/testing and collect them
|
|
353
363
|
// in the \`preconditions\` registry below. Every handle in this registry must be implemented
|
|
354
364
|
// in your app server's \`createEngine(ripplo, { preconditions: {...}, observers: {...} })\` call.
|
|
355
365
|
//
|
|
@@ -363,7 +373,7 @@ export default createRipplo({ preconditions, observers, tests });
|
|
|
363
373
|
// export const preconditions = { authLoggedIn };
|
|
364
374
|
|
|
365
375
|
export const preconditions = {};
|
|
366
|
-
`,
|
|
376
|
+
`,Fg=`// Declare observers with \`observer(name)\` from @ripplo/testing and collect them in
|
|
367
377
|
// the \`observers\` registry below. Use them in tests via \`assert.backend(handle, params)\`.
|
|
368
378
|
//
|
|
369
379
|
// Example:
|
|
@@ -376,7 +386,7 @@ export const preconditions = {};
|
|
|
376
386
|
// export const observers = { orgNameIs };
|
|
377
387
|
|
|
378
388
|
export const observers = {};
|
|
379
|
-
`,
|
|
389
|
+
`,Mg=`// Each test file under ./tests exports a TestDefinition. Import them here and add them
|
|
380
390
|
// to the \`tests\` array \u2014 that's what \`createRipplo({ ..., tests })\` receives.
|
|
381
391
|
//
|
|
382
392
|
// Example:
|
|
@@ -384,7 +394,7 @@ export const observers = {};
|
|
|
384
394
|
// export const tests = [myTest] as const;
|
|
385
395
|
|
|
386
396
|
export const tests = [] as const;
|
|
387
|
-
`,
|
|
397
|
+
`,Wg=`{
|
|
388
398
|
"compilerOptions": {
|
|
389
399
|
"strict": true,
|
|
390
400
|
"noUncheckedIndexedAccess": true,
|
|
@@ -400,52 +410,60 @@ export const tests = [] as const;
|
|
|
400
410
|
"include": ["*.ts", "coverage.d.ts", "observers/**/*.ts", "preconditions/**/*.ts", "tests/**/*.ts"],
|
|
401
411
|
"exclude": ["node_modules"]
|
|
402
412
|
}
|
|
403
|
-
`;var
|
|
413
|
+
`;var qg=Hg(`
|
|
404
414
|
query InitProjects {
|
|
405
415
|
projects {
|
|
406
416
|
id
|
|
407
417
|
name
|
|
408
418
|
}
|
|
409
419
|
}
|
|
410
|
-
`),
|
|
411
|
-
`),process.exit(1));let o=await
|
|
420
|
+
`),fn=["../.env.local","../.env"];async function gs(e=Gg()){let t=process.cwd(),r=re();r==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let n=me();Bg(t)&&(process.stdout.write(`\`.ripplo/index.ts\` already exists at ${t}. Delete it first if you want to re-init.
|
|
421
|
+
`),process.exit(1));let o=await zg({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 Kg(o,e.projectId),s=await Yg(t,e.envFile),a=await Xg(e.appUrl),l=Jg(a,e.engineUrl),c=Me.resolve(Me.join(t,".ripplo"),s);kn({cwd:t,envFiles:[s],projectId:i}),ey({appUrl:a,engineUrl:l,filePath:c});let d=await ps({cwd:t,onStep:u=>{process.stdout.write(` ${u}
|
|
412
422
|
`)}});if(d.length>0){process.stdout.write(`Done with warnings:
|
|
413
423
|
`),d.forEach(u=>{process.stdout.write(` - ${u.message}
|
|
414
424
|
`),u.manualCommand!=null&&process.stdout.write(` run: ${u.manualCommand}
|
|
415
|
-
`)});return}process.stdout.write("Ready. Add `ripplo watch` to your dev script, then write tests in `.ripplo/tests/`.\n")}function
|
|
416
|
-
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function
|
|
425
|
+
`)});return}process.stdout.write("Ready. Add `ripplo watch` to your dev script, then write tests in `.ripplo/tests/`.\n")}function Bg(e){return Fe.existsSync(Me.join(e,".ripplo","index.ts"))}async function zg({serverUrl:e,token:t}){return((await k({config:Oe({serverUrl:e,token:t}),document:qg,variables:void 0})).projects??[]).map(n=>({id:n.id,name:n.name}))}function Gg(){return{appUrl:void 0,engineUrl:void 0,envFile:void 0,projectId:void 0}}function Jg(e,t){if(t!=null){try{new URL(t)}catch{process.stdout.write(`--engine-url is not a valid URL: ${t}
|
|
426
|
+
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function Kg(e,t){if(t!=null){let r=e.find(n=>n.id===t);return r==null&&(process.stdout.write(`Unknown project id: ${t}
|
|
417
427
|
`),process.exit(1)),process.stdout.write(`Using project: ${r.name} (${r.id})
|
|
418
428
|
`),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})
|
|
419
|
-
`),r.id}return fs({choices:e.map(r=>({name:r.name,value:r.id})),message:"Select a project"})}async function
|
|
420
|
-
`),process.exit(1)),t):
|
|
421
|
-
`),process.exit(1)}return e}return
|
|
429
|
+
`),r.id}return fs({choices:e.map(r=>({name:r.name,value:r.id})),message:"Select a project"})}async function Yg(e,t){return t!=null?(t.trim().length===0&&(process.stdout.write(`--env-file must not be empty
|
|
430
|
+
`),process.exit(1)),t):Qg(e)}async function Xg(e){if(e!=null){try{new URL(e)}catch{process.stdout.write(`--app-url is not a valid URL: ${e}
|
|
431
|
+
`),process.exit(1)}return e}return Zg()}async function Qg(e){let t=Me.join(e,".ripplo"),r=fn.find(o=>Fe.existsSync(Me.resolve(t,o))),n=await fs({choices:[...fn.map(o=>({name:r===o?`${o} (detected)`:o,value:o})),{name:"custom path",value:"__custom__"}],default:r??fn[0],message:"Which env file should ripplo write RIPPLO_APP_URL, RIPPLO_ENGINE_URL, and RIPPLO_WEBHOOK_SECRET to?"});return n!=="__custom__"?n:ms({message:"Path to env file (relative to .ripplo/, e.g. ../apps/server/.env)",validate:o=>o.trim().length>0?!0:"required"})}async function Zg(){return ms({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 ey({appUrl:e,engineUrl:t,filePath:r}){Fe.mkdirSync(Me.dirname(r),{recursive:!0});let n=Fe.existsSync(r)?Fe.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=${Mr()}`),o.length===0)return;let i=n.length===0||n.endsWith(`
|
|
422
432
|
`)?"":`
|
|
423
|
-
`;
|
|
433
|
+
`;Fe.writeFileSync(r,`${n}${i}${o.join(`
|
|
424
434
|
`)}
|
|
425
|
-
`)}import
|
|
435
|
+
`)}import gn from"fs";import ys from"path";import*as hs from"remeda";async function ws(e){let{ids:t,requireImplemented:r}=e,n=process.cwd(),o=await I(n);o.ok||(process.stderr.write(`Compilation failed: ${o.error}
|
|
426
436
|
`),process.stderr.write(`${E("create","DSL authoring + lint rules")}
|
|
427
|
-
`),process.exit(1)),await de({cwd:n,result:o.result});let i=
|
|
437
|
+
`),process.exit(1)),await de({cwd:n,result:o.result});let i=De(o.result),s=t.length===0?i.diagnostics:i.diagnostics.filter(w=>t.includes(w.test)),a=hs.groupBy(s,w=>w.test);Object.entries(a).forEach(([w,h])=>{process.stderr.write(`
|
|
428
438
|
${w}
|
|
429
439
|
`),h.forEach(S=>{let C=S.step==null?"":` at "${S.step}"`;process.stderr.write(` [${S.rule}]${C}
|
|
430
440
|
`),process.stderr.write(` ${S.message}
|
|
431
441
|
`)})});let l=new Set(o.builder.getUnimplemented().tests),c=r.filter(w=>l.has(w));c.length>0&&(process.stderr.write(`
|
|
432
442
|
not-implemented
|
|
433
443
|
`),c.forEach(w=>{process.stderr.write(` ${w} is still marked .notImplemented()
|
|
434
|
-
`)}));let d=
|
|
444
|
+
`)}));let d=oy(n);d.length>0&&(process.stderr.write(`
|
|
435
445
|
preconditions
|
|
436
446
|
`),d.forEach(w=>{process.stderr.write(` [hardcoded-identifier] ${w.file}
|
|
437
447
|
`),process.stderr.write(` ${w.message}
|
|
438
448
|
`)}));let u=s.length+c.length+d.length;u>0&&(process.stderr.write(`
|
|
439
449
|
${String(u)} error(s)
|
|
440
|
-
`),
|
|
441
|
-
`)}function
|
|
442
|
-
`))}var
|
|
450
|
+
`),ty({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)
|
|
451
|
+
`)}function ty({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(`${E(o)}
|
|
452
|
+
`))}var ry=/['"`][\w.+-]+@[\w.-]+\.[a-z]{2,}['"`]/i,ny=/['"`][0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}['"`]/i;function oy(e){let t=ys.join(e,".ripplo","preconditions");return gn.existsSync(t)?gn.readdirSync(t).filter(n=>n.endsWith(".ts")).flatMap(n=>iy(ys.join(t,n))):[]}function iy(e){let t=gn.readFileSync(e,"utf8"),r=t.includes("ctx.uniqueEmail")||t.includes("ctx.uniqueId"),n=[],o=ry.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=ny.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 sy}from"gql.tada";var ay=sy(`
|
|
453
|
+
query ProjectsList {
|
|
454
|
+
projects {
|
|
455
|
+
id
|
|
456
|
+
name
|
|
457
|
+
}
|
|
458
|
+
}
|
|
459
|
+
`);async function bs(){let e=re();e==null&&(process.stderr.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let t=me(),n=((await k({config:Oe({serverUrl:t,token:e}),document:ay,variables:void 0})).projects??[]).map(o=>({id:o.id,name:o.name}));process.stdout.write(`${JSON.stringify({projects:n},null,2)}
|
|
460
|
+
`)}async function Ss(e){let t=ge();await ye(t);let{results:r,summary:n}=await Wt({config:t,ids:e});process.stdout.write(`${n}
|
|
443
461
|
`);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.
|
|
444
462
|
`),process.stderr.write(`${E("debug")}
|
|
445
|
-
`)),process.exit(o?1:0)}async function
|
|
463
|
+
`)),process.exit(o?1:0)}async function vs(){let e=process.cwd(),t=X(e);try{let r=await Ce(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}
|
|
446
464
|
`)}catch(r){let n=r instanceof Error?r.message:String(r);process.stderr.write(`ripplo sync failed: ${n}
|
|
447
465
|
`),process.stderr.write(`${E("setup","verify auth + server reachability")}
|
|
448
|
-
`),process.exit(1)}}import
|
|
466
|
+
`),process.exit(1)}}import hn from"fs";import{createClient as yy}from"graphql-sse";import{graphql as Ht}from"gql.tada";import{print as Es}from"graphql";import at from"fs";var ly="dev.pid";function ks(e){return et(e,ly)}function Rs(e){let t=ks(e);if(!at.existsSync(t))return!1;let r=at.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 xs(e){Ir(e);let t=ks(e);at.writeFileSync(t,String(process.pid));let r=!1;return()=>{if(!r){r=!0;try{let n=at.readFileSync(t,"utf8").trim();Number.parseInt(n,10)===process.pid&&at.unlinkSync(t)}catch{}}}}import cy from"fs";function lt(e){return et(e,"hooks-paused")}function V(e){return cy.existsSync(lt(e))?!1:Rs(e)}import{availableParallelism as dy}from"os";import uy from"p-limit";var py=Math.min(10,dy()/2),my=uy(py),yn=new Set;async function Ps(e){if(!yn.has(e.runId)){yn.add(e.runId);try{await my(()=>fy(e))}finally{yn.delete(e.runId)}}}async function fy({agentProfileDescription:e,agentProfileId:t,config:r,cwd:n,runId:o,workflowId:i,workflowSlug:s}){let a=await Pe({headed:!1});try{await Tr({maxRuns:100});let l=n!=null&&s!=null?await gy({cwd:n,workflowSlug:s}):void 0;await Jr({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 gy({cwd:e,workflowSlug:t}){let r=await I(e);if(!r.ok)return;let n=r.result.tests.find(o=>o.slug===t);if(n!=null)return n.preconditions}var hy=3e4,wy=Ht(`
|
|
449
467
|
subscription RunRequestedWatch($devSessionId: String!) {
|
|
450
468
|
runRequested(devSessionId: $devSessionId) {
|
|
451
469
|
agentProfileDescription
|
|
@@ -455,30 +473,30 @@ ${String(u)} error(s)
|
|
|
455
473
|
workflowSlug
|
|
456
474
|
}
|
|
457
475
|
}
|
|
458
|
-
`),
|
|
476
|
+
`),by=Ht(`
|
|
459
477
|
subscription HooksPausedWatch($projectId: String!) {
|
|
460
478
|
hooksPausedRequested(projectId: $projectId) {
|
|
461
479
|
paused
|
|
462
480
|
projectId
|
|
463
481
|
}
|
|
464
482
|
}
|
|
465
|
-
`),
|
|
483
|
+
`),Sy=Ht(`
|
|
466
484
|
mutation HeartbeatDevSessionWatch($id: String!) {
|
|
467
485
|
heartbeatDevSession(id: $id) {
|
|
468
486
|
id
|
|
469
487
|
}
|
|
470
488
|
}
|
|
471
|
-
`),
|
|
489
|
+
`),vy=Ht(`
|
|
472
490
|
mutation EndDevSessionWatch($projectId: String!, $cwd: String!) {
|
|
473
491
|
endDevSession(projectId: $projectId, cwd: $cwd) {
|
|
474
492
|
id
|
|
475
493
|
}
|
|
476
494
|
}
|
|
477
|
-
`);async function
|
|
478
|
-
`),process.exit(1));let n=await
|
|
479
|
-
`);let d=async()=>{c(),a(),l(),await Promise.race([k({config:e,document:
|
|
480
|
-
`),
|
|
481
|
-
`),process.exit(1)}}var
|
|
495
|
+
`);async function Cs(){let e=Py(process.cwd()),t=e.cwd,r=await I(t);r.ok||(process.stderr.write(`ripplo: DSL compilation failed: ${r.error}
|
|
496
|
+
`),process.exit(1));let n=await Ty(()=>ot({compiled:r.result,config:e,cwd:t})),o=Ft(t);o!=null&&g.info("watching branch %s in %s",o,t);let i=xs(t),s=yy({headers:{Authorization:`Bearer ${e.token}`},retryAttempts:1/0,url:`${e.ripploServerUrl}/graphql`}),a=ky({config:e,cwd:t,devSessionId:n.devSessionId,sseClient:s}),l=Ry({cwd:t,projectId:e.projectId,sseClient:s}),c=xy({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)
|
|
497
|
+
`);let d=async()=>{c(),a(),l(),await Promise.race([k({config:e,document:vy,variables:{cwd:e.cwd,projectId:e.projectId}}).catch(()=>{}),new Promise(u=>setTimeout(u,3e3))]),i()};process.on("SIGINT",()=>{d().finally(()=>process.exit(0))}),process.on("SIGTERM",()=>{d().finally(()=>process.exit(0))}),await new Promise(()=>{})}function ky({config:e,cwd:t,devSessionId:r,sseClient:n}){return n.subscribe({query:Es(wy),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})
|
|
498
|
+
`),Ps({agentProfileDescription:i.agentProfileDescription??void 0,agentProfileId:i.agentProfileId??void 0,config:e,cwd:t,runId:i.runId,workflowId:i.workflowId,workflowSlug:i.workflowSlug}))}})}function Ry({cwd:e,projectId:t,sseClient:r}){return r.subscribe({query:Es(by),variables:{projectId:t}},{complete:()=>{},error:n=>{g.error(n,"hooksPaused subscription error")},next:n=>{let o=n.data?.hooksPausedRequested?.paused;if(o===!0){hn.writeFileSync(lt(e),"");return}o===!1&&hn.existsSync(lt(e))&&hn.unlinkSync(lt(e))}})}function xy({config:e,devSessionId:t}){let r=setInterval(()=>{k({config:e,document:Sy,variables:{id:t}}).catch(n=>{g.warn("heartbeat failed: %s",n instanceof Error?n.message:String(n))})},hy);return()=>{clearInterval(r)}}function Py(e){try{return X(e)}catch(t){let r=t instanceof Error?t.message:String(t);process.stderr.write(`${r}
|
|
499
|
+
`),process.exit(1)}}var Ey=1e3,Cy=6e4;async function Ty(e){let t=Date.now()+Cy,r;for(;Date.now()<t;){let n=await Ay(e);if(n.ok)return n.value;if(!$y(n.message))throw n.error;r=n.error,await Iy(Ey)}throw r instanceof Error?r:new Error("server never became ready")}async function Ay(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 $y(e){return e.includes("status 502")||e.includes("ECONNREFUSED")||e.includes("Failed to connect")||e.includes("fetch failed")}function Iy(e){return new Promise(t=>setTimeout(t,e))}import{graphql as ct}from"gql.tada";var jy=ct(`
|
|
482
500
|
query ScopeStatus($projectId: String!, $cwd: String!) {
|
|
483
501
|
project(id: $projectId) {
|
|
484
502
|
id
|
|
@@ -498,7 +516,7 @@ ${String(u)} error(s)
|
|
|
498
516
|
}
|
|
499
517
|
}
|
|
500
518
|
}
|
|
501
|
-
`),
|
|
519
|
+
`),Ny=ct(`
|
|
502
520
|
query ScopeWorkflowBySlug($projectId: String!, $cwd: String!, $slug: String!) {
|
|
503
521
|
project(id: $projectId) {
|
|
504
522
|
id
|
|
@@ -511,7 +529,7 @@ ${String(u)} error(s)
|
|
|
511
529
|
}
|
|
512
530
|
}
|
|
513
531
|
}
|
|
514
|
-
`),
|
|
532
|
+
`),Oy=ct(`
|
|
515
533
|
mutation ScopeAddAgent($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
516
534
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
517
535
|
id
|
|
@@ -521,42 +539,42 @@ ${String(u)} error(s)
|
|
|
521
539
|
}
|
|
522
540
|
}
|
|
523
541
|
}
|
|
524
|
-
`),
|
|
542
|
+
`),Ly=ct(`
|
|
525
543
|
mutation ScopeLink($id: ID!, $workflowId: String!) {
|
|
526
544
|
linkScopeItem(id: $id, workflowId: $workflowId) {
|
|
527
545
|
id
|
|
528
546
|
}
|
|
529
547
|
}
|
|
530
|
-
`)
|
|
548
|
+
`),Dy=ct(`
|
|
531
549
|
mutation ScopeRemoveMany($ids: [ID!]!) {
|
|
532
550
|
removeScopeItems(ids: $ids)
|
|
533
551
|
}
|
|
534
|
-
`);async function
|
|
552
|
+
`);async function Ts(e){let t=ge();await ye(t);let n=(await k({config:t,document:jy,variables:{cwd:t.cwd,projectId:t.projectId}})).project?.devSession?.scopeItems??[];if(e.format==="json"){process.stdout.write(`${JSON.stringify(n,null,2)}
|
|
535
553
|
`);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??""}
|
|
536
554
|
`);return}let s=i.spec==null?"stub":"implemented";process.stdout.write(` [${s}] (${o.id}) ${i.slug} \u2014 ${i.name}
|
|
537
|
-
`)})}async function
|
|
555
|
+
`)})}async function As({testIds:e}){let t=ge();await ye(t),await Ce(t.cwd,t);let n=(await k({config:t,document:Oy,variables:{cwd:t.cwd,projectId:t.projectId,workflowSlugs:[...e]}})).addAgentScopeItems??[];if(n.length===0){process.stdout.write(`No scope items added.
|
|
538
556
|
`);return}let o=n.map(i=>i.workflow?.slug??"?").join(", ");process.stdout.write(`Added ${String(n.length)} scope item(s): ${o}
|
|
539
|
-
`)}async function
|
|
540
|
-
`)}async function
|
|
541
|
-
`)}async function
|
|
557
|
+
`)}async function $s({id:e,testId:t}){let r=ge();await ye(r),await Ce(r.cwd,r);let n=await _y({cfg:r,slug:t});await k({config:r,document:Ly,variables:{id:e,workflowId:n}}),process.stdout.write(`Linked scope item ${e} to ${t}
|
|
558
|
+
`)}async function Is({ids:e}){let t=ge();await ye(t);let n=(await k({config:t,document:Dy,variables:{ids:[...e]}})).removeScopeItems??0;process.stdout.write(`Removed ${String(n)} scope item(s)
|
|
559
|
+
`)}async function _y({cfg:e,slug:t}){let n=(await k({config:e,document:Ny,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.
|
|
542
560
|
`),process.stderr.write(`${E("create")}
|
|
543
|
-
`),process.exit(1)),n.id}async function
|
|
561
|
+
`),process.exit(1)),n.id}async function js(e){let t=process.cwd(),r=await I(t);r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
544
562
|
`),process.exit(1));let{tests:n}=r.builder.getUnimplemented();if(e.format==="summary"){n.length>0&&process.stdout.write(`tests: ${n.join(", ")}
|
|
545
563
|
`);return}let o={tests:n.map(i=>({id:i,implemented:!1}))};process.stdout.write(`${JSON.stringify(o,null,2)}
|
|
546
|
-
`)}import{z as
|
|
547
|
-
`).filter(t=>t.length>0)}function
|
|
548
|
-
`).filter(r=>r.length>0)}import{createHash as
|
|
549
|
-
`).filter(n=>n.length>0).filter(n=>
|
|
550
|
-
`),hookEventName:"UserPromptSubmit"}}});import
|
|
564
|
+
`)}import{z as Uy}from"zod";function L(e,t){let r=Uy.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 bT}from"crypto";import Ns from"picomatch";function Vy(e){return oe(["diff","--name-only","HEAD"],e).split(`
|
|
565
|
+
`).filter(t=>t.length>0)}function Os({cwd:e,ignoreGlobs:t,watchGlobs:r}){let n=Ns([...r]),o=Ns([...t]);return Vy(e).filter(i=>n(i)&&!o(i))}function qt(e,...t){return oe(["diff","--name-only","HEAD","--",...t],e).split(`
|
|
566
|
+
`).filter(r=>r.length>0)}import{createHash as Fy}from"crypto";import{mkdirSync as My,readFileSync as Ls,writeFileSync as Wy}from"fs";import wn from"path";var Hy=[".ts",".tsx",".js",".jsx"];function We(e){let t=Fy("sha256");return t.update(oe(["rev-parse","HEAD"],e)),t.update("\0"),t.update(oe(["diff","HEAD"],e)),t.update("\0"),oe(["ls-files","--others","--exclude-standard"],e).split(`
|
|
567
|
+
`).filter(n=>n.length>0).filter(n=>Hy.some(o=>n.endsWith(o))).toSorted((n,o)=>n.localeCompare(o)).forEach(n=>{t.update(n),t.update("\0"),t.update(qy(wn.join(e,n))),t.update("\0")}),t.digest("hex")}function He(e,t){try{return Ls(Ds(e,t),"utf8").trim()}catch{return null}}function qe(e,t,r){let n=Ds(e,t);My(wn.dirname(n),{recursive:!0}),Wy(n,r)}function Ds(e,t){return wn.join(e,".ripplo",".local",`${t}.hash`)}function qy(e){try{return Ls(e)}catch{return Buffer.alloc(0)}}function xe(){return{ignorePaths:Re,watchPaths:nn}}var _s=L("UserPromptSubmit",e=>{let{cwd:t}=e;if(!O(t)||!V(t))return;let r=We(t);if(He(t,"coverage-nudge")===r)return;let{ignorePaths:n,watchPaths:o}=xe(),i=Os({cwd:t,ignoreGlobs:n,watchGlobs:o});if(qe(t,"coverage-nudge",r),!(i.length===0||qt(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. ${E("scope")}`,hookEventName:"UserPromptSubmit"}}});import Bt from"fs";import By from"os";import Us from"path";var Vs=L("PreToolUse",e=>{if(e.tool_name!=="ExitPlanMode"||!V(e.cwd))return;let t=zy();if(t==null)return;let r=Bt.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. ${E("explore")}`}}});function zy(){let e=Us.join(By.homedir(),".claude","plans");return Bt.existsSync(e)?Bt.readdirSync(e).filter(r=>r.endsWith(".md")).map(r=>Us.join(e,r)).map(r=>({full:r,mtime:Bt.statSync(r).mtimeMs})).sort((r,n)=>n.mtime-r.mtime)[0]?.full??null:null}var Fs=L("UserPromptSubmit",async e=>{if(e.permission_mode!=="plan"||!O(e.cwd)||!V(e.cwd))return;let t=await I(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(`
|
|
568
|
+
`),hookEventName:"UserPromptSubmit"}}});import Gy from"path";import Ms from"picomatch";import{z as Ws}from"zod";var Jy=Ws.looseObject({file_path:Ws.string()}),Hs=L("PostToolUse",async e=>{let t=Jy.safeParse(e.tool_input);if(!t.success)return;let r=t.data.file_path,{cwd:n}=e;if(!O(n)||!V(n))return;let o=Gy.relative(n,r);if(o.startsWith(".."))return;let{ignorePaths:i,watchPaths:s}=xe(),a=Ms([...s]),l=Ms([...i]);if(!a(o)||l(o))return;let c=await I(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 Ky from"path";import{graphql as Yy}from"gql.tada";import{z as qs}from"zod";var Xy=qs.looseObject({file_path:qs.string()}),Qy=Yy(`
|
|
551
569
|
mutation AutoScopeAdd($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
552
570
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
553
571
|
id
|
|
554
572
|
}
|
|
555
573
|
}
|
|
556
|
-
`),
|
|
557
|
-
${E("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),
|
|
574
|
+
`),Bs=L("PostToolUse",async e=>{let t=Xy.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(!O(n)||!V(n))return;let o=await I(n);if(!o.ok)return{decision:"block",reason:`Compilation failed: ${o.error}
|
|
575
|
+
${E("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),Ue({cwd:n});let{diagnostics:i}=De(o.result);return i.length===0?Zy({compileResult:o,cwd:n,file:r}):{decision:"block",reason:`${i.map(a=>{let l=a.step==null?"":` at "${a.step}"`;return` [${a.rule}]${l} ${a.test}: ${a.message}`}).join(`
|
|
558
576
|
`)}
|
|
559
|
-
${E("create")}`}});async function
|
|
577
|
+
${E("create")}`}});async function Zy({compileResult:e,cwd:t,file:r}){let n=eh(r);if(n==null)return;let o;try{o=X(t)}catch{return}if(await ot({compiled:e.result,config:o,cwd:t}).catch(l=>(g.warn("auto-sync failed: %s",l instanceof Error?l.message:String(l)),null))==null)return;let s=await k({config:o,document:Qy,variables:{cwd:o.cwd,projectId:o.projectId,workflowSlugs:[n]}}).catch(l=>(g.warn("auto-scope failed: %s",l instanceof Error?l.message:String(l)),null));if(!(s==null||(s.addAgentScopeItems??[]).length===0))return{hookSpecificOutput:{additionalContext:`Auto-scoped ${n} (edited test).`,hookEventName:"PostToolUse"}}}function eh(e){if(!/\/\.ripplo\/tests\/[^/]+\.ts$/.test(e))return null;let t=Ky.basename(e,".ts");return t==="index"?null:t}import{z as Js}from"zod";import{existsSync as th,mkdirSync as rh,rmSync as vA,writeFileSync as nh}from"fs";import bn from"path";function zs(e,t,r){let n=Gs(e,t,r);rh(bn.dirname(n),{recursive:!0}),nh(n,"")}function zt(e,t,r){return th(Gs(e,t,r))}function oh(e,t){return bn.join(e,".ripplo",".local","skills-loaded",t)}function Gs(e,t,r){return bn.join(oh(e,t),r)}var ih=Js.looseObject({command:Js.string()}),sh=/\bripplo run\b/,ah="debug",Ks=L("PreToolUse",e=>{if(e.tool_name!=="Bash")return;let t=ih.safeParse(e.tool_input);if(!t.success||!sh.test(t.data.command))return;let{cwd:r}=e;if(!(!O(r)||!V(r))&&!zt(r,e.session_id,ah))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:"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."}}});import lh from"path";import{z as Ys}from"zod";var ch=new Set(["Edit","Write","NotebookEdit"]),dh=Ys.looseObject({file_path:Ys.string()}),uh="create",Xs=L("PreToolUse",e=>{if(!ch.has(e.tool_name))return;let t=dh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!O(r)||!V(r))return;let n=lh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n!==".ripplo"&&!n.startsWith(".ripplo/"))&&!zt(r,e.session_id,uh))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 ph from"path";import Qs from"picomatch";import{graphql as mh}from"gql.tada";import{z as Zs}from"zod";var fh=new Set(["Edit","Write","NotebookEdit"]),gh=Zs.looseObject({file_path:Zs.string()}),yh=mh(`
|
|
560
578
|
query PreEditScopeGate($projectId: String!, $cwd: String!) {
|
|
561
579
|
project(id: $projectId) {
|
|
562
580
|
id
|
|
@@ -568,7 +586,7 @@ ${E("create")}`}});async function Jy({compileResult:e,cwd:t,file:r}){let n=Yy(r)
|
|
|
568
586
|
}
|
|
569
587
|
}
|
|
570
588
|
}
|
|
571
|
-
`),
|
|
589
|
+
`),ea=L("PreToolUse",async e=>{if(!fh.has(e.tool_name))return;let t=gh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!O(r)||!V(r))return;let n=ph.relative(r,t.data.file_path);if(!(n.startsWith("..")||n===".ripplo"||n.startsWith(".ripplo/")||!hh(n)||await wh(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). ${Bi(["scope","create"])}`}}});function hh(e){let{ignorePaths:t,watchPaths:r}=xe(),n=Qs([...r]),o=Qs([...t]);return n(e)&&!o(e)}async function wh(e){let t;try{t=X(e)}catch{return!0}let r=await k({config:t,document:yh,variables:{cwd:t.cwd,projectId:t.projectId}}).catch(()=>null);return r==null?!0:(r.project?.devSession?.scopeItems??[]).length>0}import{graphql as bh}from"gql.tada";var Sh=bh(`
|
|
572
590
|
query ScopeReminder($projectId: String!, $cwd: String!) {
|
|
573
591
|
project(id: $projectId) {
|
|
574
592
|
id
|
|
@@ -585,9 +603,9 @@ ${E("create")}`}});async function Jy({compileResult:e,cwd:t,file:r}){let n=Yy(r)
|
|
|
585
603
|
}
|
|
586
604
|
}
|
|
587
605
|
}
|
|
588
|
-
`),
|
|
606
|
+
`),ta=L("UserPromptSubmit",async e=>{let{cwd:t}=e;if(!O(t)||!V(t))return;let r=We(t);if(He(t,"scope-reminder")===r)return;let n;try{n=X(t)}catch{return}let o=await k({config:n,document:Sh,variables:{cwd:n.cwd,projectId:n.projectId}}).catch(()=>null);if(o==null)return;qe(t,"scope-reminder",r);let i=o.project?.devSession?.scopeItems??[];return{hookSpecificOutput:{additionalContext:i.length===0?`RIPPLO SCOPE: empty. ${E("scope")}`:`RIPPLO SCOPE (${String(i.length)}):
|
|
589
607
|
${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(`
|
|
590
|
-
`)}`,hookEventName:"UserPromptSubmit"}}});var
|
|
608
|
+
`)}`,hookEventName:"UserPromptSubmit"}}});var vh="# 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- **Start the dev server before building features.** Run the user's dev script (e.g. `pnpm dev`) as a background process at the start of feature work. `ripplo watch` runs alongside it, which is what enables Ripplo dev mode and arms the coverage/scope hooks. Without it, edits ship without their guardrails firing.\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 = `ripplo watch` 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",ra=L("SessionStart",e=>{if(O(e.cwd))return{hookSpecificOutput:{additionalContext:vh,hookEventName:"SessionStart"}}});import{execFileSync as kh}from"child_process";import Rh from"path";import na from"process";import{graphql as xh}from"gql.tada";import{z as Gt}from"zod";var Ph=xh(`
|
|
591
609
|
query ScopeEnforce($projectId: String!, $cwd: String!) {
|
|
592
610
|
project(id: $projectId) {
|
|
593
611
|
id
|
|
@@ -606,14 +624,14 @@ ${i.map(a=>{let l=a.workflow;return l==null?` [intent] (${a.id}) ${a.label??""}
|
|
|
606
624
|
}
|
|
607
625
|
}
|
|
608
626
|
}
|
|
609
|
-
`),
|
|
627
|
+
`),ia=L("Stop",async e=>{let{cwd:t}=e;if(!O(t)||!V(t))return;let r=We(t),n=He(t,"stop-enforce")===r;if(n&&!e.stop_hook_active)return;let o=Eh(t),i=await Ch(t,o);if(qe(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:
|
|
610
628
|
${i.join(`
|
|
611
629
|
|
|
612
630
|
`)}`}:{decision:"block",reason:i.join(`
|
|
613
631
|
|
|
614
|
-
`)}});function
|
|
632
|
+
`)}});function Eh(e){return qt(e,".ripplo/tests").filter(t=>t.endsWith(".ts")).map(t=>Rh.basename(t,".ts")).filter(t=>t!=="index")}async function Ch(e,t){let r=await I(e);if(!r.ok)return[`--- Compilation failed ---
|
|
615
633
|
${r.error}
|
|
616
|
-
${E("create")}`];await de({cwd:e,result:r.result}),
|
|
634
|
+
${E("create")}`];await de({cwd:e,result:r.result}),Ue({cwd:e});let n=await Ah(e),o=[...new Set([...t,...n.scopedSlugsToRun])],i=$h(r,t),s=Ih(r),a=Th(e,r),l=jh(e,o);return[i,s,a,l,n.error].filter(c=>c!=null)}function Th(e,t){let{ignorePaths:r}=xe(),n=Gi({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(`
|
|
617
635
|
`);s.push(`Unacknowledged interactions (add to a test's .coverage(...)):
|
|
618
636
|
${a}`)}if(i.length>0){let a=i.map(l=>` ${l.id}`).join(`
|
|
619
637
|
`);s.push(`Stale .coverage(...) claims (id no longer exists in source):
|
|
@@ -621,23 +639,23 @@ ${a}`)}return`--- Exhaustiveness ---
|
|
|
621
639
|
${s.join(`
|
|
622
640
|
|
|
623
641
|
`)}
|
|
624
|
-
${E("create")}`}async function
|
|
642
|
+
${E("create")}`}async function Ah(e){let t;try{t=X(e)}catch{return{error:null,scopedSlugsToRun:[]}}let n=(await k({config:t,document:Ph,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 ---
|
|
625
643
|
${o.join(`
|
|
626
644
|
`)}
|
|
627
|
-
${E("create")}`,scopedSlugsToRun:i}}function
|
|
645
|
+
${E("create")}`,scopedSlugsToRun:i}}function $h(e,t){let{diagnostics:r}=De(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 ---
|
|
628
646
|
${[...i,...s].join(`
|
|
629
647
|
`)}
|
|
630
|
-
${E("create")}`}function
|
|
648
|
+
${E("create")}`}function Ih(e){let{tests:t}=e.builder.getUnimplemented();return t.length===0?null:`--- Unimplemented stubs ---
|
|
631
649
|
${t.join(", ")}
|
|
632
650
|
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.
|
|
633
|
-
${E("create")}`}function
|
|
651
|
+
${E("create")}`}function jh(e,t){if(t.length===0)return null;let r=Oh(["run",...t],e);if(r.code===0)return null;let n=r.output.split(`
|
|
634
652
|
`).filter(o=>/FAILED/.test(o)).join(`
|
|
635
653
|
`);return n.length===0?null:`--- Ripplo Run Failures (${t.join(" ")}) ---
|
|
636
654
|
${n}
|
|
637
|
-
Artifacts: .ripplo/debug/<runId>/. ${E("debug")}`}var
|
|
638
|
-
`),process.exit(1));let r=await
|
|
639
|
-
`),process.exit(1)});function
|
|
640
|
-
`))}export{
|
|
655
|
+
Artifacts: .ripplo/debug/<runId>/. ${E("debug")}`}var Nh=Gt.object({status:Gt.number().nullish(),stderr:Gt.unknown().optional(),stdout:Gt.unknown().optional()});function oa(e){return e instanceof Buffer?e.toString("utf8"):typeof e=="string"?e:""}function Oh(e,t){let r=na.argv[1];if(r==null)return{code:1,output:""};try{return{code:0,output:kh(na.execPath,[r,...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}}catch(n){let o=Nh.safeParse(n);if(!o.success)return{code:1,output:""};let i=`${oa(o.data.stdout)}${oa(o.data.stderr)}`;return{code:o.data.status??1,output:i}}}import{z as sa}from"zod";var Lh=sa.looseObject({skill:sa.string()}),aa=L("PostToolUse",e=>{if(e.tool_name!=="Skill")return;let t=Lh.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&&O(e.cwd)&&zs(e.cwd,e.session_id,n)});qh();xn(process.cwd());var la={"coverage-nudge":_s,"exit-plan-gate":Vs,"plan-reminder":Fs,"post-edit-flag-stubs":Hs,"post-edit-lint":Bs,"pre-bash-run-gate":Ks,"pre-edit-ripplo-skill-gate":Xs,"pre-edit-scope-gate":ea,"scope-reminder":ta,"session-preamble":ra,"stop-enforce":ia,"track-skill-load":aa};async function Uh(){await Dh(_h(process.argv)).scriptName("ripplo").command("watch","Watch for run requests and execute locally",()=>{},()=>Cs()).command("auth <subcommand>","Manage authentication",Hh).command("projects <subcommand>","Inspect Ripplo projects",Wh).command("init","Scaffold .ripplo/ in this project",e=>e.option("project",{type:"string"}).option("env-file",{type:"string"}).option("app-url",{type:"string"}).option("engine-url",{type:"string"}),e=>gs({appUrl:e["app-url"],engineUrl:e["engine-url"],envFile:e["env-file"],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=>Ss(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=>ws({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=>ds({id:e.id,runs:e.runs})).command("sync","Push the compiled .ripplo/ resources to the server (no run)",()=>{},()=>vs()).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=>zi({check:e.check})).command("cover","Audit all coverage statements",()=>{},()=>Xi()).command("doctor","Check project health",()=>{},()=>os()).command("status","Report unimplemented tests and preconditions",e=>e.option("format",{choices:["json","summary"],default:"json",describe:"Output format"}),e=>js({format:e.format})).command("scope <subcommand>","Manage testing scope",Mh).command("hook <name>","Internal: run a Claude Code plugin hook",e=>e.positional("name",{choices:Object.keys(la),demandOption:!0,type:"string"}),e=>Vh(e.name)).option("env",{choices:["dev","local"],describe:"Server environment",type:"string"}).strict().help().parse()}async function Vh(e){let t=la[e];t==null&&(process.stderr.write(`Unknown hook: ${e}
|
|
656
|
+
`),process.exit(1));let r=await Fh(),n=r.trim()===""?{}:JSON.parse(r),o=await t.run(n);o!=null&&process.stdout.write(JSON.stringify(o))}function Fh(){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)})}Uh().catch(e=>{process.stderr.write(`${e instanceof Error?e.message:String(e)}
|
|
657
|
+
`),process.exit(1)});function Mh(e){return e.command("status","Print the current scope",t=>t.option("format",{choices:["json","text"],default:"text",describe:"Output format"}),t=>Ts({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=>As({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=>$s({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=>Is({ids:t.ids})).demandCommand(1)}function Wh(e){return e.command("list","List projects you have access to (JSON)",()=>{},()=>bs()).demandCommand(1)}function Hh(e){return e.command("login","Authenticate via device flow",()=>{},()=>Si()).command("status","Show authentication status",()=>{},()=>vi()).command("logout","Remove the saved token",()=>{},()=>{ki()}).demandCommand(1)}function qh(){let e=process.cwd(),t=Jt(e);t!=null&&t!==e&&(process.chdir(t),process.stderr.write(`ripplo: resolved .ripplo/ at ${t}
|
|
658
|
+
`))}export{Uh as main};
|
|
641
659
|
/*! Bundled license information:
|
|
642
660
|
|
|
643
661
|
mustache/mustache.mjs:
|