@@ -17,18 +17,18 @@ file: + syncUrl (unchanged)                  -> 1 row back, 1 row after restart
 
 With the driver building its own client and the default `sync.onConnect`, two of these did fail at `connect()`, but on a libsql error that did not say why: `libsql://` + `syncUrl` with `SYNC_NOT_SUPPORTED`, and `:memory:` + `syncUrl` with `URL_INVALID`.
 
-**BREAKING** accept-set narrowing on a published driver option, shipped as `minor` under the repo's launch-window convention for breaking changes (`scripts/check-changeset-no-major.mjs`). **The constructor now refuses configurations it accepted before**, at `new TursoDriver()`, ahead of the Knex base and of any client, with the ADR-0112 envelope `code: 'VALIDATION_ERROR'`, `status: 400`. A remote url here means one of the lowercase schemes `TursoDriver.detectMode` classifies as remote: `libsql://`, `https://`, `http://`, `wss://`, `ws://`. Refused:
+**BREAKING** accept-set narrowing on a published driver option, shipped as `minor` under the repo's launch-window convention for breaking changes (`scripts/check-changeset-no-major.mjs`). **The constructor now refuses configurations it accepted before**, at `new TursoDriver()`, ahead of the Knex base and of any client, with the ADR-0112 envelope `code: 'VALIDATION_ERROR'`, `status: 400`. A remote url here means one of the schemes `TursoDriver.detectMode` classifies as remote: `libsql://`, `https://`, `http://`, `wss://`, `ws://`. The #19976 entry in this same version matches them in any letter case, so an uppercase `LIBSQL://` is a remote url too. Refused:
 
 - a remote url beside `syncUrl`;
 - a remote url under a forced `mode: 'replica'` or `mode: 'local'`;
 - a replica on a url `@libsql/client` reads as in-memory (`:memory:`, or `file::memory:` with or without a query string), beside `syncUrl` or under a forced `mode: 'replica'`. `@libsql/client` refuses such an embedded replica itself. For `:memory:` and a bare `file::memory:` the local engine was a private in-memory database. With a query string it was a file literally named after the url's path (for example `:memory:?cache=shared`) in the working directory, which no sync reaches;
-- under a forced `mode: 'replica'` only, any `url` that is not a local `file:` path, such as a bare path or an uppercase scheme.
+- under a forced `mode: 'replica'`, a `url` that is none of `:memory:`, a `file:` url or a remote url, such as a bare path or an unsupported scheme. The #19976 entry in this same version refuses such a url in every local or replica mode, and matches the `file:` scheme in any letter case: an uppercase `FILE:` url naming a file is a `file:` url and is not refused, and the replica runs on that file (`FILE::memory:` is refused as in-memory, like `file::memory:`).
 
 The remote-url refusal names the scheme it met. Neither refusal echoes the url, which may carry a token. Both loaders (`@objectstack/runtime`'s host factory and the datasource factory) reach this refusal through the same constructor, so a datasource declaring one of these configurations now fails by name when its loader builds the driver.
 
 **What stays accepted**, pinned by preservation tests: a `file:` url with `syncUrl` (the embedded replica), a `file:` or `:memory:` local database, a remote url on its own or with `mode: 'remote'`. `TursoDriver.detectMode()` still classifies a remote url beside `syncUrl` as `'replica'`: the refusal sits in the constructor, not in a re-classification.
 
-**Not refused, unchanged here:** a url with no `mode` that is none of `file:`, `:memory:` or a lowercase remote scheme, such as an uppercase `LIBSQL://` or a bare path like `./data/app.db`, still auto-detects `'local'` and still runs on `:memory:`, with or without `syncUrl`. So does the same url under a forced `mode: 'local'`. That fall-through is tracked as #19976.
+**Not refused by this change:** a url with no `mode` that is none of a lowercase `file:` url, `:memory:` or a lowercase remote scheme, such as an uppercase `LIBSQL://`, an uppercase `FILE:` url or a bare path like `./data/app.db`, auto-detected `'local'` with or without `syncUrl`, and the local engine was handed `:memory:`. Under a forced `mode: 'local'` the same url got the same `:memory:` engine. The #19976 entry in this same version removes that fall-through: it matches every scheme in any letter case, so an uppercase remote url is a remote url and an uppercase `FILE:` url is a `file:` url, and it refuses every other url in a local or replica mode. No configuration runs on an in-memory database it did not name.
 
 **What an affected author does.** Each refusal names its ways out. For a remote url in a local or replica mode:
 
 
@@ -28,11 +28,13 @@ file:<path> (unchanged)             -> local, 1 row back, 1 row after restart
 
 The unrecognised-url refusal names the `file:` spelling (`url: 'file:./data/app.db'`, or `url: 'file:./data/replica.db'` beside `syncUrl`) and never echoes the url, which may carry a token. `TursoDriver.detectMode()` now answers `'replica'` for such a url beside `syncUrl` (it answered `'local'`), which is what the declaration asks for. The refusal sits in the constructor, not in a re-classification.
 
+**Newly accepted:** an uppercase or mixed-case `FILE:` url naming a file, under a forced `mode: 'replica'`, with or without `syncUrl`. The #19893 change refused it, because under a forced `mode: 'replica'` it refused every url that did not start with a lowercase `file:`. With this change it is a `file:` url: the replica runs on that file, and its rows survive a restart (pinned). It is the one configuration the #19893 change refused that this change accepts.
+
 **What stays accepted**, pinned by preservation tests: a lowercase `file:` url, alone or with `syncUrl`; `:memory:` as a local database; a lowercase remote url on its own or with `mode: 'remote'`. A forced `mode: 'remote'` runs no local engine, so this change does not judge its url: a bare path there still constructs, and `@libsql/client` refuses it at `connect()` as `URL_INVALID`.
 
 **What an affected author does.** A local database file needs the `file:` prefix: `url: 'file:./data/app.db'`. For a throwaway in-memory database, `url: ':memory:'`. An uppercase remote url with no `mode` and no `syncUrl` now reaches the remote database and needs no change. Beside `syncUrl` or under a forced local or replica mode it is refused with the same ways out as the lowercase spelling.
 
-This closes the fall-through that the changelog entry for #19893 (the constructor refusal of a remote url in a local or replica mode) lists as "not refused, unchanged here".
+The #19893 entry in this same version (the constructor refusal of a remote url in a local or replica mode) describes this fall-through as not refused by that change, and names this entry as the one that removes it.
 
 Blast radius, measured on this tree: no example, template, hand-written doc, published skill or factory default, and no test fixture outside this package's own tests, spells a turso url with an uppercase scheme or as a bare path. Neither host url sniffer selects this driver for a bare path (both select it only for `libsql://` or an `http(s)://` url naming a `.turso.` host); only an explicit `OS_DATABASE_DRIVER=turso` or a datasource declaring `driver: 'turso'` hands it one. Whether any out-of-repo deployment declares such a url is NOT measured and is not claimed to be zero.
 
 
@@ -47,14 +47,20 @@
  *   refusal's; the client refuses a bare path there itself, at `connect()`.
  * - PRESERVATION, beside this file's neighbours: `file:` local and replica,
  *   `:memory:` local, a lowercase remote url, `mode: 'remote'`.
+ * - The one WIDENED cell: an uppercase `FILE:` url naming a file under a
+ *   forced `mode: 'replica'`, with or without `syncUrl`. At `a7581b326` the
+ *   constructor refused it (a forced replica had to start with a lowercase
+ *   `file:`); it is now a `file:` url, so the replica runs on that file and
+ *   keeps its rows across a restart.
  *
  * # Reverse verification: direction predicted before it was run
  *
  * With `turso-driver.ts` restored to its `a7581b326` content, every refusal
  * case and every uppercase-classification case goes RED (the constructor
  * returns a `'local'` driver on `:memory:`, with no envelope to read, and the
  * `FILE:` rows do not survive the restart) and every preservation and scope
- * case stays GREEN. Measured; see the PR.
+ * case stays GREEN, except the WIDENED cell's cases, which go RED the other
+ * way: there the constructor refuses. Measured; see the PR.
  */
 
 import { afterAll, describe, expect, it } from 'vitest';
@@ -281,7 +287,7 @@ describe('SCOPE: a forced remote mode has no local engine, so this refusal does
   });
 });
 
-describe('PRESERVATION: the recognised spellings construct exactly as before', () => {
+describe('PRESERVATION: the recognised spellings construct, and the one cell this change widens', () => {
   it.each<[string, TursoDriverConfig, string]>([
     ['file: local', { url: 'file:./data/app.db' }, 'local'],
     [':memory: local (ephemeral by declaration)', { url: ':memory:' }, 'local'],
@@ -292,8 +298,40 @@ describe('PRESERVATION: the recognised spellings construct exactly as before', (
     ['lowercase https:// remote', { url: `https://${HOST}`, authToken: 't' }, 'remote'],
     ["libsql:// + mode 'remote'", { url: `libsql://${HOST}`, mode: 'remote' }, 'remote'],
     ["file: + mode 'remote'", { url: 'file:./data/app.db', mode: 'remote' }, 'remote'],
+    // WIDENED: refused at a7581b326, where a forced replica had to start with a
+    // lowercase `file:`. An uppercase `FILE:` url is a `file:` url now.
+    ["WIDENED: FILE: + mode 'replica', no syncUrl", { url: 'FILE:./data/replica.db', mode: 'replica' }, 'replica'],
+    ["WIDENED: FILE: + mode 'replica' + syncUrl", { url: 'FILE:./data/replica.db', syncUrl: PRIMARY, mode: 'replica' }, 'replica'],
   ])('%s', (_label, config, mode) => {
     // Knex opens its connection lazily, so constructing never touches the file.
     expect(new TursoDriver(config).transportMode).toBe(mode);
   });
+
+  it.each<[string, boolean]>([
+    ['no syncUrl', false],
+    ['with syncUrl', true],
+  ])("WIDENED: FILE: + mode 'replica', %s, runs on the named file and keeps its rows across a restart", async (_label, withSync) => {
+    const url = upperFile(files.next());
+    const stub = makeLibsqlSqliteStub();
+    const make = () =>
+      new TursoDriver({
+        url,
+        mode: 'replica',
+        ...(withSync ? { syncUrl: PRIMARY, client: stub as never, sync: { onConnect: false } } : {}),
+      });
+
+    const first = make();
+    expect(first.transportMode).toBe('replica');
+    await first.connect();
+    await first.initObjects([NOTE as never]);
+    await first.create('note', { id: 'n1', title: 'kept' });
+    await first.disconnect();
+
+    const second = make();
+    await second.connect();
+    await second.initObjects([NOTE as never]);
+    expect((await second.find('note', {})).map((r: { title?: unknown }) => r.title)).toEqual(['kept']);
+    await second.disconnect();
+    stub.close();
+  });
 });