feat(website): launch professional marketing site

Author: vamgan

README.md

@@ -17,6 +17,7 @@ npm run build
 - `src/index.html` — single-page marketing site.
 - `src/styles.css` — responsive visual system.
 - `src/assets/repo-social-preview.png` — Open Graph and Twitter preview image.
+- `src/assets/org-logo.svg` — brand mark used in the page header and hero.
 - `src/main.js` — progressive enhancements only.
 - `scripts/validate.mjs` — static checks for local links, copy placeholders, and required sections.
 - `scripts/build.mjs` — copies `src` into `dist` for GitHub Pages or any static host.
@@ -27,6 +28,6 @@ The included GitHub Pages workflow builds `dist` and publishes it as a static ar
 
 ## Design constraints
 
-- One checked-in social preview image, shared with the GitHub organization profile assets.
+- Checked-in brand images shared with the GitHub organization profile assets.
 - No runtime dependencies.
 - Fast, readable, and easy to fork into a richer docs site later.

package-lock.json

@@ -27,5 +27,8 @@
   "bugs": {
     "url": "https://github.com/agent-dispatch/website/issues"
   },
-  "homepage": "https://agent-dispatch.github.io/website"
+  "homepage": "https://agent-dispatch.github.io/website",
+  "engines": {
+    "node": ">=20.19"
+  }
 }

package.json

@@ -7,12 +7,9 @@ const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const srcDir = resolve(repoRoot, "src");
 const indexPath = resolve(srcDir, "index.html");
 const requiredSections = [
-  "hero",
-  "how-it-works",
-  "packages",
-  "agentcore",
-  "quickstart",
-  "roadmap"
+  "top",
+  "why",
+  "install"
 ];
 
 const index = await readFile(indexPath, "utf8");
@@ -41,17 +38,41 @@ const socialPreviewPath = resolve(srcDir, "assets", "repo-social-preview.png");
 if (!existsSync(socialPreviewPath)) {
   throw new Error("Missing required social preview image: src/assets/repo-social-preview.png");
 }
+const socialPreviewDimensions = await readPngDimensions(socialPreviewPath);
+if (socialPreviewDimensions.width !== 1280 || socialPreviewDimensions.height !== 640) {
+  throw new Error(
+    `Social preview image must be 1280x640; got ${socialPreviewDimensions.width}x${socialPreviewDimensions.height}.`
+  );
+}
+
+const orgLogoPath = resolve(srcDir, "assets", "org-logo.svg");
+if (!existsSync(orgLogoPath)) {
+  throw new Error("Missing required organization logo: src/assets/org-logo.svg");
+}
 
 for (const placeholder of ["TODO", "lorem", "ipsum", "undefined"]) {
   if (index.toLowerCase().includes(placeholder.toLowerCase())) {
     throw new Error(`Found placeholder text: ${placeholder}`);
   }
 }
 
+for (const expected of [
+  "docs",
+  "live-aws-verification.md",
+  "spawn_cloud_agent",
+  "@agent-dispatch/mcp-server",
+  "Live AWS dispatch remains opt-in"
+]) {
+  if (!index.includes(expected)) {
+    throw new Error(`Missing required website copy: ${expected}`);
+  }
+}
+
 for (const match of index.matchAll(/(?:href|src)="([^"]+)"/g)) {
   const target = match[1];
   if (target.startsWith("http") || target.startsWith("#") || target.startsWith("mailto:")) continue;
-  const localPath = resolve(dirname(indexPath), target);
+  const localTarget = target.split(/[?#]/, 1)[0];
+  const localPath = resolve(dirname(indexPath), localTarget);
   if (!existsSync(localPath)) {
     throw new Error(`Broken local asset reference: ${target}`);
   }
@@ -61,6 +82,12 @@ const css = await readFile(resolve(srcDir, "styles.css"), "utf8");
 if (!css.includes("@media") || !css.includes(":root")) {
   throw new Error("CSS must include responsive rules and root design tokens.");
 }
+if (/letter-spacing:\s*-[0-9.]/.test(css)) {
+  throw new Error("CSS must not use negative letter spacing.");
+}
+if (/font-size:\s*[^;]*vw/.test(css)) {
+  throw new Error("CSS must not scale font size directly with viewport width.");
+}
 
 const files = [];
 async function walk(dir) {
@@ -74,3 +101,16 @@ async function walk(dir) {
 await walk(srcDir);
 
 console.log(`Validated AgentDispatch website (${files.length} source files).`);
+
+async function readPngDimensions(path) {
+  const bytes = await readFile(path);
+  const signature = bytes.subarray(0, 8).toString("hex");
+  if (signature !== "89504e470d0a1a0a") {
+    throw new Error(`${path} is not a PNG file`);
+  }
+
+  return {
+    width: bytes.readUInt32BE(16),
+    height: bytes.readUInt32BE(20)
+  };
+}