@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 +12 -5
- package/dist/src/cli.js +1 -1
- package/dist/src/client.d.ts +1 -1
- package/dist/src/client.js +4 -3
- package/dist/src/commands/migrate.js +7 -0
- package/dist/src/commands/terminal-output-buffer.d.ts +16 -0
- package/dist/src/commands/terminal-output-buffer.js +24 -0
- package/dist/src/commands/terminal-reconnect-grace.js +1 -1
- package/dist/src/commands/terminal.js +37 -9
- package/dist/src/migration.d.ts +3 -0
- package/dist/src/migration.js +26 -7
- package/dist/src/resource-syncs/event-sync.js +5 -0
- package/dist/src/ui.js +2 -2
- package/package.json +1 -1
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
|
|
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
|
|
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 `
|
|
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
|
|
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
|
-
|
|
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)) {
|
package/dist/src/client.d.ts
CHANGED
|
@@ -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);
|
package/dist/src/client.js
CHANGED
|
@@ -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
|
|
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 =
|
|
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
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
|
|
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
|
});
|
package/dist/src/migration.d.ts
CHANGED
|
@@ -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;
|
package/dist/src/migration.js
CHANGED
|
@@ -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;
|
|
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'),
|