@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/executors/frg-freshness.js

@@ -0,0 +1,627 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CACHED_MUTATION_CONTENT_BYTES = exports.MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH = exports.MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH = exports.BACKGROUND_FRG_MAX_FLUSH_DELAY_MS = exports.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS = void 0;
+exports.getTrackedRepoRootForPath = getTrackedRepoRootForPath;
+exports.ensureFrgRepoStateLoaded = ensureFrgRepoStateLoaded;
+exports.recordFrgMutation = recordFrgMutation;
+exports.getPendingFrgMutations = getPendingFrgMutations;
+exports.getPendingFrgMutationBytes = getPendingFrgMutationBytes;
+exports.clearPendingFrgMutations = clearPendingFrgMutations;
+exports.flushPendingFrgMutations = flushPendingFrgMutations;
+exports.maybeBuildFrgIndexForRepo = maybeBuildFrgIndexForRepo;
+exports.scheduleBackgroundFrgFlush = scheduleBackgroundFrgFlush;
+exports.shouldForceSynchronousFrgFlush = shouldForceSynchronousFrgFlush;
+exports.getFrgFlushStatus = getFrgFlushStatus;
+exports.getGitDirtyStatus = getGitDirtyStatus;
+exports.reconcileGitDirtyMutations = reconcileGitDirtyMutations;
+exports.getFrgFreshnessSnapshot = getFrgFreshnessSnapshot;
+exports.searchPendingFrgMutations = searchPendingFrgMutations;
+const fsSync = __importStar(require("node:fs"));
+const fs = __importStar(require("node:fs/promises"));
+const nodePath = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const fastripgrep_1 = require("@aria-cli/fastripgrep");
+const repoStates = new Map();
+const flushStates = new Map();
+exports.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS = 750;
+exports.BACKGROUND_FRG_MAX_FLUSH_DELAY_MS = 30_000;
+exports.MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH = 32;
+exports.MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH = 512 * 1024;
+exports.MAX_CACHED_MUTATION_CONTENT_BYTES = 256 * 1024;
+function normalizePath(p) {
+    return nodePath.resolve(p);
+}
+function walDir(repoRoot) {
+    return nodePath.join(normalizePath(repoRoot), ".frg", "session");
+}
+function walPath(repoRoot) {
+    return nodePath.join(walDir(repoRoot), "aria-pending.jsonl");
+}
+function ensureSessionStorageDir(repoRoot) {
+    fsSync.mkdirSync(walDir(repoRoot), { recursive: true });
+}
+function normalizeStoredContent(content) {
+    if (typeof content !== "string") {
+        return undefined;
+    }
+    return Buffer.byteLength(content, "utf8") <= exports.MAX_CACHED_MUTATION_CONTENT_BYTES
+        ? content
+        : undefined;
+}
+function getRepoState(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const existing = repoStates.get(normalizedRepoRoot);
+    if (existing) {
+        ensureRepoStateLoaded(normalizedRepoRoot, existing);
+        return existing;
+    }
+    const created = { loaded: false, sequence: 0, pending: new Map() };
+    repoStates.set(normalizedRepoRoot, created);
+    ensureRepoStateLoaded(normalizedRepoRoot, created);
+    return created;
+}
+function getFlushState(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const existing = flushStates.get(normalizedRepoRoot);
+    if (existing)
+        return existing;
+    const created = { timer: null, inFlight: false, retryCount: 0 };
+    flushStates.set(normalizedRepoRoot, created);
+    return created;
+}
+function ensureRepoStateLoaded(repoRoot, state) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const currentState = state ?? repoStates.get(normalizedRepoRoot);
+    if (!currentState || currentState.loaded) {
+        return;
+    }
+    const pendingWalPath = walPath(normalizedRepoRoot);
+    if (fsSync.existsSync(pendingWalPath)) {
+        try {
+            const lines = fsSync.readFileSync(pendingWalPath, "utf8").split(/\r?\n/).filter(Boolean);
+            for (const line of lines) {
+                const parsed = JSON.parse(line);
+                const normalizedPath = normalizePath(parsed.path);
+                currentState.pending.set(normalizedPath, {
+                    ...parsed,
+                    repoRoot: normalizedRepoRoot,
+                    path: normalizedPath,
+                    content: normalizeStoredContent(parsed.content),
+                });
+                currentState.sequence = Math.max(currentState.sequence, parsed.sequence ?? 0);
+            }
+        }
+        catch {
+            // Ignore malformed WAL and proceed with empty/in-memory state.
+        }
+    }
+    currentState.loaded = true;
+}
+function rewriteWal(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const state = repoStates.get(normalizedRepoRoot);
+    if (!state || state.pending.size === 0) {
+        try {
+            fsSync.rmSync(walPath(normalizedRepoRoot), { force: true });
+        }
+        catch {
+            // ignore
+        }
+        return;
+    }
+    ensureSessionStorageDir(normalizedRepoRoot);
+    const records = [...state.pending.values()].sort((a, b) => a.sequence - b.sequence);
+    const content = records.map((record) => JSON.stringify(record)).join("\n") + "\n";
+    fsSync.writeFileSync(walPath(normalizedRepoRoot), content, "utf8");
+}
+function appendWalRecord(repoRoot, record) {
+    ensureSessionStorageDir(repoRoot);
+    fsSync.appendFileSync(walPath(repoRoot), `${JSON.stringify(record)}\n`, "utf8");
+}
+function findGitRepoRoot(startPath) {
+    let current = normalizePath(startPath);
+    try {
+        const stat = fsSync.statSync(current);
+        if (!stat.isDirectory()) {
+            current = nodePath.dirname(current);
+        }
+    }
+    catch {
+        current = nodePath.dirname(current);
+    }
+    while (true) {
+        if (fsSync.existsSync(nodePath.join(current, ".git"))) {
+            return current;
+        }
+        const parent = nodePath.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+function escapeRegex(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function compilePattern(options) {
+    let pattern = options.literal ? escapeRegex(options.pattern) : options.pattern;
+    const smartCaseInsensitive = options.smartCase && !/[A-Z]/.test(options.pattern);
+    const flags = `${options.caseInsensitive || smartCaseInsensitive ? "i" : ""}g`;
+    return new RegExp(pattern, flags);
+}
+function globToRegExp(glob) {
+    const escaped = glob
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, "::DOUBLE_STAR::")
+        .replace(/\*/g, "[^/]*")
+        .replace(/::DOUBLE_STAR::/g, ".*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${escaped}$`);
+}
+function pathMatchesFilters(relativePath, options) {
+    if (options.fileType) {
+        const ext = options.fileType.startsWith(".") ? options.fileType : `.${options.fileType}`;
+        if (!relativePath.endsWith(ext)) {
+            return false;
+        }
+    }
+    if (options.glob) {
+        const re = globToRegExp(options.glob);
+        if (!re.test(relativePath)) {
+            return false;
+        }
+    }
+    return true;
+}
+function buildContextLines(lines, lineIndex, radius) {
+    const before = [];
+    const after = [];
+    for (let i = Math.max(0, lineIndex - radius); i < lineIndex; i++) {
+        before.push({ line: i + 1, content: lines[i] ?? "" });
+    }
+    for (let i = lineIndex + 1; i <= Math.min(lines.length - 1, lineIndex + radius); i++) {
+        after.push({ line: i + 1, content: lines[i] ?? "" });
+    }
+    return { before, after };
+}
+function relativeToRepo(repoRoot, filePath) {
+    return nodePath.relative(repoRoot, filePath).split(nodePath.sep).join("/");
+}
+function isBinaryBuffer(content) {
+    const checkLength = Math.min(content.length, 8192);
+    for (let i = 0; i < checkLength; i++) {
+        if (content[i] === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+function setMutationRecordForRepo(repoRoot, filePath, operation, content, options) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const state = getRepoState(normalizedRepoRoot);
+    state.sequence += 1;
+    const normalizedPath = normalizePath(filePath);
+    const record = {
+        repoRoot: normalizedRepoRoot,
+        path: normalizedPath,
+        operation,
+        sequence: state.sequence,
+        recordedAt: Date.now(),
+        content: normalizeStoredContent(content),
+    };
+    state.pending.set(normalizedPath, record);
+    if (options?.persistWal !== false) {
+        appendWalRecord(normalizedRepoRoot, record);
+    }
+    if (options?.scheduleFlush !== false) {
+        scheduleBackgroundFrgFlush(normalizedRepoRoot);
+    }
+}
+function runGit(repoRoot, args) {
+    try {
+        return (0, node_child_process_1.execFileSync)("git", args, {
+            cwd: normalizePath(repoRoot),
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function getTrackedRepoRootForPath(filePath) {
+    return findGitRepoRoot(filePath);
+}
+function ensureFrgRepoStateLoaded(repoRoot) {
+    void getRepoState(repoRoot);
+}
+function recordFrgMutation(filePath, operation, content) {
+    const repoRoot = getTrackedRepoRootForPath(filePath);
+    if (!repoRoot)
+        return;
+    setMutationRecordForRepo(repoRoot, filePath, operation, content);
+}
+function getPendingFrgMutations(repoRoot) {
+    const state = getRepoState(repoRoot);
+    return [...state.pending.values()].sort((a, b) => a.sequence - b.sequence);
+}
+function getPendingFrgMutationBytes(repoRoot) {
+    return getPendingFrgMutations(repoRoot).reduce((total, record) => {
+        if (typeof record.content === "string") {
+            return total + Buffer.byteLength(record.content, "utf8");
+        }
+        try {
+            return total + fsSync.statSync(record.path).size;
+        }
+        catch {
+            return total;
+        }
+    }, 0);
+}
+function clearPendingFrgMutations(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    repoStates.delete(normalizedRepoRoot);
+    try {
+        fsSync.rmSync(walPath(normalizedRepoRoot), { force: true });
+    }
+    catch {
+        // ignore
+    }
+    const flushState = flushStates.get(normalizedRepoRoot);
+    if (flushState?.timer) {
+        clearTimeout(flushState.timer);
+    }
+    flushStates.delete(normalizedRepoRoot);
+}
+function flushPendingFrgMutations(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const state = getRepoState(normalizedRepoRoot);
+    const flushState = getFlushState(normalizedRepoRoot);
+    const pendingCount = state.pending.size;
+    if (pendingCount === 0) {
+        return { flushed: false, reason: "no-pending-mutations", pendingCount };
+    }
+    if (flushState.timer) {
+        clearTimeout(flushState.timer);
+        flushState.timer = null;
+    }
+    if (flushState.inFlight) {
+        return { flushed: false, reason: "flush-in-flight", pendingCount };
+    }
+    flushState.inFlight = true;
+    try {
+        maybeBuildFrgIndexForRepo(normalizedRepoRoot);
+        // Targeted update: pass only changed/deleted files instead of full directory walk.
+        // O(changed_files) instead of O(all_files).
+        const pending = [...state.pending.values()];
+        const targetChanged = pending.filter((r) => r.operation === "write").map((r) => r.path);
+        const targetDeleted = pending.filter((r) => r.operation === "delete").map((r) => r.path);
+        const result = targetChanged.length > 0 || targetDeleted.length > 0
+            ? (0, fastripgrep_1.frg)({ command: "update", path: normalizedRepoRoot, targetChanged, targetDeleted })
+            : (0, fastripgrep_1.frg)({ command: "update", path: normalizedRepoRoot });
+        state.pending.clear();
+        rewriteWal(normalizedRepoRoot);
+        flushState.lastFlushAt = Date.now();
+        flushState.lastError = undefined;
+        flushState.retryCount = 0;
+        flushState.retryDelayMs = undefined;
+        return { flushed: true, pendingCount, result };
+    }
+    catch (error) {
+        flushState.lastError = error instanceof Error ? error.message : String(error);
+        flushState.retryCount += 1;
+        flushState.retryDelayMs = Math.min((flushState.retryDelayMs ?? exports.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS) * 2, exports.BACKGROUND_FRG_MAX_FLUSH_DELAY_MS);
+        return { flushed: false, reason: "flush-failed", pendingCount };
+    }
+    finally {
+        flushState.inFlight = false;
+    }
+}
+function maybeBuildFrgIndexForRepo(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const frgDir = nodePath.join(normalizedRepoRoot, ".frg");
+    if (fsSync.existsSync(frgDir))
+        return;
+    try {
+        (0, fastripgrep_1.frg)({ command: "init", path: normalizedRepoRoot });
+    }
+    catch {
+        // best effort; search may still fall back to noIndex if init fails
+    }
+}
+function scheduleBackgroundFrgFlush(repoRoot, delayMs = exports.DEFAULT_BACKGROUND_FRG_FLUSH_DELAY_MS) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const state = getRepoState(normalizedRepoRoot);
+    if (state.pending.size === 0) {
+        return;
+    }
+    const flushState = getFlushState(normalizedRepoRoot);
+    flushState.lastScheduledAt = Date.now();
+    if (flushState.inFlight) {
+        return;
+    }
+    if (flushState.timer) {
+        clearTimeout(flushState.timer);
+    }
+    const effectiveDelay = flushState.retryDelayMs ?? delayMs;
+    flushState.timer = setTimeout(() => {
+        flushState.timer = null;
+        const result = flushPendingFrgMutations(normalizedRepoRoot);
+        if (!result.flushed && result.reason === "flush-failed" && result.pendingCount > 0) {
+            scheduleBackgroundFrgFlush(normalizedRepoRoot, flushState.retryDelayMs ?? delayMs);
+        }
+    }, effectiveDelay);
+    if (typeof flushState.timer.unref === "function") {
+        flushState.timer.unref();
+    }
+}
+function shouldForceSynchronousFrgFlush(repoRoot) {
+    const pendingCount = getPendingFrgMutations(repoRoot).length;
+    const pendingBytes = getPendingFrgMutationBytes(repoRoot);
+    return (pendingCount >= exports.MAX_PENDING_MUTATIONS_BEFORE_SYNC_FLUSH ||
+        pendingBytes >= exports.MAX_PENDING_MUTATION_BYTES_BEFORE_SYNC_FLUSH);
+}
+function getFrgFlushStatus(repoRoot) {
+    const flushState = getFlushState(repoRoot);
+    return {
+        inFlight: flushState.inFlight,
+        scheduled: Boolean(flushState.timer),
+        lastScheduledAt: flushState.lastScheduledAt,
+        lastFlushAt: flushState.lastFlushAt,
+        lastError: flushState.lastError,
+        retryCount: flushState.retryCount,
+        retryDelayMs: flushState.retryDelayMs,
+    };
+}
+function getGitDirtyStatus(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const headCommit = runGit(normalizedRepoRoot, ["rev-parse", "HEAD"]) ?? undefined;
+    const headTree = runGit(normalizedRepoRoot, ["rev-parse", "HEAD^{tree}"]) ?? undefined;
+    const tracked = [];
+    const trackedOutput = runGit(normalizedRepoRoot, ["diff", "--name-status", "-z", "HEAD", "--"]);
+    if (trackedOutput) {
+        const tokens = trackedOutput.split("\0").filter(Boolean);
+        for (let i = 0; i < tokens.length; i++) {
+            const status = tokens[i] ?? "";
+            if (status.startsWith("R")) {
+                const oldPath = tokens[++i];
+                const newPath = tokens[++i];
+                if (oldPath)
+                    tracked.push({
+                        path: normalizePath(nodePath.join(normalizedRepoRoot, oldPath)),
+                        operation: "delete",
+                    });
+                if (newPath)
+                    tracked.push({
+                        path: normalizePath(nodePath.join(normalizedRepoRoot, newPath)),
+                        operation: "write",
+                    });
+                continue;
+            }
+            const filePath = tokens[++i];
+            if (!filePath)
+                continue;
+            tracked.push({
+                path: normalizePath(nodePath.join(normalizedRepoRoot, filePath)),
+                operation: status.startsWith("D") ? "delete" : "write",
+            });
+        }
+    }
+    const untracked = [];
+    const untrackedOutput = runGit(normalizedRepoRoot, [
+        "ls-files",
+        "-o",
+        "--exclude-standard",
+        "-z",
+    ]);
+    if (untrackedOutput) {
+        for (const token of untrackedOutput.split("\0").filter(Boolean)) {
+            untracked.push(normalizePath(nodePath.join(normalizedRepoRoot, token)));
+        }
+    }
+    return { headCommit, headTree, tracked, untracked };
+}
+function reconcileGitDirtyMutations(repoRoot) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const status = getGitDirtyStatus(normalizedRepoRoot);
+    const state = getRepoState(normalizedRepoRoot);
+    let changed = false;
+    for (const entry of status.tracked) {
+        const existing = state.pending.get(entry.path);
+        if (!existing || existing.operation !== entry.operation) {
+            setMutationRecordForRepo(normalizedRepoRoot, entry.path, entry.operation, undefined, {
+                persistWal: false,
+                scheduleFlush: false,
+            });
+            changed = true;
+        }
+    }
+    for (const filePath of status.untracked) {
+        const existing = state.pending.get(filePath);
+        if (!existing || existing.operation !== "write") {
+            setMutationRecordForRepo(normalizedRepoRoot, filePath, "write", undefined, {
+                persistWal: false,
+                scheduleFlush: false,
+            });
+            changed = true;
+        }
+    }
+    if (changed) {
+        rewriteWal(normalizedRepoRoot);
+        scheduleBackgroundFrgFlush(normalizedRepoRoot);
+    }
+    return status;
+}
+function getFrgFreshnessSnapshot(repoRoot, indexed) {
+    const normalizedRepoRoot = normalizePath(repoRoot);
+    const gitStatus = getGitDirtyStatus(normalizedRepoRoot);
+    const flush = getFrgFlushStatus(normalizedRepoRoot);
+    const sessionPendingCount = getPendingFrgMutations(normalizedRepoRoot).length;
+    const sessionPendingBytes = getPendingFrgMutationBytes(normalizedRepoRoot);
+    let freshnessState = "fresh";
+    if (!indexed) {
+        freshnessState = "missing";
+    }
+    else if (flush.inFlight) {
+        freshnessState = "syncing";
+    }
+    else if (flush.scheduled) {
+        freshnessState = "sync-scheduled";
+    }
+    else if ((indexed.tree_hash ?? null) &&
+        gitStatus.headTree &&
+        indexed.tree_hash !== gitStatus.headTree) {
+        freshnessState = "head-mismatch";
+    }
+    else if (sessionPendingCount > 0) {
+        freshnessState = "session-dirty";
+    }
+    else if (gitStatus.tracked.length > 0 || gitStatus.untracked.length > 0) {
+        freshnessState = "overlay-dirty";
+    }
+    else if ((indexed.age_seconds ?? 0) > 86400) {
+        freshnessState = "stale";
+    }
+    return {
+        headCommit: gitStatus.headCommit,
+        headTree: gitStatus.headTree,
+        dirtyTrackedCount: gitStatus.tracked.length,
+        dirtyUntrackedCount: gitStatus.untracked.length,
+        sessionPendingCount,
+        sessionPendingBytes,
+        flush,
+        freshnessState,
+    };
+}
+async function searchPendingFrgMutations(repoRoot, options) {
+    const pending = getPendingFrgMutations(repoRoot);
+    if (pending.length === 0) {
+        return null;
+    }
+    const regex = compilePattern(options);
+    const fileSet = new Set();
+    const counts = new Map();
+    const matches = [];
+    let matched = false;
+    for (const record of pending) {
+        if (record.operation === "delete") {
+            continue;
+        }
+        const relativePath = relativeToRepo(repoRoot, record.path);
+        if (!pathMatchesFilters(relativePath, options)) {
+            continue;
+        }
+        let content;
+        if (typeof record.content === "string") {
+            content = record.content;
+        }
+        else {
+            let raw;
+            try {
+                raw = await fs.readFile(record.path);
+            }
+            catch {
+                continue;
+            }
+            if (isBinaryBuffer(raw)) {
+                continue;
+            }
+            content = raw.toString("utf8");
+        }
+        const lines = content.split(/\r?\n/);
+        let fileMatchCount = 0;
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex] ?? "";
+            regex.lastIndex = 0;
+            let lineMatched = false;
+            let execMatch;
+            while ((execMatch = regex.exec(line)) !== null) {
+                matched = true;
+                lineMatched = true;
+                fileMatchCount += 1;
+                if (!options.filesOnly && !options.count && !options.quiet) {
+                    const context = buildContextLines(lines, lineIndex, options.context ?? 0);
+                    matches.push({
+                        file: relativePath,
+                        line: lineIndex + 1,
+                        content: line,
+                        match_start: execMatch.index,
+                        match_end: execMatch.index + execMatch[0].length,
+                        context_before: context.before,
+                        context_after: context.after,
+                    });
+                }
+                if ((options.maxCount ?? Number.POSITIVE_INFINITY) <= fileMatchCount) {
+                    break;
+                }
+                if (execMatch[0].length === 0) {
+                    regex.lastIndex += 1;
+                }
+            }
+            if (options.filesOnly && lineMatched) {
+                fileSet.add(relativePath);
+                break;
+            }
+            if ((options.maxCount ?? Number.POSITIVE_INFINITY) <= fileMatchCount) {
+                break;
+            }
+        }
+        if (options.count && fileMatchCount > 0) {
+            counts.set(relativePath, fileMatchCount);
+        }
+        if (options.filesOnly && fileMatchCount > 0) {
+            fileSet.add(relativePath);
+        }
+        if (options.quiet && fileMatchCount > 0) {
+            return { mode: "quiet", matched: true };
+        }
+    }
+    if (options.quiet) {
+        return { mode: "quiet", matched };
+    }
+    if (options.filesOnly) {
+        return { mode: "files", files: [...fileSet].sort() };
+    }
+    if (options.count) {
+        return {
+            mode: "counts",
+            counts: [...counts.entries()]
+                .sort((a, b) => a[0].localeCompare(b[0]))
+                .map(([file, count]) => ({ file, count })),
+        };
+    }
+    return { mode: "matches", matches };
+}

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

@@ -0,0 +1,27 @@
+import type { ToolContext, ToolResult } from "../types.js";
+export interface FrgInput {
+    command: "index" | "search" | "update" | "status" | "replace" | "init" | "watch" | "man" | "completions" | "upgrade";
+    pattern?: string;
+    replacement?: string;
+    path?: string;
+    noIndex?: boolean;
+    literal?: boolean;
+    caseInsensitive?: boolean;
+    smartCase?: boolean;
+    filesOnly?: boolean;
+    count?: boolean;
+    maxCount?: number;
+    quiet?: boolean;
+    context?: number;
+    json?: boolean;
+    glob?: string;
+    fileType?: string;
+    follow?: boolean;
+    extraPatterns?: string[];
+    maxFilesize?: number;
+    force?: boolean;
+    write?: boolean;
+    hook?: boolean;
+    shell?: "bash" | "elvish" | "fish" | "powershell" | "zsh";
+}
+export declare function executeFrg(input: unknown, ctx: ToolContext): Promise<ToolResult>;