HoneyDrunk.Operator
0.3.0
dotnet add package HoneyDrunk.Operator --version 0.3.0
NuGet\Install-Package HoneyDrunk.Operator -Version 0.3.0
<PackageReference Include="HoneyDrunk.Operator" Version="0.3.0" />
<PackageVersion Include="HoneyDrunk.Operator" Version="0.3.0" />
<PackageReference Include="HoneyDrunk.Operator" />
paket add HoneyDrunk.Operator --version 0.3.0
#r "nuget: HoneyDrunk.Operator, 0.3.0"
#:package HoneyDrunk.Operator@0.3.0
#addin nuget:?package=HoneyDrunk.Operator&version=0.3.0
#tool nuget:?package=HoneyDrunk.Operator&version=0.3.0
HoneyDrunk.Operator
Runtime composition for the HoneyDrunk.Operator human-policy enforcement substrate (ADR-0018).
services
.AddHoneyDrunkOperator(options =>
{
options.ConfigKeyPrefix = "HoneyDrunk:Operator";
})
.AddSafetyRule<MyCustomSafetyRule>();
What it registers
| Contract | Default implementation |
|---|---|
IApprovalGate |
DefaultApprovalGate (event-out + in-process pending state) |
ICircuitBreaker |
DefaultCircuitBreaker (Closed → Open → HalfOpen state machine) |
ICostGuard |
DefaultCostGuard (in-process accumulator, config-sourced budgets) |
IDecisionPolicy |
AuthBackedDecisionPolicy (config-sourced outcomes) |
ISafetyFilter |
DefaultSafetyFilter (composable ISafetyRule chain) |
Plus OperatorTelemetry (Kernel ITelemetryActivityFactory), OperatorAuditWriter (Audit
IAuditLog), and ApprovalEventEmitter (IApprovalEventSink event-out).
Scoped pending approvals
Resolve IApprovalDesk as usual and test for ISubjectScopedApprovalDesk from
HoneyDrunk.Operator.Abstractions.Approvals to request a PendingApprovalQuery. DefaultApprovalDesk
requires its store to implement ISubjectScopedOperatorStore for that read. The built-in in-memory store
and Operator.Data do; custom stores without it fail explicitly. This is a read capability, not an approval
or authorization decision. The existing unscoped list and decision methods are unchanged.
Host responsibilities
- Vault — register an
IConfigProviderso cost-rate tables, breaker thresholds, decision policies, and safety-filter config resolve from Azure App Configuration (ADR-0018 D6 / invariant 117). - Kernel — register an
ITelemetryActivityFactory(ADR-0018 D7). - Audit — register an
IAuditLogfromHoneyDrunk.Auditto capture decisions (ADR-0030 / ADR-0031). When absent, audit emission is a no-op (graceful degradation). Entries for changes wait in the store's outbox until delivered; run the host as anIHostsoOperatorAuditDeliveryServiceretries any that failed. - Approval transport — register an
IApprovalEventSinkto deliver approval-needed events; the default is a no-op sink. The wire shape is deferred per ADR-0018 D8.
Standards notes
- Per invariants 1/2, the runtime references peer Nodes' contract surfaces, never their runtime
composition:
HoneyDrunk.Kernel.AbstractionsandHoneyDrunk.Audit.Abstractions. Vault does not yet publish a standalone.Abstractionspackage, soIConfigProvider(namespaceHoneyDrunk.Vault.Abstractions) is consumed from theHoneyDrunk.Vaultpackage — the contract type only; no Vault runtime services are composed here. - v0.1.0 deferrals: the
AuthBackedDecisionPolicy→ HoneyDrunk.Auth delegation (ADR-0018 D5) and durable persistence of cost/approval state (HoneyDrunk.Data, ADR-0018 D12) were deferred from v0.1.0. Since 0.2.0, state lives behindIOperatorStore: in memory by default, or durable withHoneyDrunk.Operator.Data. The Auth delegation is still markedTODO(auth).
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- HoneyDrunk.Audit.Abstractions (>= 0.2.2)
- HoneyDrunk.Kernel.Abstractions (>= 0.8.2)
- HoneyDrunk.Operator.Abstractions (>= 0.3.0)
- HoneyDrunk.Vault (>= 0.8.2)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on HoneyDrunk.Operator:
| Package | Downloads |
|---|---|
|
HoneyDrunk.Operator.Data
Durable storage for HoneyDrunk.Operator over HoneyDrunk.Data's Entity Framework layer: approvals and decisions, manual pauses, and budget spend survive restarts. |
GitHub repositories
This package is not used by any popular GitHub repositories.