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

package/dist/src/commands/profile-and-review.js

@@ -1,12 +1,22 @@
 // @bun
+// packages/cli/src/commands/profile-and-review.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+
 // 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 +25,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;
@@ -34,14 +44,6 @@ Usage: ${usage}`);
   }
 }
 
-// packages/cli/src/commands/profile-and-review.ts
-import {
-  setProfile,
-  setReviewProfile,
-  showProfile,
-  showReviewProfile
-} from "@rig/runtime/control-plane/native/profile-ops";
-
 // packages/cli/src/withMutedConsole.ts
 function isPromise(value) {
   if (typeof value !== "object" && typeof value !== "function") {
@@ -81,95 +83,138 @@ function withMutedConsole(mute, fn) {
   }
 }
 
+// packages/cli/src/commands/_paths.ts
+import { resolve } from "path";
+import { resolveMonorepoRoot } from "@rig/runtime/layout";
+function resolveControlPlaneHostStateRoot(projectRoot) {
+  return resolve(projectRoot, ".rig");
+}
+function resolveControlPlaneHostStateDir(projectRoot) {
+  return resolve(resolveControlPlaneHostStateRoot(projectRoot), "state");
+}
+
 // packages/cli/src/commands/profile-and-review.ts
+var DEFAULT_AGENT_PROFILE = {
+  model: "pi",
+  runtime: "pi",
+  agent_plugin: "pi",
+  updated_at: new Date().toISOString()
+};
+function agentProfilePath(projectRoot) {
+  return `${resolveControlPlaneHostStateDir(projectRoot)}/agent-profile.json`;
+}
+function reviewProfilePath(projectRoot) {
+  return `${resolveControlPlaneHostStateDir(projectRoot)}/review-profile.json`;
+}
+function readJson(path) {
+  if (!existsSync(path))
+    return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+async function showProfile(projectRoot) {
+  const profile = { ...DEFAULT_AGENT_PROFILE, ...readJson(agentProfilePath(projectRoot)), model: "pi", runtime: "pi", agent_plugin: "pi" };
+  console.log("Execution Profile:");
+  console.log(`  model:        ${profile.model}`);
+  console.log(`  runtime:      ${profile.runtime}`);
+  console.log(`  plugin:       ${profile.agent_plugin}`);
+}
+async function setProfile(projectRoot) {
+  mkdirSync(resolveControlPlaneHostStateDir(projectRoot), { recursive: true });
+  writeFileSync(agentProfilePath(projectRoot), `${JSON.stringify({ ...DEFAULT_AGENT_PROFILE, updated_at: new Date().toISOString() }, null, 2)}
+`, "utf8");
+  await showProfile(projectRoot);
+}
+async function showReviewProfile(projectRoot) {
+  const parsed = readJson(reviewProfilePath(projectRoot));
+  const profile = {
+    mode: parsed?.mode === "off" || parsed?.mode === "required" || parsed?.mode === "advisory" ? parsed.mode : "advisory",
+    provider: "greptile",
+    updated_at: typeof parsed?.updated_at === "string" ? parsed.updated_at : new Date().toISOString()
+  };
+  console.log("AI Review Profile:");
+  console.log(`  mode:      ${profile.mode}`);
+  console.log(`  provider:  ${profile.provider}`);
+  console.log(`  file:      ${reviewProfilePath(projectRoot)}`);
+}
+async function setReviewProfile(projectRoot, mode, provider) {
+  if (mode !== "off" && mode !== "advisory" && mode !== "required") {
+    throw new Error(`Invalid mode: ${mode}. Use off|advisory|required.`);
+  }
+  if (provider && provider !== "greptile") {
+    throw new Error(`Invalid provider: ${provider}. Supported: greptile.`);
+  }
+  mkdirSync(resolveControlPlaneHostStateDir(projectRoot), { recursive: true });
+  writeFileSync(reviewProfilePath(projectRoot), `${JSON.stringify({ mode, provider: "greptile", updated_at: new Date().toISOString() }, null, 2)}
+`, "utf8");
+  await showReviewProfile(projectRoot);
+}
 async function executeProfile(context, args) {
   const [command = "show", ...rest] = args;
   switch (command) {
     case "show":
-      requireNoExtraArgs(rest, "bun run rig profile show");
+      requireNoExtraArgs(rest, "rig profile show");
       await withMutedConsole(context.outputMode === "json", () => showProfile(context.projectRoot));
       return { ok: true, group: "profile", command };
     case "set": {
-      if (rest.length === 0) {
-        throw new CliError2("Usage: bun run rig profile set <claude-code|codex-cli|pi> or set [--model ...] [--runtime ...] [--plugin ...]");
-      }
-      const preset = rest[0];
-      if (preset && !preset.startsWith("-")) {
-        if (rest.length !== 1) {
-          throw new CliError2("Usage: bun run rig profile set <claude-code|codex-cli|pi>");
-        }
-        try {
-          await withMutedConsole(context.outputMode === "json", () => setProfile(context.projectRoot, { preset }));
-        } catch (error) {
-          throw new CliError2(error instanceof Error ? error.message : String(error), 2);
-        }
-        return { ok: true, group: "profile", command, details: { preset } };
-      }
       let pending = rest;
+      const presetResult = takeOption(pending, "--preset");
+      pending = presetResult.rest;
       const modelResult = takeOption(pending, "--model");
       pending = modelResult.rest;
       const runtimeResult = takeOption(pending, "--runtime");
       pending = runtimeResult.rest;
       const pluginResult = takeOption(pending, "--plugin");
       pending = pluginResult.rest;
-      requireNoExtraArgs(pending, "bun run rig profile set [--model ...] [--runtime ...] [--plugin ...]");
-      if (!modelResult.value && !runtimeResult.value && !pluginResult.value) {
-        throw new CliError2("Provide at least one of --model, --runtime, or --plugin.");
-      }
-      try {
-        await withMutedConsole(context.outputMode === "json", () => setProfile(context.projectRoot, {
-          model: modelResult.value,
-          runtime: runtimeResult.value,
-          plugin: pluginResult.value
-        }));
-      } catch (error) {
-        throw new CliError2(error instanceof Error ? error.message : String(error), 2);
+      requireNoExtraArgs(pending, "rig profile set [--model ...] [--runtime ...] [--plugin ...]");
+      if (!presetResult.value && !modelResult.value && !runtimeResult.value && !pluginResult.value && rest.length === 0) {
+        throw new CliError("Provide at least one of --model, --runtime, or --plugin.", 1, {
+          hint: "Example: `rig profile set --model pi`. See current values with `rig profile show`."
+        });
       }
-      return {
-        ok: true,
-        group: "profile",
-        command,
-        details: {
-          model: modelResult.value || null,
-          runtime: runtimeResult.value || null,
-          plugin: pluginResult.value || null
-        }
-      };
+      await withMutedConsole(context.outputMode === "json", () => setProfile(context.projectRoot));
+      return { ok: true, group: "profile", command, details: { lockedTo: "pi" } };
     }
     default:
-      throw new CliError2(`Unknown profile command: ${command}`);
+      throw new CliError(`Unknown profile command: ${command}`, 1, { hint: "Run `rig profile --help` \u2014 commands are show|set." });
   }
 }
 async function executeReview(context, args) {
   const [command = "show", ...rest] = args;
   switch (command) {
     case "show":
-      requireNoExtraArgs(rest, "bun run rig review show");
+      requireNoExtraArgs(rest, "rig review show");
       await withMutedConsole(context.outputMode === "json", () => showReviewProfile(context.projectRoot));
       return { ok: true, group: "review", command };
     case "set": {
-      if (rest.length === 0) {
-        throw new CliError2("Usage: bun run rig review set <off|advisory|required> [--provider greptile]");
+      let pending = rest;
+      const modeResult = takeOption(pending, "--mode");
+      pending = modeResult.rest;
+      const providerResult = takeOption(pending, "--provider");
+      pending = providerResult.rest;
+      const positionalMode = pending[0];
+      if (modeResult.value && positionalMode) {
+        throw new CliError("Usage: rig review set <off|advisory|required> [--provider greptile]", 1, {
+          hint: "Pass the mode positionally, or use --mode as a compatibility alias, but not both."
+        });
       }
-      const mode = rest[0];
+      requireNoExtraArgs(positionalMode ? pending.slice(1) : pending, "rig review set <off|advisory|required> [--provider greptile]");
+      const mode = modeResult.value ?? positionalMode;
       if (!mode) {
-        throw new CliError2("Usage: bun run rig review set <off|advisory|required> [--provider greptile]");
+        throw new CliError("Usage: rig review set <off|advisory|required> [--provider greptile]", 1);
       }
-      let pending = rest.slice(1);
-      const providerResult = takeOption(pending, "--provider");
-      pending = providerResult.rest;
-      requireNoExtraArgs(pending, "bun run rig review set <off|advisory|required> [--provider greptile]");
       try {
-        await withMutedConsole(context.outputMode === "json", () => {
-          return setReviewProfile(context.projectRoot, mode, providerResult.value);
-        });
+        await withMutedConsole(context.outputMode === "json", () => setReviewProfile(context.projectRoot, mode, providerResult.value));
       } catch (error) {
-        throw new CliError2(error instanceof Error ? error.message : String(error), 2);
+        throw new CliError(error instanceof Error ? error.message : String(error), 2);
       }
-      return { ok: true, group: "review", command, details: { mode, provider: providerResult.value || null } };
+      return { ok: true, group: "review", command, details: { mode, provider: "greptile" } };
     }
     default:
-      throw new CliError2(`Unknown review command: ${command}`);
+      throw new CliError(`Unknown review command: ${command}`, 1, { hint: "Run `rig review --help` \u2014 commands are show|set." });
   }
 }
 export {

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

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

package/dist/src/commands/queue.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 takeFlag(args, flag) {
   const rest = [];
   let value = false;
@@ -27,7 +34,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;
@@ -56,7 +63,7 @@ function parsePositiveInt(value, option, fallback) {
   }
   const parsed = Number.parseInt(value, 10);
   if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new CliError2(`Invalid ${option} value: ${value}`);
+    throw new CliError(`Invalid ${option} value: ${value}`, 1, { hint: `Pass a positive integer, e.g. \`${option} 10\`.` });
   }
   return parsed;
 }
@@ -70,7 +77,7 @@ function parseAction(value) {
   if (value === "pipeline") {
     return "pipeline";
   }
-  throw new CliError2(`Invalid --action value: ${value}. Use validate, verify, or pipeline.`);
+  throw new CliError(`Invalid --action value: ${value}. Use validate, verify, or pipeline.`);
 }
 function parseIsolationMode(value, allowOff) {
   if (!value) {
@@ -82,16 +89,11 @@ function parseIsolationMode(value, allowOff) {
   if (allowOff && value === "off") {
     return value;
   }
-  throw new CliError2(`Invalid isolation mode: ${value}. Use ${allowOff ? "off|" : ""}worktree.`);
+  throw new CliError(`Invalid isolation mode: ${value}. Use ${allowOff ? "off|" : ""}worktree.`);
 }
 
-// packages/cli/src/commands/_preflight.ts
+// packages/cli/src/commands/queue.ts
 import { ensureProjectMainFreshBeforeRun } from "@rig/runtime/control-plane/project-main-pre-run-sync";
-
-// packages/cli/src/commands/_server-client.ts
-import { ensureLocalRigServerConnection } from "@rig/runtime/local-server";
-
-// packages/cli/src/commands/_preflight.ts
 async function runProjectMainSyncPreflight(context, options) {
   if (context.dryRun) {
     if (context.outputMode === "text" && !options.disabled) {
@@ -105,7 +107,7 @@ async function runProjectMainSyncPreflight(context, options) {
     runBootstrap: async () => {
       const bootstrap = await context.runCommand(["bun", "run", "bootstrap"]);
       if (bootstrap.exitCode !== 0) {
-        throw new CliError2(bootstrap.stderr || bootstrap.stdout || "bun run bootstrap failed during project pre-run sync", bootstrap.exitCode || 1);
+        throw new CliError(bootstrap.stderr || bootstrap.stdout || "bun run bootstrap failed during project pre-run sync", bootstrap.exitCode || 1);
       }
     }
   });
@@ -129,8 +131,6 @@ async function runProjectMainSyncPreflight(context, options) {
       break;
   }
 }
-
-// packages/cli/src/commands/queue.ts
 async function executeQueue(context, args) {
   const [command = "run", ...rest] = args;
   switch (command) {
@@ -150,7 +150,7 @@ async function executeQueue(context, args) {
       pending = failFastResult.rest;
       const skipProjectSyncResult = takeFlag(pending, "--skip-project-sync");
       pending = skipProjectSyncResult.rest;
-      requireNoExtraArgs(pending, "bun run rig queue run [--workers <n>] [--max-tasks <n>] [--action validate|verify|pipeline] [--isolation off|worktree] [--no-runtime-reuse] [--fail-fast] [--skip-project-sync]");
+      requireNoExtraArgs(pending, "rig queue run [--workers <n>] [--max-tasks <n>] [--action validate|verify|pipeline] [--isolation off|worktree] [--no-runtime-reuse] [--fail-fast] [--skip-project-sync]");
       const workers = parsePositiveInt(workersResult.value, "--workers", 2);
       const maxTasks = parsePositiveInt(maxTasksResult.value, "--max-tasks", 10);
       const action = parseAction(actionResult.value);
@@ -171,7 +171,7 @@ async function executeQueue(context, args) {
         console.log(`Failed: ${summary.failed}`);
       }
       if (summary.failed > 0) {
-        throw new CliError2(`Queue finished with ${summary.failed} failed task(s).`, 3);
+        throw new CliError(`Queue finished with ${summary.failed} failed task(s).`, 3, { hint: "Inspect the failures with `rig inspect failures`, then re-run `rig queue run`." });
       }
       return {
         ok: true,
@@ -189,7 +189,7 @@ async function executeQueue(context, args) {
       };
     }
     default:
-      throw new CliError2(`Unknown queue command: ${command}`);
+      throw new CliError(`Unknown queue command: ${command}`, 1, { hint: "Run `rig queue --help` \u2014 the primary command is `rig queue run`." });
   }
 }
 export {

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

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