@agent-native/core 0.151.2 → 0.152.1

package/corpus/templates/content/app/components/editor/BubbleToolbar.tsx

@@ -1,15 +1,13 @@
 import { useT } from "@agent-native/core/client/i18n";
 import {
   IconBold,
+  IconCheck,
+  IconChevronDown,
   IconItalic,
   IconStrikethrough,
   IconCode,
   IconLink,
   IconMessageCircle,
-  IconH1,
-  IconH2,
-  IconH3,
-  IconH4,
 } from "@tabler/icons-react";
 import {
   NodeSelection,
@@ -20,8 +18,13 @@ import {
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 import type { Editor } from "@tiptap/react";
 import { BubbleMenu } from "@tiptap/react/menus";
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
 import {
   Tooltip,
   TooltipContent,
@@ -56,6 +59,15 @@ type SelectionFillRange = {
   to: number;
 };
 
+type TextStyle = "paragraph" | 1 | 2 | 3 | 4 | 5 | 6;
+
+function activeTextStyle(editor: Editor): TextStyle {
+  for (const level of [1, 2, 3, 4, 5, 6] as const) {
+    if (editor.isActive("heading", { level })) return level;
+  }
+  return "paragraph";
+}
+
 const selectionFillPluginKey = new PluginKey<SelectionFillRange | null>(
   "contentSelectionFill",
 );
@@ -106,6 +118,86 @@ export function BubbleToolbar({ editor, onComment }: BubbleToolbarProps) {
   const t = useT();
   const [showLinkInput, setShowLinkInput] = useState(false);
   const [linkUrl, setLinkUrl] = useState("");
+  const [textStyleOpen, setTextStyleOpen] = useState(false);
+  const textStyleSelection = useRef<{ from: number; to: number } | null>(null);
+  const textStyleApplied = useRef(false);
+  const restoreEditorFocusOnClose = useRef(false);
+  const [textStyle, setTextStyle] = useState<TextStyle>(() =>
+    activeTextStyle(editor),
+  );
+
+  useEffect(() => {
+    const syncTextStyle = () => {
+      setTextStyle(activeTextStyle(editor));
+      const { from, to } = editor.state.selection;
+      if (from !== to) textStyleSelection.current = { from, to };
+    };
+    editor.on("selectionUpdate", syncTextStyle);
+    editor.on("transaction", syncTextStyle);
+    syncTextStyle();
+    return () => {
+      editor.off("selectionUpdate", syncTextStyle);
+      editor.off("transaction", syncTextStyle);
+    };
+  }, [editor]);
+
+  const textStyles = [
+    {
+      value: "paragraph" as const,
+      shortLabel: t("editor.slash.text"),
+      menuLabel: "T",
+      label: t("editor.slash.text"),
+    },
+    {
+      value: 1 as const,
+      shortLabel: "H1",
+      menuLabel: "H1",
+      label: t("editor.heading1"),
+    },
+    {
+      value: 2 as const,
+      shortLabel: "H2",
+      menuLabel: "H2",
+      label: t("editor.heading2"),
+    },
+    {
+      value: 3 as const,
+      shortLabel: "H3",
+      menuLabel: "H3",
+      label: t("editor.heading3"),
+    },
+    {
+      value: 4 as const,
+      shortLabel: "H4",
+      menuLabel: "H4",
+      label: t("editor.heading4"),
+    },
+  ];
+  const selectedTextStyle =
+    textStyles.find((style) => style.value === textStyle) ??
+    (typeof textStyle === "number"
+      ? {
+          value: textStyle,
+          shortLabel: `H${textStyle}`,
+          menuLabel: `H${textStyle}`,
+          label: textStyle === 5 ? t("editor.heading5") : t("editor.heading6"),
+        }
+      : textStyles[0]);
+
+  const applyTextStyle = (style: TextStyle) => {
+    const chain = editor.chain();
+    if (textStyleSelection.current) {
+      chain.setTextSelection(textStyleSelection.current);
+    }
+    if (style === "paragraph") {
+      chain.setParagraph().focus().run();
+    } else {
+      chain.setHeading({ level: style }).focus().run();
+    }
+    textStyleApplied.current = true;
+    setTextStyle(style);
+    setTextStyleOpen(false);
+  };
 
   const openLinkInput = useCallback(() => {
     setLinkUrl(editor.getAttributes("link").href || "");
@@ -251,30 +343,7 @@ export function BubbleToolbar({ editor, onComment }: BubbleToolbarProps) {
       isActive: () => editor.isActive("code"),
     },
     { type: "divider" as const },
-    {
-      icon: IconH1,
-      title: t("editor.heading1"),
-      action: () => editor.chain().focus().toggleHeading({ level: 1 }).run(),
-      isActive: () => editor.isActive("heading", { level: 1 }),
-    },
-    {
-      icon: IconH2,
-      title: t("editor.heading2"),
-      action: () => editor.chain().focus().toggleHeading({ level: 2 }).run(),
-      isActive: () => editor.isActive("heading", { level: 2 }),
-    },
-    {
-      icon: IconH3,
-      title: t("editor.heading3"),
-      action: () => editor.chain().focus().toggleHeading({ level: 3 }).run(),
-      isActive: () => editor.isActive("heading", { level: 3 }),
-    },
-    {
-      icon: IconH4,
-      title: t("editor.heading4"),
-      action: () => editor.chain().focus().toggleHeading({ level: 4 }).run(),
-      isActive: () => editor.isActive("heading", { level: 4 }),
-    },
+    { type: "text-style" as const },
     { type: "divider" as const },
     {
       icon: IconLink,
@@ -354,7 +423,7 @@ export function BubbleToolbar({ editor, onComment }: BubbleToolbarProps) {
         </div>
       ) : (
         <div
-          className="flex items-center gap-0.5 overflow-x-auto"
+          className="flex max-w-[calc(100vw-1rem)] items-center gap-0.5"
           onMouseDown={(e) => e.preventDefault()}
         >
           {items.map((item, i) => {
@@ -363,6 +432,103 @@ export function BubbleToolbar({ editor, onComment }: BubbleToolbarProps) {
                 <div key={`d-${i}`} className="w-px h-5 bg-border mx-0.5" />
               );
             }
+            if ("type" in item && item.type === "text-style") {
+              return (
+                <Popover
+                  key="text-style"
+                  open={textStyleOpen}
+                  onOpenChange={(open) => {
+                    if (open) {
+                      textStyleApplied.current = false;
+                      restoreEditorFocusOnClose.current = false;
+                      const { from, to } = editor.state.selection;
+                      if (from !== to)
+                        textStyleSelection.current = { from, to };
+                    }
+                    setTextStyleOpen(open);
+                  }}
+                >
+                  <PopoverTrigger asChild>
+                    <button
+                      type="button"
+                      aria-label={`${t("editor.slash.turnInto")}: ${selectedTextStyle.label}`}
+                      className="flex h-8 min-w-14 items-center justify-between gap-1 rounded px-2 text-sm font-medium text-popover-foreground/85 hover:bg-accent hover:text-accent-foreground"
+                    >
+                      <span>{selectedTextStyle.shortLabel}</span>
+                      <IconChevronDown size={14} strokeWidth={2} />
+                    </button>
+                  </PopoverTrigger>
+                  <PopoverContent
+                    portalled={false}
+                    align="start"
+                    sideOffset={24}
+                    className="w-44 p-1"
+                    onEscapeKeyDown={() => {
+                      restoreEditorFocusOnClose.current = true;
+                      window.setTimeout(() => editor.commands.focus(), 0);
+                    }}
+                    onCloseAutoFocus={(event) => {
+                      if (
+                        textStyleApplied.current ||
+                        restoreEditorFocusOnClose.current
+                      ) {
+                        event.preventDefault();
+                      }
+                      if (restoreEditorFocusOnClose.current) {
+                        editor.commands.focus();
+                      }
+                      textStyleApplied.current = false;
+                      restoreEditorFocusOnClose.current = false;
+                    }}
+                  >
+                    <div className="px-2 py-1 text-xs font-medium text-muted-foreground">
+                      {t("editor.slash.turnInto")}
+                    </div>
+                    <div
+                      role="menu"
+                      aria-label={t("editor.slash.turnInto")}
+                      className="flex flex-col gap-0.5"
+                    >
+                      {textStyles.map((style) => {
+                        const isSelected = style.value === textStyle;
+                        return (
+                          <button
+                            key={style.value}
+                            type="button"
+                            role="menuitemradio"
+                            aria-checked={isSelected}
+                            onPointerDown={(event) => {
+                              event.preventDefault();
+                              event.stopPropagation();
+                              applyTextStyle(style.value);
+                            }}
+                            onClick={(event) => {
+                              if (event.detail === 0) {
+                                applyTextStyle(style.value);
+                              }
+                            }}
+                            className={cn(
+                              "flex h-8 w-full items-center gap-2 rounded px-2 text-left text-sm",
+                              isSelected
+                                ? "bg-accent text-accent-foreground"
+                                : "text-popover-foreground hover:bg-accent hover:text-accent-foreground",
+                            )}
+                          >
+                            <span className="w-6 shrink-0 text-xs font-semibold text-muted-foreground">
+                              {style.menuLabel}
+                            </span>
+                            <span className="flex-1">{style.label}</span>
+                            {isSelected ? (
+                              <IconCheck size={15} strokeWidth={2.25} />
+                            ) : null}
+                          </button>
+                        );
+                      })}
+                    </div>
+                  </PopoverContent>
+                </Popover>
+              );
+            }
             const {
               icon: Icon,
               title,

package/corpus/templates/content/app/components/editor/DocumentEditor.tsx

@@ -78,6 +78,7 @@ import {
   useDocumentSyncStatus,
   usePushDocumentToNotion,
 } from "@/hooks/use-notion";
+import { rememberContentLandingDocument } from "@/lib/content-landing";
 import {
   canWriteLinkedLocalSource,
   writeDocumentToLinkedLocalSource,
@@ -538,6 +539,14 @@ function DocumentEditorBody({
   databaseDocumentId,
 }: DocumentEditorBodyProps) {
   const t = useT();
+  useEffect(() => {
+    void rememberContentLandingDocument(documentId).catch((error) => {
+      toast.error(t("landing.saveFailed"), {
+        description:
+          error instanceof Error ? error.message : t("empty.genericError"),
+      });
+    });
+  }, [documentId, t]);
   const updateDocument = useUpdateDocument();
   const createDatabase = useCreateContentDatabase(documentId);
   const deleteContentDatabase = useDeleteContentDatabase();

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

@@ -3041,6 +3041,11 @@ const enUS = {
     agent: "Agent",
     settings: "Settings",
   },
+  landing: {
+    previousPageUnavailable:
+      "Your previous page is no longer available, so we opened Welcome.",
+    saveFailed: "Your place could not be saved",
+  },
   team: {
     metaTitle: "Workspace access - Content",
     pageTitle: "Workspace access",
@@ -8959,11 +8964,63 @@ const commentMessagesByLocale = {
   "ar-SA": { unanchored: "التمييز غير متاح" },
 } satisfies Partial<Record<LocaleCode, Partial<typeof enUS.comments>>>;
 
+const landingMessagesByLocale = {
+  "zh-CN": {
+    previousPageUnavailable: "您之前的页面已不可用，因此我们打开了欢迎页面。",
+    saveFailed: "无法保存您的位置",
+  },
+  "zh-TW": {
+    previousPageUnavailable: "您先前的頁面已無法使用，因此我們開啟了歡迎頁面。",
+    saveFailed: "無法儲存您的位置",
+  },
+  "es-ES": {
+    previousPageUnavailable:
+      "Tu página anterior ya no está disponible, así que abrimos la página de bienvenida.",
+    saveFailed: "No se pudo guardar tu ubicación",
+  },
+  "fr-FR": {
+    previousPageUnavailable:
+      "Votre page précédente n’est plus disponible. Nous avons donc ouvert la page de bienvenue.",
+    saveFailed: "Votre emplacement n’a pas pu être enregistré",
+  },
+  "de-DE": {
+    previousPageUnavailable:
+      "Deine vorherige Seite ist nicht mehr verfügbar. Daher wurde die Willkommensseite geöffnet.",
+    saveFailed: "Deine Position konnte nicht gespeichert werden",
+  },
+  "ja-JP": {
+    previousPageUnavailable:
+      "前回のページを利用できないため、ようこそページを開きました。",
+    saveFailed: "現在位置を保存できませんでした",
+  },
+  "ko-KR": {
+    previousPageUnavailable:
+      "이전 페이지를 더 이상 사용할 수 없어 시작 페이지를 열었습니다.",
+    saveFailed: "현재 위치를 저장하지 못했습니다",
+  },
+  "pt-BR": {
+    previousPageUnavailable:
+      "Sua página anterior não está mais disponível, então abrimos a página de boas-vindas.",
+    saveFailed: "Não foi possível salvar sua localização",
+  },
+  "hi-IN": {
+    previousPageUnavailable:
+      "आपका पिछला पेज अब उपलब्ध नहीं है, इसलिए हमने स्वागत पेज खोल दिया है।",
+    saveFailed: "आपकी जगह सेव नहीं की जा सकी",
+  },
+  "ar-SA": {
+    previousPageUnavailable:
+      "لم تعد صفحتك السابقة متاحة، لذلك فتحنا صفحة الترحيب.",
+    saveFailed: "تعذر حفظ موضعك",
+  },
+} satisfies Record<Exclude<LocaleCode, "en-US">, typeof enUS.landing>;
+
 function mergeMessages(overrides: PartialMessages): Messages {
   return {
     root: { ...enUS.root, ...overrides.root },
     theme: { ...enUS.theme, ...overrides.theme },
     navigation: { ...enUS.navigation, ...overrides.navigation },
+    landing: { ...enUS.landing, ...overrides.landing },
     team: { ...enUS.team, ...overrides.team },
     settings: { ...enUS.settings, ...overrides.settings },
     chat: { ...enUS.chat, ...overrides.chat },
@@ -9061,6 +9118,7 @@ function mergeMessagesForLocale(
   return {
     ...base,
     comments: { ...base.comments, ...commentMessagesByLocale[locale] },
+    landing: { ...base.landing, ...landingMessagesByLocale[locale] },
     root: { ...base.root, ...rawLiteralOverrides.root },
     team: { ...base.team, ...rawLiteralOverrides.team },
     settings: { ...base.settings, ...rawLiteralOverrides.settings },

package/corpus/templates/content/app/lib/content-landing.ts

@@ -0,0 +1,22 @@
+import { writeClientAppState } from "@agent-native/core/client/application-state";
+import {
+  CONTENT_LAST_LOCATION_STATE_KEY,
+  type ContentLastLocationState,
+} from "@shared/content-landing";
+
+let landingWriteQueue = Promise.resolve();
+
+export function rememberContentLandingDocument(documentId: string) {
+  const write = landingWriteQueue.then(() =>
+    writeClientAppState<ContentLastLocationState>(
+      CONTENT_LAST_LOCATION_STATE_KEY,
+      { documentId },
+      { requestSource: "content-landing" },
+    ),
+  );
+  landingWriteQueue = write.then(
+    () => undefined,
+    () => undefined,
+  );
+  return write;
+}

package/corpus/templates/content/app/root.tsx

@@ -212,7 +212,6 @@ export function Layout({ children }: { children: React.ReactNode }) {
           suppressHydrationWarning
           dangerouslySetInnerHTML={{ __html: localeInitScript }}
         />
-        <link rel="manifest" href={appPath("/manifest.json")} />
         <meta name="theme-color" content="#10B981" />
         <meta name="mobile-web-app-capable" content="yes" />
         <meta

package/corpus/templates/content/app/routes/_app._index.tsx

@@ -1,11 +1,12 @@
-import type { Document } from "@shared/api";
-import { useEffect } from "react";
+import { useActionMutation } from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
+import type { ContentLandingResult } from "@shared/content-landing";
+import { useCallback, useEffect, useRef } from "react";
 import { useNavigate } from "react-router";
+import { toast } from "sonner";
 
-import { EmptyState } from "@/components/EmptyState";
 import { QueryErrorState } from "@/components/QueryErrorState";
 import { Skeleton } from "@/components/ui/skeleton";
-import { useDocuments } from "@/hooks/use-documents";
 
 const SEO_TITLE = "Content - Open Source, agent-friendly Obsidian alternative";
 const SEO_DESCRIPTION =
@@ -46,36 +47,45 @@ function DocumentSkeleton() {
 }
 
 export default function IndexRoute() {
+  const t = useT();
   const navigate = useNavigate();
-  const documentsQuery = useDocuments();
-  const documents: Document[] = documentsQuery.data ?? [];
-  const isLoading = documentsQuery.isLoading;
+  const startedRef = useRef(false);
+  const resolveLanding = useActionMutation<
+    ContentLandingResult,
+    Record<string, never>
+  >("resolve-content-landing");
 
-  // Auto-select the first favorite, or the first document if no favorites
-  useEffect(() => {
-    if (documents && documents.length > 0) {
-      const openableDocuments = documents.filter(
-        (document) => document.source?.kind !== "folder",
-      );
-      const firstFavorite = openableDocuments.find((d) => d.isFavorite);
-      const target = firstFavorite ?? openableDocuments[0];
-      if (!target) return;
-      navigate(`/page/${target.id}`, { replace: true });
+  const openLanding = useCallback(async () => {
+    if (startedRef.current) return;
+    startedRef.current = true;
+    try {
+      const result = await resolveLanding.mutateAsync({});
+      if (result.fallbackReason === "saved-document-unavailable") {
+        toast.info(t("landing.previousPageUnavailable"));
+      }
+      navigate(`/page/${result.documentId}`, { replace: true });
+    } catch (error) {
+      // Keep the typed mutation error available to QueryErrorState. Retrying
+      // starts a fresh resolver attempt rather than pretending arrival worked.
+      console.error("Failed to resolve the Content landing page", error);
     }
-  }, [documents, navigate]);
+  }, [navigate, resolveLanding, t]);
 
-  // While loading, or when we have documents but haven't navigated yet,
-  // show a skeleton instead of the "no page selected" empty state.
-  const showSkeleton = isLoading || (documents && documents.length > 0);
+  useEffect(() => {
+    void openLanding();
+  }, [openLanding]);
 
-  if (showSkeleton) return <DocumentSkeleton />;
-  if (documentsQuery.isError) {
+  if (resolveLanding.isError) {
     return (
       <QueryErrorState
-        onRetry={() => void documentsQuery.refetch()}
-        retrying={documentsQuery.isFetching}
+        onRetry={() => {
+          resolveLanding.reset();
+          startedRef.current = false;
+          void openLanding();
+        }}
+        retrying={resolveLanding.isPending}
       />
     );
   }
-  return <EmptyState />;
+  return <DocumentSkeleton />;
 }

package/corpus/templates/content/changelog/2026-08-03-choose-text-or-a-heading-from-one-compact-formatting-control.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-03
+---
+
+Choose Text or a heading from one compact formatting control.

package/corpus/templates/content/changelog/2026-08-11-browser-no-longer-offers-desktop-install.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+Chrome no longer offers to install Content as a desktop app.

package/corpus/templates/content/changelog/2026-08-11-content-opens-your-last-page-on-return-and-gives-new-users-a.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+Content opens your last page on return and gives new users a private welcome page.

package/corpus/templates/content/docs/product/capabilities/content.workspace.session-restore.md

@@ -42,6 +42,8 @@ If the Page was deleted or access changed, Content opens a safe fallback and exp
 - Restoration reauthorizes every target before reopening it and drops invalid state safely.
 - Saved or personal View focus restores when still authorized; ephemeral renderer state is bounded.
 - Recovery distinguishes normal restoration, missing target, denied target, and unavailable source.
+- At the root route, Content restores the last authorized Page. When no saved Page exists or the target is no longer available, it creates or reuses one private, editable Personal `Welcome to Agent-Native Content` Page.
+- Explicit Page links take precedence over root-route restoration. A fallback does not reveal the unavailable Page's title, preview, or owning context.
 
 ## Boundaries and non-goals
 
@@ -60,6 +62,10 @@ Content reopens that object and View with a usable focus target.
 Given saved state for an object whose access is revoked, when the session restores, then
 Content omits the object and does not reveal its title, preview, or prior selection.
 
+### Give a new person an honest starting place
+
+Given a person with no saved Content location but with organization-visible Pages, when they open the root route, then Content opens one private Personal welcome Page instead of selecting an arbitrary organization Page.
+
 ## Current evidence
 
 Persisted navigation donors do not prove reauthorization, fallback, and recovery. This
@@ -73,4 +79,4 @@ Capability remains `approved_shape`.
 
 ## Open questions
 
-The exact safe fallback order needs interaction design.
+The first Page-level fallback order is settled. Full saved View, selection, and renderer-state restoration remains to be designed and proven.

package/corpus/templates/content/docs/solutions/evidence/content-text-selector/README.md

@@ -0,0 +1,26 @@
+# Content text selector visual evidence
+
+Matched desktop captures for the compact Text/H1-H4 selector in the Content editor.
+
+## Before
+
+- Source revision: `dcc028cb7d67a0f9279f9235cdc4c16710ce5689`
+- Route: `http://127.0.0.1:3317/page/j4a5KAEDBHXY`
+- Viewport: `1496 x 846`, desktop Chrome
+- Fixture account: disposable local account `toolbar-demo@example.com`
+- Fixture page: `Toolbar comparison`
+- Fixture paragraph: `Select this sentence to compare the formatting toolbar.`
+- UI state: Personal workspace expanded, agent panel closed, full paragraph selected, formatting bubble open, text-style submenu closed
+
+![Before: separate H1-H4 toolbar buttons](./before.png)
+
+## After
+
+- Source: this pull request's production build
+- Route: `http://127.0.0.1:3317/page/vDisteHisXMq`
+- Viewport: `1496 x 846`, desktop Chrome
+- Fixture account, page title, paragraph, sidebar state, and agent-panel state match the before capture
+- UI state: full paragraph selected, formatting bubble open, Text selector expanded, Text checked, H1-H4 visible
+- The route differs because the isolated worktree uses its own disposable local fixture database; the rendered fixture and viewport are matched
+
+![After: compact Text selector with H1-H4 menu](./after.png)

package/corpus/templates/content/parity/matrix.md

@@ -30,4 +30,5 @@ This generated matrix tracks whether high-value Content UI operations use the sa
 | source-sync.database-source-bindings               | source-sync | Attach, inspect, refresh, disconnect, join, and bind database sources                                     | action-backed         | `add-content-database-source-field-property`, `attach-content-database-source`, `bind-content-database-source-field`, `change-content-database-source-role`, `disconnect-content-database-source`, `get-content-database-source`, `list-builder-cms-models`, `list-notion-database-sources`, `preview-content-database-source-attach`, `refresh-content-database-source`, `suggest-source-join-key`         | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/DocumentProperties.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`      | Mounted database source metadata, fields, source role, join keys, and source-field/property bindings are stored and refreshed.                                                                                                                                                            | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/bind-content-database-source-field.db.test.ts`, `actions/content-database-source-actions.test.ts`, `actions/resync-content-database-source.db.test.ts`                                                         | `database-source-scope`          | -                              |
 | source-sync.provider-api-and-staged-datasets       | source-sync | Inspect provider APIs and stage/query/delete large provider datasets                                      | action-backed         | `delete-staged-dataset`, `list-staged-datasets`, `provider-api-catalog`, `provider-api-docs`, `provider-api-request`, `query-staged-dataset`                                                                                                                                                                                                                                                                | `actions/provider-api-catalog.ts`, `actions/provider-api-docs.ts`, `actions/provider-api-request.ts`, `actions/query-staged-dataset.ts`                                                   | Provider API metadata and staged dataset scratch storage support scoped agent/source analysis.                                                                                                                                                                                            | -                                                                                                                                                                                                                                          | -                | P1             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
 | versions.history-and-restore                       | versions    | Open version history and restore a previous document version                                              | action-backed         | `list-document-versions`, `restore-document-version`                                                                                                                                                                                                                                                                                                                                                        | `app/components/editor/VersionHistoryPanel.tsx`, `app/hooks/use-document-versions.ts`                                                                                                     | Document versions are listed and selected versions can restore the document while snapshotting current state.                                                                                                                                                                             | -                                                                                                                                                                                                                                          | -                | P0             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
+| workspace.root-landing-resolver                    | workspace   | Resolve the app root to the caller's last authorized page or a private welcome page                       | action-backed         | `resolve-content-landing`                                                                                                                                                                                                                                                                                                                                                                                   | `app/routes/_app._index.tsx`, `app/lib/content-landing.ts`                                                                                                                                | The root route restores the most recent authorized page when possible and otherwise converges on one private personal welcome page while preserving last-location state.                                                                                                                  | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/resolve-content-landing.db.test.ts`, `app/lib/content-landing.test.ts`                                                                                                                                         | -                                | -                              |
 | workspace.spaces-and-files-catalog                 | workspace   | Provision, navigate, and delete Content spaces through Files and Workspaces with personal expansion state | action-backed         | `backfill-content-files`, `create-content-space`, `delete-content-space`, `ensure-content-spaces`, `get-content-sidebar-state`, `list-content-spaces`, `update-content-sidebar-state`                                                                                                                                                                                                                       | `app/components/sidebar/DocumentSidebar.tsx`, `app/hooks/use-content-spaces.ts`                                                                                                           | Personal and organization spaces, user-created workspaces, their canonical Files databases, the personal Workspaces catalog, and each user's sidebar expansion state are stored and reconciled in SQL; deleting a user-created workspace atomically removes its catalog row and contents. | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-spaces.db.test.ts`, `actions/content-files.db.test.ts`, `actions/content-sidebar-state.test.ts`                                                                                                        | -                                | -                              |

package/corpus/templates/content/parity/matrix.ts

@@ -95,6 +95,28 @@ export const parityMatrix: ParityRow[] = [
     testCoverage: "seeded",
     followUpPR: null,
   },
+  {
+    id: "workspace.root-landing-resolver",
+    surface: "workspace",
+    label:
+      "Resolve the app root to the caller's last authorized page or a private welcome page",
+    uiEntrypoints: ["app/routes/_app._index.tsx", "app/lib/content-landing.ts"],
+    durableEffect:
+      "The root route restores the most recent authorized page when possible and otherwise converges on one private personal welcome page while preserving last-location state.",
+    uiImplementation:
+      "The index route invokes the shared landing resolver on first load, then navigates to the resolved page and records the landing document in application state.",
+    status: "action-backed",
+    actions: ["resolve-content-landing"],
+    exception: null,
+    reliabilityRisk: "none",
+    spinePriority: "P0",
+    testCoverage: "covered",
+    followUpPR: null,
+    coverageRefs: [
+      "actions/resolve-content-landing.db.test.ts",
+      "app/lib/content-landing.test.ts",
+    ],
+  },
   {
     id: "sidebar.chrome-state",
     surface: "sidebar",

package/corpus/templates/content/public/manifest.json

@@ -3,7 +3,6 @@
   "short_name": "Content",
   "description": "Open-source Obsidian for MDX",
   "start_url": ".",
-  "display": "standalone",
   "background_color": "#111111",
   "theme_color": "#10B981",
   "icons": [

package/corpus/templates/content/shared/content-landing.ts

@@ -0,0 +1,17 @@
+export const CONTENT_LAST_LOCATION_STATE_KEY = "content-last-location-v1";
+
+export type ContentLastLocationState = {
+  documentId: string;
+};
+
+export type ContentLandingResolution =
+  | "restored"
+  | "welcome-created"
+  | "welcome-reused"
+  | "fallback";
+
+export type ContentLandingResult = {
+  documentId: string;
+  resolution: ContentLandingResolution;
+  fallbackReason?: "saved-document-unavailable";
+};