@agent-native/core-corpus 0.212.0 → 0.213.1

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

@@ -6,6 +6,159 @@ import { importMessagesByLocale } from "./import-messages";
 import { trashMessagesByLocale } from "./trash-messages";
 
 const databaseMessages = {
+  githubLinkTitle: "Link a GitHub folder",
+  githubNewCollectionTitle: "New collection from a GitHub folder",
+  githubLinkDescription:
+    "Its documents show up here as read-only pages and update on their own when the files change on GitHub.",
+  githubNewCollectionDescription:
+    "Content makes a collection named after the folder. Its documents show up there as read-only pages and update on their own when the files change on GitHub.",
+  githubLinkUrlLabel: "GitHub folder link",
+  githubLinkUrlHelp:
+    "On GitHub, open the folder and copy the address from your browser.",
+  githubLinkCheck: "Check folder",
+  githubLinkReading: "Reading the folder on GitHub…",
+  githubConnectChecking: "Checking your GitHub connection…",
+  githubConnectPrompt:
+    "Connect your GitHub account so Content can read your folders.",
+  githubConnect: "Connect GitHub",
+  githubPreviewPagesOne: "1 page",
+  githubPreviewPages: "{{count}} pages",
+  githubPreviewPagesUpTo: "Up to {{count}} pages",
+  githubLinkMore: "{{count}} more",
+  githubLinkNoFiles:
+    "This folder has no Markdown (.md) files, so there’s nothing to show.",
+  githubPreviewColumnsOne: "1 column",
+  githubPreviewColumns: "{{count}} columns",
+  githubLinkNoColumns:
+    "These files have no details at the top, so each page just gets its title.",
+  githubLinkNotShownOne: "1 file won’t show yet.",
+  githubLinkNotShown: "{{count}} files won’t show yet.",
+  githubLinkPicturesWaiting:
+    "Pictures in these files won’t show until a workspace admin sets up file storage.",
+  githubShowDetails: "Show details",
+  githubHideDetails: "Hide details",
+  githubDetailsPages: "Pages",
+  githubDetailsColumns: "Columns",
+  githubDetailsColumnsSampled:
+    "Read from the first {{count}} of {{total}} files. Others can add columns.",
+  githubDetailsNotShown: "Won’t show yet",
+  githubDetailsFrom: "From",
+  githubDetailsBranchVersion: "Branch {{branch}} · version {{commit}}",
+  githubYes: "Yes",
+  githubNo: "No",
+  githubSkipMdx: "Uses MDX, which Content can’t show yet",
+  githubSkipTooLarge: "Too big for Content to show",
+  githubSkipNotText: "Not a text file Content can read",
+  githubLinkSubmitOne: "Link 1 page",
+  githubLinkSubmit: "Link {{count}} pages",
+  githubLinkSubmitUpTo: "Link up to {{count}} pages",
+  githubLinking: "Linking…",
+  githubLinkingProgressOne: "Bringing in 1 page from GitHub…",
+  githubLinkingProgress: "Bringing in {{count}} pages from GitHub…",
+  githubLinkedToastOne: "Linked. 1 page from {{folder}} is here.",
+  githubLinkedToast: "Linked. {{count}} pages from {{folder}} are here.",
+  githubLinkedPartialToast:
+    "Linked. {{done}} of {{total}} pages are here; the rest arrive within a minute.",
+  githubLinkedSyncFailed: "Linked {{folder}}, but couldn’t bring pages in yet.",
+  githubLinkInvalidUrl:
+    "That isn’t a GitHub folder link. On GitHub, open the folder and copy the address from your browser.",
+  githubLinkFileUrl: "That’s a link to one file.",
+  githubLinkUseFolder: "Use the “{{folder}}” folder",
+  githubLinkRepositoryNotFound:
+    "Can’t open “{{repo}}”. Check the spelling, or make sure your GitHub account can see it.",
+  githubLinkBranchNotFound:
+    "There’s no branch called “{{branch}}” in {{repo}}. Check the link.",
+  githubLinkFolderNotFound:
+    "There’s no folder called “{{folder}}” in {{repo}}. Check the link.",
+  githubLinkForbidden:
+    "Your GitHub account can’t open “{{repo}}”. Ask its owner for access.",
+  githubLinkTooLarge:
+    "This folder has more than {{max}} files. Pick a smaller folder inside it.",
+  githubLinkUnavailable:
+    "Couldn’t reach GitHub just now. Try again in a minute.",
+  githubLinkBlockedHasRows:
+    "This collection has pages now, so a GitHub folder can’t fill it.",
+  githubLinkBlockedLinked:
+    "This collection already gets its pages from another app.",
+  githubLinkBlockedSystem: "This collection can’t show a GitHub folder.",
+  githubNewCollectionInstead: "New collection from GitHub",
+  githubRowAvailable: "Show a GitHub folder’s documents here",
+  githubRowConnectFirst: "Connect your GitHub account first",
+  githubRowEmptyOnly: "Only for empty collections",
+  githubRowOtherSource: "Already gets its pages from {{source}}",
+  githubRowFiles: "Not available for Files",
+  githubRowSystem: "Not available for this collection",
+  githubRowEditorsOnly: "Editors only",
+  githubRowLinked: "{{folder}} folder · Updated {{time}}",
+  githubRowLinkedNotUpdated: "{{folder}} folder · Not updated yet",
+  githubRowUnavailableWhileLinked: "Not available while linked to GitHub",
+  githubExplainHasPagesOne:
+    "A GitHub folder fills a whole collection, so it needs one with no pages. This one has 1 page.",
+  githubExplainHasPages:
+    "A GitHub folder fills a whole collection, so it needs one with no pages. This one has {{count}} pages.",
+  githubExplainOtherSource:
+    "A collection gets its pages from one place. This one uses {{source}}.",
+  githubExplainFiles: "The Files collection can’t show a GitHub folder.",
+  githubExplainSystem: "This collection can’t show a GitHub folder.",
+  githubExplainEditorsOnly:
+    "Only people who can edit this collection can link a GitHub folder. Ask its owner for edit access.",
+  githubExplainLinked:
+    "This collection’s pages come from GitHub. Unlink the folder to use another source.",
+  githubDetailFolder: "Folder",
+  githubDetailBranch: "Branch",
+  githubDetailVersion: "Version",
+  githubDetailUpdated: "Updated",
+  githubCheckForUpdates: "Check for updates",
+  githubOpenFolder: "Open in GitHub",
+  githubUnlinkFolder: "Unlink folder…",
+  githubUnlinkTitle: "Unlink this GitHub folder?",
+  githubUnlinkBodyOne:
+    "The 1 page stays here and becomes a normal page you can edit. Changes on GitHub won’t come in anymore. To link this folder again later, you’ll use a new collection.",
+  githubUnlinkBody:
+    "The {{count}} pages stay here and become normal pages you can edit. Changes on GitHub won’t come in anymore. To link this folder again later, you’ll use a new collection.",
+  githubUnlink: "Unlink",
+  githubUnlinking: "Unlinking…",
+  githubUnlinkedToast:
+    "Unlinked. Your pages are kept and you can edit them now.",
+  githubUnlinkFailed: "Couldn’t unlink the folder",
+  githubFromFolder: "From the {{folder}} folder on GitHub",
+  githubFromRepo: "From {{repo}} on GitHub",
+  githubUpdatedAgo: "Updated {{time}}",
+  githubJustNow: "just now",
+  githubNotUpdatedYet: "Not updated yet",
+  githubEditOnGitHub: "Edit on GitHub",
+  githubDetails: "Details",
+  githubNotShownOne: "1 file not shown",
+  githubNotShown: "{{count}} files not shown",
+  githubNotShownHeading: "Not shown",
+  githubShowingAsOf: "Showing pages as of {{time}}.",
+  githubSyncingProgress: "Bringing in changes: {{done}} of {{total}} files",
+  githubPicturesWaiting:
+    "Some pictures won’t show until a workspace admin sets up file storage.",
+  githubReconnect: "Reconnect GitHub",
+  githubProblemConnection:
+    "Stopped updating: GitHub needs you to sign in again.",
+  githubProblemForbidden:
+    "Stopped updating: your GitHub account can’t open this repository now. Ask its owner for access.",
+  githubProblemRepositoryNotFound:
+    "Stopped updating: the repository was moved, renamed or made private.",
+  githubProblemBranchNotFound:
+    "Stopped updating: the “{{branch}}” branch is gone from GitHub.",
+  githubProblemFolderNotFound:
+    "Stopped updating: the “{{folder}}” folder is gone from that branch.",
+  githubProblemPaused:
+    "Updates are paused for a moment. They’ll resume on their own.",
+  githubProblemTooLarge:
+    "Stopped updating: the folder now has more than {{max}} files.",
+  githubProblemStorageUnavailable:
+    "Pictures won’t show until a workspace admin sets up file storage.",
+  githubAlreadyUpToDate: "Up to date.",
+  githubSyncedToastOne: "Updated. 1 page changed.",
+  githubSyncedToast: "Updated. {{count}} pages changed.",
+  githubSyncPartialToast: "Updating: {{done}} of {{total}} files so far.",
+  githubSyncBusy:
+    "Already checking for updates. Changes show when it finishes.",
+  emptyCollectionSourceHint: "Or fill it from a source",
   aField: "a field",
   addAnotherItemSourceBeforeChangingToDetails:
     "Add another item source before changing this source to details.",
@@ -377,7 +530,7 @@ const databaseMessages = {
   range: "Range",
   sum: "Sum",
   thisDatabaseIsLocalConnectASourceToMapIts:
-    "This collection is local. Connect a source to map its columns onto these rows.",
+    "Bring pages into this collection from another app.",
   builderApiReadOnly: "Builder API read-only",
   builderBodyEditsNeedSaferPath:
     "Builder body edits need a safer push path before they can be sent.",

package/corpus/templates/content/app/lib/github-link-dialog.ts

@@ -0,0 +1,86 @@
+/** What the GitHub folder dialog links: a collection, or a new one it makes. */
+export type GitHubLinkTarget =
+  | {
+      kind: "collection";
+      databaseId: string;
+      documentId: string;
+      /** Where a new collection beside this one would go, if it can't link. */
+      spaceId?: string;
+      parentId?: string | null;
+    }
+  | { kind: "new"; spaceId: string; parentId: string | null };
+
+export interface GitHubLinkDialogRequest {
+  target: GitHubLinkTarget;
+  /** A folder link to start from, like one typed before connecting GitHub. */
+  url?: string;
+  returnFocusTo?: HTMLElement | null;
+}
+
+export const GITHUB_LINK_DIALOG_OPEN_EVENT = "content:open-github-link";
+
+export function openGitHubLinkDialog(request: GitHubLinkDialogRequest) {
+  window.dispatchEvent(
+    new CustomEvent<GitHubLinkDialogRequest>(GITHUB_LINK_DIALOG_OPEN_EVENT, {
+      detail: request,
+    }),
+  );
+}
+
+// The page's address carries the dialog through GitHub's sign-in, so the
+// person comes back to it open rather than to where they started.
+const KIND_PARAM = "githubLink";
+const ID_PARAM = "githubId";
+const PAGE_PARAM = "githubPage";
+const URL_PARAM = "githubUrl";
+const PARAMS = [KIND_PARAM, ID_PARAM, PAGE_PARAM, URL_PARAM];
+
+/** This page's address with the dialog's target, for GitHub to return to. */
+export function githubLinkReturnPath(
+  location: { pathname: string; search: string },
+  target: GitHubLinkTarget,
+  url?: string,
+): string {
+  const params = new URLSearchParams(location.search);
+  for (const name of PARAMS) params.delete(name);
+  params.set(KIND_PARAM, target.kind);
+  if (target.kind === "collection") {
+    params.set(ID_PARAM, target.databaseId);
+    params.set(PAGE_PARAM, target.documentId);
+  } else {
+    params.set(ID_PARAM, target.spaceId);
+    if (target.parentId) params.set(PAGE_PARAM, target.parentId);
+  }
+  if (url?.trim()) params.set(URL_PARAM, url.trim());
+  return `${location.pathname}?${params.toString()}`;
+}
+
+/** The dialog an address asks to reopen, if any. */
+export function githubLinkRequestFromSearch(
+  search: string,
+): Omit<GitHubLinkDialogRequest, "returnFocusTo"> | null {
+  const params = new URLSearchParams(search);
+  const kind = params.get(KIND_PARAM);
+  const id = params.get(ID_PARAM);
+  const page = params.get(PAGE_PARAM);
+  const url = params.get(URL_PARAM) ?? undefined;
+  if (!id) return null;
+  if (kind === "collection" && page) {
+    return {
+      target: { kind, databaseId: id, documentId: page },
+      url,
+    };
+  }
+  if (kind === "new") {
+    return { target: { kind, spaceId: id, parentId: page || null }, url };
+  }
+  return null;
+}
+
+/** The query string without the dialog's params, or "" when none are left. */
+export function searchWithoutGitHubLink(search: string): string {
+  const params = new URLSearchParams(search);
+  for (const name of PARAMS) params.delete(name);
+  const rest = params.toString();
+  return rest ? `?${rest}` : "";
+}

package/corpus/templates/content/changelog/2026-10-18-connected-ai-assistants-can-link-a-new-collection-to-a-github.md

@@ -3,4 +3,4 @@ type: added
 date: 2026-10-18
 ---
 
-Connected AI assistants can link a new collection to a GitHub folder: each Markdown file becomes a view-only page, and a sync brings in the latest pushes
+Connected AI assistants can make a collection from a GitHub folder, or link an empty one: each Markdown file becomes a view-only page, and a sync brings in the latest pushes

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

@@ -0,0 +1,6 @@
+---
+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

package/corpus/templates/content/changelog/2026-10-21-organization-favorites-include-documents-shared-with-the-cur.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-21
+---
+
+Organization favorites include documents shared with the current member

package/corpus/templates/content/docs/product/capabilities/content.source.sync-policy.md

@@ -6,7 +6,7 @@ name: "Source sync policy"
 user_promise: "Each connected Source declares one plain-language policy for refresh and write-back: View only, Keep in sync, or Review before write-back."
 primary_user_job: "Connect work that remains trustworthy without deciding on every edit whether it should leave Content."
 kind: "primitive"
-state: "approved_shape"
+state: "in_progress"
 publicness: "public"
 availability: "configured"
 dependencies: ["content.source.catalog", "content.event.committed"]
@@ -23,9 +23,20 @@ proof_requirements:
     "Per-field or representation ownership, access intersection, base revisions, deterministic routing, conflict, retry, and receipt behavior",
     "End-to-end View only, Keep in sync, and Review before write-back workflows with provider-side verification",
   ]
-evidence: []
+evidence:
+  [
+    "templates/content/actions/_github-source.ts",
+    "templates/content/actions/_github-source-freshness.ts",
+    "templates/content/actions/github-source.db.test.ts",
+    "templates/content/shared/github-source.spec.ts",
+    "templates/content/actions/create-github-collection.ts",
+    "templates/content/app/components/editor/database/github-availability.ts",
+    "templates/content/app/components/editor/database/GitHubSourcePanel.tsx",
+    "templates/content/app/components/editor/database/GitHubSourceStatusLine.tsx",
+    "templates/content/app/components/editor/database/GitHubSourceStatusLine.ui.test.tsx",
+  ]
 superseded_by: null
-last_reviewed: "2026-07-29"
+last_reviewed: "2026-10-20"
 ---
 
 # Source sync policy
@@ -134,11 +145,25 @@ mutation occurs until the required review decision succeeds.
 
 ## Current evidence
 
+GitHub folders are the first Source whose **View only** policy holds end to
+end. `templates/content/actions/_github-source.ts` brings a branch's Markdown
+files into a Collection as Pages, resumably, renaming and trashing Pages as
+files move or disappear, and Content refuses edits to those Pages with the
+reason. `templates/content/actions/_github-source-freshness.ts` brings in
+pushes on a background sweep and before stale reads, so nobody has to ask.
+`GitHubSourceStatusLine.tsx` shows where the Pages come from and when they
+last updated, with the synced commit behind Details and the specific problem
+when one stops refresh. Sources says before any typing whether a Collection
+can take a folder and why not (`github-availability.ts`), and
+`create-github-collection.ts` makes a new Collection for the folder instead. `actions/github-source.db.test.ts`,
+`shared/github-source.spec.ts`, and the status line's UI tests exercise these
+paths through shared Actions and the interface.
+
 Existing change sets, guarded writes, source metadata, local synchronization,
-and audit records provide useful donor machinery. They do not yet prove one
-plain-language policy across adapters, ownership-aware routing everywhere,
-reliable receipt semantics, or the full interface workflow. This Capability
-therefore remains `approved_shape`.
+and audit records remain useful donor machinery. No Source yet offers **Keep
+in sync** or **Review before write-back**, and nothing proves ownership-aware
+routing, conflict handling, or receipts for outbound writes. This Capability
+is therefore `in_progress`.
 
 ## Proof plan
 

package/corpus/templates/content/docs/product/encyclopedia.md

@@ -16,8 +16,8 @@ This index summarizes the atomic product contracts beneath the public roadmap. E
 | Verified         |     4 |
 | Failing          |     1 |
 | Stale            |     0 |
-| In Progress      |    20 |
-| Approved Shape   |    87 |
+| In Progress      |    21 |
+| Approved Shape   |    86 |
 | Exploring        |     8 |
 | Deferred         |     0 |
 | Superseded       |     5 |
@@ -499,7 +499,7 @@ graph LR
 | [Page-linked Sources](capabilities/content.source.page-link.md)                   | Exploring      | A Page can bind to one external item while keeping Content identity and the provider's ownership clear.                                                        |
 | [Materialized multi-source Collections](capabilities/content.source.row-union.md) | Superseded     | The former multi-source row-union model remains migration evidence, while active composition moves toward source Queries.                                      |
 | [Content spaces and Files](capabilities/content.source.spaces-files.md)           | Verified       | Personal and organization-backed Content spaces and Files views keep work navigable without becoming a second permission system.                               |
-| [Source sync policy](capabilities/content.source.sync-policy.md)                  | Approved Shape | Each connected Source declares one plain-language policy for refresh and write-back: View only, Keep in sync, or Review before write-back.                     |
+| [Source sync policy](capabilities/content.source.sync-policy.md)                  | In Progress    | Each connected Source declares one plain-language policy for refresh and write-back: View only, Keep in sync, or Review before write-back.                     |
 
 ## System
 

package/corpus/templates/content/docs/product/features/content.feature.trust-your-connected-sources.md

@@ -8,7 +8,7 @@ order: 10
 roadmap_status: "partially_implemented"
 summary: "Keep supported edits synchronized according to one plain-language policy without silently losing provider-specific content."
 example_workflow: "An editor updates a Builder article from Content; the supported changes synchronize, an unknown Builder component survives untouched, and changing Draft to Published remains a separate guarded action."
-works_today: "Builder change sets, guarded writes, raw sidecars, local-folder synchronization, and source metadata already preserve several difficult round-trip and conflict boundaries."
+works_today: "Builder change sets, guarded writes, raw sidecars, local-folder synchronization, and source metadata already preserve several difficult round-trip and conflict boundaries. A new Collection can follow a GitHub folder as View only, bringing in pushes within about a minute."
 remains: "Every adapter needs certification against one plain-language sync policy, seamless automatic synchronization where safe, faithful unknown-content preservation, explicit lifecycle changes, and dependable receipts."
 required_capabilities:
   [
@@ -22,7 +22,7 @@ enhancing_capabilities:
 increments: []
 feature_proof: null
 publicness: "public"
-last_reviewed: "2026-07-29"
+last_reviewed: "2026-10-18"
 ---
 
 # Feature 10: Trust your connected Sources

package/corpus/templates/content/docs/product/roadmap.md

@@ -285,7 +285,7 @@ Keep supported edits synchronized according to one plain-language policy without
 
 **Example workflow:** An editor updates a Builder article from Content; the supported changes synchronize, an unknown Builder component survives untouched, and changing Draft to Published remains a separate guarded action.
 
-**What works today:** Builder change sets, guarded writes, raw sidecars, local-folder synchronization, and source metadata already preserve several difficult round-trip and conflict boundaries.
+**What works today:** Builder change sets, guarded writes, raw sidecars, local-folder synchronization, and source metadata already preserve several difficult round-trip and conflict boundaries. A new Collection can follow a GitHub folder as View only, bringing in pushes within about a minute.
 
 **What remains:** Every adapter needs certification against one plain-language sync policy, seamless automatic synchronization where safe, faithful unknown-content preservation, explicit lifecycle changes, and dependable receipts.