@intentic/base 1.303.0 → 1.305.0

package/README.md

@@ -1,7 +1,7 @@
 # @intentic/base
 
-The runtime primitives every tier shares: the `when` condition language, disposal, the async schedulers, and
-the outside-text neutralizer.
+The runtime primitives every tier shares: the `when` condition language, disposal, the async schedulers, the
+outside-text neutralizer, the fuzzy path scorer, and the SQLite driver seam.
 
 Almost nothing in here knows what this product is. That is the point: each module replaced a decision
 that had been made independently, and differently, in the daemon and in the web app, where the copies could
@@ -25,6 +25,12 @@ and a package that offers them as one thing invites being treated as a junk draw
   reserved tokens are folded (homoglyphs, zero-width characters) and replaced before content is sealed or
   written to disk. Shared because the daemon's seams, webq's saved pages and fileq's derived sidecars must all
   neutralize identically — a drifted copy is a working forgery.
+- **`fuzzy`**: the fzf-style path scorer and the ranking order built on it. Both ends of quick-open answer with
+  it — the sandbox's iq `files` engine and the app's own search box — and they used to answer with two copies of
+  it, kept identical by hand, where the same keystrokes could have put a different file first on either side.
+- **`sqlite`**: the narrow seam a `node:sqlite` store is written against — the five-method driver interface, the
+  BEGIN/COMMIT/ROLLBACK transaction the driver has no helper for, and the schema-version guard that treats a
+  mismatch as cache loss. iq's index and iq's session recall are written against this one, not against two.
 - **`async`**: the four shapes of "don't do that again yet", named so the choice between them is visible:
   `Delayer` restarts its clock on every call, `Coalescer` opens a window on the first call and lets later ones
   join it, `SingleFlight` shares one run per key among concurrent callers, and `retry` is the loop with the
@@ -60,6 +66,8 @@ when nobody needs it any more.
 - [src/when.ts](src/when.ts): the grammar, the parser, and what a condition means against a context.
 - [src/lifecycle.ts](src/lifecycle.ts): `DisposableStore` and the two things built on it.
 - [src/async.ts](src/async.ts): the schedulers, each with the case that made it a separate name.
+- [src/fuzzy.ts](src/fuzzy.ts): the path scorer, with its substring/subsequence split and why the substring
+  branch is deliberately uncapped.
 - [src/when.test.ts](src/when.test.ts), the evaluation rules that are decisions rather than syntax: an absent
   key is false, ordering refuses anything but numbers, comparison crosses the type boundary by string form.
 - [src/async.test.ts](src/async.test.ts): the Delayer/Coalescer distinction pinned as behaviour.

package/dist/fuzzy.d.ts

@@ -0,0 +1,6 @@
+export declare const fuzzyScore: (needle: string, path: string) => number | undefined;
+export declare const rankByFuzzy: (needle: string, paths: Iterable<string>) => {
+    readonly path: string;
+    readonly score: number;
+}[];
+//# sourceMappingURL=fuzzy.d.ts.map

package/dist/fuzzy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../src/fuzzy.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,UAAU,WAAY,MAAM,QAAQ,MAAM,KAAG,MAAM,GAAG,SAalE,CAAC;AAMF,eAAO,MAAM,WAAW,WAAY,MAAM,SAAS,QAAQ,CAAC,MAAM,CAAC,KAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAStH,CAAC"}

package/dist/fuzzy.js

@@ -0,0 +1,43 @@
+const BOUNDARY = new Set(["/", ".", "_", "-"]);
+const substringScore = (haystack, at) => 0.75 + (at >= haystack.lastIndexOf("/") + 1 ? 0.2 : 0) + 5 / haystack.length;
+const subsequenceScore = (needle, haystack, path) => {
+    let score = 0;
+    let hi = 0;
+    let previousHit = -2;
+    for (let ni = 0; ni < needle.length; ni++) {
+        const ch = needle[ni];
+        const found = haystack.indexOf(ch, hi);
+        if (found === -1) {
+            return undefined;
+        }
+        const boundary = found === 0 || BOUNDARY.has(haystack[found - 1]) || (path[found] !== undefined && path[found] >= "A" && path[found] <= "Z");
+        score += 1 + (found === previousHit + 1 ? 0.8 : 0) + (boundary ? 0.6 : 0);
+        previousHit = found;
+        hi = found + 1;
+    }
+    return score;
+};
+export const fuzzyScore = (needle, path) => {
+    const n = needle.toLowerCase();
+    const h = path.toLowerCase();
+    if (n.length === 0 || n.length > h.length) {
+        return undefined;
+    }
+    const at = h.indexOf(n);
+    if (at !== -1) {
+        return substringScore(h, at);
+    }
+    const raw = subsequenceScore(n, h, path);
+    return raw === undefined ? undefined : (raw / (n.length * 2.4)) * 0.7 * Math.min(1, 20 / Math.max(20, h.length - n.length));
+};
+export const rankByFuzzy = (needle, paths) => {
+    const scored = [];
+    for (const path of paths) {
+        const score = fuzzyScore(needle, path);
+        if (score !== undefined) {
+            scored.push({ path, score });
+        }
+    }
+    return scored.toSorted((a, b) => b.score - a.score || (a.path < b.path ? -1 : 1));
+};
+//# sourceMappingURL=fuzzy.js.map

package/dist/fuzzy.js.map

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

package/dist/sqlite.d.ts

@@ -0,0 +1,13 @@
+import type { DatabaseSync } from "node:sqlite";
+export type SqliteValue = string | number | bigint | Uint8Array | null;
+export type Row = Record<string, SqliteValue>;
+export interface SqliteDb {
+    all(sql: string, ...params: SqliteValue[]): Row[];
+    get(sql: string, ...params: SqliteValue[]): Row | undefined;
+    run(sql: string, ...params: SqliteValue[]): void;
+    transaction(fn: () => void): void;
+    close(): void;
+}
+export declare const wrapDb: (db: DatabaseSync) => SqliteDb;
+export declare const guardSchemaVersion: (db: SqliteDb, version: string, label: string) => void;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AACvE,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACrB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,GAAG,SAAS,CAAC;IAC5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClC,KAAK,IAAI,IAAI,CAAC;CACjB;AAMD,eAAO,MAAM,MAAM,OAAQ,YAAY,KAAG,QAiBxC,CAAC;AAMH,eAAO,MAAM,kBAAkB,OAAQ,QAAQ,WAAW,MAAM,SAAS,MAAM,KAAG,IAUjF,CAAC"}

package/dist/sqlite.js

@@ -0,0 +1,31 @@
+export const wrapDb = (db) => ({
+    all: (sql, ...params) => db.prepare(sql).all(...params),
+    get: (sql, ...params) => db.prepare(sql).get(...params),
+    run: (sql, ...params) => {
+        db.prepare(sql).run(...params);
+    },
+    transaction: (fn) => {
+        db.exec("BEGIN");
+        try {
+            fn();
+            db.exec("COMMIT");
+        }
+        catch (error) {
+            db.exec("ROLLBACK");
+            throw error;
+        }
+    },
+    close: () => db.close(),
+});
+export const guardSchemaVersion = (db, version, label) => {
+    const found = db.get("SELECT value FROM meta WHERE key = 'schema_version'")?.["value"];
+    if (found === undefined) {
+        db.run("INSERT INTO meta (key, value) VALUES ('schema_version', ?)", version);
+        return;
+    }
+    if (found !== version) {
+        db.close();
+        throw new Error(`${label} schema ${String(found)} != ${version}`);
+    }
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAgB,EAAY,EAAE,CAAC,CAAC;IACnD,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAU;IAChE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAoB;IAC1E,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE;QACpB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE;QAChB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC;YACD,EAAE,EAAE,CAAC;YACL,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpB,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IACD,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;CAC1B,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAY,EAAE,OAAe,EAAE,KAAa,EAAQ,EAAE;IACrF,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,qDAAqD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,EAAE,CAAC,GAAG,CAAC,4DAA4D,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO;IACX,CAAC;IACD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACpB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;AACL,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/base",
-  "version": "1.303.0",
+  "version": "1.305.0",
   "description": "Runtime primitives every tier shares, when-expressions, disposal, and the async schedulers",
   "license": "MIT",
   "type": "module",
@@ -83,6 +83,28 @@
         "default": "./dist/format.js"
       }
     },
+    "./fuzzy": {
+      "types": "./dist/fuzzy.d.ts",
+      "import": {
+        "@intentic/src": "./src/fuzzy.ts",
+        "default": "./dist/fuzzy.js"
+      },
+      "require": {
+        "@intentic/src": "./src/fuzzy.ts",
+        "default": "./dist/fuzzy.js"
+      }
+    },
+    "./sqlite": {
+      "types": "./dist/sqlite.d.ts",
+      "import": {
+        "@intentic/src": "./src/sqlite.ts",
+        "default": "./dist/sqlite.js"
+      },
+      "require": {
+        "@intentic/src": "./src/sqlite.ts",
+        "default": "./dist/sqlite.js"
+      }
+    },
     "./plain-text": {
       "types": "./dist/plain-text.d.ts",
       "import": {
@@ -101,15 +123,16 @@
   "devDependencies": {
     "@intentic/testing": "0.0.0",
     "@intentic/tsconfig": "0.0.0",
+    "@types/bun": "1.4.0",
     "@types/node": "24.13.2",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
-    "vitest": "4.1.10"
+    "fast-check": "4.9.0"
   },
   "scripts": {
     "build": "tsgo",
     "typecheck": "tsgo --noEmit -p tsconfig.test.json",
     "watch": "tsgo --build --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "test": "suites",
+    "test:watch": "suites --watch"
   }
 }