ripplo 0.20.5 → 0.21.1
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 +1 -1
- package/dist/assets/collector-runtime.js +6 -6
- package/dist/assets/download-viewer/LICENSE +177 -0
- package/dist/assets/download-viewer/cmaps/78-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78ms-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/78ms-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/83pv-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90ms-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90ms-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90msp-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90msp-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90pv-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/90pv-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Add-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Add-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Add-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Add-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-0.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-1.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-3.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-4.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-5.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-6.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-CNS1-UCS2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-0.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-1.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-3.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-4.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-5.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-GB1-UCS2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-0.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-1.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-3.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-4.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-5.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-6.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Japan1-UCS2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Korea1-0.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Korea1-1.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Korea1-2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Adobe-Korea1-UCS2.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/B5pc-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/B5pc-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS1-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS1-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS2-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/CNS2-V.bcmap +3 -0
- package/dist/assets/download-viewer/cmaps/ETHK-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/ETHK-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/ETen-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/ETen-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/ETenms-B5-H.bcmap +3 -0
- package/dist/assets/download-viewer/cmaps/ETenms-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Ext-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Ext-RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Ext-RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Ext-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GB-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GB-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GB-H.bcmap +4 -0
- package/dist/assets/download-viewer/cmaps/GB-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBK-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBK-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBK2K-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBK2K-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBKp-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBKp-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBT-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBT-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBT-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBT-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBTpc-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBTpc-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBpc-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/GBpc-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKdla-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKdla-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKdlb-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKdlb-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKgccs-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKgccs-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKm314-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKm314-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKm471-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKm471-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKscs-B5-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/HKscs-B5-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Hankaku.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Hiragana.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-Johab-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-Johab-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCms-UHC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCms-UHC-HW-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCms-UHC-HW-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCms-UHC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCpc-EUC-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/KSCpc-EUC-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Katakana.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/LICENSE +36 -0
- package/dist/assets/download-viewer/cmaps/NWP-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/NWP-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/RKSJ-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/RKSJ-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/Roman.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UCS2-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UCS2-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF16-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF16-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF8-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniCNS-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UCS2-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UCS2-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF16-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF16-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF8-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniGB-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UCS2-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UCS2-HW-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UCS2-HW-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UCS2-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF16-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF16-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF8-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF16-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF16-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF8-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJIS2004-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISPro-UCS2-HW-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISPro-UCS2-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISPro-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISX0213-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISX0213-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISX02132004-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniJISX02132004-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UCS2-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UCS2-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF16-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF16-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF32-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF32-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF8-H.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/UniKS-UTF8-V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/V.bcmap +0 -0
- package/dist/assets/download-viewer/cmaps/WP-Symbol.bcmap +0 -0
- package/dist/assets/download-viewer/iccs/CGATS001Compat-v2-micro.icc +0 -0
- package/dist/assets/download-viewer/iccs/LICENSE +116 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitDingbats.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitFixed.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitFixedBold.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitFixedBoldItalic.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitFixedItalic.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitSerif.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitSerifBold.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitSerifBoldItalic.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitSerifItalic.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/FoxitSymbol.pfb +0 -0
- package/dist/assets/download-viewer/standard_fonts/LICENSE_FOXIT +27 -0
- package/dist/assets/download-viewer/standard_fonts/LICENSE_LIBERATION +363 -0
- package/dist/assets/download-viewer/standard_fonts/LiberationSans-Bold.ttf +0 -0
- package/dist/assets/download-viewer/standard_fonts/LiberationSans-BoldItalic.ttf +0 -0
- package/dist/assets/download-viewer/standard_fonts/LiberationSans-Italic.ttf +0 -0
- package/dist/assets/download-viewer/standard_fonts/LiberationSans-Regular.ttf +0 -0
- package/dist/assets/download-viewer/viewer.js +147 -0
- package/dist/assets/download-viewer/wasm/LICENSE_JBIG2 +196 -0
- package/dist/assets/download-viewer/wasm/LICENSE_OPENJPEG +39 -0
- package/dist/assets/download-viewer/wasm/LICENSE_PDFJS_JBIG2 +13 -0
- package/dist/assets/download-viewer/wasm/LICENSE_PDFJS_OPENJPEG +22 -0
- package/dist/assets/download-viewer/wasm/LICENSE_PDFJS_QCMS +19 -0
- package/dist/assets/download-viewer/wasm/LICENSE_QCMS +21 -0
- package/dist/assets/download-viewer/wasm/jbig2.wasm +0 -0
- package/dist/assets/download-viewer/wasm/jbig2_nowasm_fallback.js +15 -0
- package/dist/assets/download-viewer/wasm/openjpeg.wasm +0 -0
- package/dist/assets/download-viewer/wasm/openjpeg_nowasm_fallback.js +17 -0
- package/dist/assets/download-viewer/wasm/qcms_bg.wasm +0 -0
- package/dist/assets/download-viewer/wasm/quickjs-eval.js +16 -0
- package/dist/assets/download-viewer/wasm/quickjs-eval.wasm +0 -0
- package/dist/assets/rrweb-replay.js +1 -1
- package/dist/assets/rrweb.js +9 -9
- package/dist/index.js +373 -294
- package/dist/page-runtime.js +23 -23
- package/dist/plugin-source/plugin.json +19 -0
- package/dist/plugin-source/skills/skills/cover/SKILL.md +68 -0
- package/dist/plugin-source/skills/skills/review/SKILL.md +52 -0
- package/package.json +2 -2
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
|
+
"name": "ripplo",
|
|
4
|
+
"description": "Ripplo reviews pull requests by driving your app end to end in a real browser and reporting what broke, with the evidence. This plugin lets your coding agent fix what a review found and add what a review could not cover.",
|
|
5
|
+
"version": "0.21.1",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "Ripplo",
|
|
8
|
+
"url": "https://ripplo.ai"
|
|
9
|
+
},
|
|
10
|
+
"repository": "https://github.com/ripplo/agent-plugin",
|
|
11
|
+
"homepage": "https://ripplo.ai",
|
|
12
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"e2e",
|
|
15
|
+
"testing",
|
|
16
|
+
"code-review",
|
|
17
|
+
"qa"
|
|
18
|
+
]
|
|
19
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cover
|
|
3
|
+
description: "Add what Ripplo could not cover. Use when the user runs `ripplo:cover`, alone, with a code review id, with `--gap` ids, or with a list of workflows, or asks to make an uncoverable workflow testable. Reads each coverage gap, adds the API or route the app lacks so Ripplo can set up and observe that state, and reports per gap."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Cover the workflows a Ripplo review could not
|
|
7
|
+
|
|
8
|
+
Input: nothing, a code review id, one or more `--gap <id>` arguments, or one line per workflow pasted after the command (`- <workflow>: <what Ripplo cannot do>`). Output: the app changed in the working tree so Ripplo can create and observe the state each coverage gap names, one short report per gap.
|
|
9
|
+
|
|
10
|
+
Two words matter here. An uncoverable workflow is a user journey Ripplo cannot test yet. A coverage gap is one thing the app does not give Ripplo, and it is what holds uncoverable workflows back. Several workflows can share one gap, and one workflow can have several. One kind of gap is different: a `ripploLimitation` gap is something Ripplo itself cannot do or judge yet. No change to the app removes it, so you never work on one.
|
|
11
|
+
|
|
12
|
+
With nothing after the command, the work is every coverage gap of the project connected to this repository. With an id, it is the gaps of the workflows that review could not cover. With `--gap` arguments, it is exactly those gaps and nothing else. All three come from the CLI. Never query Ripplo any other way. With pasted lines, each line is a workflow with what Ripplo cannot do, and there is nothing to fetch. When the input ends with a `Server: <url>` line, it is not a gap: prefix every `npx ripplo` command with `RIPPLO_SERVER_URL=<url>`.
|
|
13
|
+
|
|
14
|
+
```sh
|
|
15
|
+
npx ripplo gaps # every coverage gap of the project, each with its workflows (JSON)
|
|
16
|
+
npx ripplo gaps --gap <id> # only this gap (JSON), repeat --gap for several
|
|
17
|
+
npx ripplo review <codeReviewId> # issues and uncoverable workflows of the published attempt (JSON)
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
`npx ripplo gaps` prints a `gaps` array. Each gap has a `slug`, a `kind` (`permission`, `missingApi`, `externalSystem`, `ripploLimitation`, or `other`), a one-sentence `description`, and `workflows`, the uncoverable workflows it holds back. Each workflow has `workflow`, `behavior` (what Ripplo could not check), and `otherGaps`, the gaps it still has besides this one. With `--gap` arguments, pass them to `npx ripplo gaps` unchanged, and remove only the gaps you were given. Do not remove a gap listed under `otherGaps` unless it was also given.
|
|
21
|
+
|
|
22
|
+
The `gaps` array holds only gaps an app change can remove. A `ripploLimitation` gap appears only under a workflow's `otherGaps`, and `--gap` refuses one. Each workflow has `appChangeCanCover`, which is false when one of its gaps is a `ripploLimitation`. Such a workflow stays uncoverable whatever you remove.
|
|
23
|
+
|
|
24
|
+
`npx ripplo review <codeReviewId>` prints an `uncoverable` array. Each entry has `workflow`, `behavior`, `appChangeCanCover`, and its `gaps`. Work only on the gaps of entries whose `appChangeCanCover` is true, and skip every gap whose `kind` is `ripploLimitation`.
|
|
25
|
+
|
|
26
|
+
When `gaps` says several projects are connected to the repository, ask the user which one and pass it with `--project <id>`. Sign in first if the command says so: `npx ripplo login`.
|
|
27
|
+
|
|
28
|
+
## What a coverage gap means
|
|
29
|
+
|
|
30
|
+
Ripplo tests through the browser as a signed-in run user. Before a test it sets up the starting state and reads it back through the app's own APIs, using the run's browser session. When the app has no way to create or observe some state, Ripplo records the workflow as uncoverable and names the coverage gap instead of inventing state. Ripplo never edits application code, so the gap stays until the app gains the capability.
|
|
31
|
+
|
|
32
|
+
Every request a run makes carries a signed `x-ripplo-run` header, also when no user is signed in. A route can accept a Ripplo run by verifying that header with `ripploRunId({ headers, secrets })` from `@ripplo/auth`, using the same secret the app's `/ripplo` handler uses. It returns the run id, or `undefined` when the header is missing, expired, or forged.
|
|
33
|
+
|
|
34
|
+
## Loop, per gap
|
|
35
|
+
|
|
36
|
+
One change to the app removes a gap for every workflow it holds back, so start with the gaps that hold back the most workflows. A workflow is coverable once every gap it has is removed.
|
|
37
|
+
|
|
38
|
+
1. **Read the gap's `description` and `kind`.** The description says what Ripplo cannot create or observe. It never says how to fix it. `permission` means a way exists and the run user may not use it. `missingApi` means the app has no way to do it. `externalSystem` means the state lives outside the app, so the fix is usually a test fake or a guarded route that stands in for that system.
|
|
39
|
+
2. **Look for an existing API.** Find the app code that creates or reads that state. If an API already does it and the run user can call it with their own session, report that and change nothing. If it exists only behind a role the run user cannot hold, allow it for a verified Ripplo run.
|
|
40
|
+
3. **Otherwise add the smallest API that does it.** A route that creates the row or state the gap names, or one that reads it back. Guard it with `ripploRunId` and reject when it returns `undefined`. Never mount it unguarded.
|
|
41
|
+
4. **Keep it application code.** Test it like the rest of the app. Do not write `.ripplo/` files, bindings, or state schemas. The next Ripplo review of the pull request writes those and the workflow for each uncoverable workflow.
|
|
42
|
+
|
|
43
|
+
Gaps are independent. Fan out to subagents when there are many, one gap or one shared file cluster per agent, each told to load the `ripplo:cover` skill first.
|
|
44
|
+
|
|
45
|
+
## Finish
|
|
46
|
+
|
|
47
|
+
Report per gap: already possible, access extended, or added, naming the route or API and the workflows it held back. Then report per workflow whether every gap it has is now removed. When you were given `--gap` arguments, a workflow with an empty `otherGaps`, or whose other gaps were all given too, is now coverable. Name each workflow that is still held back and the gaps it still needs. A workflow whose `appChangeCanCover` is false is never now coverable: report it as one Ripplo cannot cover yet, tell the user to contact Ripplo at mail@ripplo.ai about it, and leave it out of the pull request section below.
|
|
48
|
+
|
|
49
|
+
This skill changes the application only. It does not write Ripplo tests. The next Ripplo review of the pull request writes the tests, and it reads the pull request description to learn which workflows it can now cover. Add this section to the description so the review knows where to go:
|
|
50
|
+
|
|
51
|
+
```md
|
|
52
|
+
## Ripplo coverage
|
|
53
|
+
|
|
54
|
+
Now coverable:
|
|
55
|
+
|
|
56
|
+
- <workflow>: added `POST /api/ripplo/invoices`, which creates an invoice for the run's organization.
|
|
57
|
+
- <workflow>: already possible, `GET /api/orders/:id` returns the refund state.
|
|
58
|
+
|
|
59
|
+
Still held back:
|
|
60
|
+
|
|
61
|
+
- <workflow>: needs <description of each gap it still has>.
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
List a workflow under "Now coverable" only when every gap it has is removed, with the `workflow` exactly as the CLI gives it and the route or API that removes each gap. Include workflows that were already possible, because no code change points the review at them. List every other workflow you touched under "Still held back" with the gaps it still needs, so the review leaves it uncoverable and no one expects a test for it yet. Leave a heading out when its list is empty.
|
|
65
|
+
|
|
66
|
+
When the branch has no pull request yet, give the user the section to paste when they open one.
|
|
67
|
+
|
|
68
|
+
Tell the user to push. Once the push is on the pull request, offer to run `npx ripplo review start <prUrl> --depth deep`, with the `prUrl` from `npx ripplo review <codeReviewId>`, and wait for it as the `ripplo:review` skill describes. The review covers each listed workflow, or keeps it uncoverable and names the gaps that still hold it back.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: review
|
|
3
|
+
description: "Start, wait for, and address a Ripplo code review. Use when the user pastes a Ripplo code review id or a pull request URL, asks to run or rerun a Ripplo review, says 'address the review', or asks what Ripplo found. Starts reviews with the CLI, checks their status until they finish, pulls the published issues, renders the failing frames, classifies each issue, fixes the app in the working tree."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Address a Ripplo code review
|
|
7
|
+
|
|
8
|
+
Input: a code review id, optionally followed by `issue <number>`, or a pull request URL to review. Output: the app fixed in the working tree, one short report per issue. When an issue number is named, address that issue only.
|
|
9
|
+
|
|
10
|
+
A third input is an issue Ripplo sent to a cloud agent. That text lists the issue's fields and evidence and gives a Ripplo token that reads only run recordings. For it, skip Start and wait, start the loop below at step 2 with the fields given, and use only `explain` and `snapshot`. When the change was intended, say so in the pull request description instead of a review comment. Finish by opening the pull request the text asks for.
|
|
11
|
+
|
|
12
|
+
Everything comes from the CLI. Never query Ripplo any other way. When the input ends with a `Server: <url>` line, it is not part of the id or issue: prefix every `npx ripplo` command with `RIPPLO_SERVER_URL=<url>`.
|
|
13
|
+
|
|
14
|
+
```sh
|
|
15
|
+
npx ripplo review start <prUrl> [--depth fast|deep] [--app-url <url>] [--auth <name>] # review the latest commit, prints codeReviewId (JSON)
|
|
16
|
+
npx ripplo review status <codeReviewId> # stage, reviewed commit, and latest commit (JSON)
|
|
17
|
+
npx ripplo review comment <codeReviewId> "<body>" [--issue <number>] # a comment the next review round reads and answers (JSON)
|
|
18
|
+
npx ripplo review <codeReviewId> # open issues of the review and uncoverable workflows of the published attempt (JSON)
|
|
19
|
+
npx ripplo explain <runId> # failures per starting state and step, with nearby evidence (JSON)
|
|
20
|
+
npx ripplo snapshot <runId> --offset <ms> # PNG + rrweb-tagged HTML of that frame
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
`explain` and `snapshot` download the run's `behavior.jsonl` to `$XDG_CACHE_HOME/ripplo/runs/<runId>/` on first use, defaulting to `~/.cache`. Sign in first if any command says so: `npx ripplo login`.
|
|
24
|
+
|
|
25
|
+
## Start and wait
|
|
26
|
+
|
|
27
|
+
- A pull request URL: run `start`, then wait for the `codeReviewId` it prints. `"alreadyRunning": true` means a review of the pull request was already in progress and nothing new started, so wait for that one. `"waitingForPreview": true` means the pull request has no preview in a deploy comment yet. The review starts once one is posted and `status` reports `previewBuilding` until then. When it says the pull request has several preview URLs, ask the user which one and pass it with `--app-url`. A pull request that was reviewed before is reviewed again with the last run's depth, app, and auth connection, unless a flag says otherwise.
|
|
28
|
+
- A code review id: run `npx ripplo review status <codeReviewId>`. When `stage` is `published`, continue with the loop below. Otherwise wait for it.
|
|
29
|
+
|
|
30
|
+
`status` prints `stage`, `reviewedSha` (the commit the published review ran on), `latestSha` (the pull request's latest commit), and `failure`. While the review is in progress `stage` is `previewBuilding`, `previewFailed`, `queued`, or `running`. It ends as `published`, `failed` (with `failure` saying why), or `stopped` (canceled, or nothing running and nothing published).
|
|
31
|
+
|
|
32
|
+
A review takes up to 30 minutes, 45 with `--depth deep`, plus any wait for the preview to deploy. Wait with this loop. Run it as a background command when your agent has one (the Monitor tool in Claude Code), otherwise as a shell command, at the longest timeout allowed. Then keep working or end your turn:
|
|
33
|
+
|
|
34
|
+
```sh
|
|
35
|
+
until out=$(npx ripplo review status <codeReviewId>) || exit 1; grep -qE '"stage": "(published|failed|stopped)"' <<<"$out"; do sleep 30; done
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
The command stops at its timeout, which is shorter than most reviews. When it expires before the loop ends, run the same loop again. When the user asks how the review is going, run `status` once and tell them the stage in one line. Ripplo itself waits for the preview, so never check the preview yourself. The loop exits with an error when `status` fails. Run `status` once to see the message and tell the user. When the loop ends, run `status` once more. `published` with `reviewedSha` equal to the commit you expect: run `npx ripplo review <codeReviewId>` and continue with the loop below. `published` with an older `reviewedSha`: the review you waited for ran on an earlier commit, so run `start` again and wait for the new review. `failed` or `stopped`: tell the user.
|
|
39
|
+
|
|
40
|
+
## Loop, per issue
|
|
41
|
+
|
|
42
|
+
1. **Read the issue.** `title`, `body`, `number` (the Ripplo issue number), `kind` (`regression`, `new`, or `existing`, relative to the reviewed change), `appearance` (`behavior` or `visual`), `workflow` (the workflow slug, or `null` when an explorer trail found the issue), and `evidence` (`runId`, `frameMs`). The body is the reviewer's claim. Verify it, do not trust it.
|
|
43
|
+
2. **See what the reviewer saw.** `npx ripplo snapshot <runId> --offset <frameMs>`, then open the PNG. The rendered frame is the evidence. A string in `behavior.jsonl` can be the test's own assertion text.
|
|
44
|
+
3. **See what failed.** `npx ripplo explain <runId>`. Each failure carries its `place` (the starting state or the step), its `detail` (a model failure such as a state mismatch or a missing outcome, a failed element check, or a driver error), the network, console, and span events in the 4s before, and `snapshotOffsetMs` for the frame. A state mismatch lists the expected and observed state. Grep the cached `behavior.jsonl` by `"kind"` only for detail explain did not surface.
|
|
45
|
+
4. **Decide.** Either the app is wrong, or the claim is. Fix the app when the frame shows the broken behavior. When the frame contradicts the claim, say so with the run id and frame, and change nothing. Never change app behavior just to make a finding disappear. When the change was intended and the workflow expects the old behavior, run `npx ripplo review comment <codeReviewId> "<body>" --issue <number>` saying what the app now does. The next round updates the workflow instead of reporting it again.
|
|
46
|
+
5. **Prove the frame, not the diff.** Before saying fixed, reason from the rendered frame and the failing check to the code you changed. Never conclude from a log string or a toast.
|
|
47
|
+
|
|
48
|
+
Issues are independent. Fan out to subagents when there are many, one issue or one shared file cluster per agent, each told to load the `ripplo:review` skill first.
|
|
49
|
+
|
|
50
|
+
## Finish
|
|
51
|
+
|
|
52
|
+
Report per issue: fixed, disputed, or intended with the comment id, what changed, run id and frame you checked. When `uncoverable` is not empty, say how many workflows the review could not cover. When some have `appChangeCanCover` true, say that the `ripplo:cover` skill, run with `<codeReviewId>`, adds what those need. Say that Ripplo cannot cover the rest yet and that the user can contact Ripplo at mail@ripplo.ai about them. Do not act on them here. Tell the user to push. A review of the new commit is the proof. Once the push is on the pull request, offer to run `npx ripplo review start <prUrl>` and wait for it as described above.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ripplo",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.21.1",
|
|
4
4
|
"description": "CLI for Ripplo — AI-powered end-to-end testing",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"homepage": "https://ripplo.ai",
|
|
@@ -35,8 +35,8 @@
|
|
|
35
35
|
"eslint-plugin-neverthrow": "^1.1.4",
|
|
36
36
|
"tsup": "^8.5.1",
|
|
37
37
|
"typescript": "^5.9.3",
|
|
38
|
-
"@ripplo/browser": "^0.0.0",
|
|
39
38
|
"@ripplo/core": "^0.0.0",
|
|
39
|
+
"@ripplo/browser": "^0.0.0",
|
|
40
40
|
"@ripplo/eslint-config": "0.0.0",
|
|
41
41
|
"@ripplo/publisher": "^0.0.0",
|
|
42
42
|
"@ripplo/rrweb-bundle": "0.0.0",
|