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.
Files changed (77) hide show
  1. package/README.md +26 -138
  2. package/dist/chunk-HA3VCAP6.js +3 -0
  3. package/dist/graphql-Z4UDRCDF.js +185 -0
  4. package/dist/index.js +345 -625
  5. package/package.json +10 -45
  6. package/dist/assets/browser-trace.js +0 -1
  7. package/dist/assets/rrweb.js +0 -54
  8. package/dist/capture-worker.js +0 -13892
  9. package/dist/chunk-3BPQWAUL.js +0 -4
  10. package/dist/chunk-47LLHHJH.js +0 -9
  11. package/dist/chunk-5HFJIZLI.js +0 -4
  12. package/dist/chunk-5RKZ44OU.js +0 -4
  13. package/dist/chunk-7WZ3VIUU.js +0 -4
  14. package/dist/chunk-AXROBTLA.js +0 -4
  15. package/dist/chunk-BFAWQ5U2.js +0 -61
  16. package/dist/chunk-BGY5F3IU.js +0 -5
  17. package/dist/chunk-BIB4JJKD.js +0 -84
  18. package/dist/chunk-C7SV6AR2.js +0 -48
  19. package/dist/chunk-CI6273ZU.js +0 -107
  20. package/dist/chunk-FEHVIHVA.js +0 -5
  21. package/dist/chunk-G6J2WIHJ.js +0 -4
  22. package/dist/chunk-HEOMRXZE.js +0 -4
  23. package/dist/chunk-HN55QF5N.js +0 -405
  24. package/dist/chunk-JJ4QQPAV.js +0 -4
  25. package/dist/chunk-JQ2CRYVX.js +0 -4
  26. package/dist/chunk-JS3DLVVI.js +0 -4
  27. package/dist/chunk-KH4QH23U.js +0 -4
  28. package/dist/chunk-KMZ3L5YA.js +0 -4
  29. package/dist/chunk-KOKEEAEF.js +0 -6
  30. package/dist/chunk-LCCJPRT5.js +0 -5
  31. package/dist/chunk-MHNGR6M7.js +0 -4
  32. package/dist/chunk-NNH3YVVO.js +0 -4
  33. package/dist/chunk-OQ6KNYPG.js +0 -4
  34. package/dist/chunk-PYDYI3AA.js +0 -23
  35. package/dist/chunk-Q2TF5WLS.js +0 -6
  36. package/dist/chunk-QEE4CNMY.js +0 -6
  37. package/dist/chunk-R4ZTRVDQ.js +0 -4
  38. package/dist/chunk-RIASQHPG.js +0 -4
  39. package/dist/chunk-RLB66SU3.js +0 -4
  40. package/dist/chunk-SXVWB7TZ.js +0 -6
  41. package/dist/chunk-T6WA2F3S.js +0 -16
  42. package/dist/chunk-TZPYILZK.js +0 -4
  43. package/dist/chunk-VHFITVRX.js +0 -13
  44. package/dist/chunk-W3CXPVVB.js +0 -7
  45. package/dist/chunk-WB3HHOCG.js +0 -11
  46. package/dist/chunk-XA6BMQTW.js +0 -8
  47. package/dist/chunk-XAMVRZJH.js +0 -23
  48. package/dist/chunk-Y52M43LO.js +0 -8
  49. package/dist/chunk-YD4VBOBY.js +0 -4
  50. package/dist/chunk-YRU6BOIP.js +0 -9
  51. package/dist/chunk-ZSD6QDYB.js +0 -56
  52. package/dist/cli-error-UYWIDE4L.js +0 -4
  53. package/dist/compile-write-QNV2EA5B.js +0 -4
  54. package/dist/daemon-D4UCHMHS.js +0 -175
  55. package/dist/daemon-LZTY7W4M.js +0 -4
  56. package/dist/daemon-lock-RPKO5SNE.js +0 -4
  57. package/dist/dsl-loader-G2CRA252.js +0 -4
  58. package/dist/dsl-typecheck-worker.js +0 -6
  59. package/dist/exit-plan-gate-44YWEKYS.js +0 -4
  60. package/dist/hook.js +0 -5
  61. package/dist/plan-reminder-EDDIUY43.js +0 -4
  62. package/dist/post-edit-4CM5P2G2.js +0 -4
  63. package/dist/post-edit-analyze-HKOTNA2H.js +0 -4
  64. package/dist/post-edit-flag-stubs-2HZMK4NQ.js +0 -4
  65. package/dist/pre-bash-run-gate-CDFNAIK3.js +0 -4
  66. package/dist/pre-edit-JZX36QX6.js +0 -4
  67. package/dist/pre-edit-ripplo-skill-gate-A6ETC3QN.js +0 -4
  68. package/dist/pre-edit-scope-gate-HNIQ7KOQ.js +0 -4
  69. package/dist/pre-edit-watch-gate-T2TWL66C.js +0 -4
  70. package/dist/prompt-submit-GVZHK3CI.js +0 -4
  71. package/dist/scope-reminder-A6GVTTVE.js +0 -4
  72. package/dist/session-preamble-IZQPIWST.js +0 -4
  73. package/dist/status-CNSPYNYP.js +0 -4
  74. package/dist/stop-enforce-NKKP2X4U.js +0 -64
  75. package/dist/tasks-reminder-TDWPD3KV.js +0 -4
  76. package/dist/track-skill-load-SXSDMHFO.js +0 -4
  77. package/dist/track-skill-prompt-7N4TQAD2.js +0 -4
package/README.md CHANGED
@@ -1,158 +1,46 @@
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 `@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
- 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 });
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
- 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";
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
- 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.
24
+ ## Commands
106
25
 
107
- Preload `@ripplo/instrument` in server-side development processes to capture application spans:
26
+ The CLI is for coding agents working on a Ripplo review. Sign in first.
108
27
 
109
28
  ```sh
110
- node --import @ripplo/instrument server.js
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
- ## Compile and run
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
- ## Worktrees
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
- 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.
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};