{
  "$schema":  "https://json-schema.org/draft/2020-12/schema",
  "$id":      "https://www.triadicframeworks.org/schemas/rttcode.v1.json",
  "$comment": "Canonical RTTcode packet schema — TriadicFrameworks. Refreshed 2026-05-06 to align with /docs/rtt/codes/ module migration and session context conventions.",
 
  "title":       "RTTcode Packet (v1)",
  "description": "Master RTTcode packet schema composed of tick, entities, environment, and intent blocks. Defines the canonical payload structure for QR-compatible metadata identifiers across all TriadicFrameworks domains.",
 
  "_meta": {
    "module":          "RTT/codes",
    "canonical_id":    "RTT_CODES",
    "module_type":     "Infrastructure-Schema",
    "role":            "engine",
    "version":         "1.1",
    "status":          "canon-stable",
    "author":          "Nawder Loswin",
    "license":         "MIT",
    "canonical_path":  "/docs/schemas/rttcode.v1.json",
    "module_home":     "/docs/rtt/codes/",
    "module_url":      "https://www.triadicframeworks.org/rtt/codes/",
    "module_json":     "https://www.triadicframeworks.org/rtt/codes/RTT_codes_module.json",
    "repository":      "https://github.com/umaywant2/TriadicFrameworks",
    "last_updated":    "2026-05-06",
    "migration_note":  "Module content relocated from /docs/rttcodes/ to /docs/rtt/codes/ — schema location at /docs/schemas/ unchanged. All $ref paths remain valid (relative to schemas directory)."
  },
 
  "_session_context": {
    "canon":       "active (rtt-codes-core)",
    "modules":     "schema → validators → generators → style → examples → domain payloads",
    "drift":       "minimal (metadata-locked)",
    "coherence":   "stable (metadata grammar)",
    "version":     "1.1 (codes-refreshed)",
    "format":      "json-schema + metadata",
    "front_door":  "exists (RTT/codes root)",
    "every_page":  "stands alone + AI-parsable + schema-aware",
    "audience":    "developers + researchers + tool authors + AIs"
  },
 
  "_version_history": [
    {
      "version": "1.0",
      "date":    "2025-01-01",
      "note":    "Initial schema release at /docs/schemas/rttcode.v1.json. Module home at /docs/rttcodes/."
    },
    {
      "version": "1.1",
      "date":    "2026-05-06",
      "note":    "Metadata and session context refresh. Module home migrated to /docs/rtt/codes/. Added _meta, _session_context, _domains, _related_schemas, _version_history. All $ref paths and $id unchanged."
    }
  ],
 
  "_domains": {
    "description": "Recognized RTTcode domain values. Each domain maps to a color palette and artifact classification.",
    "values": [
      "rtt",
      "set",
      "substrate",
      "observer",
      "governance",
      "docs",
      "other"
    ]
  },
 
  "_related_schemas": [
    { "name": "tick.v1.json",         "path": "./tick.v1.json",         "role": "Monotonic tick block" },
    { "name": "entity.v1.json",       "path": "./entity.v1.json",       "role": "Entity participation block" },
    { "name": "environment.v1.json",  "path": "./environment.v1.json",  "role": "Environment context block" },
    { "name": "intent.v1.json",       "path": "./intent.v1.json",       "role": "Intent classification block" }
  ],
 
  "type": "object",
  "additionalProperties": false,
 
  "required": [
    "rtt_version",
    "tick",
    "entities",
    "environment",
    "intent"
  ],
 
  "properties": {
 
    "rtt_version": {
      "type":        "string",
      "const":       "1.0.0",
      "description": "Version of the RTTcode packet schema."
    },
 
    "tick": {
      "$ref":        "./tick.v1.json",
      "description": "Monotonic tick block — discrete time reference for the packet."
    },
 
    "entities": {
      "type":        "array",
      "items":       { "$ref": "./entity.v1.json" },
      "minItems":    1,
      "description": "List of entities participating in the RTT micro‑regime."
    },
 
    "environment": {
      "$ref":        "./environment.v1.json",
      "description": "Environment context block — boundary conditions and observability frame."
    },
 
    "intent": {
      "$ref":        "./intent.v1.json",
      "description": "Intent classification block — purpose and domain routing metadata."
    }
 
  }
}

{
  "$schema":  "https://json-schema.org/draft/2020-12/schema",
  "$id":      "https://triadicframeworks.org/schemas/tick.v1.json",
  "$comment": "RTT Tick sub-schema — refreshed 2026-05-06 to add module metadata and session context.",
 
  "title":       "RTT Tick Block (v1)",
  "description": "Defines the minimal tick substrate for RTTcode packets, representing bounded temporal progression. The tick is the monotonic time anchor of the packet — analogous to D369's monotonic time marker (R4.1).",
 
  "_meta": {
    "module":          "RTT/codes",
    "canonical_id":    "RTT_CODES_TICK",
    "role":            "engine",
    "version":         "1.1",
    "status":          "canon-stable",
    "author":          "Nawder Loswin",
    "license":         "MIT",
    "canonical_path":  "/docs/schemas/tick.v1.json",
    "module_home":     "/docs/rtt/codes/",
    "parent_schema":   "rttcode.v1.json",
    "last_updated":    "2026-05-06"
  },
 
  "_session_context": {
    "canon":       "active (rtt-codes-core)",
    "drift":       "minimal (metadata-locked)",
    "coherence":   "stable (temporal grammar)",
    "audience":    "developers + researchers + tool authors + AIs"
  },
 
  "_version_history": [
    {
      "version": "1.0",
      "date":    "2025-01-01",
      "note":    "Initial tick schema release."
    },
    {
      "version": "1.1",
      "date":    "2026-05-06",
      "note":    "Metadata refresh — added _meta, _session_context, _version_history. No property changes."
    }
  ],
 
  "type": "object",
  "additionalProperties": false,
 
  "required": [
    "tick_version",
    "index",
    "timestamp",
    "coherence"
  ],
 
  "properties": {
 
    "tick_version": {
      "type":        "string",
      "const":       "1.0.0",
      "description": "Version of the tick schema."
    },
 
    "index": {
      "type":        "integer",
      "minimum":     0,
      "description": "Monotonic tick counter within the packet sequence. Must be non-decreasing across consecutive packets."
    },
 
    "timestamp": {
      "type":        "string",
      "format":      "date-time",
      "description": "ISO 8601 timestamp marking the tick's occurrence. Serves as the wall-clock anchor for the monotonic index."
    },
 
    "coherence": {
      "type":        "number",
      "minimum":     0,
      "maximum":     1,
      "description": "Coherence score for the tick (0.0–1.0), representing temporal stability within the current micro-regime."
    }
 
  }
}

{
  "$schema":  "https://json-schema.org/draft/2020-12/schema",
  "$id":      "https://triadicframeworks.org/schemas/entity.v1.json",
  "$comment": "RTT Entity sub-schema — refreshed 2026-05-06 to add module metadata and session context.",
 
  "title":       "RTT Entity Block (v1)",
  "description": "Defines a minimal entity substrate for RTTcode packets, including identity, micro-state, and resonance alignment. Entities are the participants in a micro-regime — analogous to D369's major functional blocks with source identity (R5.1).",
 
  "_meta": {
    "module":          "RTT/codes",
    "canonical_id":    "RTT_CODES_ENTITY",
    "role":            "engine",
    "version":         "1.1",
    "status":          "canon-stable",
    "author":          "Nawder Loswin",
    "license":         "MIT",
    "canonical_path":  "/docs/schemas/entity.v1.json",
    "module_home":     "/docs/rtt/codes/",
    "parent_schema":   "rttcode.v1.json",
    "last_updated":    "2026-05-06"
  },
 
  "_session_context": {
    "canon":       "active (rtt-codes-core)",
    "drift":       "minimal (metadata-locked)",
    "coherence":   "stable (entity grammar)",
    "audience":    "developers + researchers + tool authors + AIs"
  },
 
  "_version_history": [
    {
      "version": "1.0",
      "date":    "2025-01-01",
      "note":    "Initial entity schema release."
    },
    {
      "version": "1.1",
      "date":    "2026-05-06",
      "note":    "Metadata refresh — added _meta, _session_context, _version_history. No property changes."
    }
  ],
 
  "type": "object",
  "additionalProperties": false,
 
  "required": [
    "entity_version",
    "id",
    "state",
    "resonance"
  ],
 
  "properties": {
 
    "entity_version": {
      "type":        "string",
      "const":       "1.0.0",
      "description": "Version of the entity schema."
    },
 
    "id": {
      "type":        "string",
      "description": "Unique identifier for the entity. Serves as the source identity within the RTTcode packet — must be stable across the entity's lifecycle."
    },
 
    "state": {
      "type":        "object",
      "description": "Current micro-state of the entity — the observable scalar snapshot at this tick.",
      "additionalProperties": false,
      "required": ["value"],
      "properties": {
        "value": {
          "type":        "number",
          "description": "Primary scalar representing the entity's micro-state at the current tick."
        }
      }
    },
 
    "resonance": {
      "type":        "object",
      "description": "Resonance alignment parameters — how the entity couples to the micro-regime's oscillatory substrate.",
      "additionalProperties": false,
      "required": ["amplitude", "phase"],
      "properties": {
        "amplitude": {
          "type":        "number",
          "description": "Resonance amplitude of the entity. Higher values indicate stronger coupling."
        },
        "phase": {
          "type":        "number",
          "description": "Resonance phase of the entity (radians or normalized). Determines alignment relative to other entities."
        }
      }
    }
 
  }
}

{
  "$schema":  "https://json-schema.org/draft/2020-12/schema",
  "$id":      "https://triadicframeworks.org/schemas/environment.v1.json",
  "$comment": "RTT Environment sub-schema — refreshed 2026-05-06 to add module metadata and session context.",
 
  "title":       "RTT Environment Block (v1)",
  "description": "Minimal environment substrate for RTTcode packets. Defines boundary conditions, ambient parameters, and drift thresholds required for coherent micro-regime evaluation. The environment is the observability frame — analogous to D369's structural boundary context.",
 
  "_meta": {
    "module":          "RTT/codes",
    "canonical_id":    "RTT_CODES_ENVIRONMENT",
    "role":            "engine",
    "version":         "1.1",
    "status":          "canon-stable",
    "author":          "Nawder Loswin",
    "license":         "MIT",
    "canonical_path":  "/docs/schemas/environment.v1.json",
    "module_home":     "/docs/rtt/codes/",
    "parent_schema":   "rttcode.v1.json",
    "last_updated":    "2026-05-06"
  },
 
  "_session_context": {
    "canon":       "active (rtt-codes-core)",
    "drift":       "minimal (metadata-locked)",
    "coherence":   "stable (environment grammar)",
    "audience":    "developers + researchers + tool authors + AIs"
  },
 
  "_version_history": [
    {
      "version": "1.0",
      "date":    "2025-01-01",
      "note":    "Initial environment schema release."
    },
    {
      "version": "1.1",
      "date":    "2026-05-06",
      "note":    "Metadata refresh — added _meta, _session_context, _version_history. No property changes."
    }
  ],
 
  "type": "object",
  "additionalProperties": false,
 
  "required": [
    "environment_version",
    "boundary",
    "ambient",
    "drift"
  ],
 
  "properties": {
 
    "environment_version": {
      "type":        "string",
      "const":       "1.0.0",
      "description": "Version of the environment schema."
    },
 
    "boundary": {
      "type":        "object",
      "description": "Structural limits within which micro-regimes operate. Values outside the boundary indicate regime collapse.",
      "additionalProperties": false,
      "required": ["min", "max"],
      "properties": {
        "min": {
          "type":        "number",
          "description": "Lower bound of the environment's allowable state space."
        },
        "max": {
          "type":        "number",
          "description": "Upper bound of the environment's allowable state space."
        }
      }
    },
 
    "ambient": {
      "type":        "object",
      "description": "Ambient conditions that influence resonance coupling and timing stability.",
      "additionalProperties": false,
      "required": ["temperature", "noise"],
      "properties": {
        "temperature": {
          "type":        "number",
          "description": "Ambient temperature or analogous scalar affecting micro-state stability. Higher values increase drift susceptibility."
        },
        "noise": {
          "type":        "number",
          "description": "Environmental noise level affecting drift accumulation. Measured in the same units as the drift threshold."
        }
      }
    },
 
    "drift": {
      "type":        "object",
      "description": "Drift thresholds and accumulation parameters. Drift is the silent structural degradation that D369 makes observable.",
      "additionalProperties": false,
      "required": ["max_drift", "accumulation_rate"],
      "properties": {
        "max_drift": {
          "type":        "number",
          "description": "Maximum allowable drift before coherence collapse. Exceeding this value signals regime transition."
        },
        "accumulation_rate": {
          "type":        "number",
          "description": "Rate at which drift accumulates under current ambient conditions. Units per tick."
        }
      }
    }
 
  }
}

{
  "$schema":  "https://json-schema.org/draft/2020-12/schema",
  "$id":      "https://triadicframeworks.org/schemas/intent.v1.json",
  "$comment": "RTT Intent sub-schema — refreshed 2026-05-06 to add module metadata and session context.",
 
  "title":       "RTT Intent Block (v1)",
  "description": "Defines the minimal intent substrate for RTTcode packets, capturing directional influence and desired micro-state adjustments. Intent expresses what an agent wants to happen — it does not prescribe behavior, consistent with D369's non-claim NC-5.",
 
  "_meta": {
    "module":          "RTT/codes",
    "canonical_id":    "RTT_CODES_INTENT",
    "role":            "engine",
    "version":         "1.1",
    "status":          "canon-stable",
    "author":          "Nawder Loswin",
    "license":         "MIT",
    "canonical_path":  "/docs/schemas/intent.v1.json",
    "module_home":     "/docs/rtt/codes/",
    "parent_schema":   "rttcode.v1.json",
    "last_updated":    "2026-05-06"
  },
 
  "_session_context": {
    "canon":       "active (rtt-codes-core)",
    "drift":       "minimal (metadata-locked)",
    "coherence":   "stable (intent grammar)",
    "audience":    "developers + researchers + tool authors + AIs"
  },
 
  "_version_history": [
    {
      "version": "1.0",
      "date":    "2025-01-01",
      "note":    "Initial intent schema release."
    },
    {
      "version": "1.1",
      "date":    "2026-05-06",
      "note":    "Metadata refresh — added _meta, _session_context, _version_history. No property changes."
    }
  ],
 
  "type": "object",
  "additionalProperties": false,
 
  "required": [
    "intent_version",
    "target",
    "direction",
    "magnitude"
  ],
 
  "properties": {
 
    "intent_version": {
      "type":        "string",
      "const":       "1.0.0",
      "description": "Version of the intent schema."
    },
 
    "target": {
      "type":        "string",
      "description": "The entity or subsystem the intent is directed toward. Must match an entity id within the same RTTcode packet."
    },
 
    "direction": {
      "type":        "string",
      "enum":        ["increase", "decrease", "stabilize", "invert"],
      "description": "Desired directional influence on the target. 'stabilize' resists drift; 'invert' reverses current trajectory."
    },
 
    "magnitude": {
      "type":        "number",
      "description": "Strength of the intended influence. Scale is relative to the environment's boundary range."
    }
 
  }
}