aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
RFC: centralized policy framework with PolicyDecisionEvent
- Ngôn ngữ chính
- TypeScript
- Star
- 143
- Fork
- 46
- Merge trung bình
- 3 ngày 10 giờ
- Pull request đã merge (30 ngày)
- 24
Mô tả
**Context:** ROADMAP.md → Centralized policy framework
**Related:** #230 (event-driven governance), Cedar HITL (shipped)
---
## Primary area
Cross-cutting / multiple
## Related issue or feature request
#230 (Event-Driven Governance and Actions), shipped Cedar HITL gates
## Summary
Unified **Cedar-based policy framework** with `PolicyDecisionEvent` audit schema. Three enforcement modes with **observe-before-enforce** rollout across tool calls, lifecycle events, and future event-driven governance.
## Use case and motivation
Policy decisions today are fragmented (PreToolUse Cedar, guardrails, bash allowlists). Compliance needs a single auditable decision stream and consistent observe/enforce rollout.
## Proposal
1. Define `PolicyDecisionEvent` schema: `decision`, `policy_id`, `matching_rule_ids`, `context`, `task_id`, timestamp.
2. Emit on every Cedar evaluation + lifecycle policy hook (#230).
3. Modes: `observe`, `enforce`, `disabled` per policy pack.
4. Export to immutable audit (#237) when available.
5. Operator dashboard: deny rates by repo/policy.
## Out of scope
- Replacing Bedrock Guardrails (input/output screening stays separate).
- Full implementation of all #230 semantic gates in v1.
## Potential challenges
- cedarpy/cedar-wasm parity (see AGENTS.md cedar pin rules).
- Volume of decision events at high task throughput.
- Migration from current HITL-only audit shape.
## Dependencies and integrations
- `TaskEventsTable`, FanOutConsumer, #230 RFC.
- `docs/design/CEDAR_HITL_GATES.md`.
## Alternative solutions
- Extend current HITL audit only—less unified for non-tool policies.
- OPA/Cedar split—rejected for dual engine maintenance.
---
**Note:** Non-triaged RFCs may not get timely review.
- RFC PR:
- Approved by:
- Reviewed by:
Hướng dẫn đóng góp
Hướng nghiên cứu
Trước tiên, hãy đọc ROADMAP.md tại mục «Centralized policy framework» và docs/design/CEDAR_HITL_GATES.md, sau đó xem lại các tham chiếu đến TaskEventsTable và FanOutConsumer. Đề xuất này bao gồm việc đánh giá Cedar, các lifecycle hook, các chế độ rollout, tính năng xuất audit và một dashboard; để được coi là hoàn tất, phạm vi phải được review và phê duyệt, đồng thời các trường RFC không còn được để trống.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- aws, typescript
- Lĩnh vực
- backend-api-design, observability, security
- Loại issue
- Tính năng
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức độ hoạt động
- Ít trao đổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 35/100