podojo-cli 0.4.2__tar.gz → 0.4.3__tar.gz

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to the Podojo CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com),
 and this project adheres to [Semantic Versioning](https://semver.org).
 
+## [0.4.3] - 2026-04-14
+
+### Added
+- Support `instruction` step variant for usertests (briefing screen with a "Continue" button, useful before prototype steps)
+
 ## [0.4.2] - 2026-04-05
 
 ### Changed

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/CLAUDE.md

@@ -39,7 +39,7 @@ podojo usertests validate usertest.yaml # validate without creating
 
 User test configs are YAML files. Run `podojo usertests example` for the full template.
 Required fields: `usertest_id`, `client`, `title`, `logo`, `prototype_url`, `steps`.
-Each step needs `type` ("screen" or "prototype") and `title`. Screen steps should have `variant` ("question" or "task").
+Each step needs `type` ("screen" or "prototype") and `title`. Screen steps should have `variant` ("question", "task", or "instruction" — instruction screens render a "Continue" button instead of "Done with Step", useful as a briefing before a prototype step).
 
 ## Configuration
 

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: podojo-cli
-Version: 0.4.2
+Version: 0.4.3
 Summary: CLI for the Podojo user research platform
 Project-URL: Homepage, https://github.com/podojo/cli-podojo
 Project-URL: Source, https://github.com/podojo/cli-podojo

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "podojo-cli"
-version = "0.4.2"
+version = "0.4.3"
 description = "CLI for the Podojo user research platform"
 readme = "README.md"
 license = "MIT"

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/src/podojo_cli/commands/usertests.py

@@ -13,7 +13,7 @@ console = Console()
 
 REQUIRED_FIELDS = ["usertest_id", "title", "logo", "prototype_url", "steps"]
 VALID_STEP_TYPES = {"screen", "prototype"}
-VALID_STEP_VARIANTS = {"question", "task", "intro", "feedback"}
+VALID_STEP_VARIANTS = {"question", "task", "intro", "feedback", "instruction"}
 REQUIRED_STEP_FIELDS = ["type", "title"]
 
 EXAMPLE_YAML = """\
@@ -53,7 +53,8 @@ project_name: checkout-redesign-q1
 
 # Steps define what participants see and do
 # Each step requires: type ("screen" or "prototype") and title
-# Screen steps should have a variant: "question" (open-ended) or "task" (action-based)
+# Screen steps should have a variant: "question" (open-ended), "task" (action-based),
+# or "instruction" (briefing screen shown before a prototype step — uses a "Continue" button)
 # Optional per step: text (markdown), image (URL)
 steps:
   - type: screen
@@ -64,6 +65,13 @@ steps:
       What stands out to you first?
     image: https://example.com/screenshots/homepage.png
 
+  - type: screen
+    variant: instruction
+    title: Next, you'll try the prototype
+    text: |
+      On the next screen you'll see a working prototype.
+      Try to buy a pair of running shoes, and think aloud as you go.
+
   - type: prototype
     title: Complete a Purchase
     text: |
@@ -115,7 +123,7 @@ def validate_usertest_data(data: dict) -> list[str]:
                 variant = step.get("variant")
                 if step_type == "screen" and variant is not None and variant not in VALID_STEP_VARIANTS:
                     errors.append(
-                        f"Step {i}: 'variant' must be 'question' or 'task', got '{variant}'"
+                        f"Step {i}: 'variant' must be one of {sorted(VALID_STEP_VARIANTS)}, got '{variant}'"
                     )
     return errors
 

{podojo_cli-0.4.2 → podojo_cli-0.4.3}/uv.lock

@@ -472,7 +472,7 @@ wheels = [
 
 [[package]]
 name = "podojo-cli"
-version = "0.3.2"
+version = "0.4.3"
 source = { editable = "." }
 dependencies = [
     { name = "google-api-python-client" },