PyPI - secondbrain-py - Versions diffs - 0.2.1__py3-none-any.whl - Mend

secondbrain-py 0.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (273) hide show

brain/__init__.py +0 -0
brain/__main__.py +18 -0
brain/_capture_command.py +445 -0
brain/_compose.py +52 -0
brain/activity.py +206 -0
brain/ask.py +631 -0
brain/audio.py +591 -0
brain/backfill/__init__.py +12 -0
brain/backfill/search_extras.py +141 -0
brain/backfill/source_rows.py +101 -0
brain/bin/__init__.py +1 -0
brain/bin/_launcher.py +107 -0
brain/bin/down.py +8 -0
brain/bin/launchd.py +268 -0
brain/bin/monitor.py +570 -0
brain/bin/rebuild.py +8 -0
brain/bin/status.py +8 -0
brain/bin/up.py +8 -0
brain/brief.py +272 -0
brain/capture.py +49 -0
brain/chat.py +293 -0
brain/cli.py +9760 -0
brain/cli_claude.py +81 -0
brain/cli_connect.py +285 -0
brain/cli_demo.py +266 -0
brain/config.py +1949 -0
brain/connect.py +925 -0
brain/db.py +540 -0
brain/demo/__init__.py +452 -0
brain/demo/corpus/manifest.json +403 -0
brain/demo/embedder.py +74 -0
brain/durations.py +84 -0
brain/edit_session.py +156 -0
brain/editor.py +67 -0
brain/elicit/__init__.py +16 -0
brain/elicit/detectors.py +250 -0
brain/elicit/drafter.py +70 -0
brain/elicit/queue.py +220 -0
brain/elicit/schema.py +48 -0
brain/elicit/session.py +445 -0
brain/embedding_targets.py +54 -0
brain/embeddings.py +424 -0
brain/enrichment.py +808 -0
brain/errors.py +357 -0
brain/eval/__init__.py +129 -0
brain/eval/answer_eval.py +281 -0
brain/eval/baseline.py +265 -0
brain/eval/concept_extraction.py +378 -0
brain/eval/corpus.py +152 -0
brain/eval/errors.py +19 -0
brain/eval/graph_baseline.py +226 -0
brain/eval/graph_retrieval.py +202 -0
brain/eval/graph_runner.py +319 -0
brain/eval/metrics.py +101 -0
brain/eval/runner.py +223 -0
brain/format.py +783 -0
brain/gaps.py +390 -0
brain/graph_rag/__init__.py +94 -0
brain/graph_rag/_retrieval_common.py +113 -0
brain/graph_rag/aggregates.py +303 -0
brain/graph_rag/aliases/__init__.py +583 -0
brain/graph_rag/backends/__init__.py +10 -0
brain/graph_rag/backends/_age_helpers.py +473 -0
brain/graph_rag/backends/age.py +782 -0
brain/graph_rag/backends/base.py +272 -0
brain/graph_rag/build.py +344 -0
brain/graph_rag/communities.py +644 -0
brain/graph_rag/communities_summary.py +437 -0
brain/graph_rag/concepts.py +202 -0
brain/graph_rag/cooccur.py +193 -0
brain/graph_rag/cross_type.py +312 -0
brain/graph_rag/extract.py +885 -0
brain/graph_rag/fuse.py +371 -0
brain/graph_rag/global_.py +412 -0
brain/graph_rag/grouping.py +372 -0
brain/graph_rag/person_resolver.py +167 -0
brain/graph_rag/reconcile.py +792 -0
brain/graph_rag/relational.py +353 -0
brain/graph_rag/retrieve.py +526 -0
brain/graph_rag/router.py +288 -0
brain/graph_rag/schema.py +320 -0
brain/graph_rag/sync.py +237 -0
brain/graph_rag/tenancy.py +43 -0
brain/graph_rag/themes.py +501 -0
brain/graph_rag/weighting.py +202 -0
brain/ingest/__init__.py +1926 -0
brain/ingest/chunker.py +249 -0
brain/ingest/docx.py +40 -0
brain/ingest/gmail.py +621 -0
brain/ingest/markdown.py +37 -0
brain/ingest/pdf.py +61 -0
brain/ingest/stdin.py +22 -0
brain/ingest/sub_tokens.py +91 -0
brain/ingest/text.py +16 -0
brain/interactions.py +205 -0
brain/maintenance.py +355 -0
brain/mcp_server.py +3405 -0
brain/migrations/001_init.sql +43 -0
brain/migrations/002_qwen3_embedding.sql +17 -0
brain/migrations/003_vault_model.sql +41 -0
brain/migrations/004_relax_content_hash_uniqueness.sql +18 -0
brain/migrations/005_derived_links.sql +67 -0
brain/migrations/006_dedup_file_by_source_path.sql +25 -0
brain/migrations/007_email_thread_and_draft.sql +15 -0
brain/migrations/008_gmail_thread_unique.sql +11 -0
brain/migrations/009_chunks_weighted_tsv.sql +28 -0
brain/migrations/010_interactions.sql +30 -0
brain/migrations/011_documents_summary.sql +23 -0
brain/migrations/012_graphrag.sql +171 -0
brain/migrations/013_graphrag_communities.sql +125 -0
brain/migrations/014_graphrag_community_summary_hash.sql +33 -0
brain/migrations/015_interactions_graph_targets.sql +89 -0
brain/migrations/016_index_hygiene.sql +61 -0
brain/migrations/017_elicit.sql +30 -0
brain/migrations/018_review_gap_signal_kinds.sql +40 -0
brain/migrations/019_search_queries.sql +35 -0
brain/migrations/020_link_suggestions.sql +40 -0
brain/migrations/021_timeline_doc_date.sql +34 -0
brain/migrations/022_link_suggestions_undirected.sql +84 -0
brain/migrations/023_search_queries_fts_count.sql +28 -0
brain/quartz_overrides/__init__.py +8 -0
brain/quartz_overrides/quartz/bootstrap-cli.mjs +65 -0
brain/quartz_overrides/quartz/build.ts +568 -0
brain/quartz_overrides/quartz/cli/args.js +152 -0
brain/quartz_overrides/quartz/cli/build_partial_handler.js +544 -0
brain/quartz_overrides/quartz/cli/handlers.js +636 -0
brain/quartz_overrides/quartz/components/CommandPalette.tsx +172 -0
brain/quartz_overrides/quartz/components/Explorer.tsx +198 -0
brain/quartz_overrides/quartz/components/Footer.tsx +27 -0
brain/quartz_overrides/quartz/components/Graph.tsx +468 -0
brain/quartz_overrides/quartz/components/PageTitle.tsx +72 -0
brain/quartz_overrides/quartz/components/RelatedDocs.tsx +38 -0
brain/quartz_overrides/quartz/components/Search.tsx +161 -0
brain/quartz_overrides/quartz/components/SummaryLede.tsx +72 -0
brain/quartz_overrides/quartz/components/index.ts +92 -0
brain/quartz_overrides/quartz/components/pages/TagContent.tsx +272 -0
brain/quartz_overrides/quartz/components/scripts/commandPalette.inline.ts +665 -0
brain/quartz_overrides/quartz/components/scripts/explorer.inline.ts +768 -0
brain/quartz_overrides/quartz/components/scripts/graph.inline.ts +2302 -0
brain/quartz_overrides/quartz/components/scripts/relatedDocs.inline.ts +163 -0
brain/quartz_overrides/quartz/components/scripts/search.inline.ts +1011 -0
brain/quartz_overrides/quartz/plugins/emitters/contentIndex.ts +546 -0
brain/quartz_overrides/quartz/plugins/transformers/codeCopy.ts +94 -0
brain/quartz_overrides/quartz/plugins/transformers/derivedFenceMark.ts +302 -0
brain/quartz_overrides/quartz/plugins/transformers/emailThread.ts +148 -0
brain/quartz_overrides/quartz/plugins/transformers/emptyDoorFilter.ts +213 -0
brain/quartz_overrides/quartz/plugins/transformers/index.ts +114 -0
brain/quartz_overrides/quartz/plugins/transformers/linkKindMark.ts +205 -0
brain/quartz_overrides/quartz/plugins/transformers/linkSourceTag.ts +104 -0
brain/quartz_overrides/quartz/plugins/transformers/relativeDate.ts +100 -0
brain/quartz_overrides/quartz/plugins/transformers/reloadSignal.ts +131 -0
brain/quartz_overrides/quartz/processors/parse.ts +371 -0
brain/quartz_overrides/quartz/processors/parser_cache.ts +78 -0
brain/quartz_overrides/quartz/static/brain-logo-dark.png +0 -0
brain/quartz_overrides/quartz/static/brain-logo-light.png +0 -0
brain/quartz_overrides/quartz/static/codeCopy.js +196 -0
brain/quartz_overrides/quartz/static/emailThread.js +334 -0
brain/quartz_overrides/quartz/static/favicon.ico +0 -0
brain/quartz_overrides/quartz/static/icon.png +0 -0
brain/quartz_overrides/quartz/static/linkSourceTag.js +104 -0
brain/quartz_overrides/quartz/static/relativeDate.js +142 -0
brain/quartz_overrides/quartz/static/reload.js +168 -0
brain/quartz_overrides/quartz/styles/brain/_article.scss +252 -0
brain/quartz_overrides/quartz/styles/brain/_atmosphere.scss +113 -0
brain/quartz_overrides/quartz/styles/brain/_callouts.scss +180 -0
brain/quartz_overrides/quartz/styles/brain/_cmdk.scss +7 -0
brain/quartz_overrides/quartz/styles/brain/_code.scss +208 -0
brain/quartz_overrides/quartz/styles/brain/_command_palette.scss +369 -0
brain/quartz_overrides/quartz/styles/brain/_email_thread.scss +228 -0
brain/quartz_overrides/quartz/styles/brain/_explorer.scss +142 -0
brain/quartz_overrides/quartz/styles/brain/_home.scss +182 -0
brain/quartz_overrides/quartz/styles/brain/_links.scss +322 -0
brain/quartz_overrides/quartz/styles/brain/_marginalia.scss +117 -0
brain/quartz_overrides/quartz/styles/brain/_motion.scss +175 -0
brain/quartz_overrides/quartz/styles/brain/_people_hub.scss +100 -0
brain/quartz_overrides/quartz/styles/brain/_related_docs.scss +137 -0
brain/quartz_overrides/quartz/styles/brain/_search.scss +252 -0
brain/quartz_overrides/quartz/styles/brain/_sidebar.scss +468 -0
brain/quartz_overrides/quartz/styles/brain/_summary_lede.scss +56 -0
brain/quartz_overrides/quartz/styles/brain/_surface.scss +43 -0
brain/quartz_overrides/quartz/styles/brain/_tag_content.scss +118 -0
brain/quartz_overrides/quartz/styles/brain/_tokens.scss +197 -0
brain/quartz_overrides/quartz/styles/brain/_typography.scss +92 -0
brain/quartz_overrides/quartz/styles/custom.scss +89 -0
brain/quartz_overrides/quartz/styles/graph.scss +505 -0
brain/quartz_overrides/quartz/util/ctx.ts +92 -0
brain/quartz_overrides/quartz/util/fastpath_manifest.ts +608 -0
brain/quartz_overrides/quartz/util/path.ts +358 -0
brain/quartz_overrides/quartz/util/sourceIcons.ts +55 -0
brain/quartz_overrides/quartz.config.ts +270 -0
brain/quartz_overrides/quartz.layout.ts +314 -0
brain/queries.py +1188 -0
brain/rank_fusion.py +8 -0
brain/resurface.py +210 -0
brain/review/__init__.py +26 -0
brain/review/emit.py +27 -0
brain/review/queries.py +436 -0
brain/review/render.py +196 -0
brain/review/scans.py +355 -0
brain/review/weekly.py +413 -0
brain/search.py +704 -0
brain/set_similarity.py +15 -0
brain/setup.py +1205 -0
brain/tags.py +56 -0
brain/templates/Caddyfile.j2 +9 -0
brain/templates/__init__.py +1 -0
brain/templates/bin/__init__.py +1 -0
brain/templates/bin/_brain-brief-fg.sh +25 -0
brain/templates/bin/_brain-build-fg.sh +53 -0
brain/templates/bin/_brain-watcher-fg.sh +65 -0
brain/templates/bin/brain-down.sh +89 -0
brain/templates/bin/brain-status.sh +83 -0
brain/templates/bin/brain-up.sh +221 -0
brain/templates/docker/age/Dockerfile +79 -0
brain/templates/docker-compose.stock.yml.j2 +26 -0
brain/templates/docker-compose.yml.j2 +34 -0
brain/templates/env.example +190 -0
brain/templates/launchd/__init__.py +1 -0
brain/templates/launchd/com.brain.brief.plist.j2 +45 -0
brain/templates/launchd/com.brain.build.plist.j2 +46 -0
brain/templates/launchd/com.brain.watcher.plist.j2 +46 -0
brain/templates/skill/SKILL.md +63 -0
brain/templates/skill/__init__.py +1 -0
brain/timeline.py +834 -0
brain/todo.py +124 -0
brain/uninstall.py +185 -0
brain/vault/__init__.py +115 -0
brain/vault/_atomic.py +25 -0
brain/vault/daily_index.py +228 -0
brain/vault/derived_links/__init__.py +50 -0
brain/vault/derived_links/directory.py +683 -0
brain/vault/derived_links/fence.py +408 -0
brain/vault/derived_links/gws.py +64 -0
brain/vault/derived_links/participants.py +143 -0
brain/vault/derived_links/pass_runner.py +362 -0
brain/vault/derived_links/rules.py +137 -0
brain/vault/export.py +683 -0
brain/vault/frontmatter.py +165 -0
brain/vault/graph.py +620 -0
brain/vault/graph_format.py +388 -0
brain/vault/link_rewrite.py +235 -0
brain/vault/links.py +260 -0
brain/vault/note_builder.py +211 -0
brain/vault/paths.py +55 -0
brain/vault/quartz_overlay.py +236 -0
brain/vault/rename.py +591 -0
brain/vault/resolver.py +304 -0
brain/vault/slug.py +127 -0
brain/vault/sync.py +1513 -0
brain/vault/sync_summaries.py +264 -0
brain/vault/templates.py +145 -0
brain/vault/watch.py +1052 -0
brain/wiki/__init__.py +6 -0
brain/wiki/_github_slugger.py +76 -0
brain/wiki/_person_name.py +314 -0
brain/wiki/build_homepage.py +541 -0
brain/wiki/build_partial.py +273 -0
brain/wiki/build_people.py +934 -0
brain/wiki/build_related.py +758 -0
brain/wiki/build_swap.py +585 -0
brain/wiki/build_watcher.py +975 -0
brain/wiki/edit_classifier.py +215 -0
brain/wiki/errors.py +10 -0
brain/wiki/fastpath_manifest.py +475 -0
brain/wiki/fastpath_state.py +174 -0
brain/wiki/install.py +296 -0
brain/wiki/slug.py +111 -0
secondbrain_py-0.2.1.dist-info/METADATA +195 -0
secondbrain_py-0.2.1.dist-info/RECORD +273 -0
secondbrain_py-0.2.1.dist-info/WHEEL +5 -0
secondbrain_py-0.2.1.dist-info/entry_points.txt +11 -0
secondbrain_py-0.2.1.dist-info/licenses/LICENSE +21 -0
secondbrain_py-0.2.1.dist-info/top_level.txt +1 -0

brain/quartz_overrides/quartz/static/reload.js ADDED Viewed

@@ -0,0 +1,168 @@
+// Brain blue-green serve — client-side reload watcher.
+//
+// This file is a TEMPLATE. It is installed at
+// `<vault>/.quartz/quartz/static/reload.js` by `brain vault render
+// --overlay`, and is copied verbatim into every build's `static/`
+// dir by Quartz's stock `Plugin.Static()` emitter (no extra wiring
+// needed — Quartz already mirrors `quartz/static/` 1:1 into the
+// build output). The script is referenced from page `<head>` only
+// when the brain `Plugin.ReloadSignal` transformer's
+// `externalResources()` hook decides to inject it.
+//
+// Tested against Quartz v4.5.x (April 2026). The file is plain
+// vanilla JS (no transpile, no bundler) so it survives any future
+// Quartz refactor of its plugin pipeline — the only contract is
+// that `Plugin.Static()` keeps copying `quartz/static/*` into
+// `<build>/static/`. If a future Quartz version changes the static
+// asset pipeline, update both this file's load path and the
+// `reloadSignal.ts` transformer in lock-step.
+//
+// What this script does, and why: in the blue-green serve
+// architecture (see
+// `docs/plans/2026-05-01-quartz-blue-green-serve.md`), Caddy
+// serves whichever build dir `<vault>/.quartz/current` symlinks
+// to. The brain build watcher rebuilds the site into a fresh
+// `<vault>/.quartz/builds/<id>/` dir on every vault change, then
+// atomically retargets `current` at the new build. Because the
+// swap happens server-side (rename(2) on a symlink), open
+// browsers have no signal that the page they're viewing is now
+// stale. Quartz's own `--serve` mode opens a WebSocket from the
+// dev server to reload tabs in place, but `--serve` is dead in
+// our flow (we serve via Caddy, not Quartz) — so this polling
+// loop is the replacement reload mechanism.
+//
+// Mechanism: every 1s, fetch `/.build-id` (a one-line text file
+// `brain.wiki.build_swap` writes to each build dir) as a conditional
+// request after the first successful response. Caddy serves the file
+// with an ETag; this client reuses that ETag via `If-None-Match` so
+// unchanged builds return `304 Not Modified` without a response body.
+// The first 200 response is captured as the baseline; any subsequent
+// 200 response with a different value triggers `location.reload()`.
+// Network errors, non-2xx responses, and 304s are swallowed silently —
+// a transient blip must NOT reset the baseline (that would cause
+// spurious reloads on the next successful poll). Polling pauses while
+// the tab is hidden (`document.visibilityState === "hidden"`) and
+// resumes on `visibilitychange` to "visible" so backgrounded tabs
+// don't burn battery / network.
+//
+// Env-var contract: the script tag itself is gated by
+// `BRAIN_WIKI_RELOAD=1` at Quartz BUILD time (not at script
+// runtime). When the env var is unset or any other value, the
+// `Plugin.ReloadSignal` transformer returns `{}` from its
+// `externalResources()` hook and no script tag is injected —
+// the script file is still copied into `static/` by Quartz, but
+// nothing references it. `bin/brain-up` (the dev daily-use
+// path) sets the env to `"1"`; `brain vault render` (the prod
+// one-shot path) leaves it unset, so prod builds ship without
+// any polling chatter.
+//
+// Browser support: targets evergreen Chrome / Firefox / Safari.
+// No polyfills, no IE, no transpile. Uses `fetch`, async/await,
+// and `document.visibilityState` — all baseline since 2017.
+;(function () {
+  // Polling cadence in ms. 1s keeps edit-to-UI latency at ≤1s for
+  // warm builds. Server load remains trivial: responses are
+  // ETag-gated (304 No Body on unchanged builds), so
+  // 10 tabs × 1s = ~10 req/s against Caddy, still negligible for
+  // a UUID-sized static file.
+  var INTERVAL_MS = 1000
+  // Path to the per-build identifier. `brain.wiki.build_swap`
+  // writes a one-line file at the build dir's root; Caddy's
+  // file_server serves it directly because the build dir IS the
+  // site root. Trailing newline is normal — strip it before
+  // comparing.
+  var BUILD_ID_PATH = "/.build-id"
+  // Must match full-build ids from `brain.wiki.build_swap._generate_build_id()`
+  // and fast-path ids from `quartz/cli/build_partial_handler.js`. Rejecting
+  // non-empty garbage bodies (for example an HTML fallback) prevents a
+  // bad 200 response from poisoning the ETag baseline.
+  var BUILD_ID_PATTERN = /^(?:\d{8}-\d{6}-[0-9a-f]{6}|fastpath-\d+-[0-9a-f]{8})$/
+  // Last ETag returned by Caddy for `/.build-id`. `null` means the
+  // first request has not completed yet, so no conditional header can
+  // be sent. This is independent from the baseline body value: the
+  // ETag saves bandwidth on unchanged builds, while the body comparison
+  // remains the correctness check that decides when to reload.
+  var lastEtag = null
+  // Baseline build id captured on the first successful poll.
+  // `null` means "not yet known"; any response other than the
+  // baseline triggers a reload. Once set, this is NEVER cleared
+  // by a network failure — that would cause the next successful
+  // poll to silently rebaseline against a possibly-newer build
+  // and miss the swap.
+  var baseline = null
+  // Single shared interval handle so we can `clearInterval` on
+  // visibilitychange. `null` means "not currently polling".
+  var timer = null
+  function buildHeaders() {
+    if (lastEtag === null) return {}
+    return { "If-None-Match": lastEtag }
+  }
+  async function poll() {
+    try {
+      var r = await fetch(BUILD_ID_PATH, {
+        cache: "no-cache",
+        headers: buildHeaders(),
+      })
+      if (r.status === 304) return
+      if (!r.ok) return
+      var etag = r.headers.get("ETag")
+      var id = (await r.text()).trim()
+      if (!BUILD_ID_PATTERN.test(id)) return
+      if (etag) {
+        lastEtag = etag
+      }
+      if (baseline === null) {
+        baseline = id
+        // One-time banner so the user can confirm the watcher is
+        // wired up by opening DevTools. Subsequent polls are silent.
+        // eslint-disable-next-line no-console
+        console.log("[brain] reload watcher active (build = " + id + ")")
+        return
+      }
+      if (id !== baseline) {
+        location.reload()
+      }
+    } catch (_) {
+      // Network blip / DNS hiccup / Caddy bouncing. Keep polling
+      // — do NOT reset `baseline`, otherwise the next successful
+      // poll would silently rebaseline and we'd miss the next
+      // real swap.
+    }
+  }
+  function start() {
+    if (timer !== null) return
+    timer = setInterval(poll, INTERVAL_MS)
+    // Fire one immediately so the baseline is captured without
+    // waiting for the first interval tick.
+    poll()
+  }
+  function stop() {
+    if (timer === null) return
+    clearInterval(timer)
+    timer = null
+  }
+  document.addEventListener("visibilitychange", function () {
+    if (document.visibilityState === "hidden") {
+      stop()
+    } else {
+      start()
+    }
+  })
+  // Kick off immediately if the tab is foreground at script load.
+  // (afterDOMReady scripts run after `</body>`, so the document
+  // is parsed and we can read `visibilityState` safely.)
+  if (document.visibilityState !== "hidden") {
+    start()
+  }
+})()

brain/quartz_overrides/quartz/styles/brain/_article.scss ADDED Viewed

@@ -0,0 +1,252 @@
+// Brain article surface — Lane C of the 2026 commonplace-book redesign.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_article.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via `custom.scss`'s
+// `@use "./brain/article"` line.
+//
+// Scope of this file:
+//
+//   * `measure` — cap article column width at 68ch via `.popover-hint`
+//     so prose doesn't sprawl on a 1440px viewport. The Quartz article
+//     wrapper is `.popover-hint` (used both for live popover hints AND
+//     as the article content container — see `Component.Body`).
+//   * Heading rhythm — sizes pulled from the `_tokens.scss` modular
+//     scale (h1 `--fs-3xl`, h2 `--fs-2xl`, h3 `--fs-xl`). h2 gets a
+//     1px hairline rule below in `--rule` to mark major section
+//     breaks editorially.
+//   * Blockquote — repurposed for editorial pull-quotes inside the
+//     article. Left rule 3px in `--accent-soft`, italic Fraunces
+//     (via `var(--displayFont)`), generous breathing room.
+//   * Article meta — `time` + read-time small-caps via `--fs-xs` +
+//     `+0.08em` tracking, dimmed via `--ink-2`. Quartz's
+//     `Component.ContentMeta` emits `<p class="content-meta">` with
+//     `<time>` + `<span>` children.
+//   * Tag chips at the article header — re-apply Lane B's `.tag-link`
+//     pill styling pattern. Lane B already targets `.tag-link` via
+//     the comma-form selector in `_links.scss`; this file owns only
+//     the *container* spacing on the `<ul class="tags">` wrapper
+//     emitted by `Component.TagList`.
+//
+// Scope NOT covered here:
+//
+//   * Drop cap + pull quote — Lane D (`brain/article` extension via
+//     `_motion.scss` / Lane D's article additions). This file is the
+//     baseline rhythm; Lane D adds the editorial flourishes on top.
+//   * Code surface — `_code.scss`.
+//   * Callout chrome — `_callouts.scss`.
+//
+// Tokens consumed (all from `_tokens.scss`):
+//
+//   * `--fs-3xl` / `--fs-2xl` / `--fs-xl` — heading scale
+//   * `--fs-xs` / `--fs-sm`               — meta + tag-chip type
+//   * `--rule`                            — h2 hairline + tag chip border
+//   * `--accent-soft`                     — blockquote left rule
+//   * `--ink-1` / `--ink-2`               — ink scale for meta + body
+//   * `--displayFont`                     — Fraunces for italic blockquote
+// ---------------------------------------------------------------------------
+// 1. Article measure
+// ---------------------------------------------------------------------------
+//
+// `.popover-hint` is the wrapper Quartz emits around article bodies
+// AND popover hints (`Component.Body` + `popover.inline.ts`). Capping
+// it at 68ch gives long-form prose a comfortable line length without
+// touching the grid columns from base.scss.
+//
+// brain: 68ch is a deliberate trade-off. The classical body-text
+// measure is 45–75 characters; 68ch lands at the comfortable upper
+// end so technical prose with code identifiers doesn't wrap awkwardly,
+// and on a 1440px viewport the article still fills the center column
+// rather than collapsing to a narrow strip. Newsreader at `--fs-base`
+// makes 68ch ≈ 660px.
+// brain (Linear variant): bumped from 68ch to 95ch — Geist is narrower
+// per character than Newsreader, so the same line-count needs a wider
+// measure to read at body size. 95ch on a 1440px viewport with 320px
+// sidebars leaves the article filling the center column with no dead
+// space; on wider viewports the cap still holds against runaway lines.
+.popover-hint {
+  max-width: 95ch;
+}
+// brain (Linear-variant feedback): horizontal breathing room for the
+// article column. Stock Quartz pins `.center` flush against the two
+// sidebar columns with only the grid gap (5px) as separation, which
+// reads as cramped on the redesigned layout. 2rem of horizontal
+// padding gives the prose room to breathe between the explorer/search
+// rail on the left and the graph/ToC/backlinks rail on the right.
+//
+// box-sizing + min-width are CRITICAL: stock Quartz's body grid is
+// `grid-template-columns: 320px auto 320px`. The `auto` track sizes
+// to its content's intrinsic width, so naive `padding: 0 2rem` on
+// `.center` (with default content-box) made the track grow 64px
+// wider than the available space, pushing the article over the right
+// sidebar and clipping its right-edge text. `box-sizing: border-box`
+// pulls padding INTO the element's declared width; `min-width: 0`
+// tells the grid algorithm not to inflate the track to fit the
+// content's min-content size. Together they keep the center track
+// at its natural ~790px width on a 1440 viewport, with the inner
+// content area at 790 - 64 = 726px (well above readable measure).
+.center {
+  box-sizing: border-box;
+  min-width: 0;
+  padding-left: 2rem;
+  padding-right: 2rem;
+}
+// ---------------------------------------------------------------------------
+// 2. Heading hierarchy + rhythm
+// ---------------------------------------------------------------------------
+//
+// Sizes from `_tokens.scss`. Stock Quartz's `base.scss` paints
+// `h1: 1.75rem`, `h2: 1.4rem`, `h3: 1.12rem` — flat and unrelated to
+// our modular scale. The `_typography.scss` Lane A file already pins
+// h1–h6 to the scale; this block adds the *editorial* treatment
+// (rule below h2, tighter top margins inside articles, anchor-link
+// glyph color).
+//
+// Selectors are scoped under `article` so they only fire inside the
+// article column — popover hints and breadcrumbs don't grow horns.
+article {
+  > h1 {
+    font-size: var(--fs-3xl);
+    margin-top: 0;
+    margin-bottom: 1rem;
+  }
+  > h2 {
+    font-size: var(--fs-2xl);
+    margin-top: 2rem;
+    margin-bottom: 0.8rem;
+    // brain: hairline rule below every h2 marks major section breaks
+    // editorially — it reads like a page-layout rule in a printed book
+    // rather than a hard divider. The rule sits 0.4rem below the
+    // baseline so descenders don't graze it.
+    padding-bottom: 0.4rem;
+    border-bottom: 1px solid var(--rule);
+  }
+  > h3 {
+    font-size: var(--fs-xl);
+    margin-top: 1.6rem;
+    margin-bottom: 0.6rem;
+  }
+}
+// ---------------------------------------------------------------------------
+// 3. Blockquote — editorial pull-quote treatment
+// ---------------------------------------------------------------------------
+//
+// Stock Quartz paints `blockquote { border-left: 3px solid var(--secondary) }`
+// (see `base.scss` line 349-354). We swap the rule color to
+// `--accent-soft` (12% terracotta) so the rule reads as a soft visual
+// accent rather than a hard partition, route the body through Fraunces
+// italic for a pull-quote voice, and add generous vertical breathing
+// room.
+//
+// brain (Lane D audit fix 2026-05-02): the original selector was
+// `article blockquote:not(.callout blockquote)` — a descendant
+// `:not()` argument that excludes blockquotes nested INSIDE callout
+// blockquotes (a structure Quartz never emits). The actual Quartz
+// markup for callouts is `<blockquote class="callout note">` (see
+// `quartz/plugins/transformers/ofm.ts` line 499 — the blockquote IS
+// the callout). The wrong selector applied this rule to every
+// callout, overriding the per-type color rule with `--accent-soft`.
+// Correct exclusion is `:not(.callout)` so callout chrome stays
+// owned by `_callouts.scss`. The same selector bug is fixed below
+// in the Lane D pull-quote rule.
+article blockquote:not(.callout) {
+  border-left-color: var(--accent-soft);
+  margin: 1.6rem 0;
+  padding: 0.4rem 0 0.4rem 1.2rem;
+  font-size: var(--fs-md);
+  color: var(--ink-1);
+  line-height: 1.4;
+  // Trim default paragraph margins inside the quote so a single-`<p>`
+  // quote doesn't read as a stack of margin gaps.
+  > p {
+    margin: 0.3rem 0;
+  }
+}
+// ---------------------------------------------------------------------------
+// 4. Article meta — time + read-time
+// ---------------------------------------------------------------------------
+//
+// Quartz emits `<p class="content-meta"><time>…</time><span>…</span></p>`
+// from `Component.ContentMeta`. Treat the row as a metadata caption:
+// small-caps tracking, dimmed ink, tight leading. The `show-comma`
+// attribute Quartz adds drives a `::after` "," separator we keep.
+.content-meta {
+  // brain (Linear): mono metadata is a Linear hallmark — Geist Mono
+  // at small size with a touch of tracking reads as tech-forward
+  // chrome rather than editorial small-caps.
+  font-family: var(--codeFont);
+  font-size: 0.75rem;
+  color: var(--ink-2);
+  letter-spacing: 0.02em;
+  margin: 0.2rem 0 0.8rem 0;
+  line-height: 1.3;
+  // Lining tabular numerals inside metadata so dates and read-time
+  // counts align cleanly.
+  font-feature-settings: "lnum", "tnum";
+}
+// ---------------------------------------------------------------------------
+// 5. TagList container at the article header
+// ---------------------------------------------------------------------------
+//
+// `Component.TagList` emits `<ul class="tags"><li><a class="internal tag-link">…</a></li></ul>`.
+// Lane B's `_links.scss` already styles `.tag-link` as a pill chip
+// via the comma-form selector. Here we own only the wrapper layout:
+// inline-flex row with consistent gap, no list bullets, top margin
+// matching the meta row.
+ul.tags {
+  list-style: none;
+  padding: 0;
+  margin: 0.4rem 0 1rem 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+  > li {
+    margin: 0;
+    padding: 0;
+  }
+}
+// ---------------------------------------------------------------------------
+// 6. Linear pull-quote treatment for `<blockquote>`
+// ---------------------------------------------------------------------------
+//
+// The commonplace-book lane appended a Fraunces-italic drop cap and
+// a serif pull-quote here. The Linear variant drops both:
+//
+//   * No drop cap. Tech aesthetic doesn't open articles with a
+//     literary capital — articles begin flush.
+//   * Pull quote retuned: Geist semibold at `--fs-lg`, indigo-violet
+//     left rule at full strength (not soft alpha), no italic. Reads
+//     as a tech-forward "callout" moment in the article rather than
+//     an editorial flourish.
+//
+// Same `:not(.callout)` exclusion so callout chrome stays owned by
+// `_callouts.scss`. This rule comes AFTER the Lane C blockquote rule
+// above, so cascade resolves these properties over Lane C's; the
+// Lane C `border-left-color: var(--accent-soft)` is overridden to
+// `var(--accent-strong)` here.
+article blockquote:not(.callout) {
+  font-size: var(--fs-lg);
+  line-height: 1.5;
+  font-weight: 500;
+  padding-left: 1.25rem;
+  border-left-color: var(--accent-strong);
+  margin: 2rem 0;
+  color: var(--ink-1);
+}

brain/quartz_overrides/quartz/styles/brain/_atmosphere.scss ADDED Viewed

@@ -0,0 +1,113 @@
+// Brain atmosphere — Linear-style variant of the 2026 redesign.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_atmosphere.scss` by `brain
+// vault render --overlay` and pulled into the global SCSS via
+// `custom.scss`'s `@use "./brain/atmosphere"` line (between
+// `surface` and `motion`).
+//
+// What this file owns in the Linear variant — clean tech-forward
+// chrome, NOT print-shop atmosphere:
+//
+//   1. Body stacking-context lock — defensive isolation so any
+//      future negative-z body pseudo-elements don't sink behind
+//      `<html>` styling. Inherited from the commonplace-book lane;
+//      kept because it's harmless and architecturally sound.
+//   2. Hairline column rule between the left sidebar and the article
+//      column — drawn via an absolute-positioned `::after` on
+//      `.sidebar.left`. Same treatment as the commonplace-book lane;
+//      reads as clean tech chrome on neutral surfaces.
+//   3. Hairline section break — `<hr>` inside articles renders as a
+//      flat 1px rule in `--rule`. Replaces the commonplace-book
+//      fleuron with a purely-utilitarian divider.
+//
+// What was REMOVED from the commonplace-book lane:
+//   * Paper grain `body::before` SVG noise texture — Linear surfaces
+//     are clean, never textured.
+//   * Fleuron (❦) section ornament — not appropriate for the tech
+//     aesthetic.
+//
+// What does NOT live here:
+//   * Page-load reveal animations + reduced-motion gate — `_motion.scss`.
+//   * Drop cap / pull quote — `_article.scss`.
+//   * Marginalia (backlinks-as-side-notes) — `_marginalia.scss`.
+//
+// Tokens consumed (all from `_tokens.scss`):
+//   * `--rule`     — column rule + hr hairline
+// ---------------------------------------------------------------------------
+// 1. Body stacking-context lock
+// ---------------------------------------------------------------------------
+//
+// brain (Linear-variant feedback): the `body { isolation: isolate }` rule
+// from the Lane D audit is removed in this variant. It was added to lock
+// a stacking context for the paper-grain `body::before` pseudo-element so
+// `z-index: -1` would paint reliably; the Linear variant has no paper
+// grain (the `body::before` rule is gone earlier in this file), so the
+// isolation rule has no consumer.
+//
+// Per spec, `isolation: isolate` on `body` should NOT create a containing
+// block for `position: fixed` descendants — only `transform`/`filter`/
+// `will-change` do. In practice we observed the global-graph modal
+// rendering as a narrow vertical strip instead of its expected 80vw ×
+// 80vh centered panel, and the stock search container failing to center
+// despite a `display: flex; justify-content: center` override. Both
+// symptoms vanish when the body isolation rule is removed, so we drop
+// it here. If a future feature re-adds a body-level pseudo-element with
+// negative z-index, the lock can come back at the same time.
+// ---------------------------------------------------------------------------
+// 2. Hairline column rule between left sidebar and article column
+// ---------------------------------------------------------------------------
+//
+// Quartz's stock layout (`base.scss`) lays out `.sidebar.left` /
+// `.center` / `.sidebar.right` on a CSS grid with a 5px column gap.
+// A plain `border-right` on `.sidebar.left` would technically work,
+// but the sidebar carries `padding: $topSpacing 2rem 2rem 2rem`, so
+// the border would sit at the right edge of the *padding box* —
+// flush with the column gap. Visually fine; semantically a border
+// belongs to a single element, not the gutter.
+//
+// The pseudo-element approach decouples the rule from the sidebar's
+// box model: it sits as a paint-only sibling that lives in the
+// gutter region without participating in layout. This also makes it
+// trivial to gate by viewport (we only want the rule when there's
+// actually a sidebar-and-center side-by-side layout).
+//
+// Mobile guard: the mobile layout collapses the sidebar to a
+// horizontal row at the top of the page (see `base.scss` line
+// 235-244 — `.sidebar.left @media all and ($mobile)`). A vertical
+// rule there reads as an out-of-place glyph, so we gate the rule
+// on `(min-width: 800px)` to match Quartz's `$mobile` breakpoint.
+@media (min-width: 800px) {
+  .sidebar.left::after {
+    content: "";
+    position: absolute;
+    top: 0;
+    bottom: 0;
+    right: 0;
+    width: 1px;
+    background: var(--rule);
+    pointer-events: none;
+  }
+}
+// ---------------------------------------------------------------------------
+// 3. Hairline section break — `<hr>` renders as a flat rule
+// ---------------------------------------------------------------------------
+//
+// Markdown's `---` becomes `<hr>` in the rendered article. We replace
+// the browser default with a clean 1px hairline in `--rule`. Tech
+// aesthetic: a divider is just a divider, no ornament.
+//
+// Scoped to `article hr` so it only fires inside the article column.
+// Sidebar/footer hrs — if any ever appear — keep their default
+// rendering.
+article hr {
+  border: 0;
+  height: 1px;
+  background: var(--rule);
+  margin: 2.5rem 0;
+}