LLL Agent Draft Review / エージェント下書きレビュー

FAQ

Does the agent change my content? / エージェントが記事を変えますか。 No. The tool only records a proposal inside the plugin. Content, status and the published page stay as they are until an editor applies the title in the editor and saves. / いいえ。提案はプラグイン内に記録されるだけで、編集者が編集画面で反映し保存するまで記事も公開ページも変わりません。

Why not apply the title automatically? / なぜ自動で下書きに入れないのですか。 EmDash 1.5.0 offers no way to say "update only if the entry is still at this revision" to a plugin, and the revision-checked calls need the publish permission. Applying automatically would risk overwriting a concurrent edit, so this version hands the title to the editor, whose own save is revision-checked. Automatic staging is pending a host feature. / EmDash 1.5.0 のプラグイン向け更新には「この版のままなら更新」を指定する手段がなく、版つき操作は公開権限が要ります。同時編集を上書きしかねないため、この版は編集画面に渡し、編集者の保存（版チェックあり）で確定させます。自動の下書き適用はホストの対応待ちです。

Which fields? / 対象項目は。 Only title, on existing entries. Slug, status, body, publish, delete and revision values are rejected. / 既存記事の title のみ。スラッグ・状態・本文・公開・削除・版の指定は受け付けません。

Limits / 上限 50 proposals in the queue, titles up to 200 characters, one open proposal per entry, up to 10 allowed collections. / キュー50件、題名200文字、記事ごとに未処理1件、許可コレクション10件まで。

Security and privacy

Support and vulnerability reports: contact@lx3.cafe.

• Permissions: read content, read collection schema, read and patch the unsaved editor draft for one text field. No write, publish or delete permission and no network access. / 記事の読み取り、コレクション構造の読み取り、編集中の下書きの1項目の読み取りと差し替えだけ。書き込み・公開・削除の権限と外部通信はありません。
• Editors and admins can propose, review and apply titles. An admin enables the MCP tool and sets allowed collections. Use the single-plugin scope mcp:tools:r_ulaqlq25xnlfq7sy for Registry installs. / 提案・レビュー・反映は編集者以上。管理者がMCPツールを有効にし、許可コレクションを設定します。Registry版の専用スコープは mcp:tools:r_ulaqlq25xnlfq7sy です。
• The proposer identity comes from the host session or token, never from the request body. / 提案者はリクエストの内容でなくホストが確認した利用者です。
• Inputs are strictly validated and bounded; unknown keys (status, publish, delete, revision values) are refused. / 入力は厳密に検証し、未知のキーは拒否します。
• Proposals are stored in plugin storage: collection, entry ID, before and after title, proposer and approver user IDs, status and times. No email addresses, tokens or request logs are stored. / 保存するのは提案の内容と利用者ID・状態・時刻のみです。メール・トークン・リクエストログは保存しません。
• Approval is compare-and-set on one versioned record, so two editors approving at once cannot both win and a replay changes nothing. Before approval and again before hand-off the entry must be unchanged since the proposal; otherwise the proposal is marked stale. / 承認は版つき単一レコードの比較更新で、同時承認や再送は1回しか効きません。承認時と反映時に記事が提案時から変わっていれば失効にします。
• Known limit: the entry check and the editor's save are separate steps; the editor's own save is the final revision check. / 既知の限界：記事の確認と編集者の保存は別の手順で、最終の版チェックは編集者の保存が担います。

Changelog

0.1.0

• First release: title proposals from your own MCP client, editor review queue with before/after, one-time approval, hand-off into the editor draft for posts and pages. Automatic staging of the draft is not included (pending host support for revision-checked updates).

Installation / 導入

1. In EmDash admin, open Registry, search for LLL Agent Draft Review, and review and accept the install permissions.
2. In Plugins, open the plugin settings. Enter allowed collection slugs, such as posts,pages (up to 10). Each collection needs revisions and a text field called title. A blank list disables proposals.
3. In Plugins, expand the plugin and enable Agent access.
4. Under Settings → API Tokens → Plugin MCP Tools, an admin can create a token with only this plugin selected. An editor using OAuth should request mcp:tools:r_ulaqlq25xnlfq7sy.
5. Connect the client to your site's /_emdash/api/mcp and find the tool ending in __propose_title_change.

Approve in Agent Draft Review. In Posts or Pages, use the editor's Agent Draft Review panel to review and apply the title, then select Save draft. For other collections, copy the approved title to the editor.

1. 管理画面の Registry で LLL Agent Draft Review を検索し、権限を確認して導入します。
2. Plugins でこのプラグインの設定を開き、許可するコレクションを posts,pages のように指定します（最大10件）。リビジョンと文字列項目 title が必要です。空欄では提案を受け付けません。
3. Plugins で詳細を開き、Agent access を有効にします。
4. 管理者は Settings → API Tokens → Plugin MCP Tools でこのプラグインだけを選んでトークンを作ります。編集者がOAuthで接続する場合は mcp:tools:r_ulaqlq25xnlfq7sy を要求します。
5. クライアントをサイトの /_emdash/api/mcp に接続し、末尾が __propose_title_change のツールを使います。

Agent Draft Review で承認します。投稿・固定ページでは編集画面の Agent Draft Review パネルで題名を確認・反映し、Save draft で保存します。他のコレクションでは承認済みの題名を編集画面にコピーします。