feat(absence): add absence crud commands

extend the absence command group with read/add/update/delete\noperations backed by /abcenses endpoints.\n\nadd e2e coverage for the new absence commands and update\nrepository docs to reflect the expanded workflow.

Author: mekedron

README.md

@@ -11,7 +11,7 @@ It is intended for Finnish time tracking use cases.
 - worktime commands (`list/browse/report/options/add/update/delete`)
 - calendar commands (`overview/detailed`)
 - holidays retrieval command
-- absence commands (`options/browse/comment`)
+- absence commands (`options/browse/read/add/update/delete/comment`)
 - configurable local config path
 - separate cache file for API-derived user metadata
 - environment variable credential overrides (Docker/CI friendly)
@@ -74,7 +74,11 @@ otta saldo --format json
 otta holidays --from 2026-02-20 --to 2026-02-20 --worktimegroup <id> --format json
 otta absence browse --from 2026-02-01 --to 2026-02-28 --format json
 otta absence options --format json
-otta absence comment --type sick --from 2026-02-20 --to 2026-02-20
+otta absence add --type <absence-type-id> --from 2026-02-20 --to 2026-02-20 --description "sick leave" --format json
+otta absence read --id <absence-id> --format json
+otta absence update --id <absence-id> --description "sick leave" --format json
+otta absence delete --id <absence-id> --format json
+otta absence comment --type sick --from 2026-02-20 --to 2026-02-20 --format json
 ```
 
 Important: `worktimes list/browse/report` return only worktime rows and do not include absences.
@@ -133,7 +137,7 @@ Credential env vars:
 - `OTTA_CLI_TOKEN_TYPE`
 - `OTTA_CLI_REFRESH_TOKEN`
 - `OTTA_CLI_TOKEN_SCOPE`
-- `OTTA_CLI_USER_ID` (optional convenience for `worktimes add` and `saldo`)
+- `OTTA_CLI_USER_ID` (optional convenience for `worktimes add`, `absence add`, and `saldo`)
 - `OTTA_CLI_WORKTIMEGROUP_ID` (optional convenience for `holidays`, `calendar overview`, and `calendar detailed`)
 
 ## Test and Lint

docs-site/src/pages/index.tsx

@@ -15,6 +15,10 @@ const quickCommands = [
   'otta calendar overview --from 2026-02-01 --to 2026-02-28 --format json',
   'otta absence browse --from 2026-02-01 --to 2026-02-28 --format json',
   'otta absence options --format json',
+  'otta absence add --type <absence-type-id> --from 2026-02-20 --to 2026-02-20 --description "sick leave" --format json',
+  'otta absence read --id <absence-id> --format json',
+  'otta absence update --id <absence-id> --description "sick leave" --format json',
+  'otta absence delete --id <absence-id> --format json',
   'otta absence comment --type sick --from 2026-02-20 --to 2026-02-20 --format json',
   'otta holidays --from 2026-02-20 --to 2026-02-20 --worktimegroup <id> --format json',
 ];
@@ -38,7 +42,7 @@ const highlights = [
   {
     title: 'Timesheet Operations',
     description:
-      'List, browse, report, inspect selectable options, add, update, and delete worktime entries plus run unified calendar overview with deterministic --format output.',
+      'List, browse, report, inspect selectable options, and manage full worktime + absence CRUD flows with deterministic --format output.',
   },
   {
     title: 'Automation Friendly',
@@ -50,7 +54,7 @@ const highlights = [
 const docLinks = [
   {to: '/docs/cli-installation', label: 'Installation', summary: 'Build and run locally, set paths, and bootstrap env vars.'},
   {to: '/docs/cli-auth', label: 'Authentication', summary: 'Credential flow, token handling, and security notes.'},
-  {to: '/docs/cli-timesheets', label: 'Time Tracking', summary: 'Worktime list/browse/report/CRUD, absence browse, holidays retrieval, and calendar overview.'},
+  {to: '/docs/cli-timesheets', label: 'Time Tracking', summary: 'Worktime list/browse/report/CRUD, absence browse/read/add/update/delete, holidays retrieval, and calendar overview.'},
   {to: '/docs/cli-output-contract', label: 'Output Contract', summary: 'JSON envelope shape and scriptability guarantees.'},
 ];
 

docs/cli-installation.md

@@ -57,6 +57,9 @@ $OTTA_BIN --help
 $OTTA_BIN config path
 $OTTA_BIN config cache-path
 $OTTA_BIN absence browse --from 2026-02-01 --to 2026-02-28 --format json
+$OTTA_BIN absence options --format json
+$OTTA_BIN absence add --type <absence-type-id> --from 2026-02-20 --to 2026-02-20 --description "sick leave" --format json
+$OTTA_BIN absence read --id <absence-id> --format json
 $OTTA_BIN calendar overview --from 2026-02-01 --to 2026-02-28 --format json
 $OTTA_BIN calendar detailed --from 2026-02-01 --to 2026-02-28 --format json --duration-format hours
 ```

docs/cli-output-contract.md

@@ -17,9 +17,7 @@ For scriptability, command output is deterministic.
   - `calendar overview`
   - `calendar detailed`
   - `holidays`
-  - `absence options`
-  - `absence browse`
-  - `absence comment`
+  - all `absence` subcommands (`options`, `browse`, `read`, `add`, `update`, `delete`, `comment`)
 - CSV mode is available only for `worktimes report --format csv`
 - `--json` exists as a deprecated alias for `--format json`
 
@@ -106,6 +104,24 @@ Example (`absence browse`, excerpt):
 }
 ```
 
+Example (`absence add`, excerpt):
+
+```json
+{
+  "ok": true,
+  "command": "absence add",
+  "data": {
+    "id": 51744722,
+    "raw": {
+      "abcense": {
+        "id": 51744722,
+        "status": "open"
+      }
+    }
+  }
+}
+```
+
 Example (`calendar overview`, excerpt):
 
 ```json

docs/cli-overview.md

@@ -46,6 +46,10 @@ otta status
 - `otta holidays`: fetch workday calendar/holiday rows.
 - `otta absence options`: fetch absence type/user options.
 - `otta absence browse`: aggregate absence entries across a date range.
+- `otta absence read`: fetch one absence row by id.
+- `otta absence add`: create an absence row.
+- `otta absence update`: update an existing absence row.
+- `otta absence delete`: delete an absence row.
 - `otta absence comment`: generate absence comment text.
 
 Important: `worktimes list/browse/report` do not return absences.
@@ -75,7 +79,12 @@ otta status --format json
 otta worktimes options --date 2026-02-20 --format json
 otta saldo --format json
 otta worktimes list --date 2026-02-20 --format json
+otta absence options --format json
 otta absence browse --from 2026-02-01 --to 2026-02-28 --format json
+otta absence add --type <absence-type-id> --from 2026-02-20 --to 2026-02-20 --description "sick leave" --format json
+otta absence read --id <absence-id> --format json
+otta absence update --id <absence-id> --description "sick leave" --format json
+otta absence delete --id <absence-id> --format json
 otta calendar overview --from 2026-02-01 --to 2026-02-28 --format json
 otta calendar detailed --from 2026-02-01 --to 2026-02-28 --format json
 ```
@@ -91,4 +100,4 @@ A real terminal E2E sweep was run on 2026-02-22 against the live API, covering:
 - calendar overview
 - calendar detailed
 - holidays
-- absence options/browse/comment
+- absence options/browse/read/add/update/delete/comment

docs/cli-roadmap.md

@@ -7,13 +7,13 @@ sidebar_position: 6
 ## Recently Completed
 
 - Added `absence browse` range command (`/ttapi/absence/split`).
+- Added absence CRUD commands: `absence read/add/update/delete` (`/abcenses`).
 - Added `calendar overview` combined day-by-day report (worktimes + absences + holidays).
 - Added `calendar detailed` full day-by-day report with day-off reasons and celebrations.
 
 ## Next
 
-1. Add absence create/update/delete API commands.
-2. Add report/export commands for weekly/monthly summaries.
-3. Add a scripted live E2E smoke gate for auth/worktimes/holidays flows.
-4. Expand integration tests with tenant-specific recorded API fixtures.
-5. Add browser-driven fallback flows via MCP automation.
+1. Add report/export commands for weekly/monthly summaries.
+2. Add a scripted live E2E smoke gate for auth/worktimes/holidays flows.
+3. Expand integration tests with tenant-specific recorded API fixtures.
+4. Add browser-driven fallback flows via MCP automation.

docs/cli-timesheets.md

@@ -172,6 +172,57 @@ Optional API filter for absence type mode:
 otta absence options --type days --format json
 ```
 
+Add an absence row (required: `--type`, plus resolved user):
+
+```bash
+otta absence add \
+  --type <absence-type-id> \
+  --from 2026-02-20 \
+  --to 2026-02-20 \
+  --description "sick leave" \
+  --format json
+```
+
+If `--user` is omitted in `absence add`, fallback order is:
+
+- `OTTA_CLI_USER_ID`
+- cached user profile (`~/.otta-cli/cache.json` by default)
+
+Read one absence row by id:
+
+```bash
+otta absence read --id <absence-id> --format json
+```
+
+Update an absence row:
+
+```bash
+otta absence update --id <absence-id> --description "sick leave" --format json
+```
+
+Delete an absence row:
+
+```bash
+otta absence delete --id <absence-id> --format json
+```
+
+Minimal absence CRUD smoke flow (date used in live validation):
+
+```bash
+DATE=2026-02-20
+
+# 1) Resolve type id
+otta absence options --format json
+
+# 2) Create one row (fill <absence-type-id>)
+otta absence add --type <absence-type-id> --from "$DATE" --to "$DATE" --description "tmp-smoke" --format json
+
+# 3) Read/update/delete (replace <absence-id>)
+otta absence read --id <absence-id> --format json
+otta absence update --id <absence-id> --description "sick leave" --format json
+otta absence delete --id <absence-id> --format json
+```
+
 Generate unified calendar overview (worktimes + absences + holidays):
 
 ```bash

internal/cli/absence_command.go

@@ -19,6 +19,10 @@ func newAbsenceCommand() *cobra.Command {
 
 	absenceCmd.AddCommand(newAbsenceOptionsCommand())
 	absenceCmd.AddCommand(newAbsenceBrowseCommand())
+	absenceCmd.AddCommand(newAbsenceReadCommand())
+	absenceCmd.AddCommand(newAbsenceAddCommand())
+	absenceCmd.AddCommand(newAbsenceUpdateCommand())
+	absenceCmd.AddCommand(newAbsenceDeleteCommand())
 	absenceCmd.AddCommand(newAbsenceCommentCommand())
 
 	return absenceCmd