@ripplo/testing 0.0.6 → 0.0.8

package/README.md

@@ -14,9 +14,20 @@ npm install @ripplo/testing
 2. Define preconditions in `.ripplo/preconditions/`, then add `import "./preconditions/<file>.js";` to `.ripplo/index.ts`. Exports set up test data (users, projects, etc.)
 3. Write tests in `.ripplo/tests/`, then add `import "./tests/<id>.js";` to `.ripplo/index.ts`. The CLI only loads what that file imports.
 4. Run `npx ripplo lint` to validate, `npx ripplo run` to execute
+5. Commit the generated `.ripplo/ripplo.lock` alongside your DSL changes (see Lockfile below)
 
 Every test gets a clean slate via preconditions — no shared state, no ordering dependencies, fully parallelizable.
 
+## Lockfile
+
+`npx ripplo compile` (and `ripplo lint`, and the dashboard's file watcher) writes `.ripplo/ripplo.lock` — a JSON artifact containing the compiled graph + tests, plus a `lockfileVersion` field. **Commit it.**
+
+The Ripplo server reads the lockfile on every GitHub push webhook. If the lockfile is missing or out of date, the branch does not sync and the webhook returns 422.
+
+- `ripplo compile` — compile + write (default).
+- `ripplo compile --check` — exit non-zero if the lockfile is missing or stale. Use in pre-commit hooks or CI.
+- `ripplo doctor` — surfaces stale lockfiles and a missing pre-commit hook.
+
 ## DSL API
 
 ### Test Builder

package/dist/{chunk-GTHRSFXF.js → chunk-AQ52MYXE.js}

@@ -83,7 +83,7 @@ function compileSteps(steps, accessedKeys, requiresKeys) {
     variables[key] = { default: `test-${key}`, type: "string" };
   });
   const variableNamespaces = { ...requiresKeys };
-  return { entryNode: "step-0", nodes, variableNamespaces, variables, version: 2 };
+  return { entryNode: "step-0", nodes, variableNamespaces, variables };
 }
 function compileNode(step, id, next) {
   const { label, node: raw } = readStep(step);
@@ -116,7 +116,7 @@ function compileGraph(preconditionDefs, testDefs) {
       workflow: def.id
     });
   });
-  return { edges, preconditions, states, version: 3 };
+  return { edges, preconditions, states };
 }
 function resolveDependencyChain(requires, preconditionDefs) {
   const defsByName = new Map(preconditionDefs.map((d) => [d.name, d]));

package/dist/compiler.js

@@ -1,6 +1,6 @@
 import {
   compile
-} from "./chunk-GTHRSFXF.js";
+} from "./chunk-AQ52MYXE.js";
 import "./chunk-MGATMMCZ.js";
 export {
   compile

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   compile
-} from "./chunk-GTHRSFXF.js";
+} from "./chunk-AQ52MYXE.js";
 import "./chunk-MGATMMCZ.js";
 import {
   buildSetCookieHeader,