grepmax 0.26.57 → 0.26.58

package/dist/lib/daemon/paused-reads.js

@@ -0,0 +1,155 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DaemonPausedError = exports.PAUSED_CACHE_OPTIONS = exports.PAUSED_RESULT_LIMIT = exports.PAUSED_QUERY_TIMEOUT_MS = void 0;
+exports.isPausedRead = isPausedRead;
+exports.validatePausedRead = validatePausedRead;
+exports.searchPausedIndex = searchPausedIndex;
+const intent_1 = require("../search/intent");
+const per_file_1 = require("../search/per-file");
+const searcher_1 = require("../search/searcher");
+const arrow_1 = require("../utils/arrow");
+const query_timeout_1 = require("../utils/query-timeout");
+const rows_handler_1 = require("./rows-handler");
+exports.PAUSED_QUERY_TIMEOUT_MS = 2000;
+exports.PAUSED_RESULT_LIMIT = 20;
+exports.PAUSED_CACHE_OPTIONS = {
+    readOnly: true,
+    indexCacheMb: 32,
+    metadataCacheMb: 16,
+};
+class DaemonPausedError extends Error {
+    constructor(reason) {
+        super(`gmax is serving bounded reads; indexing and heavy work are paused: ${reason}`);
+        this.code = "DAEMON_PAUSED";
+        this.name = "DaemonPausedError";
+    }
+}
+exports.DaemonPausedError = DaemonPausedError;
+function isPausedRead(name) {
+    return [
+        "keyword-search",
+        "rows.locate",
+        "rows.skeleton",
+        "graph.resolve",
+        "unwatch",
+        "llm-stop",
+    ].includes(name);
+}
+/** Refuse oversized requests rather than silently truncating exact lookups. */
+function validatePausedRead(name, payload) {
+    if (!isPausedRead(name))
+        throw new DaemonPausedError(`${name} needs the full service`);
+    if (name === "graph.resolve" &&
+        (typeof payload.target !== "string" ||
+            payload.target.length > 4096 ||
+            !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(payload.target)))
+        throw new DaemonPausedError("file-wide symbol enumeration is paused; use an exact symbol or bounded file lookup");
+    if (name === "rows.skeleton" && typeof payload.path !== "string")
+        throw new DaemonPausedError("paused skeleton lookup requires an exact file path");
+    if (name !== "rows.locate")
+        return;
+    const matches = Array.isArray(payload.matches) ? payload.matches : [];
+    const limit = payload.limit === undefined ? exports.PAUSED_RESULT_LIMIT : Number(payload.limit);
+    if (matches.length > 4 ||
+        !Number.isInteger(limit) ||
+        limit < 1 ||
+        limit > exports.PAUSED_RESULT_LIMIT ||
+        payload.scoped === false ||
+        matches.some((m) => !m ||
+            !["definedSymbol", "path"].includes(String(m.kind)))) {
+        throw new DaemonPausedError("use at most four scoped symbol/file lookups with a limit of 20");
+    }
+}
+/** Existing FTS only: no embedding, vector columns, rebuild or scan fallback. */
+function searchPausedIndex(db, payload, reason, signal) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+        signal.throwIfAborted();
+        const root = (0, rows_handler_1.assertReadableProject)(payload.projectRoot);
+        for (const candidate of (_c = (_a = payload.filters) === null || _a === void 0 ? void 0 : _a.projectRoots) !== null && _c !== void 0 ? _c : [root])
+            (0, rows_handler_1.assertReadableProject)(candidate);
+        if (payload.query.length > 4096)
+            throw new DaemonPausedError("query exceeds 4096 characters");
+        const requestedLimit = (_d = payload.limit) !== null && _d !== void 0 ? _d : 10;
+        if (!Number.isInteger(requestedLimit) || requestedLimit < 1)
+            throw new Error("invalid limit");
+        const limit = Math.min(requestedLimit, exports.PAUSED_RESULT_LIMIT);
+        const maxPerFile = (0, per_file_1.validateMaxPerFile)(payload.maxPerFile);
+        yield db.adoptFTSIndex();
+        signal.throwIfAborted();
+        const table = yield db.ensureTable();
+        const prefix = (_e = payload.pathPrefix) !== null && _e !== void 0 ? _e : `${root.replace(/\/$/, "")}/`;
+        const where = (0, searcher_1.buildWhereClause)(((_b = payload.filters) === null || _b === void 0 ? void 0 : _b.projectRoots) ? undefined : prefix, payload.filters, (0, intent_1.detectIntent)(payload.query));
+        let query = table
+            .search(payload.query)
+            .fastSearch()
+            .select([
+            "path",
+            "hash",
+            "content",
+            "start_line",
+            "end_line",
+            "chunk_index",
+            "role",
+            "defined_symbols",
+            "parent_symbol",
+            "_score",
+        ])
+            .limit(exports.PAUSED_RESULT_LIMIT);
+        if (where)
+            query = query.where(where);
+        const rows = yield (0, query_timeout_1.withQueryTimeout)(query.toArray({ timeoutMs: exports.PAUSED_QUERY_TIMEOUT_MS }), "paused keyword search", exports.PAUSED_QUERY_TIMEOUT_MS);
+        signal.throwIfAborted();
+        const data = [];
+        const counts = new Map();
+        const best = Math.max(1, ...rows.map((r) => Number(r._score) || 0));
+        for (const row of rows) {
+            const path = String((_f = row.path) !== null && _f !== void 0 ? _f : "");
+            const count = (_g = counts.get(path)) !== null && _g !== void 0 ? _g : 0;
+            if (maxPerFile !== undefined && count >= maxPerFile)
+                continue;
+            counts.set(path, count + 1);
+            data.push({
+                type: "text",
+                text: String((_h = row.content) !== null && _h !== void 0 ? _h : "").slice(0, 8192),
+                score: (Number(row._score) || 0) / best,
+                metadata: { path, hash: String((_j = row.hash) !== null && _j !== void 0 ? _j : "") },
+                generated_metadata: {
+                    start_line: Number((_k = row.start_line) !== null && _k !== void 0 ? _k : 0),
+                    end_line: Number((_l = row.end_line) !== null && _l !== void 0 ? _l : 0),
+                },
+                chunk_index: Number((_m = row.chunk_index) !== null && _m !== void 0 ? _m : 0),
+                role: String((_o = row.role) !== null && _o !== void 0 ? _o : ""),
+                parent_symbol: String((_p = row.parent_symbol) !== null && _p !== void 0 ? _p : ""),
+                defined_symbols: (0, arrow_1.toArr)(row.defined_symbols).filter((s) => typeof s === "string"),
+            });
+            if (data.length >= limit)
+                break;
+        }
+        return {
+            ok: true,
+            data,
+            warnings: [
+                `Keyword search only; embeddings and indexing are paused: ${reason}. Results use the retained FTS index and keyword scores; unindexed rows are excluded.`,
+                ...(requestedLimit > limit
+                    ? [`Paused search is limited to ${limit} results.`]
+                    : []),
+                ...(payload.includeGraph || payload.includeSkeletons
+                    ? [
+                        "Inline graph/skeleton enrichment is paused; use bounded file lookups.",
+                    ]
+                    : []),
+            ],
+        };
+    });
+}

package/dist/lib/daemon/rows-handler.js

@@ -440,7 +440,7 @@ function normalizeRow(row, select) {
 /** Run a batch of row selects, one result array per matcher, order preserved. */
 function runLocate(deps, req) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
+        var _a, _b, _c;
         const table = yield tableOf(deps);
         const scoped = req.scoped !== false;
         const pathScope = (0, scope_filter_1.buildScopeWhere)(req.scope);
@@ -452,9 +452,11 @@ function runLocate(deps, req) {
                 .select(req.select)
                 .where(scoped ? `${where} AND ${pathScope}` : where);
             query = query.limit((_a = req.limit) !== null && _a !== void 0 ? _a : exports.MAX_LOCATE_ROWS);
-            const rows = yield (0, query_timeout_2.withQueryTimeout)(query.toArray(query_timeout_1.QUERY_EXECUTION_OPTIONS), label);
+            const rows = yield (0, query_timeout_2.withQueryTimeout)(query.toArray({
+                timeoutMs: (_b = deps.queryTimeoutMs) !== null && _b !== void 0 ? _b : query_timeout_1.QUERY_EXECUTION_OPTIONS.timeoutMs,
+            }), label, deps.queryTimeoutMs);
             results.push(rows
-                .slice(0, (_b = req.limit) !== null && _b !== void 0 ? _b : exports.MAX_LOCATE_ROWS)
+                .slice(0, (_c = req.limit) !== null && _c !== void 0 ? _c : exports.MAX_LOCATE_ROWS)
                 .map((row) => normalizeRow(row, req.select)));
         }
         return results;
@@ -525,23 +527,27 @@ function runSkeleton(deps, req) {
         const db = deps.vectorDb;
         let filePath = (_b = req.path) !== null && _b !== void 0 ? _b : null;
         if (!filePath && req.symbol) {
-            filePath = yield findFileBySymbol(db, req.symbol, req.projectRoot);
+            filePath = yield findFileBySymbol(db, req.symbol, req.projectRoot, deps.queryTimeoutMs);
         }
         if (!filePath)
             return { path: null, skeleton: null };
-        return { path: filePath, skeleton: yield (0, retriever_1.getStoredSkeleton)(db, filePath) };
+        return {
+            path: filePath,
+            skeleton: yield (0, retriever_1.getStoredSkeleton)(db, filePath, deps.queryTimeoutMs),
+        };
     });
 }
 /** FTS lookup for the file that defines `symbol`; null when nothing matches. */
-function findFileBySymbol(db, symbol, projectRoot) {
-    return __awaiter(this, void 0, void 0, function* () {
+function findFileBySymbol(db_1, symbol_1, projectRoot_1) {
+    return __awaiter(this, arguments, void 0, function* (db, symbol, projectRoot, timeoutMs = query_timeout_1.QUERY_EXECUTION_OPTIONS.timeoutMs) {
         try {
             const table = yield db.ensureTable();
             const results = yield table
                 .search(symbol)
+                .select(["path", "defined_symbols"])
                 .where((0, filter_builder_1.pathStartsWith)(`${projectRoot}/`))
                 .limit(10)
-                .toArray(query_timeout_1.QUERY_EXECUTION_OPTIONS);
+                .toArray({ timeoutMs });
             for (const result of results) {
                 const defined = result.defined_symbols;
                 if ((0, arrow_1.toArr)(defined).includes(symbol)) {

package/dist/lib/skeleton/retriever.js

@@ -12,8 +12,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStoredSkeleton = getStoredSkeleton;
 const filter_builder_1 = require("../utils/filter-builder");
 const query_timeout_1 = require("../utils/query-timeout");
-function getStoredSkeleton(db, filePath) {
-    return __awaiter(this, void 0, void 0, function* () {
+function getStoredSkeleton(db_1, filePath_1) {
+    return __awaiter(this, arguments, void 0, function* (db, filePath, timeoutMs = query_timeout_1.QUERY_EXECUTION_OPTIONS.timeoutMs) {
         try {
             const table = yield db.ensureTable();
             // LanceDB query
@@ -22,7 +22,7 @@ function getStoredSkeleton(db, filePath) {
                 .select(["file_skeleton"])
                 .where(`path = '${(0, filter_builder_1.escapeSqlString)(filePath)}' AND is_anchor = true`)
                 .limit(1)
-                .toArray(query_timeout_1.QUERY_EXECUTION_OPTIONS);
+                .toArray({ timeoutMs });
             if (results.length > 0) {
                 const skel = results[0].file_skeleton;
                 if (typeof skel === "string" && skel.length > 0) {

package/dist/lib/store/vector-db.js

@@ -213,14 +213,16 @@ function envMb(name, fallback) {
     const parsed = Number(process.env[name]);
     return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
 }
-function createLanceSession() {
+function createLanceSession(options = {}) {
+    var _a, _b;
     const mb = (n) => BigInt(n * 1024 * 1024);
-    return new lancedb.Session(mb(LANCE_INDEX_CACHE_MB), mb(LANCE_METADATA_CACHE_MB));
+    return new lancedb.Session(mb((_a = options.indexCacheMb) !== null && _a !== void 0 ? _a : LANCE_INDEX_CACHE_MB), mb((_b = options.metadataCacheMb) !== null && _b !== void 0 ? _b : LANCE_METADATA_CACHE_MB));
 }
 class VectorDB {
-    constructor(lancedbDir, vectorDim, suppliedLease) {
+    constructor(lancedbDir, vectorDim, suppliedLease, options = {}) {
         this.lancedbDir = lancedbDir;
         this.suppliedLease = suppliedLease;
+        this.options = options;
         this.db = null;
         this.session = null;
         this.closed = false;
@@ -270,6 +272,11 @@ class VectorDB {
         this.vectorDim = vectorDim !== null && vectorDim !== void 0 ? vectorDim : (0, index_config_1.readGlobalConfig)().vectorDim;
         this.unregisterCleanup = (0, cleanup_1.registerCleanup)(() => this.close());
     }
+    assertMutationAllowed() {
+        if (this.options.readOnly)
+            throw new Error("gmax store is read-only");
+        (0, maintenance_policy_1.assertStoreMutationAllowed)();
+    }
     /**
      * Start a periodic maintenance timer (FTS rebuild + optimize).
      * Call once from the daemon — replaces per-processor maintenance intervals.
@@ -372,7 +379,7 @@ class VectorDB {
             }
             const creatingStore = !fs.existsSync(this.lancedbDir);
             if (creatingStore) {
-                (0, maintenance_policy_1.assertStoreMutationAllowed)();
+                this.assertMutationAllowed();
                 (0, maintenance_policy_1.assertFreshDiskMutationAllowed)(this.lancedbDir);
             }
             yield this.getLease();
@@ -381,11 +388,11 @@ class VectorDB {
             }
             if (!this.db) {
                 if (creatingStore || !fs.existsSync(this.lancedbDir)) {
-                    (0, maintenance_policy_1.assertStoreMutationAllowed)();
+                    this.assertMutationAllowed();
                     (0, maintenance_policy_1.assertFreshDiskMutationAllowed)(this.lancedbDir);
                 }
                 fs.mkdirSync(this.lancedbDir, { recursive: true });
-                this.session = createLanceSession();
+                this.session = createLanceSession(this.options);
                 // 0.38 accepts the legacy third argument in its types but drops it in
                 // the JS wrapper. Put the session in native ConnectionOptions instead.
                 this.db = yield lancedb.connect(this.lancedbDir, {
@@ -430,6 +437,7 @@ class VectorDB {
     /** Upgrade and retain this instance's current lease for transfer to a new DB. */
     upgradeStoreLease(signal) {
         return __awaiter(this, void 0, void 0, function* () {
+            this.assertMutationAllowed();
             if (this.closed)
                 throw new Error("VectorDB connection is closed");
             if (this.exclusiveMutationPromise)
@@ -526,7 +534,7 @@ class VectorDB {
      */
     withWriteGate(fn) {
         return __awaiter(this, void 0, void 0, function* () {
-            (0, maintenance_policy_1.assertStoreMutationAllowed)();
+            this.assertMutationAllowed();
             this.ensureDiskOk();
             while (this.exclusiveMutationPromise || this.compactingPromise) {
                 if (this.closed)
@@ -535,7 +543,7 @@ class VectorDB {
             }
             if (this.closed)
                 throw new Error("VectorDB connection is closed");
-            (0, maintenance_policy_1.assertStoreMutationAllowed)();
+            this.assertMutationAllowed();
             this.ensureDiskOk();
             this.activeWrites++;
             try {
@@ -575,7 +583,7 @@ class VectorDB {
     }
     withExclusiveTableMutation(mutation) {
         return __awaiter(this, void 0, void 0, function* () {
-            (0, maintenance_policy_1.assertStoreMutationAllowed)();
+            this.assertMutationAllowed();
             this.ensureDiskOk();
             if (this.closed)
                 throw new Error("VectorDB connection is closed");
@@ -602,7 +610,7 @@ class VectorDB {
                             });
                         }
                         yield Promise.all([this.drainWrites(), this.drainCompactions()]);
-                        (0, maintenance_policy_1.assertStoreMutationAllowed)();
+                        this.assertMutationAllowed();
                         this.ensureDiskOk();
                         const db = yield this.getDb();
                         const result = yield mutation(db);
@@ -773,7 +781,8 @@ class VectorDB {
     }
     ensureTable() {
         return __awaiter(this, void 0, void 0, function* () {
-            if ((0, maintenance_policy_1.storeMutationDeniedReason)() !== null ||
+            if (this.options.readOnly ||
+                (0, maintenance_policy_1.storeMutationDeniedReason)() !== null ||
                 this.checkDiskPressure(true) === "critical") {
                 const existing = yield this.openExistingTableUnsafe();
                 if (!existing)
@@ -794,7 +803,7 @@ class VectorDB {
             catch (err) {
                 if (!isMissingTableError(err))
                     throw err;
-                (0, maintenance_policy_1.assertStoreMutationAllowed)();
+                this.assertMutationAllowed();
                 (0, logger_1.log)("db", `Creating table (${this.vectorDim}d)`);
                 const schema = this.buildSchema();
                 table = yield db.createTable(TABLE_NAME, [this.seedRow()], {
@@ -805,7 +814,7 @@ class VectorDB {
                 return table;
             }
             yield this.validateSchema(table);
-            (0, maintenance_policy_1.assertStoreMutationAllowed)();
+            this.assertMutationAllowed();
             yield this.evolveSchema(table);
             return table;
         });
@@ -944,7 +953,7 @@ class VectorDB {
     }
     /** Whether this instance may create or rebuild shared indexes. */
     canBuildIndexes() {
-        return this.indexOwner;
+        return this.indexOwner && !this.options.readOnly;
     }
     /**
      * Adopt the FTS index if one already exists, without ever building it.

package/dist/lib/utils/daemon-launcher.js

@@ -92,14 +92,19 @@ function spawnDaemon() {
  * spawn fails.
  */
 function spawnDaemonProcess() {
-    return __awaiter(this, void 0, void 0, function* () {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
         const denied = (0, autostart_1.daemonStartDeniedReason)();
-        if (denied !== null)
+        if (denied !== null && !options.readOnly)
             throw new Error(`gmax: ${denied}`);
         const logFile = path.join(config_1.PATHS.logsDir, "daemon.log");
         const out = (0, log_rotate_1.openRotatedLog)(logFile);
         try {
-            const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "watch", "--daemon"], {
+            const child = (0, node_child_process_1.spawn)(process.argv[0], [
+                process.argv[1],
+                "watch",
+                "--daemon",
+                ...(options.readOnly ? ["--read-only"] : []),
+            ], {
                 detached: true,
                 stdio: ["ignore", out, out],
                 cwd: process.cwd(),

package/dist/lib/utils/operation-coordinator.js

@@ -122,6 +122,12 @@ class OperationCoordinator {
         void task.then(cleanup, cleanup);
         return task;
     }
+    /** Cancel existing work without closing admission for subsequent bounded reads. */
+    abortAndDrain(reason) {
+        for (const controller of this.controllers)
+            controller.abort(reason);
+        return Promise.allSettled([...this.activeTasks]).then(() => { });
+    }
     close(reason = new OperationClosedError()) {
         if (this.closePromise)
             return this.closePromise;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.26.57",
+  "version": "0.26.58",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.26.57",
+  "version": "0.26.58",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",