Skip to content

docs(user-guide): document the invoker role - #382

Open
s5unanow wants to merge 1 commit into
codemie-ai:mainfrom
s5unanow:docs/EPMCDME-10371-invoker-role
Open

docs(user-guide): document the invoker role#382
s5unanow wants to merge 1 commit into
codemie-ai:mainfrom
s5unanow:docs/EPMCDME-10371-invoker-role

Conversation

@s5unanow

@s5unanow s5unanow commented Sep 2, 2026

Copy link
Copy Markdown

Summary

Documents the new Invoker role (EPMCDME-10371): a run-only, least-privileged user who can chat with shared assistants, run shared workflows, clone Marketplace assistants, and manage personal integrations, but cannot view or change any AI configuration. Covers what the role can and cannot do, how the reduced interface looks, how the role is assigned in Users Management, and how it compares with the other platform roles.

Changes

  • Added docs/user-guide/project-user-management/invoker-role.md — full Invoker reference (permissions, restrictions, reduced UI, Marketplace clone flow, personal integrations, assignment rules, audit trail, role comparison) and registered it in sidebars.ts
  • Updated docs/admin/security/roles-rbac.md — Invoker added to the role list, capability table, hierarchy diagram, plus an assignment/exclusivity/prerequisite section
  • Updated docs/user-guide/project-user-management/users.md — "Assign the Invoker Role" steps under User Details and the new Auditor/Invoker values in the Platform Role filter
  • Updated docs/user-guide/project-user-management/index.mdx (Invoker column in "Access by Role", FeatureCard) and docs/user-guide/getting-started/glossary.md (Invoker entry)
  • Added two FAQ entries: faq/what-can-an-invoker-do-in-codemie.md, faq/how-do-i-assign-the-invoker-role-to-a-user.md

Testing

  • Tested locally with npm run build (full production build; npm start was not used)
  • All pages render correctly (verified in the built output)
  • Images display properly (no new images in this PR)
  • Internal links work (build runs with onBrokenLinks: 'throw')
  • Sidebar navigation works (new entry under Project & User Management)

Quality Checks

  • npm run check passes (typecheck + lint + commitlint)
  • No MDX compilation errors
  • No raw angle brackets (<text> must be `<text>`)
  • Sidebar references document IDs (not filenames)
  • Images stored locally next to content (not in static/img/)
  • Commit messages follow Conventional Commits
  • No secrets or credentials in documentation

Additional Notes

  • Content is derived from the shipped behaviour of the backend (codemie MR !4072) and UI (codemie-ui MR !1773) implementations of EPMCDME-10371; it should be merged together with, or after, those changes reach a release.
  • Text-only for now: the Users Management UI (enterprise edition) was not available in the local stack, so no new screenshots are included.
  • The roles overview still does not describe the Auditor role; that is a separate gap and is intentionally left out of this PR.

Add a dedicated Invoker Role page under Project & User Management, extend the roles
overview, Users Management, section index and glossary, and add two FAQ entries.
Covers permissions, restrictions, the reduced interface, Marketplace cloning, personal
integrations, assignment rules and audit trail for EPMCDME-10371.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FmU5HQdgfkGEbrdFyiRWms
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants