sensemaking 0.7.2 → 0.8.0

package/dist/cjs/{verbs.js → commands.js}

@@ -19,6 +19,8 @@ _export(exports, {
         return peek;
     }
 });
+var _nodefs = require("node:fs");
+var _nodepath = require("node:path");
 var _posix = /*#__PURE__*/ _interop_require_default(require("node:path/posix"));
 var _configts = require("./config.js");
 var _errorsts = require("./errors.js");
@@ -217,13 +219,153 @@ function _ts_generator(thisArg, body) {
         };
     }
 }
-// The three layer verbs: mapTree (orient), find (locate), peek (structure).
+// The three layer commands: mapTree (orient), find (locate), peek (structure).
 // Each returns data; cli.ts renders. All of them degrade when a feature is off.
 var WEIGHTED_BM25 = 'bm25(content, 10.0, 5.0, 1.0)';
 var RRF_K = 60;
+// FTS5 snippet() re-tokenizes the whole doc per candidate row, superlinearly: measured
+// 2ms at 4KB docs but 189ms at 64KB for one query's pool, and ~10s for a single 1MB doc
+// (plans/performance-findings.md finding A). 16KB keeps the whole pool's snippet cost in
+// the low-ms range; bigger docs get the JS-computed excerpt, linear and only for the rows
+// actually returned.
+var SNIPPET_BOUND = 16384;
+var EXCERPT_WINDOW = 160;
+// Bare terms from an FTS5 query string: strips operators/quoting so the oversized-doc excerpt
+// scan matches the same words the query matched on, not FTS5 syntax.
+function extractBareTerms(query) {
+    var cleaned = query.replace(/"/g, ' ').replace(/[()*]/g, ' ').replace(/\b(AND|OR|NOT|NEAR)\b(\/\d+)?/gi, ' ');
+    return cleaned.split(/\s+/).map(function(tok) {
+        return tok.replace(/^[A-Za-z_]\w*:/, '');
+    }) // column filter, e.g. title:term
+    .map(function(tok) {
+        return tok.toLowerCase().trim();
+    }).filter(function(tok) {
+        return tok.length > 0;
+    });
+}
+function findOccurrences(haystackLower, terms) {
+    var occ = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = terms[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var term = _step.value;
+            var idx = 0;
+            for(;;){
+                var found = haystackLower.indexOf(term, idx);
+                if (found === -1) break;
+                occ.push({
+                    start: found,
+                    end: found + term.length,
+                    term: term
+                });
+                idx = found + term.length;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    // Longest span first at equal start, so "tests" beats its substring "test" and the
+    // whole word gets highlighted; the emit loop then absorbs the shorter overlap.
+    return occ.sort(function(a, b) {
+        return a.start - b.start || b.end - a.end;
+    });
+}
+// Slides a window over the sorted occurrences, same semantics as FTS5's own best-window
+// pick: most distinct terms, ties broken by most total hits.
+function bestWindowStart(occ, windowSize) {
+    var best = occ[0].start;
+    var bestDistinct = 0;
+    var bestCount = 0;
+    for(var i = 0; i < occ.length; i++){
+        var winEnd = occ[i].start + windowSize;
+        var seen = new Set();
+        var count = 0;
+        for(var j = i; j < occ.length && occ[j].start < winEnd; j++){
+            seen.add(occ[j].term);
+            count++;
+        }
+        if (seen.size > bestDistinct || seen.size === bestDistinct && count > bestCount) {
+            best = occ[i].start;
+            bestDistinct = seen.size;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+// snippet()-shaped excerpt: matched terms wrapped in «», … at cut edges. Linear in doc
+// length, only run for rows actually returned (<= k), unlike snippet()'s per-row cost.
+function computeExcerpt(text, terms) {
+    var occ = findOccurrences(text.toLowerCase(), terms);
+    if (occ.length === 0) {
+        // This is a raw substring scan, not porter-stemmed: a doc matched only through a
+        // stemmed variant (query "negotiate" vs doc "negotiating") finds no occurrence here.
+        // Fall back to the doc's start, unmarked, rather than claim a match that isn't there.
+        var end = Math.min(text.length, EXCERPT_WINDOW);
+        return {
+            excerpt: "".concat(text.slice(0, end).replace(/\s+/g, ' ').trim()).concat(end < text.length ? '…' : ''),
+            offset: 0
+        };
+    }
+    var start = bestWindowStart(occ, EXCERPT_WINDOW);
+    var end1 = Math.min(text.length, start + EXCERPT_WINDOW);
+    var out = '';
+    var cursor = start;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = occ[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var o = _step.value;
+            if (o.start < start || o.end > end1) continue;
+            // Occurrences of duplicate or substring-overlapping terms ("test tests") can overlap;
+            // emitting each would duplicate document text. Keep the first, absorb the rest.
+            if (o.start < cursor) continue;
+            out += "".concat(text.slice(cursor, o.start), "\xab").concat(text.slice(o.start, o.end), "\xbb");
+            cursor = o.end;
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    out += text.slice(cursor, end1);
+    var prefix = start > 0 ? '…' : '';
+    var suffix = end1 < text.length ? '…' : '';
+    return {
+        excerpt: "".concat(prefix).concat(out.replace(/\s+/g, ' ')).concat(suffix),
+        offset: start
+    };
+}
+function lineNumberAt(text, offset) {
+    var line = 1;
+    for(var i = 0; i < offset; i++)if (text.charCodeAt(i) === 10) line++;
+    return line;
+}
+function lineRangeFor(db, path, line) {
+    var row = db.prepare('SELECT start_line, end_line FROM sections WHERE "path" = ? AND start_line <= ? AND end_line >= ? ORDER BY start_line DESC LIMIT 1').get(path, line, line);
+    return row ? "L".concat(row.start_line, "-").concat(row.end_line) : null;
+}
 function find(_0, _1, _2) {
     return _async_to_generator(function(db, cfg, terms) {
-        var opts, _opts_k, _opts_where, _hits_get, _chunkLines_get, _chunkSimilarity_get, _cfg_defaults_find, _cfg_defaults, k, fetch, scope, whereJoin, whereCond, matchSql, matchRows, hits, candidates, edges, linked, nodes, seeds, ranked, chunkLines, chunkSimilarity, vec, insert, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, path, c, where, linesCol;
+        var opts, _opts_k, _opts_where, _hits_get, _chunkLines_get, _chunkSimilarity_get, _cfg_defaults_find, _cfg_defaults, k, fetch, scope, whereJoin, whereCond, matchSql, matchRows, hits, oversized, candidates, edges, linked, nodes, seeds, ranked, chunkLines, chunkSimilarity, vec, insert, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, path, c, where, similarityCol, rows, bareTerms, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, row, text, _computeExcerpt, excerpt, offset;
         var _arguments = arguments;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
@@ -240,7 +382,9 @@ function find(_0, _1, _2) {
                     scope = (_opts_where = opts.where) !== null && _opts_where !== void 0 ? _opts_where : (_cfg_defaults = cfg.defaults) === null || _cfg_defaults === void 0 ? void 0 : (_cfg_defaults_find = _cfg_defaults.find) === null || _cfg_defaults_find === void 0 ? void 0 : _cfg_defaults_find.where;
                     whereJoin = scope ? 'JOIN frontmatter f ON f."path" = content.path' : '';
                     whereCond = scope ? "AND (".concat(scope, ")") : '';
-                    matchSql = "SELECT content.path AS path, snippet(content, -1, '\xab', '\xbb', '…', 10) AS hit FROM content ".concat(whereJoin, " WHERE content MATCH ? ").concat(whereCond, " ORDER BY ").concat(WEIGHTED_BM25, " LIMIT ").concat(fetch);
+                    // Docs past SNIPPET_BOUND skip snippet() entirely -- SQLite
+                    // short-circuits the untaken CASE branch, so it's never invoked on them.
+                    matchSql = "SELECT content.path AS path, CASE WHEN length(content.text) <= ".concat(SNIPPET_BOUND, " THEN snippet(content, -1, '\xab', '\xbb', '…', 10) ELSE NULL END AS hit FROM content ").concat(whereJoin, " WHERE content MATCH ? ").concat(whereCond, " ORDER BY ").concat(WEIGHTED_BM25, " LIMIT ").concat(fetch);
                     try {
                         matchRows = db.prepare(matchSql).all(terms);
                     } catch (err) {
@@ -252,6 +396,13 @@ function find(_0, _1, _2) {
                             r.hit
                         ];
                     }));
+                    // hit === null here means the bound suppressed snippet(), not "no match" -- distinguish
+                    // from via='link' rows (never in matchRows, so absent from this set) below.
+                    oversized = new Set(matchRows.filter(function(r) {
+                        return r.hit === null;
+                    }).map(function(r) {
+                        return r.path;
+                    }));
                     candidates = new Map();
                     matchRows.forEach(function(r, i) {
                         candidates.set(r.path, {
@@ -350,10 +501,45 @@ function find(_0, _1, _2) {
                         }
                     }
                     where = scope ? "WHERE ".concat(scope) : '';
-                    linesCol = opts.semantic ? ', _find.lines, _find.similarity' : '';
+                    // lines is always present now: semantic rows carry their chunk's range, oversized-doc
+                    // lexical rows gain one below, everything else stays null. similarity stays semantic-only.
+                    similarityCol = opts.semantic ? ', _find.similarity' : '';
+                    rows = db.prepare('SELECT f."path" AS path, content.title, content.summary, _find.hit, _find.via, round(_find.score, 4) AS score, _find.lines'.concat(similarityCol, '\n       FROM _find JOIN frontmatter f ON f."path" = _find."path" JOIN content ON content.path = _find."path"\n       ').concat(where, " ORDER BY _find.score DESC LIMIT ?")).all(k);
+                    if (oversized.size > 0) {
+                        bareTerms = extractBareTerms(terms);
+                        _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                        try {
+                            for(_iterator1 = rows[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                                row = _step1.value;
+                                if (row.hit !== null || !oversized.has(row.path)) continue;
+                                text = void 0;
+                                try {
+                                    text = (0, _nodefs.readFileSync)((0, _nodepath.join)(cfg.baseDir, row.path), 'utf8');
+                                } catch (unused) {
+                                    continue; // vanished since the match; leave hit/lines null rather than throw
+                                }
+                                _computeExcerpt = computeExcerpt(text, bareTerms), excerpt = _computeExcerpt.excerpt, offset = _computeExcerpt.offset;
+                                row.hit = excerpt;
+                                if (row.lines == null) row.lines = (0, _configts.featureEnabled)(cfg, 'sections') ? lineRangeFor(db, row.path, lineNumberAt(text, offset)) : null;
+                            }
+                        } catch (err) {
+                            _didIteratorError1 = true;
+                            _iteratorError1 = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                    _iterator1.return();
+                                }
+                            } finally{
+                                if (_didIteratorError1) {
+                                    throw _iteratorError1;
+                                }
+                            }
+                        }
+                    }
                     return [
                         2,
-                        db.prepare('SELECT f."path" AS path, content.title, content.summary, _find.hit, _find.via, round(_find.score, 4) AS score'.concat(linesCol, '\n       FROM _find JOIN frontmatter f ON f."path" = _find."path" JOIN content ON content.path = _find."path"\n       ').concat(where, " ORDER BY _find.score DESC LIMIT ?")).all(k)
+                        rows
                     ];
             }
         });
@@ -365,6 +551,14 @@ var INTERNAL_COLUMNS = new Set([
     '_size',
     '_rank'
 ]);
+// A result row is capped at SQLITE_MAX_COLUMN (2000, default); two aggregate expressions
+// per field keeps a chunk's row safely under that regardless of how many fields the tree has.
+var MAP_COLUMN_CHUNK = 300;
+function chunk(items, size) {
+    var out = [];
+    for(var i = 0; i < items.length; i += size)out.push(items.slice(i, i + size));
+    return out;
+}
 function mapTree(db, cfg) {
     var docs = db.prepare('SELECT COUNT(*) AS count, COALESCE(SUM("_size"), 0) AS bytes FROM frontmatter').get();
     var columns = db.prepare('PRAGMA table_info(frontmatter)').all().map(function(r) {
@@ -372,18 +566,47 @@ function mapTree(db, cfg) {
     }).filter(function(name) {
         return !INTERNAL_COLUMNS.has(name);
     });
-    var allFields = columns.map(function(name) {
-        var quoted = '"'.concat(name.split('"').join('""'), '"');
-        // Observed storage class, not a declared one: these columns are added dynamically and
-        // SQLite types per value, so a field can be text in most notes and numeric in a few.
-        // Listing every distinct type makes both the type and any drift visible.
-        var _db_prepare_get = db.prepare("SELECT COUNT(".concat(quoted, ") AS n, GROUP_CONCAT(DISTINCT typeof(").concat(quoted, ")) AS types FROM frontmatter WHERE ").concat(quoted, " IS NOT NULL")).get(), n = _db_prepare_get.n, types = _db_prepare_get.types;
-        return {
-            field: name,
-            coverage: n,
-            type: types !== null && types !== void 0 ? types : ''
+    // Observed storage class, not a declared one: these columns are added dynamically and
+    // SQLite types per value, so a field can be text in most notes and numeric in a few.
+    // Listing every distinct type makes both the type and any drift visible.
+    // One aggregate scan per chunk of columns rather than one scan per column: COUNT already
+    // ignores NULL, and FILTER keeps typeof() looking only at the non-null rows COUNT counted,
+    // matching the old per-column `WHERE ... IS NOT NULL` exactly.
+    var allFields = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        var _loop = function() {
+            var group = _step.value;
+            var exprs = group.map(function(name, i) {
+                var quoted = '"'.concat(name.split('"').join('""'), '"');
+                return "COUNT(".concat(quoted, ") AS n").concat(i, ", GROUP_CONCAT(DISTINCT typeof(").concat(quoted, ")) FILTER (WHERE ").concat(quoted, " IS NOT NULL) AS t").concat(i);
+            });
+            var result = db.prepare("SELECT ".concat(exprs.join(', '), " FROM frontmatter")).get();
+            group.forEach(function(name, i) {
+                var _result_;
+                return allFields.push({
+                    field: name,
+                    coverage: result["n".concat(i)],
+                    type: (_result_ = result["t".concat(i)]) !== null && _result_ !== void 0 ? _result_ : ''
+                });
+            });
         };
-    }).sort(function(a, b) {
+        for(var _iterator = chunk(columns, MAP_COLUMN_CHUNK)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    allFields.sort(function(a, b) {
         return b.coverage - a.coverage;
     });
     var fields = allFields.slice(0, 20);
@@ -398,7 +621,7 @@ function mapTree(db, cfg) {
         recent: recent
     };
 }
-var PEEK_LINK_LIMIT = 20;
+var PEEK_LIST_LIMIT = 20;
 function peek(db, cfg, pathArg) {
     var _row__size;
     var paths = db.prepare('SELECT "path" FROM frontmatter').all().map(function(r) {
@@ -438,7 +661,8 @@ function peek(db, cfg, pathArg) {
             }
         }
     }
-    var sections = (0, _configts.featureEnabled)(cfg, 'sections') ? db.prepare('SELECT level, heading, start_line, end_line, tokens FROM sections WHERE "path" = ? ORDER BY idx').all(path) : [];
+    var sectionsTotal = (0, _configts.featureEnabled)(cfg, 'sections') ? db.prepare('SELECT COUNT(*) AS n FROM sections WHERE "path" = ?').get(path).n : 0;
+    var sections = (0, _configts.featureEnabled)(cfg, 'sections') ? db.prepare('SELECT level, heading, start_line, end_line, tokens FROM sections WHERE "path" = ? ORDER BY idx LIMIT ?').all(path, PEEK_LIST_LIMIT) : [];
     var outbound = [];
     var backlinks = [];
     var unresolved = [];
@@ -456,7 +680,7 @@ function peek(db, cfg, pathArg) {
             return l.target;
         });
         backlinksTotal = db.prepare('SELECT COUNT(DISTINCT src) AS n FROM links WHERE dst = ?').get(path).n;
-        backlinks = db.prepare('SELECT DISTINCT src FROM links WHERE dst = ? ORDER BY src LIMIT ?').all(path, PEEK_LINK_LIMIT).map(function(r) {
+        backlinks = db.prepare('SELECT DISTINCT src FROM links WHERE dst = ? ORDER BY src LIMIT ?').all(path, PEEK_LIST_LIMIT).map(function(r) {
             return r.src;
         });
     }
@@ -465,9 +689,10 @@ function peek(db, cfg, pathArg) {
         tokens: Math.ceil(((_row__size = row._size) !== null && _row__size !== void 0 ? _row__size : 0) / 4),
         frontmatter: frontmatter,
         sections: sections,
-        outbound: outbound.slice(0, PEEK_LINK_LIMIT),
+        outbound: outbound.slice(0, PEEK_LIST_LIMIT),
         backlinks: backlinks,
-        unresolved: unresolved.slice(0, PEEK_LINK_LIMIT),
+        unresolved: unresolved.slice(0, PEEK_LIST_LIMIT),
+        sectionsTotal: sectionsTotal,
         outboundTotal: outbound.length,
         backlinksTotal: backlinksTotal,
         unresolvedTotal: unresolved.length,

package/dist/cjs/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/commands.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport posix from 'node:path/posix';\nimport type { DatabaseSync } from 'node:sqlite';\nimport type { FeatureName, ResolvedConfig } from './config.ts';\nimport { featureEnabled, featureStates } from './config.ts';\nimport { SenseError } from './errors.ts';\nimport { semanticCandidates } from './features/embed.ts';\nimport { linkEdges } from './features/index.ts';\nimport { personalizedRank } from './graph.ts';\nimport type { Row } from './output.ts';\nimport { searchError } from './search-error.ts';\n\n// The three layer commands: mapTree (orient), find (locate), peek (structure).\n// Each returns data; cli.ts renders. All of them degrade when a feature is off.\n\nconst WEIGHTED_BM25 = 'bm25(content, 10.0, 5.0, 1.0)';\nconst RRF_K = 60;\n\n// FTS5 snippet() re-tokenizes the whole doc per candidate row, superlinearly: measured\n// 2ms at 4KB docs but 189ms at 64KB for one query's pool, and ~10s for a single 1MB doc\n// (plans/performance-findings.md finding A). 16KB keeps the whole pool's snippet cost in\n// the low-ms range; bigger docs get the JS-computed excerpt, linear and only for the rows\n// actually returned.\nconst SNIPPET_BOUND = 16_384;\nconst EXCERPT_WINDOW = 160;\n\n// Bare terms from an FTS5 query string: strips operators/quoting so the oversized-doc excerpt\n// scan matches the same words the query matched on, not FTS5 syntax.\nfunction extractBareTerms(query: string): string[] {\n  const cleaned = query\n    .replace(/\"/g, ' ')\n    .replace(/[()*]/g, ' ')\n    .replace(/\\b(AND|OR|NOT|NEAR)\\b(\\/\\d+)?/gi, ' ');\n  return cleaned\n    .split(/\\s+/)\n    .map((tok) => tok.replace(/^[A-Za-z_]\\w*:/, '')) // column filter, e.g. title:term\n    .map((tok) => tok.toLowerCase().trim())\n    .filter((tok) => tok.length > 0);\n}\n\nfunction findOccurrences(haystackLower: string, terms: string[]): Array<{ start: number; end: number; term: string }> {\n  const occ: Array<{ start: number; end: number; term: string }> = [];\n  for (const term of terms) {\n    let idx = 0;\n    for (;;) {\n      const found = haystackLower.indexOf(term, idx);\n      if (found === -1) break;\n      occ.push({ start: found, end: found + term.length, term });\n      idx = found + term.length;\n    }\n  }\n  // Longest span first at equal start, so \"tests\" beats its substring \"test\" and the\n  // whole word gets highlighted; the emit loop then absorbs the shorter overlap.\n  return occ.sort((a, b) => a.start - b.start || b.end - a.end);\n}\n\n// Slides a window over the sorted occurrences, same semantics as FTS5's own best-window\n// pick: most distinct terms, ties broken by most total hits.\nfunction bestWindowStart(occ: Array<{ start: number; end: number; term: string }>, windowSize: number): number {\n  let best = occ[0].start;\n  let bestDistinct = 0;\n  let bestCount = 0;\n  for (let i = 0; i < occ.length; i++) {\n    const winEnd = occ[i].start + windowSize;\n    const seen = new Set<string>();\n    let count = 0;\n    for (let j = i; j < occ.length && occ[j].start < winEnd; j++) {\n      seen.add(occ[j].term);\n      count++;\n    }\n    if (seen.size > bestDistinct || (seen.size === bestDistinct && count > bestCount)) {\n      best = occ[i].start;\n      bestDistinct = seen.size;\n      bestCount = count;\n    }\n  }\n  return best;\n}\n\n// snippet()-shaped excerpt: matched terms wrapped in «», … at cut edges. Linear in doc\n// length, only run for rows actually returned (<= k), unlike snippet()'s per-row cost.\nfunction computeExcerpt(text: string, terms: string[]): { excerpt: string; offset: number } {\n  const occ = findOccurrences(text.toLowerCase(), terms);\n  if (occ.length === 0) {\n    // This is a raw substring scan, not porter-stemmed: a doc matched only through a\n    // stemmed variant (query \"negotiate\" vs doc \"negotiating\") finds no occurrence here.\n    // Fall back to the doc's start, unmarked, rather than claim a match that isn't there.\n    const end = Math.min(text.length, EXCERPT_WINDOW);\n    return { excerpt: `${text.slice(0, end).replace(/\\s+/g, ' ').trim()}${end < text.length ? '…' : ''}`, offset: 0 };\n  }\n  const start = bestWindowStart(occ, EXCERPT_WINDOW);\n  const end = Math.min(text.length, start + EXCERPT_WINDOW);\n  let out = '';\n  let cursor = start;\n  for (const o of occ) {\n    if (o.start < start || o.end > end) continue;\n    // Occurrences of duplicate or substring-overlapping terms (\"test tests\") can overlap;\n    // emitting each would duplicate document text. Keep the first, absorb the rest.\n    if (o.start < cursor) continue;\n    out += `${text.slice(cursor, o.start)}«${text.slice(o.start, o.end)}»`;\n    cursor = o.end;\n  }\n  out += text.slice(cursor, end);\n  const prefix = start > 0 ? '…' : '';\n  const suffix = end < text.length ? '…' : '';\n  return { excerpt: `${prefix}${out.replace(/\\s+/g, ' ')}${suffix}`, offset: start };\n}\n\nfunction lineNumberAt(text: string, offset: number): number {\n  let line = 1;\n  for (let i = 0; i < offset; i++) if (text.charCodeAt(i) === 10) line++;\n  return line;\n}\n\nfunction lineRangeFor(db: DatabaseSync, path: string, line: number): string | null {\n  const row = db.prepare('SELECT start_line, end_line FROM sections WHERE \"path\" = ? AND start_line <= ? AND end_line >= ? ORDER BY start_line DESC LIMIT 1').get(path, line, line) as { start_line: number; end_line: number } | undefined;\n  return row ? `L${row.start_line}-${row.end_line}` : null;\n}\n\nexport interface FindOptions {\n  k?: number;\n  where?: string; // SQL fragment against frontmatter alias `f`, e.g. \"f.status = 'active'\"\n  semantic?: boolean; // invoke vector expansion (requires features.embed); rows gain via 'vector' and a lines column\n}\n\n// Layer 1: BM25 + link-graph expansion, fused by reciprocal rank. `via` says which\n// signal produced each row so the agent knows what evidence it is trusting.\n// Semantic expansion is per-query opt-in: without opts.semantic the result is\n// byte-for-byte independent of the embed feature.\nexport async function find(db: DatabaseSync, cfg: ResolvedConfig, terms: string, opts: FindOptions = {}): Promise<Row[]> {\n  const k = opts.k ?? 10;\n  const fetch = Math.max(k * 3, 30);\n\n  // Terms pass verbatim to FTS5 MATCH: bare words AND-join, operators are the caller's.\n  // Invalid syntax propagates as an error, zero matches return zero -- no silent rewrites.\n  // --where applies inside the candidate query (a post-filter over the top-N would drop\n  // matches ranked past the pool) and again on the final select for link-derived rows.\n  // An explicit --where replaces the tree's declared default rather than ANDing with it,\n  // so a caller can always widen back to the whole tree.\n  const scope = opts.where ?? cfg.defaults?.find?.where;\n  const whereJoin = scope ? `JOIN frontmatter f ON f.\"path\" = content.path` : '';\n  const whereCond = scope ? `AND (${scope})` : '';\n  // Docs past SNIPPET_BOUND skip snippet() entirely -- SQLite\n  // short-circuits the untaken CASE branch, so it's never invoked on them.\n  const matchSql = `SELECT content.path AS path, CASE WHEN length(content.text) <= ${SNIPPET_BOUND} THEN snippet(content, -1, '«', '»', '…', 10) ELSE NULL END AS hit FROM content ${whereJoin} WHERE content MATCH ? ${whereCond} ORDER BY ${WEIGHTED_BM25} LIMIT ${fetch}`;\n  let matchRows: Array<{ path: string; hit: string | null }>;\n  try {\n    matchRows = db.prepare(matchSql).all(terms) as Array<{ path: string; hit: string | null }>;\n  } catch (err) {\n    throw searchError(err as Error, terms, scope);\n  }\n\n  const hits = new Map(matchRows.map((r) => [r.path, r.hit]));\n  // hit === null here means the bound suppressed snippet(), not \"no match\" -- distinguish\n  // from via='link' rows (never in matchRows, so absent from this set) below.\n  const oversized = new Set(matchRows.filter((r) => r.hit === null).map((r) => r.path));\n  const candidates = new Map<string, { score: number; via: string }>();\n  matchRows.forEach((r, i) => {\n    candidates.set(r.path, { score: 1 / (RRF_K + i), via: 'match' });\n  });\n\n  const edges = featureEnabled(cfg, 'links') && matchRows.length > 0 ? linkEdges(db) : [];\n  if (edges.length > 0) {\n    // `linked` gates the label only, not the score: PPR restart mass gives every seed a\n    // nonzero rank even without an incident edge, which is not link evidence — but dropping\n    // that mass from the score list reweights fusion toward connectivity and measurably\n    // wrecks ranking on link-dense corpora (FEVER hit@10 0.997 -> 0.907; fusion-tuning.md).\n    const linked = new Set(edges.flat());\n    const nodes = (db.prepare('SELECT \"path\" FROM frontmatter').all() as Array<{ path: string }>).map((r) => r.path);\n    const seeds = new Map(matchRows.map((r, i) => [r.path, 1 / (i + 1)]));\n    const ranked = [...personalizedRank(nodes, edges, seeds)]\n      .filter(([, score]) => score > 1e-9)\n      .sort((a, b) => b[1] - a[1])\n      .slice(0, fetch);\n    ranked.forEach(([path], i) => {\n      const existing = candidates.get(path);\n      if (existing) {\n        existing.score += 1 / (RRF_K + i);\n        if (linked.has(path)) existing.via = 'match+link';\n      } else {\n        candidates.set(path, { score: 1 / (RRF_K + i), via: 'link' });\n      }\n    });\n  }\n\n  // Vector expansion, invoked only: a third RRF list at the swept flat-region constants\n  // (weight 1, pool = fetch). Each row carries its best chunk's line range.\n  const chunkLines = new Map<string, string>();\n  const chunkSimilarity = new Map<string, number>();\n  if (opts.semantic) {\n    const vec = await semanticCandidates(db, cfg, terms, fetch);\n    vec.forEach(({ path, lines, similarity }, i) => {\n      chunkLines.set(path, lines);\n      chunkSimilarity.set(path, similarity);\n      const existing = candidates.get(path);\n      if (existing) {\n        existing.score += 1 / (RRF_K + i);\n        existing.via = `${existing.via}+vector`;\n      } else {\n        candidates.set(path, { score: 1 / (RRF_K + i), via: 'vector' });\n      }\n    });\n  }\n\n  db.exec('DROP TABLE IF EXISTS _find');\n  db.exec('CREATE TEMP TABLE _find (\"path\" TEXT PRIMARY KEY, score REAL, via TEXT, hit TEXT, lines TEXT, similarity REAL)');\n  const insert = db.prepare('INSERT INTO _find (\"path\", score, via, hit, lines, similarity) VALUES (?, ?, ?, ?, ?, ?)');\n  for (const [path, c] of candidates) insert.run(path, c.score, c.via, hits.get(path) ?? null, chunkLines.get(path) ?? null, chunkSimilarity.get(path) ?? null);\n\n  const where = scope ? `WHERE ${scope}` : '';\n  // lines is always present now: semantic rows carry their chunk's range, oversized-doc\n  // lexical rows gain one below, everything else stays null. similarity stays semantic-only.\n  const similarityCol = opts.semantic ? ', _find.similarity' : '';\n  const rows = db\n    .prepare(\n      `SELECT f.\"path\" AS path, content.title, content.summary, _find.hit, _find.via, round(_find.score, 4) AS score, _find.lines${similarityCol}\n       FROM _find JOIN frontmatter f ON f.\"path\" = _find.\"path\" JOIN content ON content.path = _find.\"path\"\n       ${where} ORDER BY _find.score DESC LIMIT ?`\n    )\n    .all(k) as Row[];\n\n  if (oversized.size > 0) {\n    const bareTerms = extractBareTerms(terms);\n    for (const row of rows) {\n      if (row.hit !== null || !oversized.has(row.path as string)) continue;\n      let text: string;\n      try {\n        text = readFileSync(join(cfg.baseDir, row.path as string), 'utf8');\n      } catch {\n        continue; // vanished since the match; leave hit/lines null rather than throw\n      }\n      const { excerpt, offset } = computeExcerpt(text, bareTerms);\n      row.hit = excerpt;\n      if (row.lines == null) row.lines = featureEnabled(cfg, 'sections') ? lineRangeFor(db, row.path as string, lineNumberAt(text, offset)) : null;\n    }\n  }\n\n  return rows;\n}\n\nexport interface TreeMap {\n  docs: { count: number; bytes: number };\n  fields: Row[]; // top 20 by coverage; fieldsTotal carries the real count\n  fieldsTotal: number;\n  features: { on: FeatureName[]; off: FeatureName[] };\n  hubs: Row[];\n  recent: Row[];\n}\n\nconst INTERNAL_COLUMNS = new Set(['path', '_mtime', '_size', '_rank']);\n\n// A result row is capped at SQLITE_MAX_COLUMN (2000, default); two aggregate expressions\n// per field keeps a chunk's row safely under that regardless of how many fields the tree has.\nconst MAP_COLUMN_CHUNK = 300;\n\nfunction chunk<T>(items: T[], size: number): T[][] {\n  const out: T[][] = [];\n  for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));\n  return out;\n}\n\n// Layer 0: what is this tree. Fixed-size output regardless of tree size.\nexport function mapTree(db: DatabaseSync, cfg: ResolvedConfig): TreeMap {\n  const docs = db.prepare('SELECT COUNT(*) AS count, COALESCE(SUM(\"_size\"), 0) AS bytes FROM frontmatter').get() as { count: number; bytes: number };\n\n  const columns = (db.prepare('PRAGMA table_info(frontmatter)').all() as Array<{ name: string }>).map((r) => r.name).filter((name) => !INTERNAL_COLUMNS.has(name));\n  // Observed storage class, not a declared one: these columns are added dynamically and\n  // SQLite types per value, so a field can be text in most notes and numeric in a few.\n  // Listing every distinct type makes both the type and any drift visible.\n  // One aggregate scan per chunk of columns rather than one scan per column: COUNT already\n  // ignores NULL, and FILTER keeps typeof() looking only at the non-null rows COUNT counted,\n  // matching the old per-column `WHERE ... IS NOT NULL` exactly.\n  const allFields: Row[] = [];\n  for (const group of chunk(columns, MAP_COLUMN_CHUNK)) {\n    const exprs = group.map((name, i) => {\n      const quoted = `\"${name.split('\"').join('\"\"')}\"`;\n      return `COUNT(${quoted}) AS n${i}, GROUP_CONCAT(DISTINCT typeof(${quoted})) FILTER (WHERE ${quoted} IS NOT NULL) AS t${i}`;\n    });\n    const result = db.prepare(`SELECT ${exprs.join(', ')} FROM frontmatter`).get() as Record<string, number | string | null>;\n    group.forEach((name, i) => allFields.push({ field: name, coverage: result[`n${i}`] as number, type: (result[`t${i}`] as string) ?? '' }));\n  }\n  allFields.sort((a, b) => (b.coverage as number) - (a.coverage as number));\n  const fields = allFields.slice(0, 20);\n\n  const hubs = featureEnabled(cfg, 'rank') ? (db.prepare(`SELECT f.\"path\" AS path, round(f.\"_rank\" * 100, 2) AS rank, content.title FROM frontmatter f JOIN content ON content.path = f.\"path\" WHERE f.\"_rank\" IS NOT NULL ORDER BY f.\"_rank\" DESC LIMIT 8`).all() as Row[]) : [];\n\n  const recent = db.prepare(`SELECT \"path\", datetime(\"_mtime\" / 1000, 'unixepoch') AS modified FROM frontmatter ORDER BY \"_mtime\" DESC LIMIT 5`).all() as Row[];\n\n  return { docs, fields, fieldsTotal: allFields.length, features: featureStates(cfg), hubs, recent };\n}\n\nexport interface Peek {\n  path: string;\n  tokens: number;\n  frontmatter: Row;\n  sections: Row[];\n  outbound: string[];\n  backlinks: string[];\n  unresolved: string[];\n  // Totals before truncation: a hub can have thousands of backlinks (or a note thousands of\n  // headings), and peek's whole point is bounded output. Query the sections/links tables\n  // directly for the full list.\n  sectionsTotal: number;\n  outboundTotal: number;\n  backlinksTotal: number;\n  unresolvedTotal: number;\n  off: FeatureName[]; // disabled features whose blocks are omitted (not empty)\n}\n\nconst PEEK_LIST_LIMIT = 20;\n\n// Layer 2: everything about one note except its prose -- frontmatter, outline with line\n// ranges + token estimates (so the follow-up Read is a range, not the file), links both ways.\nexport function peek(db: DatabaseSync, cfg: ResolvedConfig, pathArg: string): Peek {\n  const paths = (db.prepare('SELECT \"path\" FROM frontmatter').all() as Array<{ path: string }>).map((r) => r.path);\n  let path = paths.find((p) => p === pathArg);\n  if (!path) {\n    const base = posix.basename(pathArg).replace(/\\.md$/i, '').toLowerCase();\n    const matches = paths.filter((p) => posix.basename(p).replace(/\\.md$/i, '').toLowerCase() === base);\n    if (matches.length === 1) path = matches[0];\n    else if (matches.length > 1) throw new SenseError('NOTE_AMBIGUOUS', `\"${pathArg}\" is ambiguous: ${matches.join(', ')}`);\n    else throw new SenseError('NOTE_NOT_FOUND', `no note matches \"${pathArg}\"`);\n  }\n\n  const row = db.prepare('SELECT * FROM frontmatter WHERE \"path\" = ?').get(path) as Row;\n  const frontmatter: Row = {};\n  for (const [key, value] of Object.entries(row)) {\n    if (!INTERNAL_COLUMNS.has(key) && value !== null) frontmatter[key] = value;\n  }\n\n  const sectionsTotal = featureEnabled(cfg, 'sections') ? (db.prepare('SELECT COUNT(*) AS n FROM sections WHERE \"path\" = ?').get(path) as { n: number }).n : 0;\n  const sections = featureEnabled(cfg, 'sections') ? (db.prepare('SELECT level, heading, start_line, end_line, tokens FROM sections WHERE \"path\" = ? ORDER BY idx LIMIT ?').all(path, PEEK_LIST_LIMIT) as Row[]) : [];\n\n  let outbound: string[] = [];\n  let backlinks: string[] = [];\n  let unresolved: string[] = [];\n  let backlinksTotal = 0;\n  if (featureEnabled(cfg, 'links')) {\n    const out = db.prepare('SELECT target, dst FROM links WHERE src = ? ORDER BY target').all(path) as Array<{ target: string; dst: string | null }>;\n    outbound = [...new Set(out.filter((l) => l.dst !== null).map((l) => l.dst as string))];\n    unresolved = out.filter((l) => l.dst === null).map((l) => l.target);\n    backlinksTotal = (db.prepare('SELECT COUNT(DISTINCT src) AS n FROM links WHERE dst = ?').get(path) as { n: number }).n;\n    backlinks = (db.prepare('SELECT DISTINCT src FROM links WHERE dst = ? ORDER BY src LIMIT ?').all(path, PEEK_LIST_LIMIT) as Array<{ src: string }>).map((r) => r.src);\n  }\n\n  return {\n    path,\n    tokens: Math.ceil(((row._size as number) ?? 0) / 4),\n    frontmatter,\n    sections,\n    outbound: outbound.slice(0, PEEK_LIST_LIMIT),\n    backlinks,\n    unresolved: unresolved.slice(0, PEEK_LIST_LIMIT),\n    sectionsTotal,\n    outboundTotal: outbound.length,\n    backlinksTotal,\n    unresolvedTotal: unresolved.length,\n    off: (['sections', 'links'] as FeatureName[]).filter((name) => !featureEnabled(cfg, name)),\n  };\n}\n"],"names":["find","mapTree","peek","WEIGHTED_BM25","RRF_K","SNIPPET_BOUND","EXCERPT_WINDOW","extractBareTerms","query","cleaned","replace","split","map","tok","toLowerCase","trim","filter","length","findOccurrences","haystackLower","terms","occ","term","idx","found","indexOf","push","start","end","sort","a","b","bestWindowStart","windowSize","best","bestDistinct","bestCount","i","winEnd","seen","Set","count","j","add","size","computeExcerpt","text","Math","min","excerpt","slice","offset","out","cursor","o","prefix","suffix","lineNumberAt","line","charCodeAt","lineRangeFor","db","path","row","prepare","get","start_line","end_line","cfg","opts","hits","chunkLines","chunkSimilarity","k","fetch","scope","whereJoin","whereCond","matchSql","matchRows","oversized","candidates","edges","linked","nodes","seeds","ranked","vec","insert","c","where","similarityCol","rows","bareTerms","max","defaults","all","err","searchError","Map","r","hit","forEach","set","score","via","featureEnabled","linkEdges","flat","personalizedRank","existing","has","semantic","semanticCandidates","lines","similarity","exec","run","readFileSync","join","baseDir","INTERNAL_COLUMNS","MAP_COLUMN_CHUNK","chunk","items","docs","columns","name","allFields","group","exprs","quoted","result","field","coverage","type","fields","hubs","recent","fieldsTotal","features","featureStates","PEEK_LIST_LIMIT","pathArg","paths","p","base","posix","basename","matches","SenseError","frontmatter","Object","entries","key","value","sectionsTotal","n","sections","outbound","backlinks","unresolved","backlinksTotal","l","dst","target","src","tokens","ceil","_size","outboundTotal","unresolvedTotal","off"],"mappings":"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"}

package/dist/cjs/config.d.cts

@@ -10,6 +10,12 @@ export interface EmbedConfig {
     key?: string;
 }
 export declare const DEFAULT_EMBED_MODEL = "minishlab/potion-retrieval-32M";
+export interface SavedFind {
+    find: string;
+    k?: number;
+    where?: string;
+    semantic?: boolean;
+}
 export interface Config {
     $schema?: string;
     version?: number;
@@ -28,7 +34,7 @@ export interface Config {
         };
     };
     checks?: Record<string, 'empty'>;
-    queries: Record<string, string>;
+    queries: Record<string, string | SavedFind>;
 }
 export interface ResolvedConfig extends Config {
     baseDir: string;

package/dist/cjs/config.d.ts

@@ -10,6 +10,12 @@ export interface EmbedConfig {
     key?: string;
 }
 export declare const DEFAULT_EMBED_MODEL = "minishlab/potion-retrieval-32M";
+export interface SavedFind {
+    find: string;
+    k?: number;
+    where?: string;
+    semantic?: boolean;
+}
 export interface Config {
     $schema?: string;
     version?: number;
@@ -28,7 +34,7 @@ export interface Config {
         };
     };
     checks?: Record<string, 'empty'>;
-    queries: Record<string, string>;
+    queries: Record<string, string | SavedFind>;
 }
 export interface ResolvedConfig extends Config {
     baseDir: string;

package/dist/cjs/config.js

@@ -169,7 +169,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 var CONFIG_FILENAME = 'sense.config.json';
 var STATE_DIR = '.sense';
 var SUPPORTED_CONFIG_VERSION = 2;
-// Each feature owns its tables, parse-time extraction, and reconcile step; verbs degrade when one is off.
+// Each feature owns its tables, parse-time extraction, and reconcile step; commands degrade when one is off.
 // links/sections/rank are opt-out (absent = on); embed is opt-in (absent = off) -- most trees don't need vectors.
 var FEATURE_NAMES = [
     'links',
@@ -336,6 +336,37 @@ function unknownConfigKeys(cfg) {
     }
     return unknown;
 }
+var SAVED_FIND_KEYS = new Set([
+    'find',
+    'k',
+    'where',
+    'semantic'
+]);
+// A queries.<name> entry that isn't a SQL string must be a saved find: { find, k?, where?, semantic? }.
+function validateSavedFind(name, value, configPath) {
+    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) !== 'object' || value === null || Array.isArray(value)) {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, " must be a SQL string or { find, k?, where?, semantic? }"));
+    }
+    var entry = value;
+    var unknown = Object.keys(entry).filter(function(k) {
+        return !SAVED_FIND_KEYS.has(k);
+    });
+    if (unknown.length > 0) {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, " has unknown key(s) ").concat(unknown.join(', '), "; a saved find takes find, k, where, semantic"));
+    }
+    if (typeof entry.find !== 'string') {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".find must be a string"));
+    }
+    if (entry.k !== undefined && (typeof entry.k !== 'number' || !Number.isInteger(entry.k) || entry.k <= 0)) {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".k must be a positive integer"));
+    }
+    if (entry.where !== undefined && typeof entry.where !== 'string') {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".where must be a SQL condition string"));
+    }
+    if (entry.semantic !== undefined && typeof entry.semantic !== 'boolean') {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".semantic must be a boolean"));
+    }
+}
 function validateConfig(parsed, configPath) {
     var _cfg_features;
     var _defaults_find;
@@ -350,10 +381,29 @@ function validateConfig(parsed, configPath) {
         throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": scan.include must be a non-empty array of glob strings"));
     }
     if (cfg.queries === undefined) cfg.queries = {};
-    if (_type_of(cfg.queries) !== 'object' || cfg.queries === null || Array.isArray(cfg.queries) || !Object.values(cfg.queries).every(function(q) {
-        return typeof q === 'string';
-    })) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries must be an object of name -> SQL string"));
+    if (_type_of(cfg.queries) !== 'object' || cfg.queries === null || Array.isArray(cfg.queries)) {
+        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries must be an object of name -> SQL string or saved find"));
+    }
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = Object.entries(cfg.queries)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array(_step.value, 2), name = _step_value[0], value = _step_value[1];
+            if (typeof value === 'string') continue;
+            validateSavedFind(name, value, configPath);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
     }
     var defaults = cfg.defaults;
     if (defaults !== undefined && ((typeof defaults === "undefined" ? "undefined" : _type_of(defaults)) !== 'object' || defaults === null || Array.isArray(defaults) || defaults.find !== undefined && typeof ((_defaults_find = defaults.find) === null || _defaults_find === void 0 ? void 0 : _defaults_find.where) !== 'string')) {
@@ -368,23 +418,24 @@ function validateConfig(parsed, configPath) {
             throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': checks must be an object of query name -> "empty"'));
         }
         var queries = (_cfg_queries = cfg.queries) !== null && _cfg_queries !== void 0 ? _cfg_queries : {};
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
         try {
-            for(var _iterator = Object.keys(checks)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                var name = _step.value;
-                if (queries[name] === undefined) throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': checks names "').concat(name, '", which is not a saved query'));
+            for(var _iterator1 = Object.keys(checks)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                var name1 = _step1.value;
+                if (queries[name1] === undefined) throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': checks names "').concat(name1, '", which is not a saved query'));
+                if (typeof queries[name1] !== 'string') throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': checks names "').concat(name1, '", which is a saved find, not a SQL query'));
             }
         } catch (err) {
-            _didIteratorError = true;
-            _iteratorError = err;
+            _didIteratorError1 = true;
+            _iteratorError1 = err;
         } finally{
             try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                    _iterator.return();
+                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                    _iterator1.return();
                 }
             } finally{
-                if (_didIteratorError) {
-                    throw _iteratorError;
+                if (_didIteratorError1) {
+                    throw _iteratorError1;
                 }
             }
         }
@@ -392,10 +443,10 @@ function validateConfig(parsed, configPath) {
     if (cfg.features !== undefined && (_type_of(cfg.features) !== 'object' || cfg.features === null || Array.isArray(cfg.features))) {
         throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": features must be an object of name -> boolean"));
     }
-    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
     try {
         var _loop = function() {
-            var _step_value = _sliced_to_array(_step1.value, 2), name = _step_value[0], value = _step_value[1];
+            var _step_value = _sliced_to_array(_step2.value, 2), name = _step_value[0], value = _step_value[1];
             if (typeof value === 'boolean') return "continue";
             // embed alone takes an object form: { model?, type?: static|api, url?, key? }.
             var embed = value;
@@ -410,18 +461,18 @@ function validateConfig(parsed, configPath) {
                 throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": features.").concat(name, " must be a boolean").concat(name === 'embed' ? ' or { model?, type?: "static"|"api", url?, key? }' : ''));
             }
         };
-        for(var _iterator1 = Object.entries((_cfg_features = cfg.features) !== null && _cfg_features !== void 0 ? _cfg_features : {})[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true)_loop();
+        for(var _iterator2 = Object.entries((_cfg_features = cfg.features) !== null && _cfg_features !== void 0 ? _cfg_features : {})[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true)_loop();
     } catch (err) {
-        _didIteratorError1 = true;
-        _iteratorError1 = err;
+        _didIteratorError2 = true;
+        _iteratorError2 = err;
     } finally{
         try {
-            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                _iterator1.return();
+            if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                _iterator2.return();
             }
         } finally{
-            if (_didIteratorError1) {
-                throw _iteratorError1;
+            if (_didIteratorError2) {
+                throw _iteratorError2;
             }
         }
     }