mr.zeroandClaude Opus 5
45f5aae3e8
It told the auditor not to flag internal/*-builder references, on the grounds that a package namespace does not move with its repo. The images have since been moved deliberately, so a leftover internal/ reference is now a real drift — and the measure is where the package is in the registry today, not where it used to be. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
4.1 KiB
name, description, allowed-tools
| name | description | allowed-tools |
|---|---|---|
| ttg-audit-forge | Audit the TTG estate for drift between the forge, the clone list, the wiki, the catalog and CI — repos missing from the clone list, stale git URLs, repos with build config but no pipeline, catalog entries whose repo name differs, duplicate checkouts and leftover remotes. Reports findings; fixes only what the user approves. Use for a health check ("nézd át", "audit", "mi van elcsúszva", "konzisztencia"). | Bash, Read, Grep, Glob |
ttg-audit-forge
Konzisztencia-ellenőrzés a forge, a klónlista, a wiki, a katalógus és a CI között. Először jelents, ne javíts — a találatok egy része szándékos, és a felhasználónak kell eldöntenie.
Adatforrások
| Mi | Honnan |
|---|---|
| repók | tea api --login ttg "/user/repos?limit=50&page=N" (lapozz) |
| orgok, csapatok | tea api --login ttg /user/orgs, /orgs/<org>/teams |
| csomagok | tea api --login ttg "/packages/<org>?limit=50" |
| klónlista | devarea/scripts/repos.list + check-repos.sh |
| wiki-leképezés | devarea/WIKI_CONNECTION.md |
| katalógus | https://teletypegames.org/api/software |
| CI | https://teletypegames.org/api/ci/pipelines |
Ellenőrzések
1. Klónlista ↔ szerver. devarea/scripts/check-repos.sh. MISSING = a szerveren van, a listán nincs; STALE = fordítva. A repos.ignore-ban lévők szándékosan kimaradnak.
2. Elavult git URL-ek. A workspace-ben, a wikiben és a publikus oldalon:
grep -rn "git\.teletype\.hu" --exclude-dir=.git # legacy hoszt, sosem helyes
grep -rnoE "git\.teletypegames\.org(:[0-9]+)?/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+"
Az orgot vesd össze a repo mai tulajdonosával. Ne jelentsd hibának: az api/packages/<org>/rubygems (registry-út, nem repo) és a szándékos placeholderek (games/example).
A csomagnévterek külön figyelmet kérnek. A konténer- és gem-névtér nem költözik a repóval és nem kap átirányítást, ezért könnyen elszakad az orgtól. A builder image-ek 2026-08-16-án az internal alól a build alá kerültek, tehát egy megmaradt internal/<név>-builder vagy internal/tic80pro hivatkozás ma már valódi elcsúszás — a mérce az, hogy a csomag hol van a registryben (tea api --login ttg "/packages/<org>?limit=50"), nem az, hogy hol volt.
3. Go modulnevek. Minden go.mod első sora egyezzen a repo mai <org>/<repo> útjával. A Gitea átirányítása nem fedi a modulneveket, tehát az eltérés valódi törés. Nézd a fogyasztók require/replace sorait is: a replace ... => ../<repo> CI-ben mindig bukik.
4. Gem- és csomaghivatkozások. Gemfile, Gemfile.lock, *.gemspec — hoszt és org. A gemspec allowed_push_host-ja egyezzen a publikáló pipeline --host értékével.
5. CI-lefedettség. Vesd össze háromfelé: van-e .woodpecker.yaml vagy .woodpecker.yml, szerepel-e a repo a /api/ci/pipelines-ban, és van-e katalógus-bejegyzése. A tipikus hiba: konfig megvan, regisztráció nincs — ilyenkor a build csendben nem fut. Nézd a last_pipeline_status mezőt is.
6. Katalógus ↔ repo. A katalógus szoftverneve és a repo neve eltérhet (bevydemo vs bevy-demo). Ez önmagában nem hiba, de a wikiben és az oldalon linkként elszáll, ha a szoftvernevet használják repo-útként.
7. Org-higiénia. Minden orgnak legyen megjelenítendő neve és Teletypers csapata a games mintájára (azonos units_map, includes_all_repositories, tagok). Üres orgnál nézd meg a csomagjait, mielőtt bárki törölné.
8. Workspace-higiénia. Duplikált checkout (ugyanaz a repo két mappában, eltérő állapotban), origin-on kívüli elfekvő remote, és olyan branch, aminek az upstreamje nem origin/... — ebből egy sima git push rossz helyre megy.
Jelentés
Csoportosítsd a találatokat aszerint, hogy valódi törés, elcsúszás vagy szándékos. Minden találathoz add meg a fájlt és a sort. A javításra kérj jóváhagyást; ha a felhasználó kéri, a repo-mozgatáshoz a ttg-move-repo, a dokumentációhoz a ttg-update-docs skill való.