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