Skip to content

Split the Over-Length Sentences in the Secrets Shell Library Comments - #3581

Merged
ptr727 merged 5 commits into
developfrom
feature/3577-secrets-sh-sentence-length
Oct 28, 2026
Merged

ptr727 merged 5 commits into
developfrom
feature/3577-secrets-sh-sentence-length

Conversation

@ptr727

@ptr727 ptr727 commented Oct 28, 2026 •

Copy link
Copy Markdown
Owner

Splits the 23 over-length comment sentences in lib/sh/secrets.sh so the sentence-length check reads zero. Only comment text changed. No code, string, or behavior changed.

Files: lib/sh/secrets.sh.

Every split was compared with its original sentence for lost antecedents, dropped reasons, narrowed qualifiers, and added claims. Three strict review rounds found drifts, all fixed in later commits, and the latest pass on the final head reported no findings.

Part of #3531.
Resolves #3577 on promotion.

🤖 Generated with Claude Code

ptr727 and others added 2 commits October 28, 2026 16:13
The sentence-length check caps a sentence at 25 words, and 23 comment sentences in lib/sh/secrets.sh ran past it. Each is split without changing what it says, with comment text only and no code change.

Part of #3531.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reattach reasons and conditions the first split left on one half, and drop a widened claim and an added count.

Part of #3531.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ptr727 ptr727 added the comments Permits the comment lines the pull request adds or edits, which the prose gate otherwise refuses label Oct 28, 2026
Copilot AI lite review requested due to automatic review settings October 28, 2026 23:16
@coderabbitai

coderabbitai Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

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

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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

An active nit remains in lib/sh/secrets.sh at lines 16 and 78 because the placement of “thereby” creates an ambiguous causal link that should be corrected.

1 open issue
What changed in this PR

This pull request splits 23 over-length comments in lib/sh/secrets.sh into shorter sentences while preserving executable code, strings, and runtime behavior.

Changes:

  • Splits long comments covering secret handling, symlink resolution, and environment-file loading.
  • Preserves the existing shell implementation and behavior.
  • Retains two comment-wording findings regarding causal attribution and API-call subject clarity.
File Summary
lib/​sh/​secrets.sh Reviewed comment-only sentence splits throughout the secrets shell library. No executable code or behavior changed; two comment-wording findings remain, with 4 and 1 votes.

Review effort: Lite

Comment thread lib/sh/secrets.sh Resolved
@codecov

codecov Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.60%. Comparing base (b82a4a0) to head (d37da9a).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #3581   +/-   ##
========================================
  Coverage    81.60%   81.60%           
========================================
  Files           26       26           
  Lines         9070     9070           
========================================
  Hits          7402     7402           
  Misses        1668     1668           
Flag Coverage Δ
python-3.13 81.60% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

ptr727 and others added 2 commits October 28, 2026 16:26
Restore the second reason for reporting an unresolved link and reattach the shared-clause reason to the single composed sentence.

Part of #3531.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Restore the cause words and the second reason the split left implicit.

Part of #3531.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🔵 Needs a closer look

An active finding remains in lib/sh/secrets.sh because the rationale comment is a sentence fragment that violates the repository’s one-sentence-per-line rule.

No open issues 🎉

1 previously missed issue

In code that hasn't changed since last review

Low severity Rewrite rationale as a complete sentence

lib/​sh/​secrets.sh:74

[P2] Make the rationale line a complete sentence

Reported as unresolved rather than as a missing target. is a sentence fragment, so this split still violates the repository's one-sentence-per-line comment rule and leaves the subject of the report implicit. Rewrite it as a complete sentence.

This issue also appears on line 257 of the same file.

1 resolved since last review

Review effort: Lite

Copilot flagged two fragments the split left standing, so each now has an explicit subject.

Part of #3531.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ptr727

ptr727 commented Oct 28, 2026

Copy link
Copy Markdown
Owner Author

The two sentence fragments Copilot flagged (the lines starting "Reported as unresolved" and "A bash of its own") now have explicit subjects as of d37da9a, and the other flagged line 257 sentence is the same fix.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

No active review issues remain, and the changes are limited to comment wording without altering executable code or behavior.

No open issues 🎉

Review effort: Lite

@ptr727

ptr727 commented Oct 28, 2026

Copy link
Copy Markdown
Owner Author

Answering the Copilot finding raised on e827021, which opened no thread:

[P2] Make the rationale line a complete sentence. Reported as unresolved rather than as a missing target. is a sentence fragment, so this split still violates the repository's one-sentence-per-line comment rule and leaves the subject of the report implicit. Rewrite it as a complete sentence.

Fixed in d37da9a. That line and the matching fragment at line 257 now each name their subject. Copilot's round on d37da9a reports no open issue.

@ptr727
ptr727 merged commit eb5e6f6 into develop Oct 28, 2026
14 checks passed
@ptr727
ptr727 deleted the feature/3577-secrets-sh-sentence-length branch October 29, 2026 00:04
ptr727 added a commit that referenced this pull request Oct 29, 2026
… and the Secrets Shell Library (#3589)

## Summary

Promotes `develop` to `main`, carrying the sentence-length splits of the
skill sources and the secrets shell library:

- #3582: splits the over-length sentences in the git and worktree
skills.
- #3584: splits them in the local review, agent conduct, and
check-this-repo skills.
- #3581: splits them in the comments of `lib/sh/secrets.sh`.
- #3585: splits them in the release skills.
- #3583: splits them in the codestyle and guard skills.
- #3586: splits them in the comment and doc style skill.
- #3587: splits them in the repo procedure skills.

The skill changes include their generated copies.

Closes #3577

This is part of #3531, which stays open.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comments Permits the comment lines the pull request adds or edits, which the prose gate otherwise refuses

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants