aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

RFC: centralized policy framework with PolicyDecisionEvent

オープン
#482 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
governance RFC-proposal security
主要言語
TypeScript
スター
143
フォーク
46
平均マージ
3日 10時間
マージ済み PR(30日)
24

説明

**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:

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

まず ROADMAP.md の「Centralized policy framework」エントリと docs/design/CEDAR_HITL_GATES.md を読み、その後 TaskEventsTable と FanOutConsumer の参照を確認してください。提案の範囲は Cedar の評価、ライフサイクルフック、ロールアウトモード、監査エクスポート、ダッシュボードに及びます。完了の条件は、レビューおよび承認済みのスコープがあること、そして RFC フィールドが空欄でなくなっていることです。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
aws, typescript
領域
backend-api-design, observability, security
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。