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/design-system.md

View on GitHub
# Design System

The design system page is a living reference for the admin UI theme and components. It renders every token and installed shadcn component from the live theme, so it changes whenever `globals.css` or `src/components/ui/**` changes. `DESIGN.md` at the repo root is the written source.

## Sub-features

- `design-system-foundations` shows color pairs with a measured contrast ratio (`contrast-ratio` test ID), palette swatches (actions, brand illustration, surfaces, status, chart series and heatmap), the `type-*` scale, radius, spacing, the five-layer elevation ladder, and the motion tokens.
- `design-system-components` shows every component in `src/components/ui/`, with Button variants in a state matrix pinned through `data-preview`.
- `design-system-guidelines` shows the do and don't pairs and the recipes: auth hero panel, budget card, and the example list screen.

## How to get to it (user POV)

- Open `/admin/design-system` directly. It is not in the sidebar.
- Any signed-in user can open it; it is a personal path in `-auth-routing.ts`.

## Driving it with control-oceans-admin

Preconditions: a launched stack with the local demo seed, signed in as `alice@platform.local` / `localdemo123`.

- **Open.** Go to `/admin/design-system`. The heading reads `Design system`, the page starts at the top, and there are no console errors.
- **Sections.** The page has sections with the IDs `foundations`, `actions`, `inputs`, `data-display`, `navigation`, `feedback`, `overlays`, `guidelines`, and `recipes`.
- **Contrast.** There are 12 `contrast-ratio` badges and every one is at least `AA`. `Content panel` reads `16.13 AAA`, `Primary action` reads `8.50 AAA`, `Link text on card` reads `7.59 AAA`, `Destructive on card` reads `6.53 AA`, `Success on card` reads `10.55 AAA`, and the lowest, `Soft text on card`, reads `7.11 AAA`.
- **Data contrast.** The Data on cards block has 10 `graphic-contrast-ratio` badges (five series, Other and heatmap levels 1 to 4), and every one reads `Pass`, meaning at least 3:1 on the card. `Heatmap level 1` reads `3.22 Pass` and `Other series` reads `4.21 Pass`. `mise run //ui:test src/test/design-contrast.test.ts` checks the same pairs from `globals.css`.
- **Motion.** The Motion block lists `--duration-fast`, `--duration-base`, `--duration-slow` and `--duration-chart`, and `Replay` replays the page-entrance card and moves the fill bar.
- **Reduced motion.** With `prefers-reduced-motion: reduce` emulated, the Data display chart shows every bar at its final shape in its first frame and settles within a frame or two, once its legend is measured. Without the preference the bars draw in over about 600ms, across dozens of distinct frames.
- **Shared admin pieces.** The Data display `Table` block renders its header with `AdminTableHeader` (columns `Name` to `Actions`, `Spend (7d)` right-aligned). Under Navigation, `Detail dialog sections` shows `Overview`, `Configuration` and `Credentials`; choosing `Configuration` marks it active and swaps the text. At 375px the same block shows the sections as buttons instead of a sidebar.
- **Overlays.** `Open alert dialog` opens `Revoke ci-pipeline?` on the floating layer with the dialog shadow, and Escape closes it.
- **Responsive.** At 375px the document is no wider than the viewport.
- **Coverage.** `mise run //ui:test src/test/design-system-coverage.test.ts` passes. It fails when the page doesn't render a component in `src/components/ui/` (tests aside), or a part of one that the app renders: an imported name must appear as a JSX element, so a stale or type-only import doesn't count. A part also counts when a part the page renders renders it in turn, when a shared component the page renders (such as `AdminTableHeader`) renders it, or when the admin shell renders it. CI runs it with the other admin UI tests.
- **Proof.** Capture the page, then `control-oceans-admin record design-system --check sections=pass --check contrast=pass --check data-contrast=pass --check reduced-motion=pass --check shared-admin-pieces=pass --check overlays=pass --check responsive=pass --check coverage=pass --artifact <screenshot>`.

## Gotchas

- The chart loads lazily; wait for the first `.recharts-surface` before capturing the Data display section.
- Ratios are measured from computed styles, so they change if a token changes. Update the expected values here when the palette moves.
- Page content fades up over 200ms after each navigation (`animate-page-in`). Wait about 300ms after the heading appears before capturing a screenshot.
- The inline Command is controlled so cmdk doesn't scroll its selected item into view on load. The first item still renders highlighted.
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: 471kUpdated 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