@seanyao/roll 2026.523.2 → 2026.524.2

package/lib/changelog_audit.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python3
+"""FIX-113: changelog audit — list PRs merged to main since the latest
+release tag that don't appear in CHANGELOG.md's ## Unreleased section.
+
+Run before `release.sh` so missing entries surface BEFORE the AI rewrite
+gets a chance to silently drop them.
+
+Usage:
+  python3 lib/changelog_audit.py                # report missing
+  python3 lib/changelog_audit.py --since v2026.520.1
+  python3 lib/changelog_audit.py --json         # machine-readable
+
+Exit 0 always (read-only audit). Output:
+  - "audit ok" + no missing list when CHANGELOG covers every merged PR
+  - "audit found N PR(s) without a CHANGELOG entry:" + list otherwise
+"""
+from __future__ import annotations
+import argparse, json, re, subprocess, sys
+from pathlib import Path
+
+PR_RE = re.compile(r"\(#(\d+)\)")
+SQUASH_RE = re.compile(r"^([a-z0-9]{7,40})\s+(.*?)\s*\(#(\d+)\)\s*$")
+
+# Heuristic: PR titles whose first token is one of these tags are usually
+# user-visible (need CHANGELOG entry). Tags like "chore:", "docs:" still
+# warrant a docs section entry; left to user judgement.
+USER_VISIBLE_PATTERNS = (
+    re.compile(r"\b(US-[A-Z0-9-]+-\d+)\b"),
+    re.compile(r"\b(FIX-\d+)\b"),
+    re.compile(r"\b(REFACTOR-\d+)\b"),
+)
+
+def _latest_tag() -> str:
+    """Return the most recent v* tag, or empty string if none."""
+    try:
+        out = subprocess.check_output(
+            ["git", "tag", "--list", "v*", "--sort=-creatordate"],
+            text=True, stderr=subprocess.DEVNULL,
+        ).strip()
+        for line in out.splitlines():
+            if line:
+                return line
+    except Exception:
+        pass
+    return ""
+
+def _merged_prs_since(since: str):
+    """Return list of (sha, subject, pr_number) for first-parent merges
+    on main between <since> and HEAD."""
+    cmd = ["git", "log", "--first-parent", "--oneline"]
+    if since:
+        cmd.append(f"{since}..HEAD")
+    try:
+        out = subprocess.check_output(cmd, text=True, stderr=subprocess.DEVNULL)
+    except Exception:
+        return []
+    rows = []
+    for line in out.splitlines():
+        m = SQUASH_RE.match(line)
+        if not m:
+            # Older "Merge pull request #N from <branch>" format
+            m2 = re.match(r"^([a-f0-9]{7,40})\s+Merge pull request #(\d+) from .*$", line)
+            if m2:
+                rows.append((m2.group(1), line.split(None, 1)[1], int(m2.group(2))))
+                continue
+            # Also look for parenthesized #N anywhere in subject
+            m3 = re.match(r"^([a-f0-9]{7,40})\s+(.*)$", line)
+            if m3:
+                pr_match = PR_RE.search(m3.group(2))
+                if pr_match:
+                    rows.append((m3.group(1), m3.group(2), int(pr_match.group(1))))
+            continue
+        rows.append((m.group(1), m.group(2), int(m.group(3))))
+    return rows
+
+def _read_unreleased_section(changelog: Path) -> str:
+    """Return the text of the ## Unreleased section (or empty string)."""
+    if not changelog.exists():
+        return ""
+    text = changelog.read_text(errors="ignore")
+    m = re.search(r"^## Unreleased\s*\n(.*?)(?=^## |\Z)", text, re.MULTILINE | re.DOTALL)
+    return m.group(1) if m else ""
+
+def _is_in_changelog(subject: str, unreleased_text: str) -> bool:
+    """A PR is considered covered if any story id from its subject appears in
+    the Unreleased section text."""
+    for pat in USER_VISIBLE_PATTERNS:
+        for m in pat.finditer(subject):
+            sid = m.group(1)
+            if sid in unreleased_text:
+                return True
+    # Fallback: PR number explicit mention
+    pr_m = PR_RE.search(subject)
+    if pr_m and f"#{pr_m.group(1)}" in unreleased_text:
+        return True
+    return False
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--since", default="", help="Compare against this tag (default: latest v* tag)")
+    ap.add_argument("--changelog", default="CHANGELOG.md")
+    ap.add_argument("--json", action="store_true", help="Machine-readable output")
+    args = ap.parse_args()
+
+    since = args.since or _latest_tag()
+    prs = _merged_prs_since(since)
+    cl = _read_unreleased_section(Path(args.changelog))
+
+    missing = []
+    skipped_internal = []
+    for sha, subject, pr_n in prs:
+        # Skip merges that are themselves releases
+        if subject.startswith("[release]") or subject.startswith("[ release]"):
+            continue
+        if _is_in_changelog(subject, cl):
+            continue
+        # Heuristic: subjects that don't contain a story id and start with
+        # internal-only tags (chore: backlog ..., chore: rebase, etc.) are
+        # marked as "internal", less likely to need user-facing entry.
+        is_user_visible = any(p.search(subject) for p in USER_VISIBLE_PATTERNS)
+        if is_user_visible:
+            missing.append({"pr": pr_n, "sha": sha, "subject": subject})
+        else:
+            skipped_internal.append({"pr": pr_n, "sha": sha, "subject": subject})
+
+    if args.json:
+        json.dump({
+            "since": since,
+            "total_prs": len(prs),
+            "missing_user_visible": missing,
+            "skipped_internal": skipped_internal,
+        }, sys.stdout, indent=2, ensure_ascii=False)
+        print()
+        return 0
+
+    print(f"changelog audit  since={since or '(no tag)'}  scanned {len(prs)} PR(s)")
+    print()
+    if not missing:
+        print(f"  ✓ audit ok — every user-visible PR is mentioned in CHANGELOG.md Unreleased")
+        if skipped_internal:
+            print(f"  · {len(skipped_internal)} internal/infra PR(s) skipped from audit")
+        return 0
+
+    print(f"  ⚠ {len(missing)} user-visible PR(s) without a CHANGELOG entry:")
+    for m in missing:
+        print(f"    #{m['pr']}  {m['subject']}")
+    print()
+    print("  Add bullets under '## Unreleased' in CHANGELOG.md before release,")
+    print("  or confirm these PRs are intentionally undocumented (rare).")
+    if skipped_internal:
+        print(f"  ({len(skipped_internal)} internal PR(s) skipped from audit)")
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

package/lib/i18n/doctor.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — doctor command (US-I18N-002).
+
+_i18n_set en doctor.stale_plists "Stale launchd plists"
+_i18n_set zh doctor.stale_plists "无效的 launchd 服务"
+_i18n_set en doctor.stale_plists_cleanup "Path is stale, clean up with"
+_i18n_set zh doctor.stale_plists_cleanup "路径已失效，可清理"
+
+_i18n_set en doctor.pr_review_extras "PR review extras"
+_i18n_set zh doctor.pr_review_extras "PR 评审两档开关"
+
+_i18n_set en doctor.pr_double_gate_enabled "✅ AI review double gate enabled"
+_i18n_set zh doctor.pr_double_gate_enabled "✅ AI 评审双门已启用"
+_i18n_set en doctor.pr_double_gate_disabled "⚪ AI review double gate not enabled"
+_i18n_set zh doctor.pr_double_gate_disabled "⚪ 双门未启用"
+_i18n_set en doctor.pr_double_gate_unknown "⚪ AI review double gate state unknown — requires gh auth"
+_i18n_set zh doctor.pr_double_gate_unknown "⚪ 状态未知（需要 gh auth）"
+
+_i18n_set en doctor.pr_event_enabled "✅ Event-driven PR review installed"
+_i18n_set zh doctor.pr_event_enabled "✅ 事件驱动 PR 评审已安装"
+_i18n_set en doctor.pr_event_disabled "⚪ Event-driven PR review not installed"
+_i18n_set zh doctor.pr_event_disabled "⚪ 事件驱动 PR 评审未安装"
+
+_i18n_set en doctor.pr_event_optional "Optional — enable event-driven PR review (seconds-fast, GitHub only)."
+_i18n_set zh doctor.pr_event_optional "可选 —— 启用事件驱动 PR 评审（秒级响应，仅限 GitHub）。"
+_i18n_set en doctor.pr_event_without "Without this, Roll reviews PRs each loop cycle (~1h). With it,"
+_i18n_set zh doctor.pr_event_without "不安装也行 — loop 每轮会兜底评审。安装后"
+_i18n_set en doctor.pr_event_without_zh "contributors get AI feedback on PR open/update immediately."
+_i18n_set zh doctor.pr_event_without_zh "PR 一开即触发 AI 评审。"
+_i18n_set en doctor.pr_event_secret "Then set the API key secret for your configured agent in GitHub repo settings."
+_i18n_set zh doctor.pr_event_secret "然后在 GitHub 仓库设置中添加你配置的 agent 对应的 API key secret。"

package/lib/i18n/init.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — init command (US-I18N-002).
+
+_i18n_set en init.onboard_cancelled "Onboard cancelled (Ctrl-C)."
+_i18n_set zh init.onboard_cancelled "Onboard 已取消（Ctrl-C）。"
+_i18n_set en init.onboard_agent_exited "Agent '%s' exited with code %s."
+_i18n_set zh init.onboard_agent_exited "agent '%s' 异常退出 (code %s)。"
+_i18n_set en init.onboard_next_step "Next step  下一步:"
+_i18n_set zh init.onboard_next_step "下一步  Next step:"
+_i18n_set en init.onboard_retry "retry the same agent:   roll init"
+_i18n_set zh init.onboard_retry "再试一次同一个 agent:  roll init"
+_i18n_set en init.onboard_retry_en "retry the same agent:   roll init"
+_i18n_set zh init.onboard_retry_en "retry the same agent:   roll init"
+_i18n_set en init.onboard_switch "switch to another:      ROLL_ONBOARD_AGENT=<name> roll init"
+_i18n_set zh init.onboard_switch "换一个 agent:           ROLL_ONBOARD_AGENT=<name> roll init"
+_i18n_set en init.onboard_switch_en "switch to another:      ROLL_ONBOARD_AGENT=<name> roll init"
+_i18n_set zh init.onboard_switch_en "switch to another:      ROLL_ONBOARD_AGENT=<name> roll init"

package/lib/i18n/offboard.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — offboard command (US-I18N-002).
+
+_i18n_set en offboard.no_changeset_en "No onboard changeset found at .roll/onboard-changeset.yaml"
+_i18n_set zh offboard.no_changeset_en "No onboard changeset found at .roll/onboard-changeset.yaml"
+_i18n_set en offboard.no_changeset_zh "未找到 onboard 变更清单 .roll/onboard-changeset.yaml"
+_i18n_set zh offboard.no_changeset_zh "未找到 onboard 变更清单 .roll/onboard-changeset.yaml"
+_i18n_set en offboard.manual_offboard "Manual offboard — remove these by hand if they came from Roll:"
+_i18n_set zh offboard.manual_offboard "手动清理——如果这些文件来自 Roll，请手动删除:"
+_i18n_set en offboard.manual_rm_roll "rm -rf .roll/                  # all process artefacts"
+_i18n_set zh offboard.manual_rm_roll "rm -rf .roll/                  # 所有过程文件"
+_i18n_set en offboard.manual_rm_agents "rm -f AGENTS.md CLAUDE.md      # only if they were generated by roll init"
+_i18n_set zh offboard.manual_rm_agents "rm -f AGENTS.md CLAUDE.md      # 仅当这些文件由 roll init 生成"
+_i18n_set en offboard.manual_edit_gitignore "Edit .gitignore to remove any '.roll/' entry"
+_i18n_set zh offboard.manual_edit_gitignore "编辑 .gitignore 移除 '.roll/' 条目"

package/lib/i18n/shared.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — shared / common messages (US-I18N-002).
+# Sourced by lib/i18n.sh. Fill with _i18n_set.
+
+# ── update notification ──
+_i18n_set en update.available "v%s available — run 'roll update' to upgrade"
+_i18n_set zh update.available "有新版本 v%s — 运行 'roll update' 升级"
+
+# ── changelog heading ──
+_i18n_set en changelog.heading "Recent Changes"
+_i18n_set zh changelog.heading "最近更新"
+
+# ── init: onboard agent ──
+_i18n_set en init.onboard_retry "retry the same agent:   roll init"
+_i18n_set zh init.onboard_retry "再试一次同一个 agent:  roll init"
+_i18n_set en init.onboard_switch "switch to another:      ROLL_ONBOARD_AGENT=<name> roll init"
+_i18n_set zh init.onboard_switch "换一个 agent:           ROLL_ONBOARD_AGENT=<name> roll init"
+
+# ── migrate ──
+_i18n_set en migrate.tips.inspect "Inspect the migration commit"
+_i18n_set zh migrate.tips.inspect "查看迁移提交"
+_i18n_set en migrate.tips.verify "Verify new structure"
+_i18n_set zh migrate.tips.verify "验证新结构"
+
+# ── peer help ──
+_i18n_set en peer.help.from "Originating agent"
+_i18n_set zh peer.help.from "发起方"
+_i18n_set en peer.help.to "Target peer (auto-detected if omitted)"
+_i18n_set zh peer.help.to "对端 peer（省略则自动选择）"
+_i18n_set en peer.help.round "Current round (default: 1)"
+_i18n_set zh peer.help.round "当前轮数"
+_i18n_set en peer.help.tag "Task type for routing (architecture, security, test...)"
+_i18n_set zh peer.help.tag "任务类型"
+_i18n_set en peer.help.context "Context file to send to peer"
+_i18n_set zh peer.help.context "上下文文件"
+_i18n_set en peer.help.yes "Skip opt-out prompt"
+_i18n_set zh peer.help.yes "跳过确认提示"
+_i18n_set en peer.help.status_cmd "Show peer review state"
+_i18n_set zh peer.help.status_cmd "显示状态"
+
+# ── agent ──
+_i18n_set en agent.use_hint "roll agent use <name>   — switch agent for this project"
+_i18n_set zh agent.use_hint "roll agent use <name>   — 切换此项目的 agent"
+_i18n_set en agent.list_hint "roll agent list         — show installed agents"
+_i18n_set zh agent.list_hint "roll agent list         — 查看已安装的 agent"
+
+# ── offboard ──
+_i18n_set en offboard.manual_rm_agents "rm -f AGENTS.md CLAUDE.md      # only if they were generated by roll init"
+_i18n_set zh offboard.manual_rm_agents "rm -f AGENTS.md CLAUDE.md      # 仅当这些文件由 roll init 生成"
+_i18n_set en offboard.manual_rm_roll "rm -rf .roll/                  # all process artefacts"
+_i18n_set zh offboard.manual_rm_roll "rm -rf .roll/                  # 所有过程文件"
+_i18n_set en offboard.manual_edit_gitignore "Edit .gitignore to remove any '.roll/' entry"
+_i18n_set zh offboard.manual_edit_gitignore "编辑 .gitignore 移除 '.roll/' 条目"
+
+# ── doctor ──
+_i18n_set en doctor.stale_plists "Stale launchd plists"
+_i18n_set zh doctor.stale_plists "无效的 launchd 服务"
+_i18n_set en doctor.stale_plists_path "Path no longer valid, clean up with:"
+_i18n_set zh doctor.stale_plists_path "路径已失效，可清理:"
+
+# ── check_structure (US-ONBOARD-004) ──
+_i18n_set en check_structure.detected "Legacy structure detected at: %s"
+_i18n_set zh check_structure.detected "发现老结构目录: %s"
+_i18n_set en check_structure.pre_2_0_layout "This project uses the pre-2.0 layout (BACKLOG.md / docs/*). Roll 2.0 requires"
+_i18n_set zh check_structure.pre_2_0_layout "此项目使用 2.0 之前的老结构 (BACKLOG.md / docs/*)。Roll 2.0 要求"
+_i18n_set en check_structure.run_migration "process artifacts to live in .roll/. Run the migration to upgrade:"
+_i18n_set zh check_structure.run_migration "过程文件放在 .roll/ 下。运行迁移命令升级:"
+_i18n_set en check_structure.preview_changes "# Preview changes"
+_i18n_set zh check_structure.preview_changes "# 预览变更"
+_i18n_set en check_structure.execute "# Execute (single atomic commit)"
+_i18n_set zh check_structure.execute "# 执行（单次原子提交）"
+_i18n_set en check_structure.migration_guide "Migration guide"
+_i18n_set zh check_structure.migration_guide "迁移指南"
+_i18n_set en check_structure.roll_back "To roll back to Roll 1.x temporarily"
+_i18n_set zh check_structure.roll_back "如需临时回退到 Roll 1.x"
+
+# ── main dispatch ──
+_i18n_set en main.unknown_command "Unknown command: %s"
+_i18n_set zh main.unknown_command "未知命令: %s"
+
+# ── dashboard status ──
+_i18n_set en dashboard.pending "pending"
+_i18n_set zh dashboard.pending "待办"

package/lib/i18n/skills/roll-brief.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-brief skill user-facing strings (US-I18N-003).
+_i18n_set en brief.title "Roll Brief — %s"
+_i18n_set zh brief.title "Roll 简报 — %s"
+_i18n_set en brief.summary "Summary"
+_i18n_set zh brief.summary "摘要"
+_i18n_set en brief.completed "Completed: %s"
+_i18n_set zh brief.completed "已完成: %s"
+_i18n_set en brief.in_progress "In Progress: %s"
+_i18n_set zh brief.in_progress "进行中: %s"
+_i18n_set en brief.backlog_queue "Backlog Queue: %s pending"
+_i18n_set zh brief.backlog_queue "Backlog 队列: %s 个待办"
+_i18n_set en brief.requires_attention "Requires Attention"
+_i18n_set zh brief.requires_attention "需要关注"
+_i18n_set en brief.release_readiness "Release Readiness"
+_i18n_set zh brief.release_readiness "发版就绪"
+_i18n_set en brief.ready "Ready to release"
+_i18n_set zh brief.ready "可以发版"
+_i18n_set en brief.not_ready "Not ready — %s blockers"
+_i18n_set zh brief.not_ready "暂不可发版 — %s 个阻塞项"

package/lib/i18n/skills/roll-build.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-build skill user-facing strings (US-I18N-003).
+# These are the templates/output blocks shown to users by agents executing roll-build.
+
+# ── Phase 1-2: Clarify & Assess ──
+_i18n_set en build.clarified_goal "Clarified Goal"
+_i18n_set zh build.clarified_goal "目标澄清"
+_i18n_set en build.complexity_assessment "Complexity Assessment"
+_i18n_set zh build.complexity_assessment "复杂度评估"
+_i18n_set en build.uncertainty_areas "Uncertainty Areas"
+_i18n_set zh build.uncertainty_areas "不确定性"
+_i18n_set en build.approach_confirmation "Approach Confirmation"
+_i18n_set zh build.approach_confirmation "方案确认"
+_i18n_set en build.what_changes "What changes"
+_i18n_set zh build.what_changes "变更内容"
+_i18n_set en build.the_approach "The approach"
+_i18n_set zh build.the_approach "方案"
+_i18n_set en build.files_touched "Files touched"
+_i18n_set zh build.files_touched "涉及文件"
+
+# ── Phase 2.5: Parallel Dispatch ──
+_i18n_set en build.parallel_dispatch "Parallel Dispatch: %s Actions running in parallel"
+_i18n_set zh build.parallel_dispatch "并行分发: %s 个 Action 并行执行"
+_i18n_set en build.agent_running "Agent %s [Action: %s]  ⏳ Running..."
+_i18n_set zh build.agent_running "Agent %s [Action: %s]  ⏳ 运行中..."
+_i18n_set en build.agent_done "Agent %s [Action: %s]  ✅ Done (%s TCR commits)"
+_i18n_set zh build.agent_done "Agent %s [Action: %s]  ✅ 完成 (%s 个 TCR 提交)"
+_i18n_set en build.merge_summary "Merge: %s/%s succeeded, merging..."
+_i18n_set zh build.merge_summary "合并: %s/%s 成功，正在合并..."
+_i18n_set en build.integration_tests "Integration tests: running..."
+_i18n_set zh build.integration_tests "集成测试: 运行中..."
+
+# ── Phase 4: Test Design Review ──
+_i18n_set en build.test_design "Test Design"
+_i18n_set zh build.test_design "测试设计"
+_i18n_set en build.scenarios "Scenarios"
+_i18n_set zh build.scenarios "场景"
+_i18n_set en build.test_types "Test Types"
+_i18n_set zh build.test_types "测试类型"
+
+# ── Phase 5: TCR ──
+_i18n_set en build.tcr_cycle "TCR CYCLE (Test && Commit || Revert)"
+_i18n_set zh build.tcr_cycle "TCR 循环 (Test && Commit || Revert)"
+_i18n_set en build.micro_step "MICRO-STEP %s: %s"
+_i18n_set zh build.micro_step "微步骤 %s: %s"
+
+# ── Phase 6: Pre-Push CI Gate ──
+_i18n_set en build.ci_check_failed "Local CI check failed"
+_i18n_set zh build.ci_check_failed "本地 CI 检查失败"
+_i18n_set en build.ci_check_passed "CI check passed"
+_i18n_set zh build.ci_check_passed "CI 检查通过"
+
+# ── Phase 10.5: Verification Gate ──
+_i18n_set en build.verification_gate "Verification Gate"
+_i18n_set zh build.verification_gate "验证门"
+_i18n_set en build.evidence_checklist "Evidence checklist (each item must have actual output)"
+_i18n_set zh build.evidence_checklist "证据清单（每项必须有实际输出）"
+_i18n_set en build.tests_passed "Tests passed: paste actual test run output"
+_i18n_set zh build.tests_passed "测试通过: 粘贴实际测试输出"
+_i18n_set en build.build_succeeded "Build succeeded: paste build output"
+_i18n_set zh build.build_succeeded "构建成功: 粘贴构建输出"
+_i18n_set en build.online_verification "Online verification: screenshot / curl output / log snippet"
+_i18n_set zh build.online_verification "在线验证: 截图 / curl 输出 / 日志片段"
+_i18n_set en build.no_regression "No regression: verify at least one existing feature still works"
+_i18n_set zh build.no_regression "无回归: 验证至少一个已有功能仍然正常"
+_i18n_set en build.gate_decision "Gate Decision"
+_i18n_set zh build.gate_decision "门控决议"
+_i18n_set en build.gate_pass "All items have evidence → Can mark as DONE"
+_i18n_set zh build.gate_pass "所有项有证据 → 可标记为完成"
+_i18n_set en build.gate_fail "Any item missing evidence → Gather evidence before passing the gate"
+_i18n_set zh build.gate_fail "任一项缺证据 → 收集证据后再过门"
+
+# ── Phase 12: Report & Celebrate ──
+_i18n_set en build.pushed_to "Pushed to GitHub: origin/main"
+_i18n_set zh build.pushed_to "已推送至 GitHub: origin/main"
+_i18n_set en build.deployed "Deployed"
+_i18n_set zh build.deployed "已部署"
+_i18n_set en build.verified "Verified"
+_i18n_set zh build.verified "已验证"
+_i18n_set en build.changes_summary "Changes"
+_i18n_set zh build.changes_summary "变更"
+_i18n_set en build.commits_count "Commits"
+_i18n_set zh build.commits_count "提交"
+_i18n_set en build.tests_added "Tests"
+_i18n_set zh build.tests_added "测试"
+_i18n_set en build.tcr_stats "TCR Stats"
+_i18n_set zh build.tcr_stats "TCR 统计"
+_i18n_set en build.review_gate "Review Gate"
+_i18n_set zh build.review_gate "评审门"
+_i18n_set en build.backlog_updated "BACKLOG: %s marked ✅ Done"
+_i18n_set zh build.backlog_updated "BACKLOG: %s 已标记 ✅ Done"
+_i18n_set en build.changelog_bundled "CHANGELOG: bundled into completion commit"
+_i18n_set zh build.changelog_bundled "CHANGELOG: 已并入完成提交"
+_i18n_set en build.shipped "Shipped"
+_i18n_set zh build.shipped "已交付"
+_i18n_set en build.next_options "Next Options"
+_i18n_set zh build.next_options "下一步"

package/lib/i18n/skills/roll-design.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-design skill user-facing strings (US-I18N-003).
+_i18n_set en design.epic "Epic: %s"
+_i18n_set zh design.epic "Epic: %s"
+_i18n_set en design.feature "Feature: %s"
+_i18n_set zh design.feature "功能: %s"
+_i18n_set en design.user_story "User Story: %s"
+_i18n_set zh design.user_story "用户故事: %s"
+_i18n_set en design.acceptance_criteria "Acceptance Criteria"
+_i18n_set zh design.acceptance_criteria "验收标准"
+_i18n_set en design.domain_model "Domain Model"
+_i18n_set zh design.domain_model "领域模型"
+_i18n_set en design.aggregates "Aggregates"
+_i18n_set zh design.aggregates "聚合"
+_i18n_set en design.context_map "Context Map"
+_i18n_set zh design.context_map "上下文映射"
+_i18n_set en design.stories_created "Created %s stories in backlog"
+_i18n_set zh design.stories_created "已在 backlog 创建 %s 个故事"

package/lib/i18n/skills/roll-fix.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-fix skill user-facing strings (US-I18N-003).
+_i18n_set en fix.bug_identified "Bug identified: %s"
+_i18n_set zh fix.bug_identified "Bug 已识别: %s"
+_i18n_set en fix.root_cause "Root cause"
+_i18n_set zh fix.root_cause "根因"
+_i18n_set en fix.fix_applied "Fix applied via TCR"
+_i18n_set zh fix.fix_applied "已通过 TCR 应用修复"
+_i18n_set en fix.tests_updated "Tests updated: %s"
+_i18n_set zh fix.tests_updated "测试已更新: %s"
+_i18n_set en fix.regression_verified "Regression verified"
+_i18n_set zh fix.regression_verified "回归验证通过"
+_i18n_set en fix.fix_complete "Fix complete: %s"
+_i18n_set zh fix.fix_complete "修复完成: %s"

package/lib/i18n/skills/roll-loop.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-loop skill user-facing strings (US-I18N-003).
+_i18n_set en loop.cycle_start "Cycle %s started"
+_i18n_set zh loop.cycle_start "Cycle %s 开始"
+_i18n_set en loop.orphan_recovery "Orphan recovery: %s items reverted"
+_i18n_set zh loop.orphan_recovery "孤儿恢复: %s 项已回退"
+_i18n_set en loop.ci_precheck "Pre-run CI check"
+_i18n_set zh loop.ci_precheck "启动前 CI 检查"
+_i18n_set en loop.pr_inbox "PR inbox: %s open"
+_i18n_set zh loop.pr_inbox "PR 收件箱: %s 个开放"
+_i18n_set en loop.scanning_backlog "Scanning backlog..."
+_i18n_set zh loop.scanning_backlog "扫描 backlog..."
+_i18n_set en loop.picked_story "Picked: %s"
+_i18n_set zh loop.picked_story "已选取: %s"
+_i18n_set en loop.executing "Executing: %s"
+_i18n_set zh loop.executing "执行中: %s"
+_i18n_set en loop.story_done "Story complete: %s"
+_i18n_set zh loop.story_done "故事完成: %s"
+_i18n_set en loop.ci_waiting "Waiting for CI..."
+_i18n_set zh loop.ci_waiting "等待 CI..."
+_i18n_set en loop.ci_green "CI: green"
+_i18n_set zh loop.ci_green "CI: 通过"
+_i18n_set en loop.ci_red "CI: red"
+_i18n_set zh loop.ci_red "CI: 失败"
+_i18n_set en loop.cycle_complete "Cycle complete: %s built, %s skipped"
+_i18n_set zh loop.cycle_complete "Cycle 完成: %s 个已构建, %s 个已跳过"
+_i18n_set en loop.idle_exit "No Todo items — idle exit"
+_i18n_set zh loop.idle_exit "无待办项 — 空闲退出"

package/lib/i18n/skills/roll-onboard.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-onboard skill user-facing strings (US-I18N-003).
+_i18n_set en onboard.welcome "Welcome to Roll Onboard"
+_i18n_set zh onboard.welcome "欢迎使用 Roll Onboard"
+_i18n_set en onboard.scanning "Scanning project..."
+_i18n_set zh onboard.scanning "正在扫描项目..."
+_i18n_set en onboard.questions_group1 "Group 1/3: Understanding your project"
+_i18n_set zh onboard.questions_group1 "第 1/3 组: 理解你的项目"
+_i18n_set en onboard.questions_group2 "Group 2/3: Defining scope"
+_i18n_set zh onboard.questions_group2 "第 2/3 组: 定义范围"
+_i18n_set en onboard.questions_group3 "Group 3/3: Privacy & preferences"
+_i18n_set zh onboard.questions_group3 "第 3/3 组: 隐私与偏好"
+_i18n_set en onboard.plan_written "Onboard plan written to .roll/onboard-plan.yaml"
+_i18n_set zh onboard.plan_written "Onboard 计划已写入 .roll/onboard-plan.yaml"
+_i18n_set en onboard.next_step "Next: run 'roll init --apply' to execute this plan"
+_i18n_set zh onboard.next_step "下一步: 运行 'roll init --apply' 执行此计划"

package/lib/i18n/update.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — update command (US-I18N-002).
+
+_i18n_set en update.version_mismatch "Version mismatch: installed %s, expected %s — CDN propagation lag, clearing cache and retrying..."
+_i18n_set zh update.version_mismatch "版本不一致（已安装 %s，期望 %s），疑似 CDN 未同步，清理缓存后重试..."
+_i18n_set en update.still_mismatch "Still on %s after retry — registry may not have propagated yet, try again in a minute."
+_i18n_set zh update.still_mismatch "重试后仍为 %s，注册表可能尚未同步，请稍后再试。"
+_i18n_set en update.current_version "Current version: roll v%s"
+_i18n_set zh update.current_version "当前版本: roll v%s"

package/lib/i18n.sh

@@ -111,3 +111,28 @@ msg() {
   printf "$tmpl" "$@"
   echo
 }
+
+# ── Load per-command message catalogs (US-I18N-002) ──
+# Source all lib/i18n/*.sh files (skip self). Called once at bin/roll startup.
+_i18n_load_catalogs() {
+  local i18n_dir
+  i18n_dir="$(dirname "${BASH_SOURCE[0]:-$0}")/i18n"
+  if [[ -d "$i18n_dir" ]]; then
+    local f
+    # Load per-command catalogs
+    for f in "$i18n_dir"/*.sh; do
+      [[ -f "$f" ]] || continue
+      # shellcheck source=/dev/null
+      source "$f"
+    done
+    # Load skill catalogs (US-I18N-003)
+    if [[ -d "$i18n_dir/skills" ]]; then
+      for f in "$i18n_dir/skills"/*.sh; do
+        [[ -f "$f" ]] || continue
+        # shellcheck source=/dev/null
+        source "$f"
+      done
+    fi
+  fi
+}
+_i18n_load_catalogs