1 min read
Integration Sync
Integration syncs keep external systems available as raw evidence without pretending every external event belongs in the wiki.
Integration state is split between repo state and integration credentials/cursors. state.json records freshness. OAuth/session details live in local integration stores or browser sessions. Source: AGENTS.md; Integration Recipes Index
Integration Matrix
| Integration | Cadence | Runner | Durable rule |
|---|---|---|---|
| Gmail | Every 4 hours | local scripts / email-sync |
Raw digest first; promote durable facts. |
| Slack | Every 4 hours | browser-backed slack-sync |
Read-only review; promote decisions/actionable context. |
| X bookmarks | Every 4 hours | source-compile |
Enriched research before promotion. |
| Circleback | Daily | meeting-sync |
Raw transcript plus durable project/person/action updates. |
| Calendar | Weekly | calendar-sync |
Schedule context, commitments, and planning signals. |
Safety Rule
Sync jobs are read-oriented by default. Do not send messages, mark items read, archive, delete, or mutate external systems unless the automation explicitly permits it or Kevin approves.
Freshness Rule
Only update a syncs.* key after successful collection from the external system. A blocker report should keep sync freshness stale so the problem remains visible.
Timeline
- 2026-07-01 | Rebuilt integration sync around the current Slack/Gmail/X/Circleback/Calendar matrix and sync-state discipline. Source: User request, 2026-07-01
- 2026-06-30 | Added Slack sync and moved Gmail into the every-four-hours communications loop. Source: User request, 2026-06-30;
automations/slack-sync.md;automations/email-sync.md - 2026-05-31 | Integration sync cadence from AGENTS.md. Source: public wiki expansion, 2026-05-31