開発者ドキュメント
公開申請·

公開申請(認定プラグイン)

開発者登録 → 名前空間 claim → niyase-plugin publish → 審査 → 公開 の流れ。

認定プラグインをマーケットプレイスで公開するまでの流れです。

STEP 1: 開発者登録

マーケットプレイスのマイページで開発者プロフィール(表示名・slug)を登録します。

STEP 2: 名前空間を claim

プラグイン ID の @scope 部分(名前空間)を claim します。 @your-org/tasks を申請するには @your-org を所有している必要があります。

STEP 3: 公開トークン(PAT)を発行

マイページで plugin.* スコープの Personal Access Token を発行します。 このトークンは開発者ポータル専用で、通常の API には使えません(資格が分離されています)。

スコープ用途
plugin.publish申請の作成・提出
plugin.read.statsインストール統計参照
plugin.manageプロフィール・名前空間管理

STEP 4: 申請

CLI でビルド・検証・申請までを一括で行います。

NIYASE_TOKEN=<your plugin.publish PAT> niyase-plugin publish
# ✓ built (sha256 …)
# ✓ manifest 検証 OK (@your-org/tasks)
# ✓ 申請を送信しました (state=SUBMITTED)

publish は内部で次を行います: ビルド → validateManifest() → 申請作成 → バンドルアップロード(sha256)→ 審査依頼。 --dry-run を付けると検証までで停止します(ネットワークに出ません)。

STEP 5: 審査 → 公開

申請は状態機械で進みます:

DRAFT → SUBMITTED → IN_REVIEW → { CHANGES_REQUESTED | APPROVED | REJECTED }
APPROVED → PUBLISHED

niyase スタッフがマニフェスト・バンドルを確認し、承認 → 公開でマーケットプレイスに掲載されます。 修正依頼の場合はコメント付きで差し戻され、修正して再提出できます。

公開後

  • バージョン更新は新しい申請として再審査
  • インストール数・申請状況はマイページのダッシュボードで確認
  • 整合性: 配布バンドルはアップロード時の sha256 と照合され、不一致なら配信されません