Files
2dph/docs
eSliderandGitHub e28fb9f428
Tests / Test (push) Failing after 5s
Tests / OCR (tesseract fixture) (push) Failing after 4s
Tests / Release (semver) (push) Skipped
feat(mail): M365 Graph sync + bot ETL loop (OO+Gmail) (#38)
* feat(mail): add Microsoft 365 Graph sync source with delta state

Adds a GET-only Microsoft Graph source to bin/mail/sync (client-credentials,
delta query). Wires it into the CLI (--source m365), the worker pool and the
compose stack:

- m365.go: M365Client (token cache, delta pagination, message normalization,
  attachment download) + m365Source adapter (per-mailbox folders + delta link)
- sync.go: M365Credentials in SyncConfig; Committer interface so delta links
  only advance after a fully successful run (no skips on failure)
- cli.go: --source m365 with M365_/MS_ env passthrough
- Dockerfile: mail-build stage produces /mail-sync into the index image
- docker-entrypoint: mail-sync loop (sync -> import -> index, default 10s)
- compose.yaml: mail-sync service (index image, kb-var volume, secrets ro)

* feat(mail): adapt M365 ETL loop for OO+Gmail bots.

Default compose mail-sync to onlyoffice,gmail every 300s with import on new
mail; gate full --rebuild behind MAIL_SYNC_INDEX. Fix mail-build stage order
and add bin/stack/start-mail-sync.
2026-08-14 18:02:13 +01:00
..

type, status, related
type status related
reference current
docs/runbook.md
docs/design.md
PLAN.md
docs/roadmap.md

2dph docs (Diataxis)

Evidence-first knowledge graph. Facts need proof or they are (not confirmed).

Type Doc
tutorial / howto runbook — run anywhere (uv, Go, Docker)
explanation design — two roots, deduction, D17/D20/D18
explanation roadmap — gap to v1 (epic #16)
howto picoclaw — MCP agent (bin/stack/start-assistant)
howto reasoner — CPU bake-off (D18)
reference PLAN.md — decisions D1D24

Decisions the public face must name: D3 SearXNG compose, D6 Go service / Python write sidecar, D14 bin/{subject}/{method}.go, D15 Gitea origin, D17 assertion gate (facts → info → web), D18 pluggable reasoner.

Search: bin/brain/search.go "query" (HTTP: bin/brain/serve.go/health /search /get /stats /audit /ingest). --hop N walks FROM_FILE → Commit → Person from each hit (max 3). Rebuild writes File edges (#17).

Work board: Gitea issues (epic #16). PRs and CI: GitHub eSlider/2dph.

Published docs live here and match live commands.