typekro 0.28.0 → 0.29.0

package/dist/core/planning/aspects.js

@@ -0,0 +1,77 @@
+import { resolveFactoryTargetId } from '../aspects/targets.js';
+import { canonicalDigest } from './canonical.js';
+import { lowerPlanValue } from './values.js';
+function targetDescriptor(target) {
+    if (typeof target === 'function')
+        return resolveFactoryTargetId(target);
+    if (target && typeof target === 'object' && target.kind === 'target-group')
+        return target.id;
+    return undefined;
+}
+function aspectConfiguration(definition, order, diagnostics) {
+    const rawTargets = Array.isArray(definition.target) ? definition.target : [definition.target];
+    const targets = [];
+    let stable = true;
+    rawTargets.forEach((target, targetIndex) => {
+        const descriptor = targetDescriptor(target);
+        if (descriptor === undefined) {
+            stable = false;
+            diagnostics.push({
+                code: 'PLAN_ASPECT_IDENTITY_UNSTABLE',
+                severity: 'error',
+                message: `Aspect ${order} target ${targetIndex} has no stable TypeKro target identity.`,
+                path: `$.aspects[${order}].target[${targetIndex}]`,
+            });
+            targets.push(`unresolved-${targetIndex}`);
+        }
+        else {
+            targets.push(descriptor);
+        }
+    });
+    const rawConfiguration = {
+        targets,
+        surface: definition.surface,
+        cardinality: definition.cardinality,
+        ...(definition.selector !== undefined ? { selector: definition.selector } : {}),
+    };
+    const lowered = lowerPlanValue(rawConfiguration, { strict: false });
+    diagnostics.push(...lowered.diagnostics.map((diagnostic) => ({
+        ...diagnostic,
+        path: `$.aspects[${order}]${diagnostic.path?.slice(1) ?? ''}`,
+    })));
+    if (lowered.diagnostics.some((diagnostic) => diagnostic.severity === 'error'))
+        stable = false;
+    const surfaceKind = definition.surface &&
+        typeof definition.surface === 'object' &&
+        typeof Reflect.get(definition.surface, 'kind') === 'string'
+        ? String(Reflect.get(definition.surface, 'kind'))
+        : 'unknown';
+    return {
+        id: `typekro.aspect/${targets.join('+')}/${surfaceKind}`,
+        configuration: lowered.value,
+        stable,
+    };
+}
+/** Build the ordered, canonical aspect manifest used by planning and digests. */
+export function createAspectManifest(aspects = []) {
+    const diagnostics = [];
+    let stable = true;
+    const manifest = aspects.map((definition, order) => {
+        const descriptor = aspectConfiguration(definition, order, diagnostics);
+        if (!descriptor.stable)
+            stable = false;
+        return {
+            id: descriptor.id,
+            revision: '1',
+            configuration: descriptor.configuration,
+            order,
+        };
+    });
+    return {
+        manifest,
+        digest: canonicalDigest(manifest),
+        diagnostics,
+        stable,
+    };
+}
+//# sourceMappingURL=aspects.js.map

package/dist/core/planning/aspects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspects.js","sourceRoot":"","sources":["../../../src/core/planning/aspects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAS7C,SAAS,gBAAgB,CAAC,MAAoB;IAC5C,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC;IAC7F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAA+B,EAC/B,KAAa,EACb,WAA6B;IAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QACzC,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAsB,CAAC,CAAC;QAC5D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,KAAK,CAAC;YACf,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,+BAA+B;gBACrC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,UAAU,KAAK,WAAW,WAAW,yCAAyC;gBACvF,IAAI,EAAE,aAAa,KAAK,YAAY,WAAW,GAAG;aACnD,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG;QACvB,OAAO;QACP,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;IACF,MAAM,OAAO,GAAG,cAAc,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,WAAW,CAAC,IAAI,CACd,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC1C,GAAG,UAAU;QACb,IAAI,EAAE,aAAa,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE;KAC9D,CAAC,CAAC,CACJ,CAAC;IACF,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC;QAAE,MAAM,GAAG,KAAK,CAAC;IAC9F,MAAM,WAAW,GACf,UAAU,CAAC,OAAO;QAClB,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,QAAQ;QACzD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,EAAE,EAAE,kBAAkB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE;QACxD,aAAa,EAAE,OAAO,CAAC,KAAK;QAC5B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAClC,UAA0C,EAAE;IAE5C,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,MAAM,GAAG,KAAK,CAAC;QACvC,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,QAAQ,EAAE,GAAG;YACb,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;QACjC,WAAW;QACX,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/core/planning/canonical.d.ts

@@ -0,0 +1,10 @@
+import { TypeKroError } from '../errors.js';
+/** Error raised when a value cannot participate in a canonical plan encoding. */
+export declare class CanonicalizationError extends TypeKroError {
+    constructor(message: string, path: string);
+}
+/** Serialize JSON-compatible data with recursively sorted object keys. */
+export declare function canonicalStringify(value: unknown): string;
+/** SHA-256 digest of the canonical UTF-8 representation. */
+export declare function canonicalDigest(value: unknown): string;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/core/planning/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../src/core/planning/canonical.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,iFAAiF;AACjF,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAwCD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/core/planning/canonical.js

@@ -0,0 +1,54 @@
+import { createHash } from 'node:crypto';
+import { TypeKroError } from '../errors.js';
+/** Error raised when a value cannot participate in a canonical plan encoding. */
+export class CanonicalizationError extends TypeKroError {
+    constructor(message, path) {
+        super(message, 'PLAN_CANONICALIZATION_FAILED', { path });
+        this.name = 'CanonicalizationError';
+    }
+}
+function canonicalize(value, path, seen) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new CanonicalizationError(`Non-finite number at ${path}`, path);
+        }
+        return Object.is(value, -0) ? 0 : value;
+    }
+    if (typeof value === 'undefined') {
+        throw new CanonicalizationError(`Undefined is not canonical at ${path}`, path);
+    }
+    if (typeof value === 'bigint' || typeof value === 'function' || typeof value === 'symbol') {
+        throw new CanonicalizationError(`Unsupported ${typeof value} at ${path}`, path);
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value))
+            throw new CanonicalizationError(`Circular array at ${path}`, path);
+        seen.add(value);
+        const result = value.map((item, index) => canonicalize(item, `${path}[${index}]`, seen));
+        seen.delete(value);
+        return result;
+    }
+    if (typeof value === 'object') {
+        if (seen.has(value))
+            throw new CanonicalizationError(`Circular object at ${path}`, path);
+        seen.add(value);
+        const result = {};
+        for (const key of Object.keys(value).sort()) {
+            result[key] = canonicalize(Reflect.get(value, key), path === '$' ? `$.${key}` : `${path}.${key}`, seen);
+        }
+        seen.delete(value);
+        return result;
+    }
+    throw new CanonicalizationError(`Unsupported value at ${path}`, path);
+}
+/** Serialize JSON-compatible data with recursively sorted object keys. */
+export function canonicalStringify(value) {
+    return JSON.stringify(canonicalize(value, '$', new WeakSet()));
+}
+/** SHA-256 digest of the canonical UTF-8 representation. */
+export function canonicalDigest(value) {
+    return createHash('sha256').update(canonicalStringify(value), 'utf8').digest('hex');
+}
+//# sourceMappingURL=canonical.js.map

package/dist/core/planning/canonical.js.map

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

package/dist/core/planning/capabilities.d.ts

@@ -0,0 +1,16 @@
+import { TypeKroError } from '../errors.js';
+import type { CapabilityRequirement, PlanDiagnostic } from './types.js';
+export interface ArtifactCapabilityContext {
+    readonly target: 'direct' | 'kro';
+    readonly host: 'standalone' | 'alchemy' | null;
+    readonly output: 'live' | 'static';
+}
+/** Validate only deployment-target constraints during pure artifact compilation. */
+export declare function targetCapabilityDiagnostics(requirements: readonly CapabilityRequirement[], target: ArtifactCapabilityContext['target']): readonly PlanDiagnostic[];
+/** Validate the complete target/host/output environment at an adapter boundary. */
+export declare function adapterCapabilityDiagnostics(requirements: readonly CapabilityRequirement[], context: ArtifactCapabilityContext): readonly PlanDiagnostic[];
+export declare class ArtifactCapabilityError extends TypeKroError {
+    constructor(context: ArtifactCapabilityContext, diagnostics: readonly PlanDiagnostic[]);
+}
+export declare function assertAdapterCapabilitiesSupported(requirements: readonly CapabilityRequirement[], context: ArtifactCapabilityContext): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/core/planning/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/planning/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;CACpC;AA+FD,oFAAoF;AACpF,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,SAAS,qBAAqB,EAAE,EAC9C,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,GAC1C,SAAS,cAAc,EAAE,CAM3B;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,SAAS,qBAAqB,EAAE,EAC9C,OAAO,EAAE,yBAAyB,GACjC,SAAS,cAAc,EAAE,CAM3B;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,SAAS,cAAc,EAAE;CAQvF;AAED,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,SAAS,qBAAqB,EAAE,EAC9C,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAGN"}

package/dist/core/planning/capabilities.js

@@ -0,0 +1,90 @@
+import { TypeKroError } from '../errors.js';
+import { canonicalStringify } from './canonical.js';
+function capabilityGroupKey(requirement) {
+    return canonicalStringify({
+        id: requirement.id,
+        version: requirement.version,
+        nodeId: requirement.nodeId ?? null,
+    });
+}
+function capabilityGroups(requirements) {
+    const groups = new Map();
+    for (const requirement of requirements) {
+        const key = capabilityGroupKey(requirement);
+        const current = groups.get(key) ?? [];
+        current.push(requirement);
+        groups.set(key, current);
+    }
+    return [...groups.values()].flatMap((group) => {
+        const first = group[0];
+        if (!first)
+            return [];
+        return [
+            {
+                requirements: [...group].sort((left, right) => canonicalStringify(left).localeCompare(canonicalStringify(right))),
+                id: first.id,
+                version: first.version,
+                ...(first.nodeId ? { nodeId: first.nodeId } : {}),
+            },
+        ];
+    });
+}
+function targetMatches(requirement, target) {
+    return requirement.target === undefined || requirement.target === target;
+}
+function environmentMatches(requirement, context) {
+    return (targetMatches(requirement, context.target) &&
+        (requirement.host === undefined || requirement.host === context.host) &&
+        (requirement.output === undefined || requirement.output === context.output));
+}
+function requirementConstraints(requirement) {
+    return {
+        ...(requirement.target ? { target: requirement.target } : {}),
+        ...(requirement.host ? { host: requirement.host } : {}),
+        ...(requirement.output ? { output: requirement.output } : {}),
+    };
+}
+function unsupportedDiagnostic(group, context, dimension) {
+    const actual = dimension === 'target'
+        ? { target: context.target }
+        : {
+            target: context.target,
+            host: context.host ?? 'none',
+            output: context.output,
+        };
+    return {
+        code: 'ARTIFACT_CAPABILITY_UNSUPPORTED',
+        severity: 'error',
+        message: `Capability ${group.id}@${group.version} cannot be satisfied by ${canonicalStringify(actual)}.`,
+        path: group.nodeId ? `$.nodes.${group.nodeId}` : '$.requiredCapabilities',
+        details: {
+            capability: group.id,
+            ...actual,
+            alternatives: canonicalStringify(group.requirements.map(requirementConstraints)),
+        },
+    };
+}
+/** Validate only deployment-target constraints during pure artifact compilation. */
+export function targetCapabilityDiagnostics(requirements, target) {
+    return capabilityGroups(requirements).flatMap((group) => group.requirements.some((requirement) => targetMatches(requirement, target))
+        ? []
+        : [unsupportedDiagnostic(group, { target }, 'target')]);
+}
+/** Validate the complete target/host/output environment at an adapter boundary. */
+export function adapterCapabilityDiagnostics(requirements, context) {
+    return capabilityGroups(requirements).flatMap((group) => group.requirements.some((requirement) => environmentMatches(requirement, context))
+        ? []
+        : [unsupportedDiagnostic(group, context, 'adapter')]);
+}
+export class ArtifactCapabilityError extends TypeKroError {
+    constructor(context, diagnostics) {
+        super(`Artifact capabilities cannot be satisfied by ${context.target}/${context.host ?? 'no-host'}/${context.output}.`, 'ARTIFACT_CAPABILITY_UNSUPPORTED', { context, diagnostics });
+        this.name = 'ArtifactCapabilityError';
+    }
+}
+export function assertAdapterCapabilitiesSupported(requirements, context) {
+    const diagnostics = adapterCapabilityDiagnostics(requirements, context);
+    if (diagnostics.length > 0)
+        throw new ArtifactCapabilityError(context, diagnostics);
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/core/planning/capabilities.js.map

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

package/dist/core/planning/capture.d.ts

@@ -0,0 +1,29 @@
+import type { DeploymentResourceGraph } from '../types/deployment.js';
+import type { KroCompatibleType } from '../types/schema.js';
+import type { CapturedCompositionIR, CompositionInspection, DesiredStatePlan, PlanDiagnostic, PlanOptions, RepresentationRequirement } from './types.js';
+/** Internal executable portion kept out of the serializable captured IR. */
+export interface CapturedCompositionRuntime<TSpec extends KroCompatibleType> {
+    readonly ir: CapturedCompositionIR;
+    readonly diagnosticSource: string;
+    readonly validate: (spec: TSpec) => void;
+    readonly materialize: (spec: TSpec, options: PlanOptions) => DeploymentResourceGraph;
+    readonly representationRequirements: () => {
+        readonly requirements: readonly RepresentationRequirement[];
+        readonly diagnostics: readonly PlanDiagnostic[];
+    };
+    readonly inspect: () => CompositionInspection;
+    readonly plan: (spec: TSpec, options?: PlanOptions) => DesiredStatePlan;
+    /** Build the shared symbolic template plan used by KRO RGD compilation. */
+    readonly planTemplate: (options?: PlanOptions) => DesiredStatePlan;
+    /** Lower a caller-supplied symbolic instance spec without treating proxies as concrete input. */
+    readonly planSymbolic: (spec: TSpec, options?: PlanOptions) => DesiredStatePlan;
+    /** Build a plan from an already materialized graph without replaying author code. */
+    readonly planMaterialized: (spec: TSpec, graph: DeploymentResourceGraph, options?: PlanOptions) => DesiredStatePlan;
+}
+/** Associate a graph or callable composition with its internal semantic capture. */
+export declare function setCompositionCapture<TSpec extends KroCompatibleType>(target: WeakKey, capture: CapturedCompositionRuntime<TSpec>): void;
+/** Copy capture identity when a graph is wrapped in a callable/proxy facade. */
+export declare function copyCompositionCapture(source: WeakKey, target: WeakKey): boolean;
+/** Read internal capture data without exposing executable functions in public DTOs. */
+export declare function getCompositionCapture(target: WeakKey): CapturedCompositionRuntime<KroCompatibleType> | undefined;
+//# sourceMappingURL=capture.d.ts.map

package/dist/core/planning/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/core/planning/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,MAAM,WAAW,0BAA0B,CAAC,KAAK,SAAS,iBAAiB;IACzE,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,KAAK,uBAAuB,CAAC;IACrF,QAAQ,CAAC,0BAA0B,EAAE,MAAM;QACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;QAC5D,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;KACjD,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,gBAAgB,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,gBAAgB,CAAC;IACnE,iGAAiG;IACjG,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,gBAAgB,CAAC;IAChF,qFAAqF;IACrF,QAAQ,CAAC,gBAAgB,EAAE,CACzB,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE,WAAW,KAClB,gBAAgB,CAAC;CACvB;AAID,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,iBAAiB,EACnE,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,GACzC,IAAI,CAEN;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAKhF;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,GACd,0BAA0B,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAE3D"}

package/dist/core/planning/capture.js

@@ -0,0 +1,18 @@
+const captures = new WeakMap();
+/** Associate a graph or callable composition with its internal semantic capture. */
+export function setCompositionCapture(target, capture) {
+    captures.set(target, capture);
+}
+/** Copy capture identity when a graph is wrapped in a callable/proxy facade. */
+export function copyCompositionCapture(source, target) {
+    const capture = captures.get(source);
+    if (!capture)
+        return false;
+    captures.set(target, capture);
+    return true;
+}
+/** Read internal capture data without exposing executable functions in public DTOs. */
+export function getCompositionCapture(target) {
+    return captures.get(target);
+}
+//# sourceMappingURL=capture.js.map

package/dist/core/planning/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/core/planning/capture.ts"],"names":[],"mappings":"AAoCA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA0D,CAAC;AAEvF,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CACnC,MAAe,EACf,OAA0C;IAE1C,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAwD,CAAC,CAAC;AACjF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,MAAe,EAAE,MAAe;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,MAAe;IAEf,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core/planning/compiler.d.ts

@@ -0,0 +1,12 @@
+import { TypeKroError } from '../errors.js';
+import { type DirectArtifactCompilerOptions, type DirectKubernetesArtifactPlan, type KroArtifactCompilerOptions, type KroArtifactPlan } from './artifacts.js';
+import type { DesiredStatePlan, PlanDiagnostic } from './types.js';
+/** Error raised when a target compiler cannot faithfully represent a semantic plan. */
+export declare class ArtifactCompilationError extends TypeKroError {
+    constructor(target: 'direct' | 'kro', diagnostics: readonly PlanDiagnostic[]);
+}
+/** Purely compile a semantic plan into direct Kubernetes artifact operations. */
+export declare function compileDirectArtifactPlan(plan: DesiredStatePlan, options?: DirectArtifactCompilerOptions): DirectKubernetesArtifactPlan;
+/** Purely compile semantic intent into host-independent KRO graph and outer artifacts. */
+export declare function compileKroArtifactPlan(plan: DesiredStatePlan, options?: KroArtifactCompilerOptions): KroArtifactPlan;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/core/planning/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/core/planning/compiler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAGL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAEjC,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EAMrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAEV,gBAAgB,EAGhB,cAAc,EAKf,MAAM,YAAY,CAAC;AAgBpB,uFAAuF;AACvF,qBAAa,wBAAyB,SAAQ,YAAY;gBAC5C,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,EAAE,SAAS,cAAc,EAAE;CAY7E;AA0ZD,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,6BAAkC,GAC1C,4BAA4B,CA6D9B;AAoBD,0FAA0F;AAC1F,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,0BAA+B,GACvC,eAAe,CAoMjB"}