@celsian/vura-cli 0.5.7 → 0.5.10

package/README.md

@@ -6,7 +6,7 @@ CLI for [Vura](https://vura.io) — develop, build, and run tasks for Vura appli
 
 ## What it does
 
-`@celsian/vura-cli` provides the `vura` command for developing and building Vura projects. It scans routes, starts the Vite dev server with API middleware, bundles for production, lets you inspect runtime placement, and lets you run task routes by name from the terminal. `vura deploy` is reserved for the managed Vura Platform and intentionally fails closed in the OSS CLI — use an adapter (`adapter-lambda`, `adapter-cloudflare`) to self-host. The package was historically named `then`/`thenjs`; the only installed bin is `vura`.
+`@celsian/vura-cli` provides the `vura` command for developing, building, inspecting, and deploying Vura projects. It reports effective Function/Dedicated placement and pending Edge requests, including memory, CPU, timeout, provider recommendation, confidence, and reasons. `create-vura` installs the managed deployment adapter, so `vura deploy` works without a follow-up package install. Self-hosted builds can use the Lambda or Cloudflare adapters. The package was historically named `then`/`thenjs`; the only installed bin is `vura`.
 
 ## Install
 
@@ -44,6 +44,10 @@ vura routes inspect --json
 vura runtime advise --json
 ```
 
+An Edge declaration is a request, not an override. The CLI reports it as
+pending while the route continues on 1 GiB Function compute; only measured
+platform eligibility can promote it to the fixed 128 MiB Edge runtime.
+
 (`then` is a shell reserved word — use `vura` in all scripts.)
 
 ## Documentation

package/dist/commands/deploy.d.ts

@@ -1,8 +1,9 @@
 /**
  * `vura deploy` — deploy the built project to the Vura platform.
  *
- * Packages `dist/`, uploads it to the Vura API, streams build logs, and prints
- * the resulting deployment URL. The actual upload/poll flow lives in
+ * Packages `dist/` (plus runtime dependencies for Dedicated/server builds),
+ * uploads it to the Vura API, streams build logs, and prints the resulting
+ * deployment URL. The actual upload/poll flow lives in
  * `@celsian/vura-adapter-vura` (`deployToVura`) so the adapter's `buildEnd`
  * hook and this command share one implementation.
  *

package/dist/commands/deploy.js

@@ -1,8 +1,9 @@
 /**
  * `vura deploy` — deploy the built project to the Vura platform.
  *
- * Packages `dist/`, uploads it to the Vura API, streams build logs, and prints
- * the resulting deployment URL. The actual upload/poll flow lives in
+ * Packages `dist/` (plus runtime dependencies for Dedicated/server builds),
+ * uploads it to the Vura API, streams build logs, and prints the resulting
+ * deployment URL. The actual upload/poll flow lives in
  * `@celsian/vura-adapter-vura` (`deployToVura`) so the adapter's `buildEnd`
  * hook and this command share one implementation.
  *
@@ -92,6 +93,7 @@ export async function deployCommand(args) {
     try {
         const result = await deployToVura({
             distDir,
+            projectRoot,
             apiUrl,
             token,
             projectId,

package/dist/commands/runtime-profile.d.ts

@@ -1,4 +1,4 @@
-import type { ApiRoute, PageRoute, RouteManifest } from '@celsian/vura-core';
+import type { ApiRoute, ComputeClass, PageRoute, RouteManifest } from '@celsian/vura-core';
 export type RuntimeProfile = 'static' | 'cold' | 'hot' | 'streaming-hot' | 'task-cold' | 'cron-cold' | 'task-hot' | 'cron-hot';
 export interface RuntimeRouteInspection {
     type: 'api' | 'page';
@@ -10,6 +10,15 @@ export interface RuntimeRouteInspection {
     methods?: string[];
     schedule?: string;
     hasWebsocket?: boolean;
+    effectiveComputeClass?: 'function' | 'dedicated';
+    requestedComputeClass?: ComputeClass;
+    edgeEligibility?: 'pending';
+    memory?: string | number;
+    cpu?: number;
+    timeout?: number;
+    providerRecommendation?: 'elastic-function-provider' | 'dedicated-fly-machine' | 'cloudflare-workers-for-platforms';
+    confidence?: 'high' | 'medium';
+    reasons?: string[];
     warnings: string[];
     nextCommand?: string;
 }

package/dist/commands/runtime-profile.js

@@ -6,8 +6,74 @@ function configNumber(config, key) {
     const value = config[key];
     return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
 }
+function configObject(config, key) {
+    const value = config[key];
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function computeForRoute(route) {
+    return configObject(route.config, 'compute') ?? { class: route.kind === 'hot' ? 'dedicated' : 'function', memory: '1gb' };
+}
+function computeDetails(route) {
+    const compute = computeForRoute(route);
+    const effectiveComputeClass = compute.effectiveClass === 'dedicated' || compute.class === 'dedicated'
+        ? 'dedicated'
+        : 'function';
+    const requestedComputeClass = compute.class === 'edge' || compute.requestedClass === 'edge'
+        ? 'edge'
+        : effectiveComputeClass;
+    const effectiveMemory = compute.effectiveMemory ?? compute.memory;
+    const memory = typeof effectiveMemory === 'string' || typeof effectiveMemory === 'number'
+        ? effectiveMemory
+        : undefined;
+    const cpu = typeof compute.cpu === 'number' ? compute.cpu : undefined;
+    const timeout = configNumber(route.config, 'timeout');
+    const edgeEligibility = compute.edgeEligibility === 'pending' ? 'pending' : undefined;
+    if (requestedComputeClass === 'edge') {
+        return {
+            effectiveComputeClass,
+            requestedComputeClass,
+            edgeEligibility,
+            memory,
+            cpu,
+            timeout,
+            providerRecommendation: 'cloudflare-workers-for-platforms',
+            confidence: 'high',
+            reasons: [
+                'Edge is an optimization request and remains on Function until the platform marks this endpoint eligible from observed memory/runtime telemetry.',
+                'Edge has a fixed 128mb isolate ceiling; the safe fallback is Function at 1gb.',
+            ],
+        };
+    }
+    if (effectiveComputeClass === 'dedicated') {
+        return {
+            effectiveComputeClass,
+            requestedComputeClass,
+            memory,
+            cpu,
+            timeout,
+            providerRecommendation: 'dedicated-fly-machine',
+            confidence: 'high',
+            reasons: [route.hasWebsocket
+                    ? 'WebSocket upgrades require persistent Dedicated compute.'
+                    : 'The route explicitly requests persistent Dedicated compute.'],
+        };
+    }
+    return {
+        effectiveComputeClass,
+        requestedComputeClass,
+        memory,
+        cpu,
+        timeout,
+        providerRecommendation: 'elastic-function-provider',
+        confidence: 'medium',
+        reasons: ['Stateless endpoints and tasks default to scale-to-zero Function compute at 1gb.'],
+    };
+}
 function prefersHotTask(config) {
-    return ['runtime', 'placement', 'target'].some((key) => configString(config, key) === 'hot')
+    return configObject(config, 'compute')?.class === 'dedicated'
+        || ['runtime', 'placement', 'target'].some((key) => configString(config, key) === 'hot')
         || config.hot === true;
 }
 export function taskNameFromPattern(urlPattern) {
@@ -53,6 +119,10 @@ function inspectApiRoute(route) {
     if (route.hasWebsocket && route.kind !== 'hot') {
         warnings.push('WebSocket exports require kind: hot to be reachable.');
     }
+    const details = computeDetails(route);
+    if (details.requestedComputeClass === 'edge' && details.edgeEligibility === 'pending') {
+        warnings.push('Edge request is pending platform eligibility; effective runtime remains Function at 1gb.');
+    }
     const base = {
         type: 'api',
         pattern: route.urlPattern,
@@ -63,6 +133,7 @@ function inspectApiRoute(route) {
         methods: route.methods,
         schedule,
         hasWebsocket: Boolean(route.hasWebsocket),
+        ...details,
         warnings,
         nextCommand: route.kind === 'task'
             ? `vura tasks run ${taskNameFromPattern(route.urlPattern)}`
@@ -85,6 +156,7 @@ function inspectApiRoute(route) {
             methods: route.methods,
             schedule,
             hasWebsocket: false,
+            ...details,
             warnings: [],
             nextCommand: 'vura tasks list',
         },
@@ -140,6 +212,17 @@ export function adviseRuntime(manifest) {
         const currentProfile = profileForApiRoute(route);
         const schedule = configString(route.config, 'schedule');
         const timeout = configNumber(route.config, 'timeout');
+        const details = computeDetails(route);
+        if (details.requestedComputeClass === 'edge') {
+            advice.push({
+                pattern: route.urlPattern,
+                type: 'api',
+                currentProfile,
+                recommendation: currentProfile,
+                severity: 'warn',
+                reason: 'Edge request is pending measured platform eligibility; deploys continue on Function at 1gb until approved.',
+            });
+        }
         if (route.hasWebsocket) {
             advice.push({
                 pattern: route.urlPattern,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celsian/vura-cli",
-  "version": "0.5.7",
+  "version": "0.5.10",
   "description": "Vura CLI — build and deploy full-stack apps",
   "type": "module",
   "bin": {
@@ -15,12 +15,12 @@
     "!dist/**/*.map"
   ],
   "dependencies": {
-    "@celsian/vura-core": "0.5.7",
+    "@celsian/vura-core": "0.5.10",
     "esbuild": "^0.28.1",
     "what-framework": "^0.11.1"
   },
   "peerDependencies": {
-    "@celsian/vura-adapter-vura": "0.5.7",
+    "@celsian/vura-adapter-vura": "0.5.10",
     "ws": "^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -32,7 +32,7 @@
     }
   },
   "devDependencies": {
-    "@celsian/vura-adapter-vura": "0.5.7",
+    "@celsian/vura-adapter-vura": "0.5.10",
     "@types/ws": "^8.18.1",
     "ws": "^8.21.0"
   },