@instafy/cli 0.3.1 → 0.4.0

package/README.md

@@ -56,7 +56,9 @@ Run Instafy spaces locally and connect them back to Instafy Studio — from any
   - `instafy tunnel logs <tunnelId> --follow` — tail tunnel logs.
   - `instafy tunnel stop <tunnelId>` — stop + revoke a tunnel.
 - `instafy preview check --port <port>` — load a local site in a headless browser and list its errors, failed requests and a blank page, with desktop and phone screenshots. Local only; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#previews) for exit codes and settings.
-- `instafy web read <url…> --json` — read up to 6 public pages over plain HTTP and get their text, links and structured data with provenance, wrapped as untrusted page content. robots.txt (including AI-agent user agents), skill-listed link-only sites, private-address checks at every redirect, stop rules and per-turn caps are enforced; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#reading-web-pages-instafy-web-read).
+- `instafy web read <url…> --json` — read up to 6 public pages over plain HTTP and get their text, links and structured data with provenance, wrapped as untrusted page content. robots.txt (including AI-agent user agents), the web-research skill's `no-agents` link-only sites (built in, plus the space's additions) and translators', caches' and archives' copies of them, private-address checks at every redirect, stop rules and per-turn caps are enforced; a `no-reuse` site is read and marked `noReuse`; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#reading-web-pages-instafy-web-read).
+- `instafy web search "<query>" --json` — find links to read, in Octo's turns only, with the space's own search key (the web-research skill's providers: Brave, then Kagi). Results are untrusted leads: a link-only site's result keeps only its link and site name, keys go only to their provider's host, nothing is cached, and the room keeps only the query and the count; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#searching-for-links-instafy-web-search).
+- `instafy web link <site> [name=value…] --json` — the link the person opens in their own tab for a `no-agents` site (guided mode): the site's search template from the web-research skill's list, filled with checked, URL-encoded values, or its home page and what to type there when it bars deep links. Reads nothing.
 - `instafy secrets list` — list space secret metadata (names/descriptions, never values).
 - `instafy secrets get <name-or-id>` — inspect one space secret metadata entry.
 - `instafy secrets put <name> --value ...` — create/update a space secret.

package/dist/bind/bin/instafy-bind.mjs

@@ -59,7 +59,10 @@ init       Write a starter bound.json, index.html and handlers/hello.mjs. --star
            files are kept; --force overwrites them.
 check      Does the site show every item the request named (each product, stop or entry)? Reads the text of its
            HTML pages and every value in its data files (data.json, data/**/*.json), and lists the items it does
-           not show; exit 1 when one is missing, 2 when there is nothing to check. Items: --expect, plus an
+           not show. On a page of options (the compare and ranked starters' data.json) it also lists values that
+           only say nothing ("—", "n/a"), values without the page and day they were read, and a filter that
+           would count a row whose value is unknown; and it notes the rows a filter lists apart. Exit 1 when an
+           item is missing or a value needs fixing, 2 when there is nothing to check. Items: --expect, plus an
            "expect" array in data.json. Run it before telling anyone the page is done.
 command    Push a command (select, highlight, toast, reload) to every open viewer. Uses the
            admin token in .bind/admin-token.

package/dist/bind/src/check.mjs

@@ -4,7 +4,8 @@
 // every string in its data files (data.json, data/**/*.json, records included). Items come from --expect and from
 // an "expect" array in data.json. Text that only says an item is unavailable ("Not found yet: Tokyo", a data file's
 // "missing" list) does not count as showing it: builders are told to say on the page what they could not add, and
-// that line must not pass the check. Pure helpers are exported for the tests.
+// that line must not pass the check. On a page of options it also checks the values (below). Pure helpers are
+// exported for the tests.
 // SPDX-License-Identifier: AGPL-3.0-only
 import fs from "node:fs";
 import path from "node:path";
@@ -157,20 +158,206 @@ export function checkSite(dir, expect = []) {
   return { items, shown, missing, files: site.parts.map((p) => p.file) };
 }
 
-/** The CLI's lines and exit code: 0 every item shown, 1 some missing, 2 nothing to check. */
+// ---------- the values of a page of options (the compare and ranked starters' data.json) ----------
+// Each value on such a page names the page it was read on and the day ("checked 27 Oct on maker.com"), and a value
+// nobody found says so with why; a dash or "n/a" is not a value. A filter from a stated limit ("under €600") counts
+// only values the page shows: the starters' site.byFilter lists a row whose value is unknown apart ("Price
+// unknown"), never as within the limit. These rules read the data the same way site.js draws it.
+
+/** A value that only says nothing is known: blank, dashes, "?", "n/a", "unknown", "TBD" (site.js: no value). */
+export const NO_VALUE = /^(?:[\s\-\u2010-\u2015?.\u00b7\u2026/]*|n\s*\/\s*a|unknown|tb[ad])$/i;
+const valueOf = (fact) => (fact && typeof fact === "object" && fact.v != null ? String(fact.v) : "");
+const hasValue = (fact) => !!valueOf(fact) && !NO_VALUE.test(valueOf(fact).trim());
+const httpsUrl = (url) => {
+  try {
+    return new URL(String(url)).protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+
+/** The first number in a text, read the way shops write it (site.js: numberIn): a ".", ",", space or "'" before
+ *  exactly three digits groups thousands ("1.299", "1 299", "1,299" are 1299), and the last "." or "," is the decimal
+ *  mark otherwise ("1.299,00" is 1299, "549,99" is 549.99, "4.6" is 4.6). */
+export function numberIn(text) {
+  const m = /(-?)(\d+)((?:[.,'\u2019 \u00a0\u2009\u202f]\d+)*)/.exec(String(text ?? ""));
+  if (!m) return null;
+  const head = m[2];
+  const parts = m[3] ? m[3].match(/[.,'\u2019 \u00a0\u2009\u202f]\d+/g) : [];
+  const decimalMark = (p) => p[0] === "." || p[0] === ",";
+  let dec = -1;
+  parts.forEach((p, i) => {
+    if (decimalMark(p)) dec = i;
+  });
+  // the last "." or "," groups thousands when three digits follow it, one to three (not just 0) lead, and no other kind
+  // of decimal mark comes before it: "1.299", "1,299,000"
+  if (dec >= 0 && parts[dec].length === 4 && head.length <= 3 && head !== "0" && parts.slice(0, dec).every((p) => !decimalMark(p) || p[0] === parts[dec][0])) dec = -1;
+  let whole = head;
+  for (const part of parts.slice(0, dec >= 0 ? dec : parts.length)) {
+    // a mark that does not group thousands ends the number: "2 3-year plans" is 2
+    if (head.length > 3 || part.length !== 4) return Number(m[1] + whole);
+    whole += part.slice(1);
+  }
+  return Number(m[1] + whole + (dec >= 0 ? `.${parts[dec].slice(1)}` : ""));
+}
+
+/** The number a page shows for a seed fact (site.known): a value with its source, or an estimate; else null. */
+export function knownNumber(fact) {
+  if (!hasValue(fact) || !(fact.src || fact.est)) return null;
+  if (typeof fact.n === "number") return fact.n;
+  return numberIn(valueOf(fact));
+}
+
+/** Is this data.json a page of options: compare (columns of facts per item) or ranked (a price and specs per item)? */
+export function isOptionsData(data) {
+  if (!data || typeof data !== "object" || !Array.isArray(data.items)) return false;
+  return Array.isArray(data.columns) || data.items.some((i) => i && typeof i === "object" && ("price" in i || "specs" in i || "rank" in i));
+}
+
+/** Every value of a page of options: [{item, ref, label, key, fact, price}]. Compare: each column of each item;
+ *  ranked: each item's price (when it has one or a store), specs and details. */
+export function optionCells(data) {
+  const out = [];
+  if (!isOptionsData(data)) return out;
+  const columns = Array.isArray(data.columns) ? data.columns.filter((c) => c && typeof c === "object" && c.key) : null;
+  for (const item of data.items) {
+    if (!item || typeof item !== "object") continue;
+    const base = { item: String(item.name ?? item.ref ?? "an item"), ref: item.ref };
+    if (columns) {
+      for (const c of columns.slice(0, 5)) out.push({ ...base, label: String(c.label ?? c.key), key: c.key, fact: item.facts?.[c.key], price: c.type === "price" });
+      continue;
+    }
+    if ("price" in item || item.store) out.push({ ...base, label: "Price", key: "price", fact: item.price, price: true });
+    for (const fact of Array.isArray(item.specs) ? item.specs : []) out.push({ ...base, label: "spec", key: null, fact });
+    for (const d of Array.isArray(item.details) ? item.details : []) out.push({ ...base, label: String(d?.label ?? d?.key ?? "detail"), key: d?.key ?? null, fact: d?.fact });
+  }
+  return out;
+}
+
+/** The newest live record per ref and attribute in the site's record files (what a check wrote): Map ref -> record[]. */
+function liveRecords(root) {
+  const byRef = new Map();
+  const dir = path.join(root, "data", "records");
+  let files = [];
+  try {
+    files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
+  } catch {
+    return byRef;
+  }
+  for (const file of files) {
+    let value;
+    try {
+      value = JSON.parse(fs.readFileSync(path.join(dir, file), "utf8"));
+    } catch {
+      continue;
+    }
+    for (const r of Array.isArray(value?.records) ? value.records : []) {
+      if (!r || typeof r !== "object" || typeof r.ref !== "string") continue;
+      (byRef.get(r.ref) || byRef.set(r.ref, []).get(r.ref)).push(r);
+    }
+  }
+  return byRef;
+}
+
+/** Does a check record give the row a value for `key` that the page shows (a priced offer, or a claim that found it)? */
+function liveValue(records, key) {
+  const list = (records || []).filter((r) => (key === "price" && r.type === "offer" && typeof r.price?.amount === "number") || (r.type === "claim" && r.attr === key));
+  const newest = list.sort((a, b) => (Date.parse(b.prov?.observed_at) || 0) - (Date.parse(a.prov?.observed_at) || 0))[0];
+  if (!newest) return null;
+  if (newest.type === "offer") return newest.price.amount;
+  if (["uncertain", "not_found", "error"].includes(newest.status) || newest.value == null) return null;
+  return NO_VALUE.test(String(newest.value).trim()) ? null : numberIn(String(newest.value));
+}
+
+/** The values of a site's page of options: problems to fix before the card, and notes for the reply. */
+export function checkValues(dir) {
+  const root = path.resolve(dir);
+  const problems = [];
+  const notes = [];
+  let data;
+  try {
+    data = JSON.parse(fs.readFileSync(path.join(root, "data.json"), "utf8"));
+  } catch {
+    return { checked: false, problems, notes };
+  }
+  if (!isOptionsData(data)) return { checked: false, problems, notes };
+  for (const cell of optionCells(data)) {
+    const { fact } = cell;
+    const where = `${cell.item} · ${cell.label}`;
+    if (!fact || typeof fact !== "object") continue; // drawn "Unknown": nothing was found, and the page says so
+    if (fact.v != null && !hasValue(fact)) {
+      problems.push(`${where}: "${valueOf(fact).trim() || " "}" says nothing. Leave out "v" and say why in "note" ("no price on maker.com's page"), or give the page you read that does not list it ({"src", "url", "date"}); the page then says "Unknown".`);
+      continue;
+    }
+    if (!hasValue(fact) || fact.est) continue;
+    const lacks = [!fact.src && '"src"', !httpsUrl(fact.url) && '"url" (the page)', !fact.date && !fact.asof && '"date" (the day)'].filter(Boolean);
+    const list = lacks.length > 1 ? `${lacks.slice(0, -1).join(", ")} or ${lacks[lacks.length - 1]}` : lacks[0];
+    if (lacks.length) problems.push(`${where}: "${valueOf(fact)}" has no ${list}: add where you read it and when ("checked 27 Oct on maker.com"), or leave the value out.${fact.src ? "" : " Without a source the page shows it as not checked."}`);
+  }
+
+  const filter = data.filter;
+  if (filter && typeof filter === "object") {
+    const label = String(filter.label || "the filter");
+    const columns = Array.isArray(data.columns) ? data.columns : null;
+    const isNumber = (v) => v != null && v !== "" && Number.isFinite(Number(v));
+    if (!filter.key) problems.push(`the filter "${label}" has no "key".`);
+    if (!filter.label) problems.push('the filter has no "label" (what the person asked for: "€600 or less").');
+    else if (columns && !columns.some((c) => c && c.key === filter.key)) problems.push(`the filter's key "${filter.key}" is not a column, so "${label}" filters nothing.`);
+    if (!isNumber(filter.max) && !isNumber(filter.min)) problems.push(`the filter "${label}" has no number in "max" or "min".`);
+    let app = "";
+    try {
+      app = fs.readFileSync(path.join(root, "app.js"), "utf8");
+    } catch {
+      /* a page without app.js draws no filter */
+    }
+    if (app && !/\bsite\.byFilter\s*\(|\bsite\.within\s*\(/.test(app)) {
+      problems.push(`data.json has a filter, and app.js applies it without site.byFilter: a row whose value is unknown may be listed as "${label}". Use the starter's filter code (site.byFilter), which lists such rows apart.`);
+    }
+    if (filter.key) {
+      const live = liveRecords(root);
+      // per item, as the page's filter reads it: its value for the key (none counts as unknown), or a check's
+      const factOf = (item) => columns ? item.facts?.[filter.key]
+        : filter.key === "price" ? item.price : (Array.isArray(item.details) ? item.details : []).find((d) => d?.key === filter.key)?.fact;
+      const unknown = data.items
+        .filter((item) => item && typeof item === "object")
+        .filter((item) => knownNumber(factOf(item)) == null && liveValue(live.get(item.ref), filter.key) == null)
+        .map((item) => String(item.name ?? item.ref ?? "an item"));
+      if (unknown.length) {
+        const col = columns?.find((c) => c && c.key === filter.key);
+        const title = filter.unknown || `${col?.label ?? (filter.key === "price" ? "Price" : filter.key)} unknown`;
+        notes.push(`${unknown.length} item(s) have no ${String(col?.label ?? filter.key).toLowerCase()} the page can show: ${unknown.join(", ")}. The page lists them apart ("${title}"), never as "${label}"; say so in the lede and the reply, with why for each.`);
+      }
+    }
+  }
+  return { checked: true, problems, notes };
+}
+
+/** The CLI's lines and exit code: 0 every item shown and every value fine, 1 an item missing or a value to fix, 2
+ *  nothing to check. */
 export function checkReport(dir, expect, { json = false } = {}) {
   const result = checkSite(dir, expect);
-  if (!result.items.length) {
+  const values = checkValues(dir);
+  const bad = result.missing.length > 0 || values.problems.length > 0;
+  if (!result.items.length && !values.problems.length) {
     const message = 'nothing to check: pass --expect "<item>,<item>" (each item the request named) or put "expect": [...] in data.json';
-    return { exit: 2, lines: [json ? JSON.stringify({ ok: false, error: message }) : message] };
+    return { exit: 2, lines: [json ? JSON.stringify({ ok: false, error: message, values }) : message, ...(json ? [] : values.notes.map((n) => `NOTE: ${n}`))] };
   }
-  if (json) return { exit: result.missing.length ? 1 : 0, lines: [JSON.stringify({ ok: !result.missing.length, ...result })] };
+  if (json) return { exit: bad ? 1 : 0, lines: [JSON.stringify({ ok: !bad, ...result, values })] };
   const lines = [];
   if (result.missing.length) {
     lines.push(`MISSING: the request named ${result.missing.length} item(s) the site does not show: ${result.missing.join(", ")}.`);
     lines.push("Add each one to the page (its data file), or say plainly in the reply which are missing and why.");
   }
-  lines.push(`${result.shown.length} of ${result.items.length} expected item(s) shown${result.shown.length ? `: ${result.shown.map((s) => s.item).join(", ")}` : ""}.`);
-  lines.push(`Read ${result.files.length} file(s): the HTML text and the data files (what a script renders from elsewhere is not seen).`);
-  return { exit: result.missing.length ? 1 : 0, lines };
+  if (values.problems.length) {
+    lines.push(`VALUES: ${values.problems.length} value(s) to fix in data.json:`);
+    for (const problem of values.problems) lines.push(`- ${problem}`);
+  }
+  for (const note of values.notes) lines.push(`NOTE: ${note}`);
+  if (result.items.length) {
+    lines.push(`${result.shown.length} of ${result.items.length} expected item(s) shown${result.shown.length ? `: ${result.shown.map((s) => s.item).join(", ")}` : ""}.`);
+    lines.push(`Read ${result.files.length} file(s): the HTML text and the data files (what a script renders from elsewhere is not seen).`);
+  } else {
+    lines.push('No items to check: pass --expect "<item>,<item>" (each item the request named) or put "expect": [...] in data.json.');
+  }
+  return { exit: bad ? 1 : 0, lines };
 }

package/dist/bind/src/starters/compare/app.js

@@ -10,16 +10,20 @@
  *                          changed, then missing ones). Otherwise rows keep the order of "items", before and after a
  *                          price check: put them in the order the lede talks about them.
  *   columns: [{key, label, type: "price"|"number"|"text"}]   at most 5; a "price" column can be checked live
- *   filter (only for a constraint the person stated): {key, max, label: "Under $160", rest: "over $160"}
+ *   filter (only for a constraint the person stated): {key, max, label: "Under $160", rest: "over $160",
+ *                          unknown?: "Price unknown"}. Only a value the page shows counts: a row whose value is
+ *                          unknown is never listed as under $160; it is listed apart, under "Price unknown".
  *   items: [{ref: "option:a", name, why (one short line), badge?: "Previous model", note?, facts: {key: fact},
  *            store: {name, url, readable}, more?: [{label, fact}], sources?: [{name, url}]}]
  *   unchecked: ["what was not checked", …]     listed once in the footer
  *   fact: {"v": "$145", "src": "Example Store", "url": "https://…", "date": "2026-10-17", "asof"?: "2026-08-05", "est": false}
- *   A source you read that does not give the value: the fact without "v" ({"src", "url", "date"}) reads "Not listed ·
- *   Maker ↗". "Not checked" means nobody checked it ({"note": "what to check"}).
- * When most of a column comes from one source on one date, the cells show just the value and one line under the list
- * names the source; so does a row whose own values come from one other source ("Option C (Support and Ride): Fleet
- * Feet product page ↗"). Any other cell keeps its own caption.
+ *   Each value cites its page and day ("checked 17 Oct on maker.com ↗"), and no cell is blank: a source you read that
+ *   does not give the value is the fact without "v" ({"src", "url", "date"}): "Not listed · checked 17 Oct on
+ *   maker.com ↗"; any other missing value reads "Unknown", with {"note": "the store blocks price checks"} saying why.
+ *   Never a dash.
+ * When one page gives most of a column on one date, the cells show just the value and one line under the list cites
+ * that page; so does a row whose own values come from one other page ("Option C (Support and Ride): checked 16 Oct on
+ * fleetfeet.com ↗"). Any other cell keeps its own caption.
  * Query: ?sort=<key>&show=all&open=<slug>. Rows: id="row-<slug>", data-ref="<ref>".
  * SPDX-License-Identifier: AGPL-3.0-only */
 (function () {
@@ -60,7 +64,12 @@
     if (live && site.blocked(item.ref)) return seed; // a blocked check keeps the seed value
     return live || seed;
   }
-  /** Per column: the source most of its cells share ({src, date, asof, url}), when two or more cells and over half do. */
+  /** A fact's page and day: two values share a citation only when one page on one day gives both. */
+  function citeKey(f) {
+    var page = site.safeUrl(f.url);
+    return [page ? page.split("#")[0] : "src:" + f.src, f.date || "", f.asof || ""].join("|");
+  }
+  /** Per column: the page most of its cells share ({src, date, asof, url}), when two or more cells and over half do. */
   function sharedSources(data, items) {
     var out = {};
     columns(data).forEach(function (c) {
@@ -68,8 +77,8 @@
       var count = {};
       items.forEach(function (i) {
         var f = seedOf(i, c);
-        if (!f || !f.src || f.est || f.v == null) return;
-        var k = [f.src, f.date || "", f.asof || ""].join("|");
+        if (!f || !f.src || f.est || !site.valueText(f)) return;
+        var k = citeKey(f);
         count[k] = count[k] || { n: 0, fact: f };
         count[k].n++;
       });
@@ -81,11 +90,11 @@
   function isShared(shared, item, col) {
     var s = shared[col.key];
     var f = seedOf(item, col);
-    return !!(s && f && f.src && !f.est && [f.src, f.date || "", f.asof || ""].join("|") === s.key);
+    return !!(s && f && f.src && !f.est && citeKey(f) === s.key);
   }
-  /** Per row: the one source its own cells share ({key, fact, labels}), when two or more of its cells outside the
-   * price column come from one source on one date that is not their column's. The line under the list names it once
-   * ("Option C (Support and Ride): Fleet Feet product page ↗ · seen 16 Oct"), so the row is not a stack of links. */
+  /** Per row: the one page its own cells share ({key, fact, labels}), when two or more of its cells outside the price
+   * column come from one page on one date that is not their column's. The line under the list cites it once
+   * ("Option C (Support and Ride): checked 16 Oct on fleetfeet.com ↗"), so the row is not a stack of links. */
   function rowSources(data, items, shared) {
     var out = {};
     items.forEach(function (i) {
@@ -94,9 +103,9 @@
         if (isPrice(c) || isShared(shared, i, c)) return;
         var f = seedOf(i, c);
         if (!f || !f.src || f.est) return;
-        var k = [f.src, f.date || "", f.asof || ""].join("|");
+        var k = citeKey(f);
         (by[k] = by[k] || { key: k, fact: f, labels: [], values: 0 }).labels.push(c.label);
-        if (f.v != null) by[k].values++;
+        if (site.valueText(f)) by[k].values++;
       });
       var keys = Object.keys(by);
       if (keys.length === 1 && by[keys[0]].labels.length >= 2 && by[keys[0]].values >= 1) out[i.ref] = by[keys[0]];
@@ -106,14 +115,14 @@
   function ownRow(rows, item, col) {
     var r = rows[item.ref];
     var f = seedOf(item, col);
-    return !!(r && f && f.src && !f.est && !isPrice(col) && [f.src, f.date || "", f.asof || ""].join("|") === r.key);
+    return !!(r && f && f.src && !f.est && !isPrice(col) && citeKey(f) === r.key);
   }
-  /** label: say what was not checked ("Price not checked") where no column header or fact label says it. */
+  /** A missing value reads "Unknown" (with label: "Price unknown", where no column header or fact label says what). */
   function cell(item, col, src, label) {
     if (isPrice(col)) {
-      return site.trust(valueOf(item, col), { price: true, ref: item.ref, intent: "read_offer", store: item.store, seed: seedOf(item, col), label: label });
+      return site.trust(valueOf(item, col), { price: true, ref: item.ref, intent: "read_offer", store: item.store, seed: seedOf(item, col), label: label, unknown: "Unknown" });
     }
-    return site.trust(valueOf(item, col), { shared: isShared(src.cols, item, col) || ownRow(src.rows, item, col), label: label });
+    return site.trust(valueOf(item, col), { shared: isShared(src.cols, item, col) || ownRow(src.rows, item, col), label: label, unknown: "Unknown" });
   }
   function hasMore(item) { return !!(item.note || (item.more && item.more.length) || (item.sources && item.sources.length)); }
 
@@ -125,22 +134,28 @@
     var def = (data.sort || []).filter(function (s) { return s.key === st.sort; })[0] || (data.sort || [])[0];
     if (!def) return items;
     var col = colOf(data, def.key) || { key: def.key };
-    var tier = function (i) { var v = valueOf(i, col); return site.num(v) == null ? 2 : site.old(v, isPrice(col)) ? 1 : 0; };
+    var tier = function (i) { var v = valueOf(i, col); return site.known(v) == null ? 2 : site.old(v, isPrice(col)) ? 1 : 0; };
     return items.slice().sort(function (a, b) {
       var ta = tier(a), tb = tier(b);
       if (ta !== tb) return ta - tb;
       if (ta === 2) return 0;
-      var x = site.num(valueOf(a, col)), y = site.num(valueOf(b, col));
+      var x = site.known(valueOf(a, col)), y = site.known(valueOf(b, col));
       return def.dir === "desc" ? y - x : x - y;
     });
   }
-  function fits(data, item) {
+  /** The rows by the page's one filter: {in, unknown, out}. A row whose value is unknown is never "in". */
+  function byFilter(data, items) {
+    var f = data.filter;
+    var col = f ? colOf(data, f.key) || { key: f.key } : null;
+    return site.byFilter(items, f, function (i) { return valueOf(i, col); });
+  }
+  /** "Price unknown": the heading of the rows the filter cannot place. */
+  function unknownTitle(data) {
     var f = data.filter;
-    if (!f) return true;
-    var n = site.num(valueOf(item, colOf(data, f.key) || { key: f.key }));
-    if (n == null) return true;
-    return (f.max == null || n <= f.max) && (f.min == null || n >= f.min);
+    var col = colOf(data, f.key);
+    return f.unknown || ((col ? col.label : f.key) + " unknown");
   }
+  function lowerFirst(text) { text = String(text || ""); return text.charAt(0).toLowerCase() + text.slice(1); }
 
   function render(data, st) {
     site.head(data);
@@ -152,8 +167,12 @@
       items = lastOrder.map(function (ref) { return all.filter(function (i) { return i.ref === ref; })[0]; }).filter(Boolean);
     }
     lastOrder = items.map(function (i) { return i.ref; });
-    var shown = st.show === "all" ? items : items.filter(function (i) { return fits(data, i); });
-    var hidden = items.length - shown.length;
+    // "All" is one list; the stated limit shows the rows within it, then the rows nobody could place ("Price unknown",
+    // never counted as within it), and one line for the rest
+    var parts = st.show === "all" || !data.filter ? { "in": items, unknown: [], out: [] } : byFilter(data, items);
+    var shown = parts["in"];
+    var apart = parts.unknown;
+    var hidden = parts.out.length;
     var hasPrice = columns(data).some(isPrice);
     var cols = sharedSources(data, all);
     var shared = { cols: cols, rows: rowSources(data, all, cols) };
@@ -179,7 +198,15 @@
     } else {
       var stores = hasPrice ? site.priceNotice(all) : null;
       wideNow = isWide();
-      var wrap = h("div", { "class": "stack" }, wideNow ? table(data, shown, st, shared) : cards(data, shown, st, shared));
+      var wrap = h("div", { "class": "stack" });
+      if (shown.length) wrap.appendChild(wideNow ? table(data, shown, st, shared) : cards(data, shown, st, shared));
+      else wrap.appendChild(h("p", { "class": "cap", text: "None is known to be " + lowerFirst(data.filter.label || "within the limit") + "." }));
+      if (apart.length) {
+        wrap.appendChild(h("section", { "class": "group", attrs: { id: "group-unknown", "aria-label": unknownTitle(data) } },
+          h("div", { "class": "group-head" }, h("h2", { text: unknownTitle(data) }),
+            h("span", { "class": "cap", text: "Not counted as " + lowerFirst(data.filter.label || "within the limit") })),
+          wideNow ? table(data, apart, st, shared) : cards(data, apart, st, shared)));
+      }
       var lines = [];
       if (hidden > 0) {
         lines.push(h("p", { "class": "cap hidden-line" }, hidden + " more " + (data.filter.rest || "hidden") + " · ",
@@ -215,12 +242,12 @@
     var def = (data.sort || []).filter(function (s) { return s.key === st.sort; })[0] || (data.sort || [])[0];
     if (!def) return null;
     var col = colOf(data, def.key) || { key: def.key, label: def.key };
-    var n = items.filter(function (i) { return site.num(valueOf(i, col)) == null; }).length;
+    var n = items.filter(function (i) { return site.known(valueOf(i, col)) == null; }).length;
     if (!n || n === items.length) return null;
     return h("p", { "class": "cap", text: n + " without " + (/^[aeiou]/i.test(col.label) ? "an " : "a ") + String(col.label).toLowerCase() + (n === 1 ? " is" : " are") + " listed last." });
   }
-  /** "Support and Heel drop: Running Shoes Guru ↗ · seen 16 Oct", plus ", unless a value says otherwise" when a cell
-   * of those columns has its own source. */
+  /** "Support and Heel drop: checked 16 Oct on runningshoesguru.com ↗", plus ", unless a value says otherwise" when a
+   * cell of those columns has its own source. */
   function sharedLine(data, src, items) {
     var groups = {};
     var and = function (list) { return list.length > 1 ? list.slice(0, -1).join(", ") + " and " + list[list.length - 1] : list[0]; };
@@ -230,18 +257,16 @@
       var g = groups[s.key] = groups[s.key] || { fact: s.fact, labels: [], others: false };
       g.labels.push(c.label);
       // a value with its own source that no row line names keeps its own caption: "unless a value says otherwise"
-      if (items.some(function (i) { var f = seedOf(i, c); return f && f.src && f.v != null && !isShared(src.cols, i, c) && !ownRow(src.rows, i, c); })) g.others = true;
+      if (items.some(function (i) { var f = seedOf(i, c); return f && f.src && site.valueText(f) && !isShared(src.cols, i, c) && !ownRow(src.rows, i, c); })) g.others = true;
     });
     var out = Object.keys(groups).map(function (k) {
       var g = groups[k];
-      var when = site.seen(g.fact);
-      return h("p", { "class": "cap" }, and(g.labels) + ": ", site.link(g.fact.url, g.fact.src), when ? [" · ", h("span", { "class": "nowrap", text: when })] : "", g.others ? ", unless a value says otherwise" : "");
+      return h("p", { "class": "cap" }, and(g.labels) + ": ", site.cite(g.fact), g.others ? ", unless a value says otherwise" : "");
     });
     items.forEach(function (i) {
       var r = src.rows[i.ref];
       if (!r) return;
-      var when = site.seen(r.fact);
-      out.push(h("p", { "class": "cap" }, i.name + " (" + and(r.labels) + "): ", site.link(r.fact.url, r.fact.src), when ? [" · ", h("span", { "class": "nowrap", text: when })] : ""));
+      out.push(h("p", { "class": "cap" }, i.name + " (" + and(r.labels) + "): ", site.cite(r.fact)));
     });
     return out.length ? h("div", null, out) : null;
   }

package/dist/bind/src/starters/compare/data.json

@@ -1,6 +1,6 @@
 {
   "title": "Compare three options",
-  "lede": "Option B costs least and Option A is the lightest. Option C's price was not checked.",
+  "lede": "Option B costs least and Option A is the lightest. Option C's price is unknown.",
   "sort": [
     {
       "key": "price",

package/dist/bind/src/starters/ranked/app.js

@@ -4,7 +4,9 @@
  * data.json:
  *   title, lede     the page title and its one-line answer (the verdict, and the biggest unknown if there is one)
  *   basis           how it is ranked, one line: "Ranked by safety reviews, then price."
- *   filter (only for a constraint the person stated): {key: "price", max: 300, label: "Under $300"}
+ *   filter (only for a constraint the person stated): {key: "price", max: 300, label: "Under $300", unknown?:
+ *            "Price unknown"}. Only a price the page shows counts: a row without one is never listed as under $300;
+ *            it is listed apart, under "Price unknown".
  *   items: [{ref: "option:a", rank, name, why (one short line), badge?, specs: [fact] (at most 3), price?: fact,
  *            store?: {name, url, readable}, details?: [{label, fact}], sources?: [{name, url}]}]
  *   badge: only for a label the person must notice. "Our pick" only when it is your own pick and "why" says why;
@@ -12,8 +14,9 @@
  *          "BabyGearLab: best budget"), never a "Details" toggle. Nothing is added by itself.
  *   price: the price as a fact (not in specs), with "asof" when the source dates it; a live check replaces it. A
  *          review site's price is its list price: "list": true, so the row says "list price" and never reads as the
- *          store's price now. When every price comes from one source on one date, one line under the list names the
- *          source once ("List prices on BabyGearLab ↗ · seen 5 Aug"), and "Sources" does not name it again.
+ *          store's price now. When one page on one date gives every price, one line under the list names it once
+ *          ("List prices on BabyGearLab ↗ · seen 5 Aug"), and "Sources" does not name it again. A missing price reads
+ *          "Price unknown", then why ({"note": "the store blocks price checks"}).
  *   details: only facts the row does not already show.
  *   unchecked: ["what was not checked", …]
  *   fact: {"v": "$145", "src": "Example Store", "url": "https://…", "date": "2026-10-17", "est": false}
@@ -31,24 +34,36 @@
     render: render
   });
 
-  function priceOf(item) { return site.live(item.ref, "price") || item.price || null; }
+  /** The price a row shows: a live check, else the seed price (also when the check found the store blocked). */
+  function priceOf(item) {
+    var live = site.live(item.ref, "price");
+    if (live && site.blocked(item.ref)) return item.price || live;
+    return live || item.price || null;
+  }
   function valueFor(item, key) {
     if (key === "price") return priceOf(item);
     var d = (item.details || []).filter(function (x) { return x.key === key; })[0];
     return d ? d.fact : null;
   }
-  function fits(data, item) {
+  /** "Price unknown": the heading of the rows the filter cannot place. */
+  function unknownTitle(data) {
     var f = data.filter;
-    if (!f) return true;
-    var n = site.num(valueFor(item, f.key));
-    if (n == null) return true;
-    return (f.max == null || n <= f.max) && (f.min == null || n >= f.min);
+    if (f.unknown) return f.unknown;
+    if (f.key === "price") return "Price unknown";
+    var d = (data.items || []).map(function (i) { return (i.details || []).filter(function (x) { return x.key === f.key; })[0]; }).filter(Boolean)[0];
+    return ((d && d.label) || f.key) + " unknown";
   }
+  function lowerFirst(text) { text = String(text || ""); return text.charAt(0).toLowerCase() + text.slice(1); }
   function render(data, st) {
     site.head(data); // title, lede and the basis line ("Ranked by …") come first, before any button
     var items = (data.items || []).slice().sort(function (a, b) { return (a.rank || 0) - (b.rank || 0); });
-    var shown = st.show === "all" ? items : items.filter(function (i) { return fits(data, i); });
-    var hidden = items.length - shown.length;
+    // the stated limit shows the rows within it, then the rows nobody could place ("Price unknown", never counted as
+    // within it); "All" is the whole ranking
+    var parts = st.show === "all" || !data.filter ? { "in": items, unknown: [], out: [] }
+      : site.byFilter(items, data.filter, function (i) { return valueFor(i, data.filter.key); });
+    var shown = parts["in"];
+    var apart = parts.unknown;
+    var hidden = parts.out.length;
     var priced = items.some(function (i) { return i.price || i.store; });
     var shared = sharedPrice(items);
 
@@ -72,7 +87,14 @@
       // today's price is ("Open a store for today's price."), instead of a box about checks nobody was offered
       var inline = !!(shared && stores && site.storesBlocked(items));
       if (inline) stores = null;
-      wrap.appendChild(h("ol", { "class": "list ranked" }, shown.map(function (item) { return row(item, st, priced, shared); })));
+      if (shown.length) wrap.appendChild(h("ol", { "class": "list ranked" }, shown.map(function (item) { return row(item, st, priced, shared); })));
+      else wrap.appendChild(h("p", { "class": "cap", text: "None is known to be " + lowerFirst(data.filter.label || "within the limit") + "." }));
+      if (apart.length) {
+        wrap.appendChild(h("section", { "class": "group", attrs: { id: "group-unknown", "aria-label": unknownTitle(data) } },
+          h("div", { "class": "group-head" }, h("h2", { text: unknownTitle(data) }),
+            h("span", { "class": "cap", text: "Not counted as " + lowerFirst(data.filter.label || "within the limit") })),
+          h("ol", { "class": "list ranked" }, apart.map(function (item) { return row(item, st, priced, shared); }))));
+      }
       if (hidden > 0) {
         wrap.appendChild(h("p", { "class": "cap" }, hidden + " hidden · ",
           h("button", { "class": "link-btn", text: "Show all", attrs: { type: "button", "data-key": "show-all" }, on: { click: function () { site.setState({ show: "all" }); } } })));
@@ -93,11 +115,12 @@
     site.notes(items.length ? data.unchecked : [], items.length ? sources : []);
   }
 
-  /** The price fact every priced row shares (same source and date), else null. */
+  /** The price fact every priced row shares (one page on one date), else null. */
   function sharedPrice(items) {
     var facts = items.map(function (i) { return i.price; }).filter(Boolean);
     if (facts.length < 2) return null;
-    var key = function (f) { return f && f.src && !f.est && f.v != null ? [f.src, f.asof || f.date || "", f.list ? "list" : ""].join("|") : null; };
+    var page = function (f) { var u = site.safeUrl(f.url); return u ? u.split("#")[0] : "src:" + f.src; };
+    var key = function (f) { return f && f.src && !f.est && site.valueText(f) ? [page(f), f.asof || f.date || "", f.list ? "list" : ""].join("|") : null; };
     var k = key(facts[0]);
     return k && facts.every(function (f) { return key(f) === k; }) ? facts[0] : null;
   }
@@ -149,7 +172,7 @@
         item.why ? h("p", { "class": "why", text: item.why }) : null,
         specs.length ? h("p", { "class": "cap", text: specs.join(" · ") }) : null,
         // every priced row has the same price line, with or without a store
-        priced ? site.trust(live || item.price || null, { label: "Price", price: true, ref: item.ref, intent: "read_offer", store: item.store, seed: item.price || null, shared: !live && !!shared && !!item.price }) : null,
+        priced ? site.trust(live || item.price || null, { label: "Price", unknown: "Unknown", price: true, ref: item.ref, intent: "read_offer", store: item.store, seed: item.price || null, shared: !live && !!shared && !!item.price }) : null,
         open && hasMore(item) ? more(item) : null));
   }
 

package/dist/bind/src/starters/ranked/data.json

@@ -1,6 +1,6 @@
 {
   "title": "Top three options",
-  "lede": "Option A is the best all-round pick. Option C costs least, but its price was not checked.",
+  "lede": "Option A is the best all-round pick. Option C's price is unknown: its store blocks price checks.",
   "basis": "Ranked by review scores, then price.",
   "items": [
     {
@@ -106,7 +106,7 @@
       "ref": "option:option-c",
       "rank": 3,
       "name": "Option C",
-      "why": "The lowest price, fewer reviews",
+      "why": "Well reviewed, by fewer people",
       "specs": [
         {
           "v": "9.8 oz",