@wrongstack/tools 0.317.0 → 0.318.0

package/dist/codebase-index/project-server.js

@@ -10,7 +10,7 @@ import {
   projectIndexServerBuildId,
   projectIndexServerEndpoint,
   projectIndexServerMetadataPath
-} from "../chunk-VGBUDLW4.js";
+} from "../chunk-6GVXZCQV.js";
 import {
   fileGraphService,
   incomingCallsService,
@@ -22,15 +22,15 @@ import {
   searchService,
   statsService,
   symbolGraphService
-} from "../chunk-TRDX25UH.js";
-import "../chunk-IYK7XGDZ.js";
+} from "../chunk-BLCSYKNN.js";
+import "../chunk-JJQB6R7Y.js";
 import "../chunk-ZLTFLC25.js";
 import "../chunk-A6BRWIXN.js";
 import "../chunk-UCYQTZ7F.js";
 import {
   isIndexablePath
-} from "../chunk-TEBQ4VPZ.js";
-import "../chunk-LIJQMYYX.js";
+} from "../chunk-YOHO4DVT.js";
+import "../chunk-DTQ75VBC.js";
 import "../chunk-V43EQ6VR.js";
 
 // src/codebase-index/project-server.ts
@@ -322,6 +322,7 @@ var walMaintenance = new WalMaintenance({
     const store = indexStorePool.acquire(projectRoot, { indexDir });
     try {
       store.optimize();
+      store.optimizeFtsIfNeeded();
     } finally {
       indexStorePool.release(store);
     }
@@ -359,6 +360,13 @@ function withWriteMutex(job) {
 function serverHealth() {
   const memory = process.memoryUsage();
   const now = Date.now();
+  let watchingClients = 0;
+  let oldestClientIdleMs = 0;
+  for (const client of clients) {
+    if (client.watchExternal) watchingClients++;
+    const idle = Math.max(0, now - client.lastSeenAt);
+    if (idle > oldestClientIdleMs) oldestClientIdleMs = idle;
+  }
   return {
     checkedAt: now,
     uptimeMs: Math.round(process.uptime() * 1e3),
@@ -374,9 +382,9 @@ function serverHealth() {
     queuedWrites,
     pendingExternalFiles: externalDebounceTimers.size + externalReadyFiles.size,
     watchingExternal: externalWatcher !== void 0,
-    watchingClients: [...clients].filter((client) => client.watchExternal).length,
+    watchingClients,
     clientLeaseTimeoutMs: clientLeaseMs,
-    oldestClientIdleMs: clients.size > 0 ? Math.max(...[...clients].map((client) => Math.max(0, now - client.lastSeenAt))) : 0,
+    oldestClientIdleMs,
     activity: indexActivity
   };
 }
@@ -942,6 +950,37 @@ void (async () => {
   markMetadataWritten?.();
   scheduleIdleStop();
 })();
-process.once("SIGINT", () => void stop("SIGINT"));
-process.once("SIGTERM", () => void stop("SIGTERM"));
+var SIGNAL_GUARD = /* @__PURE__ */ Symbol.for(
+  "wrongstack.codebase-index.project-server.signalGuard"
+);
+var signalGuardStore = globalThis;
+var signalGuard = signalGuardStore[SIGNAL_GUARD];
+if (!signalGuard) {
+  let current = async () => void 0;
+  let armed = false;
+  const handlers = /* @__PURE__ */ new Map();
+  const disarm = () => {
+    if (!armed) return;
+    armed = false;
+    for (const [signal, handler] of handlers) process.removeListener(signal, handler);
+    handlers.clear();
+  };
+  signalGuard = {
+    arm(next) {
+      current = next;
+      if (armed) return;
+      armed = true;
+      for (const signal of ["SIGINT", "SIGTERM"]) {
+        const handler = () => {
+          disarm();
+          void current(signal);
+        };
+        handlers.set(signal, handler);
+        process.on(signal, handler);
+      }
+    }
+  };
+  signalGuardStore[SIGNAL_GUARD] = signalGuard;
+}
+signalGuard.arm(stop);
 //# sourceMappingURL=project-server.js.map

package/dist/codebase-index/worker.js

@@ -7,13 +7,13 @@ import {
   searchService,
   statsService,
   symbolGraphService
-} from "../chunk-TRDX25UH.js";
-import "../chunk-IYK7XGDZ.js";
+} from "../chunk-BLCSYKNN.js";
+import "../chunk-JJQB6R7Y.js";
 import "../chunk-ZLTFLC25.js";
 import "../chunk-A6BRWIXN.js";
 import "../chunk-UCYQTZ7F.js";
-import "../chunk-TEBQ4VPZ.js";
-import "../chunk-LIJQMYYX.js";
+import "../chunk-YOHO4DVT.js";
+import "../chunk-DTQ75VBC.js";
 import "../chunk-V43EQ6VR.js";
 
 // src/codebase-index/worker.ts

package/dist/codebase-index/writer-bulk-insert.d.ts

@@ -13,7 +13,6 @@ export interface BulkSymbolRow {
     signature: string;
     docComment: string;
     scope: string;
-    text: string;
 }
 export declare function bulkInsertSymbolsWithStatement(stmt: PrepareStatement, maxSqlVars: number, rows: BulkSymbolRow[]): void;
 export declare function bulkInsertFtsWithStatement(stmt: PrepareStatement, maxSqlVars: number, ftsAvailable: boolean, rows: Array<{

package/dist/codebase-index/writer-schema.d.ts

@@ -1,5 +1,5 @@
 export declare const METADATA_TABLE_SQL = "\n  CREATE TABLE IF NOT EXISTS metadata (\n    key TEXT PRIMARY KEY,\n    value TEXT NOT NULL\n  );\n";
-export declare const CORE_TABLES_SQL = "\n  CREATE TABLE IF NOT EXISTS files (\n    file TEXT PRIMARY KEY,\n    lang TEXT NOT NULL,\n    mtime_ms INTEGER NOT NULL,\n    -- Phase 2: xxHash64 of the file's UTF-8 bytes. Empty string when the\n    -- indexer hasn't populated it yet (legacy rows, schema repaired by\n    -- repairMissingColumns). Compared on incremental re-index so that a\n    -- touch or branch-switch that leaves content byte-identical skips the\n    -- expensive parse phase entirely (refactoring proposal Phase 2).\n    content_hash TEXT NOT NULL DEFAULT '',\n    symbol_count INTEGER NOT NULL DEFAULT 0,\n    last_indexed INTEGER NOT NULL,\n    -- Code Atlas grouping label, computed at index time from the ecosystem's\n    -- own manifests (package.json, go.mod, Cargo.toml, \u2026). Stored rather than\n    -- re-derived per query because the evidence lives on disk, not in the DB.\n    package TEXT NOT NULL DEFAULT ''\n  );\n  CREATE TABLE IF NOT EXISTS symbols (\n    id INTEGER PRIMARY KEY,\n    lang TEXT NOT NULL,\n    kind TEXT NOT NULL,\n    name TEXT NOT NULL,\n    file TEXT NOT NULL,\n    line INTEGER NOT NULL,\n    col INTEGER NOT NULL,\n    signature TEXT NOT NULL DEFAULT '',\n    doc_comment TEXT NOT NULL DEFAULT '',\n    scope TEXT NOT NULL DEFAULT '',\n    text TEXT NOT NULL DEFAULT ''\n    );\n";
+export declare const CORE_TABLES_SQL = "\n  CREATE TABLE IF NOT EXISTS files (\n    file TEXT PRIMARY KEY,\n    lang TEXT NOT NULL,\n    mtime_ms INTEGER NOT NULL,\n    -- Phase 2: xxHash64 of the file's UTF-8 bytes. Empty string when the\n    -- indexer hasn't populated it yet (legacy rows, schema repaired by\n    -- repairMissingColumns). Compared on incremental re-index so that a\n    -- touch or branch-switch that leaves content byte-identical skips the\n    -- expensive parse phase entirely (refactoring proposal Phase 2).\n    content_hash TEXT NOT NULL DEFAULT '',\n    symbol_count INTEGER NOT NULL DEFAULT 0,\n    last_indexed INTEGER NOT NULL,\n    -- Code Atlas grouping label, computed at index time from the ecosystem's\n    -- own manifests (package.json, go.mod, Cargo.toml, \u2026). Stored rather than\n    -- re-derived per query because the evidence lives on disk, not in the DB.\n    package TEXT NOT NULL DEFAULT ''\n  );\n  CREATE TABLE IF NOT EXISTS symbols (\n    id INTEGER PRIMARY KEY,\n    lang TEXT NOT NULL,\n    kind TEXT NOT NULL,\n    name TEXT NOT NULL,\n    file TEXT NOT NULL,\n    line INTEGER NOT NULL,\n    col INTEGER NOT NULL,\n    signature TEXT NOT NULL DEFAULT '',\n    doc_comment TEXT NOT NULL DEFAULT '',\n    scope TEXT NOT NULL DEFAULT ''\n    );\n";
 export declare const FILE_INDEX_SQL: readonly ['CREATE INDEX IF NOT EXISTS idx_f_package ON files(package)'];
 export declare const SYMBOL_INDEX_SQL: readonly ['CREATE INDEX IF NOT EXISTS idx_s_name ON symbols(name)', 'CREATE INDEX IF NOT EXISTS idx_s_kind ON symbols(kind)', 'CREATE INDEX IF NOT EXISTS idx_s_lang ON symbols(lang)', 'CREATE INDEX IF NOT EXISTS idx_s_file ON symbols(file)', 'CREATE INDEX IF NOT EXISTS idx_s_lang_kind ON symbols(lang, kind)', 'CREATE INDEX IF NOT EXISTS idx_s_name_id ON symbols(name, id)'];
 export declare const REFS_TABLE_SQL = "\n  CREATE TABLE IF NOT EXISTS refs (\n    id INTEGER PRIMARY KEY,\n    from_id INTEGER NOT NULL,\n    to_name TEXT NOT NULL,\n    to_id INTEGER,\n    call_type TEXT NOT NULL,\n    line INTEGER NOT NULL,\n    lang TEXT NOT NULL DEFAULT '',\n    module TEXT,\n    to_file TEXT\n  );\n";

package/dist/codebase-index/writer.d.ts

@@ -25,9 +25,21 @@ export declare class IndexStore {
     private rollbackWriteTransaction;
     private seedLangFamilies;
     private repairMissingColumns;
+    /**
+     * P4: `symbols.text` duplicated name + signature + doc_comment (~19 MB on
+     * the live index) and is derived on demand now. In-place DROP COLUMN — no
+     * SCHEMA_VERSION bump, so no wipe-and-reparse. Best-effort: a busy or
+     * SQLite-without-DROP-COLUMN open leaves the column in place, where new
+     * inserts simply default it to '' and the next open retries.
+     */
+    private dropDeprecatedSymbolsColumns;
     private initSchema;
     private static readonly NEXT_SYMBOL_ID_KEY;
     private static readonly MAX_SQL_VARS;
+    /** P2: persisted FTS-mutation churn counter — see {@link optimizeFtsIfNeeded}. */
+    private static readonly FTS_CHURN_KEY;
+    /** P4: one-shot marker that the deprecated symbols.text column is gone. */
+    private static readonly SYMBOLS_TEXT_DROPPED_KEY;
     private ensureNextSymbolIdSeeded;
     private allocateSymbolIds;
     private invalidateIncomingRefsForFiles;
@@ -95,6 +107,32 @@ export declare class IndexStore {
     resolveRefsForNames(names: Iterable<string>): number;
     replaceEmptyFile(meta: FileMeta): void;
     optimize(): void;
+    /**
+     * P2: churn-gated FTS5 segment maintenance.
+     *
+     * FTS5 postings only compact when FTS5 itself merges them: every delete
+     * leaves tombstone postings in the segments, and neither VACUUM nor
+     * `PRAGMA optimize` reclaims them. Measured on the live index (2026-08-30):
+     * one delete+reinsert cycle grew symbols_fts_data 174.9→212.8 MB, while the
+     * FTS5 'optimize'/'rebuild' merge resets it (rebuild: 212.9→28.2 MB in
+     * 1.26 s for 131k rows). 'optimize' is the recurring command — an
+     * incremental merge that discards deleted docs — and only runs once churn
+     * crosses the gate, so a clean index never pays for it.
+     *
+     * Follows the {@link checkpointWal} contract: best-effort, returns whether
+     * it ran, safe to call from the daemon's single-threaded idle path.
+     */
+    optimizeFtsIfNeeded(options?: {
+        minChurnRatio?: number;
+        minChurnRows?: number;
+    }): boolean;
+    /**
+     * Best-effort churn bookkeeping for {@link optimizeFtsIfNeeded}. Counts the
+     * FTS rows a mutation inserts or deletes so the maintenance gate can fire
+     * after real churn, not on a timer. Persisted in metadata so the counter
+     * survives store open/close cycles in the daemon pool.
+     */
+    private recordFtsChurn;
     /**
      * P4.14: best-effort WAL checkpoint for idle-time maintenance.
      *

package/dist/diff.js

@@ -1,6 +1,6 @@
 import {
   diffTool
-} from "./chunk-UKU2ZX4C.js";
+} from "./chunk-P7ZQ2FAJ.js";
 import "./chunk-D33S4RQG.js";
 export {
   diffTool

package/dist/e2e.d.ts

@@ -51,6 +51,45 @@ export declare function discoverE2EProjects(root: string, options: {
     includeSpecs?: boolean | undefined;
     signal: AbortSignal;
 }): Promise<E2EPlanOutput>;
-export declare const e2ePlanTool: Tool<E2EPlanInput, E2EPlanOutput>;
+type E2EPlanContext = Parameters<Tool<E2EPlanInput, E2EPlanOutput>['execute']>[1];
+export declare const e2ePlanTool: {
+    name: string;
+    category: string;
+    description: string;
+    usageHint: string;
+    permission: "auto";
+    mutating: false;
+    riskTier: "safe";
+    capabilities: string[];
+    icon: "test";
+    timeoutMs: number;
+    inputSchema: {
+        type: string;
+        properties: {
+            cwd: {
+                type: string;
+                description: string;
+            };
+            framework: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            includeSpecs: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute(input: E2EPlanInput, ctx: E2EPlanContext, opts?: {
+        signal: AbortSignal;
+    }): Promise<E2EPlanOutput>;
+};
 export {};
 //# sourceMappingURL=e2e.d.ts.map

package/dist/e2e.js

@@ -1,7 +1,7 @@
 import {
   discoverE2EProjects,
   e2ePlanTool
-} from "./chunk-JRJJX3L5.js";
+} from "./chunk-5WNDJHT6.js";
 import "./chunk-D33S4RQG.js";
 export {
   discoverE2EProjects,

package/dist/edit.js

@@ -1,16 +1,16 @@
 import {
   editTool
-} from "./chunk-U6DZWHBA.js";
+} from "./chunk-CIFAIIHI.js";
 import "./chunk-FQZOHLG3.js";
-import "./chunk-QDQY7NQ2.js";
-import "./chunk-VGBUDLW4.js";
-import "./chunk-TRDX25UH.js";
-import "./chunk-IYK7XGDZ.js";
+import "./chunk-VZLX2JZG.js";
+import "./chunk-6GVXZCQV.js";
+import "./chunk-BLCSYKNN.js";
+import "./chunk-JJQB6R7Y.js";
 import "./chunk-ZLTFLC25.js";
 import "./chunk-A6BRWIXN.js";
 import "./chunk-UCYQTZ7F.js";
-import "./chunk-TEBQ4VPZ.js";
-import "./chunk-LIJQMYYX.js";
+import "./chunk-YOHO4DVT.js";
+import "./chunk-DTQ75VBC.js";
 import "./chunk-V43EQ6VR.js";
 import "./chunk-D33S4RQG.js";
 export {

package/dist/exec.js

@@ -7,7 +7,7 @@ import {
   isExecCommandAllowed,
   resetDangerBypass,
   resetExecPolicy
-} from "./chunk-T2F4S7U4.js";
+} from "./chunk-WI3VDXHD.js";
 import "./chunk-BTSFTGIL.js";
 import "./chunk-NKNOBUBU.js";
 import "./chunk-2VSZC6QM.js";

package/dist/fetch.js

@@ -1,6 +1,6 @@
 import {
   fetchTool
-} from "./chunk-IXMNTNW5.js";
+} from "./chunk-UKGMDCXT.js";
 import {
   guardedFetch,
   guardedLookup

package/dist/format.d.ts

@@ -1,4 +1,4 @@
-import type { Tool } from '@wrongstack/core/types';
+import type { Tool, ToolStreamEvent } from '@wrongstack/core/types';
 interface FormatInput {
     files?: string | string[] | undefined;
     fixer?: 'biome' | 'prettier' | 'auto' | undefined;
@@ -14,6 +14,46 @@ interface FormatOutput {
     output: string;
     truncated: boolean;
 }
-export declare const formatTool: Tool<FormatInput, FormatOutput>;
+type FormatContext = Parameters<Tool<FormatInput, FormatOutput>['execute']>[1];
+export declare const formatTool: {
+    name: string;
+    category: string;
+    description: string;
+    usageHint: string;
+    permission: "confirm";
+    subjectKey: string;
+    mutating: true;
+    capabilities: string[];
+    icon: "code";
+    timeoutMs: number;
+    inputSchema: {
+        type: string;
+        properties: {
+            files: {
+                type: string;
+                description: string;
+            };
+            fixer: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            check: {
+                type: string;
+                description: string;
+            };
+            cwd: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    execute(input: FormatInput, ctx: FormatContext, opts?: {
+        signal: AbortSignal;
+    }): Promise<FormatOutput>;
+    executeStream(input: FormatInput, ctx: FormatContext, opts?: {
+        signal: AbortSignal;
+    }): AsyncGenerator<ToolStreamEvent<FormatOutput>>;
+};
 export {};
 //# sourceMappingURL=format.d.ts.map

package/dist/format.js

@@ -1,9 +1,9 @@
 import {
   formatTool
-} from "./chunk-SDLVH5RZ.js";
-import "./chunk-PQKK5JH7.js";
-import "./chunk-OUBDL3WH.js";
-import "./chunk-22B7GE5T.js";
+} from "./chunk-3QQSBUXR.js";
+import "./chunk-4E42D7UF.js";
+import "./chunk-SOG7XIRF.js";
+import "./chunk-ZHH3BEWU.js";
 import "./chunk-2VSZC6QM.js";
 import "./chunk-3PVYQFRQ.js";
 import "./chunk-HFXSNKCV.js";

package/dist/git.d.ts

@@ -37,6 +37,75 @@ interface GitOutput {
      */
     warning?: string | undefined;
 }
-export declare const gitTool: Tool<GitInput, GitOutput>;
+type GitContext = Parameters<Tool<GitInput, GitOutput>['execute']>[1];
+export declare const gitTool: {
+    name: string;
+    category: string;
+    description: string;
+    usageHint: string;
+    permission: "confirm";
+    icon: "git";
+    subjectKey: string;
+    subjectFields: string[];
+    mutating: true;
+    capabilities: string[];
+    timeoutMs: number;
+    inputSchema: {
+        type: string;
+        properties: {
+            command: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            files: {
+                type: string;
+                description: string;
+            };
+            message: {
+                type: string;
+                description: string;
+            };
+            branch: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            dry_run: {
+                type: string;
+                description: string;
+            };
+            worktreeAction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            worktreePath: {
+                type: string;
+                description: string;
+            };
+            newBranch: {
+                type: string;
+                description: string;
+            };
+            force: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(input: GitInput, ctx: GitContext, opts?: {
+        signal: AbortSignal;
+    }): Promise<GitOutput>;
+};
 export {};
 //# sourceMappingURL=git.d.ts.map

package/dist/git.js

@@ -1,6 +1,6 @@
 import {
   gitTool
-} from "./chunk-RXISBFR5.js";
+} from "./chunk-ZE6KLBUO.js";
 import "./chunk-D33S4RQG.js";
 export {
   gitTool

package/dist/glob.js

@@ -1,8 +1,8 @@
 import {
   globTool
-} from "./chunk-UNSKG6DC.js";
-import "./chunk-U4D5S3VQ.js";
-import "./chunk-LIJQMYYX.js";
+} from "./chunk-6GZPSWP3.js";
+import "./chunk-NWZ6XGBJ.js";
+import "./chunk-DTQ75VBC.js";
 import "./chunk-D33S4RQG.js";
 export {
   globTool

package/dist/{go-parser-JXYKJHRC.js → go-parser-IKHW67WE.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-UCYQTZ7F.js";
 import {
   detectLang
-} from "./chunk-TEBQ4VPZ.js";
+} from "./chunk-YOHO4DVT.js";
 import {
   resolveWin32Command
 } from "./chunk-V43EQ6VR.js";
@@ -466,4 +466,4 @@ export {
   detectLang,
   parseSymbols
 };
-//# sourceMappingURL=go-parser-JXYKJHRC.js.map
+//# sourceMappingURL=go-parser-IKHW67WE.js.map

package/dist/grep.js

@@ -1,10 +1,10 @@
 import {
   __resetRgDetectionForTests,
   grepTool
-} from "./chunk-553IQUMO.js";
+} from "./chunk-EOOFNYIT.js";
 import "./chunk-Q5JPPCZC.js";
-import "./chunk-U4D5S3VQ.js";
-import "./chunk-LIJQMYYX.js";
+import "./chunk-NWZ6XGBJ.js";
+import "./chunk-DTQ75VBC.js";
 import "./chunk-D33S4RQG.js";
 export {
   __resetRgDetectionForTests,