docs: prepare v0.4.0 release documentation

grokify · claude · grokify · commit ccd186ce85da · 2026-03-22T19:29:48.000-07:00
- Add v0.4.0 release notes covering PostgreSQL, SMS, webhook features
- Update configuration.md with database and webhook sections
- Update CHANGELOG.json and regenerate CHANGELOG.md
- Add v0.4.0 to mkdocs.yml navigation

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.json b/CHANGELOG.json
@@ -5,6 +5,47 @@
   "versioning": "semver",
   "commitConvention": "conventional",
   "releases": [
+    {
+      "version": "v0.4.0",
+      "date": "2026-03-22",
+      "highlights": [
+        { "description": "PostgreSQL support with Row-Level Security (RLS) for multi-tenancy" },
+        { "description": "SMS chat provider for sending and receiving messages via Twilio/Telnyx" },
+        { "description": "Webhook server for inbound SMS and voice status callbacks" },
+        { "description": "Updated dependencies: omnichat v0.4.0 (Slack, Gmail) and omnivoice v0.7.0" }
+      ],
+      "added": [
+        { "description": "PostgreSQL database driver with multi-tenancy support", "commit": "27a2494" },
+        { "description": "Row-Level Security (RLS) policies for PostgreSQL tenant isolation", "commit": "27a2494" },
+        { "description": "Tenant context package for managing tenant_id in request context", "commit": "27a2494" },
+        { "description": "Ent privacy policies for application-level tenant filtering", "commit": "63657c5" },
+        { "description": "Database abstraction layer supporting SQLite and PostgreSQL", "commit": "dbd4f27" },
+        { "description": "Webhook server for Twilio and Telnyx callbacks", "commit": "26af01c" },
+        { "description": "SMS chat provider for omnichat integration", "commit": "230a996" },
+        { "description": "Slack configuration with Socket Mode support", "commit": "e1c2eb7" },
+        { "description": "Gmail configuration with OAuth 2.0 support", "commit": "e1c2eb7" },
+        { "description": "SMS and webhook configuration options", "commit": "e1c2eb7" }
+      ],
+      "tests": [
+        { "description": "Unit tests for tenant context (100% coverage)", "commit": "8f35e59" },
+        { "description": "Unit tests for database abstraction layer", "commit": "8f35e59" },
+        { "description": "Unit tests for RLS policy application", "commit": "8f35e59" }
+      ],
+      "documentation": [
+        { "description": "Gmail setup guide for OAuth 2.0 configuration", "commit": "b54548f" },
+        { "description": "Slack setup guide for Socket Mode configuration", "commit": "b54548f" },
+        { "description": "Configuration guide updates for database and webhook settings", "commit": "b54548f" }
+      ],
+      "chore": [
+        { "description": "Add site/ and IDEATION_*.md to gitignore", "commit": "1859562" }
+      ],
+      "dependencies": [
+        { "description": "Update omnichat to v0.4.0 (Slack, Gmail providers)", "commit": "96bb592" },
+        { "description": "Update omnivoice to v0.7.0", "commit": "96bb592" },
+        { "description": "Add lib/pq v1.12.0 for PostgreSQL driver", "commit": "96bb592" },
+        { "description": "Update modernc.org/sqlite to v1.47.0", "commit": "96bb592" }
+      ]
+    },
     {
       "version": "v0.3.0",
       "date": "2026-03-16",
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,47 @@ and this changelog is generated by [Structured Changelog](https://github.com/gro
 
 ## [Unreleased]
 
+## [v0.4.0] - 2026-03-22
+
+### Highlights
+
+- PostgreSQL support with Row-Level Security (RLS) for multi-tenancy
+- SMS chat provider for sending and receiving messages via Twilio/Telnyx
+- Webhook server for inbound SMS and voice status callbacks
+- Updated dependencies: omnichat v0.4.0 (Slack, Gmail) and omnivoice v0.7.0
+
+### Added
+
+- PostgreSQL database driver with multi-tenancy support ([`27a2494`](https://github.com/plexusone/agentcomms/commit/27a2494))
+- Row-Level Security (RLS) policies for PostgreSQL tenant isolation ([`27a2494`](https://github.com/plexusone/agentcomms/commit/27a2494))
+- Tenant context package for managing tenant_id in request context ([`27a2494`](https://github.com/plexusone/agentcomms/commit/27a2494))
+- Ent privacy policies for application-level tenant filtering ([`63657c5`](https://github.com/plexusone/agentcomms/commit/63657c5))
+- Database abstraction layer supporting SQLite and PostgreSQL ([`dbd4f27`](https://github.com/plexusone/agentcomms/commit/dbd4f27))
+- Webhook server for Twilio and Telnyx callbacks ([`26af01c`](https://github.com/plexusone/agentcomms/commit/26af01c))
+- SMS chat provider for omnichat integration ([`230a996`](https://github.com/plexusone/agentcomms/commit/230a996))
+- Slack configuration with Socket Mode support ([`e1c2eb7`](https://github.com/plexusone/agentcomms/commit/e1c2eb7))
+- Gmail configuration with OAuth 2.0 support ([`e1c2eb7`](https://github.com/plexusone/agentcomms/commit/e1c2eb7))
+- SMS and webhook configuration options ([`e1c2eb7`](https://github.com/plexusone/agentcomms/commit/e1c2eb7))
+
+### Dependencies
+
+- Update omnichat to v0.4.0 (Slack, Gmail providers) ([`96bb592`](https://github.com/plexusone/agentcomms/commit/96bb592))
+- Update omnivoice to v0.7.0 ([`96bb592`](https://github.com/plexusone/agentcomms/commit/96bb592))
+- Add lib/pq v1.12.0 for PostgreSQL driver ([`96bb592`](https://github.com/plexusone/agentcomms/commit/96bb592))
+- Update modernc.org/sqlite to v1.47.0 ([`96bb592`](https://github.com/plexusone/agentcomms/commit/96bb592))
+
+### Documentation
+
+- Gmail setup guide for OAuth 2.0 configuration ([`b54548f`](https://github.com/plexusone/agentcomms/commit/b54548f))
+- Slack setup guide for Socket Mode configuration ([`b54548f`](https://github.com/plexusone/agentcomms/commit/b54548f))
+- Configuration guide updates for database and webhook settings ([`b54548f`](https://github.com/plexusone/agentcomms/commit/b54548f))
+
+### Tests
+
+- Unit tests for tenant context (100% coverage) ([`8f35e59`](https://github.com/plexusone/agentcomms/commit/8f35e59))
+- Unit tests for database abstraction layer ([`8f35e59`](https://github.com/plexusone/agentcomms/commit/8f35e59))
+- Unit tests for RLS policy application ([`8f35e59`](https://github.com/plexusone/agentcomms/commit/8f35e59))
+
 ## [v0.3.0] - 2026-03-16
 
 ### Highlights
@@ -145,7 +186,8 @@ and this changelog is generated by [Structured Changelog](https://github.com/gro
 - Roadmap and usage documentation ([`300f5d5`](https://github.com/plexusone/agentcomms/commit/300f5d5))
 - README formatting improvements ([`18613b9`](https://github.com/plexusone/agentcomms/commit/18613b9))
 
-[unreleased]: https://github.com/plexusone/agentcomms/compare/v0.3.0...HEAD
+[unreleased]: https://github.com/plexusone/agentcomms/compare/v0.4.0...HEAD
+[v0.4.0]: https://github.com/plexusone/agentcomms/compare/v0.3.0...v0.4.0
 [v0.3.0]: https://github.com/plexusone/agentcomms/compare/v0.2.0...v0.3.0
 [v0.2.0]: https://github.com/plexusone/agentcomms/compare/v0.1.0...v0.2.0
 [v0.1.0]: https://github.com/plexusone/agentcomms/releases/tag/v0.1.0
diff --git a/docs/configuration.md b/docs/configuration.md
@@ -111,6 +111,59 @@ The configuration file is located at `~/.agentcomms/config.json`.
 | `port` | int | 3333 | Server port for MCP |
 | `data_dir` | string | `~/.agentcomms` | Data directory path |
 
+### Database
+
+Configure the database backend. By default, AgentComms uses SQLite in single-tenant mode.
+
+```json
+{
+  "database": {
+    "driver": "postgres",
+    "dsn": "postgres://user:pass@localhost:5432/agentcomms?sslmode=disable",
+    "multi_tenant": true,
+    "use_rls": true
+  }
+}
+```
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `driver` | string | `sqlite` | Database driver: `sqlite` or `postgres` |
+| `dsn` | string | `data.db` | Connection string (SQLite path or PostgreSQL DSN) |
+| `multi_tenant` | bool | false | Enable multi-tenant mode with tenant_id filtering |
+| `use_rls` | bool | false | Enable PostgreSQL Row-Level Security (requires postgres driver) |
+
+#### SQLite (Default)
+
+```json
+{
+  "database": {
+    "driver": "sqlite",
+    "dsn": "~/.agentcomms/data.db"
+  }
+}
+```
+
+#### PostgreSQL with Multi-Tenancy
+
+For production deployments with multiple tenants:
+
+```json
+{
+  "database": {
+    "driver": "postgres",
+    "dsn": "postgres://user:pass@localhost:5432/agentcomms?sslmode=require",
+    "multi_tenant": true,
+    "use_rls": true
+  }
+}
+```
+
+Multi-tenancy uses two isolation layers:
+
+1. **Application-level** - Ent privacy rules filter all queries by `tenant_id` (works on SQLite and PostgreSQL)
+2. **Database-level** - PostgreSQL RLS policies provide additional isolation (PostgreSQL only)
+
 ### Logging
 
 | Field | Type | Default | Description |
@@ -221,6 +274,54 @@ Slack uses Socket Mode, which means no public webhook URL is required. See the [
 
 Gmail uses OAuth 2.0 for authentication. On first run, you'll need to complete the OAuth flow in your browser. See the [Gmail Setup Guide](gmail-setup.md) for detailed instructions.
 
+#### SMS
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `enabled` | bool | No | Enable SMS as a chat transport |
+
+SMS uses your configured phone provider (Twilio or Telnyx) for sending and receiving messages. Inbound SMS requires the webhook server to be enabled.
+
+```json
+{
+  "chat": {
+    "sms": {
+      "enabled": true
+    }
+  }
+}
+```
+
+### Webhook
+
+Enable the webhook server to receive inbound SMS and voice status callbacks from Twilio/Telnyx.
+
+```json
+{
+  "webhook": {
+    "enabled": true,
+    "port": 3334
+  }
+}
+```
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `enabled` | bool | false | Enable webhook server |
+| `port` | int | 3334 | Webhook server port |
+
+#### Webhook Endpoints
+
+| Endpoint | Description |
+|----------|-------------|
+| `/webhook/twilio/sms` | Incoming SMS from Twilio |
+| `/webhook/twilio/voice` | Voice status callbacks from Twilio |
+| `/webhook/telnyx/sms` | Incoming SMS from Telnyx |
+| `/webhook/telnyx/voice` | Voice status callbacks from Telnyx |
+| `/health` | Health check endpoint |
+
+Configure your Twilio/Telnyx phone number to send webhooks to `https://your-domain/webhook/twilio/sms` or `https://your-domain/webhook/telnyx/sms`.
+
 #### Channel Mappings
 
 Map chat channels to agents.
diff --git a/docs/releases/v0.4.0.md b/docs/releases/v0.4.0.md
@@ -0,0 +1,151 @@
+# Release Notes: v0.4.0
+
+**Release Date:** 2026-03-22
+
+## Overview
+
+AgentComms v0.4.0 adds PostgreSQL support with Row-Level Security for multi-tenancy, SMS as a chat transport, and a webhook server for inbound Twilio/Telnyx callbacks.
+
+## Highlights
+
+- **PostgreSQL with Multi-Tenancy**: Database abstraction supporting both SQLite and PostgreSQL with RLS-based tenant isolation
+- **SMS Chat Provider**: Send and receive SMS messages through Twilio or Telnyx
+- **Webhook Server**: HTTP server for receiving inbound SMS and voice status callbacks
+- **Updated Dependencies**: omnichat v0.4.0 (Slack, Gmail) and omnivoice v0.7.0
+
+## New Features
+
+### PostgreSQL + Row-Level Security
+
+Multi-tenant deployments can now use PostgreSQL with Row-Level Security for database-level isolation:
+
+```json
+{
+  "database": {
+    "driver": "postgres",
+    "dsn": "postgres://user:pass@localhost:5432/agentcomms?sslmode=disable",
+    "multi_tenant": true,
+    "use_rls": true
+  }
+}
+```
+
+Two-layer isolation:
+
+1. **Application-level** - Ent privacy rules filter all queries by `tenant_id`
+2. **Database-level** - PostgreSQL RLS policies enforce isolation at the database
+
+### SMS Chat Provider
+
+SMS is now available as a chat transport alongside Discord, Slack, Telegram, WhatsApp, and Gmail:
+
+```json
+{
+  "chat": {
+    "sms": {
+      "enabled": true
+    }
+  }
+}
+```
+
+SMS uses your configured phone provider (Twilio or Telnyx) and integrates with the existing channel mapping system.
+
+### Webhook Server
+
+A dedicated webhook server receives callbacks from Twilio and Telnyx:
+
+```json
+{
+  "webhook": {
+    "enabled": true,
+    "port": 3334
+  }
+}
+```
+
+| Endpoint | Description |
+|----------|-------------|
+| `/webhook/twilio/sms` | Incoming SMS from Twilio |
+| `/webhook/twilio/voice` | Voice status callbacks |
+| `/webhook/telnyx/sms` | Incoming SMS from Telnyx |
+| `/webhook/telnyx/voice` | Voice status callbacks |
+| `/health` | Health check |
+
+## Architecture Changes
+
+### Tenant Context
+
+New `internal/tenant` package manages tenant context propagation:
+
+```go
+ctx = tenant.WithTenantID(ctx, "tenant-123")
+tenantID := tenant.FromContext(ctx)  // Returns "local" if not set
+```
+
+### Database Abstraction
+
+The `internal/database` package provides driver-agnostic database operations:
+
+- `database.Open(cfg)` - Opens SQLite or PostgreSQL based on config
+- `ApplyRLSPolicies(db)` - Creates RLS policies for PostgreSQL
+- PostgreSQL driver wrapper sets `app.current_tenant` per transaction
+
+### Ent Privacy Policies
+
+Agent and Event schemas now include privacy policies for tenant filtering:
+
+```go
+func (Agent) Policy() ent.Policy {
+    return privacy.Policy{
+        Query: privacy.QueryPolicy{rule.FilterTenantRule()},
+        Mutation: privacy.MutationPolicy{rule.FilterTenantRule()},
+    }
+}
+```
+
+## Documentation
+
+- [Configuration Guide](../configuration.md) - Database and webhook configuration
+- [Slack Setup](../slack-setup.md) - Slack integration guide
+- [Gmail Setup](../gmail-setup.md) - Gmail integration guide
+
+## Dependencies
+
+| Package | Version | Change |
+|---------|---------|--------|
+| omnichat | v0.4.0 | Slack, Gmail providers |
+| omnivoice | v0.7.0 | Updated voice stack |
+| lib/pq | v1.12.0 | PostgreSQL driver |
+| modernc.org/sqlite | v1.47.0 | Updated SQLite driver |
+
+## Upgrade Guide
+
+This release is backwards compatible. Existing SQLite deployments continue to work without changes.
+
+### For PostgreSQL Migration
+
+1. Create a PostgreSQL database
+2. Update `config.json` with database settings:
+   ```json
+   {
+     "database": {
+       "driver": "postgres",
+       "dsn": "postgres://user:pass@localhost:5432/agentcomms?sslmode=require",
+       "multi_tenant": true,
+       "use_rls": true
+     }
+   }
+   ```
+3. Start the daemon - schema migrations run automatically
+4. RLS policies are applied after schema creation
+
+### For SMS Integration
+
+1. Ensure webhook server is enabled
+2. Configure your Twilio/Telnyx number to send SMS webhooks to your server
+3. Enable SMS in chat config
+
+## Full Changelog
+
+See [CHANGELOG.md](../../CHANGELOG.md) for the complete list of changes.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -51,6 +51,7 @@ nav:
       - Gmail Setup: gmail-setup.md
   - Architecture: architecture.md
   - Releases:
+      - v0.4.0: releases/v0.4.0.md
       - v0.3.0: releases/v0.3.0.md
       - v0.2.0: releases/v0.2.0.md
       - v0.1.0: releases/v0.1.0.md
