dirsql 0.3.39__tar.gz → 0.3.41__tar.gz

{dirsql-0.3.39 → dirsql-0.3.41}/Cargo.lock

@@ -499,7 +499,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.3.39"
+version = "0.3.41"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.3.39 → dirsql-0.3.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.3.39
+Version: 0.3.41
 Requires-Dist: pytest>=8 ; extra == 'dev'
 Requires-Dist: pytest-describe>=2 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'

{dirsql-0.3.39 → dirsql-0.3.41}/dirsql/_async.py

@@ -55,9 +55,10 @@ class DirSQL:
         async for event in db.watch():
             ...
 
-    At least one of ``root`` or ``config`` must be supplied. When both are
-    set, the explicit ``root`` wins over any ``[dirsql].root`` in the config
-    file (a warning is emitted on stderr).
+    Supply a ``root``, a ``config`` path, or both. When both are set, the
+    explicit ``root`` wins over any ``[dirsql].root`` in the config file (a
+    warning is emitted on stderr). If neither is given, the initial scan
+    fails with a "no root directory" error raised by the core.
 
     Pass ``persist=True`` to keep an on-disk SQLite cache (default location:
     ``<root>/.dirsql/cache.db``). Override the location with ``persist_path``.
@@ -79,8 +80,6 @@ class DirSQL:
         persist_path=None,
         extensions=None,
     ):
-        if root is None and config is None:
-            raise TypeError("DirSQL requires either a root directory or a config= path")
         self._root = root
         self._tables = tables
         self._ignore = ignore

{dirsql-0.3.39 → dirsql-0.3.41}/dirsql/cli/interpret/run.py

@@ -20,6 +20,7 @@ line on stderr if the config can't be loaded.
 from __future__ import annotations
 
 import json
+import os
 import sys
 
 from .dispatch_extract import dispatch_extract
@@ -41,6 +42,16 @@ def run(argv: list[str]) -> int:
         sys.stderr.write(f"dirsql interpret: {exc}\n")
         return 1
 
+    # A config file describes a single DirSQL; it must not itself delegate to
+    # another `config=` path. The interpret handshake has no field for a
+    # nested config and would recurse, so reject it up front.
+    if app._config is not None:
+        sys.stderr.write(
+            "dirsql interpret: a config file cannot itself set config= "
+            "(nested config is not supported)\n"
+        )
+        return 1
+
     # Name comes from `dirsql::db::parse_table_name` -- the canonical
     # core parser, surfaced via PyO3 on `Table.name` (#196). No regex
     # duplication on the Python side. Tables with a name the parser
@@ -49,7 +60,15 @@ def run(argv: list[str]) -> int:
     # `await app.ready()` would re-raise -- not interpret's job to
     # second-guess.
     tables = {t.name: t for t in (app._tables or []) if t.name is not None}
-    write_message({"type": "config", "state": vars(app)})
+
+    # When the config supplies neither `root` nor `config=`, the resolved
+    # root is None. Default it to the process cwd -- the directory the
+    # `dirsql` command was launched from, which interpret inherits from the
+    # parent binary -- so a root-less config indexes "here".
+    state = vars(app)
+    if state.get("root") is None:
+        state["root"] = os.getcwd()
+    write_message({"type": "config", "state": state})
 
     for line in sys.stdin:
         stripped = line.strip()

{dirsql-0.3.39/packages/python → dirsql-0.3.41}/docs/.vitepress/config.ts

@@ -19,19 +19,12 @@ export default defineConfig({
       { text: 'GitHub', link: 'https://github.com/thekevinscott/dirsql' }
     ],
 
+    // A single global sidebar shown on every page. The CLI section is a
+    // self-contained group with all its subpages -- but it never *replaces*
+    // the rest of the nav. There is intentionally no path-scoped (`/cli/`)
+    // key: a path-scoped sidebar swaps the whole tree out, which deletes the
+    // other sections when you enter CLI (see #301). Keep one sidebar.
     sidebar: {
-      '/cli/': [
-        {
-          text: 'CLI',
-          items: [
-            { text: 'Overview & Installation', link: '/cli/' },
-            { text: 'Running the Server', link: '/cli/server' },
-            { text: 'Generating a Config (`init`)', link: '/cli/init' },
-            { text: 'Configuration File', link: '/cli/config' },
-            { text: 'HTTP API', link: '/cli/http-api' }
-          ]
-        }
-      ],
       '/': [
         {
           text: 'Tutorials',
@@ -53,7 +46,11 @@ export default defineConfig({
         {
           text: 'CLI',
           items: [
-            { text: 'Using `dirsql` from the CLI', link: '/cli/' }
+            { text: 'Overview & Installation', link: '/cli/' },
+            { text: 'Running the Server', link: '/cli/server' },
+            { text: 'Generating a Config (`init`)', link: '/cli/init' },
+            { text: 'Configuration File', link: '/cli/config' },
+            { text: 'HTTP API', link: '/cli/http-api' }
           ]
         },
         {

{dirsql-0.3.39/packages/python → dirsql-0.3.41}/docs/cli/config.md

@@ -239,7 +239,7 @@ def extract_meta(path):
 
 # Python must export a module-level `app`.
 app = DirSQL(
-    root="papers",  # required — see "Set a root" below
+    root="papers",  # optional; defaults to the current directory
     tables=[
         Table(
             ddl="CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -269,7 +269,7 @@ import { readFileSync } from "node:fs";
 import { DirSQL } from "dirsql";
 
 export default new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -285,7 +285,7 @@ const { readFileSync } = require("node:fs");
 const { DirSQL } = require("dirsql");
 
 module.exports = new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -308,10 +308,15 @@ These apply to both the Python and JavaScript forms above.
   package) uses `module.exports = new DirSQL(...)`. Only the extension
   matters — the file can be named anything; `dirsql.config.{py,mjs,cjs}` is the
   suggested convention, not a requirement.
-- **Set a `root`.** Unlike TOML configs (which default the scan root to the
-  config file's directory), native-language configs require an explicit `root`.
-  Without one the Python launcher errors and the JavaScript launcher silently
-  indexes nothing.
+- **`root` defaults to the current directory.** A native-language config with
+  no `root` indexes the process's current working directory — the directory you
+  ran `dirsql` from. (This differs from TOML configs, which default the scan
+  root to the config file's own directory.) Pass `root` explicitly to index
+  somewhere else.
+- **No nested `config=`.** A native-language config builds its `DirSQL` from
+  `tables` and an optional `root`; it must not itself set `config=` to delegate
+  to another config file. `dirsql interpret` rejects such a config (a nested
+  config can't be represented in the handshake and would recurse).
 - **Install the launcher on your `PATH`.** To run your `extract`, the server
   spawns `dirsql interpret`, so the matching `dirsql` launcher must be installed
   and on your `PATH` — a global `pip`/`uv` install for `.py`, or `npm` for

{dirsql-0.3.39/packages/rust → dirsql-0.3.41}/docs/cli/index.md

@@ -20,7 +20,7 @@ Everything you need to run `dirsql` as a CLI lives in this section:
 - **[Configuration File](./config.md)** — the `.dirsql.toml` format and the
   `.py` / `.js` native-language alternative. Custom tables
   are defined through a config file; without one, the server runs in
-  [zero-config mode](./server.md#zero-config-mode).
+  [zero-config mode](./server.md#defaults).
 - **[HTTP API](./http-api.md)** — the `POST /query` and `GET /events`
   endpoints, status codes, and event streaming.
 

dirsql-0.3.41/docs/tests/integration/sidebar.spec.ts

@@ -0,0 +1,46 @@
+import { expect, test } from '@playwright/test'
+
+// Regression for #301: entering the CLI section must NOT replace the sidebar.
+// The full set of sections has to stay visible on every page, including
+// `/cli/*`, so navigation never loses its place.
+const SECTIONS = ['Tutorials', 'How-to Guides', 'CLI', 'Reference']
+
+async function sidebarSections(page: import('@playwright/test').Page) {
+  return await page.evaluate(() =>
+    Array.from(document.querySelectorAll('.VPSidebar .group .text'))
+      .map((el) => el.textContent?.trim())
+      .filter(Boolean)
+  )
+}
+
+for (const path of ['guide/tables.html', 'cli/index.html', 'cli/server.html']) {
+  test(`every section stays in the sidebar on ${path}`, async ({ page }) => {
+    await page.goto(`./${path}`)
+    await page.waitForSelector('.VPSidebar .group')
+    const sections = await sidebarSections(page)
+    for (const section of SECTIONS) {
+      expect(sections).toContain(section)
+    }
+  })
+}
+
+test('the CLI sidebar group lists all CLI subpages', async ({ page }) => {
+  await page.goto('./cli/index.html')
+  await page.waitForSelector('.VPSidebar .group')
+  const cliLinks = await page.evaluate(() => {
+    const groups = Array.from(document.querySelectorAll('.VPSidebar .group'))
+    const cli = groups.find(
+      (g) => g.querySelector('.text')?.textContent?.trim() === 'CLI'
+    )
+    return Array.from(cli?.querySelectorAll('a') ?? []).map(
+      (a) => new URL((a as HTMLAnchorElement).href).pathname
+    )
+  })
+  expect(cliLinks).toEqual([
+    '/dirsql/cli/',
+    '/dirsql/cli/server.html',
+    '/dirsql/cli/init.html',
+    '/dirsql/cli/config.html',
+    '/dirsql/cli/http-api.html'
+  ])
+})

dirsql-0.3.41/docs/tests/unit/config.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest'
+import config from '../../.vitepress/config'
+
+type SidebarItem = { text?: string; link?: string; items?: SidebarItem[] }
+
+describe('vitepress config', () => {
+  it('has the expected site title and base path', () => {
+    expect(config.title).toBe('dirsql')
+    expect(config.base).toBe('/dirsql/')
+  })
+
+  // Regression guard: CLI docs live in their own `/cli/` section, not
+  // interleaved with the SDK how-to guides (see #179).
+  it('keeps CLI pages out of the How-to Guides group', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    const howTo = sidebar['/'].find((group) => group.text === 'How-to Guides')
+    const links = (howTo!.items ?? []).map((item) => item.link)
+    expect(links).not.toContain('/guide/cli')
+    expect(links).not.toContain('/guide/init')
+    expect(links).not.toContain('/guide/config')
+  })
+
+  // Regression guard: the sidebar must never *replace* itself when entering a
+  // section. A path-scoped key (e.g. `/cli/`) swaps the whole tree out, which
+  // deletes the other sections and reads as the nav breaking (see #301). There
+  // must be exactly one global `/` sidebar.
+  it('has a single global sidebar with no replacing path-scoped keys', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    expect(Object.keys(sidebar)).toEqual(['/'])
+  })
+
+  // The CLI section is self-contained: its group carries all CLI subpages,
+  // alongside (never instead of) the other sections (see #301).
+  it('shows every CLI subpage in a self-contained CLI group', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    const groupTexts = sidebar['/'].map((group) => group.text)
+    expect(groupTexts).toEqual(['Tutorials', 'How-to Guides', 'CLI', 'Reference'])
+
+    const cli = sidebar['/'].find((group) => group.text === 'CLI')
+    const links = (cli!.items ?? []).map((item) => item.link)
+    expect(links).toEqual([
+      '/cli/',
+      '/cli/server',
+      '/cli/init',
+      '/cli/config',
+      '/cli/http-api'
+    ])
+  })
+})

{dirsql-0.3.39 → dirsql-0.3.41}/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.3.39"
+version = "0.3.41"
 edition.workspace = true
 publish = false
 readme = "README.md"

{dirsql-0.3.39 → dirsql-0.3.41/packages/python}/docs/.vitepress/config.ts

@@ -19,19 +19,12 @@ export default defineConfig({
       { text: 'GitHub', link: 'https://github.com/thekevinscott/dirsql' }
     ],
 
+    // A single global sidebar shown on every page. The CLI section is a
+    // self-contained group with all its subpages -- but it never *replaces*
+    // the rest of the nav. There is intentionally no path-scoped (`/cli/`)
+    // key: a path-scoped sidebar swaps the whole tree out, which deletes the
+    // other sections when you enter CLI (see #301). Keep one sidebar.
     sidebar: {
-      '/cli/': [
-        {
-          text: 'CLI',
-          items: [
-            { text: 'Overview & Installation', link: '/cli/' },
-            { text: 'Running the Server', link: '/cli/server' },
-            { text: 'Generating a Config (`init`)', link: '/cli/init' },
-            { text: 'Configuration File', link: '/cli/config' },
-            { text: 'HTTP API', link: '/cli/http-api' }
-          ]
-        }
-      ],
       '/': [
         {
           text: 'Tutorials',
@@ -53,7 +46,11 @@ export default defineConfig({
         {
           text: 'CLI',
           items: [
-            { text: 'Using `dirsql` from the CLI', link: '/cli/' }
+            { text: 'Overview & Installation', link: '/cli/' },
+            { text: 'Running the Server', link: '/cli/server' },
+            { text: 'Generating a Config (`init`)', link: '/cli/init' },
+            { text: 'Configuration File', link: '/cli/config' },
+            { text: 'HTTP API', link: '/cli/http-api' }
           ]
         },
         {

{dirsql-0.3.39 → dirsql-0.3.41/packages/python}/docs/cli/config.md

@@ -239,7 +239,7 @@ def extract_meta(path):
 
 # Python must export a module-level `app`.
 app = DirSQL(
-    root="papers",  # required — see "Set a root" below
+    root="papers",  # optional; defaults to the current directory
     tables=[
         Table(
             ddl="CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -269,7 +269,7 @@ import { readFileSync } from "node:fs";
 import { DirSQL } from "dirsql";
 
 export default new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -285,7 +285,7 @@ const { readFileSync } = require("node:fs");
 const { DirSQL } = require("dirsql");
 
 module.exports = new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -308,10 +308,15 @@ These apply to both the Python and JavaScript forms above.
   package) uses `module.exports = new DirSQL(...)`. Only the extension
   matters — the file can be named anything; `dirsql.config.{py,mjs,cjs}` is the
   suggested convention, not a requirement.
-- **Set a `root`.** Unlike TOML configs (which default the scan root to the
-  config file's directory), native-language configs require an explicit `root`.
-  Without one the Python launcher errors and the JavaScript launcher silently
-  indexes nothing.
+- **`root` defaults to the current directory.** A native-language config with
+  no `root` indexes the process's current working directory — the directory you
+  ran `dirsql` from. (This differs from TOML configs, which default the scan
+  root to the config file's own directory.) Pass `root` explicitly to index
+  somewhere else.
+- **No nested `config=`.** A native-language config builds its `DirSQL` from
+  `tables` and an optional `root`; it must not itself set `config=` to delegate
+  to another config file. `dirsql interpret` rejects such a config (a nested
+  config can't be represented in the handshake and would recurse).
 - **Install the launcher on your `PATH`.** To run your `extract`, the server
   spawns `dirsql interpret`, so the matching `dirsql` launcher must be installed
   and on your `PATH` — a global `pip`/`uv` install for `.py`, or `npm` for

{dirsql-0.3.39 → dirsql-0.3.41/packages/python}/docs/cli/index.md

@@ -20,7 +20,7 @@ Everything you need to run `dirsql` as a CLI lives in this section:
 - **[Configuration File](./config.md)** — the `.dirsql.toml` format and the
   `.py` / `.js` native-language alternative. Custom tables
   are defined through a config file; without one, the server runs in
-  [zero-config mode](./server.md#zero-config-mode).
+  [zero-config mode](./server.md#defaults).
 - **[HTTP API](./http-api.md)** — the `POST /query` and `GET /events`
   endpoints, status codes, and event streaming.
 

dirsql-0.3.41/packages/python/docs/tests/integration/sidebar.spec.ts

@@ -0,0 +1,46 @@
+import { expect, test } from '@playwright/test'
+
+// Regression for #301: entering the CLI section must NOT replace the sidebar.
+// The full set of sections has to stay visible on every page, including
+// `/cli/*`, so navigation never loses its place.
+const SECTIONS = ['Tutorials', 'How-to Guides', 'CLI', 'Reference']
+
+async function sidebarSections(page: import('@playwright/test').Page) {
+  return await page.evaluate(() =>
+    Array.from(document.querySelectorAll('.VPSidebar .group .text'))
+      .map((el) => el.textContent?.trim())
+      .filter(Boolean)
+  )
+}
+
+for (const path of ['guide/tables.html', 'cli/index.html', 'cli/server.html']) {
+  test(`every section stays in the sidebar on ${path}`, async ({ page }) => {
+    await page.goto(`./${path}`)
+    await page.waitForSelector('.VPSidebar .group')
+    const sections = await sidebarSections(page)
+    for (const section of SECTIONS) {
+      expect(sections).toContain(section)
+    }
+  })
+}
+
+test('the CLI sidebar group lists all CLI subpages', async ({ page }) => {
+  await page.goto('./cli/index.html')
+  await page.waitForSelector('.VPSidebar .group')
+  const cliLinks = await page.evaluate(() => {
+    const groups = Array.from(document.querySelectorAll('.VPSidebar .group'))
+    const cli = groups.find(
+      (g) => g.querySelector('.text')?.textContent?.trim() === 'CLI'
+    )
+    return Array.from(cli?.querySelectorAll('a') ?? []).map(
+      (a) => new URL((a as HTMLAnchorElement).href).pathname
+    )
+  })
+  expect(cliLinks).toEqual([
+    '/dirsql/cli/',
+    '/dirsql/cli/server.html',
+    '/dirsql/cli/init.html',
+    '/dirsql/cli/config.html',
+    '/dirsql/cli/http-api.html'
+  ])
+})

dirsql-0.3.41/packages/python/docs/tests/unit/config.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest'
+import config from '../../.vitepress/config'
+
+type SidebarItem = { text?: string; link?: string; items?: SidebarItem[] }
+
+describe('vitepress config', () => {
+  it('has the expected site title and base path', () => {
+    expect(config.title).toBe('dirsql')
+    expect(config.base).toBe('/dirsql/')
+  })
+
+  // Regression guard: CLI docs live in their own `/cli/` section, not
+  // interleaved with the SDK how-to guides (see #179).
+  it('keeps CLI pages out of the How-to Guides group', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    const howTo = sidebar['/'].find((group) => group.text === 'How-to Guides')
+    const links = (howTo!.items ?? []).map((item) => item.link)
+    expect(links).not.toContain('/guide/cli')
+    expect(links).not.toContain('/guide/init')
+    expect(links).not.toContain('/guide/config')
+  })
+
+  // Regression guard: the sidebar must never *replace* itself when entering a
+  // section. A path-scoped key (e.g. `/cli/`) swaps the whole tree out, which
+  // deletes the other sections and reads as the nav breaking (see #301). There
+  // must be exactly one global `/` sidebar.
+  it('has a single global sidebar with no replacing path-scoped keys', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    expect(Object.keys(sidebar)).toEqual(['/'])
+  })
+
+  // The CLI section is self-contained: its group carries all CLI subpages,
+  // alongside (never instead of) the other sections (see #301).
+  it('shows every CLI subpage in a self-contained CLI group', () => {
+    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
+    const groupTexts = sidebar['/'].map((group) => group.text)
+    expect(groupTexts).toEqual(['Tutorials', 'How-to Guides', 'CLI', 'Reference'])
+
+    const cli = sidebar['/'].find((group) => group.text === 'CLI')
+    const links = (cli!.items ?? []).map((item) => item.link)
+    expect(links).toEqual([
+      '/cli/',
+      '/cli/server',
+      '/cli/init',
+      '/cli/config',
+      '/cli/http-api'
+    ])
+  })
+})

dirsql-0.3.41/packages/python/e2e-attestation.json

@@ -0,0 +1,6 @@
+{
+  "command": "uv run python -m pytest tests/e2e/ -x -q",
+  "ran_at": 1782763249,
+  "exit_code": 0,
+  "commit": "8a3051871b21e04c0c2c2cc11a57e4c0a9b94866"
+}

dirsql-0.3.41/packages/python/tests/e2e/__fixtures__/interpret/dirsql.config_nested.py

@@ -0,0 +1,13 @@
+"""Fixture: a native Python config that itself sets ``config=``.
+
+`dirsql interpret` must reject this -- a config file loaded by interpret
+cannot delegate to another config file (nested config loading). The
+referenced TOML is valid, so the rejection comes from the loader, not from
+a TOML read error.
+"""
+
+import os
+
+from dirsql import DirSQL
+
+app = DirSQL(config=os.path.join(os.path.dirname(__file__), "nested.dirsql.toml"))

dirsql-0.3.41/packages/python/tests/e2e/__fixtures__/interpret/dirsql.config_no_root.py

@@ -0,0 +1,26 @@
+"""Fixture: a native Python config that omits ``root``.
+
+`dirsql interpret` should resolve the root to the helper process's current
+working directory (the cwd the orchestrator was launched from) rather than
+erroring. Mirrors ``dirsql.config.py`` but drops the ``root=`` argument.
+"""
+
+import json
+
+from dirsql import DirSQL, Table
+
+
+def _extract(path):
+    with open(path, encoding="utf-8") as f:
+        return [json.load(f)]
+
+
+app = DirSQL(
+    tables=[
+        Table(
+            ddl="CREATE TABLE papers (title TEXT)",
+            glob="**/meta.json",
+            extract=_extract,
+        )
+    ],
+)

dirsql-0.3.41/packages/python/tests/e2e/__fixtures__/interpret/nested.dirsql.toml

@@ -0,0 +1,6 @@
+# Valid config referenced by `dirsql.config_nested.py`. Its validity is the
+# point: the interpret loader must reject the *nesting*, not fail on a bad
+# TOML read.
+[[table]]
+ddl = "CREATE TABLE papers (title TEXT)"
+glob = "**/meta.json"

{dirsql-0.3.39 → dirsql-0.3.41}/packages/rust/docs/cli/config.md

@@ -239,7 +239,7 @@ def extract_meta(path):
 
 # Python must export a module-level `app`.
 app = DirSQL(
-    root="papers",  # required — see "Set a root" below
+    root="papers",  # optional; defaults to the current directory
     tables=[
         Table(
             ddl="CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -269,7 +269,7 @@ import { readFileSync } from "node:fs";
 import { DirSQL } from "dirsql";
 
 export default new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -285,7 +285,7 @@ const { readFileSync } = require("node:fs");
 const { DirSQL } = require("dirsql");
 
 module.exports = new DirSQL({
-  root: "papers", // required — see "Set a root" below
+  root: "papers", // optional; defaults to the current directory
   tables: [
     {
       ddl: "CREATE TABLE papers (title TEXT, _path TEXT)",
@@ -308,10 +308,15 @@ These apply to both the Python and JavaScript forms above.
   package) uses `module.exports = new DirSQL(...)`. Only the extension
   matters — the file can be named anything; `dirsql.config.{py,mjs,cjs}` is the
   suggested convention, not a requirement.
-- **Set a `root`.** Unlike TOML configs (which default the scan root to the
-  config file's directory), native-language configs require an explicit `root`.
-  Without one the Python launcher errors and the JavaScript launcher silently
-  indexes nothing.
+- **`root` defaults to the current directory.** A native-language config with
+  no `root` indexes the process's current working directory — the directory you
+  ran `dirsql` from. (This differs from TOML configs, which default the scan
+  root to the config file's own directory.) Pass `root` explicitly to index
+  somewhere else.
+- **No nested `config=`.** A native-language config builds its `DirSQL` from
+  `tables` and an optional `root`; it must not itself set `config=` to delegate
+  to another config file. `dirsql interpret` rejects such a config (a nested
+  config can't be represented in the handshake and would recurse).
 - **Install the launcher on your `PATH`.** To run your `extract`, the server
   spawns `dirsql interpret`, so the matching `dirsql` launcher must be installed
   and on your `PATH` — a global `pip`/`uv` install for `.py`, or `npm` for

{dirsql-0.3.39/packages/python → dirsql-0.3.41/packages/rust}/docs/cli/index.md

@@ -20,7 +20,7 @@ Everything you need to run `dirsql` as a CLI lives in this section:
 - **[Configuration File](./config.md)** — the `.dirsql.toml` format and the
   `.py` / `.js` native-language alternative. Custom tables
   are defined through a config file; without one, the server runs in
-  [zero-config mode](./server.md#zero-config-mode).
+  [zero-config mode](./server.md#defaults).
 - **[HTTP API](./http-api.md)** — the `POST /query` and `GET /events`
   endpoints, status codes, and event streaming.
 

dirsql-0.3.39/docs/tests/unit/config.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import config from '../../.vitepress/config'
-
-type SidebarItem = { text?: string; link?: string; items?: SidebarItem[] }
-
-describe('vitepress config', () => {
-  it('has the expected site title and base path', () => {
-    expect(config.title).toBe('dirsql')
-    expect(config.base).toBe('/dirsql/')
-  })
-
-  // Regression guard: CLI docs live in their own `/cli/` section, not
-  // interleaved with the SDK how-to guides (see #179).
-  it('keeps CLI pages out of the How-to Guides group', () => {
-    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
-    const howTo = sidebar['/'].find((group) => group.text === 'How-to Guides')
-    const links = (howTo!.items ?? []).map((item) => item.link)
-    expect(links).not.toContain('/guide/cli')
-    expect(links).not.toContain('/guide/init')
-    expect(links).not.toContain('/guide/config')
-  })
-})

dirsql-0.3.39/packages/python/docs/tests/unit/config.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import config from '../../.vitepress/config'
-
-type SidebarItem = { text?: string; link?: string; items?: SidebarItem[] }
-
-describe('vitepress config', () => {
-  it('has the expected site title and base path', () => {
-    expect(config.title).toBe('dirsql')
-    expect(config.base).toBe('/dirsql/')
-  })
-
-  // Regression guard: CLI docs live in their own `/cli/` section, not
-  // interleaved with the SDK how-to guides (see #179).
-  it('keeps CLI pages out of the How-to Guides group', () => {
-    const sidebar = config.themeConfig!.sidebar as Record<string, SidebarItem[]>
-    const howTo = sidebar['/'].find((group) => group.text === 'How-to Guides')
-    const links = (howTo!.items ?? []).map((item) => item.link)
-    expect(links).not.toContain('/guide/cli')
-    expect(links).not.toContain('/guide/init')
-    expect(links).not.toContain('/guide/config')
-  })
-})

dirsql-0.3.39/packages/python/e2e-attestation.json

@@ -1,6 +0,0 @@
-{
-  "command": "uv run python -m pytest tests/e2e -q",
-  "ran_at": 1782734459,
-  "exit_code": 0,
-  "commit": "7c5cf2a6e06c5dfabc7ccf60d6b888aeabbaf892"
-}