@harness-lab/cli 0.2.4 → 0.2.7

package/README.md

@@ -121,10 +121,10 @@ Workshop commands:
 harness auth status
 harness skill install
 harness workshop status
-harness workshop create-instance developer-hackathon-praha-24-4-saturn --event-title "Developer Hackathon Praha"
-harness workshop update-instance developer-hackathon-praha-24-4-saturn --room-name Saturn
-harness workshop prepare developer-hackathon-praha-24-4-saturn
-harness workshop remove-instance developer-hackathon-praha-24-4-saturn
+harness workshop create-instance sample-workshop-demo-orbit --event-title "Sample Workshop Demo"
+harness workshop update-instance sample-workshop-demo-orbit --room-name Orbit
+harness workshop prepare sample-workshop-demo-orbit
+harness workshop remove-instance sample-workshop-demo-orbit
 harness workshop phase set rotation
 harness workshop archive --notes "Manual archive"
 harness auth logout

package/assets/workshop-bundle/SKILL.md

@@ -18,7 +18,7 @@ allowed-tools:
 
 # Workshop
 
-Participant-facing skill for the Harness Lab workshop. Command semantics stay in English, but participant-facing delivery should follow the active workshop `contentLang` when live runtime data is available and fall back to the best reviewed bundled locale otherwise.
+Participant-facing skill for the Harness Lab workshop. Command semantics stay in English, but participant-facing delivery should follow the active workshop `contentLang` when live runtime data is available and otherwise resolve to a reviewed fallback locale instead of inheriting the raw language of whichever supporting doc was opened first.
 
 ## Purpose
 
@@ -27,12 +27,26 @@ This skill is the primary workshop interface for participants in Codex or pi. It
 The portable install path should make this skill usable from the participant's real working repo without requiring a clone of the Harness Lab source repo.
 
 Core mental model:
-- dashboard participant surface = orientace během dne
-- dashboard facilitator surface = řízení workshop instance
-- workshop skill = AI interface ke stejnému workshop systému
-- workshop blueprint = veřejná kanonická definice workshop method
-- `uiLang` = jazyk product chrome
-- `contentLang` = jazyk workshopového obsahu pro participant-facing delivery
+- dashboard participant surface = orientation during the day
+- dashboard facilitator surface = control of the workshop instance
+- workshop skill = AI interface to the same workshop system
+- workshop blueprint = public canonical definition of the workshop method
+- `uiLang` = language of product chrome
+- `contentLang` = language of workshop content for participant-facing delivery
+
+## Language Resolution
+
+Command semantics stay in English. Resolve the response language in this order:
+
+1. If live workshop data provides `contentLang` and the command is participant-facing workshop delivery, use that locale.
+2. Otherwise, match the user's current language when it maps to a reviewed locale in the repo or bundle.
+3. If there is no clear live or user-language signal, default bundled fallback delivery to English (`en`).
+
+Additional rules:
+- facilitator-control commands are operational rather than room-facing delivery, so prefer the user's current language unless the facilitator explicitly asks for another reviewed locale or you are quoting workshop content
+- the authored language of a supporting doc does not decide the reply language by itself
+- if the requested locale has no reviewed variant, fall back to English and say so explicitly
+- do not let a Czech-authored fallback file force a Czech answer when the resolved response locale is English
 
 ## Sources Of Truth
 
@@ -56,8 +70,8 @@ Rule:
 - if runtime is unavailable, fall back to repo material and say explicitly that the answer is fallback rather than live state
 - runtime edits do not imply blueprint edits; reusable changes belong back in the repo deliberately
 - prefer workshop `contentLang` for participant-facing responses in live mode
-- if there is no live workshop context, prefer the best reviewed bundled locale and say when the answer is fallback content rather than live workshop state
-- for bundled fallback docs, resolve `workshop-skill/locales/<locale>/...` first; if a reviewed localized doc does not exist yet, fall back to the best reviewed bundled locale and say so explicitly
+- if there is no live workshop context, resolve the fallback locale using the Language Resolution rules above and say when the answer is fallback content rather than live workshop state
+- for bundled fallback docs, resolve `workshop-skill/locales/<locale>/...` first; if a reviewed localized doc does not exist yet, fall back to English and say so explicitly
 - do not translate workshop copy ad hoc when a reviewed locale exists in the repo or bundle
 
 ## Commands
@@ -235,6 +249,12 @@ Prefer invoking `harness workshop update-instance` over raw API scripts.
 Use this when the facilitator wants to correct or refine date, venue, room, address, or event title without resetting the instance.
 Support `contentLang` changes explicitly so facilitators can choose workshop delivery language per instance without changing admin UI language.
 
+### `workshop facilitator reset-instance <instance-id>`
+
+Reset one existing workshop instance from the selected blueprint template. Requires facilitator session.
+Prefer invoking `harness workshop reset-instance` over raw API scripts.
+Use this when the facilitator wants fresh canonical agenda, runner, and presenter content for a live instance and accepts that local runtime state will be reinitialized.
+
 ### `workshop facilitator remove-instance`
 
 Remove a workshop instance from the active list without deleting its archive history. Requires facilitator session.
@@ -253,6 +273,13 @@ Inspect and edit the local agenda copy for one workshop instance. Requires facil
 
 Inspect and edit presenter scenes for one workshop instance. This includes listing scenes for an agenda item, creating a new scene, editing content, changing default scene, reordering scenes, and enabling or hiding scenes. Requires facilitator session.
 
+Rules for rich scenes:
+- keep scenes agenda-linked and room-facing rather than inventing a freeform slide deck
+- prefer one dominant voice per scene and one main idea per scene
+- use reviewed local blueprint assets for reusable visuals instead of ad hoc remote image URLs
+- treat runtime scene edits as instance-local until a maintainer deliberately publishes them back into the repo
+- when richer scene authoring or promotion is involved, follow `docs/presenter-rich-scene-authoring.md`
+
 ### `workshop facilitator archive`
 
 Archive the current workshop instance with optional notes.
@@ -297,7 +324,8 @@ Relevant local files:
 ## Style
 
 - Be concise and directive.
-- Use Czech for explanations.
+- Use the resolved response language.
+- English is the default bundled fallback locale when no live or user-language signal overrides it.
 - Keep command names, file names, and code terms in English.
 - Prefer actionable next steps over theory during build phases.
 - Treat tests and executable checks as the default trust boundary once the agent is doing meaningful implementation work.

package/assets/workshop-bundle/bundle-manifest.json

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.2.4",
-  "contentHash": "9e57d44e4a3f9296f4913cd51eefbf9dff7d6d9da8d4afb1ae5a2ce2a7dc4323",
+  "bundleVersion": "0.2.7",
+  "contentHash": "db5557fe004d30755c4912015667daf2095c70081780f8a3418bd772e2fb9a49",
   "files": [
     {
       "path": "content/challenge-cards/.gitkeep",
@@ -34,7 +34,7 @@
     },
     {
       "path": "content/facilitation/master-guide.md",
-      "sha256": "e22f4a811459be1fe23412e7d85c02fe20170e6e6c8534fc97c1616f65b2cfd8"
+      "sha256": "f0edc5eef8c7bc0efc67672e184edecce46fa5fd5e9820cfda0b28fbb8cb1a8f"
     },
     {
       "path": "content/project-briefs/.gitkeep",
@@ -98,11 +98,11 @@
     },
     {
       "path": "content/talks/context-is-king.md",
-      "sha256": "c380947051f4a66cdf47e846d5cc5d60ace0487f75dbc718b03fb7164cb94ef1"
+      "sha256": "4d0972fefac067de0b8803698b44bdf8ab0bee64b181d50d1ac5e26a92eb7089"
     },
     {
       "path": "docs/harness-cli-foundation.md",
-      "sha256": "65b0b2cee7be792ad03f9be794230298d3efe8283e8e73acb033ef401d204e51"
+      "sha256": "80b321da32d110f141e1bd6a089ccc84f2a04066d76ba0258f530cc333dbaae4"
     },
     {
       "path": "docs/learner-reference-gallery.md",
@@ -134,7 +134,7 @@
     },
     {
       "path": "SKILL.md",
-      "sha256": "b25a7730eb123edd941bcb176bd861ad209868189601c49845d1b6892f689647"
+      "sha256": "64ddc1bf36265ea8321b2634d34499e83a8c1692e5cb10c6f30b1b07f1d51975"
     },
     {
       "path": "workshop-blueprint/agenda.json",
@@ -146,7 +146,7 @@
     },
     {
       "path": "workshop-blueprint/day-structure.md",
-      "sha256": "2d2c7a43e959059fe5d3dbb2aae20e6828fee40c700729080677c2c7b6feb0dc"
+      "sha256": "4980768b9e8b71d47cec19764b317d99c830908a0298c6f104e8d7bd37320966"
     },
     {
       "path": "workshop-blueprint/edit-boundaries.md",
@@ -182,7 +182,7 @@
     },
     {
       "path": "workshop-skill/facilitator.md",
-      "sha256": "39dcb46914f19b66fd270627f42702b1f394ceb05dd0f3cf1f0c514becb6dca1"
+      "sha256": "ab4721564c1dee2a24c7d4dfda229c2cfa56f5bec89a8b3580b541d9baa13e7f"
     },
     {
       "path": "workshop-skill/follow-up-package.md",

package/assets/workshop-bundle/content/facilitation/master-guide.md

@@ -4,19 +4,55 @@
 
 ### Cíl
 
-Nastavit energii dne a jasně pojmenovat, o čem workshop je.
+Spustit den jako room-facing launch pro celý workshop, ne jako provozní brief k dopoledni.
 
 ### Klíčová message
 
-> „Dnes nejde o to být nejrychlejší. Jde o to předat práci tak, aby ji cizí tým dokázal převzít a posunout dál.“
+> „Dnes nejde o to být nejrychlejší. Jde o to postavit práci tak, aby ji cizí tým dokázal převzít a posunout dál.“
 
 ### Co potřebuje zaznít
 
-- Nejde o soutěž v promptování.
+- Nezačínáme tool demo ani soutěž v promptování.
+- Budeme se učit, stavět, předávat i přebírat. Ten oblouk dne je záměr workshopu.
 - Jde o práci s agentem tak, aby po vás zůstával použitelný kontext.
 - Odpolední část prověří, jestli repo opravdu unese převzetí dalším týmem.
 - Pokud nějaké důležité pravidlo žije jen v hovoru u stolu, ještě neexistuje.
 
+### Doporučený sled beatů
+
+1. day-opening promise
+2. proč na tom záleží právě teď
+3. analogie typu Lego duck: stejné ingredience, různé použitelné výsledky
+4. krátká pohybová aktivace podle zkušenosti s AI agenty
+5. první pracovní kontrakt pro Build fázi 1
+
+### Lego-duck analogie
+
+Použijte ji krátce a věcně.
+
+Pointa:
+
+- stejný agent neznamená stejný výsledek
+- kvalitu neurčuje samotný model
+- kontext, mantinely a ověřování jsou součást výsledku
+
+Nevést jako zábavnou odbočku. Vést jako vysvětlení, proč je harness engineering tvůrčí a inženýrská disciplína zároveň.
+
+### Pohybová aktivace
+
+Použijte krátké rozdělení místnosti podle aktuální zkušenosti s AI agenty:
+
+- používám skoro denně
+- používám, ale opatrně
+- jsem spíš na startu
+- jsem skeptický, ale chci důkaz
+
+Pravidla:
+
+- ne dělat z toho networking kolo
+- stačí přesun a 2 krátké hlasy
+- pointa není seniorita, ale kalibrace místnosti a signál, že den je participativní
+
 ### Co má facilitátor průběžně vracet
 
 - „Kde by to našel další tým bez vás?“
@@ -24,6 +60,61 @@ Nastavit energii dne a jasně pojmenovat, o čem workshop je.
 - „Je `AGENTS.md` mapa, nebo už se z něj stává dump?“
 - „Jaký je další bezpečný krok pro cizího člověka nebo agenta?“
 
+### První pracovní kontrakt
+
+Po launchi potřebuje místnost ještě jednu konkrétní věc:
+
+- co má být po prvním build bloku opravdu vidět
+- co nestačí jen slíbit
+
+Do oběda má být vidět:
+
+- repo a `README`, které dávají smysl cizímu člověku
+- `AGENTS.md` jako krátká mapa
+- plan nebo jasně vedená implementační stopa
+- první explicitní check před dalším generováním
+
+## Context is King talk
+
+### Cíl
+
+Proměnit energii z openingu v přesnou tezi a čistý most do Build fáze 1.
+
+### Klíčová message
+
+> „Kontext je páka, ne kosmetika.“
+
+### Co potřebuje zaznít
+
+- Neučíme se lépe promptovat. Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
+- `AGENTS.md`, skills, runbooky a checks jsou týmová infrastruktura, ne polish navíc.
+- Team lead nestojí modelu za zády a nediktuje další větu každých třicet sekund.
+- Po talku se tým vrací k repu s mapou, planem a prvním checkem, ne s lovem na chytřejší prompt.
+
+### Mikro-cvičení
+
+Použijte stejný malý task ve dvou podmínkách:
+
+1. prompt blob
+2. krátké zadání s `Goal`, `Context`, `Constraints`, `Done When`
+
+Nenechte to sklouznout do debaty o tom, který model je chytřejší.
+
+Pointa:
+
+- přenos záměru
+- přenos mantinelů
+- přenos done criteria
+
+### Most do Build fáze 1
+
+Na konci talku má být jasné:
+
+- teorie tím končí
+- tým se vrací k repu
+- nejdřív vzniká mapa a první explicitní check
+- teprve potom dává smysl další feature motion
+
 ## Build fáze 1
 
 ### Viditelný milestone board

package/assets/workshop-bundle/content/talks/context-is-king.md

@@ -1,8 +1,14 @@
 # Context is King
 
-## Otevírací moment
+## Otevírací modul
 
-Tento workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
+Tenhle workshop skill i dashboard vznikly stejným způsobem, jakým dnes budeme pracovat my: s AI agentem, ale s důrazem na kontext. Nejde mi o prodej nástroje. Jde mi o to ukázat disciplínu, která z nástroje dělá použitelného spolupracovníka.
+
+Rámec pro room launch:
+
+- dnes nezačínáme tool demo ani soutěž v promptování
+- budeme se učit, stavět, předávat i přebírat
+- odpoledne se ukáže, co z práce přežije bez nás
 
 ## Klíčová linka
 
@@ -12,9 +18,26 @@ Moje hlavní věta pro dnešek:
 
 > Neučíme se "lépe promptovat". Učíme se postavit repo a workflow, ve kterém agent i cizí tým dokážou bezpečně pokračovat.
 
+## Analogický beat
+
+Když dáte lidem stejné kostky, nevznikne jedna správná kachna. Stejně tak ze stejného modelu nevzniká jedna správná práce. Rozdíl nedělá jen model. Rozdíl dělá kontext, mantinely, ověřování a představivost týmu.
+
+Pointa analogie:
+
+- stejný agent neznamená stejný výsledek
+- kvalitu neurčuje samotný model
+- pracovní systém kolem agenta je součást výsledku
+
 ## Mikro-cvičení
 
-Všichni dostanou stejný malý úkol. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a kritéria hotovo i do dalšího kroku.
+Všichni dostanou stejný malý task. Jedna varianta bude prompt blob. Druhá varianta bude krátké zadání se 4 prvky a s odkazem na kontext zapsaný v repu. Pak porovnáme výsledky. Nehledáme „nejhezčí prompt“. Hledáme způsob práce, který přenese záměr, omezení a done criteria i do dalšího kroku.
+
+4 prvky pro druhou variantu:
+
+- Goal
+- Context
+- Constraints
+- Done When
 
 ## Hlavní teze
 
@@ -37,6 +60,15 @@ Všichni dostanou stejný malý úkol. Jedna varianta bude prompt blob. Druhá v
 - Když agent dělá víc, já musím lépe ověřovat.
 - Handoff není závěr dne. Je to průběžná podmínka celé práce.
 
+## Most do Build fáze 1
+
+Po tomhle talku se tým nemá vracet k repu s pocitem, že potřebuje jen chytřejší prompt. Má se vracet s jedním jasným očekáváním:
+
+- nejdřív krátká mapa v repu
+- potom plan
+- potom první explicitní check
+- teprve potom další feature motion
+
 ## Závěr
 
 Odpoledne nezažijete jen to, že „AI někdy funguje a někdy ne“. Zažijete, jak moc výsledek závisí na kvalitě pracovního systému, který kolem agenta postavíte.

package/assets/workshop-bundle/docs/harness-cli-foundation.md

@@ -8,7 +8,7 @@ Current implementation in this repo:
 
 - lives in the repository `harness-cli/` package and ships publicly as `@harness-lab/cli`
 - distributes a portable participant workshop skill bundle through `harness skill install`
-- covers `auth login/logout/status` plus `workshop status/create-instance/update-instance/prepare/remove-instance/archive/phase set`
+- covers `auth login/logout/status` plus `workshop status/create-instance/update-instance/reset-instance/prepare/remove-instance/archive/phase set`
 - targets the existing shared dashboard facilitator APIs
 - is tested for browser/device auth, local-dev Basic Auth fallback, and cookie-backed Neon bootstrap fallback
 - stores sessions in a local file under `HARNESS_CLI_HOME` or `~/.harness` by default
@@ -41,6 +41,7 @@ Required commands:
 - `harness workshop status`
 - `harness workshop create-instance`
 - `harness workshop update-instance`
+- `harness workshop reset-instance <instance-id>`
 - `harness workshop archive`
 - `harness workshop prepare`
 - `harness workshop remove-instance`
@@ -90,6 +91,7 @@ Current command posture:
 
 - explicit target required:
   - `harness workshop update-instance <instance-id>`
+  - `harness workshop reset-instance <instance-id>`
   - `harness workshop prepare <instance-id>`
   - `harness workshop remove-instance <instance-id>`
 - explicit target is the created resource:
@@ -115,6 +117,11 @@ Current step-up posture:
 - the existing CLI command set (`workshop status/archive/phase set`) may run on a valid brokered device session
 - future higher-risk commands such as facilitator grant/revoke or destructive instance mutations should require a fresh browser approval window rather than silently reusing an older CLI session
 
+Content refresh posture:
+
+- after changing authored participant-facing sources in `workshop-skill/`, `content/`, or `workshop-blueprint/`, refresh the portable bundle and verify it before shipping facilitator or participant guidance
+- when those changes must land in already-created workshop instances, `workshop reset-instance` is the intended re-import path
+
 ## Session Storage Posture
 
 Default storage backend:

package/assets/workshop-bundle/workshop-blueprint/day-structure.md

@@ -103,6 +103,31 @@ Habit installed:
 - cleanup and codification are part of delivery
 - repeated pain should become a better template, check, or runbook
 
+## Narrative Spine
+
+The day should not feel like separate agenda cards. Each phase should change what the room now understands and what it is ready to do next.
+
+- `opening`:
+  Shift the room from "AI hackathon energy" to "continuation-quality discipline." The key belief is that handoff without verbal rescue is part of the assignment from the first hour.
+- `talk`:
+  Shift the room from a vague sense that context matters to a precise thesis: harness engineering is team infrastructure, not prompt cosmetics.
+- `demo`:
+  Shift the room from abstract agreement to an observable workflow. The room should see context, plan, implementation, and review as one repeatable system.
+- `build-1`:
+  Shift teams from listening to evidence. Before lunch, the repo needs to show map, plan, one executable check, and one verified step.
+- `intermezzo-1`:
+  Shift from isolated table work to shared learning. The room should hear concrete repo signals, not generic progress reporting.
+- `lunch-reset`:
+  Shift from local progress to handoff readiness. Going to lunch without a readable next safe step should feel unfinished.
+- `rotation`:
+  Shift from authorship to inheritance. The receiving team must read first, diagnose second, and edit only after it can explain the state.
+- `build-2`:
+  Shift from frustration to codification. Weak continuation signals should turn into clearer repo guidance, stronger checks, and better runbooks.
+- `intermezzo-2`:
+  Shift from anecdotes about the afternoon to concrete continuation evidence. The room should identify which repo signals actually saved time.
+- `reveal`:
+  Shift from reflection to adoption. The close should turn signals from the day into next-week practice and into improvements to the reusable workshop blueprint.
+
 ## What Must Survive In The Repo
 
 - goal and constraints

package/assets/workshop-bundle/workshop-skill/facilitator.md

@@ -1,49 +1,49 @@
 # Facilitator Commands
 
-Příkazy pro facilitátory, kteří řídí workshop instance přes AI agenta.
+Commands for facilitators who manage workshop instances through an AI agent.
 
 ## Auth
 
-Facilitátor se musí nejdřív přihlásit přes `harness` CLI. Skill nemá být další secret store pro raw credentials ani dlouhodobou session.
+The facilitator must log in through the `harness` CLI first. The skill should not become another secret store for raw credentials or long-lived sessions.
 
 ### `/workshop facilitator login`
 
-Pokud není aktivní facilitátorská session, řekni facilitátorovi, aby spustil:
+If no facilitator session is active, tell the facilitator to run:
 
 ```bash
 harness auth login
 ```
 
-CLI provede browser/device auth flow, uloží session do lokálního file storage a zpřístupní ji pro další privileged příkazy.
+The CLI performs the browser/device auth flow, stores the session in local file storage, and exposes it to subsequent privileged commands.
 
 Model:
-- `harness auth login` autentizuje facilitátora vůči platformě
-- konkrétní workshop instance se vybírá až při operaci nebo přes default context
-- instance grant se vyhodnocuje při přístupu ke konkrétní akci, ne při samotném loginu
+- `harness auth login` authenticates the facilitator with the platform
+- the specific workshop instance is selected later per operation or via default context
+- the instance grant is evaluated when accessing a specific action, not during login itself
 
-Aktuální praktický path v repu:
+Current practical paths in this repo:
 
 - default / browser-device auth:
 ```bash
 harness auth login --dashboard-url https://harness-lab-dashboard.vercel.app
 ```
-- file mode / lokální demo fallback:
+- file mode / local demo fallback:
 ```bash
 harness auth login --auth basic --dashboard-url http://localhost:3000 --username facilitator --password secret
 ```
-- neon mode / sdílený dashboard bootstrap fallback:
+- neon mode / shared dashboard bootstrap fallback:
 ```bash
 harness auth login --auth neon --dashboard-url https://harness-lab-dashboard.vercel.app --email facilitator@example.com
 ```
 
-Poznámka:
-- CLI dnes defaultně používá browser/device auth a ukládá session do lokálního file storage
-- Pokud facilitátor chce OS-native storage, může použít `HARNESS_SESSION_STORAGE=keychain`, `credential-manager` nebo `secret-service`
-- `--auth basic` a `--auth neon` zůstávají jen jako explicitní fallback pro lokální dev/bootstrap
+Note:
+- the CLI currently defaults to browser/device auth and stores the session in local file storage
+- if the facilitator wants OS-native storage, they can use `HARNESS_SESSION_STORAGE=keychain`, `credential-manager`, or `secret-service`
+- `--auth basic` and `--auth neon` remain explicit fallbacks for local dev/bootstrap
 
 ### `/workshop facilitator logout`
 
-Požádej o:
+Ask the facilitator to run:
 
 ```bash
 harness auth logout
@@ -53,23 +53,23 @@ harness auth logout
 
 ### `/workshop facilitator status`
 
-Preferovaný path:
+Preferred path:
 
 ```bash
 harness workshop status
 ```
 
-Zobraz:
-- aktivní instanci a její stav
-- aktuální fázi
-- seznam facilitátorů s rolemi
-- počet týmů
+Show:
+- active instance and its status
+- current phase
+- facilitator list with roles
+- team count
 
 ### `/workshop facilitator grant <email> <role>`
 
-Použij CLI-backed privileged request path. Skill nemá řešit auth bootstrap sám.
+Use the CLI-backed privileged request path. The skill should not handle auth bootstrap itself.
 
-API capability zůstává:
+The API capability remains:
 
 ```http
 POST {DASHBOARD_URL}/api/admin/facilitators
@@ -78,78 +78,79 @@ Content-Type: application/json
 { "email": "...", "role": "operator" }
 ```
 
-Vyžaduje `owner` roli. Vrací info o novém grantu.
+Requires `owner` role. Returns the new grant info.
 
 ### `/workshop facilitator revoke <email>`
 
-Nejdřív zavolej `GET /api/admin/facilitators` a najdi grant podle emailu.
-Pak:
-```
+Call `GET /api/admin/facilitators` first and find the grant by email.
+Then call:
+
+```http
 DELETE {DASHBOARD_URL}/api/admin/facilitators/{grantId}
 ```
 
-Vyžaduje `owner` roli.
+Requires `owner` role.
 
 ### `/workshop facilitator create-instance`
 
-Preferovaný path je CLI příkaz nad sdíleným runtime API:
+The preferred path is a CLI command over the shared runtime API:
 
 ```bash
-harness workshop create-instance developer-hackathon-praha-24-4-saturn \
+harness workshop create-instance sample-workshop-demo-orbit \
   --template-id blueprint-default \
-  --content-lang cs \
-  --event-title "Developer Hackathon Praha" \
-  --city Praha \
-  --date-range "24. dubna 2026" \
-  --venue-name "Seyfor Praha jednička 103" \
-  --room-name Saturn \
-  --address-line "CZ, Praha 8, Sokolovska 695/115b" \
-  --location-details "17 osob + lektor" \
-  --facilitator-label Ondrej
+  --content-lang en \
+  --event-title "Sample Workshop Demo" \
+  --city "Example City" \
+  --date-range "June 15, 2026" \
+  --venue-name "Example Campus North" \
+  --room-name Orbit \
+  --address-line "Example Avenue 123" \
+  --location-details "12 participants + facilitator" \
+  --facilitator-label Alex
 ```
 
-Raw API reference zůstává jen jako diagnostická nebo architektonická reference:
+The raw API reference remains diagnostic or architectural reference only:
 
 ```http
 POST {DASHBOARD_URL}/api/workshop/instances
 Content-Type: application/json
 
 {
-  "id": "developer-hackathon-praha-24-4-saturn",
+  "id": "sample-workshop-demo-orbit",
   "templateId": "blueprint-default",
-  "contentLang": "cs",
-  "eventTitle": "Developer Hackathon Praha",
-  "city": "Praha",
-  "dateRange": "24. dubna 2026",
-  "venueName": "Seyfor Praha jednička 103",
-  "roomName": "Saturn",
-  "addressLine": "CZ, Praha 8, Sokolovska 695/115b",
-  "locationDetails": "17 osob + lektor",
-  "facilitatorLabel": "Ondrej"
+  "contentLang": "en",
+  "eventTitle": "Sample Workshop Demo",
+  "city": "Example City",
+  "dateRange": "June 15, 2026",
+  "venueName": "Example Campus North",
+  "roomName": "Orbit",
+  "addressLine": "Example Avenue 123",
+  "locationDetails": "12 participants + facilitator",
+  "facilitatorLabel": "Alex"
 }
 ```
 
-Poznámky pro skill:
-- skill má preferovat CLI, ne ručně skládané `fetch` skripty
-- `id` musí být lowercase slug s písmeny, čísly a pomlčkami
-- `contentLang` určuje jazyk workshopového obsahu pro dashboard, presenter a skill delivery; není to totéž jako UI language
-- když skill volá create opakovaně se stejným `id`, route vrací `created: false` a existující instance record
-- nehádej venue metadata zkráceně, když je facilitátor zná; pošli je rovnou při create
+Notes for the skill:
+- prefer the CLI, not hand-written `fetch` scripts
+- `id` must be a lowercase slug with letters, numbers, and hyphens
+- `contentLang` controls workshop-content language for dashboard, presenter, and skill delivery; it is not the same as UI language
+- when the skill calls create repeatedly with the same `id`, the route returns `created: false` and the existing instance record
+- do not guess venue metadata in abbreviated form if the facilitator already knows it; send it during create
 
 ### `/workshop facilitator update-instance <instance-id>`
 
-Preferovaný path:
+Preferred path:
 
 ```bash
-harness workshop update-instance developer-hackathon-praha-24-4-saturn \
+harness workshop update-instance sample-workshop-demo-orbit \
   --content-lang en \
-  --event-title "Developer Hackathon Praha" \
-  --date-range "24. dubna 2026" \
-  --venue-name "Seyfor Praha jednička 103" \
-  --room-name Saturn \
-  --address-line "CZ, Praha 8, Sokolovska 695/115b" \
-  --location-details "17 osob + lektor" \
-  --facilitator-label Ondrej
+  --event-title "Sample Workshop Demo" \
+  --date-range "June 15, 2026" \
+  --venue-name "Example Campus North" \
+  --room-name Orbit \
+  --address-line "Example Avenue 123" \
+  --location-details "12 participants + facilitator" \
+  --facilitator-label Alex
 ```
 
 Raw API reference:
@@ -161,27 +162,53 @@ Content-Type: application/json
 {
   "action": "update_metadata",
   "contentLang": "en",
-  "eventTitle": "Developer Hackathon Praha",
-  "dateRange": "24. dubna 2026",
-  "venueName": "Seyfor Praha jednička 103",
-  "roomName": "Saturn",
-  "addressLine": "CZ, Praha 8, Sokolovska 695/115b",
-  "locationDetails": "17 osob + lektor",
-  "facilitatorLabel": "Ondrej"
+  "eventTitle": "Sample Workshop Demo",
+  "dateRange": "June 15, 2026",
+  "venueName": "Example Campus North",
+  "roomName": "Orbit",
+  "addressLine": "Example Avenue 123",
+  "locationDetails": "12 participants + facilitator",
+  "facilitatorLabel": "Alex"
+}
+```
+
+Rules:
+- send only the fields you want to change
+- do not use reset for an ordinary title, venue, or room correction
+- if the route returns `400`, the payload is wrong; if it returns `404`, the instance does not exist
+
+### `/workshop facilitator reset-instance <instance-id>`
+
+Preferred path:
+
+```bash
+harness workshop reset-instance sample-workshop-demo-orbit --template-id blueprint-default
+```
+
+Raw API reference:
+
+```http
+PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+Content-Type: application/json
+
+{
+  "action": "reset",
+  "templateId": "blueprint-default"
 }
 ```
 
-Pravidla:
-- pošli jen fieldy, které chceš změnit
-- nepoužívej reset pro obyčejnou opravu názvu, venue nebo room
-- když route vrátí `400`, payload je špatně; když vrátí `404`, instance neexistuje
+Rules:
+- use this when the goal is to re-import fresh blueprint-owned workshop content into an existing instance
+- warn that reset archives current runtime state first and then clears live runtime state for the instance
+- prefer `update-instance` for ordinary metadata corrections; reset is the high-impact operation
+- if the facilitator does not specify a template, keep the current template unless there is a clear reason to switch
 
 ### `/workshop facilitator prepare`
 
-Preferovaný path:
+Preferred path:
 
 ```bash
-harness workshop prepare developer-hackathon-praha-24-4-saturn
+harness workshop prepare sample-workshop-demo-orbit
 ```
 
 Raw API reference:
@@ -190,17 +217,17 @@ Raw API reference:
 POST {DASHBOARD_URL}/api/workshop
 Content-Type: application/json
 
-{ "action": "prepare", "instanceId": "developer-hackathon-praha-24-4-saturn" }
+{ "action": "prepare", "instanceId": "sample-workshop-demo-orbit" }
 ```
 
-Nastaví instanci do stavu `prepared`, ověří event code.
+This sets the instance to `prepared` state and verifies the event code.
 
 ### `/workshop facilitator remove-instance <instance-id>`
 
-Preferovaný path:
+Preferred path:
 
 ```bash
-harness workshop remove-instance developer-hackathon-praha-24-4-saturn
+harness workshop remove-instance sample-workshop-demo-orbit
 ```
 
 Raw API reference:
@@ -212,13 +239,13 @@ Content-Type: application/json
 { "action": "remove" }
 ```
 
-Pravidla:
-- remove zůstává owner-only operace
-- skill má facilitátora upozornit, že jde o destruktivní odebrání z aktivního seznamu, ne o běžnou editaci metadata
+Rules:
+- remove remains an owner-only operation
+- the skill should warn the facilitator that this is destructive removal from the active list, not routine metadata editing
 
 ### `/workshop facilitator agenda`
 
-Lokální editace agendy pro konkrétní instanci používá instanční route:
+Local agenda editing for a specific instance uses the per-instance route:
 
 ```http
 GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
@@ -227,7 +254,7 @@ POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
 DELETE {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
 ```
 
-Příklady:
+Examples:
 
 ```http
 PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/agenda
@@ -269,28 +296,36 @@ Content-Type: application/json
 }
 ```
 
-Pravidla:
+Rules:
 
-- agenda item je facilitátorský pack, ne jen `title/time/description`
-- preferované fieldy jsou `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`
-- `description` zůstává compatibility field pro starší surface; pro room-facing shrnutí preferuj `roomSummary`
-- používej kanonická agenda ids jako `opening`, `talk`, `demo`, `build-1`, `intermezzo-1`, `rotation`, `build-2`, `intermezzo-2`, `reveal`
-- skill nemá vymýšlet vlastní názvy workshop momentů mimo tuto kostru
+- an agenda item is a facilitator pack, not just `title/time/description`
+- preferred fields are `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, and `checkpointQuestions`
+- `description` remains a compatibility field for older surfaces; prefer `roomSummary` for room-facing summaries
+- use canonical agenda ids such as `opening`, `talk`, `demo`, `build-1`, `intermezzo-1`, `rotation`, `build-2`, `intermezzo-2`, and `reveal`
+- the skill should not invent custom workshop moment names outside this skeleton
 
 ### `/workshop facilitator scenes`
 
-Presenter scenes jsou agenda-linked room-facing výstupy pro facilitátora a projektor. Skill má umět:
+Presenter scenes are agenda-linked, room-facing outputs for the facilitator and projector. The skill should be able to:
+
+- list scenes for the whole instance or a specific agenda item
+- create a new scene
+- edit content, label, scene type, and CTA
+- change the default scene for a given agenda item
+- reorder scenes
+- hide or re-enable a scene
+- delete a local scene
+- read and optionally edit `facilitatorNotes`, `sourceRefs`, and `blocks`
+
+Rich-scene rules:
 
-- vypsat scény pro celou instanci nebo konkrétní agenda item
-- vytvořit novou scénu
-- upravit obsah, label, scene type a CTA
-- změnit default scénu pro danou agenda položku
-- přeuspořádat scény
-- skrýt nebo znovu povolit scénu
-- smazat lokální scénu
-- číst a případně upravit `facilitatorNotes`, `sourceRefs` a `blocks`
+- keep presenter scenes agenda-linked; do not invent a separate slide-deck source of truth
+- prefer one dominant voice and one main idea per scene
+- for reusable visuals, prefer reviewed local blueprint assets and metadata over ad hoc remote image URLs
+- runtime edits remain instance-local until a maintainer deliberately publishes them back into the repo
+- when working in the source repo, use the maintainer playbook in `docs/presenter-rich-scene-authoring.md` for drafting, refinement, and publish-back
 
-Instanční route:
+Per-instance route:
 
 ```http
 GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
@@ -300,7 +335,7 @@ PATCH {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
 DELETE {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
 ```
 
-Příklady:
+Examples:
 
 ```http
 POST {DASHBOARD_URL}/api/workshop/instances/{instanceId}/scenes
@@ -312,28 +347,28 @@ Content-Type: application/json
   "sceneType": "demo",
   "intent": "walkthrough",
   "chromePreset": "agenda",
-  "title": "Nejdřív bez kontextu, potom s mapou",
+  "title": "Context first, then motion",
   "facilitatorNotes": [
-    "Držte jednu story, ne přehlídku funkcí."
+    "Keep one story rather than a feature parade."
   ],
   "blocks": [
     {
       "id": "hero",
       "type": "hero",
-      "title": "Nejdřív bez kontextu, potom s mapou",
-      "body": "Ukažte rozdíl mezi prompt blobem a krátkou mapou zapsanou v repu."
+      "title": "Context first, then motion",
+      "body": "Show the difference between a prompt blob and a short map stored in the repo."
     },
     {
       "id": "questions",
       "type": "bullet-list",
-      "title": "Pointa",
+      "title": "Point",
       "items": [
-        "Co není v repu, neexistuje.",
-        "Kontext je páka, ne kosmetika."
+        "If it is not in the repo, it does not exist.",
+        "Context is leverage, not cosmetics."
       ]
     }
   ],
-  "ctaLabel": "Potom přepnout na participant walkthrough"
+  "ctaLabel": "Then switch to participant walkthrough"
 }
 ```
 
@@ -345,17 +380,17 @@ Content-Type: application/json
   "action": "update",
   "agendaItemId": "talk",
   "sceneId": "scene-123",
-  "label": "Upravený demo flow",
+  "label": "Updated demo flow",
   "sceneType": "demo",
   "intent": "walkthrough",
   "chromePreset": "agenda",
-  "title": "Jedna story, ne přehlídka funkcí",
+  "title": "One story, not a feature parade",
   "blocks": [
     {
       "id": "hero",
       "type": "hero",
-      "title": "Jedna story, ne přehlídka funkcí",
-      "body": "Neukazujte pět režimů práce. Ukažte jeden čitelný workflow."
+      "title": "One story, not a feature parade",
+      "body": "Do not show five working modes. Show one readable workflow."
     }
   ]
 }
@@ -389,22 +424,23 @@ Content-Type: application/json
 { "agendaItemId": "talk", "sceneId": "scene-123" }
 ```
 
-Když facilitátor chce změnit wording, flow nebo participant walkthrough přes coding agenta, preferuj tuto route místo ručního popisu změn v UI.
+When the facilitator wants to change wording, flow, or participant walkthrough through a coding agent, prefer this route instead of manually describing UI edits.
 
-Při práci přes API:
+During API work:
 
-- neznámé `agendaItemId` nebo `sceneId` vrací `404`
-- malformed payload pořád vrací `400`
-- skill má stale target ids hlásit explicitně, ne pokračovat jako by se změna povedla
-- room-facing obsah patří do `blocks`, facilitátorské pokyny do `facilitatorNotes`
-- `title/body` zůstávají kvůli compatibility, ale skill má preferovat strukturované `blocks`
-- když runtime agenda existuje, skill má číst a citovat její `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`, `facilitatorNotes` a `blocks`
-- když runtime data nejsou dostupná, fallbackni na blueprint a facilitační docs z repa a explicitně to řekni
+- unknown `agendaItemId` or `sceneId` returns `404`
+- malformed payload still returns `400`
+- the skill must report stale target ids explicitly rather than acting as if the change succeeded
+- room-facing content belongs in `blocks`, facilitator instructions in `facilitatorNotes`
+- `title/body` remain for compatibility, but the skill should prefer structured `blocks`
+- when runtime agenda exists, the skill should read and cite its `goal`, `roomSummary`, `facilitatorPrompts`, `watchFors`, `checkpointQuestions`, `facilitatorNotes`, and `blocks`
+- when runtime data is unavailable, fall back to the blueprint and facilitation docs in the repo and say so explicitly
 
 ### `/workshop facilitator archive`
 
-Zavolej:
-```
+Call:
+
+```http
 POST {DASHBOARD_URL}/api/workshop/archive
 Content-Type: application/json
 
@@ -413,14 +449,14 @@ Content-Type: application/json
 
 ## Environment
 
-Agent potřebuje vědět URL dashboardu:
-- `HARNESS_DASHBOARD_URL` — URL produkčního nebo preview dashboardu
-- Pokud není nastaveno, použij `https://harness-lab-dashboard.vercel.app`
+The agent needs to know the dashboard URL:
+- `HARNESS_DASHBOARD_URL` - the production or preview dashboard URL
+- if not set, use `https://harness-lab-dashboard.vercel.app`
 
-## Poznámky
+## Notes
 
-- Facilitátorské příkazy jsou oddělené od participant příkazů
-- `/workshop facilitator login` má facilitátora navést do `harness auth login`
-- Všechny ostatní privileged příkazy používají CLI-backed uloženou session
-- Pokud session expiruje, agent řekne facilitátorovi, aby se znovu přihlásil
-- Tyto příkazy nikdy nezobrazuj participant účastníkům
+- facilitator commands are separate from participant commands
+- `/workshop facilitator login` should steer the facilitator into `harness auth login`
+- all other privileged commands use the stored CLI-backed session
+- if the session expires, tell the facilitator to log in again
+- never surface these commands to participants

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@harness-lab/cli",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "description": "Participant-facing Harness Lab CLI for facilitator auth and workshop operations",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",

package/src/client.js

@@ -108,6 +108,15 @@ export function createHarnessClient({ fetchFn, session }) {
         body: { action: "update_metadata", ...input },
       });
     },
+    resetWorkshopInstance(instanceId, templateId) {
+      return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}`, {
+        method: "PATCH",
+        body: {
+          action: "reset",
+          ...(templateId ? { templateId } : {}),
+        },
+      });
+    },
     prepareWorkshopInstance(instanceId) {
       return request("/api/workshop", {
         method: "POST",

package/src/run-cli.js

@@ -178,6 +178,7 @@ function printUsage(io, ui) {
     "harness workshop archive [--notes TEXT]",
     "harness workshop create-instance [<instance-id>] [--template-id ID] [--event-title TEXT] [--city CITY]",
     "harness workshop update-instance <instance-id> [--event-title TEXT] [--city CITY]",
+    "harness workshop reset-instance <instance-id> [--template-id ID]",
     "harness workshop prepare <instance-id>",
     "harness workshop remove-instance <instance-id>",
     "harness workshop phase set <phase-id>",
@@ -731,6 +732,41 @@ async function handleWorkshopPrepare(io, ui, env, positionals, flags, deps) {
   }
 }
 
+async function handleWorkshopResetInstance(io, ui, env, positionals, flags, deps) {
+  const session = await requireSession(io, ui, env);
+  if (!session) {
+    return 1;
+  }
+
+  const instanceId = await readRequiredCommandValue(
+    io,
+    flags,
+    ["id", "instance-id"],
+    "Instance id: ",
+    readOptionalPositional(positionals, 2),
+  );
+  if (!instanceId) {
+    ui.status("error", "Instance id is required.", { stream: "stderr" });
+    return 1;
+  }
+
+  try {
+    const client = createHarnessClient({ fetchFn: deps.fetchFn, session });
+    const result = await client.resetWorkshopInstance(
+      instanceId,
+      readStringFlag(flags, "template-id", "template"),
+    );
+    ui.json("Workshop Reset Instance", result);
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `Reset instance failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
 async function handleWorkshopRemoveInstance(io, ui, env, positionals, flags, deps) {
   const session = await requireSession(io, ui, env);
   if (!session) {
@@ -856,6 +892,10 @@ export async function runCli(argv, io, deps = {}) {
     return handleWorkshopUpdateInstance(io, ui, io.env, positionals, flags, mergedDeps);
   }
 
+  if (scope === "workshop" && action === "reset-instance") {
+    return handleWorkshopResetInstance(io, ui, io.env, positionals, flags, mergedDeps);
+  }
+
   if (scope === "workshop" && action === "prepare") {
     return handleWorkshopPrepare(io, ui, io.env, positionals, flags, mergedDeps);
   }