feat: merge oo-cli and extend library with Calendar/CRM/subtasks/files

- Add Calendar helpers (ListCalendars/ListEvents/AddEvent/DeleteEvent)
- Add CRM helpers: contacts, opportunities, cases, CRM tasks, history notes
- Add project-task extras (ListTasks/ListAllTasks/GetTaskByID/AddTask/
  AddSubtask/UpdateTaskStatus/DeleteTask, GetProjectByID)
- Add UploadOpportunityFile (multipart) and SelfUserID caching
- Introduce Defaults struct, SetDefaults, GetEnvironmentDefaults;
  GetEnvironmentCredentials now accepts ONLYOFFICE_HOST/NAME/PASSWORD aliases
- Add public Authenticate() helper that eagerly primes the token
- Bundle Cobra CLI at cmd/oo-cli with full command surface
  (calendar, tasks, subtasks, CRM, applications-sync); CLI-only deps
  (cobra, godotenv) kept out of the library surface
- Add httptest-based unit tests for form/multipart helpers
- Docs: CHANGELOG, AGENTS, .env.example, README updates for v0.3 features

Consolidates the standalone eSlider/oo-cli tool into this canonical Go
module (see eSlider/inventar ASR-0008).

Made-with: Cursor

cmd/oo-cli/README.md

@@ -0,0 +1,47 @@
+# oo-cli
+
+Cobra CLI wrapper around [`github.com/eslider/go-onlyoffice`](../..). Replaces the Python scripts that used to live under `eSlider/cv/bin/office`.
+
+## Install
+
+```bash
+go install github.com/eslider/go-onlyoffice/cmd/oo-cli@latest
+```
+
+Ensure `$(go env GOPATH)/bin` is on `PATH`.
+
+## Config
+
+Copy [`../../.env.example`](../../.env.example) to `.env` in the working directory:
+
+| Variable | Alias | Default |
+|---|---|---|
+| `ONLYOFFICE_URL` | `ONLYOFFICE_HOST` | — |
+| `ONLYOFFICE_USER` | `ONLYOFFICE_NAME` | — |
+| `ONLYOFFICE_PASS` | `ONLYOFFICE_PASSWORD` | — |
+| `ONLYOFFICE_CALENDAR_ID` | — | `1` |
+| `ONLYOFFICE_PROJECT_ID` | `ONLYOFFICE_CALENDAR_PROJECT_ID` | `33` |
+
+## Commands
+
+| Python (legacy) | Go CLI |
+|---|---|
+| `list-calendars.py` | `oo-cli cal-list` |
+| `list-events.py` | `oo-cli cal-events [--start] [--end]` |
+| `add-event.py` | `oo-cli cal-add TITLE START END [--calendar] [--description] [--all-day]` |
+| `delete-event.py` | `oo-cli cal-delete ID [ID...]` |
+| `list-tasks.py` | `oo-cli task-list [--project] [--status] [--all] [--verbose]` |
+| `add-task.py` | `oo-cli task-add TITLE [--project] [--description] [--deadline] [--priority]` |
+| `add-subtask.py` | `oo-cli subtask-add PARENT TITLE [TITLE...]` |
+| `update-task.py` | `oo-cli task-update ID open\|closed` or `--delete` |
+| `list-contacts.py` | `oo-cli crm-contacts [--companies\|--persons] [--search]` |
+| `add-contact.py` | `oo-cli crm-add-contact --company ...` or `--person-first` / `--person-last` |
+| `list-deals.py` | `oo-cli crm-deals` / `oo-cli crm-deals --stages` |
+| `add-deal.py` | `oo-cli crm-add-deal TITLE [--stage] [--bid] [--contact]` |
+| `list-cases.py` | `oo-cli crm-cases` |
+| `sync-applications.py` | `oo-cli applications-sync --path .../applications/2026 [--apply]` |
+
+## Notes
+
+- The CLI loads `.env` via `godotenv`; the library itself does not.
+- `applications-sync` defaults to dry-run; pass `--apply` to write to CRM.

cmd/oo-cli/main.go

@@ -0,0 +1,20 @@
+// Command oo-cli is a thin CLI wrapper over the github.com/eslider/go-onlyoffice
+// library. It exposes calendar, CRM, tasks, subtasks, and application-sync
+// commands. Build & install:
+//
+//	go install github.com/eslider/go-onlyoffice/cmd/oo-cli@latest
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/eslider/go-onlyoffice/internal/cli"
+)
+
+func main() {
+	if err := cli.Execute(); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
+	}
+}