Penghou.Hufu
0.1.0-preview.11
dotnet add package Penghou.Hufu --version 0.1.0-preview.11
NuGet\Install-Package Penghou.Hufu -Version 0.1.0-preview.11
<PackageReference Include="Penghou.Hufu" Version="0.1.0-preview.11" />
<PackageVersion Include="Penghou.Hufu" Version="0.1.0-preview.11" />
<PackageReference Include="Penghou.Hufu" />
paket add Penghou.Hufu --version 0.1.0-preview.11
#r "nuget: Penghou.Hufu, 0.1.0-preview.11"
#:package Penghou.Hufu@0.1.0-preview.11
#addin nuget:?package=Penghou.Hufu&version=0.1.0-preview.11&prerelease
#tool nuget:?package=Penghou.Hufu&version=0.1.0-preview.11&prerelease
Penghou.Hufu
Hufu is a reusable authority boundary for software that performs work on someone's behalf. It helps a host answer a specific question before a protected operation: may this authenticated subject perform this action on this resource, right now? It also records the evidence for the decision so a host can explain and recover it later.
An agent, plan, or workflow can request work; its request does not grant permission. The host supplies trusted identity, policy, current authority, approvals, and resource bindings. Hufu evaluates those inputs. The host and its resource or execution providers enforce the result at the point of use.
flowchart LR
A[Agent, plan, or workflow] -->|requests an operation| H[Trusted host]
H -->|authenticated context + current authority| U[Hufu decision]
U -->|decision + evidence| H
H -->|fresh checks at protected boundary| P[Resource or execution provider]
P --> R[File, process, or other resource]
The authority and delegation model explains how live authority, child grants, broker checks and execution policies fit together. One activity can use zero or many executions. Biscuit is an optional future carrier across those boundaries; the first selected proof is a worker calling a host broker. Published Gagamba providers currently supply process lifecycle guarantees; restricted execution remains separately gated.
What this repository provides
- Core authority contracts: bounded requests, grants, current snapshots, decisions, revocation, authenticated issuance, derived-grant lineage, and required decision evidence.
- Optional adapters: Cedar policy evaluation; SQLite current-authority and evidence storage; neutral workflow authorization; resource checks through Penghou.IO; and a governed single-file patch host built with Luban's conditional writer.
- Examples and experiments: a local Windows operator host for one exact file, plus separate plan and native-execution compositions. These show specific integration profiles, not a general-purpose production host.
Hufu does not authenticate a user by itself, schedule workflows, own resource providers, or isolate arbitrary code. Each integrating host must supply and qualify those boundaries. The overview explains how the parts fit together and where checks must occur.
Current status
Nine Hufu packages are published at 0.1.0-preview.8 for .NET 8 and .NET 10: Penghou.Hufu, Penghou.Hufu.Cedar, Penghou.Hufu.Sqlite, Penghou.Hufu.Workflow, Penghou.Hufu.IO, Penghou.Hufu.Luban, Penghou.Hufu.Luban.Sqlite, Penghou.Hufu.Biscuit, and Penghou.Hufu.Biscuit.Sqlite. They are pre-release components with explicit host obligations. The release profile is the source for package contents, compatibility, and publication evidence. Avoid 0.1.0-preview.4, which was an incomplete release.
The single-patch host and local Windows host example demonstrate one governed mutation path. The neutral workflow adapter performs authorization before protected activity code; it does not by itself coordinate a filesystem mutation with revocation. The published Biscuit packages carry an experimental credential adapter whose behavior remains gated by current Hufu authority; the Fuwen/Zhinu/Gagamba execution compositions remain separate experimental, unpublished work. Luban integration remains available for existing consumers, while new Hufu work is language-neutral.
Start here
| If you want to… | Read |
|---|---|
| Understand the goal and trust boundaries | Overview |
| Choose an integration point | Architecture and documentation guide |
| Integrate a workflow engine | Workflow authorizer |
| Govern concrete resource access | Resource adapter and single-patch host |
| Run the bounded operator example | Local host README |
| Check published versions and evidence | Package release profile |
| See planned and unfinished work | Roadmap and authority/enforcement implementation plan |
To explore the source, install the .NET 10 SDK and the .NET 8 runtime (for the .NET 8 test targets) and run from the repository root:
dotnet build Penghou.Hufu.Core.slnx -c Release
dotnet test Penghou.Hufu.Core.slnx -c Release
Penghou.Hufu.Core.slnx contains the core and newer experimental compositions. Penghou.Hufu.slnx includes the published adapters, the local Windows host, and legacy/optional integration tests; see the release profile for their different restore and platform requirements. The local host guide gives a concrete Windows run path.
Licensed under the Apache License 2.0.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages (6)
Showing the top 5 NuGet packages that depend on Penghou.Hufu:
| Package | Downloads |
|---|---|
|
Penghou.Hufu.Sqlite
Optional SQLite current authority and decision evidence for Hufu. |
|
|
Penghou.Hufu.Cedar
Optional CedarSharp policy evaluation for Hufu authority. |
|
|
Penghou.Hufu.Luban
Optional Hufu semantic authorization for independently usable Luban. |
|
|
Penghou.Hufu.Workflow
Product-neutral workflow authorization through Hufu with trusted binding, approval and evidence. |
|
|
Penghou.Hufu.IO
Optional Hufu authority enforcement for neutral Penghou IO providers. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-preview.11 | 108 | 10/15/2026 |
| 0.1.0-preview.10 | 116 | 10/15/2026 |
| 0.1.0-preview.9 | 103 | 10/14/2026 |
| 0.1.0-preview.8 | 111 | 10/13/2026 |
| 0.1.0-preview.7 | 88 | 10/13/2026 |
| 0.1.0-preview.6 | 102 | 10/12/2026 |
| 0.1.0-preview.5 | 114 | 10/7/2026 |
| 0.1.0-preview.4 | 69 | 10/7/2026 |
| 0.1.0-preview.3 | 469 | 10/4/2026 |
| 0.1.0-preview.2 | 103 | 10/4/2026 |
| 0.1.0-preview.1 | 107 | 10/4/2026 |