ripplo 0.15.1 → 0.16.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 +18 -142
- package/dist/index.js +56 -643
- package/package.json +7 -43
- 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-47LLHHJH.js +0 -9
- package/dist/chunk-5HFJIZLI.js +0 -4
- package/dist/chunk-5JXP37ET.js +0 -4
- package/dist/chunk-5PICILBD.js +0 -9
- package/dist/chunk-7WZ3VIUU.js +0 -4
- package/dist/chunk-ANAQCK5G.js +0 -4
- package/dist/chunk-AUXGLJ3J.js +0 -8
- package/dist/chunk-AXROBTLA.js +0 -4
- package/dist/chunk-BGY5F3IU.js +0 -5
- package/dist/chunk-BTIQ5H3K.js +0 -4
- package/dist/chunk-C7SV6AR2.js +0 -48
- package/dist/chunk-CI6273ZU.js +0 -107
- package/dist/chunk-EVEITUJH.js +0 -4
- package/dist/chunk-EYILCSW6.js +0 -11
- package/dist/chunk-F4UCCW7Q.js +0 -83
- package/dist/chunk-FEHVIHVA.js +0 -5
- package/dist/chunk-G6J2WIHJ.js +0 -4
- package/dist/chunk-HEOMRXZE.js +0 -4
- package/dist/chunk-IRT6UHD3.js +0 -61
- package/dist/chunk-IVW5DUE4.js +0 -360
- package/dist/chunk-JJ4QQPAV.js +0 -4
- package/dist/chunk-JPXTGKSB.js +0 -7
- package/dist/chunk-JS3DLVVI.js +0 -4
- package/dist/chunk-KH4QH23U.js +0 -4
- package/dist/chunk-KL6TIUNF.js +0 -4
- package/dist/chunk-KMZ3L5YA.js +0 -4
- package/dist/chunk-KOKEEAEF.js +0 -6
- package/dist/chunk-KOZTQJBB.js +0 -56
- package/dist/chunk-MHNGR6M7.js +0 -4
- package/dist/chunk-NNH3YVVO.js +0 -4
- package/dist/chunk-NUBMOTH6.js +0 -6
- package/dist/chunk-O4A5UISQ.js +0 -6
- package/dist/chunk-OQ6KNYPG.js +0 -4
- package/dist/chunk-PYDYI3AA.js +0 -23
- package/dist/chunk-QQ6VKZ6A.js +0 -5
- package/dist/chunk-QSKOYBDO.js +0 -8
- package/dist/chunk-R4ZTRVDQ.js +0 -4
- package/dist/chunk-RIASQHPG.js +0 -4
- package/dist/chunk-RXLDAR2J.js +0 -13
- package/dist/chunk-SXVWB7TZ.js +0 -6
- package/dist/chunk-T6WA2F3S.js +0 -16
- package/dist/chunk-XAMVRZJH.js +0 -23
- package/dist/chunk-XPOOWIRL.js +0 -4
- package/dist/cli-error-7LCAN3Z5.js +0 -4
- package/dist/compile-write-Y5III4OM.js +0 -4
- package/dist/daemon-6UYMYGPI.js +0 -175
- package/dist/daemon-EITBDEP7.js +0 -4
- package/dist/daemon-lock-RPKO5SNE.js +0 -4
- package/dist/dsl-loader-ASNZDV7E.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-6VWOS6HD.js +0 -4
- package/dist/post-edit-A5Y26UH5.js +0 -4
- package/dist/post-edit-analyze-2SBNWX6Y.js +0 -4
- package/dist/post-edit-flag-stubs-I43B5QPO.js +0 -4
- package/dist/pre-bash-run-gate-CDFNAIK3.js +0 -4
- package/dist/pre-edit-HJVNM7U5.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-G6BVWIDL.js +0 -4
- package/dist/prompt-submit-OXYVNXHK.js +0 -4
- package/dist/scope-reminder-A6GVTTVE.js +0 -4
- package/dist/session-preamble-IZQPIWST.js +0 -4
- package/dist/status-XUIBJXNP.js +0 -4
- package/dist/stop-enforce-BP6IIW3D.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,34 @@
|
|
|
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
|
|
7
|
+
`@ripplo review <preview-url>` on a pull request. Your repository holds no workflow files.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
const project = required(projects, {});
|
|
11
|
-
const nextName = arbitrary(projects.name);
|
|
12
|
-
const selectedProject = select(projects, { id: project.id });
|
|
9
|
+
## Setup
|
|
13
10
|
|
|
14
|
-
|
|
15
|
-
|
|
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:
|
|
61
|
-
|
|
62
|
-
```sh
|
|
63
|
-
npx ripplo setup
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
The session signs you in, creates or selects a project, scaffolds `.ripplo/`, mounts state-source
|
|
67
|
-
adapters, starts the daemon, and authors the first critical journey.
|
|
68
|
-
|
|
69
|
-
## Setup by hand
|
|
70
|
-
|
|
71
|
-
```sh
|
|
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";
|
|
11
|
+
Install `@ripplo/auth` and mount its handler at your authentication address. That is the whole
|
|
12
|
+
install. See [`@ripplo/auth`](../auth/README.md).
|
|
89
13
|
|
|
90
|
-
|
|
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
|
-
```
|
|
101
|
-
|
|
102
|
-
Mount each source engine behind `RIPPLO_ENGINE_URL` with the adapter for Express, Fastify, Koa,
|
|
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.
|
|
106
|
-
|
|
107
|
-
Preload `@ripplo/instrument` in server-side development processes to capture application spans:
|
|
108
|
-
|
|
109
|
-
```sh
|
|
110
|
-
node --import @ripplo/instrument server.js
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## Compile and run
|
|
114
|
-
|
|
115
|
-
Start the app dev server and daemon separately:
|
|
14
|
+
## Commands
|
|
116
15
|
|
|
117
|
-
|
|
118
|
-
npx ripplo daemon
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
Then run:
|
|
16
|
+
The CLI is for coding agents working on a Ripplo review. Sign in first.
|
|
122
17
|
|
|
123
18
|
```sh
|
|
124
|
-
npx ripplo
|
|
125
|
-
npx ripplo
|
|
126
|
-
npx ripplo
|
|
127
|
-
npx ripplo
|
|
128
|
-
npx ripplo
|
|
19
|
+
npx ripplo login # sign in through your browser
|
|
20
|
+
npx ripplo logout # remove the saved token
|
|
21
|
+
npx ripplo review <codeReviewId> # issues of the published attempt (JSON)
|
|
22
|
+
npx ripplo explain <runId> # failures per step with nearby evidence (JSON)
|
|
23
|
+
npx ripplo snapshot <runId> --offset <ms> # PNG and rrweb-tagged HTML of that frame
|
|
129
24
|
```
|
|
130
25
|
|
|
131
|
-
`
|
|
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.
|
|
26
|
+
`snapshot` takes exactly one of `--at <epoch ms>` or `--offset <ms from the start>`.
|
|
150
27
|
|
|
151
|
-
|
|
28
|
+
`explain` and `snapshot` download the run's `behavior.jsonl` on first use and cache it under
|
|
29
|
+
`$XDG_CACHE_HOME/ripplo/runs/<runId>/`, defaulting to `~/.cache`.
|
|
152
30
|
|
|
153
|
-
|
|
154
|
-
Copy or share the ignored environment file and use distinct app and engine ports.
|
|
155
|
-
`npx ripplo doctor` reports mismatches.
|
|
31
|
+
Set `RIPPLO_SERVER_URL` to point the CLI at a Ripplo server other than https://ripplo.ai.
|
|
156
32
|
|
|
157
33
|
## License
|
|
158
34
|
|