@seanyao/roll 2026.423.1 → 2026.424.2

package/bin/roll

@@ -4,7 +4,7 @@ set -euo pipefail
 # Roll — AI Agent Convention Manager
 # Single source of truth for how all AI coding agents behave.
 
-VERSION="2026.423.1"
+VERSION="2026.424.2"
 ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
 ROLL_CONFIG="${ROLL_HOME}/config.yaml"
 ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
@@ -235,6 +235,7 @@ ai_gemini: ~/.gemini|GEMINI.md|GEMINI.md
 ai_kimi: ~/.kimi|AGENTS.md|AGENTS.md
 ai_codex: ~/.codex|AGENTS.md|AGENTS.md
 ai_cursor: ~/.cursor|.cursor-rules|.cursor-rules
+ai_trae: ~/.trae|user_rules.md|project_rules.md
 ai_openclaw: ~/.openclaw/workspace|AGENTS.md|AGENTS.md
 
 # User preferences
@@ -350,7 +351,7 @@ _sync_convention_for_tool() {
   local main_dst="$2"  # target: ~/.claude/CLAUDE.md
   local force="$3"
 
-  [[ -f "$src" ]] || return
+  [[ -f "$src" ]] || return 0
   local dst_dir
   dst_dir="$(dirname "$main_dst")"
 
@@ -881,56 +882,6 @@ detect_project_type() {
   fi
 }
 
-# ─── Helper: detect AI tools from existing convention files ──────────────────
-detect_tools() {
-  local dir="$1"
-  local tools=""
-  [[ -f "$dir/.claude/CLAUDE.md" ]] && tools+="claude,"
-  [[ -f "$dir/GEMINI.md" ]] && tools+="gemini,"
-  [[ -f "$dir/.cursor-rules" ]] && tools+="cursor,"
-  echo "${tools%,}"
-}
-
-# ─── Helper: refresh a single project ────────────────────────────────────────
-refresh_project() {
-  local project_dir="$1"
-  local project_name
-  project_name="$(basename "$project_dir")"
-
-  local ptype
-  ptype="$(detect_project_type "$project_dir")"
-
-  if [[ "$ptype" == "unknown" ]]; then
-    warn "  ${BOLD}$project_name${NC}: cannot detect project type — skipping  无法检测项目类型 — 已跳过"
-    return 1
-  fi
-
-  local tools
-  tools="$(detect_tools "$project_dir")"
-
-  local tpl_dir="$ROLL_TEMPLATES/$ptype"
-  if [[ ! -d "$tpl_dir" ]]; then
-    warn "  ${BOLD}$project_name${NC}: template '$ptype' not found — skipping  模板 '$ptype' 未找到 — 已跳过"
-    return 1
-  fi
-
-  info "  ${BOLD}$project_name${NC} ($ptype | ${tools:-AGENTS.md only})  正在处理: ${BOLD}$project_name${NC}"
-
-  merge_convention "AGENTS.md" "$tpl_dir" "$project_dir" "  AGENTS.md"
-
-  if echo "$tools" | grep -q "claude"; then
-    mkdir -p "$project_dir/.claude"
-    merge_convention "CLAUDE.md" "$tpl_dir" "$project_dir/.claude" "  .claude/CLAUDE.md"
-  fi
-  if echo "$tools" | grep -q "gemini"; then
-    merge_convention "GEMINI.md" "$tpl_dir" "$project_dir" "  GEMINI.md"
-  fi
-  if echo "$tools" | grep -q "cursor"; then
-    merge_convention ".cursor-rules" "$tpl_dir" "$project_dir" "  .cursor-rules"
-  fi
-
-  return 0
-}
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # COMMAND: hooks <subcommand>
@@ -1043,7 +994,7 @@ cmd_status() {
 
   echo ""
   echo -e "${BOLD}Global conventions:  全局约定${NC}"
-  for f in AGENTS.md CLAUDE.md GEMINI.md .cursor-rules; do
+  for f in AGENTS.md CLAUDE.md GEMINI.md .cursor-rules project_rules.md; do
     if [[ -f "$ROLL_GLOBAL/$f" ]]; then
       echo -e "  ${GREEN}+${NC} $f"
     else

package/conventions/global/project_rules.md

@@ -0,0 +1,28 @@
+# Global Preferences — Trae IDE
+
+> Extends AGENTS.md in this directory — read that first for shared conventions.
+> This file adds Trae IDE-specific configuration only.
+
+## Identity
+
+- Git: `Sean Yao <sean.dlut@gmail.com>`
+- Default branch: `main`
+
+## Commit Message Format
+
+- Format: `<type>: <description>` (遵循 Git Hook 自动生成的前缀)
+- TCR micro-commits: `tcr: <description>` (No prefix)
+- Types: Story N, Fix, Refactor, Docs, Chore
+
+## Trae-Specific
+
+- When a project has Roll workflow, follow the AGENTS.md conventions and use Roll skills.
+- Use Solo mode for complex multi-step tasks.
+- Prefer targeted edits over full file rewrites.
+- For file operations, verify the file exists before modifying.
+
+## Frontend Default Stack
+
+- React + shadcn/ui + Tailwind CSS is the default.
+- Use shadcn/ui components first. Custom only when shadcn doesn't cover it.
+- Tailwind utility classes only. No inline styles, no CSS modules.

package/conventions/templates/backend-service/project_rules.md

@@ -0,0 +1,16 @@
+# Project Preferences — Backend Service (Trae IDE)
+
+> Extends global project_rules.md + project AGENTS.md.
+
+## Stack
+
+- Node.js / TypeScript / Express or Hono or Fastify
+- Database: Prisma or Drizzle ORM
+- Testing: Vitest + Supertest
+
+## Trae Notes
+
+- No frontend in this project. API-only service.
+- Write integration tests that hit real endpoints, not mocked handlers.
+- Run `npm run build && npm run test` before pushing.
+- Follow the project AGENTS.md for architecture constraints and Roll workflow.

package/conventions/templates/cli/project_rules.md

@@ -0,0 +1,16 @@
+# Project Preferences — CLI Tool (Trae IDE)
+
+> Extends global project_rules.md + project AGENTS.md.
+
+## Stack
+
+- Node.js / TypeScript
+- CLI framework: commander or citty
+- Testing: Vitest
+
+## Trae Notes
+
+- No server, no frontend. CLI tool only.
+- Test commands by running them, not just unit tests.
+- Run `npm run build && node dist/index.js --help` before pushing.
+- Follow the project AGENTS.md for architecture constraints and Roll workflow.

package/conventions/templates/frontend-only/project_rules.md

@@ -0,0 +1,14 @@
+# Project Preferences — Frontend Only (Trae IDE)
+
+> Extends global project_rules.md + project AGENTS.md.
+
+## Stack
+
+- React + shadcn/ui + Tailwind CSS + Vite
+- Testing: Vitest + Playwright
+
+## Trae Notes
+
+- No backend in this project. All data via external API consumption.
+- Run `npm run build` to verify production bundle compiles before pushing.
+- Follow the project AGENTS.md for architecture constraints and Roll workflow.

package/conventions/templates/fullstack/project_rules.md

@@ -0,0 +1,15 @@
+# Project Preferences — Fullstack Web (Trae IDE)
+
+> Extends global project_rules.md + project AGENTS.md.
+
+## Stack
+
+- Frontend: React + shadcn/ui + Tailwind CSS + Vite
+- Backend: Node.js API (Express/Hono/Fastify)
+- Testing: Vitest (unit) + Playwright (E2E)
+
+## Trae Notes
+
+- When modifying API contracts, update both `api/types.ts` and `src/shared/types/` in the same commit.
+- Run `npm run build` to verify both frontend and backend compile before pushing.
+- Follow the project AGENTS.md for architecture constraints and Roll workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanyao/roll",
-  "version": "2026.423.1",
+  "version": "2026.424.2",
   "description": "Roll — Roll out features with AI agents",
   "scripts": {
     "test": "find tests/unit tests/integration -name '*.bats' | sort | xargs ./tests/helpers/bats-core/bin/bats"