sensemaking 0.12.2 → 0.13.0

package/dist/cjs/config.js

@@ -1,919 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get CONFIG_FILENAME () {
-        return CONFIG_FILENAME;
-    },
-    get DEFAULT_EMBED_MODEL () {
-        return DEFAULT_EMBED_MODEL;
-    },
-    get STATE_DIR () {
-        return STATE_DIR;
-    },
-    get SUPPORTED_CONFIG_VERSION () {
-        return SUPPORTED_CONFIG_VERSION;
-    },
-    get anyPresetEmbeds () {
-        return anyPresetEmbeds;
-    },
-    get contentTokenize () {
-        return contentTokenize;
-    },
-    get embedConfig () {
-        return embedConfig;
-    },
-    get embedEnabled () {
-        return embedEnabled;
-    },
-    get enabledFeatures () {
-        return enabledFeatures;
-    },
-    get featureEnabled () {
-        return featureEnabled;
-    },
-    get featureSignature () {
-        return featureSignature;
-    },
-    get featureStates () {
-        return featureStates;
-    },
-    get findConfigPath () {
-        return findConfigPath;
-    },
-    get initConfig () {
-        return initConfig;
-    },
-    get loadConfig () {
-        return loadConfig;
-    },
-    get migrateConfig () {
-        return migrateConfig;
-    },
-    get presetNames () {
-        return presetNames;
-    },
-    get presetSemanticEnabled () {
-        return presetSemanticEnabled;
-    },
-    get resolvePreset () {
-        return resolvePreset;
-    },
-    get resolveSearch () {
-        return resolveSearch;
-    }
-});
-var _nodefs = require("node:fs");
-var _nodepath = require("node:path");
-var _errorsts = require("./errors.js");
-function _array_like_to_array(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
-    return arr2;
-}
-function _array_with_holes(arr) {
-    if (Array.isArray(arr)) return arr;
-}
-function _array_without_holes(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array(arr);
-}
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _iterable_to_array(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
-}
-function _iterable_to_array_limit(arr, i) {
-    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-    if (_i == null) return;
-    var _arr = [];
-    var _n = true;
-    var _d = false;
-    var _s, _e;
-    try {
-        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
-            _arr.push(_s.value);
-            if (i && _arr.length === i) break;
-        }
-    } catch (err) {
-        _d = true;
-        _e = err;
-    } finally{
-        try {
-            if (!_n && _i["return"] != null) _i["return"]();
-        } finally{
-            if (_d) throw _e;
-        }
-    }
-    return _arr;
-}
-function _non_iterable_rest() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _non_iterable_spread() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _object_spread(target) {
-    for(var i = 1; i < arguments.length; i++){
-        var source = arguments[i] != null ? arguments[i] : {};
-        var ownKeys = Object.keys(source);
-        if (typeof Object.getOwnPropertySymbols === "function") {
-            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
-            }));
-        }
-        ownKeys.forEach(function(key) {
-            _define_property(target, key, source[key]);
-        });
-    }
-    return target;
-}
-function ownKeys(object, enumerableOnly) {
-    var keys = Object.keys(object);
-    if (Object.getOwnPropertySymbols) {
-        var symbols = Object.getOwnPropertySymbols(object);
-        if (enumerableOnly) {
-            symbols = symbols.filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
-            });
-        }
-        keys.push.apply(keys, symbols);
-    }
-    return keys;
-}
-function _object_spread_props(target, source) {
-    source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
-        ownKeys(Object(source)).forEach(function(key) {
-            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-    }
-    return target;
-}
-function _object_without_properties(source, excluded) {
-    if (source == null) return {};
-    var target = {}, sourceKeys, key, i;
-    if (typeof Reflect !== "undefined" && Reflect.ownKeys) {
-        sourceKeys = Reflect.ownKeys(Object(source));
-        for(i = 0; i < sourceKeys.length; i++){
-            key = sourceKeys[i];
-            if (excluded.indexOf(key) >= 0) continue;
-            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
-            target[key] = source[key];
-        }
-        return target;
-    }
-    target = _object_without_properties_loose(source, excluded);
-    if (Object.getOwnPropertySymbols) {
-        sourceKeys = Object.getOwnPropertySymbols(source);
-        for(i = 0; i < sourceKeys.length; i++){
-            key = sourceKeys[i];
-            if (excluded.indexOf(key) >= 0) continue;
-            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
-            target[key] = source[key];
-        }
-    }
-    return target;
-}
-function _object_without_properties_loose(source, excluded) {
-    if (source == null) return {};
-    var target = {}, sourceKeys = Object.getOwnPropertyNames(source), key, i;
-    for(i = 0; i < sourceKeys.length; i++){
-        key = sourceKeys[i];
-        if (excluded.indexOf(key) >= 0) continue;
-        if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
-        target[key] = source[key];
-    }
-    return target;
-}
-function _sliced_to_array(arr, i) {
-    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
-}
-function _to_consumable_array(arr) {
-    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
-}
-function _type_of(obj) {
-    "@swc/helpers - typeof";
-    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
-}
-function _unsupported_iterable_to_array(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-}
-var CONFIG_FILENAME = 'sense.config.json';
-var STATE_DIR = '.sense';
-var SUPPORTED_CONFIG_VERSION = 4;
-// v1 and v2 were `scan`/`find`-shaped; v3 introduced `presets`. Only the former need the
-// legacy shape check before migrating.
-var FIRST_PRESET_VERSION = 3;
-// Each feature owns its tables, parse-time extraction, and reconcile step; commands degrade when one is off.
-// links/sections/rank are opt-out toggles in the top-level `features` block; embed is not a
-// member of that block -- it is on exactly when an `embed` block names a model.
-var FEATURE_NAMES = [
-    'links',
-    'sections',
-    'rank',
-    'embed'
-];
-// v1 -> v2 migration only: the features v2 introduced as opt-out (embed was opt-in then).
-var V2_OPT_OUT_NAMES = [
-    'links',
-    'sections',
-    'rank'
-];
-var DEFAULT_EMBED_MODEL = 'minishlab/potion-retrieval-32M';
-function presetNames(cfg) {
-    return Object.keys(cfg.presets);
-}
-function embedEnabled(cfg) {
-    var _cfg_embed;
-    return typeof ((_cfg_embed = cfg.embed) === null || _cfg_embed === void 0 ? void 0 : _cfg_embed.model) === 'string' && cfg.embed.model.length > 0;
-}
-function presetSemanticEnabled(cfg, name) {
-    var _cfg_presets_name;
-    return ((_cfg_presets_name = cfg.presets[name]) === null || _cfg_presets_name === void 0 ? void 0 : _cfg_presets_name.semantic) !== false;
-}
-function anyPresetEmbeds(cfg) {
-    return embedEnabled(cfg) && presetNames(cfg).some(function(name) {
-        return presetSemanticEnabled(cfg, name);
-    });
-}
-function featureEnabled(cfg, name) {
-    var _cfg_features;
-    if (name === 'embed') return anyPresetEmbeds(cfg);
-    var enabled = ((_cfg_features = cfg.features) === null || _cfg_features === void 0 ? void 0 : _cfg_features[name]) !== false;
-    if (name === 'rank') return enabled && featureEnabled(cfg, 'links');
-    return enabled;
-}
-function enabledFeatures(cfg) {
-    return FEATURE_NAMES.filter(function(name) {
-        return featureEnabled(cfg, name);
-    });
-}
-function featureStates(cfg) {
-    var reported = FEATURE_NAMES.filter(function(name) {
-        return name !== 'embed';
-    });
-    return {
-        on: reported.filter(function(name) {
-            return featureEnabled(cfg, name);
-        }),
-        off: reported.filter(function(name) {
-            return !featureEnabled(cfg, name);
-        })
-    };
-}
-function embedConfig(cfg) {
-    var _e_type;
-    if (!embedEnabled(cfg)) return null;
-    var e = cfg.embed;
-    return {
-        model: e.model,
-        type: (_e_type = e.type) !== null && _e_type !== void 0 ? _e_type : 'static',
-        url: e.url,
-        key: e.key
-    };
-}
-function contentTokenize(cfg) {
-    var _cfg_content;
-    var tokenize = (_cfg_content = cfg.content) === null || _cfg_content === void 0 ? void 0 : _cfg_content.tokenize;
-    return tokenize === undefined || tokenize.trim() === '' ? undefined : tokenize.trim();
-}
-function featureSignature(cfg) {
-    var globalPart = enabledFeatures(cfg).filter(function(name) {
-        return name !== 'embed';
-    }).join(',');
-    var e = embedConfig(cfg);
-    var embedPart = e ? "embed:".concat(e.type, ":").concat(e.model) : 'embed:off';
-    // One keyed segment per preset so a rebuild notice can name exactly which preset moved.
-    var presetsPart = _to_consumable_array(presetNames(cfg)).sort().map(function(name) {
-        var _p_exclude;
-        var p = cfg.presets[name];
-        var include = _to_consumable_array(p.include).sort().join('+');
-        var exclude = _to_consumable_array((_p_exclude = p.exclude) !== null && _p_exclude !== void 0 ? _p_exclude : []).sort().join('+');
-        return "preset:".concat(name, ":").concat(include, ":").concat(exclude, ":").concat(p.semantic === false ? 'off' : 'on');
-    }).join('|');
-    var tokenize = contentTokenize(cfg);
-    var parts = [
-        "features:".concat(globalPart),
-        embedPart
-    ];
-    if (tokenize !== undefined) parts.push("tokenize:".concat(tokenize));
-    parts.push(presetsPart);
-    return parts.join('|');
-}
-function resolvePreset(cfg, name) {
-    var presetName = name !== null && name !== void 0 ? name : 'default';
-    var preset = cfg.presets[presetName];
-    if (!preset) throw new _errorsts.SenseError('PRESET_UNKNOWN', 'unknown preset "'.concat(presetName, '"; declared presets: ').concat(presetNames(cfg).join(', ')));
-    return {
-        name: presetName,
-        preset: preset
-    };
-}
-function resolveSearch(cfg) {
-    var opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
-    var _ref, _opts_k, _opts_where, _opts_include, _opts_exclude;
-    var _resolvePreset = resolvePreset(cfg, opts.preset), presetName = _resolvePreset.name, preset = _resolvePreset.preset;
-    var k = (_ref = (_opts_k = opts.k) !== null && _opts_k !== void 0 ? _opts_k : preset.k) !== null && _ref !== void 0 ? _ref : 10;
-    var where = (_opts_where = opts.where) !== null && _opts_where !== void 0 ? _opts_where : preset.where;
-    // Each overrides its own side only, so neither clears the other.
-    var include = (_opts_include = opts.include) !== null && _opts_include !== void 0 ? _opts_include : preset.include;
-    // --no-exclude widens past the preset's exclusions; an explicit --exclude alongside it is
-    // still the scope for this command, since it says what to leave out rather than what to keep.
-    var exclude = (_opts_exclude = opts.exclude) !== null && _opts_exclude !== void 0 ? _opts_exclude : opts.noExclude ? undefined : preset.exclude;
-    return {
-        presetName: presetName,
-        k: k,
-        where: where,
-        include: include,
-        exclude: exclude,
-        semantic: preset.semantic !== false
-    };
-}
-// Pure per-version steps, chained by loadConfig. Intermediate shapes predate the Config type,
-// so steps are loosely typed and only the final result is cast back.
-var MIGRATIONS = {
-    // v1 -> v2: features block introduced, opt-out features enabled (matches the old implicit
-    // behavior of `links` etc. not existing). embed stays absent -- opt-in.
-    1: function(cfg) {
-        return _object_spread_props(_object_spread({}, cfg), {
-            version: 2,
-            features: Object.fromEntries(V2_OPT_OUT_NAMES.map(function(name) {
-                return [
-                    name,
-                    true
-                ];
-            }))
-        });
-    },
-    // v2 -> v3: mechanical-minimal, by decision -- only what keeps an existing config loading.
-    // No restructuring, no preset inference, no query rewriting; real trees get hand-migrated
-    // separately to actually use presets.
-    2: function(cfg) {
-        var _prevDefaults_find;
-        var scan = cfg.scan, defaults = cfg.defaults, features = cfg.features, checks = cfg.checks, queries = cfg.queries, rest = _object_without_properties(cfg, [
-            "scan",
-            "defaults",
-            "features",
-            "checks",
-            "queries"
-        ]);
-        var scanInclude = scan.include;
-        var nextQueries = {};
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-        try {
-            for(var _iterator = Object.entries(queries !== null && queries !== void 0 ? 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') {
-                    nextQueries[name] = value;
-                    continue;
-                }
-                var entry = value;
-                // Loosely typed on purpose: this step emits the v3 shape, which still had `semantic`.
-                // The v3 -> v4 step below strips it.
-                var search = {
-                    search: entry.find
-                };
-                if (entry.k !== undefined) search.k = entry.k;
-                if (entry.where !== undefined) search.where = entry.where;
-                // semantic: true was opt-in; it is now the default, so it drops. semantic: false is kept.
-                if (entry.semantic === false) search.semantic = false;
-                nextQueries[name] = search;
-            }
-        } catch (err) {
-            _didIteratorError = true;
-            _iteratorError = err;
-        } finally{
-            try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                    _iterator.return();
-                }
-            } finally{
-                if (_didIteratorError) {
-                    throw _iteratorError;
-                }
-            }
-        }
-        var prevDefaults = defaults;
-        var defaultWhere = prevDefaults === null || prevDefaults === void 0 ? void 0 : (_prevDefaults_find = prevDefaults.find) === null || _prevDefaults_find === void 0 ? void 0 : _prevDefaults_find.where;
-        // features.embed false becomes semantic:false on every preset produced here.
-        var prevFeatures = features !== null && features !== void 0 ? features : {};
-        var embedWasOff = prevFeatures.embed === false;
-        // Object form carried provider settings (model/type/url/key), not a toggle -- they move
-        // to the v3 top-level `embed` block verbatim; dropping them would silently switch an
-        // api tree back to the built-in static model.
-        var embedProvider = _type_of(prevFeatures.embed) === 'object' && prevFeatures.embed !== null ? prevFeatures.embed : undefined;
-        var _embed = prevFeatures.embed, restFeatures = _object_without_properties(prevFeatures, [
-            "embed"
-        ]);
-        var defaultPreset = {
-            include: scanInclude
-        };
-        if (defaultWhere !== undefined) defaultPreset.where = defaultWhere;
-        if (embedWasOff) defaultPreset.semantic = false;
-        // checks (assertions over saved queries) was removed in v3; its queries still run under
-        // `queries`, just without the pass/fail assertion -- reachable now only as a saved query.
-        if (checks !== undefined) {
-            console.error('sense: v2 "checks" was removed in v3 (sense check no longer asserts on saved queries); its queries are carried over under "queries" -- a returned row set is now the reader\'s judgment');
-        }
-        var result = _object_spread_props(_object_spread({}, rest), {
-            version: 3,
-            presets: {
-                default: defaultPreset
-            },
-            queries: nextQueries
-        });
-        if (embedProvider !== undefined) result.embed = embedProvider;
-        if (Object.keys(restFeatures).length > 0) result.features = restFeatures;
-        return result;
-    },
-    // v3 -> v4: write the model into the file, wrap bare-string queries as { sql }, drop a saved
-    // search's `semantic` (its preset decides). Same effective model, so nothing re-embeds.
-    3: function(cfg) {
-        var _cfg_queries, _cfg_embed;
-        var presets = cfg.presets;
-        var embedded = Object.values(presets).some(function(p) {
-            return p.semantic !== false;
-        });
-        var nextQueries = {};
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-        try {
-            for(var _iterator = Object.entries((_cfg_queries = cfg.queries) !== null && _cfg_queries !== void 0 ? _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];
-                // v3's bare string meant SQL by inference; v4 makes every entry name its verb.
-                if (typeof value === 'string') {
-                    nextQueries[name] = {
-                        sql: value
-                    };
-                    continue;
-                }
-                if ((typeof value === "undefined" ? "undefined" : _type_of(value)) !== 'object' || value === null || !('search' in value)) {
-                    nextQueries[name] = value;
-                    continue;
-                }
-                var _semantic = value.semantic, rest = _object_without_properties(value, [
-                    "semantic"
-                ]);
-                nextQueries[name] = rest;
-            }
-        } catch (err) {
-            _didIteratorError = true;
-            _iteratorError = err;
-        } finally{
-            try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                    _iterator.return();
-                }
-            } finally{
-                if (_didIteratorError) {
-                    throw _iteratorError;
-                }
-            }
-        }
-        var prev = (_cfg_embed = cfg.embed) !== null && _cfg_embed !== void 0 ? _cfg_embed : {};
-        var result = _object_spread_props(_object_spread({}, cfg), {
-            version: 4,
-            queries: nextQueries
-        });
-        if (embedded) {
-            var _prev_model, _prev_type;
-            result.embed = _object_spread({
-                model: (_prev_model = prev.model) !== null && _prev_model !== void 0 ? _prev_model : DEFAULT_EMBED_MODEL,
-                type: (_prev_type = prev.type) !== null && _prev_type !== void 0 ? _prev_type : 'static'
-            }, prev.url !== undefined ? {
-                url: prev.url
-            } : {}, prev.key !== undefined ? {
-                key: prev.key
-            } : {});
-        } else {
-            delete result.embed;
-            // Dropping settings silently would look like a bug in a tree that had configured an
-            // api endpoint and then turned vectors off; say it, since v4 has no way to carry
-            // provider settings for a tree that does not embed.
-            if (Object.keys(prev).length > 0) console.error('sense: every preset has "semantic": false, so v4 drops the "embed" block (vectors stay off); re-add it, or set a preset\'s semantic back to true, to turn them on');
-        }
-        return result;
-    }
-};
-function migrateConfig(cfg) {
-    var _cfg_version;
-    var from = (_cfg_version = cfg.version) !== null && _cfg_version !== void 0 ? _cfg_version : 1;
-    var current = cfg;
-    for(var v = from; v < SUPPORTED_CONFIG_VERSION; v++){
-        var step = MIGRATIONS[v];
-        if (!step) throw new _errorsts.SenseError('CONFIG_VERSION_UNSUPPORTED', "no migration from config version ".concat(v));
-        current = step(current);
-    }
-    return {
-        cfg: current,
-        from: from
-    };
-}
-function starterConfig() {
-    return {
-        $schema: 'https://unpkg.com/sensemaking/schema.json',
-        version: SUPPORTED_CONFIG_VERSION,
-        presets: {
-            default: {
-                include: [
-                    '**/*.md'
-                ],
-                k: 10
-            },
-            large: {
-                include: [
-                    '**/*.md'
-                ],
-                k: 20
-            }
-        },
-        // Written out rather than defaulted in code: this line is what makes `sense download`
-        // fetch 124 MB, so it belongs where it can be read and changed.
-        embed: {
-            model: DEFAULT_EMBED_MODEL,
-            type: 'static'
-        },
-        queries: {}
-    };
-}
-function initConfig(dir) {
-    var configPath = (0, _nodepath.join)(dir, CONFIG_FILENAME);
-    if ((0, _nodefs.existsSync)(configPath)) {
-        throw new _errorsts.SenseError('CONFIG_EXISTS', "".concat(CONFIG_FILENAME, " already exists in ").concat(dir));
-    }
-    (0, _nodefs.writeFileSync)(configPath, "".concat(JSON.stringify(starterConfig(), null, 2), "\n"));
-    return configPath;
-}
-function findConfigPath(startDir) {
-    var dir = (0, _nodepath.resolve)(startDir);
-    for(;;){
-        var candidate = (0, _nodepath.join)(dir, CONFIG_FILENAME);
-        if ((0, _nodefs.existsSync)(candidate)) return candidate;
-        var parent = (0, _nodepath.dirname)(dir);
-        if (parent === dir) return null;
-        dir = parent;
-    }
-}
-// Shape check for hand-edited files, so a typo names itself instead of surfacing as a
-// TypeError. Unknown top-level keys warn (forward compat); unknown keys inside a block error.
-var KNOWN_KEYS = new Set([
-    '$schema',
-    'version',
-    'presets',
-    'features',
-    'embed',
-    'content',
-    'queries'
-]);
-var KNOWN_PRESET_KEYS = new Set([
-    'include',
-    'exclude',
-    'k',
-    'semantic',
-    'where'
-]);
-var KNOWN_FEATURE_KEYS = new Set([
-    'links',
-    'sections',
-    'rank'
-]);
-var KNOWN_EMBED_KEYS = new Set([
-    'model',
-    'type',
-    'url',
-    'key'
-]);
-var KNOWN_CONTENT_KEYS = new Set([
-    'tokenize'
-]);
-var SAVED_SEARCH_KEYS = new Set([
-    'search',
-    'preset',
-    'include',
-    'exclude',
-    'where',
-    'k'
-]);
-function unknownConfigKeys(cfg) {
-    return Object.keys(cfg).filter(function(k) {
-        return !KNOWN_KEYS.has(k);
-    });
-}
-function isNonEmptyStringArray(value) {
-    return Array.isArray(value) && value.length > 0 && value.every(function(g) {
-        return typeof g === 'string' && g.length > 0;
-    });
-}
-// Pre-v3 shape check, just enough for migrateConfig to run safely (it reads scan.include
-// directly). The full v3 shape is checked by validateConfig once migration has produced it.
-function validateLegacyScan(parsed, configPath) {
-    var cfg = (typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) === 'object' && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-    var scan = cfg === null || cfg === void 0 ? void 0 : cfg.scan;
-    if (!cfg || !scan || !isNonEmptyStringArray(scan.include)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": scan.include must be a non-empty array of glob strings"));
-    }
-}
-// Only the shape is checked here. Whether the linked SQLite accepts the tokenizer is settled
-// by probing it in db.ts, so this never has to carry a table of which version added what.
-function validateContentBlock(value, configPath) {
-    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) !== 'object' || value === null || Array.isArray(value)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": content must be an object of { tokenize?: string }"));
-    }
-    var block = value;
-    var unknown = Object.keys(block).filter(function(k) {
-        return !KNOWN_CONTENT_KEYS.has(k);
-    });
-    if (unknown.length > 0) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": content has unknown key(s) ").concat(unknown.join(', '), "; content takes tokenize"));
-    }
-    if (block.tokenize !== undefined && (typeof block.tokenize !== 'string' || block.tokenize.trim() === '')) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': content.tokenize must be a non-empty string, e.g. "trigram" or "unicode61 tokenchars \'-_\'"'));
-    }
-}
-function validateFeaturesBlock(value, configPath) {
-    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) !== 'object' || value === null || Array.isArray(value)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": features must be an object of name -> boolean"));
-    }
-    var block = value;
-    var unknown = Object.keys(block).filter(function(k) {
-        return !KNOWN_FEATURE_KEYS.has(k);
-    });
-    if (unknown.length > 0) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": features has unknown key(s) ").concat(unknown.join(', '), '; embed is not a features key -- see the top-level "embed" block'));
-    }
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = Object.entries(block)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array(_step.value, 2), name = _step_value[0], v = _step_value[1];
-            if (typeof v !== 'boolean') {
-                throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": features.").concat(name, " must be a boolean"));
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-function validateEmbedBlock(value, configPath) {
-    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) !== 'object' || value === null || Array.isArray(value)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': embed must be an object of { model?, type?: "static"|"api", url?, key? }'));
-    }
-    var embed = value;
-    var unknown = Object.keys(embed).filter(function(k) {
-        return !KNOWN_EMBED_KEYS.has(k);
-    });
-    if (unknown.length > 0) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": embed has unknown key(s) ").concat(unknown.join(', ')));
-    }
-    if (embed.model !== undefined && typeof embed.model !== 'string') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": embed.model must be a string"));
-    }
-    // The block exists to name a model; provider settings without one would read as "vectors
-    // configured" while embedding stays off, which is the ambiguity v4 removed.
-    if (embed.model === undefined || embed.model === '') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': embed.model is required when the "embed" block is present (it is what turns vectors on); remove the block to index without vectors'));
-    }
-    if (embed.type !== undefined && embed.type !== 'static' && embed.type !== 'api') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': embed.type must be "static" or "api"'));
-    }
-    if (embed.url !== undefined && typeof embed.url !== 'string') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": embed.url must be a string"));
-    }
-    if (embed.key !== undefined && typeof embed.key !== 'string') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": embed.key must be a string"));
-    }
-}
-function validatePreset(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, ": presets.").concat(name, " must be an object"));
-    }
-    var preset = value;
-    var unknown = Object.keys(preset).filter(function(k) {
-        return !KNOWN_PRESET_KEYS.has(k);
-    });
-    if (unknown.length > 0) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, " has unknown key(s) ").concat(unknown.join(', '), "; a preset takes include, exclude, k, semantic, where"));
-    }
-    if (!isNonEmptyStringArray(preset.include)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, ".include must be a non-empty array of glob strings"));
-    }
-    if (preset.exclude !== undefined && !isNonEmptyStringArray(preset.exclude)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, ".exclude must be a non-empty array of glob strings"));
-    }
-    if (preset.semantic !== undefined && typeof preset.semantic !== 'boolean') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, ".semantic must be a boolean"));
-    }
-    if (preset.k !== undefined && (typeof preset.k !== 'number' || !Number.isInteger(preset.k) || preset.k <= 0)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, ".k must be a positive integer"));
-    }
-    if (preset.where !== undefined && typeof preset.where !== 'string') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets.").concat(name, ".where must be a SQL condition string"));
-    }
-}
-// A queries.<name> entry: { sql } or a saved search { search, preset?, include?, exclude?, where?, k? }.
-function validateSavedQuery(name, value, configPath) {
-    // A bare string used to mean SQL. It now fails rather than being inferred: an entry says
-    // which of the two verbs it runs, the same choice the CLI makes explicit.
-    if (typeof value === 'string') {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ' must say which verb it runs: { "sql": ').concat(JSON.stringify(value.length > 40 ? "".concat(value.slice(0, 37), "...") : value), ' } to run it as SQL, or { "search": "..." } for a ranked search'));
-    }
-    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 { sql } or { search, preset?, include?, exclude?, where?, k? }"));
-    }
-    var entry = value;
-    if ('sql' in entry) {
-        var unknown = Object.keys(entry).filter(function(k) {
-            return k !== 'sql';
-        });
-        if (unknown.length > 0) {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, " has unknown key(s) ").concat(unknown.join(', '), "; a { sql } query takes only sql"));
-        }
-        if (typeof entry.sql !== 'string' || entry.sql.trim() === '') {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".sql must be a non-empty string"));
-        }
-        return;
-    }
-    if ('search' in entry) {
-        var unknown1 = Object.keys(entry).filter(function(k) {
-            return !SAVED_SEARCH_KEYS.has(k);
-        });
-        if (unknown1.length > 0) {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, " has unknown key(s) ").concat(unknown1.join(', '), "; a saved search takes search, preset, include, exclude, where, k"));
-        }
-        // A saved entry saves a question; a scope without a question is just flags.
-        if (typeof entry.search !== 'string' || entry.search.trim() === '') {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".search must be non-empty text"));
-        }
-        if (entry.preset !== undefined && (typeof entry.preset !== 'string' || entry.preset.length === 0)) {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".preset must be a preset name"));
-        }
-        if (entry.include !== undefined && !isNonEmptyStringArray(entry.include)) {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".include must be a non-empty array of glob strings"));
-        }
-        if (entry.exclude !== undefined && !isNonEmptyStringArray(entry.exclude)) {
-            throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, ".exclude must be a non-empty array of glob strings"));
-        }
-        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.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"));
-        }
-        return;
-    }
-    throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": queries.").concat(name, " must be { sql } or { search, preset?, include?, exclude?, where?, k? }"));
-}
-function validateConfig(parsed, configPath) {
-    if ((typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) !== 'object' || parsed === null || Array.isArray(parsed)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": config must be a JSON object"));
-    }
-    var cfg = parsed;
-    // `checks` is rejected by name, not warned: silence would hide that assertions are gone.
-    if (cfg.checks !== undefined) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": checks was removed in v3 -- sense check no longer asserts on saved queries; a returned row set is the reader's judgment"));
-    }
-    var presets = cfg.presets;
-    if (!presets || (typeof presets === "undefined" ? "undefined" : _type_of(presets)) !== 'object' || Array.isArray(presets) || Object.keys(presets).length === 0) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": presets must be a non-empty object of preset name -> { include, exclude?, k?, semantic?, where? }"));
-    }
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = Object.entries(presets)[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];
-            validatePreset(name, value, configPath);
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    if (presets.default === undefined) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ': presets must include a "default" preset'));
-    }
-    if (cfg.queries === undefined) cfg.queries = {};
-    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 } or { search }"));
-    }
-    var queries = cfg.queries;
-    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-    try {
-        for(var _iterator1 = Object.entries(queries)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-            var _step_value1 = _sliced_to_array(_step1.value, 2), name1 = _step_value1[0], value1 = _step_value1[1];
-            validateSavedQuery(name1, value1, configPath);
-        }
-    } catch (err) {
-        _didIteratorError1 = true;
-        _iteratorError1 = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                _iterator1.return();
-            }
-        } finally{
-            if (_didIteratorError1) {
-                throw _iteratorError1;
-            }
-        }
-    }
-    if (cfg.features !== undefined) {
-        validateFeaturesBlock(cfg.features, configPath);
-    }
-    if (cfg.embed !== undefined) {
-        validateEmbedBlock(cfg.embed, configPath);
-    }
-    if (cfg.content !== undefined) {
-        validateContentBlock(cfg.content, configPath);
-    }
-    return cfg;
-}
-function loadConfig(explicitPath) {
-    var configPath;
-    if (explicitPath) {
-        configPath = (0, _nodepath.resolve)(process.cwd(), explicitPath);
-        if (!(0, _nodefs.existsSync)(configPath)) throw new _errorsts.SenseError('CONFIG_NOT_FOUND', "config not found: ".concat(configPath));
-    } else {
-        var found = findConfigPath(process.cwd());
-        if (!found) {
-            throw new _errorsts.SenseError('CONFIG_NOT_FOUND', "could not find ".concat(CONFIG_FILENAME, " in ").concat(process.cwd(), " or any parent directory"));
-        }
-        configPath = found;
-    }
-    var raw = (0, _nodefs.readFileSync)(configPath, 'utf8');
-    var parsed = JSON.parse(raw);
-    // Ahead of both the version gate and legacy/current shape checks: a non-object file (or
-    // an array -- typeof [] is also 'object') is malformed at every version, so it gets one
-    // error regardless of which branch would otherwise run.
-    if ((typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) !== 'object' || parsed === null || Array.isArray(parsed)) {
-        throw new _errorsts.SenseError('CONFIG_INVALID', "".concat(configPath, ": config must be a JSON object"));
-    }
-    // Version gate before shape validation: a config written by a newer sense should fail
-    // with "requires a newer sense", not with shape errors its own version may not have.
-    var version = (typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) === 'object' && parsed !== null && typeof parsed.version === 'number' ? parsed.version : 1;
-    if (version > SUPPORTED_CONFIG_VERSION) {
-        throw new _errorsts.SenseError('CONFIG_VERSION_UNSUPPORTED', "config version ".concat(version, " requires a newer sense"));
-    }
-    // validateConfig only knows the current shape, so scan-shaped files (pre-v3) get a minimal
-    // check, migrate, then the full one on the result.
-    var cfg;
-    var migratedFrom;
-    if (version < SUPPORTED_CONFIG_VERSION) {
-        if (version < FIRST_PRESET_VERSION) validateLegacyScan(parsed, configPath);
-        var result = migrateConfig(parsed);
-        cfg = validateConfig(result.cfg, configPath);
-        migratedFrom = result.from;
-        (0, _nodefs.writeFileSync)(configPath, "".concat(JSON.stringify(cfg, null, 2), "\n"));
-    } else {
-        cfg = validateConfig(parsed, configPath);
-    }
-    var unknownKeys = unknownConfigKeys(cfg);
-    return _object_spread_props(_object_spread({}, cfg), {
-        baseDir: (0, _nodepath.dirname)(configPath),
-        configPath: configPath,
-        migratedFrom: migratedFrom,
-        unknownKeys: unknownKeys.length > 0 ? unknownKeys : undefined
-    });
-}
-/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }