executable-stories-formatters 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "executable-stories-formatters",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Cucumber-compatible report formats (HTML, Markdown, JUnit XML, Cucumber JSON) for executable-stories test results.",
   "author": "Jag Reehal <jag@jagreehal.com>",
   "license": "MIT",

package/schemas/raw-run.schema.json

@@ -164,8 +164,21 @@
         },
         "tickets": {
           "type": "array",
-          "items": { "type": "string" },
-          "description": "Ticket/issue references for requirements traceability (e.g., ['JIRA-123'])."
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              {
+                "type": "object",
+                "properties": {
+                  "id": { "type": "string" },
+                  "url": { "type": "string" }
+                },
+                "required": ["id"],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "description": "Ticket/issue references. Each item is either a string ID or an object with id and optional url."
         },
         "meta": {
           "type": "object",
@@ -250,7 +263,8 @@
           "properties": {
             "kind": { "const": "note" },
             "text": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "text", "phase"],
           "additionalProperties": false
@@ -264,7 +278,8 @@
               "type": "array",
               "items": { "type": "string" }
             },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "names", "phase"],
           "additionalProperties": false
@@ -276,7 +291,8 @@
             "kind": { "const": "kv" },
             "label": { "type": "string" },
             "value": {},
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "label", "value", "phase"],
           "additionalProperties": false
@@ -289,7 +305,8 @@
             "label": { "type": "string" },
             "content": { "type": "string" },
             "lang": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "label", "content", "phase"],
           "additionalProperties": false
@@ -311,7 +328,8 @@
                 "items": { "type": "string" }
               }
             },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "label", "columns", "rows", "phase"],
           "additionalProperties": false
@@ -323,7 +341,8 @@
             "kind": { "const": "link" },
             "label": { "type": "string" },
             "url": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "label", "url", "phase"],
           "additionalProperties": false
@@ -335,7 +354,8 @@
             "kind": { "const": "section" },
             "title": { "type": "string" },
             "markdown": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "title", "markdown", "phase"],
           "additionalProperties": false
@@ -347,7 +367,8 @@
             "kind": { "const": "mermaid" },
             "code": { "type": "string" },
             "title": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "code", "phase"],
           "additionalProperties": false
@@ -359,7 +380,8 @@
             "kind": { "const": "screenshot" },
             "path": { "type": "string" },
             "alt": { "type": "string" },
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "path", "phase"],
           "additionalProperties": false
@@ -371,7 +393,8 @@
             "kind": { "const": "custom" },
             "type": { "type": "string" },
             "data": {},
-            "phase": { "$ref": "#/$defs/DocPhase" }
+            "phase": { "$ref": "#/$defs/DocPhase" },
+            "children": { "type": "array", "items": { "$ref": "#/$defs/DocEntry" }, "description": "Nested child doc entries for grouping." }
           },
           "required": ["kind", "type", "data", "phase"],
           "additionalProperties": false

package/skills/formatters-cli/SKILL.md

@@ -128,8 +128,49 @@ const cucumberJson = new CucumberJsonFormatter().formatToString(canonical);
 # Machine output
 --json-summary                # Print JSON summary to stdout
 --emit-canonical path.json    # Write canonical JSON
+
+# Asset Bundling
+--asset-mode none|copy        # Asset bundling strategy (default: none)
+--allow-missing-assets        # Warn on missing assets instead of failing
+```
+
+## Asset Bundling
+
+Use `--asset-mode copy` to produce a portable report directory. All locally-referenced assets
+(Playwright videos, screenshots, attachment files) are copied into an `assets/` subdirectory
+and HTML paths are rewritten.
+
+```bash
+executable-stories format raw-run.json --format html --output-dir report --asset-mode copy
+```
+
+Output:
+```
+report/
+  test-results.html   # paths rewritten to assets/
+  assets/
+    video-3f2c1a7b.webm
+    step-1-91ab22de.png
 ```
 
+### GitHub Actions usage
+
+```yaml
+- run: npx executable-stories format .executable-stories/raw-run.json --format html --output-dir report --asset-mode copy
+- uses: actions/upload-artifact@v4
+  with:
+    name: test-report
+    path: report/
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--asset-mode none` | Default. No asset bundling. |
+| `--asset-mode copy` | Copy local assets to `assets/`, rewrite paths. |
+| `--allow-missing-assets` | Warn on missing assets instead of failing. |
+
 ### Validation
 
 ```typescript