DOCMOST-10 - trckr

← DOCMOST-10

Created: 2026-01-18 • Updated: 2026-01-18

Relationships Loading...

## Description
Add the missing `workspace invites accept` command to accept workspace invitations via CLI.

## API Reference
From the Postman collection, the API endpoint is:
- **Endpoint:** `POST /workspace/invites/accept`
- **Auth:** No auth required (public endpoint for invitation acceptance)
- **Parameters:**
  - `invitationId` (required): The invitation ID
  - `name` (required): User's display name
  - `password` (required): User's password
  - `token` (required): Invitation token from the invitation link

## Implementation
1. Add `accept` subcommand to the `workspace invites` group in `src/docmost/commands/workspace.py`
2. The command should accept:
   - `INVITATION_ID` as argument
   - `--name` option (required)
   - `--password` option (required, should use click.prompt with hide_input)
   - `--token` option (required)
3. Call `/workspace/invites/accept` endpoint
4. This endpoint does NOT require authentication (new users accepting invites)

## CLI Usage
```bash
docmost workspace invites accept INVITATION_ID --name "John Doe" --token abc123
# Password will be prompted securely
```

## Testing
- Add unit tests in `tests/test_workspace.py`
- Test the command structure and parameter handling
- Mock the API call

## QA Instructions
1. Verify command exists: `docmost workspace invites accept --help`
2. Verify it shows required options (name, password, token)
3. Verify tests pass: `make test`

Pull Requests (comma-separated URLs)

Attachments

Comments (4)

qa-agent · 2026-01-18

## QA PASSED See QA report document: 1f0c01e0-0717-454f-b249-ad3fe831b22f **Verification Complete:** - Command exists with correct options (--name, --token, --password) - All 263 tests pass - README documentation now includes workspace invites accept command Fix verified working. Closing issue.

agent · 2026-01-18

## Documentation Fix Complete ### Problem QA found that README.md was missing documentation for the `workspace invites accept` command. ### Changes Made **File:** `/home/gateway/gitea/docmost-cli/README.md` (lines 259-260) Added documentation for the accept command in the Workspace invites section: ```bash docmost workspace invites accept INVITATION_ID --name "John Doe" --token abc123 # Password will be prompted securely ``` ### Verification - Documentation is now consistent with other invites commands (list, create, revoke, info, resend) - Commit merged to master and pushed to remote

qa-agent · 2026-01-18

## QA NEEDS WORK See QA report document: 1c26de4c-4e4b-45ca-8d6e-bbd66c6e66ca **Issues found:** - README.md is missing documentation for the `workspace invites accept` command The implementation is complete and correct: - Command exists with correct options (--name, --token, --password) - Password prompting is secure with confirmation - All 263 tests pass - No auth header sent (public endpoint) However, per QA instructions, the command must be documented in README.md. The README lists other invites commands (list, create, revoke, info, resend) but not accept. Returning to todo for documentation fix.

agent · 2026-01-18

Implemented the `workspace invites accept` command. ## Changes Made ### src/docmost/commands/workspace.py (lines 197-228) - Added `accept` subcommand to the `invites` group - Takes INVITATION_ID as a required argument - Required options: `--name/-n` and `--token/-t` - Password option `--password/-p` with secure prompt (hide_input=True, confirmation_prompt=True) - Creates an unauthenticated client (public endpoint) by passing empty token - Calls POST /workspace/invites/accept with invitationId, name, password, and token ### tests/test_commands_workspace.py (lines 396-506) - Added TestWorkspaceInvitesAcceptCommand test class with 11 tests covering: - Basic acceptance with prompted password - Explicit password via --password option - Short options (-n, -p, -t) - API parameter verification - No auth header verification - Required option validation (--name, --token) - Error handling (400, 404, 500) ## Verification - All 263 tests pass (including 11 new tests) - Command help displays correct usage ## CLI Usage ```bash # With prompted password (recommended) docmost workspace invites accept INVITATION_ID --name "John Doe" --token abc123 # With explicit password docmost workspace invites accept INVITATION_ID -n "John Doe" -p mypassword -t abc123 ```