mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-28 20:21:50 +01:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - Human company members receive permission grants from their role preset. > - Human invitations use the Operator role by default. > - The old Operator preset only granted task assignment, so ordinary members could not edit agents or manage connections. > - This pull request gives Operators company editing and audit access while keeping join approval and member-permission management separate. > - Members can configure their agents and accounts without an Owner role. ## Linked Issues or Issue Description **What existing behavior does this improve?** The default permission grants for human Operators and the invitation role description. **Subsystem affected** server/ permission presets and invitation authorization, plus ui/ invitation and tool access gates. **Current behavior** Operators receive only `tasks:assign` as an explicit default grant. Agent configuration and managed account setup fail their permission checks. **Proposed behavior** Operators receive agent creation/configuration, skills, environments, invitations, task assignment, pipelines, connections, tool management/use, and audit grants. The preset excludes `joins:approve` and `users:manage_permissions`. Operators can invite Operators and Viewers. Inviting a role with either excluded power requires that power, so invitations cannot bypass the restriction. **Reason and benefit** Ordinary company members can edit company work and connect accounts through the existing routes. **Breaking changes** The Operator preset grants more permissions. The existing startup and Cloud sign-in seeding paths can insert these missing grants for existing Operators. They retain custom grant scopes. Explicit invitation grants still take precedence. Inviting Admins now requires join approval; inviting Owners also requires member-permission management. This PR adds no migration or new backfill path. Related: #5945 describes missing role grants in another membership entry point. This PR changes the preset and does not change that endpoint. ## What Changed - Expanded the Operator preset to 14 company editing, invitation, tool, and audit grants. - Kept join approval and member-permission management out of the preset. - Required those powers when an invitation's selected human role includes them, preventing Operators from delegating the excluded powers through Owner/Admin invitations. - Updated the invitation role copy and the product specifications. - Allowed active Operators (including legacy Member roles) through the invite shortcut and advanced tool/profile UI gates. Kept inactive memberships, Viewers, and other companies excluded; API grants remain authoritative. - Added tests for the default Operator grants, both excluded actions, agent editing, company boundaries, and invitation role authorization. - Simplified adapter-route test imports so authorization errors and the error handler use one module graph; retained the upstream mock-initialization fix. - Kept Owner/Admin/Viewer presets and explicit invitation grants unchanged. Added no EE code or database migration. ## Verification - Permission and invitation tests: 38 passed across access service, invitation defaults, and invitation creation routes. - UI access tests: 61 passed across invitation shortcuts, Operator tool/profile access, and invitation UI. - Adapter route tests: 15 passed after resolving the upstream test setup conflict. - `pnpm -r typecheck`, `pnpm build`, and `pnpm check:token-gates`: passed on the final branch. - The initial local `pnpm test:run` general-server batch reported three tool-access failures and eight upload-helper timeouts. Both complete affected suites passed in isolation on the final branch: 403 tests. The initial full local run was not green. - Both complete tool-access and adapter route suites also passed on an untouched snapshot of base `88ff98b83`: 387 tests. The earlier tool failures did not reproduce there. - [All CI gates passed](https://github.com/paperclipai/paperclip/actions/runs/37527422346) for `068be153b9c2a064f2aaccc0627fdf458e73747e`, including the previously failing serialized adapter lane, general tests, E2E, typecheck, build, Runner checks, and canary dry run. - Greptile scored that exact commit 5/5. Superagent passed. Both invitation review threads are resolved. ## Risks - Operators gain broad company editing and invitation access by design. - Existing default seeding can add the new missing grants during startup or Cloud sign-in. It does not replace existing scopes. - Company boundaries and the two excluded permission checks still apply. - An Admin without member-permission management can no longer invite an Owner. Operators retain invitation access for Operator/Viewer roles and agent-only invites. - This PR changes company permissions. Cloud workspace invitation rules remain separate. ## Model Used OpenAI Codex, GPT-6. The exact deployment model ID and context window were not exposed in this session. Used repository inspection, code editing, shell execution, and test tools. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting a merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
60 lines
2.5 KiB
TypeScript
60 lines
2.5 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
import type { CurrentBoardAccess } from "@/api/access";
|
|
import { canInviteCompanyMembers } from "./useCompanyInviteAccess";
|
|
|
|
function snapshot(overrides: Partial<CurrentBoardAccess> = {}): CurrentBoardAccess {
|
|
return {
|
|
user: { id: "user-1", email: "jane@example.com", name: "Jane Example", image: null },
|
|
userId: "user-1",
|
|
isInstanceAdmin: false,
|
|
companyIds: ["company-1"],
|
|
memberships: [{ companyId: "company-1", membershipRole: "operator", status: "active" }],
|
|
source: "session",
|
|
keyId: null,
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
describe("canInviteCompanyMembers", () => {
|
|
it("is false until the board access snapshot is known", () => {
|
|
expect(canInviteCompanyMembers("company-1", undefined)).toBe(false);
|
|
});
|
|
|
|
it("always passes local boards and instance admins", () => {
|
|
expect(canInviteCompanyMembers("company-1", snapshot({ source: "local_implicit" }))).toBe(true);
|
|
expect(canInviteCompanyMembers("company-1", snapshot({ isInstanceAdmin: true }))).toBe(true);
|
|
// Both bypass the company lookup, so a missing company is fine.
|
|
expect(canInviteCompanyMembers(null, snapshot({ isInstanceAdmin: true }))).toBe(true);
|
|
});
|
|
|
|
it.each(["owner", "admin", "operator", "member"] as const)("passes an active company %s", (membershipRole) => {
|
|
const access = snapshot({
|
|
memberships: [{ companyId: "company-1", membershipRole, status: "active" }],
|
|
});
|
|
expect(canInviteCompanyMembers("company-1", access)).toBe(true);
|
|
});
|
|
|
|
it.each(["viewer", null] as const)("rejects a company %s", (membershipRole) => {
|
|
const access = snapshot({
|
|
memberships: [{ companyId: "company-1", membershipRole, status: "active" }],
|
|
});
|
|
expect(canInviteCompanyMembers("company-1", access)).toBe(false);
|
|
});
|
|
|
|
it("ignores inactive memberships and other companies", () => {
|
|
const suspended = snapshot({
|
|
memberships: [{ companyId: "company-1", membershipRole: "owner", status: "suspended" }],
|
|
});
|
|
expect(canInviteCompanyMembers("company-1", suspended)).toBe(false);
|
|
const elsewhere = snapshot({
|
|
memberships: [{ companyId: "company-2", membershipRole: "owner", status: "active" }],
|
|
});
|
|
expect(canInviteCompanyMembers("company-1", elsewhere)).toBe(false);
|
|
expect(canInviteCompanyMembers(null, elsewhere)).toBe(false);
|
|
});
|
|
|
|
it("is false when the snapshot carries no memberships", () => {
|
|
expect(canInviteCompanyMembers("company-1", snapshot({ memberships: undefined }))).toBe(false);
|
|
});
|
|
});
|