Releases: vig-os/sync-issues-action
Releases · vig-os/sync-issues-action
v0.2.2
Immutable
release. Only release title and notes can be modified.
Added
- Exported
shiftHeadersToMinLevelutility function for independent unit testing - Sync sub-issue relationships into frontmatter (#8, #15)
- Fetch
parentandsubIssuesvia GraphQL batch query for all synced issues - New
sync-sub-issuesaction input to control sub-issue syncing (default:true) - Replace hardcoded
relationship: nonewith dynamicparentandchildrenfields - Graceful degradation: emits info message and falls back to
noneif the sub-issues API is unavailable
- Fetch
- CI/CD pipeline (#13)
- CI workflow with lint, build-dist verification, and test jobs
- Integration test suite as a reusable workflow with parallel jobs covering issues-only, PRs-only, force-update, include-closed, sub-issues, updated-since, state-file, and default-mode scenarios
- Three-phase release pipeline: prepare-release (branch + draft PR), release (tag + GitHub Release with provenance attestation), and post-release (dev sync + CHANGELOG reset)
setup-envandbuild-distcomposite actions for consistent environment setup- CHANGELOG management CLI (
prepare_changelog.py) for automated release note preparation - Dependabot configuration for automated dependency updates
- CODEOWNERS file for automated review assignment
- CodeQL analysis workflow for automated security vulnerability scanning
- Scorecard workflow for ongoing supply-chain security assessments
- Security scan workflow for continuous security monitoring
Changed
- Sync-issues workflow uses local action checkout (#13)
- Replaced pinned remote ref with
uses: ./so the workflow always tests the current branch's code
- Replaced pinned remote ref with
- Node.js version pinned via
.nvmrc(#13).nvmrcis the single source of truth;setup-envand devcontainer read from it
Fixed
- Corrected heading hierarchy in
formatPRAsMarkdown: promoted the Comments section header from##to#and individual comment entry headers from###to## - Release workflow avoids immutable-release upload failures
- Generates
checksums-sha256.txtbefore creating the GitHub release and attaches it duringgh release createinstead of uploading afterward
- Generates
- Release workflow: floating-tag updates and rollback (#38)
- Floating-tag updates (vX, vX.Y) run in a separate job after the release job succeeds; main rollback no longer restores floating tags
- Resolve floating tags via exact "Get a reference" API (
git/ref/tags/$TAG) instead ofgit/matching-refsto avoid wrong-SHA from prefix matches - New job captures current SHAs, updates tags, and on failure restores from captured SHAs (self-contained)
--force-updatedoes not re-sync issues (only PRs) (#10)- Added
force-updateaction input that bypasses thehasContentChangedcontent-comparison gate - When active, all fetched items are re-written (with updated
synced:frontmatter) even if body content is unchanged - Updated
sync-issues.ymlworkflow to pass theforce-updatedispatch input to the action
- Added
- Added
shiftHeadersToMinLevelhelper to re-level headers inside comment bodies so the shallowest header maps to###, preventing collisions with outer document structure - Fixed default
GITHUB_REPOSITORYintest-local.shfrom non-existentvig-os/actionstovig-os/sync-issues-action - Removed broken fallback command in
test-local.shthat passed a file path where a directory is required
Security
- CodeQL and OpenSSF Scorecard analysis workflows (#13)
- CodeQL scans JavaScript/TypeScript on push and PR
- Scorecard publishes results to the Security tab via SARIF
v0.1.1
Release v0.1.1
Release Date: December 19, 2025
Critical Bug Fix
This release fixes a critical issue that prevented the GitHub Action from executing properly.
Fixed
- Missing build artifacts: Fixed missing
dist/index.jsfile in published releases. The action now correctly includes all compiled code, ensuring GitHub Actions can find and execute the action. - Updated
.gitignoreto allow distribution files to be committed to the repository.
Enhancements
Developer Experience Improvements
- TypeScript definitions: Added comprehensive TypeScript definition files (
.d.ts) for better IDE support and type checking when using this action in TypeScript projects. - Source maps: Included source maps for improved debugging experience.
- License compliance: Added
licenses.txtfile with all dependency licenses in the distribution folder.
Dependencies
- Updated
vig-os/commit-actionfromv0.1.0tov0.1.1in internal workflows.
Installation
Update your workflow to use the latest version:
- name: Sync Issues and PRs
uses: vig-os/[email protected]Migration
No migration required. This is a patch release that fixes a critical bug. All existing workflows using v0.1.0 should update to v0.1.1 to ensure the action executes correctly.
Full Changelog
For detailed changes, see the CHANGELOG.md.
Full Changelog: v0.1.0...v0.1.1
v0.1.0
Initial Release: Sync Issues and PRs Action v0.1.0
Overview
Automatically sync all issues and pull requests from your repository to organized markdown files. Suitable for documentation, backup, and offline access.
Key Features
- Syncs issues and PRs with all comments, conversations, and metadata
- Groups PR review threads with diff snippets
- Supports GitHub tokens and GitHub App authentication
- Incremental sync with timestamp filtering
- State persistence for efficient workflow runs
Quick Start
- name: Sync Issues and PRs
uses: vig-os/[email protected]What's Included
- Complete sync of issues and pull requests
- All comments and conversations preserved
- PR review threads with diff snippets
- Comprehensive metadata (labels, dates, authors, state)
- Flexible authentication options
- Configurable output directory
- Action outputs for workflow integration
Example Usage
- name: Sync Issues and PRs
uses: vig-os/[email protected]
with:
output-dir: 'docs/issues'
state-file: '.github/sync-state.txt'For complete documentation, visit the repository.