dirsql 0.4.74 → 0.4.76

package/docs/reference/cli.md

@@ -278,7 +278,7 @@ with all seven [stat columns](./columns.md): `path`, `basename`, `dir`, `ext`,
 
 ```bash
 curl -s localhost:7117/query -H 'content-type: application/json' \
-  -d '{"sql":"SELECT basename, size FROM \'./\' ORDER BY size DESC LIMIT 5"}'
+  -d "{\"sql\":\"SELECT basename, size FROM './' ORDER BY size DESC LIMIT 5\"}"
 ```
 
 Earlier versions served an implicit table named `files` here. It is gone; a

package/docs/reference/http-api.md

@@ -27,7 +27,7 @@ The `200` response is a JSON array of row objects keyed by column name:
 ```bash
 curl -s http://localhost:7117/query \
   -H 'content-type: application/json' \
-  -d '{"sql":"SELECT COUNT(*) AS n FROM \'./\'"}' \
+  -d "{\"sql\":\"SELECT COUNT(*) AS n FROM './'\"}" \
   | jq
 ```
 

package/docs/reference/path-tables.md

@@ -55,9 +55,10 @@ A path containing `*`, `?`, `[` or `{` is a glob and is used exactly as
 written: `*` matches within a single directory, `**` crosses directories.
 
 The scan starts at the last directory named outright before the first glob
-component -- `'./small/*.md'` walks `small/` and nothing else -- so a query
-over one directory costs what `find ./small` costs, however large the
-directories beside it.
+component, and descends only as deep as the pattern can match --
+`'./small/*.md'` lists `small/` and nothing else -- so a query over one
+directory costs what `ls small` costs, however large the directories beside
+or below it. Only `**` walks a whole subtree.
 
 A path naming a single file yields exactly one row. dirsql never splits a file
 into rows on its own — that is what a table's `on_file` hook is for.
@@ -260,15 +261,21 @@ 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
+Path-table scans also respect `.gitignore` files by default, inside a git
+repo, the way git, fd and ripgrep do: a `.gitignore` 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
+excludes build output, virtualenvs, and caches with zero ceremony. The
+built-in defaults above remain as a floor for directories with no
 `.gitignore` at all.
 
+A `.gitignore` is in force only when a directory holding `.git` encloses it.
+Outside a repo none applies, at the scan's start, above it or below it: a
+`~/.claude` whose `.gitignore` is `*` still lists its files when `~/.claude`
+is not a repo. Inside one, every `.gitignore` from the repo root down
+applies, including those above the directory a scan starts in, so
+`'./docs/*.log'` and `'./**/*.log'` agree about `docs/`.
+
 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
@@ -285,8 +292,17 @@ SELECT path FROM './node_modules/*/package.json';  -- scans it anyway
 SELECT path FROM './dist';                 -- scans dist/ even when gitignored
 ```
 
-A `.gitignore` at or below the directory the scan starts in still filters
-beneath it; one above it is never read.
+The `.gitignore` files in force there, including those above it, still
+filter what lies beneath it.
+
+A `node_modules` component after a glob names it too, at any depth:
+
+```sql
+SELECT path FROM './**/node_modules/*/package.json';  -- every node_modules
+SELECT path FROM './*/node_modules/**';               -- one level down
+```
+
+Only the literal name counts; `'./**/*.js'` still skips every `node_modules`.
 
 ### Hidden files
 

package/package.json

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