pi-ast-sgrep 2.0.2 → 2.2.0

package/dist/present.d.ts

@@ -1,70 +0,0 @@
-/** Neat asgrep tool chrome for the Pi TUI and the model-visible content. */
-export type PresentTheme = {
-    bold(text: string): string;
-    fg(role: string, text: string): string;
-};
-export type HitLike = {
-    file?: unknown;
-    path?: unknown;
-    ref?: unknown;
-    symbol?: unknown;
-    kind?: unknown;
-    preview?: unknown;
-    start_line?: unknown;
-    line?: unknown;
-    lines?: unknown;
-};
-export type EnvelopeLike = {
-    ok?: unknown;
-    hits?: unknown;
-    count?: unknown;
-    total?: unknown;
-    status?: unknown;
-    index_status?: unknown;
-    counts?: unknown;
-    backend?: unknown;
-    [key: string]: unknown;
-};
-export declare const ASGREP_PROMPT_SNIPPET = "Search this repo by intent, symbol, callers, defs, pattern, or chain (in-process asgrep; use without being asked)";
-export declare const ASGREP_PROMPT_GUIDELINES: readonly ["For any code lookup (find a function, callers, defs, intent, structural pattern, or imports), call asgrep or asgrep_search immediately. Do not wait for the user to mention ast-sgrep.", "Prefer the asgrep Code Mode tool when you need more than one lookup, filtering, or parallel work. Write JavaScript that calls asgrep.search / semantic / chain / defs / callers / imports / indexStatus / indexRepo and return a small shaped value.", "Use grep only for exact log strings, filenames, or config keys. Use Pi write/edit to change files; asgrep does not mutate source."];
-export declare function formatSearchCall(params: {
-    query?: string;
-    mode?: string;
-    limit?: number;
-    excerptLines?: number;
-}, theme?: PresentTheme): string;
-export declare function formatIndexCall(force: boolean, theme?: PresentTheme): string;
-export declare function formatStatusCall(theme?: PresentTheme): string;
-export declare function formatCodemodeCall(code: string, theme?: PresentTheme): string;
-export declare function formatSearchResult(response: EnvelopeLike, meta: {
-    command: string;
-    query?: string;
-    mode?: string;
-    activationMs?: number;
-    backend?: string;
-}, theme?: PresentTheme): string;
-export declare function formatStatusResult(response: EnvelopeLike, theme?: PresentTheme): string;
-export declare function formatIndexResult(command: string, response: EnvelopeLike, theme?: PresentTheme): string;
-/** Local stand-in so we do not take a pi-tui dependency. Over-counts wide glyphs rather than under-count. */
-export declare function visibleWidth(text: string): number;
-export declare function truncateToWidth(text: string, maxWidth: number, ellipsis?: string): string;
-export declare function formatCodemodeResult(value: unknown, meta?: {
-    stats?: {
-        calls: number;
-        batchedCalls: number;
-        parallelSpawnCalls: number;
-        stickyCalls?: number;
-        waves: number;
-    };
-    wallMs?: number;
-    backend?: string;
-}, theme?: PresentTheme): string;
-/** Minimal pi-tui Text stand-in so we do not take a TUI package dependency. */
-export declare class AsgrepText {
-    #private;
-    constructor(text?: string);
-    setText(text: string): void;
-    invalidate(): void;
-    render(width: number): string[];
-}
-export declare function presentText(formatted: string, last: unknown): AsgrepText;

package/dist/present.js

@@ -1,260 +0,0 @@
-/** Neat asgrep tool chrome for the Pi TUI and the model-visible content. */
-export const ASGREP_PROMPT_SNIPPET = "Search this repo by intent, symbol, callers, defs, pattern, or chain (in-process asgrep; use without being asked)";
-export const ASGREP_PROMPT_GUIDELINES = [
-    "For any code lookup (find a function, callers, defs, intent, structural pattern, or imports), call asgrep or asgrep_search immediately. Do not wait for the user to mention ast-sgrep.",
-    "Prefer the asgrep Code Mode tool when you need more than one lookup, filtering, or parallel work. Write JavaScript that calls asgrep.search / semantic / chain / defs / callers / imports / indexStatus / indexRepo and return a small shaped value.",
-    "Use grep only for exact log strings, filenames, or config keys. Use Pi write/edit to change files; asgrep does not mutate source.",
-];
-function paint(theme, role, text, bold = false) {
-    const body = bold && theme ? theme.bold(text) : text;
-    return theme ? theme.fg(role, body) : body;
-}
-function hitLocation(hit) {
-    const file = String(hit.file ?? hit.path ?? "");
-    const line = hit.start_line ?? hit.line ?? hit.lines;
-    if (typeof line === "number")
-        return `${file}:${line}`;
-    if (typeof line === "string" && line.length > 0)
-        return `${file}:${line}`;
-    if (typeof hit.ref === "string" && hit.ref.length > 0)
-        return hit.ref;
-    return file || "?";
-}
-function hitLabel(hit) {
-    const symbol = typeof hit.symbol === "string" ? hit.symbol : "";
-    const kind = typeof hit.kind === "string" ? hit.kind : "";
-    const preview = typeof hit.preview === "string" ? hit.preview.replace(/\s+/g, " ").trim() : "";
-    return [symbol, kind, preview && preview.length < 80 ? preview : ""].filter(Boolean).join("  ");
-}
-function header(theme, verb, bits) {
-    return [paint(theme, "toolTitle", "asgrep", true), paint(theme, "accent", verb), ...bits.filter((bit) => Boolean(bit))].join("  ·  ");
-}
-export function formatSearchCall(params, theme) {
-    return header(theme, "search", [
-        params.query ? JSON.stringify(params.query) : undefined,
-        params.mode ?? "natural",
-        params.limit !== undefined ? `limit ${params.limit}` : undefined,
-        params.excerptLines ? `excerpt ${params.excerptLines}` : undefined,
-    ]);
-}
-export function formatIndexCall(force, theme) {
-    return header(theme, force ? "reindex" : "index", []);
-}
-export function formatStatusCall(theme) {
-    return header(theme, "status", []);
-}
-export function formatCodemodeCall(code, theme) {
-    const preview = code.trim().replace(/\s+/g, " ").slice(0, 80);
-    return header(theme, "codemode", [`${preview}${code.trim().length > 80 ? "…" : ""}`]);
-}
-export function formatSearchResult(response, meta, theme) {
-    const hits = Array.isArray(response.hits) ? response.hits : [];
-    const title = header(theme, meta.command, [
-        meta.query ? JSON.stringify(meta.query) : undefined,
-        meta.mode,
-        `${hits.length} hit${hits.length === 1 ? "" : "s"}`,
-        meta.activationMs !== undefined ? `${meta.activationMs < 10 ? meta.activationMs.toFixed(2) : meta.activationMs.toFixed(1)}ms` : undefined,
-        meta.backend,
-    ]);
-    const rows = hits.slice(0, 24).map((hit) => {
-        const loc = hitLocation(hit);
-        const label = hitLabel(hit);
-        return paint(theme, "toolOutput", label ? `  ${loc}  ${label}` : `  ${loc}`);
-    });
-    if (hits.length > 24) {
-        rows.push(paint(theme, "muted", `  … ${hits.length - 24} more`));
-    }
-    return [title, ...rows].join("\n");
-}
-export function formatStatusResult(response, theme) {
-    const state = typeof response.status === "string" ? response.status
-        : typeof response.index_status === "string" ? response.index_status
-            : response.ok ? "ok" : "failed";
-    const counts = response.counts && typeof response.counts === "object"
-        ? Object.entries(response.counts).map(([key, value]) => `${key}=${String(value)}`).join("  ")
-        : "";
-    const backend = typeof response.backend === "string" ? response.backend : "";
-    const title = header(theme, "status", [state, counts, backend]);
-    return title;
-}
-export function formatIndexResult(command, response, theme) {
-    const count = typeof response.count === "number" ? response.count
-        : typeof response.total === "number" ? response.total
-            : undefined;
-    const tail = count === undefined ? "done" : `${count} file${count === 1 ? "" : "s"}`;
-    return header(theme, command, [tail]);
-}
-function ansiLengthAt(text, index) {
-    if (text.charCodeAt(index) !== 0x1b)
-        return 0;
-    const next = text[index + 1];
-    if (next === "[") {
-        let cursor = index + 2;
-        while (cursor < text.length) {
-            const code = text.charCodeAt(cursor);
-            if (code >= 0x40 && code <= 0x7e)
-                return cursor - index + 1;
-            cursor += 1;
-        }
-        return text.length - index;
-    }
-    if (next === "]") {
-        let cursor = index + 2;
-        while (cursor < text.length) {
-            if (text.charCodeAt(cursor) === 0x07)
-                return cursor - index + 1;
-            if (text.charCodeAt(cursor) === 0x1b && text[cursor + 1] === "\\")
-                return cursor - index + 2;
-            cursor += 1;
-        }
-        return text.length - index;
-    }
-    if (next === "P" || next === "X" || next === "^" || next === "_") {
-        let cursor = index + 2;
-        while (cursor < text.length) {
-            if (text.charCodeAt(cursor) === 0x1b && text[cursor + 1] === "\\")
-                return cursor - index + 2;
-            cursor += 1;
-        }
-        return text.length - index;
-    }
-    return Math.min(2, text.length - index);
-}
-function cellWidthAt(text, index) {
-    const code = text.charCodeAt(index);
-    if (code === 0x09)
-        return { width: 3, length: 1 };
-    if (code >= 0xd800 && code <= 0xdbff)
-        return { width: 2, length: 2 };
-    if (code <= 0x1f || (code >= 0x7f && code <= 0x9f))
-        return { width: 0, length: 1 };
-    if (code <= 0x7e)
-        return { width: 1, length: 1 };
-    return { width: 2, length: 1 };
-}
-/** Local stand-in so we do not take a pi-tui dependency. Over-counts wide glyphs rather than under-count. */
-export function visibleWidth(text) {
-    let width = 0;
-    for (let index = 0; index < text.length;) {
-        const ansi = ansiLengthAt(text, index);
-        if (ansi > 0) {
-            index += ansi;
-            continue;
-        }
-        const cell = cellWidthAt(text, index);
-        width += cell.width;
-        index += cell.length;
-    }
-    return width;
-}
-export function truncateToWidth(text, maxWidth, ellipsis = "...") {
-    const limit = Math.max(0, maxWidth);
-    if (limit <= 0)
-        return "";
-    if (visibleWidth(text) <= limit)
-        return text;
-    const ellipsisWidth = visibleWidth(ellipsis);
-    if (ellipsisWidth >= limit)
-        return ellipsis.slice(0, limit);
-    const budget = limit - ellipsisWidth;
-    let kept = "";
-    let width = 0;
-    for (let index = 0; index < text.length;) {
-        const ansi = ansiLengthAt(text, index);
-        if (ansi > 0) {
-            kept += text.slice(index, index + ansi);
-            index += ansi;
-            continue;
-        }
-        const cell = cellWidthAt(text, index);
-        if (width + cell.width > budget)
-            break;
-        kept += text.slice(index, index + cell.length);
-        width += cell.width;
-        index += cell.length;
-    }
-    return `${kept}${ellipsis}`;
-}
-function compactValue(value) {
-    if (value === null || value === undefined)
-        return String(value);
-    if (typeof value !== "object")
-        return String(value);
-    if (Array.isArray(value))
-        return `${value.length} item${value.length === 1 ? "" : "s"}`;
-    const json = JSON.stringify(value);
-    return json.length <= 80 ? json : `${json.slice(0, 79)}…`;
-}
-export function formatCodemodeResult(value, meta = {}, theme) {
-    if (value && typeof value === "object" && Array.isArray(value.hits)) {
-        const searchMeta = { command: "codemode" };
-        if (meta.wallMs !== undefined)
-            searchMeta.activationMs = meta.wallMs;
-        if (meta.backend !== undefined)
-            searchMeta.backend = meta.backend;
-        return formatSearchResult(value, searchMeta, theme);
-    }
-    const bits = [];
-    if (value && typeof value === "object") {
-        const record = value;
-        if (typeof record.hit_count === "number")
-            bits.push(`${record.hit_count} hit${record.hit_count === 1 ? "" : "s"}`);
-        else if (typeof record.node_count === "number")
-            bits.push(`${record.node_count} node${record.node_count === 1 ? "" : "s"}`);
-    }
-    if (meta.backend === "napi")
-        bits.push("in-process");
-    else if (meta.backend === "cli")
-        bits.push("cli-sticky");
-    if (meta.stats && meta.stats.calls > 0) {
-        const via = (meta.stats.stickyCalls ?? 0) > 0
-            ? `native ${meta.stats.stickyCalls}`
-            : meta.stats.batchedCalls > 0
-                ? `batched ${meta.stats.batchedCalls}`
-                : meta.stats.parallelSpawnCalls > 0
-                    ? `parallel-spawn ${meta.stats.parallelSpawnCalls}`
-                    : `${meta.stats.calls} call${meta.stats.calls === 1 ? "" : "s"}`;
-        bits.push(via);
-        if (meta.stats.waves > 1)
-            bits.push(`${meta.stats.waves} waves`);
-    }
-    if (meta.wallMs !== undefined)
-        bits.push(`${meta.wallMs}ms`);
-    const title = header(theme, "codemode", bits);
-    if (value && typeof value === "object" && !Array.isArray(value)) {
-        const rows = Object.entries(value).slice(0, 16).map(([key, entry]) => paint(theme, "toolOutput", `  ${key}: ${compactValue(entry)}`));
-        return [title, ...rows].join("\n");
-    }
-    if (Array.isArray(value)) {
-        return [title, paint(theme, "toolOutput", `  ${value.length} value${value.length === 1 ? "" : "s"}`)].join("\n");
-    }
-    return `${title}\n${paint(theme, "toolOutput", `  ${compactValue(value)}`)}`;
-}
-/** Minimal pi-tui Text stand-in so we do not take a TUI package dependency. */
-export class AsgrepText {
-    #text;
-    constructor(text = "") {
-        this.#text = text;
-    }
-    setText(text) {
-        this.#text = text;
-    }
-    invalidate() { }
-    render(width) {
-        const maxWidth = Math.max(1, width);
-        if (this.#text.length === 0)
-            return [""];
-        return this.#text.split("\n").map((line) => truncateToWidth(line, maxWidth));
-    }
-}
-export function presentText(formatted, last) {
-    if (last instanceof AsgrepText) {
-        last.setText(formatted);
-        return last;
-    }
-    if (last && typeof last === "object" && last !== null && "setText" in last && typeof last.setText === "function") {
-        last.setText(formatted);
-        return last;
-    }
-    return new AsgrepText(formatted);
-}

package/dist/runtime.d.ts

@@ -1,137 +0,0 @@
-import { type FSWatcher } from "node:fs";
-import { resolveBinary } from "ast-sgrep";
-export declare const RUNTIME_VERSION = "2.0.0";
-export declare const MACHINE_SCHEMA_VERSION = "1.0.0";
-export declare const CONFIG_SCHEMA_VERSION: 1;
-export declare const INDEX_FORMAT_VERSION: 12;
-export declare const DEFAULT_TIMEOUT_MS = 30000;
-export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
-export declare const DEFAULT_REFRESH_INTERVAL_MS = 30000;
-export interface RuntimeConfig {
-    schemaVersion?: typeof CONFIG_SCHEMA_VERSION;
-    binaryPath?: string;
-    root?: string;
-    allowOutsideProject?: boolean;
-    timeoutMs?: number;
-    maxOutputBytes?: number;
-    refreshIntervalMs?: number;
-    env?: Readonly<Record<string, string>>;
-}
-export interface LegacyRuntimeConfig extends Omit<RuntimeConfig, "schemaVersion" | "timeoutMs" | "maxOutputBytes" | "refreshIntervalMs"> {
-    schemaVersion?: 0;
-    timeout?: number;
-    maxOutput?: number;
-    refreshInterval?: number;
-}
-export type RuntimeConfigInput = RuntimeConfig | LegacyRuntimeConfig;
-export interface ConfigSources {
-    explicitProjectConfig?: RuntimeConfigInput;
-    projectSettings?: RuntimeConfigInput;
-    globalSettings?: RuntimeConfigInput;
-    environment?: NodeJS.ProcessEnv;
-    defaults?: RuntimeConfigInput;
-}
-export interface RuntimeContext {
-    cwd: string;
-}
-export interface RunOptions {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    env?: Readonly<Record<string, string>>;
-}
-export interface ExecOptions {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    signal?: AbortSignal;
-    timeout?: number;
-}
-export interface ExecResult {
-    stdout: string;
-    stderr: string;
-    code?: number | null;
-    exitCode?: number | null;
-    signal?: string | null;
-}
-export interface PiExec {
-    exec(command: string, args: readonly string[], options: ExecOptions): Promise<ExecResult>;
-}
-export interface MachineEnvelope {
-    tool: "asgrep";
-    schema_version: string;
-    ok: boolean;
-    version?: string;
-    machine_schema_version?: string;
-    [key: string]: unknown;
-}
-export declare class RuntimeError extends Error {
-    readonly code: string;
-    readonly details: Readonly<Record<string, unknown>>;
-    constructor(code: string, message: string, details?: Readonly<Record<string, unknown>>);
-}
-/** Convert schema 0/unversioned settings without mutating the rollback source. */
-export declare function migrateConfig(input?: RuntimeConfigInput): RuntimeConfig;
-/** Serialize current settings for a schema-0 rollback without mutating the current value. */
-export declare function rollbackConfig(input: RuntimeConfig): LegacyRuntimeConfig;
-/** Merge each setting independently, from the documented lowest to highest priority. */
-export declare function resolveConfig(sources?: ConfigSources): Required<Pick<RuntimeConfig, "timeoutMs" | "maxOutputBytes">> & RuntimeConfig;
-export declare function resolveRuntimeRoot(projectCwd: string, requestedRoot?: string, allowOutsideProject?: boolean): Promise<string>;
-type BinaryResolver = typeof resolveBinary;
-export interface RuntimeDependencies {
-    resolveBinary?: BinaryResolver;
-}
-export interface FreshnessRuntime {
-    run(args: readonly string[], context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-    resolveRoot(context: RuntimeContext): Promise<string>;
-    inspectIndexCompatibility?(context: RuntimeContext): Promise<IndexHealth>;
-    rebuildIncompatibleIndex?(context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-    /** Absolute database path whose SQLite/derived writes are owned by this runtime. */
-    resolveIndexPath?(root: string): string;
-    /**
-     * Optional warm native call (session sticky pool). When present, freshness
-     * prefers this over cold `run` for status/index — same Searcher as Code Mode.
-     */
-    nativeCall?(tool: string, args: Record<string, unknown>, context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-    /** Enable low-latency external filesystem change detection for real runtimes. */
-    watchExternalChanges?: boolean;
-}
-export interface FreshnessCoordinatorOptions {
-    refreshIntervalMs?: number;
-    now?: () => number;
-    watchFactory?: FreshnessWatchFactory;
-}
-export type FreshnessWatchFactory = (root: string, options: {
-    recursive: true;
-    persistent: false;
-    encoding: "utf8";
-}, listener: (eventType: "rename" | "change", filename: string | null) => void) => FSWatcher;
-export type IndexHealth = "ready" | "missing" | "incompatible";
-export declare class FreshnessCoordinator {
-    #private;
-    constructor(options?: FreshnessCoordinatorOptions);
-    markAffectedPath(path: string, cwd: string): void;
-    markRootDirty(root: string): void;
-    ensureFresh(runtime: FreshnessRuntime, context: RuntimeContext, options?: RunOptions): Promise<string>;
-    shutdown(): void;
-}
-export declare class AstSgrepRuntime {
-    #private;
-    private readonly pi;
-    readonly watchExternalChanges = true;
-    readonly config: ReturnType<typeof resolveConfig>;
-    constructor(pi: PiExec, sources?: ConfigSources, dependencies?: RuntimeDependencies);
-    resolveRoot(context: RuntimeContext): Promise<string>;
-    resolveIndexPath(root: string): string;
-    inspectIndexCompatibility(context: RuntimeContext): Promise<IndexHealth>;
-    rebuildIncompatibleIndex(context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-    run(args: readonly string[], context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-    /** Absolute path to the native binary (for sticky serve / stdin batch spawn). */
-    resolveBinaryPath(options?: {
-        env?: NodeJS.ProcessEnv;
-    }): string;
-    /** Merged process env for native Code Mode workers. */
-    nativeEnv(options?: {
-        env?: NodeJS.ProcessEnv;
-    }): NodeJS.ProcessEnv;
-    checkCompatibility(context: RuntimeContext, options?: RunOptions): Promise<MachineEnvelope>;
-}
-export {};