Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

just release <service> <version>: file Release notes and tag

Open
#182 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
52/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
git, shell
Domain
release, tooling

Research direction

Start by reading the repository's just recipes and the release notes validation entry point mentioned in the issue. Trace how pending fragments are stored under unreleased and how release workflows use tags. Done means the command checks repository state, handles both mtg and services without release notes, creates the specified commit when needed, and creates a signed annotated tag without pushing; the issue says this will be checked by hand.

Written by the indexing model from the issue text.

Description

ready-for-agent

Parent

#175

What to build

A developer cuts a Release with one command, just release <service> <version> (e.g. just release mtg 0.57.0). The version is explicit, with no bump logic.

  • It refuses when the tree is dirty, the branch is not main, or the branch is behind origin.
  • For mtg it runs the Release notes validation and refuses on an invalid pending fragment. It then moves the pending fragments from unreleased into the new version folder, writes release.yaml with the version and today's Release date, and commits as "mtg: release notes for v". With no pending notes it makes no commit.
  • It then creates the signed annotated tag <service>/v<version>, and does not push.
  • Services without a release-notes directory are only tagged.

The existing tag-triggered release and deploy workflows stay unchanged.

Acceptance criteria

  • just release <service> <version> exists and is listed by just
  • It refuses on a dirty tree, off main, and when behind origin, with a clear message
  • For mtg it refuses when a pending fragment is invalid (reusing the validation entry point)
  • For mtg with pending notes: fragments are moved, release.yaml is written, one commit "mtg: release notes for v" is made, then the signed annotated tag mtg/v<version> is created
  • For mtg without pending notes: no commit, only the tag
  • For a service without release notes: only the tag
  • Nothing is pushed
  • Checked by hand on the first real Release (no automated test)
Dominant language
TypeScript
Stars
0
Forks
1
Avg merge
11h 20m
Merged PRs (30d)
31

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from myOmikron/code

All issues in myOmikron/code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.