usertold 1.19.0 → 1.20.0

package/README.md

@@ -7,19 +7,19 @@ UserTold.ai is the research layer for autonomous product systems:
 2. run real-time interviews while users are on your website
 3. extract signals
 4. create evidence-backed tasks
-5. measure impact after release
+5. review recurrence after completed work
 
 The CLI is the automation-first interface for CI pipelines, agent workflows, and scripted operations.
 
 ## What interviews look like
 
-UserTold.ai conducts real-time interviews while participants actively use your website. The AI operates in three adaptive modes:
+UserTold.ai conducts real-time interviews while participants actively use your website. The AI operates through scripted and planned research modes:
 
 - **Observe** — Watches silently while the participant navigates, clicks, and thinks aloud. No prompting, no interruption. Captures page changes, interaction events, and spoken thoughts via microphone.
 - **Speak** — Delivers one-way verbal guidance: task instructions, clarifications, a gentle nudge. Stops immediately if the participant starts speaking (barge-in).
 - **Talk** — Full two-way voice conversation via OpenAI Realtime (speech-to-speech). The AI asks follow-up questions, probes emotional moments, and explores unexpected insights in real time.
 
-Each study segment defines a base mode and a mode ceiling. The AI escalates automatically when it detects the participant is stuck — using heuristic checks (silence, confusion keywords, navigation loops) that fire in under a second without an API call. After the intervention it returns to the base mode automatically.
+Study segments advance through explicit rules: scripted speech completion, participant Done, URL or action matches, max duration, or the complete_segment tool in planned talk segments. Observe mode stays silent so pauses, confusion, repeated clicks, loops, and help requests remain evidence for debrief and post-session signal extraction.
 
 After each session, the platform extracts structured signals — struggling moments, desired outcomes, workarounds, behavioral context — each with a verbatim quote, confidence score, and a link back to the session recording and transcript timestamp. Signals cluster into tasks. Tasks push to GitHub Issues with evidence attached.
 
@@ -89,7 +89,6 @@ Exit codes: `0` success · `1` error · `2` bad args · `3` auth · `4` not foun
 - `task`
 - `screener`
 - `billing`
-- `overview`
 - `config`
 - `setup`
 - `init`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "usertold",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "UserTold.ai CLI",
   "license": "UNLICENSED",
   "type": "module",