everything-dev 0.1.5 → 0.2.0

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "everything-dev",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "type": "module",
   "main": "src/index.ts",
   "exports": {
     ".": "./src/index.ts",
     "./types": "./src/types.ts",
+    "./config": "./src/config.ts",
     "./ui": "./src/ui/index.ts",
     "./ui/types": "./src/ui/types.ts",
     "./ui/runtime": "./src/ui/runtime.ts",
-    "./ui/head": "./src/ui/head.ts"
+    "./ui/head": "./src/ui/head.ts",
+    "./ui/router": "./src/ui/router.ts"
   },
   "files": [
     "src"

package/src/cli.ts

@@ -2,7 +2,7 @@
 import { spinner } from "@clack/prompts";
 import { program } from "commander";
 import { createPluginRuntime } from "every-plugin";
-import { type BosConfig, getConfigDir, getConfigPath, getPackages, getTitle, loadConfig } from "./config";
+import { type BosConfig, getConfigDir, getConfigPath, getPackages, loadConfig } from "./config";
 import BosPlugin from "./plugin";
 import { printBanner } from "./utils/banner";
 import { colors, frames, gradients, icons } from "./utils/theme";
@@ -21,9 +21,6 @@ function getHelpHeader(config: BosConfig | null, configPath: string): string {
     lines.push(`  ${colors.dim("Account")} ${colors.cyan(config.account)}`);
     lines.push(`  ${colors.dim("Gateway")} ${colors.white(config.gateway?.production ?? "not configured")}`);
     lines.push(`  ${colors.dim("Config ")} ${colors.dim(configPath)}`);
-    if (host?.description) {
-      lines.push(`  ${colors.dim("About  ")} ${colors.white(host.description)}`);
-    }
   } else {
     lines.push(`  ${colors.dim("No project config found")}`);
     lines.push(`  ${colors.dim("Run")} ${colors.cyan("bos create project <name>")} ${colors.dim("to get started")}`);
@@ -48,7 +45,6 @@ async function main() {
   const config = loadConfig();
   const configPath = config ? getConfigPath() : process.cwd();
   const packages = config ? getPackages() : [];
-  const title = config ? getTitle() : "BOS CLI";
 
   if (config) {
     const envPath = `${getConfigDir()}/.env.bos`;
@@ -69,7 +65,7 @@ async function main() {
     }
   }
 
-  printBanner(title);
+  printBanner("BOS CLI");
 
   const runtime = createPluginRuntime({
     registry: {
@@ -113,10 +109,6 @@ async function main() {
 
       const host = result.config.app.host;
       console.log(colors.magenta(`  ┌─ HOST ${"─".repeat(42)}┐`));
-      console.log(`  ${colors.magenta("│")} ${colors.dim("title")}        ${colors.white(host.title)}`);
-      if (host.description) {
-        console.log(`  ${colors.magenta("│")} ${colors.dim("description")}  ${colors.gray(host.description)}`);
-      }
       console.log(`  ${colors.magenta("│")} ${colors.dim("development")}  ${colors.cyan(host.development)}`);
       console.log(`  ${colors.magenta("│")} ${colors.dim("production")}   ${colors.green(host.production)}`);
       console.log(colors.magenta(`  └${"─".repeat(49)}┘`));
@@ -238,7 +230,7 @@ async function main() {
           new OpenAPIReferencePlugin({
             schemaConverters: [new ZodToJsonSchemaConverter()],
             specGenerateOptions: {
-              info: { title: "BOS CLI API", version: "1.0.0" },
+              info: { title: "everything-dev api", version: "1.0.0" },
               servers: [{ url: `http://localhost:${port}/api` }],
             },
           }),
@@ -248,7 +240,7 @@ async function main() {
 
       app.get("/", (c) => c.json({ 
         ok: true, 
-        plugin: "bos-cli", 
+        plugin: "everything-dev", 
         status: "ready",
         endpoints: {
           health: "/",
@@ -341,47 +333,49 @@ async function main() {
     });
 
   program
-    .command("deploy")
-    .description(`Build and deploy to Zephyr Cloud (${packages.join(", ")})`)
-    .argument("[packages]", "Packages to deploy (comma-separated: host,ui,api)", "all")
+    .command("publish")
+    .description("Build, deploy, and publish to Near Social (full release)")
+    .argument("[packages]", "Packages to build/deploy (comma-separated: host,ui,api)", "all")
     .option("--force", "Force rebuild")
+    .option("--network <network>", "Network: mainnet | testnet", "mainnet")
+    .option("--path <path>", "Near Social relative path", "bos.config.json")
+    .option("--dry-run", "Show what would be published without sending")
     .addHelpText("after", `
+Release Workflow:
+  1. Build packages (bun run build)
+  2. Deploy to Zephyr Cloud (updates production URLs)
+  3. Publish config to Near Social
+
 Zephyr Configuration:
   Set ZE_SERVER_TOKEN and ZE_USER_EMAIL in .env.bos for CI/CD deployment.
   Docs: https://docs.zephyr-cloud.io/features/ci-cd-server-token
 `)
     .action(async (pkgs: string, options) => {
       console.log();
-      console.log(`  ${icons.pkg} Building & deploying...`);
+      console.log(`  ${icons.pkg} Starting release workflow...`);
+      console.log(colors.dim(`  Account: ${config?.account}`));
+      console.log(colors.dim(`  Network: ${options.network}`));
+      console.log();
 
-      const result = await client.build({
-        packages: pkgs,
-        force: options.force || false,
-        deploy: true,
-      });
+      if (!options.dryRun) {
+        console.log(`  ${icons.pkg} Step 1/3: Building & deploying...`);
 
-      if (result.status === "error") {
-        console.error(colors.error(`${icons.err} Deploy failed`));
-        process.exit(1);
-      }
+        const buildResult = await client.build({
+          packages: pkgs,
+          force: options.force || false,
+          deploy: true,
+        });
 
-      console.log();
-      console.log(colors.green(`${icons.ok} Deployed: ${result.built.join(", ")}`));
-      console.log(colors.dim(`  Deployed to Zephyr Cloud`));
-      console.log();
-    });
+        if (buildResult.status === "error") {
+          console.error(colors.error(`${icons.err} Build/deploy failed`));
+          process.exit(1);
+        }
 
-  program
-    .command("publish")
-    .description("Publish bos.config.json to on-chain registry (Near Social)")
-    .option("--network <network>", "Network: mainnet | testnet", "mainnet")
-    .option("--path <path>", "Near Social relative path", "bos.config.json")
-    .option("--dry-run", "Show what would be published without sending")
-    .action(async (options) => {
-      console.log();
-      console.log(`  ${icons.pkg} Publishing to Near Social...`);
-      console.log(colors.dim(`  Account: ${config?.account}`));
-      console.log(colors.dim(`  Network: ${options.network}`));
+        console.log(colors.green(`  ${icons.ok} Built & deployed: ${buildResult.built.join(", ")}`));
+        console.log();
+      }
+
+      console.log(`  ${icons.pkg} ${options.dryRun ? "Dry run:" : "Step 2/3:"} Publishing to Near Social...`);
 
       if (options.dryRun) {
         console.log(colors.cyan(`  ${icons.scan} Dry run mode - no transaction will be sent`));
@@ -406,11 +400,12 @@ Zephyr Configuration:
         return;
       }
 
-      console.log();
-      console.log(colors.green(`${icons.ok} Published!`));
+      console.log(colors.green(`  ${icons.ok} Published to Near Social`));
       console.log(`  ${colors.dim("TX:")} ${result.txHash}`);
       console.log(`  ${colors.dim("URL:")} ${result.registryUrl}`);
       console.log();
+      console.log(colors.green(`${icons.ok} Release complete!`));
+      console.log();
     });
 
   program
@@ -742,40 +737,38 @@ Zephyr Configuration:
     });
 
   program
-    .command("sync")
-    .description("Sync dependencies and config from published bos.config.json")
-    .option("--account <account>", "NEAR account to sync from (default: from config)")
-    .option("--gateway <gateway>", "Gateway domain to sync from (default: from config)")
+    .command("update")
+    .description("Update from published config (host prod, secrets, shared deps, UI files)")
+    .option("--account <account>", "NEAR account to update from (default: from config)")
+    .option("--gateway <gateway>", "Gateway domain (default: from config)")
     .option("--network <network>", "Network: mainnet | testnet", "mainnet")
-    .option("--force", "Force sync even if versions match")
-    .option("--files", "Also sync template files (tsconfig, etc.)")
-    .action(async (options: { account?: string; gateway?: string; network?: string; force?: boolean; files?: boolean }) => {
+    .option("--force", "Force update even if versions match")
+    .action(async (options: { account?: string; gateway?: string; network?: string; force?: boolean }) => {
       console.log();
       const gateway = config?.gateway as { production?: string } | undefined;
       const gatewayDomain = gateway?.production?.replace(/^https?:\/\//, "") || "everything.dev";
       const source = `${options.account || config?.account || "every.near"}/${options.gateway || gatewayDomain}`;
 
       const s = spinner();
-      s.start(`Syncing from ${source}...`);
+      s.start(`Updating from ${source}...`);
 
-      const result = await client.sync({
+      const result = await client.update({
         account: options.account,
         gateway: options.gateway,
         network: (options.network as "mainnet" | "testnet") || "mainnet",
         force: options.force || false,
-        files: options.files || false,
       });
 
       if (result.status === "error") {
-        s.stop(colors.error(`${icons.err} Sync failed: ${result.error || "Unknown error"}`));
+        s.stop(colors.error(`${icons.err} Update failed: ${result.error || "Unknown error"}`));
         process.exit(1);
       }
 
-      s.stop(colors.green(`${icons.ok} Synced from ${source}`));
+      s.stop(colors.green(`${icons.ok} Updated from ${source}`));
 
       console.log();
       console.log(colors.cyan(frames.top(52)));
-      console.log(`  ${icons.ok} ${gradients.cyber("SYNCED")}`);
+      console.log(`  ${icons.ok} ${gradients.cyber("UPDATED")}`);
       console.log(colors.cyan(frames.bottom(52)));
       console.log();
       console.log(`  ${colors.dim("Source:")}   ${colors.cyan(`${result.account}/${result.gateway}`)}`);
@@ -793,7 +786,7 @@ Zephyr Configuration:
 
       if (result.filesSynced && result.filesSynced.length > 0) {
         const totalFiles = result.filesSynced.reduce((sum, pkg) => sum + pkg.files.length, 0);
-        console.log(colors.green(`  ${icons.ok} Synced ${totalFiles} files`));
+        console.log(colors.green(`  ${icons.ok} Synced ${totalFiles} UI files`));
         for (const pkg of result.filesSynced) {
           console.log(colors.dim(`    ${pkg.package}: ${pkg.files.join(", ")}`));
         }

package/src/components/dev-view.tsx

@@ -1,7 +1,7 @@
 import { Box, render, Text, useApp, useInput } from "ink";
 import { useEffect, useState } from "react";
 import { linkify } from "../utils/linkify";
-import { colors, divider, gradients, icons, frames } from "../utils/theme";
+import { colors, divider, frames, gradients, icons } from "../utils/theme";
 
 export type ProcessStatus = "pending" | "starting" | "ready" | "error";
 
@@ -11,6 +11,7 @@ export interface ProcessState {
   port: number;
   message?: string;
   source?: "local" | "remote";
+  proxyTarget?: string;
 }
 
 export interface LogEntry {
@@ -24,6 +25,7 @@ interface DevViewProps {
   processes: ProcessState[];
   logs: LogEntry[];
   description: string;
+  proxyTarget?: string;
   onExit?: () => void;
   onExportLogs?: () => void;
 }
@@ -64,14 +66,14 @@ function ProcessRow({ proc }: { proc: ProcessState }) {
       <Text>{"  "}</Text>
       <StatusIcon status={proc.status} />
       <Text> </Text>
-      <Text color={color} bold>{proc.name.toUpperCase().padEnd(6)}</Text>
+      <Text color={color} bold>
+        {proc.name.toUpperCase().padEnd(6)}
+      </Text>
       <Text color="gray">{sourceLabel.padEnd(10)}</Text>
       <Text color={proc.status === "ready" ? "#00ff41" : "gray"}>
         {statusText}
       </Text>
-      {proc.port > 0 && (
-        <Text color="#00ffff"> {portStr}</Text>
-      )}
+      {proc.port > 0 && <Text color="#00ffff"> {portStr}</Text>}
     </Box>
   );
 }
@@ -82,15 +84,33 @@ function LogLine({ entry }: { entry: LogEntry }) {
   return (
     <Box>
       <Text color={color}>[{entry.source}]</Text>
-      <Text color={entry.isError ? "#ff3366" : undefined}> {linkify(entry.line)}</Text>
+      <Text color={entry.isError ? "#ff3366" : undefined}>
+        {" "}
+        {linkify(entry.line)}
+      </Text>
     </Box>
   );
 }
 
+function truncateUrl(url: string, maxLen: number): string {
+  if (url.length <= maxLen) return url;
+  try {
+    const parsed = new URL(url);
+    const host = parsed.host;
+    if (host.length > maxLen - 10) {
+      return `${host.slice(0, maxLen - 13)}...`;
+    }
+    return host;
+  } catch {
+    return `${url.slice(0, maxLen - 3)}...`;
+  }
+}
+
 function DevView({
   processes,
   logs,
   description,
+  proxyTarget,
   onExit,
   onExportLogs,
 }: DevViewProps) {
@@ -133,14 +153,29 @@ function DevView({
       {allReady && (
         <Box marginBottom={1} flexDirection="column">
           <Box>
-            <Text color="#00ff41">{"  "}{icons.app} APP READY</Text>
+            <Text color="#00ff41">
+              {"  "}
+              {icons.app} APP READY
+            </Text>
           </Box>
           <Box>
-            <Text color="#00ff41" bold>{"  "}{icons.arrow} http://localhost:{hostPort}</Text>
+            <Text color="#00ff41" bold>
+              {"  "}
+              {icons.arrow} http://localhost:{hostPort}
+            </Text>
           </Box>
         </Box>
       )}
 
+      {proxyTarget && (
+        <Box marginBottom={1}>
+          <Text color="#ffaa00">
+            {"  "}
+            {icons.arrow} API PROXY → {truncateUrl(proxyTarget, 38)}
+          </Text>
+        </Box>
+      )}
+
       <Box marginTop={0} marginBottom={0}>
         <Text>{colors.dim(divider(52))}</Text>
       </Box>
@@ -160,7 +195,10 @@ function DevView({
             ? `${icons.ok} All ${total} services running`
             : `${icons.scan} ${readyCount}/${total} ready`}
         </Text>
-        <Text color="gray"> {icons.dot} q quit {icons.dot} l logs</Text>
+        <Text color="gray">
+          {" "}
+          {icons.dot} q quit {icons.dot} l logs
+        </Text>
       </Box>
 
       {recentLogs.length > 0 && (
@@ -199,6 +237,7 @@ export function renderDevView(
   let processes = [...initialProcesses];
   let logs: LogEntry[] = [];
   let rerender: (() => void) | null = null;
+  const proxyTarget = env.API_PROXY;
 
   const updateProcess = (
     name: string,
@@ -232,6 +271,7 @@ export function renderDevView(
         processes={processes}
         logs={logs}
         description={description}
+        proxyTarget={proxyTarget}
         onExit={onExit}
         onExportLogs={onExportLogs}
       />

package/src/components/streaming-view.ts

@@ -1,7 +1,10 @@
+import chalk from "chalk";
 import { linkify } from "../utils/linkify";
 import { colors, icons } from "../utils/theme";
 import type { ProcessState, ProcessStatus } from "./dev-view";
 
+const orange = chalk.hex("#ffaa00");
+
 export interface StreamingViewHandle {
   updateProcess: (name: string, status: ProcessStatus, message?: string) => void;
   addLog: (source: string, line: string, isError?: boolean) => void;
@@ -34,7 +37,7 @@ const getStatusIcon = (status: ProcessStatus): string => {
 export function renderStreamingView(
   initialProcesses: ProcessState[],
   description: string,
-  _env: Record<string, string>,
+  env: Record<string, string>,
   onExit?: () => void,
   _onExportLogs?: () => void,
 ): StreamingViewHandle {
@@ -46,6 +49,7 @@ export function renderStreamingView(
   let allReadyPrinted = false;
   const hostProcess = initialProcesses.find(p => p.name === "host");
   const hostPort = hostProcess?.port || 3000;
+  const proxyTarget = env.API_PROXY;
 
   console.log();
   console.log(colors.cyan(`${"─".repeat(52)}`));
@@ -53,6 +57,11 @@ export function renderStreamingView(
   console.log(colors.cyan(`${"─".repeat(52)}`));
   console.log();
 
+  if (proxyTarget) {
+    console.log(orange(`  ${icons.arrow} API PROXY → ${proxyTarget}`));
+    console.log();
+  }
+
   for (const proc of initialProcesses) {
     const color = getServiceColor(proc.name);
     const sourceLabel = proc.source ? ` (${proc.source})` : "";

package/src/config.ts

@@ -6,10 +6,11 @@ import type {
   HostConfig,
   PortConfig,
   RemoteConfig,
+  RuntimeConfig,
   SourceMode,
 } from "./types";
 
-export type { AppConfig, BosConfig, GatewayConfig, HostConfig, PortConfig, RemoteConfig, SourceMode };
+export type { AppConfig, BosConfig, GatewayConfig, HostConfig, PortConfig, RemoteConfig, RuntimeConfig, SourceMode };
 
 export const DEFAULT_DEV_CONFIG: AppConfig = {
   host: "local",
@@ -132,14 +133,6 @@ export function getAccount(): string {
   return config.account;
 }
 
-export function getTitle(): string {
-  const config = loadConfig();
-  if (!config) {
-    throw new Error("No bos.config.json found");
-  }
-  return config.app.host.title;
-}
-
 export function getComponentUrl(
   component: "host" | "ui" | "api",
   source: SourceMode
@@ -247,3 +240,47 @@ export async function getExistingPackages(packages: string[]): Promise<{ existin
 
   return { existing, missing };
 }
+
+export async function loadBosConfig(
+  env: "development" | "production" = "production"
+): Promise<RuntimeConfig> {
+  const configPath = process.env.BOS_CONFIG_PATH;
+  
+  let bosConfig: BosConfig;
+  if (configPath) {
+    const file = Bun.file(configPath);
+    const text = await file.text();
+    bosConfig = JSON.parse(text) as BosConfig;
+  } else {
+    const config = loadConfig();
+    if (!config) {
+      throw new Error("No bos.config.json found");
+    }
+    bosConfig = config;
+  }
+
+  const uiConfig = bosConfig.app.ui as RemoteConfig;
+  const apiConfig = bosConfig.app.api as RemoteConfig;
+
+  return {
+    env,
+    account: bosConfig.account,
+    title: bosConfig.account,
+    hostUrl: bosConfig.app.host[env],
+    shared: bosConfig.shared,
+    ui: {
+      name: uiConfig.name,
+      url: uiConfig[env],
+      ssrUrl: uiConfig.ssr,
+      source: "remote",
+    },
+    api: {
+      name: apiConfig.name,
+      url: apiConfig[env],
+      source: "remote",
+      proxy: apiConfig.proxy,
+      variables: apiConfig.variables,
+      secrets: apiConfig.secrets,
+    },
+  };
+}

package/src/contract.ts

@@ -211,16 +211,15 @@ const GatewaySyncResultSchema = z.object({
   error: z.string().optional(),
 });
 
-const SyncOptionsSchema = z.object({
+const UpdateOptionsSchema = z.object({
   account: z.string().optional(),
   gateway: z.string().optional(),
   network: z.enum(["mainnet", "testnet"]).default("mainnet"),
   force: z.boolean().optional(),
-  files: z.boolean().optional(),
 });
 
-const SyncResultSchema = z.object({
-  status: z.enum(["synced", "error"]),
+const UpdateResultSchema = z.object({
+  status: z.enum(["updated", "error"]),
   account: z.string(),
   gateway: z.string(),
   socialUrl: z.string().optional(),
@@ -500,10 +499,10 @@ export const bosContract = oc.router({
     .input(GatewaySyncOptionsSchema)
     .output(GatewaySyncResultSchema),
 
-  sync: oc
-    .route({ method: "POST", path: "/sync" })
-    .input(SyncOptionsSchema)
-    .output(SyncResultSchema),
+  update: oc
+    .route({ method: "POST", path: "/update" })
+    .input(UpdateOptionsSchema)
+    .output(UpdateResultSchema),
 
   depsUpdate: oc
     .route({ method: "POST", path: "/deps/update" })
@@ -580,8 +579,8 @@ export type SecretsDeleteResult = z.infer<typeof SecretsDeleteResultSchema>;
 export type LoginOptions = z.infer<typeof LoginOptionsSchema>;
 export type LoginResult = z.infer<typeof LoginResultSchema>;
 export type LogoutResult = z.infer<typeof LogoutResultSchema>;
-export type SyncOptions = z.infer<typeof SyncOptionsSchema>;
-export type SyncResult = z.infer<typeof SyncResultSchema>;
+export type UpdateOptions = z.infer<typeof UpdateOptionsSchema>;
+export type UpdateResult = z.infer<typeof UpdateResultSchema>;
 export type DepsUpdateOptions = z.infer<typeof DepsUpdateOptionsSchema>;
 export type DepsUpdateResult = z.infer<typeof DepsUpdateResultSchema>;
 export type FilesSyncOptions = z.infer<typeof FilesSyncOptionsSchema>;

package/src/lib/process.ts

@@ -173,7 +173,6 @@ export function buildRuntimeConfig(
   return {
     env: options.env ?? "development",
     account: bosConfig.account,
-    title: bosConfig.app.host.title,
     hostUrl: options.hostUrl,
     shared: (bosConfig as { shared?: { ui?: Record<string, unknown> } }).shared as RuntimeConfig["shared"],
     ui: {
@@ -181,7 +180,6 @@ export function buildRuntimeConfig(
       url: options.uiSource === "remote" ? uiConfig.production : uiConfig.development,
       ssrUrl: options.uiSource === "remote" ? uiConfig.ssr : undefined,
       source: options.uiSource,
-      exposes: uiConfig.exposes || {},
     },
     api: {
       name: apiConfig.name,

package/src/lib/resource-monitor/diff.ts

@@ -21,17 +21,13 @@ export const diffSnapshots = (from: Snapshot, to: Snapshot): SnapshotDiff => {
     }
   }
 
-  const stillBoundPids = new Set(
-    stillBoundPorts.map((p) => p.pid).filter((pid): pid is number => pid !== null)
-  );
-
-  const orphanedProcesses = from.processes.filter(
-    (p) =>
-      fromPids.has(p.pid) &&
-      !toPids.has(p.pid) &&
-      isProcessAliveSync(p.pid) &&
-      stillBoundPids.has(p.pid)
-  );
+  const orphanedProcesses = from.processes.filter((p) => {
+    const wasInBaseline = fromPids.has(p.pid);
+    const notInAfter = !toPids.has(p.pid);
+    const stillAlive = isProcessAliveSync(p.pid);
+    
+    return wasInBaseline && notInAfter && stillAlive;
+  });
 
   const newProcesses = to.processes.filter((p) => !fromPids.has(p.pid));
   const killedProcesses = from.processes.filter((p) => !toPids.has(p.pid));

package/src/lib/resource-monitor/platform/darwin.ts

@@ -211,7 +211,7 @@ const getMemoryInfo = (): Effect.Effect<MemoryInfo, never> =>
     return {
       total,
       used,
-      free: total - used,
+      free: Math.max(0, total - used),
       processRss: 0,
     };
   });

package/src/lib/sync.ts

@@ -1,133 +1 @@
-import { execa } from "execa";
-import { cp, mkdir, mkdtemp, rm } from "fs/promises";
-import { tmpdir } from "os";
-import { dirname, join } from "path";
-import type { BosConfig } from "../config";
-
-export interface FileSyncResult {
-  package: string;
-  files: string[];
-  depsAdded?: string[];
-  depsUpdated?: string[];
-}
-
-export interface FileSyncOptions {
-  configDir: string;
-  packages: string[];
-  bosConfig: BosConfig;
-  catalog?: Record<string, string>;
-  force?: boolean;
-}
-
-export async function syncFiles(options: FileSyncOptions): Promise<FileSyncResult[]> {
-  const { configDir, packages, bosConfig, catalog = {}, force } = options;
-  const results: FileSyncResult[] = [];
-
-  for (const pkg of packages) {
-    const pkgDir = `${configDir}/${pkg}`;
-    const pkgDirExists = await Bun.file(`${pkgDir}/package.json`).exists();
-    if (!pkgDirExists) continue;
-
-    const appConfig = bosConfig.app[pkg] as {
-      template?: string;
-      files?: string[];
-      sync?: { dependencies?: boolean; devDependencies?: boolean };
-    };
-
-    if (!appConfig?.template || !appConfig?.files) {
-      continue;
-    }
-
-    const tempDir = await mkdtemp(join(tmpdir(), `bos-files-${pkg}-`));
-
-    try {
-      await execa("npx", ["degit", appConfig.template, tempDir, "--force"], {
-        stdio: "pipe",
-      });
-
-      const filesSynced: string[] = [];
-      const depsAdded: string[] = [];
-      const depsUpdated: string[] = [];
-
-      for (const file of appConfig.files) {
-        const srcPath = join(tempDir, file);
-        const destPath = join(pkgDir, file);
-
-        try {
-          const destDir = dirname(destPath);
-          await mkdir(destDir, { recursive: true });
-          await cp(srcPath, destPath, { force: true, recursive: true });
-          filesSynced.push(file);
-        } catch {
-        }
-      }
-
-      const syncConfig = appConfig.sync ?? { dependencies: true, devDependencies: true };
-
-      if (syncConfig.dependencies !== false || syncConfig.devDependencies !== false) {
-        const templatePkgPath = join(tempDir, "package.json");
-        const localPkgPath = join(pkgDir, "package.json");
-
-        try {
-          const templatePkg = await Bun.file(templatePkgPath).json() as {
-            dependencies?: Record<string, string>;
-            devDependencies?: Record<string, string>;
-            scripts?: Record<string, string>;
-          };
-          const localPkg = await Bun.file(localPkgPath).json() as {
-            dependencies?: Record<string, string>;
-            devDependencies?: Record<string, string>;
-            scripts?: Record<string, string>;
-          };
-
-          if (syncConfig.dependencies !== false && templatePkg.dependencies) {
-            if (!localPkg.dependencies) localPkg.dependencies = {};
-            for (const [name, version] of Object.entries(templatePkg.dependencies)) {
-              if (!(name in localPkg.dependencies)) {
-                localPkg.dependencies[name] = name in catalog ? "catalog:" : version;
-                depsAdded.push(name);
-              } else if (localPkg.dependencies[name] !== "catalog:" && version !== localPkg.dependencies[name]) {
-                localPkg.dependencies[name] = name in catalog ? "catalog:" : version;
-                depsUpdated.push(name);
-              }
-            }
-          }
-
-          if (syncConfig.devDependencies !== false && templatePkg.devDependencies) {
-            if (!localPkg.devDependencies) localPkg.devDependencies = {};
-            for (const [name, version] of Object.entries(templatePkg.devDependencies)) {
-              if (!(name in localPkg.devDependencies)) {
-                localPkg.devDependencies[name] = name in catalog ? "catalog:" : version;
-                depsAdded.push(name);
-              } else if (localPkg.devDependencies[name] !== "catalog:" && version !== localPkg.devDependencies[name]) {
-                localPkg.devDependencies[name] = name in catalog ? "catalog:" : version;
-                depsUpdated.push(name);
-              }
-            }
-          }
-
-          if (templatePkg.scripts) {
-            if (!localPkg.scripts) localPkg.scripts = {};
-            for (const [name, script] of Object.entries(templatePkg.scripts)) {
-              localPkg.scripts[name] = script;
-            }
-          }
-
-          await Bun.write(localPkgPath, JSON.stringify(localPkg, null, 2));
-        } catch {
-        }
-      }
-
-      results.push({
-        package: pkg,
-        files: filesSynced,
-        depsAdded: depsAdded.length > 0 ? depsAdded : undefined,
-        depsUpdated: depsUpdated.length > 0 ? depsUpdated : undefined,
-      });
-    } finally {
-      await rm(tempDir, { recursive: true, force: true });
-    }
-  }
-
-  return results;
-}
+export { syncFiles, type FileSyncOptions, type FileSyncResult } from "../ui/files";

package/src/plugin.ts

@@ -159,7 +159,33 @@ function determineProcesses(config: AppConfig): string[] {
   return processes;
 }
 
-function buildEnvVars(config: AppConfig): Record<string, string> {
+function isValidProxyUrl(url: string): boolean {
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+function resolveProxyUrl(bosConfig: BosConfigType | null): string | null {
+  if (!bosConfig) return null;
+  
+  const apiConfig = bosConfig.app.api as RemoteConfig | undefined;
+  if (!apiConfig) return null;
+
+  if (apiConfig.proxy && isValidProxyUrl(apiConfig.proxy)) {
+    return apiConfig.proxy;
+  }
+  
+  if (apiConfig.production && isValidProxyUrl(apiConfig.production)) {
+    return apiConfig.production;
+  }
+  
+  return null;
+}
+
+function buildEnvVars(config: AppConfig, bosConfig?: BosConfigType | null): Record<string, string> {
   const env: Record<string, string> = {};
 
   env.HOST_SOURCE = config.host;
@@ -174,9 +200,11 @@ function buildEnvVars(config: AppConfig): Record<string, string> {
   }
 
   if (config.proxy) {
-    const bosConfig = loadConfig();
-    const apiConfig = bosConfig?.app.api as RemoteConfig | undefined;
-    env.API_PROXY = apiConfig?.proxy || apiConfig?.production || "true";
+    const resolvedBosConfig = bosConfig ?? loadConfig();
+    const proxyUrl = resolveProxyUrl(resolvedBosConfig);
+    if (proxyUrl) {
+      env.API_PROXY = proxyUrl;
+    }
   }
 
   return env;
@@ -248,8 +276,28 @@ export default createPlugin({
         }
       }
 
+      let proxyUrl: string | undefined;
+      if (appConfig.proxy) {
+        proxyUrl = resolveProxyUrl(deps.bosConfig) ?? undefined;
+        if (!proxyUrl) {
+          console.log();
+          console.log(colors.red(`  ${icons.err} Proxy mode requested but no valid proxy URL found`));
+          console.log(colors.dim(`    Configure 'api.proxy' or 'api.production' in bos.config.json`));
+          console.log();
+          return {
+            status: "error" as const,
+            description: "No valid proxy URL configured in bos.config.json",
+            processes: [],
+            autoRemote,
+          };
+        }
+        console.log();
+        console.log(colors.cyan(`  ${icons.arrow} API Proxy: ${colors.bold(proxyUrl)}`));
+        console.log();
+      }
+
       const processes = determineProcesses(appConfig);
-      const env = buildEnvVars(appConfig);
+      const env = buildEnvVars(appConfig, deps.bosConfig);
       const description = buildDescription(appConfig);
 
       const orchestrator: AppOrchestrator = {
@@ -1302,7 +1350,7 @@ export default createPlugin({
       };
     }),
 
-    sync: builder.sync.handler(async ({ input }) => {
+    update: builder.update.handler(async ({ input }) => {
       const { configDir, bosConfig } = deps;
 
       const DEFAULT_ACCOUNT = "every.near";
@@ -1476,24 +1524,20 @@ export default createPlugin({
           }
         }
 
-        let filesSynced: Array<{ package: string; files: string[] }> | undefined;
-
-        if (input.files) {
-          const results = await syncFiles({
-            configDir,
-            packages: Object.keys(updatedBosConfig.app),
-            bosConfig: updatedBosConfig,
-            catalog: rootPkg.workspaces?.catalog ?? {},
-            force: input.force,
-          });
+        const results = await syncFiles({
+          configDir,
+          packages: Object.keys(updatedBosConfig.app),
+          bosConfig: updatedBosConfig,
+          catalog: rootPkg.workspaces?.catalog ?? {},
+          force: input.force,
+        });
 
-          if (results.length > 0) {
-            filesSynced = results.map(r => ({ package: r.package, files: r.files }));
-          }
-        }
+        const filesSynced = results.length > 0 
+          ? results.map(r => ({ package: r.package, files: r.files }))
+          : undefined;
 
         return {
-          status: "synced" as const,
+          status: "updated" as const,
           account,
           gateway,
           socialUrl,

package/src/types.ts

@@ -4,8 +4,6 @@ export const SourceModeSchema = z.enum(["local", "remote"]);
 export type SourceMode = z.infer<typeof SourceModeSchema>;
 
 export const HostConfigSchema = z.object({
-  title: z.string(),
-  description: z.string().optional(),
   development: z.string(),
   production: z.string(),
   secrets: z.array(z.string()).optional(),
@@ -21,7 +19,6 @@ export const RemoteConfigSchema = z.object({
   production: z.string(),
   ssr: z.string().optional(),
   proxy: z.string().optional(),
-  exposes: z.record(z.string(), z.string()).optional(),
   variables: z.record(z.string(), z.string()).optional(),
   secrets: z.array(z.string()).optional(),
   template: z.string().optional(),
@@ -101,7 +98,7 @@ export type SharedConfig = z.infer<typeof SharedConfigSchema>;
 export const RuntimeConfigSchema = z.object({
   env: z.enum(["development", "production"]),
   account: z.string(),
-  title: z.string(),
+  title: z.string().optional(),
   hostUrl: z.string(),
   shared: z.object({
     ui: z.record(z.string(), SharedConfigSchema).optional(),
@@ -111,7 +108,6 @@ export const RuntimeConfigSchema = z.object({
     url: z.string(),
     ssrUrl: z.string().optional(),
     source: SourceModeSchema,
-    exposes: z.record(z.string(), z.string()),
   }),
   api: z.object({
     name: z.string(),
@@ -127,7 +123,6 @@ export type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;
 export const ClientRuntimeConfigSchema = z.object({
   env: z.enum(["development", "production"]),
   account: z.string(),
-  title: z.string(),
   hostUrl: z.string().optional(),
   assetsUrl: z.string(),
   apiBase: z.string(),
@@ -135,7 +130,6 @@ export const ClientRuntimeConfigSchema = z.object({
   ui: z.object({
     name: z.string(),
     url: z.string(),
-    exposes: z.record(z.string(), z.string()).optional(),
   }).optional(),
 });
 export type ClientRuntimeConfig = z.infer<typeof ClientRuntimeConfigSchema>;

package/src/ui/files.ts

@@ -0,0 +1,134 @@
+import { execa } from "execa";
+import { cp, mkdir, mkdtemp, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { dirname, join } from "path";
+
+export interface FileSyncResult {
+  package: string;
+  files: string[];
+  depsAdded?: string[];
+  depsUpdated?: string[];
+}
+
+export interface FileSyncOptions {
+  configDir: string;
+  packages: string[];
+  bosConfig: {
+    app: Record<string, {
+      template?: string;
+      files?: string[];
+      sync?: { dependencies?: boolean; devDependencies?: boolean };
+    }>;
+  };
+  catalog?: Record<string, string>;
+  force?: boolean;
+}
+
+export async function syncFiles(options: FileSyncOptions): Promise<FileSyncResult[]> {
+  const { configDir, packages, bosConfig, catalog = {}, force } = options;
+  const results: FileSyncResult[] = [];
+
+  for (const pkg of packages) {
+    const pkgDir = `${configDir}/${pkg}`;
+    const pkgDirExists = await Bun.file(`${pkgDir}/package.json`).exists();
+    if (!pkgDirExists) continue;
+
+    const appConfig = bosConfig.app[pkg];
+
+    if (!appConfig?.template || !appConfig?.files) {
+      continue;
+    }
+
+    const tempDir = await mkdtemp(join(tmpdir(), `bos-files-${pkg}-`));
+
+    try {
+      await execa("npx", ["degit", appConfig.template, tempDir, "--force"], {
+        stdio: "pipe",
+      });
+
+      const filesSynced: string[] = [];
+      const depsAdded: string[] = [];
+      const depsUpdated: string[] = [];
+
+      for (const file of appConfig.files) {
+        const srcPath = join(tempDir, file);
+        const destPath = join(pkgDir, file);
+
+        try {
+          const destDir = dirname(destPath);
+          await mkdir(destDir, { recursive: true });
+          await cp(srcPath, destPath, { force: true, recursive: true });
+          filesSynced.push(file);
+        } catch {
+        }
+      }
+
+      const syncConfig = appConfig.sync ?? { dependencies: true, devDependencies: true };
+
+      if (syncConfig.dependencies !== false || syncConfig.devDependencies !== false) {
+        const templatePkgPath = join(tempDir, "package.json");
+        const localPkgPath = join(pkgDir, "package.json");
+
+        try {
+          const templatePkg = await Bun.file(templatePkgPath).json() as {
+            dependencies?: Record<string, string>;
+            devDependencies?: Record<string, string>;
+            scripts?: Record<string, string>;
+          };
+          const localPkg = await Bun.file(localPkgPath).json() as {
+            dependencies?: Record<string, string>;
+            devDependencies?: Record<string, string>;
+            scripts?: Record<string, string>;
+          };
+
+          if (syncConfig.dependencies !== false && templatePkg.dependencies) {
+            if (!localPkg.dependencies) localPkg.dependencies = {};
+            for (const [name, version] of Object.entries(templatePkg.dependencies)) {
+              if (!(name in localPkg.dependencies)) {
+                localPkg.dependencies[name] = name in catalog ? "catalog:" : version;
+                depsAdded.push(name);
+              } else if (localPkg.dependencies[name] !== "catalog:" && version !== localPkg.dependencies[name]) {
+                localPkg.dependencies[name] = name in catalog ? "catalog:" : version;
+                depsUpdated.push(name);
+              }
+            }
+          }
+
+          if (syncConfig.devDependencies !== false && templatePkg.devDependencies) {
+            if (!localPkg.devDependencies) localPkg.devDependencies = {};
+            for (const [name, version] of Object.entries(templatePkg.devDependencies)) {
+              if (!(name in localPkg.devDependencies)) {
+                localPkg.devDependencies[name] = name in catalog ? "catalog:" : version;
+                depsAdded.push(name);
+              } else if (localPkg.devDependencies[name] !== "catalog:" && version !== localPkg.devDependencies[name]) {
+                localPkg.devDependencies[name] = name in catalog ? "catalog:" : version;
+                depsUpdated.push(name);
+              }
+            }
+          }
+
+          if (templatePkg.scripts) {
+            if (!localPkg.scripts) localPkg.scripts = {};
+            for (const [name, script] of Object.entries(templatePkg.scripts)) {
+              localPkg.scripts[name] = script;
+            }
+          }
+
+          await Bun.write(localPkgPath, JSON.stringify(localPkg, null, 2));
+        } catch {
+        }
+      }
+
+      results.push({
+        package: pkg,
+        files: filesSynced,
+        depsAdded: depsAdded.length > 0 ? depsAdded : undefined,
+        depsUpdated: depsUpdated.length > 0 ? depsUpdated : undefined,
+      });
+    } finally {
+      await rm(tempDir, { recursive: true, force: true });
+    }
+  }
+
+  return results;
+}

package/src/ui/index.ts

@@ -1,3 +1,5 @@
 export * from "./types";
 export * from "./runtime";
 export * from "./head";
+export * from "./files";
+export * from "./router";

package/src/ui/router.ts

@@ -0,0 +1,72 @@
+import type { AnyRouter } from "@tanstack/react-router";
+import type { HeadData, HeadLink, HeadMeta, HeadScript } from "./types";
+
+export function getMetaKey(meta: HeadMeta): string {
+  if (!meta) return "null";
+  if ("title" in meta) return "title";
+  if ("charSet" in meta) return "charSet";
+  if ("name" in meta) return `name:${(meta as { name: string }).name}`;
+  if ("property" in meta) return `property:${(meta as { property: string }).property}`;
+  if ("httpEquiv" in meta) return `httpEquiv:${(meta as { httpEquiv: string }).httpEquiv}`;
+  return JSON.stringify(meta);
+}
+
+export function getLinkKey(link: HeadLink): string {
+  const rel = (link as { rel?: string }).rel ?? "";
+  const href = (link as { href?: string }).href ?? "";
+  return `${rel}:${href}`;
+}
+
+export function getScriptKey(script: HeadScript): string {
+  if (!script) return "null";
+  if ("src" in script && script.src) return `src:${script.src}`;
+  if ("children" in script && script.children)
+    return `children:${typeof script.children === "string" ? script.children : JSON.stringify(script.children)}`;
+  return JSON.stringify(script);
+}
+
+export async function collectHeadData(router: AnyRouter): Promise<HeadData> {
+  await router.load();
+
+  const metaMap = new Map<string, HeadMeta>();
+  const linkMap = new Map<string, HeadLink>();
+  const scriptMap = new Map<string, HeadScript>();
+
+  for (const match of router.state.matches) {
+    const headFn = match.route?.options?.head;
+    if (!headFn) continue;
+
+    try {
+      const headResult = await headFn({
+        loaderData: match.loaderData,
+        matches: router.state.matches,
+        match,
+        params: match.params,
+      } as Parameters<typeof headFn>[0]);
+
+      if (headResult?.meta) {
+        for (const meta of headResult.meta) {
+          metaMap.set(getMetaKey(meta), meta);
+        }
+      }
+      if (headResult?.links) {
+        for (const link of headResult.links) {
+          linkMap.set(getLinkKey(link), link);
+        }
+      }
+      if (headResult?.scripts) {
+        for (const script of headResult.scripts) {
+          scriptMap.set(getScriptKey(script), script);
+        }
+      }
+    } catch (error) {
+      console.warn(`[collectHeadData] head() failed for ${match.routeId}:`, error);
+    }
+  }
+
+  return {
+    meta: [...metaMap.values()],
+    links: [...linkMap.values()],
+    scripts: [...scriptMap.values()],
+  };
+}