@open330/oac-completion 2026.2.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open330
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import { ResolvedRepo, Task, ExecutionResult, OacConfig, OacEventBus } from '@open330/oac-core';
+import { Octokit } from '@octokit/rest';
+
+interface PRCreationParams {
+    repo: ResolvedRepo;
+    task: Task;
+    result: ExecutionResult;
+    branchName: string;
+    baseBranch: string;
+}
+interface CreatedPR {
+    number: number;
+    url: string;
+    sha: string;
+}
+interface CompletionResult {
+    prUrl?: string;
+    commitSha?: string;
+    summary: string;
+    filesChanged: number;
+    tokensUsed: number;
+}
+interface ExternalTaskRef {
+    provider: string;
+    externalId: string;
+    url?: string;
+}
+interface ProjectManagementProvider {
+    readonly id: string;
+    readonly name: string;
+    ping(): Promise<boolean>;
+    notifyStarted(ref: ExternalTaskRef): Promise<void>;
+    notifyPRCreated(ref: ExternalTaskRef, prUrl: string): Promise<void>;
+    notifyCompleted(ref: ExternalTaskRef, result: CompletionResult): Promise<void>;
+    notifyFailed(ref: ExternalTaskRef, error: string): Promise<void>;
+}
+
+declare function createPR(params: PRCreationParams, octokit: Octokit): Promise<CreatedPR>;
+declare function pushBranch(repo: ResolvedRepo, branchName: string): Promise<string>;
+
+declare function linkIssueToePR(repo: ResolvedRepo, task: Task, pr: CreatedPR, octokit: Octokit): Promise<void>;
+declare const linkIssueToPR: typeof linkIssueToePR;
+
+interface DiffValidationConfig {
+    maxDiffLines?: number;
+    forbiddenPatterns?: RegExp[];
+    protectedFiles?: string[];
+}
+interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+}
+declare function validateDiff(repoPath: string, config?: DiffValidationConfig | OacConfig): Promise<ValidationResult>;
+
+interface CompletionHandlerOptions {
+    octokit: Octokit;
+    eventBus: OacEventBus;
+    providers?: ProjectManagementProvider[];
+    diffValidationConfig?: DiffValidationConfig | OacConfig;
+}
+interface CompletionHandlerParams extends PRCreationParams {
+    jobId: string;
+    externalTaskRef?: ExternalTaskRef;
+    diffValidationConfig?: DiffValidationConfig | OacConfig;
+}
+declare class CompletionHandler {
+    private readonly octokit;
+    private readonly eventBus;
+    private readonly providers;
+    private readonly diffValidationConfig?;
+    constructor(options: CompletionHandlerOptions);
+    handle(params: CompletionHandlerParams): Promise<CompletionResult>;
+    complete(params: CompletionHandlerParams): Promise<CompletionResult>;
+    private emitProgress;
+    private handleValidationResult;
+    private tryLinkIssue;
+    private notifyStarted;
+    private notifyPRCreated;
+    private notifyCompleted;
+    private notifyFailed;
+    private notifyProviders;
+    private resolveExternalTaskRef;
+    private normalizePipelineError;
+}
+
+export { CompletionHandler, type CompletionHandlerOptions, type CompletionHandlerParams, type CompletionResult, type CreatedPR, type DiffValidationConfig, type ExternalTaskRef, type PRCreationParams, type ProjectManagementProvider, type ValidationResult, createPR, linkIssueToPR, linkIssueToePR, pushBranch, validateDiff };

package/dist/index.js

@@ -0,0 +1,591 @@
+// src/github-pr.ts
+import { completionError } from "@open330/oac-core";
+import { simpleGit } from "simple-git";
+async function createPR(params, octokit) {
+  const { repo, task, result, branchName, baseBranch } = params;
+  const pushedSha = await pushBranch(repo, branchName);
+  const body = await buildPrBody(params);
+  try {
+    const created = await octokit.pulls.create({
+      owner: repo.owner,
+      repo: repo.name,
+      title: `[OAC] ${task.title}`,
+      body,
+      head: branchName,
+      base: baseBranch,
+      draft: false
+    });
+    await addLabels(octokit, repo, created.data.number, ["oac-contribution", task.source]);
+    return {
+      number: created.data.number,
+      url: created.data.html_url,
+      sha: created.data.head.sha || pushedSha
+    };
+  } catch (error) {
+    throw completionError(
+      "PR_CREATION_FAILED",
+      `Failed to create PR for "${repo.fullName}" on branch "${branchName}".`,
+      {
+        cause: error,
+        context: {
+          repo: repo.fullName,
+          branchName,
+          baseBranch,
+          taskId: task.id
+        }
+      }
+    );
+  }
+}
+async function pushBranch(repo, branchName) {
+  const git = simpleGit(resolveGitPath(repo));
+  const headSha = (await git.revparse(["HEAD"])).trim();
+  try {
+    const remoteSha = await readRemoteBranchSha(git, branchName);
+    if (remoteSha !== headSha) {
+      await git.push("origin", branchName);
+    }
+  } catch (error) {
+    try {
+      await git.raw(["push", "--set-upstream", "origin", branchName]);
+    } catch (retryError) {
+      throw completionError(
+        "PR_PUSH_REJECTED",
+        `Failed to push branch "${branchName}" for "${repo.fullName}".`,
+        {
+          cause: retryError,
+          context: {
+            repo: repo.fullName,
+            branchName,
+            headSha,
+            initialError: error instanceof Error ? error.message : "unknown push error"
+          }
+        }
+      );
+    }
+  }
+  return headSha;
+}
+async function buildPrBody(params) {
+  const { repo, task, result, baseBranch, branchName } = params;
+  const diffStats = await resolveDiffStats(repo, baseBranch, branchName);
+  const linkedIssue = task.linkedIssue ? `
+Fixes #${task.linkedIssue.number}
+` : "\n";
+  const agentLabel = resolveAgentLabel(task.metadata);
+  const durationText = formatDurationSeconds(result.duration);
+  const summaryText = task.description.trim().length > 0 ? task.description.trim() : `Automated contribution for task "${task.title}".`;
+  const filesChanged = result.filesChanged.length || diffStats.filesChanged;
+  const filesPreview = renderFilesPreview(result.filesChanged);
+  return [
+    "## Summary",
+    "",
+    summaryText,
+    "",
+    "## Changes",
+    "",
+    filesPreview,
+    "",
+    `- **Files changed:** ${filesChanged}`,
+    `- **Lines added:** ${diffStats.linesAdded}`,
+    `- **Lines removed:** ${diffStats.linesRemoved}`,
+    "",
+    "## Context",
+    "",
+    `- **Task source:** ${task.source}`,
+    `- **Agent:** ${agentLabel}`,
+    `- **Tokens used:** ${result.totalTokensUsed}`,
+    `- **Execution time:** ${durationText}`,
+    linkedIssue.trimEnd(),
+    "",
+    "---",
+    "*This PR was automatically generated by OAC.*"
+  ].join("\n");
+}
+async function resolveDiffStats(repo, baseBranch, branchName) {
+  const git = simpleGit(resolveGitPath(repo));
+  const ranges = [
+    [`origin/${baseBranch}...${branchName}`],
+    [`${baseBranch}...${branchName}`],
+    ["HEAD"],
+    []
+  ];
+  for (const range of ranges) {
+    try {
+      const summary = await git.diffSummary(range);
+      return {
+        filesChanged: summary.changed,
+        linesAdded: summary.insertions,
+        linesRemoved: summary.deletions
+      };
+    } catch {
+    }
+  }
+  return {
+    filesChanged: 0,
+    linesAdded: 0,
+    linesRemoved: 0
+  };
+}
+async function addLabels(octokit, repo, prNumber, labels) {
+  const uniqueLabels = [...new Set(labels.map((label) => label.trim()).filter(Boolean))];
+  if (uniqueLabels.length === 0) {
+    return;
+  }
+  try {
+    await octokit.issues.addLabels({
+      owner: repo.owner,
+      repo: repo.name,
+      issue_number: prNumber,
+      labels: uniqueLabels
+    });
+  } catch {
+  }
+}
+function resolveGitPath(repo) {
+  return repo.worktreePath.trim().length > 0 ? repo.worktreePath : repo.localPath;
+}
+async function readRemoteBranchSha(git, branchName) {
+  const remoteHeads = await git.listRemote(["--heads", "origin", branchName]);
+  const firstLine = remoteHeads.split("\n").map((line) => line.trim()).find((line) => line.length > 0);
+  if (!firstLine) {
+    return void 0;
+  }
+  const [sha] = firstLine.split(/\s+/);
+  return sha;
+}
+function resolveAgentLabel(metadata) {
+  const fromAgent = readMetadataString(metadata, ["agent", "agentName", "provider"]);
+  return fromAgent ?? "unknown";
+}
+function readMetadataString(metadata, keys) {
+  for (const key of keys) {
+    const value = metadata[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function renderFilesPreview(files) {
+  if (files.length === 0) {
+    return "- No file list was reported by the execution step.";
+  }
+  const preview = files.slice(0, 15).map((path) => `- \`${path}\``);
+  if (files.length > 15) {
+    preview.push(`- ...and ${files.length - 15} more file(s)`);
+  }
+  return preview.join("\n");
+}
+function formatDurationSeconds(duration) {
+  if (!Number.isFinite(duration) || duration <= 0) {
+    return "0s";
+  }
+  const seconds = duration > 1e3 ? duration / 1e3 : duration;
+  if (seconds >= 100) {
+    return `${Math.round(seconds)}s`;
+  }
+  return `${seconds.toFixed(1)}s`;
+}
+
+// src/issue-linker.ts
+import { completionError as completionError2 } from "@open330/oac-core";
+async function linkIssueToePR(repo, task, pr, octokit) {
+  if (!task.linkedIssue) {
+    return;
+  }
+  const issueNumber = task.linkedIssue.number;
+  try {
+    const issue = await octokit.issues.get({
+      owner: repo.owner,
+      repo: repo.name,
+      issue_number: issueNumber
+    });
+    if (issue.data.state === "closed") {
+      return;
+    }
+    await octokit.issues.createComment({
+      owner: repo.owner,
+      repo: repo.name,
+      issue_number: issueNumber,
+      body: `OAC opened a PR for this issue: ${pr.url}`
+    });
+  } catch (error) {
+    if (isNonBlockingIssueError(error)) {
+      return;
+    }
+    throw completionError2(
+      "PR_CREATION_FAILED",
+      `Failed to link issue #${issueNumber} to PR #${pr.number}.`,
+      {
+        cause: error,
+        context: {
+          repo: repo.fullName,
+          issueNumber,
+          prNumber: pr.number
+        }
+      }
+    );
+  }
+}
+var linkIssueToPR = linkIssueToePR;
+function isNonBlockingIssueError(error) {
+  if (!isStatusError(error)) {
+    return false;
+  }
+  return error.status === 404 || error.status === 410 || error.status === 422;
+}
+function isStatusError(error) {
+  return typeof error === "object" && error !== null && "status" in error;
+}
+
+// src/diff-validator.ts
+import { basename } from "path";
+import { simpleGit as simpleGit2 } from "simple-git";
+var DEFAULT_MAX_DIFF_LINES = 500;
+var DEFAULT_FORBIDDEN_PATTERNS = [
+  /eval\s*\(/,
+  /new\s+Function\s*\(/,
+  /child_process/,
+  /\bexecSync\s*\(/,
+  /\bspawnSync\s*\(/
+];
+var DEFAULT_PROTECTED_FILES = [".env*", "*.pem", "*.key"];
+async function validateDiff(repoPath, config) {
+  const git = simpleGit2(repoPath);
+  const settings = resolveValidationConfig(config);
+  const warnings = [];
+  const errors = [];
+  const [diffSummary, changedFiles, patch] = await Promise.all([
+    readDiffSummary(git),
+    readChangedFiles(git),
+    readPatch(git)
+  ]);
+  const totalLinesChanged = diffSummary.insertions + diffSummary.deletions;
+  if (totalLinesChanged > settings.maxDiffLines) {
+    errors.push(
+      `Diff too large: ${totalLinesChanged} changed lines exceeds maxDiffLines=${settings.maxDiffLines}.`
+    );
+  } else if (totalLinesChanged > Math.floor(settings.maxDiffLines * 0.8)) {
+    warnings.push(
+      `Diff is near the maximum size (${totalLinesChanged}/${settings.maxDiffLines} changed lines).`
+    );
+  }
+  if (totalLinesChanged === 0) {
+    warnings.push("No changed lines detected in the current diff.");
+  }
+  const protectedFileHits = changedFiles.filter(
+    (path) => settings.protectedFiles.some((pattern) => matchesGlob(path, pattern))
+  );
+  if (protectedFileHits.length > 0) {
+    errors.push(`Protected files were modified: ${protectedFileHits.join(", ")}.`);
+  }
+  const forbiddenHits = findForbiddenPatternHits(patch, settings.forbiddenPatterns);
+  errors.push(...forbiddenHits);
+  return {
+    valid: errors.length === 0,
+    warnings,
+    errors
+  };
+}
+async function readDiffSummary(git) {
+  try {
+    return await git.diffSummary(["HEAD"]);
+  } catch {
+    return git.diffSummary();
+  }
+}
+async function readChangedFiles(git) {
+  const withHead = await tryGitDiff(git, ["--name-only", "HEAD"]);
+  const output = withHead ?? await git.diff(["--name-only"]);
+  return output.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+}
+async function readPatch(git) {
+  const withHead = await tryGitDiff(git, ["--no-color", "--unified=0", "HEAD"]);
+  if (withHead !== void 0) {
+    return withHead;
+  }
+  return git.diff(["--no-color", "--unified=0"]);
+}
+async function tryGitDiff(git, args) {
+  try {
+    return await git.diff(args);
+  } catch {
+    return void 0;
+  }
+}
+function resolveValidationConfig(config) {
+  const diffConfig = isOacConfig(config) ? void 0 : config;
+  const maxDiffLines = isOacConfig(config) ? config.execution.validation.maxDiffLines : diffConfig?.maxDiffLines;
+  return {
+    maxDiffLines: typeof maxDiffLines === "number" && maxDiffLines > 0 ? Math.floor(maxDiffLines) : DEFAULT_MAX_DIFF_LINES,
+    forbiddenPatterns: Array.isArray(diffConfig?.forbiddenPatterns) && diffConfig.forbiddenPatterns.length > 0 ? diffConfig.forbiddenPatterns : DEFAULT_FORBIDDEN_PATTERNS,
+    protectedFiles: Array.isArray(diffConfig?.protectedFiles) && diffConfig.protectedFiles.length > 0 ? diffConfig.protectedFiles : DEFAULT_PROTECTED_FILES
+  };
+}
+function isOacConfig(value) {
+  return typeof value === "object" && value !== null && "execution" in value && typeof value.execution === "object";
+}
+function findForbiddenPatternHits(diffPatch, patterns) {
+  const hits = /* @__PURE__ */ new Set();
+  let currentFile = "(unknown)";
+  for (const line of diffPatch.split("\n")) {
+    if (line.startsWith("+++ b/")) {
+      currentFile = line.slice("+++ b/".length).trim();
+      continue;
+    }
+    if (!line.startsWith("+") || line.startsWith("+++")) {
+      continue;
+    }
+    const addedLine = line.slice(1);
+    for (const pattern of patterns) {
+      if (patternMatches(pattern, addedLine)) {
+        const preview = truncate(addedLine.trim(), 120);
+        hits.add(`Forbidden pattern "${pattern}" found in ${currentFile}: "${preview}".`);
+      }
+    }
+  }
+  return [...hits];
+}
+function patternMatches(pattern, input) {
+  const normalizedFlags = pattern.flags.replaceAll("g", "");
+  const matcher = new RegExp(pattern.source, normalizedFlags);
+  return matcher.test(input);
+}
+function matchesGlob(path, pattern) {
+  const regex = globToRegex(pattern);
+  const filename = basename(path);
+  return regex.test(path) || regex.test(filename);
+}
+function globToRegex(glob) {
+  const escaped = glob.replaceAll(/[-/\\^$+?.()|[\]{}]/g, "\\$&").replaceAll("*", ".*");
+  return new RegExp(`^${escaped}$`);
+}
+function truncate(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, maxLength - 3)}...`;
+}
+
+// src/handler.ts
+import {
+  OacError,
+  completionError as completionError3,
+  executionError
+} from "@open330/oac-core";
+var CompletionHandler = class {
+  octokit;
+  eventBus;
+  providers;
+  diffValidationConfig;
+  constructor(options) {
+    this.octokit = options.octokit;
+    this.eventBus = options.eventBus;
+    this.providers = options.providers ?? [];
+    this.diffValidationConfig = options.diffValidationConfig;
+  }
+  async handle(params) {
+    return this.complete(params);
+  }
+  async complete(params) {
+    const warnings = [];
+    const externalTaskRef = this.resolveExternalTaskRef(params.task, params.externalTaskRef);
+    try {
+      this.emitProgress(params.jobId, params.result.totalTokensUsed, "completion:validateDiff");
+      const validation = await validateDiff(
+        resolveRepoPath(params.repo),
+        params.diffValidationConfig ?? this.diffValidationConfig
+      );
+      this.handleValidationResult(validation);
+      warnings.push(...validation.warnings);
+      warnings.push(...await this.notifyStarted(externalTaskRef));
+      this.emitProgress(params.jobId, params.result.totalTokensUsed, "completion:pushBranch");
+      await pushBranch(params.repo, params.branchName);
+      this.emitProgress(params.jobId, params.result.totalTokensUsed, "completion:createPR");
+      const pr = await createPR(params, this.octokit);
+      this.eventBus.emit("pr:created", { jobId: params.jobId, prUrl: pr.url });
+      this.emitProgress(params.jobId, params.result.totalTokensUsed, "completion:linkIssue");
+      const linkIssueWarning = await this.tryLinkIssue(params.repo, params.task, pr);
+      if (linkIssueWarning) {
+        warnings.push(linkIssueWarning);
+      }
+      this.emitProgress(params.jobId, params.result.totalTokensUsed, "completion:notifyWebhooks");
+      warnings.push(...await this.notifyPRCreated(externalTaskRef, pr));
+      const completionResult = buildCompletionResult(params, pr, warnings);
+      warnings.push(...await this.notifyCompleted(externalTaskRef, completionResult));
+      return completionResult;
+    } catch (error) {
+      const normalizedError = this.normalizePipelineError(error, params);
+      this.eventBus.emit("execution:failed", {
+        jobId: params.jobId,
+        error: normalizedError
+      });
+      await this.notifyFailed(externalTaskRef, normalizedError.message);
+      throw normalizedError;
+    }
+  }
+  emitProgress(jobId, tokensUsed, stage) {
+    this.eventBus.emit("execution:progress", {
+      jobId,
+      tokensUsed,
+      stage
+    });
+  }
+  handleValidationResult(validation) {
+    if (validation.valid) {
+      return;
+    }
+    const hasForbiddenPattern = validation.errors.some(
+      (message) => message.toLowerCase().includes("forbidden pattern")
+    );
+    const errorCode = hasForbiddenPattern ? "VALIDATION_FORBIDDEN_PATTERN" : "VALIDATION_DIFF_TOO_LARGE";
+    throw executionError(errorCode, "Diff validation failed.", {
+      context: {
+        errors: validation.errors,
+        warnings: validation.warnings
+      }
+    });
+  }
+  async tryLinkIssue(repo, task, pr) {
+    try {
+      await linkIssueToePR(repo, task, pr, this.octokit);
+      return void 0;
+    } catch (error) {
+      return `Issue linking warning: ${toErrorMessage(error)}`;
+    }
+  }
+  async notifyStarted(ref) {
+    return this.notifyProviders(
+      ref,
+      "notifyStarted",
+      (provider, taskRef) => provider.notifyStarted(taskRef)
+    );
+  }
+  async notifyPRCreated(ref, pr) {
+    return this.notifyProviders(
+      ref,
+      "notifyPRCreated",
+      (provider, taskRef) => provider.notifyPRCreated(taskRef, pr.url)
+    );
+  }
+  async notifyCompleted(ref, result) {
+    return this.notifyProviders(
+      ref,
+      "notifyCompleted",
+      (provider, taskRef) => provider.notifyCompleted(taskRef, result)
+    );
+  }
+  async notifyFailed(ref, message) {
+    await this.notifyProviders(
+      ref,
+      "notifyFailed",
+      (provider, taskRef) => provider.notifyFailed(taskRef, message)
+    );
+  }
+  async notifyProviders(ref, operationName, operation) {
+    if (!ref) {
+      return [];
+    }
+    const selectedProviders = this.providers.filter((provider) => provider.id === ref.provider);
+    if (selectedProviders.length === 0) {
+      return [];
+    }
+    const results = await Promise.allSettled(
+      selectedProviders.map(async (provider) => {
+        const isReachable = await provider.ping();
+        if (!isReachable) {
+          throw new Error(`Provider "${provider.id}" is unreachable.`);
+        }
+        await operation(provider, ref);
+      })
+    );
+    const warnings = [];
+    for (let index = 0; index < results.length; index += 1) {
+      const result = results[index];
+      if (result.status === "fulfilled") {
+        continue;
+      }
+      warnings.push(
+        `${operationName} failed for provider "${selectedProviders[index].id}": ${toErrorMessage(result.reason)}`
+      );
+    }
+    return warnings;
+  }
+  resolveExternalTaskRef(task, providedRef) {
+    if (providedRef) {
+      return providedRef;
+    }
+    if (task.linkedIssue) {
+      return {
+        provider: "github",
+        externalId: `#${task.linkedIssue.number}`,
+        url: task.linkedIssue.url
+      };
+    }
+    const metadata = task.metadata;
+    const provider = readMetadataString2(metadata, "externalProvider");
+    const externalId = readMetadataString2(metadata, "externalId");
+    const url = readMetadataString2(metadata, "externalUrl");
+    if (!provider || !externalId) {
+      return void 0;
+    }
+    return { provider, externalId, url };
+  }
+  normalizePipelineError(error, params) {
+    if (error instanceof OacError) {
+      return error;
+    }
+    return completionError3(
+      "PR_CREATION_FAILED",
+      `Completion pipeline failed for task "${params.task.id}" in "${params.repo.fullName}": ${toErrorMessage(
+        error
+      )}`,
+      {
+        cause: error,
+        context: {
+          jobId: params.jobId,
+          taskId: params.task.id,
+          repo: params.repo.fullName,
+          branchName: params.branchName
+        }
+      }
+    );
+  }
+};
+function buildCompletionResult(params, pr, warnings) {
+  const filesChanged = params.result.filesChanged.length;
+  const warningSuffix = warnings.length > 0 ? ` Completed with ${warnings.length} warning(s).` : "";
+  return {
+    prUrl: pr.url,
+    commitSha: pr.sha,
+    summary: `Created PR #${pr.number} for "${params.task.title}".${warningSuffix}`,
+    filesChanged,
+    tokensUsed: params.result.totalTokensUsed
+  };
+}
+function resolveRepoPath(repo) {
+  return repo.worktreePath.trim().length > 0 ? repo.worktreePath : repo.localPath;
+}
+function readMetadataString2(metadata, key) {
+  const value = metadata[key];
+  if (typeof value === "string" && value.trim().length > 0) {
+    return value.trim();
+  }
+  return void 0;
+}
+function toErrorMessage(error) {
+  if (error instanceof Error && error.message.trim().length > 0) {
+    return error.message.trim();
+  }
+  return "Unknown error";
+}
+export {
+  CompletionHandler,
+  createPR,
+  linkIssueToPR,
+  linkIssueToePR,
+  pushBranch,
+  validateDiff
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/github-pr.ts","../src/issue-linker.ts","../src/diff-validator.ts","../src/handler.ts"],"sourcesContent":["import { type ResolvedRepo, completionError } from \"@open330/oac-core\";\nimport type { Octokit } from \"@octokit/rest\";\nimport { type SimpleGit, simpleGit } from \"simple-git\";\n\nimport type { CreatedPR, PRCreationParams } from \"./types.js\";\n\ninterface PRDiffStats {\n  filesChanged: number;\n  linesAdded: number;\n  linesRemoved: number;\n}\n\nexport async function createPR(params: PRCreationParams, octokit: Octokit): Promise<CreatedPR> {\n  const { repo, task, result, branchName, baseBranch } = params;\n  const pushedSha = await pushBranch(repo, branchName);\n  const body = await buildPrBody(params);\n\n  try {\n    const created = await octokit.pulls.create({\n      owner: repo.owner,\n      repo: repo.name,\n      title: `[OAC] ${task.title}`,\n      body,\n      head: branchName,\n      base: baseBranch,\n      draft: false,\n    });\n\n    await addLabels(octokit, repo, created.data.number, [\"oac-contribution\", task.source]);\n\n    return {\n      number: created.data.number,\n      url: created.data.html_url,\n      sha: created.data.head.sha || pushedSha,\n    };\n  } catch (error) {\n    throw completionError(\n      \"PR_CREATION_FAILED\",\n      `Failed to create PR for \"${repo.fullName}\" on branch \"${branchName}\".`,\n      {\n        cause: error,\n        context: {\n          repo: repo.fullName,\n          branchName,\n          baseBranch,\n          taskId: task.id,\n        },\n      },\n    );\n  }\n}\n\nexport async function pushBranch(repo: ResolvedRepo, branchName: string): Promise<string> {\n  const git = simpleGit(resolveGitPath(repo));\n  const headSha = (await git.revparse([\"HEAD\"])).trim();\n\n  try {\n    const remoteSha = await readRemoteBranchSha(git, branchName);\n    if (remoteSha !== headSha) {\n      await git.push(\"origin\", branchName);\n    }\n  } catch (error) {\n    try {\n      await git.raw([\"push\", \"--set-upstream\", \"origin\", branchName]);\n    } catch (retryError) {\n      throw completionError(\n        \"PR_PUSH_REJECTED\",\n        `Failed to push branch \"${branchName}\" for \"${repo.fullName}\".`,\n        {\n          cause: retryError,\n          context: {\n            repo: repo.fullName,\n            branchName,\n            headSha,\n            initialError: error instanceof Error ? error.message : \"unknown push error\",\n          },\n        },\n      );\n    }\n  }\n\n  return headSha;\n}\n\nasync function buildPrBody(params: PRCreationParams): Promise<string> {\n  const { repo, task, result, baseBranch, branchName } = params;\n  const diffStats = await resolveDiffStats(repo, baseBranch, branchName);\n  const linkedIssue = task.linkedIssue ? `\\nFixes #${task.linkedIssue.number}\\n` : \"\\n\";\n  const agentLabel = resolveAgentLabel(task.metadata);\n  const durationText = formatDurationSeconds(result.duration);\n  const summaryText =\n    task.description.trim().length > 0\n      ? task.description.trim()\n      : `Automated contribution for task \"${task.title}\".`;\n  const filesChanged = result.filesChanged.length || diffStats.filesChanged;\n  const filesPreview = renderFilesPreview(result.filesChanged);\n\n  return [\n    \"## Summary\",\n    \"\",\n    summaryText,\n    \"\",\n    \"## Changes\",\n    \"\",\n    filesPreview,\n    \"\",\n    `- **Files changed:** ${filesChanged}`,\n    `- **Lines added:** ${diffStats.linesAdded}`,\n    `- **Lines removed:** ${diffStats.linesRemoved}`,\n    \"\",\n    \"## Context\",\n    \"\",\n    `- **Task source:** ${task.source}`,\n    `- **Agent:** ${agentLabel}`,\n    `- **Tokens used:** ${result.totalTokensUsed}`,\n    `- **Execution time:** ${durationText}`,\n    linkedIssue.trimEnd(),\n    \"\",\n    \"---\",\n    \"*This PR was automatically generated by OAC.*\",\n  ].join(\"\\n\");\n}\n\nasync function resolveDiffStats(\n  repo: ResolvedRepo,\n  baseBranch: string,\n  branchName: string,\n): Promise<PRDiffStats> {\n  const git = simpleGit(resolveGitPath(repo));\n  const ranges = [\n    [`origin/${baseBranch}...${branchName}`],\n    [`${baseBranch}...${branchName}`],\n    [\"HEAD\"],\n    [],\n  ] as string[][];\n\n  for (const range of ranges) {\n    try {\n      const summary = await git.diffSummary(range);\n      return {\n        filesChanged: summary.changed,\n        linesAdded: summary.insertions,\n        linesRemoved: summary.deletions,\n      };\n    } catch {}\n  }\n\n  return {\n    filesChanged: 0,\n    linesAdded: 0,\n    linesRemoved: 0,\n  };\n}\n\nasync function addLabels(\n  octokit: Octokit,\n  repo: ResolvedRepo,\n  prNumber: number,\n  labels: string[],\n): Promise<void> {\n  const uniqueLabels = [...new Set(labels.map((label) => label.trim()).filter(Boolean))];\n  if (uniqueLabels.length === 0) {\n    return;\n  }\n\n  try {\n    await octokit.issues.addLabels({\n      owner: repo.owner,\n      repo: repo.name,\n      issue_number: prNumber,\n      labels: uniqueLabels,\n    });\n  } catch {\n    // Labeling failure should not block PR creation.\n  }\n}\n\nfunction resolveGitPath(repo: ResolvedRepo): string {\n  return repo.worktreePath.trim().length > 0 ? repo.worktreePath : repo.localPath;\n}\n\nasync function readRemoteBranchSha(\n  git: SimpleGit,\n  branchName: string,\n): Promise<string | undefined> {\n  const remoteHeads = await git.listRemote([\"--heads\", \"origin\", branchName]);\n  const firstLine = remoteHeads\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .find((line) => line.length > 0);\n\n  if (!firstLine) {\n    return undefined;\n  }\n\n  const [sha] = firstLine.split(/\\s+/);\n  return sha;\n}\n\nfunction resolveAgentLabel(metadata: Record<string, unknown>): string {\n  const fromAgent = readMetadataString(metadata, [\"agent\", \"agentName\", \"provider\"]);\n  return fromAgent ?? \"unknown\";\n}\n\nfunction readMetadataString(metadata: Record<string, unknown>, keys: string[]): string | undefined {\n  for (const key of keys) {\n    const value = metadata[key];\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      return value.trim();\n    }\n  }\n  return undefined;\n}\n\nfunction renderFilesPreview(files: string[]): string {\n  if (files.length === 0) {\n    return \"- No file list was reported by the execution step.\";\n  }\n\n  const preview = files.slice(0, 15).map((path) => `- \\`${path}\\``);\n  if (files.length > 15) {\n    preview.push(`- ...and ${files.length - 15} more file(s)`);\n  }\n\n  return preview.join(\"\\n\");\n}\n\nfunction formatDurationSeconds(duration: number): string {\n  if (!Number.isFinite(duration) || duration <= 0) {\n    return \"0s\";\n  }\n\n  const seconds = duration > 1_000 ? duration / 1_000 : duration;\n  if (seconds >= 100) {\n    return `${Math.round(seconds)}s`;\n  }\n\n  return `${seconds.toFixed(1)}s`;\n}\n","import { type ResolvedRepo, type Task, completionError } from \"@open330/oac-core\";\nimport type { Octokit } from \"@octokit/rest\";\n\nimport type { CreatedPR } from \"./types.js\";\n\nexport async function linkIssueToePR(\n  repo: ResolvedRepo,\n  task: Task,\n  pr: CreatedPR,\n  octokit: Octokit,\n): Promise<void> {\n  if (!task.linkedIssue) {\n    return;\n  }\n\n  const issueNumber = task.linkedIssue.number;\n\n  try {\n    const issue = await octokit.issues.get({\n      owner: repo.owner,\n      repo: repo.name,\n      issue_number: issueNumber,\n    });\n\n    if (issue.data.state === \"closed\") {\n      return;\n    }\n\n    await octokit.issues.createComment({\n      owner: repo.owner,\n      repo: repo.name,\n      issue_number: issueNumber,\n      body: `OAC opened a PR for this issue: ${pr.url}`,\n    });\n  } catch (error) {\n    if (isNonBlockingIssueError(error)) {\n      return;\n    }\n\n    throw completionError(\n      \"PR_CREATION_FAILED\",\n      `Failed to link issue #${issueNumber} to PR #${pr.number}.`,\n      {\n        cause: error,\n        context: {\n          repo: repo.fullName,\n          issueNumber,\n          prNumber: pr.number,\n        },\n      },\n    );\n  }\n}\n\nexport const linkIssueToPR = linkIssueToePR;\n\nfunction isNonBlockingIssueError(error: unknown): boolean {\n  if (!isStatusError(error)) {\n    return false;\n  }\n\n  return error.status === 404 || error.status === 410 || error.status === 422;\n}\n\nfunction isStatusError(error: unknown): error is { status?: number } {\n  return typeof error === \"object\" && error !== null && \"status\" in error;\n}\n","import { basename } from \"node:path\";\n\nimport type { OacConfig } from \"@open330/oac-core\";\nimport { type SimpleGit, simpleGit } from \"simple-git\";\n\nconst DEFAULT_MAX_DIFF_LINES = 500;\nconst DEFAULT_FORBIDDEN_PATTERNS: RegExp[] = [\n  /eval\\s*\\(/,\n  /new\\s+Function\\s*\\(/,\n  /child_process/,\n  /\\bexecSync\\s*\\(/,\n  /\\bspawnSync\\s*\\(/,\n];\nconst DEFAULT_PROTECTED_FILES = [\".env*\", \"*.pem\", \"*.key\"];\n\ninterface ResolvedValidationConfig {\n  maxDiffLines: number;\n  forbiddenPatterns: RegExp[];\n  protectedFiles: string[];\n}\n\nexport interface DiffValidationConfig {\n  maxDiffLines?: number;\n  forbiddenPatterns?: RegExp[];\n  protectedFiles?: string[];\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  warnings: string[];\n  errors: string[];\n}\n\nexport async function validateDiff(\n  repoPath: string,\n  config?: DiffValidationConfig | OacConfig,\n): Promise<ValidationResult> {\n  const git = simpleGit(repoPath);\n  const settings = resolveValidationConfig(config);\n  const warnings: string[] = [];\n  const errors: string[] = [];\n\n  const [diffSummary, changedFiles, patch] = await Promise.all([\n    readDiffSummary(git),\n    readChangedFiles(git),\n    readPatch(git),\n  ]);\n\n  const totalLinesChanged = diffSummary.insertions + diffSummary.deletions;\n  if (totalLinesChanged > settings.maxDiffLines) {\n    errors.push(\n      `Diff too large: ${totalLinesChanged} changed lines exceeds maxDiffLines=${settings.maxDiffLines}.`,\n    );\n  } else if (totalLinesChanged > Math.floor(settings.maxDiffLines * 0.8)) {\n    warnings.push(\n      `Diff is near the maximum size (${totalLinesChanged}/${settings.maxDiffLines} changed lines).`,\n    );\n  }\n\n  if (totalLinesChanged === 0) {\n    warnings.push(\"No changed lines detected in the current diff.\");\n  }\n\n  const protectedFileHits = changedFiles.filter((path) =>\n    settings.protectedFiles.some((pattern) => matchesGlob(path, pattern)),\n  );\n  if (protectedFileHits.length > 0) {\n    errors.push(`Protected files were modified: ${protectedFileHits.join(\", \")}.`);\n  }\n\n  const forbiddenHits = findForbiddenPatternHits(patch, settings.forbiddenPatterns);\n  errors.push(...forbiddenHits);\n\n  return {\n    valid: errors.length === 0,\n    warnings,\n    errors,\n  };\n}\n\nasync function readDiffSummary(git: SimpleGit) {\n  try {\n    return await git.diffSummary([\"HEAD\"]);\n  } catch {\n    return git.diffSummary();\n  }\n}\n\nasync function readChangedFiles(git: SimpleGit): Promise<string[]> {\n  const withHead = await tryGitDiff(git, [\"--name-only\", \"HEAD\"]);\n  const output = withHead ?? (await git.diff([\"--name-only\"]));\n\n  return output\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n}\n\nasync function readPatch(git: SimpleGit): Promise<string> {\n  const withHead = await tryGitDiff(git, [\"--no-color\", \"--unified=0\", \"HEAD\"]);\n  if (withHead !== undefined) {\n    return withHead;\n  }\n  return git.diff([\"--no-color\", \"--unified=0\"]);\n}\n\nasync function tryGitDiff(git: SimpleGit, args: string[]): Promise<string | undefined> {\n  try {\n    return await git.diff(args);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction resolveValidationConfig(\n  config?: DiffValidationConfig | OacConfig,\n): ResolvedValidationConfig {\n  const diffConfig = isOacConfig(config) ? undefined : config;\n  const maxDiffLines = isOacConfig(config)\n    ? config.execution.validation.maxDiffLines\n    : diffConfig?.maxDiffLines;\n\n  return {\n    maxDiffLines:\n      typeof maxDiffLines === \"number\" && maxDiffLines > 0\n        ? Math.floor(maxDiffLines)\n        : DEFAULT_MAX_DIFF_LINES,\n    forbiddenPatterns:\n      Array.isArray(diffConfig?.forbiddenPatterns) && diffConfig.forbiddenPatterns.length > 0\n        ? diffConfig.forbiddenPatterns\n        : DEFAULT_FORBIDDEN_PATTERNS,\n    protectedFiles:\n      Array.isArray(diffConfig?.protectedFiles) && diffConfig.protectedFiles.length > 0\n        ? diffConfig.protectedFiles\n        : DEFAULT_PROTECTED_FILES,\n  };\n}\n\nfunction isOacConfig(value: DiffValidationConfig | OacConfig | undefined): value is OacConfig {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"execution\" in value &&\n    typeof (value as { execution?: unknown }).execution === \"object\"\n  );\n}\n\nfunction findForbiddenPatternHits(diffPatch: string, patterns: RegExp[]): string[] {\n  const hits = new Set<string>();\n  let currentFile = \"(unknown)\";\n\n  for (const line of diffPatch.split(\"\\n\")) {\n    if (line.startsWith(\"+++ b/\")) {\n      currentFile = line.slice(\"+++ b/\".length).trim();\n      continue;\n    }\n\n    if (!line.startsWith(\"+\") || line.startsWith(\"+++\")) {\n      continue;\n    }\n\n    const addedLine = line.slice(1);\n    for (const pattern of patterns) {\n      if (patternMatches(pattern, addedLine)) {\n        const preview = truncate(addedLine.trim(), 120);\n        hits.add(`Forbidden pattern \"${pattern}\" found in ${currentFile}: \"${preview}\".`);\n      }\n    }\n  }\n\n  return [...hits];\n}\n\nfunction patternMatches(pattern: RegExp, input: string): boolean {\n  const normalizedFlags = pattern.flags.replaceAll(\"g\", \"\");\n  const matcher = new RegExp(pattern.source, normalizedFlags);\n  return matcher.test(input);\n}\n\nfunction matchesGlob(path: string, pattern: string): boolean {\n  const regex = globToRegex(pattern);\n  const filename = basename(path);\n  return regex.test(path) || regex.test(filename);\n}\n\nfunction globToRegex(glob: string): RegExp {\n  const escaped = glob.replaceAll(/[-/\\\\^$+?.()|[\\]{}]/g, \"\\\\$&\").replaceAll(\"*\", \".*\");\n  return new RegExp(`^${escaped}$`);\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength - 3)}...`;\n}\n","import {\n  type OacConfig,\n  OacError,\n  type OacEventBus,\n  type ResolvedRepo,\n  type Task,\n  completionError,\n  executionError,\n} from \"@open330/oac-core\";\nimport type { Octokit } from \"@octokit/rest\";\n\nimport {\n  type DiffValidationConfig,\n  type ValidationResult,\n  validateDiff,\n} from \"./diff-validator.js\";\nimport { createPR, pushBranch } from \"./github-pr.js\";\nimport { linkIssueToePR } from \"./issue-linker.js\";\nimport type {\n  CompletionResult,\n  CreatedPR,\n  ExternalTaskRef,\n  PRCreationParams,\n  ProjectManagementProvider,\n} from \"./types.js\";\n\nexport interface CompletionHandlerOptions {\n  octokit: Octokit;\n  eventBus: OacEventBus;\n  providers?: ProjectManagementProvider[];\n  diffValidationConfig?: DiffValidationConfig | OacConfig;\n}\n\nexport interface CompletionHandlerParams extends PRCreationParams {\n  jobId: string;\n  externalTaskRef?: ExternalTaskRef;\n  diffValidationConfig?: DiffValidationConfig | OacConfig;\n}\n\nexport class CompletionHandler {\n  private readonly octokit: Octokit;\n  private readonly eventBus: OacEventBus;\n  private readonly providers: ProjectManagementProvider[];\n  private readonly diffValidationConfig?: DiffValidationConfig | OacConfig;\n\n  public constructor(options: CompletionHandlerOptions) {\n    this.octokit = options.octokit;\n    this.eventBus = options.eventBus;\n    this.providers = options.providers ?? [];\n    this.diffValidationConfig = options.diffValidationConfig;\n  }\n\n  public async handle(params: CompletionHandlerParams): Promise<CompletionResult> {\n    return this.complete(params);\n  }\n\n  public async complete(params: CompletionHandlerParams): Promise<CompletionResult> {\n    const warnings: string[] = [];\n    const externalTaskRef = this.resolveExternalTaskRef(params.task, params.externalTaskRef);\n\n    try {\n      this.emitProgress(params.jobId, params.result.totalTokensUsed, \"completion:validateDiff\");\n      const validation = await validateDiff(\n        resolveRepoPath(params.repo),\n        params.diffValidationConfig ?? this.diffValidationConfig,\n      );\n      this.handleValidationResult(validation);\n      warnings.push(...validation.warnings);\n\n      warnings.push(...(await this.notifyStarted(externalTaskRef)));\n\n      this.emitProgress(params.jobId, params.result.totalTokensUsed, \"completion:pushBranch\");\n      await pushBranch(params.repo, params.branchName);\n\n      this.emitProgress(params.jobId, params.result.totalTokensUsed, \"completion:createPR\");\n      const pr = await createPR(params, this.octokit);\n      this.eventBus.emit(\"pr:created\", { jobId: params.jobId, prUrl: pr.url });\n\n      this.emitProgress(params.jobId, params.result.totalTokensUsed, \"completion:linkIssue\");\n      const linkIssueWarning = await this.tryLinkIssue(params.repo, params.task, pr);\n      if (linkIssueWarning) {\n        warnings.push(linkIssueWarning);\n      }\n\n      this.emitProgress(params.jobId, params.result.totalTokensUsed, \"completion:notifyWebhooks\");\n      warnings.push(...(await this.notifyPRCreated(externalTaskRef, pr)));\n\n      const completionResult = buildCompletionResult(params, pr, warnings);\n      warnings.push(...(await this.notifyCompleted(externalTaskRef, completionResult)));\n\n      return completionResult;\n    } catch (error) {\n      const normalizedError = this.normalizePipelineError(error, params);\n      this.eventBus.emit(\"execution:failed\", {\n        jobId: params.jobId,\n        error: normalizedError,\n      });\n      await this.notifyFailed(externalTaskRef, normalizedError.message);\n      throw normalizedError;\n    }\n  }\n\n  private emitProgress(jobId: string, tokensUsed: number, stage: string): void {\n    this.eventBus.emit(\"execution:progress\", {\n      jobId,\n      tokensUsed,\n      stage,\n    });\n  }\n\n  private handleValidationResult(validation: ValidationResult): void {\n    if (validation.valid) {\n      return;\n    }\n\n    const hasForbiddenPattern = validation.errors.some((message) =>\n      message.toLowerCase().includes(\"forbidden pattern\"),\n    );\n    const errorCode = hasForbiddenPattern\n      ? \"VALIDATION_FORBIDDEN_PATTERN\"\n      : \"VALIDATION_DIFF_TOO_LARGE\";\n\n    throw executionError(errorCode, \"Diff validation failed.\", {\n      context: {\n        errors: validation.errors,\n        warnings: validation.warnings,\n      },\n    });\n  }\n\n  private async tryLinkIssue(\n    repo: ResolvedRepo,\n    task: Task,\n    pr: CreatedPR,\n  ): Promise<string | undefined> {\n    try {\n      await linkIssueToePR(repo, task, pr, this.octokit);\n      return undefined;\n    } catch (error) {\n      return `Issue linking warning: ${toErrorMessage(error)}`;\n    }\n  }\n\n  private async notifyStarted(ref: ExternalTaskRef | undefined): Promise<string[]> {\n    return this.notifyProviders(ref, \"notifyStarted\", (provider, taskRef) =>\n      provider.notifyStarted(taskRef),\n    );\n  }\n\n  private async notifyPRCreated(\n    ref: ExternalTaskRef | undefined,\n    pr: CreatedPR,\n  ): Promise<string[]> {\n    return this.notifyProviders(ref, \"notifyPRCreated\", (provider, taskRef) =>\n      provider.notifyPRCreated(taskRef, pr.url),\n    );\n  }\n\n  private async notifyCompleted(\n    ref: ExternalTaskRef | undefined,\n    result: CompletionResult,\n  ): Promise<string[]> {\n    return this.notifyProviders(ref, \"notifyCompleted\", (provider, taskRef) =>\n      provider.notifyCompleted(taskRef, result),\n    );\n  }\n\n  private async notifyFailed(ref: ExternalTaskRef | undefined, message: string): Promise<void> {\n    await this.notifyProviders(ref, \"notifyFailed\", (provider, taskRef) =>\n      provider.notifyFailed(taskRef, message),\n    );\n  }\n\n  private async notifyProviders(\n    ref: ExternalTaskRef | undefined,\n    operationName: string,\n    operation: (provider: ProjectManagementProvider, taskRef: ExternalTaskRef) => Promise<void>,\n  ): Promise<string[]> {\n    if (!ref) {\n      return [];\n    }\n\n    const selectedProviders = this.providers.filter((provider) => provider.id === ref.provider);\n    if (selectedProviders.length === 0) {\n      return [];\n    }\n\n    const results = await Promise.allSettled(\n      selectedProviders.map(async (provider) => {\n        const isReachable = await provider.ping();\n        if (!isReachable) {\n          throw new Error(`Provider \"${provider.id}\" is unreachable.`);\n        }\n        await operation(provider, ref);\n      }),\n    );\n\n    const warnings: string[] = [];\n    for (let index = 0; index < results.length; index += 1) {\n      const result = results[index];\n      if (result.status === \"fulfilled\") {\n        continue;\n      }\n\n      warnings.push(\n        `${operationName} failed for provider \"${\n          selectedProviders[index].id\n        }\": ${toErrorMessage(result.reason)}`,\n      );\n    }\n\n    return warnings;\n  }\n\n  private resolveExternalTaskRef(\n    task: Task,\n    providedRef?: ExternalTaskRef,\n  ): ExternalTaskRef | undefined {\n    if (providedRef) {\n      return providedRef;\n    }\n\n    if (task.linkedIssue) {\n      return {\n        provider: \"github\",\n        externalId: `#${task.linkedIssue.number}`,\n        url: task.linkedIssue.url,\n      };\n    }\n\n    const metadata = task.metadata as Record<string, unknown>;\n    const provider = readMetadataString(metadata, \"externalProvider\");\n    const externalId = readMetadataString(metadata, \"externalId\");\n    const url = readMetadataString(metadata, \"externalUrl\");\n\n    if (!provider || !externalId) {\n      return undefined;\n    }\n\n    return { provider, externalId, url };\n  }\n\n  private normalizePipelineError(error: unknown, params: CompletionHandlerParams): OacError {\n    if (error instanceof OacError) {\n      return error;\n    }\n\n    return completionError(\n      \"PR_CREATION_FAILED\",\n      `Completion pipeline failed for task \"${params.task.id}\" in \"${params.repo.fullName}\": ${toErrorMessage(\n        error,\n      )}`,\n      {\n        cause: error,\n        context: {\n          jobId: params.jobId,\n          taskId: params.task.id,\n          repo: params.repo.fullName,\n          branchName: params.branchName,\n        },\n      },\n    );\n  }\n}\n\nfunction buildCompletionResult(\n  params: CompletionHandlerParams,\n  pr: CreatedPR,\n  warnings: string[],\n): CompletionResult {\n  const filesChanged = params.result.filesChanged.length;\n  const warningSuffix = warnings.length > 0 ? ` Completed with ${warnings.length} warning(s).` : \"\";\n\n  return {\n    prUrl: pr.url,\n    commitSha: pr.sha,\n    summary: `Created PR #${pr.number} for \"${params.task.title}\".${warningSuffix}`,\n    filesChanged,\n    tokensUsed: params.result.totalTokensUsed,\n  };\n}\n\nfunction resolveRepoPath(repo: ResolvedRepo): string {\n  return repo.worktreePath.trim().length > 0 ? repo.worktreePath : repo.localPath;\n}\n\nfunction readMetadataString(metadata: Record<string, unknown>, key: string): string | undefined {\n  const value = metadata[key];\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    return value.trim();\n  }\n  return undefined;\n}\n\nfunction toErrorMessage(error: unknown): string {\n  if (error instanceof Error && error.message.trim().length > 0) {\n    return error.message.trim();\n  }\n  return \"Unknown error\";\n}\n"],"mappings":"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","names":["completionError","simpleGit","completionError","readMetadataString","completionError"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@open330/oac-completion",
+  "version": "2026.2.17",
+  "description": "PR creation and post-execution completion for OAC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Open330/open-agent-contribution.git",
+    "directory": "packages/completion"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.1.1",
+    "simple-git": "^3.27.0",
+    "@open330/oac-core": "2026.2.17"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}