Thistle fluency practice loop

# Clinician Onboarding — Thistle v1.1 Closed Beta

Welcome to the Thistle v1.1 closed beta. This page is your one-link onboarding: what

v1.1 includes, how to access it, the session → review workflow, and the privacy,

consent, and feedback expectations for the beta cycle.

Framing. Thistle is a practice-tool for speech patterns. It records phonation

interval (PI) streams, attributes them to words, and shows a session timeline for

clinician review. It makes no medical or treatment claims and is not a diagnostic

or therapeutic device. The v1.1 closed beta is a usability and workflow pilot with

real SLP clinicians.

## What v1.1 includes

- Practice loop (WP-12): reading-passage library, session recording via the PI

stream, baseline capture/freeze, session history, PI-distribution chart, progress

vs. the Section 4.2 targets, and a clinician-export HTML report.

- PI pipeline (WP-06): the MPI phonation-interval detection pipeline with the

per-client shortest-quintile baseline threshold.

- Forced alignment + per-word attribution (WP-13): sessions can be aligned to

the passage (wav2vec2 CTC) and PI events attributed to specific words.

- Clinician review console (WP-14): the queue of sessions with their recordings,

automated scores, the clinician's review form (naturalness, decision

advance/hold/other, notes), and elapsed review time.

- i18n catalog (THI-138): every user-facing string resolves through the message

catalog; English is the shipped locale for v1.1.

## How to access the app

- The beta server runs locally (`python3 -m wp12.server --port 8765`) and binds to

127.0.0.1 only — it is not published to a public URL during this cycle.

- Open `http://127.0.0.1:8765` for the practice loop and `http://127.0.0.1:8765/console`

for the clinician review console.

- Beta pages: `/beta` (intake), `/beta/feedback` (end-of-cycle survey),

`/beta/dashboard` + `/api/beta/report.json` (beta report, for the project team).

- No account is required in v1.1; the beta signup records your application so the team

can contact you with next steps.

## Hardware kit note

- The beta is optimized for a quiet room and a decent microphone. **Real-time throat

contact-mic capture is not part of v1.1** — sessions are recorded by feeding the

PI stream (JSON) produced by the WP-06 detector into the app, and audio can be

uploaded as WAV for alignment and console playback.

- Alignment is validated on clean/synthetic speech; dysfluent-speech validation needs

real stuttered samples and is pending (a known limitation, not a surprise).

## The session → review workflow

1. Record a baseline session (passage + PI stream) and freeze it.

2. Record practice sessions over the cycle.

3. Optionally align a session to attribute PIs to specific words.

4. In the console, open each session, listen/read, and complete the review form:

naturalness rating, decision (advance / hold / other), and notes.

5. Review time is tracked per session (start → submit) as the payment input.

## Consent and privacy (the compact)

- The signup records your consent: *"I agree my feedback and de-identified usage data

may be used to improve Thistle."* No application is processed without it, and it is

enforced on the server, not just the form.

- Only clinician contact + feedback fields are stored by the beta module. **No voice

or recording data** is touched by the beta tooling; recordings live under the

session store with per-session consent per the existing design.

- The beta dashboard/report shows real counts of sessions, PIs, reviews, and

feedback — nothing is fabricated.

- The beta server is bound to 127.0.0.1 and never published publicly until an auth

seam exists; if that ever changes it requires a separate consent + PII review.

## Feedback channels

- Standing channel: comment directly on your issue/beta thread at any time during

the cycle (friction, wins, questions).

- End-of-cycle survey: `/beta/feedback` — the structured survey (overall rating,

console usefulness, loop usefulness, likelihood to recommend, daily fit, biggest

win, biggest friction, most-wanted feature, privacy model) plus free-text notes.

## Beta-cycle dates

- Setup: days 1–5 (this package).

- Live beta: 2 weeks.

- Feedback compile: 2 days after the live window closes.