Skip to content

fix(scripts): put the shebang on line 1 of nqc/nqc-launcher.sh - #79

Merged
hyperpolymath merged 1 commit into
mainfrom
fix/shebang-on-line-1
Aug 27, 2026
Merged

fix(scripts): put the shebang on line 1 of nqc/nqc-launcher.sh#79
hyperpolymath merged 1 commit into
mainfrom
fix/shebang-on-line-1

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

The shebang was not the first line, so the kernel never honoured it — the script ran under whatever shell invoked it rather than the one it declares. shellcheck reports this as SC1128.

Found by an estate-wide sweep of 5,111 tracked scripts across 375 repos: 20 files carry this defect, 19 of them a generated *-launcher.sh.

Source not identified. The generator standards/docs/UX-standards/comprehensive-launcher-template.sh is clean — its own line 1 is the shebang and it reports 0 shellcheck errors. The stray line is introduced when the launcher is copied into each repo, by something not yet found, so this may recur until that is tracked down.

Other lines are preserved in order; only the shebang moves.

The shebang was not the first line, so the kernel never honoured it — the
script ran under whatever shell invoked it rather than the one it declares.
shellcheck reports this as SC1128.

Found by an estate-wide sweep of 5,111 tracked scripts across 375 repos: 20
files carry this defect, 19 of them a generated *-launcher.sh.

⚠ Source not identified. The generator,
standards/docs/UX-standards/comprehensive-launcher-template.sh, is CLEAN — its
own line 1 is the shebang and it reports 0 shellcheck errors. The stray line is
therefore introduced when the launcher is copied into each repo, by something
not yet found, so this may recur until that is tracked down.

Other lines are preserved in order; only the shebang moves.
@coderabbitai

coderabbitai Bot commented Aug 26, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 28b73b1f-ed9d-4aff-99ba-5c1e53c0cb87

📥 Commits

Reviewing files that changed from the base of the PR and between 32b15ff and cd2d6db.

📒 Files selected for processing (1)
  • nqc/nqc-launcher.sh
💤 Files with no reviewable changes (1)
  • nqc/nqc-launcher.sh

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

📜 Recent review details
⏰ Context from checks skipped due to timeout. (2)
  • GitHub Check: Codacy Static Code Analysis
  • GitHub Check: Gitar

📝 Walkthrough

Summary by CodeRabbit

  • Chores
    • No user-facing changes were identified in this update.

Walkthrough

The supplied diff contains no observable code changes. It affects nqc/nqc-launcher.sh by one removed line.

Changes

Cohort / File(s) Summary
No observable changes
nqc/nqc-launcher.sh
One line was removed. No functional change is represented in the supplied diff.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to cd2d6

This is a localized shebang correction in one script, with no actionable merge-blocking risk remaining beyond normal checks and review.

Poem

A rabbit checks the launcher line
One line is gone, with no new sign
The script stays still beneath the moon
No altered paths, no changed tune
The burrow rests; the review ends soon

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description clearly explains that the shebang moves to line 1, resolves ShellCheck warning SC1128, and notes the unresolved source of the defect.
Title check ✅ Passed The title clearly and concisely describes the main change: moving the shebang to line 1 of nqc/nqc-launcher.sh.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch

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

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

@gitar-bot

gitar-bot Bot commented Aug 26, 2026

Copy link
Copy Markdown

Important

You are using the Gitar free plan. Upgrade to unlock code review, CI analysis, auto-apply, custom automations, and more.

Gitar

@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

Run reviewer

TIP This summary will be updated as you push new changes.

@codacy-production codacy-production Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR correctly relocates the shebang to the first line of nqc/nqc-launcher.sh, which is required for correct script execution and to resolve Shellcheck error SC1128. While the fix meets the technical requirement, it is applied to a file explicitly marked as auto-generated by launch-scaffolder.

Codacy indicates the PR is up to standards, but a high risk of regression exists because the root cause in the generator has not been addressed. Future regenerations of this file will likely overwrite this manual fix.

About this PR

  • The file nqc/nqc-launcher.sh contains a header stating it is generated by launch-scaffolder and should not be edited directly. This manual fix is a temporary solution that will be lost during the next code generation. Please investigate fixing the source template or configuration instead.

Test suggestions

  • Verify that nqc-launcher.sh starts with the shebang on line 1 via shellcheck or execution check.
Prompt proposal for missing tests
Consider implementing these tests if applicable:
1. Verify that nqc-launcher.sh starts with the shebang on line 1 via shellcheck or execution check.

TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback

Comment thread nqc/nqc-launcher.sh
@@ -1,4 +1,3 @@

#!/usr/bin/env bash

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚪ LOW RISK

Nitpick: This file contains a warning that it should not be edited directly as it is generated by launch-scaffolder. While moving the shebang to line 1 is necessary for the script's execution, this manual change will likely be overwritten during the next realignment.

Try running the following prompt in your IDE agent:

Investigate the launch-scaffolder template or the nqc.launcher.a2ml configuration to ensure the shebang is correctly placed on line 1 during code generation, rather than applying a manual fix to the output file.

@hyperpolymath
hyperpolymath merged commit 4ccec23 into main Aug 27, 2026
23 of 24 checks passed
@hyperpolymath
hyperpolymath deleted the fix/shebang-on-line-1 branch August 27, 2026 00:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant