@spexcode/spec-core 0.6.2 → 0.6.4

package/dist/git.d.ts

@@ -0,0 +1,166 @@
+export declare const BOARD_GIT_CONCURRENCY = 4;
+export declare function gitBinary(env?: NodeJS.ProcessEnv): string;
+export declare function gitAbortError(): Error;
+export declare function withGitAbortSignal<T>(signal: AbortSignal, run: () => Promise<T>): Promise<T>;
+export declare function currentGitBuildAbortSignal(): AbortSignal | undefined;
+export declare function git(args: string[]): string;
+export type GitObjectFormat = 'sha1' | 'sha256';
+export declare function gitObjectFormat(root: string): GitObjectFormat;
+export declare function isGitObjectId(root: string, value: string): boolean;
+export declare function batchRevisionOids(root: string, revisions: string[], options?: {
+    replaceObjects?: boolean;
+}): Promise<(string | null)[]>;
+export declare function batchBlobTexts(root: string, oids: string[]): Promise<Map<string, string>>;
+export declare function treeTextFiles(root: string, tip: string, pathspec?: string): Map<string, string>;
+export declare function treeFilePaths(root: string, tip: string): Set<string>;
+export declare function treeFileText(root: string, tip: string, path: string): string | null;
+export declare function gitA(args: string[], input?: string): Promise<string>;
+export type ImmutableHunkRanges = {
+    after: DiffLineRange[];
+    before: DiffLineRange[][];
+};
+type EventLedgerDiagnostics = {
+    reads: number;
+    locks: number;
+    replaces: number;
+};
+export declare function gitObjectInterpretation(root: string): {
+    identity: string;
+    objectFormat: GitObjectFormat;
+    replacements: ReadonlyMap<string, string>;
+};
+export declare function gitInterpretationIdentity(root: string): string;
+export declare function withEventLedgerBuild<T>(root: string, run: () => Promise<T>): Promise<T>;
+export declare function withEventLedgerDemand<T>(root: string, run: () => Promise<T>): Promise<T>;
+export declare function eventLedgerDiagnosticsForTests(): EventLedgerDiagnostics;
+export declare function resetEventLedgerDiagnosticsForTests(): void;
+export declare function readImmutableHunkFacts(root: string, keys: Iterable<string>): Map<string, ImmutableHunkRanges>;
+export declare function persistImmutableHunkFacts(root: string, facts: ReadonlyMap<string, ImmutableHunkRanges>): Promise<void>;
+export type GitTryFailure = 'exit' | 'spawn' | 'timeout';
+export declare function gitTry(args: string[], options?: {
+    indexFile?: string;
+    extraEnv?: Record<string, string | undefined>;
+    input?: string;
+}): Promise<{
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    failure?: GitTryFailure;
+}>;
+export declare function gitRequiredA(args: string[], purpose: string, options?: {
+    input?: string;
+    extraEnv?: Record<string, string | undefined>;
+}): Promise<string>;
+export declare function repoRoot(): string;
+export declare function headSha(root: string): string;
+export declare function worktreeSpecSig(wtPath: string): string;
+export type Version = {
+    hash: string;
+    date: string;
+    reason: string;
+    session: string | null;
+};
+export type DiffStat = {
+    additions: number;
+    deletions: number;
+    files: number;
+};
+export type HistoryIndex = {
+    versions: Map<string, Version[]>;
+    contentVersions: Set<string>;
+    versionPaths: Map<string, string>;
+    mergeVersions?: Set<string>;
+};
+export declare function historyIndex(root: string, tip?: string): Promise<HistoryIndex>;
+export declare function rowsFor(idx: HistoryIndex, relPath: string): Version[];
+export declare function pathsStats(root: string, paths: string[]): Promise<Map<string, DiffStat>>;
+export declare function historyStats(root: string, idx: HistoryIndex, relPath: string): Promise<Map<string, DiffStat>>;
+export declare function fileDiffAt(root: string, relPath: string, hash: string): Promise<string>;
+export type DriftIndex = {
+    tip?: string;
+    ord: Map<string, number>;
+    parents: Map<string, string[]>;
+    fileEvents: Map<string, DriftPathEvent[]>;
+    lineageEvents: Map<string, DriftPathEvent[]>;
+    lineageKeys: (path: string, revision: string) => string[];
+    resolutionEvents?: Map<string, DriftPathEvent[]>;
+    acks: Map<string, Set<string>>;
+    selfAcks?: Map<string, Set<string>>;
+    specNodes: Map<string, Set<string>>;
+    anc: Map<string, Uint8Array>;
+};
+export type DriftPathEvent = {
+    commit: string;
+    historicalPath: string;
+    parents: {
+        commit: string;
+        historicalPath: string;
+    }[];
+};
+export type Reachability = {
+    ord: Map<string, number>;
+    parents: Map<string, string[]>;
+    anc: Map<string, Uint8Array>;
+};
+export type DiffLineRange = [number, number];
+export type CombinedDiffOwnedChanges = {
+    after: DiffLineRange[];
+    before: DiffLineRange[][];
+    parentPaths: string[];
+};
+export declare function combinedDiffOwnedChanges(patch: string): Map<string, CombinedDiffOwnedChanges>;
+export declare function driftIndex(root: string, tip?: string): Promise<DriftIndex>;
+export declare function sourceIndexesFull(root: string, tip?: string): Promise<[HistoryIndex, DriftIndex]>;
+export declare function sourceIndexes(root: string, tip?: string): Promise<[HistoryIndex, DriftIndex]>;
+export declare function historyCacheStats(): {
+    historyHeads: number;
+    driftHeads: number;
+    historyRoots: number;
+    driftRoots: number;
+};
+export declare function resetHistoryCachesForTests(): void;
+export declare function historyEventCachePathForTests(root: string): string;
+export declare function ancestorsOf(idx: Reachability, sha: string): Uint8Array | undefined;
+export declare function primeAncestorClosures(idx: Reachability, shas: Iterable<string>): void;
+export declare function inAncestors(idx: Reachability, bits: Uint8Array, sha: string): boolean;
+export declare function unionTopology(root: string, revisions: readonly string[]): Promise<Reachability>;
+export declare function commitReachable(idx: DriftIndex, sha: string): boolean;
+export declare function ackCoverFor(idx: DriftIndex, sinceHash: string, nodeId?: string): Uint8Array[];
+export declare function selfAckCovers(idx: DriftIndex, sinceHash: string, hash: string, nodeId?: string): boolean;
+export declare function pathEvents(idx: DriftIndex, path: string): DriftPathEvent[];
+export declare function pathRangeEvents(idx: DriftIndex, sinceHash: string, path: string, identityRevision?: string): DriftPathEvent[] | null;
+export declare function eventsSince(idx: DriftIndex, sinceHash: string, path: string): DriftPathEvent[] | null;
+export declare function driftPathWindow(idx: DriftIndex, sinceHash: string, path: string, nodeId?: string): DriftPathEvent[] | null;
+export declare function driftFor(idx: DriftIndex, sinceHash: string, path: string, nodeId?: string): number;
+export declare function stagedFiles(root: string): string[];
+export type NodeOp = {
+    nodeId: string;
+    op: 'added' | 'edited' | 'deleted' | 'moved';
+    path: string;
+    fromPath?: string;
+    toPath?: string;
+    committed: boolean;
+    dirty: boolean;
+};
+export type ReviewDiffFile = {
+    path: string;
+    oldPath?: string;
+    status: string;
+    additions: number;
+    deletions: number;
+};
+export declare function mergeBaseDiff(wtPath: string, mainRef?: string, headRef?: string): Promise<ReviewDiffFile[]>;
+export declare function mergeConflicts(wtPath: string, mainRef?: string, headRef?: string): Promise<boolean>;
+type WorktreeSpecDemand = {
+    path: string;
+    head: string;
+};
+export type WorktreeSpecDeltaOutcome = {
+    base: string;
+    ops: NodeOp[];
+} | {
+    error: unknown;
+};
+export declare function worktreeSpecDeltas(root: string, mainSha: string, demands: WorktreeSpecDemand[], interpretation?: string): Promise<Map<string, WorktreeSpecDeltaOutcome>>;
+export declare function worktreeSpecDelta(wtPath: string, mainRef: string, baseHint?: string): Promise<NodeOp[]>;
+export {};