podojo-cli 1.30.0__tar.gz → 1.32.0__tar.gz

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/CHANGELOG.md

@@ -5,6 +5,29 @@ 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).
 
+## [1.32.0] - 2026-11-04
+
+### Added
+- Answer quotas in the user test YAML: give an option of a single-select
+  screening question a `quota` (completed sessions wanted from participants who
+  pick it). `usertests validate` checks them; `usertests get` leaves the
+  server-managed `quota_counts` out so the output still goes back into `update`.
+- `usertests status <id>` shows responses and how full each quota is, and says
+  when a test closed itself because every answer to a question is full or
+  max_responses was reached. `--json` for scripts.
+
+## [1.31.0] - 2026-11-03
+
+### Added
+- `transcripts download <project> --all -o <folder>` downloads every transcript
+  in a project, one `<name> - <batch-id>.txt` per interview, and lists the
+  interviews that have no transcript yet.
+
+### Fixed
+- List tables no longer cut batch, interview and user test IDs. Off a terminal
+  (Claude Code, a pipe) they were squeezed to 80 columns and IDs ended in "…",
+  so agents guessed the rest and got 404s; tables now print at full width there.
+
 ## [1.30.0] - 2026-10-31
 
 ### Added

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: podojo-cli
-Version: 1.30.0
+Version: 1.32.0
 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
@@ -92,8 +92,12 @@ podojo projects create "Checkout Redesign" --brief "Q1 usability study"
 podojo interviews upload session-03.mp4 --project "Checkout Redesign"
 podojo transcripts list "Checkout Redesign"
 podojo transcripts download "Checkout Redesign" <batch-id> -o transcript.txt
+podojo transcripts download "Checkout Redesign" --all -o transcripts/
 ```
 
+`--all` saves one `<name> - <batch-id>.txt` per interview, so each file carries
+its batch ID for showreel clips.
+
 ### Videos & showreels
 
 ```bash
@@ -120,6 +124,7 @@ podojo usertests create -f my-test.yaml
 podojo usertests list
 podojo usertests get checkout-usability-v1
 podojo usertests update checkout-usability-v1 -f changes.yaml
+podojo usertests status checkout-usability-v1   # responses and how full each answer quota is (--json for scripts)
 podojo usertests delete checkout-usability-v1
 podojo usertests snippet                  # recording snippet: two script tags + recorder.js
 ```

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/README.md

@@ -60,8 +60,12 @@ podojo projects create "Checkout Redesign" --brief "Q1 usability study"
 podojo interviews upload session-03.mp4 --project "Checkout Redesign"
 podojo transcripts list "Checkout Redesign"
 podojo transcripts download "Checkout Redesign" <batch-id> -o transcript.txt
+podojo transcripts download "Checkout Redesign" --all -o transcripts/
 ```
 
+`--all` saves one `<name> - <batch-id>.txt` per interview, so each file carries
+its batch ID for showreel clips.
+
 ### Videos & showreels
 
 ```bash
@@ -88,6 +92,7 @@ podojo usertests create -f my-test.yaml
 podojo usertests list
 podojo usertests get checkout-usability-v1
 podojo usertests update checkout-usability-v1 -f changes.yaml
+podojo usertests status checkout-usability-v1   # responses and how full each answer quota is (--json for scripts)
 podojo usertests delete checkout-usability-v1
 podojo usertests snippet                  # recording snippet: two script tags + recorder.js
 ```

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/pyproject.toml

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

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/src/podojo_cli/commands/aiinterviews.py

@@ -8,6 +8,7 @@ from rich.table import Table
 
 from ..client import PodojoClient
 from ..config import load_config
+from ..tables import print_table
 
 app = typer.Typer(help="Manage AI voice interviews")
 console = Console()
@@ -436,7 +437,7 @@ def list_ai_interviews(
         return
 
     table = Table(title="AI Interviews")
-    table.add_column("Interview ID")
+    table.add_column("Interview ID", no_wrap=True)
     table.add_column("Title")
     table.add_column("Language")
     table.add_column("Questions", justify="right")
@@ -459,7 +460,7 @@ def list_ai_interviews(
             s.get("last_updated", ""),
         )
 
-    console.print(table)
+    print_table(console, table)
 
 
 @app.command("get")

podojo_cli-1.32.0/src/podojo_cli/commands/transcripts.py

@@ -0,0 +1,105 @@
+import re
+from datetime import datetime
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ..client import PodojoClient
+from ..tables import print_table
+
+app = typer.Typer(help="Manage transcripts")
+console = Console()
+
+
+def _format_date(value) -> str:
+    if not value:
+        return ""
+    try:
+        return datetime.fromisoformat(value.replace("Z", "+00:00")).strftime("%Y-%m-%d %H:%M")
+    except (ValueError, AttributeError):
+        return str(value)
+
+
+def _filename(interview: dict) -> str:
+    """Name plus batch ID, so a file maps back to its batch ID without a
+    lookup. Characters file systems reject become "_"."""
+    batch_id = interview["batch_id"]
+    name = re.sub(r'[\x00-\x1f/\\:*?"<>|]', "_", (interview.get("batch_name") or "").strip())
+    return f"{name} - {batch_id}.txt" if name else f"{batch_id}.txt"
+
+
+@app.command("list")
+def list_transcripts(project: str = typer.Argument(help="Project name")):
+    """List transcripts for a project."""
+    client = PodojoClient()
+    data = client.list_transcripts(project)
+
+    table = Table(title=f"Transcripts — {project} ({data['total']} total)")
+    table.add_column("Date")
+    table.add_column("Batch ID", no_wrap=True)
+    table.add_column("Name")
+
+    for t in data["interviews"]:
+        table.add_row(
+            _format_date(t.get("date")),
+            t.get("batch_id", ""),
+            t.get("batch_name", ""),
+        )
+
+    print_table(console, table)
+
+
+def _download_all(client: PodojoClient, project: str, folder: Path) -> None:
+    data = client.list_transcripts(project)
+    interviews = data["interviews"]
+    folder.mkdir(parents=True, exist_ok=True)
+
+    missing = []
+    for interview in interviews:
+        text = client.download_transcript(project, interview["batch_id"])
+        if not text.strip():
+            missing.append(interview.get("batch_name") or interview["batch_id"])
+            continue
+        path = folder / _filename(interview)
+        path.write_text(text, encoding="utf-8")
+        console.print(f"Saved {path}", soft_wrap=True, markup=False)
+
+    console.print(
+        f"Downloaded {len(interviews) - len(missing)} transcripts to {folder}",
+        soft_wrap=True,
+        markup=False,
+    )
+    if missing:
+        console.print(f"No transcript yet: {', '.join(missing)}", soft_wrap=True, markup=False)
+    if data["total"] > len(interviews):
+        console.print(f"Only the newest {len(interviews)} of {data['total']} interviews were downloaded.")
+
+
+@app.command("download")
+def download_transcript(
+    project: str = typer.Argument(help="Project name"),
+    batch_id: str = typer.Argument(None, help="Batch ID (leave out with --all)"),
+    all_: bool = typer.Option(False, "--all", help="Download every transcript in the project"),
+    output: Path = typer.Option(
+        None, "-o", "--output", help="Output file path, or the folder for --all (default: current folder)"
+    ),
+):
+    """Download a transcript, or all of a project's transcripts with --all."""
+    if bool(batch_id) == all_:
+        console.print("[red]Error:[/red] Pass either a batch ID or --all.")
+        raise typer.Exit(1)
+
+    client = PodojoClient()
+    if all_:
+        _download_all(client, project, output or Path("."))
+        return
+
+    text = client.download_transcript(project, batch_id)
+
+    if output:
+        output.write_text(text, encoding="utf-8")
+        console.print(f"Saved to {output}")
+    else:
+        console.print(text)

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/src/podojo_cli/commands/usertests.py

@@ -1,3 +1,4 @@
+import json
 from pathlib import Path
 
 import httpx
@@ -7,6 +8,7 @@ from rich.console import Console
 from rich.table import Table
 
 from ..client import PodojoClient
+from ..tables import print_table
 
 app = typer.Typer(help="Manage unmoderated user tests")
 console = Console()
@@ -69,6 +71,13 @@ EXAMPLE_YAML = """\
 #   options         (required, at least 2) each with `text`; `qualifies: true`
 #                   marks the accepted answers of a screener question and is
 #                   ignored on plain closed questions
+#   quota           (optional, on an option) how many completed sessions you
+#                   want from participants who pick it; once it's full, new
+#                   participants who pick it are turned away. Single-select
+#                   only, and on a screener only with `qualifies: true`. The
+#                   test goes off live when every option that lets people
+#                   through on one question is full. `podojo usertests status`
+#                   shows how full each quota is.
 
 usertest_id: checkout-usability-v1
 title: Checkout Flow Usability Test
@@ -125,7 +134,9 @@ screening_questions:
       - text: Rarely or never
       - text: A few times a year
       - text: At least once a month
+        quota: 10
       - text: Weekly or more
+        quota: 10
 
   - text: Have you abandoned an online purchase at checkout in the past 3 months?
     screener: true
@@ -301,6 +312,12 @@ def validate_usertest_data(data: dict) -> list[str]:
                     errors.append(f"Screening question {i}: 'options' must list at least 2 options")
                     continue
                 qualifying = 0
+                if multi_select is True and any(
+                    isinstance(o, dict) and o.get("quota") is not None for o in options
+                ):
+                    errors.append(
+                        f"Screening question {i}: 'quota' isn't supported on multi_select questions"
+                    )
                 for j, option in enumerate(options, 1):
                     if not isinstance(option, dict) or "text" not in option:
                         errors.append(
@@ -314,6 +331,18 @@ def validate_usertest_data(data: dict) -> list[str]:
                         )
                     elif qualifies:
                         qualifying += 1
+                    quota = option.get("quota")
+                    if quota is None or multi_select is True:
+                        continue
+                    if not isinstance(quota, int) or isinstance(quota, bool) or quota < 1:
+                        errors.append(
+                            f"Screening question {i}, option {j}: 'quota' must be a positive integer"
+                        )
+                    elif screener and qualifies is not True:
+                        errors.append(
+                            f"Screening question {i}, option {j}: 'quota' only works on "
+                            "options with 'qualifies: true'"
+                        )
                 if screener and qualifying == 0:
                     errors.append(
                         f"Screening question {i}: needs at least one option with 'qualifies: true'"
@@ -423,7 +452,7 @@ def list_usertests(
         return
 
     table = Table(title="User Tests")
-    table.add_column("User Test ID")
+    table.add_column("User Test ID", no_wrap=True)
     table.add_column("Title")
     table.add_column("Steps", justify="right")
     table.add_column("Live")
@@ -444,7 +473,7 @@ def list_usertests(
             s.get("last_updated", ""),
         )
 
-    console.print(table)
+    print_table(console, table)
 
 
 @app.command("get")
@@ -465,7 +494,7 @@ def get_usertest(
     # Remove server-managed fields for a clean editable output
     group = usertest.pop("group", "")
     response_count = usertest.pop("response_count", 0) or 0
-    for key in ("id", "created_at", "created_by", "last_updated"):
+    for key in ("quota_counts", "id", "created_at", "created_by", "last_updated"):
         usertest.pop(key, None)
 
     # Plain stdout, so `get > file.yaml` round-trips: rich would hard-wrap long
@@ -481,6 +510,104 @@ def get_usertest(
         err_console.print(f"Live:    https://usertests.podojo.com/{group}?test={usertest_id}")
 
 
+def _quota_status(usertest: dict) -> dict:
+    """Work out each quota's fill level and why a closed test closed."""
+    counts = usertest.get("quota_counts") or []
+    quotas = []
+    closed_question = None
+    for qi, question in enumerate(usertest.get("screening_questions") or []):
+        if question.get("multi_select"):
+            continue
+        screener = question.get("screener", False)
+        question_counts = counts[qi] if qi < len(counts) else []
+        passing = []
+        for oi, option in enumerate(question.get("options") or []):
+            if screener and not option.get("qualifies"):
+                continue
+            count = question_counts[oi] if oi < len(question_counts) else 0
+            quota = option.get("quota")
+            passing.append(
+                {
+                    "text": option["text"],
+                    "count": count,
+                    "quota": quota,
+                    "full": quota is not None and count >= quota,
+                    "left": None if quota is None else max(quota - count, 0),
+                }
+            )
+        if not any(o["quota"] is not None for o in passing):
+            continue
+        quotas.append({"question": question["text"], "options": passing})
+        if closed_question is None and all(o["full"] for o in passing):
+            closed_question = question["text"]
+
+    live = bool(usertest.get("live"))
+    max_responses = usertest.get("max_responses")
+    response_count = usertest.get("response_count") or 0
+    closed_reason = None
+    if not live:
+        if closed_question is not None:
+            closed_reason = f'every answer to "{closed_question}" is full'
+        elif max_responses and response_count >= max_responses:
+            closed_reason = "max responses reached"
+    return {
+        "usertest_id": usertest.get("usertest_id"),
+        "title": usertest.get("title"),
+        "live": live,
+        "response_count": response_count,
+        "max_responses": max_responses,
+        "closed_reason": closed_reason,
+        "quotas": quotas,
+    }
+
+
+@app.command("status")
+def usertest_status(
+    usertest_id: str = typer.Argument(help="User test ID to check"),
+    as_json: bool = typer.Option(False, "--json", help="Output as JSON"),
+):
+    """Show how far a user test is: responses and how full each quota is."""
+    client = PodojoClient()
+    try:
+        usertest = client.get_usertest(usertest_id)
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 404:
+            console.print(f"[red]Error:[/red] User test '{usertest_id}' not found")
+        else:
+            console.print(f"[red]Error:[/red] {_format_api_error(e)}")
+        raise typer.Exit(1)
+
+    status = _quota_status(usertest)
+    if as_json:
+        typer.echo(json.dumps(status, indent=2, ensure_ascii=False))
+        return
+
+    typer.echo(f"{status['title']} · {'Live' if status['live'] else 'Not live'}")
+    if status["closed_reason"]:
+        typer.echo(f"Closed automatically: {status['closed_reason']}")
+    if status["max_responses"]:
+        typer.echo(f"Responses: {status['response_count']} / {status['max_responses']}")
+    else:
+        typer.echo(f"Responses: {status['response_count']}")
+    all_options = [o for q in status["quotas"] for o in q["options"]]
+    if all_options:
+        typer.echo("")
+    text_width = max((len(o["text"]) for o in all_options), default=0)
+    count_width = max((len(str(o["count"])) for o in all_options), default=0)
+    quota_width = max((len(str(o["quota"])) for o in all_options if o["quota"]), default=0)
+    for quota in status["quotas"]:
+        typer.echo(quota["question"])
+        for o in quota["options"]:
+            progress = f"{o['count']:>{count_width}}"
+            if o["quota"] is None:
+                note = "no limit"
+                progress = f"{progress}   {'':>{quota_width}}"
+            else:
+                progress = f"{progress} / {o['quota']:>{quota_width}}"
+                note = "full" if o["full"] else f"{o['left']} left"
+            typer.echo(f"  {o['text']:<{text_width}}  {progress}  {note}")
+
+
 @app.command("create")
 def create_usertest(
     from_file: Path = typer.Option(..., "--from-file", "-f", help="YAML file with user test config"),

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/src/podojo_cli/commands/videos.py

@@ -8,6 +8,7 @@ from rich.progress import Progress
 from rich.table import Table
 
 from ..client import PodojoClient
+from ..tables import print_table
 
 app = typer.Typer(help="Manage videos")
 console = Console()
@@ -32,7 +33,7 @@ def list_videos(project: str = typer.Argument(help="Project name")):
 
     table = Table(title=f"Videos — {project} ({data['total']} total)")
     table.add_column("Date")
-    table.add_column("Batch ID")
+    table.add_column("Batch ID", no_wrap=True)
     table.add_column("Name")
     table.add_column("Duration (min)")
 
@@ -44,7 +45,7 @@ def list_videos(project: str = typer.Argument(help="Project name")):
             str(v.get("duration_minutes", "")),
         )
 
-    console.print(table)
+    print_table(console, table)
 
 
 @app.command("download")

podojo_cli-1.32.0/src/podojo_cli/tables.py

@@ -0,0 +1,13 @@
+from rich.console import Console
+from rich.table import Table
+
+# Off a terminal (Claude Code, a pipe) Rich falls back to 80 columns and cuts
+# cells with "…", so agents end up guessing the rest of a batch ID. Tables
+# render at their natural width up to this one instead.
+OFF_TERMINAL_WIDTH = 200
+
+
+def print_table(console: Console, table: Table) -> None:
+    if not console.is_terminal:
+        console = Console(width=OFF_TERMINAL_WIDTH)
+    console.print(table)

podojo_cli-1.32.0/tests/test_transcripts.py

@@ -0,0 +1,97 @@
+from podojo_cli.main import app
+
+
+def test_list_transcripts(runner, httpx_mock):
+    httpx_mock.add_response(
+        method="GET",
+        url="http://test.local/api/v1/projects/Alpha/transcripts",
+        json={
+            "project": "Alpha",
+            "total": 2,
+            "interviews": [
+                {
+                    "batch_id": "batch-1",
+                    "batch_name": "session_1",
+                    "date": "2026-05-01T12:00:00",
+                },
+                {
+                    "batch_id": "batch-2",
+                    "batch_name": "session_2",
+                    "date": "2026-05-02T12:00:00",
+                },
+            ],
+        },
+    )
+
+    result = runner.invoke(app, ["transcripts", "list", "Alpha"])
+
+    assert result.exit_code == 0
+    assert "batch-1" in result.output
+    assert "session_2" in result.output
+
+
+BATCH_ID = "62d1b9bf-8f03-41d1-b5e0-d0c4bd0e7eb6"
+
+
+def test_list_transcripts_keeps_batch_ids_whole_off_terminal(runner, httpx_mock, monkeypatch):
+    monkeypatch.setenv("COLUMNS", "80")
+    httpx_mock.add_response(
+        method="GET",
+        url="http://test.local/api/v1/projects/Alpha/transcripts",
+        json={
+            "project": "Alpha",
+            "total": 1,
+            "interviews": [
+                {"batch_id": BATCH_ID, "batch_name": "RapidUsertest 32721 1 (3)", "date": "2026-09-17T14:10:00"},
+            ],
+        },
+    )
+
+    result = runner.invoke(app, ["transcripts", "list", "Alpha"])
+
+    assert result.exit_code == 0
+    assert BATCH_ID in result.output
+    assert "RapidUsertest 32721 1 (3)" in result.output
+
+
+def test_download_all_transcripts(runner, httpx_mock, tmp_path):
+    httpx_mock.add_response(
+        method="GET",
+        url="http://test.local/api/v1/projects/Alpha/transcripts",
+        json={
+            "project": "Alpha",
+            "total": 3,
+            "interviews": [
+                {"batch_id": BATCH_ID, "batch_name": "Session 1/2"},
+                {"batch_id": "batch-2", "batch_name": "[DE] session_2"},
+                {"batch_id": "batch-3", "batch_name": "session_3"},
+            ],
+        },
+    )
+    httpx_mock.add_response(
+        method="GET", url=f"http://test.local/api/v1/projects/Alpha/transcripts/{BATCH_ID}", text="Hello"
+    )
+    httpx_mock.add_response(
+        method="GET", url="http://test.local/api/v1/projects/Alpha/transcripts/batch-2", text="Hallo"
+    )
+    httpx_mock.add_response(
+        method="GET", url="http://test.local/api/v1/projects/Alpha/transcripts/batch-3", text=""
+    )
+    folder = tmp_path / "transcripts"
+
+    result = runner.invoke(app, ["transcripts", "download", "Alpha", "--all", "-o", str(folder)])
+
+    assert result.exit_code == 0
+    assert (folder / f"Session 1_2 - {BATCH_ID}.txt").read_text() == "Hello"
+    assert (folder / "[DE] session_2 - batch-2.txt").read_text() == "Hallo"
+    assert sorted(p.name for p in folder.iterdir()) == [f"Session 1_2 - {BATCH_ID}.txt", "[DE] session_2 - batch-2.txt"]
+    assert "Downloaded 2 transcripts" in result.output
+    assert "No transcript yet: session_3" in result.output
+
+
+def test_download_transcript_needs_batch_id_or_all(runner):
+    for args in (["Alpha"], ["Alpha", "batch-1", "--all"]):
+        result = runner.invoke(app, ["transcripts", "download", *args])
+
+        assert result.exit_code == 1
+        assert "Pass either a batch ID or --all" in result.output

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/tests/test_usertests.py

@@ -1,3 +1,5 @@
+import json
+
 import yaml
 
 from podojo_cli.main import app
@@ -799,3 +801,254 @@ def test_example_template_validates(runner, tmp_path):
 
     assert "variant: ai-question" in example.output
     assert result.exit_code == 0
+
+
+def _quota_yaml(question: str) -> str:
+    return VALID_USERTEST_YAML + "screening_questions:\n" + question
+
+
+def test_validate_quota_valid(runner, tmp_path):
+    yaml_file = tmp_path / "usertest.yaml"
+    yaml_file.write_text(
+        _quota_yaml(
+            "  - text: How long?\n"
+            "    options:\n"
+            "      - text: Short\n"
+            "        quota: 5\n"
+            "      - text: Long\n"
+            "        quota: null\n"
+            "  - text: Abandoned a purchase?\n"
+            "    screener: true\n"
+            "    options:\n"
+            "      - text: \"Yes\"\n"
+            "        qualifies: true\n"
+            "        quota: 10\n"
+            "      - text: \"No\"\n"
+        )
+    )
+
+    result = runner.invoke(app, ["usertests", "validate", str(yaml_file)])
+
+    assert result.exit_code == 0
+    assert "Valid user test config" in result.output
+
+
+def test_validate_quota_must_be_a_positive_integer(runner, tmp_path):
+    for bad in ("0", "-2", "1.5", "true", "many"):
+        yaml_file = tmp_path / "usertest.yaml"
+        yaml_file.write_text(
+            _quota_yaml(
+                "  - text: How long?\n"
+                "    options:\n"
+                "      - text: Short\n"
+                f"        quota: {bad}\n"
+                "      - text: Long\n"
+            )
+        )
+
+        result = runner.invoke(app, ["usertests", "validate", str(yaml_file)])
+
+        assert result.exit_code == 1, bad
+        assert "Screening question 1, option 1: 'quota' must be a positive integer" in result.output
+
+
+def test_validate_quota_rejected_on_multi_select(runner, tmp_path):
+    yaml_file = tmp_path / "usertest.yaml"
+    yaml_file.write_text(
+        _quota_yaml(
+            "  - text: Which devices?\n"
+            "    multi_select: true\n"
+            "    options:\n"
+            "      - text: Phone\n"
+            "        quota: 5\n"
+            "      - text: Laptop\n"
+            "        quota: 5\n"
+        )
+    )
+
+    result = runner.invoke(app, ["usertests", "validate", str(yaml_file)])
+
+    assert result.exit_code == 1
+    assert result.output.count("'quota' isn't supported on multi_select questions") == 1
+    assert "Screening question 1: 'quota' isn't supported on multi_select questions" in result.output
+
+
+def test_validate_quota_on_screener_needs_qualifying_option(runner, tmp_path):
+    yaml_file = tmp_path / "usertest.yaml"
+    yaml_file.write_text(
+        _quota_yaml(
+            "  - text: Abandoned a purchase?\n"
+            "    screener: true\n"
+            "    options:\n"
+            "      - text: \"Yes\"\n"
+            "        qualifies: true\n"
+            "      - text: \"No\"\n"
+            "        quota: 3\n"
+        )
+    )
+
+    result = runner.invoke(app, ["usertests", "validate", str(yaml_file)])
+
+    assert result.exit_code == 1
+    assert "Screening question 1, option 2: 'quota' only works on" in result.output
+    assert "'qualifies: true'" in result.output
+
+
+def test_get_usertest_drops_quota_counts(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/usertests/ut-1",
+        json={**GET_RESPONSE, "quota_counts": [[1, 2]]},
+    )
+
+    result = runner.invoke(app, ["usertests", "get", "ut-1"])
+
+    assert result.exit_code == 0
+    assert "quota_counts" not in result.stdout
+
+
+STATUS_RESPONSE = {
+    **GET_RESPONSE,
+    "title": "Customer onboarding test",
+    "live": True,
+    "max_responses": None,
+    "response_count": 12,
+    "screening_questions": [
+        {
+            "text": "How long have you been a customer?",
+            "options": [
+                {"text": "Less than 1 year", "quota": 5},
+                {"text": "1–3 years", "quota": 5},
+                {"text": "More than 3 years", "quota": 5},
+            ],
+        },
+        {"text": "Plain question?", "options": [{"text": "A"}, {"text": "B"}]},
+        {
+            "text": "Are you a buyer?",
+            "screener": True,
+            "options": [
+                {"text": "Yes", "qualifies": True, "quota": 10},
+                {"text": "Sometimes", "qualifies": True},
+                {"text": "No"},
+            ],
+        },
+    ],
+    "quota_counts": [[5, 3, 4], [0, 0], [2, 6, 9]],
+}
+
+
+def test_status_live_with_quotas(runner, httpx_mock):
+    httpx_mock.add_response(url="http://test.local/api/v1/usertests/ut-1", json=STATUS_RESPONSE)
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    assert result.exit_code == 0
+    assert result.stdout == (
+        "Customer onboarding test · Live\n"
+        "Responses: 12\n"
+        "\n"
+        "How long have you been a customer?\n"
+        "  Less than 1 year   5 /  5  full\n"
+        "  1–3 years          3 /  5  2 left\n"
+        "  More than 3 years  4 /  5  1 left\n"
+        "Are you a buyer?\n"
+        "  Yes                2 / 10  8 left\n"
+        "  Sometimes          6       no limit\n"
+    )
+
+
+def test_status_closed_by_full_question(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/usertests/ut-1",
+        json={
+            **STATUS_RESPONSE,
+            "live": False,
+            "max_responses": 50,
+            "quota_counts": [[5, 5, 5], [0, 0], [0, 0, 0]],
+        },
+    )
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    lines = result.stdout.splitlines()
+    assert lines[0] == "Customer onboarding test · Not live"
+    assert lines[1] == 'Closed automatically: every answer to "How long have you been a customer?" is full'
+    assert lines[2] == "Responses: 12 / 50"
+
+
+def test_status_closed_by_max_responses(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/usertests/ut-1",
+        json={**STATUS_RESPONSE, "live": False, "max_responses": 12},
+    )
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    assert "Closed automatically: max responses reached" in result.stdout
+    assert "Responses: 12 / 12" in result.stdout
+
+
+def test_status_not_live_without_a_reason(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/usertests/ut-1",
+        json={**STATUS_RESPONSE, "live": False},
+    )
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    assert "Not live" in result.stdout
+    assert "Closed automatically" not in result.stdout
+
+
+def test_status_without_quotas(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/usertests/ut-1",
+        json={**GET_RESPONSE, "title": "Plain", "live": True, "max_responses": None},
+    )
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    assert result.exit_code == 0
+    assert result.stdout == "Plain · Live\nResponses: 7\n"
+
+
+def test_status_missing_quota_counts_means_zeros(runner, httpx_mock):
+    data = {k: v for k, v in STATUS_RESPONSE.items() if k != "quota_counts"}
+    httpx_mock.add_response(url="http://test.local/api/v1/usertests/ut-1", json=data)
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1"])
+
+    assert result.exit_code == 0
+    assert "  Less than 1 year   0 /  5  5 left" in result.stdout
+
+
+def test_status_json(runner, httpx_mock):
+    httpx_mock.add_response(url="http://test.local/api/v1/usertests/ut-1", json=STATUS_RESPONSE)
+
+    result = runner.invoke(app, ["usertests", "status", "ut-1", "--json"])
+
+    assert result.exit_code == 0
+    data = json.loads(result.stdout)
+    assert data["usertest_id"] == "ut-1"
+    assert data["live"] is True
+    assert data["response_count"] == 12
+    assert data["max_responses"] is None
+    assert data["closed_reason"] is None
+    assert [q["question"] for q in data["quotas"]] == [
+        "How long have you been a customer?",
+        "Are you a buyer?",
+    ]
+    assert data["quotas"][0]["options"][0] == {
+        "text": "Less than 1 year", "count": 5, "quota": 5, "full": True, "left": 0,
+    }
+    assert data["quotas"][1]["options"][1] == {
+        "text": "Sometimes", "count": 6, "quota": None, "full": False, "left": None,
+    }
+
+
+def test_status_not_found(runner, httpx_mock):
+    httpx_mock.add_response(url="http://test.local/api/v1/usertests/nope", status_code=404)
+
+    result = runner.invoke(app, ["usertests", "status", "nope"])
+
+    assert result.exit_code == 1
+    assert "User test 'nope' not found" in result.output

podojo_cli-1.32.0/tests/test_videos.py

@@ -0,0 +1,28 @@
+from podojo_cli.main import app
+
+
+def test_list_videos_keeps_batch_ids_whole_off_terminal(runner, httpx_mock, monkeypatch):
+    monkeypatch.setenv("COLUMNS", "80")
+    batch_id = "62d1b9bf-8f03-41d1-b5e0-d0c4bd0e7eb6"
+    httpx_mock.add_response(
+        method="GET",
+        url="http://test.local/api/v1/projects/Alpha/videos",
+        json={
+            "project": "Alpha",
+            "total": 1,
+            "videos": [
+                {
+                    "batch_id": batch_id,
+                    "batch_name": "RapidUsertest 32721 1 (3)",
+                    "batch_timestamp": "2026-09-17T14:10:00",
+                    "duration_minutes": 12.4,
+                },
+            ],
+        },
+    )
+
+    result = runner.invoke(app, ["videos", "list", "Alpha"])
+
+    assert result.exit_code == 0
+    assert batch_id in result.output
+    assert "RapidUsertest 32721 1 (3)" in result.output

{podojo_cli-1.30.0 → podojo_cli-1.32.0}/uv.lock

@@ -438,7 +438,7 @@ wheels = [
 
 [[package]]
 name = "podojo-cli"
-version = "1.30.0"
+version = "1.32.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

podojo_cli-1.30.0/src/podojo_cli/commands/transcripts.py

@@ -1,58 +0,0 @@
-from datetime import datetime
-from pathlib import Path
-
-import typer
-from rich.console import Console
-from rich.table import Table
-
-from ..client import PodojoClient
-
-app = typer.Typer(help="Manage transcripts")
-console = Console()
-
-
-def _format_date(value) -> str:
-    if not value:
-        return ""
-    try:
-        return datetime.fromisoformat(value.replace("Z", "+00:00")).strftime("%Y-%m-%d %H:%M")
-    except (ValueError, AttributeError):
-        return str(value)
-
-
-@app.command("list")
-def list_transcripts(project: str = typer.Argument(help="Project name")):
-    """List transcripts for a project."""
-    client = PodojoClient()
-    data = client.list_transcripts(project)
-
-    table = Table(title=f"Transcripts — {project} ({data['total']} total)")
-    table.add_column("Date")
-    table.add_column("Batch ID")
-    table.add_column("Name")
-
-    for t in data["interviews"]:
-        table.add_row(
-            _format_date(t.get("date")),
-            t.get("batch_id", ""),
-            t.get("batch_name", ""),
-        )
-
-    console.print(table)
-
-
-@app.command("download")
-def download_transcript(
-    project: str = typer.Argument(help="Project name"),
-    batch_id: str = typer.Argument(help="Batch ID"),
-    output: Path = typer.Option(None, "-o", "--output", help="Output file path"),
-):
-    """Download a transcript."""
-    client = PodojoClient()
-    text = client.download_transcript(project, batch_id)
-
-    if output:
-        output.write_text(text, encoding="utf-8")
-        console.print(f"Saved to {output}")
-    else:
-        console.print(text)

podojo_cli-1.30.0/tests/test_transcripts.py

@@ -1,30 +0,0 @@
-from podojo_cli.main import app
-
-
-def test_list_transcripts(runner, httpx_mock):
-    httpx_mock.add_response(
-        method="GET",
-        url="http://test.local/api/v1/projects/Alpha/transcripts",
-        json={
-            "project": "Alpha",
-            "total": 2,
-            "interviews": [
-                {
-                    "batch_id": "batch-1",
-                    "batch_name": "session_1",
-                    "date": "2026-05-01T12:00:00",
-                },
-                {
-                    "batch_id": "batch-2",
-                    "batch_name": "session_2",
-                    "date": "2026-05-02T12:00:00",
-                },
-            ],
-        },
-    )
-
-    result = runner.invoke(app, ["transcripts", "list", "Alpha"])
-
-    assert result.exit_code == 0
-    assert "batch-1" in result.output
-    assert "session_2" in result.output