chore: project scaffold, specs, and working record

2026-08-26 08:51:16 -04:00
commit 19f7226661
26 changed files with 3206 additions and 0 deletions
@@ -0,0 +1,42 @@
+import { defineCollection, z } from 'astro:content';
+import { PRACTICE_AREAS } from '../data/site';
+
+const practiceSlugs = PRACTICE_AREAS.map((a) => a.slug) as [string, ...string[]];
+
+/**
+ * Insights. Content territories are set by the strategy brief §VII and
+ * restated in docs/03-content-spec.md.
+ *
+ * Every piece must link to at least one practice-area page — that is what
+ * turns the blog into ranking power for the pages that convert.
+ */
+const insights = defineCollection({
+  type: 'content',
+  schema: ({ image }) =>
+    z.object({
+      title: z.string().max(70),
+      description: z.string().min(70).max(160), // doubles as the meta description
+      publishDate: z.date(),
+      updatedDate: z.date().optional(),
+      topic: z.enum([
+        'process-explainer',
+        'regulatory-commentary',
+        'industry-commentary',
+        'reflection',
+        'technical-explainer',
+        'credentialing',
+      ]),
+      practiceAreas: z.array(z.enum(practiceSlugs)).min(1),
+      image: image().optional(),
+      imageAlt: z.string().optional(),
+      /** Drafts are excluded from the build, the index, and the sitemap. */
+      draft: z.boolean().default(true),
+      /**
+       * Every article is reviewed by Pouya before publication (AGENTS.md D9).
+       * An article with draft:false and reviewedByPouya:false is a bug.
+       */
+      reviewedByPouya: z.boolean().default(false),
+    }),
+});
+
+export const collections = { insights };
@@ -0,0 +1,161 @@
+/**
+ * Site-wide constants.
+ *
+ * Anything marked TODO(pouya) is an unanswered question in AGENTS.md §9.
+ * Do not guess a value to make the build pass — an unanswered question is
+ * supposed to be visible. See CLAUDE.md.
+ */
+
+export const SITE = {
+  name: 'Pouya Lajevardi',
+  tagline: 'Mediation · Arbitration · Toronto',
+  url: 'https://adr.smlcompany.ca',
+  locale: 'en_CA',
+  entity: 'SML Company Ltd. · Ontario, Canada',
+} as const;
+
+/**
+ * Verified credentials only — mirrors AGENTS.md §4.
+ * Adding a line here without adding it there is a bug.
+ *
+ * D13: the site asserts the JD and makes NO licensure claim. Do not add
+ * 'lawyer', 'called to the bar', 'licensed', or any post-nominal implying a
+ * licence — and do not imply it either. See AGENTS.md §4 Forbidden.
+ */
+export const CREDENTIALS = {
+  designations: ['Q.Med (ADRIC / ADRIO)'],
+  inProgress: ['Q.Arb — commenced August 2026'], // [verified 2026-08-26]
+  goal: 'C.Med-Arb (Chartered Mediator-Arbitrator)',
+  education: ['JD, Bond University'],
+  certifications: [
+    'Kompass Arbitration Certificate Program',
+    'Stitt Feld Handy — negotiation and ADR workshop series',
+  ],
+  languages: ['English', 'Farsi'],
+  /** [verified 2026-08-26]. NOT OCNI (lapsed) and NOT the Law Society —
+   *  listing the LSO implies licensure, which D13 bars. Do not add either. */
+  memberships: [
+    'ADR Institute of Canada (ADRIC)',
+    'ADR Institute of Ontario (ADRIO)',
+    'Ontario Bar Association — Construction & Infrastructure, ADR, and Civil Litigation sections',
+  ],
+} as const;
+
+/** The three credential slots. Never matter counts — AGENTS.md §4. */
+export const CREDENTIAL_ROW = [
+  { value: 'Q.Med',   label: 'ADRIC / ADRIO designation' },
+  { value: 'JD + ML', label: 'Law and engineering' },
+  { value: 'EN · FA', label: 'Bilingual practice' },
+] as const;
+
+/**
+ * The Toronto boutique is NEVER named — AGENTS.md D16. Use this string.
+ * Do not infer a name from an email domain or anywhere else.
+ */
+export const BOUTIQUE = 'a Toronto litigation and ADR boutique' as const;
+
+/** Analytics: privacy-first and cookieless (D15). No GA4, no consent banner. */
+export const ANALYTICS = {
+  provider: 'plausible' as 'plausible' | 'fathom' | null,
+  domain: 'adr.smlcompany.ca',
+} as const;
+
+export const CONTACT = {
+  email: 'info@smlcompany.ca',                       // [verified 2026-08-26]
+  /** No public phone by choice. Render 'By scheduled call' wherever a number
+   *  would go — do not leave the field visually empty. */
+  phone: null as string | null,                      // [verified 2026-08-26]
+  phoneFallback: 'By scheduled call',
+  location: 'Toronto · Ontario · By appointment',
+  responseTime: 'Inquiries are answered within one business day.',
+  linkedin: 'https://www.linkedin.com/in/pouyalajevardi/', // [verified 2026-08-26]
+  /** Booking parked 2026-08-26 (AGENTS.md R6). Build /contact/ with the intake
+   *  form and a reserved slot so an embed drops in later without a rebuild. */
+  bookingUrl: null as string | null,
+} as const;
+
+/** Portrait assets. Astro derives AVIF/WebP variants from the master at build. */
+export const PORTRAIT = {
+  master: 'src/assets/pouya-lajevardi.jpg',   // 1600x1600
+  og: 'src/assets/og-portrait.jpg',           // 1200x630, cropped high
+  alt: 'Pouya Lajevardi',
+} as const;
+
+/** Shown on /contact/ and with the booking embed. Do not reword casually. */
+export const NO_RETAINER_NOTICE =
+  'Submitting this form does not create a retainer, does not appoint a neutral, ' +
+  'and does not itself establish a mediator–party relationship.';
+
+/**
+ * Rate card — AGENTS.md D14, confirmed by Pouya 2026-08-26.
+ * One rate for all mediation matters. All figures PLUS HST.
+ * Full research and reasoning: docs/07-fees.md
+ */
+export const FEES = {
+  currency: 'CAD',
+  taxNote: 'All fees are plus HST.',
+  mediation: {
+    /** Prep is bundled AND stated on the page — [verified 2026-08-26].
+   *  Do not hide it: at these rates, saying preparation is included is the
+   *  point, not a detail. */
+    halfDay: { amount: 2000, hours: 3.5, prepIncluded: 2 },
+    fullDay: { amount: 4000, hours: 7,   prepIncluded: 3 },
+    additionalParty: 500,          // each party beyond two
+    overtimePerHour: 500,          // [verified 2026-08-26]
+  },
+  arbitration: {
+    perHour: 500,
+    hearingDay: 4000,
+    documentsOnlySimple: 6500,     // flat
+    documentsOnlyComplex: 9500,    // flat
+    // No tribunal-secretary rate — removed by Pouya 2026-08-26.
+  },
+  // ENE, settlement counsel, dispute-system design, pre-dispute technical advisory
+  hourly: 500,                     // [verified 2026-08-26]
+  cancellation: [
+    { window: 'More than 30 days before', fee: 'No fee. Disbursements only.' },
+    { window: '15 to 30 days before',     fee: '50% of the booked fee.' },
+    { window: 'Fewer than 15 days before', fee: '100% of the booked fee.' },
+  ],
+  cancellationNotes: [
+    'Rescheduling at the time of cancellation, with a new date fixed, is not charged.',
+    'The cancellation fee is waived if the reserved time is filled by another matter of equal or greater value.',
+  ],
+  terms: [
+    'Fees are shared equally between the parties unless they agree otherwise in writing.',
+    'Accounts are payable on rendering. Interest accrues on overdue accounts at 5% per annum.',
+    'Video and in-person sessions are charged at the same rate.',
+  ],
+} as const;
+
+export const PRACTICE_AREAS = [
+  { slug: 'construction',   name: 'Construction & Infrastructure', chip: 'Construction' },
+  { slug: 'technology',     name: 'Technology, AI & Data',          chip: 'Technology'   },
+  { slug: 'energy',         name: 'Energy, Grid & Regulatory',      chip: 'Energy'       },
+  { slug: 'insurance',      name: 'Insurance, SABS & LAT',          chip: 'Insurance'    },
+  { slug: 'shareholder',    name: 'Shareholder & Family Business',  chip: 'Shareholder'  },
+  { slug: 'cross-cultural', name: 'Cross-Border & Diaspora',        chip: 'Cross-cultural' },
+] as const;
+
+/** Seven items is the ceiling before a nav stops being scannable. */
+export const PRIMARY_NAV = [
+  { href: '/about/',       label: 'About' },
+  { href: '/mediation/',   label: 'Mediation' },
+  { href: '/arbitration/', label: 'Arbitration' },
+  { href: '/practice/',    label: 'Practice', children: PRACTICE_AREAS },
+  { href: '/fees/',        label: 'Fees' },
+  { href: '/insights/',    label: 'Insights' },
+  { href: '/contact/',     label: 'Contact' },
+] as const;
+
+/** Linked contextually rather than from the primary nav. */
+export const SECONDARY_NAV = [
+  { href: '/process/',     label: 'How I work' },
+  { href: '/med-arb/',     label: 'Med-Arb' },
+  { href: '/for-parties/', label: 'For parties' },
+] as const;
+
+export const LEGAL_NAV = [
+  { href: '/legal/privacy/', label: 'Privacy' },
+  { href: '/legal/terms/',   label: 'Terms' },
+] as const;
@@ -0,0 +1,192 @@
+/* ============================================================================
+   Global base. Spec: docs/02-design-system.md
+   ========================================================================= */
+
+@import './tokens.css';
+
+/* --- Fonts: self-hosted, subset, swap. No runtime Google Fonts request. ----
+   TODO(claude-code): place subset woff2 files in /public/fonts/ and preload
+   Instrument Serif 400 and Geist 400 in BaseLayout — they are the only two
+   faces used above the fold.                                                */
+
+@font-face {
+  font-family: 'Instrument Serif';
+  src: url('/fonts/instrument-serif-400.woff2') format('woff2');
+  font-weight: 400; font-style: normal; font-display: swap;
+  unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F, U+2190-21BB;
+}
+@font-face {
+  font-family: 'Instrument Serif';
+  src: url('/fonts/instrument-serif-400-italic.woff2') format('woff2');
+  font-weight: 400; font-style: italic; font-display: swap;
+  unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F;
+}
+@font-face {
+  font-family: 'Geist';
+  src: url('/fonts/geist-variable.woff2') format('woff2-variations');
+  font-weight: 300 600; font-style: normal; font-display: swap;
+  unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F, U+2190-21BB;
+}
+@font-face {
+  font-family: 'Geist Mono';
+  src: url('/fonts/geist-mono-variable.woff2') format('woff2-variations');
+  font-weight: 400 500; font-style: normal; font-display: swap;
+  unicode-range: U+0000-00FF, U+2000-206F;
+}
+
+/* --- Reset ---------------------------------------------------------------- */
+
+*, *::before, *::after { box-sizing: border-box; }
+* { margin: 0; }
+
+html {
+  -webkit-text-size-adjust: 100%;
+  scroll-behavior: smooth;
+  scroll-padding-top: var(--space-8);
+}
+
+body {
+  background: var(--bg);
+  color: var(--text);
+  font-family: var(--font-sans);
+  font-size: var(--text-base);
+  font-weight: var(--weight-normal);
+  line-height: var(--leading-body);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
+  overflow-x: hidden;
+  min-height: 100vh;
+}
+
+img, picture, video, canvas, svg { display: block; max-width: 100%; }
+img { height: auto; }
+input, button, textarea, select { font: inherit; color: inherit; }
+p, h1, h2, h3, h4, h5, h6 { overflow-wrap: break-word; }
+ul[role='list'], ol[role='list'] { list-style: none; padding: 0; }
+
+/* --- Type ----------------------------------------------------------------- */
+
+h1, h2, h3, h4 { font-weight: var(--weight-normal); text-wrap: balance; }
+
+.display {
+  font-family: var(--font-serif);
+  font-weight: var(--weight-normal);
+  line-height: var(--leading-display);
+  letter-spacing: var(--tracking-display);
+}
+/* The one flourish the design allows. One italic phrase per headline, max. */
+.display .it { font-style: italic; }
+
+.eyebrow {
+  font-family: var(--font-mono);
+  font-size: var(--text-xs);
+  font-weight: var(--weight-medium);
+  letter-spacing: var(--tracking-eyebrow);
+  text-transform: uppercase;
+  color: var(--text-meta);
+}
+/* An eyebrow is a label, never the page's heading element. */
+.eyebrow .dot {
+  display: inline-block;
+  inline-size: 6px; block-size: 6px;
+  border-radius: 50%;
+  background: var(--accent);
+  margin-inline-end: var(--space-3);
+  vertical-align: 0.15em;
+}
+
+p { max-inline-size: var(--width-prose); }
+
+a { color: var(--link); text-decoration-thickness: 1px; text-underline-offset: 0.2em; }
+a:hover { color: var(--accent-hover); }
+
+/* --- Focus: visible, always. The previous build removed it globally. ------- */
+
+:focus-visible {
+  outline: 2px solid var(--focus-ring);
+  outline-offset: 3px;
+  border-radius: var(--radius-sm);
+}
+:focus:not(:focus-visible) { outline: none; }
+
+.skip-link {
+  position: absolute;
+  inset-block-start: var(--space-2);
+  inset-inline-start: var(--space-2);
+  z-index: var(--z-skip);
+  padding: var(--space-3) var(--space-5);
+  background: var(--accent);
+  color: var(--text-inverse);
+  border-radius: var(--radius-md);
+  transform: translateY(-200%);
+  transition: transform var(--dur-fast) var(--ease);
+}
+.skip-link:focus { transform: translateY(0); }
+
+::selection { background: var(--accent); color: var(--text-inverse); }
+
+/* --- Layout --------------------------------------------------------------- */
+
+.wrap { inline-size: 100%; max-inline-size: var(--width-content); margin-inline: auto; padding-inline: var(--gutter); }
+.wrap-wide { max-inline-size: var(--width-wide); }
+.prose { max-inline-size: var(--width-prose); }
+.section { padding-block: var(--section-y); }
+.section-alt { background: var(--bg-alt); }
+.section-inverse { background: var(--bg-inverse); color: var(--text-inverse); }
+.section-inverse .eyebrow,
+.section-inverse .text-meta { color: var(--text-inverse-2); }
+
+hr { border: none; border-block-start: 1px solid var(--border); }
+.rule-gold { border: none; border-block-start: 1px solid var(--rule); }
+
+.visually-hidden {
+  position: absolute; inline-size: 1px; block-size: 1px;
+  padding: 0; margin: -1px; overflow: hidden;
+  clip-path: inset(50%); white-space: nowrap; border: 0;
+}
+
+/* --- Reveal ---------------------------------------------------------------
+   Progressive enhancement, not a dependency. Content is rendered and visible
+   in the HTML; `.reveal` only takes effect once JS adds `js-reveal` to <html>.
+   If the observer never runs, every page reads normally. The previous build
+   had this backwards and shipped a blank page to anything without JS.       */
+
+.js-reveal .reveal { opacity: 0; transform: translateY(20px); }
+.js-reveal .reveal.is-in {
+  opacity: 1; transform: none;
+  transition: opacity var(--dur-reveal) var(--ease), transform var(--dur-reveal) var(--ease);
+}
+.js-reveal .reveal-stagger > * { opacity: 0; transform: translateY(16px); }
+.js-reveal .reveal-stagger.is-in > * {
+  opacity: 1; transform: none;
+  transition: opacity var(--dur-reveal) var(--ease), transform var(--dur-reveal) var(--ease);
+}
+.js-reveal .reveal-stagger.is-in > *:nth-child(1) { transition-delay: 0ms; }
+.js-reveal .reveal-stagger.is-in > *:nth-child(2) { transition-delay: 70ms; }
+.js-reveal .reveal-stagger.is-in > *:nth-child(3) { transition-delay: 140ms; }
+.js-reveal .reveal-stagger.is-in > *:nth-child(4) { transition-delay: 210ms; }
+.js-reveal .reveal-stagger.is-in > *:nth-child(5) { transition-delay: 280ms; }
+.js-reveal .reveal-stagger.is-in > *:nth-child(6) { transition-delay: 350ms; }
+/* Stagger caps at six children by design. */
+
+@media (prefers-reduced-motion: reduce) {
+  html { scroll-behavior: auto; }
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+  .js-reveal .reveal,
+  .js-reveal .reveal-stagger > * { opacity: 1 !important; transform: none !important; }
+}
+
+/* --- Print: the About page will be printed by people evaluating an appointment */
+
+@media print {
+  body { background: #fff; color: #000; font-size: 11pt; }
+  .site-header, .site-footer, .skip-link, .no-print { display: none !important; }
+  a[href^='http']::after { content: ' (' attr(href) ')'; font-size: 9pt; }
+  .section { padding-block: var(--space-5); }
+}
@@ -0,0 +1,144 @@
+/* ============================================================================
+   Design tokens — the single source of colour, type, space, and motion.
+   Spec: docs/02-design-system.md
+
+   Never write a raw hex value or a magic number in a component. If a value is
+   missing here, add it here.
+   ========================================================================= */
+
+:root {
+  /* --- Colour ------------------------------------------------------------
+     Palette carried over unchanged from the previous build (AGENTS.md D7).
+     Contrast ratios measured 2026-08-25 and recorded in docs/02.          */
+
+  --cream:      #faf7f2;   /* page background                              */
+  --cream-2:    #f3ede0;   /* alternating section background               */
+  --cream-3:    #ebe3d1;   /* cards and insets on cream                    */
+
+  --ink:        #1a1614;   /* body text; dark section backgrounds  16.81:1 */
+  --ink-soft:   #3a322c;   /* secondary text                      11.75:1  */
+  --muted:      #6e6359;   /* metadata — ON CREAM ONLY (3.07:1 on ink)     */
+
+  --maroon:     #5a1a1c;   /* primary action, dark panels         12.29:1  */
+  --maroon-d:   #3d1112;   /* hover on maroon                              */
+  --maroon-l:   #7a2a2c;   /* links on cream                       8.95:1  */
+
+  /* GOLD IS NOT A TEXT COLOUR ON CREAM.
+     --gold on cream measures 2.10:1 and fails AA for body AND large text.
+     --gold-d measures 3.11:1 — large decorative text only, 24px+.
+     Both are fine on --ink (8.00) and --maroon (5.84). See docs/02.        */
+  --gold:       #c9a876;   /* rules, dividers, icon strokes, on-dark text  */
+  --gold-d:     #a88858;   /* large decorative display text on cream only  */
+  --gold-l:     #e2c89a;   /* text on ink or maroon               11.09:1  */
+
+  --line:       rgb(26 22 20 / 0.10);
+  --line-2:     rgb(26 22 20 / 0.06);
+  --line-dark:  rgb(250 247 242 / 0.14);
+
+  /* Semantic aliases — prefer these in components over raw palette names. */
+  --bg:              var(--cream);
+  --bg-alt:          var(--cream-2);
+  --bg-raised:       var(--cream-3);
+  --bg-inverse:      var(--ink);
+  --text:            var(--ink);
+  --text-secondary:  var(--ink-soft);
+  --text-meta:       var(--muted);
+  --text-inverse:    var(--cream);
+  --text-inverse-2:  var(--gold-l);
+  --accent:          var(--maroon);
+  --accent-hover:    var(--maroon-d);
+  --link:            var(--maroon-l);
+  --rule:            var(--gold);
+  --border:          var(--line);
+  --focus-ring:      var(--maroon);
+
+  /* --- Type -------------------------------------------------------------- */
+
+  --font-serif: 'Instrument Serif', 'Cormorant Garamond', Georgia, 'Times New Roman', serif;
+  --font-sans:  'Geist', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  --font-mono:  'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+
+  /* Fluid scale, 360px → 1600px viewport. Ratio widens toward the display
+     end (1.25 → 1.333) so headlines scale harder than body copy.          */
+  --text-xs:   0.75rem;                                    /* 12  — legal   */
+  --text-sm:   0.875rem;                                   /* 14  — meta    */
+  --text-base: 1rem;                                       /* 16  — body    */
+  --text-lg:   clamp(1.0625rem, 0.99rem + 0.32vw, 1.1875rem);   /* 17→19   */
+  --text-xl:   clamp(1.25rem,  1.14rem + 0.48vw,  1.5rem);      /* 20→24   */
+  --text-2xl:  clamp(1.5rem,   1.31rem + 0.81vw,  1.875rem);    /* 24→30   */
+  --text-3xl:  clamp(1.875rem, 1.55rem + 1.37vw,  2.5rem);      /* 30→40   */
+  --text-4xl:  clamp(2.25rem,  1.66rem + 2.50vw,  3.5rem);      /* 36→56   */
+  --text-5xl:  clamp(2.75rem,  1.75rem + 4.25vw,  4.75rem);     /* 44→76   */
+  --text-6xl:  clamp(3.25rem,  1.75rem + 6.35vw,  6rem);        /* 52→96   */
+
+  --leading-display: 0.98;
+  --leading-tight:   1.15;
+  --leading-snug:    1.35;
+  --leading-body:    1.6;
+  --leading-relaxed: 1.75;
+
+  --tracking-display: -0.02em;
+  --tracking-tight:   -0.01em;
+  --tracking-normal:  0;
+  --tracking-wide:    0.06em;
+  --tracking-eyebrow: 0.18em;
+
+  --weight-light:  300;
+  --weight-normal: 400;
+  --weight-medium: 500;
+  --weight-semi:   600;
+
+  /* --- Space — 8px base -------------------------------------------------- */
+
+  --space-1:  0.25rem;   /*   4 */
+  --space-2:  0.5rem;    /*   8 */
+  --space-3:  0.75rem;   /*  12 */
+  --space-4:  1rem;      /*  16 */
+  --space-5:  1.5rem;    /*  24 */
+  --space-6:  2rem;      /*  32 */
+  --space-7:  3rem;      /*  48 */
+  --space-8:  4rem;      /*  64 */
+  --space-9:  6rem;      /*  96 */
+  --space-10: 8rem;      /* 128 */
+  --space-11: 10rem;     /* 160 */
+
+  --section-y: clamp(var(--space-9), 6vw + 2rem, var(--space-11));
+
+  /* --- Layout ------------------------------------------------------------ */
+
+  --width-content: 80rem;   /* 1280 */
+  --width-wide:    90rem;   /* 1440 */
+  --width-prose:   68ch;    /* reading measure — never exceed for body copy */
+  --gutter:        var(--space-5);
+  --gutter-lg:     var(--space-7);
+
+  /* --- Radius, elevation, motion ----------------------------------------- */
+
+  --radius-sm:   4px;
+  --radius-md:   8px;
+  --radius-lg:   16px;
+  --radius-full: 999px;
+
+  --shadow-sm: 0 1px 2px rgb(26 22 20 / 0.04);
+  --shadow-md: 0 4px 16px rgb(26 22 20 / 0.06);
+  --shadow-lg: 0 12px 40px rgb(26 22 20 / 0.10);
+
+  --ease:        cubic-bezier(0.2, 0.7, 0.2, 1);
+  --ease-out:    cubic-bezier(0.16, 1, 0.3, 1);
+  --dur-fast:    150ms;
+  --dur-hover:   250ms;
+  --dur-reveal:  600ms;
+
+  --z-base: 0;
+  --z-sticky: 100;
+  --z-header: 200;
+  --z-overlay: 300;
+  --z-skip: 400;
+}
+
+@media (min-width: 48rem) {
+  :root { --gutter: var(--gutter-lg); }
+}
+
+/* No dark mode by design (docs/02). A single committed light identity is the
+   right call for a legal practice and halves the ways contrast can break.   */