ripplo 0.15.2 → 0.17.0
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/README.md +26 -138
- package/dist/chunk-HA3VCAP6.js +3 -0
- package/dist/graphql-Z4UDRCDF.js +185 -0
- package/dist/index.js +345 -625
- package/package.json +10 -45
- package/dist/assets/browser-trace.js +0 -1
- package/dist/assets/rrweb.js +0 -54
- package/dist/capture-worker.js +0 -13892
- package/dist/chunk-3BPQWAUL.js +0 -4
- package/dist/chunk-47LLHHJH.js +0 -9
- package/dist/chunk-5HFJIZLI.js +0 -4
- package/dist/chunk-5RKZ44OU.js +0 -4
- package/dist/chunk-7WZ3VIUU.js +0 -4
- package/dist/chunk-AXROBTLA.js +0 -4
- package/dist/chunk-BFAWQ5U2.js +0 -61
- package/dist/chunk-BGY5F3IU.js +0 -5
- package/dist/chunk-BIB4JJKD.js +0 -84
- package/dist/chunk-C7SV6AR2.js +0 -48
- package/dist/chunk-CI6273ZU.js +0 -107
- package/dist/chunk-FEHVIHVA.js +0 -5
- package/dist/chunk-G6J2WIHJ.js +0 -4
- package/dist/chunk-HEOMRXZE.js +0 -4
- package/dist/chunk-HN55QF5N.js +0 -405
- package/dist/chunk-JJ4QQPAV.js +0 -4
- package/dist/chunk-JQ2CRYVX.js +0 -4
- package/dist/chunk-JS3DLVVI.js +0 -4
- package/dist/chunk-KH4QH23U.js +0 -4
- package/dist/chunk-KMZ3L5YA.js +0 -4
- package/dist/chunk-KOKEEAEF.js +0 -6
- package/dist/chunk-LCCJPRT5.js +0 -5
- package/dist/chunk-MHNGR6M7.js +0 -4
- package/dist/chunk-NNH3YVVO.js +0 -4
- package/dist/chunk-OQ6KNYPG.js +0 -4
- package/dist/chunk-PYDYI3AA.js +0 -23
- package/dist/chunk-Q2TF5WLS.js +0 -6
- package/dist/chunk-QEE4CNMY.js +0 -6
- package/dist/chunk-R4ZTRVDQ.js +0 -4
- package/dist/chunk-RIASQHPG.js +0 -4
- package/dist/chunk-RLB66SU3.js +0 -4
- package/dist/chunk-SXVWB7TZ.js +0 -6
- package/dist/chunk-T6WA2F3S.js +0 -16
- package/dist/chunk-TZPYILZK.js +0 -4
- package/dist/chunk-VHFITVRX.js +0 -13
- package/dist/chunk-W3CXPVVB.js +0 -7
- package/dist/chunk-WB3HHOCG.js +0 -11
- package/dist/chunk-XA6BMQTW.js +0 -8
- package/dist/chunk-XAMVRZJH.js +0 -23
- package/dist/chunk-Y52M43LO.js +0 -8
- package/dist/chunk-YD4VBOBY.js +0 -4
- package/dist/chunk-YRU6BOIP.js +0 -9
- package/dist/chunk-ZSD6QDYB.js +0 -56
- package/dist/cli-error-UYWIDE4L.js +0 -4
- package/dist/compile-write-QNV2EA5B.js +0 -4
- package/dist/daemon-D4UCHMHS.js +0 -175
- package/dist/daemon-LZTY7W4M.js +0 -4
- package/dist/daemon-lock-RPKO5SNE.js +0 -4
- package/dist/dsl-loader-G2CRA252.js +0 -4
- package/dist/dsl-typecheck-worker.js +0 -6
- package/dist/exit-plan-gate-44YWEKYS.js +0 -4
- package/dist/hook.js +0 -5
- package/dist/plan-reminder-EDDIUY43.js +0 -4
- package/dist/post-edit-4CM5P2G2.js +0 -4
- package/dist/post-edit-analyze-HKOTNA2H.js +0 -4
- package/dist/post-edit-flag-stubs-2HZMK4NQ.js +0 -4
- package/dist/pre-bash-run-gate-CDFNAIK3.js +0 -4
- package/dist/pre-edit-JZX36QX6.js +0 -4
- package/dist/pre-edit-ripplo-skill-gate-A6ETC3QN.js +0 -4
- package/dist/pre-edit-scope-gate-HNIQ7KOQ.js +0 -4
- package/dist/pre-edit-watch-gate-T2TWL66C.js +0 -4
- package/dist/prompt-submit-GVZHK3CI.js +0 -4
- package/dist/scope-reminder-A6GVTTVE.js +0 -4
- package/dist/session-preamble-IZQPIWST.js +0 -4
- package/dist/status-CNSPYNYP.js +0 -4
- package/dist/stop-enforce-NKKP2X4U.js +0 -64
- package/dist/tasks-reminder-TDWPD3KV.js +0 -4
- package/dist/track-skill-load-SXSDMHFO.js +0 -4
- package/dist/track-skill-prompt-7N4TQAD2.js +0 -4
package/README.md
CHANGED
|
@@ -1,158 +1,46 @@
|
|
|
1
1
|
# ripplo
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
Ripplo models a critical user journey, synthesizes valid starting state, drives the browser, and
|
|
4
|
+
verifies the complete visible and application-state result.
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
Ripplo writes and owns the workflows. Install `@ripplo/auth`, then comment `@ripplo review` on a
|
|
7
|
+
pull request. Ripplo reads the preview URL from the deploy bot's comment. Pass it yourself when
|
|
8
|
+
there is none: `@ripplo review <preview-url>`. To sign in through a saved connection other than
|
|
9
|
+
the project default, add `auth=<connection name>`. Your repository holds no workflow files.
|
|
8
10
|
|
|
9
|
-
|
|
10
|
-
const project = required(projects, {});
|
|
11
|
-
const nextName = arbitrary(projects.name);
|
|
12
|
-
const selectedProject = select(projects, { id: project.id });
|
|
13
|
-
|
|
14
|
-
return {
|
|
15
|
-
given: [viewport.desktop, project],
|
|
16
|
-
steps: [
|
|
17
|
-
goto`/projects/${project.id}/dashboard`.expect(
|
|
18
|
-
visible(heading(project.name)),
|
|
19
|
-
visible(button("Project actions")),
|
|
20
|
-
),
|
|
21
|
-
click(button("Project actions")).expect(
|
|
22
|
-
visible(projectActions),
|
|
23
|
-
visible(inside(projectActions, link("Settings"))),
|
|
24
|
-
),
|
|
25
|
-
click(inside(projectActions, link("Settings"))).expect(
|
|
26
|
-
not(visible(projectActions)),
|
|
27
|
-
url.path.is`/projects/${project.id}/settings`,
|
|
28
|
-
visible(heading("General settings")),
|
|
29
|
-
visible(button("Edit project name")),
|
|
30
|
-
),
|
|
31
|
-
click(button("Edit project name")).expect(
|
|
32
|
-
visible(textbox("Project name")),
|
|
33
|
-
visible(button("Save")),
|
|
34
|
-
disabled(button("Save")),
|
|
35
|
-
),
|
|
36
|
-
fill(textbox("Project name"), nextName).expect(
|
|
37
|
-
value(textbox("Project name"), nextName),
|
|
38
|
-
enabled(button("Save")),
|
|
39
|
-
),
|
|
40
|
-
click(button("Save")).expect(
|
|
41
|
-
visible(status("Saved")),
|
|
42
|
-
visible(heading(nextName)),
|
|
43
|
-
updated(selectedProject, {
|
|
44
|
-
name: transform(({ after, before }) =>
|
|
45
|
-
and(equals(after, nextName), not(equals(after, before))),
|
|
46
|
-
),
|
|
47
|
-
}),
|
|
48
|
-
),
|
|
49
|
-
],
|
|
50
|
-
};
|
|
51
|
-
});
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Workflows describe the widest starting-state constraints valid for the whole journey, not fixed
|
|
55
|
-
fixtures. Schema-derived handles keep generated names, ids, and relations connected through later
|
|
56
|
-
actions and effects. Undeclared observed state changes are frame violations.
|
|
57
|
-
|
|
58
|
-
## Setup with Claude Code
|
|
59
|
-
|
|
60
|
-
One command installs the Claude Code plugin and opens guided setup:
|
|
11
|
+
## Setup
|
|
61
12
|
|
|
62
13
|
```sh
|
|
63
14
|
npx ripplo setup
|
|
64
15
|
```
|
|
65
16
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
npx ripplo auth login
|
|
73
|
-
npx ripplo init
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
`npx ripplo init` creates:
|
|
77
|
-
|
|
78
|
-
- `.ripplo/state.ts` with one root Zod state schema
|
|
79
|
-
- `.ripplo/workflows/` for typed user journeys
|
|
80
|
-
- `.ripplo/project.json` for project and environment pointers
|
|
81
|
-
- `.ripplo/ripplo.lock`, the committed compiled model
|
|
82
|
-
|
|
83
|
-
Each top-level state key is one source. A source reads one validated state fragment and implements
|
|
84
|
-
only the setup operations derived from its schema:
|
|
85
|
-
|
|
86
|
-
```ts
|
|
87
|
-
import { createStateSourceEngine } from "@ripplo/testing/engine";
|
|
88
|
-
import { state } from "../../../.ripplo/state.js";
|
|
89
|
-
|
|
90
|
-
export const coreEngine = createStateSourceEngine(state.core, {
|
|
91
|
-
read: ({ runId }) => readCoreState(runId),
|
|
92
|
-
setup: {
|
|
93
|
-
records: {
|
|
94
|
-
tasks: ({ input, runId }) => createTask({ input, runId }),
|
|
95
|
-
},
|
|
96
|
-
fields: ({ input, runId }) => setCoreFields({ input, runId }),
|
|
97
|
-
},
|
|
98
|
-
teardown: ({ runId }) => clearRunState(runId),
|
|
99
|
-
});
|
|
100
|
-
```
|
|
17
|
+
Run it in the app's repository. It signs you in, installs the Ripplo GitHub App if needed, creates
|
|
18
|
+
the project from the git remote, asks for the deployed test URL, creates an OpenID Connect
|
|
19
|
+
connection, and prints the values to register in your app. Add the connection to your auth library
|
|
20
|
+
(guides at [ripplo.ai/docs#sign-in](https://ripplo.ai/docs#sign-in)), set the
|
|
21
|
+
variables on your dev server, deploy, then `npx ripplo setup --check` tests authentication,
|
|
22
|
+
installs the Ripplo plugin in Claude Code, and opens your project.
|
|
101
23
|
|
|
102
|
-
|
|
103
|
-
NestJS, Next.js, Hono, Elysia, or Vite. Authentication uses a separate schema-derived engine because
|
|
104
|
-
signing in creates and verifies a browser session. The Claude setup skill wires the exact adapter
|
|
105
|
-
for your application.
|
|
24
|
+
## Commands
|
|
106
25
|
|
|
107
|
-
|
|
26
|
+
The CLI is for coding agents working on a Ripplo review. Sign in first.
|
|
108
27
|
|
|
109
28
|
```sh
|
|
110
|
-
|
|
29
|
+
npx ripplo setup # connect this repository to Ripplo
|
|
30
|
+
npx ripplo setup --app-url <url> --sign-in-page <path> --redirect-uri <url> # same, without prompts
|
|
31
|
+
npx ripplo login # sign in through your browser
|
|
32
|
+
npx ripplo logout # remove the saved token
|
|
33
|
+
npx ripplo review <codeReviewId> # issues of the published attempt (JSON)
|
|
34
|
+
npx ripplo explain <runId> # failures per step with nearby evidence (JSON)
|
|
35
|
+
npx ripplo snapshot <runId> --offset <ms> # PNG and rrweb-tagged HTML of that frame
|
|
111
36
|
```
|
|
112
37
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
Start the app dev server and daemon separately:
|
|
116
|
-
|
|
117
|
-
```sh
|
|
118
|
-
npx ripplo daemon
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
Then run:
|
|
122
|
-
|
|
123
|
-
```sh
|
|
124
|
-
npx ripplo compile
|
|
125
|
-
npx ripplo run
|
|
126
|
-
npx ripplo run <workflow-slug>
|
|
127
|
-
npx ripplo run <workflow-slug>/<test-slug>
|
|
128
|
-
npx ripplo run --all
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
`npx ripplo run` connects to the daemon and runs Testing Scope. It does not start or stop the
|
|
132
|
-
daemon. Use `npx ripplo doctor` when the app, adapter, or daemon is unavailable.
|
|
133
|
-
|
|
134
|
-
Start a workflow from the widest state the full path permits:
|
|
135
|
-
|
|
136
|
-
- Use `required`, `optional`, `absent`, `closed`, and relations for meaningful state shape.
|
|
137
|
-
- Use `arbitrary(field)` for schema-valid workflow inputs and reuse the binding.
|
|
138
|
-
- Use `exact(value)` only when that concrete value drives behavior.
|
|
139
|
-
- Use named `when` branches when starting state changes the outcome but intent and path stay the
|
|
140
|
-
same.
|
|
141
|
-
- Declare every visible outcome and complete state effect, including cascades.
|
|
142
|
-
- Make every effect provably change state.
|
|
143
|
-
|
|
144
|
-
The full authoring reference ships at `node_modules/@ripplo/testing/DSL.md`.
|
|
145
|
-
|
|
146
|
-
## Lockfile
|
|
147
|
-
|
|
148
|
-
Commit `.ripplo/ripplo.lock`. The server reads it on every push. Regenerate it with
|
|
149
|
-
`npx ripplo compile`. Never edit it by hand.
|
|
38
|
+
`snapshot` takes exactly one of `--at <epoch ms>` or `--offset <ms from the start>`.
|
|
150
39
|
|
|
151
|
-
|
|
40
|
+
`explain` and `snapshot` download the run's `behavior.jsonl` on first use and cache it under
|
|
41
|
+
`$XDG_CACHE_HOME/ripplo/runs/<runId>/`, defaulting to `~/.cache`.
|
|
152
42
|
|
|
153
|
-
|
|
154
|
-
Copy or share the ignored environment file and use distinct app and engine ports.
|
|
155
|
-
`npx ripplo doctor` reports mismatches.
|
|
43
|
+
Set `RIPPLO_SERVER_URL` to point the CLI at a Ripplo server other than https://ripplo.ai.
|
|
156
44
|
|
|
157
45
|
## License
|
|
158
46
|
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {createRequire}from'node:module';globalThis.require ?? createRequire(import.meta.url);
|
|
3
|
+
var g=Object.create;var e=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var j=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var m=(b,a)=>()=>(a||b((a={exports:{}}).exports,a),a.exports),n=(b,a)=>{for(var c in a)e(b,c,{get:a[c],enumerable:true});},l=(b,a,c,f)=>{if(a&&typeof a=="object"||typeof a=="function")for(let d of i(a))!k.call(b,d)&&d!==c&&e(b,d,{get:()=>a[d],enumerable:!(f=h(a,d))||f.enumerable});return b};var o=(b,a,c)=>(c=b!=null?g(j(b)):{},l(a||!b||!b.__esModule?e(c,"default",{value:b,enumerable:true}):c,b));export{m as a,n as b,o as c};
|