{"id":28320711,"url":"https://github.com/hwakabh/semantic-issue-action","last_synced_at":"2026-02-09T15:10:31.000Z","repository":{"id":268594078,"uuid":"904870177","full_name":"hwakabh/semantic-issue-action","owner":"hwakabh","description":"Checking if issues follow the Conventional Commits specs","archived":false,"fork":false,"pushed_at":"2026-01-12T14:18:04.000Z","size":555,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-12T20:56:36.139Z","etag":null,"topics":["github-actions","javascript-actions","nodejs","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/semantic-issue-actions","language":"TypeScript","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/hwakabh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-17T17:53:04.000Z","updated_at":"2026-01-12T14:18:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"81c580f6-ab77-48a0-9bf8-48ad0f6e0182","html_url":"https://github.com/hwakabh/semantic-issue-action","commit_stats":null,"previous_names":["hwakabh/semantic-issue-action"],"tags_count":25,"template":false,"template_full_name":"hwakabh/.github","purl":"pkg:github/hwakabh/semantic-issue-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwakabh%2Fsemantic-issue-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwakabh%2Fsemantic-issue-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwakabh%2Fsemantic-issue-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwakabh%2Fsemantic-issue-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hwakabh","download_url":"https://codeload.github.com/hwakabh/semantic-issue-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hwakabh%2Fsemantic-issue-action/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["github-actions","javascript-actions","nodejs","typescript"],"created_at":"2025-05-25T11:12:07.193Z","updated_at":"2026-01-24T17:08:22.484Z","avatar_url":"https://github.com/hwakabh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# semantic-issue-action\n[JavaScript GitHub custom Actions](https://docs.github.com/en/actions/sharing-automations/creating-actions/creating-a-javascript-action) for Semantic Issue using [`actions/toolkit`](https://github.com/actions/toolkit). \\\nThis GitHub Actions check that the titles of issue in your repository will follow [the Conventional Commit specs](https://www.conventionalcommits.org/en/v1.0.0/#specification).\n\nGenerally this actions will do nothing to interact in your issue/repos, whereas will post comments in the issue if the title format will breach conventional commits specs. \\\nFor checking if issue title will be aligned to conventional commits specs, as the core of this JavaScript actions, [`@conventional-commits/parser`](https://github.com/conventional-commits/parser) will be used.\n\n## Usage\nCreate workflows (ex. `.github/workflows/semantic-issue.yaml`) for using semantic-issue-action with contexts:\n\n```yaml\nname: Semantic Issue Title\non:\n  issues:\n    types:\n      - opened\n      - edited\n      - reopened\njobs:\n  semantic-issue:\n    steps:\n      - name: Check Issue Title\n        uses: hwakabh/semantic-issue-action@main\n```\n\nThe validations for issue title will be called, depending on the workflow event configurations in `on.issues` field, where the issue status will be not closed. \\\n(Technically, the jobs will be kicked even if the closed issue in repository will be updated, but nothing will be done by this action.)\n\nRegarding workflow event configurations, especially for issue's event, please see [GitHub docs](https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows#issues) for more references.\n\n## Inputs\nInputs have been defined in [`action.yml`](./action.yml):\n\n| Name | Required | Description |\n| --- | --- | --- |\n| `token` | true | Token to use to authorize. Typically the GITHUB_TOKEN secrets. |\n| `repo` | true | Target repository to check issue title. |\n| `body` | false | Message body to comment if title is not semantic. |\n\nExample contexts for enabling title validations of this repository (`hwakabh/semantic-issue-action`):\n\n```yaml\n    steps:\n      - name: Check Issue Title\n        uses: hwakabh/semantic-issue-action@main\n        with:\n          repo: \"hwakabh/semantic-issue-action\"\n          token: \"${{ secrets.GITHUB_TOKEN }}\"\n          body: \"The issue title is not aligned to conventional-commits specs, please consider to resolve.\"\n```\n\nThe validations will be invoked in the issue's event trigger you configured, and if the issue title would not meet the spec of conventional-commits, the above configurations will trigger to comments like:\n\n![posting-comments](https://github.com/user-attachments/assets/e5a186e1-c4df-45c9-8412-2e7a3c80a9ef)\n\n## Outputs\nThis action will return the following outputs, so that you can extend your workflow with using them:\n\n| Name | Description |\n| --- | --- |\n| `check-result` | Boolean value of validation that issue title is semantic or not |\n\nExample usage of `check-result` output are below, but note that GitHub Actions outputs will be evalutated as string value even if the actions returns boolean value. \\\nSee more about [the related comments](https://github.com/actions/runner/issues/1483#issuecomment-994986996).\n\n```yaml\n    steps:\n    - id: check-issue-title\n      uses: hwakabh/semantic-issue-action@main\n\n    - if: steps.check-issue-title.outputs.check-result == 'true'\n      run: |\n        echo \"Issue title is semantic ...\"\n        # Put your logics here\n\n    - if: steps.check-issue-title.outputs.check-result == 'false'\n      run: |\n        echo \"Title of issue is not aligned conventional-commits spec ...\"\n        # Put your logics here\n```\n\n## Locals\nFor local development of this custom actions, generally we will expect to use [`nektos/act`](https://github.com/nektos/act) to run GitHub Actions jobs on your local environment. \\\nPlease refer [the docs](https://nektosact.com/introduction.html) for more details.\n\n## Credits\nImplemenation references on:\n- [`semantic-pull-requests`](https://github.com/zeke/semantic-pull-requests) (GitHub Apps) created by [@zeke](https://github.com/zeke)\n- [`semantic-prs`](https://github.com/Ezard/semantic-prs/tree/master) created by [@Ezard](https://github.com/Ezard)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwakabh%2Fsemantic-issue-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhwakabh%2Fsemantic-issue-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhwakabh%2Fsemantic-issue-action/lists"}