@open330/oac 2026.2.5

package/dist/execution/index.d.ts

@@ -0,0 +1,215 @@
+import { A as AgentProviderId, e as ExecutionResult, i as TokenEstimate, E as Epic, T as Task, d as ExecutionPlan } from '../types-Ck7IucqK.js';
+import { k as OacEventBus, g as OacError } from '../event-bus-KiuR6e3P.js';
+import 'eventemitter3';
+
+interface AgentAvailability {
+    available: boolean;
+    version?: string;
+    error?: string;
+    remainingBudget?: number;
+}
+interface AgentExecuteParams {
+    executionId: string;
+    workingDirectory: string;
+    prompt: string;
+    targetFiles: string[];
+    tokenBudget: number;
+    allowCommits: boolean;
+    timeoutMs: number;
+    env?: Record<string, string>;
+}
+interface TokenEstimateParams {
+    taskId: string;
+    prompt: string;
+    targetFiles: string[];
+    contextTokens?: number;
+    expectedOutputTokens?: number;
+}
+type AgentEvent = {
+    type: "output";
+    content: string;
+    stream: "stdout" | "stderr";
+} | {
+    type: "tokens";
+    inputTokens: number;
+    outputTokens: number;
+    cumulativeTokens: number;
+} | {
+    type: "file_edit";
+    path: string;
+    action: "create" | "modify" | "delete";
+} | {
+    type: "tool_use";
+    tool: string;
+    input: unknown;
+} | {
+    type: "error";
+    message: string;
+    recoverable: boolean;
+};
+interface AgentResult extends ExecutionResult {
+}
+interface AgentExecution {
+    readonly executionId: string;
+    readonly providerId: AgentProviderId;
+    events: AsyncIterable<AgentEvent>;
+    result: Promise<AgentResult>;
+    pid?: number;
+}
+interface AgentProvider {
+    readonly id: AgentProviderId;
+    readonly name: string;
+    checkAvailability(): Promise<AgentAvailability>;
+    execute(params: AgentExecuteParams): AgentExecution;
+    estimateTokens(params: TokenEstimateParams): Promise<TokenEstimate>;
+    abort(executionId: string): Promise<void>;
+}
+
+declare class ClaudeCodeAdapter implements AgentProvider {
+    readonly id: AgentProviderId;
+    readonly name = "Claude Code";
+    private readonly runningExecutions;
+    checkAvailability(): Promise<AgentAvailability>;
+    execute(params: AgentExecuteParams): AgentExecution;
+    estimateTokens(params: TokenEstimateParams): Promise<TokenEstimate>;
+    abort(executionId: string): Promise<void>;
+}
+
+declare class CodexAdapter implements AgentProvider {
+    readonly id: AgentProviderId;
+    readonly name = "Codex CLI";
+    private readonly runningExecutions;
+    checkAvailability(): Promise<AgentAvailability>;
+    execute(params: AgentExecuteParams): AgentExecution;
+    estimateTokens(params: TokenEstimateParams): Promise<TokenEstimate>;
+    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;
+    cleanup(): Promise<void>;
+}
+declare function createSandbox(repoPath: string, branchName: string, baseBranch: string): Promise<SandboxContext>;
+
+interface ExecuteTaskOptions {
+    executionId?: string;
+    tokenBudget?: number;
+    timeoutMs?: number;
+    allowCommits?: boolean;
+}
+declare function executeTask(agent: AgentProvider, task: Task, sandbox: SandboxContext, eventBus: OacEventBus, options?: ExecuteTaskOptions): Promise<ExecutionResult>;
+/**
+ * Build a context-aware prompt for an entire epic, including all subtasks
+ * and module context.
+ */
+declare function buildEpicPrompt(epic: Epic): string;
+/**
+ * Convert an Epic into a Task for backward compatibility with executeTask().
+ */
+declare function epicAsTask(epic: Epic): Task;
+
+type JobStatus = "queued" | "running" | "completed" | "failed" | "retrying" | "aborted";
+interface Job {
+    id: string;
+    task: Task;
+    estimate: TokenEstimate;
+    status: JobStatus;
+    attempts: number;
+    maxAttempts: number;
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    result?: ExecutionResult;
+    error?: OacError;
+    workerId?: string;
+}
+interface ExecutionEngineConfig {
+    concurrency?: number;
+    maxAttempts?: number;
+    repoPath?: string;
+    baseBranch?: string;
+    branchPrefix?: string;
+    taskTimeoutMs?: number;
+    defaultTokenBudget?: number;
+}
+interface RunResult {
+    jobs: Job[];
+    completed: Job[];
+    failed: Job[];
+    aborted: Job[];
+}
+declare function isTransientError(error: OacError): boolean;
+declare class ExecutionEngine {
+    private readonly agents;
+    private readonly eventBus;
+    private readonly queue;
+    private readonly jobs;
+    private readonly activeJobs;
+    private readonly concurrency;
+    private readonly maxAttempts;
+    private readonly repoPath;
+    private readonly baseBranch;
+    private readonly branchPrefix;
+    private readonly taskTimeoutMs;
+    private readonly defaultTokenBudget;
+    private aborted;
+    private nextAgentIndex;
+    constructor(agents: AgentProvider[], eventBus: OacEventBus, config?: ExecutionEngineConfig);
+    enqueue(plan: ExecutionPlan): Job[];
+    run(): Promise<RunResult>;
+    abort(): Promise<void>;
+    private schedule;
+    private runJob;
+    private handleFailure;
+    private selectAgent;
+    private createBranchName;
+    private normalizeError;
+    private buildRunResult;
+}
+
+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

@@ -0,0 +1,27 @@
+import {
+  ClaudeCodeAdapter,
+  CodexAdapter,
+  ExecutionEngine,
+  OpenCodeAdapter,
+  adapterRegistry,
+  buildEpicPrompt,
+  createSandbox,
+  epicAsTask,
+  executeTask,
+  isTransientError
+} from "../chunk-QPVNC7S4.js";
+import "../chunk-7C7SC4TZ.js";
+import "../chunk-6A37SKAJ.js";
+export {
+  ClaudeCodeAdapter,
+  CodexAdapter,
+  ExecutionEngine,
+  OpenCodeAdapter,
+  adapterRegistry,
+  buildEpicPrompt,
+  createSandbox,
+  epicAsTask,
+  executeTask,
+  isTransientError
+};
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/repo/index.d.ts

@@ -0,0 +1,33 @@
+import { R as ResolvedRepo } from '../types-CYCwgojB.js';
+export { a as RepoPermissions, b as ResolvedRepoGitState, c as ResolvedRepoMeta } from '../types-CYCwgojB.js';
+
+type RepoResolutionErrorCode = "INVALID_INPUT" | "NOT_FOUND" | "FORBIDDEN" | "ARCHIVED" | "UNKNOWN";
+declare class RepoResolutionError extends Error {
+    readonly code: RepoResolutionErrorCode;
+    constructor(message: string, code: RepoResolutionErrorCode, cause?: unknown);
+}
+declare function resolveRepo(input: string): Promise<ResolvedRepo>;
+
+declare const DEFAULT_REPO_CACHE_DIR: string;
+declare function cloneRepo(repo: ResolvedRepo, cacheDir?: string): Promise<string>;
+
+interface MetadataCacheOptions {
+    filePath?: string;
+    ttlMs?: number;
+    now?: () => number;
+}
+declare const DEFAULT_METADATA_CACHE_PATH: string;
+declare const DEFAULT_METADATA_CACHE_TTL_MS: number;
+declare class MetadataCache {
+    private readonly filePath;
+    private readonly ttlMs;
+    private readonly now;
+    constructor(options?: MetadataCacheOptions);
+    get(fullName: string): Promise<ResolvedRepo | null>;
+    set(fullName: string, repo: ResolvedRepo): Promise<void>;
+    invalidate(fullName?: string): Promise<void>;
+    private readCache;
+    private writeCache;
+}
+
+export { DEFAULT_METADATA_CACHE_PATH, DEFAULT_METADATA_CACHE_TTL_MS, DEFAULT_REPO_CACHE_DIR, MetadataCache, type MetadataCacheOptions, RepoResolutionError, type RepoResolutionErrorCode, ResolvedRepo, cloneRepo, resolveRepo };

package/dist/repo/index.js

@@ -0,0 +1,19 @@
+import {
+  DEFAULT_METADATA_CACHE_PATH,
+  DEFAULT_METADATA_CACHE_TTL_MS,
+  DEFAULT_REPO_CACHE_DIR,
+  MetadataCache,
+  RepoResolutionError,
+  cloneRepo,
+  resolveRepo
+} from "../chunk-CJAJ4MBO.js";
+export {
+  DEFAULT_METADATA_CACHE_PATH,
+  DEFAULT_METADATA_CACHE_TTL_MS,
+  DEFAULT_REPO_CACHE_DIR,
+  MetadataCache,
+  RepoResolutionError,
+  cloneRepo,
+  resolveRepo
+};
+//# sourceMappingURL=index.js.map

package/dist/repo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/tracking/index.d.ts

@@ -0,0 +1,357 @@
+import { z } from 'zod';
+
+declare const taskSourceValues: readonly ["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"];
+declare const taskComplexityValues: readonly ["trivial", "simple", "moderate", "complex"];
+declare const contributionTaskStatusValues: readonly ["success", "partial", "failed"];
+type TaskSource = (typeof taskSourceValues)[number];
+type TaskComplexity = (typeof taskComplexityValues)[number];
+type ContributionTaskStatus = (typeof contributionTaskStatusValues)[number];
+type AgentProviderId = string;
+declare const contributionTaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    title: z.ZodString;
+    source: z.ZodEnum<["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"]>;
+    complexity: z.ZodEnum<["trivial", "simple", "moderate", "complex"]>;
+    status: z.ZodEnum<["success", "partial", "failed"]>;
+    tokensUsed: z.ZodNumber;
+    duration: z.ZodNumber;
+    filesChanged: z.ZodArray<z.ZodString, "many">;
+    pr: z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        url: z.ZodString;
+        status: z.ZodEnum<["open", "merged", "closed"]>;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    }, {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    }>>;
+    linkedIssue: z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        url: string;
+    }, {
+        number: number;
+        url: string;
+    }>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    title: string;
+    source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+    status: "success" | "partial" | "failed";
+    complexity: "trivial" | "simple" | "moderate" | "complex";
+    tokensUsed: number;
+    duration: number;
+    filesChanged: string[];
+    pr?: {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    } | undefined;
+    linkedIssue?: {
+        number: number;
+        url: string;
+    } | undefined;
+    error?: string | undefined;
+}, {
+    taskId: string;
+    title: string;
+    source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+    status: "success" | "partial" | "failed";
+    complexity: "trivial" | "simple" | "moderate" | "complex";
+    tokensUsed: number;
+    duration: number;
+    filesChanged: string[];
+    pr?: {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    } | undefined;
+    linkedIssue?: {
+        number: number;
+        url: string;
+    } | undefined;
+    error?: string | undefined;
+}>;
+declare const contributionLogSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    contributor: z.ZodObject<{
+        githubUsername: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        githubUsername: string;
+        email?: string | undefined;
+    }, {
+        githubUsername: string;
+        email?: string | undefined;
+    }>;
+    repo: z.ZodObject<{
+        fullName: z.ZodString;
+        headSha: z.ZodString;
+        defaultBranch: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    }, {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    }>;
+    budget: z.ZodObject<{
+        provider: z.ZodString;
+        totalTokensBudgeted: z.ZodNumber;
+        totalTokensUsed: z.ZodNumber;
+        estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    }, {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    }>;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodEnum<["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"]>;
+        complexity: z.ZodEnum<["trivial", "simple", "moderate", "complex"]>;
+        status: z.ZodEnum<["success", "partial", "failed"]>;
+        tokensUsed: z.ZodNumber;
+        duration: z.ZodNumber;
+        filesChanged: z.ZodArray<z.ZodString, "many">;
+        pr: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            url: z.ZodString;
+            status: z.ZodEnum<["open", "merged", "closed"]>;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        }, {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        }>>;
+        linkedIssue: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            url: string;
+        }, {
+            number: number;
+            url: string;
+        }>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }, {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }>, "many">;
+    metrics: z.ZodObject<{
+        tasksDiscovered: z.ZodNumber;
+        tasksAttempted: z.ZodNumber;
+        tasksSucceeded: z.ZodNumber;
+        tasksFailed: z.ZodNumber;
+        totalDuration: z.ZodNumber;
+        totalFilesChanged: z.ZodNumber;
+        totalLinesAdded: z.ZodNumber;
+        totalLinesRemoved: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    }, {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: "1.0";
+    runId: string;
+    timestamp: string;
+    contributor: {
+        githubUsername: string;
+        email?: string | undefined;
+    };
+    repo: {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    };
+    budget: {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    };
+    tasks: {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }[];
+    metrics: {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    };
+}, {
+    version: "1.0";
+    runId: string;
+    timestamp: string;
+    contributor: {
+        githubUsername: string;
+        email?: string | undefined;
+    };
+    repo: {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    };
+    budget: {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    };
+    tasks: {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }[];
+    metrics: {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    };
+}>;
+type ContributionTask = z.infer<typeof contributionTaskSchema>;
+type ContributionLog = z.infer<typeof contributionLogSchema>;
+declare function parseContributionLog(input: unknown): ContributionLog;
+
+declare function writeContributionLog(log: ContributionLog, repoPath: string): Promise<string>;
+
+interface Leaderboard {
+    generatedAt: string;
+    entries: LeaderboardEntry[];
+    repoStats: {
+        totalContributions: number;
+        totalTokensUsed: number;
+        totalPRsCreated: number;
+        totalPRsMerged: number;
+        firstContribution: string;
+        lastContribution: string;
+    };
+}
+interface LeaderboardEntry {
+    githubUsername: string;
+    totalRuns: number;
+    totalTasksCompleted: number;
+    totalTokensDonated: number;
+    totalFilesChanged: number;
+    totalLinesChanged: number;
+    totalPRsCreated: number;
+    totalPRsMerged: number;
+    favoriteTaskSource: TaskSource;
+    firstContribution: string;
+    lastContribution: string;
+}
+declare function buildLeaderboard(repoPath: string): Promise<Leaderboard>;
+
+export { type AgentProviderId, type ContributionLog, type ContributionTask, type ContributionTaskStatus, type Leaderboard, type LeaderboardEntry, type TaskComplexity, type TaskSource, buildLeaderboard, contributionLogSchema, contributionTaskSchema, parseContributionLog, writeContributionLog };

package/dist/tracking/index.js

@@ -0,0 +1,15 @@
+import {
+  buildLeaderboard,
+  contributionLogSchema,
+  contributionTaskSchema,
+  parseContributionLog,
+  writeContributionLog
+} from "../chunk-LQC5DLT7.js";
+export {
+  buildLeaderboard,
+  contributionLogSchema,
+  contributionTaskSchema,
+  parseContributionLog,
+  writeContributionLog
+};
+//# sourceMappingURL=index.js.map

package/dist/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}