dirsql 0.4.33 → 0.4.35

package/dist/cli/config-paths-from-argv.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Every config value in argv, in order (`--config X`, `--config=X`, `-c X`,
+ * `-c=X`, `-cX`), or the default when none are given.
+ */
+export declare function configPathsFromArgv(argv: string[]): string[];

package/dist/cli/config-paths-from-argv.js

@@ -0,0 +1,31 @@
+// The `-c`/`--config` flag is repeatable, so the scan collects every
+// occurrence, in argv order.
+/**
+ * Every config value in argv, in order (`--config X`, `--config=X`, `-c X`,
+ * `-c=X`, `-cX`), or the default when none are given.
+ */
+export function configPathsFromArgv(argv) {
+    const paths = [];
+    let expectValue = false;
+    for (const a of argv) {
+        if (expectValue) {
+            paths.push(a);
+            expectValue = false;
+        }
+        else if (a === "--config" || a === "-c") {
+            expectValue = true;
+        }
+        else if (a.startsWith("--config=")) {
+            paths.push(a.slice("--config=".length));
+        }
+        else if (a.startsWith("-c")) {
+            const value = a.slice("-c".length);
+            paths.push(value.startsWith("=") ? value.slice("=".length) : value);
+        }
+    }
+    if (expectValue) {
+        // A bare trailing flag (no following value) yields "".
+        paths.push("");
+    }
+    return paths.length > 0 ? paths : ["./.dirsql.toml"];
+}

package/dist/cli/resolve-config-extensions.js

@@ -7,45 +7,14 @@
 // resolved literal paths to the binary via repeatable `--extension` flags;
 // the binary then loads those and ignores the configs' own extension entries.
 //
-// The `-c`/`--config` flag is repeatable, so the scan collects every
-// occurrence, in argv order.
-//
 // Native-language configs (`.py`/`.js`/`.mjs`/`.cjs`) are untouched: the binary
 // dispatches those to `dirsql interpret`, whose handshake already carries
 // resolved paths.
 import { existsSync } from "node:fs";
+import { configPathsFromArgv } from "./config-paths-from-argv.js";
 // Config extensions the binary dispatches to `dirsql interpret`; never
 // pre-resolved here (that path resolves via the handshake).
 const NATIVE_CONFIG_SUFFIXES = [".py", ".js", ".mjs", ".cjs"];
-/**
- * Every config value in argv, in order (`--config X`, `--config=X`, `-c X`,
- * `-c=X`, `-cX`), or the default when none are given.
- */
-function configPathsFromArgv(argv) {
-    const paths = [];
-    let expectValue = false;
-    for (const a of argv) {
-        if (expectValue) {
-            paths.push(a);
-            expectValue = false;
-        }
-        else if (a === "--config" || a === "-c") {
-            expectValue = true;
-        }
-        else if (a.startsWith("--config=")) {
-            paths.push(a.slice("--config=".length));
-        }
-        else if (a.startsWith("-c")) {
-            const value = a.slice("-c".length);
-            paths.push(value.startsWith("=") ? value.slice("=".length) : value);
-        }
-    }
-    if (expectValue) {
-        // A bare trailing flag (no following value) yields "".
-        paths.push("");
-    }
-    return paths.length > 0 ? paths : ["./.dirsql.toml"];
-}
 /**
  * Return `argv` augmented with `--extension <path>[::entrypoint]` flags when a
  * TOML config names an extension by package name; otherwise return `argv`

package/docs/reference/cli.md

@@ -498,6 +498,24 @@ and, when the query ends:
 dirsql: ran 41231 worker calls in 2m41s
 ```
 
+A worker that keeps a cache of its own can say so per response
+(`{"meta": {"cached": true}}` — see [Worker
+protocol](./config.md#worker-protocol)), and those round trips are then split
+out, because the number that answers *"will this be fast next time"* is not
+the total:
+
+```
+dirsql: running 9204 worker calls (8811 cached)
+dirsql: ran 41231 worker calls in 2m41s (38104 cached)
+```
+
+Both figures count **worker round trips, not rows**. A function declared
+`deterministic = true` lets SQLite reuse one answer for identical arguments
+within a query, so repeated content never reaches the worker at all and both
+numbers sit below the row count on a corpus with duplicates. The split covers
+only what the worker itself reports serving from cache. A worker that sends no
+`meta` gets the unsplit line above, not a `(0 cached)`.
+
 A query that calls no worker prints nothing, whatever the setting — the
 reporting only ever speaks when there is something to report.
 

package/docs/reference/config.md

@@ -161,6 +161,15 @@ request line in, one response line out, per call:
   JSON-text vectors) — or `{"err": "message"}`, which **fails the query**
   with that message. An `{"err": ...}` response leaves the healthy worker
   running; only transport failures (timeout, crash) recycle it.
+- **Optional `"meta"`**, alongside `"ok"`: a second top-level object carrying
+  facts about how the answer was produced rather than what it is. One key is
+  read today — `{"ok": [...], "meta": {"cached": true}}` says the worker
+  answered from a cache of its own, which dirsql reports as the `(N cached)`
+  split on its [worker-call progress line](./cli.md#progress-reporting). The
+  field is **optional and advisory**: a worker that omits it is a worker that
+  reports no cache hits, keys dirsql does not recognize are ignored (they
+  always have been), and a `meta` of an unexpected shape is ignored too rather
+  than failing a query over a progress counter.
 - **stderr passes through** to `dirsql`'s stderr, so a worker's progress
   bars and download logs reach the terminal.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.33",
+  "version": "0.4.35",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -213,10 +213,10 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.4.33",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.33",
-    "@dirsql/lib-darwin-x64": "0.4.33",
-    "@dirsql/lib-darwin-arm64": "0.4.33",
-    "@dirsql/lib-win32-x64-msvc": "0.4.33"
+    "@dirsql/lib-linux-x64-gnu": "0.4.35",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.35",
+    "@dirsql/lib-darwin-x64": "0.4.35",
+    "@dirsql/lib-darwin-arm64": "0.4.35",
+    "@dirsql/lib-win32-x64-msvc": "0.4.35"
   }
 }