docs: add wiki and refresh flat lib with mcp artifacts

- Add hand-written wiki (index, overview, how-to, extending, dev)
  following the platform anatomy
- Remove stale nested docs/lib/mail_intake and regenerate the flat
  lib reference to match docforge.nav.yml
- Regenerate MCP bundle with standardized docstrings

docs/lib/index.md

@@ -1,4 +1,3 @@
 # mail_intake
 
 ::: mail_intake
-- [Mail Intake](mail_intake/)

docs/lib/mail_intake/adapters/base.md

@@ -1,3 +0,0 @@
-# Base
-
-::: mail_intake.adapters.base

docs/lib/mail_intake/adapters/gmail.md

@@ -1,3 +0,0 @@
-# Gmail
-
-::: mail_intake.adapters.gmail

docs/lib/mail_intake/adapters/index.md

@@ -1,5 +0,0 @@
-# Adapters
-
-::: mail_intake.adapters
-- [Base](base.md)
-- [Gmail](gmail.md)

docs/lib/mail_intake/auth/base.md

@@ -1,3 +0,0 @@
-# Base
-
-::: mail_intake.auth.base

docs/lib/mail_intake/auth/google.md

@@ -1,3 +0,0 @@
-# Google
-
-::: mail_intake.auth.google

docs/lib/mail_intake/auth/index.md

@@ -1,5 +0,0 @@
-# Auth
-
-::: mail_intake.auth
-- [Base](base.md)
-- [Google](google.md)

docs/lib/mail_intake/config.md

@@ -1,3 +0,0 @@
-# Config
-
-::: mail_intake.config

docs/lib/mail_intake/credentials/index.md

@@ -1,6 +0,0 @@
-# Credentials
-
-::: mail_intake.credentials
-- [Pickle](pickle.md)
-- [Redis](redis.md)
-- [Store](store.md)

docs/lib/mail_intake/credentials/pickle.md

@@ -1,3 +0,0 @@
-# Pickle
-
-::: mail_intake.credentials.pickle

docs/lib/mail_intake/credentials/redis.md

@@ -1,3 +0,0 @@
-# Redis
-
-::: mail_intake.credentials.redis

docs/lib/mail_intake/credentials/store.md

@@ -1,3 +0,0 @@
-# Store
-
-::: mail_intake.credentials.store

docs/lib/mail_intake/exceptions.md

@@ -1,3 +0,0 @@
-# Exceptions
-
-::: mail_intake.exceptions

docs/lib/mail_intake/index.md

@@ -1,11 +0,0 @@
-# Mail Intake
-
-::: mail_intake
-- [Adapters](adapters/)
-- [Auth](auth/)
-- [Config](config.md)
-- [Credentials](credentials/)
-- [Exceptions](exceptions.md)
-- [Ingestion](ingestion/)
-- [Models](models/)
-- [Parsers](parsers/)

docs/lib/mail_intake/ingestion/index.md

@@ -1,4 +0,0 @@
-# Ingestion
-
-::: mail_intake.ingestion
-- [Reader](reader.md)

docs/lib/mail_intake/ingestion/reader.md

@@ -1,3 +0,0 @@
-# Reader
-
-::: mail_intake.ingestion.reader

docs/lib/mail_intake/models/index.md

@@ -1,5 +0,0 @@
-# Models
-
-::: mail_intake.models
-- [Message](message.md)
-- [Thread](thread.md)

docs/lib/mail_intake/models/message.md

@@ -1,3 +0,0 @@
-# Message
-
-::: mail_intake.models.message

docs/lib/mail_intake/models/thread.md

@@ -1,3 +0,0 @@
-# Thread
-
-::: mail_intake.models.thread

docs/lib/mail_intake/parsers/body.md

@@ -1,3 +0,0 @@
-# Body
-
-::: mail_intake.parsers.body

docs/lib/mail_intake/parsers/headers.md

@@ -1,3 +0,0 @@
-# Headers
-
-::: mail_intake.parsers.headers

docs/lib/mail_intake/parsers/index.md

@@ -1,6 +0,0 @@
-# Parsers
-
-::: mail_intake.parsers
-- [Body](body.md)
-- [Headers](headers.md)
-- [Subject](subject.md)

docs/lib/mail_intake/parsers/subject.md

@@ -1,3 +0,0 @@
-# Subject
-
-::: mail_intake.parsers.subject