veryfront 0.1.91 → 0.1.92

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.91",
+    "version": "0.1.92",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/config/environment-config.js

@@ -91,7 +91,7 @@ function readEnvSnapshot() {
         v8MaxOldSpaceSize: v8MaxOldSpaceSizeRaw
             ? parseNumber(v8MaxOldSpaceSizeRaw, 0) || undefined
             : undefined,
-        veryfrontVersion: getEnv("VERYFRONT_VERSION") || undefined,
+        veryfrontVersion: getEnv("VERYFRONT_VERSION") || getEnv("RELEASE_VERSION") || undefined,
     };
 }
 export function initEnvironmentConfig() {

package/esm/src/jobs/schemas.d.ts

@@ -510,7 +510,7 @@ export declare const JobSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
     environment_id: z.ZodNullable<z.ZodString>;
-    branch_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    branch_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cron_job_id: z.ZodNullable<z.ZodString>;
     batch_id: z.ZodNullable<z.ZodString>;
     name: z.ZodString;
@@ -527,7 +527,7 @@ export declare const JobSchema: z.ZodObject<{
     created_at: z.ZodString;
     updated_at: z.ZodString;
 } & {
-    failed_reason: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    failed_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     kind: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodEnum<["knowledge_ingest"]>>>>;
     failure_detail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     result_summary: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -760,7 +760,6 @@ export declare const JobSchema: z.ZodObject<{
     config: Record<string, unknown>;
     name: string;
     project_id: string;
-    branch_id: string | null;
     batch_id: string | null;
     kind: "knowledge_ingest" | null;
     id: string;
@@ -820,7 +819,6 @@ export declare const JobSchema: z.ZodObject<{
     backoff_limit: number;
     completed_at: string | null;
     created_by: string | null;
-    failed_reason: string | null;
     failure_detail: string | null;
     result_summary: {
         kind: "knowledge_ingest";
@@ -835,6 +833,8 @@ export declare const JobSchema: z.ZodObject<{
         kind: "artifacts";
         artifact_count: number;
     } | null;
+    branch_id?: string | null | undefined;
+    failed_reason?: string | null | undefined;
 }, {
     status: "failed" | "completed" | "canceled" | "submitted" | "working";
     config: Record<string, unknown>;
@@ -920,7 +920,7 @@ export declare const JobListItemSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
     environment_id: z.ZodNullable<z.ZodString>;
-    branch_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    branch_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cron_job_id: z.ZodNullable<z.ZodString>;
     batch_id: z.ZodNullable<z.ZodString>;
     name: z.ZodString;
@@ -981,7 +981,6 @@ export declare const JobListItemSchema: z.ZodObject<{
     config: Record<string, unknown>;
     name: string;
     project_id: string;
-    branch_id: string | null;
     batch_id: string | null;
     kind: "knowledge_ingest" | null;
     id: string;
@@ -1011,6 +1010,7 @@ export declare const JobListItemSchema: z.ZodObject<{
         kind: "artifacts";
         artifact_count: number;
     } | null;
+    branch_id?: string | null | undefined;
 }, {
     status: "failed" | "completed" | "canceled" | "submitted" | "working";
     config: Record<string, unknown>;
@@ -1052,7 +1052,7 @@ export declare const PaginatedJobsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
         environment_id: z.ZodNullable<z.ZodString>;
-        branch_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        branch_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         cron_job_id: z.ZodNullable<z.ZodString>;
         batch_id: z.ZodNullable<z.ZodString>;
         name: z.ZodString;
@@ -1113,7 +1113,6 @@ export declare const PaginatedJobsResponseSchema: z.ZodObject<{
         config: Record<string, unknown>;
         name: string;
         project_id: string;
-        branch_id: string | null;
         batch_id: string | null;
         kind: "knowledge_ingest" | null;
         id: string;
@@ -1143,6 +1142,7 @@ export declare const PaginatedJobsResponseSchema: z.ZodObject<{
             kind: "artifacts";
             artifact_count: number;
         } | null;
+        branch_id?: string | null | undefined;
     }, {
         status: "failed" | "completed" | "canceled" | "submitted" | "working";
         config: Record<string, unknown>;
@@ -1201,7 +1201,6 @@ export declare const PaginatedJobsResponseSchema: z.ZodObject<{
         config: Record<string, unknown>;
         name: string;
         project_id: string;
-        branch_id: string | null;
         batch_id: string | null;
         kind: "knowledge_ingest" | null;
         id: string;
@@ -1231,6 +1230,7 @@ export declare const PaginatedJobsResponseSchema: z.ZodObject<{
             kind: "artifacts";
             artifact_count: number;
         } | null;
+        branch_id?: string | null | undefined;
     }[];
     page_info: {
         self: string | null;
@@ -2054,7 +2054,7 @@ export declare const CronJobSchema: z.ZodObject<{
     id: z.ZodString;
     project_id: z.ZodString;
     environment_id: z.ZodNullable<z.ZodString>;
-    branch_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    branch_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     status: z.ZodEnum<["active", "paused", "deleting"]>;
     target: z.ZodString;
@@ -2074,7 +2074,6 @@ export declare const CronJobSchema: z.ZodObject<{
     config: Record<string, unknown>;
     name: string;
     project_id: string;
-    branch_id: string | null;
     id: string;
     updated_at: string;
     created_at: string;
@@ -2088,6 +2087,7 @@ export declare const CronJobSchema: z.ZodObject<{
     concurrency_policy: string;
     last_scheduled_at: string | null;
     last_successful_at: string | null;
+    branch_id?: string | null | undefined;
 }, {
     status: "deleting" | "active" | "paused";
     config: Record<string, unknown>;
@@ -2113,7 +2113,7 @@ export declare const PaginatedCronJobsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         project_id: z.ZodString;
         environment_id: z.ZodNullable<z.ZodString>;
-        branch_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        branch_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         status: z.ZodEnum<["active", "paused", "deleting"]>;
         target: z.ZodString;
@@ -2133,7 +2133,6 @@ export declare const PaginatedCronJobsResponseSchema: z.ZodObject<{
         config: Record<string, unknown>;
         name: string;
         project_id: string;
-        branch_id: string | null;
         id: string;
         updated_at: string;
         created_at: string;
@@ -2147,6 +2146,7 @@ export declare const PaginatedCronJobsResponseSchema: z.ZodObject<{
         concurrency_policy: string;
         last_scheduled_at: string | null;
         last_successful_at: string | null;
+        branch_id?: string | null | undefined;
     }, {
         status: "deleting" | "active" | "paused";
         config: Record<string, unknown>;
@@ -2189,7 +2189,6 @@ export declare const PaginatedCronJobsResponseSchema: z.ZodObject<{
         config: Record<string, unknown>;
         name: string;
         project_id: string;
-        branch_id: string | null;
         id: string;
         updated_at: string;
         created_at: string;
@@ -2203,6 +2202,7 @@ export declare const PaginatedCronJobsResponseSchema: z.ZodObject<{
         concurrency_policy: string;
         last_scheduled_at: string | null;
         last_successful_at: string | null;
+        branch_id?: string | null | undefined;
     }[];
     page_info: {
         self: string | null;

package/esm/src/jobs/schemas.js

@@ -101,7 +101,7 @@ const BaseJobSchema = z.object({
     id: z.string().uuid(),
     project_id: z.string().uuid(),
     environment_id: z.string().uuid().nullable(),
-    branch_id: z.string().nullable().optional().default(null),
+    branch_id: z.string().nullable().optional(),
     cron_job_id: z.string().uuid().nullable(),
     batch_id: z.string().uuid().nullable(),
     name: z.string(),
@@ -119,7 +119,7 @@ const BaseJobSchema = z.object({
     updated_at: z.string(),
 });
 export const JobSchema = BaseJobSchema.extend({
-    failed_reason: z.string().nullable().optional().default(null),
+    failed_reason: z.string().nullable().optional(),
     kind: JobKindSchema.optional().default(null),
     failure_detail: z.string().nullable().optional().default(null),
     result_summary: JobResultSummarySchema.optional().default(null),
@@ -214,7 +214,7 @@ export const CronJobSchema = z.object({
     id: z.string().uuid(),
     project_id: z.string().uuid(),
     environment_id: z.string().uuid().nullable(),
-    branch_id: z.string().nullable().optional().default(null),
+    branch_id: z.string().nullable().optional(),
     name: z.string(),
     status: CronJobStatusSchema,
     target: z.string(),

package/esm/src/observability/metrics/manager.js

@@ -6,7 +6,7 @@ import { serverLogger } from "../../utils/index.js";
 import { loadConfig } from "./config.js";
 import { initializeInstruments } from "../instruments/index.js";
 import { MetricsRecorder } from "./recorder.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 const logger = serverLogger.component("metrics");
 /**
  * Metrics manager class
@@ -68,7 +68,7 @@ export class MetricsManager {
         }
         try {
             this.api = await import("@opentelemetry/api");
-            this.meter = this.api.metrics.getMeter(finalConfig.prefix, VERSION);
+            this.meter = this.api.metrics.getMeter(finalConfig.prefix, RUNTIME_VERSION);
             this.instruments = initializeInstruments(this.meter, finalConfig, this.runtimeState);
             this.recorder.instruments = this.instruments;
             logger.info("OpenTelemetry metrics initialized", {

package/esm/src/observability/tracing/otlp-setup.js

@@ -1,6 +1,6 @@
 import { getOtelTracingConfig } from "../../config/env.js";
 import { serverLogger } from "../../utils/index.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 const logger = serverLogger.component("otel");
 let initialized = false;
 let tracerProvider = null;
@@ -76,7 +76,7 @@ export async function initializeOTLP() {
         const { AsyncLocalStorageContextManager } = await import("@opentelemetry/context-async-hooks");
         const resource = new Resource({
             [ATTR_SERVICE_NAME]: config.serviceName,
-            [ATTR_SERVICE_VERSION]: VERSION,
+            [ATTR_SERVICE_VERSION]: RUNTIME_VERSION,
         });
         const endpointBase = config.endpoint.replace(/\/$/, "");
         const exporter = new OTLPTraceExporter({

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts

@@ -32,6 +32,7 @@ export declare class VeryfrontFSAdapter implements FSAdapter {
     constructor(config: FSAdapterConfig);
     initialize(): Promise<void>;
     private isPersistentCacheInvalidated;
+    private shouldBackgroundPregenerateStyles;
     private scheduleFileListWarmup;
     getPokeMetrics(): {
         received: number;

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,SAAS,EACT,eAAe,EAEf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AA2BnE,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAE5B,kFAAkF;IAClF,OAAO,CAAC,oBAAoB,CAA6B;IACzD,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,SAAS,CAAmB;IAEpC,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAAuB;IAE5C,+CAA+C;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,iGAAiG;IACjG,OAAO,CAAC,cAAc,CAAuC;IAC7D,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,eAAe;IA2L7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8IjC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,sBAAsB;IA0E9B,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAIK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKhD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzB,OAAO,IAAI,IAAI;IAYf,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,OAAO,GAAG,SAAS;IAI/B,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoC7E,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAYpD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWrD,0BAA0B,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IA0BvD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK7C,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,IAAI;IAK1B,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAoCxD,iBAAiB,IAAI,sBAAsB,GAAG,IAAI;IAWlD,SAAS,IAAI,kBAAkB;YAIjB,iBAAiB;IAK/B;;;;;OAKG;YACW,uBAAuB;CAkEtC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}

package/esm/src/platform/adapters/fs/veryfront/adapter.js

@@ -246,10 +246,10 @@ export class VeryfrontFSAdapter {
                 sourceFiles: fileSummary.sourceFiles,
                 sourceFilesWithContent: fileSummary.sourceFilesWithContent,
             });
-            // Trigger CSS pre-generation after the initial file snapshot is ready.
-            // This keeps stylesheet generation off the first styles request for both
-            // preview branches and published content.
-            if (fileSummary.sourceFilesWithContent > 0) {
+            // Trigger CSS pre-generation after the initial file snapshot is ready for
+            // published contexts. Branch previews should first try remote metadata
+            // recovery on cold starts instead of repopulating the prepared cache here.
+            if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
                 this.triggerCSSPregeneration(files).catch(() => {
                     // Error already logged in triggerCSSPregeneration
                 });
@@ -293,6 +293,12 @@ export class VeryfrontFSAdapter {
     isPersistentCacheInvalidated(prefix) {
         return isPrefixBeingInvalidated(prefix);
     }
+    shouldBackgroundPregenerateStyles() {
+        // Branch previews should recover the last registered stylesheet artifact on
+        // cold starts before rebuilding CSS locally. Live edit pokes still
+        // pregenerate through the WebSocket path after branch content changes.
+        return this.contentContext?.sourceType !== "branch";
+    }
     scheduleFileListWarmup(reason, cacheKey) {
         if (!this.initialized || !this.contentContext)
             return;
@@ -328,7 +334,7 @@ export class VeryfrontFSAdapter {
                 const files = await fetchFileListForContext(this.client, warmupContext);
                 await this.cache.setAsync(effectiveCacheKey, files);
                 const fileSummary = summarizeFileList(files);
-                if (fileSummary.sourceFilesWithContent > 0) {
+                if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
                     this.triggerCSSPregeneration(files).catch(() => {
                         // Error already logged in triggerCSSPregeneration
                     });

package/esm/src/proxy/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/logger.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AAaD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA+N3D,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,GAAG;IA0CX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAmB/E;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAG1D;AAED,cAAM,gBAAgB;IAElB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;gBADZ,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAG/C,OAAO,CAAC,KAAK;IAIb,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAwB/E,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAG1D;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/logger.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAEH;AASD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA+N3D,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,GAAG;IA0CX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAmB/E;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAG1D;AAED,cAAM,gBAAgB;IAElB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;gBADZ,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAG/C,OAAO,CAAC,KAAK;IAIb,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAwB/E,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAG1D;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/esm/src/proxy/logger.js

@@ -1,9 +1,8 @@
-// Import version from root deno.json (the source of truth)
 import * as dntShim from "../../_dnt.shims.js";
-import denoConfig from "../../deno.js";
 import { getEnv } from "./env.js";
 import { getTraceContext } from "./tracing.js";
 import { AsyncLocalStorage } from "node:async_hooks";
+import { PROXY_RUNTIME_VERSION } from "./version.js";
 const requestContextStore = new AsyncLocalStorage();
 /**
  * Run a function with proxy request context.
@@ -18,9 +17,6 @@ export function runWithProxyRequestContext(context, fn) {
 function getProxyRequestContext() {
     return requestContextStore.getStore();
 }
-// Get version from environment variable or root deno.json
-const VERYFRONT_VERSION = getEnv("VERYFRONT_VERSION") ??
-    (typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0");
 const LOG_LEVEL_ORDER = {
     debug: 0,
     info: 1,
@@ -208,7 +204,7 @@ class ProxyLogger {
             timestamp: new Date().toISOString(),
             level,
             service: "proxy",
-            veryfrontVersion: VERYFRONT_VERSION,
+            veryfrontVersion: PROXY_RUNTIME_VERSION,
             message,
             ...(traceCtx.traceId && { traceId: traceCtx.traceId, spanId: traceCtx.spanId }),
             // Include request context fields at top level (like renderer logs)

package/esm/src/proxy/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAU,MAAM,oBAAoB,CAAC;AAiEhE,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyD5D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,GAAG,SAAS,CAgB5E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAgB5D;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,OAAO,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAiBvF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAGrF;AAWD,wBAAgB,eAAe,IAAI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CA0BZ"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAU,MAAM,oBAAoB,CAAC;AA6DhE,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyD5D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,GAAG,SAAS,CAgB5E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAgB5D;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,OAAO,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAiBvF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAGrF;AAWD,wBAAgB,eAAe,IAAI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/esm/src/proxy/tracing.js

@@ -1,9 +1,6 @@
-import denoConfig from "../../deno.js";
 import { getEnv } from "./env.js";
 import { proxyLogger } from "./logger.js";
-// Get version from environment variable or root deno.json
-const VERYFRONT_VERSION = getEnv("VERYFRONT_VERSION") ??
-    (typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0");
+import { PROXY_RUNTIME_VERSION } from "./version.js";
 let initialized = false;
 let tracerProvider = null;
 let tracer = null;
@@ -72,7 +69,7 @@ export async function initializeOTLPWithApis() {
         const resourceAttrs = parseResourceAttributes(getEnv("OTEL_RESOURCE_ATTRIBUTES"));
         const resource = new Resource({
             [ATTR_SERVICE_NAME]: config.serviceName,
-            [ATTR_SERVICE_VERSION]: VERYFRONT_VERSION,
+            [ATTR_SERVICE_VERSION]: PROXY_RUNTIME_VERSION,
             ...resourceAttrs,
         });
         const exporter = new OTLPTraceExporter({

package/esm/src/proxy/version.d.ts

@@ -0,0 +1,2 @@
+export declare const PROXY_RUNTIME_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/esm/src/proxy/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/version.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,qBAAqB,QAIzB,CAAC"}

package/esm/src/proxy/version.js

@@ -0,0 +1,18 @@
+import denoConfig from "../../deno.js";
+import { getEnv } from "./env.js";
+function normalizeVersion(version) {
+    if (!version)
+        return undefined;
+    return version.replace(/^v(?=\d)/, "");
+}
+function getVersionEnv(name) {
+    try {
+        return getEnv(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+export const PROXY_RUNTIME_VERSION = normalizeVersion(getVersionEnv("VERYFRONT_VERSION") ?? getVersionEnv("RELEASE_VERSION")) ??
+    normalizeVersion(typeof denoConfig.version === "string" ? denoConfig.version : undefined) ??
+    "0.0.0";

package/esm/src/server/handlers/monitoring/health.handler.js

@@ -2,7 +2,7 @@ import { BaseHandler } from "../response/base.js";
 import { joinPath } from "../../../utils/path-utils.js";
 import { HTTP_OK, HTTP_UNAVAILABLE, PRIORITY_HIGH } from "../../../utils/constants/index.js";
 import { isTracingDegraded, isTracingEnabled } from "../../../observability/tracing/index.js";
-import { VERSION } from "../../../utils/version.js";
+import { RUNTIME_VERSION } from "../../../utils/version.js";
 let serverInitialized = false;
 export function setServerInitialized(ready) {
     serverInitialized = ready;
@@ -57,7 +57,7 @@ export class HealthHandler extends BaseHandler {
             status: tracingDegraded ? "degraded" : "ok",
             timestamp: new Date().toISOString(),
             mode: hasStaticBuild ? "static+ssr" : "ssr",
-            version: VERSION,
+            version: RUNTIME_VERSION,
             tracing: {
                 enabled: isTracingEnabled(),
                 degraded: tracingDegraded,

package/esm/src/utils/logger/logger.js

@@ -1,7 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { getEnv } from "../../platform/compat/process.js";
 import { hasDenoRuntime, hasNodeProcess } from "../runtime-guards.js";
-import { VERSION } from "../version.js";
+import { RUNTIME_VERSION } from "../version.js";
 import { ANSI, colorize, formatContextText, formatTimestamp, LEVEL_COLORS, LEVEL_GLYPHS, padTag, serializeError, } from "./core.js";
 export var LogLevel;
 (function (LogLevel) {
@@ -165,7 +165,7 @@ class ConsoleLogger {
             timestamp: new Date().toISOString(),
             level,
             service: this.prefix.toLowerCase(),
-            veryfrontVersion: VERSION,
+            veryfrontVersion: RUNTIME_VERSION,
             message,
         };
         if (this.componentName)

package/esm/src/utils/version.d.ts

@@ -1,4 +1,12 @@
-export declare const VERSION = "0.1.89";
+export declare const VERSION = "0.1.92";
+export declare function normalizeVeryfrontVersion(version: string | undefined): string | undefined;
+export declare function resolveRuntimeVersion(options?: {
+    veryfrontVersion?: string;
+    releaseVersion?: string;
+    denoVersion?: string;
+    fallbackVersion?: string;
+}): string;
+export declare const RUNTIME_VERSION: string;
 export declare const SERVER_START_TIME: number;
 export interface BuildVersion {
     framework: string;

package/esm/src/utils/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGzF;AAUD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAKd;AAED,eAAO,MAAM,eAAe,QAK1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}

package/esm/src/utils/version.js

@@ -1,10 +1,37 @@
+import denoConfig from "../../deno.js";
+import { getEnv } from "../platform/compat/process.js";
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.89";
+export const VERSION = "0.1.92";
+export function normalizeVeryfrontVersion(version) {
+    if (!version)
+        return undefined;
+    return version.replace(/^v(?=\d)/, "");
+}
+function getVersionEnv(name) {
+    try {
+        return getEnv(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveRuntimeVersion(options = {}) {
+    return normalizeVeryfrontVersion(options.veryfrontVersion ?? options.releaseVersion) ??
+        normalizeVeryfrontVersion(options.denoVersion) ??
+        options.fallbackVersion ??
+        VERSION;
+}
+export const RUNTIME_VERSION = resolveRuntimeVersion({
+    veryfrontVersion: getVersionEnv("VERYFRONT_VERSION"),
+    releaseVersion: getVersionEnv("RELEASE_VERSION"),
+    denoVersion: typeof denoConfig.version === "string" ? denoConfig.version : undefined,
+    fallbackVersion: VERSION,
+});
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {
-        framework: VERSION,
+        framework: RUNTIME_VERSION,
         serverStart: SERVER_START_TIME,
         projectUpdated: projectUpdatedAt,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.91",
+  "version": "0.1.92",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.91",
+  "version": "0.1.92",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/config/environment-config.ts

@@ -188,7 +188,7 @@ function readEnvSnapshot(): EnvironmentConfig {
       ? parseNumber(v8MaxOldSpaceSizeRaw, 0) || undefined
       : undefined,
 
-    veryfrontVersion: getEnv("VERYFRONT_VERSION") || undefined,
+    veryfrontVersion: getEnv("VERYFRONT_VERSION") || getEnv("RELEASE_VERSION") || undefined,
   };
 }
 

package/src/src/jobs/schemas.ts

@@ -115,7 +115,7 @@ const BaseJobSchema = z.object({
   id: z.string().uuid(),
   project_id: z.string().uuid(),
   environment_id: z.string().uuid().nullable(),
-  branch_id: z.string().nullable().optional().default(null),
+  branch_id: z.string().nullable().optional(),
   cron_job_id: z.string().uuid().nullable(),
   batch_id: z.string().uuid().nullable(),
   name: z.string(),
@@ -134,7 +134,7 @@ const BaseJobSchema = z.object({
 });
 
 export const JobSchema = BaseJobSchema.extend({
-  failed_reason: z.string().nullable().optional().default(null),
+  failed_reason: z.string().nullable().optional(),
   kind: JobKindSchema.optional().default(null),
   failure_detail: z.string().nullable().optional().default(null),
   result_summary: JobResultSummarySchema.optional().default(null),
@@ -242,7 +242,7 @@ export const CronJobSchema = z.object({
   id: z.string().uuid(),
   project_id: z.string().uuid(),
   environment_id: z.string().uuid().nullable(),
-  branch_id: z.string().nullable().optional().default(null),
+  branch_id: z.string().nullable().optional(),
   name: z.string(),
   status: CronJobStatusSchema,
   target: z.string(),

package/src/src/observability/metrics/manager.ts

@@ -10,7 +10,7 @@ import { loadConfig } from "./config.js";
 import { initializeInstruments } from "../instruments/index.js";
 import { MetricsRecorder } from "./recorder.js";
 import type { MetricsConfig, MetricsInstruments, OpenTelemetryAPI, RuntimeState } from "./types.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 
 const logger = serverLogger.component("metrics");
 
@@ -80,7 +80,7 @@ export class MetricsManager {
 
     try {
       this.api = await import("@opentelemetry/api");
-      this.meter = this.api.metrics.getMeter(finalConfig.prefix, VERSION);
+      this.meter = this.api.metrics.getMeter(finalConfig.prefix, RUNTIME_VERSION);
 
       this.instruments = initializeInstruments(this.meter, finalConfig, this.runtimeState);
       this.recorder.instruments = this.instruments;

package/src/src/observability/tracing/otlp-setup.ts

@@ -13,7 +13,7 @@ import * as dntShim from "../../../_dnt.shims.js";
 
 import { getOtelTracingConfig } from "../../config/env.js";
 import { serverLogger } from "../../utils/index.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 
 const logger = serverLogger.component("otel");
 
@@ -118,7 +118,7 @@ export async function initializeOTLP(): Promise<void> {
 
     const resource = new Resource({
       [ATTR_SERVICE_NAME]: config.serviceName,
-      [ATTR_SERVICE_VERSION]: VERSION,
+      [ATTR_SERVICE_VERSION]: RUNTIME_VERSION,
     });
 
     const endpointBase = config.endpoint.replace(/\/$/, "");

package/src/src/platform/adapters/fs/veryfront/adapter.ts

@@ -350,10 +350,10 @@ export class VeryfrontFSAdapter implements FSAdapter {
         sourceFilesWithContent: fileSummary.sourceFilesWithContent,
       });
 
-      // Trigger CSS pre-generation after the initial file snapshot is ready.
-      // This keeps stylesheet generation off the first styles request for both
-      // preview branches and published content.
-      if (fileSummary.sourceFilesWithContent > 0) {
+      // Trigger CSS pre-generation after the initial file snapshot is ready for
+      // published contexts. Branch previews should first try remote metadata
+      // recovery on cold starts instead of repopulating the prepared cache here.
+      if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
         this.triggerCSSPregeneration(files).catch(() => {
           // Error already logged in triggerCSSPregeneration
         });
@@ -403,6 +403,13 @@ export class VeryfrontFSAdapter implements FSAdapter {
     return isPrefixBeingInvalidated(prefix);
   }
 
+  private shouldBackgroundPregenerateStyles(): boolean {
+    // Branch previews should recover the last registered stylesheet artifact on
+    // cold starts before rebuilding CSS locally. Live edit pokes still
+    // pregenerate through the WebSocket path after branch content changes.
+    return this.contentContext?.sourceType !== "branch";
+  }
+
   private scheduleFileListWarmup(reason: string, cacheKey?: string): void {
     if (!this.initialized || !this.contentContext) return;
 
@@ -446,7 +453,7 @@ export class VeryfrontFSAdapter implements FSAdapter {
         await this.cache.setAsync(effectiveCacheKey, files);
         const fileSummary = summarizeFileList(files);
 
-        if (fileSummary.sourceFilesWithContent > 0) {
+        if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
           this.triggerCSSPregeneration(files).catch(() => {
             // Error already logged in triggerCSSPregeneration
           });

package/src/src/proxy/logger.ts

@@ -1,10 +1,8 @@
-// Import version from root deno.json (the source of truth)
 import * as dntShim from "../../_dnt.shims.js";
-
-import denoConfig from "../../deno.js";
 import { getEnv } from "./env.js";
 import { getTraceContext } from "./tracing.js";
 import { AsyncLocalStorage } from "node:async_hooks";
+import { PROXY_RUNTIME_VERSION } from "./version.js";
 
 // NOTE: Formatting utilities are INLINED below instead of imported from ../utils/logger/core.ts
 // because the proxy Docker build only copies src/proxy/ and has no access to src/utils/.
@@ -45,10 +43,6 @@ function getProxyRequestContext(): ProxyRequestContext | undefined {
   return requestContextStore.getStore();
 }
 
-// Get version from environment variable or root deno.json
-const VERYFRONT_VERSION: string = getEnv("VERYFRONT_VERSION") ??
-  (typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0");
-
 export type LogLevel = "debug" | "info" | "warn" | "error";
 
 const LOG_LEVEL_ORDER: Record<LogLevel, number> = {
@@ -295,7 +289,7 @@ class ProxyLogger {
       timestamp: new Date().toISOString(),
       level,
       service: "proxy",
-      veryfrontVersion: VERYFRONT_VERSION,
+      veryfrontVersion: PROXY_RUNTIME_VERSION,
       message,
       ...(traceCtx.traceId && { traceId: traceCtx.traceId, spanId: traceCtx.spanId }),
       // Include request context fields at top level (like renderer logs)

package/src/src/proxy/tracing.ts

@@ -6,13 +6,9 @@ import * as dntShim from "../../_dnt.shims.js";
 
 
 import type { Context, Span, Tracer } from "@opentelemetry/api";
-import denoConfig from "../../deno.js";
 import { getEnv } from "./env.js";
 import { proxyLogger } from "./logger.js";
-
-// Get version from environment variable or root deno.json
-const VERYFRONT_VERSION: string = getEnv("VERYFRONT_VERSION") ??
-  (typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0");
+import { PROXY_RUNTIME_VERSION } from "./version.js";
 
 let initialized = false;
 let tracerProvider: { shutdown: () => Promise<void> } | null = null;
@@ -100,7 +96,7 @@ export async function initializeOTLPWithApis(): Promise<void> {
     const resourceAttrs = parseResourceAttributes(getEnv("OTEL_RESOURCE_ATTRIBUTES"));
     const resource = new Resource({
       [ATTR_SERVICE_NAME]: config.serviceName,
-      [ATTR_SERVICE_VERSION]: VERYFRONT_VERSION,
+      [ATTR_SERVICE_VERSION]: PROXY_RUNTIME_VERSION,
       ...resourceAttrs,
     });
 

package/src/src/proxy/version.ts

@@ -0,0 +1,21 @@
+import denoConfig from "../../deno.js";
+import { getEnv } from "./env.js";
+
+function normalizeVersion(version: string | undefined): string | undefined {
+  if (!version) return undefined;
+  return version.replace(/^v(?=\d)/, "");
+}
+
+function getVersionEnv(name: string): string | undefined {
+  try {
+    return getEnv(name);
+  } catch {
+    return undefined;
+  }
+}
+
+export const PROXY_RUNTIME_VERSION = normalizeVersion(
+  getVersionEnv("VERYFRONT_VERSION") ?? getVersionEnv("RELEASE_VERSION"),
+) ??
+  normalizeVersion(typeof denoConfig.version === "string" ? denoConfig.version : undefined) ??
+  "0.0.0";

package/src/src/server/handlers/monitoring/health.handler.ts

@@ -4,7 +4,7 @@ import type { HandlerContext, HandlerMetadata, HandlerPriority, HandlerResult }
 import { joinPath } from "../../../utils/path-utils.js";
 import { HTTP_OK, HTTP_UNAVAILABLE, PRIORITY_HIGH } from "../../../utils/constants/index.js";
 import { isTracingDegraded, isTracingEnabled } from "../../../observability/tracing/index.js";
-import { VERSION } from "../../../utils/version.js";
+import { RUNTIME_VERSION } from "../../../utils/version.js";
 
 let serverInitialized = false;
 
@@ -74,7 +74,7 @@ export class HealthHandler extends BaseHandler {
           status: tracingDegraded ? "degraded" : "ok",
           timestamp: new Date().toISOString(),
           mode: hasStaticBuild ? "static+ssr" : "ssr",
-          version: VERSION,
+          version: RUNTIME_VERSION,
           tracing: {
             enabled: isTracingEnabled(),
             degraded: tracingDegraded,

package/src/src/utils/logger/logger.ts

@@ -1,7 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { getEnv } from "../../platform/compat/process.js";
 import { hasDenoRuntime, hasNodeProcess } from "../runtime-guards.js";
-import { VERSION } from "../version.js";
+import { RUNTIME_VERSION } from "../version.js";
 import {
   ANSI,
   colorize,
@@ -287,7 +287,7 @@ class ConsoleLogger implements Logger {
       timestamp: new Date().toISOString(),
       level,
       service: this.prefix.toLowerCase(),
-      veryfrontVersion: VERSION,
+      veryfrontVersion: RUNTIME_VERSION,
       message,
     };
 

package/src/src/utils/version.ts

@@ -1,6 +1,41 @@
+import denoConfig from "../../deno.js";
+import { getEnv } from "../platform/compat/process.js";
+
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.89";
+export const VERSION = "0.1.92";
+
+export function normalizeVeryfrontVersion(version: string | undefined): string | undefined {
+  if (!version) return undefined;
+  return version.replace(/^v(?=\d)/, "");
+}
+
+function getVersionEnv(name: string): string | undefined {
+  try {
+    return getEnv(name);
+  } catch {
+    return undefined;
+  }
+}
+
+export function resolveRuntimeVersion(options: {
+  veryfrontVersion?: string;
+  releaseVersion?: string;
+  denoVersion?: string;
+  fallbackVersion?: string;
+} = {}): string {
+  return normalizeVeryfrontVersion(options.veryfrontVersion ?? options.releaseVersion) ??
+    normalizeVeryfrontVersion(options.denoVersion) ??
+    options.fallbackVersion ??
+    VERSION;
+}
+
+export const RUNTIME_VERSION = resolveRuntimeVersion({
+  veryfrontVersion: getVersionEnv("VERYFRONT_VERSION"),
+  releaseVersion: getVersionEnv("RELEASE_VERSION"),
+  denoVersion: typeof denoConfig.version === "string" ? denoConfig.version : undefined,
+  fallbackVersion: VERSION,
+});
 
 export const SERVER_START_TIME: number = Date.now();
 
@@ -12,7 +47,7 @@ export interface BuildVersion {
 
 export function createBuildVersion(projectUpdatedAt?: string): BuildVersion {
   return {
-    framework: VERSION,
+    framework: RUNTIME_VERSION,
     serverStart: SERVER_START_TIME,
     projectUpdated: projectUpdatedAt,
   };