codetrail-cli 1.4.1__py3-none-any.whl

codetrail/web/templates/repository.html

@@ -0,0 +1,369 @@
+{% extends "base.html" %}
+{% block title %}{{ _("Repository") }}{% endblock %}
+{% block content %}
+{% macro capped(items) -%}
+<ul class="list" lang="en" dir="ltr">{% for item in items[:listed] %}<li>{{ caller(item) }}</li>{% endfor %}</ul>
+{% if items|length > listed %}
+<details class="more">
+  <summary>{% trans count=items|length - listed %}{{ count }} more{% endtrans %}</summary>
+  <ul class="list" lang="en" dir="ltr">{% for item in items[listed:] %}<li>{{ caller(item) }}</li>{% endfor %}</ul>
+</details>
+{% endif %}
+{%- endmacro %}
+{% macro change(tile, points=false) -%}
+{% if tile.change is none %}{{ _("No earlier update to compare with.") }}{% elif points %}{% trans change="%+d"|format(tile.change) %}{{ change }} points since the last update{% endtrans %}{% else %}{% trans change="%+d"|format(tile.change) %}{{ change }} since the last update{% endtrans %}{% endif %}
+{%- endmacro %}
+{% macro trend(tile) %}
+{% if tile.points %}
+{% set count = tile.trend_text.split(", ")|length %}
+<svg class="trend" viewBox="0 0 120 32" role="img" aria-label="{% trans count=count, values=tile.trend_text %}Trend over {{ count }} update: {{ values }}{% pluralize %}Trend over {{ count }} updates: {{ values }}{% endtrans %}"><polyline points="{{ tile.points }}"/></svg>
+{% endif %}
+{% endmacro %}
+<div class="wide">
+<header class="page-head repository-head">
+  <div>
+    <h1>{{ _("Repository") }}</h1>
+    <p class="muted">{{ _("What the repository is: its history, its releases, its code and its facts. Read from the code and its history, without calling your assistant.") }}</p>
+  </div>
+  {% if report is not none and report.activity and report.activity.days_start %}
+  <div class="segmented" role="group" aria-label="{{ _('Time range') }}" data-range-picker hidden>
+    <button type="button" data-range="all" aria-pressed="true">{{ _("All time") }}</button>
+    <button type="button" data-range="2y" aria-pressed="false">{{ _("2 years") }}</button>
+    <button type="button" data-range="1y" aria-pressed="false">{{ _("1 year") }}</button>
+    <button type="button" data-range="90d" aria-pressed="false">{{ _("90 days") }}</button>
+  </div>
+  {% endif %}
+</header>
+{% if report is none %}
+<section class="empty">
+  {% if unavailable %}
+  <h2>{{ _("The statistics aren't available just now") }}</h2>
+  <p>{{ _("Codetrail couldn't read the target's data; the log says why.") }}</p>
+  {% else %}
+  <h2>{{ _("No facts yet") }}</h2>
+  <p>{{ _("Update the guide once: reading the code is free, and the statistics come from it.") }}</p>
+  <button type="button" class="button primary" data-update-button>{{ _("Update the guide") }}</button>
+  {% endif %}
+</section>
+{% else %}
+{% set activity, releases, size = report.activity, report.releases, report.size %}
+<div class="stats">
+  <section class="stat metric" aria-labelledby="tile-age">
+    <span class="card-label" id="tile-age">{{ _("Age") }}</span>
+    {% if age is none %}
+    <span class="stat-value">—</span><span class="stat-note">{{ _("The history couldn't be read just now.") }}</span>
+    {% else %}
+    {% set years, months = age %}
+    <span class="stat-value">{% if not years and not months %}{% trans count=[(today - activity.first).days, 0]|max %}{{ count }} day{% pluralize %}{{ count }} days{% endtrans %}{% else %}{% if years %}{% trans count=years %}{{ count }} year{% pluralize %}{{ count }} years{% endtrans %}{% endif %}{% if years and months %}, {% endif %}{% if months %}{% trans count=months %}{{ count }} month{% pluralize %}{{ count }} months{% endtrans %}{% endif %}{% endif %}</span>
+    <span class="stat-note">{% trans date=activity.first.isoformat() %}First commit on <span class="nowrap">{{ date }}</span>{% endtrans %}</span>
+    {% endif %}
+  </section>
+  {% set tile = tiles["commits"] %}
+  <section class="stat metric" aria-labelledby="tile-commits">
+    <span class="card-label" id="tile-commits">{{ _("Commits") }}</span>
+    {% if tile.value is none %}
+    <span class="stat-value">—</span><span class="stat-note">{{ _("The history couldn't be read just now.") }}</span>
+    {% else %}
+    <span class="stat-value">{{ tile.value.numerator|number }}</span>
+    <span class="stat-note">{% trans count=activity.merges %}{{ count }} merge{% pluralize %}{{ count }} merges{% endtrans %}</span>
+    <span class="stat-note">{{ change(tile) }}</span>
+    {{ trend(tile) }}
+    {% endif %}
+  </section>
+  <section class="stat metric" aria-labelledby="tile-releases">
+    <span class="card-label" id="tile-releases">{{ _("Releases") }}</span>
+    {% if releases is none %}
+    <span class="stat-value">—</span><span class="stat-note">{{ _("Not available just now.") }}</span>
+    {% elif not releases.tags %}
+    <span class="stat-value">0</span><span class="stat-note">{{ _("No tags on the branch.") }}</span>
+    {% else %}
+    {% set latest = releases.tags[0] %}
+    <span class="stat-value">{{ releases.tags|length|number }}</span>
+    <span class="stat-note">{% trans name=latest.name, date=latest.date|day %}Latest: {{ name }}, on <span class="nowrap">{{ date }}</span>{% endtrans %}</span>
+    {% endif %}
+  </section>
+  {% set tile = tiles["code_lines"] %}
+  <section class="stat metric" aria-labelledby="tile-code">
+    <span class="card-label" id="tile-code">{{ _("Code") }}</span>
+    <span class="stat-value">{% trans count=tile.value.numerator, lines=tile.value.numerator|number %}{{ lines }} line{% pluralize %}{{ lines }} lines{% endtrans %}</span>
+    <span class="stat-note">{% trans count=size.languages|length %}in {{ count }} language{% pluralize %}in {{ count }} languages{% endtrans %}</span>
+    <span class="stat-note">{{ change(tile) }}</span>
+    {{ trend(tile) }}
+  </section>
+  {% set tile = tiles["test_share"] %}
+  <section class="stat metric" aria-labelledby="tile-tests">
+    <span class="card-label" id="tile-tests">{{ _("Tests") }}</span>
+    <span class="stat-value">{% if tile.percent is not none %}{{ tile.percent }}%{% else %}—{% endif %}</span>
+    <span class="stat-note">{% trans numerator=tile.value.numerator|number, denominator=tile.value.denominator|number %}{{ numerator }} of {{ denominator }} lines{% endtrans %}</span>
+    {% if tile.value.denominator %}<span class="stat-note">{{ change(tile, points=true) }}</span>{% endif %}
+    {{ trend(tile) }}
+  </section>
+</div>
+
+<section id="timeline" aria-labelledby="timeline-title">
+  <h2 id="timeline-title">{{ _("Timeline") }}</h2>
+  {% if activity is none or activity.first is none %}
+  <p class="muted">{{ _("The history couldn't be read just now; the log says why.") }}</p>
+  {% else %}
+  <p class="muted">{{ _("The branch's whole history, by author date in UTC. Only dates and counts are read: no author or message.") }}</p>
+  <div class="chart-head">
+    <p class="chart-window" data-window-text aria-live="polite"></p>
+    <div class="chart-pan" data-pan hidden>
+      <button type="button" class="icon-button" data-pan-earlier aria-label="{{ _('Earlier') }}">‹</button>
+      <button type="button" class="icon-button" data-pan-later aria-label="{{ _('Later') }}">›</button>
+    </div>
+  </div>
+  <div class="timeline" data-chart="timeline" dir="ltr">
+    <p class="chart-fallback muted">{{ _("The charts need the page's script; their numbers are in the tables below.") }}</p>
+  </div>
+  <div class="release-panel" data-release-panel hidden>
+    <div><span class="card-label">{{ _("Release") }}</span><p class="release-name" data-release-name lang="en" dir="ltr"></p><p class="muted" data-release-meta></p></div>
+    <div><span class="card-label">{{ _("Notes, from the tag") }}</span><p class="release-notes" data-release-notes lang="en" dir="ltr"></p></div>
+  </div>
+  <table class="metric-table">
+    <tbody>
+    <tr><th scope="row">{{ _("First commit") }}</th><td>{{ activity.first.isoformat() }}</td></tr>
+    <tr><th scope="row">{{ _("Latest commit") }}</th><td>{{ activity.latest.isoformat() }} · {% trans count=[(today - activity.latest).days, 0]|max %}{{ count }} day ago{% pluralize %}{{ count }} days ago{% endtrans %}</td></tr>
+    <tr><th scope="row">{{ _("Weeks with a commit") }}</th><td>{% trans active=activity.active_weeks|number, weeks=activity.weeks|number %}{{ active }} of {{ weeks }}{% endtrans %}</td></tr>
+    <tr><th scope="row">{{ _("Longest quiet stretch") }}</th><td>{% if activity.longest_gap %}{% set start, end = activity.longest_gap %}{% trans count=(end - start).days, start=start.isoformat(), end=end.isoformat() %}{{ count }} day, from {{ start }} to {{ end }}{% pluralize %}{{ count }} days, from {{ start }} to {{ end }}{% endtrans %}{% else %}—{% endif %}</td></tr>
+    </tbody>
+  </table>
+  {% if activity.cut %}<p class="muted">{% trans count=history_limit|number %}The timeline shows the latest {{ count }} commits; the counts cover them all.{% endtrans %}</p>{% endif %}
+  <details class="more">
+    <summary>{{ _("Commits per month and per year, as numbers") }}</summary>
+    <table class="metric-table">
+      <thead><tr><th>{{ _("Month") }}</th><th>{{ _("Commits") }}</th></tr></thead>
+      <tbody>{% for month, count in all_months %}<tr><td>{{ month }}</td><td>{{ count|number }}</td></tr>{% endfor %}</tbody>
+    </table>
+    <table class="metric-table">
+      <thead><tr><th>{{ _("Year") }}</th><th>{{ _("Commits") }}</th></tr></thead>
+      <tbody>{% for year, count in activity.years %}<tr><td>{{ year }}</td><td>{{ count|number }}</td></tr>{% endfor %}</tbody>
+    </table>
+  </details>
+  {% endif %}
+</section>
+
+{% if activity and activity.days_start %}
+<section id="calendar" aria-labelledby="calendar-title">
+  <h2 id="calendar-title">{{ _("Activity, day by day") }}</h2>
+  <p class="muted">{{ _("The last 53 weeks, a square per day, shaded by its commits.") }}</p>
+  <div class="calendar-layout">
+    <div class="calendar" data-chart="calendar" dir="ltr">
+      <p class="chart-fallback muted">{{ _("The charts need the page's script; their numbers are in the tables below.") }}</p>
+    </div>
+    <dl class="chart-facts">
+      <dt>{{ _("Weeks with a commit") }}</dt><dd>{% trans active=activity.active_weeks|number, weeks=activity.weeks|number %}{{ active }} of {{ weeks }}{% endtrans %}</dd>
+      <dt>{{ _("Longest quiet stretch") }}</dt><dd>{% if activity.longest_gap %}{% set start, end = activity.longest_gap %}{% trans count=(end - start).days %}{{ count }} day{% pluralize %}{{ count }} days{% endtrans %}{% else %}—{% endif %}</dd>
+      {% if weekday_name %}<dt>{{ _("Busiest weekday") }}</dt><dd>{{ weekday_name }}</dd>{% endif %}
+      <dt>{{ _("Latest commit") }}</dt><dd>{{ activity.latest.isoformat() }}</dd>
+    </dl>
+  </div>
+  <div class="ramp-legend" aria-hidden="true"><span>{{ _("Fewer") }}</span>{% for step in range(5) %}<span class="ramp-swatch heat-{{ step }}"></span>{% endfor %}<span>{{ _("More") }}</span></div>
+  <p class="chart-status muted" data-calendar-status aria-live="polite"></p>
+</section>
+{% endif %}
+
+<section id="types" aria-labelledby="types-title">
+  <h2 id="types-title">{{ _("Commit types") }}</h2>
+  {% set types = report.types %}
+  {% if types is none %}
+  <p class="muted">{{ _("The commit messages couldn't be read just now; the log says why.") }}</p>
+  {% else %}
+  <p class="muted">{% trans matched=types.matched, measured=types.measured %}{{ matched }} of the latest {{ measured }} commit subjects match the target's commit_type_pattern, such as feat(web): add a page.{% endtrans %}</p>
+  {% if not types.used %}
+  <p>{{ _("The repository doesn't appear to use typed commit subjects.") }}</p>
+  {% else %}
+  {% set widest = types.types[0][1] if types.types else 0 %}
+  <ul class="hbars" lang="en" dir="ltr">{% for name, count in types.types %}<li><span class="hbar-label">{{ name }}</span><svg class="hbar-track" viewBox="0 0 100 12" preserveAspectRatio="none" aria-hidden="true"><rect class="series-fill-1" x="0" y="0" height="12" width="{{ (count / widest * 100)|round(1) }}" rx="2"/></svg><span class="hbar-value">{{ count|number }}</span></li>{% endfor %}</ul>
+  {% if types.scopes %}
+  <h3>{{ _("Scopes") }}</h3>
+  <ul class="pills" lang="en" dir="ltr">{% for name, count in types.scopes[:listed] %}<li class="pill">{{ name }} · {{ count }}</li>{% endfor %}</ul>
+  {% endif %}
+  {% endif %}
+  {% endif %}
+</section>
+
+<section id="releases" aria-labelledby="releases-title">
+  <h2 id="releases-title">{{ _("Releases") }}</h2>
+  {% if releases is none %}
+  <p class="muted">{{ _("The releases couldn't be read just now; the log says why.") }}</p>
+  {% elif not releases.tags %}
+  <p class="muted">{{ _("No releases: the branch has no tags.") }}</p>
+  {% else %}
+  <p class="muted">{{ _("The tags that point into the branch's history. A tag gitleaks flags is withheld.") }}</p>
+  <ul class="pills">
+    <li class="pill">{% trans count=releases.tags|length %}{{ count }} release{% pluralize %}{{ count }} releases{% endtrans %}</li>
+    <li class="pill">{% trans count=releases.since_latest %}{{ count }} commit since the latest{% pluralize %}{{ count }} commits since the latest{% endtrans %}</li>
+    {% if releases.median_days is not none %}<li class="pill">{% trans count=releases.median_days %}One every {{ count }} day at the median{% pluralize %}One every {{ count }} days at the median{% endtrans %}</li>{% endif %}
+  </ul>
+  {% call(tag) capped(releases.tags) %}<code>{{ tag.commit[:7] }}</code><span class="grow">{{ tag.name }}{% if tag.message %}<details class="more"><summary>{{ tag.message.split("\n", 1)[0] }}</summary><pre class="release-notes">{{ tag.message }}</pre></details>{% endif %}</span><span class="faint">{{ tag.date|day }}</span>{% endcall %}
+  {% endif %}
+</section>
+
+<section id="change" aria-labelledby="change-title">
+  <h2 id="change-title">{{ _("Where change happens") }}</h2>
+  {% set churn = report.churn %}
+  {% if churn is none %}
+  <p class="muted">{{ _("The history couldn't be read just now; the log says why.") }}</p>
+  {% else %}
+  <p class="muted">{% trans count=churn.commits %}Over the latest {{ count }} commit, merges left out. Only files Codetrail may read are named.{% pluralize %}Over the latest {{ count }} commits, merges left out. Only files Codetrail may read are named.{% endtrans %}</p>
+  <div class="chart-head">
+    <p class="muted">{{ _("Each tile's size is its lines of code; its shade, the commits that changed it.") }}</p>
+    <div class="segmented" role="group" aria-label="{{ _('Group by') }}" data-level-picker hidden>
+      <button type="button" data-level="areas" aria-pressed="false">{{ _("Areas") }}</button>
+      <button type="button" data-level="folders" aria-pressed="false">{{ _("Folders") }}</button>
+      <button type="button" data-level="files" aria-pressed="false">{{ _("Files") }}</button>
+    </div>
+  </div>
+  <div class="heatmap-layout">
+    <div class="heatmap-main">
+      <div class="heatmap" data-chart="heatmap" dir="ltr">
+        <p class="chart-fallback muted">{{ _("The charts need the page's script; their numbers are in the tables below.") }}</p>
+      </div>
+      {% for level, count in churn.left_out.items() %}{% if count %}<p class="muted" data-left-out="{{ level }}" hidden>{% trans count=count %}{{ count }} smaller one isn't drawn.{% pluralize %}{{ count }} smaller ones aren't drawn.{% endtrans %}</p>{% endif %}{% endfor %}
+      <div class="ramp-legend"><span>{{ _("Fewer commits") }}</span>{% for step in range(5) %}<span class="ramp-swatch heat-{{ step }}" aria-hidden="true"></span>{% endfor %}<span>{{ _("more") }}</span><span class="inferred-mark" aria-hidden="true"></span><span>{{ _("Mostly inferred rationale: where an ADR or a README would help most") }}</span></div>
+    </div>
+    <aside class="heat-panel" data-heat-panel aria-live="polite" hidden>
+      <span class="card-label" data-panel-kind></span>
+      <p class="heat-panel-name" data-panel-name lang="en" dir="ltr"></p>
+      <p class="heat-panel-path" data-panel-path lang="en" dir="ltr"></p>
+      <div class="heat-panel-numbers">
+        <div><span class="stat-value" data-panel-commits></span><span class="stat-note">{{ _("commits") }}</span></div>
+        <div><span class="stat-value" data-panel-lines></span><span class="stat-note">{{ _("lines of code") }}</span></div>
+      </div>
+      <div data-panel-rationale hidden>
+        <span class="stat-note">{{ _("Rationale in its guide page") }}</span>
+        <div class="split-bar" aria-hidden="true" data-panel-split><span class="split-documented" data-panel-documented-bar></span><span class="split-inferred" data-panel-inferred-bar></span></div>
+        <p class="split-legend"><span class="documented-text"><span data-panel-documented></span> {{ _("documented") }}</span><span class="inferred-text"><span data-panel-inferred></span> {{ _("inferred") }}</span></p>
+      </div>
+      <span class="stat-note">{{ _("Most changed files in it") }}</span>
+      <ul class="list" data-panel-files lang="en" dir="ltr"></ul>
+      <a data-panel-link hidden></a>
+    </aside>
+  </div>
+  {% if churn.area_months %}
+  <h3>{{ _("Change over time, by area") }}</h3>
+  <p class="muted">{{ _("Commits per month in each guide area over the last year.") }}</p>
+  <div class="grid-scroll">
+    <table class="heat-grid" data-chart="grid">
+      <thead><tr><th scope="col"><span class="visually-hidden">{{ _("Area") }}</span></th>{% for month in churn.months %}<th scope="col">{{ month_names[month[5:]|int - 1] }}{% if loop.first or month[5:] == "01" %} {{ month[:4] }}{% endif %}</th>{% endfor %}</tr></thead>
+      <tbody>
+      {% for page_id, cells in churn.area_months %}
+      <tr><th scope="row" lang="en" dir="ltr">{{ area_titles.get(page_id, page_id) }}</th>{% for count in cells %}{% if count is none %}<td class="heat-unread" data-cell="{{ area_titles.get(page_id, page_id) }} · {{ churn.months[loop.index0] }}: {{ _('not read') }}">–</td>{% else %}<td class="heat-{{ ramp_step(count, grid_highest) }}" data-cell="{{ area_titles.get(page_id, page_id) }} · {{ churn.months[loop.index0] }}: {{ count }}">{{ count if count else "" }}</td>{% endif %}{% endfor %}</tr>
+      {% endfor %}
+      </tbody>
+    </table>
+  </div>
+  <p class="chart-status muted" data-grid-status aria-live="polite"></p>
+  {% endif %}
+  <details class="more">
+  <summary>{{ _("Where change happens, as tables") }}</summary>
+  <h3>{{ _("Guide areas") }}</h3>
+  {% if churn.areas %}
+  <p class="muted">{{ _("An area with much change and mostly inferred rationale is where an ADR or a README would help most.") }}</p>
+  <table class="metric-table">
+    <thead><tr><th>{{ _("Area") }}</th><th>{{ _("Commits") }}</th><th>{{ _("Documented") }}</th><th>{{ _("Inferred") }}</th></tr></thead>
+    <tbody>
+    {% for spot in churn.areas[:listed] %}
+    <tr><td lang="en" dir="ltr"><a href="/pages/{{ spot.page.id }}">{{ spot.page.title }}</a></td><td>{{ spot.commits|number }}</td><td>{{ spot.documented }}</td><td>{{ spot.inferred }}</td></tr>
+    {% endfor %}
+    </tbody>
+  </table>
+  {% else %}
+  <p class="muted">{{ _("Areas are counted once your assistant has written the guide's area pages.") }}</p>
+  {% endif %}
+  {% if churn.files %}
+  <h3>{{ _("Most changed files") }}</h3>
+  <ul class="list" lang="en" dir="ltr">{% for spot in churn.files[:largest_files] %}<li><a class="grow" href="/source/{{ spot.name|urlencode }}">{{ spot.name }}</a><span class="faint">{{ spot.count|number }}</span></li>{% endfor %}</ul>
+  <h3>{{ _("Most changed folders") }}</h3>
+  <ul class="pills" lang="en" dir="ltr">{% for spot in churn.folders[:listed] %}<li class="pill">{{ spot.name }} · {{ spot.count|number }}</li>{% endfor %}</ul>
+  {% endif %}
+  </details>
+  <div class="change-extras">
+  <div>
+  <h3>{{ _("Commit size") }}</h3>
+  {% if churn.median_files is none %}
+  <p class="muted">{{ _("No commits to measure yet.") }}</p>
+  {% else %}
+  <p>{% trans median="%g"|format(churn.median_files), p90="%g"|format(churn.p90_files) %}Files a commit changes: {{ median }} at the median, {{ p90 }} at the 90th percentile.{% endtrans %}</p>
+  <figure class="histogram" dir="ltr">
+    {% for height in bar_heights(churn.size_histogram) %}<div class="histogram-column"><span class="histogram-count">{{ churn.size_histogram[loop.index0]|number }}</span><svg class="histogram-bar" viewBox="0 0 10 100" preserveAspectRatio="none" aria-hidden="true"><rect class="series-fill-1" x="0" y="{{ 100 - height }}" width="10" height="{{ height }}"/></svg><span class="histogram-label">{{ ["1", "2", "3", "4–5", "6–10", "11–20", "21+"][loop.index0] }}</span></div>{% endfor %}
+    <figcaption class="visually-hidden">{{ _("Commits by the files they change") }}</figcaption>
+  </figure>
+  {% endif %}
+  </div>
+  <div>
+  <h3>{{ _("Quiet code") }}</h3>
+  {% if churn.quiet %}
+  <p class="muted">{% trans count=churn.quiet_files, days=quiet_days %}{{ count }} file of code no commit has changed in the last {{ days }} days, by folder.{% pluralize %}{{ count }} files of code no commit has changed in the last {{ days }} days, by folder.{% endtrans %}</p>
+  <ul class="pills" lang="en" dir="ltr">{% for spot in churn.quiet[:listed] %}<li class="pill">{{ spot.name }} · {{ spot.count|number }}</li>{% endfor %}</ul>
+  {% else %}
+  <p class="muted">{% trans days=quiet_days %}Every file of code changed in the last {{ days }} days.{% endtrans %}</p>
+  {% endif %}
+  </div>
+  </div>
+  {% endif %}
+</section>
+
+<section id="size" aria-labelledby="size-title">
+  <h2 id="size-title">{{ _("Code size") }}</h2>
+  <p class="muted">{{ _("The files Codetrail may read, without the excluded ones. A file's language comes from its name; documents are the files matching the target's document_globs, and tests those matching its test_globs.") }}</p>
+  {% if size.languages %}
+  {% set segments = language_segments(size.languages) %}
+  <div class="stack-bar" role="img" aria-label="{% for name, lines, slot, percent in segments %}{% if name == "Other" %}{{ _("Other") }}{% else %}{{ name }}{% endif %} {{ percent }}%{% if not loop.last %}, {% endif %}{% endfor %}"><svg viewBox="0 0 1000 20" preserveAspectRatio="none" aria-hidden="true">{% set ns = namespace(x=0) %}{% for name, lines, slot, percent in segments %}{% set width = (lines / size.code_lines * 1000) if size.code_lines else 0 %}<rect class="series-fill-{{ slot }}" x="{{ ns.x|round(1) }}" y="0" height="20" width="{{ [width - 2, 0]|max|round(1) }}"/>{% set ns.x = ns.x + width %}{% endfor %}</svg></div>
+  <ul class="stack-legend" lang="en" dir="ltr">{% for name, lines, slot, percent in segments %}<li><span class="swatch series-{{ slot }}" aria-hidden="true"></span>{% if name == "Other" %}{{ _("Other") }}{% else %}{{ name }}{% endif %}<span class="faint">{{ percent }}% · {{ lines|number }}</span></li>{% endfor %}</ul>
+  {% if size.code_lines %}
+  <div class="share-bar" role="img" aria-label="{% trans percent=(size.test_lines / size.code_lines * 100)|round|int %}{{ percent }}% of the lines of code are tests{% endtrans %}"><svg viewBox="0 0 100 10" preserveAspectRatio="none" aria-hidden="true"><rect class="series-fill-1" x="0" y="0" height="10" width="{{ (size.test_lines / size.code_lines * 100)|round(1) }}"/></svg></div>
+  {% endif %}
+  <details class="more"><summary>{{ _("Languages, as a table") }}</summary>
+  <table class="metric-table">
+    <thead><tr><th>{{ _("Language") }}</th><th>{{ _("Files") }}</th><th>{{ _("Lines") }}</th></tr></thead>
+    <tbody>
+    {% for row in size.languages[:listed] %}
+    <tr><td lang="en" dir="ltr">{{ row.language }}</td><td>{{ row.files|number }}</td><td>{{ row.lines|number }}</td></tr>
+    {% endfor %}
+    </tbody>
+  </table>
+  </details>
+  {% endif %}
+  <ul class="pills">
+    <li class="pill pill-documented">{% trans count=size.documents.files, files=size.documents.files|number, lines=size.documents.lines|number %}{{ files }} document, {{ lines }} lines{% pluralize %}{{ files }} documents, {{ lines }} lines{% endtrans %}</li>
+    <li class="pill">{% trans count=size.test_lines, lines=size.test_lines|number %}{{ lines }} line of tests{% pluralize %}{{ lines }} lines of tests{% endtrans %}</li>
+    <li class="pill">{% trans count=size.other_files %}{{ count }} other file{% pluralize %}{{ count }} other files{% endtrans %}</li>
+    {% if size.binary_files %}<li class="pill">{% trans count=size.binary_files %}{{ count }} binary file{% pluralize %}{{ count }} binary files{% endtrans %}</li>{% endif %}
+    {% if size.too_large_files %}<li class="pill pill-stale">{% trans count=size.too_large_files %}{{ count }} file too large to count{% pluralize %}{{ count }} files too large to count{% endtrans %}</li>{% endif %}
+  </ul>
+  {% if size.largest %}
+  <h3>{{ _("Largest files") }}</h3>
+  <ul class="list" lang="en" dir="ltr">{% for file in size.largest[:largest_files] %}<li><a class="grow" href="/source/{{ file.path|urlencode }}">{{ file.path }}</a><span class="faint">{{ file.language }} · {{ file.lines|number }}</span></li>{% endfor %}</ul>
+  {% endif %}
+</section>
+
+<section id="facts" aria-labelledby="facts-title">
+  <h2 id="facts-title">{{ _("Facts") }}</h2>
+  {% set inventory = report.inventory %}
+  {% if inventory.since %}<p class="muted">{% trans date=inventory.since.taken_at[:10] %}What Codetrail's extractors found, by kind. Codetrail's history of this repository starts on {{ date }}: packages present then are counted as there from the start.{% endtrans %}</p>{% endif %}
+  {% if inventory.kinds %}
+  <ul class="fact-cards">
+    {% for row in inventory.kinds %}
+    <li class="fact-card">
+      <span class="stat-note" lang="en" dir="ltr">{{ row.kind }}</span>
+      <span><span class="stat-value">{{ row.count|number }}</span> <span class="stat-note">{% if row.change is none %}—{% else %}{{ "%+d"|format(row.change) }}{% endif %}</span></span>
+      <span class="spark" role="img" aria-label="{{ _('Over the last updates') }}: {{ row.trend|join(', ') }}"><svg viewBox="0 0 {{ row.trend|length * 10 }} 24" preserveAspectRatio="none" aria-hidden="true">{% for height in bar_heights(row.trend) %}{% set bar = [height, 8]|max * 0.24 %}<rect class="series-fill-1" x="{{ loop.index0 * 10 + 1 }}" y="{{ (24 - bar)|round(1) }}" width="8" height="{{ bar|round(1) }}" rx="1"/>{% endfor %}</svg></span>
+    </li>
+    {% endfor %}
+  </ul>
+  {% endif %}
+  {% if inventory.arrived %}
+  <h3>{{ _("Dependencies that arrived") }}</h3>
+  {% call(item) capped(inventory.arrived) %}<a class="grow" href="/facts/{{ item.package|urlencode|replace("/", "%2F") }}">{{ item.package }}</a><span class="faint">{{ item.snapshot.taken_at[:10] }} · {{ item.snapshot.commit[:7] }}</span>{% endcall %}
+  {% endif %}
+  {% if inventory.left %}
+  <h3>{{ _("Dependencies that left") }}</h3>
+  {% call(item) capped(inventory.left) %}<span class="grow">{{ item.package }}</span><span class="faint">{{ item.snapshot.taken_at[:10] }} · {{ item.snapshot.commit[:7] }}</span>{% endcall %}
+  {% endif %}
+</section>
+<script type="application/json" data-repository-data>{{ chart_json }}</script>
+{% endif %}
+</div>
+{% endblock %}

codetrail/web/templates/search.html

@@ -0,0 +1,31 @@
+{% extends "base.html" %}
+{% from "layout/icons.html" import icon %}
+{% from "macros.html" import kind_name %}
+{% block title %}{{ _("Search") }}{% endblock %}
+{% block content %}
+<div class="wide">
+<header class="page-head">
+  <h1>{{ _("Search") }}</h1>
+  <form class="search-box full" action="/search" method="get" role="search">
+    {{ icon("search") }}
+    <input type="search" name="q" value="{{ query }}" maxlength="1000" aria-label="{{ _('Search the guide') }}">
+    <button type="submit" class="button small">{{ _("Search") }}</button>
+  </form>
+</header>
+{% if not available %}
+<p class="notice">{{ _("Search isn't available right now. The rest of the guide still works.") }}</p>
+{% elif query and not results %}
+<p class="muted">{% trans query=query %}Nothing in the guide matches “{{ query }}”.{% endtrans %}</p>
+{% endif %}
+{% if results %}
+<ol class="results" lang="en" dir="ltr">
+  {% for result in results %}
+  <li>
+    <a href="{{ result.document.link }}">{{ result.document.title }}</a> <span class="kind" lang="{{ language.code }}" dir="{{ language.direction }}">{{ kind_name(result.document.kind) }}</span>
+    {% if result.snippet %}<p class="snippet">{% for text, matched in result.snippet %}{% if matched %}<mark>{{ text }}</mark>{% else %}{{ text }}{% endif %}{% endfor %}</p>{% endif %}
+  </li>
+  {% endfor %}
+</ol>
+{% endif %}
+</div>
+{% endblock %}

codetrail/web/templates/source.html

@@ -0,0 +1,15 @@
+{% extends "base.html" %}
+{% block title %}{{ path }}{% endblock %}
+{% block content %}
+<header class="page-head">
+  <p class="eyebrow">{{ _("Source") }}</p>
+  <h1 lang="en" dir="ltr">{{ path }}</h1>
+  <p class="meta">{% trans commit=commit[:12] %}At commit {{ commit }}.{% endtrans %}</p>
+</header>
+{% if lines is none %}
+<p class="notice">{{ _("This file isn't text, or is too large to show.") }}</p>
+{% else %}
+<pre class="source" lang="en" dir="ltr">{% for line in lines %}<span id="L{{ loop.index }}"><a class="line" href="#L{{ loop.index }}">{{ loop.index }}</a>{{ line }}
+</span>{% endfor %}</pre>
+{% endif %}
+{% endblock %}

codetrail/web/templates/system.html

@@ -0,0 +1,43 @@
+{% extends "base.html" %}
+{% block title %}{{ _("Your system") }}{% endblock %}
+{% block content %}
+<div class="wide">
+<header class="page-head">
+  <h1>{{ _("Your system") }}</h1>
+  <p class="muted">{{ _("The repository's parts and how they connect, drawn from facts: nothing here is the assistant's guess.") }}</p>
+</header>
+
+<section>
+  {% if diagram.rolled_up %}<p class="muted">{{ _("Too many parts to show one by one: libraries, then folders, are grouped, with the number of connections on each arrow. Every part is listed below.") }}</p>{% endif %}
+  {% include "diagram.html" %}
+  {% include "system_legend.html" %}
+</section>
+
+<section>
+  <h2>{{ _("Parts") }}</h2>
+  {% set headings = {"service": _("Services"), "app": _("Apps"), "library": _("Libraries"), "contract": _("Contracts"), "infrastructure": _("Infrastructure"), "platform": _("Platforms")} %}
+  {% for kind, rows in parts %}
+  <h3>{{ headings.get(kind, kind) }}</h3>
+  <table class="system-parts">
+    <thead><tr><th>{{ _("Part") }}</th><th>{{ _("Folder") }}</th><th>{{ _("Depends on") }}</th><th>{{ _("Called by") }}</th><th>{{ _("Runs on") }}</th></tr></thead>
+    <tbody>
+    {% for row in rows %}
+    <tr>
+      <td lang="en" dir="ltr"><a href="/facts/{{ row.id|urlencode|replace("/", "%2F") }}">{{ row.name }}</a></td>
+      <td lang="en" dir="ltr">{% if row.folder %}<a href="/areas/{{ row.folder|urlencode }}">{{ row.folder }}/</a>{% else %}—{% endif %}</td>
+      <td lang="en" dir="ltr">{{ row.depends_on | join(", ") or "—" }}</td>
+      <td lang="en" dir="ltr">{{ row.called_by | join(", ") or "—" }}</td>
+      <td lang="en" dir="ltr">{{ row.runs_on | join(", ") or "—" }}</td>
+    </tr>
+    {% endfor %}
+    </tbody>
+  </table>
+  {% endfor %}
+</section>
+
+<section>
+  <h2>{{ _("Why each arrow is there") }}</h2>
+  {% include "system_arrows.html" %}
+</section>
+</div>
+{% endblock %}

codetrail/web/templates/system_arrows.html

@@ -0,0 +1,17 @@
+{% set connections = {"depends_on": _("depends on"), "implements": _("implements"), "calls_via": _("calls through"), "deployed_on": _("is deployed on")} %}
+{% if diagram.arrows %}
+<ul class="list system-arrows">
+  {% for arrow in diagram.arrows %}
+  <li>
+    <span class="grow"><span lang="en" dir="ltr">{{ arrow.source }}</span> {{ connections.get(arrow.kind, arrow.kind) }} <span lang="en" dir="ltr">{{ arrow.target }}</span></span>
+    {% if arrow.evidence == "matched" %}
+      <span class="faint">{{ _("matched by name:") }} <span lang="en" dir="ltr">{{ arrow.names | join(" · ") }}</span>{% if arrow.link %} (<a href="{{ arrow.link }}" lang="en" dir="ltr">{{ _("source") }}</a>){% endif %}</span>
+    {% elif arrow.link %}
+      <a class="faint" href="{{ arrow.link }}" lang="en" dir="ltr">{{ arrow.link.removeprefix("/source/") }}</a>
+    {% endif %}
+  </li>
+  {% endfor %}
+</ul>
+{% else %}
+<p class="muted">{{ _("No connections between the parts were found.") }}</p>
+{% endif %}

codetrail/web/templates/system_legend.html

@@ -0,0 +1,9 @@
+<dl class="legend" aria-label="{{ _('Legend') }}">
+  <div><dt><span class="legend-shape legend-rounded" aria-hidden="true"></span></dt><dd>{{ _("Service or app") }}</dd></div>
+  <div><dt><span class="legend-shape" aria-hidden="true"></span></dt><dd>{{ _("Library") }}</dd></div>
+  <div><dt><span class="legend-shape legend-document" aria-hidden="true"></span></dt><dd>{{ _("Contract") }}</dd></div>
+  <div><dt><span class="legend-shape legend-double" aria-hidden="true"></span></dt><dd>{{ _("Infrastructure") }}</dd></div>
+  <div><dt><span class="legend-shape legend-stadium" aria-hidden="true"></span></dt><dd>{{ _("Platform") }}</dd></div>
+  <div><dt><span class="legend-line" aria-hidden="true"></span></dt><dd>{{ _("Found in a file you can open") }}</dd></div>
+  <div><dt><span class="legend-line legend-dashed" aria-hidden="true"></span></dt><dd>{{ _("Matched by name: likely, not certain") }}</dd></div>
+</dl>

codetrail/web/templates/update_log.html

@@ -0,0 +1,30 @@
+{# The update's steps, for the update panel (design section 15.4). Titles and reasons come from the assistant and
+   the repository, so they are only ever autoescaped text. #}
+{% macro used(step) -%}
+<span class="muted">{% if step.provider %} · {{ step.provider }} · {{ step.model or _("default model") }}{% endif %}{% if step.tokens %} · {{ step.tokens|tokens }} {{ _("tokens") }}{% endif %}{% if step.cost_usd %} · {{ step.cost_usd|dollars }}{% endif %}</span>
+{%- endmacro %}
+{% for step in steps %}
+{% if step.step == "facts" %}
+<li class="update-line">{{ _("Refreshing the facts (free)…") }}</li>
+{% elif step.step == "facts_recorded" %}
+<li class="update-line">{% if step.changes %}{% trans count=step.changes %}The facts are refreshed: one changed.{% pluralize %}The facts are refreshed: {{ count }} changed.{% endtrans %}{% else %}{{ _("The facts are refreshed: none changed.") }}{% endif %}</li>
+{% elif step.step == "plan" %}
+<li class="update-line">{{ _("Planning the outline…") }}</li>
+{% elif step.step == "planned" %}
+<li class="update-line done">{% trans count=step.pages %}Planned one new page.{% pluralize %}Planned {{ count }} new pages.{% endtrans %}{{ used(step) }}</li>
+{% elif step.step == "page" %}
+<li class="update-line">{% if step.attempt != 1 and step.revise %}{% trans title=step.title %}Revising “{{ title }}” again, with its problems…{% endtrans %}{% elif step.attempt != 1 %}{% trans title=step.title %}Writing “{{ title }}” again, with its problems…{% endtrans %}{% elif step.revise and step.reason == "update" %}{% trans title=step.title, count=step.changed %}Revising “{{ title }}” (one of its facts changed in this update)…{% pluralize count %}Revising “{{ title }}” ({{ count }} of its facts changed in this update)…{% endtrans %}{% elif step.revise %}{% trans title=step.title %}Revising “{{ title }}” (catching up: its facts changed after it was written)…{% endtrans %}{% elif step.reason == "update" %}{% trans title=step.title, count=step.changed %}Writing “{{ title }}” (one of its facts changed in this update)…{% pluralize count %}Writing “{{ title }}” ({{ count }} of its facts changed in this update)…{% endtrans %}{% elif step.reason == "new" %}{% trans title=step.title %}Writing “{{ title }}” (a new page)…{% endtrans %}{% elif step.reason == "outline" %}{% trans title=step.title %}Writing “{{ title }}” (its outline entry changed)…{% endtrans %}{% elif step.reason == "catching_up" %}{% trans title=step.title %}Writing “{{ title }}” (catching up: its facts changed after it was written)…{% endtrans %}{% else %}{% trans title=step.title %}Writing “{{ title }}”…{% endtrans %}{% endif %}</li>
+{% elif step.step == "page_written" %}
+<li class="update-line done">{% if step.unchanged %}{% trans title=step.title %}“{{ title }}” needed no change.{% endtrans %}{% elif step.revise %}{% trans title=step.title %}Revised “{{ title }}”.{% endtrans %}{% else %}{% trans title=step.title %}Wrote “{{ title }}”.{% endtrans %}{% endif %}{{ used(step) }}</li>
+{% elif step.step == "page_failed" %}
+<li class="update-line failed">{% trans title=step.title, reason=step.reason %}“{{ title }}” wasn’t written: {{ reason }}{% endtrans %}</li>
+{% elif step.step == "page_later" %}
+<li class="update-line">{% trans title=step.title %}“{{ title }}” waits for the next update: the budget is spent.{% endtrans %}</li>
+{% elif step.step == "page_skipped" %}
+<li class="update-line">{% trans title=step.title %}“{{ title }}” is skipped: it failed last time, and nothing in it changed since.{% endtrans %} {% trans name=target %}To write it anyway: <code>codetrail update {{ name }} --retry-failed</code>{% endtrans %}</li>
+{% elif step.step == "digest" %}
+<li class="update-line">{{ _("Writing the digest…") }}</li>
+{% elif step.step == "committed" %}
+<li class="update-line done">{% trans count=step.pages %}Saved one page to the guide.{% pluralize %}Saved {{ count }} pages to the guide.{% endtrans %}{% if step.failed %} {% trans count=step.failed %}One page wasn’t written.{% pluralize %}{{ count }} pages weren’t written.{% endtrans %}{% endif %}{% if step.later %} {% trans count=step.later %}One waits for the next update.{% pluralize %}{{ count }} wait for the next update.{% endtrans %}{% endif %}</li>
+{% endif %}
+{% endfor %}

codetrail/web/trend.py

@@ -0,0 +1,22 @@
+"""Trend lines (design section 18.4): SVG points drawn on the server from numbers only."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+PADDING = 2
+
+
+def trend_points(values: Sequence[float], width: int = 120, height: int = 32) -> str:
+    """The `points` of a polyline, oldest value on the left, the lowest at the bottom; one value draws a flat line."""
+    if not values:
+        return ""
+    low, high = min(values), max(values)
+
+    def y(value: float) -> float:
+        middle = 0.5 if high == low else (high - value) / (high - low)
+        return PADDING + (height - 2 * PADDING) * middle
+
+    drawn = list(values) if len(values) > 1 else [values[0], values[0]]
+    step = (width - 2 * PADDING) / (len(drawn) - 1)
+    return " ".join(f"{PADDING + index * step:.1f},{y(value):.1f}" for index, value in enumerate(drawn))