@harness-engineering/cli 1.2.2 → 1.4.0

package/dist/bin/harness.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createProgram
-} from "../chunk-5RQKSZLA.js";
+} from "../chunk-C3J2HW4Y.js";
 import "../chunk-3U5VZYR7.js";
 import {
   handleError

package/dist/{chunk-5RQKSZLA.js → chunk-C3J2HW4Y.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-EFZOLZFB.js";
 
 // src/index.ts
-import { Command as Command29 } from "commander";
+import { Command as Command33 } from "commander";
 import { VERSION } from "@harness-engineering/core";
 
 // src/commands/validate.ts
@@ -1387,8 +1387,8 @@ async function runPersona(persona, executor) {
     const result = await Promise.race([
       executor(command),
       new Promise(
-        (resolve13) => setTimeout(
-          () => resolve13({ ok: false, error: new Error(TIMEOUT_ERROR_MESSAGE) }),
+        (resolve14) => setTimeout(
+          () => resolve14({ ok: false, error: new Error(TIMEOUT_ERROR_MESSAGE) }),
           remainingTime
         )
       )
@@ -2560,8 +2560,8 @@ function createResetCommand() {
     }
     if (!opts.yes) {
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve13) => {
-        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve13);
+      const answer = await new Promise((resolve14) => {
+        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve14);
       });
       rl.close();
       if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
@@ -2899,14 +2899,14 @@ function renderClaudeCode(spec) {
 }
 
 // src/slash-commands/render-gemini.ts
-function escapeToml(content) {
-  return content.replace(/"""/g, '""\\"');
+function escapeTomlLiteral(content) {
+  return content.replace(/'''/g, "''\\'''");
 }
 function renderGemini(spec, skillMdContent, skillYamlContent) {
   const lines = [GENERATED_HEADER_GEMINI];
   const safeDesc = spec.description.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
   lines.push(`description = "${safeDesc}"`);
-  lines.push('prompt = """');
+  lines.push("prompt = '''");
   lines.push("<context>");
   lines.push(spec.prompt.context);
   lines.push("</context>");
@@ -2920,14 +2920,14 @@ function renderGemini(spec, skillMdContent, skillYamlContent) {
     if (skillMdContent) {
       const mdPath = spec.prompt.executionContext.split("\n")[0]?.replace(/^@/, "") ?? "";
       lines.push(`--- SKILL.md (${mdPath}) ---`);
-      lines.push(escapeToml(skillMdContent));
+      lines.push(escapeTomlLiteral(skillMdContent));
       lines.push("");
     }
     if (skillYamlContent) {
       const refs = spec.prompt.executionContext.split("\n");
       const yamlPath = (refs[1] ?? refs[0] ?? "").replace(/^@/, "");
       lines.push(`--- skill.yaml (${yamlPath}) ---`);
-      lines.push(escapeToml(skillYamlContent));
+      lines.push(escapeTomlLiteral(skillYamlContent));
     }
     lines.push("</execution_context>");
     lines.push("");
@@ -2939,7 +2939,7 @@ function renderGemini(spec, skillMdContent, skillYamlContent) {
   lines.push("<process>");
   lines.push(geminiProcess);
   lines.push("</process>");
-  lines.push('"""');
+  lines.push("'''");
   lines.push("");
   return lines.join("\n");
 }
@@ -3014,11 +3014,11 @@ function fileExtension(platform) {
 }
 async function confirmDeletion(files) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve13) => {
+  return new Promise((resolve14) => {
     rl.question(`
 Remove ${files.length} orphaned command(s)? (y/N) `, (answer) => {
       rl.close();
-      resolve13(answer.toLowerCase() === "y");
+      resolve14(answer.toLowerCase() === "y");
     });
   });
 }
@@ -3140,9 +3140,360 @@ ${result.platform} \u2192 ${result.outputDir}`);
   });
 }
 
+// src/commands/ci/index.ts
+import { Command as Command31 } from "commander";
+
+// src/commands/ci/check.ts
+import { Command as Command29 } from "commander";
+import { runCIChecks } from "@harness-engineering/core";
+var VALID_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
+async function runCICheck(options) {
+  const configResult = resolveConfig(options.configPath);
+  if (!configResult.ok) {
+    return configResult;
+  }
+  const input = {
+    projectRoot: process.cwd(),
+    config: configResult.value
+  };
+  if (options.skip) input.skip = options.skip;
+  if (options.failOn) input.failOn = options.failOn;
+  const result = await runCIChecks(input);
+  if (!result.ok) {
+    return {
+      ok: false,
+      error: new CLIError(result.error.message, ExitCode.ERROR)
+    };
+  }
+  return { ok: true, value: result.value };
+}
+function parseSkip(skip) {
+  if (!skip) return [];
+  return skip.split(",").map((s) => s.trim()).filter((s) => VALID_CHECKS.includes(s));
+}
+function parseFailOn(failOn) {
+  if (failOn === "warning") return "warning";
+  return "error";
+}
+function createCheckCommand() {
+  return new Command29("check").description("Run all harness checks for CI (validate, deps, docs, entropy, phase-gate)").option("--skip <checks>", "Comma-separated checks to skip (e.g., entropy,docs)").option("--fail-on <severity>", "Fail on severity level: error (default) or warning", "error").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
+    const skip = parseSkip(opts.skip);
+    const failOn = parseFailOn(opts.failOn);
+    const result = await runCICheck({
+      configPath: globalOpts.config,
+      skip,
+      failOn
+    });
+    if (!result.ok) {
+      if (mode === OutputMode.JSON) {
+        console.log(JSON.stringify({ error: result.error.message }));
+      } else {
+        logger.error(result.error.message);
+      }
+      process.exit(ExitCode.ERROR);
+    }
+    const report = result.value;
+    if (mode === OutputMode.JSON) {
+      console.log(JSON.stringify(report, null, 2));
+    } else if (mode !== OutputMode.QUIET) {
+      for (const check of report.checks) {
+        const logFn = check.status === "pass" ? logger.success : check.status === "fail" ? logger.error : check.status === "warn" ? logger.warn : logger.dim;
+        logFn(`${check.name}: ${check.status} (${check.durationMs}ms)`);
+        for (const issue of check.issues) {
+          const prefix = issue.severity === "error" ? "  x" : "  !";
+          console.log(`${prefix} ${issue.message}${issue.file ? ` (${issue.file})` : ""}`);
+        }
+      }
+      console.log("");
+      if (report.exitCode === 0) {
+        logger.success(`All checks passed (${report.summary.passed}/${report.summary.total})`);
+      } else {
+        logger.error(
+          `${report.summary.failed} failed, ${report.summary.warnings} warnings, ${report.summary.passed} passed`
+        );
+      }
+    }
+    process.exit(report.exitCode);
+  });
+}
+
+// src/commands/ci/init.ts
+import { Command as Command30 } from "commander";
+import * as fs18 from "fs";
+import * as path26 from "path";
+import { Ok as Ok17, Err as Err14 } from "@harness-engineering/core";
+var ALL_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
+function buildSkipFlag(checks) {
+  if (!checks) return "";
+  const skipChecks = ALL_CHECKS.filter((c) => !checks.includes(c));
+  if (skipChecks.length === 0) return "";
+  return ` --skip ${skipChecks.join(",")}`;
+}
+function generateGitHubActions(skipFlag) {
+  return `name: Harness Checks
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: harness-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  harness:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - run: npm install -g @harness-engineering/cli
+      - name: Run harness checks
+        run: harness ci check --json${skipFlag}
+`;
+}
+function generateGitLabCI(skipFlag) {
+  return `harness:
+  stage: test
+  image: node:22
+  before_script:
+    - npm install -g @harness-engineering/cli
+  script:
+    - harness ci check --json${skipFlag}
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+`;
+}
+function generateGenericScript(skipFlag) {
+  return `#!/usr/bin/env bash
+set -euo pipefail
+
+# Harness CI Check Script
+# Generated by: harness ci init --platform generic
+
+if ! command -v harness &> /dev/null; then
+  echo "Installing @harness-engineering/cli..."
+  npm install -g @harness-engineering/cli
+fi
+
+echo "Running harness checks..."
+harness ci check --json${skipFlag}
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+  echo "All harness checks passed."
+elif [ $EXIT_CODE -eq 1 ]; then
+  echo "Harness checks failed. See report above."
+else
+  echo "Harness internal error."
+fi
+
+exit $EXIT_CODE
+`;
+}
+function generateCIConfig(options) {
+  const { platform, checks } = options;
+  const skipFlag = buildSkipFlag(checks);
+  const generators = {
+    github: { filename: ".github/workflows/harness.yml", generate: generateGitHubActions },
+    gitlab: { filename: ".gitlab-ci-harness.yml", generate: generateGitLabCI },
+    generic: { filename: "harness-ci.sh", generate: generateGenericScript }
+  };
+  const entry = generators[platform];
+  if (!entry) {
+    return Err14(new CLIError(`Unknown platform: ${platform}`, ExitCode.ERROR));
+  }
+  return Ok17({
+    filename: entry.filename,
+    content: entry.generate(skipFlag)
+  });
+}
+function detectPlatform() {
+  if (fs18.existsSync(".github")) return "github";
+  if (fs18.existsSync(".gitlab-ci.yml")) return "gitlab";
+  return null;
+}
+function createInitCommand2() {
+  return new Command30("init").description("Generate CI configuration for harness checks").option("--platform <platform>", "CI platform: github, gitlab, or generic").option("--checks <list>", "Comma-separated list of checks to include").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const platform = opts.platform ?? detectPlatform() ?? "generic";
+    const checks = opts.checks ? opts.checks.split(",").map((s) => s.trim()) : void 0;
+    const opts2 = { platform };
+    if (checks) opts2.checks = checks;
+    const result = generateCIConfig(opts2);
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(result.error.exitCode);
+    }
+    const { filename, content } = result.value;
+    const targetPath = path26.resolve(filename);
+    const dir = path26.dirname(targetPath);
+    fs18.mkdirSync(dir, { recursive: true });
+    fs18.writeFileSync(targetPath, content);
+    if (platform === "generic") {
+      fs18.chmodSync(targetPath, "755");
+    }
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ file: filename, platform }));
+    } else {
+      logger.success(`Generated ${filename} for ${platform}`);
+      logger.dim("Run 'harness ci check' to test locally");
+    }
+  });
+}
+
+// src/commands/ci/index.ts
+function createCICommand() {
+  const command = new Command31("ci").description("CI/CD integration commands");
+  command.addCommand(createCheckCommand());
+  command.addCommand(createInitCommand2());
+  return command;
+}
+
+// src/commands/update.ts
+import { Command as Command32 } from "commander";
+import { execSync as execSync3 } from "child_process";
+import { realpathSync } from "fs";
+import readline3 from "readline";
+import chalk4 from "chalk";
+function detectPackageManager() {
+  try {
+    const argv1 = process.argv[1];
+    if (!argv1) return "npm";
+    const binPath = realpathSync(argv1);
+    if (binPath.includes("pnpm/global/") || binPath.includes("pnpm-global/")) {
+      return "pnpm";
+    }
+    if (binPath.includes(".yarn/")) {
+      return "yarn";
+    }
+  } catch {
+  }
+  return "npm";
+}
+function getLatestVersion(pkg = "@harness-engineering/cli") {
+  const output = execSync3(`npm view ${pkg} dist-tags.latest`, {
+    encoding: "utf-8",
+    timeout: 15e3
+  });
+  return output.trim();
+}
+function getInstalledVersion(pm) {
+  try {
+    const output = execSync3(`${pm} list -g @harness-engineering/cli --json`, {
+      encoding: "utf-8",
+      timeout: 15e3
+    });
+    const data = JSON.parse(output);
+    const deps = data.dependencies ?? {};
+    return deps["@harness-engineering/cli"]?.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function getInstalledPackages(pm) {
+  try {
+    const output = execSync3(`${pm} list -g --json`, {
+      encoding: "utf-8",
+      timeout: 15e3
+    });
+    const data = JSON.parse(output);
+    const deps = data.dependencies ?? {};
+    return Object.keys(deps).filter((name) => name.startsWith("@harness-engineering/"));
+  } catch {
+    return ["@harness-engineering/cli", "@harness-engineering/core"];
+  }
+}
+function prompt(question) {
+  const rl = readline3.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve14) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve14(answer.trim().toLowerCase());
+    });
+  });
+}
+function createUpdateCommand() {
+  return new Command32("update").description("Update all @harness-engineering packages to the latest version").option("--version <semver>", "Pin @harness-engineering/cli to a specific version").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const pm = detectPackageManager();
+    if (globalOpts.verbose) {
+      logger.info(`Detected package manager: ${pm}`);
+    }
+    const currentVersion = getInstalledVersion(pm);
+    let latestCliVersion;
+    if (!opts.version) {
+      logger.info("Checking for updates...");
+      try {
+        latestCliVersion = getLatestVersion();
+      } catch {
+        logger.error("Failed to fetch latest version from npm registry");
+        return process.exit(ExitCode.ERROR);
+      }
+      if (currentVersion && currentVersion === latestCliVersion) {
+        logger.success(`Already up to date (v${currentVersion})`);
+        process.exit(ExitCode.SUCCESS);
+      }
+      if (currentVersion) {
+        console.log("");
+        logger.info(`Current CLI version: ${chalk4.dim(`v${currentVersion}`)}`);
+        logger.info(`Latest CLI version:  ${chalk4.green(`v${latestCliVersion}`)}`);
+        console.log("");
+      }
+    }
+    const packages = getInstalledPackages(pm);
+    if (globalOpts.verbose) {
+      logger.info(`Installed packages: ${packages.join(", ")}`);
+    }
+    const installArgs = packages.map((pkg) => {
+      if (opts.version && pkg === "@harness-engineering/cli") {
+        return `${pkg}@${opts.version}`;
+      }
+      return `${pkg}@latest`;
+    }).join(" ");
+    const installCmd = `${pm} install -g ${installArgs}`;
+    if (globalOpts.verbose) {
+      logger.info(`Running: ${installCmd}`);
+    }
+    try {
+      logger.info("Updating packages...");
+      execSync3(installCmd, { stdio: "inherit", timeout: 12e4 });
+      console.log("");
+      logger.success("Update complete");
+    } catch {
+      console.log("");
+      logger.error("Update failed. You can try manually:");
+      console.log(`  ${chalk4.cyan(installCmd)}`);
+      process.exit(ExitCode.ERROR);
+    }
+    console.log("");
+    const regenAnswer = await prompt("Regenerate slash commands? (y/N) ");
+    if (regenAnswer === "y" || regenAnswer === "yes") {
+      const scopeAnswer = await prompt("Generate for (g)lobal or (l)ocal project? (g/l) ");
+      const globalFlag = scopeAnswer === "g" || scopeAnswer === "global" ? " --global" : "";
+      try {
+        execSync3(`harness generate-slash-commands${globalFlag}`, { stdio: "inherit" });
+      } catch {
+        logger.warn("Slash command generation failed. Run manually:");
+        console.log(`  ${chalk4.cyan(`harness generate-slash-commands${globalFlag}`)}`);
+      }
+    }
+    process.exit(ExitCode.SUCCESS);
+  });
+}
+
 // src/index.ts
 function createProgram() {
-  const program = new Command29();
+  const program = new Command33();
   program.name("harness").description("CLI for Harness Engineering toolkit").version(VERSION).option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--verbose", "Verbose output").option("--quiet", "Minimal output");
   program.addCommand(createValidateCommand());
   program.addCommand(createCheckDepsCommand());
@@ -3160,6 +3511,8 @@ function createProgram() {
   program.addCommand(createCreateSkillCommand());
   program.addCommand(createSetupMcpCommand());
   program.addCommand(createGenerateSlashCommandsCommand());
+  program.addCommand(createCICommand());
+  program.addCommand(createUpdateCommand());
   return program;
 }
 

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   resolveConfig,
   runCheckPhaseGate,
   runPersona
-} from "./chunk-5RQKSZLA.js";
+} from "./chunk-C3J2HW4Y.js";
 import {
   runCrossCheck
 } from "./chunk-3U5VZYR7.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/cli",
-  "version": "1.2.2",
+  "version": "1.4.0",
   "description": "CLI for Harness Engineering toolkit",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
     "handlebars": "^4.7.0",
     "yaml": "^2.3.0",
     "zod": "^3.22.0",
-    "@harness-engineering/core": "0.6.0",
+    "@harness-engineering/core": "0.7.0",
     "@harness-engineering/linter-gen": "0.1.0"
   },
   "devDependencies": {