everything-dev 1.20.0 → 1.22.0

package/src/cli/prompts.ts

@@ -1,5 +1,6 @@
 import process from "node:process";
 import * as p from "@clack/prompts";
+import type { OverrideSection } from "../contract";
 
 function parseExtendsRef(ref: string): { account: string; gateway: string } | null {
   const normalized = ref.startsWith("bos://") ? ref : `bos://${ref}`;
@@ -17,13 +18,20 @@ function deriveAccountFromExtends(domain: string, extendsAccount: string): strin
   return `${firstSegment}.${suffix}`;
 }
 
+const OVERRIDE_OPTIONS: { value: OverrideSection; label: string; hint: string }[] = [
+  { value: "ui", label: "ui", hint: "Override UI with local source" },
+  { value: "api", label: "api", hint: "Override API with local source" },
+  { value: "host", label: "host", hint: "Override host with local source" },
+  { value: "plugins", label: "plugins", hint: "Override selected plugins with local source" },
+];
+
 export async function promptInitOptions(input: {
   extends?: string;
   directory?: string;
   account?: string;
   domain?: string;
   plugins?: string[];
-  withHost?: boolean;
+  overrides?: OverrideSection[];
   parentPluginKeys?: string[];
 }): Promise<{
   extendsAccount: string;
@@ -32,7 +40,7 @@ export async function promptInitOptions(input: {
   account?: string;
   domain?: string;
   plugins: string[];
-  withHost: boolean;
+  overrides: OverrideSection[];
 }> {
   p.intro("Let's build an app...");
 
@@ -78,34 +86,43 @@ export async function promptInitOptions(input: {
 
   const directory = input.directory || domain || extendsGateway;
 
-  const parentPlugins = input.parentPluginKeys ?? [];
-  const pluginOptions =
-    parentPlugins.length > 0 ? parentPlugins.map((key) => ({ value: key, label: key })) : [];
-
-  const plugins =
-    input.plugins ??
-    (pluginOptions.length > 0
-      ? ((await p.multiselect({
-          message: "Select plugins:",
-          options: pluginOptions,
-          required: false,
-        })) as string[])
-      : []);
-
-  if (p.isCancel(plugins)) process.exit(0);
-
-  const go =
-    input.withHost !== undefined
-      ? true
-      : await p.confirm({
-          message: "GO!",
-          initialValue: true,
-        });
+  const overrides =
+    input.overrides ??
+    ((await p.multiselect({
+      message: "Which sections to override locally?",
+      options: OVERRIDE_OPTIONS,
+      initialValues: ["ui", "api"] as OverrideSection[],
+      required: false,
+    })) as OverrideSection[]);
+
+  if (p.isCancel(overrides)) process.exit(0);
+
+  let plugins: string[] = [];
+  if (overrides.includes("plugins")) {
+    const parentPlugins = input.parentPluginKeys ?? [];
+    const pluginOptions =
+      parentPlugins.length > 0 ? parentPlugins.map((key) => ({ value: key, label: key })) : [];
+
+    plugins =
+      input.plugins ??
+      (pluginOptions.length > 0
+        ? ((await p.multiselect({
+            message: "Select plugins to include:",
+            options: pluginOptions,
+            required: false,
+          })) as string[])
+        : []);
+
+    if (p.isCancel(plugins)) process.exit(0);
+  }
+
+  const go = await p.confirm({
+    message: "GO!",
+    initialValue: true,
+  });
 
   if (p.isCancel(go) || !go) process.exit(0);
 
-  const withHost = input.withHost ?? false;
-
   return {
     extendsAccount,
     extendsGateway,
@@ -113,6 +130,6 @@ export async function promptInitOptions(input: {
     account: account || undefined,
     domain: domain || undefined,
     plugins,
-    withHost,
+    overrides,
   };
 }

package/src/cli/sync.ts

@@ -491,6 +491,7 @@ export async function syncTemplate(projectDir: string, options: SyncOptions): Pr
       domain,
       plugins: childPlugins,
       pluginRoutes,
+      overrides: ["ui", "api", "host", "plugins"],
       workspaceOpts: { sourceDir },
       mode: "sync",
     });

package/src/cli.ts

@@ -70,9 +70,14 @@ async function warnIfOutdated(client: any, command: string): Promise<void> {
     const status = await client.status();
     if (status.status === "error" || !status.packages) return;
 
+    const frameworkPackages = ["everything-dev", "every-plugin"];
+
     const outdated = status.packages.filter(
       (p: { name: string; installed?: string; latest?: string }) =>
-        p.installed && p.latest && normalizeVersion(p.installed) !== normalizeVersion(p.latest),
+        p.installed &&
+        p.latest &&
+        normalizeVersion(p.installed) !== normalizeVersion(p.latest) &&
+        frameworkPackages.includes(p.name),
     );
 
     if (outdated.length === 0) return;
@@ -162,6 +167,8 @@ async function main() {
       console.log(`  ${colors.dim("Directory:")} ${result.directory}`);
       if (result.account) console.log(`  ${colors.dim("Account:")} ${result.account}`);
       if (result.domain) console.log(`  ${colors.dim("Domain:")} ${result.domain}`);
+      if (result.overrides && result.overrides.length > 0)
+        console.log(`  ${colors.dim("Overrides:")} ${result.overrides.join(", ")}`);
       if (result.plugins && result.plugins.length > 0)
         console.log(`  ${colors.dim("Plugins:")} ${result.plugins.join(", ")}`);
       console.log(`  ${colors.dim("Files copied:")} ${result.filesCopied}`);

package/src/contract.meta.ts

@@ -92,8 +92,12 @@ export const cliCommandMeta = {
       account: { description: "New project NEAR account (auto-derived from extends)" },
       directory: { description: "Target directory (auto-derived from domain)" },
       source: { description: "Local source dir (skips GitHub download)" },
-      plugins: { description: "Comma-separated plugin keys to include" },
-      withHost: { description: "Include host/ in template output" },
+      plugins: {
+        description: "Comma-separated plugin keys to include (requires --overrides=plugins)",
+      },
+      overrides: {
+        description: "Comma-separated sections to override locally: ui,api,host,plugins",
+      },
       noInteractive: { description: "Skip prompts, use flags only" },
       noInstall: { description: "Skip bun install" },
     },

package/src/contract.ts

@@ -142,6 +142,8 @@ export const KeyPublishResultSchema = z.object({
   error: z.string().optional(),
 });
 
+export const OverrideSectionSchema = z.enum(["ui", "api", "host", "plugins"]);
+
 export const InitOptionsSchema = z.object({
   extends: z.string().optional(),
   directory: z.string().optional(),
@@ -149,7 +151,7 @@ export const InitOptionsSchema = z.object({
   domain: z.string().optional(),
   source: z.string().optional(),
   plugins: z.array(z.string()).optional(),
-  withHost: z.boolean().default(false),
+  overrides: z.array(OverrideSectionSchema).optional(),
   noInteractive: z.boolean().default(false),
   noInstall: z.boolean().default(false),
 });
@@ -167,6 +169,7 @@ export const InitResultSchema = z.object({
   domain: z.string().optional(),
   extends: z.string(),
   plugins: z.array(z.string()).optional(),
+  overrides: z.array(OverrideSectionSchema).optional(),
   filesCopied: z.number(),
   timings: z.array(PhaseTimingSchema).optional(),
   error: z.string().optional(),
@@ -311,6 +314,7 @@ export type KeyPublishOptions = z.infer<typeof KeyPublishOptionsSchema>;
 export type KeyPublishResult = z.infer<typeof KeyPublishResultSchema>;
 export type InitOptions = z.infer<typeof InitOptionsSchema>;
 export type InitResult = z.infer<typeof InitResultSchema>;
+export type OverrideSection = z.infer<typeof OverrideSectionSchema>;
 export type PhaseTiming = z.infer<typeof PhaseTimingSchema>;
 export type SyncOptions = z.infer<typeof SyncOptionsSchema>;
 export type SyncResult = z.infer<typeof SyncResultSchema>;

package/src/fastkv.ts

@@ -141,8 +141,13 @@ export interface PluginManifest {
 
 export async function fetchRemotePluginManifest(cdnUrl: string): Promise<PluginManifest | null> {
   try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FASTKV_TIMEOUT_MS);
     const baseUrl = cdnUrl.replace(/\/$/, "");
-    const response = await fetch(`${baseUrl}/plugin.manifest.json`);
+    const response = await fetch(`${baseUrl}/plugin.manifest.json`, {
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
     if (!response.ok) return null;
     return (await response.json()) as PluginManifest;
   } catch {

package/src/plugin.ts

@@ -7,6 +7,7 @@ import { buildRuntimeConfig, detectLocalPackages, prepareDevelopmentRuntimeConfi
 import { ensureEnvFile, writeGeneratedInfra } from "./cli/infra";
 import {
   copyFilteredFiles,
+  detectGitRemoteUrl,
   fetchParentConfig,
   generateDatabaseMigrations,
   personalizeConfig,
@@ -35,6 +36,7 @@ import {
 import {
   type BosConfigResult,
   bosContract,
+  type OverrideSection,
   type PhaseTiming,
   type PluginListResult,
 } from "./contract";
@@ -1196,7 +1198,7 @@ export default createPlugin({
         let directory = input.directory;
         let account = input.account;
         let domain = input.domain;
-        let withHost = input.withHost;
+        let overrides = input.overrides as OverrideSection[] | undefined;
         let plugins = input.plugins;
 
         if (input.extends) {
@@ -1238,7 +1240,7 @@ export default createPlugin({
             account,
             domain,
             plugins,
-            withHost,
+            overrides,
             parentPluginKeys,
           });
           extendsAccount = prompted.extendsAccount;
@@ -1246,16 +1248,29 @@ export default createPlugin({
           directory = prompted.directory;
           account = prompted.account;
           domain = prompted.domain;
-          withHost = prompted.withHost;
           plugins = prompted.plugins;
+          overrides = prompted.overrides;
           s.start("Setting up project");
         }
 
+        overrides = overrides?.length ? overrides : (["ui", "api"] as OverrideSection[]);
+        if (overrides.includes("plugins") && !plugins?.length) {
+          plugins = parentPluginKeys;
+        }
+        plugins = plugins ?? [];
+
         directory = directory || domain || extendsGateway;
         const targetDir = resolve(directory);
-        plugins = plugins ?? [];
         const extendsRef = `bos://${extendsAccount}/${extendsGateway}`;
 
+        if (overrides.includes("plugins") && !plugins.length) {
+          // explicitly selected plugins override with none selected — back out of all inherited plugins
+        }
+
+        const repository =
+          (await detectGitRemoteUrl(process.cwd()).catch(() => undefined)) ??
+          parentConfig?.repository;
+
         if (!parentConfig) {
           try {
             parentConfig = await timePhase(
@@ -1273,7 +1288,8 @@ export default createPlugin({
               account,
               domain,
               extends: extendsRef,
-              plugins: plugins ?? [],
+              plugins,
+              overrides,
               filesCopied: 0,
               timings,
               error: `No config found at ${extendsRef} — are you sure this is the right parent?`,
@@ -1315,7 +1331,25 @@ export default createPlugin({
                   account: account || extendsAccount,
                   domain,
                   plugins,
-                  withHost,
+                  overrides,
+                  repository,
+                }),
+              s,
+            );
+
+            await timePhase(
+              timings,
+              "personalize config",
+              () =>
+                personalizeConfig(targetDir, {
+                  extendsAccount,
+                  extendsGateway,
+                  account: account || extendsAccount,
+                  domain: domain || extendsGateway,
+                  plugins,
+                  overrides,
+                  mode: "init",
+                  repository,
                 }),
               s,
             );
@@ -1330,21 +1364,24 @@ export default createPlugin({
                 account,
                 domain,
                 extends: extendsRef,
-                plugins: plugins ?? [],
+                plugins,
+                overrides,
                 filesCopied: 0,
                 error: "No .templatekeep found in template source",
               };
             }
 
             const pluginRoutes: Record<string, string[]> = {};
-            const parentRuntimePlugins = await buildRuntimePluginsForConfig(
-              parentConfig as BosConfig,
-              sourceDir,
-              "production",
-            );
-            for (const [key, plugin] of Object.entries(parentRuntimePlugins ?? {})) {
-              if (plugin.routes && plugin.routes.length > 0) {
-                pluginRoutes[key] = plugin.routes;
+            if (overrides.includes("plugins")) {
+              const parentRuntimePlugins = await buildRuntimePluginsForConfig(
+                parentConfig as BosConfig,
+                sourceDir,
+                "production",
+              );
+              for (const [key, plugin] of Object.entries(parentRuntimePlugins ?? {})) {
+                if (plugin.routes && plugin.routes.length > 0) {
+                  pluginRoutes[key] = plugin.routes;
+                }
               }
             }
 
@@ -1353,7 +1390,7 @@ export default createPlugin({
               "copy files",
               () =>
                 copyFilteredFiles(sourceDir, targetDir, patterns, {
-                  withHost,
+                  overrides,
                   plugins,
                   pluginRoutes,
                 }),
@@ -1370,9 +1407,10 @@ export default createPlugin({
                   account: account || extendsAccount,
                   domain: domain || extendsGateway,
                   plugins,
+                  overrides,
                   pluginRoutes,
                   workspaceOpts: { sourceDir },
-                  withHost,
+                  repository,
                 }),
               s,
             );
@@ -1382,7 +1420,7 @@ export default createPlugin({
               "write snapshot",
               () =>
                 writeInitSnapshot(targetDir, extendsAccount, extendsGateway, sourceDir, patterns, {
-                  withHost,
+                  overrides,
                   plugins,
                   pluginRoutes,
                 }),
@@ -1466,6 +1504,7 @@ export default createPlugin({
             domain,
             extends: extendsRef,
             plugins,
+            overrides,
             filesCopied,
             timings,
           };
@@ -1486,6 +1525,7 @@ export default createPlugin({
           domain: input.domain,
           extends: extendsRef,
           plugins: input.plugins ?? [],
+          overrides: input.overrides,
           filesCopied: 0,
           timings: [],
           error: error instanceof Error ? error.message : "Unknown error",