attach-cli

attach-cli

メディアを attach Worker にアップロードし、公開 URL を返します。人間にはインストール済みの CLI を優先して使用し、JWT 登録を使用するのは GitHub App エージェントのみです。

CLI を必須とする（人間向け）

command -v attach || command -v gh
attach --help 2>/dev/null || gh attach --help 2>/dev/null || true

attach が見つからない場合は、処理を中断し、ユーザーに承認済みの方法 （brew install uinaf/tap/attach、npm i -g @uinaf/attach-cli、または gh extension install uinaf/gh-attach）でインストールするよう依頼してください。 このスキルからインストーラーをダウンロードしないでください。curl/fetch を使ったアップロード スクリプトを作成しないでください。gh attach … は同じバイナリとして扱い、gh auth は決して変更しないでください。

人間向けワークフロー

詳細：references/human.md。

ホストされている https://attach.uinaf.dev サービスには、公開 GitHub App クライアント ID がバンドルされているため、attach login に環境設定は不要です。カスタムの ATTACH_API_BASE を使用する場合は、デプロイ先独自の ATTACH_GITHUB_CLIENT_ID （GitHub App の設定）が必要です。このカスタム上書きがない場合に限り、処理を中断して依頼してください。

1. attach login
   • CLI が検証 URL とデバイスコードを出力したら、両方を対象のユーザーにすぐに伝え、 ユーザーが認証する間はログイン処理を実行したままにします。短時間のみ有効なコードは、ヘッドレス環境の制約を越えるために必要です。
2. attach put <file> [--repo owner/name] [--pr N]：デフォルトはプレビュー /p/…。 生データ用 /o/… には --url、埋め込みには --markdown、API 本文には --json を使用します。 --dry-run を追加すると、認証情報やネットワークリクエストなしでローカルに検証できます
3. attach delete <url-or-key> を実行し、その後 curl -sI <url> → 成功とする前に 404/410 を確認します
4. 認証情報の使用が終わったら attach logout

機械可読なコマンド仕様を確認するには attach help --json を使用します。構造化された結果とエラーが必要な場合は、コマンドに --json を追加します。削除対象を実行前に検証して正規化するには、 attach delete <url-or-key> --dry-run を使用します。

許可リストによる拒否またはログイン失敗が発生した場合は、阻害要因を報告して処理を中断してください。

エージェント向けワークフロー（GitHub App）

JWT クレーム、ヘッダーファイルを使った HTTP、シークレットの取り扱い： references/agent.md。Worker の AGENT_REGISTRY に App の公開鍵が必要です。App PEM はエージェントのシークレットストアに保管し（チャットには決して記載しないでください）。

1. JWT に署名します：iss=attach:<app_id>、aud = 公開ホスト、exp≤120s、新しい jti
2. ヘッダーファイルを介して Authorization を指定し、POST /v1/enroll/agent を実行します（argv には決して渡さないでください）。 JSON はプロセス内で解析し、token はメモリまたはシークレットストア内だけに保持します
3. 同じ方法で PUT /v1/objects を実行します。JSON に url と preview_url の両方が含まれる場合に限り成功とします
4. put が 401 になった場合：一度だけ再登録（新しい jti）して put を再実行します。それでも失敗した場合はハードフェイルします

厳守事項

• att_ キーのみでアップロードし、GitHub トークン／PAT／ghs_／インストールトークンは決して使用しないでください
• ログインのデバイスコードは、有効なログインフロー中に対象のユーザーにのみ伝えてください。 ログ、issue、コミット、PR、その他の公開または永続的な成果物には決して記載しないでください
• App PEM や att_ 値（登録 JSON を含む）を決して出力しないでください
• プレビュー URL を優先し、コンシューマーが埋め込みを必要とする場合に限り --markdown／生データの url を使用してください

put が URL を返したとき、削除済みであることを確認できたとき、またはインストール、カスタムクライアント ID、許可リスト、レジストリ、認証に関する問題で処理が妨げられたときは、そこで中断してください。結果の URL または正確な阻害要因を報告してください。