cybernetics-agent 0.6.0__tar.gz

cybernetics_agent-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run smoke tests
+        run: |
+          PYTHONPATH=src python3 -c "
+          import cybernetics_agent
+          from cybernetics_agent.core import FeedbackLoop, StabilityEngine, SystemIdentifier
+          from cybernetics_agent.core import OptimalController, InfoFlow, AdaptiveTuner, HierarchyController
+          from cybernetics_agent.adapters import HermesAdapter, LangChainAdapter, CrewAIAdapter
+          from cybernetics_agent.adapters import AutoGenAdapter, NativeAdapter
+          print('All imports successful')
+          "
+
+      - name: Run pytest
+        run: python -m pytest tests/ -v --tb=short
+
+      - name: Run ruff check
+        run: ruff check src/ tests/
+
+      - name: Run mypy
+        run: mypy src/
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

cybernetics_agent-0.6.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Cybernetics Agent runtime data
+.cybernetics/
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Reports
+*_report.md
+*_report.html

cybernetics_agent-0.6.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## [0.6.0] - 2026-05-13
+
+### Added
+- **事件持久化** (EventStore)
+  - `runtime/event_store.py`: SQLite 存储层，零外部依赖
+  - 三个表：`events`、`metrics`、`alerts`，带索引加速查询
+  - 支持按时间范围、类型、严重级别筛选查询
+  - 自动清理超过 30 天的旧数据
+- **集成点**
+  - MetricsCollector 自动将所有事件写入 SQLite
+  - AlertManager 自动将触发的告警写入 SQLite
+  - Dashboard 新增 `/api/history/*` 端点
+- **Bug 修复**: EventStore 目录自动创建、Dashboard 版本号统一、SQLite 异常保护
+
+### Previous Versions
+See [Git history](https://github.com/Jiaqi-Guo-0114/cybernetics-agent/commits/main) for earlier releases (v0.1.0–v0.5.0).

cybernetics_agent-0.6.0/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing to Cybernetics Agent
+
+感谢你对 Cybernetics Agent 的兴趣！欢迎提交 Issue 和 Pull Request。
+
+## 设计原则
+
+本项目遵循两个核心原则，所有贡献都应参考：
+
+1. **如无必要，勿增实体**（奥卡姆剑刀）— 不引入不必要的依赖、不创建不必要的抽象层、不添加不必要的配置项。每行代码都必须有存在的理由。如果一个功能可以用更少的代码实现，那就是更好的实现。
+
+2. **大把拆小，组合为工作流** — 复杂功能不是一个巨大的类，而是多个小模块的组合。模块之间零依赖，单独可用、单独可测。如果一个文件超过 300 行或一个类超过 10 个方法，就应该考虑拆分。
+
+## 如何贡献
+
+1. **Fork 仓库** 并克隆到本地
+2. **创建分支** `git checkout -b feature/your-feature`
+3. **提交更改** `git commit -am "feat: add new feature"`
+4. **推送到远程** `git push origin feature/your-feature`
+5. **创建 Pull Request**
+
+## 开发环境
+
+```bash
+# 克隆仓库
+git clone https://github.com/Jiaqi-Guo-0114/cybernetics-agent.git
+cd cybernetics-agent
+
+# 运行测试
+PYTHONPATH=src python3 -m pytest tests/ -v
+```
+
+## 提交规范
+
+- 使用 [Conventional Commits](https://www.conventionalcommits.org/)
+- 保持测试通过
+- 添加相关测试用例
+- 更新文档（如果需要）
+
+## 代码风格
+
+- Python 3.9+ 兼容
+- 纯标准库，无外部依赖
+- 类型注解尽量完整
+- 中文注释、中文用户面向字符串
+
+## 问题反馈
+
+- 使用 GitHub Issues 提交 bug 报告和功能请求
+- 提供尽可能详细的复现步骤

cybernetics_agent-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jiaqi Guo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cybernetics_agent-0.6.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: cybernetics-agent
+Version: 0.6.0
+Summary: A framework-agnostic cybernetics enhancement layer for AI agents, based on Qian Xuesen's Engineering Cybernetics.
+Project-URL: Homepage, https://github.com/Jiaqi-Guo-0114/cybernetics-agent
+Project-URL: Documentation, https://github.com/Jiaqi-Guo-0114/cybernetics-agent#readme
+Project-URL: Repository, https://github.com/Jiaqi-Guo-0114/cybernetics-agent
+Project-URL: Issues, https://github.com/Jiaqi-Guo-0114/cybernetics-agent/issues
+Author-email: Jiaqi Guo <your-email@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,autogen,control-theory,crewai,cybernetics,feedback-loop,langchain,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: all
+Requires-Dist: fastapi>=0.100; extra == 'all'
+Requires-Dist: jinja2>=3.1; extra == 'all'
+Requires-Dist: mypy>=1.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'all'
+Requires-Dist: pytest>=7.0; extra == 'all'
+Requires-Dist: ruff>=0.1; extra == 'all'
+Requires-Dist: uvicorn>=0.23; extra == 'all'
+Provides-Extra: dashboard
+Requires-Dist: fastapi>=0.100; extra == 'dashboard'
+Requires-Dist: jinja2>=3.1; extra == 'dashboard'
+Requires-Dist: uvicorn>=0.23; extra == 'dashboard'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🦙 Cybernetics Agent
+
+> 一个框架无关的控制论 Agent 增强层。
+> 基于钱学森《工程控制论》七大核心原则，让任何 Python Agent 都能获得自适应、自恢复、自优化的能力。
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-98%2F98-brightgreen.svg)]()
+
+🌐 **[English](README.en.md)** · **[Français](README.fr.md)** · **[Español](README.es.md)** · **[日本語](README.ja.md)** · **[한국어](README.ko.md)**
+
+---
+
+## ✅ 特性
+
+- **框架无关** — 不依赖任何 LLM 框架，纯标准库
+- **七大原则** — 钱学森《工程控制论》全覆盖
+- **多框架适配** — 支持 LangChain、AutoGen、CrewAI、Hermes、Claude Code、Codex 等
+- **声明式配置** — JSON/YAML 配置，灵活可控
+- **策略预设** — 4 种开箱即用配置模板
+- **Metrics 导出** — Prometheus / OpenMetrics 文本格式
+- **Plugin 系统** — 热插拔自定义模块
+- **实时 Dashboard** — FastAPI + SSE 事件流，告警面板 + 历史查询
+- **配置热重载** — 运行时修改配置文件自动生效
+- **告警系统** — 阈值规则 + 7 个通知渠道（飞书/钉钉/Discord/Slack/Email/Webhook/Stdout）
+- **事件持久化** — SQLite 存储，进程重启不丢失
+- **自适应调优** — ε-greedy 参数自动优化
+- **完整 CLI** — `cybernetix` 命令行工具
+- **线程安全** — 内置线程锁保护
+
+**设计哲学**: ① 如无必要，勿增实体 ② 大把拆小，组合为工作流
+
+## 🚀 快速开始
+
+```bash
+# 安装
+pip install cybernetics-agent
+
+# 初始化配置
+cybernetix init
+
+# 使用
+python -c "
+from cybernetics_agent import CyberneticsConfig, CyberneticsContext
+ctx = CyberneticsContext(CyberneticsConfig(project_name='my-agent'))
+ctx.emit_tool_result('search', ['paper1', 'paper2'])
+print(ctx.get_status())
+"
+```
+
+## 🎯 七大原则
+
+| 原则 | 模块 | 功能 |
+|------|------|------|
+| 1. 反馈闭环 | FeedbackLoop | 触发式行动，自动调整 |
+| 2. 稳定性优先 | StabilityEngine | 重试、熔断器、降级、超时控制 |
+| 3. 系统辨识 | SystemIdentifier | 转化漏斗、效率指标采集 |
+| 4. 最优控制 | OptimalController | 预算管理、约束检查 |
+| 5. 信息论 | InfoFlow | 消息过滤、分发 |
+| 6. 自适应 | AdaptiveTuner | 参数自动调优 |
+| 7. 分层控制 | HierarchyController | 战略/战术/执行三层架构 |
+
+## 🔧 支持的框架
+
+```python
+from cybernetics_agent.adapters import (
+    NativeAdapter,       # 纯 Python
+    LangChainAdapter,    # LangChain
+    AutoGenAdapter,      # AutoGen
+    CrewAIAdapter,       # CrewAI
+    HermesAdapter,       # Hermes Agent
+    ClaudeCodeAdapter,   # Claude Code CLI
+    CodexAdapter,        # OpenAI Codex CLI
+    OpenClawAdapter,     # OpenClaw (HTTP)
+    QwenpawAdapter,      # Qwenpaw
+)
+```
+
+## 📁 CLI 工具
+
+```bash
+cybernetix init                          # 初始化配置
+cybernetix preset list                   # 列出策略预设
+cybernetix preset show <name>            # 查看预设详情
+cybernetix preset apply <name> -o cfg.json  # 应用预设
+cybernetix validate cfg.json             # 验证配置文件
+cybernetix plugin list                   # 列出插件
+cybernetix plugin discover               # 发现插件
+cybernetix dashboard                     # 启动监控仪表盘
+cybernetix alert test                    # 测试告警渠道
+cybernetix alert status                  # 查看告警规则状态
+cybernetix alert fire -m "msg" -s error  # 手动触发告警
+cybernetix audit ./src                   # 审计代码缺陷
+cybernetix run ./task.py                 # 运行任务并采集指标
+cybernetix --version                     # 查看版本号
+```
+
+## 📊 监控仪表盘
+
+![Dashboard Preview](assets/dashboard_preview.png)
+
+启动监控仪表盘：
+```bash
+cybernetix dashboard
+```
+
+## 📝 许可证
+
+MIT License © 2026 Jiaqi Guo

cybernetics_agent-0.6.0/README.en.md

@@ -0,0 +1,101 @@
+# 🦙 Cybernetics Agent
+
+> A framework-agnostic cybernetics enhancement layer for AI agents.
+> Based on H.S. Tsien's *Engineering Cybernetics* seven core principles, enabling any Python agent with self-adaptive, self-healing, and self-optimizing capabilities.
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-98%2F98-brightgreen.svg)]()
+
+🌐 **[English](README.en.md)** · [中文](README.md) · [Français](README.fr.md) · [Español](README.es.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+---
+
+## ✅ Features
+
+- **Framework-agnostic** — No dependency on any LLM framework, pure stdlib
+- **Seven Principles** — Full coverage of Qian Xuesen's Engineering Cybernetics
+- **Multi-framework Adapters** — LangChain, AutoGen, CrewAI, Hermes, Claude Code, Codex, etc.
+- **Declarative Config** — JSON/YAML configuration, flexible and controllable
+- **Strategy Presets** — 4 out-of-the-box templates (high-concurrency / low-cost / high-reliability / debug)
+- **Metrics Export** — Prometheus / OpenMetrics text format, Grafana-ready
+- **Plugin System** — Hot-swappable custom modules, auto-discovery
+- **Real-time Dashboard** — FastAPI + SSE streaming, live frontend
+- **Auto-tuning** — ε-greedy parameter optimization with confidence scoring
+- **Full CLI Toolkit** — `cybernetix` (init / audit / dashboard / preset / plugin / validate / run / --version)
+- **Thread-safe** — Built-in thread lock protection
+
+## 🚀 Quick Start
+
+```bash
+# Install
+pip install cybernetics-agent
+
+# Initialize config
+cybernetix init
+
+# Use
+python -c "
+from cybernetics_agent import CyberneticsConfig, CyberneticsContext
+ctx = CyberneticsContext(CyberneticsConfig(project_name='my-agent'))
+ctx.emit_tool_result('search', ['paper1', 'paper2'])
+print(ctx.get_status())
+"
+```
+
+## 🎯 Seven Principles
+
+| Principle | Module | Function |
+|-----------|--------|----------|
+| 1. Feedback Loop | FeedbackLoop | Trigger-based actions, automatic adjustment |
+| 2. Stability First | StabilityEngine | Retry, circuit breaker, degradation, timeout |
+| 3. System Identification | SystemIdentifier | Conversion funnel, efficiency metrics |
+| 4. Optimal Control | OptimalController | Budget management, constraint checking |
+| 5. Information Theory | InfoFlow | Message filtering, distribution |
+| 6. Adaptive Control | AdaptiveTuner | Parameter auto-tuning |
+| 7. Hierarchical Control | HierarchyController | Strategic / Tactical / Executive layers |
+
+## 🔧 Supported Frameworks
+
+```python
+from cybernetics_agent.adapters import (
+    NativeAdapter,       # Pure Python
+    LangChainAdapter,    # LangChain
+    AutoGenAdapter,      # AutoGen
+    CrewAIAdapter,       # CrewAI
+    HermesAdapter,       # Hermes Agent
+    ClaudeCodeAdapter,   # Claude Code CLI
+    CodexAdapter,        # OpenAI Codex CLI
+    OpenClawAdapter,     # OpenClaw (HTTP)
+    QwenpawAdapter,      # Qwenpaw
+)
+```
+
+## 📁 CLI Tools
+
+```bash
+cybernetix init                          # Initialize config
+cybernetix preset list                   # List strategy presets
+cybernetix preset show <name>            # Show preset details
+cybernetix preset apply <name> -o cfg.json  # Apply preset
+cybernetix validate cfg.json             # Validate config file
+cybernetix plugin list                   # List plugins
+cybernetix plugin discover               # Discover plugins
+cybernetix dashboard                     # Launch monitoring dashboard
+cybernetix audit ./src                   # Audit code issues
+cybernetix run ./task.py                 # Run task with metrics
+cybernetix --version                     # Show version
+```
+
+## 📊 Dashboard
+
+![Dashboard Preview](assets/dashboard_preview.png)
+
+Launch dashboard:
+```bash
+cybernetix dashboard
+```
+
+## 📝 License
+
+MIT License © 2026 Jiaqi Guo

cybernetics_agent-0.6.0/README.es.md

@@ -0,0 +1,89 @@
+# 🦙 Cybernetics Agent
+
+> Una capa de mejora cibernética independiente del framework para agentes de IA.
+> Basada en los siete principios fundamentales de la *Cibernética de Ingeniería* de H.S. Tsien, permitiendo que cualquier agente Python sea auto-adaptativo, auto-reparable y auto-optimizante.
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-98%2F98-brightgreen.svg)]()
+
+🌐 **[Español](README.es.md)** · [中文](README.md) · [English](README.en.md) · [Français](README.fr.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+---
+
+## ✅ Características
+
+- **Independiente del framework** — Biblioteca estándar pura, cero dependencias externas
+- **Siete Principios** — Cobertura completa de la *Cibernética de Ingeniería* de Tsien
+- **Adaptadores multi-framework** — LangChain, AutoGen, CrewAI, Hermes, Claude Code, Codex, etc.
+- **Configuración declarativa** — Configuración JSON/YAML, flexible y controlable
+- **CLI completa** — Herramientas de línea de comandos `cybernetix` (init / audit / dashboard / run)
+- **Thread-safe** — Bloqueos de threading integrados para seguridad
+
+## 🚀 Inicio Rápido
+
+```bash
+# Instalar
+pip install cybernetics-agent
+
+# Inicializar configuración
+cybernetix init
+
+# Uso
+python -c "
+from cybernetics_agent import CyberneticsConfig, CyberneticsContext
+ctx = CyberneticsContext(CyberneticsConfig(project_name='mi-agente'))
+ctx.emit_tool_result('search', ['paper1', 'paper2'])
+print(ctx.get_status())
+"
+```
+
+## 🎯 Siete Principios
+
+| Principio | Módulo | Función |
+|-----------|---------|----------|
+| 1. Bucle de retroalimentación | FeedbackLoop | Acciones por disparadores, ajuste automático |
+| 2. Estabilidad primero | StabilityEngine | Reintento, disyuntor, degradación, timeout |
+| 3. Identificación del sistema | SystemIdentifier | Embudo de conversión, métricas de eficiencia |
+| 4. Control óptimo | OptimalController | Gestión de presupuesto, verificación de restricciones |
+| 5. Teoría de la información | InfoFlow | Filtrado de mensajes, distribución |
+| 6. Control adaptativo | AdaptiveTuner | Auto-ajuste de parámetros |
+| 7. Control jerárquico | HierarchyController | Capas Estratégica / Táctica / Ejecutiva |
+
+## 🔧 Frameworks Soportados
+
+```python
+from cybernetics_agent.adapters import (
+    NativeAdapter,       # Python puro
+    LangChainAdapter,    # LangChain
+    AutoGenAdapter,      # AutoGen
+    CrewAIAdapter,       # CrewAI
+    HermesAdapter,       # Hermes Agent
+    ClaudeCodeAdapter,   # Claude Code CLI
+    CodexAdapter,        # OpenAI Codex CLI
+    OpenClawAdapter,     # OpenClaw (HTTP)
+    QwenpawAdapter,      # Qwenpaw
+)
+```
+
+## 📁 Herramientas CLI
+
+```bash
+cybernetix init              # Inicializar config
+cybernetix audit ./src       # Auditar defectos de código
+cybernetix dashboard         # Iniciar panel de control
+cybernetix run ./task.py     # Ejecutar tarea y recolectar métricas
+```
+
+## 📊 Panel de Control
+
+![Dashboard Preview](assets/dashboard_preview.png)
+
+Iniciar panel de control:
+```bash
+cybernetix dashboard
+```
+
+## 📝 Licencia
+
+MIT License © 2026 Jiaqi Guo

cybernetics_agent-0.6.0/README.fr.md

@@ -0,0 +1,89 @@
+# 🦙 Cybernetics Agent
+
+> Une couche d'amélioration cybernétique indépendante du framework pour les agents IA.
+> Basée sur les sept principes fondamentaux de l'*Ingénierie Cybernétique* de H.S. Tsien, permettant à tout agent Python d'être auto-adaptatif, auto-réparant et auto-optimisant.
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-98%2F98-brightgreen.svg)]()
+
+🌐 **[Français](README.fr.md)** · [中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+---
+
+## ✅ Fonctionnalités
+
+- **Indépendant du framework** — Bibliothèque standard pure, zéro dépendance externe
+- **Sept Principes** — Couverture complète de l'*Ingénierie Cybernétique* de Tsien
+- **Adaptateurs multi-frameworks** — LangChain, AutoGen, CrewAI, Hermes, Claude Code, Codex, etc.
+- **Configuration déclarative** — Configuration JSON/YAML, flexible et contrôlable
+- **CLI complète** — Outils en ligne de commande `cybernetix` (init / audit / dashboard / run)
+- **Thread-safe** — Verrous de threading intégrés pour la sécurité
+
+## 🚀 Démarrage Rapide
+
+```bash
+# Installation
+pip install cybernetics-agent
+
+# Initialiser la configuration
+cybernetix init
+
+# Utilisation
+python -c "
+from cybernetics_agent import CyberneticsConfig, CyberneticsContext
+ctx = CyberneticsContext(CyberneticsConfig(project_name='mon-agent'))
+ctx.emit_tool_result('search', ['article1', 'article2'])
+print(ctx.get_status())
+"
+```
+
+## 🎯 Sept Principes
+
+| Principe | Module | Fonction |
+|----------|--------|----------|
+| 1. Boucle de rétroaction | FeedbackLoop | Actions basées sur déclencheurs, ajustement automatique |
+| 2. Stabilité prioritaire | StabilityEngine | Réessai, disjoncteur, dégradation, timeout |
+| 3. Identification système | SystemIdentifier | Entonnoir de conversion, métriques d'efficacité |
+| 4. Contrôle optimal | OptimalController | Gestion budget, vérification contraintes |
+| 5. Théorie de l'information | InfoFlow | Filtrage messages, distribution |
+| 6. Contrôle adaptatif | AdaptiveTuner | Auto-ajustement paramètres |
+| 7. Contrôle hiérarchique | HierarchyController | Couches Stratégique / Tactique / Exécutive |
+
+## 🔧 Frameworks Supportés
+
+```python
+from cybernetics_agent.adapters import (
+    NativeAdapter,       # Python pur
+    LangChainAdapter,    # LangChain
+    AutoGenAdapter,      # AutoGen
+    CrewAIAdapter,       # CrewAI
+    HermesAdapter,       # Hermes Agent
+    ClaudeCodeAdapter,   # Claude Code CLI
+    CodexAdapter,        # OpenAI Codex CLI
+    OpenClawAdapter,     # OpenClaw (HTTP)
+    QwenpawAdapter,      # Qwenpaw
+)
+```
+
+## 📁 Outils CLI
+
+```bash
+cybernetix init              # Initialiser config
+cybernetix audit ./src       # Auditer défauts code
+cybernetix dashboard         # Lancer tableau de bord
+cybernetix run ./task.py     # Exécuter tâche et collecter métriques
+```
+
+## 📊 Tableau de Bord
+
+![Dashboard Preview](assets/dashboard_preview.png)
+
+Lancer le tableau de bord:
+```bash
+cybernetix dashboard
+```
+
+## 📝 Licence
+
+MIT License © 2026 Jiaqi Guo