stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
fe35801cc5080142fa4b437ceca23d7c7bda2666
git.stella-ops.org/docs/features/checked/web/a-b-deploy-diff-panel.md

3.5 KiB
Raw Blame History

A/B Deploy Diff Panel

Module

Web

Status

VERIFIED

Description

Deploy diff UI provides deterministic A/B SBOM comparison with policy-hit context, loading/error states, and inline release action controls.

As of 2026-03-09 the panel is no longer wired to the dead /api/v1/sbom/diff route. The canonical comparison source is SbomService lineage compare, and the surrounding Releases workspace now degrades to an actionable No Comparison Selected state instead of a hard route failure when no digests are present.

Implementation Details

  • Feature directory: src/Web/StellaOps.Web/src/app/features/deploy-diff/
  • Route module: src/Web/StellaOps.Web/src/app/features/deploy-diff/deploy-diff.routes.ts
  • Core files:
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/pages/deploy-diff.page.ts
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.ts
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/services/deploy-diff.service.ts
  • Canonical backend dependency:
    • GET /api/v1/lineage/compare?a=<fromDigest>&b=<toDigest>&tenant=<tenantId>
  • Focused tests:
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/services/deploy-diff.service.spec.ts
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.spec.ts
    • src/Web/StellaOps.Web/src/app/features/deploy-diff/pages/deploy-diff.page.spec.ts

Follow-up Notes

  • Primary Releases shell mounts the canonical workspace at /releases/investigation/deploy-diff.
  • Direct shell navigation without digests is a supported workspace state, not an error path.

Verification

  • Date: 2026-02-10
  • Run artifacts: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-001/
  • Tier results:
    • tier0-source-check.json: pass
    • tier1-build-check.json: pass
    • tier2-e2e-check.json: pass

Recheck (run-003)

  • Date (UTC): 2026-02-10
  • Status: VERIFIED (replayed)
  • Tier 1 evidence: Angular build passed and checked-web suite passed 145/145.
  • Tier 2 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-003/tier2-e2e-check.json.

Recheck (run-004)

  • Date (UTC): 2026-02-10
  • Status: VERIFIED (replayed)
  • Tier 1 evidence: Angular build passed and checked-web suite passed 145/145 across 47 files.
  • Tier 2 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-004/tier2-e2e-check.json.

Recheck (run-006)

  • Date (UTC): 2026-02-11T07:13:55Z
  • Status: VERIFIED (strict Tier 2 UI replay)
  • Tier 1 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-006/tier1-build-check.json
  • Tier 2 evidence: docs/qa/feature-checks/runs/web/a-b-deploy-diff-panel/run-006/tier2-ui-check.json
  • Notes: Playwright now covers positive deploy-diff rendering plus missing-parameter and API-error user paths; route is mounted in the primary shell map.

Recheck (2026-03-09)

  • Status: VERIFIED (lineage compare contract repair)
  • Tier 1 evidence:
    • npx ng test --watch=false --ts-config tsconfig.spec.features.json --include=src/app/features/deploy-diff/services/deploy-diff.service.spec.ts --include=src/app/features/deploy-diff/components/deploy-diff-panel/deploy-diff-panel.component.spec.ts --include=src/app/features/deploy-diff/pages/deploy-diff.page.spec.ts
  • Tier 2 target:
    • live https://stella-ops.local/releases/investigation/deploy-diff
  • Notes:
    • direct route loads an actionable workspace when digests are missing
    • loaded comparisons are normalized from lineage compare into the deploy-diff UI model