dirsql 0.4.98__tar.gz → 0.4.100__tar.gz

{dirsql-0.4.98 → dirsql-0.4.100}/Cargo.lock

@@ -573,7 +573,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql"
-version = "0.4.98"
+version = "0.4.100"
 dependencies = [
  "assert_cmd",
  "axum",
@@ -625,7 +625,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.4.98"
+version = "0.4.100"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.4.98 → dirsql-0.4.100}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.4.98
+Version: 0.4.100
 Requires-Dist: bin-shim>=0.1
 Summary: Ephemeral SQL index over a local directory
 Keywords: sql,filesystem,directory,sqlite,index

{dirsql-0.4.98/packages/rust → dirsql-0.4.100}/docs/context/usage.md

@@ -22,7 +22,7 @@ A quoted path stands in for a table name. Paths are relative to the directory yo
 | `'./**/*.md'` | markdown at any depth |
 | `'./notes/today.md'` | that one file |
 
-`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; those report absolute `path` values.
+`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; `path` is reported as written, so `'../notes'` gives `../notes/x.md` and the others give absolute paths.
 
 Two mistakes fail every time:
 

{dirsql-0.4.98 → dirsql-0.4.100}/docs/howto/query-without-config.md

@@ -65,7 +65,7 @@ why indexes belong to only one of them, are in
   `config` nor `tables` and call `query("SELECT * FROM './'")`
   ([SDK reference](../reference/sdk.md)).
 - Paths outside the root resolve too — `'/var/log/*.log'`, `'../notes'`,
-  `'~/notes/*.md'` — reporting absolute paths
+  `'~/notes/*.md'` — reporting paths as you wrote them
   ([path-tables reference](../reference/path-tables.md#paths-outside-the-index-root)).
 - `.git/` is skipped by default, and a git repo's `.gitignore` hides what it
   lists, so a bare `'./**'` does not drown in machinery

{dirsql-0.4.98/packages/rust → dirsql-0.4.100}/docs/reference/columns.md

@@ -31,7 +31,7 @@ lazily-read hidden [`content`](./path-tables.md#columns) column.
 
 | Column | Type | Value |
 |---|---|---|
-| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); absolute for a `/`, `../` or `~/` path-table. |
+| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); as written for a `../` path-table, absolute for a `/` or `~/` one. |
 | `basename` | TEXT | The filename, including extension (`hello.md`). |
 | `dir` | TEXT | The parent directory relative to the root (`posts`); the empty string for files directly under the root. |
 | `ext` | TEXT | The file extension without the leading dot (`md`). Original case is preserved — `Photo.JPG` yields `JPG`; use `LOWER(ext)` for case-insensitive matching. `NULL` when the file has no extension. |

{dirsql-0.4.98/packages/rust → dirsql-0.4.100}/docs/reference/glob.md

@@ -19,7 +19,7 @@ divergence is a written decision.
 ## The fixture
 
 Every example below runs against this tree. A name ending in `/` is an empty
-directory, `a -> b` is a symlink, and `.gitignore` holds `*.log`.
+directory, `a -> b` is a symlink, and `.gitignore` holds `*.log` and `dist/`.
 
 <!-- conformance-tree -->
 ```text
@@ -48,7 +48,16 @@ docs/.draft.md
 docs/nested/deep.md
 docs/nested/.cache/x.md
 node_modules/pkg/index.js
+dist/bundle.js
+dist/sub/o.js
 real/r.md
+uni/1.md
+uni/a.md
+uni/é.md
+uni/É.md
+uni/中.md
+uni/٣.md
+uni/¡.md
 linkdir -> real
 link.md -> top.md
 broken -> nowhere
@@ -69,13 +78,21 @@ A test runs every row against dirsql as a path-table and, with the leading
 | Pattern | Rows | Divergence |
 | --- | --- | --- |
 | `./*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `link.md`, `my file.md`, `top.md`, `{q}.md` |  |
-| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `{q}.md` |  |
-| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `x.txt`, `{q}.md` |  |
+| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `{q}.md` |  |
+| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `x.txt`, `{q}.md` |  |
 | `./?.md` | `1.md`, `2.md`, `3.md`, `4.md`, `a.md`, `b.md`, `c.md` |  |
 | `./[ab].md` | `a.md`, `b.md` |  |
 | `./[!a].md` | `1.md`, `2.md`, `3.md`, `4.md`, `b.md`, `c.md` |  |
 | `./\[a\].md` | `[a].md` |  |
 | `./[z.md` | `[z.md` |  |
+| `./uni/[[:alpha:]].md` | `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:alnum:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:lower:]].md` | `uni/a.md`, `uni/é.md` |  |
+| `./uni/[[:upper:]].md` | `uni/É.md` |  |
+| `./uni/[[:digit:]].md` | `uni/1.md` |  |
+| `./uni/[[:punct:]].md` | `uni/¡.md` |  |
+| `./uni/[[:word:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[![:alpha:]].md` | `uni/1.md`, `uni/¡.md` |  |
 | `./[d/x]ocs/api.md` | none |  |
 | `./docs[/]api.md` | none |  |
 | `./[!/]*/api.md` | none |  |
@@ -106,28 +123,46 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `./docs/*/../api.md` | `docs/nested/../api.md` |  |
 | `./docs` | `docs/api.md`, `docs/guide.md` | directory-name |
 | `./docs/` | `docs/api.md`, `docs/guide.md` | directory-name |
-| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md` | directory-name |
+| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` | directory-name |
 | `./d*` | none | files-only |
 | `./*.log` | none | gitignore |
+| `./ignored.log` | `ignored.log` |  |
+| `./{ignored,x}.log` | `ignored.log` |  |
+| `./dist/*.js` | none | gitignore |
+| `./dist/**/*.js` | none | gitignore |
+| `./dist/sub/*.js` | none | gitignore |
+| `./d*/*.js` | none | gitignore |
+| `./dist/bundle.js` | `dist/bundle.js` |  |
+| `./dist/sub/o.js` | `dist/sub/o.js` |  |
 | `./**/*.js` | `node_modules/pkg/index.js` |  |
 | `./node_modules/*/index.js` | `node_modules/pkg/index.js` |  |
 | `./docs/**/*.md` | `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md` |  |
 | `./docs/*.md` | `docs/api.md`, `docs/guide.md` |  |
-| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `../proj/docs/*.md` | `$BASE/proj/docs/api.md`, `$BASE/proj/docs/guide.md` | absolute |
+| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `../proj/docs/*.md` | `../proj/docs/api.md`, `../proj/docs/guide.md` |  |
+| `../*/top.md` | `../proj/top.md` |  |
+| `../proj/**/deep.md` | `../proj/docs/nested/deep.md` |  |
+| `../proj/docs` | `../proj/docs/api.md`, `../proj/docs/guide.md` | directory-name |
 
 ## Divergences from bash
 
 | Tag | Rule | Why |
 | --- | --- | --- |
-| `gitignore` | Inside a git repo, `.gitignore` files hide matching files and directories. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
+| `gitignore` | Inside a git repo, `.gitignore` files hide files and directories a wildcard matches, never one the pattern spells out. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
 | `directory-name` | A pattern's last component that names a directory lists the files directly inside it, like `ls docs`. A trailing `/` is `*` appended. | A table is rows of files, and `ls` is the shell habit. |
 | `files-only` | A pattern that matches a directory but no file returns nothing. | Every row is a file. |
-| `absolute` | `/`, `~/` and `../` patterns report absolute `path` values, with `..` folded out textually. | The scanned root is derived from the pattern, so there is no relative base. |
 
 `.git` needs no rule of its own: the dotfile rule hides it.
 
+## Syntax, not behavior
+
+A path-table starts with `./`, `/`, `~/` or `../`. That is how `FROM` tells a
+path from a table name, so `FROM './**/*.md'` is a glob and `FROM docs` is a
+table. A config `glob` has no such need and is written without the `./`.
+Bash accepts a bare `**/*.md`; dirsql does not in a path-table. This is syntax,
+not a divergence: past the prefix, the glob behaves as bash does.
+
 ## Where the glob is anchored
 
 A path-table pattern is relative to the index root and starts with `./`. A config `[[table]] glob`
@@ -144,6 +179,9 @@ stderr; the exit code is unchanged. Path-tables never warn.
   `{a..c}` expand, as do zero-padded
   `{01..10}` and stepped `{1..10..2}` ranges. Groups nest.
 - `\[` is a literal bracket.
+- POSIX classes (`[[:alpha:]]`) match Unicode characters, as bash does in a UTF-8
+  locale: `[[:alpha:]]` matches `é` and `中`. `[[:digit:]]`, `[[:xdigit:]]` and
+  `[[:ascii:]]` stay ASCII.
 - A dot-named file or directory is listed only where a component spells the
   dot at that depth: `./**/.*` finds `docs/.draft.md` but does not enter
   `.config/`.

{dirsql-0.4.98 → dirsql-0.4.100}/docs/reference/path-tables.md

@@ -109,19 +109,15 @@ Three other prefixes resolve, with their usual shell meanings:
 | You write | dirsql scans |
 | --- | --- |
 | `'/var/log/*.log'` | an absolute path |
-| `'../notes'` | relative to the index root's parent |
+| `'../notes'` | relative to the index root's parent, as written |
 | `'~/notes/*.md'` | relative to your home directory |
 
 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.
-
-**These report absolute `path` values.** A `./` path-table reports paths
-relative to the index root, matching every other dirsql table; a `/`, `../` or
-`~/` path-table has no meaningful relative base — the root it scans is derived
-from the pattern, not named by you — so it reports the full path instead. The
-value you get back is one you can paste into another command:
+**A `../` path-table reports `path` as written**, relative to the directory
+dirsql runs in, as bash prints it: `'../notes/*.md'` gives `../notes/a.md`. A
+`/` or `~/` path-table is absolute already, so it reports the full path. Either
+value is one you can paste into another command:
 
 ```sql
 SELECT path FROM '/var/log/*.log';
@@ -144,7 +140,7 @@ table:
 
 | Column | Type | Meaning |
 | --- | --- | --- |
-| `path` | TEXT | path relative to the index root (absolute for `/`, `../`, `~/` tables) |
+| `path` | TEXT | path relative to the index root (as written for `../` tables, absolute for `/` and `~/` tables) |
 | `basename` | TEXT | filename with extension |
 | `dir` | TEXT | parent directory, relative to the index root |
 | `ext` | TEXT | extension without the dot |
@@ -262,6 +258,9 @@ 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.
 
+A `.gitignore` never hides a path the pattern spells out: `'./debug.log'` lists
+that file even when `*.log` is ignored, while `'./*.log'` does not.
+
 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`

{dirsql-0.4.98 → dirsql-0.4.100}/packages/python/Cargo.toml

@@ -4,7 +4,7 @@ name = "dirsql-py-ext"
 # pypi/maturin handler can rewrite it via `write-version` before
 # `maturin build`. `pyproject.toml` declares `dynamic = ["version"]`
 # and maturin reads this field. Mirrors `packages/rust/Cargo.toml`.
-version = "0.4.98"
+version = "0.4.100"
 # abi3 note: the `abi3-py310` pyo3 feature (below) builds ONE stable-ABI
 # `cp310-abi3` wheel per platform that loads on every CPython >= 3.10
 # (matching `pyproject.toml`'s `requires-python = ">=3.10"`), instead of

dirsql-0.4.100/packages/python/changelog.d/2026-10-07-dotdot-as-written.md

@@ -0,0 +1,3 @@
+**Changed**
+
+- A ../ path-table such as '../notes/*.md' now reports ../notes/a.md, relative to the directory dirsql runs in, instead of an absolute path. / and ~/ tables are unchanged.

dirsql-0.4.100/packages/python/changelog.d/2026-10-07-literal-gitignore.md

@@ -0,0 +1,3 @@
+**Changed**
+
+- A pattern with no wildcard, such as ./debug.log, lists the file even when .gitignore ignores it; wildcard matches are still filtered.

dirsql-0.4.100/packages/python/changelog.d/2026-10-07-posix-classes-unicode.md

@@ -0,0 +1,3 @@
+**Changed**
+
+- POSIX classes such as `[[:alpha:]]`, `[[:upper:]]` and `[[:punct:]]` match Unicode characters instead of ASCII only: `./[[:alpha:]].md` now matches `é.md`. `digit`, `xdigit` and `ascii` stay ASCII.

{dirsql-0.4.98 → dirsql-0.4.100/packages/python}/docs/context/usage.md

@@ -22,7 +22,7 @@ A quoted path stands in for a table name. Paths are relative to the directory yo
 | `'./**/*.md'` | markdown at any depth |
 | `'./notes/today.md'` | that one file |
 
-`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; those report absolute `path` values.
+`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; `path` is reported as written, so `'../notes'` gives `../notes/x.md` and the others give absolute paths.
 
 Two mistakes fail every time:
 

{dirsql-0.4.98/packages/rust → dirsql-0.4.100/packages/python}/docs/howto/query-without-config.md

@@ -65,7 +65,7 @@ why indexes belong to only one of them, are in
   `config` nor `tables` and call `query("SELECT * FROM './'")`
   ([SDK reference](../reference/sdk.md)).
 - Paths outside the root resolve too — `'/var/log/*.log'`, `'../notes'`,
-  `'~/notes/*.md'` — reporting absolute paths
+  `'~/notes/*.md'` — reporting paths as you wrote them
   ([path-tables reference](../reference/path-tables.md#paths-outside-the-index-root)).
 - `.git/` is skipped by default, and a git repo's `.gitignore` hides what it
   lists, so a bare `'./**'` does not drown in machinery

{dirsql-0.4.98 → dirsql-0.4.100}/packages/python/docs/reference/columns.md

@@ -31,7 +31,7 @@ lazily-read hidden [`content`](./path-tables.md#columns) column.
 
 | Column | Type | Value |
 |---|---|---|
-| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); absolute for a `/`, `../` or `~/` path-table. |
+| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); as written for a `../` path-table, absolute for a `/` or `~/` one. |
 | `basename` | TEXT | The filename, including extension (`hello.md`). |
 | `dir` | TEXT | The parent directory relative to the root (`posts`); the empty string for files directly under the root. |
 | `ext` | TEXT | The file extension without the leading dot (`md`). Original case is preserved — `Photo.JPG` yields `JPG`; use `LOWER(ext)` for case-insensitive matching. `NULL` when the file has no extension. |

{dirsql-0.4.98 → dirsql-0.4.100/packages/python}/docs/reference/glob.md

@@ -19,7 +19,7 @@ divergence is a written decision.
 ## The fixture
 
 Every example below runs against this tree. A name ending in `/` is an empty
-directory, `a -> b` is a symlink, and `.gitignore` holds `*.log`.
+directory, `a -> b` is a symlink, and `.gitignore` holds `*.log` and `dist/`.
 
 <!-- conformance-tree -->
 ```text
@@ -48,7 +48,16 @@ docs/.draft.md
 docs/nested/deep.md
 docs/nested/.cache/x.md
 node_modules/pkg/index.js
+dist/bundle.js
+dist/sub/o.js
 real/r.md
+uni/1.md
+uni/a.md
+uni/é.md
+uni/É.md
+uni/中.md
+uni/٣.md
+uni/¡.md
 linkdir -> real
 link.md -> top.md
 broken -> nowhere
@@ -69,13 +78,21 @@ A test runs every row against dirsql as a path-table and, with the leading
 | Pattern | Rows | Divergence |
 | --- | --- | --- |
 | `./*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `link.md`, `my file.md`, `top.md`, `{q}.md` |  |
-| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `{q}.md` |  |
-| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `x.txt`, `{q}.md` |  |
+| `./**/*.md` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `linkdir/r.md`, `my file.md`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `{q}.md` |  |
+| `./**` | `1.md`, `2.md`, `3.md`, `4.md`, `[a].md`, `[z.md`, `a.md`, `b.md`, `c.md`, `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md`, `link.md`, `my file.md`, `node_modules/pkg/index.js`, `real/r.md`, `top.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md`, `x.txt`, `{q}.md` |  |
 | `./?.md` | `1.md`, `2.md`, `3.md`, `4.md`, `a.md`, `b.md`, `c.md` |  |
 | `./[ab].md` | `a.md`, `b.md` |  |
 | `./[!a].md` | `1.md`, `2.md`, `3.md`, `4.md`, `b.md`, `c.md` |  |
 | `./\[a\].md` | `[a].md` |  |
 | `./[z.md` | `[z.md` |  |
+| `./uni/[[:alpha:]].md` | `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:alnum:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[[:lower:]].md` | `uni/a.md`, `uni/é.md` |  |
+| `./uni/[[:upper:]].md` | `uni/É.md` |  |
+| `./uni/[[:digit:]].md` | `uni/1.md` |  |
+| `./uni/[[:punct:]].md` | `uni/¡.md` |  |
+| `./uni/[[:word:]].md` | `uni/1.md`, `uni/a.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` |  |
+| `./uni/[![:alpha:]].md` | `uni/1.md`, `uni/¡.md` |  |
 | `./[d/x]ocs/api.md` | none |  |
 | `./docs[/]api.md` | none |  |
 | `./[!/]*/api.md` | none |  |
@@ -106,28 +123,46 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `./docs/*/../api.md` | `docs/nested/../api.md` |  |
 | `./docs` | `docs/api.md`, `docs/guide.md` | directory-name |
 | `./docs/` | `docs/api.md`, `docs/guide.md` | directory-name |
-| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md` | directory-name |
+| `./*/` | `docs/api.md`, `docs/guide.md`, `linkdir/r.md`, `real/r.md`, `uni/1.md`, `uni/a.md`, `uni/¡.md`, `uni/É.md`, `uni/é.md`, `uni/٣.md`, `uni/中.md` | directory-name |
 | `./d*` | none | files-only |
 | `./*.log` | none | gitignore |
+| `./ignored.log` | `ignored.log` |  |
+| `./{ignored,x}.log` | `ignored.log` |  |
+| `./dist/*.js` | none | gitignore |
+| `./dist/**/*.js` | none | gitignore |
+| `./dist/sub/*.js` | none | gitignore |
+| `./d*/*.js` | none | gitignore |
+| `./dist/bundle.js` | `dist/bundle.js` |  |
+| `./dist/sub/o.js` | `dist/sub/o.js` |  |
 | `./**/*.js` | `node_modules/pkg/index.js` |  |
 | `./node_modules/*/index.js` | `node_modules/pkg/index.js` |  |
 | `./docs/**/*.md` | `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md` |  |
 | `./docs/*.md` | `docs/api.md`, `docs/guide.md` |  |
-| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `../proj/docs/*.md` | `$BASE/proj/docs/api.md`, `$BASE/proj/docs/guide.md` | absolute |
+| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `../proj/docs/*.md` | `../proj/docs/api.md`, `../proj/docs/guide.md` |  |
+| `../*/top.md` | `../proj/top.md` |  |
+| `../proj/**/deep.md` | `../proj/docs/nested/deep.md` |  |
+| `../proj/docs` | `../proj/docs/api.md`, `../proj/docs/guide.md` | directory-name |
 
 ## Divergences from bash
 
 | Tag | Rule | Why |
 | --- | --- | --- |
-| `gitignore` | Inside a git repo, `.gitignore` files hide matching files and directories. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
+| `gitignore` | Inside a git repo, `.gitignore` files hide files and directories a wildcard matches, never one the pattern spells out. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
 | `directory-name` | A pattern's last component that names a directory lists the files directly inside it, like `ls docs`. A trailing `/` is `*` appended. | A table is rows of files, and `ls` is the shell habit. |
 | `files-only` | A pattern that matches a directory but no file returns nothing. | Every row is a file. |
-| `absolute` | `/`, `~/` and `../` patterns report absolute `path` values, with `..` folded out textually. | The scanned root is derived from the pattern, so there is no relative base. |
 
 `.git` needs no rule of its own: the dotfile rule hides it.
 
+## Syntax, not behavior
+
+A path-table starts with `./`, `/`, `~/` or `../`. That is how `FROM` tells a
+path from a table name, so `FROM './**/*.md'` is a glob and `FROM docs` is a
+table. A config `glob` has no such need and is written without the `./`.
+Bash accepts a bare `**/*.md`; dirsql does not in a path-table. This is syntax,
+not a divergence: past the prefix, the glob behaves as bash does.
+
 ## Where the glob is anchored
 
 A path-table pattern is relative to the index root and starts with `./`. A config `[[table]] glob`
@@ -144,6 +179,9 @@ stderr; the exit code is unchanged. Path-tables never warn.
   `{a..c}` expand, as do zero-padded
   `{01..10}` and stepped `{1..10..2}` ranges. Groups nest.
 - `\[` is a literal bracket.
+- POSIX classes (`[[:alpha:]]`) match Unicode characters, as bash does in a UTF-8
+  locale: `[[:alpha:]]` matches `é` and `中`. `[[:digit:]]`, `[[:xdigit:]]` and
+  `[[:ascii:]]` stay ASCII.
 - A dot-named file or directory is listed only where a component spells the
   dot at that depth: `./**/.*` finds `docs/.draft.md` but does not enter
   `.config/`.

{dirsql-0.4.98 → dirsql-0.4.100}/packages/python/docs/reference/path-tables.md

@@ -109,19 +109,15 @@ Three other prefixes resolve, with their usual shell meanings:
 | You write | dirsql scans |
 | --- | --- |
 | `'/var/log/*.log'` | an absolute path |
-| `'../notes'` | relative to the index root's parent |
+| `'../notes'` | relative to the index root's parent, as written |
 | `'~/notes/*.md'` | relative to your home directory |
 
 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.
-
-**These report absolute `path` values.** A `./` path-table reports paths
-relative to the index root, matching every other dirsql table; a `/`, `../` or
-`~/` path-table has no meaningful relative base — the root it scans is derived
-from the pattern, not named by you — so it reports the full path instead. The
-value you get back is one you can paste into another command:
+**A `../` path-table reports `path` as written**, relative to the directory
+dirsql runs in, as bash prints it: `'../notes/*.md'` gives `../notes/a.md`. A
+`/` or `~/` path-table is absolute already, so it reports the full path. Either
+value is one you can paste into another command:
 
 ```sql
 SELECT path FROM '/var/log/*.log';
@@ -144,7 +140,7 @@ table:
 
 | Column | Type | Meaning |
 | --- | --- | --- |
-| `path` | TEXT | path relative to the index root (absolute for `/`, `../`, `~/` tables) |
+| `path` | TEXT | path relative to the index root (as written for `../` tables, absolute for `/` and `~/` tables) |
 | `basename` | TEXT | filename with extension |
 | `dir` | TEXT | parent directory, relative to the index root |
 | `ext` | TEXT | extension without the dot |
@@ -262,6 +258,9 @@ 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.
 
+A `.gitignore` never hides a path the pattern spells out: `'./debug.log'` lists
+that file even when `*.log` is ignored, while `'./*.log'` does not.
+
 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`

dirsql-0.4.100/packages/python/e2e-attestations/bot-1421-posix-unicode.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/glob_speed_matchers_test.py -x -q",
+  "ran_at": 1791395236,
+  "exit_code": 0,
+  "commit": "b0d6654084056647e26fb061ad055ded511d5a2c",
+  "branch": "bot/1421-posix-unicode"
+}

dirsql-0.4.100/packages/python/e2e-attestations/bot-1422-literal-gitignore.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/glob_speed_one_level_test.py -x -q",
+  "ran_at": 1791398612,
+  "exit_code": 0,
+  "commit": "575ebdcb3e11ea49aefcd52ec2bff9c9a4990257",
+  "branch": "bot/1422-literal-gitignore"
+}

dirsql-0.4.100/packages/python/e2e-attestations/bot-1430-dotdot-as-written.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/glob_speed_one_level_test.py -x -q",
+  "ran_at": 1791400206,
+  "exit_code": 0,
+  "commit": "5b2712c96a0bb5f59fb543918664db9b95e55094",
+  "branch": "bot/1430-dotdot-as-written"
+}

dirsql-0.4.100/packages/python/e2e-attestations/bot-1448-wildcard-ignored-prefix.json

@@ -0,0 +1,7 @@
+{
+  "command": "uv run python -m pytest tests/e2e/glob_speed_gitignore_test.py tests/e2e/glob_speed_one_level_test.py tests/e2e/glob_speed_recursive_test.py tests/e2e/query_contract_test.py tests/e2e/fanout_test.py -x -q",
+  "ran_at": 1791403526,
+  "exit_code": 0,
+  "commit": "08b154a76016e8369151b2269aa01a9331d41ed7",
+  "branch": "bot/1448-wildcard-ignored-prefix"
+}

dirsql-0.4.100/packages/python/migrations.d/2026-10-07-dotdot-as-written.md

@@ -0,0 +1,23 @@
+### ../ paths as written
+
+#### Summary
+
+A ../ path-table reports paths as written.
+
+#### Required changes
+
+_None._
+
+#### Deprecations removed
+
+_None._
+
+#### Behavior changes without code changes
+
+- A ../ path-table such as '../notes/*.md' now reports ../notes/a.md, relative to the directory dirsql runs in, instead of an absolute path. / and ~/ tables are unchanged.
+
+#### Verification
+
+```bash
+dirsql query "SELECT path FROM '../notes/*.md'"
+```

dirsql-0.4.100/packages/python/migrations.d/2026-10-07-literal-gitignore.md

@@ -0,0 +1,23 @@
+### Named paths ignore .gitignore
+
+#### Summary
+
+A path the pattern spells out is listed even when a .gitignore ignores it.
+
+#### Required changes
+
+_None._
+
+#### Deprecations removed
+
+_None._
+
+#### Behavior changes without code changes
+
+- A pattern with no wildcard, such as ./debug.log, lists the file even when .gitignore ignores it; wildcard matches are still filtered.
+
+#### Verification
+
+```bash
+dirsql query "SELECT path FROM './debug.log'"
+```

dirsql-0.4.100/packages/python/migrations.d/2026-10-07-posix-classes-unicode.md

@@ -0,0 +1,23 @@
+### POSIX classes match Unicode characters
+
+#### Summary
+
+POSIX classes in globs match Unicode characters, as bash does in a UTF-8 locale.
+
+#### Required changes
+
+_None._
+
+#### Deprecations removed
+
+_None._
+
+#### Behavior changes without code changes
+
+- POSIX classes such as `[[:alpha:]]`, `[[:upper:]]` and `[[:punct:]]` match Unicode characters instead of ASCII only: `./[[:alpha:]].md` now matches `é.md`. `digit`, `xdigit` and `ascii` stay ASCII.
+
+#### Verification
+
+```bash
+dirsql query "SELECT path FROM './[[:alpha:]].md'"
+```

{dirsql-0.4.98 → dirsql-0.4.100}/packages/rust/Cargo.toml

@@ -6,7 +6,7 @@ description = "Ephemeral SQL index over a local directory"
 # version stays for the binding crates (publish = false). The literal
 # intentionally lags the published version: putitoutthere rewrites it to
 # the planned release version at build time and never commits it back.
-version = "0.4.98"
+version = "0.4.100"
 edition.workspace = true
 # Literal `license` (not `license.workspace = true`) because
 # putitoutthere's preflight check reads `[package].license` directly

{dirsql-0.4.98/packages/python → dirsql-0.4.100/packages/rust}/docs/context/usage.md

@@ -22,7 +22,7 @@ A quoted path stands in for a table name. Paths are relative to the directory yo
 | `'./**/*.md'` | markdown at any depth |
 | `'./notes/today.md'` | that one file |
 
-`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; those report absolute `path` values.
+`*` matches within one directory level and `**` matches any depth. A directory name lists one level, like `ls docs`, so write `'./**'` to scan the whole tree. Rows are files only, never directories. `'/var/log/*.log'`, `'../notes'` and `'~/notes/*.md'` also resolve; `path` is reported as written, so `'../notes'` gives `../notes/x.md` and the others give absolute paths.
 
 Two mistakes fail every time:
 

{dirsql-0.4.98/packages/python → dirsql-0.4.100/packages/rust}/docs/howto/query-without-config.md

@@ -65,7 +65,7 @@ why indexes belong to only one of them, are in
   `config` nor `tables` and call `query("SELECT * FROM './'")`
   ([SDK reference](../reference/sdk.md)).
 - Paths outside the root resolve too — `'/var/log/*.log'`, `'../notes'`,
-  `'~/notes/*.md'` — reporting absolute paths
+  `'~/notes/*.md'` — reporting paths as you wrote them
   ([path-tables reference](../reference/path-tables.md#paths-outside-the-index-root)).
 - `.git/` is skipped by default, and a git repo's `.gitignore` hides what it
   lists, so a bare `'./**'` does not drown in machinery

{dirsql-0.4.98 → dirsql-0.4.100/packages/rust}/docs/reference/columns.md

@@ -31,7 +31,7 @@ lazily-read hidden [`content`](./path-tables.md#columns) column.
 
 | Column | Type | Value |
 |---|---|---|
-| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); absolute for a `/`, `../` or `~/` path-table. |
+| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); as written for a `../` path-table, absolute for a `/` or `~/` one. |
 | `basename` | TEXT | The filename, including extension (`hello.md`). |
 | `dir` | TEXT | The parent directory relative to the root (`posts`); the empty string for files directly under the root. |
 | `ext` | TEXT | The file extension without the leading dot (`md`). Original case is preserved — `Photo.JPG` yields `JPG`; use `LOWER(ext)` for case-insensitive matching. `NULL` when the file has no extension. |