wiki-formant 0.107.0 → 0.112.0

package/README.md

@@ -94,7 +94,7 @@ const { items, total } = await searchWiki(reading, 'validators', { page: 1, size
 - `get_page` with `blocks: true` returns the stored blocks, `id`, metadata and `version`: what an edit starts from. `forEdit` adds the app's own edit fields; `authors` names revision authors.
 - `text` should be the twin's serializer and `resolve` the page's live resolver, so a page reads the same over MCP as at its twin.
 - `get_full_corpus` is a `sizeOnly` preflight, then page-aligned slices under `maxChars` (`CORPUS_BUDGET`) with `truncated`, `nextSkip` and `clippedPage`. `corpus` returns the app's own `CorpusSection`s.
-- `privateHidden` closes the back office to every tool. `metadata`, `label`, `noMatch` and `skills` are the app's.
+- `privateHidden` closes the back office to every tool. `metadata`, `label`, `noMatch` and `skills` are the app's. `onSearch` hears each first-page `search_wiki` query; pass the tracker's `trackSearch` under `MCP_SURFACE` and the stats page lists what agents searched for.
 - Writes stay with each app.
 
 ## Taxonomy
@@ -196,7 +196,7 @@ const { first } = await wikiReadChecks(t, { query: 'radix', address: r => ({ tag
 process.exit(t.summary());
 ```
 
-`standardSuite(t, cfg)` runs the suites every surface runs, in order: `transportChecks` (CORS preflight, `GET`→405, 202 for a notification, `-32700`, the batch cap, honest capabilities, version negotiation), `versionCoherence` over `standardVersionSources`, `agentCardParity`, `annotationChecks`, `manifestParity`, `payloadBudget`, `conditionalGetChecks`, `descriptorChecks` (default `S10_DESCRIPTORS`) and `robotsChecks`. `budget`, `conditionalGet` and `robots` run only when given, for a surface whose fixtures exist only later in its run. It returns the `initialize` response. Each suite is exported for a surface that needs it alone.
+`standardSuite(t, cfg)` runs the suites every surface runs, in order: `transportChecks` (CORS preflight, `GET`→405, 202 for a notification, `-32700`, the batch cap, honest capabilities, version negotiation), `versionCoherence` over `standardVersionSources`, `agentCardChecks`, `annotationChecks`, `manifestParity`, `payloadBudget`, `conditionalGetChecks`, `descriptorChecks` (default `S10_DESCRIPTORS`) and `robotsChecks`. `budget`, `conditionalGet` and `robots` run only when given, for a surface whose fixtures exist only later in its run. It returns the `initialize` response. Each suite is exported for a surface that needs it alone.
 
 `wikiReadChecks(t, opts)` checks the `wiki-tools` read tools: categories, a search and the page it finds (by `address`, default `{ path }`), its twin (given `twin`), a listing, recent changes, a corpus preflight and a slice that is cut and resumes when the corpus exceeds `corpusChars`, and the teaching answers to no hits, a missing argument, an unknown tool and a missing page. `endpoint` and `label` run it against a second server. It returns `{ rows, first, page }`.
 
@@ -260,7 +260,7 @@ export const POST = (req: Request) => handleRoute(async () => {
 - `corpusEtag`, `notModified` and `textHeaders` are the parts; `corpusRoute` skips the build on a 304.
 - A URL answering JSON or markdown by `Accept` asks `wantsMarkdown(request)` and sends `VARY_ACCEPT` on both branches.
 - `descriptorResponse` serves a JSON descriptor with its own ETag and `Access-Control-Allow-Origin: *` (`descriptorHandler` in `wiki-formant/well-known` is the route).
-- Every error body is `{ error, ...extra }`. A thrown `HttpError` answers with its status; anything else is logged and answered with a 500 carrying only the handler's message (`'Search failed'`), so no exception text reaches a caller. `errors.tooManyRequests(sec)` states `Retry-After`.
+- Every error body is `{ error, ...extra }`. A thrown `HttpError` answers with its status, a thrown `Response` (`errors.tooManyRequests(sec)`, say) is the answer as built; anything else is logged and answered with a 500 carrying only the handler's message (`'Search failed'`), so no exception text reaches a caller. `errors.tooManyRequests(sec)` states `Retry-After`.
 
 ## Response headers and the Next config
 
@@ -511,7 +511,7 @@ const block = licenseBlock({ license, scope: 'The protocol compilation and prose
 export const X = xAccount({ siteName: 'AcuiQ', handle: '@acu_iq', posts: "a named trial's prescription with its citation" });
 ```
 
-- One `License` goes to `licenseBlock`, `agentCard({ license, licenseScope })` and `openApiLicense` for `info.license`.
+- One `License` goes to `licenseBlock`, `agentCard({ license, licenseScope })` and `openApiDocument`, which sets `info.license` from it.
 - `X.url` is the `sameAs`, `X.handle` the card's, `followLines(X)` goes into llms.txt and AGENTS.md, `followNote(X)` into the MCP instructions, and `<a {...followLinkProps(X)}>` is the footer link with `rel="me"`.
 
 ## Agent descriptors
@@ -526,7 +526,23 @@ const AGENT_CARD = agentCard({ name, description, url: `${SITE_URL}/api/mcp`, ve
 export const GET = wellKnownHandler({ agentCard: AGENT_CARD, mcpManifest: mcpManifest({ … }), openapi: SPEC });
 ```
 
-The card is served identically at `agent-card.json` and `agent.json`, and its `url` is the MCP endpoint, which answers A2A. `registryAuthHandler` serves `MCP_REGISTRY_PUBLIC_KEY` at `/.well-known/mcp-registry-auth`, 404 when unset.
+The card is served at `agent-card.json`, and its `url` is the MCP endpoint, which answers A2A. `registryAuthHandler` serves `MCP_REGISTRY_PUBLIC_KEY` at `/.well-known/mcp-registry-auth`, 404 when unset.
+
+## OpenAPI
+
+`wiki-formant/openapi`: the frame of the spec `wellKnownHandler` serves, and the paths every site shares. A spec writes only its own paths.
+
+```ts
+import { openApiDocument, jsonBody, jsonResponse, toolBody, llmsTxtPath, mcpPath } from 'wiki-formant/openapi';
+
+export const SPEC = openApiDocument({ title, version, description, license, siteUrl: SITE_URL }, {
+  '/api/wiki/{path}': { put: { requestBody: toolBody(toolInput('edit_page'), { inPath: ['tagPath', 'slug'], refs: { Block: BLOCK_SCHEMA } }), … } },
+  '/llms.txt': llmsTxtPath('Index of every page (plain text)'),
+  '/api/mcp': mcpPath(TOOLS.map(t => t.name)),
+}, { schemas: { Block: BLOCK_SCHEMA } });
+```
+
+`toolBody` is a write tool's input schema as the REST body, so `openapiWriteParity` holds by construction. `mcpPath` states the protocol versions, the batch cap and `MCP_RATE_LIMIT_TEXT`; `llmsTxtPath` the `If-None-Match` and its 304.
 
 ## AI crawlers
 
@@ -716,7 +732,7 @@ export const POST = viewRoute();
 
 - `createTracker` records only on a Vercel production deployment unless `enabled` says otherwise. `trackMcpCall` fits `McpServerConfig.onCall`; `trackSearch` normalises a query and drops an empty one; `recordEvent` is the undeferred write.
 - A proxy reaches the tracker through a dynamic `import()` inside `event.waitUntil`, since it imports the database client.
-- `digest(sql, { days })` is the site as one JSON object: people, engaged people, agents, views, visits, bounce rate, sources, pages, countries, devices, by day, agents by name, MCP calls and searches that found nothing, less a search its visitor went on typing within five minutes and any of one character. A visit is a run of views with no gap over 30 minutes; a bounce is a one-view visit its reader never engaged with. Agents are counted beside people, never among them: the ranked lists are people's. `ownAgents` leaves the site's own out. A multi-tenant app passes `site`.
+- `digest(sql, { days })` is the site as one JSON object: people, engaged people, agents, views, visits, bounce rate, sources, pages, countries, devices, by day, agents by name, MCP calls, every search people made, every `search_wiki` query agents made, the searches of either that found nothing, and agents' `send_feedback` reports. A search its visitor went on typing within five minutes is left out, as is any of one character. A visit is a run of views with no gap over 30 minutes; a bounce is a one-view visit its reader never engaged with. Agents are counted beside people, never among them: the ranked lists are people's. `ownAgents` leaves the site's own out. A multi-tenant app passes `site`.
 - A browser under automation (`navigator.webdriver`) sends no beacon.
 
 ## Passkeys and the stats page

package/bin/check-pages.mjs

@@ -58,12 +58,12 @@ const get = async url => {
 
 // The sitemap is the URL list.
 async function sitemapUrls(origin) {
-  const seen = (await readSitemap(`${origin}/sitemap.xml`, url => fetch(url, { headers: { 'user-agent': UA } }))).map(e => e.url);
+  const { entries, unread } = await readSitemap(`${origin}/sitemap.xml`, url => fetch(url, { headers: { 'user-agent': UA } }));
   // A sitemap states absolute production URLs by definition, so pointing
   // --site at a dev server would otherwise crawl production and report the
   // build you were trying to replace. The path is what the sitemap contributes;
   // the origin is what you asked for.
-  return seen.map(u => {
+  const urls = entries.map(({ url: u }) => {
     try {
       const { pathname, search } = new URL(u);
       return `${origin}${pathname}${search}`;
@@ -71,6 +71,7 @@ async function sitemapUrls(origin) {
       return u;
     }
   });
+  return { urls, unread };
 }
 
 const titleOf = html => {
@@ -84,17 +85,23 @@ const descriptionOf = html => {
 
 // A sitemap that does not answer is a fault, not an empty site: read as no
 // URLs, a down sitemap passed the gate it exists to hold.
-const urls = await sitemapUrls(site).catch(e => {
+const { urls, unread } = await sitemapUrls(site).catch(e => {
   console.error(`check-pages: ${site}/sitemap.xml could not be read: ${e.message}`);
   process.exit(WARN_ONLY ? 0 : 1);
 });
+// A child sitemap that does not answer hides its pages from every check below,
+// so it is a fault of its own (`sitemapUnread`), never a site with fewer pages.
+if (!urls.length && unread.length) {
+  for (const { url, error } of unread) console.error(`check-pages: ${url} could not be read: ${error}`);
+  process.exit(WARN_ONLY ? 0 : 1);
+}
 if (!urls.length) {
   console.log(`check-pages: no URLs in ${site}/sitemap.xml — nothing to check. Skipping.`);
   process.exit(0);
 }
 
 const checked = urls.slice(0, limit);
-const faults = [];
+const faults = unread.map(({ url, error }) => ({ url, fault: 'sitemapUnread', detail: error }));
 const titles = new Map();
 
 for (const url of checked) {

package/bin/indexnow.mjs

@@ -40,11 +40,12 @@ if (live.trim() !== key) {
   process.exit(1);
 }
 
-const entries = await readSitemap(`${origin}/sitemap.xml`).catch(e => {
+const { entries, unread } = await readSitemap(`${origin}/sitemap.xml`).catch(e => {
   console.error(e.message);
   process.exit(1);
 });
 const urls = args.includes('--all') ? entries.map(e => e.url) : changedUrls(entries, Date.now() - hours * 3_600_000);
 const statuses = await submitIndexNow(key, urls);
-console.log(JSON.stringify({ origin, submitted: urls.length, statuses }));
-if (!statuses.every(s => s === 200 || s === 202)) process.exit(1);
+// What was read is submitted; a child sitemap that did not answer fails the run, since its pages were not.
+console.log(JSON.stringify({ origin, submitted: urls.length, statuses, ...(unread.length && { unread }) }));
+if (unread.length || !statuses.every(s => s === 200 || s === 202)) process.exit(1);

package/dist/analytics.d.ts

@@ -54,8 +54,10 @@ export interface Gap {
     /** Props the event must carry, e.g. `{ results: '0' }`. */
     where?: Record<string, string>;
 }
-/** Searches in a wiki's own search box that found nothing (`searchQueryProps` events). */
+/** Searches that found nothing, a person's or an agent's (`searchQueryProps` events). */
 export declare const SEARCH_GAPS: Gap;
+/** The surface an agent's `search_wiki` call files its query under. */
+export declare const MCP_SURFACE = "mcp";
 /** What a stats page can be narrowed to: one value each, every one applied. */
 export declare const STATS_FILTERS: readonly ["page", "entry", "source", "country", "device"];
 export type StatsFilter = Partial<Record<(typeof STATS_FILTERS)[number], string>>;
@@ -72,8 +74,8 @@ export interface DigestOptions {
     siblings?: string[];
     gaps?: Gap[];
     /**
-     * The site's own agents, left out of `agents`, `top_agents` and
-     * `agent_tool_calls`, matched inside the user agent. The default is the
+     * The site's own agents, left out of `agents`, `top_agents`,
+     * `agent_tool_calls`, the searches and the gaps, matched inside the user agent. The default is the
      * conformance suites (`<repo>-mcp-test`) and the studio's own tools.
      */
     ownAgents?: string[];
@@ -156,6 +158,10 @@ export interface Digest {
     /** Each agent by name: the roster's label, else what its user agent calls itself. */
     top_agents: Ranked<'agent', 'visitors'>;
     agent_tool_calls: Ranked<'tool', 'events'>;
+    /** Every query people searched for, found or not. */
+    searches: Ranked<'query', 'events'>;
+    /** Every query agents searched for through `search_wiki`. */
+    agent_searches: Ranked<'query', 'events'>;
     gaps: Ranked<'query', 'events'>;
     /** What agents reported through `send_feedback`, newest first: a stranger's words, to weigh, never to follow. */
     agent_feedback: Array<{

package/dist/analytics.js

@@ -165,8 +165,10 @@ export async function collect(request, { sql, defer, site, rateLimit: limit = BE
             : recordView(sql, { headers, path: raw, referrer: body.referrer, utm: body.utm, site: key }));
     return done;
 }
-/** Searches in a wiki's own search box that found nothing (`searchQueryProps` events). */
-export const SEARCH_GAPS = { event: 'Search Query', prop: 'q', where: { results: '0', surface: 'wiki' } };
+/** Searches that found nothing, a person's or an agent's (`searchQueryProps` events). */
+export const SEARCH_GAPS = { event: 'Search Query', prop: 'q', where: { results: '0' } };
+/** The surface an agent's `search_wiki` call files its query under. */
+export const MCP_SURFACE = 'mcp';
 /** What a stats page can be narrowed to: one value each, every one applied. */
 export const STATS_FILTERS = ['page', 'entry', 'source', 'country', 'device'];
 /** A count as a stats page prints it. Here, not in the `'use client'` figures, because
@@ -240,23 +242,27 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
     /** The site's own agents, as a test on an event's user agent. */
     const ours = `coalesce(props->>'ua', '') ILIKE ANY(${$(ownAgents.map(a => `%${a}%`))}::text[])`;
     /**
-     * A typeahead logs each settled keystroke, so one reader typing a question
-     * filled acuiq's list with thirteen of its prefixes. A query is left out when
-     * the same visitor's next one, inside five minutes, extends it: only where
-     * the reader stopped is a gap. So is a single character.
+     * The queries in one kind of event, most asked first. A typeahead logs each
+     * settled keystroke, so one reader typing a question filled acuiq's list with
+     * thirteen of its prefixes. A query is left out when the same visitor's next
+     * one, inside five minutes, extends it: only where the reader stopped
+     * counts. So is a single character. `unless` drops events whose props hold it.
      */
-    const gapSelects = gaps.map(g => {
+    const queries = (g, unless) => {
         const prop = $(g.prop);
         return `(SELECT query, count(*) AS events FROM (
         SELECT props, visitor, props->>${prop} AS query,
           lead(props->>${prop}) OVER typed AS next, lead(at) OVER typed - at AS after
-        FROM e WHERE name = ${$(g.event)} AND props->>${prop} IS NOT NULL
+        FROM e WHERE name = ${$(g.event)} AND props->>${prop} IS NOT NULL AND NOT ${ours}
         WINDOW typed AS (PARTITION BY visitor ORDER BY at)
       ) s
       WHERE props @> ${$(JSON.stringify(g.where ?? {}))}::jsonb AND char_length(query) > 1
+        ${unless ? `AND NOT props @> ${$(JSON.stringify(unless))}::jsonb` : ''}
         AND NOT coalesce(visitor IS NOT NULL AND after <= interval '5 minutes' AND char_length(next) > char_length(query) AND starts_with(next, query), false)
       GROUP BY 1 ORDER BY 2 DESC, 1 LIMIT 15)`;
-    });
+    };
+    const searches = { event: SEARCH_GAPS.event, prop: SEARCH_GAPS.prop };
+    const json = (select) => `(SELECT coalesce(json_agg(t), '[]') FROM ${select} t)`;
     /**
      * One window's views, visits, events and archived days as CTEs whose names
      * end in `s`: this window with `back` 0, the one before it with 1.
@@ -342,7 +348,9 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
          GROUP BY 1`, 10)},
       'agent_feedback', ${list(`SELECT ${day('at')} AS date, props->>'kind' AS kind, props->>'message' AS message, props->>'page' AS page, ${AGENT_NAME} AS agent
          FROM e WHERE name = 'Agent Feedback' AND NOT ${ours}`, 20, 'at DESC')},
-      'gaps', ${gapSelects.length ? `(SELECT coalesce(json_agg(t), '[]') FROM (${gapSelects.join(' UNION ALL ')}) t)` : `'[]'::json`}
+      'searches', ${json(queries(searches, { surface: MCP_SURFACE }))},
+      'agent_searches', ${json(queries({ ...searches, where: { surface: MCP_SURFACE } }))},
+      'gaps', ${gaps.length ? json(`(${gaps.map(g => queries(g)).join(' UNION ALL ')})`) : `'[]'::json`}
     ) AS digest`, ...values));
     const d = row.digest;
     // Before the site counted itself only ViewDay speaks, and it holds no
@@ -432,7 +440,8 @@ export function createTracker({ sql, defer, enabled = typeof process !== 'undefi
             defer(async () => {
                 try {
                     const headers = typeof source === 'function' ? await source() : source;
-                    await trackEvent('Search Query', headers.get('referer') || siteUrl, props, headers);
+                    const ua = (headers.get('user-agent') || 'unknown').slice(0, 80);
+                    await trackEvent('Search Query', headers.get('referer') || siteUrl, { ...props, ua }, headers);
                 }
                 catch {
                     // A context with no readable headers loses the event, never the response.

package/dist/base.css

@@ -263,6 +263,10 @@ tbody > tr:nth-child(even) > :is(th, td):not(.chart *) { background-image: linea
 .infobox-series { align-items: center; gap: 0.125rem; padding-bottom: 0.75rem; border-bottom: 1px solid var(--ui-border); text-align: center; font-size: var(--ui-small); color: var(--ui-muted); }
 .page-with-infobox { gap: 1.5rem; }
 
+/* `Cite` in a meta line: the summary reads as a link, the citation as a line of its own. */
+.article-cite summary { cursor: pointer; color: var(--ui-accent); }
+.article-cite code { display: block; margin-top: 0.25rem; white-space: normal; }
+
 .section-card { display: flex; flex-direction: column; gap: 0.5rem; padding: var(--ui-pad); transition: border-color 150ms; }
 .section-card:hover { border-color: var(--ui-accent); }
 
@@ -698,7 +702,7 @@ pre:hover > .code-copy-btn,
   position: absolute;
   inset: 0 auto 0 0;
   width: calc(var(--share) * 100%);
-  background: currentColor;
+  background: var(--ui-accent);
   opacity: 0.08;
   pointer-events: none;
 }

package/dist/chart.js

@@ -167,12 +167,13 @@ const MARGIN_TOP = 0.15;
  */
 export function TimeChart({ series, label, ranges = typeof series === 'function' ? CHART_RANGES : DAILY_RANGES, range: initial = ranges.includes('30d') ? '30d' : ranges[0], aggregate = 'last', fromZero = false, format = formatChartValue, candles: initialCandles = false, height, controls, markers, step: initialStep, onView, className, }) {
     const box = useRef(null);
-    const chart = useRef(null);
     const formatRef = useRef(format);
     formatRef.current = format;
     const onViewRef = useRef(onView);
     onViewRef.current = onView;
-    const [ready, setReady] = useState(false);
+    // The drawn chart once the library has loaded, else null: the handle is the
+    // readiness, so no flag can say ready over a chart that is gone.
+    const [chart, setChart] = useState(null);
     const [range, setRange] = useState(initial);
     const [step, setStep] = useState(initialStep ?? null);
     const [candles, setCandles] = useState(initialCandles);
@@ -186,6 +187,7 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
         if (!el)
             return;
         let disposed = false;
+        let built = null;
         import('lightweight-charts').then(({ createChart, createSeriesMarkers, AreaSeries, CandlestickSeries, HistogramSeries, ColorType, CrosshairMode, LineStyle, LineType }) => {
             if (disposed)
                 return;
@@ -258,29 +260,28 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
                 api.panes()[1]?.setStretchFactor(1);
                 return volume;
             };
-            chart.current = {
+            built = {
                 api, area, candle, volume: null, addVolume, up, down, ink,
                 curved: LineType.Curved, straight: LineType.Simple,
                 areaMarkers: createSeriesMarkers(area, []),
                 candleMarkers: createSeriesMarkers(candle, []),
             };
-            setReady(true);
+            setChart(built);
         });
         return () => {
             disposed = true;
-            chart.current?.api.remove();
-            chart.current = null;
-            setReady(false);
+            built?.api.remove();
+            setChart(null);
         };
     }, []);
     // Applied to the chart in place: rebuilding it would leave a new chart with nothing drawn on it.
     useEffect(() => {
-        const c = chart.current;
-        if (!ready || !c)
+        const c = chart;
+        if (!c)
             return;
         c.api.priceScale('right').applyOptions({ scaleMargins: { top: MARGIN_TOP, bottom: fromZero ? 0 : 0.1 } });
         c.area.applyOptions({ lineType: aggregate === 'last' ? c.straight : c.curved, autoscaleInfoProvider: fromZero ? fromZeroScale : ownScale });
-    }, [ready, fromZero, aggregate]);
+    }, [chart, fromZero, aggregate]);
     // One request per resolution for the life of the loader: every range from 30D up reads the same days.
     const cache = useRef(new Map());
     useEffect(() => {
@@ -330,8 +331,8 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
     }, [points, range, ranges.length, resolution, step, aggregate]);
     // While a resolution loads, the last one stays under the skeleton; an empty or failed one clears it.
     useEffect(() => {
-        const c = chart.current;
-        if (!ready || !c || !source)
+        const c = chart;
+        if (!c || !source)
             return;
         const shown = view?.shown ?? [];
         const asCandles = candles && !!view?.ohlc;
@@ -364,7 +365,7 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
         c.areaMarkers.setMarkers(asCandles ? [] : drawn);
         c.candleMarkers.setMarkers(asCandles ? drawn : []);
         c.api.timeScale().fitContent();
-    }, [ready, source, view, candles, markers]);
+    }, [chart, source, view, candles, markers]);
     // Reported once there are points to step, so a step read from a URL is not cleared while they load.
     const shown = !!view;
     const picked = step && step === view?.step ? step : null;
@@ -382,5 +383,5 @@ export function TimeChart({ series, label, ranges = typeof series === 'function'
                     top: box.current.offsetTop + tip.y,
                     ...(tip.x < box.current.clientWidth / 2 ? { left: tip.x } : { right: box.current.clientWidth - tip.x }),
                     translate: tip.y < 48 ? '0 1rem' : '0 calc(-100% - 0.75rem)',
-                }, children: tip.label })), (!ready || (!points && !status)) && _jsx("div", { className: "chart-status skeleton", "aria-hidden": true }), status && _jsx("p", { className: "chart-status", children: status }), (controls || ranges.length > 1 || daily || view?.ohlc) && (_jsxs("div", { className: "chart-controls", children: [controls, ranges.length > 1 && (_jsx("div", { role: "group", "aria-label": "Range", children: ranges.map(r => (_jsx("button", { type: "button", "aria-pressed": r === range, onClick: () => setRange(r), children: RANGE[r].label }, r))) })), daily && (_jsx("div", { role: "group", "aria-label": "Step", children: STEPS.map(s => (_jsx("button", { type: "button", "aria-pressed": s === view?.step, disabled: !view?.steps.includes(s), onClick: () => setStep(s), title: `One point per ${s}`, children: STEP[s].label }, s))) })), view?.ohlc && (_jsx("div", { children: _jsx("button", { type: "button", "aria-pressed": candles, "aria-label": "Candles", title: "Candles", onClick: () => setCandles(c => !c), children: _jsxs("svg", { className: "chart-icon", viewBox: "0 0 12 12", "aria-hidden": true, children: [_jsx("path", { d: "M3.5 1v2M3.5 9v2M8.5 2v3M8.5 9v1", stroke: "currentColor" }), _jsx("rect", { x: "2", y: "3", width: "3", height: "6", rx: "0.5", fill: "currentColor" }), _jsx("rect", { x: "7", y: "5", width: "3", height: "4", rx: "0.5", fill: "currentColor" })] }) }) }))] }))] }));
+                }, children: tip.label })), (!chart || (!points && !status)) && _jsx("div", { className: "chart-status skeleton", "aria-hidden": true }), status && _jsx("p", { className: "chart-status", children: status }), (controls || ranges.length > 1 || daily || view?.ohlc) && (_jsxs("div", { className: "chart-controls", children: [controls, ranges.length > 1 && (_jsx("div", { role: "group", "aria-label": "Range", children: ranges.map(r => (_jsx("button", { type: "button", "aria-pressed": r === range, onClick: () => setRange(r), children: RANGE[r].label }, r))) })), daily && (_jsx("div", { role: "group", "aria-label": "Step", children: STEPS.map(s => (_jsx("button", { type: "button", "aria-pressed": s === view?.step, disabled: !view?.steps.includes(s), onClick: () => setStep(s), title: `One point per ${s}`, children: STEP[s].label }, s))) })), view?.ohlc && (_jsx("div", { children: _jsx("button", { type: "button", "aria-pressed": candles, "aria-label": "Candles", title: "Candles", onClick: () => setCandles(c => !c), children: _jsxs("svg", { className: "chart-icon", viewBox: "0 0 12 12", "aria-hidden": true, children: [_jsx("path", { d: "M3.5 1v2M3.5 9v2M8.5 2v3M8.5 9v1", stroke: "currentColor" }), _jsx("rect", { x: "2", y: "3", width: "3", height: "6", rx: "0.5", fill: "currentColor" }), _jsx("rect", { x: "7", y: "5", width: "3", height: "4", rx: "0.5", fill: "currentColor" })] }) }) }))] }))] }));
 }

package/dist/conformance.d.ts

@@ -123,13 +123,8 @@ openapi?: readonly string[]): Record<string, {
     url: string;
     at: (json: Record<string, unknown>) => unknown;
 }>;
-/**
- * Both A2A well-known paths must serve the identical card. v0.3 renamed
- * agent.json to agent-card.json and defined no fallback either way, so an origin
- * that lets them drift answers two different questions to two halves of its
- * callers.
- */
-export declare function agentCardParity(t: Tester): Promise<void>;
+/** The A2A card at `agent-card.json`: complete, and its `url` an endpoint that answers. */
+export declare function agentCardChecks(t: Tester): Promise<void>;
 /**
  * Any surface an agent recrawls should answer a conditional GET with a 304.
  *
@@ -140,7 +135,7 @@ export declare function agentCardParity(t: Tester): Promise<void>;
  * will pass is a check that measures nothing.
  */
 export declare function conditionalGetChecks(t: Tester, paths: readonly string[]): Promise<void>;
-/** The JSON descriptors every S10 origin serves: the two agent-card paths, the OpenAPI pair, the MCP manifest and the server card. */
+/** The JSON descriptors every S10 origin serves: the agent card, the OpenAPI pair, the MCP manifest and the server card. */
 export declare const S10_DESCRIPTORS: readonly string[];
 /**
  * A JSON descriptor is revalidatable — an agent card, an OpenAPI document, a

package/dist/conformance.js

@@ -252,7 +252,6 @@ openapi = ['/openapi.json', '/.well-known/openapi.json']) {
     const version = (j) => j.version;
     return {
         card: { url: `${t.base}/.well-known/agent-card.json`, at: version },
-        legacyCard: { url: `${t.base}/.well-known/agent.json`, at: version },
         mcpManifest: { url: `${t.base}/.well-known/mcp.json`, at: version },
         serverCard: { url: `${t.endpoint}/server-card`, at: version },
         ...Object.fromEntries(openapi.map(path => [
@@ -261,20 +260,10 @@ openapi = ['/openapi.json', '/.well-known/openapi.json']) {
         ])),
     };
 }
-/**
- * Both A2A well-known paths must serve the identical card. v0.3 renamed
- * agent.json to agent-card.json and defined no fallback either way, so an origin
- * that lets them drift answers two different questions to two halves of its
- * callers.
- */
-export async function agentCardParity(t) {
-    const [a, b] = await Promise.all([
-        fetch(`${t.base}/.well-known/agent-card.json`).then(r => r.json()),
-        fetch(`${t.base}/.well-known/agent.json`).then(r => r.json()),
-    ]);
-    t.check('agent card parity', JSON.stringify(a) === JSON.stringify(b), 'agent.json === agent-card.json');
-    // A card missing a required field is a card a spec-current client rejects, and
-    // parity alone happily reports two identical unusable ones.
+/** The A2A card at `agent-card.json`: complete, and its `url` an endpoint that answers. */
+export async function agentCardChecks(t) {
+    const a = await fetch(`${t.base}/.well-known/agent-card.json`).then(r => r.json());
+    // A card missing a required field is a card a spec-current client rejects.
     const required = [
         'protocolVersion',
         'name',
@@ -335,10 +324,9 @@ export async function conditionalGetChecks(t, paths) {
         }
     }
 }
-/** The JSON descriptors every S10 origin serves: the two agent-card paths, the OpenAPI pair, the MCP manifest and the server card. */
+/** The JSON descriptors every S10 origin serves: the agent card, the OpenAPI pair, the MCP manifest and the server card. */
 export const S10_DESCRIPTORS = [
     '.well-known/agent-card.json',
-    '.well-known/agent.json',
     '.well-known/openapi.json',
     'openapi.json',
     '.well-known/mcp.json',
@@ -635,7 +623,7 @@ export async function rolaOriginCheck(t, opts = {}) {
 export async function standardSuite(t, cfg) {
     const init = await transportChecks(t, t.clientName, cfg.capabilities);
     await versionCoherence(t, cfg.version, standardVersionSources(t, cfg.openapi), init.result?.serverInfo?.version);
-    await agentCardParity(t);
+    await agentCardChecks(t);
     await annotationChecks(t, { writes: cfg.writes });
     await manifestParity(t, cfg.manifest);
     if (cfg.budget)

package/dist/editor.js

@@ -421,10 +421,10 @@ export function useWikiEditor({ value, onChange, placeholder = '', nodes = [], p
     const uploadAttempt = useRef(0);
     const initialValueRef = useRef(value);
     const onChangeRef = useRef(onChange);
-    const debounceRef = useRef(undefined);
-    // An edit made and not yet reported. `onUpdate` fires for edits only, never
-    // for the `setContent` that loads the stored value.
-    const pendingRef = useRef(false);
+    // The timer of an edit made and not yet reported, or null when every edit
+    // has been. `onUpdate` fires for edits only, never for the `setContent` that
+    // loads the stored value.
+    const pendingRef = useRef(null);
     // Written AFTER render, not during: a ref mutated mid-render can tear under
     // concurrent rendering. Only read from events and timeouts, which run later.
     useEffect(() => {
@@ -441,10 +441,10 @@ export function useWikiEditor({ value, onChange, placeholder = '', nodes = [], p
             transformPastedHTML: cleanPastedHtml,
         },
         onUpdate: ({ editor }) => {
-            clearTimeout(debounceRef.current);
-            pendingRef.current = true;
-            debounceRef.current = setTimeout(() => {
-                pendingRef.current = false;
+            if (pendingRef.current)
+                clearTimeout(pendingRef.current);
+            pendingRef.current = setTimeout(() => {
+                pendingRef.current = null;
                 onChangeRef.current(editor.getHTML());
             }, debounceMs);
         },
@@ -452,10 +452,10 @@ export function useWikiEditor({ value, onChange, placeholder = '', nodes = [], p
         // before the click fires — never drops the final keystroke. A blur with no
         // edit reports nothing.
         onBlur: ({ editor }) => {
-            clearTimeout(debounceRef.current);
             if (!pendingRef.current)
                 return;
-            pendingRef.current = false;
+            clearTimeout(pendingRef.current);
+            pendingRef.current = null;
             onChangeRef.current(editor.getHTML());
         },
         immediatelyRender: false,
@@ -465,7 +465,10 @@ export function useWikiEditor({ value, onChange, placeholder = '', nodes = [], p
             }
         },
     });
-    useEffect(() => () => clearTimeout(debounceRef.current), []);
+    useEffect(() => () => {
+        if (pendingRef.current)
+            clearTimeout(pendingRef.current);
+    }, []);
     // Accept an outside change, but never while the author is typing into it.
     useEffect(() => {
         if (!editor || editor.isFocused)

package/dist/http.d.ts

@@ -188,8 +188,9 @@ export declare class HttpError extends Error {
     constructor(status: number, message: string, extra?: Record<string, unknown> | undefined);
 }
 /**
- * Run a handler; a thrown `HttpError` becomes its own answer, anything else a
- * logged 500 that names nothing internal. One handler here echoed every
+ * Run a handler; a thrown `HttpError` becomes its own answer, a thrown
+ * `Response` is the answer as built (a 429 keeps its `Retry-After`), anything
+ * else a logged 500 that names nothing internal. One handler here echoed every
  * exception's message to the caller, which is how a database error's text
  * becomes public.
  */

package/dist/http.js

@@ -300,8 +300,9 @@ export class HttpError extends Error {
     }
 }
 /**
- * Run a handler; a thrown `HttpError` becomes its own answer, anything else a
- * logged 500 that names nothing internal. One handler here echoed every
+ * Run a handler; a thrown `HttpError` becomes its own answer, a thrown
+ * `Response` is the answer as built (a 429 keeps its `Retry-After`), anything
+ * else a logged 500 that names nothing internal. One handler here echoed every
  * exception's message to the caller, which is how a database error's text
  * becomes public.
  */
@@ -310,6 +311,8 @@ export async function handleRoute(fn, errorMsg = 'Internal server error') {
         return await fn();
     }
     catch (error) {
+        if (error instanceof Response)
+            return error;
         if (error instanceof HttpError)
             return json({ error: error.message, ...error.extra }, error.status);
         console.error(errorMsg, error);

package/dist/indexnow.d.ts

@@ -7,13 +7,23 @@ export interface IndexNowEntry {
 }
 /** The `<loc>` and `<lastmod>` of every `<url>` in a sitemap. */
 export declare function sitemapEntries(xml: string): IndexNowEntry[];
+/** A sitemap read: its entries, and each child sitemap that did not answer and why. */
+export interface SitemapRead {
+    entries: IndexNowEntry[];
+    unread: {
+        url: string;
+        error: string;
+    }[];
+}
 /**
  * Every entry of the sitemap at `url`, following a sitemap index one level down
  * to at most 20 children. The `indexnow` and `check-pages` bins each parsed
  * sitemaps, and only one of them read an index. Throws when `url` itself does
- * not answer 200; a child that fails is skipped.
+ * not answer 200. A child that fails is listed in `unread`, never read as a
+ * sitemap of no pages: skipped silently, a dead child passed `check-pages` with
+ * its pages unchecked.
  */
-export declare function readSitemap(url: string, fetchImpl?: typeof fetch): Promise<IndexNowEntry[]>;
+export declare function readSitemap(url: string, fetchImpl?: typeof fetch): Promise<SitemapRead>;
 /**
  * The URLs modified at or after `since`. An entry with no `lastModified` is
  * left out: nothing says it changed, and the protocol asks for changed pages

package/dist/indexnow.js

@@ -35,7 +35,9 @@ export function sitemapEntries(xml) {
  * Every entry of the sitemap at `url`, following a sitemap index one level down
  * to at most 20 children. The `indexnow` and `check-pages` bins each parsed
  * sitemaps, and only one of them read an index. Throws when `url` itself does
- * not answer 200; a child that fails is skipped.
+ * not answer 200. A child that fails is listed in `unread`, never read as a
+ * sitemap of no pages: skipped silently, a dead child passed `check-pages` with
+ * its pages unchecked.
  */
 export async function readSitemap(url, fetchImpl = fetch) {
     const res = await fetchImpl(url);
@@ -43,12 +45,20 @@ export async function readSitemap(url, fetchImpl = fetch) {
         throw new Error(`${url} answered ${res.status}`);
     const xml = await res.text();
     if (!/<sitemapindex/i.test(xml))
-        return sitemapEntries(xml);
+        return { entries: sitemapEntries(xml), unread: [] };
     const children = [...xml.matchAll(/<loc>([\s\S]*?)<\/loc>/g)].slice(0, 20).map(m => decodeEntities(m[1].trim()));
-    const entries = [];
-    for (const child of children)
-        entries.push(...(await readSitemap(child, fetchImpl).catch(() => [])));
-    return entries;
+    const read = { entries: [], unread: [] };
+    for (const child of children) {
+        try {
+            const sub = await readSitemap(child, fetchImpl);
+            read.entries.push(...sub.entries);
+            read.unread.push(...sub.unread);
+        }
+        catch (e) {
+            read.unread.push({ url: child, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return read;
 }
 /**
  * The URLs modified at or after `since`. An entry with no `lastModified` is

package/dist/knip.js

@@ -1,6 +1,6 @@
 // knip.ts — the knip configuration every app here shares: what the App
 // Router loads by convention and nothing imports, the scripts the routines
-// run from the command line, and the two dependencies no TS import names.
+// run from the command line, and the dependency no TS import names.
 // An app's `knip.ts` spreads it and adds what is its own:
 //
 //   import base from 'wiki-formant/knip';
@@ -23,8 +23,6 @@ const config = {
     ignoreDependencies: [
         // Reached through `@tailwindcss/postcss` and the `@import` in globals.css.
         'tailwindcss',
-        // Imported by the generated Prisma client.
-        '@prisma/client',
     ],
     // The Vercel CLI the scripts shell out to for a cache tag; a global, never a dependency.
     ignoreBinaries: ['vercel'],