create-windy 0.2.26 → 0.2.27

package/dist/cli.js

@@ -4335,7 +4335,8 @@ var recipes = [
   { id: "starter-0.2.22-to-0.2.23", from: "0.2.22", to: "0.2.23" },
   { id: "starter-0.2.23-to-0.2.24", from: "0.2.23", to: "0.2.24" },
   { id: "starter-0.2.24-to-0.2.25", from: "0.2.24", to: "0.2.25" },
-  { id: "starter-0.2.25-to-0.2.26", from: "0.2.25", to: "0.2.26" }
+  { id: "starter-0.2.25-to-0.2.26", from: "0.2.25", to: "0.2.26" },
+  { id: "starter-0.2.26-to-0.2.27", from: "0.2.26", to: "0.2.27" }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
   if (sourceVersion === targetVersion)
@@ -4457,6 +4458,9 @@ var correctCoreDescription = "创建时未选择 `work-order` 示例模块，当
 var wrongExampleRow = /^\|\s*示例工单\s*\|\s*已包含\s*\|$/m;
 var correctCoreRow = /^\|\s*示例工单\s*\|\s*未包含\s*\|$/m;
 function repairKnownDerivedFile(input) {
+  const neutralRouterRepair = repairKnown026Downstream(input);
+  if (neutralRouterRepair !== undefined)
+    return neutralRouterRepair;
   const downstreamRepair = repairKnown023Downstream(input);
   if (downstreamRepair !== undefined)
     return downstreamRepair;
@@ -4477,6 +4481,27 @@ function repairKnownDerivedFile(input) {
   }
   return input.content.replace(wrongExampleDescription, correctCoreDescription).replace(wrongExampleRow, targetRow);
 }
+function repairKnown026Downstream(input) {
+  if (input.sourceVersion !== "0.2.26")
+    return;
+  if (input.path === "apps/web/src/router/index.ts" && input.targetContent.includes("@/pages/auth/LoginPage.vue")) {
+    return replaceKnown(input.content, 'import LoginPage from "@/app/auth/LijianLoginPage.vue";', 'import LoginPage from "@/pages/auth/LoginPage.vue";');
+  }
+  if (input.path !== "apps/web/src/router/router-test-fixtures.ts" || input.targetContent.includes("lijian.")) {
+    return;
+  }
+  const replacements2 = [
+    ["lijian.case.read", "case.read"],
+    ["lijian.evidence.read", "evidence.read"],
+    ["lijian.case", "case"],
+    ["lijian.evidence.import", "evidence.import"],
+    ["lijian.evidence", "evidence"]
+  ];
+  if (!replacements2.every(([source]) => input.content.includes(source))) {
+    return;
+  }
+  return replacements2.reduce((content, [source, target]) => content.replaceAll(source, target), input.content);
+}
 function repairKnown023Downstream(input) {
   if (input.sourceVersion !== "0.2.23" || known023DownstreamHashes.get(input.path) !== contentHash(input.content)) {
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.2.26",
+  "version": "0.2.27",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "f73d192acc1af99fe232b51ac638c1e0e7d204c9",
-  "generatorVersion": "0.2.26",
+  "templateCommit": "c7bfbd0a1c530a6aa68cc25ba12911763cddccb4",
+  "generatorVersion": "0.2.27",
   "modules": [
     {
       "name": "system",

package/template/apps/server/src/foundation.ts

@@ -77,8 +77,8 @@ function collectAuditActions(modules: ModuleManifest[]): string[] {
 
 export function createFoundationSnapshot(
   config: PlatformConfig = loadPlatformConfig(),
+  modules: ModuleManifest[] = loadFoundationModules(),
 ): FoundationSnapshot {
-  const modules = loadFoundationModules();
   const catalogs = validateCapabilityCatalogs(
     modules,
     resolveLicenseCatalog(config.license.versions),

package/template/apps/server/src/module-bootstrap.ts

@@ -6,6 +6,7 @@ import {
   createFoundationSnapshot,
   loadFoundationModules,
 } from "./foundation.js";
+import { runInstalledModuleMigrations } from "./module-migrations.js";
 import {
   attachInstalledBusinessModules,
   installedBusinessModules,
@@ -27,17 +28,24 @@ export async function bootstrapServerModules(
   platformConfig: PlatformConfig,
   persistence: ServerPersistence | undefined,
 ) {
+  const foundationModules = loadFoundationModules();
+  const foundationSnapshot = createFoundationSnapshot(
+    platformConfig,
+    foundationModules,
+  );
+  const moduleMigrationReport = await runInstalledModuleMigrations(
+    foundationModules,
+    persistence?.pool,
+  );
   // @windy-module system.configuration begin
   const configurationRuntime = await bootstrapModuleConfiguration(
     platformConfig,
     persistence?.configVersionRepository,
   );
   // @windy-module system.configuration end
-  const foundationSnapshot = createFoundationSnapshot(platformConfig);
   // @windy-module system.configuration begin
   configurationRuntime.bindFoundation(foundationSnapshot);
   // @windy-module system.configuration end
-  const foundationModules = loadFoundationModules();
   const moduleHosts = await initializeModuleHosts({
     modules: foundationModules,
     installations: installedBusinessModules,
@@ -78,6 +86,7 @@ export async function bootstrapServerModules(
     foundationModules,
     foundationSnapshot,
     moduleHosts,
+    moduleMigrationReport,
     systemRepositories,
   };
 }

package/template/apps/server/src/module-migrations.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "bun:test";
+import type { ModuleManifest } from "@southwind-ai/modules";
+import { runInstalledModuleMigrations } from "./module-migrations.js";
+
+describe("Server Module Migration 启动 seam", () => {
+  test("没有显式 bundle 时不占用 PostgreSQL 连接", async () => {
+    let connected = false;
+    const result = await runInstalledModuleMigrations([manifest()], {
+      async connect() {
+        connected = true;
+        throw new Error("不应获取连接");
+      },
+    });
+
+    expect(result).toBeUndefined();
+    expect(connected).toBe(false);
+  });
+
+  test("未配置 PostgreSQL 时保留纯结构校验启动路径", async () => {
+    const result = await runInstalledModuleMigrations([manifest()], undefined);
+    expect(result).toBeUndefined();
+  });
+});
+
+function manifest(): ModuleManifest {
+  return {
+    name: "customer-domain",
+    version: "1.0.0",
+    label: "客户领域",
+    description: "测试模块",
+    menus: [],
+    adminRoutes: [],
+    permissions: [],
+    apiPermissions: [],
+    features: [],
+    migrations: [],
+    schemaExports: [],
+    tasks: [],
+    tools: [],
+    providers: [],
+    auditActions: [],
+  };
+}

package/template/apps/server/src/module-migrations.ts

@@ -0,0 +1,19 @@
+import {
+  runPostgresMigrationBundles,
+  type MigrationRunReport,
+  type PostgresTransactionPool,
+} from "@southwind-ai/database";
+import type { ModuleManifest } from "@southwind-ai/modules";
+import { normalizeManifestBundles } from "@southwind-ai/shared";
+
+export async function runInstalledModuleMigrations(
+  modules: readonly ModuleManifest[],
+  pool: PostgresTransactionPool | undefined,
+): Promise<MigrationRunReport | undefined> {
+  const bundledModules = modules.filter((module) => module.migrationBundle);
+  if (!pool || bundledModules.length === 0) return undefined;
+  return runPostgresMigrationBundles({
+    pool,
+    bundles: normalizeManifestBundles(bundledModules),
+  });
+}

package/template/apps/web/src/router/shared-scaffold-neutrality.webtest.ts

@@ -0,0 +1,14 @@
+import { describe, expect, test } from "vitest";
+import routerSource from "./index.ts?raw";
+import fixtureSource from "./router-test-fixtures.ts?raw";
+
+describe("Router shared-scaffold 中性契约", () => {
+  test("平台登录页与测试快照不固化下游产品命名", () => {
+    expect(routerSource).toContain(
+      'import LoginPage from "@/pages/auth/LoginPage.vue";',
+    );
+    expect(`${routerSource}\n${fixtureSource}`).not.toMatch(
+      /LijianLoginPage|lijian\./,
+    );
+  });
+});

package/template/docs/architecture/module-manifest-composition.md

@@ -45,6 +45,17 @@ Manifest 当前覆盖：
 
 这种边界允许宿主替换实现，同时保持 Manifest 的能力语义稳定。
 
+## Capability Key 重命名边界
+
+平台当前没有 Module、Feature、Permission、Task、Tool、Operation 或 API Key 的通用
+rename/alias seam。Composition、Guard、history 和审计都按 Manifest 中的精确稳定 Key
+工作，不会把旧 Key 静默映射到新 Key。
+
+产品需要硬切命名时，应在停机窗口一次性更新 Manifest、Host 实现、调用方、持久化权限
+和任务数据，并通过 project-owned forward Migration 完成 schema/data rename。若产品
+确实需要跨版本兼容期，应先单独设计带期限、冲突规则和审计语义的 alias 契约；当前
+平台不会为某个下游产品内置别名。
+
 ## 分批落地
 
 - 第一批：类型、声明级验证和失败回归。

package/template/packages/database/drizzle/0032_marvelous_pepper_potts.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "windy_migration_history" ADD COLUMN "module_version" varchar(64);--> statement-breakpoint
+ALTER TABLE "windy_migration_history" ADD COLUMN "migration_order" integer;