secondbrain-py 0.2.1__py3-none-any.whl

brain/quartz_overrides/quartz/styles/brain/_explorer.scss

@@ -0,0 +1,142 @@
+// Brain Explorer extras — P4.2 of the Wiki UX Overhaul.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_explorer.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via `custom.scss`'s
+// `@use "./brain/explorer"` line. Loaded after `_sidebar.scss` so any
+// sticky-header / surface-tier rules in the sidebar partial paint
+// underneath these explorer-content children.
+//
+// Scope of this file:
+//
+//   * `.brain-explorer-ingested-toggle` — the "Show ingested" /
+//     "Hide ingested" pill that the inline script injects as the
+//     first child of `.explorer-content`. Drives state via
+//     `[data-active="true"]` (set by the inline script on toggle).
+//   * `.brain-explorer-month-header` — month-group header `<li>`
+//     injected by the P4.3 `buildMonthGroupedChildren` pass when
+//     descending into `_ingested/krisp/` or `_ingested/gmail/`.
+//   * `.brain-explorer-month-date` / `.brain-explorer-month-title` —
+//     the two-span structure inside each grouped file's link, so
+//     the date prefix can render in dimmed tabular numerals while
+//     the title keeps the regular ink color.
+//
+// Scope NOT covered here:
+//
+//   * Folder-count badges, explorer indent guides, sticky search
+//     header — owned by `_sidebar.scss` (Lane C).
+//   * The `<ul class="explorer-ul">` tree itself — owned by upstream
+//     `quartz/components/styles/explorer.scss`.
+//
+// Tokens consumed (all from `_tokens.scss`):
+//
+//   * `--surface-1`     — toggle background when inactive
+//   * `--accent`        — toggle bg when active
+//   * `--rule`          — toggle border
+//   * `--ink-1` / `--ink-2` — text colors
+//   * `--motion-fast`   — hover transition
+
+.explorer .brain-explorer-ingested-toggle {
+  // Layout — full-width pill button so it reads as a control rail
+  // rather than a tag-pill. Sits above the tree but inside the
+  // collapsible explorer-content region.
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  margin: 0 0 0.5rem 0;
+  padding: 0.3rem 0.6rem;
+  font: inherit;
+  font-size: 0.75rem;
+  letter-spacing: 0.04em;
+  // brain: lowercase by default so the chip reads "show ingested"
+  // not "SHOW INGESTED" — matches the P3.4 lowercase-tag contract.
+  text-transform: none;
+  cursor: pointer;
+  background: transparent;
+  color: var(--ink-2, var(--gray));
+  border: 1px solid var(--rule, var(--lightgray));
+  border-radius: 999px;
+  transition:
+    background var(--motion-fast, 120ms) ease,
+    color var(--motion-fast, 120ms) ease,
+    border-color var(--motion-fast, 120ms) ease;
+
+  &:hover,
+  &:focus-visible {
+    background: var(--accent-soft, var(--highlight));
+    color: var(--ink-1, var(--darkgray));
+    border-color: var(--accent, var(--secondary));
+    outline: none;
+  }
+
+  // Active state — toggle ON, ingested visible. Reverse fg/bg so
+  // the active read matches the pattern used by the P3.2 search
+  // chips and the graph-view filter chips.
+  &[data-active="true"] {
+    background: var(--accent, var(--secondary));
+    color: var(--light, white);
+    border-color: var(--accent, var(--secondary));
+
+    &:hover,
+    &:focus-visible {
+      // Slight darken on hover so the active chip still gives
+      // pressed-state feedback.
+      background: color-mix(in srgb, var(--accent, var(--secondary)) 85%, black);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------
+// P4.3 — Per-source month grouping inside `_ingested/{krisp,gmail}/`.
+// The inline script (`buildMonthGroupedChildren`) injects a header
+// `<li>` per month plus rewrites each file's link text into a
+// `<span.brain-explorer-month-date> · <span.brain-explorer-month-title>`
+// pair. Styling lives here so the upstream `explorer.scss` partial
+// stays unforked.
+// ---------------------------------------------------------------------
+
+.explorer .brain-explorer-month-header {
+  // Appearance — dimmed small-caps section heading that reads as a
+  // separator rather than as a navigable row. No hover/active state
+  // because the header is non-interactive (`role="presentation"`).
+  list-style: none;
+  margin: 0.6rem 0 0.15rem 0;
+  padding: 0.1rem 0;
+  font-family: var(--bodyFont, inherit);
+  font-size: 0.7rem;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--ink-3, var(--gray));
+  // Subtle hairline below the label so the eye picks up the section
+  // boundary without competing with the file rows.
+  border-bottom: 1px solid var(--rule, var(--lightgray));
+  // First header in a folder-outer flush against the top — drop the
+  // top margin so it doesn't collide with the parent folder's
+  // padding/indent.
+  &:first-child {
+    margin-top: 0.1rem;
+  }
+}
+
+.explorer .brain-explorer-month-date {
+  // Tabular numerals so `Mar 9` / `Apr 15` line up vertically when
+  // stacked. Lighter weight + dimmed color so the date prefix feels
+  // like marginalia, not the primary read.
+  display: inline-block;
+  min-width: 2.6rem;
+  margin-right: 0.25rem;
+  font-variant-numeric: tabular-nums;
+  font-feature-settings: "tnum" 1;
+  font-size: 0.78rem;
+  color: var(--ink-3, var(--gray));
+  white-space: nowrap;
+}
+
+.explorer .brain-explorer-month-title {
+  // The title carries the regular ink color so it remains the primary
+  // read in the row. No layout overrides — let the link's own padding
+  // and ellipsis-truncation rules from the upstream `explorer.scss`
+  // continue to apply.
+  color: inherit;
+}

brain/quartz_overrides/quartz/styles/brain/_home.scss

@@ -0,0 +1,182 @@
+// Brain home page card grid — Lane C of the 2026 commonplace-book redesign.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_home.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via `custom.scss`'s
+// `@use "./brain/home"` line.
+//
+// Scope of this file:
+//
+//   * Detect the home page via `body[data-slug="index"]` (Quartz
+//     stamps the slug onto `<body>` from `renderPage.tsx`).
+//   * Inside the article body's top-level `<ul>` lists, render the
+//     direct child `<li>` items as a responsive card grid.
+//   * Cards: `--surface-1` background, `--shadow-md` on hover, accent
+//     border on hover, generous padding.
+//   * Wiki + ingested links INSIDE a card opt out of Lane B's
+//     underline + box-shadow source rail — the card itself IS the
+//     affordance, so the inner link should read as plain text.
+//
+// CSS-only — no markdown change. Degrades to a vertical list cleanly
+// when the assumed `<ul>` shape isn't present (for a future home doc
+// that uses different markup).
+//
+// Tokens consumed (from `_tokens.scss`):
+//   * `--surface-1` — card background
+//   * `--shadow-sm` / `--shadow-md` — resting + hover elevation
+//   * `--rule` — card border (resting)
+//   * `--accent-strong` — card border on hover
+//   * `--ink-0` / `--ink-1` / `--ink-2` — text + supporting copy
+//   * `--motion-fast` / `--motion-mid` / `--motion-easing` — transitions
+
+// ---------------------------------------------------------------------------
+// 1. Card grid layout — only on the home page
+// ---------------------------------------------------------------------------
+//
+// The home `index.md` is structured as `<h2>` section headings followed
+// by `<ul>` lists where each `<li>` contains a wiki/ingested link plus
+// a description (`<a>...</a> — text`). We turn each top-level `<ul>`
+// into a CSS grid, with each `<li>` becoming a card.
+//
+// Why not target h2-anchored sections individually: h2 + ul is a
+// repeated pattern (Doors, Topic clusters, etc.), and they all share
+// the same card treatment. Repainting every `<ul>` inside the article
+// is simpler and stays consistent if more sections land later.
+//
+// Why CSS-only: the plan flagged this explicitly — markdown stays
+// human-edited and unsurprising; no markdown rewrite, no JS dependency.
+// The grid degrades to a vertical list (the default `<ul>` rendering)
+// in any browser that ignores `display: grid`.
+
+body[data-slug="index"] {
+  article.popover-hint > ul,
+  // brain: also catch nested .popover-hint wrappers (Quartz's article
+  // body is `<article class="popover-hint">`, but we name both forms
+  // for resilience against future renderPage.tsx changes).
+  article > ul {
+    list-style: none;
+    padding: 0;
+    margin: 0.6rem 0 1.6rem 0;
+
+    // Responsive grid: 3 columns at desktop, 2 at tablet, 1 below.
+    // `auto-fit` + `minmax(240px, 1fr)` would also work but explicit
+    // breakpoints match the plan's "3/2/1" spec exactly and read
+    // clearly in devtools.
+    display: grid;
+    gap: 0.8rem;
+    grid-template-columns: 1fr;
+
+    @media (min-width: 768px) {
+      grid-template-columns: repeat(2, 1fr);
+    }
+    @media (min-width: 1024px) {
+      grid-template-columns: repeat(3, 1fr);
+    }
+
+    // Each list item becomes a card.
+    > li {
+      box-sizing: border-box;
+      position: relative;
+      background: var(--surface-1);
+      border: 1px solid var(--rule);
+      border-radius: 8px;
+      padding: 1.2rem;
+      box-shadow: var(--shadow-sm);
+      color: var(--ink-1);
+      line-height: 1.5;
+      list-style: none;
+      cursor: pointer;
+      transition:
+        transform var(--motion-mid) var(--motion-easing),
+        box-shadow var(--motion-mid) var(--motion-easing),
+        border-color var(--motion-mid) var(--motion-easing);
+
+      &:hover {
+        transform: translateY(-2px);
+        box-shadow: var(--shadow-md);
+        border-color: var(--accent-strong);
+      }
+
+      // The leading wiki/ingested link inside the card reads as the
+      // card title — promote its visual weight.
+      //
+      // Stretched-link pattern: the leading `<a>` paints an invisible
+      // `::before` overlay across the entire card so a click anywhere
+      // in the card follows the link. Markdown stays as `<li>emoji
+      // <a>title</a> — desc</li>` (no markup change), and the link's
+      // accessible name still comes from its text. Tradeoff: text
+      // selection inside the card requires shift-click (same as
+      // Bootstrap's `.stretched-link`); acceptable here because the
+      // card's primary affordance is "navigate", not "read & copy".
+      > a:first-child {
+        display: inline;
+        font-family: var(--displayFont);
+        font-size: var(--fs-md);
+        font-weight: 600;
+        color: var(--ink-0);
+        margin-right: 0.25em;
+
+        &::before {
+          content: "";
+          position: absolute;
+          inset: 0;
+          border-radius: inherit;
+          z-index: 1;
+        }
+      }
+
+      // Tag chips inside a card stay independently clickable — float
+      // them above the stretched-link overlay so the chip's own click
+      // target wins over the card-wide link.
+      a.tag-link {
+        position: relative;
+        z-index: 2;
+      }
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 2. Opt cards out of Lane B link-kind chrome
+// ---------------------------------------------------------------------------
+//
+// Lane B's `_links.scss` paints `[data-brain-link-kind="wiki"]` with a
+// terracotta underline + the `a.internal` reset, and
+// `[data-brain-link-kind="ingested"]` with the source-tinted left
+// rail. Inside a card, both treatments compete with the card's own
+// hover affordance — the card lifts, that's the affordance, the
+// link should read as plain card title text.
+//
+// Higher specificity than Lane B (adds the `body[data-slug="index"]`
+// + `> li > a` chain) so this override wins without `!important`.
+//
+// brain (Lane C audit fix 2026-05-02): exclude `.tag-link` from the
+// reset. Tag chips (rendered by `Component.TagList` and inline
+// `[[tags/x]]` wiki-links) carry both `class="internal"` AND
+// `class="tag-link"`. Without the `:not(.tag-link)` filter the
+// reset blew away Lane B's pill chrome (background, border-radius,
+// padding) — leaving a bare-text "tag" in the card. The chip *is*
+// the affordance, the card lift is complementary; both should
+// survive.
+
+body[data-slug="index"] article ul > li > a[data-brain-link-kind="wiki"]:not(.tag-link),
+body[data-slug="index"] article ul > li > a[data-brain-link-kind="ingested"]:not(.tag-link),
+body[data-slug="index"] article ul > li > a.internal:not(.tag-link) {
+  text-decoration: none;
+  background: transparent;
+  border-radius: 0;
+  padding: 0;
+  // Source-rail box-shadow reset for ingested kind.
+  box-shadow: none;
+
+  &:hover {
+    text-decoration-thickness: 0;
+    box-shadow: none;
+  }
+}
+
+// Tag-link chips inside cards stay as chips (the chip *is* the
+// affordance, and the card's hover lift complements rather than
+// competes with the chip's own micro-interaction). The
+// `:not(.tag-link)` filter on the reset above is what preserves
+// them — without it Lane B's pill chrome would be wiped.

brain/quartz_overrides/quartz/styles/brain/_links.scss

@@ -0,0 +1,322 @@
+// Brain wiki — link type system styles (Lane B, the headline complaint).
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_links.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via
+// `custom.scss`'s `@use "./brain/links"` line.
+//
+// Five distinct visual treatments — one per link kind. The
+// `data-brain-link-kind` attribute is stamped at build time by the
+// `linkKindMark.ts` transformer, which keys off the URL pattern
+// (and the `data-brain-derived` attribute already stamped by
+// `derivedFenceMark.ts` for evidence edges). For ingested links we
+// also read `data-brain-source` (krisp/slack/gmail/manual), which is
+// stamped at runtime by `linkSourceTag.js` because the source segment
+// lives in the URL path but extracting it at build time would require
+// a per-doc lookup.
+//
+// Token contract — every color, motion timing, and surface here is
+// pulled from `_tokens.scss` so a future palette swap propagates
+// automatically. Tokens consumed:
+//
+//   * `--accent-soft`, `--accent-strong`  — wiki underline + tag-chip hover
+//   * `--ink-2`                            — external dotted underline + derived dashed underline
+//   * `--surface-2`                        — tag-chip resting background
+//   * `--motion-fast`, `--motion-easing`   — universal hover transitions
+//   * `--brain-source-{krisp,slack,gmail,manual}` — ingested left-rail color
+//
+// Underline pattern — uses `text-decoration-thickness` +
+// `text-underline-offset` (2020+ CSS) instead of `border-bottom` so:
+//   * Descenders (`p`, `g`, `y`, `j`) aren't clipped by the rule.
+//   * Underline thickness scales with `font-size` automatically.
+//   * The underline can be transitioned (`text-decoration-thickness`
+//     is animatable in modern browsers; `border-bottom-width` is too,
+//     but border-bottom adds layout-shift risk via the box model).
+//
+// Selector strategy — every rule keys off `[data-brain-link-kind=...]`
+// rather than `.internal` / `.external` / `.tag-link` so the styling
+// is decoupled from Quartz's internal class naming. Stock Quartz
+// classes survive (we don't strip them) but they aren't used as
+// selectors here.
+//
+// brain a11y note: screen readers (NVDA / JAWS / VoiceOver / Chromium-
+// derived) WILL announce the "↗" content of the external-link
+// `::after` rule — CSS pseudo-element `content` is NOT auto-aria-
+// hidden, contrary to the common myth. Stock Quartz's SVG icon had
+// `aria-hidden="true"` for this reason; once we disable it (in
+// `quartz.config.ts` via `externalLinkIcon: false`, to avoid double-
+// arrow rendering with the `::after` glyph), the announcement
+// returns. Accepted tradeoff — the alternative is reverting to
+// stock's SVG and losing CSS color/opacity/transition control over
+// the indicator. Revisit if a11y feedback surfaces.
+
+// Feature flag for the universal visited-state desaturation. Default
+// on; flip to `false` if testing reveals the saturate(0.7) filter
+// muddies the design or interacts poorly with a future color tweak.
+// `!default` means a downstream `@use "./brain/links" with (...)`
+// can override without editing this file.
+$enable-visited-desaturation: true !default;
+
+// ---------------------------------------------------------------------------
+// 1. wiki — internal links to other vault notes (the most common kind)
+// ---------------------------------------------------------------------------
+//
+// Subtle terracotta underline with a small offset so descenders
+// breathe. Hover thickens the underline and shifts to the full-
+// strength accent — a tactile-feeling micro-interaction that signals
+// "this is clickable" without shouting.
+a[data-brain-link-kind="wiki"] {
+  // brain: stock Quartz `quartz/styles/base.scss` paints `a.internal`
+  // with `background-color: var(--highlight)`, `padding: 0 0.1rem`, and
+  // `border-radius: 5px` — a chunky 12%-alpha terracotta pill. Lane B's
+  // wiki kind has equal specificity (0,1,1) but doesn't redeclare those
+  // three properties, so the pill bleeds through. Reset them explicitly
+  // here so the redesign's subtle underline reads as intended.
+  background: transparent;
+  border-radius: 0;
+  padding: 0;
+  text-decoration: underline;
+  text-decoration-color: var(--accent-soft);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.18em;
+  // brain: `text-decoration-skip-ink: auto` is the browser default in
+  // modern engines but spell it out so descenders are explicitly
+  // skipped (no underline crossing through `g`/`y`/`p`).
+  text-decoration-skip-ink: auto;
+  transition:
+    text-decoration-thickness var(--motion-fast) var(--motion-easing),
+    text-decoration-color var(--motion-fast) var(--motion-easing);
+
+  &:hover {
+    text-decoration-thickness: 2px;
+    text-decoration-color: var(--accent-strong);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 2. external — http(s)/mailto links that leave the vault
+// ---------------------------------------------------------------------------
+//
+// Dotted underline in the muted ink color signals "different
+// destination" without competing with wiki links for attention.
+// The trailing `↗` arrow is the universal "leaves this site"
+// affordance (Wikipedia, MDN, GOV.UK conventions).
+a[data-brain-link-kind="external"] {
+  text-decoration: underline;
+  text-decoration-style: dotted;
+  text-decoration-color: var(--ink-2);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.18em;
+  text-decoration-skip-ink: auto;
+  transition:
+    text-decoration-thickness var(--motion-fast) var(--motion-easing),
+    text-decoration-color var(--motion-fast) var(--motion-easing);
+
+  &:hover {
+    text-decoration-thickness: 2px;
+    text-decoration-color: var(--accent-strong);
+  }
+
+  // brain: external-link arrow indicator. Inline-baseline alignment
+  // keeps it riding on the text baseline; `font-size: 0.85em` shrinks
+  // it just enough to read as an icon, not a glyph.
+  &::after {
+    content: "↗";
+    font-size: 0.85em;
+    margin-left: 0.15em;
+    opacity: 0.7;
+    vertical-align: baseline;
+    // Don't underline the arrow itself (looks weird).
+    text-decoration: none;
+    display: inline-block;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 3. tag — `#tag` and `[[tags/x]]` links rendered as pill chips
+// ---------------------------------------------------------------------------
+//
+// Pill-shape chip with a leading `#`, small-caps tracking. Hover
+// lifts the chip 1px and tints the background — the chip becomes a
+// small button. `inline-flex` aligns the chip's baseline with
+// surrounding running text without needing magic margins.
+//
+// Selector covers BOTH:
+//   * `[data-brain-link-kind="tag"]` — stamped by `linkKindMark.ts`
+//     for tag links the markdown pipeline produces (e.g. `#tag`
+//     inline syntax via OFM, or `[[tags/foo]]` wiki-link form).
+//   * `.tag-link` — Quartz's stock class on tag chips emitted by the
+//     `TagList` component (article header) and the `TagPage` emitter
+//     (tag page chips). These are JSX/hast nodes, not mdast, so
+//     `linkKindMark` never sees them — we lean on the upstream class
+//     for them. Listed second so the data-attribute is the canonical
+//     selector when both are present (they're equivalent rules; the
+//     comma form just widens reach).
+a[data-brain-link-kind="tag"],
+a.tag-link {
+  display: inline-flex;
+  align-items: baseline;
+  padding: 0.1rem 0.55rem;
+  background: var(--surface-2);
+  border-radius: 999px;
+  // brain (Linear variant): drop `smcp` — Geist doesn't ship the
+  // small-caps OpenType feature, so the declaration is a silent no-op.
+  // Lining numerals + slight letter-spacing keep the chip readable
+  // without uppercasing the text.
+  //
+  // brain (P3.4 — Wiki UX Overhaul, item 10): `text-transform: none`
+  // (explicit) — tags are the canonical lowercased values produced by
+  // `brain.tags.normalize_tags` (casefold + hyphen-separated). The
+  // earlier `uppercase` rule made every chip render `#AGENTIC-AI`,
+  // which contradicted the storage format and made the visual feel
+  // shouty. Locking `text-transform: none` here also defends against
+  // a future upstream Quartz default that might flip the default to
+  // uppercase. The DOM text from `TagList.tsx` is already lowercase,
+  // so this rule is the single seam between normalized storage and
+  // the user-visible chip.
+  font-feature-settings: "lnum";
+  text-transform: none;
+  letter-spacing: 0.04em;
+  text-decoration: none;
+  // brain: vertical-align nudge so the chip sits on the text baseline
+  // even with the inline padding. Without this, the pill rides ~2px
+  // below the baseline when wrapped inside running serif text.
+  vertical-align: baseline;
+  transition:
+    background var(--motion-fast) var(--motion-easing),
+    transform var(--motion-fast) var(--motion-easing),
+    color var(--motion-fast) var(--motion-easing);
+
+  // brain: leading `#` — opacity 0.5 so it reads as decoration, not
+  // content. `margin-right: 0.1em` gives it just enough breathing room
+  // from the tag name.
+  &::before {
+    content: "#";
+    opacity: 0.5;
+    margin-right: 0.1em;
+  }
+
+  &:hover {
+    background: var(--accent-soft);
+    transform: translateY(-1px);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 4. derived — Phase D evidence edges (auto-generated "Related" links)
+// ---------------------------------------------------------------------------
+//
+// Italic + dashed underline + opacity 0.78 says "this is a hint, not
+// an authored claim." `cursor: help` reinforces the pattern (browsers
+// render `?` cursor; users learn that hovering reveals the rule).
+// The `title` attribute is already populated by `derivedFenceMark.ts`
+// with the rule shape (`same_day_participant`, `shared_thread`).
+a[data-brain-link-kind="derived"] {
+  text-decoration: underline;
+  text-decoration-style: dashed;
+  text-decoration-color: var(--ink-2);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.18em;
+  text-decoration-skip-ink: auto;
+  font-style: italic;
+  opacity: 0.78;
+  cursor: help;
+  transition:
+    opacity var(--motion-fast) var(--motion-easing),
+    text-decoration-color var(--motion-fast) var(--motion-easing);
+
+  &:hover {
+    opacity: 1;
+    text-decoration-color: var(--accent-strong);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 5. ingested — vault-internal links into `_ingested/<source>/<slug>`
+// ---------------------------------------------------------------------------
+//
+// Inherits the wiki underline pattern (terracotta thin → thick on
+// hover) and adds a 2px source-tinted left rail via `box-shadow`
+// (NOT `border-left` — `border-left` adds 2px to the box width and
+// causes layout shift on the long form below; `inset` `box-shadow`
+// paints inside the existing box so widths stay consistent).
+//
+// Source-color comes from a CSS custom property (`--source-color`)
+// scoped per-link via the `[data-brain-source="..."]` selectors
+// below. Default fallback is `--brain-source-manual` so any
+// uncategorized ingested link still gets a rail.
+a[data-brain-link-kind="ingested"] {
+  // brain: same reset as the wiki block — stock `a.internal` from
+  // `base.scss` paints a chunky 12%-alpha pill (background + padding +
+  // border-radius) that would mix with the source-tinted rail. Wipe
+  // background/border-radius and rebuild padding from scratch so the
+  // 0.35em rail offset is the only horizontal padding present.
+  background: transparent;
+  border-radius: 0;
+  // Padding rebuilt: zero on top/right/bottom (match wiki kind),
+  // 0.35em on the left to keep text off the source rail.
+  padding: 0 0 0 0.35em;
+  // Inherit wiki underline behaviour. SCSS doesn't have `extend`
+  // across the `[attr=value]` selector cleanly, so re-declare the
+  // five properties (kept in sync with the wiki block above by code
+  // review).
+  text-decoration: underline;
+  text-decoration-color: var(--accent-soft);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.18em;
+  text-decoration-skip-ink: auto;
+  // The source-tinted rail. `inset` keeps it inside the box; the
+  // 2px width matches the wiki-link hover thickness so the visual
+  // weight is consistent between the two related kinds.
+  box-shadow: inset 2px 0 0 var(--source-color, var(--brain-source-manual));
+  transition:
+    text-decoration-thickness var(--motion-fast) var(--motion-easing),
+    text-decoration-color var(--motion-fast) var(--motion-easing),
+    box-shadow var(--motion-fast) var(--motion-easing);
+
+  &:hover {
+    text-decoration-thickness: 2px;
+    text-decoration-color: var(--accent-strong);
+    // Thicken the source rail on hover too — same "tactile" cue as
+    // the wiki underline grow.
+    box-shadow: inset 3px 0 0 var(--source-color, var(--brain-source-manual));
+  }
+
+  // Source palette mappings. Each rule sets `--source-color` to the
+  // matching `--brain-source-*` token from `_tokens.scss`. Both light
+  // and dark mode `--brain-source-*` definitions live in `_tokens.scss`,
+  // so no per-mode override is needed here.
+  &[data-brain-source="krisp"] {
+    --source-color: var(--brain-source-krisp);
+  }
+  &[data-brain-source="slack"] {
+    --source-color: var(--brain-source-slack);
+  }
+  &[data-brain-source="gmail"] {
+    --source-color: var(--brain-source-gmail);
+  }
+  &[data-brain-source="manual"] {
+    --source-color: var(--brain-source-manual);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Universal: visited state
+// ---------------------------------------------------------------------------
+//
+// `filter: saturate(0.7)` desaturates the link color slightly without
+// overriding the kind-specific styling above (which uses
+// `text-decoration-color`, not `color`, so a `color` override would
+// be invisible anyway). Applies to every kind including chips and
+// dashed derived links — visited state should read consistently
+// across the whole link family.
+//
+// Gated by the SCSS variable at the top so it can be turned off from
+// `custom.scss` via `@use "./brain/links" with ($enable-visited-desaturation: false)`
+// if it ever clashes with another visual choice.
+@if $enable-visited-desaturation {
+  a[data-brain-link-kind]:visited,
+  a.tag-link:visited {
+    filter: saturate(0.7);
+  }
+}