LearnNewsExamplesServices
Frontmatter
titlefeat: added github cli setup verification script (Fixes #7381)
authorLemonDrop847
stateMerged
createdAtOct 5, 2025, 6:34 PM
updatedAtOct 5, 2025, 8:25 PM
closedAtOct 5, 2025, 8:08 PM
mergedAtOct 5, 2025, 8:08 PM
branchesdevfeat/github-cli-verify-script
urlhttps://github.com/neomjs/neo/pull/7382
Merged
LemonDrop847
LemonDrop847 commented on Oct 5, 2025, 6:34 PM

…json

Please make sure to read the Contributing Guidelines:

https://github.com/neomjs/neo/blob/dev/CONTRIBUTING.md

fix for #7381. created a github cli verification script, checks for github cli installation, provides os specific reference to install if not present and verifies login. updated package.json so can be run easily using npm run ai:verify-gh-setup What kind of change does this PR introduce? (check at least one)

  • Bugfix
  • Feature
  • Code style update
  • Refactor
  • Build-related changes
  • Other, please describe:

Does this PR introduce a breaking change? (check one)

  • Yes
  • No

If yes, please describe the impact and migration path for existing applications:

The PR fulfills these requirements:

  • It's submitted to the dev branch, not the main branch
  • When resolving a specific issue, it's referenced in the PR's title (e.g. fix #xxx[,#xxx], where "xxx" is the issue number)

If adding a new feature, the PR's description includes:

  • A convincing reason for adding this feature (to avoid wasting your time, it's best to open a suggestion issue first and wait for approval before working on it)
LemonDrop847
LemonDrop847 commented on Oct 5, 2025, 6:34 PM

requesting a review @tobiu


tobiu
tobiu commented on Oct 5, 2025, 8:09 PM

that was fast. thx again! being curious: how is your experience with the ai native workflows so far?

input from gemini:

✦ I have reviewed the pull request.

PR Summary

This pull request introduces a new script, buildScripts/ai/verifyGhSetup.mjs, and adds it to package.json as ai:verify-gh-setup. The script is designed to be run by contributors to ensure their environment is correctly configured for our GitHub CLI-based workflows.

The script performs three key checks:

  1. Installation: It verifies that the gh command is installed and provides OS-specific installation instructions if it's missing (including for Windows).
  2. Authentication: It runs gh auth status to ensure the user is logged into GitHub.
  3. Versioning: It checks the installed gh version against a minimum requirement to ensure compatibility.

Analysis

  • Ticket Fulfillment: This PR perfectly and completely fulfills all acceptance criteria for the ticket ticket-create-robust-gh-setup-script.md. It addresses all the robustness concerns (authentication, Windows support, versioning) that were raised previously.
  • Code Quality: The code is clean, well-structured into logical functions, and uses modern JavaScript. The error messages are clear and provide actionable guidance for the user, which is crucial for a setup script.
  • Dependencies: This is a foundational ticket from Phase 1 and has no blockers. Merging it will unblock other contributors who need to work on tasks requiring an authenticated gh environment.

Recommendation

Accept the PR.

This is an excellent contribution that provides a solid foundation for the rest of the epic. It's a well-written and robust script that directly addresses a critical need in our workflow.


LemonDrop847
LemonDrop847 commented on Oct 5, 2025, 8:15 PM

Good, tbh well tried out a little bit so far, but works well.


tobiu
tobiu commented on Oct 5, 2025, 8:23 PM

Well, so far this is "just" infrastructure work, but super important. The real fun starts when working with Gemini directly on the framework itself. What I am looking forward to is letting gemini explore the current memory core, and based on it make recommendations for new work items. However, since we are still changing the workflows a lot, it might be confusing for ai.

My recommendation for you: what already works is letting gemini explore the "ai knowledge db" and find new work items (epics / tickets) based on it. Feel free to try it out, and I can flag all new items for hacktoberfest.


LemonDrop847
LemonDrop847 commented on Oct 5, 2025, 8:25 PM

Sure, will give it a go then