Files
scadaproj/ZB.MOM.WW.Secrets/docs/ui-consistency-validation.md
T
2026-11-13 18:57:36 -05:00

96 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Secrets UI consistency validation
## Release preparation
UI-only project version 1.0.0; required Abstractions 0.6.6; exact shared Theme 1.0.1. Shared
`Directory.Build.props` and Core/backend source versions remain 0.6.6 without a backend release.
The exact package pair is published and official-feed delivery verified after independent
clean-source artifact/dependency review; no Core/backend release or application deployment occurred.
## Source acceptance
- Target/draft/pending operation isolation: `f07bd3c`,34 baseline → 50 UI tests.
- Field labels/error associations, accessible confirmation lifecycle and committed/read recovery:
`510d15d`, 69 tests and actual keyboard/focus proofs in per-page/global host modes.
- Name-only metadata filtering, native secondary details, contextual actions, keyed rows and
generation-bound audited reveal: `46556db`, 81 tests; 93 final rendered checks across both actual
integration modes, 1440/390px/native200% browser zoom; zero page errors.
- The exact Theme 1.0.1 nupkg hash is
`995b117b0245577598c91404ed7957c071ebe3413696c8be48b419c9deb1bd5d`.
Selected UI text contrasts measured 5.144:1–16.877:1. CSS/fonts and source DOM module bytes were
checked in both hosts. Runtime evidence is under
`components/ui-theme/validation/secrets-ui` from the monorepo root; see its SEC01,
SEC02-04 and SEC05-06 reports and retained TRX/browser artifacts.
## Preserved security and state contracts
Metadata listing/filtering never reads values. Each public handler checks its own policy.
Reveal requires a successful audit before plaintext enters current rendered state; status,
labels, URLs, interop arguments and audit payloads exclude values. Hide, row removal, navigation,
target changes and disposal clear disclosure. There is no timer-based auto-hide policy.
Mutation audit failure after commit does not turn a successful write into failure or skip captured
cache eviction. Retry after list failure reads only; it never repeats a committed credential change.
## Dependency compatibility gate
Before publication, exercise actual published Core 0.6.2/0.6.3 and matching supported SQL-Server/Akka
replicator binaries with Abstractions 0.6.6, rather than recompiling the old implementation from
current source. Include an old-compiled key provider to prove the added default interface method,
real envelope encryption/rewrap/tamper checks, disposable SQLite persistence/tombstones and offline
replication contract/message paths. Record exact graphs/audits and all actual package hashes.
Live SQL/cluster deployment is outside this local binary smoke proof.
The new 450-character normalized name limit is a behavior boundary, not a schema migration.
Compatibility proof is bounded to valid names. Existing longer names/tombstones require a host
inventory decision before adopting Abstractions 0.6.6. The default snapshot implementation copies
the legacy key/id API; a rotating provider must supply an atomic snapshot if it needs that guarantee.
## Artifact and host gate
Freeze a clean committed library source revision and pass it explicitly as both SourceRevisionId
and RepositoryCommit when packing. Pack exactly UI 1.0.0 and Abstractions 0.6.6; inspect their nuspec
IDs/versions/floors and hash them. Keep unpublished candidates out of shared NuGet caches; isolated
restores must verify package bytes/source rather than assembly version alone. A stale unpublished
Theme 1.0.1 candidate was caught during source validation and replaced by exact official bytes.
Use isolated local candidate feeds plus mapped official feeds for a fresh restore, then run both
packaged synthetic hosts: the exact OtOpcUa per-page wrapper with its Bootstrap and the global
interactive host with ScadaBridge Bootstrap. Verify one route, live controls, DOM assets, role
boundaries, fail-closed reveal, committed outcomes and keyboard/focus behavior. Check version
collisions again immediately before any exact package publication. Publication requires final
artifact/dependency review; there is no wildcard push step.
## Rollout and rollback
Hosts adopt UI 1.0.0, Abstractions 0.6.6 and Theme 1.0.1 together through reviewed pins; keep their
current Core/store/replicator version unless separately upgrading it. Preserve the previous host
and immutable package artifacts. Roll back UI/assets together without replaying mutations,
removing tombstones or changing keys/storage formats. Preserve target isolation when feasible.
No application deployment or production-secret operation is part of this validation.
## Accepted exact artifact and delivery evidence
Frozen input `bd257c68274cd9a9d2e718c89f5e728ec7926bd2` was packed from a canonical clean
archive with explicit SourceRevisionId/RepositoryCommit. Actual nuspecs contain the required
Abstractions0.6.6 and Theme1.0.1 floors. Exact candidate hashes:
- UI1.0.0: `346c32acb0166c2704465fa7b9cec31c8f58af2d2a37296e03c0021fe50d7815`.
- Abstractions0.6.6: `5cb0386469638bda89eb6c9afa25ead397b86730c3c5e43e4e496269d316acdc`.
Actual published Core/SQL/Akka0.6.2 and0.6.3 binaries each passed33 compatibility checks with
new contracts, including an unchanged provider compiled against published contracts0.6.2,
actual encryption/rewrap/tamper handling, ephemeral SQLite and local replication paths.
Both graph vulnerability audits found no findings on the explicitly recorded patched public
package line. Standalone UI-only restore inferred Abstractions0.6.6 without a masking direct pin.
Two packaged integration hosts passed44 browser/asset checks, including exact7 asset bytes per
host, role boundaries, audit-before-disclosure, committed outcomes, field focus and modal cleanup.
The81-test source suite and93-check source responsive/zoom matrix also remain accepted.
Detailed evidence, reproducible commands, actual graph caveats, retained failed diagnostics and
release checklist: `components/ui-theme/validation/secrets-ui/SEC07.md` in the monorepo. These
include accepted official delivery: independent review `6b371be`, exact dependency-first publication,
fresh official GET hash parity, empty official-only UI-only/two-host restores and44/44 rebuilt
packaged browser checks. Reviewed consumer adoption is now allowed within the documented runtime
and450-character validation boundaries. This doc update
is later than package input and does not change the accepted artifact source identity.