rainskills 0.1.19 → 0.1.21

package/rainbond-platform-installer/scripts/environment-registry.js

@@ -1,349 +0,0 @@
-"use strict";
-
-const crypto = require("node:crypto");
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-
-const { normalizeConsoleOrigin } = require("./console-origin.js");
-const { createSecureStateStore } = require("./secure-state.js");
-
-const REGISTRY_SCHEMA = "rainskills.environments.v1";
-const REGISTRY_LOCK_ID = "68e80ada-7946-44ca-b438-59eef580a238";
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const CONTROL_PATTERN = /[\u0000-\u001f\u007f-\u009f]/u;
-const ENVIRONMENT_KINDS = new Set(["saas", "private"]);
-const CONNECTION_STATES = new Set(["connected", "needs-reconnect", "unavailable"]);
-const ROOT_FIELDS = new Set([
-  "schema", "version", "default_environment_id", "environments",
-]);
-const ENVIRONMENT_FIELDS = new Set([
-  "id", "name", "console_origin", "kind", "connection_state",
-  "created_at", "updated_at", "last_verified_at",
-]);
-const MAX_ENVIRONMENTS = 128;
-const MAX_NAME_LENGTH = 80;
-
-function isIsoTimestamp(value) {
-  return typeof value === "string"
-    && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value)
-    && !Number.isNaN(Date.parse(value));
-}
-
-function normalizeEnvironmentName(value) {
-  if (typeof value !== "string") throw new Error("环境名称无效");
-  const normalized = value.normalize("NFKC").trim().replace(/\s+/gu, " ");
-  if (!normalized || normalized.length > MAX_NAME_LENGTH || CONTROL_PATTERN.test(normalized)) {
-    throw new Error(`环境名称必须是长度不超过 ${MAX_NAME_LENGTH} 的安全文本`);
-  }
-  return normalized;
-}
-
-function nameKey(value) {
-  return normalizeEnvironmentName(value).toLocaleLowerCase("zh-CN");
-}
-
-function clone(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-
-function createEnvironmentRegistry({
-  platform = process.platform,
-  home = os.homedir(),
-  stateStore = createSecureStateStore({ platform, home }),
-  randomUUID = crypto.randomUUID,
-  now = () => new Date().toISOString(),
-  activeOperationIds = () => [],
-} = {}) {
-  const registryPath = path.join(home, ".rainbond", "rainskills", "environments-v1.json");
-
-  function emptyRegistry() {
-    return {
-      schema: REGISTRY_SCHEMA,
-      version: 1,
-      default_environment_id: null,
-      environments: [],
-    };
-  }
-
-  function validateEnvironment(input) {
-    if (!input || typeof input !== "object" || Array.isArray(input)) {
-      throw new Error("环境记录无效");
-    }
-    for (const field of Object.keys(input)) {
-      if (!ENVIRONMENT_FIELDS.has(field)) throw new Error(`环境记录包含未知字段：${field}`);
-    }
-    if (Object.keys(input).length !== ENVIRONMENT_FIELDS.size) {
-      throw new Error("环境记录字段不完整");
-    }
-    if (!UUID_PATTERN.test(input.id || "")) throw new Error("环境 ID 无效");
-    if (!ENVIRONMENT_KINDS.has(input.kind)) throw new Error("环境类型无效");
-    if (!CONNECTION_STATES.has(input.connection_state)) throw new Error("环境连接状态无效");
-    if (!isIsoTimestamp(input.created_at) || !isIsoTimestamp(input.updated_at)) {
-      throw new Error("环境时间戳无效");
-    }
-    if (input.last_verified_at !== null && !isIsoTimestamp(input.last_verified_at)) {
-      throw new Error("环境验证时间无效");
-    }
-    return {
-      id: input.id,
-      name: normalizeEnvironmentName(input.name),
-      console_origin: normalizeConsoleOrigin(input.console_origin),
-      kind: input.kind,
-      connection_state: input.connection_state,
-      created_at: input.created_at,
-      updated_at: input.updated_at,
-      last_verified_at: input.last_verified_at,
-    };
-  }
-
-  function validateRegistry(input) {
-    if (!input || typeof input !== "object" || Array.isArray(input)) {
-      throw new Error("环境注册表无效");
-    }
-    for (const field of Object.keys(input)) {
-      if (!ROOT_FIELDS.has(field)) throw new Error(`环境注册表包含未知字段：${field}`);
-    }
-    if (
-      Object.keys(input).length !== ROOT_FIELDS.size
-      || input.schema !== REGISTRY_SCHEMA
-      || input.version !== 1
-      || !Array.isArray(input.environments)
-      || input.environments.length > MAX_ENVIRONMENTS
-    ) {
-      throw new Error("环境注册表 schema 无效");
-    }
-    const environments = input.environments.map(validateEnvironment);
-    const ids = new Set();
-    const origins = new Set();
-    const names = new Set();
-    for (const environment of environments) {
-      if (ids.has(environment.id)) throw new Error("环境注册表包含重复 ID");
-      if (origins.has(environment.console_origin)) throw new Error("环境注册表包含重复 origin");
-      const normalizedName = nameKey(environment.name);
-      if (names.has(normalizedName)) throw new Error("环境注册表包含重复名称");
-      ids.add(environment.id);
-      origins.add(environment.console_origin);
-      names.add(normalizedName);
-    }
-    if (
-      input.default_environment_id !== null
-      && (!UUID_PATTERN.test(input.default_environment_id) || !ids.has(input.default_environment_id))
-    ) {
-      throw new Error("默认环境 ID 无效");
-    }
-    if (environments.length > 0 && input.default_environment_id === null) {
-      throw new Error("非空环境注册表必须指定默认环境");
-    }
-    return {
-      schema: REGISTRY_SCHEMA,
-      version: 1,
-      default_environment_id: input.default_environment_id,
-      environments,
-    };
-  }
-
-  function read() {
-    if (!fs.existsSync(registryPath)) return emptyRegistry();
-    return clone(validateRegistry(stateStore.readProtectedJson(registryPath)));
-  }
-
-  function writeUnlocked(value) {
-    const validated = validateRegistry(value);
-    stateStore.atomicWriteJson(registryPath, validated);
-    return clone(validated);
-  }
-
-  function withLock(action) {
-    let lock;
-    try {
-      lock = stateStore.acquireOperationLock({ operationId: REGISTRY_LOCK_ID });
-    } catch {
-      throw new Error("环境注册表正在由另一个进程更新");
-    }
-    try {
-      return action();
-    } finally {
-      lock.release();
-    }
-  }
-
-  function nextAutomaticName(kind, origin, environments) {
-    const hostname = new URL(origin).hostname.replace(/^\[|\]$/g, "");
-    const base = kind === "saas" ? "Rainbond Cloud" : `私有环境-${hostname}`;
-    const used = new Set(environments.map((entry) => nameKey(entry.name)));
-    if (!used.has(nameKey(base))) return base;
-    for (let suffix = 2; suffix <= MAX_ENVIRONMENTS + 1; suffix += 1) {
-      const candidate = `${base}-${suffix}`;
-      if (!used.has(nameKey(candidate))) return candidate;
-    }
-    throw new Error("无法生成不重复的环境名称");
-  }
-
-  function add({ kind, consoleOrigin, connectionState, name } = {}) {
-    if (!ENVIRONMENT_KINDS.has(kind)) throw new Error("环境类型无效");
-    if (!CONNECTION_STATES.has(connectionState)) throw new Error("环境连接状态无效");
-    const origin = normalizeConsoleOrigin(consoleOrigin);
-    return withLock(() => {
-      const current = read();
-      const existing = current.environments.find((entry) => entry.console_origin === origin);
-      if (existing) {
-        if (existing.kind !== kind) throw new Error("相同 Console origin 的环境类型不匹配");
-        return { created: false, environment: clone(existing) };
-      }
-      if (current.environments.length >= MAX_ENVIRONMENTS) throw new Error("环境数量已达到上限");
-      const environmentName = name === undefined
-        ? nextAutomaticName(kind, origin, current.environments)
-        : normalizeEnvironmentName(name);
-      if (current.environments.some((entry) => nameKey(entry.name) === nameKey(environmentName))) {
-        throw new Error("环境名称已存在");
-      }
-      const id = randomUUID();
-      if (!UUID_PATTERN.test(id || "")) throw new Error("生成的环境 ID 无效");
-      const timestamp = now();
-      const environment = validateEnvironment({
-        id,
-        name: environmentName,
-        console_origin: origin,
-        kind,
-        connection_state: connectionState,
-        created_at: timestamp,
-        updated_at: timestamp,
-        last_verified_at: connectionState === "connected" ? timestamp : null,
-      });
-      const next = writeUnlocked({
-        ...current,
-        default_environment_id: current.default_environment_id || environment.id,
-        environments: [...current.environments, environment],
-      });
-      return {
-        created: true,
-        environment: clone(next.environments.find((entry) => entry.id === environment.id)),
-      };
-    });
-  }
-
-  function rename(environmentId, name) {
-    if (!UUID_PATTERN.test(environmentId || "")) throw new Error("环境 ID 无效");
-    const normalized = normalizeEnvironmentName(name);
-    return withLock(() => {
-      const current = read();
-      const existing = current.environments.find((entry) => entry.id === environmentId);
-      if (!existing) throw new Error("环境不存在");
-      if (current.environments.some(
-        (entry) => entry.id !== environmentId && nameKey(entry.name) === nameKey(normalized)
-      )) {
-        throw new Error("环境名称已存在");
-      }
-      const timestamp = now();
-      const next = writeUnlocked({
-        ...current,
-        environments: current.environments.map((entry) => entry.id === environmentId
-          ? { ...entry, name: normalized, updated_at: timestamp }
-          : entry),
-      });
-      return clone(next.environments.find((entry) => entry.id === environmentId));
-    });
-  }
-
-  function setDefault(environmentId) {
-    if (!UUID_PATTERN.test(environmentId || "")) throw new Error("环境 ID 无效");
-    return withLock(() => {
-      const current = read();
-      if (!current.environments.some((entry) => entry.id === environmentId)) {
-        throw new Error("环境不存在");
-      }
-      writeUnlocked({ ...current, default_environment_id: environmentId });
-      return clone(current.environments.find((entry) => entry.id === environmentId));
-    });
-  }
-
-  function remove(environmentId) {
-    if (!UUID_PATTERN.test(environmentId || "")) throw new Error("环境 ID 无效");
-    return withLock(() => {
-      const current = read();
-      const existing = current.environments.find((entry) => entry.id === environmentId);
-      if (!existing) throw new Error("环境不存在");
-      if (current.default_environment_id === environmentId) {
-        throw new Error("删除默认环境前必须先指定新的默认环境");
-      }
-      const operations = activeOperationIds(environmentId);
-      if (!Array.isArray(operations)) throw new Error("活动操作检查结果无效");
-      if (operations.length > 0) throw new Error("该环境仍被活动操作使用，不能删除");
-      writeUnlocked({
-        ...current,
-        environments: current.environments.filter((entry) => entry.id !== environmentId),
-      });
-      return clone(existing);
-    });
-  }
-
-  function updateConnection(environmentId, connectionState) {
-    if (!UUID_PATTERN.test(environmentId || "")) throw new Error("环境 ID 无效");
-    if (!CONNECTION_STATES.has(connectionState)) throw new Error("环境连接状态无效");
-    return withLock(() => {
-      const current = read();
-      const existing = current.environments.find((entry) => entry.id === environmentId);
-      if (!existing) throw new Error("环境不存在");
-      const timestamp = now();
-      const next = writeUnlocked({
-        ...current,
-        environments: current.environments.map((entry) => entry.id === environmentId
-          ? {
-            ...entry,
-            connection_state: connectionState,
-            updated_at: timestamp,
-            last_verified_at: connectionState === "connected"
-              ? timestamp
-              : entry.last_verified_at,
-          }
-          : entry),
-      });
-      return clone(next.environments.find((entry) => entry.id === environmentId));
-    });
-  }
-
-  function list() {
-    return read().environments;
-  }
-
-  function get(environmentId) {
-    const environment = read().environments.find((entry) => entry.id === environmentId);
-    return environment ? clone(environment) : null;
-  }
-
-  function findByName(name) {
-    const key = nameKey(name);
-    const environment = read().environments.find((entry) => nameKey(entry.name) === key);
-    return environment ? clone(environment) : null;
-  }
-
-  function findByOrigin(origin) {
-    const normalized = normalizeConsoleOrigin(origin);
-    const environment = read().environments.find((entry) => entry.console_origin === normalized);
-    return environment ? clone(environment) : null;
-  }
-
-  return {
-    add,
-    findByName,
-    findByOrigin,
-    get,
-    list,
-    path: registryPath,
-    read,
-    remove,
-    rename,
-    setDefault,
-    updateConnection,
-  };
-}
-
-module.exports = {
-  CONNECTION_STATES,
-  ENVIRONMENT_KINDS,
-  REGISTRY_LOCK_ID,
-  REGISTRY_SCHEMA,
-  createEnvironmentRegistry,
-  normalizeEnvironmentName,
-};

package/rainbond-platform-installer/scripts/local-runtime-commands.js

@@ -1,180 +0,0 @@
-"use strict";
-
-const { createEnvironmentCredentialStore } = require("./environment-credentials.js");
-const { createEnvironmentRegistry } = require("./environment-registry.js");
-const { createRuntimeOperationStore } = require("./runtime-operations.js");
-const { renderCatalogUserMessage } = require("./user-message.js");
-
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-
-function requireFixedValue(args, index, flag) {
-  const value = args[index + 1];
-  if (!value || value.startsWith("--")) throw new Error(`${flag} 缺少参数值`);
-  return value;
-}
-
-function createLocalRuntimeServices() {
-  let operations;
-  const registry = createEnvironmentRegistry({
-    activeOperationIds: (environmentId) => operations?.activeOperationIds(environmentId) || [],
-  });
-  operations = createRuntimeOperationStore({ registry });
-  return {
-    environmentCredentialStore: createEnvironmentCredentialStore(),
-    environmentRegistry: registry,
-    operationStore: operations,
-  };
-}
-
-function parseEnvironmentMutationArgs(args) {
-  const action = args[1];
-  if (!new Set(["rename", "set-default", "remove"]).has(action)) {
-    throw new Error("environment action 无效");
-  }
-  if (args[2] !== "--environment-id" || !UUID_PATTERN.test(args[3] || "")) {
-    throw new Error("环境 ID 无效");
-  }
-  if (action === "rename") {
-    if (args.length !== 6 || args[4] !== "--name" || !args[5] || args[5].startsWith("--")) {
-      throw new Error("environment rename 参数无效");
-    }
-    return { action, environmentId: args[3], name: args[5] };
-  }
-  if (args.length !== 4) throw new Error(`environment ${action} 参数无效`);
-  return { action, environmentId: args[3] };
-}
-
-function parseOperationBeginArgs(args) {
-  if (args[0] !== "operation" || args[1] !== "begin") {
-    throw new Error("operation begin 参数无效");
-  }
-  let operationId = "";
-  let environmentId = "";
-  let intentInput = "";
-  for (let index = 2; index < args.length; index += 1) {
-    const argument = args[index];
-    if (argument === "--operation-id") {
-      operationId = requireFixedValue(args, index, argument);
-      index += 1;
-    } else if (argument === "--environment-id") {
-      environmentId = requireFixedValue(args, index, argument);
-      index += 1;
-    } else if (argument === "--intent-json") {
-      intentInput = requireFixedValue(args, index, argument);
-      index += 1;
-    } else {
-      throw new Error("operation begin 包含未知参数");
-    }
-  }
-  if (!UUID_PATTERN.test(operationId)) throw new Error("operation ID 无效");
-  if (environmentId && !UUID_PATTERN.test(environmentId)) throw new Error("环境 ID 无效");
-  if (!intentInput || intentInput.length > 16384) throw new Error("operation begin 缺少 intent JSON");
-  let intent;
-  try {
-    intent = JSON.parse(intentInput);
-  } catch {
-    throw new Error("operation begin intent JSON 无效");
-  }
-  return { operationId, environmentId: environmentId || undefined, intent };
-}
-
-function runLocalRuntimeCommand(args, {
-  environmentCredentialStore,
-  environmentRegistry,
-  operationStore,
-  write = (value) => process.stdout.write(value),
-  controlPlatform = process.platform,
-} = {}) {
-  let services;
-  const getServices = () => {
-    services ||= createLocalRuntimeServices();
-    return services;
-  };
-  const registry = () => environmentRegistry || getServices().environmentRegistry;
-  const operations = () => operationStore || getServices().operationStore;
-  const credentials = () => environmentCredentialStore
-    || getServices().environmentCredentialStore;
-
-  if (args[0] === "environment" && args[1] === "list") {
-    if (args.length !== 3 || args[2] !== "--json") {
-      throw new Error("environment list 只支持固定参数 --json");
-    }
-    const current = registry().read();
-    write(`${JSON.stringify({
-      schema: "rainskills.environment-list.v1",
-      default_environment_id: current.default_environment_id,
-      environments: current.environments,
-    })}\n`);
-    return true;
-  }
-
-  if (args[0] === "environment" && ["rename", "set-default", "remove"].includes(args[1])) {
-    const input = parseEnvironmentMutationArgs(args);
-    let environment;
-    let action;
-    if (input.action === "rename") {
-      environment = registry().rename(input.environmentId, input.name);
-      action = "renamed";
-    } else if (input.action === "set-default") {
-      environment = registry().setDefault(input.environmentId);
-      action = "default-changed";
-    } else {
-      environment = registry().remove(input.environmentId);
-      credentials().remove(input.environmentId);
-      action = "removed";
-    }
-    write(`${JSON.stringify({
-      schema: "rainskills.environment-result.v1",
-      action,
-      environment,
-    })}\n`);
-    return true;
-  }
-
-  if (args[0] === "operation" && args[1] === "begin") {
-    const operation = operations().begin(parseOperationBeginArgs(args));
-    write(`${JSON.stringify({
-      schema: "rainskills.operation-begin-result.v1",
-      operation_id: operation.operation_id,
-      environment_id: operation.environment_id,
-      intent: operation.intent,
-      stage: operation.stage,
-    })}\n`);
-    return true;
-  }
-
-  if (args[0] === "operation" && args[1] === "complete") {
-    if (
-      args.length !== 4
-      || args[2] !== "--operation-id"
-      || !UUID_PATTERN.test(args[3] || "")
-    ) {
-      throw new Error("operation complete 参数无效");
-    }
-    const operation = operations().complete(args[3]);
-    write(`${JSON.stringify({
-      schema: "rainskills.operation-complete-result.v1",
-      operation_id: operation.operation_id,
-      environment_id: operation.environment_id,
-      stage: operation.stage,
-    })}\n`);
-    return true;
-  }
-
-  if (args[0] === "runtime" && args[1] === "message") {
-    if (args.length !== 4 || args[2] !== "--id") {
-      throw new Error("runtime message 只支持固定参数 --id");
-    }
-    write(renderCatalogUserMessage(args[3], { controlPlatform }));
-    return true;
-  }
-
-  return false;
-}
-
-module.exports = {
-  createLocalRuntimeServices,
-  parseEnvironmentMutationArgs,
-  parseOperationBeginArgs,
-  runLocalRuntimeCommand,
-};

package/rainbond-platform-installer/scripts/local-runtime.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-const path = require("node:path");
-const { spawn } = require("node:child_process");
-const { runLocalRuntimeCommand } = require("./local-runtime-commands.js");
-const { backgroundUpdateEnvironment } = require("./auto-update-worker.js");
-
-function shouldScheduleUpdate(args, env = process.env) {
-  if (env.RAINSKILLS_DISABLE_AUTO_UPDATE === "1") return false;
-  return (
-    args[0] === "environment"
-    && args[1] === "list"
-    && args[2] === "--json"
-  ) || (
-    args[0] === "operation"
-    && args[1] === "complete"
-  );
-}
-
-function spawnBackgroundUpdate({
-  spawnFn = spawn,
-  env = process.env,
-  execPath = process.execPath,
-} = {}) {
-  try {
-    const child = spawnFn(execPath, [path.join(__dirname, "auto-update-worker.js")], {
-      detached: true,
-      env: backgroundUpdateEnvironment(env),
-      shell: false,
-      stdio: "ignore",
-      windowsHide: true,
-    });
-    child.unref();
-  } catch {
-    // Automatic updates are best-effort and never affect the local command.
-  }
-}
-
-async function main({
-  args = process.argv.slice(2),
-  runCommand = runLocalRuntimeCommand,
-  scheduleUpdate = spawnBackgroundUpdate,
-  env = process.env,
-} = {}) {
-  const handled = runCommand(args);
-  if (!handled) throw new Error("不支持的本地运行环境命令");
-  if (shouldScheduleUpdate(args, env)) scheduleUpdate({ env });
-}
-
-if (require.main === module) {
-  main().catch((error) => {
-    console.error(`错误：${error.message}`);
-    process.exitCode = 1;
-  });
-}
-
-module.exports = { main, shouldScheduleUpdate, spawnBackgroundUpdate };