59 lines
3.4 KiB
Python
59 lines
3.4 KiB
Python
# ============================================================
|
||
# 审计 v1（moduleId: core-audit, 可重生 ✅）
|
||
# plan.md §3.6 的最小实现：5W1H 事件 + 链式哈希（prev_hash → hash）
|
||
# M1 简化：锚定/WORM/保留策略后置；事件存于世界状态 auditEvents 表
|
||
# ============================================================
|
||
from __future__ import annotations # 前向类型引用
|
||
|
||
import hashlib # SHA-256 哈希链
|
||
import json # 规范化序列化
|
||
from datetime import datetime # 时间戳
|
||
from typing import Any # 类型标注
|
||
|
||
from server.timeutil import fmt_dt # 时间格式化
|
||
|
||
# 世界状态类型别名
|
||
World = dict[str, Any]
|
||
|
||
|
||
def write_audit(world: World, next_id, *, actor: str, category: str, action: str,
|
||
target: dict[str, Any], power: str, rationale: dict[str, Any],
|
||
result: str = "SUCCESS") -> dict[str, Any]:
|
||
"""写入一条审计事件（append-only；调用方负责随后 save）。
|
||
|
||
权力等级：P0（审计本身只追加，不改业务数据）。
|
||
Args:
|
||
world: 世界状态（事件追加到 auditEvents）
|
||
next_id: 发号函数
|
||
actor: 谁（用户/agent 标识）
|
||
category: 事件大类（§3.6.2：SESSION/PLAN/MODEL/TOOL/GATE/WORLD_WRITE/...）
|
||
action: 具体动作名（如 schedule.publish）
|
||
target: 作用对象 {type, id, ...}
|
||
power: 权力等级 P0-P3
|
||
rationale: 依据 {intent/evidence/confirmId/approver...}
|
||
result: 结果 SUCCESS/DENIED/FAILED
|
||
Returns:
|
||
写入的事件对象（含哈希）
|
||
"""
|
||
events = world.setdefault("auditEvents", []) # 审计表（缺失自动补）
|
||
prev_hash = events[-1]["hash"] if events else "GENESIS" # 链头：上一事件哈希或创世标记
|
||
at = fmt_dt(datetime.now()) # 单事件统一时间戳
|
||
event: dict[str, Any] = { # 5W1H 事件体（§3.6.1 的 M1 子集）
|
||
"id": next_id("audit"), # 事件 ID
|
||
"at": at, # When（前端契约字段）
|
||
"ts": at, # 兼容旧数据字段
|
||
"actor": actor, # Who
|
||
"category": category, # What（大类）
|
||
"action": action, # What（动作）
|
||
"target": target, # Where（对象）
|
||
"power": power, # 权力等级
|
||
"rationale": rationale, # Why（依据）
|
||
"result": result, # 结果
|
||
"prevHash": prev_hash, # 链式哈希：前驱
|
||
}
|
||
# 本事件哈希 = SHA256(前驱哈希 ‖ 事件体规范化 JSON)——任何中间篡改都会断链
|
||
payload = prev_hash + json.dumps(event, ensure_ascii=False, sort_keys=True)
|
||
event["hash"] = hashlib.sha256(payload.encode("utf-8")).hexdigest() # 计算并挂载
|
||
events.append(event) # 追加入链（append-only）
|
||
return event # 返回事件（供响应引用）
|