@harness-lab/cli 0.1.2 → 0.1.4

package/README.md

@@ -1,9 +1,11 @@
 # Harness CLI
 
-Small facilitator-facing CLI for Harness Lab.
+Small Harness Lab CLI for facilitator auth, workshop operations, and repo-local skill installation.
 
 Current shipped scope:
 
+- `harness version`
+- `harness skill install`
 - `harness auth login`
 - `harness auth logout`
 - `harness auth status`
@@ -33,6 +35,7 @@ npm install -g @harness-lab/cli
 Verify the binary:
 
 ```bash
+harness --version
 harness --help
 ```
 
@@ -49,6 +52,22 @@ cd harness-cli
 npm link
 ```
 
+Verify the local install:
+
+```bash
+harness version
+harness --help
+```
+
+Install the repo-local workshop skill bundle for Codex/OpenCode discovery:
+
+```bash
+harness skill install
+```
+
+This creates `.agents/skills/harness-lab-workshop` in the current Harness Lab repo checkout.
+After install, the CLI prints the first recommended agent commands, starting with `/workshop reference`.
+
 Default device/browser login:
 
 ```bash
@@ -81,6 +100,7 @@ Workshop commands:
 
 ```bash
 harness auth status
+harness skill install
 harness workshop status
 harness workshop phase set rotation
 harness workshop archive --notes "Manual archive"

package/package.json

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

package/src/run-cli.js

@@ -2,6 +2,11 @@ import { getDefaultDashboardUrl } from "./config.js";
 import { createHarnessClient, HarnessApiError } from "./client.js";
 import { prompt, writeLine } from "./io.js";
 import { deleteSession, readSession, sanitizeSession, writeSession, getSessionStorageMode, SessionStoreError } from "./session-store.js";
+import { installWorkshopSkill, SkillInstallError } from "./skill-install.js";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -13,6 +18,14 @@ function parseArgs(argv) {
 
   for (let index = 0; index < argv.length; index += 1) {
     const value = argv[index];
+    if (value === "-h") {
+      flags.help = true;
+      continue;
+    }
+    if (value === "-v") {
+      flags.version = true;
+      continue;
+    }
     if (value.startsWith("--")) {
       const key = value.slice(2);
       const next = argv[index + 1];
@@ -52,14 +65,42 @@ async function readJson(response) {
 
 function printUsage(io) {
   writeLine(io.stdout, "Usage:");
+  writeLine(io.stdout, "  harness --help");
+  writeLine(io.stdout, "  harness --version");
+  writeLine(io.stdout, "  harness version");
   writeLine(io.stdout, "  harness auth login [--auth device|basic|neon] [--dashboard-url URL] [--username USER] [--email EMAIL] [--password PASS] [--no-open]");
   writeLine(io.stdout, "  harness auth logout");
   writeLine(io.stdout, "  harness auth status");
+  writeLine(io.stdout, "  harness skill install [--force]");
   writeLine(io.stdout, "  harness workshop status");
   writeLine(io.stdout, "  harness workshop archive [--notes TEXT]");
   writeLine(io.stdout, "  harness workshop phase set <phase-id>");
 }
 
+function printVersion(io) {
+  writeLine(io.stdout, `harness ${version}`);
+}
+
+async function handleSkillInstall(io, deps, flags) {
+  try {
+    const result = await installWorkshopSkill(deps.cwd ?? process.cwd(), { force: flags.force === true });
+    writeLine(io.stdout, `Installed Harness Lab workshop skill to ${result.installPath}`);
+    writeLine(io.stdout, "Codex and OpenCode should now discover it from this repo via .agents/skills.");
+    writeLine(io.stdout, "Next steps:");
+    writeLine(io.stdout, "  1. Open Codex or OpenCode in this repo.");
+    writeLine(io.stdout, "  2. Run `/workshop reference` for the command overview.");
+    writeLine(io.stdout, "  3. Run `/workshop setup` if your environment is not ready yet.");
+    writeLine(io.stdout, "  4. Run `/workshop` to get the current phase or fallback guidance.");
+    return 0;
+  } catch (error) {
+    if (error instanceof SkillInstallError) {
+      writeLine(io.stderr, `Skill install failed: ${error.message}`);
+      return 1;
+    }
+    throw error;
+  }
+}
+
 function formatStorageError(error) {
   if (error instanceof SessionStoreError) {
     return error.message;
@@ -471,11 +512,7 @@ async function handleWorkshopPhaseSet(io, env, positionals, deps) {
 
 export async function runCli(argv, io, deps = {}) {
   const fetchFn = deps.fetchFn ?? globalThis.fetch;
-  if (typeof fetchFn !== "function") {
-    throw new Error("Fetch is required to run the harness CLI.");
-  }
-
-  const mergedDeps = { fetchFn, sleepFn: deps.sleepFn, openUrl: deps.openUrl };
+  const mergedDeps = { fetchFn, sleepFn: deps.sleepFn, openUrl: deps.openUrl, cwd: deps.cwd };
   const { positionals, flags } = parseArgs(argv);
   const [scope, action, subaction] = positionals;
 
@@ -484,11 +521,25 @@ export async function runCli(argv, io, deps = {}) {
     return 0;
   }
 
+  if (flags.version === true) {
+    printVersion(io);
+    return 0;
+  }
+
+  if (scope === "version") {
+    printVersion(io);
+    return 0;
+  }
+
   if (!scope) {
     printUsage(io);
     return 1;
   }
 
+  if (typeof fetchFn !== "function") {
+    throw new Error("Fetch is required to run the harness CLI.");
+  }
+
   if (scope === "auth" && action === "login") {
     return handleAuthLogin(io, io.env, flags, mergedDeps);
   }
@@ -501,6 +552,10 @@ export async function runCli(argv, io, deps = {}) {
     return handleAuthStatus(io, io.env, mergedDeps);
   }
 
+  if (scope === "skill" && action === "install") {
+    return handleSkillInstall(io, mergedDeps, flags);
+  }
+
   if (scope === "workshop" && action === "status") {
     return handleWorkshopStatus(io, io.env, mergedDeps);
   }

package/src/skill-install.js

@@ -0,0 +1,82 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export class SkillInstallError extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "SkillInstallError";
+    this.code = options.code ?? "skill_install_failed";
+  }
+}
+
+const SKILL_NAME = "harness-lab-workshop";
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function findHarnessLabRepoRoot(startDir) {
+  let currentDir = path.resolve(startDir);
+
+  while (true) {
+    if (await pathExists(path.join(currentDir, "workshop-skill", "SKILL.md"))) {
+      return currentDir;
+    }
+
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+
+    currentDir = parentDir;
+  }
+}
+
+export function getInstalledSkillPath(repoRoot) {
+  return path.join(repoRoot, ".agents", "skills", SKILL_NAME);
+}
+
+export async function installWorkshopSkill(startDir, options = {}) {
+  const repoRoot = await findHarnessLabRepoRoot(startDir);
+  if (!repoRoot) {
+    throw new SkillInstallError(
+      "Harness CLI could not find `workshop-skill/SKILL.md`. Run this command inside a Harness Lab repo checkout.",
+      { code: "repo_not_found" },
+    );
+  }
+
+  const installPath = getInstalledSkillPath(repoRoot);
+  if ((await pathExists(installPath)) && options.force !== true) {
+    throw new SkillInstallError(
+      `Skill already installed at ${installPath}. Re-run with --force to replace it.`,
+      { code: "already_installed" },
+    );
+  }
+
+  if (options.force === true) {
+    await fs.rm(installPath, { recursive: true, force: true });
+  }
+
+  await fs.mkdir(installPath, { recursive: true });
+  await fs.cp(path.join(repoRoot, "workshop-skill"), path.join(installPath, "workshop-skill"), { recursive: true });
+  await fs.cp(path.join(repoRoot, "content"), path.join(installPath, "content"), { recursive: true });
+  await fs.cp(path.join(repoRoot, "workshop-blueprint"), path.join(installPath, "workshop-blueprint"), { recursive: true });
+  await fs.rm(path.join(installPath, "workshop-skill", "SKILL.md"), { force: true });
+  await fs.mkdir(path.join(installPath, "docs"), { recursive: true });
+  await fs.copyFile(path.join(repoRoot, "workshop-skill", "SKILL.md"), path.join(installPath, "SKILL.md"));
+  await fs.copyFile(
+    path.join(repoRoot, "docs", "workshop-event-context-contract.md"),
+    path.join(installPath, "docs", "workshop-event-context-contract.md"),
+  );
+  await fs.copyFile(
+    path.join(repoRoot, "docs", "harness-cli-foundation.md"),
+    path.join(installPath, "docs", "harness-cli-foundation.md"),
+  );
+
+  return { repoRoot, installPath, skillName: SKILL_NAME };
+}