current status

Author: MPCoreDeveloper

.github/copilot-instructions.md

@@ -3,7 +3,7 @@
 ## General Guidelines
 - Test programs should be located in the `tests` folder and not in the repository root.
 - All project documentation must be written in English. This includes docs, README files, technical specs, implementation plans, and code comments.
-- Provide periodic progress updates while work is ongoing to ensure the assistant is not stuck.
+- Provide periodic progress updates while work is ongoing and do not remain stuck on the same point for long stretches.
 - When benchmarking competitor databases (like BLite), document the developer experience (DX) honestly. If a library's API is hard to use, poorly documented, or has mismatches between docs and actual API, note that as a real finding in the benchmark report. User-friendliness and ease of integration matter as much as raw performance numbers.
 - Standardize all documentation/version labels to v1.7.0 ("V 1.70").
 - Continue implementation until the scoped roadmap work is finished without pausing for confirmation.

Examples/CQRS/OrderManagement.CqrsDemo/OrderCqrsDemo.cs

@@ -5,7 +5,7 @@
 
 namespace OrderManagement.CqrsDemo;
 
-using SharpCoreDB.CQRS;
+using SharpDispatch;
 
 /// <summary>
 /// Command for creating an order on the write side.

Examples/CQRS/OrderManagement.CqrsDemo/OrderManagement.CqrsDemo.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -20,6 +20,10 @@
     <PackageReference Include="SharpCoreDB.CQRS" Version="1.7.0" />
   </ItemGroup>
 
+  <ItemGroup>
+    <PackageReference Include="SharpDispatch" Version="1.0.1" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Update="Microsoft.SourceLink.GitHub" Version="10.0.202" />
   </ItemGroup>

Examples/CQRS/OrderManagement.CqrsDemo/Program.cs

@@ -4,7 +4,7 @@
 // </copyright>
 
 using OrderManagement.CqrsDemo;
-using SharpCoreDB.CQRS;
+using SharpDispatch;
 
 Console.WriteLine("========================================");
 Console.WriteLine(" SharpCoreDB Explicit CQRS Demo");

Examples/Web/Orchardcore/SharpCoreDb.Orchardcore/SharpCoreDb.Orchardcore.csproj

@@ -22,7 +22,7 @@
   <ItemGroup>
     <PackageReference Include="HtmlSanitizer" Version="9.0.892" />
     <PackageReference Include="MimeKit" Version="4.15.1" />
-    <PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="10.4.0" />
+    <PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="10.5.0" />
     <PackageReference Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="10.0.6" />
     <PackageReference Include="AWSSDK.Core" Version="4.0.3.29" />
   </ItemGroup>

docs/analytics/README.md

@@ -296,6 +296,27 @@ var running = await database.QueryAsync(
 );
 ```
 
+### FILTER on Window Functions
+✅ **Supported since v1.7.0** — FILTER clause applies to window functions, filtering the window frame before calculation.
+
+```csharp
+// Row numbers only for active employees
+var activeRanking = await database.QueryAsync(
+    @"SELECT name, department,
+             ROW_NUMBER() FILTER (WHERE active = 1) OVER (PARTITION BY department ORDER BY salary DESC) AS active_rank
+       FROM employees
+       ORDER BY department, active_rank"
+);
+
+// Department averages excluding inactive employees
+var deptAvgs = await database.QueryAsync(
+    @"SELECT name, department, salary,
+             AVG(salary) FILTER (WHERE active = 1) OVER (PARTITION BY department) AS active_dept_avg
+       FROM employees
+       ORDER BY department, salary"
+);
+```
+
 ---
 
 ## Group By and Having
@@ -316,20 +337,73 @@ var byRegion = await database.QueryAsync(
 );
 ```
 
+### FILTER (WHERE ...)
+Applies a predicate to a single aggregate expression, matching the SQLite/PostgreSQL aggregate `FILTER` style for the currently supported aggregate executor path.
+
+```csharp
+// Count only paid sales while still returning grouped totals
+var filtered = await database.QueryAsync(
+    @"SELECT
+        category,
+        COUNT(*) AS total_count,
+        COUNT(*) FILTER (WHERE status = 'paid') AS paid_count,
+        SUM(amount) FILTER (WHERE status = 'paid') AS paid_total
+      FROM sales
+      GROUP BY category
+      ORDER BY category"
+);
+```
+
+Current support and known gaps are tracked in `docs/compatibility/SQLITE_POSTGRESQL_AGGREGATE_SYNTAX_v1.7.0.md`.
+
 ### HAVING
 Filters grouped results (WHERE applies before GROUP BY, HAVING after).
 
+✅ **Supported since v1.7.0** — HAVING predicates can reference aggregate aliases defined in SELECT.
+
 ```csharp
-// Find departments with >5 employees
-var largeDepts = await database.QueryAsync(
+// Find categories with total revenue > 100
+var highRevenue = await database.QueryAsync(
     @"SELECT 
-        department,
-        COUNT(*) AS emp_count,
-        AVG(salary) AS avg_salary
-      FROM employees
-      GROUP BY department
-      HAVING COUNT(*) > 5
-      ORDER BY emp_count DESC"
+        category,
+        SUM(amount) AS total
+      FROM orders
+      GROUP BY category
+      HAVING total > 100
+      ORDER BY total DESC"
+);
+
+// Filter groups by count
+var popularItems = await database.QueryAsync(
+    @"SELECT category, COUNT(*) AS cnt
+      FROM items
+      GROUP BY category
+      HAVING cnt >= 2"
+);
+```
+
+### Arithmetic expressions inside aggregates
+✅ **Supported since v1.7.0** — aggregate arguments accept arithmetic expressions such as `price * qty`, `a + b`, `a - b / c`.
+
+```csharp
+// Total revenue: SUM(price * quantity)
+var revenue = await database.QueryAsync(
+    @"SELECT SUM(price * qty) AS revenue FROM sales"
+);
+```
+
+### FILTER with JOIN queries
+✅ **Supported since v1.7.0** — FILTER clause works on both single-table and JOIN-backed aggregate queries.
+
+```csharp
+// Active payroll per department (JOIN + FILTER + GROUP BY)
+var payroll = await database.QueryAsync(
+    @"SELECT departments.name,
+             SUM(employees.salary) FILTER (WHERE employees.active = 1) AS active_payroll
+      FROM departments
+      JOIN employees ON departments.id = employees.dept_id
+      GROUP BY departments.name
+      ORDER BY departments.name"
 );
 ```