@plurnk/plurnk-execs-common 1.21.0 → 1.21.1

package/.env.defaults

@@ -0,0 +1,11 @@
+# @plurnk/plurnk-execs-common — secondary interpreters are opt-in.
+# Set a runtime to 1 to register it; its interpreter must also be on PATH.
+# sh, node, and python3 remain enabled through the executor framework's default.
+PLURNK_EXECS_PERL=0
+PLURNK_EXECS_RUBY=0
+PLURNK_EXECS_LUA=0
+PLURNK_EXECS_DENO=0
+PLURNK_EXECS_BUN=0
+PLURNK_EXECS_TCL=0
+PLURNK_EXECS_BC=0
+PLURNK_EXECS_AWK=0

package/.env.example

@@ -1,15 +1,13 @@
 # @plurnk/plurnk-execs-common — environment
 
-# Operator kill-switch per runtime tag. Set to 0 (or false) to disable a tag
-# even when its interpreter is installed on the host. Absent = enabled (the tag
-# is offered when its binary is on PATH). Disabling drops it from the model's
-# available-runtimes list with a "disabled" reason on the 501.
-#
-# PLURNK_EXECS_PERL=0
-# PLURNK_EXECS_RUBY=0
-# PLURNK_EXECS_LUA=0
-# PLURNK_EXECS_DENO=0
-# PLURNK_EXECS_BUN=0
-# PLURNK_EXECS_TCL=0
-# PLURNK_EXECS_BC=0
-# PLURNK_EXECS_AWK=0
+# sh, node, and python3 are enabled when their interpreter is available.
+# Uncomment any optional runtime to enable it at the next service start.
+# An enabled runtime still requires its interpreter on PATH.
+# PLURNK_EXECS_PERL=1
+# PLURNK_EXECS_RUBY=1
+# PLURNK_EXECS_LUA=1
+# PLURNK_EXECS_DENO=1
+# PLURNK_EXECS_BUN=1
+# PLURNK_EXECS_TCL=1
+# PLURNK_EXECS_BC=1
+# PLURNK_EXECS_AWK=1

package/README.md

@@ -2,8 +2,8 @@
 
 The **universal subprocess executor** for
 [plurnk-service](https://github.com/plurnk/plurnk-service)'s `exec` scheme. One
-package covers the shell, Node.js, Python 3, and whichever supported host
-interpreters are present. Node is guaranteed; the rest are detected.
+package offers the shell, Node.js, and Python 3 by default, with other supported
+host interpreters available as opt-ins. Node is guaranteed; the rest are detected.
 
 A `@plurnk/plurnk-execs-*` sibling built on the [plurnk-execs](https://github.com/plurnk/plurnk-service/tree/main/plurnk-execs) framework.
 
@@ -25,7 +25,7 @@ detects every other interpreter, so one executor adapts to the host.
 | `bc` 🧮                          | bc                | stdin (for example, `6 * 7`)             |
 | `awk` 🪄                         | awk               | program arg, empty stdin (`BEGIN { … }`) |
 
-Each runtime's catalog Summary includes a short executable inline body, with
+Each enabled runtime's catalog Summary includes a short executable inline body, with
 literal `\n` separators keeping the invocation on one discovery line.
 
 ### A script — the `(target)` slot
@@ -62,6 +62,13 @@ separate input channel; script targets receive stdin from the body.
 
 ## Configuration
 
+The shipped [`.env.defaults`](./.env.defaults) disables `perl`, `ruby`, `lua`,
+`deno`, `bun`, `tcl`, `bc`, and `awk`. To expose one, set its switch to `1`
+in the ordinary environment cascade and restart the service; commented opt-ins
+are in [`.env.example`](./.env.example). For example, `PLURNK_EXECS_PERL=1`
+enables the Perl executor when Perl is installed. These switches do not prevent
+calling an interpreter through `sh`.
+
 Per-tag kill-switches (`PLURNK_EXECS_<TAG>=0`) and the
 `PLURNK_EXECS_ONLY` allowlist are honored by framework discovery, uniformly
 across every plugin ({§executor-policy}). A disabled tag is not registered and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-execs-common",
-  "version": "1.21.0",
+  "version": "1.21.1",
   "description": "Universal subprocess executor for plurnk-service's exec scheme — one package exposing the shell, Node.js, Python 3, and supported host interpreters.",
   "keywords": [
     "plurnk",
@@ -255,12 +255,13 @@
   "files": [
     "dist/**/*",
     "README.md",
+    ".env.defaults",
     ".env.example",
     "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",
@@ -269,6 +270,6 @@
     "prepublishOnly": "npm audit --audit-level=moderate && npm test"
   },
   "peerDependencies": {
-    "@plurnk/plurnk-execs": "^1.21.0"
+    "@plurnk/plurnk-execs": "^1.21.1"
   }
 }