import type { GitCommandError, ServerSettings, ServerSettingsError, ServerSettingsPatch, VcsError, VcsListRemotesResult, VcsProcessExitFailureKind, VcsSwitchRefInput, VcsSwitchRefResult, } from "@t3tools/contracts"; import * as Context from "effect/Context"; import type * as Effect from "effect/Effect"; import type * as ChildProcessSpawner from "effect/process/ChildProcessSpawner"; export interface SourceControlProcessInput { readonly operation: string; readonly command: string; readonly args: ReadonlyArray; readonly cwd: string; readonly spawnCwd?: string; readonly stdin?: string; readonly onStdoutChunk?: (chunk: Uint8Array) => void; readonly env?: NodeJS.ProcessEnv; readonly allowNonZeroExit?: boolean; readonly timeoutMs?: number; readonly maxOutputBytes?: number; readonly outputMode?: "error" | "truncate" | undefined; readonly appendTruncationMarker?: boolean; /** * Reads a failure the generic rules cannot, such as a host CLI's sign-in hint, from its stderr. * Null leaves it to them. */ readonly classifyFailure?: (stderr: string) => VcsProcessExitFailureKind | null; /** The error's detail when the command reports something it was asked for as missing. */ readonly notFoundDetail?: string; /** * Runs sharing a key run at most `limit` at a time, for a host that throttles bursts of its CLI. * The first run of a key fixes its limit. */ readonly concurrency?: { readonly key: string; readonly limit: number }; } export interface SourceControlProcessOutput { readonly exitCode: ChildProcessSpawner.ExitCode; readonly stdout: string; readonly stderr: string; readonly stdoutTruncated: boolean; readonly stderrTruncated: boolean; readonly stdoutInvalidUtf8?: boolean; readonly stderrInvalidUtf8?: boolean; } export type SourceControlGitOutput = Omit< SourceControlProcessOutput, "stdoutInvalidUtf8" | "stderrInvalidUtf8" >; export interface SourceControlGitRemoteBranch { readonly cwd: string; readonly remoteName: string; readonly remoteBranch: string; } export class SourceControlHost extends Context.Service< SourceControlHost, { readonly settings: { /** Read fresh on each call to pick up credential changes. */ readonly get: Effect.Effect; /** * Like `get`, with each secret provider reference in one host kind's credentials replaced * by the secret it names. An unreadable reference stays in place; read the field with * `requireSettingsSecretLiteral` so it fails rather than passing for an unset credential. * Only a reader of that kind should call it: resolving can wait on a secret provider. */ readonly getWithSecrets: (kind: string) => Effect.Effect; /** For credentials the host obtains itself, such as a sign-in it refreshes. */ readonly update: ( patch: ServerSettingsPatch, ) => Effect.Effect; }; readonly process: { readonly run: ( input: SourceControlProcessInput, ) => Effect.Effect; }; readonly git: { readonly execute: (input: { readonly operation: string; readonly cwd: string; readonly args: ReadonlyArray; readonly maxOutputBytes?: number; readonly appendTruncationMarker?: boolean; }) => Effect.Effect; readonly resolveCommit: (input: { readonly cwd: string; readonly revision: string; }) => Effect.Effect<{ readonly commitSha: string }, GitCommandError>; /** The outer effect resolves the repository; the inner effect lists its remotes. */ readonly remotes: ( cwd: string, ) => Effect.Effect, VcsError>; readonly readConfigValue: ( cwd: string, key: string, ) => Effect.Effect; readonly resolvePrimaryRemoteName: (cwd: string) => Effect.Effect; readonly ensureRemote: (input: { readonly cwd: string; readonly preferredName: string; readonly url: string; }) => Effect.Effect; readonly listLocalBranchNames: (cwd: string) => Effect.Effect; readonly fetchRemoteBranch: ( input: SourceControlGitRemoteBranch & { readonly localBranch: string }, ) => Effect.Effect; readonly fetchRemoteTrackingBranch: ( input: SourceControlGitRemoteBranch, ) => Effect.Effect; readonly setBranchUpstream: ( input: SourceControlGitRemoteBranch & { readonly branch: string }, ) => Effect.Effect; /** * Writes to .git/config, which every worktree shares, go through these rather than * `execute`: the host serializes them per repository. */ readonly createBranch: (input: { readonly cwd: string; readonly branch: string; readonly startPoint: string; }) => Effect.Effect; readonly writeConfigValue: (input: { readonly cwd: string; readonly key: string; readonly value: string; }) => Effect.Effect; readonly switchRef: ( input: VcsSwitchRefInput, ) => Effect.Effect; }; } >()("@t3tools/source-control-core/server/SourceControlHost") {}