fea/references/gitea-dto.md

Gitea DTO Reference

Raw Gitea API responses are large. When processing responses in this skill, extract only the fields listed below. Discard everything else before passing data to agents or storing in context.

Issue (get_issue_by_index)

{
  "number":    int,       // issue index
  "title":     string,    // issue title
  "body":      string,    // issue description (markdown)
  "state":     string,    // "open" | "closed"
  "labels":    [{ "name": string }],
  "user":      { "login": string },
  "created_at": string,
  "html_url":  string
}

Discard: id, url, original_author, original_author_id, ref, milestone, assignees, is_locked, pull_request, repository, full user object (keep only login), full labels objects (keep only name).

Comment (get_issue_comments_by_index)

Response is an array. Per comment extract:

{
  "id":         int,       // comment ID (needed for edit_issue_comment)
  "body":       string,    // comment body (markdown)
  "user":       { "login": string },
  "created_at": string
}

Discard: html_url, pull_request_url, issue_url, original_author, original_author_id, assets, updated_at, full user object (keep only login).

Comment classification

After extracting comment fields, classify each comment:

• Bot comment: body starts with <!-- mpns-feature-bot -->
• User comment: everything else

Bot comments are further classified by phase marker:

• Contains ### Questions → Q&A session comment
• Contains <!-- status:ready --> → ready-for-planning marker
• Contains ## Implementation Plan → plan-published marker

Wiki page (get_wiki_page)

{
  "title":      string,
  "content":    string,    // base64-encoded page content
  "html_url":   string
}

Discard: sub_url, commit_count, sidebar, footer, last_commit.

Tool parameter reference

Read operations

Tool	Required params
get_issue_by_index	owner, repo, index (int)
get_issue_comments_by_index	owner, repo, index (int)
get_wiki_page	owner, repo, pageName (string)
list_wiki_pages	owner, repo

Write operations

Tool	Required params	Notes
create_issue_comment	owner, repo, index (int), body (string)	Body is markdown
edit_issue_comment	owner, repo, commentID (int), body (string)
create_wiki_page	owner, repo, title (string), content_base64 (string)	Content must be base64-encoded
update_wiki_page	owner, repo, pageName (string), content_base64 (string)	Optional: title, message
edit_issue	owner, repo, index (int)	Optional: title, body, state, assignees, milestone