@astrale-os/kernel-core 0.9.0-beta.62 → 0.9.0-beta.64

package/dist/auth/authority/admission/admission.d.ts

@@ -10,5 +10,5 @@ export declare const limits: {
 };
 export declare const MAX_BOOLEAN_OPERANDS: 512;
 export declare function admitAuthorityExpr(input: portable.Value): AuthorityExpr;
-/** Internal constructor admission: the outer Grant binds subject, but no local escapes into it. */
-export declare function admitGrantBody(input: portable.Value): AuthorityExpr;
+/** Internal constructor admission: the outer identity binder binds subject; no local escapes into it. */
+export declare function admitBinderBody(input: portable.Value): AuthorityExpr;

package/dist/auth/authority/admission/admission.js

@@ -1,7 +1,6 @@
 import { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
 import { isNodeId } from '../../../graph/node/index.js';
 import { AuthValueError } from '../../error.js';
-import { accept as acceptGrant } from '../../grant/index.js';
 import { ownsExpression } from '../ownership.optimization.js';
 export const limits = Object.freeze({
     expressionDepth: 64,
@@ -15,8 +14,8 @@ export const MAX_BOOLEAN_OPERANDS = limits.operandsPerExpression;
 export function admitAuthorityExpr(input) {
     return admit(input, '/predicate', new Set(), false, 0);
 }
-/** Internal constructor admission: the outer Grant binds subject, but no local escapes into it. */
-export function admitGrantBody(input) {
+/** Internal constructor admission: the outer identity binder binds subject; no local escapes into it. */
+export function admitBinderBody(input) {
     return admit(input, '/predicate/where', new Set(), true, 1);
 }
 function admit(input, path, locals, subjectBound, depth) {
@@ -45,11 +44,14 @@ function admit(input, path, locals, subjectBound, depth) {
                 op: 'not',
                 predicate: admit(required(value.predicate, `${path}/predicate`), `${path}/predicate`, locals, subjectBound, depth + 1),
             };
-        case 'grant':
-            exact(value, ['grant', 'op', 'where'], path);
+        case 'as':
+            exact(value, ['identity', 'op', 'where'], path);
+            if (typeof value.identity !== 'string' || !isNodeId(value.identity)) {
+                invalid(`${path}/identity`, 'Expected one canonical IdentityId');
+            }
             return {
-                op: 'grant',
-                grant: acceptGrant(value.grant),
+                op: 'as',
+                identity: value.identity,
                 where: admit(required(value.where, `${path}/where`), `${path}/where`, locals, true, depth + 1),
             };
         case 'same-node':
@@ -155,7 +157,7 @@ function term(input, path, locals, subjectBound) {
         case 'subject':
             exact(value, ['kind'], path);
             if (!subjectBound)
-                invalid(path, 'Grant subject is outside its lexical scope');
+                invalid(path, 'Binder subject is outside its lexical scope');
             return { kind: 'subject' };
         default:
             invalid(`${path}/kind`, 'Unsupported authority term');

package/dist/auth/authority/admission/index.d.ts

@@ -1 +1 @@
-export { admitAuthorityExpr, admitGrantBody, limits } from './admission.js';
+export { admitAuthorityExpr, admitBinderBody, limits } from './admission.js';

package/dist/auth/authority/admission/index.js

@@ -1 +1 @@
-export { admitAuthorityExpr, admitGrantBody, limits } from './admission.js';
+export { admitAuthorityExpr, admitBinderBody, limits } from './admission.js';

package/dist/auth/authority/index.d.ts

@@ -1,8 +1,12 @@
 export { accept } from './accept.js';
 export { isCanonical } from './canonical.js';
 export { ownsCanonical } from './ownership.optimization.js';
-export { prepareGrantBody } from './prepare-grant-body.js';
+export { prepareBinderBody } from './prepare-binder-body.js';
+export { acceptProgram, createAuthorityProgram, isPredicateRef } from './program.js';
+export type { AuthorityProgramBuilder, ClosedAuthorityProgram } from './program.js';
 export { limits } from './admission/index.js';
 export { canonicalize } from './normalization/index.js';
-export { AUTHORITY_PREDICATE_VERSION } from './language/index.js';
-export type { AuthorityExpr, AuthorityPredicate, ClassRef, ClosedEdgeExtent, Input, LocalDeclaration, Operation, Repeat, Requirement, Term, } from './language/index.js';
+export { AUTHORITY_PREDICATE_VERSION, AUTHORITY_PROGRAM_VERSION } from './language/index.js';
+export type { AuthorityExpr, AuthorityPredicate, AuthorityProgram, ClassRef, ClosedEdgeExtent, Input, LocalDeclaration, Operation, PredicateRef, Repeat, Requirement, Term, } from './language/index.js';
+export { AuthorityFailure, allowed, binderRoots, classAuthorityMeaning, closeComposition, createAuthorityEvaluator, fixedPaths, isFixedTerm, requiredInputs, termPath, } from './semantics/index.js';
+export type { AuthorityAtom, AuthorityEvaluationOptions, AuthorityEvaluator, AuthorityFailureCode, AuthorityInputs, AuthorityNode, AuthoritySnapshot, AuthorityVocabulary, CompositionClosure, CompositionLimits, CompositionStatus, FixedTerm, } from './semantics/index.js';

package/dist/auth/authority/index.js

@@ -1,7 +1,9 @@
 export { accept } from './accept.js';
 export { isCanonical } from './canonical.js';
 export { ownsCanonical } from './ownership.optimization.js';
-export { prepareGrantBody } from './prepare-grant-body.js';
+export { prepareBinderBody } from './prepare-binder-body.js';
+export { acceptProgram, createAuthorityProgram, isPredicateRef } from './program.js';
 export { limits } from './admission/index.js';
 export { canonicalize } from './normalization/index.js';
-export { AUTHORITY_PREDICATE_VERSION } from './language/index.js';
+export { AUTHORITY_PREDICATE_VERSION, AUTHORITY_PROGRAM_VERSION } from './language/index.js';
+export { AuthorityFailure, allowed, binderRoots, classAuthorityMeaning, closeComposition, createAuthorityEvaluator, fixedPaths, isFixedTerm, requiredInputs, termPath, } from './semantics/index.js';

package/dist/auth/authority/language/index.d.ts

@@ -1,2 +1,4 @@
 export { AUTHORITY_PREDICATE_VERSION } from './predicate.js';
+export { AUTHORITY_PROGRAM_VERSION } from './program.js';
 export type { AuthorityExpr, AuthorityPredicate, ClassRef, ClosedEdgeExtent, Input, LocalDeclaration, Operation, Repeat, Requirement, Term, } from './predicate.js';
+export type { AuthorityProgram, PredicateRef } from './program.js';

package/dist/auth/authority/language/index.js

@@ -1 +1,2 @@
 export { AUTHORITY_PREDICATE_VERSION } from './predicate.js';
+export { AUTHORITY_PROGRAM_VERSION } from './program.js';

package/dist/auth/authority/language/predicate.d.ts

@@ -1,7 +1,7 @@
 import type { ClassRef, CoreRef, FunctionRef, PolicyRef, ViewRef, Key } from '@astrale-os/kernel-dsl/v1/addressing';
 import type { NodeId } from '../../../graph/node/index.js';
-import type { Grant } from '../../grant/index.js';
-export declare const AUTHORITY_PREDICATE_VERSION: 10;
+import type { IdentityId } from '../../identity/index.js';
+export declare const AUTHORITY_PREDICATE_VERSION: 11;
 /** Concrete Edge Classes selected by Runtime closure, reused at every bounded hop. */
 export type ClosedEdgeExtent = readonly [ClassRef, ...ClassRef[]];
 export type Operation = 'create' | 'read' | 'traverse' | 'update' | 'delete';
@@ -67,9 +67,14 @@ export type AuthorityExpr = {
 } | {
     readonly op: 'not';
     readonly predicate: AuthorityExpr;
-} | {
-    readonly op: 'grant';
-    readonly grant: Grant;
+}
+/**
+ * Bind one Identity as the lexical subject of `where`. The Identity is evaluated through its live
+ * composition (extensions, constraints, exclusions; deny wins). Two binders are never fused.
+ */
+ | {
+    readonly op: 'as';
+    readonly identity: IdentityId;
     readonly where: AuthorityExpr;
 } | {
     /** One closed Edge extent, reused at every bounded hop. */

package/dist/auth/authority/language/predicate.js

@@ -1 +1 @@
-export const AUTHORITY_PREDICATE_VERSION = 10;
+export const AUTHORITY_PREDICATE_VERSION = 11;

package/dist/auth/authority/language/program.d.ts

@@ -0,0 +1,21 @@
+import type { ClassRef } from '@astrale-os/kernel-dsl/v1/addressing';
+import type { AuthorityExpr } from './predicate.js';
+/** Program coordinate; its predicates are AuthorityPredicate V11 expressions. */
+export declare const AUTHORITY_PROGRAM_VERSION: 1;
+declare const PREDICATE_REF: unique symbol;
+/** Ordinal of one predicate inside the `AuthorityProgram` carried by the same plan. */
+export type PredicateRef = number & {
+    readonly [PREDICATE_REF]: true;
+};
+/**
+ * The one authority representation carried by a closed plan. Every authority position of the plan
+ * is a `PredicateRef` into `predicates`.
+ */
+export interface AuthorityProgram {
+    readonly version: typeof AUTHORITY_PROGRAM_VERSION;
+    /** Concrete Identity Classes, closed by Runtime from the pinned Registry; sorted and unique. */
+    readonly identities: readonly ClassRef[];
+    /** Canonical, sorted by canonical JSON text, unique; every member referenced by the plan. */
+    readonly predicates: readonly AuthorityExpr[];
+}
+export {};

package/dist/auth/authority/language/program.js

@@ -0,0 +1,2 @@
+/** Program coordinate; its predicates are AuthorityPredicate V11 expressions. */
+export const AUTHORITY_PROGRAM_VERSION = 1;

package/dist/auth/authority/normalization/index.d.ts

@@ -1 +1 @@
-export { canonicalize, canonicalizeAdmitted, normalizeGrantBodyAdmitted } from './normalize.js';
+export { canonicalize, canonicalizeAdmitted, normalizeBinderBodyAdmitted } from './normalize.js';

package/dist/auth/authority/normalization/index.js

@@ -1 +1 @@
-export { canonicalize, canonicalizeAdmitted, normalizeGrantBodyAdmitted } from './normalize.js';
+export { canonicalize, canonicalizeAdmitted, normalizeBinderBodyAdmitted } from './normalize.js';

package/dist/auth/authority/normalization/normalize.d.ts

@@ -3,4 +3,4 @@ import type { AuthorityExpr, AuthorityPredicate } from '../language/index.js';
 export declare function canonicalize(expr: AuthorityExpr): AuthorityPredicate;
 export declare function canonicalizeAdmitted(expr: AuthorityExpr): AuthorityPredicate;
 /** Internal scoped normalization; this body is not a closed owned authority expression. */
-export declare function normalizeGrantBodyAdmitted(expr: AuthorityExpr): AuthorityExpr;
+export declare function normalizeBinderBodyAdmitted(expr: AuthorityExpr): AuthorityExpr;

package/dist/auth/authority/normalization/normalize.js

@@ -1,7 +1,6 @@
 import * as portable from '@astrale-os/kernel-dsl/value';
 import { NodeId } from '../../../graph/node/index.js';
 import { AuthValueError } from '../../error.js';
-import { canonicalize as canonicalizeGrant } from '../../grant/index.js';
 import { admitAuthorityExpr, limits } from '../admission/index.js';
 import { AUTHORITY_PREDICATE_VERSION } from '../language/index.js';
 import { ownCanonical, ownedExpression, ownsExpression } from '../ownership.optimization.js';
@@ -20,7 +19,7 @@ export function canonicalizeAdmitted(expr) {
     }));
 }
 /** Internal scoped normalization; this body is not a closed owned authority expression. */
-export function normalizeGrantBodyAdmitted(expr) {
+export function normalizeBinderBodyAdmitted(expr) {
     return normalize(expr, '/predicate/where', new Set(), true);
 }
 function normalize(expr, path, locals, subjectBound) {
@@ -43,10 +42,10 @@ function normalize(expr, path, locals, subjectBound) {
         case 'all':
         case 'any':
             return normalizeBoolean(expr.op, expr.predicates, path, locals, subjectBound);
-        case 'grant':
+        case 'as':
             return Object.freeze({
-                op: 'grant',
-                grant: canonicalizeGrant(expr.grant),
+                op: 'as',
+                identity: NodeId(expr.identity),
                 where: normalize(expr.where, `${path}/where`, locals, true),
             });
         case 'same-node': {

package/dist/auth/authority/ownership.optimization.js

@@ -45,7 +45,7 @@ function expressionDepth(expression) {
         ? expression.predicates
         : expression.op === 'not'
             ? [expression.predicate]
-            : expression.op === 'grant' || expression.op === 'exists'
+            : expression.op === 'as' || expression.op === 'exists'
                 ? [expression.where]
                 : [];
     const depth = children.length === 0 ? 0 : 1 + Math.max(...children.map(expressionDepth));
@@ -76,7 +76,7 @@ function retainClosedExpression(expression) {
     }
     else if (expression.op === 'not')
         retainClosedExpression(expression.predicate);
-    // A complete Grant or existential is closed, but its body may depend on its binder.
+    // An identity binder or existential is closed, but its body may depend on its binder.
 }
 export function ownsCanonical(input) {
     return input !== null && typeof input === 'object' && canonical.has(input);

package/dist/auth/authority/prepare-binder-body.d.ts

@@ -0,0 +1,4 @@
+import type { IdentityId } from '../identity/index.js';
+import type { AuthorityExpr, AuthorityPredicate } from './language/index.js';
+/** Prepare one body in a fresh subject scope, independently of the Identity it will bind. */
+export declare function prepareBinderBody(where: AuthorityExpr): (identity: IdentityId) => AuthorityPredicate;

package/dist/auth/authority/prepare-binder-body.js

@@ -0,0 +1,31 @@
+import * as portable from '@astrale-os/kernel-dsl/value';
+import { isNodeId } from '../../graph/node/index.js';
+import { AuthValueError } from '../error.js';
+import { admitBinderBody } from './admission/index.js';
+import { AUTHORITY_PREDICATE_VERSION } from './language/index.js';
+import { normalizeBinderBodyAdmitted } from './normalization/index.js';
+import { ownCanonical } from './ownership.optimization.js';
+/** Prepare one body in a fresh subject scope, independently of the Identity it will bind. */
+export function prepareBinderBody(where) {
+    const admitted = admitBinderBody(portable.acceptForRead(where));
+    const body = portable.acceptImmutable(normalizeBinderBodyAdmitted(admitted));
+    return identityBinder(body);
+}
+// A distinct closure scope retains only the normalized body, never an initial Identity or input.
+function identityBinder(where) {
+    return (identity) => {
+        // Charge the entire expression on every binding, including the body and its outer container.
+        const value = portable.acceptForRead({ op: 'as', identity, where });
+        return ownCanonical(Object.freeze({
+            version: AUTHORITY_PREDICATE_VERSION,
+            predicate: Object.freeze({ op: 'as', identity: identityOf(value.identity), where }),
+        }));
+    };
+}
+// The same failure ordinary canonicalization reports for a malformed binder Identity.
+function identityOf(input) {
+    if (!isNodeId(input)) {
+        throw new AuthValueError('AUTHORITY_PREDICATE_INVALID', 'Expected one canonical IdentityId', '/predicate/identity');
+    }
+    return input;
+}

package/dist/auth/authority/program.d.ts

@@ -0,0 +1,28 @@
+import type { ClassRef } from '@astrale-os/kernel-dsl/v1/addressing';
+import type { AuthorityPredicate } from './language/index.js';
+import { type AuthorityProgram, type PredicateRef } from './language/index.js';
+/** Collect one plan's predicates, then close them into one canonical program. */
+export interface AuthorityProgramBuilder {
+    /**
+     * Reserve a provisional handle. A thunk is compiled only when `finish` selects its handle, so a
+     * planner may reserve programs for positions it later drops.
+     */
+    intern(predicate: AuthorityPredicate | (() => AuthorityPredicate)): PredicateRef;
+    /** Close over the used handles (every reserved handle by default); the builder then closes. */
+    finish(used?: Iterable<PredicateRef>): ClosedAuthorityProgram;
+}
+export interface ClosedAuthorityProgram {
+    readonly program: AuthorityProgram;
+    /** Final ordinal of one used provisional handle. Equal predicates share one ordinal. */
+    ref(handle: PredicateRef): PredicateRef;
+}
+/**
+ * Start one plan's program over the concrete Identity Classes Runtime closed from the pinned
+ * Registry. Equal predicate sets always close to equal programs: members are canonical, unique and
+ * sorted by their canonical JSON text, so equal meaning yields equal plans.
+ */
+export declare function createAuthorityProgram(identities: readonly ClassRef[]): AuthorityProgramBuilder;
+/** Re-admit one crossing or persisted program; an owned program is returned as is. */
+export declare function acceptProgram(input: unknown): AuthorityProgram;
+/** True exactly for an in-range ordinal of `program`. */
+export declare function isPredicateRef(program: AuthorityProgram, value: unknown): value is PredicateRef;

package/dist/auth/authority/program.js

@@ -0,0 +1,191 @@
+import { patterns } from '@astrale-os/kernel-dsl/v1/addressing';
+import * as portable from '@astrale-os/kernel-dsl/value';
+import { AuthValueError } from '../error.js';
+import { accept } from './accept.js';
+import { AUTHORITY_PREDICATE_VERSION, AUTHORITY_PROGRAM_VERSION, } from './language/index.js';
+import { ownsCanonical } from './ownership.optimization.js';
+/** Programs closed by this owner; admission of an owned program is an identity check. */
+const owned = new WeakSet();
+/**
+ * Start one plan's program over the concrete Identity Classes Runtime closed from the pinned
+ * Registry. Equal predicate sets always close to equal programs: members are canonical, unique and
+ * sorted by their canonical JSON text, so equal meaning yields equal plans.
+ */
+export function createAuthorityProgram(identities) {
+    const classes = canonicalIdentities(identities);
+    const entries = [];
+    const handles = new Map();
+    let closed = false;
+    return Object.freeze({
+        intern(predicate) {
+            if (closed)
+                throw new TypeError('Authority program is already closed.');
+            let handle = handles.get(predicate);
+            if (handle === undefined) {
+                handle = entries.length;
+                entries.push(predicate);
+                handles.set(predicate, handle);
+            }
+            return handle;
+        },
+        finish(used) {
+            if (closed)
+                throw new TypeError('Authority program is already closed.');
+            closed = true;
+            const selected = new Set(used ?? entries.keys());
+            const keys = new Map();
+            const members = new Map();
+            for (const handle of [...selected].sort((left, right) => left - right)) {
+                const entry = entries[handle];
+                if (entry === undefined)
+                    throw new TypeError('Unknown provisional Authority handle.');
+                const value = typeof entry === 'function' ? entry() : entry;
+                const predicate = ownsCanonical(value) ? value : accept(value);
+                const key = portable.json.serializeAdmitted(predicate.predicate);
+                keys.set(handle, key);
+                if (!members.has(key))
+                    members.set(key, predicate.predicate);
+            }
+            const sorted = [...members.keys()].sort(compare);
+            const ordinals = new Map(sorted.map((key, ordinal) => [key, ordinal]));
+            const program = own({
+                version: AUTHORITY_PROGRAM_VERSION,
+                identities: classes,
+                predicates: Object.freeze(sorted.map((key) => members.get(key))),
+            });
+            return Object.freeze({
+                program,
+                ref(handle) {
+                    const key = keys.get(handle);
+                    if (key === undefined)
+                        throw new TypeError('Authority handle was not closed.');
+                    return ordinals.get(key);
+                },
+            });
+        },
+    });
+}
+/** Re-admit one crossing or persisted program; an owned program is returned as is. */
+export function acceptProgram(input) {
+    if (input !== null && typeof input === 'object' && owned.has(input)) {
+        return input;
+    }
+    try {
+        const value = portable.accept(input);
+        if (value === null || Array.isArray(value) || typeof value !== 'object') {
+            invalid('', 'Expected an authority program object');
+        }
+        const record = value;
+        exact(record, ['identities', 'predicates', 'version'], '');
+        if (record.version !== AUTHORITY_PROGRAM_VERSION) {
+            invalid('/version', `Unsupported authority program version ${String(record.version)}`);
+        }
+        if (!Array.isArray(record.identities))
+            invalid('/identities', 'Expected an array');
+        const identities = record.identities.map((entry, index) => identityClass(entry, `/identities/${index}`));
+        const keys = identities.map(classKey);
+        for (let index = 1; index < keys.length; index++) {
+            if (compare(keys[index - 1], keys[index]) >= 0) {
+                invalid(`/identities/${index}`, 'Expected sorted unique Identity Classes');
+            }
+        }
+        if (!Array.isArray(record.predicates))
+            invalid('/predicates', 'Expected an array');
+        let previous;
+        const predicates = record.predicates.map((entry, index) => {
+            const path = `/predicates/${index}`;
+            let predicate;
+            try {
+                predicate = accept({ version: AUTHORITY_PREDICATE_VERSION, predicate: entry });
+            }
+            catch (cause) {
+                const pointer = cause instanceof AuthValueError ? cause.path.replace(/^\/predicate/u, '') : '';
+                throw new AuthValueError('AUTHORITY_PROGRAM_INVALID', 'Expected a canonical predicate', `${path}${pointer}`, {
+                    cause,
+                });
+            }
+            const key = portable.json.serializeAdmitted(predicate.predicate);
+            if (key !== portable.json.serializeAdmitted(entry)) {
+                invalid(path, 'Expected a canonical predicate');
+            }
+            if (previous !== undefined && compare(previous, key) >= 0) {
+                invalid(path, 'Expected sorted unique predicates');
+            }
+            previous = key;
+            return predicate.predicate;
+        });
+        return own({
+            version: AUTHORITY_PROGRAM_VERSION,
+            identities: Object.freeze(identities),
+            predicates: Object.freeze(predicates),
+        });
+    }
+    catch (cause) {
+        if (cause instanceof AuthValueError && cause.code === 'AUTHORITY_PROGRAM_INVALID')
+            throw cause;
+        const path = cause instanceof portable.BoundaryError ? cause.pointer : '';
+        throw new AuthValueError('AUTHORITY_PROGRAM_INVALID', 'Expected a canonical authority program', path, {
+            cause,
+        });
+    }
+}
+/**
+ * Retain the portable owner's immutable proof when the program fits its default bounds, so a
+ * read-only containing Plan capture keeps this identity; otherwise retain Core ownership only.
+ */
+function own(value) {
+    let program = Object.freeze(value);
+    try {
+        program = portable.acceptImmutable(program);
+    }
+    catch (cause) {
+        if (!(cause instanceof portable.BoundaryError) || cause.code !== 'VALUE_LIMIT')
+            throw cause;
+    }
+    owned.add(program);
+    return program;
+}
+/** True exactly for an in-range ordinal of `program`. */
+export function isPredicateRef(program, value) {
+    return (Number.isSafeInteger(value) &&
+        value >= 0 &&
+        value < program.predicates.length);
+}
+function canonicalIdentities(input) {
+    const classes = new Map();
+    input.forEach((ref, index) => {
+        const value = identityClass(ref, `/identities/${index}`);
+        classes.set(classKey(value), value);
+    });
+    return Object.freeze([...classes.entries()].sort(([left], [right]) => compare(left, right)).map(([, ref]) => ref));
+}
+function identityClass(input, path) {
+    if (input === null || Array.isArray(input) || typeof input !== 'object') {
+        invalid(path, 'Expected a Class reference');
+    }
+    const value = input;
+    exact(value, ['kind', 'name', 'origin'], path);
+    if (value.kind !== 'class' ||
+        typeof value.origin !== 'string' ||
+        !patterns.origin.test(value.origin) ||
+        typeof value.name !== 'string' ||
+        !patterns.memberName.test(value.name)) {
+        invalid(path, 'Expected a canonical Class reference');
+    }
+    return Object.freeze({ origin: value.origin, kind: 'class', name: value.name });
+}
+function classKey(ref) {
+    return `${ref.origin}:${ref.kind}.${ref.name}`;
+}
+function exact(value, expected, path) {
+    const actual = Object.keys(value).sort(compare);
+    if (actual.length !== expected.length || actual.some((key, index) => key !== expected[index])) {
+        invalid(path, `Expected exactly ${expected.join(', ')}`);
+    }
+}
+function compare(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function invalid(path, message) {
+    throw new AuthValueError('AUTHORITY_PROGRAM_INVALID', message, path);
+}

package/dist/auth/authority/semantics/class-authority.d.ts

@@ -0,0 +1,8 @@
+import type { AuthorityExpr, Requirement } from '../language/index.js';
+import type { AuthorityVocabulary } from './vocabulary.js';
+/**
+ * The meaning of `class-authority`. `owner` holds when the identity is the Domain that declares
+ * the Class. `allowed` holds for that owner, or when a capability Edge for the operation leads
+ * from the identity to the Class projection.
+ */
+export declare function classAuthorityMeaning(requirement: Requirement, vocabulary: AuthorityVocabulary): AuthorityExpr;

package/dist/auth/authority/semantics/class-authority.js

@@ -0,0 +1,26 @@
+/**
+ * The meaning of `class-authority`. `owner` holds when the identity is the Domain that declares
+ * the Class. `allowed` holds for that owner, or when a capability Edge for the operation leads
+ * from the identity to the Class projection.
+ */
+export function classAuthorityMeaning(requirement, vocabulary) {
+    const owner = {
+        op: 'same-node',
+        left: requirement.identity,
+        right: { kind: 'domain', origin: requirement.class.origin },
+    };
+    if (requirement.evidence === 'owner')
+        return owner;
+    return {
+        op: 'any',
+        predicates: [
+            owner,
+            {
+                op: 'related',
+                source: requirement.identity,
+                via: [vocabulary.capabilities[requirement.operation]],
+                target: { kind: 'class', ref: requirement.class },
+            },
+        ],
+    };
+}

package/dist/auth/authority/semantics/composition.d.ts

@@ -0,0 +1,39 @@
+import type { NodeId } from '../../../graph/node/index.js';
+import type { ClassRef } from '../language/index.js';
+import type { AuthoritySnapshot } from './snapshot.js';
+import type { AuthorityVocabulary } from './vocabulary.js';
+/** Ceilings a backend places on one binder's composition; overflow is a failure, never false. */
+export interface CompositionLimits {
+    readonly compositionNodes: number;
+    readonly compositionEdges: number;
+}
+/**
+ * Composed status of one Identity. `full` is the complete truth, `positive` ignores exclusions,
+ * and `denied` records an exclusion that was reached in positive position.
+ */
+export interface CompositionStatus {
+    readonly full: boolean;
+    readonly positive: boolean;
+    readonly denied: boolean;
+}
+/** One binder's live composition: every Identity reachable from its root. */
+export interface CompositionClosure {
+    readonly root: NodeId;
+    /** Closure members, root first, in breadth-first order. */
+    readonly identities: readonly NodeId[];
+    /** False when the closure contains a cycle; the binder is then false. */
+    readonly acyclic: boolean;
+    /**
+     * Fold the closure children first from one leaf decision per member. Every member's leaf is
+     * decided. Undefined when the closure is cyclic.
+     */
+    status(leaf: (identity: NodeId) => boolean): CompositionStatus | undefined;
+}
+/** A binder admits its Identity when its composed status is positive and not denied. */
+export declare function allowed(status: CompositionStatus): boolean;
+/**
+ * Close the composition of one binder root: the outgoing `extends_with`, `constrained_by` and
+ * `excluded_from` Edges, followed transitively. The root must be live and every member must have a
+ * concrete Identity Class of `identities`; otherwise the composition is invalid, not false.
+ */
+export declare function closeComposition(root: NodeId, snapshot: AuthoritySnapshot, vocabulary: AuthorityVocabulary, identities: readonly ClassRef[], limits?: CompositionLimits): CompositionClosure;