Rewrite UI API clients from /api/v2/releases to /api/v1/release-orchestrator
Completes Sprint 323 TASK-001 using Option C (direct URL rewrite): - release-management.client.ts: readBaseUrl and legacyBaseUrl now use /api/v1/release-orchestrator/releases, eliminating the v2 proxy dependency - All 15+ component files updated: activity, approvals, runs, versions, bundle-organizer, sidebar queries, topology pages - Spec files updated to match new URL patterns - Added /releases/activity and /releases/versions backend route aliases in ReleaseEndpoints.cs with ListActivity and ListVersions handlers - Fixed orphaned audit-log-dashboard.component import → audit-log-table - Both Angular build and JobEngine build pass clean Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -968,7 +968,7 @@ Completion criteria:
|
||||
- [x] Build passes, visually verified on Dashboard and VEX pages
|
||||
|
||||
### T0b - Stella Helper Deep Context (Tab, Alert, State Awareness)
|
||||
Status: TODO
|
||||
Status: DOING
|
||||
Dependency: T0a
|
||||
Owners: Frontend Developer
|
||||
|
||||
@@ -1076,29 +1076,29 @@ Agent Fleet (2 tabs):
|
||||
5. Priority: context-triggered tips > tab-specific tips > page-level tips
|
||||
|
||||
Completion criteria:
|
||||
- [ ] 60+ tab-level route configs added to tips config
|
||||
- [ ] `StellaHelperContextService` created with context signal injection
|
||||
- [ ] Alert-driven tips for 10+ common platform states (SBOM missing, gate blocked, feed stale, etc.)
|
||||
- [ ] Priority system: alert tips surface above generic tips
|
||||
- [ ] Tab components push context on activation
|
||||
- [ ] Every tabbed page has per-tab tips (not just page-level)
|
||||
- [ ] Total tip count reaches 250+
|
||||
- [x] 60+ tab-level route configs added to tips config (78 page/tab configs implemented)
|
||||
- [x] `StellaHelperContextService` created with context signal injection (25+ well-known context keys)
|
||||
- [x] Alert-driven tips for 10+ common platform states (SBOM missing, gate blocked, feed stale, etc.)
|
||||
- [x] Priority system: alert tips surface above generic tips (context-triggered tips prepended in effectiveTips)
|
||||
- [x] Tab/components push context on activation (dashboard, integrations, approvals, deployments, supply-chain data, unknowns, policy audit, hosts, targets, agent fleet, environment detail)
|
||||
- [x] Every tabbed page has per-tab tips (not just page-level)
|
||||
- [ ] Total tip count reaches 250+ (currently ~100 tips across 78 configs)
|
||||
|
||||
### T1 - First-Time Setup Wizard Component
|
||||
Status: TODO
|
||||
Status: DONE
|
||||
Dependency: none
|
||||
Owners: Frontend Developer
|
||||
|
||||
Create a step-by-step setup wizard component that guides new users through initial platform configuration. Should be dismissable, remember completion state per user, and be re-accessible from Settings.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] Wizard component with 6 steps (diagnostics, registry, scan, triage, release, policy)
|
||||
- [ ] Each step links to the actual page/action
|
||||
- [ ] Progress persisted in user preferences
|
||||
- [ ] Accessible from Dashboard "Getting Started" card and Settings
|
||||
- [x] Wizard component with 6 steps (diagnostics, registry, scan, triage, release, policy)
|
||||
- [x] Each step links to the actual page/action
|
||||
- [x] Progress persisted in user preferences (via SetupWizardStateService)
|
||||
- [x] Accessible from Dashboard "Getting Started" card and Settings
|
||||
|
||||
### T2 - Dashboard Welcome Banner & Contextual Hints
|
||||
Status: TODO
|
||||
Status: DOING
|
||||
Dependency: none
|
||||
Owners: Frontend Developer
|
||||
|
||||
@@ -1111,19 +1111,19 @@ Completion criteria:
|
||||
- [ ] Severity guide (Critical/High/Medium/Low) shown on first visit
|
||||
|
||||
### T3 - Empty State Overhaul (All Pages)
|
||||
Status: TODO
|
||||
Status: DOING
|
||||
Dependency: none
|
||||
Owners: Frontend Developer
|
||||
|
||||
Replace all generic/broken empty states with educational content following the design system pattern: icon + explanation + action + learn more.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] Fix "event_busy" text bug on Deployments page
|
||||
- [ ] Readiness: fix grammar + add helpful empty state
|
||||
- [ ] Supply-Chain Data: add SBOM explanation + scan CTA
|
||||
- [ ] Agent Fleet: add agent explanation + deploy CTA
|
||||
- [ ] Unknowns: add explanation + zero-state positive message
|
||||
- [ ] Policy Audit: add event type guide
|
||||
- [x] Fix "event_busy" text bug on Deployments page
|
||||
- [x] Readiness: fix grammar + add helpful empty state
|
||||
- [x] Supply-Chain Data: add SBOM explanation + scan CTA
|
||||
- [x] Agent Fleet: add agent explanation + deploy CTA
|
||||
- [x] Unknowns: add explanation + zero-state positive message
|
||||
- [x] Policy Audit: add event type guide
|
||||
- [ ] All empty tables show contextual help, not just "no data"
|
||||
|
||||
### T4 - Domain Glossary Tooltip System
|
||||
@@ -1178,16 +1178,16 @@ Completion criteria:
|
||||
- [ ] Findings Explorer: baseline explanation and guided first action
|
||||
|
||||
### T8 - Integrations Setup Order Enhancement
|
||||
Status: TODO
|
||||
Status: DONE
|
||||
Dependency: none
|
||||
Owners: Frontend Developer
|
||||
|
||||
Enhance the existing "Suggested Setup Order" on the Integrations page with richer descriptions, icons, and direct links to each setup action.
|
||||
|
||||
Completion criteria:
|
||||
- [ ] Each setup step has icon, description, and "why" explanation
|
||||
- [ ] Each step links directly to the relevant setup page
|
||||
- [ ] Completion state shown (✅ Done / ⚪ Not started)
|
||||
- [x] Each setup step has icon, description, and "why" explanation
|
||||
- [x] Each step links directly to the relevant setup page
|
||||
- [x] Completion state shown (Done / Not started)
|
||||
|
||||
### T9 - Sidebar & Menu Context
|
||||
Status: TODO
|
||||
@@ -1220,7 +1220,14 @@ Completion criteria:
|
||||
| Date (UTC) | Update | Owner |
|
||||
| --- | --- | --- |
|
||||
| 2026-03-29 | Sprint created. Full UI audit completed across 34 screens with screenshots. Comprehensive findings documented with specific recommendations per screen. | Planning |
|
||||
| 2026-03-29 | T0 DONE: Stella Helper (Clippy) implemented and integrated. 35 page configs, 100+ tips, animated mascot with speech bubble. Build passes, visually verified on Dashboard and VEX pages. | Developer |
|
||||
| 2026-03-29 | T0a DONE: Stella Helper (Clippy) implemented and integrated. 35 page configs, 100+ tips, animated mascot with speech bubble. Build passes, visually verified on Dashboard and VEX pages. | Developer |
|
||||
| 2026-03-31 | Audit: T0b infrastructure implemented (StellaHelperContextService with 25+ context keys, StellaPreferencesService, StellaAssistantService with 500+ lines). 78 page/tab configs. Component-side context push still pending. | PM (audit) |
|
||||
| 2026-03-31 | Audit: T1 DONE — setup-wizard.component.ts (700+ lines) with welcome screen, horizontal progress, accordion steps, dry-run toggle, error handling, carousel. SetupWizardStateService + SetupWizardApiService. | PM (audit) |
|
||||
| 2026-03-31 | Audit: Bonus — stella-tour.component.ts (460+ lines) fully implemented. Guided walkthrough engine with backdrop overlay, step highlighting, glow animation, auto-positioning. Not in original task list. | PM (audit) |
|
||||
| 2026-03-31 | Audit: User preferences page extended with Stella Assistant section (show mascot, show tooltips, muted pages, reset first-visit tips). | PM (audit) |
|
||||
| 2026-03-31 | T8 DONE: Integrations setup order upgraded to guided step cards with icons, plain-English "why this matters" copy, direct CTAs, and live Done/Not started status derived from connector counts. `docs/UI_GUIDE.md` updated to match. Focused `ng test` runs were attempted with default and feature-only tsconfigs, but both are blocked by unrelated compile failures in `admin-notifications`, `policy-simulation`, and other stale specs already present in the tree. | Developer |
|
||||
| 2026-03-31 | T0b advanced: helper context scopes now support page-owned state, new context-triggered helper tips were added, and live context wiring landed on Dashboard, Integrations, Approvals, Hosts, Targets, Agent Fleet, and Environment Detail tabs. T3 advanced in parallel: approvals, environment detail, and agent-fleet zero states now explain what is missing and link to next actions instead of showing generic "no data" copy. | Developer |
|
||||
| 2026-03-31 | T0b extended again: deployments, supply-chain data, unknowns, and policy audit now publish scoped helper state, including new `no-sbom-components` and `no-audit-events` contexts. T3 advanced further: Deployments now render the intended `event_busy` pipeline icon, and the releases/security/policy zero states now explain what data should appear there and how to populate it. `npx tsc --noEmit -p tsconfig.app.json` passes. | Developer |
|
||||
|
||||
## Decisions & Risks
|
||||
- **Decision**: All educational content should be written for a developer audience (not security experts). Use analogies and practical examples.
|
||||
@@ -1228,9 +1235,13 @@ Completion criteria:
|
||||
- **Decision**: First-visit detection should use user preferences API, not local storage, so it works across devices.
|
||||
- **Decision**: Stella Helper (Clippy) is the PRIMARY onboarding vehicle. All other tasks (empty states, glossary, status bar, etc.) are complementary — they make each page self-documenting, while the helper provides proactive guidance.
|
||||
- **Decision**: Deep contextual tips (T0b) should use a service + signal pattern so any component can push context to the helper. This avoids tight coupling while allowing rich state-awareness.
|
||||
- **Decision**: T8 now tracks the current Integrations hub implementation in `src/Web/StellaOps.Web/src/app/features/integration-hub/integration-hub.component.ts`, not the older audit screenshots. Operator-facing behavior is documented in `docs/UI_GUIDE.md`.
|
||||
- **Decision**: Page-owned helper scopes now replace ad-hoc global pushes for onboarding state. Components publish a scoped context set and clear it on destroy so helper tips stay route-correct even when tabs and query params change within the same shell.
|
||||
- **Risk**: Content volume is large (30+ pages, 80+ tabs, 250+ tips). Mitigate by: writing all content in the tips config first (data layer), then implementing features in phases.
|
||||
- **Risk**: Glossary tooltip system (T4) needs careful UX — too many tooltips = visual noise. Only annotate first occurrence per page.
|
||||
- **Risk**: Helper context service (T0b) could create performance overhead if too many components push signals. Use debounce and single-signal-per-page pattern.
|
||||
- **Risk**: Focused frontend verification is currently blocked by unrelated compile failures in other feature suites. The new T8 spec is in place, but `ng test` cannot complete until those pre-existing errors are repaired.
|
||||
- **Risk**: T3 is still partial. Deployments, supply-chain data, unknowns, policy audit, readiness, and agent-fleet empty states are now reconciled, but remaining generic tables and lower-traffic audit surfaces still need follow-up before the sprint can close.
|
||||
|
||||
## Task Interconnection Map
|
||||
|
||||
@@ -1257,17 +1268,18 @@ All 12 tasks work together. The Stella Helper (T0a+T0b) is the PROACTIVE guide (
|
||||
|
||||
### Phase 0 — DONE
|
||||
- [x] T0a: Stella Helper Core (mascot, 100+ tips, page awareness)
|
||||
- [x] T1: First-time setup wizard (6-step guided setup) — moved up from Phase 2
|
||||
- [x] Bonus: Tour Engine (guided walkthrough with backdrop, highlighting, glow) — unplanned
|
||||
|
||||
### Phase 1 — Highest Impact (next)
|
||||
- [ ] T0b: Deep contextual tips (tabs, alerts, state-driven tips, 250+ total)
|
||||
- [ ] T3: Empty state overhaul (fix bugs like "event_busy", add educational empty states)
|
||||
### Phase 1 — In Progress
|
||||
- [~] T0b: Deep contextual tips — scoped page wiring landed on key onboarding surfaces; tip count still below 250+
|
||||
- [~] T3: Empty state overhaul — releases/security/topology coverage improved, wider page coverage still pending
|
||||
- [ ] T2: Dashboard welcome banner + inline metric hints
|
||||
|
||||
### Phase 2 — Structure
|
||||
- [ ] T7: VEX & Reachability inline education (the hardest concepts need dedicated panels)
|
||||
- [ ] T1: First-time setup wizard (6-step guided setup)
|
||||
- [ ] T5: Page-level help panels (collapsible "About this page" on all 30 pages)
|
||||
- [ ] T8: Integrations setup order enhancement
|
||||
- [x] T8: Integrations setup order enhancement
|
||||
|
||||
### Phase 3 — Polish & System
|
||||
- [ ] T4: Domain glossary tooltip system (25+ terms, auto-annotate first occurrence)
|
||||
|
||||
Reference in New Issue
Block a user