Skip to content

docs: record the capture trust contract - #439

Merged
guan4tou2 merged 3 commits into
mainfrom
docs/capture-trust-contract
Oct 24, 2026
Merged

guan4tou2 merged 3 commits into
mainfrom
docs/capture-trust-contract

Conversation

@guan4tou2

Copy link
Copy Markdown
Owner

內容

新增 docs/DESIGN-capture-trust.md,並在 docs/README.md 的索引加一行連結。

這份文件把 Spec 062 之後那一輪審查的共識寫成擷取可信度規範:

  • 兩個不變條件:不把「沒記到」說成「沒發生」;不把「已隱藏或不匯出」說成「沒保存」
  • 寫入成功後才推進進度,並要求附故障注入測試
  • 暫停期間不保存任何新內容,sidecar 原文也包括在內
  • 輸出完整性的狀態,以及不能為了記錄而改變工具行為
  • 網路擷取以 HTTP(S) 為主
  • 證據等級
  • 在擷取時就處理隱私邊界
  • 讀取可靠性、效能紀律、不做清單、交付規則

最後附一份 2026-10-24 的狀態快照,每項標明「已修/已確認但未修/已回報但未核對」。

審查重點

  • §3 和目前程式碼的刻意設計相反:tailer-host.ts 暫停時仍把原始 AI 資料寫進 sidecar,capture_gap 的描述也寫著 "Raw data preserved in sidecar"。這份文件把行為定為暫停時也不保存,實作還沒改。
  • §12 會隨程式碼過時:文件開頭已註明動手前要先對照程式碼;位置用函式名稱標,不用行號。

驗證

純文件,沒有程式碼變更。文件引用的機制名稱都已和程式碼核對:completeness、capture_gap、*_saturated、personalDomains、hidePersonal、_REDLOG_MAX_BYTES、maxCastBytes。

🤖 Generated with Claude Code

The rules agreed in the review round after Spec 062: progress follows
persistence, pause keeps nothing new, output completeness states,
HTTP(S)-first network scope, evidence levels, privacy at the capture
boundary, reading back without losing place, cost discipline, and what
is deliberately not built. Ends with a dated snapshot of which reported
gaps are fixed, confirmed open, or not yet verified.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 3460feb3-9faf-43ad-9933-4f8e75a46406
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

guan4tou2 and others added 2 commits October 24, 2026 19:13
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@guan4tou2
guan4tou2 merged commit 55af51c into main Oct 24, 2026
6 checks passed
@guan4tou2
guan4tou2 deleted the docs/capture-trust-contract branch October 24, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant