@harness-lab/cli 0.2.6 → 0.2.7

package/assets/workshop-bundle/SKILL.md

@@ -249,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.
@@ -267,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.

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

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.2.6",
-  "contentHash": "9e7a3c6549f06cbe59278c731c73ae8c21f7e38cf82cbc533f1e708ccf47602c",
+  "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": "107f2ba2574d358ed2ccd1c669a47008574517b811475c866247b0199836ae5b"
+      "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": "22775cb783e825eeec83886932c801db1ff7e3617c170fee848b6071fa63d8a3"
+      "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

@@ -177,6 +177,32 @@ Rules:
 - 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"
+}
+```
+
+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`
 
 Preferred path:
@@ -291,6 +317,14 @@ Presenter scenes are agenda-linked, room-facing outputs for the facilitator and
 - delete a local scene
 - read and optionally edit `facilitatorNotes`, `sourceRefs`, and `blocks`
 
+Rich-scene rules:
+
+- 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
+
 Per-instance route:
 
 ```http

package/package.json

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

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);
   }