From a5fdb9d6b7ae0bacac9c803ebed0e747ba91df8d Mon Sep 17 00:00:00 2001
From: MaysWind <i@mayswind.net>
Date: Mon, 2 Feb 2026 23:11:20 +0800
Subject: [PATCH] add server version command

---
 scripts/ebktools.ps1 | 23 ++++++++++++++++++++---
 scripts/ebktools.sh  | 23 ++++++++++++++++++++---
 2 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/scripts/ebktools.ps1 b/scripts/ebktools.ps1
index d7830f0d..693c11d8 100755
--- a/scripts/ebktools.ps1
+++ b/scripts/ebktools.ps1
@@ -485,6 +485,23 @@ $API_CONFIGS = @(
             "}"
         )
     }
+    @{
+        Name = "server-version"
+        Description = "Get ezBookkeeping server version information"
+        Method = "GET"
+        Path = "systems/version.json"
+        RequiresTimezone = $false
+        RequiredParams = @()
+        OptionalParams = @()
+        ParamTypes = @{}
+        ParamDescriptions = @{}
+        ResponseStructure = @(
+            "{"
+            "  `"version`": `"string (Server version)`","
+            "  `"commitHash`": `"string (Git commit hash)`""
+            "}"
+        )
+    }
 )
 
 # Reference: https://github.com/unicode-org/cldr/blob/main/common/supplemental/windowsZones.xml
@@ -837,10 +854,10 @@ function Show-Help {
     Write-Host "    ebktools.ps1 list"
     Write-Host ""
     Write-Host "    # Show help for a specific command"
-    Write-Host "    ebktools.ps1 help transactions-add"
+    Write-Host "    ebktools.ps1 help server-version"
     Write-Host ""
-    Write-Host "    # Call accounts-list API"
-    Write-Host "    ebktools.ps1 accounts-list"
+    Write-Host "    # Call server-version API"
+    Write-Host "    ebktools.ps1 server-version"
     Write-Host ""
     Write-Host "    # Call API with timezone name"
     Write-Host "    ebktools.ps1 -tzName $exampleTimezoneName transactions-list -count 10"
diff --git a/scripts/ebktools.sh b/scripts/ebktools.sh
index 61d27c9c..0b82ccf1 100755
--- a/scripts/ebktools.sh
+++ b/scripts/ebktools.sh
@@ -470,6 +470,23 @@ API_CONFIGS='[
       "  ]",
       "}"
     ]
+  },
+  {
+    "Name": "server-version",
+    "Description": "Get ezBookkeeping server version information",
+    "Method": "GET",
+    "Path": "systems/version.json",
+    "RequiresTimezone": false,
+    "RequiredParams": [],
+    "OptionalParams": [],
+    "ParamTypes": {},
+    "ParamDescriptions": {},
+    "ResponseStructure": [
+      "{",
+      "  \"version\": \"string (Server version)\",",
+      "  \"commitHash\": \"string (Git commit hash)\"",
+      "}"
+    ]
   }
 ]'
 
@@ -593,10 +610,10 @@ Examples:
     ebktools.sh list
 
     # Show help for a specific command
-    ebktools.sh help transactions-add
+    ebktools.sh help server-version
 
-    # Call accounts-list API
-    ebktools.sh accounts-list
+    # Call server-version API
+    ebktools.sh server-version
 
     # Call API with timezone name
     ebktools.sh --tz-name ${example_timezone_name} transactions-list --count 10