dirsql 0.3.100 → 0.3.101

package/docs/reference/cli.md

@@ -45,7 +45,7 @@ requests, closes open `/events` streams, and exits.
 
 | Flag | Default | Description |
 |---|---|---|
-| `-c, --config <path>` | `./.dirsql.toml` | Path to the [config file](./config.md). The index is always rooted at the **invocation directory** (the current working directory), regardless of where this file lives — so `--config /elsewhere/.dirsql.toml` still indexes the directory you ran `dirsql` from. When the file does not exist, the server runs in [zero-config mode](#zero-config-mode). |
+| `-c, --config <path>` | `./.dirsql.toml` | Path to a [config file](./config.md). **Repeatable** (`-c a -c b`): the configs load and merge in argv order — see [Composing multiple configs](./config.md#composing-multiple-configs). The index is always rooted at the **invocation directory** (the current working directory), regardless of where a config lives — so `--config /elsewhere/.dirsql.toml` still indexes the directory you ran `dirsql` from. With none given, `./.dirsql.toml` is used; when it does not exist, the server runs in [zero-config mode](#zero-config-mode). |
 | `--host <addr>` | `localhost` | Bind address. |
 | `--port <n>` | `7117` | TCP port to bind. |
 | `--persist [<path>]` | off | Keep the SQLite index on disk between runs so a restart only re-parses files that actually changed. Bare `--persist` caches at `<root>/.dirsql/cache.db`; `--persist <path>` caches at `<path>`. Off by default (the index is ephemeral). Global — also honored by [`dirsql query`](#dirsql-query). See [Keep the index across restarts](../howto/persist.md). |

package/docs/reference/config.md

@@ -131,6 +131,38 @@ by the command wins over a same-named fact. Output that is not a JSON array
 of objects is a per-file failure: the file is skipped with a stderr warning
 and the scan continues (see [failure semantics](./hooks.md#failure-semantics)).
 
+## Composing multiple configs
+
+Pass [`-c`/`--config`](./cli.md#flags) more than once to compose several config
+files — a shared team config plus local overrides, or a plugin's config
+alongside your own:
+
+```bash
+dirsql -c ./.dirsql.toml -c ~/team/embeddings.toml -c ./local.toml
+```
+
+The configs load and merge in **argv order**:
+
+- **`[[table]]`, `ignore`, and `[[dirsql.extension]]` entries accumulate** across
+  all configs, in order.
+- **Each config's `on-file`, `pre-query`, and `post-query` hooks run from that
+  config file's own directory**, under that config's own
+  [`hook-timeout`](#dirsql-keys) — so a relative command like
+  `on-file = "sh ./extract.sh"` resolves against the config that declared it,
+  wherever it lives.
+- **`pre-query` / `post-query` hooks chain FIFO**: the request body flows through
+  each `pre-query` stage in order to the final SQL, and the result rows flow
+  through each `post-query` stage to the response. See the
+  [hook contract](./hooks.md).
+- Each config is **validated on its own** (the [parse errors](#parse-errors)
+  below apply per file). There is no cross-file merge validation, with one
+  structural exception: **two configs defining a table of the same name is an
+  error**, naming the table.
+
+The index [root](./cli.md#flags) is the invocation directory regardless of where
+any config lives. With no `-c`, `./.dirsql.toml` is used; a single `-c` behaves
+exactly as before.
+
 ## Parse errors
 
 Loading fails (the CLI enters [degraded mode](./cli.md#degraded-mode); the

package/package.json

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