@revoengine/cli 1.0.24 → 1.0.26

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.
package/README.md CHANGED
@@ -94,7 +94,7 @@ revo terminal disconnect --workspace "$HOME/projects/my-project" --name "Work Ma
94
94
 
95
95
  Stop the foreground runner before installing its service. The service starts at login, reconnects automatically, and pins the selected terminal UUID and project profile at installation. Multiple terminals can share one machine and workspace when they have distinct names; pass the same `--name` to `connect`, `service install|uninstall`, and `disconnect`. Without `--name`, the CLI uses the machine hostname. If two registrations have the same name, the CLI refuses an ambiguous choice; use `revo terminal status` to find the UUID and pass `--terminal-id <uuid>`. A legacy workspace service must be uninstalled before installing a terminal-specific service. Uninstall stops the selected service but keeps its grant and local registration. `disconnect` stops/removes the selected terminal-specific service, revokes its grant and removes its local credential. Uninstall a legacy workspace service first so it cannot affect a different terminal. On macOS, service logs are in `~/Library/Logs/RevoEngine/`. On Linux, inspect them with `journalctl --user -u <unit-name>`; `install` prints the unit name. Linux user services normally stop after logout unless an administrator enables user lingering.
96
96
 
97
- The runner retries temporary API startup failures and WebSocket outages without a retry-count limit, using exponential backoff capped at 30 seconds with jitter. Startup reads have a 30-second request deadline; pairing and other writes are not automatically repeated. Ctrl+C or SIGTERM interrupts both a pending API request and a reconnect wait. Realtime restarts and Cloud Run connection timeouts renew transport without revoking the device. A newly supported ACL-change renewal immediately stops work under the old connection and reconnects against the current approved grant; it never extends the old command permission. Older runners stop on that change and need restarting. Actual grant/account/API-key revocation, expiration or invalid frames stop the runner; background services do not restart these deliberate security cutoffs. Availability has no fixed 30-day runner expiry, but depends on the machine, network, valid credentials and supervisor remaining available. An outage longer than the three-minute recovery window stops existing processes and Browser sessions; the runner continues reconnecting afterward.
97
+ The runner retries temporary API startup failures and WebSocket outages without a retry-count limit, using exponential backoff capped at 30 seconds with jitter. Startup reads have a 30-second request deadline; pairing and other writes are not automatically repeated. Ctrl+C or SIGTERM interrupts both a pending API request and a reconnect wait. Realtime restarts and Cloud Run connection timeouts renew transport without revoking the device. A newly supported ACL-change renewal immediately stops work under the old connection and reconnects against the current approved grant; it never extends the old command permission. Older runners stop on that change and need restarting. Actual grant/account/API-key revocation, expiration or invalid frames stop the runner; background services do not restart these deliberate security cutoffs. Availability has no fixed 30-day runner expiry, but depends on the machine, network, valid credentials and supervisor remaining available. An outage longer than the two-minute (120-second) recovery window stops existing processes and Browser sessions; the runner continues reconnecting afterward.
98
98
 
99
99
  Runner credentials are stored in `runner.json` beside the CLI configuration. Each executed shell command writes raw output to a private `runner-logs/<executionId>.log` there, capped at 10 MB per file. Logs older than 24 hours are removed when the next command starts; a runner left idle does not perform timed cleanup. Optional CLI HTTP tracing writes sanitized request metadata under the project `.revoengine/logs/http-trace/`. These are separate from the Assistant's server-side tool history and do not form a complete local transcript. Treat runner logs as sensitive because command output may contain secrets.
100
100
 
@@ -104,7 +104,7 @@ The Agent terminal has independent command and network grants. Grants are ceilin
104
104
 
105
105
  Browser actions use Playwright's Chromium headless shell. The CLI's npm install downloads that browser into Playwright's per-user cache without requiring Python 3; a separate Chrome installation is not required. If npm scripts were disabled or the download was interrupted, reinstall the CLI with scripts enabled before using Browser. Linux hosts still need Playwright's system libraries; an administrator can install them with `npx playwright install-deps chromium`.
106
106
 
107
- On macOS, workspace commands may use Unix-domain sockets only inside their own private temporary directory. This lets build tools exchange worker messages without enabling IP networking or access to workspace, other-command or host-service sockets. Local development servers still need Local network access and must bind to localhost. Ordinary process deadlines cover the whole lifetime, not startup. The runner advertises `background_shell_v1`: `terminal.start` with `background=true` and `timeout_ms=null` keeps a dev server or watcher on the existing execution ID without the ordinary lifetime timer. Status, output, stdin, PTY and cancel remain available; hiding the terminal view does not stop the process. Scope expiry, revocation, runner stop and the three-minute disconnect grace still apply. Reuse a healthy project server or check fresh HTTP readiness after starting it.
107
+ On macOS, workspace commands may use Unix-domain sockets only inside their own private temporary directory. This lets build tools exchange worker messages without enabling IP networking or access to workspace, other-command or host-service sockets. Local development servers still need Local network access and must bind to localhost. Ordinary process deadlines cover the whole lifetime, not startup. The runner advertises `background_shell_v1`: `terminal.start` with `background=true` and `timeout_ms=null` keeps a dev server or watcher on the existing execution ID without the ordinary lifetime timer. Status, output, stdin, PTY and cancel remain available; hiding the terminal view does not stop the process. Scope expiry, revocation, runner stop and the two-minute (120-second) disconnect grace still apply. Reuse a healthy project server or check fresh HTTP readiness after starting it.
108
108
 
109
109
  The terminal approval UI supports Allow once, Allow for 15 minutes, Allow for 1 hour, Allow for 8 hours, Allow for 24 hours and Allow for this thread. Whole-thread access requires this runner's `terminal_thread_scope_v1` capability. It covers only the requested Commands and Network levels, survives later messages and short reconnects, and carries no hourly deadline. Disconnect, thread deletion and a device grant revision change revoke it. Realtime rechecks the consent on heartbeat, including idle Browser contexts; scope revocation closes only the affected context. Process `background` mode and the one-hour Browser idle retention are independent of this approval duration.
110
110
 
@@ -117,7 +117,7 @@ The Browser bridge advertises `browser_timeout_v1`. Agent calls can set `action_
117
117
 
118
118
  The saved `agentTerminalId` identifies the device across terminal restarts. `deviceId` is an alias. Connecting another directory with the same profile and terminal name reuses the saved device secret and registers a pending workspace under that device. Approve its access in AI Agents → Terminals → Workspaces. A running device refreshes its contract; it does not need a second runner. Ambiguous older duplicate registrations require `--terminal-id`. Services remain pinned to the device UUID and original service directory.
119
119
 
120
- Current runners advertise `terminal_workspaces_v1`, `browser_control_v1` and `file_transfer_v1`. Gateway can request socket reconnect without stopping the CLI. Temporary transport/dependency failures retry and resume within three minutes; authentication failures and revocation stop retry. Newly installed services stop on fatal authentication and restart other failed processes. Reinstall existing services to adopt that supervisor behavior. CLI stop does not persist local processes or browser cookies. Changing workspace grant revision conservatively terminates workspace-bound work and contexts.
120
+ Current runners advertise `terminal_workspaces_v1`, `browser_control_v1`, `file_transfer_v1` and `terminal_resume_durable_v1`. When Realtime confirms durable resume support, output is retained until the server acknowledges its PostgreSQL commit; reconnect resumes the same execution from the last committed output sequence. Redis loss alone does not stop the PTY. Older servers remain compatible without advertising durable recovery. This protocol preserves a running CLI process; it does not restore processes after a CLI or machine crash. Gateway can request socket reconnect without stopping the CLI. Temporary transport/dependency failures retry and resume within two minutes (120 seconds); authentication failures and revocation stop retry. Newly installed services stop on fatal authentication and restart other failed processes. Reinstall existing services to adopt that supervisor behavior. CLI stop does not persist local processes or browser cookies. Changing workspace grant revision conservatively terminates workspace-bound work and contexts.
121
121
 
122
122
  Browser inventory exposes its owning chat and workspace. The model can explicitly close permitted same-actor sessions/tabs to free the four-session/sixteen-tab capacity; active sessions are never silently evicted. Inventory/cleanup preserves the existing network lease. Local/full scope changes recreate the browser context and require browser workflow recovery.
123
123
 
@@ -125,7 +125,7 @@ Browser inventory exposes its owning chat and workspace. The model can explicitl
125
125
 
126
126
  Interactive PTY commands use the optional native `node-pty` package. An unavailable native build does not block CLI installation; PTY requests return `pty_unavailable` until the optional package can be installed. To skip native installation when PTY is not needed, install locally with `npm install --omit=optional @revoengine/cli` and run `npx revo`; npm 11.9 may still install the optional dependency during a global installation. On macOS, the runner verifies the spawn helper's executable permission when a PTY starts. Ordinary commands and local development servers run with pipes.
127
127
 
128
- Local Browser mode filters HTTP and WebSocket requests and disables WebRTC, WebTransport, Worker and SharedWorker before page scripts. Worker-dependent pages may not work in this mode; Chromium is not enclosed in an OS network sandbox. A temporary Local or Full network lease closes the Browser context at expiry when the current permanent grant does not cover it, including before a queued secure credential fill. A lost WebSocket connection, a controlled Realtime restart, or a temporary dependency outage retains running processes and Browser contexts for one three-minute reconnect period; repeated failures do not renew it. Receiving `ready` alone does not reset that period while executions still await resume confirmation. Handshake, ready and execution resume each have a ten-second transport deadline. Access revocation and malformed runner frames stop the runner and its processes. Grant revision changes reject older execute frames and stop only work outside the remaining permanent or temporary scope. A network upgrade preserves the original temporary lease for a subsequent downgrade.
128
+ Local Browser mode filters HTTP and WebSocket requests and disables WebRTC, WebTransport, Worker and SharedWorker before page scripts. Worker-dependent pages may not work in this mode; Chromium is not enclosed in an OS network sandbox. A temporary Local or Full network lease closes the Browser context at expiry when the current permanent grant does not cover it, including before a queued secure credential fill. A lost WebSocket connection, a controlled Realtime restart, or a temporary dependency outage retains running processes and Browser contexts for one two-minute (120-second) reconnect period; repeated failures do not renew it. Receiving `ready` alone does not reset that period while executions still await resume confirmation. Handshake, ready and execution resume each have a ten-second transport deadline. Access revocation and malformed runner frames stop the runner and its processes. Grant revision changes reject older execute frames and stop only work outside the remaining permanent or temporary scope. A network upgrade preserves the original temporary lease for a subsequent downgrade.
129
129
 
130
130
  `save_image` validates the canonical path of the opened file descriptor and reads the image from that same descriptor (up to 30 MiB). It rejects the upload if the descriptor path cannot be verified, including when `lsof` is unavailable on macOS or `/proc/self/fd` cannot be resolved on Linux.
131
131
 
@@ -313,6 +313,13 @@ The JSON extension retains schema version 2, raw family `status`/`counts`, and `
313
313
 
314
314
  Repository deployment uses desired-source-wins upsert: it can adopt a missing baseline or overwrite target content drift with the repository state. Its Database Table policy permits supported table renames, column additions and changes, and copying foreign-reference declarations as metadata. Copying those declarations does not create physical SQL foreign-key constraints.
315
315
 
316
+ Use `--activate` on both repository `plan` and `deploy` to align tracked Event and Schedule `active` values with the manifests. The saved plan includes this activation policy; changing the flag between planning and deployment is rejected before writes. Automation is activated or disabled only after all definition writes and pruning succeed, using verified candidates and readback. Without this flag, target activation is preserved; new automations are created inactive and a remaining activation difference fails deployment verification. Named migrations and dedicated resource commands keep their existing activation behavior.
317
+
318
+ ```bash
319
+ revo plan --prune --activate --out reviewed-plan.json
320
+ revo deploy --prune --activate --yes --reviewed-plan reviewed-plan.json
321
+ ```
322
+
316
323
  `deploy --force` additionally approves supported high-impact operations reported by `plan`, including column removal, managed partition deletion, Materialized View Schedule writes, Schedule target-type changes, and Group or Role Group writes. Review them with `revo plan --force` before deployment. Force does not bypass invalid identity, missing dependencies, unsupported DDL, ambiguity, or failed verification. Full repository reconciliation explicitly selects these supported operations with `--prune`; it does not require `--force`.
317
324
 
318
325
  To reconcile all tracked families, review the complete plan and approve its deletion list:
@@ -548,7 +555,7 @@ Traces retain only known static API route segments, method, status, timing, payl
548
555
 
549
556
  Each CLI invocation shares one queue of up to six active API requests across resource clients. An available slot starts the next waiting request, with queued POST, PUT, PATCH, and DELETE requests taking priority over reads. Waiting requests can be cancelled and expire after five minutes; the HTTP timeout starts when the first network attempt begins. Retry backoff releases the slot before the next attempt is queued. Endpoint and general resource inventories use order-preserving workers that refill free slots without batch barriers. Database View inventory deduplicates active list IDs, fetches complete details, excludes deleted readbacks, and sorts by ID. Failed detail reads fail the inventory instead of silently producing a partial snapshot. Streaming debug and terminal connections use separate transport paths.
550
557
 
551
- Client requests default to no transport retries and there is no global retry flag. Database View detail reads opt into two retries, for up to three attempts. Opted-in requests can retry transport or response-read errors and HTTP 429, 502, 503, or 504; HTTP 500 is retried only for GET, HEAD, and OPTIONS. Aborted requests are not retried. Backoff starts at 100 ms with jitter, respects a bounded numeric `Retry-After`, and shares one request timeout across attempts. This opt-in behavior can also apply to mutations, so resource-specific write recovery still performs its own fresh live validation before retrying.
558
+ Safe HTTP reads (`GET`, `HEAD`, `OPTIONS`), including plan/deploy inventory reads, default to two retries, for up to three attempts. Transport or response-read errors and HTTP 429, 500, 502, 503 and 504 can be retried; validation, permission and version-conflict responses are not. Mutations default to no transport retries, so an uncertain write is not automatically replayed. Explicit client/request retry budgets, including zero, take precedence; there is no global retry flag. Aborted requests are not retried. Backoff starts at 100 ms with jitter, respects a bounded numeric `Retry-After`, releases the transport queue slot while waiting, and shares one request timeout across attempts. Existing mutation-specific opt-ins and fresh live validation remain responsible for their own recovery.
552
559
 
553
560
  ## Update notifications
554
561
 
package/dist/src/cli.js CHANGED
@@ -198,7 +198,7 @@ async function runMain(args, argv) {
198
198
  const command = args._[0];
199
199
  const noPositionals = args._.length === 0;
200
200
  if (command === 'version' || ((args.version !== undefined || args.V !== undefined) && noPositionals)) {
201
- print(args.json ? { version: packageVersion, capabilities: { workspacePrune: true, reviewedPrunePlan: true, reviewedDeploymentPlan: true, componentMutationReview: true } } : packageVersion);
201
+ print(args.json ? { version: packageVersion, capabilities: { workspacePrune: true, reviewedPrunePlan: true, reviewedDeploymentPlan: true, componentMutationReview: true, reviewedAutomationActivation: true } } : packageVersion);
202
202
  return;
203
203
  }
204
204
  if (command === 'info' || ((args.i === true || args.info === true) && noPositionals)) {
@@ -365,7 +365,7 @@ export declare class RevoClient {
365
365
  environmentName: string;
366
366
  fetchImpl: typeof fetch | undefined;
367
367
  private trustedServiceOrigins;
368
- private maxRetries;
368
+ private readonly maxRetries;
369
369
  private retryDelayMs;
370
370
  private requestQueue;
371
371
  constructor(options?: ClientOptions);
@@ -419,7 +419,7 @@ export class RevoClient {
419
419
  this.environmentName = options.environmentName || options.envName || '';
420
420
  this.fetchImpl = options.fetch || globalThis.fetch;
421
421
  this.trustedServiceOrigins = resolveTrustedServiceOrigins(options.trustedServiceOrigins);
422
- this.maxRetries = options.maxRetries ?? 0;
422
+ this.maxRetries = options.maxRetries;
423
423
  this.retryDelayMs = options.retryDelayMs ?? 100;
424
424
  this.requestQueue = options.requestQueue || currentRequestQueue() || new RequestQueue();
425
425
  }
@@ -524,9 +524,10 @@ export class RevoClient {
524
524
  body: options.sensitiveAccountPayload ? '[account payload omitted]' : body,
525
525
  context: this.environmentName ? { environment: this.environmentName } : undefined,
526
526
  });
527
- const maxRetries = options.maxRetries ?? this.maxRetries;
528
- const baseRetryDelay = options.retryDelayMs ?? this.retryDelayMs;
529
527
  const normalizedMethod = method.toUpperCase();
528
+ const safeRead = ['GET', 'HEAD', 'OPTIONS'].includes(normalizedMethod);
529
+ const maxRetries = options.maxRetries ?? this.maxRetries ?? (safeRead ? 2 : 0);
530
+ const baseRetryDelay = options.retryDelayMs ?? this.retryDelayMs;
530
531
  spinner.start();
531
532
  try {
532
533
  let lastError;
@@ -125,6 +125,8 @@ function printMigrationPlan(context, plan) {
125
125
  context.println(`Changes required: ${plan.needsChanges ? 'yes' : 'no'}; verdict: ${plan.verdict}.`);
126
126
  context.println(`Summary: create ${plan.operations.create}, update ${plan.operations.update}${plan.prune ? `, delete ${plan.operations.delete || 0}` : ''}, adopt ${plan.operations.adopt}, unchanged ${plan.operations.noop}, excluded ${plan.operations.excluded}, blocked ${plan.operations.blocked}.`);
127
127
  context.println(`Diagnostics: ${plan.warnings.length} warning(s), ${plan.blockers.length} blocker(s).`);
128
+ if (plan.policy.activateAutomations)
129
+ context.println('Automation activation: align tracked Events and Schedules with repository active values after verified writes and pruning.');
128
130
  if (plan.sourcePull.mode === 'repository') {
129
131
  context.println('Source snapshot: repository workspace (no remote source pull).');
130
132
  }
@@ -391,6 +393,7 @@ async function readWorkspaceDeploymentInput(context) {
391
393
  resources,
392
394
  withStats: readBoolFlag(context.args, ['with-stats']),
393
395
  allowDestructive: readBoolFlag(context.args, ['force', 'f']) || readBoolFlag(context.args, ['prune']),
396
+ activateAutomations: readBoolFlag(context.args, ['activate']),
394
397
  prune: readBoolFlag(context.args, ['prune']),
395
398
  sourceMode: 'workspace',
396
399
  targetClient: context.client,
@@ -550,6 +553,10 @@ function printRunResult(context, result, showPlan = true) {
550
553
  reason: ('error' in item ? item.error : undefined) || item.reason,
551
554
  });
552
555
  }
556
+ if (result.verdict !== 'succeeded' && result.verification) {
557
+ context.println('Post-deployment verification:');
558
+ printMigrationPlan(context, result.verification);
559
+ }
553
560
  context.println(`Final verdict: ${result.verdict}.`);
554
561
  }
555
562
  export async function handleDeployCommand(context) {
@@ -0,0 +1,16 @@
1
+ export type TerminalOutputChunk = {
2
+ sequence: number;
3
+ stream: 'stdout' | 'stderr';
4
+ text: string;
5
+ };
6
+ /** Only a committed server ACK removes output. Sequence identity survives buffer pruning. */
7
+ export declare class TerminalOutputBuffer {
8
+ private readonly chunks;
9
+ private sequence;
10
+ private acknowledged;
11
+ get lastSequence(): number;
12
+ get lastAcknowledged(): number;
13
+ append(stream: TerminalOutputChunk['stream'], text: string): TerminalOutputChunk;
14
+ acknowledge(sequence: unknown): boolean;
15
+ pending(): readonly TerminalOutputChunk[];
16
+ }
@@ -0,0 +1,24 @@
1
+ /** Only a committed server ACK removes output. Sequence identity survives buffer pruning. */
2
+ export class TerminalOutputBuffer {
3
+ chunks = [];
4
+ sequence = 0;
5
+ acknowledged = 0;
6
+ get lastSequence() { return this.sequence; }
7
+ get lastAcknowledged() { return this.acknowledged; }
8
+ append(stream, text) {
9
+ const chunk = { sequence: ++this.sequence, stream, text };
10
+ this.chunks.push(chunk);
11
+ return chunk;
12
+ }
13
+ acknowledge(sequence) {
14
+ if (!Number.isSafeInteger(sequence) || sequence < 0 || sequence > this.sequence)
15
+ return false;
16
+ if (sequence <= this.acknowledged)
17
+ return true;
18
+ this.acknowledged = sequence;
19
+ while (this.chunks.length && this.chunks[0].sequence <= this.acknowledged)
20
+ this.chunks.shift();
21
+ return true;
22
+ }
23
+ pending() { return this.chunks; }
24
+ }
@@ -5,7 +5,7 @@ export class TerminalReconnectGrace {
5
5
  delayMs;
6
6
  scheduleTimer;
7
7
  clearTimer;
8
- constructor(onExpire, delayMs = 180_000, scheduleTimer = setTimeout, clearTimer = clearTimeout) {
8
+ constructor(onExpire, delayMs = 120_000, scheduleTimer = setTimeout, clearTimer = clearTimeout) {
9
9
  this.onExpire = onExpire;
10
10
  this.delayMs = delayMs;
11
11
  this.scheduleTimer = scheduleTimer;
@@ -15,6 +15,7 @@ import { transferWorkspaceFile, validateFileTransfer } from "./terminal-file.js"
15
15
  import { uploadWorkspaceImages } from "./terminal-image.js";
16
16
  import { ensurePtyHelperExecutable, normalizePtyStartError } from "./terminal-pty.js";
17
17
  import { TerminalReconnectGrace, TerminalTransportRecovery, isRunnerTransportHeartbeat } from "./terminal-reconnect-grace.js";
18
+ import { TerminalOutputBuffer } from "./terminal-output-buffer.js";
18
19
  import { TerminalOperationalLog } from "./terminal-operational-log.js";
19
20
  import { createSecureBrowserIdentity, decryptSecureBrowserInput } from "./terminal-secure-browser.js";
20
21
  class TerminalRunnerFatalError extends Error {
@@ -370,7 +371,7 @@ export function boundResultFrame(frame) {
370
371
  return bounded;
371
372
  }
372
373
  function sendResult(socket, frame) {
373
- send(socket, boundResultFrame(frame));
374
+ send(socket, boundResultFrame({ lastOutputSequence: 0, ...frame }));
374
375
  }
375
376
  export async function runCommand(input, onDone, onChunk) {
376
377
  const workdir = resolveWorkspaceDirectory(input.workspace, input.workdir);
@@ -656,11 +657,14 @@ async function connect(profile, device) {
656
657
  let stopping = false;
657
658
  let activeSocket;
658
659
  let activeConnectionId = '';
660
+ let durableOutput = false;
659
661
  const activeChildren = new Set();
660
662
  const children = new Map();
661
663
  const activePolicies = new Map();
662
664
  const cancelledExecutions = new Set();
663
665
  const outputByExecution = new Map();
666
+ const retiredExecutions = new Map();
667
+ let nextRetiredSweep = 0;
664
668
  const completed = new Map();
665
669
  const traces = new Map();
666
670
  const secureRequests = new Map();
@@ -697,13 +701,14 @@ async function connect(profile, device) {
697
701
  const sendCurrent = (frame) => {
698
702
  if (activeConnectionId && activeSocket?.readyState === WebSocket.OPEN)
699
703
  send(activeSocket, frame.type === 'result'
700
- ? boundResultFrame({ ...frame, connectionId: activeConnectionId })
704
+ ? boundResultFrame({ ...frame, connectionId: activeConnectionId,
705
+ ...(durableOutput ? { lastOutputSequence: outputByExecution.get(String(frame.executionId))?.lastSequence ?? 0 } : {}) })
701
706
  : { ...frame, connectionId: activeConnectionId });
702
707
  };
703
708
  const flushExecution = (executionId) => {
704
709
  if (!resumed.has(executionId))
705
710
  return;
706
- for (const chunk of outputByExecution.get(executionId) || [])
711
+ for (const chunk of outputByExecution.get(executionId)?.pending() || [])
707
712
  sendCurrent({ type: 'output', executionId, ...chunk });
708
713
  const result = completed.get(executionId);
709
714
  if (result)
@@ -745,7 +750,7 @@ async function connect(profile, device) {
745
750
  reconnectGrace.clear();
746
751
  });
747
752
  socket.on('open', () => send(socket, { type: 'hello', protocol: 1, agentTerminalId: device.agentTerminalId,
748
- secret: device.secret, capabilities: ['grant_refresh_v1', 'workspace_sandbox_v1', 'workspace_network_v1', 'network_policy_v1',
753
+ secret: device.secret, capabilities: ['terminal_resume_durable_v1', 'grant_refresh_v1', 'workspace_sandbox_v1', 'workspace_network_v1', 'network_policy_v1',
749
754
  'terminal_policy_v2', 'terminal_policy_selective_v1', 'background_shell_v1', 'terminal_thread_scope_v1',
750
755
  'apply_patch_v1', 'stdin_v1', 'pty_v1', 'browser_v1', 'browser_session_v1', 'browser_forms_v1',
751
756
  'browser_local_v1', 'browser_once_v1', 'browser_secure_input_v1', 'browser_tabs_v1', 'save_image_v1',
@@ -778,6 +783,7 @@ async function connect(profile, device) {
778
783
  securePolicyEpoch++;
779
784
  connectionId = frame.connectionId;
780
785
  activeConnectionId = connectionId;
786
+ durableOutput = Array.isArray(frame.capabilities) && frame.capabilities.includes('terminal_resume_durable_v1');
781
787
  defaultWorkspace = frame.workspace || device.workspace;
782
788
  if (Number.isSafeInteger(frame.policyGrantRevision) && frame.policyGrantRevision >= 0) {
783
789
  minimumPolicyGrantRevision = Math.max(minimumPolicyGrantRevision, frame.policyGrantRevision);
@@ -893,7 +899,16 @@ async function connect(profile, device) {
893
899
  }
894
900
  if (frame.connectionId !== connectionId || !frame.executionId)
895
901
  return;
902
+ if (frame.type === 'output_ack') {
903
+ if (durableOutput && !outputByExecution.get(frame.executionId)?.acknowledge(frame.lastOutputSequence))
904
+ socket.terminate();
905
+ return;
906
+ }
896
907
  if (frame.type === 'resumed') {
908
+ if (durableOutput && !outputByExecution.get(frame.executionId)?.acknowledge(frame.lastOutputSequence)) {
909
+ socket.terminate();
910
+ return;
911
+ }
897
912
  recovery.accepted(frame.executionId);
898
913
  resumed.add(frame.executionId);
899
914
  flushExecution(frame.executionId);
@@ -906,6 +921,14 @@ async function connect(profile, device) {
906
921
  children.get(frame.executionId)?.terminate();
907
922
  }
908
923
  completed.delete(frame.executionId);
924
+ const now = Date.now();
925
+ retiredExecutions.set(frame.executionId, now + 65 * 60_000);
926
+ if (now >= nextRetiredSweep) {
927
+ for (const [id, expiresAt] of retiredExecutions)
928
+ if (expiresAt <= now)
929
+ retiredExecutions.delete(id);
930
+ nextRetiredSweep = now + 60_000;
931
+ }
909
932
  outputByExecution.delete(frame.executionId);
910
933
  resumed.delete(frame.executionId);
911
934
  traces.delete(frame.executionId);
@@ -943,6 +966,11 @@ async function connect(profile, device) {
943
966
  }
944
967
  if (frame.type !== 'execute')
945
968
  return;
969
+ if ((retiredExecutions.get(frame.executionId) || 0) > Date.now()) {
970
+ sendResult(socket, { type: 'result', connectionId, executionId: frame.executionId,
971
+ executed: false, stdout: '', stderr: 'execution_already_retired', exitCode: null });
972
+ return;
973
+ }
946
974
  if (policyRevisionUnavailable || !Number.isSafeInteger(frame.policyGrantRevision)
947
975
  || frame.policyGrantRevision < minimumPolicyGrantRevision) {
948
976
  sendResult(socket, { type: 'result', connectionId, executionId: frame.executionId,
@@ -1010,7 +1038,7 @@ async function connect(profile, device) {
1010
1038
  traces.set(frame.executionId, trace);
1011
1039
  operationalLog.write('INFO', trace, 'execution.started', { operation, sandbox: frame.sandbox });
1012
1040
  resumed.add(frame.executionId);
1013
- outputByExecution.set(frame.executionId, []);
1041
+ outputByExecution.set(frame.executionId, new TerminalOutputBuffer());
1014
1042
  if (operation === 'save_image' || operation === 'upload_file' || operation === 'download_file') {
1015
1043
  const controller = new AbortController();
1016
1044
  const policyDeadline = executionPolicyDeadline(frame);
@@ -1178,10 +1206,10 @@ async function connect(profile, device) {
1178
1206
  sendCurrent({ type: 'result', executionId: frame.executionId,
1179
1207
  ...completed.get(frame.executionId) });
1180
1208
  }, (stream, text) => {
1181
- const chunks = outputByExecution.get(frame.executionId) || [];
1182
- const chunk = { sequence: chunks.length + 1, stream, text };
1183
- chunks.push(chunk);
1184
- outputByExecution.set(frame.executionId, chunks);
1209
+ const buffer = outputByExecution.get(frame.executionId);
1210
+ if (!buffer)
1211
+ return;
1212
+ const chunk = buffer.append(stream, text);
1185
1213
  if (resumed.has(frame.executionId))
1186
1214
  sendCurrent({ type: 'output', executionId: frame.executionId, ...chunk });
1187
1215
  });
@@ -50,6 +50,7 @@ export type MigrationPlan = {
50
50
  pruneTargetKey?: string;
51
51
  policy: DatabaseSchemaMigrationPolicy & {
52
52
  mode: 'upsert' | 'reconcile';
53
+ activateAutomations?: boolean;
53
54
  };
54
55
  needsChanges: boolean;
55
56
  readyToMigrate: boolean;
@@ -84,6 +85,7 @@ export type MigrationRun = {
84
85
  resources: MigrationResource[];
85
86
  policy: DatabaseSchemaMigrationPolicy & {
86
87
  mode: 'upsert' | 'reconcile';
88
+ activateAutomations?: boolean;
87
89
  };
88
90
  verdict: 'succeeded' | 'blocked' | 'failed';
89
91
  sourcePull: {
@@ -112,6 +114,7 @@ type MigrationInputBase = {
112
114
  resources?: MigrationResource[];
113
115
  withStats?: boolean;
114
116
  allowDestructive?: boolean;
117
+ activateAutomations?: boolean;
115
118
  detailedDiff?: boolean;
116
119
  prune?: boolean;
117
120
  reviewedPrune?: WorkspacePrunePlan;
@@ -17,10 +17,10 @@ import { REVO_METADATA_FILE, readProjectComponentIdentity, readProjectMetadata,
17
17
  import { DATABASE_SCHEMAS_DIRECTORY, buildDatabaseSchemasPlan, pullDatabaseSchemasToWorkspace, pushDatabaseSchemas, readWorkspaceDatabaseSchemas, } from "./resource-syncs/database-table-sync.js";
18
18
  import { DATABASE_VIEWS_DIRECTORY, buildDatabaseViewsPlan, pullDatabaseViewsToWorkspace, pushDatabaseViews, readWorkspaceDatabaseViews, } from "./resource-syncs/database-view-sync.js";
19
19
  import { ENDPOINTS_DIRECTORY, buildEndpointsPlan, pullEndpointsToWorkspace, pushEndpoints, } from "./resource-syncs/endpoint-sync.js";
20
- import { EVENTS_DIRECTORY, buildEventsPlan, pullEventsToWorkspace, pushEvents, } from "./resource-syncs/event-sync.js";
20
+ import { EVENTS_DIRECTORY, activateVerifiedEvents, buildEventsPlan, pullEventsToWorkspace, pushEvents, } from "./resource-syncs/event-sync.js";
21
21
  import { GROUPS_DIRECTORY, buildGroupsPlan, pullGroupsToWorkspace, pushGroups, } from "./resource-syncs/group-sync.js";
22
22
  import { JOB_TEMPLATES_DIRECTORY, buildJobTemplatesPlan, pullJobTemplatesToWorkspace, pushJobTemplates, } from "./resource-syncs/job-template-sync.js";
23
- import { SCHEDULES_DIRECTORY, buildSchedulesPlan, pullSchedulesToWorkspace, pushSchedules, } from "./resource-syncs/schedule-sync.js";
23
+ import { SCHEDULES_DIRECTORY, activateVerifiedSchedules, buildSchedulesPlan, pullSchedulesToWorkspace, pushSchedules, } from "./resource-syncs/schedule-sync.js";
24
24
  import { ROLE_GROUPS_DIRECTORY, buildRoleGroupsPlan, pullRoleGroupsToWorkspace, pushRoleGroups, } from "./resource-syncs/role-group-sync.js";
25
25
  const RESOURCE_ORDER = [
26
26
  'database-table',
@@ -286,7 +286,7 @@ function summarizeEventPhase(plan) {
286
286
  .map((item) => `Event "${item.stableKey || item.name}" has no target lock baseline; source-wins migration will align or adopt it.`),
287
287
  ...plan.items
288
288
  .filter((item) => item.status === 'activation-drift')
289
- .map((item) => `Event "${item.stableKey || item.name}" has activation drift; migration syncs its portable configuration but keeps activation as an explicit operational step.`),
289
+ .map((item) => `Event "${item.stableKey || item.name}" has activation drift; activation requires repository plan/deploy --activate or the dedicated events push --activate step.`),
290
290
  ])];
291
291
  const blockers = [...new Set(plan.blockers)];
292
292
  return {
@@ -585,10 +585,10 @@ function combinePlan(input) {
585
585
  input.endpoints = { ...input.endpoints, items: projectRepositoryItems(input.endpoints.items, endpointItemAction, (item) => item.stableKey ? lock.endpoints[item.stableKey]?.environments[environment]?.remoteHash : undefined) };
586
586
  }
587
587
  if (input.schedules) {
588
- input.schedules = { ...input.schedules, items: projectRepositoryItems(input.schedules.items, scheduleItemAction, (item) => item.stableKey ? lock.schedules[item.stableKey]?.environments[environment]?.remoteHash : undefined) };
588
+ input.schedules = { ...input.schedules, items: projectRepositoryItems(input.schedules.items, item => input.migrationInput.activateAutomations && item.status === 'activation-drift' && !item.blocked ? 'update' : scheduleItemAction(item), (item) => item.stableKey ? lock.schedules[item.stableKey]?.environments[environment]?.remoteHash : undefined) };
589
589
  }
590
590
  if (input.events) {
591
- input.events = { ...input.events, items: projectRepositoryItems(input.events.items, eventItemAction, (item) => item.stableKey ? lock.events[item.stableKey]?.environments[environment]?.remoteHash : undefined) };
591
+ input.events = { ...input.events, items: projectRepositoryItems(input.events.items, item => input.migrationInput.activateAutomations && item.status === 'activation-drift' && !item.blocked ? 'update' : eventItemAction(item), (item) => item.stableKey ? lock.events[item.stableKey]?.environments[environment]?.remoteHash : undefined) };
592
592
  }
593
593
  if (input.groups) {
594
594
  input.groups = { ...input.groups, items: projectRepositoryItems(input.groups.items, groupItemAction, baselineByKey(lock.groups)) };
@@ -701,7 +701,7 @@ function combinePlan(input) {
701
701
  from: input.migrationInput.from,
702
702
  to: input.migrationInput.to,
703
703
  resources: selectedResources(input.migrationInput),
704
- policy: { ...migrationPolicy(input.migrationInput), mode: 'upsert' },
704
+ policy: { ...migrationPolicy(input.migrationInput), mode: 'upsert', ...(input.migrationInput.activateAutomations ? { activateAutomations: true } : {}) },
705
705
  needsChanges: phases.some((phase) => phase.needsChanges),
706
706
  readyToMigrate: blockers.length === 0,
707
707
  verdict: phaseVerdict(blockers, warnings),
@@ -1289,7 +1289,7 @@ export async function runMigration(input) {
1289
1289
  from: input.from,
1290
1290
  to: input.to,
1291
1291
  resources,
1292
- policy: { ...migrationPolicy(input), mode: 'upsert' },
1292
+ policy: { ...migrationPolicy(input), mode: 'upsert', ...(input.activateAutomations ? { activateAutomations: true } : {}) },
1293
1293
  sourcePull: pulls,
1294
1294
  plan: initialPlan,
1295
1295
  };
@@ -1300,6 +1300,8 @@ export async function runMigration(input) {
1300
1300
  const environmentKey = targetKey(input);
1301
1301
  const phaseResults = {};
1302
1302
  const results = [];
1303
+ const pendingEvents = [];
1304
+ const pendingSchedules = [];
1303
1305
  let remainingPrune = initialPlan.prune;
1304
1306
  if (remainingPrune?.items.some((item) => item.beforeUpserts)) {
1305
1307
  const pruned = await applyWorkspacePrune({ cwd: input.cwd, client: targetClient,
@@ -1559,6 +1561,7 @@ export async function runMigration(input) {
1559
1561
  stableKeyName,
1560
1562
  force: true,
1561
1563
  });
1564
+ pendingSchedules.push(...pushed.verifiedActivationCandidates);
1562
1565
  phaseResults.schedule = pushed.results;
1563
1566
  results.push(...pushed.results);
1564
1567
  if (!scheduleResultsAreComplete(pushed.results)) {
@@ -1593,6 +1596,7 @@ export async function runMigration(input) {
1593
1596
  stableKeyName,
1594
1597
  force: true,
1595
1598
  });
1599
+ pendingEvents.push(...pushed.verifiedActivationCandidates);
1596
1600
  phaseResults.event = pushed.results;
1597
1601
  results.push(...pushed.results);
1598
1602
  if (!eventResultsAreComplete(pushed.results)) {
@@ -1686,6 +1690,21 @@ export async function runMigration(input) {
1686
1690
  const pruneResults = await applyWorkspacePrune({ cwd: input.cwd, client: targetClient,
1687
1691
  resources, envName: environmentKey, plan: remainingPrune });
1688
1692
  results.push(...pruneResults);
1693
+ if (!resultsAreComplete(pruneResults))
1694
+ return { ...base, verdict: 'failed', results, phaseResults };
1695
+ }
1696
+ // Enable automation only after every definition write and obsolete consumer deletion succeeded.
1697
+ if (input.activateAutomations) {
1698
+ for (const [family, activate] of [
1699
+ ['event', () => activateVerifiedEvents({ client: targetClient, candidates: pendingEvents })],
1700
+ ['schedule', () => activateVerifiedSchedules({ client: targetClient, candidates: pendingSchedules })],
1701
+ ]) {
1702
+ const activated = await activate();
1703
+ results.push(...activated);
1704
+ phaseResults[family] = [...(phaseResults[family] || []), ...activated];
1705
+ if (!resultsAreComplete(activated))
1706
+ return { ...base, verdict: 'failed', results, phaseResults };
1707
+ }
1689
1708
  }
1690
1709
  const verification = await planWorkspace({
1691
1710
  ...input,
@@ -847,6 +847,11 @@ export async function activateVerifiedEvents(input) {
847
847
  });
848
848
  continue;
849
849
  }
850
+ // Check the complete verified definition again before enabling its side effects.
851
+ await verifyEventWrite({ client: input.client, stableKeyName: candidate.stableKeyName,
852
+ manifest: candidate.manifest, eventId: candidate.eventId,
853
+ jobTemplateId: String(current.targetId || ''), expectedActive: current.active === true,
854
+ jobTemplatesById: jobTemplatesCache });
850
855
  if (candidate.manifest.active) {
851
856
  await input.client.activateEvent(candidate.eventId);
852
857
  }
package/dist/src/ui.js CHANGED
@@ -179,8 +179,8 @@ function renderCommandCatalog() {
179
179
  commandRow('revo metadata apply [--project <name>] --yes [--skip-partitions]', 'Populate missing stable-key metadata'),
180
180
  commandRow('revo pull --all|--resources <list> --yes [--skip-groups] [--force] [--json]', 'Build the repository workspace from the configured runtime source'),
181
181
  commandRow('revo diff [--json]', 'Show only workspace-to-target resource differences without writes'),
182
- commandRow('revo plan [--prune] [--out file] [--force] [--strict] [--json] [--hints]', 'Plan tracked workspace upserts and optional Stable Key deletions without writes'),
183
- commandRow('revo deploy [--yes] [--prune] [--reviewed-plan file] [--force] [--json]', 'Review, confirm, deploy and prune tracked resources in dependency order'),
182
+ commandRow('revo plan [--activate] [--prune] [--out file] [--force] [--strict] [--json] [--hints]', 'Plan tracked workspace upserts and optional Stable Key deletions without writes'),
183
+ commandRow('revo deploy [--yes] [--activate] [--prune] [--reviewed-plan file] [--force] [--json]', 'Review, confirm, deploy and prune tracked resources in dependency order'),
184
184
  commandRow('revo migrate plan --from <env> --to <env> [--resources <list>] [--skip-groups] [--force] [--json] [--hints]', 'Preview twelve resource families and identity dependencies'),
185
185
  commandRow('revo migrate run --from <env> --to <env> [--resources <list>] [--skip-groups] --yes [--force] [--json]', 'Pull, plan, migrate, and verify resources in dependency order'),
186
186
  commandRow('revo migrate verify --from <env> --to <env> [--resources <list>] [--json]', 'Verify target resources against a fresh temporary source pull'),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@revoengine/cli",
3
- "version": "1.0.24",
3
+ "version": "1.0.26",
4
4
  "description": "CLI package for the RevoEngine Platform API",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",