@grimoire-rs/indexer 0.4.0 → 0.4.2

package/dist/renderer/astro/pages/p/[...slug].astro

@@ -166,7 +166,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
 
 <Base title={`${title} — ${config.brand}`} description={description} image={pkg.logo}>
   <div class="detail">
-    <header class="detail-head">
+    <header class="detail-head" data-slot="detail-header">
       {
         pkg.logo ? (
           // The placeholder ships in the markup and the image fades in over
@@ -182,7 +182,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
             <img src={withBase(pkg.logo)} alt="" />
           </span>
         ) : (
-          <div class="tile letter" style={`background: var(--kind-${pkg.kind}, var(--muted))`}>
+          <div class="tile letter" style={`background: var(--grim-color-kind-${pkg.kind}, var(--grim-color-muted))`}>
             {pkg.name[0]?.toUpperCase()}
           </div>
         )
@@ -202,7 +202,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
 
     {
       pkg.deprecated && (
-        <p class="deprecated-banner">
+        <p class="deprecated-banner" data-slot="deprecated-banner">
           ⚠️ deprecated{pkg.replacedBy ? ` — replaced by ${pkg.replacedBy}` : ""}
         </p>
       )
@@ -229,7 +229,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
       }
     </div>
 
-    <div class="detail-body">
+    <div class="detail-body" data-slot="detail-body">
       <main class="detail-main">
         {/* Radio tabs, not a scripted tablist: the ribbon works on a page
             whose JS never ran, and a radio group already has the keyboard
@@ -324,7 +324,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
         {openTab === null && <p class="panel-empty">No content available.</p>}
       </main>
 
-      <aside class="detail-rail">
+      <aside class="detail-rail" data-slot="detail-rail">
         {tags.length > 0 && (
           <section>
             <h2>Versions</h2>
@@ -509,33 +509,39 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
 </script>
 
 <style>
+@layer grimoire {
+  /* Layered so a user CSS file (unlayered) outranks these rules. Astro
+     scopes a component style to `.foo[data-astro-cid-…]` — specificity
+     (0,2,0) — which beats a consumer's `.foo` in EITHER source order, so
+     source order alone does not make this overridable. Not reindented:
+     the wrapper stays a two-line diff. */
   .detail {
     display: flex;
     flex-direction: column;
-    gap: 1.25rem;
+    gap: var(--grim-space-7);
   }
   .detail-head {
     display: flex;
     align-items: center;
-    gap: 1rem;
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    padding: 1rem 1.25rem;
+    gap: var(--grim-space-6);
+    background: var(--grim-color-card);
+    border: var(--grim-border-width) solid var(--grim-color-border);
+    border-radius: var(--grim-radius-xl);
+    padding: var(--grim-space-6) var(--grim-space-7);
   }
   .tile {
     flex-shrink: 0;
     width: 3.5rem;
     height: 3.5rem;
-    border-radius: 10px;
+    border-radius: var(--grim-radius-xl);
     object-fit: cover;
   }
   .tile.letter {
     display: flex;
     align-items: center;
     justify-content: center;
-    color: var(--on-accent);
-    font-size: 1.5rem;
+    color: var(--grim-color-on-accent);
+    font-size: var(--grim-text-xl);
     font-weight: 700;
     font-family: ui-monospace, "SFMono-Regular", monospace;
   }
@@ -543,18 +549,18 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     margin: 0;
     display: flex;
     align-items: center;
-    gap: 0.6rem;
-    font-size: 1.5rem;
+    gap: var(--grim-space-4);
+    font-size: var(--grim-text-xl);
     font-family: ui-monospace, "SFMono-Regular", monospace;
   }
   .summary {
-    margin: 0.3rem 0 0;
-    color: var(--muted);
+    margin: var(--grim-space-2) 0 0;
+    color: var(--grim-color-muted);
   }
   .byline {
-    margin: 0.35rem 0 0;
-    color: var(--muted);
-    font-size: 0.82rem;
+    margin: var(--grim-space-3) 0 0;
+    color: var(--grim-color-muted);
+    font-size: var(--grim-text-sm);
   }
   /* The kind badge names a closed set of five and shouts accordingly. A
      compatibility hint is a free string off the registry — upper-casing it
@@ -570,31 +576,31 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     padding: 0;
     display: flex;
     flex-direction: column;
-    gap: 0.45rem;
+    gap: var(--grim-space-4);
   }
   .support li {
     display: flex;
     align-items: center;
-    gap: 0.4rem;
-    font-size: 0.9rem;
+    gap: var(--grim-space-3);
+    font-size: var(--grim-text-md);
   }
   .support li :global(svg) {
     flex-shrink: 0;
-    color: var(--muted);
+    color: var(--grim-color-muted);
   }
   .deprecated-banner {
     margin: 0;
-    background: var(--banner-bg);
-    color: var(--banner-fg);
-    border: 1px solid var(--banner-border);
-    border-radius: 8px;
-    padding: 0.6rem 0.9rem;
+    background: var(--grim-color-banner-bg);
+    color: var(--grim-color-banner-fg);
+    border: var(--grim-border-width) solid var(--grim-color-banner-border);
+    border-radius: var(--grim-radius-lg);
+    padding: var(--grim-space-4) var(--grim-space-6);
     font-weight: 600;
   }
   .detail-body {
     display: grid;
     grid-template-columns: 1fr 18rem;
-    gap: 2rem;
+    gap: var(--grim-space-8);
     align-items: start;
   }
   @media (max-width: 55rem) {
@@ -604,10 +610,10 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   }
   .detail-main {
     min-width: 0;
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    padding: 1.25rem 1.5rem;
+    background: var(--grim-color-card);
+    border: var(--grim-border-width) solid var(--grim-color-border);
+    border-radius: var(--grim-radius-xl);
+    padding: var(--grim-space-7) var(--grim-space-7);
   }
   /* Markdown opens with its own heading, whose margin lands on top of the
      panel padding and reads as a hole. Every panel sets its own top edge. */
@@ -624,23 +630,26 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
      panel's own top edge rather than a line floating in the content. */
   .ribbon {
     display: flex;
-    gap: 1.25rem;
-    margin: -1.25rem -1.5rem 1.25rem;
-    padding: 0 1.5rem;
-    border-bottom: 1px solid var(--border);
+    gap: var(--grim-space-7);
+    /* The negation of `.detail-main`'s own padding, written as that token so
+       the two cannot drift apart into a bleed that no longer reaches the edge. */
+    margin: calc(-1 * var(--grim-space-7)) calc(-1 * var(--grim-space-7))
+      var(--grim-space-7);
+    padding: 0 var(--grim-space-7);
+    border-bottom: var(--grim-border-width) solid var(--grim-color-border);
   }
   .ribbon label {
-    padding: 0.7rem 0;
-    margin-bottom: -1px; /* the active underline sits on the panel rule */
+    padding: var(--grim-space-5) 0;
+    margin-bottom: calc(-1 * var(--grim-border-width)); /* the active underline sits on the panel rule */
     border-bottom: 2px solid transparent;
-    font-size: 0.85rem;
+    font-size: var(--grim-text-sm);
     text-transform: uppercase;
     letter-spacing: 0.04em;
-    color: var(--muted);
+    color: var(--grim-color-muted);
     cursor: pointer;
   }
   .ribbon label:hover {
-    color: var(--fg);
+    color: var(--grim-color-fg);
   }
   /* Nothing behind it. Still shown, so the ribbon is the same shape on every
      package page, but visibly not a thing to click. */
@@ -653,7 +662,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   #panel-readme:disabled ~ .ribbon label[for="panel-readme"]:hover,
   #panel-contents:disabled ~ .ribbon label[for="panel-contents"]:hover,
   #panel-changelog:disabled ~ .ribbon label[for="panel-changelog"]:hover {
-    color: var(--muted);
+    color: var(--grim-color-muted);
   }
   /* Every tab empty: say it once, in the middle. */
   .panel-empty {
@@ -661,7 +670,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     place-items: center;
     min-height: 11rem;
     margin: 0;
-    color: var(--muted);
+    color: var(--grim-color-muted);
   }
   .tab-panel {
     display: none;
@@ -674,16 +683,16 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   #panel-readme:checked ~ .ribbon label[for="panel-readme"],
   #panel-contents:checked ~ .ribbon label[for="panel-contents"],
   #panel-changelog:checked ~ .ribbon label[for="panel-changelog"] {
-    color: var(--fg);
-    border-bottom-color: var(--accent);
+    color: var(--grim-color-fg);
+    border-bottom-color: var(--grim-color-accent);
   }
   /* The input carries the focus, the label shows it. */
   #panel-readme:focus-visible ~ .ribbon label[for="panel-readme"],
   #panel-contents:focus-visible ~ .ribbon label[for="panel-contents"],
   #panel-changelog:focus-visible ~ .ribbon label[for="panel-changelog"] {
-    outline: 2px solid var(--accent);
+    outline: 2px solid var(--grim-color-accent);
     outline-offset: 2px;
-    border-radius: 3px;
+    border-radius: var(--grim-radius-sm);
   }
 
   /* A bundle's member list: what it installs, one row each. A grid, not a
@@ -696,7 +705,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     padding: 0;
     display: grid;
     grid-template-columns: auto auto 1fr;
-    gap: 0.45rem 0.75rem;
+    gap: var(--grim-space-4) var(--grim-space-5);
     align-items: center;
   }
   .members li {
@@ -711,8 +720,8 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     justify-self: start;
   }
   .members code {
-    color: var(--muted);
-    font-size: 0.82rem;
+    color: var(--grim-color-muted);
+    font-size: var(--grim-text-sm);
     overflow-wrap: anywhere;
   }
   /* Narrow: three columns of a long ref do not fit, so each member becomes
@@ -729,32 +738,32 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   .detail-rail {
     display: flex;
     flex-direction: column;
-    gap: 1.25rem;
+    gap: var(--grim-space-7);
   }
   .detail-rail section {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    padding: 1rem;
+    background: var(--grim-color-card);
+    border: var(--grim-border-width) solid var(--grim-color-border);
+    border-radius: var(--grim-radius-xl);
+    padding: var(--grim-space-6);
   }
   /* Panel label. The main panel's ribbon labels match this by hand — they
      are <label>s, not headings, so they cannot join the selector. */
   .detail-rail h2 {
-    margin: 0 0 0.6rem;
-    font-size: 0.85rem;
+    margin: 0 0 var(--grim-space-4);
+    font-size: var(--grim-text-sm);
     text-transform: uppercase;
     letter-spacing: 0.04em;
-    color: var(--muted);
+    color: var(--grim-color-muted);
   }
   /* Loose badges, both for the cascade and the older tags — VersionMenu owns
      the pill itself, this only lays them out. */
   .cascade {
     display: flex;
     flex-wrap: wrap;
-    gap: 0.3rem;
+    gap: var(--grim-space-2);
   }
   .older {
-    margin-top: 0.7rem;
+    margin-top: var(--grim-space-5);
   }
   /* The UA marker is a glyph that flips between two characters with no
      in-between; a real chevron can turn. `list-style` kills it everywhere
@@ -764,22 +773,22 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   .older > summary {
     display: flex;
     align-items: center;
-    gap: 0.35rem;
+    gap: var(--grim-space-3);
     list-style: none;
-    padding-block: 0.15rem;
+    padding-block: var(--grim-space-1);
     cursor: pointer;
-    font-size: 0.8rem;
-    color: var(--muted);
+    font-size: var(--grim-text-sm);
+    color: var(--grim-color-muted);
   }
   .older > summary::-webkit-details-marker {
     display: none;
   }
   .older > summary:hover {
-    color: var(--fg);
+    color: var(--grim-color-fg);
   }
   .older > summary :global(svg) {
     flex-shrink: 0;
-    transition: transform 160ms ease;
+    transition: transform var(--grim-duration-base) ease;
   }
   .older[open] > summary :global(svg) {
     transform: rotate(90deg);
@@ -790,7 +799,7 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
     }
   }
   .older[open] > summary {
-    margin-bottom: 0.5rem;
+    margin-bottom: var(--grim-space-4);
   }
   dl {
     margin: 0;
@@ -800,14 +809,14 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
        `stretch` sits each at the top of its own box, so the size difference
        reads as two lines that never quite line up. */
     align-items: center;
-    gap: 0.45rem 0.7rem;
+    gap: var(--grim-space-4) var(--grim-space-5);
   }
   dt {
     display: flex;
     align-items: center;
-    gap: 0.4rem;
-    color: var(--muted);
-    font-size: 0.85rem;
+    gap: var(--grim-space-3);
+    color: var(--grim-color-muted);
+    font-size: var(--grim-text-sm);
   }
   /* Every icon is the same box, so the label text lands on one x without an
      icon column of its own. */
@@ -816,15 +825,15 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
   }
   dd {
     margin: 0;
-    font-size: 0.9rem;
+    font-size: var(--grim-text-md);
   }
   .keywords {
     list-style: none;
-    margin: 0.75rem 0 0;
+    margin: var(--grim-space-5) 0 0;
     padding: 0;
     display: flex;
     flex-wrap: wrap;
-    gap: 0.35rem;
+    gap: var(--grim-space-3);
   }
   /* The chip is the link, not a box around it — otherwise the padding is
      dead space the pointer falls through. Bordered and hovering to accent
@@ -833,27 +842,28 @@ const updatedTitle = pkg.revision ? `${updated} · revision ${pkg.revision}` : u
      that answers differently reads as a different kind of thing. */
   .keywords a {
     display: inline-block;
-    border: 1px solid var(--border);
-    border-radius: 999px;
-    background: var(--chip-bg);
-    padding: 0.15rem 0.6rem;
-    font-size: 0.78rem;
-    color: var(--muted);
+    border: var(--grim-border-width) solid var(--grim-color-border);
+    border-radius: var(--grim-radius-pill);
+    background: var(--grim-color-chip-bg);
+    padding: var(--grim-space-1) var(--grim-space-4);
+    font-size: var(--grim-text-xs);
+    color: var(--grim-color-muted);
     text-decoration: none;
     transition:
-      color 120ms ease,
-      border-color 120ms ease,
-      background-color 120ms ease;
+      color var(--grim-duration-fast) ease,
+      border-color var(--grim-duration-fast) ease,
+      background-color var(--grim-duration-fast) ease;
   }
   .keywords a:hover,
   .keywords a:focus-visible {
-    color: var(--accent);
-    border-color: var(--accent);
-    background: var(--accent-soft);
+    color: var(--grim-color-accent);
+    border-color: var(--grim-color-accent);
+    background: var(--grim-color-accent-soft);
   }
   @media (prefers-reduced-motion: reduce) {
     .keywords a {
       transition: none;
     }
   }
+}
 </style>

package/dist/renderer/astro/styles/tokens.css

@@ -0,0 +1,157 @@
+/* SPDX-License-Identifier: Apache-2.0
+   Copyright 2026 The Grimoire Authors
+
+   THE THEMING CONTRACT — these custom properties are the whole customization
+   surface. There is no component-override API; see `data-slot` below for the
+   other half of the contract.
+
+   Everything the renderer ships is layered. Unlayered CSS — i.e. any user
+   override file — beats a layered declaration outright, at any specificity,
+   so a single `:root { --grim-color-accent: … }` wins in light AND dark
+   without !important and without knowing where Astro injects its bundle.
+
+   Names are `--grim-<category>-<role>`. The category segment is not
+   decoration: it is what stops a colour named `--grim-text` from colliding
+   with the type-scale tokens below.
+
+   COLOUR is the one family that differs per scheme, so it is the one family
+   declared twice — `:root` and `[data-theme="dark"]`. Redeclare BOTH when you
+   override one: `:root` is scheme-agnostic, so a `:root`-only override
+   silently takes dark mode with it. Every other family is a measurement, not
+   an appearance, and is declared once.
+
+   Adding a token is additive. Removing or renaming one is a breaking change.
+
+   `test/renderer/style_contract.test.ts` holds this file to it, and
+   `test/renderer/build.test.ts` proves the layer survives a real build. */
+
+@layer grimoire {
+  :root {
+    /* ---- Colour: surface ------------------------------------------- */
+    --grim-color-bg: #f7f6f3;
+    --grim-color-fg: #1d1c1a;
+    --grim-color-muted: #6d6a63;
+    --grim-color-card: #ffffff;
+    --grim-color-border: #dedbd3;
+    --grim-color-chip-bg: #edebe5;
+
+    /* ---- Colour: accent -------------------------------------------- */
+    --grim-color-accent: #6d4fc4;
+    --grim-color-accent-soft: #efeafd;
+    --grim-color-on-accent: #ffffff;
+
+    /* ---- Colour: package kind --------------------------------------
+       Read through a name composed at runtime — `Catalog.tsx` and the detail
+       page build `var(--grim-color-kind-${pkg.kind})`. Grepping for one of
+       these finds the declaration and no use site; all five are used. */
+    --grim-color-kind-skill: #6d4fc4;
+    --grim-color-kind-rule: #1a7f6b;
+    --grim-color-kind-agent: #b0641a;
+    --grim-color-kind-mcp: #2565c7;
+    --grim-color-kind-bundle: #a63d68;
+
+    /* ---- Colour: state --------------------------------------------- */
+    /* ~5.7:1 on --grim-color-card (white) */
+    --grim-color-deprecated: #9c5400;
+    --grim-color-banner-bg: #fff3cd;
+    --grim-color-banner-fg: #6b4c00;
+    --grim-color-banner-border: #e0b84c;
+
+    color-scheme: light;
+
+    /* ---- Space -----------------------------------------------------
+       Numbered, not role-named, because a spacing step is pure ordinal
+       magnitude: bigger number, more room. The steps are sparse and the
+       distance between them GROWS — 2, 2, 2, 4, 4, 8, 8, 16px — so the
+       scale stays usable at the top without minting a step per pixel.
+       A bare number is only honest with a published role, so here it is:
+
+         1  hairline inset — badge and pill padding
+         2  tight — an icon and its label
+         3  chip padding, keyword gaps
+         4  default gap inside one control
+         5  between related controls
+         6  card padding, row gap
+         7  between sections
+         8  page block separation
+         9  page bottom                                                 */
+    --grim-space-1: 0.125rem;
+    --grim-space-2: 0.25rem;
+    --grim-space-3: 0.375rem;
+    --grim-space-4: 0.5rem;
+    --grim-space-5: 0.75rem;
+    --grim-space-6: 1rem;
+    --grim-space-7: 1.5rem;
+    --grim-space-8: 2rem;
+    --grim-space-9: 3rem;
+
+    /* ---- Type ------------------------------------------------------
+       Role-named, unlike space: a type step is "metadata vs body vs
+       heading", which is a job, not a magnitude. `xl` is a detail-page
+       heading and `2xl` the landing hero — two sizes because those are two
+       deliberately different headings, not drift. */
+    --grim-text-2xs: 0.72rem;
+    --grim-text-xs: 0.78rem;
+    --grim-text-sm: 0.85rem;
+    --grim-text-md: 0.95rem;
+    --grim-text-lg: 1.05rem;
+    --grim-text-xl: 1.5rem;
+    --grim-text-2xl: 1.6rem;
+
+    /* ---- Radius ---------------------------------------------------- */
+    --grim-radius-sm: 4px;
+    --grim-radius-md: 6px;
+    --grim-radius-lg: 8px;
+    --grim-radius-xl: 10px;
+    --grim-radius-pill: 999px;
+
+    /* ---- Border ----------------------------------------------------
+       One width carries every rule in the UI. It is a token so a consumer
+       can thicken every seam at once, and so the two places that pull a
+       border into its neighbour can say `calc(-1 * …)` instead of
+       hardcoding the negation of a number declared elsewhere. */
+    --grim-border-width: 1px;
+
+    /* ---- Motion ---------------------------------------------------- */
+    --grim-duration-fast: 120ms;
+    --grim-duration-base: 160ms;
+    --grim-duration-slow: 200ms;
+
+    /* ---- Elevation -------------------------------------------------
+       A drop shadow is a black scrim rather than a palette colour: it reads
+       correctly over either scheme, which is why these are not declared
+       twice. Overriding one is how a consumer changes elevation. */
+    --grim-shadow-raised: 0 6px 20px rgb(0 0 0 / 18%);
+    --grim-shadow-overlay: 0 8px 24px rgb(0 0 0 / 18%);
+  }
+
+  /* Colour only. Every other family above is a measurement that does not
+     change with the scheme, and redeclaring one here would be a second
+     source of truth for the same value. */
+  [data-theme="dark"] {
+    --grim-color-bg: #16151a;
+    --grim-color-fg: #e8e6e1;
+    --grim-color-muted: #98948b;
+    --grim-color-card: #201f26;
+    --grim-color-border: #35333d;
+    --grim-color-chip-bg: #2a2931;
+
+    --grim-color-accent: #a58cf0;
+    --grim-color-accent-soft: #2c2540;
+    --grim-color-on-accent: #ffffff;
+
+    --grim-color-kind-skill: #a58cf0;
+    --grim-color-kind-rule: #4cc2a9;
+    --grim-color-kind-agent: #e0a35c;
+    --grim-color-kind-mcp: #6fa8f5;
+    --grim-color-kind-bundle: #e07ba6;
+
+    /* ~7.6:1 on --grim-color-card (#201f26) */
+    --grim-color-deprecated: #e3a640;
+    --grim-color-banner-bg: #4a3b0a;
+    --grim-color-banner-fg: #f0d78c;
+    --grim-color-banner-border: #8a6d1a;
+
+    color-scheme: dark;
+  }
+}

package/dist/validate/adapters/http.d.ts

@@ -9,6 +9,17 @@
 export declare const USER_AGENT = "grim-indexer-bot";
 export declare const TIMEOUT_MS = 30000;
 export declare const MAX_RESPONSE_BYTES: number;
+/**
+ * The cap for the two calls that legitimately read more than a small JSON
+ * document: the enrichment checkpoint, which is the whole sidecar tree, and a
+ * ratings page, which carries every thread's full body — including bodies this
+ * bot did not write.
+ *
+ * The same ceiling `enrich` already accepts from one `grim` subprocess
+ * (`MAX_OUTPUT_BYTES`), so the largest thing this toolchain holds in memory is
+ * one number rather than three.
+ */
+export declare const LARGE_RESPONSE_BYTES: number;
 export interface HttpResponse {
     /** HTTP status, or 0 when the request never completed. */
     status: number;
@@ -19,6 +30,18 @@ export interface HttpResponse {
 export interface RequestOptions {
     method?: string;
     body?: string;
+    /**
+     * Response-size cap for this call, in bytes. Defaults to
+     * [`MAX_RESPONSE_BYTES`], so every call site that does not ask keeps the
+     * reply it already got, byte for byte.
+     *
+     * Per-call because the default is sized for a small JSON document, and two
+     * callers legitimately read more: the enrichment checkpoint is the whole
+     * sidecar tree, and a ratings page carries every thread's full body. Both
+     * used to surface as `{status: 0}` — indistinguishable from a transport
+     * failure, which is how an oversized page got reported as one.
+     */
+    maxBytes?: number;
 }
 export declare function request(url: string, headers?: Record<string, string>, options?: RequestOptions): Promise<HttpResponse>;
 /** `request` plus a `JSON.parse` that yields `null` instead of throwing. */

package/dist/validate/adapters/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/validate/adapters/http.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAC7C,eAAO,MAAM,UAAU,QAAS,CAAC;AACjC,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AA4BD,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAwBvB;AAED,4EAA4E;AAC5E,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ5C"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/validate/adapters/http.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAC7C,eAAO,MAAM,UAAU,QAAS,CAAC;AACjC,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AA4BD,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAwBvB;AAED,4EAA4E;AAC5E,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ5C"}

package/dist/validate/adapters/http.js

@@ -11,6 +11,17 @@
 export const USER_AGENT = "grim-indexer-bot";
 export const TIMEOUT_MS = 30_000;
 export const MAX_RESPONSE_BYTES = 1024 * 1024;
+/**
+ * The cap for the two calls that legitimately read more than a small JSON
+ * document: the enrichment checkpoint, which is the whole sidecar tree, and a
+ * ratings page, which carries every thread's full body — including bodies this
+ * bot did not write.
+ *
+ * The same ceiling `enrich` already accepts from one `grim` subprocess
+ * (`MAX_OUTPUT_BYTES`), so the largest thing this toolchain holds in memory is
+ * one number rather than three.
+ */
+export const LARGE_RESPONSE_BYTES = 16 * 1024 * 1024;
 async function readCapped(response, cap) {
     if (!response.body)
         return "";
@@ -51,7 +62,7 @@ export async function request(url, headers = {}, options = {}) {
             redirect: "manual",
             signal: AbortSignal.timeout(TIMEOUT_MS),
         });
-        const body = await readCapped(response, MAX_RESPONSE_BYTES);
+        const body = await readCapped(response, options.maxBytes ?? MAX_RESPONSE_BYTES);
         if (body === null)
             return none;
         return {

package/dist/validate/adapters/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/validate/adapters/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/validate/adapters/http.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grimoire-rs/indexer",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "CLI + Astro integration for running your own grim package index",
   "type": "module",
   "license": "Apache-2.0",