@seanyao/roll 3.611.2 → 3.612.1

package/lib/i18n/README.md

@@ -22,7 +22,6 @@ lib/i18n/
 ├── init.sh           # roll init setup messages
 ├── lang.sh           # locale detection + ROLL_LANG resolution
 ├── loop.sh           # roll loop subcommand output (largest file)
-├── migrate.sh        # roll migrate messages
 ├── offboard.sh       # roll offboard output
 ├── onboard.sh        # roll onboard / legacy-onboard output
 ├── peer.sh           # roll peer review messages

package/lib/i18n/alert.sh

@@ -14,7 +14,7 @@ _i18n_set zh alert.alert_resolved_and_cleared "告警已解决并清除"
 _i18n_set en alert.unknown_subcommand "Unknown subcommand: %s"
 _i18n_set zh alert.unknown_subcommand "未知子命令: %s"
 
-_i18n_set en alert.run_roll_alert_ack_to_acknowledge "Run 'roll alert ack' to acknowledge alerts, 'roll alert resolve' to clear."
-_i18n_set zh alert.run_roll_alert_ack_to_acknowledge "  运行 'roll alert ack' 确认告警，'roll alert resolve' 清除告警。"
-_i18n_set en alert.usage_roll_alert_list_ack_resolve "Usage: roll alert [list|ack|resolve]"
-_i18n_set zh alert.usage_roll_alert_list_ack_resolve "  用法: roll alert [list|ack|resolve]"
+_i18n_set en alert.run_roll_alert_ack_to_acknowledge "Run 'roll loop alert ack' to acknowledge alerts, 'roll loop alert resolve' to clear."
+_i18n_set zh alert.run_roll_alert_ack_to_acknowledge "  运行 'roll loop alert ack' 确认告警，'roll loop alert resolve' 清除告警。"
+_i18n_set en alert.usage_roll_alert_list_ack_resolve "Usage: roll loop alert [list|ack|resolve]"
+_i18n_set zh alert.usage_roll_alert_list_ack_resolve "  用法: roll loop alert [list|ack|resolve]"

package/lib/i18n/consistency.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 # Roll i18n catalog — consistency check messages (US-CONSIST-001).
 
-_i18n_set en consistency.usage "roll consistency check [--json] [--project-dir DIR]"
-_i18n_set zh consistency.usage "roll consistency check [--json] [--project-dir DIR]"
+_i18n_set en consistency.usage "roll release consistency check [--json] [--project-dir DIR]"
+_i18n_set zh consistency.usage "roll release consistency check [--json] [--project-dir DIR]"
 
 _i18n_set en consistency.unknown_sub "Unknown consistency subcommand: %s"
 _i18n_set zh consistency.unknown_sub "未知的一致性子命令: %s"

package/lib/i18n/shared.sh

@@ -16,12 +16,6 @@ _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 "发起方"

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

@@ -7,8 +7,8 @@ _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。"
+_i18n_set en onboard.stop_migrate_first "This project has legacy Roll structure (BACKLOG.md or docs/features/). Run 'npx @seanyao/roll@2 migrate' first before onboarding."
+_i18n_set zh onboard.stop_migrate_first "此项目还保留着旧版 Roll 结构（BACKLOG.md 或 docs/features/）。请先运行 'npx @seanyao/roll@2 migrate' 再 onboard。"
 
 # ── Step 3: Nine Questions ──
 _i18n_set en onboard.questions_group1 "Group 1/3: Understanding your project"

package/lib/i18n/skills_catalog.sh

@@ -8,17 +8,17 @@ _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_drift "Skill catalog drift: %s differs from a fresh scan. Run 'roll setup skills'."
+_i18n_set zh skills.check_drift "技能清单漂移：%s 与最新扫描不一致。请运行 'roll setup skills'。"
 
-_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.check_missing "Skill catalog not found at %s. Run 'roll setup skills'."
+_i18n_set zh skills.check_missing "未找到技能清单 %s。请运行 'roll setup skills'。"
 
 _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.usage "Usage: roll doctor skills | roll setup skills"
+_i18n_set zh skills.usage "用法：roll doctor skills | roll setup skills"
 
 _i18n_set en skills.doctor_heading "Skill catalog"
 _i18n_set zh skills.doctor_heading "技能清单"
@@ -26,5 +26,5 @@ _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'"
+_i18n_set en skills.doctor_drift "⚠️  guide/skills.md is stale — run 'roll setup skills'"
+_i18n_set zh skills.doctor_drift "⚠️  guide/skills.md 已过期 — 请运行 'roll setup skills'"

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@seanyao/roll",
-  "version": "3.611.2",
+  "version": "3.612.1",
   "description": "Roll — Roll out features with AI agents",
   "packageManager": "pnpm@11.1.3",
   "scripts": {
     "test": "bash scripts/test-ts.sh",
+    "test:e2e": "pnpm -r build && pnpm --filter @roll/cli exec vitest run test/critical-flows.e2e.test.ts",
     "test:cov": "pnpm -r exec vitest run --coverage.enabled --coverage.provider=v8 --coverage.include='src/**' --coverage.reporter=text-summary --coverage.reporter=text",
     "bundle": "node scripts/bundle.mjs",
     "prepack": "pnpm -r build && pnpm bundle"

package/skills/roll-build/SKILL.md

@@ -35,6 +35,7 @@ Load when a user gives a US-XXX story or asks to ship a feature through Roll TCR
 - TCR for every micro-step.
 - No WIP commits or bypassed verification.
 - Self-review, attest, E2E evidence, and self-score remain required.
+- Docs/code/product alignment is a DoD gate: user-visible behavior, command, output-copy, site, or delivery-view changes update the touched README/docs/guide/site/help in the same delivery.
 
 ## Gotchas
 

package/skills/roll-build/references/full-contract.md

@@ -768,6 +768,10 @@ Before creating any file or directory:
    - .roll/backlog.md index row and `.roll/features/<feature>.md` US section are both required
    - Neither can be skipped
 
+8. **Docs/code/product stay aligned**
+   - User-visible behavior, command, output-copy, site, or delivery-view changes update the touched README/docs/guide/site/help in the same delivery
+   - Registry drift from FIX-242 remains a hard red line; `roll attest` doc-gap is a shadow warning and should be resolved before Done
+
 ---
 
 ## Definition of Done (per Action)
@@ -778,6 +782,7 @@ Before creating any file or directory:
 - [ ] **E2E deposited** (golden path test for this Story, committed via TCR)
 - [ ] All commits are green states (no broken commits)
 - [ ] Local CI checks passed (format + lint + build + test)
+- [ ] **Docs/code/product aligned** (user-visible changes updated touched README/docs/guide/site/help, or the delivery records why no doc surface changed)
 - [ ] Self-code-review passed, blocking issues fixed via TCR
 - [ ] Changes pushed to remote
 - [ ] CI is green (or explicit, recorded exception)

package/skills/roll-fix/SKILL.md

@@ -35,6 +35,7 @@ Load when the user provides a FIX-XXX or BUG-XXX item, or asks for a focused hot
 - Every fix gets a regression signal or documented exception.
 - Blocking review findings are fixed in another TCR cycle.
 - Self-score note is required before exit.
+- Docs/code/product alignment is a DoD gate: user-visible behavior, command, output-copy, site, or delivery-view changes update the touched README/docs/guide/site/help in the same delivery.
 
 ## Gotchas
 

package/skills/roll-fix/references/full-contract.md

@@ -93,6 +93,10 @@ Before creating any file or directory:
    - the change affects roadmap-visible behavior
    - the fix should be tracked for follow-up work
 
+7. **Docs/code/product stay aligned**
+   - User-visible behavior, command, output-copy, site, or delivery-view changes update the touched README/docs/guide/site/help in the same delivery
+   - Registry drift from FIX-242 remains a hard red line; `roll attest` doc-gap is a shadow warning and should be resolved before Done
+
 ## TCR Workflow
 
 ### 0. Pre-flight self-check (US-AGENT-007)
@@ -496,6 +500,7 @@ A minor change is only "done" when all are true:
 - [ ] **TCR cycle(s) completed** (fix via Test && Commit)
 - [ ] All commits are green states
 - [ ] Local integration checks pass
+- [ ] **Docs/code/product aligned** (user-visible changes updated touched README/docs/guide/site/help, or the delivery records why no doc surface changed)
 - [ ] Quality review (code-reviewer) passed, blocking issues resolved via TCR
 - [ ] Changes pushed
 - [ ] CI is green (or explicit, recorded exception exists)

package/skills/roll-onboard/SKILL.md

@@ -41,14 +41,14 @@ Hard constraint: **AI cannot create files in the user's project other than `.rol
 1. The repository tree (use the project's own structure to infer technologies)
 2. Any existing `README.md` / `package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod` etc. as evidence
 3. `roll-doc --dry-run` output → identifies what documentation gaps exist
-4. The path-audit pattern: scan for legacy structure markers (`BACKLOG.md`, `docs/features/`, etc.) — if any are present, REFUSE and tell the user to run `roll migrate` first
+4. The path-audit pattern: scan for legacy structure markers (`BACKLOG.md`, `docs/features/`, etc.) — if any are present, REFUSE and tell the user to run `npx @seanyao/roll@2 migrate` first
 
 ## Workflow
 
 ### Step 0 — Pre-flight
 
 1. Check that you're in a legacy project root (no `AGENTS.md`, has source code)
-2. If `BACKLOG.md` or `docs/features/` already present → STOP, tell user to run `roll migrate` first (this is a partial-migration project, not legacy)
+2. If `BACKLOG.md` or `docs/features/` already present → STOP, tell user to run `npx @seanyao/roll@2 migrate` first (this is a partial-migration project, not legacy)
 3. Check `.roll/onboard-plan.yaml` doesn't already exist; if it does, ask user whether to overwrite
 
 ### Step 1 — Read code, build understanding
@@ -228,7 +228,7 @@ Do NOT run `roll init --apply` yourself. Do NOT modify other project files. Your
 ## When NOT to use
 
 - **Not a legacy project**: empty dir or fresh project → use plain `roll init` instead
-- **Has BACKLOG.md or docs/features/**: this is a pre-2.0 Roll project → run `roll migrate` first
+- **Has BACKLOG.md or docs/features/**: this is a pre-2.0 Roll project → run `npx @seanyao/roll@2 migrate` first
 - **Has .roll/ already**: already onboarded → don't re-run
 
 ## Failure modes

package/lib/i18n/migrate.sh

@@ -1,74 +0,0 @@
-
-_i18n_set en migrate.unknown_arg_1 "Unknown arg: %s"
-_i18n_set zh migrate.unknown_arg_1 "未知参数: %s"
-_i18n_set en migrate.not_a_git_repository_roll_migrate "Not a git repository. roll migrate requires git."
-_i18n_set zh migrate.not_a_git_repository_roll_migrate "当前目录不是 git 仓库。"
-_i18n_set en migrate.both_old_and_new_structures_exist "Both old and new structures exist (partial migration detected)."
-_i18n_set zh migrate.both_old_and_new_structures_exist "老结构与新结构同时存在（部分迁移）。"
-_i18n_set en migrate.conflicting_paths "Conflicting paths:"
-_i18n_set zh migrate.conflicting_paths "冲突路径："
-_i18n_set en migrate.resolve_manually_then_re_run "Resolve manually then re-run."
-_i18n_set zh migrate.resolve_manually_then_re_run "请手动解决冲突后重新运行。"
-_i18n_set en migrate.already_migrated_roll_exists_no_old "Already migrated. .roll/ exists, no old paths found."
-_i18n_set zh migrate.already_migrated_roll_exists_no_old "已迁移，无需重复操作。"
-_i18n_set en migrate.no_old_structure_detected_nothing_to "No old structure detected. Nothing to migrate."
-_i18n_set zh migrate.no_old_structure_detected_nothing_to "未发现老结构，无需迁移。"
-_i18n_set en migrate.old_structure_markers_found_but_no "Old structure markers found but no migratable files."
-_i18n_set zh migrate.old_structure_markers_found_but_no "未找到可迁移文件。"
-_i18n_set en migrate.working_tree_not_clean_commit_or "Working tree not clean. Commit or stash changes before running migrate."
-_i18n_set zh migrate.working_tree_not_clean_commit_or "工作区有未提交改动，请先 commit 或 stash。"
-_i18n_set en migrate.migration_preview_dry_run "Migration preview (dry-run):"
-_i18n_set zh migrate.migration_preview_dry_run "迁移预览（dry-run）"
-_i18n_set en migrate.run_without_dry_run_to_execute "Run without --dry-run to execute."
-_i18n_set zh migrate.run_without_dry_run_to_execute "去掉 --dry-run 即可真实执行。"
-_i18n_set en migrate.migrating_paths_via_git_mv "Migrating %s paths via git mv..."
-_i18n_set zh migrate.migrating_paths_via_git_mv "正在通过 git mv 迁移 %s 个路径..."
-_i18n_set en migrate.aborting_previous_moves_are_staged_but "Aborting; previous moves are staged but not committed. Run 'git reset --hard' to undo."
-_i18n_set zh migrate.aborting_previous_moves_are_staged_but "已 stage 但未 commit，运行 'git reset --hard' 回滚。"
-_i18n_set en migrate.migrated_paths_in_a_single_commit "Migrated %s paths in a single commit."
-_i18n_set zh migrate.migrated_paths_in_a_single_commit "已在单 commit 中迁移 %s 个路径。"
-_i18n_set en migrate.next_steps "  Next steps"
-_i18n_set zh migrate.next_steps "下一步："
-_i18n_set en migrate.summary "  ┌─"
-_i18n_set zh migrate.summary "操作摘要 Summary ──────────────────────────────────┐"
-_i18n_set en migrate.roll_convention_status_roll "%sRoll Convention Status  Roll"
-_i18n_set zh migrate.roll_convention_status_roll "约定状态%s"
-_i18n_set en migrate.roll_exists_roll "~/.roll/ exists  ~/.roll/"
-_i18n_set zh migrate.roll_exists_roll "已存在"
-_i18n_set en migrate.roll_not_found_run_roll_setup "~/.roll/ not found — run 'roll setup'  ~/.roll/"
-_i18n_set zh migrate.roll_not_found_run_roll_setup "不存在 — 请运行 'roll setup'"
-_i18n_set en migrate.global_conventions "%sGlobal conventions:"
-_i18n_set zh migrate.global_conventions "全局约定%s"
-_i18n_set en migrate.missing "  %s-%s %s (missing /"
-_i18n_set zh migrate.missing "缺失)"
-_i18n_set en migrate.global_skills "%sGlobal skills:"
-_i18n_set zh migrate.global_skills "全局技能%s"
-_i18n_set en migrate.roll_skills_skills_installed "  %s+%s ~/.roll/skills (%s skills installed /"
-_i18n_set zh migrate.roll_skills_skills_installed "已安装 %s 个技能)"
-_i18n_set en migrate.roll_skills_missing "  %s-%s ~/.roll/skills (missing /"
-_i18n_set zh migrate.roll_skills_missing "缺失)"
-_i18n_set en migrate.sync_targets "%sSync targets:"
-_i18n_set zh migrate.sync_targets "同步目标%s"
-_i18n_set en migrate.no_ai_tools_configured_check_roll "No AI tools configured — check ~/.roll/config.yaml"
-_i18n_set zh migrate.no_ai_tools_configured_check_roll "未配置 AI 工具 — 请检查 ~/.roll/config.yaml"
-_i18n_set en migrate.add_ai_entries_or_run_roll "Add ai_* entries or run 'roll setup' to restore defaults."
-_i18n_set zh migrate.add_ai_entries_or_run_roll "添加 ai_* 条目或运行 'roll setup' 恢复默认配置。"
-_i18n_set en migrate.skill_symlinks "%sSkill symlinks:"
-_i18n_set zh migrate.skill_symlinks "技能软链接%s"
-_i18n_set en migrate.roll_skills_mounted "  %s=%s %s: %s -> ~/.roll/skills (mounted /"
-_i18n_set zh migrate.roll_skills_mounted "已挂载)"
-_i18n_set en migrate.no_roll_skills_linked "  %s-%s %s: %s (no roll-* skills linked /"
-_i18n_set zh migrate.no_roll_skills_linked "未链接 roll-* 技能)"
-_i18n_set en migrate.not_found "  %s-%s %s: %s (not found /"
-_i18n_set zh migrate.not_found "未找到)"
-_i18n_set en migrate.no_ai_tools_configured_check_roll_2 "No AI tools configured — check ~/.roll/config.yaml"
-_i18n_set zh migrate.no_ai_tools_configured_check_roll_2 "未配置 AI 工具 — 请检查 ~/.roll/config.yaml"
-_i18n_set en migrate.templates "%sTemplates:"
-_i18n_set zh migrate.templates "模板%s"
-_i18n_set en migrate.missing_2 "  %s-%s %s (missing /"
-_i18n_set zh migrate.missing_2 "缺失)"
-
-_i18n_set en migrate.old_path "Old path"
-_i18n_set zh migrate.old_path "老路径"
-_i18n_set en migrate.new_path "New path"
-_i18n_set zh migrate.new_path "新路径"