dirsql 0.4.62 → 0.4.64

package/docs/getting-started.md

@@ -81,11 +81,15 @@ The first run downloads the package (`npx` asks for confirmation — answer
 `y`; `uvx` prints download progress), then prints the result:
 
 ```
-[{"files":3}]
+files
+-----
+3
+
+1 row
 ```
 
 Three files, three rows. That one command scanned the directory, handed
-SQLite one row per file, ran your SQL, and printed the answer as JSON.
+SQLite one row per file, ran your SQL, and printed the answer.
 
 There is no named table here — you never declared one. `'./'` is a
 [path-table](./reference/path-tables.md): a quoted path written where a table
@@ -94,8 +98,9 @@ in. The path *is* the query.
 
 ## 3. Select some columns
 
-The response is always a JSON array of row objects, so from here on we pipe
-it through `jq` to pretty-print. Ask for two columns instead of a count:
+At a terminal `dirsql` prints a table; when its output is piped, it prints a
+JSON array of row objects instead. From here on we pipe it through `jq` to
+pretty-print. Ask for two columns instead of a count:
 
 ::: code-group
 

package/docs/howto/write-a-plugin.md

@@ -60,11 +60,12 @@ its `embed()` SQL function),
 and [`ignore`](../reference/config.md#dirsql-keys).
 
 There are **no plugin-specific keys and no plugin-specific restrictions**. The
-config schema is content-only: the index `root` and `--persist` are
-[runner-owned flags](../reference/config.md#dirsql-keys) (`--root`, `--persist
-[PATH]`), decided by whoever runs `dirsql`, never by a config file — so a
-plugin has nothing to say about them. Whatever you can put in your own
-`.dirsql.toml`, a plugin can put in its fragment, and vice-versa.
+config schema is content-only: the index root and persistence are
+[runner-owned](../reference/config.md#dirsql-keys) — the root is the directory
+`dirsql` is run from (or an SDK's explicit `root`), persistence is the
+`--persist [PATH]` flag — decided by whoever runs `dirsql`, never by a config
+file, so a plugin has nothing to say about them. Whatever you can put in your
+own `.dirsql.toml`, a plugin can put in its fragment, and vice-versa.
 
 ## Hook commands
 

package/docs/reference/cli.md

@@ -1,11 +1,13 @@
 # CLI
 
-Query is the default: `dirsql "<sql>"` runs one query and prints JSON rows.
+Query is the default: `dirsql "<sql>"` runs one query and prints the rows —
+a table at a terminal, a JSON array when piped (see
+[Output format](#output-format)).
 The `dirsql` binary has these modes:
 
 | Invocation | Behavior |
 |---|---|
-| `dirsql "<sql>"` | Run one query over the directory and print the rows as JSON. The default; identical to `dirsql query "<sql>"`. |
+| `dirsql "<sql>"` | Run one query over the directory and print the rows. The default; identical to `dirsql query "<sql>"`. |
 | `dirsql query "<sql>"` | Explicit synonym for the default one-shot query. |
 | `dirsql server` | Start a long-lived HTTP server exposing a SQL view of a directory. See [HTTP API](./http-api.md). |
 | `dirsql init` | Generate a `.dirsql.toml`. |
@@ -53,7 +55,7 @@ pipeline, same flags, same output. See that section for config discovery,
 
 ```bash
 dirsql
-# dirsql 0.2.7 — this directory is a database.
+# dirsql <version> — this directory is a database.
 #
 #   SELECT basename, size FROM './' ORDER BY size DESC LIMIT 5;
 #   SELECT path FROM './**/*.md' WHERE content LIKE '%TODO%';
@@ -331,9 +333,10 @@ is a hard error — `error: the subcommand 'query' cannot be used with
 for the server they follow the subcommand: `dirsql server -c <cfg>`.)
 :::
 
-The subcommand builds the index, runs the SQL, prints the result rows as a
-JSON array on stdout (byte-identical to the [`POST /query`](./http-api.md)
-response body), and exits `0`.
+The subcommand builds the index, runs the SQL, prints the result rows on
+stdout — a table at a terminal, otherwise a JSON array byte-identical to the
+[`POST /query`](./http-api.md) response body (see
+[Output format](#output-format)) — and exits `0`.
 
 `dirsql query` is a thin adapter over the **same query pipeline the server
 uses**, so behavior is identical to `POST /query` by construction:
@@ -413,7 +416,7 @@ The output does **not** auto-load. Once you've tweaked it, pass it explicitly
 to run against it:
 
 ```bash
-dirsql "SELECT * FROM files" -c ./.dirsql.toml
+dirsql "SELECT * FROM records" -c ./.dirsql.toml
 ```
 
 ### Flags

package/docs/reference/sdk.md

@@ -54,6 +54,7 @@ DirSQL(
     *,
     tables: list[Table] | None = None,
     ignore: list[str] | None = None,
+    no_ignore: bool = False,
     config: str | list[str] | None = None,
     persist: bool = False,
     persist_path: str | None = None,
@@ -68,6 +69,7 @@ new DirSQL({
     root?: string,
     tables?: TableDef[],
     ignore?: string[],
+    noIgnore?: boolean,
     config?: string | string[],
     persist?: boolean,
     persistPath?: string,
@@ -80,6 +82,7 @@ DirSQL::builder()
     .root(root)                     // optional
     .tables(tables)                 // optional; append one with .table(t)
     .ignore(patterns)               // optional
+    .no_ignore(true)                // optional; default false
     .config(config_toml_path)       // optional; repeatable — call again to
                                     //   merge another config in call order
     .persist(cache_path)            // optional; Some(path), or None for the
@@ -115,6 +118,10 @@ shortcut was removed in #603 — use
 - `tables` — Programmatic [`Table`](#table) definitions.
 - `ignore` — Glob patterns matched against root-relative paths; matched
   files are skipped entirely (scan and watch).
+- `no_ignore` / `noIgnore` — Scan files a `.gitignore` would hide.
+  [Path-tables](./path-tables.md#skip-rules) respect `.gitignore` files by
+  default; the built-in `node_modules`/`.git` skips and any `ignore` patterns
+  still apply. The CLI's [`--no-ignore`](./cli.md#flags).
 - `config` — Path to a [`.dirsql.toml`](./config.md). Its `[[table]]`
   entries are appended after any programmatic `tables`; its `ignore`
   patterns and `[[dirsql.extension]]` entries are appended likewise. The

package/package.json

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