huly-mcp-selfhost 2.1.0 → 3.2.0

package/README.md

@@ -27,46 +27,190 @@ This is a fork of [varaprasadreddy9676/huly-mcp](https://github.com/varaprasadre
 - **Issue Statuses** — `list_issue_statuses`, `create_issue_status` (custom workflow states)
 - **Organizations** — `list_organizations`, `get_organization`, `create_organization`, `update_organization`
 
-**Investigated and deliberately not built:** Calendar (not a native event system in Huly — it's a Google Calendar sync bridge requiring infra this fork doesn't assume you're running) and Drive/HR/Recruiting/CRM-Leads/Board (blocked by an [upstream npm packaging bug](https://github.com/hcengineering/platform/issues/10881) — `@hcengineering/*` packages published `0.7.411`+ ship without their `types/` directory, and these modules have no earlier version to pin around it).
+**Beyond the tracker (3.0):** inbox, activity history, planner to-dos and time blocking, calendar events, chat threads/reactions/pins, GitHub pull requests, contact persons — plus generic read access to *every* Huly class (`list_classes`, `describe_class`, `query_documents`) and optional guarded writes (`generic_*`). Modules without a published npm type package (Recruiting, CRM, HR, Board, Drive, …) are reachable through the generic tools; dedicated tools for them follow in 3.1/3.2.
+
+**Deliberately not built:** Love (live video office), Gmail/Telegram/Bitrix bridges (need their own service setup), analytics and UI preferences.
 
 ---
 
-## Tools (53 total)
+## Tools (224 total, grouped in toolsets)
 
 All tools except `list_workspaces` take a `workspace` argument — required for every change, optional for reads when only one workspace is available.
 
+### Toolsets
+
+Every tool schema is sent to the model in each session (Claude Desktop loads all of them up front), so tools are grouped and only the default toolsets are enabled unless you choose otherwise:
+
+```bash
+HULY_TOOLSETS=all                       # everything
+HULY_TOOLSETS=tracker,documents,planner # just these ('core' = list_workspaces is always on)
+```
+
+**Load on demand** (`HULY_DYNAMIC_TOOLSETS=1`): `HULY_TOOLSETS` becomes the starting set, and Claude loads more toolsets itself via `enable_toolsets`. Called without arguments, it lists every toolset with its tools; called with names, it loads them and tells the client that the tool list changed. With `HULY_TOOLSETS=agent,inbox` a session starts at ≈1.8k tokens instead of ≈9–11k. This needs a client that reloads the tool list on `notifications/tools/list_changed`: it is tested with the MCP SDK client, but **not yet verified in Claude Desktop**. Without the variable, nothing changes.
+
+| Toolset | Default | Tools | Contents |
+|---------|:-:|--:|----------|
+| `agent` | ✓ | 14 | agent workflow: my day at a glance, standup, project report, release notes, issue context in one call, start/finish work, plan → issue tree, spec document → issues, meeting notes → issues, changes since, claims, repo → project — plus [resources and prompts](#agent-workflow) |
+| `tracker` | ✓ | 37 | projects, issues, comments, time, labels, relations, milestones, components, statuses, attachments, search |
+| `documents` | ✓ | 8 | teamspaces and documents (tree, move, rename) |
+| `chat` | ✓ | 12 | channels, DMs, threads, edit/delete, reactions, pins |
+| `contacts` | ✓ | 11 | members, organizations, persons, contact channels |
+| `inbox` | ✓ | 3 | notifications, triage (what changed since last read), mark read/archive |
+| `activity` | ✓ | 1 | change history of an issue/object |
+| `planner` | ✓ | 5 | to-dos, time blocking |
+| `generic` | ✓ | 4 | fulltext search across everything, read any Huly class |
+| `tracker-admin` | | 12 | rarely needed admin: create/update project, create status, update/delete label, label categories, delete milestone/component, repair parent links, project types and workflows |
+| `calendar` | | 4 | calendar events |
+| `github` | | 2 | pull requests synced by Huly's GitHub integration (read-only) |
+| `generic-write` | | 3 | create/update/delete any class — dry run by default, deletes need `confirm` |
+| `collaboration` | | 8 | followers (collaborators) of issues/documents, public guest links, document comments |
+| `cards` | | 8 | cards: types and tags, create/edit/move/delete, nesting, field values |
+| `fields` | | 3 | custom fields on issues, project types, card types or any class; set values |
+| `drive` | | 10 | drives, folders, versioned files: upload, download, move, restore versions |
+| `templates` | | 11 | issue templates with sub-issues, new issue from template; message templates |
+| `testing` | | 23 | test management: projects, suites, cases, plans, runs, results; JUnit import, report, bugs from failed tests |
+| `products` | | 2 | products and versions (read-only) |
+| `members` | | 4 | workspace settings, invite links and e-mails, member roles |
+| `recruiting` | | 9 | vacancies, candidates, applications |
+| `crm` | | 5 | leads, customers |
+| `hr` | | 7 | departments, staff, vacation/sick/remote days |
+| `inventory` | | 5 | categories, products, variants (SKU) |
+| `meetings` | | 2 | office rooms, meeting minutes and transcripts (read-only) |
+| `qms` | | 4 | controlled documents and trainings (read-only) |
+| `process` | | 4 | process definitions and executions; start and cancel |
+| `surveys` | | 2 | surveys and aggregated poll answers (read-only) |
+
+Context cost of `tools/list` (≈3.5 chars/token):
+
+| | default (96 tools) | `all` (224 tools) |
+|---|--:|--:|
+| several workspaces | ~36.5k chars ≈ **10.4k tokens** | ~81.6k chars ≈ **23.3k tokens** |
+| pinned with `HULY_WORKSPACE` | ~33k chars ≈ **9.4k tokens** | ~73.3k chars ≈ **20.9k tokens** |
+
+For comparison, 2.2.0 needed ≈12.8k tokens for 64 tools. **Using one workspace? Set `HULY_WORKSPACE`** — the `workspace` argument then disappears from every tool (−10%). **Claude Code** loads MCP tools on demand, so there even `HULY_TOOLSETS=all` costs little up front.
+
+### Agent workflow
+
+Tools, resources and prompts for AI agents working on Huly issues (toolset `agent`):
+
+| Tool | What it does |
+|------|--------------|
+| `my_day` | Today (or `date`) in one call: own calendar events and work slots, open to-dos (overdue and due first), open issues assigned to me (in progress first), PRs waiting for my review and my own open PRs, unread inbox grouped by object. Times in UTC |
+| `standup` | What I did since the last working day (Monday → Friday, or `since`): status changes, new issues, comments, time, finished to-dos; then today (calendar, to-dos, my issues) and my issues blocked by open ones |
+| `release_notes` | Release notes from a milestone: done issues as "New and changed" and "Fixes" (by title or label, English and German), merged PR numbers, epics left out; open issues listed separately |
+| `project_report` | Weekly (or `since`: `14d`, ISO date) report of a project: done in the period (status changed to done — not just touched by sync), new, in progress (flagged when untouched), blocked by open issues, overdue, PRs merged and open, open milestones with progress and target, time logged per person. To keep it in Huly, pass the text to `create_document` + `update_document` |
+| `get_issue_context` | Everything about an issue in one call: fields, description, parent chain, sub-issues, blocked by / blocks, related, PRs, comments, suggested branch name |
+| `start_work` | Status → In Progress, assign to me, optionally claim — returns the full context |
+| `finish_work` | Work summary as comment, PR (`#12`, URL or Huly id) linked as sub-issue, status → Review in progress, claim released. Validates the PR before changing anything |
+| `create_issue_tree` | Plan → epic + sub-issues with priorities, components, milestones, assignees, labels and blockers (`"#2"` = second child). Same-title issues are reused, dry run by default |
+| `issues_from_document` | Spec → issues: the open checklist items of a Huly document (without a checklist: its sections) become sub-issues of an epic, checked items are skipped, the document is linked to the epic. Dry run by default; one call instead of reading the document and repeating every task |
+| `issues_from_meeting` | Meeting notes → issues: open checkboxes, lines starting with `TODO:`/`Action:`/`Aufgabe:` and list items under a heading like "Action items" or "Next steps" become issues. `@Name` (or a Huly mention) becomes the assignee, a date (`2026-11-10`, `10.11.2026`, "due …"/"bis …") the due date. Unknown people are flagged and left unassigned; same-title issues are skipped; each new issue is linked to the document. Dry run by default |
+| `changes_since` | Issues/PRs changed since `24h`, `7d` or an ISO time — which fields changed, new comments, by whom |
+| `find_project_for_repo` | Workspace + project linked to a GitHub repo (`owner/name`, URL or git remote) via Huly's GitHub integration |
+| `claim_issue` / `release_issue` | Lease an issue to an agent (label `agent:working` + comment marker) so parallel agents skip it; expires after `minutes` |
+
+**Resources** — `huly://<workspace>/issue/<PROJ-12>` and `huly://<workspace>/document/<id>`. Your open assigned issues are listed, so in Claude Code you can `@`-mention them.
+
+**Prompts** — `start`, `finish`, `plan`, `triage`, `standup` (in Claude Code: `/mcp__huly__start` …).
+
+**Guard rails** (environment):
+
+| Variable | Effect |
+|----------|--------|
+| `HULY_WRITE_PROJECTS=TSK,WEB` | Changes are only allowed when every project they touch (project keys and `PROJ-12` ids in the arguments) is listed. Reads are never blocked. Tools without a project (chat, documents, planner) are not affected |
+| `HULY_AUDIT_LOG=/path/audit.jsonl` | Every change is appended as one JSON line (time, tool, shortened arguments, success, first line of the result) |
+| `HULY_AGENT_NAME=claude-2` | Default agent name for claims |
+| `HULY_CONFIRM=auto` | Deletes and other hard-to-undo tools (`delete_*`, `bulk_update_issues`, `move_issue`, `generic_update`/`generic_delete`, `revoke_public_link`, `restore_file_version`) ask you first via MCP elicitation when the client can show a form (Claude Code in an interactive session). `auto` (default): ask when possible, otherwise run as before. `strict`: refuse when the client cannot ask (unattended agents). `off`: never ask. Dry runs never ask |
+
+### Huly hands work to Claude: `huly-mcp watch`
+
+`huly-mcp watch` turns Huly into the place where you give Claude work. It polls for open issues that carry a label (`--label claude`) or are assigned to the account it runs as (`--assigned`, the default), and for each one:
+
+1. claims the issue (`claim_issue`), so a second watcher or agent skips it,
+2. runs a command for it — by default `claude -p` in the current directory, with this MCP server attached and a prompt that says: read the issue, do the work, hand back with `finish_work`,
+3. releases the claim if the run did not (`finish_work` releases it), and comments on the issue if the run failed or timed out.
+
+```bash
+cd ~/code/my-repo
+npx huly-mcp-selfhost watch --workspace acme --project WEB --label claude --dry-run   # what would run
+npx huly-mcp-selfhost watch --workspace acme --project WEB --label claude             # poll every 60 s
+```
+
+- **Each issue runs once.** A state file (`~/.huly-mcp/watch-<workspace>.json`) remembers it. To run it again, remove the label and add it again.
+- **The command is yours.** `--command` takes any program; the placeholders `{prompt}` `{issue}` `{title}` `{workspace}` `{agent}` `{trigger}` `{mcpConfig}` are filled in per argument — no shell is involved, so issue titles cannot inject shell commands. The run also gets `HULY_ISSUE`, `HULY_ISSUE_TITLE` and `HULY_WORKSPACE` in its environment. Examples: a GitHub Action (`--command "gh workflow run agent.yml -f issue={issue}"`), or Claude with more tools (`--command "claude -p {prompt} --mcp-config {mcpConfig} --allowedTools mcp__huly,Bash(npm test),Edit"`).
+- **Default command:** `claude -p {prompt} --mcp-config {mcpConfig} --strict-mcp-config --allowedTools mcp__huly --permission-mode acceptEdits`. `{mcpConfig}` is a temporary MCP config that starts this server limited to the watched workspace; the credentials are passed through the environment, not written to the file.
+- **Unattended means careful.** Runs get `HULY_CONFIRM=strict` unless you set it: deletes and other risky tools are refused, because nobody is there to confirm them. `HULY_WRITE_PROJECTS` limits which projects are watched and changed. Issue text reaches the agent as instructions — only watch projects whose writers you trust.
+- **Its own identity.** Give the agent its own Huly account (invite e.g. `claude@your-domain` to the workspace) and start the watcher with that account's credentials (`--env-file agent.env` with `HULY_EMAIL`/`HULY_PASSWORD` or `HULY_TOKEN`). Then you hand work to Claude by assigning an issue to that user, and every comment, status change and claim shows up under its name instead of yours. `--agent <name>` (or `HULY_AGENT_NAME`) names it in claims.
+- Other options: `--interval <sec>`, `--timeout <min>` (default 60), `--once`, `--cwd <dir>`, `--prompt <template>`, `--state <file>`. `huly-mcp watch --help` lists them all.
+
+### CI test results into Huly: `huly-mcp junit`
+
+`huly-mcp junit report.xml --project "App"` imports a JUnit XML report as a test run in Huly's test management. Almost every test runner writes JUnit XML (Jest/Vitest with a JUnit reporter, `pytest --junitxml`, `go-junit-report`, Gradle, Maven Surefire, xcpretty). Suites and cases that do not exist yet are created; failed tests keep their message and stack trace. Then ask Claude *"What is flaky in App?"* (`get_test_report`) or *"File bugs for today's failures in PROJ"* (`create_issue_from_test_result`).
+
+```yaml
+# .github/workflows/test.yml (after the test step)
+- name: Report to Huly
+  if: always()
+  run: npx -y huly-mcp-selfhost junit reports/junit.xml --project "App" --run "CI ${{ github.ref_name }} #${{ github.run_number }}"
+  env:
+    HULY_URL: ${{ secrets.HULY_URL }}
+    HULY_TOKEN: ${{ secrets.HULY_TOKEN }}
+    HULY_WORKSPACE: my-workspace
+```
+
+Options: `--run <name>`, `--parent-suite <suite>`, `--no-create` (only existing cases), `--fail-on-failures` (exit code 1 when tests failed), `--dry-run`, `--workspace`. `huly-mcp junit --help` lists them.
+
+### Tool reference
+
 | Category | Tool | Description |
 |----------|------|-------------|
 | **Workspaces** | `list_workspaces` | List the workspaces this account can access (name, slug, id) |
 | **Projects** | `list_projects` | List all projects in a workspace |
 | | `get_project` | Get project details + available statuses |
-| | `create_project` | Create a new tracker project with a unique identifier |
-| **Issues** | `list_issues` | List issues with optional status / priority filters |
-| | `get_issue` | Get full details of an issue (e.g. `PROJ-42`) |
+| | `create_project` | Create a new tracker project with a unique identifier *(tracker-admin)* |
+| | `update_project` | Change name, description, default assignee or default status *(tracker-admin)* |
+| **Issues** | `list_issues` | List issues — open ones by default (`status: "all"` or a status name for others), filterable by priority, milestone, component, label, assignee, parent; `offset` pages through long lists ("51–100 of 118") |
+| | `get_issue` | Full details of an issue (e.g. `PROJ-42`): assignee, milestone, component, labels, parent, links |
 | | `create_issue` | Create a new issue (with optional Markdown description) |
 | | `update_issue` | Update title, description, status, priority, assignee, due date, component, milestone |
 | | `delete_issue` | Permanently delete an issue by identifier |
+| | `bulk_update_issues` | Same change on many issues at once — validates all before writing |
+| | `move_issue` | Move an issue (with sub-issues, comments, attachments, labels, time) to another project |
+| | `list_sub_issues` | Sub-issue tree of an epic with status and progress |
 | **Comments** | `add_comment` | Add a comment to an issue |
-| | `list_comments` | List all comments on an issue (includes IDs for `delete_comment`) |
+| | `list_comments` | Newest comments on an issue, oldest first (includes IDs for `delete_comment`); comments over 1,500 chars are shortened with a marker unless `full: true` |
+| | `update_comment` | Edit a comment |
 | | `delete_comment` | Delete a specific comment by ID |
 | **Time Tracking** | `log_time` | Log hours spent on an issue |
+| | `list_time_reports` | Logged time per issue or project, totals per member, member/date filters |
 | **Labels** | `list_labels` | List all labels with color + usage count |
 | | `create_label` | Create a new label with an optional hex color |
 | | `add_label` | Add a label to an issue (auto-creates if it doesn't exist) |
 | | `remove_label` | Remove a label from an issue |
+| | `update_label` | Rename or recolor a label (updated on every issue) *(tracker-admin)* |
+| | `delete_label` | Delete a label and remove it from every issue *(tracker-admin)* |
 | **Relations** | `add_relation` | Mark two issues as related (bidirectional) |
 | | `add_blocked_by` | Mark an issue as blocked by another issue |
 | | `set_parent` | Set or clear the parent epic of an issue |
-| **Members** | `list_members` | List workspace members |
+| | `remove_relation` | Remove a "related" link |
+| | `remove_blocked_by` | Remove a "blocked by" link |
+| | `repair_parent_links` | Fix sub-issues linked by huly-mcp ≤ 2.1 that don't show under their parent (dry run by default) *(tracker-admin)* |
+| **Members** | `list_members` | List workspace members with names and roles |
+| **Persons** (`contacts`) | `list_persons` | Contact persons with their channels |
+| | `get_person` | Person details, contact channels, organizations |
+| | `create_person` | Create a contact person (with optional channels) |
+| | `update_person` | Change name or city |
+| | `add_contact_channel` | Add email, phone, LinkedIn, … |
+| | `remove_contact_channel` | Remove a contact channel |
 | **Milestones** | `list_milestones` | List milestones for a project |
 | | `create_milestone` | Create a milestone with a target date and status |
 | | `get_milestone` | Milestone details with progress (done/open/canceled issues) and the open issues |
 | | `update_milestone` | Change name, target date, status or description |
-| | `delete_milestone` | Delete a milestone; its issues are unassigned or moved (`moveIssuesTo`) |
+| | `delete_milestone` | Delete a milestone; its issues are unassigned or moved (`moveIssuesTo`) *(tracker-admin)* |
 | **Components** | `list_components` | List components (sub-areas) in a project |
 | | `create_component` | Create a new component with optional lead |
 | | `update_component` | Change name, description or lead |
-| | `delete_component` | Delete a component; its issues are unassigned or moved (`moveIssuesTo`) |
+| | `delete_component` | Delete a component; its issues are unassigned or moved (`moveIssuesTo`) *(tracker-admin)* |
 | **Documents** | `list_teamspaces` | List document teamspaces |
 | | `create_teamspace` | Create a new teamspace (top-level document folder) |
 | | `list_documents` | List documents in a teamspace |
@@ -75,21 +219,89 @@ All tools except `list_workspaces` take a `workspace` argument — required for
 | | `create_document` | Create a new document in a teamspace |
 | | `update_document` | Write Markdown content to a document — Mermaid diagrams render natively |
 | | `link_document` | Link a document to an issue — appears in the Relations panel |
+| | `list_documents` | Shows the full document tree; `update_document` also renames and moves (incl. to another teamspace, with sub-documents) |
 | **Search** | `search_issues` | Full-text search across all issues of a workspace |
+| | `search` | Full-text search across everything — issues, documents, messages, cards, files, persons … (`kinds` filter) *(generic)* |
 | **Chat** | `list_channels` | List all channels in the workspace |
 | | `create_channel` | Create a new channel |
 | | `start_direct_message` | Start (or find) a 1:1 direct message with a workspace member |
 | | `send_message` | Send a message to a channel or direct message |
-| | `list_messages` | List messages in a channel or direct message |
+| | `list_messages` | List messages with authors, ids, replies, reactions, pins |
+| | `list_thread` | A message with its thread replies |
+| | `reply_to_message` | Reply in a thread (channel messages and issue comments) |
+| | `update_message` | Edit a message or reply |
+| | `delete_message` | Delete a message or reply |
+| | `add_reaction` / `remove_reaction` | Emoji reactions |
+| | `pin_message` | Pin or unpin a message |
 | **Attachments** | `attach_file` | Attach a file to an issue (base64-encoded content) |
 | | `list_attachments` | List files attached to an issue |
 | | `delete_attachment` | Delete a file attachment from an issue |
 | **Issue Statuses** | `list_issue_statuses` | List all issue statuses (workflow states), grouped by phase |
-| | `create_issue_status` | Create a new issue status — available in every project immediately |
+| | `create_issue_status` | Create a new issue status — available in every project immediately *(tracker-admin)* |
 | **Organizations** | `list_organizations` | List all organizations (companies) in the workspace |
 | | `get_organization` | Get details of an organization, including description |
 | | `create_organization` | Create a new organization (company contact) |
 | | `update_organization` | Set the description of an organization from Markdown |
+| **Inbox** (`inbox`) | `list_notifications` | Your notifications, grouped by issue/PR/document |
+| | `triage_inbox` | Work through the inbox in one call: per unread item its status and assignee, which fields changed and the new comments (plain text, shortened) since you last read it |
+| | `mark_notifications_read` | Mark read by object, ids or all; optionally archive |
+| **Activity** (`activity`) | `get_activity` | Who changed what, plus comments, for an issue or object |
+| **Planner** (`planner`) | `list_todos` | Your to-dos (open/done, due date filter) |
+| | `create_todo` | Create a to-do, optionally attached to an issue |
+| | `update_todo` | Change title, due date, priority; mark done/reopen |
+| | `delete_todo` | Delete a to-do |
+| | `schedule_todo` | Block time for a to-do in your calendar |
+| **Calendar** (`calendar`) | `list_events` | Events and work slots in a date range |
+| | `create_event` / `update_event` / `delete_event` | Manage events in your calendar |
+| **GitHub** (`github`) | `list_pull_requests` | PRs by project, issue, state |
+| | `get_pull_request` | State, branches, reviews, review comments, linked issue |
+| **Generic** (`generic`) | `list_classes` | All data classes of the workspace (filter by module, optional counts) |
+| | `describe_class` | Attributes and types of a class |
+| | `query_documents` | Read documents of any class; secrets are redacted |
+| **Generic write** (`generic-write`) | `generic_create` / `generic_update` / `generic_delete` | Any class; dry run by default, deletes also need `confirm: true`; system classes, spaces and credentials are blocked |
+| **Collaboration** (`collaboration`) | `list_collaborators` / `add_collaborator` / `remove_collaborator` | Who follows an issue/document (and gets its notifications) |
+| | `create_public_link` / `list_public_links` / `revoke_public_link` | Read-only guest links for issues and documents |
+| | `list_document_comments` / `add_document_comment` | Comments on documents |
+| **Cards** (`cards`) | `list_card_types` / `create_card_type` / `delete_card_type` | Card types (MasterTags) and tags |
+| | `list_cards` / `get_card` | Cards by type, parent or title; one card with fields, tags, children, content |
+| | `create_card` / `update_card` / `delete_card` | With content (Markdown), parent, tags and field values |
+| **Custom fields** (`fields`) | `list_custom_fields` | Fields of issues, a project type, card type or class — or the values on one object |
+| | `create_custom_field` | string, number, boolean, date, markup, enum (with values) or ref |
+| | `set_custom_fields` | Set values on an issue, card or document (validated against the type) |
+| **Drive** (`drive`) | `list_drives` / `create_drive` / `list_drive_files` | Drives and their folder tree |
+| | `create_folder` / `update_drive_item` / `delete_drive_item` | Folders; rename/move files and folders (across drives too) |
+| | `upload_file` / `download_file` | Base64 or local files under `HULY_FILE_ROOT`; same name → new version |
+| | `list_file_versions` / `restore_file_version` | File history |
+| **Issue templates** (`templates`) | `list_issue_templates` / `get_issue_template` | Templates with their sub-issues |
+| | `create_issue_template` / `update_issue_template` / `delete_issue_template` | Priority, assignee, component, milestone, estimation, labels, sub-issues |
+| | `create_issue_from_template` | New issue plus sub-issues from a template |
+| **Test management** (`testing`) | `list_test_projects` / `create_test_project` | Test projects |
+| | `list_test_cases` / `create_test_suite` / `get_test_case` / `create_test_case` / `update_test_case` / `delete_test_case` | Suites (nested) and cases |
+| | `list_test_plans` / `create_test_plan` | Plans from suites and/or cases |
+| | `create_test_run` / `list_test_runs` / `get_test_run` / `set_test_result` | Runs with Passed/Failed/Blocked results; results can be assigned |
+| | `create_test_cases` | Many cases in one call (e.g. drafted from a spec or an issue); existing names are skipped |
+| | `update_test_suite` / `delete_test_suite` / `update_test_run` / `delete_test_run` / `delete_test_plan` | Rename/move suites (no cycles), delete with `recursive`, run due dates |
+| | `import_test_results` | JUnit XML from CI (Jest, Vitest, pytest, Go, Gradle, Maven, xcpretty …) as a run; missing suites/cases are created, failures keep message and stack trace |
+| | `get_test_report` | Over the latest runs: failing now, flaky (flipped ≥ 2×), blocked, never run, per-suite table |
+| | `create_issue_from_test_result` | Bug from a failed result: steps + failure in the description, related to the test case, comment on the result |
+| **Products** (`products`) | `list_products` / `get_product` | Products and their versions (read-only) |
+| **Labels** (`tracker-admin`) | `list_label_categories` / `create_label_category` / `set_label_category` | Group issue labels |
+| **Project types** (`tracker-admin`) | `list_project_types` | Project types, their task types and status workflows, and which projects use them |
+| **Workspace** (`members`) | `get_workspace_settings` | Your role, members per role, invite defaults, integrations |
+| | `create_invite_link` / `send_invite` / `set_member_role` | Invite links (personal or with use limit and e-mail mask; nothing is sent), invitation e-mails, roles. `send_invite` and `set_member_role` ask for confirmation |
+| **Recruiting** (`recruiting`) | `list_vacancies` / `create_vacancy` / `update_vacancy` | Vacancies with applications per status; archive via `update_vacancy` |
+| | `list_candidates` / `create_candidate` | Candidates (person + title, e-mail, onsite/remote) |
+| | `list_applications` / `create_application` / `update_application` / `delete_application` | Applications `APP-n` through the vacancy's workflow, one per candidate and vacancy |
+| **CRM** (`crm`) | `list_leads` / `create_lead` / `update_lead` / `delete_lead` / `list_customers` | Leads `LEAD-n` in funnels; a new customer (person or organization) can be created with the lead |
+| **HR** (`hr`) | `list_departments` / `create_department` / `delete_department` / `set_department` | Department tree, team leads, members |
+| | `list_time_off` / `create_time_off` / `delete_time_off` | Vacation, sick days, PTO, overtime, remote days |
+| **Inventory** (`inventory`) | `list_inventory` / `create_inventory_category` / `create_inventory_product` / `update_inventory_item` / `delete_inventory_item` | Categories, products, variants with SKU (Huly beta module) |
+| **Message templates** (`templates`) | `list_message_templates` / `get_message_template` / `create_message_template` / `update_message_template` / `delete_message_template` | Reusable texts with `${field}` placeholders |
+| **Meetings** (`meetings`) | `list_meetings` / `get_meeting` | Rooms, meeting minutes, action items and transcripts (read-only) |
+| **QMS** (`qms`) | `list_controlled_documents` / `get_controlled_document` | Controlled documents: version, state, reviewers/approvers, requests, content (read-only) |
+| | `list_trainings` / `get_training` | Trainings, questions (answers optional) and trainee results (read-only) |
+| **Processes** (`process`) | `list_processes` / `list_executions` / `start_process` / `cancel_execution` | Process states and transitions; running executions; run a process on a card like Huly's "Run process" menu (processes that ask for input in the app are refused); cancel asks first |
+| **Surveys** (`surveys`) | `list_surveys` / `get_survey` | Surveys and aggregated poll answers (read-only) |
 
 ---
 
@@ -129,11 +341,12 @@ npm run build
 
 ### Docker (network-reachable server, not local stdio)
 
-For deployments where the MCP server needs to be reachable over the network (behind a reverse proxy, remote MCP clients, etc.) rather than launched locally per-client, a prebuilt image is published to GHCR on every push to `main`:
+For deployments where the MCP server needs to be reachable over the network (behind a reverse proxy, remote MCP clients, etc.) rather than launched locally per-client, a prebuilt image is published to Docker Hub and GHCR for every release, for `linux/amd64` and `linux/arm64`:
 
 ```bash
-docker pull jokeks2023/huly-mcp:latest
+docker pull jokeks2023/huly-mcp:latest   # latest release; also :3, :3.1, :3.1.0
 # also mirrored at ghcr.io/jokeks2023/huly-mcp:latest
+# :edge = latest build from main
 ```
 
 Or with Compose — copy `.env.example` to `.env`, fill in your credentials (no workspace needed), then:
@@ -142,7 +355,7 @@ Or with Compose — copy `.env.example` to `.env`, fill in your credentials (no
 docker compose up -d
 ```
 
-The container wraps the server with [`mcp-proxy`](https://github.com/sparfenyuk/mcp-proxy) to expose it over HTTP/SSE at `:8000/sse`, since standard MCP stdio transport can't be reached over a network directly. See [`Dockerfile`](Dockerfile) / [`docker-compose.yml`](docker-compose.yml).
+The container wraps the server with [`mcp-proxy`](https://github.com/sparfenyuk/mcp-proxy) to expose it over HTTP/SSE at `:8000/sse`, since standard MCP stdio transport can't be reached over a network directly. **Behind a reverse proxy or on a public hostname, set `MCP_ALLOWED_HOSTS`** to the host name(s) clients use, e.g. `MCP_ALLOWED_HOSTS=huly-mcp.example.com`. Otherwise mcp-proxy only accepts `localhost` and answers `421 Invalid Host header`. See [`Dockerfile`](Dockerfile) / [`docker-compose.yml`](docker-compose.yml).
 
 ---
 
@@ -160,7 +373,7 @@ A single Huly account can belong to several workspaces — e.g. a personal one a
 
 **Workspace slug:** the part of the Huly URL after the domain: `huly.app/workbench/`**`myteam`** → `myteam`. You don't need to look it up — `list_workspaces` (or `npm run setup`) prints it.
 
-**Legacy `HULY_WORKSPACE`:** still honoured, but only as an optional *restriction*: if set, this server exposes just that one workspace (as before). Leave it unset to use all workspaces.
+**`HULY_WORKSPACE`:** pins the server to that one workspace. Tools then have no `workspace` argument at all, which saves ~20% of the tool-list tokens. Leave it unset to use all workspaces of the account.
 
 ---
 
@@ -172,10 +385,47 @@ A single Huly account can belong to several workspaces — e.g. a personal one a
 | `HULY_TOKEN` | one auth option | Account token for SSO accounts (Google/GitHub) — get it with `npm run setup` |
 | `HULY_ACCOUNTS_URL` | self-hosted only | Account service — login and workspace discovery. Default `https://account.huly.app`. Self-hosted: your instance's accounts URL, e.g. `https://huly.example.com/_accounts` |
 | `HULY_FRONT_URL` | self-hosted (optional on Cloud) | Front service — document/description content and file uploads. Not involved in login or workspace discovery. Self-hosted: e.g. `https://huly.example.com` |
-| `HULY_WORKSPACE` | no (legacy) | Restrict the server to a single workspace |
+| `HULY_TRANSACTOR_URL` | no | Self-hosted, server next to Huly: connect to the transactor directly instead of the public address the account service returns, e.g. `ws://huly/_transactor` (via nginx) or `ws://transactor:3333`. Saves the detour through your uplink/tunnel. `HULY_ACCOUNTS_URL` can be internal too (`http://huly/_accounts`); an internal `HULY_FRONT_URL` also works but then invite links show the internal address |
+| `HULY_WORKSPACE` | no | Pin the server to one workspace; tools then take no `workspace` argument (fewer tokens) |
+| `HULY_DYNAMIC_TOOLSETS` | no | `1`: start with `HULY_TOOLSETS` and load more on demand via `enable_toolsets` (see [Toolsets](#toolsets)) |
+| `HULY_TOOLSETS` | no | Comma-separated toolsets to enable, or `all` (see [Toolsets](#toolsets)). Default: `agent,tracker,documents,chat,contacts,inbox,activity,planner,generic` |
+| `HULY_WRITE_PROJECTS` | no | Only allow changes in these projects, e.g. `TSK,WEB` (see [Agent workflow](#agent-workflow)) |
+| `HULY_AUDIT_LOG` | no | Append every change as JSON line to this file |
+| `HULY_AGENT_NAME` | no | Default agent name for `claim_issue` (default `claude`) |
+| `HULY_CONFIRM` | no | `auto` (default), `strict` or `off` — ask before deletes and other risky tools (see [Agent workflow](#agent-workflow)) |
+| `HULY_FILE_ROOT` | no | Directory for local files: `upload_file` (`localPath`) and `download_file` (`savePath`) only work inside it. Off when unset — the server may run remotely |
+| `HULY_SUBSCRIBE_POLL_MS` | no | How often subscribed `huly://` resources are checked for changes (default 30000, minimum 5000) |
 
 ---
 
+## Claude Code plugin
+
+The repo is also a Claude Code plugin marketplace. The plugin bundles the MCP server with a workflow skill, hooks and commands:
+
+```
+/plugin marketplace add JoKeks2023/huly-mcp
+/plugin install huly@huly-mcp
+```
+
+> **Note:** the plugin starts `huly-mcp-selfhost@^3.0.0` from npm. To try a local checkout instead: `npm run build`, then point `plugin/.mcp.json` at `dist/index.js` and start `claude --plugin-dir ./plugin`.
+
+Claude Code then asks for your Huly settings (e-mail + password or token, and for self-hosted Huly the accounts and front URL; passwords and tokens go to the OS keychain).
+
+| Part | What it does |
+|------|--------------|
+| MCP server | `huly-mcp-selfhost` via `npx`, configured from the plugin settings (toolsets, on-demand loading, pinned workspace and writable projects included) |
+| Skill `huly-workflow` | When and how to use Huly while coding: find the project for the repo, duplicate check before new issues, component + milestone, status flow, PR → issue links, epics for plans |
+| Skill `huly-efficient` | Cheapest call for each question and change, with measured output sizes: one-call overviews, filters instead of full lists, one write instead of create-then-update, no pre-checks the tools already do |
+| Hook on session start | Reports the GitHub repo and branch; a branch like `proj-12-login` points Claude to issue `PROJ-12` (no network, no credentials) |
+| Hook after `gh pr create` / `gh pr merge` | Reminds Claude to link the new PR to its issue (`finish_work`) or to check the status after a merge |
+| `/huly:start [PROJ-12]` | Pick up an issue (from the argument or the branch), load the context, plan |
+| `/huly:finish [PROJ-12] [PR]` | Honest summary, PR link, status to review |
+| `/huly:plan <goal>` | Plan → epic + sub-issues (dry run first) |
+| `/huly:day`, `/huly:standup [since]`, `/huly:triage` | My day, stand-up, inbox triage — one call each (`my_day`, `standup`, `triage_inbox`) |
+| `/huly:report <PROJECT> [7d]` | Project status: progress, milestones, blockers (`project_report`) |
+
+Without the plugin, the same server works in Claude Code as a plain MCP server (see below); the MCP prompts `start`, `finish`, `plan`, `triage`, `standup` are available there too.
+
 ## Compatible Clients
 
 The same MCP server works across all major AI coding tools. All examples use **email + password** and the npm package via `npx`; for SSO accounts replace the two credentials with `"HULY_TOKEN": "your-token"` (see [Authentication](#authentication)). To run a local build instead, replace `npx` + args with `node` + `["/absolute/path/to/huly-mcp/dist/index.js"]`.
@@ -380,6 +630,20 @@ For network access (HTTP/SSE) use the [Docker image](#docker-network-reachable-s
 - *"Move the v2.0 Launch milestone to 2026-07-15 and set it to In Progress"*
 - *"Delete milestone 'Beta' in PROJ and move its issues to 'v2.0 Launch'"*
 
+**Planning & bulk work:**
+- *"Which issues in milestone v2.0 Launch carry the label 'bug' and are still unassigned?"*
+- *"Set PROJ-12, PROJ-13 and PROJ-20 to In Progress and put them into milestone v2.0 Launch"*
+- *"Show me the sub-issue tree of PROJ-1 and how far along it is"*
+- *"How many hours did we log on PROJ in October, per person?"*
+- *"Move PROJ-42 to the OPS project"*
+
+**Inbox, planner, calendar:**
+- *"What's new in my inbox? Mark everything about PROJ-12 as read"*
+- *"Create a to-do 'Review PR' on PROJ-7 due Friday and block 45 minutes tomorrow at 9"*
+- *"What's on my calendar this week?"*
+- *"Show the history of PROJ-12 — who moved it to Done?"*
+- *"Which pull requests are waiting for review in PROJ?"*
+
 **Labels & relations:**
 - *"Add the label 'bug' to PROJ-42"*
 - *"Create a label called 'backend' with color #3b82f6"*
@@ -553,8 +817,190 @@ See [`src/connection.ts`](src/connection.ts).
 
 ---
 
+## Development and CI
+
+```bash
+npm ci && npm run build && npm test
+```
+
+GitHub Actions check every pull request:
+
+| Workflow | What it checks |
+|---|---|
+| `ci.yml` | build and tests on Node 20/22/24 (Linux), macOS and Windows; the built server answers `tools/list` over stdio; `npm pack` contents; gitleaks and a personal-data check; the Docker image (build, stdio smoke, Trivy); actionlint; a **token report** comment with the `tools/list` size before and after the PR |
+| `codeql.yml` | CodeQL security analysis (also weekly) |
+| `links.yml` | broken links in Markdown and the site (on PRs that touch them, and weekly → issue) |
+| `dependabot-automerge.yml` | Dependabot patch/minor updates merge by themselves once checks are green; majors and Huly packages wait for review |
+| `scheduled.yml` | nightly live smoke test against a sandbox workspace; weekly: the latest `@hcengineering/*` packages, and Huly modules that have no tools yet (see `.github/huly-modules-ignore.txt`). Failures open or update an issue |
+| `release.yml` | on a `vX.Y.Z` tag: version and changelog check, tests, personal-data check, `npm publish --provenance` (Trusted Publishing), GitHub release from the changelog section, MCP registry entry |
+
+Security reports: see [SECURITY.md](SECURITY.md).
+
+`test/repo.test.ts` keeps the docs honest: tool counts in this README, the site and `DOCKERHUB.md` must match the registry, the version must match everywhere, and the plugin must be well-formed.
+
+**Releasing:**
+1. Move the `Unreleased` changelog entries under `### X.Y.Z — date`.
+2. Bump the version in `package.json`, `server.json`, `plugin/.claude-plugin/plugin.json` and `src/server.ts`. The tests check that they agree.
+3. Merge, then tag `vX.Y.Z` on `main`. The rest runs by itself.
+
+**Environments and secrets:**
+- Environment `release` (tags `v*` only): used by `release.yml`. npm Trusted Publishing names this environment.
+- Environment `sandbox`: used by the nightly live jobs.
+
+Secrets:
+- `PERSONAL_DATA_PATTERNS`: private terms that must never appear in the repo, one regex per line.
+- `NPM_TOKEN`: fallback only, until Trusted Publishing is set up on npmjs.com.
+- In the environment `sandbox`: `HULY_SMOKE_WORKSPACE`, `HULY_SMOKE_PROJECT`, `HULY_SMOKE_EMAIL` + `HULY_SMOKE_PASSWORD` (or `HULY_SMOKE_TOKEN`), `HULY_SMOKE_ACCOUNTS_URL`, `HULY_SMOKE_FRONT_URL`: a **throwaway** workspace for the nightly live test. Without them the live jobs skip.
+
+---
+
 ## Changelog
 
+### 3.2.0 — 2026-11-11
+
+- **New: `issues_from_document`** — spec → issues in one call: open checklist items of a Huly document (or, without a checklist, its sections) become sub-issues of an epic; checked items are skipped; the document is linked to the epic. Dry run by default.
+- **New: `issues_from_meeting`** — meeting notes → issues in one call: action items (open checkboxes, `TODO:`/`Action:` lines, lists under "Action items"/"Next steps") with `@assignee` and due date taken from the line; dry run first, each new issue linked to the document.
+- **`create_issue` takes `assignee`, `componentLabel` and `milestoneLabel`**, so a new issue no longer needs a second `update_issue` call. An unknown `statusName` is now an error (it used to fall back to the first status). Everything is checked before anything is written.
+- **Unknown tool parameters are rejected instead of silently dropped.** Before, `update_issue {status: "Done"}` answered "No changes made". Now the call fails with the list of valid parameters and nothing is done. Common mix-ups are mapped automatically: `status`→`statusName`, `project`/`projectId`→`projectIdentifier`, `issue`/`issueId`/`id`→`identifier`, `component`→`componentLabel`, `milestone`→`milestoneLabel`.
+- **`get_issue` is shorter:** empty fields (no milestone, 0 comments, …) are left out and the fields share one line.
+- **Smaller tool list:** the `workspace` parameter no longer repeats its description in every tool (the server instructions explain it once). Default set 38.7k → 35.2k characters, all toolsets 88.8k → 80.3k.
+- **New `HULY_TRANSACTOR_URL`:** a server running next to Huly (same Docker network) can reach the transactor internally, e.g. `ws://huly/_transactor`, instead of the public address — no detour through the uplink or a tunnel.
+- **Claude Code plugin: new skill `huly-efficient`** — which Huly call answers which question with the least output (sizes measured on a real project), which writes need only one call, and which checks the tools already do. The `huly-workflow` skill points to it.
+- **Claude Code plugin:** `/huly:standup` and `/huly:triage` (and the MCP prompts) now use the one-call tools `standup` and `triage_inbox`; new commands `/huly:day` (`my_day`) and `/huly:report` (`project_report`); new settings for a pinned workspace (`HULY_WORKSPACE`) and on-demand toolsets (`HULY_DYNAMIC_TOOLSETS`). The skill points to the overview tools and to `create_issue` with component/milestone.
+- **Fixed: Huly client log lines on stdout.** `Client: onConnect 1` landed in the JSON-RPC stream; mcp-proxy logged "Failed to parse JSONRPC message". Such logs now go to stderr.
+- **Fixed: session tokens in logs.** Huly's client logs its websocket URL including the workspace token (`client websocket error: … /_transactor/<token>`), which ended up in `docker compose logs`. Tokens in log output are now masked as `***`.
+- **Fixed: `create_issue_tree` (and `issues_from_document`) left reused issues outside the epic.** A same-title issue that is reused now moves under the epic when it has no parent; one under another parent stays there, and the plan and result say so.
+- **Fixed: blob requests without a timeout.** Reading document/description content and uploads could hang a tool call when the front service stalled. Reads now stop after 30 s, uploads after 2 min, with a clear error naming `HULY_FRONT_URL`.
+- `create_issue_tree` passes component, milestone and assignee straight to `create_issue`, so a wrong name fails before the issue exists (before: the issue was created, then the update failed).
+- Unknown-parameter error of tools without own parameters (e.g. `list_issue_statuses`) said "Valid: ."; it now says the tool takes no parameters besides `workspace`.
+- README: context-cost table re-measured (the pinned saving is now ~10%, not 20%, since the `workspace` description was already shortened).
+- CI: CodeQL Action v4; runs on `main` are no longer cancelled by the next push.
+
+### 3.1.1 — 2026-11-04
+
+- **Fixed: Docker image behind a reverse proxy.** The `mcp-proxy` update in 3.1.0 made the server reject every Host name except `localhost` (`421 Invalid Host header`). New variable `MCP_ALLOWED_HOSTS` (comma-separated) lists the host names clients use, e.g. `MCP_ALLOWED_HOSTS=huly-mcp.example.com`. Without it the container logs a warning. CI now tests allowed and rejected Host headers.
+- Release workflow: when `npm publish` fails, the OIDC/auth lines of npm's debug log are shown (3.1.0 had to be published to npm by hand).
+
+### 3.1.0 — 2026-11-04
+
+First 3.x release on npm. 3.0.0 was only released on GitHub; everything from it is included here.
+
+**One call instead of several**
+- **New: `my_day`** (toolset `agent`, on by default) — "what's on today?" in one call: calendar, to-dos, my issues, reviews, unread inbox.
+- **New: `standup`, `triage_inbox`, `release_notes`** — one call each instead of several: yesterday/today/blockers, the inbox with what changed since last read, and release notes from a milestone.
+- **New: `project_report`** (toolset `agent`) — weekly report of a project: done, new, in progress, blocked, overdue, PRs, milestones, time logged.
+
+**More of Huly**
+- **New: test management, much more of it** — `import_test_results` and the CLI `huly-mcp junit` bring CI results (JUnit XML) into Huly as test runs; `get_test_report` shows failing, flaky, blocked and never-run cases over the latest runs; `create_issue_from_test_result` turns a failed test into a bug (steps and failure included, related to the test case); `create_test_cases` creates many cases at once; suites can be renamed, moved and deleted, runs renamed, dated and deleted, plans deleted, results assigned.
+- **New: `start_process` / `cancel_execution`** — run a process on a card and cancel a running one. Starting works like Huly's "Run process" menu; Huly's process service then moves the execution on. Processes whose start asks for input in the app are refused, and so is a second run where the process forbids parallel runs. Cancelling asks first.
+- `get_issue` names related non-issue documents (e.g. a test case) instead of showing a bare id.
+
+**Changed behaviour**
+- **Changed: `list_issues` lists open issues by default.** Pass `status: "all"` for every issue, or a status name. Long lists show `51–100 of 118` and page with `offset`. In a mature project this cuts the answer by ~80%.
+- **Changed: `list_comments` returns the newest comments** (before: the oldest), still in chronological order. Comments over 1,500 characters are shortened with a visible marker; `full: true` shows them whole. Issue descriptions are never shortened, because `update_issue` replaces them.
+- **Changed: Docker tags.** `latest` now means the latest *release* (before: the latest commit on `main`), and `main` builds are tagged `edge`. There are new tags `3` and `3.1` for release lines, and images are built for `linux/arm64` as well, with an SBOM and provenance.
+- `list_labels`: dead code for the ignored `projectIdentifier` removed. No behaviour change.
+
+**Fewer tokens**
+- **Fewer tokens:**
+  - With `HULY_WORKSPACE` set, tools take no `workspace` argument (−20% tool-list size). Changes still go to exactly that workspace.
+  - Validation limits (`minLength`, `maximum` …) are no longer sent in tool schemas. They are still enforced, with a clear error.
+  - `list_issues` uses one line per issue and leaves out "No priority".
+  - `list_notifications` shows notification ids only with `ids: true`. Marking read by object (`PROJ-12`) does not need them.
+- **New: load toolsets on demand** (`HULY_DYNAMIC_TOOLSETS=1`, opt-in): start small and let Claude load toolsets with `enable_toolsets`. With `agent,inbox` a session starts at ≈1.8k tokens. Not yet verified in Claude Desktop.
+- Server instructions are 41 % shorter (1,463 → 858 chars). They now point to the one-call overviews (`my_day`, `standup`, `triage_inbox` …); hints that the tool descriptions already carry were dropped.
+- Read tools describe `workspace` more briefly (the rule for omitting it is in the server instructions), which keeps the default set within its context budget.
+
+**Security**
+- **Security fixes from code scanning:**
+  - Docker image: `mcp-proxy` 0.14.0 with `mcp` 1.30.0 (fixes 5 CVEs); npm is removed from the runtime image (23 alerts in npm's bundled packages); Debian security updates are applied at build time.
+  - `uuid` is pinned to 11.1.1 via an npm override (a CVE in 8.3.2, pulled in by Huly's server client).
+  - Code: entity decoding in `triage_inbox` no longer double-unescapes (`&amp;lt;` stays `&lt;`); JUnit comment removal is repeated until nothing is left; a check-then-read race in `huly-mcp-setup` is gone.
+
+**CI and releases**
+- **CI and automation:**
+  - every PR is checked on three platforms, with a token report, a personal-data check, a Docker scan and CodeQL
+  - releases publish themselves from a tag
+  - a nightly live test runs against a sandbox workspace
+  - weekly checks cover new Huly packages and Huly modules without tools
+  - see [Development and CI](#development-and-ci)
+
+### 3.0.0 — 2026-11-04
+
+One large release instead of several small ones, built in stages (see [#11](https://github.com/JoKeks2023/huly-mcp/issues/11)).
+
+Breaking:
+- Tools are grouped into toolsets.
+- `calendar`, `github`, `generic-write` and `tracker-admin` are not enabled by default.
+- `HULY_TOOLSETS=all` enables everything.
+
+**Toolsets and the core modules**
+- **New: toolsets** (`HULY_TOOLSETS`) and slimmer tool schemas. The 64 tools of 2.2.0 now cost about 36 % fewer tokens.
+- **New: inbox** — `list_notifications`, `mark_notifications_read`
+- **New: activity** — `get_activity`
+- **New: planner** — `list_todos`, `create_todo`, `update_todo`, `delete_todo`, `schedule_todo`
+- **New: calendar** — `list_events`, `create_event`, `update_event`, `delete_event`
+- **New: chat** — `list_thread`, `reply_to_message`, `update_message`, `delete_message`, `add_reaction`, `remove_reaction`, `pin_message`. `list_messages` now shows authors and message ids.
+- **New: GitHub** — `list_pull_requests`, `get_pull_request`
+- **New: persons** — `list_persons`, `get_person`, `create_person`, `update_person`, `add_contact_channel`, `remove_contact_channel`
+- **New: generic access** — `list_classes`, `describe_class` and `query_documents` (secrets redacted). `generic_create`, `generic_update` and `generic_delete` are opt-in and run as a dry run by default.
+
+**Agent workflow**
+- **New: agent workflow** (toolset `agent`, on by default) — `get_issue_context`, `start_work`, `finish_work`, `create_issue_tree`, `changes_since`, `claim_issue`, `release_issue`, `find_project_for_repo`
+- **New: MCP resources** (`huly://…/issue/…`, `huly://…/document/…`)
+- **New: MCP prompts** (`start`, `finish`, `plan`, `triage`, `standup`)
+- **New: guard rails** — `HULY_WRITE_PROJECTS` limits changes to the listed projects, and `HULY_AUDIT_LOG` records every change.
+- **Changed: toolset `tracker-admin`.** These tools are no longer in the default set: `create_project`, `update_project`, `create_issue_status`, `update_label`, `delete_label`, `delete_milestone`, `delete_component`, `repair_parent_links`. Enable them with `HULY_TOOLSETS=…,tracker-admin` or `all`.
+
+**Claude Code plugin**
+- **New: Claude Code plugin** (`/plugin marketplace add JoKeks2023/huly-mcp`, `/plugin install huly@huly-mcp`). It bundles:
+  - the MCP server with its settings
+  - the `huly-workflow` skill
+  - session-start and PR hooks
+  - the commands `/huly:start`, `/huly:finish`, `/huly:plan`, `/huly:triage`, `/huly:standup`
+
+**More of Huly**
+- **New: fulltext search across everything** — `search` (issues, documents, messages, cards, files, persons …)
+- **New: toolset `collaboration`** — followers of issues/documents, public guest links, document comments
+- **New: toolset `cards`** — card types and tags, cards with content, nesting and field values
+- **New: toolset `fields`** — custom fields on issues, project types, card types or any class, and their values
+- **New: toolset `drive`** — drives, folders, versioned files (upload, download, move, restore)
+- **New: toolset `templates`** — issue templates; new issue with sub-issues from a template
+- **New: toolset `testing`** — test projects, suites, cases, plans, runs and results
+- **New: toolset `products`** — products and versions (read-only)
+- **New: label categories** (`tracker-admin`)
+- **New: documents** — `list_documents` shows the whole tree; `update_document` renames and moves (also to another teamspace); new documents are placed after their siblings
+- **New: MCP argument completions** for prompts and `huly://` resources (workspaces, projects, issue ids) and **resource subscriptions** (`notifications/resources/updated` when a subscribed issue or document changes)
+
+**Business modules**
+- **New: toolsets `members`, `recruiting`, `crm`, `hr`, `inventory`** — invitations and roles, vacancies/candidates/applications, leads/customers, departments and time off, inventory
+- **New: message templates** (`templates`) and **project types with workflows** (`tracker-admin`)
+- **New, read-only: `meetings`** (minutes, transcripts), **`qms`** (controlled documents, trainings), **`process`**, **`surveys`**
+- Not included: Huly's Board module (hidden and off by default in Huly itself).
+
+**Agents**
+- **New: confirmation for risky tools** — deletes, bulk updates, moves, generic writes, revoking links and restoring file versions ask the user via MCP elicitation when the client supports it (`HULY_CONFIRM`). Declining changes nothing.
+- **New: `huly-mcp watch`** — Huly hands work to an agent: issues with a label or assigned to the agent's own account are claimed, passed to `claude -p` (or any command) and released afterwards. Runs are unattended, so they default to `HULY_CONFIRM=strict`.
+
+**Fixes**
+- `create_teamspace`, `create_channel`, `start_direct_message` and `create_project` stored the user's social id as member/owner; Huly 0.7 expects the account id. Spaces created with earlier versions may list you twice as member and have no proper owner.
+- Public links created on servers whose `FRONT_URL` is `localhost` are shown with `HULY_FRONT_URL` instead.
+- Empty or unresolved `HULY_*` variables (for example plugin settings left blank) now count as not set.
+- Nested tool errors no longer repeat the "Huly MCP:" prefix.
+
+### 2.2.0 — planning, bulk edits, fixes for Huly 0.7
+
+- **New: filters in `list_issues`** — milestone, component, label, assignee, parent (null = without / top-level)
+- **New: `bulk_update_issues`, `move_issue`, `list_sub_issues`, `list_time_reports`**
+- **New: `update_project`, `update_comment`, `update_label`, `delete_label`, `remove_relation`, `remove_blocked_by`**
+- **New: `repair_parent_links`** — re-links sub-issues created by earlier versions (dry run by default)
+- **More detail in `get_issue`** — assignee, milestone, component, labels, parent, blocked by, related
+- **`list_members`** shows names
+- **Fix: `set_parent`** now links like Huly itself (`attachedTo`). Before, sub-issues did not appear under their parent in Huly. Existing links: `repair_parent_links` or `set_parent` again
+- **Fix: people lookup on Huly 0.7** — `log_time` failed ("Could not identify current user"), assigning by name (`assignee`, `lead`) never matched and comment authors showed as "Unknown". People are now resolved via the Employee mixin; names are shown as "First Last" and ambiguous names are rejected
+- **Fix: bold/italic text** in issue, document and organization descriptions no longer breaks into separate lines
+- **Fix: `update_issue`** accepts `componentLabel: null` (as documented) and rejects invalid due dates
+
 ### 2.1.0 — milestones & components, security updates
 
 - **New: `get_milestone`, `update_milestone`, `delete_milestone`** — progress overview, edit name/date/status/description, delete with issues unassigned or moved via `moveIssuesTo`