@north-light/crouter 0.3.306 → 0.3.308

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -103,7 +103,8 @@ export interface ManifestTimeouts {
103
103
  streamIdleMs?: number;
104
104
  }
105
105
  /** Exec transport only: forward every argv token after this branch to an
106
- * external binary instead of parsing children. A passthrough branch is
106
+ * external binary instead of parsing children. `bin` is either a bare PATH
107
+ * command or a plugin-root-relative executable path. A passthrough branch is
107
108
  * childless by construction; an HTTP manifest rejects it, because an HTTP
108
109
  * transport must not name a local binary to execute. */
109
110
  export interface ManifestPassthrough {
@@ -266,7 +266,7 @@ An HTTP-transport plugin replaces that declaration with:
266
266
  "transport": { "kind": "http", "endpoint": "https://example.com", "authEnv": "DEPLOY_TOKEN" }
267
267
  ```
268
268
 
269
- For `exec`, `executable` is required when the manifest has any executable leaf; a passthrough-only manifest omits it. When declared, it is plugin-root-relative, resolves inside the plugin root to a regular file, and carries the POSIX exec bit. For `http`, `transport.endpoint` is the backend origin and `authEnv` is optional. crouter stores only the environment variable **name**, never its credential; it reads the credential when invoking a leaf. A crouter-materialized archive plugin additionally records its archive URL separately in `bundle` for installation and update.
269
+ For `exec`, `executable` is required when the manifest has any executable leaf; a passthrough-only manifest omits it. When declared, it is plugin-root-relative, resolves inside the plugin root to a regular file, and carries the POSIX exec bit. A passthrough `bin` is either a bare command resolved through `PATH` or a plugin-root-relative executable path subject to the same containment and permission checks. For `http`, `transport.endpoint` is the backend origin and `authEnv` is optional. crouter stores only the environment variable **name**, never its credential; it reads the credential when invoking a leaf. A crouter-materialized archive plugin additionally records its archive URL separately in `bundle` for installation and update.
270
270
 
271
271
  Only an installed, **enabled** plugin's command manifest contributes. Discovery is per-invocation and reads the installed `commands.json` only: enable, disable, update, and remove take effect on the next `crtr` call with no daemon restart, cache clearing, or network fetch.
272
272