⚡ Bolt: 비동기 파일 읽기를 통한 CLI 탐색 성능 개선

[seonghobae]

💡 What: listUseCases, listActors, listStakeholders, listGoals 함수를 비동기로 전환하고 Promise.all과 fs.promises.readFile을 사용하여 파일을 병렬로 읽도록 변경했습니다. EMFILE (too many open files) 에러를 방지하기 위해 100개씩 청크 단위로 나누어 처리합니다. 또한 CLI의 runCommand 핸들러가 Promise 반환을 올바르게 처리할 수 있도록 업데이트했습니다.
🎯 Why: fs.readFileSync를 반복 호출하는 기존 방식은 대량의 사양(Specification) 파일이 존재하는 경우 Node.js 메인 스레드를 블로킹하여 심각한 성능 저하를 발생시킵니다.
📊 Impact: 많은 수의 파일이 존재할 때 파일 읽기 작업이 병렬로 수행되어 실행 시간이 크게 감소하며, 메인 스레드의 병목이 해소됩니다.
🔬 Measurement: vspec usecase list 명령을 다수의 명세 파일이 있는 프로젝트에서 실행하여 기존 속도와 비교해볼 수 있습니다.

---

PR created automatically by Jules for task 3903564935135711409 started by @seonghobae

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[coderabbitai]

Warning

Review limit reached

@seonghobae, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 47 minutes and 34 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0647c5eb-b380-40e3-946d-94c847880877

📥 Commits

Reviewing files that changed from the base of the PR and between f4223cb and a650f66.

📒 Files selected for processing (5)

• .jules/bolt.md
• src/cli.ts
• src/entity-commands.ts
• src/usecase-commands.ts
• tests/authoring.test.ts

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch bolt-async-file-reads-3903564935135711409

✨ Simplify code

• Create PR with simplified code
• Commit simplified code in branch bolt-async-file-reads-3903564935135711409

Warning

Billing warning: we have not been able to collect payment for this subscription for more than 72 hours. Please update the payment method or pay any pending invoices in Billing to avoid service interruption.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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