Skip to content

Technical Instruction: The UTM-V2.1 Universal Bridge

Subject: Deploying and Extending Polymorphic Situational Awareness Maps

Status: Field Tested & Stable (27 Dec 2025)

1. Executive Summary

The Universal Bridge is a single-file HTML/JavaScript implementation of the Unified Tactical Mesh (UTM). It is designed for "zero-retrofit" deployment, allowing the same code to adapt its interface, logic, and alert thresholds based on whether it detects Maritime (AIS) or Kinetic (Conflict) data patterns.

2. Component Requirements

  1. index.html: The V2.1 Universal Bridge logic.
  2. data.json: A standardized data object containing coordinate-based event or vessel data.

3. Contributor Guidance: Extending the Bridge

The strength of the UTM is its ability to "leak" information through distributed sensing. We invite contributors to submit new Domain Definitions to the Codeberg repository.

3.1 How to Add a New Sensor Domain

To add a new domain (e.g., "Traffic," "Power Grid," or "Seismic"), follow the Three-Key Protocol:

  1. Identify the Anchor Key: Choose a unique field name in your JSON that identifies the data type (e.g., traffic_density or megawatts).
  2. Define the Threshold: Determine the 2$\sigma$ (standard deviation) baseline for an anomaly (e.g., "Load Drop > 40%").
  3. Submit a Pull Request: Add your logic to the initMesh() detection block:
// Example: Adding Power Grid Monitoring
const isPowerGrid = data.some(d => d.substation_id);
if (isPowerGrid) {
    domain = 'INFRASTRUCTURE';
    threshold = 40; // Alert on 40% load drop
}

3.2 Code of Conduct for Contributors

  • Privacy First: Do not submit sensors that track individuals or private data. Only public, "leaked" API signals are permitted.
  • Observational Only: Ensure your visualization does not imply attribution or suggest operational actions. We show what changed, not who did it.
  • Resilience Testing: All new sensors must fail gracefully. If the data key is missing, the bridge must continue to render other active layers.

4. Deployment Instructions (The 10-Minute Method)

  1. Fork the repository at Codeberg.org/resilience.
  2. Standardize your data into a data.json file in the root directory.
  3. Launch: Open index.html. The bridge will automatically detect your domain and begin logging tripwire events in the UI.

"If you break it, you keep all the pieces. If you improve it, the mesh grows stronger."