can-i-merge 0.1.1 → 0.3.0

package/README.md

@@ -47,9 +47,11 @@ The **Context Engine** is the real product.
     - OpenAI
     - NVIDIA
     - Gemini
-    - Ollama
+    - Ollama (local LLM)
     - OpenRouter
+    - Custom (any OpenAI-compatible endpoint, including self-hosted/local LLM servers)
 - Provider abstraction
+- Encrypted local credential storage (`--api-key`/`--model`/`--base-url`, saved for future runs)
 - GitHub Action (Planned)
 - VSCode Extension (Planned)
 - MCP Server (Planned)
@@ -112,6 +114,26 @@ Choose AI provider
 can-i-merge --provider claude
 ```
 
+Use a local LLM (e.g. Ollama)
+
+```bash
+can-i-merge --provider ollama --model llama3.1
+```
+
+Point at any custom OpenAI-compatible endpoint (self-hosted, local server, etc.)
+
+```bash
+can-i-merge --provider custom --base-url http://localhost:1234/v1 --model local-model
+```
+
+API key / model / base URL are saved encrypted under `~/.can-i-merge` after the first run, so later runs don't need the flags again:
+
+```bash
+can-i-merge --provider openai --api-key sk-... --model gpt-4.1   # saved
+can-i-merge --provider openai                                    # reuses the saved key/model
+can-i-merge --provider openai --forget-credentials                # removes them
+```
+
 Security review
 
 ```bash
@@ -200,6 +222,9 @@ Move authorization check before JWT validation.
        │ NVIDIA                   │
        │ Gemini                   │
        │ Ollama                   │
+       │ OpenRouter               │
+       │ Custom (any OpenAI-      │
+       │   compatible endpoint)   │
        └──────────────────────────┘
                        │
                        ▼

package/dist/cli/index.js

@@ -10,10 +10,17 @@ import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
+import { clearProviderConfig, loadProviderConfig, saveProviderConfig } from "../config/index.js";
 import { NoChangesError, runReview } from "../core/index.js";
 import { isGitRepository } from "../git/index.js";
 import { ProviderRegistry } from "../provider/index.js";
 import { ClaudeProvider } from "../provider-anthropic/index.js";
+import { CustomProvider } from "../provider-custom/index.js";
+import { GeminiProvider } from "../provider-gemini/index.js";
+import { NvidiaProvider } from "../provider-nvidia/index.js";
+import { OllamaProvider } from "../provider-ollama/index.js";
+import { OpenAIProvider } from "../provider-openai/index.js";
+import { OpenRouterProvider } from "../provider-openrouter/index.js";
 import { isMergeReady, reportConsole, reportJson } from "../reporter/index.js";
 import { colors } from "../shared/colors.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -31,6 +38,19 @@ const STAGE_MESSAGES = {
     context: "Building Context...",
     reviewing: "Reviewing...",
 };
+const PROVIDER_ENV_VARS = {
+    claude: { apiKey: "ANTHROPIC_API_KEY", model: "ANTHROPIC_MODEL" },
+    openai: { apiKey: "OPENAI_API_KEY", model: "OPENAI_MODEL", baseURL: "OPENAI_BASE_URL" },
+    nvidia: { apiKey: "NVIDIA_API_KEY", model: "NVIDIA_MODEL", baseURL: "NVIDIA_BASE_URL" },
+    ollama: { apiKey: "OLLAMA_API_KEY", model: "OLLAMA_MODEL", baseURL: "OLLAMA_BASE_URL" },
+    gemini: { apiKey: "GEMINI_API_KEY", model: "GEMINI_MODEL", baseURL: "GEMINI_BASE_URL" },
+    openrouter: {
+        apiKey: "OPENROUTER_API_KEY",
+        model: "OPENROUTER_MODEL",
+        baseURL: "OPENROUTER_BASE_URL",
+    },
+    custom: { apiKey: "CUSTOM_API_KEY", model: "CUSTOM_MODEL", baseURL: "CUSTOM_BASE_URL" },
+};
 function isReviewLevel(value) {
     return REVIEW_LEVELS.includes(value);
 }
@@ -40,6 +60,12 @@ function isReviewType(value) {
 function buildProviderRegistry() {
     const registry = new ProviderRegistry();
     registry.register("claude", (config) => new ClaudeProvider(config));
+    registry.register("openai", (config) => new OpenAIProvider(config));
+    registry.register("nvidia", (config) => new NvidiaProvider(config));
+    registry.register("ollama", (config) => new OllamaProvider(config));
+    registry.register("gemini", (config) => new GeminiProvider(config));
+    registry.register("openrouter", (config) => new OpenRouterProvider(config));
+    registry.register("custom", (config) => new CustomProvider(config));
     return registry;
 }
 export async function main(argv = process.argv) {
@@ -49,13 +75,24 @@ export async function main(argv = process.argv) {
         .description("AI-powered Git Review Pipeline with Intelligent Context Building")
         .version(pkg.version)
         .option("--commit <ref>", "review a specific commit instead of the staged index")
-        .option("--provider <name>", "AI provider to use", "claude")
+        .option("--provider <name>", "AI provider to use: claude, openai, nvidia, ollama, gemini, openrouter, or custom " +
+        "(any OpenAI-compatible endpoint, including local LLM servers)", "claude")
+        .option("--api-key <key>", "API key for the selected provider (saved encrypted for future runs)")
+        .option("--model <model>", "model name for the selected provider (saved for future runs)")
+        .option("--base-url <url>", "API base URL for the selected provider, e.g. a local LLM server or other " +
+        "OpenAI-compatible endpoint (saved for future runs; required for --provider custom)")
+        .option("--forget-credentials", "remove stored credentials for the selected provider and exit", false)
         .option("--level <level>", "review level: fast, normal, or deep", "normal")
         .option("--type <type>", "review focus: general, security, performance, architecture, or style", "general")
         .option("--json", "output the review result as JSON", false)
         .option("--fix", "automatically apply suggested fixes (not yet supported)", false);
     program.parse(argv);
     const opts = program.opts();
+    if (opts.forgetCredentials) {
+        clearProviderConfig(opts.provider);
+        console.log(colors.green(`Removed stored credentials for provider "${opts.provider}".`));
+        return;
+    }
     if (opts.fix) {
         console.error(colors.yellow("--fix is not supported yet (see TOBE.md roadmap, Phase 4)."));
         process.exitCode = 2;
@@ -77,10 +114,27 @@ export async function main(argv = process.argv) {
         process.exitCode = 2;
         return;
     }
+    if (opts.apiKey !== undefined || opts.model !== undefined || opts.baseUrl !== undefined) {
+        saveProviderConfig(opts.provider, {
+            apiKey: opts.apiKey,
+            model: opts.model,
+            baseURL: opts.baseUrl,
+        });
+        if (!opts.json) {
+            console.log(colors.dim(`Saved ${opts.provider} credentials to ~/.can-i-merge (encrypted).`));
+        }
+    }
+    const stored = loadProviderConfig(opts.provider);
+    const envVars = PROVIDER_ENV_VARS[opts.provider];
+    const apiKey = opts.apiKey ?? (envVars && process.env[envVars.apiKey]) ?? stored.apiKey;
+    const model = opts.model ?? (envVars && process.env[envVars.model]) ?? stored.model;
+    const baseURL = opts.baseUrl ??
+        (envVars?.baseURL && process.env[envVars.baseURL]) ??
+        stored.baseURL;
     const registry = buildProviderRegistry();
     let provider;
     try {
-        provider = registry.create(opts.provider);
+        provider = registry.create(opts.provider, { apiKey, model, baseURL });
     }
     catch (err) {
         console.error(colors.red(err instanceof Error ? err.message : String(err)));

package/dist/config/credentialStore.js

@@ -0,0 +1,124 @@
+/**
+ * Local, encrypted credential store for provider API keys.
+ *
+ * CLI flags and env vars are per-invocation. This store lets a user pass
+ * --api-key/--model once and have it picked up automatically on every later
+ * run, without re-exporting an env var each time.
+ *
+ * The encryption key is a random 32-byte value generated on first use and
+ * kept in a file (key) separate from the ciphertext (credentials.json),
+ * both under the user's home directory with owner-only permissions. This
+ * guards against accidental exposure (e.g. a backup or sync tool scooping up
+ * one file but not the other) - it does not protect against an attacker who
+ * already has read access to the user's home directory, since the key lives
+ * on the same machine as the ciphertext.
+ */
+import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+const CONFIG_DIR = path.join(homedir(), ".can-i-merge");
+const KEY_FILE = path.join(CONFIG_DIR, "key");
+const CREDENTIALS_FILE = path.join(CONFIG_DIR, "credentials.json");
+const ALGORITHM = "aes-256-gcm";
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+function getOrCreateKey() {
+    ensureConfigDir();
+    if (existsSync(KEY_FILE)) {
+        return Buffer.from(readFileSync(KEY_FILE, "utf8"), "base64");
+    }
+    const key = randomBytes(32);
+    writeFileSync(KEY_FILE, key.toString("base64"), { mode: 0o600 });
+    return key;
+}
+function encrypt(plaintext, key) {
+    const iv = randomBytes(12);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    const data = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
+    return {
+        iv: iv.toString("base64"),
+        tag: cipher.getAuthTag().toString("base64"),
+        data: data.toString("base64"),
+    };
+}
+function decrypt(value, key) {
+    const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(value.iv, "base64"));
+    decipher.setAuthTag(Buffer.from(value.tag, "base64"));
+    const data = Buffer.concat([
+        decipher.update(Buffer.from(value.data, "base64")),
+        decipher.final(),
+    ]);
+    return data.toString("utf8");
+}
+function readCredentialsFile() {
+    if (!existsSync(CREDENTIALS_FILE)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(CREDENTIALS_FILE, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeCredentialsFile(contents) {
+    ensureConfigDir();
+    writeFileSync(CREDENTIALS_FILE, JSON.stringify(contents, null, 2), { mode: 0o600 });
+}
+/** Persist an API key, model, and/or base URL for a provider, encrypting the API key at rest. */
+export function saveProviderConfig(provider, config) {
+    const file = readCredentialsFile();
+    const next = { ...file[provider] };
+    if (config.apiKey !== undefined) {
+        next.apiKey = encrypt(config.apiKey, getOrCreateKey());
+    }
+    if (config.model !== undefined) {
+        next.model = config.model;
+    }
+    if (config.baseURL !== undefined) {
+        next.baseURL = config.baseURL;
+    }
+    file[provider] = next;
+    writeCredentialsFile(file);
+}
+/** Load a previously persisted API key/model/base URL for a provider, decrypting the API key. */
+export function loadProviderConfig(provider) {
+    const stored = readCredentialsFile()[provider];
+    if (!stored) {
+        return {};
+    }
+    const result = {};
+    if (stored.apiKey) {
+        try {
+            result.apiKey = decrypt(stored.apiKey, getOrCreateKey());
+        }
+        catch {
+            // Key file missing/rotated or ciphertext corrupted - treat as absent
+            // rather than crashing the CLI.
+        }
+    }
+    if (stored.model) {
+        result.model = stored.model;
+    }
+    if (stored.baseURL) {
+        result.baseURL = stored.baseURL;
+    }
+    return result;
+}
+/** Remove stored credentials for a provider (or all providers if omitted). */
+export function clearProviderConfig(provider) {
+    if (!existsSync(CREDENTIALS_FILE)) {
+        return;
+    }
+    if (!provider) {
+        unlinkSync(CREDENTIALS_FILE);
+        return;
+    }
+    const file = readCredentialsFile();
+    delete file[provider];
+    writeCredentialsFile(file);
+}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+/**
+ * config package entry point. Re-exports the encrypted credential store.
+ */
+export * from "./credentialStore.js";

package/dist/provider-custom/customProvider.js

@@ -0,0 +1,38 @@
+/**
+ * Custom provider - talks to any OpenAI chat-completions-compatible
+ * endpoint the user points it at: a self-hosted/local LLM server (LM
+ * Studio, vLLM, llama.cpp server, text-generation-webui, ...), or any
+ * other API that speaks the OpenAI wire format. Unlike the other
+ * OpenAI-compatible providers, there is no default base URL - the caller
+ * must supply one. Delegates the actual request/response handling to the
+ * shared OpenAI-compatible reviewer.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export class CustomProvider {
+    name = "custom";
+    delegate;
+    constructor(options = {}) {
+        const baseURL = options.baseURL ?? process.env.CUSTOM_BASE_URL;
+        if (!baseURL) {
+            throw new Error('Missing endpoint URL for the custom provider. Set the CUSTOM_BASE_URL environment variable, or pass --base-url / { baseURL } (e.g. "http://localhost:1234/v1" for a local server, or the base URL of any OpenAI-compatible API).');
+        }
+        const model = options.model ?? process.env.CUSTOM_MODEL;
+        if (!model) {
+            throw new Error("Missing model for the custom provider. Set the CUSTOM_MODEL environment variable, or pass --model / { model }.");
+        }
+        // Many self-hosted/local servers don't require a real API key, but the
+        // OpenAI SDK still needs a non-empty string - fall back to a
+        // placeholder, same as the Ollama provider does.
+        const apiKey = options.apiKey ?? process.env.CUSTOM_API_KEY ?? "not-needed";
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/provider-custom/index.js

@@ -0,0 +1,6 @@
+/**
+ * provider-custom package entry point. Re-exports the Custom provider.
+ * Does NOT register the provider into any registry - that wiring happens
+ * elsewhere (e.g. in the CLI or core composition root).
+ */
+export * from "./customProvider.js";

package/dist/provider-gemini/geminiProvider.js

@@ -0,0 +1,33 @@
+/**
+ * Gemini provider - talks to Google's OpenAI-compatible endpoint for
+ * Gemini models at https://generativelanguage.googleapis.com/v1beta/openai/.
+ * Delegates the actual request/response handling to the shared
+ * OpenAI-compatible reviewer.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export const DEFAULT_GEMINI_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai/";
+export class GeminiProvider {
+    name = "gemini";
+    delegate;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env.GEMINI_API_KEY;
+        if (!apiKey) {
+            throw new Error("Missing Gemini API key. Set the GEMINI_API_KEY environment variable, or pass { apiKey } when constructing GeminiProvider.");
+        }
+        const model = options.model ?? process.env.GEMINI_MODEL;
+        if (!model) {
+            throw new Error('Missing Gemini model. Set the GEMINI_MODEL environment variable, or pass { model } when constructing GeminiProvider (e.g. "gemini-2.5-flash").');
+        }
+        const baseURL = options.baseURL ?? process.env.GEMINI_BASE_URL ?? DEFAULT_GEMINI_BASE_URL;
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/provider-gemini/index.js

@@ -0,0 +1,6 @@
+/**
+ * provider-gemini package entry point. Re-exports the Gemini provider.
+ * Does NOT register the provider into any registry - that wiring happens
+ * elsewhere (e.g. in the CLI or core composition root).
+ */
+export * from "./geminiProvider.js";

package/dist/provider-nvidia/index.js

@@ -0,0 +1 @@
+export * from "./nvidiaProvider.js";

package/dist/provider-nvidia/nvidiaProvider.js

@@ -0,0 +1,33 @@
+/**
+ * NVIDIA provider - talks to NVIDIA's OpenAI-chat-completions-compatible
+ * endpoint for NIM-hosted foundation models (e.g. Llama, Nemotron) at
+ * https://integrate.api.nvidia.com/v1. Delegates the actual request/response
+ * handling to the shared OpenAI-compatible reviewer.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export const DEFAULT_NVIDIA_BASE_URL = "https://integrate.api.nvidia.com/v1";
+export class NvidiaProvider {
+    name = "nvidia";
+    delegate;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env.NVIDIA_API_KEY;
+        if (!apiKey) {
+            throw new Error("Missing NVIDIA API key. Set the NVIDIA_API_KEY environment variable, or pass { apiKey } when constructing NvidiaProvider.");
+        }
+        const model = options.model ?? process.env.NVIDIA_MODEL;
+        if (!model) {
+            throw new Error('Missing NVIDIA model. Set the NVIDIA_MODEL environment variable, or pass { model } when constructing NvidiaProvider (e.g. "meta/llama-3.1-70b-instruct" - see the model catalog at https://build.nvidia.com).');
+        }
+        const baseURL = options.baseURL ?? process.env.NVIDIA_BASE_URL ?? DEFAULT_NVIDIA_BASE_URL;
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/provider-ollama/index.js

@@ -0,0 +1,6 @@
+/**
+ * provider-ollama package entry point. Re-exports the Ollama provider.
+ * Does NOT register the provider into any registry - that wiring happens
+ * elsewhere (e.g. in the CLI or core composition root).
+ */
+export * from "./ollamaProvider.js";

package/dist/provider-ollama/ollamaProvider.js

@@ -0,0 +1,34 @@
+/**
+ * Ollama provider - talks to a local Ollama instance via its OpenAI
+ * chat-completions-compatible endpoint (http://localhost:11434/v1 by
+ * default). Delegates the actual request/response handling to
+ * createOpenAICompatibleReviewer.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434/v1";
+export class OllamaProvider {
+    name = "ollama";
+    delegate;
+    constructor(options = {}) {
+        // Ollama does not require a real API key for local use, but the OpenAI
+        // SDK requires some non-empty string - fall back to a placeholder.
+        const apiKey = options.apiKey ?? process.env.OLLAMA_API_KEY ?? "ollama";
+        const model = options.model ?? process.env.OLLAMA_MODEL;
+        if (!model) {
+            throw new Error('Missing Ollama model. Set the OLLAMA_MODEL environment variable, or pass { model } when ' +
+                'constructing OllamaProvider to the name of a model you have pulled locally (e.g. "ollama pull ' +
+                'llama3.1", then OLLAMA_MODEL=llama3.1). The model must support tool/function calling.');
+        }
+        const baseURL = options.baseURL ?? process.env.OLLAMA_BASE_URL ?? DEFAULT_OLLAMA_BASE_URL;
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/provider-openai/index.js

@@ -0,0 +1,6 @@
+/**
+ * provider-openai package entry point. Re-exports the OpenAI provider.
+ * Does NOT register the provider into any registry - that wiring happens
+ * elsewhere (e.g. in the CLI or core composition root).
+ */
+export * from "./openAIProvider.js";

package/dist/provider-openai/openAIProvider.js

@@ -0,0 +1,32 @@
+/**
+ * OpenAI provider - implements ReviewProvider by delegating to the shared
+ * OpenAI-compatible reviewer (createOpenAICompatibleReviewer), which speaks
+ * the OpenAI chat-completions wire format and forces structured output via
+ * a "submit_review" tool call.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export class OpenAIProvider {
+    name = "openai";
+    delegate;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error("Missing OpenAI API key. Set the OPENAI_API_KEY environment variable, or pass { apiKey } when constructing OpenAIProvider.");
+        }
+        const model = options.model ?? process.env.OPENAI_MODEL;
+        if (!model) {
+            throw new Error('Missing OpenAI model. Set the OPENAI_MODEL environment variable, or pass { model } when constructing OpenAIProvider (e.g. "gpt-4.1").');
+        }
+        const baseURL = options.baseURL ?? process.env.OPENAI_BASE_URL;
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/provider-openrouter/index.js

@@ -0,0 +1,6 @@
+/**
+ * provider-openrouter package entry point. Re-exports the OpenRouter
+ * provider. Does NOT register the provider into any registry - that wiring
+ * happens elsewhere (e.g. in the CLI or core composition root).
+ */
+export * from "./openRouterProvider.js";

package/dist/provider-openrouter/openRouterProvider.js

@@ -0,0 +1,33 @@
+/**
+ * OpenRouter provider - talks to OpenRouter's OpenAI-compatible endpoint at
+ * https://openrouter.ai/api/v1, which fronts many models (Claude, GPT,
+ * Gemini, Llama, and more) behind a single API key. Delegates the actual
+ * request/response handling to the shared OpenAI-compatible reviewer.
+ */
+import { createOpenAICompatibleReviewer } from "../shared/openaiCompatibleProvider.js";
+export const DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+export class OpenRouterProvider {
+    name = "openrouter";
+    delegate;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env.OPENROUTER_API_KEY;
+        if (!apiKey) {
+            throw new Error("Missing OpenRouter API key. Set the OPENROUTER_API_KEY environment variable, or pass { apiKey } when constructing OpenRouterProvider.");
+        }
+        const model = options.model ?? process.env.OPENROUTER_MODEL;
+        if (!model) {
+            throw new Error('Missing OpenRouter model. Set the OPENROUTER_MODEL environment variable, or pass { model } when constructing OpenRouterProvider (e.g. "anthropic/claude-sonnet-5" - see the model catalog at https://openrouter.ai/models).');
+        }
+        const baseURL = options.baseURL ?? process.env.OPENROUTER_BASE_URL ?? DEFAULT_OPENROUTER_BASE_URL;
+        this.delegate = createOpenAICompatibleReviewer({
+            providerName: this.name,
+            apiKey,
+            model,
+            baseURL,
+            maxOutputTokens: options.maxOutputTokens,
+        });
+    }
+    async review(context) {
+        return this.delegate.review(context);
+    }
+}

package/dist/shared/openaiCompatibleProvider.js

@@ -0,0 +1,125 @@
+/**
+ * Shared base for any ReviewProvider that speaks the OpenAI chat-completions
+ * wire format - OpenAI itself, and OpenAI-compatible endpoints (NVIDIA NIM,
+ * Ollama's /v1 API). Each concrete provider (provider-openai, provider-nvidia,
+ * provider-ollama) just supplies its own api key / model / base URL defaults
+ * and delegates review() to the reviewer this factory returns.
+ */
+import OpenAI from "openai";
+const SUBMIT_REVIEW_FUNCTION_NAME = "submit_review";
+function buildSubmitReviewTool() {
+    return {
+        type: "function",
+        function: {
+            name: SUBMIT_REVIEW_FUNCTION_NAME,
+            description: "Submit the code review findings: an overall summary plus a list of issues discovered in the diff.",
+            parameters: {
+                type: "object",
+                properties: {
+                    summary: {
+                        type: "string",
+                        description: "A concise, high-level summary of the overall review.",
+                    },
+                    issues: {
+                        type: "array",
+                        description: "The list of individual issues found while reviewing the diff.",
+                        items: {
+                            type: "object",
+                            properties: {
+                                severity: {
+                                    type: "string",
+                                    enum: ["critical", "high", "medium", "low"],
+                                    description: "How severe this issue is.",
+                                },
+                                category: {
+                                    type: "string",
+                                    enum: ["security", "performance", "architecture", "style", "bug"],
+                                    description: "The category this issue falls under.",
+                                },
+                                title: { type: "string", description: "A short, human-readable title for the issue." },
+                                description: { type: "string", description: "A detailed explanation of the issue." },
+                                file: { type: "string", description: "The path of the file this issue was found in." },
+                                line: { type: "number", description: "The line number in the file where this issue occurs." },
+                                suggestion: {
+                                    type: "string",
+                                    description: "A concrete suggestion for how to fix or address the issue.",
+                                },
+                                confidence: {
+                                    type: "number",
+                                    description: "A confidence score (0 to 1) that this issue is a real, valid finding.",
+                                },
+                            },
+                            required: [
+                                "severity",
+                                "category",
+                                "title",
+                                "description",
+                                "file",
+                                "line",
+                                "suggestion",
+                                "confidence",
+                            ],
+                        },
+                    },
+                },
+                required: ["summary", "issues"],
+            },
+        },
+    };
+}
+const submitReviewTool = buildSubmitReviewTool();
+/**
+ * Builds a ReviewProvider that talks to any OpenAI chat-completions-compatible
+ * endpoint, forcing structured output via a named tool call (mirrors how
+ * ClaudeProvider forces its submit_review tool use).
+ */
+export function createOpenAICompatibleReviewer(options) {
+    const client = new OpenAI({ apiKey: options.apiKey, baseURL: options.baseURL });
+    return {
+        name: options.providerName,
+        async review(context) {
+            if (!context.prompt) {
+                throw new Error("ReviewContext.prompt is not set - run the Prompt Builder (buildPrompt) before calling provider.review().");
+            }
+            const start = Date.now();
+            let response;
+            try {
+                response = await client.chat.completions.create({
+                    model: options.model,
+                    max_tokens: options.maxOutputTokens ?? 4096,
+                    messages: [
+                        { role: "system", content: context.prompt.system },
+                        { role: "user", content: context.prompt.user },
+                    ],
+                    tools: [submitReviewTool],
+                    tool_choice: { type: "function", function: { name: SUBMIT_REVIEW_FUNCTION_NAME } },
+                });
+            }
+            catch (err) {
+                throw new Error(`${options.providerName} API request failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+            }
+            const toolCall = response.choices[0]?.message?.tool_calls?.find((call) => call.type === "function" && call.function.name === SUBMIT_REVIEW_FUNCTION_NAME);
+            if (!toolCall) {
+                throw new Error(`${options.providerName} did not return a submit_review tool call. Make sure the selected ` +
+                    `model ("${options.model}") supports tool/function calling.`);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(toolCall.function.arguments);
+            }
+            catch (err) {
+                throw new Error(`${options.providerName} returned malformed JSON for the submit_review tool call arguments.`, { cause: err });
+            }
+            const input = parsed;
+            return {
+                payload: {
+                    summary: input.summary ?? "",
+                    issues: input.issues ?? [],
+                },
+                provider: options.providerName,
+                model: options.model,
+                durationMs: Date.now() - start,
+            };
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "can-i-merge",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "AI-powered Git Review Pipeline with Intelligent Context Building",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,8 @@
   "license": "SEE LICENSE IN license",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.110.0",
-    "commander": "^15.0.0"
+    "commander": "^15.0.0",
+    "openai": "^6.45.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",