bkn-env

name	bkn-env
description	BKN 执行前环境就绪检查与 bootstrap 判定。

环境检查

公约：../_shared/contract.md 插件检测：../_shared/plugin-check.md

做什么

在绑定/推送前，检查环境是否就绪。如果缺少必要资源，判定是否需要搭建。同时检测可插拔插件可用性。

输入

• network_dir：网络目录（.bkn 文件位于 {network_dir}/bkn/）
• network_context：网络名称、领域
• goal：validate / push / update / copy

检查清单

检查项	方法	失败结果
草案目录	{network_dir}/bkn/ 存在 + network.bkn 齐备	blocked
CLI	openbkn --version	blocked
平台连通性	openbkn config show	blocked
业务域	配置是否匹配	warning
同名网络	openbkn bkn list	记录冲突
资源就绪	Vega resource 是否存在	触发 bind_mode 判定
Skill 模块	openbkn skill list --limit 1	warning（记入 capability_matrix）
Agent 工厂	openbkn agent list --limit 1	warning（记入 capability_matrix）
定时任务（巡检用）	OpenClaw 调度 API 可用性	warning（记入 capability_matrix）

所有 CLI 操作委托 bkn-openbkn（读取 ../bkn-openbkn/SKILL.md）。

定时任务能力检测

在检查清单末尾，检测 OpenClaw 定时任务能力：

前提条件：定时任务能力仅在 plugin_availability.test == available（有 bkn-test 插件）时才有意义。若 test 插件不可用，巡检功能整体不可用，定时任务不会创建。

1. 检测 OpenClaw 是否已安装且可访问（委托 bkn-openbkn 检查环境）
2. 检测 OpenClaw 调度 API 是否可用（openclaw cron list 或等价命令）
3. 结果写入 env_capability_matrix.patrol_cron：available | unavailable
4. 不可用时不阻塞流程，但若同时 plugin_availability.test == unavailable，pipeline 阶段八整体跳过巡检

插件可用性检测

在检查清单末尾，按 ../_shared/plugin-check.md 协议检测可插拔插件：

1. 检测 ../_plugins/bkn-rules/SKILL.md 文件存在且非空 → plugin_availability.rules: available
2. 检测 ../_plugins/bkn-test/SKILL.md 文件存在且非空 → plugin_availability.test: available
3. 根据检测结果判定 plugin_mode（见 plugin-check.md）
4. 结果写入 pipeline_state.yaml，pipeline 据此裁剪阶段分支

Resource 可用性检查

在资源就绪检查阶段，获取平台可用 Vega resource 列表（仅元数据），供后续绑定阶段使用：

1. 执行 openbkn vega resource list 获取平台全部可用资源
   • 必须获取全部视图：优先使用 --all 参数；如不支持则使用 --page-size 分页循环获取，直到获取数量等于平台返回的总数
   • 如平台未返回总数且 CLI 不支持分页参数，执行 openbkn dataview list --limit 9999 作为降级方案
2. 输出 resource_availability（仅含资源元数据，不做对象-资源匹配推荐）
3. 对象-资源匹配的决策权交由 bkn-bind
4. 资源 property schema 由 bkn-bind 按需获取（通过 openbkn vega resource query <id> -d '{"limit":1}' 推断属性）

resource_availability:
  total_resources: 0
  fetched_resources: 0    # 实际获取的资源数量
  truncated: false        # true 表示平台有截断风险，bkn-bind 应 warn 用户
  available_resources: [{resource_id, resource_name, datasource_id, property_count}]

Bootstrap 与 bind_mode 判定

资源状态	bootstrap_level	result_status	bind_mode
数据源+资源都有	none	ready	full
仅有其一	soft	need_user_confirm	full
都没有	none	ready	deferred

bind_mode: deferred 表示当前环境无可用资源，pipeline 将跳过资源绑定阶段（阶段四），推送门禁中的绑定相关条件自动豁免。网络以 schema-only 模式推送，资源可后续通过 update pipeline 补绑。

输出

environment_status: ready | blocked | warning
bootstrap_required: true | false
bootstrap_level: soft | none
bind_mode: full | deferred
plugin_mode: full | limited
plugin_availability:
  rules: available | unavailable
  test: available | unavailable
check_summary: {cli, connectivity, domain, draft, resource_readiness}
blocking_issues: [{issue, reason, suggested_fix}]
bootstrap_plan: {steps, estimated_effort}
resource_availability: {total_resources, fetched_resources, truncated, available_resources}
env_capability_matrix:
  cli: available | unavailable
  platform: available | unavailable
  skill_module: available | unavailable
  agent_factory: available | unavailable
  resource: available | unavailable
  context_loader: available | unavailable
  patrol_cron: available | unavailable  # P1-5/P1-6 巡检自动创建

env_capability_matrix 和 plugin_availability 写入 pipeline_state.yaml，后续阶段据此裁剪分支（如 Skill 注册降级、Agent QA 降级、插件阶段跳过）。

约束

• 仅检查不修改 .bkn
• 不执行 push/delete/update
• bootstrap 前需用户确认