# BPA

> BPA is a governed local browser workflow platform. Prefer verified current
> state and normative contracts over plans, research, or historical notes.

## Reading order

1. Current state
2. Normative protocols and models
3. Architecture
4. Operations and tutorials

## Documents

- [当前能力](https://maplecity1314.github.io/BPA/raw/start/current-status.md): BPA 0.4 candidate 已实现、部分完成和明确未进入的能力边界。 (current-state; active)
- [Workflow v1alpha1](https://maplecity1314.github.io/BPA/raw/models/workflow/v1alpha1.md): BPA 声明式 Workflow 的输入输出、节点图、风险与失败分支。 (normative; active)
- [Workflow v1alpha2 / v1alpha3](https://maplecity1314.github.io/BPA/raw/models/workflow/structured.md): 结构化 sequence、call、decision、foreach、Assistance 与 Browser Resource Slot。 (normative; active)
- [Node v1alpha1](https://maplecity1314.github.io/BPA/raw/models/node/v1alpha1.md): BPA 节点能力、运行时、风险、幂等与 Evidence 契约。 (normative; active)
- [Node v1alpha2](https://maplecity1314.github.io/BPA/raw/models/node/v1alpha2.md): 资源感知 Browser Node 的能力、Origin、认证等级和版本冻结规则。 (normative; active)
- [Assistance Task v1alpha1](https://maplecity1314.github.io/BPA/raw/models/assistance/v1alpha1.md): AI Review、Human Confirm、Human Action、Lease、Fencing 与自动继续边界。 (normative; active)
- [Dataset 与 Decision](https://maplecity1314.github.io/BPA/raw/models/data/v1alpha1.md): 不可变 DatasetVersion、受限读取、Decision Candidate 与可撤销 DecisionRecord。 (normative; active)
- [Page Model 与 Readiness](https://maplecity1314.github.io/BPA/raw/models/page/v1alpha1.md): PageModel、ElementContract、受限 Design Mode 和 Adapter-owned Readiness Contract。 (normative; partial)
- [Execution Event v1](https://maplecity1314.github.io/BPA/raw/models/execution-event/v1.md): BPA 执行历史中的有序、可审计事件信封。 (normative; active)
- [Evidence v1](https://maplecity1314.github.io/BPA/raw/models/evidence/v1.md): BPA Evidence Metadata 的分类、完整性与保留字段。 (normative; active)
- [Control Hello](https://maplecity1314.github.io/BPA/raw/control/hello.md): bpa.control/hello/1 的协商顺序、帧边界、错误语义和兼容策略。 (normative; active)
- [Browser Resource Binding](https://maplecity1314.github.io/BPA/raw/control/resource-binding.md): Node Requirement、Workflow Slot、Run Binding Snapshot 与派发前复核。 (normative; active)
- [可信证据与资产](https://maplecity1314.github.io/BPA/raw/control/trusted-evidence.md): Browser Evidence、SourceRecord、AssetRecord、EvidenceLink 和本地内容寻址存储。 (normative; active)
- [Browser Protocol v2](https://maplecity1314.github.io/BPA/raw/browser/v2.md): Gateway、Native Host 与 Extension Bridge 之间的消息边界和完整生命周期。 (normative; active)
- [消息参考](https://maplecity1314.github.io/BPA/raw/browser/v2/messages.md): Browser Protocol v2 的页面观察、探测、命令和确认语义。 (normative; active)
- [安全边界](https://maplecity1314.github.io/BPA/raw/browser/v2/security.md): Permission Grant、Ed25519、Fencing Token 与不可信页面输入的约束。 (normative; active)
- [Timing 与 Risk](https://maplecity1314.github.io/BPA/raw/browser/v2/timing-and-risk.md): TimingPolicy 的有界等待与 RiskSignal 的明确阻断语义。 (normative; active)
- [JSON Schema](https://maplecity1314.github.io/BPA/raw/reference/schemas.md): BPA 协议与公共模型的机器可读 JSON Schema 下载。 (normative; active)
- [规范消息样例](https://maplecity1314.github.io/BPA/raw/reference/examples.md): Browser Protocol v2 与 Control Hello 的中性、可下载规范样例。 (normative; active)
- [机器可读文档](https://maplecity1314.github.io/BPA/raw/reference/machine-readable.md): BPA 的 llms.txt、完整文本索引、结构化目录和 Raw Markdown 入口。 (normative; active)
- [版本与兼容](https://maplecity1314.github.io/BPA/raw/reference/versioning.md): BPA 协议族、Schema 版本、Alpha 模型和兼容性规则。 (normative; active)
- [模块与边界](https://maplecity1314.github.io/BPA/raw/platform/architecture.md): BPA Core、编译器、执行引擎、Runtime Provider、Gateway、Adapter 与应用层的依赖边界。 (architecture; active)
- [执行、恢复与幂等](https://maplecity1314.github.io/BPA/raw/platform/runtime-recovery.md): IR2 计划快照、事务边界、Inbox/Outbox、Fencing 与不确定终态。 (architecture; active)
- [业务工作台](https://maplecity1314.github.io/BPA/raw/platform/operator-console.md): 本地 Operator Console 的入口、安全会话、运行向导和当前功能范围。 (architecture; partial)
- [AI 创作与发布边界](https://maplecity1314.github.io/BPA/raw/platform/ai-authoring.md): Codex 如何搜索能力、生成 Workflow/Node Candidate，并保持人工发布边界。 (architecture; partial)
- [数据与保留](https://maplecity1314.github.io/BPA/raw/operations/data-security.md): 本地数据分类、内容寻址存储、上传安全、删除约束与审计。 (operations; active)
- [安装与升级边界](https://maplecity1314.github.io/BPA/raw/operations/runtime.md): 固定 Node.js 运行时、生产闭包、SQLite Migration、健康检查与安全回滚。 (operations; partial)
- [正式资产发布](https://maplecity1314.github.io/BPA/raw/operations/publishing.md): 验证并人工发布 Workflow、Node、Adapter、Profile、Policy 和页面资产。 (operations; active)
- [使用本地工作台](https://maplecity1314.github.io/BPA/raw/guides/operator-console.md): 启动 BPA Operator Console，理解健康状态、导航和当前产品边界。 (tutorial; partial)
- [启动 Workflow](https://maplecity1314.github.io/BPA/raw/guides/run-workflow.md): 选择正式 Workflow、填写输入、绑定浏览器资源并观察一次 Run。 (tutorial; partial)
- [Browser Session 与登录](https://maplecity1314.github.io/BPA/raw/guides/browser-sessions.md): 理解浏览器资源、精确绑定、认证状态和登录失效后的人工接管。 (tutorial; partial)
- [处理人工任务](https://maplecity1314.github.io/BPA/raw/guides/assistance-tasks.md): 在任务中心处理 AI Review、Human Confirm 和 Human Action。 (tutorial; active)
- [查看证据与资产](https://maplecity1314.github.io/BPA/raw/guides/evidence-assets.md): 从 Run 追溯 Source、Evidence、Asset、摘要、保留策略和导出记录。 (tutorial; active)
- [故障与恢复](https://maplecity1314.github.io/BPA/raw/guides/recovery.md): 处理 Console、Core、Chrome、Session 和页面状态变化。 (tutorial; active)
- [可信地运行真实浏览器流程](https://maplecity1314.github.io/BPA/raw/index.md): BPA 的产品边界、平台架构、执行模型、可信证据和公共协议入口。 (tutorial; active)
- [核心概念](https://maplecity1314.github.io/BPA/raw/start/concepts.md): 用最少的概念理解 BPA 的资产、执行、浏览器资源和可信证据。 (tutorial; active)

## Machine-readable index

- https://maplecity1314.github.io/BPA/docs-index.json
- https://maplecity1314.github.io/BPA/llms-full.txt