dirsql 0.3.99 → 0.3.101

package/docs/howto/define-tables.md

@@ -42,9 +42,10 @@ zero-config default — only the tables you define are served.
 
 ## Multiple tables
 
-Add one `[[table]]` entry per table. When a file matches several globs, the
-first matching table wins — see [`[[table]]`](../reference/config.md#table)
-for that and the remaining keys (`strict`, `on-file`).
+Add one `[[table]]` entry per table. When a file matches several globs, it
+populates every matching table — each table is an independent view. See
+[`[[table]]`](../reference/config.md#table) for that and the remaining keys
+(`strict`, `on-file`).
 
 ## Going further
 

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

@@ -97,7 +97,7 @@ per-file command.
 | Key | Required | Description |
 |---|---|---|
 | `ddl` | yes | A SQLite `CREATE TABLE` statement. The table name is parsed from it. Only columns declared here are populated; auto-injected facts not in the DDL are dropped. |
-| `glob` | yes | Glob pattern matched against root-relative paths. May contain `{name}` [capture segments](./columns.md#glob-captures). First matching table wins when a file matches several globs. |
+| `glob` | yes | Glob pattern matched against root-relative paths. May contain `{name}` [capture segments](./columns.md#glob-captures). Every table whose glob matches a file receives that file's rows — a file can populate multiple tables. |
 | `strict` | no (default `false`) | When `true`, rows whose keys do not exactly match the declared columns are rejected with an error: extra keys error, and every declared column must be supplied (by the command/extract output, a glob capture, or a stat column). When `false`, extra keys are dropped and missing columns become `NULL`. |
 | `on-file` | no | A command run once per matched file; its stdout (a JSON array of row objects) becomes the file's rows. Must be non-empty. See [Command hooks](./hooks.md#on-file). |
 
@@ -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/docs/reference/sdk.md

@@ -318,7 +318,9 @@ Maps files to table rows.
 - `ddl` — A SQLite `CREATE TABLE` statement; the table name is parsed from
   it. Table names must be unique across all tables.
 - `glob` — Glob pattern matched against root-relative paths. May contain
-  `{name}` [captures](./columns.md#glob-captures).
+  `{name}` [captures](./columns.md#glob-captures). Every table whose glob
+  matches a file receives that file's rows — a file can populate multiple
+  tables.
 - `extract` — Callback receiving the matched file's full path (the root
   joined with the file's relative path — absolute when `root` is absolute)
   and returning the rows that file contributes. `dirsql` never reads file

package/package.json

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