opencode-repo-local 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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/README.md

@@ -0,0 +1,193 @@
+# opencode-repo-local
+
+OpenCode plugin that ensures a repository exists locally (clone or update) and returns an absolute path so you can use OpenCode built-in tools directly.
+
+## What it does
+
+- Exposes one custom tool: `repo_ensure_local`
+- Clones missing repositories into a deterministic local root
+- Updates existing repositories with safe, non-destructive defaults
+- Returns structured output including `local_path` for immediate `Read` / `Glob` / `Grep` / `Bash` usage
+
+## Installation
+
+### From npm
+
+Add the package to your OpenCode config:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-repo-local"]
+}
+```
+
+### Local development
+
+1. Install dependencies:
+
+```bash
+bun install
+```
+
+2. For local OpenCode testing in this repo, use the included local plugin wiring:
+
+- `.opencode/plugins/repo-local-plugin.ts` imports `src/index.ts` directly for fast iteration (no build step required)
+- `.opencode/package.json` installs plugin runtime dependencies for OpenCode
+
+3. For a publishable artifact check, run `bun run build` before release.
+
+4. Or publish and install via npm for regular usage.
+
+## Tool: `repo_ensure_local`
+
+Arguments:
+
+- `repo` (required): repository reference in one of these forms:
+  - `https://host/owner/repo(.git)`
+  - `git@host:owner/repo.git` (when `allow_ssh` is true)
+  - `host/owner/repo`
+  - `owner/repo` (GitHub shorthand)
+- `ref` (optional): branch/tag/SHA to checkout after clone/fetch
+- `clone_root` (optional): absolute path override for clone root
+- `depth` (optional): shallow clone depth
+- `update_mode` (optional): `ff-only` (default), `fetch-only`, `reset-clean`
+- `allow_ssh` (optional): allow `git@host:owner/repo.git` URLs
+
+Output fields:
+
+- `status`: `cloned` | `updated` | `already-current` | `fetched`
+- `repo_url`
+- `local_path`
+- `current_ref`
+- `default_branch`
+- `head_sha`
+- `comparison_ref`
+- `remote_head_sha`
+- `ahead_by`
+- `behind_by`
+- `freshness`: `current` | `stale` | `ahead` | `diverged` | `unknown`
+- `actions`
+- `instructions`
+
+Freshness semantics:
+
+- Default `update_mode=ff-only` is the recommended one-call path for agents: it updates when safe and returns freshness metadata.
+- Use `update_mode=fetch-only` when you explicitly want non-mutating freshness/version checks.
+
+## Environment variables
+
+- `OPENCODE_REPO_CLONE_ROOT`: default clone root (fallback is `~/.opencode/repos`)
+- `OPENCODE_REPO_ALLOW_SSH=true`: default SSH URL allowance
+- `OPENCODE_REPO_TELEMETRY_PATH`: optional telemetry JSONL path override
+
+## Telemetry
+
+- `repo_ensure_local` writes invocation telemetry on every run.
+- Default file: `~/.local/share/opencode/plugins/opencode-repo-local/telemetry.jsonl`
+- Event fields include `repo_input`, `canonical_repo_url`, `status`, `local_path`, and error metadata.
+
+## OpenCode permissions
+
+- This repo includes `opencode.json` with:
+  - `permission.external_directory["~/.opencode/repos/**"] = "allow"`
+- This lets OpenCode built-in tools access cloned repos under `~/.opencode/repos` without repeated approval prompts.
+- Recommended for users of this plugin: add the same permission rule to your own global or project OpenCode config.
+
+## Local OpenCode smoke test
+
+Use this to validate the plugin in a real OpenCode session.
+
+1. Confirm OpenCode loads the local plugin shim:
+
+```bash
+opencode debug config
+```
+
+Verify plugin list includes `.opencode/plugins/repo-local-plugin.ts`.
+
+2. Forced tool smoke test (deterministic):
+
+```bash
+opencode run "You must call repo_ensure_local first. Use repo='Aureatus/opencode-repo-local' and update_mode='fetch-only'. Then report only: status, repo_url, local_path, head_sha."
+```
+
+3. Natural-intent smoke test (agent should choose the tool):
+
+```bash
+opencode run "Please inspect ghoulr/opencode-websearch-cited, find the custom tool it exports, and report the file path where it is defined."
+```
+
+Important:
+
+- Run the natural-intent test against a repo that is not your current workspace.
+- If you reference the current repo, OpenCode may correctly skip `repo_ensure_local` because local files are already available.
+
+Expected behavior:
+
+- OpenCode chooses `repo_ensure_local` for external repo references.
+- Output includes a valid `local_path` under `~/.opencode/repos/...`.
+- Follow-up inspection uses built-in tools (`Read`, `Glob`, `Grep`, `Bash`) against that local path.
+
+## Safety behavior
+
+- Rejects malformed/unsupported repo URLs
+- Prevents clone path escape outside clone root
+- Validates existing clone remote against requested repository
+- Avoids destructive sync by default (`ff-only`)
+
+## Development
+
+```bash
+bun install
+bun run fix
+bun run check
+bun run lint
+bun run typecheck
+bun run test
+bun run test:integration
+bun run test:e2e
+bun run build
+```
+
+## Releasing
+
+- This project uses tag-driven publishing to npm via GitHub Actions.
+- Use release helper scripts:
+  - `bun run release:verify`
+  - `bun run release:patch|minor|major`
+  - `bun run release:beta:first` / `bun run release:beta:next`
+- Push version commit and tag with `git push origin main --follow-tags`.
+- Full runbook: see `RELEASING.md`.
+
+Integration script notes:
+
+- Default run validates multiple allowed input formats against `Aureatus/opencode-repo-local`.
+- Override to a single repo input: `bun run test:integration -- https://github.com/OWNER/REPO.git`
+- Keep clone directory for inspection: `OPENCODE_REPO_INTEGRATION_KEEP=true bun run test:integration`
+- Set custom clone root: `OPENCODE_REPO_INTEGRATION_ROOT=/abs/path bun run test:integration`
+
+E2E script notes:
+
+- `bun run test:e2e` runs real `opencode run` prompts and asserts tool usage via telemetry.
+- It validates all supported repo input formats across two required targets:
+  - `Aureatus/opencode-repo-local`
+  - `ghoulr/opencode-websearch-cited`
+- It checks each target's formats resolve to one normalized local path.
+- Keep temporary artifacts for inspection: `OPENCODE_REPO_E2E_KEEP=true bun run test:e2e`
+- The test is valid because each run uses:
+  - a fresh temporary clone root (`/tmp/opencode-repo-e2e-.../clones`), not the current workspace,
+  - a run-specific telemetry file,
+  - real OpenCode prompts that must trigger `repo_ensure_local`.
+- This verifies end-to-end behavior (tool invocation, clone/update, and normalized path resolution) without depending on local workspace files.
+
+## Git hooks
+
+- This repo uses Husky for pre-commit and pre-push hooks.
+- Full local check command: `bun run check` (runs no-ignore guard, `lint`, `typecheck`, `test`, `build`, and `test:integration` in parallel where possible).
+- Build command: `bun run build` (`tsdown --fail-on-warn`, warnings fail the build).
+- Lint command: `bun run lint` (Ultracite/Biome with `--error-on-warnings`).
+- Fix command: `bun run fix` (Ultracite safe + unsafe fixes, then no-ignore guard).
+- Pre-commit command: `bun run check`.
+- Pre-push command: `bun run check`.
+- Hooks are installed by running `bun install` via the `prepare` script.

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "@opencode-ai/plugin";
+
+//#region src/index.d.ts
+declare const RepoLocalPlugin: Plugin;
+//#endregion
+export { RepoLocalPlugin, RepoLocalPlugin as default };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,543 @@
+import { tool } from "@opencode-ai/plugin";
+import { spawn } from "node:child_process";
+import { appendFile, mkdir, stat } from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+
+//#region src/lib/errors.ts
+var RepoPluginError = class extends Error {
+	code;
+	details;
+	constructor(code, message, details) {
+		super(message);
+		this.name = "RepoPluginError";
+		this.code = code;
+		this.details = details;
+	}
+};
+function toRepoPluginError(error) {
+	if (error instanceof RepoPluginError) return error;
+	if (error instanceof Error) return new RepoPluginError("INTERNAL_ERROR", error.message);
+	return new RepoPluginError("INTERNAL_ERROR", "Unknown failure while handling repository operation");
+}
+
+//#endregion
+//#region src/lib/git.ts
+const DEFAULT_TIMEOUT_MS = 12e4;
+const WHITESPACE_PATTERN = /\s+/;
+function runGitRaw(args, options = {}) {
+	const cwd = options.cwd;
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	return new Promise((resolve, reject) => {
+		const processRef = spawn("git", args, {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		let stdout = "";
+		let stderr = "";
+		let timeoutId;
+		if (timeoutMs > 0) timeoutId = setTimeout(() => {
+			processRef.kill("SIGTERM");
+		}, timeoutMs);
+		processRef.stdout.on("data", (chunk) => {
+			stdout += chunk.toString();
+		});
+		processRef.stderr.on("data", (chunk) => {
+			stderr += chunk.toString();
+		});
+		processRef.on("error", (error) => {
+			if (timeoutId) clearTimeout(timeoutId);
+			if (error.code === "ENOENT") {
+				reject(new RepoPluginError("GIT_NOT_FOUND", "git binary not found on PATH"));
+				return;
+			}
+			reject(new RepoPluginError("GIT_FAILURE", "Failed to start git command", String(error)));
+		});
+		processRef.on("close", (exitCode) => {
+			if (timeoutId) clearTimeout(timeoutId);
+			resolve({
+				stdout: stdout.trim(),
+				stderr: stderr.trim(),
+				exitCode: exitCode ?? 1
+			});
+		});
+	});
+}
+async function runGit(args, options = {}) {
+	const result = await runGitRaw(args, options);
+	if (result.exitCode !== 0) throw new RepoPluginError("GIT_FAILURE", "git command failed", [`git ${args.join(" ")}`, result.stderr || result.stdout].filter(Boolean).join("\n"));
+	return result.stdout;
+}
+async function ensureGitAvailable() {
+	await runGit(["--version"]);
+}
+async function directoryExists(target) {
+	try {
+		return (await stat(target)).isDirectory();
+	} catch {
+		return false;
+	}
+}
+async function isGitRepository(cwd) {
+	const result = await runGitRaw(["rev-parse", "--is-inside-work-tree"], { cwd });
+	return result.exitCode === 0 && result.stdout === "true";
+}
+async function cloneRepo(repoUrl, targetPath, depth) {
+	await mkdir(path.dirname(targetPath), { recursive: true });
+	const args = [
+		"clone",
+		"--origin",
+		"origin"
+	];
+	if (depth !== void 0) args.push("--depth", String(depth));
+	args.push(repoUrl, targetPath);
+	await runGit(args);
+}
+async function fetchOrigin(cwd) {
+	await runGit([
+		"fetch",
+		"--prune",
+		"origin"
+	], { cwd });
+}
+async function checkoutRef(cwd, ref) {
+	await runGit(["checkout", ref], { cwd });
+}
+async function pullFfOnlyForBranch(cwd, branch) {
+	await runGit([
+		"pull",
+		"--ff-only",
+		"--prune",
+		"origin",
+		branch
+	], { cwd });
+}
+async function hardResetToOriginBranch(cwd, branch) {
+	await runGit([
+		"reset",
+		"--hard",
+		`origin/${branch}`
+	], { cwd });
+	await runGit(["clean", "-fd"], { cwd });
+}
+function getHeadSha(cwd) {
+	return runGit(["rev-parse", "HEAD"], { cwd });
+}
+function getCurrentRef(cwd) {
+	return runGit([
+		"rev-parse",
+		"--abbrev-ref",
+		"HEAD"
+	], { cwd });
+}
+async function getDefaultBranch(cwd) {
+	const result = await runGitRaw([
+		"symbolic-ref",
+		"--short",
+		"refs/remotes/origin/HEAD"
+	], { cwd });
+	if (result.exitCode !== 0 || !result.stdout) return null;
+	return result.stdout.startsWith("origin/") ? result.stdout.slice(7) : result.stdout;
+}
+function getOriginUrl(cwd) {
+	return runGit([
+		"remote",
+		"get-url",
+		"origin"
+	], { cwd });
+}
+async function isWorktreeDirty(cwd) {
+	return (await runGit(["status", "--porcelain"], { cwd })).length > 0;
+}
+async function getUpstreamRef(cwd) {
+	const result = await runGitRaw([
+		"rev-parse",
+		"--abbrev-ref",
+		"--symbolic-full-name",
+		"@{upstream}"
+	], { cwd });
+	if (result.exitCode !== 0 || !result.stdout) return null;
+	return result.stdout;
+}
+async function getRefSha(cwd, ref) {
+	const result = await runGitRaw(["rev-parse", ref], { cwd });
+	if (result.exitCode !== 0 || !result.stdout) return null;
+	return result.stdout;
+}
+async function getAheadBehindCounts(cwd, localRef, remoteRef) {
+	const result = await runGitRaw([
+		"rev-list",
+		"--left-right",
+		"--count",
+		`${localRef}...${remoteRef}`
+	], { cwd });
+	if (result.exitCode !== 0 || !result.stdout) return null;
+	const [leftCountRaw, rightCountRaw] = result.stdout.split(WHITESPACE_PATTERN);
+	const aheadBy = Number.parseInt(leftCountRaw ?? "", 10);
+	const behindBy = Number.parseInt(rightCountRaw ?? "", 10);
+	if (Number.isNaN(aheadBy) || Number.isNaN(behindBy)) return null;
+	return {
+		aheadBy,
+		behindBy
+	};
+}
+
+//#endregion
+//#region src/lib/paths.ts
+const DEFAULT_CLONE_ROOT = "~/.opencode/repos";
+function expandHome(input) {
+	if (input === "~") return os.homedir();
+	if (input.startsWith("~/")) return path.join(os.homedir(), input.slice(2));
+	return input;
+}
+function sanitizeSegment(segment) {
+	const sanitized = segment.replace(/[^A-Za-z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+	if (!sanitized) throw new RepoPluginError("INVALID_URL", `Could not derive a safe path segment from: ${segment}`);
+	return sanitized;
+}
+function ensureWithinRoot(root, target) {
+	const resolvedRoot = path.resolve(root);
+	const resolvedTarget = path.resolve(target);
+	const prefix = resolvedRoot.endsWith(path.sep) ? resolvedRoot : `${resolvedRoot}${path.sep}`;
+	if (resolvedTarget !== resolvedRoot && !resolvedTarget.startsWith(prefix)) throw new RepoPluginError("PATH_VIOLATION", "Resolved repository path escaped clone root");
+}
+async function resolveCloneRoot(override) {
+	const fromEnv = process.env.OPENCODE_REPO_CLONE_ROOT?.trim();
+	const expanded = expandHome(override?.trim() || fromEnv || DEFAULT_CLONE_ROOT);
+	if (override?.trim() && !path.isAbsolute(expanded)) throw new RepoPluginError("INVALID_CLONE_ROOT", "clone_root must be an absolute path");
+	const root = path.resolve(expanded);
+	await mkdir(root, { recursive: true });
+	return root;
+}
+function buildRepoPath(cloneRoot, repo) {
+	const safeSegments = repo.pathSegments.map(sanitizeSegment);
+	const target = path.resolve(cloneRoot, repo.host, ...safeSegments);
+	ensureWithinRoot(cloneRoot, target);
+	return target;
+}
+
+//#endregion
+//#region src/lib/telemetry.ts
+const TELEMETRY_RELATIVE_PATH = ".local/share/opencode/plugins/opencode-repo-local/telemetry.jsonl";
+function defaultTelemetryPath() {
+	return path.join(os.homedir(), TELEMETRY_RELATIVE_PATH);
+}
+function resolveTelemetryPath() {
+	const fromEnv = process.env.OPENCODE_REPO_TELEMETRY_PATH?.trim();
+	if (fromEnv) return path.resolve(fromEnv);
+	return defaultTelemetryPath();
+}
+async function appendEvent(event) {
+	const telemetryPath = resolveTelemetryPath();
+	await mkdir(path.dirname(telemetryPath), { recursive: true });
+	await appendFile(telemetryPath, `${JSON.stringify(event)}\n`, "utf8");
+}
+async function logRepoEnsureSuccess(args, result) {
+	const event = {
+		event: "repo_ensure_local",
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		ok: true,
+		repo_input: args.repo,
+		canonical_repo_url: result.repo_url,
+		local_path: result.local_path,
+		status: result.status,
+		freshness: result.freshness,
+		ahead_by: result.ahead_by,
+		behind_by: result.behind_by,
+		update_mode: args.update_mode ?? "ff-only",
+		ref: args.ref ?? null,
+		error_code: null,
+		error_message: null
+	};
+	try {
+		await appendEvent(event);
+	} catch {}
+}
+async function logRepoEnsureFailure(args, error) {
+	const parsedError = toRepoPluginError(error);
+	const event = {
+		event: "repo_ensure_local",
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		ok: false,
+		repo_input: args.repo,
+		canonical_repo_url: null,
+		local_path: null,
+		status: null,
+		freshness: null,
+		ahead_by: null,
+		behind_by: null,
+		update_mode: args.update_mode ?? "ff-only",
+		ref: args.ref ?? null,
+		error_code: parsedError.code,
+		error_message: parsedError.message
+	};
+	try {
+		await appendEvent(event);
+	} catch {}
+}
+
+//#endregion
+//#region src/lib/url.ts
+const SSH_PATTERN = /^git@([^:/]+):(.+)$/;
+const GIT_SUFFIX_PATTERN = /\.git$/i;
+const HTTP_OR_HTTPS_PATTERN = /^https?:\/\//i;
+const GITHUB_WEB_MARKERS = new Set([
+	"tree",
+	"blob",
+	"commit",
+	"pull",
+	"issues",
+	"actions",
+	"releases",
+	"wiki"
+]);
+function normalizePathSegments(host, segments) {
+	if (host.toLowerCase() !== "github.com") return segments;
+	if (segments.length >= 3 && GITHUB_WEB_MARKERS.has(segments[2])) return segments.slice(0, 2);
+	return segments;
+}
+function splitPathSegments(input) {
+	const trimmed = input.trim().replace(/^\/+|\/+$/g, "");
+	if (!trimmed) return [];
+	const segments = trimmed.split("/").filter(Boolean);
+	if (segments.length === 0) return [];
+	const lastIndex = segments.length - 1;
+	segments[lastIndex] = segments[lastIndex].replace(GIT_SUFFIX_PATTERN, "");
+	return segments;
+}
+function validateSegments(segments) {
+	if (segments.length < 2) throw new RepoPluginError("INVALID_URL", "Repository URL must include owner and repository name");
+	for (const segment of segments) if (!segment || segment === "." || segment === "..") throw new RepoPluginError("INVALID_URL", "Repository URL contains an invalid path segment");
+}
+function makeRepoKey(host, segments) {
+	return `${host.toLowerCase()}/${segments.join("/").toLowerCase()}`;
+}
+function buildParsed(raw, host, segmentsInput, protocol) {
+	const segments = normalizePathSegments(host, Array.isArray(segmentsInput) ? segmentsInput : splitPathSegments(segmentsInput));
+	validateSegments(segments);
+	const normalizedHost = host.toLowerCase();
+	const canonicalPath = segments.join("/");
+	return {
+		raw,
+		host: normalizedHost,
+		pathSegments: segments,
+		canonicalUrl: protocol === "https" ? `https://${normalizedHost}/${canonicalPath}.git` : `git@${normalizedHost}:${canonicalPath}.git`,
+		key: makeRepoKey(normalizedHost, segments)
+	};
+}
+function parseHttpLikeUrl(raw) {
+	const url = new URL(raw);
+	if (url.protocol !== "https:") throw new RepoPluginError("INVALID_URL", "Repository URL must use https:// format");
+	return buildParsed(raw, url.hostname, splitPathSegments(url.pathname), "https");
+}
+function parseHostWithPath(raw) {
+	if (raw.includes("://") || raw.startsWith("git@")) return null;
+	const firstSlash = raw.indexOf("/");
+	if (firstSlash <= 0) return null;
+	const host = raw.slice(0, firstSlash).trim();
+	const pathValue = raw.slice(firstSlash + 1).trim();
+	if (!(host && pathValue)) return null;
+	if (!(host.includes(".") || host.includes(":"))) return null;
+	return buildParsed(raw, host, splitPathSegments(pathValue), "https");
+}
+function parseGitHubShorthand(raw) {
+	if (raw.includes("://") || raw.startsWith("git@")) return null;
+	const segments = splitPathSegments(raw);
+	if (segments.length < 2) return null;
+	return buildParsed(raw, "github.com", segments, "https");
+}
+function invalidUrlErrorMessage(allowSsh) {
+	if (allowSsh) return "Repository must be one of: https://host/owner/repo(.git), git@host:owner/repo.git, host/owner/repo, or owner/repo (GitHub shorthand)";
+	return "Repository must be one of: https://host/owner/repo(.git), host/owner/repo, or owner/repo (GitHub shorthand)";
+}
+function parseRepoUrl(repo, allowSsh) {
+	const raw = repo.trim();
+	if (!raw) throw new RepoPluginError("INVALID_URL", "Repository URL is required");
+	if (HTTP_OR_HTTPS_PATTERN.test(raw)) return parseHttpLikeUrl(raw);
+	const hostWithPathParsed = parseHostWithPath(raw);
+	if (hostWithPathParsed) return hostWithPathParsed;
+	const gitHubShorthandParsed = parseGitHubShorthand(raw);
+	if (gitHubShorthandParsed) return gitHubShorthandParsed;
+	if (allowSsh) {
+		const match = raw.match(SSH_PATTERN);
+		if (match) {
+			const host = match[1];
+			return buildParsed(raw, host, splitPathSegments(match[2] ?? ""), "ssh");
+		}
+		if (raw.startsWith("ssh://")) {
+			const url = new URL(raw);
+			if (url.protocol === "ssh:") return buildParsed(raw, url.hostname, splitPathSegments(url.pathname), "ssh");
+		}
+	}
+	throw new RepoPluginError("INVALID_URL", invalidUrlErrorMessage(allowSsh));
+}
+
+//#endregion
+//#region src/tools/repo-ensure-local.ts
+const UPDATE_MODES = new Set([
+	"ff-only",
+	"fetch-only",
+	"reset-clean"
+]);
+const REPO_TOOL_ARGS = {
+	repo: tool.schema.string().describe("Remote repository reference to prepare locally. Use this FIRST when a user references a GitHub/remote repo outside the current workspace and the agent needs grounded code inspection. Accepted forms include owner/repo, host/owner/repo, and https URLs."),
+	ref: tool.schema.string().optional().describe("Optional branch/tag/sha to checkout after clone/fetch."),
+	clone_root: tool.schema.string().optional().describe("Optional absolute clone root path override. Useful in tests and CI for isolated temporary clone directories."),
+	depth: tool.schema.number().int().positive().optional().describe("Optional shallow clone depth."),
+	update_mode: tool.schema.string().optional().describe("Update policy: ff-only (default), fetch-only, or reset-clean."),
+	allow_ssh: tool.schema.boolean().optional().describe("Allow git@host:owner/repo.git URLs. Defaults to false unless OPENCODE_REPO_ALLOW_SSH=true.")
+};
+const ALLOWED_KEYS = new Set(Object.keys(REPO_TOOL_ARGS));
+function normalizeUpdateMode(value) {
+	const mode = (value ?? "ff-only").trim();
+	if (!UPDATE_MODES.has(mode)) throw new RepoPluginError("INVALID_UPDATE_MODE", `Unsupported update_mode: ${mode}`);
+	return mode;
+}
+function formatFailure(error) {
+	const parsed = toRepoPluginError(error);
+	const detailSuffix = parsed.details ? `\n${parsed.details}` : "";
+	throw new Error(`[${parsed.code}] ${parsed.message}${detailSuffix}`);
+}
+function toResultText(result) {
+	return JSON.stringify(result, null, 2);
+}
+function assertKnownArgs(args) {
+	const extraKeys = Object.keys(args ?? {}).filter((key) => !ALLOWED_KEYS.has(key));
+	if (extraKeys.length > 0) throw new RepoPluginError("INVALID_ARGS", `Unknown arguments: ${extraKeys.join(", ")}`);
+}
+function deriveFreshnessFromCounts(counts) {
+	if (!counts) return "unknown";
+	if (counts.aheadBy === 0 && counts.behindBy === 0) return "current";
+	if (counts.aheadBy > 0 && counts.behindBy === 0) return "ahead";
+	if (counts.aheadBy === 0 && counts.behindBy > 0) return "stale";
+	return "diverged";
+}
+async function resolveComparisonRef(localPath, currentRef) {
+	const upstreamRef = await getUpstreamRef(localPath);
+	if (upstreamRef) return upstreamRef;
+	if (currentRef === "HEAD") return null;
+	const fallback = `origin/${currentRef}`;
+	if (!await getRefSha(localPath, fallback)) return null;
+	return fallback;
+}
+async function computeFreshnessDetails(localPath, currentRef) {
+	const comparisonRef = await resolveComparisonRef(localPath, currentRef);
+	if (!comparisonRef) return {
+		comparisonRef: null,
+		remoteHeadSha: null,
+		aheadBy: null,
+		behindBy: null,
+		freshness: "unknown"
+	};
+	const remoteHeadSha = await getRefSha(localPath, comparisonRef);
+	const counts = await getAheadBehindCounts(localPath, "HEAD", comparisonRef);
+	return {
+		comparisonRef,
+		remoteHeadSha,
+		aheadBy: counts?.aheadBy ?? null,
+		behindBy: counts?.behindBy ?? null,
+		freshness: deriveFreshnessFromCounts(counts)
+	};
+}
+async function checkoutIfRequested(localPath, ref, actions) {
+	if (!ref) return;
+	await checkoutRef(localPath, ref);
+	actions.push(`checked_out_${ref}`);
+}
+async function runFastForward(localPath, actions) {
+	if (await isWorktreeDirty(localPath)) throw new RepoPluginError("DIRTY_WORKTREE", "Cannot fast-forward because working tree has local changes", "Commit/stash changes or use update_mode=fetch-only");
+	const currentRef = await getCurrentRef(localPath);
+	if (currentRef === "HEAD") {
+		actions.push("detached_head_no_pull");
+		return;
+	}
+	await pullFfOnlyForBranch(localPath, currentRef);
+	actions.push(`fast_forwarded_${currentRef}`);
+}
+async function runResetClean(localPath, actions) {
+	const currentRef = await getCurrentRef(localPath);
+	if (currentRef === "HEAD") throw new RepoPluginError("DETACHED_HEAD", "Cannot use reset-clean while repository is in detached HEAD state");
+	await hardResetToOriginBranch(localPath, currentRef);
+	actions.push(`reset_clean_${currentRef}`);
+}
+async function ensureExistingCloneMatchesRemote(localPath, requestedRepo) {
+	if (!await isGitRepository(localPath)) throw new RepoPluginError("NOT_GIT_REPO", `Target path exists but is not a git repository: ${localPath}`);
+	const existingOrigin = parseRepoUrl(await getOriginUrl(localPath), true);
+	if (existingOrigin.key === requestedRepo.key) return;
+	throw new RepoPluginError("REPO_URL_MISMATCH", "Existing clone origin does not match requested repository", `requested=${requestedRepo.canonicalUrl}\nexisting=${existingOrigin.canonicalUrl}`);
+}
+async function cloneMissingRepo(localPath, repoUrl, depth, ref, actions) {
+	await cloneRepo(repoUrl, localPath, depth);
+	actions.push("cloned_repository");
+	await checkoutIfRequested(localPath, ref, actions);
+	return "cloned";
+}
+async function updateExistingRepo(localPath, requestedRepo, mode, ref, actions) {
+	await ensureExistingCloneMatchesRemote(localPath, requestedRepo);
+	const beforeSha = await getHeadSha(localPath);
+	await fetchOrigin(localPath);
+	actions.push("fetched_origin");
+	await checkoutIfRequested(localPath, ref, actions);
+	if (mode === "ff-only") await runFastForward(localPath, actions);
+	if (mode === "reset-clean") await runResetClean(localPath, actions);
+	if (mode === "fetch-only") return "fetched";
+	return beforeSha === await getHeadSha(localPath) ? "already-current" : "updated";
+}
+async function repoEnsureLocal(args) {
+	assertKnownArgs(args);
+	const repoInput = args.repo?.trim();
+	if (!repoInput) throw new RepoPluginError("INVALID_URL", "repo argument cannot be empty");
+	const ref = args.ref?.trim() || void 0;
+	const mode = normalizeUpdateMode(args.update_mode);
+	const parsedRepo = parseRepoUrl(repoInput, args.allow_ssh ?? process.env.OPENCODE_REPO_ALLOW_SSH === "true");
+	await ensureGitAvailable();
+	const localPath = buildRepoPath(await resolveCloneRoot(args.clone_root), parsedRepo);
+	const actions = [];
+	const status = await directoryExists(localPath) ? await updateExistingRepo(localPath, parsedRepo, mode, ref, actions) : await cloneMissingRepo(localPath, parsedRepo.canonicalUrl, args.depth, ref, actions);
+	const currentRef = await getCurrentRef(localPath);
+	const freshness = await computeFreshnessDetails(localPath, currentRef);
+	return {
+		status,
+		repo_url: parsedRepo.canonicalUrl,
+		local_path: localPath,
+		current_ref: currentRef,
+		default_branch: await getDefaultBranch(localPath),
+		head_sha: await getHeadSha(localPath),
+		comparison_ref: freshness.comparisonRef,
+		remote_head_sha: freshness.remoteHeadSha,
+		ahead_by: freshness.aheadBy,
+		behind_by: freshness.behindBy,
+		freshness: freshness.freshness,
+		actions,
+		instructions: [`Use built-in tools with local_path: ${localPath}`, `Example: run Grep/Read/Glob with files under ${localPath}`]
+	};
+}
+const repoEnsureLocalTool = tool({
+	description: "Prepare external repositories for investigation. If a request references a GitHub/remote repo not already in the workspace, call this tool before Read/Grep/Glob/Bash so analysis is grounded in local source code. Returns absolute local_path plus freshness/version metadata (head SHA, remote SHA, ahead/behind).",
+	args: REPO_TOOL_ARGS,
+	async execute(args) {
+		const typedArgs = args;
+		try {
+			const result = await repoEnsureLocal(typedArgs);
+			await logRepoEnsureSuccess(typedArgs, result);
+			return toResultText(result);
+		} catch (error) {
+			await logRepoEnsureFailure(typedArgs, error);
+			formatFailure(error);
+		}
+	}
+});
+
+//#endregion
+//#region src/index.ts
+const RepoLocalPlugin = () => {
+	return Promise.resolve({ tool: { repo_ensure_local: repoEnsureLocalTool } });
+};
+
+//#endregion
+export { RepoLocalPlugin, RepoLocalPlugin as default };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/lib/errors.ts","../src/lib/git.ts","../src/lib/paths.ts","../src/lib/telemetry.ts","../src/lib/url.ts","../src/tools/repo-ensure-local.ts","../src/index.ts"],"sourcesContent":["export class RepoPluginError extends Error {\n  code: string;\n  details?: string;\n\n  constructor(code: string, message: string, details?: string) {\n    super(message);\n    this.name = \"RepoPluginError\";\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport function toRepoPluginError(error: unknown): RepoPluginError {\n  if (error instanceof RepoPluginError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new RepoPluginError(\"INTERNAL_ERROR\", error.message);\n  }\n\n  return new RepoPluginError(\n    \"INTERNAL_ERROR\",\n    \"Unknown failure while handling repository operation\"\n  );\n}\n","import { spawn } from \"node:child_process\";\nimport { mkdir, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport { RepoPluginError } from \"./errors\";\n\ninterface RunGitOptions {\n  cwd?: string;\n  timeoutMs?: number;\n}\n\ninterface RunGitResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\nexport interface AheadBehindCounts {\n  aheadBy: number;\n  behindBy: number;\n}\n\nconst DEFAULT_TIMEOUT_MS = 120_000;\nconst WHITESPACE_PATTERN = /\\s+/;\n\nfunction runGitRaw(\n  args: string[],\n  options: RunGitOptions = {}\n): Promise<RunGitResult> {\n  const cwd = options.cwd;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n  return new Promise((resolve, reject) => {\n    const processRef = spawn(\"git\", args, {\n      cwd,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n    if (timeoutMs > 0) {\n      timeoutId = setTimeout(() => {\n        processRef.kill(\"SIGTERM\");\n      }, timeoutMs);\n    }\n\n    processRef.stdout.on(\"data\", (chunk) => {\n      stdout += chunk.toString();\n    });\n\n    processRef.stderr.on(\"data\", (chunk) => {\n      stderr += chunk.toString();\n    });\n\n    processRef.on(\"error\", (error) => {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        reject(\n          new RepoPluginError(\"GIT_NOT_FOUND\", \"git binary not found on PATH\")\n        );\n        return;\n      }\n\n      reject(\n        new RepoPluginError(\n          \"GIT_FAILURE\",\n          \"Failed to start git command\",\n          String(error)\n        )\n      );\n    });\n\n    processRef.on(\"close\", (exitCode) => {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n\n      resolve({\n        stdout: stdout.trim(),\n        stderr: stderr.trim(),\n        exitCode: exitCode ?? 1,\n      });\n    });\n  });\n}\n\nasync function runGit(\n  args: string[],\n  options: RunGitOptions = {}\n): Promise<string> {\n  const result = await runGitRaw(args, options);\n  if (result.exitCode !== 0) {\n    const details = [`git ${args.join(\" \")}`, result.stderr || result.stdout]\n      .filter(Boolean)\n      .join(\"\\n\");\n    throw new RepoPluginError(\"GIT_FAILURE\", \"git command failed\", details);\n  }\n  return result.stdout;\n}\n\nexport async function ensureGitAvailable(): Promise<void> {\n  await runGit([\"--version\"]);\n}\n\nexport async function directoryExists(target: string): Promise<boolean> {\n  try {\n    const info = await stat(target);\n    return info.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport async function isGitRepository(cwd: string): Promise<boolean> {\n  const result = await runGitRaw([\"rev-parse\", \"--is-inside-work-tree\"], {\n    cwd,\n  });\n  return result.exitCode === 0 && result.stdout === \"true\";\n}\n\nexport async function cloneRepo(\n  repoUrl: string,\n  targetPath: string,\n  depth?: number\n): Promise<void> {\n  await mkdir(path.dirname(targetPath), { recursive: true });\n  const args = [\"clone\", \"--origin\", \"origin\"];\n  if (depth !== undefined) {\n    args.push(\"--depth\", String(depth));\n  }\n  args.push(repoUrl, targetPath);\n  await runGit(args);\n}\n\nexport async function fetchOrigin(cwd: string): Promise<void> {\n  await runGit([\"fetch\", \"--prune\", \"origin\"], { cwd });\n}\n\nexport async function checkoutRef(cwd: string, ref: string): Promise<void> {\n  await runGit([\"checkout\", ref], { cwd });\n}\n\nexport async function pullFfOnlyForBranch(\n  cwd: string,\n  branch: string\n): Promise<void> {\n  await runGit([\"pull\", \"--ff-only\", \"--prune\", \"origin\", branch], { cwd });\n}\n\nexport async function hardResetToOriginBranch(\n  cwd: string,\n  branch: string\n): Promise<void> {\n  await runGit([\"reset\", \"--hard\", `origin/${branch}`], { cwd });\n  await runGit([\"clean\", \"-fd\"], { cwd });\n}\n\nexport function getHeadSha(cwd: string): Promise<string> {\n  return runGit([\"rev-parse\", \"HEAD\"], { cwd });\n}\n\nexport function getCurrentRef(cwd: string): Promise<string> {\n  return runGit([\"rev-parse\", \"--abbrev-ref\", \"HEAD\"], { cwd });\n}\n\nexport async function getDefaultBranch(cwd: string): Promise<string | null> {\n  const result = await runGitRaw(\n    [\"symbolic-ref\", \"--short\", \"refs/remotes/origin/HEAD\"],\n    { cwd }\n  );\n  if (result.exitCode !== 0 || !result.stdout) {\n    return null;\n  }\n\n  const prefix = \"origin/\";\n  return result.stdout.startsWith(prefix)\n    ? result.stdout.slice(prefix.length)\n    : result.stdout;\n}\n\nexport function getOriginUrl(cwd: string): Promise<string> {\n  return runGit([\"remote\", \"get-url\", \"origin\"], { cwd });\n}\n\nexport async function isWorktreeDirty(cwd: string): Promise<boolean> {\n  const output = await runGit([\"status\", \"--porcelain\"], { cwd });\n  return output.length > 0;\n}\n\nexport async function getUpstreamRef(cwd: string): Promise<string | null> {\n  const result = await runGitRaw(\n    [\"rev-parse\", \"--abbrev-ref\", \"--symbolic-full-name\", \"@{upstream}\"],\n    { cwd }\n  );\n  if (result.exitCode !== 0 || !result.stdout) {\n    return null;\n  }\n\n  return result.stdout;\n}\n\nexport async function getRefSha(\n  cwd: string,\n  ref: string\n): Promise<string | null> {\n  const result = await runGitRaw([\"rev-parse\", ref], { cwd });\n  if (result.exitCode !== 0 || !result.stdout) {\n    return null;\n  }\n\n  return result.stdout;\n}\n\nexport async function getAheadBehindCounts(\n  cwd: string,\n  localRef: string,\n  remoteRef: string\n): Promise<AheadBehindCounts | null> {\n  const result = await runGitRaw(\n    [\"rev-list\", \"--left-right\", \"--count\", `${localRef}...${remoteRef}`],\n    { cwd }\n  );\n  if (result.exitCode !== 0 || !result.stdout) {\n    return null;\n  }\n\n  const [leftCountRaw, rightCountRaw] = result.stdout.split(WHITESPACE_PATTERN);\n  const aheadBy = Number.parseInt(leftCountRaw ?? \"\", 10);\n  const behindBy = Number.parseInt(rightCountRaw ?? \"\", 10);\n  if (Number.isNaN(aheadBy) || Number.isNaN(behindBy)) {\n    return null;\n  }\n\n  return {\n    aheadBy,\n    behindBy,\n  };\n}\n","import { mkdir } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { RepoPluginError } from \"./errors\";\nimport type { ParsedRepoUrl } from \"./types\";\n\nconst DEFAULT_CLONE_ROOT = \"~/.opencode/repos\";\n\nfunction expandHome(input: string): string {\n  if (input === \"~\") {\n    return os.homedir();\n  }\n\n  if (input.startsWith(\"~/\")) {\n    return path.join(os.homedir(), input.slice(2));\n  }\n\n  return input;\n}\n\nfunction sanitizeSegment(segment: string): string {\n  const sanitized = segment\n    .replace(/[^A-Za-z0-9._-]/g, \"-\")\n    .replace(/-+/g, \"-\")\n    .replace(/^-|-$/g, \"\");\n  if (!sanitized) {\n    throw new RepoPluginError(\n      \"INVALID_URL\",\n      `Could not derive a safe path segment from: ${segment}`\n    );\n  }\n  return sanitized;\n}\n\nfunction ensureWithinRoot(root: string, target: string): void {\n  const resolvedRoot = path.resolve(root);\n  const resolvedTarget = path.resolve(target);\n  const prefix = resolvedRoot.endsWith(path.sep)\n    ? resolvedRoot\n    : `${resolvedRoot}${path.sep}`;\n\n  if (resolvedTarget !== resolvedRoot && !resolvedTarget.startsWith(prefix)) {\n    throw new RepoPluginError(\n      \"PATH_VIOLATION\",\n      \"Resolved repository path escaped clone root\"\n    );\n  }\n}\n\nexport async function resolveCloneRoot(override?: string): Promise<string> {\n  const fromEnv = process.env.OPENCODE_REPO_CLONE_ROOT?.trim();\n  const selected = override?.trim() || fromEnv || DEFAULT_CLONE_ROOT;\n  const expanded = expandHome(selected);\n\n  if (override?.trim() && !path.isAbsolute(expanded)) {\n    throw new RepoPluginError(\n      \"INVALID_CLONE_ROOT\",\n      \"clone_root must be an absolute path\"\n    );\n  }\n\n  const root = path.resolve(expanded);\n  await mkdir(root, { recursive: true });\n  return root;\n}\n\nexport function buildRepoPath(cloneRoot: string, repo: ParsedRepoUrl): string {\n  const safeSegments = repo.pathSegments.map(sanitizeSegment);\n  const target = path.resolve(cloneRoot, repo.host, ...safeSegments);\n  ensureWithinRoot(cloneRoot, target);\n  return target;\n}\n","import { appendFile, mkdir } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { toRepoPluginError } from \"./errors\";\nimport type { RepoEnsureLocalArgs, RepoEnsureResult } from \"./types\";\n\ninterface RepoEnsureTelemetryEvent {\n  event: \"repo_ensure_local\";\n  timestamp: string;\n  ok: boolean;\n  repo_input: string;\n  canonical_repo_url: string | null;\n  local_path: string | null;\n  status: string | null;\n  freshness: string | null;\n  ahead_by: number | null;\n  behind_by: number | null;\n  update_mode: string | null;\n  ref: string | null;\n  error_code: string | null;\n  error_message: string | null;\n}\n\nconst TELEMETRY_RELATIVE_PATH =\n  \".local/share/opencode/plugins/opencode-repo-local/telemetry.jsonl\";\n\nfunction defaultTelemetryPath(): string {\n  return path.join(os.homedir(), TELEMETRY_RELATIVE_PATH);\n}\n\nfunction resolveTelemetryPath(): string {\n  const fromEnv = process.env.OPENCODE_REPO_TELEMETRY_PATH?.trim();\n  if (fromEnv) {\n    return path.resolve(fromEnv);\n  }\n\n  return defaultTelemetryPath();\n}\n\nasync function appendEvent(event: RepoEnsureTelemetryEvent): Promise<void> {\n  const telemetryPath = resolveTelemetryPath();\n  await mkdir(path.dirname(telemetryPath), { recursive: true });\n  await appendFile(telemetryPath, `${JSON.stringify(event)}\\n`, \"utf8\");\n}\n\nexport async function logRepoEnsureSuccess(\n  args: RepoEnsureLocalArgs,\n  result: RepoEnsureResult\n): Promise<void> {\n  const event: RepoEnsureTelemetryEvent = {\n    event: \"repo_ensure_local\",\n    timestamp: new Date().toISOString(),\n    ok: true,\n    repo_input: args.repo,\n    canonical_repo_url: result.repo_url,\n    local_path: result.local_path,\n    status: result.status,\n    freshness: result.freshness,\n    ahead_by: result.ahead_by,\n    behind_by: result.behind_by,\n    update_mode: args.update_mode ?? \"ff-only\",\n    ref: args.ref ?? null,\n    error_code: null,\n    error_message: null,\n  };\n\n  try {\n    await appendEvent(event);\n  } catch {\n    // Telemetry must never block tool execution.\n  }\n}\n\nexport async function logRepoEnsureFailure(\n  args: RepoEnsureLocalArgs,\n  error: unknown\n): Promise<void> {\n  const parsedError = toRepoPluginError(error);\n  const event: RepoEnsureTelemetryEvent = {\n    event: \"repo_ensure_local\",\n    timestamp: new Date().toISOString(),\n    ok: false,\n    repo_input: args.repo,\n    canonical_repo_url: null,\n    local_path: null,\n    status: null,\n    freshness: null,\n    ahead_by: null,\n    behind_by: null,\n    update_mode: args.update_mode ?? \"ff-only\",\n    ref: args.ref ?? null,\n    error_code: parsedError.code,\n    error_message: parsedError.message,\n  };\n\n  try {\n    await appendEvent(event);\n  } catch {\n    // Telemetry must never block tool execution.\n  }\n}\n","import { RepoPluginError } from \"./errors\";\nimport type { ParsedRepoUrl } from \"./types\";\n\nconst SSH_PATTERN = /^git@([^:/]+):(.+)$/;\nconst GIT_SUFFIX_PATTERN = /\\.git$/i;\nconst HTTP_OR_HTTPS_PATTERN = /^https?:\\/\\//i;\nconst GITHUB_WEB_MARKERS: ReadonlySet<string> = new Set([\n  \"tree\",\n  \"blob\",\n  \"commit\",\n  \"pull\",\n  \"issues\",\n  \"actions\",\n  \"releases\",\n  \"wiki\",\n]);\n\nfunction normalizePathSegments(host: string, segments: string[]): string[] {\n  if (host.toLowerCase() !== \"github.com\") {\n    return segments;\n  }\n\n  if (segments.length >= 3 && GITHUB_WEB_MARKERS.has(segments[2])) {\n    return segments.slice(0, 2);\n  }\n\n  return segments;\n}\n\nfunction splitPathSegments(input: string): string[] {\n  const trimmed = input.trim().replace(/^\\/+|\\/+$/g, \"\");\n  if (!trimmed) {\n    return [];\n  }\n\n  const segments = trimmed.split(\"/\").filter(Boolean);\n  if (segments.length === 0) {\n    return [];\n  }\n\n  const lastIndex = segments.length - 1;\n  segments[lastIndex] = segments[lastIndex].replace(GIT_SUFFIX_PATTERN, \"\");\n  return segments;\n}\n\nfunction validateSegments(segments: string[]): void {\n  if (segments.length < 2) {\n    throw new RepoPluginError(\n      \"INVALID_URL\",\n      \"Repository URL must include owner and repository name\"\n    );\n  }\n\n  for (const segment of segments) {\n    if (!segment || segment === \".\" || segment === \"..\") {\n      throw new RepoPluginError(\n        \"INVALID_URL\",\n        \"Repository URL contains an invalid path segment\"\n      );\n    }\n  }\n}\n\nfunction makeRepoKey(host: string, segments: string[]): string {\n  return `${host.toLowerCase()}/${segments.join(\"/\").toLowerCase()}`;\n}\n\nfunction buildParsed(\n  raw: string,\n  host: string,\n  segmentsInput: string[] | string,\n  protocol: \"https\" | \"ssh\"\n): ParsedRepoUrl {\n  const splitSegments = Array.isArray(segmentsInput)\n    ? segmentsInput\n    : splitPathSegments(segmentsInput);\n  const segments = normalizePathSegments(host, splitSegments);\n  validateSegments(segments);\n\n  const normalizedHost = host.toLowerCase();\n  const canonicalPath = segments.join(\"/\");\n  const canonicalUrl =\n    protocol === \"https\"\n      ? `https://${normalizedHost}/${canonicalPath}.git`\n      : `git@${normalizedHost}:${canonicalPath}.git`;\n\n  return {\n    raw,\n    host: normalizedHost,\n    pathSegments: segments,\n    canonicalUrl,\n    key: makeRepoKey(normalizedHost, segments),\n  };\n}\n\nfunction parseHttpLikeUrl(raw: string): ParsedRepoUrl {\n  const url = new URL(raw);\n  if (url.protocol !== \"https:\") {\n    throw new RepoPluginError(\n      \"INVALID_URL\",\n      \"Repository URL must use https:// format\"\n    );\n  }\n\n  return buildParsed(\n    raw,\n    url.hostname,\n    splitPathSegments(url.pathname),\n    \"https\"\n  );\n}\n\nfunction parseHostWithPath(raw: string): ParsedRepoUrl | null {\n  if (raw.includes(\"://\") || raw.startsWith(\"git@\")) {\n    return null;\n  }\n\n  const firstSlash = raw.indexOf(\"/\");\n  if (firstSlash <= 0) {\n    return null;\n  }\n\n  const host = raw.slice(0, firstSlash).trim();\n  const pathValue = raw.slice(firstSlash + 1).trim();\n  if (!(host && pathValue)) {\n    return null;\n  }\n\n  if (!(host.includes(\".\") || host.includes(\":\"))) {\n    return null;\n  }\n\n  return buildParsed(raw, host, splitPathSegments(pathValue), \"https\");\n}\n\nfunction parseGitHubShorthand(raw: string): ParsedRepoUrl | null {\n  if (raw.includes(\"://\") || raw.startsWith(\"git@\")) {\n    return null;\n  }\n\n  const segments = splitPathSegments(raw);\n  if (segments.length < 2) {\n    return null;\n  }\n\n  return buildParsed(raw, \"github.com\", segments, \"https\");\n}\n\nfunction invalidUrlErrorMessage(allowSsh: boolean): string {\n  if (allowSsh) {\n    return \"Repository must be one of: https://host/owner/repo(.git), git@host:owner/repo.git, host/owner/repo, or owner/repo (GitHub shorthand)\";\n  }\n\n  return \"Repository must be one of: https://host/owner/repo(.git), host/owner/repo, or owner/repo (GitHub shorthand)\";\n}\n\nexport function parseRepoUrl(repo: string, allowSsh: boolean): ParsedRepoUrl {\n  const raw = repo.trim();\n  if (!raw) {\n    throw new RepoPluginError(\"INVALID_URL\", \"Repository URL is required\");\n  }\n\n  if (HTTP_OR_HTTPS_PATTERN.test(raw)) {\n    return parseHttpLikeUrl(raw);\n  }\n\n  const hostWithPathParsed = parseHostWithPath(raw);\n  if (hostWithPathParsed) {\n    return hostWithPathParsed;\n  }\n\n  const gitHubShorthandParsed = parseGitHubShorthand(raw);\n  if (gitHubShorthandParsed) {\n    return gitHubShorthandParsed;\n  }\n\n  if (allowSsh) {\n    const match = raw.match(SSH_PATTERN);\n    if (match) {\n      const host = match[1];\n      const path = match[2] ?? \"\";\n      return buildParsed(raw, host, splitPathSegments(path), \"ssh\");\n    }\n\n    if (raw.startsWith(\"ssh://\")) {\n      const url = new URL(raw);\n      if (url.protocol === \"ssh:\") {\n        return buildParsed(\n          raw,\n          url.hostname,\n          splitPathSegments(url.pathname),\n          \"ssh\"\n        );\n      }\n    }\n  }\n\n  throw new RepoPluginError(\"INVALID_URL\", invalidUrlErrorMessage(allowSsh));\n}\n","import { tool } from \"@opencode-ai/plugin\";\n\nimport { RepoPluginError, toRepoPluginError } from \"../lib/errors\";\nimport {\n  type AheadBehindCounts,\n  checkoutRef,\n  cloneRepo,\n  directoryExists,\n  ensureGitAvailable,\n  fetchOrigin,\n  getAheadBehindCounts,\n  getCurrentRef,\n  getDefaultBranch,\n  getHeadSha,\n  getOriginUrl,\n  getRefSha,\n  getUpstreamRef,\n  hardResetToOriginBranch,\n  isGitRepository,\n  isWorktreeDirty,\n  pullFfOnlyForBranch,\n} from \"../lib/git\";\nimport { buildRepoPath, resolveCloneRoot } from \"../lib/paths\";\nimport { logRepoEnsureFailure, logRepoEnsureSuccess } from \"../lib/telemetry\";\nimport type {\n  RepoEnsureLocalArgs,\n  RepoEnsureResult,\n  RepoEnsureStatus,\n  RepoFreshnessStatus,\n  UpdateMode,\n} from \"../lib/types\";\nimport { parseRepoUrl } from \"../lib/url\";\n\nconst UPDATE_MODES: ReadonlySet<string> = new Set([\n  \"ff-only\",\n  \"fetch-only\",\n  \"reset-clean\",\n]);\n\nconst REPO_TOOL_ARGS = {\n  repo: tool.schema\n    .string()\n    .describe(\n      \"Remote repository reference to prepare locally. Use this FIRST when a user references a GitHub/remote repo outside the current workspace and the agent needs grounded code inspection. Accepted forms include owner/repo, host/owner/repo, and https URLs.\"\n    ),\n  ref: tool.schema\n    .string()\n    .optional()\n    .describe(\"Optional branch/tag/sha to checkout after clone/fetch.\"),\n  clone_root: tool.schema\n    .string()\n    .optional()\n    .describe(\n      \"Optional absolute clone root path override. Useful in tests and CI for isolated temporary clone directories.\"\n    ),\n  depth: tool.schema\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\"Optional shallow clone depth.\"),\n  update_mode: tool.schema\n    .string()\n    .optional()\n    .describe(\"Update policy: ff-only (default), fetch-only, or reset-clean.\"),\n  allow_ssh: tool.schema\n    .boolean()\n    .optional()\n    .describe(\n      \"Allow git@host:owner/repo.git URLs. Defaults to false unless OPENCODE_REPO_ALLOW_SSH=true.\"\n    ),\n} as const;\n\nconst ALLOWED_KEYS = new Set(Object.keys(REPO_TOOL_ARGS));\n\ninterface RepoFreshnessDetails {\n  comparisonRef: string | null;\n  remoteHeadSha: string | null;\n  aheadBy: number | null;\n  behindBy: number | null;\n  freshness: RepoFreshnessStatus;\n}\n\nfunction normalizeUpdateMode(value: string | undefined): UpdateMode {\n  const mode = (value ?? \"ff-only\").trim();\n  if (!UPDATE_MODES.has(mode)) {\n    throw new RepoPluginError(\n      \"INVALID_UPDATE_MODE\",\n      `Unsupported update_mode: ${mode}`\n    );\n  }\n  return mode as UpdateMode;\n}\n\nfunction formatFailure(error: unknown): never {\n  const parsed = toRepoPluginError(error);\n  const detailSuffix = parsed.details ? `\\n${parsed.details}` : \"\";\n  throw new Error(`[${parsed.code}] ${parsed.message}${detailSuffix}`);\n}\n\nfunction toResultText(result: RepoEnsureResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\nfunction assertKnownArgs(args: RepoEnsureLocalArgs): void {\n  const extraKeys = Object.keys(args ?? {}).filter(\n    (key) => !ALLOWED_KEYS.has(key)\n  );\n  if (extraKeys.length > 0) {\n    throw new RepoPluginError(\n      \"INVALID_ARGS\",\n      `Unknown arguments: ${extraKeys.join(\", \")}`\n    );\n  }\n}\n\nfunction deriveFreshnessFromCounts(\n  counts: AheadBehindCounts | null\n): RepoFreshnessStatus {\n  if (!counts) {\n    return \"unknown\";\n  }\n\n  if (counts.aheadBy === 0 && counts.behindBy === 0) {\n    return \"current\";\n  }\n\n  if (counts.aheadBy > 0 && counts.behindBy === 0) {\n    return \"ahead\";\n  }\n\n  if (counts.aheadBy === 0 && counts.behindBy > 0) {\n    return \"stale\";\n  }\n\n  return \"diverged\";\n}\n\nasync function resolveComparisonRef(\n  localPath: string,\n  currentRef: string\n): Promise<string | null> {\n  const upstreamRef = await getUpstreamRef(localPath);\n  if (upstreamRef) {\n    return upstreamRef;\n  }\n\n  if (currentRef === \"HEAD\") {\n    return null;\n  }\n\n  const fallback = `origin/${currentRef}`;\n  const fallbackSha = await getRefSha(localPath, fallback);\n  if (!fallbackSha) {\n    return null;\n  }\n\n  return fallback;\n}\n\nasync function computeFreshnessDetails(\n  localPath: string,\n  currentRef: string\n): Promise<RepoFreshnessDetails> {\n  const comparisonRef = await resolveComparisonRef(localPath, currentRef);\n  if (!comparisonRef) {\n    return {\n      comparisonRef: null,\n      remoteHeadSha: null,\n      aheadBy: null,\n      behindBy: null,\n      freshness: \"unknown\",\n    };\n  }\n\n  const remoteHeadSha = await getRefSha(localPath, comparisonRef);\n  const counts = await getAheadBehindCounts(localPath, \"HEAD\", comparisonRef);\n  return {\n    comparisonRef,\n    remoteHeadSha,\n    aheadBy: counts?.aheadBy ?? null,\n    behindBy: counts?.behindBy ?? null,\n    freshness: deriveFreshnessFromCounts(counts),\n  };\n}\n\nasync function checkoutIfRequested(\n  localPath: string,\n  ref: string | undefined,\n  actions: string[]\n): Promise<void> {\n  if (!ref) {\n    return;\n  }\n\n  await checkoutRef(localPath, ref);\n  actions.push(`checked_out_${ref}`);\n}\n\nasync function runFastForward(\n  localPath: string,\n  actions: string[]\n): Promise<void> {\n  if (await isWorktreeDirty(localPath)) {\n    throw new RepoPluginError(\n      \"DIRTY_WORKTREE\",\n      \"Cannot fast-forward because working tree has local changes\",\n      \"Commit/stash changes or use update_mode=fetch-only\"\n    );\n  }\n\n  const currentRef = await getCurrentRef(localPath);\n  if (currentRef === \"HEAD\") {\n    actions.push(\"detached_head_no_pull\");\n    return;\n  }\n\n  await pullFfOnlyForBranch(localPath, currentRef);\n  actions.push(`fast_forwarded_${currentRef}`);\n}\n\nasync function runResetClean(\n  localPath: string,\n  actions: string[]\n): Promise<void> {\n  const currentRef = await getCurrentRef(localPath);\n  if (currentRef === \"HEAD\") {\n    throw new RepoPluginError(\n      \"DETACHED_HEAD\",\n      \"Cannot use reset-clean while repository is in detached HEAD state\"\n    );\n  }\n\n  await hardResetToOriginBranch(localPath, currentRef);\n  actions.push(`reset_clean_${currentRef}`);\n}\n\nasync function ensureExistingCloneMatchesRemote(\n  localPath: string,\n  requestedRepo: ReturnType<typeof parseRepoUrl>\n): Promise<void> {\n  if (!(await isGitRepository(localPath))) {\n    throw new RepoPluginError(\n      \"NOT_GIT_REPO\",\n      `Target path exists but is not a git repository: ${localPath}`\n    );\n  }\n\n  const originUrl = await getOriginUrl(localPath);\n  const existingOrigin = parseRepoUrl(originUrl, true);\n  if (existingOrigin.key === requestedRepo.key) {\n    return;\n  }\n\n  throw new RepoPluginError(\n    \"REPO_URL_MISMATCH\",\n    \"Existing clone origin does not match requested repository\",\n    `requested=${requestedRepo.canonicalUrl}\\nexisting=${existingOrigin.canonicalUrl}`\n  );\n}\n\nasync function cloneMissingRepo(\n  localPath: string,\n  repoUrl: string,\n  depth: number | undefined,\n  ref: string | undefined,\n  actions: string[]\n): Promise<RepoEnsureStatus> {\n  await cloneRepo(repoUrl, localPath, depth);\n  actions.push(\"cloned_repository\");\n  await checkoutIfRequested(localPath, ref, actions);\n  return \"cloned\";\n}\n\nasync function updateExistingRepo(\n  localPath: string,\n  requestedRepo: ReturnType<typeof parseRepoUrl>,\n  mode: UpdateMode,\n  ref: string | undefined,\n  actions: string[]\n): Promise<RepoEnsureStatus> {\n  await ensureExistingCloneMatchesRemote(localPath, requestedRepo);\n\n  const beforeSha = await getHeadSha(localPath);\n  await fetchOrigin(localPath);\n  actions.push(\"fetched_origin\");\n\n  await checkoutIfRequested(localPath, ref, actions);\n\n  if (mode === \"ff-only\") {\n    await runFastForward(localPath, actions);\n  }\n\n  if (mode === \"reset-clean\") {\n    await runResetClean(localPath, actions);\n  }\n\n  if (mode === \"fetch-only\") {\n    return \"fetched\";\n  }\n\n  const afterSha = await getHeadSha(localPath);\n  return beforeSha === afterSha ? \"already-current\" : \"updated\";\n}\n\nexport async function repoEnsureLocal(\n  args: RepoEnsureLocalArgs\n): Promise<RepoEnsureResult> {\n  assertKnownArgs(args);\n\n  const repoInput = args.repo?.trim();\n  if (!repoInput) {\n    throw new RepoPluginError(\"INVALID_URL\", \"repo argument cannot be empty\");\n  }\n\n  const ref = args.ref?.trim() || undefined;\n  const mode = normalizeUpdateMode(args.update_mode);\n  const allowSsh =\n    args.allow_ssh ?? process.env.OPENCODE_REPO_ALLOW_SSH === \"true\";\n  const parsedRepo = parseRepoUrl(repoInput, allowSsh);\n\n  await ensureGitAvailable();\n\n  const cloneRoot = await resolveCloneRoot(args.clone_root);\n  const localPath = buildRepoPath(cloneRoot, parsedRepo);\n  const actions: string[] = [];\n\n  const status = (await directoryExists(localPath))\n    ? await updateExistingRepo(localPath, parsedRepo, mode, ref, actions)\n    : await cloneMissingRepo(\n        localPath,\n        parsedRepo.canonicalUrl,\n        args.depth,\n        ref,\n        actions\n      );\n\n  const currentRef = await getCurrentRef(localPath);\n  const freshness = await computeFreshnessDetails(localPath, currentRef);\n\n  return {\n    status,\n    repo_url: parsedRepo.canonicalUrl,\n    local_path: localPath,\n    current_ref: currentRef,\n    default_branch: await getDefaultBranch(localPath),\n    head_sha: await getHeadSha(localPath),\n    comparison_ref: freshness.comparisonRef,\n    remote_head_sha: freshness.remoteHeadSha,\n    ahead_by: freshness.aheadBy,\n    behind_by: freshness.behindBy,\n    freshness: freshness.freshness,\n    actions,\n    instructions: [\n      `Use built-in tools with local_path: ${localPath}`,\n      `Example: run Grep/Read/Glob with files under ${localPath}`,\n    ],\n  };\n}\n\nexport const repoEnsureLocalTool = tool({\n  description:\n    \"Prepare external repositories for investigation. If a request references a GitHub/remote repo not already in the workspace, call this tool before Read/Grep/Glob/Bash so analysis is grounded in local source code. Returns absolute local_path plus freshness/version metadata (head SHA, remote SHA, ahead/behind).\",\n  args: REPO_TOOL_ARGS,\n  async execute(args) {\n    const typedArgs = args as RepoEnsureLocalArgs;\n    try {\n      const result = await repoEnsureLocal(typedArgs);\n      await logRepoEnsureSuccess(typedArgs, result);\n      return toResultText(result);\n    } catch (error) {\n      await logRepoEnsureFailure(typedArgs, error);\n      formatFailure(error);\n    }\n  },\n});\n","import type { Plugin } from \"@opencode-ai/plugin\";\n\nimport { repoEnsureLocalTool } from \"./tools/repo-ensure-local\";\n\nexport const RepoLocalPlugin: Plugin = () => {\n  return Promise.resolve({\n    tool: {\n      repo_ensure_local: repoEnsureLocalTool,\n    },\n  });\n};\n\nexport default RepoLocalPlugin;\n"],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "@opencode-ai/plugin";
+
+export declare const RepoLocalPlugin: Plugin;
+
+export default RepoLocalPlugin;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "opencode-repo-local",
+  "version": "0.1.0",
+  "description": "OpenCode plugin to clone or update repositories locally for built-in tooling",
+  "packageManager": "bun@1.2.22",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "bunx tsdown --watch",
+    "build": "bunx tsdown --fail-on-warn",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:integration": "bun run scripts/integration-test.ts",
+    "test:e2e": "bun run scripts/e2e-opencode-run.ts",
+    "lint": "ultracite check --error-on-warnings",
+    "check": "concurrently --kill-others-on-fail --success all --names core,integration \"bun run scripts/check-no-ignores.ts && bun run lint && bun run typecheck && bun run test && bun run build\" \"bun run test:integration\"",
+    "release:verify": "bun run check && npm pack --dry-run",
+    "release:patch": "npm version patch -m \"chore(release): v%s\"",
+    "release:minor": "npm version minor -m \"chore(release): v%s\"",
+    "release:major": "npm version major -m \"chore(release): v%s\"",
+    "release:beta:first": "npm version prepatch --preid beta -m \"chore(release): v%s\"",
+    "release:beta:next": "npm version prerelease --preid beta -m \"chore(release): v%s\"",
+    "prepare": "husky",
+    "prepack": "bun run build",
+    "fix": "ultracite fix --unsafe && bun run scripts/check-no-ignores.ts"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "git",
+    "clone"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.150"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.13",
+    "@types/bun": "latest",
+    "concurrently": "^9.2.1",
+    "husky": "^9.1.7",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.9.3",
+    "ultracite": "7.1.4"
+  }
+}