pkg/

Package blocks defines the fixed library of display building blocks used to compose a template's rendered layout.

Package template defines the programmatic template contract for gitrakz: a saved composition of a form, a transform pipeline, and a display layout — never a saved prompt.

Package templates provides gitrakz's built-in template library: a small set of deterministic, Builtin=true templates seeded into the templates table on every service boot, so the template runner and templates manager have something to run before any user or LLM-authored template exists.

Package transform defines the pipeline contract for gitrakz templates: an ordered chain of primitives that reshape a selected timeline into a typed display document.

Package types defines the shared domain vocabulary for gitrakz — events, sessions, form values — as plain data structs.

Package migrations embeds gitrakz's SQLite schema migrations into the binary so it stays self-contained — no migrations directory to mount, no version skew between the binary and the SQL files.

Package api provides primitives to interact with the openapi HTTP API.

Package server implements gitrakz's HTTP handlers as the generated api.StrictServerInterface.

Package httpserver is gitrakz's only servicepack service: it boots the whole app — SQLite storage + migrations, the gh sync engine, the transform/template engine, the LLM adapters, and an aichteeteapee/serbewr HTTP server mounting the generated API under /api/ plus the embedded Svelte SPA — and runs a background sync ticker for the lifetime of the process.

Package aggregate implements the "aggregate" transform primitive: it folds every existing State.Rows entry's Values[field] down to one summary value (sum, avg, min, or max) and appends the result as a new Row.

Package describework implements the "describe-work" 🤖 transform primitive: it turns a group of raw commit titles into a one-line, natural-language description of the work — because commit subjects like "fix", "wip", or "asdf" don't belong in a timesheet or client report.

Package excludeofftime implements the "exclude-off-time" transform primitive: it subtracts recurring daily off-hours windows (lunch breaks, end-of-day cutoffs, etc.) from every session's duration.

Package groupby implements the "group-by" transform primitive: it buckets the timeline by a chosen Event field and writes one Row per bucket to State.Rows, each carrying the bucket's event count and additions/ deletions totals.

Package passthrough implements the "passthrough" transform primitive: it projects the raw event timeline directly into a display table with no aggregation, grouping, or filtering.

Package rate implements the "rate" transform primitive: it derives a dollars value for every row by multiplying its hours value by an hourly rate resolved from the run's form values, falling back to a params default.

Package registry wires every built-in transform primitive into a transform.Registry so the template engine can build a pipeline from a template's named steps.

Package sessionize implements the "sessionize" transform primitive: it clusters a timeline's events into per-owner work sessions using a gap-based heuristic, so downstream primitives can reason about continuous blocks of work instead of raw event timestamps.

Package splitbyactivedays implements a transform.Primitive that groups State.Sessions by the UTC calendar day of each session's start time and emits one aggregated Row per active day.