@ranger1/dx 0.1.91 → 0.1.92

package/skills/naming-audit-fixer/references/fix-guide.md

@@ -0,0 +1,93 @@
+# 修复指南：文件/文件夹重命名与引用更新
+
+## 核心原则
+
+1. **目录优先于文件**：先重命名目录，再处理其下的文件
+2. **git mv 保留历史**：所有重命名必须用 `git mv`，不要用 `mv` + `git add`
+3. **引用同步更新**：每次重命名后立即更新所有 import/require 引用
+4. **增量验证**：每完成一个模块的重命名，立即运行 lint + build 验证
+
+## 修复流程
+
+### Step 1: 目录重命名
+
+目录重命名影响最大，优先处理。
+
+```bash
+# 示例：重命名 NestJS 模块目录
+git mv apps/backend/src/modules/ai.model apps/backend/src/modules/ai-model
+```
+
+重命名后，使用 Grep 搜索所有引用该目录路径的导入语句：
+
+```
+# 搜索模式
+from '.*/ai\.model/    →  更新为 /ai-model/
+from '.*/ai\.usecase/  →  更新为 /ai-usecase/
+```
+
+### Step 2: 文件重命名（按模块分批）
+
+每次处理一个模块目录下的所有违规文件：
+
+```bash
+# 示例：重命名 DTO 文件
+git mv "apps/backend/src/modules/chat/dto/requests/send.message.request.dto.ts" \
+       "apps/backend/src/modules/chat/dto/requests/send-message-request.dto.ts"
+```
+
+### Step 3: 更新导入引用
+
+对每个被重命名的文件，搜索并更新所有导入：
+
+1. 用 Grep 搜索旧文件名（不含扩展名）的 import 语句
+2. 用 Edit 逐一更新为新文件名
+3. 注意 barrel export（index.ts）中的 re-export 也需要更新
+
+### Step 4: 验证
+
+```bash
+# NestJS 后端
+dx lint
+dx build backend --dev
+
+# 前端
+dx build front --dev
+dx build admin --dev
+```
+
+## 各框架规范速查
+
+### NestJS
+
+| 元素 | 规范 | 示例 |
+|------|------|------|
+| 文件 | `kebab-name.type.ts` | `user-activity.service.ts` |
+| 目录 | kebab-case | `user-statistics/` |
+| DTO | `kebab-name.request.dto.ts` | `send-message.request.dto.ts` |
+| Exception | `kebab-name.exception.ts` | `message-not-found.exception.ts` |
+| Spec | `kebab-name.type.spec.ts` | `user.service.spec.ts` |
+| E2E | `kebab-name.e2e-spec.ts` | `activity-admin.e2e-spec.ts` |
+
+### Next.js + React
+
+| 元素 | 规范 | 示例 |
+|------|------|------|
+| 组件 .tsx | PascalCase | `ChatPanel.tsx` |
+| 工具 .ts | kebab-case | `sort-mappings.ts` |
+| Hook .ts | camelCase | `useChat.ts` |
+| 路由文件 | 小写 | `page.tsx`, `layout.tsx` |
+| 目录 | kebab-case | `character/`（单数） |
+| ui/ | kebab-case | `button.tsx` |
+
+### Vite + React
+
+与 Next.js 相同，但无路由文件约束。
+
+## 高风险操作注意
+
+- **barrel export (index.ts)**：重命名后检查是否有 `export * from './old-name'`
+- **动态 import**：`import()` 表达式中的路径也需要更新
+- **tsconfig paths**：如果 tsconfig 中配置了路径别名指向具体文件，也需更新
+- **测试文件**：jest.config 或 vitest.config 中的 testMatch / include 模式可能引用目录名
+- **Prisma schema**：`schema/` 下的 `.prisma` 文件名通常与模块名对应，但 Prisma 不强制命名规范

package/skills/naming-audit-fixer/scripts/audit_naming.py

@@ -0,0 +1,534 @@
+#!/usr/bin/env python3
+"""
+naming-convention-audit: 按模型指定的规则扫描文件/文件夹命名违规。
+
+本脚本不做框架检测，所有决策由调用方（模型）通过 JSON 配置传入。
+脚本只负责：遍历目录 → 按规则匹配 → 输出 JSON 报告。
+
+用法:
+    echo '<config_json>' | python audit_naming.py
+    python audit_naming.py config.json
+
+配置 JSON 格式:
+{
+  "scans": [
+    {
+      "root": "apps/backend/src",
+      "framework": "nestjs",
+      "extra_skip_dirs": ["generated"],
+      "extra_ok_files": ["bootstrap.ts"],
+      "ui_dirs": []
+    },
+    {
+      "root": "apps/front/src",
+      "framework": "nextjs-react",
+      "app_dir": "app",
+      "ui_dirs": ["components/ui"]
+    }
+  ]
+}
+
+支持的 framework 值:
+  - nestjs          : NestJS 后端（kebab-name.type.ts）
+  - nextjs-react    : Next.js + React（PascalCase .tsx, kebab .ts, 路由文件豁免）
+  - react           : React SPA / Vite（PascalCase .tsx, kebab .ts）
+  - vue             : Vue（kebab-case .vue, kebab .ts）
+  - angular         : Angular（kebab-name.type.ts，类似 NestJS）
+  - generic-ts      : 通用 TypeScript（全 kebab-case，识别标准后缀）
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import sys
+from dataclasses import asdict, dataclass
+from pathlib import Path
+
+# ── 默认跳过 ──────────────────────────────────────────────
+
+DEFAULT_SKIP_DIRS = frozenset({
+    'node_modules', '.git', 'dist', 'build', '.next', '.nuxt', '.output',
+    '.turbo', '.nx', 'coverage', '.cache', '__pycache__', '.omc', '.claude',
+    '.vscode', '.idea', 'generated', 'migrations',
+})
+
+DEFAULT_SKIP_FILES = frozenset({'.DS_Store', 'thumbs.db', '.gitkeep'})
+
+DEFAULT_OK_FILES = frozenset({
+    'index.ts', 'index.tsx', 'index.js', 'index.jsx',
+    'main.ts', 'main.tsx', 'main.js', 'main.jsx',
+    'types.ts', 'types.d.ts', 'constants.ts',
+    'seed.ts', 'schema.prisma', 'App.tsx', 'App.ts',
+})
+
+# 合法的特殊目录名（不检查 kebab-case）
+OK_DIR_NAMES = frozenset({
+    'dto', 'e2e', 'src', '@types', '__tests__', '__mocks__',
+    'ui', 'app', 'public', 'pages', 'assets', 'static',
+})
+
+# ── NestJS 类型后缀（最长优先） ──────────────────────────────
+
+NESTJS_COMPOUND_SUFFIXES = [
+    '.e2e-spec.ts', '.response.dto.ts', '.request.dto.ts',
+    '.exception.spec.ts', '.service.spec.ts', '.controller.spec.ts',
+    '.repository.spec.ts', '.guard.spec.ts',
+]
+NESTJS_SIMPLE_SUFFIXES = [
+    '.controller.ts', '.repository.ts', '.interceptor.ts', '.middleware.ts',
+    '.subscriber.ts', '.decorator.ts', '.interface.ts', '.exception.ts',
+    '.constants.ts', '.constant.ts', '.strategy.ts', '.provider.ts',
+    '.adapter.ts', '.factory.ts', '.service.ts', '.module.ts',
+    '.helper.ts', '.entity.ts', '.guard.ts', '.pipe.ts',
+    '.filter.ts', '.enum.ts', '.util.ts', '.config.ts',
+    '.spec.ts', '.type.ts', '.types.ts', '.dto.ts',
+]
+NESTJS_ALL_SUFFIXES = NESTJS_COMPOUND_SUFFIXES + NESTJS_SIMPLE_SUFFIXES
+
+# Next.js 路由文件
+NEXTJS_ROUTE_FILES = frozenset({
+    'page.tsx', 'page.ts', 'page.jsx', 'page.js',
+    'layout.tsx', 'layout.ts', 'layout.jsx', 'layout.js',
+    'loading.tsx', 'loading.ts', 'error.tsx', 'error.ts',
+    'not-found.tsx', 'not-found.ts', 'template.tsx', 'template.ts',
+    'default.tsx', 'default.ts', 'route.tsx', 'route.ts',
+    'middleware.ts', 'middleware.js', 'global-error.tsx',
+    'sitemap.ts', 'robots.ts', 'opengraph-image.tsx', 'icon.tsx',
+    'apple-icon.tsx', 'manifest.ts',
+})
+
+# Next.js app 目录下常见的非路由客户端页面文件名（kebab-case 合法）
+NEXTJS_CLIENT_PAGE_FILES = frozenset({
+    'client-page.tsx', 'client-page.ts',
+})
+
+# 前端 .ts 文件允许的 name.type 模式中的 type 段
+FRONTEND_TYPE_SUFFIXES = frozenset({
+    'helpers', 'helper', 'utils', 'util', 'config', 'storage',
+    'context', 'types', 'schema', 'styles', 'constants',
+    'mock', 'mocks', 'fixture', 'fixtures', 'service',
+})
+
+# 通用 TS 项目中合法的文件类型后缀（name.type.ts 模式中的 type 段）
+# 这些后缀用点号分隔是标准模式，不应视为 kebab-case 违规
+GENERIC_TS_TYPE_SUFFIXES = frozenset({
+    'spec', 'test', 'e2e-spec',
+    'service', 'module', 'controller', 'repository',
+    'guard', 'pipe', 'filter', 'interceptor', 'middleware',
+    'decorator', 'interface', 'exception', 'entity',
+    'enum', 'type', 'types', 'dto', 'config', 'constant', 'constants',
+    'util', 'utils', 'helper', 'helpers', 'factory', 'strategy',
+    'subscriber', 'adapter', 'provider', 'mock', 'mocks',
+    'fixture', 'fixtures', 'schema', 'model',
+    'handler', 'resolver', 'directive', 'component',
+})
+
+# Angular 类型后缀
+ANGULAR_SUFFIXES = [
+    '.component.spec.ts', '.service.spec.ts', '.pipe.spec.ts',
+    '.directive.spec.ts', '.guard.spec.ts', '.resolver.spec.ts',
+    '.component.ts', '.component.html', '.component.css', '.component.scss',
+    '.service.ts', '.module.ts', '.pipe.ts', '.directive.ts',
+    '.guard.ts', '.resolver.ts', '.interceptor.ts', '.model.ts',
+    '.interface.ts', '.enum.ts', '.spec.ts',
+]
+
+
+# ── 数据结构 ──────────────────────────────────────────────
+
+@dataclass
+class Violation:
+    path: str
+    kind: str           # file | directory
+    rule: str
+    message: str
+    current: str
+    suggested: str | None
+    severity: str       # info | warning
+
+
+# ── 判断工具 ──────────────────────────────────────────────
+
+def is_kebab(name: str) -> bool:
+    return bool(re.match(r'^[a-z][a-z0-9]*(-[a-z0-9]+)*$', name))
+
+def is_pascal(name: str) -> bool:
+    return bool(re.match(r'^[A-Z][a-zA-Z0-9]+$', name))
+
+def is_camel(name: str) -> bool:
+    return bool(re.match(r'^[a-z][a-zA-Z0-9]+$', name))
+
+def is_numeric(name: str) -> bool:
+    """纯数字目录名（如 403, 404, 500）合法。"""
+    return bool(re.match(r'^\d+$', name))
+
+def to_kebab(name: str) -> str:
+    s = re.sub(r'([A-Z])', r'-\1', name).lower().lstrip('-')
+    s = s.replace('.', '-').replace('_', '-')
+    return re.sub(r'-+', '-', s)
+
+def to_pascal(name: str) -> str:
+    parts = re.split(r'[-_.]', name)
+    return ''.join(p.capitalize() for p in parts if p)
+
+
+def _is_in_ui_dir(rel_path: str, scan_root_rel: str, ui_dirs: list[str]) -> bool:
+    """检查文件是否位于 UI 组件目录（如 shadcn 的 components/ui/）。"""
+    for ui_dir in ui_dirs:
+        full_ui = scan_root_rel + '/' + ui_dir if scan_root_rel != '.' else ui_dir
+        if rel_path.startswith(full_ui + '/') or ('/' + ui_dir + '/') in rel_path:
+            return True
+    return False
+
+
+# ── NestJS 检查 ───────────────────────────────────────────
+
+def _extract_suffix(filename: str, suffixes: list[str]) -> tuple[str, str | None]:
+    for suffix in suffixes:
+        if filename.endswith(suffix):
+            return filename[:-len(suffix)], suffix
+    base = filename.rsplit('.', 1)[0] if '.' in filename else filename
+    return base, None
+
+
+def check_nestjs_file(fn: str, rel: str, ok_files: frozenset) -> list[Violation]:
+    vs: list[Violation] = []
+    if not fn.endswith('.ts') or fn.endswith('.d.ts') or fn in ok_files:
+        return vs
+    name, suffix = _extract_suffix(fn, NESTJS_ALL_SUFFIXES)
+    if suffix:
+        if name and '.' in name:
+            vs.append(Violation(
+                path=rel, kind='file', rule='nestjs-name-dots',
+                message='name 部分应使用 kebab-case（连字符），不应使用点号',
+                current=fn, suggested=name.replace('.', '-') + suffix, severity='warning'))
+        elif name and not is_kebab(name) and name not in ('', 'i18n'):
+            vs.append(Violation(
+                path=rel, kind='file', rule='nestjs-name-case',
+                message='name 部分应使用 kebab-case',
+                current=fn, suggested=to_kebab(name) + suffix, severity='warning'))
+    else:
+        if name and '.' in name:
+            vs.append(Violation(
+                path=rel, kind='file', rule='nestjs-name-dots',
+                message='文件名包含多余的点号',
+                current=fn, suggested=name.replace('.', '-') + '.ts', severity='info'))
+    return vs
+
+
+def check_nestjs_dir(dn: str, rel: str) -> list[Violation]:
+    vs: list[Violation] = []
+    # 跳过 @types、纯数字等合法特殊目录名
+    if dn in OK_DIR_NAMES or dn.startswith('@') or is_numeric(dn):
+        return vs
+    if '.' in dn:
+        vs.append(Violation(
+            path=rel, kind='directory', rule='nestjs-dir-dots',
+            message='目录名不应包含点号，应使用 kebab-case',
+            current=dn, suggested=dn.replace('.', '-'), severity='warning'))
+    elif not is_kebab(dn):
+        vs.append(Violation(
+            path=rel, kind='directory', rule='nestjs-dir-case',
+            message='目录名应使用 kebab-case',
+            current=dn, suggested=to_kebab(dn), severity='warning'))
+    return vs
+
+
+# ── Angular 检查 ──────────────────────────────────────────
+
+def check_angular_file(fn: str, rel: str, ok_files: frozenset) -> list[Violation]:
+    vs: list[Violation] = []
+    if fn in ok_files:
+        return vs
+    name, suffix = _extract_suffix(fn, ANGULAR_SUFFIXES)
+    if suffix:
+        if name and '.' in name:
+            vs.append(Violation(
+                path=rel, kind='file', rule='angular-name-dots',
+                message='name 部分应使用 kebab-case',
+                current=fn, suggested=name.replace('.', '-') + suffix, severity='warning'))
+        elif name and not is_kebab(name):
+            vs.append(Violation(
+                path=rel, kind='file', rule='angular-name-case',
+                message='name 部分应使用 kebab-case',
+                current=fn, suggested=to_kebab(name) + suffix, severity='warning'))
+    return vs
+
+
+# ── React / Next.js 检查 ─────────────────────────────────
+
+def check_tsx_file(fn: str, rel: str, ok_files: frozenset,
+                   is_app_dir: bool, has_nextjs: bool,
+                   in_ui_dir: bool) -> list[Violation]:
+    vs: list[Violation] = []
+    if not fn.endswith('.tsx') or fn in ok_files:
+        return vs
+    base = fn[:-4]
+    if base == 'index':
+        return vs
+    # Next.js app 目录下的路由文件和客户端页面文件豁免
+    if has_nextjs and is_app_dir:
+        if fn in NEXTJS_ROUTE_FILES or fn in NEXTJS_CLIENT_PAGE_FILES:
+            return vs
+    # 动态路由 [id].tsx, [...slug].tsx
+    if base.startswith('['):
+        return vs
+    # 测试文件跳过
+    if base.endswith('.test') or base.endswith('.spec'):
+        return vs
+    # ui/ 目录下的 shadcn 组件保持 kebab-case，不要求 PascalCase
+    if in_ui_dir:
+        if not is_kebab(base):
+            vs.append(Violation(
+                path=rel, kind='file', rule='react-ui-kebab',
+                message='ui/ 目录下的组件应保持 kebab-case',
+                current=fn, suggested=to_kebab(base) + '.tsx', severity='info'))
+        return vs
+    # 非 ui/ 下的 .tsx 组件应为 PascalCase
+    if not is_pascal(base):
+        vs.append(Violation(
+            path=rel, kind='file', rule='react-tsx-pascal',
+            message='.tsx 组件文件应使用 PascalCase',
+            current=fn, suggested=to_pascal(base) + '.tsx', severity='warning'))
+    return vs
+
+
+def check_ts_file(fn: str, rel: str, ok_files: frozenset) -> list[Violation]:
+    vs: list[Violation] = []
+    if not fn.endswith('.ts') or fn.endswith('.d.ts') or fn in ok_files:
+        return vs
+    base = fn[:-3]
+
+    # hook 文件 → camelCase（含 hook 的 spec/test 文件也豁免）
+    if base.startswith('use') and len(base) > 3 and base[3:4].isupper():
+        # useXxx.ts / useXxx.spec.ts / useXxx.test.ts 都合法
+        clean_hook = re.sub(r'\.(spec|test)$', '', base)
+        if not is_camel(clean_hook):
+            vs.append(Violation(
+                path=rel, kind='file', rule='react-hook-camel',
+                message='Hook 文件应使用 camelCase（useXxx.ts）',
+                current=fn, suggested=None, severity='warning'))
+        return vs
+
+    # 去掉 .spec / .test 后缀
+    clean = re.sub(r'\.(spec|test)$', '', base)
+
+    # 允许 name.type.ts 模式（如 foo.helpers.ts）
+    parts = clean.rsplit('.', 1)
+    if len(parts) == 2 and parts[1] in FRONTEND_TYPE_SUFFIXES:
+        name_part = parts[0]
+        if name_part and not is_kebab(name_part):
+            tail = base[len(clean):]
+            vs.append(Violation(
+                path=rel, kind='file', rule='react-ts-kebab',
+                message='.ts 文件 name 部分应使用 kebab-case',
+                current=fn, suggested=to_kebab(name_part) + '.' + parts[1] + tail + '.ts',
+                severity='warning'))
+    elif clean and not is_kebab(clean):
+        tail = base[len(clean):]
+        vs.append(Violation(
+            path=rel, kind='file', rule='react-ts-kebab',
+            message='.ts 非组件文件应使用 kebab-case',
+            current=fn, suggested=to_kebab(clean) + tail + '.ts', severity='warning'))
+    return vs
+
+
+def check_vue_file(fn: str, rel: str, ok_files: frozenset) -> list[Violation]:
+    vs: list[Violation] = []
+    if not fn.endswith('.vue') or fn in ok_files:
+        return vs
+    base = fn[:-4]
+    if not is_pascal(base) and not is_kebab(base):
+        vs.append(Violation(
+            path=rel, kind='file', rule='vue-component-case',
+            message='.vue 组件应使用 PascalCase 或 kebab-case',
+            current=fn, suggested=to_pascal(base) + '.vue', severity='warning'))
+    return vs
+
+
+def check_frontend_dir(dn: str, rel: str) -> list[Violation]:
+    vs: list[Violation] = []
+    # 跳过特殊前缀目录
+    if dn[0:1] in ('[', '(', '@', '_'):
+        return vs
+    # 跳过已知合法目录名
+    if dn in OK_DIR_NAMES:
+        return vs
+    # 跳过纯数字目录（如 403, 404, 500 错误页）
+    if is_numeric(dn):
+        return vs
+    if not is_kebab(dn):
+        vs.append(Violation(
+            path=rel, kind='directory', rule='frontend-dir-kebab',
+            message='目录应使用 kebab-case',
+            current=dn, suggested=to_kebab(dn), severity='warning'))
+    # components/ 下检查单数
+    if dn.endswith('s') and not dn.endswith('ss') and len(dn) > 3:
+        parent_name = Path(rel).parent.name
+        if parent_name == 'components':
+            vs.append(Violation(
+                path=rel, kind='directory', rule='frontend-dir-singular',
+                message='components/ 下子目录建议使用单数',
+                current=dn, suggested=dn[:-1], severity='info'))
+    return vs
+
+
+def check_generic_ts(fn: str, rel: str, ok_files: frozenset) -> list[Violation]:
+    """通用 TS 检查：识别 name.type.ext 模式，只对 name 部分检查 kebab-case。"""
+    vs: list[Violation] = []
+    if fn in ok_files or fn.endswith('.d.ts'):
+        return vs
+    if not (fn.endswith('.ts') or fn.endswith('.tsx') or fn.endswith('.js') or fn.endswith('.jsx')):
+        return vs
+
+    ext = '.' + fn.rsplit('.', 1)[1]  # .ts / .tsx / .js / .jsx
+    base = fn[:-len(ext)]
+
+    if base == 'index':
+        return vs
+
+    # 逐层剥离已知 type 后缀，提取 name 部分
+    # 如 "command.handler.test" → name="command", suffixes=["handler", "test"]
+    # 如 "error-codes.spec" → name="error-codes", suffixes=["spec"]
+    remaining = base
+    while True:
+        parts = remaining.rsplit('.', 1)
+        if len(parts) == 2 and parts[1] in GENERIC_TS_TYPE_SUFFIXES:
+            remaining = parts[0]
+        else:
+            break
+
+    name_part = remaining
+
+    # 如果整个 base 就是一个 type 后缀（如 "types.ts"），跳过
+    if not name_part:
+        return vs
+
+    # 检查 name 部分是否 kebab-case
+    if not is_kebab(name_part):
+        suggested_name = to_kebab(name_part)
+        # 重建文件名：kebab-name + 原有后缀部分
+        suffix_part = base[len(name_part):]  # 如 ".handler.test" 或 ".spec"
+        suggested = suggested_name + suffix_part + ext
+        vs.append(Violation(
+            path=rel, kind='file', rule='generic-ts-kebab',
+            message='文件名的 name 部分应使用 kebab-case',
+            current=fn, suggested=suggested, severity='warning'))
+
+    return vs
+
+
+# ── 扫描引擎 ─────────────────────────────────────────────
+
+def scan(config: dict) -> dict:
+    """按配置扫描，返回结果字典。"""
+    project_root = Path.cwd().resolve()
+    all_violations: list[Violation] = []
+
+    for scan_cfg in config.get('scans', []):
+        root_rel = scan_cfg['root']
+        framework = scan_cfg.get('framework', 'generic-ts')
+        extra_skip = frozenset(scan_cfg.get('extra_skip_dirs', []))
+        extra_ok = frozenset(scan_cfg.get('extra_ok_files', []))
+        app_dir_name = scan_cfg.get('app_dir', 'app')
+        ui_dirs: list[str] = scan_cfg.get('ui_dirs', [])
+
+        skip_dirs = DEFAULT_SKIP_DIRS | extra_skip
+        ok_files = DEFAULT_OK_FILES | extra_ok | DEFAULT_SKIP_FILES
+
+        scan_root = project_root / root_rel
+        if not scan_root.exists():
+            continue
+
+        app_dir_path = scan_root / app_dir_name
+        has_nextjs = framework == 'nextjs-react'
+
+        for root, dirs, files in os.walk(scan_root):
+            rp = Path(root)
+            dirs[:] = sorted(d for d in dirs if d not in skip_dirs)
+
+            # 检查目录名
+            if rp != scan_root:
+                dn = rp.name
+                rel = str(rp.relative_to(project_root))
+                if framework in ('nestjs', 'angular'):
+                    all_violations.extend(check_nestjs_dir(dn, rel))
+                elif framework in ('nextjs-react', 'react', 'vue'):
+                    all_violations.extend(check_frontend_dir(dn, rel))
+
+            # 检查文件名
+            for f in sorted(files):
+                if f in DEFAULT_SKIP_FILES:
+                    continue
+                fp = rp / f
+                rel = str(fp.relative_to(project_root))
+                in_app = has_nextjs and str(rp).startswith(str(app_dir_path))
+                in_ui = _is_in_ui_dir(rel, root_rel, ui_dirs)
+
+                if framework == 'nestjs':
+                    all_violations.extend(check_nestjs_file(f, rel, ok_files))
+                elif framework == 'angular':
+                    all_violations.extend(check_angular_file(f, rel, ok_files))
+                elif framework in ('nextjs-react', 'react'):
+                    if f.endswith('.tsx'):
+                        all_violations.extend(
+                            check_tsx_file(f, rel, ok_files, in_app, has_nextjs, in_ui))
+                    elif f.endswith('.ts'):
+                        all_violations.extend(check_ts_file(f, rel, ok_files))
+                elif framework == 'vue':
+                    if f.endswith('.vue'):
+                        all_violations.extend(check_vue_file(f, rel, ok_files))
+                    elif f.endswith('.ts'):
+                        all_violations.extend(check_ts_file(f, rel, ok_files))
+                elif framework == 'generic-ts':
+                    all_violations.extend(check_generic_ts(f, rel, ok_files))
+
+    # 只保留 warning
+    filtered = [v for v in all_violations if v.severity == 'warning']
+
+    by_rule: dict[str, int] = {}
+    for v in filtered:
+        by_rule[v.rule] = by_rule.get(v.rule, 0) + 1
+
+    # 修复计划
+    fix_plan: list[dict] = []
+    for v in filtered:
+        if not v.suggested:
+            continue
+        if v.kind == 'file':
+            old = v.path
+            new = str(Path(v.path).parent / v.suggested)
+            fix_plan.append({'old': old, 'new': new,
+                             'git_mv': f'git mv "{old}" "{new}"'})
+        elif v.kind == 'directory':
+            old = v.path
+            parent = v.path.rsplit('/', 1)[0] if '/' in v.path else '.'
+            new = parent + '/' + v.suggested
+            fix_plan.append({'old': old, 'new': new,
+                             'note': '目录重命名需同步更新所有导入路径'})
+
+    return {
+        'total_violations': len(filtered),
+        'summary_by_rule': by_rule,
+        'violations': [asdict(v) for v in filtered],
+        'fix_plan': fix_plan,
+    }
+
+
+def main() -> None:
+    # 从 stdin 或文件参数读取配置
+    if len(sys.argv) > 1 and sys.argv[1] != '-':
+        config_text = Path(sys.argv[1]).read_text()
+    else:
+        config_text = sys.stdin.read()
+
+    config = json.loads(config_text)
+    result = scan(config)
+    json.dump(result, sys.stdout, indent=2, ensure_ascii=False)
+    print()
+    sys.exit(1 if result['total_violations'] > 0 else 0)
+
+
+if __name__ == '__main__':
+    main()

package/codex/agents/fixer.toml

@@ -1,37 +0,0 @@
-model = "gpt-5.3-codex"
-model_reasoning_effort = "medium"
-approval_policy = "never"
-sandbox_mode = "danger-full-access"
-
-developer_instructions = '''
-你是 fix 代理。
-
-输入必须包含：PR 编号、round、runId、fixFile。
-缓存目录固定为 `./.cache/`，路径一律使用 `./.cache/<file>`（禁止 basename-only）。
-
-快速失败（缺失即报错并退出）：
-- 缺 PR 编号：`{"error":"MISSING_PR_NUMBER"}`
-- 缺 fixFile：`{"error":"MISSING_FIX_FILE"}`
-- fixFile 不可读：`{"error":"FIX_FILE_NOT_READABLE"}`
-- fixFile 无法解析 `IssuesToFix`：`{"error":"INVALID_FIX_FILE"}`
-
-强制规则：
-1. 仅处理 fixFile 中问题：`IssuesToFix` 必修；`OptionalIssues` 可修可拒绝（需写 reason），禁止范围外改动。
-2. 每个 findingId 单独一个 commit，提交信息必须包含 findingId（示例：`fix(pr #<PR>): <FINDING_ID> <title>`）。
-3. 每次提交后 push（首次无 upstream 可 `git push -u origin HEAD`），全部处理完再 `git push` 兜底。
-4. 无法修复的项必须写明 reason，并记入 Rejected。
-5. 必须维护 `./.cache/decision-log-pr<PR>.md`：按轮次追加 Fixed/Rejected，禁止覆盖历史。
-6. Decision Log 每条必须包含：id、file、essence；预检修复允许 `file: __precheck__`。
-7. 修复后执行 `dx lint` 与 `dx build all`；失败则不得声称完成。
-8. 生成 `./.cache/fix-report-pr<PR>-r<ROUND>-<RUN_ID>.md`（可直接用于 PR 评论，且不包含本地绝对路径）。
-9. 禁止执行 GitHub 评论发布动作（如 `gh pr comment` / `gh pr review`），发布由编排器负责。
-10. 修改 `json/jsonc` 文件时必须使用脚本方式（如 python）改写，禁止手工字符串拼接导致格式损坏。
-11. 最终响应只输出一行：`fixReportFile: ./.cache/<file>.md`；失败只输出一行 JSON 错误。
-
-推送失败处理（强制）：
-1. 若 `git push` 失败，先判断是否为网络类失败（如 DNS 解析失败、连接拒绝、超时）。
-2. 网络类失败必须重试当前 push 最多 2 次（总 3 次尝试），退避 2s / 5s。
-3. 每次重试前执行轻量检查：`gh auth status`、`git remote -v`、`git ls-remote origin -h`。
-4. 若重试后仍失败，必须返回结构化错误：`{"error":"GIT_PUSH_FAILED_NETWORK","step":"push","detail":"..."}`。
-5. 禁止在 push 未成功时伪造“已完成修复”或输出成功 fixReportFile。
-'''

package/codex/agents/orchestrator.toml

@@ -1,11 +0,0 @@
-model = "gpt-5.3-codex"
-model_reasoning_effort = "low"
-approval_policy = "never"
-sandbox_mode = "workspace-write"
-
-[sandbox_workspace_write]
-network_access = true
-
-developer_instructions = '''
-你是 orchestrator 代理，负责协调 fixer 和 reviewer 以完成 PR 的修复与评审循环。
-'''