feat: tamper-evident audit ledger (hash chain) + dual-column cost view

- Hash-chain ledger (cloud/ledger.py): prev_hash/entry_hash per record,
  SQLite append-only triggers, UNIQUE prev/entry hash with fail-closed
  retry at the transaction boundary; verify/export (incl. expected-head
  check for tail truncation); legacy audit_log rows marked pre-chain via
  a single ledger_genesis marker, never rewritten.
- AuthStore.audit() writes audit_log + chain entry in one transaction.
- Track-3 interface: audit_verdict / audit_pushback_round /
  audit_rebuild / third-failure assessment / test-change audit /
  meta-review / rebuild-notice entries; per-(module, contract-version)
  failure counts derived from the ledger (pass or completed rebuild
  resets; total > 3 triggers rebuild); acceptance-triggered rebuilds
  require a confirmed user notice.
- Admin read-only endpoints: GET /admin/audit-ledger/verify|export.
- Cost: dual_column_view (priced_usd_micros + billing note, wording
  reused verbatim from PR #212) wired into project/task cost endpoints;
  by-model and per-creator reporting stay in #212, not duplicated here.
- PG schema + migration lists updated for audit_ledger (incl. sequence
  setval alignment).
This commit is contained in:
host committed 2026-11-03 02:49:25 +00:00
1 parent c0ab995ccc
commit eeb10118d6
7 files changed
+2121 -10

No files matched your search

+55 -1
View File
@@ -63,9 +63,11 @@ from cloud.auth import ROLES as _MEMBER_ROLES
from cloud.auth import AuthStore
from cloud.coordinator import parse_parts as _coord_parse_parts
from cloud.coordinator import validate_parts as _coord_validate_parts
from cloud.cost import CostStore, unpriced_token_cap
from cloud.cost import unpriced_token_cap
from cloud.gates import merge_state_decision as _merge_state_decision
from cloud.gates import resolve_inside as _gate_resolve_inside
from cloud.ledger import export_chain as _ledger_export
from cloud.ledger import verify_chain as _ledger_verify
from cloud.quota import decide as _quota_decide
from cloud.quota import default_quota_usd_micros as _quota_default
from cloud.quota import monthly_usage as _quota_monthly_usage
@@ -3075,6 +3077,10 @@ class CloudControlPlaneHandler(BaseHTTPRequestHandler):
self._admin_quota_get(user_id, query)
elif path == "/admin/quotas" and method == "POST":
self._admin_quota_set(user_id)
elif path == "/admin/audit-ledger/verify" and method == "GET":
self._admin_ledger_verify(user_id)
elif path == "/admin/audit-ledger/export" and method == "GET":
self._admin_ledger_export(user_id, query)
elif path == "/admin/push/dispatch" and method == "POST":
self._push_dispatch_endpoint(user_id)
elif path.startswith("/tasks/"):
@@ -8997,6 +9003,54 @@ class CloudControlPlaneHandler(BaseHTTPRequestHandler):
target, quota, used, month,
self._quota_unpriced_tokens(target)))
def _admin_ledger_verify(self, user_id):
"""GET /admin/audit-ledger/verify:全局管理员只读校验账本。
只读:成功路径不写审计(写审计会改链头,校验读数本身
就不再可复现);被拒才记 admin_ledger_denied。校验失败
仍回 200,ok=false + failures 供运维判读,不是 HTTP 错。
"""
if not self._is_global_admin(user_id):
self._audit_admin(user_id, "admin_ledger_denied",
"verify ledger")
self._send_json(403, {"error": "forbidden"})
return
conn = self._db()
try:
result = _ledger_verify(conn)
finally:
conn.close()
self._send_json(200, result)
def _admin_ledger_export(self, user_id, query):
"""GET /admin/audit-ledger/export:全局管理员只读导出账本。
?limit=N 可截断(运维取头锚点用);limit 非法回 400。
导出含头哈希,运维应把头哈希存到库外作比对锚点。
"""
if not self._is_global_admin(user_id):
self._audit_admin(user_id, "admin_ledger_denied",
"export ledger")
self._send_json(403, {"error": "forbidden"})
return
limit_raw = (query.get("limit") or [None])[0]
limit = None
if limit_raw is not None:
try:
limit = int(limit_raw)
except (TypeError, ValueError):
limit = -1
if limit < 0:
self._send_json(
400, {"error": "limit must be a non-negative integer"})
return
conn = self._db()
try:
result = _ledger_export(conn, limit=limit)
finally:
conn.close()
self._send_json(200, result)
def _admin_quota_set(self, user_id):
if not self._is_global_admin(user_id):
self._audit_admin(user_id, "admin_quota_denied",