@astrale-os/kernel-core 0.4.1

package/dist/domain/accessors/bind.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bind property and method accessor methods to a domain origin,
+ * property index, and method map.
+ *
+ * Used by both compileDomain() and deserializeDomainFromGraph() — single
+ * implementation, no drift.
+ */
+import type { Schema } from '@astrale-os/kernel-dsl';
+import type { DomainMethodsMap } from '#domain/compile/method/types';
+import type { DomainPropertyIndex } from '#domain/compile/property/types';
+import type { DomainOrigin } from '#domain/origin';
+import type { BoundAccessorMethods } from './types';
+/**
+ * Build the set of property/method accessor methods for a CompiledDomain.
+ *
+ * The returned closures capture `origin`, `properties`, and `methods`,
+ * so they behave identically to instance methods. Caches per-class
+ * `interfaceCounts` and `ownerDomains` derived from the property index.
+ */
+export declare function bindAccessorMethods<S extends Schema = Schema>(origin: DomainOrigin, properties: DomainPropertyIndex, methods: DomainMethodsMap): BoundAccessorMethods<S>;
+//# sourceMappingURL=bind.d.ts.map

package/dist/domain/accessors/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../domain/accessors/bind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAI5D,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,8BAA8B,CAAA;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AASlD,OAAO,KAAK,EACV,oBAAoB,EAKrB,MAAM,SAAS,CAAA;AAQhB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC3D,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,gBAAgB,GACxB,oBAAoB,CAAC,CAAC,CAAC,CA2QzB"}

package/dist/domain/accessors/bind.js

@@ -0,0 +1,265 @@
+/**
+ * Bind property and method accessor methods to a domain origin,
+ * property index, and method map.
+ *
+ * Used by both compileDomain() and deserializeDomainFromGraph() — single
+ * implementation, no drift.
+ */
+import { defRef } from '@astrale-os/kernel-dsl';
+import { ClassPath } from '#domain/addressing/paths';
+import { methodsOf } from '#domain/compile/method/types';
+import { flattenProperties, unflattenProperties } from './flatten';
+import { AmbiguousOwnerAcrossDomainsError, groupProperties, UnknownPropertyError } from './group';
+import { deriveInterfaceCounts } from './interface-counts';
+import {} from './methods';
+import { buildAccessorNode } from './node';
+/**
+ * Build the set of property/method accessor methods for a CompiledDomain.
+ *
+ * The returned closures capture `origin`, `properties`, and `methods`,
+ * so they behave identically to instance methods. Caches per-class
+ * `interfaceCounts` and `ownerDomains` derived from the property index.
+ */
+export function bindAccessorMethods(origin, properties, methods) {
+    const interfaceCountCache = new Map();
+    const ownerDomainCache = new Map();
+    const classMethodCache = new Map();
+    const getInterfaceCounts = (className) => {
+        let cached = interfaceCountCache.get(className);
+        if (!cached) {
+            cached = deriveInterfaceCounts(properties.byClass[className] ?? {});
+            interfaceCountCache.set(className, cached);
+        }
+        return cached;
+    };
+    /**
+     * Derive ownerName → domain mapping from the property index for a class.
+     *
+     * Used by the method-call wiring (`MethodMapInput.ownerDomains`). When the
+     * same owner name appears in two domains we keep the FIRST one — methods
+     * are resolved by name elsewhere, and ambiguity at this layer would block
+     * dispatch entirely. Properties go through the strict per-key resolver in
+     * `groupProperties`, so they don't suffer here.
+     */
+    const getOwnerDomains = (className) => {
+        let cached = ownerDomainCache.get(className);
+        if (!cached) {
+            const map = new Map();
+            const classProps = properties.byClass[className] ?? {};
+            for (const [domain, byOwner] of Object.entries(classProps)) {
+                for (const ownerName of Object.keys(byOwner)) {
+                    if (!map.has(ownerName))
+                        map.set(ownerName, domain);
+                }
+            }
+            // The class itself belongs to this domain
+            if (!map.has(className))
+                map.set(className, origin);
+            cached = map;
+            ownerDomainCache.set(className, cached);
+        }
+        return cached;
+    };
+    const getClassMethodMap = (className) => {
+        let cached = classMethodCache.get(className);
+        if (!cached) {
+            cached = buildClassMethodMap(className, methods);
+            classMethodCache.set(className, cached);
+        }
+        return cached;
+    };
+    const requireClassIndex = (classPath) => {
+        if (classPath.domain !== origin) {
+            throw new Error(`accessors: class "${classPath.raw}" belongs to domain "${classPath.domain}", expected "${origin}"`);
+        }
+        const byClass = properties.byClass[classPath.className];
+        if (!byClass) {
+            throw new Error(`accessors: unknown class "${classPath.className}" in domain "${origin}"`);
+        }
+        return byClass;
+    };
+    const routeDraftKeys = (draft) => {
+        let byClass;
+        try {
+            byClass = requireClassIndex(draft.class);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        key: '',
+                        message: err instanceof Error ? err.message : String(err),
+                        kind: 'unknown-class',
+                    },
+                ],
+            };
+        }
+        const errors = [];
+        const scratchAttrs = {};
+        const scratchProps = {};
+        for (const [rawKey, value] of Object.entries(draft.props ?? {})) {
+            try {
+                // Route each key individually so one bad key doesn't abort the rest.
+                // Routing costs O(domains × owners) per key worst-case for owner-
+                // qualified lookups — both small in practice.
+                const routed = groupProperties(byClass, draft.class.className, origin, {
+                    [rawKey]: value,
+                });
+                Object.assign(scratchAttrs, routed.attrs);
+                for (const [domainName, domainMap] of Object.entries(routed.props)) {
+                    scratchProps[domainName] ??= {};
+                    for (const [ifaceName, ifaceMap] of Object.entries(domainMap)) {
+                        scratchProps[domainName][ifaceName] = {
+                            ...scratchProps[domainName][ifaceName],
+                            ...ifaceMap,
+                        };
+                    }
+                }
+            }
+            catch (err) {
+                if (err instanceof UnknownPropertyError) {
+                    errors.push({ key: rawKey, message: err.message, kind: 'unknown-key' });
+                }
+                else if (err instanceof AmbiguousOwnerAcrossDomainsError) {
+                    errors.push({ key: rawKey, message: err.message, kind: 'ambiguous-key' });
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        return { ok: true, routed: { errors, scratchAttrs, scratchProps } };
+    };
+    return {
+        validate(draft) {
+            const outcome = routeDraftKeys(draft);
+            if (!outcome.ok)
+                return { ok: false, errors: outcome.errors };
+            const { errors } = outcome.routed;
+            if (errors.length > 0)
+                return { ok: false, errors };
+            return { ok: true, value: undefined };
+        },
+        qualify(draft, options) {
+            const outcome = routeDraftKeys(draft);
+            if (!outcome.ok)
+                return { ok: false, errors: outcome.errors };
+            const { errors, scratchAttrs, scratchProps } = outcome.routed;
+            // Default (non-partial): every required CLASS-OWN attribute must
+            // be present. Interface-inherited props are excluded — many are
+            // kernel-managed (Timestamped fills `createdAt`/`updatedAt` from
+            // `localdatetime()` in the FalkorDB adapter; Statused defaults
+            // `status` at the adapter layer), and required-on-interface is
+            // ambiguous in practice (some domains want it, some don't).
+            // Own-class attrs are the locus where "schema says required but
+            // call omits" is unambiguously a bug — that's the M-15 case.
+            // `partial: true` opts out — used by update paths where partial
+            // drafts are legal by design.
+            if (!options?.partial) {
+                const provided = new Set(Object.keys(scratchAttrs));
+                const classIndex = properties.byClass[draft.class.className];
+                if (classIndex) {
+                    for (const byOwner of Object.values(classIndex)) {
+                        for (const [ownerName, propMap] of Object.entries(byOwner)) {
+                            for (const [propName, mapping] of Object.entries(propMap)) {
+                                if (!mapping.required)
+                                    continue;
+                                if (!mapping.isAttribute)
+                                    continue;
+                                if (provided.has(propName))
+                                    continue;
+                                errors.push({
+                                    key: `${ownerName}.${propName}`,
+                                    message: `Required property '${propName}' missing on '${draft.class.className}' (declared by '${ownerName}')`,
+                                    kind: 'missing-required',
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            if (errors.length > 0)
+                return { ok: false, errors };
+            const qualified = flattenProperties(origin, draft.class.className, scratchAttrs, scratchProps);
+            return { ok: true, value: { ...draft, props: qualified } };
+        },
+        draft: ((className, props, path) => {
+            return {
+                class: ClassPath.from({ domain: origin, className }),
+                ...(path !== undefined && { path }),
+                props: (props ?? {}),
+            };
+        }),
+        draftEdge: ((className, params) => ({
+            class: ClassPath.from({ domain: origin, className }),
+            source: params.source,
+            target: params.target,
+            ...(params.slug !== undefined && { slug: params.slug }),
+            props: (params.props ?? {}),
+        })),
+        wrap: ((...args) => {
+            // Two shapes: wrap(node, dispatch?) and wrap(className, node, dispatch?).
+            // The first arg is the className iff it's a string.
+            const hasDeclaredName = typeof args[0] === 'string';
+            const declaredClassName = hasDeclaredName ? args[0] : undefined;
+            const node = (hasDeclaredName ? args[1] : args[0]);
+            const dispatch = (hasDeclaredName ? args[2] : args[1]);
+            // The accessor is domain-scoped — wrapping a node from a foreign domain
+            // would silently mis-route property lookups. Fail loud instead.
+            if (node.class.domain !== origin) {
+                throw new Error(`accessors.wrap: node "${node.id}" at "${node.path.raw}" has class "${node.class.raw}" ` +
+                    `in domain "${node.class.domain}", expected "${origin}"`);
+            }
+            // When the caller passed a className, enforce it matches the node's
+            // actual class so the typed view doesn't silently mis-describe the data.
+            if (declaredClassName !== undefined && node.class.className !== declaredClassName) {
+                throw new Error(`accessors.wrap: declared class "${declaredClassName}" does not match node class ` +
+                    `"${node.class.className}" at "${node.path.raw}"`);
+            }
+            const className = node.class.className;
+            const split = unflattenProperties(origin, className, node.props);
+            // Build method map input when dispatch is provided. No dispatch = pure
+            // data view (no method callables), which is what method handlers need
+            // since self-re-dispatch would be a footgun inside execute().
+            let methodMapInput;
+            if (dispatch) {
+                const classMethods = getClassMethodMap(className);
+                if (classMethods.size > 0) {
+                    methodMapInput = {
+                        byOwner: classMethods,
+                        ownerDomains: getOwnerDomains(className),
+                        dispatch,
+                        nodeId: node.id,
+                    };
+                }
+            }
+            return buildAccessorNode({ id: node.id, path: node.path, class: node.class }, split.attrs, split.grouped, getInterfaceCounts(className), methodMapInput);
+        }),
+    };
+}
+/**
+ * Build a per-owner method map for a class from the domain's flat method map.
+ *
+ * `DomainMethodsMap` keys are definition names that own methods. For a given
+ * class, we collect all methods from the class itself and from all definitions
+ * in its inheritance chain (which are present as keys in the map).
+ *
+ * Returns defRef → (methodName → ResolvedMethod) for all definitions that
+ * contribute methods to this class. Keyed by defRef (`class.X` / `interface.X`)
+ * so a class and an interface sharing a name (e.g. `Function`) cannot collide.
+ */
+function buildClassMethodMap(className, methods) {
+    const classMethods = methodsOf(methods, 'class', className);
+    if (!classMethods)
+        return new Map();
+    const byOwner = new Map();
+    for (const [methodName, resolved] of Object.entries(classMethods)) {
+        const ownerRef = defRef(resolved.originKind, resolved.origin);
+        if (!byOwner.has(ownerRef))
+            byOwner.set(ownerRef, new Map());
+        byOwner.get(ownerRef).set(methodName, resolved);
+    }
+    return byOwner;
+}
+//# sourceMappingURL=bind.js.map

package/dist/domain/accessors/bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../../domain/accessors/bind.ts"],"names":[],"mappings":"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"}

package/dist/domain/accessors/errors.d.ts

@@ -0,0 +1,26 @@
+import type { DefRef } from '@astrale-os/kernel-dsl';
+import type { DomainOrigin } from '#domain/origin';
+import { DomainError } from '#domain/errors';
+import type { ValidationError } from './types';
+/**
+ * Aggregate error thrown by the graph runtime when `qualify()` (or `validate()`)
+ * returns `{ ok: false }`. Carries the full per-field error list so callers can
+ * inspect individual failures instead of parsing the message.
+ */
+export declare class AccessorValidationError extends DomainError {
+    readonly errors: readonly ValidationError[];
+    constructor(errors: readonly ValidationError[]);
+}
+/** Runtime error — interface name is defined by multiple domains on this node. */
+export declare class AmbiguousInterfaceError extends DomainError {
+    readonly interfaceName: string;
+    readonly domains: DomainOrigin[];
+    constructor(interfaceName: string, domains: DomainOrigin[]);
+}
+/** Runtime error — method name exists on multiple types on this node. */
+export declare class AmbiguousMethodError extends DomainError {
+    readonly methodName: string;
+    readonly types: DefRef[];
+    constructor(methodName: string, types: DefRef[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/domain/accessors/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../domain/accessors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,YAAY,MAAM,EAAE,SAAS,eAAe,EAAE,EAI7C;CACF;AAED,kFAAkF;AAClF,qBAAa,uBAAwB,SAAQ,WAAW;IAEpD,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE;IAFlC,YACW,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,YAAY,EAAE,EAOjC;CACF;AAED,yEAAyE;AACzE,qBAAa,oBAAqB,SAAQ,WAAW;IAEjD,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE;IAF1B,YACW,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EAOzB;CACF"}

package/dist/domain/accessors/errors.js

@@ -0,0 +1,37 @@
+import { DomainError } from '#domain/errors';
+/**
+ * Aggregate error thrown by the graph runtime when `qualify()` (or `validate()`)
+ * returns `{ ok: false }`. Carries the full per-field error list so callers can
+ * inspect individual failures instead of parsing the message.
+ */
+export class AccessorValidationError extends DomainError {
+    errors;
+    constructor(errors) {
+        const summary = errors.map((e) => `${e.key || '<class>'}: ${e.message}`).join('; ');
+        super('AccessorValidationError', `Validation failed — ${summary}`);
+        this.errors = errors;
+    }
+}
+/** Runtime error — interface name is defined by multiple domains on this node. */
+export class AmbiguousInterfaceError extends DomainError {
+    interfaceName;
+    domains;
+    constructor(interfaceName, domains) {
+        super('AmbiguousInterfaceError', `Ambiguous interface "${interfaceName}" — defined in domains: ${domains.join(', ')}. ` +
+            `Use node.$d('domain').${interfaceName}.propName to disambiguate.`);
+        this.interfaceName = interfaceName;
+        this.domains = domains;
+    }
+}
+/** Runtime error — method name exists on multiple types on this node. */
+export class AmbiguousMethodError extends DomainError {
+    methodName;
+    types;
+    constructor(methodName, types) {
+        super('AmbiguousMethodError', `Ambiguous method "${methodName}" — defined by types: ${types.join(', ')}. ` +
+            `Use node.TypeName.${methodName}() or node.$d('domain').TypeName.${methodName}() to disambiguate.`);
+        this.methodName = methodName;
+        this.types = types;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/accessors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../domain/accessors/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAI5C;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IAC7C,MAAM,CAA4B;IAC3C,YAAY,MAAkC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnF,KAAK,CAAC,yBAAyB,EAAE,uBAAuB,OAAO,EAAE,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IAE3C,aAAa;IACb,OAAO;IAFlB,YACW,aAAqB,EACrB,OAAuB;QAEhC,KAAK,CACH,yBAAyB,EACzB,wBAAwB,aAAa,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACpF,yBAAyB,aAAa,4BAA4B,CACrE,CAAA;6BAPQ,aAAa;uBACb,OAAO;IAOlB,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAExC,UAAU;IACV,KAAK;IAFhB,YACW,UAAkB,EAClB,KAAe;QAExB,KAAK,CACH,sBAAsB,EACtB,qBAAqB,UAAU,yBAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC1E,qBAAqB,UAAU,oCAAoC,UAAU,qBAAqB,CACrG,CAAA;0BAPQ,UAAU;qBACV,KAAK;IAOhB,CAAC;CACF"}

package/dist/domain/accessors/flatten.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Bidirectional conversion between grouped properties and flat qualified-key storage.
+ */
+import type { DomainOrigin } from '#domain/origin';
+import type { Attributes, GroupedProps } from './types';
+/**
+ * Flatten grouped properties + class-own attrs into a single flat record
+ * keyed by property key strings.
+ *
+ * - Attrs become `ownDomain:class.ownClassName.property.propName`.
+ * - Grouped props become `domain:interface.InterfaceName.property.propName`.
+ */
+export declare function flattenProperties(ownDomain: DomainOrigin, ownClassName: string, attrs: Attributes | undefined, grouped: GroupedProps | undefined): Record<string, unknown>;
+/**
+ * Inverse of flattenProperties.
+ *
+ * Splits a flat record into:
+ * - `structural` — keys with no `:` or non-property keys (id, slug, class, __labels, etc.)
+ * - `attrs` — property keys matching `ownDomain:class.ownClassName.property.*`
+ * - `grouped` — all other property keys (nested by domain → owner → prop)
+ */
+export declare function unflattenProperties(ownDomain: DomainOrigin, ownClassName: string, flat: Readonly<Record<string, unknown>>): {
+    structural: Record<string, unknown>;
+    attrs: Record<string, unknown>;
+    grouped: Record<string, Record<string, Record<string, unknown>>>;
+};
+//# sourceMappingURL=flatten.d.ts.map

package/dist/domain/accessors/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../domain/accessors/flatten.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAKlD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAIvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC;IACD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACjE,CA0BA"}

package/dist/domain/accessors/flatten.js

@@ -0,0 +1,67 @@
+/**
+ * Bidirectional conversion between grouped properties and flat qualified-key storage.
+ */
+import { Key } from '#domain/addressing/keys/key';
+import { Ref } from '#domain/addressing/refs/ref';
+// ── Flatten ──────────────────────────────────────────────────────────────
+/**
+ * Flatten grouped properties + class-own attrs into a single flat record
+ * keyed by property key strings.
+ *
+ * - Attrs become `ownDomain:class.ownClassName.property.propName`.
+ * - Grouped props become `domain:interface.InterfaceName.property.propName`.
+ */
+export function flattenProperties(ownDomain, ownClassName, attrs, grouped) {
+    const flat = {};
+    if (attrs) {
+        for (const [propName, value] of Object.entries(attrs)) {
+            flat[Key.of(ownDomain, Ref.property('class', ownClassName, propName)).toString()] = value;
+        }
+    }
+    if (grouped) {
+        for (const [domain, interfaces] of Object.entries(grouped)) {
+            for (const [interfaceName, props] of Object.entries(interfaces)) {
+                for (const [propName, value] of Object.entries(props)) {
+                    flat[Key.of(domain, Ref.property('interface', interfaceName, propName)).toString()] = value;
+                }
+            }
+        }
+    }
+    return flat;
+}
+// ── Unflatten ────────────────────────────────────────────────────────────
+/**
+ * Inverse of flattenProperties.
+ *
+ * Splits a flat record into:
+ * - `structural` — keys with no `:` or non-property keys (id, slug, class, __labels, etc.)
+ * - `attrs` — property keys matching `ownDomain:class.ownClassName.property.*`
+ * - `grouped` — all other property keys (nested by domain → owner → prop)
+ */
+export function unflattenProperties(ownDomain, ownClassName, flat) {
+    const structural = {};
+    const attrs = {};
+    const grouped = {};
+    for (const [key, value] of Object.entries(flat)) {
+        const parsed = Key.tryParse(key);
+        if (!parsed || !parsed.isProperty) {
+            structural[key] = value;
+            continue;
+        }
+        const domain = parsed.domain;
+        const owner = parsed.member;
+        const propName = parsed.child;
+        if (domain === ownDomain && owner === ownClassName) {
+            attrs[propName] = value;
+        }
+        else {
+            if (!grouped[domain])
+                grouped[domain] = {};
+            if (!grouped[domain][owner])
+                grouped[domain][owner] = {};
+            grouped[domain][owner][propName] = value;
+        }
+    }
+    return { structural, attrs, grouped };
+}
+//# sourceMappingURL=flatten.js.map

package/dist/domain/accessors/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../../domain/accessors/flatten.ts"],"names":[],"mappings":"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"}

package/dist/domain/accessors/group.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Group a flat input record into the storage shape that mutation ports expect.
+ *
+ * Inverse of `flattenProperties` (and a sibling of `unflattenProperties`).
+ * `groupProperties` is the **write-side** entry point: callers hand in a
+ * domain-friendly flat record and get back `{ attrs, props }`, ready to
+ * spread into `graph.createNode` / `graph.updateNode`.
+ *
+ * Three accepted key shapes per entry (parsed by `parsePropertyShortcut`):
+ *   - bare              — `'color'`                                            (class-own props ONLY)
+ *   - owner-qualified   — `'Tag.color'` / `'Named.name'`                       (class or interface owner)
+ *   - domain-qualified  — `'kernel.astrale.ai:Named.name'`                     (cross-domain disambiguation)
+ *   - storage key       — `'kernel.astrale.ai:interface.Named.property.name'`  (= `K.Named.name.key`)
+ *
+ * Error model:
+ *   - bare key for an inherited prop → `UnknownPropertyError` (must qualify)
+ *   - unknown owner / prop           → `UnknownPropertyError`
+ *   - owner-qualified, owner exists in two imported domains → `AmbiguousOwnerAcrossDomainsError`
+ */
+import type { PropertyMapping } from '#domain/compile/property/types';
+import type { Attributes, Properties } from './types';
+/** Per-class slice of `DomainPropertyIndex.byClass` — `domain → owner → prop → mapping`. */
+export type ClassPropertyIndex = Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, PropertyMapping>>>>>>;
+export declare class UnknownPropertyError extends Error {
+    readonly className: string;
+    readonly propName: string;
+    readonly name = "UnknownPropertyError";
+    constructor(className: string, propName: string);
+}
+export declare class AmbiguousOwnerAcrossDomainsError extends Error {
+    readonly className: string;
+    readonly ownerName: string;
+    readonly domains: readonly string[];
+    readonly name = "AmbiguousOwnerAcrossDomainsError";
+    constructor(className: string, ownerName: string, domains: readonly string[]);
+}
+/**
+ * Group a flat input record into `{ attrs, props }` per the class's property mapping.
+ *
+ * @param byClass — the per-class slice of `DomainPropertyIndex.byClass`:
+ *                  `ownerDomain → ownerName → propName → PropertyMapping`.
+ * @param className — the class being grouped (for error messages and class-own routing).
+ * @param ownDomain — the domain that owns `className`. Used to resolve bare keys
+ *                    (which must be class-own).
+ * @param flat — domain-friendly input.
+ */
+export declare function groupProperties(byClass: ClassPropertyIndex, className: string, ownDomain: string, flat: Readonly<Record<string, unknown>>): {
+    attrs: Attributes;
+    props: Properties;
+};
+//# sourceMappingURL=group.d.ts.map

package/dist/domain/accessors/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../domain/accessors/group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAIrD,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CACvC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CACpF,CAAA;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAG3C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAH3B,SAAkB,IAAI,0BAAyB;IAC/C,YACW,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IAGvD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;IAJrC,SAAkB,IAAI,sCAAqC;IAC3D,YACW,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,MAAM,EAAE,EAOpC;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAW1C"}