@agentunion/kite 1.0.7 → 1.3.0

package/main.py

@@ -1,217 +1,18 @@
 """
 Kite development entry point.
-Loads .env, sets KITE_* defaults, parses --debug, starts Launcher.
+1. Run code stats
+2. Start launcher
 """
-import atexit
-import builtins
-import os
-import secrets
 import sys
-import threading
-import time
-from datetime import datetime
+from pathlib import Path
 
-# ── Timestamped print with delta + color ──
-# Covers the entire Launcher process. Child processes (registry, event_hub) are
-# separate PIDs — unaffected. Their stdout is relayed via ProcessManager._read_stdout
-# → print(), so timestamps & deltas are added at the relay point automatically.
+# Add project root to sys.path
+sys.path.insert(0, str(Path(__file__).parent))
 
-_builtin_print = builtins.print
-_last_ts = time.monotonic()
+# 1. Run code stats
+from launcher.count_lines import run_stats
+run_stats()
 
-# ANSI escape codes
-_DIM   = "\033[90m"   # gray  — fast, normal
-_GREEN = "\033[32m"   # green — noticeable but expected (subprocess launch, network wait)
-_RED   = "\033[91m"   # red   — abnormally slow, likely a problem
-_RESET = "\033[0m"
-
-# ── Log file handles ──
-# Initialized lazily after KITE_MODULE_DATA is resolved (see _init_log_files)
-_log_lock = threading.Lock()
-_log_latest = None    # file handle: latest.log (cleared each startup)
-_log_daily = None     # file handle: {YYYY-MM}/{YYYY-MM-DD}.log (append)
-_log_daily_date = ""  # current date string to detect day rollover
-
-# Strip ANSI escape sequences for plain-text log files
-import re
-_ANSI_RE = re.compile(r"\033\[[0-9;]*m")
-
-def _strip_ansi(s: str) -> str:
-    return _ANSI_RE.sub("", s)
-
-
-def _init_log_files():
-    """Initialize log file handles. Called after KITE_MODULE_DATA is set."""
-    global _log_latest, _log_daily, _log_daily_date
-    module_data = os.environ.get("KITE_MODULE_DATA")
-    if not module_data:
-        return
-    log_dir = os.path.join(module_data, "log")
-    os.makedirs(log_dir, exist_ok=True)
-
-    # latest.log — truncate on each startup
-    try:
-        _log_latest = open(os.path.join(log_dir, "latest.log"), "w", encoding="utf-8")
-    except Exception as e:
-        _builtin_print(f"[launcher] 警告: 无法打开 latest.log: {e}")
-
-    # daily log — append
-    _open_daily_log(log_dir)
-
-
-def _open_daily_log(log_dir: str = None):
-    """Open (or rotate) the daily log file based on current date."""
-    global _log_daily, _log_daily_date
-    today = datetime.now().strftime("%Y-%m-%d")
-    if today == _log_daily_date and _log_daily:
-        return
-    if _log_daily:
-        try:
-            _log_daily.close()
-        except Exception:
-            pass
-    if not log_dir:
-        module_data = os.environ.get("KITE_MODULE_DATA")
-        if not module_data:
-            return
-        log_dir = os.path.join(module_data, "log")
-    month_dir = os.path.join(log_dir, today[:7])  # YYYY-MM
-    os.makedirs(month_dir, exist_ok=True)
-    try:
-        _log_daily = open(os.path.join(month_dir, f"{today}.log"), "a", encoding="utf-8")
-        _log_daily_date = today
-    except Exception as e:
-        _builtin_print(f"[launcher] 警告: 无法打开每日日志: {e}")
-
-
-def _write_log(plain_line: str):
-    """Write a plain-text line to both latest.log and daily log."""
-    global _log_daily
-    with _log_lock:
-        if _log_latest:
-            try:
-                _log_latest.write(plain_line)
-                _log_latest.flush()
-            except Exception:
-                pass
-        # Check daily rotation
-        today = datetime.now().strftime("%Y-%m-%d")
-        if today != _log_daily_date:
-            _open_daily_log()
-        if _log_daily:
-            try:
-                _log_daily.write(plain_line)
-                _log_daily.flush()
-            except Exception:
-                pass
-
-
-def _close_log_files():
-    """Flush and close log files on exit."""
-    global _log_latest, _log_daily
-    for f in (_log_latest, _log_daily):
-        if f:
-            try:
-                f.flush()
-                f.close()
-            except Exception:
-                pass
-    _log_latest = None
-    _log_daily = None
-
-atexit.register(_close_log_files)
-
-
-def _tprint(*args, **kwargs):
-    global _last_ts
-    now = time.monotonic()
-    delta = now - _last_ts
-    _last_ts = now
-
-    # Timestamp
-    ts = datetime.now().strftime("%H:%M:%S.%f")[:-3]
-
-    # Format delta string
-    if delta < 1:
-        delta_str = f"+{delta * 1000:.0f}ms"
-    elif delta < 100:
-        delta_str = f"+{delta:.1f}s"
-    else:
-        delta_str = f"+{delta:.0f}s"
-
-    # Color: gray < 1s, green 1–5s, red > 5s
-    if delta >= 5:
-        color = _RED
-    elif delta >= 1:
-        color = _GREEN
-    else:
-        color = _DIM
-
-    prefix = f"{ts} {color}{delta_str:>8}{_RESET} "
-    _builtin_print(prefix, end="")
-    _builtin_print(*args, **kwargs)
-
-    # Write to log files (plain text, no ANSI)
-    if _log_latest or _log_daily:
-        sep = kwargs.get("sep", " ")
-        end = kwargs.get("end", "\n")
-        text = sep.join(str(a) for a in args)
-        plain_prefix = f"{ts} {delta_str:>8} "
-        _write_log(plain_prefix + text + end)
-
-builtins.print = _tprint
-
-# Load .env (development convenience, not required in production)
-try:
-    from dotenv import load_dotenv
-    load_dotenv()
-except ImportError:
-    pass
-
-# Resolve project root (directory containing this file)
-_project_root = os.path.dirname(os.path.abspath(__file__))
-
-# Home base for Kite data
-_home = os.environ.get("HOME") or os.environ.get("USERPROFILE") or os.path.expanduser("~")
-_kite_home = os.path.join(_home, ".kite")
-
-# Set KITE_* defaults (only if not already set by cli.js or .env)
-_defaults = {
-    "KITE_PROJECT": _project_root,
-    "KITE_CWD": os.getcwd(),
-    "KITE_WORKSPACE": os.path.join(_kite_home, "workspace"),
-    "KITE_DATA": os.path.join(_kite_home, "data"),
-    "KITE_MODULES": os.path.join(_kite_home, "modules"),
-    "KITE_REPO": os.path.join(_kite_home, "repo"),
-    "KITE_ENV": "development",
-}
-for key, value in _defaults.items():
-    if not os.environ.get(key):
-        os.environ[key] = value
-
-# Parse --debug flag
-if "--debug" in sys.argv:
-    os.environ["KITE_DEBUG"] = "1"
-    sys.argv.remove("--debug")
-
-# Ensure project root is on sys.path
-sys.path.insert(0, os.environ["KITE_PROJECT"])
-
-from core.launcher.entry import Launcher
-
-
-def main():
-    token = secrets.token_hex(32)
-    print(f"[main] KITE_TOKEN 已生成 ({len(token)} 字符)")
-    env = os.environ.get("KITE_ENV", "development")
-    debug = os.environ.get("KITE_DEBUG") == "1"
-    print(f"[main] 环境={env}, 调试={debug}, 项目={os.environ['KITE_PROJECT']}")
-    launcher = Launcher(kite_token=token)
-    # KITE_MODULE_DATA is now set — initialize log files
-    _init_log_files()
-    print(f"[main] 日志文件已初始化: {os.environ.get('KITE_MODULE_DATA', '')}/log/")
-    launcher.run()
-
-
-if __name__ == "__main__":
-    main()
+# 2. Start launcher
+from launcher.entry import start_launcher
+start_launcher()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentunion/kite",
-  "version": "1.0.7",
+  "version": "1.3.0",
   "description": "Kite framework launcher — start Kite from anywhere",
   "bin": {
     "kite": "./cli.js"
@@ -8,19 +8,16 @@
   "files": [
     "cli.js",
     "main.py",
-    "__main__.py",
-    "__init__.py",
-    "core/**",
+    "launcher/**",
+    "kernel/**",
     "extensions/**",
+    "scripts/**",
+    "CHANGELOG.md",
     "!**/__pycache__",
     "!**/__pycache__/**",
     "!**/*.pyc",
     "!**/data",
-    "!**/data/**",
-    "!**/bench_results",
-    "!**/bench_results/**",
-    "!core/event_hub_bench",
-    "!core/event_hub_bench/**"
+    "!**/data/**"
   ],
   "engines": {
     "node": ">=16"

package/__init__.py

@@ -1 +0,0 @@
-# Kite framework package

package/__main__.py

@@ -1,15 +0,0 @@
-"""Allow running Kite as a package: python -m Kite"""
-import os, sys
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-import secrets
-from core.launcher.entry import Launcher
-
-
-def main():
-    token = secrets.token_hex(32)
-    print(f"[main] KITE_TOKEN generated ({len(token)} chars)")
-    Launcher(kite_token=token).run()
-
-
-if __name__ == "__main__":
-    main()

package/core/event_hub/BENCHMARK.md

@@ -1,94 +0,0 @@
-# Event Hub 基准测试指南
-
-## 快速开始
-
-从 Kite 根目录运行：
-
-```bash
-python -m core.event_hub.bench_perf
-```
-
-运行约 20 秒，结果自动保存到 `core/event_hub/bench_results/` 目录。
-
-## 测试项说明
-
-### 1. Throughput（吞吐量）
-
-一次性发送 10000 个事件，测量整条链路的处理速度。
-
-| 指标 | 含义 |
-|------|------|
-| send_rate | publisher 每秒发送事件数（evt/s） |
-| hub_queued | hub 成功放入订阅者队列的数量 |
-| hub_routed | hub sender loop 成功发出的数量 |
-| client_recv | 订阅者客户端实际收到的数量 |
-
-三个数字一致 = 零丢失。哪个数字变小，哪个环节就是瓶颈。
-
-### 2. Latency（延迟）
-
-逐条发送 200 个事件，测量端到端耗时。
-
-| 指标 | 含义 |
-|------|------|
-| avg_ms | 平均延迟 |
-| p50_ms | 中位数延迟（50% 的请求低于此值） |
-| p95_ms | 95 分位延迟 |
-| p99_ms | 99 分位延迟（最差情况） |
-
-### 3. Fan-out（扇出）
-
-1 个 publisher 发送 2000 个事件，N 个 subscriber 同时接收。
-
-| 场景 | 含义 |
-|------|------|
-| x1 | 1 个订阅者，基线性能 |
-| x10 | 10 个订阅者，中等负载 |
-| x50 | 50 个订阅者，高负载 |
-
-每个场景报告 `avg_recv`（平均接收数）和 `min_recv`（最少接收数）。全部等于发送数 = 零丢失。
-
-## 结果文件
-
-每次运行自动保存到 `core/event_hub/bench_results/`：
-
-```
-bench_results/
-  2026-02-28_05-22-18.json
-  2026-02-28_06-30-00.json
-```
-
-JSON 结构：
-
-```json
-{
-  "timestamp": "2026-02-28T05:22:18",
-  "env": { "platform": "win32", "python": "3.12.0" },
-  "throughput": { "send_rate": 9752, "hub_queued": 10000, ... },
-  "latency": { "avg_ms": 0.6, "p50_ms": 0.55, ... },
-  "fanout_1": { ... },
-  "fanout_10": { ... },
-  "fanout_50": { ... },
-  "hub_counters": { ... }
-}
-```
-
-## 如何对比优化效果
-
-1. 改动代码前跑一次 `python -m core.event_hub.bench_perf`
-2. 实施优化
-3. 再跑一次
-4. 对比两个 JSON 文件中的关键指标
-
-重点关注：
-- `throughput.send_rate` — 越高越好
-- `latency.p99_ms` — 越低越好
-- `fanout_50.min_recv` — 应等于 2000（零丢失）
-
-## 其他测试脚本
-
-| 脚本 | 用途 | 耗时 |
-|------|------|------|
-| `bench_perf` | 快速基准对比 | ~20s |
-| `bench_extreme` | 极限压测（50000 burst、100MB 消息、50 subscriber） | ~5min |
-| `bench` | 长时间混合压力测试 | ~10min |