# MailSubsystem Site

This is the agent-readable source map for the MailSubsystem website. The HTML pages provide the designed browser experience; these Markdown files provide the same product narrative in a form that agents can review without rendering HTML.

## Canonical Routes

| Browser route | Markdown route | Purpose |
| --- | --- | --- |
| `/` | `/site.md` | Full site overview and route map |
| `/managed-service` | `/managed-service.md` | Managed service page |
| `/managed-service/platform` | `/managed-service/platform.md` | Managed service platform boundary |
| `/docs` | `/docs.md` | Documentation hub |
| `/docs/overview` | `/docs/overview.md` | Core overview |
| `/docs/quick-start` | `/docs/quick-start.md` | Core quick start |
| `/docs/commands` | `/docs/commands.md` | CLI command reference |
| `/docs/safety` | `/docs/safety.md` | Safety notes |
| `/llms.txt` | `/llms.txt` | Agent entrypoint |

## Core Positioning

MailSubsystem Core is an upcoming AGPL-licensed Rust application for local-first IMAP email intelligence. It ingests mail, analyzes it with local or frontier models, detects risk, recommends folders, and files messages through an auditable agent pipeline.

## Core Capabilities

- Local-first inference through LM Studio or Ollama.
- Optional frontier escalation on a per-message basis.
- Declarative agent behavior in Markdown specs.
- PostgreSQL-backed mailbox state, analysis output, embeddings, and action history.
- Runtime flow: Sync -> Analyze & Embed -> Locate -> File.
- TUI review flow for risky messages before filing.

## Managed Service Positioning

MailSubsystem Managed Service brings the Core email intelligence engine into a managed inbox-protection service for families, caregivers, and small teams. It watches for payment pressure, sender impersonation, suspicious links, and unusual requests, then holds risky messages for human review before anything moves.

The intelligence comes from the open-source Core so users can audit how decisions are made. The service owns the operational shell around it: account isolation, identity, authorization, audit trails, support workflows, billing, onboarding, and careful caregiver access.

Use these terms:

- service
- managed service
- inbox protection
- control plane
- operational shell

Avoid add-on-layer phrasing for the managed service.

## Repository

Core repository:

`https://github.com/iamcobolt/MailSubsystem.git`

## Simulated Screenshots

The site includes simulated SVG screenshots under `/assets/screenshots/`. They are deterministic design assets based on the current product and CLI concepts, not captured runtime screenshots.

Core-facing assets:

- `/assets/screenshots/core-trio.svg`: homepage illustration connecting PostgreSQL state, email knowledge, and the TUI review surface.
- `/assets/screenshots/tui-message-review.svg`: simulated terminal review screen for risky messages before filing.