@seanyao/roll 2026.506.1 → 2026.506.3

package/README.md

@@ -66,7 +66,7 @@ Unified behavioral conventions for Claude Code / Gemini CLI / Cursor / Codex —
 | `roll setup` | First-time install on this machine, or re-sync after editing `~/.roll/config.yaml` (use `--force` to overwrite local cache) |
 | `roll update` | One-step upgrade: `npm install -g @seanyao/roll@latest` + re-sync via `roll setup` |
 | `roll init` | New project: create `AGENTS.md` + `BACKLOG.md` + `docs/features/` |
-| `roll hook install` | Optional: global git hook that tags commits with the active AI client |
+
 | `roll status` | Show sync state, skill links, and detected AI tools |
 
 ### Typical Flow
@@ -83,8 +83,7 @@ roll init
 # 3. Upgrade to a new release
 roll update
 
-# 4. Optional: tag commits with AI client name
-roll hook install
+
 ```
 
 ### How Convention Layering Works

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.506.1"
+VERSION="2026.506.3"
 ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
 ROLL_CONFIG="${ROLL_HOME}/config.yaml"
 ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
@@ -64,28 +64,6 @@ 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
@@ -553,19 +531,6 @@ cmd_setup() {
   echo ""
   ok "Setup complete.  初始化完成。"
 
-  # Offer git hook install if not already installed (interactive terminals only)
-  local hook_dst="$HOME/.config/git/hooks/prepare-commit-msg"
-  local hooks_path
-  hooks_path=$(git config --global core.hooksPath 2>/dev/null || true)
-  if [[ -t 0 ]] && { [[ ! -f "$hook_dst" ]] || [[ "$hooks_path" != "$HOME/.config/git/hooks" ]]; }; then
-    echo ""
-    echo -n "  Install global git hook (tags commits with AI client)? [y/N] "
-    read -r _hook_ans
-    if [[ "${_hook_ans:-N}" =~ ^[Yy]$ ]]; then
-      cmd_hook install
-    fi
-  fi
-
   echo ""
   info "Next: run ${BOLD}roll init${NC} inside a project to initialize it.  下一步：在项目目录运行 roll init"
 }
@@ -1078,61 +1043,6 @@ detect_project_type() {
   fi
 }
 
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# COMMAND: hooks <subcommand>
-# Manage the global git hook (opt-in — modifies git global config)
-# ═══════════════════════════════════════════════════════════════════════════════
-cmd_hook() {
-  local subcmd="${1:-install}"
-
-  case "$subcmd" in
-    install)
-      local hooks_dir="$HOME/.config/git/hooks"
-      local hook_src="$ROLL_PKG_DIR/hooks/prepare-commit-msg"
-      local hook_dst="$hooks_dir/prepare-commit-msg"
-
-      if [[ ! -f "$hook_src" ]]; then
-        err "Hook source not found: $hook_src  Hook 源文件未找到: $hook_src"
-        exit 1
-      fi
-
-      local current_hooks_path
-      current_hooks_path=$(git config --global core.hooksPath 2>/dev/null || echo "(not set)")
-
-      echo ""
-      warn "This will modify your global git configuration:  此操作将修改您的全局 git 配置："
-      echo "  git config --global core.hooksPath $hooks_dir"
-      echo ""
-      echo "  Current value: $current_hooks_path  当前值: $current_hooks_path"
-      echo ""
-      if [[ "$current_hooks_path" != "(not set)" ]] && [[ "$current_hooks_path" != "$hooks_dir" ]]; then
-        warn "WARNING: Hooks at '$current_hooks_path' will stop running after this change.  警告：此更改后 '$current_hooks_path' 处的 hooks 将不再运行。"
-        echo ""
-      fi
-      echo -n "  Proceed? [y/N] "
-      read -r answer
-      [[ "$answer" =~ ^[Yy]$ ]] || { info "Aborted.  已取消。"; return; }
-
-      mkdir -p "$hooks_dir"
-      cp "$hook_src" "$hook_dst"
-      chmod +x "$hook_dst"
-      git config --global core.hooksPath "$hooks_dir"
-      ok "Global git hook installed (AI client auto-detected on every commit)  全局 git hook 已安装（每次提交自动检测 AI 客户端）"
-      ;;
-    remove)
-      git config --global --unset core.hooksPath 2>/dev/null && \
-        ok "Removed core.hooksPath from global git config  已从全局 git 配置中移除 core.hooksPath" || \
-        info "core.hooksPath was not set  core.hooksPath 未设置"
-      ;;
-    *)
-      err "Unknown hooks subcommand: $subcmd  未知 hooks 子命令: $subcmd"
-      echo "Usage: roll hook [install|remove]  用法: roll hook [install|remove]"
-      exit 1
-      ;;
-  esac
-}
-
 # ═══════════════════════════════════════════════════════════════════════════════
 # COMMAND: status
 # Show current state of conventions
@@ -1239,20 +1149,6 @@ cmd_status() {
     warn "No AI tools configured — check ~/.roll/config.yaml  未配置 AI 工具 — 请检查 ~/.roll/config.yaml"
   fi
 
-  echo ""
-  echo -e "${BOLD}Git hook:  Git Hook${NC}"
-  local hook_dst="$HOME/.config/git/hooks/prepare-commit-msg"
-  local hooks_path
-  hooks_path=$(git config --global core.hooksPath 2>/dev/null || true)
-  if [[ -f "$hook_dst" ]] && [[ "$hooks_path" == "$HOME/.config/git/hooks" ]]; then
-    echo -e "  ${GREEN}+${NC} prepare-commit-msg (global, AI client auto-detect / 全局，自动检测 AI 客户端)"
-  elif [[ -f "$hook_dst" ]]; then
-    echo -e "  ${YELLOW}~${NC} prepare-commit-msg exists but core.hooksPath not set  prepare-commit-msg 已存在，但 core.hooksPath 未设置"
-    echo -e "      run: roll hook install  运行: roll hook install"
-  else
-    echo -e "  ${RED}-${NC} not installed (optional) — run 'roll hook install'  未安装（可选）— 运行 'roll hook install'"
-  fi
-
   echo ""
   echo -e "${BOLD}Templates:  模板${NC}"
   for tpl in fullstack frontend-only backend-service cli; do
@@ -1311,14 +1207,13 @@ usage() {
   echo "  setup [-f]             [Machine] First-time install or re-sync             首次安装或重新同步"
   echo "  update                 [Upgrade] npm install latest + re-sync             一键升级到最新版"
   echo "  init                   [Project] Create AGENTS.md + BACKLOG.md + docs/     初始化项目工作流文件"
-  echo "  hook [install|remove]  [Optional] Manage global git hook                  管理全局 git hook"
   echo "  status                 [Diagnostic] Show current state                    显示当前状态"
   echo ""
   echo "Examples / 示例:"
   echo "  roll setup                    # New machine: first-time install            新机器首次安装"
   echo "  roll update                   # Upgrade to latest version + re-sync         升级到最新版并重新同步"
   echo "  roll init                     # New or re-merge project (run in project)   新建或重新合并（项目目录）"
-  echo "  roll hook install             # Optional: tag commits with AI client       可选：提交时标记 AI 工具"
+
 }
 
 main() {
@@ -1329,7 +1224,6 @@ main() {
     setup)         cmd_setup "$@" ;;
     update)        cmd_update "$@" ;;
     init)          cmd_init "$@" ;;
-    hook)          cmd_hook "$@" ;;
     status)        cmd_status "$@" ;;
     version|--version|-v) echo "roll v${VERSION}" ;;
     help|--help|-h|"") usage ;;

package/conventions/global/AGENTS.md

@@ -30,6 +30,10 @@
 - **Testing**: Unit >80%. E2E for flows. No DB mocks.
 
 ## 4. Workflow
+- **Scope Gate**: Only implement what is explicitly listed in the AC. Nothing more.
+  - Requests made in conversation are NOT AC — capture with `roll-jot` first.
+  - Any new Story/Fix requires design doc + user confirmation before TCR starts.
+  - Do not commit without user approval unless explicitly told to auto-commit.
 - **TCR**: Test -> Green = Commit / Red = Revert. No WIP commits.
   - Before implementing: confirm exact files, test strategy, and commit message
     draft with user. Do not write code until approved.

package/package.json

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