@seanyao/roll 2026.505.2 → 2026.506.1

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.505.2"
+VERSION="2026.506.1"
 ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
 ROLL_CONFIG="${ROLL_HOME}/config.yaml"
 ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
@@ -64,6 +64,29 @@ lower_name() {
   echo "$1" | tr '[:upper:]' '[:lower:]'
 }
 
+# Detect AI client by walking the process tree (innermost match wins).
+# Returns empty string if no known AI client is found.
+_detect_ai_client() {
+  local pid=$$ depth=0 cmd
+  while [[ "$pid" -gt 1 ]] && [[ "$depth" -lt 15 ]]; do
+    cmd=$(ps -p "$pid" -o comm= 2>/dev/null | tr '[:upper:]' '[:lower:]' || true)
+    case "$cmd" in
+      *opencode*) echo "opencode"; return ;;
+      *claude*)   echo "claude code"; return ;;
+      *kimi*)     echo "kimi cli"; return ;;
+      *gemini*)   echo "gemini cli"; return ;;
+      *codex*)    echo "codex"; return ;;
+      *cursor*)   echo "cursor"; return ;;
+    esac
+    local ppid
+    ppid=$(ps -p "$pid" -o ppid= 2>/dev/null | tr -d ' ' || true)
+    [[ "$ppid" == "$pid" ]] && break
+    pid=$ppid
+    depth=$((depth + 1))
+  done
+  echo ""
+}
+
 # Check if an AI tool is actually installed.
 # Most tools create their own config dir; Trae on macOS uses Library/Application Support
 # and expects roll to manage ~/.trae/ — so we detect via the app directory instead.
@@ -78,6 +101,10 @@ _is_ai_installed() {
       [[ -d "$HOME/.config/Trae" ]]
       return
       ;;
+    opencode)
+      [[ -x "$HOME/.opencode/bin/opencode" ]]
+      return
+      ;;
   esac
   return 1
 }
@@ -117,6 +144,7 @@ _ensure_config_entries() {
     "ai_codex:~/.codex|AGENTS.md|AGENTS.md"
     "ai_cursor:~/.cursor|.cursor-rules|.cursor-rules"
     "ai_trae:~/.trae|user_rules.md|project_rules.md"
+    "ai_opencode:~/.config/opencode|AGENTS.md|AGENTS.md"
     "ai_openclaw:~/.openclaw/workspace|AGENTS.md|AGENTS.md"
   )
 
@@ -328,6 +356,7 @@ 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_opencode: ~/.config/opencode|AGENTS.md|AGENTS.md
 ai_openclaw: ~/.openclaw/workspace|AGENTS.md|AGENTS.md
 
 # User preferences
@@ -572,25 +601,49 @@ _merge_global_to_project() {
 
   [[ -f "$src" ]] || { warn "Global AGENTS.md not found at ${src/#$HOME/~}"; return; }
 
+  # Detect project type — controls which sections are included
+  local project_type skip_frontend=false
+  project_type="$(scan_project_type_from_files "$project_dir")"
+  case "$project_type" in
+    cli|backend-service|unknown) skip_frontend=true ;;
+  esac
+
   if [[ ! -f "$dst" ]]; then
-    cp "$src" "$dst"
+    # Fresh create: write sections filtered by project type
+    local fc_h="" fc_b="" fc_pre=true fc_want=true
+    while IFS= read -r fc_line; do
+      if [[ "$fc_line" =~ ^##\  ]]; then
+        if [[ -n "$fc_h" && "$fc_want" == "true" ]]; then
+          printf '%s\n%s' "$fc_h" "$fc_b" >> "$dst"
+        fi
+        fc_h="$fc_line"; fc_b=""; fc_pre=false
+        fc_want=true
+        [[ "$skip_frontend" == "true" && "$fc_h" == "## 7. Frontend Default Stack" ]] && fc_want=false
+      elif [[ "$fc_pre" == "true" ]]; then
+        printf '%s\n' "$fc_line" >> "$dst"
+      else
+        fc_b+="$fc_line"$'\n'
+      fi
+    done < "$src"
+    if [[ -n "$fc_h" && "$fc_want" == "true" ]]; then
+      printf '%s\n%s' "$fc_h" "$fc_b" >> "$dst"
+    fi
     ok "Created: AGENTS.md"
     _ROLL_MERGE_SUMMARY+=("created|AGENTS.md")
     return
   fi
 
-  if diff -q "$src" "$dst" &>/dev/null; then
-    _ROLL_MERGE_SUMMARY+=("unchanged|AGENTS.md")
-    return
-  fi
-
   # Section-merge: append any ## sections from global missing in project
   local added=0 cur_h="" cur_b=""
   while IFS= read -r line; do
     if [[ "$line" =~ ^##\  ]]; then
       if [[ -n "$cur_h" ]] && ! grep -qF "$cur_h" "$dst" 2>/dev/null; then
-        printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$dst"
-        added=$((added + 1))
+        local skip_sec=false
+        [[ "$skip_frontend" == "true" && "$cur_h" == "## 7. Frontend Default Stack" ]] && skip_sec=true
+        if [[ "$skip_sec" == "false" ]]; then
+          printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$dst"
+          added=$((added + 1))
+        fi
       fi
       cur_h="$line"; cur_b=""
     elif [[ -n "$cur_h" ]]; then
@@ -598,8 +651,12 @@ _merge_global_to_project() {
     fi
   done < "$src"
   if [[ -n "$cur_h" ]] && ! grep -qF "$cur_h" "$dst" 2>/dev/null; then
-    printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$dst"
-    added=$((added + 1))
+    local skip_sec=false
+    [[ "$skip_frontend" == "true" && "$cur_h" == "## 7. Frontend Default Stack" ]] && skip_sec=true
+    if [[ "$skip_sec" == "false" ]]; then
+      printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$dst"
+      added=$((added + 1))
+    fi
   fi
 
   if [[ $added -gt 0 ]]; then
@@ -610,6 +667,52 @@ _merge_global_to_project() {
   fi
 }
 
+_merge_claude_to_project() {
+  local project_dir="$1"
+  local project_type
+  project_type="$(scan_project_type_from_files "$project_dir")"
+
+  local tpl_file="$ROLL_TEMPLATES/$project_type/CLAUDE.md"
+  [[ -f "$tpl_file" ]] || return 0  # No template for this project type
+
+  local claude_dir="$project_dir/.claude"
+  local out_file="$claude_dir/CLAUDE.md"
+
+  mkdir -p "$claude_dir"
+
+  if [[ ! -f "$out_file" ]]; then
+    cp "$tpl_file" "$out_file"
+    ok "Created: .claude/CLAUDE.md"
+    _ROLL_MERGE_SUMMARY+=("created|.claude/CLAUDE.md")
+    return
+  fi
+
+  # Append any ## sections from template missing in project file
+  local added=0 cur_h="" cur_b=""
+  while IFS= read -r line; do
+    if [[ "$line" =~ ^##\  ]]; then
+      if [[ -n "$cur_h" ]] && ! grep -qF "$cur_h" "$out_file" 2>/dev/null; then
+        printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$out_file"
+        added=$((added + 1))
+      fi
+      cur_h="$line"; cur_b=""
+    elif [[ -n "$cur_h" ]]; then
+      cur_b+="$line"$'\n'
+    fi
+  done < "$tpl_file"
+  if [[ -n "$cur_h" ]] && ! grep -qF "$cur_h" "$out_file" 2>/dev/null; then
+    printf '\n%s\n%s' "$cur_h" "$cur_b" >> "$out_file"
+    added=$((added + 1))
+  fi
+
+  if [[ $added -gt 0 ]]; then
+    ok "Merged: .claude/CLAUDE.md ($added new sections)"
+    _ROLL_MERGE_SUMMARY+=("merged|.claude/CLAUDE.md")
+  else
+    _ROLL_MERGE_SUMMARY+=("unchanged|.claude/CLAUDE.md")
+  fi
+}
+
 # ═══════════════════════════════════════════════════════════════════════════════
 # COMMAND: init
 # Initialize or re-merge a project. Always operates on the current directory.
@@ -633,9 +736,14 @@ cmd_init() {
   fi
 
   _merge_global_to_project "$project_dir"
+  _merge_claude_to_project "$project_dir"
   _write_backlog "$project_dir/BACKLOG.md"
   _ensure_features_dir "$project_dir/docs/features"
   print_merge_summary
+
+  echo ""
+  info "Syncing conventions to AI tools...  正在同步约定到 AI 工具..."
+  _sync_conventions
   echo ""
 
   if [[ "$has_agents" == "true" ]]; then
@@ -645,6 +753,7 @@ cmd_init() {
   fi
 }
 
+
 # ─── Helper: merge global preamble + template into output ────────────────────
 merge_convention() {
   local filename="$1"

package/conventions/templates/cli/CLAUDE.md

@@ -4,10 +4,9 @@
 
 ## Stack
 
-- Node.js / TypeScript
-- CLI framework: commander or citty
-- Testing: Vitest + execa (CLI integration tests)
-- Distribution: npm package with bin entry
+- Runtime / Language: {e.g. Node.js / TypeScript, Go, Python, Bash}
+- Test framework: {e.g. Vitest, pytest, bats}
+- Distribution: {e.g. npm, Homebrew, binary release}
 
 ## Claude Code Notes
 
@@ -15,4 +14,3 @@
 - Test commands by running them in Bash, not just unit tests.
 - Use `$roll-design` to plan command structure and options before implementation.
 - Verify `--help` output is clear and complete for each command.
-- Run `npm run build && node dist/index.js --help` before pushing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanyao/roll",
-  "version": "2026.505.2",
+  "version": "2026.506.1",
   "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"