ripplo 0.4.4 → 0.4.6
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 +163 -161
- package/package.json +5 -3
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{execFileSync as
|
|
3
|
-
`)}function
|
|
4
|
-
`),n=
|
|
2
|
+
import{execFileSync as ka}from"child_process";import Ra from"fs";import pt from"path";function Zt(e){let t=Pa(e);return t??Rn(e)}function Rn(e){let t=pt.dirname(e);return xa(pt.join(e,".ripplo"))?e:t===e?null:Rn(t)}function xa(e){try{return Ra.statSync(e).isDirectory()}catch{return!1}}function Pa(e){let t=Ca(["rev-parse","--show-toplevel"],e);if(t==null)return null;let r=t.trim();return r.length===0?null:pt.isAbsolute(r)?r:pt.resolve(e,r)}function Ca(e,t){try{return ka("git",e,{cwd:t,encoding:"utf8",stdio:["ignore","pipe","ignore"]})}catch{return null}}import Cn from"fs";import gt from"path";import{config as $a}from"dotenv";import{z as ft}from"zod";import Je from"fs";import tr from"path";import{z as mt}from"zod";var xn=tr.join(".ripplo","project.json"),er=[".env",".env.local"],Ea=mt.object({envFiles:mt.array(mt.string().min(1)).optional(),projectId:mt.string().min(1)});function rr(e){return tr.join(e,xn)}function nr(e){let t=rr(e);if(!Je.existsSync(t))throw new Error(`ripplo: missing ${xn}. Run \`ripplo init\` to create it.`);let r=JSON.parse(Je.readFileSync(t,"utf8")),n=Ea.parse(r);return{envFiles:n.envFiles??er,projectId:n.projectId}}function or(e){let t=rr(e);if(Je.existsSync(t))try{return nr(e)}catch{return}}function Pn({cwd:e,envFiles:t,projectId:r}){let n=rr(e);Je.mkdirSync(tr.dirname(n),{recursive:!0});let o={projectId:r};t!=null&&!Ta(t)&&(o.envFiles=[...t]),Je.writeFileSync(n,JSON.stringify(o,null,2)+`
|
|
3
|
+
`)}function Ta(e){return e.length!==er.length?!1:e.every((t,r)=>t===er[r])}function En(e){let r=or(e)?.envFiles??[".env",".env.local"],n=gt.join(e,".ripplo");r.forEach(o=>{let i=gt.resolve(n,o);Cn.existsSync(i)&&$a({override:!0,path:i,quiet:!0})}),ir=void 0}var Aa=ft.object({RIPPLO_APP_URL:ft.url(),RIPPLO_ENGINE_URL:ft.url(),RIPPLO_WEBHOOK_SECRET:ft.string().min(1)}),ir;function Ie(){return ir??=Ia(),ir}function Ia(){let e=Aa.safeParse(process.env);if(!e.success){let r=e.error.issues.map(s=>` ${s.path.join(".")}: ${s.message}`).join(`
|
|
4
|
+
`),n=sr(process.cwd()),o=n.map(s=>` ${s}`).join(`
|
|
5
5
|
`),i=n.length>0?`
|
|
6
6
|
|
|
7
7
|
Declared env file(s) not found at this path:
|
|
@@ -9,48 +9,48 @@ ${o}
|
|
|
9
9
|
If you're in a git worktree, the env file may not have been copied from the main checkout \u2014 recreate it (or symlink to a shared file outside the working tree).`:"";throw new Error(`ripplo: env config invalid:
|
|
10
10
|
${r}
|
|
11
11
|
|
|
12
|
-
Add missing values to the env file(s) declared in .ripplo/project.json.${i}`)}let t=e.data;return{appUrl:t.RIPPLO_APP_URL,engineUrl:t.RIPPLO_ENGINE_URL,webhookSecret:t.RIPPLO_WEBHOOK_SECRET}}function
|
|
13
|
-
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,E=h.scan(
|
|
12
|
+
Add missing values to the env file(s) declared in .ripplo/project.json.${i}`)}let t=e.data;return{appUrl:t.RIPPLO_APP_URL,engineUrl:t.RIPPLO_ENGINE_URL,webhookSecret:t.RIPPLO_WEBHOOK_SECRET}}function sr(e){let r=or(e)?.envFiles??[],n=gt.join(e,".ripplo");return r.map(o=>gt.resolve(n,o)).filter(o=>!Cn.existsSync(o))}import pw from"yargs";import{hideBin as mw}from"yargs/helpers";import{graphql as rp}from"gql.tada";var ja=Object.prototype.toString,Ne=Array.isArray||function(t){return ja.call(t)==="[object Array]"};function lr(e){return typeof e=="function"}function Na(e){return Ne(e)?"array":typeof e}function ar(e){return e.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")}function Tn(e,t){return e!=null&&typeof e=="object"&&t in e}function Oa(e,t){return e!=null&&typeof e!="object"&&e.hasOwnProperty&&e.hasOwnProperty(t)}var Da=RegExp.prototype.test;function La(e,t){return Da.call(e,t)}var _a=/\S/;function Ua(e){return!La(_a,e)}var Va={"&":"&","<":"<",">":">",'"':""","'":"'","/":"/","`":"`","=":"="};function Fa(e){return String(e).replace(/[&<>"'`=\/]/g,function(r){return Va[r]})}var Ma=/\s*/,Ha=/\s+/,$n=/\s*=/,Wa=/\s*\}/,qa=/#|\^|\/|>|\{|&|=|!/;function Ba(e,t){if(!e)return[];var r=!1,n=[],o=[],i=[],s=!1,a=!1,l="",c=0;function d(){if(s&&!a)for(;i.length;)delete o[i.pop()];else i=[];s=!1,a=!1}var u,f,b;function w(_){if(typeof _=="string"&&(_=_.split(Ha,2)),!Ne(_)||_.length!==2)throw new Error("Invalid tags: "+_);u=new RegExp(ar(_[0])+"\\s*"),f=new RegExp("\\s*"+ar(_[1])),b=new RegExp("\\s*"+ar("}"+_[1]))}w(t||re.tags);for(var h=new Xe(e),v,E,V,B,L,F;!h.eos();){if(v=h.pos,V=h.scanUntil(u),V)for(var ie=0,Ae=V.length;ie<Ae;++ie)B=V.charAt(ie),Ua(B)?(i.push(o.length),l+=B):(a=!0,r=!0,l+=" "),o.push(["text",B,v,v+1]),v+=1,B===`
|
|
13
|
+
`&&(d(),l="",c=0,r=!1);if(!h.scan(u))break;if(s=!0,E=h.scan(qa)||"name",h.scan(Ma),E==="="?(V=h.scanUntil($n),h.scan($n),h.scanUntil(f)):E==="{"?(V=h.scanUntil(b),h.scan(Wa),h.scanUntil(f),E="&"):V=h.scanUntil(f),!h.scan(f))throw new Error("Unclosed tag at "+h.pos);if(E==">"?L=[E,V,v,h.pos,l,c,r]:L=[E,V,v,h.pos],c++,o.push(L),E==="#"||E==="^")n.push(L);else if(E==="/"){if(F=n.pop(),!F)throw new Error('Unopened section "'+V+'" at '+v);if(F[1]!==V)throw new Error('Unclosed section "'+F[1]+'" at '+v)}else E==="name"||E==="{"||E==="&"?a=!0:E==="="&&w(V)}if(d(),F=n.pop(),F)throw new Error('Unclosed section "'+F[1]+'" at '+h.pos);return Ga(za(o))}function za(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 Ga(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 Xe(e){this.string=e,this.tail=e,this.pos=0}Xe.prototype.eos=function(){return this.tail===""};Xe.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};Xe.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 je(e,t){this.view=e,this.cache={".":this.view},this.parent=t}je.prototype.push=function(t){return new je(t,this)};je.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=Tn(i,s[a])||Oa(i,s[a])),i=i[s[a++]];else i=o.view[t],l=Tn(o.view,t);if(l){n=i;break}o=o.parent}r[t]=n}return lr(n)&&(n=n.call(this.view)),n};function G(){this.templateCache={_cache:{},set:function(t,r){this._cache[t]=r},get:function(t){return this._cache[t]},clear:function(){this._cache={}}}}G.prototype.clearCache=function(){typeof this.templateCache<"u"&&this.templateCache.clear()};G.prototype.parse=function(t,r){var n=this.templateCache,o=t+":"+(r||re.tags).join(":"),i=typeof n<"u",s=i?n.get(o):void 0;return s==null&&(s=Ba(t,r),i&&n.set(o,s)),s};G.prototype.render=function(t,r,n,o){var i=this.getConfigTags(o),s=this.parse(t,i),a=r instanceof je?r:new je(r,void 0);return this.renderTokens(s,a,n,t,o)};G.prototype.renderTokens=function(t,r,n,o,i){for(var s="",a,l,c,d=0,u=t.length;d<u;++d)c=void 0,a=t[d],l=a[0],l==="#"?c=this.renderSection(a,r,n,o,i):l==="^"?c=this.renderInverted(a,r,n,o,i):l===">"?c=this.renderPartial(a,r,n,i):l==="&"?c=this.unescapedValue(a,r):l==="name"?c=this.escapedValue(a,r,i):l==="text"&&(c=this.rawValue(a)),c!==void 0&&(s+=c);return s};G.prototype.renderSection=function(t,r,n,o,i){var s=this,a="",l=r.lookup(t[1]);function c(f){return s.render(f,r,n,i)}if(l){if(Ne(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(lr(l)){if(typeof o!="string")throw new Error("Cannot use higher-order sections without the original template");l=l.call(r.view,o.slice(t[3],t[5]),c),l!=null&&(a+=l)}else a+=this.renderTokens(t[4],r,n,o,i);return a}};G.prototype.renderInverted=function(t,r,n,o,i){var s=r.lookup(t[1]);if(!s||Ne(s)&&s.length===0)return this.renderTokens(t[4],r,n,o,i)};G.prototype.indentPartial=function(t,r,n){for(var o=r.replace(/[^ \t]/g,""),i=t.split(`
|
|
14
14
|
`),s=0;s<i.length;s++)i[s].length&&(s>0||!n)&&(i[s]=o+i[s]);return i.join(`
|
|
15
|
-
`)};G.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=
|
|
16
|
-
`):`${e.status}: ${e.title}`;return{specNode:e.specNode,stepResult:o,toolOutput:i}}var
|
|
17
|
-
${r.summary}`,verdict:r.verdict};return Promise.resolve(n)}};import{z as
|
|
15
|
+
`)};G.prototype.renderPartial=function(t,r,n,o){if(n){var i=this.getConfigTags(o),s=lr(n)?n(t[1]):n[t[1]];if(s!=null){var a=t[6],l=t[5],c=t[4],d=s;l==0&&c&&(d=this.indentPartial(s,c,a));var u=this.parse(d,i);return this.renderTokens(u,r,n,d,o)}}};G.prototype.unescapedValue=function(t,r){var n=r.lookup(t[1]);if(n!=null)return n};G.prototype.escapedValue=function(t,r,n){var o=this.getConfigEscape(n)||re.escape,i=r.lookup(t[1]);if(i!=null)return typeof i=="number"&&o===re.escape?String(i):o(i)};G.prototype.rawValue=function(t){return t[1]};G.prototype.getConfigTags=function(t){return Ne(t)?t:t&&typeof t=="object"?t.tags:void 0};G.prototype.getConfigEscape=function(t){if(t&&typeof t=="object"&&!Ne(t))return t.escape};var re={name:"mustache.js",version:"4.2.0",tags:["{{","}}"],clearCache:void 0,escape:void 0,parse:void 0,render:void 0,Scanner:void 0,Context:void 0,Writer:void 0,set templateCache(e){Ye.templateCache=e},get templateCache(){return Ye.templateCache}},Ye=new G;re.clearCache=function(){return Ye.clearCache()};re.parse=function(t,r){return Ye.parse(t,r)};re.render=function(t,r,n,o){if(typeof t!="string")throw new TypeError('Invalid template! Template should be a "string" but "'+Na(t)+'" was given as the first argument for mustache#render(template, view, partials)');return Ye.render(t,r,n,o)};re.escape=Fa;re.Scanner=Xe;re.Context=je;re.Writer=G;var An=re;function Qe({defs:e}){return e==null?{}:Object.fromEntries(Object.entries(e).map(([t,r])=>[t,Ja({def:r,name:t})]))}var Ka={boolean:!1,number:0,string:""};function Ja({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??Ka[e.type]??""}function Ce({ref:e,variables:t}){if(e.type==="static")return e.value;let r=t[e.name];if(r==null||typeof r=="object")throw new Error(`Variable "${e.name}" is not defined`);return r}function K({ref:e,variables:t}){let r=String(Ce({ref:e,variables:t}));return cr({raw:r,variables:t})}function cr({raw:e,variables:t}){return An.render(e,t,{},{escape:r=>r})}function dr({ref:e,variables:t}){let r=Ce({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 Oe({name:e,store:t,value:r}){return{...t,[e]:r}}function U({locator:e,page:t,variables:r}){switch(e.by){case"testId":return t.getByTestId(In(e.value,r));case"role":return t.getByRole(e.role,{exact:!0,name:e.name==null?void 0:In(e.name,r)})}}function In(e,t){return t==null?e:cr({raw:e,variables:t})}async function jn({node:e,page:t,timeout:r}){await U({locator:e.source,page:t,variables:void 0}).dragTo(U({locator:e.target,page:t,variables:void 0}),{timeout:r})}async function Nn({node:e,page:t,timeout:r}){await U({locator:e.locator,page:t,variables:void 0}).click({button:"right",timeout:r})}function On({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 Dn({node:e,page:t,variables:r}){if(e.action==="write"){if(e.value==null)throw new Error("clipboard write requires a value");let o=K({ref:e.value,variables:r}),i=JSON.stringify(o);return await t.evaluate(`navigator.clipboard.writeText(${i})`),{variables:r}}if(e.variable==null)throw new Error("clipboard read requires a variable name to store the result");let n=String(await t.evaluate("navigator.clipboard.readText()"));return{variables:Oe({name:e.variable,store:r,value:n})}}async function Ln({node:e,page:t}){let r=t.context();e.state==="granted"?await r.grantPermissions([e.permission]):await r.clearPermissions()}async function ur({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 Xa({node:e,page:t,timeout:r,variables:n});case"rightClick":return await Nn({node:e,page:t,timeout:r}),{variables:n};case"goto":{let o=K({ref:e.url,variables:n});return await t.goto(o,{timeout:r,waitUntil:"domcontentloaded"}),await t.waitForLoadState("load",{timeout:r}),await t.waitForFunction("document.body != null && document.body.childElementCount > 0 && (document.body.textContent?.trim().length ?? 0) > 0",void 0,{timeout:r}),await t.evaluate("new Promise((resolve) => { requestAnimationFrame(() => requestAnimationFrame(() => resolve(undefined))); })"),{variables:n}}case"fill":return Za({node:e,page:t,timeout:r,variables:n});case"select":return el({node:e,page:t,timeout:r,variables:n});case"type":return tl({node:e,page:t,timeout:r,variables:n});case"press":return await Qa({node:e,page:t,timeout:r}),{variables:n};case"drag":return await jn({node:e,page:t,timeout:r}),{variables:n};case"upload":return rl({node:e,page:t,timeout:r,variables:n});case"extractText":return nl({node:e,page:t,timeout:r,variables:n});case"setVariable":{let o=Ce({ref:e.value,variables:n});return{variables:Oe({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 On({node:e,page:t,variables:n});case"clipboard":return Dn({node:e,page:t,variables:n});case"setPermission":return await Ln({node:e,page:t}),{variables:n}}}var Ya={check:"check",clear:"clear",click:"click",dblclick:"dblclick",focus:"focus",hover:"hover",scrollIntoView:"scrollIntoViewIfNeeded",uncheck:"uncheck"};async function Xa({node:e,page:t,timeout:r,variables:n}){return await U({locator:e.locator,page:t,variables:n})[Ya[e.type]]({timeout:r}),{variables:n}}async function Qa({node:e,page:t,timeout:r}){e.locator==null?await t.keyboard.press(e.key):await U({locator:e.locator,page:t,variables:void 0}).press(e.key,{timeout:r})}async function Za({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).fill(o,{timeout:r}),{variables:n}}async function el({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).selectOption(o,{timeout:r}),{variables:n}}async function tl({node:e,page:t,timeout:r,variables:n}){let o=K({ref:e.value,variables:n});return await U({locator:e.locator,page:t,variables:n}).pressSequentially(o,{timeout:r}),{variables:n}}async function rl({node:e,page:t,timeout:r,variables:n}){return await U({locator:e.locator,page:t,variables:n}).setInputFiles(e.files,{timeout:r}),{variables:n}}async function nl({node:e,page:t,timeout:r,variables:n}){let o=await U({locator:e.locator,page:t,variables:n}).textContent({timeout:r});if(o==null)throw new Error("extractText: element had no text content");return{variables:Oe({name:e.variable,store:n,value:o})}}import Xl from"@anthropic-ai/sdk";import{z as _n}from"zod";import{z as cl}from"zod";async function we({page:e,runStartTime:t,targets:r}){let n=e.viewportSize();if(n==null)throw new Error("Page has no viewport set");return{annotations:await sl(r),snapshotTimestamp:Math.round(performance.now()-t),url:e.url(),viewportHeight:n.height,viewportWidth:n.width}}function ol(e){return"locator"in e}function il(e){let t=globalThis.__ripploRrwebMirror?.getId(e);return t!=null&&t>0?t:void 0}async function sl(e){return(await Promise.all(e.map(r=>al(r)))).filter(r=>r!=null)}async function al(e){if(!ol(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(il).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 yt({node:e,page:t}){if(e.type==="assertUrl")return[{label:e.type,type:"urlBar"}];if(e.type==="drag"){let o=U({locator:e.source,page:t,variables:void 0}),i=U({locator:e.target,page:t,variables:void 0});return[{label:"drag-source",locator:o,type:"action"},{label:"drag-target",locator:i,type:"action"}]}if(!ll(e))return[];let r=e.type.startsWith("assert")?"assertion":"action",n=U({locator:e.locator,page:t,variables:void 0});return[{label:e.type,locator:n,type:r}]}function ll(e){return"locator"in e&&e.locator!=null}function y({description:e,execute:t,name:r,schema:n}){let o=cl.toJSONSchema(n,{target:"draft-2020-12"});return{anthropicTool:{description:e,input_schema:{...o,type:"object"},name:r},name:r,async execute(i,s){let a=n.parse(s);return{...await Promise.resolve(t(i,a)),kind:"action"}}}}async function k(e){let t=e.specNode==null?[]:yt({node:e.specNode,page:e.page}),r=await we({page:e.page,runStartTime:e.runStartTime,targets:t}),n=[...e.assertions],o={annotations:r.annotations,assertions:n,detail:e.detail,duration:Math.round(e.duration),nodeId:`agent-step-${String(e.stepIndex)}`,nodeType:e.nodeType,recordingEndMs:void 0,recordingStartMs:void 0,snapshotTimestamp:r.snapshotTimestamp,status:e.status,stepIndex:e.stepIndex,title:e.title,url:r.url,viewportHeight:r.viewportHeight,viewportWidth:r.viewportWidth},i=n.length>0?n.map(s=>`${s.status}: ${s.description} \u2014 ${s.detail??""}`).join(`
|
|
16
|
+
`):`${e.status}: ${e.title}`;return{specNode:e.specNode,stepResult:o,toolOutput:i}}var dl=_n.object({selector:_n.string().describe("CSS selector for the checkbox or radio button")}),Un=y({description:"Assert that a checkbox or radio button is checked",name:"assert_checked",schema:dl,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).isChecked().catch(()=>!1),o=n?"passed":"failed",i=[{description:`Element ${t.selector} is checked`,detail:n?void 0:"Element is not checked",status:o}];return k({assertions:i,detail:n?"Element is checked":"Element is not checked",duration:performance.now()-r,nodeType:"assertChecked",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:o,stepIndex:e.stepIndex,title:`Assert checked: ${t.selector}`})}});import{z as Vn}from"zod";var ul=Vn.object({selector:Vn.string().describe("CSS selector for the element to check focus on")}),Fn=y({description:"Assert that an element has keyboard focus. Use for accessibility tab-order testing.",name:"assert_focused",schema:ul,execute:async(e,t)=>{let r=performance.now(),o=!!await e.page.locator(t.selector).evaluate("(el) => document.activeElement === el").catch(()=>!1),i=o?"passed":"failed",s=[{description:`Element ${t.selector} is focused`,detail:o?void 0:"Element does not have focus",status:i}];return k({assertions:s,detail:o?"Element is focused":"Element does not have focus",duration:performance.now()-r,nodeType:"assertFocused",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:i,stepIndex:e.stepIndex,title:`Assert focused: ${t.selector}`})}});import{z as pr}from"zod";var pl=pr.object({expected:pr.string().describe("The expected text content"),selector:pr.string().describe("CSS selector for the element to check")}),Mn=y({description:"Assert that an element's text content matches the expected value",name:"assert_text",schema:pl,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).textContent({timeout:5e3}).catch(()=>null),o=n!=null&&n.includes(t.expected),i=o?"passed":"failed",s=[{description:`Text contains "${t.expected}"`,detail:`Actual: "${n??"(not found)"}"`,status:i}];return k({assertions:s,detail:o?`Text matches: "${t.expected}"`:`Expected "${t.expected}", got "${n??"(not found)"}"`,duration:performance.now()-r,nodeType:"assertText",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:i,stepIndex:e.stepIndex,title:`Assert text: ${t.selector}`})}});import{z as mr}from"zod";var ml=mr.object({expected:mr.string().describe("Expected page title or substring"),operator:mr.enum(["equals","contains","startsWith","endsWith"]).describe("Comparison operator").default("contains")}),Hn=y({description:"Assert that the page title matches an expected value",name:"assert_title",schema:ml,execute:async(e,t)=>{let r=performance.now(),n=await e.page.title(),o=fl({actual:n,expected:t.expected,operator:t.operator}),i=o?"passed":"failed",s=[{description:`Title ${t.operator} "${t.expected}"`,detail:o?void 0:`Got: "${n}"`,status:i}],a=`agent-step-${String(e.stepIndex)}`,l={expected:{type:"static",value:t.expected},id:a,operator:t.operator,type:"assertTitle"};return k({assertions:s,detail:o?"Title matches":`Expected title ${t.operator} "${t.expected}", got "${n}"`,duration:performance.now()-r,nodeType:"assertTitle",page:e.page,runStartTime:e.runStartTime,specNode:l,status:i,stepIndex:e.stepIndex,title:`Assert title ${t.operator} "${t.expected}"`})}});function fl({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 Wn}from"zod";var gl=Wn.object({selector:Wn.string().describe("CSS selector for the element to check")}),qn=y({description:"Assert that an element matching the selector is visible on the page",name:"assert_visible",schema:gl,execute:async(e,t)=>{let r=performance.now(),n=await e.page.locator(t.selector).isVisible().catch(()=>!1),o=n?"passed":"failed",i=[{description:`Element ${t.selector} is visible`,detail:n?"Element is visible":"Element is not visible",status:o}];return k({assertions:i,detail:n?"Element is visible":"Element is not visible",duration:performance.now()-r,nodeType:"assertVisible",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:o,stepIndex:e.stepIndex,title:`Assert visible: ${t.selector}`})}});import{z as Bn}from"zod";var yl=Bn.object({selector:Bn.string().describe("CSS selector for the checkbox to check")}),zn=y({description:"Check a checkbox matching the CSS selector",name:"check",schema:yl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).check({timeout:5e3}),k({assertions:[],detail:`Checked ${t.selector}`,duration:performance.now()-r,nodeType:"check",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Check ${t.selector}`})}});import{z as Gn}from"zod";var hl=Gn.object({selector:Gn.string().describe("CSS selector for the input to clear")}),Kn=y({description:"Clear the contents of an input field",name:"clear",schema:hl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).clear({timeout:5e3}),k({assertions:[],detail:`Cleared ${t.selector}`,duration:performance.now()-r,nodeType:"clear",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Clear ${t.selector}`})}});import{z as Jn}from"zod";var wl=Jn.object({selector:Jn.string().describe("CSS selector for the element to click")}),Yn=y({description:"Click an element matching the CSS selector",name:"click",schema:wl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({timeout:5e3}),k({assertions:[],detail:`Clicked ${t.selector}`,duration:performance.now()-r,nodeType:"click",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Click ${t.selector}`})}});import{z as fr}from"zod";var bl=fr.object({action:fr.enum(["read","write"]).describe("Whether to read from or write to the clipboard"),value:fr.string().optional().describe("Text to write (required for write action)")}),Xn=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:bl,execute:async(e,t)=>{let r=performance.now(),n=`agent-step-${String(e.stepIndex)}`;if(t.action==="write"){if(t.value==null)throw new Error("clipboard write requires a value");let s=JSON.stringify(t.value);await e.page.evaluate(`navigator.clipboard.writeText(${s})`);let a={action:"write",id:n,type:"clipboard",value:{type:"static",value:t.value}};return k({assertions:[],detail:`Wrote to clipboard: "${t.value}"`,duration:performance.now()-r,nodeType:"clipboard",page:e.page,runStartTime:e.runStartTime,specNode:a,status:"passed",stepIndex:e.stepIndex,title:"Clipboard write"})}let o=String(await e.page.evaluate("navigator.clipboard.readText()")),i={action:"read",id:n,type:"clipboard"};return k({assertions:[],detail:`Clipboard contents: "${o}"`,duration:performance.now()-r,nodeType:"clipboard",page:e.page,runStartTime:e.runStartTime,specNode:i,status:"passed",stepIndex:e.stepIndex,title:"Clipboard read"})}});import{z as ht}from"zod";var Qn=ht.object({summary:ht.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:ht.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.")}),Zn={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:{...ht.toJSONSchema(Qn,{target:"draft-2020-12"}),type:"object"},name:"complete_test"},name:"complete_test",execute(e,t){let r=Qn.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 eo}from"zod";var Sl=eo.object({selector:eo.string().describe("CSS selector for the element to extract text from")}),to=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:Sl,execute:async(e,t)=>{let r=performance.now(),o=await e.page.locator(t.selector).textContent({timeout:5e3})??"";return k({assertions:[],detail:`Extracted text: "${o}"`,duration:performance.now()-r,nodeType:"extractText",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Extract text from ${t.selector}`})}});import{z as gr}from"zod";var vl=gr.object({selector:gr.string().describe("CSS selector for the input element"),value:gr.string().describe("The text to type into the element")}),ro=y({description:"Clear and type text into an input element matching the CSS selector",name:"fill",schema:vl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).fill(t.value,{timeout:5e3}),k({assertions:[],detail:`Filled ${t.selector} with "${t.value}"`,duration:performance.now()-r,nodeType:"fill",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Fill ${t.selector}`})}});import{z as no}from"zod";var kl=no.object({level:no.string().describe("Filter by log level: 'error', 'warning', 'log', 'info', 'debug', or 'all'").default("all")}),oo=y({description:"Get console log messages from the browser. Optionally filter by level (error, warning, log, info, debug, all).",name:"get_console_logs",schema:kl,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=>Rl(o)).join(`
|
|
18
18
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(r.length)} console messages:
|
|
19
|
-
${n}`}}});function
|
|
20
|
-
`),s=n.length>
|
|
21
|
-
(showing last ${String(
|
|
22
|
-
${i}`}}});import{z as
|
|
19
|
+
${n}`}}});function Rl(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as io}from"zod";var yr=50,xl=io.object({urlFilter:io.string().describe("Optional regex to filter network entries by URL. Omit to see all.").default("")}),so=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:xl,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(-yr),i=o.map(a=>{let l=a.statusCode==null?"pending":String(a.statusCode),c=a.responseHeaders["content-type"]??"";return`${a.method} ${l} ${a.url} [${c}]`}).join(`
|
|
20
|
+
`),s=n.length>yr?`
|
|
21
|
+
(showing last ${String(yr)} of ${String(n.length)})`:"";return{specNode:void 0,stepResult:void 0,toolOutput:`${String(o.length)} network requests:${s}
|
|
22
|
+
${i}`}}});import{z as ao}from"zod";var Pl=ao.object({urlPattern:ao.string().describe("Regex pattern to match the request URL")}),lo=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 co}from"zod";var Cl=co.object({selector:co.string().optional().describe("CSS selector to scope the tree to a subtree (defaults to full page)")}),uo=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:Cl,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 El}from"zod";var Tl=El.object({}),po=y({description:"Get a text representation of the current page content for inspection",name:"get_page_content",schema:Tl,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 $l}from"zod";var Al=$l.object({}),mo=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:Al,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 fo}from"zod";var Il=fo.object({type:fo.enum(["all","cookies","localStorage","sessionStorage"]).describe("Which storage to retrieve").default("all")}),yo=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:Il,execute:async(e,t)=>({specNode:void 0,stepResult:void 0,toolOutput:[...t.type==="all"||t.type==="cookies"?[await jl(e.page)]:[],...t.type==="all"||t.type==="localStorage"?[await go(e.page,"localStorage")]:[],...t.type==="all"||t.type==="sessionStorage"?[await go(e.page,"sessionStorage")]:[]].join(`
|
|
38
38
|
|
|
39
|
-
`)})});async function
|
|
39
|
+
`)})});async function jl(e){let t=await e.context().cookies();if(t.length===0)return`## Cookies
|
|
40
40
|
(none)`;let r=t.map(n=>` ${n.name}=${n.value} (domain=${n.domain}, httpOnly=${String(n.httpOnly)}, secure=${String(n.secure)}, sameSite=${n.sameSite})`);return`## Cookies (${String(t.length)})
|
|
41
41
|
${r.join(`
|
|
42
|
-
`)}`}async function
|
|
43
|
-
${String(r)}`}import{z as
|
|
42
|
+
`)}`}async function go(e,t){let r=await e.evaluate(`JSON.stringify(Object.fromEntries(Object.entries(${t})))`);return`## ${t}
|
|
43
|
+
${String(r)}`}import{z as hr}from"zod";var Nl=hr.object({action:hr.enum(["accept","dismiss"]).describe("Whether to accept or dismiss the dialog"),promptText:hr.string().optional().describe("Text to enter for prompt dialogs")}),ho=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:Nl,execute:(e,t)=>{let r=performance.now();e.page.once("dialog",async i=>{t.action==="accept"?await i.accept(t.promptText??void 0):await i.dismiss()});let n=`agent-step-${String(e.stepIndex)}`,o={action:t.action,id:n,type:"handleDialog"};return k({assertions:[],detail:`Dialog handler set: ${t.action}`,duration:performance.now()-r,nodeType:"handleDialog",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Handle dialog: ${t.action}`})}});import{z as wo}from"zod";var Ol=wo.object({selector:wo.string().describe("CSS selector for the element to hover over")}),bo=y({description:"Hover over an element matching the CSS selector",name:"hover",schema:Ol,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).hover({timeout:5e3}),k({assertions:[],detail:`Hovered over ${t.selector}`,duration:performance.now()-r,nodeType:"hover",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Hover ${t.selector}`})}});import{z as wr}from"zod";var Dl=wr.object({permission:wr.string().describe("Permission name (e.g. geolocation, notifications, camera, clipboard-read)"),state:wr.enum(["granted","prompt"]).describe("Permission state to set")}),So=y({description:"Set a browser permission state (geolocation, notifications, camera, etc.)",name:"set_permission",schema:Dl,execute:async(e,t)=>{let r=performance.now(),n=e.page.context();t.state==="granted"?await n.grantPermissions([t.permission]):await n.clearPermissions();let i={id:`agent-step-${String(e.stepIndex)}`,permission:t.permission,state:t.state,type:"setPermission"};return k({assertions:[],detail:`Set ${t.permission} to ${t.state}`,duration:performance.now()-r,nodeType:"setPermission",page:e.page,runStartTime:e.runStartTime,specNode:i,status:"passed",stepIndex:e.stepIndex,title:`Set permission: ${t.permission} \u2192 ${t.state}`})}});import{z as vo}from"zod";var Ll=vo.object({url:vo.string().describe("The URL to navigate to")}),ko=y({description:"Navigate the browser to a URL",name:"navigate",schema:Ll,execute:async(e,t)=>{let r=performance.now();await e.page.goto(t.url,{waitUntil:"domcontentloaded"});let o={id:`agent-step-${String(e.stepIndex)}`,type:"goto",url:{type:"static",value:t.url}};return k({assertions:[],detail:`Navigated to ${t.url}`,duration:performance.now()-r,nodeType:"goto",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Navigate to ${t.url}`})}});import{z as Ro}from"zod";var _l=Ro.object({key:Ro.string().describe("Key to press, e.g. 'Enter', 'Tab', 'Escape'")}),xo=y({description:"Press a keyboard key",name:"press",schema:_l,execute:async(e,t)=>{let r=performance.now();await e.page.keyboard.press(t.key);let o={id:`agent-step-${String(e.stepIndex)}`,key:t.key,type:"press"};return k({assertions:[],detail:`Pressed ${t.key}`,duration:performance.now()-r,nodeType:"press",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Press ${t.key}`})}});import{z as br}from"zod";var Ul=br.object({height:br.number().int().positive().describe("Viewport height in pixels"),width:br.number().int().positive().describe("Viewport width in pixels")}),Po=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:Ul,execute:async(e,t)=>{let r=performance.now();await e.page.setViewportSize({height:t.height,width:t.width});let n=`agent-step-${String(e.stepIndex)}`,o={height:t.height,id:n,type:"setViewport",width:t.width};return k({assertions:[],detail:`Resized viewport to ${String(t.width)}x${String(t.height)}`,duration:performance.now()-r,nodeType:"setViewport",page:e.page,runStartTime:e.runStartTime,specNode:o,status:"passed",stepIndex:e.stepIndex,title:`Resize viewport to ${String(t.width)}x${String(t.height)}`})}});import{z as Co}from"zod";var Vl=Co.object({selector:Co.string().describe("CSS selector for the element to right-click")}),Eo=y({description:"Right-click an element to open the context menu",name:"right_click",schema:Vl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).click({button:"right",timeout:5e3}),k({assertions:[],detail:`Right-clicked ${t.selector}`,duration:performance.now()-r,nodeType:"rightClick",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Right-click ${t.selector}`})}});import{z as To}from"zod";var Fl=To.object({pattern:To.string().describe("Regex pattern to search console log messages")}),$o=y({description:"Search console log messages for a regex pattern. Returns matching entries.",name:"search_console",schema:Fl,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=>Ml(i)).join(`
|
|
44
44
|
`);return{specNode:void 0,stepResult:void 0,toolOutput:`${String(n.length)} matching console messages:
|
|
45
|
-
${o}`}}});function
|
|
45
|
+
${o}`}}});function Ml(e){let t=e.url.length>0?` (${e.url})`:"";return`[${e.level.toUpperCase()}] ${e.text}${t}`}import{z as Ao}from"zod";var Hl=Ao.object({pattern:Ao.string().describe("Regex pattern to search across network request URLs and response bodies")}),Io=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:Hl,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 jo}from"zod";var Wl=20,ql=2,Bl=jo.object({pattern:jo.string().describe("Regex pattern to search for in the page HTML")}),No=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:Bl,execute:async(e,t)=>{let n=(await e.page.content()).split(`
|
|
48
|
+
`),o=zl({contextLines:ql,lines:n,maxResults:Wl,pattern:t.pattern});return o.length===0?{specNode:void 0,stepResult:void 0,toolOutput:`No matches found for pattern: ${t.pattern}`}:{specNode:void 0,stepResult:void 0,toolOutput:o.join(`
|
|
49
49
|
---
|
|
50
|
-
`)}}});function
|
|
51
|
-
`);i.push(d)}),i}import{z as
|
|
52
|
-
${u.stack??""}`)}function c(u){let f=u.failure(),b=new
|
|
53
|
-
`);async function
|
|
50
|
+
`)}}});function zl({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 Sr}from"zod";var Gl=Sr.object({selector:Sr.string().describe("CSS selector for the select element"),value:Sr.string().describe("The option value to select")}),Oo=y({description:"Select an option from a dropdown/select element",name:"select",schema:Gl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).selectOption(t.value,{timeout:5e3}),k({assertions:[],detail:`Selected "${t.value}" in ${t.selector}`,duration:performance.now()-r,nodeType:"select",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Select ${t.value}`})}});import{z as Do}from"zod";var Kl=Do.object({selector:Do.string().describe("CSS selector for the checkbox to uncheck")}),Lo=y({description:"Uncheck a checkbox matching the CSS selector",name:"uncheck",schema:Kl,execute:async(e,t)=>{let r=performance.now();return await e.page.locator(t.selector).uncheck({timeout:5e3}),k({assertions:[],detail:`Unchecked ${t.selector}`,duration:performance.now()-r,nodeType:"uncheck",page:e.page,runStartTime:e.runStartTime,specNode:void 0,status:"passed",stepIndex:e.stepIndex,title:`Uncheck ${t.selector}`})}});var wt=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 Ze(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 wt(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 wt(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 vr=[ko,Yn,ro,xo,zn,Lo,Oo,bo,po,No,Kn,Eo,ho,Xn,So,qn,Mn,Hn,Un,Fn,oo,so,lo,mo,uo,yo,$o,Io,Po,to,Zn],Jl=new Map(vr.map(e=>[e.name,e])),kr=vr.map(e=>e.anthropicTool),_o=vr.map(e=>`- **${e.name}**: ${e.anthropicTool.description??""}`).join(`
|
|
53
|
+
`);async function Uo({input:e,monitor:t,name:r,page:n,runStartTime:o,stepIndex:i}){let s=Jl.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 wv from"fs";import Sv from"path";import Yl from"pino";var g=Yl({transport:{options:{ignore:"pid,hostname"},target:"pino-pretty"}});var Ql=50,Vo=16384;async function Rr({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 Xl({apiKey:"ripplo",baseURL:`${s}/api/proxy/anthropic`,defaultHeaders:{Authorization:`Bearer ${c}`,"x-run-id":i}}),f=performance.now(),b=Ze(o);await sc({baseUrl:e,page:o});let w=tc({extraVariables:r,spec:a}),h=nc({baseUrl:e,executedPreconditions:t,spec:a,systemPrompt:l,variables:w,workflowContext:d}),v=oc({baseUrl:e,spec:a,variables:w}),V=[{content:ic({page:o,startUrl:v}),role:"user"}],B=[],L=[],F={findings:"",stepIndex:0,verdict:void 0};F=await Zl({client:u,messages:V,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:L,state:F,steps:B,system:h}),F.verdict==null&&(F=await ec({client:u,messages:V,monitor:b,onStep:n,page:o,runStartTime:f,specNodes:L,state:F,steps:B,system:h}));let ie=lc(L);return{findings:F.findings,generatedSpec:ie,monitor:b,steps:B,verdict:F.verdict??"fail"}}function Fo({result:e,state:t}){return{findings:e.newFindings.length>0?e.newFindings:t.findings,stepIndex:e.nextStepIndex,verdict:e.verdict??t.verdict}}async function Zl({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<Ql;u++){g.info("Agent iteration %d",u+1);let f=await e.messages.create({max_tokens:Vo,messages:t,model:"server-controlled",system:c,tools:kr}),b=await Mo({messages:t,monitor:r,onStep:n,page:o,response:f,runStartTime:i,specNodes:s,stepIndex:d.stepIndex,steps:l});if(d=Fo({result:b,state:d}),!b.continueLoop)break}return d}async function ec({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:Vo,messages:t,model:"server-controlled",system:c,tool_choice:{name:"complete_test",type:"tool"},tools:kr}),u=await Mo({messages:t,monitor:r,onStep:n,page:o,response:d,runStartTime:i,specNodes:s,stepIndex:a.stepIndex,steps:l});return Fo({result:u,state:a})}function tc({extraVariables:e,spec:t}){let r=rc(e,t?.variableNamespaces);return{...Qe({defs:t?.variables}),...r}}function rc(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 nc({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`,_o,s,c,a,f,`
|
|
75
75
|
## Agent Profile (HIGHEST PRIORITY \u2014 these instructions override any defaults above)`,n].join(`
|
|
76
|
-
`)}function
|
|
77
|
-
`),nextStepIndex:a,verdict:void 0};let u=[],f=a,b,w;for(let v of d){let E=await
|
|
78
|
-
`);return{continueLoop:b==null&&o.stop_reason==="tool_use",newFindings:h,nextStepIndex:f,verdict:b}}async function
|
|
76
|
+
`)}function oc({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 ic({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 sc({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 Mo({messages:e,monitor:t,onStep:r,page:n,response:o,runStartTime:i,specNodes:s,stepIndex:a,steps:l}){let c=o.content.filter(v=>v.type==="text").map(v=>v.text),d=o.content.filter(v=>v.type==="tool_use");if(d.length===0)return{continueLoop:!1,newFindings:c.join(`
|
|
77
|
+
`),nextStepIndex:a,verdict:void 0};let u=[],f=a,b,w;for(let v of d){let E=await ac({block:v,monitor:t,onStep:r,page:n,runStartTime:i,specNodes:s,stepIndex:f,steps:l});u.push(E.toolResult),f=E.nextStepIndex,E.verdict!=null&&(b=E.verdict,w=E.summary)}e.push({content:o.content,role:"assistant"},{content:u,role:"user"});let h=w??c.join(`
|
|
78
|
+
`);return{continueLoop:b==null&&o.stop_reason==="tool_use",newFindings:h,nextStepIndex:f,verdict:b}}async function ac({block:e,monitor:t,onStep:r,page:n,runStartTime:o,specNodes:i,stepIndex:s,steps:a}){try{let l=await Uo({input:e.input,monitor:t,name:e.name,page:n,runStartTime:o,stepIndex:s}),c={content:l.toolOutput,tool_use_id:e.id,type:"tool_result"};return l.kind==="verdict"?(g.info(" [%d] %s \u2014 verdict: %s",s,e.name,l.verdict),{nextStepIndex:s,summary:l.summary,toolResult:c,verdict:l.verdict}):(l.specNode!=null&&i.push(l.specNode),l.stepResult!=null?(a.push(l.stepResult),r?.(l.stepResult),g.info(" [%d] %s \u2014 %s",s,e.name,l.stepResult.status),{nextStepIndex:s+1,summary:void 0,toolResult:c,verdict:void 0}):(g.info(" [%d] %s \u2014 info",s,e.name),{nextStepIndex:s,summary:void 0,toolResult:c,verdict:void 0}))}catch(l){let c=l instanceof Error?l.message:"Unknown error";g.error(" [%d] %s \u2014 error: %s",s,e.name,c);let d=await we({page:n,runStartTime:o,targets:[]}),u={annotations:d.annotations,assertions:[],detail:`Error: ${c}`,duration:0,nodeId:`agent-step-${String(s)}`,nodeType:"click",recordingEndMs:void 0,recordingStartMs:void 0,snapshotTimestamp:d.snapshotTimestamp,status:"failed",stepIndex:s,title:`${e.name} (error)`,url:d.url,viewportHeight:d.viewportHeight,viewportWidth:d.viewportWidth};return a.push(u),r?.(u),{nextStepIndex:s+1,summary:void 0,toolResult:{content:`Error: ${c}`,is_error:!0,tool_use_id:e.id,type:"tool_result"},verdict:void 0}}}function lc(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 xr({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.',cc({hasSuccessCriteria:r!=null&&r.length>0}),dc({hasOutput:t!=null&&t.length>0})];return n.push(o.join(`
|
|
82
82
|
`)),n.join(`
|
|
83
83
|
|
|
84
|
-
`)}function
|
|
84
|
+
`)}function cc({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 dc({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 uc}from"child_process";import{createRequire as pc}from"module";import Ho from"fs";import Wo from"path";import{chromium as qo}from"playwright";async function Ee({headed:e}){process.env.PW_TEST_SCREENSHOT_NO_FONTS_READY="1";try{return await qo.launch({headless:!e})}catch(t){throw mc(t)?new Error(`Playwright browsers are not installed. Run:
|
|
85
85
|
|
|
86
86
|
npx playwright install chromium
|
|
87
|
-
`):t}}async function
|
|
87
|
+
`):t}}async function Pr(){let e=qo.executablePath();if(Ho.existsSync(e))return;g.info("Chromium not found. Installing via Playwright...");let t=pc(import.meta.url),r=Wo.dirname(t.resolve("playwright/package.json")),n=Wo.join(r,"cli.js");if(await new Promise((o,i)=>{uc(process.execPath,[n,"install","chromium"],s=>{if(s!=null){i(new Error(`Playwright install failed: ${s.message}`));return}o()})}),!Ho.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 mc(e){return e instanceof Error?e.message.includes("Executable doesn't exist"):!1}import{mkdir as Cr,writeFile as se}from"fs/promises";import J from"path";async function bt({context:e,page:t,runId:r,stepIndex:n,stepResult:o}){try{let i=J.join(process.cwd(),".ripplo","debug",r,"steps",String(n));await Cr(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)),fc({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 fc({context:e,page:t,stepDir:r}){let[n,o,i,s]=await Promise.all([t.content().catch(()=>"(unable to capture DOM)"),gc(t),yc({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 gc(e){try{return await e.locator(":root").ariaSnapshot()}catch{return"(unable to capture accessibility tree)"}}async function yc({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 St({monitor:e,runId:t,steps:r,summary:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await Cr(o,{recursive:!0}),await Promise.all([se(J.join(o,"summary.txt"),hc({steps:r,summary:n})),se(J.join(o,"console.log"),wc(e.consoleEntries)),se(J.join(o,"network.jsonl"),bc(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 hc({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 wc(e){return e.map(t=>`[${new Date(t.timestamp).toISOString()}] [${t.level.toUpperCase()}] (${t.url}) ${t.text}`).join(`
|
|
94
|
+
`)}function bc(e){return e.map(t=>JSON.stringify(t)).join(`
|
|
95
|
+
`)}async function Bo({error:e,runId:t,stack:r,workflowName:n}){try{let o=J.join(process.cwd(),".ripplo","debug",t);await Cr(o,{recursive:!0});let i=r==null?e:`${e}
|
|
96
96
|
|
|
97
97
|
${r}`,s=[`Run ID: ${t}`,`Workflow: ${n}`,"Status: failed","",`Error: ${e}`,"",r==null?"":`Stack trace:
|
|
98
98
|
${r}`].join(`
|
|
99
|
-
`);await Promise.all([se(J.join(o,"error.txt"),i),se(J.join(o,"summary.txt"),s)]),g.info("Debug error artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write error debug artifacts: %s",i)}}import{readFileSync as
|
|
100
|
-
`),
|
|
101
|
-
`+
|
|
102
|
-
`),w={body:
|
|
99
|
+
`);await Promise.all([se(J.join(o,"error.txt"),i),se(J.join(o,"summary.txt"),s)]),g.info("Debug error artifacts written to .ripplo/debug/%s/",t)}catch(o){let i=o instanceof Error?o.message:String(o);g.warn("Failed to write error debug artifacts: %s",i)}}import{readFileSync as Sc}from"fs";import{createRequire as vc}from"module";import zo from"path";import{gzipSync as kc}from"zlib";var Rc=vc(import.meta.url),xc=Rc.resolve("rrweb"),Pc=zo.join(zo.dirname(xc),"rrweb.umd.min.cjs"),Cc=Sc(Pc,"utf8"),Ec=[";(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
|
+
`),Tc=Cc+`
|
|
101
|
+
`+Ec;function $c(){return globalThis.__ripploRrwebStartedAt}function Ac(){globalThis.__ripploRrwebStart?.()}function Ic(){globalThis.__ripploRrwebStop?.()}function jc(){return globalThis.__ripploRrwebDrain?.()??[]}async function vt(e){let t,r=0;async function n(){await e.addScriptTag({content:Tc}).catch(()=>{})}await n(),e.on("load",()=>{n()});async function o(){await e.evaluate(Ac).catch(()=>{});let l=await e.evaluate($c).catch(()=>{});typeof l=="number"&&(t??=l)}function i(){if(t!=null)return Date.now()-t}async function s(){let l=await e.evaluate(jc).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:kc(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(Ic).catch(()=>{})}return{currentOffsetMs:i,detach:a,start:o,takeChunk:s}}async function Er({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 Ee({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 vt(w);async function v(){let B=await h.takeChunk();B!=null&&l.enqueueRecordingChunk(B)}let E=setInterval(()=>{v()},2e3);await h.start();try{let B=function(ae){let Ke={...ae,recordingEndMs:h.currentOffsetMs(),recordingStartMs:ae.recordingStartMs??h.currentOffsetMs()};l.enqueueStep(Ke),l.flushSteps(),bt({context:b,page:w,runId:i,stepIndex:Ke.stepIndex,stepResult:Ke})};var V=B;let L=await Rr({baseUrl:e,executedPreconditions:r,extraVariables:n,onStep:B,page:w,runId:i,serverUrl:s,spec:a,systemPrompt:c,token:d,workflowContext:u}),F=L.verdict==="pass"?"passed":"failed";await l.complete({statusOverride:F,steps:L.steps,summary:L.findings});let ie=L.steps.filter(ae=>ae.status==="passed").length,Ae=L.steps.filter(ae=>ae.status==="failed").length,_={duration:L.steps.reduce((ae,Ke)=>ae+Ke.duration,0),failCount:Ae,passCount:ie,runId:i,status:F,workflowName:u.name};await St({monitor:L.monitor,runId:i,steps:L.steps,summary:_}),g.info("Agent test complete: %d passed, %d failed",ie,Ae),g.info(`
|
|
103
103
|
=== Agent Summary ===
|
|
104
|
-
%s`,
|
|
104
|
+
%s`,L.findings)}finally{clearInterval(E),await h.detach(),await v(),await f.close()}}async function Tr({expected:e,locator:t,operator:r,timeout:n}){let o=await t.textContent({timeout:n});return et({actual:o??"",expected:e,label:"Text",operator:r})}function kt({expected:e,operator:t,url:r}){return et({actual:r,expected:e,label:"URL",operator:t})}async function $r({expected:e,locator:t,operator:r}){let n=await t.count();return ei({actual:n,expected:e,label:"Count",operator:r})}async function Ar({expected:e,locator:t,operator:r,timeout:n}){let o=await t.inputValue({timeout:n});return et({actual:o,expected:e,label:"Value",operator:r})}async function Ir({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 jr({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 Go({attribute:e,expected:t,locator:r,operator:n,timeout:o}){let i=await r.getAttribute(e,{timeout:o});return et({actual:i??"",expected:t,label:`Attribute "${e}"`,operator:n})}async function Ko({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 Jo({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 Yo({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 Xo({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 Qo({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 Zo({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 et(e){let t=`${e.label} ${e.operator} "${e.expected}"`,r=Nc(e),n=r?void 0:`Got: "${e.actual}"`;return{description:t,detail:n,status:r?"passed":"failed"}}function Nc({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 ei(e){let t=`${e.label} ${e.operator} ${String(e.expected)}`,r=Oc(e),n=r?void 0:`Got: ${String(e.actual)}`;return{description:t,detail:n,status:r?"passed":"failed"}}function Oc({actual:e,expected:t,operator:r}){return r==="equals"?e===t:r==="notEquals"?e!==t:r==="greaterThan"?e>t:r==="greaterThanOrEqual"?e>=t:r==="lessThan"?e<t:e<=t}import{readdir as Fc,rm as Mc,stat as Hc}from"fs/promises";import nk from"os";import ni from"path";import{graphql as Wc}from"gql.tada";import{print as Dc}from"graphql";var Lc=15e3;async function S(e){let t=Dc(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(Lc)})}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 _c({res:o,url:n});if(!Uc(i))throw new Error("Invalid GraphQL response");if(Vc(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 _c({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 Uc(e){return typeof e=="object"&&e!=null&&("data"in e||"errors"in e)}function Vc(e){return Array.isArray(e.errors)&&e.errors.length>0}var ti=ni.join(process.cwd(),".ripplo","debug"),ri=360*60*1e3,lk=Wc(`
|
|
105
105
|
mutation RevokeCurrentCliToken {
|
|
106
106
|
revokeCurrentCliToken
|
|
107
107
|
}
|
|
108
|
-
`);async function
|
|
109
|
-
`))}}import ot from"fs";import
|
|
110
|
-
`),t}function nt(e,t){return tt.join(
|
|
111
|
-
`,{mode:384})}function
|
|
112
|
-
\u2192 /ripplo:debug \u2014 check .ripplo/debug/<runId>/ artifacts`,status:"failed"}}function
|
|
113
|
-
Load \`/ripplo:setup\` skill for instructions on engine endpoint + webhook secret wiring.`,status:"failed"}:t.kind==="pass"?{description:`observer "${e}"`,detail:n.pollCount>1?`passed after ${String(n.pollCount)} polls (${
|
|
114
|
-
Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=t.reason,null)}async function Gd({apiUrl:e,observer:t,params:r,webhookSecret:n}){let o=JSON.stringify({observer:t,params:r});try{let i=await fetch(`${e}/execute-observer`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(Hd)});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=Bd.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 Kd({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function pi(e){return`${String(Math.round(performance.now()-e))}ms`}async function Jd(e){return new Promise(t=>setTimeout(t,e))}async function X({fn:e,label:t}){let r=performance.now(),n=await e();return g.info("%s: %dms",t,Math.round(performance.now()-r)),n}var Yd=1e4;async function Wr({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return Qd({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function Xd({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function Qd({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 Zd({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(Xd({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function Zd({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=Yd,u=gt({node:t,page:o});try{let f=await eu({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(E=>E.status==="failed"),h=await X({label:`Snapshot [${c}]`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:w?"failed":"passed",stepIndex:0,title:c,url:h.url,variables:f.variables,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}catch(f){let b=Math.round(performance.now()-a),w=f instanceof Error?f.message:String(f),h=await X({label:`Snapshot [${c}] (error)`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function eu({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(tu(e)){let s=await lr({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await nu({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function tu(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 ru(e){return e.type.startsWith("assert")}async function nu({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!ru(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 iu({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=K({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"assertUrl":{let s=K({ref:i.expected,variables:o});return[vt({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=K({ref:i.expected,variables:o});return[vt({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=ar({ref:i.expected,variables:o});return[await Cr({expected:s,locator:L({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=K({ref:i.expected,variables:o});return[await Er({expected:s,locator:L({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=K({ref:i.expected,variables:o});return[await zo({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]=K({ref:l,variables:o})}),[await ui({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var ou={assertChecked:Jo,assertDisabled:Ko,assertEnabled:Go,assertFocused:Xo,assertNotChecked:Yo,assertNotFocused:Qo,assertNotVisible:$r,assertVisible:Tr};async function iu({assertNode:e,page:t,timeout:r,variables:n}){let o=ou[e.type];return[await o({locator:L({locator:e.locator,page:t,variables:n}),timeout:r})]}async function qr({baseUrl:e,browser:t,cookies:r,extraVariables:n,observerTransport:o,onRecordingChunk:i,onStep:s,runId:a,spec:l}){let c=await t.newContext({baseURL:e});g.info("Browser context created"),r.length>0&&await c.addCookies(r);let d=await c.newPage();g.info("Page created");let u=Ze(d),f=await St(d);async function b(){let D=await f.takeChunk();D!=null&&i?.(D)}let w=setInterval(()=>{b()},2e3),h=[],v=!1;function E(D){s?.(D),v||(v=!0,f.start()),h.push(wt({context:c,page:d,runId:a,stepIndex:D.stepIndex,stepResult:D}))}let _=su(n,l.variableNamespaces),B={...Xe({defs:l.variables}),..._};g.info("Starting graph execution (entry: %s)",l.entryNode);let O=await Wr({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:E,page:d,spec:l,variables:B});await Promise.allSettled(h);let U=O.steps.filter(D=>D.status==="passed").length,ie=O.steps.filter(D=>D.status==="failed").length,$e={duration:O.steps.reduce((D,le)=>D+le.duration,0),failCount:ie,passCount:U,runId:a,status:ie>0?"failed":"passed",workflowName:""};return await bt({monitor:u,runId:a,steps:O.steps,summary:$e}),clearInterval(w),await f.detach(),await b(),await c.close(),O.steps}function su(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 au}from"set-cookie-parser";import{z as Z}from"zod";var mi=3e4,lu=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 Br({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:fi({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function zr({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",...pu({cookies:t}),...ke({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(mi)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function fi({apiUrl:e,preconditionNames:t,webhookSecret:r}){let n=performance.now(),o=JSON.stringify({preconditions:t}),i=await fetch(`${e}/execute-preconditions`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(mi)});if(!i.ok){let c=await du(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=lu.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=mu({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 cu=Z.object({error:Z.string()});async function du(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=uu(t),n=r==null?null:cu.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function uu(e){try{return JSON.parse(e)}catch{return null}}function pu({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function mu({domain:e,res:t}){let r=t.headers.getSetCookie();return au(r,{decodeValues:!1}).map(o=>fu({cookie:o,domain:e}))}function fu({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=yu({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 gu={lax:"Lax",none:"None",strict:"Strict"};function yu({raw:e}){return gu[e.toLowerCase()]??"Lax"}async function Gr({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:[]}:fi({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as It}from"gql.tada";async function Kr({agentProfileId:e,config:t,runId:r}){let n=await S({config:t,document:bu,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=wu({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=hu({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 X({label:`flushSteps (${String(i.length)} steps)`,fn:()=>Promise.all(i)});let b=u.filter(E=>E.status==="passed").length,w=u.filter(E=>E.status==="failed").length,h=u.reduce((E,_)=>E+_.duration,0),v=d??(w>0?"failed":"passed");await X({label:"completeRun",fn:()=>S({config:t,document:ku,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:v,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function hu({chunk:e,config:t,runResultId:r}){await S({config:t,document:vu,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function wu({config:e,runResultId:t,steps:r}){let n=r.map(o=>({annotations:o.annotations.map(i=>({height:i.height,label:i.label,rrwebNodeId:i.rrwebNodeId??null,type:i.type,width:i.width,x:i.x,y:i.y})),assertions:o.assertions.map(i=>({description:i.description,detail:i.detail,status:i.status})),detail:o.detail,duration:o.duration,nodeType:o.nodeType,recordingEndMs:o.recordingEndMs??null,recordingStartMs:o.recordingStartMs??null,snapshotTimestamp:o.snapshotTimestamp,status:o.status,stepIndex:o.stepIndex,title:o.title,url:o.url,viewportHeight:o.viewportHeight,viewportWidth:o.viewportWidth}));await S({config:e,document:Su,variables:{runResultId:t,steps:n}})}var bu=It(`
|
|
108
|
+
`);async function Nr({maxRuns:e}){try{let r=(await Fc(ti,{withFileTypes:!0})).filter(c=>c.isDirectory()),n=Date.now(),o=await Promise.all(r.map(async c=>{let d=ni.join(ti,c.name),u=await Hc(d);return{dirPath:d,mtime:u.mtimeMs}})),i=o.filter(c=>n-c.mtime>ri),a=o.filter(c=>n-c.mtime<=ri).toSorted((c,d)=>d.mtime-c.mtime).slice(e),l=[...i,...a];if(l.length===0)return;await Promise.allSettled(l.map(c=>Mc(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 qc=5e3;async function Or({appUrl:e}){try{await fetch(e,{method:"HEAD",signal:AbortSignal.timeout(qc)})}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 ot from"fs";import Te from"fs";import Bc from"os";import tt from"path";var zc=".local",Gc=".ripplo";function Dr(e){return tt.join(e,".ripplo",zc)}function rt(e){let t=Dr(e);Te.existsSync(t)||Te.mkdirSync(t,{recursive:!0});let r=tt.join(t,".gitignore");return Te.existsSync(r)||Te.writeFileSync(r,`*
|
|
110
|
+
`),t}function nt(e,t){return tt.join(Dr(e),t)}function Lr(){return tt.join(Bc.homedir(),Gc)}function _r(){let e=Lr();return Te.existsSync(e)?Te.chmodSync(e,448):Te.mkdirSync(e,{mode:448,recursive:!0}),e}function be(e){return tt.join(Lr(),e)}function ne(){let e=process.env.RIPPLO_TOKEN;if(e!=null&&e.trim().length>0)return e.trim();let t=be("token");if(!ot.existsSync(t))return null;let r=ot.readFileSync(t,"utf8").trim();return r.length===0?null:r}function Ur(e){_r(),ot.writeFileSync(be("token"),e+`
|
|
111
|
+
`,{mode:384})}function Vr(){let e=be("token");return ot.existsSync(e)?(ot.unlinkSync(e),!0):!1}import{z as me}from"zod";import{z as Rt}from"zod";var Kc=Rt.object({__codec:Rt.string().min(1),data:Rt.unknown(),version:Rt.number().int().positive()}),xt=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}},Pt=class extends Error{constructor(t){super(`Codec mismatch: expected "${t.expected}", got "${t.got}"`),this.name="CodecMismatchError"}};function Ct(e){return oi({legacy:void 0,migrators:[],name:e,schemas:[]})}function oi(e){return{initial:t=>Fr(t,{...e,schemas:[t]}),legacy:t=>oi({...e,legacy:t})}}function Fr(e,t){return{build:()=>Jc(e,t),legacy:r=>Fr(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return Fr(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function Jc(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>Yc(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function Yc(e,t,r){let{data:n,version:o}=Xc(t,r),i=ii(t,n,o);return e.parse(i)}function Xc(e,t){let r=Kc.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new Pt({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 ii(e,t,r){let n=e.schemas.length;if(r>n)throw new xt({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 ii(e,s(i),r+1)}import{z as ci}from"zod";import{z as De}from"zod";var Mr=De.object({depends:De.array(De.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:De.string().min(1).describe("Human-readable description of what this precondition ensures"),returns:De.array(De.string().min(1)).optional().describe("Keys that the execute response's data field will contain. e.g. ['projectId', 'workflowId']. These are used for route param interpolation ({{projectId}}) and workflow variables. Declared here so generated types are strongly typed per precondition.")}).describe("A named precondition declared at the graph level. States reference these by name.");import{z as p}from"zod";import{z as Se}from"zod";var Qc=Se.object({by:Se.literal("testId"),value:Se.string().min(1)}),Zc=Se.object({by:Se.literal("role"),name:Se.string().optional(),role:Se.string().min(1)}),T=Se.discriminatedUnion("by",[Qc,Zc]);import{z as si}from"zod";var ve=si.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),Et=si.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]);import{z as O}from"zod";var ed=O.object({type:O.literal("static"),value:O.union([O.string(),O.number(),O.boolean()])}),Tt=O.object({name:O.string().min(1),type:O.literal("variable")}),$t=O.discriminatedUnion("type",[ed,Tt]),Q=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.string()}),Tt]),At=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.number().int().nonnegative()}),Tt]),Hr=O.discriminatedUnion("type",[O.object({type:O.literal("static"),value:O.union([O.string(),O.number(),O.boolean()])}),Tt]);import{z as Z}from"zod";var It=Z.discriminatedUnion("type",[Z.object({default:Z.string().optional(),type:Z.literal("string")}),Z.object({default:Z.number().optional(),type:Z.literal("number")}),Z.object({default:Z.boolean().optional(),type:Z.literal("boolean")}),Z.object({key:Z.string().min(1),type:Z.literal("env")})]);var P={id:p.string().min(1).max(200),label:p.string().max(500).optional(),next:p.string().max(200).optional(),uiOnly:p.boolean().optional()},ai=500,td=p.object({...P,type:p.literal("goto"),url:Q}),rd=p.object({...P,locator:T,type:p.literal("click")}),nd=p.object({...P,locator:T,type:p.literal("fill"),value:Q}),od=p.object({...P,locator:T,type:p.literal("select"),value:Q}),id=p.object({...P,locator:T,type:p.literal("hover")}),sd=p.object({...P,key:p.string().min(1),locator:T.optional(),type:p.literal("press")}),ad=p.object({...P,locator:T,type:p.literal("check")}),ld=p.object({...P,locator:T,type:p.literal("uncheck")}),cd=p.object({...P,height:p.number().int().positive(),type:p.literal("setViewport"),width:p.number().int().positive()}),dd=p.object({...P,message:p.string().min(1),type:p.literal("fail")}),ud=p.object({...P,type:p.literal("setVariable"),value:$t,variable:p.string().min(1)}),pd=p.object({...P,locator:T,type:p.literal("extractText"),variable:p.string().min(1)}),md=p.object({...P,files:p.array(p.string()).min(1),locator:T,type:p.literal("upload")}),fd=p.object({...P,locator:T,type:p.literal("dblclick")}),gd=p.object({...P,source:T,target:T,type:p.literal("drag")}),yd=p.object({...P,locator:T,type:p.literal("scrollIntoView")}),hd=p.object({...P,locator:T,type:p.literal("type"),value:Q}),wd=p.object({...P,locator:T,type:p.literal("focus")}),bd=p.object({...P,locator:T,type:p.literal("clear")}),Sd=p.object({...P,locator:T,type:p.literal("rightClick")}),vd=p.object({...P,action:p.enum(["accept","dismiss"]),promptText:p.string().optional(),type:p.literal("handleDialog")}),kd=p.object({...P,action:p.enum(["read","write"]),type:p.literal("clipboard"),value:Q.optional(),variable:p.string().min(1).optional()}),Rd=p.object({...P,permission:p.string().min(1),state:p.enum(["granted","prompt"]),type:p.literal("setPermission")}),xd=p.object({...P,locator:T,type:p.literal("assertVisible")}),Pd=p.object({...P,locator:T,type:p.literal("assertNotVisible")}),Cd=p.object({...P,expected:Q,locator:T,operator:ve,type:p.literal("assertText")}),Ed=p.object({...P,expected:Q,operator:ve,type:p.literal("assertUrl")}),Td=p.object({...P,expected:At,locator:T,operator:Et,type:p.literal("assertCount")}),$d=p.object({...P,expected:Q,locator:T,operator:ve,type:p.literal("assertValue")}),Ad=p.object({...P,attribute:p.string().min(1),expected:Q,locator:T,operator:ve,type:p.literal("assertAttribute")}),Id=p.object({...P,locator:T,type:p.literal("assertEnabled")}),jd=p.object({...P,locator:T,type:p.literal("assertDisabled")}),Nd=p.object({...P,expected:Q,operator:ve,type:p.literal("assertTitle")}),Od=p.object({...P,locator:T,type:p.literal("assertChecked")}),Dd=p.object({...P,locator:T,type:p.literal("assertNotChecked")}),Ld=p.object({...P,locator:T,type:p.literal("assertFocused")}),_d=p.object({...P,locator:T,type:p.literal("assertNotFocused")}),Ud=p.object({...P,budget:p.enum(["fast","slow","async"]),observer:p.string().min(1).max(200),params:p.record(p.string().max(200),Hr),type:p.literal("assertObserver")}),li=p.discriminatedUnion("type",[td,rd,nd,od,id,sd,ad,ld,xd,Pd,Cd,Ed,Td,$d,Ad,Id,jd,cd,dd,ud,pd,md,fd,gd,yd,hd,wd,bd,Sd,vd,kd,Rd,Nd,Od,Dd,Ld,_d,Ud]),jt=p.object({entryNode:p.string().min(1).max(200),nodes:p.record(p.string().max(200),li).refine(e=>Object.keys(e).length<=ai,`Workflow has more than ${String(ai)} nodes`),uiOnly:p.boolean().optional(),variableNamespaces:p.record(p.string().max(200),p.string().max(500)).optional(),variables:p.record(p.string().max(200),It).optional()});var Vd=ci.record(ci.string().max(200),Mr),Fd={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},Md={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},Wr=Ct("workflow-spec").legacy(Fd).initial(jt).build(),Hd=Ct("precondition-map").legacy(Md).initial(Vd).build();import{z as qr}from"zod";var di=["fast","slow","async"],Wd=qr.object({budget:qr.enum(di).describe("Polling budget tier: fast | slow | async"),description:qr.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 Lt,readFragment as Ot}from"gql.tada";import{z as oe}from"zod";import ui from"crypto";import{Webhook as qd}from"standardwebhooks";function ke({body:e,secret:t}){let r=new qd(t),n=`msg_${ui.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 Br(){return`whsec_${ui.randomBytes(24).toString("base64")}`}var Bd=15e4,zd={async:{backoffMs:[500,1e3,2e3,5e3],timeoutMs:12e4},fast:{backoffMs:[100,250,500,1e3],timeoutMs:5e3},slow:{backoffMs:[250,500,1e3,2e3],timeoutMs:3e4}},Gd=oe.discriminatedUnion("kind",[oe.object({kind:oe.literal("pass")}),oe.object({kind:oe.literal("retry"),reason:oe.string()}),oe.object({kind:oe.literal("fail"),reason:oe.string()})]),Kd=oe.object({error:oe.string().optional(),outcome:Gd.optional(),success:oe.boolean()});async function pi({apiUrl:e,budget:t,observer:r,params:n,webhookSecret:o}){let i=zd[t],s=performance.now(),a={lastReason:void 0,pollCount:0};for(;performance.now()-s<i.timeoutMs;){a.pollCount+=1;let l=await Yd({apiUrl:e,observer:r,params:n,webhookSecret:o}),c=Jd({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(Xd({backoff:i.backoffMs,pollCount:a.pollCount}),d);await Qd(u)}return{description:`observer "${r}"`,detail:`budget "${t}" exhausted after ${String(a.pollCount)} poll(s) (${mi(s)}); last: ${a.lastReason??"no retry reason"}
|
|
112
|
+
\u2192 /ripplo:debug \u2014 check .ripplo/debug/<runId>/ artifacts`,status:"failed"}}function Jd({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 (${mi(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 Yd({apiUrl:e,observer:t,params:r,webhookSecret:n}){let o=JSON.stringify({observer:t,params:r});try{let i=await fetch(`${e}/execute-observer`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:n})},method:"PUT",signal:AbortSignal.timeout(Bd)});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=Kd.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 Xd({backoff:e,pollCount:t}){let r=Math.min(t-1,e.length-1);return e[r]??1e3}function mi(e){return`${String(Math.round(performance.now()-e))}ms`}async function Qd(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 Zd=1e4;async function zr({failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,spec:i,variables:s}){let a=performance.now();return tu({currentId:i.entryNode,failFast:e,getRecordingOffsetMs:t,observerTransport:r,onStep:n,page:o,runStartTime:a,spec:i,variables:s})}function eu({onStep:e,steps:t,target:r}){t.forEach(n=>{let o={...n,stepIndex:r.length};r.push(o),e?.(o)})}async function tu({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 ru({getRecordingOffsetMs:r,node:f,nodeId:b,observerTransport:n,page:i,runStartTime:s,variables:d});if(eu({onStep:o,steps:[h],target:c}),d=h.variables,t&&h.status==="failed")break;u=f.next}return{steps:c,variables:d}}async function ru({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=Zd,u=yt({node:t,page:o});try{let f=await nu({node:t,observerTransport:n,page:o,timeout:d,variables:s}),b=Math.round(performance.now()-a),w=f.assertions.some(E=>E.status==="failed"),h=await Y({label:`Snapshot [${c}]`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:f.assertions,detail:void 0,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:w?"failed":"passed",stepIndex:0,title:c,url:h.url,variables:f.variables,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}catch(f){let b=Math.round(performance.now()-a),w=f instanceof Error?f.message:String(f),h=await Y({label:`Snapshot [${c}] (error)`,fn:()=>we({page:o,runStartTime:i,targets:u})}),v=e?.();return{annotations:h.annotations,assertions:[],detail:w,duration:b,nodeId:r,nodeType:t.type,recordingEndMs:v,recordingStartMs:l,snapshotTimestamp:h.snapshotTimestamp,status:"failed",stepIndex:0,title:c,url:h.url,variables:s,viewportHeight:h.viewportHeight,viewportWidth:h.viewportWidth}}}async function nu({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(ou(e)){let s=await ur({node:e,page:r,timeout:n,variables:o});return{assertions:[],variables:s.variables}}return{assertions:await su({node:e,observerTransport:t,page:r,timeout:n,variables:o}),variables:o}}function ou(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 iu(e){return e.type.startsWith("assert")}async function su({node:e,observerTransport:t,page:r,timeout:n,variables:o}){if(!iu(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 lu({assertNode:i,page:r,timeout:n,variables:o});case"assertText":{let s=K({ref:i.expected,variables:o});return[await Tr({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertUrl":{let s=K({ref:i.expected,variables:o});return[kt({expected:s,operator:i.operator,url:r.url()})]}case"assertTitle":{let s=K({ref:i.expected,variables:o});return[kt({expected:s,operator:i.operator,url:await r.title()})]}case"assertCount":{let s=dr({ref:i.expected,variables:o});return[await $r({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator})]}case"assertValue":{let s=K({ref:i.expected,variables:o});return[await Ar({expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertAttribute":{let s=K({ref:i.expected,variables:o});return[await Go({attribute:i.attribute,expected:s,locator:U({locator:i.locator,page:r,variables:o}),operator:i.operator,timeout:n})]}case"assertObserver":{if(t==null)return[{description:`observer "${i.observer}"`,detail:"observer transport not configured \u2014 set engineUrl + webhookSecret in ripplo.config",status:"failed"}];let s={};return Object.entries(i.params).forEach(([a,l])=>{s[a]=Ce({ref:l,variables:o})}),[await pi({apiUrl:t.apiUrl,budget:i.budget,observer:i.observer,params:s,webhookSecret:t.webhookSecret})]}}}var au={assertChecked:Yo,assertDisabled:Jo,assertEnabled:Ko,assertFocused:Qo,assertNotChecked:Xo,assertNotFocused:Zo,assertNotVisible:jr,assertVisible:Ir};async function lu({assertNode:e,page:t,timeout:r,variables:n}){let o=au[e.type];return[await o({locator:U({locator:e.locator,page:t,variables:n}),timeout:r})]}async function Gr({baseUrl:e,browser:t,cookies:r,extraVariables:n,observerTransport:o,onRecordingChunk:i,onStep:s,runId:a,spec:l}){let c=await t.newContext({baseURL:e});g.info("Browser context created"),r.length>0&&await c.addCookies(r);let d=await c.newPage();g.info("Page created");let u=Ze(d),f=await vt(d);async function b(){let _=await f.takeChunk();_!=null&&i?.(_)}let w=setInterval(()=>{b()},2e3),h=[],v=!1;function E(_){s?.(_),v||(v=!0,f.start()),h.push(bt({context:c,page:d,runId:a,stepIndex:_.stepIndex,stepResult:_}))}let V=cu(n,l.variableNamespaces),B={...Qe({defs:l.variables}),...V};g.info("Starting graph execution (entry: %s)",l.entryNode);let L=await zr({failFast:!0,getRecordingOffsetMs:f.currentOffsetMs,observerTransport:o,onStep:E,page:d,spec:l,variables:B});await Promise.allSettled(h);let F=L.steps.filter(_=>_.status==="passed").length,ie=L.steps.filter(_=>_.status==="failed").length,Ae={duration:L.steps.reduce((_,ae)=>_+ae.duration,0),failCount:ie,passCount:F,runId:a,status:ie>0?"failed":"passed",workflowName:""};return await St({monitor:u,runId:a,steps:L.steps,summary:Ae}),clearInterval(w),await f.detach(),await b(),await c.close(),L.steps}function cu(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 du}from"set-cookie-parser";import{z as ee}from"zod";var fi=3e4,uu=ee.object({data:ee.record(ee.string(),ee.record(ee.string(),ee.string())),error:ee.string().optional(),executed:ee.array(ee.string()),runId:ee.string(),success:ee.boolean()});async function Kr({project:e,webhookSecret:t,workflowSlug:r}){let n={apiUrl:void 0,cookies:[],data:{},executed:[]},o=e.workflows.find(a=>a.slug===r);if(o==null)return n;let i=e.engineBaseUrl.length===0?void 0:e.engineBaseUrl,s=o.preconditions;return s.length===0?{...n,apiUrl:i}:i==null?n:gi({apiUrl:i,preconditionNames:s,webhookSecret:t})}async function Jr({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",...gu({cookies:t}),...ke({body:i,secret:o})},method:"PUT",signal:AbortSignal.timeout(fi)});s.ok||g.error("Teardown returned %s",String(s.status))}catch{g.error("Teardown request failed")}}async function gi({apiUrl:e,preconditionNames:t,webhookSecret:r}){let n=performance.now(),o=JSON.stringify({preconditions:t}),i=await fetch(`${e}/execute-preconditions`,{body:o,headers:{"Content-Type":"application/json",...ke({body:o,secret:r})},method:"PUT",signal:AbortSignal.timeout(fi)});if(!i.ok){let c=await mu(i);throw new Error(`execute-preconditions returned ${String(i.status)}: ${c}`)}let s=await i.json(),a=uu.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=yu({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 pu=ee.object({error:ee.string()});async function mu(e){let t=await e.text().catch(()=>"");if(t.length===0)return"no body";let r=fu(t),n=r==null?null:pu.safeParse(r);return n!=null&&n.success?n.data.error:t.slice(0,500)}function fu(e){try{return JSON.parse(e)}catch{return null}}function gu({cookies:e}){return e.length===0?{}:{Cookie:e.map(r=>`${r.name}=${r.value}`).join("; ")}}function yu({domain:e,res:t}){let r=t.headers.getSetCookie();return du(r,{decodeValues:!1}).map(o=>hu({cookie:o,domain:e}))}function hu({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=bu({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 wu={lax:"Lax",none:"None",strict:"Strict"};function bu({raw:e}){return wu[e.toLowerCase()]??"Lax"}async function Yr({engineBaseUrl:e,preconditionNames:t,webhookSecret:r}){let n=e.length===0?void 0:e;return n==null||t.length===0?{apiUrl:n,cookies:[],data:{},executed:[]}:gi({apiUrl:n,preconditionNames:t,webhookSecret:r})}import{graphql as Nt}from"gql.tada";async function Xr({agentProfileId:e,config:t,runId:r}){let n=await S({config:t,document:ku,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=vu({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(E=>E.status==="passed").length,w=u.filter(E=>E.status==="failed").length,h=u.reduce((E,V)=>E+V.duration,0),v=d??(w>0?"failed":"passed");await Y({label:"completeRun",fn:()=>S({config:t,document:Pu,variables:{duration:h,failCount:w,passCount:b,runResultId:o,status:v,summary:f??null,warnCount:0}})})}return{complete:c,enqueueRecordingChunk:a,enqueueStep:s,flushSteps:l,runResultId:o}}async function Su({chunk:e,config:t,runResultId:r}){await S({config:t,document:xu,variables:{input:{bodyBase64:e.body.toString("base64"),chunkIndex:e.chunkIndex,endTimestamp:e.endTimestamp,eventCount:e.eventCount,runResultId:r,startTimestamp:e.startTimestamp}}})}async function vu({config:e,runResultId:t,steps:r}){let n=r.map(o=>({annotations:o.annotations.map(i=>({height:i.height,label:i.label,rrwebNodeId:i.rrwebNodeId??null,type:i.type,width:i.width,x:i.x,y:i.y})),assertions:o.assertions.map(i=>({description:i.description,detail:i.detail,status:i.status})),detail:o.detail,duration:o.duration,nodeType:o.nodeType,recordingEndMs:o.recordingEndMs??null,recordingStartMs:o.recordingStartMs??null,snapshotTimestamp:o.snapshotTimestamp,status:o.status,stepIndex:o.stepIndex,title:o.title,url:o.url,viewportHeight:o.viewportHeight,viewportWidth:o.viewportWidth}));await S({config:e,document:Ru,variables:{runResultId:t,steps:n}})}var ku=Nt(`
|
|
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
|
+
`),Ru=Nt(`
|
|
121
121
|
mutation SubmitRunStepsCLI($runResultId: String!, $steps: [StepInput!]!) {
|
|
122
122
|
submitRunSteps(runResultId: $runResultId, steps: $steps)
|
|
123
123
|
}
|
|
124
|
-
`),
|
|
124
|
+
`),xu=Nt(`
|
|
125
125
|
mutation SubmitRunRecordingChunkCLI($input: SubmitRunRecordingChunkInput!) {
|
|
126
126
|
submitRunRecordingChunk(input: $input)
|
|
127
127
|
}
|
|
128
|
-
`),
|
|
128
|
+
`),Pu=Nt(`
|
|
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 Cu=12e4,Dt=Lt(`
|
|
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
|
+
`),yi=Lt(`
|
|
164
164
|
fragment ProjectRun on Project {
|
|
165
165
|
id
|
|
166
166
|
cloudBaseUrl
|
|
@@ -169,13 +169,13 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
169
169
|
...WorkflowRun
|
|
170
170
|
}
|
|
171
171
|
}
|
|
172
|
-
`,[
|
|
172
|
+
`,[Dt]),Eu=Lt(`
|
|
173
173
|
query ProjectRun($projectId: String!) {
|
|
174
174
|
project(id: $projectId) {
|
|
175
175
|
...ProjectRun
|
|
176
176
|
}
|
|
177
177
|
}
|
|
178
|
-
`,[
|
|
178
|
+
`,[yi]),Tu=Lt(`
|
|
179
179
|
query AgentProfileRun($id: String!) {
|
|
180
180
|
agentProfile(id: $id) {
|
|
181
181
|
id
|
|
@@ -185,30 +185,30 @@ Load \`/ripplo:create\` skill for instructions.`,status:"failed"}:(n.lastReason=
|
|
|
185
185
|
successCriteria
|
|
186
186
|
}
|
|
187
187
|
}
|
|
188
|
-
`);async function
|
|
188
|
+
`);async function Qr({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=$u({externalBrowser:n,headed:i});let w=s==null?void 0:Y({label:"Preconditions resolved",fn:()=>Yr({engineBaseUrl:o.engineUrl,preconditionNames:s,webhookSecret:l})}),[{project:h,workflow:v},E]=await Promise.all([Y({label:"Run context resolved",fn:()=>Lu({config:o,workflowId:c})}),Y({label:"Streaming run started",fn:()=>Xr({agentProfileId:t,config:o,runId:a})}),Or({appUrl:r})]);d=v.name,u=E;let V=Uu(v.spec);g.info("Executing workflow: %s",v.name),await Mu(Iu({agentProfileDescription:e,agentProfileId:t,baseUrl:r,browserPromise:f,config:o,headed:i,ownsBrowser:b,preconditionPromise:w,project:h,runId:a,specData:V,streaming:u,webhookSecret:l,workflow:v}),Fu())}catch(w){throw await Au({browserPromise:f,error:w,ownsBrowser:b,runId:a,streaming:u,workflowName:d}),w}}function $u({externalBrowser:e,headed:t}){return e!=null?Promise.resolve(e):Y({label:"Browser launched",fn:()=>Ee({headed:t})})}async function Au({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 Bo({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 Iu({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:()=>Kr({project:Ou(l),webhookSecret:f,workflowSlug:b.slug})}),[h,v]=await Promise.all([w,n]);if(t!=null){s&&await v.close(),await ju({agentProfileDescription:e,agentProfileId:t,baseUrl:r,config:o,headed:i,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f,workflow:b});return}await Du({baseUrl:r,browser:v,preconditionResult:h,runId:c,specData:d,streaming:u,webhookSecret:f})}async function ju({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 _u({config:n,profileId:t});await Er({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 hi({preconditionResult:i,webhookSecret:c})}var Nu=me.object({preconditions:me.array(me.string()),requiresKeys:me.array(me.object({namespace:me.string(),preconditionName:me.string()})),slug:me.string()});function Ou(e){let t=(e.workflows??[]).map(r=>{let n=Ot(Dt,r);return Nu.parse(n)});return{engineBaseUrl:e.engineBaseUrl,workflows:t}}async function Du({baseUrl:e,browser:t,preconditionResult:r,runId:n,specData:o,streaming:i,webhookSecret:s}){let a=await Y({label:"Spec executed",fn:()=>Gr({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 hi({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 hi({preconditionResult:e,webhookSecret:t}){e.apiUrl!=null&&await Jr({apiUrl:e.apiUrl,cookies:e.cookies,data:e.data,executed:e.executed,webhookSecret:t})}async function Lu({config:e,workflowId:t}){let r=await S({config:e,document:Eu,variables:{projectId:e.projectId}});if(r.project==null)throw new Error("Project not found");let o={...Ot(yi,r.project),...e.engineUrl.length>0?{engineBaseUrl:e.engineUrl}:{}},s=(o.workflows??[]).find(l=>Ot(Dt,l).id===t);if(s==null)throw new Error(`Workflow ${t} not found`);let a=Ot(Dt,s);return{project:o,workflow:a}}async function _u({config:e,profileId:t}){let r=await S({config:e,document:Tu,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),xr({description:o,output:n.output??void 0,successCriteria:n.successCriteria??void 0})}function Uu(e){if(e==null)throw new Error("Workflow has no spec");return Wr.decode(e)}var Vu=me.coerce.number().int().positive().catch(Cu);function Fu(){return Vu.parse(process.env.RIPPLO_RUN_TIMEOUT_MS)}async function Mu(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 zu}from"child_process";import{createAuthClient as Hu}from"better-auth/client";import{deviceAuthorizationClient as Wu}from"better-auth/client/plugins";function wi({baseURL:e}){return Hu({baseURL:e,fetchOptions:{headers:{"User-Agent":"Ripplo CLI"}},plugins:[Wu()]})}import{z as bi}from"zod";var qu="https://ripplo.ai";function fe(){return Zr().RIPPLO_SERVER_URL}var Bu=bi.object({RIPPLO_SERVER_URL:bi.string().min(1).default(qu)}),Si;function Zr(){return Si??=Bu.parse(process.env),Si}var Gu=5e3,vi="ripplo-cli";async function ki({onDeviceCode:e,url:t}){let r=t??Zr().RIPPLO_SERVER_URL,n=wi({baseURL:r}),o=await n.device.code({client_id:vi});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}),Zu(a);let l=await Ku({authClient:n,deviceCode:i});return Ur(l),l}async function Ku({authClient:e,deviceCode:t}){for(;;){await Xu(Gu);let r=await e.device.token({client_id:vi,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(!Yu(r.error.error))throw new Error(`Authorization failed: ${r.error.error_description}`)}}var Ju=new Set(["authorization_pending","slow_down"]);function Yu(e){return Ju.has(e)}function Xu(e){return new Promise(t=>{setTimeout(t,e)})}function Qu(){return process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open"}function Zu(e){let t=Qu();zu(`${t} "${e}"`,()=>{})}function Le({serverUrl:e,token:t}){return{appUrl:"",cwd:process.cwd(),engineUrl:"",projectId:"",ripploServerUrl:e,token:t,webhookSecret:""}}import ep from"fs";import tp from"path";function I(e){return ep.existsSync(tp.join(e,".ripplo"))}var np=rp(`
|
|
189
189
|
query AuthViewer {
|
|
190
190
|
currentUser {
|
|
191
191
|
name
|
|
192
192
|
email
|
|
193
193
|
}
|
|
194
194
|
}
|
|
195
|
-
`);async function
|
|
195
|
+
`);async function Ri(){let e=fe(),t=ne();if(t!=null){let s=await en({serverUrl:e,token:t});if(s!=null){process.stdout.write(`Already signed in as ${s.email}. Run \`ripplo auth logout\` to switch.
|
|
196
196
|
`);return}process.stdout.write(`Your saved session expired \u2014 let's sign you back in.
|
|
197
197
|
|
|
198
|
-
`)}let r=await
|
|
198
|
+
`)}let r=await ki({url:e,onDeviceCode:s=>{process.stdout.write(`Opening your browser to finish sign-in.
|
|
199
199
|
`),process.stdout.write(`If it didn't open, visit: ${s.verificationUrl}
|
|
200
200
|
`),process.stdout.write(`Verification code: ${s.userCode}
|
|
201
201
|
|
|
202
202
|
`),process.stdout.write(`Waiting for you to approve...
|
|
203
|
-
`)}}),n=await
|
|
203
|
+
`)}}),n=await en({serverUrl:e,token:r}),o=I(process.cwd()),i=o?"Welcome back":"Welcome to Ripplo";process.stdout.write(`
|
|
204
204
|
`),process.stdout.write(n==null?`${i}.
|
|
205
|
-
`:`${i}, ${
|
|
205
|
+
`:`${i}, ${op(n)}.
|
|
206
206
|
`),process.stdout.write(`Session saved to ${be("token")}.
|
|
207
|
-
`),o||(process.stdout.write("\nNext: run `/ripplo:setup` in Claude Code to wire Ripplo into this project,\n"),process.stdout.write("or `npx ripplo init` to set it up by hand.\n"))}function
|
|
208
|
-
`)}function
|
|
207
|
+
`),o||(process.stdout.write("\nNext: run `/ripplo:setup` in Claude Code to wire Ripplo into this project,\n"),process.stdout.write("or `npx ripplo init` to set it up by hand.\n"))}function op(e){let t=e.name.trim().split(/\s+/)[0];return t!=null&&t.length>0?t:e.email}async function en({serverUrl:e,token:t}){try{let n=(await S({config:Le({serverUrl:e,token:t}),document:np,variables:void 0})).currentUser;return n==null?null:{email:n.email,name:n.name}}catch{return null}}async function xi(){let e=ne();e==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login`.\n"),process.exit(1));let t=fe(),r=await en({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 Pi(){if(!Vr()){process.stdout.write(`No token to remove.
|
|
209
209
|
`);return}process.stdout.write(`Removed ${be("token")}
|
|
210
|
-
`)}import
|
|
211
|
-
`}async function Lt({cwd:e}){let t=en.join(e,ce),r=await dm(t);return r==null?null:ip(ji,r)}async function de({cwd:e,result:t}){let r=Ni(t),n=en.join(e,ce);await Zr.mkdir(en.dirname(n),{recursive:!0}),await Zr.writeFile(n,rn(r),"utf8")}function _t({compiled:e,existing:t}){if(t==null)return"missing";let r=rn(Ni(e)),n=rn(t);return r===n?"match":"stale"}async function dm(e){try{return await Zr.readFile(e,"utf8")}catch(t){if(um(t)&&t.code==="ENOENT")return null;throw t}}function um(e){return e instanceof Error&&"code"in e}function pm(e){return function(r,n){return n===e||!mm(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function mm(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import Ft from"fs";import cn from"path";var sn=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],xe=["**/*.gen.*","**/generated/**","**/*.d.ts","**/*.test.*","**/*.spec.*","**/node_modules/**","**/dist/**","**/build/**",".ripplo/**","**/*.md","**/.next/**","**/.turbo/**","**/.vercel/**","**/.svelte-kit/**","**/.nuxt/**","**/.astro/**","**/coverage/**","**/storybook-static/**","**/*.stories.*","**/*.story.*","**/cli/**","**/scripts/**","**/tools/**","**/__tests__/**","**/__mocks__/**","**/__fixtures__/**","**/*.config.*","**/*.setup.*","**/public/**","**/static/**","**/assets/**","**/migrations/**","**/prisma/migrations/**","**/scripts/**"];function Oi(e){return e.data}function Di(e){return{as(t){return{data:{label:t,node:e}}}}}function Ut(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();fm(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=>gm(a,t));return{observers:i,preconditions:o,tests:s}}function fm(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 gm(e,t){let r=e.id,{accessedKeys:n,vars:o}=hm(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[ym(i),...s],l=wm(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=Sm(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 ym(e){return Di({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function hm(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 wm(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]=bm(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 bm(e,t,r){let{label:n,node:o}=Oi(e);return{...o,id:t,label:n,next:r}}function Sm(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 uP,WebhookVerificationError as pP}from"standardwebhooks";import{z as I}from"zod";var fP=I.object({preconditions:I.array(I.string().min(1))}),gP=I.object({data:I.record(I.string(),I.record(I.string(),I.string())),preconditions:I.array(I.string().min(1))}),yP=I.object({observer:I.string().min(1).max(200),params:I.record(I.string().max(200),I.string())}),vm=I.discriminatedUnion("kind",[I.object({kind:I.literal("pass")}),I.object({kind:I.literal("retry"),reason:I.string()}),I.object({kind:I.literal("fail"),reason:I.string()})]),hP=I.object({error:I.string().optional(),outcome:vm.optional(),success:I.boolean()});function _e(e){let t=[];return e.tests.forEach(r=>{let n=km(r),o=i=>{t.push({...i,test:r.slug})};qm.forEach(i=>{i(n,r,o)})}),{diagnostics:t}}function km(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 Rm(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 xm(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&_i(o.value)){let i=o.value.value;!Ui(i)&&Im(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 Cm(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 Em(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 Tm(e,t,r){let n=0;e.forEach(o=>{Ue(o)?n=0:(n++,n===3&&r({message:"3+ consecutive actions without an assertion \u2014 add verification between actions",rule:"assert-after-action",step:o.label??o.id}))})}function $m(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!Ue(n)&&r({message:"Last step is an action, not an assertion \u2014 expectedOutcome should be verified by assertions at the end",rule:"assert-matches-outcome",step:n.label??n.id})}function Am(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function _i(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Ui(e){return e.includes("{{")}function Im(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function Ue(e){return e.type.startsWith("assert")}var jm=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function Nm(e){return jm.has(e.type)}function Om(e,t,r){!t.implemented||e.length===0||e.some(n=>Ue(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function Dm(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>Ue(i)).length;if(n===0)return;let o=n/e.length;if(o<.15){let i=Math.round(o*100);r({message:`Only ${String(n)}/${String(e.length)} steps are assertions (${String(i)}%) \u2014 add more verification between actions`,rule:"low-assertion-ratio",step:void 0})}}function an(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 Lm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=an(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&an(c)===i)==null||s.some(c=>Nm(c)||Ue(c)&&an(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 _m=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 ln(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!_m.has(t))}function Um(e){let t=e.label==null?[]:ln(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,...ln(n)]}function Vm(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(ln(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>Ue(s));if(o.length===0)return;o.some(s=>Um(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 Fm=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function Li(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 Fm.test(r)}function Mm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!Li(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>Li(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 Hm(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])=>_i(a)&&Ui(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 Wm(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 qm=[Rm,xm,Wm,Pm,Cm,Em,Tm,$m,Am,Om,Dm,Lm,Vm,Mm,Hm];import yf from"picomatch";import{execFileSync as Bm,spawnSync as zm}from"child_process";function oe(e,t){return Bm("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function Vi(e,t){let r=zm("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 Fi from"remeda";var Mi=[["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"]],Gm=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Km=[[/(?:^|[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 Vt({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>Jm({filePath:e,sf:r,stmt:n}))}function Jm({filePath:e,sf:t,stmt:r}){let n=Xm(r);if(n==null||Ym(n))return[];let o=Hi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Fi.uniqueBy(o,i=>i.id)}function Ym(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function Xm(e){if(R.isExportAssignment(e))return Qm(e.expression);if(!Zm(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 Qm(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function Zm(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function Hi(e,t){let r=ef(e,t),n=e.getChildren(t).flatMap(o=>Hi(o,t));return r==null?n:[r,...n]}function ef(e,t){let r=tf(e);if(r==null)return null;let n=rf(r);if(n==null)return null;let o=lf(r,n);return o==null?null:{kind:n,label:o,line:gf(t,e.getStart(t))}}function tf(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 rf({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Gm.get(r)??null:of(t,e)??sf(t)??af(e)}var nf=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 of(e,t){return nf.get(e)?.(t)??null}function sf(e){return/^[A-Z]/.test(e)?Km.find(([t])=>t.test(e))?.[1]??null:null}function af(e){return Mi.find(([t])=>uf(e,t))?.[1]??null}function lf({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")??(cf(r)?void 0:ff(t))??df(e,n)}function cf(e){return e==="input"||e==="textarea"||e==="select"}function df(e,t){let r=Mi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=pf(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return Wi(n.body)}}function Wi(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,Wi)}function uf(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function qi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=qi(e,t);return r==null?void 0:mf(r.initializer)}function pf(e,t){let r=qi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function mf(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return zi(e.expression)}function ff(e){let t=e.flatMap(r=>Bi(r)).join(" ").trim();return t.length===0?void 0:t}function Bi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=zi(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>Bi(t)):[]}function zi(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 gf(e,t){return e.getLineAndCharacterOfPosition(t).line+1}var hf=cn.join(".ripplo","coverage.d.ts");function Ve({cwd:e}){wf({cwd:e,ignorePaths:xe})}function wf({cwd:e,ignorePaths:t}){let r=Fe({cwd:e,ignorePaths:t});vf({content:Sf(r),cwd:e})}function Fe({cwd:e,ignorePaths:t}){let n=bf({cwd:e,ignorePaths:t}).flatMap(o=>dn({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function bf({cwd:e,ignorePaths:t}){let r=oe(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=yf([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o))}function dn({cwd:e,file:t}){let r=Ft.readFileSync(cn.join(e,t),"utf8");return Vt({filePath:t,source:r}).map(n=>n.id)}function Sf(e){let t=`// GENERATED \u2014 do not edit
|
|
210
|
+
`)}import rn from"fs/promises";import nn from"path";import{z as _t}from"zod";import{z as Ci}from"zod";import{z as _e}from"zod";import{z as m}from"zod";import{z as Re}from"zod";import{z as Ii}from"zod";import{z as D}from"zod";import{z as te}from"zod";import{z as tn}from"zod";import{z}from"zod";var ip=_t.object({__codec:_t.string().min(1),data:_t.unknown(),version:_t.number().int().positive()}),sp=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}},ap=class extends Error{constructor(e){super(`Codec mismatch: expected "${e.expected}", got "${e.got}"`),this.name="CodecMismatchError"}};function an(e){return Ti({legacy:void 0,migrators:[],name:e,schemas:[]})}function lp(e,t){let r=JSON.parse(t);return e.decode(r)}function Ti(e){return{initial:t=>on(t,{...e,schemas:[t]}),legacy:t=>Ti({...e,legacy:t})}}function on(e,t){return{build:()=>cp(e,t),legacy:r=>on(e,{...t,legacy:r}),upgrade:(r,n)=>{let o=n;return on(r,{...t,migrators:[...t.migrators,o],schemas:[...t.schemas,r]})}}}function cp(e,t){let r=t.schemas.length;return{currentVersion:r,name:t.name,decode:n=>dp(e,t,n),encode:n=>({__codec:t.name,data:n,version:r})}}function dp(e,t,r){let{data:n,version:o}=up(t,r),i=$i(t,n,o);return e.parse(i)}function up(e,t){let r=ip.safeParse(t);if(r.success){if(r.data.__codec!==e.name)throw new ap({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 $i(e,t,r){let n=e.schemas.length;if(r>n)throw new sp({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 $i(e,s(i),r+1)}var Ai=_e.object({depends:_e.array(_e.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:_e.string().min(1).describe("Human-readable description of what this precondition ensures"),returns:_e.array(_e.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."),pp=Re.object({by:Re.literal("testId"),value:Re.string().min(1)}),mp=Re.object({by:Re.literal("role"),name:Re.string().optional(),role:Re.string().min(1)}),A=Re.discriminatedUnion("by",[pp,mp]),it=Ii.enum(["equals","notEquals","contains","startsWith","endsWith","matches"]),fp=Ii.enum(["equals","notEquals","greaterThan","greaterThanOrEqual","lessThan","lessThanOrEqual"]),gp=D.object({type:D.literal("static"),value:D.union([D.string(),D.number(),D.boolean()])}),Ut=D.object({name:D.string().min(1),type:D.literal("variable")}),yp=D.discriminatedUnion("type",[gp,Ut]),le=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.string()}),Ut]),hp=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.number().int().nonnegative()}),Ut]),wp=D.discriminatedUnion("type",[D.object({type:D.literal("static"),value:D.union([D.string(),D.number(),D.boolean()])}),Ut]),bp=te.discriminatedUnion("type",[te.object({default:te.string().optional(),type:te.literal("string")}),te.object({default:te.number().optional(),type:te.literal("number")}),te.object({default:te.boolean().optional(),type:te.literal("boolean")}),te.object({key:te.string().min(1),type:te.literal("env")})]),C={id:m.string().min(1).max(200),label:m.string().max(500).optional(),next:m.string().max(200).optional(),uiOnly:m.boolean().optional()},Ei=500,Sp=m.object({...C,type:m.literal("goto"),url:le}),vp=m.object({...C,locator:A,type:m.literal("click")}),kp=m.object({...C,locator:A,type:m.literal("fill"),value:le}),Rp=m.object({...C,locator:A,type:m.literal("select"),value:le}),xp=m.object({...C,locator:A,type:m.literal("hover")}),Pp=m.object({...C,key:m.string().min(1),locator:A.optional(),type:m.literal("press")}),Cp=m.object({...C,locator:A,type:m.literal("check")}),Ep=m.object({...C,locator:A,type:m.literal("uncheck")}),Tp=m.object({...C,height:m.number().int().positive(),type:m.literal("setViewport"),width:m.number().int().positive()}),$p=m.object({...C,message:m.string().min(1),type:m.literal("fail")}),Ap=m.object({...C,type:m.literal("setVariable"),value:yp,variable:m.string().min(1)}),Ip=m.object({...C,locator:A,type:m.literal("extractText"),variable:m.string().min(1)}),jp=m.object({...C,files:m.array(m.string()).min(1),locator:A,type:m.literal("upload")}),Np=m.object({...C,locator:A,type:m.literal("dblclick")}),Op=m.object({...C,source:A,target:A,type:m.literal("drag")}),Dp=m.object({...C,locator:A,type:m.literal("scrollIntoView")}),Lp=m.object({...C,locator:A,type:m.literal("type"),value:le}),_p=m.object({...C,locator:A,type:m.literal("focus")}),Up=m.object({...C,locator:A,type:m.literal("clear")}),Vp=m.object({...C,locator:A,type:m.literal("rightClick")}),Fp=m.object({...C,action:m.enum(["accept","dismiss"]),promptText:m.string().optional(),type:m.literal("handleDialog")}),Mp=m.object({...C,action:m.enum(["read","write"]),type:m.literal("clipboard"),value:le.optional(),variable:m.string().min(1).optional()}),Hp=m.object({...C,permission:m.string().min(1),state:m.enum(["granted","prompt"]),type:m.literal("setPermission")}),Wp=m.object({...C,locator:A,type:m.literal("assertVisible")}),qp=m.object({...C,locator:A,type:m.literal("assertNotVisible")}),Bp=m.object({...C,expected:le,locator:A,operator:it,type:m.literal("assertText")}),zp=m.object({...C,expected:le,operator:it,type:m.literal("assertUrl")}),Gp=m.object({...C,expected:hp,locator:A,operator:fp,type:m.literal("assertCount")}),Kp=m.object({...C,expected:le,locator:A,operator:it,type:m.literal("assertValue")}),Jp=m.object({...C,attribute:m.string().min(1),expected:le,locator:A,operator:it,type:m.literal("assertAttribute")}),Yp=m.object({...C,locator:A,type:m.literal("assertEnabled")}),Xp=m.object({...C,locator:A,type:m.literal("assertDisabled")}),Qp=m.object({...C,expected:le,operator:it,type:m.literal("assertTitle")}),Zp=m.object({...C,locator:A,type:m.literal("assertChecked")}),em=m.object({...C,locator:A,type:m.literal("assertNotChecked")}),tm=m.object({...C,locator:A,type:m.literal("assertFocused")}),rm=m.object({...C,locator:A,type:m.literal("assertNotFocused")}),nm=m.object({...C,budget:m.enum(["fast","slow","async"]),observer:m.string().min(1).max(200),params:m.record(m.string().max(200),wp),type:m.literal("assertObserver")}),om=m.discriminatedUnion("type",[Sp,vp,kp,Rp,xp,Pp,Cp,Ep,Wp,qp,Bp,zp,Gp,Kp,Jp,Yp,Xp,Tp,$p,Ap,Ip,jp,Np,Op,Dp,Lp,_p,Up,Vp,Fp,Mp,Hp,Qp,Zp,em,tm,rm,nm]),ji=m.object({entryNode:m.string().min(1).max(200),nodes:m.record(m.string().max(200),om).refine(e=>Object.keys(e).length<=Ei,`Workflow has more than ${String(Ei)} nodes`),uiOnly:m.boolean().optional(),variableNamespaces:m.record(m.string().max(200),m.string().max(500)).optional(),variables:m.record(m.string().max(200),bp).optional()}),im=Ci.record(Ci.string().max(200),Ai),sm={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&"entryNode"in e&&"nodes"in e},am={assumedVersion:1,detect:e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&!("__codec"in e)},dP=an("workflow-spec").legacy(sm).initial(ji).build(),uP=an("precondition-map").legacy(am).initial(im).build(),lm=["fast","slow","async"],cm=tn.object({budget:tn.enum(lm).describe("Polling budget tier: fast | slow | async"),description:tn.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",dm=5e3,um=z.record(z.string().max(200),z.string().max(200)),pm=z.object({coverage:z.array(z.string().max(500)).max(2e3).default([]),expectedOutcome:z.string().max(2e3),name:z.string().max(200),preconditions:z.array(z.string().max(200)).max(1e3),requiresKeys:um,slug:z.string().max(200),spec:ji}),mm=z.object({observers:z.record(z.string().max(200),cm),preconditions:z.record(z.string().max(200),Ai),tests:z.array(pm).max(dm)}),Ni=an("ripplo-lockfile").initial(mm).build();function Oi(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 sn(e){let t=Ni.encode(e);return`${JSON.stringify(t,ym(t),2)}
|
|
211
|
+
`}async function Vt({cwd:e}){let t=nn.join(e,ce),r=await fm(t);return r==null?null:lp(Ni,r)}async function de({cwd:e,result:t}){let r=Oi(t),n=nn.join(e,ce);await rn.mkdir(nn.dirname(n),{recursive:!0}),await rn.writeFile(n,sn(r),"utf8")}function Ft({compiled:e,existing:t}){if(t==null)return"missing";let r=sn(Oi(e)),n=sn(t);return r===n?"match":"stale"}async function fm(e){try{return await rn.readFile(e,"utf8")}catch(t){if(gm(t)&&t.code==="ENOENT")return null;throw t}}function gm(e){return e instanceof Error&&"code"in e}function ym(e){return function(r,n){return n===e||!hm(n)?n:Object.fromEntries(Object.entries(n).toSorted(([o],[i])=>o.localeCompare(i)))}}function hm(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}import st from"fs";import Wt from"path";var ln=["**/src/**","**/app/**","**/apps/**","**/pages/**","**/routes/**","**/components/**","**/server/**","**/api/**","**/backend/**","**/features/**","**/modules/**","**/views/**","**/ui/**","**/hooks/**","**/contexts/**","**/providers/**","**/controllers/**","**/handlers/**","**/resolvers/**","**/services/**","**/middleware/**","**/lib/**"],xe=["**/*.gen.*","**/generated/**","**/*.d.ts","**/*.test.*","**/*.spec.*","**/node_modules/**","**/dist/**","**/build/**",".ripplo/**","**/*.md","**/.next/**","**/.turbo/**","**/.vercel/**","**/.svelte-kit/**","**/.nuxt/**","**/.astro/**","**/coverage/**","**/storybook-static/**","**/*.stories.*","**/*.story.*","**/cli/**","**/scripts/**","**/tools/**","**/__tests__/**","**/__mocks__/**","**/__fixtures__/**","**/*.config.*","**/*.setup.*","**/public/**","**/static/**","**/assets/**","**/migrations/**","**/prisma/migrations/**","**/scripts/**"];function Di(e){return e.data}function Li(e){return{as(t){return{data:{label:t,node:e}}}}}function Mt(e){let t=e.getPreconditions(),r=e.getObservers(),n=e.getTests();wm(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=>bm(a,t));return{observers:i,preconditions:o,tests:s}}function wm(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 bm(e,t){let r=e.id,{accessedKeys:n,vars:o}=vm(e.requiresKeys),i=e.startsAtFn==null?void 0:e.startsAtFn(o),s=e.stepsFn==null?[]:e.stepsFn(o),a=i==null?s:[Sm(i),...s],l=km(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=xm(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 Sm(e){return Li({type:"goto",url:{type:"static",value:e}}).as(`navigate to ${e}`)}function vm(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 km(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]=Rm(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 Rm(e,t,r){let{label:n,node:o}=Di(e);return{...o,id:t,label:n,next:r}}function xm(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 kP,WebhookVerificationError as RP}from"standardwebhooks";import{z as $}from"zod";var PP=$.object({preconditions:$.array($.string().min(1))}),CP=$.object({data:$.record($.string(),$.record($.string(),$.string())),preconditions:$.array($.string().min(1))}),EP=$.object({observer:$.string().min(1).max(200),params:$.record($.string().max(200),$.union([$.string(),$.number(),$.boolean()]))}),Pm=$.discriminatedUnion("kind",[$.object({kind:$.literal("pass")}),$.object({kind:$.literal("retry"),reason:$.string()}),$.object({kind:$.literal("fail"),reason:$.string()})]),TP=$.object({error:$.string().optional(),outcome:Pm.optional(),success:$.boolean()});function Ue(e){let t=[];return e.tests.forEach(r=>{let n=Cm(r),o=i=>{t.push({...i,test:r.slug})};Km.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 Em(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 Tm(e,t,r){Object.keys(t.spec.variables??{}).length>0&&e.forEach(o=>{if(o.type==="fill"&&Ui(o.value)){let i=o.value.value;!Vi(i)&&Dm(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 $m(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 Am(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 Im(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 jm(e,t,r){let n=0;e.forEach(o=>{Ve(o)?n=0:(n++,n===3&&r({message:"3+ consecutive actions without an assertion \u2014 add verification between actions",rule:"assert-after-action",step:o.label??o.id}))})}function Nm(e,t,r){if(e.length===0)return;let n=e.at(-1);n!=null&&!Ve(n)&&r({message:"Last step is an action, not an assertion \u2014 expectedOutcome should be verified by assertions at the end",rule:"assert-matches-outcome",step:n.label??n.id})}function Om(e,t,r){t.implemented&&e.length===0&&r({message:"Test has zero steps",rule:"no-empty-steps",step:void 0})}function Ui(e){return!(typeof e!="object"||e==null||!("type"in e)||e.type!=="static"||!("value"in e)||typeof e.value!="string")}function Vi(e){return e.includes("{{")}function Dm(e){return e.includes("@")||/\b[a-f0-9]{8,}\b/.test(e)||/^(test|ripplo|example|sample|demo)/i.test(e)}function Ve(e){return e.type.startsWith("assert")}var Lm=new Set(["assertText","assertValue","assertCount","assertUrl","assertNotVisible","assertChecked","assertNotChecked","assertAttribute","assertDisabled","assertEnabled"]);function _m(e){return Lm.has(e.type)}function Um(e,t,r){!t.implemented||e.length===0||e.some(n=>Ve(n))||r({message:"Test has zero assertion steps \u2014 cannot verify expectedOutcome. Add assert.* steps.",rule:"no-assertions",step:void 0})}function Vm(e,t,r){if(!t.implemented||e.length<=3)return;let n=e.filter(i=>Ve(i)).length;if(n===0)return;let o=n/e.length;if(o<.15){let i=Math.round(o*100);r({message:`Only ${String(n)}/${String(e.length)} steps are assertions (${String(i)}%) \u2014 add more verification between actions`,rule:"low-assertion-ratio",step:void 0})}}function cn(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 Fm(e,t,r){e.forEach((n,o)=>{if(n.type!=="click")return;let i=cn(n);if(i==null)return;let s=e.slice(o+1,o+4);s.find(c=>c.type==="assertVisible"&&cn(c)===i)==null||s.some(c=>_m(c)||Ve(c)&&cn(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 Mm=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 dn(e){return e.toLowerCase().split(/[^a-z0-9]+/).filter(t=>t.length>=3&&!Mm.has(t))}function Hm(e){let t=e.label==null?[]:dn(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,...dn(n)]}function Wm(e,t,r){if(!t.implemented||e.length===0)return;let n=new Set(dn(t.expectedOutcome));if(n.size===0)return;let o=e.filter(s=>Ve(s));if(o.length===0)return;o.some(s=>Hm(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 qm=/save|submit|create|delete|remove|send|invite|update|confirm|publish|apply|pay|subscribe|upgrade|cancel|archive|rename/i;function _i(e){if(e.type==="upload"||e.type==="handleDialog"&&e.action==="accept")return!0;if(e.type!=="click")return!1;let t=e.locator,r=t.by==="role"?t.name??"":t.value;return qm.test(r)}function Bm(e,t,r){!t.implemented||t.spec.uiOnly===!0||e.forEach((n,o)=>{if(!_i(n)||"uiOnly"in n&&n.uiOnly===!0)return;let i=e.slice(o+1),s=i.findIndex(d=>_i(d)),a=s===-1?i.length:s;i.slice(0,a).some(d=>d.type==="assertObserver")||r({message:`"${n.label??n.id}" looks like it mutates backend state but no assert.backend(...) observer verifies it \u2014 the test can pass while the server is broken. You need to add an observer that checks the persisted result (see .ripplo/observers/ for examples). Only if this action truly does NOT change any server state (pure client-side interaction, presentation toggle, etc.) should you fall back to marking the step { uiOnly: true } to silence this rule.`,rule:"mutation-without-observer-coverage",step:n.label??n.id})})}function zm(e,t,r){Object.keys(t.spec.variables??{}).length!==0&&e.forEach(o=>{if(o.type!=="assertObserver")return;let i=Object.entries(o.params);i.length===0||i.some(([,a])=>Ui(a)&&Vi(a.value))||r({message:`assert.backend "${o.label??o.id}" passes only hardcoded params while the test defines precondition variables \u2014 observer assertions should reference {{namespace.key}} so they match the actual precondition data`,rule:"observer-params-reference-variables",step:o.label??o.id})})}function Gm(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 Km=[Em,Tm,Gm,$m,Am,Im,jm,Nm,Om,Um,Vm,Fm,Wm,Bm,zm];import Sf from"picomatch";import{execFileSync as Jm,spawnSync as Ym}from"child_process";function X(e,t){return Jm("git",[...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function Fi(e,t){let r=Ym("git",["show",e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]});if(r.status===0)return r.stdout;if(r.status===128)return null;throw new Error(`git show ${e} failed (${String(r.status)}): ${r.stderr}`)}import R from"typescript";import*as Mi from"remeda";var Hi=[["onClick","click"],["onContextMenu","click"],["onKeyDown","click"],["onKeyPress","click"],["onKeyUp","click"],["onSelect","click"],["onOpenChange","click"],["onPress","click"],["onActivate","click"],["onToggle","click"],["onOpen","click"],["onClose","click"],["onDismiss","click"],["onConfirm","click"],["onCancel","click"],["onApply","click"],["onClear","click"],["onSubmit","submit"],["onReset","submit"],["onDrop","drag"],["onDragEnd","drag"],["onDragEnter","drag"],["onDragLeave","drag"],["onDragOver","drag"],["onDragStart","drag"],["onValueChange","select"],["onSelectionChange","select"],["onChange","input"],["onCheckedChange","input"],["onInput","input"]],Xm=new Map([["button","click"],["link","navigate"],["textbox","input"],["searchbox","input"],["combobox","select"],["listbox","select"]]),Qm=[[/(?:^|[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 Ht({filePath:e,source:t}){let r=R.createSourceFile(e,t,R.ScriptTarget.Latest,!0,R.ScriptKind.TSX);return r.statements.flatMap(n=>Zm({filePath:e,sf:r,stmt:n}))}function Zm({filePath:e,sf:t,stmt:r}){let n=tf(r);if(n==null||ef(n))return[];let o=Wi(r,t).map(i=>({id:`${e}#${n}.${i.kind}[${i.label}]`,line:i.line}));return Mi.uniqueBy(o,i=>i.id)}function ef(e){return e.endsWith("Fragment")||e.endsWith("Skeleton")||/^use[A-Z]/.test(e)||/^[A-Z][A-Z0-9_]*$/.test(e)}function tf(e){if(R.isExportAssignment(e))return rf(e.expression);if(!nf(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 rf(e){return R.isIdentifier(e)?e.text:(R.isFunctionExpression(e)||R.isClassExpression(e))&&e.name!=null?e.name.text:"default"}function nf(e){if(!R.canHaveModifiers(e))return!1;let t=R.getModifiers(e);return t!=null&&t.some(r=>r.kind===R.SyntaxKind.ExportKeyword)}function Wi(e,t){let r=of(e,t),n=e.getChildren(t).flatMap(o=>Wi(o,t));return r==null?n:[r,...n]}function of(e,t){let r=sf(e);if(r==null)return null;let n=af(r);if(n==null)return null;let o=pf(r,n);return o==null?null:{kind:n,label:o,line:bf(t,e.getStart(t))}}function sf(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 af({attrs:e,tag:t}){let r=ue(e,"role");return r!=null?Xm.get(r)??null:cf(t,e)??df(t)??uf(e)}var lf=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 cf(e,t){return lf.get(e)?.(t)??null}function df(e){return/^[A-Z]/.test(e)?Qm.find(([t])=>t.test(e))?.[1]??null:null}function uf(e){return Hi.find(([t])=>gf(e,t))?.[1]??null}function pf({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")??(mf(r)?void 0:wf(t))??ff(e,n)}function mf(e){return e==="input"||e==="textarea"||e==="select"}function ff(e,t){let r=Hi.find(([,o])=>o===t)?.[0];if(r==null)return;let n=yf(e,r);if(n!=null){if(R.isIdentifier(n))return n.text;if(R.isArrowFunction(n)||R.isFunctionExpression(n))return qi(n.body)}}function qi(e){if(R.isCallExpression(e)){let t=e.expression;return R.isIdentifier(t)?t.text:R.isPropertyAccessExpression(t)?t.name.text:void 0}return R.forEachChild(e,qi)}function gf(e,t){return e.properties.some(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function Bi(e,t){return e.properties.find(r=>R.isJsxAttribute(r)&&R.isIdentifier(r.name)&&r.name.text===t)}function ue(e,t){let r=Bi(e,t);return r==null?void 0:hf(r.initializer)}function yf(e,t){let r=Bi(e,t);if(!(r?.initializer==null||!R.isJsxExpression(r.initializer)))return r.initializer.expression}function hf(e){if(e==null)return"";if(R.isStringLiteral(e))return e.text;if(R.isJsxExpression(e))return Gi(e.expression)}function wf(e){let t=e.flatMap(r=>zi(r)).join(" ").trim();return t.length===0?void 0:t}function zi(e){if(R.isJsxText(e)){let t=e.text.trim();return t.length===0?[]:[t]}if(R.isJsxExpression(e)){let t=Gi(e.expression);return t==null?[]:[t]}return R.isJsxElement(e)?e.children.flatMap(t=>zi(t)):[]}function Gi(e){if(e!=null){if(R.isStringLiteral(e)||R.isNoSubstitutionTemplateLiteral(e))return e.text;if(R.isCallExpression(e)&&e.arguments.length===1){let t=e.arguments[0];if(t!=null&&(R.isStringLiteral(t)||R.isNoSubstitutionTemplateLiteral(t)))return t.text}}}function bf(e,t){return e.getLineAndCharacterOfPosition(t).line+1}var vf=Wt.join(".ripplo","coverage.d.ts");function Fe({cwd:e}){kf({cwd:e,ignorePaths:xe})}function kf({cwd:e,ignorePaths:t}){let r=Me({cwd:e,ignorePaths:t});Pf({content:xf(r),cwd:e})}function Me({cwd:e,ignorePaths:t}){let n=Rf({cwd:e,ignorePaths:t}).flatMap(o=>un({cwd:e,file:o}));return[...new Set(n)].sort((o,i)=>o.localeCompare(i))}function Rf({cwd:e,ignorePaths:t}){let r=X(["ls-files","--cached","--others","--exclude-standard","-z"],e),n=Sf([...t]);return r.split("\0").filter(o=>o.length>0&&/\.(tsx|jsx)$/.test(o)).filter(o=>!n(o)).filter(o=>st.existsSync(Wt.join(e,o)))}function un({cwd:e,file:t}){let r=st.readFileSync(Wt.join(e,t),"utf8");return Ht({filePath:t,source:r}).map(n=>n.id)}function xf(e){let t=`// GENERATED \u2014 do not edit
|
|
212
212
|
import "@ripplo/testing";
|
|
213
213
|
|
|
214
214
|
declare module "@ripplo/testing" {
|
|
@@ -219,21 +219,22 @@ declare module "@ripplo/testing" {
|
|
|
219
219
|
`:`${t}${r}
|
|
220
220
|
}
|
|
221
221
|
}
|
|
222
|
-
`}function
|
|
222
|
+
`}function Pf({content:e,cwd:t}){let r=Wt.join(t,vf);st.existsSync(r)&&st.readFileSync(r,"utf8")===e||st.writeFileSync(r,e)}import Ki from"path";import{createJiti as Cf}from"jiti";var Ef=["getObservers","getPreconditions","getTests","getUnimplemented"];function Tf(e){return e==null||typeof e!="object"?!1:Ef.every(t=>typeof Reflect.get(e,t)=="function")}function $f(e){return e===null?"null":Array.isArray(e)?"array":typeof e}async function j(e){let t=Ki.join(e,".ripplo","index.ts"),r=Ki.join(e,".ripplo");try{let o=await Cf(import.meta.url,{moduleCache:!1,sourceMaps:!0}).import(t),i=o!=null&&typeof o=="object"&&"default"in o?Reflect.get(o,"default"):o;if(!Tf(i))return{error:`${t} must default-export a RipploBuilder (got ${$f(i)})`,ok:!1};let s=Mt(i);return{builder:i,ok:!0,result:s}}catch(n){return{error:If(n,r),ok:!1}}}var Af=/\(?([^\s()]{1,500}\.ts):(\d{1,10}):(\d{1,10})\)?$/;function If(e,t){if(!(e instanceof Error))return String(e);let r=jf(e.stack,t);return r==null?e.message:`${r} \u2014 ${e.message}`}function jf(e,t){if(e==null)return;let n=e.split(`
|
|
223
|
+
`).map(a=>Af.exec(a)).find(a=>a!=null&&a[1]!=null&&a[2]!=null&&a[3]!=null&&a[1].startsWith(t));if(n==null)return;let[,o,i,s]=n;return`${o??""}:${i??""}:${s??""}`}function x(e,t){return t==null?`Load \`/ripplo:${e}\` skill for instructions.`:`Load \`/ripplo:${e}\` skill for instructions on ${t}.`}function Ji(e){return e.length===1?x(e[0]):`REQUIRED before proceeding: load ${e.map(r=>`\`/ripplo:${r}\``).join(" AND ")} skills (load every one \u2014 each carries rules the others don't).`}async function Yi(e){let t=process.cwd(),r=await j(t);if(r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
223
224
|
`),process.stderr.write(`${x("create","DSL authoring + lint rules")}
|
|
224
|
-
`),process.exit(1)),e.check){let n=await
|
|
225
|
+
`),process.exit(1)),e.check){let n=await Vt({cwd:t}),o=Ft({compiled:r.result,existing:n});if(o==="match"){process.stdout.write(`${ce} is up to date
|
|
225
226
|
`);return}let i=o==="missing"?"missing":"out of date";process.stderr.write(`${ce} is ${i} \u2014 run \`ripplo compile\` and commit the result
|
|
226
227
|
`),process.stderr.write(`${x("setup")}
|
|
227
|
-
`),process.exit(1)}await de({cwd:t,result:r.result}),
|
|
228
|
-
`)}import ge from"process";import
|
|
229
|
-
`),ge.exit(1));let r=
|
|
228
|
+
`),process.exit(1)}await de({cwd:t,result:r.result}),Fe({cwd:t}),process.stdout.write(`wrote ${ce}
|
|
229
|
+
`)}import ge from"process";import Nf from"fs";import Of from"path";import Df from"picomatch";function Xi({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Me({cwd:t,ignorePaths:r})),o=es(e),i=Lf({cwd:t,ignorePaths:r});return Zi({acknowledged:o,allStatements:n,unacked:i})}function Qi({compileResult:e,cwd:t,ignorePaths:r}){let n=new Set(Me({cwd:t,ignorePaths:r})),o=es(e);return Zi({acknowledged:o,allStatements:n,unacked:n})}function Zi({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 es(e){return new Set(e.tests.flatMap(t=>t.coverage))}function Lf({cwd:e,ignorePaths:t}){let r=_f({cwd:e,ignorePaths:t}),n=new Set(r.flatMap(i=>Uf({cwd:e,file:i}))),o=new Set(r.flatMap(i=>Vf({cwd:e,file:i})?un({cwd:e,file:i}):[]));return new Set([...o].filter(i=>!n.has(i)))}function _f({cwd:e,ignorePaths:t}){let r=X(["diff","--name-only","HEAD","-z"],e),n=X(["ls-files","--others","--exclude-standard","-z"],e),o=Df([...t]);return[...new Set([...r.split("\0"),...n.split("\0")])].filter(i=>i.length>0&&/\.(tsx|jsx)$/.test(i)).filter(i=>!o(i))}function Uf({cwd:e,file:t}){let r=Fi(`HEAD:${t}`,e);return r==null?[]:Ht({filePath:t,source:r}).map(n=>n.id)}function Vf({cwd:e,file:t}){return Nf.existsSync(Of.join(e,t))}async function ts(){let e=ge.cwd(),t=await j(e);t.ok||(ge.stderr.write(`Compilation failed: ${t.error}
|
|
230
|
+
`),ge.exit(1));let r=Me({cwd:e,ignorePaths:xe}),n=Qi({compileResult:t.result,cwd:e,ignorePaths:xe}),o=n.filter(a=>a.kind==="unacknowledged"),i=n.filter(a=>a.kind==="stale"),s=r.length-o.length;ge.stdout.write(`Coverage: ${String(s)}/${String(r.length)} statements acknowledged
|
|
230
231
|
`),o.length>0&&(ge.stdout.write(`
|
|
231
232
|
Unacknowledged (${String(o.length)}):
|
|
232
233
|
`),o.forEach(a=>ge.stdout.write(` ${a.id}
|
|
233
234
|
`))),i.length>0&&(ge.stdout.write(`
|
|
234
235
|
Stale claims (${String(i.length)}):
|
|
235
236
|
`),i.forEach(a=>ge.stdout.write(` ${a.id}
|
|
236
|
-
`))),n.length>0&&ge.exit(1)}import
|
|
237
|
+
`))),n.length>0&&ge.exit(1)}import fn from"fs";import Bf from"path";import{chromium as zf}from"playwright";import{graphql as Mf}from"gql.tada";import rs from"fs";import pn from"path";function ns(e){let t=rs.realpathSync(e),r=t,n=pn.dirname(r);for(;n!==r;){if(rs.existsSync(pn.join(r,".git")))return r;r=n,n=pn.dirname(r)}return t}function W(e){let t=nr(e),r=Ie(),n=ne();if(n==null)throw new Error("ripplo: not authenticated. Run `ripplo auth login`.");return{appUrl:r.appUrl,cwd:ns(e),engineUrl:r.engineUrl,projectId:t.projectId,ripploServerUrl:fe(),token:n,webhookSecret:r.webhookSecret}}import at from"fs";var Ff="dev.pid";function os(e){return nt(e,Ff)}function He(e){let t=os(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 is(e){rt(e);let t=os(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{}}}}var Hf=Mf(`
|
|
237
238
|
query DevSessionCheckHealth($projectId: String!, $cwd: String!) {
|
|
238
239
|
project(id: $projectId) {
|
|
239
240
|
id
|
|
@@ -242,18 +243,18 @@ Stale claims (${String(i.length)}):
|
|
|
242
243
|
}
|
|
243
244
|
}
|
|
244
245
|
}
|
|
245
|
-
`);function
|
|
246
|
+
`);function ss(e){switch(e.status){case"active":return"\u2713 Dev session: ripplo watch is live for this directory";case"starting":return"! Dev session: `ripplo watch` is running locally but hasn't registered with the server yet. Wait a few seconds and re-run `npx ripplo doctor`. If it persists, check the watch process output for auth/network errors.";case"missing":return"\u2717 Dev session: no active ripplo watch. Start `npx ripplo watch` as a background process (separate from your app's dev server). Without it, `ripplo run` will refuse to dispatch and scope/coverage hooks won't arm."}}async function as(e){let t=He(e),r;try{r=W(e)}catch{return{status:t?"starting":"missing",type:"dev-session"}}return(await S({config:r,document:Hf,variables:{cwd:r.cwd,projectId:r.projectId}}).catch(()=>null))?.project?.devSession!=null?{status:"active",type:"dev-session"}:{status:t?"starting":"missing",type:"dev-session"}}import Wf from"fs";import qf from"path";async function ls(e){let t=qf.join(e,".ripplo","index.ts");if(!Wf.existsSync(t))return{appUrl:void 0,engineUrl:void 0,errors:[{message:".ripplo/index.ts not found",path:""}],valid:!1,warnings:[]};let r=await j(e);if(!r.ok)return{appUrl:void 0,engineUrl:void 0,errors:[{message:r.error,path:".ripplo/"}],valid:!1,warnings:[]};try{let n=Ie();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 mn(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 cs({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 ds(e){switch(e.type){case"settings":return!e.valid;case"env-files":return e.missing.length>0;case"token":return!e.exists;case"dev-server":return!e.reachable;case"dev-session":return e.status!=="active";case"preconditions":return e.count>0&&!e.configured;case"engine-endpoint":return!e.reachable;case"adapter-enabled":return e.status!=="enabled";case"webhook-verification":return!e.rejectsUnsigned;case"preconditions-validation":return!e.valid;case"workflows":return e.invalidNames.length>0;case"browser":return!e.installed;case"lockfile":return e.status!=="match";case"pre-commit-hook":return!e.installed}}async function us(e){let t=await Jf(e),r={missing:sr(e),type:"env-files"},n=Yf(),o=Xf(),i=await j(e),s=Qf(i),a=tg(i),l=await Gf(e,i),c=Kf(e),d=await rg(t,i);return[t,r,n,...d,s,a,l,c,o]}async function Gf(e,t){if(!t.ok)return{status:"missing",type:"lockfile"};let r=await Vt({cwd:e});return{status:Ft({compiled:t.result,existing:r}),type:"lockfile"}}function Kf(e){let t=Bf.join(e,".git","hooks","pre-commit");return fn.existsSync(t)?{installed:fn.readFileSync(t,"utf8").includes("ripplo compile --check"),type:"pre-commit-hook"}:{installed:!1,type:"pre-commit-hook"}}async function Jf(e){let t=await ls(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 Yf(){let e=ne();return{exists:e!=null&&e.length>0,type:"token"}}function Xf(){let e=zf.executablePath();return{installed:fn.existsSync(e),type:"browser"}}function Qf(e){if(!e.ok)return{errorCount:1,errors:[{message:e.error,path:""}],found:!1,type:"preconditions-validation",valid:!1};let t=Zf(e.result.preconditions,e.result.tests);return{errorCount:t.length,errors:t,found:!0,type:"preconditions-validation",valid:t.length===0}}function Zf(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}`})})}),eg(e).forEach(o=>{r.push({message:o,path:"preconditions"})}),r}function eg(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 tg(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 rg(e,t){if(!e.valid||!t.ok)return[];let r;try{let a=Ie();r={appUrl:a.appUrl,engineUrl:a.engineUrl,webhookSecret:a.webhookSecret}}catch{return[]}let n=[],o=await mn(r.appUrl)==null;n.push({appUrl:r.appUrl,reachable:o,type:"dev-server"});let i=await as(process.cwd());n.push(i);let s=await ng(r,t);return n.push(...s),n}async function ng(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=sg(e.appUrl,e.engineUrl);if(i==null)return[o];let s=await mn(i)==null,a=[];if(a.push({configured:!0,count:r,endpointReachable:s,type:"preconditions"}),ps(e.engineUrl)&&a.push({reachable:s,type:"engine-endpoint",url:i}),!s)return a;let l=await cs({appUrl:e.appUrl,engineUrl:e.engineUrl});a.push({rejectsUnsigned:l==null,type:"webhook-verification"});let c=await og({engineUrl:i,webhookSecret:e.webhookSecret});return a.push({status:c,type:"adapter-enabled",url:i}),a}async function og({engineUrl:e,webhookSecret:t}){if(t.length===0)return"no-secret";let r=JSON.stringify({preconditions:[]});try{let n=await fetch(`${e}/execute-preconditions`,{body:r,headers:{"Content-Type":"application/json",...ke({body:r,secret:t})},method:"PUT",signal:AbortSignal.timeout(5e3)});return n.status===404?"disabled":n.status===401||n.status===403?"bad-secret":"enabled"}catch{return"unreachable"}}function ig(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 ps(e){return e.startsWith("http://")||e.startsWith("https://")}function sg(e,t){return ps(t)?t:`${e}${t}`}function ms(e){switch(e.type){case"settings":return cg(e);case"env-files":return dg(e);case"token":return ug(e);case"dev-server":return pg(e);case"dev-session":return ss(e);case"preconditions":return gg(e);case"webhook-verification":return mg(e);case"preconditions-validation":return yg(e);case"workflows":return hg(e);case"browser":return fg(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 ig(e);case"lockfile":return ag(e);case"pre-commit-hook":return lg(e)}}function ag(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 lg(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 cg(e){return e.valid?"\u2713 Settings: Project configured":`\u2717 Settings: Missing fields: ${e.missingFields.join(", ")}`}function dg(e){return e.missing.length===0?"\u2713 Env files: declared files present":`\u2717 Env files: declared in .ripplo/project.json but missing:
|
|
246
247
|
${e.missing.map(r=>` ${r}`).join(`
|
|
247
248
|
`)}
|
|
248
|
-
If you're in a git worktree, copy the env file from the main checkout (or symlink to a shared file outside the working tree).`}function
|
|
249
|
+
If you're in a git worktree, copy the env file from the main checkout (or symlink to a shared file outside the working tree).`}function ug(e){return e.exists?"\u2713 Auth: Token found":"\u2717 Auth: No token found. Run `ripplo` to authenticate."}function pg(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 mg(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 fg(e){return e.installed?"\u2713 Browser: Chromium installed":"\u2717 Browser: Chromium not installed. Run: npx playwright install chromium"}function gg(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 yg(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"}
|
|
249
250
|
${t.join(`
|
|
250
|
-
`)}`}function
|
|
251
|
+
`)}`}function hg(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=>wg(r));return`\u2717 Tests: ${String(e.invalidNames.length)} invalid
|
|
251
252
|
${t.join(`
|
|
252
|
-
`)}`}function
|
|
253
|
+
`)}`}function wg(e){let t=e.errors.map(r=>" - "+(r.path===""?"":r.path+": ")+r.message);return" "+e.name+`:
|
|
253
254
|
`+t.join(`
|
|
254
|
-
`)}async function
|
|
255
|
+
`)}async function fs(){let e=process.cwd(),t=await us(e),r=t.map(o=>ms(o));process.stdout.write(r.join(`
|
|
255
256
|
`)+`
|
|
256
|
-
`);let n=t.some(o=>
|
|
257
|
+
`);let n=t.some(o=>ds(o));process.exit(n?1:0)}import{graphql as Bt,readFragment as Cg}from"gql.tada";import Sg from"crypto";import{graphql as vg}from"gql.tada";import gn from"fs";import yn from"path";function qt(e){try{let t=yn.join(bg(e),"HEAD"),r=gn.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 bg(e){let t=yn.join(e,".git");if(gn.statSync(t).isDirectory())return t;let n=gn.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 yn.resolve(e,i)}var kg=vg(`
|
|
257
258
|
mutation SyncDevSession(
|
|
258
259
|
$projectId: String!
|
|
259
260
|
$cwd: String!
|
|
@@ -271,12 +272,12 @@ ${t.join(`
|
|
|
271
272
|
id
|
|
272
273
|
}
|
|
273
274
|
}
|
|
274
|
-
`);async function
|
|
275
|
+
`);async function lt(e){let t=Rg(e.compiled);return Pg({config:e.config,cwd:e.cwd,payload:t})}async function $e(e,t){let r=await j(e);if(!r.ok)throw new Error(`DSL compilation failed: ${r.error}`);let n=await lt({compiled:r.result,config:t,cwd:e});return{compiled:r.result,devSessionId:n.devSessionId}}function Rg(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 xg(e){return Sg.createHash("sha256").update(JSON.stringify(e)).digest("hex")}async function Pg({config:e,cwd:t,payload:r}){let n=xg(r),o=qt(t),i=await S({config:e,document:kg,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 gs from"figures";var ct={cross:gs.cross,tick:gs.tick};var hs=Bt(`
|
|
275
276
|
fragment WorkflowIdMCP on Workflow {
|
|
276
277
|
id
|
|
277
278
|
slug
|
|
278
279
|
}
|
|
279
|
-
`),
|
|
280
|
+
`),Eg=Bt(`
|
|
280
281
|
query ProjectWorkflowIdsMCP($projectId: String!, $cwd: String!) {
|
|
281
282
|
project(id: $projectId) {
|
|
282
283
|
id
|
|
@@ -288,14 +289,14 @@ ${t.join(`
|
|
|
288
289
|
}
|
|
289
290
|
}
|
|
290
291
|
}
|
|
291
|
-
`,[
|
|
292
|
+
`,[hs]),Tg=Bt(`
|
|
292
293
|
mutation CreateRunMCP($workflowId: String!, $platforms: [String!]!, $concurrency: Int!) {
|
|
293
294
|
createRun(workflowId: $workflowId, platforms: $platforms, concurrency: $concurrency) {
|
|
294
295
|
id
|
|
295
296
|
status
|
|
296
297
|
}
|
|
297
298
|
}
|
|
298
|
-
`)
|
|
299
|
+
`),$g=Bt(`
|
|
299
300
|
query RunStatusMCP($id: String!) {
|
|
300
301
|
run(id: $id) {
|
|
301
302
|
id
|
|
@@ -322,8 +323,8 @@ ${t.join(`
|
|
|
322
323
|
}
|
|
323
324
|
}
|
|
324
325
|
}
|
|
325
|
-
`);async function
|
|
326
|
-
${x("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await
|
|
326
|
+
`);async function zt({config:e,ids:t}){let r=await Ag({config:e,ids:t}),n=await Promise.all(r.map(async s=>{try{let a=await Dg({config:e,workflowId:s.workflowId});return{entry:s,ok:!0,runId:a}}catch(a){let l=a instanceof Error?a.message:String(a);return{entry:s,message:l,ok:!1}}})),o=await Promise.all(n.map(async s=>{if(!s.ok)return{id:s.entry.id,runId:"",summary:`ERROR creating run: ${s.message}
|
|
327
|
+
${x("setup","check auth + config")}`};let{entry:a,runId:l}=s;try{let c=await _g({config:e,runId:l}),d=Og({config:e,id:a.id,runId:l}),u=`.ripplo/debug/${l}/`;return{id:a.id,runId:l,summary:`View run: ${d}
|
|
327
328
|
Debug artifacts: ${u}
|
|
328
329
|
${x("debug","read summary.txt, accessibility-tree, network.jsonl before guessing")}
|
|
329
330
|
|
|
@@ -333,10 +334,10 @@ ${s.summary}`).join(`
|
|
|
333
334
|
|
|
334
335
|
---
|
|
335
336
|
|
|
336
|
-
`);return{results:o,summary:i}}async function
|
|
337
|
+
`);return{results:o,summary:i}}async function Ag({config:e,ids:t}){let r=await $e(e.cwd,e),n=await S({config:e,document:Eg,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=>Cg(hs,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(Ig({compiledSlugs:i,slug:s}));return{id:s,workflowId:a.id}})}function Ig({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=jg({compiledSlugs:e,limit:3,slug:t}),n=r.length>0?`
|
|
337
338
|
Did you mean: ${r.join(", ")}?`:"";return`Test "${t}" is not registered in this dev session.${n}
|
|
338
|
-
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function
|
|
339
|
-
`)}function
|
|
339
|
+
Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on demand \u2014 restarting the dev server will not help.)`}function jg({compiledSlugs:e,limit:t,slug:r}){let n=new Set(r.split("-"));return e.map(i=>({candidate:i,score:Ng(n,i)})).filter(i=>i.score>0).toSorted((i,s)=>s.score-i.score).slice(0,t).map(i=>i.candidate)}function Ng(e,t){return t.split("-").filter(r=>e.has(r)).length}function Og({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 Dg({config:e,workflowId:t}){let r=await S({config:e,document:Tg,variables:{concurrency:1,platforms:["chromium"],workflowId:t}});if(r.createRun==null)throw new Error("Failed to create run");return r.createRun.id}var Lg=2e3,ys=150;async function _g({config:e,runId:t}){let r=0;for(;r<ys;){await Vg(Lg),r+=1;let o=(await S({config:e,document:$g,variables:{id:t}})).run;if(o==null)throw new Error(`Run ${t} not found`);if(!(o.status==="pending"||o.status==="running"))return Ug({results:o.results??[],runId:t,status:o.status})}return`Run ${t} timed out after polling ${String(ys)} times.`}function Ug({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"?ct.tick:ct.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"?ct.tick:ct.cross,d=l.detail==null?"":` \u2014 ${l.detail}`;n.push(` ${c} ${l.description}${d}`)})})}),n.join(`
|
|
340
|
+
`)}function Vg(e){return new Promise(t=>{setTimeout(t,e)})}import{graphql as Fg}from"gql.tada";var Mg=Fg(`
|
|
340
341
|
query DevSessionCheckPreflight($projectId: String!, $cwd: String!) {
|
|
341
342
|
project(id: $projectId) {
|
|
342
343
|
id
|
|
@@ -347,34 +348,34 @@ Tests must be exported from .ripplo/tests/index.ts. (ripplo run already syncs on
|
|
|
347
348
|
}
|
|
348
349
|
`);function ye(){try{return W(process.cwd())}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`${t}
|
|
349
350
|
`),process.stderr.write(`${x("setup")}
|
|
350
|
-
`),process.exit(1)}}async function he(e){(await S({config:e,document:
|
|
351
|
-
`),process.exit(1))}async function
|
|
352
|
-
`);let n=await Promise.allSettled(Array.from({length:t},()=>
|
|
351
|
+
`),process.exit(1)}}async function he(e){(await S({config:e,document:Mg,variables:{cwd:e.cwd,projectId:e.projectId}})).project?.devSession==null&&(process.stderr.write("No active dev session. Start `npx ripplo watch` as a background process (your app's dev server must also be running), then retry. Or run `/ripplo:start` in Claude Code.\n"),process.stderr.write(`${x("setup")}
|
|
352
|
+
`),process.exit(1))}async function ws({id:e,runs:t}){let r=ye();await he(r),process.stdout.write(`flake-detect "${e}" x${String(t)}...
|
|
353
|
+
`);let n=await Promise.allSettled(Array.from({length:t},()=>zt({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(`
|
|
353
354
|
`).find(u=>u.includes("FAILED")||u.includes("ERROR"))??"unknown failure";s.set(d,(s.get(d)??0)+1)}else o++});let a=t>0?i/t*100:0;process.stdout.write(`${String(o)} passed / ${String(i)} failed (${a.toFixed(1)}% flake)
|
|
354
355
|
`),s.size>0&&s.forEach((l,c)=>{process.stdout.write(` ${String(l)}x: ${c}
|
|
355
356
|
`)}),i>0&&process.stderr.write(`${x("flake-detect","parallel safety + race conditions")}
|
|
356
|
-
`),process.exit(i>0?1:0)}import
|
|
357
|
+
`),process.exit(i>0?1:0)}import Gt from"fs";import{graphql as Wg}from"gql.tada";import Hg from"fs";function pe(e){return nt(e,"hooks-paused")}function M(e){return Hg.existsSync(pe(e))?!1:He(e)}var qg=Wg(`
|
|
357
358
|
mutation CliSetHooksPaused($projectId: String!, $paused: Boolean!) {
|
|
358
359
|
setHooksPaused(projectId: $projectId, paused: $paused)
|
|
359
360
|
}
|
|
360
|
-
`);async function
|
|
361
|
-
`);return}
|
|
362
|
-
`)}async function
|
|
363
|
-
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function
|
|
361
|
+
`);async function bs(){process.stdin.isTTY||(process.stderr.write("`ripplo hooks pause` must be invoked interactively from a terminal \u2014 refusing non-TTY invocation. Bypassing the gate is a human decision, not an agent decision.\n"),process.exit(1));let e=process.cwd();rt(e);let t=pe(e);if(Gt.existsSync(t)){process.stdout.write("Hooks already paused. Run `ripplo hooks resume` to re-enable.\n");return}Gt.writeFileSync(t,""),await vs(e,!0),process.stdout.write("Hooks paused. Pre-edit gates and stop enforcement are off until you run `ripplo hooks resume`.\n")}async function Ss(){let e=process.cwd(),t=pe(e);if(!Gt.existsSync(t)){process.stdout.write(`Hooks already active.
|
|
362
|
+
`);return}Gt.unlinkSync(t),await vs(e,!1),process.stdout.write(`Hooks resumed.
|
|
363
|
+
`)}async function vs(e,t){let r;try{r=W(e)}catch{return}await S({config:r,document:qg,variables:{paused:t,projectId:r.projectId}}).catch(()=>null)}import We from"fs";import qe from"path";import{input as xs,select as Ps}from"@inquirer/prompts";import{graphql as dy}from"gql.tada";import{exec as Bg}from"child_process";import H from"fs";import q from"path";import{promisify as zg}from"util";var Gg=["@ripplo/testing"],ks=".ripplo/ripplo.lock linguist-generated=true",Kg=[".ripplo/debug/",".ripplo/.local/"],Jg=zg(Bg);async function Rs({cwd:e,onStep:t}){t("Scaffolding project files..."),ny({cwd:e}),t("Updating .gitignore..."),oy(e),t("Marking ripplo.lock as generated..."),Qg(e),t("Installing dependencies...");let r=await Yg(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 Xg(e);o!=null&&n.push({manualCommand:void 0,message:o})}return t("Setting up browser..."),await Pr(),n}async function Yg(e){let t=Zg({cwd:e,pm:ry(e)});g.info("Installing dependencies: %s",t);try{return await Jg(t,{cwd:e}),{ok:!0}}catch(r){let n=r instanceof Error?r.message.split(`
|
|
364
|
+
`)[0]??r.message:String(r);return g.warn("Install failed (%s): %s",t,n),{cmd:t,ok:!1,reason:n}}}async function Xg(e){try{let t=await j(e);if(!t.ok)return;await de({cwd:e,result:t.result});return}catch(t){return`Couldn't compile initial lockfile: ${t instanceof Error?t.message:String(t)}.`}}function Qg(e){let t=q.join(e,".gitattributes"),r=H.existsSync(t)?H.readFileSync(t,"utf8"):"";if(r.includes(ks))return;let n=r.length===0||r.endsWith(`
|
|
364
365
|
`)?"":`
|
|
365
|
-
`;
|
|
366
|
-
`)}function
|
|
366
|
+
`;H.writeFileSync(t,`${r}${n}${ks}
|
|
367
|
+
`)}function Zg({cwd:e,pm:t}){let r=Gg.join(" ");return t==="pnpm"?ey(e)?`pnpm add -wD ${r}`:`pnpm add -D ${r}`:t==="yarn"?ty(e)?`yarn add -WD ${r}`:`yarn add -D ${r}`:t==="bun"?`bun add -d ${r}`:`npm install -D ${r}`}function ey(e){return H.existsSync(q.join(e,"pnpm-workspace.yaml"))||H.existsSync(q.join(e,"pnpm-workspace.yml"))}function ty(e){let t=q.join(e,"package.json");if(!H.existsSync(t))return!1;try{let r=JSON.parse(H.readFileSync(t,"utf8"));if(r==null||typeof r!="object"||!("workspaces"in r))return!1;let n=r.workspaces;return Array.isArray(n)||n!=null&&typeof n=="object"}catch{return!1}}function ry(e){return H.existsSync(q.join(e,"pnpm-lock.yaml"))?"pnpm":H.existsSync(q.join(e,"yarn.lock"))?"yarn":H.existsSync(q.join(e,"bun.lockb"))||H.existsSync(q.join(e,"bun.lock"))?"bun":"npm"}function ny({cwd:e}){let t=q.join(e,".ripplo"),r=q.join(t,"tests"),n=q.join(t,"preconditions"),o=q.join(t,"observers");H.mkdirSync(r,{recursive:!0}),H.mkdirSync(n,{recursive:!0}),H.mkdirSync(o,{recursive:!0}),dt(q.join(t,"index.ts"),iy),dt(q.join(n,"index.ts"),sy),dt(q.join(o,"index.ts"),ay),dt(q.join(r,"index.ts"),ly),dt(q.join(t,"tsconfig.json"),cy)}function dt(e,t){H.existsSync(e)||H.writeFileSync(e,t)}function oy(e){let t=q.join(e,".gitignore");if(!H.existsSync(t))return;let r=H.readFileSync(t,"utf8"),n=Kg.filter(i=>!r.includes(i));if(n.length===0)return;let o=r.endsWith(`
|
|
367
368
|
`)?"":`
|
|
368
|
-
`;
|
|
369
|
+
`;H.writeFileSync(t,r+o+n.join(`
|
|
369
370
|
`)+`
|
|
370
|
-
`)}var
|
|
371
|
+
`)}var iy=`import { createRipplo } from "@ripplo/testing";
|
|
371
372
|
import { preconditions } from "./preconditions/index.js";
|
|
372
373
|
import { observers } from "./observers/index.js";
|
|
373
374
|
import { tests } from "./tests/index.js";
|
|
374
375
|
|
|
375
376
|
export { preconditions, observers, tests };
|
|
376
377
|
export default createRipplo({ preconditions, observers, tests });
|
|
377
|
-
`,
|
|
378
|
+
`,sy=`// Declare preconditions with \`precondition(name)\` from @ripplo/testing and collect them
|
|
378
379
|
// in the \`preconditions\` registry below. Every handle in this registry must be implemented
|
|
379
380
|
// in your app server's \`createEngine(ripplo, { preconditions: {...}, observers: {...} })\` call.
|
|
380
381
|
//
|
|
@@ -388,7 +389,7 @@ export default createRipplo({ preconditions, observers, tests });
|
|
|
388
389
|
// export const preconditions = { authLoggedIn };
|
|
389
390
|
|
|
390
391
|
export const preconditions = {};
|
|
391
|
-
`,
|
|
392
|
+
`,ay=`// Declare observers with \`observer(name)\` from @ripplo/testing and collect them in
|
|
392
393
|
// the \`observers\` registry below. Use them in tests via \`assert.backend(handle, params)\`.
|
|
393
394
|
//
|
|
394
395
|
// Example:
|
|
@@ -401,7 +402,7 @@ export const preconditions = {};
|
|
|
401
402
|
// export const observers = { orgNameIs };
|
|
402
403
|
|
|
403
404
|
export const observers = {};
|
|
404
|
-
`,
|
|
405
|
+
`,ly=`// Each test file under ./tests exports a TestDefinition. Import them here and add them
|
|
405
406
|
// to the \`tests\` array \u2014 that's what \`createRipplo({ ..., tests })\` receives.
|
|
406
407
|
//
|
|
407
408
|
// Example:
|
|
@@ -409,7 +410,7 @@ export const observers = {};
|
|
|
409
410
|
// export const tests = [myTest] as const;
|
|
410
411
|
|
|
411
412
|
export const tests = [] as const;
|
|
412
|
-
`,
|
|
413
|
+
`,cy=`{
|
|
413
414
|
"compilerOptions": {
|
|
414
415
|
"strict": true,
|
|
415
416
|
"noUncheckedIndexedAccess": true,
|
|
@@ -425,60 +426,60 @@ export const tests = [] as const;
|
|
|
425
426
|
"include": ["*.ts", "coverage.d.ts", "observers/**/*.ts", "preconditions/**/*.ts", "tests/**/*.ts"],
|
|
426
427
|
"exclude": ["node_modules"]
|
|
427
428
|
}
|
|
428
|
-
`;var
|
|
429
|
+
`;var uy=dy(`
|
|
429
430
|
query InitProjects {
|
|
430
431
|
projects {
|
|
431
432
|
id
|
|
432
433
|
name
|
|
433
434
|
}
|
|
434
435
|
}
|
|
435
|
-
`),
|
|
436
|
-
`),process.exit(1));let o=await
|
|
436
|
+
`),hn=["../.env.local","../.env"];async function Cs(e=fy()){let t=process.cwd(),r=ne();r==null&&(process.stdout.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let n=fe();py(t)&&(process.stdout.write(`\`.ripplo/index.ts\` already exists at ${t}. Delete it first if you want to re-init.
|
|
437
|
+
`),process.exit(1));let o=await my({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 yy(o,e.projectId),s=await hy(t,e.envFile),a=await wy(e.appUrl),l=gy(a,e.engineUrl),c=qe.resolve(qe.join(t,".ripplo"),s);Pn({cwd:t,envFiles:[s],projectId:i}),vy({appUrl:a,engineUrl:l,filePath:c});let d=await Rs({cwd:t,onStep:u=>{process.stdout.write(` ${u}
|
|
437
438
|
`)}});if(d.length>0){process.stdout.write(`Done with warnings:
|
|
438
439
|
`),d.forEach(u=>{process.stdout.write(` - ${u.message}
|
|
439
440
|
`),u.manualCommand!=null&&process.stdout.write(` run: ${u.manualCommand}
|
|
440
|
-
`)});return}process.stdout.write("Ready. Start `npx ripplo watch` as a background process (or run `/ripplo:start` in Claude Code), then write tests in `.ripplo/tests/`.\n")}function
|
|
441
|
-
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function
|
|
441
|
+
`)});return}process.stdout.write("Ready. Start `npx ripplo watch` as a background process (or run `/ripplo:start` in Claude Code), then write tests in `.ripplo/tests/`.\n")}function py(e){return We.existsSync(qe.join(e,".ripplo","index.ts"))}async function my({serverUrl:e,token:t}){return((await S({config:Le({serverUrl:e,token:t}),document:uy,variables:void 0})).projects??[]).map(n=>({id:n.id,name:n.name}))}function fy(){return{appUrl:void 0,engineUrl:void 0,envFile:void 0,projectId:void 0}}function gy(e,t){if(t!=null){try{new URL(t)}catch{process.stdout.write(`--engine-url is not a valid URL: ${t}
|
|
442
|
+
`),process.exit(1)}return t}return`${e.replace(/\/$/,"")}/ripplo`}async function yy(e,t){if(t!=null){let r=e.find(n=>n.id===t);return r==null&&(process.stdout.write(`Unknown project id: ${t}
|
|
442
443
|
`),process.exit(1)),process.stdout.write(`Using project: ${r.name} (${r.id})
|
|
443
444
|
`),r.id}if(e.length===1){let r=e[0];if(r==null)throw new Error("unreachable");return process.stdout.write(`Using project: ${r.name} (${r.id})
|
|
444
|
-
`),r.id}return
|
|
445
|
-
`),process.exit(1)),t):
|
|
446
|
-
`),process.exit(1)}return e}return
|
|
445
|
+
`),r.id}return Ps({choices:e.map(r=>({name:r.name,value:r.id})),message:"Select a project"})}async function hy(e,t){return t!=null?(t.trim().length===0&&(process.stdout.write(`--env must not be empty
|
|
446
|
+
`),process.exit(1)),t):by(e)}async function wy(e){if(e!=null){try{new URL(e)}catch{process.stdout.write(`--app-url is not a valid URL: ${e}
|
|
447
|
+
`),process.exit(1)}return e}return Sy()}async function by(e){let t=qe.join(e,".ripplo"),r=hn.find(o=>We.existsSync(qe.resolve(t,o))),n=await Ps({choices:[...hn.map(o=>({name:r===o?`${o} (detected)`:o,value:o})),{name:"custom path",value:"__custom__"}],default:r??hn[0],message:"Which env file should ripplo write RIPPLO_APP_URL, RIPPLO_ENGINE_URL, and RIPPLO_WEBHOOK_SECRET to?"});return n!=="__custom__"?n:xs({message:"Path to env file (relative to .ripplo/, e.g. ../apps/server/.env)",validate:o=>o.trim().length>0?!0:"required"})}async function Sy(){return xs({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 vy({appUrl:e,engineUrl:t,filePath:r}){We.mkdirSync(qe.dirname(r),{recursive:!0});let n=We.existsSync(r)?We.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=${Br()}`),o.length===0)return;let i=n.length===0||n.endsWith(`
|
|
447
448
|
`)?"":`
|
|
448
|
-
`;
|
|
449
|
+
`;We.writeFileSync(r,`${n}${i}${o.join(`
|
|
449
450
|
`)}
|
|
450
|
-
`)}import
|
|
451
|
+
`)}import wn from"fs";import Es from"path";import*as Ts from"remeda";async function $s(e){let{ids:t,requireImplemented:r}=e,n=process.cwd(),o=await j(n);o.ok||(process.stderr.write(`Compilation failed: ${o.error}
|
|
451
452
|
`),process.stderr.write(`${x("create","DSL authoring + lint rules")}
|
|
452
|
-
`),process.exit(1)),await de({cwd:n,result:o.result});let i=
|
|
453
|
+
`),process.exit(1)),await de({cwd:n,result:o.result});let i=Ue(o.result),s=t.length===0?i.diagnostics:i.diagnostics.filter(w=>t.includes(w.test)),a=Ts.groupBy(s,w=>w.test);Object.entries(a).forEach(([w,h])=>{process.stderr.write(`
|
|
453
454
|
${w}
|
|
454
455
|
`),h.forEach(v=>{let E=v.step==null?"":` at "${v.step}"`;process.stderr.write(` [${v.rule}]${E}
|
|
455
456
|
`),process.stderr.write(` ${v.message}
|
|
456
457
|
`)})});let l=new Set(o.builder.getUnimplemented().tests),c=r.filter(w=>l.has(w));c.length>0&&(process.stderr.write(`
|
|
457
458
|
not-implemented
|
|
458
459
|
`),c.forEach(w=>{process.stderr.write(` ${w} is still marked .notImplemented()
|
|
459
|
-
`)}));let d=
|
|
460
|
+
`)}));let d=Py(n);d.length>0&&(process.stderr.write(`
|
|
460
461
|
preconditions
|
|
461
462
|
`),d.forEach(w=>{process.stderr.write(` [hardcoded-identifier] ${w.file}
|
|
462
463
|
`),process.stderr.write(` ${w.message}
|
|
463
464
|
`)}));let u=s.length+c.length+d.length;u>0&&(process.stderr.write(`
|
|
464
465
|
${String(u)} error(s)
|
|
465
|
-
`),
|
|
466
|
-
`)}function
|
|
467
|
-
`))}var
|
|
466
|
+
`),ky({diagnostics:s,hardcodeWarnings:d,stillStubbed:c}),process.exit(1));let f=o.result.tests.length,b=t.length===0?"all tests":`${String(t.length)} test(s)`;process.stdout.write(`\u2713 ripplo lint: ${b} passed (${String(f)} compiled, lockfile written)
|
|
467
|
+
`)}function ky({diagnostics:e,hardcodeWarnings:t,stillStubbed:r}){let n=new Set;(e.length>0||r.length>0)&&n.add("create"),t.length>0&&n.add("explore"),n.forEach(o=>process.stderr.write(`${x(o)}
|
|
468
|
+
`))}var Ry=/['"`][\w.+-]+@[\w.-]+\.[a-z]{2,}['"`]/i,xy=/['"`][0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}['"`]/i;function Py(e){let t=Es.join(e,".ripplo","preconditions");return wn.existsSync(t)?wn.readdirSync(t).filter(n=>n.endsWith(".ts")).flatMap(n=>Cy(Es.join(t,n))):[]}function Cy(e){let t=wn.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=xy.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 Ey}from"gql.tada";var Ty=Ey(`
|
|
468
469
|
query ProjectsList {
|
|
469
470
|
projects {
|
|
470
471
|
id
|
|
471
472
|
name
|
|
472
473
|
}
|
|
473
474
|
}
|
|
474
|
-
`);async function
|
|
475
|
-
`)}async function
|
|
475
|
+
`);async function As(){let e=ne();e==null&&(process.stderr.write("Not authenticated. Run `ripplo auth login` first.\n"),process.exit(1));let t=fe(),n=((await S({config:Le({serverUrl:t,token:e}),document:Ty,variables:void 0})).projects??[]).map(o=>({id:o.id,name:o.name}));process.stdout.write(`${JSON.stringify({projects:n},null,2)}
|
|
476
|
+
`)}async function Is(e){let t=ye();await he(t);let{results:r,summary:n}=await zt({config:t,ids:e});process.stdout.write(`${n}
|
|
476
477
|
`);let o=r.some(i=>i.summary.includes("FAILED")||i.summary.includes("ERROR"));o&&(process.stderr.write(`Artifacts in .ripplo/debug/<runId>/ \u2014 read before re-running.
|
|
477
478
|
`),process.stderr.write(`${x("debug")}
|
|
478
|
-
`)),process.exit(o?1:0)}async function
|
|
479
|
+
`)),process.exit(o?1:0)}async function js(){let e=process.cwd(),t=W(e);try{let r=await $e(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}
|
|
479
480
|
`)}catch(r){let n=r instanceof Error?r.message:String(r);process.stderr.write(`ripplo sync failed: ${n}
|
|
480
481
|
`),process.stderr.write(`${x("setup","verify auth + server reachability")}
|
|
481
|
-
`),process.exit(1)}}import
|
|
482
|
+
`),process.exit(1)}}import Sn from"fs";import{createClient as Dy}from"graphql-sse";import{graphql as Kt}from"gql.tada";import{print as Os}from"graphql";import{availableParallelism as $y}from"os";import Ay from"p-limit";var Iy=Math.min(10,$y()/2),jy=Ay(Iy),bn=new Set;async function Ns(e){if(!bn.has(e.runId)){bn.add(e.runId);try{await jy(()=>Ny(e))}finally{bn.delete(e.runId)}}}async function Ny({agentProfileDescription:e,agentProfileId:t,config:r,cwd:n,runId:o,workflowId:i,workflowSlug:s}){let a=await Ee({headed:!1});try{await Nr({maxRuns:100});let l=n!=null&&s!=null?await Oy({cwd:n,workflowSlug:s}):void 0;await Qr({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 Oy({cwd:e,workflowSlug:t}){let r=await j(e);if(!r.ok)return;let n=r.result.tests.find(o=>o.slug===t);if(n!=null)return n.preconditions}var Ly=15e3,_y=Kt(`
|
|
482
483
|
subscription RunRequestedWatch($devSessionId: String!) {
|
|
483
484
|
runRequested(devSessionId: $devSessionId) {
|
|
484
485
|
agentProfileDescription
|
|
@@ -488,30 +489,30 @@ ${String(u)} error(s)
|
|
|
488
489
|
workflowSlug
|
|
489
490
|
}
|
|
490
491
|
}
|
|
491
|
-
`),
|
|
492
|
+
`),Uy=Kt(`
|
|
492
493
|
subscription HooksPausedWatch($projectId: String!) {
|
|
493
494
|
hooksPausedRequested(projectId: $projectId) {
|
|
494
495
|
paused
|
|
495
496
|
projectId
|
|
496
497
|
}
|
|
497
498
|
}
|
|
498
|
-
`),
|
|
499
|
+
`),Vy=Kt(`
|
|
499
500
|
mutation HeartbeatDevSessionWatch($id: String!) {
|
|
500
501
|
heartbeatDevSession(id: $id) {
|
|
501
502
|
id
|
|
502
503
|
}
|
|
503
504
|
}
|
|
504
|
-
`),
|
|
505
|
+
`),Fy=Kt(`
|
|
505
506
|
mutation EndDevSessionWatch($projectId: String!, $cwd: String!) {
|
|
506
507
|
endDevSession(projectId: $projectId, cwd: $cwd) {
|
|
507
508
|
id
|
|
508
509
|
}
|
|
509
510
|
}
|
|
510
|
-
`);async function
|
|
511
|
-
`),process.exit(1));let n=await
|
|
512
|
-
`);let d=async()=>{c(),a(),l(),await Promise.race([S({config:e,document:
|
|
513
|
-
`),
|
|
514
|
-
`),process.exit(1)}}var
|
|
511
|
+
`);async function Ds(){let e=qy(process.cwd()),t=e.cwd,r=await j(t);r.ok||(process.stderr.write(`ripplo: DSL compilation failed: ${r.error}
|
|
512
|
+
`),process.exit(1));let n=await Gy(()=>lt({compiled:r.result,config:e,cwd:t})),o=qt(t);o!=null&&g.info("watching branch %s in %s",o,t);let i=is(t),s=Dy({headers:{Authorization:`Bearer ${e.token}`},retryAttempts:1/0,url:`${e.ripploServerUrl}/graphql`}),a=My({config:e,cwd:t,devSessionId:n.devSessionId,sseClient:s}),l=Hy({cwd:t,projectId:e.projectId,sseClient:s}),c=Wy({config:e,devSessionId:n.devSessionId});process.stdout.write(`ripplo watch: ready as local executor for session ${n.devSessionId} (sync happens on each \`ripplo run\`; Ctrl-C to stop)
|
|
513
|
+
`);let d=async()=>{c(),a(),l(),await Promise.race([S({config:e,document:Fy,variables:{cwd:e.cwd,projectId:e.projectId}}).catch(()=>{}),new Promise(f=>setTimeout(f,3e3))]),i()},u=()=>{d().finally(()=>process.exit(0))};process.on("SIGINT",u),process.on("SIGTERM",u),process.on("SIGHUP",u),process.on("SIGBREAK",u),await new Promise(()=>{})}function My({config:e,cwd:t,devSessionId:r,sseClient:n}){return n.subscribe({query:Os(_y),variables:{devSessionId:r}},{complete:()=>{},error:o=>{g.error(o,"runRequested subscription error")},next:o=>{let i=o.data?.runRequested;i!=null&&(process.stdout.write(`ripplo: run ${i.runId} (${i.workflowSlug})
|
|
514
|
+
`),Ns({agentProfileDescription:i.agentProfileDescription??void 0,agentProfileId:i.agentProfileId??void 0,config:e,cwd:t,runId:i.runId,workflowId:i.workflowId,workflowSlug:i.workflowSlug}))}})}function Hy({cwd:e,projectId:t,sseClient:r}){return r.subscribe({query:Os(Uy),variables:{projectId:t}},{complete:()=>{},error:n=>{g.error(n,"hooksPaused subscription error")},next:n=>{let o=n.data?.hooksPausedRequested?.paused;if(o===!0){Sn.writeFileSync(pe(e),"");return}o===!1&&Sn.existsSync(pe(e))&&Sn.unlinkSync(pe(e))}})}function Wy({config:e,devSessionId:t}){let r=setInterval(()=>{S({config:e,document:Vy,variables:{id:t}}).catch(n=>{g.warn("heartbeat failed: %s",n instanceof Error?n.message:String(n))})},Ly);return()=>{clearInterval(r)}}function qy(e){try{return W(e)}catch(t){let r=t instanceof Error?t.message:String(t);process.stderr.write(`${r}
|
|
515
|
+
`),process.exit(1)}}var By=1e3,zy=6e4;async function Gy(e){let t=Date.now()+zy,r;for(;Date.now()<t;){let n=await Ky(e);if(n.ok)return n.value;if(!Jy(n.message))throw n.error;r=n.error,await Yy(By)}throw r instanceof Error?r:new Error("server never became ready")}async function Ky(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 Jy(e){return e.includes("status 502")||e.includes("ECONNREFUSED")||e.includes("Failed to connect")||e.includes("fetch failed")}function Yy(e){return new Promise(t=>setTimeout(t,e))}import{graphql as ut}from"gql.tada";var Xy=ut(`
|
|
515
516
|
query ScopeStatus($projectId: String!, $cwd: String!) {
|
|
516
517
|
project(id: $projectId) {
|
|
517
518
|
id
|
|
@@ -531,7 +532,7 @@ ${String(u)} error(s)
|
|
|
531
532
|
}
|
|
532
533
|
}
|
|
533
534
|
}
|
|
534
|
-
`),
|
|
535
|
+
`),Qy=ut(`
|
|
535
536
|
query ScopeWorkflowBySlug($projectId: String!, $cwd: String!, $slug: String!) {
|
|
536
537
|
project(id: $projectId) {
|
|
537
538
|
id
|
|
@@ -544,7 +545,7 @@ ${String(u)} error(s)
|
|
|
544
545
|
}
|
|
545
546
|
}
|
|
546
547
|
}
|
|
547
|
-
`),
|
|
548
|
+
`),Zy=ut(`
|
|
548
549
|
mutation ScopeAddAgent($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
549
550
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
550
551
|
id
|
|
@@ -554,42 +555,43 @@ ${String(u)} error(s)
|
|
|
554
555
|
}
|
|
555
556
|
}
|
|
556
557
|
}
|
|
557
|
-
`),
|
|
558
|
+
`),eh=ut(`
|
|
558
559
|
mutation ScopeLink($id: ID!, $workflowId: String!) {
|
|
559
560
|
linkScopeItem(id: $id, workflowId: $workflowId) {
|
|
560
561
|
id
|
|
561
562
|
}
|
|
562
563
|
}
|
|
563
|
-
`),
|
|
564
|
+
`),th=ut(`
|
|
564
565
|
mutation ScopeRemoveMany($ids: [ID!]!) {
|
|
565
566
|
removeScopeItems(ids: $ids)
|
|
566
567
|
}
|
|
567
|
-
`);async function
|
|
568
|
+
`);async function Ls(e){let t=ye();await he(t);let n=(await S({config:t,document:Xy,variables:{cwd:t.cwd,projectId:t.projectId}})).project?.devSession?.scopeItems??[];if(e.format==="json"){process.stdout.write(`${JSON.stringify(n,null,2)}
|
|
568
569
|
`);return}if(n.length===0){process.stdout.write("No scope items. Add via `ripplo scope add <test-ids..>` (variadic) or from the dashboard.\n");return}n.forEach(o=>{let i=o.workflow;if(i==null){process.stdout.write(` [intent] (${o.id}) ${o.label??""}
|
|
569
570
|
`);return}let s=i.spec==null?"stub":"implemented";process.stdout.write(` [${s}] (${o.id}) ${i.slug} \u2014 ${i.name}
|
|
570
|
-
`)})}async function
|
|
571
|
+
`)})}async function _s({testIds:e}){let t=ye();await he(t),await $e(t.cwd,t);let n=(await S({config:t,document:Zy,variables:{cwd:t.cwd,projectId:t.projectId,workflowSlugs:[...e]}})).addAgentScopeItems??[];if(n.length===0){process.stdout.write(`No scope items added.
|
|
571
572
|
`);return}let o=n.map(i=>i.workflow?.slug??"?").join(", ");process.stdout.write(`Added ${String(n.length)} scope item(s): ${o}
|
|
572
|
-
`)}async function
|
|
573
|
-
`)}async function
|
|
574
|
-
`)}async function
|
|
573
|
+
`)}async function Us({id:e,testId:t}){let r=ye();await he(r),await $e(r.cwd,r);let n=await rh({cfg:r,slug:t});await S({config:r,document:eh,variables:{id:e,workflowId:n}}),process.stdout.write(`Linked scope item ${e} to ${t}
|
|
574
|
+
`)}async function Vs({ids:e}){let t=ye();await he(t);let n=(await S({config:t,document:th,variables:{ids:[...e]}})).removeScopeItems??0;process.stdout.write(`Removed ${String(n)} scope item(s)
|
|
575
|
+
`)}async function rh({cfg:e,slug:t}){let n=(await S({config:e,document:Qy,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.
|
|
575
576
|
`),process.stderr.write(`${x("create")}
|
|
576
|
-
`),process.exit(1)),n.id}async function
|
|
577
|
+
`),process.exit(1)),n.id}async function Fs(e){let t=process.cwd(),r=await j(t);r.ok||(process.stderr.write(`Compilation failed: ${r.error}
|
|
577
578
|
`),process.exit(1));let{tests:n}=r.builder.getUnimplemented();if(e.format==="summary"){n.length>0&&process.stdout.write(`tests: ${n.join(", ")}
|
|
578
579
|
`);return}let o={tests:n.map(i=>({id:i,implemented:!1}))};process.stdout.write(`${JSON.stringify(o,null,2)}
|
|
579
|
-
`)}import{z as
|
|
580
|
-
`).filter(t=>t.length>0)}function
|
|
581
|
-
`).filter(r=>r.length>0)}import{createHash as
|
|
582
|
-
`).filter(n=>n.length>0).filter(n=>
|
|
583
|
-
`),hookEventName:"UserPromptSubmit"}}});import
|
|
580
|
+
`)}import{z as nh}from"zod";function N(e,t){let r=nh.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 l$}from"crypto";import Ms from"picomatch";function oh(e){return X(["diff","--name-only","HEAD"],e).split(`
|
|
581
|
+
`).filter(t=>t.length>0)}function Hs({cwd:e,ignoreGlobs:t,watchGlobs:r}){let n=Ms([...r]),o=Ms([...t]);return oh(e).filter(i=>n(i)&&!o(i))}function Jt(e,...t){return X(["diff","--name-only","HEAD","--",...t],e).split(`
|
|
582
|
+
`).filter(r=>r.length>0)}import{createHash as ih}from"crypto";import{mkdirSync as sh,readFileSync as Ws,writeFileSync as ah}from"fs";import vn from"path";var lh=[".ts",".tsx",".js",".jsx"];function Be(e){let t=ih("sha256");return t.update(X(["rev-parse","HEAD"],e)),t.update("\0"),t.update(X(["diff","HEAD"],e)),t.update("\0"),X(["ls-files","--others","--exclude-standard"],e).split(`
|
|
583
|
+
`).filter(n=>n.length>0).filter(n=>lh.some(o=>n.endsWith(o))).toSorted((n,o)=>n.localeCompare(o)).forEach(n=>{t.update(n),t.update("\0"),t.update(ch(vn.join(e,n))),t.update("\0")}),t.digest("hex")}function ze(e,t){try{return Ws(qs(e,t),"utf8").trim()}catch{return null}}function Ge(e,t,r){let n=qs(e,t);sh(vn.dirname(n),{recursive:!0}),ah(n,r)}function qs(e,t){return vn.join(e,".ripplo",".local",`${t}.hash`)}function ch(e){try{return Ws(e)}catch{return Buffer.alloc(0)}}function Pe(){return{ignorePaths:xe,watchPaths:ln}}var Bs=N("UserPromptSubmit",e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=Be(t);if(ze(t,"coverage-nudge")===r)return;let{ignorePaths:n,watchPaths:o}=Pe(),i=Hs({cwd:t,ignoreGlobs:n,watchGlobs:o});if(Ge(t,"coverage-nudge",r),!(i.length===0||Jt(t,".ripplo/tests",".ripplo/preconditions",".ripplo/observers").length>0))return{hookSpecificOutput:{additionalContext:`SCOPE DRIFT: ${String(i.length)} app file(s) changed without .ripplo/tests updates. ${x("scope")}`,hookEventName:"UserPromptSubmit"}}});import Yt from"fs";import dh from"os";import zs from"path";var Gs=N("PreToolUse",e=>{if(e.tool_name!=="ExitPlanMode"||!M(e.cwd))return;let t=uh();if(t==null)return;let r=Yt.readFileSync(t,"utf8");if(!/\.ripplo\/tests|Tests to implement|No e2e coverage needed/.test(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`Plan must cite ripplo test stubs. Add a "Tests to implement" section listing .ripplo/tests/<id>.ts per affected flow, OR add "No e2e coverage needed: <reason>" if this plan touches no user-facing behavior. ${x("explore")}`}}});function uh(){let e=zs.join(dh.homedir(),".claude","plans");return Yt.existsSync(e)?Yt.readdirSync(e).filter(r=>r.endsWith(".md")).map(r=>zs.join(e,r)).map(r=>({full:r,mtime:Yt.statSync(r).mtimeMs})).sort((r,n)=>n.mtime-r.mtime)[0]?.full??null:null}var Ks=N("UserPromptSubmit",async e=>{if(e.permission_mode!=="plan"||!I(e.cwd)||!M(e.cwd))return;let t=await j(e.cwd);if(!t.ok)return;let{tests:r}=t.builder.getUnimplemented(),n=['Plan must include "Tests to implement" with .ripplo/tests/<id>.ts per affected flow (ExitPlanMode blocks otherwise).'];return r.length>0&&n.push(`Existing stubs: ${r.join(", ")}`),{hookSpecificOutput:{additionalContext:n.join(`
|
|
584
|
+
`),hookEventName:"UserPromptSubmit"}}});import ph from"path";import Js from"picomatch";import{z as Ys}from"zod";var mh=Ys.looseObject({file_path:Ys.string()}),Xs=N("PostToolUse",async e=>{let t=mh.safeParse(e.tool_input);if(!t.success)return;let r=t.data.file_path,{cwd:n}=e;if(!I(n)||!M(n))return;let o=ph.relative(n,r);if(o.startsWith(".."))return;let{ignorePaths:i,watchPaths:s}=Pe(),a=Js([...s]),l=Js([...i]);if(!a(o)||l(o))return;let c=await j(n);if(!c.ok)return;let{tests:d}=c.builder.getUnimplemented();if(d.length!==0)return{hookSpecificOutput:{additionalContext:`Reminder: .notImplemented() stubs still present \u2014 tests: ${d.join(", ")}`,hookEventName:"PostToolUse"}}});import fh from"path";import{graphql as gh}from"gql.tada";import{z as Qs}from"zod";var yh=Qs.looseObject({file_path:Qs.string()}),hh=gh(`
|
|
584
585
|
mutation AutoScopeAdd($projectId: String!, $cwd: String!, $workflowSlugs: [String!]!) {
|
|
585
586
|
addAgentScopeItems(projectId: $projectId, cwd: $cwd, workflowSlugs: $workflowSlugs) {
|
|
586
587
|
id
|
|
587
588
|
}
|
|
588
589
|
}
|
|
589
|
-
`),
|
|
590
|
-
${x("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),
|
|
590
|
+
`),Zs=N("PostToolUse",async e=>{let t=yh.safeParse(e.tool_input);if(!t.success)return;let r=t.data.file_path;if(!/\/\.ripplo\/.*\.ts$/.test(r))return;let{cwd:n}=e;if(!I(n)||!M(n))return;let o=await j(n);if(!o.ok)return{decision:"block",reason:`Compilation failed: ${o.error}
|
|
591
|
+
${x("create","DSL authoring + lint rules")}`};await de({cwd:n,result:o.result}),Fe({cwd:n});let{diagnostics:i}=Ue(o.result);return i.length===0?wh({compileResult:o,cwd:n}):{decision:"block",reason:`${i.map(a=>{let l=a.step==null?"":` at "${a.step}"`;return` [${a.rule}]${l} ${a.test}: ${a.message}`}).join(`
|
|
591
592
|
`)}
|
|
592
|
-
${x("create")}`}});async function
|
|
593
|
+
${x("create")}`}});async function wh({compileResult:e,cwd:t}){let r=bh(t);if(r.length===0)return;let n=new Set(e.result.tests.map(c=>c.slug)),o=r.filter(c=>n.has(c));if(o.length===0)return;let i;try{i=W(t)}catch{return}if(await lt({compiled:e.result,config:i,cwd:t}).catch(c=>(g.warn("auto-sync failed: %s",c instanceof Error?c.message:String(c)),null))==null)return;let a=await S({config:i,document:hh,variables:{cwd:i.cwd,projectId:i.projectId,workflowSlugs:o}}).catch(c=>(g.warn("auto-scope failed: %s",c instanceof Error?c.message:String(c)),null));if(!(a==null||(a.addAgentScopeItems??[]).length===0))return{hookSpecificOutput:{additionalContext:`Auto-scoped ${o.join(", ")} (dirty tests).`,hookEventName:"PostToolUse"}}}function bh(e){let t;try{t=X(["status","--porcelain","--",".ripplo/tests"],e)}catch{return[]}return t.split(`
|
|
594
|
+
`).map(r=>r.slice(3).trim()).filter(r=>/^\.ripplo\/tests\/[^/]+\.ts$/.test(r)).map(r=>fh.basename(r,".ts")).filter(r=>r!=="index")}import{z as ea}from"zod";var Sh=ea.looseObject({command:ea.string()}),vh=/\bripplo\s+hooks\s+pause\b/,ta=N("PreToolUse",e=>{if(e.tool_name!=="Bash")return;let t=Sh.safeParse(e.tool_input);if(!t.success||!vh.test(t.data.command))return;let{cwd:r}=e;if(I(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:"`ripplo hooks pause` is a human-only escape hatch \u2014 agents can't bypass Ripplo guardrails on their own. If watch genuinely can't start (auth, server down, intentional offline work), surface the blocker to the user and ask them to run `npx ripplo hooks pause` themselves from their terminal."}}});import{parse as Ch}from"shell-quote";import{z as oa}from"zod";import{existsSync as kh,mkdirSync as Rh,rmSync as gA,writeFileSync as xh}from"fs";import kn from"path";function ra(e,t,r){let n=na(e,t,r);Rh(kn.dirname(n),{recursive:!0}),xh(n,"")}function Xt(e,t,r){return kh(na(e,t,r))}function Ph(e,t){return kn.join(e,".ripplo",".local","skills-loaded",t)}function na(e,t,r){return kn.join(Ph(e,t),r)}var Eh=oa.looseObject({command:oa.string()}),Th="debug",$h=new Set(["tail","head","less","more","wc","sort","uniq","awk","sed","grep"]),sa=N("PreToolUse",e=>{if(e.tool_name!=="Bash")return;let t=Eh.safeParse(e.tool_input);if(!t.success)return;let r=Ah(t.data.command);if(!Ih(r))return;let{cwd:n}=e;if(!I(n)||!M(n))return;let o=Nh(r);if(o!=null)return ia(`Don't pipe \`ripplo run\` through \`${o}\` \u2014 buffering filters hold all stdout until EOF, hiding live progress; if you kill the pipeline mid-run the run is orphaned on the server. Redirect to a file instead: \`ripplo run <id> > /tmp/run.log 2>&1\` and Read the file, or use \`run_in_background: true\`.`);if(!Xt(n,e.session_id,Th))return ia("Running `ripplo run` requires the `/ripplo:debug` skill loaded first. Load `/ripplo:debug` then retry \u2014 it carries the artifact-read order, the 3-strike rule, and the no-grep-piping guidance for run failures.")});function Ah(e){try{return Ch(e)}catch{return[]}}function Ih(e){return e.some((t,r)=>t==="ripplo"&&e[r+1]==="run")}function jh(e){return typeof e=="object"&&"op"in e&&e.op==="|"}function Nh(e){let t=e.find((r,n)=>{let o=e[n-1];return o!=null&&jh(o)&&typeof r=="string"&&$h.has(r)});return typeof t=="string"?t:null}function ia(e){return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:e}}}import Oh from"path";import{z as aa}from"zod";var Dh=new Set(["Edit","Write","NotebookEdit"]),Lh=aa.looseObject({file_path:aa.string()}),_h="create",la=N("PreToolUse",e=>{if(!Dh.has(e.tool_name))return;let t=Lh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r)||!M(r))return;let n=Oh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n!==".ripplo"&&!n.startsWith(".ripplo/"))&&!Xt(r,e.session_id,_h))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 Uh from"path";import ca from"picomatch";import{graphql as Vh}from"gql.tada";import{z as da}from"zod";var Fh=new Set(["Edit","Write","NotebookEdit"]),Mh=da.looseObject({file_path:da.string()}),Hh=Vh(`
|
|
593
595
|
query PreEditScopeGate($projectId: String!, $cwd: String!) {
|
|
594
596
|
project(id: $projectId) {
|
|
595
597
|
id
|
|
@@ -601,7 +603,7 @@ ${x("create")}`}});async function ph({compileResult:e,cwd:t,file:r}){let n=mh(r)
|
|
|
601
603
|
}
|
|
602
604
|
}
|
|
603
605
|
}
|
|
604
|
-
`),
|
|
606
|
+
`),ua=N("PreToolUse",async e=>{if(!Fh.has(e.tool_name))return;let t=Mh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r)||!M(r))return;let n=Uh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n===".ripplo"||n.startsWith(".ripplo/")||!Wh(n)||await qh(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). ${Ji(["scope","create"])}`}}});function Wh(e){let{ignorePaths:t,watchPaths:r}=Pe(),n=ca([...r]),o=ca([...t]);return n(e)&&!o(e)}async function qh(e){let t;try{t=W(e)}catch{return!0}let r=await S({config:t,document:Hh,variables:{cwd:t.cwd,projectId:t.projectId}}).catch(()=>null);return r==null?!0:(r.project?.devSession?.scopeItems??[]).length>0}import Bh from"fs";import zh from"path";import{z as pa}from"zod";var Gh=new Set(["Edit","Write","NotebookEdit"]),Kh=pa.looseObject({file_path:pa.string()}),ma=N("PreToolUse",e=>{if(!Gh.has(e.tool_name))return;let t=Kh.safeParse(e.tool_input);if(!t.success)return;let{cwd:r}=e;if(!I(r))return;let n=zh.relative(r,t.data.file_path);if(!(n.startsWith("..")||n!==".ripplo"&&!n.startsWith(".ripplo/"))&&!Bh.existsSync(pe(r))&&!He(r))return{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`\`ripplo watch\` is not running, so this edit to \`${n}\` won't sync to the server and dev-mode guardrails won't fire. Run \`/ripplo:start\` (or spawn \`npx ripplo watch\` directly via Bash with run_in_background), then retry. The app's dev server also needs to be running \u2014 \`npx ripplo doctor\` reports both. If watch can't start (auth, server down, intentional offline work), the user can run \`npx ripplo hooks pause\` to bypass this gate; \`npx ripplo hooks resume\` re-enables it. ${x("start")}`}}});import{graphql as Jh}from"gql.tada";var Yh=Jh(`
|
|
605
607
|
query ScopeReminder($projectId: String!, $cwd: String!) {
|
|
606
608
|
project(id: $projectId) {
|
|
607
609
|
id
|
|
@@ -618,9 +620,9 @@ ${x("create")}`}});async function ph({compileResult:e,cwd:t,file:r}){let n=mh(r)
|
|
|
618
620
|
}
|
|
619
621
|
}
|
|
620
622
|
}
|
|
621
|
-
`),
|
|
623
|
+
`),fa=N("UserPromptSubmit",async e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=Be(t);if(ze(t,"scope-reminder")===r)return;let n;try{n=W(t)}catch{return}let o=await S({config:n,document:Yh,variables:{cwd:n.cwd,projectId:n.projectId}}).catch(()=>null);if(o==null)return;Ge(t,"scope-reminder",r);let i=o.project?.devSession?.scopeItems??[];return{hookSpecificOutput:{additionalContext:i.length===0?`RIPPLO SCOPE: empty. ${x("scope")}`:`RIPPLO SCOPE (${String(i.length)}):
|
|
622
624
|
${i.map(a=>{let l=a.workflow;return l==null?` [intent] (${a.id}) ${a.label??""}`:` [${l.spec==null?"stub":"implemented"}] (${a.id}) ${l.slug}`}).join(`
|
|
623
|
-
`)}`,hookEventName:"UserPromptSubmit"}}});var
|
|
625
|
+
`)}`,hookEventName:"UserPromptSubmit"}}});var Xh="# Ripplo \u2014 always-on session context\n\nEvery user-facing change in this repo ships with a deterministic, backend-aware test that proves it works end-to-end.\n\n## Load the right skill before acting \u2014 this is critical\n\nThe skills below carry the procedural detail you need to do Ripplo work correctly: precondition isolation, observer budget tiers, coverage IDs, scope discipline, artifact-read order on failures, parallelization patterns. **None of that is reproduced in this preamble** \u2014 only the always-on guardrails are. If you act on a Ripplo task without loading the matching skill, you will skip rules that exist to prevent specific past failure modes (cross-run data leakage, \"passing\" tests that never asserted backend state, cleared coverage gates without proof, etc.).\n\nMatch the task to a skill from the triage table; if unsure between two, load both. If completely unsure, load `/ripplo:explore` or `/ripplo:create`. Loading is cheap; acting under-informed is not.\n\n## Skill triage\n\n- Load `/ripplo:setup` skill for instructions on initializing Ripplo in a project; `ripplo doctor` reports the engine endpoint missing.\n- Load `/ripplo:explore` skill for instructions on planning/stubbing test coverage for a new project or new feature area.\n- Load `/ripplo:scope` skill for instructions on managing the working set of tests this session is responsible for.\n- Load `/ripplo:create` skill for instructions on authoring a single test spec for a user flow.\n- Load `/ripplo:run` skill for instructions on executing existing tests.\n- Load `/ripplo:debug` skill for instructions on a failed run; read artifacts in `.ripplo/debug/<runId>/` before re-running.\n- Load `/ripplo:flake-detect` skill for instructions on intermittent failures; parallelizes N runs (only use with evidence of flake).\n\n## Universal rules\n\n- **Two background processes must be running before feature work.** (1) The app's dev server, so the app is reachable; (2) `npx ripplo watch` (run `/ripplo:start` to spawn it, or invoke it directly via Bash with `run_in_background`), so the dev session is live. Without watch, scope/coverage hooks don't arm and `ripplo run` refuses to dispatch. Without the dev server, runs fail when they try to hit the app. `npx ripplo doctor` reports both.\n- **Two funnels.** Definitions \u2192 `createRipplo({ preconditions, observers, tests })` in `.ripplo/index.ts`. Implementations \u2192 `createEngine(ripplo, { preconditions, observers })` in your app server's `test/engine.ts`. Never call either elsewhere. TS enforces exhaustiveness across both.\n- **\"Done\" = app code delivers the behavior AND a passing test proves it.** Both halves. Shipping without a test isn't done; writing a test against broken UI/API isn't done.\n- **Scope is your job.** For any non-trivial change, enumerate every flow it could affect and either `scope add` existing tests or stub `.notImplemented()` tests. Don't wait to be told.\n- **`scope remove` is never for size/effort.** Valid only when an item is genuinely out of scope (wrong flow, duplicate, user said \"not this session,\" feature cut). \"Too many stubs\" \u2192 parallelize with subagents. Don't present \"implement vs. remove\" as a neutral A/B.\n- **Stub gates are not a question.** When `stop-enforce` blocks on `.notImplemented()` stubs, implement them \u2014 don't ask the user \"implement or defer?\", don't propose pausing hooks as option B. The fix isn't done until the test is. New scaffolding (precondition, observer, engine impl) is in-scope work, not follow-up.\n- **`uiOnly: true` is not a stub.** Observer wiring is in-scope for mutation flows; don't use it to silence observer lint.\n- **Never weaken a test to make it pass.** No `contains`/regex for exact text, no removed assertions, no fabricated locators. App lacks an accessible name \u2192 add one to the app, don't fall back to `testId()`. App bug \u2192 report with evidence.\n- **Artifacts first, re-run last.** Failed runs produce DOM, a11y tree, console, network, screenshots under `.ripplo/debug/<runId>/`. Read them. Never pipe `ripplo run` through `grep`/`tail`/`head`. Form a hypothesis citing an artifact line, make ONE change, re-run once.\n- **3-strike rule.** Same failure after 3 targeted fixes \u2192 stop and report. Repeated failure on the same step almost always means the diagnosis is wrong.\n- **`.ripplo/ripplo.lock` is committed, never hand-edited.** `ripplo lint` / `ripplo compile` regenerates it. Pre-commit runs `ripplo compile --check`.\n- **Scratch files live in `.ripplo/.local/`.** Never loose in `.ripplo/`.\n- **Worktrees are self-contained.** Each worktree has its own `.ripplo/` checkout, DevSession, scope, and debug artifacts. Auth and projectId are shared globally. Env files (typically gitignored) won't carry over to a fresh worktree \u2014 copy from main or point at a shared file. **If sibling worktrees run dev servers on different ports, the worktree's env file MUST update both `RIPPLO_APP_URL` and `RIPPLO_ENGINE_URL` to match the port that worktree's dev server is bound to** (e.g. main on `:3000`, this worktree on `:3001` \u2192 set `RIPPLO_APP_URL=http://localhost:3001` and `RIPPLO_ENGINE_URL=http://localhost:3001/ripplo` in the worktree's env file). Mismatched ports = `npx ripplo watch` (whether started via `/ripplo:start` or manually) talks to the wrong server, runs silently fail or hit the sibling worktree's app.\n- **DSL locators are semantic.** No `css` / `placeholder` / `waitFor` / `group`.\n- **New backend assertion?** Declare in `.ripplo/observers/index.ts`, implement in your app server's `engine.ts` (TS flags the missing impl).\n\n## Key files\n\n- `.ripplo/index.ts` \u2014 `createRipplo` call.\n- `.ripplo/{preconditions,observers,tests}/index.ts` \u2014 registry aggregators.\n- `.ripplo/project.json` \u2014 project id + env-file pointers.\n- `<app>/src/test/engine.ts` \u2014 single impl funnel via `createEngine`.\n- `packages/testing/README.md` (or the npm page for `@ripplo/testing`) \u2014 DSL reference.\n",ga=N("SessionStart",e=>{if(I(e.cwd))return{hookSpecificOutput:{additionalContext:Xh,hookEventName:"SessionStart"}}});import{execFileSync as Qh}from"child_process";import Zh from"path";import ya from"process";import{graphql as ew}from"gql.tada";import{z as Qt}from"zod";var tw=ew(`
|
|
624
626
|
query ScopeEnforce($projectId: String!, $cwd: String!) {
|
|
625
627
|
project(id: $projectId) {
|
|
626
628
|
id
|
|
@@ -639,14 +641,14 @@ ${i.map(a=>{let l=a.workflow;return l==null?` [intent] (${a.id}) ${a.label??""}
|
|
|
639
641
|
}
|
|
640
642
|
}
|
|
641
643
|
}
|
|
642
|
-
`),
|
|
644
|
+
`),wa=N("Stop",async e=>{let{cwd:t}=e;if(!I(t)||!M(t))return;let r=Be(t),n=ze(t,"stop-enforce")===r;if(n&&!e.stop_hook_active)return;let o=rw(t),i=await nw(t,o);if(Ge(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:
|
|
643
645
|
${i.join(`
|
|
644
646
|
|
|
645
647
|
`)}`}:{decision:"block",reason:i.join(`
|
|
646
648
|
|
|
647
|
-
`)}});function
|
|
649
|
+
`)}});function rw(e){return Jt(e,".ripplo/tests").filter(t=>t.endsWith(".ts")).map(t=>Zh.basename(t,".ts")).filter(t=>t!=="index")}async function nw(e,t){let r=await j(e);if(!r.ok)return[`--- Compilation failed ---
|
|
648
650
|
${r.error}
|
|
649
|
-
${x("create")}`];await de({cwd:e,result:r.result}),
|
|
651
|
+
${x("create")}`];await de({cwd:e,result:r.result}),Fe({cwd:e});let n=await iw(e),o=[...new Set([...t,...n.scopedSlugsToRun])],i=sw(r,t),s=aw(r),a=ow(e,r),l=lw(e,o);return[i,s,a,l,n.error].filter(c=>c!=null)}function ow(e,t){let{ignorePaths:r}=Pe(),n=Xi({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(`
|
|
650
652
|
`);s.push(`Unacknowledged interactions (add to a test's .coverage(...)):
|
|
651
653
|
${a}`)}if(i.length>0){let a=i.map(l=>` ${l.id}`).join(`
|
|
652
654
|
`);s.push(`Stale .coverage(...) claims (id no longer exists in source):
|
|
@@ -654,23 +656,23 @@ ${a}`)}return`--- Exhaustiveness ---
|
|
|
654
656
|
${s.join(`
|
|
655
657
|
|
|
656
658
|
`)}
|
|
657
|
-
${x("create")}`}async function
|
|
659
|
+
${x("create")}`}async function iw(e){let t;try{t=W(e)}catch{return{error:null,scopedSlugsToRun:[]}}let n=(await S({config:t,document:tw,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 ---
|
|
658
660
|
${o.join(`
|
|
659
661
|
`)}
|
|
660
|
-
${x("create")}`,scopedSlugsToRun:i}}function
|
|
662
|
+
${x("create")}`,scopedSlugsToRun:i}}function sw(e,t){let{diagnostics:r}=Ue(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 ---
|
|
661
663
|
${[...i,...s].join(`
|
|
662
664
|
`)}
|
|
663
|
-
${x("create")}`}function
|
|
665
|
+
${x("create")}`}function aw(e){let{tests:t}=e.builder.getUnimplemented();return t.length===0?null:`--- Unimplemented stubs ---
|
|
664
666
|
${t.join(", ")}
|
|
665
667
|
Implement the stub now. Do not ask the user "implement or defer?" \u2014 that framing is forbidden by /ripplo:create. New scaffolding (precondition, observer, engine impl) is in-scope, not follow-up.
|
|
666
|
-
${x("create")}`}function
|
|
668
|
+
${x("create")}`}function lw(e,t){if(t.length===0)return null;let r=dw(["run",...t],e);if(r.code===0)return null;let n=r.output.split(`
|
|
667
669
|
`).filter(o=>/FAILED/.test(o)).join(`
|
|
668
670
|
`);return n.length===0?null:`--- Ripplo Run Failures (${t.join(" ")}) ---
|
|
669
671
|
${n}
|
|
670
|
-
Artifacts: .ripplo/debug/<runId>/. ${x("debug")}`}var
|
|
671
|
-
`),process.exit(1));let r=await
|
|
672
|
-
`),process.exit(1)});function
|
|
673
|
-
`))}export{
|
|
672
|
+
Artifacts: .ripplo/debug/<runId>/. ${x("debug")}`}var cw=Qt.object({status:Qt.number().nullish(),stderr:Qt.unknown().optional(),stdout:Qt.unknown().optional()});function ha(e){return e instanceof Buffer?e.toString("utf8"):typeof e=="string"?e:""}function dw(e,t){let r=ya.argv[1];if(r==null)return{code:1,output:""};try{return{code:0,output:Qh(ya.execPath,[r,...e],{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}}catch(n){let o=cw.safeParse(n);if(!o.success)return{code:1,output:""};let i=`${ha(o.data.stdout)}${ha(o.data.stderr)}`;return{code:o.data.status??1,output:i}}}import{z as ba}from"zod";var uw=ba.looseObject({skill:ba.string()}),Sa=N("PostToolUse",e=>{if(e.tool_name!=="Skill")return;let t=uw.safeParse(e.tool_input);if(!t.success)return;let r=/^ripplo:(.+)$/.exec(t.data.skill);if(r==null)return;let n=r[1];n!=null&&I(e.cwd)&&ra(e.cwd,e.session_id,n)});vw();En(process.cwd());var va={"coverage-nudge":Bs,"exit-plan-gate":Gs,"plan-reminder":Ks,"post-edit-flag-stubs":Xs,"post-edit-lint":Zs,"pre-bash-hooks-pause-gate":ta,"pre-bash-run-gate":sa,"pre-edit-ripplo-skill-gate":la,"pre-edit-scope-gate":ua,"pre-edit-watch-gate":ma,"scope-reminder":fa,"session-preamble":ga,"stop-enforce":wa,"track-skill-load":Sa};async function fw(){await pw(mw(process.argv)).scriptName("ripplo").command("watch","Watch for run requests and execute locally",()=>{},()=>Ds()).command("auth <subcommand>","Manage authentication",Sw).command("projects <subcommand>","Inspect Ripplo projects",bw).command("hooks <subcommand>","Pause or resume Ripplo hooks",ww).command("init","Scaffold .ripplo/ in this project",e=>e.option("project",{type:"string"}).option("env",{type:"string"}).option("app-url",{type:"string"}).option("engine-url",{type:"string"}),e=>Cs({appUrl:e["app-url"],engineUrl:e["engine-url"],envFile:e.env,projectId:e.project})).command("run [ids..]","Run tests in parallel",e=>{let t=[];return e.positional("ids",{array:!0,default:t,describe:"Test ids to run (all if omitted)",type:"string"})},e=>Is(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=>$s({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=>ws({id:e.id,runs:e.runs})).command("sync","Push the compiled .ripplo/ resources to the server (no run)",()=>{},()=>js()).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=>Yi({check:e.check})).command("cover","Audit all coverage statements",()=>{},()=>ts()).command("doctor","Check project health",()=>{},()=>fs()).command("status","Report unimplemented tests and preconditions",e=>e.option("format",{choices:["json","summary"],default:"json",describe:"Output format"}),e=>Fs({format:e.format})).command("scope <subcommand>","Manage testing scope",hw).command("hook <name>","Internal: run a Claude Code plugin hook",e=>e.positional("name",{choices:Object.keys(va),demandOption:!0,type:"string"}),e=>gw(e.name)).strict().help().parse()}async function gw(e){let t=va[e];t==null&&(process.stderr.write(`Unknown hook: ${e}
|
|
673
|
+
`),process.exit(1));let r=await yw(),n=r.trim()===""?{}:JSON.parse(r),o=await t.run(n);o!=null&&process.stdout.write(JSON.stringify(o))}function yw(){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)})}fw().catch(e=>{process.stderr.write(`${e instanceof Error?e.message:String(e)}
|
|
674
|
+
`),process.exit(1)});function hw(e){return e.command("status","Print the current scope",t=>t.option("format",{choices:["json","text"],default:"text",describe:"Output format"}),t=>Ls({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=>_s({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=>Us({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=>Vs({ids:t.ids})).demandCommand(1)}function ww(e){return e.command("pause","Disable all Ripplo pre-edit gates and stop enforcement until resumed",()=>{},()=>bs()).command("resume","Re-enable Ripplo hooks paused via `ripplo hooks pause`",()=>{},()=>Ss()).demandCommand(1)}function bw(e){return e.command("list","List projects you have access to (JSON)",()=>{},()=>As()).demandCommand(1)}function Sw(e){return e.command("login","Authenticate via device flow",()=>{},()=>Ri()).command("status","Show authentication status",()=>{},()=>xi()).command("logout","Remove the saved token",()=>{},()=>{Pi()}).demandCommand(1)}function vw(){let e=process.cwd(),t=Zt(e);t!=null&&t!==e&&(process.chdir(t),process.stderr.write(`ripplo: resolved .ripplo/ at ${t}
|
|
675
|
+
`))}export{fw as main};
|
|
674
676
|
/*! Bundled license information:
|
|
675
677
|
|
|
676
678
|
mustache/mustache.mjs:
|