fix(ci): rebuild packages after version bump and add jbcom branding#16
Merged
jbdevprimary merged 1 commit intoDec 25, 2025
Merged
Conversation
…o docs - Fix CI release workflow to build packages AFTER semantic-release version bump * Prevents mismatch between build artifacts and released version * Ensures correct version is published to PyPI - Add jbcom brand styling to documentation * Implement dark theme with jbcom color palette (#0a0f1a, #06b6d4) * Add jbcom-sphinx.css with Space Grotesk/Inter/JetBrains Mono typography * Configure Sphinx to use branded CSS * Follow jbcom documentation branding standards - Add docs/.gitignore to exclude auto-generated _autosummary files Fixes version publishing issues and implements required branding for 1.0 release.
cursor Bot
pushed a commit
that referenced
this pull request
Dec 25, 2025
After 3 iterations of workflow improvements (#16, #19, #20), identified that the root blocker is repository branch protection rules that prevent semantic-release from pushing to main, even with elevated tokens. Documented multiple solution paths including bypass configuration and manual release process. Repository is 100% ready for 1.0, only automation is blocked.
jbdevprimary
added a commit
that referenced
this pull request
Dec 25, 2025
* docs: update status with branch protection blocker analysis After 3 iterations of workflow improvements (#16, #19, #20), identified that the root blocker is repository branch protection rules that prevent semantic-release from pushing to main, even with elevated tokens. Documented multiple solution paths including bypass configuration and manual release process. Repository is 100% ready for 1.0, only automation is blocked. * feat(ci): implement official python-semantic-release GitHub Action Complete rewrite using official best practices from python-semantic-release docs: ### Key Changes 1. **Official GitHub Action** (python-semantic-release/python-semantic-release@v9.14.0) - Recommended approach from official documentation - Handles all version bumping, commits, and tagging - Works with GitHub's permissions model 2. **Proper Permissions** - contents:write for commits/tags - id-token:write for PyPI Trusted Publishing - persist-credentials:true for git operations 3. **Simplified Flow** - No manual git configuration needed - No credential helper hacks - Action handles branch protection correctly 4. **Updated pyproject.toml** - Added remote.type = "github" - Added commit_parser_options for conventional commits - Configured changelog generation 5. **PyPI Publishing** - Uses newly synced PYPI_TOKEN - verbose:true for debugging - skip-existing:true for safety ### Why This Works The official action is designed to work with GitHub's branch protection and permissions model. It uses the GITHUB_TOKEN correctly and doesn't try to push directly - it uses the GitHub API when needed. Follows: https://python-semantic-release.readthedocs.io/en/latest/configuration/automatic-releases/github-actions.html --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Critical fixes for CI/CD release workflow and documentation branding required for 1.0 stable release.
Changes
CI/CD Fix
Documentation Branding
.cursor/rules/03-docs-branding.mdcjbcom-sphinx.csswith:docs/.gitignoreto exclude auto-generated API docsTesting
Impact
Next Steps
After merge:
Note
Addresses release packaging and documentation branding.
releaseworkflow now runsuv buildaftersemantic-release version, replacing the artifact download step to ensuredist/matches the bumped versiondocs/_static/jbcom-sphinx.css(dark theme/branding) and configures it viahtml_css_filesindocs/conf.py; enablesstyle_external_linksin theme optionsdocs/.gitignoreto excludeapi/_autosummary/Written by Cursor Bugbot for commit af5e423. This will update automatically on new commits. Configure here.