ListCodeTodosResponse

Shape

• itemsarray of CodeTodo

  • The CodeTodo schema
  • content_digeststringThe TODO's identifier: a SHA-256 digest of its keyword and text, without the (@owner) or (#id) part or the comment syntax. It holds no path or line number, so moving the comment keeps the same TODO.
  • first_seen_atstring
  • first_seen_shaCommitHash (string)The commit (push head) that first added this marker.
  • lineinteger · int320–∞
  • markerMarkerKindTODOFIXMEHACKXXXBUGOPTIMIZEThe marker keywords the scanner recognises. Uppercase only — todo: and Todo: are everywhere in prose, README files and variable names, and lowering the case sensitivity to be "helpful" is how a scanner becomes a noise generator.
  • pathRepoPath (string)Where the TODO was last seen. It changes as the comment moves; content_digest does not.
  • region_digeststringA digest of the TODO's source line as a code region — what the anchor created on promotion starts with as its content_digest. Unlike content_digest, it includes any (#id).
  • repository_idRepositoryId (string · uuid)
  • textstringThe TODO's text, normalised, at most 255 characters.
  • authorActorSummaryoptionalThe author of the commit that added the TODO — the work item's creator if it is promoted.

    • The ActorSummary schema
    • emailstring
    • idstring
    • usernamestring
    • avatar_urlstring or nulloptional
  • issue_iidIssueId (integer · int64) or nulloptionalThe number of the work item this TODO was promoted into, in the same repository. Absent until it is promoted. gitmoap todo sync writes it back into the comment as (#id).
  • ownerstring or nulloptionalThe @username an author wrote in the marker (without the @), a suggested assignee on promotion. Absent when the marker named no owner.
  • promoted_atstring or nulloptional
• next_tokenstring or nulloptional

Graph

Used by