clawt 2.20.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +10 -0
  2. package/dist/index.js +395 -133
  3. package/dist/postinstall.js +35 -6
  4. package/docs/alias.md +108 -0
  5. package/docs/completion.md +55 -0
  6. package/docs/config-file.md +43 -0
  7. package/docs/config.md +91 -0
  8. package/docs/create.md +85 -0
  9. package/docs/init.md +65 -0
  10. package/docs/list.md +67 -0
  11. package/docs/log.md +67 -0
  12. package/docs/merge.md +137 -0
  13. package/docs/notification.md +94 -0
  14. package/docs/projects.md +135 -0
  15. package/docs/remove.md +79 -0
  16. package/docs/reset.md +35 -0
  17. package/docs/resume.md +99 -0
  18. package/docs/run.md +146 -0
  19. package/docs/spec.md +156 -1905
  20. package/docs/status.md +155 -0
  21. package/docs/sync.md +114 -0
  22. package/docs/update-check.md +95 -0
  23. package/docs/validate.md +368 -0
  24. package/package.json +1 -1
  25. package/src/commands/alias.ts +1 -1
  26. package/src/commands/create.ts +10 -5
  27. package/src/commands/init.ts +75 -0
  28. package/src/commands/list.ts +1 -1
  29. package/src/commands/merge.ts +11 -4
  30. package/src/commands/remove.ts +10 -3
  31. package/src/commands/reset.ts +3 -0
  32. package/src/commands/resume.ts +1 -1
  33. package/src/commands/run.ts +9 -3
  34. package/src/commands/status.ts +1 -1
  35. package/src/commands/sync.ts +18 -6
  36. package/src/commands/validate.ts +46 -52
  37. package/src/constants/branch.ts +3 -0
  38. package/src/constants/config.ts +1 -1
  39. package/src/constants/index.ts +2 -2
  40. package/src/constants/messages/completion.ts +1 -1
  41. package/src/constants/messages/create.ts +3 -0
  42. package/src/constants/messages/index.ts +2 -0
  43. package/src/constants/messages/init.ts +18 -0
  44. package/src/constants/messages/remove.ts +2 -0
  45. package/src/constants/messages/sync.ts +3 -0
  46. package/src/constants/messages/validate.ts +6 -0
  47. package/src/constants/paths.ts +3 -0
  48. package/src/index.ts +2 -0
  49. package/src/types/command.ts +7 -1
  50. package/src/types/index.ts +2 -1
  51. package/src/types/projectConfig.ts +5 -0
  52. package/src/utils/config.ts +2 -1
  53. package/src/utils/git.ts +18 -0
  54. package/src/utils/index.ts +5 -0
  55. package/src/utils/json.ts +67 -0
  56. package/src/utils/project-config.ts +77 -0
  57. package/src/utils/validate-branch.ts +166 -0
  58. package/src/utils/worktree.ts +6 -2
  59. package/tests/unit/commands/create.test.ts +20 -16
  60. package/tests/unit/commands/init.test.ts +146 -0
  61. package/tests/unit/commands/merge.test.ts +7 -1
  62. package/tests/unit/commands/remove.test.ts +4 -0
  63. package/tests/unit/commands/reset.test.ts +2 -0
  64. package/tests/unit/commands/run.test.ts +2 -0
  65. package/tests/unit/commands/sync.test.ts +6 -0
  66. package/tests/unit/commands/validate.test.ts +13 -0
  67. package/tests/unit/utils/config.test.ts +2 -2
  68. package/tests/unit/utils/project-config.test.ts +136 -0
  69. package/tests/unit/utils/update-checker.test.ts +28 -7
  70. package/tests/unit/utils/validate-branch.test.ts +272 -0
  71. package/tests/unit/utils/worktree.test.ts +6 -0
package/README.md CHANGED
@@ -38,6 +38,16 @@ clawt merge -b branch-1 -m "feat: 实现xxx功能"
38
38
 
39
39
  > 所有命令必须在**主 worktree 的仓库根目录**下执行。`-b` 参数支持模糊匹配。
40
40
 
41
+ ### `clawt init` — 初始化项目级配置
42
+
43
+ ```bash
44
+ clawt init # 以当前分支作为主工作分支进行初始化
45
+ clawt init -b <branch> # 指定主工作分支名
46
+ clawt init show # 查看当前项目的 init 配置（JSON 格式）
47
+ ```
48
+
49
+ 设置项目的主工作分支。重复执行会更新主工作分支配置。
50
+
41
51
  ### `clawt run` — 创建 worktree 并执行任务
42
52
 
43
53
  ```bash