@patchlogr/cli 패키지를 위한 diff 커맨드 추가

[toothlessdev]

📎 Related issues

• resolve Add diff command for Patchlogr CLI #29

📦 Scope

• @patchlogr/core
• @patchlogr/cli
• @patchlogr/oas
• @patchlogr/inspector
• @patchlogr/types
• docs, examples
• tests
• ci / cd / infra
• other (아래에 명시)

📌 Summary

• @patchlogr/core 에서 noEmit 으로 인해 d.ts 빌드 안되는 현상 수정
• diffCommand 구현 (preprocess -> partition -> diff)

⚠️ Impact

• No Breaking Changes
• Breaking Change
• Versioning 영향 있음 (major / minor / patch)
• 내부 리팩토링만 포함

✅ Checklist

• 요구사항 명세 충족
• 테스트 추가 / 수정
• deterministic output 확인

[gemini-code-assist]

Summary of Changes

Hello @toothlessdev, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 @patchlogr/cli에 OpenAPI 스펙 간의 차이점을 분석하는 diff 명령어를 추가하여 API 변경 사항을 쉽게 추적할 수 있도록 합니다. 또한, @patchlogr/core 패키지의 빌드 설정을 수정하여 타입 정의 파일이 올바르게 생성되도록 개선했습니다.

Highlights

• @patchlogr/core 빌드 수정: @patchlogr/core 패키지에서 noEmit 설정으로 인해 d.ts 파일이 빌드되지 않던 문제가 해결되었습니다.
• 새로운 diff 커맨드 추가: @patchlogr/cli에 OpenAPI 스펙을 전처리, 파티셔닝, 그리고 비교하는 기능을 포함하는 새로운 diff 커맨드가 구현되었습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• packages/patchlogr-cli/src/commands/canonicalize.ts
  • skipValidation 옵션의 기본값을 true로 명시적으로 설정했습니다.
• packages/patchlogr-cli/src/commands/diff.ts
  • 두 개의 OpenAPI 스펙 파일을 비교하고 변경 사항 및 버전 범프를 감지하는 새로운 diff 명령어를 추가했습니다.
  • 이 명령어는 tag 또는 method를 기준으로 스펙을 파티셔닝할 수 있으며, 결과를 콘솔 또는 파일로 출력합니다.
• packages/patchlogr-cli/src/createCLI.ts
  • patchlogr CLI에 새로 추가된 diff 명령어를 등록하여 사용할 수 있도록 했습니다.
• packages/patchlogr-core/tsconfig.json
  • noEmit 컴파일러 옵션을 false로 명시적으로 설정하여 TypeScript 선언 파일(d.ts)이 올바르게 생성되도록 수정했습니다.

Activity

• 현재까지 이 PR에 대한 특별한 활동(댓글, 검토 등)은 없습니다.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[github-actions]

Test Results

109 tests   109 ✅  2s ⏱️
 30 suites    0 💤
  3 files      0 ❌

Results for commit d330ae9.

♻️ This comment has been updated with latest results.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

Files with missing lines	Coverage Δ
...chlogr-adapter-oas/src/oas-v2/toCanonicalSchema.ts	84.21% <ø> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[gemini-code-assist]

Code Review

The pull request introduces a new diff command to the @patchlogr/cli package, allowing users to compare two OpenAPI Specification files. It also fixes an issue in @patchlogr/core where d.ts files were not being built due to noEmit being set to true. The new diff command preprocesses, partitions, and then diffs the OpenAPI specs, and can output the results to stdout or a file. The changes are well-structured and integrate smoothly with the existing CLI architecture.