@harness-lab/cli 0.3.0 → 0.3.1

package/assets/workshop-bundle/SKILL.md

@@ -326,6 +326,14 @@ Rules for rich scenes:
 
 Archive the current workshop instance with optional notes.
 
+### `workshop facilitator learnings`
+
+Query the cross-cohort learnings log to review rotation signals from past and current workshops.
+Prefer invoking `harness --json workshop learnings` for machine-readable output.
+Supports flags: `--tag TAG`, `--instance ID`, `--cohort NAME`, `--limit N` (default 20).
+When the facilitator asks for rotation signals, captured observations, or what happened during past handoffs, use this command.
+If the learnings log is empty, say so and suggest capturing the first signal using the rotation capture panel in the facilitator dashboard.
+
 ### `workshop analyze`
 
 Review the team's repo against the handoff criteria in `workshop-skill/analyze-checklist.md`.

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

@@ -1,8 +1,8 @@
 {
   "manifestVersion": 1,
   "bundleName": "harness-lab-workshop",
-  "bundleVersion": "0.3.0",
-  "contentHash": "b0fd5ae303c75a44d04b923e25f7a28584c8fc63940b142fdfbba4f2f8ff255c",
+  "bundleVersion": "0.3.1",
+  "contentHash": "d52937fa7d980cdd71345b725b68bc934e939bc5b48cabd4d5bcfb55da03362f",
   "files": [
     {
       "path": "content/challenge-cards/.gitkeep",
@@ -18,7 +18,7 @@
     },
     {
       "path": "content/challenge-cards/print-spec.md",
-      "sha256": "be7ecfdae9ada4145272f12e2d6018ccde7cfaeb9f48feb58aca7da7236815c0"
+      "sha256": "0c6bc2953d6296b8901705d938a29c1ef859490e53cc265fe401bb9585611e16"
     },
     {
       "path": "content/codex-craft.md",
@@ -34,7 +34,7 @@
     },
     {
       "path": "content/facilitation/master-guide.md",
-      "sha256": "2c8033a43459dad42a88c1c842e5e915e6bb7d6dbdea38412d4a9c06b93544d7"
+      "sha256": "b5e107e88ab335aaa8870f51cf9c8b8dadb619d3b0f61dab087dacdcdef4c136"
     },
     {
       "path": "content/project-briefs/.gitkeep",
@@ -90,7 +90,7 @@
     },
     {
       "path": "content/talks/context-is-king.md",
-      "sha256": "33583f7982dd8f2d4d1bcbb637c0408562d6e0e20825eea06f897b34fe5efe16"
+      "sha256": "31fb6a02037c50e0b3fa2ae4bc39f658924bd164279fb490fc192d604763ff9f"
     },
     {
       "path": "docs/harness-cli-foundation.md",
@@ -130,7 +130,7 @@
     },
     {
       "path": "SKILL.md",
-      "sha256": "a8b8f76f8eeef2a7e7cd0d2906f33a7ab7a146a14383f5f679fddc6b3bdf8242"
+      "sha256": "0188da9de8f517a09dc4d0e2eb14f395aa465048253bf0c719995e8a232a33e2"
     },
     {
       "path": "workshop-blueprint/agenda.json",
@@ -166,11 +166,11 @@
     },
     {
       "path": "workshop-skill/closing-skill.md",
-      "sha256": "7019aa2afe4ac68869f0ec0c4bf9509f35695d171b66292d874e41355da178e0"
+      "sha256": "db23689de38b1ebfc2d9dde5387c5386a774cc6e90ab3e6c95f7749601d6abb7"
     },
     {
       "path": "workshop-skill/commands.md",
-      "sha256": "837c795baf133f220d3badf329c2484028f87209fb4e39cc729df54754b9a0a3"
+      "sha256": "d0af2bcc53c9752be3b013da002c22d4a8c7a09dea1995075b82550947141736"
     },
     {
       "path": "workshop-skill/facilitator.md",
@@ -186,7 +186,7 @@
     },
     {
       "path": "workshop-skill/locales/en/commands.md",
-      "sha256": "17856fa19a44c3336709186cba171505db4b503d11bc16ad2fbc49f67d6c78a0"
+      "sha256": "596af69cff67b770c284b4485c94bc39b511a60f3ff1b2b34f91f2c58a9f8b03"
     },
     {
       "path": "workshop-skill/locales/en/follow-up-package.md",
@@ -198,7 +198,7 @@
     },
     {
       "path": "workshop-skill/locales/en/reference.md",
-      "sha256": "f5931048a100e7da07b2b0cbfcf40d3f7744014cb0658df51e34930d23692903"
+      "sha256": "2e941f974ae86c79131770d40302eec0e7968e217f36d8ff166065c7819c47b3"
     },
     {
       "path": "workshop-skill/locales/en/setup.md",
@@ -210,7 +210,7 @@
     },
     {
       "path": "workshop-skill/reference.md",
-      "sha256": "89ef69ce4380468557a2f43576286937baf891bb0dc19035f0f06da69a3d0e38"
+      "sha256": "fe7d1c5f32d2a88b4673f565fda8bb389c4fe3b2a50aad5e2a9fafef7f75d658"
     },
     {
       "path": "workshop-skill/setup.md",

package/assets/workshop-bundle/content/challenge-cards/print-spec.md

@@ -17,7 +17,7 @@
 
 1. nahoře název karty
 2. pod ním kategorie
-3. 2-3 věty zadání
+3. 2–3 věty zadání
 4. dole malý štítek:
    - `Před obědem`
    - `Po rotaci`

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

@@ -108,7 +108,7 @@ Pointa:
 - přenos mantinelů
 - přenos done criteria
 
-### Most do Build fáze 1
+### Co si odnesete do build fáze
 
 Na konci talku má být jasné:
 

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

@@ -62,7 +62,7 @@ Vezmeme stejný malý task ve dvou podmínkách. Jedna varianta bude prompt blob
 - 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
+## Co si odnesete do build fáze
 
 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:
 

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

@@ -19,7 +19,7 @@ Na konci dne vytvoř krátké shrnutí workshopu, které je:
 
 1. Co pomohlo týmům pokračovat po handoffu
 2. Co opakovaně chybělo
-3. Jaké 2-3 principy si má místnost odnést do příštího týdne
+3. Jaké 2–3 principy si má místnost odnést do příštího týdne
 4. Jedna závěrečná věta, která propojí workshop s reálnou prací v týmu
 
 ## Styl

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

@@ -39,6 +39,10 @@
 - Když si nejste jistí workflow: `workshop commands`
 - Když chcete materiály i po workshopu: `workshop resources`, `workshop follow-up`, `workshop gallery`
 
+## Facilitátorské příkazy
+
+- `workshop facilitator learnings` — dotaz do learnings logu: záznamy z rotace z minulých i aktuálních workshopů. Podporuje filtrování podle tagu, instance a cohortu.
+
 ## Důležitá poznámka
 
 `workshop` skill je garantovaný výchozí nástroj workshopu. Další workflow skills a veřejné toolkity jsou doporučené rozšíření, ne podmínka účasti.

package/assets/workshop-bundle/workshop-skill/locales/en/commands.md

@@ -39,6 +39,10 @@
 - If you are unsure about workflow: `workshop commands`
 - If you want materials after the workshop too: `workshop resources`, `workshop follow-up`, `workshop gallery`
 
+## Facilitator commands
+
+- `workshop facilitator learnings` — query the cross-cohort learnings log: rotation signals from past and current workshops. Supports filtering by tag, instance, and cohort.
+
 ## Important note
 
 The `workshop` skill is the guaranteed workshop default. Additional workflow skills and public toolkits are recommended accelerators, not a requirement for participation.

package/assets/workshop-bundle/workshop-skill/locales/en/reference.md

@@ -59,6 +59,7 @@
 - `Codex: $workshop` for orientation during the day
 - `Codex: $workshop template` when the repo is missing baseline context
 - `Codex: $workshop analyze` before handoff or after rotation when you want to expose blind spots in the repo quickly
+- `Codex: $workshop facilitator learnings` or `harness workshop learnings` to query the cross-cohort learnings log (rotation signals from past workshops). Prefers the CLI path for machine-readable output with filtering by tag, instance, or cohort.
 
 ## Recommended participant loop
 

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

@@ -87,6 +87,14 @@
 
 Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext uložený v repu, další bezpečný krok musí být dohledatelný a ověření musí zůstat čitelné i pro cizí tým.
 
+## Learnings log — pro facilitátory
+
+- Po rotaci můžete procházet zachycené signály přímo v CLI: `harness workshop learnings`
+- Filtrujte podle tagu: `harness --json workshop learnings --tag missing_runbook`
+- Filtrujte podle kohorty nebo instance: `--cohort 2026-Q2`, `--instance <id>`
+- V dashboardu: rotační panel v detailu instance obsahuje capture formulář i přehled posledních záznamů
+- Learnings log přežije smazání instance a postupně buduje evidenci pro vylepšení blueprintu
+
 ## Kam dál po workshopu
 
 - Oficiální docs, OpenAI článek o Harness Engineering a ověřené veřejné skill repozitáře najdete v [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md).

package/package.json

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

package/src/run-cli.js

@@ -1,3 +1,5 @@
+import fs from "node:fs/promises";
+import path from "node:path";
 import { getDefaultDashboardUrl } from "./config.js";
 import { createHarnessClient, HarnessApiError } from "./client.js";
 import { createCliUi, prompt, writeLine } from "./io.js";
@@ -231,6 +233,7 @@ function printUsage(io, ui) {
     "harness workshop prepare <instance-id>",
     "harness workshop remove-instance <instance-id>",
     "harness workshop phase set <phase-id>",
+    "harness workshop learnings [--tag TAG] [--instance ID] [--cohort NAME] [--limit N]",
   ]);
 }
 
@@ -1142,6 +1145,101 @@ async function handleWorkshopPhaseSet(io, ui, env, positionals, deps) {
   }
 }
 
+async function handleWorkshopLearningsQuery(io, ui, env, flags) {
+  const dataDir = env.HARNESS_DATA_DIR ?? path.join(process.cwd(), "data");
+  const logPath = env.HARNESS_LEARNINGS_LOG_PATH ?? path.join(dataDir, "learnings-log.jsonl");
+
+  let rawLines;
+  try {
+    const content = await fs.readFile(logPath, "utf8");
+    rawLines = content.split("\n").filter((line) => line.trim().length > 0);
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      ui.json("Workshop Learnings", { ok: true, signals: [], totalMatched: 0, source: logPath });
+      return 0;
+    }
+    ui.status("error", `Could not read learnings log at ${logPath}: ${error instanceof Error ? error.message : String(error)}`, { stream: "stderr" });
+    return 1;
+  }
+
+  let entries;
+  try {
+    entries = rawLines.map((line) => JSON.parse(line));
+  } catch (error) {
+    ui.status("error", `Learnings log has malformed JSON lines: ${error instanceof Error ? error.message : String(error)}`, { stream: "stderr" });
+    return 1;
+  }
+
+  const filterTag = readStringFlag(flags, "tag");
+  const filterInstance = readStringFlag(flags, "instance");
+  const filterCohort = readStringFlag(flags, "cohort");
+  const limit = Number(readStringFlag(flags, "limit") ?? "20");
+
+  let matched = entries;
+  if (filterTag) {
+    matched = matched.filter((entry) =>
+      Array.isArray(entry.signal?.tags) && entry.signal.tags.some((tag) => tag === filterTag),
+    );
+  }
+  if (filterInstance) {
+    matched = matched.filter((entry) => entry.instanceId === filterInstance);
+  }
+  if (filterCohort) {
+    matched = matched.filter((entry) => entry.cohort === filterCohort);
+  }
+
+  const totalMatched = matched.length;
+  const limited = Number.isFinite(limit) && limit > 0 ? matched.slice(-limit) : matched;
+
+  if (ui.jsonMode) {
+    ui.json("Workshop Learnings", {
+      ok: true,
+      totalMatched,
+      returned: limited.length,
+      source: logPath,
+      signals: limited.map((entry) => ({
+        cohort: entry.cohort,
+        instanceId: entry.instanceId,
+        capturedAt: entry.signal?.capturedAt ?? entry.loggedAt,
+        capturedBy: entry.signal?.capturedBy ?? "unknown",
+        teamId: entry.signal?.teamId ?? null,
+        tags: entry.signal?.tags ?? [],
+        freeText: entry.signal?.freeText ?? "",
+      })),
+    });
+    return 0;
+  }
+
+  ui.heading("Workshop Learnings");
+  if (limited.length === 0) {
+    ui.paragraph(totalMatched === 0
+      ? "No signals captured yet. Use the rotation capture panel in the facilitator dashboard during the continuation shift."
+      : `No signals matched the current filters (${totalMatched} total in log).`,
+    );
+    ui.blank();
+    ui.keyValue("Source", logPath);
+    return 0;
+  }
+
+  ui.paragraph(`${totalMatched} signal${totalMatched === 1 ? "" : "s"} matched${totalMatched > limited.length ? ` (showing last ${limited.length})` : ""}`);
+  ui.blank();
+
+  for (const entry of limited) {
+    const signal = entry.signal ?? {};
+    const capturedAt = signal.capturedAt ?? entry.loggedAt ?? "";
+    const time = capturedAt ? new Date(capturedAt).toLocaleString("en-US", { dateStyle: "short", timeStyle: "short" }) : "";
+    const team = signal.teamId ? ` [${signal.teamId}]` : "";
+    const tags = Array.isArray(signal.tags) && signal.tags.length > 0 ? `  {${signal.tags.join(", ")}}` : "";
+
+    ui.section(`${entry.cohort ?? "?"} · ${time}${team}${tags}`);
+    ui.paragraph(signal.freeText ?? "(no observation text)", { indent: "  " });
+    ui.blank();
+  }
+
+  ui.keyValue("Source", logPath);
+  return 0;
+}
+
 export async function runCli(argv, io, deps = {}) {
   const fetchFn = deps.fetchFn ?? globalThis.fetch;
   const mergedDeps = { fetchFn, sleepFn: deps.sleepFn, openUrl: deps.openUrl, cwd: deps.cwd };
@@ -1241,6 +1339,10 @@ export async function runCli(argv, io, deps = {}) {
     return handleWorkshopPhaseSet(io, ui, io.env, positionals, mergedDeps);
   }
 
+  if (scope === "workshop" && action === "learnings") {
+    return handleWorkshopLearningsQuery(io, ui, io.env, flags);
+  }
+
   printUsage(io, ui);
   return 1;
 }