Repository navigation
Conversation
## 概要 公開済みの `backlog-mcp-server@0.13.2` が提供する通常ツールのハンドラーを直接利用し、MCPトランスポートから分離した `backlog-api` のNode Core/CLIを追加します。 ## 変更内容 - upstreamの58操作について、元のツール名、Zod入力スキーマ、ハンドラー呼び出しを維持した共通実行基盤を追加 - JSON形式のCLIレスポンス、dry-run、破壊的操作の明示確認、終了コードと診断情報を実装 - 実行可能CLIバンドル、import可能runtimeバンドル、ソースアーカイブの生成処理とスモークテストを追加 - upstreamのソース、テスト、コミットとの対応を追跡する生成マッピングと関連文書を追加 - Node.js 22/24のCI、およびGitHub Release向け成果物作成workflowを追加 - README、開発記録、TODO、第三者ライセンス表示、リポジトリ運用設定を追加 - operation一覧、入力検証、直接ハンドラー呼び出し、破壊的操作ガード、CLI動作を検証するテストを追加 ## 確認内容 - `npm test` - `npm run smoke:node`
Backlog MCP handlersをスタンドアロンNode Core/CLIへ移行
## 概要 Node版の互換性・保守作業をGitHub Issuesで追跡できるように整理し、Backlog実環境への接続実験で確認した設定方法と操作上の知見を文書化します。あわせてパッチバージョンを0.3.1へ更新します。 ## 変更内容 - READMEとTODOをGitHub Issues #2〜#7への案内に更新し、登録済みのIssue下書きファイルを削除 - `workplace/backlog.env`のテンプレート、ファイル権限、Git除外、秘密情報を表示しない運用、読み取り専用から始める方針をREADMEへ追加 - 実環境で確認したプロジェクトキー制約、課題の作成・取得・一覧、Markdown、チャート、親子課題、コメント操作の知見を文書化 - package.json、lockfile、runtime、テスト、開発資料、トレーサビリティ対応表のバージョンを0.3.1へ同期 ## 確認内容 - `npm run trace:refresh`（58操作） - `npm test`（8件成功） - `npm run smoke:node` ## 関連Issue Refs #2 Refs #3 Refs #4 Refs #5 Refs #6 Refs #7
GitHub Issue管理とBacklog実接続手順を整備しバージョンを0.3.1へ更新
## 概要 Backlog API操作をクライアント側で制限するCRUD実行許可をCLIへ追加し、生成AIや自動化ツールが入出力と安全条件を判断できるようにヘルプを拡充します。あわせてプロジェクトをベータ版として明示し、パッチバージョンを0.3.2へ更新します。 ## 変更内容 - `call`の既定許可を`READ`のみにし、`CREATE`、`UPDATE`、`DELETE`を`--allow`で明示する実行ポリシーを追加 - `DELETE`では`--allow DELETE`と既存の`--confirm-destructive`を独立した安全確認として要求 - 全58操作へ`requiredPermission`を割り当て、`tools list`のJSONカタログへ出力 - 許可不足をBacklog接続前に`PERMISSION_REQUIRED`として返す処理と、未対応の許可値をCLI利用エラーにする検証を追加 - `--version`が`0.3.2`のみを返す契約を固定し、`--help`へコマンド、JSON入出力、安全性、環境変数、終了コード、実行例を追加 - READMEと開発資料へベータ版の状態、CRUD実行許可、miku-soft保守参照を記録 - package、lockfile、runtime、テスト、smoke、トレーサビリティ対応表を0.3.2へ同期 ## 確認内容 - `npm run trace:refresh`（58操作） - `npm test`（10件成功） - `npm run smoke:node` - 実Backlog環境で、既定`READ`による読み取りと`--allow CREATE`によるdry-run、課題作成、READによる再取得が成功することを確認
CLIにCRUD実行許可と詳細ヘルプを追加し0.3.2へ更新
## 概要 backlog-apiをバージョン0.3.3へ更新し、Node Core/CLIの正式ソースをTypeScriptへ移行します。あわせて、上流MCPハンドラーとの差分テスト、GraphQL風の結果フィールド選択、安全なBacklog APIアクセス概要を追加します。 ## 変更内容 - strict設定のTypeScriptビルドと型検査を追加 - アプリケーションソースをTypeScriptへ移行し、配布用CLIとruntimeの.mjsバンドル生成を維持 - READ、CREATE、UPDATE、DELETEの代表操作について、上流の合成済みMCPハンドラーとNode操作の差分テストを追加 - トップレベルのfieldsでGraphQL風の結果フィールド選択を追加 - 不正なfieldsをBacklog呼び出し前に拒否し、JSON結果エンベロープを維持 - 文字列切断により不完全なJSONを返す可能性があるトークン数制限は採用せず、その判断を文書化 - --verboseでAPIアクセスの開始・成功・失敗、操作、APIメソッド、CRUD権限、組織分類をstderrへ出力 - verboseログから引数、認証情報、応答データ、組織名、エラー本文を除外 - TypeScriptソースとテストに合わせてトレーサビリティ資料および生成マッピングを更新 ## 検証 - npm run typecheck - npm test（22件成功） - npm run smoke:node - 実際のBacklog環境でget_spaceを--verbose付きで実行し、READ成功と安全なstart/successログを確認 ## 関連Issue Closes #2 Closes #3 Refs #10
TypeScriptベースのCLIへ移行し上流互換性と安全なアクセス追跡を強化
## 概要 `--verbose`で出力するBacklog APIアクセス情報をJSON形式へ統一し、ホワイトリストで許可したリソース識別情報と実行メタデータを追加します。通常のstdout契約を維持しつつ、認証情報、本文、個人情報、検索語、エラー本文などはverboseログへ出力しません。 ## 変更内容 - startとsuccessまたはfailureで同じアクセス番号を使用する、`verbose: `プレフィックス付きJSONイベントへ変更 - 入力からスペース、プロジェクト、課題、Wiki、Gitリポジトリ、プルリクエスト、コメント、添付ファイルの安全なID・キーだけを抽出して`target`へ追加 - 成功結果から許可したID・キーだけを抽出して`result`へ追加 - `durationMs`、値を含まない`changedFields`、`offset`・`count`のページング情報を追加 - 失敗オブジェクトが実際に公開している場合のみ`httpStatus`を追加し、成功ステータスは推測しない - README、CLIヘルプ、開発資料、トレーサビリティ資料を新しいverbose契約へ更新 - Backlog APIのレート制限について、ユーザー単位の制限、レスポンスヘッダー、運用上の管理単位、今後の実装指針を文書化 - READ、CREATE、UPDATE、DELETEの代表操作と、検索語や本文などの情報漏洩防止をテスト - バージョンを`0.3.4`へ更新 ## 検証 - `npm run typecheck` - `npm test`（28テスト成功） - `npm run smoke:node` - `git diff --check` ## 関連Issue Closes #10 Refs #12
--verboseの安全な識別情報と実行メタデータを拡充する
## 概要 `backlog-api`へ環境変数によるCRUD権限の上限を追加し、未設定時はREADだけを 許可する安全な既定動作にしました。あわせてBacklog APIレスポンスのレート制限 情報を安全に捕捉し、Node独自の`get_rate_limit`操作として参照できるように しました。 バージョンは`0.3.4`から`0.4.0`へ更新しました。 ## 変更内容 ### CRUD権限の環境上限 - `BACKLOG_API_ALLOWED_PERMISSIONS`を追加 - 未設定時は`READ`だけを許可 - カンマ区切り、前後の空白、大小文字、重複を正規化 - 空要素や未知の値をBacklogクライアント解決前に拒否 - 環境側の権限上限と呼び出し単位の`--allow`を両方評価 - Node APIで`allowedPermissions`を省略した場合もREADだけを許可 - DELETEでは既存の破壊的操作確認を継続 ### レート制限情報 - Backlogクライアントへレスポンス捕捉用の`fetch`を注入 - 実レスポンスのHTTP状態と3つの`X-RateLimit`ヘッダーだけを検証して取得 - UNIX秒のリセット時刻をUTC ISO 8601へ変換 - 非同期コンテキストにより並行アクセス間のメタデータ混在を防止 - `read`、`update`、`search`、`icon`を返すREAD操作`get_rate_limit`を追加 - 上流58操作とNode独自操作をトレース情報で区別 ### CLI・文書・バージョン - `--help`だけで環境変数の形式、既定値、権限評価、DELETE要件を判断できるよう更新 - README、レート制限資料、開発資料、トレーサビリティ資料を更新 - 操作カタログを上流58操作とNode独自1操作の計59操作へ更新 - `backlog-js`を直接依存として明示 - バージョンを`0.4.0`へ更新 ## 動作確認 - `npm test`：38テスト成功 - `npm run smoke:node`：成功 - 実Backlog環境で権限上限をREADへ固定して`get_space`と`get_rate_limit`の成功を確認 - 実レスポンスのHTTP状態、レート制限ヘッダー、4つのレート制限区分を確認 - 認証情報、組織情報、取得本文を出力・保存していないことを確認 ## 関連Issue Closes #14 Closes #12 Closes #6
CRUD権限上限とレート制限取得を追加し0.4.0へ更新
## 概要 CRUD権限の解析と操作ごとのアクセス方針を整理し、新しい操作が追加された際に 未定義の権限で実行されない構造へ変更しました。あわせてCLI引数解析を独立した 処理へ分離し、未知・重複オプションや余分な引数を明示的な使用法エラーとして 扱うようにしました。 製品バージョンは`0.4.0`から`0.4.1`へ更新しました。 ## 変更内容 ### CRUD権限と操作ポリシー - 環境変数と`--allow`で共通利用するCRUD権限パーサーを追加 - 既定のREAD権限と対応する4権限の定義を一元化 - 全59操作のmutation分類と必要権限を明示的なポリシーとして定義 - 未知の操作を環境設定やBacklogクライアントの解決前に拒否 - ポリシー未定義の操作を暗黙のREADとして扱わず、設定エラーとして停止 ### CLI引数解析 - CLI引数解析を独立した純粋関数へ分離 - 未知のオプション、重複オプション、余分な位置引数を終了コード2で拒否 - `help`、`--version`、`tools list`、`trace`、`call`ごとの引数条件を明示 - 厳格な引数規則を`--help`へ追加 ### バージョンとトレーサビリティ - `package.json`、lock、製品情報、開発資料を`0.4.1`へ更新 - 操作対応表を再生成し、対象製品バージョンを更新 - CLIとruntimeのバージョン検証を更新 ## 動作確認 - `npm run trace:refresh`：59操作の対応表を生成 - `npm test`：41テスト成功 - `npm run smoke:node`：成功
CRUD権限ポリシーとCLI引数解析を整理し0.4.1へ更新
## Overview backlog-apiのCLIに、AI agentがoperationの入力仕様と安全要件を機械可読形式で確認できる導線を追加します。 ## Changes - `tools describe <operation>`と`call <operation> --help`を追加し、入力JSON Schema、結果フィールド、権限、破壊確認要否、例を返す - IDまたはキーなどの相関必須条件を共通化し、接続情報なしのdry-runでも不完全な入力を検出する - 全operationとCLI導線を対象としたテスト、README、traceability文書を更新する - Zodスキーマ変換依存を明示し、製品バージョンを`0.5.0`へ更新する
AI agent向けのoperation契約をCLIから取得可能にする
## 概要 `backlog-mcp-server` の互換対象を v0.14.0 へ更新し、追加・変更された課題操作を Node Core/CLI に反映します。 ## 変更内容 - `backlog-mcp-server@0.14.0` と `backlog-js@0.19.0` へ更新し、プロダクト版を 0.6.0 に更新 - 関連課題の取得・追加・解除と課題コメント更新を公開し、READ/CREATE/UPDATE/DELETEの 権限・確認契約を追加 - `update_issue.parentIssueId` と、非正の `issueId` から `issueKey` への フォールバックを上流と同じ挙動で維持 - 操作対応表を63件（上流62件とNode固有 `get_rate_limit`）へ再生成し、差分テスト、 CLI dry-run、verbose metadata、安全確認のテストを追加 - 利用方法・トレーサビリティ資料と下流 `backlog-api-skills` 向け引継ぎ資料を更新 ## 確認 - `npm run typecheck` - `npm run trace:refresh` - `npm test`（49件） - `npm run smoke:node` ## 関連Issue Refs #7 Refs #18
backlog-mcp-server v0.14.0対応とbacklog-api 0.6.0更新
## Overview Issue #21 に基づき、Node Core/CLI の製品名を `miku-backlog-api` へ移行するためのローカル実装と実施計画を追加します。GitHub リポジトリ名の変更、Release 作成、姉妹 Skill リポジトリの移行は後続の人手ゲートとして扱います。 ## Changes - `miku-backlog-api` を package、製品メタデータ、CLI、bundle、Release asset の正規名とし、version を `0.7.0` に更新 - `backlog-api` を `0.7.x` の package CLI compatibility alias として維持 - local toolset、trace origin、verbose event type、traceability mapping を新名称へ更新 - build、smoke、Release workflow、README、開発・runtime handoff 資料、テストを新名称へ整合 - Issue #21 の名称変更計画と TODO の進捗を更新
miku-backlog-api 0.7.0 への名称変更を準備
docs: update Skills repository link
## Overview Record the completed `miku-backlog-api` and `miku-backlog-api-skills` migration. ## Changes - Mark the main repository rename, `v0.7.0` Release, sister repository migration, and cross-repository closure as complete in `TODO.md`. - Add the verified main and sister Release, compatibility, and CI completion record to the rename plan. - Keep the separate product work in Issues #4, #5, and #20 marked as open.
docs: record miku-backlog-api migration completion
## Overview Prepare the `miku-backlog-api` 0.7.1 patch version. ## Changes - Update the package manifest, lockfile, and product metadata to `0.7.1`. - Align the generated upstream mapping and downstream runtime handoff record with the new package version. - Update CLI and runtime smoke expectations for `0.7.1`.
chore: bump version to 0.7.1
## Overview Execute the recorded open-Issue plan for the Node runtime and retain the dependency-boundary decision with traceable evidence. ## Changes - add the product-owned READ operations `get_project_statuses` and `list_organizations`, including input, permission, trace, CLI, runtime, and local-configuration safeguards - document the terminal Closed-status rule and the accepted `backlog-mcp-server@0.14.0` dependency exception - regenerate the operation mapping to cover 62 upstream and three local operations, and update agent-oriented planning and traceability records - extend local-operation and CLI/runtime coverage; `npm run typecheck`, `npm test`, and `npm run smoke:node` pass
Implement project-status and organization discovery operations
## Overview Align the runtime package and release metadata on v0.7.6 after the merged project-status and organization-discovery functionality. ## Changes - update package, lockfile, product, CLI, runtime smoke-test, and trace mapping versions to 0.7.6 - update the downstream runtime handoff with the three current Node-specific operations and their release prerequisites - verify the release metadata with typecheck, trace refresh, the 54-test suite, and the Node smoke test
Prepare v0.7.6 runtime release
## 概要 `miku-backlog-api` のパッケージバージョンを `0.7.6` から `0.7.7` へ更新します。 ## 変更内容 - パッケージ定義、ロックファイル、製品メタデータのバージョンを更新 - CLI・runtime smoke・Node CLI テストの期待バージョンを更新 - 開発文書とトレーサビリティ情報のバージョンを同期 ## 確認事項 - `npm run trace:refresh` - `npm test`（54件成功） - `npm run smoke:node`
v0.7.7 へのパッチバージョン更新
## Overview `backlog-mcp-server` の上流互換基準を v0.18.0 に更新します。 ## Changes - 公開ルート API を利用し、公開されていない `build/` サブパスへの import を廃止 - 正確な上流タグから操作マッピングを再生成 - 上流の list-only field array との差異として、Node CLI のネストした GraphQL-style `fields` 互換レイヤーを維持 - `npm ci`、型検査、トレース生成、テスト、Node smoke test を実行
Update upstream compatibility baseline to backlog-mcp-server v0.18.0
## 概要 PR #31 で導入済みの `backlog-mcp-server@0.18.0` 連携に対し、upstream が 公開する出力メタデータをそのまま CLI 契約へ反映します。 ## 変更内容 - upstream 操作の `tools describe` で、推測した `outputFieldSchema` を返さず `outputFields` を返す - Node 固有操作は、プロダクトが定義する実際の `outputFieldSchema` を維持 - CLI・ランタイム契約テストとトレーサビリティ文書を更新 ## 確認事項 - `npm ci` - `npm test`（54件成功） - `npm run trace:refresh` - `npm run smoke:node` - `git diff --check`
upstream の outputFields を互換スキーマなしで公開する
## 概要 完了した upstream 出力メタデータ契約の変更を `miku-backlog-api` v0.7.8 として 記録します。 ## 変更内容 - `package.json` と lockfile のパッケージバージョンを `0.7.8` へ更新 - 製品メタデータ、CLI／スモークテスト、ランタイムテストを同期 - 開発文書、下流引継ぎ情報、上流トレーサビリティマッピングを同期 ## 確認事項 - `npm test`（54件成功） - `npm run trace:refresh` - `npm run smoke:node` - `git diff --check`
v0.7.8 へのパッチバージョン更新
## 概要 Backlog のアーカイブ用途で必要な共有ファイル一覧と、Issue・Wiki・共有ファイルの バイナリ取得を Node ランタイムに追加します。 ## 変更内容 - `get_shared_files` READ 操作を追加し、ディレクトリ、ページング、ファイル／フォルダ メタデータを既存の JSON 契約で返す - `download_issue_attachment`、`download_wiki_attachment`、 `download_shared_file` をストリーム転送として追加 - `download` CLI と `openDownload` API を追加し、バイナリと JSON 出力を分離する。 ファイル出力は完了後に原子的に公開し、既存ファイルを上書きしない - 転送完了・失敗の verbose イベント、操作カタログ、トレーサビリティ、README、TODO、 CLI／ランタイム／転送テストを更新 ## 確認事項 - `npm run typecheck` - `npm run trace:refresh` - `npm test`（60件成功） - `npm run smoke:node` - `git diff --check`
アーカイブ用途に必要な添付・共有ファイルの取得機能を追加する
## 概要 共有ファイルと添付ファイルの取得機能を含むリリースとして、 `miku-backlog-api` を `0.7.9` へ更新します。 ## 変更内容 - `package.json` と lockfile のパッケージバージョンを `0.7.9` へ更新 - 製品メタデータ、CLI テスト、runtime smoke テストを同期 - 開発文書、下流ランタイム引継ぎ情報、生成済みトレーサビリティマッピングを同期 ## 確認事項 - `npm run typecheck` - `npm run trace:refresh` - `npm test`（60件成功） - `npm run smoke:node` - `git diff --check`
v0.7.9 へのパッチバージョン更新
## 概要 個別課題の参加者一覧をアーカイブ用途で取得できるよう、Node 固有の `get_issue_participants` READ 操作を追加します。あわせてリリース版を `0.7.10` に更新します。 ## 変更内容 - `backlog-js#getIssueParticipants` を、既存の issue ID/key 解決・organization・ permission・dry-run・fields・trace・verbose 契約に接続 - Backlog ユーザーの出力スキーマ、操作カタログ、CLI discovery、runtime export、 トレーサビリティを更新 - 正常取得、ID/key fallback、dry-run 入力エラー、上流エラー、verbose の 個人情報非出力をテスト - package、lockfile、製品メタデータ、文書、生成マッピングを `0.7.10` へ同期 ## 確認事項 - `npm run typecheck` - `npm run trace:refresh` - `npm test`（63件成功） - `npm run smoke:node` - `git diff --check`
get_issue_participants READ 操作を追加する
## 概要 Wikiページの添付一覧を本文取得とは独立して照会できる `get_wiki_attachments` を追加します。Backlog API の `GET /api/v2/wikis/:wikiId/attachments` を呼び出し、アーカイブ時の添付メタデータ確認に利用できます。 ## 変更内容 - 正の `wikiId` を受け取り、`id`・`name`・`size` を含む添付一覧を返す Node 専用 READ 操作を追加 - READ 権限、dry-run、fields 選択、trace、verbose の既存契約に接続 - 操作カタログ、CLI ドキュメント、上流操作追跡表を更新 - パッケージを `0.7.11` に更新 - エンドポイントと READ 動作を確認するテストを追加 - `npm test`、`npm run typecheck`、`npm run smoke:node` を確認 ## 関連Issue Closes #39
Wiki添付ファイル一覧取得のREAD操作を追加
## Overview Backlog MCP Server の取り込み元を v0.18.0 から v0.20.4 に更新し、miku-backlog-api のバージョンを 0.8.0 にしました。 ## Changes - `backlog-mcp-server`、`backlog-js`、Zod を上流 v0.20.4 に対応する版へ更新し、Zod 4 の draft-07 入力スキーマ変換へ切り替えました。 - 操作名を `addDocument` から `add_document` に変更し、上流で廃止された `delete_project` を削除、新しい `add_category` を追加しました。 - Backlog に検索条件が無視されていた list 型カスタムフィールドの検索パラメーターを修正しました。 - 変更内容、互換性の変更、上流との対応関係を文書化し、新規・変更操作の差分テストを追加しました。テスト69件、型チェック、CLI スモーク確認が成功しています。
Backlog MCP upstream を v0.20.4 に更新
## Overview プロジェクト削除を本製品の対応操作に含めない方針を明確にしました。 ## Changes - README に、Backlog REST API がプロジェクト削除をサポートしていても、本製品ではこの破壊的な操作を提供しないことを記載しました。 - 開発方針にも同じ制約を追記しました。
プロジェクト削除を提供しない安全方針を明確化
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
devel の開発成果を main に反映