IMESSAGE

Purpose

IMESSAGE extracts governed intelligence from Apple iMessage.

Every iMessage and SMS conversation is an INTEL source. IMESSAGE reads the macOS Messages database (chat.db), decodes attributedBody blobs via NSKeyedArchiver, resolves phone handles 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, IMESSAGE.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/IMESSAGE/
magic:    magic://hadleylab-canonic.github.io/SERVICES/IMESSAGE/

Pipeline

~/Library/Messages/chat.db (macOS iMessage DB)
  -> attributedBody blob extraction (NSKeyedArchiver)
  -> handle resolution (+1XXXXXXXXXX -> 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/Messages/chat.db — read-only, Full Disk Access required.
4. Sink: INTEL/*.md — correspondence ledger updates.
5. Blob format: attributedBody (NSAttributedString via NSKeyedArchiver streamtyped).
6. Handle format: +1XXXXXXXXXX with iMessage and SMS service types.

Pages

Default: Overview.