everything-dev 1.19.0 → 1.21.0

package/src/cli/timing.ts

@@ -1,13 +1,40 @@
+import type { spinner as clackSpinner } from "@clack/prompts";
+
+type Spinner = ReturnType<typeof clackSpinner>;
+
 export interface PhaseTiming {
   name: string;
   durationMs: number;
 }
 
+const PHASE_LABELS: Record<string, string> = {
+  "parent config": "Fetching parent config...",
+  "template source": "Resolving template source...",
+  "scaffold project": "Creating project scaffold...",
+  "copy files": "Copying template files...",
+  "personalize config": "Personalizing config...",
+  "write snapshot": "Writing snapshot...",
+  "resolve config": "Resolving config...",
+  "generate env/docker": "Generating environment config...",
+  "create env file": "Creating .env file...",
+  "install dependencies": "Installing dependencies...",
+  "generate types": "Generating types...",
+  "generate migrations": "Generating database migrations...",
+  "generate code artifacts": "Generating code artifacts...",
+  "docker compose up": "Starting Docker services...",
+};
+
+function phaseLabel(name: string): string {
+  return PHASE_LABELS[name] ?? name;
+}
+
 export async function timePhase<T>(
   timings: PhaseTiming[],
   name: string,
   fn: () => Promise<T>,
+  spinner?: Spinner,
 ): Promise<T> {
+  spinner?.message(phaseLabel(name));
   const startedAt = Date.now();
   try {
     return await fn();

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/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) {
@@ -1213,11 +1215,17 @@ export default createPlugin({
         extendsAccount = extendsAccount || "dev.everything.near";
         extendsGateway = extendsGateway || "everything.dev";
 
+        const s = p.spinner();
+        s.start("Initializing project");
+
         let parentPluginKeys: string[] = [];
         let parentConfig: BosConfig | null = null;
         try {
-          parentConfig = await timePhase(timings, "parent config", () =>
-            fetchParentConfig(extendsAccount, extendsGateway),
+          parentConfig = await timePhase(
+            timings,
+            "parent config",
+            () => fetchParentConfig(extendsAccount, extendsGateway),
+            s,
           );
           if (parentConfig?.plugins && typeof parentConfig.plugins === "object") {
             parentPluginKeys = Object.keys(parentConfig.plugins);
@@ -1225,13 +1233,14 @@ export default createPlugin({
         } catch {}
 
         if (!input.noInteractive) {
+          s.stop("Config fetched");
           const prompted = await promptInitOptions({
             extends: `bos://${extendsAccount}/${extendsGateway}`,
             directory,
             account,
             domain,
             plugins,
-            withHost,
+            overrides,
             parentPluginKeys,
           });
           extendsAccount = prompted.extendsAccount;
@@ -1239,21 +1248,39 @@ 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(timings, "parent config", () =>
-              fetchParentConfig(extendsAccount, extendsGateway),
+            parentConfig = await timePhase(
+              timings,
+              "parent config",
+              () => fetchParentConfig(extendsAccount, extendsGateway),
+              s,
             );
           } catch {
+            s.stop("Failed");
             return {
               status: "error" as const,
               directory,
@@ -1261,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?`,
@@ -1273,12 +1301,16 @@ export default createPlugin({
           sourceDir,
           parentConfig: resolvedParentConfig,
           cleanup,
-        } = await timePhase(timings, "template source", () =>
-          resolveSourceDir({
-            extendsAccount,
-            extendsGateway,
-            source: input.source,
-          }),
+        } = await timePhase(
+          timings,
+          "template source",
+          () =>
+            resolveSourceDir({
+              extendsAccount,
+              extendsGateway,
+              source: input.source,
+            }),
+          s,
         );
 
         parentConfig = resolvedParentConfig;
@@ -1286,25 +1318,28 @@ export default createPlugin({
         const isMinimalScaffold = sourceDir === "";
 
         try {
-          const s = p.spinner();
-          s.start("Setting up project");
-
           let filesCopied: number;
 
           if (isMinimalScaffold) {
-            filesCopied = await timePhase(timings, "scaffold project", () =>
-              scaffoldMinimalProject(targetDir, parentConfig as unknown as BosConfigInput, {
-                extendsAccount,
-                extendsGateway,
-                account: account || extendsAccount,
-                domain,
-                plugins,
-                withHost,
-              }),
+            filesCopied = await timePhase(
+              timings,
+              "scaffold project",
+              () =>
+                scaffoldMinimalProject(targetDir, parentConfig as unknown as BosConfigInput, {
+                  extendsAccount,
+                  extendsGateway,
+                  account: account || extendsAccount,
+                  domain,
+                  plugins,
+                  overrides,
+                  repository,
+                }),
+              s,
             );
           } else {
             const patterns = await readTemplatekeep(sourceDir);
             if (patterns.length === 0) {
+              s.stop("Failed");
               return {
                 status: "error" as const,
                 directory,
@@ -1312,77 +1347,112 @@ 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;
+                }
               }
             }
 
-            filesCopied = await timePhase(timings, "copy files", () =>
-              copyFilteredFiles(sourceDir, targetDir, patterns, {
-                withHost,
-                plugins,
-                pluginRoutes,
-              }),
+            filesCopied = await timePhase(
+              timings,
+              "copy files",
+              () =>
+                copyFilteredFiles(sourceDir, targetDir, patterns, {
+                  overrides,
+                  plugins,
+                  pluginRoutes,
+                }),
+              s,
             );
 
-            await timePhase(timings, "personalize config", () =>
-              personalizeConfig(targetDir, {
-                extendsAccount,
-                extendsGateway,
-                account: account || extendsAccount,
-                domain: domain || extendsGateway,
-                plugins,
-                pluginRoutes,
-                workspaceOpts: { sourceDir },
-                withHost,
-              }),
+            await timePhase(
+              timings,
+              "personalize config",
+              () =>
+                personalizeConfig(targetDir, {
+                  extendsAccount,
+                  extendsGateway,
+                  account: account || extendsAccount,
+                  domain: domain || extendsGateway,
+                  plugins,
+                  overrides,
+                  pluginRoutes,
+                  workspaceOpts: { sourceDir },
+                  repository,
+                }),
+              s,
             );
 
-            await timePhase(timings, "write snapshot", () =>
-              writeInitSnapshot(targetDir, extendsAccount, extendsGateway, sourceDir, patterns, {
-                withHost,
-                plugins,
-                pluginRoutes,
-              }),
+            await timePhase(
+              timings,
+              "write snapshot",
+              () =>
+                writeInitSnapshot(targetDir, extendsAccount, extendsGateway, sourceDir, patterns, {
+                  overrides,
+                  plugins,
+                  pluginRoutes,
+                }),
+              s,
             );
           }
 
-          const initConfig = await timePhase(timings, "resolve config", () =>
-            loadConfig({ cwd: targetDir }),
+          const initConfig = await timePhase(
+            timings,
+            "resolve config",
+            () => loadConfig({ cwd: targetDir }),
+            s,
           );
           if (initConfig?.runtime) {
-            await timePhase(timings, "generate env/docker", async () => {
-              writeGeneratedInfra(targetDir, initConfig.runtime);
-            });
+            await timePhase(
+              timings,
+              "generate env/docker",
+              async () => {
+                writeGeneratedInfra(targetDir, initConfig.runtime);
+              },
+              s,
+            );
           }
-          await timePhase(timings, "create env file", async () => {
-            ensureEnvFile(targetDir);
-          });
+          await timePhase(
+            timings,
+            "create env file",
+            async () => {
+              ensureEnvFile(targetDir);
+            },
+            s,
+          );
 
           if (!input.noInstall) {
-            await timePhase(timings, "install dependencies", () => runBunInstall(targetDir));
-            await timePhase(timings, "generate types", () => runTypesGen(targetDir));
-            await timePhase(timings, "generate migrations", () =>
-              generateDatabaseMigrations(targetDir),
+            await timePhase(timings, "install dependencies", () => runBunInstall(targetDir), s);
+            await timePhase(timings, "generate types", () => runTypesGen(targetDir), s);
+            await timePhase(
+              timings,
+              "generate migrations",
+              () => generateDatabaseMigrations(targetDir),
+              s,
             );
           }
 
           if (input.noInstall && initConfig?.config) {
-            await timePhase(timings, "generate code artifacts", () =>
-              generateCodeArtifacts(targetDir, initConfig.config),
+            await timePhase(
+              timings,
+              "generate code artifacts",
+              () => generateCodeArtifacts(targetDir, initConfig.config),
+              s,
             );
           }
 
@@ -1417,6 +1487,7 @@ export default createPlugin({
             domain,
             extends: extendsRef,
             plugins,
+            overrides,
             filesCopied,
             timings,
           };
@@ -1437,6 +1508,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",