everything-dev 1.12.4 → 1.13.1

package/src/plugin.ts

@@ -27,37 +27,21 @@ import {
   getProjectRoot,
   loadConfig,
   resolveLocalDevelopmentPath,
+  writeResolvedConfig,
 } from "./config";
-import {
-  type BosConfigResult,
-  type BuildOptions,
-  bosContract,
-  type DevOptions,
-  type InitOptions,
-  type KeyPublishOptions,
-  type PluginAddOptions,
-  type PluginListResult,
-  type PluginPublishOptions,
-  type PluginRemoveOptions,
-  type PublishOptions,
-  type StartOptions,
-  type SyncOptions,
-  type TypesGenOptions,
-  type UpgradeOptions,
-} from "./contract";
+import { type BosConfigResult, bosContract, type PluginListResult } from "./contract";
 import { devApp, startApp } from "./dev-session";
 import {
   buildRegistryConfigUrl,
   buildRegistryConfigUrlForNetwork,
   fetchBosConfigFromFastKv,
-  fetchPluginFromRegistry,
   fetchRemotePluginManifest,
   getRegistryNamespaceForAccount,
   getRegistryNamespaceForNetwork,
   type PluginManifest,
-  parsePluginBosUrl,
 } from "./fastkv";
 import { computeSriHashForUrl } from "./integrity";
+import type { BosEnv } from "./merge";
 import { addFunctionCallAccessKey, ensureNearCli, executeTransaction } from "./near-cli";
 import { getNetworkIdForAccount } from "./network";
 import { createPlugin, z } from "./sdk";
@@ -67,8 +51,10 @@ import {
   buildServiceDescriptorMap,
 } from "./service-descriptor";
 import { syncAndGenerateSharedUi } from "./shared";
-import type { BosConfig, RuntimeConfig, SourceMode } from "./types";
+import { writePluginSidebarGen } from "./sidebar";
+import type { BosConfig, BosPluginRef, RuntimeConfig, SourceMode } from "./types";
 import { run } from "./utils/run";
+import { saveBosConfig } from "./utils/save-config";
 import { colors } from "./utils/theme";
 
 function ensureEnvFile(configDir: string, opts?: { domain?: string }): void {
@@ -119,6 +105,11 @@ type BosDeps = {
 
 type PluginAttachmentConfig = NonNullable<BosConfig["plugins"]>[string];
 
+function getPluginRef(entry: string | BosPluginRef | undefined | null): BosPluginRef | null {
+  if (!entry || typeof entry === "string") return null;
+  return entry;
+}
+
 function parseSourceMode(value: string | undefined, defaultValue: SourceMode): SourceMode {
   if (value === "local" || value === "remote") return value;
   return defaultValue;
@@ -167,7 +158,7 @@ function resolveWorkspaceTarget(
   const runtimePlugin = runtimeConfig?.plugins?.[key];
   const pluginPath =
     runtimePlugin?.localPath ??
-    resolveLocalDevelopmentPath(bosConfig?.plugins?.[key]?.development, configDir);
+    resolveLocalDevelopmentPath(getPluginRef(bosConfig?.plugins?.[key])?.development, configDir);
   if (pluginPath) {
     return {
       key,
@@ -223,7 +214,8 @@ function defaultPluginKey(source: string): string {
 }
 
 function pluginLocalPath(configDir: string, attachment: PluginAttachmentConfig): string | null {
-  const source = attachment.development ?? attachment.production;
+  const ref = getPluginRef(attachment);
+  const source = ref?.development ?? ref?.production;
   if (!source?.startsWith("local:")) {
     return null;
   }
@@ -231,34 +223,23 @@ function pluginLocalPath(configDir: string, attachment: PluginAttachmentConfig):
   return join(configDir, source.slice("local:".length));
 }
 
-async function saveBosConfig(configDir: string, config: BosConfig): Promise<void> {
-  const filePath = join(configDir, "bos.config.json");
-  const next = `${JSON.stringify(config, null, 2)}\n`;
-  try {
-    if (readFileSync(filePath, "utf8") === next) return;
-  } catch {
-    // file does not exist yet
-  }
-
-  writeFileSync(filePath, next);
-}
-
 function listPluginAttachments(config: BosConfig | null) {
   return (Object.entries(config?.plugins ?? {}) as Array<[string, PluginAttachmentConfig]>)
-    .map(([key, attachment]) => ({
-      key,
-      development: attachment.development,
-      production: attachment.production,
-      localPath: attachment.development?.startsWith("local:")
-        ? attachment.development.slice("local:".length)
-        : undefined,
-      source: attachment.development?.startsWith("local:")
-        ? ("local" as const)
-        : ("remote" as const),
-      integrity: attachment.integrity,
-      version: attachment.version,
-      name: attachment.name,
-    }))
+    .map(([key, attachment]) => {
+      const ref = getPluginRef(attachment);
+      return {
+        key,
+        development: ref?.development,
+        production: ref?.production,
+        localPath: ref?.development?.startsWith("local:")
+          ? ref.development.slice("local:".length)
+          : undefined,
+        source: ref?.development?.startsWith("local:") ? ("local" as const) : ("remote" as const),
+        integrity: ref?.integrity,
+        version: ref?.version,
+        name: ref?.name,
+      };
+    })
     .sort((a, b) => a.key.localeCompare(b.key));
 }
 
@@ -274,6 +255,8 @@ async function refreshApiContractBridge(
     runtimeConfig: refreshed.runtime,
     apiBaseUrl: refreshed.runtime.api.url,
   });
+
+  writePluginSidebarGen(configDir, refreshed.config);
 }
 
 function extractPublishedUrl(output: string): string | null {
@@ -417,6 +400,7 @@ async function buildWorkspaceTargets(opts: {
     configDir: opts.configDir,
     hostMode: "local",
     bosConfig: opts.bosConfig ?? undefined,
+    extendsChain: [],
   });
   if (sharedSync.catalogChanged) {
     await run("bun", ["install"], { cwd: opts.configDir });
@@ -472,7 +456,7 @@ export default createPlugin({
   }),
   secrets: z.object({}),
   contract: bosContract,
-  initialize: (config: any) =>
+  initialize: (config) =>
     Effect.promise(async () => {
       const configResult = await loadConfig({ path: config.variables.configPath });
       return {
@@ -482,10 +466,10 @@ export default createPlugin({
       } satisfies BosDeps;
     }),
   shutdown: () => Effect.void,
-  createRouter: (deps: BosDeps, builder: any) => ({
+  createRouter: (deps, builder) => ({
     config: builder.config.handler(async () => buildConfigResult(deps.bosConfig)),
 
-    pluginAdd: builder.pluginAdd.handler(async ({ input }: { input: PluginAddOptions }) => {
+    pluginAdd: builder.pluginAdd.handler(async ({ input }) => {
       if (!deps.bosConfig) {
         return {
           status: "error" as const,
@@ -494,90 +478,33 @@ export default createPlugin({
         };
       }
 
-      const pluginRef = parsePluginBosUrl(input.source);
-      let production = input.production ?? input.source;
-      let integrity: string | undefined;
-      let version: string | undefined;
-      let name: string | undefined;
-
-      if (pluginRef) {
-        try {
-          const entry = await fetchPluginFromRegistry(pluginRef.accountId, pluginRef.pluginName);
-          if (!entry) {
-            return {
-              status: "error" as const,
-              key: "",
-              error: `Plugin not found in registry: bos://${pluginRef.accountId}/plugins/${pluginRef.pluginName}`,
-            };
-          }
-
-          const manifest = entry.manifest;
-          if (
-            manifest.schemaVersion !== 1 ||
-            manifest.kind !== "every-plugin/manifest" ||
-            !manifest.plugin?.name ||
-            !manifest.plugin?.version ||
-            !manifest.runtime?.remoteEntry
-          ) {
-            return {
-              status: "error" as const,
-              key: "",
-              error: `Invalid plugin manifest for bos://${pluginRef.accountId}/plugins/${pluginRef.pluginName}`,
-            };
-          }
-
-          production = entry.metadata.cdnUrl || input.production || input.source;
-          name = manifest.plugin.name;
-          version = manifest.plugin.version;
-        } catch (error) {
-          return {
-            status: "error" as const,
-            key: "",
-            error: `Failed to resolve plugin from registry: ${error instanceof Error ? error.message : error}`,
-          };
-        }
-      }
-
-      if (!input.source.startsWith("local:") && !pluginRef && production.startsWith("https://")) {
-        try {
-          const manifest = await fetchRemotePluginManifest(production);
-          if (manifest) {
-            name = manifest.plugin.name;
-            version = manifest.plugin.version;
-          }
-        } catch {
-          console.warn(`[plugin add] Could not fetch manifest from ${production}`);
-        }
-      }
-
-      if (!input.source.startsWith("local:") && production.startsWith("https://")) {
-        try {
-          const computed = await computeSriHashForUrl(production);
-          if (computed) integrity = computed;
-        } catch {
-          console.warn(`[plugin add] Could not compute integrity for ${production}`);
-        }
-      }
-
+      const isBosRef = input.source.startsWith("bos://");
+      const isLocal = input.source.startsWith("local:");
       const key = sanitizePluginKey(
-        input.as ?? (pluginRef ? pluginRef.pluginName : defaultPluginKey(input.source)),
+        input.as ??
+          (isBosRef ? (input.source.split("/").pop() ?? "plugin") : defaultPluginKey(input.source)),
       );
       const existing = deps.bosConfig.plugins?.[key];
+      const existingEntry = existing && typeof existing === "object" ? existing : {};
       const nextPlugins = { ...(deps.bosConfig.plugins ?? {}) };
 
-      nextPlugins[key] = input.source.startsWith("local:")
-        ? {
-            ...(existing ?? {}),
-            development: input.source,
-            production: input.production ?? existing?.production,
-          }
-        : {
-            ...(existing ?? {}),
-            production,
-            ...(integrity ? { integrity } : {}),
-            ...(name ? { name } : {}),
-            ...(version ? { version } : {}),
-          };
+      if (isBosRef) {
+        nextPlugins[key] = {
+          ...existingEntry,
+          extends: input.source,
+        };
+      } else if (isLocal) {
+        nextPlugins[key] = {
+          ...existingEntry,
+          development: input.source,
+          ...(existingEntry.extends ? {} : {}),
+        };
+      } else {
+        nextPlugins[key] = {
+          ...existingEntry,
+          production: input.production ?? input.source,
+        };
+      }
 
       deps.bosConfig = {
         ...deps.bosConfig,
@@ -587,50 +514,51 @@ export default createPlugin({
       await saveBosConfig(deps.configDir, deps.bosConfig);
       await refreshApiContractBridge(deps.configDir);
 
+      const stored = deps.bosConfig.plugins?.[key];
+      const storedObj = stored && typeof stored === "object" ? stored : {};
+
       return {
         status: "added" as const,
         key,
-        development: deps.bosConfig.plugins?.[key]?.development,
-        production: deps.bosConfig.plugins?.[key]?.production,
-        integrity,
-        version,
+        development: storedObj.development,
+        production: storedObj.production,
+        integrity: storedObj.integrity,
+        version: storedObj.version,
       };
     }),
 
-    pluginRemove: builder.pluginRemove.handler(
-      async ({ input }: { input: PluginRemoveOptions }) => {
-        if (!deps.bosConfig) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: "No bos.config.json found",
-          };
-        }
-
-        if (!deps.bosConfig.plugins?.[input.key]) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: `Plugin '${input.key}' is not configured`,
-          };
-        }
-
-        const nextPlugins = { ...(deps.bosConfig.plugins ?? {}) };
-        delete nextPlugins[input.key];
-        deps.bosConfig = {
-          ...deps.bosConfig,
-          plugins: Object.keys(nextPlugins).length > 0 ? nextPlugins : undefined,
+    pluginRemove: builder.pluginRemove.handler(async ({ input }) => {
+      if (!deps.bosConfig) {
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: "No bos.config.json found",
         };
+      }
 
-        await saveBosConfig(deps.configDir, deps.bosConfig);
-        await refreshApiContractBridge(deps.configDir);
-
+      if (!deps.bosConfig.plugins?.[input.key]) {
         return {
-          status: "removed" as const,
+          status: "error" as const,
           key: input.key,
+          error: `Plugin '${input.key}' is not configured`,
         };
-      },
-    ),
+      }
+
+      const nextPlugins = { ...(deps.bosConfig.plugins ?? {}) };
+      delete nextPlugins[input.key];
+      deps.bosConfig = {
+        ...deps.bosConfig,
+        plugins: Object.keys(nextPlugins).length > 0 ? nextPlugins : undefined,
+      };
+
+      await saveBosConfig(deps.configDir, deps.bosConfig);
+      await refreshApiContractBridge(deps.configDir);
+
+      return {
+        status: "removed" as const,
+        key: input.key,
+      };
+    }),
 
     pluginList: builder.pluginList.handler(async () => {
       const plugins: PluginListResult["plugins"] = listPluginAttachments(deps.bosConfig);
@@ -640,166 +568,202 @@ export default createPlugin({
       };
     }),
 
-    pluginPublish: builder.pluginPublish.handler(
-      async ({ input }: { input: PluginPublishOptions }) => {
-        if (!deps.bosConfig) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: "No bos.config.json found",
-          };
-        }
+    pluginPublish: builder.pluginPublish.handler(async ({ input }) => {
+      if (!deps.bosConfig) {
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: "No bos.config.json found",
+        };
+      }
 
-        const attachment = deps.bosConfig.plugins?.[input.key];
-        if (!attachment) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: `Plugin '${input.key}' is not configured`,
-          };
-        }
+      const attachment = deps.bosConfig.plugins?.[input.key];
+      if (!attachment) {
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: `Plugin '${input.key}' is not configured`,
+        };
+      }
 
-        const localPath = pluginLocalPath(deps.configDir, attachment);
-        if (!localPath) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: `Plugin '${input.key}' does not have a local development path`,
-          };
-        }
+      const attachmentRef = getPluginRef(attachment);
 
-        const pkgPath = join(localPath, "package.json");
-        if (!(await Bun.file(pkgPath).exists())) {
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: `Missing package.json at ${localPath}`,
-          };
-        }
+      const localPath = pluginLocalPath(deps.configDir, attachment);
+      if (!localPath) {
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: `Plugin '${input.key}' does not have a local development path`,
+        };
+      }
 
-        const pkgJson = (await Bun.file(pkgPath).json()) as {
-          scripts?: Record<string, string>;
-          name?: string;
-          version?: string;
+      const pkgPath = join(localPath, "package.json");
+      if (!(await Bun.file(pkgPath).exists())) {
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: `Missing package.json at ${localPath}`,
         };
-        const script = pkgJson.scripts?.deploy ? "deploy" : "build";
+      }
 
-        const { stdout, stderr, exitCode } = (await run("bun", ["run", script], {
-          cwd: localPath,
-          capture: true,
-        })) as { stdout: string; stderr: string; exitCode: number };
+      const pkgJson = (await Bun.file(pkgPath).json()) as {
+        scripts?: Record<string, string>;
+        name?: string;
+        version?: string;
+      };
+      const script = pkgJson.scripts?.deploy ? "deploy" : "build";
 
-        if (exitCode !== 0) {
-          if (stdout.trim()) process.stdout.write(stdout);
-          if (stderr.trim()) process.stderr.write(stderr);
-          return {
-            status: "error" as const,
-            key: input.key,
-            error: `Publish failed with exit code ${exitCode}`,
-          };
-        }
+      const { stdout, stderr, exitCode } = (await run("bun", ["run", script], {
+        cwd: localPath,
+        capture: true,
+      })) as { stdout: string; stderr: string; exitCode: number };
 
+      if (exitCode !== 0) {
         if (stdout.trim()) process.stdout.write(stdout);
         if (stderr.trim()) process.stderr.write(stderr);
+        return {
+          status: "error" as const,
+          key: input.key,
+          error: `Publish failed with exit code ${exitCode}`,
+        };
+      }
+
+      if (stdout.trim()) process.stdout.write(stdout);
+      if (stderr.trim()) process.stderr.write(stderr);
+
+      let publishedUrl = extractPublishedUrl(`${stdout}\n${stderr}`);
+
+      let manifest: PluginManifest | null = null;
+      if (publishedUrl) {
+        manifest = await fetchRemotePluginManifest(publishedUrl);
+      } else if (attachmentRef?.production) {
+        manifest = await fetchRemotePluginManifest(attachmentRef.production);
+        if (manifest) {
+          publishedUrl = attachmentRef.production;
+        }
+      }
 
-        let publishedUrl = extractPublishedUrl(`${stdout}\n${stderr}`);
+      const integrity = publishedUrl ? await computeSriHashForUrl(publishedUrl) : null;
+      const version = manifest?.plugin.version ?? pkgJson.version;
 
-        let manifest: PluginManifest | null = null;
-        if (publishedUrl) {
-          manifest = await fetchRemotePluginManifest(publishedUrl);
-        } else if (attachment.production) {
-          manifest = await fetchRemotePluginManifest(attachment.production);
-          if (manifest) {
-            publishedUrl = attachment.production;
+      if (publishedUrl) {
+        const pluginConfigPath = join(localPath, "bos.config.json");
+        if (existsSync(pluginConfigPath)) {
+          try {
+            const pluginConfig = JSON.parse(readFileSync(pluginConfigPath, "utf-8")) as Record<
+              string,
+              unknown
+            >;
+            if (!pluginConfig.app) pluginConfig.app = {};
+            const app = pluginConfig.app as Record<string, unknown>;
+            if (!app.api) app.api = {};
+            const api = app.api as Record<string, unknown>;
+            api.production = publishedUrl;
+            if (integrity) {
+              api.integrity = integrity;
+            } else {
+              delete api.integrity;
+            }
+            writeFileSync(pluginConfigPath, `${JSON.stringify(pluginConfig, null, 2)}\n`);
+            console.log(`   ✅ Updated ${pluginConfigPath}: app.api.production`);
+          } catch (err) {
+            console.error(
+              `   ❌ Failed to update plugin bos.config.json:`,
+              err instanceof Error ? err.message : err,
+            );
           }
         }
 
-        const integrity = publishedUrl ? await computeSriHashForUrl(publishedUrl) : null;
-        const version = manifest?.plugin.version ?? pkgJson.version;
-
-        if (publishedUrl) {
-          deps.bosConfig = {
-            ...deps.bosConfig,
-            plugins: {
-              ...(deps.bosConfig.plugins ?? {}),
-              [input.key]: {
-                ...(deps.bosConfig.plugins?.[input.key] ?? {}),
-                production: publishedUrl,
-                ...(integrity ? { integrity } : {}),
-                ...(manifest?.plugin.name ? { name: manifest.plugin.name } : {}),
-                ...(version ? { version } : {}),
-              },
-            },
-          };
-          await saveBosConfig(deps.configDir, deps.bosConfig);
+        const account = deps.bosConfig.account;
+        const network = getNetworkIdForAccount(account);
+
+        let pluginDomain: string | undefined;
+        if (existsSync(pluginConfigPath)) {
+          try {
+            const pluginConfig = JSON.parse(readFileSync(pluginConfigPath, "utf-8"));
+            if (typeof pluginConfig.domain === "string") {
+              pluginDomain = pluginConfig.domain;
+            }
+          } catch {}
+        }
+        if (!pluginDomain) {
+          pluginDomain = `${input.key}.${deps.bosConfig.domain ?? "everything.dev"}`;
+        }
+
+        if (manifest && version) {
+          try {
+            const registryEntries: Record<string, string> = {
+              [`plugins/${account}/${input.key}/manifest.json`]: JSON.stringify(manifest),
+              [`plugins/${account}/${input.key}/metadata`]: JSON.stringify({
+                title: null,
+                description: null,
+                repoUrl: deps.bosConfig.repository ?? null,
+                version,
+                publishedAt: new Date().toISOString(),
+                cdnUrl: publishedUrl,
+                integrity,
+              }),
+              [`plugins/${account}/${input.key}/versions/${version}/manifest.json`]:
+                JSON.stringify(manifest),
+            };
+
+            if (existsSync(pluginConfigPath)) {
+              try {
+                const publishedPluginConfig = JSON.parse(readFileSync(pluginConfigPath, "utf-8"));
+                delete publishedPluginConfig.development;
+                registryEntries[`apps/${account}/${pluginDomain}/bos.config.json`] =
+                  JSON.stringify(publishedPluginConfig);
+              } catch {}
+            }
+
+            const payload = JSON.stringify(registryEntries);
+            const argsBase64 = Buffer.from(payload).toString("base64");
+            const privateKey = process.env.NEAR_PRIVATE_KEY || process.env.BOS_NEAR_PRIVATE_KEY;
 
-          const account = deps.bosConfig.account;
-          const network = getNetworkIdForAccount(account);
-          if (manifest && version) {
+            await Effect.runPromise(ensureNearCli);
             try {
-              const registryEntries: Record<string, string> = {
-                [`plugins/${account}/${input.key}/manifest.json`]: JSON.stringify(manifest),
-                [`plugins/${account}/${input.key}/metadata`]: JSON.stringify({
-                  title: null,
-                  description: null,
-                  repoUrl: deps.bosConfig.repository ?? null,
-                  version,
-                  publishedAt: new Date().toISOString(),
-                  cdnUrl: publishedUrl,
-                  integrity,
+              await Effect.runPromise(
+                executeTransaction({
+                  account,
+                  contract: getRegistryNamespaceForNetwork(network),
+                  method: "__fastdata_kv",
+                  argsBase64,
+                  network,
+                  privateKey,
+                  gas: "50Tgas",
+                  deposit: "0NEAR",
                 }),
-                [`plugins/${account}/${input.key}/versions/${version}/manifest.json`]:
-                  JSON.stringify(manifest),
-              };
-              const payload = JSON.stringify(registryEntries);
-              const argsBase64 = Buffer.from(payload).toString("base64");
-              const privateKey = process.env.NEAR_PRIVATE_KEY || process.env.BOS_NEAR_PRIVATE_KEY;
-
-              await Effect.runPromise(ensureNearCli);
-              try {
-                await Effect.runPromise(
-                  executeTransaction({
-                    account,
-                    contract: getRegistryNamespaceForNetwork(network),
-                    method: "__fastdata_kv",
-                    argsBase64,
-                    network,
-                    privateKey,
-                    gas: "50Tgas",
-                    deposit: "0NEAR",
-                  }),
+              );
+            } catch (registryError) {
+              const txHash = extractTransactionHash(registryError);
+              if (!txHash) {
+                console.warn(
+                  `[publish] Plugin registry write failed: ${registryError instanceof Error ? registryError.message : registryError}`,
                 );
-              } catch (registryError) {
-                const txHash = extractTransactionHash(registryError);
-                if (!txHash) {
-                  console.warn(
-                    `[publish] Plugin registry write failed: ${registryError instanceof Error ? registryError.message : registryError}`,
-                  );
-                }
               }
-            } catch (registryError) {
-              console.warn(
-                `[publish] Plugin registry write skipped: ${registryError instanceof Error ? registryError.message : registryError}`,
-              );
             }
+          } catch (registryError) {
+            console.warn(
+              `[publish] Plugin registry write skipped: ${registryError instanceof Error ? registryError.message : registryError}`,
+            );
           }
-
-          await refreshApiContractBridge(deps.configDir);
         }
 
-        return {
-          status: "published" as const,
-          key: input.key,
-          path: localPath,
-          script,
-          production: publishedUrl ?? attachment.production,
-          integrity: integrity ?? undefined,
-          version: version ?? undefined,
-        };
-      },
-    ),
+        await refreshApiContractBridge(deps.configDir);
+      }
 
-    dev: builder.dev.handler(async ({ input }: { input: DevOptions }) => {
+      return {
+        status: "published" as const,
+        key: input.key,
+        path: localPath,
+        script,
+        production: publishedUrl ?? attachmentRef?.production,
+        integrity: integrity ?? undefined,
+        version: version ?? undefined,
+      };
+    }),
+
+    dev: builder.dev.handler(async ({ input }) => {
       ensureEnvFile(deps.configDir);
 
       const localPackages = detectLocalPackages(
@@ -808,16 +772,16 @@ export default createPlugin({
       );
 
       const hostSource: SourceMode = localPackages.includes("host")
-        ? parseSourceMode(input.host as string, "local")
+        ? parseSourceMode(input.host, "local")
         : "remote";
       const uiSource: SourceMode = localPackages.includes("ui")
-        ? parseSourceMode(input.ui as string, "local")
+        ? parseSourceMode(input.ui, "local")
         : "remote";
       const apiSource: SourceMode = localPackages.includes("api")
-        ? parseSourceMode(input.api as string, "local")
+        ? parseSourceMode(input.api, "local")
         : "remote";
       const authSource: SourceMode = localPackages.includes("auth")
-        ? parseSourceMode(input.auth as string, "local")
+        ? parseSourceMode(input.auth, "local")
         : "remote";
       const ssr = input.ssr ?? false;
       const proxy = input.proxy ?? false;
@@ -826,6 +790,7 @@ export default createPlugin({
         configDir: deps.configDir,
         hostMode: hostSource,
         bosConfig: deps.bosConfig ?? undefined,
+        extendsChain: [],
       });
       if (sharedSync.catalogChanged) {
         await run("bun", ["install"], { cwd: deps.configDir });
@@ -843,6 +808,16 @@ export default createPlugin({
       deps.bosConfig = refreshed?.config ?? deps.bosConfig;
       deps.runtimeConfig = refreshed?.runtime ?? deps.runtimeConfig;
 
+      if (deps.bosConfig) {
+        writeResolvedConfig(
+          deps.configDir,
+          deps.bosConfig,
+          "development",
+          refreshed?.source.extended,
+        );
+        writePluginSidebarGen(deps.configDir, deps.bosConfig);
+      }
+
       if (!deps.bosConfig) {
         return {
           status: "error" as const,
@@ -905,7 +880,7 @@ export default createPlugin({
       };
     }),
 
-    start: builder.start.handler(async ({ input }: { input: StartOptions }) => {
+    start: builder.start.handler(async ({ input }) => {
       ensureEnvFile(deps.configDir);
 
       const account = input.account ?? process.env.BOS_ACCOUNT;
@@ -962,6 +937,8 @@ export default createPlugin({
         plugins: runtimePlugins,
       });
 
+      writePluginSidebarGen(deps.configDir, config);
+
       // ── Production Readiness Validation ──
       const productionEnv: Record<string, string> = {};
       const warnings: string[] = [];
@@ -1064,7 +1041,7 @@ export default createPlugin({
       };
     }),
 
-    build: builder.build.handler(async ({ input }: { input: BuildOptions }) => {
+    build: builder.build.handler(async ({ input }) => {
       if (!deps.bosConfig) {
         return {
           status: "error" as const,
@@ -1073,6 +1050,11 @@ export default createPlugin({
         };
       }
 
+      const buildEnv: BosEnv = input.deploy ? "production" : "development";
+
+      writeResolvedConfig(deps.configDir, deps.bosConfig, buildEnv);
+      writePluginSidebarGen(deps.configDir, deps.bosConfig);
+
       const targets = selectWorkspaceTargets(input.packages, deps.bosConfig);
       if (targets.length === 0) {
         return {
@@ -1087,7 +1069,7 @@ export default createPlugin({
         apiSource: deps.bosConfig.app.api?.development ? "local" : "remote",
         authSource: deps.bosConfig.app.auth?.development ? "local" : "remote",
         hostSource: deps.bosConfig.app.host?.development ? "local" : "remote",
-        env: "development",
+        env: buildEnv,
         plugins: deps.runtimeConfig?.plugins,
       });
 
@@ -1121,7 +1103,7 @@ export default createPlugin({
       };
     }),
 
-    publish: builder.publish.handler(async ({ input }: { input: PublishOptions }) => {
+    publish: builder.publish.handler(async ({ input }) => {
       if (!deps.bosConfig) {
         return {
           status: "error" as const,
@@ -1177,9 +1159,34 @@ export default createPlugin({
         }
       }
 
-      const payload = JSON.stringify({
+      const registryEntries: Record<string, string> = {
         [`apps/${account}/${gateway}/bos.config.json`]: JSON.stringify(publishConfig),
-      });
+      };
+
+      for (const [pluginKey, pluginEntry] of Object.entries(publishConfig.plugins ?? {})) {
+        const pluginRef = getPluginRef(pluginEntry);
+        if (!pluginRef?.development?.startsWith("local:")) continue;
+
+        const localPath = join(deps.configDir, pluginRef.development.slice("local:".length));
+        const pluginConfigPath = join(localPath, "bos.config.json");
+        if (!existsSync(pluginConfigPath)) continue;
+
+        try {
+          const pluginConfig = JSON.parse(readFileSync(pluginConfigPath, "utf-8")) as Record<
+            string,
+            unknown
+          >;
+          const pluginDomain =
+            typeof pluginConfig.domain === "string"
+              ? pluginConfig.domain
+              : `${pluginKey}.${gateway}`;
+          delete pluginConfig.development;
+          registryEntries[`apps/${account}/${pluginDomain}/bos.config.json`] =
+            JSON.stringify(pluginConfig);
+        } catch {}
+      }
+
+      const payload = JSON.stringify(registryEntries);
       const argsBase64 = Buffer.from(payload).toString("base64");
       const privateKey =
         input.privateKey || process.env.NEAR_PRIVATE_KEY || process.env.BOS_NEAR_PRIVATE_KEY;
@@ -1238,7 +1245,7 @@ export default createPlugin({
       }
     }),
 
-    keyPublish: builder.keyPublish.handler(async ({ input }: { input: KeyPublishOptions }) => {
+    keyPublish: builder.keyPublish.handler(async ({ input }) => {
       if (!deps.bosConfig) {
         return {
           status: "error" as const,
@@ -1287,7 +1294,7 @@ export default createPlugin({
       }
     }),
 
-    init: builder.init.handler(async ({ input }: { input: InitOptions }) => {
+    init: builder.init.handler(async ({ input }) => {
       try {
         let extendsAccount = input.extendsAccount;
         let extendsGateway = input.extendsGateway;
@@ -1328,7 +1335,7 @@ export default createPlugin({
         extendsAccount = extendsAccount || "dev.everything.near";
         extendsGateway = extendsGateway || "everything.dev";
         directory = directory || domain || extendsGateway;
-        plugins = plugins?.length ? plugins : ["_template"];
+        plugins = plugins?.length ? plugins : ["settings"];
 
         try {
           await fetchParentConfig(extendsAccount, extendsGateway);
@@ -1372,9 +1379,10 @@ export default createPlugin({
 
           const pluginRoutes: Record<string, string[]> = {};
           if (parentConfig.plugins) {
-            for (const [key, ref] of Object.entries(parentConfig.plugins)) {
-              if (ref.routes && ref.routes.length > 0) {
-                pluginRoutes[key] = ref.routes;
+            for (const [key, entry] of Object.entries(parentConfig.plugins)) {
+              const entryRef = getPluginRef(entry);
+              if (entryRef?.routes && entryRef.routes.length > 0) {
+                pluginRoutes[key] = entryRef.routes;
               }
             }
           }
@@ -1413,6 +1421,11 @@ export default createPlugin({
             await generateDatabaseMigrations(directory);
           }
 
+          const initConfig = await loadConfig({ cwd: directory });
+          if (initConfig?.config) {
+            writePluginSidebarGen(directory, initConfig.config);
+          }
+
           s.stop("Project initialized");
 
           return {
@@ -1448,7 +1461,7 @@ export default createPlugin({
       }
     }),
 
-    sync: builder.sync.handler(async ({ input }: { input: SyncOptions }) => {
+    sync: builder.sync.handler(async ({ input }) => {
       try {
         const configPath = findConfigPath();
         if (!configPath) {
@@ -1462,7 +1475,16 @@ export default createPlugin({
         }
 
         const projectDir = resolve(dirname(configPath));
-        return await syncTemplate(projectDir, input);
+        const result = await syncTemplate(projectDir, input);
+
+        if (result.status === "synced" || result.status === "dry-run") {
+          const syncedConfig = await loadConfig({ cwd: projectDir });
+          if (syncedConfig?.config) {
+            writePluginSidebarGen(projectDir, syncedConfig.config);
+          }
+        }
+
+        return result;
       } catch (error) {
         return {
           status: "error" as const,
@@ -1474,7 +1496,7 @@ export default createPlugin({
       }
     }),
 
-    upgrade: builder.upgrade.handler(async ({ input }: { input: UpgradeOptions }) => {
+    upgrade: builder.upgrade.handler(async ({ input }) => {
       try {
         const configPath = findConfigPath();
         if (!configPath) {
@@ -1496,7 +1518,7 @@ export default createPlugin({
       }
     }),
 
-    typesGen: builder.typesGen.handler(async ({ input }: { input: TypesGenOptions }) => {
+    typesGen: builder.typesGen.handler(async ({ input }) => {
       try {
         const configPath = findConfigPath();
         if (!configPath) {