@jant/core 0.6.11 → 0.6.13

package/src/services/export-theme/layouts/_default/rss.xml

@@ -10,7 +10,7 @@
     - featured (`.Type == "featured"`): featured_at != nil
     - archive  (`.Type == "archive"`): all published (includes latest_hidden)
     - collection (`.Type == "collection"`): Params.collections.slug match,
-        pinned first then per `sort_order`
+        ordered per `sort_order`; pinning is ignored for RSS
 
   Per-entry payload mirrors `buildSinglePostContent` + `buildFeedContent`:
     - Title: empty for quote posts, else .Title
@@ -23,7 +23,8 @@
         body    → Hugo-rendered .Content (stripped of <script>/<style>)
         rating  → <p>★★★★☆ 4/5</p>
         link    → trailing <p><a href=permalink> ★ </a></p>
-        replies → <hr/> + <p><small><time>{dt}</time></small></p> + content
+        replies → <hr/> + <p><small><time>{dt}</time></small></p>
+                  + inline title/link metadata + content
 
   Hugo's default RSS media-type override (`[outputFormats.RSS]`) makes this
   template produce application/atom+xml at /{section}/index.xml.
@@ -59,25 +60,15 @@
       {{- end -}}
     {{- end -}}
   {{- end -}}
-  {{- $pinned := slice -}}
-  {{- $unpinned := slice -}}
-  {{- range $members -}}
-    {{- if .entry.pinned_at -}}
-      {{- $pinned = $pinned | append . -}}
-    {{- else -}}
-      {{- $unpinned = $unpinned | append . -}}
-    {{- end -}}
-  {{- end -}}
-  {{- if $pinned -}}{{- $pinned = sort $pinned "entry.pinned_at" "desc" -}}{{- end -}}
   {{- $sortOrder := $page.Params.sort_order | default "position" -}}
-  {{- if $unpinned -}}
+  {{- $ordered := $members -}}
+  {{- if $ordered -}}
     {{- if eq $sortOrder "collected_at_desc" -}}
-      {{- $unpinned = sort $unpinned "entry.collected_at" "desc" -}}
+      {{- $ordered = sort $ordered "entry.collected_at" "desc" -}}
     {{- else -}}
-      {{- $unpinned = sort $unpinned "entry.position" "asc" -}}
+      {{- $ordered = sort $ordered "entry.position" "asc" -}}
     {{- end -}}
   {{- end -}}
-  {{- $ordered := $pinned | append $unpinned -}}
   {{- range $ordered -}}{{- $posts = $posts | append .post -}}{{- end -}}
 {{- end -}}
 

package/src/services/export-theme/layouts/index.html

@@ -1,41 +1,28 @@
-{{ define "main" }}
-  {{- $homeDefaultView := .Site.Params.home_default_view | default "latest" -}}
-  {{- $pageSize := .Site.Params.page_size | default 10 -}}
-  {{- /* Root posts are branch bundles (kind=section), so we iterate .Site.Pages, not .Site.RegularPages. */ -}}
-  {{- $allPosts := where .Site.Pages "Type" "post" -}}
-  {{- $pinned := where $allPosts "Params.pinned_at" "ne" nil -}}
-  {{- $pinned = $pinned.ByDate.Reverse -}}
-  {{- $main := slice -}}
-  {{- if eq $homeDefaultView "featured" -}}
-    {{- $featured := where $allPosts "Params.featured_at" "ne" nil -}}
-    {{- $main = sort $featured "Params.featured_at" "desc" -}}
-  {{- else -}}
-    {{- $public := where $allPosts "Params.visibility" "public" -}}
-    {{- $public = where $public "Params.pinned_at" nil -}}
-    {{- $main = $public.ByDate.Reverse -}}
-  {{- end -}}
-  {{- $paginator := .Paginate $main $pageSize -}}
-
-  <section class="home">
-    {{- if and (eq $paginator.PageNumber 1) $pinned -}}
-      <div class="post-list post-list-pinned" aria-label="Pinned posts">
-        {{- range $i, $p := $pinned -}}
-          {{- if gt $i 0 -}}<hr class="feed-divider" aria-hidden="true" />{{- end -}}
-          {{ partial "thread-preview.html" $p }}
-        {{- end -}}
-      </div>
-    {{- end -}}
+{{ define "main" }} {{- $pageSize := .Site.Params.page_size | default 10 -}} {{-
+/* Root posts are branch bundles (kind=section), so we iterate .Site.Pages, not
+.Site.RegularPages. */ -}} {{- $allPosts := where .Site.Pages "Type" "post" -}}
+{{- $pinned := where $allPosts "Params.pinned_at" "ne" nil -}} {{- $pinned =
+$pinned.ByDate.Reverse -}} {{- $public := where $allPosts "Params.visibility"
+"public" -}} {{- $public = where $public "Params.pinned_at" nil -}} {{- $main :=
+$public.ByDate.Reverse -}} {{- $paginator := .Paginate $main $pageSize -}}
 
-    {{- if $paginator.Pages -}}
-      <div class="post-list post-list-main">
-        {{- range $i, $p := $paginator.Pages -}}
-          {{- if gt $i 0 -}}<hr class="feed-divider" aria-hidden="true" />{{- end -}}
-          {{ partial "thread-preview.html" $p }}
-        {{- end -}}
-      </div>
-      {{ partial "pagination.html" $paginator }}
-    {{- else if not $pinned -}}
-      <p class="empty-state">Nothing published yet. Write your first post to get started.</p>
-    {{- end -}}
-  </section>
+<section class="home">
+  {{- if and (eq $paginator.PageNumber 1) $pinned -}}
+  <div class="post-list post-list-pinned" aria-label="Pinned posts">
+    {{- range $i, $p := $pinned -}} {{- if gt $i 0 -}}
+    <hr class="feed-divider" aria-hidden="true" />
+    {{- end -}} {{ partial "thread-preview.html" $p }} {{- end -}}
+  </div>
+  {{- end -}} {{- if $paginator.Pages -}}
+  <div class="post-list post-list-main">
+    {{- range $i, $p := $paginator.Pages -}} {{- if gt $i 0 -}}
+    <hr class="feed-divider" aria-hidden="true" />
+    {{- end -}} {{ partial "thread-preview.html" $p }} {{- end -}}
+  </div>
+  {{ partial "pagination.html" $paginator }} {{- else if not $pinned -}}
+  <p class="empty-state">
+    Nothing published yet. Write your first post to get started.
+  </p>
+  {{- end -}}
+</section>
 {{ end }}

package/src/services/export-theme/layouts/partials/feed-post-content.xml

@@ -8,6 +8,8 @@
                      link-format "★" suffix)
     includeReplies — when true, appends each public reply separated by
                      <hr/> + <small><time></time></small>
+    inline         — when true, renders title/link metadata that top-level
+                     Atom entries expose through their entry fields
 
   Output is raw HTML suitable for embedding inside Atom
   <content type="html"><![CDATA[...]]></content>. Since CDATA ends at the
@@ -18,9 +20,31 @@
 {{- $post := .post -}}
 {{- $permalink := .permalink -}}
 {{- $includeReplies := .includeReplies -}}
+{{- $inline := false -}}
+{{- with .inline -}}{{- $inline = . -}}{{- end -}}
 {{- $format := $post.Params.format | default "note" -}}
 {{- $parts := slice -}}
 
+{{- /* --- Inline title/link metadata for thread replies --- */ -}}
+{{- if and $inline (ne $format "quote") -}}
+  {{- $title := $post.Title | default "" -}}
+  {{- $linkUrl := string ($post.Params.link_url | default "") -}}
+  {{- if eq $format "link" -}}
+    {{- if ne $linkUrl "" -}}
+      {{- $domain := $linkUrl -}}
+      {{- with urls.Parse $linkUrl -}}{{- if .Host -}}{{- $domain = replaceRE `^(www|m|mobile)\.` "" .Host -}}{{- end -}}{{- end -}}
+      {{- $parts = $parts | append (printf `<p><a href=%q>%s</a></p>` $linkUrl (transform.XMLEscape $domain)) -}}
+    {{- end -}}
+    {{- if ne $title "" -}}
+      {{- $titleHref := $permalink -}}
+      {{- if ne $linkUrl "" -}}{{- $titleHref = $linkUrl -}}{{- end -}}
+      {{- $parts = $parts | append (printf `<h2><a href=%q>%s</a></h2>` $titleHref (transform.XMLEscape $title)) -}}
+    {{- end -}}
+  {{- else if ne $title "" -}}
+    {{- $parts = $parts | append (printf `<h2><a href=%q>%s</a></h2>` $permalink (transform.XMLEscape $title)) -}}
+  {{- end -}}
+{{- end -}}
+
 {{- /* --- Quote block (format=quote) --- */ -}}
 {{- if eq $format "quote" -}}
   {{- $quoteText := string ($post.Params.quote_text | default "") -}}
@@ -100,7 +124,7 @@
     {{- $replyLabel := .Date.Format "Jan 2, 2006 15:04" -}}
     {{- $parts = $parts | append "<hr/>" -}}
     {{- $parts = $parts | append (printf `<p><small><time datetime=%q>%s</time></small></p>` $replyDatetime (transform.XMLEscape $replyLabel)) -}}
-    {{- $parts = $parts | append (partial "feed-post-content.xml" (dict "post" . "permalink" $replyPermalink "includeReplies" false)) -}}
+    {{- $parts = $parts | append (partial "feed-post-content.xml" (dict "post" . "permalink" $replyPermalink "includeReplies" false "inline" true)) -}}
   {{- end -}}
 {{- end -}}
 

package/src/services/export-theme/styles/main.css

@@ -84,13 +84,11 @@ h1 {
 
 h2 {
   font-size: var(--type-content-title);
-  font-style: italic;
   margin: 2.1rem 0 1.4rem;
 }
 
 h3 {
   font-size: var(--type-content-subtitle);
-  font-style: italic;
   margin: 2rem 0 1.4rem;
 }
 
@@ -119,6 +117,12 @@ kbd,
 samp {
   font-family: var(--font-mono);
   font-size: var(--type-code);
+  line-height: 1.42;
+}
+
+code {
+  color: var(--site-code-text);
+  overflow-wrap: break-word;
 }
 
 pre {
@@ -127,23 +131,26 @@ pre {
   line-height: 1.5;
   padding: 1rem;
   overflow-x: auto;
-  background-color: var(--site-feed-card-bg);
-  border: 1px solid var(--site-feed-card-border);
-  border-radius: 0.375rem;
+  color: var(--site-code-text);
+  background-color: var(--site-code-block-bg);
+  border: 1px solid var(--site-code-block-border);
+  border-radius: 6px;
 }
 
 pre code {
   padding: 0;
   background: transparent;
   border: 0;
+  color: inherit;
   font-size: inherit;
 }
 
 :not(pre) > code {
-  padding: 0.1em 0.35em;
-  background-color: var(--site-feed-card-bg);
-  border: 1px solid var(--site-feed-card-border);
-  border-radius: 0.25rem;
+  padding: 0.08em 0.28em;
+  background-color: var(--site-code-bg);
+  border-radius: 0.22em;
+  box-decoration-break: clone;
+  -webkit-box-decoration-break: clone;
 }
 
 /* Blockquotes — tinted background card with quote icon (matches main site). */
@@ -217,13 +224,13 @@ blockquote cite {
 
 ul,
 ol {
-  padding-left: 1.625em;
+  padding-left: 1.4em;
   margin: 1.25em 0;
 }
 
 li {
-  margin-top: 1.2em;
-  margin-bottom: 1.2em;
+  margin-top: 0.65em;
+  margin-bottom: 0.65em;
 }
 
 /* Normalize li > p so list spacing is controlled by li alone,
@@ -850,6 +857,31 @@ hr.feed-divider {
   color: var(--site-reading-body);
 }
 
+.post-card > .post-card-summary :is(h1, h2),
+.post-card > .post-card-quote-commentary :is(h1, h2) {
+  font-size: calc(var(--type-content-body) * 1.12);
+  font-weight: var(--fw-medium);
+  margin-top: 1.45rem;
+  margin-bottom: 0.55rem;
+}
+
+.post-card > .post-card-summary :is(h3, h4),
+.post-card > .post-card-quote-commentary :is(h3, h4) {
+  font-size: var(--type-content-body);
+  font-weight: var(--fw-medium);
+  margin-top: 1.2rem;
+  margin-bottom: 0.45rem;
+}
+
+.post-card > .post-card-summary :is(h5, h6),
+.post-card > .post-card-quote-commentary :is(h5, h6) {
+  font-size: var(--type-secondary);
+  font-weight: var(--fw-medium);
+  color: var(--site-text-secondary);
+  margin-top: 1rem;
+  margin-bottom: 0.35rem;
+}
+
 /* Link card domain row — shown ABOVE the title (matches main site's
    `.feed-link-domain` pattern). Inline flex with icon + host text. */
 .post-card-link-domain,
@@ -1009,8 +1041,8 @@ hr.feed-divider {
 .post-card-quote-content {
   font-family: var(--font-serif);
   color: var(--site-text-primary);
-  font-size: var(--type-content-subtitle);
-  line-height: var(--type-heading-leading);
+  font-size: var(--type-content-quote);
+  line-height: var(--type-content-quote-leading);
   white-space: pre-line;
   text-wrap: pretty;
   margin: 0;

package/src/services/export.ts

@@ -102,7 +102,6 @@ export interface SiteConfig {
   siteDescription: string;
   siteLanguage: string;
   showJantBrandingOnHome: boolean;
-  homeDefaultView: string;
   /** "latest" or "featured" — drives the default RSS nav link in the exported site. */
   mainRssFeed: string;
   siteFooter: string;
@@ -1374,9 +1373,8 @@ function resolveNavItemLabel(item: SiteConfig["navItems"][number]): string {
  * Resolve a nav item's final href for the Hugo export.
  *
  * Mirrors the runtime logic in `lib/view.ts:toNavItemView`. System URLs
- * stored in the DB ("/latest", "/featured") are not real routes — they get
- * rewritten to "/" when they match `homeDefaultView`, otherwise they
- * resolve to the dedicated path.
+ * stored in the DB are canonicalized during export so stale DB values do not
+ * leak into the static site's navigation.
  *
  * The "rss" system nav item points at whichever Atom feed the site has
  * configured as its main feed: `mainRssFeed === "featured"` → the featured
@@ -1385,14 +1383,13 @@ function resolveNavItemLabel(item: SiteConfig["navItems"][number]): string {
  */
 function resolveNavItemUrl(
   item: SiteConfig["navItems"][number],
-  homeDefaultView: string,
   mainRssFeed: string,
 ): string {
   if (item.systemKey === "latest") {
-    return homeDefaultView === "latest" ? "/" : "/latest/";
+    return "/";
   }
   if (item.systemKey === "featured") {
-    return homeDefaultView === "featured" ? "/" : "/featured/";
+    return "/featured/";
   }
   if (item.systemKey === "collections") return "/collections/";
   if (item.systemKey === "archive") return "/archive/";
@@ -1474,7 +1471,6 @@ function buildHugoToml(config: SiteConfig): string {
     "",
     "[params]",
     `  description = "${escapeTomlString(config.siteDescription)}"`,
-    `  home_default_view = "${escapeTomlString(config.homeDefaultView)}"`,
     `  main_rss_feed = "${escapeTomlString(config.mainRssFeed)}"`,
     `  show_jant_branding_on_home = ${config.showJantBrandingOnHome}`,
     `  show_header_avatar = ${config.showHeaderAvatar}`,
@@ -1514,7 +1510,6 @@ function buildJantDataToml(
     `site_name = "${escapeTomlString(config.siteName)}"`,
     `site_description = "${escapeTomlString(config.siteDescription)}"`,
     `site_language = "${escapeTomlString(config.siteLanguage)}"`,
-    `home_default_view = "${escapeTomlString(config.homeDefaultView)}"`,
     `main_rss_feed = "${escapeTomlString(config.mainRssFeed)}"`,
     `show_jant_branding_on_home = ${config.showJantBrandingOnHome}`,
     `show_header_avatar = ${config.showHeaderAvatar}`,
@@ -1558,7 +1553,7 @@ function buildJantDataToml(
     parts.push(`type = "${escapeTomlString(item.type)}"`);
     parts.push(`label = "${escapeTomlString(resolveNavItemLabel(item))}"`);
     parts.push(
-      `url = "${escapeTomlString(resolveNavItemUrl(item, config.homeDefaultView, config.mainRssFeed))}"`,
+      `url = "${escapeTomlString(resolveNavItemUrl(item, config.mainRssFeed))}"`,
     );
     parts.push(`system_key = "${escapeTomlString(item.systemKey ?? "")}"`);
     parts.push(`placement = "${escapeTomlString(item.placement ?? "header")}"`);

package/src/services/github-app-installations.ts

@@ -149,9 +149,7 @@ export function createGitHubAppInstallationsService(
         .select()
         .from(githubAppInstallation)
         .where(eq(githubAppInstallation.siteId, siteId));
-      return rows
-        .map(toStored)
-        .sort((a, b) => b.addedAt - a.addedAt);
+      return rows.map(toStored).sort((a, b) => b.addedAt - a.addedAt);
     },
 
     async listSitesForInstallation(installationId) {

package/src/services/index.ts

@@ -35,6 +35,7 @@ import {
   createSiteProfileService,
   type SiteProfileService,
 } from "./site-profile.js";
+import { createAboutPageService, type AboutPageService } from "./about-page.js";
 import {
   createUploadSessionService,
   type UploadSessionService,
@@ -64,6 +65,7 @@ export interface Services {
   siteAdmin: SiteAdminService;
   siteMembers: SiteMemberService;
   siteProfile: SiteProfileService;
+  aboutPage: AboutPageService;
   githubAppInstallations: GitHubAppInstallationsService;
   telegram: TelegramService;
 }
@@ -88,6 +90,23 @@ export function createServices(
   const settings = createSettingsService(db, siteId, databaseSchema, dialect);
   const paths = createPathService(db, siteId, databaseSchema);
   const navItems = createNavItemService(db, siteId, databaseSchema);
+  const posts = createPostService(
+    db,
+    {
+      slugIdLength: config?.slugIdLength ?? 5,
+      databaseDialect: dialect,
+    },
+    siteId,
+    paths,
+    databaseSchema,
+  );
+  const collections = createCollectionService(
+    db,
+    siteId,
+    paths,
+    databaseSchema,
+    dialect,
+  );
   const media = createMediaService(db, siteId, databaseSchema, dialect, {
     enforceHostedQuota: config?.enforceHostedMediaQuota ?? false,
     hostedControlPlane: config?.hostedControlPlane ?? null,
@@ -97,26 +116,11 @@ export function createServices(
     settings,
     site,
     paths,
-    posts: createPostService(
-      db,
-      {
-        slugIdLength: config?.slugIdLength ?? 5,
-        databaseDialect: dialect,
-      },
-      siteId,
-      paths,
-      databaseSchema,
-    ),
+    posts,
     customUrls: createCustomUrlService(db, siteId, paths, databaseSchema),
     media,
     uploads: createUploadSessionService(db, siteId, media, databaseSchema),
-    collections: createCollectionService(
-      db,
-      siteId,
-      paths,
-      databaseSchema,
-      dialect,
-    ),
+    collections,
     search: createSearchService(rawQuery, siteId, dialect),
     navItems,
     auth: createAuthService(
@@ -148,6 +152,11 @@ export function createServices(
         );
       },
     }),
+    aboutPage: createAboutPageService({
+      paths,
+      posts,
+      collections,
+    }),
     githubAppInstallations: createGitHubAppInstallationsService(
       db,
       databaseSchema,
@@ -166,6 +175,7 @@ export type { UploadSessionService } from "./upload-session.js";
 export type { CollectionService } from "./collection.js";
 export type { SearchService, SearchResult, SearchOptions } from "./search.js";
 export type { NavItemService } from "./navigation.js";
+export type { AboutPageService, AboutPageStatus } from "./about-page.js";
 export type { AuthService, DeleteAccountDeps } from "./auth.js";
 export type { ApiTokenService } from "./api-token.js";
 export type {

package/src/services/navigation.ts

@@ -15,6 +15,12 @@ import {
 import { createEntityId } from "../lib/ids.js";
 import { ValidationError } from "../lib/errors.js";
 import { now } from "../lib/time.js";
+import {
+  normalizePath,
+  normalizeSitePathPrefix,
+  stripSitePathPrefix,
+  toSameSitePath,
+} from "../lib/url.js";
 import { COLLECTION_FRESHNESS_WINDOW_SECONDS } from "../types.js";
 import type {
   NavItem,
@@ -23,10 +29,20 @@ import type {
   CreateNavItem,
   UpdateNavItem,
   SystemNavKey,
+  SuggestedNavLink,
 } from "../types.js";
 import { SYSTEM_NAV_KEYS } from "../types.js";
 
 const POSITION_RETRY_ATTEMPTS = 5;
+const SUGGESTED_NAV_LINK_CANDIDATES = [
+  { key: "about", path: "/about", label: "About" },
+  { key: "now", path: "/now", label: "Now" },
+] as const;
+
+export interface ListSuggestedLinksOptions {
+  siteOrigin?: string;
+  sitePathPrefix?: string;
+}
 
 // Re-export shared constraint detection — see db/dialect.ts
 import { isUniqueConstraintError } from "../db/dialect.js";
@@ -45,6 +61,9 @@ export interface NavItemService {
     afterId: string | null,
     beforeId: string | null,
   ): Promise<NavItem | null>;
+  listSuggestedLinks(
+    options?: ListSuggestedLinksOptions,
+  ): Promise<SuggestedNavLink[]>;
   getCollectionFreshness(collectionIds: string[]): Promise<Map<string, number>>;
 }
 
@@ -53,7 +72,8 @@ export function createNavItemService(
   siteId: string,
   databaseSchema: DatabaseSchema = sqliteSchemaBundle,
 ): NavItemService {
-  const { navItems, postCollections, posts } = databaseSchema;
+  const { navItems, postCollections, posts, pathRegistry, collections } =
+    databaseSchema;
 
   const defaultSystemOrder = [
     "latest",
@@ -121,6 +141,58 @@ export function createNavItemService(
     };
   }
 
+  function withLeadingSlash(path: string): string {
+    const normalized = normalizePath(path);
+    return normalized ? `/${normalized}` : "/";
+  }
+
+  function getComparableInternalPath(
+    url: string,
+    options: ListSuggestedLinksOptions = {},
+  ): string | null {
+    const value = url.trim();
+    const sitePathPrefix = normalizeSitePathPrefix(
+      options.sitePathPrefix ?? "",
+    );
+    const sameSitePath = toSameSitePath(value, options.siteOrigin ?? "");
+    if (sameSitePath !== null) {
+      try {
+        const pathname = new URL(sameSitePath, "https://jant.invalid").pathname;
+        const internalPath = stripSitePathPrefix(pathname, sitePathPrefix);
+        return internalPath ? withLeadingSlash(internalPath) : null;
+      } catch {
+        return null;
+      }
+    }
+
+    if (
+      value.startsWith("http://") ||
+      value.startsWith("https://") ||
+      value.startsWith("//") ||
+      value.startsWith("mailto:") ||
+      value.startsWith("tel:") ||
+      value.startsWith("#")
+    ) {
+      return null;
+    }
+
+    try {
+      const pathname = new URL(value, "https://jant.invalid").pathname;
+      const internalPath = stripSitePathPrefix(pathname, sitePathPrefix);
+      return internalPath ? withLeadingSlash(internalPath) : null;
+    } catch {
+      return null;
+    }
+  }
+
+  function normalizeSuggestedLabel(
+    label: string | null | undefined,
+    fallback: string,
+  ): string {
+    const trimmed = label?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed : fallback;
+  }
+
   async function getLastPosition(): Promise<string | null> {
     const rows = await db
       .select({ position: navItems.position })
@@ -414,6 +486,119 @@ export function createNavItemService(
       throw new Error("Failed to assign a unique nav item position");
     },
 
+    async listSuggestedLinks(options: ListSuggestedLinksOptions = {}) {
+      const existingRows = await db
+        .select({
+          url: navItems.url,
+          collectionId: navItems.collectionId,
+        })
+        .from(navItems)
+        .where(eq(navItems.siteId, siteId));
+      const existingPaths = new Set(
+        existingRows.flatMap((item) => {
+          const path = getComparableInternalPath(item.url, options);
+          return path ? [path] : [];
+        }),
+      );
+      const existingCollectionIds = new Set(
+        existingRows.flatMap((item) =>
+          item.collectionId ? [item.collectionId] : [],
+        ),
+      );
+
+      const suggestions: SuggestedNavLink[] = [];
+
+      for (const candidate of SUGGESTED_NAV_LINK_CANDIDATES) {
+        const path = withLeadingSlash(candidate.path);
+        if (existingPaths.has(path)) continue;
+
+        const pathRows = await db
+          .select()
+          .from(pathRegistry)
+          .where(
+            and(
+              eq(pathRegistry.siteId, siteId),
+              eq(pathRegistry.path, normalizePath(candidate.path)),
+            ),
+          )
+          .limit(1);
+        const record = pathRows[0];
+        if (!record || record.kind === "redirect") continue;
+
+        if (record.postId) {
+          const postRows = await db
+            .select({
+              title: posts.title,
+              status: posts.status,
+              visibility: posts.visibility,
+            })
+            .from(posts)
+            .where(and(eq(posts.siteId, siteId), eq(posts.id, record.postId)))
+            .limit(1);
+          const post = postRows[0];
+          if (
+            !post ||
+            post.status !== "published" ||
+            post.visibility === "private"
+          ) {
+            continue;
+          }
+
+          suggestions.push({
+            key: candidate.key,
+            label: normalizeSuggestedLabel(post.title, candidate.label),
+            url: path,
+            targetType: "page",
+            navItemType: "link",
+          });
+          continue;
+        }
+
+        if (record.collectionId) {
+          if (existingCollectionIds.has(record.collectionId)) continue;
+
+          const collectionRows = await db
+            .select({
+              title: collections.title,
+            })
+            .from(collections)
+            .where(
+              and(
+                eq(collections.siteId, siteId),
+                eq(collections.id, record.collectionId),
+              ),
+            )
+            .limit(1);
+          const collection = collectionRows[0];
+          if (!collection) continue;
+
+          suggestions.push({
+            key: candidate.key,
+            label: normalizeSuggestedLabel(collection.title, candidate.label),
+            url: path,
+            targetType: "collection",
+            navItemType: record.kind === "slug" ? "collection" : "link",
+            ...(record.kind === "slug" && {
+              collectionId: record.collectionId,
+            }),
+          });
+          continue;
+        }
+
+        if (record.kind === "archive") {
+          suggestions.push({
+            key: candidate.key,
+            label: candidate.label,
+            url: path,
+            targetType: "archive",
+            navItemType: "link",
+          });
+        }
+      }
+
+      return suggestions;
+    },
+
     async getCollectionFreshness(collectionIds) {
       if (collectionIds.length === 0) return new Map<string, number>();