@harness-lab/cli 0.2.7 → 0.2.8

package/assets/workshop-bundle/SKILL.md

@@ -215,6 +215,18 @@ This is a facilitator-only command — do not surface to participants.
 Show the current instance state, agenda phase, facilitator list, and team count.
 Requires active facilitator session.
 
+### `workshop facilitator list-instances`
+
+List the facilitator-visible workshop instance registry.
+Prefer invoking `harness workshop list-instances` over raw API scripts or local session-file inspection.
+Use this when the facilitator needs to discover what currently exists on a shared dashboard before choosing an explicit instance for reset, update, or agenda work.
+
+### `workshop facilitator show-instance <instance-id>`
+
+Inspect one explicit workshop instance.
+Prefer invoking `harness workshop show-instance <instance-id>` over raw API scripts.
+Use this when the facilitator needs the full record for one instance rather than the deployment-default runtime status returned by `workshop facilitator status`.
+
 ### `workshop facilitator grant <email> <role>`
 
 Grant a Neon Auth user access to the current workshop instance.
@@ -249,6 +261,10 @@ 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.
 
+Facilitator discovery rule:
+- for routine discovery, use `harness workshop list-instances` and `harness workshop show-instance`
+- do not read local CLI session files or improvise authenticated `node -e` fetch scripts unless you are diagnosing the CLI itself
+
 ### `workshop facilitator reset-instance <instance-id>`
 
 Reset one existing workshop instance from the selected blueprint template. Requires facilitator session.

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

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.2.7",
-  "contentHash": "db5557fe004d30755c4912015667daf2095c70081780f8a3418bd772e2fb9a49",
+  "bundleVersion": "0.2.8",
+  "contentHash": "6194a59089ff94131b647282c1b5e7574a6a9d112c48b4b9d58b600f5775736a",
   "files": [
     {
       "path": "content/challenge-cards/.gitkeep",
@@ -42,7 +42,7 @@
     },
     {
       "path": "content/project-briefs/code-review-helper.md",
-      "sha256": "0d70c455d000ec8bc01337db5feee2174be8359730b5c278cccee9c3e6b0f2f7"
+      "sha256": "3e174ff0d097fe132088774042f9db58c9c2494613d66950bdd423116bd7986d"
     },
     {
       "path": "content/project-briefs/devtoolbox-cli.md",
@@ -102,7 +102,7 @@
     },
     {
       "path": "docs/harness-cli-foundation.md",
-      "sha256": "80b321da32d110f141e1bd6a089ccc84f2a04066d76ba0258f530cc333dbaae4"
+      "sha256": "f3b6125a4575c27dcb7b88474003f2a9b189a4b1b25bfaa462861571b69f7a51"
     },
     {
       "path": "docs/learner-reference-gallery.md",
@@ -134,11 +134,11 @@
     },
     {
       "path": "SKILL.md",
-      "sha256": "64ddc1bf36265ea8321b2634d34499e83a8c1692e5cb10c6f30b1b07f1d51975"
+      "sha256": "de24b73c431855143630f6d312d9bb2af0a16178c2c70f928c5c3a426e569777"
     },
     {
       "path": "workshop-blueprint/agenda.json",
-      "sha256": "6b8e1925e20fabccfd3cd9e9d79839855f51b2b7fd449efbb336bf3edd4eadce"
+      "sha256": "91b4037578ce61d172e09941089b97180322552cb42bb52de87b3956e60b1ed0"
     },
     {
       "path": "workshop-blueprint/control-surfaces.md",
@@ -146,7 +146,7 @@
     },
     {
       "path": "workshop-blueprint/day-structure.md",
-      "sha256": "4980768b9e8b71d47cec19764b317d99c830908a0298c6f104e8d7bd37320966"
+      "sha256": "ffecae258211cef2430112ca25e1ff59658cac729ea2a07b9cac48e9a2a6244e"
     },
     {
       "path": "workshop-blueprint/edit-boundaries.md",
@@ -158,7 +158,7 @@
     },
     {
       "path": "workshop-blueprint/README.md",
-      "sha256": "ae809a473bbc88411891044de7609fa053e66e370a8d4063e5d7b9e68179a98c"
+      "sha256": "badb477ecfef7df163ec41c72c39e04bcde2a5a723c1b01bf2e91ed38924e903"
     },
     {
       "path": "workshop-blueprint/teaching-spine.md",
@@ -182,7 +182,7 @@
     },
     {
       "path": "workshop-skill/facilitator.md",
-      "sha256": "ab4721564c1dee2a24c7d4dfda229c2cfa56f5bec89a8b3580b541d9baa13e7f"
+      "sha256": "f0e977df5979d0d218eabad026b66ecefa90802c71dc8a9468959334570f1c1c"
     },
     {
       "path": "workshop-skill/follow-up-package.md",

package/assets/workshop-bundle/content/project-briefs/code-review-helper.md

@@ -2,30 +2,30 @@
 
 ## Problém
 
-Code review bývá nevyrovnané. Některé změny projdou s dobrým checklistem a jasným popisem rizik, jiné bez společného rámce. Reviewer pak improvizuje, autor neví, co má ověřit předem, a tým ztrácí konzistenci.
+Code review bývá nevyrovnané. Některé změny projdou s dobrým checklistem a jasným popisem rizik, jiné bez společného rámce. Reviewer pak improvizuje, autor neví, co má ověřit předem, a tým ztrácí konzistenci právě tam, kde by měl být nejpřesnější.
 
-Vaším úkolem je navrhnout nástroj, který z diffu nebo změny vytvoří použitelný review checklist.
+Vaším úkolem je navrhnout nástroj, který z diffu nebo změny vytvoří použitelný review checklist a zároveň jasně oddělí jistotu, heuristiku a místa, kde je pořád potřeba lidský úsudek.
 
 ## User stories
 
-- Jako reviewer chci z diffu rychle získat checklist rizik, otázek a míst, na která se zaměřit.
-- Jako autor změny chci vědět, co mám zkontrolovat ještě před samotným review.
+- Jako reviewer chci z diffu rychle získat checklist změněných hranic, rizik, otázek a míst, na která se zaměřit.
+- Jako autor změny chci vědět, co mám ověřit ještě před samotným review.
 - Jako tým po rotaci chci navázat na heuristiky, které původní tým objevil, místo abych je znovu vymýšlel.
 
 ## Architektonické poznámky
 
-- Může jít o CLI, web nebo jednoduchý skript. Důležitý je jasný tok `diff → analýza → checklist`.
-- Musí být zřejmé, jaké vstupy nástroj očekává a co naopak neumí spolehlivě vyhodnotit.
-- Přidejte seed diff nebo `examples/`, aby šlo workflow lokálně ověřit.
-- Jasně oddělte heuristiku od jistoty. Nástroj má pomáhat reviewerovi, ne předstírat neomylnost.
+- Může jít o CLI, web nebo jednoduchý skript. Důležitý je jasný tok `diff → rubric → checklist`.
+- Musí být zřejmé, jaké vstupy nástroj očekává, co umí označit jistě a co naopak zůstává heuristické.
+- Přidejte seed diff nebo `examples/`, aby šlo workflow lokálně ověřit a další tým rychle přidal nové pravidlo.
+- Nástroj má pomáhat reviewerovi, ne předstírat neomylnost.
 
 ## Hotovo když
 
 - Nástroj vytvoří review checklist ze seed diffu.
-- Výstup odlišuje jistá zjištění od doporučení nebo hypotéz.
+- Výstup odlišuje jistá zjištění od doporučení, hypotéz a bodů pro lidský úsudek.
 - Je jasné, jak přidat nové pravidlo nebo heuristiku bez dlouhého onboardingu.
 - Další tým může během několika minut pokračovat v rozvoji bez chaosu.
 
 ## První krok pro agenta
 
-Nezačínej kódem. Nejdřív napiš pravidla review, tok vstupů a definici toho, co znamená dobrý checklist. Teprve potom navrhni první implementační slice.
+Nezačínej kódem. Nejdřív napiš review rubric, tok vstupů a definici toho, co znamená dobrý checklist. Ukaž, kde je jistota, kde heuristika a co musí posoudit člověk. Teprve potom navrhni první implementační slice.

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/reset-instance/prepare/remove-instance/archive/phase set`
+- covers `auth login/logout/status` plus `workshop status/list-instances/show-instance/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
@@ -39,6 +39,8 @@ Required commands:
 - `harness auth logout`
 - `harness auth status`
 - `harness workshop status`
+- `harness workshop list-instances`
+- `harness workshop show-instance <instance-id>`
 - `harness workshop create-instance`
 - `harness workshop update-instance`
 - `harness workshop reset-instance <instance-id>`
@@ -89,6 +91,10 @@ Current target-selection order:
 
 Current command posture:
 
+- explicit workspace-discovery commands:
+  - `harness workshop list-instances`
+- explicit target required:
+  - `harness workshop show-instance <instance-id>`
 - explicit target required:
   - `harness workshop update-instance <instance-id>`
   - `harness workshop reset-instance <instance-id>`
@@ -105,6 +111,7 @@ Current discoverability path:
 
 - facilitators can inspect available workshop instances through the dashboard workspace view
 - the same platform-scoped list lives behind the authenticated instances API surface at `/api/workshop/instances`
+- the CLI should expose that list directly so facilitator skills do not need session-file inspection or raw authenticated scripts for routine discovery
 
 For the current facilitator lifecycle slice:
 

package/assets/workshop-bundle/workshop-blueprint/README.md

@@ -39,7 +39,7 @@ Do not use this folder for live event state. Real dates, rooms, rosters, checkpo
 ### Structured data
 
 - [`agenda.json`](agenda.json)
-  Public-readable workshop agenda summary and workshop metadata.
+  Public-readable 10-phase mirror of the workshop day and workshop metadata.
 
 ## Related Runtime Documents
 
@@ -51,5 +51,6 @@ For maintainers working in the source repository, the runtime-facing structured
 
 - `docs/workshop-content-language-architecture.md`
 - `dashboard/lib/workshop-blueprint-agenda.json`
+- `dashboard/lib/workshop-blueprint-localized-content.ts`
 
-Treat those as maintainer/source-repo references, not as portable participant-bundle docs.
+Treat those as maintainer/source-repo references, not as portable participant-bundle docs. The public `agenda.json` file should stay aligned with the same phase structure, but it is not the runtime import source.

package/assets/workshop-bundle/workshop-blueprint/agenda.json

@@ -1,21 +1,23 @@
 {
-  "version": 1,
+  "version": 2,
   "blueprintId": "harness-lab-core-day",
   "title": "Harness Lab",
-  "subtitle": "Workshop operating system pro práci s AI agenty",
+  "subtitle": "Public-readable 10-phase mirror of the Harness Lab workshop day",
+  "presentationMode": "public-readable-mirror",
+  "sourceNote": "Runtime imports come from dashboard/lib/workshop-blueprint-agenda.json plus dashboard/lib/workshop-blueprint-localized-content.ts.",
   "principles": [
-    "Mapa před pohybem",
-    "Ověření je hranice důvěry",
-    "Pište tak, aby další tým mohl pokračovat"
+    "Context before generation",
+    "Verification is the trust boundary",
+    "Work so another team can continue"
   ],
   "phases": [
     {
       "id": "opening",
       "order": 1,
-      "label": "Úvod a naladění",
+      "label": "Opening and framing",
       "startTime": "09:10",
       "kind": "shared",
-      "goal": "Rámec dne: nejde o promptování, ale o repo a workflow, které přežijí handoff."
+      "goal": "Shift the room from prompt-hackathon expectations to continuation-quality discipline."
     },
     {
       "id": "talk",
@@ -23,31 +25,71 @@
       "label": "Context is King",
       "startTime": "09:40",
       "kind": "shared",
-      "goal": "Krátký talk a porovnání přístupů. Krátká mapa v repu je silnější než prompt blob."
+      "goal": "Turn context into a precise thesis: AGENTS.md, plans, and checks are working infrastructure, not polish."
     },
     {
-      "id": "build-1",
+      "id": "demo",
       "order": 3,
+      "label": "Demo",
+      "startTime": "10:05",
+      "kind": "shared",
+      "goal": "Show one compact workflow story: context, planning, implementation, review, and safe fallback moves."
+    },
+    {
+      "id": "build-1",
+      "order": 4,
       "label": "Build Phase 1",
       "startTime": "10:30",
       "kind": "team",
-      "goal": "Nejdřív udělejte z repa operating surface: krátké AGENTS.md, plán, build/test flow, první ověření a první reviewed output."
+      "goal": "Before lunch, get every team to a navigable repo, AGENTS.md, a plan, one explicit check, and a first reviewed slice."
+    },
+    {
+      "id": "intermezzo-1",
+      "order": 5,
+      "label": "Intermezzo 1",
+      "startTime": "11:40",
+      "kind": "shared",
+      "goal": "Surface one change, one proof, and one next move from the room before lunch momentum slips."
+    },
+    {
+      "id": "lunch-reset",
+      "order": 6,
+      "label": "Lunch Reset",
+      "startTime": "12:15",
+      "kind": "shared",
+      "goal": "Frame lunch as a handoff preparation point, not as a pause between unrelated workshop blocks."
     },
     {
       "id": "rotation",
-      "order": 4,
-      "label": "Rotace týmů",
+      "order": 7,
+      "label": "Continuation Shift",
       "startTime": "13:30",
       "kind": "team",
-      "goal": "Plný přesun lidí mezi stoly. Nejdřív čtěte a napište diagnózu, až pak měňte kód."
+      "goal": "Force silent repo reading, diagnosis, and explicit continuation before anyone edits code."
+    },
+    {
+      "id": "build-2",
+      "order": 8,
+      "label": "Build Phase 2",
+      "startTime": "14:05",
+      "kind": "team",
+      "goal": "Turn continuation friction into better repo guidance, stronger checks, and clearer next moves."
+    },
+    {
+      "id": "intermezzo-2",
+      "order": 9,
+      "label": "Intermezzo 2",
+      "startTime": "15:05",
+      "kind": "shared",
+      "goal": "Name which repo signals actually saved time during continuation and which failures repeated."
     },
     {
       "id": "reveal",
-      "order": 5,
-      "label": "Reveal a reflexe",
+      "order": 10,
+      "label": "Reveal and reflection",
       "startTime": "15:45",
       "kind": "shared",
-      "goal": "Co pomohlo pokračovat, co chybělo, a kterou bolest teď proměníme v lepší harness."
+      "goal": "Turn the day into reusable practice: what helped continuation, what failed, and what should change next week."
     }
   ],
   "runtimeImport": {

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

@@ -147,8 +147,8 @@ The day should not feel like separate agenda cards. Each phase should change wha
 - `AGENTS.md` as a table of contents that points to deeper sources of truth
 - small, continuous garbage collection before bad patterns spread
 
-## Canonical Agenda Source
+## Agenda Mirror
 
-The reusable agenda lives in [`agenda.json`](agenda.json).
+The public-readable 10-phase mirror lives in [`agenda.json`](agenda.json).
 
-Runtime workshop instances import from that blueprint and then track live phase position, reveal state, teams, and checkpoints locally in the private runtime layer.
+Runtime workshop instances import from the maintained dashboard blueprint source pair and then track live phase position, reveal state, teams, and checkpoints locally in the private runtime layer.

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

@@ -65,6 +65,59 @@ Show:
 - facilitator list with roles
 - team count
 
+Use this for the current default or selected workshop context.
+If the facilitator needs the full workspace registry first, use `list-instances` instead of probing local session files or writing raw authenticated fetch scripts.
+
+### `/workshop facilitator list-instances`
+
+Preferred path:
+
+```bash
+harness workshop list-instances
+```
+
+Show:
+- facilitator-visible instance ids
+- template id
+- status
+- content language
+- event title and room metadata when present
+
+Raw API reference:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances
+```
+
+Rules:
+- prefer this over inspecting local session files or composing one-off authenticated scripts
+- use it when the facilitator needs to discover which live instances exist before reset, update, or scene work
+- keep raw API usage as a diagnostic fallback, not the default operator workflow
+
+### `/workshop facilitator show-instance <instance-id>`
+
+Preferred path:
+
+```bash
+harness workshop show-instance sample-workshop-demo-orbit
+```
+
+Show:
+- one explicit instance record
+- summary metadata for quick operator inspection
+- the full instance payload when the facilitator needs exact values before a mutation
+
+Raw API reference:
+
+```http
+GET {DASHBOARD_URL}/api/workshop/instances/{instanceId}
+```
+
+Rules:
+- use this when the facilitator needs one specific instance, not the deployment-default `workshop status`
+- if the route returns `404`, the instance does not exist or is not visible to the facilitator
+- prefer this over ad hoc authenticated scripts for routine discovery
+
 ### `/workshop facilitator grant <email> <role>`
 
 Use the CLI-backed privileged request path. The skill should not handle auth bootstrap itself.
@@ -176,6 +229,7 @@ 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
+- use `--content-lang cs|en` when the facilitator intends to change the workshop delivery language for that instance
 
 ### `/workshop facilitator reset-instance <instance-id>`
 

package/package.json

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

package/src/client.js

@@ -90,6 +90,12 @@ export function createHarnessClient({ fetchFn, session }) {
     getWorkshopStatus() {
       return request("/api/workshop");
     },
+    listWorkshopInstances() {
+      return request("/api/workshop/instances");
+    },
+    getWorkshopInstance(instanceId) {
+      return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}`);
+    },
     getAgenda() {
       return request("/api/agenda");
     },

package/src/run-cli.js

@@ -103,6 +103,7 @@ async function readRequiredCommandValue(io, flags, keys, promptLabel, fallbackVa
 
 function buildWorkshopMetadataInput(flags) {
   const input = {
+    contentLang: readStringFlag(flags, "content-lang", "content-language"),
     eventTitle: readStringFlag(flags, "event-title", "title"),
     city: readStringFlag(flags, "city"),
     dateRange: readStringFlag(flags, "date-range", "date"),
@@ -122,6 +123,7 @@ function hasWorkshopMetadataInput(input) {
 
 async function promptWorkshopMetadataInput(io) {
   const prompts = [
+    ["contentLang", "Content language (cs/en, leave blank to skip): "],
     ["eventTitle", "Event title (leave blank to skip): "],
     ["city", "City (leave blank to skip): "],
     ["dateRange", "Date range (leave blank to skip): "],
@@ -148,7 +150,9 @@ function summarizeWorkshopInstance(instance) {
 
   return {
     instanceId: instance?.id ?? null,
+    templateId: instance?.templateId ?? null,
     status: instance?.status ?? null,
+    contentLang: workshopMeta.contentLang ?? null,
     eventTitle: workshopMeta.eventTitle ?? null,
     city: workshopMeta.city ?? null,
     dateRange: workshopMeta.dateRange ?? null,
@@ -175,9 +179,11 @@ function printUsage(io, ui) {
     "harness auth status",
     "harness skill install [--target PATH] [--force]",
     "harness workshop status",
+    "harness workshop list-instances",
+    "harness workshop show-instance <instance-id>",
     "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 create-instance [<instance-id>] [--template-id ID] [--content-lang cs|en] [--event-title TEXT] [--city CITY]",
+    "harness workshop update-instance <instance-id> [--content-lang cs|en] [--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>",
@@ -583,6 +589,67 @@ async function handleWorkshopStatus(io, ui, env, deps) {
   }
 }
 
+async function handleWorkshopListInstances(io, ui, env, deps) {
+  const session = await requireSession(io, ui, env);
+  if (!session) {
+    return 1;
+  }
+
+  try {
+    const client = createHarnessClient({ fetchFn: deps.fetchFn, session });
+    const result = await client.listWorkshopInstances();
+    const items = Array.isArray(result?.items) ? result.items.map((instance) => summarizeWorkshopInstance(instance)) : [];
+    ui.json("Workshop Instances", {
+      ok: true,
+      count: items.length,
+      items,
+    });
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `List instances failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
+async function handleWorkshopShowInstance(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.getWorkshopInstance(instanceId);
+    ui.json("Workshop Instance", {
+      ok: true,
+      ...summarizeWorkshopInstance(result.instance),
+      instance: result.instance,
+    });
+    return 0;
+  } catch (error) {
+    if (error instanceof HarnessApiError) {
+      ui.status("error", `Show instance failed: ${error.message}`, { stream: "stderr" });
+      return 1;
+    }
+    throw error;
+  }
+}
+
 async function handleWorkshopArchive(io, ui, env, flags, deps) {
   const session = await requireSession(io, ui, env);
   if (!session) {
@@ -880,6 +947,14 @@ export async function runCli(argv, io, deps = {}) {
     return handleWorkshopStatus(io, ui, io.env, mergedDeps);
   }
 
+  if (scope === "workshop" && action === "list-instances") {
+    return handleWorkshopListInstances(io, ui, io.env, mergedDeps);
+  }
+
+  if (scope === "workshop" && action === "show-instance") {
+    return handleWorkshopShowInstance(io, ui, io.env, positionals, flags, mergedDeps);
+  }
+
   if (scope === "workshop" && action === "archive") {
     return handleWorkshopArchive(io, ui, io.env, flags, mergedDeps);
   }