# Changelog

All notable changes to this project will be documented in this file.

The format is inspired by Keep a Changelog and follows a simple unreleased-first structure.

## [Unreleased]

### Added

- email-first AI agent runtime scaffold on Cloudflare Workers, R2, D1, Queues, and Amazon SES
- inbound email handling, normalization, threading, and task creation
- outbound draft creation and SES sending support, including Raw MIME handling
- SES webhook ingestion for delivery lifecycle events
- D1-backed repositories for agents, mailboxes, messages, threads, tasks, drafts, and outbound jobs
- signed bearer token auth with tenant, agent, mailbox, and scope checks
- local smoke testing flow, fixtures, and debug endpoints
- multi-environment Wrangler configuration for local, dev, staging, and production
- GitHub Actions CI and manual deploy workflow
- AI-focused documentation set:
  - `docs/ai-onboarding.md`
  - `docs/ai-decision-rules.md`
  - `docs/ai-auth.md`
  - `docs/ai-agents.md`
  - `docs/ai-mail-workflows.md`
  - `docs/ai-debug.md`
  - `docs/mcp-local.md`
  - `docs/mcp-tools.schema.json`
  - `llms-full.txt`
- idempotency support for draft send, message replay, and admin send flows
- idempotency key storage and retention cleanup:
  - `migrations/0002_idempotency_keys.sql`
  - scheduled cleanup handler
  - admin maintenance APIs for listing and pruning idempotency keys
- admin dashboard idempotency operations view
- versioned agent compatibility contract at `/v2/meta/compatibility`, including:
  - stable MCP error code catalog
  - compatibility version metadata
  - deprecation and evolution policy fields
- open source project files:
  - `LICENSE`
  - `SECURITY.md`
  - `CONTRIBUTING.md`
  - `CODE_OF_CONDUCT.md`
  - issue templates
  - pull request template

### Changed

- sanitized tracked configuration to avoid committing live infrastructure identifiers
- adjusted queue handling to normalize Cloudflare queue names across environments
- updated README and deployment docs for open source and GitHub-based workflows
- restructured `README.md` into a clearer project homepage with status, documentation, layout, and deploy summaries
- added `docs/README.md` as the documentation landing page for integrators, operators, and contributors
- added `docs/archive/` for dated rollout and verification records that should not stay mixed into long-lived guides
- clarified `docs/local-dev.md` to distinguish pure local development from remote Cloudflare and SES-backed validation
- aligned `docs/deployment.md` and `docs/production-rollout-checklist.md` with the current verified production state
- updated `SECURITY.md`, `.dev.vars.example`, and `CONTRIBUTING.md` to better explain public config, local env vars, validation expectations, and doc-sync requirements
- aligned `docs/openapi.yaml` with current route behavior, request requirements, and debug endpoints
- updated local smoke coverage to assert idempotent send and replay behavior
- added hourly cron configuration and retention vars for idempotency cleanup