Files

T

mr.zeroandClaude Opus 5 4192fc366e Add the ttg-ops plugin: six skills for the forge estate

The marketplace held only MCP servers so far. These are skills for the
work that keeps costing manual effort and quietly breaking:

- ttg-publish-module — releasing a library, and verifying from a clean
  external project that the release is actually fetchable. Encodes the
  trap that cost the most: Gitea redirects old repo paths, but not Go
  module paths, so a repo can be reachable while `go get` fails.
- ttg-move-repo — moving a repo and following it through every place
  that names it, including the ones redirects do not cover.
- ttg-new-repo — creating one in the right org and registering it, so
  it cannot end up absent from the clone list the way batocera-store did.
- ttg-ci-enroll — wiring a repo into the build, and the usual failure
  where the config exists but the repo was never registered.
- ttg-audit-forge — the drift check between forge, clone list, wiki,
  catalog and CI.
- ttg-update-docs — README, wiki page and the public site (Vue page plus
  both locale files) after a change.

The rules stay in REPO_REFACT.md, WIKI_CONNECTION.md and
ECOSYSTEM_PLAN.md; the skills read them instead of carrying a second
copy that drifts.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-16 11:07:39 +02:00

4.3 KiB

Raw Blame History

name, description, allowed-tools

name	description	allowed-tools
ttg-publish-module	Release a TTG library as a consumable package — a Go module tag or a RubyGems push to the forge registry. Checks the module path against the repo's org, tags the version, and verifies from a clean external project that the release is actually fetchable. Use when the user wants to publish, release, tag or version a library ("adjuk ki", "publikáld", "release", "tag a version").	Bash, Read, Edit, Grep, Glob

ttg-publish-module

Egy TTG könyvtár kiadása úgy, hogy utána tényleg le lehessen hívni. A skill nem ér véget a tagnél: külső projektből visszaellenőrzi.

Amit tudni kell előre

A forge https://git.teletypegames.org. A régi git.teletype.hu hosztot soha ne használd.
A Gitea átirányítja a régi owner/repo utakat egy átnevezés vagy org-váltás után — de ez nem terjed ki a Go modulnevekre és a csomag-névterekre. Ez a leggyakoribb hiba: a repo elérhető, a go get mégis elszáll.
A könyvtárak az engines orgban laknak. Az org-szabályok a workspace gyökér REPO_REFACT.md-jében vannak.

Go modul

A Go-nál nincs csomagtár: a repo maga a terjesztés, a git tag a verzió.

Modulnév ellenőrzése. A go.mod első sora legyen git.teletypegames.org/<org>/<repo>, ahol az org és a repo a mai helye. Ha eltér, írd át, és vele együtt minden belső importot (grep -rl '"<régi modulnév>' --include="*.go"). Két valós eset volt: module game (semmilyen néven nem hivatkozható) és egy org-váltást nem követő útvonal.
Fordul-e. go build ./... és go vet ./.... Ha a repo ebiten-t használ, macOS-en cgo-figyelmeztetések jönnek az upstreamből — azok nem a mi hibánk, szűrd ki őket.
Fogyasztók. Keresd meg, ki hivatkozik rá (grep -rn '<modulnév>' --include=go.mod a workspace-ben). Ha van replace ... => ../<repo> direktíva, az kiadás után elhagyható — és el is kell hagyni, mert testvérkönyvtárat vár, ami CI-checkoutban nincs, tehát bukó pipeline-t okoz.
Verzió. Ha nincs korábbi tag, v0.1.0 az őszinte kezdés. Egyébként semver a változás mértéke szerint. A tag legyen annotált: git tag -a v0.1.0 -m "<repo> v0.1.0 — <mi ez>".
Push. git push origin master && git push origin v0.1.0.

Ellenőrzés — ezt ne hagyd ki. Üres könyvtárban:

go mod init tmp/probe
GOPRIVATE=git.teletypegames.org GOPROXY=direct GOSUMDB=off \
  go get git.teletypegames.org/<org>/<repo>@v0.1.0

Ha ez lefut és a go.mod-ba bekerül a verzió, a kiadás valódi.

GOPRIVATE. A saját modulјaink nincsenek a proxy.golang.org-on és a publikus checksum adatbázisban, ezért minden fogyasztónak kell GOPRIVATE=git.teletypegames.org. Ha a fogyasztó egy TTG repo, tedd a Makefile-jába (export GOPRIVATE = git.teletypegames.org), ne csak a környezetbe — így CI-ben is működik.

Ruby gem

Hol fejlesztik. Ha a gem egy monorepo alkönyvtárában él (a warp_engine a services/teletypegames libs/ruby/warp_engine-jében), a gemspecet ott módosítsd, ne a split mirrorban — a mirror csak publikálásra való, a CI felülírja.
allowed_push_host. Pontosan egyezzen a gem push --host értékével. A forge orgonként külön registryt szolgál ki: https://git.teletypegames.org/api/packages/<org>/rubygems Ha csak a hosztnév van benne, a push visszautasításra kerül.
Van-e már pipeline. Nézd meg a repo .woodpecker.yaml-ját: lehet, hogy a publikálás már meg van írva és csak sosem futott. Ilyenkor ne kézzel pusholj — javítsd a pipeline-t (org-hivatkozások!) és tedd ki a tagot, amire figyel (a warp_engine-nél warp_engine-v*, nem v*).
Ellenőrzés. tea api --login ttg "/packages/<org>?limit=20". Ha üres marad, a Woodpecker naplója kell: indít-e buildet a tag-esemény, és van-e a CI tokennek package:write joga.

Korlát: a tea api csak JSON törzset küld, bináris feltöltésre nem alkalmas — kézi gem push-hoz nyers token kell, amit a tea titkosítva tárol, tehát a felhasználónak kell megadnia.

A végén

Foglald össze, mi hol jelent meg: a Go modulnál a repo tagje a kiadás helye (a csomag-registry üres marad, és ez így helyes), a gemnél az org rubygems registryje. Ha az ECOSYSTEM_PLAN.md említi a csomagot, frissítsd a státuszát.

4.3 KiB Raw Blame History Unescape Escape