tha-cli 0.1.2 → 0.1.4

package/tha/eslint-rules/executor-no-import-api.js

@@ -0,0 +1,69 @@
+/**
+ * EXE-02：执行器/零件不许 import 网络层、状态层、路由
+ * 所有依赖必须通过 ctx 注入，不自己 import
+ */
+
+const DEFAULT_DIRS = {
+  domains: 'src/domains',
+  api: 'src/api',
+  stores: 'src/stores',
+  router: 'src/router'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isExecutorOrStepFile(filename, dirs) {
+  const domainsDir = dirs.domains.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  // 文件在 domains/<模块>/executors/ 或 domains/<模块>/steps/ 下
+  return new RegExp(`/${domainsDir}/[^/]+/(executors|steps)/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '执行器/零件不许 import 网络层、状态层、路由，依赖必须通过 ctx 注入',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isExecutorOrStepFile(filename, dirs)) return {}
+
+    const forbiddenPrefixes = [
+      importSpec(dirs, 'api'),
+      importSpec(dirs, 'stores'),
+      importSpec(dirs, 'router'),
+      '@/store'
+    ]
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        const matched = forbiddenPrefixes.find(
+          (prefix) => importPath === prefix || importPath.startsWith(`${prefix}/`)
+        )
+
+        if (matched) {
+          context.report({
+            node,
+            message: `执行器不许直接 import ${matched}，依赖必须通过 ctx 注入`
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/executor-no-import-utils.js

@@ -0,0 +1,68 @@
+/**
+ * EXE-03：执行器/零件不许 import utils/（纯函数白名单除外）
+ * 日志/时钟/流/鉴权这些必须经 ctx.ports 注入
+ */
+
+const DEFAULT_DIRS = {
+  domains: 'src/domains',
+  utils: 'src/utils'
+}
+
+// 纯函数白名单：无副作用、不持有状态、不依赖运行时环境
+const PURE_UTILS = ['@/utils/adapters', '@/utils/format', '@/utils/number']
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isExecutorOrStepFile(filename, dirs) {
+  const domainsDir = dirs.domains.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  return new RegExp(`/${domainsDir}/[^/]+/(executors|steps)/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '执行器/零件不许 import utils/，能力必须经 ctx.ports 注入',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isExecutorOrStepFile(filename, dirs)) return {}
+
+    const utilsBase = importSpec(dirs, 'utils')
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        // 不是 import utils/ 的，跳过
+        if (!importPath.startsWith(`${utilsBase}/`) && importPath !== utilsBase) return
+
+        // 白名单里的纯函数，放行
+        const isPure = PURE_UTILS.some(
+          (pure) => importPath === pure || importPath.startsWith(`${pure}/`)
+        )
+
+        if (!isPure) {
+          context.report({
+            node,
+            message: `执行器不许直接 import ${importPath}，能力必须经 ctx.ports 注入`
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/hub-no-import-steps.js

@@ -0,0 +1,51 @@
+/**
+ * HUB-01：中枢不许 import steps/
+ * 中枢只做分发，把意图交给执行器，不直接调内部步骤
+ */
+
+const DEFAULT_DIRS = {
+  domains: 'src/domains'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isHubFile(filename, dirs) {
+  const domainsDir = dirs.domains.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  // 文件是 domains/<模块>/index.ts（中枢入口）
+  return new RegExp(`/${domainsDir}/[^/]+/index\\.ts$`).test(normalized)
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '中枢不许 import steps/，只做分发，把意图交给执行器',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isHubFile(filename, dirs)) return {}
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        // import 了 steps/ 下的文件
+        if (/^(\.\.?\/)+steps\//.test(importPath)) {
+          context.report({
+            node,
+            message: '中枢不许直接 import steps/，把这类控制动作放进执行器文件'
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/index.js

@@ -0,0 +1,42 @@
+/**
+ * tha-cli ESLint 插件
+ * 把 THA 架构的边界规则做成 ESLint 规则，编辑器里实时红线
+ */
+
+import hubNoImportSteps from './hub-no-import-steps.js'
+import executorNoCrossImport from './executor-no-cross-import.js'
+import executorNoImportApi from './executor-no-import-api.js'
+import executorNoImportUtils from './executor-no-import-utils.js'
+import viewNoImportApi from './view-no-import-api.js'
+import viewNoCreateModule from './view-no-create-module.js'
+import storeNoImportApi from './store-no-import-api.js'
+import utilNoImportUi from './util-no-import-ui.js'
+
+export const rules = {
+  'hub-no-import-steps': hubNoImportSteps,
+  'executor-no-cross-import': executorNoCrossImport,
+  'executor-no-import-api': executorNoImportApi,
+  'executor-no-import-utils': executorNoImportUtils,
+  'view-no-import-api': viewNoImportApi,
+  'view-no-create-module': viewNoCreateModule,
+  'store-no-import-api': storeNoImportApi,
+  'util-no-import-ui': utilNoImportUi
+}
+
+export const configs = {
+  recommended: {
+    plugins: ['tha'],
+    rules: {
+      'tha/hub-no-import-steps': 'error',
+      'tha/executor-no-cross-import': 'error',
+      'tha/executor-no-import-api': 'error',
+      'tha/executor-no-import-utils': 'error',
+      'tha/view-no-import-api': 'error',
+      'tha/view-no-create-module': 'error',
+      'tha/store-no-import-api': 'error',
+      'tha/util-no-import-ui': 'error'
+    }
+  }
+}
+
+export default { rules, configs }

package/tha/eslint-rules/store-no-import-api.js

@@ -0,0 +1,57 @@
+/**
+ * STORE-01：状态层不许 import api 层
+ * 状态层只存状态，不发请求
+ */
+
+const DEFAULT_DIRS = {
+  stores: 'src/stores',
+  api: 'src/api'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isStoreFile(filename, dirs) {
+  const storesDir = dirs.stores.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  return new RegExp(`/${storesDir}/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '状态层不许 import api 层，状态层只存状态，不发请求',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isStoreFile(filename, dirs)) return {}
+
+    const apiBase = importSpec(dirs, 'api')
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        if (importPath.startsWith(`${apiBase}/`)) {
+          context.report({
+            node,
+            message: '状态层不许 import api 层，把请求挪进执行器，拿到结果再写回 state'
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/util-no-import-ui.js

@@ -0,0 +1,78 @@
+/**
+ * UTIL-01：基础设施不许 import UI 库或业务模块
+ * 传输层只上报不越权：不感知业务模块，不做展示
+ */
+
+const DEFAULT_DIRS = {
+  utils: 'src/utils',
+  views: 'src/views',
+  domains: 'src/domains'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isUtilFile(filename, dirs) {
+  const utilsDir = dirs.utils.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  return new RegExp(`/${utilsDir}/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '基础设施不许 import UI 库或业务模块',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isUtilFile(filename, dirs)) return {}
+
+    const viewsBase = importSpec(dirs, 'views')
+    const domainsBase = importSpec(dirs, 'domains')
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        // import 了 UI 库
+        if (importPath === 'element-plus') {
+          context.report({
+            node,
+            message: '基础设施不许 import UI 库，提示交给页面'
+          })
+          return
+        }
+
+        // import 了视图层
+        if (importPath.startsWith(`${viewsBase}/`)) {
+          context.report({
+            node,
+            message: '基础设施不许 import 视图层'
+          })
+          return
+        }
+
+        // import 了业务模块
+        if (importPath.startsWith(`${domainsBase}/`)) {
+          context.report({
+            node,
+            message: '基础设施不许 import 业务模块'
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/view-no-create-module.js

@@ -0,0 +1,68 @@
+/**
+ * VIEW-02：视图不许自己 create 模块实例
+ * 每个领域全局唯一实例，视图只能经 useXxxModule() 取
+ */
+
+const DEFAULT_DIRS = {
+  views: 'src/views',
+  domains: 'src/domains'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isViewFile(filename, dirs) {
+  const viewsDir = dirs.views.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  return new RegExp(`/${viewsDir}/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '视图不许自己 create 模块实例，必须用 useXxxModule()',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isViewFile(filename, dirs)) return {}
+
+    const domainsBase = importSpec(dirs, 'domains')
+    // 匹配 @/domains/user 这种（模块入口）
+    const factoryPattern = new RegExp(`^${domainsBase}/[^/]+$`)
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        if (!factoryPattern.test(importPath)) return
+
+        // 看 import 的名字里有没有 createXxxModule
+        const importedNames = node.specifiers
+          .filter((spec) => spec.type === 'ImportSpecifier')
+          .map((spec) => spec.imported.name)
+
+        const factory = importedNames.find((name) => /^create[A-Z]\w*Module$/.test(name))
+
+        if (factory) {
+          context.report({
+            node,
+            message: `视图不许自己 create 模块实例，改用 useXxxModule()`
+          })
+        }
+      }
+    }
+  }
+}

package/tha/eslint-rules/view-no-import-api.js

@@ -0,0 +1,87 @@
+/**
+ * VIEW-01：视图不许直接 import 网络层、传输工具、执行器内部
+ * 视图只表达意图：动作走域中枢，数据直读状态层
+ */
+
+const DEFAULT_DIRS = {
+  views: 'src/views',
+  api: 'src/api',
+  utils: 'src/utils',
+  domains: 'src/domains'
+}
+
+function getDirs(context) {
+  return { ...DEFAULT_DIRS, ...(context.settings?.tha?.dirs || {}) }
+}
+
+function isViewFile(filename, dirs) {
+  const viewsDir = dirs.views.replace(/\\/g, '/')
+  const normalized = filename.replace(/\\/g, '/')
+  return new RegExp(`/${viewsDir}/`).test(normalized)
+}
+
+function importSpec(dirs, key) {
+  const base = dirs[key].startsWith('src/') ? dirs[key].slice('src/'.length) : dirs[key]
+  return `@/${base}`
+}
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '视图不许直接 import 网络层、传输工具、执行器内部',
+      recommended: true
+    },
+    schema: []
+  },
+
+  create(context) {
+    const dirs = getDirs(context)
+    const filename = context.filename
+
+    if (!isViewFile(filename, dirs)) return {}
+
+    const apiBase = importSpec(dirs, 'api')
+    const utilsBase = importSpec(dirs, 'utils')
+    const domainsBase = importSpec(dirs, 'domains')
+
+    // 传输工具：request / stream / token
+    const transportUtils = new Set([
+      `${utilsBase}/request`,
+      `${utilsBase}/stream`,
+      `${utilsBase}/token`
+    ])
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value
+
+        // import 了 api 层
+        if (importPath.startsWith(`${apiBase}/`)) {
+          context.report({
+            node,
+            message: '视图不许直接 import api 层，动作走域中枢'
+          })
+          return
+        }
+
+        // import 了传输工具
+        if (transportUtils.has(importPath)) {
+          context.report({
+            node,
+            message: '视图不许直接 import 传输工具，动作走域中枢'
+          })
+          return
+        }
+
+        // import 了执行器/零件内部
+        if (new RegExp(`^${domainsBase}/[^/]+/(executors|steps)/`).test(importPath)) {
+          context.report({
+            node,
+            message: '视图不许直接 import 执行器内部，走域中枢的动作'
+          })
+        }
+      }
+    }
+  }
+}