@menasehk/sera 1.0.3 → 1.6.0

package/README.md

@@ -1,6 +1,20 @@
-# SERA / ስራ
+# SERA
 
-> **ስራ** means *work* in Amharic. Your AI-powered daily work command center — manage tasks, calendar, contacts, notes, and automate your computer through natural conversation, right from your terminal.
+```
+╔══════════════════ SERA ══════════════════╗
+║                                          ║
+║  ███████╗███████╗██████╗  █████╗         ║
+║  ██╔════╝██╔════╝██╔══██╗██╔══██╗        ║
+║  ███████╗█████╗  ██████╔╝███████║        ║
+║  ╚════██║██╔══╝  ██╔══██╗██╔══██║        ║
+║  ███████║███████╗██║  ██║██║  ██║        ║
+║  ╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝        ║
+║                                          ║
+║   › ስ ራ ‹  AI-Powered Work Command Center ║
+╚══════════════════════════════════════════╝
+```
+
+> **ስራ** means *work* in Amharic. Manage tasks, calendar, contacts, notes, and automate your computer through natural conversation — right from your terminal.
 
 ---
 
@@ -20,7 +34,7 @@ sera setup
 
 ## What you can do
 
-Just open SERA and talk to it naturally. No special syntax needed.
+Just open SERA and talk to it naturally:
 
 ```bash
 sera        # open and start chatting
@@ -34,29 +48,27 @@ sera        # open and start chatting
 "Add Sarah Connor to my contacts, phone 555-0123"
 "What do I have on Friday?"
 "Remember that I prefer short responses"
-"Create a collection to track my expenses"
-"Show all expenses over $50 this month"
+"Write an MOU between us and Acme Corp"
+"ቃለ-ጉባኤ ጻፍ — ዛሬ ጠዋት የነበረው ስብሰባ"
 ```
 
-SERA figures out what you mean and does it — including creating tasks, scheduling calendar events, saving contacts, running shell commands, reading files, and more.
-
 ---
 
 ## Quick commands
 
 ```bash
-sera                            # Start chatting with your AI
-sera setup                      # First-time setup (AI provider, API key, preferences)
-sera today                      # Today's tasks and appointments at a glance
+sera                            # Start chatting
+sera setup                      # First-time setup
+sera today                      # Today's tasks and appointments
 sera tasks                      # View all active tasks
 sera add "Buy groceries" -p low # Quick-add a task
 sera done "Buy groceries"       # Mark a task done
 sera cal                        # Upcoming appointments
-sera remind 15 "Stand up call"  # Desktop notification in 15 minutes
+sera remind 15 "Stand up call"  # Desktop notification in 15 min
 sera note "Great idea I had"    # Save a quick note
 sera notes                      # View all notes
 sera memory                     # See what SERA remembers about you
-sera daemon start               # Run in the background (notifications when not open)
+sera daemon start               # Run in background (notifications when closed)
 sera daemon install             # Auto-start at login
 sera export                     # Back up all your data
 ```
@@ -72,13 +84,70 @@ sera export                     # Back up all your data
 | **Ollama** | llama3.1, mistral, gemma3 (runs locally, free) |
 | **Groq** | llama-3.3-70b, mixtral, … |
 
-Run `sera setup` to choose your provider and paste in your API key. For Ollama no API key is needed.
+Run `sera setup` to choose your provider and paste in your API key. Ollama needs no API key.
+
+---
+
+## Amharic Document Generation
+
+SERA writes professional Word (`.docx`) documents in Amharic or English. Files are saved to your Desktop and opened automatically.
+
+**Supported document types:**
+
+| Type | Amharic Name |
+|---|---|
+| MOU | የስምምነት ማስታወሻ |
+| Meeting Minutes | ቃለ-ጉባኤ |
+| Official Letter | ደብዳቤ |
+| Report | ሪፖርት |
+| Agreement | ስምምነት |
+| Contract | ውል |
+| Custom | any structure |
+
+**Examples:**
+
+```
+"Write an MOU between Tagcodi and the Ministry of Education"
+"ቃለ-ጉባኤ ጻፍ — ዛሬ ጠዋት ከቦርዱ ጋር የነበረው ስብሰባ"
+"Draft an official letter to the Ministry of Finance"
+"Create meeting minutes — attendees were Kassu, Sara, and John"
+"Write a 1-year service contract between us and our client"
+"ሪፖርት ጻፍ — Q1 የስራ አፈጻጸም"
+```
+
+All documents use proper Ethiopic fonts (Nyala on Windows, Kefa on macOS) with correct structure — signature lines, reference numbers, section headings, and standard Amharic phrasing.
+
+---
+
+## Amharic Terminology & Learning
+
+SERA comes with a built-in Amharic glossary of 60+ standard document terms — legal words, titles, phrases, and document sections — and learns new ones as you teach it.
+
+**Pre-loaded categories:**
+
+- Document types — `ቃለ-ጉባኤ`, `ደብዳቤ`, `የስምምነት ማስታወሻ`, `ውል`, `ሪፖርት`
+- Legal terms — `ወገን`, `አንቀጽ`, `ፊርማ`, `ግዴታ`, `መብት`, `ቅጣት`
+- Titles & roles — `ሰብሳቢ`, `ፀሐፊ`, `ሃላፊ`, `ወኪል`, `ዳይሬክተር`
+- Formal phrases — `ለክቡርነትዎ`, `በአክብሮት`, `ተዋዋይ ወገኖች`
+- Document sections — `ጉዳዩ`, `ዓላማ`, `ምክረ-ሃሳብ`, `አጀንዳ`, `አባሪ`
+- Ethiopic numerals — ፩ ፪ ፫ ፬ ፭ …
+
+**Teaching SERA new words:**
+
+```
+"Learn the word ተጠቃሚ — it means beneficiary in legal documents"
+"ሰብሳቢ is also written as ሊቀ-ወንበር — remember that variant"
+"How do you spell the Amharic word for arbitration?"
+"What does ቃለ-ጉባኤ mean?"
+```
+
+Every learned term is saved permanently and immediately used in future documents.
 
 ---
 
 ## AI Memory
 
-SERA remembers things about you across sessions automatically — no prompting needed. Just chat normally.
+SERA remembers things about you across sessions automatically — no prompting needed.
 
 ```
 "My name is Kassu and I live in Helsinki"
@@ -86,25 +155,21 @@ SERA remembers things about you across sessions automatically — no prompting n
 "I'm working on a mobile app called Fana"
 ```
 
-Next time you open SERA it already knows all of this. View or clear memories any time:
-
 ```bash
 sera memory                       # See everything SERA remembers
 sera memory --forget "timezone"   # Remove one memory
 sera memory --forget-all          # Start fresh
 ```
 
-Or type `/memory` while chatting.
-
 ---
 
 ## Calendar & Contacts
 
-On macOS SERA talks directly to Calendar.app and Contacts.app. On other platforms it creates `.ics` / `.vcf` files that open in whatever app you use.
+On macOS SERA talks directly to Calendar.app and Contacts.app. On other platforms it creates `.ics` / `.vcf` files that open in your default app.
 
 ```
-"Add dentist appointment Friday 3pm, set a 30 minute reminder"
-"Add John Smith to my contacts, email john@acme.com, phone 555-1234"
+"Add dentist appointment Friday 3pm with a 30 minute reminder"
+"Add John Smith to my contacts, email john@acme.com"
 "Look up Alice in my contacts"
 "Put this on my Google Calendar: team lunch, Thursday noon"
 ```
@@ -113,18 +178,19 @@ SERA always asks your permission before touching your calendar or contacts.
 
 ---
 
-## Background daemon
+## Background Daemon
 
-Keep SERA running silently in the background so you get notified even when the app is closed.
+Runs silently in the background and sends desktop notifications even when SERA is closed.
 
 ```bash
 sera daemon start      # Start background monitoring
 sera daemon install    # Auto-start every time you log in
 sera daemon status     # Check if it's running
 sera daemon stop       # Turn it off
+sera daemon logs       # View recent activity
 ```
 
-The daemon sends desktop notifications for overdue tasks, upcoming appointments (15 min warning + at start time), and a 9 AM morning briefing.
+Monitors: overdue tasks, appointment reminders (15 min + at start), daily 9 AM briefing.
 
 ---
 
@@ -133,10 +199,10 @@ The daemon sends desktop notifications for overdue tasks, upcoming appointments
 SERA asks before doing anything that touches your system. You choose how strict:
 
 - `ask` — confirm every action
-- `auto` — auto-allow safe actions, ask for risky ones
+- `auto` — auto-allow safe actions, ask for risky ones  
 - `allow` — allow everything
 
-You can always allow or deny permanently per tool so you're never asked twice for the same thing.
+You can always allow or deny permanently per tool so you're never asked twice.
 
 ---
 
@@ -150,15 +216,14 @@ Everything stays on your machine. No cloud sync, no tracking.
 | `~/.ai-daily-cli/data.json` | Tasks, appointments, notes |
 | `~/.ai-daily-cli/memory.json` | Things SERA remembers about you |
 | `~/.ai-daily-cli/collections.json` | Custom data collections |
+| `~/.ai-daily-cli/amharic-glossary.json` | Amharic terms and learned words |
 
-The only outbound traffic is your conversation being sent to your chosen AI provider's API.
+The only outbound traffic is your conversation sent to your chosen AI provider's API.
 
 ---
 
 ## In-chat slash commands
 
-While chatting you can type these shortcuts:
-
 | Command | What it does |
 |---|---|
 | `/help` | Show all slash commands |