Penghou.IO.Local
0.1.0-preview.1
dotnet add package Penghou.IO.Local --version 0.1.0-preview.1
NuGet\Install-Package Penghou.IO.Local -Version 0.1.0-preview.1
<PackageReference Include="Penghou.IO.Local" Version="0.1.0-preview.1" />
<PackageVersion Include="Penghou.IO.Local" Version="0.1.0-preview.1" />
<PackageReference Include="Penghou.IO.Local" />
paket add Penghou.IO.Local --version 0.1.0-preview.1
#r "nuget: Penghou.IO.Local, 0.1.0-preview.1"
#:package Penghou.IO.Local@0.1.0-preview.1
#addin nuget:?package=Penghou.IO.Local&version=0.1.0-preview.1&prerelease
#tool nuget:?package=Penghou.IO.Local&version=0.1.0-preview.1&prerelease
Penghou I/O
Penghou I/O supplies bounded resource capabilities for AI tool usage, with explicit authorization at each concrete resource boundary. Trusted hosts inject providers and authority implementations; Hufu is an optional integration.
Architecture direction (2026-10-02): replaceable resource capabilities, with the original specification, public-type inventory and corrective roadmap. ADR 0003 records the implemented correction. The delivery plan and handoff distinguish qualification, publication and consumer adoption.
Three .NET 8 and .NET 10 NuGet package candidates share version
0.1.0-preview.1; publication status is recorded in the delivery plan.
Penghou.IO.Abstractionscontains the neutral request, result, provider and authorization contracts. It has no provider or protocol implementation dependency.Penghou.IO.Protocolscontains the versioned request identity codec and the Windows workspace path profile. It depends on the neutral contracts package.Penghou.IO.Localcontains the Windows filesystem provider and depends on both the contracts and protocol packages. It applies host-supplied authorization and mutation-journal checks at the concrete resource boundary.
Build and test both target frameworks, with the native Windows provider qualified on Windows. See the release guide for manual publication from the checked-in version or a matching release tag.
Every operation carries a host-authenticated HostInvocation with subject,
effect, attempt, scope references, and request identity. These records are data
only: contracts do not authenticate host IDs or enforce checks. The host
composition authenticates the operation and its scope; the provider snapshots
inputs and makes the final current-authority
check for each concrete action and resource. There is no ambient-user lookup or
default permit. A WorkspacePath reference describes provenance; it does not
grant permission.
Luban validates its whole pipeline's syntax, types, and execution profile
before I/O. Luban owns semantic typed effects and finite dataflow; Fuwen and
Zhinu own workflow control and durability. Preflight checks all nodes' known
static effects and exact targets, rejecting a known denied write before
upstream reads or artifacts. This advisory check reserves no authority and
does not replace provider access checks. Dynamic targets require bounded,
authorized discovery. An ls list effect, a later gc read effect, and a
write each require their own check. A live denial can follow earlier reads, but
the denied write must not occur. There is no global pipeline atomicity;
intermediates use finite buffered values with byte/work bounds and cancellation; lazy production and backpressure are not guaranteed. Persistence and debug/release artifacts require explicit authorization.
ADR 0002 adds the planned preview resolution and commit barrier: authorized discovery resolves dynamic mutation targets, the complete known mutation set is admitted before writes begin, and every actual I/O still receives live checks. WhatIf leaves opaque tools unexecuted. Luban now implements a separate programmatic capture-only WhatIf profile using this reader; its plans cannot commit and WhatIf never dispatches the separate executor. Luban's single and batch patch executors require explicit host admission, live resource checks and journaled start/completion evidence. Luban materializes the exact text edits; Local conditionally persists frozen bytes. Batch execution is ordered and can leave a completed prefix; it is not an atomic transaction. Production mutation-host composition and terminal-outcome recovery remain separate qualification obligations.
See architecture, provider contract, the roadmap, and decision 0001. The Apache-2.0 license applies.
The implementation plan records the Windows read/list provider and Luban's read migration. See its qualified profile, identity encoding, and the separate Local conditional existing-file write profile. Other mutations and the web backend remain pending.
Build with the .NET 10 SDK:
dotnet test Penghou.IO.slnx -c Release -f net8.0
dotnet test Penghou.IO.slnx -c Release -f net10.0
CI runs these Windows tests, builds the neutral contracts and protocols on Linux, packs all three packages, verifies their identities and contents, and restores a separate package-only consumer from the generated local feed. CI packages use a unique prerelease version and are not published.
| 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
- Penghou.IO.Abstractions (>= 0.1.0-preview.1)
- Penghou.IO.Protocols (>= 0.1.0-preview.1)
-
net8.0
- Penghou.IO.Abstractions (>= 0.1.0-preview.1)
- Penghou.IO.Protocols (>= 0.1.0-preview.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-preview.1 | 551 | 10/3/2026 |