proofdeck 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/NOTICE +23 -0
- package/README.md +152 -2
- package/README.zh-CN.md +152 -0
- package/bin/proofdeck.js +191 -0
- package/board/LICENSE +201 -0
- package/board/README.md +473 -0
- package/board/README.zh-CN.md +424 -0
- package/board/dist/_chk.db-shm +0 -0
- package/board/dist/_chk.db-wal +0 -0
- package/board/dist/adapters.d.ts +40 -0
- package/board/dist/adapters.d.ts.map +1 -0
- package/board/dist/adapters.js +124 -0
- package/board/dist/adapters.js.map +1 -0
- package/board/dist/board.d.ts +628 -0
- package/board/dist/board.d.ts.map +1 -0
- package/board/dist/board.js +2767 -0
- package/board/dist/board.js.map +1 -0
- package/board/dist/cli.d.ts +3 -0
- package/board/dist/cli.d.ts.map +1 -0
- package/board/dist/cli.js +1663 -0
- package/board/dist/cli.js.map +1 -0
- package/board/dist/config.d.ts +57 -0
- package/board/dist/config.d.ts.map +1 -0
- package/board/dist/config.js +99 -0
- package/board/dist/config.js.map +1 -0
- package/board/dist/db.d.ts +9 -0
- package/board/dist/db.d.ts.map +1 -0
- package/board/dist/db.js +506 -0
- package/board/dist/db.js.map +1 -0
- package/board/dist/git.d.ts +35 -0
- package/board/dist/git.d.ts.map +1 -0
- package/board/dist/git.js +147 -0
- package/board/dist/git.js.map +1 -0
- package/board/dist/index.d.ts +18 -0
- package/board/dist/index.d.ts.map +1 -0
- package/board/dist/index.js +13 -0
- package/board/dist/index.js.map +1 -0
- package/board/dist/mcp-config.d.ts +26 -0
- package/board/dist/mcp-config.d.ts.map +1 -0
- package/board/dist/mcp-config.js +88 -0
- package/board/dist/mcp-config.js.map +1 -0
- package/board/dist/mcp.d.ts +3 -0
- package/board/dist/mcp.d.ts.map +1 -0
- package/board/dist/mcp.js +949 -0
- package/board/dist/mcp.js.map +1 -0
- package/board/dist/quickstart.d.ts +75 -0
- package/board/dist/quickstart.d.ts.map +1 -0
- package/board/dist/quickstart.js +156 -0
- package/board/dist/quickstart.js.map +1 -0
- package/board/dist/serve.d.ts +10 -0
- package/board/dist/serve.d.ts.map +1 -0
- package/board/dist/serve.js +445 -0
- package/board/dist/serve.js.map +1 -0
- package/board/dist/signing.d.ts +18 -0
- package/board/dist/signing.d.ts.map +1 -0
- package/board/dist/signing.js +26 -0
- package/board/dist/signing.js.map +1 -0
- package/board/dist/sync.d.ts +49 -0
- package/board/dist/sync.d.ts.map +1 -0
- package/board/dist/sync.js +158 -0
- package/board/dist/sync.js.map +1 -0
- package/board/dist/types.d.ts +359 -0
- package/board/dist/types.d.ts.map +1 -0
- package/board/dist/types.js +20 -0
- package/board/dist/types.js.map +1 -0
- package/board/docs/adr/0001-shared-worktree-collision.md +102 -0
- package/board/docs/adr/0001-shared-worktree-collision.zh-CN.md +90 -0
- package/board/docs/attribution.md +123 -0
- package/board/docs/attribution.zh-CN.md +104 -0
- package/board/docs/development-workflow.md +81 -0
- package/board/docs/development-workflow.zh-CN.md +75 -0
- package/board/docs/diagrams/banner.png +0 -0
- package/board/docs/diagrams/banner.svg +1 -0
- package/board/docs/diagrams/before-after.png +0 -0
- package/board/docs/diagrams/before-after.svg +1 -0
- package/board/docs/diagrams/governance-chain.png +0 -0
- package/board/docs/diagrams/governance-chain.svg +1 -0
- package/board/docs/diagrams/value-flow.png +0 -0
- package/board/docs/diagrams/value-flow.svg +1 -0
- package/board/docs/entry-point.md +81 -0
- package/board/docs/entry-point.zh-CN.md +65 -0
- package/board/docs/kanban.png +0 -0
- package/board/docs/octoryn-mark.png +0 -0
- package/board/docs/registry-metadata.md +34 -0
- package/board/docs/registry-metadata.zh-CN.md +30 -0
- package/board/package.json +87 -0
- package/config.example.json +72 -0
- package/daemon.js +1148 -0
- package/docs/assets/demo.gif +0 -0
- package/docs/assets/logo-512.png +0 -0
- package/docs/assets/logo.svg +31 -0
- package/docs/assets/social-preview.png +0 -0
- package/docs/demo-run.mjs +61 -0
- package/docs/render-demo.py +94 -0
- package/docs/render-logo.py +101 -0
- package/docs/task-book.md +58 -0
- package/e2e/verify-acceptance.mjs +150 -0
- package/e2e/verify-antifraud.mjs +128 -0
- package/e2e/verify-caps.mjs +46 -0
- package/e2e/verify-checkpoint.mjs +208 -0
- package/e2e/verify-firstclass.mjs +110 -0
- package/e2e/verify-judge.mjs +52 -0
- package/e2e/verify-lease.mjs +95 -0
- package/e2e/verify-replay.mjs +92 -0
- package/e2e/verify-resilience.mjs +323 -0
- package/e2e/verify-review.mjs +86 -0
- package/e2e/verify-scheduling.mjs +110 -0
- package/e2e/verify-schema-evolution.mjs +107 -0
- package/e2e/verify-sla-digest.mjs +105 -0
- package/guard.js +97 -0
- package/lib/adapters/codex.js +206 -0
- package/lib/billing-convert.js +57 -0
- package/lib/board.js +46 -0
- package/lib/caps.js +35 -0
- package/lib/checkpoint.js +130 -0
- package/lib/gating.js +218 -0
- package/lib/guard-core.mjs +108 -0
- package/lib/http.js +161 -0
- package/lib/judge.js +89 -0
- package/lib/lease.js +93 -0
- package/lib/notify.js +56 -0
- package/lib/platform.js +120 -0
- package/lib/replay.js +68 -0
- package/lib/review.js +40 -0
- package/lib/runner.js +152 -0
- package/lib/schedule.js +59 -0
- package/lib/sla.js +42 -0
- package/lib/spans.js +36 -0
- package/lib/starve.js +43 -0
- package/lib/store.js +109 -0
- package/lib/supply.js +101 -0
- package/lib/usage.js +103 -0
- package/lib/verify.js +223 -0
- package/lib/watchdog-core.mjs +68 -0
- package/lib/watchdog-worker.mjs +75 -0
- package/package.json +55 -4
- package/scripts/run-daemon.sh +18 -0
- package/scripts/run-e2e.mjs +39 -0
|
@@ -0,0 +1,424 @@
|
|
|
1
|
+

|
|
2
|
+
|
|
3
|
+
# Octopus Blackboard(章鱼黑板)
|
|
4
|
+
|
|
5
|
+
**面向 AI 编码 Agent 的共享记忆与协调层。**
|
|
6
|
+
|
|
7
|
+
> Agent 不需要另一个老板,它们需要一块共享黑板。
|
|
8
|
+
|
|
9
|
+
[English](./README.md)
|
|
10
|
+
|
|
11
|
+
> **[Octopus Core](https://github.com/octoryn) 的一部分 —— 受治理 AI 的开源基础设施栈。** 每个仓库只做一件事,沿 agent 生命周期组合:[Scout](https://github.com/octoryn/octopus-scout) · [Observe](https://github.com/octoryn/octopus-observe) · [Experience](https://github.com/octoryn/octopus-experience) · [Blackboard](https://github.com/octoryn/octopus-blackboard) · [Runtime](https://github.com/octoryn/octopus-runtime) · [Replay](https://github.com/octoryn/octopus-replay) —— [Inspect](https://github.com/octoryn/octopus-inspect) 横贯每一环做治理。
|
|
12
|
+
>
|
|
13
|
+
> **本仓库 —— Blackboard · 协同:** 为编码 agent 提供共享认知。
|
|
14
|
+
|
|
15
|
+

|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
Claude Code、Codex、Gemini CLI、Cursor、以及你本地的各种 agent,都在改同一个仓
|
|
20
|
+
库——但彼此失明。一个在重构 auth,另一个在改同一个文件。上下文散落在不同 CLI 里,
|
|
21
|
+
没人能复盘发生过什么。
|
|
22
|
+
|
|
23
|
+
Octopus Blackboard **不是 orchestrator。** 它不调度 agent、不触发 agent,也不替
|
|
24
|
+
agent 做任何决定。它是一个被动的、本地优先的共享记忆,只回答六个问题:
|
|
25
|
+
|
|
26
|
+
```text
|
|
27
|
+
谁在做什么 → agents, tasks, claims
|
|
28
|
+
改了什么 → files_changed
|
|
29
|
+
决定了什么 → decisions
|
|
30
|
+
有什么证据 → evidence
|
|
31
|
+
有哪些未决风险 → risks
|
|
32
|
+
给谁留了什么话 → messages, handoffs
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
每个 agent 只需要能够 **读黑板、写黑板、留言、附证据**。这就是全部契约。
|
|
36
|
+
|
|
37
|
+
## 为什么
|
|
38
|
+
|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
企业真正怕的,不是 agent 不够聪明,而是:
|
|
42
|
+
|
|
43
|
+
- 多个 AI 工具同时改代码
|
|
44
|
+
- 上下文散落在不同 CLI
|
|
45
|
+
- 没有共享记忆、没有审计、没有 handoff
|
|
46
|
+
- 没有冲突认知、无法复盘
|
|
47
|
+
|
|
48
|
+
黑板正好切中这一点。每一次写入,都会向 append-only 的 `timeline` 追加一条
|
|
49
|
+
**防篡改的哈希链条目**,因此整段历史可审计、可复盘——任何对早期条目的事后修改都
|
|
50
|
+
会导致校验失败。
|
|
51
|
+
|
|
52
|
+
## 两分钟上手
|
|
53
|
+
|
|
54
|
+
Blackboard 是进入 Octopus 技术栈最简单的入口——纯粹的协调记忆层,今天只要有
|
|
55
|
+
Claude Code 和 Cursor 即可使用,无需任何编排器。一条命令即可完成全部配置:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
npx octopus-blackboard quickstart
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
这一条命令会:在 `.octoboard/` 不存在时创建本地黑板,**自动检测你的 MCP 客户端**
|
|
62
|
+
(`.claude/` → Claude Code,`.cursor/` → Cursor……否则给出通用片段),打印针对该
|
|
63
|
+
客户端**可直接粘贴的配置**,并通过一次写入 + 一次读取证明黑板可用。
|
|
64
|
+
|
|
65
|
+
然后只需:
|
|
66
|
+
|
|
67
|
+
1. **粘贴**打印出的配置块到它指明的文件中。
|
|
68
|
+
2. **重载**你的 MCP 客户端(重启,或重新打开项目)。
|
|
69
|
+
3. **完成。** 让你的智能体调用 `board_status`,再调用 `board_note "hello"`——这就是
|
|
70
|
+
你在共享、防篡改时间线上的第一个黑板操作。
|
|
71
|
+
|
|
72
|
+
重复运行 `quickstart` 始终安全:它绝不会覆盖已有黑板或其历史。想了解为什么应该
|
|
73
|
+
**先**采用协调层?请看[**为什么先采用 Blackboard**](docs/entry-point.zh-CN.md)。
|
|
74
|
+
|
|
75
|
+
## 安装
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npm install
|
|
79
|
+
npm run build # 编译到 dist/
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
需要 Node ≥ 22。黑板就是 `.octoboard/` 下的单个 SQLite 文件,从当前工作目录向上
|
|
83
|
+
查找(类似 `.git`)。
|
|
84
|
+
|
|
85
|
+
## 见证效果
|
|
86
|
+
|
|
87
|
+
[`examples/two-agents.sh`](./examples/two-agents.sh) 演绎旗舰场景——Claude Code
|
|
88
|
+
与 Codex 在同一个仓库上共享一块板:认领冲突、实时同文件碰撞、决策、归属、落入对方
|
|
89
|
+
收件箱的 handoff、AI review、人类审批的 CI 门禁(阻断 → 放行)、问责计分卡、
|
|
90
|
+
blame→叙事,以及带 session 签名的可校验哈希链。在一个空目录里跑:
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
bash examples/two-agents.sh # 需要 PATH 上有 `octoboard`
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## CLI
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
octoboard init # 在此处创建 .octoboard/
|
|
100
|
+
octoboard status # 当前谁在黑板上
|
|
101
|
+
|
|
102
|
+
octoboard note "Codex is refactoring auth middleware"
|
|
103
|
+
octoboard claim trust-layer-policy-schema # 认领工作;冲突时告警
|
|
104
|
+
octoboard message claude "Review policy edge cases before merge"
|
|
105
|
+
octoboard decision "Use hash-chain audit log" --why "tamper-evidence"
|
|
106
|
+
octoboard risk "Migration may break audit replay" --severity high
|
|
107
|
+
octoboard file src/auth.ts --change modified --task trust-layer-policy-schema
|
|
108
|
+
octoboard handoff claude "Tests pass except policy replay" --task trust-layer-policy-schema
|
|
109
|
+
|
|
110
|
+
octoboard timeline # 完整的哈希链历史
|
|
111
|
+
octoboard verify # 校验链条是否完好
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
身份通过 `--as <agent>` 或环境变量 `OCTOBOARD_AGENT` 设置。用 `--board <dir>` 或
|
|
115
|
+
`OCTOBOARD_DIR` 指向特定黑板。
|
|
116
|
+
|
|
117
|
+
### 冲突认知
|
|
118
|
+
|
|
119
|
+
黑板从不阻塞——它只**暴露**。如果两个 agent 认领同一个 key,或改动同一个 task 的
|
|
120
|
+
文件,两次写入都会被记录,并对后来者告警:
|
|
121
|
+
|
|
122
|
+
```text
|
|
123
|
+
⚠ CONFLICT: "trust-layer-policy-schema" is also held by codex. Both claims recorded.
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## AI 归属与共享开发记忆
|
|
127
|
+
|
|
128
|
+
Git 记录的是谁 **push** 了 commit。它不记录:是哪个 AI agent 产出了代码、在哪个
|
|
129
|
+
session、在哪台机器、是否被另一个 AI review 过、是否有人类批准过。随着 AI 原生开
|
|
130
|
+
发普及,问责必须超越 Git authorship。
|
|
131
|
+
|
|
132
|
+
黑板在 Git **之上**加一层归属——它绝不 rewrite 历史。Git 仍是代码的真相源,黑板
|
|
133
|
+
成为归属的真相源。
|
|
134
|
+
|
|
135
|
+
### Session(会话)
|
|
136
|
+
|
|
137
|
+
session 是一个 agent 的一段连续执行,也是归属挂靠的单位。开启后,后续每次写入都归
|
|
138
|
+
属到它(活跃 session 会跨 CLI 调用按 agent 记住):
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
export OCTOBOARD_AGENT=claude OCTOBOARD_PROVIDER=anthropic \
|
|
142
|
+
OCTOBOARD_MODEL=claude-opus-4-8 OCTOBOARD_CLI=claude-code
|
|
143
|
+
|
|
144
|
+
blackboard session start --label "auth work" # 捕获机器、分支、仓库
|
|
145
|
+
blackboard claim policy-engine
|
|
146
|
+
blackboard file src/policy.ts --change modified
|
|
147
|
+
# ... 做一次 git commit ...
|
|
148
|
+
blackboard link HEAD # 把该 commit 的文件归属出去
|
|
149
|
+
blackboard session stop
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
身份完全 provider-independent——`--provider`、`--model`、`--cli` 或对应的
|
|
153
|
+
`OCTOBOARD_*` 环境变量。任何 AI CLI(本地或云端)都能自我注册,不对任何厂商做假设。
|
|
154
|
+
|
|
155
|
+
### 关联 commit
|
|
156
|
+
|
|
157
|
+
`blackboard link <rev>` 通过 Git 读取该 commit 改动的文件,为活跃 session 每个文件
|
|
158
|
+
记一条归属。可选地在 `refs/notes/blackboard` 下写一条 additive 的 `git notes`:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
blackboard link HEAD --note
|
|
162
|
+
blackboard attribute <sha> --file src/x.ts --actor human --name Ran # 手动
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### Review
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
blackboard review HEAD --by ai --name codex --outcome approved --note "tests pass"
|
|
169
|
+
blackboard review HEAD --by human --name Ran --outcome approved
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
### 查询共享记忆
|
|
173
|
+
|
|
174
|
+
```bash
|
|
175
|
+
blackboard who src/auth.ts # git 作者 + 触碰过它的 AI session
|
|
176
|
+
blackboard who src/auth.ts --line 42 # 哪个 session 引入了这一行
|
|
177
|
+
blackboard explain HEAD # 归属 + review + 相关决策
|
|
178
|
+
blackboard commits claude-code # 哪些 commit 来自某个 AI / CLI
|
|
179
|
+
blackboard unreviewed # 从未经人类 review 的 AI commit
|
|
180
|
+
blackboard joint claude codex # 被两个 agent 同时改过的文件
|
|
181
|
+
blackboard timeline --session <id> # 单个 session 的 HH:MM 时间线
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
每一条归属、review、session、决策都会同时记入哈希链 `timeline`,因此完整的问责历
|
|
185
|
+
史防篡改、可复盘。`blackboard` 与 `octoboard` 是同一个命令。
|
|
186
|
+
|
|
187
|
+
## 治理与问责链
|
|
188
|
+
|
|
189
|
+

|
|
190
|
+
|
|
191
|
+
归属的意义在于**能落地约束**。从"干活"到"合并门禁"的完整链路:
|
|
192
|
+
|
|
193
|
+
```text
|
|
194
|
+
agent work → commit attribution → export/import → CI check → human-review gate
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
### CI 门禁(`check`)
|
|
198
|
+
|
|
199
|
+
把查询变成可执行门禁。只读——报告 pass/fail 并以非零退出;真正 block 的是 CI 系统,
|
|
200
|
+
黑板从不阻塞。
|
|
201
|
+
|
|
202
|
+
```bash
|
|
203
|
+
# CI 里,在 PR 分支上——存在未经人类 review 的 AI commit 就让构建失败:
|
|
204
|
+
blackboard check --range origin/main..HEAD --require-human-review
|
|
205
|
+
echo $? # 0=通过, 1=有违规
|
|
206
|
+
|
|
207
|
+
blackboard check # 默认门禁:校验链 + 要求人类 review
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### 可携带性(`export` / `import` / `trailers`)
|
|
211
|
+
|
|
212
|
+
归属是本地优先的;这几条让它活过 `git push`,进入团队板子或 CI:
|
|
213
|
+
|
|
214
|
+
```bash
|
|
215
|
+
blackboard export --range origin/main..HEAD --out attribution.json # 开发机上
|
|
216
|
+
blackboard import attribution.json # 团队板 / CI 上
|
|
217
|
+
blackboard trailers HEAD # commit message 用的 trailer 行
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
`import` 幂等(按行 id 去重)。bundle 携带 attributions、reviews、sessions、相关 decisions。
|
|
221
|
+
|
|
222
|
+
### 订阅(`watch`)
|
|
223
|
+
|
|
224
|
+
补齐 read/write/**subscribe**/message 契约。被动:轮询并报告,绝不推工作。
|
|
225
|
+
|
|
226
|
+
```bash
|
|
227
|
+
blackboard watch --for claude # 只提示发给我的 message/handoff/冲突
|
|
228
|
+
blackboard watch # 全量流
|
|
229
|
+
blackboard watch --once # 一次性轮询(脚本用)
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
### 签名 session(`sign` / `verify`)
|
|
233
|
+
|
|
234
|
+
最小身份(v0):每个 session 一对 Ed25519 密钥(私钥留本地 `.octoboard/keys/`,已
|
|
235
|
+
gitignore)。对 timeline head 签名,让 `verify` 区分**可信**与仅仅"自证":
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
blackboard sign # 用当前活跃 session key 对 head 签名
|
|
239
|
+
blackboard verify # 链完整性 + 哪些 session 签过、trusted/stale
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
`session stop` 时自动对 head 签名。一旦任何更早的历史被改动,覆盖该 head 的签名就变
|
|
243
|
+
**stale**——即使签名本身在密码学上仍有效,篡改也会显形。这还不是完整 PKI(无密钥分
|
|
244
|
+
发/吊销)。
|
|
245
|
+
|
|
246
|
+
## 摄取 CLI 会话记录
|
|
247
|
+
|
|
248
|
+
不必手动调 API——直接从 CLI 的会话 transcript 灌入,文件改动、决策、笔记都会落到当前
|
|
249
|
+
session 上:
|
|
250
|
+
|
|
251
|
+
```bash
|
|
252
|
+
blackboard ingest ~/.claude/transcript.jsonl --format claude-code
|
|
253
|
+
blackboard ingest session.jsonl --format codex # 还支持:gemini、grok
|
|
254
|
+
blackboard ingest events.json --format generic --dry-run
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
`claude-code`/`codex`/`gemini`/`grok` 用一套保守的 tool-use JSONL 启发式(从
|
|
258
|
+
`file_path`/`notebook_path` 及 patch/write 工具调用里找文件改动)。`generic` 读一套
|
|
259
|
+
规范化 schema——这是**任意** CLI 的稳定接入路径:
|
|
260
|
+
|
|
261
|
+
```json
|
|
262
|
+
{ "events": [
|
|
263
|
+
{ "type": "file", "path": "src/auth.ts", "change": "modified" },
|
|
264
|
+
{ "type": "decision", "title": "use ed25519", "rationale": "small keys" },
|
|
265
|
+
{ "type": "note", "text": "left policy edge cases for review" }
|
|
266
|
+
] }
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
## 团队后端
|
|
270
|
+
|
|
271
|
+
板子保持本地优先;sync 把可携带的归属记录(绝不含板子的私有哈希链)同步到团队存储
|
|
272
|
+
——一个共享文件或 Postgres:
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
blackboard sync push --target /shared/team.json # 文件(共享盘)
|
|
276
|
+
blackboard sync pull --target postgres://host/blackboard # 团队数据库(需要 `pg`)
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
`export` 用你活跃 session 的密钥对 bundle 签名;`import` 会校验,`import
|
|
280
|
+
--require-signed` 拒收未签名或被篡改的 bundle——所以导入的归属有来源真实性,而不只是
|
|
281
|
+
按 id 去重。
|
|
282
|
+
|
|
283
|
+
如果把 head 锚定到外部,防篡改能力比 DB 内哈希链更强:
|
|
284
|
+
|
|
285
|
+
```bash
|
|
286
|
+
blackboard anchor --git-note # 把 seq:hash 记到 commit 上(或 --out file)
|
|
287
|
+
blackboard verify --against git-note # 证明历史没被截断/改动
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
在线状态与合规:
|
|
291
|
+
|
|
292
|
+
```bash
|
|
293
|
+
blackboard session heartbeat # 标记 session 存活(区分活跃/陈旧)
|
|
294
|
+
# `blackboard file ...` 现在会在另一个活跃 session 正在改同一文件时告警
|
|
295
|
+
|
|
296
|
+
blackboard prune --before 2026-01-01T00:00:00Z # 保留策略:删旧 messages/
|
|
297
|
+
# evidence/file-changes(时间线保留)
|
|
298
|
+
blackboard redact 42 --reason PII # 隐藏某条时间线条目的内容
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
`prune` 绝不动 append-only 时间线(审计轨迹)。`redact` 在**所有读路径**上抹掉内容
|
|
302
|
+
——时间线覆盖层*和*底层源行(消息正文、evidence 笔记等),让 `inbox`/`status`/看板
|
|
303
|
+
都无法泄露——同时保持哈希链可校验。它不是密码学擦除:原始 summary 仍留在时间线行里
|
|
304
|
+
以保证链可验,所以别存你必须能销毁的机密。要防御有数据库写权限的攻击者,请把 head
|
|
305
|
+
hash 锚定到外部(一个 commit、一份日志、另一台机器)——当 `verify` 无法确认尾部时会
|
|
306
|
+
显示 `unanchored` 警告。
|
|
307
|
+
|
|
308
|
+
## 任务与看板(Kanban)
|
|
309
|
+
|
|
310
|
+
任务就是看板卡片——编号、内容、负责人(哪个 agent / CLI)、project、影响面、风险、
|
|
311
|
+
实时进度。**"通知 agent" 是被动的:** 派发任务 = 在该 agent 的收件箱里放一条"请查看
|
|
312
|
+
任务 #N";agent 读到后自己决定是否开工——板子从不启动任何人。
|
|
313
|
+
|
|
314
|
+

|
|
315
|
+
|
|
316
|
+
*`blackboard serve` 的实时看板——只读、自动刷新。每张卡显示 任务号、进度条、负责人、
|
|
317
|
+
活跃 agent 数(⚡)、project、按风险着色的边框。*
|
|
318
|
+
|
|
319
|
+
```bash
|
|
320
|
+
blackboard task add auth-mw --title "Refactor auth middleware" \
|
|
321
|
+
--project octopus-api --impact "src/auth.ts, src/db.ts" --risk high
|
|
322
|
+
blackboard assign 1 claude # → 在 claude 收件箱放 "请查看任务 #1 …"
|
|
323
|
+
blackboard progress 1 40 # → #1 变 in-progress,40%
|
|
324
|
+
blackboard tasks # 看板视图,按状态分组
|
|
325
|
+
blackboard task show 1 # 完整卡片:负责人、project、影响面、风险、文件
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
只读的 `serve` 看板把它们渲染成实时 Kanban(按状态分列;每张卡显示 编号、标题、进度
|
|
329
|
+
条、负责人、活跃 agent 数、project、按风险着色的左边框)。agent 通过 MCP 工具
|
|
330
|
+
`board_task_define`、`board_assign`、`board_progress`、`board_tasks` 驱动——agent 边干
|
|
331
|
+
边调 `board_progress`,进度条就实时动。
|
|
332
|
+
|
|
333
|
+
## 可见性
|
|
334
|
+
|
|
335
|
+
```bash
|
|
336
|
+
blackboard report # 计分卡:review 覆盖率、AI/人类比例、按 agent 分解
|
|
337
|
+
blackboard blame src/auth.ts 42 # 从一行回溯 → 写它的 session,及其其它工作、
|
|
338
|
+
# 决策、handoff(blame → 叙事)
|
|
339
|
+
blackboard serve # 只读本地 web 看板(http://localhost:4319)
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
看板零依赖(`node:http`)、严格只读(拒绝非 GET),自动刷新:实时时间线、sessions、
|
|
343
|
+
冲突/归属状态,以及问责计分卡。
|
|
344
|
+
|
|
345
|
+
## MCP 服务器 — 接入任意 CLI
|
|
346
|
+
|
|
347
|
+
黑板用标准 MCP over stdio,所以**任何**支持 MCP 的客户端(Claude Code、Cursor、
|
|
348
|
+
Codex、Gemini CLI、VS Code、Windsurf……)都能读写这块板。一步生成你客户端专属的配置:
|
|
349
|
+
|
|
350
|
+
```bash
|
|
351
|
+
blackboard mcp-config cursor # → ~/.cursor/mcp.json 片段
|
|
352
|
+
blackboard mcp-config claude-code # → 项目 .mcp.json 片段
|
|
353
|
+
blackboard mcp-config codex # → ~/.codex/config.toml(TOML)
|
|
354
|
+
blackboard mcp-config gemini # → ~/.gemini/settings.json 片段
|
|
355
|
+
blackboard mcp-config vscode # → .vscode/mcp.json(servers 块)
|
|
356
|
+
blackboard mcp-config # → 通用 mcpServers JSON(任意客户端)
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
每条都会打印粘贴位置和现成片段,例如:
|
|
360
|
+
|
|
361
|
+
```json
|
|
362
|
+
{
|
|
363
|
+
"mcpServers": {
|
|
364
|
+
"blackboard": {
|
|
365
|
+
"command": "npx",
|
|
366
|
+
"args": ["-y", "octopus-blackboard-mcp"],
|
|
367
|
+
"env": { "OCTOBOARD_AGENT": "cursor" }
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
agent 身份默认取客户端名(Cursor 写成 `cursor`,Codex 写成 `codex`),用 `--agent`
|
|
374
|
+
覆盖。板子从工作目录的 `.octoboard/` 自动发现,或用 `--dir` 固定。两个 CLI 指向同一
|
|
375
|
+
个 `.octoboard/` 就共享一块板——这正是全部意义所在。
|
|
376
|
+
|
|
377
|
+
提供的工具——协调:`board_status`、`board_timeline`、`board_note`、`board_claim`、
|
|
378
|
+
`board_task_define`、`board_task`、`board_tasks`、`board_assign`、`board_progress`、
|
|
379
|
+
`board_message`、`board_inbox`、`board_handoffs`、`board_decision`、
|
|
380
|
+
`board_evidence`、`board_file_changed`、`board_risk`、`board_handoff`、
|
|
381
|
+
`board_heartbeat`、`board_since`;归属:`session_start`、`session_stop`、
|
|
382
|
+
`board_link`、`board_attribute`、`board_review`、`board_who`、`board_explain`、
|
|
383
|
+
`board_blame`、`board_unreviewed`、`board_report`;治理与可携带:`board_check`、
|
|
384
|
+
`board_export`、`board_import`、`board_trailers`、`board_sign`、`board_trust`、
|
|
385
|
+
`board_prune`、`board_redact`、`board_ingest`。每个工具都接受可选的 `agent` 参数,
|
|
386
|
+
用于按调用覆盖身份。
|
|
387
|
+
|
|
388
|
+
推荐模式:agent 在**开始工作前**调用 `board_status` 看看其他人在干什么,然后边做
|
|
389
|
+
边写。
|
|
390
|
+
|
|
391
|
+
## 数据模型
|
|
392
|
+
|
|
393
|
+
| 层 | 表 | 作用 |
|
|
394
|
+
|---|---|---|
|
|
395
|
+
| **谁在场** | `agents`、`sessions` | provider 无关的身份、session 上下文 |
|
|
396
|
+
| **正在发生** | `tasks`、`messages`、`handoffs` | 协调——认领、留言、交接 |
|
|
397
|
+
| **谁产出了什么** | `attributions`、`reviews` | AI/人类归属与 review,以 commit 为键 |
|
|
398
|
+
| **沉淀的事实** | `decisions`、`evidence`、`files_changed`、`risks`、`timeline` | 可审计的共享记忆 |
|
|
399
|
+
|
|
400
|
+
`timeline` 是 append-only 的哈希链,所有其他写入也会记录进去,因此黑板与它的审计
|
|
401
|
+
日志永远不会发散。
|
|
402
|
+
|
|
403
|
+
## 技术形态
|
|
404
|
+
|
|
405
|
+
```text
|
|
406
|
+
better-sqlite3(本地优先,默认)
|
|
407
|
+
+ MCP 服务器 (读 / 写黑板)
|
|
408
|
+
+ CLI (octoboard ...)
|
|
409
|
+
+ 哈希链审计日志(timeline)
|
|
410
|
+
+ 可选 Postgres sync (规划中)
|
|
411
|
+
+ 可选 git / file watcher(规划中)
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
## 状态
|
|
415
|
+
|
|
416
|
+
早期 MVP(v0.1)。已可用:本地 SQLite 黑板、CLI(`octoboard` / `blackboard`)、
|
|
417
|
+
MCP 服务器、可校验的哈希链 timeline、一等 session、provider 无关的 AI/人类归属(挂
|
|
418
|
+
到 Git commit)、review,以及查询层(`who`、`explain`、`commits`、`unreviewed`、
|
|
419
|
+
`joint`)。Git 集成为只读 + additive `git notes`——绝不 rewrite 历史。Postgres
|
|
420
|
+
同步与变更订阅在路线图上。
|
|
421
|
+
|
|
422
|
+
## 许可证
|
|
423
|
+
|
|
424
|
+
Apache-2.0 © Octoryn。见 [LICENSE](./LICENSE)。
|
|
Binary file
|
|
File without changes
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { FileChangeKind } from "./types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Transcript ingestion adapters. An adapter turns a CLI's session transcript
|
|
4
|
+
* into normalized ingest events the board can record under the active session —
|
|
5
|
+
* so file edits, decisions, and notes flow onto the board with minimal
|
|
6
|
+
* integration, without each CLI having to call the API directly.
|
|
7
|
+
*
|
|
8
|
+
* Two reliable paths ship:
|
|
9
|
+
* - `generic`: our own normalized schema (JSON `{events:[...]}` or JSONL of
|
|
10
|
+
* events). This is the stable integration path for ANY CLI — normalize the
|
|
11
|
+
* transcript to this shape and it just works.
|
|
12
|
+
* - a permissive tool-use JSONL heuristic used by `claude-code`, `codex`,
|
|
13
|
+
* `gemini`, and `grok`: it scans JSONL for file-editing tool calls
|
|
14
|
+
* (file_path / notebook_path, or a `path` beside an edit/write/patch tool).
|
|
15
|
+
*
|
|
16
|
+
* The heuristic is deliberately conservative and best-effort; as each CLI's
|
|
17
|
+
* format stabilizes, promote it to a dedicated parser. Provider-independent by
|
|
18
|
+
* design — no assumptions beyond "a transcript mentions files it edited".
|
|
19
|
+
*/
|
|
20
|
+
export type IngestEvent = {
|
|
21
|
+
type: "file";
|
|
22
|
+
path: string;
|
|
23
|
+
change: FileChangeKind;
|
|
24
|
+
} | {
|
|
25
|
+
type: "decision";
|
|
26
|
+
title: string;
|
|
27
|
+
rationale?: string;
|
|
28
|
+
} | {
|
|
29
|
+
type: "note";
|
|
30
|
+
text: string;
|
|
31
|
+
};
|
|
32
|
+
export interface Adapter {
|
|
33
|
+
name: string;
|
|
34
|
+
parse(content: string): IngestEvent[];
|
|
35
|
+
}
|
|
36
|
+
/** Our normalized schema: JSON `{events:[...]}`, a bare array, or JSONL. */
|
|
37
|
+
export declare const genericAdapter: Adapter;
|
|
38
|
+
export declare const ADAPTERS: string[];
|
|
39
|
+
export declare function getAdapter(name: string): Adapter | undefined;
|
|
40
|
+
//# sourceMappingURL=adapters.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACvC;AAiGD,4EAA4E;AAC5E,eAAO,MAAM,cAAc,EAAE,OAuB5B,CAAC;AAUF,eAAO,MAAM,QAAQ,EAAE,MAAM,EAA0B,CAAC;AAExD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D"}
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
function changeFromToolName(name) {
|
|
2
|
+
const n = name.toLowerCase();
|
|
3
|
+
if (/delete|remove|rm\b/.test(n))
|
|
4
|
+
return "deleted";
|
|
5
|
+
if (/write|create|add/.test(n))
|
|
6
|
+
return "added";
|
|
7
|
+
return "modified";
|
|
8
|
+
}
|
|
9
|
+
const EDIT_TOOL_RE = /edit|write|patch|create|apply|delete|remove/i;
|
|
10
|
+
/**
|
|
11
|
+
* Recursively collect file-edit events from an arbitrary parsed JSON value.
|
|
12
|
+
* `file_path` and `notebook_path` are treated as unambiguous edit targets; a
|
|
13
|
+
* bare `path` only counts under an edit/write/patch tool. The enclosing tool
|
|
14
|
+
* name is threaded down (`ctxTool`) because a transcript typically nests the
|
|
15
|
+
* path inside an `input`/`args` object one level below the tool name — so the
|
|
16
|
+
* change kind must be derived from the ancestor, not the leaf.
|
|
17
|
+
*/
|
|
18
|
+
const MAX_DEPTH = 200;
|
|
19
|
+
function collectFileEdits(value, out, ctxTool = "", depth = 0) {
|
|
20
|
+
// Bound recursion so a pathologically-nested (attacker-influenced) transcript
|
|
21
|
+
// cannot overflow the stack.
|
|
22
|
+
if (depth > MAX_DEPTH) {
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
if (Array.isArray(value)) {
|
|
26
|
+
for (const v of value)
|
|
27
|
+
collectFileEdits(v, out, ctxTool, depth + 1);
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
if (value === null || typeof value !== "object") {
|
|
31
|
+
return;
|
|
32
|
+
}
|
|
33
|
+
const obj = value;
|
|
34
|
+
const localTool = [obj.name, obj.tool, obj.type, obj.function]
|
|
35
|
+
.filter((v) => typeof v === "string")
|
|
36
|
+
.join(" ");
|
|
37
|
+
// Prefer a tool-shaped local name; otherwise keep the ancestor's.
|
|
38
|
+
const toolName = EDIT_TOOL_RE.test(localTool) ? localTool : ctxTool;
|
|
39
|
+
const change = changeFromToolName(toolName);
|
|
40
|
+
for (const key of ["file_path", "notebook_path"]) {
|
|
41
|
+
if (typeof obj[key] === "string" && obj[key].length > 0) {
|
|
42
|
+
out.set(obj[key], change);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
if (EDIT_TOOL_RE.test(toolName) &&
|
|
46
|
+
typeof obj.path === "string" &&
|
|
47
|
+
obj.path.length > 0) {
|
|
48
|
+
out.set(obj.path, change);
|
|
49
|
+
}
|
|
50
|
+
for (const v of Object.values(obj)) {
|
|
51
|
+
collectFileEdits(v, out, toolName, depth + 1);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/** Parse JSONL lines tolerantly, skipping blank/malformed lines. */
|
|
55
|
+
function parseJsonl(content) {
|
|
56
|
+
const out = [];
|
|
57
|
+
for (const line of content.split("\n")) {
|
|
58
|
+
const trimmed = line.trim();
|
|
59
|
+
if (trimmed.length === 0)
|
|
60
|
+
continue;
|
|
61
|
+
try {
|
|
62
|
+
out.push(JSON.parse(trimmed));
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
/* skip malformed line */
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
return out;
|
|
69
|
+
}
|
|
70
|
+
/** The tool-use JSONL heuristic shared by real-CLI adapters. */
|
|
71
|
+
function heuristicAdapter(name) {
|
|
72
|
+
return {
|
|
73
|
+
name,
|
|
74
|
+
parse(content) {
|
|
75
|
+
const edits = new Map();
|
|
76
|
+
for (const entry of parseJsonl(content)) {
|
|
77
|
+
collectFileEdits(entry, edits);
|
|
78
|
+
}
|
|
79
|
+
return [...edits.entries()].map(([path, change]) => ({
|
|
80
|
+
type: "file",
|
|
81
|
+
path,
|
|
82
|
+
change,
|
|
83
|
+
}));
|
|
84
|
+
},
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
/** Our normalized schema: JSON `{events:[...]}`, a bare array, or JSONL. */
|
|
88
|
+
export const genericAdapter = {
|
|
89
|
+
name: "generic",
|
|
90
|
+
parse(content) {
|
|
91
|
+
const isEvent = (e) => typeof e === "object" &&
|
|
92
|
+
e !== null &&
|
|
93
|
+
(e.type === "file" ||
|
|
94
|
+
e.type === "decision" ||
|
|
95
|
+
e.type === "note");
|
|
96
|
+
const trimmed = content.trim();
|
|
97
|
+
let raw;
|
|
98
|
+
try {
|
|
99
|
+
const parsed = JSON.parse(trimmed);
|
|
100
|
+
if (Array.isArray(parsed))
|
|
101
|
+
raw = parsed;
|
|
102
|
+
else if (parsed && Array.isArray(parsed.events))
|
|
103
|
+
raw = parsed.events;
|
|
104
|
+
else
|
|
105
|
+
raw = [parsed];
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
raw = parseJsonl(trimmed); // fall back to JSONL of events
|
|
109
|
+
}
|
|
110
|
+
return raw.filter(isEvent);
|
|
111
|
+
},
|
|
112
|
+
};
|
|
113
|
+
const REGISTRY = {
|
|
114
|
+
generic: genericAdapter,
|
|
115
|
+
"claude-code": heuristicAdapter("claude-code"),
|
|
116
|
+
codex: heuristicAdapter("codex"),
|
|
117
|
+
gemini: heuristicAdapter("gemini"),
|
|
118
|
+
grok: heuristicAdapter("grok"),
|
|
119
|
+
};
|
|
120
|
+
export const ADAPTERS = Object.keys(REGISTRY);
|
|
121
|
+
export function getAdapter(name) {
|
|
122
|
+
return REGISTRY[name];
|
|
123
|
+
}
|
|
124
|
+
//# sourceMappingURL=adapters.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"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"}
|