/** * Built-in `git.commit` and `git.tag` verifiers over a local repository. * * - Object lookups go through `git cat-file --batch-check` on stdin, so a * target is never parsed as a command-line option and "missing" is a * complete, successful answer rather than an error exit. * - `absent` needs a complete repository: a shallow or partial clone gives * `unknown` / `paging-incomplete` for a missing commit. * - Signature checks reuse `git verify-commit` / `git verify-tag` (as * `tools/ci/verify-signed-tag.sh` does). A required signature that is not * good is never `present`: it is `unknown` / `evidence-conflict`, or * `unknown` / `container-unreadable` when it cannot be checked (no key). * * @see docs/contracts/effect-ledger.v1.md "Built-in verifiers" */ import { type EffectVerifier } from './types.js'; export interface VerifierGitResult { stdout: string; stderr: string; exitCode: number; } /** Runs `git -C `. Rejects when git cannot be started. */ export type VerifierGitRunner = (args: string[], options?: { stdin?: string; signal?: AbortSignal; }) => Promise; export interface GitVerifierOptions { repoDir: string; /** Defaults to `git` on PATH. */ gitBinary?: string; /** Test seam; defaults to spawning `gitBinary`. */ runner?: VerifierGitRunner; } /** `good` passes a signature requirement; every other status is never `present` when one is required. */ export type GitSignatureStatus = 'good' | 'unsigned' | 'bad' | 'unverifiable' | 'expired' | 'revoked' | 'unchecked'; export declare const GIT_VERIFIER_VERSION = "1.0.0"; /** `git.commit`: target `git:` (full 40 or 64 hex). */ export declare function gitCommitVerifier(options: GitVerifierOptions): EffectVerifier; /** `git.tag`: target `git-tag:`; the expected peeled object comes from `expected.object` or `context.object`. */ export declare function gitTagVerifier(options: GitVerifierOptions): EffectVerifier; //# sourceMappingURL=git.d.ts.map