veryfront 0.1.1231 → 0.1.1233

package/README.md

@@ -10,6 +10,11 @@ Veryfront Code is a full-stack framework for building AI-powered applications an
 
 It gives you agents, tools, workflows, and a complete React rendering stack in a single framework. Veryfront Code runs on Node.js, Deno, and Bun, and can be deployed anywhere or shipped through the Veryfront platform with built-in preview environments and production hosting.
 
+Veryfront Code is an Apache-2.0 open-source framework that works standalone.
+Develop and evaluate locally, self-host in your own cloud or on-premises
+environment, or use Veryfront Cloud for managed platform services. A Veryfront
+account is not required for local development or self-hosting.
+
 <p align="center">
   <img src="./assets/banner.svg" alt="Veryfront" width="100%">
 </p>

package/esm/cli/app/actions.js

@@ -69,7 +69,7 @@ export function createLauncher(host) {
     }
     return {
         openInBrowser(project, port) {
-            return open(`http://${project.slug}.veryfront.me:${port}`, (url) => `Opened ${url}`);
+            return open(`http://${project.slug}.localhost:${port}`, (url) => `Opened ${url}`);
         },
         openInStudio(project) {
             return open(`https://veryfront.com/projects/${project.slug}`, () => `Opened Studio for ${project.slug}`);

package/esm/cli/app/shell.js

@@ -53,7 +53,7 @@ export function createApp(config) {
     state = setTemplates(TEMPLATES)(state);
     state = updateServer({
         port: config.port,
-        url: `http://veryfront.me:${config.port}`,
+        url: `http://localhost:${config.port}`,
     })(state);
     state = updateMCP({
         enabled: config.mcpPort !== undefined,
@@ -304,9 +304,9 @@ export function createApp(config) {
     function start() {
         running = true;
         if (!isInteractiveMode) {
-            console.log(`Server running on http://veryfront.me:${config.port}`);
+            console.log(`Server running on http://localhost:${config.port}`);
             if (config.mcpPort)
-                console.log(`MCP available at http://veryfront.me:${config.mcpPort}/mcp`);
+                console.log(`MCP available at http://localhost:${config.mcpPort}/mcp`);
             return;
         }
         write(screen.altOn + cursor.hide);

package/esm/cli/app/state.js

@@ -8,7 +8,7 @@ export function createInitialState() {
         previousView: null,
         server: {
             running: false,
-            url: "http://veryfront.me:8080",
+            url: "http://localhost:8080",
             port: 8080,
             errors: 0,
             warnings: 0,

package/esm/cli/app/views/dashboard.js

@@ -42,7 +42,7 @@ function hasRemoteProjects(state) {
 function renderStatus(state) {
     const lines = [`  ✓ Server ready at ${brand(state.server.url)}`];
     if (state.mcp.enabled && state.mcp.transport === "http" && state.mcp.httpPort !== undefined) {
-        lines.push(`  ✓ MCP ready at ${brand(`http://veryfront.me:${state.mcp.httpPort}/mcp`)}`);
+        lines.push(`  ✓ MCP ready at ${brand(`http://localhost:${state.mcp.httpPort}/mcp`)}`);
     }
     const { errors, warnings } = state.server;
     if (errors > 0 || warnings > 0) {

package/esm/cli/app/views/help.js

@@ -44,7 +44,7 @@ export function renderHelpView(state) {
         lines.push(`    ${dim('"mcpServers": {')}`);
         lines.push(`    ${dim('  "veryfront": {')}`);
         lines.push(`    ${dim('    "type": "url",')}`);
-        lines.push(`    ${dim(`    "url": "http://veryfront.me:${state.mcp.httpPort}/mcp"`)}`);
+        lines.push(`    ${dim(`    "url": "http://localhost:${state.mcp.httpPort}/mcp"`)}`);
         lines.push(`    ${dim("  }")}`);
         lines.push(`    ${dim("}")}`);
         lines.push("");

package/esm/cli/commands/deploy/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAoDxB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deploy/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAqDxB,CAAC"}

package/esm/cli/commands/deploy/command-help.js

@@ -49,5 +49,6 @@ export const deployHelp = {
         "With --project, promotes only: the working directory is never pushed, so the selected project directory's push receipt must already name that project",
         "Creates a new release from the resolved branch",
         "Verifies the target environment points to the created deployment before succeeding",
+        "Warns when only the environment's access gate answered the readiness probe, so the app itself was never observed serving",
     ],
 };

package/esm/cli/commands/deploy/command.js

@@ -101,13 +101,15 @@ async function deployCommandHuman(options) {
         progressText = next;
         spinner.update(next);
     };
-    let warning = null;
+    // Collected, not overwritten: a deploy can raise more than one warning, and
+    // the one an operator most needs is not reliably the last.
+    const warnings = [];
     let outcome;
     try {
         outcome = await deployRunner(options).execute(toDeployRequest(options), {
             onEvent(event) {
                 if (event.kind === "warning") {
-                    warning = event.message;
+                    warnings.push(event.message);
                     return;
                 }
                 updateProgress(deployProgressText(event, env, verbose));
@@ -145,8 +147,8 @@ async function deployCommandHuman(options) {
         logInfo(`  Source digest: ${result.sourceDigest}`);
         logInfo(`  Control plane: ${result.controlPlane}`);
     }
-    if (warning)
-        logWarning(warning);
+    for (const message of warnings)
+        logWarning(message);
     if (verbose) {
         const { getPostDeployTips } = await import("../../help/tips.js");
         console.log(getPostDeployTips());

package/esm/cli/commands/dev/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,OAAO,EAAE,WA0BrB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,OAAO,EAAE,WAqCrB,CAAC"}

package/esm/cli/commands/dev/command-help.js

@@ -6,7 +6,7 @@ export const devHelp = {
     options: [
         {
             flag: "--port <number>",
-            description: "Port to run on",
+            description: "Port to run on (also reads PORT env var)",
             default: "3000",
         },
         {
@@ -21,7 +21,18 @@ export const devHelp = {
     examples: [
         "veryfront dev",
         "veryfront dev --port 8080",
+        "PORT=3001 veryfront dev",
         "veryfront dev --open",
         "veryfront dev --no-hmr",
     ],
+    notes: [
+        "Port selection priority (highest to lowest):",
+        "  1. --port / -p flag",
+        "  2. PORT env var",
+        "  3. VERYFRONT_PORT env var",
+        "  4. Default: 3000",
+        "",
+        "When the requested port is taken, the server falls forward to the next",
+        "free port. Open the URL the CLI prints to reach the running server.",
+    ],
 };

package/esm/cli/commands/dev/command.d.ts

@@ -6,6 +6,14 @@ import { type RemoteProject } from "../../sync/index.js";
 import { type PushOptions } from "../push/index.js";
 export interface DevOptions {
     port: number;
+    /**
+     * True when the port was set explicitly by a `--port` / `-p` flag or by a
+     * valid `PORT` / `VERYFRONT_PORT` env var.  When false (or absent) the port
+     * value fell through to the hardcoded default and `config.dev.port` should
+     * take precedence.  Defaults to `port !== DEFAULT_DEV_PORT` for callers that
+     * do not set this field, preserving backward-compatible behaviour.
+     */
+    portExplicit?: boolean;
     projectDir: string;
     hmr?: boolean;
     open?: boolean;

package/esm/cli/commands/dev/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAQvE;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyRzE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAQvE;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6SzE"}

package/esm/cli/commands/dev/command.js

@@ -4,7 +4,7 @@
 import { compileAllMDX, watchMDX } from "../../../src/build/index.js";
 import { CONFIG_NOT_FOUND, PORT_IN_USE } from "../../../src/errors/index.js";
 import { join } from "../../../src/platform/compat/path/index.js";
-import { runtime } from "../../../src/platform/index.js";
+import { getEnv, runtime } from "../../../src/platform/index.js";
 import { getConfig } from "../../../src/config/index.js";
 import { getEnvironmentConfig } from "../../../src/config/index.js";
 import { startDevServer } from "../../../src/server/index.js";
@@ -25,6 +25,7 @@ import { createStagedPushOptions, pushCommand } from "../push/index.js";
 import { createProjectSelector } from "./project-selector.js";
 import { createDevLogController } from "./log-controller.js";
 import { findAvailablePort, isPortAvailable, isPortInUseError } from "./port-fallback.js";
+import { listInferenceOptions } from "./inference-status.js";
 function authStatus(identity) {
     return isApiKeyIdentity(identity)
         ? "Authenticated with an API key"
@@ -99,7 +100,7 @@ export async function clearLocalCachesIfPortFree(requestedPort, clear = clearAll
 }
 export function devCommand(options) {
     return withSpan("cli.command.dev", async () => {
-        const { port, projectDir, hmr = true, open = false, demoMode = false, clearLocalCaches = false, } = options;
+        const { port, portExplicit, projectDir, hmr = true, open = false, demoMode = false, clearLocalCaches = false, } = options;
         const startTime = Date.now();
         let doneResolve;
         const done = new Promise((resolve) => {
@@ -120,7 +121,14 @@ export function devCommand(options) {
             throw error;
         }
         const DEFAULT_DEV_PORT = 3000;
-        const finalPort = port !== DEFAULT_DEV_PORT ? port : (config?.dev?.port ?? port);
+        // Use `portExplicit` when provided so that `PORT=3000` is honoured even
+        // though 3000 equals the default — the old sentinel `port !== 3000` would
+        // silently discard an explicit env-var request that happens to equal the
+        // default value.  Fall back to the sentinel for callers that predate this
+        // field.
+        const finalPort = (portExplicit ?? port !== DEFAULT_DEV_PORT)
+            ? port
+            : (config?.dev?.port ?? port);
         const enableHMR = config?.dev?.hmr !== false && hmr;
         if (clearLocalCaches)
             await clearLocalCachesIfPortFree(finalPort);
@@ -247,13 +255,25 @@ export function devCommand(options) {
                 stop: shutdown,
             };
         }
-        const serverUrl = `http://veryfront.me:${boundPort}`;
+        const serverUrl = `http://localhost:${boundPort}`;
         const elapsed = Date.now() - startTime;
         console.log();
         console.log(`  ✓ Ready in ${formatDuration(elapsed)}`);
         console.log(`  ${brand(serverUrl)}`);
+        const inferenceOptions = listInferenceOptions({
+            apiToken: runtimeAuth.apiToken,
+            projectSlug: runtimeAuth.projectSlug,
+            openaiApiKey: getEnv("OPENAI_API_KEY"),
+            openaiBaseUrl: getEnv("OPENAI_BASE_URL"),
+            anthropicApiKey: getEnv("ANTHROPIC_API_KEY"),
+            googleApiKey: getEnv("GOOGLE_API_KEY") ?? getEnv("GOOGLE_GENERATIVE_AI_API_KEY"),
+            mistralApiKey: getEnv("MISTRAL_API_KEY"),
+        });
+        if (inferenceOptions.length > 0) {
+            console.log(`  ${dim("Inference")} ${brand(inferenceOptions.join(", "))}`);
+        }
         if (mcpServer && isVerbose()) {
-            console.log(`  ${dim("MCP")} ${brand(`http://veryfront.me:${mcpPort}/mcp`)}`);
+            console.log(`  ${dim("MCP")} ${brand(`http://localhost:${mcpPort}/mcp`)}`);
         }
         if (isTTY()) {
             console.log(devShortcuts());

package/esm/cli/commands/dev/handler.d.ts

@@ -2,7 +2,7 @@
  * Dev command handler
  */
 import type { ParsedArgs } from "../../shared/types.js";
-export declare const parseDevArgs: (args: ParsedArgs) => import("../../shared/args.js").SafeParseResult<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
+declare const parseDevArgsBase: (args: ParsedArgs) => import("../../shared/args.js").SafeParseResult<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
     port: import("../../../src/internal-agents/schema.js").Schema<number>;
     project: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     hmr: import("../../../src/internal-agents/schema.js").Schema<boolean>;
@@ -10,5 +10,11 @@ export declare const parseDevArgs: (args: ParsedArgs) => import("../../shared/ar
     open: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     debug: import("../../../src/internal-agents/schema.js").Schema<boolean>;
 }>>;
+/**
+ * Parses dev command arguments, honouring `PORT` / `VERYFRONT_PORT` as
+ * lower-precedence defaults when no explicit `--port` / `-p` is given.
+ */
+export declare const parseDevArgs: typeof parseDevArgsBase;
 export declare function handleDevCommand(args: ParsedArgs): Promise<void>;
+export {};
 //# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/dev/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAexD,eAAO,MAAM,YAAY;;;;;;;GAOvB,CAAC;AAwBH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BtE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAmFxD,QAAA,MAAM,gBAAgB;;;;;;;GAOpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,gBAajC,CAAC;AAwBF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDtE"}

package/esm/cli/commands/dev/handler.js

@@ -3,12 +3,80 @@
  */
 import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
 import { isAbsolute, join } from "../../../src/platform/compat/path/index.js";
-import { cwd, setEnv } from "../../../src/platform/index.js";
+import { cwd, getEnv, setEnv } from "../../../src/platform/index.js";
 import { createFileSystem } from "../../../src/platform/index.js";
-import { cliLogger, DEFAULT_DEV_SERVER_PORT, showHeader } from "../../utils/index.js";
+import { cliLogger, DEFAULT_DEV_SERVER_PORT, logWarning, showHeader } from "../../utils/index.js";
 import { refreshLoggerConfig } from "../../../src/utils/index.js";
 import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
 import { ensureCliBundlerContracts } from "../../shared/default-contracts.js";
+/**
+ * Parse a port from an env var string.  Returns `undefined` when the var is
+ * absent, empty, not an all-digit integer, or outside the valid port range
+ * 1–65535.  Invalid values emit a warning so the developer sees exactly what
+ * was rejected rather than getting a silent fallback.
+ *
+ * `Number.parseInt("3001abc")` silently returns 3001, so this function requires
+ * the entire trimmed string to be digits before converting — no prefix parsing.
+ */
+function parsePortEnv(name) {
+    const raw = getEnv(name);
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return undefined;
+    if (!/^\d+$/.test(trimmed)) {
+        logWarning(`${name}=${JSON.stringify(raw)} is not a valid port number; ignoring`);
+        return undefined;
+    }
+    const port = Number(trimmed);
+    if (port < 1 || port > 65535) {
+        logWarning(`${name}=${port} is outside the valid port range (1-65535); ignoring`);
+        return undefined;
+    }
+    return port;
+}
+/**
+ * Read a numeric port from an env var, returning `fallback` when the var is
+ * absent or contains a value that fails strict validation (non-integer string,
+ * trailing garbage, or a value outside the 1-65535 range).
+ */
+function readPortEnv(name, fallback) {
+    return parsePortEnv(name) ?? fallback;
+}
+/**
+ * Returns true when the named env var holds a valid port number (all-digit
+ * string within 1–65535).  This is a pure predicate — it never emits warnings,
+ * because those were already emitted by `parsePortEnv` during arg parsing.
+ * Used to determine whether the port came from an explicit env var rather than
+ * falling through to the hardcoded default.
+ */
+function isValidPortEnv(name) {
+    const raw = getEnv(name);
+    if (!raw)
+        return false;
+    const t = raw.trim();
+    if (!/^\d+$/.test(t))
+        return false;
+    const n = Number(t);
+    return n >= 1 && n <= 65535;
+}
+/**
+ * The default port to use for `veryfront dev`, resolved from env vars.
+ *
+ * Priority (highest → lowest):
+ *   1. `--port` / `-p` flag — explicit, handled by `parseDevArgs`
+ *   2. `PORT`              — the near-universal PaaS / framework convention
+ *   3. `VERYFRONT_PORT`   — Veryfront-specific override
+ *   4. 3000               — hardcoded default
+ *
+ * This matches how `veryfront serve` handles the same env vars, and how
+ * Next.js, Vite, Create React App, Heroku, and Railway all treat `PORT`.
+ */
+function getDefaultDevPort() {
+    const veryfrontPort = readPortEnv("VERYFRONT_PORT", DEFAULT_DEV_SERVER_PORT);
+    return readPortEnv("PORT", veryfrontPort);
+}
 const getDevArgsSchema = defineSchema((v) => v.object({
     port: v.number().default(DEFAULT_DEV_SERVER_PORT),
     project: v.string().optional(),
@@ -18,7 +86,7 @@ const getDevArgsSchema = defineSchema((v) => v.object({
     debug: v.boolean().default(false),
 }));
 const DevArgsSchema = lazySchema(getDevArgsSchema);
-export const parseDevArgs = createArgParser(DevArgsSchema, {
+const parseDevArgsBase = createArgParser(DevArgsSchema, {
     port: { keys: ["port", "p"], type: "number" },
     project: { keys: ["project"], type: "string" },
     hmr: { keys: ["hmr"], type: "boolean" },
@@ -26,6 +94,24 @@ export const parseDevArgs = createArgParser(DevArgsSchema, {
     open: { keys: ["open"], type: "boolean" },
     debug: { keys: ["debug", "d"], type: "boolean" },
 });
+/**
+ * Parses dev command arguments, honouring `PORT` / `VERYFRONT_PORT` as
+ * lower-precedence defaults when no explicit `--port` / `-p` is given.
+ */
+export const parseDevArgs = (args) => {
+    const result = parseDevArgsBase(args);
+    if (!result.success)
+        return result;
+    return {
+        success: true,
+        data: {
+            ...result.data,
+            port: args.port === undefined && args.p === undefined
+                ? getDefaultDevPort()
+                : result.data.port,
+        },
+    };
+};
 async function resolveProjectDir(projectArg) {
     if (projectArg) {
         const projectDir = isAbsolute(projectArg) ? projectArg : join(cwd(), projectArg);
@@ -45,6 +131,26 @@ async function resolveProjectDir(projectArg) {
 export async function handleDevCommand(args) {
     const opts = parseArgsOrThrow(parseDevArgs, "dev", args);
     showHeader();
+    // Warn when `PORT` is set but `--port` overrides it. The developer set an
+    // env var that the server is not going to use, and silent divergence is the
+    // original defect this fixes. Only `PORT` is surfaced here (not
+    // `VERYFRONT_PORT`) because `PORT` is the near-universal convention that
+    // developers arriving from Next.js, Vite, Heroku, and Railway expect to work.
+    //
+    // `portExplicit` is also used to carry provenance into devCommand so that
+    // `PORT=3000` is honoured even when 3000 equals the hardcoded default — the
+    // sentinel `port !== 3000` check in devCommand must not swallow an explicit
+    // env var that happens to equal the default value.
+    const portExplicit = args.port !== undefined ||
+        args.p !== undefined ||
+        isValidPortEnv("PORT") ||
+        isValidPortEnv("VERYFRONT_PORT");
+    if (args.port !== undefined || args.p !== undefined) {
+        const portFromEnv = parsePortEnv("PORT");
+        if (portFromEnv !== undefined && opts.port !== portFromEnv) {
+            logWarning(`PORT=${portFromEnv} is set but --port ${opts.port} takes precedence`);
+        }
+    }
     await ensureCliBundlerContracts();
     const projectDir = await resolveProjectDir(opts.project);
     // Enable verbose logging when --debug flag is passed
@@ -56,6 +162,7 @@ export async function handleDevCommand(args) {
     const { devCommand } = await import("./index.js");
     const { done } = await devCommand({
         port: opts.port,
+        portExplicit,
         projectDir,
         hmr: opts.hmr && !opts.noHmr,
         open: opts.open,

package/esm/cli/commands/dev/inference-status.d.ts

@@ -0,0 +1,12 @@
+export interface InferenceEnvironment {
+    apiToken?: string;
+    projectSlug?: string;
+    openaiApiKey?: string;
+    openaiBaseUrl?: string;
+    anthropicApiKey?: string;
+    googleApiKey?: string;
+    mistralApiKey?: string;
+}
+/** Return the inference paths the current dev process can use without exposing credentials. */
+export declare function listInferenceOptions(environment: InferenceEnvironment): string[];
+//# sourceMappingURL=inference-status.d.ts.map

package/esm/cli/commands/dev/inference-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/inference-status.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAgBhF"}

package/esm/cli/commands/dev/inference-status.js

@@ -0,0 +1,20 @@
+function isSet(value) {
+    return Boolean(value?.trim());
+}
+/** Return the inference paths the current dev process can use without exposing credentials. */
+export function listInferenceOptions(environment) {
+    const options = [];
+    if (isSet(environment.apiToken) && isSet(environment.projectSlug)) {
+        options.push("Veryfront Cloud AI Gateway");
+    }
+    if (isSet(environment.openaiApiKey)) {
+        options.push(isSet(environment.openaiBaseUrl) ? "OpenAI-compatible service" : "OpenAI direct");
+    }
+    if (isSet(environment.anthropicApiKey))
+        options.push("Anthropic direct");
+    if (isSet(environment.googleApiKey))
+        options.push("Google direct");
+    if (isSet(environment.mistralApiKey))
+        options.push("Mistral direct");
+    return options;
+}

package/esm/cli/commands/dev/port-fallback.d.ts

@@ -1,16 +1,3 @@
-/**
- * Dev server port selection.
- *
- * Port 3000 is the most contended port on a developer machine, and the
- * getting-started docs tell readers to run a bare `veryfront dev`. Rather than
- * hard-failing when that port is taken, scan forward for the first free one -
- * the same fallback the login callback server already uses.
- *
- * The scan probes ports by binding and releasing them, rather than by retrying
- * `startDevServer`: a failed `DevServer.start()` has already registered file
- * watchers and reload subscriptions that only `stop()` releases, so retrying it
- * would leak a watcher set per busy port.
- */
 /** How many consecutive ports to try before giving up. */
 export declare const MAX_PORT_FALLBACK_ATTEMPTS = 10;
 /** The highest port a TCP listener can bind. */
@@ -18,7 +5,21 @@ export declare const MAX_TCP_PORT = 65535;
 /** True when `error` means "that port is taken", on either Deno or Node. */
 export declare function isPortInUseError(error: unknown): boolean;
 /**
- * Binds `port` and releases it again, to see whether the dev server could have it.
+ * True when `error` means "this host has no address in that family at all",
+ * rather than "that port is taken".
+ *
+ * The two have to be told apart, because probing a family a host does not have
+ * must not make every port look busy: an IPv4-only CI container or a machine
+ * with IPv6 disabled would otherwise never find a free port to fall back to.
+ */
+export declare function isAddressFamilyUnavailableError(error: unknown): boolean;
+/**
+ * Binds `port` on every loopback family the dev server might use, and releases
+ * it again, to see whether the dev server could have it.
+ *
+ * A port counts as available only when nothing holds it on *any* of those
+ * addresses - see `PROBE_HOSTNAMES` for why one family is not enough. A family
+ * the host does not have is skipped rather than counted as a collision.
  *
  * The Deno runtime is read through `getDenoRuntime()` rather than through the
  * `Deno` global directly: dnt rewrites every bare `Deno.` reference in the

package/esm/cli/commands/dev/port-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port-fallback.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/port-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,gDAAgD;AAChD,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAAmC,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,MAAM,CAAC,CAejB"}
+{"version":3,"file":"port-fallback.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/port-fallback.ts"],"names":[],"mappings":"AAoBA,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,gDAAgD;AAChD,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWvE;AAqDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAAmC,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,GAC1D,OAAO,CAAC,MAAM,CAAC,CAejB"}