{
  "$schema": "https://json-schema.org/draft-07/schema",
  "name": "PureGuard AI Knowledge Catalog",
  "version": "1.0.0",
  "description": "Domain model for the PureGuard Apparel knowledge catalog. Optimizes PureGuard content for traditional SEO and AI search agents (LLMs, enterprise copilots, autonomous agents).",
  "published": "2026-06-29",
  "publisher": {
    "name": "PureGuard Apparel",
    "url": "https://pureguardapparel.com",
    "contact": "justin@pureguardapparel.com"
  },
  "objectives": [
    "Maximize discoverability by search engines and AI agents",
    "Maximize trust / citation likelihood for LLMs and copilots",
    "Maintain a single source of truth for all customer-facing knowledge",
    "Surface knowledge gaps and content decay with quantitative scores",
    "Make every knowledge asset discoverable, retrievable, and reusable"
  ],
  "domain_model": {
    "KnowledgeAsset": {
      "description": "Any reusable unit of organisational knowledge — document, SOP, policy, FAQ, API doc, dataset, dashboard, prompt, AI workflow, video, report, runbook, garment product, branding technique, FAQ entry, page section, downloadable asset.",
      "properties": {
        "id": {"type": "string", "required": true, "description": "Stable URI slug, e.g. 'ka-ws6070' or 'ka-garment-embroidery-badges'."},
        "type": {"type": "string", "enum": ["garment","branding-technique","page","faq","policy","sop","form","lead-magnet","spec","article","image","video","download","service"], "required": true},
        "title": {"type": "string", "required": true},
        "summary": {"type": "string", "required": true, "description": "1-2 sentence plain-English summary, written for both humans and LLM retrieval."},
        "owner": {"type": "string", "description": "Person or role accountable for this asset."},
        "department": {"type": "string", "enum": ["sales","operations","marketing","branding","logistics","compliance","leadership"]},
        "tags": {"type": "array", "items": {"type": "string"}},
        "keywords": {"type": "array", "items": {"type": "string"}, "description": "Discoverability keywords — search + LLM retrieval."},
        "entities": {"type": "array", "items": {"type": "string"}, "description": "Named entities: products, brands, standards, places."},
        "business_concepts": {"type": "array", "items": {"type": "string"}, "description": "Higher-order concepts this asset relates to."},
        "confidence_score": {"type": "number", "min": 0, "max": 1, "description": "How confident we are in the factual claims. Higher = more quotable."},
        "trust_score": {"type": "number", "min": 0, "max": 1, "description": "Source authority, recency of review, citation depth."},
        "ai_readiness_score": {"type": "number", "min": 0, "max": 1, "description": "Combined retrieval-quality score for LLMs (chunk quality + structure + metadata)."},
        "seo_score": {"type": "number", "min": 0, "max": 1, "description": "Traditional search-engine optimisation score."},
        "geo_score": {"type": "number", "min": 0, "max": 1, "description": "Generative engine optimisation — likelihood that an LLM cites this in its answer."},
        "last_reviewed": {"type": "string", "format": "date"},
        "review_frequency_days": {"type": "integer", "description": "Cadence at which this asset is re-verified."},
        "source_location": {"type": "string", "description": "URI, file path, or external system identifier."},
        "permissions": {"type": "string", "enum": ["public","authenticated","internal","restricted"], "default": "public"},
        "version": {"type": "string", "default": "1.0"},
        "related_assets": {"type": "array", "items": {"type": "string"}, "description": "Array of KnowledgeAsset IDs."}
      }
    },
    "KnowledgeCatalog": {
      "description": "Discovery layer over KnowledgeAssets. Holds metadata, search index entries, graph edges — never the raw documents.",
      "operations": ["search","semantic_search","hybrid_search","vector_search","filter","recommend","traverse"]
    },
    "AIOptimizationEngine": {
      "description": "Scores each asset and produces recommendations.",
      "checks": [
        "readability","completeness","freshness","authority","structure",
        "schema_markup","metadata_quality","duplicate_detection",
        "citation_likelihood","retrieval_quality","chunk_quality_for_rag","embedding_quality"
      ]
    },
    "KnowledgeGraph": {
      "description": "Typed relationships between assets, concepts, teams, products, customers, experts.",
      "edge_types": [
        "related_to","derived_from","supersedes","applies_to",
        "owned_by","authored_by","cites","belongs_to","used_in"
      ]
    },
    "Search": {
      "modes": ["keyword","semantic","hybrid","vector"],
      "filters": ["type","department","permissions","tag","keyword","last_reviewed","score_range"]
    },
    "AIReadinessDashboard": {
      "metrics": [
        "ai_readiness_score","seo_score","geo_score","freshness",
        "citation_probability","knowledge_coverage","duplicate_content",
        "missing_metadata","orphaned_documents","review_status"
      ]
    },
    "Governance": {
      "supports": ["workflows","approvals","ownership","review_reminders","audit_history","permissions","lifecycle"]
    }
  }
}