dirsql 0.3.4 → 0.3.6

package/dist/bin/dirsql.js

@@ -1,12 +1,14 @@
 #!/usr/bin/env node
-// npm `bin` entry for `dirsql`. Runs the launcher when invoked from the
-// command line; doesn't do anything when imported (so tests can pull in
-// individual modules without side effects).
+// npm `bin` entry for `dirsql`. The package.json `bin` field points at
+// the compiled version of this file; npm symlinks `node_modules/.bin/dirsql`
+// to it. Always runs the launcher -- nothing else should import this
+// file (test the helpers in `main.ts` / `resolveBinary.ts` instead).
+//
+// A prior `process.argv[1] === import.meta.filename` self-detection
+// guard tripped up the npm-bin symlink: argv[1] is the (unresolved)
+// symlink path, while import.meta.filename is the realpath, and the
+// guard silently skipped main() so `dirsql --version` produced no
+// output (caught by the pack-install build-CI smoke test).
 import { main } from "./main.js";
-// `import.meta.filename` (Node 20.11+) avoids the
-// `dirname(fileURLToPath(import.meta.url))` boilerplate. When this
-// module is the script Node was invoked with, run the launcher.
-if (process.argv[1] === import.meta.filename) {
-    main();
-}
+main();
 //# sourceMappingURL=dirsql.js.map

package/dist/bin/dirsql.js.map

@@ -1 +1 @@
-{"version":3,"file":"dirsql.js","sourceRoot":"","sources":["../../ts/bin/dirsql.ts"],"names":[],"mappings":";AACA,wEAAwE;AACxE,wEAAwE;AACxE,4CAA4C;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,kDAAkD;AAClD,mEAAmE;AACnE,gEAAgE;AAChE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7C,IAAI,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"dirsql.js","sourceRoot":"","sources":["../../ts/bin/dirsql.ts"],"names":[],"mappings":";AACA,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,qEAAqE;AACrE,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,oEAAoE;AACpE,kEAAkE;AAClE,2DAA2D;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,EAAE,CAAC"}

package/docs/getting-started.md

@@ -31,7 +31,7 @@ cargo install dirsql --features cli
 
 :::
 
-See the [CLI guide](./guide/cli.md) for details on the command-line interface, and the [Rust library README](https://github.com/thekevinscott/dirsql/tree/main/packages/rust) for the library-vs-CLI feature split.
+See the [CLI section](./cli/) for details on the command-line interface, and the [Rust library README](https://github.com/thekevinscott/dirsql/tree/main/packages/rust) for the library-vs-CLI feature split.
 
 ## Quick start
 
@@ -182,5 +182,5 @@ The filesystem is always the source of truth. The database is rebuilt from files
 - [Querying](./guide/querying.md) -- SQL queries and return format
 - [File Watching](./guide/watching.md) -- real-time change events
 - [Async API](./guide/async.md) -- async ready(), query(), and watch()
-- [Command-Line Interface](./guide/cli.md) -- `dirsql` runs an HTTP server (`POST /query`, `GET /events` SSE)
+- [Using `dirsql` from the CLI](./cli/) -- `dirsql` runs an HTTP server (`POST /query`, `GET /events` SSE)
 - [Collaboration with CRDTs](./guide/crdt.md) -- multi-writer document merging alongside `dirsql`

package/docs/guide/querying.md

@@ -8,6 +8,10 @@ canonical: https://thekevinscott.github.io/dirsql/guide/querying
 
 Once a `DirSQL` instance is created, the initial directory scan is complete and you can run SQL queries against the indexed data.
 
+::: tip From the CLI
+The `dirsql` HTTP server exposes the same query interface over [`POST /query`](../cli/http-api.md#post-query). Send `{"sql": "..."}` and get back the same JSON array of row objects. See the [CLI section](../cli/) for the full server setup.
+:::
+
 ## Basic queries
 
 ::: code-group

package/docs/guide/watching.md

@@ -8,6 +8,10 @@ canonical: https://thekevinscott.github.io/dirsql/guide/watching
 
 `dirsql` can monitor the filesystem for changes and emit events when rows are inserted, updated, or deleted. This is useful for building reactive applications that respond to file changes in real time.
 
+::: tip From the CLI
+The `dirsql` HTTP server streams the same events over [`GET /events`](../cli/http-api.md#get-events) as a [Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events) stream. Each `data:` payload uses the same JSON schema described in [Event types](#event-types) below. See the [CLI section](../cli/) for the full server setup.
+:::
+
 ## Starting a watch stream
 
 ::: code-group

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -39,6 +39,7 @@
     "test": "wireit",
     "test:unit": "wireit",
     "test:integration": "wireit",
+    "test:e2e": "wireit",
     "coverage": "wireit",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
@@ -142,6 +143,21 @@
       ],
       "output": []
     },
+    "test:e2e": {
+      "command": "vitest run --dir test-e2e --passWithNoTests",
+      "dependencies": [
+        "build"
+      ],
+      "files": [
+        "ts/**/*.ts",
+        "tools/**/*.ts",
+        "test-e2e/**/*.ts",
+        "vitest.config.ts",
+        "../rust/src/**/*.rs",
+        "../rust/Cargo.toml"
+      ],
+      "output": []
+    },
     "coverage": {
       "command": "vitest run --coverage",
       "dependencies": [
@@ -175,15 +191,15 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.3.4",
-    "@dirsql/lib-linux-arm64-gnu": "0.3.4",
-    "@dirsql/lib-darwin-x64": "0.3.4",
-    "@dirsql/lib-darwin-arm64": "0.3.4",
-    "@dirsql/lib-win32-x64-msvc": "0.3.4",
-    "@dirsql/cli-linux-x64-gnu": "0.3.4",
-    "@dirsql/cli-linux-arm64-gnu": "0.3.4",
-    "@dirsql/cli-darwin-x64": "0.3.4",
-    "@dirsql/cli-darwin-arm64": "0.3.4",
-    "@dirsql/cli-win32-x64-msvc": "0.3.4"
+    "@dirsql/lib-linux-x64-gnu": "0.3.6",
+    "@dirsql/lib-linux-arm64-gnu": "0.3.6",
+    "@dirsql/lib-darwin-x64": "0.3.6",
+    "@dirsql/lib-darwin-arm64": "0.3.6",
+    "@dirsql/lib-win32-x64-msvc": "0.3.6",
+    "@dirsql/cli-linux-x64-gnu": "0.3.6",
+    "@dirsql/cli-linux-arm64-gnu": "0.3.6",
+    "@dirsql/cli-darwin-x64": "0.3.6",
+    "@dirsql/cli-darwin-arm64": "0.3.6",
+    "@dirsql/cli-win32-x64-msvc": "0.3.6"
   }
 }

package/dist/bin/die.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=die.test.d.ts.map

package/dist/bin/die.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"die.test.d.ts","sourceRoot":"","sources":["../../ts/bin/die.test.ts"],"names":[],"mappings":""}

package/dist/bin/die.test.js

@@ -1,34 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-import { die } from "./die.js";
-afterEach(() => vi.restoreAllMocks());
-describe("die", () => {
-    describe("by default", () => {
-        it("writes a `dirsql: ` prefixed message to stderr", () => {
-            const write = vi.spyOn(process.stderr, "write").mockReturnValue(true);
-            vi.spyOn(process, "exit").mockImplementation(((code) => {
-                throw new Error(`exit:${code}`);
-            }));
-            expect(() => die("boom")).toThrow("exit:1");
-            expect(write).toHaveBeenCalledWith("dirsql: boom\n");
-        });
-        it("exits with code 1", () => {
-            vi.spyOn(process.stderr, "write").mockReturnValue(true);
-            const exit = vi.spyOn(process, "exit").mockImplementation(((code) => {
-                throw new Error(`exit:${code}`);
-            }));
-            expect(() => die("boom")).toThrow();
-            expect(exit).toHaveBeenCalledWith(1);
-        });
-    });
-    describe("with an explicit exit code", () => {
-        it("passes the code to process.exit", () => {
-            vi.spyOn(process.stderr, "write").mockReturnValue(true);
-            const exit = vi.spyOn(process, "exit").mockImplementation(((code) => {
-                throw new Error(`exit:${code}`);
-            }));
-            expect(() => die("nope", 7)).toThrow();
-            expect(exit).toHaveBeenCalledWith(7);
-        });
-    });
-});
-//# sourceMappingURL=die.test.js.map

package/dist/bin/die.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"die.test.js","sourceRoot":"","sources":["../../ts/bin/die.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;AAEtC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACnB,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACtE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAC5C,IAA6B,EAC7B,EAAE;gBACF,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC,CAAwB,CAAC,CAAC;YAE3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CACzD,IAA6B,EAC7B,EAAE;gBACF,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC,CAAwB,CAAC,CAAC;YAE3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CACzD,IAA6B,EAC7B,EAAE;gBACF,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC,CAAwB,CAAC,CAAC;YAE3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/bin/main.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=main.test.d.ts.map

package/dist/bin/main.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.test.d.ts","sourceRoot":"","sources":["../../ts/bin/main.test.ts"],"names":[],"mappings":""}

package/dist/bin/main.test.js

@@ -1,121 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-vi.mock("./resolveBinary", () => ({ resolveBinary: vi.fn() }));
-vi.mock("node:child_process", () => ({ spawnSync: vi.fn() }));
-import { spawnSync } from "node:child_process";
-import { main } from "./main.js";
-import { resolveBinary } from "./resolveBinary.js";
-const spawnSyncMock = vi.mocked(spawnSync);
-const resolveBinaryMock = vi.mocked(resolveBinary);
-afterEach(() => vi.restoreAllMocks());
-function stubExit() {
-    return vi.spyOn(process, "exit").mockImplementation(((code) => {
-        throw new Error(`exit:${code}`);
-    }));
-}
-function stubStderr() {
-    vi.spyOn(process.stderr, "write").mockReturnValue(true);
-}
-function stubKill() {
-    return vi.spyOn(process, "kill").mockImplementation(() => true);
-}
-describe("main", () => {
-    describe("on success", () => {
-        it("resolves the binary, spawns it with argv, and exits with the child's status", () => {
-            resolveBinaryMock.mockReturnValue("/real/dirsql");
-            spawnSyncMock.mockReturnValue({
-                status: 0,
-                signal: null,
-                pid: 123,
-                output: [],
-                stdout: Buffer.from(""),
-                stderr: Buffer.from(""),
-            });
-            const exit = stubExit();
-            expect(() => main(["--help"])).toThrow("exit:0");
-            expect(resolveBinaryMock).toHaveBeenCalledTimes(1);
-            expect(spawnSyncMock).toHaveBeenCalledWith("/real/dirsql", ["--help"], {
-                stdio: "inherit",
-            });
-            expect(exit).toHaveBeenCalledWith(0);
-        });
-    });
-    describe("when the child exits non-zero", () => {
-        it("forwards the exit code", () => {
-            resolveBinaryMock.mockReturnValue("/real/dirsql");
-            spawnSyncMock.mockReturnValue({
-                status: 42,
-                signal: null,
-                pid: 1,
-                output: [],
-                stdout: Buffer.from(""),
-                stderr: Buffer.from(""),
-            });
-            const exit = stubExit();
-            expect(() => main([])).toThrow("exit:42");
-            expect(exit).toHaveBeenCalledWith(42);
-        });
-    });
-    describe("when spawn fails to launch the child", () => {
-        it("dies with the spawn error message and exits 1", () => {
-            resolveBinaryMock.mockReturnValue("/real/dirsql");
-            spawnSyncMock.mockReturnValue({
-                status: null,
-                signal: null,
-                pid: 0,
-                output: [],
-                stdout: Buffer.from(""),
-                stderr: Buffer.from(""),
-                error: new Error("ENOENT"),
-            });
-            stubStderr();
-            const exit = stubExit();
-            expect(() => main([])).toThrow();
-            expect(exit).toHaveBeenCalledWith(1);
-            expect(process.stderr.write).toHaveBeenCalledWith(expect.stringContaining("ENOENT"));
-        });
-    });
-    describe("when the child dies from a signal", () => {
-        it("re-raises the same signal against itself", () => {
-            resolveBinaryMock.mockReturnValue("/real/dirsql");
-            spawnSyncMock.mockReturnValue({
-                status: null,
-                signal: "SIGINT",
-                pid: 1,
-                output: [],
-                stdout: Buffer.from(""),
-                stderr: Buffer.from(""),
-            });
-            const kill = stubKill();
-            const exit = stubExit();
-            expect(() => main([])).toThrow();
-            expect(kill).toHaveBeenCalledWith(process.pid, "SIGINT");
-            expect(exit).toHaveBeenCalledWith(1);
-        });
-    });
-    describe("when argv is omitted", () => {
-        it("defaults to process.argv.slice(2)", () => {
-            resolveBinaryMock.mockReturnValue("/real/dirsql");
-            spawnSyncMock.mockReturnValue({
-                status: 0,
-                signal: null,
-                pid: 1,
-                output: [],
-                stdout: Buffer.from(""),
-                stderr: Buffer.from(""),
-            });
-            vi.stubGlobal("process", {
-                ...process,
-                argv: ["node", "bin", "a", "b"],
-            });
-            stubExit();
-            try {
-                main();
-            }
-            catch {
-                // process.exit is stubbed to throw
-            }
-            expect(spawnSyncMock).toHaveBeenCalledWith("/real/dirsql", ["a", "b"], expect.any(Object));
-        });
-    });
-});
-//# sourceMappingURL=main.test.js.map

package/dist/bin/main.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.test.js","sourceRoot":"","sources":["../../ts/bin/main.test.ts"],"names":[],"mappings":"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"}

package/dist/bin/resolveBinary.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=resolveBinary.test.d.ts.map

package/dist/bin/resolveBinary.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolveBinary.test.d.ts","sourceRoot":"","sources":["../../ts/bin/resolveBinary.test.ts"],"names":[],"mappings":""}

package/dist/bin/resolveBinary.test.js

@@ -1,60 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-import { defaultResolver, resolveBinary, } from "./resolveBinary.js";
-afterEach(() => {
-    vi.restoreAllMocks();
-});
-function exitThrower() {
-    return vi.spyOn(process, "exit").mockImplementation(((code) => {
-        throw new Error(`exit:${code}`);
-    }));
-}
-describe("defaultResolver", () => {
-    it("returns a function that resolves node built-ins", () => {
-        const resolve = defaultResolver();
-        expect(typeof resolve).toBe("function");
-        // `node:fs` is always resolvable from any Node-reachable module.
-        expect(resolve("node:fs")).toBe("node:fs");
-    });
-});
-describe("resolveBinary", () => {
-    describe("with a supported platform key", () => {
-        it("returns the resolver's result for the matching package", () => {
-            const resolver = vi.fn().mockReturnValue("/real/linux/dirsql");
-            const path = resolveBinary("linux-x64", resolver);
-            expect(path).toBe("/real/linux/dirsql");
-            expect(resolver).toHaveBeenCalledWith(expect.stringContaining("@dirsql/cli-linux-x64-gnu"));
-        });
-    });
-    describe("with an unsupported platform key", () => {
-        it("dies with a `cargo install` hint", () => {
-            vi.spyOn(process.stderr, "write").mockReturnValue(true);
-            const exit = exitThrower();
-            expect(() => resolveBinary("sunos-sparc", () => "")).toThrow();
-            expect(exit).toHaveBeenCalledWith(1);
-            expect(process.stderr.write).toHaveBeenCalledWith(expect.stringContaining("no prebuilt binary for sunos-sparc"));
-        });
-    });
-    describe("on Windows", () => {
-        it("appends .exe to the resolved binary name", () => {
-            vi.stubGlobal("process", { ...process, platform: "win32" });
-            const resolver = vi
-                .fn()
-                .mockReturnValue("C:\\fake\\dirsql.exe");
-            resolveBinary("win32-x64", resolver);
-            expect(resolver).toHaveBeenCalledWith(expect.stringMatching(/dirsql\.exe$/));
-        });
-    });
-    describe("when the optional dep is not installed", () => {
-        it("dies with an `--no-optional` hint", () => {
-            vi.spyOn(process.stderr, "write").mockReturnValue(true);
-            const exit = exitThrower();
-            const resolver = () => {
-                throw new Error("Cannot find module");
-            };
-            expect(() => resolveBinary("linux-x64", resolver)).toThrow();
-            expect(exit).toHaveBeenCalledWith(1);
-            expect(process.stderr.write).toHaveBeenCalledWith(expect.stringContaining("is not installed"));
-        });
-    });
-});
-//# sourceMappingURL=resolveBinary.test.js.map

package/dist/bin/resolveBinary.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolveBinary.test.js","sourceRoot":"","sources":["../../ts/bin/resolveBinary.test.ts"],"names":[],"mappings":"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"}

package/docs/guide/cli.md

@@ -1,131 +0,0 @@
----
-canonical: https://thekevinscott.github.io/dirsql/guide/cli
----
-
-# Command-Line Interface
-
-> Online: <https://thekevinscott.github.io/dirsql/guide/cli>
-
-`dirsql` starts an HTTP server that exposes identical SDK functionality.
-
-## Installation
-
-::: code-group
-
-```bash [npm]
-npx dirsql
-```
-
-```bash [PyPI]
-uvx dirsql
-```
-
-```bash [Cargo]
-# Installs the binary only (non-default feature)
-cargo install dirsql --features cli
-dirsql
-```
-
-:::
-
-::: tip For Rust library consumers
-The `cli` feature is **opt-in**. Adding `dirsql` as a library dependency (`cargo add dirsql`) pulls no CLI dependencies — only the core library. See the [Rust library README](https://github.com/thekevinscott/dirsql/tree/main/packages/rust) for details.
-:::
-
-## Subcommands
-
-| Command | Purpose |
-|---|---|
-| `dirsql` (no subcommand) | Start the long-lived HTTP server (default behavior, see below). |
-| `dirsql init` | Generate a starter `.dirsql.toml` from the contents of a directory. See [Generating a Config](./init.md). |
-
-## Running the server
-
-Run `dirsql` from the directory containing your files:
-
-```bash
-dirsql
-
-$ Running at localhost:7117
-```
-
-### Flags
-
-| Flag | Default | Description |
-|---|---|---|
-| `--config <path>` | `./.dirsql.toml` | Path to the config file. The index is rooted at the directory containing this file. |
-| `--host <addr>` | `localhost` | Bind address |
-| `--port <n>` | `7117` | TCP port to bind |
-
-## HTTP API
-
-### `POST /query`
-
-Run a SQL query. Request body is JSON:
-
-```json
-{"sql": "SELECT title, author FROM posts WHERE draft = 0"}
-```
-
-Response is a JSON array of row objects:
-
-```json
-[
-  {"title": "Hello World", "author": "alice"},
-  {"title": "Second Post", "author": "bob"}
-]
-```
-
-On error, the server returns a non-2xx status with a JSON body:
-
-```json
-{"error": "syntax error near \"SLECT\""}
-```
-
-Malformed SQL returns `400`, not `500` — the client sent bad input. Missing / unreadable config returns `503`.
-
-```bash
-curl -s http://localhost:7117/query \
-  -H 'content-type: application/json' \
-  -d '{"sql":"SELECT COUNT(*) AS n FROM posts"}' \
-  | jq
-```
-
-### `GET /events`
-
-Opens a [Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events) stream of change events. Each `data:` payload is the same JSON schema the SDK emits from [`db.watch()`](./watching.md#event-types):
-
-```
-event: row
-data: {"action":"insert","table":"posts","file_path":"posts/hello.json","row":{"title":"Hello World","author":"alice"},"old_row":null}
-
-event: row
-data: {"action":"update","table":"posts","file_path":"posts/hello.json","row":{"title":"Hello, world","author":"alice"},"old_row":{"title":"Hello World","author":"alice"}}
-
-event: row
-data: {"action":"delete","table":"posts","file_path":"posts/second.json","row":{"title":"Second Post","author":"bob"},"old_row":null}
-```
-
-Errors during extraction appear as `{"action":"error",...}` events on the same stream. They do **not** terminate the stream — a malformed file is a per-event problem, not a server-wide one.
-
-```bash
-curl -N http://localhost:7117/events
-```
-
-## Piping event streams
-
-The SSE stream is easy to tee into shell tools with `curl -N` plus `jq`:
-
-```bash
-# Log every delete to a file
-curl -N http://localhost:7117/events \
-  | jq -cR 'fromjson? | select(.action=="delete")' \
-  >> deletes.log
-
-# Alert on errors
-curl -N http://localhost:7117/events \
-  | jq -c 'fromjson? | select(.action=="error")' \
-  | while read -r line; do notify-send "dirsql error" "$line"; done
-```
-
-(The `fromjson?` wrapping strips the `data:` framing; drop it if your SSE client is already parsing frames.)

package/docs/guide/config.md

@@ -1,193 +0,0 @@
----
-canonical: https://thekevinscott.github.io/dirsql/guide/config
----
-
-# Configuration File
-
-> Online: <https://thekevinscott.github.io/dirsql/guide/config>
-
-`dirsql` can be configured with a `.dirsql.toml` file. Tables defined this
-way produce **one row per matched file**. Each row's columns come from
-filesystem facts:
-
-- **Glob path captures** — named `{placeholder}` segments in the glob.
-- **Stat virtuals** — reserved `_`-prefixed columns for path-derived and
-  stat-derived metadata.
-
-Content interpretation (parsing JSON, CSV, frontmatter, etc.) is **not**
-configured in `.dirsql.toml`. If you need columns derived from file
-contents, register a programmatic [`Table`](./tables.md) whose `extract`
-function does the parsing in your host language.
-
-## Basic Example
-
-```toml
-[dirsql]
-ignore = ["node_modules/**", ".git/**"]
-
-[[table]]
-ddl  = "CREATE TABLE posts (_path TEXT, _basename TEXT, _size INTEGER, _mtime INTEGER)"
-glob = "posts/*.md"
-```
-
-Each `posts/*.md` file produces one row. The DDL declares which stat
-virtuals are surfaced as SQL columns.
-
-## Loading a Config File
-
-Pass the config file path to the `DirSQL` constructor:
-
-::: code-group
-
-```python [Python]
-from dirsql import DirSQL
-
-db = DirSQL(config="./my-project/.dirsql.toml")
-await db.ready()
-```
-
-```rust [Rust]
-use dirsql::DirSQL;
-
-let db = DirSQL::builder()
-    .config("./my-project/.dirsql.toml")
-    .build()?;
-```
-
-```typescript [TypeScript]
-import { DirSQL } from "dirsql";
-
-// String argument is interpreted as a config file path.
-const db = new DirSQL("./my-project/.dirsql.toml");
-await db.ready;
-```
-
-:::
-
-By default, the root directory scanned is the config file's parent
-directory. Override it by passing `root` explicitly (the explicit value
-wins and a warning is emitted) or by declaring `[dirsql].root` in the
-config file itself.
-
-## Root Directory
-
-By default, the config file's parent directory is the scan root. To index
-a different location, declare `[dirsql].root` (relative paths are resolved
-relative to the config file's parent):
-
-```toml
-[dirsql]
-root = "../data"
-ignore = ["node_modules/**"]
-```
-
-## Stat Virtuals
-
-Every config-defined table can expose any of these reserved columns. Add
-the ones you want to your DDL; the rest are silently dropped.
-
-| Column | Type    | Source |
-|--------|---------|--------|
-| `_path`     | TEXT    | The file's path relative to the scan root. |
-| `_basename` | TEXT    | The filename including extension. |
-| `_dir`      | TEXT    | The parent directory path (relative to root). |
-| `_ext`      | TEXT    | The file extension, lowercased, no leading dot. |
-| `_size`     | INTEGER | Size in bytes. |
-| `_mtime`    | INTEGER | Last-modified time, unix seconds. |
-| `_ctime`    | INTEGER | Created/changed time, unix seconds. |
-
-Example query:
-
-```sql
-SELECT _basename, _size
-FROM posts
-WHERE _mtime > strftime('%s', '2024-01-01')
-ORDER BY _mtime DESC;
-```
-
-## Path Captures
-
-Use `{name}` in glob patterns to extract path segments as columns. Add a
-matching column name to the DDL and the capture is auto-populated:
-
-```toml
-[[table]]
-ddl  = "CREATE TABLE comments (thread_id TEXT, _basename TEXT, _mtime INTEGER)"
-glob = "_comments/{thread_id}/*.jsonl"
-```
-
-A file at `_comments/abc123/2024-05-05.jsonl` produces a row with
-`thread_id = "abc123"`, `_basename = "2024-05-05.jsonl"`, and `_mtime` set
-to the file's modification time.
-
-## Ignore Patterns
-
-The `ignore` list skips files and directories entirely (not even scanned):
-
-```toml
-[dirsql]
-ignore = ["node_modules/**", ".git/**", "*.pyc", "__pycache__/**"]
-```
-
-The top-level `.dirsql/` directory is always excluded, whether you list it
-or not — it is a reserved namespace for `dirsql`'s own metadata (see
-[Persistence](./persistence.md)).
-
-## Persistence
-
-Set `persist = true` to keep the SQLite database on disk between runs
-instead of rebuilding from scratch on every startup:
-
-```toml
-[dirsql]
-persist = true
-# persist_path = ".dirsql/cache.db"   # optional; this is the default
-```
-
-See [Persistence](./persistence.md) for the full reconcile algorithm,
-storage layout, and limitations.
-
-## Strict Mode
-
-By default, auto-injected virtuals that aren't in the DDL are silently
-dropped, and undeclared user-extract keys are dropped. Enable strict mode
-to error when an extract emits keys not declared in the DDL:
-
-```toml
-[[table]]
-ddl  = "CREATE TABLE comments (thread_id TEXT)"
-glob = "_comments/{thread_id}/*.jsonl"
-strict = true
-```
-
-Strict mode does **not** apply to auto-injected stat virtuals — those are
-always filtered to the DDL's declared columns regardless. Strict mode
-applies only to keys produced by an extract callback (relevant for
-programmatic [tables](./tables.md)).
-
-## Full Example
-
-```toml
-[dirsql]
-ignore = ["node_modules/**", ".git/**", "dist/**"]
-
-[[table]]
-ddl  = "CREATE TABLE comments (thread_id TEXT, _basename TEXT, _mtime INTEGER)"
-glob = "_comments/{thread_id}/*.jsonl"
-
-[[table]]
-ddl  = "CREATE TABLE documents (_path TEXT, _basename TEXT, _size INTEGER)"
-glob = "**/index.md"
-
-[[table]]
-ddl  = "CREATE TABLE logs (_path TEXT, _size INTEGER, _mtime INTEGER)"
-glob = "logs/*.csv"
-```
-
-## When you need parsed content
-
-`.dirsql.toml` does not parse file contents. For columns derived from the
-*inside* of files (frontmatter keys, JSON values, CSV cells, etc.),
-register a programmatic [`Table`](./tables.md) instead, and parse the
-bytes in your host language. Glob captures and stat virtuals are still
-auto-injected into rows produced by your extract.

package/docs/guide/init.md

@@ -1,84 +0,0 @@
----
-canonical: https://thekevinscott.github.io/dirsql/guide/init
----
-
-# Generating a config with `dirsql init`
-
-> Online: <https://thekevinscott.github.io/dirsql/guide/init>
-
-`dirsql init` generates a `.dirsql.toml` by running `claude` over the target directory.
-
-The output is limited to filesystem-fact tables. For content-aware schemas, see [Defining Tables](./tables.md).
-
-## Examples
-
-### Mixed files
-
-```
-my-downloads/
-├── archive.zip
-├── invoice.pdf
-├── notes.txt
-└── photo.jpg
-```
-
-```toml
-[[table]]
-ddl  = "CREATE TABLE files (_path TEXT, _ext TEXT, _size INTEGER)"
-glob = "*"
-```
-
-### Path captures
-
-```
-photos/
-├── 2024-01/
-│   ├── beach.jpg
-│   └── sunset.jpg
-└── 2024-02/
-    ├── snow.jpg
-    └── mountain.jpg
-```
-
-```toml
-[[table]]
-ddl  = "CREATE TABLE photos (month TEXT, _basename TEXT, _mtime INTEGER)"
-glob = "{month}/*.jpg"
-```
-
-### Multiple tables
-
-```
-my-blog/
-├── posts/
-│   ├── hello-world.md
-│   └── second.md
-└── _comments/
-    └── hello-world/
-        ├── 2024-01-15.jsonl
-        └── 2024-02-03.jsonl
-```
-
-```toml
-[[table]]
-ddl  = "CREATE TABLE posts (_basename TEXT, _mtime INTEGER, _size INTEGER)"
-glob = "posts/*.md"
-
-[[table]]
-ddl  = "CREATE TABLE comments (thread_id TEXT, _basename TEXT, _mtime INTEGER)"
-glob = "_comments/{thread_id}/*.jsonl"
-```
-
-`init` will not overwrite an existing config without `--force`.
-
-## Flags
-
-| Flag | Default | Description |
-|---|---|---|
-| `--root <path>` | cwd | Directory to scan |
-| `--output <path>` | `<root>/.dirsql.toml` | Output path |
-| `--force` | off | Overwrite if the output exists |
-
-## Authentication
-
-Requires `claude` on `PATH` and signed in. There is no separate API key. If `claude` is missing, `dirsql init` raises an exception.