WHATSAPP

Purpose

WHATSAPP extracts governed intelligence from WhatsApp group and direct messages.

Every WhatsApp conversation — group chat and direct message — is an INTEL source. WHATSAPP reads the macOS WhatsApp database (ChatStorage.sqlite), extracts messages from ZWAMESSAGE/ZWACHATSESSION tables, resolves phone JIDs to INTEL contacts, and ledgers all correspondence. Raw messages stay private (auth-gated); only SHOP-safe summaries surface publicly.

Structure

Leaf SERVICE scope. No governed child scopes. Extracted intelligence lands in INTEL/*.md (auth-gated).

Required closure artifacts per scope: CANON.md, README.md, WHATSAPP.md, VOCAB.md, ROADMAP.md, COVERAGE.md, LEARNING.md.

Learning lane per governed scope: LEARNING.md at the scope root is terminal and SHALL NOT nest further LEARNING/.

Routes

web_docs: https://hadleylab-canonic.github.io/
web_surface: https://hadleylab-canonic.github.io/SERVICES/WHATSAPP/
magic:    magic://hadleylab-canonic.github.io/SERVICES/WHATSAPP/

Pipeline

~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite (macOS WhatsApp DB)
  -> ZWACHATSESSION (group + direct chats)
  -> ZWAMESSAGE (message text, timestamps, sender JID)
  -> handle resolution (phone JID -> INTEL contact)
  -> INTEL update (INTEL/{contact}.md)
  -> LEDGER (correspondence log, clock, cross-axioms)

Ecosystem Connectivity

1. Upstream: SHOP governance and SERVICES meta-governance.
2. Runtime: SHOP-safe outputs only. Raw messages stay private (auth-gated).
3. Source: ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite — read-only, Full Disk Access required.
4. Sink: INTEL/*.md — correspondence ledger updates.
5. Message format: ZTEXT column (plain UTF-8, no blob decoding required unlike iMessage).
6. Handle format: XXXXXXXXXX@s.whatsapp.net (individual) / XXXXXXXXXX-XXXXXXXXXX@g.us (group).

Pages

Default: Overview.