@simplepush/cli 0.2.1 → 0.4.0

package/README.md

@@ -22,6 +22,7 @@ sp cancel    Withdraw a pending task, subtask, or task group you sent.
 sp notify    Send a fire-and-forget notification.
 sp collect   Collect replies, inputs, or submissions as bounded NDJSON.
 sp download  Download one file a collect line referenced, by its ids.
+sp get       Read what came back: task listings, one task with its subtasks, a task group, submissions.
 sp events    Stream or replay the raw event feed.
 sp auth      Log in to an organization (login / logout / status).
 sp org       Administer an organization: members, invites, topics, API key, encryption.
@@ -85,7 +86,7 @@ sp cancel grptsk_0198… --reason answered --note "already handled"
 sp cancel sub_0198… --reason superseded --superseded-by sub_0199…
 ```
 
-Already-answered members are skipped, never failed; re-canceling is a no-op. With an API token it cancels a personal send, without one it uses the org session. `--note` is sealed under the org master key automatically on org cancels; on personal cancels pass `-p "pw@topic"` (topic send) or a bare `-p "pw"` (send to your own devices) to seal it.
+Already-answered members are skipped, never failed; re-canceling is a no-op. With an API token it cancels a personal send, without one it uses the org session. `--note` is sealed under the target's own key whenever the CLI holds it: the org vault on org cancels, or the matching `-p "pw@topic"` (topic send) / bare `-p "pw"` (send to your own devices) on personal ones; otherwise it ships plaintext with a warning.
 
 ### Download the files people upload
 
@@ -161,7 +162,7 @@ Collect its answers like any send: pipe the `sent` line, or collect after the fa
 sp subtask --append-token "$TOKEN" --format json \
   --text-input "ETA?" | sp collect --inputs
 
-sp collect --instance tsk_0198…/sub_0198… --since 24h
+sp collect --instance sub_0198… --since 24h
 ```
 
 ### Watch your account live, or replay history
@@ -192,3 +193,19 @@ Bun can compile the CLI into a single-file native binary:
 bun run build:binary
 ./bin/simplepush --help
 ```
+
+### Query what came back
+
+The read commands mirror the MCP query tools, so an agent can ask questions like "every task that expired unanswered this week, grouped by assignee":
+
+```bash
+sp get tasks --status expired --since 7d --format json  # one JSON object per line
+sp get tasks --status pending --member anna --all       # follow cursors to the end
+sp get tsk_…                                            # the chain: root + subtasks, decrypted where keys are held
+sp get sub_…                                            # one subtask on its own
+sp get grptsk_…                                         # per-recipient status of a group send
+sp get submissions --since 24h --member anna
+sp events --since 7d --member anna                      # events replay, narrowed client-side
+```
+
+A page that was cut off ends with `{"type":"more","cursor":"…"}` (`json`) or an info line (`pretty`); pass the cursor back with `--cursor`, or `--all` to page automatically. `--since`/`--until` take ISO-8601 instants or relative windows (`7d`, `12h`). For personal accounts the HTTP query surface (`sp get`) is a subscription feature — `sp events`, `sp collect` and `sp download` stay free.