Voicex
SPEC_VOICEX.md
CGNT-1 Component Specification — VOICEX
Status: SPECIFIED
Version: v1.0
Module: 24 of 24
Author: VELA (Thread #13)
Authorized: NOUS
Date: 2026-04-20
PURPOSE
External communications engine. All outbound communication from CGNT-1 to the world flows through VOICEX. Manages four channels, enforces draft-before-send discipline, and ensures Captain approval on every outbound message.
VOICEX drafts autonomously. It never sends autonomously.
FOUR CHANNELS
| # | Channel | Implementation | Use |
|---|---------|---------------|-----|
| CH1 | Email | oracle@42sisters.ai via Microsoft Graph API | Transactional, customer delivery, support |
| CH2 | Notification | In-app notification on 42sisters.ai | Product updates, verdict delivery, alerts |
| CH3 | Social | Managed presence (platform TBD) | Brand presence, thought leadership |
| CH4 | Outreach | Targeted professional — warm contacts only | Business development, partnerships |
MESSAGE LIFECYCLE
DRAFT → QUEUED → APPROVED → SENT → DELIVERED → ENGAGED → CLOSED
| State | Who sets it | Meaning |
|-------|------------|---------|
| DRAFT | VOICEX (autonomous) | Message composed, not yet reviewed |
| QUEUED | VOICEX | Submitted for Captain review |
| APPROVED | NOUS | Captain has approved — cleared to send |
| SENT | VOICEX | Message transmitted |
| DELIVERED | VOICEX / channel feedback | Delivery confirmed |
| ENGAGED | VOICEX | Recipient replied or clicked |
| CLOSED | VOICEX | Thread complete |
DRAFT → SENT requires NOUS approval. No message advances past QUEUED without Captain action.
CHANNEL RULES
CH1 — Email
- Sender: oracle@42sisters.ai
- Auth: Microsoft Graph API (existing — send_graph_email.py)
- Templates stored in:
~/email_templates/ - Allowed without additional approval: transactional (verdict delivery, purchase confirmation, support response)
- Requires NOUS approval: newsletters, announcements, cold outreach (which is a Vacuum Rule violation — see INV-02)
CH2 — Notification
- In-app only, visible to logged-in customers
- No PII in notification text
- Auto-send permitted for transactional notifications (payment confirmed, verdict ready)
- Requires NOUS approval for broadcast notifications
CH3 — Social
- APPROVAL required for every post (Agency Walls — RESTRICTED tier)
- Draft composed by Sisters or NOUS, posted only after explicit Captain approval
- No automated posting under any circumstances
CH4 — Outreach
- Warm contacts only: people who have engaged with 42sisters.ai, attended the same events, or been introduced
- Cold email is a Vacuum Rule violation. Cold DM is a Vacuum Rule violation.
- Every outreach message requires NOUS approval
- Outreach cadence tracked to prevent duplicate contact
TEMPLATE LIBRARY
Templates stored in ~/email_templates/. Current templates:
| Template | Trigger |
|----------|---------|
| oracle_verdict_quick.txt | Quick Oracle verdict delivery |
| oracle_verdict_full.txt | Full Oracle verdict delivery |
| oracle_verdict_strategy.txt | Strategy Oracle verdict delivery |
| welcome.txt | New subscriber welcome |
| brain_delivery.txt | Brain Builder delivery |
| support_response.txt | Customer support reply |
| brain_proposal.txt | Brain Builder proposal |
New templates require NOUS approval before use.
REVIEW QUEUE
VOICEX maintains a review queue at ~/voicex_queue.jsonl. Each entry:
{
"id": "vx-[timestamp]-[seq]",
"channel": "CH1",
"to": "[recipient]",
"subject": "[subject]",
"body_preview": "[first 200 chars]",
"template": "[template name or null]",
"created": "[ISO timestamp]",
"state": "QUEUED",
"approved_by": null,
"sent_at": null
}
NOUS reviews via: python3 voicex_engine.py review — shows all QUEUED messages.
SCHEDULE
| Trigger | Action |
|---------|--------|
| Customer purchase | CH1 confirmation email drafted (CH2 notification auto-sent) |
| Oracle verdict ready | CH1 verdict email drafted |
| Brain delivery | CH1 delivery email drafted |
| Support inquiry received | CH1 response drafted |
| Daily 07:00 ET | VOICEX posts pending queue count to COMMX |
| On-demand | ROUTX query: "voicex queue" / "voicex status" / "voicex drafts" |
INTEGRATION
| System | Relationship |
|--------|-------------|
| ROUTX | Registered as module 24 |
| oracle_email_service.py (port 8006) | CH1 email delivery backend |
| send_graph_email.py | Graph API transport |
| COMMX | Crew notifications about outbound queue |
| CASHX | New subscriber triggers welcome email draft |
| Brain Builder | Delivery triggers CH1 draft |
| Agency Walls | CH3 Social governed by RESTRICTED tier |
INVARIANTS
INV-01: VOICEX never sends without Captain approval. DRAFT and QUEUED states are autonomous. APPROVED and beyond require NOUS.
INV-02: No cold outreach. Cold email and cold DM are Vacuum Rule violations. VOICEX will not draft cold outreach even if instructed to by crew members other than NOUS.
INV-03: No communication with hostile actors (identified by HACKX/MANTIS). If a recipient is in MANTIS's threat list, VOICEX refuses to draft.
INV-04: CH3 Social requires approval for every post. No exceptions. No scheduled auto-posts.
INV-05: Customer email addresses stored encrypted at rest. Never appear in logs, specs, training data, or CREW_CHANNEL broadcasts.
INV-06: Outreach (CH4) tracks contact history. No recipient contacted more than once per 30 days without NOUS explicit instruction.
GAPS
- Engine file:
~/voicex_engine.py— not yet built ~/voicex_queue.jsonlnot yet created~/email_templates/partially populated (oracle_email_service.py has inline templates — migrate to files)- CH2 in-app notification system not yet wired to 42sisters.ai
- CH3 Social platform not yet selected
- CH4 warm contact list not yet defined
- No systemd unit yet
Jeremy Zlabis
Chronogeometer · Visionary · Disruptor · Chief
42 Sisters AI · East York, Toronto
🍁 Φ 0.042