superbee 0.4.0-pre.1 → 0.4.0-pre.3

package/SKILL.md

@@ -59,7 +59,7 @@ becoming a second source of truth. Add only the layer justified by current evide
   explicit publication decision.
 - Never silently rewrite an established Kind, recipe, or its instances. Inspect dependencies and
   explain migration consequences first.
-- Writes carry an actor (`--actor`/`SUPERBEE_ACTOR`); OKF v0.2 bundles accept only `human:<id>`, `process:<id>`, or `<producer>/<version>` (e.g. `openai/codex`); a bare name is refused with the fix.
+- Writes carry an actor (`--actor`/`SUPERBEE_ACTOR`); OKF v0.2 bundles accept only `human:<id>`, `process:<id>`, or `<producer>/<version>` (e.g. `openai/codex`); a bare name is refused with the fix. After a raw file edit, run `superbee status`: it names a document whose frontmatter no longer parses (quote values containing `: `); sync publishes nothing until it parses.
 
 ## Deliver after acceptance
 

package/dist/publication-bridge.mjs

@@ -2997,6 +2997,16 @@ function stringifyDoc(frontmatter2, body) {
   return stringifyWithData(frontmatter2, body);
 }
 
+// ../core/src/meaningful-change-time.ts
+function meaningfulChangeTimeField(frontmatter2) {
+  const generated = frontmatter2.generated;
+  if (generated !== null && typeof generated === "object" && !Array.isArray(generated) && generated.at !== void 0) return "generated.at";
+  return "timestamp";
+}
+function meaningfulChangeTimeValue(frontmatter2) {
+  return meaningfulChangeTimeField(frontmatter2) === "generated.at" ? frontmatter2.generated.at : frontmatter2.timestamp;
+}
+
 // ../core/src/errors.ts
 var InvalidInputError = class extends Error {
   constructor(message) {
@@ -3028,6 +3038,58 @@ var ConcurrentReplacementError = class extends Error {
   }
 };
 
+// ../core/src/verification.ts
+var TRUST_TIERS = Object.freeze([
+  "unverified",
+  "machine-confirmed",
+  "human-reviewed"
+]);
+var ISO_INSTANT = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?(?:([Zz])|([+-])(\d{2})(?::?(\d{2}))?)$/;
+function parseIsoInstant(raw, rounding = "truncate") {
+  const match = ISO_INSTANT.exec(raw);
+  if (!match) return null;
+  const [, y, mo, d, h, mi, sec = "0", frac = "0", zulu, sign, oh, om = "0"] = match;
+  const year = Number(y);
+  const month = Number(mo);
+  const day = Number(d);
+  const hour = Number(h);
+  const minute = Number(mi);
+  const second = Number(sec);
+  if (month < 1 || month > 12) return null;
+  const probe = /* @__PURE__ */ new Date(0);
+  probe.setUTCFullYear(year, month, 0);
+  if (day < 1 || day > probe.getUTCDate()) return null;
+  if (hour > 23 || minute > 59 || second > 59) return null;
+  let offsetMinutes = 0;
+  if (!zulu) {
+    const offsetHours = Number(oh);
+    const offsetMins = Number(om);
+    if (offsetHours > 23 || offsetMins > 59) return null;
+    offsetMinutes = (sign === "-" ? -1 : 1) * (offsetHours * 60 + offsetMins);
+  }
+  const millis = Number(frac.padEnd(3, "0").slice(0, 3));
+  const instant = /* @__PURE__ */ new Date(0);
+  instant.setUTCFullYear(year, month - 1, day);
+  instant.setUTCHours(hour, minute, second, millis);
+  const remainder = rounding === "ceil" && /[1-9]/.test(frac.slice(3)) ? 1 : 0;
+  return instant.getTime() - offsetMinutes * 6e4 + remainder;
+}
+
+// ../core/src/freshness.ts
+function parseTimestamp(ts, okfVersion) {
+  if (okfVersion === "0.2") return typeof ts === "string" ? parseIsoInstant(ts) : null;
+  if (ts instanceof Date) {
+    const ms2 = ts.getTime();
+    return Number.isNaN(ms2) ? null : ms2;
+  }
+  if (typeof ts === "number") {
+    return Number.isFinite(ts) ? ts : null;
+  }
+  if (typeof ts !== "string" || ts.trim() === "") return null;
+  const ms = Date.parse(ts);
+  return Number.isNaN(ms) ? null : ms;
+}
+
 // ../core/src/okf-lifecycle.ts
 var OKF_LIFECYCLE_STATUSES = Object.freeze(["draft", "stable", "deprecated"]);
 function isOkfLifecycleStatus(value) {
@@ -3308,7 +3370,7 @@ async function query(backend, filter = {}, options = {}) {
 }
 async function queryHeads(backend, filter = {}, options = {}) {
   if (backend.queryHeads) {
-    const rows = (await backend.queryHeads(filter)).filter((row) => matchesFilter(row, filter));
+    const rows = (await backend.queryHeads(filter, options.onSkip ? { onSkip: options.onSkip } : void 0)).filter((row) => matchesFilter(row, filter));
     rows.sort((a, b) => a.id.localeCompare(b.id));
     return rows;
   }
@@ -3337,11 +3399,11 @@ function toSelectorList(value) {
   if (value === void 0) return void 0;
   return Array.isArray(value) ? value : [value];
 }
-async function queryEdges(backend, filter = {}) {
+async function queryEdges(backend, filter = {}, options = {}) {
   const fromSelectors = toSelectorList(filter.from)?.map(normalizeEdgeSelector);
   const toSelectors = toSelectorList(filter.to)?.map(normalizeEdgeSelector);
   const edges = [];
-  for (const doc of await query(backend)) {
+  for (const doc of await query(backend, {}, options)) {
     for (const link of parseLinksFromDoc(doc)) {
       if (!matchesEdgeSelector(link.from, fromSelectors)) continue;
       if (!matchesEdgeSelector(link.to, toSelectors)) continue;
@@ -4761,8 +4823,8 @@ async function query2(bundle, filter = {}, options = {}) {
 async function queryHeads2(bundle, filter = {}, options = {}) {
   return queryHeads(backendFor(bundle), filter, options);
 }
-async function queryEdges2(bundle, filter = {}) {
-  return queryEdges(backendFor(bundle), filter);
+async function queryEdges2(bundle, filter = {}, options = {}) {
+  return queryEdges(backendFor(bundle), filter, options);
 }
 
 // ../core/src/bundle.ts
@@ -5477,6 +5539,29 @@ function parseRegistration(id, frontmatter2) {
   };
 }
 
+// ../core/src/query-order.ts
+function meaningfulChangeOrderKey(id, frontmatter2, okfVersion) {
+  const value = meaningfulChangeTimeValue(frontmatter2);
+  return {
+    id,
+    timestamp: typeof value === "string" ? value : "",
+    timestampMs: parseTimestamp(value, okfVersion ?? void 0)
+  };
+}
+function compareByMeaningfulChange(a, b) {
+  if (a.timestampMs !== null && b.timestampMs !== null) {
+    if (a.timestampMs !== b.timestampMs) return b.timestampMs - a.timestampMs;
+  } else if (a.timestampMs !== null) {
+    return -1;
+  } else if (b.timestampMs !== null) {
+    return 1;
+  }
+  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+}
+function sortByMeaningfulChange(rows, okfVersion) {
+  return rows.map((row) => ({ row, key: meaningfulChangeOrderKey(row.id, row.frontmatter, okfVersion) })).sort((a, b) => compareByMeaningfulChange(a.key, b.key)).map(({ row }) => row);
+}
+
 // ../view-runtime/src/bridge.ts
 var BRIDGE_PROTOCOL = "v0";
 var ACTION_BRIDGE_PROTOCOL = "v1";
@@ -5508,6 +5593,7 @@ var BRIDGE_HOST_CAPABILITIES = Object.freeze({
   queryFieldOr: "query.field-or",
   queryOpen: "query.open",
   queryCount: "query.count",
+  queryNewest: "query.newest",
   edges: "edges",
   renderDocument: "render-document",
   openPage: "open-page",
@@ -5522,10 +5608,12 @@ var BRIDGE_SERVICE_CAPABILITIES = Object.freeze([
   BRIDGE_HOST_CAPABILITIES.queryFieldOr,
   BRIDGE_HOST_CAPABILITIES.queryOpen,
   BRIDGE_HOST_CAPABILITIES.queryCount,
+  BRIDGE_HOST_CAPABILITIES.queryNewest,
   BRIDGE_HOST_CAPABILITIES.edges,
   BRIDGE_HOST_CAPABILITIES.graph,
   BRIDGE_HOST_CAPABILITIES.renderDocument
 ]);
+var BRIDGE_QUERY_ORDERS = Object.freeze(["id", "newest"]);
 var V0_REQUEST_TYPES = /* @__PURE__ */ new Set(["hello", "query", "read", "render-document", "edges", "graph", "subscribe", "host", "open-page"]);
 function isPlainRecord(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
@@ -5554,7 +5642,7 @@ function invalidV0RequestId(value) {
 }
 function normalizeQueryParams(raw) {
   if (!isPlainRecord(raw)) return null;
-  const allowed = /* @__PURE__ */ new Set(["type", "prefix", "field", "open", "limit"]);
+  const allowed = /* @__PURE__ */ new Set(["type", "prefix", "field", "open", "limit", "order"]);
   if (Object.keys(raw).some((key) => !allowed.has(key))) return null;
   const out = {};
   if (raw.type !== void 0) {
@@ -5582,6 +5670,10 @@ function normalizeQueryParams(raw) {
     }
     out.limit = raw.limit;
   }
+  if (raw.order !== void 0) {
+    if (!BRIDGE_QUERY_ORDERS.includes(raw.order)) return null;
+    out.order = raw.order;
+  }
   return out;
 }
 function selector(value) {
@@ -5709,9 +5801,19 @@ function fail(id, bridge, code, message) {
 function replyWithinLimit(reply) {
   return Buffer.byteLength(JSON.stringify(reply), "utf8") <= MAX_REPLY_BYTES;
 }
+function skippedReply(skipped) {
+  if (skipped.length === 0) return {};
+  return { skipped: [...skipped].sort((a, b) => a.id.localeCompare(b.id)).slice(0, MAX_QUERY_ROWS) };
+}
 function boundedRows(rows, params, kinds) {
   const requested = params.limit === 0 || params.limit === void 0 ? MAX_QUERY_ROWS : Math.min(params.limit, MAX_QUERY_ROWS);
-  return applyQuerySelectionFilters(rows, { ...params, limit: requested }, kinds);
+  const { order, ...selection } = params;
+  if (order !== "newest") return applyQuerySelectionFilters(rows, { ...selection, limit: requested }, kinds);
+  const matched = applyQuerySelectionFilters(rows, { ...selection, limit: void 0 }, kinds);
+  return {
+    rows: sortByMeaningfulChange(matched.rows, selection.okfVersion).slice(0, requested),
+    count: matched.count
+  };
 }
 var BridgeService = class {
   constructor(options) {
@@ -5839,7 +5941,8 @@ var BridgeService = class {
     return { status: "reload-required", message };
   }
   async subscriptionSnapshot() {
-    const rows = await queryHeads2(this.options.bundle, {});
+    const rows = await queryHeads2(this.options.bundle, {}, { onSkip: () => {
+    } });
     if (rows.length > MAX_SUBSCRIPTION_HEADS) {
       throw new Error("the bundle is too large for the experimental View polling snapshot");
     }
@@ -5856,7 +5959,11 @@ var BridgeService = class {
    * capability before adding them.
    */
   async graph(launch, request) {
-    const heads = await queryHeads2(this.options.bundle, {});
+    const skipped = [];
+    const onSkip = (skip) => {
+      if (!skipped.some((row) => row.id === skip.id)) skipped.push({ id: skip.id, reason: skip.reason });
+    };
+    const heads = await queryHeads2(this.options.bundle, {}, { onSkip });
     if (heads.length > GRAPH_MAX_DOCUMENTS) {
       return {
         reply: fail(request.id, request.bridge, "TOO_LARGE", `the graph exceeded ${GRAPH_MAX_DOCUMENTS} documents`)
@@ -5865,7 +5972,7 @@ var BridgeService = class {
     const [registry, declaredOkfVersion, edges] = await Promise.all([
       loadKinds(this.options.bundle),
       readBundleOkfVersion2(this.options.bundle),
-      queryEdges2(this.options.bundle, {})
+      queryEdges2(this.options.bundle, {}, { onSkip })
     ]);
     if (edges.length > GRAPH_MAX_RELATIONSHIPS) {
       return {
@@ -5899,7 +6006,8 @@ var BridgeService = class {
         okfVersion,
         documents,
         relationships,
-        counts: { documents: documents.length, relationships: relationships.length }
+        counts: { documents: documents.length, relationships: relationships.length },
+        ...skippedReply(skipped)
       })
     };
   }
@@ -5957,10 +6065,14 @@ var BridgeService = class {
       return { reply: ok(request.id, request.bridge, request.type, { capability: request.capability, output: outcome.output }) };
     }
     if (request.type === "query") {
+      if (request.params.order !== void 0 && !this.options.host.capabilities.includes(BRIDGE_HOST_CAPABILITIES.queryNewest)) {
+        return { reply: fail(request.id, request.bridge, "USAGE", "invalid or unsupported bridge request") };
+      }
+      const skipped = [];
       const rows = await queryHeads2(this.options.bundle, {
         ...request.params.type ? { type: request.params.type } : {},
         ...request.params.prefix ? { prefix: request.params.prefix } : {}
-      });
+      }, { onSkip: (skip) => skipped.push({ id: skip.id, reason: skip.reason }) });
       const [registry, okfVersion] = await Promise.all([
         loadKinds(this.options.bundle),
         readBundleOkfVersion2(this.options.bundle)
@@ -5974,7 +6086,7 @@ var BridgeService = class {
         const kind = registry.kinds.get(String(row.frontmatter.type ?? ""));
         return kind ? { ...row, frontmatter: projectLogicalKindFields(okfVersion, kind, row.frontmatter) } : row;
       });
-      return { reply: ok(request.id, request.bridge, request.type, result) };
+      return { reply: ok(request.id, request.bridge, request.type, { ...result, ...skippedReply(skipped) }) };
     }
     if (request.type === "read" || request.type === "read-versioned") {
       const [result, registry, okfVersion] = await Promise.all([
@@ -6026,12 +6138,21 @@ var BridgeService = class {
       };
     }
     if (request.type === "edges") {
-      const edges = await queryEdges2(this.options.bundle, request.params);
+      const skipped = [];
+      const edges = await queryEdges2(this.options.bundle, request.params, {
+        onSkip: (skip) => skipped.push({ id: skip.id, reason: skip.reason })
+      });
       if (edges.length > MAX_EDGE_ROWS) {
         return { reply: fail(request.id, request.bridge, "TOO_LARGE", `the edge query exceeded ${MAX_EDGE_ROWS} rows`) };
       }
       const projected = edges.map(({ from, to, text }) => ({ from, to, text }));
-      return { reply: ok(request.id, request.bridge, request.type, { edges: projected, count: projected.length }) };
+      return {
+        reply: ok(request.id, request.bridge, request.type, {
+          edges: projected,
+          count: projected.length,
+          ...skippedReply(skipped)
+        })
+      };
     }
     if (request.type === "graph") {
       return this.graph(launch, request);

package/dist/publication.mjs

@@ -30951,6 +30951,16 @@ function stringifyDoc(frontmatter2, body) {
   return stringifyWithData(frontmatter2, body);
 }
 
+// ../core/src/meaningful-change-time.ts
+function meaningfulChangeTimeField(frontmatter2) {
+  const generated = frontmatter2.generated;
+  if (generated !== null && typeof generated === "object" && !Array.isArray(generated) && generated.at !== void 0) return "generated.at";
+  return "timestamp";
+}
+function meaningfulChangeTimeValue(frontmatter2) {
+  return meaningfulChangeTimeField(frontmatter2) === "generated.at" ? frontmatter2.generated.at : frontmatter2.timestamp;
+}
+
 // ../core/src/errors.ts
 var InvalidInputError = class extends Error {
   constructor(message) {
@@ -30982,6 +30992,58 @@ var ConcurrentReplacementError = class extends Error {
   }
 };
 
+// ../core/src/verification.ts
+var TRUST_TIERS = Object.freeze([
+  "unverified",
+  "machine-confirmed",
+  "human-reviewed"
+]);
+var ISO_INSTANT = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?(?:([Zz])|([+-])(\d{2})(?::?(\d{2}))?)$/;
+function parseIsoInstant(raw, rounding = "truncate") {
+  const match = ISO_INSTANT.exec(raw);
+  if (!match) return null;
+  const [, y, mo, d, h, mi, sec = "0", frac = "0", zulu, sign, oh, om = "0"] = match;
+  const year = Number(y);
+  const month = Number(mo);
+  const day = Number(d);
+  const hour = Number(h);
+  const minute = Number(mi);
+  const second = Number(sec);
+  if (month < 1 || month > 12) return null;
+  const probe = /* @__PURE__ */ new Date(0);
+  probe.setUTCFullYear(year, month, 0);
+  if (day < 1 || day > probe.getUTCDate()) return null;
+  if (hour > 23 || minute > 59 || second > 59) return null;
+  let offsetMinutes = 0;
+  if (!zulu) {
+    const offsetHours = Number(oh);
+    const offsetMins = Number(om);
+    if (offsetHours > 23 || offsetMins > 59) return null;
+    offsetMinutes = (sign === "-" ? -1 : 1) * (offsetHours * 60 + offsetMins);
+  }
+  const millis = Number(frac.padEnd(3, "0").slice(0, 3));
+  const instant = /* @__PURE__ */ new Date(0);
+  instant.setUTCFullYear(year, month - 1, day);
+  instant.setUTCHours(hour, minute, second, millis);
+  const remainder = rounding === "ceil" && /[1-9]/.test(frac.slice(3)) ? 1 : 0;
+  return instant.getTime() - offsetMinutes * 6e4 + remainder;
+}
+
+// ../core/src/freshness.ts
+function parseTimestamp(ts, okfVersion) {
+  if (okfVersion === "0.2") return typeof ts === "string" ? parseIsoInstant(ts) : null;
+  if (ts instanceof Date) {
+    const ms2 = ts.getTime();
+    return Number.isNaN(ms2) ? null : ms2;
+  }
+  if (typeof ts === "number") {
+    return Number.isFinite(ts) ? ts : null;
+  }
+  if (typeof ts !== "string" || ts.trim() === "") return null;
+  const ms = Date.parse(ts);
+  return Number.isNaN(ms) ? null : ms;
+}
+
 // ../core/src/okf-lifecycle.ts
 var OKF_LIFECYCLE_STATUSES = Object.freeze(["draft", "stable", "deprecated"]);
 function isOkfLifecycleStatus(value) {
@@ -31262,7 +31324,7 @@ async function query(backend, filter = {}, options = {}) {
 }
 async function queryHeads(backend, filter = {}, options = {}) {
   if (backend.queryHeads) {
-    const rows = (await backend.queryHeads(filter)).filter((row) => matchesFilter(row, filter));
+    const rows = (await backend.queryHeads(filter, options.onSkip ? { onSkip: options.onSkip } : void 0)).filter((row) => matchesFilter(row, filter));
     rows.sort((a, b) => a.id.localeCompare(b.id));
     return rows;
   }
@@ -31291,11 +31353,11 @@ function toSelectorList(value) {
   if (value === void 0) return void 0;
   return Array.isArray(value) ? value : [value];
 }
-async function queryEdges(backend, filter = {}) {
+async function queryEdges(backend, filter = {}, options = {}) {
   const fromSelectors = toSelectorList(filter.from)?.map(normalizeEdgeSelector);
   const toSelectors = toSelectorList(filter.to)?.map(normalizeEdgeSelector);
   const edges = [];
-  for (const doc of await query(backend)) {
+  for (const doc of await query(backend, {}, options)) {
     for (const link of parseLinksFromDoc(doc)) {
       if (!matchesEdgeSelector(link.from, fromSelectors)) continue;
       if (!matchesEdgeSelector(link.to, toSelectors)) continue;
@@ -32752,8 +32814,8 @@ async function query2(bundle, filter = {}, options = {}) {
 async function queryHeads2(bundle, filter = {}, options = {}) {
   return queryHeads(backendFor(bundle), filter, options);
 }
-async function queryEdges2(bundle, filter = {}) {
-  return queryEdges(backendFor(bundle), filter);
+async function queryEdges2(bundle, filter = {}, options = {}) {
+  return queryEdges(backendFor(bundle), filter, options);
 }
 
 // ../core/src/bundle.ts
@@ -42677,6 +42739,29 @@ function admitActiveView(bytes, contentType) {
   return { bytes: bytes.slice(), contentType: ACTIVE_VIEW_CONTENT_TYPE };
 }
 
+// ../core/src/query-order.ts
+function meaningfulChangeOrderKey(id, frontmatter2, okfVersion) {
+  const value = meaningfulChangeTimeValue(frontmatter2);
+  return {
+    id,
+    timestamp: typeof value === "string" ? value : "",
+    timestampMs: parseTimestamp(value, okfVersion ?? void 0)
+  };
+}
+function compareByMeaningfulChange(a, b) {
+  if (a.timestampMs !== null && b.timestampMs !== null) {
+    if (a.timestampMs !== b.timestampMs) return b.timestampMs - a.timestampMs;
+  } else if (a.timestampMs !== null) {
+    return -1;
+  } else if (b.timestampMs !== null) {
+    return 1;
+  }
+  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+}
+function sortByMeaningfulChange(rows, okfVersion) {
+  return rows.map((row) => ({ row, key: meaningfulChangeOrderKey(row.id, row.frontmatter, okfVersion) })).sort((a, b) => compareByMeaningfulChange(a.key, b.key)).map(({ row }) => row);
+}
+
 // ../view-runtime/src/bridge.ts
 var BRIDGE_PROTOCOL = "v0";
 var ACTION_BRIDGE_PROTOCOL = "v1";
@@ -42708,6 +42793,7 @@ var BRIDGE_HOST_CAPABILITIES = Object.freeze({
   queryFieldOr: "query.field-or",
   queryOpen: "query.open",
   queryCount: "query.count",
+  queryNewest: "query.newest",
   edges: "edges",
   renderDocument: "render-document",
   openPage: "open-page",
@@ -42722,10 +42808,12 @@ var BRIDGE_SERVICE_CAPABILITIES = Object.freeze([
   BRIDGE_HOST_CAPABILITIES.queryFieldOr,
   BRIDGE_HOST_CAPABILITIES.queryOpen,
   BRIDGE_HOST_CAPABILITIES.queryCount,
+  BRIDGE_HOST_CAPABILITIES.queryNewest,
   BRIDGE_HOST_CAPABILITIES.edges,
   BRIDGE_HOST_CAPABILITIES.graph,
   BRIDGE_HOST_CAPABILITIES.renderDocument
 ]);
+var BRIDGE_QUERY_ORDERS = Object.freeze(["id", "newest"]);
 var V0_REQUEST_TYPES = /* @__PURE__ */ new Set(["hello", "query", "read", "render-document", "edges", "graph", "subscribe", "host", "open-page"]);
 function isPlainRecord(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
@@ -42754,7 +42842,7 @@ function invalidV0RequestId(value) {
 }
 function normalizeQueryParams(raw) {
   if (!isPlainRecord(raw)) return null;
-  const allowed = /* @__PURE__ */ new Set(["type", "prefix", "field", "open", "limit"]);
+  const allowed = /* @__PURE__ */ new Set(["type", "prefix", "field", "open", "limit", "order"]);
   if (Object.keys(raw).some((key) => !allowed.has(key))) return null;
   const out = {};
   if (raw.type !== void 0) {
@@ -42782,6 +42870,10 @@ function normalizeQueryParams(raw) {
     }
     out.limit = raw.limit;
   }
+  if (raw.order !== void 0) {
+    if (!BRIDGE_QUERY_ORDERS.includes(raw.order)) return null;
+    out.order = raw.order;
+  }
   return out;
 }
 function selector(value) {
@@ -42909,9 +43001,19 @@ function fail(id, bridge, code2, message) {
 function replyWithinLimit(reply) {
   return Buffer.byteLength(JSON.stringify(reply), "utf8") <= MAX_REPLY_BYTES;
 }
+function skippedReply(skipped) {
+  if (skipped.length === 0) return {};
+  return { skipped: [...skipped].sort((a, b) => a.id.localeCompare(b.id)).slice(0, MAX_QUERY_ROWS) };
+}
 function boundedRows(rows, params, kinds) {
   const requested = params.limit === 0 || params.limit === void 0 ? MAX_QUERY_ROWS : Math.min(params.limit, MAX_QUERY_ROWS);
-  return applyQuerySelectionFilters(rows, { ...params, limit: requested }, kinds);
+  const { order, ...selection } = params;
+  if (order !== "newest") return applyQuerySelectionFilters(rows, { ...selection, limit: requested }, kinds);
+  const matched = applyQuerySelectionFilters(rows, { ...selection, limit: void 0 }, kinds);
+  return {
+    rows: sortByMeaningfulChange(matched.rows, selection.okfVersion).slice(0, requested),
+    count: matched.count
+  };
 }
 var BridgeService = class {
   constructor(options) {
@@ -43039,7 +43141,8 @@ var BridgeService = class {
     return { status: "reload-required", message };
   }
   async subscriptionSnapshot() {
-    const rows = await queryHeads2(this.options.bundle, {});
+    const rows = await queryHeads2(this.options.bundle, {}, { onSkip: () => {
+    } });
     if (rows.length > MAX_SUBSCRIPTION_HEADS) {
       throw new Error("the bundle is too large for the experimental View polling snapshot");
     }
@@ -43056,7 +43159,11 @@ var BridgeService = class {
    * capability before adding them.
    */
   async graph(launch, request) {
-    const heads = await queryHeads2(this.options.bundle, {});
+    const skipped = [];
+    const onSkip = (skip) => {
+      if (!skipped.some((row) => row.id === skip.id)) skipped.push({ id: skip.id, reason: skip.reason });
+    };
+    const heads = await queryHeads2(this.options.bundle, {}, { onSkip });
     if (heads.length > GRAPH_MAX_DOCUMENTS) {
       return {
         reply: fail(request.id, request.bridge, "TOO_LARGE", `the graph exceeded ${GRAPH_MAX_DOCUMENTS} documents`)
@@ -43065,7 +43172,7 @@ var BridgeService = class {
     const [registry, declaredOkfVersion, edges] = await Promise.all([
       loadKinds(this.options.bundle),
       readBundleOkfVersion2(this.options.bundle),
-      queryEdges2(this.options.bundle, {})
+      queryEdges2(this.options.bundle, {}, { onSkip })
     ]);
     if (edges.length > GRAPH_MAX_RELATIONSHIPS) {
       return {
@@ -43099,7 +43206,8 @@ var BridgeService = class {
         okfVersion,
         documents,
         relationships,
-        counts: { documents: documents.length, relationships: relationships.length }
+        counts: { documents: documents.length, relationships: relationships.length },
+        ...skippedReply(skipped)
       })
     };
   }
@@ -43157,10 +43265,14 @@ var BridgeService = class {
       return { reply: ok3(request.id, request.bridge, request.type, { capability: request.capability, output: outcome.output }) };
     }
     if (request.type === "query") {
+      if (request.params.order !== void 0 && !this.options.host.capabilities.includes(BRIDGE_HOST_CAPABILITIES.queryNewest)) {
+        return { reply: fail(request.id, request.bridge, "USAGE", "invalid or unsupported bridge request") };
+      }
+      const skipped = [];
       const rows = await queryHeads2(this.options.bundle, {
         ...request.params.type ? { type: request.params.type } : {},
         ...request.params.prefix ? { prefix: request.params.prefix } : {}
-      });
+      }, { onSkip: (skip) => skipped.push({ id: skip.id, reason: skip.reason }) });
       const [registry, okfVersion] = await Promise.all([
         loadKinds(this.options.bundle),
         readBundleOkfVersion2(this.options.bundle)
@@ -43174,7 +43286,7 @@ var BridgeService = class {
         const kind = registry.kinds.get(String(row.frontmatter.type ?? ""));
         return kind ? { ...row, frontmatter: projectLogicalKindFields(okfVersion, kind, row.frontmatter) } : row;
       });
-      return { reply: ok3(request.id, request.bridge, request.type, result) };
+      return { reply: ok3(request.id, request.bridge, request.type, { ...result, ...skippedReply(skipped) }) };
     }
     if (request.type === "read" || request.type === "read-versioned") {
       const [result, registry, okfVersion] = await Promise.all([
@@ -43226,12 +43338,21 @@ var BridgeService = class {
       };
     }
     if (request.type === "edges") {
-      const edges = await queryEdges2(this.options.bundle, request.params);
+      const skipped = [];
+      const edges = await queryEdges2(this.options.bundle, request.params, {
+        onSkip: (skip) => skipped.push({ id: skip.id, reason: skip.reason })
+      });
       if (edges.length > MAX_EDGE_ROWS) {
         return { reply: fail(request.id, request.bridge, "TOO_LARGE", `the edge query exceeded ${MAX_EDGE_ROWS} rows`) };
       }
       const projected = edges.map(({ from, to, text: text4 }) => ({ from, to, text: text4 }));
-      return { reply: ok3(request.id, request.bridge, request.type, { edges: projected, count: projected.length }) };
+      return {
+        reply: ok3(request.id, request.bridge, request.type, {
+          edges: projected,
+          count: projected.length,
+          ...skippedReply(skipped)
+        })
+      };
     }
     if (request.type === "graph") {
       return this.graph(launch, request);