feat(tools): 台帳への行追加を支援する add_row.py を追加

[mhaya]

概要 (Summary)

台帳（API インベントリ）に行を追加する作業を支援するツールを追加します。ツールとドキュメントのみで、アプリケーションコードへの変更はありません。

reconcile.py が「インベントリ未収載」を検出しても、57列を手で並べる必要があり実務的ではありませんでした。add_row.py は api_snapshot.json（実機 url_map）と git から機械的に決まる列を埋め、調査が要る列に TODO を入れた雛形を出力します。

変更タイプ (Type of Change)

• 🚀 新機能追加 (Feature) — 開発基盤
• 📚 仕様書・マニュアル・APIリストの更新 (Documentation)

使い方

export WEKO_API_INVENTORY_DIR=/path/to/weko-secret

# 雛形を確認（まだ書き込まない）
python3 tools/api-inventory/scripts/add_row.py --endpoint api:weko_admin.foo
python3 tools/api-inventory/scripts/add_row.py --uri /api/items/import-task

# 追記する
python3 tools/api-inventory/scripts/add_row.py --endpoint api:weko_admin.foo --append

自動で埋まる列 / 埋めない列

	列
自動（27列）	no / module / api_type / app / method / uri / path_params / blueprint / endpoint / impl_func / impl_file / impl_line / auth_required / auth_method / auth_mechanism / api_version / last_commit系4列 ほか
TODO（31列）	summary / response / status_codes / roles / data_op / data_target / data_store / side_effects / config_deps / test_file / notes / sec_* / dynamic_verified / csrf_protection ほか

TODO はソースを読まないと書けない列です。Phase 2（静的解析）と Phase 3（実機実測）でやっていることを、その1行について行います。

派生列（priority / test_* / cleanup）は空のままでよく、後続の test_coverage.py → prioritize.py が付与します。

ドキュメント

scripts/README.md の「台帳の更新手順」ケース2を、この手順に沿って具体化しました。あわせて次を明記しています。

• ケース2b（既存行の修正）を分離し、派生列は手編集しても次の実行で消えること
• TODO を残したままにすると prioritize.py の入力が欠け、誤った優先度が付くこと（例: data_op が TODO だと破壊系の判定に入らない）

動作検証

$ add_row.py --endpoint api:weko_admin.get_curr_api_cert
  自動で埋まる列: 27  /  TODO(要調査): 31

$ add_row.py --uri /records/replace_file
  no=927 / module=weko-records-ui / api_type=画面ビュー / app=UIアプリ / method=POST

--uri は API アプリのルールが url_map 上 /api を含まない（DispatcherMiddleware でマウントされるため）点を考慮し、前置してから比較しています。

注意

台帳そのものは public な本リポジトリに含まれていません。このツールは WEKO_API_INVENTORY_DIR が指す秘密の場所の台帳を読み書きします（未設定なら理由を添えて中断します）。

[github-actions]

API インベントリ差分（件数のみ）

明細は公開できないため件数のみ表示しています。該当箇所は秘密側の台帳・レポートで確認してください。

ベースラインとの差分

API インベントリ差分レポート

• 旧: d2fdc0e3b v2.0.3 (profile=default) endpoints=860 (外部ライブラリ由来 291)
• 新: 3a2f84da1 v2.0.3-16-g3a2f84da1 (profile=default) endpoints=860 (外部ライブラリ由来 291)

判定: ✅ PASS (FAIL 0 / WARN 1)

サマリ

分類	件数
ADDED	0
REMOVED	0
RULE_CHANGED	0
METHODS_CHANGED	0
AUTH_CHANGED	0
IMPL_CHANGED	0
ATTRS_UNKNOWN_NEW	0
ModelView 追加	0
ModelView 削除	0
ModelView フラグ変化	0
config 変化	0
コメントアウト認証の増加	0
依存パッケージの版変化	3

[WARN] W6 依存パッケージの版が変化した — 3件

• pbr — 7.0.3 -> 7.1.1
• pyld — 3.1.0 -> 3.2.0
• weko-redis — 0.1.0.dev20170000 -> (削除)

---

台帳との突き合わせ

スナップショット ↔ インベントリ 突き合わせ

• リビジョン: 3a2f84da1 v2.0.3-16-g3a2f84da1 経路URI=870
• 台帳: 行=926 URI=881

件数のみ。詳細は秘密側の完全版レポートを参照。

判定: ✅ 一致 (0件)

検出	件数
A. インベントリ未収載(抽出漏れ)	0
B. 実機に無い(未説明)	0
B'. 実機に無い(既知・許容)	11
C. メソッド不一致	0
D. app列の不一致	0

[github-actions]

API インベントリ差分（件数のみ）

明細は公開できないため件数のみ表示しています。該当箇所は秘密側の台帳・レポートで確認してください。

ベースラインとの差分

API インベントリ差分レポート

• 旧: d2fdc0e3b v2.0.3 (profile=default) endpoints=860 (外部ライブラリ由来 291)
• 新: f9ab71ebc v2.0.3-17-gf9ab71ebc (profile=default) endpoints=860 (外部ライブラリ由来 291)

判定: ✅ PASS (FAIL 0 / WARN 1)

サマリ

分類	件数
ADDED	0
REMOVED	0
RULE_CHANGED	0
METHODS_CHANGED	0
AUTH_CHANGED	0
IMPL_CHANGED	0
ATTRS_UNKNOWN_NEW	0
ModelView 追加	0
ModelView 削除	0
ModelView フラグ変化	0
config 変化	0
コメントアウト認証の増加	0
依存パッケージの版変化	3

[WARN] W6 依存パッケージの版が変化した — 3件

• pbr — 7.0.3 -> 7.1.1
• pyld — 3.1.0 -> 3.2.0
• weko-redis — 0.1.0.dev20170000 -> (削除)

---

台帳との突き合わせ

スナップショット ↔ インベントリ 突き合わせ

• リビジョン: f9ab71ebc v2.0.3-17-gf9ab71ebc 経路URI=870
• 台帳: 行=926 URI=881

件数のみ。詳細は秘密側の完全版レポートを参照。

判定: ✅ 一致 (0件)

検出	件数
A. インベントリ未収載(抽出漏れ)	0
B. 実機に無い(未説明)	0
B'. 実機に無い(既知・許容)	11
C. メソッド不一致	0
D. app列の不一致	0