@ykdz/template 0.0.42 → 0.1.0-experimental.0

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/scripts/task-gates.ts

@@ -1,589 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-
-export type TaskGate = "check" | "check:heavy" | "check:full" | "fix";
-
-type ScriptRole =
-  | "quality:light"
-  | "quality:heavy"
-  | "quality:conditional"
-  | "quality:entry"
-  | "work:development"
-  | "work:repair"
-  | "work:release"
-  | "work:preparation"
-  | "work:lifecycle"
-  | "work:on-demand";
-
-type TurboTask = {
-  readonly name: string;
-  readonly fullName: string;
-  readonly packageName: string;
-  readonly tags: readonly string[];
-  readonly executable: boolean;
-  readonly role?: ScriptRole;
-};
-
-type GateLayer = {
-  readonly role: "quality:light" | "quality:heavy" | "work:repair";
-  readonly label: string;
-};
-
-type CommandResult = {
-  readonly status: number;
-  readonly stdout: string;
-  readonly stderr: string;
-  readonly error: Error | undefined;
-};
-
-const turboTaskQuery =
-  "{ packages { items { name tasks { items { name fullName tags script command } } } } }";
-
-const validRoles = new Set<ScriptRole>([
-  "quality:light",
-  "quality:heavy",
-  "quality:conditional",
-  "quality:entry",
-  "work:development",
-  "work:repair",
-  "work:release",
-  "work:preparation",
-  "work:lifecycle",
-  "work:on-demand",
-]);
-
-const publicGateNames = new Set<TaskGate>([
-  "check",
-  "check:heavy",
-  "check:full",
-  "fix",
-]);
-
-const maxTurboOutputBytes = 16 * 1024 * 1024;
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function isNonEmptyString(value: unknown): value is string {
-  return typeof value === "string" && value.trim().length > 0;
-}
-
-function report(message: string): void {
-  process.stderr.write(`${message}\n`);
-}
-
-function runCaptured(cwd: string, args: readonly string[]): CommandResult {
-  const result = spawnSync("pnpm", ["exec", "turbo", ...args], {
-    cwd,
-    encoding: "utf8",
-    maxBuffer: maxTurboOutputBytes,
-  });
-
-  return {
-    status: result.status ?? 1,
-    stdout: result.stdout ?? "",
-    stderr: result.stderr ?? "",
-    error: result.error,
-  };
-}
-
-function runVisible(cwd: string, args: readonly string[]): Promise<number> {
-  return new Promise((resolveStatus) => {
-    const command =
-      process.platform === "win32"
-        ? "pnpm"
-        : resolve(cwd, "node_modules/.bin/turbo");
-    const commandArgs =
-      process.platform === "win32" ? ["exec", "turbo", ...args] : args;
-    const child = spawn(command, commandArgs, {
-      cwd,
-      detached: process.platform !== "win32",
-      stdio: "inherit",
-    });
-    let interruptedBy: NodeJS.Signals | undefined;
-    const forward = (signal: NodeJS.Signals): void => {
-      if (child.exitCode === null && child.signalCode === null) {
-        interruptedBy = signal;
-        const turboSignal = signal === "SIGTERM" ? "SIGINT" : signal;
-        if (process.platform !== "win32" && child.pid !== undefined) {
-          try {
-            process.kill(-child.pid, turboSignal);
-          } catch {
-            child.kill(turboSignal);
-          }
-        } else {
-          child.kill(turboSignal);
-        }
-      }
-    };
-    const forwardInterrupt = (): void => forward("SIGINT");
-    const forwardTerminate = (): void => forward("SIGTERM");
-    const removeSignalHandlers = (): void => {
-      process.off("SIGINT", forwardInterrupt);
-      process.off("SIGTERM", forwardTerminate);
-    };
-
-    process.on("SIGINT", forwardInterrupt);
-    process.on("SIGTERM", forwardTerminate);
-    child.once("error", (error) => {
-      removeSignalHandlers();
-      report(`无法启动 Turbo 执行 ${args.join(" ")}：${error.message}`);
-      resolveStatus(1);
-    });
-    child.once("close", (code, signal) => {
-      removeSignalHandlers();
-      if (interruptedBy !== undefined) {
-        resolveStatus(interruptedBy === "SIGINT" ? 130 : 143);
-      } else if (code !== null) {
-        resolveStatus(code);
-      } else {
-        resolveStatus(
-          signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1,
-        );
-      }
-    });
-  });
-}
-
-function commandFailure(label: string, result: CommandResult): string {
-  const details = result.stderr.trim();
-  if (result.error !== undefined) {
-    return `无法运行 Turbo ${label}：${result.error.message}`;
-  }
-  return `Turbo ${label} 失败（退出码 ${String(result.status)}）${details === "" ? "" : `：\n${details}`}`;
-}
-
-function roleTags(tags: readonly string[]): readonly string[] {
-  return tags.filter(
-    (tag) => tag.startsWith("quality:") || tag.startsWith("work:"),
-  );
-}
-
-function publicGateTask(task: {
-  readonly name: string;
-  readonly packageName: string;
-}): boolean {
-  return (
-    task.packageName === "//" && publicGateNames.has(task.name as TaskGate)
-  );
-}
-
-function protectedVerificationTask(task: TurboTask): boolean {
-  return (
-    task.name === "check" ||
-    task.name.startsWith("check:") ||
-    task.name === "test" ||
-    task.name.startsWith("test:") ||
-    task.name === "lint" ||
-    task.name === "typecheck" ||
-    task.name === "format:check"
-  );
-}
-
-function assignRole(
-  task: Omit<TurboTask, "role">,
-  diagnostics: string[],
-): ScriptRole | undefined {
-  const roles = roleTags(task.tags);
-  const isPublicGate = publicGateTask(task);
-  if (roles.length === 0) {
-    diagnostics.push(
-      `${task.fullName} 缺少唯一职责标签；请在 Turbo 任务标签中声明质量范围或工作用途`,
-    );
-    return undefined;
-  }
-  if (roles.length > 1) {
-    diagnostics.push(
-      `${task.fullName} 有多个职责标签：${roles.join("、")}；每个可执行任务只能声明一个职责`,
-    );
-    return undefined;
-  }
-
-  const role = roles[0]!;
-  if (!validRoles.has(role as ScriptRole)) {
-    diagnostics.push(`${task.fullName} 使用未知职责标签 ${role}`);
-    return undefined;
-  }
-  const scriptRole = role as ScriptRole;
-  const publicRole = task.name === "fix" ? "work:repair" : "quality:entry";
-  if (isPublicGate && scriptRole !== publicRole) {
-    diagnostics.push(
-      `${task.fullName} 是公共任务入口，职责必须为 ${publicRole}，当前为 ${scriptRole}`,
-    );
-    return undefined;
-  }
-  if (!isPublicGate && scriptRole === "quality:entry") {
-    diagnostics.push(
-      `${task.fullName} 不能使用 quality:entry；该职责只允许根 check、check:heavy、check:full`,
-    );
-    return undefined;
-  }
-  if (protectedVerificationTask(task) && !scriptRole.startsWith("quality:")) {
-    diagnostics.push(
-      `${task.fullName} 是保留验收任务，不能归入非验收职责 ${scriptRole}`,
-    );
-    return undefined;
-  }
-
-  return scriptRole;
-}
-
-function readTaskDirectory(
-  cwd: string,
-  entryCommand: string,
-): {
-  readonly tasks: readonly TurboTask[];
-  readonly diagnostics: readonly string[];
-} {
-  const result = runCaptured(cwd, ["query", turboTaskQuery]);
-  if (result.error !== undefined || result.status !== 0) {
-    return {
-      diagnostics: [commandFailure("原生任务目录查询", result)],
-      tasks: [],
-    };
-  }
-
-  let response: unknown;
-  try {
-    response = JSON.parse(result.stdout) as unknown;
-  } catch (error) {
-    return {
-      diagnostics: [
-        `Turbo 原生任务目录不是有效 JSON：${error instanceof Error ? error.message : String(error)}`,
-      ],
-      tasks: [],
-    };
-  }
-
-  const packages =
-    isRecord(response) && isRecord(response.data)
-      ? response.data.packages
-      : undefined;
-  const packageItems = isRecord(packages) ? packages.items : undefined;
-  if (!Array.isArray(packageItems)) {
-    return {
-      diagnostics: ["Turbo 原生任务目录缺少 packages.items"],
-      tasks: [],
-    };
-  }
-
-  const diagnostics: string[] = [];
-  const tasks: TurboTask[] = [];
-  for (const packageItem of packageItems) {
-    if (!isRecord(packageItem) || !isNonEmptyString(packageItem.name)) {
-      diagnostics.push("Turbo 原生任务目录包含无法识别的工作区包");
-      continue;
-    }
-    const taskConnection = packageItem.tasks;
-    const taskItems = isRecord(taskConnection)
-      ? taskConnection.items
-      : undefined;
-    if (!Array.isArray(taskItems)) {
-      diagnostics.push(`${packageItem.name} 的 Turbo 任务目录缺少 tasks.items`);
-      continue;
-    }
-
-    for (const taskItem of taskItems) {
-      if (!isRecord(taskItem)) {
-        diagnostics.push(`${packageItem.name} 的 Turbo 任务目录包含无效任务`);
-        continue;
-      }
-      const { name, fullName, tags, script, command } = taskItem;
-      if (
-        !isNonEmptyString(name) ||
-        !isNonEmptyString(fullName) ||
-        !Array.isArray(tags) ||
-        !tags.every((tag) => typeof tag === "string")
-      ) {
-        diagnostics.push(`${packageItem.name} 的 Turbo 任务条目缺少名称或标签`);
-        continue;
-      }
-
-      const executable = isNonEmptyString(script) || isNonEmptyString(command);
-      const taskWithoutRole = {
-        name,
-        fullName,
-        packageName: packageItem.name,
-        tags,
-        executable,
-      };
-      if (publicGateTask(taskWithoutRole)) {
-        const expectedCommand = `${entryCommand} ${name}`;
-        if (script !== expectedCommand || command !== expectedCommand) {
-          diagnostics.push(
-            `${fullName} 公共入口接线错误；package.json script 和有效 command 必须为 ${expectedCommand}`,
-          );
-        }
-      }
-      if (!executable && roleTags(tags).length === 0) {
-        tasks.push(taskWithoutRole);
-        continue;
-      }
-
-      const role = assignRole(taskWithoutRole, diagnostics);
-      tasks.push(
-        role === undefined ? taskWithoutRole : { ...taskWithoutRole, role },
-      );
-    }
-  }
-
-  for (const name of publicGateNames) {
-    if (
-      !tasks.some((task) => task.packageName === "//" && task.name === name)
-    ) {
-      diagnostics.push(`缺少根公共任务入口 ${name}`);
-    }
-  }
-
-  return { diagnostics, tasks };
-}
-
-function parseDryRun(
-  cwd: string,
-  tasks: readonly TurboTask[],
-): {
-  readonly taskIds: readonly string[];
-  readonly diagnostics: readonly string[];
-} {
-  if (tasks.length === 0) {
-    return { diagnostics: [], taskIds: [] };
-  }
-  const result = runCaptured(cwd, [
-    "run",
-    ...tasks.map((task) => task.fullName),
-    "--dry=json",
-  ]);
-  if (result.error !== undefined || result.status !== 0) {
-    return {
-      diagnostics: [commandFailure("执行图预览", result)],
-      taskIds: [],
-    };
-  }
-
-  let response: unknown;
-  try {
-    response = JSON.parse(result.stdout) as unknown;
-  } catch (error) {
-    return {
-      diagnostics: [
-        `Turbo 执行图预览不是有效 JSON：${error instanceof Error ? error.message : String(error)}`,
-      ],
-      taskIds: [],
-    };
-  }
-  if (!isRecord(response) || !Array.isArray(response.tasks)) {
-    return {
-      diagnostics: ["Turbo 执行图预览缺少 tasks"],
-      taskIds: [],
-    };
-  }
-
-  const taskIds: string[] = [];
-  const diagnostics: string[] = [];
-  for (const task of response.tasks) {
-    if (!isRecord(task) || !isNonEmptyString(task.taskId)) {
-      diagnostics.push("Turbo 执行图预览包含无法识别的任务标识");
-      continue;
-    }
-    taskIds.push(task.taskId);
-  }
-
-  return { diagnostics, taskIds };
-}
-
-function validateLayerClosure(
-  layer: GateLayer,
-  taskIds: readonly string[],
-  tasksByName: ReadonlyMap<string, TurboTask>,
-): readonly string[] {
-  const diagnostics: string[] = [];
-  for (const taskId of taskIds) {
-    const dependency = tasksByName.get(taskId);
-    if (dependency === undefined) {
-      diagnostics.push(
-        `${layer.label} 执行图包含任务目录中不存在的任务 ${taskId}`,
-      );
-      continue;
-    }
-    if (publicGateTask(dependency)) {
-      diagnostics.push(
-        `${layer.label} 执行图包含 ${dependency.fullName}：叶任务不能依赖公共聚合入口`,
-      );
-    } else if (
-      dependency.role !== undefined &&
-      dependency.role !== layer.role &&
-      dependency.role !== "work:preparation" &&
-      !(layer.role !== "quality:light" && dependency.role === "quality:light")
-    ) {
-      const scope =
-        layer.role === "quality:light" && dependency.role === "quality:heavy"
-          ? "轻检查不能间接启动重验收"
-          : dependency.role === "quality:conditional"
-            ? "常规验收不能间接启动条件验收"
-            : `不允许间接启动职责 ${dependency.role}`;
-      diagnostics.push(
-        `${layer.label} 执行图包含 ${dependency.fullName}：${scope}`,
-      );
-    }
-  }
-
-  return diagnostics;
-}
-
-function layerFor(role: GateLayer["role"]): GateLayer {
-  return {
-    role,
-    label:
-      role === "quality:light"
-        ? "轻检查"
-        : role === "quality:heavy"
-          ? "重验收"
-          : "修复",
-  };
-}
-
-function layersFor(gate: TaskGate): readonly GateLayer[] {
-  if (gate === "check") {
-    return [layerFor("quality:light")];
-  }
-  if (gate === "check:heavy") {
-    return [layerFor("quality:heavy")];
-  }
-  if (gate === "fix") {
-    return [layerFor("work:repair")];
-  }
-
-  return [layerFor("quality:light"), layerFor("quality:heavy")];
-}
-
-export async function runTaskGate(
-  gate: TaskGate,
-  cwd = process.cwd(),
-  entryCommand = "node --conditions=source scripts/task-gates.ts",
-): Promise<number> {
-  if (!publicGateNames.has(gate)) {
-    report(`未知公共任务入口：${String(gate)}`);
-    return 1;
-  }
-
-  const directory = readTaskDirectory(cwd, entryCommand);
-  if (directory.diagnostics.length > 0) {
-    report(directory.diagnostics.join("\n"));
-    return 1;
-  }
-  const tasksByName = new Map(
-    directory.tasks.map((task) => [task.fullName, task]),
-  );
-  const layers = layersFor(gate);
-  const plans: {
-    readonly layer: GateLayer;
-    readonly tasks: readonly TurboTask[];
-  }[] = [];
-  const diagnostics: string[] = [];
-
-  for (const task of directory.tasks) {
-    if (task.executable || task.role === undefined) {
-      continue;
-    }
-    const dryRun = parseDryRun(cwd, [task]);
-    diagnostics.push(...dryRun.diagnostics);
-    if (
-      dryRun.diagnostics.length === 0 &&
-      !dryRun.taskIds.some(
-        (taskId) => tasksByName.get(taskId)?.executable === true,
-      )
-    ) {
-      diagnostics.push(
-        `${task.fullName} 声明悬空职责标签 ${task.role}：无命令节点的原生执行图没有可执行工作`,
-      );
-    }
-  }
-
-  for (const layer of layers) {
-    const selected = directory.tasks.filter(
-      (task) => task.role === layer.role && !publicGateTask(task),
-    );
-    const dryRun = parseDryRun(cwd, selected);
-    diagnostics.push(...dryRun.diagnostics);
-    diagnostics.push(
-      ...validateLayerClosure(layer, dryRun.taskIds, tasksByName),
-    );
-    if (
-      layer.role === "quality:light" &&
-      !dryRun.taskIds.some(
-        (taskId) => tasksByName.get(taskId)?.executable === true,
-      )
-    ) {
-      diagnostics.push(
-        "轻检查没有选中有效任务；请为实际验收任务声明 quality:light",
-      );
-    }
-    plans.push({ layer, tasks: selected });
-  }
-
-  if (diagnostics.length > 0) {
-    report(diagnostics.join("\n"));
-    return 1;
-  }
-
-  const conditionalTasks = directory.tasks.filter(
-    (task) => task.role === "quality:conditional",
-  );
-  if (gate !== "fix" && conditionalTasks.length > 0) {
-    report(
-      `条件验收未执行：${conditionalTasks.map((task) => task.fullName).join("、")}`,
-    );
-  }
-
-  for (const plan of plans) {
-    if (plan.tasks.length === 0) {
-      report(`${plan.layer.label}没有选中任务，跳过执行`);
-      continue;
-    }
-    const status = await runVisible(cwd, [
-      "run",
-      ...plan.tasks.map((task) => task.fullName),
-      "--continue=dependencies-successful",
-      gate === "fix" ? "--output-logs=full" : "--output-logs=errors-only",
-      "--log-order=grouped",
-      "--log-prefix=task",
-    ]);
-    if (status !== 0) {
-      return status;
-    }
-  }
-
-  return 0;
-}
-
-const mainFile = process.argv[1];
-if (
-  mainFile !== undefined &&
-  pathToFileURL(resolve(mainFile)).href === import.meta.url
-) {
-  const gate = process.argv[2];
-  if (
-    gate !== "check" &&
-    gate !== "check:heavy" &&
-    gate !== "check:full" &&
-    gate !== "fix"
-  ) {
-    report(
-      "用法：node scripts/task-gates.ts <check|check:heavy|check:full|fix>",
-    );
-    process.exitCode = 2;
-  } else {
-    void runTaskGate(gate)
-      .then((status) => {
-        process.exitCode = status;
-      })
-      .catch((error: unknown) => {
-        report(
-          `公共任务入口失败：${error instanceof Error ? error.message : String(error)}`,
-        );
-        process.exitCode = 1;
-      });
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/tsconfig.packing-hook.json

@@ -1,7 +0,0 @@
-{
-  "compilerOptions": {
-    "allowJs": true,
-    "checkJs": true
-  },
-  "files": [".pnpmfile.mjs"]
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-boundary-tags/app.json

@@ -1,7 +0,0 @@
-{
-  "boundaries": {
-    "tags": {
-      "app": { "dependencies": { "allow": ["app", "library"] } }
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-boundary-tags/library.json

@@ -1,7 +0,0 @@
-{
-  "boundaries": {
-    "tags": {
-      "library": { "dependencies": { "allow": ["library"] } }
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-projections/database-preparation.json

@@ -1,17 +0,0 @@
-{
-  "tasks": {
-    "//#dev": { "tags": ["work:development"] },
-    "//#database:prepare:dev": {
-      "cache": false,
-      "tags": ["work:preparation"]
-    },
-    "//#database:prepare:test": {
-      "cache": false,
-      "tags": ["work:preparation"]
-    },
-    "//#database:prepare:e2e": {
-      "cache": false,
-      "tags": ["work:preparation"]
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-projections/deployment.json

@@ -1,13 +0,0 @@
-{
-  "tasks": {
-    "//#deployment": {
-      "dependsOn": [
-        "{{APPLICATION_PACKAGE}}#build",
-        "{{DATABASE_PACKAGE}}#build",
-        "{{MIGRATION_PACKAGE}}#build"
-      ],
-      "cache": false,
-      "tags": ["quality:heavy"]
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-projections/rust-toolchain.json

@@ -1,5 +0,0 @@
-{
-  "tasks": {
-    "//#toolchain:prepare": { "cache": false, "tags": ["work:preparation"] }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo-projections/vue-hono-joint-e2e.json

@@ -1,13 +0,0 @@
-{
-  "tasks": {
-    "//#test:e2e": {
-      "dependsOn": [
-        "{{API_PACKAGE}}#build",
-        "{{WEB_PACKAGE}}#build",
-        "{{WEB_PACKAGE}}#browser:prepare"
-      ],
-      "cache": false,
-      "tags": ["quality:heavy"]
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/turbo.json

@@ -1,20 +0,0 @@
-{
-  "boundaries": { "tags": {} },
-  "globalPassThroughEnv": ["CARGO_HOME", "RUSTUP_HOME", "RUSTUP_TOOLCHAIN"],
-  "tasks": {
-    "//#check": { "tags": ["quality:entry"] },
-    "//#check:heavy": { "tags": ["quality:entry"] },
-    "//#check:full": { "tags": ["quality:entry"] },
-    "//#boundaries": { "tags": ["quality:light"] },
-    "//#fix": { "tags": ["work:repair"] },
-    "//#format:check": { "outputs": [], "tags": ["quality:light"] },
-    "//#lint": { "outputs": [], "tags": ["quality:light"] },
-    "//#format:write": {
-      "dependsOn": ["//#lint:fix"],
-      "cache": false,
-      "tags": ["work:repair"]
-    },
-    "//#lint:fix": { "cache": false, "tags": ["work:repair"] },
-    "//#typecheck": { "outputs": [], "tags": ["quality:light"] }
-  }
-}