executable-stories-formatters 1.12.0 → 1.13.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.
package/README.md CHANGED
@@ -47,6 +47,12 @@ const results = await generator.generate(run);
47
47
  // results: Map<"html" | "markdown", string[]> (file paths written)
48
48
  ```
49
49
 
50
+ `generate(run)` updates canonical state under `reports/by-file/`, one report per
51
+ test source, then renders. Documentation formats use that accumulated suite. JUnit,
52
+ Cucumber, and `release-manifest` are execution evidence and contain only `run`. Use
53
+ `generate(run, { persist: false })` to render an already-assembled snapshot without
54
+ changing persistent state.
55
+
50
56
  ## Quick Start — CLI
51
57
 
52
58
  ```bash
@@ -59,6 +65,10 @@ executable-stories format run.json --format html --format markdown
59
65
  # Validate a run file against the schema
60
66
  executable-stories validate run.json
61
67
 
68
+ # Inspect or reset persistent per-source state
69
+ executable-stories runs status
70
+ executable-stories runs reset
71
+
62
72
  # Backpressure summary for coding agents: compress passing, expand failing
63
73
  executable-stories check .executable-stories/raw-run.json
64
74