AgentReady Woo

AgentReady Woo — WooCommerce リリースゲート

注文、チェックアウト、決済認証情報に触れることなく、リリース後のエージェント向け WooCommerce サーフェスを検証します。

無料の公開事前チェックを実行するか、依存関係不要の Node 24 アクションをデプロイワークフローに追加してください。デフォルトでは、明示的な HOLD の場合にのみ CI を失敗させます。BLOCKED、UNMEASURED、UNREADABLE は判定保留としてそのまま表示されます。

- name: AgentReady Woo preflight
  uses: tytutueh13-sudo/agentready-woo@v1
  with:
    store-origin: https://shop.example

リリースチェックで得られるもの

• WooCommerce、robots、JSON-LD、MCP、UCP、ACP のサーフェスを対象とする、読み取り専用の公開事前チェック。
• 水増しされた準備スコアではなく、有限の判定結果と不明な理由の一覧。
• 署名付きの集約データのみを含む WordPress の証拠情報を利用する、任意のオーナー認証済みゲート。
• 注文の作成、在庫の確保、チェックアウトの変更、決済へのアクセスはありません。

稼働中のサービス：app.utilityhouse.xyz

AgentReady は受動的な公開事前チェックを実行し、その後、認証済みストアオーナーが署名付きプラグイン証拠情報に基づいて、バージョンを固定したリリース判定を行えるようにします。対象を読み取れない場合、作り上げた低スコアではなく、判定保留を返します。

これは認定でも、ランキングの保証でも、チェックアウトテストでもありません。ルートツールは注文を作成したり、在庫を確保したり、顧客にメールを送信したり、決済認証情報を扱ったりしません。

公開 MCP ツール

POST https://app.utilityhouse.xyz/mcp は MCP JSON-RPC 2.0 に対応し、5 つのツールを公開します。常に tools/list を正式なスキーマとして使用してください。

ツール	用途
scan_woo_store_readiness	一般的な公開ストアの監査、スコア、修正項目
preflight_woo_store	特定のアップデートやリリースに関するプロトコルファミリーの証拠情報

追加の 3 つのツールで、オーナー認証済みのリリースゲート実行を開始、読み取り、申請できます。スコープ付きベアラートークンと、確認済みのストア所有権が必要です。

一般スキャナーは、対象を読み取れない場合、score: null を伴う state: UNREADABLE を返します。実際の加盟店ストアに対する診断精度は未測定です。リリースゲートの確定処理は無効です。

GitHub アクション

このリポジトリには、依存関係不要の Node 24 アクションが含まれています。同じ公開事前チェックの契約を呼び出し、理由コード付きのジョブ概要を出力し、明示的な HOLD の場合にのみ失敗します。BLOCKED と UNMEASURED は判定保留のままです。

ワークフローで次の 4 つのプロトコルファミリーのみをチェックする場合は、families: woo,robots,jsonld,mcp を追加してください。

公開エンドポイントは、対象オリジンごとに 1 日 3 回、呼び出し元 IP ごとに 1 日 10 回まで利用できます。このアクションはストアに変更を加えません。

WordPress プラグイン

wordpress-plugin/utilityhouse-release-gate-for-woocommerce はバージョン 1.2.1 です。接続前に、実用的なローカル準備スナップショットを提供します。有効化しても UtilityHouse への接続やスケジュールの作成は行われません。管理者が一度だけ手動で送信するか、署名付き集約証拠情報を毎日送るスケジュールを別途オプトインする必要があります。

証拠情報のエンベロープには、バージョン識別子、不透明なストア／実行フィールド、タイムスタンプ、nonce、ファミリー名、集約チェック状態／件数が含まれます。顧客、注文、決済、メール、住所、商品説明、URL、認証情報、未加工ログのフィールドは含まれません。

次のコマンドで、決定論的なプラグインパッケージをビルドできます。

npm run build:plugin

実際のストアに触れることなく、バージョン固定の WordPress Playground デモでローカルのみのスナップショットをお試しください。この使い捨てサイトでは UtilityHouse のエンドポイントは設定されず、証拠情報も送信されません。

REST 事前チェック

POST https://app.utilityhouse.xyz/api/v2/preflight の仕様は mcp-registry/openapi-preflight.yaml に記載されています。HTTP 200 は、必ずしも対象を測定できたことを意味しません。返された state とファミリーごとのチェック結果を確認してください。

商取引専用の独立したサーフェス

認証済みアカウントは、読み取り専用の WooCommerce 認証情報をストアに紐付いたカタログ、オファー、署名付きカート引き継ぎのサーフェスに接続できます。サーフェスのパスは /mcp/{store_id} です。 これは独立した製品契約であり、Release Gate へのアクセス権は付与されません。 チェックアウトと決済は、引き続き販売者のストアで行われます。

開発

npm install
npm run typecheck
npm test
npm run test:wordpress

この公開リポジトリはレビュー用のミラーであり、本番環境へのデプロイ元ではありません。wrangler.toml にはプレースホルダーのデータベース ID が記載されています。デプロイはプライベートなモノレポから実行されます。

ライセンスの適用範囲

• action.yml および action/** は、action/LICENSE に記載された MIT ライセンスの適用対象です。
• wordpress-plugin/utilityhouse-release-gate-for-woocommerce/** は、プラグインヘッダーと readme.txt に記載された GPL-2.0-or-later の適用対象です。
• 残りのサーバー、テスト、デプロイ、ミラーの各ファイルについては、ファイルまたはサブツリーに明示的な記載がない限り、ライセンスは付与されません。これらのファイルの著作権はすべて留保されています。

適用範囲を定めたこれらのライセンスは、ホスト型の AgentReady サービス、そのデータ、商標、プライベートなデプロイ設定には適用されません。