opencara 0.18.0 → 0.18.1

package/README.md

@@ -84,7 +84,7 @@ Review prompts are delivered via **stdin** to your command. The command reads st
 
 | Field                    | Default                    | Description                           |
 | ------------------------ | -------------------------- | ------------------------------------- |
-| `platform_url`           | `https://api.opencara.dev` | OpenCara server URL                   |
+| `platform_url`           | `https://api.opencara.com` | OpenCara server URL                   |
 | `github_token`           | --                         | GitHub token for private repo diffs   |
 | `codebase_dir`           | --                         | Default clone directory for repos     |
 | `max_diff_size_kb`       | `100`                      | Skip PRs with diffs larger than this  |

package/dist/index.js

@@ -378,7 +378,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import { parse as parseToml2, stringify as stringifyToml } from "smol-toml";
-var DEFAULT_PLATFORM_URL = "https://api.opencara.dev";
+var DEFAULT_PLATFORM_URL = "https://api.opencara.com";
 var CONFIG_DIR = path.join(os.homedir(), ".opencara");
 var CONFIG_FILE = process.env.OPENCARA_CONFIG && process.env.OPENCARA_CONFIG.trim() ? path.resolve(process.env.OPENCARA_CONFIG) : path.join(CONFIG_DIR, "config.toml");
 function ensureConfigDir() {
@@ -565,7 +565,6 @@ function loadConfig() {
   const envPlatformUrl = process.env.OPENCARA_PLATFORM_URL?.trim() || null;
   const defaults = {
     platformUrl: envPlatformUrl || DEFAULT_PLATFORM_URL,
-    apiKey: null,
     maxDiffSizeKb: DEFAULT_MAX_DIFF_SIZE_KB,
     maxConsecutiveErrors: DEFAULT_MAX_CONSECUTIVE_ERRORS,
     codebaseDir: null,
@@ -609,7 +608,6 @@ function loadConfig() {
   }
   return {
     platformUrl: envPlatformUrl || (typeof data.platform_url === "string" ? data.platform_url : DEFAULT_PLATFORM_URL),
-    apiKey: typeof data.api_key === "string" ? data.api_key.trim() || null : null,
     maxDiffSizeKb: overrides.maxDiffSizeKb ?? (typeof data.max_diff_size_kb === "number" ? data.max_diff_size_kb : DEFAULT_MAX_DIFF_SIZE_KB),
     maxConsecutiveErrors: overrides.maxConsecutiveErrors ?? (typeof data.max_consecutive_errors === "number" ? data.max_consecutive_errors : DEFAULT_MAX_CONSECUTIVE_ERRORS),
     codebaseDir: typeof data.codebase_dir === "string" ? data.codebase_dir : null,
@@ -2195,8 +2193,14 @@ You MUST output ONLY a valid JSON object matching this exact schema (no markdown
 
 - "duplicates": array of matches found (empty array if no duplicates)
 - "similarity": "exact" = identical intent/change, "high" = very similar with minor differences, "partial" = overlapping but distinct
-- "index_entry": a single line in the format: \`- #<number> [label1] [label2] \u2014 <short description>\`
+- "index_entry": a single line in the format: \`- <number>(<label1>, <label2>, ...): <short description>\` where labels are inferred from GitHub labels, PR/issue title, body, and any available context`);
+  if (task.customPrompt) {
+    parts.push(`
+## Repo-Specific Instructions
 
+${task.customPrompt}`);
+  }
+  parts.push(`
 ## Index of Existing Items
 
 <UNTRUSTED_CONTENT>`);
@@ -2346,7 +2350,7 @@ async function executeDedup(prompt, timeoutSeconds, deps, runTool = executeTool,
 }
 async function executeDedupTask(client, agentId, taskId, task, diffContent, timeoutSeconds, reviewDeps, consumptionDeps, logger, signal, role = "pr_dedup") {
   logger.log(`  ${icons.running} Executing dedup: ${reviewDeps.commandTemplate}`);
-  const prompt = buildDedupPrompt({ ...task, diffContent });
+  const prompt = buildDedupPrompt({ ...task, diffContent, customPrompt: task.prompt });
   const result = await executeDedup(
     prompt,
     timeoutSeconds,
@@ -2607,6 +2611,11 @@ function buildTriagePrompt(task) {
   const title = task.issue_title ?? `PR #${task.pr_number}`;
   const rawBody = task.issue_body ?? "";
   const safeBody = truncateToBytes(rawBody, MAX_ISSUE_BODY_BYTES);
+  const repoPromptSection = task.prompt ? `
+
+## Repo-Specific Instructions
+
+${task.prompt}` : "";
   const userMessage = [
     `## Issue Title`,
     title,
@@ -2616,7 +2625,7 @@ function buildTriagePrompt(task) {
     safeBody,
     "</UNTRUSTED_CONTENT>"
   ].join("\n");
-  return `${TRIAGE_SYSTEM_PROMPT}
+  return `${TRIAGE_SYSTEM_PROMPT}${repoPromptSection}
 
 ${userMessage}`;
 }
@@ -3167,7 +3176,8 @@ async function handleTask(client, agentId, task, reviewDeps, consumptionDeps, ag
           issue_title: task.issue_title,
           issue_body: task.issue_body,
           diff_url,
-          index_issue_body: task.index_issue_body
+          index_issue_body: task.index_issue_body,
+          prompt
         },
         diffContent,
         timeout_seconds,
@@ -3568,7 +3578,7 @@ function sleep2(ms, signal) {
 async function startAgent(agentId, platformUrl, agentInfo, reviewDeps, consumptionDeps, options) {
   const client = new ApiClient(platformUrl, {
     authToken: options?.authToken,
-    cliVersion: "0.18.0",
+    cliVersion: "0.18.1",
     versionOverride: options?.versionOverride,
     onTokenRefresh: options?.onTokenRefresh
   });
@@ -4075,11 +4085,77 @@ async function updateIssueComment(owner, repo, commentId, body, token, fetchFn =
 }
 function formatEntry(item, compact = false) {
   if (compact) {
-    return `- #${item.number} \u2014 ${item.title}`;
+    return `- ${item.number}(): ${item.title}`;
+  }
+  const labels = item.labels.map((l) => l.name).join(", ");
+  return `- ${item.number}(${labels}): ${item.title}`;
+}
+var AI_ENTRY_TIMEOUT_MS = 6e4;
+function buildIndexEntryPrompt(item, kind) {
+  const typeLabel = kind === "prs" ? "PR" : "Issue";
+  const labels = item.labels.map((l) => l.name).join(", ");
+  return `You are a dedup index entry generator. Given a GitHub ${typeLabel}, produce a concise one-line description suitable for duplicate detection.
+
+## Input
+
+${typeLabel} #${item.number}: ${item.title}
+Labels: ${labels || "(none)"}
+State: ${item.state}
+
+## Output Format
+
+Respond with ONLY a JSON object (no markdown fences, no preamble):
+
+{
+  "description": "<concise one-line description for duplicate detection>"
+}
+
+The description should capture the core intent/change of the ${typeLabel.toLowerCase()} in a way that helps identify duplicates. Keep it under 120 characters.`;
+}
+function parseIndexEntryResponse(stdout) {
+  const jsonStr = extractJson(stdout);
+  if (!jsonStr) return null;
+  try {
+    const parsed = JSON.parse(jsonStr);
+    if (typeof parsed.description === "string" && parsed.description.length > 0) {
+      return parsed.description;
+    }
+  } catch {
+  }
+  return null;
+}
+function resolveAgentCommand(toolName) {
+  const config = loadConfig();
+  if (config.agents) {
+    const agent = config.agents.find((a) => a.tool === toolName);
+    if (agent) {
+      const cmd = agent.command ?? config.agentCommand;
+      if (cmd) return cmd;
+    }
+  }
+  const registryTool = DEFAULT_REGISTRY.tools.find((t) => t.name === toolName);
+  if (registryTool) {
+    const defaultModel = DEFAULT_REGISTRY.models.find((m) => m.tools.includes(toolName));
+    const modelName = defaultModel?.name ?? "";
+    return registryTool.commandTemplate.replaceAll("${MODEL}", modelName);
+  }
+  return null;
+}
+async function generateAIEntry(item, kind, commandTemplate, runTool = executeTool) {
+  const prompt = buildIndexEntryPrompt(item, kind);
+  try {
+    const result = await runTool(commandTemplate, prompt, AI_ENTRY_TIMEOUT_MS);
+    return parseIndexEntryResponse(result.stdout);
+  } catch {
+    return null;
+  }
+}
+function formatEntryWithDescription(item, description, compact = false) {
+  if (compact) {
+    return `- ${item.number}(): ${description}`;
   }
-  const labels = item.labels.map((l) => `[${l.name}]`).join(" ");
-  const labelPart = labels ? ` ${labels}` : "";
-  return `- #${item.number}${labelPart} \u2014 ${item.title}`;
+  const labels = item.labels.map((l) => l.name).join(", ");
+  return `- ${item.number}(${labels}): ${description}`;
 }
 function categorizeItems(items, recentDays = DEFAULT_RECENT_DAYS, nowMs = Date.now()) {
   const cutoff = nowMs - recentDays * 24 * 60 * 60 * 1e3;
@@ -4099,22 +4175,28 @@ function categorizeItems(items, recentDays = DEFAULT_RECENT_DAYS, nowMs = Date.n
 }
 function parseExistingNumbers(body) {
   const numbers = /* @__PURE__ */ new Set();
-  const regex = /^- #(\d+)/gm;
+  const regex = /^- #?(\d+)/gm;
   let match;
   while ((match = regex.exec(body)) !== null) {
     numbers.add(parseInt(match[1], 10));
   }
   return numbers;
 }
-function buildCommentBody(marker, header, items, existingBody, compact = false) {
+function buildCommentBody(marker, header, items, existingBody, compact = false, descriptions) {
   const existingNumbers = existingBody ? parseExistingNumbers(existingBody) : /* @__PURE__ */ new Set();
   const newItems = items.filter((item) => !existingNumbers.has(item.number));
   let body = existingBody ?? `${marker}
 ## ${header}
 `;
   for (const item of newItems) {
-    body += `
+    const aiDesc = descriptions?.get(item.number);
+    if (aiDesc) {
+      body += `
+${formatEntryWithDescription(item, aiDesc, compact)}`;
+    } else {
+      body += `
 ${formatEntry(item, compact)}`;
+    }
   }
   return body;
 }
@@ -4134,6 +4216,7 @@ async function initIndex(opts) {
   const fetchFn = opts.fetchFn ?? fetch;
   const log = opts.log ?? (() => {
   });
+  const runTool = opts.runTool ?? executeTool;
   log(`Scanning ${kind}...`);
   const items = kind === "prs" ? await fetchAllPRs(owner, repo, token, fetchFn, log) : await fetchAllIssues(owner, repo, token, fetchFn, log);
   log(`${icons.info} Found ${items.length} ${kind}.`);
@@ -4143,34 +4226,64 @@ async function initIndex(opts) {
   );
   const comments = await fetchIssueComments2(owner, repo, indexIssue, token, fetchFn);
   const found = findIndexComments(comments);
-  const openBody = buildCommentBody(OPEN_MARKER, "Open Items", open, found.open?.body ?? null);
+  const existingOpen = found.open ? parseExistingNumbers(found.open.body) : /* @__PURE__ */ new Set();
+  const existingRecent = found.recent ? parseExistingNumbers(found.recent.body) : /* @__PURE__ */ new Set();
+  const existingArchived = found.archived ? parseExistingNumbers(found.archived.body) : /* @__PURE__ */ new Set();
+  const newOpenItems = open.filter((i) => !existingOpen.has(i.number));
+  const newRecentItems = recentlyClosed.filter((i) => !existingRecent.has(i.number));
+  const newArchivedItems = archived.filter((i) => !existingArchived.has(i.number));
+  const newEntries = newOpenItems.length + newRecentItems.length + newArchivedItems.length;
+  const descriptions = /* @__PURE__ */ new Map();
+  if (opts.agentCommandTemplate && newEntries > 0) {
+    const allNewItems = [...newOpenItems, ...newRecentItems, ...newArchivedItems];
+    log(`
+Generating AI-enriched descriptions for ${allNewItems.length} items...`);
+    for (let i = 0; i < allNewItems.length; i++) {
+      const item = allNewItems[i];
+      log(`  Processing item ${i + 1}/${allNewItems.length} (#${item.number})...`);
+      const desc = await generateAIEntry(item, kind, opts.agentCommandTemplate, runTool);
+      if (desc) {
+        descriptions.set(item.number, desc);
+      } else {
+        log(`  ${icons.warn} AI failed for #${item.number}, using raw title`);
+      }
+    }
+    const enriched = descriptions.size;
+    log(
+      `${icons.info} AI enrichment: ${enriched}/${allNewItems.length} items enriched successfully`
+    );
+  }
+  const openBody = buildCommentBody(
+    OPEN_MARKER,
+    "Open Items",
+    open,
+    found.open?.body ?? null,
+    false,
+    descriptions
+  );
   const recentBody = buildCommentBody(
     RECENT_MARKER,
     "Recently Closed Items",
     recentlyClosed,
-    found.recent?.body ?? null
+    found.recent?.body ?? null,
+    false,
+    descriptions
   );
   const archivedBody = buildCommentBody(
     ARCHIVED_MARKER,
     "Archived Items",
     archived,
     found.archived?.body ?? null,
-    true
+    true,
     // compact format
+    descriptions
   );
-  const existingOpen = found.open ? parseExistingNumbers(found.open.body) : /* @__PURE__ */ new Set();
-  const existingRecent = found.recent ? parseExistingNumbers(found.recent.body) : /* @__PURE__ */ new Set();
-  const existingArchived = found.archived ? parseExistingNumbers(found.archived.body) : /* @__PURE__ */ new Set();
-  const newOpen = open.filter((i) => !existingOpen.has(i.number)).length;
-  const newRecent = recentlyClosed.filter((i) => !existingRecent.has(i.number)).length;
-  const newArchived = archived.filter((i) => !existingArchived.has(i.number)).length;
-  const newEntries = newOpen + newRecent + newArchived;
   if (dryRun) {
     log(`
 ${icons.info} Dry run \u2014 would update index issue #${indexIssue}:`);
-    log(`  Open Items: ${open.length} entries (${newOpen} new)`);
-    log(`  Recently Closed: ${recentlyClosed.length} entries (${newRecent} new)`);
-    log(`  Archived: ${archived.length} entries (${newArchived} new)`);
+    log(`  Open Items: ${open.length} entries (${newOpenItems.length} new)`);
+    log(`  Recently Closed: ${recentlyClosed.length} entries (${newRecentItems.length} new)`);
+    log(`  Archived: ${archived.length} entries (${newArchivedItems.length} new)`);
     return {
       openCount: open.length,
       recentCount: recentlyClosed.length,
@@ -4209,6 +4322,7 @@ async function runDedupInit(options, deps = {}) {
   const log = deps.log ?? console.log;
   const logError = deps.logError ?? console.error;
   const loadAuthFn = deps.loadAuthFn ?? loadAuth;
+  const resolveCmd = deps.resolveAgentCommandFn ?? resolveAgentCommand;
   const auth = loadAuthFn();
   if (!auth || auth.expires_at <= Date.now()) {
     logError(`${icons.error} Not authenticated. Run: ${pc3.cyan("opencara auth login")}`);
@@ -4273,6 +4387,19 @@ async function runDedupInit(options, deps = {}) {
     process.exitCode = 1;
     return;
   }
+  let agentCommandTemplate;
+  if (options.agent) {
+    const cmd = resolveCmd(options.agent);
+    if (!cmd) {
+      logError(
+        `${icons.error} Unknown agent tool "${options.agent}". Available: ${DEFAULT_REGISTRY.tools.map((t) => t.name).join(", ")}`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    agentCommandTemplate = cmd;
+    log(`Using AI agent "${options.agent}" for enriched descriptions`);
+  }
   for (const target of filteredTargets) {
     log(`
 ${pc3.bold(`Initializing ${target.kind} dedup index (issue #${target.indexIssue})...`)}`);
@@ -4284,16 +4411,23 @@ ${pc3.bold(`Initializing ${target.kind} dedup index (issue #${target.indexIssue}
       recentDays,
       dryRun: options.dryRun ?? false,
       token,
+      agentCommandTemplate,
       fetchFn,
-      log
+      log,
+      runTool: deps.runTool
     });
   }
 }
 function dedupCommand() {
   const dedup = new Command3("dedup").description("Dedup index management");
-  dedup.command("init").description("Scan existing PRs/issues and populate dedup index").requiredOption("--repo <owner/repo>", "Target repository (e.g., OpenCara/OpenCara)").option("--all", "Initialize both PR and issue dedup indexes").option("--dry-run", "Show what would be done without making changes").option("--days <number>", "Recently closed window in days (default: 30)", "30").action(async (options) => {
-    await runDedupInit(options);
-  });
+  dedup.command("init").description("Scan existing PRs/issues and populate dedup index").requiredOption("--repo <owner/repo>", "Target repository (e.g., OpenCara/OpenCara)").option("--all", "Initialize both PR and issue dedup indexes").option("--dry-run", "Show what would be done without making changes").option("--days <number>", "Recently closed window in days (default: 30)", "30").option(
+    "--agent <tool-name>",
+    "Use AI agent to generate enriched descriptions (e.g., claude, codex, gemini, qwen)"
+  ).action(
+    async (options) => {
+      await runDedupInit(options);
+    }
+  );
   return dedup;
 }
 
@@ -4424,7 +4558,7 @@ var statusCommand = new Command4("status").description("Show agent config, conne
 });
 
 // src/index.ts
-var program = new Command5().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.18.0");
+var program = new Command5().name("opencara").description("OpenCara \u2014 distributed AI code review agent").version("0.18.1");
 program.addCommand(agentCommand);
 program.addCommand(authCommand());
 program.addCommand(dedupCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencara",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Distributed AI code review agent — poll, review, and submit PR reviews using your own AI tools",
   "type": "module",
   "license": "MIT",