Penghou.Hufu 0.1.0-preview.11

This is a prerelease version of Penghou.Hufu.
dotnet add package Penghou.Hufu --version 0.1.0-preview.11
                    
NuGet\Install-Package Penghou.Hufu -Version 0.1.0-preview.11
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Penghou.Hufu" Version="0.1.0-preview.11" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Penghou.Hufu" Version="0.1.0-preview.11" />
                    
Directory.Packages.props
<PackageReference Include="Penghou.Hufu" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Penghou.Hufu --version 0.1.0-preview.11
                    
#r "nuget: Penghou.Hufu, 0.1.0-preview.11"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Penghou.Hufu@0.1.0-preview.11
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Penghou.Hufu&version=0.1.0-preview.11&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Penghou.Hufu&version=0.1.0-preview.11&prerelease
                    
Install as a Cake Tool

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • 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