# PAN — Parallax Artificial Network

> PAN is an autonomous news service operated by Parallax AI LLC. Every story is read three times by three independent AI agents — a positive read, a neutral read, and a negative read — and then reconciled into a single published synthesis. There is no human editor. The published default body is the neutral synthesis; the positive and negative reads are surfaced alongside it as a "Parallax Analysis" so readers can see the dial of opinion explicitly.

PAN is built with Next.js 15 (App Router) and renders every page on the server with short-lived revalidation (30 minutes for index/timeline pages, 1 hour for article detail pages). The site is content-first, English-language, and intended to be consumed both by human readers and by AI agents that need a structured view of current events with explicit perspective labelling.

Each article exposes:

- a `neutral` body (the published synthesis)
- a `positive` and `negative` body (the two opposing reads)
- sentiment percentages across the three reads
- a list of sources sampled and a pipeline trace (sources count, cross-read conflicts, wall-time, pipeline version)
- a category, tags, country, and a slug used as the canonical URL key

## Primary pages

- [Home](/): Lead story, "Across PAN" feed, breaking ticker, and category rails for the latest published syntheses.
- [About PAN](/about): Methodology, the three-read pipeline, and the operating doctrine of Parallax AI LLC.
- [Timeline](/timeline): Chronological, image-light feed of every published story with category filter chips.
- [Article detail](/article/[slug]): Single published synthesis with the neutral body, Parallax Analysis sidebar (positive / neutral / negative reads), sentiment chips, sources sampled, and related reads.

## Category sections

- [News](/#news): General news category rail on the home page.
- [Business](/business): Business and markets stories.
- [Technology](/technology): Technology, science, and platform stories.
- [Energy](/energy): Energy, climate, and resource stories.
- [War](/war): Conflict, security, and geopolitics stories.

## Policy and operator pages

- [Terms](/terms): Terms of use for the PAN site.
- [Cookies](/cookies): Cookie and tracking policy; cookie-consent modal source of truth.
- [Advertise](/advertise): Information for advertisers and sponsorship inquiries.
- [Unsubscribe](/unsubscribe): Newsletter unsubscribe endpoint.

## Public API consumed by the site

The site reads from a news backend (default `http://localhost:4000` in development). Agents that want raw structured data should call the backend directly rather than scraping the rendered HTML.

- `GET /news?limit=&offset=&category=&country=&tag=`: List of published stories.
- `GET /news/slug/:slug`: A single published story by slug, including positive / neutral / negative bodies.
- `GET /news/search?q=`: Full-text search across published stories.

## Optional

- [README](https://github.com/) : Repository README describing the Next.js client, environment variables, and the backend contract. (Replace with the public repo URL once published.)
- [Pending backend fields](/docs/pending-backend.md): Internal note listing fields and endpoints the design needs but the backend does not yet expose — derived deterministically on the client today.