knowledge-runtime-state-bootstrap-and-observability

name

knowledge-runtime-state-bootstrap-and-observability

description

覆盖 Blade 的进程启动目录状态、跨异步上下文 cwd 隔离、共享 Vanilla Store、日志与运行环境观测、运行时包信息、Session ID、原生目录选择和项目注册。 使用时机：调整 CLI 启动顺序、排查多 workspace 状态串扰、从 React 外访问 Store、增加运行态观测、修改版本识别、Session 标识或项目选择/绑定流程。 不包含：配置层级与持久化路由见 layered-configuration-and-runtime-settings，事件日志与持久投影见 durable-transcript-and-event-projection，容量和关闭编排见 capacity-lifecycle-and-egress。 关键词：bootstrap state, getCwd, runWithCwdOverride, vanillaStore, ensureStoreInitialized, Logger, streamDebug, getEnvironmentContext, getVersion, createSessionId, NativeDirectoryPicker, ProjectRegistry。

Module Structure

该组件提供各运行表面共享的进程级基础状态与观测入口；它区分启动目录、当前工作区和稳定项目根，并把 UI 状态、日志、环境探测及项目发现收敛到可被 Agent、CLI、Server、工具和扩展复用的 API。

Directory Layout

• packages/cli/src/bootstrap/state.ts — 惰性初始化的 cwd、originalCwd 与 projectRoot 三态
• packages/cli/src/store/ — React 与非 React 共用的 Zustand Store、切片、类型和细粒度选择器
• packages/cli/src/logging/ — 分类 JSONL 日志与独立流式调试日志
• packages/cli/src/utils/cwd.ts — 基于 AsyncLocalStorage 的并发 cwd 覆写
• packages/cli/src/utils/environment.ts — 项目根发现、环境提示和目录概览
• packages/cli/src/utils/packageInfo.ts — 源码与打包布局兼容的运行时包信息
• packages/cli/src/utils/sessionId.ts — 可安全用于存储路径的 Session ID
• packages/cli/src/services/DirectoryPicker.ts — macOS、Windows 与 Linux 原生目录选择
• packages/cli/src/services/ProjectRegistry.ts — 规范化项目路径的持久绑定注册表

Key Entry Points

• getCwd() / runWithCwdOverride() — 获取当前执行上下文的 workspace，或为异步调用链临时覆写
• vanillaStore / useBladeStore() / ensureStoreInitialized() — 共享状态实例、React 订阅与幂等配置初始化
• createLogger() / / — 分类日志、会话日志路由与流式专项诊断