@open-cr-agent/vcs-local 0.2.0 → 0.4.0

package/README.md

@@ -1,3 +1,3 @@
 # @open-cr-agent/vcs-local
 
-The adapter for local Git changes (working tree, ranges and commits) of [Open-CR-Agent](https://github.com/jma49/Open-CR-Agent), the multi-agent code reviewer. Most users want [`@open-cr-agent/cli`](https://www.npmjs.com/package/@open-cr-agent/cli), which provides the `ocra` command and installs this package; see the [manual](https://ocra.majincheng.com). All `@open-cr-agent` packages are released together at one version. Apache-2.0.
+The adapter for local Git changes (working tree, ranges and commits) of [Open-CR-Agent](https://github.com/jma49/Open-CR-Agent), the multi-agent code reviewer. Most users want [`@open-cr-agent/cli`](https://www.npmjs.com/package/@open-cr-agent/cli), which provides the `ocra` command and installs this package; see the [manual](https://ocracloud.com). All `@open-cr-agent` packages are released together at one version. Apache-2.0.

package/dist/commits.js

@@ -1,3 +1,4 @@
+import { OcraError } from "@open-cr-agent/core";
 import { git } from "./git.js";
 const FETCH_TIMEOUT_MS = 5 * 60_000;
 // Pull request commits are often missing from a local clone (shallow CI
@@ -7,7 +8,7 @@ export async function ensureCommits(root, shas, refspecs = [], remote = "origin"
     // Anything but a commit id could be read by git fetch as an option.
     const invalid = shas.filter((sha) => !/^[0-9a-f]{40}([0-9a-f]{24})?$/.test(sha));
     if (invalid.length > 0)
-        throw new Error(`Not commit ids: ${invalid.join(", ")}`);
+        throw new OcraError("INPUT_INVALID", `Not commit ids: ${invalid.join(", ")}`);
     const missing = async () => {
         const result = [];
         for (const sha of shas) {
@@ -36,7 +37,7 @@ export async function ensureCommits(root, shas, refspecs = [], remote = "origin"
         absent = await missing();
     }
     if (absent.length > 0) {
-        throw new Error(`Commits ${absent.join(", ")} are not in this repository and could not be fetched from ${remote}`);
+        throw new OcraError("VCS_REF_UNKNOWN", `Commits ${absent.join(", ")} are not in this repository and could not be fetched from ${remote}`);
     }
 }
 //# sourceMappingURL=commits.js.map

package/dist/git.d.ts

@@ -1,3 +1,4 @@
+import { OcraError } from "@open-cr-agent/core";
 export interface GitOptions {
     cwd: string;
     input?: string;
@@ -7,7 +8,7 @@ export interface GitOptions {
     timeoutMs?: number;
 }
 export declare const GIT_TIMEOUT_MS: number;
-export declare class GitError extends Error {
+export declare class GitError extends OcraError {
     readonly args: readonly string[];
     readonly exitCode: number | undefined;
     readonly stderr: string;

package/dist/git.js

@@ -1,16 +1,18 @@
 import { execFile } from "node:child_process";
+import { OcraError } from "@open-cr-agent/core";
 // Every git call ends: a fetch can wait on the network forever, and a diff
 // of a huge repository should fail rather than hang the review.
 export const GIT_TIMEOUT_MS = 10 * 60_000;
-export class GitError extends Error {
+export class GitError extends OcraError {
     args;
     exitCode;
     stderr;
     constructor(args, exitCode, stderr) {
-        super(`git ${args.join(" ")} failed (exit ${exitCode ?? "unknown"}): ${stderr.trim()}`);
+        super("VCS_GIT_FAILED", `git ${args.join(" ")} failed (exit ${exitCode ?? "unknown"}): ${stderr.trim()}`);
         this.args = args;
         this.exitCode = exitCode;
         this.stderr = stderr;
+        this.name = "GitError";
     }
 }
 const MAX_OUTPUT_BYTES = 512 * 1024 * 1024;

package/dist/index.d.ts

@@ -1,6 +1,4 @@
-export { ensureCommits } from "./commits.js";
 export { GitError } from "./git.js";
-export * from "./history.js";
-export * from "./local-adapter.js";
-export * from "./plugin.js";
+export type { LocalGitOptions, LocalTarget } from "./local-adapter.js";
+export { localGitPlugin } from "./plugin.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,6 +1,3 @@
-export { ensureCommits } from "./commits.js";
 export { GitError } from "./git.js";
-export * from "./history.js";
-export * from "./local-adapter.js";
-export * from "./plugin.js";
+export { localGitPlugin } from "./plugin.js";
 //# sourceMappingURL=index.js.map

package/dist/internal.d.ts

@@ -0,0 +1,5 @@
+export { ensureCommits } from "./commits.js";
+export { type ChangedFiles, filesChangedSince } from "./history.js";
+export { LocalGitAdapter } from "./local-adapter.js";
+export { findRepositoryRoot } from "./plugin.js";
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.js

@@ -0,0 +1,7 @@
+// "@open-cr-agent/vcs-local/internal": what the CLI uses beyond the public
+// entry. Not a contract: any release may change it.
+export { ensureCommits } from "./commits.js";
+export { filesChangedSince } from "./history.js";
+export { LocalGitAdapter } from "./local-adapter.js";
+export { findRepositoryRoot } from "./plugin.js";
+//# sourceMappingURL=internal.js.map

package/dist/local-adapter.js

@@ -1,7 +1,8 @@
 import { cp, lstat, mkdtemp, open, readFile, readlink, realpath, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { parseUnifiedDiff, } from "@open-cr-agent/core";
+import { OcraError, } from "@open-cr-agent/core";
+import { parseUnifiedDiff } from "@open-cr-agent/core/internal";
 import { GitError, git, isShallow, SHALLOW_HINT } from "./git.js";
 const WORKING_TREE = "working-tree";
 const SEARCH_RESULT_LIMIT = 100;
@@ -180,7 +181,7 @@ async function mergeBase(root, from, to) {
     }
     catch (error) {
         if (error instanceof GitError && (await isShallow(root))) {
-            throw new Error(`Cannot find where ${from.slice(0, 7)} and ${to.slice(0, 7)} diverge: ${SHALLOW_HINT}`);
+            throw new OcraError("VCS_GIT_FAILED", `Cannot find where ${from.slice(0, 7)} and ${to.slice(0, 7)} diverge: ${SHALLOW_HINT}`);
         }
         throw error;
     }
@@ -233,7 +234,7 @@ function request(id, title, description, baseSha, headSha) {
 async function verifyCommit(root, ref) {
     const sha = await tryVerifyCommit(root, ref);
     if (sha === undefined)
-        throw new Error(`Unknown commit: ${ref}`);
+        throw new OcraError("VCS_REF_UNKNOWN", `Unknown commit: ${ref}`);
     return sha;
 }
 // --end-of-options stops a user-supplied ref such as "--output=x" from being

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@open-cr-agent/vcs-local",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Local git adapter for Open-CR-Agent: working tree, ranges and commits",
   "keywords": [
     "code-review",
     "git"
   ],
   "license": "Apache-2.0",
-  "homepage": "https://ocra.majincheng.com",
+  "homepage": "https://ocracloud.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jma49/Open-CR-Agent.git",
@@ -18,18 +18,26 @@
     "node": ">=22.19"
   },
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
+      "@open-cr-agent/source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
-    }
+    },
+    "./internal": {
+      "@open-cr-agent/source": "./src/internal.ts",
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "!dist/**/*.map"
   ],
   "dependencies": {
-    "@open-cr-agent/core": "0.2.0",
+    "@open-cr-agent/core": "0.4.0",
     "zod": "^4.6.5"
   },
   "publishConfig": {