feat(explorer): brand the UI as AgentEnv Explorer and link the framework docs

[polakamtejas]

The explorer UI that agent-env up serves still showed the old Scale branding. This PR replaces it with the AgentEnv Framework brand, links the user docs, and fixes misleading labels and duplicate endpoint names on the Docs page.

Branding

• Sidebar header: the AgentEnv Framework icon and AgentEnv Explorer, with a small "Built by" and the Scale logo underneath. This replaces the "Scale | AgentEnv" wordmark. The collapsed sidebar, which showed nothing here before, now shows the icon.
• Favicons: favicon.svg is assets/brand/icon.svg, which switches colors with prefers-color-scheme. favicon.ico (16/32/48), apple-touch-icon.png (opaque) and the Android icons are rendered from the same SVG. They were the Scale mark.
• The sidebar's public/logos/agentenv-icon.svg is the brand icon fixed to its light colors, since the explorer's theme is pinned light. Only favicon.svg follows the OS color scheme.
• public/logos/scale-logo.svg is the Scale mark and wordmark cut from the old sidebar logo, which is deleted. site.webmanifest and the Docs fallback title say "AgentEnv Explorer".

Docs link

• A "Framework docs" link at the foot of the sidebar (an icon when collapsed) and a line under the Docs page intro both open https://www.agentenvframework.com/docs in a new tab.

Docs page wording

• The stat cards and Docs sidebar sections counted registered primitive types but were labelled "Artifacts", "Environments" and "Task Steps", which reads like a count of stored objects. They now read "Artifact Types", "Environment Types" and "Task Step Types".
• The x-agent-env-docs.counts keys (shown raw in the "OpenAPI Extensions" block) are renamed to artifactTypes, envTypes and taskStepTypes to match. Only that raw block reads them.

API reference names

• FastAPI names an operation after its function when no summary= is set. The five collection routers come from one factory (versioned_router), so "List Items", "Get Item" and "List Versions" each appeared five times in the Docs nav, which shows the name without the path. The factory now takes a noun, and the routes are "List Artifacts", "Get Environment", "List Task Versions" and so on. versioned_router is not part of the plugin surface; check_plugin_api.py reports no break.
• /health was titled " Health", from the function name _health. It is now "Health". The / health alias, served only when no UI is mounted, is left out of the schema so it doesn't add a second "Health".
• New test test_every_operation_has_its_own_summary: every summary is distinct and trimmed. On main it fails (30 operations, 17 distinct summaries).

Testing

• npm run typecheck, npm run test:smoke (11 passed; the 2 skips need trajectory fixtures) and npm run build:static pass.
• pytest tst/unit/explorer: 46 passed.
• Checked in the browser against agent-env up from a fresh clone and venv: expanded and collapsed sidebar, Docs page, favicon.

🤖 Generated with Claude Code

Confidence Score: 5/5

The PR appears safe to merge; the earlier sidebar icon issue is fixed.

What we checked:

• Sidebar icon in dark mode: No. The Explorer stays light, and the icon now keeps dark fills against its white sidebar.

Summary

The PR gives AgentEnv Explorer its own branding, adds links to the Framework docs, clarifies the Docs page’s type counts, and gives API operations distinct names. It updates the sidebar and app icons and makes the API reference easier to scan.

• Shows AgentEnv Explorer branding in the sidebar and browser icons.
• Links users to the Framework docs and labels primitive counts as types.
• Names API operations by entity and gives the health endpoint a clear title.

_{Reviews (3) · Last reviewed commit: "fix(explorer): keep the sidebar icon in ..."}