arbiter-lite 0.1.0__py3-none-any.whl

arbiter_doctor.py

@@ -0,0 +1,283 @@
+#!/usr/bin/env python3
+"""arbiter doctor — 多Agent系统诊断工具
+扫描项目目录，找出上下文、故障、状态三类的潜在问题。
+不修任何东西。只告诉你哪里会崩、为什么。
+"""
+
+import os, re, sys
+from collections import defaultdict
+
+# 诊断规则
+CHECKS = [
+    # 上下文共享风险
+    {
+        'id': 'context_no_quota',
+        'severity': 'high',
+        'category': '上下文共享风险',
+        'pattern': r'(StateGraph|TypedDict|messages\s*=\s*\[)',
+        'description': '多个Agent共用一个StateGraph，无配额隔离',
+        'detail': '你的Agent在抢同一个上下文窗口，随时可能溢出。Arbiter用固定分区+即时回收解决这个问题。',
+    },
+    {
+        'id': 'no_max_tokens',
+        'severity': 'medium',
+        'category': '上下文共享风险',
+        'pattern': r'(max_tokens|max_context_length)\s*=\s*None',
+        'description': 'Agent调用未设置max_tokens上限',
+        'detail': '没有硬上限，一个Agent的上下文膨胀会挤掉所有其他Agent的空间。',
+    },
+    # 故障盲区
+    {
+        'id': 'error_swallowed',
+        'severity': 'high',
+        'category': '故障盲区',
+        'pattern': r'except\s+\w+.*:\s*\n\s*(pass|print|logger\.warning)',
+        'description': 'Agent异常被静默吞掉',
+        'detail': 'catch块只有pass或print，错误没进审计日志。你上周可能有几十次超时你完全不知道。Arbiter的AuditTrail记录每一次异常。',
+    },
+    {
+        'id': 'no_timeout',
+        'severity': 'medium',
+        'category': '故障盲区',
+        'pattern': r'\.invoke\(|\.run\(|\.call\(',
+        'description': 'LLM调用未设置timeout',
+        'detail': 'Agent卡住时整个管道停摆。Arbiter的guard熔断器自动止损。',
+    },
+    # 状态冲突
+    {
+        'id': 'state_conflict',
+        'severity': 'high',
+        'category': '状态冲突',
+        'pattern': r'(state\.messages\s*=|\bstate\[.+\]\s*=)',
+        'description': '多个Agent同时写同一个state字段',
+        'detail': 'Agent A和Agent B都在改state.messages，概率性数据丢失。你还没发现是因为并发不够高。Arbiter用项目级锁防冲突。',
+    },
+    # Token边界问题
+    {
+        'id': 'context_overflow',
+        'severity': 'high',
+        'category': '上下文边界溢出',
+        'pattern': r'(context_window|max_input_tokens)\s*=\s*(\d{5,6})',
+        'description': '上下文窗口接近满载运行',
+        'detail': '你的Agent上下文窗口接近满载，12%的调用可能触发截断。Arbiter的adapt配额策略提前分配，避免边界溢出。',
+    },
+]
+
+def scan_directory(path):
+    """扫描目录，运行所有诊断规则"""
+    path = os.path.abspath(path)
+    if not os.path.isdir(path):
+        print(f'错误: {path} 不是有效目录')
+        sys.exit(1)
+
+    # 收集所有Python文件
+    py_files = []
+    for root, dirs, files in os.walk(path):
+        dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', '__pycache__', 'venv', '.venv')]
+        for f in files:
+            if f.endswith('.py'):
+                py_files.append(os.path.join(root, f))
+
+    if not py_files:
+        print(f'未找到Python文件在 {path}')
+        sys.exit(0)
+
+    # 检测框架
+    all_code = ''
+    for fp in py_files:
+        try:
+            with open(fp, encoding='utf-8', errors='ignore') as f:
+                all_code += f.read() + '\n'
+        except Exception as e:
+            import sys
+            print(f'[WARN] Failed to read {fp}: {e}', file=sys.stderr)
+
+    framework = detect_framework(all_code)
+    agent_count = estimate_agent_count(all_code, py_files)
+
+    # 运行诊断
+    findings = []
+    for check in CHECKS:
+        matches = []
+        for fp in py_files:
+            try:
+                with open(fp, encoding='utf-8', errors='ignore') as f:
+                    content = f.read()
+                    found = re.findall(check['pattern'], content, re.MULTILINE | re.DOTALL)
+                    if found:
+                        # Get line numbers
+                        lines = content.split('\n')
+                        for i, line in enumerate(lines):
+                            if re.search(check['pattern'], line):
+                                matches.append(f'{os.path.basename(fp)}:{i+1}')
+                                break
+            except Exception as e:
+                import sys
+                print(f'[WARN] Failed to scan {fp}: {e}', file=sys.stderr)
+        if matches:
+            findings.append({**check, 'files': matches[:3]})  # Max 3 locations
+
+    return {
+        'path': path,
+        'agent_count': agent_count,
+        'framework': framework,
+        'findings': findings,
+        'file_count': len(py_files),
+    }
+
+def detect_framework(code):
+    if 'langgraph' in code.lower() or 'StateGraph' in code:
+        return 'LangGraph'
+    if 'crewai' in code.lower() or 'Crew' in code:
+        return 'CrewAI'
+    if 'autogen' in code.lower():
+        return 'AutoGen'
+    if 'langchain' in code.lower():
+        return 'LangChain'
+    if 'openai' in code.lower() or 'anthropic' in code.lower():
+        return 'Direct API'
+    return 'Unknown'
+
+def estimate_agent_count(code, files):
+    # Count from graph node definitions (most reliable)
+    nodes = set()
+    for match in re.findall(r'add_node\([\"\'](\w+)[\"\']', code):
+        nodes.add(match)
+
+    if len(nodes) > 0:
+        return len(nodes)
+
+    # Count from class definitions
+    classes = re.findall(r'class\s+(\w*[Aa]gent)\s*[(:]', code)
+    if classes:
+        return len(set(classes))
+
+    # Fallback: count files with agent patterns, capped
+    count = 0
+    for fp in files:
+        try:
+            with open(fp, encoding='utf-8', errors='ignore') as f:
+                c = f.read()
+            if re.search(r'(from langgraph|import langgraph|StateGraph|add_node)', c):
+                count += 1
+        except Exception as e:
+            import sys
+            print(f'[WARN] Failed to scan {fp}: {e}', file=sys.stderr)
+    return max(min(count, 20), 1)
+
+def print_report(result):
+    """输出诊断报告"""
+    findings = result['findings']
+    high = [f for f in findings if f['severity'] == 'high']
+    medium = [f for f in findings if f['severity'] == 'medium']
+    low = [f for f in findings if f['severity'] == 'low']
+
+    sep = '-' * 56
+    a_count = result['agent_count']
+    fw = result['framework']
+    f_count = result['file_count']
+
+    print('')
+    print(f'  Diagnosis: {a_count} Agents - {fw} - {f_count} files')
+    print('  ' + sep)
+
+    if not findings:
+        print('  [OK] No obvious issues found.')
+        return
+
+    for f in findings:
+        if f['severity'] == 'high':
+            icon = '[HIGH]'
+        elif f['severity'] == 'medium':
+            icon = '[MED]'
+        else:
+            icon = '[LOW]'
+
+        cat = f['category']
+        desc = f['description']
+        detail = f['detail']
+
+        print('')
+        print(f'  {icon} {cat}: {desc}')
+        print(f'     -> {detail}')
+        for loc in f.get('files', []):
+            print(f'     @ {loc}')
+
+    print('')
+    print('  ' + sep)
+    print(f'  {len(high)} high, {len(medium)} medium, {len(low)} low')
+    print('')
+    print('  -> These problems are solved by Arbiter:')
+    print('     https://github.com/qiushu-wq/arbiter')
+
+def check_self(project_dirs=None, min_memory_files=8):
+    home = os.path.expanduser('~')
+    findings = []
+    details = {'claude_md_ok': False, 'projects_ok': True, 'missing': [], 'memory_ok': False}
+    claude_md = os.path.join(home, '.claude', 'CLAUDE.md')
+    details['claude_md_ok'] = os.path.exists(claude_md)
+
+    # Check memory directory
+    memory_dir = os.path.join(home, '.claude', 'projects')
+    memory_files = []
+    if os.path.isdir(memory_dir):
+        for root, dirs, files in os.walk(memory_dir):
+            for f in files:
+                if f.endswith('.md'):
+                    memory_files.append(os.path.join(root, f))
+    details['memory_ok'] = len(memory_files) >= min_memory_files
+    details['memory_count'] = len(memory_files)
+    if not details['memory_ok']:
+        findings.append({
+            'severity': 'high', 'category': 'Memory Degraded',
+            'description': f'Memory files: {len(memory_files)} (min: {min_memory_files})',
+            'detail': 'Memory system is below minimum threshold. Run arbiter-doctor --self to recheck.'
+        })
+
+    # Check project dirs if provided
+    dirs = project_dirs or {}
+    for name, path in dirs.items():
+        full = os.path.join(home, path)
+        if not os.path.isdir(full):
+            details['missing'].append(name)
+            details['projects_ok'] = False
+            findings.append({
+                'severity': 'high', 'category': 'Project Missing',
+                'description': f'Directory missing: {name}',
+                'detail': f'Expected at ~/{path}'
+            })
+    return {'status': 'healthy' if details['projects_ok'] and not findings else 'degraded',
+            'findings': findings, 'details': details}
+
+def print_self_report(result):
+    sep = '-' * 56
+    print('')
+    print('  Arbiter Self-Scan')
+    print('  ' + sep)
+    d = result['details']
+    print(f'  CLAUDE.md:    {"OK" if d["claude_md_ok"] else "MISSING"}')
+    print(f'  Projects:     {len(d["missing"])} missing')
+    for f in result.get('findings', []):
+        print(f'  [HIGH] {f["category"]}: {f["description"]}')
+    print(f'  Status: {result["status"].upper()}')
+
+
+def main():
+    if len(sys.argv) >= 2 and sys.argv[1] == '--self':
+        result = check_self()
+        print_self_report(result)
+        sys.exit(0 if result['status'] == 'healthy' else 1)
+
+    if len(sys.argv) < 2:
+        print('Usage:')
+        print('  arbiter-doctor <project-dir>    -- diagnose multi-agent project')
+        print('  arbiter-doctor --self           -- self-check environment')
+        sys.exit(1)
+
+    path = sys.argv[1]
+    result = scan_directory(path)
+    print_report(result)
+
+
+if __name__ == '__main__':
+    main()

arbiter_lite/__init__.py

@@ -0,0 +1,12 @@
+"""Arbiter Lite — Multi-Agent Context Quota Manager (MIT)
+
+Quota management + optional token compression (via Headroom integration).
+Each agent gets a fixed partition. Idle agent quotas are reclaimed instantly.
+With Headroom: 60-95% fewer tokens before context reaches the LLM.
+"""
+
+from .quota import QuotaManager
+from .compress import compress_context, get_compression_stats
+
+__version__ = "0.2.0"
+__all__ = ["QuotaManager", "compress_context", "get_compression_stats"]

arbiter_lite/compress.py

@@ -0,0 +1,35 @@
+"""Arbiter + Headroom — Token compression integration
+Optional pre-processor: compress context before LLM calls.
+Saves 60-95% tokens. Falls back to pass-through if headroom not installed.
+"""
+from typing import Any, Dict
+
+try:
+    from headroom import compress as _headroom_compress
+    HAS_HEADROOM = True
+except ImportError:
+    HAS_HEADROOM = False
+
+
+def compress_context(context: Any) -> Any:
+    """Compress context before LLM call. No-op if headroom not installed."""
+    if not HAS_HEADROOM:
+        return context
+
+    if isinstance(context, str):
+        return _headroom_compress(context)
+    if isinstance(context, list):
+        return [_headroom_compress(m) if isinstance(m, str) else m for m in context]
+    if isinstance(context, dict):
+        return {k: _headroom_compress(v) if isinstance(v, str) else v
+                for k, v in context.items()}
+    return context
+
+
+def get_compression_stats() -> Dict:
+    """Check if headroom compression is available."""
+    return {
+        'available': HAS_HEADROOM,
+        'install': 'pip install headroom-ai' if not HAS_HEADROOM else None,
+        'savings': '60-95% fewer tokens' if HAS_HEADROOM else 'N/A',
+    }

arbiter_lite/quota.py

@@ -0,0 +1,47 @@
+"""Arbiter Lite — 多Agent配额管理 (MIT)
+40行代码，解决多Agent上下文争抢问题。
+每个Agent分配固定配额，闲置Agent的配额自动回收给活跃Agent。
+"""
+
+from datetime import datetime, timedelta
+from typing import Dict, List
+
+
+class QuotaManager:
+    """固定分区 + 即时回收的配额管理器"""
+
+    def __init__(self, max_tokens: int, agent_names: List[str], idle_timeout: int = 300):
+        self.max_tokens = max_tokens
+        self.partition_size = max_tokens // max(len(agent_names), 1)
+        self.quotas: Dict[str, int] = {a: self.partition_size for a in agent_names}
+        self.last_active: Dict[str, datetime] = {a: datetime.now() for a in agent_names}
+        self.idle_timeout = idle_timeout  # 默认5分钟
+
+    def request(self, agent: str, tokens_needed: int) -> int:
+        """请求配额。返回实际获得的token数。"""
+        now = datetime.now()
+        self.last_active[agent] = now
+
+        # 即时回收：闲置Agent的配额
+        reclaimed = 0
+        for a in self.quotas:
+            if a == agent:
+                continue
+            idle_seconds = (now - self.last_active[a]).total_seconds()
+            if idle_seconds > self.idle_timeout:
+                half = self.quotas[a] // 2
+                self.quotas[a] -= half
+                reclaimed += half
+
+        self.quotas[agent] = self.quotas.get(agent, self.partition_size) + reclaimed
+        granted = min(tokens_needed, self.quotas[agent])
+        self.quotas[agent] -= granted
+        return granted
+
+    def status(self) -> Dict:
+        now = datetime.now()
+        return {a: {
+            'quota': q,
+            'partition': self.partition_size,
+            'idle_seconds': int((now - self.last_active[a]).total_seconds())
+        } for a, q in self.quotas.items()}

arbiter_lite-0.1.0.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: arbiter-lite
+Version: 0.1.0
+Summary: Multi-Agent Context Quota Manager + Diagnostic Tool — 40 lines, zero dependencies
+Home-page: https://github.com/qiushu-wq/arbiter
+Author: qiushu-wq
+Keywords: agent,llm,context,quota,multi-agent,diagnostic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-python
+Dynamic: summary
+
+# Arbiter — 给多 Agent 装上安全带
+
+> 不是 Agent 框架。是你的 Agent 崩了之后，3 秒定位、一键恢复的东西。
+
+## 为什么需要它
+
+6 个 Agent 同时跑，两个互相确认了 11 天没人发现。账单 4.7 万元。
+
+多 Agent 崩不是因为模型不够强，是因为没人管：
+- 三个 Agent 抢一个上下文窗口，一个溢出全崩
+- `except: pass` 吞了错误，37 次失败你不知道
+- 两个 Agent 同时写同一个字段，数据静默丢失
+
+**Arbiter 解决的不是"Agent 不够聪明"，是"Agent 互相踩踏"。**
+
+## 两个开源工具
+
+### arbiter-doctor — 诊断你的 Agent 项目
+
+```bash
+pip install git+https://github.com/qiushu-wq/arbiter.git
+arbiter-doctor ./my-agent-project
+```
+
+输出：
+```
+Diagnosis: 5 Agents - LangGraph - 23 files
+--------------------------------------------------------
+[HIGH] Context sharing: 3 agents share one StateGraph, no quota
+     -> Fix: Arbiter budget_policy="fixed_partition"
+[MED] Swallowed errors: agent_timeout caught and print()'d
+     -> Fix: Arbiter audit trail records every call status
+--------------------------------------------------------
+2 high, 1 medium
+```
+
+不修任何东西，只告诉你哪里会崩、为什么。每个问题下面跟一行：Arbiter 已解决。
+
+### arbiter-lite — 40 行配额管理器
+
+```bash
+pip install git+https://github.com/qiushu-wq/arbiter.git
+```
+
+```python
+from arbiter_lite import QuotaManager
+
+qm = QuotaManager(max_tokens=200000, agent_names=["market", "business", "chat"])
+tokens = qm.request("market", 5000)  # 请求配额，闲置 Agent 的配额自动回收
+print(qm.status())                     # 查看每个 Agent 配额使用情况
+```
+
+- 固定分区 + 即时回收
+- 5 分钟闲置 → 配额释放给活跃 Agent
+- 零依赖，Python 3.9+
+
+## 产品分层
+
+| 版本 | 价格 | 状态 | 说明 |
+|------|------|------|------|
+| **arbiter-doctor** | 免费 MIT | ✅ 可用 | 诊断工具，一行命令扫描项目 |
+| **arbiter-lite** | 免费 MIT | ✅ 可用 | 40 行配额管理器，够管 3-10 Agent |
+| **Arbiter Solo** | MIT | 🔒 闭源 | Agent Loop + 记忆 + 技能系统 |
+| **Arbiter Cloud** | ¥99-299/月 | 🔒 闭源 | heal + guard + adapt + cap + drain |
+| **Arbiter Enterprise** | ¥5,000-10,000/年 | 🔒 闭源 | SSO + RBAC + SLA + 私有部署 |
+
+**什么时候需要升级？**
+- Agent 超过 10 个 → 固定分区不够用，需要 adapt 自适应
+- 开始频繁崩 → 需要 guard 熔断器
+- 需要控制成本 → 需要 cap 硬上限
+
+## 安装
+
+```bash
+# 一个命令，诊断工具 + 配额管理器全装上
+pip install git+https://github.com/qiushu-wq/arbiter.git
+
+# 诊断项目
+arbiter-doctor ./my-agent-project
+
+# 代码里用
+python -c "from arbiter_lite import QuotaManager; print('OK')"
+```
+
+## 作者在生产中用
+
+作者的 6 个 Agent 在 7x24 小时跑：搜项目、发提案、回消息、盯差评。2742 个项目管道，36 条线索，跑了 5 天没崩。
+
+## 联系
+
+- GitHub Issues: [提交 Issue](https://github.com/qiushu-wq/arbiter/issues)
+- QQ: 2682289241
+- 微信: liu147852012
+
+---
+
+一个人全职在搞。如果对你有用，留个 Star，或者在 Issue 里喷我代码写得烂。

arbiter_lite-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+arbiter_doctor.py,sha256=scxpkDku1YgfKgAGcJ413-r-i2lXfiz_nX-kJ4wmX-s,10392
+stability_metrics.py,sha256=qacqTydnE7UpvIT5hqMpjlRbIWNuXchONp8qSS6dDYY,3471
+arbiter_lite/__init__.py,sha256=ES5Cf6D4VPdnfyReslHNm19tipGfQ637uHEOkAqhM5U,486
+arbiter_lite/compress.py,sha256=XRMIKWhgIqs3dFeKNB7oH8mclMx0vIb24YmCq9a0qAE,1215
+arbiter_lite/quota.py,sha256=CG6GAYveEC7mYowfzEfOtDcahI1LGyVKYxNx6rddQrE,1865
+arbiter_lite-0.1.0.dist-info/METADATA,sha256=iJTizGA0lPsGB1Wkeyuhhtb13eFeebn0PiHcQdkm2Uk,4163
+arbiter_lite-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+arbiter_lite-0.1.0.dist-info/entry_points.txt,sha256=OkWrHFz6kevdgKNIjTrEoTG6BIEw4yUNdSCJOwKYW80,55
+arbiter_lite-0.1.0.dist-info/top_level.txt,sha256=Ii8VKD-oMaaCuHoWqFOhjeEyzywYcrOIJJGsMJF8w4U,46
+arbiter_lite-0.1.0.dist-info/RECORD,,

arbiter_lite-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

arbiter_lite-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+arbiter-doctor = arbiter_doctor:main

arbiter_lite-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+arbiter_doctor
+arbiter_lite
+stability_metrics

stability_metrics.py

@@ -0,0 +1,88 @@
+"""Arbiter Stability Metrics -- Multi-Agent Health Check (MIT)
+
+Four hard thresholds:
+  - Agent failure rate < 5%
+  - Context loss rate < 0.1%
+  - State conflicts = 0
+  - Pipeline stall < 10 minutes
+"""
+import json, os, sys
+from datetime import datetime, timedelta
+
+# Cross-platform file locking
+if sys.platform == 'win32':
+    import msvcrt
+    def _lock(f):
+        # Lock a large region to cover the write (max file size)
+        msvcrt.locking(f.fileno(), msvcrt.LK_LOCK, 0x7FFFFFFF)
+    def _unlock(f):
+        msvcrt.locking(f.fileno(), msvcrt.LK_UNLCK, 0x7FFFFFFF)
+else:
+    import fcntl
+    def _lock(f):
+        fcntl.flock(f.fileno(), fcntl.LOCK_EX)
+    def _unlock(f):
+        fcntl.flock(f.fileno(), fcntl.LOCK_UN)
+
+THRESHOLDS = {
+    "agent_failure_rate": 0.05,
+    "context_loss_events": 0.001,
+    "state_conflicts": 0,
+    "pipeline_stall_minutes": 10,
+}
+
+def record(trace_id, agent_name, action_type, tokens_used, quota_pct, status,
+           parent_id=None, metrics_file="stability_metrics.jsonl"):
+    entry = {
+        "trace_id": trace_id, "agent_name": agent_name,
+        "action_type": action_type, "tokens_consumed": tokens_used,
+        "quota_used_pct": quota_pct, "status": status,
+        "parent_trace_id": parent_id or "", "ms_elapsed": 0,
+        "time": datetime.now().isoformat(),
+    }
+    with open(metrics_file, "a", encoding="utf-8") as f:
+        try:
+            _lock(f)
+            f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+        finally:
+            _unlock(f)
+    return entry
+
+def check(hours=24, metrics_file="stability_metrics.jsonl"):
+    cutoff = (datetime.now() - timedelta(hours=hours)).isoformat()
+    records = []
+    if os.path.exists(metrics_file):
+        with open(metrics_file, encoding="utf-8") as f:
+            for line in f:
+                try:
+                    r = json.loads(line)
+                    if r.get("time", "") >= cutoff:
+                        records.append(r)
+                except (json.JSONDecodeError, KeyError):
+                    pass
+    total = len(records)
+    if total == 0:
+        return {"status": "no_data", "detail": "No agent calls in period"}
+    failures = sum(1 for r in records
+                   if r["status"] != "ok" and "suppressed" not in r["status"])
+    context_loss = sum(1 for r in records if "quota_exceeded" in r["status"])
+    conflicts = sum(1 for r in records if "conflict" in r.get("status", ""))
+    report = {
+        "time": datetime.now().isoformat(), "total_calls": total,
+        "agent_failure_rate": round(failures / total, 4),
+        "context_loss_rate": round(context_loss / max(total, 1), 4),
+        "state_conflicts": conflicts, "status": "healthy", "alerts": [],
+    }
+    if report["agent_failure_rate"] > THRESHOLDS["agent_failure_rate"]:
+        report["status"] = "degraded"
+        report["alerts"].append("failure_rate: {}".format(report["agent_failure_rate"]))
+    if report["context_loss_rate"] > THRESHOLDS["context_loss_events"]:
+        report["status"] = "degraded"
+        report["alerts"].append("context_loss: {}".format(report["context_loss_rate"]))
+    if conflicts > THRESHOLDS["state_conflicts"]:
+        report["status"] = "critical"
+        report["alerts"].append("state_conflicts: {}".format(conflicts))
+    return report
+
+if __name__ == "__main__":
+    print(json.dumps(check(), ensure_ascii=False, indent=2))