How gnaro-shaft/cenacle works
Cénacle is a local-first personal assistant whose Iris agent collects and classifies mail, tracks replies, and prepares drafts; the owner reviews and approves proposals in the web page, and a separate deterministic executor sends only approved replies. The graph also preserves status/Telegram reporting and heartbeat monitoring. Several domain implementations are documented but not excerpted, so those links rely on the README; unsampled details are not inferred.
Main entry points: main.ts Iris scheduler · src Journal and mail stores · proposals-service.ts Proposal service · execute.ts Approved-send executor
Components 19
Mail workflow
- Iris scheduler
apps/iris/src/main.ts - Mail collection and sorting
packages/mail/src/pass.ts - Classification and local models
packages/brain/src - Follow-up tracking
packages/core/src/follow-up.ts - Draft generation
apps/iris/src/drafting.ts - Mail parsing and safeguards
packages/mail/src
Approval and delivery
- Proposal service
apps/server/src/proposals-service.ts - Local API
apps/server/src/app.ts - Approved-send executor
apps/executor/src/execute.ts
State and policy
- Journal and mail stores
packages/journal/src - Schedule and safety rules
packages/core/src - Agent status projection
packages/core/src/agent-status.ts
Owner interfaces
- Review page
apps/web/src/Proposals.tsx - Telegram bot
apps/telegram/src/handler.ts
Monitoring
- Heartbeat monitor
apps/sentinel/src/watch.ts - Heartbeat endpoint
apps/sentinel/src/server.ts
Other components
- Owner
- Mail server
- Telegram service
Connections 26
- Mail server → Iris scheduler: provides mail
README.md - Iris scheduler → Mail collection and sorting: runs collection
apps/iris/src/main.ts - Mail collection and sorting → Classification and local models: classifies remainder
README.md - Mail collection and sorting → Mail parsing and safeguards: parses and checks
README.md - Iris scheduler → Follow-up tracking: tracks replies
README.md - Iris scheduler → Draft generation: drafts due replies
apps/iris/src/main.ts - Draft generation → Classification and local models: uses local models
apps/iris/src/drafting.ts - Iris scheduler → Journal and mail stores: reads and writes
apps/iris/src/main.ts - Iris scheduler → Schedule and safety rules: applies schedule
README.md - Draft generation → Journal and mail stores: stores proposals
README.md - Owner → Review page: reviews drafts
README.md - Review page → Local API: requests actions
apps/web/src/Proposals.tsx - Local API → Proposal service: routes proposal actions
apps/server/src/app.ts - Proposal service → Journal and mail stores: reads and updates
README.md - Proposal service → Mail parsing and safeguards: rechecks reply target
- Proposal service → Approved-send executor: records signed approval
README.md - Approved-send executor → Journal and mail stores: claims approved work
- Approved-send executor → Mail server: sends accepted reply
- Telegram service → Telegram bot: delivers updates
- Telegram bot → Agent status projection: projects agent status
apps/telegram/src/handler.ts - Telegram bot → Journal and mail stores: reads status and records stop
- Telegram bot → Telegram service: sends replies
- Iris scheduler → Heartbeat endpoint: sends heartbeat
README.md - Approved-send executor → Heartbeat endpoint: sends heartbeat
README.md - Heartbeat endpoint → Heartbeat monitor: records heartbeat
apps/sentinel/src/server.ts - Heartbeat monitor → Telegram service: alerts on silence