@homespunapps/cli 1.6.57 → 1.6.59

package/dist/commands/data.js

@@ -18,7 +18,7 @@ export async function runData(args) {
         return;
     }
     if (!appArg || !collection || !verb) {
-        fail("usage: homespun data <app> <collection> <list|get|upsert|update|delete|restore|deleted|purge|import|retention>", "invalid_args");
+        fail("usage: homespun data <app> <collection> <list|count|get|upsert|update|delete|restore|deleted|purge|import|retention>", "invalid_args");
     }
     const sub = {
         positionals: args.positionals.slice(3),
@@ -31,6 +31,8 @@ export async function runData(args) {
     switch (verb) {
         case "list":
             return runList(appArg, collection, sub);
+        case "count":
+            return runCount(appArg, collection, sub);
         case "get":
             return runGet(appArg, collection, sub);
         case "upsert":
@@ -50,7 +52,7 @@ export async function runData(args) {
         case "retention":
             return runRetention(appArg, collection, sub);
         default:
-            fail(`unknown verb '${verb}': homespun data <app> <collection> <list|get|upsert|update|delete|restore|deleted|purge|import|retention>`, "invalid_args");
+            fail(`unknown verb '${verb}': homespun data <app> <collection> <list|count|get|upsert|update|delete|restore|deleted|purge|import|retention>`, "invalid_args");
     }
 }
 function parseIntFlag(args, name, defaultValue, bounds = {}) {
@@ -91,6 +93,25 @@ async function runList(appArg, collection, args) {
         failFromError(e);
     }
 }
+// `homespun data <app> <coll> count`: live row count (spec B4, issue #1056),
+// the same aggregate the browser `/_hs/count/:name` door and the MCP
+// `count_rows` tool call through. Gated by the collection's `countRead`
+// opt-in, INDEPENDENT of `read`: a collection that opted in returns its count
+// even to a caller who cannot `list` the rows, and a collection that never
+// declared `countRead` refuses with collection_count_forbidden even for a
+// caller who could otherwise list. No `--where`/`--sort`/`--since`/`--limit`:
+// count is a whole-scope total, there is nothing here to filter or page.
+async function runCount(appArg, collection, args) {
+    assertKnownFlags(args, ...specFor("data", "count"));
+    const client = makeClient(args);
+    const appId = await resolveAppId(client, appArg);
+    try {
+        printJson(await client.countAppRows(appId, collection));
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
 // Parse a `--<name> <json>` flag whose value must be a JSON array. Returns
 // undefined when the flag is absent; fails cleanly (invalid_args) when present
 // but not a JSON array. Element-level validation is left to the relay, which

package/dist/help-catalog.js

@@ -174,6 +174,10 @@ const DATA = {
                 },
             ],
         },
+        {
+            verb: "count",
+            summary: "Shows the collection's live row count. Independent of read: works when the manifest opted the collection into countRead even for a caller who cannot list.",
+        },
         {
             verb: "get",
             positionals: "<key>",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/cli",
-  "version": "1.6.57",
+  "version": "1.6.59",
   "description": "Command-line client for the Homespun relay: deploy a real multi-user web app from your agent, then keep reading and writing its data.",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@homespunapps/core": "^1.6.57",
+    "@homespunapps/core": "^1.6.59",
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {