novafabric

NovaFabric 是一款自托管的命令行工具，旨在使 AI 和 HPC 运行具有可复现性、可比性和可审计性。其价值单元是“胶囊”（capsule）：一个位于 ~/.novafabric/capsules/ 下的以 ULID 命名的目录，用于保存单次执行的可观测事实，而非托管数据库中的跟踪行。安装方式为 `pip install novafabric`（支持 Python 3.12+）；可选的额外组件可增加 dashboard、query、server、compliance 和 Sigstore 支持，通过 `nova doctor --check-extras` 可报告缺失项。 捕获功能：`nova capture python my_agent.py --dataset data.csv` 可适用于任何命令且无需更改应用程序。它通过 PYTHONPATH 注入 sitecustomize.py 加载器，并为 OpenAI、Anthropic 和 MCP SDK 安装 monkey-patches，同时在 httpx、requests、aiohttp 和 urllib3 上设置线路级钩子，并设有分层保护以确保嵌套调用仅产生单条记录。工具可提取 OpenTelemetry GenAI 语义约定字段（如 temperature、top_p、max_tokens、seed、finish reasons 等）。对于 Claude Code、Cursor 或 Node/Go 智能体等非 Python 客户端，通过 `nova api-proxy` 和 `nova mcp-proxy` 两个透明代理，可在不触碰客户端的情况下捕获 LLM 和 MCP 流量。无论成功与否，系统都会写入胶囊，因此崩溃会被记录为包含状态、退出码和错误块的证据。 胶囊内容：包含 capsule.yaml 清单、trace.jsonl 跨度、model-calls.jsonl、tool-calls.jsonl、env.lock、replay.yaml、输入输出（stdout/stderr）以及 redaction-proof.json。在最终确定前，会对每个产出物进行密钥扫描；缺乏脱敏证明的胶囊在 `nova validate` 中被视为无效且无法导出。 重放与比对：`nova replay` 提供四种模式——取证（forensic，只读检查，无网络或子进程）、模拟（mocked，使用胶囊缓存提供模型和工具调用来重新运行命令）、语义（semantic，判断含义而非 Token，相似度 0.0–1.0）和精确（exact，要求确定性环境和单次调用种子以实现字节级一致）。README 明确表示不承诺远程 LLM 调用的精确重放。`nova diff` 用于比较两次运行，而 `nova diff --assert-no-regressions` 在行为发生变化时以非零状态退出，可作为智能体 CI 门禁，防止昨日可用而今日失效的情况。 治理与血缘：本地 SQLite Asset Registry 存储七类版本化资产（model, agent, prompt, tool, dataset, evaluation, deployment），以 name@version 形式寻址，生命周期涵盖从开发到归档；晋升仅为治理元数据，不执行部署。血缘层生成机械化的 consumed、produced_by 和 replayed_from 边（包含观测置信度与推断置信度），支持溯源、影响范围（blast-radius）和重放链查询，并可发出 OpenLineage 事件及 W3C PROV-N 导出。针对更大规模图谱提供了实验性的可选后端。`nova export-evidence` 可构建一个签名 ZIP 包，包含胶囊、血缘子图、in-toto DSSE 证明和 ed25519 签名，无需 NovaFabric 运行时即可通过 sha256sum 和 ed25519 验证器进行验证。 定位：项目声明其并非编排器、模型训练器、推理服务器、向量数据库、LLM 网关或 CI 运行器。如果目标是实时仪表盘、告警和多用户分析，托管的 SaaS 可观测性平台将更省力。Server 模式和实时 dashboard 标记为实验性，胶囊架构在计划的 v1.0 版本前尚未冻结，且该工具产生的是支持合规工作流的证据，而非对其进行认证。README 中提到的目标用户包括 ML/平台工程师、HPC 和研究团队、合规官、事件响应人员以及智能体框架作者。