Skip to content

ahstn/oceans-llm / .agents/skills/verify-oceans-admin

verify-oceans-admin

Verified

Verify the Oceans LLM admin control plane and backend gateway against the real local stack, seeded demo data, and bounded live providers when required. Use for user-path checks of sign-in, models, API keys, observability, usage costs, spend controls, batches, agent sessions, request logs, Anthropic Messages thinking and effort compatibility, MCP registry and tool access, OpenRouter routing, guardrails, and Skills storage.

FileKindSize
SKILL.mdskill md29.0 KB
examples/mcp-candidates.jsonconfig3.0 KB
features/README.mdmarkdown10.0 KB
features/account-onboarding.mdmarkdown4.3 KB
features/agent-harnesses.mdmarkdown4.3 KB
features/agent-plugins.mdmarkdown1005 B
features/agent-sessions.mdmarkdown3.9 KB
features/anthropic-messages.mdmarkdown20.7 KB
features/api-keys.mdmarkdown6.5 KB
features/attribution.mdmarkdown13.9 KB
features/audit-log.mdmarkdown4.9 KB
features/backend-gateway.mdmarkdown5.2 KB
features/batch-requests.mdmarkdown4.2 KB
features/design-system.mdmarkdown4.6 KB
features/guardrails.mdmarkdown7.0 KB
features/harness-integration.mdmarkdown7.8 KB
features/identity.mdmarkdown4.2 KB
features/image-generation.mdmarkdown7.3 KB
features/leaderboard.mdmarkdown3.3 KB
features/live-llm-requests.mdmarkdown12.6 KB
features/mcp-client-oauth.mdmarkdown9.9 KB
features/mcp-ownership.mdmarkdown7.4 KB
features/mcp.mdmarkdown19.6 KB
features/models.mdmarkdown8.2 KB
features/password-sign-in.mdmarkdown8.3 KB
features/profile.mdmarkdown2.5 KB
features/rate-limits.mdmarkdown6.0 KB
features/request-logs.mdmarkdown8.6 KB
features/review-agent.mdmarkdown3.7 KB
features/routing.jsonconfig33.6 KB
features/service-tiers.mdmarkdown6.3 KB
features/skills.mdmarkdown9.8 KB
features/spend-controls.mdmarkdown7.3 KB
features/usage-costs.mdmarkdown3.7 KB
features/workspace-connections.mdmarkdown6.1 KB
scripts/check-messages.mjsexecutablescript2.4 KB
scripts/check-messages.test.mjsscript3.0 KB
scripts/control-oceans-adminexecutablescript25.3 KB
scripts/control-oceans-admin.test.mjsscript7.6 KB
scripts/drive-backend-gateway.mjsexecutablescript12.5 KB
scripts/drive-harness-integration.mjsscript6.6 KB
scripts/drive-mcp.mjsscript13.0 KB
scripts/drive-models.mjsscript12.9 KB
scripts/drive-observability.mjsscript16.8 KB
scripts/drive-profile.mjsscript8.2 KB
scripts/drive-service-tiers.mjsexecutablescript20.1 KB
scripts/drive-skills.mjsscript27.2 KB
scripts/mcp-browser.mjsscript26.5 KB
scripts/mcp-canary.mjsscript18.8 KB
scripts/mcp-candidates.mjsscript3.5 KB
scripts/mcp-verification.test.mjsscript10.2 KB
scripts/messages-regressions.mjsscript15.8 KB
scripts/plan-verification.mjsscript5.2 KB
scripts/plan-verification.test.mjsscript6.1 KB
scripts/proof-cli.mjsscript11.1 KB
scripts/proof.mjsscript9.2 KB
scripts/proof.test.mjsscript10.4 KB

features/identity.md

View on GitHub
# Identity

Identity lets a platform administrator review and manage users, teams, and service accounts from the `Identity` sidebar group. Other signed-in users get read-only directories of the same records. Service accounts are always read-only and link to their team and API key.

## Sub-features

- `identity-users-list` lists users with `Global role`, `Team`, and `Status`, and opens the `Manage user` sections.
- `identity-user-manage` edits role, team, tags, and lifecycle (`Deactivate`, `Reactivate`, `Reset onboarding`) for non-bootstrap users.
- `identity-teams-list` lists teams with admins, member counts, and an expandable member roster.
- `identity-team-membership` adds teamless users, removes members, and transfers members between teams.
- `identity-service-accounts` lists service accounts with links to their team and API key.
- `identity-read-only` shows directory views with `Only administrators can make changes.` to users who are not platform admins.

## How to get to it (user POV)

- Under `Identity`, choose `Teams`, `Users`, or `Service Accounts`.
- Open `/admin/identity/users?user_id=<id>&user_section=overview|configuration|auth|provider-configuration|usage` directly.
- From Teams, choose an admin link `Open <name>`. From Service Accounts, choose `Open <team> in Teams` or `Open API key <name>`.

## Driving it with control-oceans-admin

Preconditions:

- `control-oceans-admin doctor` passes, and you are signed in as `admin@local`.
- Seeded demo users use the password `localdemo123`. `ben@platform.local` is a member of Platform.

- **Users list.** Choose `Users`. The `Users` heading and the `User list` card show the `Name`, `Email`, `Global role`, `Team`, `Status`, and `Actions` columns.
- **API parity (users).** Fetch `/api/v1/admin/identity/users` and read `data.users`. Every returned email appears once in the list with the same status and team.
- **Manage user.** In the `ben@platform.local` row, choose `Manage`. The URL gains `user_id` and `user_section=overview`, and `Profile` shows `Team` as Platform. Close the sheet.
- **Teams list.** Choose `Teams`. The `Platform`, `Research`, `Applied AI`, and `Operations` rows each show a `Show N members` toggle, and N matches `member_count` from `/api/v1/admin/identity/teams` (`data.teams`).
- **Transfer.** Expand Platform. In Ben's roster row, choose `Transfer`. Set `Destination team` to Research and `Destination role` to Member, then choose `Transfer member`. The toast reads `Member transferred`.
- **Second view.** Reload Users. Ben's `Team` reads Research, and the API agrees.
- **Cleanup.** Expand Research, choose `Transfer` for Ben, and move him back to Platform as a Member. Confirm Team reads Platform in Users and in the API.
- **Service accounts.** Choose `Service Accounts`. `Local CI Runner` shows team Platform and `Open API key Local CI Runner Key`. `Local Eval Worker` shows `No credential attached`. Compare both with `/api/v1/admin/identity/service-accounts`.
- **Read-only role.** In a new browser context, sign in as `ben@platform.local`. `Users` shows `Only administrators can make changes.` and has no `Add user` button. Compare it with `/api/v1/identity/directory/users`.
- **Proof.** Capture both list views, the transfer dialog, the moved and restored team, and the read-only view.

## Gotchas

- `admin@local` is the bootstrap admin, so it cannot be edited, deactivated, or reset. Never change its password.
- You cannot deactivate yourself. There is no user delete and no team delete, so do not create teams during verification.
- Owner memberships have `Transfer` and `Remove` disabled. The seed has no owners.
- `Add members` lists only teamless users. `Reset onboarding` is enabled only for invited or disabled users.
- Tables and mobile cards both render `Manage`, `Edit team`, and `Add members`, so scope each click to the visible row.
- Team admins such as `cara@research.local` also get read-only views, because identity mutations call `require_platform_admin`.
- The expanded roster is one table cell with a flat list of members, not one row per member. Scope `Transfer` and `Remove` through the member's email text, for example its nearest ancestor that contains a `Transfer` button.
- The page heading is `Service accounts`, but the sidebar label is `Service Accounts`.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall