@seanyao/roll 0.5.0 → 2.602.1

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,33 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — roll-onboard skill user-facing strings (US-I18N-003).
+# These are the templates/questions shown to users by agents executing roll-onboard.
+
+# ── Step 0-2: Setup ──
+_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.stop_migrate_first "This project has legacy Roll structure (BACKLOG.md or docs/features/). Run 'roll migrate' first before onboarding."
+_i18n_set zh onboard.stop_migrate_first "此项目还保留着旧版 Roll 结构（BACKLOG.md 或 docs/features/）。请先运行 'roll migrate' 再 onboard。"
+
+# ── Step 3: Nine Questions ──
+_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.q1 "I see this is a %s project doing %s — correct?"
+_i18n_set zh onboard.q1 "我看到这是一个 %s 项目，做的是 %s — 对吗？"
+_i18n_set en onboard.q2 "The main business domains look like %s — anything to add or correct?"
+_i18n_set zh onboard.q2 "主要业务领域看起来有 %s — 有需要补充或纠正的吗？"
+_i18n_set en onboard.q3 "The key modules are %s — any missed or mis-identified?"
+_i18n_set zh onboard.q3 "关键模块是 %s — 有遗漏或识别错误的吗？"
+_i18n_set en onboard.q4 "Which artifacts should I generate?"
+_i18n_set zh onboard.q4 "需要生成哪些产出物？"
+
+# ── Step 4: Plan complete ──
+_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/skills_catalog.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Roll i18n catalog — `roll skills` command (US-SKILL-016).
+# Generated skills catalog: scan skills/*/SKILL.md frontmatter → guide/skills.md.
+
+_i18n_set en skills.generated "Generated skill catalog: %s"
+_i18n_set zh skills.generated "已生成技能清单：%s"
+
+_i18n_set en skills.check_ok "Skill catalog is up to date."
+_i18n_set zh skills.check_ok "技能清单已是最新。"
+
+_i18n_set en skills.check_drift "Skill catalog drift: %s differs from a fresh scan. Run 'roll skills generate'."
+_i18n_set zh skills.check_drift "技能清单漂移：%s 与最新扫描不一致。请运行 'roll skills generate'。"
+
+_i18n_set en skills.check_missing "Skill catalog not found at %s. Run 'roll skills generate'."
+_i18n_set zh skills.check_missing "未找到技能清单 %s。请运行 'roll skills generate'。"
+
+_i18n_set en skills.unknown_sub "Unknown 'roll skills' subcommand: %s"
+_i18n_set zh skills.unknown_sub "未知的 'roll skills' 子命令：%s"
+
+_i18n_set en skills.usage "Usage: roll skills <generate|check>"
+_i18n_set zh skills.usage "用法：roll skills <generate|check>"
+
+_i18n_set en skills.doctor_heading "Skill catalog"
+_i18n_set zh skills.doctor_heading "技能清单"
+
+_i18n_set en skills.doctor_ok "✅ guide/skills.md matches skills/*/SKILL.md"
+_i18n_set zh skills.doctor_ok "✅ guide/skills.md 与 skills/*/SKILL.md 一致"
+
+_i18n_set en skills.doctor_drift "⚠️  guide/skills.md is stale — run 'roll skills generate'"
+_i18n_set zh skills.doctor_drift "⚠️  guide/skills.md 已过期 — 请运行 'roll skills generate'"

package/lib/i18n/slides.sh

@@ -0,0 +1,3 @@
+
+_i18n_set en slides.unknown_subcommand "Unknown subcommand: %s"
+_i18n_set zh slides.unknown_subcommand "未知子命令：%s"

package/lib/i18n/slides_build.sh

@@ -0,0 +1,38 @@
+
+_i18n_set en slides_build.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_build.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_build.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_build.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_build.slides_toolchain_missing_re_run_roll "Slides toolchain missing — re-run 'roll setup'"
+_i18n_set zh slides_build.slides_toolchain_missing_re_run_roll "渲染工具缺失，请运行 roll setup"
+_i18n_set en slides_build.deck_md "  deck.md"
+_i18n_set zh slides_build.deck_md "校验失败，请先修复上方提示再重试。"
+_i18n_set en slides_build.template_not_found "Template not found: %s"
+_i18n_set zh slides_build.template_not_found "未找到模板：%s"
+_i18n_set en slides_build.render_failed_for "Render failed for %s"
+_i18n_set zh slides_build.render_failed_for "渲染失败：%s"
+_i18n_set en slides_build.rendered "Rendered → %s"
+_i18n_set zh slides_build.rendered "渲染完成 → %s"
+
+# US-DECK-012: build failure recovery paths
+_i18n_set en slides_build.validation_failed_for "Validation failed for %s"
+_i18n_set zh slides_build.validation_failed_for "校验失败：%s"
+_i18n_set en slides_build.hint_fix_and_rerun "Hint: fix the issues above in %s and re-run 'roll slides build %s'"
+_i18n_set zh slides_build.hint_fix_and_rerun "提示：请按上方提示修复 %s，然后重新运行 'roll slides build %s'"
+_i18n_set en slides_build.available_templates "Available templates:"
+_i18n_set zh slides_build.available_templates "可用模板："
+_i18n_set en slides_build.templates_list_hint "Hint: 'roll slides templates' lists all installed templates"
+_i18n_set zh slides_build.templates_list_hint "提示：'roll slides templates' 列出所有已安装模板"
+_i18n_set en slides_build.renderer_crashed_for "Renderer crashed for %s"
+_i18n_set zh slides_build.renderer_crashed_for "渲染器崩溃：%s"
+_i18n_set en slides_build.see_full_error_logs "See full error: roll slides logs %s"
+_i18n_set zh slides_build.see_full_error_logs "查看完整错误：roll slides logs %s"
+_i18n_set en slides_build.last_5_lines_of_renderer_output "Last 5 lines of renderer output:"
+_i18n_set zh slides_build.last_5_lines_of_renderer_output "渲染器最后 5 行："
+
+_i18n_set en slides_build.usage_roll_slides_build_slug_no "Usage: roll slides build <slug> [--no-open]"
+_i18n_set zh slides_build.usage_roll_slides_build_slug_no "用法: roll slides build <slug> [--no-open]"
+_i18n_set en slides_build.en_deck "[EN:  未找到 deck 文件：%s...]"
+_i18n_set zh slides_build.en_deck "  未找到 deck 文件：%s"
+_i18n_set en slides_build.en_roll_slides_new "[EN:  提示：先运行 'roll slides new \"<主题>\"' 生成新的幻灯片。...]"
+_i18n_set zh slides_build.en_roll_slides_new "  提示：先运行 'roll slides new \"<主题>\"' 生成新的幻灯片。"

package/lib/i18n/slides_delete.sh

@@ -0,0 +1,19 @@
+
+_i18n_set en slides_delete.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_delete.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_delete.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_delete.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_delete.deck_not_found "Deck not found: %s"
+_i18n_set zh slides_delete.deck_not_found "未找到幻灯片：%s"
+_i18n_set en slides_delete.non_interactive_terminal_must_use_force "Non-interactive terminal: must use --force to delete"
+_i18n_set zh slides_delete.non_interactive_terminal_must_use_force "非交互终端：需使用 --force 参数"
+_i18n_set en slides_delete.cancelled "Cancelled"
+_i18n_set zh slides_delete.cancelled "已取消"
+_i18n_set en slides_delete.deleted "Deleted %s"
+_i18n_set zh slides_delete.deleted "已删除 %s"
+
+_i18n_set en slides_delete.usage_roll_slides_delete_slug_force "Usage: roll slides delete <slug> [--force]"
+_i18n_set zh slides_delete.usage_roll_slides_delete_slug_force "用法: roll slides delete <slug> [--force]"
+
+_i18n_set en slides_delete.prompt 'Delete deck "%s"? (y/N)'
+_i18n_set zh slides_delete.prompt '删除幻灯片 "%s"？(y/N)'

package/lib/i18n/slides_list.sh

@@ -0,0 +1,14 @@
+
+_i18n_set en slides_list.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_list.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_list.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_list.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_list.no_decks_found_under_roll_slides "No decks found under .roll/slides/"
+_i18n_set zh slides_list.no_decks_found_under_roll_slides "无幻灯片"
+_i18n_set en slides_list.no_decks_found_under_roll_slides_2 "No decks found under .roll/slides/"
+_i18n_set zh slides_list.no_decks_found_under_roll_slides_2 "无幻灯片"
+
+_i18n_set en slides_list.en_roll_slides_new "[EN:  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。...]"
+_i18n_set zh slides_list.en_roll_slides_new "  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。"
+_i18n_set en slides_list.en_roll_slides_new_2 "[EN:  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。...]"
+_i18n_set zh slides_list.en_roll_slides_new_2 "  提示：运行 'roll slides new \"<主题>\"' 创建第一个幻灯片。"

package/lib/i18n/slides_logs.sh

@@ -0,0 +1,12 @@
+
+_i18n_set en slides_logs.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_logs.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_logs.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_logs.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_logs.deck_not_found "Deck not found: %s"
+_i18n_set zh slides_logs.deck_not_found "未找到幻灯片：%s"
+_i18n_set en slides_logs.no_failure_records_for "No failure records for %s"
+_i18n_set zh slides_logs.no_failure_records_for "该幻灯片没有失败记录"
+
+_i18n_set en slides_logs.usage_roll_slides_logs_slug "Usage: roll slides logs <slug>"
+_i18n_set zh slides_logs.usage_roll_slides_logs_slug "用法: roll slides logs <slug>"

package/lib/i18n/slides_new.sh

@@ -0,0 +1,15 @@
+
+_i18n_set en slides_new.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_new.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_new.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_new.unexpected_argument_1 "多余参数: %s"
+
+_i18n_set en slides_new.en_roll_slides_new_template "[EN:  用法：roll slides new \"<主题>\" [--template <模板名>] [...]"
+_i18n_set zh slides_new.en_roll_slides_new_template "  用法：roll slides new \"<主题>\" [--template <模板名>] [--quiet] [--no-build]"
+_i18n_set en slides_new.en_slug "[EN:  无法从主题派生 slug：%s...]"
+_i18n_set zh slides_new.en_slug "  无法从主题派生 slug：%s"
+_i18n_set en slides_new.en_roll_slides_build "[EN:下一步：roll slides build %s...]"
+_i18n_set zh slides_new.en_roll_slides_build "下一步：roll slides build %s"
+
+_i18n_set en slides_new.template_requires_value "--template requires a value"
+_i18n_set zh slides_new.template_requires_value "--template 需要一个值"

package/lib/i18n/slides_preview.sh

@@ -0,0 +1,14 @@
+
+_i18n_set en slides_preview.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_preview.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_preview.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_preview.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_preview.preview "Preview → %s"
+_i18n_set zh slides_preview.preview "打开预览 → %s"
+
+_i18n_set en slides_preview.usage_roll_slides_preview_slug_no "Usage: roll slides preview <slug> [--no-open]"
+_i18n_set zh slides_preview.usage_roll_slides_preview_slug_no "用法: roll slides preview <slug> [--no-open]"
+_i18n_set en slides_preview.en_html "[EN:  未找到已渲染的 HTML：%s...]"
+_i18n_set zh slides_preview.en_html "  未找到已渲染的 HTML：%s"
+_i18n_set en slides_preview.en_roll_slides_build "[EN:  提示：先运行 'roll slides build %s' 渲染幻灯片。...]"
+_i18n_set zh slides_preview.en_roll_slides_build "  提示：先运行 'roll slides build %s' 渲染幻灯片。"

package/lib/i18n/slides_templates.sh

@@ -0,0 +1,7 @@
+
+_i18n_set en slides_templates.unknown_option_1 "Unknown option: %s"
+_i18n_set zh slides_templates.unknown_option_1 "未知选项: %s"
+_i18n_set en slides_templates.unexpected_argument_1 "Unexpected argument: %s"
+_i18n_set zh slides_templates.unexpected_argument_1 "多余参数: %s"
+_i18n_set en slides_templates.no_templates_found "No templates found"
+_i18n_set zh slides_templates.no_templates_found "无可用模板"

package/lib/i18n/status.sh

@@ -0,0 +1,21 @@
+
+_i18n_set en status.loop_overview "%sLoop Overview:"
+_i18n_set zh status.loop_overview "所有项目 loop 状态%s"
+_i18n_set en status.not_synced "  %s-%s %s: %s (not synced /"
+_i18n_set zh status.not_synced "未同步)"
+_i18n_set en status.out_of_sync_roll_md_missing "  %s~%s %s: %s (out of sync — roll.md missing / roll.md"
+_i18n_set zh status.out_of_sync_roll_md_missing "缺失)"
+_i18n_set en status.out_of_sync_roll_md_outdated "  %s~%s %s: %s (out of sync — roll.md outdated / roll.md"
+_i18n_set zh status.out_of_sync_roll_md_outdated "已过期)"
+_i18n_set en status.out_of_sync_roll_md_not "  %s~%s %s: %s (out of sync — @roll.md not in config /"
+_i18n_set zh status.out_of_sync_roll_md_not "未包含 @roll.md)"
+_i18n_set en status.in_sync "  %s=%s %s: %s (in sync /"
+_i18n_set zh status.in_sync "已同步)"
+_i18n_set en status.peer_call_timeout_s_peer "Peer call timeout: %ss  Peer"
+_i18n_set zh status.peer_call_timeout_s_peer "调用超时: %ss"
+_i18n_set en status.peer_call_timeout_killed "Peer %s killed after %ss wall-clock budget (FIX-150c)"
+_i18n_set zh status.peer_call_timeout_killed "Peer %s 超过 %ss 上限,已强制终止 (FIX-150c)"
+_i18n_set en status.unsupported_peer "Unsupported peer: %s"
+_i18n_set zh status.unsupported_peer "不支持的 peer: %s"
+_i18n_set en status.unsupported_peer_2 "Unsupported peer: %s"
+_i18n_set zh status.unsupported_peer_2 "不支持的 peer: %s"

package/lib/i18n/update.sh

@@ -0,0 +1,24 @@
+#!/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"
+
+_i18n_set en update.upgrading_via_npm "Upgrading via npm..."
+_i18n_set zh update.upgrading_via_npm "正在通过 npm 升级..."
+_i18n_set en update.upgrading_via_curl "Upgrading via curl..."
+_i18n_set zh update.upgrading_via_curl "正在通过 curl 升级..."
+_i18n_set en update.npm_install_failed_check_network_proxy "npm install failed. Check network/proxy and try again."
+_i18n_set zh update.npm_install_failed_check_network_proxy "安装失败，请检查网络/代理后重试。"
+_i18n_set en update.curl_download_failed "Download failed. Check network/proxy and try again."
+_i18n_set zh update.curl_download_failed "下载失败，请检查网络/代理后重试。"
+_i18n_set en update.curl_extract_failed "Extraction failed. The downloaded archive may be corrupted."
+_i18n_set zh update.curl_extract_failed "解压失败，下载的归档可能已损坏。"
+_i18n_set en update.new_version "Upgraded to roll v%s"
+_i18n_set zh update.new_version "已升级到 roll v%s"
+_i18n_set en update.re_syncing_to_ai_tools "Re-syncing to AI tools..."
+_i18n_set zh update.re_syncing_to_ai_tools "正在重新同步到 AI 工具..."

package/lib/i18n.sh

@@ -0,0 +1,211 @@
+#!/usr/bin/env bash
+# Roll i18n engine — US-I18N-001.
+#
+# Provides:
+#   _i18n_resolve_lang     — resolve user's language per precedence
+#   msg <key> [args...]    — look up message catalog with EN fallback
+#   _i18n_set <lang> <key> <value>  — fill the catalog (used by modules)
+#
+# Storage is bash 3.2-compatible (macOS default ships 3.2): each catalog entry
+# is held in a plain variable named `MSG_<LANG>_<key>`, looked up via indirect
+# reference. Bash 4 assoc arrays would be cleaner but break macOS default bash
+# (see AGENTS.md §4: single bash script, no runtime).
+#
+# Precedence: ROLL_LANG env > ~/.roll/config.yaml `lang` > LC_ALL > LANG
+#             > (macOS) AppleLanguages > 'en'.
+# Decision:   value starting with `zh` → "zh", everything else → "en".
+
+# Fill the catalog. Modules call this at source-time:
+#   _i18n_set en hello "Hello, %s!"
+#   _i18n_set zh hello "你好，%s！"
+# No subshell forks: lang uppercasing uses a case statement (bash 3.2-safe;
+# ${var^^} requires bash 4+), key sanitization uses inline param-expansion.
+_i18n_set() {
+  local lang="$1" key="$2" val="$3"
+  local upper safe varname
+  case "$lang" in
+    en|EN) upper=EN ;;
+    zh|ZH) upper=ZH ;;
+    *)     upper="$(printf '%s' "$lang" | tr '[:lower:]' '[:upper:]')" ;;
+  esac
+  safe="${key//[^A-Za-z0-9_]/_}"        # inline param-expansion — no subshell fork
+  varname="MSG_${upper}_${safe}"
+  printf -v "$varname" '%s' "$val"
+  export "$varname"
+}
+
+# Decide "zh" or "en" from a free-form locale string.
+_i18n_classify() {
+  case "${1:-}" in
+    zh*) echo zh ;;
+    *)   echo en ;;
+  esac
+}
+
+# Resolve the active language. Caches in ROLL_LANG_RESOLVED so later calls are
+# free.
+_i18n_resolve_lang() {
+  if [[ -n "${ROLL_LANG_RESOLVED:-}" ]]; then
+    echo "$ROLL_LANG_RESOLVED"
+    return
+  fi
+
+  local lang=""
+
+  if [[ -n "${ROLL_LANG:-}" ]]; then
+    lang=$(_i18n_classify "$ROLL_LANG")
+  fi
+
+  if [[ -z "$lang" && -n "${ROLL_CONFIG:-}" && -f "${ROLL_CONFIG}" ]]; then
+    local cfg
+    cfg=$(grep -E '^lang:' "$ROLL_CONFIG" 2>/dev/null | head -1 \
+            | sed 's/^lang:[[:space:]]*//' \
+            | sed 's/[[:space:]]*#.*$//' \
+            | sed 's/[[:space:]]*$//')
+    [[ -n "$cfg" ]] && lang=$(_i18n_classify "$cfg")
+  fi
+
+  if [[ -z "$lang" && -n "${LC_ALL:-}" ]]; then
+    lang=$(_i18n_classify "$LC_ALL")
+  fi
+
+  if [[ -z "$lang" && -n "${LANG:-}" ]]; then
+    lang=$(_i18n_classify "$LANG")
+  fi
+
+  if [[ -z "$lang" ]] && command -v defaults >/dev/null 2>&1; then
+    local apple
+    apple=$(defaults read -g AppleLanguages 2>/dev/null | head -2 | tail -1 \
+              | tr -d ' ",()' | head -1 || true)
+    [[ -n "$apple" ]] && lang=$(_i18n_classify "$apple")
+  fi
+
+  [[ -z "$lang" ]] && lang="en"
+
+  ROLL_LANG_RESOLVED="$lang"
+  echo "$lang"
+}
+
+# Look up message catalog entry. Falls back to EN, then to the key itself so
+# missing translations stay visible without crashing the caller.
+msg() {
+  local key="$1"; shift || true
+  local lang safe
+  # FIX: avoid subshell forks — check cached value first, inline key sanitize
+  if [[ -n "${ROLL_LANG_RESOLVED:-}" ]]; then
+    lang="$ROLL_LANG_RESOLVED"
+  else
+    lang=$(_i18n_resolve_lang)
+  fi
+  safe="${key//[^A-Za-z0-9_]/_}"       # FIX: inline — no subshell fork
+
+  local zh_var="MSG_ZH_${safe}"
+  local en_var="MSG_EN_${safe}"
+  local tmpl=""
+
+  if [[ "$lang" == "zh" && -n "${!zh_var:-}" ]]; then
+    tmpl="${!zh_var}"
+  elif [[ -n "${!en_var:-}" ]]; then
+    tmpl="${!en_var}"
+  else
+    tmpl="$key"
+  fi
+
+  # shellcheck disable=SC2059 — template comes from our own catalog
+  printf "$tmpl" "$@"
+  echo
+}
+
+# Look up message catalog entry with an explicit language, bypassing ROLL_LANG env.
+# Usage: msg_lang <lang> <key> [printf-args...]
+# Useful when the caller tracks language independently of the process env (e.g.
+# _loop_schedule_desc passes an explicit lang= parameter).
+msg_lang() {
+  local lang="$1" key="$2"; shift 2 || true
+  local upper safe varname tmpl
+  case "$lang" in
+    en|EN) upper=EN ;;
+    zh|ZH) upper=ZH ;;
+    *)     upper="$(printf '%s' "$lang" | tr '[:lower:]' '[:upper:]')" ;;
+  esac
+  safe="${key//[^A-Za-z0-9_]/_}"
+  varname="MSG_${upper}_${safe}"
+  tmpl="${!varname:-}"
+  if [[ -z "$tmpl" ]]; then
+    varname="MSG_EN_${safe}"
+    tmpl="${!varname:-$key}"
+  fi
+  # shellcheck disable=SC2059 — template comes from our own catalog
+  printf "$tmpl" "$@"
+  echo
+}
+
+# ── CJK display-width helpers (US-I18N-006) ──────────────────────────────
+# Compute visual display width of a string (CJK fullwidth = 2 cells,
+# ASCII = 1 cell). Delegates to python3 which is already a dependency.
+_strw() {
+  python3 -c "
+import sys
+from unicodedata import east_asian_width
+s = sys.argv[1]
+w = sum(2 if east_asian_width(c) in ('F','W') else 1 for c in s)
+print(w)
+" "$1"
+}
+
+# Left-pad a string to a target visual display width (CJK-aware).
+_pad_l() {
+  local s="$1" target="$2"
+  local sw
+  sw=$(_strw "$s")
+  local pad=$((target - sw))
+  if ((pad <= 0)); then
+    printf '%s' "$s"
+  else
+    printf '%s%*s' "$s" "$pad" ''
+  fi
+}
+
+# Right-pad a string to a target visual display width (CJK-aware).
+_pad_r() {
+  local s="$1" target="$2"
+  local sw
+  sw=$(_strw "$s")
+  local pad=$((target - sw))
+  if ((pad <= 0)); then
+    printf '%s' "$s"
+  else
+    printf '%*s%s' "$pad" '' "$s"
+  fi
+}
+
+# ── 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() {
+  # FIX: guard — skip re-load when catalogs already loaded in this shell.
+  # Each bats test sources bin/roll in its own subshell so the guard resets
+  # automatically; but within a single shell (e.g. integration tests) this
+  # prevents 2.6s of catalog I/O on every subsequent source.
+  [[ -n "${_I18N_CATALOGS_LOADED:-}" ]] && return 0
+  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_CATALOGS_LOADED=1
+}
+_i18n_load_catalogs