{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://aigeoradar.com/schemas/aipm/1.2/page-manifest.schema.json",
    "title": "AI Page Manifest (AIPM)",
    "description": "Machine-readable page manifest for AI crawlers, RAG systems, and GEO discovery. Part of the AI Discovery Framework (ADF). AIPM v1.2.0 adds entity importance, related page anchors, and editorial key-fact suggestions. Maintained by AigeoRadar.",
    "type": "object",
    "additionalProperties": false,
    "required": [
        "$schema",
        "specification",
        "manifestType",
        "maintainer",
        "purpose",
        "version",
        "id",
        "url",
        "canonical",
        "title",
        "inLanguage",
        "pageType",
        "abstract",
        "primaryTopic",
        "keywords",
        "audience",
        "contentHash",
        "wordCount",
        "readingTime",
        "readingLevel",
        "contentIntent",
        "topicCluster",
        "contentFreshness",
        "mainEntity",
        "secondaryEntities",
        "summary50",
        "summary150",
        "summary500",
        "keyFacts",
        "claims",
        "confidence",
        "relatedPages",
        "publisher",
        "citationPolicy",
        "speakable",
        "breadcrumb",
        "instructions",
        "updateFrequency",
        "lifecycle",
        "trustSignals",
        "assets",
        "availableActions",
        "faqEntity"
    ],
    "properties": {
        "$schema": {
            "type": "string",
            "format": "uri",
            "const": "https://aigeoradar.com/schemas/aipm/1.2/page-manifest.schema.json",
            "description": "JSON Schema URI for AI Page Manifest (AIPM)."
        },
        "specification": {
            "type": "object",
            "additionalProperties": false,
            "required": ["name", "shortName", "version", "rfc"],
            "properties": {
                "name": { "type": "string", "const": "AI Page Manifest" },
                "shortName": { "type": "string", "const": "AIPM" },
                "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
                "rfc": { "type": "string", "pattern": "^AIPM-\\d{3}$" }
            },
            "description": "Public specification identity for AI Page Manifest (AIPM)."
        },
        "manifestType": {
            "type": "string",
            "enum": ["page", "organization", "product", "faq", "service"],
            "description": "Manifest document type. Only page is produced in AIPM v1.1.1."
        },
        "maintainer": {
            "type": "object",
            "additionalProperties": false,
            "required": ["name", "url", "specification"],
            "properties": {
                "name": { "type": "string", "minLength": 1 },
                "url": { "type": "string", "format": "uri" },
                "specification": { "type": "string", "format": "uri" }
            },
            "description": "Organization maintaining this specification."
        },
        "purpose": {
            "type": "string",
            "minLength": 10,
            "maxLength": 500,
            "description": "Why this page exists — editorial one-sentence intent for AI systems."
        },
        "version": {
            "type": "string",
            "pattern": "^\\d+\\.\\d+\\.\\d+$",
            "description": "Semantic version of this manifest payload (e.g. 1.1.1).",
            "examples": ["1.1.1"]
        },
        "id": {
            "type": "string",
            "pattern": "^page_[a-f0-9]{8}$",
            "description": "Stable page identifier derived from canonical URL (SHA-256 prefix).",
            "examples": ["page_f495043e"]
        },
        "url": {
            "type": "string",
            "format": "uri",
            "description": "Public HTML page URL this card describes."
        },
        "canonical": {
            "type": "string",
            "format": "uri",
            "description": "Canonical URL for citation and deduplication. May differ from url when redirects or alternate paths exist."
        },
        "title": {
            "type": "string",
            "minLength": 1,
            "description": "Human-readable page title."
        },
        "inLanguage": {
            "type": "string",
            "pattern": "^[a-z]{2}(-[A-Z]{2})?$",
            "description": "BCP 47 language tag.",
            "examples": ["en", "tr"]
        },
        "pageType": {
            "type": "string",
            "enum": ["blog", "help", "product", "pricing", "legal", "faq"],
            "description": "High-level page classification for routing AI intent."
        },
        "datePublished": {
            "type": ["string", "null"],
            "format": "date",
            "description": "First publication date (ISO 8601 date). Null for evergreen static pages without a publish date."
        },
        "dateModified": {
            "type": ["string", "null"],
            "format": "date",
            "description": "Last substantive content update (ISO 8601 date)."
        },
        "abstract": {
            "type": "string",
            "description": "Factual summary (typically from meta description or help summary). Not marketing copy."
        },
        "primaryTopic": {
            "type": "string",
            "description": "Primary subject of the page for clustering and retrieval."
        },
        "keywords": {
            "type": "array",
            "items": { "type": "string", "minLength": 1 },
            "uniqueItems": true,
            "description": "GEO keywords and tags associated with this page."
        },
        "audience": {
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1
            },
            "minItems": 1,
            "description": "Intended reader or buyer segments. Prefer owner-verified audience from entity.json (business profile)."
        },
        "contentHash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$",
            "description": "SHA-256 hash of title + abstract + body text + dateModified. Crawlers use this to detect content changes without re-fetching HTML."
        },
        "wordCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Approximate word count of visible page body text."
        },
        "readingTime": {
            "type": "integer",
            "minimum": 1,
            "description": "Estimated reading time in minutes (default: 220 words per minute)."
        },
        "readingLevel": {
            "type": "string",
            "enum": ["beginner", "intermediate", "advanced"],
            "description": "Technical depth of the content."
        },
        "contentIntent": {
            "type": "string",
            "enum": ["informational", "commercial", "transactional", "comparison", "documentation"],
            "description": "Primary user and AI intent signal for this page."
        },
        "topicCluster": {
            "type": "array",
            "items": { "type": "string", "minLength": 1 },
            "minItems": 1,
            "description": "Thematic cluster labels for cross-page linking and RAG routing.",
            "examples": [["AI Visibility", "GEO", "WordPress", "AI Discovery"]]
        },
        "contentFreshness": {
            "type": "object",
            "additionalProperties": false,
            "required": ["status", "daysSinceModified", "modifiedAt"],
            "properties": {
                "status": {
                    "type": "string",
                    "enum": ["current", "fresh", "aging", "stale", "unknown"],
                    "description": "current ≤30d, fresh ≤90d, aging ≤180d, stale >180d, unknown when dateModified is absent."
                },
                "daysSinceModified": {
                    "type": ["integer", "null"],
                    "minimum": 0
                },
                "modifiedAt": {
                    "type": ["string", "null"],
                    "format": "date"
                }
            }
        },
        "mainEntity": {
            "type": "array",
            "description": "Named entities mentioned on this page (products, concepts, discovery files).",
            "items": { "$ref": "#/$defs/namedEntity" }
        },
        "secondaryEntities": {
            "type": "array",
            "description": "Related platform entities and discovery assets referenced across the site.",
            "items": { "$ref": "#/$defs/namedEntityWithOptionalUrl" }
        },
        "summary50": {
            "type": "string",
            "maxLength": 50,
            "description": "Ultra-short factual summary (~50 characters) for tight context windows."
        },
        "summary150": {
            "type": "string",
            "maxLength": 160,
            "description": "Short summary (~150 characters) — preferred default for most LLM citations."
        },
        "summary500": {
            "type": "string",
            "maxLength": 520,
            "description": "Extended factual summary (~500 characters) for deeper RAG context."
        },
        "keyFacts": {
            "type": "array",
            "items": { "type": "string", "minLength": 10 },
            "maxItems": 10,
            "description": "Editorially authored atomic facts (3–7 recommended). Automatic extraction is not permitted in v1.1.1."
        },
        "claims": {
            "type": "array",
            "items": { "$ref": "#/$defs/claim" },
            "description": "Verifiable claims with evidence URLs."
        },
        "confidence": {
            "type": "string",
            "enum": ["official", "verified", "estimated"],
            "description": "Publisher confidence level for facts on this page."
        },
        "reviewedBy": {
            "type": "string",
            "description": "Editorial or team responsible for factual review."
        },
        "reviewDate": {
            "type": ["string", "null"],
            "format": "date",
            "description": "Date of last editorial review. Often mirrors dateModified."
        },
        "relatedPages": {
            "type": "array",
            "items": { "$ref": "#/$defs/relatedPage" },
            "maxItems": 10,
            "description": "Semantically related pages with relationship types."
        },
        "publisher": {
            "type": "object",
            "additionalProperties": false,
            "required": ["@id", "name", "url"],
            "properties": {
                "@id": {
                    "type": "string",
                    "format": "uri",
                    "description": "Publisher entity graph URI (typically /entity.json)."
                },
                "name": { "type": "string" },
                "url": {
                    "type": "string",
                    "format": "uri"
                }
            }
        },
        "citationPolicy": {
            "type": "array",
            "items": { "type": "string", "minLength": 10 },
            "minItems": 1,
            "description": "Rules for AI systems citing or summarizing this publisher. Includes entity.json precedence on conflicts."
        },
        "speakable": {
            "type": "object",
            "additionalProperties": false,
            "required": ["@type", "cssSelector", "summary", "ssml"],
            "properties": {
                "@type": {
                    "type": "string",
                    "const": "SpeakableSpecification"
                },
                "cssSelector": {
                    "type": "array",
                    "items": { "type": "string" },
                    "minItems": 1
                },
                "summary": {
                    "type": "string",
                    "maxLength": 160,
                    "description": "Plain-text speakable summary."
                },
                "ssml": {
                    "type": "string",
                    "description": "SSML-wrapped speakable version for voice assistants.",
                    "pattern": "^<speak>"
                }
            }
        },
        "breadcrumb": {
            "type": "array",
            "items": { "$ref": "#/$defs/breadcrumbItem" },
            "minItems": 1
        },
        "instructions": {
            "type": "object",
            "additionalProperties": false,
            "required": ["preferredSummaryLength", "preferredCitation", "allowQuotation", "maxQuoteWords"],
            "properties": {
                "preferredSummaryLength": {
                    "type": "integer",
                    "enum": [50, 150, 500],
                    "description": "Preferred summary field: summary50, summary150, or summary500."
                },
                "preferredCitation": {
                    "type": "string",
                    "enum": ["url", "title", "publisher"],
                    "description": "How to attribute citations from this page."
                },
                "allowQuotation": { "type": "boolean" },
                "maxQuoteWords": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 100
                }
            },
            "description": "Machine instructions for LLMs consuming this card."
        },
        "updateFrequency": {
            "type": "string",
            "enum": ["weekly", "monthly", "yearly", "dynamic"],
            "description": "Expected cadence of content updates."
        },
        "lifecycle": {
            "type": "string",
            "enum": ["evergreen", "seasonal", "deprecated", "dynamic"],
            "description": "Content lifecycle classification."
        },
        "trustSignals": {
            "type": "object",
            "additionalProperties": false,
            "required": ["officialPublisher", "structuredData", "entityFile", "knowledgeFile"],
            "properties": {
                "officialPublisher": { "type": "boolean" },
                "structuredData": { "type": "boolean" },
                "entityFile": { "type": "boolean" },
                "knowledgeFile": { "type": "boolean" }
            },
            "description": "Publisher trust indicators for AI citation decisions."
        },
        "assets": {
            "type": "object",
            "additionalProperties": false,
            "required": ["entity", "knowledge", "feed", "llms", "llmsFull", "schema"],
            "properties": {
                "entity": { "type": "string", "format": "uri" },
                "knowledge": { "type": "string", "format": "uri" },
                "feed": { "type": "string", "format": "uri" },
                "llms": { "type": "string", "format": "uri" },
                "llmsFull": { "type": "string", "format": "uri" },
                "schema": { "type": "string", "format": "uri", "description": "Organization/entity JSON-LD source (entity.json)." }
            },
            "description": "Site-wide AI discovery asset URLs discoverable from any page card."
        },
        "availableActions": {
            "type": "array",
            "items": { "$ref": "#/$defs/action" },
            "description": "Actions an AI assistant may suggest to users reading about this publisher."
        },
        "faqEntity": {
            "type": "array",
            "description": "Schema.org FAQ Question/Answer items when pageType is faq. Empty array on non-FAQ pages.",
            "items": { "$ref": "#/$defs/faqQuestion" }
        }
    },
    "$defs": {
        "namedEntity": {
            "type": "object",
            "additionalProperties": false,
            "required": ["name", "type"],
            "properties": {
                "name": { "type": "string", "minLength": 1 },
                "type": {
                    "type": "string",
                    "enum": ["Software", "Concept", "DiscoveryFile", "Organization", "Thing"]
                },
                "importance": {
                    "type": "string",
                    "enum": ["primary", "secondary", "mentioned"],
                    "description": "Entity salience on this page (v1.2.0)."
                }
            }
        },
        "namedEntityWithOptionalUrl": {
            "type": "object",
            "additionalProperties": false,
            "required": ["name", "type"],
            "properties": {
                "name": { "type": "string", "minLength": 1 },
                "type": {
                    "type": "string",
                    "enum": ["Software", "Concept", "DiscoveryFile", "Organization", "Thing"]
                },
                "url": { "type": "string", "format": "uri" }
            }
        },
        "claim": {
            "type": "object",
            "additionalProperties": false,
            "required": ["text", "type", "evidence", "confidence"],
            "properties": {
                "text": { "type": "string", "minLength": 10 },
                "type": {
                    "type": "string",
                    "enum": ["internal", "external"],
                    "description": "internal = publisher evidence; external = third-party source."
                },
                "evidence": { "type": "string", "format": "uri" },
                "confidence": {
                    "type": "string",
                    "enum": ["official", "verified", "estimated"]
                }
            }
        },
        "relatedPage": {
            "type": "object",
            "additionalProperties": false,
            "required": ["url", "title", "pageType", "relationship"],
            "properties": {
                "url": { "type": "string", "format": "uri" },
                "title": { "type": "string", "minLength": 1 },
                "pageType": {
                    "type": "string",
                    "enum": ["blog", "help", "product", "pricing", "legal", "faq"]
                },
                "relationship": {
                    "type": "string",
                    "enum": ["supports", "extends", "tutorial", "overview", "reference"]
                },
                "anchor": {
                    "type": "string",
                    "minLength": 5,
                    "maxLength": 120,
                    "description": "Suggested link text for AI citation (v1.2.0)."
                }
            }
        },
        "breadcrumbItem": {
            "type": "object",
            "additionalProperties": false,
            "required": ["name", "url"],
            "properties": {
                "name": { "type": "string", "minLength": 1 },
                "url": { "type": "string", "format": "uri" }
            }
        },
        "action": {
            "type": "object",
            "additionalProperties": false,
            "required": ["action", "label", "url"],
            "properties": {
                "action": {
                    "type": "string",
                    "enum": ["scan", "deploy", "readDocs", "contact", "pricing"]
                },
                "label": { "type": "string", "minLength": 1 },
                "url": { "type": "string", "format": "uri" }
            }
        },
        "faqQuestion": {
            "type": "object",
            "additionalProperties": false,
            "required": ["@type", "name", "acceptedAnswer"],
            "properties": {
                "@type": { "type": "string", "const": "Question" },
                "name": { "type": "string", "minLength": 1 },
                "acceptedAnswer": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": ["@type", "text"],
                    "properties": {
                        "@type": { "type": "string", "const": "Answer" },
                        "text": { "type": "string", "minLength": 1 }
                    }
                }
            }
        }
    }
}