dirsql 0.4.6 → 0.4.7

package/docs/reference/cli.md

@@ -69,6 +69,7 @@ Config flags are subcommand-local: pass them after `server`
 | `--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). Also available on [`dirsql query`](#dirsql-query). See [Keep the index across restarts](../howto/persist.md). |
+| `--no-ignore` | off | Scan files a `.gitignore` would hide. [Path-tables](./path-tables.md#skip-rules) respect `.gitignore` files by default; this flag restores the full walk. The built-in skips (`node_modules`/`.git`) and configured `ignore` patterns still apply. Also available on [`dirsql query`](#dirsql-query). |
 | `--extension <path>` | none | Load a SQLite extension by literal path, overriding the config's `[[dirsql.extension]]` entries. Repeatable. Format: `<path>` or `<path>::<entrypoint>`. Internal plumbing for the pip/npm launchers, which resolve package-name extensions and pass the resolved paths here — not intended for direct use. When any `--extension` is present, the config file's own extension entries are not loaded. |
 | `--version` | | Print the version and exit. |
 | `--help` | | Print usage and exit. |
@@ -163,6 +164,8 @@ uses**, so behavior is identical to `POST /query` by construction:
   on-disk cache. Because its value is optional, place a bare `--persist` after
   the SQL (`dirsql query "SELECT …" --persist`) or use the `=` form
   (`--persist=/path`) so it does not swallow the SQL argument.
+- **`--no-ignore`** is honored: path-tables in the query scan files a
+  `.gitignore` would hide. See [Skip rules](./path-tables.md#skip-rules).
 - **Hooks** ([`pre-query`](./hooks.md#pre-query) /
   [`post-query`](./hooks.md#post-query)) and the
   [`[dirsql].hook-timeout`](./config.md#dirsql-keys) apply identically.

package/docs/reference/path-tables.md

@@ -179,19 +179,48 @@ A path-table scan applies the same [`ignore`](/reference/config) patterns your
 declared tables use, plus two built-in defaults so a zero-config
 `SELECT * FROM './'` does not drown in machinery:
 
-- `node_modules/**`
-- `.git/**`
+- `**/node_modules/**`
+- `**/.git/**`
+
+Both apply at any depth, so a `node_modules` nested inside a subdirectory is
+skipped just like one at the top.
+
+### `.gitignore`
+
+Path-table scans also respect `.gitignore` files by default, the way fd and
+ripgrep do: a `.gitignore` anywhere in the tree applies below its own
+directory, deeper files override shallower ones, `!pattern` re-includes, and
+an ignored directory is pruned rather than walked. In a typical repo this
+excludes build output, virtualenvs, and caches with zero ceremony. No `.git`
+directory is required — a `.gitignore` in any scanned directory counts — and
+the built-in defaults above remain as a floor for directories with no
+`.gitignore` at all.
+
+Pass [`--no-ignore`](./cli.md#flags) to restore the full walk — the
+determinism switch for scripted use, since results otherwise depend on
+`.gitignore` state. It disables only the `.gitignore` respect; the built-in
+defaults and configured `ignore` patterns still apply.
+
+### Naming a skipped directory
 
 Skip rules are judged on the part of the path *below* what you named outright,
-so pointing at a skipped directory still scans it:
+so pointing at a skipped directory — built-in or gitignored — still scans it:
 
 ```sql
 SELECT path FROM './';                     -- no node_modules rows
 SELECT path FROM './node_modules/*/package.json';  -- scans it anyway
+SELECT path FROM './dist';                 -- scans dist/ even when gitignored
 ```
 
-Dotfiles are ordinary files: `'./'` and `'./*'` include them. Add an `ignore`
-pattern if you would rather not see them.
+A `.gitignore` at or below the directory you named still filters beneath it;
+only rules inherited from above it are set aside.
+
+### Hidden files
+
+Dotfiles are ordinary files: `'./'` and `'./*'` include them, with or without
+`--no-ignore`. This is a deliberate divergence from fd/ripgrep — querying
+dotfile directories (`.claude/`, …) is a first-class `dirsql` use case. Add an
+`ignore` pattern if you would rather not see them.
 
 ## Joining against declared tables
 

package/package.json

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