tools.gitea_integration module

Gitea shortcuts for smk/stargazer-v3 on git.neko.li (delegates to shared credentials).

async tools.gitea_integration.gitea_open_issue(title, body, ctx=None)[source]

Open a new issue on the canonical smk/stargazer-v3 Gitea repo.

Convenience shortcut that hardcodes the owner/repo (DEFAULT_OWNER / DEFAULT_REPO) so callers need only supply the issue title and body. It lazily imports and delegates to tools.gitea_tools.gitea_create_issue, which performs the authenticated HTTP POST against the Gitea API on git.neko.li using the shared repo credentials; all network access and error handling live in that shared helper. The ctx is forwarded so the underlying tool can resolve credentials and platform state.

This coroutine is registered as the gitea_open_issue handler in this module’s TOOLS list (and appears in classifiers/tool_prefix_groups.py for routing), so it is invoked via the tool-dispatch layer rather than by direct internal calls; no direct by-name callers were found.

Parameters:

  • title (str) – The issue title.

  • body (str) – The issue body in Markdown.

  • ctx (ToolContext | None) – Tool execution context forwarded to the shared Gitea helper for credential/platform resolution.

Return type:

str

Returns:

The string result produced by gitea_create_issue (typically a success/summary message or serialized issue details).

async tools.gitea_integration.gitea_comment_issue(issue_id, body, ctx=None)[source]

Post a comment on an existing issue in smk/stargazer-v3.

Convenience shortcut that pins the owner/repo (DEFAULT_OWNER / DEFAULT_REPO) and lazily delegates to tools.gitea_tools.gitea_create_issue_comment, which issues the authenticated HTTP POST to the Gitea API on git.neko.li using the shared repo credentials. All network I/O and error handling are owned by that shared helper; ctx is forwarded for credential/platform resolution.

Registered as the gitea_comment_issue handler in this module’s TOOLS list (and listed in classifiers/tool_prefix_groups.py for routing), so it is reached through the tool-dispatch layer; no direct by-name internal callers were found.

Parameters:

  • issue_id (int) – The numeric id (issue number) of the target issue.

  • body (str) – The comment text in Markdown.

  • ctx (ToolContext | None) – Tool execution context forwarded to the shared Gitea helper.

Return type:

str

Returns:

The string result produced by gitea_create_issue_comment (typically a success/summary message or serialized comment details).

async tools.gitea_integration.gitea_close_issue(issue_id, ctx=None)[source]

Close an existing issue in smk/stargazer-v3.

Convenience shortcut that pins the owner/repo (DEFAULT_OWNER / DEFAULT_REPO) and lazily delegates to tools.gitea_tools.gitea_update_issue with state="closed". That shared helper performs the authenticated HTTP PATCH against the Gitea API on git.neko.li using the shared repo credentials and owns all network I/O and error handling; ctx is forwarded for credential/platform resolution.

Registered as the gitea_close_issue handler in this module’s TOOLS list (and listed in classifiers/tool_prefix_groups.py for routing), so it is invoked through the tool-dispatch layer; no direct by-name internal callers were found.

Parameters:

  • issue_id (int) – The numeric id (issue number) of the issue to close.

  • ctx (ToolContext | None) – Tool execution context forwarded to the shared Gitea helper.

Return type:

str

Returns:

The string result produced by gitea_update_issue (typically a success/summary message or serialized issue details).