64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# Continuity Plugin（MVP）
|
||
|
||
這個套件目前是把既有 approved-plan continuity hard gate 抽離成可安裝 plugin 的骨架。
|
||
|
||
## MVP 狀態
|
||
|
||
- Task 2：已建立 package skeleton
|
||
- Task 3：已先放入 config schema contract 骨架
|
||
- Task 4：已補 config validation 測試
|
||
- Task 5：已實作 minimal config validator
|
||
- Task 6：已抽出 receipt validator contract
|
||
- evaluator / adapter 邏輯目前仍未實作
|
||
|
||
## 目錄
|
||
|
||
```text
|
||
plugins/continuity/
|
||
README.md
|
||
README.zh-TW.md
|
||
HOOK.md
|
||
package.json
|
||
examples/
|
||
src/
|
||
test/
|
||
```
|
||
|
||
## 預計公開介面
|
||
|
||
- `src/config/schema.mjs`
|
||
- `src/config/defaults.mjs`
|
||
- `src/continuity/evaluator.mjs`
|
||
- `src/continuity/receipt-validator.mjs`
|
||
- `src/adapters/force-recall.mjs`
|
||
- `src/index.mjs`
|
||
|
||
## 範例設定
|
||
|
||
請參考 `examples/openclaw.continuity.example.json`。
|
||
|
||
## Receipt validator contract
|
||
|
||
目前 MVP receipt validator 最小欄位如下：
|
||
|
||
- `planId`
|
||
- `currentTask`
|
||
- `nextDerivedAction`
|
||
- `dispatchedAt`
|
||
- `dispatchRunId`
|
||
- `childSessionKey`
|
||
- `replyClosureState`
|
||
|
||
API 介面：
|
||
|
||
- `validateReceipt(receipt)`
|
||
- `isValidReceipt(receipt)`
|
||
|
||
抽出的 contract 說明見 `src/continuity/types.md`。
|
||
|
||
## 備註
|
||
|
||
- 預設保留目前 terminal states：`waiting_user`、`blocked`、`pending_verification`
|
||
- 預設 receipt 目錄：`state/approved-plan-continuity`
|
||
- `npm test` 先保留給後續依計畫補上的完整測試流程
|