fix(landing): derive platform support from release assets

landing/app/layout.tsx

@@ -1,6 +1,7 @@
 import type { Metadata } from "next";
 import "./globals.css";
 import { ThemeProvider } from "../components/theme-provider";
+import { platformSupportSummary } from "../lib/platform-support";
 
 const description =
   "Local-first desktop control plane for autonomous AI companies. Set a goal, let an AI CEO assemble specialists, delegate work, and deliver code, research, content, and operations from your desktop.";
@@ -143,7 +144,7 @@ const faqJsonLd = {
       name: "How do I download AgentCompany?",
       acceptedAnswer: {
         "@type": "Answer",
-        text: "Use the download section on the website to choose the installer for your platform. macOS ships as a signed and notarized DMG. Windows and Linux builds are distributed directly from our Cloudflare release host.",
+        text: platformSupportSummary.downloadAnswer,
       },
     },
     {
@@ -151,7 +152,7 @@ const faqJsonLd = {
       name: "What platforms does AgentCompany support?",
       acceptedAnswer: {
         "@type": "Answer",
-        text: "AgentCompany is available on macOS, Windows, and Linux. It is built with Electron and runs natively on all three platforms with full feature parity.",
+        text: platformSupportSummary.platformAnswer,
       },
     },
     {

landing/components/faq.tsx

@@ -2,6 +2,7 @@
 
 import { motion } from "framer-motion";
 import { useState } from "react";
+import { platformSupportSummary } from "../lib/platform-support";
 
 const faqs = [
   {
@@ -11,13 +12,11 @@ const faqs = [
   },
   {
     question: "How do I download AgentCompany?",
-    answer:
-      "Use the download section on this page to choose the build that matches your architecture and package format. macOS ships as signed and notarized DMGs, Windows ships as a universal installer covering ARM64, x64, and x86, and Linux ships as AppImage, DEB, and RPM builds from our Cloudflare release host.",
+    answer: platformSupportSummary.downloadAnswer,
   },
   {
     question: "What platforms does AgentCompany support?",
-    answer:
-      "AgentCompany is available on macOS arm64 and x64, Windows ARM64/x64/x86, and Linux x64 and ARM64. It is built with Electron and the desktop feature set stays aligned across all supported targets.",
+    answer: platformSupportSummary.platformAnswer,
   },
   {
     question: "What AI models can AgentCompany use?",

landing/components/release-links.generated.ts

@@ -1,12 +1,16 @@
 export type PlatformDownloadAsset = {
+  architectures: ReleaseArchitecture[];
   id: string;
   label: string;
   href: string;
   note: string;
 };
 
+export type ReleaseArchitecture = "arm64" | "x64" | "x86";
+
 export type PlatformDownload = {
   id: "macos" | "windows" | "linux";
+  packageDescription: string;
   title: string;
   note: string;
   assets: PlatformDownloadAsset[];
@@ -17,16 +21,19 @@ export const releaseVersion = "0.4.174";
 export const platformDownloads: PlatformDownload[] = [
   {
     id: "macos",
+    packageDescription: "signed and notarized DMG builds",
     title: "macOS",
     note: "Signed + notarized DMG builds",
     assets: [
       {
+        architectures: ["arm64"],
         id: "macos-arm64-dmg",
         label: "Apple Silicon DMG",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/AgentCompany-0.4.174-arm64.dmg",
         note: "arm64",
       },
       {
+        architectures: ["x64"],
         id: "macos-x64-dmg",
         label: "Intel Mac DMG",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/AgentCompany-0.4.174.dmg",
@@ -36,10 +43,12 @@ export const platformDownloads: PlatformDownload[] = [
   },
   {
     id: "windows",
+    packageDescription: "an NSIS installer build",
     title: "Windows",
     note: "NSIS installer builds",
     assets: [
       {
+        architectures: ["arm64", "x64"],
         id: "windows-universal-installer",
         label: "Windows Universal Installer",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/AgentCompany.Setup.0.4.174.exe",
@@ -49,40 +58,47 @@ export const platformDownloads: PlatformDownload[] = [
   },
   {
     id: "linux",
+    packageDescription: "AppImage, DEB, and RPM builds",
     title: "Linux",
     note: "AppImage, DEB, and RPM builds",
     assets: [
       {
+        architectures: ["x64"],
         id: "linux-x64-appimage",
         label: "Linux x64 AppImage",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/AgentCompany-0.4.174.AppImage",
         note: "x64",
       },
       {
+        architectures: ["x64"],
         id: "linux-x64-deb",
         label: "Linux x64 DEB",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/agent-company_0.4.174_amd64.deb",
         note: "x64",
       },
       {
+        architectures: ["x64"],
         id: "linux-x64-rpm",
         label: "Linux x64 RPM",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/agent-company-0.4.174.x86_64.rpm",
         note: "x64",
       },
       {
+        architectures: ["arm64"],
         id: "linux-arm64-appimage",
         label: "Linux ARM64 AppImage",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/AgentCompany-0.4.174-arm64.AppImage",
         note: "arm64",
       },
       {
+        architectures: ["arm64"],
         id: "linux-arm64-deb",
         label: "Linux ARM64 DEB",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/agent-company_0.4.174_arm64.deb",
         note: "arm64",
       },
       {
+        architectures: ["arm64"],
         id: "linux-arm64-rpm",
         label: "Linux ARM64 RPM",
         href: "https://pub-a19a3a2c1d2e4fa3a9c120b184024448.r2.dev/AC/agent-company-0.4.174.aarch64.rpm",

landing/lib/platform-support.ts

@@ -0,0 +1,106 @@
+import {
+  platformDownloads,
+  type PlatformDownload,
+  type PlatformDownloadAsset,
+  type ReleaseArchitecture,
+} from "../components/release-links.generated";
+
+const ARCHITECTURE_ORDER: ReleaseArchitecture[] = ["arm64", "x64", "x86"];
+
+export type PlatformSupportSummary = {
+  downloadAnswer: string;
+  platformAnswer: string;
+};
+
+export const platformSupportSummary = buildPlatformSupportSummary(platformDownloads);
+
+export function buildPlatformSupportSummary(downloads: PlatformDownload[]): PlatformSupportSummary {
+  const macos = requirePlatform(downloads, "macos");
+  const windows = requirePlatform(downloads, "windows");
+  const linux = requirePlatform(downloads, "linux");
+
+  return {
+    downloadAnswer:
+      `Use the download section on this page to choose the build that matches your architecture and package format. ` +
+      `${formatDownloadSentence(macos)} ${formatDownloadSentence(windows)} ${formatDownloadSentence(linux)}`,
+    platformAnswer:
+      `AgentCompany is available on ${formatAvailability(macos)}, ${formatAvailability(windows)}, ` +
+      `and ${formatAvailability(linux)}. It is built with Electron and the desktop feature set stays aligned across all supported targets.`,
+  };
+}
+
+function requirePlatform(downloads: PlatformDownload[], id: PlatformDownload["id"]): PlatformDownload {
+  const platform = downloads.find((download) => download.id === id);
+  if (!platform) {
+    throw new Error(`Missing ${id} release download metadata.`);
+  }
+  return platform;
+}
+
+function formatDownloadSentence(download: PlatformDownload): string {
+  const architectures = formatArchitectureList(collectArchitectures(download));
+
+  if (!download.packageDescription.trim()) {
+    throw new Error(`Release platform ${download.id} must include package format copy.`);
+  }
+
+  return `${download.title} ships as ${download.packageDescription} for ${architectures}.`;
+}
+
+function formatAvailability(download: PlatformDownload): string {
+  return `${download.title} (${formatArchitectureList(collectArchitectures(download), "comma")})`;
+}
+
+function collectArchitectures(download: PlatformDownload): ReleaseArchitecture[] {
+  const architectures = new Set<ReleaseArchitecture>();
+
+  for (const asset of download.assets) {
+    collectAssetArchitectures(download.id, asset).forEach((architecture) => architectures.add(architecture));
+  }
+
+  return [...architectures].sort((left, right) => architectureRank(left) - architectureRank(right));
+}
+
+function collectAssetArchitectures(
+  platformId: PlatformDownload["id"],
+  asset: PlatformDownloadAsset,
+): ReleaseArchitecture[] {
+  if (asset.architectures.length === 0) {
+    throw new Error(`Release asset ${platformId}/${asset.id} must declare at least one architecture.`);
+  }
+
+  for (const architecture of asset.architectures) {
+    if (!isReleaseArchitecture(architecture)) {
+      throw new Error(`Release asset ${platformId}/${asset.id} declares unsupported architecture: ${architecture}`);
+    }
+  }
+
+  return asset.architectures;
+}
+
+function isReleaseArchitecture(value: string): value is ReleaseArchitecture {
+  return ARCHITECTURE_ORDER.includes(value as ReleaseArchitecture);
+}
+
+function architectureRank(architecture: ReleaseArchitecture): number {
+  return ARCHITECTURE_ORDER.indexOf(architecture);
+}
+
+function formatArchitectureList(
+  architectures: ReleaseArchitecture[],
+  style: "and" | "comma" = "and",
+): string {
+  if (architectures.length === 0) {
+    throw new Error("Release download metadata must include at least one architecture.");
+  }
+  if (style === "comma") {
+    return architectures.join(", ");
+  }
+  if (architectures.length === 1) {
+    return architectures[0];
+  }
+  if (architectures.length === 2) {
+    return `${architectures[0]} and ${architectures[1]}`;
+  }
+  return `${architectures.slice(0, -1).join(", ")}, and ${architectures.at(-1)}`;
+}