Documentation
¶
Index ¶
- func AppendEntries(project string, entries []Entry) error
- func AppendEntriesToPath(path string, entries []Entry) error
- func CountForTicket(entries []Entry, ticketID string) int
- func ExtractTicketActions(message string) map[string]string
- func FirstLine(s string) string
- func GetDiffStats(repoPath, sha string) (files []string, added, removed int, branch string, err error)
- func GetParentCommitTS(repoPath, sha string) string
- func GroupByTicket(entries []Entry) map[string][]Entry
- func IsLiveCommit(ts string) bool
- func JournalPath(project string) (string, error)
- func LoadJournalState(path string) (map[string]struct{}, string, error)
- func ResolveStableBranchName(repoPath, sha string) string
- func StatePath(project string) (string, error)
- func WorkDurationSeconds(started, ended string) int
- type EffortSummary
- type Entry
- type GitCommit
- type WatchCycleResult
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AppendEntries ¶
AppendEntries appends entries to the project's commits.jsonl, creating parent directories if needed. Entries whose SHA+Ticket pair already exists in the file are skipped.
func AppendEntriesToPath ¶
AppendEntriesToPath appends entries to a specific JSONL path with dedup.
func CountForTicket ¶
CountForTicket counts entries for a specific ticket ID.
func ExtractTicketActions ¶
ExtractTicketActions parses a commit message and returns a map of ticket ID to action. Bracket refs [ticket-id] produce action "ref". Closes:/Fixes: prefixes followed by bracket refs produce action "close".
func GetDiffStats ¶
func GetDiffStats(repoPath, sha string) (files []string, added, removed int, branch string, err error)
GetDiffStats runs git diff-tree --numstat for a commit and returns changed files, total lines added, total lines removed, and the branch name.
func GetParentCommitTS ¶
GetParentCommitTS returns the author date of the parent commit (sha^), used as a work_started proxy. Returns empty string on any error.
func GroupByTicket ¶
GroupByTicket groups entries by ticket ID into a map.
func IsLiveCommit ¶
IsLiveCommit returns true if the commit timestamp is within the last 60 seconds.
func JournalPath ¶
JournalPath returns ~/.ticket/state/<project>/commits.jsonl.
func LoadJournalState ¶
LoadJournalState reads existing SHAs and the last SHA from a journal file.
func ResolveStableBranchName ¶
ResolveStableBranchName returns a single stable branch label for a commit. Returns empty string if the commit belongs to zero or multiple branches.
func WorkDurationSeconds ¶
WorkDurationSeconds computes the duration in seconds between two RFC3339 timestamps. Returns 0 if either is empty or unparseable.
Types ¶
type EffortSummary ¶
EffortSummary holds aggregated diff stats for a set of journal entries.
func Effort ¶
func Effort(entries []Entry) EffortSummary
Effort computes aggregated diff stats from a slice of journal entries.
func (EffortSummary) String ¶
func (e EffortSummary) String() string
String returns a human-readable effort summary, or empty string if no data.
type Entry ¶
type Entry struct {
SHA string `json:"sha"`
Ticket string `json:"ticket"`
Repo string `json:"repo"`
TS string `json:"ts"`
Msg string `json:"msg"`
Author string `json:"author"`
Action string `json:"action"`
FilesChanged []string `json:"files_changed,omitempty"`
LinesAdded int `json:"lines_added,omitempty"`
LinesRemoved int `json:"lines_removed,omitempty"`
Branch string `json:"branch,omitempty"`
WorkStarted string `json:"work_started,omitempty"`
WorkEnded string `json:"work_ended,omitempty"`
DurationSecs int `json:"duration_seconds,omitempty"`
}
Entry represents a single commit-to-ticket link in the journal JSONL file.
func FilterByTickets ¶
FilterByTickets returns entries whose Ticket is in the given set of IDs.
func ReadEntries ¶
ReadEntries loads all commit journal entries for the given project. Malformed lines are silently skipped. Missing file returns empty slice.
func ReadEntriesFromPath ¶
ReadEntriesFromPath loads entries from a specific JSONL file path.
type GitCommit ¶
GitCommit represents a parsed git log entry.
func CollectCommits ¶
CollectCommits runs git log and returns commits in chronological order. If lastSHA is provided, returns commits after that SHA. If lastSHA is empty or the SHA range fails (history rewrite), falls back to --since=registeredAt.
type WatchCycleResult ¶
WatchCycleResult holds the outcome of a single watch cycle for a project.
func RunWatchCycle ¶
func RunWatchCycle(projectName string, cfg project.ProjectConfig, store ticket.Store) (WatchCycleResult, error)
RunWatchCycle processes new git commits for a project, extracts ticket references, computes diff stats, appends journal entries, and optionally auto-closes tickets.
Source Files