by-framework 0.2.2.dev0__tar.gz → 0.2.2.dev2__tar.gz

{by_framework-0.2.2.dev0 → by_framework-0.2.2.dev2}/.gitignore

@@ -3,6 +3,7 @@ __pycache__/
 *.py[cod]
 *$py.class
 *.so
+.ruff_cache/
 .Python
 build/
 develop-eggs/
@@ -66,3 +67,9 @@ Thumbs.db
 *gateway-sdk.log*
 .claude/settings.local.json
 .claude/settings.json
+
+core
+
+.coderfleet-uploads/
+
+.claude/skills

{by_framework-0.2.2.dev0 → by_framework-0.2.2.dev2}/CLAUDE.md

@@ -65,9 +65,11 @@ Plugins can implement: `on_worker_startup`, `on_worker_shutdown`, `on_task_start
 
 ### Redis Key Patterns
 
-- `queue:ctrl:{agent_type}` - Control stream for agent commands
-- `queue:data:stream` - Data stream for events/chunks
-- `worker:active:{worker_id}` - Worker heartbeat registration
+- `byai_gateway:ctrl:agent_type:{agent_type}` — Control stream; competitive consume per agent type
+- `byai_gateway:ctrl:worker:{worker_id}` — Direct per-worker routing
+- `byai_gateway:session:{session_id}:data_stream` — Session-scoped output events
+- `byai_gateway:registry:worker:online:{worker_id}` — Heartbeat TTL key
+- `byai_gateway:task_group:{group_id}` — Scatter-gather group tracker
 
 ## Test Structure
 

{by_framework-0.2.2.dev0 → by_framework-0.2.2.dev2}/Makefile

@@ -82,6 +82,10 @@ lint-changed:
 
 test:
 	@set -e; for project in $(PROJECTS); do \
+		if ! find "$$project/tests" -type f \( -name 'test_*.py' -o -name '*_test.py' \) -print -quit 2>/dev/null | grep -q .; then \
+			echo "==> Skipping $$project (no test files)"; \
+			continue; \
+		fi; \
 		echo "==> Testing $$project"; \
 		(cd $$project && uv run --extra dev pytest); \
 	done

by_framework-0.2.2.dev0/README.md → by_framework-0.2.2.dev2/PKG-INFO

@@ -1,3 +1,27 @@
+Metadata-Version: 2.4
+Name: by-framework
+Version: 0.2.2.dev2
+Summary: 分布式 Agent 调度框架
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: dill>=0.4.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: redis>=7.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: isort>=5.13.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pyink>=24.0.0; extra == 'dev'
+Requires-Dist: pylint>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: observability
+Requires-Dist: opentelemetry-api>=1.25.0; extra == 'observability'
+Requires-Dist: opentelemetry-sdk>=1.25.0; extra == 'observability'
+Requires-Dist: prometheus-client>=0.20.0; extra == 'observability'
+Description-Content-Type: text/markdown
+
 # by-framework
 
 <div align="center">
@@ -608,11 +632,39 @@ import logging
 setup_logging(level=logging.INFO, use_json=True)  # JSON for log aggregation
 ```
 
+### Observability Dashboard
+
+Serve the built-in dashboard to inspect worker health, agent health, execution
+state counts, recent executions, Redis stream queue depth, consumer-group
+pending/lag, failure details, routing decisions, derived alerts, and segmented
+queue/run/end-to-end task latency:
+
+```bash
+uv run --package by-framework-dashboard by-framework-dashboard --host 127.0.0.1 --port 8765
+```
+
+Open `http://127.0.0.1:8765/`. For a local UI preview without Redis, open
+`http://127.0.0.1:8765/?demo=1`. Prometheus-style metrics are available at
+`http://127.0.0.1:8765/metrics`, and the dashboard keeps short in-memory trend
+history at `http://127.0.0.1:8765/api/history`. The UI uses split polling
+endpoints (`/api/workers`, `/api/executions`, `/api/queues`, `/api/history`)
+instead of polling the full `/api/snapshot` endpoint on every refresh. Runtime
+self-check data is exposed at `/api/health`, shown in the toolbar, and exported
+through `/metrics`.
+Alert thresholds can be tuned with `--queue-backlog-threshold`,
+`--delivery-pending-threshold`, `--consumer-pending-threshold`, and
+`--failed-execution-threshold`.
+
+The dashboard frontend is built with React/Vite under
+`libs/by-framework-dashboard/frontend`; its production build is packaged in
+`libs/by-framework-dashboard/src/by_framework_dashboard/static`. See
+`libs/by-framework-dashboard/README.md` for dashboard-specific runbook details.
+
 ---
 
 ## Roadmap
 
-- [ ] Observability dashboard for Worker health and task streams
+- [x] Observability dashboard for Worker health and task streams
 - [ ] WASM-based sandbox for stronger execution isolation
 - [ ] Enhanced LangGraph multi-agent orchestration adapter
 

by_framework-0.2.2.dev0/PKG-INFO → by_framework-0.2.2.dev2/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: by-framework
-Version: 0.2.2.dev0
-Summary: 分布式 Agent 调度框架
-License-File: LICENSE
-Requires-Python: >=3.12
-Requires-Dist: dill>=0.4.1
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: redis>=7.0.0
-Requires-Dist: typing-extensions>=4.0.0
-Provides-Extra: dev
-Requires-Dist: isort>=5.13.0; extra == 'dev'
-Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
-Requires-Dist: pyink>=24.0.0; extra == 'dev'
-Requires-Dist: pylint>=3.0.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
-Requires-Dist: pytest>=8.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.3.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
 # by-framework
 
 <div align="center">
@@ -628,11 +608,39 @@ import logging
 setup_logging(level=logging.INFO, use_json=True)  # JSON for log aggregation
 ```
 
+### Observability Dashboard
+
+Serve the built-in dashboard to inspect worker health, agent health, execution
+state counts, recent executions, Redis stream queue depth, consumer-group
+pending/lag, failure details, routing decisions, derived alerts, and segmented
+queue/run/end-to-end task latency:
+
+```bash
+uv run --package by-framework-dashboard by-framework-dashboard --host 127.0.0.1 --port 8765
+```
+
+Open `http://127.0.0.1:8765/`. For a local UI preview without Redis, open
+`http://127.0.0.1:8765/?demo=1`. Prometheus-style metrics are available at
+`http://127.0.0.1:8765/metrics`, and the dashboard keeps short in-memory trend
+history at `http://127.0.0.1:8765/api/history`. The UI uses split polling
+endpoints (`/api/workers`, `/api/executions`, `/api/queues`, `/api/history`)
+instead of polling the full `/api/snapshot` endpoint on every refresh. Runtime
+self-check data is exposed at `/api/health`, shown in the toolbar, and exported
+through `/metrics`.
+Alert thresholds can be tuned with `--queue-backlog-threshold`,
+`--delivery-pending-threshold`, `--consumer-pending-threshold`, and
+`--failed-execution-threshold`.
+
+The dashboard frontend is built with React/Vite under
+`libs/by-framework-dashboard/frontend`; its production build is packaged in
+`libs/by-framework-dashboard/src/by_framework_dashboard/static`. See
+`libs/by-framework-dashboard/README.md` for dashboard-specific runbook details.
+
 ---
 
 ## Roadmap
 
-- [ ] Observability dashboard for Worker health and task streams
+- [x] Observability dashboard for Worker health and task streams
 - [ ] WASM-based sandbox for stronger execution isolation
 - [ ] Enhanced LangGraph multi-agent orchestration adapter
 

{by_framework-0.2.2.dev0 → by_framework-0.2.2.dev2}/README_zh.md

@@ -608,11 +608,35 @@ import logging
 setup_logging(level=logging.INFO, use_json=True)  # JSON 格式便于日志聚合
 ```
 
+### 可观测仪表盘
+
+启动内置仪表盘，用于查看 Worker 健康、Agent 健康、执行状态计数、最近执行、Redis Stream 队列深度、consumer group pending/lag、失败详情、路由决策、派生告警，以及排队/执行/端到端分段延迟：
+
+```bash
+uv run --package by-framework-dashboard by-framework-dashboard --host 127.0.0.1 --port 8765
+```
+
+打开 `http://127.0.0.1:8765/`。如果本地没有 Redis，可打开
+`http://127.0.0.1:8765/?demo=1` 预览 UI。Prometheus 风格指标位于
+`http://127.0.0.1:8765/metrics`，仪表盘也会在
+`http://127.0.0.1:8765/api/history` 保留短期内存趋势历史。UI 使用拆分后的
+轮询接口（`/api/workers`、`/api/executions`、`/api/queues`、`/api/history`），
+不会每次刷新都请求完整的 `/api/snapshot`。运行时自检数据位于
+`/api/health`，会显示在工具栏中，也会通过 `/metrics` 导出。
+告警阈值可通过 `--queue-backlog-threshold`、
+`--delivery-pending-threshold`、`--consumer-pending-threshold` 和
+`--failed-execution-threshold` 调整。
+
+仪表盘前端使用 React/Vite 构建，源码位于
+`libs/by-framework-dashboard/frontend`，生产构建产物打包在
+`libs/by-framework-dashboard/src/by_framework_dashboard/static`。更多运行说明见
+`libs/by-framework-dashboard/README.md`。
+
 ---
 
 ## 路线图
 
-- [ ] Worker 健康与任务流的可观测仪表盘
+- [x] Worker 健康与任务流的可观测仪表盘
 - [ ] 基于 WASM 的沙箱，实现更强隔离
 - [ ] 增强的 LangGraph 多 Agent 编排适配器