@dyyz1993/create-agent 2.0.0 → 2.1.0

package/templates/general/eslint-plugin-rpc/index.js

@@ -1,50 +0,0 @@
-/**
- * eslint-plugin-rpc — RPC 模块化规范 ESLint 插件（单注册架构）
- *
- * 规则列表：
- *   - rpc/no-bare-method          : 方法名必须使用 module.action 格式
- *   - rpc/no-direct-register      : server.register() 只允许在 handlers/ 目录内使用
- *   - rpc/schema-merge-only       : rpc-schema.ts 禁止直接定义方法
- *   - rpc/module-file-naming      : 模块文件命名、导出、方法前缀强制规范
- *   - rpc/require-typed-register  : 入口文件必须导入 registerAllHandlers
- *   - rpc/require-api-client      : 前端必须通过 apiClient 调用 RPC
- */
-"use strict";
-
-const noBareMethod = require("./rules/no-bare-method");
-const noDirectRegister = require("./rules/no-direct-register");
-const schemaMergeOnly = require("./rules/schema-merge-only");
-const moduleFileNaming = require("./rules/module-file-naming");
-const requireTypedRegister = require("./rules/require-typed-register");
-const requireApiClient = require("./rules/require-api-client");
-const noHardcodedStrings = require("./rules/no-hardcoded-strings");
-
-module.exports = {
-  meta: {
-    name: "eslint-plugin-rpc",
-    version: "1.0.0",
-  },
-  rules: {
-    "no-bare-method": noBareMethod,
-    "no-direct-register": noDirectRegister,
-    "schema-merge-only": schemaMergeOnly,
-    "module-file-naming": moduleFileNaming,
-    "require-typed-register": requireTypedRegister,
-    "require-api-client": requireApiClient,
-    "no-hardcoded-strings": noHardcodedStrings,
-  },
-  configs: {
-    recommended: {
-      plugins: ["rpc"],
-      rules: {
-        "rpc/no-bare-method": "error",
-        "rpc/no-direct-register": "error",
-        "rpc/schema-merge-only": "error",
-        "rpc/module-file-naming": "error",
-        "rpc/require-typed-register": "error",
-        "rpc/require-api-client": "error",
-        "rpc/no-hardcoded-strings": "warn",
-      },
-    },
-  },
-};

package/templates/general/eslint-plugin-rpc/package.json

@@ -1,6 +0,0 @@
-{
-  "name": "@dyyz1993/eslint-plugin-rpc",
-  "version": "1.0.0",
-  "private": true,
-  "main": "index.js"
-}

package/templates/general/eslint-plugin-rpc/rules/module-file-naming.js

@@ -1,99 +0,0 @@
-/**
- * @fileoverview 强制 RPC 模块文件的命名和导出规范
- */
-"use strict";
-
-function getModuleName(filename) {
-  const match = filename.match(/\/modules\/([^/]+)\.[jt]sx?$/);
-  return match ? match[1] : null;
-}
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "RPC 模块文件必须遵循命名和导出规范",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      missingMethodsExport:
-        '模块文件 "{{file}}" 必须导出 "{{ModuleName}}Methods" 接口。',
-      methodPrefixMismatch:
-        '方法 "{{method}}" 的前缀不匹配模块 "{{module}}"。必须以 "{{module}}." 开头。',
-      eventPrefixMismatch:
-        '事件 "{{event}}" 的前缀不匹配模块 "{{module}}"。必须以 "{{module}}." 开头。',
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-    const moduleName = getModuleName(filename);
-    if (!moduleName) return {};
-
-    const moduleNamePascal = moduleName
-      .split(/[-_]/)
-      .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
-      .join("");
-
-    let hasMethodsExport = false;
-
-    return {
-      TSInterfaceDeclaration(node) {
-        const name = node.id.name;
-
-        if (name === `${moduleNamePascal}Methods`) {
-          hasMethodsExport = true;
-
-          if (node.body && node.body.body) {
-            for (const member of node.body.body) {
-              if (member.type === "TSPropertySignature" && member.key) {
-                const key =
-                  member.key.type === "Literal" ? String(member.key.value) : null;
-                if (key && !key.startsWith(`${moduleName}.`)) {
-                  context.report({
-                    node: member,
-                    messageId: "methodPrefixMismatch",
-                    data: { method: key, module: moduleName },
-                  });
-                }
-              }
-            }
-          }
-        }
-
-        if (name === `${moduleNamePascal}Events`) {
-          if (node.body && node.body.body) {
-            for (const member of node.body.body) {
-              if (member.type === "TSPropertySignature" && member.key) {
-                const key =
-                  member.key.type === "Literal" ? String(member.key.value) : null;
-                if (key && !key.startsWith(`${moduleName}.`)) {
-                  context.report({
-                    node: member,
-                    messageId: "eventPrefixMismatch",
-                    data: { event: key, module: moduleName },
-                  });
-                }
-              }
-            }
-          }
-        }
-      },
-
-      "Program:exit"() {
-        if (!hasMethodsExport) {
-          context.report({
-            loc: { line: 1, column: 0 },
-            messageId: "missingMethodsExport",
-            data: {
-              file: filename.split("/").pop(),
-              ModuleName: moduleNamePascal,
-            },
-          });
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/no-bare-method.js

@@ -1,78 +0,0 @@
-/**
- * @fileoverview 禁止使用裸方法名（无模块前缀）
- */
-"use strict";
-
-const METHOD_CALL_PATTERNS = [
-  { calleePattern: /^register$/, argIndex: 0 },
-  { calleePattern: /\.call$/, argIndex: 0 },
-  { calleePattern: /\.subscribe$/, argIndex: 0 },
-  { calleePattern: /\.emitEvent$/, argIndex: 0 },
-];
-
-function isModuleMethodName(name) {
-  const parts = name.split(".");
-  return parts.length === 2 && parts[0].length > 0 && parts[1].length > 0;
-}
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "RPC 方法名必须使用 module.action 格式（禁止裸方法名）",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      bareMethod:
-        'RPC 方法名 "{{name}}" 缺少模块前缀。必须使用 "module.action" 格式，如 "{{suggestion}}"。',
-      invalidFormat:
-        'RPC 方法名 "{{name}}" 格式错误。必须使用 "module.action" 格式（单一 "." 分隔）。',
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/\.[jt]sx?$/.test(filename)) return {};
-
-    return {
-      CallExpression(node) {
-        const { callee, arguments: args } = node;
-
-        let calleeText = "";
-        if (callee.type === "Identifier") {
-          calleeText = callee.name;
-        } else if (callee.type === "MemberExpression" && callee.property.type === "Identifier") {
-          calleeText = `.${callee.property.name}`;
-        }
-
-        for (const pattern of METHOD_CALL_PATTERNS) {
-          if (!pattern.calleePattern.test(calleeText)) continue;
-          if (args.length <= pattern.argIndex) continue;
-
-          const arg = args[pattern.argIndex];
-          if (arg.type !== "Literal" || typeof arg.value !== "string") continue;
-
-          const methodName = arg.value;
-
-          if (!methodName.includes(".")) {
-            const suggestion = `module.${methodName}`;
-            context.report({
-              node: arg,
-              messageId: "bareMethod",
-              data: { name: methodName, suggestion },
-            });
-          } else if (!isModuleMethodName(methodName)) {
-            context.report({
-              node: arg,
-              messageId: "invalidFormat",
-              data: { name: methodName },
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/no-direct-register.js

@@ -1,65 +0,0 @@
-/**
- * @fileoverview server.register() 只允许在 shared/handlers/ 目录内使用
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description:
-        "server.register() 只允许在 shared/handlers/ 目录内使用，入口文件和其他文件禁止直接调用",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      noDirectRegisterInEntry:
-        "入口文件禁止直接调用 server.register()。请导入并使用 registerAllHandlers() 统一注册 handler。",
-      noDirectRegisterGeneral:
-        "禁止直接调用 server.register()。Handler 注册只能在 shared/handlers/ 目录内的文件中进行。",
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/src\/.*\.[jt]sx?$/.test(filename)) return {};
-
-    if (filename.includes("shared/handlers/")) return {};
-
-    const isEntryPoint =
-      filename.endsWith("bun/index.ts") || filename.endsWith("server.ts");
-
-    return {
-      CallExpression(node) {
-        const { callee } = node;
-
-        if (
-          callee.type === "MemberExpression" &&
-          callee.property.type === "Identifier" &&
-          callee.property.name === "register" &&
-          callee.object.type === "Identifier"
-        ) {
-          const objectName = callee.object.name;
-
-          const serverVarNames = [
-            "server",
-            "rpcServer",
-            "rpc",
-            "rpc_server",
-          ];
-
-          if (serverVarNames.includes(objectName)) {
-            context.report({
-              node,
-              messageId: isEntryPoint
-                ? "noDirectRegisterInEntry"
-                : "noDirectRegisterGeneral",
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/no-hardcoded-strings.js

@@ -1,69 +0,0 @@
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "suggestion",
-    docs: {
-      description: "disallow hardcoded strings in JSX (use i18n t() instead)",
-      category: "Best Practices",
-      recommended: false,
-    },
-    fixable: null,
-    schema: [
-      {
-        type: "object",
-        properties: {
-          ignoreAttributes: {
-            type: "array",
-            items: { type: "string" },
-          },
-          ignoreComponents: {
-            type: "array",
-            items: { type: "string" },
-          },
-        },
-        additionalProperties: false,
-      },
-    ],
-    messages: {
-      hardcodedString:
-        'Hardcoded string "{{text}}" should use i18n translation (t()).',
-    },
-  },
-
-  create(context) {
-    const options = context.options[0] || {};
-    const ignoreAttributes = new Set(options.ignoreAttributes || ["className", "style", "id", "key", "ref", "type", "name", "data-testid", "viewBox", "d", "points", "x1", "x2", "y1", "y2", "strokeWidth", "strokeLinecap", "strokeLinejoin", "fill", "stroke", "xmlns"]);
-    new Set(options.ignoreComponents || []);
-
-    return {
-      JSXText(node) {
-        const text = node.value.trim();
-        if (text.length > 1 && /[a-zA-Z]{2,}/.test(text)) {
-          context.report({
-            node,
-            messageId: "hardcodedString",
-            data: { text },
-          });
-        }
-      },
-      JSXAttribute(node) {
-        if (ignoreAttributes.has(node.name.name)) return;
-        if (
-          node.value &&
-          node.value.type === "Literal" &&
-          typeof node.value.value === "string"
-        ) {
-          const text = node.value.value.trim();
-          if (text.length > 3 && /[a-zA-Z]{3,}/.test(text) && !text.startsWith("var(") && !text.startsWith("bg-") && !text.startsWith("text-") && !text.startsWith("border-")) {
-            context.report({
-              node,
-              messageId: "hardcodedString",
-              data: { text },
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/require-api-client.js

@@ -1,58 +0,0 @@
-/**
- * @fileoverview 强制前端使用 apiClient 进行 RPC 调用
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "前端 RPC 调用必须通过 apiClient",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      useApiClient:
-        "前端 RPC 调用必须通过 apiClient.call() / apiClient.subscribe()。禁止直接操作 WebSocket 或其他传输层。",
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/mainview\/.*\.[jt]sx?$/.test(filename)) return {};
-
-    return {
-      NewExpression(node) {
-        if (
-          node.callee.type === "Identifier" &&
-          node.callee.name === "WebSocket"
-        ) {
-          context.report({
-            node,
-            messageId: "useApiClient",
-          });
-        }
-      },
-
-      CallExpression(node) {
-        if (
-          node.callee.type === "MemberExpression" &&
-          node.callee.property.type === "Identifier" &&
-          node.callee.property.name === "send"
-        ) {
-          if (node.callee.object.type === "Identifier") {
-            const objName = node.callee.object.name.toLowerCase();
-            if (objName.includes("websocket") || objName.includes("ws")) {
-              context.report({
-                node,
-                messageId: "useApiClient",
-              });
-            }
-          }
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/require-typed-register.js

@@ -1,78 +0,0 @@
-/**
- * @fileoverview 入口文件必须导入 registerAllHandlers
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "入口文件必须导入并调用 registerAllHandlers",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      missingRegisterAllHandlersImport:
-        '入口文件必须导入 registerAllHandlers。请添加：import { registerAllHandlers } from "./shared/handlers/register-all-handlers";',
-      missingRegisterAllHandlersCall:
-        "已导入 registerAllHandlers 但未调用。请在创建 server 后调用 registerAllHandlers(server)。",
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    const isEntryPoint =
-      filename.endsWith("bun/index.ts") || filename.endsWith("gateway/ws-handler.ts");
-
-    if (!isEntryPoint) return {};
-
-    let hasRegisterAllHandlersImport = false;
-    let hasRegisterAllHandlersCall = false;
-    let importNode = null;
-
-    return {
-      ImportDeclaration(node) {
-        if (
-          node.source.type === "Literal" &&
-          typeof node.source.value === "string" &&
-          node.source.value.includes("register-all-handlers")
-        ) {
-          for (const specifier of node.specifiers) {
-            if (
-              specifier.type === "ImportSpecifier" &&
-              specifier.imported.name === "registerAllHandlers"
-            ) {
-              hasRegisterAllHandlersImport = true;
-              importNode = node;
-            }
-          }
-        }
-      },
-
-      CallExpression(node) {
-        if (
-          node.callee.type === "Identifier" &&
-          node.callee.name === "registerAllHandlers"
-        ) {
-          hasRegisterAllHandlersCall = true;
-        }
-      },
-
-      "Program:exit"() {
-        if (!hasRegisterAllHandlersImport) {
-          context.report({
-            loc: { line: 1, column: 0 },
-            messageId: "missingRegisterAllHandlersImport",
-          });
-        } else if (!hasRegisterAllHandlersCall) {
-          context.report({
-            node: importNode,
-            messageId: "missingRegisterAllHandlersCall",
-          });
-        }
-      },
-    };
-  },
-};

package/templates/general/eslint-plugin-rpc/rules/schema-merge-only.js

@@ -1,55 +0,0 @@
-/**
- * @fileoverview rpc-schema.ts 只允许合并，禁止直接定义方法
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "rpc-schema.ts 禁止直接定义方法，只允许 extends 合并",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      noDirectDefinition:
-        'rpc-schema.ts 中禁止直接定义方法 "{{key}}"。请在 src/shared/modules/ 下对应模块文件中定义，然后在此处 extends 合并。',
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!filename.endsWith("rpc-schema.ts") && !filename.endsWith("rpc-schema.tsx")) return {};
-
-    const schemaInterfaces = new Set(["RPCMethods", "RPCEvents"]);
-
-    return {
-      TSInterfaceDeclaration(node) {
-        if (!schemaInterfaces.has(node.id.name)) return;
-
-        if (node.body && node.body.body) {
-          for (const member of node.body.body) {
-            if (member.type === "TSPropertySignature" && member.key) {
-              const keyName =
-                member.key.type === "Identifier"
-                  ? member.key.name
-                  : member.key.type === "Literal"
-                    ? String(member.key.value)
-                    : null;
-
-              if (keyName) {
-                context.report({
-                  node: member,
-                  messageId: "noDirectDefinition",
-                  data: { key: keyName },
-                });
-              }
-            }
-          }
-        }
-      },
-    };
-  },
-};