tick

type Activity struct {
	Timestamp time.Time              `json:"ts"`
	TickID    string                 `json:"tick"`
	Action    string                 `json:"action"`
	Actor     string                 `json:"actor"`
	Epic      string                 `json:"epic,omitempty"`
	Data      map[string]interface{} `json:"data,omitempty"`
}

type IDGenerator struct {
	// contains filtered or unexported fields
}

type Store struct {
	Root string
}

type Tick struct {
	ID          string   `json:"id"`
	Title       string   `json:"title"`
	Description string   `json:"description,omitempty"`
	Notes       string   `json:"notes,omitempty"`
	Status      string   `json:"status"`
	Priority    int      `json:"priority"`
	Type        string   `json:"type"`
	Owner       string   `json:"owner"`
	Labels      []string `json:"labels,omitempty"`
	BlockedBy   []string `json:"blocked_by,omitempty"`
	// After expresses preferred ordering only (work these targets first if
	// feasible); it never gates readiness — that is BlockedBy. Entries are
	// tick IDs; consumers ignore missing or closed targets.
	After  []string `json:"after,omitempty"`
	Parent string   `json:"parent,omitempty"`
	// TargetDate is an optional precise ISO calendar day (e.g. "2026-09-30"):
	// no time-of-day, no timezone, no fuzziness. Absent (empty) is the common
	// case. It feeds the derived overdue / on-track signal (later ticks) and
	// never gates execution.
	TargetDate string `json:"target_date,omitempty"`
	// Role marks a process tick in an epic's EPIC-SKELETON: "review" for the
	// final-review tick, "closeout" for the close-out/retro tick. Empty (the
	// common case) means a normal work tick. Structural, not title-derived —
	// tk graph --json reports missing_process_ticks from this field.
	Role               string     `json:"role,omitempty"`
	DiscoveredFrom     string     `json:"discovered_from,omitempty"`
	AcceptanceCriteria string     `json:"acceptance_criteria,omitempty"`
	DeferUntil         *time.Time `json:"defer_until,omitempty"`
	ExternalRef        string     `json:"external_ref,omitempty"`
	Manual             bool       `json:"manual,omitempty"`
	BaseBranch         string     `json:"base_branch,omitempty"`
	Requires           *string    `json:"requires,omitempty"`
	Awaiting           *string    `json:"awaiting,omitempty"`
	Verdict            *string    `json:"verdict,omitempty"`
	CreatedBy          string     `json:"created_by"`
	CreatedAt          time.Time  `json:"created_at"`
	UpdatedAt          time.Time  `json:"updated_at"`
	StartedAt          *time.Time `json:"started_at,omitempty"`
	ClosedAt           *time.Time `json:"closed_at,omitempty"`
	ClosedReason       string     `json:"closed_reason,omitempty"`
}