[jeonsworld]

배포 후 일반 사용자가 API 키 위치와 호출 방법을 다시 물어야 하던 흐름을 개선합니다. 배포 결과에 배포 버전 열기·프로젝트 API 키 확인 링크, 키 입력 순서와 기본 cURL을 안내하고 새 대화에서도 같은 정보를 조회하도록 연결합니다.

• ennoia-publish의 진입 설명과 reference에 기존 배포 API·키 확인·cURL 안내를 추가합니다.
• 새 usage 응답과 읽기 도구를 우선 사용하고 구 서버에서는 확인된 endpoint·대상·Studio 경로만 활용합니다. 키 확인을 위해 재배포하거나 미지원 예제를 추측하지 않습니다.
• 고정 버전·실제 프로젝트·환경을 보존하며 중지·미배포·개인 연결 미확인·승인 대기·안내 생성 실패를 구분합니다.
• 실제 MCP 등록 schema에서 15개 도구의 계약 fixture와 78개 inventory를 갱신하고 입력·출력 계약 사례를 94개로 확장합니다.
• Plugin payload를 1.5.5로 준비하고 host manifest·uploader version을 동기화합니다. 실제 release 발행은 수행하지 않았습니다.

검증: Python unittest 63개, Node uploader 36개, manifest sync·package validation·94개 schema 사례 통과. 별도 평가자가 생성한 합성 UX 답변 12개를 작성자가 rubric으로 판정해 모두 충족했습니다. 이는 native host 설치·Skill 로딩·운영 API 실행 검증과 별개입니다. 독립 코드 리뷰의 중요 지적은 없고 discovery 설명 보강도 반영했습니다.

적용 순서는 Orchestrator → MCP 서버 → Plugin입니다. 새 조회가 없는 연결에서도 기존 응답에 근거한 링크 안내를 유지합니다.

연동 PR: https://github.com/wanteddev/llm-orchestrator/pull/1150 (dev), https://github.com/wanteddev/llm-orchestrator/pull/1151 (main), https://github.com/wanteddev/ennoia-mcp-server/pull/254 (dev)

관련: wanteddev/ennoia-mcp-server#253

Summary by CodeRabbit

• 새 기능

  • 배포 후 API 사용 안내를 제공하며, 기존 배포에 대해서도 API 사용법과 키 확인 정보를 조회할 수 있습니다.
  • 확인된 링크와 호출 예제를 안내하고, 실행 여부와 개인 서비스 인증·승인 상태를 구분해 표시합니다.
  • API 키는 환경변수로 참조하며, 키 확인을 위해 재배포하지 않습니다.

• 문서

  • 배포 사용 안내와 관련 평가 기준 및 시나리오를 보강했습니다.
  • 플러그인 버전이 1.5.5로 업데이트되었습니다.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-27T11:18:05.580677Z	250d900	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

배포 도구와 사용량 조회 도구의 계약 픽스처를 추가했습니다. 배포 후 사용 안내 규칙과 합성 평가 자료를 보강했으며, 관련 플러그인 버전을 1.5.5로 갱신했습니다.

Changes

배포 사용 안내

Layer / File(s)	Summary
도구 계약 및 검증 사례 tests/fixtures/ennoia-tool-contracts.json, tests/fixtures/ennoia-contract-cases.json, tests/fixtures/ennoia-tools.json	배포, 배포 에이전트 호출, 사용량 조회 도구의 계약과 입력·출력 사례를 추가했습니다. 사용량 출력에 API 키가 포함되거나 실행 검증이 완료된 것으로 표시되는 무효 사례도 추가했습니다.
배포 사용 안내 지침과 버전 갱신 plugins/ennoia/skills/ennoia-publish/*, plugins/ennoia/references/response-guide.md, README.md, .claude-plugin/marketplace.json, plugins/ennoia/plugin.json, plugins/ennoia/.claude-plugin/plugin.json, plugins/ennoia/.codex-plugin/plugin.json, plugins/ennoia/mcp/file-uploader.mjs	배포 결과에 사용 정보가 있으면 이를 활용하고, 없으면 확인된 도구와 대상 정보를 사용하도록 지침을 추가했습니다. 키 원문 노출, 확인되지 않은 계약 추정, 안내를 위한 재배포를 금지합니다. 플러그인 및 서버 버전을 1.5.5로 갱신했습니다.
합성 평가 시나리오와 결과 evals/deployment-usage-scenarios.json, evals/deployment-usage-rubric.md, evals/README.md, evals/2026-10-27-deployment-usage-summary.md	배포 후 안내와 재조회에 관한 시나리오 및 평가 기준을 추가했습니다. 평가 기록은 합성 평가가 실제 API 호출이나 운영 환경을 검증하지 않았다고 명시합니다.

Priority: Not assessed

Estimated code review effort: 3 (Moderate) | ~20 minutes

Change: Feature

Possibly related issues

• wanteddev/ennoia-mcp-server#253: 해당 이슈는 배포 완료 안내에 API 사용 예제와 프로젝트 API 키 확인 링크를 요청합니다. 이 PR은 플러그인 안내에 해당 링크와 cURL 예제를 추가합니다. MCP 측 조회 흐름과 운영 검증까지 포함하는 변경은 아닙니다.

Possibly related PRs

• wanteddev/ennoia-plugin#22: 이 PR은 개인 서비스 연결과 승인 대기 상태를 배포 사용 안내에서 구분합니다. 후보 PR은 개인 OAuth 연결의 승인 대기와 완료 판정을 정의합니다.
• wanteddev/ennoia-plugin#23: 이 PR은 도구 계약 스냅샷의 revision을 갱신하고 저장 draft 도구 메타데이터를 조정한 뒤 배포 도구 계약을 추가합니다. 후보 PR의 저장 draft 도구 계약이 관련 스냅샷에 포함되어 있습니다.

Merge Risk: Low · up to 250d9

This PR adds post-deployment API and key guidance for the Ennoia plugin and prepares version 1.5.5. Nothing found blocks merging. Before or soon after merge, add a key-only path to the usage guidance so users without a known agent can still reach the project key link, and add the missing provenance details to the eval summary.

Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}