@wrongstack/tools 0.306.3 → 0.307.0

package/dist/codebase-index/project-server-client-state.d.ts

@@ -0,0 +1,79 @@
+import type { ProjectIndexServerActivity, ProjectIndexServerHealth } from './project-server-protocol.js';
+export declare const CONNECT_ATTEMPT_TIMEOUT_MS = 750;
+export declare const SERVER_START_TIMEOUT_MS = 10000;
+export declare const SERVER_CONTROL_TIMEOUT_MS = 5000;
+export declare const SERVER_HEALTH_TIMEOUT_MS = 3000;
+export declare const SERVER_HEARTBEAT_INTERVAL_MS = 10000;
+export declare class StaleProjectIndexServerError extends Error {
+    readonly pid: number;
+    readonly name = "StaleProjectIndexServerError";
+    constructor(message: string, pid: number);
+}
+export interface PendingRequest {
+    resolve(value: unknown): void;
+    reject(error: unknown): void;
+    timer: ReturnType<typeof setTimeout>;
+    signal?: AbortSignal | undefined;
+    onAbort?: (() => void) | undefined;
+    onProgress?: ((current: number, total: number) => void) | undefined;
+}
+export interface ProjectServerCallOptions {
+    timeoutMs: number;
+    signal?: AbortSignal | undefined;
+    onProgress?: ((current: number, total: number) => void) | undefined;
+}
+export interface ProjectIndexServerShutdownResult {
+    stopped: boolean;
+    pid?: number | undefined;
+    reason?: string | undefined;
+}
+export type ProjectIndexServerConnectionStatus = 'unavailable' | 'offline' | 'connecting' | 'connected' | 'degraded' | 'unresponsive' | 'error' | 'stopping';
+export interface ProjectIndexServerClientHealth {
+    status: 'healthy' | 'degraded' | 'unresponsive';
+    checkedAt: number;
+    lastHealthyAt: number | null;
+    latencyMs: number | null;
+    missedHeartbeats: number;
+    server?: ProjectIndexServerHealth | undefined;
+}
+export interface ProjectIndexServerConnectionState {
+    status: ProjectIndexServerConnectionStatus;
+    connected: boolean;
+    projectRoot?: string | undefined;
+    indexDir?: string | undefined;
+    endpoint?: string | undefined;
+    pid?: number | undefined;
+    lastError?: string | undefined;
+    activity?: ProjectIndexServerActivity | undefined;
+    health?: ProjectIndexServerClientHealth | undefined;
+}
+export type ProjectIndexServerConnectionListener = (state: ProjectIndexServerConnectionState) => void;
+export declare const connectionStates: Map<string, ProjectIndexServerConnectionState>;
+export declare const connectionStateListeners: Set<ProjectIndexServerConnectionListener>;
+export declare let latestConnectionState: ProjectIndexServerConnectionState;
+export declare function setLatestConnectionState(state: ProjectIndexServerConnectionState): void;
+export type ProjectIndexDaemonAvailability = {
+    readonly kind: 'available';
+    readonly url: URL;
+} | {
+    readonly kind: 'inline-requested';
+} | {
+    readonly kind: 'missing-build';
+} | {
+    readonly kind: 'endpoint-invalid';
+    readonly endpoint: string;
+    readonly byteLength: number;
+    readonly maxBytes: number;
+};
+export declare function resolveProjectIndexDaemonAvailability(projectRoot?: string, indexDir?: string): ProjectIndexDaemonAvailability;
+export declare function resolveProjectServerUrl(): URL | null;
+export declare function projectIndexServerExpectedBuildId(): string | null;
+export declare function isProjectIndexServerAvailable(): boolean;
+export declare function publishConnectionState(endpoint: string, state: ProjectIndexServerConnectionState): void;
+export declare function getProjectIndexServerConnectionState(projectRoot?: string, indexDir?: string): ProjectIndexServerConnectionState;
+export declare function onProjectIndexServerConnectionStateChange(listener: ProjectIndexServerConnectionListener): () => void;
+export declare function remoteError(message: string, name?: string): Error;
+export declare function isProjectIndexServerHealth(value: unknown): value is ProjectIndexServerHealth;
+export declare function delay(ms: number): Promise<void>;
+export declare function cancellationError(signal: AbortSignal): Error;
+//# sourceMappingURL=project-server-client-state.d.ts.map

package/dist/codebase-index/project-server-client.d.ts

@@ -1,80 +1,13 @@
-import { type ProjectIndexServerActivity, type ProjectIndexServerHealth } from './project-server-protocol.js';
 import type { OpName, OpShapes } from './worker-protocol.js';
-export interface ProjectServerCallOptions {
-    timeoutMs: number;
-    signal?: AbortSignal | undefined;
-    onProgress?: ((current: number, total: number) => void) | undefined;
-}
-export interface ProjectIndexServerShutdownResult {
-    stopped: boolean;
-    pid?: number | undefined;
-    reason?: string | undefined;
-}
-export type ProjectIndexServerConnectionStatus = 'unavailable' | 'offline' | 'connecting' | 'connected' | 'degraded' | 'unresponsive' | 'error' | 'stopping';
-export interface ProjectIndexServerClientHealth {
-    status: 'healthy' | 'degraded' | 'unresponsive';
-    checkedAt: number;
-    lastHealthyAt: number | null;
-    latencyMs: number | null;
-    missedHeartbeats: number;
-    server?: ProjectIndexServerHealth | undefined;
-}
-export interface ProjectIndexServerConnectionState {
-    status: ProjectIndexServerConnectionStatus;
-    connected: boolean;
-    projectRoot?: string | undefined;
-    indexDir?: string | undefined;
-    endpoint?: string | undefined;
-    pid?: number | undefined;
-    lastError?: string | undefined;
-    activity?: ProjectIndexServerActivity | undefined;
-    health?: ProjectIndexServerClientHealth | undefined;
-}
-type ProjectIndexServerConnectionListener = (state: ProjectIndexServerConnectionState) => void;
-/**
- * Why the index daemon is or is not usable.
- *
- * A bare `null` cannot distinguish "the operator asked for in-process mode"
- * from "the built server is missing", so callers that degrade on `null` treat a
- * broken build as a supported mode. For the index that means every process
- * quietly builds its own FTS5 database instead of sharing the project's one
- * owner — same data, N copies, none of them authoritative.
- */
-export type ProjectIndexDaemonAvailability = {
-    readonly kind: 'available';
-    readonly url: URL;
-}
-/** `WRONGSTACK_INDEX_INLINE` / `WRONGSTACK_INDEX_SERVER=0` was set. */
- | {
-    readonly kind: 'inline-requested';
-}
-/** No server entry point exists in any known output layout. */
- | {
-    readonly kind: 'missing-build';
-}
-/**
- * The derived socket path cannot be bound on this platform (over the
- * `sun_path` byte limit — seen on macOS whose per-user TMPDIR is ~48 bytes).
- * A daemon spawned onto this endpoint dies silently (`stdio: 'ignore'`), so
- * callers must degrade explicitly instead of entering the connect loop.
- */
- | {
-    readonly kind: 'endpoint-invalid';
-    readonly endpoint: string;
-    readonly byteLength: number;
-    readonly maxBytes: number;
-};
-export declare function resolveProjectIndexDaemonAvailability(projectRoot?: string, indexDir?: string): ProjectIndexDaemonAvailability;
-export declare function projectIndexServerExpectedBuildId(): string | null;
-export declare function isProjectIndexServerAvailable(): boolean;
-export declare function getProjectIndexServerConnectionState(projectRoot?: string, indexDir?: string): ProjectIndexServerConnectionState;
-export declare function onProjectIndexServerConnectionStateChange(listener: ProjectIndexServerConnectionListener): () => void;
+import { type ProjectServerCallOptions, type ProjectIndexServerShutdownResult, type ProjectIndexServerConnectionStatus, type ProjectIndexServerClientHealth, type ProjectIndexServerConnectionState, type ProjectIndexDaemonAvailability, resolveProjectIndexDaemonAvailability, projectIndexServerExpectedBuildId, isProjectIndexServerAvailable, getProjectIndexServerConnectionState, onProjectIndexServerConnectionStateChange } from './project-server-client-state.js';
+export { type ProjectServerCallOptions, type ProjectIndexServerShutdownResult, type ProjectIndexServerConnectionStatus, type ProjectIndexServerClientHealth, type ProjectIndexServerConnectionState, type ProjectIndexDaemonAvailability, resolveProjectIndexDaemonAvailability, projectIndexServerExpectedBuildId, isProjectIndexServerAvailable, getProjectIndexServerConnectionState, onProjectIndexServerConnectionStateChange, };
 export declare function callProjectIndexServer<O extends OpName>(op: O, args: OpShapes[O]['args'], options: ProjectServerCallOptions): Promise<OpShapes[O]['result']>;
 export declare function ensureProjectIndexServer(options: {
     projectRoot: string;
     indexDir?: string | undefined;
     watchExternal: boolean;
     debounceMs: number;
+    coalesceWindowMs?: number | undefined;
 }): Promise<void>;
 export declare function checkProjectIndexServerHealth(projectRoot: string, indexDir?: string, options?: {
     timeoutMs?: number | undefined;
@@ -82,5 +15,4 @@ export declare function checkProjectIndexServerHealth(projectRoot: string, index
 export declare function shutdownProjectIndexServer(projectRoot: string, indexDir?: string, reason?: string): Promise<ProjectIndexServerShutdownResult>;
 /** Disconnect this process from every project server without stopping them. */
 export declare function closeProjectIndexServerClients(): void;
-export {};
 //# sourceMappingURL=project-server-client.d.ts.map

package/dist/codebase-index/project-server-protocol.d.ts

@@ -79,6 +79,7 @@ export type ProjectServerClientMessage = {
     id: number;
     watchExternal: boolean;
     debounceMs: number;
+    coalesceWindowMs?: number | undefined;
     authToken?: string | undefined;
 } | {
     type: 'ping';