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/account-onboarding.md

View on GitHub
# Account onboarding

Account onboarding lets a platform administrator create a password user and share a one-time invite URL. The invitee sets a password on a public page, sees `Account ready`, and then signs in. A signed-in password user can also rotate their own password from the sidebar identity menu.

## Sub-features

- `onboard-create-user` creates a password user from `Add user`, then shows `Password invite ready` with a `Generated URL`.
- `onboard-invite-accept` sets a password at `/admin/invite/<token>` and moves the invitation to `consumed`.
- `onboard-invite-invalid` shows `Invitation <state>` when the token is invalid, consumed, revoked, or expired.
- `onboard-account-ready` confirms onboarding and links `Open control plane` to `/admin`.
- `onboard-change-password` lets a signed-in password user rotate their password at `/admin/change-password`.

## How to get to it (user POV)

- Choose `Users` → `Add user`. For an invited or disabled user, use `Manage` → `Auth & onboarding` → `Reset onboarding`.
- Open the shared `/admin/invite/<token>` URL while signed out. On success it lands at `/admin/account-ready?mode=password&email=<email>`.
- Open the sidebar identity menu and choose `Change password`.

## Driving it with control-oceans-admin

Preconditions:

- `control-oceans-admin doctor` passes, and you are signed in as `admin@local`.
- Use the email `onboard-<run-id>@verify.local`. Generate a password of at least 8 characters that includes the run ID, and keep it in memory only.

- **Create.** Choose `Users` → `Add user`. Fill `Name` and `Email`, keep `Auth method` as Password and `Team` as `No team`, then choose `Create user`. The toast reads `Password invite created`, and the `generated-url` field holds `/admin/invite/<token>`.
- **Second view.** The new user's row shows Status `invited`, and `/api/v1/admin/identity/users` agrees.
- **Invite state.** In a new browser context, fetch `/api/v1/auth/invitations/<token>`. The state is `valid`.
- **Accept.** In the same context, open the URL. The heading reads `Finish your account setup` and `Invitation is valid` is shown. Fill `Password` and `Confirm password`, then choose `Set password`. The toast reads `Password set`.
- **Ready.** The URL is `/admin/account-ready?mode=password&email=...` and the heading reads `Account ready`. Choose `Open control plane`; the sign-in page appears.
- **API parity.** Fetch the invitation again. Its state is `consumed`, and reopening the URL shows `Invitation consumed`. The user's Status reads `active`.
- **Sign in.** Sign in as the new user. The browser lands on `/admin/profile`.
- **Invalid token.** Open `/admin/invite/not-a-token`. The page shows `Invitation invalid` and no `Set password` button.
- **Change password.** In a new browser context, sign in as `ben@platform.local` with `localdemo123`. Choose `Change password`, fill `Current password`, `New password`, and `Confirm new password`, then choose `Update password`. The page reloads to `/admin/profile`, and the next sign-in with the new password succeeds.
- **Cleanup.** Change Ben's password back to `localdemo123`. As admin, open the created user's `Manage` → `Auth & onboarding` and choose `Deactivate`. The toast reads `User deactivated` and Status reads `disabled`.
- **Proof.** Capture the invite result with the URL masked, the accept form, `Account ready`, the `consumed` state, and the deactivated row. Redact tokens and passwords.

## Gotchas

- Never rotate the `admin@local` password. Bootstrap does not reset it on a reused `gateway.db`.
- The invite token is a credential. Redact the `Generated URL` from screenshots and logs.
- `Set password` does not sign the user in. There is no user delete, so `Deactivate` is the cleanup.
- `Change password` always shows `Rotation required` and prefills `Current password` with `admin`. Clear the field before filling it.
- `mode=oidc` and `mode=oauth` need SSO providers, and `gateway.yaml` does not configure any.
- `Update password` fires `Password updated` and then does a full-page navigation, so the toast is rarely visible. Assert the navigation away from `/admin/change-password` and a sign-in with the new password instead.
- If a change-password run fails midway, restore Ben with `POST /api/v1/auth/password/change` before the next proof; other recipes sign in with `localdemo123`.
- Forced rotation (`require_password_change: true`) is covered in password-sign-in.
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