@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,428 @@
1
+ // Issue 操作の API。cli/core/github/issues.py の移植。
2
+ // 返す値のキー名は、Python の辞書と同じ snake_case にする(CLI の JSON 出力がそのまま使う)。
3
+ import { isJsonObject, jsonField } from '../../domain/json.js';
4
+ import { JSON_NULL } from '../../domain/json-null.js';
5
+ import { DependenciesUnsupportedError, GitHubAPIError, GitHubNotFoundError, isSchemaError } from './errors.js';
6
+ import { asArray, asObject, isTruthy, numberOrNull, requireNumber, requireString, requireValue, stringOrNull, subIssuesTotal, truthyNodes } from './payload.js';
7
+ import { MUTATION_ADD_BLOCKED_BY, MUTATION_ADD_SUB_ISSUE, MUTATION_REMOVE_BLOCKED_BY, QUERY_GET_BLOCKED_BY_OF_NODES, QUERY_GET_ISSUE_BLOCKED_BY_REFERENCES, QUERY_GET_ISSUE_BLOCKING_REFERENCES, QUERY_GET_ISSUE_KIND, QUERY_HAS_ADD_BLOCKED_BY_INPUT, QUERY_GET_ISSUE_KIND_PHASE1, QUERY_GET_ISSUE_NODE_ID, QUERY_GET_ISSUE_PREREQUISITES, QUERY_GET_ISSUE_SLIM, QUERY_GET_ISSUE_SLIM_WITHOUT_BLOCKED_BY, QUERY_GET_SUB_ISSUES_PAGE, } from './queries.js';
8
+ import { readBlockedBy, readIssue, readIssueReference } from './readout.js';
9
+ import { ProjectsApi } from './projects.js';
10
+ import { repositoryPath } from './rest-path.js';
11
+ const ISSUES_PER_PAGE = 100;
12
+ const DEFAULT_COMMENT_LIMIT = 5;
13
+ /**
14
+ 前提を 1 回で読む件数の上限
15
+ */
16
+ export const MAX_BLOCKED_BY = 50;
17
+ // issueType フィールドに対応しない GHES が返すスキーマの失敗
18
+ function isIssueTypeSchemaError(error) {
19
+ return isSchemaError(error) && error.message.includes('issueType');
20
+ }
21
+ export const DEPENDENCIES_UNSUPPORTED = 'this GitHub Enterprise Server does not support issue dependencies (blockedBy); version 3.19 or later is required';
22
+ // 依存関係のフィールド(blockedBy・blocking・addBlockedBy・removeBlockedBy)と issueType に対応しない GHES(3.19 より前)。
23
+ // そのスキーマの失敗なら、分かる失敗に替える
24
+ function asDependenciesError(error) {
25
+ return isSchemaError(error) && /blockedBy|blocking|issueType/iu.test(error.message) ? new DependenciesUnsupportedError(DEPENDENCIES_UNSUPPORTED, { cause: error }) : error;
26
+ }
27
+ /**
28
+ nodes(ids:) の 1 回で渡せる node ID の上限
29
+ */
30
+ const MAX_NODES_PER_QUERY = 100;
31
+ // 部分エラーのうち、対象の Issue の blockedBy の下のもの
32
+ function isBlockedByPath(path) {
33
+ return path[0] === 'repository' && path[1] === 'issue' && path[2] === 'blockedBy';
34
+ }
35
+ // nodes(ids:) の部分エラーのうち、node の下のもの
36
+ function isNodesPath(path) {
37
+ return path[0] === 'nodes';
38
+ }
39
+ // 部分エラーのうち、対象の Issue の blocking の下のもの
40
+ function isBlockingPath(path) {
41
+ return path[0] === 'repository' && path[1] === 'issue' && path[2] === 'blocking';
42
+ }
43
+ // GitHub は無い Issue・リポを、data の null と、その道筋の NOT_FOUND の errors で返す。null を見て GitHubNotFoundError にする
44
+ function isIssueOrRepositoryPath(path) {
45
+ return path[0] === 'repository' && (path.length === 1 || (path[1] === 'issue' && path.length === 2));
46
+ }
47
+ // blockedBy(または blocking)の connection を参照にする。件数が足りないのは呼ぶ側が見るので、ここでは失敗にしない
48
+ function readBlockedByReferences(connection, field = 'blockedBy') {
49
+ if (!isTruthy(connection))
50
+ return { kind: 'read-failed', reason: `${field} is null` };
51
+ const nodes = asArray(jsonField(connection, 'nodes'));
52
+ if (nodes.some(node => !isTruthy(node)))
53
+ return { kind: 'read-failed', reason: `${field} has a null node` };
54
+ const issues = nodes.map(node => readIssueReference(node));
55
+ return { kind: 'ok', total: requireNumber(jsonField(connection, 'totalCount'), `${field}.totalCount`), issues };
56
+ }
57
+ // nodes(ids:) の 1 件を前提にする。message は、その node の部分エラー
58
+ function readNodeBlockedBy(node, id, message) {
59
+ if (message !== undefined)
60
+ return { kind: 'read-failed', reason: `blockedBy could not be read: ${message}` };
61
+ if (!isTruthy(node) || jsonField(node, 'id') !== id)
62
+ return { kind: 'read-failed', reason: 'the node is not an Issue or was not found' };
63
+ return readBlockedByReferences(jsonField(node, 'blockedBy'));
64
+ }
65
+ function numberOrUndefined(value) {
66
+ return typeof value === 'number' ? value : undefined;
67
+ }
68
+ function stringOrEmpty(value) {
69
+ return typeof value === 'string' ? value : '';
70
+ }
71
+ // 見つからないときは GitHubNotFoundError。repository と issue の 2 段で確かめる
72
+ function issueNode(result, owner, repository, number) {
73
+ const repositoryNode = jsonField(result, 'repository');
74
+ if (!isTruthy(repositoryNode))
75
+ throw new GitHubNotFoundError(`repository not found: ${owner}/${repository}`);
76
+ const issue = jsonField(repositoryNode, 'issue');
77
+ if (!isTruthy(issue))
78
+ throw new GitHubNotFoundError(`Issue not found: ${owner}/${repository}/${String(number)}`);
79
+ return requireValue(issue, 'issue');
80
+ }
81
+ // 対象の Issue の親の参照。親が無い、またはリポジトリが読めない応答なら null
82
+ function readParentReference(issue) {
83
+ const parent = jsonField(issue, 'parent');
84
+ if (!isTruthy(parent))
85
+ return JSON_NULL;
86
+ const repository = jsonField(parent, 'repository');
87
+ const owner = stringOrNull(jsonField(jsonField(repository, 'owner'), 'login'));
88
+ const name = stringOrNull(jsonField(repository, 'name'));
89
+ const number = jsonField(parent, 'number');
90
+ return owner === JSON_NULL || name === JSON_NULL || typeof number !== 'number' ? JSON_NULL : { repository: { owner, repository: name }, number };
91
+ }
92
+ function formatParent(parent) {
93
+ if (!isTruthy(parent))
94
+ return JSON_NULL;
95
+ const repository = asObject(jsonField(parent, 'repository'));
96
+ return {
97
+ number: requireNumber(jsonField(parent, 'number'), 'parent.number'),
98
+ title: requireString(jsonField(parent, 'title'), 'parent.title'),
99
+ state: requireString(jsonField(parent, 'state'), 'parent.state'),
100
+ owner: stringOrNull(jsonField(repository['owner'], 'login')),
101
+ repo: stringOrNull(repository['name']),
102
+ };
103
+ }
104
+ /**
105
+ timelineItems からリンクされた PR を取り出す。
106
+ ConnectedEvent は subject、CrossReferencedEvent は source に PR がある。PR 番号で重複を除く
107
+ */
108
+ function extractLinkedPullRequests(timelineItems) {
109
+ const seen = new Set();
110
+ const pullRequests = [];
111
+ for (const node of truthyNodes(timelineItems)) {
112
+ const subject = jsonField(node, 'subject');
113
+ const pullRequest = isTruthy(subject) ? subject : jsonField(node, 'source');
114
+ if (!isTruthy(pullRequest))
115
+ continue;
116
+ const number = numberOrNull(jsonField(pullRequest, 'number'));
117
+ if (number === null || number === 0 || seen.has(number))
118
+ continue;
119
+ seen.add(number);
120
+ pullRequests.push({
121
+ number,
122
+ title: stringOrEmpty(jsonField(pullRequest, 'title')),
123
+ state: stringOrEmpty(jsonField(pullRequest, 'state')),
124
+ });
125
+ }
126
+ return pullRequests;
127
+ }
128
+ function readSubIssueNodes(connection) {
129
+ return truthyNodes(connection).map(sub => ({
130
+ number: requireNumber(jsonField(sub, 'number'), 'subIssue.number'),
131
+ state: requireString(jsonField(sub, 'state'), 'subIssue.state'),
132
+ title: requireString(jsonField(sub, 'title'), 'subIssue.title'),
133
+ }));
134
+ }
135
+ export class IssuesApi extends ProjectsApi {
136
+ async executeDependencyMutation(mutation, variables) {
137
+ try {
138
+ await this.executeGraphql(mutation, variables);
139
+ }
140
+ catch (error) {
141
+ throw asDependenciesError(error);
142
+ }
143
+ }
144
+ // issueType フィールド非対応の GHES 用の判定
145
+ async getIssueKindPhase1(owner, repository, number) {
146
+ const result = await this.executeGraphql(QUERY_GET_ISSUE_KIND_PHASE1, { owner, repo: repository, number });
147
+ const issue = issueNode(result, owner, repository, number);
148
+ return {
149
+ number: requireNumber(jsonField(issue, 'number'), 'issue.number'),
150
+ state: requireString(jsonField(issue, 'state'), 'issue.state'),
151
+ issue_type: JSON_NULL,
152
+ sub_issues_total: subIssuesTotal(issue),
153
+ };
154
+ }
155
+ // GetIssueSlim の応答の issue。前提の件数に対応しない GHES は、件数なしのクエリで読み直す
156
+ async fetchSlimIssue(owner, repository, number, commentLimit) {
157
+ const variables = { owner, repo: repository, number, commentLimit };
158
+ let result;
159
+ try {
160
+ result = await this.queryIssue(QUERY_GET_ISSUE_SLIM, variables);
161
+ }
162
+ catch (error) {
163
+ if (!isSchemaError(error) || !/blockedBy/iu.test(error.message))
164
+ throw error;
165
+ result = await this.queryIssue(QUERY_GET_ISSUE_SLIM_WITHOUT_BLOCKED_BY, variables);
166
+ }
167
+ return issueNode(result, owner, repository, number);
168
+ }
169
+ /**
170
+ Issue を作る。labels が空なら送らない
171
+ */
172
+ async createIssue(owner, repository, title, body = '', labels) {
173
+ const data = {
174
+ title,
175
+ body,
176
+ ...(labels !== undefined && labels.length > 0 && { labels }),
177
+ };
178
+ return this.restObject('POST', `${repositoryPath(owner, repository)}/issues`, { json: data });
179
+ }
180
+ /**
181
+ Issue のコメントを書き換える。見つからなければ GitHubNotFoundError
182
+ */
183
+ async updateIssueComment(owner, repository, commentId, body) {
184
+ return this.restObject('PATCH', `${repositoryPath(owner, repository)}/issues/comments/${String(commentId)}`, { json: { body } });
185
+ }
186
+ /**
187
+ Issue にコメントを足す
188
+ */
189
+ async addIssueComment(owner, repository, number, body) {
190
+ return this.restObject('POST', `${repositoryPath(owner, repository)}/issues/${String(number)}/comments`, { json: { body } });
191
+ }
192
+ /**
193
+ Issue 番号から GraphQL Node ID を取る。見つからなければ GitHubNotFoundError
194
+ */
195
+ async getIssueNodeId(owner, repository, number) {
196
+ const issue = await this.getIssueNodeIdAndTitle(owner, repository, number);
197
+ return issue.id;
198
+ }
199
+ /**
200
+ Issue 番号から GraphQL Node ID とタイトルを、1 回のクエリで取る
201
+ */
202
+ async getIssueNodeIdAndTitle(owner, repository, number) {
203
+ const result = await this.queryIssue(QUERY_GET_ISSUE_NODE_ID, { owner, repo: repository, number });
204
+ const issue = issueNode(result, owner, repository, number);
205
+ return {
206
+ id: requireString(jsonField(issue, 'id'), 'issue.id'),
207
+ title: stringOrEmpty(jsonField(issue, 'title')),
208
+ };
209
+ }
210
+ /**
211
+ サブ Issue を紐づける。紐づけ結果は親と子の Issue 番号
212
+ */
213
+ async addSubIssue(parentIssueId, childIssueId) {
214
+ const result = await this.executeGraphql(MUTATION_ADD_SUB_ISSUE, { parentId: parentIssueId, childId: childIssueId });
215
+ const linkResult = jsonField(result, 'addSubIssue');
216
+ const parent = jsonField(linkResult, 'issue');
217
+ const child = jsonField(linkResult, 'subIssue');
218
+ if (!isTruthy(parent) || !isTruthy(child))
219
+ throw new GitHubAPIError('failed to link the sub-issue');
220
+ return {
221
+ parent_number: requireNumber(jsonField(parent, 'number'), 'issue.number'),
222
+ child_number: requireNumber(jsonField(child, 'number'), 'subIssue.number'),
223
+ };
224
+ }
225
+ /**
226
+ 前提(blocked by)を付ける。issueId が待つ側、blockingIssueId が前提(どちらも node ID)。
227
+ GitHub の拒否(輪・件数の上限など)は HTTP 200 の VALIDATION で返り、GitHubAPIError になる。
228
+ Issue の依存関係に対応しない GHES(3.19 より前)も GitHubAPIError
229
+ */
230
+ async addBlockedBy(issueId, blockingIssueId) {
231
+ await this.executeDependencyMutation(MUTATION_ADD_BLOCKED_BY, { issueId, blockingIssueId });
232
+ }
233
+ /**
234
+ Issue の依存関係(blocked by)に対応するか。対応しない GHES(3.19 より前)は false
235
+ */
236
+ async supportsBlockedBy() {
237
+ const result = await this.executeGraphql(QUERY_HAS_ADD_BLOCKED_BY_INPUT, {});
238
+ return jsonField(result, '__type') !== JSON_NULL;
239
+ }
240
+ /**
241
+ 前提(blocked by)を外す。addBlockedBy と同じ失敗をする
242
+ */
243
+ async removeBlockedBy(issueId, blockingIssueId) {
244
+ await this.executeDependencyMutation(MUTATION_REMOVE_BLOCKED_BY, { issueId, blockingIssueId });
245
+ }
246
+ /**
247
+ Issue と、その前提(blockedBy 先頭 blockedByFirst 件)を 1 回のクエリで読む。ボードの値は projectId のものだけ。
248
+ blockedBy の部分エラーと、件数の上限による取りこぼしは、例外にせず blockedBy の read-failed で返す(呼ぶ側は判定の入力にする)。
249
+ Issue の依存関係に対応しない GHES(3.19 より前)、blockedBy 以外の失敗は GitHubAPIError
250
+ */
251
+ async getIssuePrerequisites(owner, repository, number, projectId, fieldNames, blockedByFirst = MAX_BLOCKED_BY) {
252
+ const variables = { owner, repo: repository, number, columnFieldName: fieldNames.columnFieldName, labelFieldName: fieldNames.labelFieldName, blockedByFirst };
253
+ let outcome;
254
+ try {
255
+ outcome = await this.queryIssueTolerating(QUERY_GET_ISSUE_PREREQUISITES, variables, isBlockedByPath);
256
+ }
257
+ catch (error) {
258
+ throw asDependenciesError(error);
259
+ }
260
+ const { data, errors } = outcome;
261
+ const issue = issueNode(data, owner, repository, number);
262
+ const messages = errors.map(error => stringOrEmpty(jsonField(error, 'message')));
263
+ return {
264
+ issue: { ...readIssue(issue, projectId, fieldNames), body: requireString(jsonField(issue, 'body'), 'issue.body'), parent: readParentReference(issue) },
265
+ blockedBy: readBlockedBy(issue, projectId, fieldNames, messages),
266
+ };
267
+ }
268
+ /**
269
+ Issue の node ID・本文・前提(先頭 blockedByFirst 件の参照と全体の件数)を、判定の読み取りより軽く読む。
270
+ blockedBy の部分エラーと null の node は、例外にせず read-failed で返す。
271
+ Issue の依存関係に対応しない GHES(3.19 より前)は DependenciesUnsupportedError
272
+ */
273
+ async getIssueBlockedByReferences(owner, repository, number, blockedByFirst = MAX_BLOCKED_BY) {
274
+ let outcome;
275
+ try {
276
+ outcome = await this.queryIssueTolerating(QUERY_GET_ISSUE_BLOCKED_BY_REFERENCES, { owner, repo: repository, number, blockedByFirst }, isBlockedByPath);
277
+ }
278
+ catch (error) {
279
+ throw asDependenciesError(error);
280
+ }
281
+ const issue = issueNode(outcome.data, owner, repository, number);
282
+ const messages = outcome.errors.map(error => stringOrEmpty(jsonField(error, 'message')));
283
+ return {
284
+ id: requireString(jsonField(issue, 'id'), 'issue.id'),
285
+ body: requireString(jsonField(issue, 'body'), 'issue.body'),
286
+ blockedBy: messages.length > 0 ? { kind: 'read-failed', reason: `blockedBy could not be read: ${messages.join('; ')}` } : readBlockedByReferences(jsonField(issue, 'blockedBy')),
287
+ };
288
+ }
289
+ /**
290
+ その Issue を前提にしている Issue(blocking 先頭 blockingFirst 件)の参照と、全体の件数を読む。
291
+ total が issues の数より多ければ、読めなかった分がある。blocking の部分エラーと null の node は read-failed。
292
+ Issue の依存関係に対応しない GHES は DependenciesUnsupportedError
293
+ */
294
+ async getIssueBlockingReferences(owner, repository, number, blockingFirst = MAX_BLOCKED_BY) {
295
+ let outcome;
296
+ try {
297
+ const variables = { owner, repo: repository, number, blockingFirst };
298
+ outcome = await this.executeGraphqlTolerating(QUERY_GET_ISSUE_BLOCKING_REFERENCES, variables, path => isBlockingPath(path) || isIssueOrRepositoryPath(path));
299
+ }
300
+ catch (error) {
301
+ throw asDependenciesError(error);
302
+ }
303
+ const issue = issueNode(outcome.data, owner, repository, number);
304
+ const messages = outcome.errors.filter(error => isBlockingPath(asArray(error['path']))).map(error => stringOrEmpty(jsonField(error, 'message')));
305
+ return messages.length > 0 ? { kind: 'read-failed', reason: `blocking could not be read: ${messages.join('; ')}` } : readBlockedByReferences(jsonField(issue, 'blocking'), 'blocking');
306
+ }
307
+ /**
308
+ node ID の並びのそれぞれの前提を、まとめて読む(輪の探索の 1 段)。結果の鍵は node ID。
309
+ Issue でない・見つからない node と部分エラーは、その node だけ read-failed。
310
+ Issue の依存関係に対応しない GHES は DependenciesUnsupportedError
311
+ */
312
+ async getBlockedByOfNodes(ids) {
313
+ const result = new Map();
314
+ for (let start = 0; start < ids.length; start += MAX_NODES_PER_QUERY) {
315
+ const chunk = ids.slice(start, start + MAX_NODES_PER_QUERY);
316
+ let outcome;
317
+ try {
318
+ outcome = await this.executeGraphqlTolerating(QUERY_GET_BLOCKED_BY_OF_NODES, { ids: [...chunk], blockedByFirst: MAX_BLOCKED_BY }, isNodesPath);
319
+ }
320
+ catch (error) {
321
+ throw asDependenciesError(error);
322
+ }
323
+ const nodes = asArray(jsonField(outcome.data, 'nodes'));
324
+ const failed = new Map(outcome.errors.map(error => [asArray(error['path'])[1], stringOrEmpty(jsonField(error, 'message'))]));
325
+ for (const [index, id] of chunk.entries()) {
326
+ result.set(id, readNodeBlockedBy(nodes.at(index), id, failed.get(index)));
327
+ }
328
+ }
329
+ return result;
330
+ }
331
+ /**
332
+ Issue 種別を軽く取る。issueType フィールドに対応しない GHES では、subIssues だけで判定する
333
+ */
334
+ async getIssueKind(owner, repository, number) {
335
+ const variables = { owner, repo: repository, number };
336
+ let result;
337
+ try {
338
+ result = await this.executeGraphql(QUERY_GET_ISSUE_KIND, variables);
339
+ }
340
+ catch (error) {
341
+ if (isIssueTypeSchemaError(error)) {
342
+ return this.getIssueKindPhase1(owner, repository, number);
343
+ }
344
+ throw error;
345
+ }
346
+ const issue = issueNode(result, owner, repository, number);
347
+ return {
348
+ number: requireNumber(jsonField(issue, 'number'), 'issue.number'),
349
+ state: requireString(jsonField(issue, 'state'), 'issue.state'),
350
+ issue_type: stringOrNull(jsonField(jsonField(issue, 'issueType'), 'name')),
351
+ sub_issues_total: subIssuesTotal(issue),
352
+ };
353
+ }
354
+ /**
355
+ 親のサブ Issue を全件読む。1 ページ目は getIssueSlim と同じクエリで読み、続きがあるときだけ GetSubIssuesPage を回す
356
+ */
357
+ async getAllSubIssues(owner, repository, number) {
358
+ const issue = await this.fetchSlimIssue(owner, repository, number, 0);
359
+ const subIssues = [];
360
+ let connection = jsonField(issue, 'subIssues');
361
+ for (;;) {
362
+ subIssues.push(...readSubIssueNodes(connection));
363
+ const pageInfo = jsonField(connection, 'pageInfo');
364
+ const cursor = jsonField(pageInfo, 'endCursor');
365
+ if (typeof cursor !== 'string' || jsonField(pageInfo, 'hasNextPage') !== true)
366
+ return subIssues;
367
+ const result = await this.queryIssue(QUERY_GET_SUB_ISSUES_PAGE, { owner, repo: repository, number, after: cursor });
368
+ connection = jsonField(issueNode(result, owner, repository, number), 'subIssues');
369
+ }
370
+ }
371
+ /**
372
+ Issue の詳細を取る(GraphQL)。親・サブ Issue・リンクブランチ・リンク PR を 1 回のクエリで取る
373
+ */
374
+ async getIssueSlim(owner, repository, number, commentLimit = DEFAULT_COMMENT_LIMIT) {
375
+ const issue = await this.fetchSlimIssue(owner, repository, number, commentLimit);
376
+ return {
377
+ number: requireNumber(jsonField(issue, 'number'), 'issue.number'),
378
+ state: requireString(jsonField(issue, 'state'), 'issue.state'),
379
+ title: requireString(jsonField(issue, 'title'), 'issue.title'),
380
+ body: requireString(jsonField(issue, 'body'), 'issue.body'),
381
+ comments: {
382
+ total_count: requireNumber(jsonField(jsonField(issue, 'comments'), 'totalCount'), 'issue.comments.totalCount'),
383
+ nodes: truthyNodes(jsonField(issue, 'comments')).map(comment => ({
384
+ author: isTruthy(jsonField(comment, 'author')) ? requireString(jsonField(jsonField(comment, 'author'), 'login'), 'comment.author.login') : 'ghost',
385
+ created_at: requireString(jsonField(comment, 'createdAt'), 'comment.createdAt'),
386
+ body: requireString(jsonField(comment, 'body'), 'comment.body'),
387
+ })),
388
+ },
389
+ parent: formatParent(jsonField(issue, 'parent')),
390
+ sub_issues: readSubIssueNodes(jsonField(issue, 'subIssues')),
391
+ linked_branches: truthyNodes(jsonField(issue, 'linkedBranches'))
392
+ .filter(branch => isTruthy(jsonField(branch, 'ref')))
393
+ .map(branch => requireString(jsonField(jsonField(branch, 'ref'), 'name'), 'linkedBranch.ref.name')),
394
+ linked_prs: extractLinkedPullRequests(jsonField(issue, 'timelineItems')),
395
+ blockedByCount: numberOrUndefined(jsonField(jsonField(issue, 'blockedBy'), 'totalCount')),
396
+ };
397
+ }
398
+ /**
399
+ Issue を閉じる。stateReason は completed か not_planned
400
+ */
401
+ async closeIssue(owner, repository, number, stateReason = 'completed') {
402
+ return this.restObject('PATCH', `${repositoryPath(owner, repository)}/issues/${String(number)}`, {
403
+ json: { state: 'closed', state_reason: stateReason },
404
+ });
405
+ }
406
+ /**
407
+ Issue を再オープンする
408
+ */
409
+ async reopenIssue(owner, repository, number) {
410
+ return this.restObject('PATCH', `${repositoryPath(owner, repository)}/issues/${String(number)}`, {
411
+ json: { state: 'open', state_reason: 'reopened' },
412
+ });
413
+ }
414
+ /**
415
+ ラベルの付いた Issue を open・closed の両方で全件取る(REST)。Pull Request は除く
416
+ */
417
+ async listIssuesByLabel(owner, repository, label) {
418
+ const items = await this.listAll(`${repositoryPath(owner, repository)}/issues`, { state: 'all', labels: label, per_page: ISSUES_PER_PAGE });
419
+ return items.filter(item => !(isJsonObject(item) && 'pull_request' in item));
420
+ }
421
+ /**
422
+ Issue の本文を丸ごと置き換える。本文が上限を超える 422 は GitHubAPIError
423
+ */
424
+ async updateIssueBody(owner, repository, number, body) {
425
+ return this.restObject('PATCH', `${repositoryPath(owner, repository)}/issues/${String(number)}`, { json: { body } });
426
+ }
427
+ }
428
+ //# sourceMappingURL=issues.js.map
@@ -0,0 +1,44 @@
1
+ import type { JsonObject } from '../../domain/json.js';
2
+ import type { JsonValue } from '../../domain/python-format.js';
3
+ /**
4
+ as_dict と同じ。オブジェクトでなければ空のオブジェクト
5
+ */
6
+ export declare function asObject(value: JsonValue | undefined): JsonObject;
7
+ /**
8
+ 配列でなければ空の配列
9
+ */
10
+ export declare function asArray(value: JsonValue | undefined): readonly JsonValue[];
11
+ /**
12
+ Python の真偽値と同じ。None・False・0・空文字・空の配列・空の辞書は偽
13
+ */
14
+ export declare function isTruthy(value: JsonValue | undefined): boolean;
15
+ /**
16
+ `value.get(key, [])` の `nodes` の読み方。真偽値が偽の要素(None・空の辞書)を落とした配列
17
+ */
18
+ export declare function truthyNodes(value: JsonValue | undefined): readonly JsonValue[];
19
+ export declare function throwMalformed(path: string): never;
20
+ /**
21
+ 必須の文字列。無い、または文字列でなければ GitHubAPIError
22
+ */
23
+ export declare function requireString(value: JsonValue | undefined, path: string): string;
24
+ /**
25
+ 必須の数。無い、または数でなければ GitHubAPIError
26
+ */
27
+ export declare function requireNumber(value: JsonValue | undefined, path: string): number;
28
+ /**
29
+ 文字列か null。無いときと文字列以外は null
30
+ */
31
+ export declare function stringOrNull(value: JsonValue | undefined): string | null;
32
+ /**
33
+ 数か null。無いときと数以外は null
34
+ */
35
+ export declare function numberOrNull(value: JsonValue | undefined): number | null;
36
+ /**
37
+ 必須の値(null でもよい)。キーが無ければ GitHubAPIError
38
+ */
39
+ export declare function requireValue(value: JsonValue | undefined, path: string): JsonValue;
40
+ /**
41
+ Issue の subIssues.totalCount。無いときは 0
42
+ */
43
+ export declare function subIssuesTotal(issue: JsonValue): number;
44
+ //# sourceMappingURL=payload.d.ts.map
@@ -0,0 +1,80 @@
1
+ // GitHub の応答(REST の JSON と GraphQL の data)を読む補助。
2
+ // Python の dict.get と as_dict に当たる。形が合わないときは、辞書や配列を空として読む。
3
+ // 必須の値が無い、または型が違うときは GitHubAPIError にする(Python は KeyError で落ちる所)。
4
+ import { isJsonObject, jsonField } from '../../domain/json.js';
5
+ import { JSON_NULL } from '../../domain/json-null.js';
6
+ import { isJsonArray } from '../../domain/python-format.js';
7
+ import { GitHubAPIError } from './errors.js';
8
+ const EMPTY_OBJECT = {};
9
+ const EMPTY_ARRAY = [];
10
+ /**
11
+ as_dict と同じ。オブジェクトでなければ空のオブジェクト
12
+ */
13
+ export function asObject(value) {
14
+ return isJsonObject(value) ? value : EMPTY_OBJECT;
15
+ }
16
+ /**
17
+ 配列でなければ空の配列
18
+ */
19
+ export function asArray(value) {
20
+ return isJsonArray(value) ? value : EMPTY_ARRAY;
21
+ }
22
+ /**
23
+ Python の真偽値と同じ。None・False・0・空文字・空の配列・空の辞書は偽
24
+ */
25
+ export function isTruthy(value) {
26
+ if (value === undefined || value === null || value === false || value === 0 || value === '')
27
+ return false;
28
+ if (isJsonArray(value))
29
+ return value.length > 0;
30
+ if (typeof value === 'object')
31
+ return Object.keys(value).length > 0;
32
+ return true;
33
+ }
34
+ /**
35
+ `value.get(key, [])` の `nodes` の読み方。真偽値が偽の要素(None・空の辞書)を落とした配列
36
+ */
37
+ export function truthyNodes(value) {
38
+ return asArray(jsonField(value, 'nodes')).filter(node => isTruthy(node));
39
+ }
40
+ export function throwMalformed(path) {
41
+ throw new GitHubAPIError(`malformed GitHub response: ${path}`);
42
+ }
43
+ /**
44
+ 必須の文字列。無い、または文字列でなければ GitHubAPIError
45
+ */
46
+ export function requireString(value, path) {
47
+ return typeof value === 'string' ? value : throwMalformed(path);
48
+ }
49
+ /**
50
+ 必須の数。無い、または数でなければ GitHubAPIError
51
+ */
52
+ export function requireNumber(value, path) {
53
+ return typeof value === 'number' ? value : throwMalformed(path);
54
+ }
55
+ /**
56
+ 文字列か null。無いときと文字列以外は null
57
+ */
58
+ export function stringOrNull(value) {
59
+ return typeof value === 'string' ? value : JSON_NULL;
60
+ }
61
+ /**
62
+ 数か null。無いときと数以外は null
63
+ */
64
+ export function numberOrNull(value) {
65
+ return typeof value === 'number' ? value : JSON_NULL;
66
+ }
67
+ /**
68
+ 必須の値(null でもよい)。キーが無ければ GitHubAPIError
69
+ */
70
+ export function requireValue(value, path) {
71
+ return value === undefined ? throwMalformed(path) : value;
72
+ }
73
+ /**
74
+ Issue の subIssues.totalCount。無いときは 0
75
+ */
76
+ export function subIssuesTotal(issue) {
77
+ const total = jsonField(jsonField(issue, 'subIssues'), 'totalCount');
78
+ return typeof total === 'number' ? total : 0;
79
+ }
80
+ //# sourceMappingURL=payload.js.map