Skip to content

chore(docs): remove VOLUME_STORAGE_PATH, fix stale refs, expand REST examples#88

Merged
nanotaboada merged 1 commit into
masterfrom
chore/cleanup-stale-entrypoint-docs-and-rest
Apr 10, 2026
Merged

chore(docs): remove VOLUME_STORAGE_PATH, fix stale refs, expand REST examples#88
nanotaboada merged 1 commit into
masterfrom
chore/cleanup-stale-entrypoint-docs-and-rest

Conversation

@nanotaboada

@nanotaboada nanotaboada commented Apr 10, 2026

Copy link
Copy Markdown
Owner

Summary

  • Removes the redundant VOLUME_STORAGE_PATH local variable from entrypoint.sh — it was an unreachable fallback alias for $STORAGE_PATH, which is always set via the Dockerfile ENV directive
  • Fixes stale references: README.md env var default clarified (container vs. local dev), Swagger UI access endpoint added, copilot-instructions.md version updated from Rocket 0.5 to Rocket 0.5.1
  • Expands rest/players.rest with existing / nonexistent / unknown naming convention, additional variables, all missing 404/409 cases, and ordering comments where sequential execution is required

Test plan

  • Verify entrypoint.sh works correctly in container (docker compose up)
  • Verify all REST requests in rest/players.rest return the documented status codes when run top-to-bottom

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Updated framework version reference and added Swagger UI access info; clarified STORAGE_PATH default and container/local guidance.
  • Tests

    • Expanded API test scenarios for player operations to cover existing, nonexistent, duplicate and unknown identifier cases.

@coderabbitai

coderabbitai Bot commented Apr 10, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@nanotaboada has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 4 minutes and 58 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 4 minutes and 58 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, 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 have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e8e4bc38-07f3-478d-ae3e-40a8262c4664

📥 Commits

Reviewing files that changed from the base of the PR and between 08d9454 and 7ed1f0a.

📒 Files selected for processing (4)
  • .github/copilot-instructions.md
  • README.md
  • rest/players.rest
  • scripts/entrypoint.sh

Walkthrough

Updated AI instruction doc to Rocket 0.5.1, added Swagger UI reference and clarified STORAGE_PATH in README, expanded REST client test scenarios for players/squad number success and error cases, and simplified the entrypoint script to use STORAGE_PATH directly (removed VOLUME_STORAGE_PATH).

Changes

Cohort / File(s) Summary
Documentation & AI Configuration
\.github/copilot-instructions.md, README.md
Bumped Rocket version to 0.5.1 in AI instructions; added Swagger UI endpoint to README; changed STORAGE_PATH docs from ./storage/players-sqlite3.db to /storage/players-sqlite3.db and expanded explanatory comments for container vs local-dev defaults.
REST Test Client
rest/players.rest
Expanded and restructured test requests: introduced explicit ID/squad variables for existing/nonexistent/unknown cases; added duplicate-squad create expecting 409; parameterized GET/PUT/DELETE requests covering 200/204/404/409 scenarios.
Entrypoint Script
scripts/entrypoint.sh
Removed VOLUME_STORAGE_PATH variable and updated directory/file checks and log messages to operate on "$STORAGE_PATH" directly while preserving existing start-vs-first-run logic.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • #58 — Overlaps container/runtime and REST test changes (scripts/entrypoint.sh, rest/players.rest, README.md) with similar STORAGE_PATH adjustments.
  • #81 — Related changes to SQLite storage handling and repository ignore rules for /storage.
  • #55 — Documentation and STORAGE_PATH updates in README and supporting scripts that mirror this PR's storage path adjustments.
🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title follows Conventional Commits format (chore:), is under 80 characters (77), and accurately describes the main changes: removing VOLUME_STORAGE_PATH, fixing stale references, and expanding REST examples.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/cleanup-stale-entrypoint-docs-and-rest
  • 🛠️ sync documentation: Commit on current branch
  • 🛠️ sync documentation: Create PR
  • 🛠️ enforce http error handling: Commit on current branch
  • 🛠️ enforce http error handling: Create PR
  • 🛠️ idiomatic review: Commit on current branch
  • 🛠️ idiomatic review: Create PR
  • 🛠️ verify api contract: Commit on current branch
  • 🛠️ verify api contract: Create PR

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 and usage tips.

@nanotaboada
nanotaboada force-pushed the chore/cleanup-stale-entrypoint-docs-and-rest branch from 11af501 to 08d9454 Compare April 10, 2026 01:37
@nanotaboada nanotaboada changed the title chore(docs): remove redundant VOLUME_STORAGE_PATH, fix stale refs, expand REST examples chore(docs): remove VOLUME_STORAGE_PATH, fix stale refs, expand REST examples Apr 10, 2026

@coderabbitai coderabbitai 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.

Actionable comments posted: 1

🧹 Nitpick comments (1)
rest/players.rest (1)

35-36: Optional DRY cleanup: use declared variables inside JSON bodies.

You already define @newSquadNumber / @existingSquadNumber; reusing them in payloads would reduce drift risk when these test values change.

♻️ Example refactor
-  "squadNumber": 27,
+  "squadNumber": {{newSquadNumber}},
...
-  "squadNumber": 23,
+  "squadNumber": {{existingSquadNumber}},

Also applies to: 56-57, 120-121, 140-141, 160-161

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@rest/players.rest` around lines 35 - 36, Replace hard-coded squadNumber
literals in the JSON request bodies with the already-declared test variables
(`@newSquadNumber` and `@existingSquadNumber`); specifically update the payloads
that currently contain "squadNumber": 27 (and similar occurrences) to reference
the appropriate variable so the create/update test bodies use `@newSquadNumber` or
`@existingSquadNumber` instead of magic numbers, reducing drift when test values
change.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@scripts/entrypoint.sh`:
- Around line 12-14: Add a POSIX-safe default for STORAGE_PATH so the entrypoint
and Rust app use the same fallback: before the mkdir -p "$(dirname
"$STORAGE_PATH")" and the if [ ! -f "$STORAGE_PATH" ] checks, set STORAGE_PATH
to a default (for example storage/players-sqlite3.db) when empty using POSIX
parameter expansion (e.g.,
STORAGE_PATH="${STORAGE_PATH:-storage/players-sqlite3.db}"), or apply the same
expansion inline in the existing commands to ensure both mkdir -p "$(dirname
"$STORAGE_PATH")" and the file existence test use the fallback value.

---

Nitpick comments:
In `@rest/players.rest`:
- Around line 35-36: Replace hard-coded squadNumber literals in the JSON request
bodies with the already-declared test variables (`@newSquadNumber` and
`@existingSquadNumber`); specifically update the payloads that currently contain
"squadNumber": 27 (and similar occurrences) to reference the appropriate
variable so the create/update test bodies use `@newSquadNumber` or
`@existingSquadNumber` instead of magic numbers, reducing drift when test values
change.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 68b12ed0-0524-4213-be0c-f4eb2d0e9b88

📥 Commits

Reviewing files that changed from the base of the PR and between d39058f and 11af501.

📒 Files selected for processing (4)
  • .github/copilot-instructions.md
  • README.md
  • rest/players.rest
  • scripts/entrypoint.sh

Comment thread scripts/entrypoint.sh
@codecov

codecov Bot commented Apr 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.33%. Comparing base (d39058f) to head (7ed1f0a).
⚠️ Report is 2 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master      #88   +/-   ##
=======================================
  Coverage   84.33%   84.33%           
=======================================
  Files           6        6           
  Lines         166      166           
=======================================
  Hits          140      140           
  Misses         26       26           

☔ View full report in Codecov by Sentry.
📢 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.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

…examples

- Remove redundant VOLUME_STORAGE_PATH alias in entrypoint.sh; use $STORAGE_PATH
  directly with a POSIX-safe fallback matching the Rust app's own default
- Clarify STORAGE_PATH defaults in README (container vs. local dev)
- Add Swagger UI access endpoint to README
- Update Rocket version from 0.5 to 0.5.1 in copilot-instructions.md
- Expand rest/players.rest with existing/nonexistent/unknown naming convention,
  missing 404/409 cases, ordering comments, and variable-driven request bodies

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
@nanotaboada
nanotaboada force-pushed the chore/cleanup-stale-entrypoint-docs-and-rest branch from e4c25e1 to 7ed1f0a Compare April 10, 2026 01:58
@nanotaboada
nanotaboada merged commit 0b33653 into master Apr 10, 2026
10 checks passed
@nanotaboada
nanotaboada deleted the chore/cleanup-stale-entrypoint-docs-and-rest branch April 10, 2026 02:06
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