@seanyao/roll 2026.421.3 → 2026.421.5

package/README.md

@@ -70,7 +70,6 @@ Unified behavioral conventions for Claude Code / Gemini CLI / Cursor / Codex —
 | `roll hook install` | Optional: global git hook for AI client auto-detection |
 | `roll reset` | Force-rebuild local cache from repo source, then re-sync |
 | `roll status` | Show sync state, skill links, and detected AI tools |
-| `roll clean` | Remove legacy `~/.wukong/` or `~/.cybernetix/` remnants |
 
 ### Typical Flow
 
@@ -142,6 +141,7 @@ Research → Design → Build → Check → Fix → (loop)
 | Deep research (product / company / tech) | `$roll-research "subject"` |
 | Patrol production for regressions | `$roll-sentinel patrol` |
 | Debug a broken page | `$roll-debug <URL>` |
+| Record a dev moment / diary entry | `$roll-notes "just fixed that nasty bug"` |
 
 ### Full Skill List
 
@@ -161,6 +161,7 @@ Research → Design → Build → Check → Fix → (loop)
 | `$roll-.changelog` | Support | Auto-generate CHANGELOG from BACKLOG |
 | `$roll-.echo` | Support | Passive intent clarification |
 | `$roll-.clarify` | Support | Passive scope clarification for vague build requests |
+| `$roll-notes` | Support | Project diary — append dev moments to `notes/YYYY-MM-DD.md` |
 
 ---
 

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.421.3"
+VERSION="2026.421.5"
 ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
 ROLL_CONFIG="${ROLL_HOME}/config.yaml"
 ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
@@ -250,8 +250,8 @@ YAML
 # ─── Internal: create or repair per-skill symlinks (non-destructive) ─────────
 _link_skills() {
   local force="${1:-false}"
-  local wk_skills_real pkg_skills_real
-  wk_skills_real="$(canonical_dir "$ROLL_HOME/skills" 2>/dev/null || true)"
+  local roll_skills_real pkg_skills_real
+  roll_skills_real="$(canonical_dir "$ROLL_HOME/skills" 2>/dev/null || true)"
   pkg_skills_real="$(canonical_dir "$ROLL_PKG_DIR/skills" 2>/dev/null || true)"
 
   while IFS= read -r entry; do
@@ -279,17 +279,15 @@ _link_skills() {
       continue
     fi
 
-    # Handle legacy whole-dir symlink
+    # Handle whole-dir symlink (legacy or user-created)
     if [[ -L "$skills_dir" ]]; then
       local skills_target
       skills_target="$(readlink "$skills_dir")"
-      if [[ -n "$skills_real" && "$skills_real" == "$wk_skills_real" ]]; then
-        continue  # Whole-dir symlink to WK skills — still functional
+      if [[ -n "$skills_real" && "$skills_real" == "$roll_skills_real" ]]; then
+        continue  # Whole-dir symlink to ~/.roll/skills — still functional
       fi
-      # Dangling or legacy whole-dir symlink — remove and recreate as per-skill links
-      if [[ -z "$skills_real" ]] || \
-         [[ "$skills_target" == *"cybernetix"* ]] || \
-         [[ "$skills_target" == *"wukong"* ]]; then
+      # Dangling whole-dir symlink — remove and recreate as per-skill links
+      if [[ -z "$skills_real" ]]; then
         info "Removing legacy symlink ~/${ai_name}/skills -> ${skills_target/#$HOME/~}  正在移除遗留软链接 ~/${ai_name}/skills -> ${skills_target/#$HOME/~}"
         rm "$skills_dir"
       else
@@ -1028,104 +1026,6 @@ cmd_update() {
   cmd_sync
 }
 
-# ═══════════════════════════════════════════════════════════════════════════════
-# COMMAND: clean
-# Remove legacy ~/.cybernetix/ and ~/.wukong/ remnants after migration
-# ═══════════════════════════════════════════════════════════════════════════════
-cmd_clean() {
-  local found=false
-
-  echo -e "${BOLD}Roll Legacy Cleanup  清理旧版遗留文件${NC}"
-  echo ""
-
-  # Detect what exists
-  for legacy_dir in "$HOME/.cybernetix" "$HOME/.wukong"; do
-    [[ -d "$legacy_dir" ]] && found=true
-  done
-  for legacy_bin in "$HOME/.local/bin/cybernetix" "$HOME/.local/bin/wukong"; do
-    { [[ -L "$legacy_bin" ]] || [[ -f "$legacy_bin" ]]; } && found=true
-  done
-  # Old skill symlinks
-  local ai_dirs=("$HOME/.claude" "$HOME/.gemini" "$HOME/.kimi" "$HOME/.codex" "$HOME/.cursor")
-  for ai_dir in "${ai_dirs[@]}"; do
-    local skills_dir="$ai_dir/skills"
-    [[ -d "$skills_dir" ]] || continue
-    if find "$skills_dir" -maxdepth 1 -type l \( -name "wk-*" -o -name "cnx-*" \) 2>/dev/null | grep -q .; then
-      found=true
-    fi
-  done
-
-  if [[ "$found" == "false" ]]; then
-    ok "Nothing to clean — no legacy files found.  未发现遗留文件。"
-    return
-  fi
-
-  # Show what will be removed
-  info "Found legacy items to remove:  发现以下遗留文件："
-  echo ""
-  for d in "$HOME/.cybernetix" "$HOME/.wukong"; do
-    [[ -d "$d" ]] && echo -e "  ${RED}✕${NC} ${d/#$HOME/~}/"
-  done
-  for b in "$HOME/.local/bin/cybernetix" "$HOME/.local/bin/wukong"; do
-    { [[ -L "$b" ]] || [[ -f "$b" ]]; } && echo -e "  ${RED}✕${NC} ${b/#$HOME/~}"
-  done
-  for ai_dir in "${ai_dirs[@]}"; do
-    local skills_dir="$ai_dir/skills"
-    [[ -d "$skills_dir" ]] || continue
-    local old_links
-    old_links=$(find "$skills_dir" -maxdepth 1 -type l \( -name "wk-*" -o -name "cnx-*" \) 2>/dev/null || true)
-    if [[ -n "$old_links" ]]; then
-      local count
-      count=$(echo "$old_links" | wc -l | tr -d ' ')
-      echo -e "  ${RED}✕${NC} ${skills_dir/#$HOME/~}/ ($count legacy symlinks)"
-    fi
-  done
-
-  echo ""
-  echo -n "  Remove all of the above? [y/N] "
-  read -r answer
-  [[ "$answer" =~ ^[Yy]$ ]] || { info "Aborted.  已取消。"; return; }
-
-  echo ""
-  local removed=0
-
-  # Remove legacy home dirs
-  for d in "$HOME/.cybernetix" "$HOME/.wukong"; do
-    if [[ -d "$d" ]]; then
-      rm -rf "$d"
-      ok "Removed: ${d/#$HOME/~}  已删除: ${d/#$HOME/~}"
-      removed=$((removed + 1))
-    fi
-  done
-
-  # Remove legacy binaries
-  for b in "$HOME/.local/bin/cybernetix" "$HOME/.local/bin/wukong"; do
-    if [[ -L "$b" ]] || [[ -f "$b" ]]; then
-      rm -f "$b"
-      ok "Removed: ${b/#$HOME/~}  已删除: ${b/#$HOME/~}"
-      removed=$((removed + 1))
-    fi
-  done
-
-  # Remove legacy skill symlinks
-  for ai_dir in "${ai_dirs[@]}"; do
-    local skills_dir="$ai_dir/skills"
-    [[ -d "$skills_dir" ]] || continue
-    local old_links
-    old_links=$(find "$skills_dir" -maxdepth 1 -type l \( -name "wk-*" -o -name "cnx-*" \) 2>/dev/null || true)
-    if [[ -n "$old_links" ]]; then
-      while IFS= read -r link; do rm -f "$link"; done <<< "$old_links"
-      local count
-      count=$(echo "$old_links" | wc -l | tr -d ' ')
-      ok "Removed $count legacy symlinks from ${skills_dir/#$HOME/~}  已删除 $count 个遗留软链接"
-      removed=$((removed + count))
-    fi
-  done
-
-  echo ""
-  ok "Cleaned $removed legacy items.  已清理 $removed 个遗留文件。"
-}
-
 # ═══════════════════════════════════════════════════════════════════════════════
 # COMMAND: status
 # Show current state of conventions
@@ -1308,7 +1208,6 @@ usage() {
   echo "  hook [install|remove]  [Optional] Manage global git hook                  管理全局 git hook"
   echo "  status                 [Diagnostic] Show current state                    显示当前状态"
   echo "  reset                  [Recovery] Force-rebuild from package source        强制从包源重建"
-  echo "  clean                  [Legacy] Remove ~/.wukong/ ~/.cybernetix/ remnants  清理遗留文件"
   echo ""
   echo "Examples / 示例:"
   echo "  roll setup                    # New machine: first-time install             新机器：首次安装"
@@ -1328,7 +1227,6 @@ main() {
     hook)         cmd_hook "$@" ;;
     update)        cmd_update "$@" ;;
     reset)         cmd_reset "$@" ;;
-    clean)         cmd_clean "$@" ;;
     status)        cmd_status "$@" ;;
     version|--version|-v) echo "roll v${VERSION}" ;;
     help|--help|-h|"") usage ;;

package/package.json

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

package/skills/roll-notes/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: roll-notes
+description: "Project diary skill. Records development moments — successes, failures, discoveries — appended chronologically to a daily notes file."
+---
+
+# roll-notes
+
+> 项目日记技能。记录开发过程中的成功、失败、感受和任何值得记住的事情。
+> Append-only, timeline-driven, no fixed format.
+
+## Trigger
+
+- User says "记一下"、"写进日记"、"append 到日记"
+- User asks to record a feeling, finding, or moment
+- A project milestone is reached and worth capturing
+
+```
+$roll-notes 终于搞定了那个 WebSocket 断线重连的 bug
+$roll-notes 今天的 code review 给了很好的反馈
+```
+
+## Behavior
+
+1. **Determine file path**: `notes/YYYY-MM-DD.md` relative to project root
+2. **Get current time**: Use `Asia/Shanghai` timezone (`TZ=Asia/Shanghai date`)
+3. **Append**: Add new entry at end of file — never overwrite existing content
+4. **Create if missing**: If file doesn't exist, create with a `# YYYY-MM-DD — <one-line summary>` header
+5. **Free format**: Paragraph, list, code block — whatever fits the moment
+
+## File format
+
+```markdown
+# YYYY-MM-DD — 一句话概括今天
+
+> 时间：北京时间 HH:MM
+
+---
+
+## HH:MM — 事件标题
+
+发生了什么、怎么解决的、什么感受。
+
+---
+
+## HH:MM — 另一个事件
+
+...
+```
+
+## Rules
+
+- **No planning**: Never write "明日待办" or "下一步"
+- **No summaries**: Never write "今日收获" or "经验教训"
+- **Pure record**: What happened, as-is — honest, immediate, rough is fine
+- **Append freely**: Multiple entries per day is normal
+
+## File location
+
+```
+notes/
+  └── YYYY-MM-DD.md
+```

package/skills/roll-research/SKILL.md

@@ -196,7 +196,7 @@ After the report is complete, use this skill's included `scripts/md_to_pdf.py` t
 2. **Install dependencies** (if not installed): `pip install weasyprint markdown --break-system-packages`
 3. **Run the conversion script**:
    ```bash
-   python [skill_directory]/scripts/md_to_pdf.py input.md output.pdf --title "Subject Name" --author "wukong"
+  python [skill_directory]/scripts/md_to_pdf.py input.md output.pdf --title "Subject Name" --author "roll"
    ```
 4. The script automatically generates an intermediate HTML file (for debugging) and the final PDF
 

package/tools/roll-probe/SKILL.md

@@ -1,84 +0,0 @@
----
-hidden: true
-name: roll-probe
-description: Node discovery and health check for Roll environment. Find machines on LAN by name, check node health, verify OpenClaw Gateway status. Use when user asks to find a machine, check node status, diagnose gateway issues, or verify node connectivity.
----
-
-# Roll Probe
-
-**Node discovery and health check tool** - for node management and status diagnosis in Roll environments.
-
-## Capabilities
-
-1. **Node Discovery** - Discover machines on LAN
-   - Discover SSH services via Bonjour/mDNS
-   - Resolve `.local` hostnames
-   - Supports aliases: orin, seanclaw, apeclaw
-
-2. **Node Health Check** - Check node health
-   - OpenClaw Gateway process status
-   - Port listening check
-   - Health endpoint verification
-   - Log viewing
-
-## Usage
-
-```bash
-# Discover machines
-$roll-checker find <machine-name>
-
-# Check node health
-$roll-checker health <hostname>
-
-# Full diagnosis
-$roll-checker diagnose <machine-name>
-```
-
-## Node Discovery
-
-Uses Bonjour `_ssh._tcp` service discovery:
-
-```bash
-# Browse all SSH services
-dns-sd -B _ssh._tcp local
-
-# Resolve a specific service
-dns-sd -L "Sean's Claw Machine" _ssh._tcp local
-dns-sd -G v4v6 Seans-Claw-Machine.local
-```
-
-**Known aliases**:
-- `orin` / `nv-orin` → nv-orin.local
-- `seanclaw` → Seans-Claw-Machine.local
-- `apeclaw` → Ape's Claw Machine
-
-## Health Check
-
-Check procedure for Orin/OpenClaw hosts:
-
-```bash
-# 1. Identity verification
-ssh -o BatchMode=yes -o ConnectTimeout=10 nvidia@nv-orin.local 'hostname && whoami'
-
-# 2. Process check
-ps -ef | grep -i "openclaw\|gateway" | grep -v grep
-
-# 3. Port check
-ss -ltnp | grep -E "18789|18791|18792"
-
-# 4. Health endpoint
-for p in 18789 18791 18792; do
-  curl -fsS http://127.0.0.1:$p/health || true
-done
-```
-
-## Dynamic Host Resolution
-
-Priority order:
-1. `nvidia@nv-orin.local` (Bonjour hostname)
-2. Current `.local` hostname (via discovery)
-3. Current IP (via discovery)
-
-## References
-
-- `scripts/find_ssh_machine.py` - SSH machine discovery script