{"id":14981769,"url":"https://github.com/tmillr/breaking-change","last_synced_at":"2025-10-29T09:30:17.647Z","repository":{"id":63297331,"uuid":"562778924","full_name":"tmillr/breaking-change","owner":"tmillr","description":"A GitHub Action for automatically reporting breaking changes detected via conventional commits.","archived":false,"fork":false,"pushed_at":"2025-02-12T16:57:55.000Z","size":428,"stargazers_count":1,"open_issues_count":25,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T01:18:07.026Z","etag":null,"topics":["actions","breaking-changes","conventional-changelog","conventional-commits","github-actions","neovim","nvim","vim"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmillr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-07T08:39:25.000Z","updated_at":"2023-07-25T15:03:43.000Z","dependencies_parsed_at":"2024-03-02T18:41:06.781Z","dependency_job_id":"82016daa-e83e-4800-b55c-d01384e9ede2","html_url":"https://github.com/tmillr/breaking-change","commit_stats":{"total_commits":72,"total_committers":3,"mean_commits":24.0,"dds":"0.18055555555555558","last_synced_commit":"16f1a5cc712612a7ea15495c32bb8e57d041bce8"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmillr%2Fbreaking-change","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmillr%2Fbreaking-change/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmillr%2Fbreaking-change/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmillr%2Fbreaking-change/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmillr","download_url":"https://codeload.github.com/tmillr/breaking-change/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238759818,"owners_count":19525874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","breaking-changes","conventional-changelog","conventional-commits","github-actions","neovim","nvim","vim"],"created_at":"2024-09-24T14:04:13.530Z","updated_at":"2025-10-29T09:30:17.170Z","avatar_url":"https://github.com/tmillr.png","language":"JavaScript","readme":"# Breaking Change\n\n[![codecov](https://codecov.io/github/tmillr/breaking-change/branch/master/graph/badge.svg?token=CdtcYcijqb)](https://codecov.io/github/tmillr/breaking-change)\n\nThis GitHub action automatically detects breaking changes by scanning the messages of commits pushed to your repository for [conventional commit](https://www.conventionalcommits.org) syntax. For each commit that signals a breaking change, its message content will be posted as a comment on a preselected/predetermined GitHub issue and/or discussion (whose number is specified via the action's inputs). The action will error if neither an issue or discussion is specified, although both may be specified. The order of commits are preserved and are reflected in the order of the comments. Such a discussion or issue not only serves as a central, autonomous, chronological log of breaking changes, but also as a source of breaking change notifications for users who subscribe to the issue/discussion.\n\n## Usage\n\n\u003c!-- prettier-ignore-start --\u003e\n~~~yaml\n      - name: Report Breaking Changes\n        uses: tmillr/breaking-change@v2\n        # Only trigger step on push events occurring on your release branch\n        if: ${{ github.event_name == 'push' \u0026\u0026 github.ref_name == 'main' }}\n        with:\n          # The token to be used for posting the comments\n          token: ${{ github.token }}\n          # Issue and/or discussion number where breaking changes should be reported\n          issueNumber: 1\n          discussionNumber: 2\n~~~\n\u003c!-- prettier-ignore-end --\u003e\n\n### Inputs\n\n\u003c!-- prettier-ignore-start --\u003e\n| **Key** | **Description** | **Required** | **Default** |\n| --- | --- | :---: | :---: |\n| `token` | The token used for posting the comments. | `false` | `${{ github.token }}` |\n| `issueNumber` | Issue to comment on for each breaking change commit found. May be combined with `discussionNumber`. (`integer`) | `false` |  |\n| `discussionNumber` | Discussion to comment on for each breaking change commit found. May be combined with `issueNumber`. (`integer`) | `false` |  |\n| `headerLevel` | Header level for the commit message title/subject (use `false` to disable header styling of commit title). (`1\\|2\\|3\\|4\\|5\\|6\\|false`) | `false` | `3` |\n\u003c!-- prettier-ignore-end --\u003e\n\n### Outputs\n\n| **Key** | **Description**                                     |\n| ------- | --------------------------------------------------- |\n| `found` | Whether a breaking change was detected. (`boolean`) |\n\n## Tips\n\n- Lock the issue/discussion used for reporting breaking changes (only allow maintainers etc. to comment).\n\n## Caveats\n\n- Using the issue/discussion method alone, it may not be clear or obvious which reported breaking changes belong to which versions/releases of the software.\n\n- Only detects [conventional commits](https://www.conventionalcommits.org).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmillr%2Fbreaking-change","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmillr%2Fbreaking-change","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmillr%2Fbreaking-change/lists"}