/* === reset + tokens === */
* { margin: 0; padding: 0; box-sizing: border-box; }

:root {
  --bg: #0e0e0e;
  --text: #d8d8d8;
  --muted: #888;
  --dim: #555;
  --link: #9dc7ff;
  --link-hover: #dceaff;
  --link-underline: rgba(157, 199, 255, 0.3);
  --rule: #1c1c1c;
  --rule-strong: #222;
  --card: #141414;
  --code-bg: #121212;
  --text-block-width: 600px;
}

html { font-size: 14px; }

body {
  font-family: 'SF Mono', 'Menlo', 'JetBrains Mono', 'Fira Code', Consolas, monospace;
  background: var(--bg);
  color: var(--text);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

a {
  color: var(--link);
  text-decoration: underline;
  text-decoration-color: var(--link-underline);
  text-decoration-thickness: 1px;
  text-underline-offset: 0.2em;
  transition: color 0.15s, text-decoration-color 0.15s;
}
a:hover { color: var(--link-hover); text-decoration-color: currentColor; }

/* === top nav === */
.nav-bar {
  border-bottom: 1px solid var(--rule);
  background: var(--bg);
  position: sticky;
  top: 0;
  z-index: 30;
}
.nav-inner {
  max-width: 1180px;
  margin: 0 auto;
  padding: 8px 20px;
  display: flex;
  justify-content: space-between;
  align-items: center;
  font-size: 13px;
}
.nav-brand-group { display: flex; align-items: baseline; gap: 6px; }
.nav-prompt {
  color: #7c7;
  font-weight: 700;
  font-size: 13px;
  font-family: inherit;
  margin-right: 2px;
}
.nav-brand {
  color: var(--text);
  text-decoration: none;
  font-weight: 700;
  font-size: 13px;
  font-family: inherit;
}
.nav-by { color: var(--dim); margin-left: 4px; font-size: 12px; }
.nav-by a { color: #666; text-decoration: none; }
.nav-by a:hover { color: var(--text); }
.nav-links { list-style: none; display: flex; gap: 18px; }
.nav-links a { color: var(--muted); text-decoration: none; font-size: 13px; }
.nav-links a.active { color: var(--text); }
.nav-links a:hover { color: var(--text); }

.mobile-menu-toggle {
  display: none;
  align-items: center;
  gap: 7px;
  min-height: 30px;
  padding: 5px 9px;
  border: 1px solid var(--rule-strong);
  border-radius: 3px;
  background: var(--card);
  color: var(--text);
  font: inherit;
  font-size: 12px;
  line-height: 1;
  cursor: pointer;
}
.mobile-menu-toggle:hover,
.mobile-menu-toggle:focus-visible {
  border-color: #3a3a3a;
  outline: none;
}
.mobile-menu-icon,
.mobile-menu-icon::before,
.mobile-menu-icon::after {
  display: block;
  width: 14px;
  height: 1px;
  background: currentColor;
}
.mobile-menu-icon {
  position: relative;
}
.mobile-menu-icon::before,
.mobile-menu-icon::after {
  content: "";
  position: absolute;
  left: 0;
}
.mobile-menu-icon::before { top: -5px; }
.mobile-menu-icon::after { top: 5px; }
.mobile-menu-toggle[aria-expanded="true"] .mobile-menu-icon {
  background: transparent;
}
.mobile-menu-toggle[aria-expanded="true"] .mobile-menu-icon::before {
  top: 0;
  transform: rotate(45deg);
}
.mobile-menu-toggle[aria-expanded="true"] .mobile-menu-icon::after {
  top: 0;
  transform: rotate(-45deg);
}
.mobile-menu-panel {
  display: none;
}
body.mobile-menu-open {
  overflow: hidden;
}

@media (max-width: 879px) {
  .nav-inner {
    gap: 10px;
  }
  .nav-brand-group {
    min-width: 0;
    flex: 1 1 auto;
  }
  .nav-brand {
    white-space: nowrap;
  }
  .nav-by {
    display: none;
  }
  .nav-links {
    display: none;
  }
  .mobile-menu-toggle {
    display: inline-flex;
    flex: 0 0 auto;
  }
  .mobile-menu-panel {
    display: block;
    position: fixed;
    top: 47px;
    left: 0;
    right: 0;
    bottom: 0;
    z-index: 20;
    background: rgba(14, 14, 14, 0.98);
    border-top: 1px solid var(--rule);
    overflow-y: auto;
    -webkit-overflow-scrolling: touch;
  }
  .mobile-menu-panel[hidden] {
    display: none;
  }
  .mobile-menu-inner {
    max-width: 440px;
    margin: 0 auto;
    padding: 18px 20px 32px;
  }
  .mobile-menu-inner h3 {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.12em;
    color: var(--muted);
    margin: 18px 0 8px;
  }
  .mobile-menu-inner h3:first-child {
    margin-top: 0;
  }
  .mobile-menu-inner ul {
    list-style: none;
    border: 1px solid var(--rule-strong);
    border-radius: 4px;
    background: #111;
    overflow: hidden;
  }
  .mobile-menu-inner li + li {
    border-top: 1px solid var(--rule);
  }
  .mobile-menu-inner a {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 12px;
    min-height: 40px;
    padding: 10px 12px;
    color: var(--text);
    text-decoration: none;
    font-size: 13px;
    font-weight: 600;
  }
  .mobile-menu-inner a:hover,
  .mobile-menu-inner a:focus-visible,
  .mobile-menu-inner a.active {
    background: var(--card);
    color: #fff;
    outline: none;
  }
  .mobile-menu-inner a .b {
    flex: 0 0 auto;
    font-size: 11px;
    font-weight: 500;
    color: var(--dim);
  }
  .mobile-menu-inner a .b::before { content: "["; }
  .mobile-menu-inner a .b::after  { content: "]"; }
  .mobile-menu-inner a .b.cloud { color: #7c7; }
  .mobile-menu-inner a .b.local { color: #c7c; }
  .mobile-menu-inner a .b.arch  { color: #cba; }
  .mobile-menu-inner a .b.security { color: #f08c2a; }
  .mobile-menu-inner a .bitcoin-orange { color: #f7931a; }
}

/* === layout === */
.layout {
  max-width: 1180px;
  margin: 0 auto;
  padding: 0 20px;
  display: grid;
  grid-template-columns: 1fr;
  gap: 24px;
}
@media (min-width: 880px) {
  .layout { grid-template-columns: 240px 1fr; gap: 48px; }
}

/* === sidebar === */
aside.rail { padding: 24px 0 36px; min-width: 0; }
@media (max-width: 879px) {
  aside.rail { display: none; }
}
@media (min-width: 880px) {
  aside.rail {
    position: sticky;
    top: 48px;
    align-self: start;
    max-height: calc(100vh - 56px);
    overflow-y: auto;
    padding-right: 8px;
  }
}
aside.rail h3 {
  font-size: 11px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--muted);
  margin: 18px 0 6px;
}
aside.rail h3:first-child { margin-top: 0; }
aside.rail ul { list-style: none; }
aside.rail li a {
  display: block;
  padding: 3px 0;
  color: var(--text);
  text-decoration: none;
  font-size: 13px;
  font-weight: 500;
}
aside.rail li a:hover { color: #fff; text-decoration: underline; text-decoration-color: rgba(255,255,255,0.3); }
aside.rail li a.active { color: #fff; }
aside.rail li a .b {
  font-size: 11px;
  font-weight: 500;
  color: var(--dim);
  margin-left: 4px;
}
aside.rail li a .b::before { content: "["; }
aside.rail li a .b::after  { content: "]"; }
aside.rail li a .b.cloud { color: #7c7; }
aside.rail li a .b.local { color: #c7c; }
aside.rail li a .b.arch  { color: #cba; }
aside.rail li a .b.security { color: #f08c2a; }
aside.rail li a .bitcoin-orange { color: #f7931a; }

/* === main column === */
main.col { padding: 24px 0 60px; min-width: 0; max-width: 760px; }

/* === page hero logo === */
.page-hero {
  padding: 28px 0 8px;
  text-align: left;
  max-width: var(--text-block-width);
}
.page-hero img {
  width: 100%;
  max-width: 100%;
  height: auto;
  display: block;
}

/* === index hero + principles === */
.hero { margin-bottom: 24px; }
.hero p { color: var(--muted); font-size: 14px; max-width: var(--text-block-width); line-height: 1.6; }

.principles {
  padding: 14px 0;
  margin: 8px 0 24px;
  border-top: 1px solid var(--rule-strong);
  border-bottom: 1px solid var(--rule-strong);
}
.principles p { color: var(--muted); padding: 3px 0; font-size: 13.5px; }
.principles p strong { color: var(--text); font-weight: 700; margin-right: 4px; }

/* === blocks === */
section.block { margin-bottom: 32px; }
section.block > h2 {
  font-size: 11px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--muted);
  margin-bottom: 8px;
  padding-top: 14px;
  border-top: 1px solid var(--rule-strong);
}
section.block > p.lede { color: var(--muted); font-size: 13.5px; margin-bottom: 12px; max-width: 600px; }

/* === flat list rows === */
ul.flat { list-style: none; }
ul.flat li {
  display: grid;
  grid-template-columns: auto 1fr auto auto;
  gap: 10px;
  align-items: baseline;
  padding: 4px 0;
  font-size: 13.5px;
}
ul.flat li > a {
  color: var(--text);
  text-decoration: none;
  font-weight: 600;
  white-space: nowrap;
}
ul.flat li > a:hover { color: #fff; text-decoration: underline; }
ul.flat li .desc { color: var(--muted); }
ul.flat li .updated {
  color: var(--dim);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  white-space: nowrap;
  font-variant-numeric: tabular-nums;
}
ul.flat li .tag {
  color: var(--dim);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  white-space: nowrap;
}
ul.flat li .tag.cloud { color: #7c7; }
ul.flat li .tag.local { color: #c7c; }

@media (max-width: 640px) {
  ul.flat li { grid-template-columns: 1fr auto; row-gap: 0; }
  ul.flat li .desc { grid-column: 1 / -1; padding-left: 14px; font-size: 13px; }
  ul.flat li .updated { grid-column: 1 / 2; padding-left: 14px; }
  ul.flat li .tag { justify-self: end; }
}

/* === featured (index) === */
.feature {
  padding: 18px 20px;
  background: var(--card);
  border: 1px solid var(--rule-strong);
  border-radius: 4px;
  font-size: 13.5px;
}
.feature .tag {
  font-size: 10px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--dim);
  margin-bottom: 6px;
}
.feature-meta {
  display: flex;
  gap: 10px;
  align-items: baseline;
  flex-wrap: wrap;
  margin-bottom: 6px;
}
.feature-meta .tag { margin-bottom: 0; }
.feature-meta .updated {
  color: var(--dim);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-variant-numeric: tabular-nums;
}
.feature h3 { font-size: 16px; margin-bottom: 8px; font-weight: 700; }
.feature p { color: var(--muted); margin-bottom: 10px; }
.feature ul { list-style: none; margin-bottom: 14px; }
.feature li { color: var(--muted); padding: 2px 0; padding-left: 14px; position: relative; }
.feature li::before { content: "·"; position: absolute; left: 4px; color: var(--dim); }
.feature .btn {
  display: inline-block;
  background: #fff;
  color: #0e0e0e;
  padding: 6px 14px;
  border-radius: 3px;
  text-decoration: none;
  font-weight: 700;
  font-size: 12px;
  font-family: inherit;
}
.feature .btn:hover { opacity: 0.9; }

/* === guide pages === */
.guide-header { padding: 0 0 18px; border-bottom: 1px solid var(--rule-strong); margin-bottom: 20px; }
.guide-header h1 {
  font-size: 22px;
  font-weight: 700;
  letter-spacing: 0;
  margin-bottom: 6px;
  color: var(--text);
}
.guide-subtitle { color: var(--muted); font-size: 14px; margin-bottom: 10px; }
.guide-subtitle a { color: var(--link); }
.guide-updated {
  color: var(--muted-2);
  font-size: 11.5px;
  margin: -2px 0 12px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
}
.guide-updated time { font-variant-numeric: tabular-nums; }
.guide-header .badge { margin-right: 6px; }

/* badges (used in guide headers) */
.badge {
  display: inline-block;
  font-size: 10px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  padding: 2px 7px;
  border-radius: 3px;
  background: #1f1f1f;
  color: var(--muted);
  font-family: inherit;
}
.badge-cloud { background: #1a2a1a; color: #7c7; }
.badge-local { background: #2a1a2a; color: #c7c; }

/* TOC */
.toc {
  padding: 12px 14px;
  margin-bottom: 28px;
  border: 1px solid var(--rule-strong);
  border-radius: 4px;
  background: #111;
}
.toc h2 {
  font-size: 10px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--muted);
  margin-bottom: 8px;
}
.toc ol { list-style: none; counter-reset: toc; }
.toc li { counter-increment: toc; padding: 2px 0; font-size: 13px; }
.toc li::before { content: counter(toc, decimal-leading-zero) "  "; color: var(--dim); }
.toc a { color: var(--text); text-decoration: none; }
.toc a:hover { color: #fff; text-decoration: underline; }

/* section-subnav (chips) — only used on agent-stack */
.section-subnav {
  display: flex;
  gap: 8px;
  flex-wrap: nowrap;
  overflow-x: auto;
  padding: 8px 0 16px;
  margin-bottom: 16px;
  position: sticky;
  top: 42px;
  z-index: 8;
  background: var(--bg);
  border-bottom: 1px solid var(--rule);
}
.section-subnav a {
  flex: 0 0 auto;
  color: var(--text);
  text-decoration: none;
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  padding: 5px 10px;
  border: 1px solid var(--rule-strong);
  border-radius: 3px;
  background: #131313;
  font-family: inherit;
}
.section-subnav a:hover { color: #fff; border-color: #3a3a3a; background: #1a1a1a; }

/* guide sections */
.guide-section {
  padding: 22px 0;
  border-top: 1px solid var(--rule);
}
.guide-section:first-of-type { border-top: 0; padding-top: 0; }
.guide-section h2 {
  font-size: 16px;
  font-weight: 700;
  margin-bottom: 12px;
  color: var(--text);
}
.guide-section h3 {
  font-size: 13px;
  font-weight: 700;
  margin: 18px 0 8px;
  color: var(--text);
  text-transform: uppercase;
  letter-spacing: 0.06em;
}
.guide-section p { color: var(--muted); font-size: 13.5px; margin-bottom: 10px; }
.guide-section ul, .guide-section ol {
  color: var(--muted);
  font-size: 13.5px;
  margin: 0 0 14px 18px;
}
.guide-section li { padding: 1px 0; }
.guide-section a { color: var(--link); }

/* code blocks — slightly smaller + subtle bg so they stand out from mono body */
pre {
  background: var(--code-bg);
  border: 1px solid var(--rule-strong);
  border-radius: 4px;
  padding: 12px 14px;
  overflow-x: auto;
  margin: 10px 0 16px;
  font-size: 12.5px;
  line-height: 1.55;
}
code {
  font-family: inherit;
  font-size: 0.95em;
}
p code, li code, td code, th code {
  background: var(--code-bg);
  border: 1px solid var(--rule-strong);
  padding: 1px 5px;
  border-radius: 3px;
  font-size: 0.92em;
  color: var(--text);
}
pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: inherit;
  color: var(--text);
}

/* callouts */
.callout {
  border-left: 3px solid var(--dim);
  padding: 10px 14px;
  margin: 14px 0;
  background: #111;
  border-radius: 0 3px 3px 0;
  font-size: 13px;
  color: var(--muted);
}
.callout-warn { border-left-color: #a86; }
.callout-info { border-left-color: #68a; }
.callout strong { color: var(--text); }

/* tables */
.guide-section table {
  width: 100%;
  border-collapse: collapse;
  margin: 10px 0 18px;
  font-size: 12.5px;
}
.guide-section th {
  text-align: left;
  padding: 6px 10px;
  border-bottom: 1px solid var(--rule-strong);
  font-weight: 700;
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--muted);
}
.guide-section td {
  padding: 6px 10px;
  border-bottom: 1px solid var(--rule);
  color: var(--muted);
  vertical-align: top;
}
.guide-section td code { color: var(--text); }

/* figure (agent-stack diagram) */
.guide-figure {
  margin: 18px 0 22px;
  background: var(--card);
  border: 1px solid var(--rule-strong);
  border-radius: 4px;
  overflow: hidden;
}
.guide-figure img { display: block; width: 100%; height: auto; }
.guide-figure figcaption {
  padding: 10px 14px;
  color: var(--muted);
  font-size: 12px;
  border-top: 1px solid var(--rule);
  background: var(--code-bg);
}

/* arch-diagram */
.arch-diagram {
  background: var(--code-bg);
  border: 1px solid var(--rule-strong);
  border-radius: 4px;
  padding: 14px;
  margin: 16px 0;
  text-align: left;
  font-family: inherit;
  font-size: 12px;
  line-height: 1.5;
  color: var(--muted);
  overflow-x: auto;
  white-space: pre;
}

/* footer */
footer.site-footer {
  border-top: 1px solid var(--rule);
  margin-top: 40px;
  padding: 16px 20px;
  text-align: center;
  color: var(--dim);
  font-size: 12px;
}
footer.site-footer a { color: var(--muted); text-decoration: none; }
footer.site-footer a:hover { color: var(--text); }

/* === site search === */
.search-wrap {
  position: relative;
  margin-left: 24px;
  flex: 0 1 280px;
  max-width: 280px;
}
@media (max-width: 720px) { .search-wrap { display: none; } }
#site-search {
  width: 100%;
  background: var(--card);
  border: 1px solid var(--rule-strong);
  color: var(--text);
  padding: 5px 36px 5px 26px;
  font-family: inherit;
  font-size: 12px;
  border-radius: 3px;
  outline: none;
}
#site-search::placeholder { color: var(--dim); }
#site-search:focus { background: var(--bg); }
.search-wrap::before {
  content: "⌕";
  position: absolute;
  left: 8px;
  top: 50%;
  transform: translateY(-50%);
  color: var(--dim);
  font-size: 13px;
  pointer-events: none;
}
.search-wrap::after {
  content: "⌘K";
  position: absolute;
  right: 8px;
  top: 50%;
  transform: translateY(-50%);
  color: var(--dim);
  font-size: 10px;
  pointer-events: none;
  background: var(--bg);
  padding: 1px 5px;
  border: 1px solid var(--rule);
  border-radius: 2px;
}
#site-search-results {
  position: absolute;
  top: calc(100% + 4px);
  left: 0;
  right: 0;
  max-height: 70vh;
  overflow-y: auto;
  background: var(--card);
  border: 1px solid var(--rule-strong);
  border-radius: 3px;
  z-index: 100;
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
  width: 420px;
}
#site-search-results[hidden] { display: none; }
.search-hit {
  display: block;
  padding: 8px 12px;
  border-bottom: 1px solid var(--rule);
  text-decoration: none;
  color: var(--text);
}
.search-hit:last-child { border-bottom: 0; }
.search-hit:hover, .search-hit.active {
  background: var(--bg);
}
.search-hit-title {
  font-size: 12px;
  font-weight: 600;
  color: var(--text);
  margin-bottom: 2px;
}
.search-hit-snippet {
  font-size: 11px;
  color: var(--muted);
  line-height: 1.5;
}
.search-hit-snippet mark {
  background: rgba(157, 199, 255, 0.18);
  color: var(--link-hover);
  padding: 0 2px;
  border-radius: 2px;
}
.search-empty {
  padding: 12px;
  font-size: 12px;
  color: var(--dim);
  text-align: center;
}

/* print */
@media print {
  .nav-bar, aside.rail, .toc, .section-subnav, .search-wrap { display: none; }
  body { background: #fff; color: #111; font-family: 'SF Mono', monospace; }
  .layout { display: block; padding: 0; }
  main.col { max-width: 100%; }
}