ripplo 0.1.12 → 0.2.1

package/README.md

@@ -59,17 +59,19 @@ The plugin hooks into your agent's workflow to create a tight validation loop
 npm install @ripplo/testing
 ```
 
-This is the DSL your `.ripplo/` files use to define workflows and preconditions.
+This is the DSL your `.ripplo/` files use — tests, preconditions (test data), and observers (backend assertions).
 
 ## How It Works
 
-**Define tests as code** — Tests are TypeScript files using a typed DSL. Your agent writes them, or you write them by hand. Each test defines its preconditions, starting URL, and interaction steps.
+**Define tests as code** — Tests are TypeScript files using a typed DSL. Your agent writes them, or you write them by hand. Each test declares its preconditions, starting URL, and interaction steps.
 
-**Every test gets a clean slate** — Each test defines its own preconditions (fresh user, sample data, permissions). No shared state or ordering dependencies.
+**Every test gets a clean slate** — Each test declares its own preconditions (fresh user, sample data, permissions). No shared state or ordering dependencies.
+
+**Backend assertions are first-class** — Use `assert.backend(observer, params)` mid-flow to verify DB rows, jobs, emails, or webhooks. Observers are typed, named, and bounded by a budget tier (fast / slow / async).
 
 **Dev mode to cloud** — The dashboard runs tests locally as you develop. When you merge, tests sync and run in the cloud against your deployed environment.
 
-**Secure by default** — Every precondition request is cryptographically signed. Test endpoints are gated behind a webhook secret.
+**Secure by default** — Every engine request is cryptographically signed. The engine adapter is gated behind a webhook secret and an `ENABLE_RIPPLO_TESTING` env flag.
 
 ## Commands
 
@@ -88,10 +90,11 @@ After setup, your project will have:
 
 ```
 .ripplo/
-├── ripplo.ts          # Config: createRipplo({ projectId, appUrl, ... })
+├── ripplo.ts          # Config: createRipplo({ projectId, appUrl, engineUrl, ... })
 ├── ripplo.lock        # Generated + committed: compiled DSL the Ripplo server reads on push
-├── index.ts           # Entry point — explicitly imports every precondition and test file
+├── index.ts           # Entry point — explicitly imports every precondition, observer, and test file
 ├── preconditions/     # Test data setup/teardown (add `import "./preconditions/<file>.js";` to index.ts)
+├── observers/         # Backend state assertions (add `import "./observers/<file>.js";` to index.ts)
 └── tests/             # Test specs (add `import "./tests/<id>.js";` to index.ts)
 ```
 
@@ -100,7 +103,7 @@ Configuration lives in `ripplo.ts` via `createRipplo()`:
 ```ts
 const ripplo = createRipplo({
   appUrl: "http://localhost:3000",
-  preconditionsUrl: "http://localhost:3000/ripplo/preconditions",
+  engineUrl: "http://localhost:3000/ripplo",
   projectId: "your-project-id",
   webhookSecret: process.env["RIPPLO_WEBHOOK_SECRET"] ?? "",
 });