@pecot/workflow-mcp 5.0.0 → 7.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 (188) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.md +27 -22
  3. package/cli/dist/cli.js +6 -1
  4. package/cli/dist/commands/board-add.d.ts +3 -0
  5. package/cli/dist/commands/board-add.js +69 -0
  6. package/cli/dist/commands/board-judgment.d.ts +69 -0
  7. package/cli/dist/commands/board-judgment.js +150 -0
  8. package/cli/dist/commands/board-move.d.ts +3 -0
  9. package/cli/dist/commands/board-move.js +65 -0
  10. package/cli/dist/commands/board-readiness.d.ts +34 -0
  11. package/cli/dist/commands/board-readiness.js +108 -0
  12. package/cli/dist/commands/board-show.d.ts +3 -0
  13. package/cli/dist/commands/board-show.js +75 -0
  14. package/cli/dist/commands/board-sync.d.ts +3 -0
  15. package/cli/dist/commands/board-sync.js +120 -0
  16. package/cli/dist/commands/board-view.d.ts +151 -0
  17. package/cli/dist/commands/board-view.js +293 -0
  18. package/cli/dist/commands/board.d.ts +3 -0
  19. package/cli/dist/commands/board.js +12 -0
  20. package/cli/dist/commands/branch.d.ts +3 -0
  21. package/cli/dist/commands/branch.js +111 -0
  22. package/cli/dist/commands/command-binding.js +4 -0
  23. package/cli/dist/commands/command-definition.d.ts +39 -8
  24. package/cli/dist/commands/command-definition.js +20 -7
  25. package/cli/dist/commands/command-help.js +2 -2
  26. package/cli/dist/commands/command-hint.d.ts +5 -0
  27. package/cli/dist/commands/command-hint.js +13 -0
  28. package/cli/dist/commands/command-stop.d.ts +5 -3
  29. package/cli/dist/commands/command-stop.js +7 -6
  30. package/cli/dist/commands/failure-kind.d.ts +3 -0
  31. package/cli/dist/commands/failure-kind.js +35 -0
  32. package/cli/dist/commands/failure.d.ts +6 -0
  33. package/cli/dist/commands/failure.js +29 -3
  34. package/cli/dist/commands/github-client.d.ts +6 -2
  35. package/cli/dist/commands/github-client.js +13 -3
  36. package/cli/dist/commands/help.js +8 -13
  37. package/cli/dist/commands/issue-board.d.ts +61 -0
  38. package/cli/dist/commands/issue-board.js +85 -1
  39. package/cli/dist/commands/issue-comment.js +66 -30
  40. package/cli/dist/commands/issue-create.js +632 -92
  41. package/cli/dist/commands/issue-dependency.d.ts +3 -0
  42. package/cli/dist/commands/issue-dependency.js +310 -0
  43. package/cli/dist/commands/issue-readiness.d.ts +122 -0
  44. package/cli/dist/commands/issue-readiness.js +253 -0
  45. package/cli/dist/commands/issue-reopen.d.ts +3 -0
  46. package/cli/dist/commands/issue-reopen.js +130 -0
  47. package/cli/dist/commands/issue-shared.d.ts +33 -20
  48. package/cli/dist/commands/issue-shared.js +84 -76
  49. package/cli/dist/commands/issue-show.d.ts +3 -0
  50. package/cli/dist/commands/issue-show.js +239 -0
  51. package/cli/dist/commands/issue.d.ts +0 -1
  52. package/cli/dist/commands/issue.js +6 -8
  53. package/cli/dist/commands/names.d.ts +33 -0
  54. package/cli/dist/commands/names.js +63 -0
  55. package/cli/dist/commands/output.d.ts +32 -4
  56. package/cli/dist/commands/output.js +28 -8
  57. package/cli/dist/commands/pr-merge.d.ts +3 -0
  58. package/cli/dist/commands/pr-merge.js +230 -0
  59. package/cli/dist/commands/pr-reference.d.ts +8 -0
  60. package/cli/dist/commands/pr-reference.js +30 -0
  61. package/cli/dist/commands/pr-restack.d.ts +6 -0
  62. package/cli/dist/commands/pr-restack.js +233 -0
  63. package/cli/dist/commands/pr-waiting.d.ts +59 -0
  64. package/cli/dist/commands/pr-waiting.js +143 -0
  65. package/cli/dist/commands/pr.d.ts +23 -0
  66. package/cli/dist/commands/pr.js +378 -366
  67. package/cli/dist/commands/project-sync.d.ts +12 -3
  68. package/cli/dist/commands/project-sync.js +23 -13
  69. package/cli/dist/commands/project.d.ts +3 -2
  70. package/cli/dist/commands/project.js +371 -177
  71. package/cli/dist/commands/registry.js +15 -10
  72. package/cli/dist/commands/release.d.ts +2 -2
  73. package/cli/dist/commands/release.js +118 -130
  74. package/cli/dist/commands/renamed-commands.d.ts +26 -0
  75. package/cli/dist/commands/renamed-commands.js +53 -0
  76. package/cli/dist/commands/repository-match.js +9 -3
  77. package/cli/dist/commands/session-finish.d.ts +3 -0
  78. package/cli/dist/commands/session-finish.js +383 -0
  79. package/cli/dist/commands/session-start.d.ts +3 -0
  80. package/cli/dist/commands/session-start.js +252 -0
  81. package/cli/dist/commands/session.d.ts +3 -0
  82. package/cli/dist/commands/session.js +186 -32
  83. package/cli/dist/commands/tracker-sync-dependabot.d.ts +7 -0
  84. package/cli/dist/commands/{dependabot.js → tracker-sync-dependabot.js} +76 -68
  85. package/cli/dist/commands/tracker-sync-security.d.ts +7 -0
  86. package/cli/dist/commands/{security.js → tracker-sync-security.js} +71 -64
  87. package/cli/dist/commands/tracker-sync.d.ts +37 -0
  88. package/cli/dist/commands/tracker-sync.js +18 -6
  89. package/cli/dist/commands/tracker.d.ts +3 -0
  90. package/cli/dist/commands/tracker.js +20 -0
  91. package/cli/dist/commands/usage-error.d.ts +4 -0
  92. package/cli/dist/commands/usage-error.js +6 -0
  93. package/cli/dist/commands/work-target.d.ts +20 -3
  94. package/cli/dist/commands/work-target.js +49 -6
  95. package/cli/dist/commands/worktree.js +103 -33
  96. package/cli/dist/domain/batch-plan.d.ts +73 -0
  97. package/cli/dist/domain/batch-plan.js +114 -0
  98. package/cli/dist/domain/blocked-by-change.d.ts +99 -0
  99. package/cli/dist/domain/blocked-by-change.js +101 -0
  100. package/cli/dist/domain/board-move.d.ts +90 -0
  101. package/cli/dist/domain/board-move.js +92 -0
  102. package/cli/dist/domain/branch-name.js +1 -1
  103. package/cli/dist/domain/command-hint.d.ts +85 -0
  104. package/cli/dist/domain/command-hint.js +148 -0
  105. package/cli/dist/domain/config.d.ts +4 -0
  106. package/cli/dist/domain/config.js +11 -1
  107. package/cli/dist/domain/dependabot.js +1 -1
  108. package/cli/dist/domain/errors.d.ts +5 -0
  109. package/cli/dist/domain/errors.js +5 -0
  110. package/cli/dist/domain/format.d.ts +51 -4
  111. package/cli/dist/domain/format.js +72 -6
  112. package/cli/dist/domain/frontmatter.d.ts +18 -3
  113. package/cli/dist/domain/frontmatter.js +38 -12
  114. package/cli/dist/domain/issue-order.d.ts +55 -0
  115. package/cli/dist/domain/issue-order.js +65 -0
  116. package/cli/dist/domain/issue-readout.d.ts +36 -4
  117. package/cli/dist/domain/pull-request.d.ts +71 -4
  118. package/cli/dist/domain/pull-request.js +59 -10
  119. package/cli/dist/domain/readiness.d.ts +44 -0
  120. package/cli/dist/domain/readiness.js +153 -5
  121. package/cli/dist/domain/reference-parser.d.ts +3 -1
  122. package/cli/dist/domain/reference-parser.js +6 -2
  123. package/cli/dist/domain/release.d.ts +7 -3
  124. package/cli/dist/domain/release.js +5 -12
  125. package/cli/dist/domain/repository-policy.d.ts +9 -3
  126. package/cli/dist/domain/repository-policy.js +8 -7
  127. package/cli/dist/domain/repository-resolver.js +4 -1
  128. package/cli/dist/domain/restack.d.ts +62 -0
  129. package/cli/dist/domain/restack.js +53 -0
  130. package/cli/dist/domain/security-alerts.js +1 -1
  131. package/cli/dist/domain/state.d.ts +69 -0
  132. package/cli/dist/domain/state.js +67 -1
  133. package/cli/dist/domain/work-start.d.ts +30 -0
  134. package/cli/dist/domain/work-start.js +42 -0
  135. package/cli/dist/infra/authored-notes.d.ts +1 -1
  136. package/cli/dist/infra/authored-notes.js +10 -4
  137. package/cli/dist/infra/config-store.d.ts +4 -0
  138. package/cli/dist/infra/config-store.js +13 -0
  139. package/cli/dist/infra/git.d.ts +76 -0
  140. package/cli/dist/infra/git.js +123 -1
  141. package/cli/dist/infra/github/client.d.ts +5 -0
  142. package/cli/dist/infra/github/client.js +10 -7
  143. package/cli/dist/infra/github/errors.d.ts +18 -0
  144. package/cli/dist/infra/github/errors.js +22 -0
  145. package/cli/dist/infra/github/issues.d.ts +39 -3
  146. package/cli/dist/infra/github/issues.js +178 -23
  147. package/cli/dist/infra/github/projects.d.ts +35 -0
  148. package/cli/dist/infra/github/projects.js +89 -8
  149. package/cli/dist/infra/github/pulls.d.ts +105 -2
  150. package/cli/dist/infra/github/pulls.js +172 -5
  151. package/cli/dist/infra/github/queries.d.ts +15 -4
  152. package/cli/dist/infra/github/queries.js +203 -40
  153. package/cli/dist/infra/github/readout.d.ts +5 -1
  154. package/cli/dist/infra/github/readout.js +11 -33
  155. package/cli/dist/infra/github/repos.d.ts +18 -0
  156. package/cli/dist/infra/github/repos.js +31 -0
  157. package/cli/dist/infra/nx-scope.d.ts +1 -1
  158. package/cli/dist/infra/nx-scope.js +1 -1
  159. package/cli/dist/infra/state-store.d.ts +10 -1
  160. package/cli/dist/infra/state-store.js +14 -2
  161. package/cli/dist/infra/worktree-links.d.ts +3 -0
  162. package/cli/dist/infra/worktree-links.js +8 -1
  163. package/cli/dist/infra/worktree.d.ts +12 -1
  164. package/cli/dist/infra/worktree.js +40 -23
  165. package/cli/dist/mcp/result.d.ts +82 -7
  166. package/cli/dist/mcp/result.js +139 -19
  167. package/cli/dist/mcp/server.d.ts +2 -2
  168. package/cli/dist/mcp/server.js +57 -10
  169. package/cli/templates/comment/plan.md +14 -0
  170. package/cli/templates/comment/review-findings.md +3 -2
  171. package/cli/templates/issue/bug.md +13 -4
  172. package/cli/templates/issue/task-implement.md +13 -6
  173. package/cli/templates/issue/task.md +13 -4
  174. package/cli/templates/workflow/pecot-board-sync.yml +84 -0
  175. package/npm-shrinkwrap.json +2 -2
  176. package/package.json +1 -1
  177. package/cli/dist/commands/dependabot.d.ts +0 -3
  178. package/cli/dist/commands/issue-project.d.ts +0 -3
  179. package/cli/dist/commands/issue-project.js +0 -176
  180. package/cli/dist/commands/issue-quick.d.ts +0 -3
  181. package/cli/dist/commands/issue-quick.js +0 -126
  182. package/cli/dist/commands/issue-read.d.ts +0 -3
  183. package/cli/dist/commands/issue-read.js +0 -80
  184. package/cli/dist/commands/project-info.d.ts +0 -48
  185. package/cli/dist/commands/project-info.js +0 -181
  186. package/cli/dist/commands/repository.d.ts +0 -5
  187. package/cli/dist/commands/repository.js +0 -265
  188. package/cli/dist/commands/security.d.ts +0 -3
@@ -77,9 +77,17 @@ export interface RepositoryParts {
77
77
  */
78
78
  export declare function buildRepository(parts: Readonly<RepositoryParts>): Repository;
79
79
  /**
80
- GitHub Projects V2 の情報から設定ファイルを作るか更新し、アクティブにする。作った設定ファイルのパスを返す。
80
+ syncProjectConfig の結果。行に出した値と同じ。change は設定ファイルの扱い、activeProject はアクティブにした(dry-run では、する)設定の名前で、unchanged なら undefined
81
+ */
82
+ export interface SyncedProjectConfig {
83
+ readonly configPath: string;
84
+ readonly change: 'create' | 'update' | 'unchanged';
85
+ readonly activeProject: string | undefined;
86
+ }
87
+ /**
88
+ GitHub Projects V2 の情報から設定ファイルを作るか更新し、アクティブにする。設定ファイルのパスと、行に出した扱いを返す。
81
89
  pecot-workflow に合うプロジェクトだけを扱う。suffix はその名前の workflow フィールドを使う。
82
- skipIfUnchanged は、設定ファイルの内容が同じなら何も書かない
90
+ skipIfUnchanged は、設定ファイルの内容が同じなら何も書かない。isDryRun は読むだけで、書く操作を planned で出す
83
91
  */
84
92
  export declare function syncProjectConfig(out: Readonly<Output>, client: Readonly<GitHubClient>, target: Readonly<{
85
93
  owner: string;
@@ -87,5 +95,6 @@ export declare function syncProjectConfig(out: Readonly<Output>, client: Readonl
87
95
  host: string;
88
96
  suffix?: string | undefined;
89
97
  skipIfUnchanged?: boolean | undefined;
90
- }>): Promise<string>;
98
+ isDryRun?: boolean | undefined;
99
+ }>): Promise<SyncedProjectConfig>;
91
100
  //# sourceMappingURL=project-sync.d.ts.map
@@ -6,7 +6,9 @@ import { isJsonObject, jsonField, parseJsonText } from '../domain/json.js';
6
6
  import { pythonRepr } from '../domain/python-format.js';
7
7
  import { loadConfig, projectsDirectory, saveConfig, setActiveConfig } from '../infra/config-store.js';
8
8
  import { asArray, isTruthy, requireNumber, requireString } from '../infra/github/payload.js';
9
+ import { commandHint, hinted, placeholder } from './command-hint.js';
9
10
  import { stopWith } from './command-stop.js';
11
+ import { kindOfFailure } from './failure.js';
10
12
  const WORKFLOW_FIELD_PREFIX = 'pecot-workflow-';
11
13
  /**
12
14
  前提を待つ Issue を pecot が置く列
@@ -60,7 +62,7 @@ export const SIZE_FIELD_OPTIONS = [
60
62
  export function failApi(out, action, error) {
61
63
  const detail = error.message;
62
64
  const status = error.statusCode ?? 0;
63
- return stopWith(out, status === 0 ? `could not ${action}: ${detail}` : `could not ${action} (status ${String(status)}): ${detail}`);
65
+ return stopWith(out, status === 0 ? `could not ${action}: ${detail}` : `could not ${action} (status ${String(status)}): ${detail}`, kindOfFailure(error));
64
66
  }
65
67
  /**
66
68
  Python の str() に当たる文字列。値が無いときは None
@@ -91,7 +93,7 @@ export async function findProjectByTitle(out, client, owner, name) {
91
93
  if (found !== undefined)
92
94
  return found;
93
95
  const titles = projects.map(project => `- ${textOf(jsonField(project, 'title'))}`).join('\n');
94
- return stopWith(out, `project not found: ${name}\navailable projects:\n${titles}`);
96
+ return stopWith(out, `project not found: ${name}\navailable projects:\n${titles}`, 'project-not-found');
95
97
  }
96
98
  /**
97
99
  workflow フィールドに足りない必須の選択肢(要る順。optional は数えない。名前は大文字と小文字を区別しない)
@@ -104,7 +106,7 @@ export function missingRequiredOptions(field) {
104
106
  必須の選択肢が欠けたときの、終了コード 1 の止め方
105
107
  */
106
108
  export function stopMissingOptions(out, missing) {
107
- return stopWith(out, `pecot-workflow field is missing options: ${missing.join(', ')}\nrequired options: Backlog / Pending / Ready / Active / In Review / Archived`);
109
+ return stopWith(out, `pecot-workflow field is missing options: ${missing.join(', ')}\nrequired options: Backlog / Pending / Ready / Active / In Review / Archived`, 'not-initialized');
108
110
  }
109
111
  function lowerName(option) {
110
112
  const name = jsonField(option, 'name');
@@ -118,13 +120,13 @@ async function fetchValidatedFields(out, client, target) {
118
120
  const { owner, name, host, number, suffix } = target;
119
121
  const projectInfo = await client.getProjectFields(owner, number);
120
122
  if (projectInfo === undefined || !isTruthy(projectInfo))
121
- return stopWith(out, `could not read project fields: ${name}`);
123
+ return stopWith(out, `could not read project fields: ${name}`, 'not-initialized');
122
124
  const fields = fieldNodesOf(projectInfo);
123
125
  const workflowField = findWorkflowField(fields, suffix);
124
126
  if (workflowField === undefined) {
125
- return stopWith(out, `project "${name}" has no pecot-workflow-* field\n`
126
- + 'required field: pecot-workflow-<suffix> (Backlog/Pending/Ready/Active/In Review/Archived)\n'
127
- + `run: pecot project init --host ${host} --suffix <suffix> ${owner} "${name}"`);
127
+ return stopWith(out, hinted `project "${name}" has no pecot-workflow-* field
128
+ required field: pecot-workflow-<suffix> (Backlog/Pending/Ready/Active/In Review/Archived)
129
+ run: ${commandHint(['project', 'init'], { owner, name, host, suffix: placeholder('suffix') })}`, 'not-initialized');
128
130
  }
129
131
  const missing = missingRequiredOptions(workflowField);
130
132
  if (missing.length > 0)
@@ -225,9 +227,9 @@ function loadExistingConfig(configPath) {
225
227
  return existsSync(configPath) ? loadConfig(configPath) : undefined;
226
228
  }
227
229
  /**
228
- GitHub Projects V2 の情報から設定ファイルを作るか更新し、アクティブにする。作った設定ファイルのパスを返す。
230
+ GitHub Projects V2 の情報から設定ファイルを作るか更新し、アクティブにする。設定ファイルのパスと、行に出した扱いを返す。
229
231
  pecot-workflow に合うプロジェクトだけを扱う。suffix はその名前の workflow フィールドを使う。
230
- skipIfUnchanged は、設定ファイルの内容が同じなら何も書かない
232
+ skipIfUnchanged は、設定ファイルの内容が同じなら何も書かない。isDryRun は読むだけで、書く操作を planned で出す
231
233
  */
232
234
  export async function syncProjectConfig(out, client, target) {
233
235
  const { owner, name, host, skipIfUnchanged = false } = target;
@@ -261,13 +263,21 @@ export async function syncProjectConfig(out, client, target) {
261
263
  };
262
264
  // 読み直して保存と同じ形にそろえてから比べる
263
265
  const normalized = parseProjectConfig(parseJsonText(serializeProjectConfig(config)));
264
- if (skipIfUnchanged && existing !== undefined && serializeProjectConfig(existing) === serializeProjectConfig(normalized))
265
- return configPath;
266
+ if (skipIfUnchanged && existing !== undefined && serializeProjectConfig(existing) === serializeProjectConfig(normalized)) {
267
+ out.planned({ verb: 'unchanged', target: `config file ${configPath}` });
268
+ return { configPath, change: 'unchanged', activeProject: undefined };
269
+ }
266
270
  const verb = existing === undefined ? 'create' : 'update';
271
+ const activeProject = path.parse(configPath).name;
272
+ if (target.isDryRun === true) {
273
+ out.planned({ verb, target: `config file ${configPath}` });
274
+ out.planned({ verb: 'set', target: `active project to ${activeProject}` });
275
+ return { configPath, change: verb, activeProject };
276
+ }
267
277
  saveConfig(config, configPath);
268
278
  out.done({ verb, target: `config file ${configPath}` });
269
279
  setActiveConfig(configPath);
270
- out.done({ verb: 'set', target: `active project to ${path.parse(configPath).name}` });
271
- return configPath;
280
+ out.done({ verb: 'set', target: `active project to ${activeProject}` });
281
+ return { configPath, change: verb, activeProject };
272
282
  }
273
283
  //# sourceMappingURL=project-sync.js.map
@@ -1,5 +1,6 @@
1
+ import type { CommandDefinition } from './command-definition.js';
1
2
  /**
2
- project のコマンド。並びは tests/parity/commands.ts と同じ
3
+ project のグループのコマンド。並びは help の一覧の順
3
4
  */
4
- export declare const PROJECT_COMMANDS: import("./command-definition.js").CommandDefinition[];
5
+ export declare const PROJECT_COMMANDS: readonly CommandDefinition[];
5
6
  //# sourceMappingURL=project.d.ts.map