import path from "path" import { Context, Effect, Layer, Schema } from "effect" import { FSUtil } from "./fs-util" import { Git } from "./git" import { Global } from "./global" import { Repository } from "./repository" import { AbsolutePath } from "./schema" import { makeGlobalNode } from "./effect/app-node" import { EffectFlock } from "./util/effect-flock" export type Result = { readonly repository: string readonly host: string readonly remote: string readonly localPath: string readonly status: "cached" | "cloned" | "refreshed" readonly head?: string readonly branch?: string } export type EnsureInput = { readonly reference: Repository.RemoteReference readonly refresh?: boolean readonly branch?: string } export class InvalidRepositoryError extends Schema.TaggedErrorClass()( "RepositoryCacheInvalidRepositoryError", { repository: Schema.String, message: Schema.String, }, ) {} export class InvalidBranchError extends Schema.TaggedErrorClass()( "RepositoryCacheInvalidBranchError", { branch: Schema.String, message: Schema.String, }, ) {} export class CloneFailedError extends Schema.TaggedErrorClass()("RepositoryCacheCloneFailedError", { repository: Schema.String, message: Schema.String, }) {} export class FetchFailedError extends Schema.TaggedErrorClass()("RepositoryCacheFetchFailedError", { repository: Schema.String, message: Schema.String, }) {} export class CheckoutFailedError extends Schema.TaggedErrorClass()( "RepositoryCacheCheckoutFailedError", { repository: Schema.String, branch: Schema.String, message: Schema.String, }, ) {} export class ResetFailedError extends Schema.TaggedErrorClass()("RepositoryCacheResetFailedError", { repository: Schema.String, message: Schema.String, }) {} export class LockFailedError extends Schema.TaggedErrorClass()("RepositoryCacheLockFailedError", { localPath: Schema.String, message: Schema.String, }) {} export class CacheOperationError extends Schema.TaggedErrorClass()( "RepositoryCacheOperationError", { operation: Schema.String, path: Schema.String, message: Schema.String, }, ) {} export type Error = | InvalidRepositoryError | InvalidBranchError | CloneFailedError | FetchFailedError | CheckoutFailedError | ResetFailedError | LockFailedError | CacheOperationError export interface Interface { readonly ensure: (input: EnsureInput) => Effect.Effect } export class Service extends Context.Service()("@opencode/RepositoryCache") {} export function isError(error: unknown): error is Error { return ( error instanceof InvalidRepositoryError || error instanceof InvalidBranchError || error instanceof CloneFailedError || error instanceof FetchFailedError || error instanceof CheckoutFailedError || error instanceof ResetFailedError || error instanceof LockFailedError || error instanceof CacheOperationError ) } export const parseRemote = Effect.fn("RepositoryCache.parseRemote")(function* (repository: string) { return yield* Effect.try({ try: () => Repository.parseRemote(repository), catch: (error) => new InvalidRepositoryError({ repository, message: errorMessage(error) }), }) }) export const validateBranch = Effect.fn("RepositoryCache.validateBranch")(function* (branch: string) { return yield* Effect.try({ try: () => Repository.validateBranch(branch), catch: (error) => new InvalidBranchError({ branch, message: errorMessage(error) }), }) }) const layer: Layer.Layer = Layer.effect( Service, Effect.gen(function* () { const fs = yield* FSUtil.Service const git = yield* Git.Service const flock = yield* EffectFlock.Service const global = yield* Global.Service return Service.of({ ensure: Effect.fn("RepositoryCache.ensure")(function* (input) { if (input.branch) yield* validateBranch(input.branch) const repository = input.reference.label const localPath = Repository.cachePath(global.repos, input.reference) const cloneTarget = Repository.parse(input.reference.remote) ?? input.reference return yield* flock .withLock( Effect.gen(function* () { yield* cacheOperation(fs.ensureDir(path.dirname(localPath)), "ensure cache directory", localPath) const exists = yield* fs.existsSafe(localPath) const existing = yield* git.repo.discover(AbsolutePath.make(localPath)) const origin = existing ? yield* git.remote.get(existing) : undefined const originReference = origin ? Repository.parse(origin) : undefined const reuse = Boolean(existing && originReference && Repository.same(originReference, cloneTarget)) if (exists && !reuse) { yield* cacheOperation(fs.remove(localPath, { recursive: true }), "remove stale cache", localPath) } const currentBranch = reuse && existing ? yield* git.history.branch(existing) : undefined const status = statusForRepository({ reuse, refresh: input.refresh, branchMatches: input.branch ? currentBranch === input.branch : undefined, }) if (status === "cloned") { yield* git.repo .clone({ remote: input.reference.remote, directory: AbsolutePath.make(localPath), branch: input.branch, }) .pipe(Effect.mapError((error) => new CloneFailedError({ repository, message: error.message }))) } if (status === "refreshed") { if (!existing) return yield* new FetchFailedError({ repository, message: "Repository is unavailable" }) yield* git.sync .fetchRemotes(existing) .pipe(Effect.mapError((error) => new FetchFailedError({ repository, message: error.message }))) if (input.branch) { const requestedBranch = input.branch yield* git.sync .fetchBranch(existing, { branch: requestedBranch }) .pipe(Effect.mapError((error) => new FetchFailedError({ repository, message: error.message }))) yield* git.sync.checkoutRemoteBranch(existing, { branch: requestedBranch }).pipe( Effect.mapError( (error) => new CheckoutFailedError({ repository, branch: requestedBranch, message: error.message, }), ), ) } yield* git.sync .resetHard(existing, yield* resetTarget(git, existing, input.branch)) .pipe(Effect.mapError((error) => new ResetFailedError({ repository, message: error.message }))) } const checkout = yield* git.repo.discover(AbsolutePath.make(localPath)) return { repository, host: input.reference.host, remote: input.reference.remote, localPath, status, head: checkout ? yield* git.history.head(checkout) : undefined, branch: checkout ? yield* git.history.branch(checkout) : undefined, } satisfies Result }), `repository-cache:${localPath}`, ) .pipe( Effect.mapError((error) => isError(error) ? error : new LockFailedError({ localPath, message: errorMessage(error) }), ), ) }), }) }), ) export const node = makeGlobalNode({ service: Service, layer, deps: [EffectFlock.node, FSUtil.node, Git.node, Global.node], }) function statusForRepository(input: { reuse: boolean; refresh?: boolean; branchMatches?: boolean }) { if (!input.reuse) return "cloned" as const if (input.branchMatches === false || input.refresh) return "refreshed" as const return "cached" as const } function errorMessage(error: unknown) { return error instanceof globalThis.Error ? error.message : String(error) } function cacheOperation(effect: Effect.Effect, operation: string, target: string) { return effect.pipe( Effect.mapError((error) => new CacheOperationError({ operation, path: target, message: errorMessage(error) })), ) } const resetTarget = Effect.fnUntraced(function* ( git: Git.Interface, repository: Git.Repository, requestedBranch?: string, ) { if (requestedBranch) return `origin/${requestedBranch}` const remoteHead = yield* git.history.defaultRemoteBranch(repository) if (remoteHead) return `origin/${remoteHead}` const currentBranch = yield* git.history.branch(repository) if (currentBranch) return `origin/${currentBranch}` return "HEAD" }) export * as RepositoryCache from "./repository-cache"