zoryn/ maintainer-assistant
zoryn
v0.37.0 · GPL-2.0-or-later

zoryn
ALT Linux maintainer assistant

// clone → up → build → submit

Zoryn drives a package from upstream release to a sisyphus build — automating what can be automated, keeping you in control of the process.

The name comes from an ancient root meaning light and clear sight.

maintainer@alt·~/packages/erlang-stun·zsh
/ architecture

Where zoryn sits

Four commands — from "a new release dropped" to a sisyphus subtask.

/ upstream
git.altlinux.org
gears, srpms — clone, fetch
github · gitlab · …
upstream tags, tarballs, CVE
PyPI · Debian watch · opam
pypi2spec, opam2spec, gen watch
/ build · hasher farm
local
x86_64 · parallel slots
@host:arm · @host:i586 …
remote hashers via ssh
batch · specsubst
package chains, test-rebuild
Maintainer
git · spec · coffee
zoryn
ocaml · toml · 14-stage pipeline
fetchmergespec
changeloghooksbuild
batchtagpushtask
test-rebuild
pre-submit verification of build tasks
/ publish
gitery
git push, tag
gyle / girar
task new / add / run / approve
Tasks API
task list, subtask states
/ query · meta
RDB
package db, deps for rebuild
Repoteka · Taskoteka
name search, subtask metadata
OSV · Bugzilla
CVE database, bug closures
/ capabilities

Ten things it takes off your hands

zoryn up
zoryn up
Full update pipeline: fetch → merge → spec → changelog → build. State-aware with --continue.
zoryn build -b @all
Build anywhere
Local and remote hasher machines, @all / @host:basalt patterns, TUI for live monitoring.
zoryn task manage
Task management
task new / add / run / approve, interactive TUI, state columns, syntax-highlighted logs.
zoryn task refresh
Refresh stale subtasks
Pulls newer package versions from the repo into the task to replace stale ones. Types: rebuild (default) / copy / gear / srpm; --from switches branch.
zoryn task test-rebuild
Test rebuild dependents
Download task RPMs, find dependent packages via RDB, hasher-rebuild each locally — catch breakage before submit.
zoryn task rebuild
Rebuild dependents
Find dependents of a rebuilt library, build them in hasher and attach successes back to the task as new subtasks.
zoryn builder
Builder fleet
Manage local and remote hasher machines: list / status / add / remove / shell / install / copy / clean.
zoryn check spec
Pre-submit checks
Spec validation, CVE scan, sisyphus_check, Bugzilla bug-closure verification.
zoryn gen pypi2spec
Generators
opam2spec, pypi2spec, watch, version-up, environment — spec + .gear from two commands.
[sandbox] runner = hybrid
Sandboxed hooks
Hooks from .gear/*.d/ run in bwrap + hasher chroot. Your ~/.ssh stays safe.
/ workflow

A typical maintainer day

Four commands — from "a new release dropped" to a sisyphus subtask.

01 —
zoryn clone libnghttp2
Clone the package
Zoryn detects whether it is gear or SRPM and pulls from the right git.altlinux.org.
02 —
zoryn up
Update & build
Fetch upstream, git-merge or tarball, CVE scan, changelog, release reset to alt1 — and hasher build across your builders in one command. `--continue` resumes from the last checkpoint.
03 —
zoryn submit --run
Submit to sisyphus
Commit, tag, push, task new/add — one command. Test-only by default; `--commit` to actually land it.
04 —
zoryn task manage
Manage the queue
Interactive TUI for your gyle tasks: state columns, syntax-highlighted logs, approve or run builds without leaving the terminal.
/ install

Installation

The `zoryn` package is already in Sisyphus. To build from source:

apt-get
From source
Into $HOME
shell · sisyphus
$ apt-get install zoryn
# done. bash completion lives at /usr/share/bash-completion/completions/zoryn