@octavio.bot/review 0.1.3 → 0.1.5

package/README.md

@@ -17,6 +17,19 @@ No GitHub review comments are created or updated.
 bunx --bun @octavio.bot/review@latest review --owner acme --repo web --pr 123 --workdir .
 ```
 
+Initialize Octavio in your repository:
+
+```bash
+bunx --bun @octavio.bot/review@latest init --workdir .
+```
+
+This scaffolds:
+
+- `.octavio/review.config.json`
+- `.github/workflows/review-check.yml`
+
+The generated workflow defaults to `OPENCODE_MODEL=opencode/minimax-m2.5-free` and sets `OPENCODE_API_KEY` to an empty fallback (`''`). If you move to a non-free model, set repository secret `OPENCODE_API_KEY`.
+
 CLI binary name: `octavio-review`.
 
 ## OpenCode Detection and Install
@@ -63,6 +76,12 @@ bun install
 bun run review-bot --owner acme --repo web --pr 123 --instructions-profile balanced --workdir .
 ```
 
+Build and packaging notes:
+
+- `bun run review-cli:build` builds the CLI bundle and syncs prompt markdown into `apps/review-bot-cli/prompts/`
+- `bun run sync` from repo root runs the CLI `sync` task through Turborepo and refreshes generated prompts
+- Prompt source-of-truth lives in `packages/prompts/prompts/*.md`; the app-level `prompts/` directory is generated for publishing
+
 Optional flags:
 
 - `--report-output path/to/review.md`
@@ -72,6 +91,11 @@ Optional flags:
 - `--artifact-execution agent|host`
 - `--install-opencode`
 
+Init flags:
+
+- `--workdir path/to/repo`
+- `--force` (overwrite existing scaffolded files)
+
 ## Instruction Profiles
 
 Instruction resolution order:
@@ -111,9 +135,17 @@ Default artifact schema writes these files into `artifacts/`:
 - Review workflow: `.github/workflows/review-check.yml`
   - Runs profile matrix (`balanced`, `styling`, `security`) with `max-parallel: 1`
   - Uses `bunx --bun @octavio.bot/review@latest`
+  - Defaults to `OPENCODE_MODEL=opencode/minimax-m2.5-free`
+  - Uses `OPENCODE_API_KEY: ${{ secrets.OPENCODE_API_KEY || '' }}`
   - Uploads `review.md`, `confidence.json`, and `result.json`
 - CI workflow: `.github/workflows/ci.yml`
   - Includes smoke test: `bunx --bun @octavio.bot/review@latest doctor`
 - Publish workflow: `.github/workflows/publish-review.yml`
   - Manual only (`workflow_dispatch`)
   - Publishes from `apps/review-bot-cli` using npm trusted publishing (OIDC)
+
+## Troubleshooting
+
+- If runs fail after changing models, set repository secret `OPENCODE_API_KEY`.
+- If OpenCode is unreachable, verify `OPENCODE_HOSTNAME` and `OPENCODE_PORT`.
+- If GitHub API requests fail, verify `GITHUB_TOKEN` permissions.

package/dist/index.mjs

@@ -1694,6 +1694,17 @@ class CodeReviewWorkflow {
   }
 }
 
+// ../../packages/prompts/src/index.ts
+var PROMPT_PROFILES = ["balanced", "styling", "security"];
+var PROMPT_PATHS = {
+  balanced: "../prompts/code-review.md",
+  security: "../prompts/security-review.md",
+  styling: "../prompts/styling-review.md"
+};
+var DEFAULT_PROMPT_PROFILE = "balanced";
+var isPromptProfile = (value) => PROMPT_PROFILES.some((profile) => profile === value);
+var resolvePromptPath = (profile) => Bun.fileURLToPath(new URL(PROMPT_PATHS[profile], import.meta.url));
+
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -15235,7 +15246,7 @@ var envSchema = exports_external.object({
 });
 var POLICY_RULE_REGEX = /^(any|new):(low|medium|high|critical)$/u;
 var artifactExecutionSchema = exports_external.enum(["host", "agent"]);
-var instructionsPromptSchema = exports_external.enum(["balanced", "styling", "security"]);
+var instructionsPromptSchema = exports_external.enum(PROMPT_PROFILES);
 var artifactSchemaConfigSchema = exports_external.object({
   artifactDir: exports_external.string().min(1).optional(),
   confidenceFile: exports_external.string().min(1).optional(),
@@ -15658,40 +15669,379 @@ class OpenCodeReportRunner {
   }
 }
 
-// ../../packages/prompts/src/index.ts
-var PROMPT_PATHS = {
-  balanced: "../prompts/code-review.md",
-  security: "../prompts/security-review.md",
-  styling: "../prompts/styling-review.md"
+// src/init.ts
+var DEFAULT_REVIEW_CONFIG = {
+  defaultProfile: "balanced",
+  profiles: {
+    balanced: {
+      artifactExecution: "agent",
+      artifactSchema: {
+        artifactDir: "artifacts",
+        confidenceFile: "confidence.json",
+        maxAttempts: 2,
+        reviewFile: "review.md"
+      },
+      instructionsPrompt: "balanced",
+      policy: {
+        failOn: ["new:high", "new:critical"]
+      }
+    },
+    security: {
+      artifactExecution: "agent",
+      artifactSchema: {
+        artifactDir: "artifacts",
+        confidenceFile: "confidence.json",
+        maxAttempts: 2,
+        reviewFile: "review.md"
+      },
+      instructionsPrompt: "security",
+      policy: {
+        failOn: ["new:medium", "new:high", "new:critical"]
+      }
+    },
+    styling: {
+      artifactExecution: "agent",
+      artifactSchema: {
+        artifactDir: "artifacts",
+        confidenceFile: "confidence.json",
+        maxAttempts: 2,
+        reviewFile: "review.md"
+      },
+      instructionsPrompt: "styling",
+      policy: {
+        failOn: ["new:high", "new:critical"]
+      }
+    }
+  }
 };
-var DEFAULT_PROMPT_PROFILE = "balanced";
-var isPromptProfile = (value) => Object.hasOwn(PROMPT_PATHS, value);
-var resolvePromptPath = (profile) => Bun.fileURLToPath(new URL(PROMPT_PATHS[profile], import.meta.url));
+var DEFAULT_REVIEW_WORKFLOW = `name: review-check
 
-// src/index.ts
-var REPORT_LOG_MAX_CHARS = 8000;
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+concurrency:
+  group: review-check-pr-\${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  actions: read
+  contents: read
+  pull-requests: read
+
+jobs:
+  review:
+    name: review (\${{ matrix.profile }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      max-parallel: 1
+      matrix:
+        profile: [balanced, styling, security]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Run review check
+        timeout-minutes: 8
+        env:
+          GITHUB_TOKEN: \${{ github.token }}
+          OPENCODE_HOSTNAME: \${{ vars.OPENCODE_HOSTNAME || '127.0.0.1' }}
+          OCTAVIO_INSTRUCTIONS_PROFILE: \${{ matrix.profile }}
+          OPENCODE_MODEL: opencode/minimax-m2.5-free
+          OPENCODE_PORT: \${{ vars.OPENCODE_PORT || '4096' }}
+          OPENCODE_API_KEY: \${{ secrets.OPENCODE_API_KEY || '' }}
+        run: |
+          mkdir -p artifacts
+          PROFILE_ARGS=""
+          if [ -n "$OCTAVIO_INSTRUCTIONS_PROFILE" ]; then
+            PROFILE_ARGS="--instructions-profile $OCTAVIO_INSTRUCTIONS_PROFILE"
+          fi
+          bunx --bun @octavio.bot/review@latest review \\
+            --owner "\${{ github.repository_owner }}" \\
+            --repo "\${{ github.event.repository.name }}" \\
+            --pr "\${{ github.event.pull_request.number }}" \\
+            $PROFILE_ARGS \\
+            --install-opencode \\
+            --workdir . \\
+            --report-output artifacts/review.md \\
+            --findings-output artifacts/confidence.json \\
+            --result-output artifacts/result.json
+
+      - name: Publish job summary
+        if: always()
+        env:
+          OCTAVIO_INSTRUCTIONS_PROFILE: \${{ matrix.profile }}
+        run: |
+          if [ -f artifacts/result.json ]; then
+            bun -e 'const result = await Bun.file("artifacts/result.json").json();
+            const lines = [
+              "## Octavio Review",
+              "",
+              "- Profile: " + (process.env.OCTAVIO_INSTRUCTIONS_PROFILE || "balanced"),
+              "- Blocking findings: " + (result.hasBlockingFindings ? "yes" : "no"),
+              "- Policy source: " + result.policy.source,
+              "- Policy rules: " + (result.policy.failOnRules.join(", ") || "none"),
+              "- Matched rules: " + (result.policy.matchedRules.join(", ") || "none"),
+              "",
+              "### Summary",
+              result.summary,
+            ];
+            await Bun.write(Bun.stdout, lines.join("\\n") + "\\n");' >> "$GITHUB_STEP_SUMMARY"
+          else
+            printf '## Octavio Review
+
+Run failed before report generation.
+
+Troubleshooting:
+- Confirm workflow env uses OPENCODE_MODEL=opencode/minimax-m2.5-free.
+- If you switch to a non-free model, set repository secret OPENCODE_API_KEY.
+- Check run logs for OpenCode connection/auth/model errors.
+' >> "$GITHUB_STEP_SUMMARY"
+          fi
+
+      - name: Upload report artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: octavio-review-report-pr-\${{ github.event.pull_request.number }}-\${{ matrix.profile }}
+          path: artifacts/review.md
+          if-no-files-found: ignore
+
+      - name: Upload confidence artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: octavio-confidence-pr-\${{ github.event.pull_request.number }}-\${{ matrix.profile }}
+          path: artifacts/confidence.json
+          if-no-files-found: ignore
+
+      - name: Upload result artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: octavio-result-pr-\${{ github.event.pull_request.number }}-\${{ matrix.profile }}
+          path: artifacts/result.json
+          if-no-files-found: ignore
+`;
+var scaffoldPlans = () => [
+  {
+    contents: `${JSON.stringify(DEFAULT_REVIEW_CONFIG, null, 2)}
+`,
+    relativePath: ".octavio/review.config.json"
+  },
+  {
+    contents: DEFAULT_REVIEW_WORKFLOW,
+    relativePath: ".github/workflows/review-check.yml"
+  }
+];
+var scaffoldReviewSetup = async (workspaceDirectory, force) => {
+  const results = [];
+  for (const plan of scaffoldPlans()) {
+    const absolutePath = resolvePathFromWorkspace(workspaceDirectory, plan.relativePath);
+    const file2 = Bun.file(absolutePath);
+    const exists = await file2.exists();
+    if (exists && !force) {
+      results.push({
+        relativePath: plan.relativePath,
+        status: "skipped"
+      });
+      continue;
+    }
+    await Bun.write(absolutePath, plan.contents);
+    results.push({
+      relativePath: plan.relativePath,
+      status: exists ? "overwritten" : "created"
+    });
+  }
+  return results;
+};
+
+// src/opencode.ts
 var OPEN_CODE_INSTALL_COMMAND = "curl -fsSL https://opencode.ai/install | bash";
 var OPEN_CODE_INSTALL_COMMAND_NO_PATH = "curl -fsSL https://opencode.ai/install | bash -s -- --no-modify-path";
+var ensureBinaryDirectoryOnPath = (binaryPath) => {
+  const directoryEnd = binaryPath.lastIndexOf("/");
+  if (directoryEnd <= 0) {
+    return;
+  }
+  const directory = binaryPath.slice(0, directoryEnd);
+  const currentPath = process.env.PATH ?? "";
+  const pathEntries = currentPath.split(":").filter((entry) => entry.length > 0);
+  if (pathEntries.includes(directory)) {
+    return;
+  }
+  process.env.PATH = currentPath.length > 0 ? `${directory}:${currentPath}` : directory;
+  process.stdout.write(`Added ${directory} to PATH for this process.
+`);
+};
+var knownOpenCodePaths = () => {
+  const home = process.env.HOME;
+  return [
+    Bun.which("opencode") ?? "",
+    home ? `${home}/.opencode/bin/opencode` : "",
+    home ? `${home}/.local/bin/opencode` : ""
+  ].filter((value, index, values) => value.length > 0 && values.indexOf(value) === index);
+};
+var readProcessOutput = async (stream) => stream ? await new Response(stream).text() : "";
+var getOpenCodeVersion = async (binaryPath) => {
+  const subprocess = Bun.spawn([binaryPath, "--version"], {
+    stderr: "pipe",
+    stdout: "pipe"
+  });
+  const [exitCode, stderr, stdout] = await Promise.all([
+    subprocess.exited,
+    readProcessOutput(subprocess.stderr),
+    readProcessOutput(subprocess.stdout)
+  ]);
+  if (exitCode !== 0) {
+    const details = stderr.trim();
+    return details.length > 0 ? details : null;
+  }
+  const version2 = stdout.trim();
+  return version2.length > 0 ? version2 : null;
+};
+var detectOpenCode = async () => {
+  for (const candidatePath of knownOpenCodePaths()) {
+    const file2 = Bun.file(candidatePath);
+    if (!await file2.exists()) {
+      continue;
+    }
+    const version2 = await getOpenCodeVersion(candidatePath);
+    return {
+      path: candidatePath,
+      version: version2 ?? "unknown"
+    };
+  }
+  return null;
+};
+var runOpenCodeInstall = async () => {
+  process.stdout.write(`OpenCode was not found. Installing now...
+`);
+  process.stdout.write(`Install command: ${OPEN_CODE_INSTALL_COMMAND_NO_PATH}
+`);
+  const subprocess = Bun.spawn(["bash", "-lc", OPEN_CODE_INSTALL_COMMAND_NO_PATH], {
+    stderr: "inherit",
+    stdout: "inherit"
+  });
+  const exitCode = await subprocess.exited;
+  if (exitCode !== 0) {
+    throw new Error([
+      "Failed to auto-install OpenCode.",
+      `Run this manually and retry: ${OPEN_CODE_INSTALL_COMMAND}`
+    ].join(`
+`));
+  }
+};
+var ensureOpenCodeInstalled = async (forceInstall) => {
+  const detectedBeforeInstall = await detectOpenCode();
+  if (detectedBeforeInstall) {
+    ensureBinaryDirectoryOnPath(detectedBeforeInstall.path);
+    process.stdout.write(`OpenCode detected at ${detectedBeforeInstall.path} (${detectedBeforeInstall.version}).
+`);
+    return detectedBeforeInstall;
+  }
+  const shouldAutoInstall = forceInstall || process.env.GITHUB_ACTIONS === "true";
+  if (!shouldAutoInstall) {
+    throw new Error([
+      "OpenCode CLI is required but was not found.",
+      `Install it with: ${OPEN_CODE_INSTALL_COMMAND}`,
+      "Then rerun this command, or pass --install-opencode to auto-install."
+    ].join(`
+`));
+  }
+  await runOpenCodeInstall();
+  const detectedAfterInstall = await detectOpenCode();
+  if (!detectedAfterInstall) {
+    throw new Error([
+      "OpenCode install completed but the binary was still not detected.",
+      `Try opening a new shell or run manually: ${OPEN_CODE_INSTALL_COMMAND}`
+    ].join(`
+`));
+  }
+  process.stdout.write(`OpenCode installed at ${detectedAfterInstall.path} (${detectedAfterInstall.version}).
+`);
+  ensureBinaryDirectoryOnPath(detectedAfterInstall.path);
+  return detectedAfterInstall;
+};
+var runDoctor = async () => {
+  const detected = await detectOpenCode();
+  process.stdout.write(`Octavio doctor
+`);
+  process.stdout.write(`- bun: ${Bun.version}
+`);
+  if (detected) {
+    process.stdout.write(`- opencode: installed (${detected.version})
+`);
+    process.stdout.write(`- opencode-path: ${detected.path}
+`);
+  } else {
+    process.stdout.write(`- opencode: missing
+`);
+    process.stdout.write(`- install: ${OPEN_CODE_INSTALL_COMMAND}
+`);
+  }
+};
+
+// src/troubleshooting.ts
+var troubleshootingGuidance = (message) => {
+  const lower = message.toLowerCase();
+  const guidance = new Set;
+  if (lower.includes("github_token is required")) {
+    guidance.add("Set GITHUB_TOKEN before running the review command.");
+  }
+  if (lower.includes("github api request failed (401") || lower.includes("github api request failed (403")) {
+    guidance.add("Check GITHUB_TOKEN permissions: repository contents read and pull requests read.");
+  }
+  if (lower.includes("econnrefused") || lower.includes("enotfound") || lower.includes("connect")) {
+    guidance.add("Verify OpenCode connectivity (OPENCODE_HOSTNAME and OPENCODE_PORT).");
+  }
+  if (lower.includes("opencode_api_key") || lower.includes("api key") || lower.includes("unauthorized")) {
+    guidance.add("If you are not using a free model, set OPENCODE_API_KEY (repository secret in GitHub Actions, env var locally).");
+  }
+  if (lower.includes("model") && (lower.includes("not found") || lower.includes("unsupported") || lower.includes("unavailable"))) {
+    guidance.add("Use OPENCODE_MODEL=opencode/minimax-m2.5-free, or provide OPENCODE_API_KEY for paid/private models.");
+  }
+  if (lower.includes("429") || lower.includes("rate limit")) {
+    guidance.add("You hit provider limits. Retry later or use a model/account with higher quota.");
+  }
+  return [...guidance];
+};
+
+// src/index.ts
+var REPORT_LOG_MAX_CHARS = 8000;
 var DEFAULT_ARTIFACT_DIR = "artifacts";
 var DEFAULT_REVIEW_FILE = "review.md";
 var DEFAULT_CONFIDENCE_FILE = "confidence.json";
 var DEFAULT_ARTIFACT_MAX_ATTEMPTS = 2;
 var DEFAULT_ARTIFACT_EXECUTION = "agent";
+var INSTRUCTIONS_PROFILE_LIST = PROMPT_PROFILES.join("|");
 var usage = () => [
   "Usage:",
   "  octavio-review review --owner <owner> --repo <repo> --pr <number> [options]",
+  "  octavio-review init [options]",
   "  octavio-review doctor",
   "  octavio-review install-opencode",
   "",
   "Options for review:",
   "  --instructions <path>",
-  "  --instructions-profile <balanced|styling|security>",
+  `  --instructions-profile <${INSTRUCTIONS_PROFILE_LIST}>`,
   "  --artifact-execution <agent|host>",
   "  --workdir <path>",
   "  --report-output <path>",
   "  --findings-output <path>",
   "  --result-output <path>",
-  "  --install-opencode (force auto-install if missing)"
+  "  --install-opencode (force auto-install if missing)",
+  "",
+  "Options for init:",
+  "  --workdir <path>",
+  "  --force (overwrite existing files)"
 ].join(`
 `);
 var parseArtifactExecution = (rawValue) => {
@@ -15767,6 +16117,18 @@ ${usage()}`);
     workspaceDirectory
   };
 };
+var parseInitInput = (argv) => {
+  const { flags, positional } = parseArgs(argv);
+  if (positional.length > 0) {
+    throw new Error(`Unexpected positional arguments for init: ${positional.join(", ")}
+
+${usage()}`);
+  }
+  return {
+    force: hasBooleanFlag(flags, "force"),
+    workspaceDirectory: resolveWorkspaceDirectory(getStringFlag(flags, "workdir") ?? process.cwd())
+  };
+};
 var resolveInstructions = (cliInput, config2) => {
   const selectedProfileName = cliInput.instructionsProfile ?? config2?.defaultProfile;
   const selectedProfile = selectedProfileName ? config2?.profiles[selectedProfileName] : undefined;
@@ -15777,7 +16139,7 @@ var resolveInstructions = (cliInput, config2) => {
   if (selectedProfile) {
     const profilePrompt = selectedProfile.instructionsPrompt;
     if (!isPromptProfile(profilePrompt)) {
-      throw new Error(`Unsupported instructionsPrompt '${profilePrompt}'. Supported values: balanced, styling, security.`);
+      throw new Error(`Unsupported instructionsPrompt '${profilePrompt}'. Supported values: ${PROMPT_PROFILES.join(", ")}.`);
     }
     resolvedPath = resolvePromptPath(profilePrompt);
   }
@@ -15798,127 +16160,26 @@ var defaultResultPath = (pullNumber) => {
 };
 var truncateForLogs = (value) => value.length > REPORT_LOG_MAX_CHARS ? `${value.slice(0, REPORT_LOG_MAX_CHARS)}
 ...truncated...` : value;
-var ensureBinaryDirectoryOnPath = (binaryPath) => {
-  const directoryEnd = binaryPath.lastIndexOf("/");
-  if (directoryEnd <= 0) {
-    return;
-  }
-  const directory = binaryPath.slice(0, directoryEnd);
-  const currentPath = process.env.PATH ?? "";
-  const pathEntries = currentPath.split(":").filter((entry) => entry.length > 0);
-  if (pathEntries.includes(directory)) {
-    return;
-  }
-  process.env.PATH = currentPath.length > 0 ? `${directory}:${currentPath}` : directory;
-  process.stdout.write(`Added ${directory} to PATH for this process.
-`);
-};
-var knownOpenCodePaths = () => {
-  const home = process.env.HOME;
-  return [
-    Bun.which("opencode") ?? "",
-    home ? `${home}/.opencode/bin/opencode` : "",
-    home ? `${home}/.local/bin/opencode` : ""
-  ].filter((value, index, values) => value.length > 0 && values.indexOf(value) === index);
-};
-var readProcessOutput = async (stream) => stream ? await new Response(stream).text() : "";
-var getOpenCodeVersion = async (binaryPath) => {
-  const subprocess = Bun.spawn([binaryPath, "--version"], {
-    stderr: "pipe",
-    stdout: "pipe"
-  });
-  const [exitCode, stderr, stdout] = await Promise.all([
-    subprocess.exited,
-    readProcessOutput(subprocess.stderr),
-    readProcessOutput(subprocess.stdout)
-  ]);
-  if (exitCode !== 0) {
-    const details = stderr.trim();
-    return details.length > 0 ? details : null;
-  }
-  const version2 = stdout.trim();
-  return version2.length > 0 ? version2 : null;
-};
-var detectOpenCode = async () => {
-  for (const candidatePath of knownOpenCodePaths()) {
-    const file2 = Bun.file(candidatePath);
-    if (!await file2.exists()) {
-      continue;
-    }
-    const version2 = await getOpenCodeVersion(candidatePath);
-    return {
-      path: candidatePath,
-      version: version2 ?? "unknown"
-    };
-  }
-  return null;
-};
-var runOpenCodeInstall = async () => {
-  process.stdout.write(`OpenCode was not found. Installing now...
+var runInit = async (argv) => {
+  const input = parseInitInput(argv);
+  process.stdout.write(`Initializing Octavio review in ${input.workspaceDirectory}...
 `);
-  process.stdout.write(`Install command: ${OPEN_CODE_INSTALL_COMMAND_NO_PATH}
+  const results = await scaffoldReviewSetup(input.workspaceDirectory, input.force);
+  for (const result of results) {
+    process.stdout.write(`- ${result.status}: ${result.relativePath}
 `);
-  const subprocess = Bun.spawn(["bash", "-lc", OPEN_CODE_INSTALL_COMMAND_NO_PATH], {
-    stderr: "inherit",
-    stdout: "inherit"
-  });
-  const exitCode = await subprocess.exited;
-  if (exitCode !== 0) {
-    throw new Error([
-      "Failed to auto-install OpenCode.",
-      `Run this manually and retry: ${OPEN_CODE_INSTALL_COMMAND}`
-    ].join(`
-`));
   }
-};
-var ensureOpenCodeInstalled = async (forceInstall) => {
-  const detectedBeforeInstall = await detectOpenCode();
-  if (detectedBeforeInstall) {
-    ensureBinaryDirectoryOnPath(detectedBeforeInstall.path);
-    process.stdout.write(`OpenCode detected at ${detectedBeforeInstall.path} (${detectedBeforeInstall.version}).
+  const skippedCount = results.filter((result) => result.status === "skipped").length;
+  if (skippedCount > 0 && !input.force) {
+    process.stdout.write(`Some files already existed and were skipped. Re-run with --force to overwrite.
 `);
-    return detectedBeforeInstall;
   }
-  const shouldAutoInstall = forceInstall || process.env.GITHUB_ACTIONS === "true";
-  if (!shouldAutoInstall) {
-    throw new Error([
-      "OpenCode CLI is required but was not found.",
-      `Install it with: ${OPEN_CODE_INSTALL_COMMAND}`,
-      "Then rerun this command, or pass --install-opencode to auto-install."
-    ].join(`
-`));
-  }
-  await runOpenCodeInstall();
-  const detectedAfterInstall = await detectOpenCode();
-  if (!detectedAfterInstall) {
-    throw new Error([
-      "OpenCode install completed but the binary was still not detected.",
-      `Try opening a new shell or run manually: ${OPEN_CODE_INSTALL_COMMAND}`
-    ].join(`
-`));
-  }
-  process.stdout.write(`OpenCode installed at ${detectedAfterInstall.path} (${detectedAfterInstall.version}).
-`);
-  ensureBinaryDirectoryOnPath(detectedAfterInstall.path);
-  return detectedAfterInstall;
-};
-var runDoctor = async () => {
-  const detected = await detectOpenCode();
-  process.stdout.write(`Octavio doctor
-`);
-  process.stdout.write(`- bun: ${Bun.version}
-`);
-  if (detected) {
-    process.stdout.write(`- opencode: installed (${detected.version})
+  process.stdout.write(`Next steps:
 `);
-    process.stdout.write(`- opencode-path: ${detected.path}
+  process.stdout.write(`1. Commit .octavio/review.config.json and .github/workflows/review-check.yml.
 `);
-  } else {
-    process.stdout.write(`- opencode: missing
+  process.stdout.write(`2. Optional: set OPENCODE_API_KEY if you switch away from the default free model.
 `);
-    process.stdout.write(`- install: ${OPEN_CODE_INSTALL_COMMAND}
-`);
-  }
 };
 var runReview = async (argv) => {
   const cliInput = parseReviewInput(argv);
@@ -16011,6 +16272,10 @@ var run = async () => {
     await runDoctor();
     return;
   }
+  if (firstArg === "init") {
+    await runInit(args.slice(1));
+    return;
+  }
   if (firstArg === "install-opencode") {
     await ensureOpenCodeInstalled(true);
     return;
@@ -16033,6 +16298,15 @@ try {
   const message = error48 instanceof Error ? error48.message : String(error48);
   process.stderr.write(`octavio-review failed: ${message}
 `);
+  const guidance = troubleshootingGuidance(message);
+  if (guidance.length > 0) {
+    process.stderr.write(`Troubleshooting:
+`);
+    for (const line of guidance) {
+      process.stderr.write(`- ${line}
+`);
+    }
+  }
   process.exitCode = 1;
 }
 await Bun.sleep(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octavio.bot/review",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "private": false,
   "description": "CLI for OpenCode-powered pull request review checks",
   "homepage": "https://github.com/rustydotwtf/octavio.bot/tree/main/apps/review-bot-cli",
@@ -13,7 +13,7 @@
     "directory": "apps/review-bot-cli"
   },
   "bin": {
-    "octavio-review": "./dist/index.mjs"
+    "octavio-review": "dist/index.mjs"
   },
   "files": [
     "dist",
@@ -24,7 +24,10 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bun build ./src/index.ts --outfile ./dist/index.mjs --target bun --banner '#!/usr/bin/env bun' && chmod +x ./dist/index.mjs && rm -rf ./prompts && mkdir -p ./prompts && cp ../../packages/prompts/prompts/*.md ./prompts/",
+    "build:bin": "bun build ./src/index.ts --outfile ./dist/index.mjs --target bun --banner '#!/usr/bin/env bun' && chmod +x ./dist/index.mjs",
+    "sync:prompts": "[ -d ../../packages/prompts/prompts ] || (echo 'Missing prompts source: ../../packages/prompts/prompts' && exit 1) && rm -rf ./prompts && mkdir -p ./prompts && cp ../../packages/prompts/prompts/*.md ./prompts/",
+    "sync": "bun run sync:prompts",
+    "build": "bun run build:bin && bun run sync:prompts",
     "prepack": "bun run build"
   },
   "dependencies": {