Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
33 changes: 16 additions & 17 deletions apps/aevatar-console-web/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,25 +119,23 @@ pnpm --dir apps/aevatar-console-web build
`routeDraftWorkflowId` or `draftWorkflowId` for draft hints, and
`publishedServiceId` for service identities. An unresolved value must be
named as a candidate until its source establishes the concrete identity.
- Canonical Team routes express `scope -> team -> member` ownership:
`/scopes/:scopeId/teams`, `/scopes/:scopeId/teams/:teamId`, and
`/scopes/:scopeId/teams/:teamId/members/:memberId/...`.
- `/scopes` is only the authenticated technical entry for resolving a scope; it
is not the Team collection URL.
- Canonical member workflow editors are
`/scopes/:scopeId/teams/:teamId/members/:memberId/workflow` and
`/scopes/:scopeId/teams/:teamId/members/new/workflow`. The `workflow` path
segment names the member implementation editor surface, not a workflow
resource identity. A `workflowId` query value is only a draft hint and cannot
replace the path's member identity.
- Do not add or preserve hidden `/teams/:scopeId...` compatibility routes.
Parse paths by resource name, not by fragile segment indexes.
- Canonical console resources are `/scopes/:scopeId/workflows`,
`/scopes/:scopeId/activity`, `/scopes/:scopeId/channels`, and
`/scopes/:scopeId/settings`, with their resource-owned child routes.
- `/workflows` resolves the authenticated account's scope. `/`, `/overview`,
and `/scopes` use this home; `/scopes` is not a Team collection URL.
- Legacy Team/member and other console pages are retired under
`docs/superpowers/specs/2026-09-16-console-route-consolidation.md`. Do not
restore hidden legacy routes or the `workflow-activity-vnext` URL segment.
Backend Team/member identity boundaries above still apply.

## Workflow Activity vNext Baseline

- Before changing any route, page, component, hook, query, adapter, model,
style, locale, or test for
`/scopes/:scopeId/workflow-activity-vnext`, read all three of these sources
`/scopes/:scopeId/{workflows,activity,channels,settings}`, first read
`docs/superpowers/specs/2026-09-16-console-route-consolidation.md`, then read
all three of these sources
completely:
`docs/design-baselines/workflow-activity-vnext/README.md` and
`docs/superpowers/specs/2026-08-04-workflow-activity-vnext-design.md` and
Expand Down Expand Up @@ -181,9 +179,10 @@ pnpm --dir apps/aevatar-console-web build
from `apps/aevatar-console-web/` before and after changing the baseline. The
verifier must confirm the declared hash, deterministic generator output, and
exact 17-frame inventory.
- Keep this feature frontend-only and isolated to its new route namespace.
Do not change backend code or alter existing Workflow, Run, Settings, Studio,
Team, member, redirect, or menu behavior to implement it.
- Keep this feature frontend-only. The 2026-09-16 route consolidation decision
replaces the original namespace isolation and legacy-page preservation
rules; the current experience owns the production console routes and shell.
Do not infer backend resource removal from frontend page retirement.

## UI and Interaction

Expand Down
24 changes: 13 additions & 11 deletions apps/aevatar-console-web/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Aevatar Console Web

`aevatar-console-web` is the Ant Design Pro based admin shell for Aevatar.
`aevatar-console-web` is the Aevatar console for Workflows, Activity, Channels,
and Settings, using the existing Workflow Activity design system.

## Stack

Expand Down Expand Up @@ -104,15 +105,16 @@ Current proxy split during local development:
- `/api/chat`, `/api/workflows/*`, `/api/actors/*`, `/api/runs/*`, `/api/primitives`, `/api/capabilities`, most `/api/scopes/*` runtime routes -> `Mainnet Host API`
- `/api/app/*`, `/api/auth/*`, `/api/workspace/*`, `/api/editor/*`, `/api/executions/*`, `/api/roles/*`, `/api/connectors/*`, `/api/scopes/{scopeId}/teams*` -> `Studio Hosting API target`

## Current scope
## Current Routes

- `Overview`
- `Studio`
- `Primitives`
- `Runs`
- `Actors`
- `Workflows`
- `Observability`
- `Settings`
`/workflows` resolves the signed-in account's scope. The console uses
`/scopes/:scopeId/workflows`, `/scopes/:scopeId/activity`,
`/scopes/:scopeId/channels`, and `/scopes/:scopeId/settings`, including their
resource detail and editing routes. `/`, `/overview`, and `/scopes` open this
home. Login and callback remain at `/login` and `/auth/callback`.

If Studio shows `Failed to load Studio workflow` with an RFC 9110 `404 Not Found` payload, check that `AEVATAR_API_TARGET` points to `Aevatar.Mainnet.Host.Api` rather than `Aevatar.Workflow.Host.Api`; scope workflow detail requests are served by mainnet.
The old Teams, Members, Studio, and other legacy console pages are removed.
Retired business URLs, including the former `workflow-activity-vnext` prefix,
render the not-found page. Backend resources and identity contracts are
unchanged. See the [route consolidation specification](docs/superpowers/specs/2026-09-16-console-route-consolidation.md)
for the complete route inventory and the shared-component migration.
Loading
Loading