@plurnk/plurnk-execs-common 1.14.2 → 1.16.0

package/README.md

@@ -25,21 +25,21 @@ 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 { … }`) |
 
-### A script or working directory — the `(target)` slot
+### A script — the `(target)` slot
 
 The table above is the **inline** form: the body is the program. A file in the
 `(target)` slot is instead the script each interpreter reads directly, and the
-body becomes that script's stdin. A directory target becomes the working
-directory and the body remains the inline program
+body becomes that script's stdin. A `{cwd=<directory>}` block on the heading
+selects the working directory; the body remains the program
 ({§executor-subprocess-routing}).
 
-```plurnk
-## EXEC0 [sh] (./deploy.sh)
+```example
+### EXEC0 (./deploy.sh)
 yes
 yes
 no
 
-## EXEC0 [python3] (transform.py)
+### EXEC0 [python3] (transform.py)
 3
 1
 4

package/docs/node.md

@@ -17,8 +17,9 @@ on stderr.
 ## Working directory
 
 Runs in the workspace project root by default, or the daemon's own cwd in a
-workspace without one. The target is a cwd or a script, never a command: a
-directory target sets the working directory; a script target runs that
-JavaScript file and receives the body as stdin; anything else is refused before
-anything runs. Relative module and filesystem paths resolve against the selected
-working directory. The receipt always names it.
+workspace without one; a `{cwd=<directory>}` block on the heading selects
+another. The target is a script, never a command or a directory:
+`### EXEC0 [node] (tool.js)` runs that JavaScript file and receives the body as
+stdin; anything else is refused before anything runs. Relative module and
+filesystem paths resolve against the working directory. The receipt always
+names it.

package/docs/sh.md

@@ -11,24 +11,24 @@ read plurnk's credentials. The project's environment passes through.
 
 ## Working directory
 
-With no target, the working directory is the workspace project root — where
-file operations write — or, in a workspace without one, the directory the
-shell would run in anyway. Any directory target overrides it for its body:
+The working directory is the workspace project root — where file operations
+write — or, in a workspace without one, the directory the shell would run in
+anyway. A `{cwd=<directory>}` block on the heading overrides it for its body:
 
-```plurnk
-## EXEC0 (./dir)
+```example
+### EXEC0 {cwd=./dir}
 pwd
 ```
 
 The receipt always names the directory the command ran in.
 
-A script target runs that script: `## EXEC0 (greet.sh)` runs it with an empty
+A script target runs that script: `### EXEC0 (greet.sh)` runs it with an empty
 stdin; a nonempty body becomes its stdin. The interpreter reads the script
 directly, so it needs no executable bit; a script path authored inside a shell
 body still follows the kernel's ordinary executable-bit rules.
 
-The target is a cwd or a script — never a command. A target that is neither is
-refused before anything runs, and the refusal names the directory it searched.
+The target is a program — a script — never a command and never a directory. A
+target that is not a script is refused before anything runs.
 
 ## Channels
 
@@ -44,23 +44,25 @@ because either may carry the useful diagnostic.
 
 For a long-running command, the `<L>` slot carries `<TIMEOUT_SECONDS, POLL_SECONDS>` (both seconds):
 
-```plurnk
-## EXEC0 <1800>
+```example
+### EXEC0 <1800>
 npm run build
 
-## EXEC0 <1800,300>
+### EXEC0 <1800,300>
 npm run e2e
 
-## EXEC0 <-1,300>
+### EXEC0 <-1,300>
 npm run test
 
-## EXEC0 <-1,0>
+### EXEC0 <-1,0>
 tail -f app.log
 ```
 
 The first coordinate is the timeout: a positive value kills at that deadline;
-`-1` declines the per-operation deadline; `0` keeps the process only through
-the current turn. Loop teardown still reaps surviving work. The optional
+`-1` declines the deadline and the process outlives the loop — it runs until it
+exits or you KILL it, so a server you must leave running takes `<-1>`; `0` keeps
+the process only through the current turn. Anything without `-1` is reaped when
+the loop ends. The optional
 positive second coordinate fixes the poll cadence while a loop is parked on
 the stream. With no explicit poll, the consumer uses exponential backoff so a
 parked loop can inspect partial output and decide whether to wait or KILL. A

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-execs-common",
-    "version": "1.14.2",
+    "version": "1.16.0",
     "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",
@@ -44,10 +44,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "example": {
                         "body": "git status --short"
@@ -64,10 +63,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "JavaScript code"
                 }
@@ -82,10 +80,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "Python code"
                 }
@@ -100,10 +97,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "Perl code"
                 }
@@ -118,10 +114,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "Ruby code"
                 }
@@ -136,10 +131,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "Lua code"
                 }
@@ -154,10 +148,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "TypeScript or JavaScript code"
                 }
@@ -172,10 +165,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "TypeScript or JavaScript code"
                 }
@@ -190,10 +182,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "Tcl code"
                 }
@@ -208,10 +199,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "bc expression or code"
                 }
@@ -226,10 +216,9 @@
                         "required": false
                     },
                     "target": {
-                        "role": "cwd or script; never a command",
+                        "role": "script; never a command or a directory",
                         "required": false,
-                        "kind": "resource",
-                        "directory": "cwd"
+                        "kind": "script"
                     },
                     "signature": "AWK code"
                 }
@@ -261,6 +250,6 @@
         "prepublishOnly": "npm audit --audit-level=moderate && npm test"
     },
     "peerDependencies": {
-        "@plurnk/plurnk-execs": "^1.14.2"
+        "@plurnk/plurnk-execs": "^1.16.0"
     }
 }