← Changelog

Entity Map

AI 2026-07-07

Implemented /entitymap.json (EntityMap v1.0) with 8 entities — Person, Organization, and 6 Concepts — with structured relations, hasChunks text extracts, and a human-readable /entitymap/ companion page.

Why an entity map

Knowledge graphs are how Google understands entities and their relationships — who someone is, what they’ve built, how concepts relate. For a personal site, declaring these relationships explicitly helps search engines and AI systems build an accurate picture without having to infer everything from prose.

The EntityMap v1.0 spec provides a structured format for self-declaring entities: their type, description, sameAs links to authoritative sources, relations to other entities, and hasChunks — actual text extracts that serve as grounding data for LLMs.

The 8 entities

People:

Organizations:

Concepts:

Relations

Relations use explicit predicates: AFFILIATED_WITH, AUTHORED_BY, INCLUDES, DEPENDS_ON, RELATES_TO, PART_OF, PRODUCED_BY. These model the actual structure:

hasChunks — grounding data for LLMs

Each entity includes hasChunks: short text extracts that provide factual grounding. These are structured like retrieved documents: chunkId, text, sourceUrl, pageTitle, relevanceScore, contentType (definition, evidence, example).

The intention is that an LLM processing the entity map has ready-made factual summaries per entity, linked back to their source pages, rather than having to extract meaning from prose.

Two surfaces: JSON and human-readable

/entitymap.json — machine-readable, cached for 24 hours, tracked in the crawl intelligence pipeline alongside other AI-facing endpoints.

/entitymap/ — human-readable page with entity cards, type badges, and relation chips. Lets humans see the same data without parsing JSON.

What I’d add next

← All entries