Silent Observer UX Spec — Speak Message Design

[Who] [Activity] is [Time] — you said [OtherTime]. Clarify?

[Who] and [Who] both claim [Task]. Who's covering?

[Who] [Activity] missing [Variable]. Fill in?

Leo's soccer is **4:30pm** — you said **3pm**. New schedule?

SPEAK_QUIET_HOURS = {
    "start": "07:00",    # No messages before 7 AM
    "end": "22:00",      # No messages after 10 PM
    "timezone": "America/Chicago"  # Matt/Aundrea timezone
}

Mode: SHADOW
- Tripwire runs normally
- Tier 2 extraction runs
- Redline rules execute
- DECISIONS LOGGED BUT NOT SENT
- Store "would have sent" messages in `shadow_speak` table

Daily 8 PM CST: Wadsworth reviews shadow_speak
- How many messages would have been sent?
- Are they all justified?
- Would any have confused Aundrea?

After 7 days of clean shadow logs:
- Enable live Speak mode
- Continue logging all decisions
- Daily review continues for 2 weeks

CREATE TABLE shadow_speak (
    id INTEGER PRIMARY KEY,
    message_id TEXT NOT NULL,
    would_send TEXT NOT NULL,        -- The Speak message that would be sent
    redline_rule TEXT NOT NULL,      -- Which rule triggered
    confidence REAL NOT NULL,
    created_at TIMESTAMP,
    reviewed_at TIMESTAMP,             -- When Wadsworth reviewed
    approved BOOLEAN,                -- Would this have been okay?
    notes TEXT                       -- Human notes on quality
);

Trigger: "I'll pick up Leo at 3pm for soccer"
Brain: Leo's soccer is 4:30pm
Speak: Leo's soccer is **4:30pm** — you said **3pm**. New schedule?
Word count: 9

Trigger: "Leo has soccer Friday"
Brain: Leo's soccer is Tuesday/Thursday
Speak: Leo's soccer is **Tuesday/Thursday** — you said **Friday**. Which day?
Word count: 10

Trigger: "Leo needs pickup Thursday after early dismissal"
Brain: No assigned_to found, activity=unspecified
Speak: Thursday pickup missing who's covering. You or Aundrea?
Word count: 10

Trigger: "I'll get Leo at 3pm tomorrow"
Brain: 3pm has no scheduled activity
Speak: Leo pickup **3pm tomorrow** — what's the activity?
Word count: 8

Trigger: John: "I'll cover Tuesday" + Sarah: "I'll cover Tuesday"
Brain: Both assigned to same task
Speak: John and Sarah both claim **Tuesday pickup**. Who's covering?
Word count: 10

Trigger: John: "I'll get kids" / Sarah: "No I'll get them"
Brain: Conflicting assignments in thread
Speak: John and Sarah both claim **kids pickup**. Who's covering?
Word count: 10

Trigger: "Remember when Leo's soccer game got rained out?"
Tripwire: Catches "Leo", "soccer"
Redline: Past tense detected ("remember", "rained out")
Decision: SILENT
Reason: Referencing past event, not coordination

Trigger: "We'll pick up Leo after practice"
Brain: "we" could be John+Sarah, or John+friend, or Sarah+parent
Redline: Missing critical variable (who is "we")
Speak: "**We**" picking up Leo — who does that include?
Word count: 9

Original: Speak message sent: "Leo's soccer **4:30pm** — you said **3pm**. New schedule?"
Reply: "Oops, dentist at 3pm then soccer"
Trigger: New information resolves conflict
Speak: Got it — **dentist 3pm**, then **soccer 4:30pm**. Locked in?
Word count: 9
Note: Reply to original Speak thread, not new message

SPEAK_CONSTRAINTS = {
    "max_words": 12,
    "max_clauses": 2,
    "emoji_urgent_only": True,
    "allowed_emoji": ["⚠️", "🚨"],  # Conflict/urgent only
    "quiet_hours_start": "07:00",
    "quiet_hours_end": "22:00",
    "daily_limit": 2,
    "timezone": "America/Chicago"
}

SPEAK_TEMPLATES = {
    "temporal_conflict": "{who}'s {activity} is **{correct}** — you said **{incorrect}**. {action}?",
    "resource_conflict": "{who1} and {who2} both claim **{task}**. Who's covering?",
    "missing_variable": "{who} {activity} missing **{variable}**. {prompt}?",
}

def validate_speak_message(message: str) -> tuple[bool, str]:
    words = message.split()
    if len(words) > 12:
        return False, f"Message too long: {len(words)} words (max 12)"

    # Count clauses (rough: split on commas, em-dashes, periods)
    clauses = len(re.split(r'[,—.!?]', message)) - 1
    if clauses > 2:
        return False, f"Too many clauses: {clauses} (max 2)"

    return True, "OK"