create-windy 0.2.25 → 0.2.27

package/dist/cli.js

@@ -4058,10 +4058,28 @@ import { join as join12 } from "node:path";
 
 // src/update/process.ts
 import { spawn as spawn3 } from "node:child_process";
+var LOCAL_GIT_ENVIRONMENT_VARIABLES = [
+  "GIT_ALTERNATE_OBJECT_DIRECTORIES",
+  "GIT_CONFIG",
+  "GIT_CONFIG_PARAMETERS",
+  "GIT_CONFIG_COUNT",
+  "GIT_OBJECT_DIRECTORY",
+  "GIT_DIR",
+  "GIT_WORK_TREE",
+  "GIT_IMPLICIT_WORK_TREE",
+  "GIT_GRAFT_FILE",
+  "GIT_INDEX_FILE",
+  "GIT_NO_REPLACE_OBJECTS",
+  "GIT_REPLACE_REF_BASE",
+  "GIT_PREFIX",
+  "GIT_SHALLOW_FILE",
+  "GIT_COMMON_DIR"
+];
 async function captureProcess(command, args, cwd, inherit = false) {
   return await new Promise((resolve4, reject) => {
     const child = spawn3(command, args, {
       cwd,
+      env: withoutParentGitRepository(process.env),
       stdio: inherit ? "inherit" : ["ignore", "pipe", "pipe"]
     });
     let stdout2 = "";
@@ -4080,6 +4098,13 @@ async function assertProcess(command, args, cwd, inherit = false) {
   }
   return result;
 }
+function withoutParentGitRepository(source) {
+  const environment = { ...source };
+  for (const key of LOCAL_GIT_ENVIRONMENT_VARIABLES) {
+    delete environment[key];
+  }
+  return environment;
+}
 
 // src/update/transaction.ts
 import {
@@ -4309,7 +4334,9 @@ var recipes = [
   { id: "starter-0.2.21-to-0.2.22", from: "0.2.21", to: "0.2.22" },
   { 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.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.26-to-0.2.27", from: "0.2.26", to: "0.2.27" }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
   if (sourceVersion === targetVersion)
@@ -4431,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;
@@ -4451,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.25",
+  "version": "0.2.27",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "02fc178560c17d0e17022dd785ff1f11e5350179",
-  "generatorVersion": "0.2.25",
+  "templateCommit": "c7bfbd0a1c530a6aa68cc25ba12911763cddccb4",
+  "generatorVersion": "0.2.27",
   "modules": [
     {
       "name": "system",

package/template/apps/server/src/agent/data-scope-routes.test.ts

@@ -1,9 +1,6 @@
 import { describe, expect, test } from "bun:test";
 import { buildScopeContext } from "../data-access/context.js";
-import {
-  createFoundationSnapshot,
-  loadFoundationModules,
-} from "../foundation.js";
+import { createFoundationSnapshot, loadSystemModules } from "../foundation.js";
 import { createServerRuntime } from "../runtime.js";
 import { FakeRouteApp } from "../system/route-test-app.js";
 import { createSystemRepositories } from "../system/seed.js";
@@ -31,13 +28,13 @@ describe("Agent Tool data scope", () => {
     expect(
       () =>
         new GovernedToolRegistry(
-          loadFoundationModules(),
+          loadSystemModules(),
           missing as ModuleToolHandlers,
           runtime,
         ),
     ).toThrow("缺少 Handler");
     expect(
-      () => new GovernedToolRegistry(loadFoundationModules(), extra, runtime),
+      () => new GovernedToolRegistry(loadSystemModules(), extra, runtime),
     ).toThrow("Handler 未声明");
   });
 
@@ -67,7 +64,7 @@ describe("Agent Tool data scope", () => {
     registerAgentRoutes(
       app,
       new GovernedToolRegistry(
-        loadFoundationModules(),
+        loadSystemModules(),
         createSystemToolHandlers(repositories, runtime),
         runtime,
       ),
@@ -102,7 +99,7 @@ describe("Agent Tool data scope", () => {
     registerAgentRoutes(
       app,
       new GovernedToolRegistry(
-        loadFoundationModules(),
+        loadSystemModules(),
         createSystemToolHandlers(createSystemRepositories(snapshot), runtime),
         runtime,
       ),

package/template/apps/server/src/agent/routes.test.ts

@@ -3,10 +3,7 @@ import {
   entitlementKey,
   type FeatureFlagDefinition,
 } from "@southwind-ai/shared";
-import {
-  createFoundationSnapshot,
-  loadFoundationModules,
-} from "../foundation.js";
+import { createFoundationSnapshot, loadSystemModules } from "../foundation.js";
 import { createServerRuntime } from "../runtime.js";
 import type { RouteApp } from "../system/routes.js";
 import { createSystemRepositories } from "../system/seed.js";
@@ -42,7 +39,7 @@ class FakeRouteApp implements RouteApp {
 function routeFixture(features?: FeatureFlagDefinition[]) {
   const runtime = createServerRuntime({ WINDY_DEV_ADMIN_TOKEN: "token_1" });
   const app = new FakeRouteApp();
-  const modules = loadFoundationModules();
+  const modules = loadSystemModules();
   if (features) {
     modules[0] = { ...modules[0]!, features };
   }
@@ -67,7 +64,7 @@ describe("agent routes", () => {
       createSystemRepositories(createFoundationSnapshot()),
       runtime,
     );
-    const manifestKeys = loadFoundationModules().flatMap((module) =>
+    const manifestKeys = loadSystemModules().flatMap((module) =>
       module.tools.map(({ key }) => key),
     );
 
@@ -198,7 +195,7 @@ describe("agent routes", () => {
     registerAgentRoutes(
       app,
       new GovernedToolRegistry(
-        loadFoundationModules(),
+        loadSystemModules(),
         createSystemToolHandlers(repositories, runtime),
         runtime,
       ),

package/template/apps/server/src/agent/tool-registry.test.ts

@@ -1,9 +1,6 @@
 import { describe, expect, test } from "bun:test";
 import type { ModuleToolHandlers } from "./tool-registry.js";
-import {
-  createFoundationSnapshot,
-  loadFoundationModules,
-} from "../foundation.js";
+import { createFoundationSnapshot, loadSystemModules } from "../foundation.js";
 import { createServerRuntime } from "../runtime.js";
 import { createSystemRepositories } from "../system/seed.js";
 import { createSystemToolHandlers } from "./routes.js";
@@ -30,7 +27,7 @@ describe("Governed Tool Registry", () => {
       },
     });
     const registry = new GovernedToolRegistry(
-      loadFoundationModules(),
+      loadSystemModules(),
       handlers,
       fixture.runtime,
     );
@@ -56,7 +53,7 @@ describe("Governed Tool Registry", () => {
       }),
     });
     const registry = new GovernedToolRegistry(
-      loadFoundationModules(),
+      loadSystemModules(),
       invalidOutput,
       fixture.runtime,
     );
@@ -72,7 +69,7 @@ describe("Governed Tool Registry", () => {
     expect(
       () =>
         new GovernedToolRegistry(
-          loadFoundationModules(),
+          loadSystemModules(),
           mismatchedScope,
           fixture.runtime,
         ),
@@ -104,7 +101,7 @@ async function createFixture() {
     runtime,
   );
   const registry = new GovernedToolRegistry(
-    loadFoundationModules(),
+    loadSystemModules(),
     handlers,
     runtime,
   );

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

@@ -45,6 +45,12 @@ export function loadFoundationModules(): ModuleManifest[] {
   return registry.list();
 }
 
+export function loadSystemModules(): ModuleManifest[] {
+  const registry = createModuleRegistry();
+  for (const factory of systemModuleFactories) registry.register(factory);
+  return registry.list();
+}
+
 function collectMenus(modules: ModuleManifest[]): MenuNode[] {
   return composeModuleMenus(modules);
 }
@@ -71,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/http-app.test.ts

@@ -39,8 +39,11 @@ describe("platform HTTP app observability", () => {
       /^[A-Za-z0-9._-]{1,128}$/,
     );
     expect(
-      records.filter(({ event }) => event === "http.request.completed"),
-    ).toHaveLength(3);
+      records.filter(
+        ({ event, statusCode }) =>
+          event === "http.request.completed" && statusCode === 404,
+      ),
+    ).toHaveLength(2);
     expect(observability.metrics.render()).toContain(
       'windy_http_requests_total{method="GET",status_class="4xx"} 2',
     );

package/template/apps/server/src/license/runtime-service.test.ts

@@ -18,10 +18,7 @@ import {
 } from "../agent/routes.js";
 import { GovernedToolRegistry } from "../agent/tool-registry.js";
 import { runGuardedBackgroundTask } from "../background/task-guard.js";
-import {
-  createFoundationSnapshot,
-  loadFoundationModules,
-} from "../foundation.js";
+import { createFoundationSnapshot, loadSystemModules } from "../foundation.js";
 import {
   evaluateRestrictedHttpRequest,
   licenseRestrictedResponse,
@@ -266,7 +263,7 @@ function createFixture(
   registerAgentRoutes(
     app,
     new GovernedToolRegistry(
-      loadFoundationModules(),
+      loadSystemModules(),
       createSystemToolHandlers(repositories, runtime),
       runtime,
     ),

package/template/apps/server/src/mcp/adapter.test.ts

@@ -1,10 +1,7 @@
 import { afterEach, describe, expect, test } from "bun:test";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import {
-  createFoundationSnapshot,
-  loadFoundationModules,
-} from "../foundation.js";
+import { createFoundationSnapshot, loadSystemModules } from "../foundation.js";
 import { createServerRuntime } from "../runtime.js";
 import { createSystemRepositories } from "../system/seed.js";
 import { createSystemToolHandlers } from "../agent/routes.js";
@@ -104,7 +101,7 @@ describe("Platform MCP Adapter", () => {
 });
 
 function createFixture() {
-  const modules = loadFoundationModules();
+  const modules = loadSystemModules();
   const runtime = createServerRuntime(
     {},
     {

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/docs/platform/agent-runtime.md

@@ -126,13 +126,13 @@ SSE 事件包括 `output.delta`、`tool.requested`、`tool.completed`、usage，
 `run.completed`、`run.failed` 或 `run.cancelled` 终态。断线后使用已确认 sequence 作为
 cursor 恢复；不要重新创建 Run 或重复执行 Tool。
 
-## 从 create-windy 0.2.24 或更早版本升级
+## 从 create-windy 0.2.25 或更早版本升级
 
 先检查计划，再应用连续 recipe：
 
 ```bash
-bunx --bun create-windy@0.2.25 update --check
-bunx --bun create-windy@0.2.25 update
+bunx --bun create-windy@0.2.26 update --check
+bunx --bun create-windy@0.2.26 update
 bun install
 ```
 

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;