@fulgurjs/federation 4.3.0 → 5.0.0

package/dist/cli.js

@@ -154,140 +154,6 @@ var init_manifest = __esm({
   }
 });
 
-// src/config.ts
-async function loadRepoConfig(configPath) {
-  const { pathToFileURL: pathToFileURL2, fileURLToPath } = await import("node:url");
-  const { createRequire: createRequire2 } = await import("node:module");
-  const fs3 = await import("node:fs");
-  const os = await import("node:os");
-  const path3 = await import("node:path");
-  const selfDir = await (async () => {
-    try {
-      return path3.dirname(fileURLToPath(import.meta.url));
-    } catch {
-    }
-    try {
-      return __dirname;
-    } catch {
-    }
-    return "";
-  })();
-  const selfConfigJs = selfDir ? path3.join(selfDir, "config.js") : "";
-  const SELF_SPEC = selfConfigJs && fs3.existsSync(selfConfigJs) ? pathToFileURL2(selfConfigJs).href : "@fulgurjs-federation-config-unavailable";
-  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgurjs\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
-  let cacheBust = 0;
-  const importConfigs = async (cacheKey) => {
-    return await import(`${cacheKey}?t=${Date.now()}-${++cacheBust}`);
-  };
-  let mod;
-  if (configPath.endsWith(".json")) {
-    mod = { default: JSON.parse(fs3.readFileSync(configPath, "utf8")) };
-  } else {
-    const source = rewriteSelfImports(fs3.readFileSync(configPath, "utf8"));
-    const tmpBase = path3.join(os.tmpdir(), `fulgurjs-config-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
-    if (/\.(ts|mts|cts)$/.test(configPath)) {
-      try {
-        const tmpTs = `${tmpBase}.ts`;
-        fs3.writeFileSync(tmpTs, source);
-        mod = await importConfigs(pathToFileURL2(tmpTs).href);
-      } catch (e) {
-        if (!/Unexpected|SyntaxError|ERR_UNSUPPORTED_NODE_MODULES|ERR_UNKNOWN_FILE_EXTENSION|ERR_IMPORT_ATTRIBUTE/.test(String(e)) && process.version.startsWith("v2")) {
-          throw e;
-        }
-        const requireFromConfig = createRequire2(configPath);
-        let esbuild;
-        try {
-          esbuild = requireFromConfig("esbuild");
-        } catch {
-          const requireFromSelf = createRequire2(import.meta.url);
-          esbuild = requireFromSelf("esbuild");
-        }
-        const out = esbuild.buildSync({ entryPoints: [configPath], bundle: false, write: false, format: "esm", target: "node18" });
-        const jsFile = `${tmpBase}.mjs`;
-        fs3.writeFileSync(jsFile, rewriteSelfImports(out.outputFiles[0].text));
-        mod = await importConfigs(pathToFileURL2(jsFile).href);
-      }
-    } else {
-      const jsFile = `${tmpBase}.mjs`;
-      fs3.writeFileSync(jsFile, source);
-      mod = await importConfigs(pathToFileURL2(jsFile).href);
-    }
-  }
-  const cfg = mod.default;
-  if (!cfg?.root) {
-    throw new Error(
-      `[fulgurjs:init] \u914D\u7F6E\u7F3A\u5C11 root\uFF08\u5DE5\u7A0B\u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF09
-\u6839\u56E0\uFF1ACLI \u9700\u8981\u77E5\u9053\u5728\u54EA\u4E2A\u5DE5\u7A0B\u4E0A\u505A\u96C6\u6210
-\u4FEE\u6CD5\uFF1Afulgurjs.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgurjs init\uFF09`
-    );
-  }
-  if (!Array.isArray(cfg.apps) || cfg.apps.length === 0) {
-    throw new Error("[fulgurjs:init] \u914D\u7F6E\u7F3A\u5C11 apps\uFF08\u81F3\u5C11\u4E00\u4E2A\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u5E94\u7528\uFF09");
-  }
-  for (const app of cfg.apps) {
-    if (!app.host && !app.remote) {
-      throw new Error(
-        `[fulgurjs:init] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
-\u6839\u56E0\uFF1A\u5E94\u7528\u5FC5\u987B\u81F3\u5C11\u58F0\u660E\u4E00\u4E2A\u89D2\u8272
-\u4FEE\u6CD5\uFF1A\u5BBF\u4E3B\u8865 host: { remotePrefixes, remotes }\uFF08pages \u53EF\u9009\uFF09\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
-      );
-    }
-  }
-  return cfg;
-}
-function federationOptionsForApp(config, appPathOrName) {
-  const app = config.apps.find(
-    (a) => a.path === appPathOrName || a.name === appPathOrName
-  );
-  if (!app) {
-    throw new Error(
-      `[fulgurjs] \u5E94\u7528 "${appPathOrName}" \u4E0D\u5728\u4ED3\u5E93\u914D\u7F6E\u4E2D
-  \u53EF\u7528\u5E94\u7528: ${config.apps.map((a) => `${a.path}(${a.name})`).join("\u3001")}
-  \u4FEE\u6CD5: \u4FEE\u6B63\u5E94\u7528\u76EE\u5F55\u540D\u6216\u5BB9\u5668\u540D\uFF08fulgurjs.config.ts apps \u6570\u7EC4\u5185\u4E8C\u9009\u4E00\u5339\u914D\uFF09`
-    );
-  }
-  if (!app.host && !app.remote) {
-    throw new Error(
-      `[fulgurjs] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
-  \u4FEE\u6CD5: \u5BBF\u4E3B\u8865 host: { remotePrefixes, remotes }\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
-    );
-  }
-  const remotes = {};
-  const remoteSource = /* @__PURE__ */ new Map();
-  const mergeRemotes = (from, role) => {
-    for (const [key, addr] of Object.entries(from ?? {})) {
-      const prev = remotes[key];
-      if (prev && (prev.dev !== addr.dev || prev.prod !== addr.prod)) {
-        throw new Error(
-          `[fulgurjs] \u5E94\u7528 "${app.path}" \u7684\u8FDC\u7A0B "${key}" \u5728 ${role} \u4E0E ${remoteSource.get(key)} \u4E24\u5904\u5730\u5740\u4E0D\u4E00\u81F4
-  ${remoteSource.get(key)}: dev=${prev.dev} prod=${prev.prod}
-  ${role}: dev=${addr.dev} prod=${addr.prod}
-  \u4FEE\u6CD5: \u4FEE\u6B63 fulgurjs.config.ts \u4F7F\u4E24\u5904\u4E00\u81F4\uFF08\u540C\u4E00\u8FDC\u7A0B\u5728\u4E00\u4E2A\u5E94\u7528\u5185\u53EA\u80FD\u6709\u4E00\u4E2A\u5730\u5740\uFF09`
-        );
-      }
-      remotes[key] = addr;
-      remoteSource.set(key, role);
-    }
-  };
-  mergeRemotes(app.host?.remotes, "host.remotes");
-  mergeRemotes(app.remote?.remotes, "remote.remotes");
-  const hasExposes = !!app.remote && Object.keys(app.remote.exposes).length > 0;
-  const hasRemotes = Object.keys(remotes).length > 0;
-  return {
-    name: app.name,
-    ...hasRemotes ? { remotes } : {},
-    ...hasExposes ? { exposes: app.remote.exposes } : {},
-    ...app.remote?.setup ? { setup: app.remote.setup } : {},
-    ...app.shared ? { shared: app.shared } : {},
-    devSharedSelf: app.devSharedSelf ?? (hasExposes || !!app.remote?.setup)
-  };
-}
-var init_config = __esm({
-  "src/config.ts"() {
-    "use strict";
-  }
-});
-
 // src/app-config.ts
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
@@ -299,6 +165,13 @@ function appConfigError(what, cause, fix) {
 function isAggregateShape(value) {
   return !!value && typeof value === "object" && Array.isArray(value.apps);
 }
+function aggregateMigrationError() {
+  appConfigError(
+    "\u914D\u7F6E\u662F\u65E7\u805A\u5408\u5F62\u6001\uFF08root + apps[]\uFF0C\u5DF2\u5220\u9664\uFF09",
+    "4.1.0 \u7684\u805A\u5408\u914D\u7F6E\u94FE\uFF08defineRepoConfig / loadRepoConfig / federationOptionsForApp \u4E0E @fulgurjs/federation/config \u5B50\u8DEF\u5F84\uFF09\u5DF2\u5728 5.0.0 \u5220\u9664\uFF1BCLI \u53EA\u63A5\u53D7\u5355\u9879\u76EE\u914D\u7F6E\uFF1A\u6BCF\u4E2A\u5E94\u7528\u6839\u76EE\u5F55\u4E00\u4EFD fulgurjs.config.ts\uFF0C\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879",
+    "\u628A\u805A\u5408\u6587\u4EF6\u91CC\u6BCF\u4E2A\u5E94\u7528\u62C6\u6210\u5404\u81EA\u9879\u76EE\u6839\u76EE\u5F55\u7684 fulgurjs.config.ts\uFF1A\n  \u5E94\u7528\u6839/fulgurjs.config.ts\uFF1Aexport default { name, remotes, exposes, setup, shared, devSharedSelf? } satisfies FederationOptions\n  \uFF08host.pages/remotePrefixes/deriveSpec \u2192 \u5177\u540D\u5BFC\u51FA hostPages\uFF1Bhost.remotes \u2192 \u9876\u5C42 remotes\uFF1Bremote.exposes \u2192 \u9876\u5C42 exposes\uFF1Bremote.setup \u2192 \u9876\u5C42 setup\uFF09\n  \u5404\u9879\u76EE vite.config.ts\uFF1Aimport fulgurjsConfig from './fulgurjs.config' \u540E federation(fulgurjsConfig)\uFF1B\u5220\u9664\u7236\u76EE\u5F55\u805A\u5408\u6587\u4EF6"
+  );
+}
 function fieldError(field, got, expect, example) {
   appConfigError(
     `fulgurjs.config.ts \u7684 ${field} \u5F62\u72B6\u4E0D\u5408\u6CD5\uFF08\u5B9E\u9645 ${JSON.stringify(got)}\uFF09`,
@@ -320,8 +193,8 @@ function validateAppOptions(options) {
     if (options[legacyField] !== void 0) {
       appConfigError(
         `\u9ED8\u8BA4\u5BFC\u51FA\u5305\u542B\u65E7\u805A\u5408/\u89D2\u8272\u58F3\u5B57\u6BB5 "${legacyField}"`,
-        "\u5355\u9879\u76EE\u5951\u7EA6\u7684\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF08name/exposes/setup/remotes/shared/\u2026\uFF09\uFF0C\u4E0D\u5305 host/remote \u89D2\u8272\u58F3\uFF0C\u4E5F\u6CA1\u6709 root/apps[]",
-        legacyField === "host" || legacyField === "remote" ? "\u628A host/remote \u5185\u7684\u5B57\u6BB5\u62CD\u5E73\u5230\u9876\u5C42\uFF1Ahost.remotes \u2192 remotes\uFF1Bremote.exposes \u2192 exposes\uFF1Bremote.setup \u2192 setup\uFF1Bhost.pages/remotePrefixes/deriveSpec \u2192 \u5177\u540D\u5BFC\u51FA hostPages" : `${legacyField} \u5C5E\u4E8E\u65E7\u805A\u5408\u914D\u7F6E\uFF08root + apps[]\uFF0C\u517C\u5BB9\u671F\u4FDD\u7559\uFF09\u3002\u5355\u9879\u76EE\u5F62\u6001\u8BF7\u5220\u9664\u8BE5\u5B57\u6BB5\uFF1B\u805A\u5408\u7528\u6CD5\u89C1 README\u300C\u5386\u53F2\u517C\u5BB9\u300D\u7AE0\u8282`
+        "\u5355\u9879\u76EE\u5951\u7EA6\u7684\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF08name/exposes/setup/remotes/shared/\u2026\uFF09\uFF0C\u4E0D\u5305 host/remote \u89D2\u8272\u58F3\uFF0C\u4E5F\u6CA1\u6709 root/apps[]\uFF1B\u65E7\u805A\u5408\u914D\u7F6E\uFF08root + apps[]\uFF09\u5DF2\u5728 5.0.0 \u5220\u9664",
+        legacyField === "host" || legacyField === "remote" ? "\u628A host/remote \u5185\u7684\u5B57\u6BB5\u62CD\u5E73\u5230\u9876\u5C42\uFF1Ahost.remotes \u2192 remotes\uFF1Bremote.exposes \u2192 exposes\uFF1Bremote.setup \u2192 setup\uFF1Bhost.pages/remotePrefixes/deriveSpec \u2192 \u5177\u540D\u5BFC\u51FA hostPages" : `${legacyField} \u5C5E\u4E8E\u5DF2\u5220\u9664\u7684\u65E7\u805A\u5408\u914D\u7F6E\uFF08root + apps[]\uFF09\u3002\u5355\u9879\u76EE\u5F62\u6001\u8BF7\u5220\u9664\u8BE5\u5B57\u6BB5\u2014\u2014\u6BCF\u4E2A\u5E94\u7528\u4E00\u4EFD fulgurjs.config.ts\uFF08\u89C1 README\uFF09`
       );
     }
   }
@@ -342,17 +215,17 @@ function validateHostPages(value) {
   }
   return hp;
 }
-function validatePathsInsideApp(options, appRoot, fs3, path3) {
+function validatePathsInsideApp(options, appRoot, fs3, path2) {
   const checkModule = (field, value) => {
     if (typeof value !== "string" || value.trim() === "") return;
-    if (/^(https?:)?\/\//.test(value) || path3.isAbsolute(value)) {
+    if (/^(https?:)?\/\//.test(value) || path2.isAbsolute(value)) {
       appConfigError(
         `${field} "${value}" \u4E0D\u662F\u672C\u9879\u76EE\u5185\u7684\u6A21\u5757\u8DEF\u5F84`,
         "exposes/setup \u7684\u503C\u662F\u76F8\u5BF9\u672C\u5E94\u7528\u6839\u76EE\u5F55\u7684\u6E90\u6587\u4EF6\u8DEF\u5F84\uFF08URL/\u7EDD\u5BF9\u8DEF\u5F84\u65E0\u6CD5\u5728\u72EC\u7ACB\u4ED3\u5E93\u95F4\u79FB\u690D\uFF09",
         `\u6539\u4E3A\u76F8\u5BF9\u8DEF\u5F84\uFF0C\u5982 './src/views/Home.vue'\uFF08\u914D\u7F6E\u6587\u4EF6\u76EE\u5F55 = \u5E94\u7528\u6839 ${appRoot}\uFF09`
       );
     }
-    const abs = path3.resolve(appRoot, value);
+    const abs = path2.resolve(appRoot, value);
     if (!fs3.existsSync(abs)) {
       appConfigError(
         `${field} \u6307\u5411\u7684\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${value}`,
@@ -424,8 +297,8 @@ function resolveEsbuild(configPath) {
 async function loadAppConfig(configPath) {
   const fs3 = await import("node:fs");
   const os = await import("node:os");
-  const path3 = await import("node:path");
-  const abs = path3.resolve(configPath);
+  const path2 = await import("node:path");
+  const abs = path2.resolve(configPath);
   if (!fs3.existsSync(abs)) {
     appConfigError(
       `\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${abs}`,
@@ -435,11 +308,16 @@ async function loadAppConfig(configPath) {
   }
   if (abs.endsWith(".json")) {
     const parsed = JSON.parse(fs3.readFileSync(abs, "utf8"));
-    if (isAggregateShape(parsed)) {
-      const repo = await loadRepoConfig(abs);
-      return { kind: "repo", configPath: abs, appRoot: path3.dirname(abs), repo };
-    }
-    return finishAppShape(parsed, {}, abs, path3.dirname(abs), fs3, path3);
+    if (isAggregateShape(parsed)) aggregateMigrationError();
+    return finishAppShape(parsed, {}, abs, path2.dirname(abs), fs3, path2);
+  }
+  const rawSource = fs3.readFileSync(abs, "utf8");
+  if (/@fulgurjs\/federation\/config/.test(rawSource)) {
+    appConfigError(
+      `\u914D\u7F6E\u5BFC\u5165\u4E86\u5DF2\u5220\u9664\u7684\u5B50\u8DEF\u5F84 "@fulgurjs/federation/config"`,
+      "defineRepoConfig / loadRepoConfig / federationOptionsForApp \u4E0E\u805A\u5408\u7C7B\u578B\uFF08RepoConfig \u7B49\uFF09\u6240\u5728\u7684 /config \u5B50\u8DEF\u5F84\u5DF2\u5728 5.0.0 \u5220\u9664\uFF1B\u5355\u9879\u76EE\u914D\u7F6E\u4E0D\u9700\u8981\u4EFB\u4F55\u8FD0\u884C\u65F6\u5305\u88C5\u51FD\u6570",
+      "\u5220\u9664\u8BE5\u5BFC\u5165\uFF0C\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u5199 federation() \u9009\u9879\u5BF9\u8C61\uFF1A\n  import type { FederationOptions } from '@fulgurjs/federation'\n  export default { name: 'my-app', exposes: { /* \u2026 */ } } satisfies FederationOptions"
+    );
   }
   const esbuild = resolveEsbuild(abs);
   const selfRedirect = {
@@ -448,7 +326,7 @@ async function loadAppConfig(configPath) {
       build.onResolve({ filter: /^@fulgurjs\/federation(\/|$)/ }, (args) => {
         const resolved = resolveSelfEntry(abs, args.path);
         if (!resolved) {
-          return { errors: [{ text: `cannot resolve "${args.path}" from the config project or the CLI itself` }] };
+          return { errors: [{ text: `\u65E0\u6CD5\u4ECE\u914D\u7F6E\u9879\u76EE\u6216 CLI \u81EA\u8EAB\u89E3\u6790 "${args.path}"\uFF1B\u8BF7\u5148\u5728\u5F53\u524D\u9879\u76EE\u5B89\u88C5 @fulgurjs/federation` }] };
         }
         return { path: resolved };
       });
@@ -464,21 +342,18 @@ async function loadAppConfig(configPath) {
     plugins: [selfRedirect],
     logLevel: "silent"
   });
-  const tmpDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "fulgurjs-appcfg-"));
+  const tmpDir = fs3.mkdtempSync(path2.join(os.tmpdir(), "fulgurjs-appcfg-"));
   try {
-    const bundleFile = path3.join(tmpDir, "fulgurjs.config.bundle.mjs");
+    const bundleFile = path2.join(tmpDir, "fulgurjs.config.bundle.mjs");
     fs3.writeFileSync(bundleFile, out.outputFiles[0].text);
     const mod = await import(`${pathToFileURL(bundleFile).href}?t=${Date.now()}`);
-    if (isAggregateShape(mod.default)) {
-      const repo = await loadRepoConfig(abs);
-      return { kind: "repo", configPath: abs, appRoot: path3.dirname(abs), repo };
-    }
-    return finishAppShape(mod.default, { hostPages: mod.hostPages }, abs, path3.dirname(abs), fs3, path3);
+    if (isAggregateShape(mod.default)) aggregateMigrationError();
+    return finishAppShape(mod.default, { hostPages: mod.hostPages }, abs, path2.dirname(abs), fs3, path2);
   } finally {
     fs3.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
-function finishAppShape(def, named, configPath, appRoot, fs3, path3) {
+function finishAppShape(def, named, configPath, appRoot, fs3, path2) {
   if (def === void 0 || def === null) {
     appConfigError(
       "fulgurjs.config.ts \u6CA1\u6709\u53EF\u7528\u7684\u9ED8\u8BA4\u5BFC\u51FA",
@@ -491,7 +366,7 @@ function finishAppShape(def, named, configPath, appRoot, fs3, path3) {
   }
   const options = def;
   validateAppOptions(options);
-  validatePathsInsideApp(options, appRoot, fs3, path3);
+  validatePathsInsideApp(options, appRoot, fs3, path2);
   const hostPages = named.hostPages !== void 0 ? validateHostPages(named.hostPages) : void 0;
   return {
     kind: "app",
@@ -511,7 +386,6 @@ var TS_SYNTAX_PROBE;
 var init_app_config = __esm({
   "src/app-config.ts"() {
     "use strict";
-    init_config();
     TS_SYNTAX_PROBE = "export default {} satisfies Record<string, unknown>";
   }
 });
@@ -533,36 +407,6 @@ async function writeConfigTemplate(target, force = false) {
   fs.writeFileSync(path.resolve(target), STARTER_CONFIG);
   return "written";
 }
-function remoteEntriesLiteral(remotes) {
-  return Object.entries(remotes).map(([k, v]) => `    '${k}': { dev: '${v.dev}', prod: '${v.prod}' },`).join("\n");
-}
-function exposesLiteral(exposes) {
-  return Object.entries(exposes).map(([k, v]) => `    '${k}': '${v}',`).join("\n");
-}
-function viteSnippetFor(app) {
-  const hostRemotes = app.host ? remoteEntriesLiteral(app.host.remotes) : "";
-  const remoteRemotes = app.remote?.remotes ? remoteEntriesLiteral(app.remote.remotes) : "";
-  const remotesBlock = hostRemotes || remoteRemotes ? `  remotes: {
-${hostRemotes || remoteRemotes}
-  },
-` : "";
-  const exposesBlock = app.remote?.exposes ? `  exposes: {
-${exposesLiteral(app.remote.exposes)}
-  },
-` : "";
-  const setupBlock = app.remote?.setup ? `  setup: '${app.remote.setup}',
-` : "";
-  const sharedBlock = app.shared ? `  shared: {
-${Object.entries(app.shared).map(([k, v]) => {
-    const opts = [v.singleton ? "singleton: true" : "", v.requiredVersion ? `requiredVersion: '${v.requiredVersion}'` : ""].filter(Boolean);
-    return `    '${k}': { ${opts.join(", ")} },`;
-  }).join("\n")}
-  },
-` : "";
-  return `federation({
-  name: '${app.name}',
-${remotesBlock}${exposesBlock}${setupBlock}${sharedBlock}})`;
-}
 function viteSnippetForAppMode(appRoot) {
   return `// ${appRoot}/vite.config.ts\uFF08\u8054\u90A6\u76F8\u5173\u884C\uFF1B\u5176\u4F59 Vite \u914D\u7F6E\u539F\u6837\u4FDD\u7559\uFF09
 import federation from '@fulgurjs/federation'
@@ -575,64 +419,6 @@ export default defineConfig({
   ],
 })`;
 }
-function nginxSnippetFor(cfg) {
-  const listen = cfg.deploy?.listen ?? 8080;
-  const webRoot = cfg.deploy?.webRoot ?? "/var/www/your-site";
-  const hostApp = cfg.apps.find((a) => a.host) ?? cfg.apps[0];
-  const hostIndex = `/${hostApp.base.replace(/^\/|\/$/g, "")}/index.html`.replace(/\/{2,}/g, "/");
-  const blocks = cfg.apps.map(
-    (a) => {
-      const b = a.base === "/" || a.base === "" ? "/" : a.base.replace(/\/$/, "");
-      return `  location ${b} {
-    try_files $uri $uri/ ${hostIndex};
-
-    location = ${b}/fulgurjs-remoteEntry.js {
-      add_header Cache-Control "no-cache";
-      add_header Access-Control-Allow-Origin "*";
-    }
-    location = ${b}/fulgurjs-manifest.json {
-      add_header Cache-Control "no-cache";
-      add_header Access-Control-Allow-Origin "*";
-    }
-    location = ${b}/index.html {
-      add_header Cache-Control "no-cache";
-    }
-  }`;
-    }
-  ).join("\n\n");
-  return `# \u8054\u90A6\u7AD9\u70B9\u6837\u677F\uFF08\u6253\u5370\u6837\u677F\uFF0C\u4E0D\u5199\u6587\u4EF6\u3002\u8981\u70B9\uFF1AremoteEntry/manifest/index.html \u5FC5\u987B no-cache\u2014\u2014
-# \u6587\u4EF6\u540D\u56FA\u5B9A\u800C\u5185\u5BB9\u6BCF\u6B21\u6784\u5EFA\u53D8\u5316\uFF0Cimmutable \u957F\u7F13\u5B58\u4F1A\u8BA9\u6D4F\u89C8\u5668\u6301\u65E7\u5165\u53E3\u3001\u91CD\u90E8\u7F72\u540E\u5168 404\uFF1B
-# \u5E26 hash \u7684 assets \u624D\u914D\u957F\u7F13\u5B58\uFF1B\u8DE8\u6E90\u90E8\u7F72\u65F6\u4FDD\u7559 Access-Control-Allow-Origin\uFF09
-server {
-  listen ${listen};
-  root ${webRoot};
-
-${blocks}
-}`;
-}
-function appSummary(app) {
-  const role = app.host ? app.remote ? "\u5BBF\u4E3B+\u8FDC\u7A0B" : "\u5BBF\u4E3B" : "\u8FDC\u7A0B";
-  const lines = [];
-  lines.push(`  ${app.name}\uFF08${role}\uFF0C\u76EE\u5F55 ${app.path}\uFF0Cdev \u7AEF\u53E3 ${app.port}\uFF0Cbase ${app.base}\uFF09`);
-  if (app.host) {
-    for (const [k, v] of Object.entries(app.host.remotes)) {
-      lines.push(`    \u6D88\u8D39\u8FDC\u7A0B ${k} \u2192 dev ${v.dev} / prod ${v.prod}`);
-    }
-    lines.push(`    \u9875\u9762\u8DEF\u7531\u8868\uFF1A${app.host.pages?.length ?? 0} \u6761${app.host.pages ? "" : "\uFF08\u672A\u5728\u4ED3\u5E93\u914D\u7F6E\u4E2D\u63D0\u4F9B\u2014\u2014\u4EE5\u5E94\u7528\u4EE3\u7801\u9875\u9762\u8868\u4E3A\u51C6\uFF09"}`);
-  }
-  if (app.remote?.exposes) {
-    lines.push(`    exposes\uFF1A${Object.keys(app.remote.exposes).join("\u3001")}`);
-  }
-  if (app.remote?.setup) {
-    lines.push(`    setup\uFF08\u53EF\u9009\u8FDC\u7A0B\u521D\u59CB\u5316\uFF09\uFF1A${app.remote.setup}`);
-  }
-  if (app.remote?.remotes) {
-    for (const [k, v] of Object.entries(app.remote.remotes)) {
-      lines.push(`    \u53CD\u5411\u6D88\u8D39 ${k} \u2192 dev ${v.dev} / prod ${v.prod}\uFF08\u53CC\u5411\u8054\u90A6\uFF09`);
-    }
-  }
-  return lines.join("\n");
-}
 function appModeSummary(loaded) {
   const options = loaded.options;
   const roleText = { host: "\u5BBF\u4E3B", remote: "\u8FDC\u7A0B", dual: "\u5BBF\u4E3B+\u8FDC\u7A0B\uFF08\u53CC\u89D2\u8272\uFF09" }[Object.keys(options.remotes ?? {}).length > 0 && (Object.keys(options.exposes ?? {}).length > 0 || !!options.setup) ? "dual" : Object.keys(options.remotes ?? {}).length > 0 ? "host" : "remote"];
@@ -658,28 +444,11 @@ function appModeSummary(loaded) {
 async function inspectConfig(configPath) {
   const loaded = await loadAppConfig(configPath);
   const out = [];
-  if (loaded.kind === "app") {
-    out.push(`${MARK} \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF1A\u5355\u9879\u76EE\u5F62\u6001\uFF08\u9ED8\u8BA4\u5BFC\u51FA = federation() \u9009\u9879\uFF09`);
-    out.push("\u5E94\u7528\u6458\u8981\uFF1A");
-    out.push(...appModeSummary(loaded));
-    out.push("\n\u2500\u2500 vite.config.ts plugins \u63A5\u5165\u5757\uFF08\u8FD9\u5C31\u662F\u5168\u90E8\u8054\u90A6\u63A5\u5165\u4EE3\u7801\uFF09 \u2500\u2500");
-    out.push(viteSnippetForAppMode(loaded.appRoot));
-    out.push("\n\u2500\u2500 \u63A5\u5165\u6838\u5BF9\u6E05\u5355\uFF08\u8054\u90A6\u901A\u7528\u9879\uFF0C\u4E0E\u5177\u4F53\u9879\u76EE\u65E0\u5173\uFF09 \u2500\u2500");
-    out.push(...COMMON_CHECKLIST);
-    return out.join("\n");
-  }
-  const cfg = loaded.repo ?? await loadRepoConfig(loaded.configPath);
-  out.push(`${MARK} \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF1Aroot=${cfg.root}\uFF0Capps=${cfg.apps.length}\u3010\u65E7\u805A\u5408\u914D\u7F6E\u5F62\u6001\uFF08root+apps[]\uFF09\uFF0C\u517C\u5BB9\u671F\u4FDD\u7559\uFF1B\u65B0\u9879\u76EE\u63A8\u8350\u6BCF\u9879\u76EE\u4E00\u4EFD\u5355\u9879\u76EE\u914D\u7F6E\uFF0C\u89C1 README\u3011`);
+  out.push(`${MARK} \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF1A\u5355\u9879\u76EE\u5F62\u6001\uFF08\u9ED8\u8BA4\u5BFC\u51FA = federation() \u9009\u9879\uFF09`);
   out.push("\u5E94\u7528\u6458\u8981\uFF1A");
-  for (const app of cfg.apps) out.push(appSummary(app));
-  out.push("\n\u2500\u2500 \u5404\u5E94\u7528 vite.config.ts plugins \u7C98\u8D34\u5757\uFF08\u65E7\u805A\u5408\u5F62\u6001\u9700\u7ECF loadRepoConfig/federationOptionsForApp \u8F6C\u6362\uFF09 \u2500\u2500");
-  for (const app of cfg.apps) {
-    out.push(`
-# ${app.path}\uFF08${app.name}\uFF09`);
-    out.push(viteSnippetFor(app));
-  }
-  out.push("\n\u2500\u2500 NGINX \u7AD9\u70B9\u6837\u677F\uFF08\u6253\u5370\u6837\u677F\uFF0C\u4E0D\u5199\u6587\u4EF6\uFF09 \u2500\u2500");
-  out.push(nginxSnippetFor(cfg));
+  out.push(...appModeSummary(loaded));
+  out.push("\n\u2500\u2500 vite.config.ts plugins \u63A5\u5165\u5757\uFF08\u8FD9\u5C31\u662F\u5168\u90E8\u8054\u90A6\u63A5\u5165\u4EE3\u7801\uFF09 \u2500\u2500");
+  out.push(viteSnippetForAppMode(loaded.appRoot));
   out.push("\n\u2500\u2500 \u63A5\u5165\u6838\u5BF9\u6E05\u5355\uFF08\u8054\u90A6\u901A\u7528\u9879\uFF0C\u4E0E\u5177\u4F53\u9879\u76EE\u65E0\u5173\uFF09 \u2500\u2500");
   out.push(...COMMON_CHECKLIST);
   return out.join("\n");
@@ -689,7 +458,6 @@ var init_init = __esm({
   "src/init.ts"() {
     "use strict";
     init_app_config();
-    init_config();
     MARK = "[fulgurjs:init]";
     STARTER_CONFIG = `// fulgurjs.config.ts \u2014\u2014 @fulgurjs/federation \u5355\u9879\u76EE\u63A5\u5165\u914D\u7F6E\uFF08\u4E00\u9879\u76EE\u4E00\u4EFD\uFF0C\u53EF\u5165\u5E93\u3001\u53EF\u590D\u8DD1\uFF09
 //
@@ -746,7 +514,7 @@ export default {
       "   \uFF08\u9000\u51FA\u65F6 clearAppContext \u6E05\u7406\uFF09\uFF0C\u8FDC\u7A0B setup/onSession \u7528 getAppContext / requireAppContext \u6D88\u8D39",
       "5. \u5E94\u7528\u4EE3\u7801\u552F\u4E00 API \u5165\u53E3\uFF1Aimport { loadRemote, provideAppContext, getAppContext, clearAppContext, definePages, createHostPages, remoteSchema, remoteComponent } from '@fulgurjs/federation/runtime'",
       '6. dev \u51B7\u542F\u52A8\u9996\u8F6E 30~60s \u6709\u9884\u6784\u5EFA\u7A97\u53E3\uFF08\u77AC\u65F6 504/"ce"\uFF0CDEV-010\uFF09\uFF1A\u5148\u771F\u5B9E\u6253\u5F00\u9875\u9762\u9884\u70ED\u518D\u505A\u65AD\u8A00',
-      "7. \u914D\u7F6E\u89E3\u91CA\uFF1Afulgurjs explain\uFF08\u5355\u9879\u76EE\u5F62\u6001\u514D --app\uFF09\uFF1B\u9875\u9762\u5951\u7EA6\u6838\u5BF9\uFF1Afulgurjs check-pages\uFF08\u5BBF\u4E3B\u9879\u76EE\u8FD0\u884C\uFF0C--manifest/--site \u6307\u5B9A\u8FDC\u7A0B manifest \u6765\u6E90\uFF09\uFF1B",
+      "7. \u914D\u7F6E\u89E3\u91CA\uFF1Afulgurjs explain\uFF1B\u9875\u9762\u5951\u7EA6\u6838\u5BF9\uFF1Afulgurjs check-pages\uFF08\u5BBF\u4E3B\u9879\u76EE\u8FD0\u884C\uFF0C--manifest/--site \u6307\u5B9A\u8FDC\u7A0B manifest \u6765\u6E90\uFF09\uFF1B",
       "   \u90E8\u7F72\u4F53\u68C0\uFF1Afulgurjs doctor --base <URL> --apps <\u5BB9\u5668\u540D...>",
       "8. \u90E8\u7F72\u8BED\u4E49\uFF1AremoteEntry/manifest/index.html \u5FC5\u987B no-cache\uFF08\u4E25\u7981 immutable\uFF09\uFF1B\u5E26 hash \u7684 assets \u957F\u7F13\u5B58"
     ];
@@ -883,24 +651,6 @@ __export(commands_exports, {
   stripRemoteNamePrefix: () => stripRemoteNamePrefix
 });
 import fs2 from "node:fs";
-import path2 from "node:path";
-function roleOf(app) {
-  if (app.host && app.remote) return "dual";
-  return app.host ? "host" : "remote";
-}
-function pageMappings(app) {
-  const pages = app.host?.pages ?? [];
-  const prefixes = Object.entries(app.host?.remotePrefixes ?? {}).sort((a, b) => b[0].length - a[0].length);
-  const remoteOf = (route) => {
-    for (const [prefix, name] of prefixes) {
-      const p = prefix.endsWith("/") ? prefix : `${prefix}/`;
-      if (route.startsWith(p) || `${route}/` === p) return name;
-    }
-    return null;
-  };
-  const derive = app.host?.deriveSpec ?? ((route) => route.split("/").filter(Boolean).slice(1).filter((s) => !s.startsWith(":")).join("/"));
-  return mappingsOf({ pages, remotePrefixes: app.host?.remotePrefixes ?? {}, deriveSpec: app.host?.deriveSpec }, derive);
-}
 function mappingsOf(hp, deriveFallback) {
   const pages = hp.pages ?? [];
   const prefixes = Object.entries(hp.remotePrefixes ?? {}).sort((a, b) => b[0].length - a[0].length);
@@ -952,14 +702,8 @@ function chainLines(options, role) {
   }
   return chain;
 }
-function explainAppMode(loaded, appName) {
+function explainAppMode(loaded) {
   const options = loaded.options;
-  if (appName && appName !== options.name) {
-    throw new Error(
-      `[fulgurjs:explain] \u5355\u9879\u76EE\u914D\u7F6E\u53EA\u63CF\u8FF0\u672C\u5E94\u7528\uFF08name: "${options.name}"\uFF09\uFF0C\u4E0E --app "${appName}" \u4E0D\u4E00\u81F4
-  \u4FEE\u6CD5: \u53BB\u6389 --app\uFF0C\u6216\u6539\u4E3A --app ${options.name}`
-    );
-  }
   const role = roleOfOptions(options);
   const devSharedSelfExplicit = options.devSharedSelf !== void 0;
   const devSharedSelfValue = devSharedSelfExplicit ? options.devSharedSelf === true : role !== "host";
@@ -967,7 +711,6 @@ function explainAppMode(loaded, appName) {
   return {
     app: options.name,
     role,
-    mode: "app",
     path: loaded.appRoot,
     remotes: remotesOfOptions(options),
     exposes: Object.keys(options.exposes ?? {}),
@@ -979,65 +722,13 @@ function explainAppMode(loaded, appName) {
     chain: chainLines(options, role)
   };
 }
-function explainRepoMode(cfg, appPathOrName) {
-  const app = cfg.apps.find((a) => a.path === appPathOrName || a.name === appPathOrName);
-  if (!app) {
-    throw new Error(
-      `[fulgurjs:explain] \u5E94\u7528 "${appPathOrName}" \u4E0D\u5728\u914D\u7F6E\u4E2D\uFF08\u53EF\u7528\uFF1A${cfg.apps.map((a) => a.path).join("\u3001")}\uFF09`
-    );
-  }
-  const opts = federationOptionsForApp(cfg, appPathOrName);
-  const remotes = Object.entries(opts.remotes ?? {}).map(
-    ([key, v]) => ({ key, dev: String(v.dev ?? v.external ?? ""), prod: String(v.prod ?? v.external ?? "") })
-  );
-  const shared = Object.entries(opts.shared ?? {}).map(
-    ([name, v]) => ({ name, singleton: !!v.singleton, requiredVersion: v.requiredVersion ?? false })
-  );
-  const chain = [];
-  chain.push(app.host ? "\u5BBF\u4E3B\u63D0\u4F9B AppContext\uFF08provideAppContext\uFF0C\u542B sessionKey\uFF09\u2192 \u52A0\u8F7D remoteEntry/\u5171\u4EAB\u4F9D\u8D56 \u2192 \u9996\u6B21 loadRemote \u6267\u884C\u8BE5\u8FDC\u7A0B\u53EF\u9009 setup/onSession \u2192 \u53D6\u5F97\u9875\u9762\u6A21\u5757 \u2192 \u5BBF\u4E3B\u5E03\u5C40\u6E32\u67D3" : "\u88AB\u5BBF\u4E3B\u6D88\u8D39\uFF1AremoteEntry/\u5171\u4EAB\u4F9D\u8D56\u52A0\u8F7D \u2192 \u5BBF\u4E3B\u9996\u6B21 loadRemote \u672C\u5E94\u7528\u6A21\u5757\u65F6\u6267\u884C\u53EF\u9009 setup/onSession \u2192 \u9875\u9762\u6A21\u5757\u5728\u5BBF\u4E3B\u5E03\u5C40\u5185\u6E32\u67D3");
-  if (app.remote?.setup) {
-    chain.push(`setup \u5165\u53E3 ${app.remote.setup}\uFF1A\u9ED8\u8BA4\u5BFC\u51FA\u5E94\u7528\u7EA7\u6267\u884C\u4E00\u6B21\uFF1B${"onSession"} \u6309\u5BBF\u4E3B sessionKey \u53BB\u91CD\uFF08\u7F3A sessionKey \u65F6\u62A5 MFU-013\uFF09`);
-  } else {
-    chain.push("\u672C\u5E94\u7528\u672A\u914D\u7F6E setup\uFF1A\u65E0\u521D\u59CB\u5316\u751F\u547D\u5468\u671F\uFF0CloadRemote \u76F4\u63A5\u8FD4\u56DE\u6A21\u5757\uFF08\u666E\u901A expose \u8BED\u4E49\uFF09");
-  }
-  return {
-    app: app.name,
-    role: roleOf(app),
-    mode: "repo",
-    path: app.path,
-    base: app.base,
-    port: app.port,
-    remotes,
-    exposes: Object.keys(app.remote?.exposes ?? {}),
-    setup: app.remote?.setup,
-    shared,
-    devSharedSelf: {
-      value: opts.devSharedSelf === true,
-      source: app.devSharedSelf === void 0 ? "inferred" : "explicit"
-    },
-    pages: pageMappings(app),
-    pagesSource: app.host?.pages ? "\u4ED3\u5E93\u914D\u7F6E host.pages \u526F\u672C\uFF08\u517C\u5BB9\u5F62\u6001\uFF1B\u5355\u9879\u76EE\u5F62\u6001\u8BF7\u6539\u7528 hostPages \u5177\u540D\u5BFC\u51FA\uFF09" : "\u4ED3\u5E93\u914D\u7F6E\u672A\u63D0\u4F9B\u9875\u9762\u8868\u2014\u2014\u5E94\u7528\u4EE3\u7801\u9875\u9762\u8868\u4E3A\u8FD0\u884C\u65F6\u771F\u6E90",
-    chain
-  };
-}
-async function explainApp(configPath, appName) {
-  const loaded = await loadAppConfig(configPath);
-  if (loaded.kind === "repo") {
-    if (!appName) {
-      throw new Error("[fulgurjs:explain] \u805A\u5408\u914D\u7F6E\u9700 --app <\u5E94\u7528\u76EE\u5F55\u540D\u6216\u5BB9\u5668\u540D>\uFF08\u5355\u9879\u76EE\u914D\u7F6E\u53EF\u7701\u7565\uFF09");
-    }
-    return explainRepoMode(loaded.repo, appName);
-  }
-  return explainAppMode(loaded, appName);
+async function explainApp(configPath) {
+  return explainAppMode(await loadAppConfig(configPath));
 }
 function formatExplain(r) {
   const roleText = r.role === "dual" ? "\u5BBF\u4E3B+\u8FDC\u7A0B\uFF08\u53CC\u89D2\u8272\uFF09" : r.role === "host" ? "\u5BBF\u4E3B" : "\u8FDC\u7A0B";
   const L = [];
-  if (r.mode === "app") {
-    L.push(`\u5E94\u7528 ${r.app}\uFF08${roleText}\uFF0C\u5355\u9879\u76EE\u914D\u7F6E\uFF0C\u76EE\u5F55 ${r.path}\uFF1Bbase/dev \u7AEF\u53E3\u7531 vite.config.ts \u7BA1\u7406\uFF09`);
-  } else {
-    L.push(`\u5E94\u7528 ${r.app}\uFF08${roleText}\uFF0C\u76EE\u5F55 ${r.path}\uFF0Cdev \u7AEF\u53E3 ${r.port}\uFF0Cbase ${r.base}\uFF09\u3010\u65E7\u805A\u5408\u914D\u7F6E\u5F62\u6001\uFF0C\u517C\u5BB9\u671F\u3011`);
-  }
+  L.push(`\u5E94\u7528 ${r.app}\uFF08${roleText}\uFF0C\u5355\u9879\u76EE\u914D\u7F6E\uFF0C\u76EE\u5F55 ${r.path}\uFF1Bbase/dev \u7AEF\u53E3\u7531 vite.config.ts \u7BA1\u7406\uFF09`);
   if (r.remotes.length) {
     L.push("\u6D88\u8D39\u8FDC\u7A0B\uFF1A");
     for (const x of r.remotes) L.push(`  ${x.key} \u2192 dev ${x.dev} / prod ${x.prod}`);
@@ -1100,31 +791,6 @@ function manifestUrlForRemoteAddress(addr) {
   if (/fulgurjs-remoteEntry\.js$/.test(clean)) return clean.replace(/fulgurjs-remoteEntry\.js$/, "fulgurjs-manifest.json");
   return `${clean}/fulgurjs-manifest.json`;
 }
-async function fetchRemoteManifestRepo(cfg, app, opts) {
-  const explicit = opts.manifests?.[app.name] ?? opts.manifests?.[app.path];
-  if (explicit) {
-    if (/^https?:\/\//.test(explicit)) {
-      const got2 = await manifestFromUrl(explicit);
-      return got2 ? { manifest: got2.manifest, from: explicit } : void 0;
-    }
-    const got = manifestFromFile(explicit);
-    return got ? { manifest: got, from: explicit } : void 0;
-  }
-  if (opts.site) {
-    const base = app.base === "/" ? "" : app.base.replace(/\/$/, "");
-    const url = `${opts.site.replace(/\/$/, "")}${base}/fulgurjs-manifest.json`;
-    const got = await manifestFromUrl(url);
-    if (got) return { manifest: got.manifest, from: got.url };
-    return void 0;
-  }
-  const candidates = [app.deployDir || app.base.replace(/^\/|\/$/g, ""), "dist"];
-  for (const dir of candidates) {
-    const p = path2.join(cfg.root, app.path, dir, "fulgurjs-manifest.json");
-    const got = manifestFromFile(p);
-    if (got) return { manifest: got, from: p };
-  }
-  return void 0;
-}
 async function fetchRemoteManifestApp(loaded, options, remoteName, opts) {
   const explicit = opts.manifests?.[remoteName];
   if (explicit) {
@@ -1220,83 +886,8 @@ async function checkPagesApp(loaded, opts) {
   const unverified = issues.filter((i) => i.level === "unverified").length;
   return { app: options.name, checked, issues, failed, unverifiedFailed: !!opts.requireVerified && unverified > 0, manifestSources: sources };
 }
-async function checkPagesRepo(cfg, appPathOrName, opts) {
-  const app = cfg.apps.find((a) => a.path === appPathOrName || a.name === appPathOrName);
-  if (!app) {
-    throw new Error(`[fulgurjs:check-pages] \u5E94\u7528 "${appPathOrName}" \u4E0D\u5728\u914D\u7F6E\u4E2D\uFF08\u53EF\u7528\uFF1A${cfg.apps.map((a) => a.path).join("\u3001")}\uFF09`);
-  }
-  const issues = [];
-  const pages = app.host?.pages ?? [];
-  const prefixes = app.host?.remotePrefixes ?? {};
-  if (pages.length === 0) {
-    issues.push({
-      level: "unverified",
-      message: "\u4ED3\u5E93\u914D\u7F6E\u672A\u63D0\u4F9B\u9875\u9762\u8868\uFF08pages \u53EF\u9009\uFF0C\u5E94\u7528\u4EE3\u7801\u9875\u9762\u8868\u4E3A\u8FD0\u884C\u65F6\u771F\u6E90\uFF09\u2014\u2014\u672C\u547D\u4EE4\u65E0\u4ECE\u6838\u5BF9\u3002\n  \u4FEE\u6CD5: \u5728 fulgurjs.config.ts \u5BBF\u4E3B host.pages \u63D0\u4F9B\u9875\u9762\u8868\u526F\u672C\uFF0C\u6216\u4F9D\u8D56 dev \u671F remoteSchema \u63A2\u9488\u6821\u9A8C"
-    });
-    return { app: app.name, checked: 0, issues, failed: false, unverifiedFailed: !!opts.requireVerified && issues.some((i) => i.level === "unverified"), manifestSources: [] };
-  }
-  const violations = validatePages(pages, { remotes: prefixes });
-  for (const v of violations) {
-    issues.push({ level: v.level === "error" ? "error" : "warn", message: v.message });
-  }
-  const remoteNames = [...new Set(Object.values(prefixes))];
-  const manifests = /* @__PURE__ */ new Map();
-  const sources = [];
-  for (const name of remoteNames) {
-    const remoteApp = cfg.apps.find((a) => a.name === name);
-    if (!remoteApp) {
-      issues.push({ level: "error", message: `\u8DEF\u7531\u524D\u7F00\u6620\u5C04\u5230\u672A\u77E5\u8FDC\u7A0B "${name}"\u2014\u2014\u914D\u7F6E apps \u4E2D\u4E0D\u5B58\u5728\u8BE5\u5BB9\u5668\u540D` });
-      continue;
-    }
-    const got = await fetchRemoteManifestRepo(cfg, remoteApp, opts);
-    if (!got) {
-      const how = opts.manifests?.[name] ?? opts.manifests?.[remoteApp.path] ? `--manifest \u6307\u5B9A\u6765\u6E90\u4E0D\u53EF\u8FBE\u6216\u975E\u6709\u6548 manifest` : opts.site ? `--site ${opts.site} \u6309 base \u63A8\u5BFC\u7684 manifest URL \u4E0D\u53EF\u8FBE\uFF08\u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5931\u8D25\u65F6\u4E0D\u56DE\u9000\u672C\u5730 dist\uFF09` : "\u672C\u5730 dist \u672A\u547D\u4E2D\u4E14\u672A\u6307\u5B9A --site/--manifest";
-      issues.push({
-        level: "unverified",
-        message: `\u8FDC\u7A0B "${name}" \u7684 manifest \u4E0D\u53EF\u5F97\uFF08${how}\uFF09\u2014\u2014\u8BE5\u8FDC\u7A0B\u7684 spec \u5B58\u5728\u6027\u65E0\u6CD5\u6838\u5BF9\u3002
-  \u4FEE\u6CD5: \u5148\u6784\u5EFA\u8BE5\u8FDC\u7A0B\uFF08\u4EA7\u7269\u542B fulgurjs-manifest.json\uFF09\uFF0C\u6216\u7528 --site <URL> \u6307\u5411\u5DF2\u90E8\u7F72\u7AD9\u70B9\uFF0C\u6216 --manifest ${name}=<\u8DEF\u5F84|URL>`
-      });
-      continue;
-    }
-    manifests.set(name, { exposes: new Set([...normalizeExposes(got.manifest).keys()].map(normSpecKey)), from: got.from });
-    sources.push({ remote: name, from: got.from });
-  }
-  const derive = app.host?.deriveSpec ?? ((r) => r.split("/").filter(Boolean).slice(1).filter((s) => !s.startsWith(":")).join("/"));
-  let checked = 0;
-  for (const page of pages) {
-    const prefixHit = Object.entries(prefixes).sort((a, b) => b[0].length - a[0].length).find(
-      ([p]) => page.route.startsWith(p.endsWith("/") ? p : `${p}/`) || `${page.route}/` === (p.endsWith("/") ? p : `${p}/`)
-    );
-    if (!prefixHit) {
-      issues.push({ level: "error", message: `\u8DEF\u7531 "${page.route}" \u4E0D\u5728\u4EFB\u4F55 remotePrefixes \u524D\u7F00\u4E0B` });
-      continue;
-    }
-    checked++;
-    const m = manifests.get(prefixHit[1]);
-    if (!m) continue;
-    const spec = normSpecKey(String(page.spec ?? derive(page.route)));
-    if (!m.exposes.has(spec)) {
-      issues.push({
-        level: "error",
-        message: `\u8DEF\u7531 "${page.route}" \u7684 spec "${spec}" \u4E0D\u5728\u8FDC\u7A0B "${prefixHit[1]}" \u7684 exposes \u6E05\u5355\u4E2D\uFF08\u6765\u6E90 ${m.from}\uFF09\u3002
-  \u8FDC\u7A0B\u5B9E\u9645 exposes\uFF08\u524D 10\uFF09\uFF1A${[...m.exposes].slice(0, 10).join("\u3001") || "\uFF08\u7A7A\uFF09"}
-  \u4FEE\u6CD5: \u6838\u5BF9\u8FDC\u7A0B federation({ exposes }) \u952E\u540D\u6216\u4FEE\u6B63\u9875\u9762\u8868 spec`
-      });
-    }
-  }
-  const failed = issues.some((i) => i.level === "error");
-  const unverifiedCount = issues.filter((i) => i.level === "unverified").length;
-  return { app: app.name, checked, issues, failed, unverifiedFailed: !!opts.requireVerified && unverifiedCount > 0, manifestSources: sources };
-}
-async function checkPages(configPath, appPathOrName, opts = {}) {
-  const loaded = await loadAppConfig(configPath);
-  if (loaded.kind === "repo") {
-    if (!appPathOrName) {
-      throw new Error("[fulgurjs:check-pages] \u805A\u5408\u914D\u7F6E\u9700 --app <\u5E94\u7528\u76EE\u5F55\u540D\u6216\u5BB9\u5668\u540D>\uFF08\u5355\u9879\u76EE\u914D\u7F6E\u53EF\u7701\u7565\uFF09");
-    }
-    return checkPagesRepo(loaded.repo, appPathOrName, opts);
-  }
-  return checkPagesApp(loaded, opts);
+async function checkPages(configPath, opts = {}) {
+  return checkPagesApp(await loadAppConfig(configPath), opts);
 }
 function formatCheckPages(r) {
   const L = [];
@@ -1305,7 +896,7 @@ function formatCheckPages(r) {
   const warns = r.issues.filter((i) => i.level === "warn");
   L.push(`[fulgurjs:check-pages] \u5E94\u7528 ${r.app}\uFF1A\u6838\u5BF9 ${r.checked} \u6761\u9875\u9762\uFF0Cerror ${errors.length} / warn ${warns.length} / \u65E0\u6CD5\u9A8C\u8BC1 ${unverified.length}`);
   if (r.manifestSources?.length) {
-    L.push("manifest \u6765\u6E90\uFF08\u4F18\u5148\u7EA7\uFF1A--manifest > --site/prod \u63A8\u5BFC\uFF1B\u672C\u5730 dist \u4EC5\u5728\u672A\u6307\u5B9A\u4EFB\u4F55\u7EBF\u4E0A\u6765\u6E90\u65F6\u515C\u5E95\uFF1B\u4EE5\u5B9E\u9645\u547D\u4E2D\u7684\u6765\u6E90\u4E3A\u51C6\uFF09\uFF1A");
+    L.push("manifest \u6765\u6E90\uFF08\u4F18\u5148\u7EA7\uFF1A--manifest > --site/prod \u63A8\u5BFC\uFF1B\u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5931\u8D25\u4E0D\u56DE\u9000\u3001\u4EE5\u5B9E\u9645\u547D\u4E2D\u7684\u6765\u6E90\u4E3A\u51C6\uFF09\uFF1A");
     for (const s of r.manifestSources) L.push(`  ${s.remote} \u2190 ${s.from}`);
   }
   for (const i of [...errors, ...warns, ...unverified]) L.push(`
@@ -1322,7 +913,6 @@ var init_commands = __esm({
   "src/commands.ts"() {
     "use strict";
     init_app_config();
-    init_config();
     init_pages();
     init_manifest();
     DEFAULT_DERIVE = (route) => route.split("/").filter(Boolean).slice(1).filter((s) => !s.startsWith(":")).join("/");
@@ -1647,29 +1237,23 @@ var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
   fulgurjs init [--template <path>] [--force]      \u751F\u6210\u5355\u9879\u76EE fulgurjs.config.ts \u8D77\u6B65\u6A21\u677F
                                                    \uFF08\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF09
   fulgurjs init --config <path>                    \u6821\u9A8C\u914D\u7F6E\uFF1B\u8F93\u51FA federation(fulgurjsConfig) \u63A5\u5165\u5757
-                                                 \u4E0E\u63A5\u5165\u6838\u5BF9\u6E05\u5355\uFF08NGINX \u6837\u677F\u4EC5\u968F\u65E7\u805A\u5408\u914D\u7F6E\u6253\u5370\uFF09
-  fulgurjs explain [--config <path>] [--app <name>] [--json]
-                                                 \u89E3\u91CA\u672C\u5E94\u7528\u6709\u6548\u8054\u90A6\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE\uFF08\u7EAF\u672C\u5730\uFF0C\u65E0\u7F51\u7EDC\uFF1B
-                                                 \u5355\u9879\u76EE\u5F62\u6001\u514D --app\uFF0C\u65E7\u805A\u5408\u914D\u7F6E\u5FC5\u586B\uFF09
-  fulgurjs check-pages [--config <path>] [--app <name>] [--site <URL>]
+                                                 \u4E0E\u63A5\u5165\u6838\u5BF9\u6E05\u5355
+  fulgurjs explain [--config <path>] [--json]      \u89E3\u91CA\u672C\u5E94\u7528\u6709\u6548\u8054\u90A6\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE\uFF08\u7EAF\u672C\u5730\uFF0C\u65E0\u7F51\u7EDC\uFF09
+  fulgurjs check-pages [--config <path>] [--site <URL>]
                         [--manifest <remote>=<\u8DEF\u5F84|URL>]... [--require-verified] [--json]
                                                  \u6838\u5BF9\u5BBF\u4E3B\u9875\u9762\u8868\u4E0E\u8FDC\u7A0B exposes\uFF08\u5BBF\u4E3B\u9879\u76EE\u8FD0\u884C\uFF1B
                                                  manifest \u6765\u6E90\u4F18\u5148\u7EA7 --manifest > --site/prod \u63A8\u5BFC\uFF0C
-                                                 \u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5931\u8D25\u4E0D\u56DE\u9000\u672C\u5730 dist\uFF1B\u672C\u5730 dist \u4EC5\u5728
-                                                 \u672A\u6307\u5B9A\u4EFB\u4F55\u7EBF\u4E0A\u6765\u6E90\u65F6\u515C\u5E95\uFF1B\u786E\u5B9A\u6027\u9519\u8BEF\u975E\u96F6\u9000\u51FA\uFF1B
+                                                 \u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5931\u8D25\u4E0D\u56DE\u9000\uFF1B\u786E\u5B9A\u6027\u9519\u8BEF\u975E\u96F6\u9000\u51FA\uFF1B
                                                  --require-verified \u65F6\u65E0\u6CD5\u9A8C\u8BC1\u4E5F\u975E\u96F6\uFF09
   fulgurjs doctor --base <URL> --apps <a,b,c> [--dev] [--json] [--chunk-sample N]
   fulgurjs --help
 
-\u793A\u4F8B\uFF08\u5355\u9879\u76EE\u5F62\u6001\uFF0C\u5E94\u7528\u6839\u76EE\u5F55\u5185\u8FD0\u884C\uFF09\uFF1A
+\u793A\u4F8B\uFF08\u5E94\u7528\u6839\u76EE\u5F55\u5185\u8FD0\u884C\uFF09\uFF1A
   fulgurjs init                                    # \u5F53\u524D\u76EE\u5F55\u5199 fulgurjs.config.ts\uFF08\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF0C--force \u8986\u76D6\uFF09
   fulgurjs explain                                 # \u89E3\u91CA\u672C\u5E94\u7528\uFF08--config \u6307\u5411\u5176\u4ED6\u8DEF\u5F84\u65F6\u663E\u5F0F\u4F20\uFF09
   fulgurjs check-pages --site http://your-site     # \u6309 remotes prod \u5730\u5740\u63A8\u5BFC\u8FDC\u7A0B manifest \u6838\u5BF9
   fulgurjs check-pages --manifest remote-a=https://cdn.example.com/remote-a/fulgurjs-manifest.json
   fulgurjs doctor --base http://your-site --apps my-app,remote-a
-
-\u65E7\u805A\u5408\u914D\u7F6E\uFF08root + apps[]\uFF0C\u517C\u5BB9\u671F\uFF09\uFF1A\u6240\u6709\u5B50\u547D\u4EE4\u52A0 --config \u6307\u5411\u805A\u5408\u6587\u4EF6\uFF0C
-explain/check-pages \u9700 --app <\u5E94\u7528\u76EE\u5F55\u540D\u6216\u5BB9\u5668\u540D>\u3002
 `;
 async function main() {
   const argv = process.argv.slice(2);
@@ -1689,7 +1273,7 @@ async function main() {
       if (a !== k) return;
       const v = argv[i + 1];
       const eq = v?.indexOf("=");
-      if (!v || !eq || eq < 1) return;
+      if (!v || eq === void 0 || eq < 1) return;
       out[v.slice(0, eq)] = v.slice(eq + 1);
     });
     return out;
@@ -1726,11 +1310,18 @@ async function main() {
     return 0;
   }
   if (cmd === "explain" || cmd === "check-pages") {
-    const app = argOf("--app");
+    if (has("--app")) {
+      console.error(
+        `[fulgurjs] \u4E0D\u518D\u652F\u6301 --app \u53C2\u6570
+\u6839\u56E0\uFF1A--app \u662F 4.1.0 \u805A\u5408\u914D\u7F6E\uFF08root + apps[]\uFF09\u7684\u5E94\u7528\u9009\u62E9\u5668\uFF0C\u805A\u5408\u94FE\uFF08@fulgurjs/federation/config\u3001defineRepoConfig\u3001loadRepoConfig\u3001federationOptionsForApp\uFF09\u5DF2\u5728 5.0.0 \u5220\u9664
+\u4FEE\u6CD5\uFF1A\u6BCF\u4E2A\u5E94\u7528\u6839\u76EE\u5F55\u4E00\u4EFD fulgurjs.config.ts\uFF0C\u5728\u5E94\u7528\u76EE\u5F55\u5185\u76F4\u63A5\u8FD0\u884C fulgurjs ${cmd}\uFF08\u53BB\u6389 --app\uFF09`
+      );
+      return 2;
+    }
     try {
       if (cmd === "explain") {
         const { explainApp: explainApp2, formatExplain: formatExplain2 } = await Promise.resolve().then(() => (init_commands(), commands_exports));
-        const r2 = await explainApp2(resolve(argOf("--config") ?? "fulgurjs.config.ts"), app);
+        const r2 = await explainApp2(resolve(argOf("--config") ?? "fulgurjs.config.ts"));
         console.log(has("--json") ? JSON.stringify(r2, null, 2) : formatExplain2(r2));
         return 0;
       }
@@ -1740,7 +1331,7 @@ async function main() {
         ...Object.keys(kvAllOf("--manifest")).length ? { manifests: kvAllOf("--manifest") } : {},
         ...has("--require-verified") ? { requireVerified: true } : {}
       };
-      const r = await checkPages2(resolve(argOf("--config") ?? "fulgurjs.config.ts"), app, opts);
+      const r = await checkPages2(resolve(argOf("--config") ?? "fulgurjs.config.ts"), opts);
       console.log(has("--json") ? JSON.stringify(r, null, 2) : formatCheckPages2(r));
       return r.failed || r.unverifiedFailed ? 1 : 0;
     } catch (e) {