@pecot/workflow-mcp 0.0.0-stage → 5.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 (244) hide show
  1. package/.claude-plugin/plugin.json +8 -0
  2. package/LICENSE +21 -0
  3. package/README.md +126 -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 +222 -0
  7. package/cli/dist/commands/cell-table.d.ts +3 -0
  8. package/cli/dist/commands/cell-table.js +495 -0
  9. package/cli/dist/commands/command-binding.d.ts +26 -0
  10. package/cli/dist/commands/command-binding.js +266 -0
  11. package/cli/dist/commands/command-definition.d.ts +136 -0
  12. package/cli/dist/commands/command-definition.js +101 -0
  13. package/cli/dist/commands/command-help.d.ts +8 -0
  14. package/cli/dist/commands/command-help.js +173 -0
  15. package/cli/dist/commands/command-stop.d.ts +19 -0
  16. package/cli/dist/commands/command-stop.js +30 -0
  17. package/cli/dist/commands/dependabot.d.ts +3 -0
  18. package/cli/dist/commands/dependabot.js +165 -0
  19. package/cli/dist/commands/directory-option.d.ts +7 -0
  20. package/cli/dist/commands/directory-option.js +48 -0
  21. package/cli/dist/commands/failure.d.ts +13 -0
  22. package/cli/dist/commands/failure.js +33 -0
  23. package/cli/dist/commands/fuzzy.d.ts +7 -0
  24. package/cli/dist/commands/fuzzy.js +79 -0
  25. package/cli/dist/commands/github-client.d.ts +12 -0
  26. package/cli/dist/commands/github-client.js +23 -0
  27. package/cli/dist/commands/global-options.d.ts +25 -0
  28. package/cli/dist/commands/global-options.js +83 -0
  29. package/cli/dist/commands/help-layout.d.ts +40 -0
  30. package/cli/dist/commands/help-layout.js +117 -0
  31. package/cli/dist/commands/help.d.ts +8 -0
  32. package/cli/dist/commands/help.js +55 -0
  33. package/cli/dist/commands/input-schema.d.ts +14 -0
  34. package/cli/dist/commands/input-schema.js +56 -0
  35. package/cli/dist/commands/issue-board.d.ts +38 -0
  36. package/cli/dist/commands/issue-board.js +62 -0
  37. package/cli/dist/commands/issue-comment.d.ts +3 -0
  38. package/cli/dist/commands/issue-comment.js +196 -0
  39. package/cli/dist/commands/issue-create.d.ts +3 -0
  40. package/cli/dist/commands/issue-create.js +329 -0
  41. package/cli/dist/commands/issue-project.d.ts +3 -0
  42. package/cli/dist/commands/issue-project.js +176 -0
  43. package/cli/dist/commands/issue-quick.d.ts +3 -0
  44. package/cli/dist/commands/issue-quick.js +126 -0
  45. package/cli/dist/commands/issue-read.d.ts +3 -0
  46. package/cli/dist/commands/issue-read.js +80 -0
  47. package/cli/dist/commands/issue-shared.d.ts +159 -0
  48. package/cli/dist/commands/issue-shared.js +419 -0
  49. package/cli/dist/commands/issue.d.ts +4 -0
  50. package/cli/dist/commands/issue.js +15 -0
  51. package/cli/dist/commands/names.d.ts +9 -0
  52. package/cli/dist/commands/names.js +16 -0
  53. package/cli/dist/commands/output.d.ts +78 -0
  54. package/cli/dist/commands/output.js +187 -0
  55. package/cli/dist/commands/pr.d.ts +3 -0
  56. package/cli/dist/commands/pr.js +933 -0
  57. package/cli/dist/commands/project-info.d.ts +48 -0
  58. package/cli/dist/commands/project-info.js +181 -0
  59. package/cli/dist/commands/project-sync.d.ts +91 -0
  60. package/cli/dist/commands/project-sync.js +273 -0
  61. package/cli/dist/commands/project.d.ts +5 -0
  62. package/cli/dist/commands/project.js +677 -0
  63. package/cli/dist/commands/registry.d.ts +6 -0
  64. package/cli/dist/commands/registry.js +27 -0
  65. package/cli/dist/commands/release.d.ts +10 -0
  66. package/cli/dist/commands/release.js +414 -0
  67. package/cli/dist/commands/repository-display.d.ts +3 -0
  68. package/cli/dist/commands/repository-display.js +7 -0
  69. package/cli/dist/commands/repository-match.d.ts +14 -0
  70. package/cli/dist/commands/repository-match.js +33 -0
  71. package/cli/dist/commands/repository.d.ts +5 -0
  72. package/cli/dist/commands/repository.js +265 -0
  73. package/cli/dist/commands/rich-panel.d.ts +22 -0
  74. package/cli/dist/commands/rich-panel.js +295 -0
  75. package/cli/dist/commands/security.d.ts +3 -0
  76. package/cli/dist/commands/security.js +164 -0
  77. package/cli/dist/commands/session.d.ts +3 -0
  78. package/cli/dist/commands/session.js +161 -0
  79. package/cli/dist/commands/tracker-sync.d.ts +58 -0
  80. package/cli/dist/commands/tracker-sync.js +53 -0
  81. package/cli/dist/commands/usage-error.d.ts +47 -0
  82. package/cli/dist/commands/usage-error.js +72 -0
  83. package/cli/dist/commands/value-types.d.ts +46 -0
  84. package/cli/dist/commands/value-types.js +94 -0
  85. package/cli/dist/commands/work-target.d.ts +13 -0
  86. package/cli/dist/commands/work-target.js +41 -0
  87. package/cli/dist/commands/worktree.d.ts +3 -0
  88. package/cli/dist/commands/worktree.js +335 -0
  89. package/cli/dist/domain/api-error-detail.d.ts +10 -0
  90. package/cli/dist/domain/api-error-detail.js +25 -0
  91. package/cli/dist/domain/branch-name.d.ts +5 -0
  92. package/cli/dist/domain/branch-name.js +10 -0
  93. package/cli/dist/domain/changelog.d.ts +43 -0
  94. package/cli/dist/domain/changelog.js +107 -0
  95. package/cli/dist/domain/config.d.ts +215 -0
  96. package/cli/dist/domain/config.js +300 -0
  97. package/cli/dist/domain/dependabot-pull-requests.d.ts +82 -0
  98. package/cli/dist/domain/dependabot-pull-requests.js +338 -0
  99. package/cli/dist/domain/dependabot-source.d.ts +51 -0
  100. package/cli/dist/domain/dependabot-source.js +4 -0
  101. package/cli/dist/domain/dependabot.d.ts +47 -0
  102. package/cli/dist/domain/dependabot.js +88 -0
  103. package/cli/dist/domain/errors.d.ts +19 -0
  104. package/cli/dist/domain/errors.js +31 -0
  105. package/cli/dist/domain/field-options.d.ts +31 -0
  106. package/cli/dist/domain/field-options.js +44 -0
  107. package/cli/dist/domain/format.d.ts +47 -0
  108. package/cli/dist/domain/format.js +168 -0
  109. package/cli/dist/domain/frontmatter.d.ts +122 -0
  110. package/cli/dist/domain/frontmatter.js +264 -0
  111. package/cli/dist/domain/git-runner.d.ts +10 -0
  112. package/cli/dist/domain/git-runner.js +4 -0
  113. package/cli/dist/domain/git-url.d.ts +17 -0
  114. package/cli/dist/domain/git-url.js +30 -0
  115. package/cli/dist/domain/issue-kind.d.ts +16 -0
  116. package/cli/dist/domain/issue-kind.js +16 -0
  117. package/cli/dist/domain/issue-readout.d.ts +107 -0
  118. package/cli/dist/domain/issue-readout.js +4 -0
  119. package/cli/dist/domain/json-null.d.ts +2 -0
  120. package/cli/dist/domain/json-null.js +5 -0
  121. package/cli/dist/domain/json.d.ts +21 -0
  122. package/cli/dist/domain/json.js +47 -0
  123. package/cli/dist/domain/prerequisites.d.ts +32 -0
  124. package/cli/dist/domain/prerequisites.js +192 -0
  125. package/cli/dist/domain/pull-request.d.ts +134 -0
  126. package/cli/dist/domain/pull-request.js +232 -0
  127. package/cli/dist/domain/python-format.d.ts +105 -0
  128. package/cli/dist/domain/python-format.js +304 -0
  129. package/cli/dist/domain/readiness.d.ts +172 -0
  130. package/cli/dist/domain/readiness.js +280 -0
  131. package/cli/dist/domain/reference-parser.d.ts +49 -0
  132. package/cli/dist/domain/reference-parser.js +119 -0
  133. package/cli/dist/domain/release.d.ts +49 -0
  134. package/cli/dist/domain/release.js +72 -0
  135. package/cli/dist/domain/repository-policy.d.ts +32 -0
  136. package/cli/dist/domain/repository-policy.js +65 -0
  137. package/cli/dist/domain/repository-resolver.d.ts +57 -0
  138. package/cli/dist/domain/repository-resolver.js +119 -0
  139. package/cli/dist/domain/sections.d.ts +69 -0
  140. package/cli/dist/domain/sections.js +514 -0
  141. package/cli/dist/domain/security-alerts-source.d.ts +29 -0
  142. package/cli/dist/domain/security-alerts-source.js +4 -0
  143. package/cli/dist/domain/security-alerts.d.ts +52 -0
  144. package/cli/dist/domain/security-alerts.js +107 -0
  145. package/cli/dist/domain/security-tracker.d.ts +115 -0
  146. package/cli/dist/domain/security-tracker.js +353 -0
  147. package/cli/dist/domain/state.d.ts +29 -0
  148. package/cli/dist/domain/state.js +56 -0
  149. package/cli/dist/domain/tracker-body.d.ts +70 -0
  150. package/cli/dist/domain/tracker-body.js +65 -0
  151. package/cli/dist/domain/yaml-document.d.ts +5 -0
  152. package/cli/dist/domain/yaml-document.js +206 -0
  153. package/cli/dist/infra/authored-notes.d.ts +37 -0
  154. package/cli/dist/infra/authored-notes.js +66 -0
  155. package/cli/dist/infra/changelog-file.d.ts +19 -0
  156. package/cli/dist/infra/changelog-file.js +43 -0
  157. package/cli/dist/infra/child-stdin.d.ts +4 -0
  158. package/cli/dist/infra/child-stdin.js +8 -0
  159. package/cli/dist/infra/config-store.d.ts +49 -0
  160. package/cli/dist/infra/config-store.js +121 -0
  161. package/cli/dist/infra/diagnostics.d.ts +9 -0
  162. package/cli/dist/infra/diagnostics.js +2 -0
  163. package/cli/dist/infra/file-kind.d.ts +9 -0
  164. package/cli/dist/infra/file-kind.js +26 -0
  165. package/cli/dist/infra/frontmatter-file.d.ts +14 -0
  166. package/cli/dist/infra/frontmatter-file.js +30 -0
  167. package/cli/dist/infra/git.d.ts +74 -0
  168. package/cli/dist/infra/git.js +133 -0
  169. package/cli/dist/infra/github/auth.d.ts +60 -0
  170. package/cli/dist/infra/github/auth.js +158 -0
  171. package/cli/dist/infra/github/client.d.ts +173 -0
  172. package/cli/dist/infra/github/client.js +576 -0
  173. package/cli/dist/infra/github/dependabot-source.d.ts +13 -0
  174. package/cli/dist/infra/github/dependabot-source.js +33 -0
  175. package/cli/dist/infra/github/errors.d.ts +47 -0
  176. package/cli/dist/infra/github/errors.js +42 -0
  177. package/cli/dist/infra/github/index.d.ts +13 -0
  178. package/cli/dist/infra/github/index.js +19 -0
  179. package/cli/dist/infra/github/issues.d.ts +129 -0
  180. package/cli/dist/infra/github/issues.js +273 -0
  181. package/cli/dist/infra/github/payload.d.ts +44 -0
  182. package/cli/dist/infra/github/payload.js +80 -0
  183. package/cli/dist/infra/github/projects.d.ts +108 -0
  184. package/cli/dist/infra/github/projects.js +303 -0
  185. package/cli/dist/infra/github/pulls.d.ts +80 -0
  186. package/cli/dist/infra/github/pulls.js +161 -0
  187. package/cli/dist/infra/github/queries.d.ts +36 -0
  188. package/cli/dist/infra/github/queries.js +883 -0
  189. package/cli/dist/infra/github/readout.d.ts +18 -0
  190. package/cli/dist/infra/github/readout.js +156 -0
  191. package/cli/dist/infra/github/repos.d.ts +68 -0
  192. package/cli/dist/infra/github/repos.js +137 -0
  193. package/cli/dist/infra/github/rest-path.d.ts +14 -0
  194. package/cli/dist/infra/github/rest-path.js +31 -0
  195. package/cli/dist/infra/github/security-alerts-source.d.ts +15 -0
  196. package/cli/dist/infra/github/security-alerts-source.js +73 -0
  197. package/cli/dist/infra/gitignore-spec.d.ts +36 -0
  198. package/cli/dist/infra/gitignore-spec.js +235 -0
  199. package/cli/dist/infra/nx-scope.d.ts +51 -0
  200. package/cli/dist/infra/nx-scope.js +182 -0
  201. package/cli/dist/infra/os-error.d.ts +24 -0
  202. package/cli/dist/infra/os-error.js +38 -0
  203. package/cli/dist/infra/paths.d.ts +88 -0
  204. package/cli/dist/infra/paths.js +234 -0
  205. package/cli/dist/infra/state-store.d.ts +45 -0
  206. package/cli/dist/infra/state-store.js +118 -0
  207. package/cli/dist/infra/template-store.d.ts +15 -0
  208. package/cli/dist/infra/template-store.js +34 -0
  209. package/cli/dist/infra/text-file.d.ts +12 -0
  210. package/cli/dist/infra/text-file.js +33 -0
  211. package/cli/dist/infra/worktree-copy.d.ts +24 -0
  212. package/cli/dist/infra/worktree-copy.js +95 -0
  213. package/cli/dist/infra/worktree-links.d.ts +139 -0
  214. package/cli/dist/infra/worktree-links.js +433 -0
  215. package/cli/dist/infra/worktree-setup.d.ts +21 -0
  216. package/cli/dist/infra/worktree-setup.js +41 -0
  217. package/cli/dist/infra/worktree.d.ts +174 -0
  218. package/cli/dist/infra/worktree.js +567 -0
  219. package/cli/dist/mcp/result.d.ts +33 -0
  220. package/cli/dist/mcp/result.js +52 -0
  221. package/cli/dist/mcp/serve.d.ts +51 -0
  222. package/cli/dist/mcp/serve.js +183 -0
  223. package/cli/dist/mcp/server.d.ts +21 -0
  224. package/cli/dist/mcp/server.js +128 -0
  225. package/cli/dist/mcp/session-directory.d.ts +26 -0
  226. package/cli/dist/mcp/session-directory.js +84 -0
  227. package/cli/dist/package.json +1 -0
  228. package/cli/dist/version.d.ts +17 -0
  229. package/cli/dist/version.js +42 -0
  230. package/cli/templates/comment/merge-diff.md +34 -0
  231. package/cli/templates/comment/plan.md +181 -0
  232. package/cli/templates/comment/precede-notify.md +33 -0
  233. package/cli/templates/comment/review-findings.md +42 -0
  234. package/cli/templates/comment/review-resolution.md +48 -0
  235. package/cli/templates/issue/bug.md +63 -0
  236. package/cli/templates/issue/epic.md +54 -0
  237. package/cli/templates/issue/task-implement.md +67 -0
  238. package/cli/templates/issue/task.md +48 -0
  239. package/cli/templates/issue/tracker.md +48 -0
  240. package/cli/templates/pr/create.md +123 -0
  241. package/cli/templates/pr/release.md +56 -0
  242. package/hooks/lib/core/pecot-gitignore-ensure.sh +48 -0
  243. package/npm-shrinkwrap.json +83 -0
  244. package/package.json +22 -4
@@ -0,0 +1,173 @@
1
+ import type { JsonObject } from '../../domain/json.js';
2
+ import type { LinkedRepository } from '../../domain/config.js';
3
+ import { BaseError } from '../../domain/errors.js';
4
+ import type { JsonValue } from '../../domain/python-format.js';
5
+ import type { Diagnostics } from '../diagnostics.js';
6
+ /**
7
+ PECOT_GITHUB_API_URL を検証して返す。未設定・空文字なら undefined。
8
+ 前後比較のテストが GitHub の代わりに偽サーバへ向けるための差し替え口。
9
+ ループバックの http URL だけを受け付け、それ以外は InvalidValueError。末尾の `/` は落とす
10
+ */
11
+ export declare function resolveApiUrlOverride(): string | undefined;
12
+ export type HttpMethod = 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
13
+ /**
14
+ クエリの値。undefined は Python の None に当たり、`key=` と書く
15
+ */
16
+ export type QueryValue = boolean | number | string | undefined;
17
+ export interface RestRequestOptions {
18
+ readonly params?: Readonly<Record<string, QueryValue>> | undefined;
19
+ /**
20
+ JSON の本文
21
+ */
22
+ readonly json?: JsonValue | undefined;
23
+ }
24
+ /**
25
+ 送信の失敗(接続できない・時間切れ)。Python の httpx の例外に当たり、PecotError ではない
26
+ */
27
+ export declare class TransportFailure extends BaseError {
28
+ }
29
+ export interface HeaderLink {
30
+ readonly url: string;
31
+ readonly rel?: string | undefined;
32
+ }
33
+ /**
34
+ REST の応答。Python の httpx.Response のうち、呼び出し側が使う部分
35
+ */
36
+ export declare class RestResponse {
37
+ private readonly headers;
38
+ readonly statusCode: number;
39
+ readonly statusText: string;
40
+ readonly url: string;
41
+ readonly text: string;
42
+ constructor(init: Readonly<{
43
+ statusCode: number;
44
+ statusText: string;
45
+ url: string;
46
+ text: string;
47
+ headers: ReadonlyMap<string, string>;
48
+ }>);
49
+ /**
50
+ 状態コードが 2xx
51
+ */
52
+ get isSuccess(): boolean;
53
+ /**
54
+ ヘッダの値。名前は大文字小文字を区別しない
55
+ */
56
+ header(name: string): string | undefined;
57
+ /**
58
+ Link ヘッダ。キーは rel(無ければ url)
59
+ */
60
+ get links(): ReadonlyMap<string, HeaderLink>;
61
+ /**
62
+ 本文を JSON として読む。不正なら InvalidValueError
63
+ */
64
+ json(): JsonValue;
65
+ }
66
+ /**
67
+ errors[].path(フィールドの道筋)を受けて、許す errors かを答える
68
+ */
69
+ export type PathPredicate = (path: readonly JsonValue[]) => boolean;
70
+ /**
71
+ executeGraphqlTolerating の結果。data と、許した errors
72
+ */
73
+ export interface GraphqlOutcome {
74
+ readonly data: JsonObject;
75
+ readonly errors: readonly JsonObject[];
76
+ }
77
+ export interface GitHubClientOptions {
78
+ /**
79
+ GitHub のホスト。既定は github.com
80
+ */
81
+ readonly host?: string | undefined;
82
+ /**
83
+ 認証トークン。省略または空なら、config/.env・ルート .env・gh auth token の順で取る
84
+ */
85
+ readonly token?: string | undefined;
86
+ /**
87
+ 1 回の要求の時間切れ(ミリ秒)。既定は 30000
88
+ */
89
+ readonly timeoutMilliseconds?: number | undefined;
90
+ /**
91
+ gh auth token の時間切れ(ミリ秒)。既定は 10000
92
+ */
93
+ readonly ghTimeoutMilliseconds?: number | undefined;
94
+ /**
95
+ 警告の受け口。トークンを切り替えたときの案内を渡す。省略できない(省くと警告が出ない)
96
+ */
97
+ readonly diagnostics: Diagnostics;
98
+ }
99
+ /**
100
+ GitHub API クライアント(REST と GraphQL)。github.com と GHES に対応する。
101
+
102
+ トークンの優先順位は、token の指定、config/.env、ルート .env、gh auth token の順。
103
+ issues・pulls・projects・repos の操作は、次のメソッドを使って作る。
104
+ restJson・restObject・restRequest・handleHttpError・executeGraphql。
105
+ */
106
+ export declare class GitHubClientBase {
107
+ private readonly diagnostics;
108
+ private usedFallback;
109
+ readonly host: string;
110
+ token: string;
111
+ readonly timeoutMilliseconds: number;
112
+ readonly ghTimeoutMilliseconds: number;
113
+ readonly apiUrl: string;
114
+ readonly graphqlUrl: string;
115
+ /**
116
+ プロジェクトにリンクされたリポジトリの一覧のキャッシュ(`owner/projectNumber` がキー)
117
+ */
118
+ readonly linkedRepositoriesCache: Map<string, readonly LinkedRepository[]>;
119
+ constructor(options: Readonly<GitHubClientOptions>);
120
+ private resolveToken;
121
+ private tokenFromEnvironment;
122
+ private tokenFromGh;
123
+ /**
124
+ 認証エラーの文を作る。.env が無ければ生成し、あるときはホストの変数が無ければ追記する
125
+ */
126
+ private authErrorMessage;
127
+ private requestHeaders;
128
+ /**
129
+ env のトークンが失効したとき、gh auth token に 1 回だけ切り替える。切り替えたら true
130
+ */
131
+ private retryWithFallbackToken;
132
+ private send;
133
+ private sendRest;
134
+ private sendGraphql;
135
+ private classifyGraphqlFailure;
136
+ private runGraphql;
137
+ private assertSameOrigin;
138
+ /**
139
+ REST の要求(401 のときは gh auth token に切り替えて 1 回だけ再試行する)。
140
+ target は `/user` のようなパス(base の後ろにつなぐ)か、`https://` で始まる絶対 URL(Link ヘッダの next など)。
141
+ 失敗の状態コードは例外にせず、そのまま返す。呼び出し側が isSuccess を見て handleHttpError に渡す
142
+ */
143
+ restRequest(method: HttpMethod, target: string, options?: Readonly<RestRequestOptions>): Promise<RestResponse>;
144
+ /**
145
+ REST の要求を送り、成功した応答の JSON を返す。失敗の応答は handleHttpError の例外にする。
146
+ 本文が無い応答(204 など)には使わない
147
+ */
148
+ restJson(method: HttpMethod, target: string, options?: Readonly<RestRequestOptions>): Promise<JsonValue>;
149
+ /**
150
+ restJson の結果をオブジェクトとして返す(オブジェクトでなければ空のオブジェクト。Python の as_dict と同じ)
151
+ */
152
+ restObject(method: HttpMethod, target: string, options?: Readonly<RestRequestOptions>): Promise<JsonObject>;
153
+ /**
154
+ HTTP エラーの応答を、状態コード別の例外にして投げる
155
+ */
156
+ handleHttpError(response: RestResponse): never;
157
+ /**
158
+ GraphQL を実行する。失敗は応答の状態コードと errors の type で分類する。
159
+ 状態が 401(または type が UNAUTHORIZED)は GitHubAuthError。gh auth token に 1 回切り替えて再試行する。
160
+ レート制限は GitHubRateLimitError、それ以外は GitHubAPIError
161
+ */
162
+ executeGraphql(query: string, variables?: Readonly<Record<string, JsonValue>>): Promise<JsonObject>;
163
+ /**
164
+ executeGraphql の、部分エラーを許す版。data があり、errors のすべてが isTolerated を満たすとき、例外にせず data と errors を返す。
165
+ それ以外の errors は executeGraphql と同じ例外になる
166
+ */
167
+ executeGraphqlTolerating(query: string, variables: Readonly<Record<string, JsonValue>>, isTolerated: PathPredicate): Promise<GraphqlOutcome>;
168
+ /**
169
+ 認証ユーザーの情報(login・id・name・email など)
170
+ */
171
+ getAuthenticatedUser(): Promise<JsonValue>;
172
+ }
173
+ //# sourceMappingURL=client.d.ts.map