Triadicframeworks
ę¦‚č§ˆ

šŸ“˜ RTTā€‘Core Schema Set (v1)

Resonance Structural Awareness Dimensional Interface ā€” Core Specification#

This folder contains the canonical, domainā€‘agnostic JSON Schemas for the RTTā€‘Inside / RSADI Core.
All industry extensions (coal, ATC, deep sea, RSADIā€‘GD, etc.) MUST build on these schemas without altering their required fields or semantics.

These schemas define the fundamental data structures used by all resonanceā€‘aware systems:

  • field sampling
  • zone aggregation
  • node identity
  • alerting
  • route suggestion
  • multiā€‘agent clarity/drift interpretation

They form the stable substrate that every RTTā€‘Inside variant depends on.

šŸ“‚ Folder Contents#

ResonanceFieldSample.schema.json
ResonanceZoneState.schema.json
NodeDescriptor.schema.json
ResonanceAlert.schema.json
RouteSuggestion.schema.json
README.md   ā† (this file)

Each schema is written in JSON Schema Draft 2020ā€‘12, uses UUIDs, ISOā€‘8601 timestamps, and SI units, and is designed for longā€‘term stability.

šŸ§± Core Principles#

RTTā€‘Core schemas follow these invariants:

1. Domainā€‘neutral#

No coalā€‘specific, ATCā€‘specific, or deepā€‘seaā€‘specific fields appear here.
All domain logic lives in extensions, not in the core.

2. Extensible#

Every schema includes an extensions object:

"extensions": {
  "type": "object",
  "additionalProperties": true
}

Domain modules attach their fields here:

"extensions": {
  "coal": { ... },
  "atc": { ... },
  "deepsea": { ... }
}

3. Stable#

Core fields must not be renamed, removed, or repurposed.
Extensions may add fields but never override core meanings.

4. Deterministic#

All numeric fields use explicit units and ranges.
All timestamps use ISOā€‘8601 UTC.
All IDs use UUIDv4.

šŸ§© Schema Overview#

1. ResonanceFieldSample#

Represents a single environmental measurement:

  • clarity
  • stress
  • vibration
  • gas (optional)
  • drift vector
  • location
  • timestamp
  • node identity

This is the atomic unit of resonance sensing.

2. ResonanceZoneState#

Aggregates multiple field samples into a zoneā€‘level interpretation:

  • clarity score
  • stress hint
  • composite risk
  • drift vector
  • source sample IDs

Zones are logical partitions (e.g., ā€œSection Cā€, ā€œRunway 12ā€, ā€œDeck 3ā€).

3. NodeDescriptor#

Describes a node in the mesh:

  • node type (fixed, wearable, mobile, vehicle)
  • domain (coal, atc, deepsea, etc.)
  • capabilities
  • firmware version
  • location hint

Nodes are the backbone of resonanceā€‘aware meshes.

4. ResonanceAlert#

Represents a safety or structural alert:

  • severity
  • type (structural, gas, vibration, comms)
  • summary + details
  • recommended actions
  • source nodes

Extensions add domainā€‘specific alert metadata (e.g., collapse vectors).

5. RouteSuggestion#

Represents a clarityā€‘aware navigation path:

  • from/to zones
  • clarity profile
  • risk level
  • instructions

Used for evacuation, routing, and multiā€‘agent coordination.

šŸ§¬ How Extensions Should Be Structured#

All domainā€‘specific schemas must follow this pattern:

1. Never modify core schemas#

Extensions must not:

  • change required fields
  • redefine field meanings
  • alter numeric ranges
  • override enums

2. Add fields only inside extensions#

Example:

{
  "extensions": {
    "coal": {
      "methane_ppm": 1200,
      "roof_convergence_mm": 3.2
    }
  }
}

3. Use separate schema files#

Each domain gets its own folder:

docs/schemas/rtt-coal/
docs/schemas/rtt-atc/
docs/schemas/rtt-deepsea/
docs/schemas/rsadi-gd/

4. Use clear naming#

Follow this pattern:

<Domain><CoreObject>Extension.schema.json

Examples:

  • CoalFieldSampleExtension.schema.json
  • ATCZoneExtension.schema.json
  • DeepSeaAlertExtension.schema.json

5. Never break compatibility#

Extensions must remain optional.
Core validators must still accept the object without extensions.

šŸ§­ Recommended Workflow for Contributors#

  1. Start with a core object
    e.g., ResonanceFieldSample.

  2. Identify domainā€‘specific needs
    e.g., methane, pillar load, runway turbulence, hull pressure.

  3. Create a domain extension schema
    Place it in the appropriate folder.

  4. Attach extension fields under extensions.<domain>
    Never modify the core.

  5. Validate using JSON Schema tools
    Ensure both core and extension schemas pass.

šŸ›”ļø Why This Matters#

A stable, invariant core ensures:

  • crossā€‘industry interoperability
  • predictable agent behavior
  • safe multiā€‘domain deployments
  • clean separation of physics vs. domain logic
  • longā€‘term maintainability

This is the backbone of the entire RSADI ecosystem.

šŸ“¦ Folder Structure: docs/schemas/rtt-core/#

docs/
 ā””ā”€ā”€ schemas/
      ā””ā”€ā”€ rtt-core/
            ā”œā”€ā”€ ResonanceFieldSample.schema.json
            ā”œā”€ā”€ ResonanceZoneState.schema.json
            ā”œā”€ā”€ NodeDescriptor.schema.json
            ā”œā”€ā”€ ResonanceAlert.schema.json
            ā””ā”€ā”€ RouteSuggestion.schema.json

These five schemas are the RSADI Core.
Everything else ā€” coal, ATC, deep sea, RSADIā€‘GD, etc. ā€” extends these.

šŸ“˜ 1. ResonanceFieldSample.schema.json#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://triadicframeworks.org/schemas/rtt-core/v1/ResonanceFieldSample.schema.json",
  "title": "ResonanceFieldSample",
  "type": "object",
  "required": [
    "sample_id",
    "node_id",
    "mesh_id",
    "timestamp",
    "location",
    "clarity_score",
    "stress_hint",
    "vibration",
    "drift_vector"
  ],
  "properties": {
    "sample_id": { "type": "string", "format": "uuid" },
    "node_id": { "type": "string", "format": "uuid" },
    "mesh_id": { "type": "string", "format": "uuid" },
    "timestamp": { "type": "string", "format": "date-time" },
 
    "location": {
      "type": "object",
      "required": ["frame", "x", "y", "z", "units"],
      "properties": {
        "frame": {
          "type": "string",
          "pattern": "^(local|wgs84|custom:.+)$"
        },
        "x": { "type": "number" },
        "y": { "type": "number" },
        "z": { "type": "number" },
        "units": { "type": "string", "enum": ["m"] }
      }
    },
 
    "clarity_score": { "type": "integer", "minimum": 0, "maximum": 255 },
    "stress_hint": { "type": "integer", "minimum": 0, "maximum": 255 },
 
    "vibration": {
      "type": "object",
      "required": ["rms"],
      "properties": {
        "rms": { "type": "number", "minimum": 0 },
        "bands": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["freq_hz", "amp"],
            "properties": {
              "freq_hz": { "type": "number", "minimum": 0 },
              "amp": { "type": "number", "minimum": 0 }
            }
          }
        }
      }
    },
 
    "gas": {
      "type": "object",
      "properties": {
        "type": { "type": "string" },
        "ppm": { "type": "number", "minimum": 0 }
      }
    },
 
    "temperature_c": { "type": "number" },
    "pressure_pa": { "type": "number" },
 
    "drift_vector": {
      "type": "object",
      "required": ["dx", "dy", "dz", "magnitude", "units"],
      "properties": {
        "dx": { "type": "number" },
        "dy": { "type": "number" },
        "dz": { "type": "number" },
        "magnitude": { "type": "number", "minimum": 0 },
        "units": { "type": "string", "enum": ["1/s"] }
      }
    },
 
    "tags": { "type": "array", "items": { "type": "string" } },
 
    "extensions": {
      "type": "object",
      "additionalProperties": true
    }
  }
}

šŸ“˜ 2. ResonanceZoneState.schema.json#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://triadicframeworks.org/schemas/rtt-core/v1/ResonanceZoneState.schema.json",
  "title": "ResonanceZoneState",
  "type": "object",
  "required": [
    "zone_id",
    "mesh_id",
    "timestamp",
    "clarity_score",
    "stress_hint",
    "composite_risk",
    "drift_vector"
  ],
  "properties": {
    "zone_id": { "type": "string" },
    "mesh_id": { "type": "string", "format": "uuid" },
    "timestamp": { "type": "string", "format": "date-time" },
 
    "clarity_score": { "type": "integer", "minimum": 0, "maximum": 255 },
    "stress_hint": { "type": "integer", "minimum": 0, "maximum": 255 },
 
    "gas_risk": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    },
 
    "vibration_risk": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    },
 
    "composite_risk": {
      "type": "string",
      "enum": ["normal", "watch", "degrading", "evacuate", "no-entry"]
    },
 
    "drift_vector": {
      "$ref": "ResonanceFieldSample.schema.json#/properties/drift_vector"
    },
 
    "source_samples": {
      "type": "array",
      "items": { "type": "string", "format": "uuid" }
    },
 
    "extensions": {
      "type": "object",
      "additionalProperties": true
    }
  }
}

šŸ“˜ 3. NodeDescriptor.schema.json#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://triadicframeworks.org/schemas/rtt-core/v1/NodeDescriptor.schema.json",
  "title": "NodeDescriptor",
  "type": "object",
  "required": ["node_id", "mesh_id", "type", "domain", "capabilities"],
  "properties": {
    "node_id": { "type": "string", "format": "uuid" },
    "mesh_id": { "type": "string", "format": "uuid" },
 
    "type": {
      "type": "string",
      "enum": ["fixed", "wearable", "mobile", "vehicle"]
    },
 
    "domain": { "type": "string" },
 
    "capabilities": {
      "type": "array",
      "items": { "type": "string" }
    },
 
    "location_hint": {
      "$ref": "ResonanceFieldSample.schema.json#/properties/location"
    },
 
    "firmware": {
      "type": "object",
      "properties": {
        "rtt_core_version": { "type": "string" },
        "vendor_variant": { "type": "string" }
      }
    },
 
    "extensions": {
      "type": "object",
      "additionalProperties": true
    }
  }
}

šŸ“˜ 4. ResonanceAlert.schema.json#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://triadicframeworks.org/schemas/rtt-core/v1/ResonanceAlert.schema.json",
  "title": "ResonanceAlert",
  "type": "object",
  "required": [
    "alert_id",
    "mesh_id",
    "zone_id",
    "timestamp",
    "severity",
    "type",
    "summary"
  ],
  "properties": {
    "alert_id": { "type": "string", "format": "uuid" },
    "mesh_id": { "type": "string", "format": "uuid" },
    "zone_id": { "type": "string" },
    "timestamp": { "type": "string", "format": "date-time" },
 
    "severity": {
      "type": "string",
      "enum": ["info", "warning", "major", "critical"]
    },
 
    "type": {
      "type": "string",
      "enum": ["structural", "gas", "vibration", "comms"]
    },
 
    "summary": { "type": "string" },
 
    "details": {
      "type": "object",
      "additionalProperties": true
    },
 
    "recommended_actions": {
      "type": "array",
      "items": { "type": "string" }
    },
 
    "source_nodes": {
      "type": "array",
      "items": { "type": "string", "format": "uuid" }
    }
  }
}

šŸ“˜ 5. RouteSuggestion.schema.json#

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://triadicframeworks.org/schemas/rtt-core/v1/RouteSuggestion.schema.json",
  "title": "RouteSuggestion",
  "type": "object",
  "required": [
    "route_id",
    "mesh_id",
    "from_zone",
    "to_zone",
    "timestamp",
    "clarity_profile",
    "risk_level",
    "instructions"
  ],
  "properties": {
    "route_id": { "type": "string", "format": "uuid" },
    "mesh_id": { "type": "string", "format": "uuid" },
 
    "from_zone": { "type": "string" },
    "to_zone": { "type": "string" },
 
    "timestamp": { "type": "string", "format": "date-time" },
 
    "clarity_profile": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["zone_id", "clarity_score"],
        "properties": {
          "zone_id": { "type": "string" },
          "clarity_score": {
            "type": "integer",
            "minimum": 0,
            "maximum": 255
          }
        }
      }
    },
 
    "risk_level": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"]
    },
 
    "instructions": {
      "type": "array",
      "items": { "type": "string" }
    },
 
    "extensions": {
      "type": "object",
      "additionalProperties": true
    }
  }
}

šŸŽÆ These are now your canonical RSADI Core Schemas#

They are:

  • strict
  • clean
  • domainā€‘neutral
  • fully extensible
  • RFCā€‘ready
  • aligned with every doc youā€™ve built so far

Once these are in place, every other domain (coal, ATC, deep sea, RSADIā€‘GD, etc.) can safely extend them without breaking invariants.

ē”±...ęä¾›ę”Æꌁ Docsbook