feat: repo_topics_update tool #18

New Issue

mathias · 2026-05-14T08:52:42Z

mathias commented

2026-05-14 08:52:42 +00:00

Summary

Add a repo_topics_update tool to set/replace the topic tags on a repository. Topics are the primary way to make repos discoverable and are used by the GitHub ingestion pipeline to filter relevant repos.

Gitea API

PUT /api/v1/repos/{owner}/{repo}/topics

Tool spec

tool: repo_topics_update
params:
  owner:  string
  name:   string
  topics: []string  // replaces all existing topics

Required token permission

write:repository scope on the Gitea API token.

Risk classification

LOW — metadata only, fully reversible.

Motivation

During the GitHub ingestion pipeline design (2026-05-14): topic filtering is a key mechanism for reducing noise when ingesting starred repos. Our own repos also need consistent topics so they're correctly categorised. hyperguild new-project should set topics on newly created repos based on blueprint type (e.g. ["go", "agent", "homelab"] for agent projects).

Part of the repo_create + repo_update family
Used by hyperguild new-project after repo creation

## Summary Add a `repo_topics_update` tool to set/replace the topic tags on a repository. Topics are the primary way to make repos discoverable and are used by the GitHub ingestion pipeline to filter relevant repos. ## Gitea API `PUT /api/v1/repos/{owner}/{repo}/topics` ## Tool spec ``` tool: repo_topics_update params: owner: string name: string topics: []string // replaces all existing topics ``` ## Required token permission `write:repository` scope on the Gitea API token. ## Risk classification **LOW** — metadata only, fully reversible. ## Motivation During the GitHub ingestion pipeline design (2026-05-14): topic filtering is a key mechanism for reducing noise when ingesting starred repos. Our own repos also need consistent topics so they're correctly categorised. `hyperguild new-project` should set topics on newly created repos based on blueprint type (e.g. `["go", "agent", "homelab"]` for agent projects). ## Related - Part of the `repo_create` + `repo_update` family - Used by `hyperguild new-project` after repo creation

mathias referenced this issue from a commit

2026-05-15 08:24:19 +00:00

feat(tools): repo_tree, repo_topics_update, file_read dir fix (#14, #15, #18)

mathias referenced this issue

2026-05-15 08:24:28 +00:00

feat(tools): repo_tree, repo_topics_update, file_read dir fix (#14, #15, #18) #22

mathias referenced this issue from a commit

2026-05-15 08:24:36 +00:00

Merge pull request 'feat(tools): repo_tree, repo_topics_update, file_read dir fix (#14, #15, #18)' (#22) from feat/repo-ux into main

mathias commented

2026-05-18 06:12:37 +00:00

Shipped in v0.2.3. Closing during cleanup pass.