CodeTodo

Shape

• 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

Graph

Used by