@plurnk/plurnk-execs-jq 1.20.0 → 1.21.1

package/.env.defaults

@@ -0,0 +1,3 @@
+# @plurnk/plurnk-execs-jq — opt-in JSON filtering.
+# Set to 1 to register jq; the interpreter must also be on PATH.
+PLURNK_EXECS_JQ=0

package/README.md

@@ -23,6 +23,7 @@ line ({§executor-output-address}).
 
 ## Effect & availability
 
+- Disabled by default. Set `PLURNK_EXECS_JQ=1` in the environment cascade to enable it.
 - **`effect`** — inline/`-n` is `pure`; a target data source is `read`. Both
   bypass the human proposal gate, then stream on the same next-turn path as
   every execution ({§executor-effect}).

package/docs/jq.md

@@ -2,17 +2,17 @@
 
 The system `jq` as a runtime: the **body is the jq program**, the **`(target)` is the data source**.
 
-````jq
+```jq
 [1,2,3] | add
-````
+```
 
-````jq (data.json)
+```jq (data.json)
 .users[].name
-````
+```
 
-````jq (sqlite:///ab3d5678#results)
+```jq (sqlite:///ab3d5678#results)
 .[] | .name
-````
+```
 
 The first form has no input and uses `-n`. The second filters a file. The third
 filters the result stream at the emitted SQLite address.
@@ -29,24 +29,24 @@ address.
 
 `jq` reads the ambient environment (`env`, `$ENV`) per its own contract — the consumer's scoped env is honored when provided.
 
+## Errors
+
+A failed program or spawn closes `results` as `errored` with status 500 and an
+RFC 9457 Problem carrying jq's own stderr.
+
 ## Live input
 
-````jq [{"stdin": "open"}]
+```jq [{"stdin": "open"}]
 .value * 2
-````
+```
 
 Use the returned stream address, here `jq:///c4e56789`. A SEND body is input
 JSON, not another jq program; this example closes stdin after sending its value:
 
-````SEND (jq:///c4e56789) [{"eof": true}]
+```SEND (jq:///c4e56789) [{"eof": true}]
 {"value":21}
-````
+```
 
 Without `[{"eof": true}]`, include an actual trailing newline to delimit each JSON
 value. Open-input output is unbuffered. READ the same address for results;
 SEND acknowledges only input delivery. KILL remains execution cancellation.
-
-## Errors
-
-A failed program or spawn closes `results` as `errored` with status 500 and an
-RFC 9457 Problem carrying jq's own stderr.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-execs-jq",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "jq runtime executor for plurnk-service's exec scheme — shells the system jq binary to filter or transform JSON.",
   "keywords": [
     "plurnk",
@@ -64,11 +64,12 @@
   "files": [
     "dist/**/*",
     "README.md",
+    ".env.defaults",
     "docs/**/*"
   ],
   "scripts": {
     "test:lint": "tsc --noEmit",
-    "test:unit": "node --conditions=plurnk-dev --env-file-if-exists=../plurnk-execs/.env.defaults --test \"src/**/*.test.ts\"",
+    "test:unit": "node --conditions=plurnk-dev --env-file-if-exists=.env.defaults --env-file-if-exists=../plurnk-execs/.env.defaults --test \"src/**/*.test.ts\"",
     "test": "npm run test:lint && npm run test:unit",
     "build:clean": "rm -rf dist",
     "build:dist": "tsc -p tsconfig.build.json",
@@ -77,6 +78,6 @@
     "prepublishOnly": "npm audit --audit-level=moderate && npm test"
   },
   "peerDependencies": {
-    "@plurnk/plurnk-execs": "^1.20.0"
+    "@plurnk/plurnk-execs": "^1.21.1"
   }
 }