@quantod/qq 1.3.0 → 1.3.1

package/dist/resources/guide.md

@@ -204,7 +204,7 @@ Reads items without claiming them. For inspection, data collection, and monitori
 Parameters:
 - `pipeline` (string)
 - `stage` (string, optional) — supports globs. Defaults to `*`
-- `payload_fields` (`"*"` | string[], optional) — which payload fields to return. `"*"` returns the full payload; an array of dot-notation paths (e.g. `["status", "meta.author"]`) returns only those fields; omit to return no payload. **Note: this controls payload projection, not item filtering.**
+- `payload_fields` (`"*"` | string[], optional) — which payload fields to return. `"*"` returns the full payload; an array of dot-notation paths (e.g. `["status", "meta.author"]`) returns only those fields; omit to return no payload. **Note: this controls payload projection, not item filtering. Prefer '*' if you don't know exactly which fields can be in the payload.**
 - `payload_filter` (object, optional) — MongoDB-style filter on payload fields. Keys are dot-notation paths into the payload. Values are either a literal (equality match) or an operator object. Supported operators: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in` (array), `$exists` (boolean). Example: `{ "status": "active", "score": { "$gt": 80 } }`.
 - `claimed` (boolean, optional) — filter by claimed status
 - `ids` (string[], optional)
@@ -508,7 +508,7 @@ while True:
     item = qq_claim(pipeline, "pending")
     if "error" in item:  # "no items to claim" or other error
         break
-    result = process_item(item["payload"])   # payload is a dict
+    result = process_item(item["payload"])  # payload is a dict
     qq_release(pipeline, item["seq"], target="done", payload={"result": result})
 
 items = qq_query(pipeline, "done", payload_fields="*")
@@ -516,9 +516,12 @@ for item in items:
     print(item["id"], item["payload"])  # payload is a dict
 
 # Filter by payload fields; select only specific fields
-high_scores = qq_query(pipeline, "done",
+high_scores = qq_query(
+    pipeline,
+    "done",
     payload_filter={"score": {"$gt": 80}, "status": "active"},
-    payload_fields=["url", "score"])
+    payload_fields=["url", "score"],
+)
 
 # Monitor
 s = qq_status(pipeline)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantod/qq",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Persistent queue for multi-stage Claude agent pipelines",
   "license": "All Rights Reserved",
   "engines": {

package/src/resources/guide.md

@@ -204,7 +204,7 @@ Reads items without claiming them. For inspection, data collection, and monitori
 Parameters:
 - `pipeline` (string)
 - `stage` (string, optional) — supports globs. Defaults to `*`
-- `payload_fields` (`"*"` | string[], optional) — which payload fields to return. `"*"` returns the full payload; an array of dot-notation paths (e.g. `["status", "meta.author"]`) returns only those fields; omit to return no payload. **Note: this controls payload projection, not item filtering.**
+- `payload_fields` (`"*"` | string[], optional) — which payload fields to return. `"*"` returns the full payload; an array of dot-notation paths (e.g. `["status", "meta.author"]`) returns only those fields; omit to return no payload. **Note: this controls payload projection, not item filtering. Prefer '*' if you don't know exactly which fields can be in the payload.**
 - `payload_filter` (object, optional) — MongoDB-style filter on payload fields. Keys are dot-notation paths into the payload. Values are either a literal (equality match) or an operator object. Supported operators: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in` (array), `$exists` (boolean). Example: `{ "status": "active", "score": { "$gt": 80 } }`.
 - `claimed` (boolean, optional) — filter by claimed status
 - `ids` (string[], optional)
@@ -508,7 +508,7 @@ while True:
     item = qq_claim(pipeline, "pending")
     if "error" in item:  # "no items to claim" or other error
         break
-    result = process_item(item["payload"])   # payload is a dict
+    result = process_item(item["payload"])  # payload is a dict
     qq_release(pipeline, item["seq"], target="done", payload={"result": result})
 
 items = qq_query(pipeline, "done", payload_fields="*")
@@ -516,9 +516,12 @@ for item in items:
     print(item["id"], item["payload"])  # payload is a dict
 
 # Filter by payload fields; select only specific fields
-high_scores = qq_query(pipeline, "done",
+high_scores = qq_query(
+    pipeline,
+    "done",
     payload_filter={"score": {"$gt": 80}, "status": "active"},
-    payload_fields=["url", "score"])
+    payload_fields=["url", "score"],
+)
 
 # Monitor
 s = qq_status(pipeline)