All Classes and Interfaces
Class
Description
TrackerSource for the API-detector plugins' shared contract progress-history NDJSON,
one record per line with fields fingerprint, verb, path,
declaringClass, declaredAt, implementedAt, verifiedAt,
lastSeenAt, removedAt.Generates a complete, runnable pair of projects for developing and testing a new lens end to
end - the same boilerplate
LENS_TUTORIAL.adoc walks through by hand: a minimal lens-pack
project (containing the same boilerplate CSS initTrackerLens generates) and a minimal
sample project that applies tracker-lens itself, already wired to consume that pack and
render a dashboard from a small bundled sample history file.How many times a
ContractRule's selector is allowed or required to match in a generated
dashboard.The fixed (non-rule-relative) cardinality kinds.
The whole-document match count equals
rule's whole-document match count.How much history a
Projection is based on, driving the disclaimer text shown next to it
in the dashboard.The tracker-lens dashboard content contract: the single source of truth for which structural
elements a generated
dashboard.html must contain, so a lens's CSS has stable selectors to
style against.Renders
DashboardView to dashboard.html plus one CSS file per discovered lens, via
a Mustache template - this plugin's own bundled default, or a user-supplied override.Everything
DashboardHtmlWriter needs to render dashboard.html and one CSS file
per lens.Reads every registered tracker's NDJSON history, computes a completion
Projection for
each, resolves the merged lens set, writes dashboard.html plus one CSS file per
discovered lens, and validates the result against ContractRule as its unconditional last
step - a dashboard that silently can't take a lens because generation drifted from its own
content contract is a worse failure than a build error.TrackerSource for gherkin-to-asciidoc's scenario progress-history NDJSON, one
record per line with fields fingerprint, scenarioName, featureTitle,
listedAt, definedAt, implementedAt, lastSeenAt, removedAt.Expands a tracker's configured
historyFiles entries into a flat, deterministic list of
concrete NDJSON files to read: an entry that is itself a file is used as-is, and an entry that is
a directory is expanded to every *.ndjson file directly within it (non-recursive), sorted
by name.Generates a complete, heavily-commented boilerplate lens CSS file to start a new lens from,
covering every selector
ContractRule governs (see DASHBOARD-THEMING.adoc) with
inline comments explaining what each one is for and clearly-fake placeholder colors to replace.A single style pack lens, as discovered by
LensScanner: its id (the lens file's base
name, lower-cased) and its CSS content.Enforces every
ContractRule against a generated dashboard file.Derives a filesystem-safe CSS file name from a (possibly auto-namespaced) lens id, e.g.
Merges the
Lenses contributed by several LensSources into the final set offered
in the dashboard's lens switcher.Scans one classpath root - a directory or a jar, this plugin's own bundled resources or a
resolved
lensStyle dependency, no distinction - for the fixed
META-INF/arc-e-tect/tracker-lens/lenses/*.css convention and returns the Lenses
it finds.Resolves the full merged lens set - this plugin's own bundled built-in lenses, every resolved
external
lensStyle pack (optionally restricted to one preferred pack), and the single
lensStylesheet lens when configured - exactly the same way regardless of which task asks
for it.One contributor of
Lenses to be merged by LensResolver: either this plugin's own
bundled built-in lenses, or one resolved lensStyle dependency's lenses, or the single lens
contributed by trackerLens.lensStylesheet.A single tracked item's lifecycle, as read from a
TrackerSource.Merges
LifecycleRecords sharing the same LifecycleRecord.id() - read from
different history files registered on the same tracker - into one record per id.Lists every Tracker Lens style that
generateTrackerLensDashboard would offer in the
dashboard's lens switcher - this plugin's own built-in lenses, every resolved external
lensStyle pack, and the lensStylesheet lens when configured - without generating
a dashboard.Rendered data for one
.metric-card in a tracker section.Extrapolates when a tracker will reach its total item count, from the historical rate at which
items have reached its final stage.
An extrapolated completion estimate for a tracker, computed by
ProgressProjector.A
Lens after cross-pack merging by LensResolver: its final, possibly
auto-namespaced id, the label of the source it came from, and its CSS content.DSL extension for the Tracker Lens Gradle plugin.
Gradle plugin that generates a themeable, standalone HTML dashboard from Gherkin scenario and API
contract lifecycle history.
One
trackerLens.trackers { register("...") { ... } } DSL registration: which history
file(s) to read and which TrackerSourceKind to read them with.Reads a producing plugin's NDJSON lifecycle-history file into
LifecycleRecords.The built-in
TrackerSource kinds selectable from the trackerLens DSL's
source property, each paired with its canonical, ordered stage sequence.A resolved
trackerLens.trackers { ... } registration, as read by
GenerateTrackerLensTask from TrackerLensExtension.getTrackers() at configuration
time.Rendered data for one
.tracker section of the dashboard.Builds a
TrackerView from a tracker's raw records, ready for
DashboardHtmlWriter to render.One
ContractRule violation found by LensContractValidator.