Maintainer Guide¶

This page collection is a working reference for the fnb maintainer (myself). Unlike the Contributor Guide, which is written for external contributors, or Release Management, which is a general walkthrough, this guide is meant to be the shortest path to "what do I actually type" for repository and release operations.

Pages¶

Repository Management — branch workflow with git worktree, issue/MR management, CI monitoring
Release Checklist — the actual steps from version bump to publishing on PyPI

Quick Reference¶

The commands used most often, condensed into one table. See each page for details.

Task	Command
Create a work branch	`git worktree add ../worktrees/<branch> -b <branch>`
Create an issue	`glab issue create --label "Type::Bug,Priority::High"`
Create an MR	`glab mr create --source-branch <branch> --target-branch main`
Check CI status	`glab ci status --branch <branch>`
Preview a version bump	`task bump:check`
Apply a version bump	`task bump:auto`
Create release notes	`task docs:release -- X.Y.Z`
Create a GitLab release	`task push:release -- X.Y.Z`
Verify TestPyPI	`VERSION=X.Y.Z task verify:testpypi`
Publish to production PyPI	`task publish:prod`

Required Tools¶

uv — Python package management
task — Taskfile runner (see Taskfile.yml)
glab — GitLab CLI (check auth status with glab auth status)
.env — holds PYPI_API_TOKEN / TESTPYPI_API_TOKEN (never commit this)