hanzo.ai/app/(marketing)/research/page.tsx

'use client'

import { FlaskConical } from 'lucide-react'
import { Page, PageHero, Section, CardGrid, Prose, Cta, type CardItem } from '@/components/marketing/page-kit'
import { papers, PAPERS } from '@/lib/data/papers'
import { Spare } from '@/components/type'

/**
 * The way in to the library. papers.hanzo.ai is where a paper is published; this
 * page is the entry point, and it states nothing of its own.
 *
 * It used to hold six hand-typed titles under a comment reading "Titles mirror
 * what is published on papers.hanzo.ai — add a paper there, then here". They did
 * not mirror it. Not one of the six was a title the library serves, every card
 * pointed at the library's ROOT rather than at its paper, and the instruction to
 * update two places in step is exactly the arrangement that guarantees they
 * drift. The list is now derived from `lib/data/papers.json`, which
 * `scripts/sync-papers.mjs` re-fetches on every build — so adding a paper to the
 * library is the whole of adding it here, and a card cannot name a paper that
 * does not exist or link to a page that does not answer.
 */
const ITEMS: CardItem[] = PAPERS.map((paper) => ({
  title: paper.title,
  description: paper.subtitle,
  meta: paper.date,
  href: `${papers.source}/${paper.slug}/`,
}))

/**
 * Doors into the specification index. Each URL was fetched and answered.
 * This is not the whole index — hips.hanzo.ai is — and a card is added here
 * only when this page should open that document.
 */
const SPECS: CardItem[] = [
  { title: 'All HIPs', description: 'The specification index.', href: 'https://hips.hanzo.ai' },
  { title: 'HIP-0000', description: 'The architecture framework.', href: 'https://hips.hanzo.ai/docs/hip-0000-hanzo-ai-architecture-framework' },
  { title: 'HIP-0510', description: 'Enso, the learned router.', href: 'https://hips.hanzo.ai/docs/hip-0510-enso-learned-router' },
  { title: 'HIP-1332', description: 'Kai, the decision model.', href: 'https://hips.hanzo.ai/docs/hip-1332-kai-the-decision-model' },
  { title: 'HIP-0039', description: 'Zen model architecture.', href: 'https://hips.hanzo.ai/docs/hip-0039-zen-model-architecture' },
  { title: 'HIP-1334', description: 'The research runtime.', href: 'https://hips.hanzo.ai/docs/hip-1334-research-unified-runtime' },
  { title: 'HIP-1145', description: 'How an experiment is recorded.', href: 'https://hips.hanzo.ai/docs/hip-1145-research-experiment-record' },
]

/** Standards Track documents the families are built against. */
const STANDARDS: CardItem[] = [
  { title: 'HIP-0043', description: 'The inference engine.', href: 'https://hips.hanzo.ai/docs/hip-0043-llm-inference-engine-standard' },
  { title: 'HIP-1211', description: 'The model API.', href: 'https://hips.hanzo.ai/docs/hip-1211-ai-the-model-api' },
  { title: 'HIP-0004', description: 'The gateway.', href: 'https://hips.hanzo.ai/docs/hip-0004-llm-gateway-unified-ai-provider-interface' },
  { title: 'HIP-0019', description: 'Tensor operations.', href: 'https://hips.hanzo.ai/docs/hip-0019-tensor-operations-standard' },
  { title: 'HIP-1105', description: 'The benchmark arena.', href: 'https://hips.hanzo.ai/docs/hip-1105-benchmark-measurement-arena' },
]

export default function ResearchPage() {
  return (
    <Page>
      <PageHero
        eyebrow="Research"
        icon={FlaskConical}
        title="Work we publish"
        lede={<>Hanzo builds infrastructure that has to hold up under audit, regulation and adversaries.<Spare> The reasoning behind it is published rather than kept internal.</Spare></>}
      >
        <Cta href="https://papers.hanzo.ai">Explore papers.hanzo.ai ↗</Cta>
        <Cta href="https://hips.hanzo.ai">Specifications (HIPs) ↗</Cta>
        <Cta href="/benchmarks">Benchmarks</Cta>
      </PageHero>

      <Section title="Papers" lede="Each one links to its page on papers.hanzo.ai, where the PDF and the LaTeX live.">
        <CardGrid items={ITEMS} columns={2} />
      </Section>

      <Section title="Specifications" lede="HIPs. The index is hips.hanzo.ai. These are the ones the families are written against.">
        <CardGrid items={SPECS} columns={2} />
      </Section>

      <Section title="Standards" lede="The standards the runtime, the gateway, and the benchmark arena are built to.">
        <CardGrid items={STANDARDS} columns={2} />
      </Section>

      <Section title="Open source">
        <Prose>
          <p>
            The systems described in these papers are open source. The cloud, the gateway, the agent runtime and the
            infrastructure around them are developed in the open at{' '}
            <a href="https://github.com/hanzoai">github.com/hanzoai</a>, and the platform pays the open-source authors
            whose work runs on it.
          </p>
        </Prose>
      </Section>
    </Page>
  )
}