@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/executors/frg-freshness.d.ts

@@ -0,0 +1,93 @@
+import { type FrgSearchMatch } from "@aria-cli/fastripgrep";
+export type FrgMutationOperation = "write" | "delete";
+export interface FrgMutationRecord {
+    repoRoot: string;
+    path: string;
+    operation: FrgMutationOperation;
+    sequence: number;
+    recordedAt: number;
+    content?: string;
+}
+export interface FrgSessionDeltaSearchOptions {
+    pattern: string;
+    context?: number;
+    caseInsensitive?: boolean;
+    smartCase?: boolean;
+    literal?: boolean;
+    glob?: string;
+    fileType?: string;
+    filesOnly?: boolean;
+    count?: boolean;
+    quiet?: boolean;
+    maxCount?: number;
+}
+export interface FrgSessionDeltaSearchResult {
+    mode: "matches" | "files" | "counts" | "quiet";
+    matches?: FrgSearchMatch[];
+    files?: string[];
+    counts?: Array<{
+        file: string;
+        count: number;
+    }>;
+    matched?: boolean;
+}
+export interface FrgGitDirtyStatus {
+    headCommit?: string;
+    headTree?: string;
+    tracked: Array<{
+        path: string;
+        operation: FrgMutationOperation;
+    }>;
+    untracked: string[];
+}
+export interface FrgFlushStatus {
+    inFlight: boolean;
+    scheduled: boolean;
+    lastScheduledAt?: number;
+    lastFlushAt?: number;
+    lastError?: string;
+    retryCount: number;
+    retryDelayMs?: number;
+}
+export interface FrgFreshnessSnapshot {
+    headCommit?: string;
+    headTree?: string;
+    dirtyTrackedCount: number;
+    dirtyUntrackedCount: number;
+    sessionPendingCount: number;
+    sessionPendingBytes: number;
+    flush: FrgFlushStatus;
+    freshnessState: "missing" | "fresh" | "session-dirty" | "overlay-dirty" | "head-mismatch" | "syncing" | "sync-scheduled" | "stale";
+}
+export declare const DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS = 750;
+export declare const BACKGROUND_FRG_MAX_FLUSH_DELAY_MS = 30000;
+export declare const MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH = 32;
+export declare const MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH: number;
+export declare const MAX_CACHED_MUTATION_CONTENT_BYTES: number;
+export declare function getTrackedRepoRootForPath(filePath: string): string | null;
+export declare function ensureFrgRepoStateLoaded(repoRoot: string): void;
+export declare function recordFrgMutation(filePath: string, operation: FrgMutationOperation, content?: string): void;
+export declare function getPendingFrgMutations(repoRoot: string): FrgMutationRecord[];
+export declare function getPendingFrgMutationBytes(repoRoot: string): number;
+export declare function clearPendingFrgMutations(repoRoot: string): void;
+export declare function flushPendingFrgMutations(repoRoot: string): {
+    flushed: false;
+    reason: string;
+    pendingCount: number;
+} | {
+    flushed: true;
+    pendingCount: number;
+    result: unknown;
+};
+export declare function maybeBuildFrgIndexForRepo(repoRoot: string): void;
+export declare function scheduleBackgroundFrgFlush(repoRoot: string, delayMs?: number): void;
+export declare function shouldForceSynchronousFrgFlush(repoRoot: string): boolean;
+export declare function getFrgFlushStatus(repoRoot: string): FrgFlushStatus;
+export declare function getGitDirtyStatus(repoRoot: string): FrgGitDirtyStatus;
+export declare function reconcileGitDirtyMutations(repoRoot: string): FrgGitDirtyStatus;
+export declare function getFrgFreshnessSnapshot(repoRoot: string, indexed?: {
+    commit_hash?: string | null;
+    tree_hash?: string | null;
+    age_seconds?: number;
+}): FrgFreshnessSnapshot;
+export declare function searchPendingFrgMutations(repoRoot: string, options: FrgSessionDeltaSearchOptions): Promise<FrgSessionDeltaSearchResult | null>;