TEK System

Adversarial Co-evolving Execution Research Platform.

This repository is a local executable scaffold for TEK: a small research runtime that simulates an execution kernel under adaptive adversarial pressure, records stability metrics, and emits structured traces for later benchmark, stress, and visualization work.

Status

• Local repository: ready
• Executable runtime: ready
• GitHub remote: https://github.com/joy7758/tek-system
• Public release: v0.1.0

Run

bash run.sh

Run with explicit options:

python3 -m cli.main --steps 64 --seed 11 --output artifacts/trace.json

Run tests:

python3 -m unittest discover -s tests

Features

• Execution Kernel (TEK) with deterministic seeded evolution
• Co-evolution adversary system
• Stability monitoring
• Emergent behavior analysis
• Benchmark and stress scenario hooks
• Optional visualization helper
• Agent-readable manifest and module map

Agent-Readable Map

Surface	Purpose
agent_manifest.json	Machine-readable project map, entry points, trace schema, and truth surfaces
configs/default.yaml	Default TEK runtime configuration
cli/main.py	CLI entry point
tek_core/runtime.py	Main run_system() orchestration
tek_core/state.py	Kernel state dataclass and transition helper
coevolution/adversary.py	Adversary action generator
stability/monitor.py	Stability score and phase classifier
emergence/detector.py	Emergence event detector
benchmark/runner.py	Multi-seed benchmark helper
stress/scenarios.py	Stress scenario presets
visualization/plot.py	Matplotlib trace plotting helper

Trace Schema

run_system() returns a list of JSON-compatible records. Each record includes:

• step: integer step index
• phase: stability phase label
• state: kernel state after the step
• adversary_action: selected adversary action
• stability: stability metrics
• emergence_events: detected event labels

GitHub Release

Target release:

gh release create v0.1.0 \
  --title "TEK System v0.1.0" \
  --notes "Stable TEK runtime system: adversarial execution + coevolution + stability + emergence + benchmark + stress testing"

Version

v0.1.0.