Security posture

Security evidence age

<forma-security-evidence-age>

Makes security evidence freshness and staleness explicit.

Authoring tag
<forma-security-evidence-age>
Behavior owner
Aegis / application
Canonical source
patterns/security-evidence-age.html

Purpose

Security evidence age lists evidence records with their freshness written in text: current with its observation date, stale with the reason it was invalidated, or never observed. Stale evidence cannot silently support a security conclusion, so each entry states its state explicitly next to its stable ID. Tutela decides whether evidence is current or stale; Forma presents that result and does not compute ages or thresholds.

Use when

  • A security review needs to show which evidence is still current for a release.
  • Evidence has been invalidated, for example by a boundary change, and readers must see why.
  • Each evidence record needs a deep link and a visible freshness state.

Avoid when

Behavior to know

  • Each entry is a stable-ID link followed by a text line starting with the state (Current, Stale, Not observed).
  • Entries carry a start border and secondary surface so they read as separate records; the border does not change with state.
  • data-state records the machine state and is not used as the only cue.
  • Dates use time elements with machine-readable values.

Basic example

The smallest correct markup: the canonical pattern from patterns/security-evidence-age.html inside its public tag. Copy this first, then adapt labels, names and state.

Canonical

Minimal security evidence age

Rendered from the canonical pattern file.

Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.

Evidence freshness

HTML · Minimal security evidence age Raw HTML for HTML · Minimal security evidence age
<forma-security-evidence-age class="forma-component-tag">
<section class="forma-evidence-age" aria-labelledby="evidence-age-title"><h2 id="evidence-age-title">Evidence freshness</h2><ul><li data-state="current"><a href="#SEC-EVD-042">SEC-EVD-042</a><span>Current · observed 24 Sep 2026</span></li><li data-state="stale"><a href="#SEC-EVD-031">SEC-EVD-031</a><span>Stale · invalidated by boundary change</span></li></ul></section>
</forma-security-evidence-age>

Click or tap the code once to select all of it, then copy.

Examples

Scenario

Current, stale and never observed

Three evidence records in three different states. The never-observed entry is shown explicitly instead of being omitted or treated as stale.

Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.

Evidence freshness for SEC-INV-014

  • SEC-EVD-042Current · observed against this release artifact
  • SEC-EVD-031Stale · invalidated by the session-store boundary change on
  • SEC-EVD-050Not observed · no run exists for this artifact
HTML · Current, stale and never observed Raw HTML for HTML · Current, stale and never observed
<forma-security-evidence-age class="forma-component-tag">
  <section class="forma-evidence-age" aria-labelledby="security-evidence-age-mixed-title">
    <h2 id="security-evidence-age-mixed-title">Evidence freshness for SEC-INV-014</h2>
    <ul>
      <li data-state="current"><a href="#SEC-EVD-042">SEC-EVD-042</a><span>Current · observed <time datetime="2026-09-29">29 Sep 2026</time> against this release artifact</span></li>
      <li data-state="stale"><a href="#SEC-EVD-031">SEC-EVD-031</a><span>Stale · invalidated by the session-store boundary change on <time datetime="2026-09-21">21 Sep 2026</time></span></li>
      <li data-state="unknown"><a href="#SEC-EVD-050">SEC-EVD-050</a><span>Not observed · no run exists for this artifact</span></li>
    </ul>
  </section>
</forma-security-evidence-age>

Click or tap the code once to select all of it, then copy.

Scenario

All evidence invalidated

Every record is stale after a dependency upgrade. The heading states the count so the situation is clear before reading the list.

Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.

2 of 2 evidence records are stale

  • SEC-EVD-018Stale · invalidated by the TLS library upgrade
  • SEC-EVD-019Stale · invalidated by the TLS library upgrade
HTML · All evidence invalidated Raw HTML for HTML · All evidence invalidated
<forma-security-evidence-age class="forma-component-tag">
  <section class="forma-evidence-age" aria-labelledby="security-evidence-age-all-stale-title">
    <h2 id="security-evidence-age-all-stale-title">2 of 2 evidence records are stale</h2>
    <ul>
      <li data-state="stale"><a href="#SEC-EVD-018">SEC-EVD-018</a><span>Stale · invalidated by the TLS library upgrade</span></li>
      <li data-state="stale"><a href="#SEC-EVD-019">SEC-EVD-019</a><span>Stale · invalidated by the TLS library upgrade</span></li>
    </ul>
  </section>
</forma-security-evidence-age>

Click or tap the code once to select all of it, then copy.

Mobile

Each mobile example renders in its own document inside a real narrow viewport, so Forma's media and container queries run exactly as they would on a phone. Choose a width to compare.

Mobile example

Evidence freshness on a phone

Long reasons and IDs at phone width.

Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.

Viewport width

Frames narrower than the selected width show the component at the width available.

What changes at narrow widths

  • The list is a single-column grid at every width, so entries stack vertically with a 0.5rem gap.
  • Explanations use overflow-wrap: anywhere, so long reasons and dates wrap without horizontal scrolling.
  • Each entry's ID link sits on its own line above the explanation, giving a clear tap target.
  • Orientation changes only reflow the text lines.
HTML · Evidence freshness on a phone Raw HTML for HTML · Evidence freshness on a phone
<forma-security-evidence-age class="forma-component-tag">
  <section class="forma-evidence-age" aria-labelledby="security-evidence-age-mobile-title">
    <h2 id="security-evidence-age-mobile-title">Evidence freshness</h2>
    <ul>
      <li data-state="current"><a href="#SEC-EVD-042">SEC-EVD-042</a><span>Current · observed <time datetime="2026-09-29">29 Sep 2026</time></span></li>
      <li data-state="stale"><a href="#SEC-EVD-031">SEC-EVD-031</a><span>Stale · invalidated by the change to the authorization boundary for imported organizations</span></li>
    </ul>
  </section>
</forma-security-evidence-age>

Click or tap the code once to select all of it, then copy.

Baseline

Mobile · 320px

The canonical pattern in a true 320px viewport, the minimum width every Forma component must support without page-level horizontal scrolling.

Static specimen. Its links point to placeholder destinations that do not exist on this site. Its controls are shown for their markup and appearance and cannot be operated here.

Viewport width

Frames narrower than the selected width show the component at the width available.

API and configuration

Forma components have no JavaScript API. Their public contract is the markup: native elements and attributes you write, and the CSS hooks below. The CSS hook table is generated from the built stylesheet, so it always matches the shipped implementation.

Native and ARIA attributes
AttributeOnValuesDefaultDescription
aria-labelledbysection.forma-evidence-ageid of the heading—Names the region by its heading.
data-statelicurrent | stale | unknown—Machine freshness state from Tutela. Not styled by Forma CSS; the entry text must state it.
hrefastable record URL or #ID—Deep link to the evidence record.
datetimetimeISO 8601—Machine-readable observation or invalidation date.
CSS hooks (derived from dist/all.css)
HookKindValues or defaultDescription
.forma-evidence-ageBlock class—Root section: bordered, padded primary surface. Its list is an unstyled single-column grid; each entry is a grid with a 0.3rem start border in the current text color and a secondary surface, and its span wraps anywhere.
Keyboard interaction
KeysResult
Tab / Shift+TabMoves between evidence links.
EnterFollows the focused link.
Events
EventDescription
—No events.

Form behavior

Not a form control.

States

Security evidence age states
StateHow it is expressedPresentation
Currentdata-state="current" + text CurrentEvidence is valid for this subject; the observation date is shown.
Staledata-state="stale" + text StaleEvidence was invalidated; the reason is shown.
Not observeddata-state="unknown" + textNo evidence exists yet for this subject; shown explicitly.

Accessibility

Forma provides

  • Presents each record as a list item with its state in text; the start border is structural, not a state color.
  • Keeps the list semantic, so the number of records is announced.
  • Wraps long content at 320px.

Your application supplies

  • Start each explanation with the state word so it is read first.
  • Explain why evidence is stale; a date alone does not tell the reader what changed.
  • Keep stale and unobserved evidence visible; never filter it out of a security view.
  • Redact sensitive evidence details before rendering.

Responsive behavior

  • The section has zero minimum inline size; the list is a single-column grid at every width.
  • Text wraps anywhere inside each entry. No breakpoints are needed.

Motion

  • No animation: freshness is static text and state changes replace it immediately.

Usage guidance

Do

  • Use the same state vocabulary as Tutela (Current, Stale).
  • Include the observation date for current evidence.

Avoid

  • Color-coding ages without text.
  • Computing "days old" in the UI as a substitute for Tutela's stale/current decision.

Verification specimens

Generated fault-injection specimens expose content, spacing, color-cue, and reduced-effective-contrast risks. They screen presentation robustness as engineering screens without claiming human-subject validation.