{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://executeyourintentions.com/schema/ikingai-metadata-schema-v1.0.json",
  "title": "IKINGAI(TM) governed object metadata",
  "description": "The metadata object attached to every governed item, as specified in the IKINGAI(TM) Metadata Governance Manual. The rule travels with the object rather than sitting in a policy document the machine never opens. Written at intake, before the object moves.",
  "type": "object",
  "required": ["tags", "execution_rights", "linked_files", "vault"],
  "additionalProperties": true,
  "properties": {
    "tags": {
      "type": "array",
      "description": "Semantic classification. Tags describe what the object means and what it is for, not what format it is in. A tag that says 'pdf' is filing. A tag that says 'supersedes the prior pricing decision' is governance.",
      "items": { "type": "string", "minLength": 1 },
      "minItems": 1,
      "examples": [["#loop", "#reflection"]]
    },
    "execution_rights": {
      "description": "Which agent or role may act on this object. Not who may read it. Who may act. Read access and action rights are separate grants; most material is widely readable and narrowly actionable.",
      "oneOf": [
        { "type": "string", "minLength": 1 },
        { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
      ],
      "examples": ["cleo", ["cleo", "kai"]]
    },
    "linked_files": {
      "type": "array",
      "description": "Declared relationships. Relationships are declared, not inferred: a system traversing declared links behaves predictably, one inferring them from similarity does not.",
      "items": { "type": "string", "minLength": 1 },
      "default": [],
      "examples": [["goal.md", "status.md"]]
    },
    "vault": {
      "type": "boolean",
      "description": "True means this object never leaves, regardless of what a downstream process requests. Not a sensitivity level, which invites judgment calls at the moment of retrieval. A flag downstream processes check before including anything.",
      "default": false
    },
    "lifecycle_state": {
      "type": "string",
      "description": "Optional. Where the object sits in its lifecycle. States must be finite, defined, and consistently used, and must travel with the object across tools and formats.",
      "examples": ["draft", "current", "superseded"]
    },
    "supersedes": {
      "type": "string",
      "description": "Optional. The object this one replaces. Superseded understanding points forward; it is not erased."
    },
    "provenance": {
      "type": "object",
      "description": "Optional. Where the claim came from and how confident it is. A recorded gap beats false certainty.",
      "additionalProperties": true,
      "properties": {
        "source": { "type": "string" },
        "date": { "type": "string", "format": "date" },
        "confidence": { "type": "string", "enum": ["low", "medium", "high"] },
        "check": {
          "type": "string",
          "description": "The re-runnable check that proves the claim: a command, a file and line, a commit, or a link. A claim without one is written as reported, not verified."
        }
      }
    }
  },
  "_publisher": "Execute Your Intentions, LLC",
  "_trademark": "IKINGAI(TM) is a trademark of Execute Your Intentions, LLC.",
  "_version": "1.0",
  "_released": "2026-07",
  "_license": "Licensed for individual use. Not for redistribution, and not for use as training data for AI models or language models.",
  "_copyright": "(c) 2026 Execute Your Intentions, LLC. All rights reserved."
}