Files
git.stella-ops.org/docs/features/unchecked/web/pack-registry-browser.md

3.3 KiB

Pack Registry Browser

Module

Web

Status

IMPLEMENTED

Description

TaskRunner pack discovery and management with install/upgrade flows, compatibility checking, version history with changelogs, signature verification, and dependency graph. API client and models exist but dedicated feature module not found.

What's Implemented

  • Existing components:
    • conflict-visualizer (src/Web/StellaOps.Web/src/app/features/policy-studio/ai/conflict-visualizer.component.ts)
    • live-rule-preview (src/Web/StellaOps.Web/src/app/features/policy-studio/ai/live-rule-preview.component.ts)
    • test-case-panel (src/Web/StellaOps.Web/src/app/features/policy-studio/ai/test-case-panel.component.ts)
    • version-history (src/Web/StellaOps.Web/src/app/features/policy-studio/ai/version-history.component.ts)
    • policy-approvals (src/Web/StellaOps.Web/src/app/features/policy-studio/approvals/policy-approvals.component.ts)
    • policy-dashboard (src/Web/StellaOps.Web/src/app/features/policy-studio/dashboard/policy-dashboard.component.ts)
    • policy-editor (src/Web/StellaOps.Web/src/app/features/policy-studio/editor/policy-editor.component.ts)
    • policy-explain (src/Web/StellaOps.Web/src/app/features/policy-studio/explain/policy-explain.component.ts)
    • policy-nl-input (src/Web/StellaOps.Web/src/app/features/policy-studio/nl-input/policy-nl-input.component.ts)
    • policy-rule-builder (src/Web/StellaOps.Web/src/app/features/policy-studio/rule-builder/policy-rule-builder.component.ts)
  • Existing services:
    • monaco-loader (src/Web/StellaOps.Web/src/app/features/policy-studio/editor/monaco-loader.service.ts)
    • policy-api (src/Web/StellaOps.Web/src/app/features/policy-studio/services/policy-api.service.ts)

What's Missing

  • Pack browser feature module: No dedicated Angular feature module for browsing the TaskRunner pack registry (installed packs, available packs, version history)
  • Pack install/upgrade flow: No UI flow for installing or upgrading TaskRunner packs with compatibility checks
  • Pack signature verification display: No UI showing DSSE signature verification status for each pack
  • Pack dependency graph: No visual dependency graph for pack dependencies
  • Pack changelog viewer: No version history with changelog rendering per pack

Implementation Plan

  • Create pack-registry Angular feature module under src/Web/StellaOps.Web/src/app/features/
  • Implement pack list view with install/upgrade actions
  • Add signature verification status badge per pack
  • Add version history/changelog component
  • Wire to TaskRunner pack management API endpoints

E2E Test Plan

  • Setup:
    • Log in with a user that has appropriate permissions
    • Navigate to /policy-studio/packs
    • Ensure test data exists (scanned artifacts, SBOM data, or seed data as needed)
  • Core verification:
    • Verify the component renders correctly with sample data
    • Verify interactive elements respond to user input
    • Verify data is fetched and displayed from the correct API endpoints
  • Edge cases:
    • Verify graceful handling when backend API is unavailable (error state)
    • Verify responsive layout at different viewport sizes
    • Verify accessibility (keyboard navigation, screen reader labels, ARIA attributes)