dirsql 0.4.32 → 0.4.34

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

@@ -483,6 +483,24 @@ dirsql: indexed 41231 files in 3m12s
 
 stdout is untouched — it carries the query result and nothing else.
 
+A query gets the same treatment when it calls a
+[worker-backed function](./config.md#dirsql-function). Those cost one round
+trip per row, so a query that calls one over a whole corpus is the slowest
+thing dirsql does:
+
+```
+dirsql: running 9204 worker calls
+```
+
+and, when the query ends:
+
+```
+dirsql: ran 41231 worker calls in 2m41s
+```
+
+A query that calls no worker prints nothing, whatever the setting — the
+reporting only ever speaks when there is something to report.
+
 By default this is **terminal-only, and only for work slow enough to wonder
 about**: a phase that finishes in under half a second prints nothing at all,
 and a run whose stderr is a pipe or a file prints nothing regardless of how

package/docs/reference/config.md

@@ -133,6 +133,11 @@ process alive for the rest of the invocation, sending it every subsequent
 call — one process total, never one per row or per file. The worker is torn
 down when the invocation ends.
 
+A query paying per-row round trips reports them on stderr while it runs
+(`dirsql: running 9204 worker calls`), on the same terms as every other
+[progress line](./cli.md#progress-reporting): terminal-only by default, silent
+on a pipe, and gone before the result is printed.
+
 The `timeout` bounds each **round-trip call**, not the query: a query that
 calls the function on 10 000 rows is 10 000 individually timed calls. A call
 that times out, or a worker that crashes or closes its pipes, fails the query

package/docs/reference/sdk.md

@@ -408,6 +408,10 @@ one summary of what each cost:
 dirsql: indexed 41231 files in 3m12s
 ```
 
+A `query` that calls a worker-backed function is reported the same way, as a
+running count of round trips (`dirsql: running 9204 worker calls`) — the shape
+`dirsql-plugin-embeddings` produces when it embeds a corpus one row at a time.
+
 This is terminal-only by default, and only for a phase that runs longer than
 half a second — a program whose stderr is a pipe, a file, or a log collector
 sees nothing, whatever the scan costs. Set `DIRSQL_PROGRESS=never` to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.32",
+  "version": "0.4.34",
   "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.32",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.32",
-    "@dirsql/lib-darwin-x64": "0.4.32",
-    "@dirsql/lib-darwin-arm64": "0.4.32",
-    "@dirsql/lib-win32-x64-msvc": "0.4.32"
+    "@dirsql/lib-linux-x64-gnu": "0.4.34",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.34",
+    "@dirsql/lib-darwin-x64": "0.4.34",
+    "@dirsql/lib-darwin-arm64": "0.4.34",
+    "@dirsql/lib-win32-x64-msvc": "0.4.34"
   }
 }