@rogatio/cli 1.9.1 → 2.0.0

package/README.md

@@ -39,8 +39,8 @@ rogatio <command> [options]
 | `rogatio edit [path]` | Launch the browser editor for `.rogatio.json`. |
 | `rogatio verify [path]` | Validate a `.rogatio.json` file (schema + compiler). |
 | `rogatio test [path] [url...]` | Run offline dry-run tests against `.rogatio.json`. |
-| `rogatio runtime <start\|stop\|status\|install\|trust\|untrust\|uninstall>` | Control the native messaging runtime and request-body trust. |
-| `rogatio runtime-host <path>` | Start the consolidated native-messaging host for the project (mock/pair/authorize over stdio). |
+| `rogatio runtime <activate\|deactivate\|status\|install\|trust\|untrust\|uninstall>` | Control the native messaging runtime and request-body trust. |
+| `rogatio runtime host <path>` | Run the consolidated native-messaging host for the project (mock/pair/authorize over stdio). Normally launched by the browser; run manually only for debugging. |
 
 Global options: `--help, -h` and `--version, -v`. Run `rogatio <command> --help`
 for command-specific usage.
@@ -57,8 +57,8 @@ rogatio verify .rogatio.json
 # Dry-run rules against a set of URLs
 rogatio test .rogatio.json https://example.com/ https://example.com/app.js
 
-# Start the native-messaging host for the project (launched by the extension)
-rogatio runtime-host .rogatio.json
+# Run the native-messaging host for the project (normally launched by the browser)
+rogatio runtime host .rogatio.json
 ```
 
 ## Exit codes

package/dist/node/index.js

@@ -5971,8 +5971,8 @@ function showRuntimeHelp() {
 Native messaging runtime control for response-body and request-body rules.
 
 Native runtime commands:
-  start     Start the runtime (explicit, no auto-start)
-  stop      Stop the runtime (idempotent)
+  activate  Activate the runtime (explicit, no auto-activation)
+  deactivate Deactivate the runtime (idempotent)
   status    Show the current runtime and trust state
 
 Request-body trust commands:
@@ -5983,10 +5983,10 @@ Request-body trust commands:
   uninstall Uninstall the native-messaging host manifest (idempotent)
 
 Native host command:
-  runtime-host [path]  Run the consolidated native-messaging runtime host,
-                       reading pairing/authorization/mock envelopes from stdin
-                       and writing responses to stdout. This process is what the
-                       browser launches via the native-messaging manifest.
+  host [path]  Run the consolidated native-messaging runtime host, reading
+               pairing/authorization/mock envelopes from stdin and writing
+               responses to stdout. This process is what the browser launches
+               via the native-messaging manifest.
 
 Options:
   --extension-id    Extension ID for native messaging manifest (required for install)
@@ -6046,16 +6046,16 @@ async function nativeRuntimeCommand(args) {
     preset: await loadControlPreset()
   });
   switch (subcommand) {
-    case "start": {
+    case "activate": {
       const result = await controller.start();
       if (result.state === "running") {
-        console.log("runtime started");
+        console.log("runtime activated");
         return 0;
       }
-      console.error(`runtime start failed: ${result.state}`);
+      console.error(`runtime activate failed: ${result.state}`);
       return 1;
     }
-    case "stop": {
+    case "deactivate": {
       const result = await controller.stop();
       console.log(`runtime ${result.state}`);
       return 0;
@@ -6276,10 +6276,11 @@ async function runtimeCommand(args, _options = {}) {
   if (first === "install" || first === "trust" || first === "untrust" || first === "uninstall")
     return trustRuntimeCommand(args);
   if (first === "status") return runtimeStatusCommand(args);
-  if (first === "start" || first === "stop") return nativeRuntimeCommand(args);
-  if (first === "runtime-host") return runtimeHostCommand(args.slice(1));
+  if (first === "activate" || first === "deactivate")
+    return nativeRuntimeCommand(args);
+  if (first === "host") return runtimeHostCommand(args.slice(1));
   console.error(
-    `Error: 'rogatio runtime' no longer starts an HTTP mock server. Use 'rogatio runtime-host [path]' to run the native-messaging host, or one of: start, stop, status, install, trust, untrust, uninstall.`
+    `Error: 'rogatio runtime' no longer starts an HTTP mock server. Use 'rogatio runtime host [path]' to run the native-messaging host, or one of: activate, deactivate, status, install, trust, untrust, uninstall.`
   );
   showRuntimeHelp();
   return 2;
@@ -6807,8 +6808,8 @@ Commands:
   edit [path]     Launch browser editor for .rogatio.json
   test [path] [url...]  Run offline dry-run tests against .rogatio.json
   verify [path]   Validate .rogatio.json file
-  runtime <start|stop|status|install|trust|untrust|uninstall>  Native messaging runtime and request-body trust control
-  runtime-host [path]  Run the consolidated native-messaging runtime host
+  runtime <activate|deactivate|status|install|trust|untrust|uninstall>  Native messaging runtime activation and request-body trust control
+  runtime host [path]  Run the consolidated native-messaging runtime host
 
 Global Options:
   --help, -h      Show help
@@ -6852,16 +6853,17 @@ Exit codes:
 }
 function showRuntimeHelp2() {
   console.log(`Usage: rogatio runtime <command> [options]
-       rogatio runtime-host [path]
+       rogatio runtime host [path]
 
 Native messaging runtime control for response-body and request-body rules. The
 runtime no longer serves an HTTP mock server; mock delivery happens in the
 consolidated native-messaging host (spec REQ-001..REQ-005).
 
 Native runtime commands:
-  start     Start the runtime (explicit, no auto-start)
-  stop      Stop the runtime (idempotent)
-  status    Show the current runtime and trust state
+  activate   Activate the runtime (explicit, no auto-activation)
+  deactivate Deactivate the runtime (idempotent)
+  host [path]  Run the consolidated native-messaging runtime host
+  status     Show the current runtime and trust state
 
 Request-body trust commands:
   install   Install the native-messaging host manifest (requires --extension-id)
@@ -6870,17 +6872,17 @@ Request-body trust commands:
   uninstall Uninstall the native-messaging host manifest (idempotent)
 
 Native host command:
-  runtime-host [path]  Run the consolidated native-messaging runtime host. The
-                      browser launches this process via the native-messaging
-                      manifest; it reads pairing/authorization/mock envelopes from
-                      stdin and writes responses to stdout.
+  host [path]  Run the consolidated native-messaging runtime host. The browser
+               launches this process via the native-messaging manifest; it reads
+               pairing/authorization/mock envelopes from stdin and writes
+               responses to stdout.
 
 Options:
   --root <dir>    Root for confined file mocks (default: project directory)
   --extension-id  Extension ID for native messaging manifest (required for install)
   --help, -h      Show this help
 
-The native runtime activates unconditionally once started; the device-local CA /
+The native runtime activates unconditionally once activated; the device-local CA /
 PAC routing capability only affects request-body interception, not the host
 control plane.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rogatio/cli",
-  "version": "1.9.1",
+  "version": "2.0.0",
   "private": false,
   "type": "module",
   "description": "Local-first browser request and response rules — editor host, file verification, test runner, and runtime dispatch.",