@pecot/workflow-mcp 7.0.0 → 7.0.1-dev.19

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 (41) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.md +1 -1
  3. package/cli/dist/commands/branch.js +1 -18
  4. package/cli/dist/commands/issue-board.d.ts +1 -1
  5. package/cli/dist/commands/issue-board.js +1 -1
  6. package/cli/dist/commands/issue-create.js +7 -11
  7. package/cli/dist/commands/issue-dependency.js +21 -12
  8. package/cli/dist/commands/issue-shared.d.ts +8 -2
  9. package/cli/dist/commands/issue-shared.js +22 -4
  10. package/cli/dist/commands/names.d.ts +1 -1
  11. package/cli/dist/commands/names.js +2 -3
  12. package/cli/dist/commands/pr-merge.js +9 -14
  13. package/cli/dist/commands/pr-restack.js +16 -18
  14. package/cli/dist/commands/pr.js +54 -44
  15. package/cli/dist/commands/project.js +2 -2
  16. package/cli/dist/commands/renamed-commands.js +0 -1
  17. package/cli/dist/commands/restack-reading.d.ts +45 -0
  18. package/cli/dist/commands/restack-reading.js +29 -0
  19. package/cli/dist/commands/session-finish.js +6 -18
  20. package/cli/dist/commands/session-start.js +10 -55
  21. package/cli/dist/commands/session.js +51 -168
  22. package/cli/dist/commands/work-target.d.ts +5 -8
  23. package/cli/dist/commands/work-target.js +17 -19
  24. package/cli/dist/domain/branch-name.d.ts +7 -0
  25. package/cli/dist/domain/branch-name.js +23 -1
  26. package/cli/dist/domain/command-hint.d.ts +1 -1
  27. package/cli/dist/domain/pull-request.d.ts +19 -2
  28. package/cli/dist/domain/pull-request.js +25 -9
  29. package/cli/dist/domain/restack.d.ts +4 -0
  30. package/cli/dist/domain/restack.js +4 -0
  31. package/cli/dist/domain/state.d.ts +2 -12
  32. package/cli/dist/domain/state.js +3 -14
  33. package/cli/dist/infra/git.d.ts +5 -0
  34. package/cli/dist/infra/git.js +7 -0
  35. package/cli/dist/infra/paths.d.ts +1 -3
  36. package/cli/dist/infra/paths.js +2 -45
  37. package/cli/dist/infra/state-store.d.ts +3 -8
  38. package/cli/dist/infra/state-store.js +6 -24
  39. package/cli/templates/workflow/pecot-board-sync.yml +3 -2
  40. package/npm-shrinkwrap.json +2 -2
  41. package/package.json +1 -1
@@ -1,14 +1,8 @@
1
1
  import type { IssueReference } from './reference-parser.js';
2
- export declare const FLAG_PECOT_ACTIVE = ".pecot-active";
3
2
  export declare const FLAG_PECOT_SESSION_TITLE = ".pecot-session-title";
4
3
  export declare const FLAG_PECOT_BASE = ".pecot-base";
5
4
  export declare const FLAG_PECOT_RESTACK = ".pecot-restack";
6
5
  export declare const FLAG_PECOT_QUICK_MODE = ".pecot-quick-mode";
7
- export declare const FLAG_WIP_BRANCH_LINKED = ".wip-branch-linked";
8
- export declare const FLAG_PR_CREATE_SLASH_PENDING = "pr-create-slash-pending";
9
- export declare const FLAG_ISSUE_CREATE_SLASH_PENDING = "issue-create-slash-pending";
10
- export declare const FLAG_MERGE_SLASH_PENDING = "merge-slash-pending";
11
- export declare const FLAG_ISSUE_PENDING = "issue-pending";
12
6
  export declare const SESSION_TITLE_MAX_CHARS = 40;
13
7
  /**
14
8
  セッション名 `#<番号> <Issue タイトル>` を組み立てる。
@@ -21,14 +15,10 @@ export declare function formatSessionTitle(issueNumber: number, title: string):
21
15
  `.pecot/work` の直下は Issue 番号の数字だけにする規約のため、全角数字などは通さない
22
16
  */
23
17
  export declare function workDirectoryName(issueReference: string): string | undefined;
24
- export interface WorkTarget {
25
- readonly active: string;
26
- readonly sessionTitle: string;
27
- }
28
18
  /**
29
- 作業対象として書く内容(.pecot-active と .pecot-session-title)を決める。参照の末尾が整数でなければ InvalidValueError
19
+ 作業対象のセッション名(.pecot-session-title に書く内容)を決める。参照の末尾が整数でなければ InvalidValueError
30
20
  */
31
- export declare function planWorkTarget(issueReference: string, title: string): WorkTarget;
21
+ export declare function planWorkTarget(issueReference: string, title: string): string;
32
22
  export interface BaseRecord {
33
23
  readonly branch: string;
34
24
  readonly sha: string;
@@ -4,24 +4,13 @@ import { parsePythonInteger, pythonRightStrip, pythonStrip, pythonStringRepr, tr
4
4
  import { createIssueReference, issueReferenceToString } from './reference-parser.js';
5
5
  import { createRepositoryReference } from './repository-resolver.js';
6
6
  // フラグファイル名
7
- export const FLAG_PECOT_ACTIVE = '.pecot-active';
8
- // セッション名(hooks の session-title.sh が Claude Code の sessionTitle に流す)。.pecot-active と同じタイミングで書く
7
+ // セッション名のキャッシュ(hooks の session-title.sh が Claude Code の sessionTitle に流す)。session start がブランチを作るときに書く
9
8
  export const FLAG_PECOT_SESSION_TITLE = '.pecot-session-title';
10
9
  // 着手のときに選んだ base(ブランチ・位置・積んだ先の Issue)。session start が書き、session finish が消す
11
10
  export const FLAG_PECOT_BASE = '.pecot-base';
12
11
  // 衝突で止まった載せ直しの途中の記録。pr restack が書き、続行か取りやめで消す
13
12
  export const FLAG_PECOT_RESTACK = '.pecot-restack';
14
13
  export const FLAG_PECOT_QUICK_MODE = '.pecot-quick-mode';
15
- export const FLAG_WIP_BRANCH_LINKED = '.wip-branch-linked';
16
- // スラッシュコマンド起点の外部反映免除フラグ。
17
- // 設置は hooks の create-slash-flag.sh が行う。
18
- // 確認は mcp-handlers/pecot-post-ask.sh(merge は pr_merge も。gh pr merge は core/external-post-check.sh)が行う。
19
- // MCP ツールが実投稿成功時に削除する。
20
- export const FLAG_PR_CREATE_SLASH_PENDING = 'pr-create-slash-pending';
21
- export const FLAG_ISSUE_CREATE_SLASH_PENDING = 'issue-create-slash-pending';
22
- export const FLAG_MERGE_SLASH_PENDING = 'merge-slash-pending';
23
- // 起票未完了のリマインド用フラグ。設置は hooks、確認は pecot-issue-pending-reminder.sh。MCP ツールが起票成功時に削除する
24
- export const FLAG_ISSUE_PENDING = 'issue-pending';
25
14
  export const SESSION_TITLE_MAX_CHARS = 40;
26
15
  const ISSUE_TYPE_PREFIX_PATTERN = /^\[(?:Task|Bug|Epic)\]\s*/u;
27
16
  /**
@@ -50,14 +39,14 @@ export function workDirectoryName(issueReference) {
50
39
  return /^\d+$/u.test(number) ? number : undefined;
51
40
  }
52
41
  /**
53
- 作業対象として書く内容(.pecot-active と .pecot-session-title)を決める。参照の末尾が整数でなければ InvalidValueError
42
+ 作業対象のセッション名(.pecot-session-title に書く内容)を決める。参照の末尾が整数でなければ InvalidValueError
54
43
  */
55
44
  export function planWorkTarget(issueReference, title) {
56
45
  const text = lastSegment(issueReference);
57
46
  const number = parsePythonInteger(text);
58
47
  if (number === undefined)
59
48
  throw new InvalidValueError(`invalid literal for int() with base 10: ${pythonStringRepr(text)}`);
60
- return { active: issueReference, sessionTitle: formatSessionTitle(number, title) };
49
+ return formatSessionTitle(number, title);
61
50
  }
62
51
  // ブランチ名に空白は入らないので、空白で区切る
63
52
  const BASE_SHA_PATTERN = /^(?:[\da-f]{40}|[\da-f]{64})$/u;
@@ -1,6 +1,7 @@
1
1
  import type { GitResult, GitRunner } from '../domain/git-runner.js';
2
2
  import type { RemoteLocation } from '../domain/git-url.js';
3
3
  import { BaseError } from '../domain/errors.js';
4
+ import type { IssueReference } from '../domain/reference-parser.js';
4
5
  export interface GitOptions {
5
6
  /**
6
7
  作業ディレクトリ。省略すると呼び出し元の作業ディレクトリ
@@ -80,6 +81,10 @@ export declare function primaryRemoteRepository(cwd?: string): RemoteLocation |
80
81
  */
81
82
  export declare function gitCurrentBranch(cwd?: string): string | undefined;
82
83
  /**
84
+ 作業中の Issue。主の remote のリポと現在のブランチ名の末尾の番号から決める。どちらかが読めなければ undefined
85
+ */
86
+ export declare function activeIssueOf(directory?: string): IssueReference | undefined;
87
+ /**
83
88
  指定した remote の URL から host・owner・repository を返す。remote 不在・git の外・URL 形式の不一致は undefined
84
89
  */
85
90
  export declare function remoteRepository(cwd: string | undefined, remote: string): RemoteLocation | undefined;
@@ -3,6 +3,7 @@
3
3
  import { spawnSync } from 'node:child_process';
4
4
  import { existsSync } from 'node:fs';
5
5
  import path from 'node:path';
6
+ import { activeIssueFromBranch } from '../domain/branch-name.js';
6
7
  import { parseRemoteUrl } from '../domain/git-url.js';
7
8
  import { BaseError, InvalidValueError } from '../domain/errors.js';
8
9
  import { normalizeNewlines, pythonRepr, pythonStrip } from '../domain/python-format.js';
@@ -129,6 +130,12 @@ export function gitCurrentBranch(cwd) {
129
130
  return runForValue(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd });
130
131
  }
131
132
  /**
133
+ 作業中の Issue。主の remote のリポと現在のブランチ名の末尾の番号から決める。どちらかが読めなければ undefined
134
+ */
135
+ export function activeIssueOf(directory) {
136
+ return activeIssueFromBranch(primaryRemoteRepository(directory), gitCurrentBranch(directory));
137
+ }
138
+ /**
132
139
  指定した remote の URL から host・owner・repository を返す。remote 不在・git の外・URL 形式の不一致は undefined
133
140
  */
134
141
  export function remoteRepository(cwd, remote) {
@@ -32,9 +32,7 @@ export interface ProjectRootOptions {
32
32
  /**
33
33
  プロジェクトルートを取得する。
34
34
  1. CLAUDE_PROJECT_DIR があれば使う(テスト上書き用)。
35
- 2. cwd が PECOT_SESSION_PROJECT_DIR の .pecot/work 配下(入れ子の git リポを除く)なら、その実体パス。
36
- worktree の .pecot/work は base への symlink で、そこでは git toplevel が base になる。
37
- 3. なければ git rev-parse --show-toplevel で解決する(GIT_* を除いて実行する)。
35
+ 2. なければ git rev-parse --show-toplevel で解決する(GIT_* を除いて実行する)。
38
36
 
39
37
  どれも得られなければ ProjectRootNotFoundError
40
38
  */
@@ -1,7 +1,7 @@
1
1
  /* eslint-disable security/detect-non-literal-fs-filename -- パスは呼び出し側が決める。ここは解決と予約だけ */
2
2
  // pecot リポジトリ基準のパス解決。`.pecot/` 配下のパス定義の唯一の置き場。
3
3
  // projectRoot() でプロジェクトルートを解決し、一時ファイルの出力先を固定する。
4
- import { closeSync, existsSync, mkdirSync, openSync, realpathSync, unlinkSync } from 'node:fs';
4
+ import { closeSync, mkdirSync, openSync, realpathSync, unlinkSync } from 'node:fs';
5
5
  import path from 'node:path';
6
6
  import { PecotError, ProjectRootNotFoundError } from '../domain/errors.js';
7
7
  import { gitToplevel } from './git.js';
@@ -55,42 +55,6 @@ export function resolveRealPath(target) {
55
55
  throw error;
56
56
  }
57
57
  }
58
- /**
59
- cwd がセッションの worktree の .pecot/work の実体配下なら、その worktree を返す。
60
- セッション開始時の SessionStart hook が PECOT_SESSION_PROJECT_DIR に書いた値を起点にする。git は呼ばない。
61
- hooks の project-root.sh と同じ判定を使う。cwd の文字列が `.pecot/work` で終わるか `.pecot/work/` を含み、実体が起点の .pecot/work の実体配下にある。
62
- かつ途中に `.git` を持つディレクトリ(入れ子の git リポ)が無いときだけ対象にする
63
- */
64
- function sessionWorkOwner(cwd) {
65
- const sessionDirectory = process.env['PECOT_SESSION_PROJECT_DIR'];
66
- if (sessionDirectory === undefined || sessionDirectory === '')
67
- return undefined;
68
- // 安価な文字列の判定を、realpath の解決より先に行う
69
- if (!(cwd.endsWith(`/${WORK_DIR}`) || cwd.includes(`/${WORK_DIR}/`)))
70
- return undefined;
71
- let workReal;
72
- let cwdReal;
73
- try {
74
- workReal = resolveRealPath(path.join(sessionDirectory, WORK_DIR));
75
- cwdReal = resolveRealPath(cwd);
76
- }
77
- catch (error) {
78
- if (hasErrorCode(error))
79
- return undefined;
80
- throw error;
81
- }
82
- if (cwdReal !== workReal && !cwdReal.startsWith(`${workReal}/`))
83
- return undefined;
84
- for (let directory = cwdReal;; directory = path.dirname(directory)) {
85
- if (directory === workReal)
86
- break;
87
- if (existsSync(path.join(directory, '.git')))
88
- return undefined;
89
- if (path.dirname(directory) === directory)
90
- break;
91
- }
92
- return resolveRealPath(sessionDirectory);
93
- }
94
58
  function currentDirectory(options) {
95
59
  try {
96
60
  return options.cwd ?? process.cwd();
@@ -105,9 +69,7 @@ function currentDirectory(options) {
105
69
  /**
106
70
  プロジェクトルートを取得する。
107
71
  1. CLAUDE_PROJECT_DIR があれば使う(テスト上書き用)。
108
- 2. cwd が PECOT_SESSION_PROJECT_DIR の .pecot/work 配下(入れ子の git リポを除く)なら、その実体パス。
109
- worktree の .pecot/work は base への symlink で、そこでは git toplevel が base になる。
110
- 3. なければ git rev-parse --show-toplevel で解決する(GIT_* を除いて実行する)。
72
+ 2. なければ git rev-parse --show-toplevel で解決する(GIT_* を除いて実行する)。
111
73
 
112
74
  どれも得られなければ ProjectRootNotFoundError
113
75
  */
@@ -116,11 +78,6 @@ export function projectRoot(options = {}) {
116
78
  if (fromEnvironment !== undefined && fromEnvironment !== '')
117
79
  return normalizePath(fromEnvironment);
118
80
  const cwd = currentDirectory(options);
119
- if (cwd !== undefined) {
120
- const sessionRoot = sessionWorkOwner(cwd);
121
- if (sessionRoot !== undefined)
122
- return sessionRoot;
123
- }
124
81
  // git push 等のフック内では GIT_DIR 等が設定され、作業ディレクトリの代わりに参照される。
125
82
  // そのため GIT_* を除いて作業ディレクトリ基準で解決する
126
83
  const toplevel = gitToplevel({ cwd, stripGitEnvironment: true });
@@ -11,7 +11,7 @@ export interface StateDirectoryOptions {
11
11
  export declare function getStateDirectory(options?: Readonly<StateDirectoryOptions>): string;
12
12
  /**
13
13
  作業ディレクトリ `.pecot/work/<Issue番号>/` を作って返す。
14
- .pecot-active へ作業対象を記録するタイミング(session start / session restore)で呼ぶ。
14
+ ブランチを作るとき(session start)に呼ぶ。
15
15
  作れないとき(プロジェクトルート不明・OS のエラー)は undefined。作業フロー自体は止めない
16
16
  */
17
17
  export declare function ensureWorkDirectory(issueReference: string): string | undefined;
@@ -24,11 +24,6 @@ export declare function touchFlag(flagName: string): void;
24
24
  */
25
25
  export declare function removeFlag(flagName: string): void;
26
26
  /**
27
- 実投稿成功時にスラッシュコマンド免除フラグを消費(削除)する。
28
- 投稿自体は成功しているため、フラグ解決の失敗(git リポ外等)でコマンドを失敗させない
29
- */
30
- export declare function consumeFlag(flagName: string): void;
31
- /**
32
27
  通常のファイルとして存在するか
33
28
  */
34
29
  export declare function hasFlag(flagName: string): boolean;
@@ -47,8 +42,8 @@ export declare function writeBaseRecord(record: Readonly<BaseRecord>): void;
47
42
  */
48
43
  export declare function readBaseRecord(): BaseReading;
49
44
  /**
50
- 作業対象を記録する(.pecot-active と .pecot-session-title を同時に書く)。
45
+ セッション名のキャッシュ(.pecot-session-title)を書く。
51
46
  issueReference の末尾が整数でなければ InvalidValueError で、何も書かない
52
47
  */
53
- export declare function writeWorkTarget(issueReference: string, title: string): void;
48
+ export declare function writeSessionTitle(issueReference: string, title: string): void;
54
49
  //# sourceMappingURL=state-store.d.ts.map
@@ -4,8 +4,8 @@ import { closeSync, mkdirSync, openSync, statSync, unlinkSync, utimesSync, write
4
4
  import path from 'node:path';
5
5
  import { ProjectRootNotFoundError } from '../domain/errors.js';
6
6
  import { pythonStrip } from '../domain/python-format.js';
7
- import { FLAG_PECOT_ACTIVE, FLAG_PECOT_BASE, FLAG_PECOT_SESSION_TITLE, formatBaseRecord, interpretBaseRecord, planWorkTarget, workDirectoryName } from '../domain/state.js';
8
- import { OsError, hasErrorCode, isFileNotFound, isSystemCallError } from './os-error.js';
7
+ import { FLAG_PECOT_BASE, FLAG_PECOT_SESSION_TITLE, formatBaseRecord, interpretBaseRecord, planWorkTarget, workDirectoryName } from '../domain/state.js';
8
+ import { OsError, hasErrorCode, isFileNotFound } from './os-error.js';
9
9
  import { projectRoot, STATE_DIR, WORK_DIR } from './paths.js';
10
10
  import { readTextFile } from './text-file.js';
11
11
  /**
@@ -19,7 +19,7 @@ export function getStateDirectory(options = {}) {
19
19
  }
20
20
  /**
21
21
  作業ディレクトリ `.pecot/work/<Issue番号>/` を作って返す。
22
- .pecot-active へ作業対象を記録するタイミング(session start / session restore)で呼ぶ。
22
+ ブランチを作るとき(session start)に呼ぶ。
23
23
  作れないとき(プロジェクトルート不明・OS のエラー)は undefined。作業フロー自体は止めない
24
24
  */
25
25
  export function ensureWorkDirectory(issueReference) {
@@ -59,22 +59,6 @@ export function removeFlag(flagName) {
59
59
  }
60
60
  }
61
61
  /**
62
- 実投稿成功時にスラッシュコマンド免除フラグを消費(削除)する。
63
- 投稿自体は成功しているため、フラグ解決の失敗(git リポ外等)でコマンドを失敗させない
64
- */
65
- export function consumeFlag(flagName) {
66
- try {
67
- removeFlag(flagName);
68
- }
69
- catch (error) {
70
- // 握るのは OS の失敗とプロジェクトルート不明だけ。投稿は成功しているので、後始末の失敗でコマンドを失敗させない。
71
- // プログラムの誤り(TypeError など)は握らない
72
- if (error instanceof ProjectRootNotFoundError || isSystemCallError(error))
73
- return;
74
- throw error;
75
- }
76
- }
77
- /**
78
62
  通常のファイルとして存在するか
79
63
  */
80
64
  export function hasFlag(flagName) {
@@ -119,12 +103,10 @@ export function readBaseRecord() {
119
103
  return interpretBaseRecord(readFlag(FLAG_PECOT_BASE));
120
104
  }
121
105
  /**
122
- 作業対象を記録する(.pecot-active と .pecot-session-title を同時に書く)。
106
+ セッション名のキャッシュ(.pecot-session-title)を書く。
123
107
  issueReference の末尾が整数でなければ InvalidValueError で、何も書かない
124
108
  */
125
- export function writeWorkTarget(issueReference, title) {
126
- const target = planWorkTarget(issueReference, title);
127
- writeFlag(FLAG_PECOT_ACTIVE, target.active);
128
- writeFlag(FLAG_PECOT_SESSION_TITLE, target.sessionTitle);
109
+ export function writeSessionTitle(issueReference, title) {
110
+ writeFlag(FLAG_PECOT_SESSION_TITLE, planWorkTarget(issueReference, title));
129
111
  }
130
112
  //# sourceMappingURL=state-store.js.map
@@ -76,9 +76,10 @@ jobs:
76
76
  permission-pull-requests: read
77
77
  permission-contents: read
78
78
 
79
- # Pin the major version here. Raise it when the plugin's major version is raised.
79
+ # The dist-tag after the package name decides the version. @latest is the newest release,
80
+ # and a new major version brings breaking changes. Use @<major> or @<version> to stay on one.
80
81
  # --prefix=/ keeps npx from stopping in a repository that declares pnpm devEngines.
81
82
  - name: Sync the board
82
83
  env:
83
84
  PECOT_GITHUB_COM_TOKEN: ${{ steps.app-token.outputs.token || secrets.PECOT_BOARD_SYNC_TOKEN }}
84
- run: npx -y --prefix=/ @pecot/workflow-mcp@7 board sync
85
+ run: npx -y --prefix=/ @pecot/workflow-mcp@latest board sync
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@pecot/workflow-mcp",
3
- "version": "7.0.0",
3
+ "version": "7.0.1-dev.19",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@pecot/workflow-mcp",
9
- "version": "7.0.0",
9
+ "version": "7.0.1-dev.19",
10
10
  "license": "MIT",
11
11
  "dependencies": {
12
12
  "@modelcontextprotocol/server": "^2.4.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pecot/workflow-mcp",
3
- "version": "7.0.0",
3
+ "version": "7.0.1-dev.19",
4
4
  "type": "module",
5
5
  "description": "pecot-workflow MCP server (standalone distribution)",
6
6
  "license": "MIT",