# Decisions

This directory contains the decision history for ows-coda -- the _why_ behind what we built.

## Technical Reference Documents (TRDs)

TRDs capture design rationale, alternatives explored, and decision logs for significant engineering work.

See [trds/README.md](trds/README.md) for the full index with status tracking.

## Architecture Decision Records (ADRs)

| ADR                                                  | Summary                                       |
| ---------------------------------------------------- | --------------------------------------------- |
| [ADR-068](adrs/ADR-068-uuid-varchar36-storage.md)    | UUID stored as VARCHAR(36)                    |
| [Sandbox decisions](adrs/sandbox-decisions.md)       | isolated-vm, dual timeout, WASM injection     |
| [Platform edge cases](adrs/platform-edge-cases.md)   | Open design questions for platform service    |
| [Cortex Analyst](adrs/cortex-analyst-integration.md) | Cortex Analyst integration design exploration |

## Product Requirements Documents (PRDs)

| PRD                                                        | Summary                                     |
| ---------------------------------------------------------- | ------------------------------------------- |
| [Sandbox engine](prds/sandbox-engine.md)                   | V8 isolate execution for LLM-generated code |
| [Dashboards](prds/dashboards.md)                           | Multi-tenant analytics dashboards           |
| [Enterprise permissions](prds/enterprise-permissions.md)   | Multi-tenancy, RBAC, ABAC, audit            |
| [Message feedback](prds/message-feedback.md)               | Thumbs up/down on assistant messages        |
| [Offline client](prds/offline-client-cursor-pagination.md) | Cursor-based pagination for offline sync    |
| [Auth error page](prds/auth-error-page.md)                 | Auth failure messaging and UX               |
| [Platform pricing](prds/platform-pricing.md)               | Plan tiers, credits, rate limits (Phase 2)  |
| [Platform user stories](prds/platform-user-stories.md)     | Workflow user stories (Phase 2+)            |