docs: declare Engine/PIP under security-layer-model v0.7

Assent to ZONE-IN-0001 in this repository's own voice: layer Engine, role
PIP, offline reference remaining the catalogued surface. Align INTENT,
SCOPE, and GOAL with accepted statute v0.7 and companion v0.2. Record the
scope-against-intent review and open ZONE-WP-0003 for the mechanical
remainder. Do not reopen the no-runtime decision.

Assistant: grok
Assistant-Session: 01a04ceb-0745-7ae1-9e26-0d10e5d52b8b
This commit is contained in:
tegwick 2026-08-29 11:57:25 +02:00
parent 1b9a252fa3
commit a34bc194dc
6 changed files with 704 additions and 88 deletions

View file

@ -8,24 +8,56 @@
## One-liner
`zone-engine` is the retained reference-conformance repository for NetKingdom
security-zone membership, admission, owner-provenanced control profiles, and
time-boxed exception semantics. It does **not** run an engine or make policy
decisions.
`zone-engine` is the Engine-layer **PIP** for NetKingdom zone identity and
membership, retained as an offline reference-conformance repository. It does
**not** run a live engine, render a policy decision, or cause a protected side
effect.
## Layer
Declared in `INTENT.md` frontmatter, in this repository's own voice:
| Key | Value |
| --- | --- |
| Layer | Engine |
| Role | PIP |
| Statute | `security-layer-model_v0.7` (accepted 2026-08-29) |
| Companion | `net-kingdom/SECURITY-COMPANION.md` v0.2 |
| Catalogued form | offline reference conformance (2026-08-23 disposition) |
| PEP-shaped | no |
| Tooling contacts | none |
| Conformance | conforming for Tooling contact; the live Engine API is not a missing capability this repository currently owes |
The machine-readable `layer.yaml` form and a conformance check that fails a
new Tooling client or a new decision surface are not yet evidenced here.
Until they are, the declaration is the `INTENT.md` frontmatter and the prose
in that file.
`access-engine` (currently `flex-auth`) is the only PDP. Zone stance and
failure mode remain owner policy and PEP configuration. This repository
projects only explicit versioned owner data and never changes a live effect.
## Lifecycle
`ZONE-WP-0001` delivered and proved the model. `ZONE-WP-0002` hardened the
retained reference boundary. Both are finished with `DoD-Ok`; no runtime is
needed and there is no continuing implementation backlog.
needed.
The repository is retained while `security-zones_v0.1` remains `proposed` in
net-kingdom canon, with zone-engine as maintainer of fixtures and reference
tooling. Retention is not service ownership. A future canon lifecycle change,
an owner-requested conformance revision, or evidence that an adopting control
cannot enforce the contract at its existing point are the only normal change
triggers. Archival remains an attended action once the reference artifacts are
durably handed off or no longer needed.
tooling. Retention is not service ownership. Acceptance of the security layer
model does not reopen the no-runtime decision; it names the retained form as
the Engine/PIP this repository already is.
Normal change triggers remain: a canon lifecycle or content change, an
owner-requested conformance revision, or evidence that an adopting control
cannot enforce the contract at its existing point. The layer declaration and
the PIP claim-mapping work that follow from v0.7 are owner-driven revisions
of that kind. Archival remains an attended action once the reference
artifacts are durably handed off or no longer needed.
A live Engine API, a decision surface, or stance compiled into membership
would be a layer change and is out of present scope.
## Capability actually present
@ -59,6 +91,10 @@ ambiguous join, read a live clock, or publish a consumer registry. Its profile
fixture records owner-approved v0.1 behavior; only the referenced owner policy
and PEP configuration can change a live effect.
The resolver output is a reference membership/admission record. It is not yet
a statute §17 request-claim. Taxonomy owns that schema and has not published
it. This repository must not ship a competing dialect.
## Authority boundary
| Concern | Authority | This repository's role |
@ -67,13 +103,17 @@ and PEP configuration can change a live effect.
| Managed workload tuple and applicability | Repo Manager / owning catalog | Consumes the explicit projection |
| Zone ids and admission standard | zone-engine model, published by net-kingdom | Maintains conformance fixtures and lineage |
| Canon publication and lifecycle | net-kingdom | Detects change; never promotes by inference |
| Control stance | Owner of the control | Projects only explicit versioned owner data |
| Layer model and engine roles | gate-house / net-kingdom canon | Declares Engine/PIP; does not author the statute |
| Request-claim schema | Taxonomy (statute §17, unassigned) | Will consume, not invent |
| Control stance | Owner of the control; effect in `access-engine` policy | Projects only explicit versioned owner data |
| Failure behavior | Owner of the PEP | Records provenance and semantics only |
| Authorization effect | Existing PDP or control owner | Makes no decision |
| Authorization effect | `access-engine` (currently `flex-auth`) | Makes no decision; supplies PIP facts |
| Exception grant and expiry | Designated control authority and enforcement point | Checks reusable fixtures offline |
| Reef placement vs zone floor | Railiance / canon composition (statute §20.3) | Keeps the axes separate; does not compose them |
The invariant remains: **membership is ours; stance is theirs; the decision
point is neither.** `flex-auth` remains the only PDP for decisions it renders.
point is neither.** `access-engine` remains the only PDP for decisions it
renders.
## Deliberately absent
@ -81,12 +121,15 @@ There is no:
- API, daemon, database, controller, scheduler, watch loop, or reload path;
- synchronous lookup in an authorization or enforcement path;
- authorization decision surface, cached verdict, or compiled stance;
- PEP, unreachable-engine stance map, or protected side effect;
- Tooling-layer client (OpenBao, key-cape, or a direct datastore);
- central exception store, grant workflow, clock, or expiry evaluator;
- live policy evaluation or implementation of another repository's control;
- fleet discovery, reference repair, registry publication, or workload
migration;
- network segmentation, reef placement, tenancy, identity, or secrets service;
or
- estate request-claim schema, or authority to publish one; or
- authority to publish canon or select a consumer's stance and failure mode.
Exception expiry remains enforced at decision or enforcement time by each
@ -99,16 +142,24 @@ decision point.
- Checking direct declarations or explicit Repo Manager projections offline.
- Verifying a versioned owner profile is total and fully attributed.
- Testing an owner exception implementation against the lifecycle boundaries.
- Reviewing a net-kingdom canon lifecycle/content change.
- Reviewing a net-kingdom canon lifecycle/content change, including the
security-layer-model.
- Declaring or checking this repository's Engine/PIP conformance.
- Auditing why no zone-engine runtime exists.
## Not relevant when
- Determining the published rule: read net-kingdom canon.
- Asking whether a request is allowed: use `flex-auth` or the owning control.
- Asking whether a request is allowed: use `access-engine` or the owning
control.
- Discovering or repairing managed workloads: use Repo Manager and the owning
catalog.
- Granting, applying, or expiring a live exception: use the control owner's
versioned policy or PEP configuration.
- Placing a workload, routing a network, managing identity/tenancy, or handling
secrets.
- Publishing an unreachable-engine stance, containing a workload, or observing
production: those are PEP, actuation, and `kings-guard`, and the last two
are held at zero by the statute.
- Mapping Railiance `reef-*` onto security zones: statute §20.3 leaves that
composition unwritten; guessing it here is out of scope.