aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
RFC: centralized policy framework with PolicyDecisionEvent
- Lenguaje dominante
- TypeScript
- Estrellas
- 143
- Forks
- 46
- Merge medio
- 3 d 10 h
- PR fusionados (30 d)
- 24
Descripción
**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:
Guía de contribución
Línea de trabajo
Lee primero ROADMAP.md en la entrada «Centralized policy framework» y docs/design/CEDAR_HITL_GATES.md; después revisa las referencias a TaskEventsTable y FanOutConsumer. La propuesta abarca la evaluación de Cedar, hooks del ciclo de vida, modos de rollout, exportación de auditoría y un dashboard; para darla por terminada se requiere un alcance revisado y aprobado, y los campos del RFC ya no deben estar vacíos.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- aws, typescript
- Área
- backend-api-design, observability, security
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Tranquilo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 35/100