@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/search/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/search/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAGnD,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEvF,iHAAiH;AACjH,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAA;AAE3D,2FAA2F;AAC3F,eAAO,MAAM,aAAa,aAAc,QAAQ,KAAG,OAAoC,CAAA;AAEvF,0HAA0H;AAC1H,eAAO,MAAM,QAAQ,WAAY,MAAM,YAAY,QAAQ,KAAG,OAMb,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAA;IAClB,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAqED;;;GAGG;AACH,eAAO,MAAM,QAAQ,SAAU,MAAM,SAAS,MAAM,aAAa,SAAS,QAAQ,EAAE,KAAG,MActF,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,UAAU,UACd,MAAM,uBACyB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,KACtF,WAoCF,CAAA"}

package/dist/search/query.js

@@ -0,0 +1,136 @@
+import { CliError } from "@wirecat/cli-base";
+import { isKind, kindOf, providerNamed } from "../domain/providers.js";
+/** How the store tells a bot's copy from a personal account: `max-bot`, `telegram-bot`. */
+export const isBotProvider = (provider) => provider.endsWith("-bot");
+/** Whether an account of `provider` is inside `source`: also a kind (`messages`, `mail`) or a provider's alias (`tg`). */
+export const inSource = (source, provider) => source === "all" ||
+    (source === "bots" && isBotProvider(provider)) ||
+    (source === "personal" && !isBotProvider(provider)) ||
+    source === provider ||
+    providerNamed(source)?.name === provider ||
+    (isKind(source) && kindOf(provider) === source);
+const FILTERS = ["from", "chat", "after", "before", "has", "in"];
+const DAY = 24 * 60 * 60 * 1000;
+const fail = (message) => {
+    throw new CliError("validation_error", message);
+};
+const tokenize = (query) => {
+    const tokens = [];
+    let at = 0;
+    while (at < query.length) {
+        if (/\s/.test(query[at] ?? "")) {
+            at++;
+            continue;
+        }
+        let negated = false;
+        let filter;
+        const rest = query.slice(at);
+        const named = /^([a-z]+):(?=\S)/i.exec(rest);
+        const name = named?.[1]?.toLowerCase();
+        if (named && FILTERS.includes(name)) {
+            filter = name;
+            at += named[0].length;
+        }
+        else if (query[at] === "-" && query[at + 1] !== undefined && /\S/.test(query[at + 1] ?? "")) {
+            negated = true;
+            at++;
+        }
+        if (query[at] === '"') {
+            const end = query.indexOf('"', at + 1);
+            const close = end === -1 ? query.length : end;
+            tokens.push({ negated, ...(filter ? { filter } : {}), quoted: true, text: query.slice(at + 1, close).trim() });
+            at = close + 1;
+            continue;
+        }
+        const end = query.slice(at).search(/\s/);
+        const close = end === -1 ? query.length : at + end;
+        tokens.push({ negated, ...(filter ? { filter } : {}), quoted: false, text: query.slice(at, close) });
+        at = close;
+    }
+    return tokens;
+};
+const termOf = (token) => {
+    const words = token.text.split(/\s+/).filter(Boolean);
+    return token.quoted && words.length > 1 ? { kind: "phrase", words } : { kind: "word", text: words.join(" ") };
+};
+const day = (name, value, now) => {
+    const back = /^(\d+)d$/.exec(value);
+    if (back)
+        return now - Number(back[1]) * DAY;
+    const date = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    const at = date ? new Date(Number(date[1]), Number(date[2]) - 1, Number(date[3])) : undefined;
+    if (!at || at.getMonth() !== Number(date?.[2]) - 1 || at.getDate() !== Number(date?.[3])) {
+        return fail(`${name}: takes a day, 2026-01-31, or a count of days back, 7d — not "${value}"`);
+    }
+    return at.getTime();
+};
+/**
+ * `in:` and `--source` take a messenger the store holds, `personal`, `bots` or `all`, a held provider's alias
+ * (`tg`), or the kind `messages` or `mail`; an alias and `mail` come back as the provider they stand for.
+ */
+export const sourceOf = (name, value, providers) => {
+    const sources = [...providers, "personal", "bots", "all"];
+    const source = value.toLowerCase();
+    if (sources.includes(source))
+        return source;
+    if (source === "mail")
+        return "email";
+    if (source === "messages")
+        return source;
+    if (isKind(source))
+        fail(`${name}${source} names ${source}, which a message search does not read — ` +
+            `search ${source === "meetings" ? "all --source meetings" : "notes"} does`);
+    const named = providerNamed(source);
+    if (named && providers.includes(named.name))
+        return named.name;
+    return fail(`${name} takes ${[...sources, "messages", "mail"].join(", ")} — not "${value}"`);
+};
+/** `providers` are the messengers the store holds; `in:` takes one of them, or `all`. */
+export const parseQuery = (query, { now = Date.now(), providers = [] } = {}) => {
+    const parsed = { required: [], excluded: [], has: [] };
+    const tokens = tokenize(query);
+    for (let index = 0; index < tokens.length; index++) {
+        const token = tokens[index];
+        if (token.filter) {
+            const { filter, text } = token;
+            if (text === "")
+                fail(`${filter}: needs a value`);
+            if (filter === "has") {
+                parsed.has.push(text.toLowerCase());
+                continue;
+            }
+            if (parsed[filter] !== undefined)
+                fail(`${filter}: is given twice`);
+            if (filter === "after" || filter === "before")
+                parsed[filter] = day(filter, text, now);
+            else if (filter === "in")
+                parsed.in = sourceOf("in:", text, providers);
+            else
+                parsed[filter] = text;
+            continue;
+        }
+        if (token.text === "")
+            continue;
+        if (!token.quoted && token.text === "OR") {
+            const previous = tokens[index - 1];
+            const next = tokens[index + 1];
+            if (previous?.negated || next?.negated)
+                fail("a word left out cannot be one side of OR");
+            const word = (side) => side && !side.filter && side.text !== "" && (side.quoted || side.text !== "OR");
+            if (!word(previous) || !word(next))
+                fail("OR needs a word on each side");
+            parsed.required.at(-1)?.push(termOf(next));
+            index++;
+            continue;
+        }
+        if (token.negated)
+            parsed.excluded.push(termOf(token));
+        else
+            parsed.required.push([termOf(token)]);
+    }
+    if (parsed.required.length === 0 && parsed.excluded.length > 0) {
+        fail("say what to find, not only what to leave out");
+    }
+    return parsed;
+};
+//# sourceMappingURL=query.js.map

package/dist/search/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/search/query.ts"],"names":[],"mappings":"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"}

package/dist/search/question-plan.d.ts

@@ -0,0 +1,12 @@
+export declare const words: (text: string) => RegExpMatchArray | [];
+export declare function planQuestion(text: string, strict?: boolean): {
+    changed: boolean;
+    natural: boolean;
+    queries: string[];
+    scope: string;
+    terms: string[];
+    rankingTerms: string[];
+    removed: string[];
+    aliases: string[];
+};
+//# sourceMappingURL=question-plan.d.ts.map

package/dist/search/question-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-plan.d.ts","sourceRoot":"","sources":["../../src/search/question-plan.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,KAAK,SAAU,MAAM,0BAAmD,CAAA;AAQrF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ;;;;;;;aA4EpC,MAAM,EAAE;aACR,MAAM,EAAE;EAqC5B"}

package/dist/search/question-plan.js

@@ -0,0 +1,121 @@
+import { implicitTextTerms, parseLucene, walkQuery } from "@wirecat/cli-base/query";
+import { normalize } from "../store/normalize.js";
+import { SEARCH_QUERY } from "./lucene/types.js";
+export const words = (text) => normalize(text).match(/[\p{L}\p{N}]+/gu) ?? [];
+const scaffolding = new Set(words("what which how many much who where when is are was were do does did can could should we the a an for of to under from in on at has have сколько какой какая какие какое кто кому кем где когда как что во по на в к с у через ли должен должна нужно идёт идет можно может могут"));
+const questionWord = /\b(?:what|which|how|who|where|when|can|could|should)\b|(?:^|\s)(?:сколько|какой|какая|какие|какое|кто|кому|кем|где|когда|как|что|можно|может|могут|ли)(?:\s|$)/iu;
+export function planQuestion(text, strict = false) {
+    if (strict)
+        return {
+            changed: false,
+            natural: false,
+            queries: [text],
+            scope: "",
+            terms: words(text),
+            rankingTerms: words(text),
+            removed: [],
+            aliases: [],
+        };
+    const inputAst = parseLucene(text, SEARCH_QUERY);
+    const rawTextual = walkQuery(inputAst.root).filter((node) => node.field === "text" || node.field === "exact");
+    const body = rawTextual.map((node) => node.value).join(" ");
+    const prefix = words(body).slice(0, 2);
+    const questionPrefix = [
+        "what",
+        "which",
+        "how",
+        "who",
+        "where",
+        "when",
+        "can",
+        "could",
+        "should",
+        "сколько",
+        "какои",
+        "какая",
+        "какие",
+        "какое",
+        "кто",
+        "кому",
+        "кем",
+        "где",
+        "когда",
+        "как",
+        "что",
+        "можно",
+        "может",
+        "могут",
+    ].includes(prefix[0] ?? "") ||
+        (["к", "во"].includes(prefix[0] ?? "") && ["кому", "сколько"].includes(prefix[1] ?? ""));
+    const natural = questionWord.test(body) && (/\?/u.test(body) || questionPrefix);
+    let cleaned = text;
+    if (natural && !text.includes("\\")) {
+        const last = rawTextual.at(-1);
+        const mark = (last?.span.end ?? 0) - 1;
+        if (last?.operator === "wildcard" && text[mark] === "?")
+            cleaned = text.slice(0, mark) + text.slice(mark + 1);
+    }
+    const ast = cleaned === text ? inputAst : parseLucene(cleaned, SEARCH_QUERY);
+    const predicates = walkQuery(ast.root);
+    const textual = predicates.filter((p) => p.field === "text" || p.field === "exact");
+    const fields = predicates.filter((p) => p.field !== "text" && p.field !== "exact");
+    // A `field:value` term's span covers its field; a term inside `field:( … )` covers only its value.
+    const scope = fields
+        .map((p) => {
+        const raw = cleaned.slice(p.span.start, p.span.end);
+        return new RegExp(`^${p.field}[:=<>]`, "u").test(raw) ? raw : `${p.field}:${raw}`;
+    })
+        .join(" ");
+    const bypass = strict ||
+        !natural ||
+        implicitTextTerms(cleaned).size === 0 ||
+        textual.some((p) => p.operator !== "term" || p.field === "exact");
+    if (bypass)
+        return {
+            changed: false,
+            natural: false,
+            queries: [text],
+            scope,
+            terms: textual.flatMap((p) => words(p.value)),
+            rankingTerms: textual.flatMap((p) => words(p.value)),
+            removed: [],
+            aliases: [],
+        };
+    const original = textual.flatMap((p) => words(p.value));
+    const removed = original.filter((w) => scaffolding.has(w));
+    const terms = [...new Set(original.filter((w) => !scaffolding.has(w)))];
+    if (!terms.length)
+        return {
+            changed: false,
+            natural: true,
+            queries: [text],
+            scope,
+            terms,
+            rankingTerms: original,
+            removed,
+            aliases: [],
+        };
+    const alias = [...terms];
+    const changes = [];
+    const replace = (from, to) => {
+        for (let i = 0; i < alias.length; i++)
+            if (from.includes(alias[i] ?? "")) {
+                changes.push(`${alias[i]} -> ${to}`);
+                alias[i] = to;
+            }
+    };
+    if (terms.some((w) => ["refund", "euros", "euro", "money", "возврата", "возврат", "евро"].includes(w))) {
+        replace(["returned", "refunded", "received"], "refund");
+        replace(["вернули", "возвращено", "перечислено"], "возврат");
+    }
+    if (terms.some((w) => ["log", "logs", "retention", "backup", "логов", "логи", "хранение", "хранения"].includes(w))) {
+        replace(["lifetime", "kept", "keep"], "retention");
+        replace(["хранятся", "хранят", "хранить", "срок"], "хранение");
+    }
+    if (terms.includes("service") || terms.includes("build"))
+        replace(["currently", "now"], "current");
+    const render = (ws) => [...new Set(ws)].join(" ") + (scope ? ` ${scope}` : "");
+    const queries = [...new Set([render(terms), render(alias)])].slice(0, 2);
+    return { changed: true, natural: true, queries, scope, terms, rankingTerms: original, removed, aliases: changes };
+}
+//# sourceMappingURL=question-plan.js.map

package/dist/search/question-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-plan.js","sourceRoot":"","sources":["../../src/search/question-plan.ts"],"names":[],"mappings":"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"}

package/dist/search/search.d.ts

@@ -0,0 +1,27 @@
+import type { MessageStore, ScoredHit, SearchScope, WordQuery } from "../store/store.js";
+/** Which step found a hit (plan S4). `filters` answers a search with no word. */
+export type Match = "words" | "beginnings" | "corrected" | "anyWord" | "substring" | "filters";
+export type SearchHit = ScoredHit & {
+    match: Match;
+};
+export interface SearchAnswer {
+    items: SearchHit[];
+    hasMore: boolean;
+    corrections: {
+        from: string;
+        to: string[];
+    }[];
+    /** `false` while the word index is not built: the answer then came from the substring index alone. */
+    wordsReady: boolean;
+}
+export type SearchSteps = Pick<MessageStore, "searchIndexState" | "matchWords" | "matchSubstring" | "matchFilters" | "knownTerms" | "termCandidates">;
+/**
+ * The search, in the order of plan S4: every word, topped up by word beginnings; then typo
+ * correction; then any word, unless the query chose with OR; then the substring index. Each step
+ * runs only when the one before found nothing. Until the word index is built, substring alone.
+ */
+export declare const search: (store: SearchSteps, query: WordQuery, scope: SearchScope, { limit, newest }: {
+    limit: number;
+    newest?: boolean;
+}) => Promise<SearchAnswer>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAIxF,iFAAiF;AACjF,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;AAE9F,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;IAC7C,sGAAsG;IACtG,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,YAAY,EACZ,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,CACxG,CAAA;AAkCD;;;;GAIG;AACH,eAAO,MAAM,MAAM,UACV,WAAW,SACX,SAAS,SACT,WAAW,qBACS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAC7D,OAAO,CAAC,YAAY,CAwCtB,CAAA"}

package/dist/search/search.js

@@ -0,0 +1,66 @@
+import { correctWords } from "./correct.js";
+const tagged = (page, match) => page.items.map((hit) => ({ ...hit, match }));
+/** Step 1 topped up by step 2: whole words first, then the hits only a word's beginning finds. */
+const everyWord = async (store, query, scope, { limit, newest }, match) => {
+    const options = { mode: "every", limit, newest };
+    const whole = await store.matchWords(query, scope, { ...options, beginnings: false });
+    if (whole.items.length >= limit)
+        return { items: tagged(whole, match.whole), hasMore: whole.hasMore };
+    const begun = await store.matchWords(query, scope, { ...options, beginnings: true });
+    const seen = new Set(whole.items.map((hit) => hit.locator));
+    const more = tagged(begun, match.beginnings).filter((hit) => !seen.has(hit.locator));
+    const items = [...tagged(whole, match.whole), ...more];
+    return { items: items.slice(0, limit), hasMore: items.length > limit || begun.hasMore };
+};
+/** Every plain word replaced by its corrections, when it has any; phrases and left-out words never are. */
+const corrected = (query, corrections) => ({
+    ...query,
+    required: query.required.map((group) => group.flatMap((term) => term.kind === "word" && corrections.has(term.text)
+        ? (corrections.get(term.text) ?? []).map((text) => ({ kind: "word", text }))
+        : [term])),
+});
+/**
+ * The search, in the order of plan S4: every word, topped up by word beginnings; then typo
+ * correction; then any word, unless the query chose with OR; then the substring index. Each step
+ * runs only when the one before found nothing. Until the word index is built, substring alone.
+ */
+export const search = async (store, query, scope, { limit, newest = false }) => {
+    const wordsReady = (await store.searchIndexState())?.ready === true;
+    const answer = (found, rest = {}) => ({
+        corrections: [],
+        wordsReady,
+        ...found,
+        ...rest,
+    });
+    if (query.required.length === 0) {
+        const page = await store.matchFilters(scope, { limit });
+        return answer({ items: tagged(page, "filters"), hasMore: page.hasMore });
+    }
+    if (!wordsReady) {
+        const page = await store.matchSubstring(query, scope, { limit });
+        return answer({ items: tagged(page, "substring"), hasMore: page.hasMore });
+    }
+    const options = { limit, newest };
+    const found = await everyWord(store, query, scope, options, { whole: "words", beginnings: "beginnings" });
+    if (found.items.length > 0)
+        return answer(found);
+    const plain = query.required.flat().flatMap((term) => (term.kind === "word" ? [term.text] : []));
+    const corrections = await correctWords(store, [...new Set(plain)]);
+    const listed = [...corrections].map(([from, to]) => ({ from, to }));
+    const fixed = corrections.size > 0 ? corrected(query, corrections) : query;
+    if (corrections.size > 0) {
+        const repaired = await everyWord(store, fixed, scope, options, { whole: "corrected", beginnings: "corrected" });
+        if (repaired.items.length > 0)
+            return answer(repaired, { corrections: listed });
+    }
+    const chose = query.required.some((group) => group.length > 1);
+    if (!chose && query.required.length > 1) {
+        const any = await store.matchWords(fixed, scope, { mode: "any", beginnings: true, limit, newest });
+        if (any.items.length > 0)
+            return answer({ items: tagged(any, "anyWord"), hasMore: any.hasMore }, { corrections: listed });
+    }
+    // The raw text is searched as typed: a correction is a guess about words, not about pieces of them.
+    const page = await store.matchSubstring(query, scope, { limit });
+    return answer({ items: tagged(page, "substring"), hasMore: page.hasMore });
+};
+//# sourceMappingURL=search.js.map

package/dist/search/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"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"}

package/dist/search/snowball/LICENSE

@@ -0,0 +1,29 @@
+Copyright (c) 2001, Dr Martin Porter
+Copyright (c) 2004,2005, Richard Boulton
+Copyright (c) 2013, Yoshiki Shibukawa
+Copyright (c) 2006-2025, Olly Betts
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+  1. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+  2. Redistributions in binary form must reproduce the above copyright notice,
+     this list of conditions and the following disclaimer in the documentation
+     and/or other materials provided with the distribution.
+  3. Neither the name of the Snowball project nor the names of its contributors
+     may be used to endorse or promote products derived from this software
+     without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.