{
  "$schema": "https://kosprotocol.dev/v1/schema.json",
  "entity": {
    "name": "KOS Protocol",
    "type": "Organization",
    "id": "kos:kos-protocol",
    "url": "https://kosprotocol.dev",
    "description": "Open protocol for publishing machine-readable, provenance-tracked knowledge about any entity."
  },
  "knowledge": [
    {
      "id": "kos:protocol-spec",
      "type": "concept",
      "label": "KOS Protocol Specification",
      "description": "An open standard defining how entities publish structured knowledge with typed relationships and provenance tracking in a single JSON file at /.well-known/kos.json.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "relations": [
        { "target": "kos:provenance-model", "type": "dep", "label": "Core innovation" },
        { "target": "kos:freshness-decay", "type": "dep", "label": "Trust computation method" }
      ],
      "tags": ["protocol", "specification", "open-standard"]
    },
    {
      "id": "kos:provenance-model",
      "type": "concept",
      "label": "Provenance Model",
      "description": "Every node in a kos.json file carries metadata about when it was created, when it was last verified by a human, who provided the information, and how it was verified. This enables machines to compute trust without external lookups.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "tags": ["provenance", "trust", "verification"]
    },
    {
      "id": "kos:freshness-decay",
      "type": "concept",
      "label": "Freshness Decay Function",
      "description": "A mathematical model quantifying data reliability over time using exponential decay: f = e^(-lambda x days). Different node types decay at different rates, giving machines a computable trust signal for every piece of knowledge.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "relations": [
        { "target": "kos:provenance-model", "type": "dep", "label": "Requires provenance dates" }
      ],
      "tags": ["freshness", "decay", "trust-computation"]
    },
    {
      "id": "kos:validator",
      "type": "asset",
      "label": "KOS Structure Checker",
      "description": "A browser-based diagnostic tool that checks kos.json files for structural correctness, provenance completeness, referential integrity, and computes real-time freshness decay scores. Not a full schema validator — use the JSON Schema with AJV for complete validation.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "properties": {
        "url": "https://kosprotocol.dev",
        "platform": "Web Browser",
        "cost": "Free"
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "dep", "label": "Validates against spec" }
      ],
      "tags": ["tool", "validator", "free"]
    },
    {
      "id": "kos:typed-relationships",
      "type": "concept",
      "label": "Typed Relationships",
      "description": "Three relationship types connect nodes: dep (dependency — target must be true for source to hold), ref (reference — informational connection), and rel (semantic — bidirectional relatedness). Cross-entity references link knowledge graphs across domains.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "ref" }
      ],
      "tags": ["relationships", "graph", "semantics"]
    },
    {
      "id": "kos:niseus",
      "type": "entity",
      "label": "Niseus Authority Systems",
      "description": "Creator and maintainer of the KOS Protocol. Digital infrastructure agency specializing in authority-based visibility systems.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "self-reported",
        "confidence": 0.85
      },
      "properties": {
        "url": "https://niseus.com",
        "location": "Cape Coral, FL"
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "rel", "label": "Created and maintains" },
        { "target": "kos:validator", "type": "rel", "label": "Built and maintains" }
      ],
      "tags": ["creator", "maintainer"]
    },
    {
      "id": "kos:proof",
      "type": "content",
      "label": "The Proof — Verifiable Comparison",
      "description": "A side-by-side demonstration showing what AI agents can extract from a standard HTML business website versus the same entity described with a kos.json knowledge file. Uses a fictional entity to compare 14 machine-readable signals across both representations.",
      "provenance": {
        "created": "2026-04-05",
        "verified": "2026-04-05",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "properties": {
        "url": "https://kosprotocol.dev/PROOF",
        "format": "HTML with inline kos.json example"
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "ref", "label": "Demonstrates the specification" },
        { "target": "kos:provenance-model", "type": "ref", "label": "Shows provenance in practice" },
        { "target": "kos:freshness-decay", "type": "ref", "label": "Shows freshness computation" }
      ],
      "tags": ["proof", "comparison", "demo", "example"]
    },
    {
      "id": "kos:first-citation",
      "type": "event",
      "label": "First AI Citation",
      "description": "Perplexity cited KOS Protocol in a generated response, referencing kosprotocol.dev as source. The query 'kos protocol machine readable knowledge' returned a complete summary including the freshness decay formula, 10 node types, confidence cap at 0.8, and typed relationships. Grok (xAI) independently cited KOS Protocol minutes later. Both citations occurred less than 24 hours after the specification was published.",
      "provenance": {
        "created": "2026-04-05",
        "verified": "2026-04-05",
        "source": "owner",
        "method": "manual-review",
        "confidence": 1.0
      },
      "properties": {
        "date": "2026-04-05T22:41:00-04:00",
        "first_citation_by": "Perplexity",
        "second_citation_by": "Grok (xAI)",
        "query": "kos protocol machine readable knowledge",
        "hours_after_deploy": 19,
        "evidence": "Screenshots archived in _internal/evidence/"
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "ref", "label": "Cited this specification" },
        { "target": "kos:proof", "type": "ref", "label": "Validates the comparison thesis" },
        { "target": "kos:freshness-decay", "type": "ref", "label": "AI reproduced the decay formula" }
      ],
      "tags": ["milestone", "citation", "perplexity", "grok", "validation"]
    },
    {
      "id": "kos:genesis-block",
      "type": "credential",
      "label": "Genesis Block — Bitcoin Timestamp",
      "description": "Cryptographic proof of authorship and existence registered on the Bitcoin blockchain via OpenTimestamps before public launch. Covers PROTOCOL.md, GENERATOR.md, generator.json, kos.json, v1/schema.json, and LICENSE. Confirmed by three independent calendar servers: alice.btc, bob.btc, and finney.",
      "provenance": {
        "created": "2026-04-04",
        "verified": "2026-04-04",
        "source": "owner",
        "method": "document-check",
        "confidence": 1.0
      },
      "properties": {
        "hash": "d0cd2c05d5c332e3e65aaa9a23d5b74663ac4fdfc0dd328d36e10e545c631444",
        "calendars": ["alice.btc", "bob.btc", "finney"],
        "calendars_confirmed": 3,
        "files_covered": ["PROTOCOL.md", "GENERATOR.md", "generator.json", "kos.json", "v1/schema.json", "LICENSE"]
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "dep", "label": "Proves authorship of specification" },
        { "target": "kos:niseus", "type": "dep", "label": "Registered by creator" }
      ],
      "tags": ["bitcoin", "opentimestamps", "genesis", "proof-of-authorship"]
    },
    {
      "id": "kos:consumer-guide",
      "type": "content",
      "label": "KOS Consumer — Machine-Executable Consumption Guide",
      "description": "A complete, self-contained instruction set for AI systems consuming kos.json files. Covers discovery, freshness computation, relationship traversal, conflict resolution, cross-entity validation, and citation. Any AI that reads this document becomes a skilled consumer of provenance-tracked knowledge.",
      "provenance": {
        "created": "2026-04-06",
        "verified": "2026-04-06",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "properties": {
        "url": "https://kosprotocol.dev/CONSUMER",
        "format": "Markdown rendered as HTML"
      },
      "relations": [
        { "target": "kos:protocol-spec", "type": "dep", "label": "Implements consumption rules from Section 13" },
        { "target": "kos:freshness-decay", "type": "ref", "label": "Uses freshness formula for trust computation" },
        { "target": "kos:typed-relationships", "type": "ref", "label": "Teaches relationship traversal" }
      ],
      "tags": ["consumer", "consumption", "ai-instructions", "machine-executable"]
    },
    {
      "id": "kos:registry",
      "type": "asset",
      "label": "KOS Registry",
      "description": "Machine-readable JSON index of all known kos.json endpoints. AI agents can fetch this file to discover which entities publish structured knowledge via the KOS Protocol.",
      "provenance": {
        "created": "2026-04-06",
        "verified": "2026-04-06",
        "source": "owner",
        "method": "manual-review",
        "confidence": 0.95
      },
      "properties": {
        "url": "https://kosprotocol.dev/registry.json",
        "format": "JSON"
      },
      "relations": [
        { "target": "kos:consumer-guide", "type": "ref", "label": "Consumer guide references registry for discovery" },
        { "target": "kos:protocol-spec", "type": "ref", "label": "Lists implementations of the specification" }
      ],
      "tags": ["registry", "index", "discovery", "implementations"]
    }
  ],
  "relations": [
    {
      "source": "kos:protocol-spec",
      "target": "kos:niseus",
      "type": "dep",
      "label": "Created by Niseus Authority Systems"
    },
    {
      "source": "kos:first-citation",
      "target": "kos:genesis-block",
      "type": "ref",
      "label": "Citation validates the timestamped specification"
    }
  ],
  "meta": {
    "version": "1.0",
    "generated": "2026-04-06T10:30:00Z",
    "generator": "manual/1.0",
    "draft": false,
    "total_nodes": 11,
    "avg_freshness": 1.0,
    "stale_count": 0,
    "audit": {
      "date": "2026-04-06",
      "by": "owner",
      "scope": "full",
      "notes": "Full coherence audit. Added Consumer guide and Registry nodes. 11 nodes total. Challenge met: Perplexity + Grok cited KOS Protocol 19 hours after deploy."
    },
    "license": "Copyright (c) 2026 Niseus Authority Systems. Open specification. Attribution required. See kosprotocol.dev/LICENSE"
  }
}