bkper 5.6.0 → 5.6.1

package/lib/docs/cli/data-management.md

@@ -264,9 +264,6 @@ bkper transaction list -b abc123 -q 'on:2025' --limit 100
 # Fetch the next transaction page
 bkper transaction list -b abc123 -q 'on:2025' --limit 100 --cursor cursor_123
 
-# Count transactions without listing them
-bkper transaction count -b abc123 -q "account:'Capital' on:2025"
-
 # Update a transaction
 bkper transaction update tx_456 -b abc123 --amount 120.00 --description "Printer paper (corrected)"
 
@@ -289,6 +286,19 @@ bkper transaction untrash tx_456 -b abc123
 bkper transaction merge tx_123 tx_456 -b abc123
 ```
 
+### Counting transactions
+
+To answer how many transactions match, use `transaction count` (one call per account, group, or period), never `transaction list`. Queries include drafts: add `is:posted` for posted only. Trashed transactions are excluded unless `is:trashed`.
+
+```bash
+bkper transaction count -b abc123 -q "account:'Capital' on:2025 is:posted"  # {"count":N}
+bkper transaction count -b abc123 -q "group:'Equity' on:2025 is:posted"
+
+# Accounts directly in a group, to count per account
+GROUP_ID=$(bkper group get 'Equity' -b abc123 | jq -r '.id')
+bkper account list -b abc123 | jq -r --arg g "$GROUP_ID" '.items[] | select(any(.groups[]?; .id == $g)) | .name'
+```
+
 <details>
 <summary>Command reference</summary>
 
@@ -296,7 +306,7 @@ bkper transaction merge tx_123 tx_456 -b abc123
 -   `transaction list -b <bookId> -q <query>` - List transactions matching a query (auto-paginates through all results unless `--limit` or `--cursor` is provided)
     -   `--limit <number>` - Fetch one page with up to this many transactions
     -   `--cursor <cursor>` - Cursor for fetching the next page
--   `transaction count -b <bookId> [-q <query>]` - Count transactions matching a query, returning `{"count":N}`; counts all transactions when `-q` is omitted. Use this instead of `transaction list` whenever only the number of transactions is needed — one call per account/group/period is fast, while listing fetches every transaction
+-   `transaction count -b <bookId> [-q <query>]` - Count transactions matching a query, returning `{"count":N}`; counts all transactions when `-q` is omitted
 -   `transaction create -b <bookId>` - Create a transaction
     -   `--date <date>` - Transaction date
     -   `--amount <amount>` - Transaction amount

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "5.6.0",
+    "version": "5.6.1",
     "description": "Official Bkper CLI for accounting data, automation, apps, and AI agents",
     "bin": {
         "bkper": "lib/cli.js"