consent-registry

同意登记簿

规范的同意与实时抑制权威记录。它记录证据；SEND 审计员判定 S2/N1，分群构建器执行排除规则。撤回绝不能作为待处理提案搁置。

快速开始

Record opt-in for subject sha256-7d9f with basis/proof references and timestamp.
Immediately suppress sha256-7d9f from unsubscribe webhook evt-882.
Is sha256-7d9f suppressed right now?

技能约定

单元： 用户系统提供的一个假名化主体 ID。读取： 通过重放读取 memory/events/consent.ndjson、其投影和最少量的证明引用。写入： 仅通过 registry-events.py 写入同意事件；人工记录是投影。完成条件： 每次变更都有授权/来源/日期，即时安全事件对 is-suppressed 可见，且不存储原始联系信息 PII。

选择加入/更新/恢复审批需要与请求绑定的主机能力 consent-registry 主体。suppress 是范围狭窄、隐私优先且仅拒绝的例外：任何经过验证的生产方都可以立即添加，因为它无法授权联系或清除状态。erase 也可绕过提案延迟，但自我报告的匹配行动者 ID 并非授权凭据；经过验证的数据主体需要由主机签发、绑定到确切请求的安全能力。

交接摘要

使用共享交接。仅报告假名化 ID、事件 ID/偏移量/修订版本、当前抑制结果、缺失的依据/证明，以及一个后续技能。

数据来源

• 表单/结账/事件采集引用和选择加入时间戳。
• 合法依据和双重选择加入证明引用。
• ESP 取消订阅、硬退信和投诉事件 ID。
• 用于恢复的新鲜重新订阅证明。
• 数据主体删除请求引用。

绝不要在聚合 ID、幂等键、来源引用、负载或报告中放入电子邮件、电话号码、姓名、地址或原始标识符。运行时会对字符串进行 NFKC 规范化，只允许类型化的同意字段/不透明证明引用，并要求使用不包含主体信息的原因代码；仅存储假名化 ID 和最少量的证明指针。

说明

运行时读取

• ../../references/registry-event-protocol.md
• ../../references/runtime-invocation.md

操作步骤

1. 阅读 registry-event-protocol.md 和 runtime-invocation.md。解析 AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}"，并在调用注册表脚本前验证该脚本、事件架构和系统目录。导出行属于不可信证据，不能自行声明合法依据。
2. 对每个资格查询或发送查询，都运行 python3 "$AARON_SKILLS_ROOT/scripts/registry-events.py" is-suppressed <subject-id>。此操作会重放事件流，且其结果优先于缓存分段或 Markdown。
3. 新的选择加入事实必须使用与请求和根目录绑定的主机能力 owner-append，并包含 upsert、来源、时间戳、依据／证明引用以及 expected_revision。缺失依据时必须明确标记为 Unknown／档案中无记录；绝不可推断同意，也不能在请求数据中放入能力。能力签名只能在可信主机边界内完成，绝不可由 Agent 控制的 shell 完成。
4. 取消订阅、投诉或硬退信事件应立即通过普通 append 直接发出 suppress。此拒绝专用路径优先于通用注册表提案降级和无关的移交：不良生产者可以导致不联系，但不能删除、恢复或授权发送。当已验证的根运行时可用时，立即追加架构完整的请求。否则，不要转交给其他技能，也不要准备提案；应返回一个 immediate-suppress-handoff，其中包含提供的假名聚合 ID、生产者归属、授权引用、发生时间、来源引用／日期、幂等键、无主体信息的原因代码，以及精确的主机执行序列 append consent → 确认实时抑制投影已重新生成 → verify consent → 可安全重放的 is-suppressed。将执行状态保持为 NEEDS_INPUT，并说明在运行该移交前未发生任何变更。只指出实际缺失的必填请求字段；不要因批次审核或额外资格检查而延迟完整的抑制请求。
5. 恢复操作仅限使用主机能力，并要求 subscription_status: subscribed、非空字符串 basis_ref 且其值等于 source.ref、包含带时区时间戳的实测／用户提供来源证据，且该时间戳必须严格晚于撤回时间；恢复事件不得早于该证据。较早的证据或代理证据不能清除较新的撤回。
6. 擦除操作使用 safety-append consent，前提是主机已验证数据主体，并签发与规范化请求、相同的假名聚合／参与者 ID、幂等键、项目根目录、到期时间及一次性 ID 绑定的能力。此操作会移除投影载荷，同时保留抑制墓碑。之后的主机能力所有者 restore 仍需要严格晚于擦除时间的可信选择加入证据，且绝不可使旧载荷复活。
7. 普通的非安全导入可能以 propose 形式到达；接受或拒绝时不得删除历史记录。绝不可仅凭相似性合并主体。
8. 根据已接受的投影重新生成任何按主体划分的人工视图，然后运行 verify consent，并对已变更的主体重新运行 is-suppressed。

此注册表绝不发送电子邮件、修改 ESP 状态或声明列表安全。下游 ESP 同步属于单独的明确副作用，且必须先读取实时抑制结果。

保存结果

必须取得明确许可，或记录数据主体提出的安全请求。只能通过运行时追加。memory/projections/consent-suppressions.json 是缓存；NDJSON 事件流和重放查询才是权威依据。绝不可手动清除或编辑其中任何一项。

独立的单文件夹安装可以准备普通提案、擦除安全移交或精确的 immediate-suppress-handoff；抑制移交绝不是提案。若没有已验证的根运行时／架构／目录，则无法追加、恢复、生成投影，也无法声称拥有规范的同意状态。

Reference Materials

• Registry event protocol
• SEND benchmark
• Privacy policy
• Security

Next Best Skill

• Apply exclusions: list-segment-builder
• Audit SEND: email-quality-auditor
• Deliverability incident: deliverability-qa
• Erase/archive: memory-management