@open330/oac 2026.4.3 → 2026.220.2

package/dist/discovery/index.js

@@ -5,6 +5,7 @@ import {
   TestGapScanner,
   TodoScanner,
   analyzeCodebase,
+  buildScanners,
   computeEpicComplexity,
   computeEpicPriority,
   createBacklog,
@@ -20,8 +21,8 @@ import {
   persistContext,
   rankTasks,
   updateBacklog
-} from "../chunk-HDMLNOND.js";
-import "../chunk-YWIB3TRI.js";
+} from "../chunk-6JEFW6B7.js";
+import "../chunk-6A37SKAJ.js";
 export {
   CompositeScanner,
   GitHubIssuesScanner,
@@ -29,6 +30,7 @@ export {
   TestGapScanner,
   TodoScanner,
   analyzeCodebase,
+  buildScanners,
   computeEpicComplexity,
   computeEpicPriority,
   createBacklog,

package/dist/execution/index.d.ts

@@ -85,6 +85,50 @@ declare class CodexAdapter implements AgentProvider {
     abort(executionId: string): Promise<void>;
 }
 
+declare class OpenCodeAdapter implements AgentProvider {
+    readonly id: AgentProviderId;
+    readonly name = "OpenCode";
+    private readonly runningExecutions;
+    checkAvailability(): Promise<AgentAvailability>;
+    execute(params: AgentExecuteParams): AgentExecution;
+    estimateTokens(params: TokenEstimateParams): Promise<TokenEstimate>;
+    abort(executionId: string): Promise<void>;
+}
+
+/**
+ * Factory function that creates a new adapter instance.
+ *
+ * Using factories (rather than singleton instances) ensures each
+ * concurrent pipeline run gets its own `runningExecutions` map.
+ */
+type AdapterFactory = () => AgentProvider;
+/**
+ * Maintains a registry of agent adapter factories keyed by provider ID.
+ *
+ * Built-in adapters (claude-code, codex, opencode) are registered at
+ * module load time.  Custom adapters can be added at runtime with
+ * `adapterRegistry.register(id, factory)`.
+ */
+declare class AdapterRegistry {
+    private readonly factories;
+    /** Well-known aliases (e.g. legacy IDs) that map to canonical provider IDs. */
+    private readonly aliases;
+    /** Register a new adapter factory. Replaces any previous factory for the same ID. */
+    register(id: string, factory: AdapterFactory): void;
+    /** Add an alias that maps to an existing canonical ID. */
+    alias(alias: string, canonicalId: string): void;
+    /** Resolve an ID (including aliases) and return the factory, or `undefined`. */
+    get(rawId: string): AdapterFactory | undefined;
+    /** Canonical ID after alias resolution. */
+    resolveId(rawId: string): string;
+    /** All registered canonical provider IDs. */
+    registeredIds(): string[];
+}
+/**
+ * Global singleton registry with built-in adapters pre-registered.
+ */
+declare const adapterRegistry: AdapterRegistry;
+
 interface SandboxContext {
     path: string;
     branchName: string;
@@ -168,4 +212,4 @@ declare class ExecutionEngine {
     private buildRunResult;
 }
 
-export { type AgentAvailability, type AgentEvent, type AgentExecuteParams, type AgentExecution, type AgentProvider, type AgentResult, ClaudeCodeAdapter, CodexAdapter, type ExecuteTaskOptions, ExecutionEngine, type ExecutionEngineConfig, type Job, type JobStatus, type RunResult, type SandboxContext, type TokenEstimateParams, buildEpicPrompt, createSandbox, epicAsTask, executeTask, isTransientError };
+export { type AdapterFactory, type AgentAvailability, type AgentEvent, type AgentExecuteParams, type AgentExecution, type AgentProvider, type AgentResult, ClaudeCodeAdapter, CodexAdapter, type ExecuteTaskOptions, ExecutionEngine, type ExecutionEngineConfig, type Job, type JobStatus, OpenCodeAdapter, type RunResult, type SandboxContext, type TokenEstimateParams, adapterRegistry, buildEpicPrompt, createSandbox, epicAsTask, executeTask, isTransientError };

package/dist/execution/index.js

@@ -2,18 +2,22 @@ import {
   ClaudeCodeAdapter,
   CodexAdapter,
   ExecutionEngine,
+  OpenCodeAdapter,
+  adapterRegistry,
   buildEpicPrompt,
   createSandbox,
   epicAsTask,
   executeTask,
   isTransientError
-} from "../chunk-7FWC3Z4W.js";
-import "../chunk-ZRYAHZQJ.js";
-import "../chunk-YWIB3TRI.js";
+} from "../chunk-QPVNC7S4.js";
+import "../chunk-7C7SC4TZ.js";
+import "../chunk-6A37SKAJ.js";
 export {
   ClaudeCodeAdapter,
   CodexAdapter,
   ExecutionEngine,
+  OpenCodeAdapter,
+  adapterRegistry,
   buildEpicPrompt,
   createSandbox,
   epicAsTask,

package/dist/repo/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ResolvedRepo } from '../types-CYCwgojB.js';
-export { a as RepoPermissions, b as ResolvedRepoGitState, c as ResolvedRepoMeta } from '../types-CYCwgojB.js';
+import { R as ResolvedRepo } from '../types-3_IAAxh5.js';
+export { a as RepoPermissions, b as ResolvedRepoGitState, c as ResolvedRepoMeta } from '../types-3_IAAxh5.js';
 
 type RepoResolutionErrorCode = "INVALID_INPUT" | "NOT_FOUND" | "FORBIDDEN" | "ARCHIVED" | "UNKNOWN";
 declare class RepoResolutionError extends Error {

package/dist/repo/index.js

@@ -6,7 +6,7 @@ import {
   RepoResolutionError,
   cloneRepo,
   resolveRepo
-} from "../chunk-CJAJ4MBO.js";
+} from "../chunk-OS3XDHOJ.js";
 export {
   DEFAULT_METADATA_CACHE_PATH,
   DEFAULT_METADATA_CACHE_TTL_MS,

package/dist/{types-CYCwgojB.d.ts → types-3_IAAxh5.d.ts}

@@ -19,6 +19,7 @@ interface ResolvedRepoMeta {
 interface ResolvedRepoGitState {
     headSha: string;
     remoteUrl: string;
+    sshUrl?: string;
     isShallowClone: boolean;
 }
 interface ResolvedRepo {

package/docs/config-reference.md

@@ -0,0 +1,271 @@
+# OAC Configuration Reference
+
+> Auto-generated from the Zod schema in `src/core/config.ts`.
+> Version: **2026.2.5**
+
+OAC is configured via an `oac.config.ts` (or `.js` / `.json`) file at the project root. Use `defineConfig()` for type-safe authoring:
+
+```ts
+import { defineConfig } from "@open330/oac";
+
+export default defineConfig({
+  repos: ["facebook/react"],
+  budget: { totalTokens: 50_000 },
+  execution: { concurrency: 3, mode: "new-pr" },
+});
+```
+
+Environment variables can be interpolated with `${VAR_NAME}` syntax anywhere a string value is accepted.
+
+---
+
+## `repos`
+
+Target repositories to contribute to.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `repos` | `Array<string \| { name, branch? }>` | `[]` | List of repos. Each entry is either a GitHub slug (`"owner/repo"`) or an object with `name` (required) and `branch` (optional). |
+
+```ts
+repos: [
+  "facebook/react",
+  { name: "vercel/next.js", branch: "canary" },
+]
+```
+
+---
+
+## `provider`
+
+AI agent provider configuration.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `provider.id` | `string` | `"claude-code"` | Provider identifier. |
+| `provider.options` | `Record<string, unknown>` | `{}` | Provider-specific options passed through to the agent. |
+
+---
+
+## `budget`
+
+Token budget controls.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `budget.totalTokens` | `integer` | `100000` | Maximum tokens to spend across all tasks. Must be positive. |
+| `budget.reservePercent` | `number` | `0.1` | Fraction of budget to reserve for retries/overhead (0–1). |
+| `budget.estimationPadding` | `number` | `1.2` | Multiplier applied to token estimates for safety margin. Must be positive. |
+
+---
+
+## `discovery`
+
+Task discovery and scanning settings.
+
+### `discovery.scanners`
+
+Toggle individual scanners on or off.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `discovery.scanners.lint` | `boolean` | `true` | Scan for lint warnings and errors. |
+| `discovery.scanners.todo` | `boolean` | `true` | Scan for TODO/FIXME/HACK comments. |
+| `discovery.scanners.testGap` | `boolean` | `true` | Scan for files missing test coverage. |
+| `discovery.scanners.deadCode` | `boolean` | `false` | Scan for dead/unused code. |
+| `discovery.scanners.githubIssues` | `boolean` | `true` | Fetch open GitHub issues matching labels. |
+
+### Other discovery options
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `discovery.issueLabels` | `string[]` | `["good-first-issue", "help-wanted", "bug"]` | GitHub issue labels to match. |
+| `discovery.minPriority` | `integer` | `20` | Minimum priority score (0–100) for a task to be included. |
+| `discovery.maxTasks` | `integer` | `50` | Maximum number of tasks to discover. Must be positive. |
+| `discovery.customScanners` | `string[]` | `[]` | Paths to custom scanner modules. |
+| `discovery.exclude` | `string[]` | `["node_modules", "dist", "build", ".git", "*.min.js", "vendor/"]` | Glob patterns to exclude from scanning. |
+
+---
+
+## `execution`
+
+Task execution settings.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `execution.concurrency` | `integer` | `2` | Max parallel task executions. Must be positive. |
+| `execution.taskTimeout` | `integer` | `300` | Timeout per task in seconds. Must be positive. |
+| `execution.maxRetries` | `integer` | `2` | Max retry attempts for failed tasks (0 = no retries). |
+| `execution.mode` | `"new-pr" \| "update-pr" \| "direct-commit"` | `"new-pr"` | How to submit completed work. |
+| `execution.branchPattern` | `string` | `"oac/{date}/{task}"` | Branch naming pattern. `{date}` and `{task}` are interpolated. |
+
+### `execution.validation`
+
+Post-execution validation checks.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `execution.validation.lint` | `boolean` | `true` | Run linter after task completion. |
+| `execution.validation.test` | `boolean` | `true` | Run tests after task completion. |
+| `execution.validation.typeCheck` | `boolean` | `true` | Run type checker after task completion. |
+| `execution.validation.maxDiffLines` | `integer` | `500` | Reject diffs exceeding this line count. Must be positive. |
+
+### `execution.pr`
+
+Pull request settings.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `execution.pr.draft` | `boolean` | `false` | Create PRs as drafts. |
+| `execution.pr.labels` | `string[]` | `["oac-contribution"]` | Labels to apply to created PRs. |
+| `execution.pr.reviewers` | `string[]` | `[]` | GitHub usernames to request as reviewers. |
+| `execution.pr.assignees` | `string[]` | `[]` | GitHub usernames to assign to the PR. |
+
+---
+
+## `completion`
+
+Post-PR completion and monitoring.
+
+### `completion.integrations.linear`
+
+Linear issue tracker integration.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `completion.integrations.linear.enabled` | `boolean` | `false` | Enable Linear integration. |
+| `completion.integrations.linear.apiKey` | `string` | — | Linear API key. **Required** when `enabled: true`. Supports `${ENV_VAR}` syntax. |
+| `completion.integrations.linear.teamId` | `string` | — | Linear team ID. **Required** when `enabled: true`. |
+
+### `completion.integrations.jira`
+
+Jira issue tracker integration.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `completion.integrations.jira.enabled` | `boolean` | `false` | Enable Jira integration. |
+| `completion.integrations.jira.baseUrl` | `string (URL)` | — | Jira instance URL. **Required** when `enabled: true`. |
+| `completion.integrations.jira.email` | `string` | — | Jira account email. **Required** when `enabled: true`. |
+| `completion.integrations.jira.apiToken` | `string` | — | Jira API token. **Required** when `enabled: true`. Supports `${ENV_VAR}` syntax. |
+| `completion.integrations.jira.projectKey` | `string` | — | Jira project key. **Required** when `enabled: true`. |
+
+### `completion.monitor`
+
+PR monitoring settings.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `completion.monitor.enabled` | `boolean` | `false` | Enable post-PR monitoring. |
+| `completion.monitor.pollInterval` | `integer` | `300` | Seconds between status checks. Must be positive. |
+| `completion.monitor.autoRespondToReviews` | `boolean` | `false` | Automatically respond to review comments. |
+| `completion.monitor.autoDeleteBranch` | `boolean` | `true` | Delete branch after PR is merged. |
+
+---
+
+## `tracking`
+
+Local state tracking.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `tracking.directory` | `string` | `".oac"` | Directory for local OAC state files. |
+| `tracking.autoCommit` | `boolean` | `false` | Auto-commit tracking changes to git. |
+| `tracking.gitTracked` | `boolean` | `true` | Include tracking directory in git. |
+
+---
+
+## `dashboard`
+
+Local dashboard server.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `dashboard.port` | `integer` | `3141` | Port for the dashboard server (1–65535). |
+| `dashboard.openBrowser` | `boolean` | `true` | Automatically open the dashboard in a browser. |
+
+---
+
+## `analyze`
+
+Context analysis settings for `oac analyze` / auto-analysis before `oac run`.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `analyze.autoAnalyze` | `boolean` | `true` | Auto-run analysis before `oac run` if context is stale or missing. |
+| `analyze.staleAfterMs` | `integer` | `86400000` | Max age in milliseconds before context is considered stale (default: 24 hours). |
+| `analyze.contextDir` | `string` | `".oac/context"` | Directory for persisted analysis context, relative to repo root. |
+
+---
+
+## Environment Variable Interpolation
+
+Any string value in the config supports `${VAR_NAME}` interpolation:
+
+```ts
+export default defineConfig({
+  completion: {
+    integrations: {
+      linear: {
+        enabled: true,
+        apiKey: "${LINEAR_API_KEY}",
+        teamId: "${LINEAR_TEAM_ID}",
+      },
+    },
+  },
+});
+```
+
+If a referenced variable is not set, OAC throws a `CONFIG_SECRET_MISSING` error with the variable name and config path.
+
+---
+
+## Minimal Example
+
+```ts
+import { defineConfig } from "@open330/oac";
+
+export default defineConfig({
+  repos: ["my-org/my-repo"],
+});
+```
+
+All other options use sensible defaults. See individual sections above for default values.
+
+## Full Example
+
+```ts
+import { defineConfig } from "@open330/oac";
+
+export default defineConfig({
+  repos: [
+    "facebook/react",
+    { name: "vercel/next.js", branch: "canary" },
+  ],
+  provider: { id: "claude-code" },
+  budget: {
+    totalTokens: 200_000,
+    reservePercent: 0.15,
+    estimationPadding: 1.3,
+  },
+  discovery: {
+    scanners: { lint: true, todo: true, testGap: true, deadCode: true, githubIssues: true },
+    issueLabels: ["good-first-issue", "help-wanted"],
+    minPriority: 30,
+    maxTasks: 25,
+    exclude: ["node_modules", "dist", "vendor/", "**/*.generated.ts"],
+  },
+  execution: {
+    concurrency: 4,
+    taskTimeout: 600,
+    maxRetries: 1,
+    mode: "new-pr",
+    branchPattern: "oac/{date}/{task}",
+    validation: { lint: true, test: true, typeCheck: true, maxDiffLines: 800 },
+    pr: { draft: true, labels: ["oac-contribution", "automated"], reviewers: ["maintainer"] },
+  },
+  tracking: { directory: ".oac", autoCommit: true },
+  dashboard: { port: 3141 },
+  analyze: { autoAnalyze: true, staleAfterMs: 43_200_000 },
+});
+```
+