Skip to content

rasient/operational-systems-intelligence

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Operational Systems Intelligence

AI-assisted operational coordination and sociotechnical systems modeling.

Operational Systems Intelligence is a systems-thinking platform for modeling how information, decisions, authority, dependencies, and execution move through complex systems.

It is designed for exploring organizations, infrastructures, public systems, logistics networks, healthcare systems, AI-human workflows, and multi-system coordination under stress.

The goal is not to build another dashboard.

The goal is to model how systems behave when coordination becomes the bottleneck.


🧠 Part of Systems Lab

This project is the current flagship repository in the broader Systems Lab ecosystem.

Systems Lab is a portfolio of experiments focused on understanding how interconnected systems behave across infrastructure, organizations, AI, governance, energy, water, logistics, and society.

Main ecosystem repo:

https://github.com/rasient/systems-lab

This repository connects several earlier Systems Lab directions into one coherent operational intelligence framework:

  • decision intelligence
  • infrastructure coordination
  • energy system modeling
  • water system modeling
  • governance boundaries
  • signal vs noise analysis
  • AI-assisted runtime modeling
  • sociotechnical systems thinking

Core Idea

Most large-scale failures are not isolated technical failures.

They emerge from coordination breakdowns:

  • important signals arrive too late
  • authority boundaries are unclear
  • dependencies overload critical nodes
  • reports distort operational reality
  • governance slows execution
  • decision latency compounds
  • local optimizations damage the whole system
  • systems remain visible but not governable

Operational Systems Intelligence models these patterns directly.


What This Platform Does

The platform allows you to:

  • generate operational system models
  • visualize dependency graphs
  • simulate signal propagation
  • calculate decision latency
  • identify coordination bottlenecks
  • detect fragility and cascade risk
  • compare reported vs actual system state
  • test governance boundary conditions
  • explore AI-assisted runtime graph generation
  • save scenario history for later comparison

Core Modules

🧠 Signal vs Noise Engine

Models whether important signals survive organizational noise and latency.

Example:

Repeated delayed responses from a critical logistics dependency.

The engine estimates signal integrity, urgency, reliability, importance, propagation loss, and whether a signal is actionable or degraded.


⏱ Decision Latency Simulator

Models how long it takes for decisions or escalations to move through a system.

Example:

What happens if hospital escalation latency doubles?

The simulator analyzes node-level latency, dependency pressure, weighted paths, approval delay, and escalation bottlenecks.


⚑ Fragility Engine

Detects which parts of a system are most structurally fragile.

It considers base fragility, dependency criticality, current load, capacity limits, single points of failure, and cascading impact potential.


πŸ₯ Reality Distortion Index

Measures the gap between actual operational state, reported state, and perceived state.

This helps model situations where dashboards show green while the real system is deteriorating.


πŸ›‘ Governance Boundary Simulator

Tests whether an action should be allowed based on actor authority, required authority, action risk, system fragility, and trust level.

Example:

Should AI be allowed to reroute medical supply chains without human approval?

πŸ“¦ Coordination Cost Engine

Estimates the operational cost of coordination itself.

It models communication load, dependency complexity, synchronization delay, node load, and coordination overhead.


🌊 Cascade Simulation Engine

Simulates how shocks propagate through dependencies.

Example:

What happens if energy instability affects healthcare, logistics, and food supply?

πŸ€– AI Runtime Modeling Layer

The system can generate operational graphs from natural language prompts.

Example:

Model Hungary during an energy crisis affecting healthcare and logistics.

If an OpenAI API key is available, the app can generate a structured graph using AI.

If no API key is available, it falls back to a deterministic local demo model.

The AI layer is not the source of truth. The simulation engine remains the core.


Example Prompts

Model Hungary during an energy crisis affecting healthcare and logistics.
Model hospital overload during pandemic escalation with delayed escalation pathways.
Model food supply collapse after fuel shortages and transport disruption.
Model NATO logistics coordination during regional infrastructure instability.
Model AI governance inside a decentralized institution with human override authority.
Model a personal operational system where financial fragility, project fragmentation, and long-term systems philosophy interact.

Runtime Architecture

User Prompt
      ↓
AI Interpretation Layer
      ↓
Operational Graph Builder
      ↓
NetworkX System Graph
      ↓
Simulation Engines
      ↓
Metrics Layer
      ↓
Interactive Visualization
      ↓
Scenario History

Repository Structure

operational-systems-intelligence/
β”œβ”€β”€ app.py
β”œβ”€β”€ README.md
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ requirements-dev.txt
β”œβ”€β”€ pyproject.toml
β”œβ”€β”€ .gitignore
β”œβ”€β”€ .env.example
β”œβ”€β”€ LICENSE
β”œβ”€β”€ core/
β”œβ”€β”€ pages/
β”œβ”€β”€ data/
β”œβ”€β”€ docs/
β”œβ”€β”€ tests/
└── scripts/

Installation

python -m venv venv

Windows:

venv\Scripts\activate

Git Bash / Linux / macOS:

source venv/Scripts/activate

Install dependencies:

python -m pip install -r requirements.txt

Run the app:

python -m streamlit run app.py

Optional OpenAI Setup

The platform works without OpenAI.

For AI-assisted runtime graph generation, create a .env file:

OPENAI_API_KEY=your_key_here

Roadmap

Phase 1 β€” Operational Core

Status: mostly implemented.

  • operational graph engine
  • signal propagation
  • latency simulation
  • dependency visualization

Phase 2 β€” Coordination Intelligence

Status: partially implemented.

  • fragility scoring
  • governance boundaries
  • coordination metrics
  • cascade simulation
  • reality distortion analysis

Phase 3 β€” AI Runtime Intelligence

Status: early implementation.

  • AI-assisted graph generation
  • prompt-to-system modeling
  • scenario history foundation
  • explanation layer foundation

Phase 4 β€” Organizational Digital Twin

Status: conceptual foundation.

  • persistent system state
  • multi-system coordination
  • organizational memory
  • adaptive governance
  • live operational monitoring

Strategic Positioning

This is not intended to be a simple productivity app.

It is an experimental platform for operational intelligence, systems philosophy, coordination science, sociotechnical modeling, AI-assisted governance, infrastructure resilience, and organizational digital twins.

The long-term question is:

What should a person, organization, or institution do inside a complex system to produce the best long-term outcome?

Author

Alexander Berg

Exploring:

  • Sociotechnical Systems
  • Operational Systems Intelligence
  • Infrastructure Coordination
  • AI-Augmented Governance
  • Systems Philosophy
  • Complex Adaptive Systems

Releases

No releases published

Packages

 
 
 

Contributors

Languages