@astrale-os/sdk 0.5.0-beta.114 → 0.5.0-beta.116

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.5.0-beta.116](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.115...sdk-v0.5.0-beta.116) (2026-09-05)
+
+
+### Features
+
+* **app:** support sameNode policies and explicit Dataset references ([#432](https://github.com/astrale-os/sdk/issues/432)) ([29e72b3](https://github.com/astrale-os/sdk/commit/29e72b377c71f1e8cce8ce75a8a0d3920e4c46c6))
+
+## [0.5.0-beta.115](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.114...sdk-v0.5.0-beta.115) (2026-09-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* default graph execution to self authority ([#430](https://github.com/astrale-os/sdk/issues/430))
+
+### Features
+
+* **app:** add invocation-bound provider authentication ([#427](https://github.com/astrale-os/sdk/issues/427)) ([ed3f31f](https://github.com/astrale-os/sdk/commit/ed3f31f26d7ebcb124ab30b4b0661a954d437fea))
+* default graph execution to self authority ([#430](https://github.com/astrale-os/sdk/issues/430)) ([35cf447](https://github.com/astrale-os/sdk/commit/35cf447936bb23f5817ba6f0116a846783d2688b))
+
+
+### Bug Fixes
+
+* default domain dev to the development environment ([#431](https://github.com/astrale-os/sdk/issues/431)) ([470bcee](https://github.com/astrale-os/sdk/commit/470bcee062c46999bd39ce53de760757902e2637))
+
 ## [0.5.0-beta.114](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.113...sdk-v0.5.0-beta.114) (2026-09-05)
 
 

package/README.md

@@ -131,6 +131,28 @@ linter tool failures.
 Structured review [issues](issues/README.md) retain observation-first evidence and later governance
 attachments without becoming current contract authority.
 
+## Dataset references
+
+A Dataset can materialize a projected Node explicitly with `ref`, using its resolved local or
+direct-dependency definition:
+
+```typescript
+const demo = defineDataset(Schema, {
+  id: 'demo',
+  graph({ domain, ref }) {
+    const member = ref(domain.core.nodes.member)
+    // Repeating ref returns the same Dataset Node. node() always creates a separate identity.
+    return { member }
+  },
+})
+```
+
+`ref` uses the canonical symbolic Schema projection for Class, Function, Policy, View and Core
+facts. The Dataset's `references` table retains the explicit association between each projected
+NodePath and its Dataset Node ID through encoding and decoding. Matching properties or slugs do
+not create that association. Studio uses it when simulating `sameNode` and reference endpoints;
+a missing association makes that simulation unavailable.
+
 ## License
 
 Apache License 2.0 — see [LICENSE](LICENSE) for details.

package/dist/application/action/context.d.ts

@@ -55,9 +55,9 @@ type AuthorityOf<Callable, DomainValue extends Domain> = Callable extends {
     readonly client: BoundClientSession;
     readonly kernel: DomainKernelSessions;
     readonly graph: DomainGraphExecutors<DomainValue>;
-    /** Convenience executor using the admitted union of caller and Domain authority. */
+    /** Convenience executor using the installed Domain authority (`graph.self`). */
     readonly query: QueryExecutor<DomainValue>;
-    /** Convenience executor using the admitted union of caller and Domain authority. */
+    /** Convenience executor using the installed Domain authority (`graph.self`). */
     readonly mutate: MutationExecutor<DomainValue>;
 } : {
     readonly caller: AuthenticatedCaller;
@@ -65,9 +65,9 @@ type AuthorityOf<Callable, DomainValue extends Domain> = Callable extends {
     readonly client: BoundClientSession;
     readonly kernel: DomainKernelSessions;
     readonly graph: DomainGraphExecutors<DomainValue>;
-    /** Convenience executor using the admitted union of caller and Domain authority. */
+    /** Convenience executor using the installed Domain authority (`graph.self`). */
     readonly query: QueryExecutor<DomainValue>;
-    /** Convenience executor using the admitted union of caller and Domain authority. */
+    /** Convenience executor using the installed Domain authority (`graph.self`). */
     readonly mutate: MutationExecutor<DomainValue>;
 };
 type SelfOf<Callable> = Callable extends ResolvedMethod<unknown, unknown, false> ? {

package/dist/application/integration/authentication.d.ts

@@ -0,0 +1,10 @@
+import type { MintedCredential } from '../../platform/auth/index.js';
+export interface IntegrationMintInput {
+    readonly audience: string;
+    /** Maximum requested lifetime, in whole seconds, from 1 through 60. */
+    readonly ttlSeconds: number;
+}
+/** Invocation-bound authentication as the executing Domain, never the caller. */
+export interface IntegrationAuthentication {
+    mint(input: IntegrationMintInput): Promise<MintedCredential>;
+}

package/dist/application/integration/authentication.js

@@ -0,0 +1 @@
+export {};

package/dist/application/integration/authentication.typecheck.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/application/integration/authentication.typecheck.js

@@ -0,0 +1,18 @@
+async function provider(execution) {
+    // @ts-expect-error An anonymous invocation has no auth capability.
+    await execution.auth.mint({ audience: 'admin', ttlSeconds: 60 });
+    if (execution.auth === undefined)
+        return;
+    await execution.auth.mint({ audience: 'admin', ttlSeconds: 60 });
+    // @ts-expect-error Providers cannot register identities.
+    execution.auth.register({});
+    // @ts-expect-error Providers cannot delegate authority.
+    execution.auth.delegate({});
+    // @ts-expect-error Providers cannot supply a Grant.
+    execution.auth.mint({ audience: 'admin', ttlSeconds: 60, grant: {} });
+    // @ts-expect-error The destination audience is mandatory.
+    const invalid = { ttlSeconds: 60 };
+    return invalid;
+}
+void provider;
+export {};

package/dist/application/integration/client.d.ts

@@ -1,4 +1,5 @@
 import type { BoundClientSession } from '../../platform/client/session/index.js';
+import type { IntegrationAuthentication } from './authentication.js';
 import type { IntegrationClients, Integrations } from './integration.js';
 import type { IntegrationReplayDecision } from './operation.js';
 import type { Providers } from './provider.js';
@@ -7,6 +8,7 @@ export interface IntegrationCallCoordinates {
     readonly signal: AbortSignal;
     readonly deadline: number;
     readonly invoke?: BoundClientSession['invoke'];
+    readonly auth?: IntegrationAuthentication;
 }
 export interface IntegrationAttempt<Output> {
     readonly integration: string;

package/dist/application/integration/client.js

@@ -78,8 +78,12 @@ function admitCoordinates(input) {
     if (input === null || typeof input !== 'object' || Array.isArray(input))
         invalidCoordinates();
     const keys = Reflect.ownKeys(input);
-    if ((keys.length !== 3 && keys.length !== 4) ||
-        !keys.every((key) => key === 'callId' || key === 'signal' || key === 'deadline' || key === 'invoke') ||
+    if (!['callId', 'signal', 'deadline'].every((key) => Object.hasOwn(input, key)) ||
+        !keys.every((key) => key === 'callId' ||
+            key === 'signal' ||
+            key === 'deadline' ||
+            key === 'invoke' ||
+            key === 'auth') ||
         typeof input.callId !== 'string' ||
         input.callId.length === 0 ||
         input.callId.trim() !== input.callId ||
@@ -88,13 +92,26 @@ function admitCoordinates(input) {
         (input.invoke !== undefined && typeof input.invoke !== 'function')) {
         invalidCoordinates();
     }
+    const auth = input.auth === undefined ? undefined : admitAuthentication(input.auth);
     return Object.freeze({
         callId: input.callId,
         signal: input.signal,
         deadline: input.deadline,
         ...(input.invoke === undefined ? {} : { invoke: input.invoke }),
+        ...(auth === undefined ? {} : { auth }),
     });
 }
+function admitAuthentication(input) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        Array.isArray(input) ||
+        Reflect.ownKeys(input).length !== 1 ||
+        !Object.hasOwn(input, 'mint') ||
+        typeof input.mint !== 'function') {
+        invalidCoordinates();
+    }
+    return Object.freeze({ mint: input.mint.bind(input) });
+}
 function invalidCoordinates() {
     throw new TypeError('Integration call coordinates are invalid.');
 }

package/dist/application/integration/index.d.ts

@@ -5,3 +5,4 @@ export type { DefineIntegration, ProviderBinding } from './define.js';
 export type { IntegrationClient, IntegrationClients, IntegrationDefinition, Integrations, } from './integration.js';
 export type { IntegrationExecution, IntegrationInput, IntegrationOperation, IntegrationOperations, IntegrationOutput, IntegrationReplay, IntegrationReplayDecision, } from './operation.js';
 export type { Provider, ProviderImplementation, Providers } from './provider.js';
+export type { IntegrationAuthentication, IntegrationMintInput } from './authentication.js';

package/dist/application/integration/operation.d.ts

@@ -1,4 +1,5 @@
 import type { BoundClientSession } from '../../platform/client/session/index.js';
+import type { IntegrationAuthentication } from './authentication.js';
 declare const INTEGRATION_OPERATION: unique symbol;
 export type IntegrationReplayDecision = {
     readonly kind: 'safe';
@@ -20,6 +21,8 @@ export interface IntegrationExecution {
     readonly idempotencyKey?: string;
     /** Exact caller-bound invocation capability; absent for an anonymous invocation. */
     readonly invoke?: BoundClientSession['invoke'];
+    /** Domain-self transport authentication; absent for an anonymous invocation. */
+    readonly auth?: IntegrationAuthentication;
 }
 export interface IntegrationOperation<Input = unknown, Output = unknown> {
     readonly replay: IntegrationReplay<Input>;

package/dist/execution/invocation/dispatch/context.js

@@ -24,10 +24,20 @@ export function context(request, runtime, authentication, self) {
         ...(graph === null
             ? {}
             : {
-                query: graph.union.query,
-                mutate: graph.union.mutate,
+                query: graph.self.query,
+                mutate: graph.self.mutate,
+            }),
+        integrations: clients(runtime, request.context, authentication.graph === null
+            ? null
+            : {
+                caller: authentication.graph.caller,
+                self: authentication.graph.self,
+                ...(authentication.caller.authentication.expiresAt === undefined
+                    ? {}
+                    : {
+                        expiresAt: authentication.caller.authentication.expiresAt,
+                    }),
             }),
-        integrations: clients(runtime, request.context, client),
         execution,
         ...(self === undefined ? {} : { self }),
     });

package/dist/execution/invocation/integration/authentication.d.ts

@@ -0,0 +1,5 @@
+import type { InvocationContext } from '@astrale-os/kernel-server';
+import type { IntegrationAuthentication } from '../../../application/integration/index.js';
+import type { BoundClientSession } from '../../../platform/client/session/index.js';
+/** Capture only self mint, bounded by this invocation's verified credential horizon. */
+export declare function bindIntegrationAuthentication(context: InvocationContext, self: BoundClientSession, expiresAt?: number): IntegrationAuthentication;

package/dist/execution/invocation/integration/authentication.js

@@ -0,0 +1,53 @@
+import { credential as credentials } from '../../../platform/auth/index.js';
+import { active } from '../lifecycle/index.js';
+import { protocolError } from '../result/index.js';
+// Match the callback resolver's reserve; a child credential cannot outlive its source.
+const TRANSPORT_RESERVE_SECONDS = 5;
+/** Capture only self mint, bounded by this invocation's verified credential horizon. */
+export function bindIntegrationAuthentication(context, self, expiresAt) {
+    if (expiresAt !== undefined && !Number.isFinite(expiresAt)) {
+        throw new TypeError('Invalid Integration authentication expiry.');
+    }
+    const mint = self.auth.mint.bind(self.auth);
+    return Object.freeze({
+        async mint(input) {
+            active(context);
+            if (input === null || typeof input !== 'object' || Array.isArray(input))
+                invalidInput();
+            const keys = Reflect.ownKeys(input);
+            const { audience, ttlSeconds } = input;
+            if (keys.length !== 2 ||
+                !keys.every((key) => key === 'audience' || key === 'ttlSeconds') ||
+                typeof audience !== 'string' ||
+                audience.length === 0 ||
+                audience.trim() !== audience ||
+                !Number.isInteger(ttlSeconds) ||
+                ttlSeconds < 1 ||
+                ttlSeconds > 60)
+                invalidInput();
+            const horizon = Math.min(context.execution.deadline / 1000, expiresAt ?? Infinity);
+            const remaining = Math.floor(horizon) - Math.floor(Date.now() / 1000) - TRANSPORT_RESERVE_SECONDS;
+            if (remaining < 1) {
+                throw protocolError('DEADLINE_EXCEEDED', 'Insufficient lifetime for Integration credential.');
+            }
+            const credential = await mint({ audience, ttlSeconds: Math.min(ttlSeconds, remaining) }, {
+                signal: context.execution.signal,
+                timeoutMs: Math.max(1, context.execution.deadline - Date.now()),
+            });
+            active(context);
+            // Inspect only the result of the trusted Kernel call, not a Provider-supplied token.
+            // The reserve is an optimization; this absolute check is the lifetime boundary.
+            const expiry = credentials.inspect(credential).claims.exp;
+            if (typeof expiry !== 'number' ||
+                !Number.isSafeInteger(expiry) ||
+                expiry <= Math.floor(Date.now() / 1000) ||
+                expiry > Math.floor(horizon)) {
+                throw protocolError('DEADLINE_EXCEEDED', 'Integration credential exceeds its lifetime.');
+            }
+            return credential;
+        },
+    });
+}
+function invalidInput() {
+    throw new TypeError('Invalid Integration mint input.');
+}

package/dist/execution/invocation/integration/call.d.ts

@@ -1,5 +1,11 @@
 import type { InvocationContext } from '@astrale-os/kernel-server';
 import type { IntegrationInvocationOwner } from '../../../application/integration/index.js';
 import type { BoundClientSession } from '../../../platform/client/session/index.js';
+export interface IntegrationInvocationSessions {
+    readonly caller: BoundClientSession;
+    readonly self: BoundClientSession;
+    /** Verified incoming carrier expiry, in Unix seconds. */
+    readonly expiresAt?: number;
+}
 /** One invocation-owned logical Integration call sequence. */
-export declare function calls(context: InvocationContext, client?: BoundClientSession | null): IntegrationInvocationOwner;
+export declare function calls(context: InvocationContext, sessions?: IntegrationInvocationSessions | null): IntegrationInvocationOwner;

package/dist/execution/invocation/integration/call.js

@@ -1,8 +1,12 @@
 import { active } from '../lifecycle/index.js';
+import { bindIntegrationAuthentication } from './authentication.js';
 /** One invocation-owned logical Integration call sequence. */
-export function calls(context, client = null) {
+export function calls(context, sessions = null) {
     const prefix = context.idempotencyKey ?? JSON.stringify([context.invocation.source, context.invocation.id]);
-    const invoke = client?.invoke.bind(client);
+    const invoke = sessions?.caller.invoke.bind(sessions.caller);
+    const auth = sessions === null
+        ? undefined
+        : bindIntegrationAuthentication(context, sessions.self, sessions.expiresAt);
     let sequence = 0;
     return Object.freeze({
         invoke(call) {
@@ -13,6 +17,7 @@ export function calls(context, client = null) {
                 signal: context.execution.signal,
                 deadline: context.execution.deadline,
                 ...(invoke === undefined ? {} : { invoke }),
+                ...(auth === undefined ? {} : { auth }),
             });
         },
     });

package/dist/execution/invocation/integration/clients.d.ts

@@ -1,5 +1,5 @@
 import type { InvocationContext } from '@astrale-os/kernel-server';
 import type { IntegrationClients, Integrations } from '../../../application/integration/index.js';
-import type { BoundClientSession } from '../../../platform/client/session/index.js';
 import type { InitializedRuntime } from '../../runtime/index.js';
-export declare function clients(runtime: InitializedRuntime, context: InvocationContext, client: BoundClientSession | null): IntegrationClients<Integrations>;
+import type { IntegrationInvocationSessions } from './call.js';
+export declare function clients(runtime: InitializedRuntime, context: InvocationContext, sessions: IntegrationInvocationSessions | null): IntegrationClients<Integrations>;

package/dist/execution/invocation/integration/clients.js

@@ -1,4 +1,4 @@
 import { calls } from './call.js';
-export function clients(runtime, context, client) {
-    return runtime.clients(calls(context, client));
+export function clients(runtime, context, sessions) {
+    return runtime.clients(calls(context, sessions));
 }

package/dist/platform/schema/index.d.ts

@@ -7,7 +7,7 @@ export { classIcon } from './class-icon.js';
 export type { ClassIcon } from './class-icon.js';
 export type { CallablePolicyBuilder, CallablePolicyContext, CallableProjection, AuthoredMethodProjection, AuthoredPropertyProjection, ClassIdentityProjection, ClassOwnerProjection, CoreEdge, CoreEndpoint, CoreNode, DefinedSchema, DirectedEdgeClass, ClassReferenceProjection, ClassProjection, FunctionProjection, EdgeClass, Function, Method, MethodProjection, Lazy, NodeClass, Policy, PolicyExistsContext, PolicyNodeBinder, PolicyPatternContext, Property, PropertyProjection, ResolvedDomainOfInput, View, } from '@astrale-os/kernel-dsl/v1/builder';
 export type { Array, Object, Value } from '@astrale-os/kernel-dsl/value';
-export type { ClassKind, DirectedEdgeContract, EdgeClassPolicies, NodeClassDefinition, PolicyCheckObject, PropertyFacet, UndirectedEdgeContract, } from '@astrale-os/kernel-dsl/v1/language';
+export type { ClassKind, DirectedEdgeContract, EdgeClassPolicies, NodeClassDefinition, PolicyCheckObject, PolicyObjectRef, PropertyFacet, UndirectedEdgeContract, } from '@astrale-os/kernel-dsl/v1/language';
 export type { DomainSchema } from '@astrale-os/kernel-dsl/v1/schema';
 /** Kernel-owned Schema values used by authored product Schemas and graph operations. */
 export { AuthorityOperationOrder, AuthorityOperations, AuthorityRelations, K, KernelRootFunctions, OperationCore, operationOf, } from '@astrale-os/kernel-core/schema';

package/dist/testing/dataset/builder.d.ts

@@ -1,7 +1,8 @@
 import type { Edge } from '../../platform/graph/edge/index.js';
 import type { Node, NodeId } from '../../platform/graph/node/index.js';
 import type { PropertyInputOf, ResolvedClass, schema } from '../../platform/schema/index.js';
-import type { DatasetNode } from './dataset.js';
+import type { DatasetNode, DatasetReferences } from './dataset.js';
+import { type DatasetReferenceInput } from './references.js';
 /** Resolved Classes of the exact authored Schema, keyed by their authored names. */
 export type DatasetClasses<Schema extends schema.DomainSchema> = schema.DomainOf<Schema>['classes'];
 /** One Dataset Node, or one Node identity that names a Node already added to the same Dataset. */
@@ -20,10 +21,13 @@ export interface DatasetGraph<Schema extends schema.DomainSchema> {
     /** The exact resolved Domain, including dependency Domains under their authored aliases. */
     readonly domain: schema.DomainOf<Schema>;
     readonly classes: DatasetClasses<Schema>;
+    /** Materialize one local or direct-dependency projected Node, retaining its reference identity. */
+    ref(input: DatasetReferenceInput): DatasetNode;
     node<Class extends ResolvedClass<'node'>>(definition: Class, input?: DatasetNodeInput<Class>): DatasetNode<Class>;
     edge<Class extends ResolvedClass<'edge'>>(definition: Class, source: DatasetEndpoint, target: DatasetEndpoint, input?: DatasetEdgeInput<Class>): Edge;
 }
 export interface DatasetFacts {
+    readonly references: DatasetReferences;
     readonly nodes: readonly Node[];
     readonly edges: readonly Edge[];
     /** Exact Node values handed out by `node()`, for variable admission by identity. */
@@ -35,4 +39,4 @@ export interface DatasetGraphSession<Schema extends schema.DomainSchema> {
     seal(): DatasetFacts;
 }
 /** Open one authoring session over a resolved Domain. Authored facts stay un-admitted until sealed. */
-export declare function openDatasetGraph<Schema extends schema.DomainSchema>(domain: schema.DomainOf<Schema>): DatasetGraphSession<Schema>;
+export declare function openDatasetGraph<Schema extends schema.DomainSchema>(domain: schema.ResolvedDomainOf<Schema>): DatasetGraphSession<Schema>;

package/dist/testing/dataset/builder.js

@@ -1,6 +1,8 @@
 import { edge as graphEdge, EdgeSlug } from '../../platform/graph/edge/index.js';
 import { node as graphNode, NodeId as admitNodeId } from '../../platform/graph/node/index.js';
+import { Path } from '../../platform/graph/path/index.js';
 import { ClassKey } from '../../platform/schema/index.js';
+import { datasetReferenceNodes } from './references.js';
 /** Open one authoring session over a resolved Domain. Authored facts stay un-admitted until sealed. */
 export function openDatasetGraph(domain) {
     const nodes = [];
@@ -8,10 +10,35 @@ export function openDatasetGraph(domain) {
     const byId = new Map();
     const created = new Set();
     const ordinals = new Map();
+    const references = {};
+    let projected;
+    let referenceOrdinal = 0;
     let sealed = false;
     const graph = Object.freeze({
         domain,
         classes: domain.classes,
+        ref(input) {
+            open();
+            const ref = 'ref' in input ? input.ref : input;
+            const path = Path.project(ref).raw;
+            const existing = references[path];
+            if (existing !== undefined)
+                return byId.get(existing);
+            projected ??= datasetReferenceNodes(domain);
+            const facts = projected.get(path);
+            if (facts === undefined)
+                throw new TypeError(`Dataset reference ${path} is not local or a direct dependency member.`);
+            let id;
+            do {
+                id = admitNodeId(`reference-${++referenceOrdinal}`);
+            } while (byId.has(id));
+            const value = graphNode({ id, class: facts.class, props: facts.props });
+            nodes.push(value);
+            byId.set(id, value);
+            created.add(value);
+            references[path] = id;
+            return value;
+        },
         node(definition, input = {}) {
             open();
             acceptClass(definition, 'node');
@@ -52,6 +79,7 @@ export function openDatasetGraph(domain) {
                 nodes: Object.freeze([...nodes]),
                 edges: Object.freeze([...edges]),
                 created,
+                references: Object.freeze({ ...references }),
             });
         },
     });

package/dist/testing/dataset/codec.js

@@ -4,6 +4,7 @@ import { schema as schemaApi } from '../../platform/schema/index.js';
 import { admitDatasetGraph } from './admission.js';
 import { DATASET_FORMAT, DATASET_VERSION } from './dataset.js';
 import { admitId, admitText, admitVariableName, assembleDataset } from './define.js';
+import { decodeDatasetReferences } from './references.js';
 /** Encode exact portable Dataset bytes without retaining runtime object identity. */
 export function encodeDataset(dataset) {
     const variables = Object.freeze(Object.fromEntries(Object.entries(dataset.variables)
@@ -21,13 +22,24 @@ export function encodeDataset(dataset) {
         }),
         graph: GraphData.encode({ nodes: dataset.nodes, edges: dataset.edges }),
         variables,
+        references: dataset.references,
     });
 }
 /** Decode one portable Dataset and re-admit its facts against the exact authored Schema. */
 export function decodeDataset(source, input) {
     if (!isRecord(input))
         invalid('Dataset must be an object.');
-    exactKeys(input, ['format', 'version', 'id', 'title', 'description', 'domain', 'graph', 'variables'], ['format', 'version', 'id', 'domain', 'graph', 'variables'], 'Dataset');
+    exactKeys(input, [
+        'format',
+        'version',
+        'id',
+        'title',
+        'description',
+        'domain',
+        'graph',
+        'variables',
+        'references',
+    ], ['format', 'version', 'id', 'domain', 'graph', 'variables', 'references'], 'Dataset');
     if (input.format !== DATASET_FORMAT || input.version !== DATASET_VERSION) {
         invalid('Dataset format or version is unsupported.');
     }
@@ -47,7 +59,8 @@ export function decodeDataset(source, input) {
     const domain = schemaApi.resolve(source);
     const graph = admitDatasetGraph(id, domain, GraphData.decode(input.graph));
     const variables = decodeVariables(input.variables, graph);
-    return assembleDataset({ schema: source, id, title, description, graph, variables });
+    const references = decodeDatasetReferences(input.references, domain, graph);
+    return assembleDataset({ schema: source, id, title, description, graph, variables, references });
 }
 function encodeVariable(value) {
     return Array.isArray(value)

package/dist/testing/dataset/dataset.d.ts

@@ -1,6 +1,6 @@
 import type { Graph, GraphDataJson } from '../../platform/graph/document/index.js';
 import type { Edge } from '../../platform/graph/edge/index.js';
-import type { Node } from '../../platform/graph/node/index.js';
+import type { Node, NodeId } from '../../platform/graph/node/index.js';
 import type { ResolvedClass, schema } from '../../platform/schema/index.js';
 export declare const DATASET_FORMAT: 'astrale.sdk.dataset';
 export declare const DATASET_VERSION: 1;
@@ -9,6 +9,8 @@ declare const DATASET_NODE_CLASS: unique symbol;
 export type DatasetNode<Class extends ResolvedClass<'node'> = ResolvedClass<'node'>> = Node & {
     readonly [DATASET_NODE_CLASS]: Class;
 };
+/** Canonical projected NodePath → explicit Dataset Node identity. */
+export type DatasetReferences = Readonly<Record<string, NodeId>>;
 export type DatasetVariable = DatasetNode | readonly DatasetNode[];
 export type DatasetVariables = Readonly<Record<string, DatasetVariable>>;
 /**
@@ -27,6 +29,7 @@ export interface Dataset<Schema extends schema.DomainSchema = schema.DomainSchem
     readonly nodes: readonly Node[];
     readonly edges: readonly Edge[];
     /** Named entry points into the facts, for tooling and tests. */
+    readonly references: DatasetReferences;
     readonly variables: Variables;
 }
 export type DatasetVariableJson = {
@@ -46,6 +49,7 @@ export interface DatasetJson {
         readonly revision: string;
     };
     readonly graph: GraphDataJson;
+    readonly references: Readonly<Record<string, string>>;
     readonly variables: Readonly<Record<string, DatasetVariableJson>>;
 }
 export type SchemaOfDataset<Value> = Value extends {

package/dist/testing/dataset/define.d.ts

@@ -1,7 +1,7 @@
 import type { Graph } from '../../platform/graph/document/index.js';
 import type { schema as schemaLanguage } from '../../platform/schema/index.js';
 import type { DatasetGraph } from './builder.js';
-import type { Dataset, DatasetVariables } from './dataset.js';
+import type { Dataset, DatasetReferences, DatasetVariables } from './dataset.js';
 /** Variables returned by one graph author; `void` means the Dataset names no entry point. */
 export type AuthoredDatasetVariables = DatasetVariables | void;
 /** The exact variables record retained by a Dataset for one authored return type. */
@@ -25,6 +25,7 @@ export declare function assembleDataset<Schema extends schemaLanguage.DomainSche
     readonly title: string | undefined;
     readonly description: string | undefined;
     readonly graph: Graph;
+    readonly references: DatasetReferences;
     readonly variables: DatasetVariables;
 }): Dataset<Schema>;
 export declare function admitId(input: unknown): string;

package/dist/testing/dataset/define.js

@@ -22,7 +22,15 @@ export function defineDataset(source, input) {
     const facts = session.seal();
     const graph = admitDatasetGraph(id, domain, { nodes: facts.nodes, edges: facts.edges });
     const variables = admitVariables(returned, facts.created, graph);
-    return assembleDataset({ schema: source, id, title, description, graph, variables });
+    return assembleDataset({
+        schema: source,
+        id,
+        title,
+        description,
+        graph,
+        variables,
+        references: facts.references,
+    });
 }
 /** True only for a Dataset produced by defineDataset or decodeDataset in this SDK package root. */
 export function isDataset(input) {
@@ -41,6 +49,7 @@ export function assembleDataset(input) {
         nodes: data.nodes,
         edges: data.edges,
         variables: input.variables,
+        references: input.references,
     });
     admittedDatasets.add(dataset);
     return dataset;

package/dist/testing/dataset/index.d.ts

@@ -2,6 +2,7 @@ export { DatasetAdmissionError } from './admission.js';
 export type { DatasetClasses, DatasetEdgeInput, DatasetEndpoint, DatasetGraph, DatasetNodeInput, } from './builder.js';
 export { decodeDataset, encodeDataset } from './codec.js';
 export { DATASET_FORMAT, DATASET_VERSION } from './dataset.js';
-export type { Dataset, DatasetJson, DatasetNode, DatasetVariable, DatasetVariableJson, DatasetVariables, SchemaOfDataset, } from './dataset.js';
+export type { Dataset, DatasetJson, DatasetNode, DatasetReferences, DatasetVariable, DatasetVariableJson, DatasetVariables, SchemaOfDataset, } from './dataset.js';
 export { defineDataset, isDataset } from './define.js';
 export type { AuthoredDatasetVariables, DatasetInput, DatasetVariablesOf } from './define.js';
+export type { DatasetReferenceInput } from './references.js';

package/dist/testing/dataset/references.d.ts

@@ -0,0 +1,13 @@
+import type { Graph } from '../../platform/graph/document/index.js';
+import type { Node } from '../../platform/graph/node/index.js';
+import type { PolicyObjectRef, schema } from '../../platform/schema/index.js';
+import type { DatasetReferences } from './dataset.js';
+export type DatasetReferenceInput = PolicyObjectRef | {
+    readonly ref: PolicyObjectRef;
+};
+type ReferenceNode = Pick<Node, 'class' | 'props'>;
+/** Symbolic projection supplies facts; only an explicit Dataset reference supplies identity. */
+export declare function datasetReferenceNodes(domain: schema.ResolvedDomainOf<schema.DomainSchema>): ReadonlyMap<string, ReferenceNode>;
+/** Serialized reference associations lose their proof and must match the exact projection again. */
+export declare function decodeDatasetReferences(input: unknown, domain: schema.ResolvedDomainOf<schema.DomainSchema>, graph: Graph): DatasetReferences;
+export {};

package/dist/testing/dataset/references.js

@@ -0,0 +1,56 @@
+import { graph as schemaGraph } from '@astrale-os/kernel-core/schema';
+import { isNodeId } from '../../platform/graph/node/index.js';
+import { Path } from '../../platform/graph/path/index.js';
+import { bundle, schema as schemaApi } from '../../platform/schema/index.js';
+/** Symbolic projection supplies facts; only an explicit Dataset reference supplies identity. */
+export function datasetReferenceNodes(domain) {
+    const result = new Map();
+    const direct = new Set([
+        domain.origin,
+        ...Object.values(domain.dependencies).map(({ origin }) => origin),
+    ]);
+    const sourceBundle = bundle.create(domain.source);
+    for (const source of [sourceBundle.root, ...sourceBundle.closure]) {
+        if (!direct.has(source.origin))
+            continue;
+        const owner = schemaApi.resolve(source);
+        const projection = schemaGraph.project(owner);
+        const allowed = new Set(owner
+            .definitions()
+            .filter(({ ref }) => ref.origin === owner.origin &&
+            ['class', 'function', 'policy', 'view', 'core'].includes(ref.kind))
+            .map(({ ref }) => Path.project(ref).raw));
+        for (const part of [projection.managed, projection.core]) {
+            for (const node of part.graph.nodes) {
+                if (!('as' in node))
+                    continue;
+                const path = part.paths.get(node.as);
+                if (path !== undefined && allowed.has(path))
+                    result.set(path, node);
+            }
+        }
+    }
+    return result;
+}
+/** Serialized reference associations lose their proof and must match the exact projection again. */
+export function decodeDatasetReferences(input, domain, graph) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new TypeError('Dataset references must be an object.');
+    }
+    const entries = Object.entries(input);
+    const projected = entries.length === 0 ? new Map() : datasetReferenceNodes(domain);
+    const identities = new Set();
+    for (const [path, id] of entries) {
+        const expected = projected.get(path);
+        const actual = isNodeId(id) ? graph.nodes.byId(id) : undefined;
+        if (expected === undefined ||
+            actual === undefined ||
+            identities.has(actual.id) ||
+            expected.class !== actual.class ||
+            JSON.stringify(expected.props) !== JSON.stringify(actual.props)) {
+            throw new TypeError(`Dataset reference ${path} does not identify its projected Node.`);
+        }
+        identities.add(actual.id);
+    }
+    return Object.freeze(Object.fromEntries(entries));
+}

package/dist/testing/index.d.ts

@@ -1,6 +1,6 @@
 /** Development and test resources: schema-admitted demo Datasets and their lazy project references. */
 export { DATASET_FORMAT, DATASET_VERSION, DatasetAdmissionError, decodeDataset, defineDataset, encodeDataset, isDataset, } from './dataset/index.js';
-export type { AuthoredDatasetVariables, Dataset, DatasetClasses, DatasetEdgeInput, DatasetEndpoint, DatasetGraph, DatasetInput, DatasetJson, DatasetNode, DatasetNodeInput, DatasetVariable, DatasetVariableJson, DatasetVariables, DatasetVariablesOf, SchemaOfDataset, } from './dataset/index.js';
+export type { AuthoredDatasetVariables, Dataset, DatasetClasses, DatasetEdgeInput, DatasetEndpoint, DatasetGraph, DatasetInput, DatasetJson, DatasetNode, DatasetNodeInput, DatasetReferences, DatasetReferenceInput, DatasetVariable, DatasetVariableJson, DatasetVariables, DatasetVariablesOf, SchemaOfDataset, } from './dataset/index.js';
 export { loadDataset, loadDatasets } from './load.js';
 export type { DatasetModuleLoader, LoadedDataset } from './load.js';
 export { dataset, isDatasetReference } from './reference.js';

package/dist/tooling/cli/arguments.js

@@ -100,7 +100,7 @@ export function parseArgs(argv) {
             if (positionals.length > 1) {
                 throw new Error(`\`${command}\` accepts exactly one Environment.`);
             }
-            const env = environment ?? positionals[0];
+            const env = environment ?? positionals[0] ?? (command === 'dev' ? 'development' : undefined);
             if (!env) {
                 throw new Error(`\`${command}\` requires an Environment, e.g. \`${command} development\`.`);
             }

package/dist/tooling/cli/help.js

@@ -18,7 +18,7 @@ Usage:
   astrale-domain <command> [options]
 
 Commands:
-  dev <environment>       Remotely deploy and watch one Project Environment.
+  dev [environment]       Remotely deploy and watch one Project Environment.
   build                   Build and verify without deploying.
   deploy <environment>    Deploy and optionally install one Environment.
   test                    Run Project tests, optionally against one Environment.
@@ -34,10 +34,10 @@ const COMMAND_HELP = Object.freeze({
     dev: `Build, verify, remotely deploy, and watch one Project Environment.
 
 Usage:
-  astrale-domain dev <environment> [options]
+  astrale-domain dev [environment] [options]
 
 Arguments:
-  environment             Required Project Environment name.
+  environment             Project Environment name; defaults to development.
 
 Options:
   --environment <name>    Select the environment without a positional argument.
@@ -53,6 +53,7 @@ Options:
   -h, --help              Show help for dev.
 
 Behavior:
+  The selected Environment must exist; no other Environment is chosen as a fallback.
   Builds and verifies the Application, Runtime, frontend, and adapter artifact, then
   deploys it through the selected Environment. It never starts a local Worker,
   Vite server, or tunnel. Imported source changes produce serialized remote updates;

package/dist/tooling/linter/policy/generated.js

@@ -1,7 +1,7 @@
 /** Generated from the validated Domain knowledge catalog. Regenerate with pnpm sync:linter-policy. */
-export const domainPolicyDigest = '4a3b8f2d8a058f54947224c1961500c656057e236338816983a13e5e60298b55';
+export const domainPolicyDigest = '56a1a8da10a228e3ab66502d206a53ccaa0cb76a3e723e83e971074f2c819827';
 export const domainPolicySource = Object.freeze({
-    rules: "id\tscope\tkind\tseverity\tmessage\tverification\texample\nOWN-SEMANTIC\townership\tarchitecture\terror\tEvery semantic fact, rule, representation, transition, and failure meaning has exactly one owner\tInventory declarations by meaning and report each duplicate authority or ownerless concept\tsemantic-owner.md\nMOD-SUBMODULE\tmodules\tstructure\terror\tEvery semantic source file lives in a dedicated semantic submodule or its registered layer facade\tClassify every layer-root source file and report files outside the registered facade or public index\tsemantic-owner.md\nMOD-REQUIRED\tmodules\tstructure\terror\tEvery required layer and root file declared by the injected layout exists\tCompare admitted project entries with required layout entries and report each missing path\trequired-layout.md\nMOD-GOVERNED\tmodules\tstructure\terror\tEvery source file admitted by the Domain compilation scope belongs to a declared layer or supported root\tClassify admitted source paths after declared workspace and tooling delegation and report each unowned path\tgoverned-source.md\nROOT-FACADE\troots\tstructure\terror\tEvery registered layer facade is exposed through a curated public index\tInspect each layer index and facade and report private-owner behavior or misplaced facade declarations\tpackage-facade.md\nROOT-COMPOSE\troots\tstructure\terror\tPackage roots compose only policy-backed Schema, Runtime, frontend deployment, native Routes, Migrations, Provider-backed Integrations, and supported package journeys\tInspect declared composition and package roots and report behavior, provider protocol logic, recursive barrels, or unsupported exports\tcomposition-root.md\nROOT-PACKAGE\troots\tevidence\terror\tEvery public Schema package subpath maps one admitted source entrypoint to its deterministic published declaration and JavaScript targets\tCompare source and publish exports and reject missing duplicate non-Schema locally linked generated or Kernel-leaking package artifacts\tmulti-domain-package.md\nDEP-ALLOWLIST\tdependencies\tdependency\terror\tEvery direct cross-layer import and its runtime or type-only kind appears in the dependency allowlist and dependencies between distinct layers are acyclic\tResolve source imports, reject every absent or kind-mismatched edge, and detect cycles after excluding evidence edges\tsemantic-owner.md\nIMP-FACADE\timports\tdependency\terror\tEvery cross-submodule import uses the semantic owner's facade and every foreign Domain import uses its public package facade\tResolve imports and report private deep paths outside the importing submodule\tcross-domain.md\nIMP-SDK-BOUNDARY\timports\tdependency\terror\tDomain source imports Kernel Core and DSL authoring values only through semantic SDK subpaths\tInspect every static and literal dynamic import and report module specifiers rooted at @astrale-os/kernel-core or @astrale-os/kernel-dsl\tsdk-boundary.md\nIMP-LAYER-ALIAS\timports\tdependency\terror\tEvery local import crossing a layer or semantic-submodule boundary uses the registered # layer alias\tResolve relative imports and report each one whose target leaves the importing semantic submodule\tlayer-aliases.md\nIMP-ALIAS-CFG\timports\tdependency\terror\tPackage and TypeScript resolution exactly implement each active layer-facade and semantic-submodule alias\tCompare active and required layers with the injected alias registry and report missing, undeclared, or drifted mappings\talias-configuration.md\nIMP-STATIC\timports\tdependency\terror\tProduction dependency edges use analyzable static ESM declarations or literal import calls\tReject require calls, import-equals declarations, nonliteral import calls, and unresolved static dependency forms\tstatic-imports.md\nTYP-OWNER\ttypes\tarchitecture\terror\tEvery type and reusable expected error is colocated with the semantic concept that defines its meaning\tTrace each declaration to its semantic authority and report catch-all or remotely owned values\texpected-failure.md\nERR-EXPECTED\terrors\tdataflow\terror\tBoundaries map only declared expected failures and propagate unexpected defects\tInspect catches and result mappings and report broad fallback, swallowed defects, or mappings without a declared source failure\texpected-failure.md\nTST-NO-PROD-IMP\ttests\tdependency\terror\tProduction source imports no root or colocated Test artifact\tResolve production imports and report targets under Root Tests, __tests__, or test, spec, bench, and perf source files\ttest-import-boundary.md\nABS-EARNED\tabstractions\tarchitecture\terror\tAn invariant or real boundary earns an abstraction; reuse alone requires two independent consumers and no duplicated semantic behavior\tIdentify the invariant, boundary, or independent consumers for each abstraction and report reuse wrappers that duplicate an owner's semantics\tsemantic-owner.md\nABS-NO-REPO\tabstractions\tarchitecture\terror\tDomain source places no collection-shaped persistence facade between business code and canonical Query or Mutation definitions\tInspect persistence-facing contracts and report abstractions that replace graph identity, traversal, observation, or atomic change semantics\tsemantic-owner.md\nABS-CANON-GRAPH\tabstractions\tdeclaration\terror\tDomain source declares no alternate Query or Mutation language, AST, compiler, planner, or wire representation\tInspect graph-related declarations and report semantics not identical to canonical Kernel Query or Mutation values\tsemantic-owner.md\nTRUST-ADMIT-ONCE\ttrust\tdataflow\terror\tEvery untrusted value is admitted or translated exactly once at its owning boundary\tTrace values from each external boundary and report missing admission or repeated structural validation\texpected-failure.md\nQLT-EXHAUSTIVE\tquality\tbehavior\terror\tEvery closed alternative is handled exhaustively and no required failure becomes placeholder success\tTrace closed unions and failure paths and report permissive defaults, placeholder success, or catch-and-continue behavior\texpected-failure.md\nQLT-CANON-VALUES\tquality\tdataflow\terror\tNo unchecked cast fabricates a canonical Kernel identity, QueryAST, MutationAST, or admitted schema value\tScan casts to canonical values and require an owning constructor or decoder for each\tsemantic-owner.md\nQLT-DEF-IDS\tquality\tdeclaration\terror\tEvery top-level Query, Mutation, and Migration definition has a stable literal ID unique in its owning namespace\tExtract top-level definition IDs and report missing, dynamic, malformed, or duplicate values\tdefinition-identities.md\nQLT-TYPED-COORD\tquality\tdeclaration\terror\tQueries and Mutations derive graph coordinates from resolved DSL definitions instead of raw string or structural reconstruction\tReject raw PropertyKey calls and structural ClassPath objects; require canonical resolved Classes Properties and keys at graph boundaries\ttyped-coordinates.md\nNODE-INHERITED\tnodes\tdeclaration\terror\tNo Node Class redeclares name, description, createdAt, or updatedAt inherited from Named, Descriptable, and Timestamped\tScan Node Class Properties and report each inherited field redeclaration\tsemantic-owner.md\nDOM-PUBLIC-DEPS\tdomains\tdependency\terror\tEvery directly referenced foreign-Domain graph declaration has one exact Schema dependency\tResolve foreign Schema, Query, and Mutation graph references and report each package without one exact declared Schema dependency\tcross-domain.md\nDOM-CALL-INT\tdomains\tdependency\terror\tEvery cross-Domain callable invocation implements a consumer-owned Integration inside a Provider and uses only the remote Domain's public facade\tTrace foreign callable invocations and report direct Action or Workflow calls, missing Integration contracts, non-Provider call sites, or private remote imports\tremote-domain-call.md\nDOM-ATOMICITY\tdomains\tbehavior\terror\tA cross-Domain change claims atomicity only when it is one MutationAST on one graph; calls combined with other effects are Workflow steps\tTrace atomicity and effect claims and report multiple commits, service boundaries, or foreign calls combined in a Action\tcross-domain.md\nSCH-SUBMODULE\tschema\tstructure\terror\tEvery Schema source path belongs to the registered facade, one canonical shared declaration kind, or one business-module facade or canonical declaration kind\tClassify admitted Schema source paths and report flat files or source-bearing directories outside the canonical Schema vocabulary\tschema-facade.md\nSCH-ONE-DECL\tschema\tdeclaration\terror\tEvery Schema declaration leaf file exports exactly one locally authored declaration of its directory kind and every declaration-kind index is a curated facade\tInspect runtime exports in Classes, Functions, Policies, States, and Views; resolve canonical SDK constructor origins and report zero, several, re-exported, aggregated, wrong-kind, or index-owned values\tdeclaration-file.md\nSCH-DECL-ONLY\tschema\tdeclaration\terror\tSchema performs no handler execution, Query execution, Mutation submission, Integration call, Workflow step, or Provider call\tResolve Schema imports and call graphs and require zero excluded operations\tpublication-callables.md\nSCH-EXACT-TYPES\tschema\tdeclaration\terror\tSchema authoring values preserve their exact inferred DSL types instead of widening to generic builder contracts\tScan Schema declarations and action returns for explicit generic builder authoring annotations\tschema-facade.md\nSCH-ICON-REQUIRED\tschema\tdeclaration\terror\tEvery Node Class must explicitly declare one admitted SVG icon\tInspect each SDK nodeClass and Node-kind defineClass declaration and report statically proven missing icon values while preserving opaque configurations as indeterminate\tclass-icon.md\nSCH-ICON-NEUTRAL\tschema\tdeclaration\twarning\tEvery neutral Node Class icon should be replaced with a meaningful icon\tInspect each SDK nodeClass and Node-kind defineClass declaration and report explicit classIcon.neutral or exact neutral SVG values\tclass-icon.md\nSCH-POLICY-AUTH\tschema\tdeclaration\terror\tCallable authority and existential Node scope are declared explicitly through Policy and Action implementations add no private authorization rule\tTrace callable admission and existential Node binders; report hidden authority or an ambiguous Node extent\tpolicy.md\nSCH-STATE-SOURCE\tschema\tdeclaration\terror\tEvery persisted StateMachine vocabulary originates from an exported authority in the same Schema business module rather than a copied literal set\tResolve exact StateMachine and stateProperty origins; report same-owner copied literals and reject cross-module association\tarticle-schema.md\nSCH-STATE-RELATION\tschema\tdeclaration\terror\tEvery StateMachine is one exported static immutable finite relation without parallel vocabulary authorities\tInspect Schema module machines and exported sibling values for split or copied topology\tarticle-status.md\nSCH-STATE-PURE\tschema\tdeclaration\terror\tStateMachine topology contains no behavior, effects, guards, clocks, retry, recovery, or orchestration\tInspect files that declare StateMachine authorities for behavioral exports, boundary imports, and effectful calls\tstate-pure.md\nRUL-SYNC\trules\tbehavior\terror\tEvery Rule is synchronous and returns no Promise, continuation, generator, or asynchronous iterator\tInspect Rule signatures and result types and reject asynchronous forms\tnormalization.md\nRUL-PURE\trules\tbehavior\terror\tRules perform no I/O and depend on no graph executor or Domain execution boundary\tResolve imports and effect origins, permitting pure standard value transformations while reporting conclusive I/O and Domain execution dependencies\tpublish-eligibility.md\nRUL-EXPL-FACTS\trules\tbehavior\terror\tEvery clock value, random value, identity, limit, and environmental observation used by a Rule is an explicit input\tTrace every value source and report reads from ambient state, globals, process state, or hidden singletons\ttime-facts.md\nRUL-CLOSED-DEC\trules\tbehavior\terror\tEvery expected business alternative is represented by a closed decision value rather than thrown control flow\tInspect Rule branches and report expected alternatives represented by exceptions or open optional fields\tpublish-eligibility.md\nQRY-CANON\tqueries\tdataflow\terror\tEvery graph request produced by a Query definition is one canonical QueryAST built through Kernel Query APIs\tTrace request construction and reject every non-canonical graph document\tfiltered-query.md\nQRY-CONTRACT\tqueries\tdataflow\terror\tA Query owns its input, observation, optional business projection, pagination, and expected failures\tInspect each Query definition and report a required concern owned elsewhere or omitted\tquery-transforms.md\nQRY-SINGLE\tqueries\tdataflow\terror\tEvery authored single Query definition declares exactly one build callback and at most one project callback\tInspect definition properties and canonical roots; report opaque helper origins as ambiguity rather than assuming cardinality\tsingle-query.md\nQRY-COMPOSE-TYPED\tqueries\tdataflow\terror\tA composite Query constructs one closed QueryPlan containing only typed single-Query leaves, symbolic output references, and explicit result composition\tInspect plan construction, report unresolved call origins as ambiguity, and reject nested composites, raw sessions, graph clients, result-time callbacks, arbitrary promises, or Domain effects\tdependent-query.md\nQRY-COMPOSE-STABLE\tqueries\tdeclaration\terror\tEvery composite Query leaf has a stable semantic literal ID unique within its definition\tInspect declared Query leaves and reject dynamic, malformed, or duplicate leaf identifiers\tdependent-query.md\nQRY-COLL-FANOUT\tqueries\tdataflow\twarning\tThree or more independent same-kind complete-Class collection leaves use one explicit query.union group\tInfer collection kind from canonical definition types and print the direct named replacement plus logical and physical plan counts\tcollection-union.md\nQRY-PROJECT-PURE\tqueries\tdataflow\terror\tEvery Query project callback is synchronous and performs only pure value transformation\tInspect project callback syntax and call graphs and report asynchronous continuation, I/O, mutation, nondeterminism, hidden query execution, or effects\tprojection.md\nQRY-SNAPSHOT\tqueries\tdataflow\terror\tA composite or paginated Query makes no point-in-time graph snapshot claim beyond one Kernel invocation\tReject shared-snapshot claims across leaves unions or continuations and route stronger consistency to an explicit Kernel facility\tdependent-query.md\nMUT-PLAN-REQ\tmutations\tdependency\terror\tEvery Provision plan declares the exact Kernel Function and foreign Class authority it uses\tInspect SDK MutationAST builders and Kernel Provision calls and match every foreign Class operation and Provision invocation to Application requirements\tprovision-plan.md\nMUT-CANON\tmutations\tdataflow\terror\tEvery Mutation definition builds one synchronous change through the canonical builder and constructs no alternate or nested graph document\tInspect every definition build callback and reject missing, asynchronous, alternate, or nested Mutation construction\tatomic-mutation.md\nMUT-CONTRACT\tmutations\tdataflow\terror\tA Mutation owns its input, preconditions, operations, optional business projection, and expected failures\tInspect each definition and report required mutation semantics owned elsewhere or omitted\tcreate-aggregate.md\nMUT-PRECONDS\tmutations\tdataflow\terror\tRules decide eligibility and every live graph condition required for safety is encoded as a precondition in the same MutationAST\tMap decisions to preconditions and report duplicated eligibility or safety enforced only by an earlier observation\tconditional-update.md\nMUT-FRAGMENTS\tmutations\tdataflow\terror\tReusable fragments receive the callback-scoped MutationBuilder and contribute only to the same MutationAST\tResolve fragment signatures and calls and reject escaped builders, opaque documents, or nested MutationAST construction\tmutation-fragments.md\nMUT-PURE\tmutations\tdataflow\terror\tMutation definitions perform no session call, external effect, retry, compensation, or second submission\tScan definition call graphs and require zero excluded operations\tedge-change.md\nMUT-MULTI-WFL\tmutations\tdataflow\terror\tA change requiring several MutationAST values is a Workflow and is never exposed as one atomic Mutation\tTrace multi-commit changes and report definitions or names claiming single-mutation atomicity\tdelete-node.md\nMUT-STATE-INITIAL\tmutations\tdataflow\terror\tEvery StateMachine-backed node is created from its machine's initial state\tResolve machine-backed Property initializers and require the canonical machine.initial value rather than a copied state literal\tstate-transition.md\nMUT-STATE-ATOMIC\tmutations\tdataflow\terror\tEvery persisted machine-state change consumes one allowed decision and commits its stale-state precondition and update in the same MutationAST\tInspect machine-backed writes and require transition with the canonical Schema module machine and one allowed decision; reject direct target writes and split precondition updates\tstate-transition.md\nFNC-ONE-IMPL\tfunctions\tbehavior\terror\tEvery registered handler binding resolves to exactly one implementation owned by one semantic Functions submodule\tResolve the handler registry and report non-Action owners or duplicate registrations; SDK typing owns callable exhaustiveness\tsynchronous-result.md\nFNC-ONE-OP\tfunctions\tbehavior\terror\tEvery Action performs one terminal semantic operation; only a native binary compatibility Action may precede its Integration call with one exact-receiver Query\tTrace every path and report several terminal effects, writes before effects, non-receiver prerequisite reads, or hidden orchestration\tsingle-operation.md\nFNC-OP-KINDS\tfunctions\tbehavior\terror\tA semantic asynchronous operation is one Query definition, Mutation definition, or Integration call\tClassify every awaited effect and report operations outside the three allowed kinds\tintegration-operation.md\nFNC-BOUNDARIES\tfunctions\tbehavior\terror\tActions use invocation-bound query and mutate executors with admitted union authority by default, explicit caller self or union graph partitions when narrowing or naming authority, plus declared Integrations; Providers or foreign Domains are never imported\tInspect context use, authority-mode selection, dependencies, imports, and failure mapping; report raw or unbound graph executors, implicit privilege, concrete or foreign dependencies, broad mapping, or swallowed defects\tremote-integration.md\nFNC-BINARY-RESULT\tfunctions\tbehavior\terror\tA binary Action returns detached buffered bytes or streaming bytes with admitted media type status and application headers without collecting or value-framing a provider stream\tExercise buffered and streaming results through their native route; verify exact bytes status headers cancellation and invalid output rejection\tnative-byte-response.md\nFNC-MULTISTEP\tfunctions\tbehavior\terror\tEvery Workflow definition contains at least two distinct semantic asynchronous operation sites\tInventory operation sites in the definition and report fewer than two; early exit, rejection, and recovery paths may execute fewer\tpublication-workflow.md\nFNC-STEP-EFFECTS\tfunctions\tbehavior\terror\tEvery semantic asynchronous operation maps to one named step.run boundary\tTrace effects and report operations outside step.run\tpublication-workflow.md\nFNC-STEP-IDS\tfunctions\tbehavior\terror\tEvery step identifier is a stable non-empty kebab-case literal unique within its Workflow\tExtract step identifiers and reject dynamic, malformed, empty, or duplicate values\tpublication-workflow.md\nFNC-NO-NEST\tfunctions\tbehavior\terror\tNo step.run callback invokes another step.run directly or through a reachable helper\tInspect callback call graphs and report every nested step.run path\tpublication-workflow.md\nFNC-INT-TYPES\tfunctions\tdeclaration\terror\tWorkflow Integration requirements derive from declared Integration definitions and the SDK projects their clients\tReject Workflow-owned operation interfaces and require its definition generic to reference the declared Integration registry\tcross-domain-workflow.md\nFNC-ONE-OP-STEP\tfunctions\tbehavior\terror\tEvery step owns exactly one semantic asynchronous operation\tTrace each step and report zero or several independently failing operations\tpublication-workflow.md\nFNC-STATE-CODEC\tfunctions\tbehavior\terror\tEvery step result and inter-step value is undefined or portable JSON data\tInspect step values and report actions, clients, symbols, bigint, cycles, or class instances\tpublication-workflow.md\nFNC-RECOVERY\tfunctions\tbehavior\terror\tWhen compensation or unknown-outcome branches exist, they are explicit and rely only on declared operation semantics\tInspect existing recovery branches and report guessed outcomes or compensation without exact evidence\tpublication-workflow.md\nFNC-XDOM-INT\tfunctions\tbehavior\terror\tA Workflow invokes another Domain only through a declared Integration and imports no foreign Domain\tResolve Workflow imports and operations and report foreign Domain imports or calls without Integration ownership\tcross-domain-workflow.md\nMIG-EXACT-REVS\tmigrations\tdataflow\terror\tEvery Migration declares exactly one source revision and one target revision for the same Domain origin\tParse Migration descriptors and reject missing, equal, ambiguous, cross-origin, or dynamically selected revisions\texact-revisions.md\nMIG-APP-DATA\tmigrations\tdataflow\terror\tMigrations transform application-owned facts only and own no schema projection, physical representation, deployment, backup, or external import\tClassify every transformed value and operation and report responsibilities outside application data\trewrite-values.md\nMIG-DEDICATED-CTX\tmigrations\tdataflow\terror\tMigration execution uses only its dedicated source reader, target writer, durable step context, revision-compatible Rules, and generic Utils\tResolve imports and calls and reject ordinary Actions, Workflows, Queries, Mutations, Integrations, Providers, Views, UI, or provider access\texact-revisions.md\nMIG-RESTART-SAFE\tmigrations\tdataflow\terror\tEvery Migration page is idempotent and resumes from a stable checkpoint without reinterpreting accepted target output\tInterrupt before and after every page commit, resume repeatedly, and compare target facts and checkpoints with uninterrupted execution\trestart-safe.md\nMIG-TARGET-PROOF\tmigrations\tdataflow\terror\tA Migration completes only after bounded source coverage and target-revision validation account for every selected source fact\tInject omitted, duplicated, invalid, and over-budget facts and require completion to fail with exact evidence\tverify-target.md\nMIG-DESTRUCTIVE\tmigrations\tdataflow\terror\tEvery destructive or irreversible transform declares and accounts for its intended loss and exposes declared expected failures\tTrace removals and irreversible rewrites and report undeclared or unaccounted loss, open failures, or catch-and-continue behavior\tremove-facts.md\nINT-BOUNDARY\tintegrations\tarchitecture\terror\tEvery Integration represents required behavior across an external, remote-Domain, substitution, process, or trust boundary\tIdentify the boundary for every contract and report behavior that can remain ordinary local Domain code\tpayment-authorization.md\nINT-NEUTRAL\tintegrations\tdeclaration\terror\tEvery Integration owns provider-neutral requests, evidence, correlation, idempotency, trust, and expected failure semantics needed by consumers\tInspect consumers and contracts and report provider fields or missing stable boundary semantics\tid-allocation.md\nINT-PURE\tintegrations\tdependency\terror\tIntegrations remain provider- and execution-boundary-neutral and import no concrete client, credential, configuration, Provider, Action, or Workflow\tResolve runtime and provider imports and report every conclusive concrete or execution-boundary dependency\tdocument-signing.md\nINT-ABILITY-NAME\tintegrations\tstructure\terror\tIntegration submodules are named by required ability and never mirror Schema entities mechanically\tCompare Integration and Schema submodules and report a contract without an independent boundary ability\tobject-storage.md\nRTE-RECIPE\troutes\tdeclaration\terror\tEvery native HTTP Route targets exactly one admitted Action or Workflow recipe\tResolve every route target and report forged missing or several recipes\taction-route.md\nRTE-MAPPING\troutes\tdataflow\terror\tEvery callable input field and instance receiver is mapped exactly once from path query header method or body input\tCompile each route against its resolved callable and reject incomplete ambiguous or unknown mappings\tinstance-route.md\nRTE-CREDENTIAL\troutes\tdataflow\terror\tEvery external credential source is explicit and is never also mapped as callable input\tCompile credential and input mappings and reject duplicate reserved or implicit authority sources\tcredential-route.md\nRTE-ONE-FILE\troutes\tstructure\terror\tEvery Route declaration has one business-intent kebab-case file and Routes composition contains no inline declaration\tInventory route declarations and report generic grouped or inline ownership\tapplication-routes.md\nPRV-INT-IMPL\tproviders\tarchitecture\terror\tEvery Provider implements one or more declared Integrations across a named external or remote-Domain boundary\tIdentify the boundary and implemented contracts and report a Provider without both\tpayment-provider.md\nPRV-BOUNDARY-NAME\tproviders\tstructure\terror\tProvider submodules are named by external system, protocol, or trust boundary rather than Domain entity\tInspect every submodule name and report one justified only by Schema vocabulary\tobject-storage-provider.md\nPRV-ADMIT-RESULT\tproviders\tdataflow\terror\tEvery boundary value is admitted before Integration evidence and recognized boundary failures become stable Integration failures\tTrace input and failure paths and report missing admission, leaked boundary errors, broad mapping, or swallowed defects\twebhook-admission.md\nPRV-NO-DOMAIN\tproviders\tdependency\terror\tProviders perform no local Domain graph operation, business decision, local Action call, or Workflow orchestration\tResolve Provider imports and call graphs and require zero excluded operations\tboundary-composition.md\nPRV-XDOM-TYPED\tproviders\tdependency\terror\tRemote-Domain Providers pass SDK-derived typed callable references to the caller-bound invocation capability without never casts\tInspect Provider execution invoke calls and reject references not constructed through SDK reference, opaque or fabricated references, and never-cast arguments\tremote-domain.md\nPRV-XDOM-REQ\tproviders\tdependency\terror\tEvery statically resolved remote-Domain Provider invocation has one exact Application Function requirement\tMatch each invocation-bound public callable reference to the same foreign facade and Function selector under Application requirements; preserve opaque references or composition as indeterminate\tremote-domain.md\nPRV-XDOM-PUBLIC\tproviders\tdependency\terror\tA remote-Domain Provider uses the remote public facade and invokes at most one public callable per Integration operation\tResolve receiver and facade origins for each remote operation and report private access, missing Integration ownership, unrelated calls, or several public invocations\tremote-domain.md\nVIW-PROJECTION\tviews\tdeclaration\terror\tEvery View converts public Domain values or named Query observations into UI props and connects each action to a named bounded Mutation or public callable contract\tInspect View outputs and actions and report behavior without a Schema, Query, UI, Mutation, Rule, or public callable owner\tdetail-view.md\nVIW-SCHEMA-DECL\tviews\tdeclaration\terror\tSchema owns every DSL View declaration and Views declares no Domain schema construct\tScan View declarations and reject Classes, Properties, Policies, Methods, Actions, or DSL Views\tarticle-list.md\nVIW-NO-COMPOSE\tviews\tdeclaration\terror\tApplication owns frontend deployment composition and Views never calls defineFrontend\tResolve direct imported defineFrontend calls in Views and report SDK constructor calls while ignoring unrelated local functions\tfrontend-composition.md\nVIW-DEPS\tviews\tdependency\terror\tViews import only Schema and its StateMachines, pure Rules, named Queries, bounded named Mutations, UI, shell-react primitives, public callable contracts, and presentation libraries\tInspect resolved imports and report dependencies or raw graph APIs outside the allowlist\tnavigation.md\nVIW-ACTIONS\tviews\tdataflow\terror\tEvery View action executes a named caller-authorized atomic Mutation or invokes a public callable; presentation state is never authorization evidence\tTrace action and authority paths and report inline or raw graph documents, elevated or effectful Mutation use, private Action imports, direct Integration calls, or authority derived from presentation\tform-actions.md\nUI-PRES-DEPS\tui\tdependency\terror\tEvery UI import is a sibling UI module or an external library used only for presentation\tInspect resolved imports and used APIs and report Domain, I/O, persistence, authorization, routing, or provider behavior\tstatus-panel.md\nUI-NO-DOMAIN\tui\tdependency\terror\tUI imports no Domain layer or Domain package facade\tResolve the UI import graph and require zero Domain paths\tresult-list.md\nUI-PURE\tui\tbehavior\terror\tUI performs no I/O, graph access, storage, authorization, business validation, provider call, routing, or Domain result mapping\tInspect components and hooks and report the exact excluded call or branch\tconfirmation-dialog.md\nUI-CALLBACKS\tui\tdataflow\terror\tUI accepts presentation props and forwards intent through callbacks without constructing Domain commands\tInspect props and event handlers and report Domain identities, command construction, or business decisions\tform.md\nUTL-DOM-AGNOSTIC\tutils\tarchitecture\terror\tEvery Utils export is Domain-agnostic and contains no Domain declaration, identity, decision, graph definition, or Workflow step\tInspect signatures and implementations and report the exact Domain concept or business behavior\tresult.md\nUTL-REUSED\tutils\tarchitecture\terror\tEvery Utils extension serves two independent semantic consumers or one package-wide execution boundary\tList direct consumers and report an extension satisfying neither condition\tjson-codec.md\nUTL-PUBLIC-DEPS\tutils\tdependency\terror\tUtils imports only public Kernel, DSL, SDK, standard-library, and sibling Utils modules\tResolve the Utils import graph and reject Domain layers, Providers, or private package paths\tjson-codec.md\nUTL-LIGHTWEIGHT\tutils\tarchitecture\terror\tUtils is private and owns no durable engine, planner, compiler, Repository, service locator, or dependency container\tInspect package exports and declarations and report public exposure or any forbidden framework machinery\tresult.md\nSCR-OPERATOR\tscripts\tbehavior\terror\tEvery root Script implements a supported operator workflow with declared inputs, outcomes, failures, and proof\tInspect each Script contract and report disposable tasks or missing operator semantics\tbackup.md\nSCR-PUBLIC-DEPS\tscripts\tbehavior\terror\tScripts import only dependency-DAG-authorized public facades, standard libraries, and operator libraries and define no Domain behavior\tResolve imports and inspect branches and report private paths, business decisions, graph definitions, or callable behavior\tupgrade.md\nSCR-TEST-DRIVERS\tscripts\tbehavior\terror\tDisposable setup, fixtures, resets, and scenario drivers live under tests/scripts rather than root Scripts\tClassify every Script by supported operator contract and report evidence-only programs at the root\trestore.md\nTST-SYS-OWNER\ttests\tevidence\terror\tRoot Tests owns cross-layer journeys, environments, harnesses, scenarios, seeds, fixtures, and disposable scripts\tInventory evidence support code and report cross-layer artifacts outside Tests or production semantics inside Tests\tmigration-scenario.md\nTST-COLOCATED\ttests\tevidence\terror\tEvery semantic production submodule owns focused evidence in its local __tests__ directory\tJoin production submodules to focused test directories and report missing owners\tfocused-rule.md\n",
+    rules: "id\tscope\tkind\tseverity\tmessage\tverification\texample\nOWN-SEMANTIC\townership\tarchitecture\terror\tEvery semantic fact, rule, representation, transition, and failure meaning has exactly one owner\tInventory declarations by meaning and report each duplicate authority or ownerless concept\tsemantic-owner.md\nMOD-SUBMODULE\tmodules\tstructure\terror\tEvery semantic source file lives in a dedicated semantic submodule or its registered layer facade\tClassify every layer-root source file and report files outside the registered facade or public index\tsemantic-owner.md\nMOD-REQUIRED\tmodules\tstructure\terror\tEvery required layer and root file declared by the injected layout exists\tCompare admitted project entries with required layout entries and report each missing path\trequired-layout.md\nMOD-GOVERNED\tmodules\tstructure\terror\tEvery source file admitted by the Domain compilation scope belongs to a declared layer or supported root\tClassify admitted source paths after declared workspace and tooling delegation and report each unowned path\tgoverned-source.md\nROOT-FACADE\troots\tstructure\terror\tEvery registered layer facade is exposed through a curated public index\tInspect each layer index and facade and report private-owner behavior or misplaced facade declarations\tpackage-facade.md\nROOT-COMPOSE\troots\tstructure\terror\tPackage roots compose only policy-backed Schema, Runtime, frontend deployment, native Routes, Migrations, Provider-backed Integrations, and supported package journeys\tInspect declared composition and package roots and report behavior, provider protocol logic, recursive barrels, or unsupported exports\tcomposition-root.md\nROOT-PACKAGE\troots\tevidence\terror\tEvery public Schema package subpath maps one admitted source entrypoint to its deterministic published declaration and JavaScript targets\tCompare source and publish exports and reject missing duplicate non-Schema locally linked generated or Kernel-leaking package artifacts\tmulti-domain-package.md\nDEP-ALLOWLIST\tdependencies\tdependency\terror\tEvery direct cross-layer import and its runtime or type-only kind appears in the dependency allowlist and dependencies between distinct layers are acyclic\tResolve source imports, reject every absent or kind-mismatched edge, and detect cycles after excluding evidence edges\tsemantic-owner.md\nIMP-FACADE\timports\tdependency\terror\tEvery cross-submodule import uses the semantic owner's facade and every foreign Domain import uses its public package facade\tResolve imports and report private deep paths outside the importing submodule\tcross-domain.md\nIMP-SDK-BOUNDARY\timports\tdependency\terror\tDomain source imports Kernel Core and DSL authoring values only through semantic SDK subpaths\tInspect every static and literal dynamic import and report module specifiers rooted at @astrale-os/kernel-core or @astrale-os/kernel-dsl\tsdk-boundary.md\nIMP-LAYER-ALIAS\timports\tdependency\terror\tEvery local import crossing a layer or semantic-submodule boundary uses the registered # layer alias\tResolve relative imports and report each one whose target leaves the importing semantic submodule\tlayer-aliases.md\nIMP-ALIAS-CFG\timports\tdependency\terror\tPackage and TypeScript resolution exactly implement each active layer-facade and semantic-submodule alias\tCompare active and required layers with the injected alias registry and report missing, undeclared, or drifted mappings\talias-configuration.md\nIMP-STATIC\timports\tdependency\terror\tProduction dependency edges use analyzable static ESM declarations or literal import calls\tReject require calls, import-equals declarations, nonliteral import calls, and unresolved static dependency forms\tstatic-imports.md\nTYP-OWNER\ttypes\tarchitecture\terror\tEvery type and reusable expected error is colocated with the semantic concept that defines its meaning\tTrace each declaration to its semantic authority and report catch-all or remotely owned values\texpected-failure.md\nERR-EXPECTED\terrors\tdataflow\terror\tBoundaries map only declared expected failures and propagate unexpected defects\tInspect catches and result mappings and report broad fallback, swallowed defects, or mappings without a declared source failure\texpected-failure.md\nTST-NO-PROD-IMP\ttests\tdependency\terror\tProduction source imports no root or colocated Test artifact\tResolve production imports and report targets under Root Tests, __tests__, or test, spec, bench, and perf source files\ttest-import-boundary.md\nABS-EARNED\tabstractions\tarchitecture\terror\tAn invariant or real boundary earns an abstraction; reuse alone requires two independent consumers and no duplicated semantic behavior\tIdentify the invariant, boundary, or independent consumers for each abstraction and report reuse wrappers that duplicate an owner's semantics\tsemantic-owner.md\nABS-NO-REPO\tabstractions\tarchitecture\terror\tDomain source places no collection-shaped persistence facade between business code and canonical Query or Mutation definitions\tInspect persistence-facing contracts and report abstractions that replace graph identity, traversal, observation, or atomic change semantics\tsemantic-owner.md\nABS-CANON-GRAPH\tabstractions\tdeclaration\terror\tDomain source declares no alternate Query or Mutation language, AST, compiler, planner, or wire representation\tInspect graph-related declarations and report semantics not identical to canonical Kernel Query or Mutation values\tsemantic-owner.md\nTRUST-ADMIT-ONCE\ttrust\tdataflow\terror\tEvery untrusted value is admitted or translated exactly once at its owning boundary\tTrace values from each external boundary and report missing admission or repeated structural validation\texpected-failure.md\nQLT-EXHAUSTIVE\tquality\tbehavior\terror\tEvery closed alternative is handled exhaustively and no required failure becomes placeholder success\tTrace closed unions and failure paths and report permissive defaults, placeholder success, or catch-and-continue behavior\texpected-failure.md\nQLT-CANON-VALUES\tquality\tdataflow\terror\tNo unchecked cast fabricates a canonical Kernel identity, QueryAST, MutationAST, or admitted schema value\tScan casts to canonical values and require an owning constructor or decoder for each\tsemantic-owner.md\nQLT-DEF-IDS\tquality\tdeclaration\terror\tEvery top-level Query, Mutation, and Migration definition has a stable literal ID unique in its owning namespace\tExtract top-level definition IDs and report missing, dynamic, malformed, or duplicate values\tdefinition-identities.md\nQLT-TYPED-COORD\tquality\tdeclaration\terror\tQueries and Mutations derive graph coordinates from resolved DSL definitions instead of raw string or structural reconstruction\tReject raw PropertyKey calls and structural ClassPath objects; require canonical resolved Classes Properties and keys at graph boundaries\ttyped-coordinates.md\nNODE-INHERITED\tnodes\tdeclaration\terror\tNo Node Class redeclares name, description, createdAt, or updatedAt inherited from Named, Descriptable, and Timestamped\tScan Node Class Properties and report each inherited field redeclaration\tsemantic-owner.md\nDOM-PUBLIC-DEPS\tdomains\tdependency\terror\tEvery directly referenced foreign-Domain graph declaration has one exact Schema dependency\tResolve foreign Schema, Query, and Mutation graph references and report each package without one exact declared Schema dependency\tcross-domain.md\nDOM-CALL-INT\tdomains\tdependency\terror\tEvery cross-Domain callable invocation implements a consumer-owned Integration inside a Provider and uses only the remote Domain's public facade\tTrace foreign callable invocations and report direct Action or Workflow calls, missing Integration contracts, non-Provider call sites, or private remote imports\tremote-domain-call.md\nDOM-ATOMICITY\tdomains\tbehavior\terror\tA cross-Domain change claims atomicity only when it is one MutationAST on one graph; calls combined with other effects are Workflow steps\tTrace atomicity and effect claims and report multiple commits, service boundaries, or foreign calls combined in a Action\tcross-domain.md\nSCH-SUBMODULE\tschema\tstructure\terror\tEvery Schema source path belongs to the registered facade, one canonical shared declaration kind, or one business-module facade or canonical declaration kind\tClassify admitted Schema source paths and report flat files or source-bearing directories outside the canonical Schema vocabulary\tschema-facade.md\nSCH-ONE-DECL\tschema\tdeclaration\terror\tEvery Schema declaration leaf file exports exactly one locally authored declaration of its directory kind and every declaration-kind index is a curated facade\tInspect runtime exports in Classes, Functions, Policies, States, and Views; resolve canonical SDK constructor origins and report zero, several, re-exported, aggregated, wrong-kind, or index-owned values\tdeclaration-file.md\nSCH-DECL-ONLY\tschema\tdeclaration\terror\tSchema performs no handler execution, Query execution, Mutation submission, Integration call, Workflow step, or Provider call\tResolve Schema imports and call graphs and require zero excluded operations\tpublication-callables.md\nSCH-EXACT-TYPES\tschema\tdeclaration\terror\tSchema authoring values preserve their exact inferred DSL types instead of widening to generic builder contracts\tScan Schema declarations and action returns for explicit generic builder authoring annotations\tschema-facade.md\nSCH-ICON-REQUIRED\tschema\tdeclaration\terror\tEvery Node Class must explicitly declare one admitted SVG icon\tInspect each SDK nodeClass and Node-kind defineClass declaration and report statically proven missing icon values while preserving opaque configurations as indeterminate\tclass-icon.md\nSCH-ICON-NEUTRAL\tschema\tdeclaration\twarning\tEvery neutral Node Class icon should be replaced with a meaningful icon\tInspect each SDK nodeClass and Node-kind defineClass declaration and report explicit classIcon.neutral or exact neutral SVG values\tclass-icon.md\nSCH-POLICY-AUTH\tschema\tdeclaration\terror\tCallable authority and existential Node scope are declared explicitly through Policy and Action implementations add no private authorization rule\tTrace callable admission and existential Node binders; report hidden authority or an ambiguous Node extent\tpolicy.md\nSCH-STATE-SOURCE\tschema\tdeclaration\terror\tEvery persisted StateMachine vocabulary originates from an exported authority in the same Schema business module rather than a copied literal set\tResolve exact StateMachine and stateProperty origins; report same-owner copied literals and reject cross-module association\tarticle-schema.md\nSCH-STATE-RELATION\tschema\tdeclaration\terror\tEvery StateMachine is one exported static immutable finite relation without parallel vocabulary authorities\tInspect Schema module machines and exported sibling values for split or copied topology\tarticle-status.md\nSCH-STATE-PURE\tschema\tdeclaration\terror\tStateMachine topology contains no behavior, effects, guards, clocks, retry, recovery, or orchestration\tInspect files that declare StateMachine authorities for behavioral exports, boundary imports, and effectful calls\tstate-pure.md\nRUL-SYNC\trules\tbehavior\terror\tEvery Rule is synchronous and returns no Promise, continuation, generator, or asynchronous iterator\tInspect Rule signatures and result types and reject asynchronous forms\tnormalization.md\nRUL-PURE\trules\tbehavior\terror\tRules perform no I/O and depend on no graph executor or Domain execution boundary\tResolve imports and effect origins, permitting pure standard value transformations while reporting conclusive I/O and Domain execution dependencies\tpublish-eligibility.md\nRUL-EXPL-FACTS\trules\tbehavior\terror\tEvery clock value, random value, identity, limit, and environmental observation used by a Rule is an explicit input\tTrace every value source and report reads from ambient state, globals, process state, or hidden singletons\ttime-facts.md\nRUL-CLOSED-DEC\trules\tbehavior\terror\tEvery expected business alternative is represented by a closed decision value rather than thrown control flow\tInspect Rule branches and report expected alternatives represented by exceptions or open optional fields\tpublish-eligibility.md\nQRY-CANON\tqueries\tdataflow\terror\tEvery graph request produced by a Query definition is one canonical QueryAST built through Kernel Query APIs\tTrace request construction and reject every non-canonical graph document\tfiltered-query.md\nQRY-CONTRACT\tqueries\tdataflow\terror\tA Query owns its input, observation, optional business projection, pagination, and expected failures\tInspect each Query definition and report a required concern owned elsewhere or omitted\tquery-transforms.md\nQRY-SINGLE\tqueries\tdataflow\terror\tEvery authored single Query definition declares exactly one build callback and at most one project callback\tInspect definition properties and canonical roots; report opaque helper origins as ambiguity rather than assuming cardinality\tsingle-query.md\nQRY-COMPOSE-TYPED\tqueries\tdataflow\terror\tA composite Query constructs one closed QueryPlan containing only typed single-Query leaves, symbolic output references, and explicit result composition\tInspect plan construction, report unresolved call origins as ambiguity, and reject nested composites, raw sessions, graph clients, result-time callbacks, arbitrary promises, or Domain effects\tdependent-query.md\nQRY-COMPOSE-STABLE\tqueries\tdeclaration\terror\tEvery composite Query leaf has a stable semantic literal ID unique within its definition\tInspect declared Query leaves and reject dynamic, malformed, or duplicate leaf identifiers\tdependent-query.md\nQRY-COLL-FANOUT\tqueries\tdataflow\twarning\tThree or more independent same-kind complete-Class collection leaves use one explicit query.union group\tInfer collection kind from canonical definition types and print the direct named replacement plus logical and physical plan counts\tcollection-union.md\nQRY-PROJECT-PURE\tqueries\tdataflow\terror\tEvery Query project callback is synchronous and performs only pure value transformation\tInspect project callback syntax and call graphs and report asynchronous continuation, I/O, mutation, nondeterminism, hidden query execution, or effects\tprojection.md\nQRY-SNAPSHOT\tqueries\tdataflow\terror\tA composite or paginated Query makes no point-in-time graph snapshot claim beyond one Kernel invocation\tReject shared-snapshot claims across leaves unions or continuations and route stronger consistency to an explicit Kernel facility\tdependent-query.md\nMUT-PLAN-REQ\tmutations\tdependency\terror\tEvery Provision plan declares the exact Kernel Function and foreign Class authority it uses\tInspect SDK MutationAST builders and Kernel Provision calls and match every foreign Class operation and Provision invocation to Application requirements\tprovision-plan.md\nMUT-CANON\tmutations\tdataflow\terror\tEvery Mutation definition builds one synchronous change through the canonical builder and constructs no alternate or nested graph document\tInspect every definition build callback and reject missing, asynchronous, alternate, or nested Mutation construction\tatomic-mutation.md\nMUT-CONTRACT\tmutations\tdataflow\terror\tA Mutation owns its input, preconditions, operations, optional business projection, and expected failures\tInspect each definition and report required mutation semantics owned elsewhere or omitted\tcreate-aggregate.md\nMUT-PRECONDS\tmutations\tdataflow\terror\tRules decide eligibility and every live graph condition required for safety is encoded as a precondition in the same MutationAST\tMap decisions to preconditions and report duplicated eligibility or safety enforced only by an earlier observation\tconditional-update.md\nMUT-FRAGMENTS\tmutations\tdataflow\terror\tReusable fragments receive the callback-scoped MutationBuilder and contribute only to the same MutationAST\tResolve fragment signatures and calls and reject escaped builders, opaque documents, or nested MutationAST construction\tmutation-fragments.md\nMUT-PURE\tmutations\tdataflow\terror\tMutation definitions perform no session call, external effect, retry, compensation, or second submission\tScan definition call graphs and require zero excluded operations\tedge-change.md\nMUT-MULTI-WFL\tmutations\tdataflow\terror\tA change requiring several MutationAST values is a Workflow and is never exposed as one atomic Mutation\tTrace multi-commit changes and report definitions or names claiming single-mutation atomicity\tdelete-node.md\nMUT-STATE-INITIAL\tmutations\tdataflow\terror\tEvery StateMachine-backed node is created from its machine's initial state\tResolve machine-backed Property initializers and require the canonical machine.initial value rather than a copied state literal\tstate-transition.md\nMUT-STATE-ATOMIC\tmutations\tdataflow\terror\tEvery persisted machine-state change consumes one allowed decision and commits its stale-state precondition and update in the same MutationAST\tInspect machine-backed writes and require transition with the canonical Schema module machine and one allowed decision; reject direct target writes and split precondition updates\tstate-transition.md\nFNC-ONE-IMPL\tfunctions\tbehavior\terror\tEvery registered handler binding resolves to exactly one implementation owned by one semantic Functions submodule\tResolve the handler registry and report non-Action owners or duplicate registrations; SDK typing owns callable exhaustiveness\tsynchronous-result.md\nFNC-ONE-OP\tfunctions\tbehavior\terror\tEvery Action performs one terminal semantic operation; only a native binary compatibility Action may precede its Integration call with one exact-receiver Query\tTrace every path and report several terminal effects, writes before effects, non-receiver prerequisite reads, or hidden orchestration\tsingle-operation.md\nFNC-OP-KINDS\tfunctions\tbehavior\terror\tA semantic asynchronous operation is one Query definition, Mutation definition, or Integration call\tClassify every awaited effect and report operations outside the three allowed kinds\tintegration-operation.md\nFNC-BOUNDARIES\tfunctions\tbehavior\terror\tActions use invocation-bound query and mutate executors with installed Domain authority by default, explicit caller self or union graph partitions when selecting authority, plus declared Integrations; Providers or foreign Domains are never imported\tInspect context use, authority-mode selection, dependencies, imports, and failure mapping; report raw or unbound graph executors, implicit privilege, concrete or foreign dependencies, broad mapping, or swallowed defects\tremote-integration.md\nFNC-BINARY-RESULT\tfunctions\tbehavior\terror\tA binary Action returns detached buffered bytes or streaming bytes with admitted media type status and application headers without collecting or value-framing a provider stream\tExercise buffered and streaming results through their native route; verify exact bytes status headers cancellation and invalid output rejection\tnative-byte-response.md\nFNC-MULTISTEP\tfunctions\tbehavior\terror\tEvery Workflow definition contains at least two distinct semantic asynchronous operation sites\tInventory operation sites in the definition and report fewer than two; early exit, rejection, and recovery paths may execute fewer\tpublication-workflow.md\nFNC-STEP-EFFECTS\tfunctions\tbehavior\terror\tEvery semantic asynchronous operation maps to one named step.run boundary\tTrace effects and report operations outside step.run\tpublication-workflow.md\nFNC-STEP-IDS\tfunctions\tbehavior\terror\tEvery step identifier is a stable non-empty kebab-case literal unique within its Workflow\tExtract step identifiers and reject dynamic, malformed, empty, or duplicate values\tpublication-workflow.md\nFNC-NO-NEST\tfunctions\tbehavior\terror\tNo step.run callback invokes another step.run directly or through a reachable helper\tInspect callback call graphs and report every nested step.run path\tpublication-workflow.md\nFNC-INT-TYPES\tfunctions\tdeclaration\terror\tWorkflow Integration requirements derive from declared Integration definitions and the SDK projects their clients\tReject Workflow-owned operation interfaces and require its definition generic to reference the declared Integration registry\tcross-domain-workflow.md\nFNC-ONE-OP-STEP\tfunctions\tbehavior\terror\tEvery step owns exactly one semantic asynchronous operation\tTrace each step and report zero or several independently failing operations\tpublication-workflow.md\nFNC-STATE-CODEC\tfunctions\tbehavior\terror\tEvery step result and inter-step value is undefined or portable JSON data\tInspect step values and report actions, clients, symbols, bigint, cycles, or class instances\tpublication-workflow.md\nFNC-RECOVERY\tfunctions\tbehavior\terror\tWhen compensation or unknown-outcome branches exist, they are explicit and rely only on declared operation semantics\tInspect existing recovery branches and report guessed outcomes or compensation without exact evidence\tpublication-workflow.md\nFNC-XDOM-INT\tfunctions\tbehavior\terror\tA Workflow invokes another Domain only through a declared Integration and imports no foreign Domain\tResolve Workflow imports and operations and report foreign Domain imports or calls without Integration ownership\tcross-domain-workflow.md\nMIG-EXACT-REVS\tmigrations\tdataflow\terror\tEvery Migration declares exactly one source revision and one target revision for the same Domain origin\tParse Migration descriptors and reject missing, equal, ambiguous, cross-origin, or dynamically selected revisions\texact-revisions.md\nMIG-APP-DATA\tmigrations\tdataflow\terror\tMigrations transform application-owned facts only and own no schema projection, physical representation, deployment, backup, or external import\tClassify every transformed value and operation and report responsibilities outside application data\trewrite-values.md\nMIG-DEDICATED-CTX\tmigrations\tdataflow\terror\tMigration execution uses only its dedicated source reader, target writer, durable step context, revision-compatible Rules, and generic Utils\tResolve imports and calls and reject ordinary Actions, Workflows, Queries, Mutations, Integrations, Providers, Views, UI, or provider access\texact-revisions.md\nMIG-RESTART-SAFE\tmigrations\tdataflow\terror\tEvery Migration page is idempotent and resumes from a stable checkpoint without reinterpreting accepted target output\tInterrupt before and after every page commit, resume repeatedly, and compare target facts and checkpoints with uninterrupted execution\trestart-safe.md\nMIG-TARGET-PROOF\tmigrations\tdataflow\terror\tA Migration completes only after bounded source coverage and target-revision validation account for every selected source fact\tInject omitted, duplicated, invalid, and over-budget facts and require completion to fail with exact evidence\tverify-target.md\nMIG-DESTRUCTIVE\tmigrations\tdataflow\terror\tEvery destructive or irreversible transform declares and accounts for its intended loss and exposes declared expected failures\tTrace removals and irreversible rewrites and report undeclared or unaccounted loss, open failures, or catch-and-continue behavior\tremove-facts.md\nINT-BOUNDARY\tintegrations\tarchitecture\terror\tEvery Integration represents required behavior across an external, remote-Domain, substitution, process, or trust boundary\tIdentify the boundary for every contract and report behavior that can remain ordinary local Domain code\tpayment-authorization.md\nINT-NEUTRAL\tintegrations\tdeclaration\terror\tEvery Integration owns provider-neutral requests, evidence, correlation, idempotency, trust, and expected failure semantics needed by consumers\tInspect consumers and contracts and report provider fields or missing stable boundary semantics\tid-allocation.md\nINT-PURE\tintegrations\tdependency\terror\tIntegrations remain provider- and execution-boundary-neutral and import no concrete client, credential, configuration, Provider, Action, or Workflow\tResolve runtime and provider imports and report every conclusive concrete or execution-boundary dependency\tdocument-signing.md\nINT-ABILITY-NAME\tintegrations\tstructure\terror\tIntegration submodules are named by required ability and never mirror Schema entities mechanically\tCompare Integration and Schema submodules and report a contract without an independent boundary ability\tobject-storage.md\nRTE-RECIPE\troutes\tdeclaration\terror\tEvery native HTTP Route targets exactly one admitted Action or Workflow recipe\tResolve every route target and report forged missing or several recipes\taction-route.md\nRTE-MAPPING\troutes\tdataflow\terror\tEvery callable input field and instance receiver is mapped exactly once from path query header method or body input\tCompile each route against its resolved callable and reject incomplete ambiguous or unknown mappings\tinstance-route.md\nRTE-CREDENTIAL\troutes\tdataflow\terror\tEvery external credential source is explicit and is never also mapped as callable input\tCompile credential and input mappings and reject duplicate reserved or implicit authority sources\tcredential-route.md\nRTE-ONE-FILE\troutes\tstructure\terror\tEvery Route declaration has one business-intent kebab-case file and Routes composition contains no inline declaration\tInventory route declarations and report generic grouped or inline ownership\tapplication-routes.md\nPRV-INT-IMPL\tproviders\tarchitecture\terror\tEvery Provider implements one or more declared Integrations across a named external or remote-Domain boundary\tIdentify the boundary and implemented contracts and report a Provider without both\tpayment-provider.md\nPRV-BOUNDARY-NAME\tproviders\tstructure\terror\tProvider submodules are named by external system, protocol, or trust boundary rather than Domain entity\tInspect every submodule name and report one justified only by Schema vocabulary\tobject-storage-provider.md\nPRV-ADMIT-RESULT\tproviders\tdataflow\terror\tEvery boundary value is admitted before Integration evidence and recognized boundary failures become stable Integration failures\tTrace input and failure paths and report missing admission, leaked boundary errors, broad mapping, or swallowed defects\twebhook-admission.md\nPRV-NO-DOMAIN\tproviders\tdependency\terror\tProviders perform no local Domain graph operation, business decision, local Action call, or Workflow orchestration\tResolve Provider imports and call graphs and require zero excluded operations\tboundary-composition.md\nPRV-XDOM-TYPED\tproviders\tdependency\terror\tRemote-Domain Providers pass SDK-derived typed callable references to the caller-bound invocation capability without never casts\tInspect Provider execution invoke calls and reject references not constructed through SDK reference, opaque or fabricated references, and never-cast arguments\tremote-domain.md\nPRV-XDOM-REQ\tproviders\tdependency\terror\tEvery statically resolved remote-Domain Provider invocation has one exact Application Function requirement\tMatch each invocation-bound public callable reference to the same foreign facade and Function selector under Application requirements; preserve opaque references or composition as indeterminate\tremote-domain.md\nPRV-XDOM-PUBLIC\tproviders\tdependency\terror\tA remote-Domain Provider uses the remote public facade and invokes at most one public callable per Integration operation\tResolve receiver and facade origins for each remote operation and report private access, missing Integration ownership, unrelated calls, or several public invocations\tremote-domain.md\nVIW-PROJECTION\tviews\tdeclaration\terror\tEvery View converts public Domain values or named Query observations into UI props and connects each action to a named bounded Mutation or public callable contract\tInspect View outputs and actions and report behavior without a Schema, Query, UI, Mutation, Rule, or public callable owner\tdetail-view.md\nVIW-SCHEMA-DECL\tviews\tdeclaration\terror\tSchema owns every DSL View declaration and Views declares no Domain schema construct\tScan View declarations and reject Classes, Properties, Policies, Methods, Actions, or DSL Views\tarticle-list.md\nVIW-NO-COMPOSE\tviews\tdeclaration\terror\tApplication owns frontend deployment composition and Views never calls defineFrontend\tResolve direct imported defineFrontend calls in Views and report SDK constructor calls while ignoring unrelated local functions\tfrontend-composition.md\nVIW-DEPS\tviews\tdependency\terror\tViews import only Schema and its StateMachines, pure Rules, named Queries, bounded named Mutations, UI, shell-react primitives, public callable contracts, and presentation libraries\tInspect resolved imports and report dependencies or raw graph APIs outside the allowlist\tnavigation.md\nVIW-ACTIONS\tviews\tdataflow\terror\tEvery View action executes a named caller-authorized atomic Mutation or invokes a public callable; presentation state is never authorization evidence\tTrace action and authority paths and report inline or raw graph documents, elevated or effectful Mutation use, private Action imports, direct Integration calls, or authority derived from presentation\tform-actions.md\nUI-PRES-DEPS\tui\tdependency\terror\tEvery UI import is a sibling UI module or an external library used only for presentation\tInspect resolved imports and used APIs and report Domain, I/O, persistence, authorization, routing, or provider behavior\tstatus-panel.md\nUI-NO-DOMAIN\tui\tdependency\terror\tUI imports no Domain layer or Domain package facade\tResolve the UI import graph and require zero Domain paths\tresult-list.md\nUI-PURE\tui\tbehavior\terror\tUI performs no I/O, graph access, storage, authorization, business validation, provider call, routing, or Domain result mapping\tInspect components and hooks and report the exact excluded call or branch\tconfirmation-dialog.md\nUI-CALLBACKS\tui\tdataflow\terror\tUI accepts presentation props and forwards intent through callbacks without constructing Domain commands\tInspect props and event handlers and report Domain identities, command construction, or business decisions\tform.md\nUTL-DOM-AGNOSTIC\tutils\tarchitecture\terror\tEvery Utils export is Domain-agnostic and contains no Domain declaration, identity, decision, graph definition, or Workflow step\tInspect signatures and implementations and report the exact Domain concept or business behavior\tresult.md\nUTL-REUSED\tutils\tarchitecture\terror\tEvery Utils extension serves two independent semantic consumers or one package-wide execution boundary\tList direct consumers and report an extension satisfying neither condition\tjson-codec.md\nUTL-PUBLIC-DEPS\tutils\tdependency\terror\tUtils imports only public Kernel, DSL, SDK, standard-library, and sibling Utils modules\tResolve the Utils import graph and reject Domain layers, Providers, or private package paths\tjson-codec.md\nUTL-LIGHTWEIGHT\tutils\tarchitecture\terror\tUtils is private and owns no durable engine, planner, compiler, Repository, service locator, or dependency container\tInspect package exports and declarations and report public exposure or any forbidden framework machinery\tresult.md\nSCR-OPERATOR\tscripts\tbehavior\terror\tEvery root Script implements a supported operator workflow with declared inputs, outcomes, failures, and proof\tInspect each Script contract and report disposable tasks or missing operator semantics\tbackup.md\nSCR-PUBLIC-DEPS\tscripts\tbehavior\terror\tScripts import only dependency-DAG-authorized public facades, standard libraries, and operator libraries and define no Domain behavior\tResolve imports and inspect branches and report private paths, business decisions, graph definitions, or callable behavior\tupgrade.md\nSCR-TEST-DRIVERS\tscripts\tbehavior\terror\tDisposable setup, fixtures, resets, and scenario drivers live under tests/scripts rather than root Scripts\tClassify every Script by supported operator contract and report evidence-only programs at the root\trestore.md\nTST-SYS-OWNER\ttests\tevidence\terror\tRoot Tests owns cross-layer journeys, environments, harnesses, scenarios, seeds, fixtures, and disposable scripts\tInventory evidence support code and report cross-layer artifacts outside Tests or production semantics inside Tests\tmigration-scenario.md\nTST-COLOCATED\ttests\tevidence\terror\tEvery semantic production submodule owns focused evidence in its local __tests__ directory\tJoin production submodules to focused test directories and report missing owners\tfocused-rule.md\n",
     layers: frozenRows([
         {
             id: 'schema',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.5.0-beta.114",
+  "version": "0.5.0-beta.116",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",
@@ -229,11 +229,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@astrale-os/kernel-client": "0.6.0-beta.49",
-    "@astrale-os/kernel-core": "0.9.0-beta.37",
-    "@astrale-os/kernel-dsl": "0.2.0-beta.28",
-    "@astrale-os/kernel-protocol": "0.5.0-beta.40",
-    "@astrale-os/kernel-server": "0.5.0-beta.42",
+    "@astrale-os/kernel-client": "0.6.0-beta.51",
+    "@astrale-os/kernel-core": "0.9.0-beta.39",
+    "@astrale-os/kernel-dsl": "0.2.0-beta.30",
+    "@astrale-os/kernel-protocol": "0.5.0-beta.42",
+    "@astrale-os/kernel-server": "0.5.0-beta.44",
     "@lucide/icons": "1.34.0",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "hono": "^4.13.2",