Skip to content

Conversation

@pyramation
Copy link
Contributor

@pyramation pyramation commented Dec 27, 2025

fix: update README badge paths and rename streaming/ to uploads/

Summary

This PR fixes broken version badge URLs in README files across the monorepo and renames the streaming/ folder to uploads/ for better clarity about its purpose (file upload utilities for S3).

The badge URLs were pointing to incorrect folder paths (e.g., packages%2Fexplorer instead of graphql%2Fexplorer), causing the version badges to fail to load. All badge paths have been updated to reflect the actual folder structure.

Changes include:

  • Renamed streaming/ folder to uploads/ (10 packages)
  • Fixed badge paths in 23 README files across graphql/, postgres/, pgpm/, and uploads/ folders
  • Updated pnpm-workspace.yaml to reference uploads/*
  • Updated CI workflow to test packages from uploads/ instead of streaming/

Updates since last revision

Added a fix for flaky snapshot tests in pgpm/cli that were failing when boilerplate dependency versions changed (e.g., makage, pgsql-test):

  • Added normalizePackageJsonForSnapshot() helper in pgpm/cli/test-utils/cli.ts that replaces dependency versions with <VERSION> placeholder
  • Updated init.install.test.ts to use the normalizer while preserving versions for explicitly installed test packages (@pgpm-testing/base32, @pgpm-testing/utils)
  • Updated snapshots to use normalized versions

Review & Testing Checklist for Human

  • Verify CI passes - this validates both the folder rename and the snapshot test fixes
  • Review the normalizePackageJsonForSnapshot function logic - ensure it correctly handles all dependency fields and the preserveVersionsFor option
  • Verify the preserveVersionsFor arrays in init.install.test.ts include the correct packages (should match what each test installs)
  • Spot-check a few badge URLs after merge to confirm they render correctly
  • Search for any remaining streaming/ references: grep -r "streaming/" --include="*.yaml" --include="*.json" --include="*.md"

Notes

Link to Devin run: https://app.devin.ai/sessions/a4fde64468004af8a5a915dac64fb642
Requested by: Dan Lynch ([email protected]) / @pyramation

Build was verified locally with pnpm build passing successfully. Snapshot tests pass with npx jest __tests__/init.install.test.ts.

- Fix broken badge paths in README files that referenced incorrect package folders
- Rename streaming/ folder to uploads/ for better clarity
- Update pnpm-workspace.yaml to use uploads/ instead of streaming/
- Update CI workflow to reference uploads/ folder
- Update all badge URLs to use correct folder paths:
  - streaming/ packages now use uploads/
  - postgres/ packages now use postgres/
  - pgpm/ packages now use pgpm/
  - graphql/ packages now use graphql/
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Add normalizePackageJsonForSnapshot helper function that replaces
dependency versions with '<VERSION>' placeholder to prevent snapshot
failures when boilerplate/tooling dependency versions change.

The helper preserves versions for explicitly installed packages
(specified via preserveVersionsFor option) while normalizing
devDependencies and other tooling versions.

This fixes the flaky pgpm/cli tests that were failing due to
makage and pgsql-test version bumps.
@pyramation pyramation merged commit 3fe074f into main Dec 27, 2025
34 checks passed
@pyramation pyramation deleted the devin/1766793546-fix-readme-badges branch December 27, 2025 00:38
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.

2 participants