@revoengine/cli 1.0.9 → 1.0.11

package/dist/src/ui.js

@@ -94,28 +94,80 @@ function renderCommandCatalog() {
         `  ${formatCommand(`${CLI_NAME} <command> [arguments] [options]`)}`,
         '',
         paintHeader('Global Options'),
+        commandRow('--project <name>', 'Use one saved project for this command'),
         commandRow('--url <url>', 'Override API base URL for TEST, prod, local, or dedicated tenants'),
         commandRow('--token <apiKey>', 'Override API key for non-interactive runs'),
         commandRow('--no-update-notifier', 'Disable npm version update checks for this run'),
         '',
-        paintHeader('Core'),
+        paintHeader('Projects'),
         commandRow('revo -i', 'Show runtime info, config path, and auth state'),
+        commandRow('revo projects add <name> [--url <url>] [--token <apiKey>]', 'Save and activate a project'),
+        commandRow('revo projects list [--json]', 'List projects and mark the active one'),
+        commandRow('revo projects set <name>', 'Switch the active project; use default for the original login'),
+        commandRow('revo projects remove <name>', 'Remove a saved project'),
+        '',
+        paintHeader('Authentication'),
         commandRow('revo auth login', 'Paste API key in the terminal'),
         commandRow('revo auth status', 'Show the current authentication status'),
         commandRow('revo auth logout', 'Remove stored credentials'),
-        commandRow('revo project [path]', 'Initialize ambient editor types for JS and TS'),
+        '',
+        paintHeader('Workspace'),
+        commandRow('revo project init [path] [--identity-mode <stableKey|componentId>] [--stable-key-name <name>] [--resources <list>]', 'Initialize local workspace config and editor types'),
         commandRow('revo project update [path]', 'Refresh editor types and project metadata'),
-        commandRow('revo endpoints', 'List available API endpoints'),
+        '',
+        paintHeader('Terminal'),
+        commandRow('revo terminal connect --workspace <path> --name <name>', 'Pair and run a local terminal'),
+        commandRow('revo terminal service install --workspace <path>', 'Run an approved terminal in the background on macOS or Linux'),
+        commandRow('revo terminal service uninstall --workspace <path>', 'Stop and remove the background service'),
+        commandRow('revo terminal status', 'Show terminal grants'),
+        commandRow('revo terminal disconnect --workspace <path>', 'Revoke a local terminal grant'),
         '',
         paintHeader('Components'),
-        commandRow('revo component plan --all [--json] [--strict] [--changed --base <ref>]', 'Preview local/remote sync status'),
-        commandRow('revo component pull <componentId...> [--force]', 'Pull one or more components safely'),
-        commandRow('revo component pull --all [--yes] [--force]', 'Pull every available component safely'),
-        commandRow('revo component push <componentId...>', 'Push one or more local components'),
-        commandRow('revo component push --all [--yes] [--force] [--changed --base <ref>]', 'Push local components with lock checks'),
+        commandRow('revo component plan --all [--project <name>] [--json] [--strict] [--changed --base <ref>]', 'Preview local/remote sync status'),
+        commandRow('revo component pull <identity...> [--project <name>] [--force]', 'Pull by configured stable key or component ID'),
+        commandRow('revo component pull --all [--project <name>] [--yes] [--force]', 'Pull every available component safely'),
+        commandRow('revo component push <identity...> [--project <name>]', 'Push by configured stable key or component ID'),
+        commandRow('revo component push --all [--project <name>] [--yes] [--force] [--changed --base <ref>]', 'Push local components with lock checks'),
         commandRow('revo component debug <componentId> [BODY] [--stream] [--raw-debug]', 'Debug one local component against sandbox'),
         '',
-        paintHeader('Low-Level'),
+        paintHeader('Databases'),
+        commandRow('revo database-schemas pull --all [--project <name>] [--force] [--strict]', 'Pull portable Database Schemas and partitions'),
+        commandRow('revo database-schemas plan --all [--project <name>] [--with-stats] [--json] [--strict]', 'Preview schema drift, DDL risks, partitions, and performance hints'),
+        commandRow('revo database-schemas push <stableKey>|--all [--project <name>] --yes [--force] [--prune-partitions]', 'Create, safely update, or explicitly prune managed partitions'),
+        commandRow('revo database-views pull --all [--project <name>] [--force] [--strict]', 'Pull portable STRUCTURED and RAW_SQL Database Views after Database Schema convergence'),
+        commandRow('revo database-views plan --all [--project <name>] [--json] [--strict]', 'Preview Database View drift, source readiness, and target compilation'),
+        commandRow('revo database-views push <stableKey>|--all [--project <name>] --yes [--force] [--allow-materialized]', 'Create or update Database Views after live preview'),
+        '',
+        paintHeader('Endpoints'),
+        commandRow('revo endpoints', 'List available API endpoints'),
+        commandRow('revo endpoints pull --all [--project <name>] [--force]', 'Pull managed endpoints into the configured workspace'),
+        commandRow('revo endpoints plan --all [--project <name>] [--json] [--strict]', 'Preview Endpoint state and Component compatibility'),
+        commandRow('revo endpoints push --all [--project <name>] [--yes] [--force]', 'Deploy and verify managed endpoints'),
+        '',
+        paintHeader('Access'),
+        commandRow('revo role-groups pull --all [--project <name>] [--force]', 'Pull managed role groups into the configured workspace'),
+        commandRow('revo role-groups plan --all [--project <name>] [--json] [--strict]', 'Preview workspace, lock, and live target state'),
+        commandRow('revo role-groups push --all [--project <name>] [--yes] [--force]', 'Push role groups with live stable-key and lock checks'),
+        commandRow('revo groups pull --all [--project <name>] [--force]', 'Pull managed groups into the configured workspace'),
+        commandRow('revo groups plan --all [--project <name>] [--json] [--strict]', 'Preview workspace, lock, and live target state'),
+        commandRow('revo groups push --all [--project <name>] [--yes] [--force]', 'Push portable group structures with live owner resolution'),
+        '',
+        paintHeader('Automation'),
+        commandRow('revo job-templates pull --all [--project <name>] [--force]', 'Pull portable job templates into the configured workspace'),
+        commandRow('revo job-templates plan --all [--project <name>] [--json] [--strict]', 'Preview workspace, lock, dependencies, and live target state'),
+        commandRow('revo job-templates push --all [--project <name>] --yes [--force] [--json]', 'Create or safely update job templates with live lock checks'),
+        commandRow('revo schedules pull --all [--project <name>] [--force]', 'Pull Job Template and Materialized View schedules into the configured workspace'),
+        commandRow('revo schedules plan --all [--project <name>] [--json] [--strict]', 'Preview workspace, lock, target schedules, and portable dependencies'),
+        commandRow('revo schedules push --all [--project <name>] --yes [--force] [--allow-materialized] [--activate] [--json]', 'Create or safely update disabled-by-default Schedule definitions'),
+        commandRow('revo events pull --all [--project <name>] [--force] [--json]', 'Pull portable Job Template Event definitions into the configured workspace'),
+        commandRow('revo events plan --all [--project <name>] [--json] [--strict]', 'Preview Event manifests, lock baselines, target state, and Job Template dependencies'),
+        commandRow('revo events push --all [--project <name>] --yes [--force] [--activate] [--json]', 'Create or safely update disabled-by-default Event definitions'),
+        '',
+        paintHeader('Advanced'),
+        commandRow('revo env diff --from <env> --to <env> [--prune] [--json] [--strict]', 'Compare components across two projects'),
+        commandRow('revo env apply --from <env> --to <env> [--yes] [--prune] [--force]', 'Mirror components from one project into another'),
+        commandRow('revo metadata plan [--project <name>] [--skip-partitions] [--json]', 'Preview stable-key metadata backfill'),
+        commandRow('revo metadata apply [--project <name>] --yes [--skip-partitions]', 'Populate missing stable-key metadata'),
         commandRow('revo search <CODE|SIMPLE> <term>', 'Search code references or all platform content'),
         commandRow('revo request <METHOD> <PATH> [BODY]', 'Make a raw API request with optional JSON body'),
     ].join('\n');
@@ -142,8 +194,11 @@ export function renderHelp(version) {
 }
 export function renderRuntimeInfo(input) {
     const { auth, configDir, nodeVersion, packageVersion, runtime } = input;
+    const environmentName = input.environmentName || 'default';
     const onboardingWarning = auth.status === 'not_authenticated'
-        ? paintWarning(`Warning: Start onboarding with ${CLI_ALIAS} auth login`)
+        ? paintWarning(environmentName === 'default'
+            ? `Warning: Start onboarding with ${CLI_NAME} auth login`
+            : `Warning: Check the API key for project "${environmentName}"`)
         : '';
     return [
         renderBanner(packageVersion),
@@ -152,11 +207,13 @@ export function renderRuntimeInfo(input) {
         paintHeader('Runtime'),
         row('Node', nodeVersion),
         row('Config', configDir),
+        row('Project', environmentName),
         row('Base URL', runtime.baseUrl),
         row('Status', formatStatusValue(auth)),
         ...(shouldRenderValidationRow(auth) ? [row('Validation', auth.validation || 'skipped')] : []),
         '',
         paintHeader('Tips'),
+        commandRow('revo projects list', 'See and switch projects'),
         commandRow('revo auth login', 'Save credentials interactively'),
         commandRow('revo --help', 'Show the command reference'),
     ].join('\n');
@@ -167,6 +224,7 @@ export function renderAuthStatus(input) {
         paintHeader('Auth Status'),
         row('Status', formatStatusValue(auth)),
         row('Config', configDir),
+        row('Project', input.environmentName || 'default'),
         row('Base URL', runtime.baseUrl),
         row('API key', runtime.token ? 'configured' : 'missing'),
         ...(shouldRenderValidationRow(auth) ? [row('Validation', auth.validation || 'skipped')] : []),

package/dist/src/utils.d.ts

@@ -4,6 +4,8 @@ export declare function readBoolFlag(args: ParsedArgs, names: string[]): boolean
 export declare function readValues(args: ParsedArgs, names: string[]): string[];
 export declare function toArray(value: string | string[] | undefined): string[];
 export declare function sanitizeSegment(value: string): string;
+export declare function normalizeCron(value: string): string;
+export declare function isValidNormalizedCron(value: string): boolean;
 export declare function readJsonFile(filePath: string): any;
 export declare function writeJsonFile(filePath: string, data: unknown): void;
 export declare function deepClone<T>(value: T): T;

package/dist/src/utils.js

@@ -51,6 +51,70 @@ export function sanitizeSegment(value) {
         .replace(/\s+/g, '_');
     return normalized.length > 0 ? normalized : 'untitled';
 }
+const CRON_MONTH_ALIASES = {
+    JAN: 1,
+    FEB: 2,
+    MAR: 3,
+    APR: 4,
+    MAY: 5,
+    JUN: 6,
+    JUL: 7,
+    AUG: 8,
+    SEP: 9,
+    OCT: 10,
+    NOV: 11,
+    DEC: 12,
+};
+const CRON_DAY_ALIASES = {
+    SUN: 0,
+    MON: 1,
+    TUE: 2,
+    WED: 3,
+    THU: 4,
+    FRI: 5,
+    SAT: 6,
+};
+export function normalizeCron(value) {
+    return value.trim().replace(/\s+/g, ' ');
+}
+function cronFieldIsValid(field, min, max, aliases = {}) {
+    return field.split(',').every((part) => {
+        if (part === '*') {
+            return true;
+        }
+        const [rangePart, step, ...extraStepParts] = part.split('/');
+        if (extraStepParts.length > 0 || !rangePart || (step !== undefined && (!/^\d+$/.test(step) || Number(step) <= 0))) {
+            return false;
+        }
+        if (rangePart === '*') {
+            return true;
+        }
+        const rangeMatch = rangePart.match(/^([A-Z0-9]+)(-([A-Z0-9]+))?$/i);
+        if (!rangeMatch) {
+            return false;
+        }
+        const startRaw = rangeMatch[1].toUpperCase();
+        const endRaw = rangeMatch[3] ? rangeMatch[3].toUpperCase() : startRaw;
+        const start = aliases[startRaw] ?? Number(startRaw);
+        const end = aliases[endRaw] ?? Number(endRaw);
+        return Number.isInteger(start) && Number.isInteger(end)
+            && start >= min && end <= max && start <= end;
+    });
+}
+export function isValidNormalizedCron(value) {
+    if (value !== normalizeCron(value)) {
+        return false;
+    }
+    const fields = value.split(' ');
+    if (fields.length !== 5) {
+        return false;
+    }
+    return cronFieldIsValid(fields[0], 0, 59)
+        && cronFieldIsValid(fields[1], 0, 23)
+        && cronFieldIsValid(fields[2], 1, 31)
+        && cronFieldIsValid(fields[3], 1, 12, CRON_MONTH_ALIASES)
+        && cronFieldIsValid(fields[4], 0, 6, CRON_DAY_ALIASES);
+}
 export function readJsonFile(filePath) {
     const raw = fs.readFileSync(filePath, 'utf8');
     return raw.trim() ? JSON.parse(raw) : {};

package/dist/src/workspace-component.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentRecord } from './types.ts';
+export declare function hydrateWorkspaceComponentElementDetails<T extends ComponentRecord>(manifestPath: string, component: T, preferredExtension?: string): T;

package/dist/src/workspace-component.js

@@ -0,0 +1,34 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function hydrateWorkspaceComponentElementDetails(manifestPath, component, preferredExtension) {
+    const componentDirectory = path.dirname(manifestPath);
+    const detailDirectories = [
+        path.join(componentDirectory, 'elements'),
+        path.join(componentDirectory, 'details'),
+    ];
+    return {
+        ...component,
+        elements: (component.elements || []).map((element) => {
+            let details = typeof element.details === 'string' ? element.details : '';
+            for (const detailDirectory of detailDirectories) {
+                if (!fs.existsSync(detailDirectory)) {
+                    continue;
+                }
+                const preferredPath = preferredExtension
+                    ? path.join(detailDirectory, `${element.order}_${element.key}.${preferredExtension}`)
+                    : '';
+                if (preferredPath && fs.existsSync(preferredPath)) {
+                    details = fs.readFileSync(preferredPath, 'utf8');
+                    break;
+                }
+                const prefix = `${element.order}_${element.key}.`;
+                const detailFile = fs.readdirSync(detailDirectory).sort().find((entry) => entry.startsWith(prefix));
+                if (detailFile) {
+                    details = fs.readFileSync(path.join(detailDirectory, detailFile), 'utf8');
+                    break;
+                }
+            }
+            return { ...element, details };
+        }),
+    };
+}

package/dist/src/workspace-resource.d.ts

@@ -0,0 +1,2 @@
+/** Replace one resource directory only after its replacement is fully written. */
+export declare function replaceWorkspaceResourceDirectory(root: string, directory: string, populate: (stagingDirectory: string) => void): void;

package/dist/src/workspace-resource.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/** Replace one resource directory only after its replacement is fully written. */
+export function replaceWorkspaceResourceDirectory(root, directory, populate) {
+    const resolvedRoot = path.resolve(root);
+    const resolvedDirectory = path.resolve(directory);
+    const relative = path.relative(resolvedRoot, resolvedDirectory);
+    if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error(`Resource directory must be inside workspace root: ${directory}`);
+    }
+    // Never replace a symlink or write through a symlink in the selected path.
+    for (let current = resolvedDirectory;; current = path.dirname(current)) {
+        if (fs.lstatSync(current, { throwIfNoEntry: false })?.isSymbolicLink()) {
+            throw new Error(`Cannot replace a resource through a symbolic link: ${current}`);
+        }
+        if (current === resolvedRoot) {
+            break;
+        }
+    }
+    const parent = path.dirname(resolvedDirectory);
+    fs.mkdirSync(parent, { recursive: true });
+    const transaction = fs.mkdtempSync(path.join(parent, '.revo-pull-'));
+    const staged = path.join(transaction, 'new');
+    const backup = path.join(transaction, 'previous');
+    fs.mkdirSync(staged);
+    let backedUp = false;
+    let installed = false;
+    try {
+        populate(staged);
+        if (fs.existsSync(resolvedDirectory)) {
+            fs.renameSync(resolvedDirectory, backup);
+            backedUp = true;
+        }
+        try {
+            fs.renameSync(staged, resolvedDirectory);
+            installed = true;
+        }
+        catch (error) {
+            if (backedUp) {
+                fs.renameSync(backup, resolvedDirectory);
+                backedUp = false;
+            }
+            throw error;
+        }
+    }
+    finally {
+        // Keep the backup if restoring the original directory itself failed.
+        if (installed || !backedUp) {
+            fs.rmSync(transaction, { recursive: true, force: true });
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revoengine/cli",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "CLI package for the RevoEngine Platform API",
   "type": "module",
   "main": "dist/src/index.js",
@@ -9,8 +9,9 @@
     "revoengine": "dist/bin/revo.js"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "check": "node --input-type=module -e \"await import('./src/config.ts'); await import('./src/legacy.ts'); await import('./src/client.ts'); await import('./src/component-lock.ts'); await import('./src/ui.ts'); await import('./src/update-notifier.ts'); await import('./src/commands/auth.ts'); await import('./src/commands/component.ts'); await import('./src/commands/endpoints.ts'); await import('./src/commands/info.ts'); await import('./src/commands/request.ts'); await import('./src/commands/search.ts'); await import('./src/cli.ts'); await import('./src/index.ts'); await import('./bin/revo.ts'); await import('./scripts/dev.ts')\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "clean": "node --input-type=module -e \"import fs from 'node:fs'; fs.rmSync('dist', { recursive: true, force: true });\"",
+    "check": "node --input-type=module -e \"await import('./src/config.ts'); await import('./src/legacy.ts'); await import('./src/client.ts'); await import('./src/component-lock.ts'); await import('./src/resource-metadata.ts'); await import('./src/tracked-resources.ts'); await import('./src/metadata-backfill.ts'); await import('./src/workspace-component.ts'); await import('./src/workspace-resource.ts'); await import('./src/resource-syncs/database-schema-sync.ts'); await import('./src/resource-syncs/database-view-sync.ts'); await import('./src/resource-syncs/endpoint-sync.ts'); await import('./src/resource-syncs/group-sync.ts'); await import('./src/resource-syncs/role-group-sync.ts'); await import('./src/resource-syncs/job-template-sync.ts'); await import('./src/resource-syncs/schedule-sync.ts'); await import('./src/resource-syncs/event-sync.ts'); await import('./src/sync-output.ts'); await import('./src/ui.ts'); await import('./src/update-notifier.ts'); await import('./src/env-sync.ts'); await import('./src/commands/auth.ts'); await import('./src/commands/component.ts'); await import('./src/commands/database-schemas.ts'); await import('./src/commands/database-views.ts'); await import('./src/commands/endpoints.ts'); await import('./src/commands/env.ts'); await import('./src/commands/events.ts'); await import('./src/commands/groups.ts'); await import('./src/commands/info.ts'); await import('./src/commands/job-templates.ts'); await import('./src/commands/metadata.ts'); await import('./src/commands/request.ts'); await import('./src/commands/role-groups.ts'); await import('./src/commands/search.ts'); await import('./src/commands/schedules.ts'); await import('./src/commands/terminal-service.ts'); await import('./src/commands/terminal.ts'); await import('./src/cli.ts'); await import('./src/index.ts'); await import('./bin/revo.ts'); await import('./scripts/dev.ts')\"",
     "dev": "node ./scripts/dev.ts",
     "prepack": "npm run build",
     "test": "node --test ./test/*.test.ts"
@@ -25,8 +26,12 @@
     "node": ">=24"
   },
   "license": "MIT",
+  "dependencies": {
+    "ws": "^8.19.0"
+  },
   "devDependencies": {
     "@types/node": "^25.5.0",
+    "@types/ws": "^8.18.1",
     "typescript": "^6.0.3"
   }
 }