Files

Documenter c5760db43d docs: Phase 8 documentation - Gitea, Obsidian, Outline, Vikunja, map (AUD-74)

- README: architecture Mermaid, Phase 8 status, Phase 7 endpoints, Documentation index
- docs/outline/: AI-context collection (index, system, config, code map, runbook)
- docs/email-agent-architecture.mmd + rendered PNG + Archify map (showcase pass)
- docs/vikunja-tasks.json (Vikunja project 17, tasks 179-185)
- docs/phase8-documentation.md evidence

2026-10-13 10:46:21 +11:00

1.8 KiB

Raw Permalink Blame History

Email Agent — AI Document Index

Target: AI agents. Writing style: ASD-STE100 Simplified Technical English.

Document catalog

Read this index. Inject the exact document you need. Do not search all files.

Document	Path	Scope
System Overview	`docs/outline/01-system-overview.md`	Purpose, architecture, services, phase status.
Configuration and Environment	`docs/outline/02-config-and-env.md`	Environment variables, config paths, ports, secrets.
Code Map	`docs/outline/03-code-map.md`	Folder structure, entry points, dependencies, schema.
Agent Runbook	`docs/outline/04-agent-runbook.md`	Commands to test, deploy, restart, and roll back.

The build spec is AGENTS.md. The phase evidence files are docs/phaseN-*.md. The interactive map is docs/email-agent-map.html.

System summary

The Email Agent triages the family inbox. All mail lands in one Gmail account. Sam opens one page, clears the inbox in minutes, and sees nothing important missed. The service reads Gmail over IMAP, classifies each message with JEV, recommends an action, applies bulk actions, drafts replies, and answers the Hub.

Core configuration

Secrets file: ~/.config/environment.d/10-secrets.conf (mode 600).
Project directory: /home/sam/paseo/projects/email_agent/.
Live host: .13, one container, own image.
Live port: 8790. Public URL: https://mail.lab.audasmedia.com.au.
Database: SQLite at /data/email_agent.db on the email_agent_data volume.

Agent restart steps

Read the catalog above. Inject only the documents you need.
Check git status: git status.
Check recent commits: git log -n 5 --oneline.

Run the Go tests in a container:

timeout 600 docker run --rm -v "$PWD":/src -w /src golang:1.25-alpine go test ./...

1.8 KiB Raw Permalink Blame History