release: 2.5.0 — cosmokv CLI + schema introspection

New dotnet global tool `cosmokv` (CosmoSQLClient.CosmoKv.Cli) gives an
sqlite3-style shell to any CosmoKv database: REPL, one-shot SQL, stdin
scripts, four output formats (table/csv/tsv/json), and dot-commands for
.tables / .schema / .indexes / .dump / .format.

To make the CLI possible without exposing internal schema types, the
driver gains a small public introspection surface on CosmoKvConnection:
GetTableNames(), GetTableScript(name), GetIndexScriptsForTable(name),
ScriptSchema(). Output round-trips through the parser, so .dump output
is safe to replay against an empty CosmoKv.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: vkuttyp

.github/workflows/nuget.yml

@@ -88,6 +88,11 @@ jobs:
             -p:Version=${{ steps.version.outputs.VERSION }} \
             -o ./nupkgs
 
+          dotnet pack src/CosmoSQLClient.CosmoKv.Cli/CosmoSQLClient.CosmoKv.Cli.csproj \
+            -c Release \
+            -p:Version=${{ steps.version.outputs.VERSION }} \
+            -o ./nupkgs
+
           ls -la ./nupkgs
 
       - name: Push to NuGet

CosmoSQLClient-Dotnet.sln

@@ -41,6 +41,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CosmoSQLClient.CosmoKv.Test
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CosmoSQLClient.CosmoKvHttp", "src\CosmoSQLClient.CosmoKvHttp\CosmoSQLClient.CosmoKvHttp.csproj", "{89630EF9-0FE4-4C0C-A858-798CDCE700E3}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CosmoSQLClient.CosmoKv.Cli", "src\CosmoSQLClient.CosmoKv.Cli\CosmoSQLClient.CosmoKv.Cli.csproj", "{520F292D-D5B8-415F-84DD-B3072EBBBE63}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -255,6 +257,18 @@ Global
 		{89630EF9-0FE4-4C0C-A858-798CDCE700E3}.Release|x64.Build.0 = Release|Any CPU
 		{89630EF9-0FE4-4C0C-A858-798CDCE700E3}.Release|x86.ActiveCfg = Release|Any CPU
 		{89630EF9-0FE4-4C0C-A858-798CDCE700E3}.Release|x86.Build.0 = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|x64.Build.0 = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Debug|x86.Build.0 = Debug|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|Any CPU.Build.0 = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|x64.ActiveCfg = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|x64.Build.0 = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|x86.ActiveCfg = Release|Any CPU
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -277,5 +291,6 @@ Global
 		{63463845-4079-4171-ABE3-525606D36AB6} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
 		{65E8881F-CEEC-4085-84DC-7BBFDE746E43} = {0AB3BF05-4346-4AA6-1389-037BE0695223}
 		{89630EF9-0FE4-4C0C-A858-798CDCE700E3} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
+		{520F292D-D5B8-415F-84DD-B3072EBBBE63} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B}
 	EndGlobalSection
 EndGlobal

Directory.Build.props

@@ -7,6 +7,6 @@
     <Authors>vkuttyp</Authors>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <RepositoryUrl>https://github.com/vkuttyp/CosmoSQLClient-Dotnet</RepositoryUrl>
-    <Version>2.4.0</Version>
+    <Version>2.5.0</Version>
   </PropertyGroup>
 </Project>

README.md

@@ -13,6 +13,7 @@ A lightweight, high-performance database client library for .NET designed for lo
 | `CosmoSQLClient.Sqlite` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.Sqlite.svg)](https://www.nuget.org/packages/CosmoSQLClient.Sqlite/) |
 | `CosmoSQLClient.CosmoKv` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.CosmoKv.svg)](https://www.nuget.org/packages/CosmoSQLClient.CosmoKv/) |
 | `CosmoSQLClient.CosmoKvHttp` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.CosmoKvHttp.svg)](https://www.nuget.org/packages/CosmoSQLClient.CosmoKvHttp/) |
+| `CosmoSQLClient.CosmoKv.Cli` *(dotnet tool: `cosmokv`)* | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.CosmoKv.Cli.svg)](https://www.nuget.org/packages/CosmoSQLClient.CosmoKv.Cli/) |
 | `CosmoSQLClient.MsSql.EntityFrameworkCore` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.MsSql.EntityFrameworkCore.svg)](https://www.nuget.org/packages/CosmoSQLClient.MsSql.EntityFrameworkCore/) |
 | `CosmoSQLClient.Postgres.EntityFrameworkCore` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.Postgres.EntityFrameworkCore.svg)](https://www.nuget.org/packages/CosmoSQLClient.Postgres.EntityFrameworkCore/) |
 | `CosmoSQLClient.MySql.EntityFrameworkCore` | [![NuGet](https://img.shields.io/nuget/v/CosmoSQLClient.MySql.EntityFrameworkCore.svg)](https://www.nuget.org/packages/CosmoSQLClient.MySql.EntityFrameworkCore/) |
@@ -171,6 +172,25 @@ services.AddDbContext<AppDbContext>(options =>
     options.UseCosmoSqlite("Data Source=sales.db"));
 ```
 
+## CLI: `cosmokv`
+
+A `sqlite3`-style shell for CosmoKv embedded databases — REPL, one-shot SQL, stdin scripts, and four output formats. Ships as a dotnet global tool.
+
+```bash
+dotnet tool install -g CosmoSQLClient.CosmoKv.Cli
+```
+
+```bash
+cosmokv ./mydb                                       # REPL
+cosmokv ./mydb "SELECT * FROM Users"                 # one-shot
+cat schema.sql | cosmokv ./mydb -                    # stdin script
+cosmokv --format=json ./mydb "SELECT * FROM Users"   # JSON output
+```
+
+REPL dot-commands cover the usual introspection surface (`.tables`, `.schema [TABLE]`, `.indexes [TABLE]`, `.dump`, `.format FMT`, `.quit`). Full reference: [`src/CosmoSQLClient.CosmoKv.Cli/README.md`](src/CosmoSQLClient.CosmoKv.Cli/README.md).
+
+The introspection used by `.schema` / `.dump` is also available programmatically from v2.5 — `CosmoKvConnection.GetTableNames()`, `GetTableScript(name)`, `GetIndexScriptsForTable(name)`, `ScriptSchema()` — so you can build your own dump/backup tooling without going through the CLI.
+
 ## Technical Architecture
 
 ### Zero-Allocation Pipeline