ripplo 0.15.2 → 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.
Files changed (75) hide show
  1. package/README.md +18 -142
  2. package/dist/index.js +56 -664
  3. package/package.json +8 -45
  4. package/dist/assets/browser-trace.js +0 -1
  5. package/dist/assets/rrweb.js +0 -54
  6. package/dist/capture-worker.js +0 -13892
  7. package/dist/chunk-3BPQWAUL.js +0 -4
  8. package/dist/chunk-47LLHHJH.js +0 -9
  9. package/dist/chunk-5HFJIZLI.js +0 -4
  10. package/dist/chunk-5RKZ44OU.js +0 -4
  11. package/dist/chunk-7WZ3VIUU.js +0 -4
  12. package/dist/chunk-AXROBTLA.js +0 -4
  13. package/dist/chunk-BFAWQ5U2.js +0 -61
  14. package/dist/chunk-BGY5F3IU.js +0 -5
  15. package/dist/chunk-BIB4JJKD.js +0 -84
  16. package/dist/chunk-C7SV6AR2.js +0 -48
  17. package/dist/chunk-CI6273ZU.js +0 -107
  18. package/dist/chunk-FEHVIHVA.js +0 -5
  19. package/dist/chunk-G6J2WIHJ.js +0 -4
  20. package/dist/chunk-HEOMRXZE.js +0 -4
  21. package/dist/chunk-HN55QF5N.js +0 -405
  22. package/dist/chunk-JJ4QQPAV.js +0 -4
  23. package/dist/chunk-JQ2CRYVX.js +0 -4
  24. package/dist/chunk-JS3DLVVI.js +0 -4
  25. package/dist/chunk-KH4QH23U.js +0 -4
  26. package/dist/chunk-KMZ3L5YA.js +0 -4
  27. package/dist/chunk-KOKEEAEF.js +0 -6
  28. package/dist/chunk-LCCJPRT5.js +0 -5
  29. package/dist/chunk-MHNGR6M7.js +0 -4
  30. package/dist/chunk-NNH3YVVO.js +0 -4
  31. package/dist/chunk-OQ6KNYPG.js +0 -4
  32. package/dist/chunk-PYDYI3AA.js +0 -23
  33. package/dist/chunk-Q2TF5WLS.js +0 -6
  34. package/dist/chunk-QEE4CNMY.js +0 -6
  35. package/dist/chunk-R4ZTRVDQ.js +0 -4
  36. package/dist/chunk-RIASQHPG.js +0 -4
  37. package/dist/chunk-RLB66SU3.js +0 -4
  38. package/dist/chunk-SXVWB7TZ.js +0 -6
  39. package/dist/chunk-T6WA2F3S.js +0 -16
  40. package/dist/chunk-TZPYILZK.js +0 -4
  41. package/dist/chunk-VHFITVRX.js +0 -13
  42. package/dist/chunk-W3CXPVVB.js +0 -7
  43. package/dist/chunk-WB3HHOCG.js +0 -11
  44. package/dist/chunk-XA6BMQTW.js +0 -8
  45. package/dist/chunk-XAMVRZJH.js +0 -23
  46. package/dist/chunk-Y52M43LO.js +0 -8
  47. package/dist/chunk-YD4VBOBY.js +0 -4
  48. package/dist/chunk-YRU6BOIP.js +0 -9
  49. package/dist/chunk-ZSD6QDYB.js +0 -56
  50. package/dist/cli-error-UYWIDE4L.js +0 -4
  51. package/dist/compile-write-QNV2EA5B.js +0 -4
  52. package/dist/daemon-D4UCHMHS.js +0 -175
  53. package/dist/daemon-LZTY7W4M.js +0 -4
  54. package/dist/daemon-lock-RPKO5SNE.js +0 -4
  55. package/dist/dsl-loader-G2CRA252.js +0 -4
  56. package/dist/dsl-typecheck-worker.js +0 -6
  57. package/dist/exit-plan-gate-44YWEKYS.js +0 -4
  58. package/dist/hook.js +0 -5
  59. package/dist/plan-reminder-EDDIUY43.js +0 -4
  60. package/dist/post-edit-4CM5P2G2.js +0 -4
  61. package/dist/post-edit-analyze-HKOTNA2H.js +0 -4
  62. package/dist/post-edit-flag-stubs-2HZMK4NQ.js +0 -4
  63. package/dist/pre-bash-run-gate-CDFNAIK3.js +0 -4
  64. package/dist/pre-edit-JZX36QX6.js +0 -4
  65. package/dist/pre-edit-ripplo-skill-gate-A6ETC3QN.js +0 -4
  66. package/dist/pre-edit-scope-gate-HNIQ7KOQ.js +0 -4
  67. package/dist/pre-edit-watch-gate-T2TWL66C.js +0 -4
  68. package/dist/prompt-submit-GVZHK3CI.js +0 -4
  69. package/dist/scope-reminder-A6GVTTVE.js +0 -4
  70. package/dist/session-preamble-IZQPIWST.js +0 -4
  71. package/dist/status-CNSPYNYP.js +0 -4
  72. package/dist/stop-enforce-NKKP2X4U.js +0 -64
  73. package/dist/tasks-reminder-TDWPD3KV.js +0 -4
  74. package/dist/track-skill-load-SXSDMHFO.js +0 -4
  75. package/dist/track-skill-prompt-7N4TQAD2.js +0 -4
package/README.md CHANGED
@@ -1,158 +1,34 @@
1
1
  # ripplo
2
2
 
3
- Model a critical user journey once. Ripplo synthesizes valid starting state, drives the browser,
4
- and verifies the complete visible and application-state result.
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
- ```ts
7
- const projectActions = surface(menu("Project actions"), { overlay: true });
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
- export const renameProject = workflow("Rename a project", () => {
10
- const project = required(projects, {});
11
- const nextName = arbitrary(projects.name);
12
- const selectedProject = select(projects, { id: project.id });
9
+ ## Setup
13
10
 
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:
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
- 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
- ```
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
- ```sh
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 compile
125
- npx ripplo run
126
- npx ripplo run <workflow-slug>
127
- npx ripplo run <workflow-slug>/<test-slug>
128
- npx ripplo run --all
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
- `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.
26
+ `snapshot` takes exactly one of `--at <epoch ms>` or `--offset <ms from the start>`.
150
27
 
151
- ## Worktrees
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
- Each working directory gets its own daemon, Testing Scope, debug artifacts, and lockfile checkout.
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