@h-rig/cli 0.0.6-alpha.9 → 0.0.6-alpha.91

package/dist/src/commands/test.d.ts

@@ -0,0 +1,3 @@
+import { type RunnerContext } from "../runner";
+import type { CommandOutcome } from "@rig/runtime";
+export declare function executeTest(context: RunnerContext, args: string[]): Promise<CommandOutcome>;

package/dist/src/commands/test.js

@@ -1,12 +1,19 @@
 // @bun
 // packages/cli/src/runner.ts
 import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError } from "@rig/runtime/control-plane/errors";
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
 import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { PluginManager } from "@rig/runtime/control-plane/runtime/plugins";
-import { loadRuntimeContextFromEnv } from "@rig/runtime/control-plane/runtime/context";
 import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
+
+class CliError extends RuntimeCliError {
+  hint;
+  constructor(message, exitCode = 1, options = {}) {
+    super(message, exitCode);
+    if (options.hint?.trim()) {
+      this.hint = options.hint.trim();
+    }
+  }
+}
 function requireNoExtraArgs(args, usage) {
   if (args.length > 0) {
     throw new CliError(`Unexpected arguments: ${args.join(" ")}
@@ -19,19 +26,19 @@ async function executeTest(context, args) {
   const [command = "unit", ...rest] = args;
   switch (command) {
     case "unit":
-      requireNoExtraArgs(rest, "bun run rig test unit");
+      requireNoExtraArgs(rest, "rig test unit");
       await context.runCommand(["bun", "test", "tests/harness/", "--ignore", "tests/harness/e2e/**"]);
       return { ok: true, group: "test", command };
     case "e2e":
-      requireNoExtraArgs(rest, "bun run rig test e2e");
+      requireNoExtraArgs(rest, "rig test e2e");
       await context.runCommand(["bun", "test", "tests/harness/e2e/"]);
       return { ok: true, group: "test", command };
     case "all":
-      requireNoExtraArgs(rest, "bun run rig test all");
+      requireNoExtraArgs(rest, "rig test all");
       await context.runCommand(["bun", "test", "tests/harness/"]);
       return { ok: true, group: "test", command };
     default:
-      throw new CliError2(`Unknown test command: ${command}`);
+      throw new CliError(`Unknown test command: ${command}`, 1, { hint: "Run `rig test --help` \u2014 commands are unit|e2e|all." });
   }
 }
 export {

package/dist/src/commands/triage.d.ts

@@ -0,0 +1,11 @@
+import { type IssueAnalysisTriageRunResult, type RunIssueAnalysisTriageOptions } from "@rig/runtime/control-plane/github";
+import type { CommandOutcome } from "@rig/runtime/control-plane/runtime/types";
+import { type RunnerContext } from "../runner";
+type TriageCommandDeps = {
+    runTriage?: (options: RunIssueAnalysisTriageOptions) => Promise<IssueAnalysisTriageRunResult>;
+    spinner?: <T>(label: string, work: (update: (label: string) => void) => Promise<T>, options: {
+        outputMode: RunnerContext["outputMode"];
+    }) => Promise<T>;
+};
+export declare function executeTriage(context: RunnerContext, args: string[], deps?: TriageCommandDeps): Promise<CommandOutcome>;
+export {};

package/dist/src/commands/triage.js

@@ -0,0 +1,227 @@
+// @bun
+// packages/cli/src/commands/triage.ts
+import { runIssueAnalysisTriage } from "@rig/runtime/control-plane/github";
+
+// packages/cli/src/runner.ts
+import { EventBus } from "@rig/runtime/control-plane/runtime/events";
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
+import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
+import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
+
+class CliError extends RuntimeCliError {
+  hint;
+  constructor(message, exitCode = 1, options = {}) {
+    super(message, exitCode);
+    if (options.hint?.trim()) {
+      this.hint = options.hint.trim();
+    }
+  }
+}
+function takeOption(args, option) {
+  const rest = [];
+  let value;
+  for (let index = 0;index < args.length; index += 1) {
+    const current = args[index];
+    if (current === option) {
+      const next = args[index + 1];
+      if (!next || next.startsWith("-")) {
+        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
+      }
+      value = next;
+      index += 1;
+      continue;
+    }
+    if (current !== undefined) {
+      rest.push(current);
+    }
+  }
+  return { value, rest };
+}
+function requireNoExtraArgs(args, usage) {
+  if (args.length > 0) {
+    throw new CliError(`Unexpected arguments: ${args.join(" ")}
+Usage: ${usage}`);
+  }
+}
+
+// packages/cli/src/commands/_async-ui.ts
+import pc from "picocolors";
+
+// packages/cli/src/commands/_spinner.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createTtySpinner(input) {
+  const output = input.output ?? process.stdout;
+  const isTty = output.isTTY === true;
+  const frames = input.frames && input.frames.length > 0 ? input.frames : SPINNER_FRAMES;
+  let label = input.label;
+  let frame = 0;
+  let paused = false;
+  let stopped = false;
+  let lastPrintedLabel = "";
+  const render = () => {
+    if (stopped || paused)
+      return;
+    if (!isTty) {
+      if (label !== lastPrintedLabel) {
+        output.write(`${label}
+`);
+        lastPrintedLabel = label;
+      }
+      return;
+    }
+    frame = (frame + 1) % frames.length;
+    const glyph = frames[frame] ?? frames[0] ?? "";
+    output.write(`\r\x1B[2K${input.styleFrame ? input.styleFrame(glyph) : glyph} ${label}`);
+  };
+  const clearLine = () => {
+    if (isTty)
+      output.write("\r\x1B[2K");
+  };
+  render();
+  const timer = isTty ? setInterval(render, input.intervalMs ?? 16) : null;
+  return {
+    setLabel(next) {
+      label = next;
+      render();
+    },
+    pause() {
+      paused = true;
+      clearLine();
+    },
+    resume() {
+      if (stopped)
+        return;
+      paused = false;
+      render();
+    },
+    stop(finalLine) {
+      if (stopped)
+        return;
+      stopped = true;
+      if (timer)
+        clearInterval(timer);
+      clearLine();
+      if (finalLine)
+        output.write(`${finalLine}
+`);
+    }
+  };
+}
+
+// packages/cli/src/commands/_async-ui.ts
+var FRAMES = ["\u25D0", "\u25D3", "\u25D1", "\u25D2"];
+var DONE_SYMBOL = pc.green("\u25C7");
+var FAIL_SYMBOL = pc.red("\u25A0");
+var activeUpdate = null;
+async function withSpinner(label, work, options = {}) {
+  if (options.outputMode === "json") {
+    return work(() => {
+      return;
+    });
+  }
+  if (activeUpdate) {
+    activeUpdate(label);
+    return work(activeUpdate);
+  }
+  const output = options.output ?? process.stderr;
+  const isTty = output.isTTY === true;
+  let lastLabel = label;
+  if (!isTty) {
+    output.write(`${label}
+`);
+    const update2 = (next) => {
+      lastLabel = next;
+    };
+    activeUpdate = update2;
+    try {
+      return await work(update2);
+    } finally {
+      activeUpdate = null;
+    }
+  }
+  const spinner = createTtySpinner({
+    label,
+    output,
+    frames: FRAMES,
+    styleFrame: (frame) => pc.cyan(frame)
+  });
+  const update = (next) => {
+    lastLabel = next;
+    spinner.setLabel(next);
+  };
+  activeUpdate = update;
+  try {
+    const result = await work(update);
+    spinner.stop(options.doneLabel ? `${DONE_SYMBOL} ${options.doneLabel}` : undefined);
+    return result;
+  } catch (error) {
+    spinner.stop(`${FAIL_SYMBOL} ${lastLabel}`);
+    throw error;
+  } finally {
+    activeUpdate = null;
+  }
+}
+
+// packages/cli/src/commands/triage.ts
+function printTriageResult(context, result) {
+  if (context.outputMode === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (!result.enabled) {
+    const suffix = result.skippedReason === "no-config" ? "no rig.config task source was found" : "config.issueAnalysis is not enabled for continuous Pi analysis";
+    console.log(`Rig triage skipped: ${suffix}.`);
+    return;
+  }
+  console.log([
+    `Rig triage analyzed ${result.analyzedIssues} issue${result.analyzedIssues === 1 ? "" : "s"}.`,
+    `metadata patches: ${result.metadataPatches}`,
+    `labels added: ${result.labelsAdded}`,
+    `labels removed: ${result.labelsRemoved}`,
+    `generated issues: ${result.generatedIssues}`,
+    `snapshot refreshes: ${result.writeBackRefreshes}`
+  ].join(`
+`));
+}
+async function executeTriage(context, args, deps = {}) {
+  if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    console.log(`Usage: rig triage [--reason <text>]
+
+Runs the configured issueAnalysis pass once. Schedule this command externally for continuous triage.`);
+    return { ok: true, group: "triage", command: "help" };
+  }
+  const parsedReason = takeOption(args, "--reason");
+  requireNoExtraArgs(parsedReason.rest, "rig triage [--reason <text>]");
+  if (context.dryRun) {
+    const result2 = {
+      ok: true,
+      enabled: false,
+      reason: parsedReason.value?.trim() || "triage",
+      sourceId: null,
+      sourceKind: null,
+      analyzedIssues: 0,
+      metadataPatches: 0,
+      labelsAdded: 0,
+      labelsRemoved: 0,
+      generatedIssues: 0,
+      writeBackRefreshes: 0,
+      refreshedIssueCount: null,
+      skippedReason: "disabled",
+      dryRun: true
+    };
+    if (context.outputMode === "json")
+      console.log(JSON.stringify(result2, null, 2));
+    else
+      console.log("[dry-run] rig triage would run the configured issueAnalysis pass once.");
+    return { ok: true, group: "triage", command: "run", details: result2 };
+  }
+  const result = await (deps.spinner ?? withSpinner)("Running Rig issue-analysis triage\u2026", () => (deps.runTriage ?? runIssueAnalysisTriage)({
+    projectRoot: context.projectRoot,
+    reason: parsedReason.value?.trim() || "triage"
+  }), { outputMode: context.outputMode });
+  printTriageResult(context, result);
+  return { ok: true, group: "triage", command: "run", details: result };
+}
+export {
+  executeTriage
+};

package/dist/src/commands/workspace.d.ts

@@ -0,0 +1,3 @@
+import { type RunnerContext } from "../runner";
+import type { CommandOutcome } from "@rig/runtime";
+export declare function executeWorkspace(context: RunnerContext, args: string[]): Promise<CommandOutcome>;

package/dist/src/commands/workspace.js

@@ -1,12 +1,19 @@
 // @bun
 // packages/cli/src/runner.ts
 import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError } from "@rig/runtime/control-plane/errors";
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
 import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { PluginManager } from "@rig/runtime/control-plane/runtime/plugins";
-import { loadRuntimeContextFromEnv } from "@rig/runtime/control-plane/runtime/context";
 import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
+
+class CliError extends RuntimeCliError {
+  hint;
+  constructor(message, exitCode = 1, options = {}) {
+    super(message, exitCode);
+    if (options.hint?.trim()) {
+      this.hint = options.hint.trim();
+    }
+  }
+}
 function takeOption(args, option) {
   const rest = [];
   let value;
@@ -15,7 +22,7 @@ function takeOption(args, option) {
     if (current === option) {
       const next = args[index + 1];
       if (!next || next.startsWith("-")) {
-        throw new CliError(`Missing value for ${option}`);
+        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
       }
       value = next;
       index += 1;
@@ -45,7 +52,7 @@ async function executeWorkspace(context, args) {
   const [command = "summary", ...rest] = args;
   switch (command) {
     case "summary": {
-      requireNoExtraArgs(rest, "bun run rig workspace summary");
+      requireNoExtraArgs(rest, "rig workspace summary");
       const summary = await readWorkspaceSummary(context.projectRoot);
       if (context.outputMode === "text") {
         console.log("Workspace Summary");
@@ -70,7 +77,7 @@ Warnings:`);
       return { ok: true, group: "workspace", command, details: summary };
     }
     case "topology": {
-      requireNoExtraArgs(rest, "bun run rig workspace topology");
+      requireNoExtraArgs(rest, "rig workspace topology");
       const topology = readWorkspaceTopology(context.projectRoot);
       if (context.outputMode === "text") {
         console.log(`Topology: ${topology.status}`);
@@ -83,7 +90,7 @@ Warnings:`);
       return { ok: true, group: "workspace", command, details: topology };
     }
     case "remote-hosts": {
-      requireNoExtraArgs(rest, "bun run rig workspace remote-hosts");
+      requireNoExtraArgs(rest, "rig workspace remote-hosts");
       const fleet = readWorkspaceRemoteFleet(context.projectRoot);
       if (context.outputMode === "text") {
         console.log(`Remote Hosts: ${fleet.status}`);
@@ -98,9 +105,9 @@ Warnings:`);
       let pending = serviceRest;
       const services = takeOption(pending, "--service");
       pending = services.rest;
-      requireNoExtraArgs(pending, "bun run rig workspace service-fabric <status|up|verify|down> [--service <name>]");
+      requireNoExtraArgs(pending, "rig workspace service-fabric <status|up|verify|down> [--service <name>]");
       if (action !== "status" && action !== "up" && action !== "verify" && action !== "down") {
-        throw new CliError2(`Unknown workspace service-fabric action: ${action}`);
+        throw new CliError(`Unknown workspace service-fabric action: ${action}`, 1, { hint: "Use one of: `rig workspace service-fabric status|up|verify|down`." });
       }
       const selectedServices = services.value ? services.value.split(",").map((entry) => entry.trim()).filter(Boolean) : [];
       const summary = action === "status" ? await mutateWorkspaceServiceFabric(context.projectRoot, "verify", selectedServices) : await mutateWorkspaceServiceFabric(context.projectRoot, action, selectedServices);
@@ -115,7 +122,7 @@ Warnings:`);
       };
     }
     default:
-      throw new CliError2(`Unknown workspace command: ${command}`);
+      throw new CliError(`Unknown workspace command: ${command}`, 1, { hint: "Run `rig workspace --help` \u2014 commands are summary|topology|remote-hosts|service-fabric." });
   }
 }
 export {

package/dist/src/commands.d.ts

@@ -0,0 +1,13 @@
+import { type RunnerContext } from "./runner";
+import type { CommandOutcome } from "@rig/runtime/control-plane/runtime/types";
+import { buildRunPrompt } from "./commands/_run-driver-helpers";
+export declare function printGroupHelp(group: string): void;
+/** Returns true if args[0] requests group help (--help, -h, or "help"). */
+export declare function isHelpArg(arg: string | undefined): boolean;
+export declare function helpText(): string;
+export declare function execute(context: RunnerContext, args: string[]): Promise<CommandOutcome>;
+export { buildRigInitConfigSource } from "./commands/init";
+export type { RigInitConfigInput } from "./commands/init";
+export declare const __testOnly: {
+    buildRunPrompt: typeof buildRunPrompt;
+};