@zhivex-ai/harness 1.1.1 → 1.2.0-rc.13

package/dist/cli-entry-64pdp3k5.js

@@ -0,0 +1,17 @@
+// src/version.ts
+import { createRequire } from "node:module";
+var packageMetadata = createRequire(import.meta.url)("../package.json");
+if (typeof packageMetadata.version !== "string" || packageMetadata.version.length === 0) {
+  throw new Error("package.json must contain a non-empty version.");
+}
+if (typeof packageMetadata.engines?.node !== "string" || packageMetadata.engines.node.length === 0) {
+  throw new Error("package.json must contain a non-empty engines.node requirement.");
+}
+if (typeof packageMetadata.engines?.bun !== "string" || packageMetadata.engines.bun.length === 0) {
+  throw new Error("package.json must contain a non-empty engines.bun requirement.");
+}
+var HARNESS_VERSION = packageMetadata.version;
+var NODE_ENGINE_RANGE = packageMetadata.engines.node;
+var BUN_ENGINE_RANGE = packageMetadata.engines.bun;
+
+export { HARNESS_VERSION, NODE_ENGINE_RANGE, BUN_ENGINE_RANGE };

package/dist/cli-entry-b1mfvmxe.js

@@ -0,0 +1,376 @@
+// src/cli/cli-options.ts
+var repeatableOptions = new Set([
+  "--route",
+  "--oci-allow-command",
+  "--allow-check",
+  "--require-capability",
+  "--subagent",
+  "--reviewer",
+  "--status"
+]);
+var conflicts = {
+  "--approval-mode": ["--yes"],
+  "--yes": ["--approval-mode"],
+  "--token-budget": ["--no-token-budget"],
+  "--no-token-budget": ["--token-budget"],
+  "--usage-limit-usd": ["--max-cost-usd", "--input-cost-per-million", "--output-cost-per-million"],
+  "--max-cost-usd": ["--usage-limit-usd"],
+  "--input-cost-per-million": ["--usage-limit-usd"],
+  "--output-cost-per-million": ["--usage-limit-usd"],
+  "--json": ["--jsonl"],
+  "--jsonl": ["--json"],
+  "--session": ["--continue"],
+  "--continue": ["--session"],
+  "--approve": ["--deny"],
+  "--deny": ["--approve"]
+};
+var CLI_OPTION_NAMES = [
+  "--compaction-model",
+  "--compaction-provider",
+  "--provider",
+  "--model",
+  "--reasoning",
+  "--profile",
+  "--route",
+  "--workspace",
+  "--state-dir",
+  "--mcp-config",
+  "--context-config",
+  "--no-project-context",
+  "--patch",
+  "--preconditions",
+  "--now",
+  "--require-verified-delivery",
+  "--execution",
+  "--oci-runtime",
+  "--oci-image",
+  "--oci-allow-command",
+  "--oci-shell",
+  "--oci-max-process-runtime-ms",
+  "--oci-max-process-output-bytes",
+  "--oci-max-memory-mb",
+  "--oci-max-pids",
+  "--oci-max-cpus",
+  "--oci-max-workspace-bytes",
+  "--oci-max-file-write-bytes",
+  "--oci-tmpfs-mb",
+  "--store",
+  "--tenant",
+  "--user",
+  "--namespace",
+  "--idempotency-key",
+  "--token-budget",
+  "--context-tokens",
+  "--no-token-budget",
+  "--max-steps",
+  "--timeout-ms",
+  "--max-tool-calls",
+  "--max-tool-errors",
+  "--max-input-tokens",
+  "--max-output-tokens",
+  "--max-total-tokens",
+  "--subagent-max-steps",
+  "--subagent-max-tool-calls",
+  "--subagent-max-tool-errors",
+  "--subagent-max-input-tokens",
+  "--subagent-max-output-tokens",
+  "--subagent-max-total-tokens",
+  "--subagent-timeout-ms",
+  "--max-parallel-reviews",
+  "--max-cost-usd",
+  "--input-cost-per-million",
+  "--output-cost-per-million",
+  "--allow-check",
+  "--require-capability",
+  "--subagent",
+  "--reviewer",
+  "--approval-mode",
+  "--yes",
+  "--approve",
+  "--deny",
+  "--json",
+  "--jsonl",
+  "--session",
+  "--continue",
+  "--update",
+  "--status",
+  "--limit",
+  "--cursor",
+  "--before",
+  "--reason",
+  "--cascade",
+  "--final",
+  "--service",
+  "--apply",
+  "--help",
+  "--version",
+  "--search",
+  "--pricing-file",
+  "--usage-limit-usd"
+];
+var CLI_OPTION_DEFINITIONS = Object.fromEntries(CLI_OPTION_NAMES.map((name) => [name, {
+  repeatable: repeatableOptions.has(name),
+  conflictsWith: conflicts[name] ?? []
+}]));
+var locator = ["--workspace", "--state-dir", "--store", "--tenant", "--user", "--namespace"];
+var provider = ["--provider", "--model", "--reasoning"];
+var profile = ["--profile"];
+var project = ["--mcp-config", "--context-config", "--no-project-context"];
+var execution = [
+  "--require-verified-delivery",
+  "--execution",
+  "--oci-runtime",
+  "--oci-image",
+  "--oci-allow-command",
+  "--oci-shell",
+  "--oci-max-process-runtime-ms",
+  "--oci-max-process-output-bytes",
+  "--oci-max-memory-mb",
+  "--oci-max-pids",
+  "--oci-max-cpus",
+  "--oci-max-workspace-bytes",
+  "--oci-max-file-write-bytes",
+  "--oci-tmpfs-mb"
+];
+var budgets = [
+  "--token-budget",
+  "--context-tokens",
+  "--no-token-budget",
+  "--max-steps",
+  "--timeout-ms",
+  "--max-tool-calls",
+  "--max-tool-errors",
+  "--max-input-tokens",
+  "--max-output-tokens",
+  "--max-total-tokens",
+  "--max-cost-usd",
+  "--input-cost-per-million",
+  "--output-cost-per-million",
+  "--subagent-max-steps",
+  "--subagent-max-tool-calls",
+  "--subagent-max-tool-errors",
+  "--subagent-max-input-tokens",
+  "--subagent-max-output-tokens",
+  "--subagent-max-total-tokens",
+  "--subagent-timeout-ms"
+];
+var childBudgets = [
+  "--no-token-budget",
+  "--subagent-max-steps",
+  "--subagent-max-tool-calls",
+  "--subagent-max-tool-errors",
+  "--subagent-max-input-tokens",
+  "--subagent-max-output-tokens",
+  "--subagent-max-total-tokens",
+  "--subagent-timeout-ms"
+];
+var agent = [
+  "--compaction-model",
+  "--compaction-provider",
+  "--pricing-file",
+  "--usage-limit-usd",
+  ...provider,
+  ...profile,
+  "--route",
+  ...locator,
+  ...project,
+  ...execution,
+  ...budgets,
+  "--allow-check",
+  "--require-capability",
+  "--subagent"
+];
+var contract = (allowed, required = []) => {
+  const allowedSet = new Set(allowed);
+  return {
+    allowed,
+    required,
+    repeatable: allowed.filter((name) => repeatableOptions.has(name)),
+    conflicts: Object.fromEntries(allowed.flatMap((name) => {
+      const relevant = conflicts[name]?.filter((other) => allowedSet.has(other)) ?? [];
+      return relevant.length > 0 ? [[name, relevant]] : [];
+    }))
+  };
+};
+var CLI_COMMAND_OPTION_CONTRACTS = {
+  init: contract([...provider, ...profile, "--update", "--json"]),
+  run: contract(["--service", "--session", ...agent, "--idempotency-key", "--approval-mode", "--yes", "--json", "--jsonl"]),
+  review: contract([
+    "--pricing-file",
+    "--usage-limit-usd",
+    ...provider,
+    ...profile,
+    "--route",
+    ...locator,
+    "--context-config",
+    "--no-project-context",
+    ...childBudgets,
+    "--max-parallel-reviews",
+    "--require-capability",
+    "--reviewer",
+    "--json"
+  ]),
+  chat: contract(["--service", ...agent, "--approval-mode", "--yes", "--session", "--continue"]),
+  providers: contract(["--json"]),
+  doctor: contract([...provider, ...profile, ...locator, ...project, ...execution, ...budgets, "--allow-check", "--require-capability", "--subagent", "--json"]),
+  resume: contract(["--service", "--session", ...locator, "--approve", "--deny", "--json", "--jsonl"], [["--approve", "--deny"]]),
+  "runs:list": contract([...locator, "--status", "--limit", "--cursor", "--json"]),
+  "runs:inspect": contract([...locator, "--json"]),
+  "runs:cancel": contract([...locator, "--reason", "--cascade", "--final", "--json"]),
+  "runs:cleanup": contract([...locator, "--before", "--status", "--limit", "--json"], ["--before"]),
+  "runs:export": contract([...locator, "--json"]),
+  "sessions:list": contract(["--service", ...locator, "--limit", "--json", "--search"]),
+  "sessions:inspect": contract(["--service", ...locator, "--json"]),
+  "sessions:rename": contract(["--service", ...locator, "--json"]),
+  "sessions:fork": contract([...locator, "--json"]),
+  "sessions:archive": contract([...locator, "--json"]),
+  "changes:create": contract(["--patch"], ["--patch"]),
+  "changes:verify": contract(["--patch", "--preconditions", "--now"], ["--patch"]),
+  "state:status": contract([...locator, "--json"]),
+  "state:export": contract([...locator, "--json"]),
+  "state:import": contract([...locator, "--apply", "--json"]),
+  help: contract(["--help"]),
+  version: contract(["--version"])
+};
+var validateCliCommandOptions = (commandKey, counts) => {
+  const commandContract = CLI_COMMAND_OPTION_CONTRACTS[commandKey];
+  const allowed = new Set(commandContract.allowed);
+  for (const [name, count] of counts) {
+    if (!allowed.has(name)) {
+      throw new Error(`${name} is not supported by ${commandKey.replace(":", " ")}.`);
+    }
+    if (count > 1 && !commandContract.repeatable.includes(name)) {
+      throw new Error(`${name} cannot be repeated for ${commandKey.replace(":", " ")}.`);
+    }
+    for (const conflicting of commandContract.conflicts[name] ?? []) {
+      if (counts.has(conflicting)) {
+        throw new Error(`${name} cannot be combined with ${conflicting}.`);
+      }
+    }
+  }
+  for (const requirement of commandContract.required) {
+    if (typeof requirement === "string") {
+      if (!counts.has(requirement)) {
+        throw new Error(`${requirement} is required by ${commandKey.replace(":", " ")}.`);
+      }
+      continue;
+    }
+    if (!requirement.some((name) => counts.has(name))) {
+      throw new Error(`${requirement.join(" or ")} is required by ${commandKey.replace(":", " ")}.`);
+    }
+  }
+};
+
+// src/cli/cli-help.ts
+var usage = {
+  init: "zhx init [--provider <id>] [--model <id>] [--profile <name>] [--update]",
+  run: 'zhx run [options] "task" | zhx run [options] -',
+  review: 'zhx review [options] "review task" | zhx review [options] -',
+  chat: "zhx [--continue | --session <id>]",
+  providers: "zhx providers [--json]",
+  doctor: "zhx doctor [options]",
+  resume: "zhx resume <runId> --approve|--deny",
+  "runs:list": "zhx runs list [options]",
+  "runs:inspect": "zhx runs inspect <runId>",
+  "runs:cancel": "zhx runs cancel <runId> [options]",
+  "runs:cleanup": "zhx runs cleanup --before <date> [options]",
+  "runs:export": "zhx runs export <runId>",
+  "sessions:list": "zhx sessions list [--search <text>]",
+  "sessions:inspect": "zhx sessions inspect <sessionId>",
+  "sessions:rename": 'zhx sessions rename <sessionId> "title"',
+  "sessions:fork": "zhx sessions fork <sessionId>",
+  "sessions:archive": "zhx sessions archive <sessionId>",
+  "changes:create": "zhx changes create <input.json> --patch <artifact>",
+  "changes:verify": "zhx changes verify <envelope.json> --patch <artifact> [options]",
+  "state:status": "zhx state status",
+  "state:export": "zhx state export <backup.json>",
+  "state:import": "zhx state import <backup.json> [--apply]",
+  version: "zhx --version"
+};
+var shortCliHelp = (version) => `Zhivex Harness v${version}
+
+Start in your project:
+  zhx                         Open the conversation (first-use setup if needed)
+  zhx --continue              Reopen the latest conversation
+  zhx run "task"              Run one task for a script or automation
+  zhx doctor                  Check local configuration
+
+Inside the console, type / for common actions or /help for guidance.
+  zhx init                    Configure a provider/model profile explicitly
+  zhx <command> --help        Show help for one command
+  zhx help all                Show every command and advanced option
+  zhx --version               Show the installed version
+
+Requires Node >=22.13. The console guides API key setup; automation uses environment keys.
+zhx chat and zhivex-harness remain supported aliases.`;
+function resolveHelpTopic(parts, explicit) {
+  if (!explicit || !parts.length)
+    return;
+  const topic = parts.join(":");
+  if (topic === "all" || Object.hasOwn(usage, topic) || Object.keys(usage).some((key) => key.startsWith(`${topic}:`)))
+    return topic;
+  throw new Error(`Unknown help topic: ${parts.join(" ")}. Use zhx help all.`);
+}
+function formatCliHelp(topic, version, full) {
+  if (!topic)
+    return shortCliHelp(version);
+  if (topic === "all")
+    return full;
+  const contract2 = CLI_COMMAND_OPTION_CONTRACTS[topic];
+  if (!contract2) {
+    return `Zhivex Harness — ${topic}
+
+` + Object.entries(usage).filter(([key]) => key.startsWith(`${topic}:`)).map(([, command]) => `  ${command}`).join(`
+`) + `
+
+Use zhx ${topic} <subcommand> --help for its options.`;
+  }
+  const descriptions = new Map;
+  for (const line of full.split(`
+`)) {
+    const match = line.match(/^  (--[\w-]+)(?:\s|$)/);
+    if (match)
+      descriptions.set(match[1], line);
+  }
+  const extra = {
+    "--approve": "  --approve                     Approve the pending batch",
+    "--deny": "  --deny                        Deny the pending batch",
+    "--status": "  --status <status>             Filter by run status; repeatable",
+    "--limit": "  --limit <n>                   Maximum number of results",
+    "--search": "  --search <text>               Literal conversation title or ID filter",
+    "--pricing-file": "  --pricing-file <file.json>    Operator-supplied price estimates",
+    "--usage-limit-usd": "  --usage-limit-usd <amount>    Per-run monetary limit; requires pricing",
+    "--version": "  --version                     Show the installed version"
+  };
+  const examples = {
+    run: ['zhx run "Explain this repository"', 'zhx run --profile daily --json "Review the parser"', "git diff | zhx run -"],
+    review: ['zhx review "Review error handling"', "zhx review - < review-task.txt"],
+    init: ["zhx init --profile daily", "zhx init --profile daily --update --model <id>"],
+    doctor: ["zhx doctor --profile daily", "zhx doctor --workspace /path/to/project"]
+  };
+  const groups = new Map;
+  for (const name of contract2.allowed) {
+    const group = name.startsWith("--oci-") || ["--execution", "--require-verified-delivery", "--allow-check", "--yes"].includes(name) ? "Execution and approvals" : /subagent|reviewer|parallel-reviews|^--route$/.test(name) ? "Specialist agents" : /cost|pricing|usage-limit|^--max-|^--timeout/.test(name) ? "Budgets and limits" : ["--state-dir", "--store", "--tenant", "--user", "--namespace", "--idempotency-key"].includes(name) ? "State and scope" : ["--mcp-config", "--context-config", "--no-project-context", "--require-capability"].includes(name) ? "Context and capabilities" : "Common options";
+    const lines = groups.get(group) ?? [];
+    lines.push(descriptions.get(name) ?? extra[name] ?? `  ${name}`);
+    groups.set(group, lines);
+  }
+  const sections = ["Common options", "Execution and approvals", "Budgets and limits", "Specialist agents", "Context and capabilities", "State and scope"].filter((group) => groups.has(group)).map((group) => `${group}:
+${groups.get(group).join(`
+`)}`);
+  return `Zhivex Harness — ${topic.replace(":", " ")}
+
+Usage: ${usage[topic]}
+` + (examples[topic] ? `
+Examples:
+${examples[topic].map((example) => `  ${example}`).join(`
+`)}
+` : "") + `
+${sections.join(`
+
+`)}
+
+Use zhx help all for the full reference and exit codes.`;
+}
+
+export { CLI_OPTION_DEFINITIONS, validateCliCommandOptions, shortCliHelp, resolveHelpTopic, formatCliHelp };