@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,65 @@
1
+ import { PecotError } from '../../domain/errors.js';
2
+ export interface GitHubErrorDetail {
3
+ /**
4
+ HTTP の状態コード(該当する場合)
5
+ */
6
+ readonly statusCode?: number | undefined;
7
+ /**
8
+ 応答の本文(該当する場合)
9
+ */
10
+ readonly responseBody?: string | undefined;
11
+ /**
12
+ GraphQL の errors[0] の type(NOT_FOUND など。該当する場合)
13
+ */
14
+ readonly errorType?: string | undefined;
15
+ /**
16
+ 元の例外
17
+ */
18
+ readonly cause?: unknown;
19
+ }
20
+ /**
21
+ GitHub API 操作エラーの基底
22
+ */
23
+ export declare class GitHubAPIError extends PecotError {
24
+ readonly statusCode: number | undefined;
25
+ readonly responseBody: string | undefined;
26
+ readonly errorType: string | undefined;
27
+ constructor(message: string, detail?: Readonly<GitHubErrorDetail>);
28
+ }
29
+ /**
30
+ 認証エラー(401 Unauthorized)。トークンが無効または期限切れのときに起きる
31
+ */
32
+ export declare class GitHubAuthError extends GitHubAPIError {
33
+ }
34
+ /**
35
+ リソースが見つからない(404 Not Found)。指定したリポジトリ・Issue・プロジェクトが無いときに起きる
36
+ */
37
+ export declare class GitHubNotFoundError extends GitHubAPIError {
38
+ }
39
+ /**
40
+ レート制限エラー(403 Forbidden で rate limit を超えたとき)
41
+ */
42
+ export declare class GitHubRateLimitError extends GitHubAPIError {
43
+ }
44
+ /**
45
+ Issue の依存関係(blockedBy など)に対応しない GHES(3.19 より前)のエラー。スキーマの失敗を、ほかの GitHubAPIError と見分けるために使う
46
+ */
47
+ export declare class DependenciesUnsupportedError extends GitHubAPIError {
48
+ }
49
+ /**
50
+ GraphQL の errors の NOT_FOUND を GitHubNotFoundError にする。文は変えない。GitHub は無い Issue を data の null でなくこの形で返すことがある
51
+ */
52
+ export declare function asNotFoundError(error: unknown): unknown;
53
+ /**
54
+ このエラーが、ブランチ(ref)がもう無いことを表すか。`Reference does not exist` を含む 404・422 だけを「無い」と見なす
55
+ */
56
+ export declare function isMissingReferenceError(error: Readonly<GitHubAPIError>): boolean;
57
+ /**
58
+ 別の要求が同時に閉じたことを示す 422 か(PR の Closes による自動 close など)
59
+ */
60
+ export declare function isClosedByAnotherRequest(error: Readonly<GitHubAPIError>): boolean;
61
+ /**
62
+ 古い GHES が、対応しないフィールドに返すスキーマの失敗か
63
+ */
64
+ export declare function isSchemaError(error: unknown): error is GitHubAPIError;
65
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1,64 @@
1
+ // GitHub API 操作の例外。Python の cli/core/github/errors.py と同じ階層にする。
2
+ import { PecotError } from '../../domain/errors.js';
3
+ /**
4
+ GitHub API 操作エラーの基底
5
+ */
6
+ export class GitHubAPIError extends PecotError {
7
+ statusCode;
8
+ responseBody;
9
+ errorType;
10
+ constructor(message, detail = {}) {
11
+ super(message, detail.cause === undefined ? undefined : { cause: detail.cause });
12
+ this.statusCode = detail.statusCode;
13
+ this.responseBody = detail.responseBody;
14
+ this.errorType = detail.errorType;
15
+ }
16
+ }
17
+ /**
18
+ 認証エラー(401 Unauthorized)。トークンが無効または期限切れのときに起きる
19
+ */
20
+ export class GitHubAuthError extends GitHubAPIError {
21
+ }
22
+ /**
23
+ リソースが見つからない(404 Not Found)。指定したリポジトリ・Issue・プロジェクトが無いときに起きる
24
+ */
25
+ export class GitHubNotFoundError extends GitHubAPIError {
26
+ }
27
+ /**
28
+ レート制限エラー(403 Forbidden で rate limit を超えたとき)
29
+ */
30
+ export class GitHubRateLimitError extends GitHubAPIError {
31
+ }
32
+ /**
33
+ Issue の依存関係(blockedBy など)に対応しない GHES(3.19 より前)のエラー。スキーマの失敗を、ほかの GitHubAPIError と見分けるために使う
34
+ */
35
+ export class DependenciesUnsupportedError extends GitHubAPIError {
36
+ }
37
+ /**
38
+ GraphQL の errors の NOT_FOUND を GitHubNotFoundError にする。文は変えない。GitHub は無い Issue を data の null でなくこの形で返すことがある
39
+ */
40
+ export function asNotFoundError(error) {
41
+ return error instanceof GitHubAPIError && !(error instanceof GitHubNotFoundError) && error.errorType === 'NOT_FOUND'
42
+ ? new GitHubNotFoundError(error.message, { cause: error, errorType: error.errorType })
43
+ : error;
44
+ }
45
+ /**
46
+ このエラーが、ブランチ(ref)がもう無いことを表すか。`Reference does not exist` を含む 404・422 だけを「無い」と見なす
47
+ */
48
+ export function isMissingReferenceError(error) {
49
+ return (error.statusCode === 404 || error.statusCode === 422) && error.responseBody?.includes('Reference does not exist') === true;
50
+ }
51
+ /**
52
+ 別の要求が同時に閉じたことを示す 422 か(PR の Closes による自動 close など)
53
+ */
54
+ export function isClosedByAnotherRequest(error) {
55
+ return error.statusCode === 422 && error.responseBody?.includes('closed by another request') === true;
56
+ }
57
+ const SCHEMA_ERROR_PHRASES = ['Cannot query field', 'doesn\'t exist', 'Unknown field'];
58
+ /**
59
+ 古い GHES が、対応しないフィールドに返すスキーマの失敗か
60
+ */
61
+ export function isSchemaError(error) {
62
+ return error instanceof GitHubAPIError && SCHEMA_ERROR_PHRASES.some(phrase => error.message.includes(phrase));
63
+ }
64
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1,13 @@
1
+ import { PullsApi } from './pulls.js';
2
+ /**
3
+ GitHub API クライアント。操作は責務別のクラスから合成する。
4
+
5
+ 使い方は次のとおり。
6
+ - 作る: `new GitHubClient({ host: 'ghes.example.com', diagnostics })`。
7
+ - 呼ぶ: `await client.getIssueSlim('owner', 'repo', 123)`。
8
+
9
+ RepositoryMembership(domain/config.ts)と同じ形の linkedRepositories も持つ。
10
+ */
11
+ export declare class GitHubClient extends PullsApi {
12
+ }
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,19 @@
1
+ // GitHub API クライアント(REST と GraphQL、github.com と GHES に対応)。cli/core/github/__init__.py の移植。
2
+ //
3
+ // Python は IssuesAPI・ProjectsAPI・PullsAPI・ReposAPI の多重継承で合成していた。
4
+ // TypeScript は継承を一直線につなぐ。基底 → repos → projects → issues → pulls の順で、各ファイルが前のクラスを拡張する。
5
+ // この順は合成のための並びで、操作の依存を表さない。
6
+ // 操作どうしの実際の依存は projects が repos の getRepositoryId を呼ぶ 1 本だけ。
7
+ import { PullsApi } from './pulls.js';
8
+ /**
9
+ GitHub API クライアント。操作は責務別のクラスから合成する。
10
+
11
+ 使い方は次のとおり。
12
+ - 作る: `new GitHubClient({ host: 'ghes.example.com', diagnostics })`。
13
+ - 呼ぶ: `await client.getIssueSlim('owner', 'repo', 123)`。
14
+
15
+ RepositoryMembership(domain/config.ts)と同じ形の linkedRepositories も持つ。
16
+ */
17
+ export class GitHubClient extends PullsApi {
18
+ }
19
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,165 @@
1
+ import type { JsonObject } from '../../domain/json.js';
2
+ import type { BlockedByReferences, IssueBlockedByReferences, IssuePrerequisitesReadout, PrerequisiteFieldNames } from '../../domain/issue-readout.js';
3
+ import type { JsonValue } from '../../domain/python-format.js';
4
+ import { ProjectsApi } from './projects.js';
5
+ export interface IssueNodeIdAndTitle {
6
+ readonly id: string;
7
+ readonly title: string;
8
+ }
9
+ export interface SubIssueLink {
10
+ readonly parent_number: number;
11
+ readonly child_number: number;
12
+ }
13
+ /**
14
+ Issue 種別。issue_type は issueType フィールド非対応の GHES では null になりうる
15
+ */
16
+ export interface IssueKindResult {
17
+ readonly number: number;
18
+ readonly state: string;
19
+ readonly issue_type: string | null;
20
+ readonly sub_issues_total: number;
21
+ }
22
+ export interface IssueComment {
23
+ readonly author: string;
24
+ readonly created_at: string;
25
+ readonly body: string;
26
+ }
27
+ export interface IssueParent {
28
+ readonly number: number;
29
+ readonly title: string;
30
+ readonly state: string;
31
+ readonly owner: string | null;
32
+ readonly repo: string | null;
33
+ }
34
+ export interface IssueSubIssue {
35
+ readonly number: number;
36
+ readonly state: string;
37
+ readonly title: string;
38
+ }
39
+ export interface LinkedPullRequest {
40
+ readonly number: number;
41
+ readonly title: string;
42
+ readonly state: string;
43
+ }
44
+ /**
45
+ Issue の詳細(GraphQL で必要なフィールドだけ取ったもの)
46
+ */
47
+ export interface IssueSlim {
48
+ readonly number: number;
49
+ readonly state: string;
50
+ readonly title: string;
51
+ readonly body: string;
52
+ readonly comments: {
53
+ readonly total_count: number;
54
+ readonly nodes: readonly IssueComment[];
55
+ };
56
+ readonly parent: IssueParent | null;
57
+ readonly sub_issues: readonly IssueSubIssue[];
58
+ readonly linked_branches: readonly string[];
59
+ readonly linked_prs: readonly LinkedPullRequest[];
60
+ /**
61
+ 前提(blocked by)の件数(closed も数える)。Issue の依存関係に対応しない GHES では undefined
62
+ */
63
+ readonly blockedByCount: number | undefined;
64
+ }
65
+ /**
66
+ 前提を 1 回で読む件数の上限
67
+ */
68
+ export declare const MAX_BLOCKED_BY = 50;
69
+ export declare const DEPENDENCIES_UNSUPPORTED = "this GitHub Enterprise Server does not support issue dependencies (blockedBy); version 3.19 or later is required";
70
+ export declare class IssuesApi extends ProjectsApi {
71
+ private executeDependencyMutation;
72
+ private getIssueKindPhase1;
73
+ private fetchSlimIssue;
74
+ /**
75
+ Issue を作る。labels が空なら送らない
76
+ */
77
+ createIssue(owner: string, repository: string, title: string, body?: string, labels?: readonly string[]): Promise<JsonObject>;
78
+ /**
79
+ Issue のコメントを書き換える。見つからなければ GitHubNotFoundError
80
+ */
81
+ updateIssueComment(owner: string, repository: string, commentId: number, body: string): Promise<JsonObject>;
82
+ /**
83
+ Issue にコメントを足す
84
+ */
85
+ addIssueComment(owner: string, repository: string, number: number, body: string): Promise<JsonObject>;
86
+ /**
87
+ Issue 番号から GraphQL Node ID を取る。見つからなければ GitHubNotFoundError
88
+ */
89
+ getIssueNodeId(owner: string, repository: string, number: number): Promise<string>;
90
+ /**
91
+ Issue 番号から GraphQL Node ID とタイトルを、1 回のクエリで取る
92
+ */
93
+ getIssueNodeIdAndTitle(owner: string, repository: string, number: number): Promise<IssueNodeIdAndTitle>;
94
+ /**
95
+ サブ Issue を紐づける。紐づけ結果は親と子の Issue 番号
96
+ */
97
+ addSubIssue(parentIssueId: string, childIssueId: string): Promise<SubIssueLink>;
98
+ /**
99
+ 前提(blocked by)を付ける。issueId が待つ側、blockingIssueId が前提(どちらも node ID)。
100
+ GitHub の拒否(輪・件数の上限など)は HTTP 200 の VALIDATION で返り、GitHubAPIError になる。
101
+ Issue の依存関係に対応しない GHES(3.19 より前)も GitHubAPIError
102
+ */
103
+ addBlockedBy(issueId: string, blockingIssueId: string): Promise<void>;
104
+ /**
105
+ Issue の依存関係(blocked by)に対応するか。対応しない GHES(3.19 より前)は false
106
+ */
107
+ supportsBlockedBy(): Promise<boolean>;
108
+ /**
109
+ 前提(blocked by)を外す。addBlockedBy と同じ失敗をする
110
+ */
111
+ removeBlockedBy(issueId: string, blockingIssueId: string): Promise<void>;
112
+ /**
113
+ Issue と、その前提(blockedBy 先頭 blockedByFirst 件)を 1 回のクエリで読む。ボードの値は projectId のものだけ。
114
+ blockedBy の部分エラーと、件数の上限による取りこぼしは、例外にせず blockedBy の read-failed で返す(呼ぶ側は判定の入力にする)。
115
+ Issue の依存関係に対応しない GHES(3.19 より前)、blockedBy 以外の失敗は GitHubAPIError
116
+ */
117
+ getIssuePrerequisites(owner: string, repository: string, number: number, projectId: string, fieldNames: Readonly<PrerequisiteFieldNames>, blockedByFirst?: number): Promise<IssuePrerequisitesReadout>;
118
+ /**
119
+ Issue の node ID・本文・前提(先頭 blockedByFirst 件の参照と全体の件数)を、判定の読み取りより軽く読む。
120
+ blockedBy の部分エラーと null の node は、例外にせず read-failed で返す。
121
+ Issue の依存関係に対応しない GHES(3.19 より前)は DependenciesUnsupportedError
122
+ */
123
+ getIssueBlockedByReferences(owner: string, repository: string, number: number, blockedByFirst?: number): Promise<IssueBlockedByReferences>;
124
+ /**
125
+ その Issue を前提にしている Issue(blocking 先頭 blockingFirst 件)の参照と、全体の件数を読む。
126
+ total が issues の数より多ければ、読めなかった分がある。blocking の部分エラーと null の node は read-failed。
127
+ Issue の依存関係に対応しない GHES は DependenciesUnsupportedError
128
+ */
129
+ getIssueBlockingReferences(owner: string, repository: string, number: number, blockingFirst?: number): Promise<BlockedByReferences>;
130
+ /**
131
+ node ID の並びのそれぞれの前提を、まとめて読む(輪の探索の 1 段)。結果の鍵は node ID。
132
+ Issue でない・見つからない node と部分エラーは、その node だけ read-failed。
133
+ Issue の依存関係に対応しない GHES は DependenciesUnsupportedError
134
+ */
135
+ getBlockedByOfNodes(ids: readonly string[]): Promise<ReadonlyMap<string, BlockedByReferences>>;
136
+ /**
137
+ Issue 種別を軽く取る。issueType フィールドに対応しない GHES では、subIssues だけで判定する
138
+ */
139
+ getIssueKind(owner: string, repository: string, number: number): Promise<IssueKindResult>;
140
+ /**
141
+ 親のサブ Issue を全件読む。1 ページ目は getIssueSlim と同じクエリで読み、続きがあるときだけ GetSubIssuesPage を回す
142
+ */
143
+ getAllSubIssues(owner: string, repository: string, number: number): Promise<readonly IssueSubIssue[]>;
144
+ /**
145
+ Issue の詳細を取る(GraphQL)。親・サブ Issue・リンクブランチ・リンク PR を 1 回のクエリで取る
146
+ */
147
+ getIssueSlim(owner: string, repository: string, number: number, commentLimit?: number): Promise<IssueSlim>;
148
+ /**
149
+ Issue を閉じる。stateReason は completed か not_planned
150
+ */
151
+ closeIssue(owner: string, repository: string, number: number, stateReason?: string): Promise<JsonObject>;
152
+ /**
153
+ Issue を再オープンする
154
+ */
155
+ reopenIssue(owner: string, repository: string, number: number): Promise<JsonObject>;
156
+ /**
157
+ ラベルの付いた Issue を open・closed の両方で全件取る(REST)。Pull Request は除く
158
+ */
159
+ listIssuesByLabel(owner: string, repository: string, label: string): Promise<readonly JsonValue[]>;
160
+ /**
161
+ Issue の本文を丸ごと置き換える。本文が上限を超える 422 は GitHubAPIError
162
+ */
163
+ updateIssueBody(owner: string, repository: string, number: number, body: string): Promise<JsonObject>;
164
+ }
165
+ //# sourceMappingURL=issues.d.ts.map