Firma de AI — Exchange & Nextcloud Assistant

Ce rezolvă concret

Folosește skillul când vrei să lucrezi cu:

• emailuri, reply-uri, drafturi și atașamente în Exchange
• calendar, meeting-uri și follow-up tasks
• task-uri Exchange, inclusiv delegate access
• fișiere Nextcloud: listare, căutare, upload, download, mutare, sharing
• document understanding: extract-text, summarize, ask-file
• workflow extraction: extrage acțiuni din fișiere și creează task-uri Exchange
• context persistent între sesiuni prin LCM

Utilizare Rapidă

Email

# Conexiune
imm-romania mail connect

# Listează email-uri
imm-romania mail read --limit 10
imm-romania mail read --unread

# Trimite email
imm-romania mail send --to "[email protected]" --subject "Ofertă" --body "..."

# Răspunde
imm-romania mail reply --id EMAIL_ID --body "Răspuns"

Calendar

# Evenimente
imm-romania cal today
imm-romania cal week
imm-romania cal list --days 7

# Creează eveniment
imm-romania cal create --subject "Meeting" --start "2024-01-15 14:00" --duration 60

# Cu invitați
imm-romania cal create --subject "Team Meeting" --start "2024-01-15 14:00" --to "[email protected],[email protected]"

Tasks

# Listează
imm-romania tasks list
imm-romania tasks list --overdue

# Creează
imm-romania tasks create --subject "Review proposal" --due "+7d" --priority high

# Completează
imm-romania tasks complete --id TASK_ID

Analytics (Email Statistics)

# Statistici generale
imm-romania analytics stats --days 30

# Timp mediu de răspuns
imm-romania analytics response-time --days 7

# Top expeditori
imm-romania analytics top-senders --limit 20

# Activity heatmap
imm-romania analytics heatmap --days 30

# Statistici per folder
imm-romania analytics folders

# Raport complet
imm-romania analytics report --days 30

Fișiere (Nextcloud)

# Listează și caută
imm-romania files list /Documents/
imm-romania files search contract /Clients/

# Upload / Download
imm-romania files upload /local/report.pdf /Documents/
imm-romania files download /Documents/report.pdf /local/

# Document understanding
imm-romania files extract-text /Clients/contract.docx
imm-romania files summarize /Clients/contract.docx
imm-romania files ask-file /Clients/contract.docx "When is the renewal due?"

# Workflow extraction
imm-romania files extract-actions /Clients/contract.txt
imm-romania files create-tasks-from-file /Clients/contract.txt
imm-romania files create-tasks-from-file /Clients/contract.txt --select 1,2 --execute

Workflow-uri Combinate

Email + Fișiere

Trimite email cu atașament din Nextcloud:

# Download din Nextcloud și trimite
imm-romania files download /Documents/offer.pdf /tmp/
imm-romania mail send --to "[email protected]" --subject "Ofertă" --body "..." --attach /tmp/offer.pdf

Salvează atașament din email în Nextcloud:

# Download atașament și upload în Nextcloud
imm-romania mail download-attachment --id EMAIL_ID --name "contract.pdf" --output /tmp/
imm-romania files upload /tmp/contract.pdf /Contracts/

Calendar + Tasks

Creează task din meeting request:

# După meeting, creează task pentru follow-up
imm-romania tasks create --subject "Follow-up meeting X" --due "+3d"

Memory (LCM Plugin)

Context persistent este gestionat automat de Lossless Context Management plugin.

Tool-uri disponibile (dacă plugin-ul e instalat):

• lcm_grep - Caută în istoricul conversațiilor
• lcm_describe - Detalii despre un summary
• lcm_expand_query - Expandare și răspuns la întrebări

Exemple:

• "Ce am discutat despre proiectul X?" → caută în istoric
• "Când am trimis ultimul email către Y?" → combină LCM cu Exchange

Configurare Completă

Vezi references/setup.md pentru configurare detaliată.

Positioning public / branding

For public listings, documentation, and SEO copy, prefer this positioning:

• Public title: Firma de AI — Exchange & Nextcloud Assistant
• Subtitle: Email, files, tasks, and document workflows for teams
• Brand line: Built for teams using Firma de AI and supported by Firma de IT.
• Links: https://firmade.ai și https://firmade.it

This keeps the internal skill name imm-romania while making the public positioning more accurate and searchable.

Coding Standards

This project follows the Hardshell Coding Standards.

When writing or modifying Python code, see:

• Python Standards - PEP 8, type hints, docstrings, security
• Testing Standards - TDD, test pyramid, coverage
• Git Workflow - Conventional commits, PR process

Key rules:

• PEP 8 formatting - use black for formatting, ruff for linting
• Type hints - required for all function parameters and return types
• Docstrings - Google-style for all public functions and classes
• Testing - pytest with pytest-cov for coverage
• Security - never use pickle or eval() on untrusted input
• Dependencies - use uv or poetry, pin versions, audit with pip-audit

Module Structure

modules/
├── exchange/           # Email, Calendar, Tasks (Exchange on-prem)
│   ├── SKILL.md       # Module documentation
│   ├── mail.py        # Email operations
│   ├── cal.py         # Calendar operations
│   ├── tasks.py       # Task operations
│   ├── sync.py        # Sync and reminders
│   └── ...
├── nextcloud/          # File management, doc understanding, workflow extraction
│   ├── SKILL.md       # Module documentation
│   └── nextcloud.py   # File operations and analysis
└── (future modules)

Notes

• Tasks sunt create în folderul Tasks al mailbox-ului implicit sau în mailbox-ul țintă când folosești delegate access
• Pentru task-uri collaborative, folosiți calendar events cu invitați
• Self-signed certificates necesită verify_ssl: false
• LCM plugin trebuie instalat separat: openclaw plugins install @martian-engineering/lossless-claw

License

MIT License - see LICENSE file for details.