@pecot/workflow-mcp 0.0.0-stage → 6.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 (287) hide show
  1. package/.claude-plugin/plugin.json +8 -0
  2. package/LICENSE +21 -0
  3. package/README.md +184 -2
  4. package/bin/pecot-workflow-mcp.mjs +10 -0
  5. package/cli/dist/cli.d.ts +26 -0
  6. package/cli/dist/cli.js +227 -0
  7. package/cli/dist/commands/board-add.d.ts +3 -0
  8. package/cli/dist/commands/board-add.js +59 -0
  9. package/cli/dist/commands/board-judgment.d.ts +60 -0
  10. package/cli/dist/commands/board-judgment.js +144 -0
  11. package/cli/dist/commands/board-move.d.ts +3 -0
  12. package/cli/dist/commands/board-move.js +57 -0
  13. package/cli/dist/commands/board-readiness.d.ts +34 -0
  14. package/cli/dist/commands/board-readiness.js +108 -0
  15. package/cli/dist/commands/board-show.d.ts +3 -0
  16. package/cli/dist/commands/board-show.js +72 -0
  17. package/cli/dist/commands/board-sync.d.ts +3 -0
  18. package/cli/dist/commands/board-sync.js +111 -0
  19. package/cli/dist/commands/board-view.d.ts +62 -0
  20. package/cli/dist/commands/board-view.js +191 -0
  21. package/cli/dist/commands/board.d.ts +3 -0
  22. package/cli/dist/commands/board.js +12 -0
  23. package/cli/dist/commands/branch.d.ts +3 -0
  24. package/cli/dist/commands/branch.js +100 -0
  25. package/cli/dist/commands/cell-table.d.ts +3 -0
  26. package/cli/dist/commands/cell-table.js +495 -0
  27. package/cli/dist/commands/command-binding.d.ts +26 -0
  28. package/cli/dist/commands/command-binding.js +270 -0
  29. package/cli/dist/commands/command-definition.d.ts +150 -0
  30. package/cli/dist/commands/command-definition.js +105 -0
  31. package/cli/dist/commands/command-help.d.ts +8 -0
  32. package/cli/dist/commands/command-help.js +173 -0
  33. package/cli/dist/commands/command-hint.d.ts +5 -0
  34. package/cli/dist/commands/command-hint.js +13 -0
  35. package/cli/dist/commands/command-stop.d.ts +21 -0
  36. package/cli/dist/commands/command-stop.js +31 -0
  37. package/cli/dist/commands/directory-option.d.ts +7 -0
  38. package/cli/dist/commands/directory-option.js +48 -0
  39. package/cli/dist/commands/failure-kind.d.ts +3 -0
  40. package/cli/dist/commands/failure-kind.js +34 -0
  41. package/cli/dist/commands/failure.d.ts +19 -0
  42. package/cli/dist/commands/failure.js +59 -0
  43. package/cli/dist/commands/fuzzy.d.ts +7 -0
  44. package/cli/dist/commands/fuzzy.js +79 -0
  45. package/cli/dist/commands/github-client.d.ts +16 -0
  46. package/cli/dist/commands/github-client.js +33 -0
  47. package/cli/dist/commands/global-options.d.ts +25 -0
  48. package/cli/dist/commands/global-options.js +83 -0
  49. package/cli/dist/commands/help-layout.d.ts +40 -0
  50. package/cli/dist/commands/help-layout.js +117 -0
  51. package/cli/dist/commands/help.d.ts +8 -0
  52. package/cli/dist/commands/help.js +50 -0
  53. package/cli/dist/commands/input-schema.d.ts +14 -0
  54. package/cli/dist/commands/input-schema.js +56 -0
  55. package/cli/dist/commands/issue-board.d.ts +71 -0
  56. package/cli/dist/commands/issue-board.js +122 -0
  57. package/cli/dist/commands/issue-comment.d.ts +3 -0
  58. package/cli/dist/commands/issue-comment.js +215 -0
  59. package/cli/dist/commands/issue-create.d.ts +3 -0
  60. package/cli/dist/commands/issue-create.js +786 -0
  61. package/cli/dist/commands/issue-dependency.d.ts +3 -0
  62. package/cli/dist/commands/issue-dependency.js +282 -0
  63. package/cli/dist/commands/issue-readiness.d.ts +94 -0
  64. package/cli/dist/commands/issue-readiness.js +218 -0
  65. package/cli/dist/commands/issue-reopen.d.ts +3 -0
  66. package/cli/dist/commands/issue-reopen.js +115 -0
  67. package/cli/dist/commands/issue-shared.d.ts +172 -0
  68. package/cli/dist/commands/issue-shared.js +426 -0
  69. package/cli/dist/commands/issue-show.d.ts +3 -0
  70. package/cli/dist/commands/issue-show.js +169 -0
  71. package/cli/dist/commands/issue.d.ts +3 -0
  72. package/cli/dist/commands/issue.js +13 -0
  73. package/cli/dist/commands/names.d.ts +42 -0
  74. package/cli/dist/commands/names.js +78 -0
  75. package/cli/dist/commands/output.d.ts +90 -0
  76. package/cli/dist/commands/output.js +194 -0
  77. package/cli/dist/commands/pr-waiting.d.ts +20 -0
  78. package/cli/dist/commands/pr-waiting.js +106 -0
  79. package/cli/dist/commands/pr.d.ts +22 -0
  80. package/cli/dist/commands/pr.js +852 -0
  81. package/cli/dist/commands/project-sync.d.ts +92 -0
  82. package/cli/dist/commands/project-sync.js +282 -0
  83. package/cli/dist/commands/project.d.ts +6 -0
  84. package/cli/dist/commands/project.js +714 -0
  85. package/cli/dist/commands/registry.d.ts +6 -0
  86. package/cli/dist/commands/registry.js +30 -0
  87. package/cli/dist/commands/release.d.ts +10 -0
  88. package/cli/dist/commands/release.js +353 -0
  89. package/cli/dist/commands/renamed-commands.d.ts +26 -0
  90. package/cli/dist/commands/renamed-commands.js +53 -0
  91. package/cli/dist/commands/repository-display.d.ts +3 -0
  92. package/cli/dist/commands/repository-display.js +7 -0
  93. package/cli/dist/commands/repository-match.d.ts +14 -0
  94. package/cli/dist/commands/repository-match.js +34 -0
  95. package/cli/dist/commands/rich-panel.d.ts +22 -0
  96. package/cli/dist/commands/rich-panel.js +295 -0
  97. package/cli/dist/commands/session-finish.d.ts +3 -0
  98. package/cli/dist/commands/session-finish.js +267 -0
  99. package/cli/dist/commands/session-start.d.ts +3 -0
  100. package/cli/dist/commands/session-start.js +236 -0
  101. package/cli/dist/commands/session.d.ts +6 -0
  102. package/cli/dist/commands/session.js +214 -0
  103. package/cli/dist/commands/tracker-sync-dependabot.d.ts +7 -0
  104. package/cli/dist/commands/tracker-sync-dependabot.js +156 -0
  105. package/cli/dist/commands/tracker-sync-security.d.ts +7 -0
  106. package/cli/dist/commands/tracker-sync-security.js +153 -0
  107. package/cli/dist/commands/tracker-sync.d.ts +65 -0
  108. package/cli/dist/commands/tracker-sync.js +50 -0
  109. package/cli/dist/commands/tracker.d.ts +3 -0
  110. package/cli/dist/commands/tracker.js +18 -0
  111. package/cli/dist/commands/usage-error.d.ts +51 -0
  112. package/cli/dist/commands/usage-error.js +78 -0
  113. package/cli/dist/commands/value-types.d.ts +46 -0
  114. package/cli/dist/commands/value-types.js +94 -0
  115. package/cli/dist/commands/work-target.d.ts +22 -0
  116. package/cli/dist/commands/work-target.js +82 -0
  117. package/cli/dist/commands/worktree.d.ts +3 -0
  118. package/cli/dist/commands/worktree.js +339 -0
  119. package/cli/dist/domain/api-error-detail.d.ts +10 -0
  120. package/cli/dist/domain/api-error-detail.js +25 -0
  121. package/cli/dist/domain/batch-plan.d.ts +73 -0
  122. package/cli/dist/domain/batch-plan.js +114 -0
  123. package/cli/dist/domain/blocked-by-change.d.ts +99 -0
  124. package/cli/dist/domain/blocked-by-change.js +101 -0
  125. package/cli/dist/domain/board-move.d.ts +90 -0
  126. package/cli/dist/domain/board-move.js +92 -0
  127. package/cli/dist/domain/branch-name.d.ts +5 -0
  128. package/cli/dist/domain/branch-name.js +10 -0
  129. package/cli/dist/domain/changelog.d.ts +43 -0
  130. package/cli/dist/domain/changelog.js +107 -0
  131. package/cli/dist/domain/command-hint.d.ts +85 -0
  132. package/cli/dist/domain/command-hint.js +148 -0
  133. package/cli/dist/domain/config.d.ts +219 -0
  134. package/cli/dist/domain/config.js +310 -0
  135. package/cli/dist/domain/dependabot-pull-requests.d.ts +82 -0
  136. package/cli/dist/domain/dependabot-pull-requests.js +338 -0
  137. package/cli/dist/domain/dependabot-source.d.ts +51 -0
  138. package/cli/dist/domain/dependabot-source.js +4 -0
  139. package/cli/dist/domain/dependabot.d.ts +47 -0
  140. package/cli/dist/domain/dependabot.js +88 -0
  141. package/cli/dist/domain/errors.d.ts +24 -0
  142. package/cli/dist/domain/errors.js +36 -0
  143. package/cli/dist/domain/field-options.d.ts +31 -0
  144. package/cli/dist/domain/field-options.js +44 -0
  145. package/cli/dist/domain/format.d.ts +94 -0
  146. package/cli/dist/domain/format.js +234 -0
  147. package/cli/dist/domain/frontmatter.d.ts +137 -0
  148. package/cli/dist/domain/frontmatter.js +290 -0
  149. package/cli/dist/domain/git-runner.d.ts +10 -0
  150. package/cli/dist/domain/git-runner.js +4 -0
  151. package/cli/dist/domain/git-url.d.ts +17 -0
  152. package/cli/dist/domain/git-url.js +30 -0
  153. package/cli/dist/domain/issue-kind.d.ts +16 -0
  154. package/cli/dist/domain/issue-kind.js +16 -0
  155. package/cli/dist/domain/issue-order.d.ts +55 -0
  156. package/cli/dist/domain/issue-order.js +65 -0
  157. package/cli/dist/domain/issue-readout.d.ts +143 -0
  158. package/cli/dist/domain/issue-readout.js +4 -0
  159. package/cli/dist/domain/json-null.d.ts +2 -0
  160. package/cli/dist/domain/json-null.js +5 -0
  161. package/cli/dist/domain/json.d.ts +21 -0
  162. package/cli/dist/domain/json.js +47 -0
  163. package/cli/dist/domain/prerequisites.d.ts +32 -0
  164. package/cli/dist/domain/prerequisites.js +192 -0
  165. package/cli/dist/domain/pull-request.d.ts +201 -0
  166. package/cli/dist/domain/pull-request.js +281 -0
  167. package/cli/dist/domain/python-format.d.ts +105 -0
  168. package/cli/dist/domain/python-format.js +304 -0
  169. package/cli/dist/domain/readiness.d.ts +199 -0
  170. package/cli/dist/domain/readiness.js +391 -0
  171. package/cli/dist/domain/reference-parser.d.ts +51 -0
  172. package/cli/dist/domain/reference-parser.js +123 -0
  173. package/cli/dist/domain/release.d.ts +53 -0
  174. package/cli/dist/domain/release.js +65 -0
  175. package/cli/dist/domain/repository-policy.d.ts +38 -0
  176. package/cli/dist/domain/repository-policy.js +66 -0
  177. package/cli/dist/domain/repository-resolver.d.ts +57 -0
  178. package/cli/dist/domain/repository-resolver.js +122 -0
  179. package/cli/dist/domain/sections.d.ts +69 -0
  180. package/cli/dist/domain/sections.js +514 -0
  181. package/cli/dist/domain/security-alerts-source.d.ts +29 -0
  182. package/cli/dist/domain/security-alerts-source.js +4 -0
  183. package/cli/dist/domain/security-alerts.d.ts +52 -0
  184. package/cli/dist/domain/security-alerts.js +107 -0
  185. package/cli/dist/domain/security-tracker.d.ts +115 -0
  186. package/cli/dist/domain/security-tracker.js +353 -0
  187. package/cli/dist/domain/state.d.ts +59 -0
  188. package/cli/dist/domain/state.js +95 -0
  189. package/cli/dist/domain/tracker-body.d.ts +70 -0
  190. package/cli/dist/domain/tracker-body.js +65 -0
  191. package/cli/dist/domain/work-start.d.ts +34 -0
  192. package/cli/dist/domain/work-start.js +49 -0
  193. package/cli/dist/domain/yaml-document.d.ts +5 -0
  194. package/cli/dist/domain/yaml-document.js +206 -0
  195. package/cli/dist/infra/authored-notes.d.ts +37 -0
  196. package/cli/dist/infra/authored-notes.js +72 -0
  197. package/cli/dist/infra/changelog-file.d.ts +19 -0
  198. package/cli/dist/infra/changelog-file.js +43 -0
  199. package/cli/dist/infra/child-stdin.d.ts +4 -0
  200. package/cli/dist/infra/child-stdin.js +8 -0
  201. package/cli/dist/infra/config-store.d.ts +53 -0
  202. package/cli/dist/infra/config-store.js +134 -0
  203. package/cli/dist/infra/diagnostics.d.ts +9 -0
  204. package/cli/dist/infra/diagnostics.js +2 -0
  205. package/cli/dist/infra/file-kind.d.ts +9 -0
  206. package/cli/dist/infra/file-kind.js +26 -0
  207. package/cli/dist/infra/frontmatter-file.d.ts +14 -0
  208. package/cli/dist/infra/frontmatter-file.js +30 -0
  209. package/cli/dist/infra/git.d.ts +86 -0
  210. package/cli/dist/infra/git.js +145 -0
  211. package/cli/dist/infra/github/auth.d.ts +60 -0
  212. package/cli/dist/infra/github/auth.js +158 -0
  213. package/cli/dist/infra/github/client.d.ts +178 -0
  214. package/cli/dist/infra/github/client.js +579 -0
  215. package/cli/dist/infra/github/dependabot-source.d.ts +13 -0
  216. package/cli/dist/infra/github/dependabot-source.js +33 -0
  217. package/cli/dist/infra/github/errors.d.ts +65 -0
  218. package/cli/dist/infra/github/errors.js +64 -0
  219. package/cli/dist/infra/github/index.d.ts +13 -0
  220. package/cli/dist/infra/github/index.js +19 -0
  221. package/cli/dist/infra/github/issues.d.ts +165 -0
  222. package/cli/dist/infra/github/issues.js +428 -0
  223. package/cli/dist/infra/github/payload.d.ts +44 -0
  224. package/cli/dist/infra/github/payload.js +80 -0
  225. package/cli/dist/infra/github/projects.d.ts +143 -0
  226. package/cli/dist/infra/github/projects.js +384 -0
  227. package/cli/dist/infra/github/pulls.d.ts +104 -0
  228. package/cli/dist/infra/github/pulls.js +217 -0
  229. package/cli/dist/infra/github/queries.d.ts +44 -0
  230. package/cli/dist/infra/github/queries.js +1031 -0
  231. package/cli/dist/infra/github/readout.d.ts +22 -0
  232. package/cli/dist/infra/github/readout.js +167 -0
  233. package/cli/dist/infra/github/repos.d.ts +86 -0
  234. package/cli/dist/infra/github/repos.js +168 -0
  235. package/cli/dist/infra/github/rest-path.d.ts +14 -0
  236. package/cli/dist/infra/github/rest-path.js +31 -0
  237. package/cli/dist/infra/github/security-alerts-source.d.ts +15 -0
  238. package/cli/dist/infra/github/security-alerts-source.js +73 -0
  239. package/cli/dist/infra/gitignore-spec.d.ts +36 -0
  240. package/cli/dist/infra/gitignore-spec.js +235 -0
  241. package/cli/dist/infra/nx-scope.d.ts +51 -0
  242. package/cli/dist/infra/nx-scope.js +182 -0
  243. package/cli/dist/infra/os-error.d.ts +24 -0
  244. package/cli/dist/infra/os-error.js +38 -0
  245. package/cli/dist/infra/paths.d.ts +88 -0
  246. package/cli/dist/infra/paths.js +234 -0
  247. package/cli/dist/infra/state-store.d.ts +54 -0
  248. package/cli/dist/infra/state-store.js +130 -0
  249. package/cli/dist/infra/template-store.d.ts +15 -0
  250. package/cli/dist/infra/template-store.js +34 -0
  251. package/cli/dist/infra/text-file.d.ts +12 -0
  252. package/cli/dist/infra/text-file.js +33 -0
  253. package/cli/dist/infra/worktree-copy.d.ts +24 -0
  254. package/cli/dist/infra/worktree-copy.js +95 -0
  255. package/cli/dist/infra/worktree-links.d.ts +142 -0
  256. package/cli/dist/infra/worktree-links.js +440 -0
  257. package/cli/dist/infra/worktree-setup.d.ts +21 -0
  258. package/cli/dist/infra/worktree-setup.js +41 -0
  259. package/cli/dist/infra/worktree.d.ts +185 -0
  260. package/cli/dist/infra/worktree.js +584 -0
  261. package/cli/dist/mcp/result.d.ts +61 -0
  262. package/cli/dist/mcp/result.js +96 -0
  263. package/cli/dist/mcp/serve.d.ts +51 -0
  264. package/cli/dist/mcp/serve.js +183 -0
  265. package/cli/dist/mcp/server.d.ts +21 -0
  266. package/cli/dist/mcp/server.js +142 -0
  267. package/cli/dist/mcp/session-directory.d.ts +26 -0
  268. package/cli/dist/mcp/session-directory.js +84 -0
  269. package/cli/dist/package.json +1 -0
  270. package/cli/dist/version.d.ts +17 -0
  271. package/cli/dist/version.js +42 -0
  272. package/cli/templates/comment/merge-diff.md +34 -0
  273. package/cli/templates/comment/plan.md +195 -0
  274. package/cli/templates/comment/precede-notify.md +33 -0
  275. package/cli/templates/comment/review-findings.md +42 -0
  276. package/cli/templates/comment/review-resolution.md +48 -0
  277. package/cli/templates/issue/bug.md +63 -0
  278. package/cli/templates/issue/epic.md +54 -0
  279. package/cli/templates/issue/task-implement.md +74 -0
  280. package/cli/templates/issue/task.md +48 -0
  281. package/cli/templates/issue/tracker.md +48 -0
  282. package/cli/templates/pr/create.md +123 -0
  283. package/cli/templates/pr/release.md +56 -0
  284. package/cli/templates/workflow/pecot-board-sync.yml +84 -0
  285. package/hooks/lib/core/pecot-gitignore-ensure.sh +48 -0
  286. package/npm-shrinkwrap.json +83 -0
  287. package/package.json +22 -4
@@ -0,0 +1,48 @@
1
+ ---
2
+ title: ""
3
+ type: tracker
4
+ repository: ""
5
+ status: backlog
6
+ priority: ""
7
+ size: ""
8
+ labels: []
9
+ parent_epic: ""
10
+ ---
11
+
12
+ <!--
13
+ 読者: この Tracker が束ねる対象を追う人(運用する人と AI)。何を束ね、どう運用するかを確かめて、sub-issue の表示と見比べる。末尾の「例:」の形で書く。
14
+
15
+ 書き方:
16
+ - 見出しの `—` の後は、何がどうなったか(どうなるか)を、主語と述語のある 1 文で書く
17
+ - 束ねる対象は、対象の種類と集め方を書く。個々の Issue へのリンク・担当・進み具合は書かない(sub-issue の表示とボードが見せる)
18
+
19
+ フィールド:
20
+ - repository: `--repo owner/repo` 必須(Tracker は aggregation_repo へ寄せない)
21
+ - 起票ルール: skills/w-help/references/issue-flow-rules.md (投稿先の判定基準)
22
+
23
+ 例:
24
+
25
+ ## Scope — 依存パッケージの脆弱性の通知を、このリポジトリの Issue として束ねる
26
+
27
+ - 束ねる対象 — 依存パッケージの脆弱性の通知 1 件につき sub-issue 1 件
28
+
29
+ - 集め方 — 毎時の確認が、新しい通知を sub-issue に足す
30
+
31
+ ## Operation — 通知が直ったら、その sub-issue を閉じる
32
+
33
+ - 閉じ方 — 通知が解消したら sub-issue を閉じる
34
+
35
+ - この Issue — sub-issue を持つ間は閉じない
36
+ -->
37
+
38
+ ## Scope — <束ねる対象を1行で>
39
+
40
+ - 束ねる対象 — <対象の種類と、sub-issue 1 件の単位>
41
+
42
+ - 集め方 — <sub-issue を足す手段>
43
+
44
+ ## Operation — <運用の決まりを1行で>
45
+
46
+ - 閉じ方 — <sub-issue を閉じる条件>
47
+
48
+ - この Issue — <この Issue を閉じる条件>
@@ -0,0 +1,123 @@
1
+ ---
2
+ title: ""
3
+ repository: ""
4
+ base: ""
5
+ head: ""
6
+ draft: false
7
+ screenshot: ""
8
+ ---
9
+
10
+ <!--
11
+ 読者: この PR をマージしてよいかを判断する人と、後で履歴から PR を見返す人。どちらも作業の経緯を知らない。末尾の「例:」の形で書く。
12
+
13
+ 書き方:
14
+ - Changes には振る舞いの変化を書く。利用者が打つ操作(コマンド・設定・画面の操作)と、そのとき見える結果が、変更の前後でどう変わるか。どのファイル・関数をどう直したかは書かない(Files changed が見せる)
15
+ - Changes は、変化ごとに番号付きの `###` の小見出しを立てる。小見出しは、何がどう変わるかを主語と述語のある文で書く(`### 1. <何が><どう変わる>`)。直下の太字の 1 文で、利用者の操作と結果を言い切る
16
+ - 次のどれかが変わる変更は、結果のスクリーンショットを撮って Summary に置く。画面、ツールが生成して利用者が GitHub で見る Markdown(Issue・PR の本文、コメント、Tracker の表)、利用者が読む CLI の出力の文である。CHANGELOG・README・SKILL.md の文の変更は含めない。載せ方・撮り方は w-pr スキルの手順にある
17
+ - Verified は、CUJ ごとに `###` の小見出し(`### CUJ 1 — <何が><どうなる>`)を立て、誰が・起点・合格基準・結果を書いて、打ったコマンドと出力をそのまま載せる
18
+ - 末尾の `Closes #` には sub-issue の番号だけを入れる(Epic の番号を入れると、マージで Epic が閉じる)。`pr create --prepare` が作業中の Issue の番号を入れる
19
+
20
+ フィールド:
21
+ - repository: 必須。PR 先の `owner/repo`(`git remote -v` の URL。origin、無ければ最初の remote のもの)
22
+ - screenshot: 画像を Summary に入れたら空のまま。入れないなら、入れない理由を `"..."` で囲んで書く
23
+ - 例: `"CLI の内部の整理だけで、画面・生成する Markdown・出力の文は変わらない"`
24
+ - title: `"type(scope): #ISSUE タイトル"` の形で `"..."` で囲む(囲まないと ` #ISSUE` 以降が YAML のコメントになる)。type は feat / fix / docs / chore / refactor / test / ci / build / perf / revert
25
+ - title の scope(nx を使うリポ = config の `release_type` が `nx`): 変更した nx プロジェクトの scope
26
+ - scope は、プロジェクトの `project.json` の `tags` にある `scope:<名前>` の値。tag が無ければプロジェクト名
27
+ - 複数は空白なしの `,` 区切り。どのプロジェクトにも属さないファイルがあれば `repo` を加える(`.nx/version-plans/` は数えない)
28
+ - `pr create --prepare` が算出した scope を title の行のコメント(`# expected scope: ...`)に書き、`pecot pr create` が食い違いを止める
29
+ - title の scope(nx を使わないリポ): 付けない(`type: #ISSUE タイトル`)
30
+
31
+ 例:
32
+
33
+ ## Summary
34
+
35
+ `mytool export` で、**CSV のファイルを書き出せる**ようにしました。これまでは JSON しか書き出せず、表計算ソフトで開くには利用者が自分で変換していました。
36
+
37
+ ![mytool export --format csv で書き出したファイルを表計算ソフトで開いた画面](./export-csv.png)
38
+
39
+ ## Changes
40
+
41
+ ### 1. `mytool export` が CSV のファイルを書き出せるようになる
42
+
43
+ **`mytool export --format csv` で、CSV のファイルを書き出せるようになりました**。これまでは `--format` という引数が無く、打つと「unknown option」で止まっていました。
44
+
45
+ 書き出したファイルは、表計算ソフトでそのまま開けます。列の順は `mytool list` の表示と同じなので、画面で見ていた並びのまま表になります。値にカンマや改行を含むときは、ダブルクォートで囲んで 1 つのセルに収めます。
46
+
47
+ ### 2. 不正な形式の名前を渡すと、使える値を示して止まる
48
+
49
+ **`--format` に `csv` と `json` 以外を渡すと、使える値を示して止まるようになりました**。たとえば `--format xml` と打つと、「csv か json を指定してください」と出て、ファイルは書き出しません。
50
+
51
+ ### 3. `--format` を省いたときの動きは変わらない
52
+
53
+ **`--format` を付けずに打ったときの動きは変わりません**。今までどおり JSON を書き出すので、`mytool export` を使っている既存のスクリプトはそのまま動きます。
54
+
55
+ ### 打つコマンドごとに、結果が次のように変わる
56
+
57
+ | 打つコマンド | 変更前 | 変更後 |
58
+ |---|---|---|
59
+ | `mytool export` | JSON を書き出す | JSON を書き出す(変わらない) |
60
+ | `mytool export --format csv` | 「unknown option」で止まる | CSV を書き出す |
61
+ | `mytool export --format xml` | 「unknown option」で止まる | 「csv か json を指定してください」で止まる |
62
+
63
+ ## Verified
64
+
65
+ ### CUJ 1 — CSV で書き出したファイルが表計算ソフトで開ける
66
+
67
+ - 誰が — 利用者(自分の端末で、このブランチの mytool を打つ)
68
+ - 起点 — `mytool export --format csv > out.csv`(値にカンマを含む行を足してから)
69
+ - 合格基準 — 1 行目が `mytool list` と同じ列の見出しで、カンマを含む値が 1 つのセルに収まる
70
+ - 結果 — 合格。表計算ソフトで開いた画面は Summary の画像のとおり
71
+
72
+ ```console
73
+ $ mytool export --format csv > out.csv
74
+ $ head -3 out.csv
75
+ name,date,note
76
+ alpha,2026-10-02,"a, b"
77
+ beta,2026-10-03,c
78
+ ```
79
+
80
+ ### CUJ 2 — 不正な形式の名前を渡すと、`mytool export` が止まる
81
+
82
+ - 誰が — 利用者(同上)
83
+ - 起点 — `mytool export --format xml`
84
+ - 合格基準 — 使える値を示して、終了コード 1 で止まる
85
+ - 結果 — 合格
86
+
87
+ ```console
88
+ $ mytool export --format xml
89
+ csv か json を指定してください
90
+ (exit 1)
91
+ ```
92
+
93
+ ### 変更箇所の単体テストが通る
94
+
95
+ ```bash
96
+ pytest tests/test_export.py
97
+ # 24 passed
98
+ ```
99
+
100
+ ## Risks
101
+
102
+ 入れ子の値は、CSV では JSON の文字列として 1 つのセルに入ります。表計算ソフトでは、そのまま文字列として見えます。
103
+
104
+ Closes #123
105
+ -->
106
+
107
+ ## Summary
108
+
109
+ <何が・なぜ変わったか>
110
+
111
+ ## Changes
112
+
113
+ <振る舞いの変化。操作ごとの変更前と変更後>
114
+
115
+ ## Verified
116
+
117
+ <確かめたことと結果>
118
+
119
+ ## Risks
120
+
121
+ <マージ後に残る懸念とその影響。無ければ「なし」>
122
+
123
+ Closes #
@@ -0,0 +1,56 @@
1
+ ---
2
+ title: ""
3
+ repository: ""
4
+ base: "main"
5
+ head: ""
6
+ draft: false
7
+ ---
8
+
9
+ <!--
10
+ 読者: このリリースを公開してよいかを判断する人と、後で履歴からリリースを見返す人。どちらもリリースまでの経緯を知らない。末尾の「例:」の形で書く。
11
+
12
+ 書き方:
13
+ - Changes は CHANGELOG.md の該当バージョン節を転記する。Nx Release が生成する節見出しの先頭記号は外す(`### 🚀 Features` は `### Features` として転記)
14
+
15
+ 例:
16
+
17
+ ## Summary
18
+
19
+ **mytool 1.4.0** を公開します。`mytool export` が CSV で書き出せるようになり、`mytool list --sort date` の並び順の誤りが直ります。
20
+
21
+ ## Changes
22
+
23
+ ### Features
24
+
25
+ - `mytool export` に `--format csv` を追加した (#123)
26
+
27
+ ### Fixes
28
+
29
+ - `mytool list --sort date` が日付を文字列として並べていた誤りを直した (#130)
30
+
31
+ ## Migration
32
+
33
+ なし
34
+
35
+ ## Verified
36
+
37
+ - CHANGELOG.md の 1.4.0 の節に、上の 2 件があることを確かめました。
38
+ - リリースのブランチで、全テストが通りました。
39
+ - README の `mytool export` の節に、`--format csv` を足しました。
40
+ -->
41
+
42
+ ## Summary
43
+
44
+ <このリリースで利用者に何が届くか>
45
+
46
+ ## Changes
47
+
48
+ <CHANGELOG.md の該当バージョン節を転記>
49
+
50
+ ## Migration
51
+
52
+ <利用者の手順が変わる点。該当なしなら「なし」>
53
+
54
+ ## Verified
55
+
56
+ <公開してよいと判断した根拠>
@@ -0,0 +1,84 @@
1
+ # Place this file at .github/workflows/pecot-board-sync.yml in your repository.
2
+ #
3
+ # This workflow runs `pecot board sync` after PRs and issues change.
4
+ # The command fixes the Status column and label of the pecot project board.
5
+ # It reads the whole board on every run, so the trigger only decides when it runs.
6
+ #
7
+ # Set one of the two token setups in Settings > Secrets and variables > Actions.
8
+ # The job is skipped until one of them exists.
9
+ # GitHub App.
10
+ # Use it when the board and this repository have the same organization as owner.
11
+ # The token covers only the installation on that owner (owner: github.repository_owner).
12
+ # Set variable PECOT_BOARD_SYNC_APP_CLIENT_ID.
13
+ # Set secret PECOT_BOARD_SYNC_APP_PRIVATE_KEY.
14
+ # Personal access token.
15
+ # Use it for a personal account board, or when the board owner differs from the repository.
16
+ # Set variable PECOT_BOARD_SYNC_USE_PAT to true.
17
+ # Set secret PECOT_BOARD_SYNC_TOKEN.
18
+ #
19
+ # GitHub Enterprise Server names the token variable after the host.
20
+ # The name is PECOT_GITHUB_<HOST>_TOKEN, with the host upper-cased and dots replaced by underscores.
21
+ # For example, ghe.example.com gives PECOT_GITHUB_GHE_EXAMPLE_COM_TOKEN.
22
+ # Change the name under `env:` in the last step.
23
+ #
24
+ # pull_request_target runs the workflow from the default branch.
25
+ # Secrets are passed to PRs from forks, so this workflow never checks out code from a PR.
26
+ name: pecot board sync
27
+
28
+ on:
29
+ pull_request_target:
30
+ types: [opened, reopened, closed, ready_for_review, converted_to_draft]
31
+ issues:
32
+ types: [closed, reopened]
33
+ workflow_dispatch:
34
+ # Optional periodic run. Choose the interval and uncomment.
35
+ # Actions minutes are billed for private repositories.
36
+ # schedule:
37
+ # - cron: "0 * * * *"
38
+
39
+ permissions:
40
+ contents: read
41
+
42
+ concurrency:
43
+ group: pecot-board-sync
44
+ cancel-in-progress: false
45
+
46
+ jobs:
47
+ sync:
48
+ # A job-level if cannot read secrets, so variables tell whether a token is set up.
49
+ # Runs started by Dependabot are skipped because secrets are not always passed to them.
50
+ # The actor is whoever started the run, so a human merging a Dependabot PR still runs.
51
+ if: ${{ (vars.PECOT_BOARD_SYNC_APP_CLIENT_ID != '' || vars.PECOT_BOARD_SYNC_USE_PAT == 'true') && github.actor != 'dependabot[bot]' }}
52
+ runs-on: ubuntu-latest
53
+ timeout-minutes: 15
54
+ steps:
55
+ # No ref: the default branch is checked out, which holds the project settings.
56
+ - name: Checkout
57
+ uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
58
+ with:
59
+ persist-credentials: false
60
+
61
+ - name: Set up Node.js
62
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
63
+ with:
64
+ node-version: "24.22.1"
65
+
66
+ - name: Generate GitHub App token
67
+ id: app-token
68
+ if: ${{ vars.PECOT_BOARD_SYNC_APP_CLIENT_ID != '' }}
69
+ uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
70
+ with:
71
+ client-id: ${{ vars.PECOT_BOARD_SYNC_APP_CLIENT_ID }}
72
+ private-key: ${{ secrets.PECOT_BOARD_SYNC_APP_PRIVATE_KEY }}
73
+ owner: ${{ github.repository_owner }}
74
+ permission-organization-projects: write
75
+ permission-issues: read
76
+ permission-pull-requests: read
77
+ permission-contents: read
78
+
79
+ # Pin the major version here. Raise it when the plugin's major version is raised.
80
+ # --prefix=/ keeps npx from stopping in a repository that declares pnpm devEngines.
81
+ - name: Sync the board
82
+ env:
83
+ PECOT_GITHUB_COM_TOKEN: ${{ steps.app-token.outputs.token || secrets.PECOT_BOARD_SYNC_TOKEN }}
84
+ run: npx -y --prefix=/ @pecot/workflow-mcp@6 board sync
@@ -0,0 +1,48 @@
1
+ #!/usr/bin/env bash
2
+ # .pecot/.gitignore を生成する。中身の定義はこのスクリプトを単一の出所とする。
3
+ #
4
+ # 中身は許可の一覧で、`*` で全部を除外し、追跡する設定だけを `!` で戻す。
5
+ # 追跡している .pecot/.gitignore は書き換えない(無関係のブランチに差が出るため)。
6
+ # 書くのは、ファイルが無いか追跡していないときだけ。git 外・git 不在は追跡なしとして書く。
7
+ #
8
+ # 使い方: pecot-gitignore-ensure.sh [--print]
9
+ # --print 書かずに定義を標準出力へ出す(CLAUDE_PROJECT_DIR は不要)。
10
+ set -euo pipefail
11
+
12
+ _print_definition() {
13
+ cat <<'GITIGNORE_EOF'
14
+ # pecot の設定だけを追跡し、生成物は管理外にする許可の一覧。
15
+ *
16
+ !/config/
17
+ /config/*
18
+ !/config/worktree-config.json
19
+ !/config/.worktreeignore
20
+ !/config/projects/
21
+ /config/projects/*
22
+ !/config/projects/*.json
23
+ GITIGNORE_EOF
24
+ }
25
+
26
+ if [[ "${1:-}" == "--print" ]]; then
27
+ _print_definition
28
+ exit 0
29
+ fi
30
+
31
+ [[ -z "${CLAUDE_PROJECT_DIR:-}" ]] && exit 0
32
+
33
+ PECOT_DIR="${CLAUDE_PROJECT_DIR}/.pecot"
34
+ TARGET="${PECOT_DIR}/.gitignore"
35
+
36
+ if [[ -f "$TARGET" ]] && command -v git >/dev/null 2>&1 \
37
+ && git -C "$CLAUDE_PROJECT_DIR" ls-files --error-unmatch -- .pecot/.gitignore >/dev/null 2>&1; then
38
+ exit 0
39
+ fi
40
+
41
+ mkdir -p "$PECOT_DIR"
42
+
43
+ # 並行発火でも空ファイルが生じないよう、一時ファイルへ書いて mv(同一 filesystem でアトミック)。
44
+ _TMP=$(mktemp "${PECOT_DIR}/.gitignore.XXXXXX")
45
+ trap 'rm -f "$_TMP"' EXIT
46
+
47
+ _print_definition > "$_TMP"
48
+ mv -f "$_TMP" "$TARGET"
@@ -0,0 +1,83 @@
1
+ {
2
+ "name": "@pecot/workflow-mcp",
3
+ "version": "6.0.0",
4
+ "lockfileVersion": 3,
5
+ "requires": true,
6
+ "packages": {
7
+ "": {
8
+ "name": "@pecot/workflow-mcp",
9
+ "version": "6.0.0",
10
+ "license": "MIT",
11
+ "dependencies": {
12
+ "@modelcontextprotocol/server": "^2.4.0",
13
+ "commander": "^15.1.0",
14
+ "yaml": "^2.9.1",
15
+ "zod": "^4.6.7"
16
+ },
17
+ "bin": {
18
+ "pecot-workflow-mcp": "bin/pecot-workflow-mcp.mjs"
19
+ },
20
+ "engines": {
21
+ "node": "^24.22.1 || >=26.12.1"
22
+ }
23
+ },
24
+ "node_modules/@modelcontextprotocol/core": {
25
+ "version": "2.4.0",
26
+ "resolved": "https://registry.npmjs.org/@modelcontextprotocol/core/-/core-2.4.0.tgz",
27
+ "integrity": "sha512-z8QBKqdfXLPzkLQuG4xp8hrVEMm1PZ1IgxMN2sMbJiFiAKOWXnAzogXn2W4aqIBlP1ea6U5yiqVquvUNM1Cj6Q==",
28
+ "license": "Apache-2.0",
29
+ "dependencies": {
30
+ "zod": "^4.2.0"
31
+ },
32
+ "engines": {
33
+ "node": ">=20"
34
+ }
35
+ },
36
+ "node_modules/@modelcontextprotocol/server": {
37
+ "version": "2.4.0",
38
+ "resolved": "https://registry.npmjs.org/@modelcontextprotocol/server/-/server-2.4.0.tgz",
39
+ "integrity": "sha512-rgR9yxSaAJ+bcsi/XroT/S2AfPiIWloXAnrdfYSCms9ivVju0ishu/wW0J21Ho6+ZOR1r7RyeRbjiRuF87ix5Q==",
40
+ "license": "Apache-2.0",
41
+ "dependencies": {
42
+ "@modelcontextprotocol/core": "2.4.0",
43
+ "zod": "^4.2.0"
44
+ },
45
+ "engines": {
46
+ "node": ">=20"
47
+ }
48
+ },
49
+ "node_modules/commander": {
50
+ "version": "15.1.0",
51
+ "resolved": "https://registry.npmjs.org/commander/-/commander-15.1.0.tgz",
52
+ "integrity": "sha512-cgnQ88TRrWcC7pVq46RzJVRMktu3W2RcbnoidnfBsl1bmDCBwJS/udcIZpKoCrbAYYaCqsz1yZCVIgbIaU3ddQ==",
53
+ "license": "MIT",
54
+ "engines": {
55
+ "node": ">=22.12.0"
56
+ }
57
+ },
58
+ "node_modules/yaml": {
59
+ "version": "2.9.1",
60
+ "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz",
61
+ "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==",
62
+ "license": "ISC",
63
+ "bin": {
64
+ "yaml": "bin.mjs"
65
+ },
66
+ "engines": {
67
+ "node": ">= 14.6"
68
+ },
69
+ "funding": {
70
+ "url": "https://github.com/sponsors/eemeli"
71
+ }
72
+ },
73
+ "node_modules/zod": {
74
+ "version": "4.6.7",
75
+ "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
76
+ "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
77
+ "license": "MIT",
78
+ "funding": {
79
+ "url": "https://github.com/sponsors/colinhacks"
80
+ }
81
+ }
82
+ }
83
+ }
package/package.json CHANGED
@@ -1,6 +1,24 @@
1
1
  {
2
2
  "name": "@pecot/workflow-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "6.0.0",
4
+ "type": "module",
5
+ "description": "pecot-workflow MCP server (standalone distribution)",
6
+ "license": "MIT",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/pecotcraft/pecot.git",
10
+ "directory": "plugins/pecot-workflow"
11
+ },
12
+ "bin": {
13
+ "pecot-workflow-mcp": "bin/pecot-workflow-mcp.mjs"
14
+ },
15
+ "engines": {
16
+ "node": "^24.22.1 || >=26.12.1"
17
+ },
18
+ "dependencies": {
19
+ "@modelcontextprotocol/server": "^2.4.0",
20
+ "commander": "^15.1.0",
21
+ "yaml": "^2.9.1",
22
+ "zod": "^4.6.7"
23
+ }
24
+ }