tmpdot/dsh-audit-foundation--packages-audit-ledger0

dsh-audit-ledger

Trust Anchor audit ledger (D5, base scope): paired harness-event aggregation into the 'audit' storage domain with hash chain and retention policy. Skeleton: pure derivation functions, zero DSH deps, CI-testable; plugin shell (apply) planned

包名
dsh-audit-ledger
版本
0.1.0
许可证
Apache-2.0
最近更新
2026年8月21日

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

dsh-audit-ledger —— 审计记录插件(D5 已拍板:首期做,基础范围)

Trust Anchor(dsh-audit-foundation)的审计记录插件:把 harness 关键事件 聚合为追加式审计记录写入 audit 域(成对事件聚合 + 哈希链 + 保留策略)。 消费 harness 事件,不发明平行语义(M4/M8);schema 归 dsh-audit-spec(M0:禁止同构重声明)。

状态

  • 骨架 v0.1(2026-08):纯函数层已落地(src/derive.mjs,零 DSH 依赖, CI 可测);插件壳(apply / storageDomain 写路径)规划中——host 侧改动 需 harness 重启验证,不在本仓 CI 内。

写路径(M6,唯一且显式)

写路径内容校验
audit 域(storageDomain,表 records追加式审计记录(只增不改;prevHash 哈希链)记录先过 dsh-audit-specauditRecordSchema;保留逐出用 dsh-audit-commoncomputeRetention(只算不删,删归本插件写路径)
  • 只读消费 harness 事件(approval/*permission/presettool/*checkpoint/*),不写其他存储(M6 不变量 3)。
  • 降级(M5):事件流缺席 → 明确标注 degraded,绝不静默。

职责边界(M1)

  • :基础范围——成对事件聚合(tool 成对 / approval 成对)、哈希链、 保留策略(auditPolicySchema,F19)。
  • 不做(留给生态):高级分析/聚合报表、签名密封(D6)、判定消费 (F16 由 timeline 消费)。

纯函数层用法

import { deriveAuditDrafts } from 'dsh-audit-ledger'
// 会话事件序列 → 审计记录草案(id/seq/time/prevHash 由写路径落盘补齐)
const drafts = deriveAuditDrafts(events, { sessionId })

合规自证(MDP)

  • M0:不重声明 schema——写路径校验用 dsh-audit-spec 导出。
  • M6:写路径唯一(上表);路径校验归 dsh-audit-common pathguard。
  • M7:prevHash 哈希链;"可验证 ≠ 不可篡改"(不密封、不签名)。
  • M8:复用 harness 事件与服务;不 fork 上游。
  • M9:保留语义显式(auditPolicySchema 配额 + DOMAINS §3 文档化)。