Class NuggetApplicationLifecycle

java.lang.Object
org.j7m.middleware.operations.api.NuggetApplicationLifecycle
public final class NuggetApplicationLifecycle extends Object
UI-neutral application lifecycle contracts for nugget administration.

The records in this type are immutable public DTOs used by the headless nugget administration service, CLI clients, deterministic tests, demos, and future web/API adapters. They carry only safe operational summaries and must not contain PINs, admission identifiers in public summaries, repository host paths, application configuration secrets, classloader details, raw exception text, stack traces, private keys, certificates, credentials, or mutable runtime implementation objects. Provider-origin error metadata is untrusted: nugget admin implementations must project it through a bounded allowlist before constructing NuggetApplicationLifecycle.Result, audit records, human output, or JSON output. Unknown lifecycle failure details are omitted by default. Retained details use explicit public value domains rather than provider free text, and sensitive classification is based on the original provider key and value before any public key normalization, fallback, or truncation. Implementations that expose ordered public error details must preserve the canonical detail order through defensive immutable copies.

Instances are immutable and thread-safe. Implementations that create these DTOs remain responsible for enforcing PIN admission, authorization, read-only and feature gates, application verification, lifecycle state checks, deadlines, redaction, audit, and bounded result construction before returning them.