dirsql 0.4.71 → 0.4.73

package/dist/cli/resolve-config-extensions.js

@@ -22,7 +22,7 @@ const NATIVE_CONFIG_SUFFIXES = [".py", ".js", ".mjs", ".cjs"];
  * launcher as a clean error).
  */
 export async function withResolvedExtensions(argv) {
-    if (argv[0] === "init") {
+    if (argv[0] === "init" || argv[0] === "context") {
         return argv;
     }
     const configPaths = getCore()

package/docs/reference/cli.md

@@ -11,6 +11,7 @@ The `dirsql` binary has these modes:
 | `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`. |
+| `dirsql context` | Print the usage guide for this version, for an agent to read. |
 | `dirsql` (bare) | Open a [REPL](#the-repl) over the current directory, reading statements until EOF. |
 
 Bare `dirsql` does **not** start the server — that is `dirsql server`.
@@ -441,6 +442,17 @@ All failures exit `1` with a message on stderr:
 
 On success, `init` exits `0`.
 
+## `dirsql context`
+
+```sh
+uvx dirsql context
+```
+
+Prints a markdown guide for an agent that is about to query files: the
+first line is `dirsql <version>`, then sections on usage, recipes and
+troubleshooting. The guide is compiled into the binary, so it describes the
+version that prints it. It takes no flags and exits `0`.
+
 ## Plugins
 
 A **plugin** is an ordinary Python package that ships a `dirsql.toml` config

package/docs/reference/path-tables.md

@@ -37,14 +37,16 @@ indexing, not your shell's working directory.
 
 **A directory name is one level, like `ls`.** Naming a directory lists the
 files directly inside it and no deeper; `*` matches one level and `**` any
-depth, as in the shell.
+depth, as in the shell. A trailing `/` is `*` appended, so `'./*/'` is
+`'./*/*'`: the files directly inside each top-level directory, like `ls */`.
 
 | You write | dirsql scans |
 | --- | --- |
 | `'./'` | files directly inside the index root, and no deeper |
 | `'./docs'`, `'./docs/'` | files directly inside `docs/` |
 | `'./*'` | the same as `'./'` |
-| `'./**'` | every file under the index root, recursively |
+| `'./**'`, `'./**/'` | every file under the index root, recursively |
+| `'./*/'` | the same as `'./*/*'`: files directly inside each top-level directory |
 | `'./docs/*.md'` | markdown files directly inside `docs/` |
 | `'./docs/**/*.md'` | markdown files at any depth under `docs/` |
 | `'./notes/today.md'` | exactly that one file — one file is one row |
@@ -108,7 +110,8 @@ Three other prefixes resolve, with their usual shell meanings:
 | `'../notes'` | relative to the index root's parent |
 | `'~/notes/*.md'` | relative to your home directory |
 
-A directory named this way is one level too; `'../notes/**'` descends.
+A directory named this way is one level too; `'../notes/**'` descends. The
+trailing-`/` rule holds here as well: `'~/*/'` is `'~/*/*'`.
 `..` is folded out textually, not followed through symlinks, so the directory
 scanned is a function of the string you wrote.
 

package/package.json

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