@agent-native/core-corpus 0.216.0 → 0.217.0

package/corpus/templates/content/app/components/editor/database/ListItemLayout.tsx

@@ -93,6 +93,7 @@ function PropertyChoices({
   selectedIds: savedIds,
   multiple,
   noneLabel,
+  otherChoice,
   onChange,
 }: {
   label: string;
@@ -100,6 +101,8 @@ function PropertyChoices({
   selectedIds: string[];
   multiple: boolean;
   noneLabel?: string;
+  /** A choice that isn't a property, listed after Nothing (Line 2's page text). */
+  otherChoice?: { label: string; selected: boolean; onSelect: () => void };
   onChange: (ids: string[]) => void;
 }) {
   // A saved slot can name a property this menu doesn't offer: one hidden, or
@@ -107,8 +110,11 @@ function PropertyChoices({
   // In Line 3 and End it stays saved for when it's shown again.
   const offeredIds = properties.map((property) => property.definition.id);
   const selectedIds = savedIds.filter((id) => offeredIds.includes(id));
-  const rows = [
+  const rows: Array<{ id: string; name: string; other?: true }> = [
     ...(noneLabel ? [{ id: "", name: noneLabel }] : []),
+    ...(otherChoice
+      ? [{ id: "", name: otherChoice.label, other: true as const }]
+      : []),
     ...properties.map((property) => ({
       id: property.definition.id,
       name: property.definition.name,
@@ -121,9 +127,11 @@ function PropertyChoices({
       className="grid max-h-56 gap-0.5 overflow-y-auto"
     >
       {rows.map((row) => {
-        const selected = row.id
-          ? selectedIds.includes(row.id)
-          : selectedIds.length === 0;
+        const selected = row.other
+          ? otherChoice!.selected
+          : row.id
+            ? selectedIds.includes(row.id)
+            : selectedIds.length === 0 && !otherChoice?.selected;
         const position = row.id ? selectedIds.indexOf(row.id) : -1;
         const full =
           multiple &&
@@ -132,12 +140,13 @@ function PropertyChoices({
           selectedIds.length >= MAX_ITEM_LAYOUT_META_PROPERTIES;
         return (
           <button
-            key={row.id || "none"}
+            key={row.id || (row.other ? "other" : "none")}
             type="button"
             aria-pressed={selected}
             disabled={full}
             className="flex h-8 items-center gap-2 rounded px-2 text-left text-sm enabled:hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-50"
             onClick={() => {
+              if (row.other) return otherChoice!.onSelect();
               if (!multiple) return onChange(row.id ? [row.id] : []);
               onChange(
                 toggleContentDatabaseItemLayoutMetaProperty(
@@ -253,22 +262,37 @@ export function ListItemLayoutSlotEditor({
     );
   }
   if (slot === "line2") {
+    const pageText = layout.line2.source === "page";
+    const { lines } = layout.line2;
     return (
       <div className="grid gap-2">
         <PropertyChoices
           label={label}
           properties={itemLayoutLine2Candidates(properties)}
-          selectedIds={layout.line2.propertyId ? [layout.line2.propertyId] : []}
+          selectedIds={
+            !pageText && layout.line2.propertyId
+              ? [layout.line2.propertyId]
+              : []
+          }
           multiple={false}
           noneLabel={dbText("listRowsNothing")}
+          otherChoice={{
+            label: dbText("listRowsPageText"),
+            selected: pageText,
+            onSelect: () =>
+              onChange({
+                ...layout,
+                line2: { source: "page", propertyId: null, lines },
+              }),
+          }}
           onChange={([id]) =>
             onChange({
               ...layout,
-              line2: { ...layout.line2, propertyId: id ?? null },
+              line2: { propertyId: id ?? null, lines },
             })
           }
         />
-        {layout.line2.propertyId ? (
+        {pageText || layout.line2.propertyId ? (
           <Segmented<1 | 2 | 3>
             label={label}
             value={layout.line2.lines}

package/corpus/templates/content/app/components/editor/database/ListItemRow.tsx

@@ -7,7 +7,10 @@ import type {
   ContentDatabaseItemLayoutSlot,
   ResolvedContentDatabaseItemLayout,
 } from "@shared/database-item-layout";
-import { stripMarkdownForPreview } from "@shared/og-description";
+import {
+  buildListRowExcerpt,
+  stripMarkdownForPreview,
+} from "@shared/og-description";
 import {
   isEmptyPropertyValue,
   type DocumentPropertyOptionColor,
@@ -93,11 +96,29 @@ function line2Text(property: DocumentProperty) {
     : value.trim();
 }
 
+/**
+ * The first lines of a row's page. The list read sends an excerpt, and saving
+ * the page's body in this tab rebuilds it. Until a read brings one (right after
+ * Page text is picked), a body this tab already holds stands in.
+ */
+function pageExcerpt(item: ContentDatabaseItem) {
+  if (item.excerpt !== undefined) return item.excerpt;
+  return item.document.content
+    ? buildListRowExcerpt({
+        content: item.document.content,
+        title: item.document.title,
+      })
+    : "";
+}
+
 /** The fields a slot shows, which can be set but blank on a given row. */
 function slotFieldNames(
   resolved: ResolvedContentDatabaseItemLayout<DocumentProperty>,
   slot: ContentDatabaseItemLayoutSlot,
 ) {
+  if (slot === "line2" && resolved.line2.pageText) {
+    return [dbText("listRowsPageText")];
+  }
   const fields =
     slot === "line2"
       ? resolved.line2.property
@@ -305,7 +326,11 @@ export function DatabaseLayoutListRow({
   const line2Property = resolved.line2.property
     ? itemValue(item, resolved.line2.property)
     : null;
-  const line2 = line2Property ? line2Text(line2Property) : "";
+  const line2 = resolved.line2.pageText
+    ? pageExcerpt(item)
+    : line2Property
+      ? line2Text(line2Property)
+      : "";
   const filled = (properties: DocumentProperty[]) =>
     properties
       .map((property) => itemValue(item, property))

package/corpus/templates/content/app/components/editor/database-sources/BuilderSourceReviewDialog.tsx

@@ -238,6 +238,7 @@ export function builderReviewRowCanCancelPrepared(
 ) {
   const execution = row.execution;
   if (!execution) return false;
+  if (execution.payloadUnavailable) return false;
   if (
     execution.state !== "ready" &&
     execution.state !== "write_disabled" &&

package/corpus/templates/content/app/hooks/use-content-database.ts

@@ -58,6 +58,7 @@ import type {
   ValidateBuilderSourceExecutionRequest,
   DocumentPropertyRelationTarget,
 } from "@shared/api";
+import { contentDatabaseViewsShowPageText } from "@shared/database-item-layout";
 import type { Query, QueryClient } from "@tanstack/react-query";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 
@@ -255,6 +256,29 @@ export function contentDatabaseItemsContainingDocumentFilter(
   };
 }
 
+/**
+ * Collection reads whose row for a page shows its page text. The server skips
+ * a first paragraph that repeats the title, so a rename can change that text.
+ */
+export function contentDatabaseExcerptContainingDocumentFilter(
+  documentId: string,
+) {
+  return {
+    queryKey: ["action", "get-content-database"],
+    predicate: (query: Query) => {
+      const data = query.state.data as
+        | Partial<ContentDatabaseResponse>
+        | undefined;
+      return (
+        data?.items?.some(
+          (item) =>
+            item.document.id === documentId && item.excerpt !== undefined,
+        ) === true
+      );
+    },
+  };
+}
+
 export function invalidateContentDatabaseNavigationQueries(
   queryClient: Pick<QueryClient, "invalidateQueries">,
   scope: { databaseId?: string; parentId?: string | null } = {},
@@ -504,6 +528,20 @@ export function isContentDatabaseUnavailable(
   );
 }
 
+/**
+ * Unpaged reads (row menus, pickers) leave out page text, so one can't stand
+ * in for the List's read of a collection whose List view shows it.
+ */
+function canSeedContentDatabaseRead(
+  data: ContentDatabaseResponse | undefined,
+): data is ContentDatabaseResponse {
+  if (!data || isContentDatabaseUnavailable(data)) return false;
+  return (
+    !contentDatabaseViewsShowPageText(data.database?.viewConfig?.views ?? []) ||
+    data.items.every((item) => item.excerpt !== undefined)
+  );
+}
+
 export function readCachedContentDatabaseResponse(
   queryClient: Pick<QueryClient, "getQueryData" | "getQueriesData">,
   documentId: string,
@@ -511,13 +549,13 @@ export function readCachedContentDatabaseResponse(
   const exact = queryClient.getQueryData<ContentDatabaseResponse>(
     contentDatabaseQueryKey(documentId),
   );
-  if (exact && !isContentDatabaseUnavailable(exact)) return exact;
+  if (canSeedContentDatabaseRead(exact)) return exact;
 
   const cached = queryClient
     .getQueriesData<ContentDatabaseResponse>(
       contentDatabaseQueryFilter(documentId),
     )
-    .find(([, data]) => data && !isContentDatabaseUnavailable(data));
+    .find(([, data]) => canSeedContentDatabaseRead(data));
   return cached?.[1];
 }
 

package/corpus/templates/content/app/hooks/use-documents.ts

@@ -29,6 +29,7 @@ import type {
 import type { ContentSidebarSections } from "@shared/content-personal-navigation";
 import type { ContentRecentResult } from "@shared/content-personal-navigation";
 import { applyContentPersonalNavigationPatch } from "@shared/content-personal-navigation-patch";
+import { buildListRowExcerpt } from "@shared/og-description";
 import type { QueryClient } from "@tanstack/react-query";
 import {
   hashKey,
@@ -88,6 +89,7 @@ import {
 } from "./use-content-action-mutation";
 import {
   contentDatabaseConstrainedQueryFilter,
+  contentDatabaseExcerptContainingDocumentFilter,
   contentDatabaseItemsContainingDocumentFilter,
   contentDatabaseNavigationQueryFilter,
   invalidateContentDatabaseNavigationQueries,
@@ -455,6 +457,17 @@ export function patchDocumentInDatabaseCache<
     return {
       ...item,
       document: { ...item.document, ...patch },
+      // A saved body, even an empty one, replaces the excerpt the read sent.
+      ...(patch.content !== undefined &&
+      "excerpt" in item &&
+      item.excerpt !== undefined
+        ? {
+            excerpt: buildListRowExcerpt({
+              content: patch.content,
+              title: patch.title ?? item.document.title,
+            }),
+          }
+        : {}),
     };
   });
   return changed ? ({ ...current, items } as T) : current;
@@ -1554,6 +1567,7 @@ export function useUpdateDocument(options?: { saveOrigin?: "recovery" }) {
         if (variables.title !== undefined) {
           invalidateContentQueries(queryClient, [
             contentDatabaseConstrainedQueryFilter(),
+            contentDatabaseExcerptContainingDocumentFilter(variables.id),
             ...contentRowTargets(queryClient, [variables.id]),
             ["action", "search-documents"],
           ]);

package/corpus/templates/content/app/i18n-data.ts

@@ -473,6 +473,7 @@ const databaseMessages = {
   listRowsMedium: "Medium",
   listRowsBold: "Bold",
   listRowsNothing: "Nothing",
+  listRowsPageText: "Page text",
   listRowsOneLine: "1 line",
   listRowsLineCount: "{{count}} lines",
   listRowsNoStatus: "No status",

package/corpus/templates/content/changelog/2026-10-17-builder-content-avoids-retrying-a-write-when-builder-accepte.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-17
+---
+
+Builder Content avoids retrying a write when Builder accepted it but the response could not be saved.

package/corpus/templates/content/changelog/2026-10-18-link-a-new-collection-to-a-github-folder-from-its-sources.md

@@ -3,4 +3,4 @@ type: added
 date: 2026-10-18
 ---
 
-Make a collection from a GitHub folder in the sidebar's New menu, or fill an empty one from its Sources settings, which say up front when GitHub can't link and what to do instead. A short preview comes before linking, the collection shows where its pages come from and when they last updated, and unlinking asks first
+Fill a collection from a GitHub folder through its Sources settings, which an empty collection links to from under its title and which say up front when GitHub can't link and what to do instead. A short preview comes before linking, the collection shows where its pages come from and when they last updated, with a link back to its folder in Sources, and unlinking asks first

package/corpus/templates/content/changelog/2026-10-20-builder-content-sync-keeps-read-and-write-status-accurate-wh.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-20
+---
+
+Builder content sync keeps read and write status accurate when API responses fail.

package/corpus/templates/content/changelog/2026-10-21-list-rows-can-show-each-pages-first-lines.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-10-21
+---
+
+List rows can show the first lines of each page under its title: pick **Page text** for Line 2

package/corpus/templates/content/changelog/2026-10-22-a-collection-linked-to-a-big-github-folder-fills-faster-and-p.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-10-22
+---
+
+A collection linked to a big GitHub folder fills faster, and pushes to other linked collections aren't held up while it does

package/corpus/templates/content/docs/product/capabilities/content.source.adapters.md

@@ -134,6 +134,35 @@ adapters that are valuable substrate. Existing provider-specific behavior does
 not yet certify the common declaration model, every operation, or cross-source
 authorization and fidelity behavior. This Capability remains `in_progress`.
 
+The bounded Builder OAuth consumer requests general content read/write scopes,
+uses the existing models, query-data, and Write API routes, and binds
+subsequent mutation calls to the Builder space observed during source refresh.
+Focused client tests cover general OAuth precedence, legacy and Publish grant
+separation, raw draft-inclusive enumeration, exact-entry reads, cross-space
+rejection, and ambiguous writes without replay. This is adapter substrate, not
+certification: Builder model discovery remains developer/admin-only, indexed
+reads do not expose the editable autosave head, and the Write API has no
+conditional write.
+
+Existing-entry Builder writes are guarded on the Content side. Review records
+the entry's Builder `lastUpdated` from the last refresh, and a later refresh
+that moves it makes the review stale. Immediately before each existing-entry
+write, Content reads the live `lastUpdated` through the bound OAuth content API
+and blocks without writing when it differs from the reviewed value or when
+either value is missing. This narrows the overwrite window but does not close
+it: a Builder save that lands after that read and before Content's write
+reaches Builder is still overwritten. Closing that window would need a
+conditional write in Builder's API, which is out of scope. Unsaved Builder
+editor state is not visible to the check. Focused execution tests cover it; it
+has not been exercised against a live Builder space. New-entry creation keeps
+its existing intent-reconciliation path.
+
+Prepared requests and receipts use identity-bound private blobs with verified
+readback; SQL stores compact opaque references. Exact replacement and deletion
+cleanup runs after confirmed database success; ambiguous outcomes retain
+evidence. A crash before pointer persistence can leave an unreachable blob; no
+general garbage collector is added.
+
 ## Proof plan
 
 1. Validate adapter declarations and Action routing for a read-only provider,